@spotto/contract 1.0.70-alpha.11 → 1.0.70-alpha.12

package/dist/forms/[id]/patch/request.d.ts

@@ -1,14 +1,16 @@
-import { FormItem, FormPrefillRow, FormWriteBackRow } from '../../shared';
+import { FormItem, FormPrefillRow, FormSettings, FormWriteBackRow } from '../../shared';
 /**
  * Publishes a new version of the form. `{id}` is the version document the
  * editor loaded — the server inserts exactly `that.version + 1` and returns
  * 409 when the head has moved ("form changed — reload"). Version documents
  * themselves are never mutated. Omitted fields carry over from the loaded
- * version; `name` is immutable.
+ * version; `name` is immutable. A present `settings` replaces the loaded
+ * version's wholesale (like the arrays) — publish `{}` to clear it.
  */
 export interface UpdateFormRequest {
     label?: string;
     items?: FormItem[];
     prefill?: FormPrefillRow[];
     writeBack?: FormWriteBackRow[];
+    settings?: FormSettings;
 }

package/dist/forms/get/response.d.ts

@@ -1,5 +1,5 @@
 import { IEntityMeta } from '../../shared';
-import { FormItem, FormPrefillRow, FormWriteBackRow } from '../shared';
+import { FormItem, FormPrefillRow, FormSettings, FormWriteBackRow } from '../shared';
 import { GetFormsQuery } from './query';
 /** One immutable form version document. */
 export interface GetFormResponse {
@@ -14,6 +14,7 @@ export interface GetFormResponse {
     items: FormItem[];
     prefill: FormPrefillRow[];
     writeBack: FormWriteBackRow[];
+    settings?: FormSettings;
     createdBy: string;
     meta?: IEntityMeta;
 }

package/dist/forms/post/request.d.ts

@@ -1,4 +1,4 @@
-import { FormItem, FormPrefillRow, FormWriteBackRow } from '../shared';
+import { FormItem, FormPrefillRow, FormSettings, FormWriteBackRow } from '../shared';
 /** Creates a new form as version 1 (current). */
 export interface PostFormRequest {
     /** Immutable handle; referenced by actions. */
@@ -7,4 +7,5 @@ export interface PostFormRequest {
     items: FormItem[];
     prefill?: FormPrefillRow[];
     writeBack?: FormWriteBackRow[];
+    settings?: FormSettings;
 }

package/dist/forms/shared.d.ts

@@ -48,6 +48,27 @@ export interface FormImageItem {
 export interface FormDividerItem {
     kind: 'divider';
 }
+/**
+ * A hyperlink content block — opens `href` (validated http(s)-only at save,
+ * so a stored href is always safe to render as an anchor).
+ */
+export interface FormLinkItem {
+    kind: 'link';
+    href: string;
+    /** Display text; the href itself shows when omitted. */
+    label?: string;
+}
+/**
+ * An embedded YouTube video. The URL is stored as authored (watch, share,
+ * shorts or embed form — validated against the YouTube hosts at save) and
+ * the client derives the embed markup, so only allowlisted hosts ever reach
+ * an iframe.
+ */
+export interface FormVideoItem {
+    kind: 'video';
+    url: string;
+    caption?: string;
+}
 /**
  * A signature/photo capture block. Produces an attachment reference on the
  * submission (never a fieldValue), keyed by the block's `name`.
@@ -59,8 +80,29 @@ export interface FormCaptureItem {
     label?: string;
     help?: string;
 }
-export declare type FormItem = FormFieldItem | FormSectionItem | FormTextItem | FormImageItem | FormDividerItem | FormCaptureItem;
+export declare type FormItem = FormFieldItem | FormSectionItem | FormTextItem | FormImageItem | FormDividerItem | FormLinkItem | FormVideoItem | FormCaptureItem;
 export declare type FormItemKind = FormItem['kind'];
+/**
+ * Runner presentation options — how the form presents its chrome, not what
+ * it collects. Optional as a whole, and PATCH replaces it wholesale (like
+ * the arrays), so an option can be cleared by publishing without it.
+ */
+export interface FormSettings {
+    /** Overrides the submit button text (e.g. "Confirm"). */
+    submitLabel?: string;
+    /** Show a cancel button that closes the form without submitting. */
+    showCancel?: boolean;
+    /** Cancel button text — only allowed alongside `showCancel`. */
+    cancelLabel?: string;
+    /**
+     * Content-only: completing the form records NOTHING (no submission, no
+     * event, no write-back) — the server rejects a submission against it.
+     * Save-time validation forbids write-back rows, capture blocks and
+     * required items. For a recorded acknowledgment, use a non-informational
+     * form with a signature block and a "Confirm" submitLabel instead.
+     */
+    informational?: boolean;
+}
 /**
  * A read-in row: on open, seed form field `to` from the target — either a
  * copy of target field `from` or an `expression` over the target's effective

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spotto/contract",
   "license": "ISC",
-  "version": "1.0.70-alpha.11",
+  "version": "1.0.70-alpha.12",
   "description": "Spotto's API Contract type definitions",
   "main": "./dist/index.js",
   "files": [
@@ -18,5 +18,5 @@
     "@types/geojson": "^7946.0.11",
     "shx": "^0.3.4"
   },
-  "gitHead": "3bfd5e720157f73503fd29486b6111952e44de5a"
+  "gitHead": "609333e7153afaa63e907e108dfa0fd08df49246"
 }