@hanzo/ui 8.29.10 → 8.29.12

package/dist/theme.css

@@ -802,9 +802,10 @@
 }
 
 /* ── tokens/fonts.css ─────────────────────────────────────── */
-/* Zen — the only family on Hanzo surfaces, sans and mono.
+/* Zen — the family on Hanzo surfaces, sans and mono, and its Arabic companions.
    SELF-HOSTED. The faces ship inside this package (assets/fonts/*.woff2, two
-   variable files, 141 KB total, SIL OFL-1.1 — see assets/fonts/LICENSE-Zen.txt).
+   variable files, 141 KB total, SIL OFL-1.1 — see assets/fonts/LICENSE-Zen.txt),
+   with two Arabic companions beside them (below).
 
    Zen is our own family, under the SIL Open Font License. The licence file
    beside the binaries carries every copyright the OFL requires; nothing else in
@@ -853,11 +854,51 @@
 
 
 
+/* ARABIC. Zen draws Latin and Cyrillic and no Arabic, so an Arabic page used to
+   fall to whatever face each browser picked. @hanzo/font carries two Arabic
+   companions, variable over Zen's own weight axis and cut to the Arabic blocks,
+   and they are copied here with the Zen faces: Noto Kufi Arabic (the default,
+   geometric like Zen) and Noto Sans Arabic. Both draw every Arabic-script
+   language Hanzo ships. They are not ours and keep their names; their licence is
+   assets/fonts/LICENSE-Arabic.txt.
+
+   THE RANGE IS THE WHOLE TRICK. Each face covers the Arabic blocks only, so a
+   page with no Arabic on it never requests one, and Latin inside an Arabic page
+   is still Zen. The joiners (U+200C-200F) are drawn by the files but kept out of
+   the range: an English page with an emoji ZWJ sequence would otherwise fetch an
+   Arabic face for one invisible character.
+
+   Every stack below names `--font-arabic` FIRST. A family whose range excludes a
+   character is passed over without a download, so Latin falls through to Zen,
+   and the "first available font" a line box and `ch` are measured from is still
+   Zen (its range covers the space; the companion's does not). That is what makes
+   the choice one property: `@hanzo/appearance` writes `--font-arabic`, and sans,
+   mono and serif follow.
+
+   The default is ALSO declared under "Zen" and "Zen Mono", for anything that
+   names a family rather than a token. That only works because its descriptors
+   are Zen's exactly (weight 100 900, normal): faces in one family composite only
+   when everything but the range matches, and a companion declared at another
+   weight wins the weight match for Latin too, refuses every Latin letter, and
+   sends the page to the system sans with no font request to show for it.
+
+   `block` for the reason Zen has it: an Arabic page waits a moment for its face
+   rather than painting the platform's and repainting. */
+
+
+
+
+
 :root{
-  --font-sans:Zen, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+  /* The Arabic companions by what they are, and the one in use. A person's
+     choice replaces --font-arabic with one of the two names above it. */
+  --font-arabic-kufi:"Noto Kufi Arabic";
+  --font-arabic-sans:"Noto Sans Arabic";
+  --font-arabic:var(--font-arabic-kufi);
+  --font-sans:var(--font-arabic), Zen, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
   --font-display:var(--font-sans);
-  --font-mono:Zen Mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
-  --font-serif:Georgia,serif;
+  --font-mono:var(--font-arabic), Zen Mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
+  --font-serif:var(--font-arabic), Georgia, serif;
   /* The default is Zen as drawn, and that is a decision rather than an omission.
      `base.css` puts this on <body>, so whatever is here is the voice of every
      surface in the estate — which is exactly why it should not carry a brand's.
@@ -2115,7 +2156,12 @@
 
 @layer hanzo.font {
   :root {
-    --font-sans: var(--font-sans-provided, 'Zen', ui-sans-serif, system-ui, sans-serif);
+    /* `--font-script` is the face for the page's writing system, which
+       lang.css sets per :lang() — Arabic, Hebrew, Devanagari, Thai, CJK and the
+       rest. It follows the brand face, so Latin keeps Zen and every glyph Zen
+       lacks falls through to a face drawn for it. Unset, the stack is the one
+       this always was. */
+    --font-sans: var(--font-sans-provided, 'Zen'), var(--font-script, ui-sans-serif), system-ui, sans-serif;
     --font-mono: var(--font-mono-provided, 'Zen Mono', ui-monospace, monospace);
   }
 }
