@iris-ui-kit/vue 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import * as vue from 'vue';
-import { ShallowRef, VNode, PropType, ComputedRef, Ref, InjectionKey } from 'vue';
+import { ShallowRef, Ref, VNode, PropType, ComputedRef, InjectionKey } from 'vue';
 import * as _iris_ui_kit_core from '@iris-ui-kit/core';
-import { ReadonlyStore, Store, Variant, Size, Placement, FloatingMachine, SpreadsheetXmlOptions } from '@iris-ui-kit/core';
-export { Align, DataSourceConfig, DataSourceController, DataSourceMode, DataSourceMutateOptions, DataSourceQuery, DataSourceState, DataViewColumn, FloatingEvent, FloatingMachine, FloatingState, GroupedViewConfig, GroupedViewState, GroupedViewStore, IrisHsva, PageItem as IrisPageItem, IrisRgba, Machine, MachineConfig, MachineEvent, MachineState, MutateOptions, NavNode, Placement, ResourceController, ResourceControllerConfig, ResourceQuery, ResourceState, RowMutateOptions, Side, Size, StateNode, Store, TabItem, TabsNav, TabsNavConfig, TabsNavState, Transition, Variant, addDays, addMonths, buildMonthMatrix, clamp01, clampDate, composeEventHandlers, createClientDataSource, createClientFetcher, createDataSource, createFloatingMachine, createGroupedView, createMachine, createResourceController, createStore, createTabsNav, endOfMonth, findNavNode, findNavPath, firstLeaf, flattenNav, formatLocalISO, formatMonthYear, generateId, getPageRange, getWeekdayNames, hexToRgba, hsvToRgb, hsvaToRgba, isBranch, isClosable, isOutOfRange, isSameDay, isSameMonth, mergeProps, rgbToHex, rgbToHsv, rgbaToHsva, startOfDay, startOfMonth, visibleNav } from '@iris-ui-kit/core';
+import { ReadonlyStore, Store, RealtimeHandlers, RealtimeOptions, RealtimeStatus, ResilientFetcherOptions, ResilientFetcher, DisposableScope, Variant, Size, Placement, FloatingMachine, SpreadsheetXmlOptions } from '@iris-ui-kit/core';
+export { AdminPreferences, AdminPreferencesState, Align, DataSourceConfig, DataSourceController, DataSourceMode, DataSourceMutateOptions, DataSourceQuery, DataSourceState, DataViewColumn, FloatingEvent, FloatingMachine, FloatingState, GroupedViewConfig, GroupedViewState, GroupedViewStore, IrisHsva, PageItem as IrisPageItem, IrisRgba, Machine, MachineConfig, MachineEvent, MachineState, MutateOptions, NavNode, Placement, ResourceController, ResourceControllerConfig, ResourceQuery, ResourceState, RowMutateOptions, Side, Size, StateNode, Store, TabItem, TabsNav, TabsNavConfig, TabsNavState, Transition, Variant, addDays, addMonths, buildMonthMatrix, clamp01, clampDate, composeEventHandlers, createAdminPreferences, createClientDataSource, createClientFetcher, createDataSource, createFloatingMachine, createGroupedView, createMachine, createResourceController, createStore, createTabsNav, endOfMonth, filterNavByAccess, findNavNode, findNavPath, firstLeaf, flattenNav, formatLocalISO, formatMonthYear, generateId, getPageRange, getWeekdayNames, hexToRgba, hsvToRgb, hsvaToRgba, isBranch, isClosable, isOutOfRange, isSameDay, isSameMonth, localStorageAdminPreferencesStorage, mergeProps, nodeAllowsRoles, rgbToHex, rgbToHsv, rgbaToHsva, startOfDay, startOfMonth, visibleNav } from '@iris-ui-kit/core';
 export { IrisThemeContext, IrisThemeKey, ThemeProvider, UseThemeReturn, useColorScheme, useDirection, useTheme, useThemeContext } from './theme.cjs';
 export { ApplySkinResult, LoadSkinOptions, ResolvedSkin, Skin, SkinBootScriptConfig, SkinCatalog, SkinCatalogConfig, SkinEngine, SkinEngineConfig, SkinError, SkinErrorCode, SkinLookup, SkinManifest, SkinManifestEntry, SkinMode, SkinPatch, SkinRegistry, SkinResolutionError, SkinStorage, SkinTokenOverrides, applySkin, builtinSkins, createSkinCatalog, createSkinEngine, createSkinRegistry, darkSkin, lightSkin, loadSkin, localStorageSkinStorage, memorySkinStorage, renderSkinStyle, resolveSkin, skinBootScript, skinError, skinToCssEntries, validateSkin } from '@iris-ui-kit/skins';
 export { IrisSkinContext, IrisSkinKey, SkinProvider, UseSkinReturn, useSkin, useSkinContext } from './skins.cjs';
