polytypo 1.6.2 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf167fa991d92f3a4e63e03b4b4f96882a5842a2c80759941533cde64b0cf5a4
-  data.tar.gz: 8337a2ad5508d5d698b5130329753eacf8534ec5b7ead365981f8d42fa85931f
+  metadata.gz: 406f25967b3adc0d3dca2c77838e8e59d861ede74e42959c01efcb732d08c419
+  data.tar.gz: '03389980598eee3542f48d15f23b1501a83cfd88e79bcc56ad2044db034ba40b'
 SHA512:
-  metadata.gz: d408de52fe21124d92a29ef3492fccaeca452ae11c80924a2e96dd6f69509d23b21263efb4635db3d7b41b79d02798eb261eb8be87b72d24ad8f1f139a13cb59
-  data.tar.gz: a9a451994c2b99626c5eaa702c50bd2d6b4cb2c68ee754b9711343cb51a0cf59893c3e9443203483f33adf5513a3e5431cc72d274f089004759034570610084b
+  metadata.gz: ab38ef48178c5d64b8261830d13d96b66b2941ebf229f6bcc8161ef66ee94f6bbbce4479d2ed98183530aea9f67a945383e7feaeb1d4b69923f4ead8dc4bea9b
+  data.tar.gz: a3545f797663af489eba433bf8a6d30cd0e23af1bde436834c502f746ddafd31e5caee4eda322d01b175c3de3d1faf6f18fd54616dd9fe81c40032a6a2760a36

data/README.md

@@ -85,6 +85,31 @@ chomping indicator are never decoded and rewritten — the file is located, not
 trailing newlines of a `|+` block come back exactly as you wrote them. An empty `keys:` array is
 legal and processes nothing, and `yaml` mode needs no parser at all.
 
