@atscript/vue-form 0.1.58

package/dist/index.mjs

@@ -0,0 +1,105 @@
+import { m as PATH_PREFIX_KEY, n as useAsUnionVariant, s as DISMISS_EXTERNAL_AT_KEY, t as formatIndexedLabelParts } from "./use-form-context-bAj7UoSe.mjs";
+import { n as provideAsNestedSectionsStore, r as useAsNestedSectionsStore } from "./use-as-nested-sections-store-lhi0z5z1.mjs";
+import { n as useAsValueHelp } from "./use-as-value-help-CBykDEjZ.mjs";
+import { i as useAsExternalErrors, n as useAsForm, r as useAsState, t as as_form_default } from "./as-form-CWwgyvfw.mjs";
+import { n as useAsData, r as useAsField, t as as_field_default } from "./as-field-CXVjrEPQ.mjs";
+import { n as useAsLocale, t as provideAsLocale } from "./use-as-locale-BrFdAgnU.mjs";
+import { t as as_iterator_default } from "./as-iterator-CT5y1jyn.mjs";
+import { i as useAsFocusFirstAfter, n as focusFirstAfter, r as focusNewFocusableAfter, t as useAsDropdown } from "./use-as-dropdown-BMnEm6jF.mjs";
+import { t as as_field_shell_default } from "./as-field-shell-Pdy3sAvr.mjs";
+import "./as-variant-picker-BVs0AvjK.mjs";
+import "./as-input-control-BzELjheN.mjs";
+import "./as-adornment-shell-knFiB7Ct.mjs";
+import { t as as_input_default } from "./as-input-DIa8BzLv.mjs";
+import { t as as_select_default } from "./as-select-UBGCVhku.mjs";
+import { t as as_radio_default } from "./as-radio-B1N-gmoI.mjs";
+import { n as useAsTriStateCheckbox, t as as_checkbox_default } from "./as-checkbox-B_9mwla6.mjs";
+import { t as as_paragraph_default } from "./as-paragraph-jIG_dg7_.mjs";
+import { t as as_action_default } from "./as-action-DU17rykn.mjs";
+import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-CuXEir_i.mjs";
+import "./as-collapsible-DtNCofNT.mjs";
+import { t as as_object_default } from "./as-object-CT6lNEqt.mjs";
+import { n as useAsArray, t as as_array_default } from "./as-array-DwarTaKP.mjs";
+import "./as-array-clear-btn-DIhzCKC9.mjs";
+import { n as useAsTypeMap, r as useAsUnion, t as as_union_default } from "./as-union-BGvdxr3G.mjs";
+import { n as useAsTuple, t as as_tuple_default } from "./as-tuple-DkI9swlW.mjs";
+import { t as as_ref_default } from "./as-ref-CIifSSCQ.mjs";
+import { n as useAsDualInput, r as useAsDecimal, t as as_decimal_default } from "./as-decimal-DtXjFPhe.mjs";
+import { n as useAsNumber, t as as_number_default } from "./as-number-JPEwPK8Q.mjs";
+import { t as useAsDate } from "./use-as-date-C39i9mzE.mjs";
+import { t as as_date_default } from "./as-date-C7tFQDkh.mjs";
+import { t as as_datetime_default } from "./as-datetime-elcOoDT5.mjs";
+import { t as as_time_default } from "./as-time-CQsxUs8P.mjs";
+import { computed, inject, reactive } from "vue";
+import { createFormData, createFormDef, createFormValueResolver, getDefaultClientFactory, resetDefaultClientFactory, setDefaultClientFactory } from "@atscript/ui";
+//#region src/composables/create-as-form-def.ts
+/**
+* Creates a reactive form definition and data object from an ATScript annotated type.
+*
+* @param type - An ATScript annotated type (imported from a `.as` file).
+* @param context - Optional context object forwarded to `ui.fn.value` resolvers during data creation.
+*   Only effective when `@atscript/ui-fns` is installed (dynamic resolver).
+* @returns `{ def, formData }` — the FormDef and a Vue reactive data object with defaults applied
+*/
+function createAsFormDef(type, context) {
+	return {
+		def: createFormDef(type),
+		formData: reactive(createFormData(type, context ? createFormValueResolver({}, context) : void 0))
+	};
+}
+//#endregion
+//#region src/composables/create-default-types.ts
+/**
+* Returns a fresh type-to-component map pre-filled with all built-in defaults.
+*
+* Spread or assign additional entries to extend with custom field types:
+* ```ts
+* const types = { ...createDefaultTypes(), rating: MyRatingComponent }
+* ```
+*/
+function createDefaultTypes() {
+	return {
+		text: as_input_default,
+		textarea: as_input_default,
+		password: as_input_default,
+		number: as_number_default,
+		decimal: as_decimal_default,
+		select: as_select_default,
+		radio: as_radio_default,
+		checkbox: as_checkbox_default,
+		paragraph: as_paragraph_default,
+		action: as_action_default,
+		object: as_object_default,
+		array: as_array_default,
+		union: as_union_default,
+		tuple: as_tuple_default,
+		ref: as_ref_default,
+		date: as_date_default,
+		datetime: as_datetime_default,
+		time: as_time_default
+	};
+}
+//#endregion
+//#region src/composables/use-as-path.ts
+const EMPTY_PATH = computed(() => "");
+/**
+* Reactive read-only access to the absolute dotted path prefix at the
+* current point in the `<AsForm>` tree. Returns `''` when called outside
+* a form.
+*/
+function useAsPath() {
+	return { path: inject(PATH_PREFIX_KEY, EMPTY_PATH) };
+}
+//#endregion
+//#region src/composables/use-as-error-dismiss.ts
+const NOOP = () => {};
+/**
+* Returns the `dismissExternalAt` callback provided by the nearest
+* ancestor `<AsForm>`. Outside a form the result is a no-op so calling
+* it from a leaf component does not throw.
+*/
+function useAsErrorDismiss() {
+	return inject(DISMISS_EXTERNAL_AT_KEY, null) ?? NOOP;
+}
+//#endregion
+export { as_action_default as AsAction, as_array_default as AsArray, as_checkbox_default as AsCheckbox, as_date_default as AsDate, as_datetime_default as AsDatetime, as_decimal_default as AsDecimal, as_field_default as AsField, as_field_shell_default as AsFieldShell, as_form_default as AsForm, as_input_default as AsInput, as_iterator_default as AsIterator, as_number_default as AsNumber, as_object_default as AsObject, as_paragraph_default as AsParagraph, as_radio_default as AsRadio, as_ref_default as AsRef, as_select_default as AsSelect, as_time_default as AsTime, as_tuple_default as AsTuple, as_union_default as AsUnion, createAsFormDef, createDefaultTypes, focusFirstAfter, focusNewFocusableAfter, formatIndexedLabelParts, getDefaultClientFactory, provideAsLocale, provideAsNestedSectionsStore, resetDefaultClientFactory, setDefaultClientFactory, useAsArray, useAsData, useAsDate, useAsDecimal, useAsDropdown, useAsDualInput, useAsErrorDismiss, useAsExternalErrors, useAsField, useAsFocusFirstAfter, useAsForm, useAsLocale, useAsNestedSectionsStore, useAsNumber, useAsOptionalAddFlow, useAsPath, useAsState, useAsTriStateCheckbox, useAsTuple, useAsTypeMap, useAsUnion, useAsUnionVariant, useAsValueHelp };

