@starci/grammar 0.4.12 → 0.5.0

package/dist/offset-pop/conformance.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Offset Pop's rule conformance against the canonical Common catalogue.
+ *
+ * The family's CSS is `styles.css` plus the three component sheets it imports
+ * (`components-forms.css`, `components-overlays.css`, `components-navigation.css`). A rule is
+ * FAMILY-owned only when that CSS makes a decision inside the rule's concern; the evidence names the
+ * mechanism. Every other rule is inherited: the family declares nothing in its concern, so Common's
+ * realization stands unchanged (Core inherits all 150 the same way).
+ *
+ * Inherited on purpose, although the family is close to them:
+ * - The spacing and size rules not listed below: the family's only geometry is the short allow-list
+ *   `conformance.spec.ts` locks, each entry owned by a claim here.
+ * - ACCENT-3 / COLOR-3: one pink fills the decision action, marks the selected or current state and
+ *   draws the focus ring, so distinctness rests on Common's carriers (fill on an action, fill inside a
+ *   control, outline, soft pairing, underline), not on hue.
+ * - BOUNDARY-3: rows claim it, and the seam stays Common's one line between consecutive rows; the family
+ *   only repaints that same edge in its 2px outline material (BOUNDARY-5) and adds no edge of its own.
+ *
+ * Each claim below is proved in `conformance.spec.ts`, which cites the matching assertion in
+ * `styles.spec.ts`, the component `components-*.spec.ts` files or the render specs.
+ */
+export declare const OFFSET_POP_FAMILY_EVIDENCE: {
+    readonly "ACCENT-1": readonly ["`--accent` binds the one pink. The family fills with it only the decision it marks: the dialog confirm, toast and alert action (the single action in each), a checked, selected or current state inside a control, and a real measurement (slider, meter, rating, spinner); it never paints text with it."];
+    readonly "BOUNDARY-1": readonly ["Band edges are the ink line at `--offset-pop-outline-width`: NavigationFeatureNav and TopBar below, Footer and BottomNav above; `--border` and `--separator` resolve to the same ink in every theme and CanvasText under forced colours."];
+    readonly "BOUNDARY-4": readonly ["Rail draws its inline-end column edge as the 2px `--offset-pop-outline-width` ink line in `--border`; Common draws none on Rail."];
+    readonly "BOUNDARY-5": readonly ["Objects carry a `--offset-pop-outline-width` (2px) solid ink outline in place of Common's 1px: nested surfaces, Button, Badge, StateMark, field and choice controls, overlay surfaces, DataTable, Calendar, Avatar, tags and pagination; grouped Buttons overlap by one outline width so a shared edge draws once, and a row seam is Common's one between-rows edge repainted at the outline width (never a second edge)."];
+    readonly "BOUNDARY-6": readonly ["Family-owned departure: a `depth=\"top\"` surface keeps `--shadow-surface` (the hard `0.25rem 0.5rem 0 --offset-pop-shadow-ink` offset) AND the 2px ink outline, the outline-plus-offset signature (overlay surfaces, DataTable and Calendar do the same); forced colours drop the shadow and keep only the outline."];
+    readonly "COLOR-5": readonly ["Scoped light, `[data-grammar-theme=\"dark\"]`, `prefers-color-scheme` system and `forced-colors` token blocks, and every component sheet resets its edges, shadows and selected fills to system colours; every text pair measures at least 4.5:1 and the focus ring at least 3:1 in light and dark, error text included (critical mixed 65% with the ink)."];
+    readonly "CONTROL-STATE-2": readonly ["`[data-grammar-state=\"unavailable\"]` reads in the muted ink (AA, unavailable is not disabled), drops shadow and transform and shows `not-allowed`; `[data-grammar-state=\"pending\"]` only removes pointer events at full paint. Two hooks, never derived from each other."];
+    readonly "CORE-BOUNDARY-1": readonly ["Every family edge lands on a hook a Common owner emits (`data-component`, `data-grammar-*`, the HeroUI slot, or the vendor's own state attribute); the family adds no wrapper shell."];
+    readonly "CORE-BOUNDARY-4": readonly ["Shadows stay material, not stacking: `--shadow-surface` and the overlay, drawer and chip offsets are hard ink copies of the outline, nested and forced-colour surfaces have none, and the family sets no `z-index` or `position`."];
+    readonly "CORE-BOUNDARY-5": readonly ["Unlike Core, the family adds width queries, and they change shadow geometry only: below 40rem the offset shadow and the surface radius shorten, below 30rem DataTable and Calendar take a smaller hard shadow; every owner hook stays. State paint changes text colour, shadow and pointer only."];
+    readonly "CORE-SURFACE-2": readonly ["Material (ink outline, radius, `--surface`, depth shadow) is painted on the bounded `[data-slot=\"card-content\"]` frame and `[data-grammar-surface]` shells; the HeroUI `[data-slot=\"card\"]` root is cleared to no edge, no background and no shadow."];
+    readonly "FLOW-2": readonly ["The display Heading wraps with `text-wrap: balance`; `overflow-wrap` stays Common's."];
+    readonly "FONT-6": readonly ["The display Heading keeps Common's `text-4xl` size; the family sets weight 900, tracking -.045em and line-height .96, tighter than Common's `leading-tight`."];
+    readonly "FOCUS-1": readonly ["`--focus` binds the pink ring (3.22:1 on canvas light, 5.42:1 dark, Highlight under forced colours). It rings a focus-visible whole action's painted frame, a choice control and a slider thumb (2px, 0.25rem offset), and a keyboard-focused ListBox or Select/ComboBox option (2px on the row edge, offset 0, so the list's clip never cuts it); a field shows focus as the hard offset shadow over a transparent 2px outline that forced colours turn into a Highlight ring."];
+    readonly "GAP-4": readonly ["Stacked toasts are spaced by `--offset-pop-shadow-y` + 0.5rem (1rem, and .75rem below 40rem) so each hard shadow clears the next toast."];
+    readonly "MARGIN-2": readonly ["Accordion items are separated by `margin-block-start: var(--grammar-inline-gap)` (.5rem) because each item is its own outlined box."];
+    readonly "MEASURE-5": readonly ["BottomNav items keep a 4rem minimum block size and their icon pill 3.25rem by 2rem, a thumb-sized target; the family also fixes the Meter track at .75rem and the Timeline rail at the outline width."];
+    readonly "MOTION-1": readonly ["The family's only movement is press travel: a translate plus shadow collapse keyed on `:active` or the vendor's `data-pressed` / `data-dragging`, repeating a press Common already handles; no state or meaning rides on it."];
+    readonly "MOTION-2": readonly ["`prefers-reduced-motion: reduce` zeroes `--offset-pop-motion-duration` and `--offset-pop-transition`, and every sheet that moves something sets its `transform` or `translate` to none (navigation zeroes its disclosure and dock transitions); the press itself still reaches Common."];
+    readonly "MOTION-3": readonly ["Every family transition reads `--offset-pop-transition`, built from the DNA's `--offset-pop-motion-duration` (140ms) and `--offset-pop-motion-easing`."];
+    readonly "OVERFLOW-2": readonly ["The family clips (`overflow: clip`) only non-scrolling shells to their radius: a list that is not the scroll region, the DataTable sheet (its rows scroll in the inner table scroll container) and the SegmentedControl unit; a list that is the scroll region keeps Common's OVERFLOW-3 `overflow-y: auto`."];
+    readonly "PADDING-2": readonly ["The current Breadcrumb becomes an outlined pill with a .5rem inline inset."];
+    readonly "PADDING-3": readonly ["The Calendar becomes an outlined sheet with a .75rem inset."];
+    readonly "PADDING-4": readonly ["Disclosure and Accordion triggers take a 1rem inline inset inside their outlined box."];
+    readonly "RESPONSIVE-1": readonly ["Narrow widths change only family shadow geometry: below 40rem `--offset-pop-shadow-y` (0.5rem to 0.25rem) and `--offset-pop-surface-radius` (1.5rem to 1.25rem), below 30rem the DataTable and Calendar shadow; no region, hook or content is removed."];
+    readonly "STATE-5": readonly ["Surface press and focus treatments are keyed on `:has([data-grammar-whole-action]...)`, so a static surface never paints as pressable."];
+    readonly "SURFACE-1": readonly ["The HeroUI card root stays no-surface around the painted frame (no edge, transparent, no shadow), and a frameless SurfaceCard carries no hook the family paints."];
+    readonly "SURFACE-2": readonly ["Bounded frames and `[data-grammar-surface]` shells paint `--surface` with `--surface-foreground`, both bound to family tokens."];
+    readonly "SURFACE-3": readonly ["A nested frame or shell paints `--surface-secondary`, drops the shadow, and keeps `--surface-foreground` (the same ink as `--foreground`)."];
+    readonly "SURFACE-4": readonly ["`--accent-soft` binds the secondary surface and `--accent-soft-foreground` the text-safe `--offset-pop-accent-text` (5.09:1 light, 5.61:1 dark)."];
+    readonly "TONE-2": readonly ["`Text tone=\"muted\"` reads `--muted` (#675f6c light, #c8bdca dark), at least 4.75:1 on every family surface."];
+    readonly "TONE-3": readonly ["`Text tone=\"accent\"`, the SectionHeader eyebrow, the current tab label, a selected menu item and a selected ListBox option, Select/ComboBox option or DataTable row (on the `--accent-soft` fill) read `--offset-pop-accent-text`, never the fill pink."];
+    readonly "TRUTH-1": readonly ["The inset state stripe is drawn only on rows whose state is not neutral (`:not([data-grammar-state=\"neutral\"])`), and toast and meter tones map each named outcome to its own semantic colour; no neutral tone is painted as success or danger."];
+};
+export declare const offsetPopRuleConformance: Readonly<{
+    familyId: string;
+    inheritedCommonRules: readonly string[];
+    familyEvidence: Readonly<{
+        [x: string]: readonly string[];
+    }>;
+}>;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/offset-pop/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/offset-pop/conformance.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC6B,CAAA;AAEpE,eAAO,MAAM,wBAAwB;;;;;;EAInC,CAAA"}

