@vobs/ui 0.2.0 → 1.0.0

package/dist/virtual-list.js

@@ -1,521 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/ui
- */
-import { Virtualizer, elementScroll } from '@tanstack/virtual-core';
-import { createUiDomPlan } from './primitives.js';
-export function createFixedVirtualListPlans(options) {
-    const state = calculateFixedVirtualListState(options);
-    return withVirtualListDomPlans(options, state);
-}
-export function createDynamicVirtualListPlans(options) {
-    const state = calculateDynamicVirtualListState(options);
-    return withVirtualListDomPlans(options, state);
-}
-export function createVirtualListLayoutPlans(options) {
-    const state = calculateVirtualListLayoutState(options);
-    return {
-        ...state,
-        root: createUiDomPlan('div', 'virtual-list', {
-            ...(options.className === undefined ? {} : { className: options.className }),
-            attrs: {
-                id: options.id,
-                role: options.layout === 'grid' ? 'grid' : 'list',
-                'aria-label': options.ariaLabel,
-                style: `width: ${options.viewportWidth}px; height: ${options.viewportHeight}px;${styleSuffix(options.attrs?.style)}`,
-                ...options.attrs,
-                'data-layout': state.layout,
-                'data-count': options.items.length,
-                'data-row-count': state.rowCount,
-                'data-column-count': state.columnCount,
-                'data-window-start': state.visibleStartIndex,
-                'data-window-end': state.visibleEndIndex,
-                'data-window-row-start': state.visibleRowStart,
-                'data-window-row-end': state.visibleRowEnd,
-                'data-window-column-start': state.visibleColumnStart,
-                'data-window-column-end': state.visibleColumnEnd,
-                'data-scroll-left': state.scrollLeft,
-                'data-scroll-top': state.scrollTop,
-                'data-total-width': state.totalWidth,
-                'data-total-height': state.totalHeight,
-                'data-layout-contract': 'true',
-            },
-        }),
-        spacer: createUiDomPlan('div', 'virtual-list-spacer', {
-            attrs: { style: `width: ${state.totalWidth}px; height: ${state.totalHeight}px;` },
-        }),
-    };
-}
-export function calculateVirtualListLayoutState(options) {
-    const itemWidth = positiveNumber(options.itemWidth, 'itemWidth');
-    const itemHeight = positiveNumber(options.itemHeight, 'itemHeight');
-    const count = options.items.length;
-    const viewportWidth = Math.max(0, options.viewportWidth);
-    const viewportHeight = Math.max(0, options.viewportHeight);
-    const overscan = options.overscan ?? 2;
-    const columnCount = options.layout === 'horizontal'
-        ? count
-        : Math.max(1, Math.trunc(options.columnCount ?? Math.max(1, Math.floor(viewportWidth / itemWidth))));
-    const rowCount = count === 0 ? 0 : Math.ceil(count / Math.max(1, columnCount));
-    const totalWidth = options.layout === 'horizontal' ? count * itemWidth : columnCount * itemWidth;
-    const totalHeight = options.layout === 'horizontal' ? itemHeight : rowCount * itemHeight;
-    const scrollLeft = clamp(options.scrollLeft ?? 0, 0, Math.max(totalWidth - viewportWidth, 0));
-    const scrollTop = clamp(options.scrollTop ?? 0, 0, Math.max(totalHeight - viewportHeight, 0));
-    if (count === 0) {
-        return createLayoutState(options, rowCount, columnCount, totalWidth, totalHeight, scrollLeft, scrollTop, 0, -1, 0, -1, []);
-    }
-    const visibleColumnStart = Math.max(0, Math.floor(scrollLeft / itemWidth));
-    const visibleColumnEnd = Math.min(Math.max(0, columnCount - 1), Math.ceil((scrollLeft + viewportWidth) / itemWidth));
-    const visibleRowStart = Math.max(0, Math.floor(scrollTop / itemHeight));
-    const visibleRowEnd = Math.min(Math.max(0, rowCount - 1), Math.ceil((scrollTop + viewportHeight) / itemHeight));
-    const ssrCount = options.ssrFallbackCount;
-    const rowStart = ssrCount === undefined ? Math.max(0, visibleRowStart - overscan) : 0;
-    const rowEnd = ssrCount === undefined
-        ? Math.min(rowCount - 1, visibleRowEnd + overscan)
-        : Math.min(rowCount - 1, Math.ceil(Math.max(0, ssrCount) / columnCount) - 1);
-    const columnStart = ssrCount === undefined ? Math.max(0, visibleColumnStart - overscan) : 0;
-    const columnEnd = ssrCount === undefined
-        ? Math.min(columnCount - 1, visibleColumnEnd + overscan)
-        : columnCount - 1;
-    const items = layoutRangeItems(options, itemWidth, itemHeight, columnCount, rowStart, rowEnd, columnStart, columnEnd).slice(0, ssrCount === undefined ? undefined : Math.max(0, ssrCount));
-    const first = items[0];
-    const last = items.at(-1);
-    return createLayoutState(options, rowCount, columnCount, totalWidth, totalHeight, scrollLeft, scrollTop, first?.index ?? 0, last?.index ?? -1, visibleRowStart, visibleRowEnd, items, visibleColumnStart, visibleColumnEnd);
-}
-export function createVirtualListResizeMeasurementContract(options) {
-    const measuredKeys = options.items
-        .map((item, index) => ({
-        key: keyFor(options, index),
-        height: options.getMeasuredItemHeight?.(item, index),
-    }))
-        .filter((entry) => entry.height !== undefined && Number.isFinite(entry.height) && entry.height > 0)
-        .map((entry) => entry.key);
-    const measuringKeys = uniqueKeys(options.measuringIds ?? []);
-    const plans = createDynamicVirtualListPlans(options.getMeasuredItemHeight === undefined
-        ? options
-        : {
-            ...options,
-            getItemHeight: options.getMeasuredItemHeight,
-        });
-    const estimatedKeys = options.items
-        .map((_, index) => keyFor(options, index))
-        .filter((key) => !measuredKeys.includes(key));
-    return {
-        plans,
-        measuredKeys,
-        measuringKeys,
-        estimatedKeys,
-        attrs: {
-            'data-resize-measurement-contract': 'true',
-            'data-measured-count': measuredKeys.length,
-            'data-estimated-count': estimatedKeys.length,
-            'data-measuring-count': measuringKeys.length,
-            'data-measured-keys': measuredKeys.join(','),
-            'data-estimated-keys': estimatedKeys.join(','),
-            'data-measuring-keys': measuringKeys.join(','),
-            'data-total-size': plans.totalSize,
-            'data-viewport-height': options.viewportHeight,
-            'data-scroll-offset': plans.scrollOffset,
-            'aria-busy': measuringKeys.length > 0 ? 'true' : undefined,
-        },
-    };
-}
-export function createVirtualListAnchorStateContract(options) {
-    const itemHeight = positiveNumber(options.itemHeight, 'itemHeight');
-    const previousAnchorIndex = findItemIndexByKey(options.previousItems, options.anchorKey, options.getKey);
-    const nextAnchorIndex = findItemIndexByKey(options.nextItems, options.anchorKey, options.getKey);
-    const anchorOffset = Math.max(0, options.anchorOffset ?? 0);
-    const viewportHeight = Math.max(0, options.viewportHeight ?? 0);
-    const maxOffset = Math.max(options.nextItems.length * itemHeight - viewportHeight, 0);
-    const anchorOffsetTarget = nextAnchorIndex < 0 ? 0 : nextAnchorIndex * itemHeight + anchorOffset;
-    const scrollOffset = options.stickToEnd === true ? maxOffset : clamp(anchorOffsetTarget, 0, maxOffset);
-    const insertedBeforeCount = previousAnchorIndex < 0 || nextAnchorIndex < 0
-        ? 0
-        : Math.max(0, nextAnchorIndex - previousAnchorIndex);
-    const state = nextAnchorIndex < 0 ? 'missing-anchor' : options.stickToEnd === true ? 'end' : 'preserved';
-    return {
-        scrollOffset,
-        previousAnchorIndex,
-        nextAnchorIndex,
-        insertedBeforeCount,
-        attrs: {
-            'data-anchor-contract': 'true',
-            'data-anchor-mode': options.mode ?? 'preserve',
-            'data-anchor-state': state,
-            'data-anchor-key': String(options.anchorKey),
-            'data-previous-anchor-index': previousAnchorIndex,
-            'data-next-anchor-index': nextAnchorIndex,
-            'data-inserted-before-count': insertedBeforeCount,
-            'data-scroll-offset': scrollOffset,
-            'data-stick-to-end': options.stickToEnd === true ? 'true' : undefined,
-        },
-    };
-}
-export function calculateFixedVirtualListState(options) {
-    const itemHeight = positiveNumber(options.itemHeight, 'itemHeight');
-    const count = options.items.length;
-    if (count === 0)
-        return createState(options, itemHeight, 0, 0, -1, []);
-    const viewportHeight = Math.max(0, options.viewportHeight);
-    const scrollOffset = clamp(options.scrollOffset ?? 0, 0, Math.max(count * itemHeight - viewportHeight, 0));
-    const visibleStart = Math.floor(scrollOffset / itemHeight);
-    const visibleEnd = Math.min(count - 1, Math.ceil((scrollOffset + viewportHeight) / itemHeight));
-    const ssrCount = options.ssrFallbackCount;
-    const fallbackEnd = ssrCount === undefined ? visibleEnd : Math.min(count - 1, Math.max(0, ssrCount) - 1);
-    const start = ssrCount === undefined ? Math.max(0, visibleStart - (options.overscan ?? 2)) : 0;
-    const end = ssrCount === undefined
-        ? Math.min(count - 1, visibleEnd + (options.overscan ?? 2))
-        : fallbackEnd;
-    return createState(options, itemHeight, scrollOffset, visibleStart, visibleEnd, rangeItems(options, start, end));
-}
-export function calculateDynamicVirtualListState(options) {
-    const estimatedItemHeight = positiveNumber(options.estimatedItemHeight, 'estimatedItemHeight');
-    const count = options.items.length;
-    if (count === 0) {
-        return createDynamicState(options, 0, 0, 0, -1, 0, []);
-    }
-    const metrics = dynamicItemMetrics(options, estimatedItemHeight);
-    const totalSize = metrics.at(-1)?.end ?? 0;
-    const viewportHeight = Math.max(0, options.viewportHeight);
-    const scrollOffset = clamp(options.scrollOffset ?? 0, 0, Math.max(totalSize - viewportHeight, 0));
-    const visibleStart = firstDynamicIndexAfter(metrics, scrollOffset);
-    const visibleEnd = lastDynamicIndexBefore(metrics, scrollOffset + viewportHeight);
-    const ssrCount = options.ssrFallbackCount;
-    const fallbackEnd = ssrCount === undefined ? visibleEnd : Math.min(count - 1, Math.max(0, ssrCount) - 1);
-    const start = ssrCount === undefined ? Math.max(0, visibleStart - (options.overscan ?? 2)) : 0;
-    const end = ssrCount === undefined
-        ? Math.min(count - 1, visibleEnd + (options.overscan ?? 2))
-        : fallbackEnd;
-    return createDynamicState(options, totalSize, scrollOffset, visibleStart, visibleEnd, metrics.filter((metric) => metric.measured).length, dynamicRangeItems(options, metrics, start, end));
-}
-export function createFixedVirtualListController(options) {
-    let current = normalizeControllerOptions(options);
-    let disposed = false;
-    const virtualizer = new Virtualizer({
-        count: current.items.length,
-        getScrollElement: current.getScrollElement,
-        estimateSize: () => current.itemHeight,
-        scrollToFn: elementScroll,
-        observeElementRect: (instance, callback) => {
-            const element = instance.scrollElement;
-            if (element === null)
-                return undefined;
-            callback({
-                width: element.clientWidth,
-                height: element.clientHeight || current.viewportHeight,
-            });
-            return undefined;
-        },
-        observeElementOffset: (instance, callback) => {
-            const element = instance.scrollElement;
-            if (element === null)
-                return undefined;
-            let frame = 0;
-            let first = true;
-            const readOffset = () => {
-                if (first && element.scrollTop === 0 && current.initialOffset > 0)
-                    return current.initialOffset;
-                return element.scrollTop;
-            };
-            const emit = (scrolling) => {
-                if (frame !== 0)
-                    return;
-                frame = requestFrame(() => {
-                    frame = 0;
-                    first = false;
-                    callback(readOffset(), scrolling);
-                });
-            };
-            const onScroll = () => emit(true);
-            element.addEventListener('scroll', onScroll, { passive: true });
-            callback(readOffset(), false);
-            first = false;
-            return () => {
-                if (frame !== 0)
-                    cancelFrame(frame);
-                element.removeEventListener('scroll', onScroll);
-            };
-        },
-        getItemKey: (index) => keyFor(current, index),
-        overscan: current.overscan,
-        initialOffset: current.initialOffset,
-        initialRect: { width: 0, height: current.viewportHeight },
-        anchorTo: 'start',
-        onChange: (instance, sync) => {
-            current.onChange?.(stateFromVirtualizer(current, instance), sync);
-        },
-    });
-    const cleanup = virtualizer._didMount();
-    virtualizer._willUpdate();
-    return {
-        read() {
-            return withVirtualListDomPlans(current, stateFromVirtualizer(current, virtualizer));
-        },
-        update(next) {
-            if (disposed)
-                return;
-            current = normalizeControllerOptions({ ...current, ...next });
-            virtualizer.setOptions({
-                ...virtualizer.options,
-                count: current.items.length,
-                overscan: current.overscan,
-            });
-            virtualizer._willUpdate();
-        },
-        scrollToOffset(offset) {
-            if (!disposed)
-                virtualizer.scrollToOffset(offset);
-        },
-        scrollToIndex(index) {
-            if (!disposed)
-                virtualizer.scrollToIndex(index);
-        },
-        takeScrollState() {
-            const state = stateFromVirtualizer(current, virtualizer);
-            return {
-                scrollOffset: state.scrollOffset,
-                visibleStartIndex: state.visibleStartIndex,
-                visibleEndIndex: state.visibleEndIndex,
-            };
-        },
-        destroy() {
-            if (disposed)
-                return;
-            disposed = true;
-            cleanup();
-        },
-    };
-}
-function stateFromVirtualizer(options, virtualizer) {
-    const items = virtualizer
-        .getVirtualItems()
-        .map((virtualItem) => itemFromRange(options, virtualItem.index, virtualItem.start, virtualItem.size));
-    const first = items[0];
-    const last = items.at(-1);
-    return createState(options, options.itemHeight, virtualizer.scrollOffset ?? 0, first?.index ?? 0, last?.index ?? -1, items);
-}
-function withVirtualListDomPlans(options, state) {
-    return {
-        ...state,
-        root: createUiDomPlan('div', 'virtual-list', {
-            ...(options.className === undefined ? {} : { className: options.className }),
-            attrs: {
-                id: options.id,
-                role: 'list',
-                'aria-label': options.ariaLabel,
-                style: `height: ${options.viewportHeight}px;${styleSuffix(options.attrs?.style)}`,
-                ...options.attrs,
-                'data-count': options.items.length,
-                'data-window-start': state.visibleStartIndex,
-                'data-window-end': state.visibleEndIndex,
-                'data-dynamic': 'estimatedItemHeight' in options ? 'true' : undefined,
-                'data-measured-count': 'measuredCount' in state ? state.measuredCount : undefined,
-            },
-        }),
-        spacer: createUiDomPlan('div', 'virtual-list-spacer', {
-            attrs: { style: `height: ${state.totalSize}px;` },
-        }),
-    };
-}
-function createState(options, itemHeight, scrollOffset, visibleStartIndex, visibleEndIndex, items) {
-    return {
-        totalSize: options.items.length * itemHeight,
-        scrollOffset,
-        visibleStartIndex,
-        visibleEndIndex,
-        items,
-    };
-}
-function rangeItems(options, startIndex, endIndex) {
-    const result = [];
-    for (let index = startIndex; index <= endIndex; index++) {
-        result.push(itemFromRange(options, index, index * options.itemHeight, options.itemHeight));
-    }
-    return result;
-}
-function itemFromRange(options, index, start, size) {
-    return {
-        key: keyFor(options, index),
-        index,
-        item: options.items[index],
-        start,
-        size,
-        end: start + size,
-        plan: createUiDomPlan('div', 'virtual-list-item', {
-            attrs: {
-                role: 'listitem',
-                'aria-posinset': index + 1,
-                'aria-setsize': options.items.length,
-                'data-index': index,
-                'data-key': String(keyFor(options, index)),
-                style: `height: ${size}px; transform: translateY(${start}px);`,
-            },
-        }),
-    };
-}
-function createDynamicState(options, totalSize, scrollOffset, visibleStartIndex, visibleEndIndex, measuredCount, items) {
-    return {
-        totalSize,
-        scrollOffset,
-        visibleStartIndex,
-        visibleEndIndex,
-        measuredCount,
-        items,
-    };
-}
-function dynamicRangeItems(options, metrics, startIndex, endIndex) {
-    const result = [];
-    for (let index = startIndex; index <= endIndex; index++) {
-        const metric = metrics[index];
-        if (metric === undefined)
-            continue;
-        result.push(dynamicItemFromMetric(options, index, metric));
-    }
-    return result;
-}
-function dynamicItemFromMetric(options, index, metric) {
-    return {
-        key: keyFor(options, index),
-        index,
-        item: options.items[index],
-        start: metric.start,
-        size: metric.size,
-        measured: metric.measured,
-        end: metric.end,
-        plan: createUiDomPlan('div', 'virtual-list-item', {
-            attrs: {
-                role: 'listitem',
-                'aria-posinset': index + 1,
-                'aria-setsize': options.items.length,
-                'data-index': index,
-                'data-key': String(keyFor(options, index)),
-                'data-measured': metric.measured ? 'true' : 'false',
-                style: `height: ${metric.size}px; transform: translateY(${metric.start}px);`,
-            },
-        }),
-    };
-}
-function dynamicItemMetrics(options, estimatedItemHeight) {
-    const metrics = [];
-    let start = 0;
-    for (let index = 0; index < options.items.length; index++) {
-        const measuredHeight = options.getItemHeight?.(options.items[index], index);
-        const measured = measuredHeight !== undefined && Number.isFinite(measuredHeight) && measuredHeight > 0;
-        const size = measured ? measuredHeight : estimatedItemHeight;
-        metrics.push({ start, size, measured, end: start + size });
-        start += size;
-    }
-    return metrics;
-}
-function createLayoutState(options, rowCount, columnCount, totalWidth, totalHeight, scrollLeft, scrollTop, visibleStartIndex, visibleEndIndex, visibleRowStart, visibleRowEnd, items, visibleColumnStart = 0, visibleColumnEnd = -1) {
-    return {
-        layout: options.layout,
-        rowCount,
-        columnCount,
-        totalWidth,
-        totalHeight,
-        scrollLeft,
-        scrollTop,
-        visibleStartIndex,
-        visibleEndIndex,
-        visibleRowStart,
-        visibleRowEnd,
-        visibleColumnStart,
-        visibleColumnEnd,
-        items,
-    };
-}
-function layoutRangeItems(options, itemWidth, itemHeight, columnCount, rowStart, rowEnd, columnStart, columnEnd) {
-    const result = [];
-    for (let rowIndex = rowStart; rowIndex <= rowEnd; rowIndex++) {
-        for (let columnIndex = columnStart; columnIndex <= columnEnd; columnIndex++) {
-            const index = rowIndex * columnCount + columnIndex;
-            if (index >= options.items.length)
-                continue;
-            result.push(layoutItemFromRange(options, index, rowIndex, columnIndex, itemWidth, itemHeight));
-        }
-    }
-    return result;
-}
-function layoutItemFromRange(options, index, rowIndex, columnIndex, width, height) {
-    const x = columnIndex * width;
-    const y = rowIndex * height;
-    const key = keyFor(options, index);
-    return {
-        key,
-        index,
-        item: options.items[index],
-        rowIndex,
-        columnIndex,
-        x,
-        y,
-        width,
-        height,
-        plan: createUiDomPlan('div', 'virtual-list-item', {
-            attrs: {
-                role: options.layout === 'grid' ? 'gridcell' : 'listitem',
-                'aria-posinset': options.layout === 'horizontal' ? index + 1 : undefined,
-                'aria-setsize': options.layout === 'horizontal' ? options.items.length : undefined,
-                'aria-rowindex': options.layout === 'grid' ? rowIndex + 1 : undefined,
-                'aria-colindex': options.layout === 'grid' ? columnIndex + 1 : undefined,
-                'data-index': index,
-                'data-key': String(key),
-                'data-row-index': rowIndex,
-                'data-column-index': columnIndex,
-                style: `width: ${width}px; height: ${height}px; transform: translate(${x}px, ${y}px);`,
-            },
-        }),
-    };
-}
-function firstDynamicIndexAfter(metrics, offset) {
-    const index = metrics.findIndex((metric) => metric.end > offset);
-    return index === -1 ? Math.max(0, metrics.length - 1) : index;
-}
-function lastDynamicIndexBefore(metrics, offset) {
-    const index = metrics.findIndex((metric) => metric.start >= offset);
-    if (index === -1)
-        return metrics.length - 1;
-    return Math.max(0, index);
-}
-function normalizeControllerOptions(options) {
-    return {
-        ...options,
-        itemHeight: positiveNumber(options.itemHeight, 'itemHeight'),
-        viewportHeight: options.viewportHeight ?? 0,
-        overscan: options.overscan ?? 2,
-        initialOffset: options.initialOffset ?? 0,
-    };
-}
-function keyFor(options, index) {
-    return options.getKey?.(options.items[index], index) ?? index;
-}
-function findItemIndexByKey(items, key, getKey) {
-    return items.findIndex((item, index) => (getKey?.(item, index) ?? index) === key);
-}
-function uniqueKeys(keys) {
-    return [...new Set(keys)];
-}
-function positiveNumber(value, name) {
-    if (!Number.isFinite(value) || value <= 0)
-        throw new Error(`${name} must be a positive number`);
-    return value;
-}
-function clamp(value, min, max) {
-    return Math.min(Math.max(value, min), max);
-}
-function requestFrame(callback) {
-    if (typeof requestAnimationFrame === 'function')
-        return requestAnimationFrame(callback);
-    return setTimeout(callback, 16);
-}
-function cancelFrame(frame) {
-    if (typeof cancelAnimationFrame === 'function')
-        cancelAnimationFrame(frame);
-    else
-        clearTimeout(frame);
-}
-function styleSuffix(value) {
-    if (typeof value !== 'string' || value.trim() === '')
-        return '';
-    return value.trim().endsWith(';') ? value.trim() : `${value.trim()};`;
-}