@@ -13,7 +13,7 @@ export { UseAsyncResourceOptions, UseAsyncResourceReturn, UsePaginatedResourceOp
 export { UseResourceController, useResourceController } from './resource.cjs';
 export { UseDataSource, UseGroupedView, useDataSource, useGroupedView } from './data.cjs';
 export { DATA_STATE_CLASS, DataStateNodeProps, UseDataStateReturn, __resetDataStateStyles, installDataStateStyles, useDataState, usePrefersReducedMotion } from './motion.cjs';
-export { IrisAdminBreadcrumb, IrisAdminLayout, IrisAdminLayoutMode, IrisAdminTabs, IrisNavMenu, UseAdminShellConfig, UseAdminShellReturn, UseTabsNavReturn, useAdminShell, useTabsNav } from './admin.cjs';
+export { IrisAdminBreadcrumb, IrisAdminContentHeight, IrisAdminContentWidth, IrisAdminLayout, IrisAdminLayoutMode, IrisAdminLayoutProps, IrisAdminMenuAlign, IrisAdminTabs, IrisNavMenu, UseAdminPreferencesReturn, UseAdminShellConfig, UseAdminShellReturn, UseTabsNavReturn, useAdminPreferences, useAdminShell, useTabsNav } from './admin.cjs';
 export { UndoStackReactiveState, useUndoStack } from './undo.cjs';
 export { UndoStack, UndoStackOptions, createUndoStack } from '@iris-ui-kit/core/undo';
 export { IrisProvider, IrisProviderProps, PluginStoreContext, PluginStoreContextKey, usePlugin, usePluginStore } from './provider.cjs';
@@ -43,6 +43,58 @@ declare function useStore<T>(store: ReadonlyStore<T>): Readonly<ShallowRef<T>>;
  */
 declare function useStoreSelector<T, U>(store: Store<T>, selector: (state: T) => U, equals?: (a: U, b: U) => boolean): Readonly<ShallowRef<U>>;
 
+/**
+ * Vue composable for `createReconnectingSource` — a realtime subscription with
+ * automatic exponential-backoff reconnection.
+ *
+ * Returns a reactive `status` ref. The source is opened in `onMounted` and
+ * closed/cleaned up in `onUnmounted`.
+ */
+declare function useReconnectingSource<T>(connect: (sink: {
+    message: (data: T) => void;
+    open: () => void;
+    error: (err: unknown) => void;
+    close: () => void;
+}) => () => void, handlers: Pick<RealtimeHandlers<T>, 'onMessage' | 'onOpen' | 'onError' | 'onClose'>, options?: RealtimeOptions): Ref<RealtimeStatus>;
+
+/**
+ * Vue composable for `createResilientFetcher` — a hardened async fetcher with
+ * cache dedup/TTL/SWR, circuit breaker, and optional rate limiting.
+ *
+ * The resilient fetcher is created once and lives for the component's lifetime.
+ * The cache is cleared on unmount.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * import { useResilientFetcher } from '@iris-ui-kit/vue'
+ * import { ref, onMounted } from 'vue'
+ *
+ * const rf = useResilientFetcher<{ name: string }>({ ttlMs: 30_000 })
+ * const user = ref<{ name: string } | null>(null)
+ *
+ * onMounted(async () => {
+ *   user.value = await rf.fetch('user:1', async () => {
+ *     const res = await fetch('/api/users/1')
+ *     return res.json()
+ *   })
+ * })
+ * </script>
+ * ```
+ */
+declare function useResilientFetcher<T>(options?: ResilientFetcherOptions): ResilientFetcher<T>;
+
+/**
+ * Vue composable for `createDisposableScope` — creates a disposable scope
+ * that is automatically torn down when the component is unmounted.
+ *
+ * Returns a reactive `scope` ref that stays alive for the component's lifetime.
+ * Call `scope.value.add(teardown)` to register cleanup callbacks.
+ */
+declare function useDisposableScope(): {
+    value: DisposableScope;
+};
+
 /**
  * Compose multiple Vue template refs into a single function ref. Each input
  * may be a `Ref<HTMLElement | null>`, a function ref `(el) => void`, or null.
@@ -210,8 +262,8 @@ declare const IrisButton: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     onClick?: ((_event: MouseEvent) => any) | undefined;
 }>, {
-    type: IrisButtonType;
     size: _iris_ui_kit_core.Size;
+    type: IrisButtonType;
     loading: boolean;
     disabled: boolean;
     asChild: boolean;
@@ -732,9 +784,9 @@ declare const IrisDrawer: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     "onUpdate:open"?: ((_value: boolean) => any) | undefined;
 }>, {
+    open: boolean;
     size: string;
     side: IrisDrawerSide;
-    open: boolean;
     defaultOpen: boolean;
     closeOnOutsideClick: boolean;
     closeOnEscape: boolean;
@@ -904,8 +956,8 @@ declare const IrisInput: vue.DefineComponent<vue.ExtractPropTypes<{
     onFocus?: ((_event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((_value: string) => any) | undefined;
 }>, {
-    type: IrisInputType;
     size: Size;
+    type: IrisInputType;
     id: string;
     invalid: boolean;
     disabled: boolean;
@@ -1304,9 +1356,9 @@ declare const IrisOtpInput: vue.DefineComponent<vue.ExtractPropTypes<{
     "onUpdate:modelValue"?: ((_value: string) => any) | undefined;
     onComplete?: ((_value: string) => any) | undefined;
 }>, {
+    size: IrisOtpInputSize;
     type: IrisOtpInputType;
     length: number;
-    size: IrisOtpInputSize;
     id: string;
     mask: boolean;
     invalid: boolean;
@@ -1732,8 +1784,8 @@ declare const IrisFormField: vue.DefineComponent<vue.ExtractPropTypes<{
         default: string;
     };
 }>> & Readonly<{}>, {
-    required: boolean;
     size: "sm" | "md";
+    required: boolean;
     label: string;
     error: string;
     hint: string;
@@ -1821,8 +1873,8 @@ declare const IrisSwitch: vue.DefineComponent<vue.ExtractPropTypes<{
     onChange?: ((_value: boolean) => any) | undefined;
     "onUpdate:modelValue"?: ((_value: boolean) => any) | undefined;
 }>, {
-    name: string;
     size: Size;
+    name: string;
     id: string;
     invalid: boolean;
     disabled: boolean;
@@ -1938,8 +1990,8 @@ declare const IrisCheckbox: vue.DefineComponent<vue.ExtractPropTypes<{
     "onUpdate:modelValue"?: ((_value: boolean) => any) | undefined;
 }>, {
     value: string | number;
-    name: string;
     size: Size;
+    name: string;
     id: string;
     invalid: boolean;
     ariaLabel: string;
@@ -2004,8 +2056,8 @@ declare const IrisRadioGroup: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((_value: string | number | boolean) => any) | undefined;
 }>, {
-    name: string;
     size: Size;
+    name: string;
     disabled: boolean;
     modelValue: string | number | boolean | null;
     defaultValue: string | number | boolean | null;
@@ -2182,9 +2234,23 @@ declare const IrisList: vue.DefineComponent<vue.ExtractPropTypes<{
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 type IrisSelectSize = Size;
+interface IrisSelectProps<T = unknown> {
+    items: IrisListItem<T>[];
+    modelValue?: T;
+    defaultValue?: T;
+    placeholder?: string;
+    size?: IrisSelectSize;
+    disabled?: boolean;
+    placement?: Placement;
+    invalid?: boolean;
+    id?: string;
+    ariaDescribedby?: string;
+    teleport?: false | HTMLElement | string;
+}
 /**
  * Single-select dropdown. Composes Popover (positioning + dismiss) with List
- * (keyboard nav + selection). Two-way binds via `v-model`.
+ * (keyboard nav + selection). Two-way binds via `v-model`; when `modelValue`
+ * is omitted it owns its value, seeded by `defaultValue`.
  *
  * The trigger is a styled `<button>` showing the current item's `label` (or
  * `value` as fallback) or `placeholder` when empty. Pass `#trigger` to fully
@@ -2198,6 +2264,10 @@ declare const IrisSelect: vue.DefineComponent<vue.ExtractPropTypes<{
     modelValue: {
         type: PropType<unknown>;
     };
+    defaultValue: {
+        type: PropType<unknown>;
+        default: undefined;
+    };
     placeholder: {
         type: StringConstructor;
         default: undefined;
@@ -2237,6 +2307,7 @@ declare const IrisSelect: vue.DefineComponent<vue.ExtractPropTypes<{
     [key: string]: any;
 }>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     'update:modelValue': (_value: unknown) => true;
+    valueChange: (_value: unknown) => true;
 }, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     items: {
         type: PropType<IrisListItem<unknown>[]>;
@@ -2245,6 +2316,10 @@ declare const IrisSelect: vue.DefineComponent<vue.ExtractPropTypes<{
     modelValue: {
         type: PropType<unknown>;
     };
+    defaultValue: {
+        type: PropType<unknown>;
+        default: undefined;
+    };
     placeholder: {
         type: StringConstructor;
         default: undefined;
@@ -2282,6 +2357,7 @@ declare const IrisSelect: vue.DefineComponent<vue.ExtractPropTypes<{
     };
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((_value: unknown) => any) | undefined;
+    onValueChange?: ((_value: unknown) => any) | undefined;
 }>, {
     size: Size;
     id: string;
@@ -2291,6 +2367,7 @@ declare const IrisSelect: vue.DefineComponent<vue.ExtractPropTypes<{
     teleport: string | false | HTMLElement;
     placeholder: string;
     ariaDescribedby: string;
+    defaultValue: undefined;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 interface DragState {
@@ -2448,8 +2525,8 @@ declare const IrisAvatar: vue.DefineComponent<vue.ExtractPropTypes<{
         default: string;
     };
 }>> & Readonly<{}>, {
-    name: string;
     size: IrisAvatarSize;
+    name: string;
     fallback: string;
     src: string;
     alt: string;
@@ -2589,8 +2666,8 @@ declare const IrisIcon: vue.DefineComponent<vue.ExtractPropTypes<{
         default: () => IrisIconRegistry;
     };
 }>> & Readonly<{}>, {
-    fill: boolean;
     size: string | number;
+    fill: boolean;
     title: string;
     strokeWidth: number;
     registry: IrisIconRegistry;
@@ -2784,8 +2861,8 @@ declare const IrisAlert: vue.DefineComponent<vue.ExtractPropTypes<{
     onClose?: (() => any) | undefined;
     "onUpdate:open"?: ((_value: boolean) => any) | undefined;
 }>, {
-    title: string;
     open: boolean;
+    title: string;
     closable: boolean;
     tone: IrisAlertTone;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
@@ -2842,8 +2919,8 @@ declare const IrisBanner: vue.DefineComponent<vue.ExtractPropTypes<{
     onClose?: (() => any) | undefined;
     "onUpdate:open"?: ((_value: boolean) => any) | undefined;
 }>, {
-    sticky: boolean;
     open: boolean;
+    sticky: boolean;
     closable: boolean;
     tone: IrisBannerTone;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
@@ -2930,12 +3007,12 @@ declare const IrisSlider: vue.DefineComponent<vue.ExtractPropTypes<{
     "onUpdate:modelValue"?: ((_value: number) => any) | undefined;
 }>, {
     label: string;
+    orientation: IrisSliderOrientation;
     disabled: boolean;
     modelValue: number;
     min: number;
     max: number;
     step: number;
-    orientation: IrisSliderOrientation;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 type IrisPaginationSize = 'sm' | 'md';
@@ -3473,9 +3550,9 @@ declare const IrisStepper: vue.DefineComponent<vue.ExtractPropTypes<{
     onChange?: ((_value: number) => any) | undefined;
     "onUpdate:modelValue"?: ((_value: number) => any) | undefined;
 }>, {
+    orientation: IrisStepperOrientation;
     linear: boolean;
     modelValue: number;
-    orientation: IrisStepperOrientation;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -3646,12 +3723,12 @@ declare const IrisToggleGroup: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((_value: string | string[] | null) => any) | undefined;
 }>, {
-    type: IrisToggleGroupType;
     size: "sm" | "md" | "lg";
+    type: IrisToggleGroupType;
+    orientation: IrisToggleGroupOrientation;
     disabled: boolean;
     variant: IrisToggleGroupVariant;
     modelValue: string | string[] | null;
-    orientation: IrisToggleGroupOrientation;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 type IrisKbdSize = 'sm' | 'md';
@@ -3692,8 +3769,8 @@ declare const IrisKbd: vue.DefineComponent<vue.ExtractPropTypes<{
         default: string;
     };
 }>> & Readonly<{}>, {
-    keys: string | string[];
     size: IrisKbdSize;
+    keys: string | string[];
     separator: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
@@ -3767,9 +3844,9 @@ declare const IrisSplitter: vue.DefineComponent<vue.ExtractPropTypes<{
 }>> & Readonly<{
     "onUpdate:modelValue"?: ((_value: number) => any) | undefined;
 }>, {
+    orientation: IrisSplitterOrientation;
     disabled: boolean;
     modelValue: number;
-    orientation: IrisSplitterOrientation;
     minStart: number;
     minEnd: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
@@ -4190,30 +4267,6 @@ type IrisTableColumnWidths = Record<string, number>;
  *   />
  */
 declare const IrisTable: vue.DefineComponent<vue.ExtractPropTypes<{
-    columns: {
-        type: PropType<IrisTableColumn<Record<string, unknown>>[]>;
-        required: true;
-    };
-    data: {
-        type: PropType<Array<Record<string, unknown>>>;
-        required: true;
-    };
-    rowKey: {
-        type: StringConstructor;
-        default: string;
-    };
-    selectable: {
-        type: PropType<"none" | "single" | "multi">;
-        default: string;
-    };
-    selection: {
-        type: PropType<Array<string | number>>;
-        default: undefined;
-    };
-    sort: {
-        type: PropType<IrisTableSortState | null>;
-        default: undefined;
-    };
     striped: {
         type: BooleanConstructor;
         default: boolean;
@@ -4305,28 +4358,6 @@ declare const IrisTable: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(row: Record<string, unknown>) => Array<Record<string, unknown>> | undefined>;
         default: undefined;
     };
-}>, () => VNode<vue.RendererNode, vue.RendererElement, {
-    [key: string]: any;
-}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-    'update:selection': (_value: Array<string | number>) => true;
-    'update:sort': (_value: IrisTableSortState | null) => true;
-    'update:columnWidths': (_value: IrisTableColumnWidths) => true;
-    rowClick: (_row: Record<string, unknown>, _index: number) => true;
-    cellEdit: (_payload: IrisTableCellEditEvent<Record<string, unknown>>) => true;
-    expandedRowsChange: (_keys: Array<string | number>) => true;
-}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
-    columns: {
-        type: PropType<IrisTableColumn<Record<string, unknown>>[]>;
-        required: true;
-    };
-    data: {
-        type: PropType<Array<Record<string, unknown>>>;
-        required: true;
-    };
-    rowKey: {
-        type: StringConstructor;
-        default: string;
-    };
     selectable: {
         type: PropType<"none" | "single" | "multi">;
         default: string;
@@ -4335,10 +4366,40 @@ declare const IrisTable: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<Array<string | number>>;
         default: undefined;
     };
