@starci/grammar 0.1.0

package/dist/core/contracts.d.ts

@@ -0,0 +1,190 @@
+import { type GrammarContract, type GrammarContractSpec } from "../common/index.js";
+export declare const surfaceCardContract: Readonly<{
+    key: "core.surface-card";
+    version: string;
+    spec: Readonly<{
+        readonly version: "1.0.0";
+        readonly layer: "branch";
+        readonly slots: readonly ["external-label", "content", "whole-action"];
+        readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+        readonly variableAxes: readonly ["surface-depth", "state-treatment", "action-mode", "container-response"];
+        readonly extensionPolicy: {
+            readonly allowedAxes: readonly ["surface-depth", "state-treatment", "container-response"];
+            readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+        };
+        readonly closedInvariants: readonly ["label-outside-surface", "nested-border-xor-shadow", "one-content-owner", "whole-action-is-overlay", "neutral-state-only"];
+    }>;
+    base: Readonly<{
+        key: string;
+        version: string;
+        rootKey: string;
+        rootVersion: string;
+    }> | null;
+    resolvedAxes: Readonly<Record<string, unknown>>;
+}>;
+export declare const surfaceListCardContract: Readonly<{
+    key: "core.surface-list-card";
+    version: string;
+    spec: Readonly<{
+        readonly version: "1.0.0";
+        readonly layer: "branch";
+        readonly slots: readonly ["external-label", "single-list-shell", "static-row"];
+        readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+        readonly variableAxes: readonly ["surface-depth", "state-treatment", "row-count", "container-response"];
+        readonly extensionPolicy: {
+            readonly allowedAxes: readonly ["surface-depth", "state-treatment", "container-response"];
+            readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+        };
+        readonly closedInvariants: readonly ["one-list-one-shell", "rows-separated-by-dividers", "affirmative-row-uses-one-check", "nested-border-xor-shadow", "static-rows-have-no-action", "neutral-state-only"];
+    }>;
+    base: Readonly<{
+        key: string;
+        version: string;
+        rootKey: string;
+        rootVersion: string;
+    }> | null;
+    resolvedAxes: Readonly<Record<string, unknown>>;
+}>;
+export declare const railContract: Readonly<{
+    key: "core.rail";
+    version: string;
+    spec: Readonly<{
+        readonly version: "1.0.0";
+        readonly layer: "branch";
+        readonly slots: readonly ["heading", "body", "footer"];
+        readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+        readonly variableAxes: readonly ["rail-mode", "rail-width", "state-treatment", "container-response"];
+        readonly extensionPolicy: {
+            readonly allowedAxes: readonly ["rail-width", "state-treatment", "container-response"];
+            readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+        };
+        readonly closedInvariants: readonly ["one-rail-landmark", "sticky-disabled-on-narrow-viewport", "body-remains-reachable", "footer-follows-body", "neutral-state-only"];
+    }>;
+    base: Readonly<{
+        key: string;
+        version: string;
+        rootKey: string;
+        rootVersion: string;
+    }> | null;
+    resolvedAxes: Readonly<Record<string, unknown>>;
+}>;
+export declare const visualTreatmentContract: Readonly<{
+    key: "core.visual-treatment";
+    version: string;
+    spec: Readonly<{
+        readonly version: "1.0.0";
+        readonly layer: "composites";
+        readonly slots: readonly ["field", "surface", "display-copy", "floating-cluster"];
+        readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+        readonly variableAxes: readonly ["palette", "display-type", "outline-shadow", "floating-composition", "motion"];
+        readonly extensionPolicy: {
+            readonly allowedAxes: readonly ["palette", "display-type", "outline-shadow", "floating-composition", "motion"];
+            readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+        };
+        readonly closedInvariants: readonly ["business-neutral", "semantic-html-unchanged", "component-anatomy-unchanged", "state-vocabulary-unchanged", "content-remains-readable-without-decoration"];
+    }>;
+    base: Readonly<{
+        key: string;
+        version: string;
+        rootKey: string;
+        rootVersion: string;
+    }> | null;
+    resolvedAxes: Readonly<Record<string, unknown>>;
+}>;
+export declare const CORE_COMPONENT_CONTRACTS: Readonly<{
+    "core.surface-card": Readonly<{
+        key: "core.surface-card";
+        version: string;
+        spec: Readonly<{
+            readonly version: "1.0.0";
+            readonly layer: "branch";
+            readonly slots: readonly ["external-label", "content", "whole-action"];
+            readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+            readonly variableAxes: readonly ["surface-depth", "state-treatment", "action-mode", "container-response"];
+            readonly extensionPolicy: {
+                readonly allowedAxes: readonly ["surface-depth", "state-treatment", "container-response"];
+                readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+            };
+            readonly closedInvariants: readonly ["label-outside-surface", "nested-border-xor-shadow", "one-content-owner", "whole-action-is-overlay", "neutral-state-only"];
+        }>;
+        base: Readonly<{
+            key: string;
+            version: string;
+            rootKey: string;
+            rootVersion: string;
+        }> | null;
+        resolvedAxes: Readonly<Record<string, unknown>>;
+    }>;
+    "core.surface-list-card": Readonly<{
+        key: "core.surface-list-card";
+        version: string;
+        spec: Readonly<{
+            readonly version: "1.0.0";
+            readonly layer: "branch";
+            readonly slots: readonly ["external-label", "single-list-shell", "static-row"];
+            readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+            readonly variableAxes: readonly ["surface-depth", "state-treatment", "row-count", "container-response"];
+            readonly extensionPolicy: {
+                readonly allowedAxes: readonly ["surface-depth", "state-treatment", "container-response"];
+                readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+            };
+            readonly closedInvariants: readonly ["one-list-one-shell", "rows-separated-by-dividers", "affirmative-row-uses-one-check", "nested-border-xor-shadow", "static-rows-have-no-action", "neutral-state-only"];
+        }>;
+        base: Readonly<{
+            key: string;
+            version: string;
+            rootKey: string;
+            rootVersion: string;
+        }> | null;
+        resolvedAxes: Readonly<Record<string, unknown>>;
+    }>;
+    "core.rail": Readonly<{
+        key: "core.rail";
+        version: string;
+        spec: Readonly<{
+            readonly version: "1.0.0";
+            readonly layer: "branch";
+            readonly slots: readonly ["heading", "body", "footer"];
+            readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+            readonly variableAxes: readonly ["rail-mode", "rail-width", "state-treatment", "container-response"];
+            readonly extensionPolicy: {
+                readonly allowedAxes: readonly ["rail-width", "state-treatment", "container-response"];
+                readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+            };
+            readonly closedInvariants: readonly ["one-rail-landmark", "sticky-disabled-on-narrow-viewport", "body-remains-reachable", "footer-follows-body", "neutral-state-only"];
+        }>;
+        base: Readonly<{
+            key: string;
+            version: string;
+            rootKey: string;
+            rootVersion: string;
+        }> | null;
+        resolvedAxes: Readonly<Record<string, unknown>>;
+    }>;
+    "core.visual-treatment": Readonly<{
+        key: "core.visual-treatment";
+        version: string;
+        spec: Readonly<{
+            readonly version: "1.0.0";
+            readonly layer: "composites";
+            readonly slots: readonly ["field", "surface", "display-copy", "floating-cluster"];
+            readonly stateInputs: readonly ["neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable"];
+            readonly variableAxes: readonly ["palette", "display-type", "outline-shadow", "floating-composition", "motion"];
+            readonly extensionPolicy: {
+                readonly allowedAxes: readonly ["palette", "display-type", "outline-shadow", "floating-composition", "motion"];
+                readonly forbiddenChanges: readonly ["anatomy", "closed-invariant", "owner-substitution"];
+            };
+            readonly closedInvariants: readonly ["business-neutral", "semantic-html-unchanged", "component-anatomy-unchanged", "state-vocabulary-unchanged", "content-remains-readable-without-decoration"];
+        }>;
+        base: Readonly<{
+            key: string;
+            version: string;
+            rootKey: string;
+            rootVersion: string;
+        }> | null;
+        resolvedAxes: Readonly<Record<string, unknown>>;
+    }>;
+}>;
+export type CoreComponentContract = GrammarContract<string, GrammarContractSpec>;
+export type CoreComponentContractId = keyof typeof CORE_COMPONENT_CONTRACTS;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/core/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/core/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAC3B,MAAM,oBAAoB,CAAA;AAsF3B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;EAA8D,CAAA;AAC9F,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;EAAuE,CAAA;AAC3G,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;EAA+C,CAAA;AACxE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;EAAsE,CAAA;AAE1G,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKnC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;AAChF,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,wBAAwB,CAAA"}

