@ripple-ui/svelte 0.0.0-stage → 0.8.2

package/dist/manifest/entries/sankey.js

@@ -0,0 +1,25 @@
+export const sankeyEntry = {
+    type: 'sankey',
+    category: 'data',
+    description: 'Sankey diagram showing flows between nodes. Use for value streams, user journeys.',
+    props: {
+        nodes: { type: 'Array<{ name: string }>', required: true, description: 'Node names.' },
+        links: { type: 'Array<{ source: string; target: string; value: number }>', required: true, description: 'Flows.' },
+        height: { type: 'number', required: false, description: 'Max height in px.' },
+        title: { type: 'string', required: false, description: 'Chart title.' },
+        orient: { type: '"horizontal" | "vertical"', required: false, description: 'Flow direction.' },
+        curveness: { type: 'number', required: false, description: 'Link curve factor 0-1. Default 0.5.' },
+    },
+    example: {
+        type: 'sankey',
+        props: {
+            title: 'User Journey',
+            nodes: [{ name: 'Landing' }, { name: 'Signup' }, { name: 'Active' }, { name: 'Churn' }],
+            links: [
+                { source: 'Landing', target: 'Signup', value: 120 },
+                { source: 'Signup', target: 'Active', value: 85 },
+                { source: 'Active', target: 'Churn', value: 15 },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/saved-views.d.ts

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

package/dist/manifest/entries/saved-views.js

@@ -0,0 +1,23 @@
+export const savedViewsEntry = {
+    type: 'saved-views',
+    category: 'vertical',
+    description: 'Saved filter views as chips with optional counts.',
+    props: {
+        views: { type: 'Array<{ id: string; label: string; icon?: string; pinned?: boolean; count?: number }>', required: true, description: 'Saved views.' },
+        value: { type: 'string | null', required: false, description: 'Currently active view id (use with bind).' },
+        canCreate: { type: 'boolean', required: false, description: 'Show "+ New view" button.' },
+    },
+    example: {
+        type: 'saved-views',
+        props: {
+            value: 'all',
+            canCreate: true,
+            views: [
+                { id: 'all', label: 'All issues', count: 142, pinned: true },
+                { id: 'assigned', label: 'Assigned to me', count: 8 },
+                { id: 'high-priority', label: 'High priority', icon: 'alert-circle', count: 23 },
+                { id: 'closed', label: 'Closed', count: 2847 },
+            ],
+        },
+    },
+};

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

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

package/dist/manifest/entries/search.js

@@ -0,0 +1,54 @@
+export const searchEntry = {
+    type: 'search',
+    category: 'input',
+    description: 'Search input with dropdown results, grouping, keyboard navigation, and shortcuts.',
+    props: {
+        bind: { type: 'string', required: false, description: 'Two-way state path for query.' },
+        value: { type: 'string', required: false, description: 'Current query.' },
+        placeholder: { type: 'string', required: false, description: 'Placeholder text.' },
+        results: { type: 'Array<{ id: string | number; label: string; description?: string; icon?: string; group?: string; href?: string; shortcut?: string }>', required: false, description: 'Search results.' },
+        alwaysShow: { type: 'boolean', required: false, description: 'Show dropdown even when query is empty.' },
+        emptyText: { type: 'string', required: false, description: 'Empty-results text.' },
+        loading: { type: 'boolean', required: false, description: 'Show loading indicator.' },
+        mode: { type: "'suggest' | 'filter'", required: false, description: "suggest (default): results dropdown. filter: plain search box, never opens a dropdown." },
+    },
+    events: {
+        on_input: { type: 'EventAction', required: false, description: 'Fired on every keystroke.' },
+        on_change: { type: 'EventAction', required: false, description: 'Fired when the query changes.' },
+        on_select: { type: 'EventAction', required: false, description: 'Fired when a result is selected.' },
+    },
+    example: {
+        type: 'search',
+        props: {
+            placeholder: 'Search users…',
+            results: [
+                { id: 1, label: 'Alice Chen', description: 'Product Designer', group: 'Users', icon: 'user' },
+                { id: 2, label: 'Bob Singh', description: 'Engineering Lead', group: 'Users', icon: 'user' },
+            ],
+            bind: '{state.searchQuery}',
+        },
+    },
+    pocket: {
+        state: { searchQuery: '', lastSelected: null },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '8px' },
+            children: [
+                {
+                    type: 'search',
+                    props: {
+                        placeholder: 'Search users…',
+                        results: [
+                            { id: 1, label: 'Alice Chen', description: 'Product Designer', group: 'Users', icon: 'user' },
+                            { id: 2, label: 'Bob Singh', description: 'Engineering Lead', group: 'Users', icon: 'user' },
+                            { id: 3, label: 'Carol Park', description: 'Customer Success', group: 'Users', icon: 'user' },
+                        ],
+                    },
+                    bind: 'state.searchQuery',
+                    on_select: { action: 'set', target: 'lastSelected', value: '{event}' },
+                },
+                { type: 'text', show: '{state.lastSelected != null}', props: { text: 'Picked: {state.lastSelected.label}' } },
+            ],
+        },
+    },
+};

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

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

package/dist/manifest/entries/section.js

@@ -0,0 +1,25 @@
+export const sectionEntry = {
+    type: 'section',
+    category: 'layout',
+    description: 'Content section with optional title and description header. Use for logical page grouping.',
+    props: {
+        title: { type: 'string', required: false, description: 'Section title.' },
+        description: { type: 'string', required: false, description: 'Section description.' },
+    },
+    example: {
+        type: 'section',
+        props: { title: 'Recent activity', description: 'Past 7 days' },
+        children: [
+            {
+                type: 'timeline',
+                props: {
+                    density: 'compact',
+                    events: [
+                        { date: '2m ago', title: 'Deploy succeeded', type: 'success' },
+                        { date: '14m ago', title: 'PR merged', type: 'info' },
+                    ],
+                },
+            },
+        ],
+    },
+};

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

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

package/dist/manifest/entries/segmented.js

@@ -0,0 +1,50 @@
+export const segmentedEntry = {
+    type: 'segmented',
+    category: 'input',
+    description: 'Segmented control (toggle group). Use for view switching or compact single/multi-select.',
+    props: {
+        label: { type: 'string', required: false, description: 'Label text.' },
+        bind: { type: 'string', required: false, description: 'Two-way state path, e.g. "{state.viewMode}".' },
+        value: { type: 'string | number | (string | number)[]', required: false, description: 'Selected value (or array if multiple).' },
+        options: { type: 'string[] | Array<{ value: string | number; label: string; icon?: string; disabled?: boolean }>', required: true, description: 'Segment options.' },
+        multiple: { type: 'boolean', required: false, description: 'Allow multiple selections.' },
+        allowEmpty: { type: 'boolean', required: false, description: 'Single mode: an empty value stays unselected until the user picks, instead of auto-selecting the first option. Use for a real "not chosen yet" choice.' },
+        size: { type: '"sm" | "md"', required: false, description: 'Button size.' },
+        disabled: { type: 'boolean', required: false, description: 'Disable all buttons.' },
+    },
+    events: {
+        on_change: { type: 'EventAction', required: false, description: 'Fired on selection change.' },
+    },
+    example: {
+        type: 'segmented',
+        props: {
+            label: 'View',
+            options: [
+                { value: 'list', label: 'List', icon: 'list' },
+                { value: 'grid', label: 'Grid', icon: 'grid' },
+            ],
+            bind: '{state.viewMode}',
+        },
+    },
+    pocket: {
+        state: { view: 'list' },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '12px' },
+            children: [
+                {
+                    type: 'segmented',
+                    props: {
+                        options: [
+                            { value: 'list', label: 'List' },
+                            { value: 'grid', label: 'Grid' },
+                            { value: 'map', label: 'Map' },
+                        ],
+                    },
+                    bind: 'state.view',
+                },
+                { type: 'text', props: { text: 'Showing as: {state.view}' } },
+            ],
+        },
+    },
+};

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

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

