@wix/himalaya-cli 0.930.0 → 0.932.0

package/guides/app-icon.md

@@ -31,6 +31,12 @@ himi icon generate                    # a gradient tile + glyph, for a customer
 himi icon glyphs                      # what `generate --glyph` accepts
 ```
 
+**No logo on the site?** `himi site analyze` reports `identity.logoUrl: null` for plenty of real
+sites, and `from-site` then has nothing to take. That is the `generate` case, not a dead end:
+`himi icon generate --glyph <name> --accent <hex>` draws a mark from the brand's own accent
+colour — see `himi icon glyphs` for the vocabulary. A QA run hit exactly this, inferred
+`generate` unaided, and both resulting binaries shipped their own mark (#2823 item 6).
+
 **`generate` with no `--glyph` draws `emblem`** — a mark that means nothing, on your app's
 accent colour. That is deliberate: every other glyph in the vocabulary asserts a business
 (`envelope` says mail, `cutlery` says restaurant), and a fallback fires precisely when

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.930.0",
+  "version": "0.932.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -64,5 +64,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "4aa36a3ff0999cd423ab13c46f38df173f2468df2b52718520fafcb5"
+  "falconPackageHash": "5594dcf1852eb9fcdca5e28365f47573679ebb1fdaab2421b0cdd6ee"
 }

package/stdlib/design-kits/README.md

@@ -0,0 +1,147 @@
+# Design Kits Catalog
+
+Shared, OTA-deliverable look-and-feel **kits** (RFC 0021). Any Himalaya app can adopt a kit; the token *names* stay canonical (compile-time-validated), a kit supplies *values* + primitive *selections*.
+
+## Kit JSON shape
+
+```jsonc
+{
+  "id": "liquid-glass",                 // kebab-case, == filename
+  "name": "Liquid Glass",               // human label (admin gallery)
+  "tags": ["surface"],                  // "surface" | "construction"
+  "kit": { "material": "glass",         // app-wide default surface material
+           "variant": "default" },      // app-wide default construction language
+  "manifest": { "materials": ["glass"], // primitives this kit RELIES on — gated by kit-coverage.test.ts
+                "variants": [] },
+  "tokens": { /* full tokens.json-shaped preset: colors, typography, spacing,
+                 radius, shadows, gradients, materials … */ }
+}
+```
+
+## The OTA-vs-native boundary
+
+- **Content is OTA** — token values, which `material`/`variant`, their params (blur/tint/opacity). Adding a kit that reuses existing primitives is a JSON file, no rebuild.
+- **The engine is native** — the code that *draws* a material (`flat`/`glass`/`frosted`) or a construction `variant` ships in the app binary (iOS SwiftUI, Android Compose, admin web preview).
+
+A kit may only name primitives that all renderers implement. `manifest.materials` / `manifest.variants` are the contract; **`core/dev-server/tests/kit-coverage.test.ts`** fails CI if a kit references a primitive the renderers don't yet support. Pushing a kit to an older binary degrades gracefully (unknown material/variant → flat/default).
+
+## Phase 1 kits (surface)
+
+| id | name | material |
+|----|------|----------|
+| `liquid-glass` | Liquid Glass | glass |
+| `material` | Flat / Material 3 | flat |
+| `minimal-editorial` | Minimal / Editorial | flat |
+| `dark-luxe` | Dark Luxe | flat |
+
+Phase 2 adds construction kits (neumorphic, brutalist, skeuomorphic, playful) that introduce `variant` languages. See `docs/superpowers/specs/2026-06-08-design-kits-design.md`.
+
+## Kit typography (WS-B)
+
+A kit may carry `tokens.typography` to give itself a typographic identity —
+per-style entries (`title1`, `body`, `heroTitle`, …) with an optional `family`.
+Three hard rules:
+
+1. **Entries must be COMPLETE — `size` + `weight` + `line`, always.** Native
+   token decode is strict (iOS `Tokens.swift` / Android `Tokens.kt`): one
+   family-only entry (`{"family": "Georgia"}`) makes the whole `DesignTokens`
+   decode throw. Kits are registered STANDALONE in places (KitSnapshotTests,
+   branded-lite), so you cannot rely on the serve-time deep-merge to fill the
+   gaps. Gated in CI by `tools/release-build/app-tokens-typography.test.ts`.
+2. **A `family` must be shippable, or it degrades — and is now reported.**
+   An unregistered family still renders as the system font (iOS/Android/macOS)
+   or falls down the web stack; what changed is that this is no longer silent.
+   Name a family outside the catalog and `himi fonts check`, `himi validate`,
+   `himi push` and `POST /v1/validate` all fail with an error, CI fails on
+   `app-tokens-family.test.ts`, and a family that slips all of those emits
+   `font_family_unresolved` once at runtime.
+   Registration is no longer a per-app boot concern either: apps declare faces
+   and `FontInstaller` registers them from that declaration. Pick a family with
+   `himi fonts list` — see [docs/fonts.md](../../docs/fonts.md) and
+   [RFC 0056](../../core/schema/RFC/0056-ota-custom-fonts.md).
+3. **Kit family beats the brand fill.** `branding.fontFamily`
+   (himi-branded-lite) only fills entries that ship no family of their own — a
+   kit's per-entry family always survives.
+
+Cross-platform-safe family values today:
+
+| family | iOS | Android | macOS | web |
+|--------|-----|---------|-------|-----|
+| *(none)* | system (SF) | system (Roboto) | system (SF) | Madefor Text stack |
+| `Wix Madefor Text` / `Wix Madefor Display` | ✅ registered | ✅ registered | ✅ himi-player | ✅ @font-face (web host + admin) |
+| `Georgia` | ✅ OS font | ≈ `serif` fallback | ✅ OS font | ✅ OS font; web stacks tail with `serif` |
+
+The web renderer resolves every family through `fontStack()`
+(`core/web-renderer/src/tokens.ts`): serif-shaped families get a `serif`
+generic tail (so a missing Georgia degrades to *a* serif, never into Madefor),
+sans families fall back to the Madefor+system chain. On Android, `Tokens.kt`
+carries a builtin degrade for the catalog's safe serif: an unregistered
+`Georgia` resolves to the platform generic `serif` (never the default sans).
+
+### Per-kit typographic personalities (WS-B phase 2)
+
+Every kit ships a full scale (`display`, `heroTitle`, `title1`–`title3`,
+`body`, `bodyEmphasis`, `footnote`, `caption`) — complete entries only. One
+line each (titles / body / the idea):
+
+| kit | titles | body | personality |
+|-----|--------|------|-------------|
+| `minimal-editorial` | Georgia 400–500, −0.2…−0.5 tracking, line 1.25–1.4, title1 30 | Madefor Text 400/1.5 | literary magazine — light serif headlines, airy |
+| `dark-luxe` | Madefor Display 400–500, **+0.8…+1.5 tracking**, title1 26 | Madefor Text 400/1.5/+0.2 | five-star hotel — smaller-but-spaced luxury caps feel |
+| `brutalist` | Madefor Display 700–800, −0.3…−1.0 tracking, line 1.1, display 44 → title3 18 | Madefor Text 400/1.4 | poster-loud — heavy, tight, big size jumps; caption goes Display 700 |
+| `playful` | Madefor Display 700, line 1.3–1.35, title1 31 (bigger than base) | Madefor Text 400/1.5 | friendly app — bouncy, roomy, bold |
+| `neumorphic` | Madefor Text 500–600, line 1.35–1.45, title1 26 | Madefor Text 400/1.5/+0.1 | calm — soft mid weights, muted level contrast |
+| `skeuomorphic` | *(system)* 600–700, classic iOS scale (title1 28) | *(system)* 400/1.45 | classic iOS — semibold titles; footnote/caption in Georgia (“printed label”) |
+| `material` | *(system)* 400 large titles / 500 mid (title1 28) | *(system)* 400/1.5/+0.15 | Material — Roboto IS the identity on Android; positive small-end tracking |
+| `liquid-glass` | *(system)* 600, −0.2…−0.6 tracking, display 40 / title1 32 | *(system)* 400/1.45/−0.1 | Apple-adjacent — SF is the glass identity, larger display/title1 |
+| `shadcn` | Madefor Text 600, line 1.25, compact (title1 24) | Madefor Text 400/1.45, body 15 | dashboard — tight professional scale, neutral tracking |
+
+Two CI gates keep this honest (`core/dev-server/tests/kit-coverage.test.ts`):
+every kit must ship a typography block covering at least `title1` + `body`,
+and no `title1` (family, weight, size, letterSpacing) tuple may be shared by
+more than 2 kits — the anti-regression against drifting back to uniform type.
+Keep `line` in the **1.1–1.5** range: iOS converts the multiple to additive
+line spacing, Android consumes the multiple, web treats it unitless — values
+outside that band diverge visibly across platforms.
+
+## Color coherence (the complete ladder)
+
+Every kit ships a **complete** color ladder — the union of tokens the built
+screens of all 16 CLI templates reference, plus the semantic completions:
+
+```
+surfacePrimary surfaceSecondary surfaceElevated surfaceSubtle
+textPrimary textSecondary textTertiary textOnAccent
+accentPrimary accentSecondary accentSurface border
+success successSurface warning warningSurface danger dangerSurface
+```
+
+An incomplete ladder is a **bug**, not a shorthand: kit colors merge arm-by-arm
+over the app's base tokens, so any missing token leaks the base value through —
+the original dark-luxe kit had no `surfaceElevated`, and every card glared
+white (`#FFFFFF`) on its near-black page. **`core/dev-server/tests/kit-coherence.test.ts`**
+gates this in CI: full ladder present; per arm textPrimary ≥ 7:1 / textSecondary
+≥ 4.5:1 / textTertiary ≥ 3:1 on both `surfacePrimary` and `surfaceElevated`;
+elevation subtle (≤ 2:1 vs the page, dark arms stepping *lighter* as elevation
+rises); accents ≥ 3:1 on the page with textOnAccent ≥ 4.5:1; semantic colors
+≥ 3:1 on the page and on their own surfaces.
+
+Deliberate judgment calls (the 2026-07 color reconsideration):
+
+- **playful** — the hot-pink `textPrimary` failed 7:1 everywhere; legibility
+  wins. Body ink is now a deep berry (`#821B47`) that keeps the personality;
+  the original pink lives on as `accentSecondary` for headings-scale accents,
+  and `accentPrimary` deepened one notch (`#DE1673`) so white button text passes.
+- **brutalist** — white cards ON yellow stay: stark contrast IS the language
+  (text on the yellow is black at ~18:1, verified). Radius stays 0; semantics
+  are primary-color loud on purpose.
+- **dark-luxe** — inherently dark: light arm == dark arm by design. The gold
+  `glow` shadow stays gold in the kit but is **retinted to the brand accent at
+  merge time** (`branding.ts`) so it never clashes with a template's accent.
+- **skeuomorphic / neumorphic** — dark-mode gloss/emboss pairs re-tuned so the
+  bevel highlight sits just above the surface and the shadow just below
+  (`glossTop/glossBottom`, `neumoLight/neumoDark`); elevation in dark mode comes
+  from those pairs plus a gentle lighter step, never from a bright card.
+- **shadcn** — dark `danger` was a *background* red (`#7F1D1D`, 1.6:1 on the
+  page); it is now a legible foreground red (`#F87171`) with `dangerSurface`
+  carrying the fill role.