package/dist/core/contracts.js

@@ -0,0 +1,91 @@
+import { defineGrammarContract, } from "../common/index.js";
+import { PRESENTATION_STATES } from "./state.js";
+const CLOSED_EXTENSION_BOUNDARIES = [
+    "anatomy",
+    "closed-invariant",
+    "owner-substitution",
+];
+const surfaceCardSpec = {
+    version: "1.0.0",
+    layer: "branch",
+    slots: ["external-label", "content", "whole-action"],
+    stateInputs: PRESENTATION_STATES,
+    variableAxes: ["surface-depth", "state-treatment", "action-mode", "container-response"],
+    extensionPolicy: {
+        allowedAxes: ["surface-depth", "state-treatment", "container-response"],
+        forbiddenChanges: CLOSED_EXTENSION_BOUNDARIES,
+    },
+    closedInvariants: [
+        "label-outside-surface",
+        "nested-border-xor-shadow",
+        "one-content-owner",
+        "whole-action-is-overlay",
+        "neutral-state-only",
+    ],
+};
+const surfaceListCardSpec = {
+    version: "1.0.0",
+    layer: "branch",
+    slots: ["external-label", "single-list-shell", "static-row"],
+    stateInputs: PRESENTATION_STATES,
+    variableAxes: ["surface-depth", "state-treatment", "row-count", "container-response"],
+    extensionPolicy: {
+        allowedAxes: ["surface-depth", "state-treatment", "container-response"],
+        forbiddenChanges: CLOSED_EXTENSION_BOUNDARIES,
+    },
+    closedInvariants: [
+        "one-list-one-shell",
+        "rows-separated-by-dividers",
+        "affirmative-row-uses-one-check",
+        "nested-border-xor-shadow",
+        "static-rows-have-no-action",
+        "neutral-state-only",
+    ],
+};
+const railSpec = {
+    version: "1.0.0",
+    layer: "branch",
+    slots: ["heading", "body", "footer"],
+    stateInputs: PRESENTATION_STATES,
+    variableAxes: ["rail-mode", "rail-width", "state-treatment", "container-response"],
+    extensionPolicy: {
+        allowedAxes: ["rail-width", "state-treatment", "container-response"],
+        forbiddenChanges: CLOSED_EXTENSION_BOUNDARIES,
+    },
+    closedInvariants: [
+        "one-rail-landmark",
+        "sticky-disabled-on-narrow-viewport",
+        "body-remains-reachable",
+        "footer-follows-body",
+        "neutral-state-only",
+    ],
+};
+const visualTreatmentSpec = {
+    version: "1.0.0",
+    layer: "composites",
+    slots: ["field", "surface", "display-copy", "floating-cluster"],
+    stateInputs: PRESENTATION_STATES,
+    variableAxes: ["palette", "display-type", "outline-shadow", "floating-composition", "motion"],
+    extensionPolicy: {
+        allowedAxes: ["palette", "display-type", "outline-shadow", "floating-composition", "motion"],
+        forbiddenChanges: CLOSED_EXTENSION_BOUNDARIES,
+    },
+    closedInvariants: [
+        "business-neutral",
+        "semantic-html-unchanged",
+        "component-anatomy-unchanged",
+        "state-vocabulary-unchanged",
+        "content-remains-readable-without-decoration",
+    ],
+};
+export const surfaceCardContract = defineGrammarContract("core.surface-card", surfaceCardSpec);
+export const surfaceListCardContract = defineGrammarContract("core.surface-list-card", surfaceListCardSpec);
+export const railContract = defineGrammarContract("core.rail", railSpec);
+export const visualTreatmentContract = defineGrammarContract("core.visual-treatment", visualTreatmentSpec);
+export const CORE_COMPONENT_CONTRACTS = Object.freeze({
+    "core.surface-card": surfaceCardContract,
+    "core.surface-list-card": surfaceListCardContract,
+    "core.rail": railContract,
+    "core.visual-treatment": visualTreatmentContract,
+});
+//# sourceMappingURL=contracts.js.map

