@synopackageland/ui 0.4.0 → 0.5.3

package/README.md

@@ -349,6 +349,23 @@ DSM-style application building blocks:
 - AppLayout / AppSidebar / AppToolbar / AppActionBar
 - PageHeader / SectionTabs
 
+`Tabs` and `SectionTabs` move a raised selection notch in 120ms. Selected labels
+are blue; main labels are bold 14px and section labels bold 13px. `Tabs` fades its
+new panel in over 160ms, with immediate selection and keyboard response.
+`SectionTabs` can also render content using named `panel-${value}` slots:
+
+```vue
+<SectionTabs v-model="section" :items="sections">
+  <template #panel-general>General settings</template>
+  <template #panel-advanced>Advanced settings</template>
+</SectionTabs>
+```
+
+Navigation-only `SectionTabs` usage still works. For content managed separately
+by the caller, add `class="ui-tab-panel"` to a panel keyed by the selected value
+to use the same short fade. These effects and the loading ring respect the
+system's reduced-motion preference.
+
 `FilePicker` owns file selection/validation/drop-zone UI only; applications remain responsible for upload transport.
 
 ### DataGrid
@@ -372,6 +389,10 @@ DSM-style application building blocks:
 - **Footer bar.** `footer` shows the DSM bar with the item count; `refreshable` adds the refresh button (`@refresh`, `refreshing` spins it). Without `footer` it appears only when there is more than one page or a `#footer` slot.
 - **Localisation.** Every built-in string goes through `labels`: `empty`, `items(count)`, `page(page, count)`, `previous`, `next`, `refresh`, `selectAll`, `selectRow(key)`, `resizeColumn(label)`. `emptyText` still works.
 - **Loading.** `loading` masks the table with a centred indicator; `loading-text` adds a message.
+- **Footer layout.** The footer has top and bottom divider lines and a separator
+  before Refresh. In a flex column with a bounded height, the grid fills the
+  remaining space and its rows scroll above the footer. Use `class="flex-none"`
+  for a grid that should retain its content height.
 - Virtual scrolling is not provided; page long lists (`page-size`).
 
 ### Loading
@@ -402,6 +423,7 @@ pnpm dev         # rebuild dist when library source changes
 pnpm check       # lint, typecheck, tests, and production build
 pnpm story:build # build the component workbench
 pnpm check:host  # after pnpm build: DSM host simulation screenshots (Chrome)
