@lssm/lib.contracts-spec 17.3.2

package/dist/forms/forms.js

@@ -0,0 +1 @@
+var {require}=import.meta;export class FormRegistry{items=new Map;projectionItems=new Map;register(e){const t=K(e.meta);if(this.items.has(t))throw Error(`Duplicate form ${t}`);const n=R(e);if(n&&this.projectionItems.has(n))throw Error(`Duplicate form projection ${n}`);this.items.set(t,e);if(n)this.projectionItems.set(n,e);return this}list(){return[...this.items.values()]}get(e,t){if(t!=null)return this.items.get(`${e}.v${t}`);let n;for(const[r,i]of this.items.entries()){if(i.meta.key!==e)continue;if(!n||P(i.meta.version,n.meta.version)>0)n=i}return n}getByEntityProjection(e,t,n){if(n!=null)return this.projectionItems.get(F(e,t,n));return findFormProjection(this.projectionItems.values(),{entityKey:e,projectionKind:t})}findProjection(e){return this.getByEntityProjection(e.entityKey,e.projectionKind,e.version)}filter(e){const{filterBy:t}=require("../registry-utils");return t(this.list(),e)}listByTag(e){return this.list().filter((t)=>t.meta.tags?.includes(e))}listByOwner(e){return this.list().filter((t)=>t.meta.owners?.includes(e))}groupBy(e){const{groupBy:t}=require("../registry-utils");return t(this.list(),e)}getUniqueTags(){const{getUniqueTags:e}=require("../registry-utils");return e(this.list())}}import{compareVersions as P}from"compare-versions";import{evaluatePredicateSpec as w}from"../decisioning/predicate-evaluation.js";export function responsiveFormColumns(e,t={}){const n=t.breakpoint??"md";return{base:t.base??1,[n]:e}}export function isFieldReadOnly(e){return e.readOnly??e.computeFrom?.readOnly??!1}export function normalizeFieldSpec(e){const t=e.layout??(e.wrapper?.orientation?{orientation:e.wrapper.orientation}:void 0),n=e.readOnly==null&&e.computeFrom?.readOnly!=null?{...e,layout:t,readOnly:e.computeFrom.readOnly}:{...e,layout:t};if(n.kind==="group")return{...n,fields:n.fields.map((r)=>normalizeFieldSpec(r))};if(n.kind==="array")return{...n,of:normalizeFieldSpec(n.of)};return n}function x(e,t){const n=e.name?t?`${t}.${e.name}`:e.name:t??"";if(e.kind==="group")return e.fields.flatMap((r)=>x(r,n));if(e.kind==="array")return x(e.of,n);if(e.kind!=="phone")return[];return[n,e.output?.countryCodeName,e.output?.countryIso2Name,e.output?.nationalNumberName,e.output?.e164Name].filter((r)=>Boolean(r))}function C(e,t){const n=t.flatMap((i)=>x(i));if(!n.length)return e;const r=[...new Set([...e?.pii??[],...n])];return{...e,pii:r}}export function normalizeFormSpec(e){const t=e.fields.map((n)=>normalizeFieldSpec(n));return{...e,fields:t,policy:C(e.policy,t)}}function j(e){return e==null||typeof e==="string"&&e.trim().length===0||Array.isArray(e)&&e.length===0}function I(e,t){const n=e.projection?.completionProfiles??[];if(t)return n.find((r)=>r.key===t);return n[0]}function O(e){if(!e)return[];return[...(e.requiredPaths??[]).map((n)=>({path:n,severity:"required"})),...e.requirements??[]]}export function evaluateFormCompletion(e,t,n={}){const r=I(e,n.profileKey),i=O(r).flatMap((s)=>{if(s.requiredWhen&&!evalPredicate(t,s.requiredWhen))return[];const m=S(t,s.path);if(!j(m))return[];return[{path:s.path,profileKey:r?.key,reason:s.requiredWhen?"requiredWhen":"missing",severity:s.severity??"required",labelI18n:s.labelI18n,message:s.reason}]});return{status:i.some((s)=>s.severity==="required")?"incomplete":"complete",profileKey:r?.key,debt:i}}export function captureFormIntake(e,t,n={}){const r=n.profileKey??e.projection?.intake?.completionProfileKey,i=evaluateFormCompletion(e,t,{profileKey:r});return{accepted:!0,values:t,projection:e.projection,completion:i}}function K(e){return`${e.key}.v${e.version}`}function f(e){return e.projection?.version??e.meta.version}function F(e,t,n){return`${e}#${t}.v${n}`}function R(e){if(!e.projection)return;return F(e.projection.entity.entityKey,e.projection.kind,f(e))}export function findFormProjection(e,t){let n;for(const r of e){if(r.projection?.entity.entityKey!==t.entityKey)continue;if(r.projection.kind!==t.projectionKind)continue;const i=f(r);if(t.version!=null){if(i!==t.version)continue;if(n)throw Error(`Duplicate form projection ${F(t.entityKey,t.projectionKind,t.version)}`);n=r;continue}if(!n||P(i,f(n))>0)n=r;else if(P(i,f(n))===0)throw Error(`Duplicate form projection ${F(t.entityKey,t.projectionKind,i)}`)}return n}function S(e,t){if(!t)return;const n=t.replace(/\[(\d+)\]/g,".$1").split(".").filter(Boolean);let r=e;for(const i of n){if(r==null)return;if(r&&typeof r==="object"&&i in r)r=r[i];else return}return r}function b(e,t=[]){let n=0;return e.replace(/\$index/g,()=>{const r=t[n];n+=1;return r==null?"$index":String(r)})}function u(e){return e.split(".").filter(Boolean).map((t)=>/^\d+$/.test(t)?Number(t):t)}export function evalPredicate(e,t,n=[]){if(!t)return!0;return w(t,e,(r)=>b(r,n)).matched}export function buildZodWithRelations(e,t){const n=normalizeFormSpec(e);return n.model.getZod().superRefine((i,s)=>{const m=(o,l,c=[])=>{const k=o.name?l?`${l}.${o.name}`:o.name:l??"",p=b(k,c);if(o.requiredWhen){if(evalPredicate(i,o.requiredWhen,c)){const d=S(i,p);if(d==null||typeof d==="string"&&d.trim().length===0||Array.isArray(d)&&d.length===0)s.addIssue({code:"custom",path:u(p),message:"required"})}}if(o.kind==="array"||o.kind==="multi-select"){const a=S(i,p),d=o.kind==="array"?o.min:o.minSelections,g=o.kind==="array"?o.max:o.maxSelections;if(d!=null&&Array.isArray(a)&&a.length<d)s.addIssue({code:"custom",path:u(p),message:`min:${d}`});if(g!=null&&Array.isArray(a)&&a.length>g)s.addIssue({code:"custom",path:u(p),message:`max:${g}`});if(o.kind==="array"&&Array.isArray(a))a.forEach((h,y)=>{m(o.of,`${p}.${y}`,[...c,y])});if(o.kind==="multi-select"&&Array.isArray(a)){const h="kind"in o.options?o.options.kind==="static"?o.options.options??[]:[]:o.options;if(h.length&&a.some((y)=>!h.some((v)=>Object.is(v.value,y))))s.addIssue({code:"custom",path:u(p),message:"invalid-option"})}}else if(o.kind==="group")for(const a of o.fields)m(a,p,c)};for(const o of n.fields)m(o);if(n.constraints&&t)for(const o of n.constraints){const l=t[o.key];if(!l)continue;const c=l(i,o.paths,o.args);if(!c.ok)s.addIssue({code:"custom",path:u(c.path??o.paths[0]??""),message:c.message??o.messageI18n})}})}export function defineFormSpec(e){return e}export const tech_contracts_forms_DocBlocks=[{id:"docs.tech.contracts.forms",title:"Contracts: FormSpec",summary:"This document defines the canonical contracts for declarative forms.",kind:"reference",visibility:"public",route:"/docs/tech/contracts/forms",tags:["tech","contracts","forms"],body:"# Contracts: FormSpec\n\nThis document defines the canonical contracts for declarative forms.\n\n## Overview\n\n- `FormSpec` (in `@lssm/lib.contracts-spec/forms`) declares:\n  - `meta` (extends `OwnerShipMeta`) + `key`/`version` for stability.\n  - `model` (`@lssm/lib.schema` `SchemaModel`) as the single source of truth.\n  - `fields` built from `FieldSpec` kinds: `text`, `email`, `textarea`, `select`, `checkbox`, `radio`, `switch`, `autocomplete`, `address`, `phone`, `number`, `percent`, `currency`, `date`, `time`, `datetime`, `duration`, `group`, `array`.\n  - `text.password` for masked current/new password fields with password-manager hints.\n  - field-level `readOnly` support that preserves submitted values.\n  - Optional `layout`, `layout.flow`, `actions`, `policy.flags`, `constraints` and `renderHints`.\n- Relations DSL provides `visibleWhen`, `enabledWhen`, `requiredWhen` based on predicates.\n- Entity-bound projections use `projection.parts` for form-to-entity-path\n  part bindings and `projection.relatedEdges` for references to actual\n  entity `EdgeSpec` relations. Part bindings do not own graph cardinality.\n- `FormRegistry.getByEntityProjection(entityKey, projectionKind, version?)`\n  deterministically resolves quick/full/intake/edit/part forms by entity\n  projection metadata instead of by renderable form key only.\n- `buildZodWithRelations(spec)` augments the base zod with conditional rules and constraints.\n- Entity-bound projections are declared with optional `projection` metadata:\n  `quick`, `full`, `intake`, `edit`, and `part` forms remain normal\n  renderable `FormSpec` objects while `FormProjectionSpec.entity` binds them\n  to a canonical `ContractEntitySpec.meta.key`.\n- `captureFormIntake(spec, values)` is permissive by design: it returns\n  `accepted: true` for partial values and records missing completion debt.\n- `evaluateFormCompletion(spec, values)` is the strict readiness companion:\n  it reports missing `FormCompletionDebt` for a completion profile without\n  invalidating the permissive capture result.\n- React adapter renders with React Hook Form + driver API for UI components.\n\n## Rich field contracts\n\n- `autocomplete` supports local filtering or resolver-backed search, including debounce/min-query hints and configurable submit-value mapping.\n- Resolver-backed autocomplete stays runtime-neutral: forms declare `resolverKey`, dependency paths, and optional args while host renderers provide the actual fetcher.\n- `email` represents one string email-address field; schema validation remains model-owned while renderers supply email input affordances.\n- `address` uses the canonical `AddressFormValue` object shape.\n- `phone` uses the canonical `PhoneFormValue` object shape.\n- `number`, `percent`, and `currency` map numeric schema intent to native input controls while preserving locale, precision, rounding, and currency-display metadata.\n- `date`, `time`, `datetime`, and `duration` map temporal schema intent to native controls while preserving locale, timezone, unit, and display metadata.\n- `array` remains the canonical dynamic-field primitive and can repeat grouped item layouts.\n- `text` can declare `password.purpose` as `current` or `new`; renderers map those to masked controls and `current-password` / `new-password` autocomplete hints.\n\n## Progressive form layout\n\n- `layout.flow.kind: \"sections\"` groups existing fields into accessible sections while keeping all sections visible.\n- `layout.flow.kind: \"steps\"` uses the same section metadata for progressive, one-section-at-a-time rendering.\n- `FormSectionSpec.fieldNames` references existing immediate field names; field definitions stay in `FormSpec.fields`.\n- Unlisted fields remain visible so flow metadata cannot accidentally drop required model inputs.\n- `text` and `textarea` can declare portable `inputGroup` addons for text and host-resolved icons.\n\n## Entity-bound projections and intake\n\n- Entity-bound form work is entity-first: canonical identity and true entity-to-entity relations stay on entity contracts.\n- Forms remain renderable projections. Quick, full, edit, intake, and part forms should be discoverable by entity key, projection kind, and optional version.\n- Form part bindings describe sub-capture surfaces such as identity or address. They must not overload `EdgeSpec`, which remains reserved for real entity graph relations and cardinality.\n- Capture acceptance and strict readiness are separate. Quick or message intake can accept partial values and return completion debt; stricter profiles can later report missing fields without rejecting the original capture.\n- Communication runtime intake hooks should map normalized messages into entity-bound intake payloads with source refs and completion debt. They should not implement full AI extraction, database persistence, or CommunicationOS UI.\n- The public documentation/migration subpath for this first-pass guidance is `@lssm/lib.contracts-spec/forms/entity-bound`.\n- Form configuration chrome is a design-system concern: reuse `FormConfigShell`, `FormConfigMenuBar`, and `FormConfigPanel` from `@lssm/lib.design-system/forms` instead of forking configuration panels in examples or apps.\n- FormSpec and FormConfig docs describe render/config metadata only. Persistence of drafts, submissions, credentials, or tenant state remains host-owned and approval-gated; examples should expose deterministic proof maps, not storage guarantees.\n\n## Layout and Groups\n\n- `FormSpec.layout` and `group.layout` can declare 1-4 responsive columns, gap size, and default field orientation.\n- `field.layout.colSpan` lets fields span one or more grid columns or the full row.\n- `wrapper.orientation` remains a compatibility alias for `layout.orientation`.\n- `group.legendI18n` renders as the semantic legend, falling back to `labelI18n`.\n\n## Driver API (UI-agnostic)\n\nHost apps supply a driver mapping slots to components:\n\n- Required: `Field`, `FieldLabel`, `FieldDescription`, `FieldError`, `Input`, `Textarea`, `Select`, `Checkbox`, `RadioGroup`, `Switch`, `Autocomplete`, `AddressField`, `PhoneField`, `NumberField`, `PercentField`, `CurrencyField`, `DateField`, `TimeField`, `DateTimeField`, `DurationField`, `Button`.\n- Optional: `FieldContent`, `FieldGroup`, `FieldSet`, `FieldLegend`, `FieldSeparator`, `InputGroup`, `InputGroupAddon`, `InputGroupInput`, `InputGroupTextarea`, `InputGroupText`, `InputGroupIcon`, and `PasswordInput`.\n- Autocomplete drivers should accept optional `loading`, `error`, `emptyText`, `loadingText`, and `errorText` props so resolver-backed fields can expose async state without embedding transport details in the contract.\n\nUse `createFormRenderer({ driver })` to obtain a `render(spec)` function.\n\n## Arrays and Groups\n\n- `array` items are rendered with `useFieldArray`, honoring `min`/`max` and add/remove controls.\n- `array.of` can repeat grouped multi-field rows.\n- `group` composes nested fields and provides optional legend/description/layout.\n\n## Feature Flags\n\n- Declare `policy.flags` on forms to signal gating. Gate usage at host boundary; avoid scattering flags across individual fields.\n\n## Example\n\nUse the exported `RichFieldsShowcaseForm` as the canonical reference for readonly, password, autocomplete, address, phone, temporal, layout, and input-group field authoring.\n"}];