package/dist/workbench.d.ts

@@ -1,136 +0,0 @@
-/** @license MIT
- * Copyright (c) 2026 vobsjs
- * @vobs/ui
- */
-import { type UiAttributes, type UiDomPlan } from './primitives.js';
-/**
- * Workbench shell component plans — an IDE/workbench-style component family:
- * rich status bar (status-bar), activity rail (activity-rail), workbench titlebar (workbench-titlebar), chat composer (chat-composer).
- *
- * Spec sources: UIStyle/preview/component-status-bar.html, component-activity-rail.html,
- * component-workbench-titlebar.html, component-chat-composer.html (ds-* classes).
- *
- * Homogeneous with other plans components in the ui package: pure static DOM plans + derived state;
- * text/icons are carried via data-label / data-icon and mapped by the app at render time — plans hold no DOM text fields.
- */
-export type StatusDotTone = 'success' | 'warning' | 'error';
-export interface StatusBarItemPlan extends UiDomPlan<'span'> {
-    readonly itemId: string;
-    /** Icon identifier (optional). */
-    readonly icon?: string;
-    /** Status dot tone (optional). */
-    readonly tone?: StatusDotTone;
-    /** Text. */
-    readonly label: string;
-}
-export interface StatusBarGroupPlan {
-    readonly groupId: string;
-    readonly items: readonly StatusBarItemPlan[];
-}
-export interface StatusBarPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly groups: readonly StatusBarGroupPlan[];
-}
-export interface StatusBarGroupInput {
-    readonly id: string;
-    readonly items: readonly {
-        readonly id: string;
-        readonly label: string;
-        readonly icon?: string;
-        readonly tone?: StatusDotTone;
-    }[];
-}
-export interface StatusBarPlanOptions {
-    readonly id: string;
-    readonly groups: readonly StatusBarGroupInput[];
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createStatusBarPlans(options: StatusBarPlanOptions): StatusBarPlans;
-export type ActivityRailEntryKind = 'button' | 'divider' | 'spacer';
-export interface ActivityRailButtonPlan extends UiDomPlan<'button'> {
-    readonly entryId: string;
-    readonly kind: 'button';
-    /** Icon identifier. */
-    readonly icon: string;
-    readonly active: boolean;
-}
-export interface ActivityRailDividerPlan extends UiDomPlan<'div'> {
-    readonly entryId: string;
-    readonly kind: 'divider';
-}
-export interface ActivityRailSpacerPlan extends UiDomPlan<'span'> {
-    readonly entryId: string;
-    readonly kind: 'spacer';
-}
-export type ActivityRailEntryPlan = ActivityRailButtonPlan | ActivityRailDividerPlan | ActivityRailSpacerPlan;
-export interface ActivityRailEntryInput {
-    readonly id: string;
-    readonly kind: ActivityRailEntryKind;
-    /** Required when kind='button'. */
-    readonly icon?: string;
-    readonly active?: boolean;
-    readonly disabled?: boolean;
-}
-export interface ActivityRailPlans {
-    readonly root: UiDomPlan<'nav'>;
-    readonly entries: readonly ActivityRailEntryPlan[];
-}
-export interface ActivityRailPlanOptions {
-    readonly id: string;
-    readonly entries: readonly ActivityRailEntryInput[];
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createActivityRailPlans(options: ActivityRailPlanOptions): ActivityRailPlans;
-export type TitlebarLightKind = 'close' | 'min' | 'max';
-export interface WorkbenchTitlebarPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly left: UiDomPlan<'div'>;
-    /** Red/yellow/green window lights. */
-    readonly lights: readonly UiDomPlan<'span'>[];
-    readonly modeChip: UiDomPlan<'span'>;
-    readonly projectSelector: UiDomPlan<'button'>;
-    readonly right: UiDomPlan<'div'>;
-    /** Right-side icon buttons (data-icon identifier). */
-    readonly actions: readonly UiDomPlan<'button'>[];
-}
-export interface WorkbenchTitlebarPlanOptions {
-    readonly id: string;
-    /** Mode chip text (e.g. 'Agent Mode'). */
-    readonly mode?: string;
-    /** Project selector text. */
-    readonly project?: string;
-    /** Right-side action icon list. */
-    readonly actions?: readonly string[];
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createWorkbenchTitlebarPlans(options: WorkbenchTitlebarPlanOptions): WorkbenchTitlebarPlans;
-export interface ChatComposerPlans {
-    readonly root: UiDomPlan<'div'>;
-    readonly input: UiDomPlan<'textarea'>;
-    readonly toolbar: UiDomPlan<'div'>;
-    readonly tools: UiDomPlan<'div'>;
-    /** Left-side tool buttons (data-icon identifier). */
-    readonly toolButtons: readonly UiDomPlan<'button'>[];
-    readonly modelSelector: UiDomPlan<'button'>;
-    readonly actions: UiDomPlan<'div'>;
-    /** Right-side action buttons (including send). */
-    readonly actionButtons: readonly UiDomPlan<'button'>[];
-}
-export interface ChatComposerPlanOptions {
-    readonly id: string;
-    /** Input placeholder. */
-    readonly placeholder?: string;
-    /** Left-side tool icon list. */
-    readonly tools?: readonly string[];
-    /** Model selector text. */
-    readonly model?: string;
-    /** Right-side action icon list (the send button is handled by the renderer via data-send). */
-    readonly actions?: readonly string[];
-    readonly disabled?: boolean;
-    readonly className?: string;
-    readonly attrs?: UiAttributes;
-}
-export declare function createChatComposerPlans(options: ChatComposerPlanOptions): ChatComposerPlans;