@wow-two-beta/ui-vue 0.0.2

package/dist/presentation/forms/emojiPicker/EmojiPickerPopover.vue.d.ts

@@ -0,0 +1,68 @@
+import { Placement } from '@floating-ui/vue';
+import { EmojiCatalogEntry } from '../../../domain/emoji';
+import { StorageBroker } from '../../../foundation/storage';
+import { CategoryNavVariant, EmojiPickerSizeInput, EmojiTileShape } from './EmojiPicker.variants';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/**
+ * Defines props for the popover-hosted emoji picker.
+ *
+ * React wrote this as `extends Omit<EmojiPickerProps, 'value' | 'onChange'>`. The
+ * forwarded picker props are spelled out instead: the SFC compiler has to generate
+ * them as real props (they are forwarded by hand, not fallthrough attrs), and an
+ * `Omit<…>` heritage over an imported interface is exactly what its type resolver
+ * cannot follow.
+ */
+export interface EmojiPickerPopoverProps {
+    /** The current emoji catalog entry, or `null` for none. The `v-model` binding target. */
+    readonly modelValue?: EmojiCatalogEntry | null;
+    /** The current emoji catalog entry — React's spelling of `modelValue`, which wins when both are set. */
+    readonly value?: EmojiCatalogEntry | null;
+    /** The persistence contract backing the "recently used" list. */
+    readonly storage: StorageBroker;
+    /** The category-navigation affordance. Default `strip`. */
+    readonly categoryNavVariant?: CategoryNavVariant;
+    /** The element scale — one value for every element, or a per-element `{ search, nav, tile }`. Default `md`. */
+    readonly size?: EmojiPickerSizeInput;
+    /** The emoji-tile frame — rounded chip or circle. Default `rounded`. */
+    readonly tileShape?: EmojiTileShape;
+    /** The scrollable tile viewport's height, in tile rows. Default `6`. */
+    readonly rowsCount?: number;
+    /** The heading rendered above the picker. Default `Emoji`. */
+    readonly label?: string;
+    /** When `true` and no emoji has been used yet, opens on the first real category. Default `false`. */
+    readonly showFirstCategoryWhenRecentsEmpty?: boolean;
+    /** The scrollbar thumb color for the tile viewport — any CSS color. */
+    readonly scrollThumbColor?: string;
+    /** The popover placement relative to the trigger. Default `bottom`. */
+    readonly placement?: Placement;
+    /** The open state, controlled. The `v-model:open` binding target. */
+    readonly open?: boolean;
+    /** The open state, controlled — the house boolean spelling of `open`; `open` wins when both are set. */
+    readonly isOpen?: boolean;
+    /** The initial open state when uncontrolled. Default `false`. */
+    readonly defaultOpen?: boolean;
+}
+declare const _default: __VLS_WithSlots< DefineComponent<EmojiPickerPopoverProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "value-change": (entry: EmojiCatalogEntry | null) => any;
+    "open-change": (open: boolean) => any;
+    "update:open": (open: boolean) => any;
+    "update:modelValue": (entry: EmojiCatalogEntry | null) => any;
+}, string, PublicProps, Readonly<EmojiPickerPopoverProps> & Readonly<{
+    "onValue-change"?: ((entry: EmojiCatalogEntry | null) => any) | undefined;
+    "onOpen-change"?: ((open: boolean) => any) | undefined;
+    "onUpdate:open"?: ((open: boolean) => any) | undefined;
+    "onUpdate:modelValue"?: ((entry: EmojiCatalogEntry | null) => any) | undefined;
+}>, {
+    readonly open: boolean;
+    readonly placement: Placement;
+    readonly isOpen: boolean;
+    readonly defaultOpen: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+    trigger?(): unknown;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/presentation/forms/emojiPicker/EmojiTile.vue.d.ts

@@ -0,0 +1,22 @@
+import { EmojiCatalogEntry } from '../../../domain/emoji';
+import { EmojiTileShape, EmojiPickerSize } from './EmojiPicker.variants';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** Defines props for a single selectable emoji tile. */
+export interface EmojiTileProps {
+    /** The catalog emoji this tile renders. */
+    readonly entry: EmojiCatalogEntry;
+    /** Whether this tile is the active selection. */
+    readonly selected: boolean;
+    /** The tile scale. */
+    readonly size: EmojiPickerSize;
+    /** The tile frame — rounded chip or circle. */
+    readonly shape: EmojiTileShape;
+    /** Whether this tile holds the grid's single roving tab stop. */
+    readonly isActive: boolean;
+}
+declare const _default: DefineComponent<EmojiTileProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    select: (entry: EmojiCatalogEntry) => any;
+}, string, PublicProps, Readonly<EmojiTileProps> & Readonly<{
+    onSelect?: ((entry: EmojiCatalogEntry) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/presentation/forms/emojiPicker/index.d.ts

@@ -0,0 +1,4 @@
+export { default as EmojiPicker, type EmojiPickerProps } from './EmojiPicker.vue';
+export { default as EmojiPickerPopover, type EmojiPickerPopoverProps, } from './EmojiPickerPopover.vue';
+export { useEmojiPicker, type UseEmojiPickerOptions, type EmojiPickerModel, } from './useEmojiPicker';
+export * from './EmojiPicker.variants';

package/dist/presentation/forms/emojiPicker/useEmojiPicker.d.ts

@@ -0,0 +1,45 @@
+import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+import { EmojiCatalogEntry } from '../../../domain/emoji';
+import { StorageBroker } from '../../../foundation/storage';
+import { CategoryKey } from './EmojiPicker.variants';
+/** Defines the inputs the picker view-model binds to the live selection value. */
+export interface UseEmojiPickerOptions {
+    /** The current emoji entry, or `null` for none. Pass a getter to keep it reactive. */
+    readonly value: MaybeRefOrGetter<EmojiCatalogEntry | null>;
+    /** Emits the next emoji entry, or `null` to clear it. */
+    readonly onChange: (entry: EmojiCatalogEntry | null) => void;
+    /** The persistence contract backing recents — injected so the picker stays storage-agnostic (localStorage, Redux, …). */
+    readonly storage: StorageBroker;
+    /** When `true` and recents is empty at mount, the initial category is the first real category, not the recents bucket. Default `false`. */
+    readonly showFirstCategoryWhenRecentsEmpty?: MaybeRefOrGetter<boolean>;
+}
+/**
+ * Represents the headless picker state — layout-agnostic, shared by every nav variant.
+ *
+ * React exposed `setSearchKeyword` / `setActiveCategory` alongside the values; here
+ * both are writable refs, which already are their own setters, so the paired setters
+ * are gone.
+ */
+export interface EmojiPickerModel {
+    /** The current search keyword. Writable. */
+    readonly searchKeyword: Ref<string>;
+    /** The active category (or the synthetic recents bucket). Writable. */
+    readonly activeCategory: Ref<CategoryKey>;
+    /** Whether a non-empty keyword is driving the visible list, bypassing categories. */
+    readonly showSearch: ComputedRef<boolean>;
+    /** The emoji to render right now — search results, recents, or the active category. */
+    readonly visibleEmojis: ComputedRef<readonly EmojiCatalogEntry[]>;
+    /** The most-recently-used emoji, most-recent-first. */
+    readonly recents: ComputedRef<ReadonlyArray<EmojiCatalogEntry>>;
+    /** The selected emoji entry, or `null` for none. */
+    readonly selected: ComputedRef<EmojiCatalogEntry | null>;
+    /** Picks an emoji — sets the selection to that entry and records it as recent. */
+    readonly selectEmoji: (entry: EmojiCatalogEntry) => void;
+    /** Clears the selected emoji. */
+    readonly clearSelection: () => void;
+}
+/**
+ * Manages the emoji picker independent of layout: owns the keyword, the active category, the derived
+ * visible list, and the recents MRU — and folds a pick back into the selection entry + the recents list.
+ */
+export declare function useEmojiPicker({ value, onChange, storage, showFirstCategoryWhenRecentsEmpty, }: UseEmojiPickerOptions): EmojiPickerModel;

package/dist/presentation/forms/emojiSizeControl/EmojiSizeControl.variants.d.ts

@@ -0,0 +1,23 @@
+/** Defines a discrete emoji size preset — the ratio it applies to the host width, plus its preview glyph. */
+export declare const CenterEmojiSize: {
+    /** Refers to the small emoji size. */
+    readonly Small: "small";
+    /** Refers to the medium emoji size. */
+    readonly Medium: "medium";
+    /** Refers to the large emoji size. */
+    readonly Large: "large";
+};
+export type CenterEmojiSize = (typeof CenterEmojiSize)[keyof typeof CenterEmojiSize];
+/** Defines the display for an emoji size option. */
+interface CenterEmojiSizeDisplay {
+    label: string;
+    ratio: number;
+    glyph: number;
+}
+/** Maps each emoji size to its label, host-width ratio, and preview glyph size (each glyph ≤ the control's preview cap). */
+export declare const CenterEmojiSizeDisplays: Record<CenterEmojiSize, CenterEmojiSizeDisplay>;
+/** The emoji size (fraction of the host surface's width) applied as the sensible default when none is set. */
+export declare const DefaultEmojiSize = 0.25;
+/** The default preview-glyph cap, in px — caps each tile's glyph so it never clips the `OptionTile` frame. */
+export declare const DefaultMaxPreviewGlyph = 24;
+export {};

package/dist/presentation/forms/emojiSizeControl/EmojiSizeControl.vue.d.ts

@@ -0,0 +1,32 @@
+import { ButtonSize } from '../../actions/button/Button.vue';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** Defines props for the emoji size control. */
+export interface EmojiSizeControlProps {
+    /** The emoji rendered inside each tile, so the choice previews the real glyph at that size. */
+    readonly glyph: string;
+    /** The current size ratio, controlled. The `v-model` binding target. */
+    readonly modelValue?: number;
+    /** The current size ratio — React's spelling of `modelValue`, which wins when both are set. */
+    readonly sizeRatio?: number;
+    /**
+     * The preset-tile scale, forwarded to each `OptionTile`. Default `sm`.
+     *
+     * React wrote this as `OptionTileProps['size']`. An indexed access into an
+     * imported interface is opaque to the SFC compiler's type resolver — it fails
+     * the build while `vue-tsc` stays green — so the named alias the tile itself
+     * uses is spelled out instead.
+     */
+    readonly size?: ButtonSize;
+    /** The largest preview glyph, in px — caps each tile's glyph so it never clips the `OptionTile` frame. Default `24`. */
+    readonly maxPreviewGlyph?: number;
+}
+declare const _default: DefineComponent<EmojiSizeControlProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "value-change": (ratio: number) => any;
+    "update:modelValue": (ratio: number) => any;
+}, string, PublicProps, Readonly<EmojiSizeControlProps> & Readonly<{
+    "onValue-change"?: ((ratio: number) => any) | undefined;
+    "onUpdate:modelValue"?: ((ratio: number) => any) | undefined;
+}>, {
+    readonly maxPreviewGlyph: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/presentation/forms/emojiSizeControl/index.d.ts

@@ -0,0 +1,2 @@
+export { default as EmojiSizeControl, type EmojiSizeControlProps } from './EmojiSizeControl.vue';
+export * from './EmojiSizeControl.variants';

package/dist/presentation/forms/field/Field.vue.d.ts

@@ -0,0 +1,37 @@
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface FieldProps {
+    /** The label text. Fill the `label` slot instead for richer content (e.g. label + tooltip). */
+    label?: string | number;
+    /** The helper / hint shown beneath the control. Hidden while errors show. */
+    helper?: string | number;
+    /**
+     * The error text — renders only when truthy. Sets `isInvalid` on the form context.
+     * Inside a forms-engine `Field` this is an OVERRIDE: leave it unset and the
+     * field's own errors (client + server, all of them) render automatically.
+     */
+    error?: string | number;
+    /** The required state (also exposes `isRequired` to the control via context). */
+    isRequired?: boolean;
+    /** The disabled state (also exposes `isDisabled` to the control). */
+    isDisabled?: boolean;
+    /** The read-only state (also exposes `isReadOnly` to the control). */
+    isReadOnly?: boolean;
+}
+declare const _default: __VLS_WithSlots< DefineComponent<FieldProps, {
+    el: Readonly< ShallowRef<HTMLDivElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<FieldProps> & Readonly<{}>, {
+    isDisabled: boolean;
+    isRequired: boolean;
+    isReadOnly: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+    default(): unknown;
+    label?(): unknown;
+    helper?(): unknown;
+    error?(): unknown;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/presentation/forms/field/index.d.ts

@@ -0,0 +1,6 @@
+export { default as Field, type FieldProps } from './Field.vue';
+/**
+ * @deprecated `FormField` was renamed to `Field` (the generic labeled wrapper).
+ * Alias kept for one release so consumers can migrate; removed next.
+ */
+export { default as FormField, type FieldProps as FormFieldProps } from './Field.vue';

package/dist/presentation/forms/fieldset/Fieldset.vue.d.ts

@@ -0,0 +1,22 @@
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/**
+ * Defines props for a `Fieldset`.
+ *
+ * React's `FieldsetHTMLAttributes<HTMLFieldSetElement>` has no Vue counterpart —
+ * every native attribute (`disabled`, `form`, `name`) is a fallthrough attr and
+ * lands on the `<fieldset>` unchanged. The name is kept so consumers importing
+ * `FieldsetProps` still resolve.
+ */
+export interface FieldsetProps {
+}
+declare const _default: __VLS_WithSlots< DefineComponent<{}, {
+    el: Readonly< ShallowRef<HTMLFieldSetElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/presentation/forms/fieldset/index.d.ts

@@ -0,0 +1 @@
+export { default as Fieldset, type FieldsetProps } from './Fieldset.vue';

package/dist/presentation/forms/filePicker/FilePicker.vue.d.ts

@@ -0,0 +1,34 @@
+import { Size } from '../../../foundation/utils';
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface FilePickerProps {
+    /** The button label. Default `"Choose file"`. Fill the `label` slot for richer content. */
+    label?: string | number;
+    /** The filename(s) preview rendered next to the button. Fill the `preview` slot for richer content. */
+    preview?: string | number;
+    /** The visual size of the button. Default `md`. */
+    size?: Size;
+    /** The control's id. Auto-filled from `FormControl` context when omitted. */
+    id?: string;
+    /** The disabled state. Falls back to the surrounding form control's `isDisabled`. */
+    disabled?: boolean;
+}
+declare const _default: __VLS_WithSlots< DefineComponent<FilePickerProps, {
+    el: Readonly< ShallowRef<HTMLInputElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "files-change": (files: FileList | null) => any;
+}, string, PublicProps, Readonly<FilePickerProps> & Readonly<{
+    "onFiles-change"?: ((files: FileList | null) => any) | undefined;
+}>, {
+    label: string | number;
+    size: Size;
+    disabled: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+    label?(): unknown;
+    preview?(): unknown;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/presentation/forms/filePicker/index.d.ts

@@ -0,0 +1 @@
+export { default as FilePicker, type FilePickerProps } from './FilePicker.vue';

package/dist/presentation/forms/fileUpload/FileUpload.vue.d.ts

@@ -0,0 +1,60 @@
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** Defines why a picked file was rejected by the uploader. */
+export declare const FileRejectionReason: {
+    /** Refers to a file whose MIME type / extension is not accepted. */
+    readonly Type: "type";
+    /** Refers to a file exceeding the max size. */
+    readonly Size: "size";
+    /** Refers to a file beyond the max file count. */
+    readonly Count: "count";
+};
+export type FileRejectionReason = (typeof FileRejectionReason)[keyof typeof FileRejectionReason];
+export interface FileRejection {
+    file: File;
+    reason: FileRejectionReason;
+}
+export interface FileUploadProps {
+    /** The `accept` token list handed to the native input and used for validation. */
+    accept?: string;
+    /** Whether more than one file may be picked. Default `false`. */
+    multiple?: boolean;
+    /** The per-file byte cap. Files exceeding this drop into `rejected`. */
+    maxSize?: number;
+    /** The cap on total accepted files (multiple mode). Excess go to `rejected`. */
+    maxFiles?: number;
+    /** The invalid surface override. Falls back to the surrounding form control's `isInvalid`. */
+    isInvalid?: boolean;
+    /** The zone's headline. Fill the `label` slot for richer content. */
+    label?: string | number;
+    /** The zone's sub-line. Fill the `hint` slot for richer content. */
+    hint?: string | number;
+    /** The disabled state. Falls back to the surrounding form control's `isDisabled`. */
+    disabled?: boolean;
+    /** The native input name. */
+    name?: string;
+    /** The control's id. Auto-filled from `FormControl` context when omitted. */
+    id?: string;
+}
+declare const _default: __VLS_WithSlots< DefineComponent<FileUploadProps, {
+    el: Readonly< ShallowRef<HTMLInputElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "files-change": (accepted: readonly File[], rejected: readonly FileRejection[]) => any;
+}, string, PublicProps, Readonly<FileUploadProps> & Readonly<{
+    "onFiles-change"?: ((accepted: readonly File[], rejected: readonly FileRejection[]) => any) | undefined;
+}>, {
+    label: string | number;
+    multiple: boolean;
+    disabled: boolean;
+    isInvalid: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+    /** The content rendered under the drop zone — React's `children`. */
+    default?(): unknown;
+    label?(): unknown;
+    hint?(): unknown;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/presentation/forms/fileUpload/index.d.ts

@@ -0,0 +1 @@
+export { default as FileUpload, FileRejectionReason, type FileUploadProps, type FileRejection, } from './FileUpload.vue';

package/dist/presentation/forms/fontPicker/FontPicker.vue.d.ts

@@ -0,0 +1,43 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** Represents a single selectable font face. */
+export interface FontOption {
+    name: string;
+    family: string;
+    sample?: string;
+}
+export declare const BUILT_IN_FONTS: ReadonlyArray<FontOption>;
+export interface FontPickerProps {
+    /** The selected font family, controlled — React's spelling, which wins when both are set. */
+    value?: string;
+    /** The selected font family, controlled. The `v-model` binding target. */
+    modelValue?: string;
+    /** The initial font family when uncontrolled. Defaults to the first entry in `fonts`. */
+    defaultValue?: string;
+    /** The selectable font set. Defaults to {@link BUILT_IN_FONTS}. */
+    fonts?: ReadonlyArray<FontOption>;
+    /** The trigger text shown when the value matches no known font. */
+    placeholder?: string;
+    /** The sample string rendered in each row's own face, unless the option carries its own `sample`. */
+    previewText?: string;
+    /** The disabled state. Falls back to the surrounding form control's `isDisabled`. */
+    isDisabled?: boolean;
+    /** The hidden form input name; the hidden input emits the selected family. */
+    name?: string;
+    /** The control's id — it lands on the trigger button. Auto-filled from `FormControl` context. */
+    id?: string;
+}
+declare const _default: DefineComponent<FontPickerProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "value-change": (family: string) => any;
+    "update:modelValue": (family: string) => any;
+}, string, PublicProps, Readonly<FontPickerProps> & Readonly<{
+    "onValue-change"?: ((family: string) => any) | undefined;
+    "onUpdate:modelValue"?: ((family: string) => any) | undefined;
+}>, {
+    value: string;
+    placeholder: string;
+    isDisabled: boolean;
+    modelValue: string;
+    fonts: ReadonlyArray<FontOption>;
+    previewText: string;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/presentation/forms/fontPicker/index.d.ts

@@ -0,0 +1 @@
+export { default as FontPicker, BUILT_IN_FONTS, type FontOption, type FontPickerProps, } from './FontPicker.vue';

package/dist/presentation/forms/formErrorMessage/FormErrorMessage.vue.d.ts

@@ -0,0 +1,24 @@
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface FormErrorMessageProps {
+    /**
+     * The node's own id. An explicit id detaches it from the context's `errorId`,
+     * so the control's `aria-describedby` stops referencing it.
+     */
+    id?: string;
+    /**
+     * The single hand-written message — the scalar half of React's `children`.
+     * Set it (or fill the default slot) to override the context's `errors`.
+     */
+    message?: string | number;
+}
+declare const _default: __VLS_WithSlots< DefineComponent<FormErrorMessageProps, {
+    el: Readonly< ShallowRef<HTMLParagraphElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<FormErrorMessageProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/presentation/forms/formErrorMessage/index.d.ts

@@ -0,0 +1 @@
+export { default as FormErrorMessage, type FormErrorMessageProps, } from './FormErrorMessage.vue';

package/dist/presentation/forms/formHelperText/FormHelperText.vue.d.ts

@@ -0,0 +1,19 @@
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface FormHelperTextProps {
+    /**
+     * The node's own id. An explicit id detaches it from the context's `helperId`,
+     * so the control's `aria-describedby` stops referencing it.
+     */
+    id?: string;
+}
+declare const _default: __VLS_WithSlots< DefineComponent<FormHelperTextProps, {
+    el: Readonly< ShallowRef<HTMLParagraphElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<FormHelperTextProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/presentation/forms/formHelperText/index.d.ts

@@ -0,0 +1 @@
+export { default as FormHelperText, type FormHelperTextProps } from './FormHelperText.vue';

package/dist/presentation/forms/gradientPicker/GradientPicker.vue.d.ts

@@ -0,0 +1,50 @@
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** Defines the geometry of a CSS gradient. */
+export declare const GradientKind: {
+    /** Refers to a linear gradient. */
+    readonly Linear: "linear";
+    /** Refers to a radial gradient. */
+    readonly Radial: "radial";
+    /** Refers to a conic gradient. */
+    readonly Conic: "conic";
+};
+export type GradientKind = (typeof GradientKind)[keyof typeof GradientKind];
+export interface GradientStop {
+    color: string;
+    position: number;
+}
+export interface Gradient {
+    kind: GradientKind;
+    angle: number;
+    stops: ReadonlyArray<GradientStop>;
+}
+export interface GradientPickerProps {
+    /** The gradient, controlled — React's spelling, which wins when both are set. */
+    value?: Gradient;
+    /** The gradient, controlled. The `v-model` binding target. */
+    modelValue?: Gradient;
+    /** The initial gradient when uncontrolled. */
+    defaultValue?: Gradient;
+    /** The disabled state. Falls back to the surrounding form control's `isDisabled`. */
+    isDisabled?: boolean;
+    /** The hidden input name; the hidden input emits the CSS string. */
+    name?: string;
+    /** The control's id. Auto-filled from `FormControl` context when omitted. */
+    id?: string;
+}
+export declare function gradientToCss(g: Gradient): string;
+declare const _default: DefineComponent<GradientPickerProps, {
+    el: Readonly< ShallowRef<HTMLDivElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "value-change": (value: Gradient) => any;
+    "update:modelValue": (value: Gradient) => any;
+}, string, PublicProps, Readonly<GradientPickerProps> & Readonly<{
+    "onValue-change"?: ((value: Gradient) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: Gradient) => any) | undefined;
+}>, {
+    value: Gradient;
+    isDisabled: boolean;
+    defaultValue: Gradient;
+    modelValue: Gradient;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/presentation/forms/gradientPicker/index.d.ts

@@ -0,0 +1 @@
+export { default as GradientPicker, gradientToCss, GradientKind, type Gradient, type GradientPickerProps, type GradientStop, } from './GradientPicker.vue';

package/dist/presentation/forms/iconPicker/IconPicker.vue.d.ts

@@ -0,0 +1,45 @@
+import { IconAdapter } from '../../../foundation/icons';
+import { DefineComponent, ShallowRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface IconPickerProps {
+    /** The selected icon key, controlled — React's spelling, which wins when both are set. */
+    value?: string;
+    /** The selected icon key, controlled. The `v-model` binding target. */
+    modelValue?: string;
+    /** The initial icon key when uncontrolled. */
+    defaultValue?: string;
+    /** The icon set, keyed by the name the picker emits. Defaults to the built-in lucide subset. */
+    icons?: Record<string, IconAdapter>;
+    /** The number of grid columns. Default `8`. */
+    columns?: number;
+    /** The glyph pixel size. Default `20`. */
+    size?: number;
+    /** The pixel size of each icon button. Default `36`. */
+    iconButtonSize?: number;
+    /** The search-field placeholder. */
+    placeholder?: string;
+    /** The disabled state. Falls back to the surrounding form control's `isDisabled`. */
+    isDisabled?: boolean;
+    /** The hidden input name; the hidden input emits the selected icon key. */
+    name?: string;
+    /** The control's id. Auto-filled from `FormControl` context when omitted. */
+    id?: string;
+}
+declare const _default: DefineComponent<IconPickerProps, {
+    el: Readonly< ShallowRef<HTMLDivElement | null>>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "value-change": (name: string) => any;
+    "update:modelValue": (name: string) => any;
+}, string, PublicProps, Readonly<IconPickerProps> & Readonly<{
+    "onValue-change"?: ((name: string) => any) | undefined;
+    "onUpdate:modelValue"?: ((name: string) => any) | undefined;
+}>, {
+    size: number;
+    value: string;
+    placeholder: string;
+    isDisabled: boolean;
+    columns: number;
+    modelValue: string;
+    icons: Record<string, IconAdapter>;
+    iconButtonSize: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/presentation/forms/iconPicker/index.d.ts

@@ -0,0 +1 @@
+export { default as IconPicker, type IconPickerProps } from './IconPicker.vue';