package/dist/forms/index.d.js

@@ -0,0 +1 @@
+export*from"./entity-bound-forms.js";export*from"./forms.js";export*from"./marketing.forms.js";export*from"./platform-capability.js";export*from"./platform-compiler.js";export*from"./platform-decision-graph.js";export*from"./platform-docs.js";export*from"./platform-document.js";export*from"./platform-document-doc.js";export*from"./platform-ecosystem-operations.js";export*from"./platform-features.js";export*from"./platform-form-spec-serialization.js";export*from"./platform-form-spec-validation.js";export*from"./platform-operation-catalog.js";export*from"./platform-operation-errors.js";export*from"./platform-operations.js";export*from"./platform-product.js";export*from"./platform-registry.js";export*from"./platform-response-extension.js";export*from"./platform-validation.js";export*from"./richFieldsShowcase.form.js";

package/dist/forms/index.d.ts

@@ -0,0 +1,21 @@
+export * from './entity-bound-forms.js';
+export * from './forms.js';
+export * from './marketing.forms.js';
+export * from './platform-capability.js';
+export * from './platform-compiler.js';
+export * from './platform-decision-graph.js';
+export * from './platform-docs.js';
+export * from './platform-document.js';
+export * from './platform-document-doc.js';
+export * from './platform-ecosystem-operations.js';
+export * from './platform-features.js';
+export * from './platform-form-spec-serialization.js';
+export * from './platform-form-spec-validation.js';
+export * from './platform-operation-catalog.js';
+export * from './platform-operation-errors.js';
+export * from './platform-operations.js';
+export * from './platform-product.js';
+export * from './platform-registry.js';
+export * from './platform-response-extension.js';
+export * from './platform-validation.js';
+export * from './richFieldsShowcase.form.js';

