@atscript/vue-form 0.1.103 → 0.1.104

package/dist/index.mjs

@@ -1,33 +1,33 @@
 import { h as PATH_PREFIX_KEY, n as useAsUnionVariant, s as DISMISS_EXTERNAL_AT_KEY, t as formatIndexedLabelParts } from "./use-form-context-D6J1WTyG.mjs";
-import { a as useAsFormPatch, i as useAsExternalErrors, n as useAsForm, r as useAsState, t as as_form_default } from "./as-form-OsyP7m-A.mjs";
+import { a as useAsFormPatch, i as useAsExternalErrors, n as useAsForm, r as useAsState, t as as_form_default } from "./as-form-me0zA-52.mjs";
 import { n as provideAsNestedSectionsStore, r as useAsNestedSectionsStore } from "./use-as-nested-sections-store-DVRmG7V0.mjs";
 import { n as useAsValueHelp } from "./use-as-value-help-DrISSxCz.mjs";
-import { n as useAsData, r as useAsField, t as as_field_default } from "./as-field-DLW-csEu.mjs";
+import { n as useAsData, r as useAsField, t as as_field_default } from "./as-field-5rz47opo.mjs";
 import { n as useAsLocale, t as provideAsLocale } from "./use-as-locale-BrFdAgnU.mjs";
-import { t as as_iterator_default } from "./as-iterator-DW7giLlz.mjs";
+import { t as as_iterator_default } from "./as-iterator-BjIF-O-J.mjs";
 import { n as focusNewFocusableAfter, r as useAsFocusFirstAfter, t as focusFirstAfter } from "./focus-after-toggle-Dtl3P6CS.mjs";
 import { t as as_collapsible_default } from "./as-collapsible-DFTzB5Ar.mjs";
-import { t as as_field_shell_default } from "./as-field-shell-BHYEjGcn.mjs";
+import { t as as_field_shell_default } from "./as-field-shell-DLvPV8WS.mjs";
 import { t as useAsDropdown } from "./use-as-dropdown-B2Shb7wn.mjs";
-import { t as as_input_default } from "./as-input-D7aA22Yx.mjs";
-import { t as as_select_default } from "./as-select-Cr00CPKf.mjs";
-import { t as as_multi_select_default } from "./as-multi-select-Bsf4Y_mv.mjs";
-import { t as as_radio_default } from "./as-radio-CFaDbRPe.mjs";
-import { n as useAsTriStateCheckbox, t as as_checkbox_default } from "./as-checkbox-C3i6ZmRk.mjs";
-import { t as as_paragraph_default } from "./as-paragraph-GIGj6UgL.mjs";
-import { t as as_action_default } from "./as-action-BoZtbaXt.mjs";
+import { t as as_input_default } from "./as-input-DF--i7kY.mjs";
+import { t as as_select_default } from "./as-select-C3ukCyGQ.mjs";
+import { t as as_multi_select_default } from "./as-multi-select-mp-aM3LV.mjs";
+import { t as as_radio_default } from "./as-radio-SwpgM1xP.mjs";
+import { n as useAsTriStateCheckbox, t as as_checkbox_default } from "./as-checkbox-DwLRHmXj.mjs";
+import { t as as_paragraph_default } from "./as-paragraph-BP3-0EY4.mjs";
+import { t as as_action_default } from "./as-action-CCjN5EFP.mjs";
 import { t as useAsOptionalAddFlow } from "./use-as-optional-add-flow-B_gr8sX-.mjs";