package/dist/manifest/entries/seismograph.js

@@ -0,0 +1,22 @@
+export const seismographEntry = {
+    type: 'seismograph',
+    category: 'data',
+    staticSafe: false,
+    description: 'Scrolling live signal trace on a canvas via a rAF ring-buffer. `line` = oscilloscope trace, `bars` = histogram. Has a ● LIVE/REC indicator + readout. Paused on tab-hide; static under reduced-motion.',
+    props: {
+        variant: { type: '"line" | "bars"', required: false, description: 'line = oscilloscope trace, bars = histogram. Default line.' },
+        live: { type: 'boolean', required: false, description: 'Animate live. When false, paints a single static frame. Default true.' },
+        color: { type: 'string', required: false, description: 'Trace color. Default the primary token. Pass a CSS var or hex.' },
+        label: { type: 'string', required: false, description: 'Caption (e.g. "GATE EVENTS · CH 01").' },
+        readout: { type: 'string', required: false, description: 'Right-side readout (e.g. "12 evt/min").' },
+        indicator: { type: 'boolean', required: false, description: 'Show the ● LIVE/REC pill. Defaults to the value of `live`.' },
+        indicatorLabel: { type: 'string', required: false, description: 'Indicator text. Default "LIVE".' },
+        height: { type: 'number', required: false, description: 'Canvas height in px. Default 96.' },
+        samples: { type: 'number', required: false, description: 'Ring-buffer length. Default 160.' },
+        seed: { type: 'number[]', required: false, description: 'Optional seed values (oldest → newest) to pre-fill the buffer.' },
+    },
+    example: {
+        type: 'seismograph',
+        props: { variant: 'line', live: true, color: '#2E6BFF', label: 'GATE EVENTS · CH 01', readout: '12 evt/min', indicatorLabel: 'LIVE' },
+    },
+};

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

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

