@infotrust/ui 0.0.0-stage → 0.30.0

package/dist/components/forms/ItSegmentedControl.vue.d.ts

@@ -0,0 +1,25 @@
+export interface ItSegmentOption<V> {
+    value: V;
+    label: string;
+    disabled?: boolean;
+}
+declare const _default: <T extends string | number>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly "onUpdate:modelValue"?: ((value: T) => any) | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:modelValue"> & {
+        modelValue: T;
+        options: ItSegmentOption<T>[];
+        label: string;
+        size?: "sm" | "md";
+    } & Partial<{}>> & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {};
+    emit: (evt: "update:modelValue", value: T) => void;
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/forms/ItSelect.vue.d.ts

@@ -0,0 +1,50 @@
+import { type ItOptionSource } from './option-source';
+declare const _default: <V>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly "onUpdate:modelValue"?: ((value: V | null) => any) | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:modelValue"> & {
+        modelValue?: V | null;
+        /** The options. With `source`, leave it out. */
+        options?: readonly unknown[];
+        /**
+         * Load the options from an API, a page at a time. The list asks for the first page when it
+         * opens; its search asks the API (debounced) and never filters only the loaded rows.
+         */
+        source?: ItOptionSource;
+        /** Options per page with `source`. */
+        pageSize?: number;
+        /** Milliseconds after typing before a `source` search runs. */
+        searchDebounce?: number;
+        /** The search box's accessible name with `source`. */
+        searchLabel?: string;
+        /** A value's label before any page has listed it (a value set by the app). */
+        valueLabel?: (value: V) => string | undefined;
+        optionLabel?: string;
+        optionValue?: string;
+        optionDisabled?: string;
+        placeholder?: string;
+        size?: "sm" | "md";
+        disabled?: boolean;
+        invalid?: boolean;
+        id?: string;
+        describedBy?: string;
+        /** Show a clear button when a value is set. For optional fields. */
+        clearable?: boolean;
+        clearLabel?: string;
+        /** Search box in the panel. Default: on when there are more than 8 options. */
+        filter?: boolean;
+        pt?: Record<string, unknown>;
+    } & Partial<{}>> & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {
+        [x: string]: ((props: any) => any) | undefined;
+    };
+    emit: (evt: "update:modelValue", value: V | null) => void;
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/forms/ItSwitch.vue.d.ts

