@starci/grammar 0.3.0 → 0.4.1

package/dist/common/rule-catalog.generated.js

@@ -0,0 +1,230 @@
+/*
+ * GENERATED FILE - do not edit by hand.
+ *
+ * Regenerate with `node scripts/generate-rule-catalog.mjs [knowledgeDir]` from the package root.
+ * The source of truth is the knowledge tree's `ui/composition`, `ui/presentation`, `ui/proof`
+ * and `grammars/starci` topic files; a family that publishes no `PREFIX-n` heading contributes
+ * no rules and therefore does not appear here.
+ *
+ * 29 families, 150 rules.
+ */
+/** How many rule ids each family publishes. Reported for coverage summaries, never expanded. */
+export const RULE_FAMILY_COUNTS = Object.freeze({
+    "A11Y": 4, // ui/proof/accessibility.md
+    "ACCENT": 5, // ui/composition/accent.md
+    "ACTION": 4, // ui/composition/action.md
+    "BOUNDARY": 6, // ui/presentation/boundary.md
+    "COLOR": 2, // ui/proof/contrast.md
+    "CONTROL-STATE": 4, // grammars/starci/control-state.md
+    "CORE-BOUNDARY": 5, // grammars/starci/boundary.md
+    "CORE-SURFACE": 5, // grammars/starci/surface.md
+    "CTA": 5, // ui/composition/cta.md
+    "FEEDBACK": 4, // ui/composition/feedback.md
+    "FIELD": 4, // grammars/starci/field.md
+    "FLOW": 5, // ui/presentation/text-flow.md
+    "FOCUS": 5, // ui/proof/focus.md
+    "FONT": 6, // ui/presentation/font.md
+    "GAP": 7, // ui/presentation/gap.md
+    "HIERARCHY": 5, // ui/composition/hierarchy.md
+    "ICON": 6, // grammars/starci/icon.md
+    "LAYOUT": 5, // ui/composition/layout.md
+    "MARGIN": 7, // ui/presentation/margin.md
+    "MEASURE": 7, // ui/presentation/measure.md
+    "MEDIA": 6, // grammars/starci/media.md
+    "MOTION": 4, // ui/proof/motion.md
+    "OVERFLOW": 5, // ui/presentation/overflow.md
+    "PADDING": 9, // ui/presentation/padding.md
+    "RESPONSIVE": 5, // ui/composition/responsive.md
+    "STATE": 7, // ui/composition/state.md
+    "SURFACE": 6, // ui/presentation/surface.md
+    "TONE": 3, // ui/presentation/tone.md
+    "TRUTH": 4, // ui/proof/render-truth.md
+});
+/**
+ * Every canonical rule id, exactly as the tree spells it.
+ *
+ * The ids are listed rather than expanded from the counts above: the spacing families start at
+ * `-0`, so a `1..count` expansion would both invent `PADDING-9` and lose `PADDING-0`.
+ */
+export const CANONICAL_RULE_IDS = Object.freeze([
+    // A11Y
+    "A11Y-1",
+    "A11Y-2",
+    "A11Y-3",
+    "A11Y-4",
+    // ACCENT
+    "ACCENT-1",
+    "ACCENT-2",
+    "ACCENT-3",
+    "ACCENT-4",
+    "ACCENT-5",
+    // ACTION
+    "ACTION-1",
+    "ACTION-2",
+    "ACTION-3",
+    "ACTION-4",
+    // BOUNDARY
+    "BOUNDARY-1",
+    "BOUNDARY-2",
+    "BOUNDARY-3",
+    "BOUNDARY-4",
+    "BOUNDARY-5",
+    "BOUNDARY-6",
+    // COLOR
+    "COLOR-3",
+    "COLOR-5",
+    // CONTROL-STATE
+    "CONTROL-STATE-1",
+    "CONTROL-STATE-2",
+    "CONTROL-STATE-3",
+    "CONTROL-STATE-4",
+    // CORE-BOUNDARY
+    "CORE-BOUNDARY-1",
+    "CORE-BOUNDARY-2",
+    "CORE-BOUNDARY-3",
+    "CORE-BOUNDARY-4",
+    "CORE-BOUNDARY-5",
+    // CORE-SURFACE
+    "CORE-SURFACE-1",
+    "CORE-SURFACE-2",
+    "CORE-SURFACE-3",
+    "CORE-SURFACE-4",
+    "CORE-SURFACE-5",
+    // CTA
+    "CTA-1",
+    "CTA-2",
+    "CTA-3",
+    "CTA-4",
+    "CTA-5",
+    // FEEDBACK
+    "FEEDBACK-1",
+    "FEEDBACK-2",
+    "FEEDBACK-3",
+    "FEEDBACK-4",
+    // FIELD
+    "FIELD-1",
+    "FIELD-2",
+    "FIELD-3",
+    "FIELD-4",
+    // FLOW
+    "FLOW-1",
+    "FLOW-2",
+    "FLOW-3",
+    "FLOW-4",
+    "FLOW-5",
+    // FOCUS
+    "FOCUS-1",
+    "FOCUS-2",
+    "FOCUS-3",
+    "FOCUS-4",
+    "FOCUS-5",
+    // FONT
+    "FONT-1",
+    "FONT-2",
+    "FONT-3",
+    "FONT-4",
+    "FONT-5",
+    "FONT-6",
+    // GAP
+    "GAP-0",
+    "GAP-1",
+    "GAP-2",
+    "GAP-3",
+    "GAP-4",
+    "GAP-5",
+    "GAP-6",
+    // HIERARCHY
+    "HIERARCHY-1",
+    "HIERARCHY-2",
+    "HIERARCHY-3",
+    "HIERARCHY-4",
+    "HIERARCHY-5",
+    // ICON
+    "ICON-1",
+    "ICON-2",
+    "ICON-3",
+    "ICON-4",
+    "ICON-5",
+    "ICON-6",
+    // LAYOUT
+    "LAYOUT-1",
+    "LAYOUT-2",
+    "LAYOUT-3",
+    "LAYOUT-4",
+    "LAYOUT-5",
+    // MARGIN
+    "MARGIN-0",
+    "MARGIN-1",
+    "MARGIN-2",
+    "MARGIN-3",
+    "MARGIN-4",
+    "MARGIN-5",
+    "MARGIN-6",
+    // MEASURE
+    "MEASURE-1",
+    "MEASURE-2",
+    "MEASURE-3",
+    "MEASURE-4",
+    "MEASURE-5",
+    "MEASURE-6",
+    "MEASURE-7",
+    // MEDIA
+    "MEDIA-1",
+    "MEDIA-2",
+    "MEDIA-3",
+    "MEDIA-4",
+    "MEDIA-5",
+    "MEDIA-6",
+    // MOTION
+    "MOTION-1",
+    "MOTION-2",
+    "MOTION-3",
+    "MOTION-4",
+    // OVERFLOW
+    "OVERFLOW-1",
+    "OVERFLOW-2",
+    "OVERFLOW-3",
+    "OVERFLOW-4",
+    "OVERFLOW-5",
+    // PADDING
+    "PADDING-0",
+    "PADDING-1",
+    "PADDING-2",
+    "PADDING-3",
+    "PADDING-4",
+    "PADDING-5",
+    "PADDING-6",
+    "PADDING-7",
+    "PADDING-8",
+    // RESPONSIVE
+    "RESPONSIVE-1",
+    "RESPONSIVE-2",
+    "RESPONSIVE-3",
+    "RESPONSIVE-4",
+    "RESPONSIVE-5",
+    // STATE
+    "STATE-1",
+    "STATE-2",
+    "STATE-3",
+    "STATE-4",
+    "STATE-5",
+    "STATE-6",
+    "STATE-7",
+    // SURFACE
+    "SURFACE-1",
+    "SURFACE-2",
+    "SURFACE-3",
+    "SURFACE-4",
+    "SURFACE-5",
+    "SURFACE-6",
+    // TONE
+    "TONE-1",
+    "TONE-2",
+    "TONE-3",
+    // TRUTH
+    "TRUTH-1",
+    "TRUTH-2",
+    "TRUTH-3",
+    "TRUTH-4",
+]);
+//# sourceMappingURL=rule-catalog.generated.js.map

