@starci/grammar 0.4.12 → 0.5.0

package/dist/core/branch/Disclosure/index.js

@@ -0,0 +1,26 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Disclosure as HeroDisclosure } from "@heroui/react";
+import { useState } from "react";
+import { navigationClassName } from "../../navigationClassNames.js";
+/*
+ * Consumer hooks: `starci-core-disclosure-panel`, `starci-core-disclosure-body` name HeroUI parts
+ * whose vendor paint Common leaves as it is. No shipped sheet paints them; the Grammar name lets a
+ * consumer or family select those parts without reaching for vendor class names.
+ */
+/**
+ * One show/hide section (the generic, unframed disclosure; `SurfaceAccordionCard` is the framed
+ * card form). The trigger is a real button inside a heading with `aria-expanded`/`aria-controls`;
+ * `data-grammar-disclosure-state` mirrors the open state for the stylesheet.
+ * Contract: root STATE-7 (controlled expansion), trigger FOCUS-1, indicator MOTION-2.
+ */
+export const Disclosure = ({ title, children, isExpanded, defaultExpanded = false, onExpandedChange, isDisabled = false, headingLevel = 3, className, }) => {
+    const [uncontrolled, setUncontrolled] = useState(defaultExpanded);
+    const expanded = isExpanded ?? uncontrolled;
+    return (_jsxs(HeroDisclosure, { className: navigationClassName("starci-core-disclosure", className), "data-component": "Disclosure", "data-tier": "branch", "data-contract": "STATE-7", "data-grammar-disclosure-state": expanded ? "open" : "closed", isDisabled: isDisabled, isExpanded: expanded, onExpandedChange: (next) => {
+            if (isExpanded === undefined)
+                setUncontrolled(next);
+            onExpandedChange?.(next);
+        }, children: [_jsx(HeroDisclosure.Heading, { className: "starci-core-disclosure-heading", level: headingLevel, children: _jsxs(HeroDisclosure.Trigger, { className: "starci-core-disclosure-trigger", "data-contract": "FOCUS-1", "data-grammar-disclosure-trigger": "true", children: [_jsx("span", { className: "starci-core-disclosure-title", children: title }), _jsx(HeroDisclosure.Indicator, { className: "starci-core-disclosure-indicator", "data-contract": "MOTION-2" })] }) }), _jsx(HeroDisclosure.Content, { className: "starci-core-disclosure-panel", "data-grammar-disclosure-panel": "true", children: _jsx(HeroDisclosure.Body, { className: "starci-core-disclosure-body", children: children }) })] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/branch/Disclosure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Disclosure/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAgBnE;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,UAAU,EACV,eAAe,GAAG,KAAK,EACvB,gBAAgB,EAChB,UAAU,GAAG,KAAK,EAClB,YAAY,GAAG,CAAC,EAChB,SAAS,GACK,EAAE,EAAE;IAClB,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAA;IACjE,MAAM,QAAQ,GAAG,UAAU,IAAI,YAAY,CAAA;IAC3C,OAAO,CACH,MAAC,cAAc,IACX,SAAS,EAAE,mBAAmB,CAAC,wBAAwB,EAAE,SAAS,CAAC,oBACpD,YAAY,eACjB,QAAQ,mBACJ,SAAS,mCACQ,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAC3D,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,QAAQ,EACpB,gBAAgB,EAAE,CAAC,IAAa,EAAE,EAAE;YAChC,IAAI,UAAU,KAAK,SAAS;gBAAE,eAAe,CAAC,IAAI,CAAC,CAAA;YACnD,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC,aAED,KAAC,cAAc,CAAC,OAAO,IAAC,SAAS,EAAC,gCAAgC,EAAC,KAAK,EAAE,YAAY,YAClF,MAAC,cAAc,CAAC,OAAO,IAAC,SAAS,EAAC,gCAAgC,mBAAe,SAAS,qCAAiC,MAAM,aAC7H,eAAM,SAAS,EAAC,8BAA8B,YAAE,KAAK,GAAQ,EAC7D,KAAC,cAAc,CAAC,SAAS,IAAC,SAAS,EAAC,kCAAkC,mBAAe,UAAU,GAAG,IAC7E,GACJ,EACzB,KAAC,cAAc,CAAC,OAAO,IAAC,SAAS,EAAC,8BAA8B,mCAA+B,MAAM,YACjG,KAAC,cAAc,CAAC,IAAI,IAAC,SAAS,EAAC,6BAA6B,YAAE,QAAQ,GAAuB,GACxE,IACZ,CACpB,CAAA;AACL,CAAC,CAAA"}

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

@@ -0,0 +1,35 @@
+import { type ReactNode } from "react";
+import { type OverlayOpenState } from "../../overlayScope.js";
+import type { OverlayFooter } from "../Dialog/index.js";
+/** Edge the sheet slides from. `bottom` is the mobile bottom sheet. */
+export type DrawerPlacement = "left" | "right" | "top" | "bottom";
+export type DrawerProps = OverlayOpenState & {
+    /** Visible heading; the drawer dialog's accessible name. */
+    readonly title: string;
+    readonly description?: ReactNode;
+    readonly children?: ReactNode;
+    readonly footer?: OverlayFooter;
+    /** A Common `Button`/`IconButton` (any React Aria pressable) that opens the drawer. */
+    readonly trigger?: ReactNode;
+    readonly closeLabel?: string;
+    readonly placement?: DrawerPlacement;
+    /**
+     * Draw the grab handle. Default: shown for `bottom` sheets only. The handle is decorative
+     * (`aria-hidden`); dragging it past the threshold dismisses, the close button and Escape remain the
+     * accessible ways out.
+     */
+    readonly showHandle?: boolean;
+    /** Close on an outside press (and allow drag-to-dismiss). Default `true`. */
+    readonly isDismissable?: boolean;
+    readonly isKeyboardDismissDisabled?: boolean;
+};
+/**
+ * BRANCH - `Drawer`: a side sheet or mobile bottom sheet holding a secondary task.
+ *
+ * Same modal rules as `Dialog` (focus trap and return, Escape/outside dismiss, scroll lock, inert
+ * page, scoped portal). Placement is echoed on `data-placement` so anatomy and families can shape the
+ * sheet edge; the slide motion is removed under reduced motion.
+ * Contract: surface FOCUS-3 LAYOUT-4 CORE-BOUNDARY-4 (as `Dialog`); sliding content MOTION-2.
+ */
+export declare const Drawer: ({ title, description, children, footer, trigger, closeLabel, placement, showHandle, isDismissable, isKeyboardDismissDisabled, ...openState }: DrawerProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Drawer/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAEpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEjE,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAA;IACpC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;CAC/C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GAAI,8IAYpB,WAAW,gCAuDb,CAAA"}

package/dist/core/branch/Drawer/index.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Drawer as HeroDrawer } from "@heroui/react";
+import { useId } from "react";
+import { overlayOpenProps, useOverlayContainer } from "../../overlayScope.js";
+import { CloseButton } from "../../primitive/CloseButton/index.js";
+/**
+ * BRANCH - `Drawer`: a side sheet or mobile bottom sheet holding a secondary task.
+ *
+ * Same modal rules as `Dialog` (focus trap and return, Escape/outside dismiss, scroll lock, inert
+ * page, scoped portal). Placement is echoed on `data-placement` so anatomy and families can shape the
+ * sheet edge; the slide motion is removed under reduced motion.
+ * Contract: surface FOCUS-3 LAYOUT-4 CORE-BOUNDARY-4 (as `Dialog`); sliding content MOTION-2.
+ */
+export const Drawer = ({ title, description, children, footer, trigger, closeLabel, placement = "right", showHandle, isDismissable = true, isKeyboardDismissDisabled = false, ...openState }) => {
+    const { anchor, container } = useOverlayContainer("Drawer");
+    const descriptionId = useId();
+    const hasHandle = showHandle ?? placement === "bottom";
+    return (_jsxs(HeroDrawer, { ...overlayOpenProps(openState), children: [trigger, anchor, container === null ? null : (_jsx(HeroDrawer.Backdrop, { UNSTABLE_portalContainer: container, isDismissable: isDismissable, isKeyboardDismissDisabled: isKeyboardDismissDisabled, "data-grammar-overlay-backdrop": "Drawer", className: "starci-core-overlay-backdrop starci-core-drawer-backdrop", children: _jsx(HeroDrawer.Content, { placement: placement, "data-contract": "MOTION-2", className: "starci-core-drawer-content", children: _jsx(HeroDrawer.Dialog, { "data-tier": "branch", "data-component": "Drawer", "data-placement": placement, "data-grammar-overlay-surface": "drawer", "data-contract": "FOCUS-3 LAYOUT-4 CORE-BOUNDARY-4", ...(description === undefined ? {} : { "aria-describedby": descriptionId }), className: "starci-core-drawer", children: ({ close }) => (_jsxs(_Fragment, { children: [hasHandle ? _jsx(HeroDrawer.Handle, { "data-grammar-drawer-handle": "true", className: "starci-core-drawer-handle" }) : null, _jsxs(HeroDrawer.Header, { className: "starci-core-overlay-header", children: [_jsxs("div", { className: "starci-core-overlay-heading-group", children: [_jsx(HeroDrawer.Heading, { className: "starci-core-overlay-title", children: title }), description === undefined ? null : (_jsx("p", { id: descriptionId, className: "starci-core-overlay-description", children: description }))] }), closeLabel === undefined ? null : _jsx(CloseButton, { label: closeLabel, onPress: close })] }), children === undefined ? null : (_jsx(HeroDrawer.Body, { className: "starci-core-overlay-body", children: children })), footer === undefined ? null : (_jsx(HeroDrawer.Footer, { className: "starci-core-overlay-footer", children: typeof footer === "function" ? footer(close) : footer }))] })) }) }) }))] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/branch/Drawer/index.js.map

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

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

@@ -0,0 +1,61 @@
+import type { ReactNode } from "react";
+import { type OverlayOpenState } from "../../overlayScope.js";
+import { type IconSource } from "../../primitive/Icon/index.js";
+export type DropdownMenuItemTone = "neutral" | "negative";
+/** One command, destination or (inside a selectable section) checkable choice. */
+export type DropdownMenuItem = {
+    readonly kind?: "item";
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    /** Shortcut chord drawn with `Kbd`, e.g. `["command", "K"]`. Display only: the app binds the keys. */
+    readonly shortcut?: readonly string[];
+    readonly iconSource?: IconSource;
+    /** `negative` marks a destructive command. */
+    readonly tone?: DropdownMenuItemTone;
+    readonly isDisabled?: boolean;
+    /** A destination: the item renders a real link. */
+    readonly href?: string;
+    readonly onAction?: () => void;
+    /** Nested entries open as a submenu (ArrowRight / Enter / hover open it, ArrowLeft / Escape close it). */
+    readonly submenu?: readonly DropdownMenuEntry[];
+};
+/** Checkable items: `single` draws a dot (radio semantics), `multiple` a check (checkbox semantics). */
+export type DropdownMenuSelection = {
+    readonly mode: "single" | "multiple";
+    readonly selectedIds: readonly string[];
+    readonly onChange: (selectedIds: readonly string[]) => void;
+};
+export type DropdownMenuSection = {
+    readonly kind: "section";
+    readonly id: string;
+    /** Visible group heading; also the group's accessible name. */
+    readonly label?: string;
+    readonly items: readonly DropdownMenuItem[];
+    readonly selection?: DropdownMenuSelection;
+};
+export type DropdownMenuEntry = DropdownMenuItem | DropdownMenuSection;
+export type DropdownMenuPlacement = "bottom start" | "bottom end" | "top start" | "top end";
+export type DropdownMenuProps = OverlayOpenState & {
+    /**
+     * A Common `Button`/`IconButton` (any React Aria pressable) that opens the menu. It also NAMES the
+     * menu (`aria-labelledby`, the WAI-ARIA menu-button pattern), so give an icon trigger its label.
+     */
+    readonly trigger: ReactNode;
+    readonly entries: readonly DropdownMenuEntry[];
+    /** Called with the id of any activated item (after the item's own `onAction`). */
+    readonly onAction?: (id: string) => void;
+    readonly placement?: DropdownMenuPlacement;
+};
+/**
+ * BRANCH - `DropdownMenu`: a trigger-owned `role="menu"` of commands, links, checkable choices and
+ * submenus.
+ *
+ * React Aria owns the keyboard model (arrow keys, Home/End, typeahead, Enter/Space, ArrowRight into
+ * a submenu, Escape and outside press dismiss, focus returns to the trigger). The menu and every
+ * submenu portal into the nearest Grammar root so the family scope still applies.
+ * Contract: menu FOCUS-2 FOCUS-5; popover LAYOUT-4 CORE-BOUNDARY-4 MOTION-2; item FOCUS-1 CTA-2 (ring,
+ * link vs command); a selectable section CONTROL-STATE-3 (app-owned selectedIds).
+ */
+export declare const DropdownMenu: ({ trigger, entries, onAction, placement, ...openState }: DropdownMenuProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/DropdownMenu/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACpG,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAGrE,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,CAAA;AAEzD,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,sGAAsG;IACtG,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAA;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,0GAA0G;IAC1G,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAClD,CAAA;AAED,wGAAwG;AACxG,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAA;CAC9D,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,mBAAmB,CAAA;AAEtE,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAAA;AAE3F,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG;IAC/C;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAA;CAC7C,CAAA;AAeD;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,yDAM1B,iBAAiB,gCA8HnB,CAAA"}

package/dist/core/branch/DropdownMenu/index.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Description as HeroDescription, Dropdown as HeroDropdown, Header as HeroHeader } from "@heroui/react";
+import { overlayOpenProps, useOverlayContainer } from "../../overlayScope.js";
+import { Icon } from "../../primitive/Icon/index.js";
+import { Kbd } from "../../primitive/Kbd/index.js";
+const isSection = (entry) => entry.kind === "section";
+const collectItems = (entries, into = new Map()) => {
+    for (const entry of entries) {
+        if (isSection(entry))
+            collectItems(entry.items, into);
+        else {
+            into.set(entry.id, entry);
+            if (entry.submenu !== undefined)
+                collectItems(entry.submenu, into);
+        }
+    }
+    return into;
+};
+/**
+ * BRANCH - `DropdownMenu`: a trigger-owned `role="menu"` of commands, links, checkable choices and
+ * submenus.
+ *
+ * React Aria owns the keyboard model (arrow keys, Home/End, typeahead, Enter/Space, ArrowRight into
+ * a submenu, Escape and outside press dismiss, focus returns to the trigger). The menu and every
+ * submenu portal into the nearest Grammar root so the family scope still applies.
+ * Contract: menu FOCUS-2 FOCUS-5; popover LAYOUT-4 CORE-BOUNDARY-4 MOTION-2; item FOCUS-1 CTA-2 (ring,
+ * link vs command); a selectable section CONTROL-STATE-3 (app-owned selectedIds).
+ */
+export const DropdownMenu = ({ trigger, entries, onAction, placement = "bottom start", ...openState }) => {
+    const { anchor, container } = useOverlayContainer("DropdownMenu");
+    const items = collectItems(entries);
+    const handleAction = (key) => {
+        const id = String(key);
+        items.get(id)?.onAction?.();
+        onAction?.(id);
+    };
+    const renderItem = (item, selectionMode) => {
+        const tone = item.tone ?? "neutral";
+        const content = (_jsxs(_Fragment, { children: [selectionMode === undefined ? null : (_jsx(HeroDropdown.ItemIndicator, { type: selectionMode === "single" ? "dot" : "checkmark", className: "starci-core-menu-indicator" })), item.iconSource === undefined ? null : _jsx(Icon, { source: item.iconSource, usage: "leading" }), _jsxs("span", { className: "starci-core-menu-item-copy", children: [_jsx("span", { className: "starci-core-menu-item-label", children: item.label }), item.description === undefined ? null : (_jsx(HeroDescription, { className: "starci-core-menu-item-description", children: item.description }))] }), item.shortcut === undefined ? null : (_jsx("span", { className: "starci-core-menu-item-shortcut", "data-grammar-menu-shortcut": "true", children: _jsx(Kbd, { keys: item.shortcut }) })), item.submenu === undefined ? null : _jsx(HeroDropdown.SubmenuIndicator, { className: "starci-core-menu-submenu-indicator" })] }));
+        const itemElement = (_jsx(HeroDropdown.Item, { id: item.id, textValue: item.label, "aria-label": item.label, variant: tone === "negative" ? "danger" : "default", isDisabled: item.isDisabled ?? false, ...(item.href === undefined ? {} : { href: item.href }), "data-grammar-menu-item": "true", "data-contract": "FOCUS-1 CTA-2", "data-grammar-tone": tone, className: "starci-core-menu-item", children: content }, item.id));
+        if (item.submenu === undefined)
+            return itemElement;
+        return (_jsxs(HeroDropdown.SubmenuTrigger, { children: [itemElement, _jsx(HeroDropdown.Popover, { "data-grammar-overlay-surface": "menu", "data-contract": "LAYOUT-4 CORE-BOUNDARY-4 MOTION-2", className: "starci-core-menu-popover", children: _jsx(HeroDropdown.Menu, { "aria-label": item.label, onAction: handleAction, "data-component": "DropdownMenu", "data-grammar-menu-depth": "submenu", "data-contract": "FOCUS-2 FOCUS-5", className: "starci-core-menu", children: renderEntries(item.submenu) }) })] }, item.id));
+    };
+    const renderEntries = (list) => list.map((entry) => {
+        if (!isSection(entry))
+            return renderItem(entry);
+        const selection = entry.selection;
+        return (_jsxs(HeroDropdown.Section, { id: entry.id, ...(entry.label === undefined ? {} : { "aria-label": entry.label }), ...(selection === undefined ? {} : {
+                selectionMode: selection.mode,
+                selectedKeys: new Set(selection.selectedIds),
+                onSelectionChange: (keys) => {
+                    selection.onChange(keys === "all" ? entry.items.map((item) => item.id) : Array.from(keys, String));
+                },
+            }), "data-grammar-menu-section": "true", "data-contract": selection === undefined ? undefined : "CONTROL-STATE-3", className: "starci-core-menu-section", children: [entry.label === undefined ? null : _jsx(HeroHeader, { className: "starci-core-menu-section-label", children: entry.label }), entry.items.map((item) => renderItem(item, selection?.mode))] }, entry.id));
+    });
+    return (_jsxs(HeroDropdown, { ...overlayOpenProps(openState), children: [trigger, anchor, container === null ? null : (_jsx(HeroDropdown.Popover, { UNSTABLE_portalContainer: container, placement: placement, "data-grammar-overlay-surface": "menu", "data-contract": "LAYOUT-4 CORE-BOUNDARY-4 MOTION-2", className: "starci-core-menu-popover", children: _jsx(HeroDropdown.Menu, { onAction: handleAction, "data-tier": "branch", "data-component": "DropdownMenu", "data-grammar-menu-depth": "root", "data-contract": "FOCUS-2 FOCUS-5", className: "starci-core-menu", children: renderEntries(entries) }) }))] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/branch/DropdownMenu/index.js.map

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

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

@@ -0,0 +1,30 @@
+import type { ReactNode } from "react";
+export type ListBoxItem = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: ReactNode;
+    readonly leading?: ReactNode;
+    readonly trailing?: ReactNode;
+    readonly isDisabled?: boolean;
+};
+export type ListBoxProps = {
+    /** Names the list, e.g. "Members". */
+    readonly label: string;
+    readonly items: ReadonlyArray<ListBoxItem>;
+    /** `none` makes an actionable (not selectable) list; rows then only fire `onAction`. */
+    readonly selectionMode?: "none" | "single" | "multiple";
+    readonly selectedIds?: ReadonlyArray<string>;
+    readonly defaultSelectedIds?: ReadonlyArray<string>;
+    readonly onSelectionChange?: (ids: ReadonlyArray<string>) => void;
+    readonly onAction?: (id: string) => void;
+    readonly emptyContent?: ReactNode;
+    readonly className?: string;
+};
+/**
+ * A list of selectable or actionable rows (`role="listbox"`). Arrow keys, Home/End and typeahead
+ * move between rows; Space/Enter select. Each row exposes `data-grammar-selected` and the
+ * vendor `aria-selected`; long labels truncate and descriptions wrap at narrow widths.
+ * Contract: list FOCUS-2 CONTROL-STATE-3, empty STATE-3, leading glyph ICON-6.
+ */
+export declare const ListBox: ({ label, items, selectionMode, selectedIds, defaultSelectedIds, onSelectionChange, onAction, emptyContent, className, }: ListBoxProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/ListBox/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,MAAM,WAAW,GAAG;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAA;IAC1C,wFAAwF;IACxF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC5C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,yHAUrB,YAAY,gCAwCd,CAAA"}

package/dist/core/branch/ListBox/index.js

@@ -0,0 +1,14 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ListBox as HeroListBox } from "@heroui/react";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * A list of selectable or actionable rows (`role="listbox"`). Arrow keys, Home/End and typeahead
+ * move between rows; Space/Enter select. Each row exposes `data-grammar-selected` and the
+ * vendor `aria-selected`; long labels truncate and descriptions wrap at narrow widths.
+ * Contract: list FOCUS-2 CONTROL-STATE-3, empty STATE-3, leading glyph ICON-6.
+ */
+export const ListBox = ({ label, items, selectionMode = "single", selectedIds, defaultSelectedIds, onSelectionChange, onAction, emptyContent, className, }) => (_jsx(HeroListBox, { "aria-label": label, className: navigationClassName("starci-core-list-box", className), "data-component": "ListBox", "data-contract": "FOCUS-2 CONTROL-STATE-3", "data-tier": "branch", "data-grammar-list-selection": selectionMode, selectionMode: selectionMode, ...(selectedIds === undefined ? {} : { selectedKeys: new Set(selectedIds) }), ...(defaultSelectedIds === undefined ? {} : { defaultSelectedKeys: new Set(defaultSelectedIds) }), ...(onSelectionChange === undefined ? {} : {
+        onSelectionChange: (selection) => onSelectionChange(selection === "all" ? items.map((item) => item.id) : [...selection].map(String)),
+    }), ...(onAction === undefined ? {} : { onAction: (key) => onAction(String(key)) }), ...(emptyContent === undefined ? {} : { renderEmptyState: () => _jsx("div", { className: "starci-core-list-box-empty", "data-contract": "STATE-3", "data-grammar-list-empty": "true", children: emptyContent }) }), children: items.map((item) => (_jsx(HeroListBox.Item, { id: item.id, className: "starci-core-list-box-item", "data-grammar-list-item": "true", textValue: item.label, ...(item.isDisabled === undefined ? {} : { isDisabled: item.isDisabled }), children: ({ isSelected }) => (_jsxs("span", { className: "starci-core-list-box-row", "data-grammar-selected": isSelected ? "true" : "false", children: [item.leading === undefined ? null : _jsx("span", { "aria-hidden": "true", className: "starci-core-list-box-leading", "data-contract": "ICON-6", children: item.leading }), _jsxs("span", { className: "starci-core-list-box-copy", children: [_jsx("span", { className: "starci-core-list-box-label", children: item.label }), item.description === undefined ? null : _jsx("span", { className: "starci-core-list-box-description", children: item.description })] }), item.trailing === undefined ? null : _jsx("span", { className: "starci-core-list-box-trailing", children: item.trailing }), selectionMode === "none" ? null : _jsx(HeroListBox.ItemIndicator, { className: "starci-core-list-box-indicator" })] })) }, item.id))) }));
+//# sourceMappingURL=index.js.map

package/dist/core/branch/ListBox/index.js.map

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

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

@@ -7,6 +7,12 @@ export type MarkdownArticleProps = {
 type FencedCodeBlockFrameProps = {
     readonly language?: string;
     readonly action?: ReactNode;
+    /**
+     * Accessible name of the scrolling code region (e.g. "Install command"). Defaults to
+     * `language`. Authored code scrolls inline and is plain text, so its `<pre>` is a Tab stop
+     * (WCAG 2.1.1); a name makes it a `role="region"` a screen reader can announce.
+     */
+    readonly label?: string;
 };
 type AuthoredCodeProps = {
     readonly code: string;
@@ -19,6 +25,8 @@ type RenderedCodeProps = {
 export type FencedCodeBlockProps = FencedCodeBlockFrameProps & (AuthoredCodeProps | RenderedCodeProps);
 export type MarkdownTableFrameProps = {
     readonly children: ReactNode;
+    /** Accessible name of the scrolling frame; with it the frame is a `role="region"`. */
+    readonly label?: string;
 };
 /** Own the business-neutral reading rhythm for one semantic Markdown document. */
 export declare const MarkdownArticle: (props: MarkdownArticleProps) => import("react").JSX.Element;

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

@@ -1 +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,gCAgB1D,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,GAAI,OAAO,uBAAuB,gCAOhE,CAAA"}
+{"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;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B,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;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAQD,kFAAkF;AAClF,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,gCAQ1D,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,gCAgB1D,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,GAAI,OAAO,uBAAuB,gCAQhE,CAAA"}

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

@@ -1,12 +1,17 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { fencedCodeBlockClassName, fencedCodeHeaderClassName, markdownArticleClassName, markdownTableFrameClassName } from "./classNames.js";
+/** Keyboard reachability for an inline-scrolling reading frame whose content is plain text. */
+const scrollFrameProps = (label) => ({
+    tabIndex: 0,
+    ...(label === undefined ? {} : { role: "region", "aria-label": label }),
+});
 /** Own the business-neutral reading rhythm for one semantic Markdown document. */
 export const MarkdownArticle = (props) => (_jsx("div", { "aria-label": props.ariaLabel, className: markdownArticleClassName, "data-grammar-markdown-measure": props.measure ?? "reading", children: props.children }));
 /** Own bounded code overflow while allowing a caller-supplied neutral action such as Copy. */
 export const FencedCodeBlock = (props) => {
-    const body = "children" in props ? props.children : _jsx("pre", { children: _jsx("code", { children: props.code }) });
+    const body = "children" in props ? props.children : _jsx("pre", { ...scrollFrameProps(props.label ?? props.language), children: _jsx("code", { children: props.code }) });
     return (_jsxs("div", { className: fencedCodeBlockClassName, "data-contract": "OVERFLOW-4", children: [props.language === undefined && props.action === undefined ? null : (_jsxs("div", { className: fencedCodeHeaderClassName, children: [props.language === undefined ? _jsx("span", {}) : _jsx("span", { children: props.language }), props.action] })), body] }));
 };
 /** Keep a vendor-rendered table inside the same bounded reading frame as semantic tables. */
-export const MarkdownTableFrame = (props) => (_jsx("div", { className: markdownTableFrameClassName, "data-contract": "OVERFLOW-4", children: props.children }));
+export const MarkdownTableFrame = (props) => (_jsx("div", { className: markdownTableFrameClassName, "data-contract": "OVERFLOW-4", ...scrollFrameProps(props.label), children: props.children }));
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/MarkdownArticle/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AA6B5I,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE,CAAC,CAC5D,4BACgB,KAAK,CAAC,SAAS,EAC3B,SAAS,EAAE,wBAAwB,mCACJ,KAAK,CAAC,OAAO,IAAI,SAAS,YAExD,KAAK,CAAC,QAAQ,GACb,CACT,CAAA;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE;IAC3D,MAAM,IAAI,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAK,yBAAO,KAAK,CAAC,IAAI,GAAQ,GAAM,CAAA;IACxF,OAAO,CACH,eACI,SAAS,EAAE,wBAAwB,mBACrB,YAAY,aAEzB,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACjE,eAAK,SAAS,EAAE,yBAAyB,aACpC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAQ,CAAC,CAAC,CAAC,yBAAO,KAAK,CAAC,QAAQ,GAAQ,EACvE,KAAK,CAAC,MAAM,IACX,CACT,EACA,IAAI,IACH,CACT,CAAA;AACL,CAAC,CAAA;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAA8B,EAAE,EAAE,CAAC,CAClE,cACI,SAAS,EAAE,2BAA2B,mBACxB,YAAY,YAEzB,KAAK,CAAC,QAAQ,GACb,CACT,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/MarkdownArticle/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAqC5I,+FAA+F;AAC/F,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAE,EAAE,CAAC,CAAC;IACrD,QAAQ,EAAE,CAAC;IACX,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;CAC1E,CAAC,CAAA;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE,CAAC,CAC5D,4BACgB,KAAK,CAAC,SAAS,EAC3B,SAAS,EAAE,wBAAwB,mCACJ,KAAK,CAAC,OAAO,IAAI,SAAS,YAExD,KAAK,CAAC,QAAQ,GACb,CACT,CAAA;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAA2B,EAAE,EAAE;IAC3D,MAAM,IAAI,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAS,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAE,yBAAO,KAAK,CAAC,IAAI,GAAQ,GAAM,CAAA;IAC7I,OAAO,CACH,eACI,SAAS,EAAE,wBAAwB,mBACrB,YAAY,aAEzB,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACjE,eAAK,SAAS,EAAE,yBAAyB,aACpC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAQ,CAAC,CAAC,CAAC,yBAAO,KAAK,CAAC,QAAQ,GAAQ,EACvE,KAAK,CAAC,MAAM,IACX,CACT,EACA,IAAI,IACH,CACT,CAAA;AACL,CAAC,CAAA;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAA8B,EAAE,EAAE,CAAC,CAClE,cACI,SAAS,EAAE,2BAA2B,mBACxB,YAAY,KACtB,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,YAEhC,KAAK,CAAC,QAAQ,GACb,CACT,CAAA"}

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

@@ -0,0 +1,33 @@
+import type { ReactNode } from "react";
+import { type OverlayOpenState } from "../../overlayScope.js";
+/** Side of the trigger the panel opens on; it flips when the viewport has no room. */
+export type PopoverPlacement = "top" | "bottom" | "start" | "end";
+type PopoverBase = OverlayOpenState & {
+    /** A Common `Button`/`IconButton` (any React Aria pressable) that toggles the panel. */
+    readonly trigger: ReactNode;
+    readonly children: ReactNode;
+    readonly placement?: PopoverPlacement;
+    /** Draw the pointer arrow toward the trigger. Default `false`. */
+    readonly showArrow?: boolean;
+};
+/** A popover is a non-modal dialog, so it needs a name: a visible title or an accessible label. */
+type TitledPopover = {
+    readonly title: string;
+    readonly label?: never;
+};
+type LabelledPopover = {
+    readonly label: string;
+    readonly title?: never;
+};
+export type PopoverProps = PopoverBase & (TitledPopover | LabelledPopover);
+/**
+ * BRANCH - `Popover`: rich, interactive content anchored to a trigger.
+ *
+ * Unlike `Tooltip` (a description), a popover holds focusable content. React Aria moves focus into
+ * the panel, contains Tab while open, dismisses on Escape or an outside press, and returns focus to
+ * the trigger. The panel portals into the nearest Grammar root so the family scope still applies.
+ * Contract: panel LAYOUT-4 CORE-BOUNDARY-4 MOTION-2 (portal, shadow, reduced motion); dialog FOCUS-3.
+ */
+export declare const Popover: ({ trigger, children, placement, showArrow, title, label, ...openState }: PopoverProps) => import("react").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Popover/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAEpG,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;AAEjE,KAAK,WAAW,GAAG,gBAAgB,GAAG;IAClC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAA;IACrC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED,mGAAmG;AACnG,KAAK,aAAa,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AACvE,KAAK,eAAe,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAEzE,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,CAAC,aAAa,GAAG,eAAe,CAAC,CAAA;AAE1E;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,GAAI,yEAQrB,YAAY,gCAmCd,CAAA"}

package/dist/core/branch/Popover/index.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Popover as HeroPopover } from "@heroui/react";
+import { overlayOpenProps, useOverlayContainer } from "../../overlayScope.js";
+/**
+ * BRANCH - `Popover`: rich, interactive content anchored to a trigger.
+ *
+ * Unlike `Tooltip` (a description), a popover holds focusable content. React Aria moves focus into
+ * the panel, contains Tab while open, dismisses on Escape or an outside press, and returns focus to
+ * the trigger. The panel portals into the nearest Grammar root so the family scope still applies.
+ * Contract: panel LAYOUT-4 CORE-BOUNDARY-4 MOTION-2 (portal, shadow, reduced motion); dialog FOCUS-3.
+ */
+export const Popover = ({ trigger, children, placement = "bottom", showArrow = false, title, label, ...openState }) => {
+    const { anchor, container } = useOverlayContainer("Popover");
+    return (_jsxs(HeroPopover, { ...overlayOpenProps(openState), children: [trigger, anchor, container === null ? null : (_jsxs(HeroPopover.Content, { UNSTABLE_portalContainer: container, placement: placement, offset: 8, "data-grammar-overlay-surface": "popover", "data-contract": "LAYOUT-4 CORE-BOUNDARY-4 MOTION-2", className: "starci-core-popover", children: [showArrow ? (_jsx(HeroPopover.Arrow, { className: "starci-core-popover-arrow", "data-grammar-popover-arrow": "true" })) : null, _jsxs(HeroPopover.Dialog, { "data-tier": "branch", "data-component": "Popover", "data-contract": "FOCUS-3", ...(label === undefined ? {} : { "aria-label": label }), className: "starci-core-popover-dialog", children: [title === undefined ? null : (_jsx(HeroPopover.Heading, { className: "starci-core-overlay-title", children: title })), _jsx("div", { className: "starci-core-popover-body", children: children })] })] }))] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/branch/Popover/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Popover/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAyB,MAAM,uBAAuB,CAAA;AAoBpG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EACpB,OAAO,EACP,QAAQ,EACR,SAAS,GAAG,QAAQ,EACpB,SAAS,GAAG,KAAK,EACjB,KAAK,EACL,KAAK,EACL,GAAG,SAAS,EACD,EAAE,EAAE;IACf,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAE5D,OAAO,CACH,MAAC,WAAW,OAAK,gBAAgB,CAAC,SAAS,CAAC,aACvC,OAAO,EACP,MAAM,EACN,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACzB,MAAC,WAAW,CAAC,OAAO,IAChB,wBAAwB,EAAE,SAAS,EACnC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,CAAC,kCACoB,SAAS,mBACxB,mCAAmC,EACjD,SAAS,EAAC,qBAAqB,aAE9B,SAAS,CAAC,CAAC,CAAC,CACT,KAAC,WAAW,CAAC,KAAK,IAAC,SAAS,EAAC,2BAA2B,gCAA4B,MAAM,GAAG,CAChG,CAAC,CAAC,CAAC,IAAI,EACR,MAAC,WAAW,CAAC,MAAM,iBACL,QAAQ,oBACH,SAAS,mBACV,SAAS,KACnB,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EACxD,SAAS,EAAC,4BAA4B,aAErC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,KAAC,WAAW,CAAC,OAAO,IAAC,SAAS,EAAC,2BAA2B,YAAE,KAAK,GAAuB,CAC3F,EACD,cAAK,SAAS,EAAC,0BAA0B,YAAE,QAAQ,GAAO,IACzC,IACH,CACzB,IACS,CACjB,CAAA;AACL,CAAC,CAAA"}

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

@@ -23,6 +23,8 @@ export type RailProps = (ComplementaryRailProps | ContentNavigationRailProps) &
     readonly isLabelHidden?: boolean;
     /** Grammar-owned content inset. `content` is exactly px-3 py-6. */
     readonly inset?: "none" | "content";
+    /** Outline rank of the rail's (possibly visually hidden) name. Default 2: a peer of the page's sections. */
+    readonly headingLevel?: 2 | 3 | 4 | 5 | 6;
 };
 export declare const Rail: (props: RailProps) => import("react").JSX.Element;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAG9F,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CACtC,CAAA;AAED,KAAK,0BAA0B,GAAG;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,sBAAsB,GAAG,0BAA0B,CAAC,GAAG;IAC5E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IACnD,sFAAsF;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,gCAiEpC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC5D,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAG9F,KAAK,sBAAsB,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;CACtC,CAAA;AAED,KAAK,0BAA0B,GAAG;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,sBAAsB,GAAG,0BAA0B,CAAC,GAAG;IAC5E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAA;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IACnD,sFAAsF;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,4GAA4G;IAC5G,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;CAC5C,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,OAAO,SAAS,gCA0EpC,CAAA"}

package/dist/core/branch/Rail/index.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useId } from "react";
+import { createElement, useId } from "react";
 import { assertPresentationState, treatmentFor } from "../../state.js";
 import { railBodyClassName, railClassName, railFooterClassName, railFrameClassName } from "./classNames.js";
 export const Rail = (props) => {
-    const { label, landmark = "complementary", children, footer, height = "content", mode = "flow", width = "standard", state = "neutral", collapse = "expanded", motion = "static", isLabelHidden = false, inset = "none", } = props;
+    const { label, landmark = "complementary", children, footer, height = "content", mode = "flow", width = "standard", state = "neutral", collapse = "expanded", motion = "static", isLabelHidden = false, inset = "none", headingLevel = 2, } = props;
     assertPresentationState(state);
     const headingId = useId();
     const treatment = treatmentFor(state);
@@ -16,7 +16,14 @@ export const Rail = (props) => {
         height === "fill" ? "MEASURE-6" : "OVERFLOW-3",
         inset === "content" ? "PADDING-3 PADDING-5" : null,
     ].filter(Boolean).join(" ");
-    const frame = (_jsxs("div", { className: railFrameClassName, "data-contract": "GAP-4", "data-grammar-rail-frame": "true", children: [landmark === "content-navigation" ? null : _jsx("h2", { className: isLabelHidden ? "starci-core-visually-hidden" : undefined, "data-grammar-rail-heading": "true", id: headingId, children: label }), _jsx("div", { className: railBodyClassName, "data-grammar-rail-body": "true", "data-grammar-rail-inset": inset, ...(bodyContract === "" ? {} : { "data-contract": bodyContract }), children: children }), footer === undefined ? null : (_jsx("div", { className: railFooterClassName, "data-grammar-rail-footer": "true", children: footer }))] }));
+    /*
+     * At height="content" the body is the rail's scroll owner (`overflow-y: auto`), so it must be
+     * reachable without a pointer (WCAG 2.1.1, axe `scrollable-region-focusable`): a Tab stop named
+     * by the rail heading. A `fill` body clips instead of scrolling and a content-navigation body
+     * scrolls links that are themselves focusable, so neither adds a stop.
+     */
+    const isScrollOwner = height === "content" && landmark !== "content-navigation";
+    const frame = (_jsxs("div", { className: railFrameClassName, "data-contract": "GAP-4", "data-grammar-rail-frame": "true", children: [landmark === "content-navigation" ? null : createElement(`h${headingLevel}`, { className: isLabelHidden ? "starci-core-visually-hidden" : undefined, "data-grammar-rail-heading": "true", id: headingId }, label), _jsx("div", { className: railBodyClassName, "data-grammar-rail-body": "true", "data-grammar-rail-inset": inset, ...(isScrollOwner ? { "aria-labelledby": headingId, role: "region", tabIndex: 0 } : {}), ...(bodyContract === "" ? {} : { "data-contract": bodyContract }), children: children }), footer === undefined ? null : (_jsx("div", { className: railFooterClassName, "data-grammar-rail-footer": "true", children: footer }))] }));
     const shared = {
         className: railClassName,
         "data-grammar-collapse": collapse,

package/dist/core/branch/Rail/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAA;AAC9F,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AA6B3G,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAgB,EAAE,EAAE;IACrC,MAAM,EACF,KAAK,EACL,QAAQ,GAAG,eAAe,EAC1B,QAAQ,EACR,MAAM,EACN,MAAM,GAAG,SAAS,EAClB,IAAI,GAAG,MAAM,EACb,KAAK,GAAG,UAAU,EAClB,KAAK,GAAG,SAAS,EACjB,QAAQ,GAAG,UAAU,EACrB,MAAM,GAAG,QAAQ,EACjB,aAAa,GAAG,KAAK,EACrB,KAAK,GAAG,MAAM,GACjB,GAAG,KAAK,CAAA;IACT,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,CAAA;IACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAErC,MAAM,YAAY,GAAG;QACjB,8EAA8E;QAC9E,mEAAmE;QACnE,oFAAoF;QACpF,oFAAoF;QACpF,sBAAsB;QACtB,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY;QAC9C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI;KACrD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAE3B,MAAM,KAAK,GAAG,CACV,eAAK,SAAS,EAAE,kBAAkB,mBAAgB,OAAO,6BAAyB,MAAM,aACnF,QAAQ,KAAK,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAI,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,SAAS,+BAA4B,MAAM,EAAC,EAAE,EAAE,SAAS,YAAG,KAAK,GAAM,EAClL,cACI,SAAS,EAAE,iBAAiB,4BACL,MAAM,6BACJ,KAAK,KAC1B,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC,YACpE,QAAQ,GAAO,EAChB,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3B,cAAK,SAAS,EAAE,mBAAmB,8BAA2B,MAAM,YAAE,MAAM,GAAO,CACtF,IACC,CACT,CAAA;IACD,MAAM,MAAM,GAAG;QACX,SAAS,EAAE,aAAa;QACxB,uBAAuB,EAAE,QAAQ;QACjC,uBAAuB,EAAE,QAAQ;QACjC,0BAA0B,EAAE,MAAM;QAClC,qBAAqB,EAAE,MAAM;QAC7B,mBAAmB,EAAE,MAAM;QAC3B,wBAAwB,EAAE,IAAI;QAC9B,yBAAyB,EAAE,KAAK;QAChC,oBAAoB,EAAE,KAAK;QAC3B,wBAAwB,EAAE,SAAS,CAAC,IAAI;KAClC,CAAA;IAEV,IAAI,QAAQ,KAAK,oBAAoB;QAAE,OAAO,iBAAS,MAAM,YAAG,KAAK,GAAO,CAAA;IAC5E,OAAO,CACH,mCACqB,SAAS,KACtB,MAAM,YAET,KAAK,GACF,CACX,CAAA;AACL,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/branch/Rail/index.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+import { type ReactNode } from "react";
+import { type FieldControlProps } from "../../primitive/Field/index.js";
+/** One choice in a list-backed control. `label` is plain text because it is also the typeahead value. */
+export type ListOption = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: ReactNode;
+    readonly isDisabled?: boolean;
+};
+export type SelectProps = FieldControlProps & {
+    readonly options: ReadonlyArray<ListOption>;
+    readonly placeholder?: string;
+    readonly value?: string | null;
+    readonly defaultValue?: string | null;
+    readonly onValueChange?: (value: string | null) => void;
+    /** Options are still arriving. The trigger stays named and focusable, announces pending, and does not open. */
+    readonly isPending?: boolean;
+};
+/** Renders the options as vendor list-box items with the selected-state indicator. */
+export declare const ListOptions: ({ options }: {
+    readonly options: ReadonlyArray<ListOption>;
+}) => import("react").JSX.Element;
+/**
+ * A single choice from a closed list, opened from a field-shaped trigger.
+ *
+ * Keyboard, typeahead, listbox semantics and focus return are the vendor's. Read-only keeps the
+ * trigger focusable and announced but holds the value and never opens the list; the vendor select
+ * has no read-only mode of its own.
+ */
+export declare const Select: ({ options, placeholder, value, defaultValue, onValueChange, isPending, ...field }: SelectProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/branch/Select/index.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAChD,OAAO,EAMH,KAAK,iBAAiB,EACzB,MAAM,gCAAgC,CAAA;AAEvC,yGAAyG;AACzG,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,iBAAiB,GAAG;IAC1C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACvD,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AAID,sFAAsF;AACtF,eAAO,MAAM,WAAW,GAAI,aAAa;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAAE,gCAqBvF,CAAA;AAeD;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAAI,mFAQpB,WAAW,gCA4Cb,CAAA"}

package/dist/core/branch/Select/index.js

@@ -0,0 +1,41 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { ListBox as HeroListBox, Select as HeroSelect, Spinner as HeroSpinner, } from "@heroui/react";
+import { useState } from "react";
+import { FieldDescription, FieldErrorText, FieldLabel, useGrammarPortal, vendorFieldProps, } from "../../primitive/Field/index.js";
+const toValue = (key) => (key === null ? null : String(key));
+/** Renders the options as vendor list-box items with the selected-state indicator. */
+export const ListOptions = ({ options }) => (_jsx(_Fragment, { children: options.map((option) => (_jsxs(HeroListBox.Item, { id: option.id, textValue: option.label, isDisabled: option.isDisabled === true, className: "starci-core-list-option", "data-grammar-option": "true", children: [_jsxs("span", { className: "starci-core-list-option-copy", children: [_jsx("span", { className: "starci-core-list-option-label", children: option.label }), option.description == null ? null : (_jsx("span", { className: "starci-core-list-option-description", children: option.description }))] }), _jsx(HeroListBox.ItemIndicator, {})] }, option.id))) }));
+/*
+ * Consumer hook: `starci-core-select` 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.
+ */
+/*
+ * Consumer hooks: `starci-core-select-indicator`, `starci-core-list-popover`, `starci-core-list`
+ * name HeroUI parts whose vendor paint Common leaves as it is. No shipped sheet paints them; the
+ * Grammar name lets a consumer or family select those parts without reaching for vendor class
+ * names.
+ */
+/**
+ * A single choice from a closed list, opened from a field-shaped trigger.
+ *
+ * Keyboard, typeahead, listbox semantics and focus return are the vendor's. Read-only keeps the
+ * trigger focusable and announced but holds the value and never opens the list; the vendor select
+ * has no read-only mode of its own.
+ */
+export const Select = ({ options, placeholder, value, defaultValue, onValueChange, isPending = false, ...field }) => {
+    const [heldValue] = useState(value ?? defaultValue ?? null);
+    const { anchor, portalProps } = useGrammarPortal();
+    const readOnly = field.isReadOnly === true;
+    const selection = readOnly
+        ? { value: value === undefined ? heldValue : value }
+        : value === undefined ? defaultValue === undefined ? {} : { defaultValue } : { value };
+    return (_jsxs(HeroSelect, { "data-tier": "branch", "data-component": "Select", "data-contract": "A11Y-1 FIELD-3 STATE-6 CONTROL-STATE-2", className: "starci-core-field starci-core-select", fullWidth: true, ...vendorFieldProps({ ...field, isPending }), ...(placeholder === undefined ? {} : { placeholder }), ...selection, ...(readOnly ? { isOpen: false } : {}), onChange: (key) => {
+            if (!readOnly)
+                onValueChange?.(toValue(key));
+        }, children: [anchor, _jsx(FieldLabel, { isHidden: field.isLabelHidden, isRequired: field.isRequired, children: field.label }), _jsxs(HeroSelect.Trigger, { className: "starci-core-select-trigger", "data-grammar-field-control": "true", isPending: isPending, children: [_jsx(HeroSelect.Value, { className: "starci-core-select-value" }), isPending
+                        ? _jsx(HeroSpinner, { size: "sm", color: "current", "aria-hidden": "true", className: "starci-core-field-spinner" })
+                        : _jsx(HeroSelect.Indicator, { className: "starci-core-select-indicator" })] }), _jsx(FieldDescription, { children: field.description }), _jsx(FieldErrorText, { children: field.errorMessage }), _jsx(HeroSelect.Popover, { className: "starci-core-list-popover", "data-grammar-popover": "Select", "data-contract": "LAYOUT-4", ...portalProps, children: _jsx(HeroListBox, { className: "starci-core-list", children: _jsx(ListOptions, { options: options }) }) })] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/branch/Select/index.js.map

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