package/dist/core/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/core/contracts.ts"],"names":[],"mappings":"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"}

package/dist/core/grammar.d.ts

@@ -0,0 +1,18 @@
+import type { GrammarContract } from "../common/index.js";
+import { CORE_COMPONENT_CONTRACTS } from "./contracts.js";
+import { CORE_RULES } from "./rules.js";
+import { CORE_NEUTRAL_TREATMENTS, PRESENTATION_STATES } from "./state.js";
+export type CoreGrammar = Readonly<{
+    id: "core";
+    version: "1.0.0";
+    extends: ReadonlyArray<string>;
+    presentationStates: typeof PRESENTATION_STATES;
+    treatments: typeof CORE_NEUTRAL_TREATMENTS;
+    contracts: typeof CORE_COMPONENT_CONTRACTS;
+    contractList: ReadonlyArray<GrammarContract>;
+    rules: typeof CORE_RULES;
+    invariants: ReadonlyArray<string>;
+}>;
+/** Business-neutral default Grammar assembled entirely from common-kernel contracts. */
+export declare const coreGrammar: CoreGrammar;
+//# sourceMappingURL=grammar.d.ts.map

package/dist/core/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../../src/core/grammar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EACH,wBAAwB,EAK3B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAEzE,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B,kBAAkB,EAAE,OAAO,mBAAmB,CAAA;IAC9C,UAAU,EAAE,OAAO,uBAAuB,CAAA;IAC1C,SAAS,EAAE,OAAO,wBAAwB,CAAA;IAC1C,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAC5C,KAAK,EAAE,OAAO,UAAU,CAAA;IACxB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACpC,CAAC,CAAA;AAEF,wFAAwF;AACxF,eAAO,MAAM,WAAW,EAAE,WAqBxB,CAAA"}

