@starci/grammar 0.3.0 → 0.4.1

package/dist/heritage/index.d.ts

@@ -0,0 +1,27 @@
+import { type GrammarRootProps } from "../common/index.js";
+/** Resolved institutional identity; destination behavior remains with the consumer. */
+export type HeritageBrandProps = {
+    readonly name: string;
+    readonly descriptor: string;
+    readonly logo: {
+        readonly src: string;
+        readonly width: number;
+        readonly height: number;
+    };
+};
+/** Official product-neutral Heritage family contract. */
+export declare const heritageGrammar: import("../common/registry.js").GrammarFamilyContract<"heritage", {
+    readonly Brand: import("react").FunctionComponent<HeritageBrandProps>;
+}>;
+export declare const heritageRuleConformance: Readonly<{
+    familyId: string;
+    inheritedCommonRules: readonly string[];
+    familyEvidence: Readonly<{
+        [x: string]: readonly string[];
+    }>;
+}>;
+export declare const HeritageGrammarRoot: ({ className, theme, ...props }: GrammarRootProps) => import("react").JSX.Element;
+export declare const HeritageButton: (props: import("../common/renderers.js").ButtonProps) => import("react").JSX.Element;
+export declare const HeritageHeading: ({ children, level, scale, isSkeleton, isVisuallyHidden, }: import("../common/renderers.js").HeadingProps) => import("react").JSX.Element;
+export declare const HeritageBrand: import("react").FunctionComponent<HeritageBrandProps>;
+//# sourceMappingURL=index.d.ts.map

package/dist/heritage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/heritage/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAMH,KAAK,gBAAgB,EACxB,MAAM,oBAAoB,CAAA;AAG3B,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE;QACX,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAC1B,CAAA;CACJ,CAAA;AAoBD,yDAAyD;AACzD,eAAO,MAAM,eAAe;;EAc1B,CAAA;AAWF,eAAO,MAAM,uBAAuB;;;;;;EAIlC,CAAA;AAEF,eAAO,MAAM,mBAAmB,mFAAyC,CAAA;AACzE,eAAO,MAAM,cAAc,sFAAoC,CAAA;AAC/D,eAAO,MAAM,eAAe,2IAAqC,CAAA;AACjE,eAAO,MAAM,aAAa,uDAAmC,CAAA"}

package/dist/heritage/index.js

@@ -0,0 +1,44 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { COMMON_GRAMMAR_COMPONENTS, COMMON_UI_RULE_IDS, defineGrammarFamily, defineGrammarRuleConformance, } from "../common/index.js";
+import { createElement } from "react";
+const HeritageGrammarRootRenderer = (props) => {
+    const CommonGrammarRoot = COMMON_GRAMMAR_COMPONENTS.GrammarRoot;
+    return createElement(CommonGrammarRoot, { ...props, "data-grammar-family": "heritage" });
+};
+/** Family extension for non-interactive brand content inside a consumer-owned destination. */
+const HeritageBrandRenderer = ({ name, descriptor, logo }) => (_jsxs("span", { "data-family-component": "Brand", children: [_jsx("span", { "data-family-part": "brand-mark", "aria-hidden": "true", children: _jsx("img", { src: logo.src, alt: "", width: logo.width, height: logo.height }) }), _jsxs("span", { "data-family-part": "brand-copy", children: [_jsx("strong", { children: name }), _jsx("span", { children: descriptor })] })] }));
+/** Official product-neutral Heritage family contract. */
+export const heritageGrammar = defineGrammarFamily({
+    id: "heritage",
+    styles: {
+        entrypoint: "@starci/grammar/heritage/styles.css",
+        scope: { attribute: "data-grammar-family", value: "heritage" },
+    },
+    components: {
+        replacements: {
+            GrammarRoot: HeritageGrammarRootRenderer,
+        },
+        extensions: {
+            Brand: HeritageBrandRenderer,
+        },
+    },
+});
+const HERITAGE_FAMILY_EVIDENCE = {
+    "A11Y-4": ["Brand is non-interactive and its supplied image is decorative."],
+    "BOUNDARY-1": ["Heritage surfaces bind material only through emitted Common surface hooks."],
+    "COLOR-5": ["Heritage owns scoped light, dark, system, and forced-color variables."],
+    "FOCUS-1": ["Heritage binds the shared visible focus variable without replacing focus ownership."],
+    "GAP-2": ["Brand anatomy uses the invariant Common spacing tokens."],
+    "MEDIA-6": ["Brand receives approved logo identity; asset generation remains outside Grammar."],
+};
+export const heritageRuleConformance = defineGrammarRuleConformance({
+    familyId: "heritage",
+    inheritedCommonRules: COMMON_UI_RULE_IDS.filter((rule) => !(rule in HERITAGE_FAMILY_EVIDENCE)),
+    familyEvidence: HERITAGE_FAMILY_EVIDENCE,
+});
+export const HeritageGrammarRoot = heritageGrammar.components.GrammarRoot;
+export const HeritageButton = heritageGrammar.components.Button;
+export const HeritageHeading = heritageGrammar.components.Heading;
+export const HeritageBrand = heritageGrammar.components.Brand;
+//# sourceMappingURL=index.js.map