package/dist/offset-pop/conformance.js

@@ -0,0 +1,63 @@
+import { COMMON_UI_RULE_IDS, defineGrammarRuleConformance } from "../common/index.js";
+/**
+ * Offset Pop's rule conformance against the canonical Common catalogue.
+ *
+ * The family's CSS is `styles.css` plus the three component sheets it imports
+ * (`components-forms.css`, `components-overlays.css`, `components-navigation.css`). A rule is
+ * FAMILY-owned only when that CSS makes a decision inside the rule's concern; the evidence names the
+ * mechanism. Every other rule is inherited: the family declares nothing in its concern, so Common's
+ * realization stands unchanged (Core inherits all 150 the same way).
+ *
+ * Inherited on purpose, although the family is close to them:
+ * - The spacing and size rules not listed below: the family's only geometry is the short allow-list
+ *   `conformance.spec.ts` locks, each entry owned by a claim here.
+ * - ACCENT-3 / COLOR-3: one pink fills the decision action, marks the selected or current state and
+ *   draws the focus ring, so distinctness rests on Common's carriers (fill on an action, fill inside a
+ *   control, outline, soft pairing, underline), not on hue.
+ * - BOUNDARY-3: rows claim it, and the seam stays Common's one line between consecutive rows; the family
+ *   only repaints that same edge in its 2px outline material (BOUNDARY-5) and adds no edge of its own.
+ *
+ * Each claim below is proved in `conformance.spec.ts`, which cites the matching assertion in
+ * `styles.spec.ts`, the component `components-*.spec.ts` files or the render specs.
+ */
+export const OFFSET_POP_FAMILY_EVIDENCE = {
+    "ACCENT-1": ["`--accent` binds the one pink. The family fills with it only the decision it marks: the dialog confirm, toast and alert action (the single action in each), a checked, selected or current state inside a control, and a real measurement (slider, meter, rating, spinner); it never paints text with it."],
+    "BOUNDARY-1": ["Band edges are the ink line at `--offset-pop-outline-width`: NavigationFeatureNav and TopBar below, Footer and BottomNav above; `--border` and `--separator` resolve to the same ink in every theme and CanvasText under forced colours."],
+    "BOUNDARY-4": ["Rail draws its inline-end column edge as the 2px `--offset-pop-outline-width` ink line in `--border`; Common draws none on Rail."],
+    "BOUNDARY-5": ["Objects carry a `--offset-pop-outline-width` (2px) solid ink outline in place of Common's 1px: nested surfaces, Button, Badge, StateMark, field and choice controls, overlay surfaces, DataTable, Calendar, Avatar, tags and pagination; grouped Buttons overlap by one outline width so a shared edge draws once, and a row seam is Common's one between-rows edge repainted at the outline width (never a second edge)."],
+    "BOUNDARY-6": ["Family-owned departure: a `depth=\"top\"` surface keeps `--shadow-surface` (the hard `0.25rem 0.5rem 0 --offset-pop-shadow-ink` offset) AND the 2px ink outline, the outline-plus-offset signature (overlay surfaces, DataTable and Calendar do the same); forced colours drop the shadow and keep only the outline."],
+    "COLOR-5": ["Scoped light, `[data-grammar-theme=\"dark\"]`, `prefers-color-scheme` system and `forced-colors` token blocks, and every component sheet resets its edges, shadows and selected fills to system colours; every text pair measures at least 4.5:1 and the focus ring at least 3:1 in light and dark, error text included (critical mixed 65% with the ink)."],
+    "CONTROL-STATE-2": ["`[data-grammar-state=\"unavailable\"]` reads in the muted ink (AA, unavailable is not disabled), drops shadow and transform and shows `not-allowed`; `[data-grammar-state=\"pending\"]` only removes pointer events at full paint. Two hooks, never derived from each other."],
+    "CORE-BOUNDARY-1": ["Every family edge lands on a hook a Common owner emits (`data-component`, `data-grammar-*`, the HeroUI slot, or the vendor's own state attribute); the family adds no wrapper shell."],
+    "CORE-BOUNDARY-4": ["Shadows stay material, not stacking: `--shadow-surface` and the overlay, drawer and chip offsets are hard ink copies of the outline, nested and forced-colour surfaces have none, and the family sets no `z-index` or `position`."],
+    "CORE-BOUNDARY-5": ["Unlike Core, the family adds width queries, and they change shadow geometry only: below 40rem the offset shadow and the surface radius shorten, below 30rem DataTable and Calendar take a smaller hard shadow; every owner hook stays. State paint changes text colour, shadow and pointer only."],
+    "CORE-SURFACE-2": ["Material (ink outline, radius, `--surface`, depth shadow) is painted on the bounded `[data-slot=\"card-content\"]` frame and `[data-grammar-surface]` shells; the HeroUI `[data-slot=\"card\"]` root is cleared to no edge, no background and no shadow."],
+    "FLOW-2": ["The display Heading wraps with `text-wrap: balance`; `overflow-wrap` stays Common's."],
+    "FONT-6": ["The display Heading keeps Common's `text-4xl` size; the family sets weight 900, tracking -.045em and line-height .96, tighter than Common's `leading-tight`."],
+    "FOCUS-1": ["`--focus` binds the pink ring (3.22:1 on canvas light, 5.42:1 dark, Highlight under forced colours). It rings a focus-visible whole action's painted frame, a choice control and a slider thumb (2px, 0.25rem offset), and a keyboard-focused ListBox or Select/ComboBox option (2px on the row edge, offset 0, so the list's clip never cuts it); a field shows focus as the hard offset shadow over a transparent 2px outline that forced colours turn into a Highlight ring."],
+    "GAP-4": ["Stacked toasts are spaced by `--offset-pop-shadow-y` + 0.5rem (1rem, and .75rem below 40rem) so each hard shadow clears the next toast."],
+    "MARGIN-2": ["Accordion items are separated by `margin-block-start: var(--grammar-inline-gap)` (.5rem) because each item is its own outlined box."],
+    "MEASURE-5": ["BottomNav items keep a 4rem minimum block size and their icon pill 3.25rem by 2rem, a thumb-sized target; the family also fixes the Meter track at .75rem and the Timeline rail at the outline width."],
+    "MOTION-1": ["The family's only movement is press travel: a translate plus shadow collapse keyed on `:active` or the vendor's `data-pressed` / `data-dragging`, repeating a press Common already handles; no state or meaning rides on it."],
+    "MOTION-2": ["`prefers-reduced-motion: reduce` zeroes `--offset-pop-motion-duration` and `--offset-pop-transition`, and every sheet that moves something sets its `transform` or `translate` to none (navigation zeroes its disclosure and dock transitions); the press itself still reaches Common."],
+    "MOTION-3": ["Every family transition reads `--offset-pop-transition`, built from the DNA's `--offset-pop-motion-duration` (140ms) and `--offset-pop-motion-easing`."],
+    "OVERFLOW-2": ["The family clips (`overflow: clip`) only non-scrolling shells to their radius: a list that is not the scroll region, the DataTable sheet (its rows scroll in the inner table scroll container) and the SegmentedControl unit; a list that is the scroll region keeps Common's OVERFLOW-3 `overflow-y: auto`."],
+    "PADDING-2": ["The current Breadcrumb becomes an outlined pill with a .5rem inline inset."],
+    "PADDING-3": ["The Calendar becomes an outlined sheet with a .75rem inset."],
+    "PADDING-4": ["Disclosure and Accordion triggers take a 1rem inline inset inside their outlined box."],
+    "RESPONSIVE-1": ["Narrow widths change only family shadow geometry: below 40rem `--offset-pop-shadow-y` (0.5rem to 0.25rem) and `--offset-pop-surface-radius` (1.5rem to 1.25rem), below 30rem the DataTable and Calendar shadow; no region, hook or content is removed."],
+    "STATE-5": ["Surface press and focus treatments are keyed on `:has([data-grammar-whole-action]...)`, so a static surface never paints as pressable."],
+    "SURFACE-1": ["The HeroUI card root stays no-surface around the painted frame (no edge, transparent, no shadow), and a frameless SurfaceCard carries no hook the family paints."],
+    "SURFACE-2": ["Bounded frames and `[data-grammar-surface]` shells paint `--surface` with `--surface-foreground`, both bound to family tokens."],
+    "SURFACE-3": ["A nested frame or shell paints `--surface-secondary`, drops the shadow, and keeps `--surface-foreground` (the same ink as `--foreground`)."],
+    "SURFACE-4": ["`--accent-soft` binds the secondary surface and `--accent-soft-foreground` the text-safe `--offset-pop-accent-text` (5.09:1 light, 5.61:1 dark)."],
+    "TONE-2": ["`Text tone=\"muted\"` reads `--muted` (#675f6c light, #c8bdca dark), at least 4.75:1 on every family surface."],
+    "TONE-3": ["`Text tone=\"accent\"`, the SectionHeader eyebrow, the current tab label, a selected menu item and a selected ListBox option, Select/ComboBox option or DataTable row (on the `--accent-soft` fill) read `--offset-pop-accent-text`, never the fill pink."],
+    "TRUTH-1": ["The inset state stripe is drawn only on rows whose state is not neutral (`:not([data-grammar-state=\"neutral\"])`), and toast and meter tones map each named outcome to its own semantic colour; no neutral tone is painted as success or danger."],
+};
+export const offsetPopRuleConformance = defineGrammarRuleConformance({
+    familyId: "offset-pop",
+    inheritedCommonRules: COMMON_UI_RULE_IDS.filter((rule) => !(rule in OFFSET_POP_FAMILY_EVIDENCE)),
+    familyEvidence: OFFSET_POP_FAMILY_EVIDENCE,
+});
+//# sourceMappingURL=conformance.js.map

