@multiplatform.one/components 6.0.4 → 6.3.0

package/types/code/HighlightedCode/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * File: /src/code/highlighted_code/index.tsx
+ * Project: @multiplatform.one/components
+ *
+ * Universal syntax-highlighted code renderer.
+ * Renders shiki tokens as Text components -- works identically on web and native.
+ * No CSS classes or className parsing needed.
+ */
+import type { ReactNode } from "react";
+import type { HighlightLine } from "../Highlighter";
+export interface HighlightedCodeProps {
+    /** Array of token lines from shiki */
+    tokens: HighlightLine[] | null;
+    /** Fallback content while tokens are loading */
+    children?: ReactNode;
+    /** Lines to highlight (1-indexed) */
+    highlightLines?: number[];
+    /** Whether to show line numbers */
+    showLineNumbers?: boolean;
+    /** Font size token */
+    fontSize?: any;
+}
+export declare function HighlightedCode({ tokens, children, highlightLines, showLineNumbers, fontSize, }: HighlightedCodeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/types/code/HighlightedCode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code/HighlightedCode/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mCAAmC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,cAAmB,EACnB,eAAuB,EACvB,QAAQ,GACT,EAAE,oBAAoB,2CA2DtB"}

package/types/code/Highlighter/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * File: /src/code/highlighter/index.ts
+ * Project: @multiplatform.one/components
+ *
+ * Shiki-based syntax highlighting utilities.
+ * Uses dynamic import so shiki is only loaded when needed (optional peer dep).
+ */
+/** A single highlighted token with inline color */
+export interface HighlightToken {
+    content: string;
+    color?: string;
+    fontStyle?: number;
+}
+/** A line of highlighted tokens */
+export type HighlightLine = HighlightToken[];
+/** Options for the highlight context provider */
+export interface ShikiContextValue {
+    theme?: string;
+}
+export declare const ShikiContext: import("react").Context<ShikiContextValue>;
+/**
+ * Hook that tokenizes code using shiki.
+ * Returns null while loading, then an array of lines (each line is an array of tokens).
+ * Falls back to plain text if shiki is not installed.
+ */
+export declare function useShikiTokens(code: string, language: string, theme?: string): HighlightLine[] | null;
+/**
+ * Highlight code using shiki and return structured tokens.
+ * Dynamically imports shiki so it's only loaded when actually used.
+ * Falls back to plain text if shiki is not installed or fails.
+ */
+export declare function highlightCode(code: string, language: string, theme?: string): Promise<HighlightLine[]>;
+//# sourceMappingURL=index.d.ts.map

package/types/code/Highlighter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code/Highlighter/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,MAAM,aAAa,GAAG,cAAc,EAAE,CAAC;AAE7C,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,YAAY,4CAAuC,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,EAAE,GAAG,IAAI,CA8BxB;AA4BD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAgB,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CA8B1B"}

package/types/code/Pre/index.d.ts

@@ -0,0 +1,8 @@
+export declare const Pre: import("tamagui").TamaguiComponent<import("@tamagui/web").GetFinalProps<import("@tamagui/core").RNTamaguiViewNonStyleProps, import("@tamagui/web").StackStyleBase, {
+    elevation?: number | import("tamagui").SizeTokens | undefined;
+    fullscreen?: boolean | undefined;
+}>, import("tamagui").TamaguiElement, import("@tamagui/core").RNTamaguiViewNonStyleProps & void, import("@tamagui/web").StackStyleBase, {
+    elevation?: number | import("tamagui").SizeTokens | undefined;
+    fullscreen?: boolean | undefined;
+}, import("@tamagui/web").StaticConfigPublic>;
+//# sourceMappingURL=index.d.ts.map

package/types/code/Pre/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code/Pre/index.tsx"],"names":[],"mappings":"AAcA,eAAO,MAAM,GAAG;;;;;;6CAGd,CAAC"}

package/types/code/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./Code";
+export * from "./CodeBlock";
+export * from "./HighlightedCode";
+export * from "./Highlighter";
+export * from "./Pre";
+//# sourceMappingURL=index.d.ts.map

package/types/code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/code/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC"}

package/types/componentColors.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Semantic color ramp constants for non-form components.
+ *
+ * Follows the same pattern as `public/forms/src/shared/colorRamps.ts`.
+ * All values reference Tamagui theme tokens so they adapt to light/dark mode.
+ *
+ * Use these instead of hardcoding `$color3`, `$color10`, etc. in component files.
+ */
+export declare const componentColors: {
+    /** Surface-level backgrounds and borders (cards, panels, containers) */
+    readonly surface: {
+        readonly background: "$color2";
+        readonly border: "$color6";
+    };
+    /** Interactive element states (buttons, clickable items, hover/press) */
+    readonly interactive: {
+        readonly background: "$color3";
+        readonly hover: "$color4";
+        readonly active: "$color5";
+        readonly border: "$color7";
+    };
+    /** Text color levels. muted sits on the $color11 tier — the lowest ramp
+     * step that keeps secondary text AA-readable on color1/2 surfaces. */
+    readonly text: {
+        readonly primary: "$color12";
+        readonly secondary: "$color11";
+        readonly muted: "$color11";
+        readonly subtle: "$color8";
+    };
+    /** Code block styling */
+    readonly code: {
+        readonly background: "$color3";
+        readonly foreground: "$color12";
+        readonly border: "$color6";
+        readonly lineNumber: "$color8";
+        readonly highlightLine: "$yellow3";
+    };
+    /** Dot/step indicators */
+    readonly indicator: {
+        readonly active: "$color9";
+        readonly inactive: "$color5";
+        readonly hover: "$color6";
+        readonly completed: "$green9";
+        readonly current: "$color12";
+        readonly track: "$color8";
+    };
+    /** Tooltips and overlays */
+    readonly overlay: {
+        readonly background: "$color3";
+        readonly border: "$color6";
+        readonly text: "$color11";
+    };
+    /** Badge semantic colors. Step 11 (not 9) so the count text clears AA:
+     * white-on-$red9 measured 3.91:1 (SB-R-02). Step 11 flips with the scheme
+     * (deep hue in light, pale hue in dark), pairing with $color1 text. */
+    readonly badge: {
+        readonly red: "$red11";
+        readonly blue: "$blue11";
+        readonly green: "$green11";
+        readonly orange: "$orange11";
+        readonly gray: "$color11";
+    };
+    /** Semantic status colors for diff-like displays. Step 11 (not 10) for the
+     * same AA reason as `badge`: these color small status/trend text (KPICard
+     * trend, Timeline diffs, Attachments errors) and step 10 measured
+     * 3.37–4.36:1 on color1/2 surfaces — under the 4.5:1 normal-text floor. */
+    readonly semantic: {
+        readonly error: "$red11";
+        readonly success: "$green11";
+        readonly info: "$color11";
+    };
+    /** Separator/divider tokens */
+    readonly divider: "$color4";
+    /** Debug indicator color */
+    readonly debug: "$color9";
+};
+/**
+ * Shared section-heading scale.
+ *
+ * One step below the page `<H1>` title so every catalog section label
+ * (PageSection title, Timeline label, Attachments label) reads at ONE
+ * consistent 20px scale on a composed screen — instead of each component
+ * picking its own H2/H4/Label size. Spread onto the heading node:
+ *
+ *   <H2 margin={0} {...sectionHeading}>{title}</H2>
+ *
+ * Numeric px on purpose: the token `$7` resolves per font SCOPE — 20px in
+ * the `$body` scope (Label) but 28px in the `$heading` scope (H2/H4, whose
+ * size table is 1.4x) — which put 28px text on this 26px leading (ratio
+ * 0.93, wrapped titles overlapped). Fixed values render the same 20px/26px
+ * (1.3) in every scope and every headingFont category.
+ */
+export declare const sectionHeading: {
+    readonly fontSize: 20;
+    readonly lineHeight: 26;
+    readonly fontWeight: "600";
+};
+//# sourceMappingURL=componentColors.d.ts.map

package/types/componentColors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentColors.d.ts","sourceRoot":"","sources":["../src/componentColors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,eAAe;IAC1B,wEAAwE;;;;;IAMxE,yEAAyE;;;;;;;IAQzE;0EACsE;;;;;;;IAQtE,yBAAyB;;;;;;;;IASzB,0BAA0B;;;;;;;;;IAU1B,4BAA4B;;;;;;IAO5B;;2EAEuE;;;;;;;;IASvE;;;+EAG2E;;;;;;IAO3E,+BAA+B;;IAG/B,4BAA4B;;CAEpB,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC"}

package/types/feedback/ConfirmDialog.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ConfirmDialog — blocking confirm / cancel overlay (DG-OVL-01/02, W7).
+ *
+ * Always `role="alertdialog"`. Modal Dialog provides the focus trap; Escape
+ * cancels. Pointer-outside light-dismiss is disabled (blocking confirm).
+ * `destructive` paints the confirm button with the danger (error) theme.
+ *
+ * Action rules: cancel never renders disabled — `cancelDisabled` is ignored
+ * by design (DG-ACT-05, `cancel-disabled` DEV warn). Cancel + confirm are the
+ * two sanctioned actions; extra pressables in the body DEV-warn
+ * `dialog-too-many-actions` unless `allowManyActions` ejects (DG-OVL-04).
+ */
+import { type ReactNode } from "react";
+export interface ConfirmDialogProps {
+    open: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Dialog title (also labels the alertdialog). */
+    title: ReactNode;
+    /** Body copy. Prefer this over `children` for simple string bodies. */
+    body?: ReactNode;
+    /** Alternate body slot (e.g. richer content). Ignored when `body` is set. */
+    children?: ReactNode;
+    /** Confirm button label (default "Confirm"). */
+    confirmLabel?: string;
+    /** Cancel button label (default "Cancel"). */
+    cancelLabel?: string;
+    /** Fired when the confirm button is pressed (dialog closes after). */
+    onConfirm?: () => void;
+    /** Fired when cancel / Escape closes the dialog. */
+    onCancel?: () => void;
+    /**
+     * Danger confirm — error-themed primary (DG-OVL-02).
+     * Use for irreversible / high-severity actions. Wins over `warning`.
+     */
+    destructive?: boolean;
+    /** Warning-themed confirm (caution). Ignored when `destructive`. */
+    warning?: boolean;
+    /** Disable the confirm button (e.g. typed-confirm gate until text matches). */
+    confirmDisabled?: boolean;
+    /**
+     * DG-ST-03 — explains why confirm is gated (e.g. the typed-confirm hint).
+     * Renders as visible text under the confirm button via the Button
+     * `disabledReason` affordance; without it, a gated confirm DEV-warns
+     * `bare-disabled`.
+     */
+    confirmDisabledReason?: string;
+    /**
+     * DG-ACT-05 — IGNORED by design. The cancel action never renders disabled,
+     * even while `confirmDisabled` gates the confirm button. Passing `true`
+     * emits the `cancel-disabled` DEV warn and marks the cancel button with
+     * `data-mp-cancel-disabled-ignored` (the button stays enabled).
+     */
+    cancelDisabled?: boolean;
+    /**
+     * DG-OVL-04 eject — acknowledges more than 2 actions rendered by the
+     * dialog (extra pressables in `body` / `children`) and silences the
+     * `dialog-too-many-actions` DEV warn.
+     */
+    allowManyActions?: boolean;
+}
+export declare function ConfirmDialog({ open, onOpenChange, title, body, children, confirmLabel: confirmLabelProp, cancelLabel: cancelLabelProp, onConfirm, onCancel, destructive, warning, confirmDisabled, confirmDisabledReason, cancelDisabled, allowManyActions, }: ConfirmDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConfirmDialog.d.ts.map

package/types/feedback/ConfirmDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmDialog.d.ts","sourceRoot":"","sources":["../../src/feedback/ConfirmDialog.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAO1D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,kDAAkD;IAClD,KAAK,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,YAAY,EAAE,gBAAgB,EAC9B,WAAW,EAAE,eAAe,EAC5B,SAAS,EACT,QAAQ,EACR,WAAmB,EACnB,OAAe,EACf,eAAuB,EACvB,qBAAqB,EACrB,cAAsB,EACtB,gBAAwB,GACzB,EAAE,kBAAkB,2CAmGpB"}

package/types/feedback/NotifyHost.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Host for notify() non-toast surfaces: page banners + blocking dialogs.
+ * Also mounts ToastViewport so a single root host covers all routes.
+ *
+ * Blocking error/warning routes render `<ConfirmDialog>` (alertdialog) — W7.
+ */
+import { type ReactNode } from "react";
+import { type ToastViewportProps } from "../Toast";
+export interface NotifyHostProps {
+    /** Mount ToastViewport (default true). Pass false if the app already mounts one. */
+    toastViewport?: boolean | ToastViewportProps;
+    children?: ReactNode;
+}
+/**
+ * Inline region for section/field-scoped alerts from `notify()`.
+ * Place next to the relevant form section or field.
+ */
+export declare function NotifyRegion({ scope, compact, }: {
+    scope: "section" | "field";
+    compact?: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * App/story root host: page banners, blocking dialog, and (optionally) toast viewport.
+ */
+export declare function NotifyHost({ toastViewport, children }: NotifyHostProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NotifyHost.d.ts.map

package/types/feedback/NotifyHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotifyHost.d.ts","sourceRoot":"","sources":["../../src/feedback/NotifyHost.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMtE,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAIlE,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA4DD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,OAAO,GACR,EAAE;IACD,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,kDA2BA;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,aAAoB,EAAE,QAAQ,EAAE,EAAE,eAAe,2CAe7E"}

package/types/feedback/index.d.ts

@@ -0,0 +1,6 @@
+export { routeNotify, type NotifyAction, type NotifyEvent, type NotifyRoute, type NotifyScope, type NotifySeverity, type NotifySurface, type NotifyToastIntent, } from "./route";
+export { notify } from "./notify";
+export { NotifyHost, NotifyRegion, type NotifyHostProps } from "./NotifyHost";
+export { ConfirmDialog, type ConfirmDialogProps } from "./ConfirmDialog";
+export { dismissFeedback, dismissFeedbackBySurface, getFeedback, pushFeedback, resetFeedback, subscribeFeedback, type FeedbackEntry, } from "./store";
+//# sourceMappingURL=index.d.ts.map

package/types/feedback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feedback/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAC"}

package/types/feedback/notify.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Semantic `notify()` — severity × scope × blocking → toast / banner / alert / dialog.
+ *
+ * Mount `<NotifyHost />` once (app root / story) so banners and dialogs render.
+ * Inline `alert` surfaces need a `<NotifyRegion scope="section"|"field" />`
+ * near the relevant content. Toast still needs `<ToastViewport />` (included
+ * in NotifyHost by default).
+ */
+import { type NotifyEvent, type NotifyRoute } from "./route";
+export type { NotifyEvent, NotifyRoute };
+/**
+ * Route a semantic feedback event and deliver it to the matching surface.
+ * Returns the route decision (useful for tests / debugging).
+ */
+export declare function notify(event: NotifyEvent): NotifyRoute;
+//# sourceMappingURL=notify.d.ts.map

package/types/feedback/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/feedback/notify.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAG1E,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAUzC;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CA0BtD"}

package/types/feedback/route.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Pure severity × scope × blocking → surface router (DG-FB-01..04).
+ *
+ * Devs declare *what happened*; this picks *how it appears*. Side-effecting
+ * delivery lives in `notify.ts` so unit tests can assert the table without
+ * mounting hosts.
+ */
+export type NotifySeverity = "info" | "success" | "warning" | "error";
+export type NotifyScope = "page" | "section" | "field";
+export type NotifySurface = "toast" | "banner" | "alert" | "dialog";
+export interface NotifyAction {
+    label: string;
+    onPress: () => void;
+}
+export interface NotifyEvent {
+    severity: NotifySeverity;
+    scope: NotifyScope;
+    /** Escalate to a blocking dialog (error/warning only). Ignored for info/success. */
+    blocking?: boolean;
+    action?: NotifyAction;
+    title?: string;
+    body: string;
+    /**
+     * Eject: override the severity-gated dismissibility. House default: error
+     * banners are NOT dismissible (they persist until the error state clears);
+     * every other surface/severity is dismissible.
+     */
+    dismissible?: boolean;
+}
+/** Toast intent mapping: info rides accent (same as Alert's info→accent theme). */
+export type NotifyToastIntent = "accent" | "success" | "warning" | "error";
+export interface NotifyRoute {
+    surface: NotifySurface;
+    severity: NotifySeverity;
+    scope: NotifyScope;
+    /** Toast intent (info → accent). Banner/alert/dialog use `severity` as Alert intent. */
+    toastIntent: NotifyToastIntent;
+    title?: string;
+    body: string;
+    action?: NotifyAction;
+    /**
+     * Auto-dismiss for toast surfaces. `0` = persistent.
+     * Errors never auto-dismiss (DG-FB-02); action toasts stay ≥10s (DG-FB-04).
+     */
+    duration: number | undefined;
+    dismissible: boolean;
+}
+/**
+ * Decide the feedback surface for a semantic event.
+ *
+ * Routing table:
+ * | severity | scope           | blocking | surface                          |
+ * |----------|-----------------|----------|----------------------------------|
+ * | success  | *               | *        | toast                            |
+ * | info     | page            | *        | toast                            |
+ * | info     | section \| field| *        | alert (inline)                   |
+ * | warning  | *               | true     | dialog                           |
+ * | warning  | page            | false    | banner (sticky)                  |
+ * | warning  | section \| field| false    | alert (inline)                   |
+ * | error    | *               | true     | dialog                           |
+ * | error    | page            | false    | banner (sticky)                  |
+ * | error    | section \| field| false    | alert (inline)                   |
+ *
+ * Errors never route to an auto-dismissing toast.
+ */
+export declare function routeNotify(event: NotifyEvent): NotifyRoute;
+//# sourceMappingURL=route.d.ts.map

package/types/feedback/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/feedback/route.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,wFAAwF;IACxF,WAAW,EAAE,iBAAiB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAwC3D"}

package/types/feedback/store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Module-level store for notify() banner / inline alert / dialog surfaces.
+ * Toast delivery uses the existing Toast store (`showToast`).
+ */
+import type { NotifyAction, NotifyScope, NotifySeverity, NotifySurface } from "./route";
+export interface FeedbackEntry {
+    id: string;
+    surface: Exclude<NotifySurface, "toast">;
+    severity: NotifySeverity;
+    scope: NotifyScope;
+    title?: string;
+    body: string;
+    action?: NotifyAction;
+    dismissible: boolean;
+}
+export declare function getFeedback(): FeedbackEntry[];
+export declare function subscribeFeedback(listener: () => void): () => void;
+export declare function pushFeedback(entry: Omit<FeedbackEntry, "id"> & {
+    id?: string;
+}): string;
+export declare function dismissFeedback(id: string): void;
+export declare function dismissFeedbackBySurface(surface: FeedbackEntry["surface"]): void;
+/** Hard-reset (tests / story decorators). */
+export declare function resetFeedback(): void;
+//# sourceMappingURL=store.d.ts.map

package/types/feedback/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/feedback/store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAUD,wBAAgB,WAAW,IAAI,aAAa,EAAE,CAE7C;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKlE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAevF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI,CAIhF;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}

package/types/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./useAssets";
+export * from "./useClipboard";
+export * from "./useDirection";
+export * from "./useDocumentTitle";
+//# sourceMappingURL=index.d.ts.map

package/types/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/types/hooks/useAssets/index.d.ts

@@ -0,0 +1,3 @@
+import type { ImageURISource } from "react-native";
+export declare function useAssets(modules: any[]): (ImageURISource | undefined)[];
+//# sourceMappingURL=index.d.ts.map

package/types/hooks/useAssets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAssets/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,wBAAgB,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CASxE"}

package/types/hooks/useAssets/index.native.d.ts

@@ -0,0 +1,4 @@
+type StaticImageData = any;
+export declare function useAssets(modules: any | any[]): (StaticImageData | undefined)[];
+export {};
+//# sourceMappingURL=index.native.d.ts.map

package/types/hooks/useAssets/index.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.native.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAssets/index.native.ts"],"names":[],"mappings":"AAKA,KAAK,eAAe,GAAG,GAAG,CAAC;AAE3B,wBAAgB,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,eAAe,GAAG,SAAS,CAAC,EAAE,CAa/E"}

package/types/hooks/useClipboard.d.ts

@@ -0,0 +1,23 @@
+export declare const copyToClipboard: (text: string) => Promise<boolean>;
+export interface UseClipboardOptions {
+    timeout?: number;
+}
+/**
+ * Hook for copying text to the clipboard with "copied" / "copy failed" state indicators.
+ *
+ * @param text - Default text to copy
+ * @param options - `timeout` in ms before `hasCopied` / `hasCopyFailed` reset (default 1500)
+ * @returns `{ value, onCopy, hasCopied, hasCopyFailed }`
+ *
+ * `onCopy` accepts an optional string argument to override the default text and
+ * resolves to whether the clipboard write succeeded. `hasCopied` only becomes
+ * true when the write actually resolved successfully; a rejected/denied write
+ * sets `hasCopyFailed` instead.
+ */
+export declare function useClipboard(text?: string, options?: UseClipboardOptions): {
+    value: string;
+    onCopy: (overrideText?: string | unknown) => Promise<boolean>;
+    hasCopied: boolean;
+    hasCopyFailed: boolean;
+};
+//# sourceMappingURL=useClipboard.d.ts.map

package/types/hooks/useClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useClipboard.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,qBAE3C,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAK,EAAE,OAAO,CAAC,EAAE,mBAAmB;;4BAKrB,MAAM,GAAG,OAAO;;;EAkB/D"}

package/types/hooks/useDirection.d.ts

@@ -0,0 +1,29 @@
+/**
+ * useDirection — the catalog's runtime direction source (RTL audit backlog #1).
+ *
+ * CSS logical properties mirror layout for free, but directional *glyphs*
+ * (prev/next carets, expand arrows) and JS-measured geometry need to know the
+ * writing direction at runtime. This hook is that source.
+ *
+ * Web: reads the document-level `dir` attribute — `<body dir>` wins over
+ * `<html dir>` (the nearer attribute governs content per bidi inheritance);
+ * `"auto"` and empty values fall through. A MutationObserver keeps the value
+ * live, so flipping `document.dir` at runtime (e.g. the RTL probe, a locale
+ * switcher) re-renders consumers. SSR-safe via `useSyncExternalStore`: the
+ * server snapshot is `"ltr"`, hydration renders with it (no mismatch), and
+ * React re-checks the client snapshot immediately after.
+ *
+ * Native (`useDirection.native.ts`): `I18nManager.isRTL`, which is fixed for
+ * the app session (RN requires a reload to change direction).
+ */
+export type Direction = "ltr" | "rtl";
+/**
+ * Returns the current writing direction (`"ltr"` | `"rtl"`).
+ *
+ * Use it to mirror directional chrome that CSS logical properties cannot
+ * reach — swap paired glyphs (CaretLeft ⇄ CaretRight) when the icon encodes
+ * direction-of-travel. Do NOT mirror direction-neutral glyphs (search,
+ * close, checkmarks).
+ */
+export declare function useDirection(): Direction;
+//# sourceMappingURL=useDirection.d.ts.map

package/types/hooks/useDirection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDirection.d.ts","sourceRoot":"","sources":["../../src/hooks/useDirection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAmCtC;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAExC"}

package/types/hooks/useDirection.native.d.ts

@@ -0,0 +1,11 @@
+/**
+ * useDirection (native) — see useDirection.ts for the contract.
+ *
+ * React Native exposes direction through `I18nManager.isRTL`, which is fixed
+ * for the app session (changing it requires a reload), so no subscription is
+ * needed — the value cannot change while mounted.
+ */
+export type Direction = "ltr" | "rtl";
+/** Returns the current writing direction (`"ltr"` | `"rtl"`). */
+export declare function useDirection(): Direction;
+//# sourceMappingURL=useDirection.native.d.ts.map

package/types/hooks/useDirection.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDirection.native.d.ts","sourceRoot":"","sources":["../../src/hooks/useDirection.native.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtC,iEAAiE;AACjE,wBAAgB,YAAY,IAAI,SAAS,CAExC"}

package/types/hooks/useDocumentTitle.d.ts

@@ -0,0 +1,41 @@
+/**
+ * useDocumentTitle — DG-COPY-04 "document titles are reverse breadcrumbs".
+ *
+ * Composes "Leaf – Section – App" from a breadcrumb-ordered trail (root
+ * first, exactly as passed to `<Breadcrumbs items>`) and assigns it to
+ * `document.title` on web. Native (and SSR) is a no-op — there is no
+ * `document`. An empty composed title never blanks the current one.
+ */
+/** Anything with a breadcrumb-style label (BreadcrumbItem is assignable). */
+export interface DocumentTitlePart {
+    label?: string | null;
+}
+/**
+ * Breadcrumb-ordered trail (root → leaf). Plain strings and items with a
+ * `label` are accepted; empty / nullish parts are dropped.
+ */
+export type DocumentTitleTrail = ReadonlyArray<DocumentTitlePart | string | null | undefined> | null;
+/** En dash with hair spaces per DG-COPY-04: "Leaf – Section – App". */
+export declare const DOCUMENT_TITLE_SEPARATOR = " \u2013 ";
+/**
+ * Pure composition: reverse the trail (leaf first) and join. Exported for
+ * unit tests and non-hook callers.
+ */
+export declare function composeDocumentTitle(trail: DocumentTitleTrail | undefined, separator?: string): string;
+export interface UseDocumentTitleOptions {
+    /** Separator between parts. Default `" – "`. */
+    separator?: string;
+    /** Pass false to compose without assigning `document.title`. */
+    enabled?: boolean;
+}
+/**
+ * Sets `document.title` to the reverse of the given breadcrumb trail.
+ * Returns the composed title (empty string when the trail has no labels —
+ * in that case the current document title is left untouched).
+ *
+ * @example
+ * // breadcrumbs = [{ label: "Desk" }, { label: "Pokemon" }, { label: "Pikachu" }]
+ * useDocumentTitle(breadcrumbs); // document.title === "Pikachu – Pokemon – Desk"
+ */
+export declare function useDocumentTitle(trail: DocumentTitleTrail | undefined, options?: UseDocumentTitleOptions): string;
+//# sourceMappingURL=useDocumentTitle.d.ts.map

package/types/hooks/useDocumentTitle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentTitle.d.ts","sourceRoot":"","sources":["../../src/hooks/useDocumentTitle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAC5C,iBAAiB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAC9C,GAAG,IAAI,CAAC;AAET,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,aAAQ,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,SAAS,GAAE,MAAiC,GAC3C,MAAM,CAOR;AAED,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAaR"}

package/types/icons/CheckRegular.d.ts

@@ -0,0 +1,11 @@
+declare function Icon({ color, size, ...otherProps }: {
+    [x: string]: any;
+    color?: string | undefined;
+    size?: number | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+declare namespace Icon {
+    var displayName: string;
+}
+declare const CheckRegular: import("react").MemoExoticComponent<typeof Icon>;
+export { CheckRegular };
+//# sourceMappingURL=CheckRegular.d.ts.map

package/types/icons/CheckRegular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckRegular.d.ts","sourceRoot":"","sources":["../../src/icons/CheckRegular.tsx"],"names":[],"mappings":"AAIA,iBAAS,IAAI,CAAC,EAAE,KAAe,EAAE,IAAS,EAAE,GAAG,UAAU,EAAE;;;;CAAA,2CAc1D;kBAdQ,IAAI;;;AAgBb,QAAA,MAAM,YAAY,kDAAqB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/types/icons/MinusRegular.d.ts

@@ -0,0 +1,11 @@
+declare function Icon({ color, size, ...otherProps }: {
+    [x: string]: any;
+    color?: string | undefined;
+    size?: number | undefined;
+}): import("react/jsx-runtime").JSX.Element;
+declare namespace Icon {
+    var displayName: string;
+}
+declare const MinusRegular: import("react").MemoExoticComponent<typeof Icon>;
+export { MinusRegular };
+//# sourceMappingURL=MinusRegular.d.ts.map

package/types/icons/MinusRegular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MinusRegular.d.ts","sourceRoot":"","sources":["../../src/icons/MinusRegular.tsx"],"names":[],"mappings":"AAIA,iBAAS,IAAI,CAAC,EAAE,KAAe,EAAE,IAAS,EAAE,GAAG,UAAU,EAAE;;;;CAAA,2CAiB1D;kBAjBQ,IAAI;;;AAmBb,QAAA,MAAM,YAAY,kDAAqB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/types/icons/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./CheckRegular";
+export * from "./MinusRegular";
+export * from "./lucide";
+//# sourceMappingURL=index.d.ts.map

package/types/icons/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/icons/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC"}