package/dist/heritage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/heritage/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EACH,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,GAG/B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAarC,MAAM,2BAA2B,GAA+C,CAAC,KAAK,EAAE,EAAE;IACtF,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,WAAW,CAAA;IAC/D,OAAO,aAAa,CAAC,iBAAiB,EAAE,EAAE,GAAG,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC,CAAA;AAC5F,CAAC,CAAA;AAED,8FAA8F;AAC9F,MAAM,qBAAqB,GAAiD,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CACxG,yCAA4B,OAAO,aAC/B,mCAAuB,YAAY,iBAAa,MAAM,YAClD,cAAK,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAC,EAAE,EAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,GAAI,GAClE,EACP,oCAAuB,YAAY,aAC/B,2BAAS,IAAI,GAAU,EACvB,yBAAO,UAAU,GAAQ,IACtB,IACJ,CACV,CAAA;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;IAC/C,EAAE,EAAE,UAAU;IACd,MAAM,EAAE;QACJ,UAAU,EAAE,qCAAqC;QACjD,KAAK,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,KAAK,EAAE,UAAU,EAAE;KACjE;IACD,UAAU,EAAE;QACR,YAAY,EAAE;YACV,WAAW,EAAE,2BAA2B;SAC3C;QACD,UAAU,EAAE;YACR,KAAK,EAAE,qBAAqB;SAC/B;KACJ;CACJ,CAAC,CAAA;AAEF,MAAM,wBAAwB,GAAG;IAC7B,QAAQ,EAAE,CAAC,gEAAgE,CAAC;IAC5E,YAAY,EAAE,CAAC,4EAA4E,CAAC;IAC5F,SAAS,EAAE,CAAC,uEAAuE,CAAC;IACpF,SAAS,EAAE,CAAC,qFAAqF,CAAC;IAClG,OAAO,EAAE,CAAC,yDAAyD,CAAC;IACpE,SAAS,EAAE,CAAC,kFAAkF,CAAC;CACzF,CAAA;AAEV,MAAM,CAAC,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;IAChE,QAAQ,EAAE,UAAU;IACpB,oBAAoB,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,wBAAwB,CAAC,CAAC;IAC9F,cAAc,EAAE,wBAAwB;CAC3C,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC,UAAU,CAAC,WAAW,CAAA;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,CAAA;AAC/D,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC,UAAU,CAAC,OAAO,CAAA;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC,UAAU,CAAC,KAAK,CAAA"}

package/dist/heritage/styles.css