@@ -2328,14 +2374,15 @@
   color: var(--foreground);
   font-family: var(--font-sans), sans-serif;
   font-size: var(--text-base);
-  line-height: var(--leading-base, var(--leading-normal));
+  /* `--leading-lang` opens the line for scripts with tall marks (lang.css). */
+  line-height: calc(var(--leading-base, var(--leading-normal)) * var(--leading-lang, 1));
 }
 
 [data-slot='prose'] > h1, [data-slot='prose'] > h2, [data-slot='prose'] > h3,
 [data-slot='prose'] > h4, [data-slot='prose'] > h5, [data-slot='prose'] > h6 {
   font-family: var(--font-display, var(--font-sans)), sans-serif;
   font-weight: 606;
-  line-height: var(--leading-tight);
+  line-height: calc(var(--leading-tight) * var(--leading-lang, 1));
   letter-spacing: var(--tracking-tight);
   margin: 0;
 }
@@ -2438,6 +2485,20 @@
   [data-slot='prose'][data-size='responsive'] > h2 { font-size: var(--text-5xl) }
 }
 
+/* DIRECTION. Sides are logical properties throughout, so a page follows
+   <html dir="rtl"> with no rule here. An icon whose meaning is a direction along
+   the line (back, forward, next, a drill-in chevron, send) carries
+   `data-i18n-mirror` (the `mirror` helper) and turns with the line. `:dir()`
+   rather than `html[dir]`, so an LTR island inside an RTL page keeps its
+   arrows; the same declaration @hanzo/i18n's rtl.css and @hanzo/gui's base sheet
+   state, so any number of them on one page mirror an icon once. */
+[data-i18n-mirror]:dir(rtl) { transform: scaleX(-1) }
+
+/* Text whose order is not language (a shortcut, a key chord, an email or URL
+   field) carries `data-i18n-ltr` (the `ltr` helper) and stays left to right,
+   isolated so the line around it keeps its own order. */
+[data-i18n-ltr] { direction: ltr; unicode-bidi: isolate }
+
 /* Glass — the material floating chrome is made of, and the ladder it stands on.
  *
  *   import '@hanzo/ui/glass.css'      // this slice alone
@@ -2839,6 +2900,16 @@
   will-change: transform;
 }
 
+/* Where a panel waits off screen, by the edge it slides from. A translate has no
+   logical form, so the reading edges resolve here: `end` is off the right under
+   LTR and off the left under RTL. */
+[data-slide-from='end'],
+[data-slide-from='right'] { --slide-off: 100%; }
+[data-slide-from='start'],
+[data-slide-from='left'] { --slide-off: -100%; }
+[data-slide-from='end']:dir(rtl) { --slide-off: -100%; }
+[data-slide-from='start']:dir(rtl) { --slide-off: 100%; }
+
 [data-motion='drag'] {
   touch-action: none;
   transition: transform 180ms cubic-bezier(0.16, 1, 0.3, 1);
@@ -3018,6 +3089,16 @@
   animation: sweep var(--duration-loop, 1.5s) ease-in-out infinite;
 }
 
