@verbb/formie-core 1.0.12 → 1.0.14

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 ## Unreleased
 
+## 1.0.14 - 2026-10-08
+
+### Added
+- Add the shared, versioned reference grammar and typed browser source diagnostics.
+
+### Changed
+- Expose one canonical payment decision across REST and GraphQL instead of parallel beta response fields.
+- Keep numeric condition semantics separate from decimal-string runtime field types.
+- Version browser-module manifests around one explicit surface, discriminated targets and configured occurrence keys without decorative capabilities.
+- Share versioned tri-state conditions and plain-text validation rules across PHP and browser consumers; enforce recursive hidden-value clearing and server-authoritative navigation.
+- Preserve exact nested submission error paths, return typed page-transition results, and distinguish skipped side effects from invalid condition configuration.
+- Consume the shared completion outcome and preserve the server-owned configuration and query-prefill boundary.
+- Version the client-rendered bootstrap and module contract, enforce explicit request profiles, stage selected files and expose shared browser-module host seams.
+- Describe only non-null normalized field types because `null` is the universal absent value, and keep browser-input defaults separate from public data projections.
+- Support browser-bound progress, purpose-bound grant exchange, revision sessions and portable Save & Continue responses across REST and GraphQL. Clear exchanged tokens from browser history, issue browser-bound upload-creation capabilities and preserve structured upload attachment references.
+- Carry submission versions and typed outcomes through REST and GraphQL; return expected rejection and conflict payloads to renderers.
+
+### Fixed
+- Expose Formie's field-error announcement preference and stable, form-scoped error-region IDs to definition-driven renderers. ([#2954](https://github.com/verbb/formie/issues/2954))
+- Read the field structure metadata emitted by current Craft client bootstrap responses.
+
+## 1.0.13 - 2026-07-09
+
+### Changed
+- Released alongside the other `@verbb/formie-*` packages to keep versions aligned (@verbb/formie-core).
+
 ## 1.0.12 - 2026-07-02
 
 ### Changed
@@ -20,7 +46,7 @@
 ## 1.0.9 - 2026-06-25
 
 ### Added