package/dist/core/grammar.js

@@ -0,0 +1,27 @@
+import { CORE_COMPONENT_CONTRACTS, railContract, surfaceCardContract, surfaceListCardContract, visualTreatmentContract, } from "./contracts.js";
+import { CORE_RULES } from "./rules.js";
+import { CORE_NEUTRAL_TREATMENTS, PRESENTATION_STATES } from "./state.js";
+/** Business-neutral default Grammar assembled entirely from common-kernel contracts. */
+export const coreGrammar = Object.freeze({
+    id: "core",
+    version: "1.0.0",
+    extends: Object.freeze([]),
+    presentationStates: PRESENTATION_STATES,
+    treatments: CORE_NEUTRAL_TREATMENTS,
+    contracts: CORE_COMPONENT_CONTRACTS,
+    contractList: Object.freeze([
+        surfaceCardContract,
+        surfaceListCardContract,
+        railContract,
+        visualTreatmentContract,
+    ]),
+    rules: CORE_RULES,
+    invariants: Object.freeze([
+        "business-neutral",
+        "closed-public-props",
+        "no-caller-class-name",
+        "no-anatomy-changing-extension",
+        "container-owned-responsive-behavior",
+    ]),
+});
+//# sourceMappingURL=grammar.js.map

package/dist/core/grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.js","sourceRoot":"","sources":["../../src/core/grammar.ts"],"names":[],"mappings":"AACA,OAAO,EACH,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,GAC1B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAczE,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAgB,MAAM,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,MAAM;IACV,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1B,kBAAkB,EAAE,mBAAmB;IACvC,UAAU,EAAE,uBAAuB;IACnC,SAAS,EAAE,wBAAwB;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,mBAAmB;QACnB,uBAAuB;QACvB,YAAY;QACZ,uBAAuB;KAC1B,CAAC;IACF,KAAK,EAAE,UAAU;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,kBAAkB;QAClB,qBAAqB;QACrB,sBAAsB;QACtB,+BAA+B;QAC/B,qCAAqC;KACxC,CAAC;CACL,CAAC,CAAA"}

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+export { coreGrammar, type CoreGrammar } from "./grammar.js";
+export { CORE_COMPONENT_CONTRACTS, railContract, surfaceCardContract, surfaceListCardContract, visualTreatmentContract, type CoreComponentContract, type CoreComponentContractId, } from "./contracts.js";
+export { CORE_RULES, type CoreRule } from "./rules.js";
+export { CORE_NEUTRAL_TREATMENTS, PRESENTATION_STATES, assertPresentationState, isPresentationState, treatmentFor, type NeutralTreatment, type PresentationState, } from "./state.js";
+export { SurfaceCard, meta as surfaceCardMeta, type SurfaceCardProps, type WholeCardAction } from "./branch/SurfaceCard/index.js";
+export { SurfaceListCard, meta as surfaceListCardMeta, type SurfaceListCardProps, type SurfaceListItem } from "./branch/SurfaceListCard/index.js";
+export { Rail, meta as railMeta, type RailProps } from "./branch/Rail/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,EACH,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,GAC/B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACzB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAA;AACjI,OAAO,EAAE,eAAe,EAAE,IAAI,IAAI,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACjJ,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,8 @@
+export { coreGrammar } from "./grammar.js";
+export { CORE_COMPONENT_CONTRACTS, railContract, surfaceCardContract, surfaceListCardContract, visualTreatmentContract, } from "./contracts.js";
+export { CORE_RULES } from "./rules.js";
+export { CORE_NEUTRAL_TREATMENTS, PRESENTATION_STATES, assertPresentationState, isPresentationState, treatmentFor, } from "./state.js";
+export { SurfaceCard, meta as surfaceCardMeta } from "./branch/SurfaceCard/index.js";
+export { SurfaceListCard, meta as surfaceListCardMeta } from "./branch/SurfaceListCard/index.js";
+export { Rail, meta as railMeta } from "./branch/Rail/index.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,cAAc,CAAA;AAC5D,OAAO,EACH,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,GAG1B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAA;AACtD,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,GAGf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,eAAe,EAA+C,MAAM,+BAA+B,CAAA;AACjI,OAAO,EAAE,eAAe,EAAE,IAAI,IAAI,mBAAmB,EAAmD,MAAM,mCAAmC,CAAA;AACjJ,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAkB,MAAM,wBAAwB,CAAA"}

