@corbits/react-ui 0.1.0

package/dist/hooks/use-list-selection.js

@@ -0,0 +1,147 @@
+import { useCallback, useMemo, useReducer, useRef } from "react";
+function reducer(state, action) {
+    switch(action.type){
+        case "clear":
+            return {
+                selectedIds: new Set(),
+                anchorId: undefined,
+                baseSelection: new Set()
+            };
+        case "selectAll":
+            {
+                const all = new Set(action.ids);
+                return {
+                    selectedIds: all,
+                    anchorId: state.anchorId,
+                    baseSelection: all
+                };
+            }
+        case "toggle":
+            {
+                const { id, shiftKey, ids } = action;
+                if (shiftKey && state.anchorId !== undefined) {
+                    const anchorIndex = ids.indexOf(state.anchorId);
+                    const targetIndex = ids.indexOf(id);
+                    if (anchorIndex === -1 || targetIndex === -1) {
+                        // The anchor or target scrolled out of the known set — fall back
+                        // to a plain toggle rather than ranging over an index that no
+                        // longer means anything.
+                        const next = toggleOne(state.selectedIds, id);
+                        return {
+                            selectedIds: next,
+                            anchorId: id,
+                            baseSelection: next
+                        };
+                    }
+                    const [start, end] = anchorIndex <= targetIndex ? [
+                        anchorIndex,
+                        targetIndex
+                    ] : [
+                        targetIndex,
+                        anchorIndex
+                    ];
+                    const range = ids.slice(start, end + 1);
+                    const selectedIds = new Set(state.baseSelection);
+                    for (const rangeId of range)selectedIds.add(rangeId);
+                    return {
+                        ...state,
+                        selectedIds
+                    };
+                }
+                const next = toggleOne(state.selectedIds, id);
+                return {
+                    selectedIds: next,
+                    anchorId: id,
+                    baseSelection: next
+                };
+            }
+    }
+}
+function createInitialState() {
+    return {
+        selectedIds: new Set(),
+        anchorId: undefined,
+        baseSelection: new Set()
+    };
+}
+/**
+ * Headless selection state for a list/table: toggle-by-id, shift-click range
+ * selection anchored on the last row toggled outside a range, and
+ * select-all/clear. Renders nothing and owns no DOM — `SelectionCheckbox` and
+ * `BulkActionBar` are the rendered halves of this.
+ *
+ * The anchor is the last id passed to `toggle` *without* `shiftKey` — the
+ * same row a Finder/Sheets shift-click ranges from. A shift-click does not
+ * move the anchor, so a person can shift-click several times in a row (even
+ * in different directions) and each click re-ranges from the same start
+ * rather than from wherever they last landed.
+ *
+ * **Stale-id reconciliation.** The hook keeps whatever was selected even
+ * after a row drops out of `ids` (a refetch, a filter change) rather than
+ * pruning it immediately — pruning on every `ids` change would need an
+ * effect, and an extra render on top of whatever caused `ids` to change in
+ * the first place. Instead `selectedIds`/`selectedCount`/`isSelected` are
+ * reconciled against the current `ids` on every read, so a stale id can
+ * never inflate the count or reach the caller; it simply stops counting
+ * once its row is gone, and starts counting again if the same id reappears
+ * (e.g. a filter that got cleared) with no action needed from the caller.
+ *
+ * **Stable callbacks.** `toggle`/`selectAll`/`clear` read `ids` through a
+ * ref rather than closing over the `ids` array directly, so their identity
+ * stays stable across renders even when a caller passes a freshly allocated
+ * array each time (e.g. an inline `rows.map(row => row.id)`) — a memoized
+ * row downstream that depends on `toggle` does not re-render just because
+ * the caller didn't bother memoizing `ids`.
+ */ export function useListSelection({ ids }) {
+    const [state, dispatch] = useReducer(reducer, undefined, createInitialState);
+    // Updated on every render, read only inside event handlers — never during
+    // render — so `toggle`/`selectAll` can stay referentially stable while
+    // still acting on the `ids` most recently passed in.
+    const idsRef = useRef(ids);
+    idsRef.current = ids;
+    const toggle = useCallback((id, modifiers)=>dispatch({
+            type: "toggle",
+            id,
+            shiftKey: modifiers?.shiftKey ?? false,
+            ids: idsRef.current
+        }), []);
+    const selectAll = useCallback(()=>dispatch({
+            type: "selectAll",
+            ids: idsRef.current
+        }), []);
+    const clear = useCallback(()=>dispatch({
+            type: "clear"
+        }), []);
+    const selectedIds = useMemo(()=>{
+        const known = new Set(ids);
+        const reconciled = new Set();
+        for (const id of state.selectedIds)if (known.has(id)) reconciled.add(id);
+        return reconciled;
+    }, [
+        state.selectedIds,
+        ids
+    ]);
+    const isSelected = useCallback((id)=>selectedIds.has(id), [
+        selectedIds
+    ]);
+    return useMemo(()=>({
+            selectedIds,
+            selectedCount: selectedIds.size,
+            isSelected,
+            toggle,
+            selectAll,
+            clear
+        }), [
+        selectedIds,
+        isSelected,
+        toggle,
+        selectAll,
+        clear
+    ]);
+}
+function toggleOne(current, id) {
+    const next = new Set(current);
+    if (next.has(id)) next.delete(id);
+    else next.add(id);
+    return next;
+}