package/dist/types-C4HRSxgV.d.cts

@@ -0,0 +1,233 @@
+import { Component, Ref } from "vue";
+import { FormFieldDef, FormUnionVariant, TFormAction, TFormEntryOptions, ValueHelpInfo } from "@atscript/ui";
+
+//#region src/components/types.d.ts
+/**
+ * Shared base props available to all custom form components.
+ */
+interface TAsBaseComponentProps {
+  /** Whether this component is disabled. */
+  disabled?: boolean;
+  /** Whether this component is hidden. */
+  hidden?: boolean;
+}
+/**
+ * Props contract for custom field components used with `AsForm` / `AsField`.
+ *
+ * Implement this interface in your UI components so that `AsField` can pass
+ * all resolved field state (value, label, validation errors, etc.) as props.
+ *
+ * @typeParam V - The field value type
+ * @typeParam TFormData - The full form data object type
+ * @typeParam TFormContext - The external context object type
+ */
+interface TAsComponentProps<V = unknown> extends TAsBaseComponentProps {
+  /** Called on field blur — triggers validation. */
+  onBlur: () => void;
+  /** Validation error message for this field, if any. */
+  error?: string;
+  /** Reactive model wrapping the field value. Bind with `v-model="model.value"`. */
+  model: {
+    value: V;
+  };
+  /** Phantom field display value from `@meta.default` / `@ui.form.fn.value` (paragraphs, actions). `undefined` for data fields. */
+  value?: unknown;
+  /** Resolved field label from `@meta.label` or `@ui.form.fn.label`. */
+  label?: string;
+  /** Resolved field description from `@meta.description` or `@ui.form.fn.description`. */
+  description?: string;
+  /** Resolved hint text from `@ui.form.hint` or `@ui.form.fn.hint`. */
+  hint?: string;
+  /** Resolved placeholder from `@ui.form.placeholder` or `@ui.form.fn.placeholder`. */
+  placeholder?: string;
+  /** Resolved CSS class painting the prefix icon glyph from `@ui.form.prefix.icon`. Consumer manages safelist / preset coverage. Rendered as the leftmost adornment, before the `prefix` text. */
+  prefixIcon?: string;
+  /** Resolved CSS class painting the suffix icon glyph from `@ui.form.suffix.icon`. Consumer manages safelist / preset coverage. Rendered as the rightmost adornment, after the `suffix` text. */
+  suffixIcon?: string;
+  /** CSS class(es) from `@ui.form.classes` or `@ui.form.fn.classes`. */
+  class?: Record<string, boolean> | string;
+  /** Inline styles from `@ui.form.styles` or `@ui.form.fn.styles`. */
+  style?: Record<string, string> | string;
+  /** Whether the field is optional (not required). */
+  optional?: boolean | undefined;
+  /** Toggle an optional field on/off. `true` sets default value; `false` sets `undefined`. Only present when `optional` is true. */
+  onToggleOptional?: (enabled: boolean) => void;
+  /** Whether the field is required (inverse of optional). */
+  required?: boolean | undefined;
+  /** Whether the field is read-only. */
+  readonly?: boolean | undefined;
+  /** The resolved field input type (e.g., `'text'`, `'select'`, `'checkbox'`). */
+  type: string;
+  /** Form action from `@ui.form.action`. Contains the action id and display label. */
+  formAction?: TFormAction;
+  /** The field name (last segment of the dot-separated path). */
+  name?: string;
+  /** The full FormFieldDef for advanced use cases. */
+  field?: FormFieldDef;
+  /** Resolved options for select/radio/checkbox fields. */
+  options?: TFormEntryOptions[];
+  /** Max length constraint from `@expect.maxLength`. */
+  maxLength?: number;
+  /** Autocomplete hint from `@ui.form.autocomplete`. */
+  autocomplete?: string;
+  /** Resolved title from `@ui.form.fn.title` / `@meta.label` for structure/array fields. */
+  title?: string;
+  /** Nesting level for structure/array fields. Root structure is 0, each nested structure/array increments by 1. */
+  level?: number;
+  /** Callback to remove this item from its parent array. Present when rendered inside an array. */
+  onRemove?: () => void;
+  /** Whether removal is allowed (respects minLength constraints). */
+  canRemove?: boolean;
+  /** Label for the remove button (from `@ui.array.remove.label`). */
+  removeLabel?: string;
+  /** Zero-based index when rendered as a direct array item. `undefined` otherwise. */
+  arrayIndex?: number;
+  /** Absolute dotted path to this field inside the form data. Empty string at the root. */
+  path: string;
+  /** Resolved value-help descriptor for FK ref fields (`@db.rel.FK` → `@db.http.path`). */
+  valueHelp?: ValueHelpInfo;
+  /** Singular label for array fields (`@ui.form.label.singular`) — used in "Add <singular>" affordances. */
+  singularLabel?: string;
+  /** Stable input element id, suitable for `<label :for>`. Co-resolved with `errorId` / `descId` so a11y wiring is consistent. Always populated by AsField. */
+  inputId: string;
+  /** Stable id for the error/hint container. Pair with `aria-describedby` (already resolved as `ariaDescribedBy`). Always populated by AsField. */
+  errorId: string;
+  /** Stable id for the description container. Always populated by AsField. */
+  descId: string;
+  /** Pre-resolved `aria-describedby` target — `errorId` when error/hint is present, else `descId`, else `undefined`. */
+  ariaDescribedBy?: string;
+  /**
+   * Resolved currency code (post-sibling resolution).
+   *
+   * Resolution chain at AsField: `@db.amount.currency 'EUR'` literal →
+   * `@db.amount.currency.ref 'fieldName'` sibling-field read → `undefined`.
+   * Useful for tooltips/titles (e.g. hovering an AsDecimal shell shows
+   * "USD"). Note: when `prefix` is also resolved from currency, the
+   * `currencyCode` here is the symbolic identifier; `prefix` carries
+   * the locale-aware narrow symbol.
+   */
+  currencyCode?: string;
+  /**
+   * Resolved unit-of-measure code (post-sibling resolution).
+   *
+   * Resolution chain at AsField: `@db.unit 'kg'` literal →
+   * `@db.unit.ref 'fieldName'` sibling-field read → `undefined`. Useful
+   * for tooltips. Note: when `suffix` is also resolved from `@db.unit*`,
+   * `unitCode` and `suffix` carry the same string.
+   */
+  unitCode?: string;
+  /**
+   * Decimal scale storage cap (the DB column's fractional-digit limit) —
+   * raw second arg of `@db.column.precision precision, scale`. The
+   * composables pad outgoing strings to this; for display, use `scale`
+   * (which may be tighter due to currency natural digits).
+   */
+  precisionScale?: number;
+  /**
+   * Resolved input prefix adornment.
+   *
+   * Resolution chain at AsField: explicit `@ui.form.prefix 'value'` →
+   * `@ui.form.prefix.ref 'fieldName'` sibling-field read → currency
+   * symbol (locale-narrow form, when currency is resolved) → `undefined`.
+   * Applied by AsInput, AsNumber, AsDecimal.
+   */
+  prefix?: string;
+  /**
+   * Resolved input suffix adornment.
+   *
+   * Resolution chain at AsField: explicit `@ui.form.suffix 'value'` →
+   * `@ui.form.suffix.ref 'fieldName'` sibling-field read → unit code
+   * (resolved `unitCode`) → `undefined`. Applied by AsInput, AsNumber,
+   * AsDecimal.
+   */
+  suffix?: string;
+  /**
+   * Effective display scale (fractional digits) — composables enforce
+   * this when editing decimals.
+   *
+   * Resolution: `min(currencyDecimals, precisionScale)` when currency is
+   * resolved, else `currencyDecimals` (currency only), else
+   * `precisionScale` (DB only), else `undefined`. Smaller than
+   * `precisionScale` is fine — storage stays at the DB cap, display
+   * truncates to this.
+   */
+  scale?: number;
+  /**
+   * Whether AsField found at least one adornment-driving annotation on
+   * this field (`@db.amount.currency*`, `@db.unit*`, `@ui.form.prefix*`,
+   * `@ui.form.suffix*`). Used by AsNumber / AsDecimal to keep the
+   * merged-chrome shell visible even when a sibling-ref source is
+   * currently empty — without this flag, the shell would flicker as
+   * the user picks a source value.
+   *
+   * Always populated by AsField; defaults to `false` when no adornment
+   * annotation is present on the prop.
+   */
+  hasAdornment?: boolean;
+}
+/**
+ * Public emits contract for custom field components used with `AsForm` /
+ * `AsField`. Type your `defineEmits` against this interface so the
+ * action-button surface stays compatible with the framework.
+ *
+ * `_V` is reserved for forward-compat with value-typed emits in Phase 4
+ * (e.g. `(e: 'change-value', value: _V)`); the underscore prefix marks it
+ * as deliberately unused under both biome and eslint conventions.
+ *
+ * @typeParam _V - The field value type (reserved for future emits)
+ */
+interface TAsComponentEmits<_V = unknown> {
+  /**
+   * Action invocation — emitted by phantom action buttons. The form
+   * routes the named action through its `@action` handler.
+   */
+  (e: "action", name: string): void;
+}
+/**
+ * Discriminated type for the `change` event emitted by `AsForm`.
+ *
+ * - `'update'` — leaf field value committed (blur)
+ * - `'array-add'` — array item added
+ * - `'array-remove'` — array item removed
+ * - `'union-switch'` — union variant switched
+ */
+type TAsChangeType = "update" | "array-add" | "array-remove" | "union-switch";
+/**
+ * Type-to-component map for `AsForm`. Lists all built-in field types as
+ * required keys and accepts additional custom types via index signature.
+ *
+ * Use {@link createDefaultTypes} to get a pre-built map with all defaults.
+ */
+type TAsTypeComponents = {
+  text: Component;
+  select: Component;
+  radio: Component;
+  checkbox: Component;
+  paragraph: Component;
+  action: Component;
+  object: Component;
+  array: Component;
+  union: Component;
+  tuple: Component;
+  ref: Component;
+  decimal: Component;
+  number: Component;
+  date: Component;
+  datetime: Component;
+  time: Component;
+} & Record<string, Component>;
+/**
+ * Union context provided by `AsUnion` via `UNION_CONTEXT_KEY`.
+ * Consumed by `AsFieldShell` to render the variant picker inline with the
+ * item's own header.
+ */
+interface TAsUnionContext {
+  /** All available union variant branches. */
+  variants: FormUnionVariant[];
+  /** Reactive index of the currently selected variant. */
+  currentIndex: Ref<number>;
+  /** Switch to a different variant (rewrites model data). */
+  changeVariant: (index: number) => void;
+}
+//#endregion
+export { TAsTypeComponents as a, TAsComponentProps as i, TAsChangeType as n, TAsUnionContext as o, TAsComponentEmits as r, TAsBaseComponentProps as t };

