@starci/grammar 0.2.0 → 0.4.1

package/README.md

@@ -1,50 +1,71 @@
 # `@starci/grammar`
 
-Business-neutral UI contracts and versioned StarCi Grammar bundles.
+`@starci/grammar` separates one shared, business-free UI contract from sibling visual families.
+Common owns typed props, semantics, renderer anatomy, universal states/scales, and the family
+registry. Core, Heritage, and Offset Pop implement that contract with independently scoped visual
+DNA. The package contains no routes, domain entities, product decisions, or feature-named shells.
 
 ## Public entry points
 
-- `@starci/grammar/common` — contract kernel and runtime validation.
-- `@starci/grammar/core` — batteries-included, product-neutral leaves, composites, branches, layout capabilities and base contracts.
-- `@starci/grammar/offset-pop` — one declared visual extension of Core.
-- `@starci/grammar/common/styles.css`, `core/styles.css`, `offset-pop/styles.css` — canonical cascade entries. Short `.css` aliases are also exported.
+- `@starci/grammar/common` — shared React renderers, presentation-state helpers, and their CSS. Anonymous layout/action owners include `WorkspaceShell`, `Sidebar`, `Link`, and `TextAction`.
+- `@starci/grammar/core` — the StarCi Core family, its scoped root, DNA, and compatibility aliases.
+- `@starci/grammar/heritage` and `@starci/grammar/offset-pop` — sibling family roots,
+  conformance receipts, and scoped visual overlays.
+- `@starci/grammar/common/styles.css`, `@starci/grammar/core/styles.css`,
+  `@starci/grammar/heritage/styles.css`, and
+  `@starci/grammar/offset-pop/styles.css` — package stylesheets. Short `.css` export aliases are
+  also available.
 
-Install this workspace package while it is under development. Published consumers must pin one
-exact version rather than a range:
+Install the workspace package while developing locally:
 
 ```sh
 npm install ./packages/grammar
-# after publication: npm install --save-exact @starci/grammar@0.2.0
 ```
 
-```ts
-import { createContractRegistry } from "@starci/grammar/common"
-import { CORE_COMPONENT_CONTRACTS } from "@starci/grammar/core"
-import { offsetPopGrammar } from "@starci/grammar/offset-pop"
-```
+Import components from the focused entry point:
 
-```css
-@import "@starci/grammar/common/styles.css";
-@import "@starci/grammar/core/styles.css";
-@import "@starci/grammar/offset-pop/styles.css";
-```
+```tsx
+import {
+  PageContainer,
+  PrimaryRailLayout,
+  SurfaceCard,
+} from "@starci/grammar/common"
+import { CoreGrammarRoot } from "@starci/grammar/core"
+import "@starci/grammar/core/styles.css"
 
-`common` contains no React, Next.js, business entity, operation or domain state. A Product Block translates domain state into `PresentationState`; Grammar consumes only that neutral state.
+export const ProductSurface = () => (
+  <CoreGrammarRoot>
+    <PageContainer>
+      <PrimaryRailLayout
+        primary={<SurfaceCard ariaLabel="Main">...</SurfaceCard>}
+        rail={<SurfaceCard ariaLabel="Progress">...</SurfaceCard>}
+      />
+    </PageContainer>
+  </CoreGrammarRoot>
+)
+```
 
-Core owners expose additive, business-neutral capabilities without opening their anatomy:
+`GrammarRoot` from Common is neutral. `CoreGrammarRoot` applies `data-grammar-family="core"` and
+the Core stylesheet imports Common anatomy before adding StarCi light, dark, system, forced-colour,
+and HeroUI-compatible tokens. `STARCI_CORE_DNA` exposes the immutable
+design values, `STARCI_CORE_SPACING_SCALE` exposes the canonical 4px spacing steps,
+`STARCI_CORE_TOKEN_NAMES` exposes their CSS adaptation contract, and
+`STARCI_CORE_TOKEN_DEFAULTS` / `STARCI_CORE_DARK_TOKEN_DEFAULTS` expose the exact packaged values.
 
-- `StateMark` is a Core leaf for neutral presentation-state marks.
-- `StaticStateRow` is a Core composite for one non-interactive row in a Core-owned collection.
-- `SurfaceCard` supports bounded/frameless frames, page/contained scrolling and one label-end slot.
-- `SurfaceListCard` supports Core-owned static rows or a content-owned interactive collection, an accessible hidden label and one footer.
-- `Rail` supports a Core-owned complementary landmark or one content-owned navigation landmark, plus expanded/collapsed and motion/reduced-motion declarations.
+Heritage and Offset Pop replace only the neutral family root; every other Common renderer and prop
+contract is inherited. Each family stylesheet imports Common anatomy directly and never imports a
+sibling family stylesheet.
 
