@ripple-ui/svelte 0.0.0-stage → 0.9.0-next.0

package/dist/manifest/entries/date-picker.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const datePickerEntry: WidgetManifestEntry;

package/dist/manifest/entries/date-picker.js

@@ -0,0 +1,31 @@
+export const datePickerEntry = {
+    type: 'date-picker',
+    category: 'input',
+    description: 'Calendar-based date picker (popover).',
+    props: {
+        label: { type: 'string', required: false, description: 'Label text.' },
+        bind: { type: 'string', required: false, description: 'Two-way state path for ISO date (YYYY-MM-DD).' },
+        value: { type: 'string | null', required: false, description: 'Selected ISO date.' },
+        placeholder: { type: 'string', required: false, description: 'Trigger placeholder.' },
+        disabled: { type: 'boolean', required: false, description: 'Disable picker.' },
+        format: { type: '"short" | "medium" | "long" | "iso"', required: false, description: 'Display format.' },
+        min: { type: 'string', required: false, description: 'Minimum selectable ISO date.' },
+        max: { type: 'string', required: false, description: 'Maximum selectable ISO date.' },
+        locale: { type: 'string', required: false, description: 'Locale code. Default "en-US".' },
+    },
+    events: {
+        on_change: { type: 'EventAction', required: false, description: 'Fired on date change.' },
+    },
+    example: { type: 'date-picker', props: { label: 'Due date', format: 'long', min: '2026-01-01', max: '2026-12-31', bind: '{state.dueDate}' } },
+    pocket: {
+        state: { dueDate: null },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '8px' },
+            children: [
+                { type: 'date-picker', props: { label: 'Due date', format: 'long', min: '2026-01-01', max: '2026-12-31' }, bind: 'state.dueDate' },
+                { type: 'text', show: '{state.dueDate != null}', props: { text: 'Due: {state.dueDate}' } },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/definition-list.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const definitionListEntry: WidgetManifestEntry;

package/dist/manifest/entries/definition-list.js

@@ -0,0 +1,19 @@
+export const definitionListEntry = {
+    type: 'definition-list',
+    category: 'display',
+    description: 'Term/definition pairs, inline (term on the left) or stacked. Use for glossaries and metadata.',
+    props: {
+        items: { type: 'Array<{ term: string; definition: string }>', required: true, description: 'Term/definition pairs.' },
+        layout: { type: '"inline" | "stacked"', required: false, description: 'Layout mode.' },
+    },
+    example: {
+        type: 'definition-list',
+        props: {
+            layout: 'inline',
+            items: [
+                { term: 'API', definition: 'Application Programming Interface' },
+                { term: 'REST', definition: 'Representational State Transfer' },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/diff.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const diffEntry: WidgetManifestEntry;

package/dist/manifest/entries/diff.js

@@ -0,0 +1,16 @@
+export const diffEntry = {
+    type: 'diff',
+    category: 'display',
+    description: 'Text diff viewer, unified or split, with line/word/char granularity.',
+    props: {
+        before: { type: 'string', required: false, description: '"Before" text.' },
+        after: { type: 'string', required: false, description: '"After" text.' },
+        mode: { type: '"lines" | "words" | "chars"', required: false, description: 'Diff granularity.' },
+        layout: { type: '"unified" | "split"', required: false, description: 'View layout.' },
+        showLineNumbers: { type: 'boolean', required: false, description: 'Show line numbers (lines mode only).' },
+        title: { type: 'string', required: false, description: 'Header title.' },
+        oldStart: { type: 'number', required: false, description: 'File line number of the first "before" line, for an excerpt. Default 1.' },
+        newStart: { type: 'number', required: false, description: 'File line number of the first "after" line, for an excerpt. Default 1.' },
+    },
+    example: { type: 'diff', props: { before: 'const x = 1;', after: 'const x = 42;', mode: 'lines', layout: 'unified', showLineNumbers: true } },
+};

package/dist/manifest/entries/discover-card.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const discoverCardEntry: WidgetManifestEntry;

package/dist/manifest/entries/discover-card.js

@@ -0,0 +1,13 @@
+export const discoverCardEntry = {
+    type: 'discover-card',
+    category: 'research',
+    description: 'Discovery card with image, title, description, and source tag. Use for curated articles or recommendations.',
+    props: {
+        title: { type: 'string', required: true, description: 'Card title.' },
+        description: { type: 'string', required: false, description: 'Short description.' },
+        image: { type: 'string', required: false, description: 'Image URL.' },
+        source: { type: 'string', required: false, description: 'Publisher name.' },
+        url: { type: 'string', required: false, description: 'Link URL.' },
+    },
+    example: { type: 'discover-card', props: { title: 'Cloud Infrastructure Trends for 2026', description: 'Key insights on Kubernetes and edge computing adoption.', source: 'InfoQ', url: 'https://infoq.com/article' } },
+};

package/dist/manifest/entries/drawing-canvas.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const drawingCanvasEntry: WidgetManifestEntry;

package/dist/manifest/entries/drawing-canvas.js

@@ -0,0 +1,18 @@
+export const drawingCanvasEntry = {
+    type: 'drawing-canvas',
+    category: 'interactive',
+    description: 'Canvas 2D drawing pad with brush, eraser, color, size, undo/redo, clear, and PNG export. Supports mouse and touch. Exports via the on_save event.',
+    props: {
+        width: { type: 'number', required: false, description: 'Canvas width in px. Default 400.' },
+        height: { type: 'number', required: false, description: 'Canvas height in px. Default 300.' },
+        backgroundColor: { type: 'string', required: false, description: 'Background fill. Default "#ffffff".' },
+        initialImage: { type: 'string', required: false, description: 'Data URL pre-loaded onto the canvas.' },
+    },
+    events: {
+        on_save: { type: 'EventAction', required: false, description: 'Fired with a PNG data URL when the user exports.' },
+    },
+    example: {
+        type: 'drawing-canvas',
+        props: { width: 400, height: 300, backgroundColor: '#ffffff' },
+    },
+};

package/dist/manifest/entries/dropdown-menu.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const dropdownMenuEntry: WidgetManifestEntry;

package/dist/manifest/entries/dropdown-menu.js

@@ -0,0 +1,25 @@
+export const dropdownMenuEntry = {
+    type: 'dropdown-menu',
+    category: 'overlay',
+    description: 'Dropdown menu with items, icons, shortcuts, and separators. Emits onchange with selected item value.',
+    props: {
+        label: { type: 'string', required: false, description: 'Trigger button label.' },
+        triggerVariant: { type: '"default" | "outline" | "ghost" | "secondary"', required: false, description: 'Trigger button style.' },
+        items: { type: 'Array<{ label?: string; icon?: string; value?: unknown; variant?: string; disabled?: boolean; type?: "separator" | "item"; shortcut?: string }>', required: true, description: 'Menu items.' },
+        side: { type: '"top" | "right" | "bottom" | "left"', required: false, description: 'Popover position.' },
+        align: { type: '"start" | "center" | "end"', required: false, description: 'Alignment.' },
+        hideChevron: { type: 'boolean', required: false, description: 'Hide trailing chevron.' },
+    },
+    example: {
+        type: 'dropdown-menu',
+        props: {
+            label: 'Actions',
+            items: [
+                { label: 'Edit', icon: 'edit', value: 'edit' },
+                { label: 'Duplicate', icon: 'copy', value: 'duplicate' },
+                { type: 'separator' },
+                { label: 'Delete', icon: 'trash-2', value: 'delete', variant: 'destructive' },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/each.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const eachEntry: WidgetManifestEntry;

package/dist/manifest/entries/each.js

@@ -0,0 +1,34 @@
+export const eachEntry = {
+    type: 'each',
+    category: 'control',
+    description: 'Loop over an array. Renders children per item with `{item}` and `{index}` in expressions. `items`/`item_as`/`index_as` are node-level fields, not props.',
+    props: {},
+    nodeFields: {
+        items: { type: 'string', required: true, description: 'State path or expression resolving to an array, e.g. "{state.users}".' },
+        item_as: { type: 'string', required: false, description: 'Variable name for the current item. Default "item".' },
+        index_as: { type: 'string', required: false, description: 'Variable name for the current index. Default "index".' },
+    },
+    example: {
+        type: 'each',
+        items: '{state.users}',
+        children: [
+            { type: 'text', props: { text: '{item.name}' } },
+        ],
+    },
+    pocket: {
+        state: { users: [{ name: 'Ada Lovelace' }, { name: 'Grace Hopper' }, { name: 'Alan Turing' }] },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '8px' },
+            children: [
+                {
+                    type: 'each',
+                    items: '{state.users}',
+                    children: [
+                        { type: 'text', props: { text: '{item.name}' } },
+                    ],
+                },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/embed.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const embedEntry: WidgetManifestEntry;

package/dist/manifest/entries/embed.js

@@ -0,0 +1,52 @@
+export const embedEntry = {
+    type: 'embed',
+    category: 'media',
+    description: 'Sandboxed iframe escape hatch: embeds a remote https URL or an inline srcdoc document. The iframe sandbox is renderer-controlled; the spec cannot widen it. Frame runs at an opaque origin.',
+    props: {
+        mode: {
+            type: '"url" | "srcdoc"',
+            required: true,
+            description: 'Embed a remote page (`url`) or an inline document (`srcdoc`).',
+        },
+        url: {
+            type: 'string',
+            required: false,
+            description: 'Remote page URL, used when mode=url. Must be https://.',
+        },
+        srcdoc: {
+            type: 'string',
+            required: false,
+            description: 'Inline HTML document, used when mode=srcdoc. Capped at 64KB.',
+        },
+        title: {
+            type: 'string',
+            required: true,
+            description: 'Accessible title for the iframe.',
+        },
+        height: {
+            type: 'number',
+            required: false,
+            description: 'Fixed height in px. Ignored when aspectRatio is set.',
+        },
+        aspectRatio: {
+            type: 'string',
+            required: false,
+            description: 'Aspect ratio such as "16 / 9". Wins over height.',
+        },
+        allow: {
+            type: 'string[]',
+            required: false,
+            description: 'Permissions-policy tokens. Only fullscreen, autoplay, encrypted-media, picture-in-picture are honored; anything else is dropped.',
+        },
+    },
+    example: {
+        type: 'embed',
+        props: {
+            mode: 'url',
+            url: 'https://www.youtube.com/embed/dQw4w9WgXcQ',
+            title: 'Embedded video',
+            aspectRatio: '16 / 9',
+            allow: ['fullscreen', 'encrypted-media'],
+        },
+    },
+};

package/dist/manifest/entries/empty-state.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const emptyStateEntry: WidgetManifestEntry;

package/dist/manifest/entries/empty-state.js

@@ -0,0 +1,11 @@
+export const emptyStateEntry = {
+    type: 'empty-state',
+    category: 'display',
+    description: 'Empty state with icon (inbox/search/file/error), title, and description.',
+    props: {
+        title: { type: 'string', required: true, description: 'Title text.' },
+        description: { type: 'string', required: false, description: 'Description text.' },
+        icon: { type: '"inbox" | "search" | "file" | "error"', required: false, description: 'Icon preset.' },
+    },
+    example: { type: 'empty-state', props: { title: 'No results', description: 'Try adjusting your search filters', icon: 'search' } },
+};

package/dist/manifest/entries/entity-detail.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const entityDetailEntry: WidgetManifestEntry;

package/dist/manifest/entries/entity-detail.js

@@ -0,0 +1,55 @@
+export const entityDetailEntry = {
+    type: 'entity-detail',
+    category: 'composite',
+    description: 'The "view one record" page: hero header, status badge, KPI strip, action buttons, meta sidebar, content body via children. Use for any single-entity page.',
+    props: {
+        title: { type: 'string', required: true, description: 'Primary heading (e.g. customer name, ticket title).' },
+        subtitle: { type: 'string', required: false, description: 'Smaller line under the title.' },
+        eyebrow: { type: 'string', required: false, description: 'Small uppercase label above the title (e.g. "Customer · ACME-1042").' },
+        avatar: { type: 'string', required: false, description: 'Avatar image URL.' },
+        icon: { type: 'string', required: false, description: 'Lucide icon slug, used when there is no avatar.' },
+        iconColor: { type: 'string', required: false, description: 'Background color for the icon block (e.g. oklch(0.55 0.18 250)).' },
+        status: { type: '{ label: string; variant?: "default" | "success" | "warning" | "destructive" | "info" }', required: false, description: 'Status pill rendered next to the title.' },
+        tags: { type: 'Array<string | { label: string; color?: string }>', required: false, description: 'Tag pills.' },
+        kpis: { type: 'Array<{ label: string; value: string | number; delta?: string; trend?: "up" | "down" | "flat"; sublabel?: string }>', required: false, description: 'KPI strip cards. Trend controls the colored arrow on `delta`.' },
+        actions: { type: 'Array<{ id?: string; label: string; icon?: string; variant?: "default" | "secondary" | "outline" | "ghost" | "destructive"; actions?: EventAction | EventAction[] }>', required: false, description: 'Action buttons on the right of the hero.' },
+        meta: { type: 'Array<{ label: string; value: string; icon?: string }>', required: false, description: 'Key-value pairs for the right rail (or stacked, depending on `metaPlacement`).' },
+        metaPlacement: { type: '"rail" | "stacked"', required: false, description: 'Where to place the meta block. Default "rail".' },
+    },
+    example: {
+        type: 'entity-detail',
+        props: {
+            eyebrow: 'Customer · ACME-1042',
+            title: 'Acme Corp',
+            subtitle: 'Enterprise · Annual contract',
+            icon: 'building-2',
+            iconColor: 'oklch(0.55 0.18 250)',
+            status: { label: 'Active', variant: 'success' },
+            tags: ['SSO', 'Audit', { label: 'Strategic', color: 'oklch(0.55 0.22 25)' }],
+            kpis: [
+                { label: 'MRR', value: '$48k', delta: '+12%', trend: 'up' },
+                { label: 'Open tickets', value: 3, sublabel: '1 high priority' },
+                { label: 'Health score', value: 92, delta: '+4', trend: 'up' },
+                { label: 'Last touch', value: '2d ago', trend: 'flat' },
+            ],
+            actions: [
+                { id: 'edit', label: 'Edit', icon: 'pencil', variant: 'outline' },
+                { id: 'note', label: 'Add note', icon: 'message-square', variant: 'default' },
+            ],
+            meta: [
+                { label: 'Owner', value: 'Jane Doe', icon: 'user' },
+                { label: 'Created', value: 'Aug 14, 2019' },
+                { label: 'Renewal', value: 'Mar 1, 2027', icon: 'calendar' },
+                { label: 'Industry', value: 'Logistics' },
+            ],
+        },
+        children: [
+            { type: 'tabs', props: { tabs: ['Overview', 'Activity', 'Files', 'Settings'] }, bind: 'tab', children: [
+                    { type: 'text', props: { text: 'Overview content goes here.' } },
+                    { type: 'text', props: { text: 'Activity feed goes here.' } },
+                    { type: 'text', props: { text: 'Files list goes here.' } },
+                    { type: 'text', props: { text: 'Settings panel goes here.' } },
+                ] },
+        ],
+    },
+};

package/dist/manifest/entries/error-state.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const errorStateEntry: WidgetManifestEntry;

package/dist/manifest/entries/error-state.js

@@ -0,0 +1,24 @@
+export const errorStateEntry = {
+    type: 'error-state',
+    category: 'overlay',
+    description: 'Error state with icon, title, description, optional code/detail, and primary/secondary actions.',
+    props: {
+        title: { type: 'string', required: false, description: 'Error title.' },
+        description: { type: 'string', required: false, description: 'Error description.' },
+        icon: { type: 'string', required: false, description: 'Lucide icon slug.' },
+        actionLabel: { type: 'string', required: false, description: 'Primary action label.' },
+        secondaryLabel: { type: 'string', required: false, description: 'Secondary action label.' },
+        detail: { type: 'string', required: false, description: 'Error code or technical detail (monospace).' },
+    },
+    example: {
+        type: 'error-state',
+        props: {
+            title: 'Connection failed',
+            description: "We couldn't reach the server. Please check your internet and try again.",
+            icon: 'alert-circle',
+            actionLabel: 'Retry',
+            secondaryLabel: 'Go back',
+            detail: 'Error: NETWORK_TIMEOUT',
+        },
+    },
+};

package/dist/manifest/entries/exec-dashboard.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const execDashboardEntry: WidgetManifestEntry;

package/dist/manifest/entries/exec-dashboard.js

@@ -0,0 +1,107 @@
+export const execDashboardEntry = {
+    type: 'exec-dashboard',
+    category: 'composite',
+    description: 'KPI dashboard from raw rows: give rows, measures {key,label,format,agg}, dimensions {key,label}, x and split; it computes KPIs, trends, a chart, a breakdown and a filtered table with totals.',
+    props: {
+        verdict: {
+            type: '{ text: string; status?: "good" | "warn" | "bad" | "info" | "neutral" }',
+            required: false,
+            description: 'The answer up front, at most 140 chars, e.g. "September was the best month; East leads on revenue."',
+        },
+        currency: { type: 'string', required: false, description: 'ISO 4217 code for money measures. Default "USD". Never put a symbol in the data.' },
+        rows: {
+            type: 'Array<Record<string, string | number>>',
+            required: false,
+            description: 'Rows mode: the raw records, one per order/event, e.g. { id, date: "2026-07-14", region, channel, amount }. Numbers as numbers. Every KPI, chart bar, breakdown and total is computed from these.',
+        },
+        measures: {
+            type: 'Array<{ key?: string; label: string; format?: "money" | "number" | "percent"; agg?: "sum" | "avg" | "count"; good?: "up" | "down" }>',
+            required: false,
+            description: 'One KPI each, in order; the first also drives the chart and breakdown. `agg` defaults to sum (count needs no key). `percent` values are 0 to 100. `good` says which way is good (default up).',
+        },
+        dimensions: {
+            type: 'Array<{ key: string; label: string }>',
+            required: false,
+            description: 'Filter chip rows (e.g. region). A pick recomputes every number; the breakdown shows the first dimension not filtered.',
+        },
+        x: { type: 'string', required: false, description: 'The column the chart runs along. ISO dates group by day (span up to 31 days) or by month; other values group as written.' },
+        split: { type: 'string', required: false, description: 'A column to stack the chart by (e.g. channel), one colour per value; past five values the rest fold into Other.' },
+        compare: { type: 'Array<Record<string, string | number>>', required: false, description: 'The previous period\'s rows, for KPI trends. Without it, trends compare the last x group with the one before.' },
+        compareLabel: { type: 'string', required: false, description: 'Trend wording when `compare` is given, e.g. "vs Q2". Default "vs previous period".' },
+        filters: {
+            type: 'Record<string, string>',
+            required: false,
+            description: 'The active filter per dimension, e.g. { region: "West" }. Use top-level `bind` to keep it in state (e.g. `bind: "salesFilter"`).',
+        },
+        title: { type: 'string', required: false, description: 'Page title.' },
+        subtitle: { type: 'string', required: false, description: 'Page subtitle / description.' },
+        dateRange: { type: 'string', required: false, description: 'Static date-range chip (used when `dateRanges` is not provided).' },
+        dateRanges: { type: 'string[]', required: false, description: 'Preset date-range chips (e.g. ["Today","7d","30d","90d","YTD"]). Renders a segmented control.' },
+        activeDateRange: { type: 'string', required: false, description: 'Active date-range chip. Defaults to the first item.' },
+        granularities: { type: 'string[]', required: false, description: 'Optional granularity toggle (e.g. ["Day","Week","Month"]).' },
+        activeGranularity: { type: 'string', required: false, description: 'Two-way bindable.' },
+        activityFilters: { type: 'string[]', required: false, description: 'Activity-rail filter pills (first item is treated as "all"). If omitted but items have `category`, filters are auto-derived.' },
+        activeActivityFilter: { type: 'string', required: false, description: 'Two-way bindable.' },
+        showRefresh: { type: 'boolean', required: false, description: 'KPI mode refresh button. Default true in KPI mode, false in rows mode.' },
+        refreshActions: { type: 'EventAction | EventAction[]', required: false, description: 'Actions dispatched when refresh is clicked.' },
+        lastUpdated: { type: 'string', required: false, description: 'Human-readable timestamp shown near the refresh button (e.g. "2m ago"). Pulses while `loading`.' },
+        loading: { type: 'boolean', required: false, description: 'When true and there is no existing content, renders animated skeletons. When content is present, only the refresh icon spins.' },
+        error: { type: 'string', required: false, description: 'When set, renders an inline error block with optional retry CTA in place of dashboard content.' },
+        density: { type: '"comfortable" | "compact"', required: false, description: 'Padding/typography preset. Default "comfortable". Use "compact" for dense ops/finance dashboards.' },
+        empty: { type: '{ title?: string; message?: string; icon?: string }', required: false, description: 'Shown when there is no KPI / chart / activity / table data and no error.' },
+        actions: { type: 'Array<{ id?: string; label: string; icon?: string; variant?: "default" | "outline" | "ghost"; actions?: EventAction | EventAction[] }>', required: false, description: 'Header action buttons.' },
+        kpis: { type: 'Array<{ id?: string; label: string; value: string | number; unit?: string; delta?: string; trend?: "up" | "down" | "flat"; compareLabel?: string; sparkline?: number[]; color?: string; icon?: string; sublabel?: string; status?: "normal" | "success" | "warning" | "critical"; target?: string | number; progress?: number; byKey?: Record<string, KpiOverride>; actions?: EventAction | EventAction[] }>', required: false, description: 'KPI tiles. `status` paints a left-edge band; `progress` (0-100) renders a thin progress bar (optionally with `target`). `byKey` swaps fields (value/delta/trend/sparkline/...) when activeDateRange / activeGranularity changes. Keys may be the range, the granularity, or "<range>|<granularity>" (most specific wins). When `actions` (or `id` + a host `onkpiclick`) is set, the tile becomes clickable for drill-through.' },
+        primaryChart: { type: '{ title?: string; type?: "bar" | "line" | "area" | "pie" | "donut" | "radar" | "heatmap"; data: DataPoint[] | Record<string, DataPoint[]>;height?: number; colors?: string[]; reference?: string | string[] }', required: false, description: 'Hero chart. `data` is an array or a record keyed by range, granularity or "<range>|<granularity>". `colors` is per series on many; one series wears one colour unless you give two or more. `reference` names series (a target pace, a plan) to draw muted and dashed.' },
+        activity: { type: 'Array<{ id?: string; time: string; label: string; actor?: string; icon?: string; severity?: "info" | "success" | "warning" | "destructive"; category?: string; unread?: boolean; actions?: EventAction | EventAction[] }>', required: false, description: 'Right-rail activity feed. `unread` highlights the item. `category` is surfaced as auto-derived filters when `activityFilters` is omitted. Per-item `actions` makes the item clickable.' },
+        activityTitle: { type: 'string', required: false, description: 'Activity rail heading. Default "Recent activity".' },
+        charts: { type: 'Array<ChartConfig>', required: false, description: 'Secondary chart row (auto-fit grid). Each `data` may be keyed the same way as `primaryChart.data`.' },
+        table: { type: '{ title?: string; columns?: Array<{ key: string; label: string; align?: "left" | "right" | "center" }>; rows?: Record<string, unknown>[] | Record<string, Record<string, unknown>[]> }', required: false, description: 'Rows mode: `title` and optional `columns` for the filtered rows table. KPI mode: a table footer whose `rows` may be keyed by range/granularity.' },
+    },
+    events: {
+        on_filter: {
+            type: 'EventAction | EventAction[]',
+            required: false,
+            description: 'Rows mode. Fires with { key, value } when a filter chip is picked (value null for All).',
+        },
+        on_date_range_change: {
+            type: 'EventAction | EventAction[]',
+            required: false,
+            description: 'KPI mode. Fires with the picked date-range chip, e.g. "30d".',
+        },
+    },
+    example: {
+        type: 'exec-dashboard',
+        bind: 'salesFilter',
+        props: {
+            title: 'Fernleaf Ceramics, Q3 sales',
+            subtitle: 'Online orders, July to September',
+            verdict: { text: 'September was the best month; East leads on revenue.', status: 'good' },
+            currency: 'USD',
+            x: 'date',
+            split: 'channel',
+            measures: [
+                { key: 'amount', label: 'Revenue', format: 'money' },
+                { label: 'Orders', agg: 'count' },
+                { key: 'amount', label: 'Avg order', format: 'money', agg: 'avg' },
+                { key: 'items', label: 'Items sold' },
+            ],
+            dimensions: [{ key: 'region', label: 'Region' }],
+            table: { title: 'Orders' },
+            rows: [
+                { id: 'FL-1041', date: '2026-07-01', region: 'West', channel: 'Marketplace', items: 3, amount: 133.38 },
+                { id: 'FL-1046', date: '2026-07-09', region: 'East', channel: 'Web', items: 2, amount: 98.4 },
+                { id: 'FL-1050', date: '2026-07-18', region: 'North', channel: 'Social', items: 1, amount: 42.5 },
+                { id: 'FL-1055', date: '2026-07-27', region: 'South', channel: 'Web', items: 2, amount: 87.1 },
+                { id: 'FL-1061', date: '2026-08-04', region: 'East', channel: 'Web', items: 3, amount: 151.2 },
+                { id: 'FL-1066', date: '2026-08-12', region: 'West', channel: 'Social', items: 1, amount: 38.9 },
+                { id: 'FL-1070', date: '2026-08-19', region: 'South', channel: 'Marketplace', items: 2, amount: 76.0 },
+                { id: 'FL-1074', date: '2026-08-28', region: 'North', channel: 'Web', items: 2, amount: 104.75 },
+                { id: 'FL-1081', date: '2026-09-03', region: 'East', channel: 'Web', items: 4, amount: 212.6 },
+                { id: 'FL-1086', date: '2026-09-11', region: 'West', channel: 'Web', items: 2, amount: 95.3 },
+                { id: 'FL-1090', date: '2026-09-17', region: 'East', channel: 'Social', items: 1, amount: 49.0 },
+                { id: 'FL-1095', date: '2026-09-22', region: 'South', channel: 'Web', items: 3, amount: 139.45 },
+                { id: 'FL-1099', date: '2026-09-29', region: 'North', channel: 'Marketplace', items: 2, amount: 88.2 },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/faq.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const faqEntry: WidgetManifestEntry;

package/dist/manifest/entries/faq.js

@@ -0,0 +1,21 @@
+export const faqEntry = {
+    type: 'faq',
+    category: 'marketing',
+    staticSafe: true,
+    description: 'Frequently-asked-questions section: question/answer pairs as native <details> disclosures. Expands with no client JS. Aliased as faqs.',
+    props: {
+        title: { type: 'string', required: false, description: 'Optional section heading above the list.' },
+        items: { type: 'Array<{ question: string; answer: string }>', required: true, description: 'The Q/A pairs.' },
+    },
+    example: {
+        type: 'faq',
+        props: {
+            title: 'Questions, answered',
+            items: [
+                { question: 'How long does a visit take?', answer: 'Most first visits run 45 minutes — a cleaning, a check, and a plan.' },
+                { question: 'Do you take my insurance?', answer: 'We bill all major plans directly and confirm your coverage before the appointment.' },
+                { question: 'Can I reschedule online?', answer: 'Yes — change or cancel from the confirmation email up to 24 hours ahead.' },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/feature-grid.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const featureGridEntry: WidgetManifestEntry;

package/dist/manifest/entries/feature-grid.js

@@ -0,0 +1,21 @@
+export const featureGridEntry = {
+    type: 'feature-grid',
+    category: 'marketing',
+    staticSafe: true,
+    description: 'Responsive grid of feature cells (lucide icon + title + description). Aliased as features. Use to lay out product benefits on a landing page.',
+    props: {
+        features: { type: 'Array<{ title: string; description?: string; icon?: string }>', required: true, description: 'Feature cells. `icon` is a lucide slug (kebab-case, e.g. "zap") rendered as an SVG above the title.' },
+        columns: { type: '2 | 3 | 4', required: false, description: 'Columns on md+. Default 3.' },
+    },
+    example: {
+        type: 'feature-grid',
+        props: {
+            columns: 3,
+            features: [
+                { icon: 'zap', title: 'Edge-fast', description: 'Served from the closest edge node.' },
+                { icon: 'shield-check', title: 'You own it', description: 'Your domain, your brand, your data.' },
+                { icon: 'message-square', title: 'Edit by chat', description: 'Change anything just by asking.' },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/figure.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const figureEntry: WidgetManifestEntry;

package/dist/manifest/entries/figure.js

@@ -0,0 +1,34 @@
+export const figureEntry = {
+    type: 'figure',
+    category: 'composite',
+    description: 'A hand-built live isometric figure, with sliders, readouts and numbered labels. Catalog ids: heart, bike-gears, rocket-engine, ion-thruster, tokamak, fission-reactor, particle-collider. Bind value.',
+    props: {
+        figure: {
+            type: '"heart" | "bike-gears" | "rocket-engine" | "ion-thruster" | "tokamak" | "fission-reactor" | "particle-collider"',
+            required: true,
+            description: 'Figure id. "heart" is a beating heart as two pumps: sliders bpm (40-180) and stroke (50-110 ml). "bike-gears" is a bicycle drivetrain on a stand: sliders cadence (40-120 rpm), ring (34 or 50 teeth) and gear (1-7, 1 = the 28-tooth cog, 7 = the 11); readouts gear ratio, metres per pedal turn and km/h. "rocket-engine" is a liquid-oxygen and kerosene staged-combustion engine firing on a test stand: sliders throttle (40-100 %) and mixture (oxidiser to fuel by mass, 2.2-3.0); readouts thrust (kN), chamber pressure (bar) and turbopump rpm. "ion-thruster" is a gridded xenon ion thruster cut in half on a thrust stand: sliders voltage (600-1800 V on the grids) and flow (0.5-3 mg/s of xenon); readouts exhaust speed km/s, thrust mN and power kW. "tokamak" is a fusion reactor cut open: sliders current (5-17 MA) and heating (10-75 MW); readouts core temperature (million °C), fusion power (MW) and the gain Q. "fission-reactor" is a pressurised water reactor plant: sliders rods (control rods in, 0-100 %) and pump (coolant pump speed, 40-100 %); readouts thermal and electric power (MW) and the coolant temperature leaving the core. "particle-collider" is a cutaway piece of a proton collider ring (dipoles, quadrupoles, RF cavities, a layered detector where the beams cross): sliders energy (0.5-7 TeV per beam) and rate (5-40 million bunch crossings a second); readouts share of light speed, dipole field in tesla, collision energy and collisions a second.'
+        },
+        params: { type: 'Record<string, number>', required: false, description: 'Starting slider values, e.g. { "bpm": 120 }. Clamped to each slider.' },
+        labels: {
+            type: 'Array<{ anchor: string; label?: string; note?: string }>',
+            required: false,
+            description: 'Up to 10 numbered pins, plain text. heart anchors: right-atrium, right-ventricle, left-atrium, left-ventricle, tricuspid, mitral, pulmonary-valve, aortic-valve, aorta, vena-cava, pulmonary-artery, pulmonary-veins, lungs, body. bike-gears anchors: chainring, crank, pedal, chain, cassette, rear-derailleur, front-derailleur, jockey-wheels, rear-hub, wheel. rocket-engine anchors: oxidiser-tank, fuel-tank, turbopump, turbine, oxidiser-pump, fuel-pump, preburner, injector, combustion-chamber, throat, nozzle, cooling-channels, gimbal, load-cell, plume, pressure-gauge. ion-thruster anchors: xenon-tank, flow-controller, power-unit, discharge-chamber, magnets, cathode, plasma, screen-grid, accel-grid, neutraliser, ion-beam, thrust-dial. tokamak anchors: plasma, central-solenoid, tf-coil, pf-coil, vacuum-vessel, blanket, divertor, heating-beam, port. fission-reactor anchors: reactor-vessel, fuel, control-rods, pressuriser, steam-generator, coolant-pump, hot-leg, cold-leg, containment, steam-line, turbine, generator, condenser, feedwater-pump, cooling-tower, transformer. particle-collider anchors: collision-point, detector, tracker, ecal, hcal, solenoid, muon-chambers, beam-pipes, dipole, quadrupole, final-focus, separation-magnet, rf-cavities, magnet-coils, field-gauge.'
+        },
+        caption: { type: 'string', required: false, description: 'One or two plain sentences under the figure.' },
+        value: { type: 'Record<string, number>', required: false, description: 'Two-way bind with `bind: "{state.figure}"`: the slider values, written when one moves.' }
+    },
+    example: {
+        type: 'figure',
+        bind: '{state.figure}',
+        props: {
+            figure: 'heart',
+            params: { bpm: 72 },
+            labels: [
+                { anchor: 'right-ventricle', note: 'Pumps oxygen-poor blood to the lungs.' },
+                { anchor: 'left-ventricle', note: 'Pumps oxygen-rich blood to the whole body.' },
+                { anchor: 'mitral', label: 'Mitral valve', note: 'Opens while the left ventricle fills.' }
+            ],
+            caption: 'Move the heart rate and watch the output change.'
+        }
+    }
+};

package/dist/manifest/entries/file-upload.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const fileUploadEntry: WidgetManifestEntry;

package/dist/manifest/entries/file-upload.js

@@ -0,0 +1,32 @@
+export const fileUploadEntry = {
+    type: 'file-upload',
+    category: 'input',
+    description: 'Drag-and-drop file upload with file list display, accept-type filtering, and size limits.',
+    props: {
+        label: { type: 'string', required: false, description: 'Label text.' },
+        bind: { type: 'string', required: false, description: 'Two-way state path for files array.' },
+        accept: { type: 'string', required: false, description: 'Accept attribute (e.g. "image/*", ".pdf,.docx").' },
+        multiple: { type: 'boolean', required: false, description: 'Allow multiple files.' },
+        maxSize: { type: 'number', required: false, description: 'Max bytes per file.' },
+        maxFiles: { type: 'number', required: false, description: 'Max number of files.' },
+        helperText: { type: 'string', required: false, description: 'Helper text below dropzone.' },
+        hideFileList: { type: 'boolean', required: false, description: 'Hide file list under dropzone.' },
+        disabled: { type: 'boolean', required: false, description: 'Disable upload.' },
+    },
+    events: {
+        on_change: { type: 'EventAction', required: false, description: 'Fired when files are added.' },
+        on_error: { type: 'EventAction', required: false, description: 'Fired on validation error.' },
+    },
+    example: { type: 'file-upload', props: { label: 'Upload documents', accept: '.pdf,.docx', multiple: true, maxSize: 10485760, maxFiles: 5, bind: '{state.uploadedFiles}' } },
+    pocket: {
+        state: { uploadedFiles: [] },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '8px' },
+            children: [
+                { type: 'file-upload', props: { label: 'Upload documents', accept: '.pdf,.docx', multiple: true, maxSize: 10485760, maxFiles: 5, helperText: 'PDF or Word, up to 10MB each.' }, bind: 'state.uploadedFiles' },
+                { type: 'text', props: { text: '{state.uploadedFiles.length} file(s) ready to upload' } },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/fill-grid.d.ts

@@ -0,0 +1,2 @@
+import type { WidgetManifestEntry } from '../index.js';
+export declare const fillGridEntry: WidgetManifestEntry;