package/dist/hooks/use-prefers-reduced-motion.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The OS-level "reduce motion" preference, read once and kept live.
+ *
+ * `theme.css` collapses every CSS transition/animation duration to near-zero
+ * under this same query, so most components need nothing here — that global
+ * rule is the default. This hook exists for the handful that animate outside
+ * CSS (a `requestAnimationFrame` loop, an imperative scroll), where the
+ * stylesheet has no duration to collapse. `animated-number`, `dither-canvas`
+ * and `use-scroll-current-into-view` each read `matchMedia` by hand before
+ * this shipped; this is the one place that logic lives now, and — unlike
+ * those one-shot reads — it updates if the preference changes while mounted.
+ */
+export declare function usePrefersReducedMotion(): boolean;

package/dist/hooks/use-prefers-reduced-motion.js

@@ -0,0 +1,28 @@
+import { useSyncExternalStore } from "react";
+const QUERY = "(prefers-reduced-motion: reduce)";
+function subscribe(callback) {
+    if (typeof window === "undefined") return ()=>{};
+    const query = window.matchMedia(QUERY);
+    query.addEventListener("change", callback);
+    return ()=>query.removeEventListener("change", callback);
+}
+function getSnapshot() {
+    return typeof window === "undefined" ? false : window.matchMedia(QUERY).matches;
+}
+function getServerSnapshot() {
+    return false;
+}
+/**
+ * The OS-level "reduce motion" preference, read once and kept live.
+ *
+ * `theme.css` collapses every CSS transition/animation duration to near-zero
+ * under this same query, so most components need nothing here — that global
+ * rule is the default. This hook exists for the handful that animate outside
+ * CSS (a `requestAnimationFrame` loop, an imperative scroll), where the
+ * stylesheet has no duration to collapse. `animated-number`, `dither-canvas`
+ * and `use-scroll-current-into-view` each read `matchMedia` by hand before
+ * this shipped; this is the one place that logic lives now, and — unlike
+ * those one-shot reads — it updates if the preference changes while mounted.
+ */ export function usePrefersReducedMotion() {
+    return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}

package/dist/hooks/use-scroll-current-into-view.d.ts

