@vizejs/ui 0.387.0 → 0.388.0

package/dist/field-WWPaJT1x.d.mts

@@ -0,0 +1,235 @@
+import { n as FieldLabelProps, r as FieldTextProps, t as FieldControlProps } from "./field-wiring-types-Bfyis5hO.mjs";
+import { n as PrimitiveElement, t as PrimitiveAs } from "./primitive-BE2mdUcw.mjs";
+import { a as FormFieldError } from "./form-types-DXwZRLcs.mjs";
+import { ComputedRef } from "vue";
+
+//#region src/families/form/field/field-types.d.ts
+/** State exposed by the Field root default slot. */
+interface FieldRootSlotState {
+  /** Stable id for the consumer-rendered form control. */
+  readonly id: string;
+  /** Normalized HTML form field name. */
+  readonly name: string;
+  /** Whether this field is currently invalid. */
+  readonly invalid: boolean;
+  /** Current normalized errors for this field only. */
+  readonly errors: readonly FormFieldError[];
+  /** First current error message for this field. */
+  readonly errorMessage: string | undefined;
+  /** Attributes to bind to the consumer-rendered form control. */
+  readonly fieldProps: FieldControlProps;
+  /** Attributes bound by FieldLabel. */
+  readonly labelProps: FieldLabelProps;
+  /** Attributes bound by FieldDescription. */
+  readonly descriptionProps: FieldTextProps;
+  /** Attributes bound by FieldErrorMessage. */
+  readonly errorMessageProps: FieldTextProps;
+}
+/** State exposed by FieldLabel's default slot. */
+interface FieldLabelSlotState {
+  /** Stable id for the rendered label element. */
+  readonly id: string;
+  /** Stable id for the labelled control. */
+  readonly for: string;
+  /** Normalized HTML form field name. */
+  readonly name: string;
+  /** Whether this field is currently invalid. */
+  readonly invalid: boolean;
+}
+/** State exposed by FieldDescription's default slot. */
+interface FieldDescriptionSlotState {
+  /** Stable id for the rendered description element. */
+  readonly id: string;
+  /** Normalized HTML form field name. */
+  readonly name: string;
+  /** Whether this field is currently invalid. */
+  readonly invalid: boolean;
+}
+/** State exposed by FieldErrorMessage's default slot. */
+interface FieldErrorMessageSlotState {
+  /** Stable id for the rendered error message element. */
+  readonly id: string;
+  /** Normalized HTML form field name. */
+  readonly name: string;
+  /** Whether this field is currently invalid. */
+  readonly invalid: boolean;
+  /** First current error message for this field. */
+  readonly message: string | undefined;
+  /** Current normalized errors for this field only. */
+  readonly errors: readonly FormFieldError[];
+}
+/** Public instance exposed by Field. */
+interface FieldRootExpose extends FieldRootSlotState {
+  /** Rendered root element or component instance. */
+  readonly element: PrimitiveElement | null;
+}
+/** Public instance exposed by FieldLabel. */
+interface FieldLabelExpose {
+  /** Rendered label element or component instance. */
+  readonly element: PrimitiveElement | null;
+}
+/** Public instance exposed by FieldDescription. */
+interface FieldDescriptionExpose {
+  /** Rendered description element or component instance. */
+  readonly element: PrimitiveElement | null;
+}
+/** Public instance exposed by FieldErrorMessage. */
+interface FieldErrorMessageExpose {
+  /** Rendered error message element or component instance. */
+  readonly element: PrimitiveElement | null;
+  /** Whether this field is currently invalid. */
+  readonly invalid: boolean;
+  /** First current error message for this field. */
+  readonly message: string | undefined;
+}
+//#endregion
+//#region src/families/form/field/field.vue.d.ts
+type __VLS_Props$3 = {
+  /**
+   * Native element, custom element, or component to render.
+   *
+   * @default "div"
+   */
+  readonly as?: PrimitiveAs;
+  /**
+   * Consumer-owned control id. `null` and `undefined` select a deterministic fallback.
+   *
+   * @default undefined
+   */
+  readonly id?: string | null;
+  /**
+   * Normalized HTML form field name.
+   *
+   * @default required
+   */
+  readonly name: string;
+  /**
+   * Full normalized form error list produced by the form helpers.
+   *
+   * @default []
+   */
+  readonly errors?: readonly FormFieldError[];
+  /**
+   * Consumer-owned invalid override. `undefined` derives invalid state from matching errors.
+   *
+   * @default undefined
+   */
+  readonly invalid?: boolean;
+  /**
+   * Whether a FieldDescription is rendered and should join `aria-describedby`.
+   *
+   * @default false
+   */
+  readonly hasDescription?: boolean;
+  /**
+   * Whether a FieldErrorMessage is rendered while invalid and should be referenced.
+   *
+   * @default true
+   */
+  readonly hasErrorMessage?: boolean;
+};
+type __VLS_Slots$3 = {
+  /** Renders the composed field body with ids, ARIA props, and normalized field state. */default(props: FieldRootSlotState): unknown;
+};
+declare const __VLS_base$3: import("vue").DefineComponent<__VLS_Props$3, {
+  descriptionProps: ComputedRef<FieldTextProps>;
+  element: Readonly<import("vue").ShallowRef<PrimitiveElement | null>>;
+  errorMessage: ComputedRef<string | undefined>;
+  errorMessageProps: ComputedRef<FieldTextProps>;
+  errors: ComputedRef<readonly FormFieldError[]>;
+  fieldProps: ComputedRef<FieldControlProps>;
+  id: ComputedRef<string>;
+  invalid: ComputedRef<boolean>;
+  labelProps: ComputedRef<FieldLabelProps>;
+  name: ComputedRef<string>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "invalid-change": (invalid: boolean, errors: readonly FormFieldError[]) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props$3> & Readonly<{
+  "onInvalid-change"?: (invalid: boolean, errors: readonly FormFieldError[]) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$3: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
+declare const _default$3: typeof __VLS_export$3;
+type __VLS_WithSlots$3<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/families/form/field/field-description.vue.d.ts
+type __VLS_Props$2 = {
+  /**
+   * Native element, custom element, or component to render.
+   *
+   * @default "p"
+   */
+  readonly as?: PrimitiveAs;
+};
+type __VLS_Slots$2 = {
+  /** Renders descriptive help text with the resolved description id. */default(props: FieldDescriptionSlotState): unknown;
+};
+declare const __VLS_base$2: import("vue").DefineComponent<__VLS_Props$2, {
+  element: Readonly<import("vue").ShallowRef<PrimitiveElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props$2> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$2: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
+declare const _default$2: typeof __VLS_export$2;
+type __VLS_WithSlots$2<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/families/form/field/field-error-message.vue.d.ts
+type __VLS_Props$1 = {
+  /**
+   * Native element, custom element, or component to render.
+   *
+   * @default "p"
+   */
+  readonly as?: PrimitiveAs;
+  /**
+   * Keep the error message element in the DOM while the field is valid.
+   *
+   * @default false
+   */
+  readonly forceMount?: boolean;
+};
+type __VLS_Slots$1 = {
+  /** Renders validation text with the resolved error id and current field errors. */default(props: FieldErrorMessageSlotState): unknown;
+};
+declare const __VLS_base$1: import("vue").DefineComponent<__VLS_Props$1, {
+  element: Readonly<import("vue").ShallowRef<PrimitiveElement | null>>;
+  invalid: ComputedRef<boolean>;
+  message: ComputedRef<string | undefined>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props$1> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
+declare const _default$1: typeof __VLS_export$1;
+type __VLS_WithSlots$1<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/families/form/field/field-label.vue.d.ts
+type __VLS_Props = {
+  /**
+   * Native element, custom element, or component to render.
+   *
+   * @default "label"
+   */
+  readonly as?: PrimitiveAs;
+};
+type __VLS_Slots = {
+  /** Renders visible label content with the resolved label and control ids. */default(props: FieldLabelSlotState): unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
+  element: Readonly<import("vue").ShallowRef<PrimitiveElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { FieldDescriptionExpose as a, FieldErrorMessageSlotState as c, FieldRootExpose as d, FieldRootSlotState as f, _default$3 as i, FieldLabelExpose as l, _default$1 as n, FieldDescriptionSlotState as o, _default$2 as r, FieldErrorMessageExpose as s, _default as t, FieldLabelSlotState as u };

package/dist/field-wiring-9Fy-G1rf.d.mts

@@ -0,0 +1,14 @@
+import { a as FieldWiringOptions, i as FieldWiringController } from "./field-wiring-types-Bfyis5hO.mjs";
+
+//#region src/families/form/field-wiring/field-wiring-runtime.d.ts
+/**
+ * Wire one form control to its accessible name, description, and error message.
+ *
+ * All four ids derive from one deterministic control id, so server and client
+ * renders agree. `aria-errormessage` only applies while the control is invalid,
+ * and the error id also joins `aria-describedby` for assistive technology
+ * without `aria-errormessage` support.
+ */
+declare function useFieldWiring(options?: FieldWiringOptions): FieldWiringController;
+//#endregion
+export { useFieldWiring as t };

package/dist/field-wiring-runtime-fQ3GoLuG.mjs

@@ -0,0 +1,64 @@
+import { a as useDeterministicId, n as deriveDeterministicId } from "./deterministic-id-yMq4HfmS.mjs";
+import { computed, getCurrentInstance, toValue } from "vue";
+//#region src/families/form/field-wiring/field-wiring-runtime.ts
+const invalidOptionDiagnostic = "VIZE_UI_FIELD_WIRING_OPTION";
+const setupDiagnostic = "VIZE_UI_FIELD_WIRING_SETUP";
+function readBoolean(value, name, fallback) {
+	const resolved = toValue(value);
+	if (resolved === void 0) return fallback;
+	if (typeof resolved !== "boolean") throw new TypeError(`${invalidOptionDiagnostic}: ${name} must resolve to a boolean`);
+	return resolved;
+}
+/**
+* Wire one form control to its accessible name, description, and error message.
+*
+* All four ids derive from one deterministic control id, so server and client
+* renders agree. `aria-errormessage` only applies while the control is invalid,
+* and the error id also joins `aria-describedby` for assistive technology
+* without `aria-errormessage` support.
+*/
+function useFieldWiring(options = {}) {
+	if (getCurrentInstance() === null) throw new Error(`${setupDiagnostic}: useFieldWiring() must run during component setup`);
+	for (const name of [
+		"invalid",
+		"hasDescription",
+		"hasErrorMessage"
+	]) if (typeof options[name] !== "function") readBoolean(options[name], name, false);
+	const fieldId = useDeterministicId({
+		id: options.id,
+		hint: "field"
+	});
+	const labelId = computed(() => deriveDeterministicId(fieldId.value, "label"));
+	const descriptionId = computed(() => deriveDeterministicId(fieldId.value, "description"));
+	const errorMessageId = computed(() => deriveDeterministicId(fieldId.value, "error"));
+	const isInvalid = computed(() => readBoolean(options.invalid, "invalid", false));
+	const showsError = computed(() => isInvalid.value && readBoolean(options.hasErrorMessage, "hasErrorMessage", true));
+	const describedBy = computed(() => {
+		const ids = [];
+		if (readBoolean(options.hasDescription, "hasDescription", false)) ids.push(descriptionId.value);
+		if (showsError.value) ids.push(errorMessageId.value);
+		return ids.length === 0 ? void 0 : ids.join(" ");
+	});
+	return Object.freeze({
+		fieldId,
+		labelId,
+		descriptionId,
+		errorMessageId,
+		isInvalid,
+		labelProps: computed(() => ({
+			id: labelId.value,
+			for: fieldId.value
+		})),
+		fieldProps: computed(() => ({
+			id: fieldId.value,
+			"aria-labelledby": labelId.value,
+			"aria-describedby": describedBy.value,
+			"aria-errormessage": showsError.value ? errorMessageId.value : void 0,
+			"aria-invalid": isInvalid.value ? "true" : void 0
+		})),
+		descriptionProps: computed(() => ({ id: descriptionId.value })),
+		errorMessageProps: computed(() => ({ id: errorMessageId.value }))
+	});
+}
+//#endregion
+export { useFieldWiring as t };

package/dist/field-wiring-types-Bfyis5hO.d.mts

@@ -0,0 +1,73 @@
+import { t as DeterministicId } from "./deterministic-id-DYQJ7KzM.mjs";
+import { ComputedRef, MaybeRefOrGetter } from "vue";
+
+//#region src/families/form/field-wiring/field-wiring-types.d.ts
+/** Options accepted by {@link useFieldWiring}. */
+interface FieldWiringOptions {
+  /**
+   * Consumer-owned control id. `null` and `undefined` select the generated
+   * deterministic fallback.
+   *
+   * @default undefined
+   */
+  readonly id?: MaybeRefOrGetter<string | null | undefined>;
+  /**
+   * Whether the field currently fails validation.
+   *
+   * @default false
+   */
+  readonly invalid?: MaybeRefOrGetter<boolean | undefined>;
+  /**
+   * Whether a description element is rendered with `descriptionProps`.
+   *
+   * @default false
+   */
+  readonly hasDescription?: MaybeRefOrGetter<boolean | undefined>;
+  /**
+   * Whether an error message element is rendered with `errorMessageProps`
+   * while the field is invalid.
+   *
+   * @default true
+   */
+  readonly hasErrorMessage?: MaybeRefOrGetter<boolean | undefined>;
+}
+/** Attributes for the label element naming the control. */
+interface FieldLabelProps {
+  readonly id: string;
+  readonly for: string;
+}
+/** Attributes for the labelled form control. */
+interface FieldControlProps {
+  readonly id: string;
+  readonly "aria-labelledby": string;
+  readonly "aria-describedby": string | undefined;
+  readonly "aria-errormessage": string | undefined;
+  readonly "aria-invalid": "true" | undefined;
+}
+/** Attributes for a description or error message element. */
+interface FieldTextProps {
+  readonly id: string;
+}
+/** Accessible name, description, and error message wiring for one field. */
+interface FieldWiringController {
+  /** Stable id of the form control. */
+  readonly fieldId: ComputedRef<DeterministicId>;
+  /** Stable id of the label element. */
+  readonly labelId: ComputedRef<DeterministicId>;
+  /** Stable id of the description element. */
+  readonly descriptionId: ComputedRef<DeterministicId>;
+  /** Stable id of the error message element. */
+  readonly errorMessageId: ComputedRef<DeterministicId>;
+  /** Whether the control is currently marked invalid. */
+  readonly isInvalid: ComputedRef<boolean>;
+  /** Bind to the label element. */
+  readonly labelProps: ComputedRef<FieldLabelProps>;
+  /** Bind to the form control. */
+  readonly fieldProps: ComputedRef<FieldControlProps>;
+  /** Bind to the description element. */
+  readonly descriptionProps: ComputedRef<FieldTextProps>;
+  /** Bind to the error message element. */
+  readonly errorMessageProps: ComputedRef<FieldTextProps>;
+}
+//#endregion
+export { FieldWiringOptions as a, FieldWiringController as i, FieldLabelProps as n, FieldTextProps as r, FieldControlProps as t };

package/dist/field-wiring.d.mts

@@ -0,0 +1,3 @@
+import { a as FieldWiringOptions, i as FieldWiringController, n as FieldLabelProps, r as FieldTextProps, t as FieldControlProps } from "./field-wiring-types-Bfyis5hO.mjs";
+import { t as useFieldWiring } from "./field-wiring-9Fy-G1rf.mjs";
+export { type FieldControlProps, type FieldLabelProps, type FieldTextProps, type FieldWiringController, type FieldWiringOptions, useFieldWiring };

package/dist/field-wiring.mjs

@@ -0,0 +1,2 @@
+import { t as useFieldWiring } from "./field-wiring-runtime-fQ3GoLuG.mjs";
+export { useFieldWiring };

package/dist/field.d.mts

@@ -0,0 +1,2 @@
+import { a as FieldDescriptionExpose, c as FieldErrorMessageSlotState, d as FieldRootExpose, f as FieldRootSlotState, i as _default, l as FieldLabelExpose, n as _default$2, o as FieldDescriptionSlotState, r as _default$1, s as FieldErrorMessageExpose, t as _default$3, u as FieldLabelSlotState } from "./field-WWPaJT1x.mjs";
+export { _default as Field, _default as FieldRoot, _default$1 as FieldDescription, type FieldDescriptionExpose, type FieldDescriptionSlotState, _default$2 as FieldErrorMessage, type FieldErrorMessageExpose, type FieldErrorMessageSlotState, _default$3 as FieldLabel, type FieldLabelExpose, type FieldLabelSlotState, type FieldRootExpose, type FieldRootSlotState };

package/dist/field.mjs

@@ -0,0 +1,2 @@
+import { i as field_default, n as field_error_message_default, r as field_description_default, t as field_label_default } from "./field-CBs2-Z9B.mjs";
+export { field_default as Field, field_default as FieldRoot, field_description_default as FieldDescription, field_error_message_default as FieldErrorMessage, field_label_default as FieldLabel };

package/dist/{focus-CAWi_I-0.mjs → focus-XxVWOwbs.mjs}

@@ -1,6 +1,6 @@
-import { n as isElementFocusVisible, t as createInteractionModalityTracker } from "./interaction-modality-DOZK0BpZ.mjs";
+import { n as isElementFocusVisible, t as createInteractionModalityTracker } from "./interaction-modality-BHnjtU4S.mjs";
 import { getCurrentScope, isRef, onScopeDispose, shallowReadonly, shallowRef, toValue, watch } from "vue";
-//#region src/focus-internal.ts
+//#region src/families/accessibility/focus/focus-internal.ts
 const invalidOptionDiagnostic = "VIZE_UI_FOCUS_OPTION";
 const invalidTargetDiagnostic = "VIZE_UI_FOCUS_TARGET";
 function capture(errors, callback) {
@@ -97,7 +97,7 @@ function createFocusEvent(type, mode, host, focusedTarget, relatedTarget, origin
 	});
 }
 //#endregion
-//#region src/focus.ts
+//#region src/families/accessibility/focus/focus.ts
 const disposedDiagnostic = "VIZE_UI_FOCUS_DISPOSED";
 const setupDiagnostic = "VIZE_UI_FOCUS_SETUP";
 function installSettlementObserver(mode, host, settle) {

package/dist/{focus-K6dOifoZ.d.mts → focus-eObxGOtP.d.mts}

@@ -1,6 +1,6 @@
 import { MaybeRefOrGetter, ShallowRef } from "vue";
 
-//#region src/focus-types.d.ts
+//#region src/families/accessibility/focus/focus-types.d.ts
 /** Scope used to determine whether a host owns the focused element. */
 type FocusMode = "target" | "within";
 /** Why a focus observer entered or left its active state. */
@@ -95,7 +95,7 @@ interface FocusController {
 /** Direct-target controller returned by {@link createFocusRing}. */
 type FocusRingController = FocusController;
 //#endregion
-//#region src/focus.d.ts
+//#region src/families/accessibility/focus/focus.d.ts
 /** Create an SSR-safe observer for direct or composed-descendant focus. */
 declare function createFocus(options?: FocusOptions): FocusController;
 /** Observe composed-descendant focus ownership. */

package/dist/{focus-guards-Bt0C-0qS.d.mts → focus-guards-BZa7vm6O.d.mts}

@@ -1,6 +1,6 @@
 import { CSSProperties, MaybeRefOrGetter, ShallowRef } from "vue";
 
-//#region src/focus-guards-types.d.ts
+//#region src/families/accessibility/focus-guards/focus-guards-types.d.ts
 /** Logical sentinel position around a guarded focus region. */
 type FocusGuardPosition = "after" | "before";
 /** Direction in which a sentinel redirects sequential focus. */
@@ -59,7 +59,7 @@ interface FocusGuardsController {
 /** Optional zero-CSS visual preset for consumer-rendered sentinels. */
 type FocusGuardStylePreset = Readonly<CSSProperties>;
 //#endregion
-//#region src/focus-guards.d.ts
+//#region src/families/accessibility/focus-guards/focus-guards.d.ts
 /** Optional invisible sentinel preset; consumers remain free to replace every value. */
 declare const focusGuardPreset: Readonly<{
   blockSize: string;

package/dist/{focus-guards-DhMPQAT8.mjs → focus-guards-DSxiemx7.mjs}

@@ -1,6 +1,6 @@
-import { a as focusableElements, c as documentOrder, i as focusElement, o as isUsableTarget, p as surfaceErrors, s as capture, t as containsComposed } from "./focus-scope-dom-DBwNEWxG.mjs";
+import { a as focusableElements, c as documentOrder, i as focusElement, o as isUsableTarget, p as surfaceErrors, s as capture, t as containsComposed } from "./focus-scope-dom-L_EC5GsX.mjs";
 import { getCurrentInstance, getCurrentScope, onMounted, onScopeDispose, shallowReadonly, shallowRef, toValue, watch } from "vue";
-//#region src/focus-guards-internal.ts
+//#region src/families/accessibility/focus-guards/focus-guards-internal.ts
 const optionDiagnostic = "VIZE_UI_FOCUS_GUARDS_OPTION";
 /** Resolve an event target without relying on the current realm's Element constructor. */
 function eventElement(value) {
@@ -68,7 +68,7 @@ function createRedirectEvent(position, direction, reason, target, relatedTarget,
 	});
 }
 //#endregion
-//#region src/focus-guards-stack.ts
+//#region src/families/accessibility/focus-guards/focus-guards-stack.ts
 const documentStacks = /* @__PURE__ */ new WeakMap();
 function stackFor(document) {
 	let stack = documentStacks.get(document);
@@ -119,7 +119,7 @@ function detachFocusGuards(token) {
 	else recomputeFocusGuards(document);
 }
 //#endregion
-//#region src/focus-guards.ts
+//#region src/families/accessibility/focus-guards/focus-guards.ts
 const disposedDiagnostic = "VIZE_UI_FOCUS_GUARDS_DISPOSED";
 const rootDiagnostic = "VIZE_UI_FOCUS_GUARDS_ROOT";
 const setupDiagnostic = "VIZE_UI_FOCUS_GUARDS_SETUP";

package/dist/focus-guards.d.mts

@@ -1,2 +1,2 @@
-import { a as FocusGuardPosition, c as FocusGuardRedirectEvent, d as FocusGuardsOptions, i as FocusGuardDirection, l as FocusGuardStylePreset, n as focusGuardPreset, o as FocusGuardProps, r as useFocusGuards, s as FocusGuardReason, t as createFocusGuards, u as FocusGuardsController } from "./focus-guards-Bt0C-0qS.mjs";
+import { a as FocusGuardPosition, c as FocusGuardRedirectEvent, d as FocusGuardsOptions, i as FocusGuardDirection, l as FocusGuardStylePreset, n as focusGuardPreset, o as FocusGuardProps, r as useFocusGuards, s as FocusGuardReason, t as createFocusGuards, u as FocusGuardsController } from "./focus-guards-BZa7vm6O.mjs";
 export { type FocusGuardDirection, type FocusGuardPosition, type FocusGuardProps, type FocusGuardReason, type FocusGuardRedirectEvent, type FocusGuardStylePreset, type FocusGuardsController, type FocusGuardsOptions, createFocusGuards, focusGuardPreset, useFocusGuards };

package/dist/focus-guards.mjs

@@ -1,2 +1,2 @@
-import { n as focusGuardPreset, r as useFocusGuards, t as createFocusGuards } from "./focus-guards-DhMPQAT8.mjs";
+import { n as focusGuardPreset, r as useFocusGuards, t as createFocusGuards } from "./focus-guards-DSxiemx7.mjs";
 export { createFocusGuards, focusGuardPreset, useFocusGuards };

package/dist/{focus-scope-CavhKWx0.d.mts → focus-scope-CsnioDR4.d.mts}

@@ -1,6 +1,6 @@
 import { MaybeRefOrGetter, ShallowRef } from "vue";
 
-//#region src/focus-scope-types.d.ts
+//#region src/families/accessibility/focus-scope/focus-scope-types.d.ts
 /** Preventable lifecycle notification for automatic focus movement. */
 interface FocusScopeAutoFocusEvent {
   readonly type: "mount" | "unmount";
@@ -89,11 +89,11 @@ interface FocusScopeController extends FocusScopeManager {
   readonly dispose: () => void;
 }
 //#endregion
-//#region src/use-focus-scope.d.ts
+//#region src/families/accessibility/focus-scope/use-focus-scope.d.ts
 /** Create, mount-activate, and scope-dispose a focus scope from Vue setup. */
 declare function useFocusScope(options: FocusScopeOptions): FocusScopeController;
 //#endregion
-//#region src/focus-scope.d.ts
+//#region src/families/accessibility/focus-scope/focus-scope.d.ts
 /** Create an SSR-safe focus scope with containment, traversal, and restoration. */
 declare function createFocusScope(options: FocusScopeOptions): FocusScopeController;
 //#endregion

package/dist/{focus-scope-dom-DBwNEWxG.mjs → focus-scope-dom-L_EC5GsX.mjs}

@@ -1,5 +1,5 @@
 import { toValue } from "vue";
-//#region src/focus-scope-internal.ts
+//#region src/families/accessibility/focus-scope/focus-scope-internal.ts
 const optionDiagnostic = "VIZE_UI_FOCUS_SCOPE_OPTION";
 const rootDiagnostic = "VIZE_UI_FOCUS_SCOPE_ROOT";
 function capture(errors, callback) {
@@ -91,7 +91,7 @@ function documentOrder(elements) {
 	});
 }
 //#endregion
-//#region src/focus-scope-dom.ts
+//#region src/families/accessibility/focus-scope/focus-scope-dom.ts
 const focusableSelector = [
 	"a[href]",
 	"area[href]",

package/dist/{focus-scope-D9U1aj67.mjs → focus-scope-mEg8UoeE.mjs}

@@ -1,6 +1,6 @@
-import { a as focusableElements, c as documentOrder, d as readTarget, f as resolveMoveOptions, i as focusElement, l as readBoolean, m as validateOptions, n as createAutoFocusEvent, o as isUsableTarget, p as surfaceErrors, r as deepActiveElement, s as capture, t as containsComposed, u as readRoot } from "./focus-scope-dom-DBwNEWxG.mjs";
+import { a as focusableElements, c as documentOrder, d as readTarget, f as resolveMoveOptions, i as focusElement, l as readBoolean, m as validateOptions, n as createAutoFocusEvent, o as isUsableTarget, p as surfaceErrors, r as deepActiveElement, s as capture, t as containsComposed, u as readRoot } from "./focus-scope-dom-L_EC5GsX.mjs";
 import { getCurrentInstance, getCurrentScope, onMounted, onScopeDispose, shallowReadonly, shallowRef, toValue, watch } from "vue";
-//#region src/focus-scope-manager.ts
+//#region src/families/accessibility/focus-scope/focus-scope-manager.ts
 /** Create stable traversal methods while keeping controller lifecycle orchestration focused. */
 function createFocusScopeManager({ assertAlive, list, root }) {
 	const move = (position, values) => {
@@ -29,7 +29,7 @@ function createFocusScopeManager({ assertAlive, list, root }) {
 	});
 }
 //#endregion
-//#region src/focus-scope-stack.ts
+//#region src/families/accessibility/focus-scope/focus-scope-stack.ts
 const documentScopes = /* @__PURE__ */ new WeakMap();
 function scopesFor(document) {
 	let scopes = documentScopes.get(document);
@@ -85,7 +85,7 @@ function parentScope(token) {
 	return index > 0 ? scopes[index - 1] ?? null : null;
 }
 //#endregion
-//#region src/use-focus-scope.ts
+//#region src/families/accessibility/focus-scope/use-focus-scope.ts
 const setupDiagnostic = "VIZE_UI_FOCUS_SCOPE_SETUP";
 /** Create, mount-activate, and scope-dispose a focus scope from Vue setup. */
 function useFocusScope(options) {
@@ -97,7 +97,7 @@ function useFocusScope(options) {
 	return controller;
 }
 //#endregion
-//#region src/focus-scope.ts
+//#region src/families/accessibility/focus-scope/focus-scope.ts
 const disposedDiagnostic = "VIZE_UI_FOCUS_SCOPE_DISPOSED";
 const rootDiagnostic = "VIZE_UI_FOCUS_SCOPE_ROOT";
 /** Create an SSR-safe focus scope with containment, traversal, and restoration. */

package/dist/focus-scope.d.mts

@@ -1,2 +1,2 @@
-import { a as FocusScopeManager, i as FocusScopeController, n as useFocusScope, o as FocusScopeMoveOptions, r as FocusScopeAutoFocusEvent, s as FocusScopeOptions, t as createFocusScope } from "./focus-scope-CavhKWx0.mjs";
+import { a as FocusScopeManager, i as FocusScopeController, n as useFocusScope, o as FocusScopeMoveOptions, r as FocusScopeAutoFocusEvent, s as FocusScopeOptions, t as createFocusScope } from "./focus-scope-CsnioDR4.mjs";
 export { type FocusScopeAutoFocusEvent, type FocusScopeController, type FocusScopeManager, type FocusScopeMoveOptions, type FocusScopeOptions, createFocusScope, useFocusScope };

package/dist/focus-scope.mjs

@@ -1,2 +1,2 @@
-import { n as useFocusScope, t as createFocusScope } from "./focus-scope-D9U1aj67.mjs";
+import { n as useFocusScope, t as createFocusScope } from "./focus-scope-mEg8UoeE.mjs";
 export { createFocusScope, useFocusScope };

package/dist/focus.d.mts

@@ -1,2 +1,2 @@
-import { a as useFocusRing, c as FocusController, d as FocusOptions, f as FocusProps, h as FocusWithinOptions, i as useFocus, l as FocusEvent, m as FocusRingOptions, n as createFocusRing, o as useFocusWithin, p as FocusRingController, r as createFocusWithin, s as FocusChangeReason, t as createFocus, u as FocusMode } from "./focus-K6dOifoZ.mjs";
+import { a as useFocusRing, c as FocusController, d as FocusOptions, f as FocusProps, h as FocusWithinOptions, i as useFocus, l as FocusEvent, m as FocusRingOptions, n as createFocusRing, o as useFocusWithin, p as FocusRingController, r as createFocusWithin, s as FocusChangeReason, t as createFocus, u as FocusMode } from "./focus-eObxGOtP.mjs";
 export { type FocusChangeReason, type FocusController, type FocusEvent, type FocusMode, type FocusOptions, type FocusProps, type FocusRingController, type FocusRingOptions, type FocusWithinOptions, createFocus, createFocusRing, createFocusWithin, useFocus, useFocusRing, useFocusWithin };

package/dist/focus.mjs

@@ -1,2 +1,2 @@
-import { a as useFocusRing, i as useFocus, n as createFocusRing, o as useFocusWithin, r as createFocusWithin, t as createFocus } from "./focus-CAWi_I-0.mjs";
+import { a as useFocusRing, i as useFocus, n as createFocusRing, o as useFocusWithin, r as createFocusWithin, t as createFocus } from "./focus-XxVWOwbs.mjs";
 export { createFocus, createFocusRing, createFocusWithin, useFocus, useFocusRing, useFocusWithin };

package/dist/form-1V2V30Sv.d.mts

@@ -0,0 +1,20 @@
+import { n as ErrorSummaryField } from "./error-summary-types-5ePaC9O3.mjs";
+import { a as FormFieldError, c as FormPathKey, f as StandardSchemaV1, i as FormFieldController, n as FormErrorSummaryFieldOptions, o as FormFieldErrorOptions, p as StandardSchemaValidationOptions, r as FormErrorSummaryOptions, s as FormFieldOptions, t as FormErrorSummaryController, u as FormValidationResult } from "./form-types-DXwZRLcs.mjs";
+
+//#region src/families/form/form/form-runtime.d.ts
+/** Convert a Standard Schema issue path into a conventional HTML field name. */
+declare function formatFormFieldName(path: readonly FormPathKey[]): string;
+/** Convert Standard Schema issues into normalized field errors. */
+declare function normalizeStandardSchemaIssues(issues: readonly StandardSchemaV1.Issue[], options?: FormFieldErrorOptions): readonly FormFieldError[];
+/** Convert normalized field errors into unique fields for the error summary. */
+declare function createFormErrorSummaryFields(errors: readonly FormFieldError[], options?: FormErrorSummaryFieldOptions): readonly ErrorSummaryField[];
+/** Normalize a Standard Schema validation result for form fields and summaries. */
+declare function normalizeStandardSchemaResult<Output>(result: StandardSchemaV1.Result<Output>, options?: StandardSchemaValidationOptions): FormValidationResult<Output>;
+/** Validate a Standard Schema and normalize the result for form consumers. */
+declare function validateStandardSchema<Input, Output>(schema: StandardSchemaV1<Input, Output>, value: Input, options?: StandardSchemaValidationOptions): Promise<FormValidationResult<Output>>;
+/** Create normalized field state whose invalid flag can feed existing field wiring. */
+declare function useFormField(options: FormFieldOptions): FormFieldController;
+/** Create error-summary fields from normalized form errors. */
+declare function useFormErrorSummary(options?: FormErrorSummaryOptions): FormErrorSummaryController;
+//#endregion
+export { useFormErrorSummary as a, normalizeStandardSchemaResult as i, formatFormFieldName as n, useFormField as o, normalizeStandardSchemaIssues as r, validateStandardSchema as s, createFormErrorSummaryFields as t };