@starci/grammar 0.4.12 → 0.5.0

package/dist/core/composite/VerticalScrollRegion/index.d.ts

@@ -1,10 +1,40 @@
-import type { ComponentProps, ReactNode } from "react";
+import { type ComponentProps, type ReactNode } from "react";
+/**
+ * Which overflow answer this region gives for its one axis.
+ *
+ * `always` is the region standing on its own: the block axis scrolls, full stop (OVERFLOW-3).
+ * `needed` is that same one axis scrolling only where the content actually overflows (OVERFLOW-4).
+ * The region is the node that carries the stamp, so the owner has to be able to say which of the two
+ * it is; a `data-contract` passed in was, and still is, silently replaced by this element's own.
+ */
+export type VerticalScrollRegionOverflow = "always" | "needed";
 export type VerticalScrollRegionProps = Omit<ComponentProps<"div">, "children"> & {
     readonly children: ReactNode;
     readonly isScrollable: boolean;
+    /**
+     * The element the region renders when it is NOT scrollable. A list owner passes `ul`/`ol` so its
+     * `<li>` rows have a real list parent; when scrollable the region is HeroUI's ScrollShadow `div`,
+     * and the owner gives it `role="list"` instead.
+     */
+    readonly as?: "div" | "ul" | "ol";
+    /**
+     * Keyboard reachability of a scrolling region (WCAG 2.1.1, axe `scrollable-region-focusable`).
+     * Default `true`: a scrollable region joins the Tab order (`tabIndex=0`) so its content can be
+     * scrolled without a pointer, and a region named by `aria-label`/`aria-labelledby` is exposed as
+     * `role="region"` unless the owner passes its own role. Pass `false` only when every scrolled
+     * item is itself focusable (a tab strip, an input group), so the region adds no empty stop.
+     */
+    readonly isFocusable?: boolean;
     /** Hide scrollbar chrome by default while retaining wheel, touch and keyboard scrolling. */
     readonly hideScrollBar?: boolean;
+    /** The region's own overflow answer; the stamp and the render both follow it. */
+    readonly overflow?: VerticalScrollRegionOverflow;
 };
+/**
+ * The attributes that make a scrolling region keyboard-reachable and, when named, a navigable
+ * region. Shared by every Common scroll owner so the rule is stated once.
+ */
+export declare const scrollRegionFocusProps: (props: Pick<ComponentProps<"div">, "aria-label" | "aria-labelledby" | "role" | "tabIndex">, isFocusable: boolean) => Pick<ComponentProps<"div">, "role" | "tabIndex">;
 /** Use HeroUI's Vertical ScrollShadow without making consumers own its DOM contract. */
 export declare const VerticalScrollRegion: (props: VerticalScrollRegionProps) => import("react").JSX.Element;
 //# sourceMappingURL=index.d.ts.map

package/dist/core/composite/VerticalScrollRegion/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtD,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACnC,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,GAAI,OAAO,yBAAyB,gCAKpE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG1E;;;;;;;GAOG;AACH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE9D,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAAA;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,4BAA4B,CAAA;CACnD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,iBAAiB,GAAG,MAAM,GAAG,UAAU,CAAC,EAC1F,aAAa,OAAO,KACrB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAKjD,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,GAAI,OAAO,yBAAyB,gCAMpE,CAAA"}

package/dist/core/composite/VerticalScrollRegion/index.js

@@ -1,10 +1,23 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { createElement } from "react";
 import { ScrollShadow } from "@heroui/react";
+/**
+ * The attributes that make a scrolling region keyboard-reachable and, when named, a navigable
+ * region. Shared by every Common scroll owner so the rule is stated once.
+ */
+export const scrollRegionFocusProps = (props, isFocusable) => {
+    if (!isFocusable)
+        return {};
+    const isNamed = props["aria-label"] !== undefined || props["aria-labelledby"] !== undefined;
+    const role = props.role ?? (isNamed ? "region" : undefined);
+    return { tabIndex: props.tabIndex ?? 0, ...(role === undefined ? {} : { role }) };
+};
 /** Use HeroUI's Vertical ScrollShadow without making consumers own its DOM contract. */
 export const VerticalScrollRegion = (props) => {
-    const { children, isScrollable, hideScrollBar = true, ...regionProps } = props;
+    const { children, isScrollable, as: Element = "div", isFocusable = true, hideScrollBar = true, overflow = "always", ...regionProps } = props;
+    const contract = overflow === "needed" ? "MEASURE-7 OVERFLOW-4" : "MEASURE-7 OVERFLOW-3";
     return isScrollable
-        ? _jsx(ScrollShadow, { ...regionProps, "data-contract": "MEASURE-7 OVERFLOW-3", hideScrollBar: hideScrollBar, orientation: "vertical", children: children })
-        : _jsx("div", { ...regionProps, children: children });
+        ? _jsx(ScrollShadow, { ...regionProps, ...scrollRegionFocusProps(regionProps, isFocusable), "data-contract": contract, "data-grammar-overflow": overflow, "data-grammar-scroll-region": "vertical", hideScrollBar: hideScrollBar, orientation: "vertical", children: children })
+        : createElement(Element, regionProps, children);
 };
 //# sourceMappingURL=index.js.map

package/dist/core/composite/VerticalScrollRegion/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAS5C,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAgC,EAAE,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,CAAA;IAC9E,OAAO,YAAY;QACf,CAAC,CAAC,KAAC,YAAY,OAAK,WAAW,mBAAgB,sBAAsB,EAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAC,UAAU,YAAE,QAAQ,GAAgB;QACpJ,CAAC,CAAC,iBAAS,WAAW,YAAG,QAAQ,GAAO,CAAA;AAChD,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composite/VerticalScrollRegion/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAuC,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAmC5C;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAClC,KAA0F,EAC1F,WAAoB,EAC4B,EAAE;IAClD,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAA;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,iBAAiB,CAAC,KAAK,SAAS,CAAA;IAC3F,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC3D,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AACrF,CAAC,CAAA;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAgC,EAAE,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,GAAG,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,KAAK,CAAA;IAC5I,MAAM,QAAQ,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,sBAAsB,CAAA;IACxF,OAAO,YAAY;QACf,CAAC,CAAC,KAAC,YAAY,OAAK,WAAW,KAAM,sBAAsB,CAAC,WAAW,EAAE,WAAW,CAAC,mBAAiB,QAAQ,2BAAyB,QAAQ,gCAA6B,UAAU,EAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAC,UAAU,YAAE,QAAQ,GAAgB;QACrQ,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;AACvD,CAAC,CAAA"}

package/dist/core/composition/BottomNav/index.d.ts