+    defaultSelection: {
+        type: PropType<Array<string | number>>;
+        default: undefined;
+    };
     sort: {
         type: PropType<IrisTableSortState | null>;
         default: undefined;
     };
+    defaultSort: {
+        type: PropType<IrisTableSortState | null>;
+        default: undefined;
+    };
+    columns: {
+        type: PropType<IrisTableColumn<Record<string, unknown>>[]>;
+        required: true;
+    };
+    data: {
+        type: PropType<Array<Record<string, unknown>>>;
+        required: true;
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+    'update:selection': (_value: Array<string | number>) => true;
+    'update:sort': (_value: IrisTableSortState | null) => true;
+    'update:columnWidths': (_value: IrisTableColumnWidths) => true;
+    rowClick: (_row: Record<string, unknown>, _index: number) => true;
+    cellEdit: (_payload: IrisTableCellEditEvent<Record<string, unknown>>) => true;
+    expandedRowsChange: (_keys: Array<string | number>) => true;
+}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
     striped: {
         type: BooleanConstructor;
         default: boolean;
@@ -4430,20 +4491,50 @@ declare const IrisTable: vue.DefineComponent<vue.ExtractPropTypes<{
         type: PropType<(row: Record<string, unknown>) => Array<Record<string, unknown>> | undefined>;
         default: undefined;
     };
+    selectable: {
+        type: PropType<"none" | "single" | "multi">;
+        default: string;
+    };
+    selection: {
+        type: PropType<Array<string | number>>;
+        default: undefined;
+    };
+    defaultSelection: {
+        type: PropType<Array<string | number>>;
+        default: undefined;
+    };
+    sort: {
+        type: PropType<IrisTableSortState | null>;
+        default: undefined;
+    };
+    defaultSort: {
+        type: PropType<IrisTableSortState | null>;
+        default: undefined;
+    };
+    columns: {
+        type: PropType<IrisTableColumn<Record<string, unknown>>[]>;
+        required: true;
+    };
+    data: {
+        type: PropType<Array<Record<string, unknown>>>;
+        required: true;
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
 }>> & Readonly<{
     "onUpdate:selection"?: ((_value: (string | number)[]) => any) | undefined;
+    onExpandedRowsChange?: ((_keys: (string | number)[]) => any) | undefined;
     "onUpdate:sort"?: ((_value: IrisTableSortState | null) => any) | undefined;
+    onCellEdit?: ((_payload: IrisTableCellEditEvent<Record<string, unknown>>) => any) | undefined;
     "onUpdate:columnWidths"?: ((_value: IrisTableColumnWidths) => any) | undefined;
     onRowClick?: ((_row: Record<string, unknown>, _index: number) => any) | undefined;
-    onCellEdit?: ((_payload: IrisTableCellEditEvent<Record<string, unknown>>) => any) | undefined;
-    onExpandedRowsChange?: ((_keys: (string | number)[]) => any) | undefined;
 }>, {
     sort: IrisTableSortState | null;
     error: boolean;
     loading: boolean;
     rowKey: string;
-    selectable: "none" | "single" | "multi";
-    selection: (string | number)[];
     striped: boolean;
     bordered: boolean;
     resizableColumns: boolean;
@@ -4456,7 +4547,13 @@ declare const IrisTable: vue.DefineComponent<vue.ExtractPropTypes<{
     rowExpandable: IrisTableRowExpandable<Record<string, unknown>>;
     defaultExpandedRowKeys: (string | number)[];
     getSubRows: (row: Record<string, unknown>) => Array<Record<string, unknown>> | undefined;
+    selectable: "none" | "single" | "multi";
+    selection: (string | number)[];
+    defaultSelection: (string | number)[];
+    defaultSort: IrisTableSortState | null;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+/** Public input/event surface inferred from the runtime Vue component. */
+type IrisTableProps = InstanceType<typeof IrisTable>['$props'];
 
 /**
  * Serialize a list of rows as a CSV string. Columns determine the order;
@@ -4580,9 +4677,9 @@ declare const IrisTabs: vue.DefineComponent<vue.ExtractPropTypes<{
     "onUpdate:value"?: ((_value: string) => any) | undefined;
 }>, {
     value: string;
+    orientation: IrisTabsOrientation;
     disabled: boolean;
     defaultValue: string;
-    orientation: IrisTabsOrientation;
     lazy: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
@@ -7285,8 +7382,8 @@ declare const IrisToolbar: vue.DefineComponent<vue.ExtractPropTypes<{
         default: undefined;
     };
 }>> & Readonly<{}>, {
-    ariaLabel: string;
     orientation: IrisToolbarOrientation;
+    ariaLabel: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
 /**
@@ -7851,8 +7948,8 @@ declare const IrisCommandPalette: vue.DefineComponent<vue.ExtractPropTypes<{
     onSelect?: ((_item: IrisCommandItem) => any) | undefined;
     "onUpdate:open"?: ((_value: boolean) => any) | undefined;
 }>, {
-    filter: (query: string, item: IrisCommandItem) => number | null;
     open: boolean;
+    filter: (query: string, item: IrisCommandItem) => number | null;
     placeholder: string;
     emptyText: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
@@ -8084,4 +8181,4 @@ declare const IrisDateRangePicker: vue.DefineComponent<vue.ExtractPropTypes<{
     weekStartsOn: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
 
-export { type AccordionContext, AccordionContextKey, type DialogContext, DialogContextKey, type DragState, type DrawerContext, DrawerContextKey, type DropdownContext, DropdownContextKey, IrisAccordion, IrisAccordionItem, type IrisAccordionValue, IrisAffix, IrisAlert, type IrisAlertTone, IrisAnchor, type IrisAnchorItem, IrisAspectRatio, IrisAvatar, type IrisAvatarShape, type IrisAvatarSize, IrisBackTop, IrisBadge, type IrisBadgeSize, type IrisBadgeTone, type IrisBadgeVariant, IrisBanner, type IrisBannerTone, IrisBreadcrumb, IrisBreadcrumbItem, IrisButton, type IrisButtonProps, type IrisButtonSize, type IrisButtonType, type IrisButtonVariant, IrisCalendar, IrisCard, type IrisCardPadding, type IrisCardVariant, IrisCarousel, IrisCascader, type IrisCascaderNode, type IrisCascaderSize, IrisCheckbox, type IrisCheckboxSize, type IrisCheckboxValue, IrisChip, type IrisChipSize, type IrisChipTone, type IrisChipVariant, IrisColorPicker, IrisCombobox, type IrisComboboxOption, type IrisComboboxSize, type IrisCommandItem, IrisCommandPalette, IrisCopyButton, type IrisCopyButtonSize, IrisCountdown, type IrisCountdownSize, IrisDatePicker, type IrisDateRange, IrisDateRangePicker, IrisDescriptions, type IrisDescriptionsItem, type IrisDescriptionsLayout, IrisDialog, IrisDialogClose, IrisDialogContent, IrisDialogDescription, IrisDialogTitle, IrisDialogTrigger, IrisDivider, type IrisDividerOrientation, type IrisDividerSpacing, IrisDragger, type IrisDraggerPosition, IrisDrawer, IrisDrawerClose, IrisDrawerContent, type IrisDrawerSide, IrisDrawerTitle, IrisDrawerTrigger, IrisDropdown, IrisDropdownItem, IrisDropdownMenu, IrisDropdownSeparator, IrisDropdownTrigger, IrisEmptyState, IrisFieldset, IrisFileUpload, type IrisFileUploadFile, IrisFloatButton, type IrisFloatButtonAction, type IrisFloatButtonShape, IrisFormField, IrisGauge, type IrisGaugeStatus, IrisIcon, IrisImage, IrisInput, type IrisInputSize, type IrisInputType, IrisKbd, type IrisKbdSize, IrisList, type IrisListItem, IrisMarquee, type IrisMarqueeDirection, IrisMasonry, type IrisMentionOption, IrisMentions, IrisMenu, IrisMenuContent, IrisMenuItem, IrisMenuSeparator, IrisMenuSub, IrisMenuTrigger, IrisNumberInput, type IrisNumberInputSize, IrisOtpInput, type IrisOtpInputSize, type IrisOtpInputType, IrisPagination, type IrisPaginationSize, IrisPasswordInput, type IrisPasswordInputSize, IrisPopover, IrisPopoverContent, IrisPopoverTrigger, IrisProgress, IrisProgressCircle, type IrisProgressCircleStatus, type IrisProgressSize, type IrisProgressTone, IrisRadio, IrisRadioGroup, type IrisRadioSize, IrisRangeSlider, type IrisRangeSliderValue, IrisRating, type IrisRatingSize, IrisResizer, type IrisResizerHandle, type IrisResizerSize, IrisResult, type IrisResultStatus, IrisRibbon, type IrisRibbonPlacement, IrisScrollArea, type IrisScrollAreaAxis, IrisSegmented, type IrisSegmentedOption, type IrisSegmentedSize, IrisSelect, type IrisSelectSize, IrisSkeleton, type IrisSkeletonShape, IrisSlider, type IrisSliderOrientation, IrisSlot, IrisSpinner, type IrisSpinnerSize, IrisSplitButton, type IrisSplitButtonAction, type IrisSplitButtonSize, type IrisSplitButtonVariant, IrisSplitter, type IrisSplitterOrientation, IrisStatistic, type IrisStatisticSize, type IrisStatisticTrend, type IrisStepStatus, IrisStepper, type IrisStepperOrientation, IrisStepperStep, IrisSwitch, type IrisSwitchSize, IrisTable, type IrisTableCellEditEvent, type IrisTableColumn, type IrisTableColumnWidths, type IrisTableEditor, type IrisTableSortDirection, type IrisTableSortState, type IrisTableVirtualOptions, IrisTabs, IrisTabsContent, IrisTabsList, type IrisTabsOrientation, IrisTabsTrigger, IrisTagInput, IrisTextarea, type IrisTextareaSize, IrisTimePicker, type IrisTimePickerFormat, type IrisTimeValue, IrisTimeline, type IrisTimelineItem, type IrisTimelineVariant, type IrisToast, type IrisToastInput, type IrisToastPosition, type IrisToastVariant, IrisToastViewport, IrisToggleGroup, IrisToggleGroupItem, type IrisToggleGroupOrientation, type IrisToggleGroupType, type IrisToggleGroupVariant, IrisToolbar, type IrisToolbarOrientation, IrisTooltip, IrisTour, type IrisTourStep, IrisTransfer, type IrisTransferItem, IrisTree, type IrisTreeNode, IrisTreeSelect, type IrisTreeSelectNode, type IrisTreeSelectSize, type IrisTreeSelectionMode, IrisVirtualScroll, type IrisVirtualScrollAlign, type IrisVirtualScrollExposed, IrisVisuallyHidden, IrisWatermark, type MenuContext, MenuContextKey, type PopoverContext, PopoverContextKey, type StepperContext, StepperContextKey, type TabsContext, TabsContextKey, type ToggleGroupContext, ToggleGroupContextKey, type UseDragOptions, type UseToastReturn, __PROGRESS_STYLE_ID, __SKELETON_STYLE_ID, __SPINNER_STYLE_ID, __resetProgressStyles, __resetSkeletonStyles, __resetSpinnerStyles, clearToasts, composeRefs, defaultFilter, dismissToast, downloadCsv, downloadExcel, exportCsv, exportExcel, findFirstElement, formatBytes, formatRemaining, getToasts, mergeSlotProps, pushToast, subscribeToasts, useDrag, useStore, useStoreSelector, useToast };
+export { type AccordionContext, AccordionContextKey, type DialogContext, DialogContextKey, type DragState, type DrawerContext, DrawerContextKey, type DropdownContext, DropdownContextKey, IrisAccordion, IrisAccordionItem, type IrisAccordionValue, IrisAffix, IrisAlert, type IrisAlertTone, IrisAnchor, type IrisAnchorItem, IrisAspectRatio, IrisAvatar, type IrisAvatarShape, type IrisAvatarSize, IrisBackTop, IrisBadge, type IrisBadgeSize, type IrisBadgeTone, type IrisBadgeVariant, IrisBanner, type IrisBannerTone, IrisBreadcrumb, IrisBreadcrumbItem, IrisButton, type IrisButtonProps, type IrisButtonSize, type IrisButtonType, type IrisButtonVariant, IrisCalendar, IrisCard, type IrisCardPadding, type IrisCardVariant, IrisCarousel, IrisCascader, type IrisCascaderNode, type IrisCascaderSize, IrisCheckbox, type IrisCheckboxSize, type IrisCheckboxValue, IrisChip, type IrisChipSize, type IrisChipTone, type IrisChipVariant, IrisColorPicker, IrisCombobox, type IrisComboboxOption, type IrisComboboxSize, type IrisCommandItem, IrisCommandPalette, IrisCopyButton, type IrisCopyButtonSize, IrisCountdown, type IrisCountdownSize, IrisDatePicker, type IrisDateRange, IrisDateRangePicker, IrisDescriptions, type IrisDescriptionsItem, type IrisDescriptionsLayout, IrisDialog, IrisDialogClose, IrisDialogContent, IrisDialogDescription, IrisDialogTitle, IrisDialogTrigger, IrisDivider, type IrisDividerOrientation, type IrisDividerSpacing, IrisDragger, type IrisDraggerPosition, IrisDrawer, IrisDrawerClose, IrisDrawerContent, type IrisDrawerSide, IrisDrawerTitle, IrisDrawerTrigger, IrisDropdown, IrisDropdownItem, IrisDropdownMenu, IrisDropdownSeparator, IrisDropdownTrigger, IrisEmptyState, IrisFieldset, IrisFileUpload, type IrisFileUploadFile, IrisFloatButton, type IrisFloatButtonAction, type IrisFloatButtonShape, IrisFormField, IrisGauge, type IrisGaugeStatus, IrisIcon, IrisImage, IrisInput, type IrisInputSize, type IrisInputType, IrisKbd, type IrisKbdSize, IrisList, type IrisListItem, IrisMarquee, type IrisMarqueeDirection, IrisMasonry, type IrisMentionOption, IrisMentions, IrisMenu, IrisMenuContent, IrisMenuItem, IrisMenuSeparator, IrisMenuSub, IrisMenuTrigger, IrisNumberInput, type IrisNumberInputSize, IrisOtpInput, type IrisOtpInputSize, type IrisOtpInputType, IrisPagination, type IrisPaginationSize, IrisPasswordInput, type IrisPasswordInputSize, IrisPopover, IrisPopoverContent, IrisPopoverTrigger, IrisProgress, IrisProgressCircle, type IrisProgressCircleStatus, type IrisProgressSize, type IrisProgressTone, IrisRadio, IrisRadioGroup, type IrisRadioSize, IrisRangeSlider, type IrisRangeSliderValue, IrisRating, type IrisRatingSize, IrisResizer, type IrisResizerHandle, type IrisResizerSize, IrisResult, type IrisResultStatus, IrisRibbon, type IrisRibbonPlacement, IrisScrollArea, type IrisScrollAreaAxis, IrisSegmented, type IrisSegmentedOption, type IrisSegmentedSize, IrisSelect, type IrisListItem as IrisSelectItem, type IrisSelectProps, type IrisSelectSize, IrisSkeleton, type IrisSkeletonShape, IrisSlider, type IrisSliderOrientation, IrisSlot, IrisSpinner, type IrisSpinnerSize, IrisSplitButton, type IrisSplitButtonAction, type IrisSplitButtonSize, type IrisSplitButtonVariant, IrisSplitter, type IrisSplitterOrientation, IrisStatistic, type IrisStatisticSize, type IrisStatisticTrend, type IrisStepStatus, IrisStepper, type IrisStepperOrientation, IrisStepperStep, IrisSwitch, type IrisSwitchSize, IrisTable, type IrisTableAggregateOp, type IrisTableCellEditEvent, type IrisTableColumn, type IrisTableColumnWidths, type IrisTableEditor, type IrisTableProps, type IrisTableRenderDetail, type IrisTableRowExpandable, type IrisTableSortDirection, type IrisTableSortState, type IrisTableVirtualOptions, IrisTabs, IrisTabsContent, IrisTabsList, type IrisTabsOrientation, IrisTabsTrigger, IrisTagInput, IrisTextarea, type IrisTextareaSize, IrisTimePicker, type IrisTimePickerFormat, type IrisTimeValue, IrisTimeline, type IrisTimelineItem, type IrisTimelineVariant, type IrisToast, type IrisToastInput, type IrisToastPosition, type IrisToastVariant, IrisToastViewport, IrisToggleGroup, IrisToggleGroupItem, type IrisToggleGroupOrientation, type IrisToggleGroupType, type IrisToggleGroupVariant, IrisToolbar, type IrisToolbarOrientation, IrisTooltip, IrisTour, type IrisTourStep, IrisTransfer, type IrisTransferItem, IrisTree, type IrisTreeNode, IrisTreeSelect, type IrisTreeSelectNode, type IrisTreeSelectSize, type IrisTreeSelectionMode, IrisVirtualScroll, type IrisVirtualScrollAlign, type IrisVirtualScrollExposed, IrisVisuallyHidden, IrisWatermark, type MenuContext, MenuContextKey, type PopoverContext, PopoverContextKey, type StepperContext, StepperContextKey, type TabsContext, TabsContextKey, type ToggleGroupContext, ToggleGroupContextKey, type UseDragOptions, type UseToastReturn, __PROGRESS_STYLE_ID, __SKELETON_STYLE_ID, __SPINNER_STYLE_ID, __resetProgressStyles, __resetSkeletonStyles, __resetSpinnerStyles, clearToasts, composeRefs, defaultFilter, dismissToast, downloadCsv, downloadExcel, exportCsv, exportExcel, findFirstElement, formatBytes, formatRemaining, getToasts, mergeSlotProps, pushToast, subscribeToasts, useDisposableScope, useDrag, useReconnectingSource, useResilientFetcher, useStore, useStoreSelector, useToast };