@@ -0,0 +1,165 @@
+@import "../common/styles.css";
+
+@layer starci-grammar-heritage {
+    .grammar-common-root[data-grammar-family="heritage"] {
+        color-scheme: light;
+
+        --heritage-green-900: oklch(29% 0.085 147);
+        --heritage-green-700: oklch(42% 0.12 147);
+        --heritage-ink: oklch(18% 0.018 145);
+        --heritage-muted: oklch(49% 0.018 145);
+        --heritage-ivory: oklch(97.5% 0.014 96);
+        --heritage-paper: oklch(99.3% 0.005 96);
+        --heritage-line: oklch(88% 0.012 110);
+        --heritage-display: Georgia, "Times New Roman", serif;
+        --heritage-sans: "Segoe UI", Arial, ui-sans-serif, system-ui, sans-serif;
+
+        --accent: var(--heritage-green-700);
+        --accent-foreground: white;
+        --focus: var(--heritage-green-700);
+        --background: var(--heritage-ivory);
+        --foreground: var(--heritage-ink);
+        --surface: var(--heritage-paper);
+        --surface-foreground: var(--heritage-ink);
+        --surface-secondary: var(--heritage-ivory);
+        --surface-secondary-foreground: var(--heritage-ink);
+        --muted: var(--heritage-muted);
+        --border: var(--heritage-line);
+        --separator: var(--heritage-line);
+        --success: var(--heritage-green-700);
+        --success-foreground: white;
+        --warning: oklch(76% 0.13 82);
+        --warning-foreground: var(--heritage-ink);
+        --danger: oklch(55% 0.18 28);
+        --danger-foreground: white;
+        --info: oklch(70% 0.09 235);
+        --info-foreground: var(--heritage-ink);
+        --field-background: var(--heritage-paper);
+        --field-border: var(--heritage-line);
+        --field-foreground: var(--heritage-ink);
+        --field-placeholder: var(--heritage-muted);
+        --radius: 0;
+        --field-radius: 0;
+        --shadow-surface: 0 1.5rem 4rem rgb(16 68 37 / 12%);
+
+        color: var(--foreground);
+        background: var(--background);
+        font-family: var(--heritage-sans);
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"][data-grammar-theme="dark"] {
+        color-scheme: dark;
+
+        --heritage-green-900: oklch(88% 0.08 147);
+        --heritage-green-700: oklch(74% 0.12 147);
+        --heritage-ink: oklch(96% 0.01 96);
+        --heritage-muted: oklch(75% 0.018 110);
+        --heritage-ivory: oklch(16% 0.018 145);
+        --heritage-paper: oklch(21% 0.018 145);
+        --heritage-line: oklch(38% 0.025 145);
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-grammar-surface-card][data-slot="card"] {
+        border: 0;
+        background: transparent;
+        box-shadow: none;
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-grammar-surface-card][data-slot="card"] [data-grammar-frame="bounded"][data-slot="card-content"],
+    .grammar-common-root[data-grammar-family="heritage"] [data-grammar-surface] {
+        border: 1px solid var(--border);
+        border-radius: var(--radius);
+        background: var(--surface);
+        box-shadow: var(--shadow-surface);
+        color: var(--surface-foreground);
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-grammar-surface-card][data-slot="card"] [data-grammar-frame="bounded"][data-slot="card-content"][data-grammar-surface-depth="nested"],
+    .grammar-common-root[data-grammar-family="heritage"] [data-grammar-surface][data-grammar-surface-depth="nested"] {
+        background: var(--surface-secondary);
+        box-shadow: none;
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-grammar-surface-label] {
+        color: var(--heritage-green-900);
+        font-family: var(--heritage-display);
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-family-component="Brand"] {
+        display: inline-flex;
+        min-height: 3.5rem;
+        align-items: center;
+        gap: var(--grammar-row-gap);
+        text-align: start;
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-family-part="brand-mark"] {
+        display: grid;
+        inline-size: 3.5rem;
+        block-size: 3.5rem;
+        overflow: hidden;
+        flex: 0 0 auto;
+        place-items: center;
+        border-radius: 50%;
+        background: white;
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-family-part="brand-mark"] img {
+        inline-size: 100%;
+        block-size: 100%;
+        object-fit: cover;
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-family-part="brand-copy"] {
+        display: grid;
+        gap: 0.125rem;
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-family-part="brand-copy"] strong {
+        color: var(--heritage-green-900);
+        font-family: var(--heritage-display);
+        font-size: 1rem;
+        font-weight: 800;
+        letter-spacing: .125em;
+    }
+
+    .grammar-common-root[data-grammar-family="heritage"] [data-family-part="brand-copy"] span {
+        color: var(--heritage-muted);
+        font-size: .75rem;
+        font-weight: 650;
+        letter-spacing: .0625em;
+        text-transform: uppercase;
+    }
+
+    @media (prefers-color-scheme: dark) {
+        .grammar-common-root[data-grammar-family="heritage"][data-grammar-theme="system"] {
+            color-scheme: dark;
+
+            --heritage-green-900: oklch(88% 0.08 147);
+            --heritage-green-700: oklch(74% 0.12 147);
+            --heritage-ink: oklch(96% 0.01 96);
+            --heritage-muted: oklch(75% 0.018 110);
+            --heritage-ivory: oklch(16% 0.018 145);
+            --heritage-paper: oklch(21% 0.018 145);
+            --heritage-line: oklch(38% 0.025 145);
+        }
+    }
+
+    @media (forced-colors: active) {
+        .grammar-common-root[data-grammar-family="heritage"] {
+            --heritage-green-900: CanvasText;
+            --heritage-green-700: Highlight;
+            --heritage-ink: CanvasText;
+            --heritage-muted: GrayText;
+            --heritage-ivory: Canvas;
+            --heritage-paper: Canvas;
+            --heritage-line: CanvasText;
+            --shadow-surface: none;
+        }
+
+        .grammar-common-root[data-grammar-family="heritage"] [data-family-part="brand-mark"] {
+            border: 1px solid CanvasText;
+            background: Canvas;
+        }
+    }
+}

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

