@starci/grammar 0.1.0 → 0.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 StarCi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 StarCi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,37 +1,36 @@
 # `@starci/grammar`
 
-Business-neutral UI contracts and versioned StarCi Grammar bundles.
+`@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` — contract kernel and runtime validation.
-- `@starci/grammar/core` — generic StarCi owners 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` — 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 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.1.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 { MarkdownArticle, SurfaceCard } 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.
-
-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.
+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.
 
 ## Package checks
 
@@ -40,3 +39,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/index.d.ts

@@ -1,74 +1,6 @@
-/** Render-neutral states accepted by Grammar contracts. Product Blocks own every domain mapping. */
+/** 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;
-/** 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>;
 //# 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,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"}

package/dist/common/index.js

@@ -1,203 +1,11 @@
-/** Render-neutral states accepted by Grammar contracts. Product Blocks own every domain mapping. */
+/** Render-neutral presentation states shared by Grammar components. */
 export const PRESENTATION_STATES = [
-    "neutral",
-    "informative",
-    "affirmative",
-    "cautionary",
-    "negative",
-    "pending",
-    "unavailable",
+    "neutral", "informative", "affirmative", "cautionary", "negative", "pending", "unavailable",
 ];
-const presentationStateSet = new Set(PRESENTATION_STATES);
-export const isPresentationState = (value) => (typeof value === "string" && presentationStateSet.has(value));
+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 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())),
-    });
+        throw new TypeError(`Unknown presentation state: ${JSON.stringify(value)}`);
 };
 //# 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,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"}

package/dist/common/styles.css

@@ -1,2 +1,2 @@
-/* Establish one deterministic cascade without owning product colour or business meaning. */
-@layer starci-grammar-common, starci-grammar-core, starci-grammar-extension;
+/* Establish one deterministic cascade without owning product colour or business meaning. */
+@layer starci-grammar-common, starci-grammar-core, starci-grammar-extension;

package/dist/core/LeadingNumber.d.ts

@@ -0,0 +1,12 @@
+export type LeadingNumberProps = {
+    /** One-based position of the item inside its authored sequence. */
+    readonly position: number;
+};
+/**
+ * Product-neutral ordinal prefix for readable ordered rows.
+ *
+ * The punctuation and treatment are intentionally closed: an ordinal prefix is
+ * quiet reading structure (`1.`), never a badge, chip, status, or decoration.
+ */
+export declare const LeadingNumber: (props: LeadingNumberProps) => import("react").JSX.Element;
+//# sourceMappingURL=LeadingNumber.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LeadingNumber.d.ts","sourceRoot":"","sources":["../../src/core/LeadingNumber.tsx"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC5B,CAAA;AAID;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,kBAAkB,gCAMtD,CAAA"}

package/dist/core/LeadingNumber.js

@@ -0,0 +1,10 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { leadingNumberClassName } from "./classNames.js";
+/**
+ * Product-neutral ordinal prefix for readable ordered rows.
+ *
+ * The punctuation and treatment are intentionally closed: an ordinal prefix is
+ * quiet reading structure (`1.`), never a badge, chip, status, or decoration.
+ */
+export const LeadingNumber = (props) => (_jsxs("span", { className: leadingNumberClassName, children: [props.position, "."] }));
+//# sourceMappingURL=LeadingNumber.js.map

package/dist/core/LeadingNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeadingNumber.js","sourceRoot":"","sources":["../../src/core/LeadingNumber.tsx"],"names":[],"mappings":";AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAE,EAAE,CAAC,CACxD,gBACI,SAAS,EAAE,sBAAsB,aAEhC,KAAK,CAAC,QAAQ,SACZ,CACV,CAAA"}

package/dist/core/OtpInput.d.ts

@@ -0,0 +1,12 @@
+export type OtpInputProps = {
+    readonly id: string;
+    readonly name: string;
+    readonly defaultValue?: string;
+    readonly disabled?: boolean;
+    readonly invalid?: boolean;
+    readonly describedBy?: string;
+    readonly onChange?: (value: string) => void;
+};
+/** Own the conventional six-digit OTP control and its intrinsic-width overflow treatment. */
+export declare const OtpInput: (props: OtpInputProps) => import("react").JSX.Element;
+//# sourceMappingURL=OtpInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OtpInput.d.ts","sourceRoot":"","sources":["../../src/core/OtpInput.tsx"],"names":[],"mappings":"AAKA,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9C,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,QAAQ,GAAI,OAAO,aAAa,gCAqC5C,CAAA"}

package/dist/core/OtpInput.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useRef } from "react";
+import { InputOTP, REGEXP_ONLY_DIGITS } from "@heroui/react";
+import { horizontalScrollRegionClassName } from "./classNames.js";
+import { HorizontalScrollRegion } from "./composite/HorizontalScrollRegion/index.js";
+/** Own the conventional six-digit OTP control and its intrinsic-width overflow treatment. */
+export const OtpInput = (props) => {
+    const regionRef = useRef(null);
+    const onChange = useCallback((nextValue) => {
+        props.onChange?.(nextValue);
+        window.requestAnimationFrame(() => {
+            const slots = regionRef.current?.querySelectorAll("[data-slot='input-otp-slot']");
+            if (!slots?.length)
+                return;
+            const activeIndex = Math.min(nextValue.length, slots.length - 1);
+            slots.item(activeIndex).scrollIntoView({ block: "nearest", inline: "nearest" });
+        });
+    }, [props.onChange]);
+    return (_jsx(HorizontalScrollRegion, { ref: regionRef, className: horizontalScrollRegionClassName, children: _jsx(InputOTP, { id: props.id, name: props.name, maxLength: 6, pattern: REGEXP_ONLY_DIGITS, autoComplete: "one-time-code", inputMode: "numeric", defaultValue: props.defaultValue, isDisabled: props.disabled === true, isInvalid: props.invalid === true, "aria-invalid": props.invalid === true ? true : undefined, "aria-describedby": props.describedBy, variant: "secondary", onChange: onChange, children: _jsx(InputOTP.Group, { children: Array.from({ length: 6 }, (_, index) => (_jsx(InputOTP.Slot, { index: index }, index))) }) }) }));
+};
+//# sourceMappingURL=OtpInput.js.map

package/dist/core/OtpInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtpInput.js","sourceRoot":"","sources":["../../src/core/OtpInput.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAA;AAYpF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAoB,EAAE,EAAE;IAC7C,MAAM,SAAS,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAA;IAC9C,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,SAAiB,EAAE,EAAE;QAC/C,KAAK,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAA;QAC3B,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE;YAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAc,8BAA8B,CAAC,CAAA;YAC9F,IAAI,CAAC,KAAK,EAAE,MAAM;gBAAE,OAAM;YAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YAChE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QACnF,CAAC,CAAC,CAAA;IACN,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEpB,OAAO,CACH,KAAC,sBAAsB,IAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,+BAA+B,YAC9E,KAAC,QAAQ,IACL,EAAE,EAAE,KAAK,CAAC,EAAE,EACZ,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAC,eAAe,EAC5B,SAAS,EAAC,SAAS,EACnB,YAAY,EAAE,KAAK,CAAC,YAAY,EAChC,UAAU,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,EACnC,SAAS,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI,kBACnB,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,sBACrC,KAAK,CAAC,WAAW,EACnC,OAAO,EAAC,WAAW,EACnB,QAAQ,EAAE,QAAQ,YAElB,KAAC,QAAQ,CAAC,KAAK,cACV,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CACrC,KAAC,QAAQ,CAAC,IAAI,IAAa,KAAK,EAAE,KAAK,IAAnB,KAAK,CAAkB,CAC9C,CAAC,GACW,GACV,GACU,CAC5B,CAAA;AACL,CAAC,CAAA"}

package/dist/core/StateMark.d.ts

@@ -1,6 +1,8 @@
 import type { PresentationState } from "./state.js";
+/** Props for the neutral state mark. */
 export type StateMarkProps = {
     readonly state: PresentationState;
 };
-export declare const StateMark: ({ state }: StateMarkProps) => import("react").JSX.Element | null;
+/** Draw the check mark used by successful neutral states. */
+export declare const StateMark: (props: StateMarkProps) => import("react").JSX.Element | null;
 //# sourceMappingURL=StateMark.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StateMark.d.ts","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAGnD,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CACpC,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,WAAW,cAAc,uCAclD,CAAA"}
+{"version":3,"file":"StateMark.d.ts","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAGnD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CACpC,CAAA;AAED,6DAA6D;AAC7D,eAAO,MAAM,SAAS,GAAI,OAAO,cAAc,uCAc9C,CAAA"}

package/dist/core/StateMark.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { treatmentFor } from "./state.js";
-export const StateMark = ({ state }) => {
-    const treatment = treatmentFor(state);
+/** Draw the check mark used by successful neutral states. */
+export const StateMark = (props) => {
+    const treatment = treatmentFor(props.state);
     if (treatment.mark !== "check")
         return null;
     return (_jsx("svg", { "aria-hidden": "true", "data-grammar-state-mark": "check", focusable: "false", viewBox: "0 0 20 20", children: _jsx("path", { d: "M5 10.5 8.25 14 15 6.5", fill: "none", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "2" }) }));

package/dist/core/StateMark.js.map

@@ -1 +1 @@
-{"version":3,"file":"StateMark.js","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAMzC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,EAAkB,EAAE,EAAE;IACnD,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IAE3C,OAAO,CACH,6BACgB,MAAM,6BACM,OAAO,EAC/B,SAAS,EAAC,OAAO,EACjB,OAAO,EAAC,WAAW,YAEnB,eAAM,CAAC,EAAC,wBAAwB,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,cAAc,EAAC,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,WAAW,EAAC,GAAG,GAAG,GAChI,CACT,CAAA;AACL,CAAC,CAAA"}
+{"version":3,"file":"StateMark.js","sourceRoot":"","sources":["../../src/core/StateMark.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAOzC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAqB,EAAE,EAAE;IAC/C,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC3C,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IAE3C,OAAO,CACH,6BACgB,MAAM,6BACM,OAAO,EAC/B,SAAS,EAAC,OAAO,EACjB,OAAO,EAAC,WAAW,YAEnB,eAAM,CAAC,EAAC,wBAAwB,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,cAAc,EAAC,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,WAAW,EAAC,GAAG,GAAG,GAChI,CACT,CAAA;AACL,CAAC,CAAA"}

package/dist/core/branch/MarkdownArticle/classNames.d.ts

@@ -0,0 +1,9 @@
+/** Identifies the readable Markdown document frame. */
+export declare const markdownArticleClassName: import("tailwind-variants").CnReturn;
+/** Identifies a bounded fenced-code frame. */
+export declare const fencedCodeBlockClassName: import("tailwind-variants").CnReturn;
+/** Identifies the optional fenced-code header. */
+export declare const fencedCodeHeaderClassName: import("tailwind-variants").CnReturn;
+/** Identifies the bounded table overflow frame. */
+export declare const markdownTableFrameClassName: import("tailwind-variants").CnReturn;
+//# sourceMappingURL=classNames.d.ts.map

package/dist/core/branch/MarkdownArticle/classNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/MarkdownArticle/classNames.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,sCAA0B,CAAA;AAC/D,8CAA8C;AAC9C,eAAO,MAAM,wBAAwB,sCAAiC,CAAA;AACtE,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,sCAAgD,CAAA;AACtF,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,sCAAiC,CAAA"}

package/dist/core/branch/MarkdownArticle/classNames.js

@@ -0,0 +1,10 @@
+import { cn } from "@heroui/react";
+/** Identifies the readable Markdown document frame. */
+export const markdownArticleClassName = cn("min-w-0", "w-full");
+/** Identifies a bounded fenced-code frame. */
+export const fencedCodeBlockClassName = cn("min-w-0", "overflow-auto");
+/** Identifies the optional fenced-code header. */
+export const fencedCodeHeaderClassName = cn("flex", "items-center", "justify-between");
+/** Identifies the bounded table overflow frame. */
+export const markdownTableFrameClassName = cn("min-w-0", "overflow-auto");
+//# sourceMappingURL=classNames.js.map

package/dist/core/branch/MarkdownArticle/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sourceRoot":"","sources":["../../../../src/core/branch/MarkdownArticle/classNames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,uDAAuD;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;AAC/D,8CAA8C;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;AACtE,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAA;AACtF,mDAAmD;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA"}

package/dist/core/branch/MarkdownArticle/index.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from "react";
+export type MarkdownArticleProps = {
+    readonly children: ReactNode;
+    readonly ariaLabel?: string;
+    readonly measure?: "reading" | "compact";
+};
+type FencedCodeBlockFrameProps = {
+    readonly language?: string;
+    readonly action?: ReactNode;
+};
+type AuthoredCodeProps = {
+    readonly code: string;
+    readonly children?: never;
+};
+type RenderedCodeProps = {
+    readonly children: ReactNode;
+    readonly code?: never;
+};
+export type FencedCodeBlockProps = FencedCodeBlockFrameProps & (AuthoredCodeProps | RenderedCodeProps);
+export type MarkdownTableFrameProps = {
+    readonly children: ReactNode;
+};
+/** Own the business-neutral reading rhythm for one semantic Markdown document. */
+export declare const MarkdownArticle: (props: MarkdownArticleProps) => import("react").JSX.Element;
+/** Own bounded code overflow while allowing a caller-supplied neutral action such as Copy. */
+export declare const FencedCodeBlock: (props: FencedCodeBlockProps) => import("react").JSX.Element;
+/** Keep a vendor-rendered table inside the same bounded reading frame as semantic tables. */
+export declare const MarkdownTableFrame: (props: MarkdownTableFrameProps) => import("react").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/MarkdownArticle/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAC3C,CAAA;AAED,KAAK,yBAAyB,GAAG;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAC9B,CAAA;AAED,KAAK,iBAAiB,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAC5B,CAAA;AAED,KAAK,iBAAiB,GAAG;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,GAAG,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,CAAA;AAEtG,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC/B,CAAA;AAED,kFAAkF;AAClF,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,gCAQ1D,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,gCAe1D,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,GAAI,OAAO,uBAAuB,gCAMhE,CAAA"}