package/stdlib/design-kits/brutalist.json

@@ -0,0 +1,202 @@
+{
+  "id": "brutalist",
+  "name": "Brutalist",
+  "tags": [
+    "construction"
+  ],
+  "kit": {
+    "material": "flat",
+    "variant": "brutalist"
+  },
+  "manifest": {
+    "materials": [
+      "flat"
+    ],
+    "variants": [
+      "brutalist"
+    ]
+  },
+  "tokens": {
+    "colors": {
+      "surfacePrimary": {
+        "light": "#FFE600",
+        "dark": "#0D0D0D"
+      },
+      "surfaceSecondary": {
+        "light": "#FFFFFF",
+        "dark": "#1A1A1A"
+      },
+      "surfaceElevated": {
+        "light": "#FFFFFF",
+        "dark": "#232323"
+      },
+      "surfaceSubtle": {
+        "light": "#FFEE4D",
+        "dark": "#131313"
+      },
+      "textPrimary": {
+        "light": "#000000",
+        "dark": "#FFFFFF"
+      },
+      "textSecondary": {
+        "light": "#333333",
+        "dark": "#BBBBBB"
+      },
+      "textTertiary": {
+        "light": "#575757",
+        "dark": "#8C8C8C"
+      },
+      "textOnAccent": {
+        "light": "#000000",
+        "dark": "#000000"
+      },
+      "accentPrimary": {
+        "light": "#E63900",
+        "dark": "#FF6A2B"
+      },
+      "accentSecondary": {
+        "light": "#0000E6",
+        "dark": "#5C5CFF"
+      },
+      "accentSurface": {
+        "light": "#FFF6B3",
+        "dark": "#1F1F1F"
+      },
+      "success": {
+        "light": "#008A2E",
+        "dark": "#33E633"
+      },
+      "successSurface": {
+        "light": "#D6FFD6",
+        "dark": "#112911"
+      },
+      "warning": {
+        "light": "#7A4D00",
+        "dark": "#FFB300"
+      },
+      "warningSurface": {
+        "light": "#FFF3C2",
+        "dark": "#292109"
+      },
+      "danger": {
+        "light": "#D60000",
+        "dark": "#FF3333"
+      },
+      "dangerSurface": {
+        "light": "#FFD6D6",
+        "dark": "#291111"
+      },
+      "border": {
+        "light": "#000000",
+        "dark": "#FFFFFF"
+      }
+    },
+    "materials": {
+      "flat": {
+        "style": "flat",
+        "tint": "surfaceSecondary",
+        "opacity": 1
+      }
+    },
+    "typography": {
+      "display": {
+        "size": 44,
+        "weight": 800,
+        "line": 1.1,
+        "letterSpacing": -1.0,
+        "family": "Wix Madefor Display"
+      },
+      "heroTitle": {
+        "size": 38,
+        "weight": 800,
+        "line": 1.1,
+        "letterSpacing": -0.8,
+        "family": "Wix Madefor Display"
+      },
+      "title1": {
+        "size": 34,
+        "weight": 800,
+        "line": 1.1,
+        "letterSpacing": -0.8,
+        "family": "Wix Madefor Display"
+      },
+      "title2": {
+        "size": 24,
+        "weight": 800,
+        "line": 1.12,
+        "letterSpacing": -0.5,
+        "family": "Wix Madefor Display"
+      },
+      "title3": {
+        "size": 18,
+        "weight": 700,
+        "line": 1.15,
+        "letterSpacing": -0.3,
+        "family": "Wix Madefor Display"
+      },
+      "body": {
+        "size": 16,
+        "weight": 400,
+        "line": 1.4,
+        "letterSpacing": 0,
+        "family": "Wix Madefor Text"
+      },
+      "bodyEmphasis": {
+        "size": 16,
+        "weight": 700,
+        "line": 1.3,
+        "letterSpacing": 0,
+        "family": "Wix Madefor Text"
+      },
+      "footnote": {
+        "size": 13,
+        "weight": 500,
+        "line": 1.3,
+        "letterSpacing": 0,
+        "family": "Wix Madefor Text"
+      },
+      "caption": {
+        "size": 12,
+        "weight": 700,
+        "line": 1.25,
+        "letterSpacing": 0.5,
+        "family": "Wix Madefor Display"
+      }
+    },
+    "variantParams": {
+      "brutalist": {
+        "offset": 4,
+        "borderWidth": 3,
+        "shadowToken": "border"
+      }
+    },
+    "radius": {
+      "sm": 0,
+      "md": 0,
+      "pill": 0
+    },
+    "tabBar": {
+      "background": {
+        "color": "surfacePrimary"
+      },
+      "shape": {
+        "kind": "full"
+      },
+      "border": {
+        "topHairline": true,
+        "color": "border",
+        "width": 3
+      },
+      "selectedIndicator": {
+        "kind": "colorOnly",
+        "color": "accentPrimary"
+      },
+      "activeTint": "accentPrimary",
+      "inactiveTint": "textPrimary",
+      "labels": {
+        "show": true
+      },
+      "motion": "crisp"
+    }
+  }
+}