package/dist/offset-pop/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../src/offset-pop/conformance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAErF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACtC,UAAU,EAAE,CAAC,2SAA2S,CAAC;IACzT,YAAY,EAAE,CAAC,0OAA0O,CAAC;IAC1P,YAAY,EAAE,CAAC,kIAAkI,CAAC;IAClJ,YAAY,EAAE,CAAC,2ZAA2Z,CAAC;IAC3a,YAAY,EAAE,CAAC,sTAAsT,CAAC;IACtU,SAAS,EAAE,CAAC,4VAA4V,CAAC;IACzW,iBAAiB,EAAE,CAAC,8QAA8Q,CAAC;IACnS,iBAAiB,EAAE,CAAC,sLAAsL,CAAC;IAC3M,iBAAiB,EAAE,CAAC,mOAAmO,CAAC;IACxP,iBAAiB,EAAE,CAAC,kSAAkS,CAAC;IACvT,gBAAgB,EAAE,CAAC,0PAA0P,CAAC;IAC9Q,QAAQ,EAAE,CAAC,sFAAsF,CAAC;IAClG,QAAQ,EAAE,CAAC,8JAA8J,CAAC;IAC1K,SAAS,EAAE,CAAC,idAAid,CAAC;IAC9d,OAAO,EAAE,CAAC,yIAAyI,CAAC;IACpJ,UAAU,EAAE,CAAC,qIAAqI,CAAC;IACnJ,WAAW,EAAE,CAAC,uMAAuM,CAAC;IACtN,UAAU,EAAE,CAAC,8NAA8N,CAAC;IAC5O,UAAU,EAAE,CAAC,wRAAwR,CAAC;IACtS,UAAU,EAAE,CAAC,wJAAwJ,CAAC;IACtK,YAAY,EAAE,CAAC,8SAA8S,CAAC;IAC9T,WAAW,EAAE,CAAC,4EAA4E,CAAC;IAC3F,WAAW,EAAE,CAAC,6DAA6D,CAAC;IAC5E,WAAW,EAAE,CAAC,uFAAuF,CAAC;IACtG,cAAc,EAAE,CAAC,wPAAwP,CAAC;IAC1Q,SAAS,EAAE,CAAC,wIAAwI,CAAC;IACrJ,WAAW,EAAE,CAAC,kKAAkK,CAAC;IACjL,WAAW,EAAE,CAAC,gIAAgI,CAAC;IAC/I,WAAW,EAAE,CAAC,4IAA4I,CAAC;IAC3J,WAAW,EAAE,CAAC,kJAAkJ,CAAC;IACjK,QAAQ,EAAE,CAAC,+GAA+G,CAAC;IAC3H,QAAQ,EAAE,CAAC,2PAA2P,CAAC;IACvQ,SAAS,EAAE,CAAC,mPAAmP,CAAC;CAChM,CAAA;AAEpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,4BAA4B,CAAC;IACjE,QAAQ,EAAE,YAAY;IACtB,oBAAoB,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,0BAA0B,CAAC,CAAC;IAChG,cAAc,EAAE,0BAA0B;CAC7C,CAAC,CAAA"}