package/dist/core/rules.d.ts

@@ -0,0 +1,45 @@
+export type CoreRule = {
+    readonly id: string;
+    readonly concern: "state" | "anatomy" | "layout" | "interaction";
+    readonly when: ReadonlyArray<string>;
+    readonly decide: ReadonlyArray<string>;
+    readonly refuse: ReadonlyArray<string>;
+};
+export declare const CORE_RULES: readonly [{
+    readonly id: "core.anatomy.label-outside-surface";
+    readonly concern: "anatomy";
+    readonly when: readonly ["one optional label names one bounded surface"];
+    readonly decide: readonly ["render the label before and outside the surface shell"];
+    readonly refuse: readonly ["placing the label inside surface padding", "duplicating the label in content"];
+}, {
+    readonly id: "core.anatomy.nested-surface";
+    readonly concern: "anatomy";
+    readonly when: readonly ["one list boundary is nested in a larger surface"];
+    readonly decide: readonly ["retain one border", "remove elevation"];
+    readonly refuse: readonly ["border and shadow together", "a nested shell used only as decoration"];
+}, {
+    readonly id: "core.anatomy.static-list";
+    readonly concern: "anatomy";
+    readonly when: readonly ["zero, one or many static peer statements share one boundary"];
+    readonly decide: readonly ["render one list shell", "separate adjacent rows", "show one check for an affirmative row"];
+    readonly refuse: readonly ["one shell per row", "interactive row behavior", "more than one state mark per row"];
+}, {
+    readonly id: "core.interaction.whole-surface-action";
+    readonly concern: "interaction";
+    readonly when: readonly ["the entire surface has exactly one destination or action"];
+    readonly decide: readonly ["render one transparent control overlay after the content"];
+    readonly refuse: readonly ["nesting controls", "moving the visible content into the control"];
+}, {
+    readonly id: "core.state.neutral-input";
+    readonly concern: "state";
+    readonly when: readonly ["a caller requests generic visual treatment"];
+    readonly decide: readonly ["accept one closed neutral presentation state"];
+    readonly refuse: readonly ["external semantic input", "copy-driven treatment selection"];
+}, {
+    readonly id: "core.layout.container-response";
+    readonly concern: "layout";
+    readonly when: readonly ["a surface or rail loses useful inline space"];
+    readonly decide: readonly ["reflow owned rows within the component container", "disable sticky positioning on a narrow viewport"];
+    readonly refuse: readonly ["content clipping", "hiding the primary body", "caller-authored breakpoint classes"];
+}];
+//# sourceMappingURL=rules.d.ts.map