-import { t as as_object_default } from "./as-object-CN3KZFXO.mjs";
-import { n as useAsArray, t as as_array_default } from "./as-array-4rQYVD9_.mjs";
-import { n as useAsTypeMap, r as useAsUnion, t as as_union_default } from "./as-union-BPlYyGVk.mjs";
-import { n as useAsTuple, t as as_tuple_default } from "./as-tuple-CeJWgP6l.mjs";
-import { t as as_ref_default } from "./as-ref-CNQgr6zE.mjs";
-import { n as useAsDualInput, r as useAsDecimal, t as as_decimal_default } from "./as-decimal-DIO8bD2Y.mjs";
-import { n as useAsNumber, t as as_number_default } from "./as-number-B8MCg-ph.mjs";
-import { t as useAsDate } from "./use-as-date-XLE8HBbo.mjs";
-import { t as as_date_default } from "./as-date-BfISLr-e.mjs";
-import { t as as_datetime_default } from "./as-datetime-F3In2A6l.mjs";
-import { t as as_time_default } from "./as-time-CE2FaqZ3.mjs";
+import { t as as_object_default } from "./as-object-CQMTYtcY.mjs";
+import { n as useAsArray, t as as_array_default } from "./as-array-BGG38Y1L.mjs";
+import { n as useAsTypeMap, r as useAsUnion, t as as_union_default } from "./as-union-DZWgGqqM.mjs";
+import { n as useAsTuple, t as as_tuple_default } from "./as-tuple-CJXpGGKj.mjs";
+import { t as as_ref_default } from "./as-ref-8JnEuan0.mjs";
+import { n as useAsDualInput, r as useAsDecimal, t as as_decimal_default } from "./as-decimal-CQM5OfqB.mjs";
+import { n as useAsNumber, t as as_number_default } from "./as-number-De9zTltV.mjs";
+import { t as useAsDate } from "./use-as-date-B6RGkjjB.mjs";
+import { t as as_date_default } from "./as-date-CfCa2Kp1.mjs";
+import { t as as_datetime_default } from "./as-datetime-B1I_zREk.mjs";
+import { t as as_time_default } from "./as-time-QJ9YiVj9.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

package/dist/{types-BYfe1QEF.d.cts → types-B8aPXWL5.d.cts}

@@ -164,6 +164,19 @@ interface TAsComponentProps<V = unknown> extends TAsBaseComponentProps {
    * annotation is present on the prop.
    */
   hasAdornment?: boolean;
+  /**
+   * Whether this field has changed since the change-tracking baseline.
+   *
+   * `true` only when the enclosing `<AsForm>` has `track-changes` enabled AND
+   * this field's value differs from the baseline; `false` (or absent) when
+   * tracking is off. AsField resolves it from the change list and surfaces it
+   * here so default components — and custom swaps — can drive a visual hook
+   * (the default `AsFieldShell` paints a `data-dirty` attribute from it) without
+   * re-deriving the predicate. Granularity matches the change list: object /
+   * section containers light up via their leaves; whole-array fields exactly;
+   * an array-ITEM field stays `false` (the array container lights up instead).
+   */
+  isDirty?: boolean;
 }
 /**
  * Public emits contract for custom field components used with `AsForm` /

package/dist/{types-CV9ss4UN.d.mts → types-nuUi10Kl.d.mts}

@@ -164,6 +164,19 @@ interface TAsComponentProps<V = unknown> extends TAsBaseComponentProps {
    * annotation is present on the prop.
    */
   hasAdornment?: boolean;