-- Extend `FrontendSubmitResult` and `submitFormieClientForm` GraphQL selections with payment follow-up fields (`paymentStatus`, `paymentMessage`, `paymentRedirectUrl`, `paymentAction`, `paymentDecision`, `keepSubmitLoading`), plus `quizResult` and `clientEvents`. ([#1375](https://github.com/verbb/formie/issues/1375))
+- Extend `ClientSubmitResult` and `submitFormieClientForm` GraphQL selections with payment follow-up fields (`paymentStatus`, `paymentMessage`, `paymentRedirectUrl`, `paymentAction`, `paymentDecision`, `keepSubmitLoading`), plus `quizResult` and `clientEvents`. ([#1375](https://github.com/verbb/formie/issues/1375))
 
 ## 1.0.8 - 2026-06-24
 

package/dist/accessibility.d.ts

@@ -0,0 +1,5 @@
+import type { ClientFormDefinition, ClientFormSession } from './types';
+export type ClientErrorAriaLive = 'polite' | 'assertive' | 'off';
+export declare function getClientErrorAriaLive(definition: ClientFormDefinition): ClientErrorAriaLive;
+export declare function getClientFieldErrorId(session: ClientFormSession, errorKey: string): string;
+//# sourceMappingURL=accessibility.d.ts.map

package/dist/accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../src/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;AAEjE,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,oBAAoB,GAAG,mBAAmB,CAE5F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1F"}

package/dist/browser-modules.d.ts

@@ -0,0 +1,34 @@
+/** The wire contract is shared by both markup products and CP editing. */
+export declare const BROWSER_MODULE_CONTRACT_VERSION = 2;
+export type BrowserSurface = 'server-rendered' | 'client-rendered' | 'cp-edit';
+export type BrowserModuleKind = 'field' | 'captcha' | 'payment' | 'address' | 'core';
+export type BrowserModuleTarget = {
+    type: 'form';
+} | {
+    type: 'field';
+    uid: string;
+} | {
+    type: 'page';
+    id: string;
+} | {
+    type: 'action';
+    action: string;
+} | {
+    type: 'selector';
+    selector: string;
+};
+export type BrowserModuleEntry = {
+    key: string;
+    moduleId: string;
+    kind: BrowserModuleKind;
+    targets: BrowserModuleTarget[];
+    config: Record<string, unknown>;
+    required: boolean;
+};
+export type BrowserModuleManifest = {
+    contractVersion: 2;
+    surface: BrowserSurface;
+    entries: BrowserModuleEntry[];
+};
+export declare function assertBrowserModuleManifest(value: unknown): asserts value is BrowserModuleManifest;
+//# sourceMappingURL=browser-modules.d.ts.map

package/dist/browser-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-modules.d.ts","sourceRoot":"","sources":["../src/browser-modules.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,+BAA+B,IAAI,CAAC;AACjD,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AACrF,MAAM,MAAM,mBAAmB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7C,MAAM,MAAM,kBAAkB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;CACrB,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG;IAAE,eAAe,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC;AAEnH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,qBAAqB,CA8BlG"}

package/dist/condition-projections.d.ts

@@ -0,0 +1,6 @@
+/** Row scopes consume normalized rows; selectors and row identity remain explicit. */
+export declare function selectConditionRows(rows: unknown[], params: Record<string, string>, current?: number): {
+    value?: unknown;
+    diagnostic?: string;
+};
+//# sourceMappingURL=condition-projections.d.ts.map

package/dist/condition-projections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-projections.d.ts","sourceRoot":"","sources":["../src/condition-projections.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAsB/I"}

package/dist/condition-state.d.ts

@@ -0,0 +1,13 @@
+import type { ConditionEvaluation } from './conditions';
+import type { ClientFieldDefinition, ClientFormState } from './types';
+type Occurrence = {
+    field: ClientFieldDefinition;
+    key: string;
+    path: string[];
+    parent?: string;
+};
+export declare function evaluateClientCondition(condition: ClientFieldDefinition['condition'], state: ClientFormState, target?: Occurrence): ConditionEvaluation;
+export declare function clientActionAllowed(state: ClientFormState): boolean;
+export declare function deriveConditionState(state: ClientFormState): ClientFormState;
+export {};
+//# sourceMappingURL=condition-state.d.ts.map

package/dist/condition-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-state.d.ts","sourceRoot":"","sources":["../src/condition-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAC;AAE5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAItE,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,qBAAqB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAsBjG,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,mBAAmB,CAqCvJ;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAKnE;AACD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAmD5E"}

package/dist/conditions.d.ts

@@ -1,17 +1,31 @@
-export type FrontendConditionRule = {
+export type ConditionValueType = 'text' | 'number' | 'boolean' | 'date' | 'time' | 'datetime' | 'collection';
+export type ConditionEvaluation = {
+    value: boolean | null;
+    diagnostics: Array<{
+        code: string;
+        rule?: number;
+    }>;
+};
+export type ClientConditionRule = {
     condition: string;
     value?: unknown;
+    valueType?: ConditionValueType;
+    browserSafe?: boolean;
 };
-export type FrontendConditionSettings = {
-    showRule: 'show' | 'hide';
+export type ClientConditionSettings = {
+    showRule: 'show' | 'hide' | 'enable' | 'disable';
     conditionRule: 'all' | 'any';
-    conditions: FrontendConditionRule[];
+    conditions: ClientConditionRule[];
 };
-export declare function evaluateConditionDefinition(condition: FrontendConditionRule, actualValues: string[], options?: {
+export declare function conditionNumber(value: unknown): number | null;
+export declare function evaluateCondition(operator: string, actual: unknown, expected: unknown, type?: ConditionValueType): ConditionEvaluation;
+export declare function combineConditions(mode: string, results: ConditionEvaluation[]): ConditionEvaluation;
+export declare function evaluateConditionDefinition(condition: ClientConditionRule, actualValues: string[], options?: {
     visibility?: boolean | null;
-}): boolean;
-export declare function finalizeConditionEvaluation(settings: Pick<FrontendConditionSettings, 'conditionRule' | 'showRule'>, results: boolean[]): {
+}): ConditionEvaluation;
+export declare function finalizeConditionEvaluation(settings: Pick<ClientConditionSettings, 'conditionRule' | 'showRule'>, results: Array<ConditionEvaluation | boolean>): {
     finalResult: boolean;
     shouldHide: boolean;
+    evaluation: ConditionEvaluation;
 };
 //# sourceMappingURL=conditions.d.ts.map

package/dist/conditions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../src/conditions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACpC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,aAAa,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACvC,CAAC;AAkEF,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,qBAAqB,EAChC,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,GAAE;IACL,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B,GACP,OAAO,CAyCT;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,yBAAyB,EAAE,eAAe,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG;IACtI,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACvB,CAaA"}
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../src/conditions.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAC7G,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AACjH,MAAM,MAAM,mBAAmB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAChI,MAAM,MAAM,uBAAuB,GAAG;IAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,aAAa,EAAE,KAAK,GAAG,KAAK,CAAC;IAAC,UAAU,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAK5J,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI7D;AA4DD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,GAAE,kBAA2B,GAAG,mBAAmB,CA4B9I;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,CAKnG;AAGD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAO,GAAG,mBAAmB,CAItK;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,GAAG,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,mBAAmB,GAAG,OAAO,CAAC,GAAG;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,CAIhP"}

package/dist/contract.d.ts

@@ -0,0 +1,4 @@
+import type { ClientFormBootstrap } from './types';
+export declare const CLIENT_FORM_CONTRACT_VERSION = 1;
+export declare function assertClientFormBootstrap(value: unknown): asserts value is ClientFormBootstrap;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,mBAAmB,CAS9F"}

package/dist/date-parts-validation.d.ts

@@ -1,4 +1,4 @@
-import type { FrontendFieldDefinition } from './types';
+import type { ClientFieldDefinition } from './types';
 export declare function isValidCalendarDate(year: number, month: number, day: number): boolean;
-export declare function validateCompositeDateParts(field: FrontendFieldDefinition, value: unknown, errorKey: string, output: Record<string, string[]>): void;
+export declare function validateCompositeDateParts(field: ClientFieldDefinition, value: unknown, errorKey: string, output: Record<string, string[]>): void;
 //# sourceMappingURL=date-parts-validation.d.ts.map

package/dist/date-parts-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-parts-validation.d.ts","sourceRoot":"","sources":["../src/date-parts-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AA4BvD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAUrF;AAaD,wBAAgB,0BAA0B,CACtC,KAAK,EAAE,uBAAuB,EAC9B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACjC,IAAI,CAiDN"}
+{"version":3,"file":"date-parts-validation.d.ts","sourceRoot":"","sources":["../src/date-parts-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA4BrD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAUrF;AAaD,wBAAgB,0BAA0B,CACtC,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACjC,IAAI,CAiDN"}

package/dist/event-names.d.ts

@@ -1,2 +1,2 @@
-export declare const FRONTEND_CLIENT_EVENT_NAMES: readonly ["formie:client:ready", "formie:submit:result", "formie:page:navigate", "formie:page:navigate:error", "formie:session:refreshed", "formie:session:refresh:error", "formie:state:reset"];
+export declare const CLIENT_FORM_EVENT_NAMES: readonly ["formie:client:ready", "formie:submit:result", "formie:page:navigate", "formie:page:navigate:error", "formie:session:refreshed", "formie:session:refresh:error", "formie:state:reset"];
 //# sourceMappingURL=event-names.d.ts.map

package/dist/event-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-names.d.ts","sourceRoot":"","sources":["../src/event-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,kMAQ9B,CAAC"}
+{"version":3,"file":"event-names.d.ts","sourceRoot":"","sources":["../src/event-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,kMAQ1B,CAAC"}

package/dist/events.d.ts

@@ -1,5 +1,5 @@
 type EventCallback = (payload: unknown) => void;
-export declare class FrontendEventEmitter {
+export declare class ClientEventEmitter {
     private listeners;
     on(eventName: string, callback: EventCallback): () => void;
     emit(eventName: string, payload: unknown): void;

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAEhD,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,SAAS,CAAyC;IAE1D,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAc1D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;CAWlD"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAEhD,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAyC;IAE1D,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAc1D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;CAWlD"}

package/dist/form-instance.d.ts

@@ -1,8 +1,8 @@
-import type { FrontendFormEnvelope, FrontendFormInstance, FrontendTransport } from './types';
-type CreateFrontendFormInstanceOptions = {
-    envelope: FrontendFormEnvelope;
-    transport: FrontendTransport;
+import type { ClientFormBootstrap, ClientFormInstance, ClientTransport } from './types';
+type CreateClientFormInstanceOptions = {
+    envelope: ClientFormBootstrap;
+    transport: ClientTransport;
 };
-export declare function createFrontendFormInstance({ envelope, transport }: CreateFrontendFormInstanceOptions): FrontendFormInstance;
+export declare function createClientFormInstance({ envelope, transport }: CreateClientFormInstanceOptions): ClientFormInstance;
 export {};
 //# sourceMappingURL=form-instance.d.ts.map

package/dist/form-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-instance.d.ts","sourceRoot":"","sources":["../src/form-instance.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAER,oBAAoB,EACpB,oBAAoB,EAIpB,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAEjB,KAAK,iCAAiC,GAAG;IACrC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,EAAE,iBAAiB,CAAC;CAChC,CAAC;AAucF,wBAAgB,0BAA0B,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,iCAAiC,GAAG,oBAAoB,CA8R3H"}
+{"version":3,"file":"form-instance.d.ts","sourceRoot":"","sources":["../src/form-instance.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAER,mBAAmB,EACnB,kBAAkB,EAIlB,eAAe,EAClB,MAAM,SAAS,CAAC;AAEjB,KAAK,+BAA+B,GAAG;IACnC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,SAAS,EAAE,eAAe,CAAC;CAC9B,CAAC;AAoNF,wBAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,+BAA+B,GAAG,kBAAkB,CAiYrH"}

package/dist/grants.d.ts

@@ -0,0 +1,3 @@
+/** Remove an exchanged bearer from browser history without changing unrelated query values. */
+export declare function clearExchangedGrant(token?: string): void;
+//# sourceMappingURL=grants.d.ts.map

package/dist/grants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grants.d.ts","sourceRoot":"","sources":["../src/grants.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAWxD"}

package/dist/graphql.d.ts

@@ -1,10 +1,15 @@
-import type { FrontendFormEnvelope, FrontendTransport } from './types';
-export type GraphqlFrontendTransportOptions = {
+import { type BrowserRequestOptions } from './request-profile';
+import type { ClientFormBootstrap, ClientTransport } from './types';
+export type GraphqlClientTransportOptions = BrowserRequestOptions & {
     endpoint: string;
     formHandle: string;
     siteId?: number;
     credentials?: RequestCredentials;
+    grantToken?: string;
+    grantPurpose?: 'continue-incomplete' | 'revise-complete';
+    draftContext?: string;
+    query?: Record<string, string | string[]>;
 };
-export declare function loadGraphqlFrontendEnvelope(options: GraphqlFrontendTransportOptions): Promise<FrontendFormEnvelope>;
-export declare function createGraphqlFrontendTransport(options: GraphqlFrontendTransportOptions): FrontendTransport;
+export declare function loadGraphqlClientFormBootstrap(options: GraphqlClientTransportOptions): Promise<ClientFormBootstrap>;
+export declare function createGraphqlClientTransport(options: GraphqlClientTransportOptions): ClientTransport;
 //# sourceMappingURL=graphql.d.ts.map

package/dist/graphql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAER,oBAAoB,EAGpB,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,+BAA+B,GAAG;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAkFF,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2BzH;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,+BAA+B,GAAG,iBAAiB,CAmG1G"}
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,KAAK,EAER,mBAAmB,EAGnB,eAAe,EAClB,MAAM,SAAS,CAAC;AAIjB,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,GAAG;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,CAAC;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C,CAAC;AAqFF,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiCzH;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,eAAe,CAqGpG"}

package/dist/index.d.ts

@@ -1,11 +1,27 @@
-export { createFrontendFormInstance } from './form-instance';
-export { FRONTEND_CLIENT_EVENT_NAMES } from './event-names';
+export { createClientFormInstance } from './form-instance';
+export { CLIENT_FORM_EVENT_NAMES } from './event-names';
 export { coerceCalculationVariables, evaluateCalculationExpression, formatCalculationValue, getCalculationFormula, getCalculationVariableEntries, readCalculationVariableValue, } from './calculations';
 export type { CalculationFormula, CalculationOptions, CalculationVariable, CalculationVariableEntry, } from './calculations';
 export { evaluateConditionDefinition, finalizeConditionEvaluation } from './conditions';
-export { createRestFrontendTransport, loadFrontendEnvelope } from './rest';
-export { createGraphqlFrontendTransport, loadGraphqlFrontendEnvelope } from './graphql';
-export { allFields, compositePartDefinitions, createRepeaterRowValue, defaultValueForField, fieldValueContract, fieldValueStructure, fieldValueAsStrings, findFieldById, findFieldByHandle, isBooleanField, isCompositeField, isEmailField, isFileField, isKnownFrontendFieldType, isMultiValueField, isNumericField, isRepeatableField, repeaterFieldDefinitions, repeaterRowDefinitions, serializeFieldValues, serializeTransportFieldValues, } from './schema';
+export { buildActionUrl, createRestClientTransport, loadClientFormBootstrap } from './rest';
+export { createGraphqlClientTransport, loadGraphqlClientFormBootstrap } from './graphql';
+export { allFields, compositePartDefinitions, createRepeaterRowValue, defaultValueForField, fieldValueContract, fieldValueStructure, fieldValueAsStrings, findFieldById, findFieldByHandle, isBooleanField, isCompositeField, isEmailField, isFileField, isKnownClientFieldType, isMultiValueField, isNumericField, isRepeatableField, repeaterFieldDefinitions, repeaterRowDefinitions, serializeFieldValues, serializeTransportFieldValues, } from './schema';
 export { countGraphemes, getTextLimitMetrics, getWordCount, normalizeText } from './text';
-export type { FrontendFieldDefinition, FrontendFieldValueContract, FrontendFieldValueStructure, FrontendFieldType, FrontendFieldValueClass, FrontendFormDefinition, FrontendFormEnvelope, FrontendFormSession, KnownFrontendFieldType, FrontendPageDefinition, FrontendRowDefinition, FrontendFormEventName, FrontendFormFieldState, FrontendFormInstance, FrontendFormPageState, FrontendFormState, FrontendSubmitAction, FrontendSubmitResult, FrontendTransport, FrontendValidationRule, } from './types';
+export { getClientErrorAriaLive, getClientFieldErrorId } from './accessibility';
+export type { ClientErrorAriaLive } from './accessibility';
+export type { ClientFieldDefinition, ClientFieldValueContract, ClientFieldValueStructure, ClientFieldType, ClientFieldValueType, ClientFormDefinition, ClientFormBootstrap, ClientFormSession, KnownClientFieldType, ClientPageDefinition, ClientRowDefinition, ClientFormEventName, ClientFormFieldState, ClientFormInstance, ClientFormPageState, ClientFormState, ClientSubmitAction, ClientSubmitResult, PaymentDecision, ClientTransport, ClientValidationRule, } from './types';
+export { parseReference, serializeReference } from './references';
+export type { ReferenceExpression } from './references';
+export { resolveReference } from './references';
+export type { ReferenceDefinition, ReferenceContext, ResolvedReference } from './references';
+export * from './browser-modules';
+export * from './contract';
+export type { RequestProfile, BrowserRequestOptions } from './request-profile';
+export { browserRequest, browserRequestHeaders } from './request-profile';
+export { evaluateCondition, combineConditions, conditionNumber } from './conditions';
+export type { ConditionEvaluation, ConditionValueType } from './conditions';
+export { validateBrowserValue, browserValueEmpty, registerBrowserValidationRule } from './validation';
+export type { BrowserValidationRule, BrowserValidationContext } from './validation';
+export { clientActionAllowed, evaluateClientCondition } from './condition-state';
+export { selectConditionRows } from './condition-projections';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACH,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,4BAA4B,GAC/B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACR,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AACxF,OAAO,EACH,SAAS,EACT,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,GAChC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE1F,YAAY,EACR,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,GACzB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EACH,0BAA0B,EAC1B,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,4BAA4B,GAC/B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACR,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EACH,SAAS,EACT,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,GAChC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAChF,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,YAAY,EACR,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,oBAAoB,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE7F,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAE3B,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrF,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACtG,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAEpF,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}