package/dist/offset-pop/dna.d.ts

@@ -0,0 +1,282 @@
+/**
+ * Stable visual identity shipped by the Offset Pop Grammar family.
+ *
+ * Same shape as `STARCI_CORE_DNA`, key for key, plus two family groups: `offset` (the hard
+ * offset shadow and ink outline that make the family recognisable) and `palette` (the named
+ * inks the semantic colours are drawn from). This is presentation data, not a registry of UI
+ * laws, and it is product-neutral. Every value equals the default in `./styles.css`; the
+ * styles spec holds the two together.
+ *
+ * WCAG 2.x contrast, recorded here and asserted in `styles.spec.ts`:
+ *
+ * | pair                                   | light | dark  | need |
+ * | -------------------------------------- | ----- | ----- | ---- |
+ * | foreground on canvas                   | 16.86 | 17.47 | 4.5  |
+ * | foreground on surface                  | 17.49 | 15.44 | 4.5  |
+ * | foreground on surfaceSecondary         | 13.78 | 12.80 | 4.5  |
+ * | muted on canvas                        |  5.81 | 10.16 | 4.5  |
+ * | muted on surface                       |  6.03 |  8.98 | 4.5  |
+ * | muted on surfaceSecondary              |  4.75 |  7.45 | 4.5  |
+ * | accentForeground on accent             |  5.23 |  5.23 | 4.5  |
+ * | successForeground on success           | 11.97 | 11.97 | 4.5  |
+ * | warningForeground on warning           | 12.49 | 12.49 | 4.5  |
+ * | dangerForeground on danger             |  4.72 |  4.72 | 4.5  |
+ * | infoForeground on info                 | 13.50 | 13.50 | 4.5  |
+ * | focus on canvas (non-text, 1.4.11)     |  3.22 |  5.42 | 3    |
+ * | focus on surface (non-text, 1.4.11)    |  3.34 |  4.79 | 3    |
+ * | accentText on canvas                   |  6.22 |  7.65 | 4.5  |
+ * | accentText on surface                  |  6.45 |  6.76 | 4.5  |
+ * | accentText on surfaceSecondary         |  5.09 |  5.61 | 4.5  |
+ * | accentText on blush (palette/info)     |  4.98 |   -   | 4.5  |
+ *
+ * The accent foreground is the ink, not white: white on the family pink is 3.40:1, which fails
+ * AA for button-size text. The same reasoning puts ink on the critical red (white is 3.77:1).
+ * Pink as body-size TEXT on the light canvas is only 3.22:1, so `accent` stays the fill and the
+ * focus ring and every place the accent paints text reads `accentText` instead: a deeper
+ * raspberry in light, a lighter candy pink in dark. `accentText` and `accentSoft` (the selected
+ * and soft tint, the blush secondary surface in light and the plum one in dark) mirror Core's
+ * keys of the same names.
+ */
+export declare const OFFSET_POP_DNA: Readonly<{
+    readonly id: "offset-pop";
+    readonly version: 1;
+    readonly color: Readonly<{
+        accent: "#ff3593";
+        accentForeground: "#1c1524";
+        focus: "#ff3593";
+        light: Readonly<{
+            canvas: "#fff8ef";
+            surface: "#fffdf9";
+            surfaceSecondary: "#f8dbe8";
+            foreground: "#1c1524";
+            muted: "#675f6c";
+            border: "#1c1524";
+            separator: "#1c1524";
+            success: "#91e4ca";
+            successForeground: "#1c1524";
+            warning: "#ffd447";
+            warningForeground: "#1c1524";
+            danger: "#e84a5f";
+            dangerForeground: "#1c1524";
+            info: "#f8d8e6";
+            infoForeground: "#1c1524";
+            accentText: "#b8005f";
+            accentSoft: "#f8dbe8";
+        }>;
+        dark: Readonly<{
+            canvas: "#17121d";
+            surface: "#251d2c";
+            surfaceSecondary: "#3b2936";
+            foreground: "#fff8ef";
+            muted: "#c8bdca";
+            border: "#fff8ef";
+            separator: "#fff8ef";
+            success: "#91e4ca";
+            successForeground: "#1c1524";
+            warning: "#ffd447";
+            warningForeground: "#1c1524";
+            danger: "#e84a5f";
+            dangerForeground: "#1c1524";
+            info: "#f8d8e6";
+            infoForeground: "#1c1524";
+            accentText: "#ff7ab8";
+            accentSoft: "#3b2936";
+        }>;
+    }>;
+    readonly geometry: Readonly<{
+        pageMeasure: "80rem";
+        readingMeasure: "72ch";
+        surfaceRadius: "1.5rem";
+        controlRadius: "1rem";
+        pillRadius: "999px";
+    }>;
+    readonly rhythm: Readonly<{
+        inlineGap: "0.5rem";
+        rowGap: "0.75rem";
+        sectionGap: "1rem";
+        regionGap: "1.5rem";
+        pageInset: "clamp(1rem, 3vw, 2rem)";
+    }>;
+    readonly elevation: Readonly<{
+        /** Composed from `offset`, so it follows the theme's shadow ink and the narrow-viewport drop. */
+        surface: "var(--offset-pop-shadow-x) var(--offset-pop-shadow-y) 0 var(--offset-pop-shadow-ink)";
+    }>;
+    readonly motion: Readonly<{
+        duration: "140ms";
+        easing: "cubic-bezier(.2, .8, .2, 1)";
+    }>;
+    readonly offset: Readonly<{
+        x: "0.25rem";
+        y: "0.5rem";
+        outlineWidth: "2px";
+        ink: "#1c1524";
+        shadowInk: "#1c1524";
+        /** Dark ink is the outline and text colour (it flips to cream); the shadow stays near-black. */
+        dark: Readonly<{
+            ink: "#fff8ef";
+            shadowInk: "#050306";
+        }>;
+    }>;
+    readonly palette: Readonly<{
+        pink: "#ff3593";
+        blush: "#f8d8e6";
+        yellow: "#ffd447";
+        mint: "#91e4ca";
+        critical: "#e84a5f";
+    }>;
+}>;
+/** Canonical 4px spacing scale; the same values as Common and Core, which the family does not re-space. */
+export declare const OFFSET_POP_SPACING_SCALE: Readonly<{
+    readonly "0": "0rem";
+    readonly "0.5": "0.125rem";
+    readonly "1": "0.25rem";
+    readonly "1.5": "0.375rem";
+    readonly "2": "0.5rem";
+    readonly "2.5": "0.625rem";
+    readonly "3": "0.75rem";
+    readonly "4": "1rem";
+    readonly "5": "1.25rem";
+    readonly "6": "1.5rem";
+    readonly "8": "2rem";
+    readonly "10": "2.5rem";
+    readonly "12": "3rem";
+    readonly "16": "4rem";
+}>;
+export type OffsetPopSpacingStep = keyof typeof OFFSET_POP_SPACING_SCALE;
+export type OffsetPopSpacingValue = (typeof OFFSET_POP_SPACING_SCALE)[OffsetPopSpacingStep];
+/** CSS custom-property contract for adapting Offset Pop without renaming its anatomy. */
+export declare const OFFSET_POP_TOKEN_NAMES: Readonly<{
+    readonly accent: "--offset-pop-accent";
+    readonly accentForeground: "--offset-pop-accent-foreground";
+    readonly focus: "--offset-pop-focus";
+    readonly canvas: "--offset-pop-canvas";
+    readonly surface: "--offset-pop-surface";
+    readonly surfaceSecondary: "--offset-pop-surface-secondary";
+    readonly foreground: "--offset-pop-foreground";
+    readonly muted: "--offset-pop-muted";
+    readonly border: "--offset-pop-border";
+    readonly separator: "--offset-pop-separator";
+    readonly success: "--offset-pop-success";
+    readonly successForeground: "--offset-pop-success-foreground";
+    readonly warning: "--offset-pop-warning";
+    readonly warningForeground: "--offset-pop-warning-foreground";
+    readonly danger: "--offset-pop-danger";
+    readonly dangerForeground: "--offset-pop-danger-foreground";
+    readonly info: "--offset-pop-info";
+    readonly infoForeground: "--offset-pop-info-foreground";
+    readonly accentText: "--offset-pop-accent-text";
+    readonly accentSoft: "--offset-pop-accent-soft";
+    readonly pageMeasure: "--offset-pop-page-measure";
+    readonly readingMeasure: "--offset-pop-reading-measure";
+    readonly surfaceRadius: "--offset-pop-surface-radius";
+    readonly controlRadius: "--offset-pop-control-radius";
+    readonly pillRadius: "--offset-pop-pill-radius";
+    readonly pageInset: "--offset-pop-page-inset";
+    readonly inlineGap: "--offset-pop-inline-gap";
+    readonly rowGap: "--offset-pop-row-gap";
+    readonly sectionGap: "--offset-pop-section-gap";
+    readonly regionGap: "--offset-pop-region-gap";
+    readonly elevation: "--offset-pop-surface-shadow";
+    readonly motionDuration: "--offset-pop-motion-duration";
+    readonly motionEasing: "--offset-pop-motion-easing";
+    readonly shadowX: "--offset-pop-shadow-x";
+    readonly shadowY: "--offset-pop-shadow-y";
+    readonly outlineWidth: "--offset-pop-outline-width";
+    readonly ink: "--offset-pop-ink";
+    readonly shadowInk: "--offset-pop-shadow-ink";
+    readonly pink: "--offset-pop-pink";
+    readonly blush: "--offset-pop-blush";
+    readonly yellow: "--offset-pop-yellow";
+    readonly mint: "--offset-pop-mint";
+    readonly critical: "--offset-pop-critical";
+}>;
+/**
+ * Sticky-band geometry published under an Offset Pop root.
+ *
+ * Common, not the family, publishes the band: `src/common/styles.css` defines these on every
+ * `.grammar-common-root` that holds a sticky `NavigationFeatureNav` or `Subnav`, whatever its
+ * family, and reads the two host overrides. So the names are Common's, shared with Core; the
+ * family re-exports them so a consumer reads them from `@starci/grammar/offset-pop`. They are
+ * not theme tokens and are absent from `OFFSET_POP_TOKEN_NAMES`; Offset Pop CSS never writes them.
+ * See `STARCI_CORE_BAND_TOKEN_NAMES` for what each one means.
+ */
+export declare const OFFSET_POP_BAND_TOKEN_NAMES: Readonly<{
+    readonly bandOffset: "--starci-core-band-offset";
+    readonly bandHeight: "--starci-core-band-height";
+    readonly bandSubnavHeight: "--starci-core-band-subnav-height";
+    readonly railOffset: "--starci-core-rail-offset";
+    readonly subnavOffset: "--starci-core-subnav-offset";
+}>;
+export type OffsetPopBandTokenName = (typeof OFFSET_POP_BAND_TOKEN_NAMES)[keyof typeof OFFSET_POP_BAND_TOKEN_NAMES];
+export type OffsetPopDna = typeof OFFSET_POP_DNA;
+export type OffsetPopTokenName = (typeof OFFSET_POP_TOKEN_NAMES)[keyof typeof OFFSET_POP_TOKEN_NAMES];
+/** Portable light/default values keyed by the public CSS custom-property contract. */
+export declare const OFFSET_POP_TOKEN_DEFAULTS: Readonly<{
+    "--offset-pop-accent": "#ff3593";
+    "--offset-pop-accent-foreground": "#1c1524";
+    "--offset-pop-focus": "#ff3593";
+    "--offset-pop-canvas": "#fff8ef";
+    "--offset-pop-surface": "#fffdf9";
+    "--offset-pop-surface-secondary": "#f8dbe8";
+    "--offset-pop-foreground": "#1c1524";
+    "--offset-pop-muted": "#675f6c";
+    "--offset-pop-border": "#1c1524";
+    "--offset-pop-separator": "#1c1524";
+    "--offset-pop-success": "#91e4ca";
+    "--offset-pop-success-foreground": "#1c1524";
+    "--offset-pop-warning": "#ffd447";
+    "--offset-pop-warning-foreground": "#1c1524";
+    "--offset-pop-danger": "#e84a5f";
+    "--offset-pop-danger-foreground": "#1c1524";
+    "--offset-pop-info": "#f8d8e6";
+    "--offset-pop-info-foreground": "#1c1524";
+    "--offset-pop-accent-text": "#b8005f";
+    "--offset-pop-accent-soft": "#f8dbe8";
+    "--offset-pop-page-measure": "80rem";
+    "--offset-pop-reading-measure": "72ch";
+    "--offset-pop-surface-radius": "1.5rem";
+    "--offset-pop-control-radius": "1rem";
+    "--offset-pop-pill-radius": "999px";
+    "--offset-pop-page-inset": "clamp(1rem, 3vw, 2rem)";
+    "--offset-pop-inline-gap": "0.5rem";
+    "--offset-pop-row-gap": "0.75rem";
+    "--offset-pop-section-gap": "1rem";
+    "--offset-pop-region-gap": "1.5rem";
+    "--offset-pop-surface-shadow": "var(--offset-pop-shadow-x) var(--offset-pop-shadow-y) 0 var(--offset-pop-shadow-ink)";
+    "--offset-pop-motion-duration": "140ms";
+    "--offset-pop-motion-easing": "cubic-bezier(.2, .8, .2, 1)";
+    "--offset-pop-shadow-x": "0.25rem";
+    "--offset-pop-shadow-y": "0.5rem";
+    "--offset-pop-outline-width": "2px";
+    "--offset-pop-ink": "#1c1524";
+    "--offset-pop-shadow-ink": "#1c1524";
+    "--offset-pop-pink": "#ff3593";
+    "--offset-pop-blush": "#f8d8e6";
+    "--offset-pop-yellow": "#ffd447";
+    "--offset-pop-mint": "#91e4ca";
+    "--offset-pop-critical": "#e84a5f";
+}>;
+/** Theme overrides layered on the default token set by `OffsetPopGrammarRoot` dark (and system-dark) mode. */
+export declare const OFFSET_POP_DARK_TOKEN_DEFAULTS: Readonly<{
+    "--offset-pop-canvas": "#17121d";
+    "--offset-pop-surface": "#251d2c";
+    "--offset-pop-surface-secondary": "#3b2936";
+    "--offset-pop-foreground": "#fff8ef";
+    "--offset-pop-muted": "#c8bdca";
+    "--offset-pop-border": "#fff8ef";
+    "--offset-pop-separator": "#fff8ef";
+    "--offset-pop-success": "#91e4ca";
+    "--offset-pop-success-foreground": "#1c1524";
+    "--offset-pop-warning": "#ffd447";
+    "--offset-pop-warning-foreground": "#1c1524";
+    "--offset-pop-danger": "#e84a5f";
+    "--offset-pop-danger-foreground": "#1c1524";
+    "--offset-pop-info": "#f8d8e6";
+    "--offset-pop-info-foreground": "#1c1524";
+    "--offset-pop-accent-text": "#ff7ab8";
+    "--offset-pop-accent-soft": "#3b2936";
+    "--offset-pop-ink": "#fff8ef";
+    "--offset-pop-shadow-ink": "#050306";
+}>;
+export type OffsetPopTokenDefaults = typeof OFFSET_POP_TOKEN_DEFAULTS;
+//# sourceMappingURL=dna.d.ts.map

package/dist/offset-pop/dna.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dna.d.ts","sourceRoot":"","sources":["../../src/offset-pop/dna.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA6DnB,iGAAiG;;;;;;;;;;;;;QAajG,gGAAgG;;;;;;;;;;;;;EAa7F,CAAA;AAEX,2GAA2G;AAC3G,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAe1B,CAAA;AAEX,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,wBAAwB,CAAA;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,oBAAoB,CAAC,CAAA;AAE3F,yFAAyF;AACzF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CxB,CAAA;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B;;;;;;EAM7B,CAAA;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA;AAEnH,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAA;AAChD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAA;AAErG,sFAAsF;AACtF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CmB,CAAA;AAEzD,8GAA8G;AAC9G,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;EAoBuB,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG,OAAO,yBAAyB,CAAA"}