@@ -0,0 +1,19 @@
+import { type RefObject } from "react";
+/**
+ * Keeps "the current item" visible inside a scrollable rail: attach the
+ * returned ref to whichever element is current, and it is scrolled into view
+ * whenever `currentKey` changes. Headless — no markup, no styling — so a
+ * stepper, a tab strip or a timeline can all share the one behaviour.
+ *
+ * `currentKey` takes a single primitive (a step number, a tab id) rather than
+ * a dependency array, so there is nothing to spread and no way for a new
+ * array identity to re-fire the scroll on every unrelated parent render.
+ *
+ * `block: "nearest"` keeps the page itself from jumping; only the rail's own
+ * scroll position moves.
+ *
+ * The scroll itself is smooth, but `scrollIntoView` isn't covered by the
+ * theme's global reduced-motion block, so a `prefers-reduced-motion: reduce`
+ * check here falls back to an instant jump.
+ */
+export declare function useScrollCurrentIntoView<T extends HTMLElement>(currentKey: string | number): RefObject<T | null>;

package/dist/hooks/use-scroll-current-into-view.js

@@ -0,0 +1,33 @@
+import { useEffect, useRef } from "react";
+import { usePrefersReducedMotion } from "./use-prefers-reduced-motion.js";
+/**
+ * Keeps "the current item" visible inside a scrollable rail: attach the
+ * returned ref to whichever element is current, and it is scrolled into view
+ * whenever `currentKey` changes. Headless — no markup, no styling — so a
+ * stepper, a tab strip or a timeline can all share the one behaviour.
+ *
+ * `currentKey` takes a single primitive (a step number, a tab id) rather than
+ * a dependency array, so there is nothing to spread and no way for a new
+ * array identity to re-fire the scroll on every unrelated parent render.
+ *
+ * `block: "nearest"` keeps the page itself from jumping; only the rail's own
+ * scroll position moves.
+ *
+ * The scroll itself is smooth, but `scrollIntoView` isn't covered by the
+ * theme's global reduced-motion block, so a `prefers-reduced-motion: reduce`
+ * check here falls back to an instant jump.
+ */ export function useScrollCurrentIntoView(currentKey) {
+    const currentRef = useRef(null);
+    const prefersReducedMotion = usePrefersReducedMotion();
+    useEffect(()=>{
+        currentRef.current?.scrollIntoView({
+            block: "nearest",
+            inline: "center",
+            behavior: prefersReducedMotion ? "auto" : "smooth"
+        });
+    }, [
+        currentKey,
+        prefersReducedMotion
+    ]);
+    return currentRef;
+}

package/dist/index.d.ts

