@starci/grammar 0.4.12 → 0.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Image/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGnE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAC/E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE3D,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,2GAanB,UAAU,gCAmDZ,CAAA"}

package/dist/core/primitive/Image/index.js

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * A reserved-ratio image with loading, loaded and error states.
+ *
+ * The box claims its aspect ratio before the bytes arrive, so lazy images never shift the page.
+ * `MediaFrame` frames approved art with a caption; `Image` is the element inside or outside it.
+ * Contract: box MEDIA-2 MEDIA-5 (reserved ratio, load states), img MEDIA-4 MOTION-2, fallback MEDIA-4 MEDIA-5.
+ */
+export const Image = ({ src, alt, aspect = "auto", fit = "cover", fallback, loading = "lazy", srcSet, sizes, width, height, onLoadStateChange, className, }) => {
+    const [state, setState] = useState("loading");
+    const imageRef = useRef(null);
+    const report = (next) => {
+        setState(next);
+        onLoadStateChange?.(next);
+    };
+    useEffect(() => {
+        setState("loading");
+        // A cached image can finish before hydration attaches onLoad.
+        const image = imageRef.current;
+        if (image !== null && image.complete && image.naturalWidth > 0)
+            report("loaded");
+    }, [src]);
+    const showFallback = state === "error" && fallback !== undefined;
+    return (_jsx("span", { className: navigationClassName("starci-core-image", className), "data-component": "Image", "data-contract": "MEDIA-2 MEDIA-5", "data-tier": "atom", "data-grammar-image-aspect": aspect, "data-grammar-image-fit": fit, "data-grammar-image-state": state, children: showFallback ? (_jsx("span", { className: "starci-core-image-fallback", "data-contract": "MEDIA-4 MEDIA-5", "data-grammar-image-fallback": "true", ...(alt === "" ? { "aria-hidden": true } : { role: "img", "aria-label": alt }), children: fallback })) : (_jsx("img", { ref: imageRef, alt: alt, className: "starci-core-image-element", "data-contract": "MEDIA-4 MOTION-2", decoding: "async", loading: loading, src: src, ...(srcSet === undefined ? {} : { srcSet }), ...(sizes === undefined ? {} : { sizes }), ...(width === undefined ? {} : { width }), ...(height === undefined ? {} : { height }), onError: () => report("error"), onLoad: () => report("loaded") })) }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/Image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Image/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAwBnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAClB,GAAG,EACH,GAAG,EACH,MAAM,GAAG,MAAM,EACf,GAAG,GAAG,OAAO,EACb,QAAQ,EACR,OAAO,GAAG,MAAM,EAChB,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAM,EACN,iBAAiB,EACjB,SAAS,GACA,EAAE,EAAE;IACb,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAiB,SAAS,CAAC,CAAA;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAmB,IAAI,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAG,CAAC,IAAoB,EAAE,EAAE;QACpC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACd,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC,CAAA;IACD,SAAS,CAAC,GAAG,EAAE;QACX,QAAQ,CAAC,SAAS,CAAC,CAAA;QACnB,8DAA8D;QAC9D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC9B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,GAAG,CAAC;YAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpF,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAET,MAAM,YAAY,GAAG,KAAK,KAAK,OAAO,IAAI,QAAQ,KAAK,SAAS,CAAA;IAChE,OAAO,CACH,eACI,SAAS,EAAE,mBAAmB,CAAC,mBAAmB,EAAE,SAAS,CAAC,oBAC/C,OAAO,mBACR,iBAAiB,eACrB,MAAM,+BACW,MAAM,4BACT,GAAG,8BACD,KAAK,YAE9B,YAAY,CAAC,CAAC,CAAC,CACZ,eACI,SAAS,EAAC,4BAA4B,mBACxB,iBAAiB,iCACH,MAAM,KAC9B,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,YACjF,QAAQ,GAAQ,CACrB,CAAC,CAAC,CAAC,CACA,cACI,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,GAAG,EACR,SAAS,EAAC,2BAA2B,mBACvB,kBAAkB,EAChC,QAAQ,EAAC,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,KACJ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KACxC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KACtC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KACtC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAC5C,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAChC,CACL,GACE,CACV,CAAA;AACL,CAAC,CAAA"}

package/dist/core/primitive/IncludedMark/index.d.ts

@@ -4,7 +4,8 @@ export type IncludedMarkProps = Omit<ComponentPropsWithoutRef<"svg">, "children"
 };
 /**
  * Purpose-named offering marker: an outlined 20px circle-check in inherited
- * foreground. It deliberately does not reuse affirmative/completion state.
+ * foreground. It deliberately does not reuse affirmative/completion state (TRUTH-1), and it is named
+ * only when given a label, silent otherwise (ICON-6).
  */
 export declare const IncludedMark: ({ className, label, ...props }: IncludedMarkProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/IncludedMark/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAA;AAGrD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,gCAAgC,iBAAiB,gCAc7E,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/IncludedMark/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAA;AAGrD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,gCAAgC,iBAAiB,gCAe7E,CAAA"}

package/dist/core/primitive/IncludedMark/index.js

@@ -2,7 +2,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "@heroui/react";
 /**
  * Purpose-named offering marker: an outlined 20px circle-check in inherited
- * foreground. It deliberately does not reuse affirmative/completion state.
+ * foreground. It deliberately does not reuse affirmative/completion state (TRUTH-1), and it is named
+ * only when given a label, silent otherwise (ICON-6).
  */
-export const IncludedMark = ({ className, label, ...props }) => (_jsxs("svg", { ...props, "aria-hidden": label === undefined ? "true" : undefined, "aria-label": label, className: cn("starci-core-included-mark", className), "data-grammar-included-mark": "true", focusable: "false", role: label === undefined ? undefined : "img", viewBox: "0 0 20 20", children: [_jsx("circle", { cx: "10", cy: "10", fill: "none", r: "8", stroke: "currentColor", strokeWidth: "1.5" }), _jsx("path", { d: "m6.5 10.25 2.2 2.2 4.8-5", fill: "none", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.75" })] }));
+export const IncludedMark = ({ className, label, ...props }) => (_jsxs("svg", { ...props, "aria-hidden": label === undefined ? "true" : undefined, "aria-label": label, className: cn("starci-core-included-mark", className), "data-contract": "ICON-6 TRUTH-1", "data-grammar-included-mark": "true", focusable: "false", role: label === undefined ? undefined : "img", viewBox: "0 0 20 20", children: [_jsx("circle", { cx: "10", cy: "10", fill: "none", r: "8", stroke: "currentColor", strokeWidth: "1.5" }), _jsx("path", { d: "m6.5 10.25 2.2 2.2 4.8-5", fill: "none", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.75" })] }));
 //# sourceMappingURL=index.js.map

package/dist/core/primitive/IncludedMark/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/IncludedMark/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAMlC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,EAAqB,EAAE,EAAE,CAAC,CAC/E,kBACQ,KAAK,iBACI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,gBACzC,KAAK,EACjB,SAAS,EAAE,EAAE,CAAC,2BAA2B,EAAE,SAAS,CAAC,gCAC1B,MAAM,EACjC,SAAS,EAAC,OAAO,EACjB,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAC7C,OAAO,EAAC,WAAW,aAEnB,iBAAQ,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,CAAC,EAAC,GAAG,EAAC,MAAM,EAAC,cAAc,EAAC,WAAW,EAAC,KAAK,GAAG,EACpF,eAAM,CAAC,EAAC,0BAA0B,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,cAAc,EAAC,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,WAAW,EAAC,MAAM,GAAG,IACrI,CACT,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/IncludedMark/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAMlC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,EAAqB,EAAE,EAAE,CAAC,CAC/E,kBACQ,KAAK,iBACI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,gBACzC,KAAK,EACjB,SAAS,EAAE,EAAE,CAAC,2BAA2B,EAAE,SAAS,CAAC,mBACvC,gBAAgB,gCACH,MAAM,EACjC,SAAS,EAAC,OAAO,EACjB,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAC7C,OAAO,EAAC,WAAW,aAEnB,iBAAQ,EAAE,EAAC,IAAI,EAAC,EAAE,EAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,CAAC,EAAC,GAAG,EAAC,MAAM,EAAC,cAAc,EAAC,WAAW,EAAC,KAAK,GAAG,EACpF,eAAM,CAAC,EAAC,0BAA0B,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,cAAc,EAAC,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,EAAC,WAAW,EAAC,MAAM,GAAG,IACrI,CACT,CAAA"}

package/dist/core/primitive/Kbd/index.d.ts

@@ -0,0 +1,13 @@
+/** Named keys drawn as their platform symbol, with the spelled-out name as the abbreviation title. */
+export declare const KBD_NAMED_KEYS: readonly ["command", "shift", "ctrl", "option", "enter", "delete", "escape", "tab", "capslock", "up", "right", "down", "left", "pageup", "pagedown", "home", "end", "help", "space", "fn", "win", "alt"];
+export type KbdNamedKey = (typeof KBD_NAMED_KEYS)[number];
+export type KbdProps = {
+    /**
+     * The chord, in press order. A named key (`command`, `shift`, `enter`...) renders its symbol inside
+     * an `<abbr>` whose title spells the key; any other string (`K`, `F6`) renders verbatim.
+     */
+    readonly keys: readonly string[];
+};
+/** ATOM - `Kbd`: one keyboard shortcut chord as a single `<kbd>` element. Contract: ICON-6 (key glyphs named once via `<abbr title>`). */
+export declare const Kbd: ({ keys }: KbdProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Kbd/index.tsx"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,eAAO,MAAM,cAAc,0MAGjB,CAAA;AAEV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzD,MAAM,MAAM,QAAQ,GAAG;IACnB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC,CAAA;AAKD,0IAA0I;AAC1I,eAAO,MAAM,GAAG,GAAI,UAAU,QAAQ,gCAMrC,CAAA"}

package/dist/core/primitive/Kbd/index.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Kbd as HeroKbd } from "@heroui/react";
+/** Named keys drawn as their platform symbol, with the spelled-out name as the abbreviation title. */
+export const KBD_NAMED_KEYS = [
+    "command", "shift", "ctrl", "option", "enter", "delete", "escape", "tab", "capslock", "up", "right",
+    "down", "left", "pageup", "pagedown", "home", "end", "help", "space", "fn", "win", "alt",
+];
+const namedKeys = new Set(KBD_NAMED_KEYS);
+const isNamedKey = (key) => namedKeys.has(key);
+/** ATOM - `Kbd`: one keyboard shortcut chord as a single `<kbd>` element. Contract: ICON-6 (key glyphs named once via `<abbr title>`). */
+export const Kbd = ({ keys }) => (_jsx(HeroKbd, { "data-tier": "atom", "data-component": "Kbd", "data-contract": "ICON-6", className: "starci-core-kbd", children: keys.map((key, index) => isNamedKey(key)
+        ? _jsx(HeroKbd.Abbr, { keyValue: key }, `${key}-${index}`)
+        : _jsx(HeroKbd.Content, { children: key }, `${key}-${index}`)) }));
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/Kbd/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Kbd/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,eAAe,CAAA;AAE9C,sGAAsG;AACtG,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;IACnG,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK;CAClF,CAAA;AAYV,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC,cAAc,CAAC,CAAA;AAC9D,MAAM,UAAU,GAAG,CAAC,GAAW,EAAsB,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE1E,0IAA0I;AAC1I,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,IAAI,EAAY,EAAE,EAAE,CAAC,CACvC,KAAC,OAAO,iBAAW,MAAM,oBAAgB,KAAK,mBAAe,QAAQ,EAAC,SAAS,EAAC,iBAAiB,YAC5F,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QACrC,CAAC,CAAC,KAAC,OAAO,CAAC,IAAI,IAAyB,QAAQ,EAAE,GAAG,IAAhC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAmB;QACzD,CAAC,CAAC,KAAC,OAAO,CAAC,OAAO,cAA0B,GAAG,IAAvB,GAAG,GAAG,IAAI,KAAK,EAAE,CAAyB,CAAC,GACjE,CACb,CAAA"}

package/dist/core/primitive/Label/index.d.ts

@@ -1,11 +1,25 @@
-import type { ReactNode } from "react";
+import { type ReactNode } from "react";
+/**
+ * The document-outline rank a surface's visible name takes. Surfaces default to `3` (a card under
+ * a page section's `h2`); a page whose cards sit directly under its `h1` passes `2`, a card nested
+ * under a `h3` passes `4`, so the outline never skips a level (axe `heading-order`).
+ */
+export type SurfaceHeadingLevel = 2 | 3 | 4 | 5 | 6;
+/** The default rank of a surface name. */
+export declare const DEFAULT_SURFACE_HEADING_LEVEL: SurfaceHeadingLevel;
 export type LabelProps = {
     readonly id?: string;
     readonly children: ReactNode;
     readonly depth?: "top" | "nested";
-    /** A surface branch may promote its visible name into the document outline. */
-    readonly as?: "span" | "h3";
+    /** A surface branch may promote its visible name into the document outline at any rank. */
+    readonly as?: "span" | "h2" | "h3" | "h4" | "h5" | "h6";
 };
 /** Names a bounded surface region without claiming document-outline heading rank. */
-export declare const Label: ({ id, children, depth, as }: LabelProps) => import("react").JSX.Element;
+export declare const Label: ({ id, children, depth, as }: LabelProps) => import("react").DetailedReactHTMLElement<{
+    readonly id: string | undefined;
+    readonly className: string;
+    readonly "data-grammar-label": "true";
+    readonly "data-grammar-label-depth": "top" | "nested";
+    readonly "data-contract": "FONT-1 MARGIN-0" | "FONT-2 MARGIN-0";
+}, HTMLElement>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Label/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,KAAK,GAAI,6BAA8C,UAAU,gCAU7E,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Label/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAEnD,0CAA0C;AAC1C,eAAO,MAAM,6BAA6B,EAAE,mBAAuB,CAAA;AAGnE,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAA;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1D,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,KAAK,GAAI,6BAA8C,UAAU;;;;;;eAU7E,CAAA"}

package/dist/core/primitive/Label/index.js

@@ -1,4 +1,6 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { createElement } from "react";
+/** The default rank of a surface name. */
+export const DEFAULT_SURFACE_HEADING_LEVEL = 3;
 import { getLabelClassName, getLabelContract } from "./classNames.js";
 /** Names a bounded surface region without claiming document-outline heading rank. */
 export const Label = ({ id, children, depth = "top", as = "span" }) => {
@@ -9,6 +11,6 @@ export const Label = ({ id, children, depth = "top", as = "span" }) => {
         "data-grammar-label-depth": depth,
         "data-contract": getLabelContract(depth),
     };
-    return as === "h3" ? _jsx("h3", { ...shared, children: children }) : _jsx("span", { ...shared, children: children });
+    return createElement(as, shared, children);
 };
 //# sourceMappingURL=index.js.map

package/dist/core/primitive/Label/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Label/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAUrE,qFAAqF;AACrF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,GAAG,KAAK,EAAE,EAAE,GAAG,MAAM,EAAc,EAAE,EAAE;IAC9E,MAAM,MAAM,GAAG;QACX,EAAE;QACF,SAAS,EAAE,iBAAiB,EAAE;QAC9B,oBAAoB,EAAE,MAAM;QAC5B,0BAA0B,EAAE,KAAK;QACjC,eAAe,EAAE,gBAAgB,CAAC,KAAK,CAAC;KAClC,CAAA;IAEV,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAQ,MAAM,YAAG,QAAQ,GAAM,CAAC,CAAC,CAAC,kBAAU,MAAM,YAAG,QAAQ,GAAQ,CAAA;AAC9F,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Label/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAA;AASrD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,6BAA6B,GAAwB,CAAC,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAUrE,qFAAqF;AACrF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,GAAG,KAAK,EAAE,EAAE,GAAG,MAAM,EAAc,EAAE,EAAE;IAC9E,MAAM,MAAM,GAAG;QACX,EAAE;QACF,SAAS,EAAE,iBAAiB,EAAE;QAC9B,oBAAoB,EAAE,MAAM;QAC5B,0BAA0B,EAAE,KAAK;QACjC,eAAe,EAAE,gBAAgB,CAAC,KAAK,CAAC;KAClC,CAAA;IAEV,OAAO,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AAC9C,CAAC,CAAA"}

package/dist/core/primitive/Link/index.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from "react";
+export type LinkKind = "internal" | "external";
+export type LinkProps = {
+    readonly children: ReactNode;
+    readonly href: string;
+    /** `external` leaves the app in a new browsing context with `noopener noreferrer`. */
+    readonly kind?: LinkKind;
+    /** Marks the destination the reader is on now (`aria-current="page"`). */
+    readonly isCurrent?: boolean;
+    /** Visited destinations keep a distinct tint unless the surrounding list must stay uniform. */
+    readonly visited?: "distinct" | "uniform";
+    /** App-owned assistive text appended to an external link, e.g. that it opens a new tab. */
+    readonly externalHint?: string;
+    /** App-owned glyph after an external label; decorative only. */
+    readonly externalIcon?: ReactNode;
+    readonly isDisabled?: boolean;
+    /** Runs alongside navigation. It cannot cancel the destination. */
+    readonly onFollow?: () => void;
+    readonly className?: string;
+};
+/**
+ * An inline destination in running text or a link list.
+ *
+ * It is always a real anchor (middle-click, copy-link and the `link` role come from the platform).
+ * `TextAction` owns action-shaped links; `Link` owns prose and directory links, including the
+ * visited and current destination states that action chrome does not draw.
+ * Contract: anchor ACTION-3 (always a destination) FOCUS-1, external glyph ICON-6.
+ */
+export declare const Link: ({ children, href, kind, isCurrent, visited, externalHint, externalIcon, isDisabled, onFollow, className, }: LinkProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Link/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAA;AAE9C,MAAM,MAAM,SAAS,GAAG;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IACzC,2FAA2F;IAC3F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,GAAI,4GAWlB,SAAS,gCAsBX,CAAA"}

package/dist/core/primitive/Link/index.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Link as HeroLink } from "@heroui/react";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * An inline destination in running text or a link list.
+ *
+ * It is always a real anchor (middle-click, copy-link and the `link` role come from the platform).
+ * `TextAction` owns action-shaped links; `Link` owns prose and directory links, including the
+ * visited and current destination states that action chrome does not draw.
+ * Contract: anchor ACTION-3 (always a destination) FOCUS-1, external glyph ICON-6.
+ */
+export const Link = ({ children, href, kind = "internal", isCurrent = false, visited = "distinct", externalHint, externalIcon, isDisabled = false, onFollow, className, }) => {
+    const external = kind === "external";
+    return (_jsxs(HeroLink, { "aria-current": isCurrent ? "page" : undefined, className: navigationClassName("starci-core-link", className), "data-component": "Link", "data-contract": "ACTION-3 FOCUS-1", "data-tier": "atom", "data-grammar-link-kind": kind, "data-grammar-link-visited": visited, "data-grammar-current": isCurrent ? "true" : "false", isDisabled: isDisabled, ...(isDisabled ? { "aria-disabled": true } : { href }), ...(external ? { target: "_blank", rel: "noopener noreferrer" } : {}), ...(onFollow === undefined ? {} : { onPress: () => onFollow() }), children: [children, external && externalIcon !== undefined ? _jsx("span", { "aria-hidden": "true", className: "starci-core-link-external-icon", "data-contract": "ICON-6", "data-grammar-link-external-icon": "true", children: externalIcon }) : null, external && externalHint !== undefined ? _jsx("span", { className: "starci-core-nav-visually-hidden", children: ` ${externalHint}` }) : null] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/Link/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Link/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAuBnE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,EACjB,QAAQ,EACR,IAAI,EACJ,IAAI,GAAG,UAAU,EACjB,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,UAAU,EACpB,YAAY,EACZ,YAAY,EACZ,UAAU,GAAG,KAAK,EAClB,QAAQ,EACR,SAAS,GACD,EAAE,EAAE;IACZ,MAAM,QAAQ,GAAG,IAAI,KAAK,UAAU,CAAA;IACpC,OAAO,CACH,MAAC,QAAQ,oBACS,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAC5C,SAAS,EAAE,mBAAmB,CAAC,kBAAkB,EAAE,SAAS,CAAC,oBAC9C,MAAM,mBACP,kBAAkB,eACtB,MAAM,4BACQ,IAAI,+BACD,OAAO,0BACZ,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAClD,UAAU,EAAE,UAAU,KAClB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KACnD,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAClE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,aAEhE,QAAQ,EACR,QAAQ,IAAI,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,8BAAkB,MAAM,EAAC,SAAS,EAAC,gCAAgC,mBAAe,QAAQ,qCAAiC,MAAM,YAAE,YAAY,GAAQ,CAAC,CAAC,CAAC,IAAI,EACvM,QAAQ,IAAI,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,iCAAiC,YAAE,IAAI,YAAY,EAAE,GAAQ,CAAC,CAAC,CAAC,IAAI,IACvH,CACd,CAAA;AACL,CAAC,CAAA"}

package/dist/core/primitive/Meter/index.d.ts

@@ -0,0 +1,16 @@
+import type { PresentationState } from "../../../common/state.js";
+export type MeterProps = {
+    /** What the gauge measures. Visible by default and wired as the meter's accessible name. */
+    readonly label: string;
+    readonly value: number;
+    readonly minValue?: number;
+    readonly maxValue?: number;
+    /** App-resolved reading, e.g. "3.2 of 5 GB". Defaults to the platform percentage. */
+    readonly valueLabel?: string;
+    /** How the reading should be judged. It colours the fill; it never replaces the label. */
+    readonly tone?: PresentationState;
+    /** Hide the drawn label and reading but keep the accessible name. */
+    readonly isLabelHidden?: boolean;
+};
+export declare const Meter: ({ label, value, minValue, maxValue, valueLabel, tone, isLabelHidden, }: MeterProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Meter/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAGjE,MAAM,MAAM,UAAU,GAAG;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACjC,qEAAqE;IACrE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACnC,CAAA;AAeD,eAAO,MAAM,KAAK,GAAI,wEAQnB,UAAU,gCA6BZ,CAAA"}

package/dist/core/primitive/Meter/index.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Label as HeroLabel, Meter as HeroMeter } from "@heroui/react";
+import { vendorStatusFor } from "../../overlayScope.js";
+/**
+ * ATOM - `Meter`: a static reading inside a known range (`role="meter"`).
+ *
+ * The role is exactly `meter` (ARIA 1.2), never React Aria's `"meter progressbar"` fallback list:
+ * validators resolve a role list to an unsupported token and reject the `aria-value*` attributes
+ * (axe 4.13 `aria-allowed-attr`), while every current engine exposes `meter` (Chromium, WebKit
+ * and Gecko map it to a level indicator / progress bar natively).
+ *
+ * Unlike `Progress`, a meter is not work moving toward completion. Tone is a PresentationState and is
+ * echoed on `data-grammar-tone` for family treatments.
+ */
+const renderMeterRoot = (domProps) => _jsx("div", { ...domProps, role: "meter" });
+export const Meter = ({ label, value, minValue = 0, maxValue = 100, valueLabel, tone = "neutral", isLabelHidden = false, }) => {
+    const status = vendorStatusFor(tone);
+    return (_jsxs(HeroMeter, { "data-tier": "atom", "data-component": "Meter", "data-grammar-tone": tone, "data-contract": "A11Y-3 ACCENT-4", value: value, minValue: minValue, maxValue: maxValue, ...(valueLabel === undefined ? {} : { valueLabel }), ...(isLabelHidden ? { "aria-label": label } : {}), color: status === "default" ? "accent" : status, size: "md", className: "starci-core-meter", render: renderMeterRoot, children: [isLabelHidden ? null : (_jsxs("span", { className: "starci-core-meter-header", children: [_jsx(HeroLabel, { className: "starci-core-meter-label", children: label }), _jsx(HeroMeter.Output, { className: "starci-core-meter-output" })] })), _jsx(HeroMeter.Track, { className: "starci-core-meter-track", children: _jsx(HeroMeter.Fill, { className: "starci-core-meter-fill", "data-contract": "MOTION-2" }) })] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/Meter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/Meter/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,eAAe,CAAA;AAGtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAgBvD;;;;;;;;;;GAUG;AACH,MAAM,eAAe,GAAG,CAAC,QAAsC,EAAE,EAAE,CAAC,iBAAS,QAAQ,EAAE,IAAI,EAAC,OAAO,GAAG,CAAA;AAEtG,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAClB,KAAK,EACL,KAAK,EACL,QAAQ,GAAG,CAAC,EACZ,QAAQ,GAAG,GAAG,EACd,UAAU,EACV,IAAI,GAAG,SAAS,EAChB,aAAa,GAAG,KAAK,GACZ,EAAE,EAAE;IACb,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;IACpC,OAAO,CACH,MAAC,SAAS,iBACI,MAAM,oBACD,OAAO,uBACH,IAAI,mBACT,iBAAiB,EAC/B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,KACd,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,KAChD,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAClD,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAC/C,IAAI,EAAC,IAAI,EACT,SAAS,EAAC,mBAAmB,EAC7B,MAAM,EAAE,eAAe,aAEtB,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACpB,gBAAM,SAAS,EAAC,0BAA0B,aACtC,KAAC,SAAS,IAAC,SAAS,EAAC,yBAAyB,YAAE,KAAK,GAAa,EAClE,KAAC,SAAS,CAAC,MAAM,IAAC,SAAS,EAAC,0BAA0B,GAAG,IACtD,CACV,EACD,KAAC,SAAS,CAAC,KAAK,IAAC,SAAS,EAAC,yBAAyB,YAChD,KAAC,SAAS,CAAC,IAAI,IAAC,SAAS,EAAC,wBAAwB,mBAAe,UAAU,GAAG,GAChE,IACV,CACf,CAAA;AACL,CAAC,CAAA"}

package/dist/core/primitive/NumberField/index.d.ts

@@ -0,0 +1,21 @@
+import { type FieldControlProps } from "../Field/index.js";
+export type NumberFieldProps = FieldControlProps & {
+    readonly id?: string;
+    readonly placeholder?: string;
+    readonly value?: number;
+    readonly defaultValue?: number;
+    readonly onValueChange?: (value: number) => void;
+    readonly minValue?: number;
+    readonly maxValue?: number;
+    readonly step?: number;
+    /** Locale-aware display, e.g. `{ style: "percent" }` or a currency. */
+    readonly formatOptions?: Intl.NumberFormatOptions;
+    /** Hides the stepper buttons; arrow keys, Page Up/Down and Home/End still step. */
+    readonly hideSteppers?: boolean;
+};
+/**
+ * A number with stepping. The vendor owns `role="spinbutton"`-equivalent semantics on the input,
+ * locale parsing, arrow-key and wheel stepping, clamping to min/max and the localized stepper names.
+ */
+export declare const NumberField: ({ id, placeholder, value, defaultValue, onValueChange, minValue, maxValue, step, formatOptions, hideSteppers, ...field }: NumberFieldProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/NumberField/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG;IAC/C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAA;IACjD,mFAAmF;IACnF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAClC,CAAA;AAQD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,0HAYzB,gBAAgB,gCA6BlB,CAAA"}

package/dist/core/primitive/NumberField/index.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { NumberField as HeroNumberField } from "@heroui/react";
+import { FieldDescription, FieldErrorText, FieldLabel, vendorFieldProps, } from "../Field/index.js";
+/*
+ * Consumer hook: `starci-core-number-field` names this control's root for a consumer or family
+ * stylesheet. No shipped sheet paints it: the root is drawn as a whole by `.starci-core-field`, so
+ * a rule on the hook adds to the shared anatomy and never has to replace it.
+ */
+/**
+ * A number with stepping. The vendor owns `role="spinbutton"`-equivalent semantics on the input,
+ * locale parsing, arrow-key and wheel stepping, clamping to min/max and the localized stepper names.
+ */
+export const NumberField = ({ id, placeholder, value, defaultValue, onValueChange, minValue, maxValue, step, formatOptions, hideSteppers = false, ...field }) => (_jsxs(HeroNumberField, { "data-tier": "atom", "data-component": "NumberField", "data-contract": "A11Y-1 FIELD-1 FIELD-2 FIELD-3", className: "starci-core-field starci-core-number-field", fullWidth: true, ...vendorFieldProps(field), isReadOnly: field.isReadOnly === true, ...(value === undefined ? defaultValue === undefined ? {} : { defaultValue } : { value }), ...(onValueChange === undefined ? {} : { onChange: onValueChange }), ...(minValue === undefined ? {} : { minValue }), ...(maxValue === undefined ? {} : { maxValue }), ...(step === undefined ? {} : { step }), ...(formatOptions === undefined ? {} : { formatOptions }), children: [_jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsxs(HeroNumberField.Group, { className: "starci-core-number-field-group", "data-grammar-field-control": "true", children: [hideSteppers ? null : _jsx(HeroNumberField.DecrementButton, { className: "starci-core-number-field-step" }), _jsx(HeroNumberField.Input, { ...(id === undefined ? {} : { id }), ...(placeholder === undefined ? {} : { placeholder }), className: "starci-core-number-field-input" }), hideSteppers ? null : _jsx(HeroNumberField.IncrementButton, { className: "starci-core-number-field-step" })] }), _jsx(FieldDescription, { children: field.description }), _jsx(FieldErrorText, { children: field.errorMessage })] }));
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/NumberField/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/NumberField/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,gBAAgB,GAEnB,MAAM,mBAAmB,CAAA;AAiB1B;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EACxB,EAAE,EACF,WAAW,EACX,KAAK,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,aAAa,EACb,YAAY,GAAG,KAAK,EACpB,GAAG,KAAK,EACO,EAAE,EAAE,CAAC,CACpB,MAAC,eAAe,iBACF,MAAM,oBACD,aAAa,mBACd,gCAAgC,EAC9C,SAAS,EAAC,4CAA4C,EACtD,SAAS,WACL,gBAAgB,CAAC,KAAK,CAAC,EAC3B,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,KACjC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KACtF,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,KAChE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAC5C,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAC5C,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KACpC,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,aAE1D,KAAC,UAAU,IAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,YAAG,KAAK,CAAC,KAAK,GAAc,EACnG,MAAC,eAAe,CAAC,KAAK,IAAC,SAAS,EAAC,gCAAgC,gCAA4B,MAAM,aAC9F,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,eAAe,CAAC,eAAe,IAAC,SAAS,EAAC,+BAA+B,GAAG,EACpG,KAAC,eAAe,CAAC,KAAK,OACd,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAChC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EACtD,SAAS,EAAC,gCAAgC,GAC5C,EACD,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAC,eAAe,CAAC,eAAe,IAAC,SAAS,EAAC,+BAA+B,GAAG,IAChF,EACxB,KAAC,gBAAgB,cAAE,KAAK,CAAC,WAAW,GAAoB,EACxD,KAAC,cAAc,cAAE,KAAK,CAAC,YAAY,GAAkB,IACvC,CACrB,CAAA"}

package/dist/core/primitive/ProgressCircle/index.d.ts

@@ -0,0 +1,13 @@
+export type ProgressCircleSize = "sm" | "md" | "lg";
+export type ProgressCircleProps = {
+    /** What the ring measures. Required: the ring draws no label of its own. */
+    readonly label: string;
+    /** Completion from 0 to 100. Ignored while indeterminate. */
+    readonly value?: number;
+    /** Work with no knowable completion; the ring is announced without a value. */
+    readonly isIndeterminate?: boolean;
+    readonly size?: ProgressCircleSize;
+};
+/** ATOM - `ProgressCircle`: compact circular completion, the ring counterpart of `Progress`. */
+export declare const ProgressCircle: ({ label, value, isIndeterminate, size }: ProgressCircleProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/ProgressCircle/index.tsx"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEnD,MAAM,MAAM,mBAAmB,GAAG;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;CACrC,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,cAAc,GAAI,yCAA4D,mBAAmB,gCAoB7G,CAAA"}

package/dist/core/primitive/ProgressCircle/index.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ProgressCircle as HeroProgressCircle } from "@heroui/react";
+/** ATOM - `ProgressCircle`: compact circular completion, the ring counterpart of `Progress`. */
+export const ProgressCircle = ({ label, value = 0, isIndeterminate = false, size = "md" }) => (_jsx(HeroProgressCircle, { "data-tier": "atom", "data-component": "ProgressCircle", "data-size": size, "data-indeterminate": isIndeterminate ? "true" : "false", "aria-label": label, "data-contract": "A11Y-3 MOTION-2", minValue: 0, maxValue: 100, ...(isIndeterminate ? { isIndeterminate: true } : { value }), color: "accent", size: size, className: "starci-core-progress-circle", children: _jsxs(HeroProgressCircle.Track, { children: [_jsx(HeroProgressCircle.TrackCircle, {}), _jsx(HeroProgressCircle.FillCircle, {})] }) }));
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/ProgressCircle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/ProgressCircle/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAcpE,gGAAgG;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,eAAe,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,EAAuB,EAAE,EAAE,CAAC,CAC/G,KAAC,kBAAkB,iBACL,MAAM,oBACD,gBAAgB,eACpB,IAAI,wBACK,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,gBAC1C,KAAK,mBACH,iBAAiB,EAC/B,QAAQ,EAAE,CAAC,EACX,QAAQ,EAAE,GAAG,KACT,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAC7D,KAAK,EAAC,QAAQ,EACd,IAAI,EAAE,IAAI,EACV,SAAS,EAAC,6BAA6B,YAEvC,MAAC,kBAAkB,CAAC,KAAK,eACrB,KAAC,kBAAkB,CAAC,WAAW,KAAG,EAClC,KAAC,kBAAkB,CAAC,UAAU,KAAG,IACV,GACV,CACxB,CAAA"}

package/dist/core/primitive/RankArtwork/index.d.ts

@@ -6,7 +6,8 @@ export type RankArtworkProps = Omit<ComponentPropsWithoutRef<"svg">, "children">
 };
 /**
  * Semantic ranking artwork shared by every Core consumer. Consumers choose
- * the ranking meaning; the Grammar owns the official Fluent Emoji Flat art.
+ * the ranking meaning; the Grammar owns the official Fluent Emoji Flat art. Named only when given a
+ * label, silent otherwise (ICON-6).
  */
 export declare const RankArtwork: ({ className, kind, label, ...props }: RankArtworkProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/RankArtwork/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAa,MAAM,OAAO,CAAA;AAGhE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;AAElE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC/E,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AA0CD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,sCAAsC,gBAAgB,gCAejF,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/RankArtwork/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAa,MAAM,OAAO,CAAA;AAGhE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;AAElE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC/E,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AA0CD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,sCAAsC,gBAAgB,gCAgBjF,CAAA"}

package/dist/core/primitive/RankArtwork/index.js

@@ -8,7 +8,8 @@ const artworkByKind = {
 };
 /**
  * Semantic ranking artwork shared by every Core consumer. Consumers choose
- * the ranking meaning; the Grammar owns the official Fluent Emoji Flat art.
+ * the ranking meaning; the Grammar owns the official Fluent Emoji Flat art. Named only when given a
+ * label, silent otherwise (ICON-6).
  */
-export const RankArtwork = ({ className, kind, label, ...props }) => (_jsx("svg", { ...props, "aria-hidden": label === undefined ? "true" : undefined, "aria-label": label, className: cn("starci-core-rank-artwork", className), "data-grammar-rank-artwork": kind, fill: "none", focusable: "false", role: label === undefined ? undefined : "img", viewBox: "0 0 32 32", xmlns: "http://www.w3.org/2000/svg", children: artworkByKind[kind] }));
+export const RankArtwork = ({ className, kind, label, ...props }) => (_jsx("svg", { ...props, "aria-hidden": label === undefined ? "true" : undefined, "aria-label": label, className: cn("starci-core-rank-artwork", className), "data-contract": "ICON-6", "data-grammar-rank-artwork": kind, fill: "none", focusable: "false", role: label === undefined ? undefined : "img", viewBox: "0 0 32 32", xmlns: "http://www.w3.org/2000/svg", children: artworkByKind[kind] }));
 //# sourceMappingURL=index.js.map

package/dist/core/primitive/RankArtwork/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/RankArtwork/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AASlC,MAAM,aAAa,GAAuC;IACtD,KAAK,EAAE,CACH,8BACI,eAAM,CAAC,EAAC,8MAA8M,EAAC,IAAI,EAAC,SAAS,GAAG,EACxO,eAAM,CAAC,EAAC,kNAAkN,EAAC,IAAI,EAAC,SAAS,GAAG,EAC5O,eAAM,CAAC,EAAC,iNAAiN,EAAC,IAAI,EAAC,SAAS,GAAG,EAC3O,eAAM,CAAC,EAAC,yNAAyN,EAAC,IAAI,EAAC,SAAS,GAAG,EACnP,eAAM,CAAC,EAAC,+kBAA+kB,EAAC,IAAI,EAAC,SAAS,GAAG,IAC1mB,CACN;IACD,MAAM,EAAE,CACJ,8BACI,eAAM,CAAC,EAAC,sNAAsN,EAAC,IAAI,EAAC,SAAS,GAAG,EAChP,eAAM,CAAC,EAAC,kNAAkN,EAAC,IAAI,EAAC,SAAS,GAAG,EAC5O,eAAM,CAAC,EAAC,8MAA8M,EAAC,IAAI,EAAC,SAAS,GAAG,EACxO,eAAM,CAAC,EAAC,opBAAopB,EAAC,IAAI,EAAC,SAAS,GAAG,EAC9qB,eAAM,CAAC,EAAC,qoBAAqoB,EAAC,IAAI,EAAC,SAAS,GAAG,IAChqB,CACN;IACD,KAAK,EAAE,CACH,8BACI,eAAM,CAAC,EAAC,oOAAoO,EAAC,IAAI,EAAC,SAAS,GAAG,EAC9P,eAAM,CAAC,EAAC,0OAA0O,EAAC,IAAI,EAAC,SAAS,GAAG,EACpQ,eAAM,CAAC,EAAC,qLAAqL,EAAC,IAAI,EAAC,SAAS,GAAG,EAC/M,eAAM,CAAC,EAAC,+kBAA+kB,EAAC,IAAI,EAAC,SAAS,GAAG,EACzmB,eAAM,CAAC,EAAC,0rBAA0rB,EAAC,IAAI,EAAC,SAAS,GAAG,IACrtB,CACN;IACD,GAAG,EAAE,CACD,8BACI,eAAM,CAAC,EAAC,6kBAA6kB,EAAC,IAAI,EAAC,SAAS,GAAG,EACvmB,eAAM,CAAC,EAAC,4kBAA4kB,EAAC,IAAI,EAAC,SAAS,GAAG,EACtmB,eAAM,CAAC,EAAC,qJAAqJ,EAAC,IAAI,EAAC,SAAS,GAAG,EAC/K,eAAM,CAAC,EAAC,oMAAoM,EAAC,IAAI,EAAC,SAAS,GAAG,EAC9N,eAAM,CAAC,EAAC,qOAAqO,EAAC,IAAI,EAAC,SAAS,GAAG,EAC/P,eAAM,CAAC,EAAC,wMAAwM,EAAC,IAAI,EAAC,SAAS,GAAG,IACnO,CACN;CACJ,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAoB,EAAE,EAAE,CAAC,CACnF,iBACQ,KAAK,iBACI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,gBACzC,KAAK,EACjB,SAAS,EAAE,EAAE,CAAC,0BAA0B,EAAE,SAAS,CAAC,+BACzB,IAAI,EAC/B,IAAI,EAAC,MAAM,EACX,SAAS,EAAC,OAAO,EACjB,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAC7C,OAAO,EAAC,WAAW,EACnB,KAAK,EAAC,4BAA4B,YAEjC,aAAa,CAAC,IAAI,CAAC,GAClB,CACT,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/RankArtwork/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AASlC,MAAM,aAAa,GAAuC;IACtD,KAAK,EAAE,CACH,8BACI,eAAM,CAAC,EAAC,8MAA8M,EAAC,IAAI,EAAC,SAAS,GAAG,EACxO,eAAM,CAAC,EAAC,kNAAkN,EAAC,IAAI,EAAC,SAAS,GAAG,EAC5O,eAAM,CAAC,EAAC,iNAAiN,EAAC,IAAI,EAAC,SAAS,GAAG,EAC3O,eAAM,CAAC,EAAC,yNAAyN,EAAC,IAAI,EAAC,SAAS,GAAG,EACnP,eAAM,CAAC,EAAC,+kBAA+kB,EAAC,IAAI,EAAC,SAAS,GAAG,IAC1mB,CACN;IACD,MAAM,EAAE,CACJ,8BACI,eAAM,CAAC,EAAC,sNAAsN,EAAC,IAAI,EAAC,SAAS,GAAG,EAChP,eAAM,CAAC,EAAC,kNAAkN,EAAC,IAAI,EAAC,SAAS,GAAG,EAC5O,eAAM,CAAC,EAAC,8MAA8M,EAAC,IAAI,EAAC,SAAS,GAAG,EACxO,eAAM,CAAC,EAAC,opBAAopB,EAAC,IAAI,EAAC,SAAS,GAAG,EAC9qB,eAAM,CAAC,EAAC,qoBAAqoB,EAAC,IAAI,EAAC,SAAS,GAAG,IAChqB,CACN;IACD,KAAK,EAAE,CACH,8BACI,eAAM,CAAC,EAAC,oOAAoO,EAAC,IAAI,EAAC,SAAS,GAAG,EAC9P,eAAM,CAAC,EAAC,0OAA0O,EAAC,IAAI,EAAC,SAAS,GAAG,EACpQ,eAAM,CAAC,EAAC,qLAAqL,EAAC,IAAI,EAAC,SAAS,GAAG,EAC/M,eAAM,CAAC,EAAC,+kBAA+kB,EAAC,IAAI,EAAC,SAAS,GAAG,EACzmB,eAAM,CAAC,EAAC,0rBAA0rB,EAAC,IAAI,EAAC,SAAS,GAAG,IACrtB,CACN;IACD,GAAG,EAAE,CACD,8BACI,eAAM,CAAC,EAAC,6kBAA6kB,EAAC,IAAI,EAAC,SAAS,GAAG,EACvmB,eAAM,CAAC,EAAC,4kBAA4kB,EAAC,IAAI,EAAC,SAAS,GAAG,EACtmB,eAAM,CAAC,EAAC,qJAAqJ,EAAC,IAAI,EAAC,SAAS,GAAG,EAC/K,eAAM,CAAC,EAAC,oMAAoM,EAAC,IAAI,EAAC,SAAS,GAAG,EAC9N,eAAM,CAAC,EAAC,qOAAqO,EAAC,IAAI,EAAC,SAAS,GAAG,EAC/P,eAAM,CAAC,EAAC,wMAAwM,EAAC,IAAI,EAAC,SAAS,GAAG,IACnO,CACN;CACJ,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,EAAoB,EAAE,EAAE,CAAC,CACnF,iBACQ,KAAK,iBACI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,gBACzC,KAAK,EACjB,SAAS,EAAE,EAAE,CAAC,0BAA0B,EAAE,SAAS,CAAC,mBACtC,QAAQ,+BACK,IAAI,EAC/B,IAAI,EAAC,MAAM,EACX,SAAS,EAAC,OAAO,EACjB,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAC7C,OAAO,EAAC,WAAW,EACnB,KAAK,EAAC,4BAA4B,YAEjC,aAAa,CAAC,IAAI,CAAC,GAClB,CACT,CAAA"}

package/dist/core/primitive/Rating/index.d.ts

@@ -0,0 +1,26 @@
+import { type ReactNode } from "react";
+export type RatingProps = {
+    /** Names what is being rated. */
+    readonly label: string;
+    /** Controlled value; 0 means unrated. Read-only ratings may be fractional (halves are drawn). */
+    readonly value?: number;
+    readonly defaultValue?: number;
+    readonly onChange?: (value: number) => void;
+    readonly max?: number;
+    readonly isReadOnly?: boolean;
+    readonly isDisabled?: boolean;
+    /** App-owned accessible text for a value, e.g. "3 of 5 stars". */
+    readonly valueLabel: (value: number, max: number) => string;
+    /** App-owned glyph; defaults to a neutral star outline filled by the stylesheet. */
+    readonly icon?: ReactNode;
+    /** Form field name for the native radio set. */
+    readonly name?: string;
+    readonly className?: string;
+};
+/**
+ * A 1..max rating. Interactive ratings are a native radio set, so arrow keys, form submission and
+ * the radiogroup semantics come from the platform; read-only ratings are one labelled image.
+ * Contract: read-only A11Y-3; radiogroup A11Y-3 FOCUS-2 CONTROL-STATE-3; option FOCUS-1; glyph ICON-6.
+ */
+export declare const Rating: ({ label, value, defaultValue, onChange, max, isReadOnly, isDisabled, valueLabel, icon, name, className, }: RatingProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/Rating/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGvD,MAAM,MAAM,WAAW,GAAG;IACtB,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iGAAiG;IACjG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IAC3D,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAcD;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,2GAYpB,WAAW,gCAoEb,CAAA"}

package/dist/core/primitive/Rating/index.js

@@ -0,0 +1,37 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId, useState } from "react";
+import { navigationClassName } from "../../navigationClassNames.js";
+const StarGlyph = () => (_jsx("svg", { "aria-hidden": "true", focusable: "false", viewBox: "0 0 24 24", className: "starci-core-rating-glyph", "data-contract": "ICON-6", children: _jsx("path", { d: "M12 2.8l2.8 5.9 6.4.8-4.7 4.4 1.2 6.3L12 17.1l-5.7 3.1 1.2-6.3-4.7-4.4 6.4-.8z" }) }));
+const fillFor = (position, value) => {
+    if (value >= position)
+        return "full";
+    if (value >= position - 0.5)
+        return "half";
+    return "empty";
+};
+/**
+ * A 1..max rating. Interactive ratings are a native radio set, so arrow keys, form submission and
+ * the radiogroup semantics come from the platform; read-only ratings are one labelled image.
+ * Contract: read-only A11Y-3; radiogroup A11Y-3 FOCUS-2 CONTROL-STATE-3; option FOCUS-1; glyph ICON-6.
+ */
+export const Rating = ({ label, value, defaultValue = 0, onChange, max = 5, isReadOnly = false, isDisabled = false, valueLabel, icon, name, className, }) => {
+    const [uncontrolled, setUncontrolled] = useState(defaultValue);
+    const [preview, setPreview] = useState(null);
+    const generatedName = useId();
+    const current = value ?? uncontrolled;
+    const positions = Array.from({ length: max }, (_, index) => index + 1);
+    const glyph = icon ?? _jsx(StarGlyph, {});
+    if (isReadOnly) {
+        return (_jsx("span", { "aria-label": `${label}: ${valueLabel(current, max)}`, className: navigationClassName("starci-core-rating", className), "data-component": "Rating", "data-tier": "atom", "data-contract": "A11Y-3", "data-grammar-rating-mode": "read-only", role: "img", children: positions.map((position) => (_jsx("span", { className: "starci-core-rating-item", "data-grammar-rating-fill": fillFor(position, current), children: glyph }, position))) }));
+    }
+    const shown = preview ?? current;
+    const select = (next) => {
+        if (value === undefined)
+            setUncontrolled(next);
+        onChange?.(next);
+    };
+    return (_jsx("span", { "aria-disabled": isDisabled || undefined, "aria-label": label, className: navigationClassName("starci-core-rating", className), "data-component": "Rating", "data-tier": "atom", "data-contract": "A11Y-3 FOCUS-2 CONTROL-STATE-3", "data-grammar-rating-mode": "interactive", "data-grammar-disabled": isDisabled ? "true" : "false", onPointerLeave: () => setPreview(null), role: "radiogroup", children: positions.map((position) => (_jsxs("label", { className: "starci-core-rating-item", "data-contract": "FOCUS-1", "data-grammar-rating-fill": fillFor(position, shown), "data-grammar-selected": Math.round(current) === position ? "true" : "false", onPointerEnter: () => { if (!isDisabled)
+                setPreview(position); }, children: [_jsx("input", { "aria-label": valueLabel(position, max), checked: Math.round(current) === position, className: "starci-core-rating-input", disabled: isDisabled, name: name ?? generatedName, onChange: () => select(position), type: "radio", value: position }), glyph] }, position))) }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/Rating/index.js.map

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

package/dist/core/primitive/SearchField/index.d.ts

@@ -0,0 +1,22 @@
+import { type FieldControlProps } from "../Field/index.js";
+export type SearchFieldProps = FieldControlProps & {
+    readonly id?: string;
+    readonly placeholder?: string;
+    readonly value?: string;
+    readonly defaultValue?: string;
+    readonly onValueChange?: (value: string) => void;
+    /** Enter in the field. */
+    readonly onSubmit?: (value: string) => void;
+    /** The clear button or Escape emptied the field. */
+    readonly onClear?: () => void;
+    /** Results for the current query are loading. The field stays editable. */
+    readonly isPending?: boolean;
+    /** Accessible name of the clear button. Pass the app's localized "clear" copy. */
+    readonly clearLabel?: string;
+};
+/**
+ * A text field whose job is a query: `type="search"`, a clear button, Escape to clear, Enter to
+ * submit - all the vendor's. The leading glyph is decoration; the label is the name.
+ */
+export declare const SearchField: ({ id, placeholder, value, defaultValue, onValueChange, onSubmit, onClear, isPending, clearLabel, ...field }: SearchFieldProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/primitive/SearchField/index.tsx"],"names":[],"mappings":"AAGA,OAAO,EAKH,KAAK,iBAAiB,EACzB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG;IAC/C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC/B,CAAA;AAQD;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,6GAWzB,gBAAgB,gCAgClB,CAAA"}

package/dist/core/primitive/SearchField/index.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SearchField as HeroSearchField, Spinner as HeroSpinner } from "@heroui/react";
+import { FieldDescription, FieldErrorText, FieldLabel, vendorFieldProps, } from "../Field/index.js";
+/*
+ * Consumer hook: `starci-core-search-field` names this control's root for a consumer or family
+ * stylesheet. No shipped sheet paints it: the root is drawn as a whole by `.starci-core-field`, so
+ * a rule on the hook adds to the shared anatomy and never has to replace it.
+ */
+/**
+ * A text field whose job is a query: `type="search"`, a clear button, Escape to clear, Enter to
+ * submit - all the vendor's. The leading glyph is decoration; the label is the name.
+ */
+export const SearchField = ({ id, placeholder, value, defaultValue, onValueChange, onSubmit, onClear, isPending = false, clearLabel, ...field }) => (_jsxs(HeroSearchField, { "data-tier": "atom", "data-component": "SearchField", "data-contract": "A11Y-1 FIELD-1 FIELD-2 CONTROL-STATE-2", className: "starci-core-field starci-core-search-field", fullWidth: true, ...vendorFieldProps({ ...field, isPending }), isReadOnly: field.isReadOnly === true, ...(value === undefined ? defaultValue === undefined ? {} : { defaultValue } : { value }), ...(onValueChange === undefined ? {} : { onChange: onValueChange }), ...(onSubmit === undefined ? {} : { onSubmit }), ...(onClear === undefined ? {} : { onClear }), children: [_jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsxs(HeroSearchField.Group, { className: "starci-core-search-field-group", "data-grammar-field-control": "true", children: [_jsx(HeroSearchField.SearchIcon, { "aria-hidden": "true" }), _jsx(HeroSearchField.Input, { ...(id === undefined ? {} : { id }), ...(placeholder === undefined ? {} : { placeholder }), className: "starci-core-search-field-input", ...(isPending ? { "aria-busy": true } : {}) }), isPending ? _jsx(HeroSpinner, { size: "sm", color: "current", "aria-hidden": "true", className: "starci-core-field-spinner" }) : null, _jsx(HeroSearchField.ClearButton, { className: "starci-core-search-field-clear", ...(clearLabel === undefined ? {} : { "aria-label": clearLabel }) })] }), _jsx(FieldDescription, { children: field.description }), _jsx(FieldErrorText, { children: field.errorMessage })] }));
+//# sourceMappingURL=index.js.map

package/dist/core/primitive/SearchField/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/primitive/SearchField/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AACtF,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,gBAAgB,GAEnB,MAAM,mBAAmB,CAAA;AAkB1B;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EACxB,EAAE,EACF,WAAW,EACX,KAAK,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,OAAO,EACP,SAAS,GAAG,KAAK,EACjB,UAAU,EACV,GAAG,KAAK,EACO,EAAE,EAAE,CAAC,CACpB,MAAC,eAAe,iBACF,MAAM,oBACD,aAAa,mBACd,wCAAwC,EACtD,SAAS,EAAC,4CAA4C,EACtD,SAAS,WACL,gBAAgB,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC,EAC7C,UAAU,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,KACjC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KACtF,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,KAChE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAC5C,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,aAE9C,KAAC,UAAU,IAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,YAAG,KAAK,CAAC,KAAK,GAAc,EACnG,MAAC,eAAe,CAAC,KAAK,IAAC,SAAS,EAAC,gCAAgC,gCAA4B,MAAM,aAC/F,KAAC,eAAe,CAAC,UAAU,mBAAa,MAAM,GAAG,EACjD,KAAC,eAAe,CAAC,KAAK,OACd,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAChC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EACtD,SAAS,EAAC,gCAAgC,KACtC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAC9C,EACD,SAAS,CAAC,CAAC,CAAC,KAAC,WAAW,IAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,SAAS,iBAAa,MAAM,EAAC,SAAS,EAAC,2BAA2B,GAAG,CAAC,CAAC,CAAC,IAAI,EACtH,KAAC,eAAe,CAAC,WAAW,IACxB,SAAS,EAAC,gCAAgC,KACtC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,GACpE,IACkB,EACxB,KAAC,gBAAgB,cAAE,KAAK,CAAC,WAAW,GAAoB,EACxD,KAAC,cAAc,cAAE,KAAK,CAAC,YAAY,GAAkB,IACvC,CACrB,CAAA"}

package/dist/core/primitive/SectionHeader/index.d.ts

@@ -4,12 +4,19 @@ export type SectionHeaderProps = {
     readonly description?: ReactNode;
     readonly eyebrow?: ReactNode;
     readonly action?: ReactNode;
-    readonly level?: 1 | 2 | 3 | 4;
+    /** Outline rank of the title. Default `2`; pick the rank that follows the heading above it. */
+    readonly level?: 1 | 2 | 3 | 4 | 5 | 6;
     readonly className?: string;
     readonly id?: string;
     /** Closed semantic anatomy; ContextIntro requires eyebrow, title and description. */
     readonly composition?: "section-header" | "context-intro";
 };
-/** Reusable title-copy-action hierarchy shared by StarCi product sections. */
+/**
+ * Reusable title-copy-action hierarchy shared by StarCi product sections.
+ *
+ * It renders a plain `div`, never `<header>`: outside a sectioning element a `<header>` is the page
+ * banner landmark, and the banner belongs to the application bar (TopBar / NavigationFeatureNav /
+ * WorkspaceShell header). A section heading group must not add a second one.
+ */
 export declare const SectionHeader: ({ title, description, eyebrow, action, level, className, id, composition, }: SectionHeaderProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map