package/dist/core/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/core/rules.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAA;IAChE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACzC,CAAA;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CqB,CAAA"}

package/dist/core/rules.js

@@ -0,0 +1,45 @@
+export const CORE_RULES = [
+    {
+        id: "core.anatomy.label-outside-surface",
+        concern: "anatomy",
+        when: ["one optional label names one bounded surface"],
+        decide: ["render the label before and outside the surface shell"],
+        refuse: ["placing the label inside surface padding", "duplicating the label in content"],
+    },
+    {
+        id: "core.anatomy.nested-surface",
+        concern: "anatomy",
+        when: ["one list boundary is nested in a larger surface"],
+        decide: ["retain one border", "remove elevation"],
+        refuse: ["border and shadow together", "a nested shell used only as decoration"],
+    },
+    {
+        id: "core.anatomy.static-list",
+        concern: "anatomy",
+        when: ["zero, one or many static peer statements share one boundary"],
+        decide: ["render one list shell", "separate adjacent rows", "show one check for an affirmative row"],
+        refuse: ["one shell per row", "interactive row behavior", "more than one state mark per row"],
+    },
+    {
+        id: "core.interaction.whole-surface-action",
+        concern: "interaction",
+        when: ["the entire surface has exactly one destination or action"],
+        decide: ["render one transparent control overlay after the content"],
+        refuse: ["nesting controls", "moving the visible content into the control"],
+    },
+    {
+        id: "core.state.neutral-input",
+        concern: "state",
+        when: ["a caller requests generic visual treatment"],
+        decide: ["accept one closed neutral presentation state"],
+        refuse: ["external semantic input", "copy-driven treatment selection"],
+    },
+    {
+        id: "core.layout.container-response",
+        concern: "layout",
+        when: ["a surface or rail loses useful inline space"],
+        decide: ["reflow owned rows within the component container", "disable sticky positioning on a narrow viewport"],
+        refuse: ["content clipping", "hiding the primary body", "caller-authored breakpoint classes"],
+    },
+];
+//# sourceMappingURL=rules.js.map

package/dist/core/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/core/rules.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB;QACI,EAAE,EAAE,oCAAoC;QACxC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,CAAC,8CAA8C,CAAC;QACtD,MAAM,EAAE,CAAC,uDAAuD,CAAC;QACjE,MAAM,EAAE,CAAC,0CAA0C,EAAE,kCAAkC,CAAC;KAC3F;IACD;QACI,EAAE,EAAE,6BAA6B;QACjC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,CAAC,iDAAiD,CAAC;QACzD,MAAM,EAAE,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;QACjD,MAAM,EAAE,CAAC,4BAA4B,EAAE,wCAAwC,CAAC;KACnF;IACD;QACI,EAAE,EAAE,0BAA0B;QAC9B,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,CAAC,6DAA6D,CAAC;QACrE,MAAM,EAAE,CAAC,uBAAuB,EAAE,wBAAwB,EAAE,uCAAuC,CAAC;QACpG,MAAM,EAAE,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,kCAAkC,CAAC;KAChG;IACD;QACI,EAAE,EAAE,uCAAuC;QAC3C,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,CAAC,0DAA0D,CAAC;QAClE,MAAM,EAAE,CAAC,0DAA0D,CAAC;QACpE,MAAM,EAAE,CAAC,kBAAkB,EAAE,6CAA6C,CAAC;KAC9E;IACD;QACI,EAAE,EAAE,0BAA0B;QAC9B,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,CAAC,4CAA4C,CAAC;QACpD,MAAM,EAAE,CAAC,8CAA8C,CAAC;QACxD,MAAM,EAAE,CAAC,yBAAyB,EAAE,iCAAiC,CAAC;KACzE;IACD;QACI,EAAE,EAAE,gCAAgC;QACpC,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,CAAC,6CAA6C,CAAC;QACrD,MAAM,EAAE,CAAC,kDAAkD,EAAE,iDAAiD,CAAC;QAC/G,MAAM,EAAE,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,oCAAoC,CAAC;KAChG;CACuC,CAAA"}