@@ -0,0 +1,122 @@
+export * from "./blocks/login/auth-layout.js";
+export * from "./blocks/login/login-form.js";
+export * from "./hooks/use-command-palette-navigation.js";
+export * from "./hooks/use-controllable-state.js";
+export * from "./hooks/use-delayed-autofocus.js";
+export * from "./hooks/use-dismissable-popover.js";
+export * from "./hooks/use-list-selection.js";
+export * from "./hooks/use-prefers-reduced-motion.js";
+export * from "./hooks/use-scroll-current-into-view.js";
+export * from "./lib/artifact.js";
+export * from "./lib/chart-palette.js";
+export * from "./lib/chat-message.js";
+export * from "./lib/chat-parts.js";
+export * from "./lib/csv.js";
+export * from "./lib/metrics.js";
+export * from "./lib/now-item.js";
+export * from "./lib/relative-time.js";
+export * from "./lib/theme.js";
+export * from "./lib/url.js";
+export * from "./lib/utils.js";
+export * from "./lib/workflow-display-flow.js";
+export * from "./lib/workflow-registry.js";
+export * from "./lib/workflow-run.js";
+export * from "./lib/workflow-run-error.js";
+export * from "./lib/workflow-run-progress.js";
+export * from "./ui/agent-turn.js";
+export * from "./ui/animated-number.js";
+export * from "./ui/approval-card.js";
+export * from "./ui/artifact-body.js";
+export * from "./ui/artifact-notice.js";
+export * from "./ui/avatar.js";
+export * from "./ui/badge.js";
+export * from "./ui/bar-chart.js";
+export * from "./ui/block-card.js";
+export * from "./ui/boot-screen.js";
+export * from "./ui/bulk-action-bar.js";
+export * from "./ui/button.js";
+export * from "./ui/card.js";
+export * from "./ui/category-bars.js";
+export * from "./ui/chart-frame.js";
+export * from "./ui/chat-composer.js";
+export * from "./ui/chat-dock-timing.js";
+export * from "./ui/chat-input.js";
+export * from "./ui/chat-panel.js";
+export * from "./ui/chat-thread.js";
+export * from "./ui/checkbox.js";
+export * from "./ui/command-palette.js";
+export * from "./ui/compare-body.js";
+export * from "./ui/confirm-button.js";
+export * from "./ui/corbits-mark.js";
+export * from "./ui/csv-table.js";
+export * from "./ui/dialog.js";
+export * from "./ui/dictation-status-line.js";
+export * from "./ui/dither-canvas.js";
+export * from "./ui/embed-body.js";
+export * from "./ui/empty-state.js";
+export * from "./ui/file-input.js";
+export * from "./ui/filter-bar.js";
+export * from "./ui/filter-chip.js";
+export * from "./ui/gate-block.js";
+export * from "./ui/horizontal-stepper.js";
+export * from "./ui/input.js";
+export * from "./ui/inspector-shell.js";
+export * from "./ui/intake-form.js";
+export * from "./ui/kind-card-grid.js";
+export * from "./ui/library-page-header.js";
+export * from "./ui/list-detail.js";
+export * from "./ui/live-run-banner.js";
+export * from "./ui/live-status-line.js";
+export * from "./ui/menu.js";
+export * from "./ui/message-bubble.js";
+export * from "./ui/mic-button.js";
+export * from "./ui/mic-permission-dialog.js";
+export * from "./ui/notifications-bell.js";
+export * from "./ui/now-cards.js";
+export * from "./ui/page-panel.js";
+export * from "./ui/page-shell.js";
+export * from "./ui/parts-renderer.js";
+export * from "./ui/profile-card.js";
+export * from "./ui/progress-checklist.js";
+export * from "./ui/provider-mark.js";
+export * from "./ui/quick-reply-chips.js";
+export * from "./ui/quote-card.js";
+export * from "./ui/reasoning-block.js";
+export * from "./ui/research-body.js";
+export * from "./ui/rich-empty-state.js";
+export * from "./ui/run-now-button.js";
+export * from "./ui/section.js";
+export * from "./ui/select.js";
+export * from "./ui/selection-checkbox.js";
+export * from "./ui/settings-panel.js";
+export * from "./ui/shimmer-text.js";
+export * from "./ui/sidebar.js";
+export * from "./ui/sidebar-item-row.js";
+export * from "./ui/sidebar-panel.js";
+export * from "./ui/skeleton.js";
+export * from "./ui/sortable-table.js";
+export * from "./ui/sparkline.js";
+export * from "./ui/stat-grid.js";
+export * from "./ui/status-dot.js";
+export * from "./ui/step-list.js";
+export * from "./ui/switch.js";
+export * from "./ui/table.js";
+export * from "./ui/tabs.js";
+export * from "./ui/textarea.js";
+export * from "./ui/theme-provider.js";
+export * from "./ui/theme-toggle.js";
+export * from "./ui/thinking-indicator.js";
+export * from "./ui/thinking-label.js";
+export * from "./ui/thinking-mark.js";
+export * from "./ui/time-series-chart.js";
+export * from "./ui/toast.js";
+export * from "./ui/token-mosaic.js";
+export * from "./ui/tool-block.js";
+export * from "./ui/tool-narrative.js";
+export * from "./ui/tool-picker.js";
+export * from "./ui/tooltip.js";
+export * from "./ui/top-bar.js";
+export * from "./ui/trace-waterfall.js";
+export * from "./ui/typing-indicator.js";
+export * from "./ui/view-toggle.js";
+export * from "./ui/voice-waveform.js";

package/dist/index.js