+In `markdown` mode frontmatter is skipped whole by default, delimiters included — it is a
+machine-read block, and `fr` would put a narrow no-break space in front of the colon of every
+field in it. On a site whose frontmatter carries the headline that leaves the most visible string
+on the page untouched, so name the keys you want processed:
+
+```ruby
+Polytypo.transform(
+  %(---\ntitle: He said "hello" once\nslug: "he-said-hello"\n---\n\nThe body was typeset all along.\n),
+  locale: "en-US", mode: "markdown", dialect: "commonmark", frontmatter_keys: ["title"]
+)
+# ---
+# title: He said “hello” once
+# slug: "he-said-hello"
+# ---
+#
+# The body was typeset all along.
+```
+
+Without `frontmatter_keys:` nothing in the block changes, and a key you do not name never does. The
+block is read with the same scan `yaml` mode uses, so it refuses the same constructs — a
+single-quoted scalar containing `''` among them, which is how an apostrophe is written inside single
+quotes, so `title: 'It''s a test'` comes back untouched. The block is also processed separately from
+the body, which shows up in exactly one place: an unbalanced quotation mark in `title` cannot pair
+with a mark in your first paragraph.
+
 `require "polytypo"` never loads the native `commonmarker` extension unless you actually call
 `Polytypo.transform` with `mode: "markdown"` — the require happens lazily, inside the markdown
 pipeline only. A single `Polytypo.transform` module method (not separate

data/lib/polytypo/data/.not-vendored

@@ -0,0 +1,11 @@
+# Paths under canonical polytypo's spec/ that this repository deliberately does not vendor, so
+# check-vendored-spec.sh must not expect them here. Every other file canonical has at tag
+# spec-v$(cat VERSION) must be present here, or the check fails naming it — which is how a
+# vendored file that was deleted, or a canonical file that was never copied, is caught.
+#
+# An entry canonical does not have at that tag is an error, and so is an entry that is also
+# present here: this list records deliberate omissions, not exemptions.
+#
+# CONFORMANCE.md is canonical's own conformance matrix, written after a release. Nothing here
+# reads it, and it is the one canonical file a released spec version may still gain.
+CONFORMANCE.md

data/lib/polytypo/data/README.md

@@ -18,17 +18,22 @@ one copy, shipped as part of the gem's own `lib/` payload and loaded via `File.r
 Editing a file here does not change the spec; it only drifts this copy from canonical. When
 canonical's `spec/` changes, re-copy the affected files here.
 
-CI checks that it was done. `script/check-vendored-spec.sh` compares every file in this
-directory against canonical `polytypo/polytypo` at tag `spec-v` + this directory's own
-`VERSION`, and fails on any difference. Three details. The files this repository authors
-itself are listed in `.not-canonical` and skipped — and a listed path that canonical *does*
-have is an error, so that list cannot be used to keep a forked copy of a canonical file. A
-`locales/*.json` file is compared in full when it carries its `sources` array, and against
-canonical minus that array when it does not, which is the shipped form three of the five
-runtimes vendor; the script reads which case it is off the file rather than being told. And a
-file here with no canonical counterpart is a failure, so a canonical rename cannot pass
-unnoticed. Completeness is deliberately not checked — each runtime vendors its own subset,
-and the subsets differ.
+CI checks that it was done. `script/check-vendored-spec.sh` compares every file in this directory
+against canonical `polytypo/polytypo` at tag `spec-v` + this directory's own `VERSION`, and fails
+on any difference. Five details. The files this repository authors itself are listed in
+`.not-canonical` and skipped — and a listed path that canonical *does* have is an error, so that
+list cannot be used to keep a forked copy of a canonical file. A `locales/*.json` file is compared
+in full when it carries its `sources` array, and against canonical minus that array when it does
+not, which is the shipped form three of the five runtimes vendor; the script reads which case it
+is off the file rather than being told. A file here with no canonical counterpart is a failure, so
+a canonical rename cannot pass unnoticed. Completeness is checked from canonical's side rather
+than this one: every file canonical has at that tag must be here unless `.not-vendored` names it,
+so a vendored file that was deleted, or a canonical file that arrived later and was never copied,
+fails naming itself, and an entry canonical does not have at that tag, or one that is also present
+here, fails too. Here that list names `CONFORMANCE.md`, and nothing else. And the version itself
+is checked: a tree faithful to the tag it claims while canonical has tagged a newer one is a
+warning in CI and, with `--require-current`, a refusal in the release job, because a package must
+not be published claiming a spec version canonical has moved past.
 
 Before that check existed, this half of the tree went stale unnoticed in four of the five
 ports at once: the data half is proved by the test suite, and nothing at all read the prose.

data/lib/polytypo/data/VERSION

@@ -1 +1 @@
-1.6.2
+1.7.0

data/lib/polytypo/data/fixtures/cs.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "cs",
   "cases": [
     {

data/lib/polytypo/data/fixtures/de-CH.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "de-CH",
   "cases": [
     {

data/lib/polytypo/data/fixtures/de-DE.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "de-DE",
   "cases": [
     {
@@ -763,6 +763,19 @@
       "in": "description: a---#b\n",
       "out": "description: a---#b\n",
       "note": "modes.md §3.8.6 with §3.4's character clause: without it this became `description: a – #b`, and everything from the hash became a comment — the value silently truncated to `a –`."
+    },
+    {
+      "id": "de-de-markdown-commonmark-frontmatter-keys",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title",
+        "summary"
+      ],
+      "in": "---\ntitle: Er sagte \"hallo\" laut\nsummary: Noch \"eins\" hier\nslug: \"er-sagte-hallo\"\n---\n\nIm Text \"so\" hier.\n",
+      "out": "---\ntitle: Er sagte „hallo“ laut\nsummary: Noch „eins“ hier\nslug: \"er-sagte-hallo\"\n---\n\nIm Text „so“ hier.\n",
+      "note": "modes.md §3.7.4: two listed plain scalars in a locale whose quote glyphs differ from English, with an unlisted slug between the block and the body. Each listed scalar is its own span and the marks pair inside it, so the German pair appears three times and the slug keeps its straight quotes."
     }
   ]
 }

data/lib/polytypo/data/fixtures/el.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "el",
   "cases": [
     {

data/lib/polytypo/data/fixtures/en-GB.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "en-GB",
   "cases": [
     {

data/lib/polytypo/data/fixtures/en-US.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "en-US",
   "cases": [
     {
@@ -1903,6 +1903,148 @@
       "out": "---\ntitle: “Unclosed”\n\nBody “quotes” here.\n",
       "note": "modes.md §3.7.3 skips a frontmatter block; an opening delimiter with no closing one is not a block. The leading --- is then an ordinary thematic break and everything after it is prose, so the metadata-looking line converts like any other paragraph. Pinned so the skip cannot be widened into \"anything after a leading ---\"."
     },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ntitle: \"He said 'hi' twice\"\nslug: \"he-said-hi\"\n---\n\nBody has \"quotes\" here.\n",
+      "out": "---\ntitle: \"He said “hi” twice\"\nslug: \"he-said-hi\"\n---\n\nBody has “quotes” here.\n",
+      "note": "modes.md §3.7.4: the option names title, so that scalar is processable and everything else in the block — the unlisted slug, both delimiters, every key — is not. Compare en-us-markdown-commonmark-frontmatter, the same shape with the option absent."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-empty",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [],
+      "in": "---\ntitle: \"He said 'hi' twice\"\n---\n\nBody has \"quotes\" here.\n",
+      "out": "---\ntitle: \"He said 'hi' twice\"\n---\n\nBody has “quotes” here.\n",
+      "note": "modes.md §3.7.4: an empty list is legal and yields no spans, as it does for keys in yaml mode. Process nothing is a choice, not an error, and the output is identical to the option being absent."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-unlisted-only",
+      "rule": "dashes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ndescription: \"Fast - reliable\"\n---\n\nBody - here.\n",
+      "out": "---\ndescription: \"Fast - reliable\"\n---\n\nBody—here.\n",
+      "note": "modes.md §3.7.4: a block containing none of the listed keys is left exactly as the skip left it. The same dash converts in the body, so the case pins that the block was not processed rather than that the rule declined."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-toml",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "+++\ntitle = \"He said 'hi'\"\n+++\n\nBody has \"quotes\" here.\n",
+      "out": "+++\ntitle = \"He said 'hi'\"\n+++\n\nBody has “quotes” here.\n",
+      "note": "modes.md §3.7.4: a TOML block yields no spans with the option given. TOML quoting is a second grammar the scan does not claim (§7.13), so +++ keeps §3.7.3's skip-whole treatment whatever the caller lists."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-unterminated",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ntitle: \"Unclosed\"\n\nBody \"quotes\" here.\n",
+      "out": "---\ntitle: “Unclosed”\n\nBody “quotes” here.\n",
+      "note": "modes.md §3.7.4: an opening delimiter with no closing one is not a block, so the option has nothing to name and adds no spans. The line converts anyway — as ordinary prose, per en-us-markdown-commonmark-frontmatter-unterminated — which is why the option must not be credited with it."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-escape-bail",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ntitle: \"She said \\\"hi\\\" to me\"\n---\n\nBody has \"quotes\" here.\n",
+      "out": "---\ntitle: \"She said \\\"hi\\\" to me\"\n---\n\nBody has “quotes” here.\n",
+      "note": "modes.md §3.7.4 inherits every bail of §3.8.6: a double-quoted scalar whose content contains U+005C yields no spans, because the source spells the content with more characters than it has. The listed key is not enough on its own."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-single-quote-bail",
+      "rule": "apostrophe",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ntitle: 'It''s a test'\n---\n\nBody it's here.\n",
+      "out": "---\ntitle: 'It''s a test'\n---\n\nBody it’s here.\n",
+      "note": "modes.md §3.7.4, and the cost §7.13 measures: a single-quoted scalar containing two consecutive U+0027 yields no spans, and an apostrophe in a single-quoted scalar is written exactly that way. Half the prose values of the §3.7.4.1 corpus bail here when re-emitted in this style."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-separate-unit",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ntitle: He said \"hello\n---\n\nworld\" she said\n",
+      "out": "---\ntitle: He said \"hello\n---\n\nworld\" she said\n",
+      "note": "modes.md §3.7.4: the block is its own text unit, so the unbalanced mark in title cannot pair with the one in the body. This case discriminates: run as one unit the pair converts — measured, text mode over the same characters gives “hello … world” — and under two units both marks stay straight. A runtime that concatenates the block with the body passes every other frontmatter case and fails this one."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-nested",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\nseo:\n  title: He said \"hi\"\nslug: \"x\"\n---\n\nBody \"quotes\" here.\n",
+      "out": "---\nseo:\n  title: He said “hi”\nslug: \"x\"\n---\n\nBody “quotes” here.\n",
+      "note": "modes.md §3.7.4 with §3.8.2's matching: a listed key is processable at any depth and by bare name only, so a nested title converts while the sibling slug does not. §7.12's accepted cost is the same one — a caller cannot say seo.title and not title."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-block-scalar",
+      "rule": "dashes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "summary"
+      ],
+      "in": "---\nsummary: |\n  One line - here.\n  Another - line.\n---\n\nBody - here.\n",
+      "out": "---\nsummary: |\n  One line—here.\n  Another—line.\n---\n\nBody—here.\n",
+      "note": "modes.md §3.7.4 reuses §3.8.5: each non-blank content line of a listed block scalar is one span, the header and the indentation stay outside every span, and the gap between two content lines is a −2 marker."
+    },
+    {
+      "id": "en-us-markdown-commonmark-frontmatter-keys-crlf",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\r\ntitle: \"He said 'hi'\"\r\n---\r\n\r\nBody has \"quotes\" here.\r\n",
+      "out": "---\r\ntitle: \"He said “hi”\"\r\n---\r\n\r\nBody has “quotes” here.\r\n",
+      "note": "modes.md §3.7.4: a U+000D before the terminator belongs to the terminator, so a CRLF document gives the same block content as the same bytes with LF and the delimiters stay outside every span."
+    },
+    {
+      "id": "en-us-markdown-mdx-frontmatter-keys",
+      "rule": "quotes",
+      "mode": "markdown",
+      "dialect": "mdx",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ntitle: \"He said 'hi'\"\n---\n\n<Callout>Body \"quotes\" here</Callout>\n",
+      "out": "---\ntitle: \"He said “hi”\"\n---\n\n<Callout>Body “quotes” here</Callout>\n",
+      "note": "modes.md §3.7.4 applies to both dialects: YAML frontmatter is the same construct in mdx as in commonmark, and §3.7.3 lists it once for both."
+    },
     {
       "id": "en-us-ranges-closed-up-currency",
       "rule": "ranges",

data/lib/polytypo/data/fixtures/es.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "es",
   "cases": [
     {

data/lib/polytypo/data/fixtures/fi.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "fi",
   "cases": [
     {

data/lib/polytypo/data/fixtures/fr-CA.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "fr-CA",
   "cases": [
     {

data/lib/polytypo/data/fixtures/fr.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "fr",
   "cases": [
     {
@@ -747,6 +747,18 @@
       "out": "---\ntitle: Une note ; suite\n---\n\n<Callout>Est-ce vrai ?</Callout>\n",
       "note": "modes.md §3.7.3: the same guarantee under \"mdx\", where frontmatter plus JSX is the ordinary document shape. This is the case the polytypo-js source comment above its frontmatter skip entry described as a spec gap."
     },
+    {
+      "id": "fr-markdown-commonmark-frontmatter-keys-colon",
+      "rule": "nbsp",
+      "mode": "markdown",
+      "dialect": "commonmark",
+      "frontmatterKeys": [
+        "title"
+      ],
+      "in": "---\ntitle: \"Chapitre 1: le début\"\ndate: \"2026-09-25\"\n---\n\nVoici: le corps.\n",
+      "out": "---\ntitle: \"Chapitre 1 : le début\"\ndate: \"2026-09-25\"\n---\n\nVoici : le corps.\n",
+      "note": "modes.md §3.7.4 with the locale that made §3.7.3 skip the block in the first place: inside a listed quoted scalar a colon is content, so fr inserts its narrow no-break space, while the unlisted date field and the key itself keep every byte. That contrast is the whole argument for a caller-named list."
+    },
     {
       "id": "fr-nbsp-character-reference-numeric",
       "rule": "nbsp",

data/lib/polytypo/data/fixtures/it.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "it",
   "cases": [
     {

data/lib/polytypo/data/fixtures/locale-resolution.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "cases": [
     {
       "id": "exact-en-us",

data/lib/polytypo/data/fixtures/nl.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "nl",
   "cases": [
     {

data/lib/polytypo/data/fixtures/pl.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "pl",
   "cases": [
     {

data/lib/polytypo/data/fixtures/pt-BR.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "pt-BR",
   "cases": [
     {

data/lib/polytypo/data/fixtures/pt-PT.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "pt-PT",
   "cases": [
     {

data/lib/polytypo/data/fixtures/ru.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "ru",
   "cases": [
     {

data/lib/polytypo/data/fixtures/sv.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "sv",
   "cases": [
     {

data/lib/polytypo/data/fixtures/tr.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "tr",
   "cases": [
     {

data/lib/polytypo/data/fixtures/uk.json

@@ -1,5 +1,5 @@
 {
-  "spec": "1.6.2",
+  "spec": "1.7.0",
   "locale": "uk",
   "cases": [
     {

data/lib/polytypo/data/locales/cs.json

@@ -33,43 +33,62 @@
   "nbsp": {
     "beforePunctuation": [],
     "narrowBeforePunctuation": [],
-    "afterShortWords": [
-      "a",
-      "i",
-      "k",
-      "o",
-      "s",
-      "u",
-      "v",
-      "z"
-    ],
-    "abbreviations": [
-      "a. s.",
-      "s. r. o."
-    ],
-    "beforeUnits": [
-      "%",
-      "°C",
-      "ha",
-      "kg",
-      "km",
-      "cm",
-      "mm",
-      "m²",
-      "kWh",
-      "km/h",
-      "str.",
-      "hod."
-    ],
+    "afterShortWords": ["a", "i", "k", "o", "s", "u", "v", "z"],
+    "abbreviations": ["a. s.", "s. r. o."],
+    "beforeUnits": ["%", "°C", "ha", "kg", "km", "cm", "mm", "m²", "kWh", "km/h", "str.", "hod."],
     "beforeNumber": [],
-    "beforeWord": [
-      "tj.",
-      "tzv.",
-      "tzn."
-    ],
-    "afterSymbols": [
-      "§"
-    ],
+    "beforeWord": ["tj.", "tzv.", "tzn."],
+    "afterSymbols": ["§"],
     "initialBinding": "single"
-  }
+  },
+  "sources": [
+    {
+      "rule": "quotes",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Uvozovky»: «V češtině užíváme různé varianty uvozovek: dvojité „ “, jednoduché ‚ ‘ a boční » «»; «Jako základní se doporučují uvozovky typu 99 66, tj. dvojité „ “»; «Ostatní typy uvozovek (v první řadě jednoduché, až v druhé řadě boční) se užívají především tehdy, pokud potřebujeme do uvozeného textu vložit ještě další uvozovky»; «Uvozovky přiléhají vždy těsně k výrazům, které ohraničují (tedy „takto“)»",
+      "url": "https://prirucka.ujc.cas.cz/?id=162",
+      "note": "První stupeň: U+201E otevírací, U+201C zavírací — NIKOLI U+201D jako v polštině, a právě to je rozdíl, který se v sazbě přehlédne. Kódy nebyly odečteny z markdownové konverze stránky, která se u uvozovek ukázala jako nespolehlivá; rozhodující je vlastní označení zdroje «uvozovky typu 99 66»: první znaménko má tvar devítky u paty řádku (U+201E), druhé tvar šestky vyzdvižený nahoru (U+201C). Polský pár PWN naproti tomu označuje jako 99 99. Druhý stupeň: jednoduché uvozovky, protože zdroj je výslovně řadí «v první řadě» pro uvozovky v uvozovkách. OMEZENÁ JISTOTA, řečená naplno: označení «99 66» je ve zdroji uvedeno pouze pro dvojité uvozovky, takže kódy jednoduchých (U+201A … U+2018) vycházejí ze stejného vzorce a z vysázených glyfů, ne z doslovného tvrzení. Rozhodla by tabulka H.1 normy ČSN 01 6910:2014, která je však placená (ČSN online od 1 000 Kč/rok). ROZHODNUTÍ OPERÁTORA, 18. 9. 2026: leží-li pravidlo za placenou normou, projekt je formuluje podle převládajícího úzu a označí to jako rozhodnutí, nikoli jako citaci — stejně jako u německého «Nr.». Padne-li placená stěna, nahradí znění normy tento řádek. Q-W platí v obou případech: U+201A, U+2018 i U+2019 patří do NARROW. Ověřeno 18. 9. 2026."
+    },
+    {
+      "rule": "dashes",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Pomlčka»: «Pomlčku oddělujeme z obou stran mezerami, komplikovanější situace je pouze tehdy, pokud toto znaménko vystupuje ve funkci výrazů a, až, od … do … nebo proti (versus)»; «pomlčka místo čárky: Tato kniha – vydaná ještě před válkou – je opravdu úžasná»; «Pomlčka (–) je dlouhá vodorovná čárka»; «Vedle krátké pomlčky (–) se v textu někdy používá také pomlčka dlouhá (—)»",
+      "url": "https://prirucka.ujc.cas.cz/?id=165",
+      "note": "Odůvodňuje dash.parenthetical = «en-spaced». Vsuvka není žádná ze čtyř vyjmenovaných výjimek, takže platí obecné pravidlo o mezerách z obou stran. DÉLKA je na rozdíl od polštiny rozhodnuta samotným zdrojem: definiční glyf stránky je krátká pomlčka U+2013 a dlouhá U+2014 je popsána jako to, co se používá «někdy» navíc. U polštiny musel o délce rozhodnout operátor, protože PWN si v korpusu protiřečil; tady stačí číst. PŘÍPUSTNÁ VARIANTA, zaznamenána: U+2014. Ověřeno 18. 9. 2026."
+    },
+    {
+      "rule": "ranges",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Pomlčka», vyjádření rozsahu (s významem ‚až‘ či ‚od … do‘): «strana 23–26, v letech 1945–1948, 9–16 h»; ÚJČ (P. Lozan, M. Pravdová), «Otázky a odpovědi k ČSN 01 6910 (2014)», otázka 2: «norma umožňuje i psaní mezery kolem pomlčky v rozsazích a ve významu „a“ a „versus“, jestliže je alespoň jeden z výrazů kolem pomlčky víceslovný»",
+      "url": "https://prirucka.ujc.cas.cz/?id=165",
+      "note": "Odůvodňuje dash.range = «en-tight»: krátká pomlčka U+2013 bez mezer. Potvrzeno ze dvou stran: příručka sází rozsahy těsně, a dokument ÚJČ k normě popisuje mezery v rozsahu jako povolenou VÝJIMKU pro víceslovné výrazy, což těsnou sazbu předpokládá jako pravidlo. Text samotné ČSN 01 6910 čten nebyl (je placený); citován je výklad jejích vlastních zpracovatelů, což je nejsilnější veřejně dostupná náhrada. Stránka rovněž uvádí, že pomlčka vyjadřující rozsah nemá stát na konci ani na začátku řádku — požadavek, pro který locale.schema.json nemá pole. Pravidlo ranges je ve výchozím stavu vypnuté (spec 0.5.0). Ověřeno 18. 9. 2026."
+    },
+    {
+      "rule": "ellipsis",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Tři tečky»: «jedná se totiž o jeden znak, nikoli tři samostatné tečky»; «Za třemi tečkami často následují další interpunkční znaménka, která se za tři tečky připojují bez mezery, ale nikdy se však nepřipojuje další tečka (nikoli tedy čtyři tečky vedle sebe)»",
+      "url": "https://prirucka.ujc.cas.cz/?id=166",
+      "note": "Odůvodňuje abbreviatedAfterTerminal = false. Výpustka je jeden znak U+2026 a otazník či vykřičník stojí ZA ní — ruská dvoutečková forma «?..» není v žádném konzultovaném českém zdroji předvídána. Bylo to ověřeno záměrně: ukrajinština, zkoumaná v témže průchodu, tu formu MÁ, takže analogie mezi slovanskými jazyky by tu byla svůdná a mylná. Ověřeno 18. 9. 2026."
+    },
+    {
+      "rule": "hyphen",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Spojovník»: «píše se bez mezer mezi výrazy, které spojuje»; «Spojovník na začátku dalšího řádku neopakujeme, naznačuje-li rozdělení slova (např. žong- | -lér)»; táž příručka, «Zalomení řádků a nevhodné výrazy na jejich konci», jejíž uzavřený výčet míst, kde k zalomení dojít nemá, spojovník neuvádí",
+      "url": "https://prirucka.ujc.cas.cz/?id=164",
+      "note": "Odůvodňuje tři prázdné seznamy. Čeština spojovník na konci řádku ani nezakazuje, ani — na rozdíl od polštiny — dělení v jeho místě nepředepisuje; neexistuje uzavřený normativní seznam tvarů, jejichž spojovník se nesmí lámat. To, že jej třináctibodový výčet stránky o zalomení řádků neobsahuje, je doložená nepřítomnost, ne nenalezená citace — a je to zároveň rozdíl proti ukrajinštině, kde § 64 п. 4 takový seznam má. Ověřeno 18. 9. 2026."
+    },
+    {
+      "rule": "nbsp",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Zalomení řádků a nevhodné výrazy na jejich konci»: k zalomení nemá dojít «ve spojení neslabičných předložek k, s, v, z s následujícím slovem, např. k mostu, s bratrem, v Plzni, z nádraží»; «ve spojení slabičných předložek o, u a spojek a, i s výrazem, který po nich následuje, např. u babičky, o páté»; «ve složených zkratkách a kódech, např. a. s., s. r. o.»; «mezi zkratkami tj., tzv., tzn. a následujícím výrazem»; «mezi zkratkou jména a příjmením»; «mezi číslem a značkou, např. 50 %, § 23»; «V textovém procesoru vkládáme tam, kde nemá dojít k zalomení řádku, místo běžné mezislovní mezery mezeru pevnou»",
+      "url": "https://prirucka.ujc.cas.cz/?id=880",
+      "note": "Pět polí z jednoho uzavřeného výčtu, který se odvolává na ČSN 01 6910. (1) afterShortWords: osm jednopísmenných výrazů, citovaných doslova. Na rozdíl od polštiny je zákaz v prameni BEZPODMÍNEČNÝ — není vázán na šířku sloupce ani na to, zda jde o titulek — takže zde nebylo co rozhodovat. (2) abbreviations: «a. s.» a «s. r. o.». Interakce s N3 ověřena a je opačná než u polského «i in.»: N3 vyžaduje, aby po jednopísmenném výrazu následovala mezera, a po «a» následuje tečka, takže N3 index nenárokuje a obě mezery dostane N4. «ČSN 01 6910» z výčtu vypuštěno: číslo normy není fakt o jazyce. (3) beforeWord: «tj.», «tzv.», «tzn.». Bod o «zkratce titulu» populován není, protože zdroj u něj žádný seznam neuvádí. (4) afterSymbols = [«§»]. Ze stejného citovaného bodu byly ZÁMĚRNĚ vynechány «*», «†» a «#»: řetězec «* 1921» je bajt po bajtu totožný s odrážkou seznamu následovanou číslicí, takže v režimu markdown by šlo o falešný zásah bez vyvažujícího přínosu. (5) initialBinding = «single»: pramen váže «zkratku jména» k příjmení a jeho vlastní příklady jsou Fr. Daneš a M. Těšitelová, tedy JEDNA zkrácená křestní jméno; «chain» by na ani jednom z nich nezabral a citované pravidlo by zůstalo nenaplněné. Expozici, kterou schéma u «single» samo pojmenovává, přijímáme na základě citace, stejně jako u fr. beforeNumber zůstává prázdné: jediným kandidátem je «strana 2», ale «strana» je víceznačné plnovýznamové slovo, nikoli zkratka — týž argument, jakým ru.json vylučuje «г.». Ověřeno 18. 9. 2026."
+    },
+    {
+      "rule": "nbsp",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Značky, čísla a číslice»: «Značky se od číselné hodnoty oddělují mezerou, číslo a značka se umísťují na stejný řádek», «např. 10 ha = 10 hektarů, 3 kg = 3 kilogramy, 14 % = 14 procent», «100 kWh», «rychlost 50 km/h», «teplota 12–15 °C»; BIPM, The International System of Units (SI), 9th ed., concise summary: «A single space is always left between the number and the unit»",
+      "url": "https://prirucka.ujc.cas.cz/?id=785",
+      "note": "Rozdělení rolí jako v en-US, fi, sv, es, pt a pl: BIPM říká, které řetězce jsou značkami jednotek SI, ÚJČ říká, jaká je česká konvence. České znění je přitom silnější, než nbsp.md §2.1 od locale vyžaduje: uvádí nejen mezeru, ale i to, že «číslo a značka se umísťují na stejný řádek». PŘÍPUSTNÁ VARIANTA, zaznamenána: «V případě, že pomocí číslice a značky vyjadřujeme přídavné jméno, mezeru nevkládáme: 8km = 8kilometrový, 20% = 20procentní». Rozpor není třeba řešit: N5 existující mezeru pouze nahrazuje a nikdy ji nevkládá (nbsp.md §3.7), takže «14 %» dostane U+00A0 a «20%» zůstane nedotčeno. Jednoznakové značky vypuštěny, a pro češtinu z konkrétního důvodu, ne ze stylové opatrnosti: «s» je zároveň vyjmenovaná jednopísmenná předložka, takže ve větě «Přišel v 5 s bratrem» by se «5» svázala se «s». Ověřeno 18. 9. 2026."
+    },
+    {
+      "rule": "nbsp",
+      "cite": "Ústav pro jazyk český AV ČR, Internetová jazyková příručka, «Otazník»: «Stejně jako naprostá většina interpunkčních znamének se připojuje k předcházejícímu slovu (zkratce, značce) bez mezery, za ním následuje mezera»; táž příručka, «Tři tečky»: «tři tečky následující za slovem se připojují bez mezery»",
+      "url": "https://prirucka.ujc.cas.cz/?id=171",
+      "note": "Odůvodňuje prázdné beforePunctuation i narrowBeforePunctuation. Čeština před «:», «;», «!», «?» nestaví ani U+00A0, ani U+202F, a zdroj jim odstup výslovně upírá — je to zápor, ne mlčení. Q-P je tím splněno triviálně. Ověřeno 18. 9. 2026."
+    }
+  ]
 }