package/dist/manifest/entries/select.js

@@ -0,0 +1,50 @@
+export const selectEntry = {
+    type: 'select',
+    category: 'input',
+    description: 'Single-select dropdown with options.',
+    props: {
+        label: { type: 'string', required: false, description: 'Label text.' },
+        bind: { type: 'string', required: false, description: 'Two-way state path, e.g. "{state.tier}".' },
+        value: { type: 'string', required: false, description: 'Selected value.' },
+        placeholder: { type: 'string', required: false, description: 'Placeholder text.' },
+        options: { type: 'string[] | Array<{ value: string; label: string }>', required: true, description: 'Option list.' },
+        disabled: { type: 'boolean', required: false, description: 'Disable select.' },
+    },
+    events: {
+        on_change: { type: 'EventAction', required: false, description: 'Fired when selection changes.' },
+    },
+    example: {
+        type: 'select',
+        props: {
+            label: 'Plan',
+            options: [
+                { value: 'free', label: 'Free' },
+                { value: 'pro', label: 'Pro' },
+                { value: 'enterprise', label: 'Enterprise' },
+            ],
+            bind: '{state.plan}',
+        },
+    },
+    pocket: {
+        state: { plan: 'pro' },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '12px' },
+            children: [
+                {
+                    type: 'select',
+                    props: {
+                        label: 'Plan',
+                        options: [
+                            { value: 'free', label: 'Free' },
+                            { value: 'pro', label: 'Pro' },
+                            { value: 'enterprise', label: 'Enterprise' },
+                        ],
+                    },
+                    bind: 'state.plan',
+                },
+                { type: 'badge', props: { text: 'Current: {state.plan}', variant: 'secondary' } },
+            ],
+        },
+    },
+};

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

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

package/dist/manifest/entries/separator.js

@@ -0,0 +1,12 @@
+export const separatorEntry = {
+    type: 'separator',
+    category: 'layout',
+    description: 'Visual divider line (horizontal or vertical) between content sections.',
+    props: {
+        orientation: { type: '"horizontal" | "vertical"', required: false, description: 'Direction. Default "horizontal".' },
+    },
+    example: {
+        type: 'separator',
+        props: { orientation: 'horizontal' },
+    },
+};

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

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

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

@@ -0,0 +1,18 @@
+export const settingsListEntry = {
+    type: 'settings-list',
+    category: 'vertical',
+    description: 'Grouped list of settings with labels, descriptions, and right-aligned control widgets.',
+    props: {
+        items: { type: 'Array<{ id?: string; label: string; description?: string; group?: string; control?: UISpec }>', required: true, description: 'Settings rows; `control` is a nested widget spec.' },
+    },
+    example: {
+        type: 'settings-list',
+        props: {
+            items: [
+                { group: 'Account', label: 'Email address', description: 'Your primary login email.', control: { type: 'input', props: { value: 'alice@example.com' } } },
+                { group: 'Account', label: 'Two-factor auth', description: 'Secure your account.', control: { type: 'switch', props: { checked: true } } },
+                { group: 'Notifications', label: 'Email digests', description: 'Receive activity summaries.', control: { type: 'switch', props: { checked: true } } },
+            ],
+        },
+    },
+};

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

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