package/dist/core/state.d.ts

@@ -0,0 +1,10 @@
+import { type PresentationState } from "../common/index.js";
+export { PRESENTATION_STATES, assertPresentationState, isPresentationState, type PresentationState, } from "../common/index.js";
+export type NeutralTreatment = {
+    readonly state: PresentationState;
+    readonly tone: "quiet" | "positive" | "information" | "warning" | "danger" | "inactive" | "pending";
+    readonly mark: "none" | "check";
+};
+export declare const CORE_NEUTRAL_TREATMENTS: Readonly<Record<PresentationState, NeutralTreatment>>;
+export declare const treatmentFor: (state: PresentationState) => NeutralTreatment;
+//# sourceMappingURL=state.d.ts.map

package/dist/core/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,iBAAiB,EACzB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,iBAAiB,GACzB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IACnG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAClC,CAAA;AAaD,eAAO,MAAM,uBAAuB,EAE9B,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAE3D,eAAO,MAAM,YAAY,GAAI,OAAO,iBAAiB,KAAG,gBAGvD,CAAA"}

package/dist/core/state.js

@@ -0,0 +1,24 @@
+import { PRESENTATION_STATES, assertPresentationState, } from "../common/index.js";
+export { PRESENTATION_STATES, assertPresentationState, isPresentationState, } from "../common/index.js";
+const neutralTreatment = (state) => {
+    const id = String(state);
+    if (id === "affirmative")
+        return { state, tone: "positive", mark: "check" };
+    if (id === "informative")
+        return { state, tone: "information", mark: "none" };
+    if (id === "cautionary")
+        return { state, tone: "warning", mark: "none" };
+    if (id === "negative")
+        return { state, tone: "danger", mark: "none" };
+    if (id === "pending")
+        return { state, tone: "pending", mark: "none" };
+    if (id === "unavailable")
+        return { state, tone: "inactive", mark: "none" };
+    return { state, tone: "quiet", mark: "none" };
+};
+export const CORE_NEUTRAL_TREATMENTS = Object.freeze(Object.fromEntries(PRESENTATION_STATES.map((state) => [state, Object.freeze(neutralTreatment(state))])));
+export const treatmentFor = (state) => {
+    assertPresentationState(state);
+    return CORE_NEUTRAL_TREATMENTS[state];
+};
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mBAAmB,EACnB,uBAAuB,GAE1B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACH,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GAEtB,MAAM,oBAAoB,CAAA;AAQ3B,MAAM,gBAAgB,GAAG,CAAC,KAAwB,EAAoB,EAAE;IACpE,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACxB,IAAI,EAAE,KAAK,aAAa;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAC3E,IAAI,EAAE,KAAK,aAAa;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC7E,IAAI,EAAE,KAAK,YAAY;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACxE,IAAI,EAAE,KAAK,UAAU;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACrE,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACrE,IAAI,EAAE,KAAK,aAAa;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC1E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACjD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CACnE,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CACtF,CAA0D,CAAA;AAE3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAwB,EAAoB,EAAE;IACvE,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAC9B,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAA;AACzC,CAAC,CAAA"}