@@ -0,0 +1,131 @@
+// Generated by scripts/generate-exports.mjs. Do not edit.
+//
+// Re-exports only, and the package is sideEffects-free, so importing from
+// the root still tree-shakes down to what you used.
+//
+// Modules that statically import an optional peer dependency are absent here
+// on purpose and must be imported by their subpath. The barrel is a single
+// module: anything it re-exports is loaded by any root import, so one such
+// re-export would make the optional peer mandatory for everyone.
+export * from "./blocks/login/auth-layout.js";
+export * from "./blocks/login/login-form.js";
+export * from "./hooks/use-command-palette-navigation.js";
+export * from "./hooks/use-controllable-state.js";
+export * from "./hooks/use-delayed-autofocus.js";
+export * from "./hooks/use-dismissable-popover.js";
+export * from "./hooks/use-list-selection.js";
+export * from "./hooks/use-prefers-reduced-motion.js";
+export * from "./hooks/use-scroll-current-into-view.js";
+export * from "./lib/artifact.js";
+export * from "./lib/chart-palette.js";
+export * from "./lib/chat-message.js";
+export * from "./lib/chat-parts.js";
+export * from "./lib/csv.js";
+export * from "./lib/metrics.js";
+export * from "./lib/now-item.js";
+export * from "./lib/relative-time.js";
+export * from "./lib/theme.js";
+export * from "./lib/url.js";
+export * from "./lib/utils.js";
+export * from "./lib/workflow-display-flow.js";
+export * from "./lib/workflow-registry.js";
+export * from "./lib/workflow-run.js";
+export * from "./lib/workflow-run-error.js";
+export * from "./lib/workflow-run-progress.js";
+export * from "./ui/agent-turn.js";
+export * from "./ui/animated-number.js";
+export * from "./ui/approval-card.js";
+export * from "./ui/artifact-body.js";
+export * from "./ui/artifact-notice.js";
+export * from "./ui/avatar.js";
+export * from "./ui/badge.js";
+export * from "./ui/bar-chart.js";
+export * from "./ui/block-card.js";
+export * from "./ui/boot-screen.js";
+export * from "./ui/bulk-action-bar.js";
+export * from "./ui/button.js";
+export * from "./ui/card.js";
+export * from "./ui/category-bars.js";
+export * from "./ui/chart-frame.js";
+export * from "./ui/chat-composer.js";
+export * from "./ui/chat-dock-timing.js";
+export * from "./ui/chat-input.js";
+export * from "./ui/chat-panel.js";
+export * from "./ui/chat-thread.js";
+export * from "./ui/checkbox.js";
+export * from "./ui/command-palette.js";
+export * from "./ui/compare-body.js";
+export * from "./ui/confirm-button.js";
+export * from "./ui/corbits-mark.js";
+export * from "./ui/csv-table.js";
+export * from "./ui/dialog.js";
+export * from "./ui/dictation-status-line.js";
+export * from "./ui/dither-canvas.js";
+export * from "./ui/embed-body.js";
+export * from "./ui/empty-state.js";
+export * from "./ui/file-input.js";
+export * from "./ui/filter-bar.js";
+export * from "./ui/filter-chip.js";
+export * from "./ui/gate-block.js";
+export * from "./ui/horizontal-stepper.js";
+export * from "./ui/input.js";
+export * from "./ui/inspector-shell.js";
+export * from "./ui/intake-form.js";
+export * from "./ui/kind-card-grid.js";
+export * from "./ui/library-page-header.js";
+export * from "./ui/list-detail.js";
+export * from "./ui/live-run-banner.js";
+export * from "./ui/live-status-line.js";
+export * from "./ui/menu.js";
+export * from "./ui/message-bubble.js";
+export * from "./ui/mic-button.js";
+export * from "./ui/mic-permission-dialog.js";
+export * from "./ui/notifications-bell.js";
+export * from "./ui/now-cards.js";
+export * from "./ui/page-panel.js";
+export * from "./ui/page-shell.js";
+export * from "./ui/parts-renderer.js";
+export * from "./ui/profile-card.js";
+export * from "./ui/progress-checklist.js";
+export * from "./ui/provider-mark.js";
+export * from "./ui/quick-reply-chips.js";
+export * from "./ui/quote-card.js";
+export * from "./ui/reasoning-block.js";
+export * from "./ui/research-body.js";
+export * from "./ui/rich-empty-state.js";
+export * from "./ui/run-now-button.js";
+export * from "./ui/section.js";
+export * from "./ui/select.js";
+export * from "./ui/selection-checkbox.js";
+export * from "./ui/settings-panel.js";
+export * from "./ui/shimmer-text.js";
+export * from "./ui/sidebar.js";
+export * from "./ui/sidebar-item-row.js";
+export * from "./ui/sidebar-panel.js";
+export * from "./ui/skeleton.js";
+export * from "./ui/sortable-table.js";
+export * from "./ui/sparkline.js";
+export * from "./ui/stat-grid.js";
+export * from "./ui/status-dot.js";
+export * from "./ui/step-list.js";
+export * from "./ui/switch.js";
+export * from "./ui/table.js";
+export * from "./ui/tabs.js";
+export * from "./ui/textarea.js";
+export * from "./ui/theme-provider.js";
+export * from "./ui/theme-toggle.js";
+export * from "./ui/thinking-indicator.js";
+export * from "./ui/thinking-label.js";
+export * from "./ui/thinking-mark.js";
+export * from "./ui/time-series-chart.js";
+export * from "./ui/toast.js";
+export * from "./ui/token-mosaic.js";
+export * from "./ui/tool-block.js";
+export * from "./ui/tool-narrative.js";
+export * from "./ui/tool-picker.js";
+export * from "./ui/tooltip.js";
+export * from "./ui/top-bar.js";
+export * from "./ui/trace-waterfall.js";
+export * from "./ui/typing-indicator.js";
+export * from "./ui/view-toggle.js";
+export * from "./ui/voice-waveform.js";

