@atscript/vue-form 0.1.58

package/dist/as-form.vue-DRrb_yoj.d.mts

@@ -0,0 +1,158 @@
+import { a as TAsTypeComponents, i as TAsComponentProps, n as TAsChangeType } from "./types-Czm-Gtud.mjs";
+import * as vue from "vue";
+import { Component } from "vue";
+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;
+}
+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: {}) => void;
+  attrs: any;
+  slots: {
+    'form.header'?: (props: {
+      clearErrors: () => void;
+      reset: () => Promise<void>;
+      setErrors: (errors: Record<string, string>) => void;
+      formContext: TFormContext | undefined;
+      disabled: boolean;
+    }) => any;
+  } & {
+    'form.before'?: (props: {
+      clearErrors: () => void;
+      reset: () => Promise<void>;
+      setErrors: (errors: Record<string, string>) => void;
+      formContext: TFormContext | undefined;
+      disabled: boolean;
+    }) => any;
+  } & {
+    'form.after'?: (props: {
+      clearErrors: () => void;
+      reset: () => Promise<void>;
+      setErrors: (errors: Record<string, string>) => void;
+      disabled: boolean;
+      formContext: TFormContext | undefined;
+    }) => any;
+  } & {
+    'form.error'?: (props: {
+      message: string;
+      dismiss: () => void;
+    }) => any;
+  } & {
+    'form.submit'?: (props: {
+      disabled: boolean;
+      text: string;
+      clearErrors: () => void;
+      reset: () => Promise<void>;
+      setErrors: (errors: Record<string, string>) => void;
+      formContext: TFormContext | undefined;
+    }) => any;
+  } & {
+    'form.footer'?: (props: {
+      disabled: boolean;
+      clearErrors: () => void;
+      reset: () => Promise<void>;
+      setErrors: (errors: Record<string, string>) => void;
+      formContext: TFormContext | undefined;
+    }) => any;
+  } & {
+    'form.loading'?: (props: {}) => 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 };

package/dist/as-input-CpbV2k3s.cjs

