@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/media/media-lib.js

@@ -0,0 +1,333 @@
+import { getFormatters } from '@adminium/i18n';
+/**
+ * Shared helpers for the `media` family (annex §8) — a deterministic seeded PRNG
+ * for `demoData`, the file-kind classifier every media widget colour-codes with,
+ * the self-FK folder-hierarchy walk (`file-browser`'s breadcrumb + children), and
+ * Intl-routed size/date formatting.
+ *
+ * PURE module: no JSX, no @adminium/ui component imports — `media-config.ts` (the
+ * registry-metadata graph) imports from here, so this file must never drag the
+ * component code into the eager chunk (04 §2.3). Icon ELEMENTS live in
+ * `media-icons.tsx`.
+ *
+ * Numeral policy (10-i18n-theming.md §4.2): file sizes and modified dates are
+ * *data-context* strings → Latin digits + gregorian, so the mono size/date
+ * columns stay `tabular-nums`-aligned in every locale including `ar_EG`. That is
+ * `getFormatters`' default `ctx: 'data'`, applied inside the layer — callers pass
+ * the PLAIN tag (`latnDataTag` is only for hand-built `Intl.*` instances, and
+ * double-applying it here would produce an invalid tag). Month names still
+ * localize to the locale's script.
+ *
+ * Kept framework-light (no i18n provider dependency), like the `feeds`/`calendar`
+ * families — widgets render in stories/tests without a wrapper and the dashboard
+ * resolves label overrides through @adminium/i18n at the host boundary (04 §2).
+ */
+/** Mulberry32 — the repo's deterministic seeded PRNG (see feeds/calendar/boards). */
+export function mulberry32(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** Deterministic pick from a non-empty tuple. */
+export function pickFrom(random, items) {
+    return items[Math.floor(random() * items.length) % items.length];
+}
+/** Fixed demo epoch so `demoData(seed)` is byte-identical across runs (04 §7.7). */
+export const MEDIA_DEMO_EPOCH = Date.UTC(2026, 6, 14, 12, 0, 0);
+/**
+ * Coalesce an empty/whitespace locale to `en-US`. A schema-valid
+ * `format.locale: ''` otherwise reaches locale-sensitive Intl calls that throw
+ * `RangeError: Incorrect locale information provided` — so widgets normalize the
+ * tag once, at the boundary (the calendar-family convention).
+ */
+export function resolveLocale(locale) {
+    return locale !== undefined && locale.trim() !== '' ? locale : 'en-US';
+}
+/**
+ * The event target for a bound widget: `connectionId` + the schema-qualified
+ * table name, or `null` when the widget is running on `demoData` (no binding) —
+ * an unbound widget must never emit a mutation against a table that isn't there
+ * (the tables/CardGallery + boards convention).
+ */
+export function bindingSourceOf(binding) {
+    if (binding === undefined)
+        return null;
+    const { schema, name } = binding.source;
+    return { connectionId: binding.connectionId, table: schema === undefined ? name : `${schema}.${name}` };
+}
+// ── File kinds ──────────────────────────────────────────────────────────────
+/**
+ * The colour-coded file kinds the media family renders (File Manager's
+ * `ftMeta` vocabulary). `file` is the catch-all for an unrecognised type.
+ */
+export const FILE_KINDS = ['folder', 'pdf', 'sheet', 'image', 'archive', 'doc', 'code', 'video', 'audio', 'file'];
+/**
+ * Smart-folder rail predicates (annex §8 `smartFolders`). Closed vocabulary —
+ * a stored config can never smuggle arbitrary predicate code into the rail.
+ * `media-config.ts` mirrors this as its Zod enum.
+ */
+export const SMART_FOLDER_FILTERS = ['all', 'starred', 'recent', 'folder'];
+const FILE_KIND_SET = new Set(FILE_KINDS);
+/** Kind → icon-chip tone (File Manager: folders accent, pdf danger, sheets pos…). */
+export const FILE_KIND_TONE = {
+    folder: 'accent',
+    pdf: 'danger',
+    sheet: 'pos',
+    image: 'info',
+    archive: 'warn',
+    doc: 'accent',
+    code: 'info',
+    video: 'danger',
+    audio: 'warn',
+    file: 'neutral',
+};
+/** Extension → kind. Lowercase, no leading dot. */
+const EXTENSION_KIND = {
+    pdf: 'pdf',
+    xls: 'sheet',
+    xlsx: 'sheet',
+    csv: 'sheet',
+    tsv: 'sheet',
+    numbers: 'sheet',
+    png: 'image',
+    jpg: 'image',
+    jpeg: 'image',
+    gif: 'image',
+    webp: 'image',
+    svg: 'image',
+    avif: 'image',
+    heic: 'image',
+    zip: 'archive',
+    tar: 'archive',
+    gz: 'archive',
+    rar: 'archive',
+    '7z': 'archive',
+    doc: 'doc',
+    docx: 'doc',
+    rtf: 'doc',
+    txt: 'doc',
+    md: 'doc',
+    key: 'doc',
+    ppt: 'doc',
+    pptx: 'doc',
+    pages: 'doc',
+    json: 'code',
+    ts: 'code',
+    tsx: 'code',
+    js: 'code',
+    sql: 'code',
+    yml: 'code',
+    yaml: 'code',
+    mp4: 'video',
+    mov: 'video',
+    webm: 'video',
+    mkv: 'video',
+    mp3: 'audio',
+    wav: 'audio',
+    flac: 'audio',
+    m4a: 'audio',
+    ogg: 'audio',
+};
+/** MIME top-level type → kind, for the mime-first branch. */
+const MIME_KIND = {
+    image: 'image',
+    video: 'video',
+    audio: 'audio',
+    text: 'doc',
+};
+/** Extension of a filename (lowercase, no dot); `''` when there is none. */
+export function extensionOf(name) {
+    const dot = name.lastIndexOf('.');
+    return dot > 0 && dot < name.length - 1 ? name.slice(dot + 1).toLowerCase() : '';
+}
+/**
+ * Classify a row into a `FileKind`, in precedence order:
+ *   1. an explicit `type` that already names a kind (`'folder'`, `'pdf'`, …),
+ *   2. the MIME type (`application/pdf`, `image/png`, `text/*`, …),
+ *   3. the filename extension,
+ *   4. `file`.
+ *
+ * Deliberately tolerant (unknown in, `FileKind` out) — rows arrive from an
+ * untrusted `record-list` payload whose `type` column is whatever the source
+ * table stores.
+ */
+export function kindOf(type, mime, name) {
+    if (typeof type === 'string') {
+        const normalized = type.trim().toLowerCase();
+        if (FILE_KIND_SET.has(normalized))
+            return normalized;
+        // Common aliases the annex evidence uses ('img', 'zip', 'dir').
+        if (normalized === 'img')
+            return 'image';
+        if (normalized === 'zip')
+            return 'archive';
+        if (normalized === 'dir' || normalized === 'directory')
+            return 'folder';
+    }
+    if (typeof mime === 'string' && mime.includes('/')) {
+        const [top = '', sub = ''] = mime.toLowerCase().split('/');
+        if (sub === 'pdf')
+            return 'pdf';
+        if (sub.includes('spreadsheet') || sub === 'csv')
+            return 'sheet';
+        if (sub.includes('zip') || sub.includes('compressed') || sub.includes('tar'))
+            return 'archive';
+        if (sub.includes('word') || sub.includes('presentation') || sub.includes('document'))
+            return 'doc';
+        if (sub === 'json' || sub.includes('javascript'))
+            return 'code';
+        const byTop = MIME_KIND[top];
+        if (byTop !== undefined)
+            return byTop;
+    }
+    if (typeof name === 'string') {
+        const byExtension = EXTENSION_KIND[extensionOf(name)];
+        if (byExtension !== undefined)
+            return byExtension;
+    }
+    return 'file';
+}
+// ── `record-list` envelope reads ────────────────────────────────────────────
+/**
+ * A `record-list` envelope's rows. Tolerant of every shape the repo emits: the
+ * §3 canonical `{ rows }`, the `{ data }` shorthand the boards/feeds tracks use,
+ * and a bare array.
+ */
+export function fileRowsOf(data) {
+    if (Array.isArray(data))
+        return data;
+    if (typeof data === 'object' && data !== null) {
+        const envelope = data;
+        if (Array.isArray(envelope.rows))
+            return envelope.rows;
+        if (Array.isArray(envelope.data))
+            return envelope.data;
+    }
+    return [];
+}
+/** Read a string-ish field off an untrusted row (numbers coerce; else undefined). */
+export function stringField(row, field) {
+    const value = row[field];
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+/** Read a finite-number field off an untrusted row (numeric strings coerce). */
+export function numberField(row, field) {
+    const value = row[field];
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+/** Read a boolean-ish field (`true`, `1`, `'true'`, `'t'`, `'yes'`). */
+export function booleanField(row, field) {
+    const value = row[field];
+    if (typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return value === 1;
+    if (typeof value === 'string')
+        return ['true', 't', 'yes', 'y', '1'].includes(value.toLowerCase());
+    return false;
+}
+/** The root sentinel id — `file-browser`'s "current folder" when at the top. */
+export const ROOT_ID = '__root__';
+/** Direct children of `folderId`, folders first then files, each name-sorted. */
+export function childrenOf(nodes, folderId, collator) {
+    const parent = folderId === ROOT_ID ? null : folderId;
+    const compare = collator ?? new Intl.Collator('en-US', { numeric: true });
+    return nodes
+        .filter((node) => (node.parentId ?? null) === parent)
+        .sort((a, b) => {
+        const folderDelta = (a.kind === 'folder' ? 0 : 1) - (b.kind === 'folder' ? 0 : 1);
+        return folderDelta !== 0 ? folderDelta : compare.compare(a.name, b.name);
+    });
+}
+/**
+ * Root → `folderId` breadcrumb chain (excluding the root sentinel), walked up the
+ * self-FK pointers. **Cycle-safe**: a self-referential or mutually-referential
+ * `parentId` (a corrupt row, or a legitimately cyclic self-FK the engine cannot
+ * forbid) would otherwise spin forever — visited ids terminate the walk.
+ */
+export function breadcrumbTrail(nodes, folderId) {
+    const byId = new Map(nodes.map((node) => [node.id, node]));
+    const chain = [];
+    const seen = new Set();
+    let cursor = folderId === ROOT_ID ? null : folderId;
+    while (cursor !== null && !seen.has(cursor)) {
+        seen.add(cursor);
+        const node = byId.get(cursor);
+        if (node === undefined)
+            break;
+        chain.unshift(node);
+        cursor = node.parentId ?? null;
+    }
+    return chain;
+}
+/**
+ * How many items a folder directly contains — the grid tile's "12 items" when
+ * the bound table has no materialized count column (annex §8 marks `count`
+ * optional). Direct children only, matching the file-manager convention.
+ */
+export function descendantCount(nodes, folderId) {
+    return nodes.filter((node) => (node.parentId ?? null) === folderId).length;
+}
+// ── Intl-routed formatting ──────────────────────────────────────────────────
+/** Localized byte size ("1.2 MB"), Latin digits (data context). */
+export function formatSize(bytes, locale) {
+    if (bytes === undefined || !Number.isFinite(bytes) || bytes < 0)
+        return undefined;
+    return getFormatters(resolveLocale(locale)).bytes(bytes);
+}
+/** Localized short modified date ("Sep 12"), Latin digits (data context). */
+export function formatModified(iso, locale) {
+    const date = parseIso(iso);
+    return date === null ? undefined : getFormatters(resolveLocale(locale)).date(date, 'medium');
+}
+/** Localized absolute timestamp for the `title` tooltip on a modified cell. */
+export function formatModifiedFull(iso, locale) {
+    const date = parseIso(iso);
+    return date === null ? undefined : getFormatters(resolveLocale(locale)).dateTime(date);
+}
+/** Parse an ISO timestamp, `null` when absent or unparseable (untrusted rows). */
+function parseIso(iso) {
+    if (iso === undefined)
+        return null;
+    const date = new Date(iso);
+    return Number.isNaN(date.getTime()) ? null : date;
+}
+/** Localized item count ("12 items" is composed by the caller from config copy). */
+export function formatCount(value, locale) {
+    return getFormatters(resolveLocale(locale)).number(value);
+}
+/**
+ * Strip the scheme from a URL for the mono display line (`link-list` renders
+ * `app.adminium.io/v/8kd93m2q`, never `https://app.adminium.io/…`). Falsy /
+ * scheme-less input passes through unchanged.
+ */
+export function displayUrl(url) {
+    return url.replace(/^[a-z][a-z0-9+.-]*:\/\//i, '');
+}
+/**
+ * Percent clamped to `[0, 100]` and rounded — `upload-progress-list` renders an
+ * untrusted `pct` from a job row straight into a bar width.
+ */
+export function clampPct(value) {
+    const numeric = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(numeric))
+        return 0;
+    return Math.min(100, Math.max(0, Math.round(numeric)));
+}
+//# sourceMappingURL=media-lib.js.map

package/dist/families/media/media-lib.js.map

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

package/dist/families/media/media-track-components.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `media` family component barrel — the single lazy-import target for this
+ * family's definitions, so the registry metadata graph reaches the
+ * @adminium/ui-heavy media components only through a dynamic `import()` boundary
+ * (one lazy chunk for the family, 04 §2.3). Mirrors the kpi/charts/feeds/boards
+ * `*-components.ts` convention.
+ */
+export { AttachmentListWidget } from './AttachmentList.js';
+export { FileBrowserWidget } from './FileBrowser.js';
+export { ImageBoardWidget } from './ImageBoard.js';
+export { LinkListWidget } from './LinkList.js';
+export { UploadDropzoneWidget } from './UploadDropzone.js';
+export { UploadProgressListWidget } from './UploadProgressList.js';
+//# sourceMappingURL=media-track-components.d.ts.map

package/dist/families/media/media-track-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-track-components.d.ts","sourceRoot":"","sources":["../../../src/families/media/media-track-components.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/families/media/media-track-components.js

@@ -0,0 +1,14 @@
+/**
+ * `media` family component barrel — the single lazy-import target for this
+ * family's definitions, so the registry metadata graph reaches the
+ * @adminium/ui-heavy media components only through a dynamic `import()` boundary
+ * (one lazy chunk for the family, 04 §2.3). Mirrors the kpi/charts/feeds/boards
+ * `*-components.ts` convention.
+ */
+export { AttachmentListWidget } from './AttachmentList.js';
+export { FileBrowserWidget } from './FileBrowser.js';
+export { ImageBoardWidget } from './ImageBoard.js';
+export { LinkListWidget } from './LinkList.js';
+export { UploadDropzoneWidget } from './UploadDropzone.js';
+export { UploadProgressListWidget } from './UploadProgressList.js';
+//# sourceMappingURL=media-track-components.js.map

package/dist/families/media/media-track-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-track-components.js","sourceRoot":"","sources":["../../../src/families/media/media-track-components.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/families/media/media-track.definitions.d.ts

@@ -0,0 +1,26 @@
+import type { WidgetDefinition } from '../../registry/types.js';
+/**
+ * TRACK MEDIA — `media` family registry metadata (annex §8; 04-T10). Metadata
+ * only: the @adminium/ui-heavy widget components load through the
+ * `media-track-components` barrel via `lazy(() => import(...))`, so the family
+ * stays in ONE lazy chunk and the registry metadata never eagerly pulls the
+ * component code into a sibling family's bundle (04 §2.3; the chunk-budget gate).
+ * Schemas + `demoData` come from the PURE `media-config.ts` for the same reason.
+ * The GREEN LOOP spreads `mediaTrackDefinitions` into the registry map. Widget
+ * ids match the annex catalog exactly (acceptance #1).
+ *
+ * Sizing is the annex's grid note converted to 40px half-units
+ * (04 §6.1: `h = round(annexRows × 2)`); widths map 1:1.
+ *
+ * `capabilities.editsData` marks the widgets that emit `mutate` intents (star a
+ * file, delete an attachment, edit a caption, add/remove a link) — the host runs
+ * them through the CRUD API with undo + audit; the widgets never write.
+ */
+export declare const fileBrowserDefinition: WidgetDefinition;
+export declare const uploadDropzoneDefinition: WidgetDefinition;
+export declare const uploadProgressListDefinition: WidgetDefinition;
+export declare const attachmentListDefinition: WidgetDefinition;
+export declare const imageBoardDefinition: WidgetDefinition;
+export declare const linkListDefinition: WidgetDefinition;
+export declare const mediaTrackDefinitions: readonly WidgetDefinition[];
+//# sourceMappingURL=media-track.definitions.d.ts.map

package/dist/families/media/media-track.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-track.definitions.d.ts","sourceRoot":"","sources":["../../../src/families/media/media-track.definitions.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,qBAAqB,EAAE,gBAYlC,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,gBAarC,CAAC;AAEH,eAAO,MAAM,4BAA4B,EAAE,gBAWzC,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,gBAYrC,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,gBAYjC,CAAC;AAEH,eAAO,MAAM,kBAAkB,EAAE,gBAY/B,CAAC;AAEH,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAO5D,CAAC"}

package/dist/families/media/media-track.definitions.js

@@ -0,0 +1,107 @@
+import { lazy } from 'react';
+import { attachmentListConfigSchema, attachmentListDemoData, fileBrowserConfigSchema, fileBrowserDemoData, imageBoardConfigSchema, imageBoardDemoData, linkListConfigSchema, linkListDemoData, uploadDropzoneConfigSchema, uploadDropzoneDemoData, uploadProgressListConfigSchema, uploadProgressListDemoData, } from './media-config.js';
+import { defineWidget } from '../../registry/types.js';
+/**
+ * TRACK MEDIA — `media` family registry metadata (annex §8; 04-T10). Metadata
+ * only: the @adminium/ui-heavy widget components load through the
+ * `media-track-components` barrel via `lazy(() => import(...))`, so the family
+ * stays in ONE lazy chunk and the registry metadata never eagerly pulls the
+ * component code into a sibling family's bundle (04 §2.3; the chunk-budget gate).
+ * Schemas + `demoData` come from the PURE `media-config.ts` for the same reason.
+ * The GREEN LOOP spreads `mediaTrackDefinitions` into the registry map. Widget
+ * ids match the annex catalog exactly (acceptance #1).
+ *
+ * Sizing is the annex's grid note converted to 40px half-units
+ * (04 §6.1: `h = round(annexRows × 2)`); widths map 1:1.
+ *
+ * `capabilities.editsData` marks the widgets that emit `mutate` intents (star a
+ * file, delete an attachment, edit a caption, add/remove a link) — the host runs
+ * them through the CRUD API with undo + audit; the widgets never write.
+ */
+export const fileBrowserDefinition = defineWidget({
+    id: 'file-browser',
+    family: 'media',
+    component: lazy(() => import('./media-track-components.js').then((m) => ({ default: m.FileBrowserWidget }))),
+    configSchema: fileBrowserConfigSchema,
+    dataContract: 'record-list',
+    sizing: { minW: 8, minH: 12, defaultW: 12, defaultH: 18 }, // annex "full page body"
+    placement: 'page',
+    skeleton: 'block',
+    capabilities: { editsData: true, exportCsv: true },
+    demoData: fileBrowserDemoData,
+    descriptionKey: 'widgets.media.fileBrowser.description',
+});
+export const uploadDropzoneDefinition = defineWidget({
+    id: 'upload-dropzone',
+    family: 'media',
+    component: lazy(() => import('./media-track-components.js').then((m) => ({ default: m.UploadDropzoneWidget }))),
+    configSchema: uploadDropzoneConfigSchema,
+    // annex §8: "none (emits files); constraints from config" — `static` is the
+    // §3 shape for a widget whose payload is its config.
+    dataContract: 'static',
+    sizing: { minW: 4, minH: 4, defaultW: 6, defaultH: 4 }, // annex "min 4×2, default 6×2"
+    placement: 'grid',
+    skeleton: 'block',
+    demoData: uploadDropzoneDemoData,
+    descriptionKey: 'widgets.media.uploadDropzone.description',
+});
+export const uploadProgressListDefinition = defineWidget({
+    id: 'upload-progress-list',
+    family: 'media',
+    component: lazy(() => import('./media-track-components.js').then((m) => ({ default: m.UploadProgressListWidget }))),
+    configSchema: uploadProgressListConfigSchema,
+    dataContract: 'record-list',
+    sizing: { minW: 3, minH: 4, defaultW: 4, defaultH: 6 }, // annex "min 3×2"
+    placement: 'grid',
+    skeleton: 'list',
+    demoData: uploadProgressListDemoData,
+    descriptionKey: 'widgets.media.uploadProgressList.description',
+});
+export const attachmentListDefinition = defineWidget({
+    id: 'attachment-list',
+    family: 'media',
+    component: lazy(() => import('./media-track-components.js').then((m) => ({ default: m.AttachmentListWidget }))),
+    configSchema: attachmentListConfigSchema,
+    dataContract: 'record-list',
+    sizing: { minW: 3, minH: 4, defaultW: 4, defaultH: 6 }, // annex "min 3×2"
+    placement: 'grid',
+    skeleton: 'list',
+    capabilities: { editsData: true },
+    demoData: attachmentListDemoData,
+    descriptionKey: 'widgets.media.attachmentList.description',
+});
+export const imageBoardDefinition = defineWidget({
+    id: 'image-board',
+    family: 'media',
+    component: lazy(() => import('./media-track-components.js').then((m) => ({ default: m.ImageBoardWidget }))),
+    configSchema: imageBoardConfigSchema,
+    dataContract: 'record-list',
+    sizing: { minW: 6, minH: 8, defaultW: 6, defaultH: 10 }, // annex "min 6×4"
+    placement: 'grid',
+    skeleton: 'block',
+    capabilities: { editsData: true },
+    demoData: imageBoardDemoData,
+    descriptionKey: 'widgets.media.imageBoard.description',
+});
+export const linkListDefinition = defineWidget({
+    id: 'link-list',
+    family: 'media',
+    component: lazy(() => import('./media-track-components.js').then((m) => ({ default: m.LinkListWidget }))),
+    configSchema: linkListConfigSchema,
+    dataContract: 'record-list',
+    sizing: { minW: 3, minH: 4, defaultW: 4, defaultH: 6 }, // annex "min 3×2"
+    placement: 'grid',
+    skeleton: 'list',
+    capabilities: { editsData: true },
+    demoData: linkListDemoData,
+    descriptionKey: 'widgets.media.linkList.description',
+});
+export const mediaTrackDefinitions = [
+    fileBrowserDefinition,
+    uploadDropzoneDefinition,
+    uploadProgressListDefinition,
+    attachmentListDefinition,
+    imageBoardDefinition,
+    linkListDefinition,
+];
+//# sourceMappingURL=media-track.definitions.js.map

package/dist/families/media/media-track.definitions.js.map

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

package/dist/families/system/AlertBanner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `alert-banner` (annex §12) — inline callout: severity tint, bold stat lead or
+ * icon, explanatory copy, optional CTA. Variants observed in the comps:
+ * over-limit warning, deploy-freeze note, recurring-schedule info, rebalance
+ * suggestion. The annex's auto-instantiation hook emits one of these per quota
+ * check.
+ *
+ * Wraps @adminium/ui's `Alert` (which owns the tone-soft bg + `color-mix` tone
+ * border + default per-tone glyph); this file adds the record binding, the
+ * severity→tone map, the bold stat lead, and dismissal.
+ */
+import { alertBannerConfigSchema, alertBannerDemoData } from './system-config.js';
+import type { AlertBannerConfig } from './system-config.js';
+import type { WidgetProps } from '../../registry/types.js';
+export { alertBannerConfigSchema, alertBannerDemoData };
+export type { AlertBannerConfig };
+export interface AlertBannerViewProps {
+    severity?: string | undefined;
+    /** Bold stat lead rendered before the copy ("92% disk used"). */
+    lead?: string | undefined;
+    message?: string | undefined;
+    ctaLabel?: string | undefined;
+    severityMap?: Record<string, string> | undefined;
+    dismissible?: boolean | undefined;
+    dismissLabel?: string | undefined;
+    onCta?: (() => void) | undefined;
+    testId?: string | undefined;
+}
+export declare function AlertBannerView({ severity, lead, message, ctaLabel, severityMap, dismissible, dismissLabel, onCta, testId, }: AlertBannerViewProps): import("react").JSX.Element | null;
+export declare function AlertBannerWidget({ config, data, onEvent }: WidgetProps<AlertBannerConfig>): import("react").JSX.Element | null;
+//# sourceMappingURL=AlertBanner.d.ts.map

package/dist/families/system/AlertBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertBanner.d.ts","sourceRoot":"","sources":["../../../src/families/system/AlertBanner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AA6BlC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAmB,EACnB,YAAY,EACZ,KAAK,EACL,MAAM,GACP,EAAE,oBAAoB,sCA8CtB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,iBAAiB,CAAC,sCAqB1F"}

package/dist/families/system/AlertBanner.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `alert-banner` (annex §12) — inline callout: severity tint, bold stat lead or
+ * icon, explanatory copy, optional CTA. Variants observed in the comps:
+ * over-limit warning, deploy-freeze note, recurring-schedule info, rebalance
+ * suggestion. The annex's auto-instantiation hook emits one of these per quota
+ * check.
+ *
+ * Wraps @adminium/ui's `Alert` (which owns the tone-soft bg + `color-mix` tone
+ * border + default per-tone glyph); this file adds the record binding, the
+ * severity→tone map, the bold stat lead, and dismissal.
+ */
+import { Button, IconButton, Alert } from '@adminium/ui';
+import { X } from 'lucide-react';
+import { useState } from 'react';
+import { recordRowOf, stringField } from './system-lib.js';
+import { alertBannerConfigSchema, alertBannerDemoData } from './system-config.js';
+export { alertBannerConfigSchema, alertBannerDemoData };
+const ALERT_TONES = ['info', 'pos', 'warn', 'danger'];
+/**
+ * Default severity vocabulary — the common spellings a real `severity`/`level`
+ * column uses. Config `severityMap` overrides it per instance.
+ */
+const DEFAULT_SEVERITY_TONE = {
+    info: 'info',
+    notice: 'info',
+    success: 'pos',
+    ok: 'pos',
+    pos: 'pos',
+    warn: 'warn',
+    warning: 'warn',
+    danger: 'danger',
+    error: 'danger',
+    critical: 'danger',
+    fatal: 'danger',
+};
+function toneOf(severity, map) {
+    if (severity === undefined)
+        return 'info';
+    const mapped = map?.[severity] ?? DEFAULT_SEVERITY_TONE[severity.toLowerCase()];
+    return mapped !== undefined && ALERT_TONES.includes(mapped) ? mapped : 'info';
+}
+export function AlertBannerView({ severity, lead, message, ctaLabel, severityMap, dismissible = false, dismissLabel, onCta, testId, }) {
+    const [dismissed, setDismissed] = useState(false);
+    if (dismissed)
+        return null;
+    const tone = toneOf(severity, severityMap);
+    // The annex leads with the stat when there is one, else the message carries
+    // the title line — an Alert always needs a title.
+    const title = lead ?? message ?? '';
+    const body = lead === undefined ? undefined : message;
+    return (_jsxs("div", { className: "relative px-4 pb-4", children: [_jsx(Alert, { "data-widget": "alert-banner", "data-severity": severity ?? 'info', "data-testid": testId, tone: tone, 
+                // `warn`/`danger` callouts appear in response to a state change, so they
+                // announce assertively; informational ones stay polite.
+                role: tone === 'danger' || tone === 'warn' ? 'alert' : 'status', title: title, ...(body === undefined ? {} : { body }), ...(ctaLabel === undefined
+                    ? {}
+                    : {
+                        action: (_jsx(Button, { size: "sm", variant: "ghost", onClick: () => onCta?.(), children: ctaLabel })),
+                    }), className: dismissible ? 'pe-11' : undefined }), dismissible && (_jsx(IconButton, { size: "sm", label: dismissLabel ?? 'Dismiss', "data-part": "alert-dismiss", onClick: () => setDismissed(true), className: "absolute end-6 top-2", children: _jsx(X, { className: "size-3.5" }) }))] }));
+}
+export function AlertBannerWidget({ config, data, onEvent }) {
+    const row = recordRowOf(data);
+    if (row === null)
+        return null;
+    const href = stringField(row, config.ctaHrefField) ?? config.href;
+    const ctaLabel = stringField(row, config.ctaLabelField);
+    return (_jsx(AlertBannerView, { severity: stringField(row, config.severityField), lead: stringField(row, config.leadField), message: stringField(row, config.messageField), ...(ctaLabel === undefined || href === undefined ? {} : { ctaLabel }), severityMap: config.severityMap, dismissible: config.dismissible, dismissLabel: config.dismissLabel, onCta: href === undefined ? undefined : () => onEvent({ type: 'drill-through', href }), testId: config.testId }));
+}
+//# sourceMappingURL=AlertBanner.js.map