package/dist/lib/artifact.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The shape an artifact surface renders.
+ *
+ * Deliberately not a mirror of any producer's row type: the registry has no
+ * backend, so this is the projection a viewer actually needs — an identity, a
+ * name, a kind, a payload, and enough provenance to caption a tile. Map your
+ * own record onto it at the edge of your app and the whole artifacts family
+ * works unchanged.
+ */
+export type Artifact = {
+    readonly id: string;
+    readonly title: string;
+    /**
+     * Open vocabulary, owned by whatever produced the artifact — "one-pager",
+     * "csv-export", "deck". It is a plain string rather than a union because the
+     * registry cannot know your kinds, and a union here would force every
+     * consumer to fork this file on their first new kind.
+     */
+    readonly kind: string;
+    /**
+     * The payload. Prose kinds carry text, embed kinds carry a URL, structured
+     * kinds carry JSON. Empty is a legitimate value — see `pending`.
+     */
+    readonly content: string;
+    readonly createdAt: string;
+    readonly updatedAt?: string;
+    readonly ownerName?: string;
+    /**
+     * The producer is still writing this one. An empty `content` means "not
+     * written yet" rather than "broken", and the viewer must say which — an
+     * artifact that reads as damaged while it is merely mid-generation is the
+     * single most common false alarm on this surface.
+     */
+    readonly pending?: boolean;
+    /** A preview image the host can serve, when it has one. */
+    readonly thumbnailUrl?: string;
+    /** The original bytes, when the host exposes a download route. */
+    readonly downloadUrl?: string;
+};
+/**
+ * How an artifact should be *drawn*, as opposed to what it is called.
+ *
+ * A closed union, unlike `kind`: there are only so many ways to present a
+ * payload, and every one of them is a component in this registry. Kinds
+ * multiply; forms do not.
+ */
+export type ArtifactForm = "prose" | "table" | "comparison" | "research" | "embed" | "image" | "download";
+/**
+ * Guesses a form from a kind string, defaulting to prose.
+ *
+ * **This is the function you edit.** It is a plain lookup, not a plugin
+ * registry, precisely because you own this file once `shadcn add` copies it —
+ * adding a kind should be one line here, readable at a glance, not a
+ * registration call into machinery you have to go read. The regexes cover the
+ * naming conventions kinds usually arrive with; replace them with an explicit
+ * `Record<string, ArtifactForm>` the moment your vocabulary is closed enough to
+ * enumerate, which is strictly better than pattern-matching once you can.
+ *
+ * Prose is the default because it is the only form that cannot mislead: text
+ * rendered as text is always honest, whereas a non-tabular payload forced into
+ * a grid silently shifts cells into the wrong columns.
+ */
+export declare function artifactForm(kind: string): ArtifactForm;
+/**
+ * "sales-one-pager" → "Sales one pager".
+ *
+ * Derived rather than looked up: a hand-maintained label map goes stale the
+ * first time a producer ships a kind nobody told the UI about, and an unlabelled
+ * tile is worse than a mechanically-titled one. Pass your own labels through
+ * the `kindLabel` prop where a surface offers it if you need better copy.
+ */
+export declare function artifactKindLabel(kind: string): string;