@@ -0,0 +1,231 @@
+const require_as_field_shell = require("./as-field-shell-B2iTn-iM.cjs");
+const require_as_input_control = require("./as-input-control-C5-DelZT.cjs");
+const require_as_adornment_shell = require("./as-adornment-shell-9UmdNIPR.cjs");
+let vue = require("vue");
+//#endregion
+//#region src/components/defaults/as-input.vue
+var as_input_default = /* @__PURE__ */ (0, vue.defineComponent)({
+	__name: "as-input",
+	props: {
+		onBlur: {
+			type: Function,
+			required: true
+		},
+		error: {
+			type: String,
+			required: false
+		},
+		model: {
+			type: Object,
+			required: true
+		},
+		value: {
+			type: null,
+			required: false
+		},
+		label: {
+			type: String,
+			required: false
+		},
+		description: {
+			type: String,
+			required: false
+		},
+		hint: {
+			type: String,
+			required: false
+		},
+		placeholder: {
+			type: String,
+			required: false
+		},
+		prefixIcon: {
+			type: String,
+			required: false
+		},
+		suffixIcon: {
+			type: String,
+			required: false
+		},
+		class: {
+			type: [Object, String],
+			required: false
+		},
+		style: {
+			type: [Object, String],
+			required: false
+		},
+		optional: {
+			type: Boolean,
+			required: false,
+			skipCheck: true
+		},
+		onToggleOptional: {
+			type: Function,
+			required: false
+		},
+		required: {
+			type: Boolean,
+			required: false,
+			skipCheck: true
+		},
+		readonly: {
+			type: Boolean,
+			required: false,
+			skipCheck: true
+		},
+		type: {
+			type: String,
+			required: true
+		},
+		formAction: {
+			type: Object,
+			required: false
+		},
+		name: {
+			type: String,
+			required: false
+		},
+		field: {
+			type: Object,
+			required: false
+		},
+		options: {
+			type: Array,
+			required: false
+		},
+		maxLength: {
+			type: Number,
+			required: false
+		},
+		autocomplete: {
+			type: String,
+			required: false
+		},
+		title: {
+			type: String,
+			required: false
+		},
+		level: {
+			type: Number,
+			required: false
+		},
+		onRemove: {
+			type: Function,
+			required: false
+		},
+		canRemove: {
+			type: Boolean,
+			required: false
+		},
+		removeLabel: {
+			type: String,
+			required: false
+		},
+		arrayIndex: {
+			type: Number,
+			required: false
+		},
+		path: {
+			type: String,
+			required: true
+		},
+		valueHelp: {
+			type: Object,
+			required: false
+		},
+		singularLabel: {
+			type: String,
+			required: false
+		},
+		inputId: {
+			type: String,
+			required: true
+		},
+		errorId: {
+			type: String,
+			required: true
+		},
+		descId: {
+			type: String,
+			required: true
+		},
+		ariaDescribedBy: {
+			type: String,
+			required: false
+		},
+		currencyCode: {
+			type: String,
+			required: false
+		},
+		unitCode: {
+			type: String,
+			required: false
+		},
+		precisionScale: {
+			type: Number,
+			required: false
+		},
+		prefix: {
+			type: String,
+			required: false
+		},
+		suffix: {
+			type: String,
+			required: false
+		},
+		scale: {
+			type: Number,
+			required: false
+		},
+		hasAdornment: {
+			type: Boolean,
+			required: false
+		},
+		disabled: {
+			type: Boolean,
+			required: false
+		},
+		hidden: {
+			type: Boolean,
+			required: false
+		}
+	},
+	setup(__props) {
+		const props = __props;
+		const shellTitle = (0, vue.computed)(() => props.currencyCode ?? props.unitCode ?? void 0);
+		return (_ctx, _cache) => {
+			return (0, vue.openBlock)(), (0, vue.createBlock)(require_as_field_shell.as_field_shell_default, (0, vue.normalizeProps)((0, vue.guardReactiveProps)(_ctx.$props)), {
+				default: (0, vue.withCtx)(({ inputId }) => [__props.hasAdornment ? ((0, vue.openBlock)(), (0, vue.createBlock)(require_as_adornment_shell.as_adornment_shell_default, {
+					key: 0,
+					"prefix-icon": __props.prefixIcon,
+					prefix: __props.prefix,
+					suffix: __props.suffix,
+					"suffix-icon": __props.suffixIcon,
+					error: __props.error,
+					required: __props.required,
+					title: shellTitle.value
+				}, {
+					default: (0, vue.withCtx)(() => [(0, vue.createVNode)(require_as_input_control.as_input_control_default, (0, vue.mergeProps)(_ctx.$props, { "input-id": inputId }), null, 16, ["input-id"])]),
+					_: 2
+				}, 1032, [
+					"prefix-icon",
+					"prefix",
+					"suffix",
+					"suffix-icon",
+					"error",
+					"required",
+					"title"
+				])) : ((0, vue.openBlock)(), (0, vue.createBlock)(require_as_input_control.as_input_control_default, (0, vue.mergeProps)({ key: 1 }, _ctx.$props, { "input-id": inputId }), null, 16, ["input-id"]))]),
+				_: 1
+			}, 16);
+		};
+	}
+});
+//#endregion
+Object.defineProperty(exports, "as_input_default", {
+	enumerable: true,
+	get: function() {
+		return as_input_default;
+	}
+});

package/dist/as-input-DIa8BzLv.mjs