-`CORE_LAYOUT_CLASS_NAMES` is the closed product-neutral layout vocabulary. Product breakpoints,
-token names and selectors remain in the consuming application's contract registry.
-
-Adapters must bind directly to the `core.*` contract identity and emit the canonical `data-grammar-*` anatomy. A product-prefixed contract with no resolved Core axis is not a substitute for conformance.
+`IncludedMark` is the purpose-named 20px outlined circle-check for included offering content; it
+inherits foreground and never claims completion. `SurfaceCopyGroup` packages Core's compact `0.5rem`
+title/explanation rhythm. A `SurfaceCard` without `wholeAction` identifies itself as `static`, which
+is the appropriate comparison surface when its short facts must remain visible together.
 
-Contracts are immutable. Extensions may resolve only axes explicitly opened by the base contract. They cannot replace anatomy, mutate a closed invariant, substitute the owner or silently replace a duplicate registry key.
+Common components accept ordinary typed React props and keep semantic DOM and accessibility behavior.
+The application translates business data into those props; a family changes presentation only.
+`MediaFrame` presents an already selected asset and never decides whether to generate one. The
+machine-checkable `COMMON_UI_RULE_IDS`/`defineGrammarRuleConformance` boundary verifies that each
+family accounts for the canonical UI X-n catalog without copying the laws into package code.
 
 ## Package checks
 
