@epilot/zenith-react 0.1.0-next.0 → 0.1.0

package/dist/styles/make-styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"make-styles.js","sources":["../../src/styles/make-styles.ts"],"sourcesContent":["import * as React from \"react\"\nimport {\n  createZenithStylesRecipe as runtimeCreateZenithStylesRecipe,\n  createZenithResetStylesRecipe as runtimeCreateZenithResetStylesRecipe,\n  type GriffelResetStyle,\n  type GriffelStyle,\n} from \"@epilot/zenith-runtime/v1\"\n\nimport { ensureCoreTokens } from \"../tokens/install\"\nimport { useZenithTargetDocument } from \"./document-context\"\n\n/**\n * The runtime's style hooks, with this package's token sheet attached.\n *\n * WHY THIS WRAPPER EXISTS, AND WHY IT IS NOT IN THE RUNTIME. Token installation used to sit inside\n * the renderer. It cannot any more, and not for a packaging reason: the runtime is SHARED, and\n * token values are exactly the thing that must diverge per component-package version — their\n * value-derived property namespace is what lets two versions declare on `:root` without colliding.\n * A shared module cannot own a per-version sheet. So the runtime owns placement (the recipe's\n * `install`, anchored) and this package owns content, and the two meet here.\n *\n * WHY COMMIT-PHASE, NOT RENDER-PHASE (WP2B2). Both calls used to run inline in this hook's body — a\n * side effect during React's render phase, which an abandoned render (Suspense, a superseded\n * transition) still executes even though nothing ever commits. `React.useInsertionEffect` is the\n * hook React documents for exactly this class of problem: it runs before any `useLayoutEffect` in\n * the tree (so token/atom sheets are present before any layout read), but its own timing relative to\n * a specific DOM mutation is NOT guaranteed either way, and it never runs during server rendering —\n * <https://react.dev/reference/react/useInsertionEffect>. `recipe.getClasses()` stays in the render\n * body: it is DOM-free preparation, not mathematically pure (no DOM access, no renderer acquisition\n * — see the recipe contract in `@epilot/zenith-runtime` — but Griffel's own definition/debug\n * bookkeeping still runs and still mutates shared, non-DOM state) and its output IS this render's\n * return value, so it cannot be deferred.\n *\n * NO DEPENDENCY ARRAY ON THE EFFECT. It runs after every commit, not only when the target Document\n * changes: a sheet removed between commits by anything external must be restored on the very next\n * committed render even with unchanged props, and both `ensureCoreTokens` and `recipe.install` are\n * cheap, idempotent checks when nothing is actually missing — narrowing this to `[doc]` would\n * silently defeat the WP2A restoration guarantee for the (far more common) case where `doc` never\n * changes at all. That restoration guarantee is specifically about the CORE and PALETTE token\n * sheets `ensureCoreTokens`/`ensurePaletteTokensFor` own — it does not extend to an arbitrary\n * Griffel atom bucket rule removed externally; the recipe's install memo only ever re-attempts\n * `insertCSSRules`, it does not detect or recover a bucket sheet element deleted out from under it.\n *\n * ONE RECIPE PER STYLE FACTORY, CREATED OUTSIDE RENDER. `createZenithStylesRecipe(styles)` runs once,\n * at `makeZenithStyles`'s own call time (module scope) — never inside the returned hook. A fresh\n * recipe per render would recompute Griffel's definition/debug bookkeeping for no reason and would\n * defeat the recipe's own per-renderer install memo (`@epilot/zenith-runtime`'s `WeakSet`-keyed\n * dedup), which only helps when the SAME recipe object is reused across renders.\n *\n * Cost per commit is not merely a `WeakSet.has`: `useZenithTargetDocument()` resolves the target\n * Document (a Context read, falling back to the ambient global), `ensureCoreTokens` does its own\n * per-Document `WeakMap` reconciliation check (WP2A), and only then does the recipe's `WeakSet.has`\n * (keyed on renderer object identity) decide whether `insertCSSRules` runs again. All three are\n * cheap, but none of them is skipped merely because the recipe was already installed once.\n */\n\nexport type ZenithStyles<Slots extends string> = Record<Slots, GriffelStyle>\n\n/**\n * One class per slot, atoms deduped against whatever is already on the page.\n *\n * **The generic is over the object, not over the key union, and that is load-bearing.** Inferring a\n * type parameter from `Record<Slots, …>` against an object literal widens `Slots` to `string`, so\n * every slot name typechecks including ones that do not exist. OptionCard read `styles.card` in two\n * places with no `card` slot declared and rendered with no card styling at all; tsc was clean and\n * 322 tests passed. Only a pixel diff caught it.\n */\nexport function makeZenithStyles<S extends Record<string, GriffelStyle>>(\n  styles: S\n): () => Record<keyof S & string, string> {\n  const recipe = runtimeCreateZenithStylesRecipe(styles)\n  return function useZenithStyles(): Record<keyof S & string, string> {\n    const doc = useZenithTargetDocument()\n    const classes = recipe.getClasses()\n    React.useInsertionEffect(() => {\n      if (!doc) return\n      ensureCoreTokens(doc)\n      recipe.install(doc)\n    })\n    return classes\n  }\n}\n\n/**\n * One monolithic class for an element's invariant base, rather than atoms.\n *\n * Lands in Griffel's `r` bucket, which sorts before every atom bucket, so variant atoms override it\n * by source order without any specificity escalation. Exactly one reset class per element.\n */\nexport function makeZenithResetStyles(styles: GriffelResetStyle): () => string {\n  const recipe = runtimeCreateZenithResetStylesRecipe(styles)\n  return function useZenithResetStyles(): string {\n    const doc = useZenithTargetDocument()\n    const className = recipe.getClasses()\n    React.useInsertionEffect(() => {\n      if (!doc) return\n      ensureCoreTokens(doc)\n      recipe.install(doc)\n    })\n    return className\n  }\n}\n"],"names":["makeZenithStyles","styles","recipe","runtimeCreateZenithStylesRecipe","doc","useZenithTargetDocument","classes","React","ensureCoreTokens","makeZenithResetStyles","runtimeCreateZenithResetStylesRecipe","className"],"mappings":";;;;AAmEO,SAASA,EACdC,GACwC;AACxC,QAAMC,IAASC,EAAgCF,CAAM;AACrD,SAAO,WAA6D;AAClE,UAAMG,IAAMC,EAAA,GACNC,IAAUJ,EAAO,WAAA;AACvB,WAAAK,EAAM,mBAAmB,MAAM;AAC7B,MAAKH,MACLI,EAAiBJ,CAAG,GACpBF,EAAO,QAAQE,CAAG;AAAA,IACpB,CAAC,GACME;AAAA,EACT;AACF;AAQO,SAASG,EAAsBR,GAAyC;AAC7E,QAAMC,IAASQ,EAAqCT,CAAM;AAC1D,SAAO,WAAwC;AAC7C,UAAMG,IAAMC,EAAA,GACNM,IAAYT,EAAO,WAAA;AACzB,WAAAK,EAAM,mBAAmB,MAAM;AAC7B,MAAKH,MACLI,EAAiBJ,CAAG,GACpBF,EAAO,QAAQE,CAAG;AAAA,IACpB,CAAC,GACMO;AAAA,EACT;AACF;"}
+{"version":3,"file":"make-styles.js","sources":["../../src/styles/make-styles.ts"],"sourcesContent":["import * as React from \"react\"\nimport {\n  createZenithStylesRecipe as runtimeCreateZenithStylesRecipe,\n  createZenithResetStylesRecipe as runtimeCreateZenithResetStylesRecipe,\n  type GriffelResetStyle,\n  type GriffelStyle,\n} from \"@epilot/zenith-runtime/v1\"\n\nimport { ensureCoreTokens } from \"../tokens/install\"\nimport { useZenithTargetDocument } from \"./document-context\"\n\n/**\n * The runtime's style hooks, with this package's token sheet attached. WHY THIS WRAPPER EXISTS,\n * AND WHY IT IS NOT IN THE RUNTIME.\n */\n\nexport type ZenithStyles<Slots extends string> = Record<Slots, GriffelStyle>\n\n/**\n * One class per slot, atoms deduped against whatever is already on the page. **The generic is over\n * the object, not over the key union, and that is load-bearing.** Inferring a type parameter from\n * `Record<Slots, …>` against an object literal widens `Slots` to `string`, so every slot name\n * typechecks including ones that do not exist.\n */\nexport function makeZenithStyles<S extends Record<string, GriffelStyle>>(\n  styles: S\n): () => Record<keyof S & string, string> {\n  const recipe = runtimeCreateZenithStylesRecipe(styles)\n  return function useZenithStyles(): Record<keyof S & string, string> {\n    const doc = useZenithTargetDocument()\n    const classes = recipe.getClasses()\n    React.useInsertionEffect(() => {\n      if (!doc) return\n      ensureCoreTokens(doc)\n      recipe.install(doc)\n    })\n    return classes\n  }\n}\n\n/**\n * One monolithic class for an element's invariant base, rather than atoms.\n *\n * Lands in Griffel's `r` bucket, which sorts before every atom bucket, so variant atoms override it\n * by source order without any specificity escalation. Exactly one reset class per element.\n */\nexport function makeZenithResetStyles(styles: GriffelResetStyle): () => string {\n  const recipe = runtimeCreateZenithResetStylesRecipe(styles)\n  return function useZenithResetStyles(): string {\n    const doc = useZenithTargetDocument()\n    const className = recipe.getClasses()\n    React.useInsertionEffect(() => {\n      if (!doc) return\n      ensureCoreTokens(doc)\n      recipe.install(doc)\n    })\n    return className\n  }\n}\n"],"names":["makeZenithStyles","styles","recipe","runtimeCreateZenithStylesRecipe","doc","useZenithTargetDocument","classes","React","ensureCoreTokens","makeZenithResetStyles","runtimeCreateZenithResetStylesRecipe","className"],"mappings":";;;;AAwBO,SAASA,EACdC,GACwC;AACxC,QAAMC,IAASC,EAAgCF,CAAM;AACrD,SAAO,WAA6D;AAClE,UAAMG,IAAMC,EAAA,GACNC,IAAUJ,EAAO,WAAA;AACvB,WAAAK,EAAM,mBAAmB,MAAM;AAC7B,MAAKH,MACLI,EAAiBJ,CAAG,GACpBF,EAAO,QAAQE,CAAG;AAAA,IACpB,CAAC,GACME;AAAA,EACT;AACF;AAQO,SAASG,EAAsBR,GAAyC;AAC7E,QAAMC,IAASQ,EAAqCT,CAAM;AAC1D,SAAO,WAAwC;AAC7C,UAAMG,IAAMC,EAAA,GACNM,IAAYT,EAAO,WAAA;AACzB,WAAAK,EAAM,mBAAmB,MAAM;AAC7B,MAAKH,MACLI,EAAiBJ,CAAG,GACpBF,EAAO,QAAQE,CAAG;AAAA,IACpB,CAAC,GACMO;AAAA,EACT;AACF;"}

