@starci/grammar 0.3.0 → 0.4.1

package/README.md

@@ -1,44 +1,79 @@
-# `@starci/grammar`
-
-`@starci/grammar` is a business-neutral React component package for StarCi Academy. It wraps
-HeroUI primitives with stable, accessible presentation components and provides the Offset Pop
-visual layer. It contains no application routes, data fetching, domain entities, or product state.
-
-## Public entry points
-
-- `@starci/grammar/common` — presentation-state helpers and shared CSS.
-- `@starci/grammar/core` — `StateMark`, `LeadingNumber`, `StaticStateRow`, `SurfaceCard`,
-  `SurfaceListCard`, `MarkdownArticle`, `SurfaceAccordionCard`, and `Rail`.
-- `@starci/grammar/common/styles.css`, `@starci/grammar/core/styles.css`, and
-  `@starci/grammar/offset-pop/styles.css` — package stylesheets. Short `.css` export aliases are
-  also available.
-
-Install the workspace package while developing locally:
-
-```sh
-npm install ./packages/grammar
-```
-
-Import components from the focused entry point:
-
-```tsx
-import { MarkdownArticle, SurfaceCard } from "@starci/grammar/core"
+# `@starci/grammar`
+
+`@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` — 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 the workspace package while developing locally:
+
+```sh
+npm install ./packages/grammar
+```
+
+Import components from the focused entry point:
+
+```tsx
+import {
+  PageContainer,
+  PrimaryRailLayout,
+  SurfaceCard,
+} from "@starci/grammar/common"
+import { CoreGrammarRoot } from "@starci/grammar/core"
 import "@starci/grammar/core/styles.css"
+
+export const ProductSurface = () => (
+  <CoreGrammarRoot>
+    <PageContainer>
+      <PrimaryRailLayout
+        primary={<SurfaceCard ariaLabel="Main">...</SurfaceCard>}
+        rail={<SurfaceCard ariaLabel="Progress">...</SurfaceCard>}
+      />
+    </PageContainer>
+  </CoreGrammarRoot>
+)
 ```
 
-Core components accept ordinary typed React props and keep their own semantic DOM and accessibility
-behavior. The consuming application remains responsible for translating business data into those
-props. Offset Pop adds visual treatment only; it does not change ownership or business behavior.
-The package deliberately exposes no rule registry, contract metadata, Tree DSL, projection, or
-runtime visual-vocabulary object.
+`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.
 
-## Package checks
-
-```sh
-npm run typecheck
-npm test
-npm pack --dry-run
-```
+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.
 
