Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
fix(i18n): drop doubled counter word in ko finder status; scope example catalogs as format references
uygnoey4293db81b586
diff --git a/archify.zip b/archify.zipindex e3c43e23..50c68e79 100644Binary files a/archify.zip and b/archify.zip differdiff --git a/archify/SKILL.md b/archify/SKILL.mdindex c39577b9..45b747e8 100644--- a/archify/SKILL.md+++ b/archify/SKILL.md@@ -127,7 +127,7 @@ This section is about renderer-owned Viewer chrome only. Write titles, node labe**Any well-formed locale tag works, for any language — not just the ones listed below.** `en`, `zh-CN`, and `es` ship as built-in Viewer-chrome catalogs (`renderers/shared/i18n.mjs`), so those three need nothing further. Every other locale — including ones with no example on disk — is supplied as translation *data* you (the authoring agent) write into the document, not a renderer code change and not a fixed list anywhere in this repo. To localize a diagram in a language with no existing example, set `meta.locale` to its tag and write `meta.translations` yourself: an object mapping canonical message keys (see `catalogKeys()`, or any key in `examples/locales/ko.json`) to translated strings whose `{placeholder}` tokens match the English source exactly. `validate`/`render`/`deliver` report coverage to stderr (`archify: meta.translations for locale "…" covers N/519 renderer-owned messages…`); a key that is missing, unknown, or has mismatched placeholders falls back to its English string rather than breaking the render. `meta.locale` without a built-in catalog or `meta.translations` falls back entirely to English Viewer UI and `<html lang="en">`, with the same disclosure on stderr — never a half-translated page. The renderer itself never translates anything or calls a translation service; every string in `meta.translations` must already be present in the document when you call `validate`/`render`/`deliver`.-`examples/locales/` carries reusable, checked-in catalogs so a diagram doesn't need retranslating from scratch every time: `examples/locales/ko.json`, `fr.json`, `pt.json`, `ja.json`, `de.json`, `it.json`, and `ru.json` are each complete (519/519 keys). `examples/locales/fr.partial.json` is a small, deliberately partial French catalog demonstrating the missing-key/coverage-report path specifically. None of these are a closed enum — they're starting points to copy or extend, and a language with no file here works exactly the same way once you write its `meta.translations`.+`examples/locales/` holds format references only, not catalogs to copy: `examples/locales/ko.json`, `fr.json`, `pt.json`, `ja.json`, `de.json`, `it.json`, and `ru.json` each show a complete (519/519 keys) catalog, and `examples/locales/fr.partial.json` is a small, deliberately partial French catalog demonstrating the missing-key/coverage-report path specifically. Use them to see the key set, placeholder shape, and coverage behavior — never paste one into `meta.translations`. Translate the Viewer strings yourself for each diagram, in the target language and in keeping with that diagram's own terminology, even when an example file exists for that language. None of these are a closed enum; a language with no file here works exactly the same way.`assets/template.html` also bundles D2Coding (SIL OFL, `assets/D2Coding-OFL.txt`) after JetBrains Mono in the monospace stack, and one weight of Pretendard (SIL OFL, `assets/Pretendard-OFL.txt`) in the "editorial" preset's serif heading stack, so Hangul in authored content or a Korean-translated chrome renders without missing glyphs. This is independent of `meta.translations`: it helps any locale or authored text that uses Hangul, and is not required for the translation mechanism itself to work.diff --git a/archify/examples/locales/ko.json b/archify/examples/locales/ko.jsonindex 0fb01cc6..5eb15d4d 100644--- a/archify/examples/locales/ko.json+++ b/archify/examples/locales/ko.json@@ -308,13 +308,13 @@"viewer.finder.status.empty": "일치하는 노드가 없습니다","viewer.finder.status.count.one": "일치하는 노드 {count}개","viewer.finder.status.count.other": "일치하는 노드 {count}개",- "viewer.finder.noun.nodes": "개 노드",+ "viewer.finder.noun.nodes": "노드","viewer.finder.link.one": "연결 {count}개","viewer.finder.link.other": "연결 {count}개","viewer.finder.result.focus.one": "{label} 포커스, 관련 연결 {count}개","viewer.finder.result.focus.other": "{label} 포커스, 관련 연결 {count}개",- "viewer.finder.status.filtered": "{available}개 중 {visible}개 {noun}",- "viewer.finder.status.all": "{available}개 {noun}",+ "viewer.finder.status.filtered": "{noun} {available}개 중 {visible}개",+ "viewer.finder.status.all": "{noun} {available}개","viewer.passport.eyebrow": "시맨틱 패스포트","viewer.passport.metadata": "노드 메타데이터","viewer.passport.evidence": "검증된 소스 근거",@@ -430,13 +430,13 @@"viewer.route.finder.source.placeholder": "경로 출발지 검색","viewer.route.finder.source.empty": "일치하는 경로 출발지가 없습니다","viewer.route.finder.source.results": "경로를 시작할 수 있는 노드",- "viewer.route.finder.source.noun": "개 경로 출발지",+ "viewer.route.finder.source.noun": "경로 출발지","viewer.route.finder.source.badge": "시작","viewer.route.finder.target.title": "{label}에서 출발할 도착지","viewer.route.finder.target.placeholder": "도달 가능한 도착지 검색","viewer.route.finder.target.empty": "일치하는 도달 가능한 도착지가 없습니다","viewer.route.finder.target.results": "도달 가능한 경로 도착지",- "viewer.route.finder.target.noun": "개 도달 가능한 도착지",+ "viewer.route.finder.target.noun": "도달 가능한 도착지","viewer.route.hop.one": "홉 {count}개","viewer.route.hop.other": "홉 {count}개","viewer.lens.eyebrow": "시맨틱 렌즈",diff --git a/archify/test/fixtures/korean-locale.architecture.json b/archify/test/fixtures/korean-locale.architecture.jsonindex 3586db7a..ee9202fc 100644--- a/archify/test/fixtures/korean-locale.architecture.json+++ b/archify/test/fixtures/korean-locale.architecture.json@@ -315,13 +315,13 @@"viewer.finder.status.empty": "일치하는 노드가 없습니다","viewer.finder.status.count.one": "일치하는 노드 {count}개","viewer.finder.status.count.other": "일치하는 노드 {count}개",- "viewer.finder.noun.nodes": "개 노드",+ "viewer.finder.noun.nodes": "노드","viewer.finder.link.one": "연결 {count}개","viewer.finder.link.other": "연결 {count}개","viewer.finder.result.focus.one": "{label} 포커스, 관련 연결 {count}개","viewer.finder.result.focus.other": "{label} 포커스, 관련 연결 {count}개",- "viewer.finder.status.filtered": "{available}개 중 {visible}개 {noun}",- "viewer.finder.status.all": "{available}개 {noun}",+ "viewer.finder.status.filtered": "{noun} {available}개 중 {visible}개",+ "viewer.finder.status.all": "{noun} {available}개","viewer.passport.eyebrow": "시맨틱 패스포트","viewer.passport.metadata": "노드 메타데이터","viewer.passport.evidence": "검증된 소스 근거",@@ -437,13 +437,13 @@"viewer.route.finder.source.placeholder": "경로 출발지 검색","viewer.route.finder.source.empty": "일치하는 경로 출발지가 없습니다","viewer.route.finder.source.results": "경로를 시작할 수 있는 노드",- "viewer.route.finder.source.noun": "개 경로 출발지",+ "viewer.route.finder.source.noun": "경로 출발지","viewer.route.finder.source.badge": "시작","viewer.route.finder.target.title": "{label}에서 출발할 도착지","viewer.route.finder.target.placeholder": "도달 가능한 도착지 검색","viewer.route.finder.target.empty": "일치하는 도달 가능한 도착지가 없습니다","viewer.route.finder.target.results": "도달 가능한 경로 도착지",- "viewer.route.finder.target.noun": "개 도달 가능한 도착지",+ "viewer.route.finder.target.noun": "도달 가능한 도착지","viewer.route.hop.one": "홉 {count}개","viewer.route.hop.other": "홉 {count}개","viewer.lens.eyebrow": "시맨틱 렌즈",