@duffcloudservices/site-forms 0.1.0

package/README.md

@@ -0,0 +1,213 @@
+# @duffcloudservices/site-forms
+
+Shared `<DcsForm/>` runtime for DCS customer sites. Renders a managed
+form definition (created in the portal Form Manager) from a build-time
+`.dcs/forms/<formId>.yaml` snapshot, validates user input, and posts
+submissions to the public site-forms API.
+
+This is the single import surface for managed-form runtime code on
+customer sites — do not redefine field components per site.
+
+> **Inside the `dcs-again` workspace** the package is also reachable
+> as `@duffcloudservices/site-forms` via `workspace:*` (the workspace
+> name and the published name are the same).
+> **In sibling customer-site repos** install the published package
+> from public npm — see [`PUBLISHING.md`](./PUBLISHING.md) for the
+> consumption story and registry setup.
+
+## Install
+
+### In a workspace app (inside `dcs-again`)
+
+```jsonc
+// portal/package.json
+{
+  "dependencies": {
+    "@duffcloudservices/site-forms": "workspace:*"
+  }
+}
+```
+
+Then `pnpm install` from the repo root.
+
+### In a sibling customer-site repo (e.g. `ktbraunlaw`, `kept`)
+
+```powershell
+pnpm add @duffcloudservices/site-forms
+```
+
+See [`PUBLISHING.md`](./PUBLISHING.md) for the registry, version, and
+release-workflow details.
+
+## Vite setup
+
+Two pieces are required in the consuming site:
+
+1. **`vite-plugin-yaml`** so `import.meta.glob('/.dcs/forms/*.yaml', { eager: true, import: 'default' })` returns parsed objects:
+
+   ```ts
+   // vite.config.ts
+   import yaml from '@modyfi/vite-plugin-yaml'
+
+   export default defineConfig({
+     plugins: [vue(), yaml()],
+   })
+   ```
+
+   Without it, the loader falls back to parsing raw strings via
+   `js-yaml`, which works but pays the parse cost at boot.
+
+2. **Env vars** the runtime reads:
+
+   | Variable                | Purpose                                              |
+   | ----------------------- | ---------------------------------------------------- |
+   | `VITE_DCS_PUBLIC_API`   | Base URL of the DCS public API (no trailing slash). |
+   | `VITE_DCS_SITE_SLUG`    | Default site slug used when the prop is omitted.    |
+
+## Usage
+
+Place a YAML file at `<site>/.dcs/forms/contact.yaml`:
+
+```yaml
+formId: contact
+title: Contact Us
+submission:
+  kind: lead
+fields:
+  - id: name
+    type: text
+    label: Name
+    required: true
+  - id: email
+    type: email
+    label: Email
+    required: true
+  - id: message
+    type: textarea
+    label: Message
+    required: true
+```
+
+Then in any page component:
+
+```vue
+<script setup lang="ts">
+import { DcsForm } from '@duffcloudservices/site-forms'
+</script>
+
+<template>
+  <DcsForm
+    form-id="contact"
+    @submit-success="onSuccess"
+    @submit-error="onError"
+  />
+</template>
+```
+
+## Props
+
+| Prop                 | Type                              | Default                                | Notes                                                       |
+| -------------------- | --------------------------------- | -------------------------------------- | ----------------------------------------------------------- |
+| `formId`             | `string` (required)               | —                                      | Matches `.dcs/forms/<formId>.yaml`.                         |
+| `siteSlug`           | `string`                          | `import.meta.env.VITE_DCS_SITE_SLUG`   | Path segment in the submission URL.                         |
+| `definitionOverride` | `PortalFormDefinition`            | —                                      | Used by the portal preview iframe to show in-flight edits.  |
+| `apiBase`            | `string`                          | `import.meta.env.VITE_DCS_PUBLIC_API`  | Override for tests / non-prod environments.                 |
+| `captchaToken`       | `string`                          | —                                      | Attached to the submission payload when set.                |
+| `formsModules`       | `Record<string, unknown>`         | `import.meta.glob(...)`                | Test-only override for the YAML modules map.                |
+
+## Emits
+
+| Event              | Payload                | When                                        |
+| ------------------ | ---------------------- | ------------------------------------------- |
+| `submit-success`   | `DcsFormSubmitSuccess` | API responded `2xx`.                        |
+| `submit-error`     | `DcsFormSubmitError`   | Network or non-2xx response after retries.  |
+| `validation-error` | `FormErrors`           | Submit attempted with invalid required/regex/etc. fields. |
+
+## Slots
+
+Every slot exposes scoped data so consumers (KT Braun, Kept) can swap
+shadcn primitives in without forking field components.
+
+| Slot       | Scope                                                              | Default                                              |
+| ---------- | ------------------------------------------------------------------ | ---------------------------------------------------- |
+| `header`   | `{ definition }`                                                   | `<h2>` + description                                 |
+| `progress` | `{ current, total, step }`                                         | `Step N of M — Title` (multi-step only)              |
+| `actions`  | `{ isFirstStep, isLastStep, submitting, prev, next }`              | Plain `<button>` elements                            |
+| `success`  | `{ definition }`                                                   | `definition.successMessage`                          |
+| `missing`  | `{ formId }`                                                       | Friendly fallback when the YAML can't be found      |
+
+Per-field components (`DcsFormText` etc.) expose `#input` slots so a
+shadcn site can replace the underlying primitive while keeping the
+wrapper, label, help, and error-message structure.
+
+## Composables
+
+For sites that want a fully custom layout, drop `<DcsForm/>` and use
+the underlying composables directly:
+
+```ts
+import {
+  useDcsForm,
+  validateForm,
+  submitFormValues,
+  parseFormYaml,
+} from '@duffcloudservices/site-forms'
+```
+
+- `useDcsForm({ definition })` — reactive `values`, `errors`, `steps`,
+  `next`, `prev`, `validateAll`, `collectSubmissionValues`, etc.
+- `validateForm(def, values, fieldIds?)` — pure validator usable in
+  any setting (server-side, tests, custom adapters).
+- `submitFormValues({ apiBase, siteSlug, payload })` — one-shot POST
+  with a single retry on 5xx and `multipart/form-data` when files are
+  present.
+
+## Visual editor integration
+
+The form root carries `data-form-key="<formId>"` and every field
+wrapper carries `data-form-field-key="<fieldId>"`. The portal preview
+iframe bridge uses these to highlight and select form regions. Do not
+strip them in custom layouts.
+
+## Schema validation
+
+In dev (`import.meta.env.DEV === true`) the runtime validates each
+loaded definition against the JSON Schema bundled in
+`src/schema/form-definition.schema.json` (snapshot of
+`contracts/dist/form-definition.schema.json`) and logs failures via
+`console.warn`. Production builds skip the warning to avoid noisy
+end-user consoles.
+
+When the contracts schema is regenerated (`pnpm --filter @dcs/contracts
+generate`), refresh the snapshot:
+
+```powershell
+Copy-Item ../../contracts/dist/form-definition.schema.json ./src/schema/form-definition.schema.json -Force
+pnpm --filter @duffcloudservices/site-forms test --run
+```
+
+## Scripts
+
+```powershell
+pnpm --filter @duffcloudservices/site-forms build       # vite library build (esm + dts)
+pnpm --filter @duffcloudservices/site-forms test        # vitest --run
+pnpm --filter @duffcloudservices/site-forms type-check  # vue-tsc --noEmit
+```
+
+## Related docs
+
+- **Authoring guide** — [`.docs/forms/AUTHORING.md`](../../.docs/forms/AUTHORING.md)
+  covers the YAML schema, worked examples, validation flow, HIPAA
+  guardrails, and the hand-coded → `<DcsForm/>` migration recipe.
+- **Publishing** — [`PUBLISHING.md`](./PUBLISHING.md) covers the
+  registry, OIDC trusted publishing, version bump policy, and the
+  exact dep line sibling customer-site repos should add.
+- **Validation CLI** — [`cli/forms/README.md`](../../cli/forms/README.md)
+  documents `dcs forms validate` and `dcs forms doctor`, which lint
+  the `.dcs/forms/*.yaml` files in a customer-site repo.
+
+## Ownership
+
+Per `packages/README.md`: external/consumer-facing docs live here, not
+in repo-root docs. Cross-cutting details (e.g. the public submissions
+API contract) belong in `contracts/README.md`.