-The package requires Node.js 20 or newer and has peer dependencies on React 18+ and
-`@heroui/react` 3.2+.
+`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.
+
+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
+
+```sh
+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,6 +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;
+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":"AAAA,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,wGAEtB,CAAA;AACV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBAE7D,CAAA;AACD,eAAO,MAAM,uBAAuB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,iBAE1E,CAAA"}
+{"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,11 +1,6 @@
-/** 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)}`);
-};
+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":"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;AAEV,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAA;AAClE,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;AACD,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"}
+{"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"}

package/dist/common/registry.js

@@ -0,0 +1,34 @@
+"use client";
+import { Badge, Button, ChatWorkspace, Divider, EmptyNotice, FencedCodeBlock, GrammarRoot, Heading, HorizontalScrollRegion, Icon, IconButton, IconTile, IncludedMark, Input, Label, LeadingNumber, MarkdownArticle, MarkdownTableFrame, MediaFrame, NavigationFeatureNav, OtpInput, PageContainer, PrimaryRailLayout, Progress, Rail, RankArtwork, SectionHeader, Sidebar, StateMark, StaticStateRow, Subnav, SurfaceAccordionCard, SurfaceCard, SurfaceCopyGroup, SurfaceListCard, Tabs, Text, TextAction, Tooltip, VerticalScrollRegion, WorkspaceShell, } from "./renderers.js";
+export const COMMON_GRAMMAR_COMPONENTS = Object.freeze({
+    Badge, Button, ChatWorkspace, Divider, EmptyNotice, FencedCodeBlock, GrammarRoot,
+    Heading, HorizontalScrollRegion, Icon, IconButton, IconTile, IncludedMark, Input,
+    Label, LeadingNumber, MarkdownArticle, MarkdownTableFrame, MediaFrame,
+    NavigationFeatureNav, OtpInput, PageContainer, PrimaryRailLayout, Progress, Rail,
+    RankArtwork, SectionHeader, Sidebar, StateMark, StaticStateRow, Subnav,
+    SurfaceAccordionCard, SurfaceCard, SurfaceCopyGroup, SurfaceListCard, Tabs, Text,
+    TextAction, Tooltip, VerticalScrollRegion, WorkspaceShell,
+});
+/** Define one visual family over the stable Common semantic contract. */
+export const defineGrammarFamily = (definition) => {
+    if (definition.styles.scope.value !== definition.id) {
+        throw new TypeError("Grammar family CSS scope must match the family id");
+    }
+    for (const name of Object.keys(definition.components.replacements)) {
+        if (!(name in COMMON_GRAMMAR_COMPONENTS))
+            throw new TypeError(`Cannot replace unknown Common component: ${name}`);
+    }
+    for (const name of Object.keys(definition.components.extensions)) {
+        if (name in COMMON_GRAMMAR_COMPONENTS)
+            throw new TypeError(`Grammar extension collides with Common component: ${name}`);
+    }
+    const mergedComponents = {};
+    Object.assign(mergedComponents, COMMON_GRAMMAR_COMPONENTS, definition.components.replacements, definition.components.extensions);
+    return Object.freeze({
+        id: definition.id,
+        styles: Object.freeze({ entrypoint: definition.styles.entrypoint, scope: Object.freeze({ ...definition.styles.scope }) }),
+        components: Object.freeze(mergedComponents),
+        scopeProps: Object.freeze({ "data-grammar-family": definition.id }),
+    });
+};
+//# sourceMappingURL=registry.js.map

package/dist/common/registry.js.map

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

package/dist/common/renderers.d.ts

@@ -0,0 +1,41 @@
+export { GrammarRoot, type GrammarRootProps } from "../core/primitive/GrammarRoot/index.js";
+export { PageContainer, type PageContainerProps } from "../core/primitive/PageContainer/index.js";
+export { Badge, type BadgeProps, type BadgeTone } from "../core/primitive/Badge/index.js";
+export { Button, type ButtonProps, type ButtonSize, type ButtonType, type ButtonVariant } from "../core/primitive/Button/index.js";
+export { Divider, type DividerProps } from "../core/primitive/Divider/index.js";
+export { Heading, type HeadingLevel, type HeadingProps, type HeadingScale } from "../core/primitive/Heading/index.js";
+export { Icon, type IconProps, type IconUsage, type IconSource, type IconSourceProps } from "../core/primitive/Icon/index.js";
+export { IconTile, type IconTileProps, type IconTileSize, type IconTileTone } from "../core/primitive/IconTile/index.js";
+export { IconButton, type IconButtonProps } from "../core/primitive/IconButton/index.js";
+export { Label, type LabelProps } from "../core/primitive/Label/index.js";
+export { Input, type InputKind, type InputProps, type InputVariant } from "../core/primitive/Input/index.js";
+export { Progress, type ProgressProps } from "../core/primitive/Progress/index.js";
+export { Text, type TextAs, type TextLive, type TextProps, type TextSize, type TextTone, type TextWeight } from "../core/primitive/Text/index.js";
+export { TextAction, type TextActionAppearance, type TextActionProps, type TextActionSize } from "../core/primitive/TextAction/index.js";
+export { SectionHeader, type SectionHeaderProps } from "../core/primitive/SectionHeader/index.js";
+export { MediaFrame, type MediaFrameProps } from "../core/primitive/MediaFrame/index.js";
+export { IncludedMark, type IncludedMarkProps } from "../core/primitive/IncludedMark/index.js";
+export { RankArtwork, type RankArtworkKind, type RankArtworkProps } from "../core/primitive/RankArtwork/index.js";
+export { SurfaceCopyGroup, type SurfaceCopyGroupProps } from "../core/primitive/SurfaceCopyGroup/index.js";
+export { PrimaryRailLayout, type PrimaryRailLayoutProps } from "../core/composition/PrimaryRailLayout/index.js";
+export { NavigationFeatureNav, type NavigationFeatureNavProps } from "../core/composition/NavigationFeatureNav/index.js";
+export { Sidebar, type SidebarGroup, type SidebarItem, type SidebarProps } from "../core/composition/Sidebar/index.js";
+export { WorkspaceShell, type WorkspaceShellProps } from "../core/composition/WorkspaceShell/index.js";
+export { ChatWorkspace, type ChatWorkspaceProps } from "../core/composition/ChatWorkspace/index.js";
+export { StateMark, type StateMarkProps } from "../core/StateMark.js";
+export { LeadingNumber, type LeadingNumberProps } from "../core/LeadingNumber.js";
+export { OtpInput, type OtpInputProps } from "../core/OtpInput.js";
+export { StaticStateRow, type StaticStateRowData, type StaticStateRowProps } from "../core/composite/StaticStateRow/index.js";
+export { EmptyNotice, type EmptyNoticeProps } from "../core/composite/EmptyNotice/index.js";
+export { HorizontalScrollRegion, type HorizontalScrollRegionProps } from "../core/composite/HorizontalScrollRegion/index.js";
+export { VerticalScrollRegion, type VerticalScrollRegionProps } from "../core/composite/VerticalScrollRegion/index.js";
+export { SurfaceCard, type SurfaceCardProps, type WholeCardAction } from "../core/branch/SurfaceCard/index.js";
+export { SurfaceListCard, type SurfaceListCardProps } from "../core/branch/SurfaceListCard/index.js";
+export { FencedCodeBlock, MarkdownArticle, MarkdownTableFrame, type FencedCodeBlockProps, type MarkdownArticleProps, type MarkdownTableFrameProps } from "../core/branch/MarkdownArticle/index.js";
+export { SurfaceAccordionCard, type SurfaceAccordionCardItem, type SurfaceAccordionCardProps } from "../core/branch/SurfaceAccordionCard/index.js";
+export { Rail, type RailProps } from "../core/branch/Rail/index.js";
+export { Subnav, type SubnavProps } from "../core/branch/Subnav/index.js";
+export { Tabs, type TabItem, type TabsProps } from "../core/branch/Tabs/index.js";
+export { Tooltip, type TooltipPlacement, type TooltipProps } from "../core/branch/Tooltip/index.js";
+export { formCompactSurfaceClassName, formFieldClassName, formPageClassName, formScreenReaderLabelClassName, formScrollViewportClassName, formSurfaceClassName, horizontalScrollRegionClassName } from "../core/classNames.js";
+//# sourceMappingURL=renderers.d.ts.map

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

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

package/dist/common/renderers.js

@@ -0,0 +1,44 @@
+// Common is the public semantic/props authority. Physical renderer paths remain
+// internal compatibility storage until the package can move them without a
+// breaking source-layout migration.
+export { GrammarRoot } from "../core/primitive/GrammarRoot/index.js";
+export { PageContainer } from "../core/primitive/PageContainer/index.js";
+export { Badge } from "../core/primitive/Badge/index.js";
+export { Button } from "../core/primitive/Button/index.js";
+export { Divider } from "../core/primitive/Divider/index.js";
+export { Heading } from "../core/primitive/Heading/index.js";
+export { Icon } from "../core/primitive/Icon/index.js";
+export { IconTile } from "../core/primitive/IconTile/index.js";
+export { IconButton } from "../core/primitive/IconButton/index.js";
+export { Label } from "../core/primitive/Label/index.js";
+export { Input } from "../core/primitive/Input/index.js";
+export { Progress } from "../core/primitive/Progress/index.js";
+export { Text } from "../core/primitive/Text/index.js";
+export { TextAction } from "../core/primitive/TextAction/index.js";
+export { SectionHeader } from "../core/primitive/SectionHeader/index.js";
+export { MediaFrame } from "../core/primitive/MediaFrame/index.js";
+export { IncludedMark } from "../core/primitive/IncludedMark/index.js";
+export { RankArtwork } from "../core/primitive/RankArtwork/index.js";
+export { SurfaceCopyGroup } from "../core/primitive/SurfaceCopyGroup/index.js";
+export { PrimaryRailLayout } from "../core/composition/PrimaryRailLayout/index.js";
+export { NavigationFeatureNav } from "../core/composition/NavigationFeatureNav/index.js";
+export { Sidebar } from "../core/composition/Sidebar/index.js";
+export { WorkspaceShell } from "../core/composition/WorkspaceShell/index.js";
+export { ChatWorkspace } from "../core/composition/ChatWorkspace/index.js";
+export { StateMark } from "../core/StateMark.js";
+export { LeadingNumber } from "../core/LeadingNumber.js";
+export { OtpInput } from "../core/OtpInput.js";
+export { StaticStateRow } from "../core/composite/StaticStateRow/index.js";
+export { EmptyNotice } from "../core/composite/EmptyNotice/index.js";
+export { HorizontalScrollRegion } from "../core/composite/HorizontalScrollRegion/index.js";
+export { VerticalScrollRegion } from "../core/composite/VerticalScrollRegion/index.js";
+export { SurfaceCard } from "../core/branch/SurfaceCard/index.js";
+export { SurfaceListCard } from "../core/branch/SurfaceListCard/index.js";
+export { FencedCodeBlock, MarkdownArticle, MarkdownTableFrame } from "../core/branch/MarkdownArticle/index.js";
+export { SurfaceAccordionCard } from "../core/branch/SurfaceAccordionCard/index.js";
+export { Rail } from "../core/branch/Rail/index.js";
+export { Subnav } from "../core/branch/Subnav/index.js";
+export { Tabs } from "../core/branch/Tabs/index.js";
+export { Tooltip } from "../core/branch/Tooltip/index.js";
+export { formCompactSurfaceClassName, formFieldClassName, formPageClassName, formScreenReaderLabelClassName, formScrollViewportClassName, formSurfaceClassName, horizontalScrollRegionClassName } from "../core/classNames.js";
+//# sourceMappingURL=renderers.js.map

package/dist/common/renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.js","sourceRoot":"","sources":["../../src/common/renderers.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,oCAAoC;AACpC,OAAO,EAAE,WAAW,EAAyB,MAAM,wCAAwC,CAAA;AAC3F,OAAO,EAAE,aAAa,EAA2B,MAAM,0CAA0C,CAAA;AACjG,OAAO,EAAE,KAAK,EAAmC,MAAM,kCAAkC,CAAA;AACzF,OAAO,EAAE,MAAM,EAA0E,MAAM,mCAAmC,CAAA;AAClI,OAAO,EAAE,OAAO,EAAqB,MAAM,oCAAoC,CAAA;AAC/E,OAAO,EAAE,OAAO,EAA2D,MAAM,oCAAoC,CAAA;AACrH,OAAO,EAAE,IAAI,EAAyE,MAAM,iCAAiC,CAAA;AAC7H,OAAO,EAAE,QAAQ,EAA4D,MAAM,qCAAqC,CAAA;AACxH,OAAO,EAAE,UAAU,EAAwB,MAAM,uCAAuC,CAAA;AACxF,OAAO,EAAE,KAAK,EAAmB,MAAM,kCAAkC,CAAA;AACzE,OAAO,EAAE,KAAK,EAAsD,MAAM,kCAAkC,CAAA;AAC5G,OAAO,EAAE,QAAQ,EAAsB,MAAM,qCAAqC,CAAA;AAClF,OAAO,EAAE,IAAI,EAA6F,MAAM,iCAAiC,CAAA;AACjJ,OAAO,EAAE,UAAU,EAAwE,MAAM,uCAAuC,CAAA;AACxI,OAAO,EAAE,aAAa,EAA2B,MAAM,0CAA0C,CAAA;AACjG,OAAO,EAAE,UAAU,EAAwB,MAAM,uCAAuC,CAAA;AACxF,OAAO,EAAE,YAAY,EAA0B,MAAM,yCAAyC,CAAA;AAC9F,OAAO,EAAE,WAAW,EAA+C,MAAM,wCAAwC,CAAA;AACjH,OAAO,EAAE,gBAAgB,EAA8B,MAAM,6CAA6C,CAAA;AAC1G,OAAO,EAAE,iBAAiB,EAA+B,MAAM,gDAAgD,CAAA;AAC/G,OAAO,EAAE,oBAAoB,EAAkC,MAAM,mDAAmD,CAAA;AACxH,OAAO,EAAE,OAAO,EAA0D,MAAM,sCAAsC,CAAA;AACtH,OAAO,EAAE,cAAc,EAA4B,MAAM,6CAA6C,CAAA;AACtG,OAAO,EAAE,aAAa,EAA2B,MAAM,4CAA4C,CAAA;AACnG,OAAO,EAAE,SAAS,EAAuB,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAAE,aAAa,EAA2B,MAAM,0BAA0B,CAAA;AACjF,OAAO,EAAE,QAAQ,EAAsB,MAAM,qBAAqB,CAAA;AAClE,OAAO,EAAE,cAAc,EAAqD,MAAM,2CAA2C,CAAA;AAC7H,OAAO,EAAE,WAAW,EAAyB,MAAM,wCAAwC,CAAA;AAC3F,OAAO,EAAE,sBAAsB,EAAoC,MAAM,mDAAmD,CAAA;AAC5H,OAAO,EAAE,oBAAoB,EAAkC,MAAM,iDAAiD,CAAA;AACtH,OAAO,EAAE,WAAW,EAA+C,MAAM,qCAAqC,CAAA;AAC9G,OAAO,EAAE,eAAe,EAA6B,MAAM,yCAAyC,CAAA;AACpG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAsF,MAAM,yCAAyC,CAAA;AAClM,OAAO,EAAE,oBAAoB,EAAiE,MAAM,8CAA8C,CAAA;AAClJ,OAAO,EAAE,IAAI,EAAkB,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,MAAM,EAAoB,MAAM,gCAAgC,CAAA;AACzE,OAAO,EAAE,IAAI,EAAgC,MAAM,8BAA8B,CAAA;AACjF,OAAO,EAAE,OAAO,EAA4C,MAAM,iCAAiC,CAAA;AACnG,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/common/rule-catalog.generated.d.ts

@@ -0,0 +1,40 @@
+/** How many rule ids each family publishes. Reported for coverage summaries, never expanded. */
+export declare const RULE_FAMILY_COUNTS: Readonly<{
+    readonly A11Y: 4;
+    readonly ACCENT: 5;
+    readonly ACTION: 4;
+    readonly BOUNDARY: 6;
+    readonly COLOR: 2;
+    readonly "CONTROL-STATE": 4;
+    readonly "CORE-BOUNDARY": 5;
+    readonly "CORE-SURFACE": 5;
+    readonly CTA: 5;
+    readonly FEEDBACK: 4;
+    readonly FIELD: 4;
+    readonly FLOW: 5;
+    readonly FOCUS: 5;
+    readonly FONT: 6;
+    readonly GAP: 7;
+    readonly HIERARCHY: 5;
+    readonly ICON: 6;
+    readonly LAYOUT: 5;
+    readonly MARGIN: 7;
+    readonly MEASURE: 7;
+    readonly MEDIA: 6;
+    readonly MOTION: 4;
+    readonly OVERFLOW: 5;
+    readonly PADDING: 9;
+    readonly RESPONSIVE: 5;
+    readonly STATE: 7;
+    readonly SURFACE: 6;
+    readonly TONE: 3;
+    readonly TRUTH: 4;
+}>;
+/**
+ * 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 declare const CANONICAL_RULE_IDS: ReadonlyArray<string>;
+//# sourceMappingURL=rule-catalog.generated.d.ts.map

package/dist/common/rule-catalog.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-catalog.generated.d.ts","sourceRoot":"","sources":["../../src/common/rule-catalog.generated.ts"],"names":[],"mappings":"AAWA,gGAAgG;AAChG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BpB,CAAA;AAEX;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAoLnD,CAAA"}