+pnpm check:switch # after pnpm build: Switch knob geometry and click toggling (Chrome)
 ```
 
 `pnpm check:host` serves `tests/dsm-host` and screenshots each overlay scene in
@@ -411,6 +433,11 @@ stylesheet written for these tests that reproduces DSM's known element rules.
 The images must be identical, and must match `theme.css` on a plain page. They
 are left in `.dsm-host-shots/`.
 
+`pnpm check:switch` renders the Switch off, on and disabled on the standalone theme and the
+embedded theme (also under `host-simulation.css`), checks in headless Chrome that the knob stays
+inside and centred in the track and that a real mouse click toggles an enabled switch. Screenshots
+are left in `.switch-shots/`.
+
 In the workbench, open `DSM 7 / App Interior` and `DSM 7 / Advanced Components`
 for reference compositions. See [SPEC.md](./SPEC.md) for architecture and
 contribution rules, and [src/index.ts](./src/index.ts) for public exports.

package/dist/components/advanced-panel/AdvancePanelColumns.vue.d.ts

@@ -0,0 +1,19 @@
+import { AdvancePanelColumn } from './types';
+type __VLS_Props = {
+    columns?: AdvancePanelColumn[];
+};
+declare var __VLS_2: string, __VLS_3: {};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_2>]?: (props: typeof __VLS_3) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    columns: AdvancePanelColumn[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/advanced-panel/AdvancePanelForm.vue.d.ts

@@ -0,0 +1,21 @@
+import { AdvancePanelField } from './types';
+type __VLS_Props = {
+    fields?: AdvancePanelField[];
+};
+declare var __VLS_2: `${string}-label`, __VLS_3: {}, __VLS_6: `${string}-value`, __VLS_7: {};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_2>]?: (props: typeof __VLS_3) => any;
+} & {
+    [K in NonNullable<typeof __VLS_6>]?: (props: typeof __VLS_7) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    fields: AdvancePanelField[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/advanced-panel/AdvancePanelGrid.vue.d.ts

@@ -0,0 +1,44 @@
+import { AdvancePanelGridCell, AdvancePanelGridColumn, AdvancePanelGridRow, AdvancePanelGridSort, AdvancePanelGridSortResolver } from './types';
+type __VLS_Props = {
+    columns: AdvancePanelGridColumn[];
+    data: AdvancePanelGridRow[];
+    /** Custom comparator per column; falls back to a numeric/locale compare. */
+    localSortFunc?: AdvancePanelGridSortResolver;
+};
+declare function deactivateRow(): void;
+declare var __VLS_2: `header-${string}`, __VLS_3: {
+    column: AdvancePanelGridColumn;
+}, __VLS_25: {}, __VLS_28: string, __VLS_29: {
+    cell: AdvancePanelGridCell;
+    item: AdvancePanelGridRow;
+    column: AdvancePanelGridColumn;
+    index: number;
+}, __VLS_31: {
+    item: AdvancePanelGridRow;
+    column: AdvancePanelGridColumn;
+    index: number;
+    activate: () => void;
+    deactivate: typeof deactivateRow;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_2>]?: (props: typeof __VLS_3) => any;
+} & {
+    [K in NonNullable<typeof __VLS_28>]?: (props: typeof __VLS_29) => any;
+} & {
+    'empty-body'?: (props: typeof __VLS_25) => any;
+} & {
+    'row-hover-action'?: (props: typeof __VLS_31) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:sort": (sort: AdvancePanelGridSort) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:sort"?: ((sort: AdvancePanelGridSort) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/advanced-panel/types.d.ts

@@ -0,0 +1,50 @@
+export type AdvancePanelColumn = {
+    name: string;
+};
+export type AdvancePanelField = {
+    name: string;
+    /** Let the value wrap instead of staying on a single truncated line. */
+    multipleLine?: boolean;
+};
+export type AdvancePanelGridCellObject = {
+    content?: string;
+    /** Tooltip for a single cell, shown through the native title attribute. */
+    tooltip?: string;
+    /** Name of the slot that renders this cell instead of plain text. */
+    slot?: string;
+    /** Injected verbatim; the caller owns the safety of the string. */
+    html?: string;
+};
+export type AdvancePanelGridCell = string | number | AdvancePanelGridCellObject;
+export type AdvancePanelGridRow = Record<string, AdvancePanelGridCell>;
+export type AdvancePanelGridSortOrder = 'ASC' | 'DESC';
+export type AdvancePanelGridColumnSort = {
+    /** Sorting is off unless this is explicitly `false`. */
+    disable?: boolean;
+    /** First-click direction, `ASC` when unset. */
+    defaultOrder?: AdvancePanelGridSortOrder;
+};
+export type AdvancePanelGridTooltip = string | {
+    content?: string;
+    overflowOnly?: boolean;
+};
+export type AdvancePanelGridColumn = {
+    title: string;
+    field: string;
+    sort?: AdvancePanelGridColumnSort;
+    /** Supplementary info icon shown next to the header title. */
+    tip?: string;
+    tooltip?: AdvancePanelGridTooltip;
+    align?: 'left' | 'center' | 'right';
+};
+export type AdvancePanelGridSort = {
+    columnIndex: number;
+    order: AdvancePanelGridSortOrder;
+};
+export type AdvancePanelGridSortComparer = (a: AdvancePanelGridRow, b: AdvancePanelGridRow) => number;
+export type AdvancePanelGridSortResolver = (column: AdvancePanelGridColumn) => AdvancePanelGridSortComparer;
+export declare function isSortable(column: AdvancePanelGridColumn): boolean;
+export declare function cellObject(cell: AdvancePanelGridCell | undefined): AdvancePanelGridCellObject | undefined;
+/** Plain text of a cell, used for sorting and for the default rendering path. */
+export declare function cellText(cell: AdvancePanelGridCell | undefined): string;
+export declare function defaultCellComparer(a: AdvancePanelGridRow, b: AdvancePanelGridRow, field: string): number;

package/dist/components/app/app-action-bar/AppActionBar.vue.d.ts

@@ -1,10 +1,20 @@
-declare var __VLS_1: {}, __VLS_3: {};
+import { FootbarButton } from '../../composite/footbar/types';
+type __VLS_Props = {
+    buttons?: FootbarButton[];
+};
+declare var __VLS_1: {}, __VLS_24: {};
 type __VLS_Slots = {} & {
     leading?: (props: typeof __VLS_1) => any;
 } & {
-    default?: (props: typeof __VLS_3) => any;
+    default?: (props: typeof __VLS_24) => any;
 };
-declare const __VLS_base: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "click-button": (button: FootbarButton, event: MouseEvent) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onClick-button"?: ((button: FootbarButton, event: MouseEvent) => any) | undefined;
+}>, {
+    buttons: FootbarButton[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/app/app-layout/AppLayout.vue.d.ts

@@ -13,8 +13,8 @@ type __VLS_Slots = {} & {
     footer?: (props: typeof __VLS_7) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    sidebarWidth: string;
     minHeight: string;
+    sidebarWidth: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/app/app-sidebar/AppSidebar.vue.d.ts

@@ -1,15 +1,5 @@
-import { Component } from 'vue';
-export type AppSidebarItem = {
-    key: string;
-    label: string;
-    icon?: Component;
-    badge?: string | number;
-    disabled?: boolean;
-};
-export type AppSidebarGroup = {
-    label?: string;
-    items: AppSidebarItem[];
-};
+import { AppSidebarGroup, AppSidebarItem } from './types';
+export type { AppSidebarGroup, AppSidebarItem } from './types';
 type __VLS_Props = {
     modelValue?: string;
     groups: AppSidebarGroup[];
@@ -18,17 +8,26 @@ type __VLS_Props = {
     searchPlaceholder?: string;
     /** Section headers get a chevron and fold their items. */
     collapsible?: boolean;
+    /** Bind to control which rows with children are open. */
+    expandedKeys?: string[];
+    defaultExpandedKeys?: string[];
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     select: (item: AppSidebarItem) => any;
     "update:modelValue": (value: string) => any;
+    "update:expandedKeys": (value: string[]) => any;
+    branchToggle: (key: string, expanded: boolean) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelect?: ((item: AppSidebarItem) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    "onUpdate:expandedKeys"?: ((value: string[]) => any) | undefined;
+    onBranchToggle?: ((key: string, expanded: boolean) => any) | undefined;
 }>, {
+    searchPlaceholder: string;
     collapsible: boolean;
+    expandedKeys: string[];
+    defaultExpandedKeys: string[];
     searchable: boolean;
-    searchPlaceholder: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/app/app-sidebar/AppSidebarItems.vue.d.ts

@@ -0,0 +1,17 @@
+import { AppSidebarItem } from './types';
+type __VLS_Props = {
+    items: AppSidebarItem[];
+    modelValue?: string;
+    expandedKeys: string[];
+    depth: number;
+    searching?: boolean;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (item: AppSidebarItem) => any;
+    toggle: (key: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((item: AppSidebarItem) => any) | undefined;
+    onToggle?: ((key: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/app/app-sidebar/types.d.ts

@@ -0,0 +1,16 @@
+import { Component } from 'vue';
+export type AppSidebarItem = {
+    key: string;
+    label: string;
+    icon?: Component;
+    badge?: string | number;
+    disabled?: boolean;
+    /** Nested submodules; the row becomes an expand/collapse control. */
+    children?: AppSidebarItem[];
+    /** Let a row that has children also be selected. Off by default. */
+    selectable?: boolean;
+};
+export type AppSidebarGroup = {
+    label?: string;
+    items: AppSidebarItem[];
+};

package/dist/components/app/section-tabs/SectionTabs.vue.d.ts

@@ -7,10 +7,20 @@ type __VLS_Props = {
     modelValue: string;
     items: SectionTab[];
 };
-declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+declare var __VLS_2: `panel-${string}`, __VLS_3: {};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_2>]?: (props: typeof __VLS_3) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/composite/about-dialog/AboutDialog.vue.d.ts

@@ -0,0 +1,78 @@
+import { AboutCheckState, AboutVersionInfo } from './types';
+/**
+ * App-local "About this application" dialog: name, tagline, version, copyright
+ * and legal links. It is a plain modal dialog, not a DSM window: no window
+ * manager, dragging or desktop frame.
+ *
+ * The optional update check is never hidden. `fetchVersion` is awaited, the
+ * result drives a visible, announced status (checking / update / beta /
+ * failed), the request is re-runnable and its outcome is observable through
+ * `check-start`, `check-result` and `check-error` plus the exposed
+ * `checkForUpdates()`.
+ */
+type __VLS_Props = {
+    open?: boolean;
+    defaultOpen?: boolean;
+    title: string;
+    tagline?: string;
+    version?: string;
+    /** Defaults to the current year at render time. */
+    copyrightYear?: string;
+    iconSrc?: string;
+    beta?: boolean;
+    tosUrl?: string;
+    privacyUrl?: string;
+    releaseNotesUrl?: string;
+    /** Runs on open. Return `newVersion` for an update, `betaVersion` for beta info, `{}`/undefined for failure. */
+    fetchVersion?: () => Promise<AboutVersionInfo>;
+    checkUpdates?: boolean;
+    width?: string;
+    closeLabel?: string;
+};
+declare function checkForUpdates(): Promise<AboutVersionInfo | null>;
+declare var __VLS_11: {}, __VLS_13: {}, __VLS_58: {}, __VLS_61: {};
+type __VLS_Slots = {} & {
+    trigger?: (props: typeof __VLS_11) => any;
+} & {
+    icon?: (props: typeof __VLS_13) => any;
+} & {
+    default?: (props: typeof __VLS_58) => any;
+} & {
+    copyright?: (props: typeof __VLS_61) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
+    checkForUpdates: typeof checkForUpdates;
+    state: import('vue').Ref<AboutCheckState, AboutCheckState>;
+    versionInfo: import('vue').Ref<AboutVersionInfo | undefined, AboutVersionInfo | undefined>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+    "check-start": () => any;
+    "check-result": (info: AboutVersionInfo | null) => any;
+    "check-error": (error: unknown) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    "onCheck-start"?: (() => any) | undefined;
+    "onCheck-result"?: ((info: AboutVersionInfo | null) => any) | undefined;
+    "onCheck-error"?: ((error: unknown) => any) | undefined;
+}>, {
+    width: string;
+    defaultOpen: boolean;
+    open: boolean;
+    version: string;
+    closeLabel: string;
+    tagline: string;
+    iconSrc: string;
+    beta: boolean;
+    tosUrl: string;
+    privacyUrl: string;
+    releaseNotesUrl: string;
+    checkUpdates: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/composite/about-dialog/types.d.ts

@@ -0,0 +1,6 @@
+/** Result of the optional `fetchVersion` request. An empty result means the check failed. */
+export type AboutVersionInfo = {
+    newVersion?: string;
+    betaVersion?: string;
+};
+export type AboutCheckState = 'idle' | 'checking' | 'update-available' | 'beta-available' | 'failed';

package/dist/components/composite/callout/Callout.vue.d.ts

@@ -1,13 +1,23 @@
 type __VLS_Props = {
     tone?: 'info' | 'success' | 'warning' | 'danger';
     title?: string;
+    closable?: boolean;
+    closeLabel?: string;
 };
-declare var __VLS_6: {};
+declare var __VLS_6: {}, __VLS_8: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_6) => any;
+} & {
+    actions?: (props: typeof __VLS_8) => any;
 };
-declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    close: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+}>, {
     tone: "info" | "success" | "warning" | "danger";
+    closeLabel: string;
+    closable: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/composite/config-provider/ConfigProvider.vue.d.ts

@@ -0,0 +1,19 @@
+import { ConfigRecord } from '../../../composables/configCascade';
+type __VLS_Props = {
+    config?: ConfigRecord;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    config: ConfigRecord;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/composite/copy-cut-field/CopyCutField.vue.d.ts

@@ -0,0 +1,44 @@
+export type CopyCutFieldAutosize = boolean | {
+    minRows?: number;
+    maxRows?: number;
+};
+type __VLS_Props = {
+    modelValue?: string;
+    /** `copy` writes the value; `cut` writes it and clears the field. */
+    type?: 'copy' | 'cut';
+    /** Non-editable display field. The `cut` action requires `readonly: false`. */
+    readonly?: boolean;
+    disabled?: boolean;
+    inputType?: 'text' | 'textarea';
+    /** Textarea growth: `false` keeps two rows, `true` grows without limit. */
+    autosize?: CopyCutFieldAutosize;
+    placeholder?: string;
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+    name?: string;
+    id?: string;
+    copyLabel?: string;
+    cutLabel?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+    inputFocused: (event: FocusEvent) => any;
+    actionSuccess: (value: string) => any;
+    actionFailed: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    onInputFocused?: ((event: FocusEvent) => any) | undefined;
+    onActionSuccess?: ((value: string) => any) | undefined;
+    onActionFailed?: (() => any) | undefined;
+}>, {
+    type: "copy" | "cut";
+    disabled: boolean;
+    modelValue: string;
+    readonly: boolean;
+    inputType: "text" | "textarea";
+    autosize: CopyCutFieldAutosize;
+    copyLabel: string;
+    cutLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;