@@ -0,0 +1,12 @@
+import { type GrammarRootProps } from "../common/index.js";
+/** Official product-neutral Offset Pop sibling family over the Common contract. */
+export declare const offsetPopGrammar: import("../common/registry.js").GrammarFamilyContract<"offset-pop", {}>;
+export declare const offsetPopRuleConformance: Readonly<{
+    familyId: string;
+    inheritedCommonRules: readonly string[];
+    familyEvidence: Readonly<{
+        [x: string]: readonly string[];
+    }>;
+}>;
+export declare const OffsetPopGrammarRoot: ({ className, theme, ...props }: GrammarRootProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/offset-pop/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAMH,KAAK,gBAAgB,EACxB,MAAM,oBAAoB,CAAA;AAS3B,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,yEAY3B,CAAA;AAeF,eAAO,MAAM,wBAAwB;;;;;;EAInC,CAAA;AAEF,eAAO,MAAM,oBAAoB,mFAA0C,CAAA"}

package/dist/offset-pop/index.js

@@ -0,0 +1,41 @@
+"use client";
+import { COMMON_GRAMMAR_COMPONENTS, COMMON_UI_RULE_IDS, defineGrammarFamily, defineGrammarRuleConformance, } from "../common/index.js";
+import { createElement } from "react";
+/** Installs the Offset Pop scope without changing Common root props or behavior. */
+const OffsetPopGrammarRootRenderer = (props) => {
+    const CommonGrammarRoot = COMMON_GRAMMAR_COMPONENTS.GrammarRoot;
+    return createElement(CommonGrammarRoot, { ...props, "data-grammar-family": "offset-pop" });
+};
+/** Official product-neutral Offset Pop sibling family over the Common contract. */
+export const offsetPopGrammar = defineGrammarFamily({
+    id: "offset-pop",
+    styles: {
+        entrypoint: "@starci/grammar/offset-pop/styles.css",
+        scope: { attribute: "data-grammar-family", value: "offset-pop" },
+    },
+    components: {
+        replacements: {
+            GrammarRoot: OffsetPopGrammarRootRenderer,
+        },
+        extensions: {},
+    },
+});
+const OFFSET_POP_FAMILY_EVIDENCE = {
+    "ACCENT-1": ["Offset Pop binds one scoped pink decision accent."],
+    "BOUNDARY-1": ["Offset Pop material targets emitted Common surface and frame hooks."],
+    "COLOR-5": ["Offset Pop owns scoped light, dark, system, and forced-color variables."],
+    "FOCUS-1": ["Offset Pop keeps Common focus ownership and supplies a visible family focus color."],
+    "GAP-2": ["Family geometry uses the invariant Common spacing scale."],
+    "MOTION-2": ["Reduced motion removes Offset Pop transforms and transition duration."],
+    "PADDING-3": ["Offset Pop does not add a second inset owner to Common surface content."],
+    "RESPONSIVE-4": ["Narrow viewports retain content and reduce only family shadow geometry."],
+    "STATE-2": ["Pending and loading remain Common-owned; family CSS only reads emitted state hooks."],
+    "SURFACE-1": ["Top and nested surface treatments preserve Common surface roles."],
+};
+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,
+});
+export const OffsetPopGrammarRoot = offsetPopGrammar.components.GrammarRoot;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/offset-pop/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EACH,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,GAG/B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAErC,oFAAoF;AACpF,MAAM,4BAA4B,GAA+C,CAAC,KAAK,EAAE,EAAE;IACvF,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,WAAW,CAAA;IAC/D,OAAO,aAAa,CAAC,iBAAiB,EAAE,EAAE,GAAG,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,CAAC,CAAA;AAC9F,CAAC,CAAA;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;IAChD,EAAE,EAAE,YAAY;IAChB,MAAM,EAAE;QACJ,UAAU,EAAE,uCAAuC;QACnD,KAAK,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,KAAK,EAAE,YAAY,EAAE;KACnE;IACD,UAAU,EAAE;QACR,YAAY,EAAE;YACV,WAAW,EAAE,4BAA4B;SAC5C;QACD,UAAU,EAAE,EAAE;KACjB;CACJ,CAAC,CAAA;AAEF,MAAM,0BAA0B,GAAG;IAC/B,UAAU,EAAE,CAAC,mDAAmD,CAAC;IACjE,YAAY,EAAE,CAAC,qEAAqE,CAAC;IACrF,SAAS,EAAE,CAAC,yEAAyE,CAAC;IACtF,SAAS,EAAE,CAAC,oFAAoF,CAAC;IACjG,OAAO,EAAE,CAAC,0DAA0D,CAAC;IACrE,UAAU,EAAE,CAAC,uEAAuE,CAAC;IACrF,WAAW,EAAE,CAAC,yEAAyE,CAAC;IACxF,cAAc,EAAE,CAAC,yEAAyE,CAAC;IAC3F,SAAS,EAAE,CAAC,qFAAqF,CAAC;IAClG,WAAW,EAAE,CAAC,kEAAkE,CAAC;CAC3E,CAAA;AAEV,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;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAA"}