package/dist/manifest/entries/sheet.js

@@ -0,0 +1,46 @@
+export const sheetEntry = {
+    type: 'sheet',
+    category: 'layout',
+    description: 'Slide-in panel from any edge (top/right/bottom/left). Use for sidebars and off-canvas menus.',
+    props: {
+        value: { type: 'boolean', required: false, description: 'Open state. Use with bind.' },
+        side: { type: '"top" | "right" | "bottom" | "left"', required: false, description: 'Slide direction. Default "right".' },
+        size: { type: '"sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl"', required: false, description: 'Max width of a left/right sheet on wider screens. Default "sm"; "2xl"-"4xl" fit a review or a diff.' },
+        title: { type: 'string', required: false, description: 'Sheet header title.' },
+        description: { type: 'string', required: false, description: 'Sheet header description.' },
+    },
+    example: {
+        type: 'sheet',
+        props: { value: false, side: 'right', title: 'Filters' },
+        children: [
+            { type: 'text', props: { text: 'Filter options here.' } },
+        ],
+    },
+    pocket: {
+        state: { filtersOpen: false, inStock: true },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '12px' },
+            children: [
+                {
+                    type: 'button',
+                    props: { label: 'Open filters', variant: 'secondary' },
+                    on_click: { action: 'open', target: 'filtersOpen' },
+                },
+                {
+                    type: 'sheet',
+                    props: { side: 'right', title: 'Filters', description: 'Narrow the product list.' },
+                    bind: 'state.filtersOpen',
+                    children: [
+                        { type: 'switch', props: { label: 'In stock only' }, bind: 'state.inStock' },
+                        {
+                            type: 'button',
+                            props: { label: 'Apply' },
+                            on_click: { action: 'set', target: 'filtersOpen', value: false },
+                        },
+                    ],
+                },
+            ],
+        },
+    },
+};

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

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

package/dist/manifest/entries/shimmer.js

@@ -0,0 +1,20 @@
+export const shimmerEntry = {
+    type: 'shimmer',
+    category: 'display',
+    // 2026-09-16: both strings corrected after the beautiful-ui re-skin. `width`
+    // stopped being a no-repeat band and became the ramp offset either side of
+    // centre, and the root is inline-flex, so a stretching flex column widens it
+    // past the text and the band never crosses the glyphs — a caller who does not
+    // know that sees a static label and reports a bug.
+    // Kept under the 200-char manifest limit that manifest.test.ts enforces.
+    description: 'Sweeps a moving highlight through the text of its children (pure CSS). Use on a CTA label or skeleton text. In a flex column pass self-start, or it stretches and the sweep misses the text.',
+    props: {
+        duration: { type: 'number', required: false, description: 'Seconds per sweep. Default 2.' },
+        width: { type: 'string', required: false, description: 'How far either side of centre the bright band ramps (CSS length). Default 100px.' },
+    },
+    example: {
+        type: 'shimmer',
+        class: 'text-lg font-semibold',
+        children: [{ type: 'text', props: { text: 'Get early access' } }],
+    },
+};

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

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

package/dist/manifest/entries/sidebar.js

@@ -0,0 +1,22 @@
+export const sidebarEntry = {
+    type: 'sidebar',
+    category: 'layout',
+    description: 'Navigation sidebar with grouped items, icons, badges, and optional footer. Pair with app-shell.',
+    props: {
+        title: { type: 'string', required: false, description: 'Sidebar title.' },
+        items: { type: 'Array<{ label: string; icon?: string; href?: string; group?: string; active?: boolean; badge?: string; value?: string }>', required: true, description: 'Navigation items.' },
+        value: { type: 'string', required: false, description: 'Currently selected item value.' },
+    },
+    example: {
+        type: 'sidebar',
+        props: {
+            title: 'Workspace',
+            items: [
+                { label: 'Inbox', icon: 'inbox', value: 'inbox', badge: '3' },
+                { label: 'Projects', icon: 'folder', value: 'projects' },
+                { label: 'Settings', icon: 'settings', value: 'settings' },
+            ],
+            value: 'inbox',
+        },
+    },
+};

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

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