@@ -53,3 +74,6 @@ npm run typecheck
 npm test
 npm pack --dry-run
 ```
+
+The package requires Node.js 20 or newer and has peer dependencies on React 18+ and
+`@heroui/react` 3.2+.

package/dist/common/conformance.d.ts

@@ -0,0 +1,31 @@
+import { RULE_FAMILY_COUNTS } from "./rule-catalog.generated.js";
+/**
+ * The catalog is GENERATED, not transcribed.
+ *
+ * The table that used to live here was a hand-typed copy of the knowledge tree's family list, and
+ * a copy is only correct on the day it is typed. By the time anyone looked, `accessibility` had
+ * renamed its ids from `ACCESSIBILITY-n` to `A11Y-n`, `render-truth` published `TRUTH-n`,
+ * `text-flow` published `FLOW-n`, and MEASURE, OVERFLOW and TONE had appeared - none of which the
+ * table knew, while three of its families named rules that no longer existed anywhere. Every
+ * conformance check went on passing against the wrong catalog, which is the worst outcome a check
+ * can have.
+ *
+ * Regenerate with `node scripts/generate-rule-catalog.mjs [knowledgeDir]` from the package root.
+ */
+export { RULE_FAMILY_COUNTS };
+/** Every canonical Common UI rule id, exactly as the knowledge tree spells it. */
+export declare const COMMON_UI_RULE_IDS: readonly string[];
+export type GrammarRuleConformance = {
+    readonly familyId: string;
+    readonly inheritedCommonRules: ReadonlyArray<string>;
+    readonly familyEvidence: Readonly<Record<string, ReadonlyArray<string>>>;
+};
+/** Machine-checkable family coverage against the canonical knowledge/ui X-n catalog. */
+export declare const defineGrammarRuleConformance: (definition: GrammarRuleConformance) => Readonly<{
+    familyId: string;
+    inheritedCommonRules: readonly string[];
+    familyEvidence: Readonly<{
+        [x: string]: readonly string[];
+    }>;
+}>;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/common/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/common/conformance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAEpF;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,mBAAqB,CAAA;AAEpD,MAAM,MAAM,sBAAsB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACpD,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;CAC3E,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,4BAA4B,GAAI,YAAY,sBAAsB;;;;;;EAa9E,CAAA"}

package/dist/common/conformance.js

@@ -0,0 +1,33 @@
+import { CANONICAL_RULE_IDS, RULE_FAMILY_COUNTS } from "./rule-catalog.generated.js";
+/**
+ * The catalog is GENERATED, not transcribed.
+ *
+ * The table that used to live here was a hand-typed copy of the knowledge tree's family list, and
+ * a copy is only correct on the day it is typed. By the time anyone looked, `accessibility` had
+ * renamed its ids from `ACCESSIBILITY-n` to `A11Y-n`, `render-truth` published `TRUTH-n`,
+ * `text-flow` published `FLOW-n`, and MEASURE, OVERFLOW and TONE had appeared - none of which the
+ * table knew, while three of its families named rules that no longer existed anywhere. Every
+ * conformance check went on passing against the wrong catalog, which is the worst outcome a check
+ * can have.
+ *
+ * Regenerate with `node scripts/generate-rule-catalog.mjs [knowledgeDir]` from the package root.
+ */
+export { RULE_FAMILY_COUNTS };
+/** Every canonical Common UI rule id, exactly as the knowledge tree spells it. */
+export const COMMON_UI_RULE_IDS = CANONICAL_RULE_IDS;
+/** Machine-checkable family coverage against the canonical knowledge/ui X-n catalog. */
+export const defineGrammarRuleConformance = (definition) => {
+    const inherited = new Set(definition.inheritedCommonRules);
+    const evidence = new Set(Object.keys(definition.familyEvidence));
+    const missing = COMMON_UI_RULE_IDS.filter((rule) => !inherited.has(rule) && !evidence.has(rule));
+    const unknown = [...inherited, ...evidence].filter((rule) => !COMMON_UI_RULE_IDS.includes(rule));
+    if (missing.length > 0 || unknown.length > 0) {
+        throw new TypeError(`Invalid ${definition.familyId} Grammar conformance: missing=[${missing.join(", ")}], unknown=[${unknown.join(", ")}]`);
+    }
+    return Object.freeze({
+        familyId: definition.familyId,
+        inheritedCommonRules: Object.freeze([...definition.inheritedCommonRules]),
+        familyEvidence: Object.freeze({ ...definition.familyEvidence }),
+    });
+};
+//# sourceMappingURL=conformance.js.map

package/dist/common/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../src/common/conformance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAEpF;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAE7B,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAA;AAQpD,wFAAwF;AACxF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,UAAkC,EAAE,EAAE;IAC/E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA;IAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAA;IAChE,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAChG,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAChG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,SAAS,CAAC,WAAW,UAAU,CAAC,QAAQ,kCAAkC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/I,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACzE,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC;KAClE,CAAC,CAAA;AACN,CAAC,CAAA"}

package/dist/common/index.d.ts

@@ -1,74 +1,6 @@
-/** Render-neutral states accepted by Grammar contracts. Product Blocks own every domain mapping. */
-export declare const PRESENTATION_STATES: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
-export type PresentationState = (typeof PRESENTATION_STATES)[number];
-export declare const isPresentationState: (value: unknown) => value is PresentationState;
-export declare const assertPresentationState: (value: unknown) => asserts value is PresentationState;
-/** Package-owned component tiers. The spelling matches the public export topology. */
-export type GrammarLayer = "leaves" | "branch" | "composites";
-/** Contract boundaries that an extension can never reopen. */
-export type ClosedContractChange = "anatomy" | "closed-invariant" | "owner-substitution";
-/** The only dimensions on which a derived Grammar may supply values. */
-export type GrammarExtensionPolicy<Axis extends string = string> = Readonly<{
-    allowedAxes: ReadonlyArray<Axis>;
-    forbiddenChanges: ReadonlyArray<ClosedContractChange>;
-}>;
-/** Business-neutral reusable owner contract. Additional package metadata must remain data-only. */
-export type GrammarContractSpec<Axis extends string = string> = Readonly<{
-    version: string;
-    layer: GrammarLayer;
-    slots: ReadonlyArray<string>;
-    stateInputs: ReadonlyArray<string>;
-    variableAxes: ReadonlyArray<Axis>;
-    extensionPolicy: GrammarExtensionPolicy<Axis>;
-    closedInvariants: ReadonlyArray<string>;
-}>;
-/** One declared derivation. Every value key must have a matching requested axis. */
-export type GrammarContractExtension<Axis extends string = string> = Readonly<{
-    id: string;
-    version: string;
-    base: Readonly<{
-        key: string;
-        version: string;
-    }>;
-    axes: ReadonlyArray<Axis>;
-    values: Readonly<Record<Axis, unknown>>;
-}>;
-/** Immutable provenance for a contract derived from another contract. */
-export type GrammarContractBase = Readonly<{
-    key: string;
-    version: string;
-    rootKey: string;
-    rootVersion: string;
-}>;
-/** A closed, runtime-validated contract value. */
-export type GrammarContract<Key extends string = string, Spec extends GrammarContractSpec = GrammarContractSpec> = Readonly<{
-    key: Key;
-    version: string;
-    spec: Readonly<Spec>;
-    base: GrammarContractBase | null;
-    resolvedAxes: Readonly<Record<string, unknown>>;
-}>;
-/** Stable refusal identities for callers and tests. */
-export type GrammarContractErrorCode = "invalid-key" | "invalid-version" | "invalid-spec" | "duplicate-entry" | "allowed-axis-not-variable" | "duplicate-contract-key" | "missing-base-contract" | "same-extension-key" | "extension-id-mismatch" | "extension-base-mismatch" | "axis-not-allowed" | "axis-already-resolved" | "missing-axis-value" | "undeclared-axis-value" | "cyclic-value" | "unsupported-value";
-/** Fail-closed error emitted by every runtime guard in this module. */
-export declare class GrammarContractError extends Error {
-    readonly code: GrammarContractErrorCode;
-    constructor(code: GrammarContractErrorCode, message: string);
-}
-/** Define one immutable base contract after validating its closed boundaries. */
-export declare const defineGrammarContract: <const Key extends string, const Spec extends GrammarContractSpec>(key: Key, spec: Spec) => GrammarContract<Key, Spec>;
-/** Derive a contract by resolving declared axes without changing its base anatomy or invariants. */
-export declare const extendGrammarContract: <const Key extends string, Spec extends GrammarContractSpec, Axis extends string>(key: Key, base: GrammarContract<string, Spec>, extension: GrammarContractExtension<Axis>) => GrammarContract<Key, Spec>;
-/** Typed in-memory registry used by each Grammar bundle while it assembles its public contracts. */
-export type GrammarContractRegistry<Spec extends GrammarContractSpec> = Readonly<{
-    define: <const Key extends string, const Input extends Spec>(key: Key, spec: Input) => GrammarContract<Key, Input>;
-    extend: <const Key extends string, Axis extends string>(key: Key, baseKey: string, extension: GrammarContractExtension<Axis>) => GrammarContract<Key, Spec>;
-    register: <const Key extends string, const Input extends Spec>(contract: GrammarContract<Key, Input>) => GrammarContract<Key, Input>;
-    get: (key: string) => GrammarContract<string, Spec> | undefined;
-    require: (key: string) => GrammarContract<string, Spec>;
-    has: (key: string) => boolean;
-    entries: () => ReadonlyArray<GrammarContract<string, Spec>>;
-}>;
-/** Create an isolated fail-closed registry. Duplicate keys never replace an earlier contract. */
-export declare const createContractRegistry: <Spec extends GrammarContractSpec>() => GrammarContractRegistry<Spec>;
+export { PRESENTATION_STATES, assertPresentationState, isPresentationState, type PresentationState } from "./state.js";
+export { COMMON_SPACING_SCALE, COMMON_SPACING_TOKENS, type CommonSpacingStep, type CommonSpacingValue } from "./spacing.js";
+export { COMMON_UI_RULE_IDS, defineGrammarRuleConformance, type GrammarRuleConformance } from "./conformance.js";
+export * from "./renderers.js";
+export { COMMON_GRAMMAR_COMPONENTS, defineGrammarFamily, type CommonGrammarComponentName, type GrammarComponentRenderer, type GrammarFamilyContract, type GrammarFamilyStyles, } from "./registry.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACtH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC3H,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAChH,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EACH,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GAC3B,MAAM,eAAe,CAAA"}

package/dist/common/index.js

@@ -1,203 +1,6 @@
-/** Render-neutral states accepted by Grammar contracts. Product Blocks own every domain mapping. */
-export const PRESENTATION_STATES = [
-    "neutral",
-    "informative",
-    "affirmative",
-    "cautionary",
-    "negative",
-    "pending",
-    "unavailable",
-];
-const presentationStateSet = new Set(PRESENTATION_STATES);
-export const isPresentationState = (value) => (typeof value === "string" && presentationStateSet.has(value));
-export const assertPresentationState = (value) => {
-    if (!isPresentationState(value))
-        throw new TypeError(`Unknown neutral presentation state: ${JSON.stringify(value)}`);
-};
-/** Fail-closed error emitted by every runtime guard in this module. */
-export class GrammarContractError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = "GrammarContractError";
-        this.code = code;
-    }
-}
-const stableKeyPattern = /^[a-z0-9]+(?:[./-][a-z0-9]+)*$/;
-const exactVersionPattern = /^[0-9]+\.[0-9]+\.[0-9]+(?:-[0-9A-Za-z]+(?:[.-][0-9A-Za-z]+)*)?$/;
-const requiredForbiddenChanges = [
-    "anatomy",
-    "closed-invariant",
-    "owner-substitution",
-];
-const fail = (code, message) => {
-    throw new GrammarContractError(code, message);
-};
-const validateStableKey = (value, label) => {
-    if (!stableKeyPattern.test(value))
-        fail("invalid-key", `${label} must be a stable lowercase key: ${value}`);
-};
-const validateExactVersion = (value, label) => {
-    if (!exactVersionPattern.test(value)) {
-        fail("invalid-version", `${label} must be one exact semantic version: ${value}`);
-    }
-};
-const validateStringSet = (values, label) => {
-    if (!Array.isArray(values))
-        fail("invalid-spec", `${label} must be an array`);
-    const seen = new Set();
-    for (const value of values) {
-        if (typeof value !== "string" || value.length === 0 || value.trim() !== value) {
-            fail("invalid-spec", `${label} contains an empty or untrimmed value`);
-        }
-        validateStableKey(value, label);
-        if (seen.has(value))
-            fail("duplicate-entry", `${label} contains duplicate value: ${value}`);
-        seen.add(value);
-    }
-};
-const cloneClosed = (value, path, ancestors) => {
-    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean")
-        return value;
-    if (Array.isArray(value)) {
-        if (ancestors.has(value))
-            fail("cyclic-value", `${path} contains a cycle`);
-        ancestors.add(value);
-        const copy = value.map((item, index) => cloneClosed(item, `${path}[${index}]`, ancestors));
-        ancestors.delete(value);
-        return Object.freeze(copy);
-    }
-    if (typeof value === "object") {
-        if (ancestors.has(value))
-            fail("cyclic-value", `${path} contains a cycle`);
-        const prototype = Object.getPrototypeOf(value);
-        if (prototype !== Object.prototype && prototype !== null) {
-            fail("unsupported-value", `${path} must contain only plain data`);
-        }
-        ancestors.add(value);
-        const copy = {};
-        for (const [key, child] of Object.entries(value))
-            copy[key] = cloneClosed(child, `${path}.${key}`, ancestors);
-        ancestors.delete(value);
-        return Object.freeze(copy);
-    }
-    return fail("unsupported-value", `${path} contains unsupported ${typeof value}`);
-};
-const closedCopy = (value, path) => cloneClosed(value, path, new WeakSet());
-const validateSpec = (spec) => {
-    if (spec === null || typeof spec !== "object")
-        fail("invalid-spec", "contract spec must be an object");
-    validateExactVersion(spec.version, "contract version");
-    if (!["leaves", "branch", "composites"].includes(spec.layer)) {
-        fail("invalid-spec", `unsupported Grammar layer: ${String(spec.layer)}`);
-    }
-    validateStringSet(spec.slots, "slots");
-    validateStringSet(spec.stateInputs, "stateInputs");
-    validateStringSet(spec.variableAxes, "variableAxes");
-    if (spec.extensionPolicy === null || typeof spec.extensionPolicy !== "object") {
-        fail("invalid-spec", "extensionPolicy must be an object");
-    }
-    validateStringSet(spec.extensionPolicy.allowedAxes, "extensionPolicy.allowedAxes");
-    validateStringSet(spec.extensionPolicy.forbiddenChanges, "extensionPolicy.forbiddenChanges");
-    validateStringSet(spec.closedInvariants, "closedInvariants");
-    const variableAxes = new Set(spec.variableAxes);
-    for (const axis of spec.extensionPolicy.allowedAxes) {
-        if (!variableAxes.has(axis)) {
-            fail("allowed-axis-not-variable", `allowed extension axis is not a variable axis: ${axis}`);
-        }
-    }
-    for (const change of requiredForbiddenChanges) {
-        if (!spec.extensionPolicy.forbiddenChanges.includes(change)) {
-            fail("invalid-spec", `extensionPolicy.forbiddenChanges must include ${change}`);
-        }
-    }
-};
-/** Define one immutable base contract after validating its closed boundaries. */
-export const defineGrammarContract = (key, spec) => {
-    validateStableKey(key, "contract key");
-    validateSpec(spec);
-    return Object.freeze({
-        key,
-        version: spec.version,
-        spec: closedCopy(spec, `contract ${key}`),
-        base: null,
-        resolvedAxes: Object.freeze({}),
-    });
-};
-/** Derive a contract by resolving declared axes without changing its base anatomy or invariants. */
-export const extendGrammarContract = (key, base, extension) => {
-    validateStableKey(key, "extension key");
-    validateStableKey(extension.id, "extension id");
-    validateExactVersion(extension.version, "extension version");
-    validateStableKey(extension.base.key, "extension base key");
-    validateExactVersion(extension.base.version, "extension base version");
-    if (key === base.key)
-        fail("same-extension-key", `extension key must differ from base key: ${key}`);
-    if (extension.id !== key) {
-        fail("extension-id-mismatch", `extension id ${extension.id} does not match registered key ${key}`);
-    }
-    if (extension.base.key !== base.key || extension.base.version !== base.version) {
-        fail("extension-base-mismatch", `extension base ${extension.base.key}@${extension.base.version} does not match ${base.key}@${base.version}`);
-    }
-    validateStringSet(extension.axes, "extension.axes");
-    if (extension.values === null || typeof extension.values !== "object" || Array.isArray(extension.values)) {
-        fail("invalid-spec", "extension.values must be an object");
-    }
-    const requested = new Set(extension.axes);
-    const allowed = new Set(base.spec.extensionPolicy.allowedAxes);
-    for (const axis of extension.axes) {
-        if (!allowed.has(axis))
-            fail("axis-not-allowed", `extension axis is closed: ${axis}`);
-        if (Object.hasOwn(base.resolvedAxes, axis)) {
-            fail("axis-already-resolved", `extension axis is already resolved: ${axis}`);
-        }
-        if (!Object.hasOwn(extension.values, axis))
-            fail("missing-axis-value", `extension axis has no value: ${axis}`);
-    }
-    for (const axis of Object.keys(extension.values)) {
-        if (!requested.has(axis))
-            fail("undeclared-axis-value", `extension value has no declared axis: ${axis}`);
-    }
-    const values = closedCopy(extension.values, `extension ${key}`);
-    const baseRef = Object.freeze({
-        key: base.key,
-        version: base.version,
-        rootKey: base.base?.rootKey ?? base.key,
-        rootVersion: base.base?.rootVersion ?? base.version,
-    });
-    return Object.freeze({
-        key,
-        version: extension.version,
-        spec: base.spec,
-        base: baseRef,
-        resolvedAxes: Object.freeze({ ...base.resolvedAxes, ...values }),
-    });
-};
-/** Create an isolated fail-closed registry. Duplicate keys never replace an earlier contract. */
-export const createContractRegistry = () => {
-    const contracts = new Map();
-    const register = (contract) => {
-        if (contracts.has(contract.key)) {
-            fail("duplicate-contract-key", `contract key is already registered: ${contract.key}`);
-        }
-        contracts.set(contract.key, contract);
-        return contract;
-    };
-    const requireContract = (key) => {
-        const contract = contracts.get(key);
-        if (contract === undefined) {
-            return fail("missing-base-contract", `contract key is not registered: ${key}`);
-        }
-        return contract;
-    };
-    return Object.freeze({
-        define: (key, spec) => (register(defineGrammarContract(key, spec))),
-        extend: (key, baseKey, extension) => register(extendGrammarContract(key, requireContract(baseKey), extension)),
-        register,
-        get: (key) => contracts.get(key),
-        require: requireContract,
-        has: (key) => contracts.has(key),
-        entries: () => Object.freeze(Array.from(contracts.values())),
-    });
-};
+export { PRESENTATION_STATES, assertPresentationState, isPresentationState } from "./state.js";
+export { COMMON_SPACING_SCALE, COMMON_SPACING_TOKENS } from "./spacing.js";
+export { COMMON_UI_RULE_IDS, defineGrammarRuleConformance } from "./conformance.js";
+export * from "./renderers.js";
+export { COMMON_GRAMMAR_COMPONENTS, defineGrammarFamily, } from "./registry.js";
 //# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,mBAAmB,EAA0B,MAAM,YAAY,CAAA;AACtH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAmD,MAAM,cAAc,CAAA;AAC3H,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAA+B,MAAM,kBAAkB,CAAA;AAChH,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EACH,yBAAyB,EACzB,mBAAmB,GAKtB,MAAM,eAAe,CAAA"}

package/dist/common/registry.d.ts

@@ -0,0 +1,79 @@
+import type { ComponentProps, ComponentType, ElementType } from "react";
+export type GrammarComponentRenderer<Props> = ComponentType<Props>;
+type GrammarRendererRegistry = Readonly<Record<string, ElementType>>;
+type CompatibleReplacements<Common extends GrammarRendererRegistry> = {
+    readonly [Name in keyof Common]?: GrammarComponentRenderer<ComponentProps<Common[Name]>>;
+};
+type ExtensionWithoutCommonCollisions<Common extends GrammarRendererRegistry, Extensions extends GrammarRendererRegistry> = Extensions & {
+    readonly [Name in Extract<keyof Extensions, keyof Common>]: never;
+};
+export declare const COMMON_GRAMMAR_COMPONENTS: Readonly<{
+    readonly Badge: ({ children, startContent, tone, isSkeleton }: import("./renderers.js").BadgeProps) => import("react").JSX.Element;
+    readonly Button: (props: import("./renderers.js").ButtonProps) => import("react").JSX.Element;
+    readonly ChatWorkspace: (props: import("./renderers.js").ChatWorkspaceProps) => import("react").JSX.Element;
+    readonly Divider: ({ label }: import("./renderers.js").DividerProps) => import("react").JSX.Element;
+    readonly EmptyNotice: ({ message, description, iconSource, actionLabel, actionStartContent, actionVariant, isActionPending, onAction, }: import("./renderers.js").EmptyNoticeProps) => import("react").JSX.Element;
+    readonly FencedCodeBlock: (props: import("./renderers.js").FencedCodeBlockProps) => import("react").JSX.Element;
+    readonly GrammarRoot: ({ className, theme, ...props }: import("./renderers.js").GrammarRootProps) => import("react").JSX.Element;
+    readonly Heading: ({ children, level, scale, isSkeleton, isVisuallyHidden, }: import("./renderers.js").HeadingProps) => import("react").JSX.Element;
+    readonly HorizontalScrollRegion: import("react").ForwardRefExoticComponent<Omit<import("./renderers.js").HorizontalScrollRegionProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+    readonly Icon: ({ source: Source, usage, ariaLabel, isSkeleton }: import("./renderers.js").IconProps) => import("react").JSX.Element;
+    readonly IconButton: ({ source, label, isActive, isDisabled, isSkeleton, onPress, }: import("./renderers.js").IconButtonProps) => import("react").JSX.Element;
+    readonly IconTile: ({ source, artwork, ariaLabel, tone, size, isSkeleton, }: import("./renderers.js").IconTileProps) => import("react").JSX.Element;
+    readonly IncludedMark: ({ className, label, ...props }: import("./renderers.js").IncludedMarkProps) => import("react").JSX.Element;
+    readonly Input: ({ id, name, label, kind: kindName, variant, placeholder, defaultValue, value, hint, errorMessage, isError, isDisabled, isRequired, isSkeleton, revealLabel, hideLabel, revealIcon: RevealIcon, hideIcon: HideIcon, onValueChange, }: import("./renderers.js").InputProps) => import("react").JSX.Element;
+    readonly Label: ({ id, children, depth, as }: import("./renderers.js").LabelProps) => import("react").JSX.Element;
+    readonly LeadingNumber: (props: import("./renderers.js").LeadingNumberProps) => import("react").JSX.Element;
+    readonly MarkdownArticle: (props: import("./renderers.js").MarkdownArticleProps) => import("react").JSX.Element;
+    readonly MarkdownTableFrame: (props: import("./renderers.js").MarkdownTableFrameProps) => import("react").JSX.Element;
+    readonly MediaFrame: ({ children, caption, aspect, fit, treatment, className, }: import("./renderers.js").MediaFrameProps) => import("react").JSX.Element;
+    readonly NavigationFeatureNav: ({ identity, navigation, navigationLabel, compactNavigationTrigger, compactNavigationTriggerLabel, actions, actionsLabel, featureNavigation, featureNavigationLabel, measure, position, className, ...headerProps }: import("./renderers.js").NavigationFeatureNavProps) => import("react").JSX.Element;
+    readonly OtpInput: (props: import("./renderers.js").OtpInputProps) => import("react").JSX.Element;
+    readonly PageContainer: ({ className, measure, ...props }: import("./renderers.js").PageContainerProps) => import("react").JSX.Element;
+    readonly PrimaryRailLayout: ({ primary, rail, railWidth, align, className, }: import("./renderers.js").PrimaryRailLayoutProps) => import("react").JSX.Element;
+    readonly Progress: ({ label, value, isSkeleton }: import("./renderers.js").ProgressProps) => import("react").JSX.Element;
+    readonly Rail: (props: import("./renderers.js").RailProps) => import("react").JSX.Element;
+    readonly RankArtwork: ({ className, kind, label, ...props }: import("./renderers.js").RankArtworkProps) => import("react").JSX.Element;
+    readonly SectionHeader: ({ title, description, eyebrow, action, level, className, id, composition, }: import("./renderers.js").SectionHeaderProps) => import("react").JSX.Element;
+    readonly Sidebar: ({ label, groups, selectedKey, presentation, isCollapsed, collapseLabel, expandLabel, toggleSource, header, footer, onAction, onCollapsedChange, }: import("./renderers.js").SidebarProps) => import("react").JSX.Element;
+    readonly StateMark: (props: import("./renderers.js").StateMarkProps) => import("react").JSX.Element | null;
+    readonly StaticStateRow: (props: import("./renderers.js").StaticStateRowProps) => import("react").JSX.Element;
+    readonly Subnav: ({ label, title, leading, menuIcon, openMenuLabel, closeMenuLabel, isMenuOpen, onMenuOpenChange, position, visibility, className, ...navProps }: import("./renderers.js").SubnavProps) => import("react").JSX.Element;
+    readonly SurfaceAccordionCard: <Summary, Body>(props: import("./renderers.js").SurfaceAccordionCardProps<Summary, Body>) => import("react").JSX.Element;
+    readonly SurfaceCard: (props: import("./renderers.js").SurfaceCardProps) => import("react").JSX.Element;
+    readonly SurfaceCopyGroup: ({ className, density, ...props }: import("./renderers.js").SurfaceCopyGroupProps) => import("react").JSX.Element;
+    readonly SurfaceListCard: (props: import("./renderers.js").SurfaceListCardProps) => import("react").JSX.Element;
+    readonly Tabs: (props: import("./renderers.js").TabsProps) => import("react").JSX.Element;
+    readonly Text: ({ as: Element, id, children, startContent, size, tone, weight, live, isSkeleton, isSuperseded, parentEmphasis, }: import("./renderers.js").TextProps) => import("react").JSX.Element;
+    readonly TextAction: (props: import("./renderers.js").TextActionProps) => import("react").JSX.Element;
+    readonly Tooltip: ({ content, children, placement, }: import("./renderers.js").TooltipProps) => import("react").JSX.Element;
+    readonly VerticalScrollRegion: (props: import("./renderers.js").VerticalScrollRegionProps) => import("react").JSX.Element;
+    readonly WorkspaceShell: (props: import("./renderers.js").WorkspaceShellProps) => import("react").JSX.Element;
+}>;
+export type CommonGrammarComponentName = keyof typeof COMMON_GRAMMAR_COMPONENTS;
+export type GrammarFamilyStyles<FamilyId extends string> = {
+    readonly entrypoint: `@starci/grammar/${string}/styles.css`;
+    readonly scope: {
+        readonly attribute: "data-grammar-family";
+        readonly value: FamilyId;
+    };
+};
+export type GrammarFamilyContract<FamilyId extends string, Extensions extends GrammarRendererRegistry> = {
+    readonly id: FamilyId;
+    readonly styles: GrammarFamilyStyles<FamilyId>;
+    readonly components: Readonly<typeof COMMON_GRAMMAR_COMPONENTS & Extensions>;
+    readonly scopeProps: Readonly<{
+        "data-grammar-family": FamilyId;
+    }>;
+};
+/** Define one visual family over the stable Common semantic contract. */
+export declare const defineGrammarFamily: <const FamilyId extends string, const Replacements extends CompatibleReplacements<typeof COMMON_GRAMMAR_COMPONENTS>, const Extensions extends GrammarRendererRegistry>(definition: {
+    readonly id: FamilyId;
+    readonly styles: GrammarFamilyStyles<FamilyId>;
+    readonly components: {
+        readonly replacements: Replacements;
+        readonly extensions: ExtensionWithoutCommonCollisions<typeof COMMON_GRAMMAR_COMPONENTS, Extensions>;
+    };
+}) => GrammarFamilyContract<FamilyId, Extensions>;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/common/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/common/registry.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEvE,MAAM,MAAM,wBAAwB,CAAC,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,CAAA;AAClE,KAAK,uBAAuB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;AACpE,KAAK,sBAAsB,CAAC,MAAM,SAAS,uBAAuB,IAAI;IAClE,QAAQ,EAAE,IAAI,IAAI,MAAM,MAAM,CAAC,CAAC,EAAE,wBAAwB,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CAC3F,CAAA;AACD,KAAK,gCAAgC,CAAC,MAAM,SAAS,uBAAuB,EAAE,UAAU,SAAS,uBAAuB,IACpH,UAAU,GAAG;IAAE,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,MAAM,CAAC,GAAG,KAAK;CAAE,CAAA;AAEtF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ3B,CAAA;AACX,MAAM,MAAM,0BAA0B,GAAG,MAAM,OAAO,yBAAyB,CAAA;AAE/E,MAAM,MAAM,mBAAmB,CAAC,QAAQ,SAAS,MAAM,IAAI;IACvD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,MAAM,aAAa,CAAA;IAC3D,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAA;CAC1F,CAAA;AAED,MAAM,MAAM,qBAAqB,CAAC,QAAQ,SAAS,MAAM,EAAE,UAAU,SAAS,uBAAuB,IAAI;IACrG,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC9C,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,OAAO,yBAAyB,GAAG,UAAU,CAAC,CAAA;IAC5E,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;QAAE,qBAAqB,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAA;CACrE,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,GAC5B,KAAK,CAAC,QAAQ,SAAS,MAAM,EAC7B,KAAK,CAAC,YAAY,SAAS,sBAAsB,CAAC,OAAO,yBAAyB,CAAC,EACnF,KAAK,CAAC,UAAU,SAAS,uBAAuB,EAClD,YAAY;IACV,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAA;IAC9C,QAAQ,CAAC,UAAU,EAAE;QACjB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;QACnC,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC,OAAO,yBAAyB,EAAE,UAAU,CAAC,CAAA;KACtG,CAAA;CACJ,KAAG,qBAAqB,CAAC,QAAQ,EAAE,UAAU,CAuB7C,CAAA"}