package/stdlib/design-kits/dark-luxe.json

@@ -0,0 +1,197 @@
+{
+  "id": "dark-luxe",
+  "name": "Dark Luxe",
+  "tags": [
+    "surface"
+  ],
+  "kit": {
+    "material": "flat",
+    "variant": "default"
+  },
+  "manifest": {
+    "materials": [
+      "flat"
+    ],
+    "variants": []
+  },
+  "tokens": {
+    "colors": {
+      "surfacePrimary": {
+        "light": "#0B0D12",
+        "dark": "#0B0D12"
+      },
+      "surfaceSecondary": {
+        "light": "#14171F",
+        "dark": "#14171F"
+      },
+      "surfaceElevated": {
+        "light": "#1B1F29",
+        "dark": "#1B1F29"
+      },
+      "surfaceSubtle": {
+        "light": "#101319",
+        "dark": "#101319"
+      },
+      "textPrimary": {
+        "light": "#F1E9D2",
+        "dark": "#F1E9D2"
+      },
+      "textSecondary": {
+        "light": "#9AA0AC",
+        "dark": "#9AA0AC"
+      },
+      "textTertiary": {
+        "light": "#777E8C",
+        "dark": "#777E8C"
+      },
+      "textOnAccent": {
+        "light": "#1A1303",
+        "dark": "#1A1303"
+      },
+      "accentPrimary": {
+        "light": "#E9C46A",
+        "dark": "#E9C46A"
+      },
+      "accentSecondary": {
+        "light": "#C9A86A",
+        "dark": "#C9A86A"
+      },
+      "accentSurface": {
+        "light": "#221D11",
+        "dark": "#221D11"
+      },
+      "success": {
+        "light": "#95C9A2",
+        "dark": "#95C9A2"
+      },
+      "successSurface": {
+        "light": "#131F17",
+        "dark": "#131F17"
+      },
+      "warning": {
+        "light": "#E0B354",
+        "dark": "#E0B354"
+      },
+      "warningSurface": {
+        "light": "#211B0E",
+        "dark": "#211B0E"
+      },
+      "danger": {
+        "light": "#E08983",
+        "dark": "#E08983"
+      },
+      "dangerSurface": {
+        "light": "#221214",
+        "dark": "#221214"
+      },
+      "border": {
+        "light": "#262B36",
+        "dark": "#262B36"
+      }
+    },
+    "materials": {
+      "flat": {
+        "style": "flat",
+        "tint": "surfaceSecondary",
+        "opacity": 1
+      }
+    },
+    "typography": {
+      "display": {
+        "size": 32,
+        "weight": 400,
+        "line": 1.25,
+        "letterSpacing": 1.5,
+        "family": "Wix Madefor Display"
+      },
+      "heroTitle": {
+        "size": 28,
+        "weight": 400,
+        "line": 1.3,
+        "letterSpacing": 1.2,
+        "family": "Wix Madefor Display"
+      },
+      "title1": {
+        "size": 26,
+        "weight": 400,
+        "line": 1.3,
+        "letterSpacing": 1.2,
+        "family": "Wix Madefor Display"
+      },
+      "title2": {
+        "size": 21,
+        "weight": 500,
+        "line": 1.32,
+        "letterSpacing": 1.0,
+        "family": "Wix Madefor Display"
+      },
+      "title3": {
+        "size": 17,
+        "weight": 500,
+        "line": 1.35,
+        "letterSpacing": 0.8,
+        "family": "Wix Madefor Display"
+      },
+      "body": {
+        "size": 16,
+        "weight": 400,
+        "line": 1.5,
+        "letterSpacing": 0.2,
+        "family": "Wix Madefor Text"
+      },
+      "bodyEmphasis": {
+        "size": 16,
+        "weight": 500,
+        "line": 1.5,
+        "letterSpacing": 0.3,
+        "family": "Wix Madefor Text"
+      },
+      "footnote": {
+        "size": 13,
+        "weight": 400,
+        "line": 1.45,
+        "letterSpacing": 0.6,
+        "family": "Wix Madefor Text"
+      },
+      "caption": {
+        "size": 12,
+        "weight": 400,
+        "line": 1.4,
+        "letterSpacing": 1.0,
+        "family": "Wix Madefor Text"
+      }
+    },
+    "shadows": {
+      "glow": {
+        "color": "#E9C46A",
+        "opacity": 0.12,
+        "radius": 24,
+        "x": 0,
+        "y": 0
+      }
+    },
+    "radius": {
+      "sm": 10,
+      "md": 14,
+      "pill": 22
+    },
+    "tabBar": {
+      "background": {
+        "color": "surfacePrimary"
+      },
+      "shape": {
+        "kind": "full"
+      },
+      "selectedIndicator": {
+        "kind": "underline",
+        "color": "accentPrimary"
+      },
+      "activeTint": "accentPrimary",
+      "inactiveTint": "textSecondary",
+      "labels": {
+        "show": true
+      },
+      "motion": "smooth"
+    }
+  }
+}