package/dist/manifest/entries/skeleton.js

@@ -0,0 +1,9 @@
+export const skeletonEntry = {
+    type: 'skeleton',
+    category: 'display',
+    description: 'Loading placeholder shimmer. Variants tune shape: card / dashboard / text.',
+    props: {
+        variant: { type: '"card" | "dashboard" | "text" | "none"', required: false, description: 'Shape preset.' },
+    },
+    example: { type: 'skeleton', props: { variant: 'card' } },
+};

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

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

package/dist/manifest/entries/slider.js

@@ -0,0 +1,30 @@
+export const sliderEntry = {
+    type: 'slider',
+    category: 'input',
+    description: 'Range slider with optional label and value display.',
+    props: {
+        label: { type: 'string', required: false, description: 'Label text.' },
+        bind: { type: 'string', required: false, description: 'Two-way state path, e.g. "{state.volume}".' },
+        value: { type: 'number', required: false, description: 'Current value.' },
+        min: { type: 'number', required: false, description: 'Minimum. Default 0.' },
+        max: { type: 'number', required: false, description: 'Maximum. Default 100.' },
+        step: { type: 'number', required: false, description: 'Step increment. Default 1.' },
+        disabled: { type: 'boolean', required: false, description: 'Disable slider.' },
+        showValue: { type: 'boolean', required: false, description: 'Show numeric value badge.' },
+    },
+    events: {
+        on_change: { type: 'EventAction', required: false, description: 'Fired on value change.' },
+    },
+    example: { type: 'slider', props: { label: 'Volume', min: 0, max: 100, step: 1, bind: '{state.volume}', showValue: true } },
+    pocket: {
+        state: { volume: 50 },
+        ui: {
+            type: 'flex',
+            props: { direction: 'column', gap: '8px' },
+            children: [
+                { type: 'slider', props: { label: 'Volume', min: 0, max: 100, step: 1 }, bind: 'state.volume' },
+                { type: 'text', props: { text: 'Volume: {state.volume}%' } },
+            ],
+        },
+    },
+};

package/dist/manifest/entries/soul-status.d.ts

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

package/dist/manifest/entries/soul-status.js

@@ -0,0 +1,18 @@
+export const soulStatusEntry = {
+    type: 'soul-status',
+    category: 'display',
+    description: 'Agent soul state: avatar, name, energy, mood, status. Compact pill or expanded card.',
+    props: {
+        name: { type: 'string', required: false, description: 'Agent name.' },
+        role: { type: 'string', required: false, description: 'Agent role.' },
+        initials: { type: 'string', required: false, description: 'Avatar initials.' },
+        color: { type: 'string', required: false, description: 'Avatar background color.' },
+        mood: { type: 'string', required: false, description: 'Mood emoji/text.' },
+        energy: { type: 'number', required: false, description: 'Energy level (0-100).' },
+        memories: { type: 'number', required: false, description: 'Memory count.' },
+        lastAction: { type: 'string', required: false, description: 'Last action performed.' },
+        status: { type: '"online" | "offline" | "busy"', required: false, description: 'Online status.' },
+        compact: { type: 'boolean', required: false, description: 'Compact pill (true) or expanded card (false).' },
+    },
+    example: { type: 'soul-status', props: { name: 'Claude', role: 'AI Assistant', color: '#6366f1', mood: '😊', energy: 85, memories: 342, status: 'online', compact: true } },
+};

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

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

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

@@ -0,0 +1,13 @@
+export const sourceCardEntry = {
+    type: 'source-card',
+    category: 'research',
+    description: 'Source card with publisher, headline, and favicon. Use in card grids for articles or research.',
+    props: {
+        source: { type: 'string', required: true, description: 'Publisher name.' },
+        title: { type: 'string', required: true, description: 'Headline text.' },
+        color: { type: 'string', required: false, description: 'Accent color (CSS), used if the favicon fails.' },
+        favicon: { type: 'string', required: false, description: 'Favicon URL override.' },
+        url: { type: 'string', required: false, description: 'Link URL.' },
+    },
+    example: { type: 'source-card', props: { source: 'TechCrunch', title: 'AI Startup Raises $50M Series B', color: '#ff6b35', url: 'https://techcrunch.com/article' } },
+};