@@ -0,0 +1,226 @@
+import { t as as_field_shell_default } from "./as-field-shell-Pdy3sAvr.mjs";
+import { t as as_input_control_default } from "./as-input-control-BzELjheN.mjs";
+import { t as as_adornment_shell_default } from "./as-adornment-shell-knFiB7Ct.mjs";
+import { computed, createBlock, createVNode, defineComponent, guardReactiveProps, mergeProps, normalizeProps, openBlock, withCtx } from "vue";
+//#endregion
+//#region src/components/defaults/as-input.vue
+var as_input_default = /* @__PURE__ */ defineComponent({
+	__name: "as-input",
+	props: {
+		onBlur: {
+			type: Function,
+			required: true
+		},
+		error: {
+			type: String,
+			required: false
+		},
+		model: {
+			type: Object,
+			required: true
+		},
+		value: {
+			type: null,
+			required: false
+		},
+		label: {
+			type: String,
+			required: false
+		},
+		description: {
+			type: String,
+			required: false
+		},
+		hint: {
+			type: String,
+			required: false
+		},
+		placeholder: {
+			type: String,
+			required: false
+		},
+		prefixIcon: {
+			type: String,
+			required: false
+		},
+		suffixIcon: {
+			type: String,
+			required: false
+		},
+		class: {
+			type: [Object, String],
+			required: false
+		},
+		style: {
+			type: [Object, String],
+			required: false
+		},
+		optional: {
+			type: Boolean,
+			required: false,
+			skipCheck: true
+		},
+		onToggleOptional: {
+			type: Function,
+			required: false
+		},
+		required: {
+			type: Boolean,
+			required: false,
+			skipCheck: true
+		},
+		readonly: {
+			type: Boolean,
+			required: false,
+			skipCheck: true
+		},
+		type: {
+			type: String,
+			required: true
+		},
+		formAction: {
+			type: Object,
+			required: false
+		},
+		name: {
+			type: String,
+			required: false
+		},
+		field: {
+			type: Object,
+			required: false
+		},
+		options: {
+			type: Array,
+			required: false
+		},
+		maxLength: {
+			type: Number,
+			required: false
+		},
+		autocomplete: {
+			type: String,
+			required: false
+		},
+		title: {
+			type: String,
+			required: false
+		},
+		level: {
+			type: Number,
+			required: false
+		},
+		onRemove: {
+			type: Function,
+			required: false
+		},
+		canRemove: {
+			type: Boolean,
+			required: false
+		},
+		removeLabel: {
+			type: String,
+			required: false
+		},
+		arrayIndex: {
+			type: Number,
+			required: false
+		},
+		path: {
+			type: String,
+			required: true
+		},
+		valueHelp: {
+			type: Object,
+			required: false
+		},
+		singularLabel: {
+			type: String,
+			required: false
+		},
+		inputId: {
+			type: String,
+			required: true
+		},
+		errorId: {
+			type: String,
+			required: true
+		},
+		descId: {
+			type: String,
+			required: true
+		},
+		ariaDescribedBy: {
+			type: String,
+			required: false
+		},
+		currencyCode: {
+			type: String,
+			required: false
+		},
+		unitCode: {
+			type: String,
+			required: false
+		},
+		precisionScale: {
+			type: Number,
+			required: false
+		},
+		prefix: {
+			type: String,
+			required: false
+		},
+		suffix: {
+			type: String,
+			required: false
+		},
+		scale: {
+			type: Number,
+			required: false
+		},
+		hasAdornment: {
+			type: Boolean,
+			required: false
+		},
+		disabled: {
+			type: Boolean,
+			required: false
+		},
+		hidden: {
+			type: Boolean,
+			required: false
+		}
+	},
+	setup(__props) {
+		const props = __props;
+		const shellTitle = computed(() => props.currencyCode ?? props.unitCode ?? void 0);
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(as_field_shell_default, normalizeProps(guardReactiveProps(_ctx.$props)), {
+				default: withCtx(({ inputId }) => [__props.hasAdornment ? (openBlock(), createBlock(as_adornment_shell_default, {
+					key: 0,
+					"prefix-icon": __props.prefixIcon,
+					prefix: __props.prefix,
+					suffix: __props.suffix,
+					"suffix-icon": __props.suffixIcon,
+					error: __props.error,
+					required: __props.required,
+					title: shellTitle.value
+				}, {
+					default: withCtx(() => [createVNode(as_input_control_default, mergeProps(_ctx.$props, { "input-id": inputId }), null, 16, ["input-id"])]),
+					_: 2
+				}, 1032, [
+					"prefix-icon",
+					"prefix",
+					"suffix",
+					"suffix-icon",
+					"error",
+					"required",
+					"title"
+				])) : (openBlock(), createBlock(as_input_control_default, mergeProps({ key: 1 }, _ctx.$props, { "input-id": inputId }), null, 16, ["input-id"]))]),
+				_: 1
+			}, 16);
+		};
+	}
+});
+//#endregion
+export { as_input_default as t };