@@ -0,0 +1,33 @@
+import type { ReactNode } from "react";
+export type BottomNavItem = {
+    readonly id: string;
+    readonly label: string;
+    /** App-owned glyph; decorative, the label names the destination. */
+    readonly icon: ReactNode;
+    /** A real destination. Without it the item is a same-document button driven by `onSelect`. */
+    readonly href?: string;
+    /** Small count or dot; pass `badgeLabel` so it is announced. */
+    readonly badge?: ReactNode;
+    readonly badgeLabel?: string;
+    readonly isDisabled?: boolean;
+};
+export type BottomNavProps = {
+    /** Names the landmark, e.g. "Primary". */
+    readonly label: string;
+    readonly items: ReadonlyArray<BottomNavItem>;
+    readonly currentId: string;
+    readonly onSelect?: (id: string) => void;
+    /** `fixed` pins the bar to the viewport bottom above the device safe area. */
+    readonly position?: "fixed" | "static";
+    /** `compact` hides the bar from 48rem up, where a sidebar or top bar takes over. */
+    readonly visibility?: "compact" | "always";
+    readonly className?: string;
+};
+/**
+ * The mobile tab bar: 3-5 primary destinations with icon + label, a 44px minimum target, the
+ * device safe-area inset, and `aria-current="page"` plus `data-grammar-current` on the current
+ * destination. Left/Right/Home/End move between items; every item also stays in the Tab order.
+ * Contract: nav LAYOUT-4 (fixed bar), list FOCUS-2, item FOCUS-1 ACTION-3 (anchor vs button), icon ICON-6.
+ */
+export declare const BottomNav: ({ label, items, currentId, onSelect, position, visibility, className }: BottomNavProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composition/BottomNav/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/BottomNav/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAIrD,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IACtC,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,wEAA8F,cAAc,gCAwCrI,CAAA"}

package/dist/core/composition/BottomNav/index.js

@@ -0,0 +1,22 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { moveFocusBetweenPeers } from "../../navigationKeys.js";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * The mobile tab bar: 3-5 primary destinations with icon + label, a 44px minimum target, the
+ * device safe-area inset, and `aria-current="page"` plus `data-grammar-current` on the current
+ * destination. Left/Right/Home/End move between items; every item also stays in the Tab order.
+ * Contract: nav LAYOUT-4 (fixed bar), list FOCUS-2, item FOCUS-1 ACTION-3 (anchor vs button), icon ICON-6.
+ */
+export const BottomNav = ({ label, items, currentId, onSelect, position = "fixed", visibility = "compact", className }) => (_jsx("nav", { "aria-label": label, className: navigationClassName("starci-core-bottom-nav", className), "data-component": "BottomNav", "data-contract": "LAYOUT-4", "data-tier": "composition", "data-grammar-bottom-nav-position": position, "data-grammar-bottom-nav-visibility": visibility, style: { "--starci-core-bottom-nav-count": String(Math.max(1, items.length)) }, children: _jsx("ul", { className: "starci-core-bottom-nav-list", "data-contract": "FOCUS-2", onKeyDown: (event) => { moveFocusBetweenPeers(event, "[data-grammar-bottom-nav-item]", "horizontal"); }, children: items.map((item) => {
+            const isCurrent = item.id === currentId;
+            const shared = {
+                "aria-current": isCurrent ? "page" : undefined,
+                className: "starci-core-bottom-nav-item",
+                "data-grammar-bottom-nav-item": "true",
+                "data-grammar-current": isCurrent ? "true" : "false",
+            };
+            const content = _jsxs(_Fragment, { children: [_jsxs("span", { "aria-hidden": "true", className: "starci-core-bottom-nav-icon", "data-contract": "ICON-6", children: [item.icon, item.badge === undefined ? null : _jsx("span", { className: "starci-core-bottom-nav-badge", "data-grammar-bottom-nav-badge": "true", children: item.badge })] }), _jsx("span", { className: "starci-core-bottom-nav-label", children: item.label }), item.badgeLabel === undefined ? null : _jsx("span", { className: "starci-core-nav-visually-hidden", children: `, ${item.badgeLabel}` })] });
+            return (_jsx("li", { className: "starci-core-bottom-nav-slot", children: item.href !== undefined && item.isDisabled !== true ? (_jsx("a", { ...shared, "data-contract": "FOCUS-1 ACTION-3", href: item.href, onClick: () => onSelect?.(item.id), children: content })) : (_jsx("button", { ...shared, "data-contract": "FOCUS-1 ACTION-3", disabled: item.isDisabled === true, onClick: () => onSelect?.(item.id), type: "button", children: content })) }, item.id));
+        }) }) }));
+//# sourceMappingURL=index.js.map

package/dist/core/composition/BottomNav/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/BottomNav/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAGZ,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AA4BnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAAE,UAAU,GAAG,SAAS,EAAE,SAAS,EAAkB,EAAE,EAAE,CAAC,CACvI,4BACgB,KAAK,EACjB,SAAS,EAAE,mBAAmB,CAAC,wBAAwB,EAAE,SAAS,CAAC,oBACpD,WAAW,mBACZ,UAAU,eACd,aAAa,sCACW,QAAQ,wCACN,UAAU,EAC9C,KAAK,EAAE,EAAE,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAmB,YAE/F,aAAI,SAAS,EAAC,6BAA6B,mBAAe,SAAS,EAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,qBAAqB,CAAC,KAAK,EAAE,gCAAgC,EAAE,YAAY,CAAC,CAAA,CAAC,CAAC,YACrK,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,KAAK,SAAS,CAAA;YACvC,MAAM,MAAM,GAAG;gBACX,cAAc,EAAE,SAAS,CAAC,CAAC,CAAE,MAAgB,CAAC,CAAC,CAAC,SAAS;gBACzD,SAAS,EAAE,6BAA6B;gBACxC,8BAA8B,EAAE,MAAM;gBACtC,sBAAsB,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;aACvD,CAAA;YACD,MAAM,OAAO,GAAG,8BACZ,+BAAkB,MAAM,EAAC,SAAS,EAAC,6BAA6B,mBAAe,QAAQ,aAClF,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,8BAA8B,mCAA+B,MAAM,YAAE,IAAI,CAAC,KAAK,GAAQ,IACvI,EACP,eAAM,SAAS,EAAC,8BAA8B,YAAE,IAAI,CAAC,KAAK,GAAQ,EACjE,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,iCAAiC,YAAE,KAAK,IAAI,CAAC,UAAU,EAAE,GAAQ,IAC1H,CAAA;YACH,OAAO,CACH,aAAkB,SAAS,EAAC,6BAA6B,YACpD,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CACnD,eAAO,MAAM,mBAAgB,kBAAkB,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,YAAG,OAAO,GAAK,CACrH,CAAC,CAAC,CAAC,CACA,oBAAY,MAAM,mBAAgB,kBAAkB,EAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAC,QAAQ,YAAE,OAAO,GAAU,CAChK,IALI,IAAI,CAAC,EAAE,CAMX,CACR,CAAA;QACL,CAAC,CAAC,GACD,GACH,CACT,CAAA"}

package/dist/core/composition/Footer/index.d.ts

@@ -0,0 +1,35 @@
+import { type ReactNode } from "react";
+import { type LinkKind } from "../../primitive/Link/index.js";
+export type FooterLink = {
+    readonly id: string;
+    readonly label: string;
+    readonly href: string;
+    readonly kind?: LinkKind;
+    readonly isCurrent?: boolean;
+};
+export type FooterLinkGroup = {
+    readonly id: string;
+    readonly label: string;
+    readonly links: ReadonlyArray<FooterLink>;
+};
+export type FooterProps = {
+    /** Names the footer's link landmark, e.g. "Footer". Required when `groups` are present. */
+    readonly label?: string;
+    /** App-owned identity and short statement. */
+    readonly brand?: ReactNode;
+    readonly groups?: ReadonlyArray<FooterLinkGroup>;
+    /** Legal line, copyright, locale switcher: the closing row. */
+    readonly legal?: ReactNode;
+    /** App-owned assistive hint for external links, e.g. that they open a new tab. */
+    readonly externalHint?: string;
+    readonly children?: ReactNode;
+    readonly className?: string;
+};
+/**
+ * The page footer (`<footer>`, the contentinfo landmark at page level): brand, grouped link
+ * directories that reflow from columns to one column at narrow widths, free content and a legal
+ * row. Links are Common `Link`s, so the current page keeps `aria-current="page"`.
+ * Contract: directory HIERARCHY-3 (reflow keeps source order), link list A11Y-4 CTA-2 (named list of destinations).
+ */
+export declare const Footer: ({ label, brand, groups, legal, externalHint, children, className }: FooterProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composition/Footer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/Footer/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAGnE,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACtB,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,oEAAyE,WAAW,gCA4C1G,CAAA"}

package/dist/core/composition/Footer/index.js

@@ -0,0 +1,19 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+import { Link } from "../../primitive/Link/index.js";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * The page footer (`<footer>`, the contentinfo landmark at page level): brand, grouped link
+ * directories that reflow from columns to one column at narrow widths, free content and a legal
+ * row. Links are Common `Link`s, so the current page keeps `aria-current="page"`.
+ * Contract: directory HIERARCHY-3 (reflow keeps source order), link list A11Y-4 CTA-2 (named list of destinations).
+ */
+export const Footer = ({ label, brand, groups = [], legal, externalHint, children, className }) => {
+    const idPrefix = useId();
+    return (_jsxs("footer", { className: navigationClassName("starci-core-footer", className), "data-component": "Footer", "data-tier": "composition", children: [brand === undefined && groups.length === 0 && children === undefined ? null : (_jsxs("div", { className: "starci-core-footer-main", children: [brand === undefined ? null : _jsx("div", { className: "starci-core-footer-brand", "data-grammar-footer-brand": "true", children: brand }), groups.length === 0 ? null : (_jsx("nav", { "aria-label": label, className: "starci-core-footer-directory", "data-contract": "HIERARCHY-3", "data-grammar-footer-directory": "true", children: groups.map((group) => {
+                            const headingId = `${idPrefix}-${group.id}`;
+                            return (_jsxs("div", { className: "starci-core-footer-group", "data-grammar-footer-group": "true", children: [_jsx("p", { className: "starci-core-footer-group-label", id: headingId, children: group.label }), _jsx("ul", { "aria-labelledby": headingId, className: "starci-core-footer-links", "data-contract": "A11Y-4 CTA-2", children: group.links.map((link) => (_jsx("li", { children: _jsx(Link, { href: link.href, isCurrent: link.isCurrent === true, kind: link.kind ?? "internal", visited: "uniform", ...(externalHint === undefined ? {} : { externalHint }), children: link.label }) }, link.id))) })] }, group.id));
+                        }) })), children] })), legal === undefined ? null : _jsx("div", { className: "starci-core-footer-legal", "data-grammar-footer-legal": "true", children: legal })] }));
+};
+//# sourceMappingURL=index.js.map

package/dist/core/composition/Footer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/Footer/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,KAAK,EAAkB,MAAM,OAAO,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAiB,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AA8BnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAe,EAAE,EAAE;IAC3G,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAA;IACxB,OAAO,CACH,kBACI,SAAS,EAAE,mBAAmB,CAAC,oBAAoB,EAAE,SAAS,CAAC,oBAChD,QAAQ,eACb,aAAa,aAEtB,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3E,eAAK,SAAS,EAAC,yBAAyB,aACnC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,0BAA0B,+BAA2B,MAAM,YAAE,KAAK,GAAO,EACrH,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC1B,4BAAiB,KAAK,EAAE,SAAS,EAAC,8BAA8B,mBAAe,aAAa,mCAA+B,MAAM,YAC5H,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;4BAClB,MAAM,SAAS,GAAG,GAAG,QAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,CAAA;4BAC3C,OAAO,CACH,eAAoB,SAAS,EAAC,0BAA0B,+BAA2B,MAAM,aACrF,YAAG,SAAS,EAAC,gCAAgC,EAAC,EAAE,EAAE,SAAS,YAAG,KAAK,CAAC,KAAK,GAAK,EAC9E,gCAAqB,SAAS,EAAE,SAAS,EAAC,0BAA0B,mBAAe,cAAc,YAC5F,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACvB,uBACI,KAAC,IAAI,IACD,IAAI,EAAE,IAAI,CAAC,IAAI,EACf,SAAS,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,EAClC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,EAC7B,OAAO,EAAC,SAAS,KACb,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,YAEvD,IAAI,CAAC,KAAK,GACR,IATF,IAAI,CAAC,EAAE,CAUX,CACR,CAAC,GACD,KAhBC,KAAK,CAAC,EAAE,CAiBZ,CACT,CAAA;wBACL,CAAC,CAAC,GACA,CACT,EACA,QAAQ,IACP,CACT,EACA,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,0BAA0B,+BAA2B,MAAM,YAAE,KAAK,GAAO,IACjH,CACZ,CAAA;AACL,CAAC,CAAA"}

package/dist/core/composition/NavigationFeatureNav/index.d.ts

@@ -34,6 +34,9 @@ export type NavigationFeatureNavProps = Omit<ComponentPropsWithoutRef<"header">,
  * The composition owns the single outer separator: the primary and feature
  * layers are intentionally continuous. Deeper responsive navigation belongs
  * to the independent Subnav branch instead of becoming a third navbar layer.
+ *
+ * Landmark rule: this `<header>` is the page's one banner. In `WorkspaceShell`'s `header` slot the
+ * shell yields its own `<header>` for a plain `div`, so the banner is never nested or duplicated.
  */
 export declare const NavigationFeatureNav: ({ identity, navigation, navigationLabel, compactNavigationTrigger, compactNavigationTriggerLabel, actions, actionsLabel, featureNavigation, featureNavigationLabel, measure, position, className, ...headerProps }: NavigationFeatureNavProps) => import("react").JSX.Element;
 export {};

package/dist/core/composition/NavigationFeatureNav/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/NavigationFeatureNav/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAChE,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAW/F;;;;;;GAMG;AACH,KAAK,cAAc,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAA;AAC1F,KAAK,iBAAiB,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAE9F,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,cAAc,GAAG,iBAAiB,CAAC,GAAG;IAClI,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,wBAAwB,EAAE,SAAS,CAAA;IAC5C,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAA;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,qGAAqG;IACrG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAA;IACtC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAC1C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,oNAclC,yBAAyB,gCA8C3B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/NavigationFeatureNav/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAChE,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAW/F;;;;;;GAMG;AACH,KAAK,cAAc,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAA;AAC1F,KAAK,iBAAiB,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAE9F,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,cAAc,GAAG,iBAAiB,CAAC,GAAG;IAClI,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,wBAAwB,EAAE,SAAS,CAAA;IAC5C,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAA;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,qGAAqG;IACrG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAA;IACtC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAC1C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAAI,oNAclC,yBAAyB,gCA8C3B,CAAA"}

package/dist/core/composition/NavigationFeatureNav/index.js

@@ -8,6 +8,9 @@ import { navigationFeatureNavActionsClassName, navigationFeatureNavClassName, na
  * The composition owns the single outer separator: the primary and feature
  * layers are intentionally continuous. Deeper responsive navigation belongs
  * to the independent Subnav branch instead of becoming a third navbar layer.
+ *
+ * Landmark rule: this `<header>` is the page's one banner. In `WorkspaceShell`'s `header` slot the
+ * shell yields its own `<header>` for a plain `div`, so the banner is never nested or duplicated.
  */
 export const NavigationFeatureNav = ({ identity, navigation, navigationLabel, compactNavigationTrigger, compactNavigationTriggerLabel, actions, actionsLabel, featureNavigation, featureNavigationLabel, measure = "full", position = "sticky", className, ...headerProps }) => (_jsxs("header", { ...headerProps, className: cn(navigationFeatureNavClassName, className), "data-contract": "MEASURE-2 BOUNDARY-1", "data-grammar-navigation-feature-nav": "true", "data-grammar-navigation-feature-nav-destinations": navigation === undefined ? "absent" : "present", "data-grammar-navigation-feature-nav-layers": featureNavigation === undefined ? "one" : "two", "data-grammar-navigation-feature-nav-position": position, children: [_jsxs(PageContainer, { className: navigationFeatureNavPrimaryClassName, "data-contract": "GAP-3 PADDING-3", "data-grammar-navigation-feature-nav-primary": "true", measure: measure, children: [_jsx("div", { className: navigationFeatureNavIdentityClassName, "data-grammar-navigation-feature-nav-identity": "true", children: identity }), navigation === undefined ? null : (_jsx("nav", { "aria-label": navigationLabel, className: navigationFeatureNavNavigationClassName, "data-grammar-navigation-feature-nav-navigation": "true", children: navigation })), _jsx("div", { "aria-label": compactNavigationTriggerLabel, className: navigationFeatureNavCompactNavigationClassName, "data-grammar-navigation-feature-nav-compact-navigation": "true", role: "group", children: compactNavigationTrigger }), actions === undefined ? null : (_jsx("div", { "aria-label": actionsLabel, className: navigationFeatureNavActionsClassName, "data-contract": "GAP-2", "data-grammar-navigation-feature-nav-actions": "true", role: actionsLabel === undefined ? undefined : "group", children: actions }))] }), featureNavigation === undefined ? null : (_jsx("div", { "aria-label": featureNavigationLabel, className: navigationFeatureNavFeatureClassName, "data-grammar-navigation-feature-nav-feature": "true", role: featureNavigationLabel === undefined ? undefined : "region", children: featureNavigation }))] }));
 //# sourceMappingURL=index.js.map

package/dist/core/composition/NavigationFeatureNav/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/NavigationFeatureNav/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,OAAO,EAAE,aAAa,EAA2B,MAAM,wCAAwC,CAAA;AAC/F,OAAO,EACH,oCAAoC,EACpC,6BAA6B,EAC7B,8CAA8C,EAC9C,oCAAoC,EACpC,qCAAqC,EACrC,uCAAuC,EACvC,oCAAoC,GACvC,MAAM,iBAAiB,CAAA;AA0BxB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EACjC,QAAQ,EACR,UAAU,EACV,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,OAAO,GAAG,MAAM,EAChB,QAAQ,GAAG,QAAQ,EACnB,SAAS,EACT,GAAG,WAAW,EACU,EAAE,EAAE,CAAC,CAC7B,qBACQ,WAAW,EACf,SAAS,EAAE,EAAE,CAAC,6BAA6B,EAAE,SAAS,CAAC,mBACzC,sBAAsB,yCACA,MAAM,sDACQ,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,gDACrD,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,kDAC7C,QAAQ,aAEtD,MAAC,aAAa,IAAC,SAAS,EAAE,oCAAoC,mBAAgB,iBAAiB,iDAA6C,MAAM,EAAC,OAAO,EAAE,OAAO,aAC/J,cAAK,SAAS,EAAE,qCAAqC,kDAA+C,MAAM,YAAE,QAAQ,GAAO,EAC1H,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC/B,4BAAiB,eAAe,EAAE,SAAS,EAAE,uCAAuC,oDAAiD,MAAM,YAAE,UAAU,GAAO,CACjK,EACD,4BACgB,6BAA6B,EACzC,SAAS,EAAE,8CAA8C,4DACF,MAAM,EAC7D,IAAI,EAAC,OAAO,YAEX,wBAAwB,GACvB,EACL,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC5B,4BACgB,YAAY,EACxB,SAAS,EAAE,oCAAoC,mBACjC,OAAO,iDACuB,MAAM,EAClD,IAAI,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,YAErD,OAAO,GACN,CACT,IACW,EACf,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACtC,4BACgB,sBAAsB,EAClC,SAAS,EAAE,oCAAoC,iDACH,MAAM,EAClD,IAAI,EAAE,sBAAsB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,YAEhE,iBAAiB,GAChB,CACT,IACI,CACZ,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/NavigationFeatureNav/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAElC,OAAO,EAAE,aAAa,EAA2B,MAAM,wCAAwC,CAAA;AAC/F,OAAO,EACH,oCAAoC,EACpC,6BAA6B,EAC7B,8CAA8C,EAC9C,oCAAoC,EACpC,qCAAqC,EACrC,uCAAuC,EACvC,oCAAoC,GACvC,MAAM,iBAAiB,CAAA;AA0BxB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EACjC,QAAQ,EACR,UAAU,EACV,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,OAAO,GAAG,MAAM,EAChB,QAAQ,GAAG,QAAQ,EACnB,SAAS,EACT,GAAG,WAAW,EACU,EAAE,EAAE,CAAC,CAC7B,qBACQ,WAAW,EACf,SAAS,EAAE,EAAE,CAAC,6BAA6B,EAAE,SAAS,CAAC,mBACzC,sBAAsB,yCACA,MAAM,sDACQ,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,gDACrD,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,kDAC7C,QAAQ,aAEtD,MAAC,aAAa,IAAC,SAAS,EAAE,oCAAoC,mBAAgB,iBAAiB,iDAA6C,MAAM,EAAC,OAAO,EAAE,OAAO,aAC/J,cAAK,SAAS,EAAE,qCAAqC,kDAA+C,MAAM,YAAE,QAAQ,GAAO,EAC1H,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC/B,4BAAiB,eAAe,EAAE,SAAS,EAAE,uCAAuC,oDAAiD,MAAM,YAAE,UAAU,GAAO,CACjK,EACD,4BACgB,6BAA6B,EACzC,SAAS,EAAE,8CAA8C,4DACF,MAAM,EAC7D,IAAI,EAAC,OAAO,YAEX,wBAAwB,GACvB,EACL,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC5B,4BACgB,YAAY,EACxB,SAAS,EAAE,oCAAoC,mBACjC,OAAO,iDACuB,MAAM,EAClD,IAAI,EAAE,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,YAErD,OAAO,GACN,CACT,IACW,EACf,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACtC,4BACgB,sBAAsB,EAClC,SAAS,EAAE,oCAAoC,iDACH,MAAM,EAClD,IAAI,EAAE,sBAAsB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,YAEhE,iBAAiB,GAChB,CACT,IACI,CACZ,CAAA"}

package/dist/core/composition/TopBar/index.d.ts

@@ -0,0 +1,34 @@
+import type { ComponentPropsWithoutRef, ReactNode } from "react";
+export type TopBarMenu = {
+    readonly icon: ReactNode;
+    readonly openLabel: string;
+    readonly closeLabel: string;
+    readonly isOpen: boolean;
+    readonly onOpenChange: (isOpen: boolean) => void;
+    /** Id of the drawer/menu region the trigger opens (`aria-controls`). */
+    readonly controls?: string;
+    /** `compact` shows the trigger only below 48rem, where `navigation` leaves the bar. */
+    readonly visibility?: "compact" | "always";
+};
+export type TopBarProps = Omit<ComponentPropsWithoutRef<"header">, "children" | "title"> & {
+    /** App-owned identity (logo, product name) - usually a link home. */
+    readonly brand: ReactNode;
+    /** Primary destinations shown inline at wide widths (e.g. a `<nav>` of `Link`s). */
+    readonly navigation?: ReactNode;
+    /** Trailing actions: search, notifications, account. They stay visible at every width. */
+    readonly actions?: ReactNode;
+    /** The mobile menu trigger. */
+    readonly menu?: TopBarMenu;
+    readonly position?: "static" | "sticky";
+};
+/**
+ * The application bar (`<header>`, the banner landmark at page level): brand, inline navigation,
+ * actions and a menu trigger that replaces the inline navigation below 48rem. The trigger reports
+ * `aria-expanded`; the drawer it opens stays app/overlay-owned.
+ *
+ * Landmark rule: a page has ONE banner, and the app bar owns it. Hosted in `WorkspaceShell`'s
+ * `header` slot, the shell yields (its wrapper becomes a plain `div`) so the banner is never nested.
+ * Contract: menu trigger A11Y-2 ICON-5 STATE-7 (named glyph button, app-owned aria-expanded).
+ */
+export declare const TopBar: ({ brand, navigation, actions, menu, position, className, ...headerProps }: TopBarProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/composition/TopBar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/TopBar/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhE,MAAM,MAAM,UAAU,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IAChD,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG;IACvF,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAC1C,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,GAAI,2EAAsF,WAAW,gCA6BvH,CAAA"}

package/dist/core/composition/TopBar/index.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button as HeroButton } from "@heroui/react";
+import { navigationClassName } from "../../navigationClassNames.js";
+/**
+ * The application bar (`<header>`, the banner landmark at page level): brand, inline navigation,
+ * actions and a menu trigger that replaces the inline navigation below 48rem. The trigger reports
+ * `aria-expanded`; the drawer it opens stays app/overlay-owned.
+ *
+ * Landmark rule: a page has ONE banner, and the app bar owns it. Hosted in `WorkspaceShell`'s
+ * `header` slot, the shell yields (its wrapper becomes a plain `div`) so the banner is never nested.
+ * Contract: menu trigger A11Y-2 ICON-5 STATE-7 (named glyph button, app-owned aria-expanded).
+ */
+export const TopBar = ({ brand, navigation, actions, menu, position = "sticky", className, ...headerProps }) => (_jsxs("header", { ...headerProps, className: navigationClassName("starci-core-top-bar", className), "data-component": "TopBar", "data-tier": "composition", "data-grammar-top-bar-position": position, "data-grammar-top-bar-menu": menu === undefined ? "none" : menu.visibility ?? "compact", children: [menu === undefined ? null : (_jsx(HeroButton, { "aria-expanded": menu.isOpen, "aria-label": menu.isOpen ? menu.closeLabel : menu.openLabel, className: "starci-core-top-bar-menu-trigger", "data-contract": "A11Y-2 ICON-5 STATE-7", "data-grammar-top-bar-trigger": "true", isIconOnly: true, onPress: () => menu.onOpenChange(!menu.isOpen), type: "button", variant: "tertiary", ...(menu.controls === undefined ? {} : { "aria-controls": menu.controls }), children: menu.icon })), _jsx("div", { className: "starci-core-top-bar-brand", "data-grammar-top-bar-brand": "true", children: brand }), navigation === undefined ? null : _jsx("div", { className: "starci-core-top-bar-navigation", "data-grammar-top-bar-navigation": "true", children: navigation }), actions === undefined ? null : _jsx("div", { className: "starci-core-top-bar-actions", "data-grammar-top-bar-actions": "true", children: actions })] }));
+//# sourceMappingURL=index.js.map

package/dist/core/composition/TopBar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/TopBar/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AA0BnE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,SAAS,EAAE,GAAG,WAAW,EAAe,EAAE,EAAE,CAAC,CACzH,qBACQ,WAAW,EACf,SAAS,EAAE,mBAAmB,CAAC,qBAAqB,EAAE,SAAS,CAAC,oBACjD,QAAQ,eACb,aAAa,mCACQ,QAAQ,+BACZ,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,SAAS,aAEpF,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CACzB,KAAC,UAAU,qBACQ,IAAI,CAAC,MAAM,gBACd,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAC1D,SAAS,EAAC,kCAAkC,mBAC9B,uBAAuB,kCACR,MAAM,EACnC,UAAU,QACV,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAC9C,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,UAAU,KACd,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,YAE1E,IAAI,CAAC,IAAI,GACD,CAChB,EACD,cAAK,SAAS,EAAC,2BAA2B,gCAA4B,MAAM,YAAE,KAAK,GAAO,EACzF,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,gCAAgC,qCAAiC,MAAM,YAAE,UAAU,GAAO,EAC3I,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,6BAA6B,kCAA8B,MAAM,YAAE,OAAO,GAAO,IAC3H,CACZ,CAAA"}

package/dist/core/composition/WorkspaceShell/index.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from "react";
+import { type ReactNode } from "react";
 type SlotContent = Exclude<ReactNode, null | undefined | boolean>;
 type ShellOwnedMain = ({
     readonly primaryLabel: string;
@@ -52,8 +52,25 @@ type WithoutCompactNavigation = {
     readonly compactNavigation?: undefined;
     readonly compactNavigationLabel?: never;
 };
+/**
+ * Who owns the page's single banner landmark when the shell has a `header`.
+ *
+ * `shell`: the shell's header wrapper is the `<header>` (banner) and the slot holds plain content.
+ * `slot`: the slot content is itself the banner (a `TopBar`, a `NavigationFeatureNav`, or an app
+ * bar that renders `<header>`), so the wrapper renders a plain `div` and never nests a second
+ * banner around it (axe `landmark-banner-is-top-level`, `landmark-no-duplicate-banner`).
+ */
+export type WorkspaceShellHeaderLandmark = "shell" | "slot";
+/** Resolve the landmark rule: an explicit prop wins, otherwise a Grammar app bar in the slot owns it. */
+export declare const resolveWorkspaceHeaderLandmark: (header: ReactNode, headerLandmark?: WorkspaceShellHeaderLandmark) => WorkspaceShellHeaderLandmark;
 export type WorkspaceShellProps = (ShellOwnedMain | CallerOwnedMain) & (WithNavigation | WithoutNavigation) & (WithRail | WithoutRail) & (WithCompactNavigation | WithoutCompactNavigation) & {
     readonly header?: ReactNode;
+    /**
+     * Landmark owner for `header` (see `WorkspaceShellHeaderLandmark`). Defaults to `slot` when the
+     * header is a `TopBar` or `NavigationFeatureNav`, otherwise `shell`. Pass `slot` when an
+     * app-owned bar that renders its own `<header>` goes in the slot.
+     */
+    readonly headerLandmark?: WorkspaceShellHeaderLandmark;
     readonly compactHeader?: ReactNode;
     readonly primary: ReactNode;
     readonly primaryId?: string;

package/dist/core/composition/WorkspaceShell/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/WorkspaceShell/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/composition/WorkspaceShell/index.tsx"],"names":[],"mappings":"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"}

package/dist/core/composition/WorkspaceShell/index.js

@@ -1,7 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "@heroui/react";
+import { isValidElement } from "react";
 import { Rail } from "../../branch/Rail/index.js";
+import { NavigationFeatureNav } from "../NavigationFeatureNav/index.js";
+import { TopBar } from "../TopBar/index.js";
 import { workspaceShellClassName, workspaceShellCompactHeaderClassName, workspaceShellCompactNavigationClassName, workspaceShellFloatingLayerClassName, workspaceShellHeaderClassName, workspaceShellLayoutClassName, workspaceShellLeadingRuleClassName, workspaceShellNavigationClassName, workspaceShellPrimaryClassName, workspaceShellRailClassName, } from "./classNames.js";
+/** Grammar bars that own the banner themselves; hosting one flips the default to `slot`. */
+const BANNER_OWNERS = new Set([TopBar, NavigationFeatureNav]);
+/** Resolve the landmark rule: an explicit prop wins, otherwise a Grammar app bar in the slot owns it. */
+export const resolveWorkspaceHeaderLandmark = (header, headerLandmark) => headerLandmark ?? (isValidElement(header) && BANNER_OWNERS.has(header.type) ? "slot" : "shell");
 /** Shared product workspace anatomy; connected apps supply every route and business slot. */
 export const WorkspaceShell = (props) => {
     const hasHeader = props.header != null && typeof props.header !== "boolean";
@@ -15,6 +22,8 @@ export const WorkspaceShell = (props) => {
     const primary = mainLandmark === "caller" ? _jsx("div", { className: workspaceShellPrimaryClassName, "data-contract": "GAP-5", "data-grammar-workspace-primary": "true", "data-grammar-main-landmark": "caller", id: props.primaryId, tabIndex: -1, children: props.primary }) : _jsx("main", { "aria-label": props.primaryLabel, "aria-labelledby": props.primaryLabelledBy, className: workspaceShellPrimaryClassName, "data-contract": "GAP-5", "data-grammar-workspace-primary": "true", "data-grammar-main-landmark": "shell", id: props.primaryId, tabIndex: -1, children: props.primary });
     const rail = hasRail ? _jsx("div", { className: workspaceShellRailClassName, "data-grammar-workspace-rail-region": "true", children: _jsx(Rail, { inset: props.railInset ?? "none", isLabelHidden: props.isRailLabelHidden ?? true, label: props.railLabel, mode: props.railMode ?? "flow", width: props.railWidth ?? "standard", children: props.rail }) }) : null;
     const leadingRule = railPosition === "leading" ? _jsx("div", { "aria-hidden": "true", className: workspaceShellLeadingRuleClassName, "data-contract": "BOUNDARY-4", "data-grammar-workspace-leading-rule": "true" }) : null;
-    return _jsxs("div", { className: cn(workspaceShellClassName, props.className), "data-grammar-workspace-floating": hasFloatingLayer ? "present" : "absent", "data-grammar-workspace-shell": "true", children: [hasHeader ? _jsx("header", { className: workspaceShellHeaderClassName, "data-contract": "MARGIN-5", "data-grammar-workspace-header": "true", children: props.header }) : null, hasCompactHeader ? _jsx("div", { className: workspaceShellCompactHeaderClassName, "data-grammar-workspace-compact-header": "true", children: props.compactHeader }) : null, _jsxs("div", { className: workspaceShellLayoutClassName, "data-contract": "GAP-5 MEASURE-1", "data-grammar-workspace-align": props.align ?? "start", "data-grammar-workspace-navigation": hasNavigation ? "present" : "absent", "data-grammar-workspace-navigation-track": hasNavigation ? props.navigationTrack ?? "fixed" : undefined, "data-grammar-workspace-navigation-visibility": hasNavigation ? props.navigationVisibility ?? "always" : undefined, "data-grammar-workspace-rail": hasRail ? "present" : "absent", "data-grammar-workspace-rail-position": railPosition, "data-grammar-workspace-rail-width": hasRail ? props.railWidth ?? "standard" : undefined, children: [hasNavigation ? _jsx("nav", { "aria-label": props.navigationLabel, className: workspaceShellNavigationClassName, "data-grammar-workspace-navigation-region": "true", children: props.navigation }) : null, railPosition === "leading" ? rail : null, leadingRule, primary, railPosition === "trailing" ? rail : null] }), hasCompactNavigation ? _jsx("nav", { "aria-label": props.compactNavigationLabel, className: workspaceShellCompactNavigationClassName, "data-contract": "BOUNDARY-1", "data-grammar-workspace-compact-navigation": "true", children: props.compactNavigation }) : null, hasFloatingLayer ? _jsx("div", { className: workspaceShellFloatingLayerClassName, "data-contract": "OVERFLOW-4", "data-grammar-workspace-floating-layer": "true", children: props.floatingLayer }) : null] });
+    return _jsxs("div", { className: cn(workspaceShellClassName, props.className), "data-grammar-workspace-floating": hasFloatingLayer ? "present" : "absent", "data-grammar-workspace-shell": "true", children: [hasHeader ? (resolveWorkspaceHeaderLandmark(props.header, props.headerLandmark) === "slot"
+                ? _jsx("div", { className: workspaceShellHeaderClassName, "data-contract": "MARGIN-5", "data-grammar-workspace-header": "true", "data-grammar-workspace-header-landmark": "slot", children: props.header })
+                : _jsx("header", { className: workspaceShellHeaderClassName, "data-contract": "MARGIN-5", "data-grammar-workspace-header": "true", "data-grammar-workspace-header-landmark": "shell", children: props.header })) : null, hasCompactHeader ? _jsx("div", { className: workspaceShellCompactHeaderClassName, "data-grammar-workspace-compact-header": "true", children: props.compactHeader }) : null, _jsxs("div", { className: workspaceShellLayoutClassName, "data-contract": "GAP-5 MEASURE-1", "data-grammar-workspace-align": props.align ?? "start", "data-grammar-workspace-navigation": hasNavigation ? "present" : "absent", "data-grammar-workspace-navigation-track": hasNavigation ? props.navigationTrack ?? "fixed" : undefined, "data-grammar-workspace-navigation-visibility": hasNavigation ? props.navigationVisibility ?? "always" : undefined, "data-grammar-workspace-rail": hasRail ? "present" : "absent", "data-grammar-workspace-rail-position": railPosition, "data-grammar-workspace-rail-width": hasRail ? props.railWidth ?? "standard" : undefined, children: [hasNavigation ? _jsx("nav", { "aria-label": props.navigationLabel, className: workspaceShellNavigationClassName, "data-grammar-workspace-navigation-region": "true", children: props.navigation }) : null, railPosition === "leading" ? rail : null, leadingRule, primary, railPosition === "trailing" ? rail : null] }), hasCompactNavigation ? _jsx("nav", { "aria-label": props.compactNavigationLabel, className: workspaceShellCompactNavigationClassName, "data-contract": "BOUNDARY-1", "data-grammar-workspace-compact-navigation": "true", children: props.compactNavigation }) : null, hasFloatingLayer ? _jsx("div", { className: workspaceShellFloatingLayerClassName, "data-contract": "OVERFLOW-4", "data-grammar-workspace-floating-layer": "true", children: props.floatingLayer }) : null] });
 };
 //# sourceMappingURL=index.js.map

package/dist/core/composition/WorkspaceShell/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/WorkspaceShell/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/composition/WorkspaceShell/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAClC,OAAO,EAAE,cAAc,EAAkB,MAAM,OAAO,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EACH,uBAAuB,EACvB,oCAAoC,EACpC,wCAAwC,EACxC,oCAAoC,EACpC,6BAA6B,EAC7B,6BAA6B,EAC7B,kCAAkC,EAClC,iCAAiC,EACjC,8BAA8B,EAC9B,2BAA2B,GAC9B,MAAM,iBAAiB,CAAA;AAsBxB,4FAA4F;AAC5F,MAAM,aAAa,GAAyB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAA;AAEnF,yGAAyG;AACzG,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,MAAiB,EAAE,cAA6C,EAAgC,EAAE,CAC7I,cAAc,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAkBnG,6FAA6F;AAC7F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA0B,EAAE,EAAE;IACzD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAA;IAC3E,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,SAAS,CAAA;IAChG,MAAM,aAAa,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAA;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAA;IACxC,MAAM,oBAAoB,GAAG,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAA;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,UAAU,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3E,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,SAAS,CAAA;IAChG,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,OAAO,CAAA;IAClD,MAAM,OAAO,GAAG,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAK,SAAS,EAAE,8BAA8B,mBAAgB,OAAO,oCAAgC,MAAM,gCAA4B,QAAQ,EAAC,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAG,KAAK,CAAC,OAAO,GAAO,CAAC,CAAC,CAAC,6BAAkB,KAAK,CAAC,YAAY,qBAAmB,KAAK,CAAC,iBAAiB,EAAE,SAAS,EAAE,8BAA8B,mBAAgB,OAAO,oCAAgC,MAAM,gCAA4B,OAAO,EAAC,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAG,KAAK,CAAC,OAAO,GAAQ,CAAA;IAC1gB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,cAAK,SAAS,EAAE,2BAA2B,wCAAqC,MAAM,YAAC,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,IAAI,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,IAAI,UAAU,YAAG,KAAK,CAAC,IAAI,GAAQ,GAAM,CAAC,CAAC,CAAC,IAAI,CAAA;IACpU,MAAM,WAAW,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,6BAAiB,MAAM,EAAC,SAAS,EAAE,kCAAkC,mBAAgB,YAAY,yCAAqC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;IAEvM,OAAO,eAAK,SAAS,EAAE,EAAE,CAAC,uBAAuB,EAAE,KAAK,CAAC,SAAS,CAAC,qCAAmC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,kCAA+B,MAAM,aAC7K,SAAS,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,MAAM;gBACvF,CAAC,CAAC,cAAK,SAAS,EAAE,6BAA6B,mBAAgB,UAAU,mCAA+B,MAAM,4CAAwC,MAAM,YAAE,KAAK,CAAC,MAAM,GAAO;gBACjL,CAAC,CAAC,iBAAQ,SAAS,EAAE,6BAA6B,mBAAgB,UAAU,mCAA+B,MAAM,4CAAwC,OAAO,YAAE,KAAK,CAAC,MAAM,GAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EACnM,gBAAgB,CAAC,CAAC,CAAC,cAAK,SAAS,EAAE,oCAAoC,2CAAwC,MAAM,YAAE,KAAK,CAAC,aAAa,GAAO,CAAC,CAAC,CAAC,IAAI,EACzJ,eAAK,SAAS,EAAE,6BAA6B,mBAAgB,iBAAiB,kCAA+B,KAAK,CAAC,KAAK,IAAI,OAAO,uCAAqC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,6CAA2C,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,kDAAgD,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,oBAAoB,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,iCAA+B,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,0CAAwC,YAAY,uCAAqC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,UAAU,CAAC,CAAC,CAAC,SAAS,aACzmB,aAAa,CAAC,CAAC,CAAC,4BAAiB,KAAK,CAAC,eAAe,EAAE,SAAS,EAAE,iCAAiC,8CAA2C,MAAM,YAAE,KAAK,CAAC,UAAU,GAAO,CAAC,CAAC,CAAC,IAAI,EACrL,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IACxG,EACL,oBAAoB,CAAC,CAAC,CAAC,4BAAiB,KAAK,CAAC,sBAAsB,EAAE,SAAS,EAAE,wCAAwC,mBAAgB,YAAY,+CAA2C,MAAM,YAAE,KAAK,CAAC,iBAAiB,GAAO,CAAC,CAAC,CAAC,IAAI,EAC7O,gBAAgB,CAAC,CAAC,CAAC,cAAK,SAAS,EAAE,oCAAoC,mBAAgB,YAAY,2CAAuC,MAAM,YAAE,KAAK,CAAC,aAAa,GAAO,CAAC,CAAC,CAAC,IAAI,IAClL,CAAA;AACV,CAAC,CAAA"}

package/dist/core/dna.d.ts

@@ -4,6 +4,14 @@
  * This is presentation data, not a registry of UI laws. Product rules remain
  * outside the package; consumers use these values to render the same StarCi
  * family without rebuilding its palette, geometry or motion from memory.
+ *
+ * Every colour pair the family's CSS combines clears WCAG AA in light and dark; `styles.spec.ts`
+ * measures them through the resolved scope, HeroUI's vendor variables included. `accent` is the
+ * brand FILL (white text on it, and the focus ring); where the accent is painted as TEXT - links,
+ * the current tab and bottom-nav label, the section eyebrow, the soft accent pairing - the family
+ * reads `accentText`, which is themed because the violet fill is too dark to read on the dark
+ * canvas (3.95:1) and a hair too light on the secondary surface (4.44:1). `accentSoft` is the
+ * selected/soft tint that `accentText` and `muted` both stay AA on.
  */
 export declare const STARCI_CORE_DNA: Readonly<{
     readonly id: "starci-core";
@@ -17,17 +25,19 @@ export declare const STARCI_CORE_DNA: Readonly<{
             surface: "oklch(100% 0.0008 354.13)";
             surfaceSecondary: "oklch(95.24% 0.0012 354.13)";
             foreground: "oklch(21.03% 0.0015 354.13)";
-            muted: "oklch(55.17% 0.003 354.13)";
+            muted: "oklch(52% 0.003 354.13)";
             border: "oklch(90% 0.0015 354.13)";
             separator: "oklch(92% 0.0015 354.13)";
             success: "oklch(73.29% 0.1941 162.85)";
             successForeground: "oklch(21.03% 0.0059 162.85)";
             warning: "oklch(78.19% 0.159 84.37)";
             warningForeground: "oklch(21.03% 0.0059 84.37)";
-            danger: "oklch(65.32% 0.2335 37.78)";
+            danger: "oklch(55% 0.2 37.78)";
             dangerForeground: "oklch(99.11% 0 0)";
             info: "oklch(72% 0.17 250)";
             infoForeground: "oklch(21.03% 0.0059 250)";
+            accentText: "#6a3cf2";
+            accentSoft: "oklch(95.5% 0.03 287)";
         }>;
         dark: Readonly<{
             canvas: "oklch(12% 0.0015 354.13)";
@@ -41,10 +51,12 @@ export declare const STARCI_CORE_DNA: Readonly<{
             successForeground: "oklch(21.03% 0.0059 162.85)";
             warning: "oklch(82.03% 0.1392 88.38)";
             warningForeground: "oklch(21.03% 0.0059 88.38)";
-            danger: "oklch(59.4% 0.1973 36.67)";
-            dangerForeground: "oklch(99.11% 0 0)";
+            danger: "oklch(70% 0.17 36.67)";
+            dangerForeground: "oklch(21.03% 0.0059 36.67)";
             info: "oklch(72% 0.17 250)";
             infoForeground: "oklch(21.03% 0.0059 250)";
+            accentText: "#a48bff";
+            accentSoft: "oklch(30% 0.07 287)";
         }>;
     }>;
     readonly geometry: Readonly<{
@@ -108,6 +120,8 @@ export declare const STARCI_CORE_TOKEN_NAMES: Readonly<{
     readonly dangerForeground: "--starci-core-danger-foreground";
     readonly info: "--starci-core-info";
     readonly infoForeground: "--starci-core-info-foreground";
+    readonly accentText: "--starci-core-accent-text";
+    readonly accentSoft: "--starci-core-accent-soft";
     readonly pageMeasure: "--starci-core-page-measure";
     readonly readingMeasure: "--starci-core-reading-measure";
     readonly surfaceRadius: "--starci-core-surface-radius";
@@ -160,17 +174,19 @@ export declare const STARCI_CORE_TOKEN_DEFAULTS: Readonly<{
     "--starci-core-surface": "oklch(100% 0.0008 354.13)";
     "--starci-core-surface-secondary": "oklch(95.24% 0.0012 354.13)";
     "--starci-core-foreground": "oklch(21.03% 0.0015 354.13)";
-    "--starci-core-muted": "oklch(55.17% 0.003 354.13)";
+    "--starci-core-muted": "oklch(52% 0.003 354.13)";
     "--starci-core-border": "oklch(90% 0.0015 354.13)";
     "--starci-core-separator": "oklch(92% 0.0015 354.13)";
     "--starci-core-success": "oklch(73.29% 0.1941 162.85)";
     "--starci-core-success-foreground": "oklch(21.03% 0.0059 162.85)";
     "--starci-core-warning": "oklch(78.19% 0.159 84.37)";
     "--starci-core-warning-foreground": "oklch(21.03% 0.0059 84.37)";
-    "--starci-core-danger": "oklch(65.32% 0.2335 37.78)";
+    "--starci-core-danger": "oklch(55% 0.2 37.78)";
     "--starci-core-danger-foreground": "oklch(99.11% 0 0)";
     "--starci-core-info": "oklch(72% 0.17 250)";
     "--starci-core-info-foreground": "oklch(21.03% 0.0059 250)";
+    "--starci-core-accent-text": "#6a3cf2";
+    "--starci-core-accent-soft": "oklch(95.5% 0.03 287)";
     "--starci-core-page-measure": "80rem";
     "--starci-core-reading-measure": "72ch";
     "--starci-core-surface-radius": "1rem";
@@ -198,10 +214,12 @@ export declare const STARCI_CORE_DARK_TOKEN_DEFAULTS: Readonly<{
     "--starci-core-success-foreground": "oklch(21.03% 0.0059 162.85)";
     "--starci-core-warning": "oklch(82.03% 0.1392 88.38)";
     "--starci-core-warning-foreground": "oklch(21.03% 0.0059 88.38)";
-    "--starci-core-danger": "oklch(59.4% 0.1973 36.67)";
-    "--starci-core-danger-foreground": "oklch(99.11% 0 0)";
+    "--starci-core-danger": "oklch(70% 0.17 36.67)";
+    "--starci-core-danger-foreground": "oklch(21.03% 0.0059 36.67)";
     "--starci-core-info": "oklch(72% 0.17 250)";
     "--starci-core-info-foreground": "oklch(21.03% 0.0059 250)";
+    "--starci-core-accent-text": "#a48bff";
+    "--starci-core-accent-soft": "oklch(30% 0.07 287)";
 }>;
 export type StarCiCoreTokenDefaults = typeof STARCI_CORE_TOKEN_DEFAULTS;
 //# sourceMappingURL=dna.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dna.d.ts","sourceRoot":"","sources":["../../src/core/dna.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+DjB,CAAA;AAEX,kFAAkF;AAClF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAe3B,CAAA;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,yBAAyB,CAAA;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,qBAAqB,CAAC,CAAA;AAE9F,mFAAmF;AACnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCzB,CAAA;AAEX;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B;;;;;;EAM9B,CAAA;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAA;AAEtH,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAA;AAClD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAA;AAExG,sFAAsF;AACtF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCmB,CAAA;AAE1D,mFAAmF;AACnF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;EAgBuB,CAAA;AAEnE,MAAM,MAAM,uBAAuB,GAAG,OAAO,0BAA0B,CAAA"}
+{"version":3,"file":"dna.d.ts","sourceRoot":"","sources":["../../src/core/dna.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmEjB,CAAA;AAEX,kFAAkF;AAClF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAe3B,CAAA;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,yBAAyB,CAAA;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,qBAAqB,CAAC,CAAA;AAE9F,mFAAmF;AACnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzB,CAAA;AAEX;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B;;;;;;EAM9B,CAAA;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAA;AAEtH,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAA;AAClD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAA;AAExG,sFAAsF;AACtF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCmB,CAAA;AAE1D,mFAAmF;AACnF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;EAkBuB,CAAA;AAEnE,MAAM,MAAM,uBAAuB,GAAG,OAAO,0BAA0B,CAAA"}