package/dist/types-Czm-Gtud.d.mts

@@ -0,0 +1,233 @@
+import { Component, Ref } from "vue";
+import { FormFieldDef, FormUnionVariant, TFormAction, TFormEntryOptions, ValueHelpInfo } from "@atscript/ui";
+
+//#region src/components/types.d.ts
+/**
+ * Shared base props available to all custom form components.
+ */
+interface TAsBaseComponentProps {
+  /** Whether this component is disabled. */
+  disabled?: boolean;
+  /** Whether this component is hidden. */
+  hidden?: boolean;
+}
+/**
+ * Props contract for custom field components used with `AsForm` / `AsField`.
+ *
+ * Implement this interface in your UI components so that `AsField` can pass
+ * all resolved field state (value, label, validation errors, etc.) as props.
+ *
+ * @typeParam V - The field value type
+ * @typeParam TFormData - The full form data object type
+ * @typeParam TFormContext - The external context object type
+ */
+interface TAsComponentProps<V = unknown> extends TAsBaseComponentProps {
+  /** Called on field blur — triggers validation. */
+  onBlur: () => void;
+  /** Validation error message for this field, if any. */
+  error?: string;
+  /** Reactive model wrapping the field value. Bind with `v-model="model.value"`. */
+  model: {
+    value: V;
+  };
+  /** Phantom field display value from `@meta.default` / `@ui.form.fn.value` (paragraphs, actions). `undefined` for data fields. */
+  value?: unknown;
+  /** Resolved field label from `@meta.label` or `@ui.form.fn.label`. */
+  label?: string;
+  /** Resolved field description from `@meta.description` or `@ui.form.fn.description`. */
+  description?: string;
+  /** Resolved hint text from `@ui.form.hint` or `@ui.form.fn.hint`. */
+  hint?: string;
+  /** Resolved placeholder from `@ui.form.placeholder` or `@ui.form.fn.placeholder`. */
+  placeholder?: string;
+  /** Resolved CSS class painting the prefix icon glyph from `@ui.form.prefix.icon`. Consumer manages safelist / preset coverage. Rendered as the leftmost adornment, before the `prefix` text. */
+  prefixIcon?: string;
+  /** Resolved CSS class painting the suffix icon glyph from `@ui.form.suffix.icon`. Consumer manages safelist / preset coverage. Rendered as the rightmost adornment, after the `suffix` text. */
+  suffixIcon?: string;
+  /** CSS class(es) from `@ui.form.classes` or `@ui.form.fn.classes`. */
+  class?: Record<string, boolean> | string;
+  /** Inline styles from `@ui.form.styles` or `@ui.form.fn.styles`. */
+  style?: Record<string, string> | string;
+  /** Whether the field is optional (not required). */
+  optional?: boolean | undefined;
+  /** Toggle an optional field on/off. `true` sets default value; `false` sets `undefined`. Only present when `optional` is true. */
+  onToggleOptional?: (enabled: boolean) => void;
+  /** Whether the field is required (inverse of optional). */
+  required?: boolean | undefined;
+  /** Whether the field is read-only. */
+  readonly?: boolean | undefined;
+  /** The resolved field input type (e.g., `'text'`, `'select'`, `'checkbox'`). */
+  type: string;
+  /** Form action from `@ui.form.action`. Contains the action id and display label. */
+  formAction?: TFormAction;
+  /** The field name (last segment of the dot-separated path). */
+  name?: string;
+  /** The full FormFieldDef for advanced use cases. */
+  field?: FormFieldDef;
+  /** Resolved options for select/radio/checkbox fields. */
+  options?: TFormEntryOptions[];
+  /** Max length constraint from `@expect.maxLength`. */
+  maxLength?: number;
+  /** Autocomplete hint from `@ui.form.autocomplete`. */
+  autocomplete?: string;
+  /** Resolved title from `@ui.form.fn.title` / `@meta.label` for structure/array fields. */
+  title?: string;
+  /** Nesting level for structure/array fields. Root structure is 0, each nested structure/array increments by 1. */
+  level?: number;
+  /** Callback to remove this item from its parent array. Present when rendered inside an array. */
+  onRemove?: () => void;
+  /** Whether removal is allowed (respects minLength constraints). */
+  canRemove?: boolean;
+  /** Label for the remove button (from `@ui.array.remove.label`). */
+  removeLabel?: string;
+  /** Zero-based index when rendered as a direct array item. `undefined` otherwise. */
+  arrayIndex?: number;
+  /** Absolute dotted path to this field inside the form data. Empty string at the root. */
+  path: string;
+  /** Resolved value-help descriptor for FK ref fields (`@db.rel.FK` → `@db.http.path`). */
+  valueHelp?: ValueHelpInfo;
+  /** Singular label for array fields (`@ui.form.label.singular`) — used in "Add <singular>" affordances. */
+  singularLabel?: string;
+  /** Stable input element id, suitable for `<label :for>`. Co-resolved with `errorId` / `descId` so a11y wiring is consistent. Always populated by AsField. */
+  inputId: string;
+  /** Stable id for the error/hint container. Pair with `aria-describedby` (already resolved as `ariaDescribedBy`). Always populated by AsField. */
+  errorId: string;
+  /** Stable id for the description container. Always populated by AsField. */
+  descId: string;
+  /** Pre-resolved `aria-describedby` target — `errorId` when error/hint is present, else `descId`, else `undefined`. */
+  ariaDescribedBy?: string;
+  /**
+   * Resolved currency code (post-sibling resolution).
+   *
+   * Resolution chain at AsField: `@db.amount.currency 'EUR'` literal →
+   * `@db.amount.currency.ref 'fieldName'` sibling-field read → `undefined`.
+   * Useful for tooltips/titles (e.g. hovering an AsDecimal shell shows
+   * "USD"). Note: when `prefix` is also resolved from currency, the
+   * `currencyCode` here is the symbolic identifier; `prefix` carries
+   * the locale-aware narrow symbol.
+   */
+  currencyCode?: string;
+  /**
+   * Resolved unit-of-measure code (post-sibling resolution).
+   *
+   * Resolution chain at AsField: `@db.unit 'kg'` literal →
+   * `@db.unit.ref 'fieldName'` sibling-field read → `undefined`. Useful
+   * for tooltips. Note: when `suffix` is also resolved from `@db.unit*`,
+   * `unitCode` and `suffix` carry the same string.
+   */
+  unitCode?: string;
+  /**
+   * Decimal scale storage cap (the DB column's fractional-digit limit) —
+   * raw second arg of `@db.column.precision precision, scale`. The
+   * composables pad outgoing strings to this; for display, use `scale`
+   * (which may be tighter due to currency natural digits).
+   */
+  precisionScale?: number;
+  /**
+   * Resolved input prefix adornment.
+   *
+   * Resolution chain at AsField: explicit `@ui.form.prefix 'value'` →
+   * `@ui.form.prefix.ref 'fieldName'` sibling-field read → currency
+   * symbol (locale-narrow form, when currency is resolved) → `undefined`.
+   * Applied by AsInput, AsNumber, AsDecimal.
+   */
+  prefix?: string;
+  /**
+   * Resolved input suffix adornment.
+   *
+   * Resolution chain at AsField: explicit `@ui.form.suffix 'value'` →
+   * `@ui.form.suffix.ref 'fieldName'` sibling-field read → unit code
+   * (resolved `unitCode`) → `undefined`. Applied by AsInput, AsNumber,
+   * AsDecimal.
+   */
+  suffix?: string;
+  /**
+   * Effective display scale (fractional digits) — composables enforce
+   * this when editing decimals.
+   *
+   * Resolution: `min(currencyDecimals, precisionScale)` when currency is
+   * resolved, else `currencyDecimals` (currency only), else
+   * `precisionScale` (DB only), else `undefined`. Smaller than
+   * `precisionScale` is fine — storage stays at the DB cap, display
+   * truncates to this.
+   */
+  scale?: number;
+  /**
+   * Whether AsField found at least one adornment-driving annotation on
+   * this field (`@db.amount.currency*`, `@db.unit*`, `@ui.form.prefix*`,
+   * `@ui.form.suffix*`). Used by AsNumber / AsDecimal to keep the
+   * merged-chrome shell visible even when a sibling-ref source is
+   * currently empty — without this flag, the shell would flicker as
+   * the user picks a source value.
+   *
+   * Always populated by AsField; defaults to `false` when no adornment
+   * annotation is present on the prop.
+   */
+  hasAdornment?: boolean;
+}
+/**
+ * Public emits contract for custom field components used with `AsForm` /
+ * `AsField`. Type your `defineEmits` against this interface so the
+ * action-button surface stays compatible with the framework.
+ *
+ * `_V` is reserved for forward-compat with value-typed emits in Phase 4
+ * (e.g. `(e: 'change-value', value: _V)`); the underscore prefix marks it
+ * as deliberately unused under both biome and eslint conventions.
+ *
+ * @typeParam _V - The field value type (reserved for future emits)
+ */
+interface TAsComponentEmits<_V = unknown> {
+  /**
+   * Action invocation — emitted by phantom action buttons. The form
+   * routes the named action through its `@action` handler.
+   */
+  (e: "action", name: string): void;
+}
+/**
+ * Discriminated type for the `change` event emitted by `AsForm`.
+ *
+ * - `'update'` — leaf field value committed (blur)
+ * - `'array-add'` — array item added
+ * - `'array-remove'` — array item removed
+ * - `'union-switch'` — union variant switched
+ */
+type TAsChangeType = "update" | "array-add" | "array-remove" | "union-switch";
+/**
+ * Type-to-component map for `AsForm`. Lists all built-in field types as
+ * required keys and accepts additional custom types via index signature.
+ *
+ * Use {@link createDefaultTypes} to get a pre-built map with all defaults.
+ */
+type TAsTypeComponents = {
+  text: Component;
+  select: Component;
+  radio: Component;
+  checkbox: Component;
+  paragraph: Component;
+  action: Component;
+  object: Component;
+  array: Component;
+  union: Component;
+  tuple: Component;
+  ref: Component;
+  decimal: Component;
+  number: Component;
+  date: Component;
+  datetime: Component;
+  time: Component;
+} & Record<string, Component>;
+/**
+ * Union context provided by `AsUnion` via `UNION_CONTEXT_KEY`.
+ * Consumed by `AsFieldShell` to render the variant picker inline with the
+ * item's own header.
+ */
+interface TAsUnionContext {
+  /** All available union variant branches. */
+  variants: FormUnionVariant[];
+  /** Reactive index of the currently selected variant. */
+  currentIndex: Ref<number>;
+  /** Switch to a different variant (rewrites model data). */
+  changeVariant: (index: number) => void;
+}
+//#endregion
+export { TAsTypeComponents as a, TAsComponentProps as i, TAsChangeType as n, TAsUnionContext as o, TAsComponentEmits as r, TAsBaseComponentProps as t };