package/dist/common/rule-catalog.generated.js.map

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

package/dist/common/spacing.d.ts

@@ -0,0 +1,20 @@
+/** Universal spacing vocabulary consumed by every visual family. */
+export declare const COMMON_SPACING_SCALE: Readonly<{
+    readonly 0: "0";
+    readonly 1: "0.25rem";
+    readonly 2: "0.5rem";
+    readonly 3: "0.75rem";
+    readonly 4: "1rem";
+    readonly 6: "1.5rem";
+    readonly 8: "2rem";
+}>;
+export type CommonSpacingStep = keyof typeof COMMON_SPACING_SCALE;
+export type CommonSpacingValue = (typeof COMMON_SPACING_SCALE)[CommonSpacingStep];
+export declare const COMMON_SPACING_TOKENS: Readonly<{
+    readonly inline: "--grammar-inline-gap";
+    readonly row: "--grammar-row-gap";
+    readonly section: "--grammar-section-gap";
+    readonly region: "--grammar-region-gap";
+    readonly pageInset: "--grammar-page-inset";
+}>;
+//# sourceMappingURL=spacing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../src/common/spacing.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,oBAAoB;;;;;;;;EAQtB,CAAA;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAA;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,iBAAiB,CAAC,CAAA;AAEjF,eAAO,MAAM,qBAAqB;;;;;;EAMvB,CAAA"}

