@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/media/FileBrowser.js

@@ -0,0 +1,158 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Breadcrumbs, Checkbox, EmptyState, IconButton, IconTile, MonoText, SegmentedControl } from '@adminium/ui';
+import { LayoutGrid, List, Star } from 'lucide-react';
+import { useMemo, useState } from 'react';
+import { fileIconFor } from './media-icons.js';
+import { FILE_KIND_TONE, ROOT_ID, bindingSourceOf, booleanField, breadcrumbTrail, childrenOf, descendantCount, fileRowsOf, formatCount, formatModified, formatModifiedFull, formatSize, kindOf, numberField, resolveLocale, stringField, } from './media-lib.js';
+import { fileBrowserConfigSchema, fileBrowserDemoData } from './media-config.js';
+export { fileBrowserConfigSchema, fileBrowserDemoData };
+/** Placeholder for a folder's size cell — folders have no byte size. */
+const EM_DASH = '—';
+export function FileBrowser({ nodes, views = 'both', defaultView = 'grid', starrable = true, selectable = false, smartFolders, typeIconMap, locale, rootLabel, breadcrumbLabel, gridViewLabel, listViewLabel, nameHeader, sizeHeader, modifiedHeader, starLabel, itemsLabel, emptyTitle, emptyBody, folderId, onFolderChange, onOpenFile, onToggleStar, onSelectionChange, testId, }) {
+    const tag = resolveLocale(locale);
+    const [localFolder, setLocalFolder] = useState(ROOT_ID);
+    const [view, setView] = useState(views === 'both' ? defaultView : views);
+    const [smartKey, setSmartKey] = useState(null);
+    const [selected, setSelected] = useState([]);
+    const current = folderId ?? localFolder;
+    const effectiveView = views === 'both' ? view : views;
+    const collator = useMemo(() => new Intl.Collator(tag, { numeric: true }), [tag]);
+    const smart = smartFolders?.find((entry) => entry.key === smartKey);
+    const trail = useMemo(() => breadcrumbTrail(nodes, current), [nodes, current]);
+    /**
+     * The rows on screen. A smart folder REPLACES the hierarchy view with a flat
+     * filtered list (the File Manager rail's semantics: "Starred" spans folders);
+     * otherwise it is the current folder's direct children, folders first.
+     */
+    const visible = useMemo(() => {
+        if (smart !== undefined && smart.filter !== 'folder') {
+            return flatFilter(nodes, smart.filter, collator);
+        }
+        const target = smart?.filter === 'folder' && smart.folderId !== undefined ? smart.folderId : current;
+        return childrenOf(nodes, target, collator);
+    }, [nodes, smart, current, collator]);
+    const navigate = (next) => {
+        setSmartKey(null);
+        if (folderId === undefined)
+            setLocalFolder(next);
+        onFolderChange?.(next);
+    };
+    const openNode = (node) => {
+        if (node.kind === 'folder')
+            navigate(node.id);
+        else
+            onOpenFile?.(node);
+    };
+    const toggleSelected = (id) => {
+        const next = selected.includes(id) ? selected.filter((value) => value !== id) : [...selected, id];
+        setSelected(next);
+        onSelectionChange?.(next);
+    };
+    const crumbs = [
+        { label: rootLabel ?? 'Files', onClick: () => navigate(ROOT_ID) },
+        ...trail.map((node) => ({ label: node.name, onClick: () => navigate(node.id) })),
+    ];
+    return (_jsxs("div", { "data-widget": "file-browser", "data-testid": testId, className: "flex h-full min-h-0 flex-col", children: [_jsxs("div", { className: "flex items-center gap-3 border-b border-border px-4 py-2.5", children: [_jsx(Breadcrumbs, { items: crumbs, label: breadcrumbLabel ?? 'Breadcrumb', className: "flex-1" }), views === 'both' && (_jsx(SegmentedControl, { value: effectiveView, onValueChange: (next) => setView(next === 'list' ? 'list' : 'grid'), options: [
+                            { value: 'grid', ariaLabel: gridViewLabel ?? 'Grid view', icon: _jsx(LayoutGrid, { className: "size-4" }) },
+                            { value: 'list', ariaLabel: listViewLabel ?? 'List view', icon: _jsx(List, { className: "size-4" }) },
+                        ] }))] }), _jsxs("div", { className: "flex min-h-0 flex-1", children: [smartFolders !== undefined && smartFolders.length > 0 && (_jsx("nav", { className: "w-48 shrink-0 space-y-0.5 overflow-auto border-e border-border p-2", "aria-label": rootLabel ?? 'Files', children: smartFolders.map((entry) => {
+                            const active = entry.key === smartKey;
+                            const count = flatFilter(nodes, entry.filter, collator, entry.folderId).length;
+                            return (_jsxs("button", { type: "button", "data-part": "smart-folder", "data-active": active ? '' : undefined, "aria-current": active ? 'true' : undefined, onClick: () => setSmartKey(active ? null : entry.key), className: 'flex w-full items-center gap-2.5 rounded-md px-2.5 py-2 text-body-sm font-semibold ' +
+                                    'focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent ' +
+                                    (active ? 'bg-accent-soft text-accent' : 'text-fg-muted hover:bg-surface-2 hover:text-fg'), children: [_jsx("span", { className: "flex-1 text-start", children: entry.label ?? entry.key }), _jsx(MonoText, { className: "text-caption text-fg-subtle", children: formatCount(count, tag) })] }, entry.key));
+                        }) })), _jsx("div", { className: "min-w-0 flex-1 overflow-auto", children: visible.length === 0 ? (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'This folder is empty', body: emptyBody ?? 'Upload files or create a folder to get started.' })) : effectiveView === 'grid' ? (_jsx("ul", { className: "grid grid-cols-[repeat(auto-fill,minmax(10.5rem,1fr))] gap-3.5 p-4", children: visible.map((node) => (_jsxs("li", { className: "relative", children: [_jsxs("button", { type: "button", "data-part": "file-tile", "data-kind": node.kind, onClick: () => openNode(node), className: 'group flex w-full flex-col rounded-lg border border-border bg-surface p-4 text-start ' +
+                                            'transition-shadow duration-150 hover:border-border-strong hover:shadow-md ' +
+                                            'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: [_jsx(IconTile, { size: "lg", tone: FILE_KIND_TONE[node.kind], icon: fileIconFor(node.kind, undefined, node.name, typeIconMap) }), _jsx("span", { className: "mt-3 truncate text-body-sm font-bold text-fg", children: node.name }), _jsx("span", { className: "mt-0.5 truncate text-caption text-fg-subtle", children: metaLine(node, nodes, tag, itemsLabel) })] }), starrable && _jsx(StarToggle, { node: node, label: starLabel, onToggle: onToggleStar, className: "absolute end-3 top-3" }), selectable && (_jsx("span", { className: "absolute start-3 top-3", children: _jsx(Checkbox, { checked: selected.includes(node.id), onCheckedChange: () => toggleSelected(node.id), "aria-label": node.name }) }))] }, node.id))) })) : (_jsxs("table", { "data-part": "file-table", className: "w-full border-collapse", children: [_jsx("thead", { children: _jsxs("tr", { className: "border-b border-border text-caption font-bold uppercase tracking-wide text-fg-subtle", children: [selectable && _jsx("th", { scope: "col", className: "w-10 px-4 py-2.5" }), _jsx("th", { scope: "col", className: "px-4 py-2.5 text-start", children: nameHeader ?? 'Name' }), _jsx("th", { scope: "col", className: "w-28 px-4 py-2.5 text-start", children: sizeHeader ?? 'Size' }), _jsx("th", { scope: "col", className: "w-32 px-4 py-2.5 text-start", children: modifiedHeader ?? 'Modified' }), starrable && _jsx("th", { scope: "col", className: "w-12 px-4 py-2.5" })] }) }), _jsx("tbody", { children: visible.map((node) => (_jsxs("tr", { "data-part": "file-row", "data-kind": node.kind, className: "border-b border-border hover:bg-surface-2", children: [selectable && (_jsx("td", { className: "px-4 py-2.5", children: _jsx(Checkbox, { checked: selected.includes(node.id), onCheckedChange: () => toggleSelected(node.id), "aria-label": node.name }) })), _jsx("td", { className: "px-4 py-2.5", children: _jsxs("button", { type: "button", onClick: () => openNode(node), className: 'flex w-full min-w-0 items-center gap-3 text-start ' +
+                                                        'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: [_jsx(IconTile, { size: "sm", tone: FILE_KIND_TONE[node.kind], icon: fileIconFor(node.kind, undefined, node.name, typeIconMap) }), _jsx("span", { className: "truncate text-body-sm font-semibold text-fg", children: node.name })] }) }), _jsx("td", { className: "px-4 py-2.5", children: _jsx(MonoText, { className: "text-body-sm text-fg-muted", children: node.kind === 'folder' ? EM_DASH : (formatSize(node.size, tag) ?? EM_DASH) }) }), _jsx("td", { className: "px-4 py-2.5 text-body-sm text-fg-muted", children: node.modified === undefined ? (EM_DASH) : (_jsx("time", { dateTime: node.modified, title: formatModifiedFull(node.modified, tag), children: formatModified(node.modified, tag) ?? EM_DASH })) }), starrable && (_jsx("td", { className: "px-4 py-2.5", children: _jsx(StarToggle, { node: node, label: starLabel, onToggle: onToggleStar }) }))] }, node.id))) })] })) })] })] }));
+}
+/**
+ * The hover star toggle. Optimistic-free: the widget renders `node.starred` and
+ * reports the intent — the host owns the write (04 §2, `capabilities.editsData`).
+ */
+function StarToggle({ node, label, onToggle, className, }) {
+    return (_jsx(IconButton, { size: "sm", "data-part": "star-toggle", "data-starred": node.starred ? '' : undefined, "aria-pressed": node.starred, label: label ?? 'Star', onClick: () => onToggle?.(node, !node.starred), className: `${node.starred ? 'text-warn' : 'text-fg-subtle'} ${className ?? ''}`, children: _jsx(Star, { className: "size-3.5", ...(node.starred ? { fill: 'currentColor' } : {}) }) }));
+}
+/**
+ * Tile sub-label: "12 items" for a folder, "2.4 MB · Sep 12" for a file.
+ *
+ * `count` is OPTIONAL in the annex §8 contract — a real file table (name + size
+ * + parent self-FK) has no materialized count column — so a folder with no
+ * `countField` binding falls back to counting its children in the payload's own
+ * self-FK hierarchy rather than asserting a false "0 items".
+ */
+function metaLine(node, nodes, locale, itemsLabel) {
+    if (node.kind === 'folder') {
+        return `${formatCount(node.count ?? descendantCount(nodes, node.id), locale)} ${itemsLabel ?? 'items'}`;
+    }
+    return [formatSize(node.size, locale), formatModified(node.modified, locale)].filter((part) => part !== undefined).join(' · ');
+}
+/** Rows for a smart-folder rail entry (also drives its live count). */
+function flatFilter(nodes, filter, collator, folderId) {
+    if (filter === 'folder')
+        return childrenOf(nodes, folderId ?? ROOT_ID, collator);
+    if (filter === 'starred')
+        return nodes.filter((node) => node.starred);
+    if (filter === 'recent') {
+        return [...nodes]
+            .filter((node) => node.kind !== 'folder' && node.modified !== undefined)
+            .sort((a, b) => (b.modified ?? '').localeCompare(a.modified ?? ''))
+            .slice(0, 8);
+    }
+    // 'all' spans the WHOLE hierarchy, like its `starred`/`recent` siblings — the
+    // rail's "All files · N" must not stop at the root folder's direct children.
+    return nodes
+        .filter((node) => node.kind !== 'folder')
+        .sort((a, b) => collator.compare(a.name, b.name));
+}
+/**
+ * Project an untrusted `record-list` onto `FileNode`s using the config's field
+ * naming. Rows without a usable id are dropped (a React key must be stable);
+ * everything else degrades to a sensible default rather than throwing.
+ */
+export function fileNodesOf(data, config) {
+    return fileRowsOf(data)
+        .map((row, index) => {
+        const id = stringField(row, config.idField) ?? `row-${index}`;
+        const name = stringField(row, config.nameField) ?? id;
+        const rawParent = row[config.parentField];
+        return {
+            id,
+            name,
+            kind: kindOf(row[config.typeField], row[config.mimeField], name),
+            parentId: typeof rawParent === 'string' && rawParent !== '' ? rawParent : null,
+            size: numberField(row, config.sizeField),
+            count: numberField(row, config.countField),
+            modified: stringField(row, config.modifiedField),
+            starred: booleanField(row, config.starredField),
+            url: stringField(row, config.urlField),
+        };
+    })
+        .filter((node) => node !== null);
+}
+export function FileBrowserWidget({ config, data, onEvent }) {
+    const nodes = fileNodesOf(data, config);
+    const source = bindingSourceOf(config.binding);
+    return (_jsx(FileBrowser, { nodes: nodes, views: config.views, defaultView: config.defaultView, starrable: config.starrable, selectable: config.selectable, ...(config.smartFolders === undefined ? {} : { smartFolders: config.smartFolders }), ...(config.typeIconMap === undefined ? {} : { typeIconMap: config.typeIconMap }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.rootLabel === undefined ? {} : { rootLabel: config.rootLabel }), ...(config.breadcrumbLabel === undefined ? {} : { breadcrumbLabel: config.breadcrumbLabel }), ...(config.gridViewLabel === undefined ? {} : { gridViewLabel: config.gridViewLabel }), ...(config.listViewLabel === undefined ? {} : { listViewLabel: config.listViewLabel }), ...(config.nameHeader === undefined ? {} : { nameHeader: config.nameHeader }), ...(config.sizeHeader === undefined ? {} : { sizeHeader: config.sizeHeader }), ...(config.modifiedHeader === undefined ? {} : { modifiedHeader: config.modifiedHeader }), ...(config.starLabel === undefined ? {} : { starLabel: config.starLabel }), ...(config.itemsLabel === undefined ? {} : { itemsLabel: config.itemsLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), onOpenFile: (node) => {
+            // Bound → let the host open the record (preview/download/route is its
+            // call); unbound demo data → the row's own url is the only target.
+            if (source !== null) {
+                onEvent({ type: 'record-open', connectionId: source.connectionId, table: source.table, recordId: node.id });
+            }
+            else if (node.url !== undefined) {
+                onEvent({ type: 'drill-through', href: node.url });
+            }
+        }, onToggleStar: (node, next) => {
+            if (source === null)
+                return; // unbound: nothing to write to
+            onEvent({
+                type: 'mutate',
+                intent: 'update',
+                connectionId: source.connectionId,
+                table: source.table,
+                recordId: node.id,
+                values: { [config.starredField]: next },
+            });
+        } }));
+}
+//# sourceMappingURL=FileBrowser.js.map

package/dist/families/media/FileBrowser.js.map

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

package/dist/families/media/ImageBoard.d.ts

@@ -0,0 +1,41 @@
+import { imageBoardConfigSchema, imageBoardDemoData } from './media-config.js';
+import type { ImageBoardConfig } from './media-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { imageBoardConfigSchema, imageBoardDemoData };
+export type { ImageBoardConfig };
+/**
+ * `image-board` (annex §8) — the moodboard grid of droppable image slots with
+ * captions and an Add-image slot. Niche but broadly useful: any table with an
+ * image-URL column (product photos, property listings, design refs) auto-
+ * instantiates onto it (annex §8).
+ *
+ * An EMPTY slot is a first-class state, not a loading artefact: the annex's
+ * droppable placeholder ("Drop reference") is what an unfilled row renders. A
+ * broken/blocked image URL degrades to the same placeholder via `onError` rather
+ * than showing the browser's torn-image glyph.
+ */
+export interface BoardImage {
+    id: string;
+    imageUrl?: string | undefined;
+    caption?: string | undefined;
+    placeholder?: string | undefined;
+}
+export interface ImageBoardProps {
+    images: readonly BoardImage[];
+    columns?: number | undefined;
+    editableCaptions?: boolean | undefined;
+    allowAdd?: boolean | undefined;
+    addLabel?: string | undefined;
+    captionLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onCaptionChange?: ((image: BoardImage, caption: string) => void) | undefined;
+    onAdd?: (() => void) | undefined;
+    onOpen?: ((image: BoardImage) => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function ImageBoard({ images, columns, editableCaptions, allowAdd, addLabel, captionLabel, emptyTitle, emptyBody, onCaptionChange, onAdd, onOpen, testId, }: ImageBoardProps): import("react").JSX.Element;
+/** Project an untrusted `record-list` onto `BoardImage`s via the field naming. */
+export declare function boardImagesOf(data: unknown, config: ImageBoardConfig): BoardImage[];
+export declare function ImageBoardWidget({ config, data, onEvent }: WidgetProps<ImageBoardConfig>): import("react").JSX.Element;
+//# sourceMappingURL=ImageBoard.d.ts.map

package/dist/families/media/ImageBoard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageBoard.d.ts","sourceRoot":"","sources":["../../../src/families/media/ImageBoard.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7E,KAAK,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAgBD,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,OAAW,EACX,gBAAwB,EACxB,QAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,SAAS,EACT,eAAe,EACf,KAAK,EACL,MAAM,EACN,MAAM,GACP,EAAE,eAAe,+BAsFjB;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAOnF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,gBAAgB,CAAC,+BA+BxF"}

package/dist/families/media/ImageBoard.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { EmptyState, IconTile } from '@adminium/ui';
+import { ImageIcon, Plus } from 'lucide-react';
+import { useState } from 'react';
+import { bindingSourceOf, fileRowsOf, stringField } from './media-lib.js';
+import { imageBoardConfigSchema, imageBoardDemoData } from './media-config.js';
+export { imageBoardConfigSchema, imageBoardDemoData };
+/**
+ * Column count → a static Tailwind grid class. A template literal
+ * (`grid-cols-${n}`) would not survive Tailwind's static extraction — the class
+ * must appear verbatim in the source to be emitted.
+ */
+const COLUMN_CLASS = {
+    1: 'grid-cols-1',
+    2: 'grid-cols-2',
+    3: 'grid-cols-3',
+    4: 'grid-cols-4',
+    5: 'grid-cols-5',
+    6: 'grid-cols-6',
+};
+export function ImageBoard({ images, columns = 2, editableCaptions = false, allowAdd = false, addLabel, captionLabel, emptyTitle, emptyBody, onCaptionChange, onAdd, onOpen, testId, }) {
+    // Slots whose image failed to load fall back to the placeholder.
+    const [broken, setBroken] = useState([]);
+    if (images.length === 0 && !allowAdd) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No images yet', body: emptyBody ?? 'Reference images will appear on this board.' }));
+    }
+    return (_jsx("div", { "data-widget": "image-board", "data-testid": testId, className: "h-full overflow-auto p-4", children: _jsxs("ul", { className: `grid gap-3.5 ${COLUMN_CLASS[columns] ?? COLUMN_CLASS[2]}`, children: [images.map((image) => {
+                    const failed = broken.includes(image.id);
+                    const src = failed ? undefined : image.imageUrl;
+                    return (_jsxs("li", { "data-part": "image-slot", "data-filled": src === undefined ? undefined : '', children: [_jsx("div", { className: "relative aspect-[4/3] w-full overflow-hidden rounded-lg border border-border bg-surface-2", children: src === undefined ? (_jsxs("div", { className: "flex h-full flex-col items-center justify-center gap-2 text-fg-subtle", children: [_jsx(ImageIcon, { "aria-hidden": "true", className: "size-6" }), _jsx("span", { className: "text-caption font-semibold", children: image.placeholder ?? 'Drop reference' })] })) : (_jsx("button", { type: "button", onClick: () => onOpen?.(image), className: "block size-full focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-accent", children: _jsx("img", { src: src, alt: image.caption ?? '', loading: "lazy", onError: () => setBroken((prev) => (prev.includes(image.id) ? prev : [...prev, image.id])), className: "size-full object-cover" }) })) }), editableCaptions ? (_jsx("input", { "data-part": "image-caption", "aria-label": captionLabel ?? 'Caption', defaultValue: image.caption ?? '', onBlur: (event) => onCaptionChange?.(image, event.currentTarget.value), className: 'mt-2 w-full rounded-md border border-transparent bg-transparent px-1.5 py-1 text-caption ' +
+                                    'font-semibold text-fg-muted hover:border-border focus:border-accent focus:outline-none' })) : (image.caption !== undefined && (_jsx("p", { "data-part": "image-caption", className: "mt-2 text-caption font-semibold text-fg-muted", children: image.caption })))] }, image.id));
+                }), allowAdd && (_jsx("li", { children: _jsxs("button", { type: "button", "data-part": "image-add", onClick: onAdd, className: 'flex aspect-[4/3] w-full flex-col items-center justify-center gap-2 rounded-lg border-2 ' +
+                            'border-dashed border-border-strong text-fg-subtle transition-colors duration-150 ' +
+                            'hover:border-accent hover:text-accent focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: [_jsx(IconTile, { size: "md", tone: "accent", icon: _jsx(Plus, {}) }), _jsx("span", { className: "text-caption font-bold", children: addLabel ?? 'Add image' })] }) }))] }) }));
+}
+/** Project an untrusted `record-list` onto `BoardImage`s via the field naming. */
+export function boardImagesOf(data, config) {
+    return fileRowsOf(data).map((row, index) => ({
+        id: stringField(row, config.idField) ?? `image-${index}`,
+        imageUrl: stringField(row, config.imageField),
+        caption: stringField(row, config.captionField),
+        placeholder: stringField(row, config.placeholderField),
+    }));
+}
+export function ImageBoardWidget({ config, data, onEvent }) {
+    const source = bindingSourceOf(config.binding);
+    return (_jsx(ImageBoard, { images: boardImagesOf(data, config), columns: config.columns, 
+        // An editable caption is a write: only offer it when a binding exists to
+        // write to, else the field would silently swallow every edit.
+        editableCaptions: config.editableCaptions && source !== null, allowAdd: config.allowAdd, ...(config.addLabel === undefined ? {} : { addLabel: config.addLabel }), ...(config.captionLabel === undefined ? {} : { captionLabel: config.captionLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), onOpen: (image) => {
+            const href = image.imageUrl ?? config.href;
+            if (href !== undefined)
+                onEvent({ type: 'drill-through', href });
+        }, onCaptionChange: (image, caption) => {
+            if (source === null || caption === (image.caption ?? ''))
+                return; // no-op blur
+            onEvent({
+                type: 'mutate',
+                intent: 'update',
+                connectionId: source.connectionId,
+                table: source.table,
+                recordId: image.id,
+                values: { [config.captionField]: caption },
+            });
+        } }));
+}
+//# sourceMappingURL=ImageBoard.js.map

package/dist/families/media/ImageBoard.js.map

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

package/dist/families/media/LinkList.d.ts

@@ -0,0 +1,48 @@
+import { linkListConfigSchema, linkListDemoData } from './media-config.js';
+import type { LinkListConfig } from './media-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { linkListConfigSchema, linkListDemoData };
+export type { LinkListConfig };
+/**
+ * `link-list` (annex §8) — reference-link rows: an icon chip, the title, the mono
+ * URL, an external-link arrow, a hover delete, and an inline add-composer. The
+ * read-only "resources" variant (`editable: false`) is what Workspace Onboarding
+ * and the 404 quick-links render; the auto-instantiation target for URL columns
+ * (annex §8).
+ *
+ * SAFETY: rows carry URLs from a database column — untrusted input. Only
+ * `http(s)` links become anchors (a `javascript:`/`data:` URL would otherwise be
+ * a stored-XSS sink via `href`); anything else renders as inert text. External
+ * links always get `rel="noreferrer noopener"` so the target can never reach back
+ * through `window.opener`.
+ */
+export interface ReferenceLink {
+    id: string;
+    title: string;
+    url: string;
+}
+export interface LinkListProps {
+    links: readonly ReferenceLink[];
+    editable?: boolean | undefined;
+    newTab?: boolean | undefined;
+    addLabel?: string | undefined;
+    titlePlaceholder?: string | undefined;
+    urlPlaceholder?: string | undefined;
+    submitLabel?: string | undefined;
+    deleteLabel?: string | undefined;
+    emptyTitle?: string | undefined;
+    emptyBody?: string | undefined;
+    onAdd?: ((link: {
+        title: string;
+        url: string;
+    }) => void) | undefined;
+    onDelete?: ((link: ReferenceLink) => void) | undefined;
+    testId?: string | undefined;
+}
+/** Only `http(s)` URLs may become an `href` — everything else renders inert. */
+export declare function isSafeHref(url: string): boolean;
+export declare function LinkList({ links, editable, newTab, addLabel, titlePlaceholder, urlPlaceholder, submitLabel, deleteLabel, emptyTitle, emptyBody, onAdd, onDelete, testId, }: LinkListProps): import("react").JSX.Element;
+/** Project an untrusted `record-list` onto `ReferenceLink`s via the field naming. */
+export declare function referenceLinksOf(data: unknown, config: LinkListConfig): ReferenceLink[];
+export declare function LinkListWidget({ config, data, onEvent }: WidgetProps<LinkListConfig>): import("react").JSX.Element;
+//# sourceMappingURL=LinkList.d.ts.map

package/dist/families/media/LinkList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkList.d.ts","sourceRoot":"","sources":["../../../src/families/media/LinkList.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,QAAgB,EAChB,MAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE,aAAa,+BAiIf;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAMvF;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,cAAc,CAAC,+BAqCpF"}

package/dist/families/media/LinkList.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button, EmptyState, IconButton, IconTile, Input, MonoText } from '@adminium/ui';
+import { ArrowUpRight, Plus, X } from 'lucide-react';
+import { useState } from 'react';
+import { linkIcon } from './media-icons.js';
+import { bindingSourceOf, displayUrl, fileRowsOf, stringField } from './media-lib.js';
+import { linkListConfigSchema, linkListDemoData } from './media-config.js';
+export { linkListConfigSchema, linkListDemoData };
+/** Only `http(s)` URLs may become an `href` — everything else renders inert. */
+export function isSafeHref(url) {
+    try {
+        const protocol = new URL(url, 'https://placeholder.invalid').protocol;
+        return protocol === 'http:' || protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+export function LinkList({ links, editable = false, newTab = true, addLabel, titlePlaceholder, urlPlaceholder, submitLabel, deleteLabel, emptyTitle, emptyBody, onAdd, onDelete, testId, }) {
+    const [composing, setComposing] = useState(false);
+    const [title, setTitle] = useState('');
+    const [url, setUrl] = useState('');
+    const submit = () => {
+        const nextTitle = title.trim();
+        const nextUrl = url.trim();
+        if (nextUrl === '')
+            return;
+        onAdd?.({ title: nextTitle === '' ? nextUrl : nextTitle, url: nextUrl });
+        setTitle('');
+        setUrl('');
+        setComposing(false);
+    };
+    if (links.length === 0 && !editable) {
+        return (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No links yet', body: emptyBody ?? 'Reference links will appear here.' }));
+    }
+    return (_jsxs("div", { "data-widget": "link-list", "data-testid": testId, className: "flex h-full flex-col", children: [editable && (_jsx("div", { className: "border-b border-border p-2", children: composing ? (_jsxs("div", { className: "flex items-center gap-2", "data-part": "link-composer", children: [_jsx(Input, { autoFocus: true, value: title, "aria-label": titlePlaceholder ?? 'Title', placeholder: titlePlaceholder ?? 'Title', onChange: (event) => setTitle(event.currentTarget.value), onKeyDown: (event) => {
+                                if (event.key === 'Enter')
+                                    submit();
+                                if (event.key === 'Escape')
+                                    setComposing(false);
+                            }, className: "flex-1" }), _jsx(Input, { value: url, "aria-label": urlPlaceholder ?? 'https://…', placeholder: urlPlaceholder ?? 'https://…', onChange: (event) => setUrl(event.currentTarget.value), onKeyDown: (event) => {
+                                if (event.key === 'Enter')
+                                    submit();
+                                if (event.key === 'Escape')
+                                    setComposing(false);
+                            }, className: "flex-[1.3] font-mono" }), _jsx(Button, { size: "sm", onClick: submit, "data-part": "link-submit", children: submitLabel ?? 'Add' })] })) : (_jsx(Button, { size: "sm", variant: "ghost", iconLeft: _jsx(Plus, {}), onClick: () => setComposing(true), "data-part": "link-add", children: addLabel ?? 'Add link' })) })), links.length === 0 ? (_jsx(EmptyState, { compact: true, preset: "no-data", title: emptyTitle ?? 'No links yet', body: emptyBody ?? 'Reference links will appear here.' })) : (_jsx("ul", { className: "flex-1 space-y-0.5 overflow-auto p-2", children: links.map((link) => {
+                    const safe = isSafeHref(link.url);
+                    const body = (_jsxs(_Fragment, { children: [_jsx(IconTile, { size: "md", tone: "neutral", icon: linkIcon() }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-body-sm font-bold text-fg", children: link.title }), _jsx(MonoText, { className: "block truncate text-caption text-accent", children: displayUrl(link.url) })] })] }));
+                    return (_jsxs("li", { "data-part": "link-row", "data-unsafe": safe ? undefined : '', className: "group flex items-center gap-3 rounded-lg px-2.5 py-2.5 hover:bg-surface-2", children: [safe ? (_jsx("a", { href: link.url, ...(newTab ? { target: '_blank' } : {}), rel: "noreferrer noopener", className: 'flex min-w-0 flex-1 items-center gap-3 rounded-md ' +
+                                    'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent', children: body })) : (
+                            // Non-http(s) URL from an untrusted column: show it, never link it.
+                            _jsx("span", { className: "flex min-w-0 flex-1 items-center gap-3", children: body })), editable && (_jsx(IconButton, { size: "sm", "data-part": "link-delete", label: deleteLabel ?? 'Remove', onClick: () => onDelete?.(link), className: "opacity-0 transition-opacity duration-100 hover:text-danger group-hover:opacity-100 focus-visible:opacity-100", children: _jsx(X, { className: "size-3.5" }) })), safe && _jsx(ArrowUpRight, { "aria-hidden": "true", className: "size-4 shrink-0 text-fg-subtle rtl:-scale-x-100" })] }, link.id));
+                }) }))] }));
+}
+/** Project an untrusted `record-list` onto `ReferenceLink`s via the field naming. */
+export function referenceLinksOf(data, config) {
+    return fileRowsOf(data).map((row, index) => {
+        const id = stringField(row, config.idField) ?? `link-${index}`;
+        const url = stringField(row, config.urlField) ?? '';
+        return { id, title: stringField(row, config.titleField) ?? url, url };
+    });
+}
+export function LinkListWidget({ config, data, onEvent }) {
+    const source = bindingSourceOf(config.binding);
+    return (_jsx(LinkList, { links: referenceLinksOf(data, config), 
+        // Editing is a write: only offer it when there is a table to write to.
+        editable: config.editable && source !== null, newTab: config.newTab, ...(config.addLabel === undefined ? {} : { addLabel: config.addLabel }), ...(config.titlePlaceholder === undefined ? {} : { titlePlaceholder: config.titlePlaceholder }), ...(config.urlPlaceholder === undefined ? {} : { urlPlaceholder: config.urlPlaceholder }), ...(config.submitLabel === undefined ? {} : { submitLabel: config.submitLabel }), ...(config.deleteLabel === undefined ? {} : { deleteLabel: config.deleteLabel }), ...(config.emptyTitle === undefined ? {} : { emptyTitle: config.emptyTitle }), ...(config.emptyBody === undefined ? {} : { emptyBody: config.emptyBody }), onAdd: (link) => {
+            if (source === null)
+                return;
+            onEvent({
+                type: 'mutate',
+                intent: 'insert',
+                connectionId: source.connectionId,
+                table: source.table,
+                values: { [config.titleField]: link.title, [config.urlField]: link.url },
+            });
+        }, onDelete: (link) => {
+            if (source === null)
+                return;
+            onEvent({
+                type: 'mutate',
+                intent: 'delete',
+                connectionId: source.connectionId,
+                table: source.table,
+                recordId: link.id,
+            });
+        } }));
+}
+//# sourceMappingURL=LinkList.js.map

package/dist/families/media/LinkList.js.map

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

package/dist/families/media/UploadDropzone.d.ts

@@ -0,0 +1,41 @@
+import { uploadDropzoneConfigSchema, uploadDropzoneDemoData } from './media-config.js';
+import type { UploadDropzoneConfig } from './media-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { uploadDropzoneConfigSchema, uploadDropzoneDemoData };
+export type { UploadDropzoneConfig };
+/**
+ * `upload-dropzone` (annex §8) — the dashed-border drag-and-drop target: icon
+ * tile, "Drop files to upload", a format/size hint, an "or browse" micro-CTA, and
+ * an accent hover/drag-over state. Generalises the Studio-local
+ * `apps/dashboard/src/studio/connect/Dropzone.tsx` (09 §8.2 mode c) into the
+ * reusable registry widget.
+ *
+ * NO TRANSPORT: this widget renders state and EMITS files through `onFiles` — it
+ * never uploads. There are no files routes yet (08 §2.11), so the host owns the
+ * transport; when they land, the dashboard wires `onFiles` to them and pipes the
+ * resulting job rows into `upload-progress-list`. Data contract is `static`
+ * (annex §8: "none (emits files); constraints from config").
+ *
+ * The `maxSize` constraint is enforced here (oversize files are reported through
+ * `onReject`, never silently dropped) because it is the one check that needs no
+ * backend — everything else is the server's job.
+ */
+export interface UploadDropzoneProps {
+    accept?: string | undefined;
+    /** Max bytes per file; oversize picks are routed to `onReject`. */
+    maxSize?: number | undefined;
+    multiple?: boolean | undefined;
+    disabled?: boolean | undefined;
+    locale?: string | undefined;
+    dropTitle?: string | undefined;
+    browsePrefix?: string | undefined;
+    browseLabel?: string | undefined;
+    hint?: string | undefined;
+    onFiles?: ((files: readonly File[]) => void) | undefined;
+    /** Files rejected by the `maxSize` constraint, with the limit that failed. */
+    onReject?: ((files: readonly File[], reason: 'max-size') => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function UploadDropzone({ accept, maxSize, multiple, disabled, locale, dropTitle, browsePrefix, browseLabel, hint, onFiles, onReject, testId, }: UploadDropzoneProps): import("react").JSX.Element;
+export declare function UploadDropzoneWidget({ config }: WidgetProps<UploadDropzoneConfig>): import("react").JSX.Element;
+//# sourceMappingURL=UploadDropzone.d.ts.map

package/dist/families/media/UploadDropzone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadDropzone.d.ts","sourceRoot":"","sources":["../../../src/families/media/UploadDropzone.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACzD,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAO,EACP,QAAe,EACf,QAAgB,EAChB,MAAM,EACN,SAAS,EACT,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,MAAM,GACP,EAAE,mBAAmB,+BA0ErB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,oBAAoB,CAAC,+BAoBjF"}

package/dist/families/media/UploadDropzone.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { IconTile } from '@adminium/ui';
+import { CloudUpload } from 'lucide-react';
+import { useRef, useState } from 'react';
+import { formatSize, resolveLocale } from './media-lib.js';
+import { uploadDropzoneConfigSchema, uploadDropzoneDemoData } from './media-config.js';
+export { uploadDropzoneConfigSchema, uploadDropzoneDemoData };
+export function UploadDropzone({ accept, maxSize, multiple = true, disabled = false, locale, dropTitle, browsePrefix, browseLabel, hint, onFiles, onReject, testId, }) {
+    const inputRef = useRef(null);
+    const [dragging, setDragging] = useState(false);
+    const tag = resolveLocale(locale);
+    const pick = (list) => {
+        if (list === null || list.length === 0)
+            return;
+        const files = multiple ? [...list] : [...list].slice(0, 1);
+        if (maxSize === undefined) {
+            onFiles?.(files);
+            return;
+        }
+        const accepted = files.filter((file) => file.size <= maxSize);
+        const rejected = files.filter((file) => file.size > maxSize);
+        if (rejected.length > 0)
+            onReject?.(rejected, 'max-size');
+        if (accepted.length > 0)
+            onFiles?.(accepted);
+    };
+    const onDrop = (event) => {
+        event.preventDefault();
+        setDragging(false);
+        if (!disabled)
+            pick(event.dataTransfer.files);
+    };
+    const sizeHint = maxSize === undefined ? undefined : formatSize(maxSize, tag);
+    return (_jsxs("div", { "data-widget": "upload-dropzone", "data-testid": testId, className: "flex h-full flex-col p-3", children: [_jsxs("button", { type: "button", "data-part": "dropzone", disabled: disabled, "data-dragging": dragging ? '' : undefined, onClick: () => inputRef.current?.click(), onDragOver: (event) => {
+                    event.preventDefault();
+                    setDragging(true);
+                }, onDragLeave: () => setDragging(false), onDrop: onDrop, className: 'flex h-full w-full flex-col items-center justify-center gap-1 rounded-lg border-2 border-dashed ' +
+                    'border-border-strong bg-surface-2 px-6 py-8 text-center transition-colors duration-150 ' +
+                    'hover:border-fg-subtle focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent ' +
+                    'disabled:pointer-events-none disabled:opacity-40 data-[dragging]:border-accent data-[dragging]:bg-accent-soft', children: [_jsx(IconTile, { size: "xl", tone: "accent", icon: _jsx(CloudUpload, {}), className: "mb-2" }), _jsx("span", { className: "text-body-sm font-bold text-fg", children: dropTitle ?? 'Drop files to upload' }), _jsxs("span", { className: "text-caption text-fg-muted", children: [browsePrefix ?? 'or', " ", _jsx("span", { className: "font-bold text-accent", children: browseLabel ?? 'browse' })] }), (hint !== undefined || sizeHint !== undefined) && (_jsx("span", { className: "mt-2 text-caption text-fg-subtle", "data-part": "dropzone-hint", children: [hint, sizeHint].filter((part) => part !== undefined).join(' · ') }))] }), _jsx("input", { ref: inputRef, type: "file", tabIndex: -1, "aria-hidden": "true", "data-part": "dropzone-input", multiple: multiple, ...(accept === undefined ? {} : { accept }), className: "hidden", onChange: (event) => {
+                    pick(event.currentTarget.files);
+                    event.currentTarget.value = '';
+                } })] }));
+}
+export function UploadDropzoneWidget({ config }) {
+    // No `onFiles` sink: `WidgetEvent` (04 §2.1) models drill-through/record-open/
+    // mutate — it has no "here are some File handles" case, and inventing one is a
+    // registry-contract change, not a widget decision. The dashboard composes the
+    // exported <UploadDropzone> directly (import pages: dropzone +
+    // column-mapping-table + validation-issues-list, annex §10) where it can hold
+    // the File objects. Registry-placed, this instance is the visual affordance.
+    return (_jsx(UploadDropzone, { ...(config.accept === undefined ? {} : { accept: config.accept }), ...(config.maxSize === undefined ? {} : { maxSize: config.maxSize }), multiple: config.multiple, disabled: config.disabled, ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.dropTitle === undefined ? {} : { dropTitle: config.dropTitle }), ...(config.browsePrefix === undefined ? {} : { browsePrefix: config.browsePrefix }), ...(config.browseLabel === undefined ? {} : { browseLabel: config.browseLabel }), ...(config.hint === undefined ? {} : { hint: config.hint }) }));
+}
+//# sourceMappingURL=UploadDropzone.js.map

package/dist/families/media/UploadDropzone.js.map

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