package/dist/forms/index.js

@@ -0,0 +1 @@
+export*from"./entity-bound-forms.js";export*from"./forms.js";export*from"./marketing.forms.js";export*from"./platform-capability.js";export*from"./platform-compiler.js";export*from"./platform-decision-graph.js";export*from"./platform-docs.js";export*from"./platform-document.js";export*from"./platform-document-doc.js";export*from"./platform-ecosystem-operations.js";export*from"./platform-features.js";export*from"./platform-form-spec-serialization.js";export*from"./platform-form-spec-validation.js";export*from"./platform-operation-catalog.js";export*from"./platform-operation-errors.js";export*from"./platform-operations.js";export*from"./platform-product.js";export*from"./platform-registry.js";export*from"./platform-response-extension.js";export*from"./platform-validation.js";export*from"./richFieldsShowcase.form.js";

package/dist/forms/marketing.forms.d.ts

@@ -0,0 +1,71 @@
+/** Generic prop-driven marketing lead capture form contract. */
+export declare const MarketingLeadCaptureFormSpec: import("./forms").FormSpec<import("@lssm/lib.schema").SchemaModel<{
+    email: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    name: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    company: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    message: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>>;
+/** Generic estimate-input form contract for marketing pricing widgets. */
+export declare const MarketingEstimateInputFormSpec: import("./forms").FormSpec<import("@lssm/lib.schema").SchemaModel<{
+    primaryQuantity: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    secondaryQuantity: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    bundleKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    locale: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    currency: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>>;
+/** BillingOS-adjacent intake form for side-effect-free quote preparation. */
+export declare const BillingEstimateIntakeFormSpec: import("./forms").FormSpec<import("@lssm/lib.schema").SchemaModel<{
+    accountCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    documentCount: {
+        type: import("@lssm/lib.schema").FieldType<number, number>;
+        isOptional: false;
+    };
+    bundleKey: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    currency: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+}>>;
+export declare const MarketingFormsDocBlock: {
+    id: string;
+    title: string;
+    summary: string;
+    kind: "reference";
+    visibility: "public";
+    route: string;
+    tags: string[];
+    body: string;
+};

package/dist/forms/marketing.forms.js

@@ -0,0 +1 @@
+import{BillingEstimateIntakeInput as r,BillingEstimatePrepareQuery as i,MarketingEstimateCalculateInput as o,MarketingEstimateCalculateQuery as a,MarketingLeadCaptureCommand as n,MarketingLeadCaptureInput as m}from"../operations/index.js";import{defineFormSpec as e,responsiveFormColumns as t}from"./forms.js";export const MarketingLeadCaptureFormSpec=e({meta:{key:"marketing.lead.capture.form",version:"1.0.0",title:"Marketing lead capture form",description:"Generic marketing lead capture FormSpec; hosts own copy, provider logic, and operation handlers.",domain:"marketing",owners:["@contractspec-core"],tags:["marketing","forms","lead-capture"],stability:"experimental"},model:m,layout:{columns:t(2),gap:"md"},fields:[{kind:"email",name:"email",labelI18n:"Email",layout:{colSpan:"full"}},{kind:"text",name:"name",labelI18n:"Name"},{kind:"text",name:"company",labelI18n:"Company"},{kind:"textarea",name:"message",labelI18n:"Message",layout:{colSpan:"full"}}],actions:[{key:"submit",labelI18n:"Submit",op:{name:n.meta.key,version:n.meta.version}}],renderHints:{ui:"shadcn",form:"react-hook-form"}});export const MarketingEstimateInputFormSpec=e({meta:{key:"marketing.estimate.input.form",version:"1.0.0",title:"Marketing estimate input form",description:"Generic marketing estimate input FormSpec. Pricing math is supplied by host OperationSpec handlers.",domain:"marketing",owners:["@contractspec-core"],tags:["marketing","forms","pricing","estimate"],stability:"experimental"},model:o,layout:{columns:t(2),gap:"md"},fields:[{kind:"number",name:"primaryQuantity",labelI18n:"Primary quantity",min:0,step:1,inputMode:"numeric"},{kind:"number",name:"secondaryQuantity",labelI18n:"Secondary quantity",min:0,step:1,inputMode:"numeric"},{kind:"radio",name:"bundleKey",labelI18n:"Bundle",layout:{colSpan:"full"},options:{kind:"static",options:[{value:"starter",labelI18n:"Starter"},{value:"growth",labelI18n:"Growth"},{value:"scale",labelI18n:"Scale"}]}}],actions:[{key:"estimate",labelI18n:"Estimate",op:{name:a.meta.key,version:a.meta.version}}],renderHints:{ui:"shadcn",form:"react-hook-form"}});export const BillingEstimateIntakeFormSpec=e({meta:{key:"billing.estimate.intake.form",version:"1.0.0",title:"Billing estimate intake form",description:"Side-effect-free billing estimate intake FormSpec. Hosts provide estimate handlers; no payment execution is implied.",domain:"billing",owners:["@contractspec-core"],tags:["billing","forms","estimate"],stability:"experimental"},model:r,layout:{columns:t(2),gap:"md"},fields:[{kind:"number",name:"accountCount",labelI18n:"Account count",min:0,step:1,inputMode:"numeric"},{kind:"number",name:"documentCount",labelI18n:"Document count",min:0,step:1,inputMode:"numeric"},{kind:"text",name:"bundleKey",labelI18n:"Bundle key",layout:{colSpan:"full"}}],actions:[{key:"prepare",labelI18n:"Prepare estimate",op:{name:i.meta.key,version:i.meta.version}}],renderHints:{ui:"shadcn",form:"react-hook-form"}});export const MarketingFormsDocBlock={id:"docs.contracts-spec.forms.marketing",title:"Marketing & BillingOS-adjacent FormSpecs",summary:"Contract-first FormSpecs for form-like marketing/BillingOS UI; rendering goes through the design-system FormSpec renderer and submission binds to OperationSpecs.",kind:"reference",visibility:"public",route:"/docs/contracts-spec/forms/marketing",tags:["marketing","billing","forms","lead-capture","estimate"],body:"# Marketing & BillingOS-adjacent FormSpecs\n\nThree generic, reusable FormSpecs make form-like marketing/BillingOS UI\ncontract-first. Each binds its action to an OperationSpec by `key`+`version`;\nhosts own copy, option catalogs, provider logic, and handlers.\n\n- `marketing.lead.capture.form` (`MarketingLeadCaptureFormSpec`) \u2192 action binds\n  to `marketing.lead.capture` (command).\n- `marketing.estimate.input.form` (`MarketingEstimateInputFormSpec`) \u2192 action\n  binds to `marketing.estimate.calculate` (query). Bundle options are\n  illustrative defaults; hosts override them.\n- `billing.estimate.intake.form` (`BillingEstimateIntakeFormSpec`) \u2192 action binds\n  to `billing.estimate.prepare` (query, **side-effect-free**).\n\nThese specs are schema/layout/action metadata only. The design system renders\nfields and an operation/host-provided result; it never computes pricing, calls a\nprovider, payment, CRM, or invoice path. Live billing execution stays host-owned.\n\nRelationship to `marketing/forms.ts`: `MarketingStudioDemoRequestForm` +\n`marketingFormRegistry` are the Studio-specific demo-CTA form and its registry;\nthe specs here are the generic, reusable lead/estimate/billing forms."};

package/dist/forms/platform-ai-validation.d.ts

@@ -0,0 +1,3 @@
+import type { FormDocument } from './platform-document.js';
+import type { FormDocumentIssue } from './platform-validation.js';
+export declare function validateFormAiPolicy(document: FormDocument, issues: FormDocumentIssue[]): void;

package/dist/forms/platform-ai-validation.js

@@ -0,0 +1 @@
+import{FORM_AI_GENERATED_QUESTION_HARD_LIMIT as a}from"./platform-document.js";export function validateFormAiPolicy(s,o){const t=s.ai,n=new Set(s.questions.map(({id:e})=>e)),m=new Set([...n,...Object.keys(s.formSpec?.modelFields??{})]);if((t.maxGeneratedQuestions??t.staticLimit??0)>a||(t.maxModelCalls??0)>a)o.push({code:"ai_limit_exceeded",path:"ai",message:`AI calls and questions cannot exceed ${a}`});if(t.mode==="static-limit"&&(!t.staticLimit||t.staticLimit<1))o.push({code:"ai_static_limit_required",path:"ai.staticLimit",message:"Static AI mode requires a positive limit"});for(const[e,i]of[["maxModelCalls",t.maxModelCalls],["tokenBudget",t.tokenBudget],["costBudgetMinor",t.costBudgetMinor],["timeoutMs",t.timeoutMs]])if(i!==void 0&&(!Number.isInteger(i)||i<1))o.push({code:"ai_budget_invalid",path:`ai.${e}`,message:`${e} must be a positive integer`});for(const[e,i,d]of[["approvedQuestionIds",t.approvedQuestionIds,n],["allowedInputQuestionIds",t.allowedInputQuestionIds,m]])if(i?.some((u)=>!d.has(u)))o.push({code:"ai_question_unknown",path:`ai.${e}`,message:`${e} contains an unknown question ID`})}

package/dist/forms/platform-capability.d.ts

@@ -0,0 +1,3 @@
+export declare const FORM_PLATFORM_MILESTONE_FLAGS: readonly ['forms.v0', 'forms.v0_1', 'forms.v0_2', 'forms.v0_3', 'forms.v0_4', 'forms.v0_5', 'forms.v0_6'];
+export declare const FORM_PLATFORM_PERMISSIONS: readonly ['forms.create', 'forms.edit', 'forms.publish', 'forms.responses.read', 'forms.export.redacted', 'forms.export.sensitive', 'forms.ai.configure', 'forms.integrations.manage'];
+export declare const FormsPlatformCapability: import("..").CapabilitySpec;

package/dist/forms/platform-capability.js

@@ -0,0 +1 @@
+import{defineCapability as r}from"../capabilities/index.js";import{formPlatformEvents as s}from"./platform-ecosystem-operations.js";import{formPlatformOperations as e}from"./platform-operation-catalog.js";export const FORM_PLATFORM_MILESTONE_FLAGS=["forms.v0","forms.v0_1","forms.v0_2","forms.v0_3","forms.v0_4","forms.v0_5","forms.v0_6"];export const FORM_PLATFORM_PERMISSIONS=["forms.create","forms.edit","forms.publish","forms.responses.read","forms.export.redacted","forms.export.sensitive","forms.ai.configure","forms.integrations.manage"];export const FormsPlatformCapability=r({meta:{key:"forms.platform",version:"1.0.0",kind:"api",title:"Shared Forms Platform",description:"Portable form authoring, publication, response, verification, AI, and ecosystem contracts.",domain:"forms",owners:["platform.core"],tags:["forms","survey","i18n"],stability:"experimental"},provides:[...e.map((o)=>({surface:"operation",key:o.meta.key,version:o.meta.version})),...s.map((o)=>({surface:"event",key:o.meta.key,version:o.meta.version}))]});

package/dist/forms/platform-compiler.d.ts

@@ -0,0 +1,4 @@
+import { SchemaModel, type SchemaModelFieldsAnyConfig } from '@lssm/lib.schema';
+import type { FormSpec } from './forms.js';
+import type { FormDocument } from './platform-document.js';
+export declare function compileFormDocument(document: FormDocument): FormSpec<SchemaModel<SchemaModelFieldsAnyConfig>>;

package/dist/forms/platform-compiler.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as t,SchemaModel as c}from"@lssm/lib.schema";import{OwnersEnum as p,StabilityEnum as d,TagsEnum as y}from"../ownership.js";import{FormDocumentValidationError as h,validateFormDocument as f}from"./platform-validation.js";function o(e){return(e??[]).map((n)=>({labelI18n:n.labelKey,value:n.value,descriptionI18n:n.descriptionKey}))}function S(e){const n={name:e.name,labelI18n:e.labelKey,descriptionI18n:e.descriptionKey,placeholderI18n:e.placeholderKey,required:e.required,readOnly:e.readOnly,visibleWhen:e.visibleWhen,enabledWhen:e.enabledWhen,requiredWhen:e.requiredWhen};switch(e.kind){case"short-text":return{...n,kind:"text",minLength:e.minLength,maxLength:e.maxLength};case"long-text":return{...n,kind:"textarea",minLength:e.minLength,maxLength:e.maxLength};case"email":return{...n,kind:"email",minLength:e.minLength,maxLength:e.maxLength};case"phone":return{...n,kind:"phone",output:{mode:"e164"}};case"number":return{...n,kind:"number",min:e.min,max:e.max};case"date":return{...n,kind:"date"};case"time":return{...n,kind:"time"};case"single-choice":return{...n,kind:"radio",options:o(e.options)};case"multi-select":return{...n,kind:"multi-select",options:o(e.options),minSelections:e.min,maxSelections:e.max};case"dropdown":return{...n,kind:"select",options:o(e.options)};case"consent":return{...n,kind:"checkbox"}}}function F(e){return{type:e.kind==="email"?t.EmailAddress():e.kind==="phone"?t.PhoneNumber():e.kind==="number"?t.Float_unsecure():e.kind==="date"?t.Date():e.kind==="time"?t.Time():e.kind==="consent"?t.Boolean():t.String_unsecure(),isOptional:!e.required,...e.kind==="multi-select"?{isArray:!0}:{}}}function g(e){return{type:e.type==="email"?t.EmailAddress():e.type==="phone"?t.PhoneNumber():e.type==="number"?t.Float_unsecure():e.type==="integer"?t.Int_unsecure():e.type==="boolean"?t.Boolean():e.type==="date"?t.Date():e.type==="time"?t.Time():e.type==="datetime"?t.DateTime():e.type==="json"?t.JSONObject():t.String_unsecure(),isOptional:e.optional,...e.array?{isArray:!0}:{}}}export function compileFormDocument(e){const n=f(e);if(n.length)throw new h(n);const a=new Map(e.questions.map((r)=>[r.id,r])),m=e.pages.map((r)=>({key:r.id,titleI18n:r.titleKey,descriptionI18n:r.descriptionKey,fieldNames:r.questionIds.map((i)=>a.get(i)?.name).filter((i)=>Boolean(i))})),s=Object.fromEntries(e.formSpec?Object.entries(e.formSpec.modelFields).map(([r,i])=>[r,g(i)]):e.questions.map((r)=>[r.name,F(r)])),l=[{key:"submit",labelI18n:e.afterDestination?.labelKey??"forms.action.submit",...e.afterDestination?.kind==="https"?{success:{navigateTo:e.afterDestination.href}}:{}}];return{meta:{key:`forms.platform.${e.id}`,version:e.version,title:e.titleKey,description:e.descriptionKey??e.titleKey,domain:"forms",owners:[p.PlatformCore],tags:[y.I18n],stability:d.Experimental},model:new c({name:e.formSpec?.modelName??`FormDocument_${e.id.replace(/[^A-Za-z0-9_]/g,"_")}`,fields:s}),fields:e.formSpec?[...e.formSpec.fields]:e.questions.map(S),layout:e.formSpec?.layout??{flow:{kind:e.pages.length>1?"steps":"sections",sections:m}},actions:e.formSpec?.actions?[...e.formSpec.actions]:l,entityBinding:e.formSpec?.entityBinding,completion:e.formSpec?.completion,constraints:e.formSpec?.constraints?[...e.formSpec.constraints]:void 0,projection:e.formSpec?.projection,policy:e.formSpec?.policy,renderHints:e.formSpec?.renderHints}}

package/dist/forms/platform-decision-graph.d.ts

@@ -0,0 +1,6 @@
+import { type DecisionGraphDocument, type DecisionGraphRevision } from '../decisioning/index.js';
+import type { FormDocument } from './platform-document.js';
+/** Compile serializable Form branching into the shared, effect-free graph document. */
+export declare function formDocumentToDecisionGraph(form: FormDocument): DecisionGraphDocument;
+/** Pin a validated graph revision into a FormDocument for portable public rendering. */
+export declare function decisionGraphToFormDocument(form: FormDocument, revision: DecisionGraphRevision): FormDocument;

package/dist/forms/platform-decision-graph.js

@@ -0,0 +1 @@
+import{assertDecisionGraphValid as s}from"../decisioning/index.js";const d="form-outcome:submitted";function r(t,e){return t.edges.filter((i)=>i.from===e).sort((i,n)=>(n.priority??0)-(i.priority??0)||i.id.localeCompare(n.id))}export function formDocumentToDecisionGraph(t){return{key:`forms.branching.${t.id}`,version:t.version,entryNodeId:t.pages[0]?.id??"",nodes:[...t.pages.map((e)=>({id:e.id,kind:"branch",labelI18n:e.titleKey})),{id:d,kind:"outcome",outcomeKey:"submitted"}],edges:t.pages.flatMap((e,i)=>{const n=(e.nextPageRules??[]).map((o,a)=>({id:o.id,from:e.id,to:o.nextPageId,predicate:o.when,priority:(e.nextPageRules?.length??0)-a})),c=e.defaultNextPageId??t.pages[i+1]?.id??d;return[...n,{id:`${e.id}:default`,from:e.id,to:c}]}),policy:{requireTotalBranches:!0},localeCatalogs:t.content.catalogs,defaultLocale:t.content.defaultLocale}}function u(t,e){const i=r(e,t.id),n=i.filter((o)=>o.predicate),c=i.find((o)=>!o.predicate&&!o.subgraphOutcomeKey);return{...t,nextPageRules:n.map((o)=>({id:o.id,when:o.predicate,nextPageId:o.to})),defaultNextPageId:c&&e.nodes.some((o)=>o.id===c.to&&o.kind!=="outcome")?c.to:void 0}}export function decisionGraphToFormDocument(t,e){s(e.document);if(e.document.entryNodeId!==t.pages[0]?.id)throw Error("Decision graph entry must match the first form page.");const i=new Set(t.pages.map((n)=>n.id));for(const n of t.pages)for(const c of r(e.document,n.id)){const o=e.document.nodes.find((a)=>a.id===c.to);if(!o||o.kind!=="outcome"&&!i.has(o.id))throw Error(`Decision edge ${c.id} cannot be represented by this form.`)}return{...t,pages:t.pages.map((n)=>u(n,e.document)),decisionGraph:{key:e.graphKey,revision:e.revision,digest:e.digest}}}

package/dist/forms/platform-docs.d.ts

@@ -0,0 +1,18 @@
+export declare const formsOperationsDocIds: readonly [import("../docs").DocId];
+export declare const formsEventsDocIds: readonly [import("../docs").DocId];
+export declare const formPlatformOperationsDocBlock: {
+    id: string;
+    title: string;
+    body: string;
+    kind: "reference";
+    route: string;
+    visibility: "public";
+};
+export declare const formPlatformEventsDocBlock: {
+    id: string;
+    title: string;
+    body: string;
+    kind: "reference";
+    route: string;
+    visibility: "public";
+};

package/dist/forms/platform-docs.js

@@ -0,0 +1 @@
+import{docId as o}from"../docs/registry.js";export const formsOperationsDocIds=[o("forms-platform-operations")];export const formsEventsDocIds=[o("forms-platform-events")];export const formPlatformOperationsDocBlock={id:"forms-platform-operations",title:"Shared Forms operations",body:"Versioned creator and public operations. Creator ownership is derived from authenticated server context; public operations accept opaque tokens and never tenant authority. This experimental foundation does not claim product-host availability until its adapters pass Connect review.",kind:"reference",route:"/docs/specs/forms/platform-operations",visibility:"public"};export const formPlatformEventsDocBlock={id:"forms-platform-events",title:"Shared Forms events",body:"PII-free lifecycle receipts for definition, response, and verification transitions. Raw answers, contact destinations, and verification codes are never event payloads.",kind:"reference",route:"/docs/specs/forms/platform-events",visibility:"public"};

package/dist/forms/platform-document-doc.d.ts

@@ -0,0 +1,8 @@
+export declare const formPlatformDocumentDocBlock: {
+    id: string;
+    title: string;
+    body: string;
+    kind: "reference";
+    route: string;
+    visibility: "public";
+};

package/dist/forms/platform-document-doc.js

@@ -0,0 +1 @@
+export const formPlatformDocumentDocBlock={id:"forms-platform-document",title:"Shared Forms Platform Document",body:"Portable Forms contracts for Pactena, CompanyOS, and CommunicationOS. Published revisions are immutable, responses pin a revision, creator logic is declarative, AI is off and redacted by default, and product hosts retain authority and storage ownership.",kind:"reference",route:"/docs/specs/forms/platform-document",visibility:"public"};

package/dist/forms/platform-document.d.ts

@@ -0,0 +1,187 @@
+import type { DecisionGraphRef } from '../decisioning/types.js';
+import type { ConstraintDecl, FieldSpec, FormAction, FormCompletionSpec, FormEntityBinding, FormLayoutSpec, FormProjectionSpec, FormSpec, Predicate } from './forms.js';
+export declare const FORM_PLATFORM_VERSION: '1.0.0';
+export declare const FORM_AI_GENERATED_QUESTION_HARD_LIMIT: 10;
+export declare const FORM_AI_FULL_DATA_CONSENT_NOTICE_VERSION: 'forms-ai-full-data-v1';
+export type FormLifecycleStatus = 'draft' | 'published' | 'closed' | 'archived';
+export type FormQuestionKind = 'short-text' | 'long-text' | 'email' | 'phone' | 'number' | 'date' | 'time' | 'single-choice' | 'multi-select' | 'dropdown' | 'consent';
+export interface FormLocalizedContent {
+    defaultLocale: string;
+    enabledLocales: readonly string[];
+    catalogs: Readonly<Record<string, Readonly<Record<string, string>>>>;
+}
+export interface FormQuestionOptionDocument {
+    id: string;
+    value: string;
+    labelKey: string;
+    descriptionKey?: string;
+}
+export interface FormQuestionDocument {
+    id: string;
+    name: string;
+    kind: FormQuestionKind;
+    labelKey: string;
+    descriptionKey?: string;
+    placeholderKey?: string;
+    required?: boolean;
+    readOnly?: boolean;
+    /** Explicit PII/sensitive classification for redacted exports. */
+    sensitive?: boolean;
+    options?: readonly FormQuestionOptionDocument[];
+    visibleWhen?: Predicate;
+    enabledWhen?: Predicate;
+    requiredWhen?: Predicate;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    resolverKey?: string;
+}
+export interface FormPageDocument {
+    id: string;
+    titleKey: string;
+    descriptionKey?: string;
+    questionIds: readonly string[];
+    nextPageRules?: readonly FormPageRule[];
+    /** Explicit deterministic fallback when it is not the next page in document order. */
+    defaultNextPageId?: string;
+}
+export interface FormPageRule {
+    id: string;
+    when: Predicate;
+    nextPageId: string;
+}
+export type FormVerificationRequirement = 'none' | 'email' | 'phone' | 'either' | 'both';
+export type FormVerificationTiming = 'before' | 'after';
+export type FormUnverifiedDisposition = 'completed-unverified' | 'pending-hidden';
+export interface FormVerificationPolicy {
+    requirement: FormVerificationRequirement;
+    timing: FormVerificationTiming;
+    unverifiedDisposition: FormUnverifiedDisposition;
+}
+export type FormAiMode = 'off' | 'static-limit' | 'adaptive';
+export type FormAiDataMode = 'redacted' | 'full-with-consent' | 'self-hosted';
+export interface FormAiPolicy {
+    mode: FormAiMode;
+    dataMode: FormAiDataMode;
+    staticLimit?: number;
+    approvedQuestionIds?: readonly string[];
+    allowedInputQuestionIds?: readonly string[];
+    maxGeneratedQuestions?: number;
+    maxModelCalls?: number;
+    tokenBudget?: number;
+    costBudgetMinor?: number;
+    timeoutMs?: number;
+}
+export type FormDestination = {
+    kind: 'https';
+    href: string;
+    labelKey: string;
+} | {
+    kind: 'opa-profile';
+    profileRef: string;
+    labelKey: string;
+} | {
+    kind: 'opa-booking';
+    bookingRef: string;
+    labelKey: string;
+};
+export interface FormRetentionPolicy {
+    completedDays?: number;
+    pendingDraftDays: number;
+    verificationChallengeMinutes: number;
+}
+export interface FormIntegrationPolicy {
+    allowedResolverKeys?: readonly string[];
+    allowedActionKeys?: readonly string[];
+    allowedConstraintKeys?: readonly string[];
+    allowedComputationKeys?: readonly string[];
+    webhookRefs?: readonly string[];
+    extensionRefs?: readonly string[];
+}
+export type PortableFormScalar = 'string' | 'email' | 'phone' | 'number' | 'integer' | 'boolean' | 'date' | 'time' | 'datetime' | 'json';
+export interface PortableFormModelField {
+    readonly type: PortableFormScalar;
+    readonly optional: boolean;
+    readonly array?: boolean;
+}
+/** Serializable v0.4 projection of every renderer-facing FormSpec feature. */
+export interface PortableFormSpecDocument {
+    readonly modelName: string;
+    readonly modelFields: Readonly<Record<string, PortableFormModelField>>;
+    readonly fields: readonly FieldSpec[];
+    readonly entityBinding?: FormEntityBinding;
+    readonly completion?: FormCompletionSpec;
+    readonly layout?: FormLayoutSpec;
+    readonly actions?: readonly FormAction[];
+    readonly constraints?: readonly ConstraintDecl[];
+    readonly projection?: FormProjectionSpec;
+    readonly policy?: FormSpec['policy'];
+    readonly renderHints?: {
+        ui: 'shadcn' | 'custom';
+        form: 'react-hook-form';
+    };
+}
+export interface FormDocument {
+    kind: 'contractspec.form-document';
+    version: typeof FORM_PLATFORM_VERSION;
+    id: string;
+    titleKey: string;
+    descriptionKey?: string;
+    content: FormLocalizedContent;
+    questions: readonly FormQuestionDocument[];
+    pages: readonly FormPageDocument[];
+    /** Optional immutable graph revision from which page branching was compiled. */
+    decisionGraph?: DecisionGraphRef;
+    verification: FormVerificationPolicy;
+    ai: FormAiPolicy;
+    retention: FormRetentionPolicy;
+    integrations?: FormIntegrationPolicy;
+    formSpec?: PortableFormSpecDocument;
+    beforeDestination?: FormDestination;
+    afterDestination?: FormDestination;
+    metadata?: Readonly<Record<string, string | number | boolean>>;
+}
+export interface FormOwnerScope {
+    product: 'pactena' | 'companyos' | 'communicationos' | (string & {});
+    tenantRef: string;
+    workspaceRef?: string;
+    ownerRef: string;
+}
+export interface FormDefinition {
+    id: string;
+    owner: FormOwnerScope;
+    status: FormLifecycleStatus;
+    draft: FormDocument;
+    draftVersion: number;
+    publishedRevisionId?: string;
+    publicToken?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface FormRevision {
+    id: string;
+    definitionId: string;
+    revision: number;
+    document: FormDocument;
+    digest: string;
+    publishedAt: string;
+}
+export type FormResponseStatus = 'draft' | 'pending-verification' | 'completed-unverified' | 'completed' | 'deleted';
+export type FormAuthorAssurance = 'anonymous' | 'email' | 'phone' | 'both';
+export type FormAnswerValue = string | number | boolean | null | readonly FormAnswerValue[] | {
+    readonly [key: string]: FormAnswerValue;
+};
+export interface FormResponse {
+    id: string;
+    definitionId: string;
+    revisionId: string;
+    locale: string;
+    status: FormResponseStatus;
+    authorAssurance: FormAuthorAssurance;
+    answers: Readonly<Record<string, FormAnswerValue>>;
+    source?: Readonly<Record<string, string>>;
+    submittedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/forms/platform-document.js

@@ -0,0 +1 @@
+export const FORM_PLATFORM_VERSION="1.0.0";export const FORM_AI_GENERATED_QUESTION_HARD_LIMIT=10;export const FORM_AI_FULL_DATA_CONSENT_NOTICE_VERSION="forms-ai-full-data-v1";

package/dist/forms/platform-ecosystem-operations.d.ts

@@ -0,0 +1,8 @@
+import { SchemaModel, type SchemaModelFieldsAnyConfig } from '@lssm/lib.schema';
+export declare const FormResponsesListQuery: import("..").OperationSpec<SchemaModel<SchemaModelFieldsAnyConfig>, SchemaModel<SchemaModelFieldsAnyConfig>, undefined>;
+export declare const FormResponseGetQuery: import("..").OperationSpec<SchemaModel<SchemaModelFieldsAnyConfig>, SchemaModel<SchemaModelFieldsAnyConfig>, undefined>;
+export declare const FormResponsesExportQuery: import("..").OperationSpec<SchemaModel<SchemaModelFieldsAnyConfig>, SchemaModel<SchemaModelFieldsAnyConfig>, undefined>;
+export declare const FormResponseEraseCommand: import("..").OperationSpec<SchemaModel<SchemaModelFieldsAnyConfig>, SchemaModel<SchemaModelFieldsAnyConfig>, undefined>;
+export declare const FormAiAnalysisRequestCommand: import("..").OperationSpec<SchemaModel<SchemaModelFieldsAnyConfig>, SchemaModel<SchemaModelFieldsAnyConfig>, undefined>;
+export declare const FormIntegrationConfigureCommand: import("..").OperationSpec<SchemaModel<SchemaModelFieldsAnyConfig>, SchemaModel<SchemaModelFieldsAnyConfig>, undefined>;
+export declare const formPlatformEvents: import("..").EventSpec<SchemaModel<SchemaModelFieldsAnyConfig>>[];

package/dist/forms/platform-ecosystem-operations.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as s,SchemaModel as I}from"@lssm/lib.schema";import{defineEvent as v}from"../events.js";import{defineCommand as O,defineQuery as h}from"../operations/index.js";import{formsEventsDocIds as S,formsOperationsDocIds as u}from"./platform-docs.js";import{formsOperationErrors as y}from"./platform-operation-errors.js";const g={key:"forms.platform",version:"1.0.0"};const m=["platform.core"];const d=["forms","survey","i18n"];function e(r,o){return new I({name:r,fields:o})}const t={type:s.ID(),isOptional:!1};const c={type:s.ID(),isOptional:!1};const x={type:s.ID(),isOptional:!1};const n={type:s.JSONObject(),isOptional:!1};const p={type:s.String_unsecure(),isOptional:!0};const R=e("FormsReceiptOutput",{receiptId:{type:s.ID(),isOptional:!1},status:{type:s.NonEmptyString(),isOptional:!1}});const C=e("FormsResponseOutput",{response:n});function f(r,o,i,a=R){return O({meta:{key:r,title:o,version:"1.0.0",description:o,goal:o,context:"Shared Forms platform operation with server-derived scope.",domain:"forms",owners:[...m],tags:[...d],stability:"experimental",docId:[...u]},capability:g,io:{input:i,output:a,errors:y},policy:{auth:"user",pii:[]}})}function l(r,o,i,a,F=[]){return h({meta:{key:r,title:o,version:"1.0.0",description:o,goal:o,context:"Shared Forms results query with server-derived scope.",domain:"forms",owners:[...m],tags:[...d],stability:"experimental",docId:[...u]},capability:g,io:{input:i,output:a,errors:y},policy:{auth:"user",pii:F}})}export const FormResponsesListQuery=l("forms.responses.list","List form responses",e("FormResponsesListInput",{definitionId:t,cursor:p,status:p}),e("FormResponsesListOutput",{page:n}),["page.responses.answers"]);export const FormResponseGetQuery=l("forms.response.get","Get form response",e("FormResponseGetInput",{definitionId:t,responseId:c}),C,["response.answers"]);export const FormResponsesExportQuery=l("forms.responses.export","Export form responses",e("FormResponsesExportInput",{definitionId:t,cursor:p,includeSensitive:{type:s.Boolean(),isOptional:!0}}),e("FormResponsesExportOutput",{export:n}),["export.answers"]);export const FormResponseEraseCommand=f("forms.response.erase","Erase form response",e("FormResponseEraseInput",{definitionId:t,responseId:c}));export const FormAiAnalysisRequestCommand=f("forms.ai-analysis.request","Request form response analysis",e("FormAiAnalysisRequestInput",{definitionId:t}),e("FormAiAnalysisRequestOutput",{analysis:n}));export const FormIntegrationConfigureCommand=f("forms.integration.configure","Configure form integration",e("FormIntegrationConfigureInput",{definitionId:t,configuration:n}),e("FormIntegrationConfigureOutput",{integration:n}));const A=e("FormPlatformEventPayload",{definitionId:t,revisionId:{...x,isOptional:!0},responseId:{...c,isOptional:!0},occurredAt:{type:s.DateTime(),isOptional:!1},receiptId:{type:s.ID(),isOptional:!0}});const E=[["forms.definition.created","Form definition created"],["forms.draft.saved","Form draft saved"],["forms.definition.published","Form definition published"],["forms.definition.closed","Form definition closed"],["forms.definition.archived","Form definition archived"],["forms.response.submitted","Form response submitted"],["forms.response.erased","Form response erased"],["forms.verification.completed","Form verification completed"]];export const formPlatformEvents=E.map(([r,o])=>v({meta:{key:r,title:o,version:"1.0.0",description:o,owners:[...m],tags:[...d],stability:"experimental",docId:[...S]},payload:A,pii:[]}));

package/dist/forms/platform-features.d.ts

@@ -0,0 +1 @@
+export declare const FormsMilestoneFeatures: import("..").FeatureModuleSpec[];

package/dist/forms/platform-features.js

@@ -0,0 +1 @@
+import{defineFeature as r}from"../features/index.js";import{FORM_PLATFORM_MILESTONE_FLAGS as o}from"./platform-capability.js";function t(e){return r({meta:{key:e,version:"1.0.0",title:`Forms milestone ${e.slice(6)}`,description:`Independently deployable and reversible ${e} Forms milestone.`,domain:"forms",owners:["platform.core"],tags:["forms","feature-flag"],stability:"experimental"},capabilities:{provides:[{key:e,version:"1.0.0"}]}})}export const FormsMilestoneFeatures=o.map(t);

package/dist/forms/platform-form-spec-serialization.d.ts

@@ -0,0 +1,4 @@
+import type { FormSpec } from './forms.js';
+import type { PortableFormSpecDocument } from './platform-document.js';
+/** Removes the live schema and freezes only declarative FormSpec metadata. */
+export declare function serializePortableFormSpec(spec: FormSpec): PortableFormSpecDocument;

package/dist/forms/platform-form-spec-serialization.js

@@ -0,0 +1 @@
+function t(r){if(r.kind==="email")return"email";if(r.kind==="phone")return"phone";if(["number","percent","currency","duration"].includes(r.kind))return"number";if(["checkbox","switch"].includes(r.kind))return"boolean";if(r.kind==="date")return"date";if(r.kind==="time")return"time";if(r.kind==="datetime")return"datetime";if(r.kind==="group"||r.kind==="array")return"json";return"string"}export function serializePortableFormSpec(r){const n=r.fields.filter((e)=>Boolean(e.name));return structuredClone({modelName:`FormSpec_${r.meta.key.replace(/[^A-Za-z0-9_]/g,"_")}`,modelFields:Object.fromEntries(n.map((e)=>[e.name,{type:t(e),optional:!e.required,...e.kind==="array"||e.kind==="multi-select"?{array:!0}:{}}])),fields:r.fields,entityBinding:r.entityBinding,completion:r.completion,layout:r.layout,actions:r.actions,constraints:r.constraints,projection:r.projection,policy:r.policy,renderHints:r.renderHints})}

package/dist/forms/platform-form-spec-validation.d.ts

@@ -0,0 +1,6 @@
+import type { FieldSpec } from './forms.js';
+import type { FormDocument } from './platform-document.js';
+import type { FormDocumentIssue } from './platform-validation.js';
+export declare function flattenPortableFormFields(input: readonly FieldSpec[]): FieldSpec[];
+export declare function portableFormAnswerFields(input: readonly FieldSpec[]): FieldSpec[];
+export declare function validatePortableFormSpec(document: FormDocument, issues: FormDocumentIssue[]): void;

package/dist/forms/platform-form-spec-validation.js

@@ -0,0 +1 @@
+export function flattenPortableFormFields(o){return o.flatMap((e)=>e.kind==="group"?[e,...flattenPortableFormFields(e.fields)]:e.kind==="array"?[e,...flattenPortableFormFields([e.of])]:[e])}export function portableFormAnswerFields(o){return o.flatMap((e)=>e.kind==="group"?e.name?[e]:portableFormAnswerFields(e.fields):[e])}function s(o){return o&&typeof o==="object"&&"kind"in o&&o.kind==="resolver"?o.resolverKey:void 0}function c(o){if(o.kind==="autocomplete"&&o.source.kind==="resolver")return[o.source.resolverKey];if(o.kind==="select"||o.kind==="multi-select"||o.kind==="radio")return[s(o.options)].filter((e)=>Boolean(e));if(o.kind==="address"||o.kind==="phone")return[s(o.countryOptions)].filter((e)=>Boolean(e));return[]}function i(o,e,n,a){for(const r of e)if(!n.includes(r))a.push({code:`form_spec_${o}_not_allowed`,path:"formSpec",message:`FormSpec ${o} ${r} is not allowlisted`})}export function validatePortableFormSpec(o,e){const n=o.formSpec;if(!n)return;try{structuredClone(n);const t=JSON.stringify(n);if(!t||t.length>1e6)throw Error("size")}catch{e.push({code:"form_spec_not_serializable",path:"formSpec",message:"FormSpec metadata must be portable JSON without functions"});return}const a=flattenPortableFormFields(n.fields),r=o.integrations;i("resolver",a.flatMap(c),r?.allowedResolverKeys??[],e);i("computation",a.flatMap((t)=>t.computeFrom?[t.computeFrom.computeKey]:[]),r?.allowedComputationKeys??[],e);i("constraint",(n.constraints??[]).map(({key:t})=>t),r?.allowedConstraintKeys??[],e);i("action",(n.actions??[]).map(({key:t})=>t),r?.allowedActionKeys??[],e)}

package/dist/forms/platform-locale-validation.d.ts

@@ -0,0 +1,3 @@
+import type { FormDocument } from './platform-document.js';
+import type { FormDocumentIssue } from './platform-validation.js';
+export declare function validateFormLocales(document: FormDocument, issues: FormDocumentIssue[]): void;

package/dist/forms/platform-locale-validation.js

@@ -0,0 +1 @@
+function c(t){return[t.titleKey,t.descriptionKey,...t.pages.flatMap((e)=>[e.titleKey,e.descriptionKey]),...t.questions.flatMap((e)=>[e.labelKey,e.descriptionKey,e.placeholderKey,...(e.options??[]).flatMap((a)=>[a.labelKey,a.descriptionKey])]),t.beforeDestination?.labelKey,t.afterDestination?.labelKey].filter((e)=>Boolean(e))}export function validateFormLocales(t,e){const a=t.content.enabledLocales;if(new Set(a.map((o)=>o.toLowerCase())).size!==a.length)e.push({code:"duplicate_locale",path:"content.enabledLocales",message:"Enabled locales must be unique"});for(const o of a){try{new Intl.Locale(o)}catch{e.push({code:"invalid_locale",path:"content.enabledLocales",message:`Locale ${o} must be a valid BCP-47 tag`})}const n=t.content.catalogs[o]??{};for(const l of c(t))if(!(l in n))e.push({code:"missing_content_key",path:`content.catalogs.${o}.${l}`,message:`Locale ${o} is missing content key ${l}`})}}

package/dist/forms/platform-operation-catalog.d.ts

@@ -0,0 +1 @@
+export declare const formPlatformOperations: readonly [import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>, import("..").OperationSpec<import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, import("@lssm/lib.schema").SchemaModel<import("@lssm/lib.schema").SchemaModelFieldsAnyConfig>, undefined>];

package/dist/forms/platform-operation-catalog.js

@@ -0,0 +1 @@
+import{FormAiAnalysisRequestCommand as o,FormIntegrationConfigureCommand as m,FormResponseEraseCommand as r,FormResponseGetQuery as e,FormResponsesExportQuery as n,FormResponsesListQuery as i}from"./platform-ecosystem-operations.js";import{FormDefinitionArchiveCommand as t,FormDefinitionCloseCommand as s,FormDefinitionCreateCommand as a,FormDefinitionGetQuery as F,FormDefinitionListQuery as C,FormDefinitionPublishCommand as f,FormDraftSaveCommand as d,FormPublicGetQuery as p,FormResponseAdvanceCommand as u,FormResponseSubmitCommand as c,FormVerificationConfirmCommand as y,FormVerificationStartCommand as D}from"./platform-operations.js";export const formPlatformOperations=[a,C,F,d,f,s,t,i,e,n,r,p,c,u,D,y,o,m];