package/dist/DcsForm.vue.d.ts

@@ -0,0 +1,67 @@
+import { DcsFormSubmitError, DcsFormSubmitSuccess, PortalFormDefinition } from './types';
+interface Props {
+    /** Kebab-case form id; matches `.dcs/forms/<formId>.yaml`. */
+    formId: string;
+    /** Site slug used for the submission endpoint path. */
+    siteSlug?: string;
+    /** Override the loaded definition (used by the portal preview iframe). */
+    definitionOverride?: PortalFormDefinition;
+    /** Override the API base URL; defaults to `VITE_DCS_PUBLIC_API`. */
+    apiBase?: string;
+    /** Optional captcha token, attached to the submission payload. */
+    captchaToken?: string;
+    /**
+     * Optional override for the YAML modules map. Mostly for tests; in
+     * real apps the build-time `import.meta.glob` call below is used.
+     */
+    formsModules?: Record<string, unknown>;
+}
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        missing?(_: {
+            formId: string;
+        }): any;
+        success?(_: {
+            definition: PortalFormDefinition;
+        }): any;
+        header?(_: {
+            definition: PortalFormDefinition;
+        }): any;
+        progress?(_: {
+            current: number;
+            total: number;
+            step: import('./types').PortalFormStep | null;
+        }): any;
+        actions?(_: {
+            isFirstStep: boolean;
+            isLastStep: boolean;
+            submitting: boolean;
+            prev: () => void;
+            next: () => boolean;
+        }): any;
+    };
+    refs: {
+        formEl: HTMLFormElement;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "submit-success": (event: DcsFormSubmitSuccess) => any;
+    "submit-error": (event: DcsFormSubmitError) => any;
+    "validation-error": (errors: Record<string, string | undefined>) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    "onSubmit-success"?: ((event: DcsFormSubmitSuccess) => any) | undefined;
+    "onSubmit-error"?: ((event: DcsFormSubmitError) => any) | undefined;
+    "onValidation-error"?: ((errors: Record<string, string | undefined>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    formEl: HTMLFormElement;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/composables/useDcsForm.d.ts

@@ -0,0 +1,36 @@
+import { ComputedRef, Ref } from 'vue';
+import { PortalFormDefinition, PortalFormField, PortalFormStep, FormErrors, FormValues } from '../types';
+export interface UseDcsFormOptions {
+    definition: PortalFormDefinition;
+}
+export interface UseDcsFormReturn {
+    values: FormValues;
+    errors: Ref<FormErrors>;
+    touched: Ref<Record<string, boolean>>;
+    submitting: Ref<boolean>;
+    submitted: Ref<boolean>;
+    submitError: Ref<string | null>;
+    /** All fields, with layout-only types preserved. */
+    fields: ComputedRef<PortalFormField[]>;
+    /** Steps if multi-step, else null. */
+    steps: ComputedRef<PortalFormStep[] | null>;
+    currentStepIndex: Ref<number>;
+    currentStep: ComputedRef<PortalFormStep | null>;
+    currentStepFields: ComputedRef<PortalFormField[]>;
+    isFirstStep: ComputedRef<boolean>;
+    isLastStep: ComputedRef<boolean>;
+    visibleFields: ComputedRef<PortalFormField[]>;
+    /** Sets a field value and clears that field's error. */
+    setValue: (id: string, value: unknown) => void;
+    /** Marks a field as touched + revalidates only that field's row. */
+    touch: (id: string) => void;
+    /** Validates the current step (multi-step) or the entire form. */
+    validateCurrentScope: () => boolean;
+    validateAll: () => boolean;
+    next: () => boolean;
+    prev: () => void;
+    reset: () => void;
+    /** Returns the values that should actually be submitted (visible only). */
+    collectSubmissionValues: () => FormValues;
+}
+export declare function useDcsForm(opts: UseDcsFormOptions): UseDcsFormReturn;

package/dist/composables/useFormSubmission.d.ts

@@ -0,0 +1,18 @@
+import { DcsFormSubmitPayload, DcsFormSubmitSuccess } from '../types';
+export interface SubmitOptions {
+    apiBase: string;
+    siteSlug: string;
+    payload: DcsFormSubmitPayload;
+    /** Number of retries on 5xx / network errors. Default 1. */
+    retries?: number;
+    /** Optional fetch implementation override (tests). */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * POSTs a form submission to
+ * `${apiBase}/public/sites/{siteSlug}/form-submissions`.
+ *
+ * Uses JSON for plain values and `multipart/form-data` when any
+ * value is a `File` (file-upload fields).
+ */
+export declare function submitFormValues(opts: SubmitOptions): Promise<DcsFormSubmitSuccess>;

package/dist/composables/useFormValidation.d.ts

@@ -0,0 +1,19 @@
+import { PortalFormDefinition, PortalFormField, FormErrors, FormValues } from '../types';
+/**
+ * Returns true iff `field` is currently visible given the form's
+ * other values. Hidden fields are never validated and never sent.
+ */
+export declare function isFieldVisible(field: PortalFormField, values: FormValues): boolean;
+/**
+ * Validates a single field's value. Returns an error string or
+ * `undefined` if valid. Layout-only field types (section-heading,
+ * html-block) and hidden fields never produce errors.
+ */
+export declare function validateField(field: PortalFormField, value: unknown): string | undefined;
+/**
+ * Validates an entire form. Skips fields that are not visible.
+ * If `fieldIds` is supplied, only those fields are validated
+ * (used for per-step validation in multi-step forms).
+ */
+export declare function validateForm(def: PortalFormDefinition, values: FormValues, fieldIds?: string[]): FormErrors;
+export declare function hasErrors(errors: FormErrors): boolean;

package/dist/fields/DcsFormCheckbox.vue.d.ts

@@ -0,0 +1,12 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: boolean | undefined;
+    error?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/fields/DcsFormCheckboxGroup.vue.d.ts

@@ -0,0 +1,12 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: string[] | undefined;
+    error?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/fields/DcsFormDate.vue.d.ts

@@ -0,0 +1,14 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: string | undefined;
+    error?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+    blur: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    onBlur?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/fields/DcsFormFieldWrapper.vue.d.ts

@@ -0,0 +1,27 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    error?: string;
+    /** Optional id to use for the input — wrappers use it for label `for=`. */
+    inputId?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        label?(_: {}): any;
+        default?(_: {}): any;
+        help?(_: {}): any;
+        error?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/fields/DcsFormFile.vue.d.ts

@@ -0,0 +1,12 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: File | undefined;
+    error?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: File | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: File | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/fields/DcsFormHidden.vue.d.ts

@@ -0,0 +1,7 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: string | number | undefined;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLInputElement>;
+export default _default;

package/dist/fields/DcsFormHtmlBlock.vue.d.ts

@@ -0,0 +1,6 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/fields/DcsFormRadio.vue.d.ts

@@ -0,0 +1,12 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: string | undefined;
+    error?: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/fields/DcsFormSection.vue.d.ts

@@ -0,0 +1,21 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/fields/DcsFormSelect.vue.d.ts

@@ -0,0 +1,35 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: string | string[] | undefined;
+    error?: string;
+};
+declare function onChange(e: Event): void;
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        input?(_: {
+            id: string;
+            value: string | string[] | undefined;
+            options: import('..').PortalFormFieldOption[];
+            onChange: typeof onChange;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string | string[]) => any;
+    blur: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | string[]) => any) | undefined;
+    onBlur?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/fields/DcsFormText.vue.d.ts

@@ -0,0 +1,34 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: string | number | undefined;
+    error?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        input?(_: {
+            id: string;
+            value: string | number | undefined;
+            onInput: (e: Event) => void;
+            onBlur: () => void;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+    blur: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    onBlur?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/fields/DcsFormTextarea.vue.d.ts

@@ -0,0 +1,34 @@
+import { PortalFormField } from '../types';
+type __VLS_Props = {
+    field: PortalFormField;
+    modelValue: string | undefined;
+    error?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        input?(_: {
+            id: string;
+            value: string | undefined;
+            onInput: (e: Event) => void;
+            onBlur: () => void;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+    blur: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    onBlur?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { default as DcsForm } from './DcsForm.vue';
+export { default as DcsFormText } from './fields/DcsFormText.vue';
+export { default as DcsFormTextarea } from './fields/DcsFormTextarea.vue';
+export { default as DcsFormSelect } from './fields/DcsFormSelect.vue';
+export { default as DcsFormRadio } from './fields/DcsFormRadio.vue';
+export { default as DcsFormCheckboxGroup } from './fields/DcsFormCheckboxGroup.vue';
+export { default as DcsFormCheckbox } from './fields/DcsFormCheckbox.vue';
+export { default as DcsFormDate } from './fields/DcsFormDate.vue';
+export { default as DcsFormFile } from './fields/DcsFormFile.vue';
+export { default as DcsFormHidden } from './fields/DcsFormHidden.vue';
+export { default as DcsFormSection } from './fields/DcsFormSection.vue';
+export { default as DcsFormHtmlBlock } from './fields/DcsFormHtmlBlock.vue';
+export { default as DcsFormFieldWrapper } from './fields/DcsFormFieldWrapper.vue';
+export { useDcsForm } from './composables/useDcsForm';
+export type { UseDcsFormOptions, UseDcsFormReturn } from './composables/useDcsForm';
+export { validateField, validateForm, isFieldVisible, hasErrors, } from './composables/useFormValidation';
+export { submitFormValues } from './composables/useFormSubmission';
+export type { SubmitOptions } from './composables/useFormSubmission';
+export { loadFormDefinitions, parseFormYaml } from './loaders/yaml';
+export { validateFormDefinition, warnIfInvalid, } from './schema/validate';
+export type { SchemaValidationResult } from './schema/validate';
+export type { DcsFormSubmitPayload, DcsFormSubmitSuccess, DcsFormSubmitError, FormErrors, FormValues, PortalFormDefinition, PortalFormField, PortalFormFieldType, PortalFormFieldOption, PortalFormFieldValidation, PortalFormFieldVisibleIf, PortalFormFieldWidth, PortalFormStep, PortalFormSubmissionConfig, PortalFormSubmissionLeadConfig, PortalFormSubmissionEmailConfig, PortalFormSubmissionWebhookConfig, } from './types';