package/dist/common/spacing.js

@@ -0,0 +1,18 @@
+/** Universal spacing vocabulary consumed by every visual family. */
+export const COMMON_SPACING_SCALE = Object.freeze({
+    0: "0",
+    1: "0.25rem",
+    2: "0.5rem",
+    3: "0.75rem",
+    4: "1rem",
+    6: "1.5rem",
+    8: "2rem",
+});
+export const COMMON_SPACING_TOKENS = Object.freeze({
+    inline: "--grammar-inline-gap",
+    row: "--grammar-row-gap",
+    section: "--grammar-section-gap",
+    region: "--grammar-region-gap",
+    pageInset: "--grammar-page-inset",
+});
+//# sourceMappingURL=spacing.js.map

package/dist/common/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","sourceRoot":"","sources":["../../src/common/spacing.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,MAAM;CACH,CAAC,CAAA;AAKX,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,sBAAsB;IAC9B,GAAG,EAAE,mBAAmB;IACxB,OAAO,EAAE,uBAAuB;IAChC,MAAM,EAAE,sBAAsB;IAC9B,SAAS,EAAE,sBAAsB;CAC3B,CAAC,CAAA"}

package/dist/common/state.d.ts

@@ -0,0 +1,6 @@
+/** Render-neutral presentation states shared by Grammar components. */
+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;
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/common/state.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,wGAEtB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAIpE,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBAE7D,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,iBAE1E,CAAA"}

package/dist/common/state.js

@@ -0,0 +1,11 @@
+/** Render-neutral presentation states shared by Grammar components. */
+export const PRESENTATION_STATES = [
+    "neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable",
+];
+const stateSet = new Set(PRESENTATION_STATES);
+export const isPresentationState = (value) => (typeof value === "string" && stateSet.has(value));
+export const assertPresentationState = (value) => {
+    if (!isPresentationState(value))
+        throw new TypeError(`Unknown presentation state: ${JSON.stringify(value)}`);
+};
+//# sourceMappingURL=state.js.map

package/dist/common/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/common/state.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa;CACrF,CAAA;AAIV,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAA;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAA8B,EAAE,CAAC,CAC/E,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CACnD,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAA2D,CAAC,KAAK,EAAE,EAAE;IACrG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAChH,CAAC,CAAA"}