package/dist/tokens/core.meta.generated.js

@@ -1,5 +1,5 @@
-const c = "ccfa55f882e79499";
+const b = "1149b991f836ab9e";
 export {
-  c as NS
+  b as NS
 };
 //# sourceMappingURL=core.meta.generated.js.map

package/dist/tokens/core.meta.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.meta.generated.js","sources":["../../src/tokens/core.meta.generated.ts"],"sourcesContent":["/* GENERATED by packages/tokens (bun run build:tokens) — do not edit. */\nexport const NS = \"ccfa55f882e79499\"\nexport const SHEET_HASH = \"a779e71d2fb6b1f3\"\nexport const CORE_TOKEN_ASSET = {\n  url: \"/zenith/token-assets/core/5cd4072decf5df2a664f0b1d5f2ec250a3309101ded3056c1f87c8bbe3738d50.css\",\n  integrity: \"sha256-XNQHLez13ypmTwsdXy7CUKMwkQHe0wVsH4fIu+NzjVA=\",\n  namespace: \"ccfa55f882e79499\",\n  sheetHash: \"a779e71d2fb6b1f3\",\n} as const\n"],"names":["NS"],"mappings":"AACO,MAAMA,IAAK;"}
+{"version":3,"file":"core.meta.generated.js","sources":["../../src/tokens/core.meta.generated.ts"],"sourcesContent":["/* GENERATED by packages/tokens (bun run build:tokens) — do not edit. */\nexport const NS = \"1149b991f836ab9e\"\nexport const SHEET_HASH = \"d57ca09079a04c67\"\n"],"names":["NS"],"mappings":"AACO,MAAMA,IAAK;"}