package/dist/lib/artifact.js

@@ -0,0 +1,67 @@
+/**
+ * The shape an artifact surface renders.
+ *
+ * Deliberately not a mirror of any producer's row type: the registry has no
+ * backend, so this is the projection a viewer actually needs — an identity, a
+ * name, a kind, a payload, and enough provenance to caption a tile. Map your
+ * own record onto it at the edge of your app and the whole artifacts family
+ * works unchanged.
+ */ const FORM_BY_SUFFIX = [
+    [
+        /(^|-)csv(-|$)|(^|-)sheet(-|$)|(^|-)table(-|$)/,
+        "table"
+    ],
+    [
+        /(^|-)comparison(-|$)|(^|-)compare(-|$)|^ab-/,
+        "comparison"
+    ],
+    [
+        /(^|-)research(-|$)|(^|-)brief(-|$)/,
+        "research"
+    ],
+    [
+        /(^|-)deck(-|$)|(^|-)presentation(-|$)|(^|-)slides(-|$)|(^|-)embed(-|$)/,
+        "embed"
+    ],
+    [
+        /(^|-)image(-|$)|(^|-)photo(-|$)|(^|-)screenshot(-|$)/,
+        "image"
+    ],
+    [
+        /(^|-)file(-|$)|(^|-)upload(-|$)|(^|-)binary(-|$)/,
+        "download"
+    ]
+];
+/**
+ * Guesses a form from a kind string, defaulting to prose.
+ *
+ * **This is the function you edit.** It is a plain lookup, not a plugin
+ * registry, precisely because you own this file once `shadcn add` copies it —
+ * adding a kind should be one line here, readable at a glance, not a
+ * registration call into machinery you have to go read. The regexes cover the
+ * naming conventions kinds usually arrive with; replace them with an explicit
+ * `Record<string, ArtifactForm>` the moment your vocabulary is closed enough to
+ * enumerate, which is strictly better than pattern-matching once you can.
+ *
+ * Prose is the default because it is the only form that cannot mislead: text
+ * rendered as text is always honest, whereas a non-tabular payload forced into
+ * a grid silently shifts cells into the wrong columns.
+ */ export function artifactForm(kind) {
+    const normalized = kind.trim().toLowerCase();
+    for (const [pattern, form] of FORM_BY_SUFFIX){
+        if (pattern.test(normalized)) return form;
+    }
+    return "prose";
+}
+/**
+ * "sales-one-pager" → "Sales one pager".
+ *
+ * Derived rather than looked up: a hand-maintained label map goes stale the
+ * first time a producer ships a kind nobody told the UI about, and an unlabelled
+ * tile is worse than a mechanically-titled one. Pass your own labels through
+ * the `kindLabel` prop where a surface offers it if you need better copy.
+ */ export function artifactKindLabel(kind) {
+    const words = kind.trim().replace(/[_-]+/g, " ").replace(/\s+/g, " ");
+    if (words === "") return "Artifact";
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}