package/dist/manifest/entries/sources-bar.d.ts

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

package/dist/manifest/entries/sources-bar.js

@@ -0,0 +1,24 @@
+export const sourcesBarEntry = {
+    type: 'sources-bar',
+    category: 'research',
+    description: 'Horizontal bar with stacked source favicons, count label, and share/copy actions.',
+    props: {
+        sources: { type: 'Array<{ name: string; color?: string; favicon?: string; url?: string }>', required: true, description: 'Source list.' },
+        count: { type: 'number', required: false, description: 'Override displayed count.' },
+        label: { type: 'string', required: false, description: 'Label text. Default "sources".' },
+        share: { type: 'boolean', required: false, description: 'Show share action.' },
+        copy: { type: 'boolean', required: false, description: 'Show copy action.' },
+    },
+    example: {
+        type: 'sources-bar',
+        props: {
+            sources: [
+                { name: 'Lanternpost', url: 'https://lanternpost.example.com' },
+                { name: 'Harbor Ledger', url: 'https://harborledger.example.org' },
+                { name: 'Fieldnote Review', url: 'https://fieldnote.example.net' },
+            ],
+            share: true,
+            copy: true,
+        },
+    },
+};

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

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

package/dist/manifest/entries/sparkline.js

@@ -0,0 +1,13 @@
+export const sparklineEntry = {
+    type: 'sparkline',
+    category: 'data',
+    description: 'Compact mini line chart for trend indicators. Color auto-derives from trend direction.',
+    props: {
+        values: { type: 'number[]', required: true, description: 'Numeric values, oldest to newest.' },
+        labels: { type: '(string | number)[]', required: false, description: 'Optional matching labels for tooltip.' },
+        color: { type: 'string', required: false, description: 'Override trend-driven color.' },
+        height: { type: 'number', required: false, description: 'Height in px. Default 36.' },
+        noTooltip: { type: 'boolean', required: false, description: 'Hide tooltip on hover.' },
+    },
+    example: { type: 'sparkline', props: { values: [12, 18, 15, 22, 28, 31, 25], labels: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'] } },
+};

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

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

package/dist/manifest/entries/split.js

@@ -0,0 +1,19 @@
+export const splitEntry = {
+    type: 'split',
+    category: 'layout',
+    description: 'Resizable two-pane layout (horizontal or vertical) with draggable divider. Use for inspector panels.',
+    props: {
+        direction: { type: '"horizontal" | "vertical"', required: false, description: 'Pane direction. Default "horizontal".' },
+        defaultSize: { type: 'number', required: false, description: 'Initial first-pane size as percent. Default 50.' },
+        minSize: { type: 'number', required: false, description: 'Minimum first-pane percent. Default 10.' },
+        maxSize: { type: 'number', required: false, description: 'Maximum first-pane percent. Default 90.' },
+    },
+    example: {
+        type: 'split',
+        props: { direction: 'horizontal', defaultSize: 30 },
+        children: [
+            { type: 'text', props: { text: 'Left navigation' } },
+            { type: 'text', props: { text: 'Right detail view' } },
+        ],
+    },
+};

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

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

package/dist/manifest/entries/spotlight.js

@@ -0,0 +1,14 @@
+export const spotlightEntry = {
+    type: 'spotlight',
+    category: 'layout',
+    description: 'Wraps children with a radial highlight that follows the cursor on hover (CSS, client-only pointer wiring). Use on a hero or feature card.',
+    props: {
+        size: { type: 'string', required: false, description: 'Highlight diameter (CSS length). Default 300px.' },
+        color: { type: 'string', required: false, description: 'Highlight colour. Default a translucent white.' },
+    },
+    example: {
+        type: 'spotlight',
+        class: 'rounded-xl border bg-card p-10',
+        children: [{ type: 'heading', props: { text: 'Hover to light it up' } }],
+    },
+};

package/dist/manifest/entries/standup-board.d.ts

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