@@ -0,0 +1,31 @@
+type __VLS_Props = {
+    modelValue?: boolean;
+    label: string;
+    description?: string;
+    /**
+     * Accessible name in place of the visible label, for a row of switches
+     * whose visible label is a state word ("On"): "Missing consent rule
+     * enabled". Keep the visible word in it where it reads naturally.
+     */
+    ariaLabel?: string;
+    /** Id(s) of the element(s) that name the switch (the row's name cell), in place of the visible label. */
+    labelledBy?: string;
+    size?: 'sm' | 'md';
+    disabled?: boolean;
+    invalid?: boolean;
+    id?: string;
+    describedBy?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {
+    invalid: boolean;
+    disabled: boolean;
+    size: "sm" | "md";
+    modelValue: boolean;
+    ariaLabel: string;
+    labelledBy: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/forms/ItTabs.vue.d.ts

@@ -0,0 +1,27 @@
+export interface ItTabOption<V> {
+    value: V;
+    label: string;
+    count?: number | null;
+    disabled?: boolean;
+}
+declare const _default: <T extends string | number>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly "onUpdate:modelValue"?: ((value: T) => any) | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onUpdate:modelValue"> & {
+        modelValue: T;
+        options: ItTabOption<T>[];
+        label: string;
+        /** Prefix for tab/panel ids. */
+        idPrefix?: string;
+    } & Partial<{}>> & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {};
+    emit: (evt: "update:modelValue", value: T) => void;
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/forms/OptionSourceSlot.vue.d.ts

@@ -0,0 +1,13 @@
+import type { useOptionSource } from './option-source';
+type __VLS_Props = {
+    part: 'search' | 'more' | 'empty';
+    state: ReturnType<typeof useOptionSource>;
+    searchLabel: string;
+    searchDebounce: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    list: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onList?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/forms/choice.d.ts

@@ -0,0 +1,24 @@
+import type { Component } from 'vue';
+/**
+ * A v-for key for an option value: the value itself when it is a primitive,
+ * the position when it is an object (every object would stringify to the
+ * same "[object Object]").
+ */
+export declare function choiceKey(value: unknown, index: number): string | number;
+/** One option in ItCheckboxGroup or ItRadioGroup. */
+export interface ItChoiceOption<V> {
+    value: V;
+    label: string;
+    /** One line under the label. It is linked to the input as its description. */
+    description?: string;
+    disabled?: boolean;
+}
+/** One card in ItOptionCardGroup. */
+export interface ItOptionCardOption<V> extends ItChoiceOption<V> {
+    /** Platform registry key. Takes precedence over icon. */
+    platform?: string;
+    /** A Lucide icon component, before the label. */
+    icon?: Component;
+    /** Why the option is unavailable ("Coming soon", "Needs an admin"). Shown while disabled. */
+    disabledReason?: string;
+}

package/dist/components/forms/code-editor.d.ts

@@ -0,0 +1,17 @@
+/** One completion replaces the word or path immediately before the caret. */
+export interface ItCodeCompletion {
+    label: string;
+    insertText: string;
+    detail?: string;
+}
+/** One-based source line. The application owns parsing and validation. */
+export interface ItCodeDiagnostic {
+    line: number;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+}
+export interface ItCodeCompletionContext {
+    value: string;
+    position: number;
+    query: string;
+}

package/dist/components/forms/field-context.d.ts

@@ -0,0 +1,39 @@
+import { type ComputedRef, type InjectionKey } from 'vue';
+export interface ItFieldState {
+    /** The id the field's <label for> points at. */
+    id: string;
+    /** The id of the label element, for controls a <label for> cannot name (combobox spans, fieldsets). */
+    labelId: string;
+    invalid: boolean;
+    describedBy: string | undefined;
+}
+export interface ItFieldContext {
+    state: ComputedRef<ItFieldState>;
+    /** A group control (checkbox or radio group) names itself with aria-labelledby, so the label drops its `for`. */
+    registerGroup(): void;
+}
+export declare const IT_FORM_FIELD: InjectionKey<ItFieldContext | null>;
+/** Props every It* field wrapper accepts; they match the ItFormField slot scope. */
+export interface ItFieldControlProps {
+    id?: string;
+    invalid?: boolean;
+    describedBy?: string;
+}
+/** Search box appears in Select and MultiSelect panels above this many options. */
+export declare const IT_SEARCH_THRESHOLD = 8;
+export declare function useItFieldControl(props: ItFieldControlProps, options?: {
+    group?: boolean;
+}): {
+    id: ComputedRef<string>;
+    labelId: ComputedRef<string | undefined>;
+    invalid: ComputedRef<boolean>;
+    describedBy: ComputedRef<string | undefined>;
+};
+type PtValue = Record<string, unknown> | ((...args: never[]) => unknown) | undefined;
+/**
+ * Merge the wrapper's pass-through attributes with the app's `pt`. Sections
+ * that are plain objects merge (the app wins per key); a function section
+ * from the app replaces the wrapper's.
+ */
+export declare function mergePt(base: Record<string, PtValue>, user: Record<string, unknown> | undefined): Record<string, unknown>;
+export {};

package/dist/components/forms/file-drop.d.ts

@@ -0,0 +1,19 @@
+/** A file that was not taken, and why, in a sentence that says what to choose instead. */
+export interface ItFileRejection {
+    file: File;
+    reason: 'type' | 'size' | 'count';
+    message: string;
+}
+/**
+ * The file types an `accept` string names, for a sentence: ".csv,text/csv" →
+ * "CSV"; ".csv,.txt" → "CSV or TXT"; "image/*" → "image". Empty when it names
+ * none.
+ */
+export declare function itFileAcceptText(accept: string | undefined): string;
+/** Whether a file matches an `accept` string, as the browser's picker does: by extension, by MIME type, or by `type/*`. */
+export declare function itFileAccepted(file: File, accept: string | undefined): boolean;
+/** Why a file cannot be taken (type, then size), or null when it can. */
+export declare function itFileRejection(file: File, rules: {
+    accept?: string;
+    maxSize?: number;
+}): ItFileRejection | null;

package/dist/components/forms/form-errors.d.ts

@@ -0,0 +1,7 @@
+/** An invalid field: ItFormField marks itself, and a raw control marks itself with aria-invalid. */
+export declare const IT_INVALID_FIELD = ".it-field--invalid, [aria-invalid=\"true\"]";
+/**
+ * Focuses the first invalid field in `root` (a form). Call it after a failed
+ * submit, once the errors show. Returns whether a field took focus.
+ */
+export declare function itFocusFirstError(root: ParentNode | null | undefined): Promise<boolean>;

package/dist/components/forms/form-rows.d.ts

@@ -0,0 +1,8 @@
+export interface ItFormRowsColumn {
+    key: string;
+    label: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'full';
+    required?: boolean;
+}
+/** Errors are keyed by stable row key, then column key. */
+export type ItFormRowsErrors = Record<string, Record<string, string | undefined> | undefined>;

package/dist/components/forms/option-source.d.ts

@@ -0,0 +1,39 @@
+/** One request for options. Offset APIs read `offset`; cursor APIs read `cursor` (the last page's). */
+export interface ItOptionQuery {
+    search: string;
+    offset: number;
+    cursor: unknown;
+    limit: number;
+    /** Aborted when a newer search replaces this one. */
+    signal: AbortSignal;
+}
+/** One page of options. More pages exist when `hasMore` is true, or (unset) when a `cursor` comes back. */
+export interface ItOptionPage<T = unknown> {
+    options: readonly T[];
+    hasMore?: boolean;
+    cursor?: unknown;
+    /** Every match for the search, when the API knows: shown as "remaining". */
+    total?: number | null;
+}
+export type ItOptionSource<T = unknown> = (query: ItOptionQuery) => Promise<ItOptionPage<T>>;
+export declare const IT_OPTION_PAGE_SIZE = 25;
+export declare function useOptionSource(options: {
+    source: () => ItOptionSource | undefined;
+    pageSize: () => number;
+    valueOf: (option: unknown) => unknown;
+}): {
+    search: import("vue").Ref<string, string>;
+    options: import("vue").ShallowRef<readonly unknown[], readonly unknown[]>;
+    loading: import("vue").Ref<boolean, boolean>;
+    loadingMore: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<string | null, string | null>;
+    hasMore: import("vue").Ref<boolean, boolean>;
+    total: import("vue").Ref<number | null, number | null>;
+    known: import("vue").ShallowRef<Map<unknown, unknown>, Map<unknown, unknown>>;
+    open: () => void;
+    close: () => void;
+    setSearch: (value: string) => void;
+    more: () => undefined;
+    retry: () => undefined;
+    moreLabel: import("vue").ComputedRef<string>;
+};

package/dist/components/forms/virtual-options.d.ts

@@ -0,0 +1,12 @@
+/** Lists longer than this draw as they scroll. */
+export declare const IT_VIRTUAL_OPTIONS_FROM = 200;
+export declare function useVirtualOptions(options: {
+    count: () => number;
+    plain: () => boolean;
+    size: () => 'sm' | 'md';
+}): {
+    scrollerOptions: import("vue").ComputedRef<{
+        itemSize: number;
+    } | undefined>;
+    measure: (overlay: unknown) => void;
+};

package/dist/components/layout/ItBreadcrumb.vue.d.ts

@@ -0,0 +1,12 @@
+import { type ItRouteLocation } from '../../utils/router';
+export interface ItBreadcrumbItem {
+    label: string;
+    /** Router location. Rendered with RouterLink when vue-router is installed. */
+    to?: ItRouteLocation;
+    href?: string;
+}
+type __VLS_Props = {
+    items: ItBreadcrumbItem[];
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/layout/ItDetailSection.vue.d.ts

@@ -0,0 +1,21 @@
+type __VLS_Props = {
+    title: string;
+    description?: string;
+    /** h3 follows the ItDrawer h2; use h2 on a detail page. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+};
+type __VLS_Slots = {
+    default?: () => unknown;
+    /** Actions for this section. Drawer-wide actions belong to ItDrawer. */
+    actions?: () => unknown;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    headingLevel: 2 | 3 | 4 | 5 | 6;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/layout/ItPage.vue.d.ts

@@ -0,0 +1,44 @@
+type __VLS_Props = {
+    title?: string;
+    /** Use a lower heading level when demonstrating a page inside another page. */
+    headingLevel?: 1 | 2 | 3;
+    /** One sentence explaining the page, before live metadata. */
+    description?: string;
+    /** `data` = fluid to 1440px (lists, dashboards); `form` = 1040px (forms, settings); `reading` = 760px (docs, long text); `full` = no cap. */
+    width?: 'data' | 'form' | 'reading' | 'full';
+    /** A studio page: fits the window with no page scroll; the last block takes the rest of the height. */
+    fill?: boolean;
+    /**
+     * The page names itself in its breadcrumb (the trail's last item is the
+     * title, kept current by the app) on one line with the actions, and the
+     * title row goes. For a studio, so the work area gets the height. The
+     * title stays the page's heading for assistive tech.
+     */
+    titleInBreadcrumb?: boolean;
+};
+type __VLS_Slots = {
+    /** Breadcrumb trail above the title. Only for nested pages. */
+    breadcrumb?: () => unknown;
+    /** Replaces the plain-text title (e.g. title + inline status badge). */
+    title?: () => unknown;
+    /** One line under the title: status dot, freshness, counts. Each child is a flex item, so a sentence (text with `<code>`) goes in one `<span>`. */
+    meta?: () => unknown;
+    /** Right-aligned: secondary actions first, the one primary action last. */
+    actions?: () => unknown;
+    /** Blocking state (scan failed, permission missing) — renders directly under the header. */
+    alert?: () => unknown;
+    default?: () => unknown;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    width: "data" | "form" | "reading" | "full";
+    fill: boolean;
+    headingLevel: 1 | 2 | 3;
+    titleInBreadcrumb: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/layout/ItPanel.vue.d.ts

@@ -0,0 +1,47 @@
+type __VLS_Props = {
+    title?: string;
+    description?: string;
+    /** `md` pads the body; `none` for tables and lists that run edge to edge. */
+    padding?: 'md' | 'none';
+    /** Heading level for the title (h2 on pages, h3 inside drawers). */
+    headingLevel?: 2 | 3;
+    /** `visible` lets in-page floating content (expanding KPI cards) extend past the panel edge. */
+    overflow?: 'clip' | 'visible';
+    /** Takes the rest of its column's height (the work area of an `ItPage fill`); a body taller than that scrolls inside the panel. */
+    fill?: boolean;
+    /**
+     * The body is the tab panel of the ItTabs in #tabs: role="tabpanel",
+     * the `${idPrefix}-panel-${value}` id the selected tab controls, and
+     * labelled by that tab. ItTabs needs no `id-prefix` here (it makes
+     * one). Leave it off when the app wires its own tab panel.
+     */
+    tabPanel?: boolean;
+};
+type __VLS_Slots = {
+    /** Replaces the whole header row. */
+    header?: () => unknown;
+    /** Right side of the header row. */
+    actions?: () => unknown;
+    /** Views of the panel's object (`ItTabs`), between the header and the toolbar. The panel insets them so the first label lines up with the toolbar. */
+    tabs?: () => unknown;
+    /** Full-width row under the header or tabs (e.g. ItDataToolbar). */
+    toolbar?: () => unknown;
+    /** Inset feedback between the toolbar and body, including with padding="none". */
+    message?: () => unknown;
+    default?: () => unknown;
+    footer?: () => unknown;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    fill: boolean;
+    overflow: "clip" | "visible";
+    headingLevel: 2 | 3;
+    padding: "md" | "none";
+    tabPanel: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/layout/ItSectionNav.vue.d.ts

@@ -0,0 +1,43 @@
+import type { ItSectionNavGroup, ItSectionNavItem } from './section-nav';
+type __VLS_Props = {
+    groups: readonly ItSectionNavGroup[];
+    label?: string;
+    mode?: 'pages' | 'toc';
+    /** Scope heading lookup and observation to this document. */
+    content?: HTMLElement | null;
+    loading?: boolean;
+    error?: boolean;
+    emptyText?: string;
+};
+type __VLS_PublicProps = __VLS_Props & {
+    'active'?: string;
+};
+declare var __VLS_15: {}, __VLS_38: {};
+type __VLS_Slots = {} & {
+    start?: (props: typeof __VLS_15) => any;
+} & {
+    end?: (props: typeof __VLS_38) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (item: ItSectionNavItem) => any;
+    retry: () => any;
+    "update:active": (value: string | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onSelect?: ((item: ItSectionNavItem) => any) | undefined;
+    onRetry?: (() => any) | undefined;
+    "onUpdate:active"?: ((value: string | undefined) => any) | undefined;
+}>, {
+    label: string;
+    error: boolean;
+    content: HTMLElement | null;
+    loading: boolean;
+    mode: "pages" | "toc";
+    emptyText: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/layout/ItWizard.vue.d.ts

@@ -0,0 +1,57 @@
+import type { ItWizardStep } from './wizard';
+type __VLS_Props = {
+    steps: readonly ItWizardStep[];
+    /** The current step's key (v-model:step). Default: the first step. */
+    step?: string;
+    /** The task: the modal title, and the stepper's name ("New rule"). */
+    title: string;
+    /** The last step's primary action: "Create rule", "Connect", "Import 24 properties". */
+    finishLabel: string;
+    /** Whether Next (or the finish action) is enabled on the current step. */
+    canAdvance?: boolean;
+    /**
+     * Unsaved input: closing asks first. In a modal, leave it unset and the
+     * modal asks once the person has typed in a text field; in a page, set it.
+     */
+    dirty?: boolean;
+    /** Finishing: the finish action spins; Back, Cancel, and closing are locked. */
+    busy?: boolean;
+    as?: 'modal' | 'page';
+    /** Modal only. */
+    visible?: boolean;
+    /** Modal width and height (layout.modal-width-* × layout.wizard-height-*). */
+    size?: 'md' | 'lg' | 'xl';
+};
+type __VLS_Slots = {
+    /** One region per step, named by its key. */
+    [key: string]: ((scope: {
+        step: ItWizardStep;
+        index: number;
+    }) => unknown) | undefined;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    cancel: () => any;
+    "update:visible": (value: boolean) => any;
+    finish: () => any;
+    "update:step": (key: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+    onFinish?: (() => any) | undefined;
+    "onUpdate:step"?: ((key: string) => any) | undefined;
+}>, {
+    size: "md" | "lg" | "xl";
+    visible: boolean;
+    busy: boolean;
+    dirty: boolean;
+    step: string;
+    as: "modal" | "page";
+    canAdvance: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/layout/ItWizardSteps.vue.d.ts

@@ -0,0 +1,15 @@
+import type { ItWizardStep } from './wizard';
+type __VLS_Props = {
+    steps: readonly ItWizardStep[];
+    current: number;
+    /** Names the list: "New rule steps". */
+    label: string;
+    /** Done steps stay plain text (while finishing). */
+    locked?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (index: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((index: number) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/layout/SectionNavLinks.vue.d.ts

@@ -0,0 +1,15 @@
+import type { ItSectionNavItem } from './section-nav';
+type __VLS_Props = {
+    items: readonly ItSectionNavItem[];
+    active?: string;
+    mode: 'pages' | 'toc';
+    depth?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (event: MouseEvent, item: ItSectionNavItem) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((event: MouseEvent, item: ItSectionNavItem) => any) | undefined;
+}>, {
+    depth: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/layout/panel.d.ts

@@ -0,0 +1,18 @@
+import type { InjectionKey } from 'vue';
+/** What the ItTabs in an ItPanel's #tabs region tells the panel: its id prefix and the selected tab. */
+export interface ItPanelTabState {
+    prefix: string;
+    value: string | number;
+}
+/**
+ * Provided only to an ItPanel's #tabs region. When the panel has `tabPanel`,
+ * the ItTabs there reports its ids and selection, and the panel body becomes
+ * the tab panel: role="tabpanel", `${prefix}-panel-${value}`, labelled by the
+ * selected tab. ItTabs elsewhere never sees it.
+ */
+export interface ItPanelTabsContext {
+    /** Whether the panel wires its body as the tab panel. */
+    wanted(): boolean;
+    report(state: ItPanelTabState | null): void;
+}
+export declare const IT_PANEL_TABS: InjectionKey<ItPanelTabsContext>;

package/dist/components/layout/section-nav.d.ts

@@ -0,0 +1,17 @@
+import type { Component } from 'vue';
+import type { ItRouteLocation } from '../../utils/router';
+export interface ItSectionNavItem {
+    key: string;
+    label: string;
+    href?: string;
+    to?: ItRouteLocation;
+    /** A Lucide icon before the label, for a top-level page such as a docs home. */
+    icon?: Component;
+    /** Heading id for mode="toc". The application gives its headings these ids. */
+    headingId?: string;
+    children?: readonly ItSectionNavItem[];
+}
+export interface ItSectionNavGroup {
+    label?: string;
+    items: readonly ItSectionNavItem[];
+}

package/dist/components/layout/wizard.d.ts

@@ -0,0 +1,13 @@
+/** One step in ItWizard. */
+export interface ItWizardStep {
+    /** Names the step's slot in ItWizard: `<template #configure>`. */
+    key: string;
+    /** Short noun or verb: "Template", "Configure", "Review". */
+    label: string;
+    /**
+     * What was chosen on this step, in a few words ("Google", "5 properties").
+     * Shown under the step's name in the stepper once the step is done, so
+     * earlier choices stay in view without a summary box.
+     */
+    summary?: string;
+}