@duffcloudservices/site-forms 0.1.2 → 0.1.4

package/README.md

@@ -115,7 +115,6 @@ Place a YAML file at `<site>/.dcs/forms/contact.yaml`:
 
 ```yaml
 formId: contact
-title: Contact Us
 submission:
   kind: lead
 fields:
@@ -177,7 +176,7 @@ shadcn primitives in without forking field components.
 
 | Slot       | Scope                                                              | Default                                              |
 | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------- |
-| `header`   | `{ definition }`                                                   | `<h2>` + description                                 |
+| `header`   | `{ definition }`                                                   | Empty; page/section headings live outside the managed form |
 | `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`                          |
@@ -213,8 +212,19 @@ import {
 
 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.
+iframe bridge uses these to discover managed forms, show the preview
+affordance, and route preview click / context-menu actions into the same
+portal `FormManagerSheet`. Do not strip these attributes in custom
+layouts.
+
+`definitionOverride` is a preview-only draft path for the iframe. The
+durable form truth still lives in the form definition saved by the
+portal and in the committed `.dcs/forms/<formId>.yaml` snapshot consumed
+by the site runtime.
+
+For the cross-package first-party component contract (runtime markers,
+bridge discovery, portal entry points, rollout, validation), see
+[`../FIRST-PARTY-COMPONENTS.md`](../FIRST-PARTY-COMPONENTS.md).
 
 ## Schema validation
 
@@ -249,6 +259,10 @@ pnpm --filter @duffcloudservices/site-forms type-check  # vue-tsc --noEmit
 - **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.
+- **First-party visual-editor contract** —
+  [`../FIRST-PARTY-COMPONENTS.md`](../FIRST-PARTY-COMPONENTS.md)
+  captures the shared adaptation model used by forms and future
+  component families.
 - **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.

package/dist/composables/useFormSubmission.d.ts

@@ -10,7 +10,7 @@ export interface SubmitOptions {
 }
 /**
  * POSTs a form submission to
- * `${apiBase}/public/sites/{siteSlug}/form-submissions`.
+ * `${apiBase}/sites/{siteSlug}/forms/{formId}/submissions`.
  *
  * Uses JSON for plain values and `multipart/form-data` when any
  * value is a `File` (file-upload fields).

package/dist/index.d.ts

@@ -17,6 +17,8 @@ export { validateField, validateForm, isFieldVisible, hasErrors, } from './compo
 export { submitFormValues } from './composables/useFormSubmission';
 export type { SubmitOptions } from './composables/useFormSubmission';
 export { loadFormDefinitions, parseFormYaml } from './loaders/yaml';
+export { buildStandardFormDefinition, STANDARD_FORM_PRESET_META, } from './presets';
+export type { StandardFormPreset, BuildStandardFormOptions, } from './presets';
 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';
+export type { DcsFormSubmitPayload, DcsFormSubmitSuccess, DcsFormSubmitError, FormErrors, FormValues, PortalFormDefinition, PortalFormField, PortalFormKind, PortalFormFieldRole, PortalFormAttachmentPolicy, PortalFormFieldType, PortalFormFieldOption, PortalFormFieldValidation, PortalFormFieldVisibleIf, PortalFormFieldWidth, PortalFormStep, PortalFormSubmissionConfig, PortalFormSubmissionLeadConfig, PortalFormSubmissionEmailConfig, PortalFormSubmissionWebhookConfig, } from './types';