+/* Under RTL the bar starts at the right edge and crosses the way the line reads. */
+@keyframes sweep-rtl {
+  from { transform: translateX(100%); }
+  to { transform: translateX(-400%); }
+}
+
+[data-motion='sweep']:dir(rtl) {
+  animation-name: sweep-rtl;
+}
+
 @keyframes orbit {
   from { transform: rotate(-90deg); }
   to { transform: rotate(270deg); }
@@ -3037,6 +3118,11 @@
   animation: drain var(--drain, 6000ms) linear forwards;
 }
 
+/* A fill empties toward the inline start: the right edge under RTL. */
+[data-motion='drain']:dir(rtl) {
+  transform-origin: right center;
+}
+
 [data-motion='drain'][data-paused] {
   animation-play-state: paused;
 }
@@ -3053,3 +3139,147 @@
     animation-play-state: paused;
   }
 }
+
+/**
+ * @hanzo/ui/lang.css — type for every writing system the interface ships in.
+ *
+ *   import '@hanzo/ui/lang.css'   (theme.css already carries it)
+ *
+ * Driven by the document's language, `<html lang>`, which @hanzo/i18n sets
+ * together with `dir`. Direction itself lives in @hanzo/i18n's rtl.css and in
+ * the components' logical properties; this file is the TYPE half:
+ *
+ *   1. a face per script (`--font-script`). theme.css puts it after the brand
+ *      face, so Latin stays Zen and every glyph Zen lacks falls through to a
+ *      face drawn for its script. Noto first, because it covers every script
+ *      here at one weight axis, then the face each platform ships, so a machine
+ *      without Noto still renders the script as its own people expect.
+ *   2. line height for scripts whose marks stand above or hang below the
+ *      Latin line (`--leading-lang`, a multiplier the type ladder and prose
+ *      read). Latin, Cyrillic, Greek, Hebrew, Georgian, Armenian: 1.
+ *   3. no letter-spacing on connected scripts. Arabic joins letter to letter
+ *      and the Indic headstroke runs across a word; tracking pulls both apart.
+ *   4. no brand tweaks on Arabic-script text: the `ss01` stylistic set and
+ *      `text-transform` are Latin ideas (a single-storey a, capitals).
+ *   5. numerals that line up in tables in every script.
+ *
+ * Every selector is `:lang()`, which matches by prefix: `:lang(fa)` takes fa-IR
+ * and fa-AF, `:lang(pa-Arab)` takes pa-Arab-PK and leaves Gurmukhi pa alone.
+ */
+
+/* ── 1. Faces ──────────────────────────────────────────────────────────── */
+
+/* Arabic script, Naskh: Arabic, Persian (Iran and Afghanistan), Pashto,
+   Sorani Kurdish, Uyghur. Noto Sans Arabic for the interface, Noto Naskh Arabic
+   behind it for the letters Sans lacks. */
+:is(:lang(ar), :lang(fa), :lang(prs), :lang(ps), :lang(ckb), :lang(ku-Arab), :lang(ug), :lang(ks), :lang(bal), :lang(glk), :lang(mzn)) {
+  --font-script: 'Noto Sans Arabic', 'Noto Naskh Arabic', 'SF Arabic', 'Geeza Pro', 'Segoe UI', Tahoma, ui-sans-serif;
+}
+
+/* Sindhi is set in Naskh, whose letter forms it was drawn in; Sans lacks
+   several of its dotted letters. */
+:lang(sd) {
+  --font-script: 'Noto Naskh Arabic', 'Noto Sans Arabic', 'Segoe UI', Tahoma, ui-sans-serif;
+}
+
+/* Nastaliq: Urdu and Shahmukhi Punjabi read in it, and Naskh reads to them as
+   Arabic. Naskh behind it for anything Nastaliq does not cover. */
+:is(:lang(ur), :lang(pa-Arab), :lang(pnb), :lang(skr)) {
+  --font-script: 'Noto Nastaliq Urdu', 'Urdu Typesetting', 'Jameel Noori Nastaleeq', 'Noto Naskh Arabic', 'Noto Sans Arabic', 'Segoe UI', Tahoma, ui-sans-serif;
+}
+
+:is(:lang(he), :lang(yi)) {
+  --font-script: 'Noto Sans Hebrew', 'Arial Hebrew', 'Segoe UI', ui-sans-serif;
+}
+
+:is(:lang(hi), :lang(mr), :lang(ne), :lang(sa), :lang(bho), :lang(mai), :lang(kok), :lang(doi)) {
+  --font-script: 'Noto Sans Devanagari', 'Kohinoor Devanagari', 'Devanagari Sangam MN', 'Nirmala UI', 'Mangal', ui-sans-serif;
+}
+:is(:lang(bn), :lang(as), :lang(mni)) {
+  --font-script: 'Noto Sans Bengali', 'Kohinoor Bangla', 'Bangla Sangam MN', 'Nirmala UI', 'Vrinda', ui-sans-serif;
+}
+:lang(ta) { --font-script: 'Noto Sans Tamil', 'Tamil Sangam MN', 'Nirmala UI', 'Latha', ui-sans-serif; }
+:lang(te) { --font-script: 'Noto Sans Telugu', 'Kohinoor Telugu', 'Telugu Sangam MN', 'Nirmala UI', 'Gautami', ui-sans-serif; }
+:lang(kn) { --font-script: 'Noto Sans Kannada', 'Kannada Sangam MN', 'Nirmala UI', 'Tunga', ui-sans-serif; }
+:lang(ml) { --font-script: 'Noto Sans Malayalam', 'Malayalam Sangam MN', 'Nirmala UI', 'Kartika', ui-sans-serif; }
+:lang(gu) { --font-script: 'Noto Sans Gujarati', 'Kohinoor Gujarati', 'Gujarati Sangam MN', 'Nirmala UI', 'Shruti', ui-sans-serif; }
+/* Gurmukhi is Punjabi's default script; Shahmukhi took pa-Arab above. */
+:is(:lang(pa), :lang(pa-Guru)):not(:lang(pa-Arab)) {
+  --font-script: 'Noto Sans Gurmukhi', 'Gurmukhi Sangam MN', 'Nirmala UI', 'Raavi', ui-sans-serif;
+}
+:lang(si) { --font-script: 'Noto Sans Sinhala', 'Sinhala Sangam MN', 'Nirmala UI', 'Iskoola Pota', ui-sans-serif; }
+:lang(th) { --font-script: 'Noto Sans Thai', 'Thonburi', 'Leelawadee UI', 'Tahoma', ui-sans-serif; }
+:lang(lo) { --font-script: 'Noto Sans Lao', 'Lao Sangam MN', 'Leelawadee UI', 'Lao UI', ui-sans-serif; }
+:lang(km) { --font-script: 'Noto Sans Khmer', 'Khmer Sangam MN', 'Leelawadee UI', 'Khmer UI', ui-sans-serif; }
+:lang(my) { --font-script: 'Noto Sans Myanmar', 'Myanmar Sangam MN', 'Myanmar Text', ui-sans-serif; }
+:is(:lang(bo), :lang(dz)) { --font-script: 'Noto Serif Tibetan', 'Noto Sans Tibetan', 'Kailasa', 'Microsoft Himalaya', ui-sans-serif; }
+:lang(ka) { --font-script: 'Noto Sans Georgian', 'Helvetica Neue', 'Sylfaen', ui-sans-serif; }
+:lang(hy) { --font-script: 'Noto Sans Armenian', 'Mshtakan', 'Sylfaen', ui-sans-serif; }
+:is(:lang(am), :lang(ti), :lang(om-Ethi)) { --font-script: 'Noto Sans Ethiopic', 'Kefa', 'Nyala', 'Ebrima', ui-sans-serif; }
+
+/* Han is unified across Chinese, Japanese and Korean, and each reads the
+   others' forms of the same character as foreign. So the face is chosen by
+   language, never by script alone. */
+:is(:lang(zh-Hans), :lang(zh-CN), :lang(zh-SG), :lang(zh)) {
+  --font-script: 'Noto Sans SC', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', ui-sans-serif;
+}
+:is(:lang(zh-Hant), :lang(zh-TW)) {
+  --font-script: 'Noto Sans TC', 'PingFang TC', 'Microsoft JhengHei', ui-sans-serif;
+}
+:is(:lang(zh-HK), :lang(zh-MO)) { --font-script: 'Noto Sans HK', 'PingFang HK', 'Microsoft JhengHei', ui-sans-serif; }
+:lang(ja) { --font-script: 'Noto Sans JP', 'Hiragino Sans', 'Hiragino Kaku Gothic ProN', 'Yu Gothic UI', 'Meiryo', ui-sans-serif; }
+:lang(ko) { --font-script: 'Noto Sans KR', 'Apple SD Gothic Neo', 'Malgun Gothic', ui-sans-serif; }
+
+/* ── 2. Line height ─────────────────────────────────────────────────────── */
+
+/* Marks above and below the line: Arabic harakat, the Indic matras and
+   conjuncts, Thai and Lao tone marks stacked over vowels, Khmer subscripts,
+   Burmese medials, Tibetan stacks. Measured against the Latin ladder, which
+   sets 14px on 20px: these need roughly 1.15x to 1.5x the space to keep one
+   line's marks out of the next. */
+:is(:lang(ar), :lang(fa), :lang(prs), :lang(ps), :lang(ckb), :lang(ku-Arab), :lang(ug), :lang(sd), :lang(ks), :lang(bal), :lang(glk), :lang(mzn)) { --leading-lang: 1.15; }
+:is(:lang(hi), :lang(mr), :lang(ne), :lang(sa), :lang(bho), :lang(mai), :lang(kok), :lang(doi), :lang(bn), :lang(as), :lang(mni), :lang(gu), :lang(pa), :lang(ta), :lang(te), :lang(kn), :lang(ml), :lang(si)) { --leading-lang: 1.2; }
+:is(:lang(th), :lang(lo)) { --leading-lang: 1.25; }
+:is(:lang(km), :lang(my)) { --leading-lang: 1.35; }
+:is(:lang(bo), :lang(dz)) { --leading-lang: 1.4; }
+:is(:lang(zh), :lang(ja), :lang(ko), :lang(am), :lang(ti)) { --leading-lang: 1.1; }
+/* Nastaliq descends along a diagonal baseline; each word steps down from its
+   first letter, so a line needs half again its Latin height. After the Naskh
+   rule so pa-Arab takes this one rather than Gurmukhi's. */
+:is(:lang(ur), :lang(pa-Arab), :lang(pnb), :lang(skr)) { --leading-lang: 1.5; }
+
+/* The body's own leading, for content that arrives as bare tags. Only where a
+   script above asked for more, so a host that brings its own body leading and
+   no tall script keeps it untouched. */
+:root:is(:lang(ar), :lang(fa), :lang(prs), :lang(ps), :lang(ckb), :lang(ku-Arab), :lang(ug), :lang(sd), :lang(ks), :lang(bal), :lang(glk), :lang(mzn), :lang(ur), :lang(pa-Arab), :lang(pnb), :lang(skr), :lang(hi), :lang(mr), :lang(ne), :lang(sa), :lang(bho), :lang(mai), :lang(kok), :lang(doi), :lang(bn), :lang(as), :lang(mni), :lang(gu), :lang(pa), :lang(ta), :lang(te), :lang(kn), :lang(ml), :lang(si), :lang(th), :lang(lo), :lang(km), :lang(my), :lang(bo), :lang(dz), :lang(zh), :lang(ja), :lang(ko), :lang(am), :lang(ti)) body {
+  line-height: calc(var(--leading-base, 1.35rem) * var(--leading-lang));
+}
+
+/* ── 3 and 4. Connected scripts: no tracking, no Latin tweaks ───────────── */
+
+/* !important because the type ladder states its tracking as an atomic class
+   on the element itself (-0.025em on headline rungs), and a class on the
+   element beats anything inherited. Tracking a connected script is never a
+   choice; it breaks the joins. */
+:is(:lang(ar), :lang(fa), :lang(prs), :lang(ps), :lang(ckb), :lang(ku-Arab), :lang(ug), :lang(sd), :lang(ks), :lang(bal), :lang(glk), :lang(mzn), :lang(ur), :lang(pa-Arab), :lang(pnb), :lang(skr), :lang(syr), :lang(nqo), :lang(mn-Mong)) {
+  letter-spacing: 0 !important;
+  /* `ss01` is the brand's single-storey a; in an Arabic face the same tag
+     names an unrelated alternate, or a different letter entirely. */
+  --font-feature-settings: normal;
+  font-feature-settings: normal;
+  text-transform: none !important;
+}
+/* The headstroke of Devanagari, Bengali and Gurmukhi is one line across a
+   word; tracking breaks it into letters. */
+:is(:lang(hi), :lang(mr), :lang(ne), :lang(sa), :lang(bho), :lang(mai), :lang(kok), :lang(doi), :lang(bn), :lang(as), :lang(mni), :lang(pa)) {
+  letter-spacing: 0 !important;
+}
+
+/* ── 5. Numerals ────────────────────────────────────────────────────────── */
+
+/* Tables and counters align digits whatever the language, and Persian and
+   Arabic-Indic digits come in a tabular form in the same faces. Code, URLs and
+   email stay left to right with their own numerals (rtl.css isolates them). */
+:is(:lang(ar), :lang(fa), :lang(prs), :lang(ps), :lang(ckb), :lang(ug), :lang(sd), :lang(ur), :lang(pa-Arab), :lang(pnb), :lang(he)) :where(td, th, data, time, output, meter, .hz-tnum, [data-numeric]) {
+  font-variant-numeric: tabular-nums;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzo/ui",
-  "version": "8.29.10",
+  "version": "8.29.12",
   "type": "module",
   "description": "Hanzo UI — the one canonical Hanzo component library, on @hanzo/gui + @hanzo/design. ONE substrate: every component renders through @hanzo/gui primitives, so the same import works on web, native (expo) and desktop (Tauri). Self-contained (theme.css), presentational, host-agnostic, clean-room.",
   "exports": {
@@ -85,6 +85,7 @@
     },
     "./theme.css": "./dist/theme.css",
     "./glass.css": "./dist/glass.css",
+    "./lang.css": "./dist/lang.css",
     "./glass": {
       "types": "./dist/glass.d.ts",
       "import": "./dist/glass.js",
@@ -314,9 +315,9 @@
     "@codemirror/language": "^6.12.4",
     "@codemirror/state": "^6.7.6",
     "@codemirror/view": "^6.43.13",
-    "@hanzo/appearance": "0.2.7",
+    "@hanzo/appearance": "0.2.11",
     "@hanzo/brand": "1.4.8",
-    "@hanzo/design": "0.5.35",
+    "@hanzo/design": "0.5.37",
     "@hanzo/font": "1.9.2",
     "@hanzo/tokens": "^1.1.1",
     "@hanzo/logo": "1.0.26",
@@ -434,6 +435,8 @@
     "test:responsive": "node scripts/responsive.mjs",
     "test:contain": "node scripts/contain.mjs",
     "test:corner": "node scripts/corner.mjs",
+    "test:code": "node scripts/code.mjs",
+    "test:rtl": "node scripts/compose-theme.mjs && node scripts/rtl.mjs",
     "test:consumer": "node scripts/consumer-test.mjs",
     "test:unit": "vitest run",
     "test:consumer:webpack": "node scripts/consumer-webpack.mjs"