+  /**
+   * Whether this field has changed since the change-tracking baseline.
+   *
+   * `true` only when the enclosing `<AsForm>` has `track-changes` enabled AND
+   * this field's value differs from the baseline; `false` (or absent) when
+   * tracking is off. AsField resolves it from the change list and surfaces it
+   * here so default components — and custom swaps — can drive a visual hook
+   * (the default `AsFieldShell` paints a `data-dirty` attribute from it) without
+   * re-deriving the predicate. Granularity matches the change list: object /
+   * section containers light up via their leaves; whole-array fields exactly;
+   * an array-ITEM field stays `false` (the array container lights up instead).
+   */
+  isDirty?: boolean;
 }
 /**
  * Public emits contract for custom field components used with `AsForm` /

package/dist/{use-as-date-XLE8HBbo.mjs → use-as-date-B6RGkjjB.mjs}

@@ -193,6 +193,10 @@ var as_date_control_default = /* @__PURE__ */ defineComponent({
 			type: Boolean,
 			required: false
 		},
+		isDirty: {
+			type: Boolean,
+			required: false
+		},
 		disabled: {
 			type: Boolean,
 			required: false

package/dist/{use-as-date-DY8b1_V4.cjs → use-as-date-CslHBPmQ.cjs}

@@ -193,6 +193,10 @@ var as_date_control_default = /* @__PURE__ */ (0, vue.defineComponent)({
 			type: Boolean,
 			required: false
 		},
+		isDirty: {
+			type: Boolean,
+			required: false
+		},
 		disabled: {
 			type: Boolean,
 			required: false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/vue-form",
-  "version": "0.1.103",
+  "version": "0.1.104",
   "description": "Type-driven form rendering for Atscript with Vue 3",
   "keywords": [
     "atscript",
@@ -160,11 +160,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/ui": "^0.1.103"
+    "@atscript/ui": "^0.1.104"
   },
   "devDependencies": {
     "@atscript/core": "^0.1.77",
-    "@atscript/db-client": "^0.1.107",
+    "@atscript/db-client": "^0.1.108",
     "@atscript/typescript": "^0.1.77",
     "@tsdown/css": "^0.21.4",
     "@vitejs/plugin-vue": "^6",
@@ -176,13 +176,13 @@
     "vue": "^3",
     "vue-tsc": "~3.2.9",
     "vunor": "^0.2.1",
-    "@atscript/ui-fns": "^0.1.103"
+    "@atscript/ui-fns": "^0.1.104"
   },
   "peerDependencies": {
-    "@atscript/db-client": "^0.1.107",
+    "@atscript/db-client": "^0.1.108",
     "reka-ui": "^2.9.8",
     "vue": "^3",
-    "@atscript/ui-fns": "^0.1.103"
+    "@atscript/ui-fns": "^0.1.104"
   },
   "scripts": {
     "build": "node ../../scripts/gen-exports.mjs && vp pack",

package/dist/as-form.vue-2NZSk1F9.d.mts

@@ -1,285 +0,0 @@
-import { n as TAsChangeType, o as TAsComponentProps, s as TAsTypeComponents } from "./types-CV9ss4UN.mjs";
-import * as vue from "vue";
-import { Component } from "vue";
-import * as _atscript_ui0 from "@atscript/ui";
-import { ClientFactory, FormDef } from "@atscript/ui";
-
-//#region src/composables/types.d.ts
-type TFormRule<TValue, TFormData, TContext> = (v: TValue, data?: TFormData, context?: TContext) => boolean | string;
-interface TFormFieldCallbacks {
-  validate: () => boolean | string;
-  clearErrors: () => void;
-  reset: () => void;
-  setExternalError: (msg?: string) => void;
-}
-interface TFormFieldRegistration {
-  path: () => string;
-  callbacks: TFormFieldCallbacks;
-}
-interface TFormState {
-  firstSubmitHappened: boolean;
-  firstValidation: "on-change" | "touched-on-blur" | "on-blur" | "on-submit" | "none";
-  /**
-   * Fields registered AFTER `firstSubmitHappened` flipped to true. They stay
-   * in this set until either the user edits the field (model watch removes
-   * the id) or the next submit fires (set is cleared). Live validation is
-   * suppressed for these fields so a freshly-added array item doesn't render
-   * red required-field errors before the user has had a chance to type.
-   */
-  freshFields: Set<symbol>;
-  register: (id: symbol, registration: TFormFieldRegistration) => void;
-  unregister: (id: symbol) => void;
-}
-//#endregion
-//#region src/components/as-form.vue.d.ts
-interface Props<TF, TC> {
-  def: FormDef;
-  formData?: TF;
-  formContext?: TC;
-  firstValidation?: TFormState["firstValidation"];
-  components?: Record<string, Component<TAsComponentProps>>;
-  /**
-   * Type-to-component map for field rendering. Maps field types to Vue components.
-   * Must include entries for all built-in field types. Use `createDefaultTypes()`
-   * for a pre-filled map, or supply your own.
-   */
-  types: TAsTypeComponents;
-  errors?: Record<string, string | undefined>;
-  /**
-   * Per-form client factory override. Creates `Client` instances from URL paths
-   * for FK value-help pickers inside this form. Falls back to the app-wide
-   * default (`setDefaultClientFactory`) and then to the built-in `new Client(url)`
-   * factory when unset.
-   */
-  clientFactory?: ClientFactory;
-  /**
-   * Suppress the root field's title rendering. Use when the form is mounted
-   * inside a chrome that already shows the form's `@meta.label` (e.g. a
-   * dialog header). Nested fields keep their own headings.
-   */
-  hideRootTitle?: boolean;
-  /**
-   * Suppress the default submit button. Use when the host chrome owns the
-   * submit affordance (e.g. a dialog footer with its own submit button
-   * wired via HTML5 `<button form="...">`). Vue 3 treats an empty
-   * `<template #form.submit />` as "slot not provided" and falls back to
-   * the default button — this prop is the explicit way to skip it.
-   */
-  hideSubmit?: boolean;
-  /**
-   * When true, freezes the form: the body becomes `inert` (blocks pointer
-   * events + keyboard focus) and a loading overlay paints over the entire
-   * form area. Used by `<AsWfForm>` to lock interaction during a server
-   * round-trip so the user can't edit a field whose response is racing in.
-   * Visual is shared with `<AsTable>`'s query overlay via vunor
-   * `inner-loading`.
-   */
-  loading?: boolean;
-  /**
-   * Enable change tracking. When set, the form captures a deep-clone baseline
-   * of its data and surfaces both a changed-fields list and an `@atscript/db`
-   * patch object. The tracking surface (`isDirty` / `changes` / `getPatch` /
-   * `getChanges`) is spread into every slot AND exposed on the component
-   * instance (template ref → `asForm.value.getPatch()`); descendants read it
-   * with `useAsFormPatch()`. Off by default — zero overhead when unset.
-   */
-  trackChanges?: boolean;
-}
-declare const __VLS_export: <TFormData = any, TFormContext = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-  props: vue.PublicProps & __VLS_PrettifyLocal<Props<TFormData, TFormContext> & {
-    onError?: ((errors: {
-      path: string;
-      message: string;
-    }[]) => any) | undefined;
-    onAction?: ((name: string, data: TFormData) => any) | undefined;
-    onSubmit?: ((data: TFormData) => any) | undefined;
-    "onUnsupported-action"?: ((name: string, data: TFormData) => any) | undefined;
-    onChange?: ((type: TAsChangeType, path: string, value: unknown, formData: TFormData) => any) | undefined;
-  }> & (typeof globalThis extends {
-    __VLS_PROPS_FALLBACK: infer P;
-  } ? P : {});
-  expose: (exposed: vue.ShallowUnwrapRef<{
-    submit: () => void;
-    reset: () => Promise<void>; /** True when `track-changes` is on AND data differs from baseline. */
-    readonly isDirty: boolean; /** Revert-aware per-field change list (empty when tracking is off). */
-    readonly changes: _atscript_ui0.FormFieldChange[]; /** Build the `@atscript/db` patch object on demand (`{}` when off). */
-    getPatch: ((opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>) | (() => {}); /** Build the per-field change list on demand (`[]` when off). */
-    getChanges: () => _atscript_ui0.FormFieldChange[]; /** Re-baseline to current data after a successful save (no-op when off). */
-    rebase: () => void;
-  }>) => void;
-  attrs: any;
-  slots: {
-    'form.header'?: (props: {
-      title: string | undefined;
-      description: string | undefined;
-      data: TFormData;
-      errors: Record<string, string | undefined> | undefined;
-      formError: string | undefined;
-      disabled: boolean;
-      loading: boolean;
-      submitText: string;
-      submit: () => void;
-      reset: () => Promise<void>;
-      clearErrors: () => void;
-      setErrors: (errors: Record<string, string>) => void;
-      dismissError: (path: string) => void;
-      dismissFormError: () => void;
-      formContext: TFormContext | undefined;
-      isDirty: boolean;
-      changes: readonly _atscript_ui0.FormFieldChange[];
-      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
-      getChanges: () => _atscript_ui0.FormFieldChange[];
-    }) => any;
-  } & {
-    'form.before'?: (props: {
-      title: string | undefined;
-      description: string | undefined;
-      data: TFormData;
-      errors: Record<string, string | undefined> | undefined;
-      formError: string | undefined;
-      disabled: boolean;
-      loading: boolean;
-      submitText: string;
-      submit: () => void;
-      reset: () => Promise<void>;
-      clearErrors: () => void;
-      setErrors: (errors: Record<string, string>) => void;
-      dismissError: (path: string) => void;
-      dismissFormError: () => void;
-      formContext: TFormContext | undefined;
-      isDirty: boolean;
-      changes: readonly _atscript_ui0.FormFieldChange[];
-      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
-      getChanges: () => _atscript_ui0.FormFieldChange[];
-    }) => any;
-  } & {
-    'form.after'?: (props: {
-      title: string | undefined;
-      description: string | undefined;
-      data: TFormData;
-      errors: Record<string, string | undefined> | undefined;
-      formError: string | undefined;
-      disabled: boolean;
-      loading: boolean;
-      submitText: string;
-      submit: () => void;
-      reset: () => Promise<void>;
-      clearErrors: () => void;
-      setErrors: (errors: Record<string, string>) => void;
-      dismissError: (path: string) => void;
-      dismissFormError: () => void;
-      formContext: TFormContext | undefined;
-      isDirty: boolean;
-      changes: readonly _atscript_ui0.FormFieldChange[];
-      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
-      getChanges: () => _atscript_ui0.FormFieldChange[];
-    }) => any;
-  } & {
-    'form.error'?: (props: {
-      message: string;
-      dismiss: () => void;
-      title: string | undefined;
-      description: string | undefined;
-      data: TFormData;
-      errors: Record<string, string | undefined> | undefined;
-      formError: string | undefined;
-      disabled: boolean;
-      loading: boolean;
-      submitText: string;
-      submit: () => void;
-      reset: () => Promise<void>;
-      clearErrors: () => void;
-      setErrors: (errors: Record<string, string>) => void;
-      dismissError: (path: string) => void;
-      dismissFormError: () => void;
-      formContext: TFormContext | undefined;
-      isDirty: boolean;
-      changes: readonly _atscript_ui0.FormFieldChange[];
-      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
-      getChanges: () => _atscript_ui0.FormFieldChange[];
-    }) => any;
-  } & {
-    'form.submit'?: (props: {
-      text: string;
-      title: string | undefined;
-      description: string | undefined;
-      data: TFormData;
-      errors: Record<string, string | undefined> | undefined;
-      formError: string | undefined;
-      disabled: boolean;
-      loading: boolean;
-      submitText: string;
-      submit: () => void;
-      reset: () => Promise<void>;
-      clearErrors: () => void;
-      setErrors: (errors: Record<string, string>) => void;
-      dismissError: (path: string) => void;
-      dismissFormError: () => void;
-      formContext: TFormContext | undefined;
-      isDirty: boolean;
-      changes: readonly _atscript_ui0.FormFieldChange[];
-      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
-      getChanges: () => _atscript_ui0.FormFieldChange[];
-    }) => any;
-  } & {
-    'form.footer'?: (props: {
-      title: string | undefined;
-      description: string | undefined;
-      data: TFormData;
-      errors: Record<string, string | undefined> | undefined;
-      formError: string | undefined;
-      disabled: boolean;
-      loading: boolean;
-      submitText: string;
-      submit: () => void;
-      reset: () => Promise<void>;
-      clearErrors: () => void;
-      setErrors: (errors: Record<string, string>) => void;
-      dismissError: (path: string) => void;
-      dismissFormError: () => void;
-      formContext: TFormContext | undefined;
-      isDirty: boolean;
-      changes: readonly _atscript_ui0.FormFieldChange[];
-      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
-      getChanges: () => _atscript_ui0.FormFieldChange[];
-    }) => any;
-  } & {
-    'form.loading'?: (props: {
-      title: string | undefined;
-      description: string | undefined;
-      data: TFormData;
-      errors: Record<string, string | undefined> | undefined;
-      formError: string | undefined;
-      disabled: boolean;
-      loading: boolean;
-      submitText: string;
-      submit: () => void;
-      reset: () => Promise<void>;
-      clearErrors: () => void;
-      setErrors: (errors: Record<string, string>) => void;
-      dismissError: (path: string) => void;
-      dismissFormError: () => void;
-      formContext: TFormContext | undefined;
-      isDirty: boolean;
-      changes: readonly _atscript_ui0.FormFieldChange[];
-      getPatch: (opts?: _atscript_ui0.FormDiffOptions) => Record<string, unknown>;
-      getChanges: () => _atscript_ui0.FormFieldChange[];
-    }) => any;
-  };
-  emit: {
-    (e: "submit", data: TFormData): void;
-    (e: "error", errors: {
-      path: string;
-      message: string;
-    }[]): void;
-    (e: "action", name: string, data: TFormData): void;
-    (e: "unsupported-action", name: string, data: TFormData): void;
-    (e: "change", type: TAsChangeType, path: string, value: unknown, formData: TFormData): void;
-  };
-}>) => vue.VNode & {
-  __ctx?: Awaited<typeof __VLS_setup>;
-};
-declare const _default: typeof __VLS_export;
-type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
-//#endregion
-export { TFormRule as a, TFormFieldRegistration as i, _default as n, TFormState as o, TFormFieldCallbacks as r, Props as t };