@mj-biz-apps/forms-ng 0.0.0 → 0.2.0

package/dist/lib/widget/api/forms-api.interface.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Seam S1 — the public read + submit API the respondent widget consumes.
+ *
+ * `PublishedForm(distributionSlug)` and `SubmitFormResponse(input)` are implemented
+ * server-side by WP-B as anonymous-scope custom resolvers. The widget codes ONLY
+ * against this interface so the real GraphQL transport ({@link FormsGraphQLApiService})
+ * and the standalone {@link FormsMockApiService} are interchangeable — swap the DI
+ * provider, nothing else changes.
+ *
+ * The shapes (`PublishedFormDefinition`, `FormSubmissionInput`, `FormSubmissionResult`)
+ * are imported from the frozen contract in `@mj-biz-apps/forms-entities`; they are NOT
+ * redefined here.
+ */
+import type { PublishedFormDefinition, FormSubmissionInput, FormSubmissionResult } from '@mj-biz-apps/forms-entities';
+import { InjectionToken } from '@angular/core';
+/**
+ * The transport contract for the respondent widget. Method signatures mirror the S1
+ * GraphQL operations exactly:
+ *
+ * - `query PublishedForm(distributionSlug: String!): PublishedFormDefinition`
+ * - `mutation SubmitFormResponse(input: FormSubmissionInput!): FormSubmissionResult!`
+ */
+export interface IFormsApiService {
+    /**
+     * Load a published form by its distribution slug. Resolves to `null` when the slug
+     * is unknown, the form is closed, or quota is exhausted (server decides).
+     */
+    loadPublishedForm(distributionSlug: string): Promise<PublishedFormDefinition | null>;
+    /**
+     * Submit (or partial-save) a response. The server re-validates before persisting.
+     *
+     * `existingResponseId` is the id returned by a prior partial save; passing it lets the
+     * server UPSERT the same in-progress response (autosave) rather than creating a new
+     * one. It is a transport-level parameter — NOT part of the frozen `FormSubmissionInput`
+     * contract — because it is a widget-session concern (cross-session resume is Phase 2).
+     */
+    submitResponse(input: FormSubmissionInput, existingResponseId?: string): Promise<FormSubmissionResult>;
+}
+/**
+ * DI token for the active {@link IFormsApiService}. The element bootstrap binds either
+ * the real GraphQL service or the mock to this token; components inject the token, not
+ * a concrete class, so the real/mock swap is a one-line provider change.
+ */
+export declare const FORMS_API_SERVICE: InjectionToken<IFormsApiService>;
+//# sourceMappingURL=forms-api.interface.d.ts.map

package/dist/lib/widget/api/forms-api.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-api.interface.d.ts","sourceRoot":"","sources":["../../../../src/lib/widget/api/forms-api.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;IAErF;;;;;;;OAOG;IACH,cAAc,CACZ,KAAK,EAAE,mBAAmB,EAC1B,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kCAA4D,CAAC"}

package/dist/lib/widget/api/forms-api.interface.js

@@ -0,0 +1,8 @@
+import { InjectionToken } from '@angular/core';
+/**
+ * DI token for the active {@link IFormsApiService}. The element bootstrap binds either
+ * the real GraphQL service or the mock to this token; components inject the token, not
+ * a concrete class, so the real/mock swap is a one-line provider change.
+ */
+export const FORMS_API_SERVICE = new InjectionToken('FORMS_API_SERVICE');
+//# sourceMappingURL=forms-api.interface.js.map

package/dist/lib/widget/api/forms-api.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-api.interface.js","sourceRoot":"","sources":["../../../../src/lib/widget/api/forms-api.interface.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AA8B/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,cAAc,CAAmB,mBAAmB,CAAC,CAAC"}

package/dist/lib/widget/api/forms-api.mock.service.d.ts

@@ -0,0 +1,12 @@
+import type { PublishedFormDefinition, FormSubmissionInput, FormSubmissionResult } from '@mj-biz-apps/forms-entities';
+import type { IFormsApiService } from './forms-api.interface';
+import * as i0 from "@angular/core";
+export declare class FormsMockApiService implements IFormsApiService {
+    loadPublishedForm(distributionSlug: string): Promise<PublishedFormDefinition | null>;
+    submitResponse(input: FormSubmissionInput, existingResponseId?: string): Promise<FormSubmissionResult>;
+    /** Mimic network round-trip so loading + progress UI are exercised. */
+    private simulateLatency;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormsMockApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FormsMockApiService>;
+}
+//# sourceMappingURL=forms-api.mock.service.d.ts.map

package/dist/lib/widget/api/forms-api.mock.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-api.mock.service.d.ts","sourceRoot":"","sources":["../../../../src/lib/widget/api/forms-api.mock.service.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;;AAG9D,qBACa,mBAAoB,YAAW,gBAAgB;IAC7C,iBAAiB,CAC5B,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAK7B,cAAc,CACzB,KAAK,EAAE,mBAAmB,EAC1B,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAchC,uEAAuE;IACvE,OAAO,CAAC,eAAe;yCA1BZ,mBAAmB;6CAAnB,mBAAmB;CA6B/B"}

package/dist/lib/widget/api/forms-api.mock.service.js

@@ -0,0 +1,41 @@
+/**
+ * Standalone mock S1 transport. Lets the widget build, render, and demo end-to-end
+ * before WP-B's resolvers land — same {@link IFormsApiService} interface, so swapping
+ * to {@link FormsGraphQLApiService} is a one-line provider change.
+ *
+ * The seeded form exercises every Phase-1 question type (§5.3), both choice + scale
+ * styles, conditional show/hide (S2), and validation rules — so the demo doubles as a
+ * visual smoke test.
+ */
+import { Injectable } from '@angular/core';
+import { buildMockForm } from './mock-form.data';
+import * as i0 from "@angular/core";
+export class FormsMockApiService {
+    async loadPublishedForm(distributionSlug) {
+        await this.simulateLatency();
+        return buildMockForm(distributionSlug);
+    }
+    async submitResponse(input, existingResponseId) {
+        await this.simulateLatency();
+        return {
+            success: true,
+            // Echo the client-supplied id back (it is the widget's stable idempotency key), falling
+            // back to a minted id only if none was sent.
+            responseId: existingResponseId ?? `mock-${Date.now().toString(36)}`,
+            status: input.partial ? 'Partial' : 'Complete',
+            confirmationMessage: input.partial
+                ? 'Your progress has been saved.'
+                : 'Thank you! Your response has been recorded.',
+        };
+    }
+    /** Mimic network round-trip so loading + progress UI are exercised. */
+    simulateLatency() {
+        return new Promise((resolve) => setTimeout(resolve, 250));
+    }
+    static ɵfac = function FormsMockApiService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || FormsMockApiService)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: FormsMockApiService, factory: FormsMockApiService.ɵfac });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(FormsMockApiService, [{
+        type: Injectable
+    }], null, null); })();
+//# sourceMappingURL=forms-api.mock.service.js.map

package/dist/lib/widget/api/forms-api.mock.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-api.mock.service.js","sourceRoot":"","sources":["../../../../src/lib/widget/api/forms-api.mock.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQ3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;;AAGjD,MAAM,OAAO,mBAAmB;IACvB,KAAK,CAAC,iBAAiB,CAC5B,gBAAwB;QAExB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,OAAO,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,cAAc,CACzB,KAA0B,EAC1B,kBAA2B;QAE3B,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,wFAAwF;YACxF,6CAA6C;YAC7C,UAAU,EAAE,kBAAkB,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;YACnE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;YAC9C,mBAAmB,EAAE,KAAK,CAAC,OAAO;gBAChC,CAAC,CAAC,+BAA+B;gBACjC,CAAC,CAAC,6CAA6C;SAClD,CAAC;IACJ,CAAC;IAED,uEAAuE;IAC/D,eAAe;QACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;6GA5BU,mBAAmB;gEAAnB,mBAAmB,WAAnB,mBAAmB;;iFAAnB,mBAAmB;cAD/B,UAAU"}

package/dist/lib/widget/api/mock-form.data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Seed data for {@link FormsMockApiService}: a single multi-page published form that
+ * covers all 15 Phase-1 question types, conditional show/hide, and validation rules.
+ */
+import type { PublishedFormDefinition } from '@mj-biz-apps/forms-entities';
+/** Build the demo form definition for a given (ignored) distribution slug. */
+export declare function buildMockForm(_distributionSlug: string): PublishedFormDefinition;
+//# sourceMappingURL=mock-form.data.d.ts.map

package/dist/lib/widget/api/mock-form.data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-form.data.d.ts","sourceRoot":"","sources":["../../../../src/lib/widget/api/mock-form.data.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,uBAAuB,CA6LhF"}

package/dist/lib/widget/api/mock-form.data.js

@@ -0,0 +1,192 @@
+/** Build the demo form definition for a given (ignored) distribution slug. */
+export function buildMockForm(_distributionSlug) {
+    return {
+        formId: 'mock-form-1',
+        formVersionId: 'mock-version-1',
+        name: 'Community Event Sign-up',
+        description: 'A short form demonstrating every Phase-1 question type.',
+        renderMode: 'Scroll',
+        settings: {
+            anonymousAllowed: true,
+            captchaRequired: false,
+            confirmationMessage: 'Thanks for signing up — see you at the event!',
+        },
+        styleTokens: { cssVariables: {} },
+        pages: [
+            {
+                id: 'page-1',
+                title: 'About you',
+                description: 'Tell us who you are.',
+                displayOrder: 1,
+                questions: [
+                    {
+                        id: 'q-name',
+                        type: 'ShortText',
+                        prompt: 'Your full name',
+                        isRequired: true,
+                        displayOrder: 1,
+                        options: [],
+                        validationRule: { maxLength: 120 },
+                    },
+                    {
+                        id: 'q-email',
+                        type: 'Email',
+                        prompt: 'Email address',
+                        helpText: "We'll only use this to send your confirmation.",
+                        isRequired: true,
+                        displayOrder: 2,
+                        options: [],
+                    },
+                    {
+                        id: 'q-phone',
+                        type: 'Phone',
+                        prompt: 'Mobile number',
+                        isRequired: false,
+                        displayOrder: 3,
+                        options: [],
+                    },
+                    {
+                        id: 'q-guests',
+                        type: 'Number',
+                        prompt: 'How many guests are you bringing?',
+                        isRequired: false,
+                        displayOrder: 4,
+                        options: [],
+                        validationRule: { min: 0, max: 10 },
+                        settings: { placeholder: '0' },
+                    },
+                ],
+            },
+            {
+                id: 'page-2',
+                title: 'Your preferences',
+                displayOrder: 2,
+                questions: [
+                    {
+                        id: 'q-statement',
+                        type: 'Statement',
+                        prompt: 'Help us tailor the day to you',
+                        helpText: 'These questions are optional but appreciated.',
+                        isRequired: false,
+                        displayOrder: 1,
+                        options: [],
+                    },
+                    {
+                        id: 'q-session',
+                        type: 'SingleChoice',
+                        prompt: 'Which session will you attend?',
+                        isRequired: true,
+                        displayOrder: 2,
+                        options: [
+                            { id: 'o-morning', label: 'Morning', value: 'morning', displayOrder: 1 },
+                            { id: 'o-afternoon', label: 'Afternoon', value: 'afternoon', displayOrder: 2 },
+                            { id: 'o-other', label: 'Other', value: 'other', displayOrder: 3 },
+                        ],
+                    },
+                    {
+                        id: 'q-session-other',
+                        type: 'ShortText',
+                        prompt: 'Please tell us when suits you',
+                        isRequired: true,
+                        displayOrder: 3,
+                        options: [],
+                        conditionalRule: {
+                            show: { all: [{ questionId: 'q-session', op: 'equals', value: 'other' }] },
+                        },
+                    },
+                    {
+                        id: 'q-topics',
+                        type: 'MultiChoice',
+                        prompt: 'Topics you are interested in',
+                        isRequired: false,
+                        displayOrder: 4,
+                        options: [
+                            { id: 't-ai', label: 'AI', value: 'ai', displayOrder: 1 },
+                            { id: 't-data', label: 'Data', value: 'data', displayOrder: 2 },
+                            { id: 't-design', label: 'Design', value: 'design', displayOrder: 3 },
+                        ],
+                    },
+                    {
+                        id: 'q-shirt',
+                        type: 'Dropdown',
+                        prompt: 'T-shirt size',
+                        isRequired: false,
+                        displayOrder: 5,
+                        options: [
+                            { id: 's-s', label: 'Small', value: 'S', displayOrder: 1 },
+                            { id: 's-m', label: 'Medium', value: 'M', displayOrder: 2, isDefault: true },
+                            { id: 's-l', label: 'Large', value: 'L', displayOrder: 3 },
+                        ],
+                    },
+                    {
+                        id: 'q-diet',
+                        type: 'LongText',
+                        prompt: 'Any dietary requirements?',
+                        isRequired: false,
+                        displayOrder: 6,
+                        options: [],
+                        settings: { rows: 4 },
+                    },
+                ],
+            },
+            {
+                id: 'page-3',
+                title: 'Feedback & logistics',
+                displayOrder: 3,
+                questions: [
+                    {
+                        id: 'q-rating',
+                        type: 'Rating',
+                        prompt: 'How excited are you?',
+                        isRequired: false,
+                        displayOrder: 1,
+                        options: [],
+                        settings: { max: 5 },
+                    },
+                    {
+                        id: 'q-nps',
+                        type: 'NPS',
+                        prompt: 'How likely are you to recommend this event to a friend?',
+                        isRequired: false,
+                        displayOrder: 2,
+                        options: [],
+                    },
+                    {
+                        id: 'q-newsletter',
+                        type: 'YesNo',
+                        prompt: 'Subscribe to the newsletter?',
+                        isRequired: false,
+                        displayOrder: 3,
+                        options: [],
+                    },
+                    {
+                        id: 'q-date',
+                        type: 'Date',
+                        prompt: 'Preferred follow-up date',
+                        isRequired: false,
+                        displayOrder: 4,
+                        options: [],
+                    },
+                    {
+                        id: 'q-time',
+                        type: 'Time',
+                        prompt: 'Preferred follow-up time',
+                        isRequired: false,
+                        displayOrder: 5,
+                        options: [],
+                    },
+                    {
+                        id: 'q-file',
+                        type: 'FileUpload',
+                        prompt: 'Attach a photo (optional)',
+                        isRequired: false,
+                        displayOrder: 6,
+                        options: [],
+                        settings: { accept: 'image/*' },
+                    },
+                ],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=mock-form.data.js.map

package/dist/lib/widget/api/mock-form.data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-form.data.js","sourceRoot":"","sources":["../../../../src/lib/widget/api/mock-form.data.ts"],"names":[],"mappings":"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"}

package/dist/lib/widget/api/submission-mapping.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Pure mapping from the frozen `@mj-biz-apps/forms-entities` submission contract to the S1
+ * GraphQL `FormSubmissionInputType` wire shape. Extracted from the transport service so it is
+ * unit-testable and so the wire-shape field set is locked by a test (see submission-mapping.spec).
+ *
+ * The ONLY intentional divergence from the contract is `jsonValue`: the contract carries a
+ * structured `JSONValue`, the SDL expects a JSON STRING, so it is stringified here. The
+ * transport-only `responseId` (autosave upsert target) is folded in here too, keeping it out of
+ * the frozen contract.
+ */
+import type { ClientMeta, FormAnswerInput, FormSubmissionInput } from '@mj-biz-apps/forms-entities';
+/** `FormAnswerInputType` per WP-B's SDL: `jsonValue` is a JSON STRING, `dateValue` a String. */
+export interface FormAnswerInputType {
+    questionId: string;
+    textValue?: string;
+    numericValue?: number;
+    dateValue?: string;
+    booleanValue?: boolean;
+    jsonValue?: string;
+    fileId?: string;
+}
+/** `FormSubmissionInputType` per WP-B's SDL (answers use {@link FormAnswerInputType}). */
+export interface FormSubmissionInputType {
+    distributionSlug: string;
+    formVersionId: string;
+    partial?: boolean;
+    /** Prior partial's id, so the server UPSERTs the same response on autosave. */
+    responseId?: string;
+    startedAt?: string;
+    turnstileToken?: string;
+    clientMeta?: ClientMeta;
+    answers: FormAnswerInputType[];
+}
+/** The exact, ordered set of top-level fields the server input type accepts. */
+export declare const SUBMISSION_INPUT_FIELDS: readonly (keyof FormSubmissionInputType)[];
+/** The exact set of fields a single answer accepts. */
+export declare const ANSWER_INPUT_FIELDS: readonly (keyof FormAnswerInputType)[];
+/** Map the contract submission onto the wire shape, folding in the transport upsert target. */
+export declare function toInputType(input: FormSubmissionInput, existingResponseId?: string): FormSubmissionInputType;
+/** Map one contract answer onto the wire shape, stringifying `jsonValue`. */
+export declare function toAnswerInputType(answer: FormAnswerInput): FormAnswerInputType;
+/** Flatten intersections / Omit / mapped types to a plain object literal so `Exact` compares cleanly. */
+type Id<T> = {
+    [K in keyof T]: T[K];
+};
+/** Invariant equality — catches renamed/added OPTIONAL fields (bidirectional `extends` won't). */
+type Exact<A, B> = (<T>() => T extends Id<A> ? 1 : 2) extends <T>() => T extends Id<B> ? 1 : 2 ? true : false;
+type AssertExact<T extends true> = T;
+type _LockAnswer = AssertExact<Exact<Omit<FormAnswerInput, 'jsonValue'>, Omit<FormAnswerInputType, 'jsonValue'>>>;
+type _LockAnswerJson = AssertExact<[
+    FormAnswerInputType['jsonValue']
+] extends [string | undefined] ? ([string | undefined] extends [FormAnswerInputType['jsonValue']] ? true : false) : false>;
+type _LockSubmission = AssertExact<Exact<Omit<FormSubmissionInput, 'answers'> & {
+    responseId?: string;
+}, Omit<FormSubmissionInputType, 'answers'>>>;
+type _LockClientMeta = AssertExact<Exact<ClientMeta, NonNullable<FormSubmissionInputType['clientMeta']>>>;
+/** Referenced so `noUnusedLocals` retains the locks above (they exist purely for the check). */
+export type WidgetContractLocks = [_LockAnswer, _LockAnswerJson, _LockSubmission, _LockClientMeta];
+export {};
+//# sourceMappingURL=submission-mapping.d.ts.map

package/dist/lib/widget/api/submission-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission-mapping.d.ts","sourceRoot":"","sources":["../../../../src/lib/widget/api/submission-mapping.ts"],"names":[],"mappings":"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"}

package/dist/lib/widget/api/submission-mapping.js

@@ -0,0 +1,47 @@
+/** The exact, ordered set of top-level fields the server input type accepts. */
+export const SUBMISSION_INPUT_FIELDS = [
+    'distributionSlug',
+    'formVersionId',
+    'partial',
+    'responseId',
+    'startedAt',
+    'turnstileToken',
+    'clientMeta',
+    'answers',
+];
+/** The exact set of fields a single answer accepts. */
+export const ANSWER_INPUT_FIELDS = [
+    'questionId',
+    'textValue',
+    'numericValue',
+    'dateValue',
+    'booleanValue',
+    'jsonValue',
+    'fileId',
+];
+/** Map the contract submission onto the wire shape, folding in the transport upsert target. */
+export function toInputType(input, existingResponseId) {
+    return {
+        distributionSlug: input.distributionSlug,
+        formVersionId: input.formVersionId,
+        partial: input.partial,
+        responseId: existingResponseId,
+        startedAt: input.startedAt,
+        turnstileToken: input.turnstileToken,
+        clientMeta: input.clientMeta,
+        answers: input.answers.map(toAnswerInputType),
+    };
+}
+/** Map one contract answer onto the wire shape, stringifying `jsonValue`. */
+export function toAnswerInputType(answer) {
+    return {
+        questionId: answer.questionId,
+        textValue: answer.textValue,
+        numericValue: answer.numericValue,
+        dateValue: answer.dateValue,
+        booleanValue: answer.booleanValue,
+        jsonValue: answer.jsonValue === undefined ? undefined : JSON.stringify(answer.jsonValue),
+        fileId: answer.fileId,
+    };
+}
+//# sourceMappingURL=submission-mapping.js.map

package/dist/lib/widget/api/submission-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission-mapping.js","sourceRoot":"","sources":["../../../../src/lib/widget/api/submission-mapping.ts"],"names":[],"mappings":"AAoCA,gFAAgF;AAChF,MAAM,CAAC,MAAM,uBAAuB,GAA+C;IACjF,kBAAkB;IAClB,eAAe;IACf,SAAS;IACT,YAAY;IACZ,WAAW;IACX,gBAAgB;IAChB,YAAY;IACZ,SAAS;CACD,CAAC;AAEX,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAA2C;IACzE,YAAY;IACZ,WAAW;IACX,cAAc;IACd,WAAW;IACX,cAAc;IACd,WAAW;IACX,QAAQ;CACA,CAAC;AAEX,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CACzB,KAA0B,EAC1B,kBAA2B;IAE3B,OAAO;QACL,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,kBAAkB;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;QACxF,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/lib/widget/components/form-one-question.component.d.ts

@@ -0,0 +1,43 @@
+import type { AnswerValue, PublishedFormQuestion } from '@mj-biz-apps/forms-entities';
+import { FormRuntime } from '../core/form-runtime';
+import * as i0 from "@angular/core";
+export declare class FormOneQuestionComponent {
+    readonly runtime: import("@angular/core").InputSignal<FormRuntime>;
+    readonly submitting: import("@angular/core").InputSignal<boolean>;
+    /** When true, the final-step submit control is disabled (e.g. captcha not yet solved). */
+    readonly submitDisabled: import("@angular/core").InputSignal<boolean>;
+    /** Distribution slug, forwarded to FileUpload questions for scoped uploads. */
+    readonly distributionSlug: import("@angular/core").InputSignal<string>;
+    readonly submit: import("@angular/core").OutputEmitterRef<void>;
+    /** Fires when the respondent advances a step — a natural autosave checkpoint. */
+    readonly progressChange: import("@angular/core").OutputEmitterRef<void>;
+    private readonly hostRef;
+    /**
+     * Raw cursor. Always written through {@link setIndex} so it stays inside the valid
+     * range; the re-clamp {@link effect} below also corrects it whenever conditional logic
+     * resizes the visible-question path, so the stored value never drifts out of bounds.
+     */
+    protected readonly index: import("@angular/core").WritableSignal<number>;
+    /** The ordered, currently-visible answerable questions (recomputed reactively). */
+    protected readonly steps: import("@angular/core").Signal<PublishedFormQuestion[]>;
+    protected readonly total: import("@angular/core").Signal<number>;
+    protected readonly current: import("@angular/core").Signal<PublishedFormQuestion | null>;
+    protected readonly isFirst: import("@angular/core").Signal<boolean>;
+    protected readonly isLast: import("@angular/core").Signal<boolean>;
+    protected readonly progress: import("@angular/core").Signal<number>;
+    protected readonly stepLabel: import("@angular/core").Signal<string>;
+    /** Disable the primary control while submitting, or on the final (submit) step when blocked. */
+    protected readonly primaryDisabled: import("@angular/core").Signal<boolean>;
+    constructor();
+    protected onValueChange(question: PublishedFormQuestion, value: AnswerValue): void;
+    protected onNext(): void;
+    protected onBack(): void;
+    /** Move the cursor to `next`, clamped to the currently-valid range. */
+    private setIndex;
+    /** Enter on the question advances (except in a multiline textarea). */
+    protected onKeydown(event: KeyboardEvent): void;
+    private focusCurrent;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormOneQuestionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormOneQuestionComponent, "mjf-form-one-question", never, { "runtime": { "alias": "runtime"; "required": true; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; "submitDisabled": { "alias": "submitDisabled"; "required": false; "isSignal": true; }; "distributionSlug": { "alias": "distributionSlug"; "required": false; "isSignal": true; }; }, { "submit": "submit"; "progressChange": "progressChange"; }, never, never, true, never>;
+}
+//# sourceMappingURL=form-one-question.component.d.ts.map

package/dist/lib/widget/components/form-one-question.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-one-question.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/widget/components/form-one-question.component.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;;AAKnD,qBAQa,wBAAwB;IACnC,SAAgB,OAAO,mDAAiC;IACxD,SAAgB,UAAU,+CAAyB;IACnD,0FAA0F;IAC1F,SAAgB,cAAc,+CAAyB;IACvD,+EAA+E;IAC/E,SAAgB,gBAAgB,8CAAqB;IACrD,SAAgB,MAAM,iDAAkB;IACxC,iFAAiF;IACjF,SAAgB,cAAc,iDAAkB;IAEhD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IAEvE;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,iDAAa;IAErC,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,KAAK,0DAA+D;IACvF,SAAS,CAAC,QAAQ,CAAC,KAAK,yCAAuC;IAC/D,SAAS,CAAC,QAAQ,CAAC,OAAO,+DAExB;IACF,SAAS,CAAC,QAAQ,CAAC,OAAO,0CAAsC;IAChE,SAAS,CAAC,QAAQ,CAAC,MAAM,0CAAoD;IAC7E,SAAS,CAAC,QAAQ,CAAC,QAAQ,yCAGxB;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,yCAA4D;IAExF,gGAAgG;IAChG,SAAS,CAAC,QAAQ,CAAC,eAAe,0CAEhC;;IA8BF,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAKlF,SAAS,CAAC,MAAM,IAAI,IAAI;IAmBxB,SAAS,CAAC,MAAM,IAAI,IAAI;IAMxB,uEAAuE;IACvE,OAAO,CAAC,QAAQ;IAIhB,uEAAuE;IACvE,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAQ/C,OAAO,CAAC,YAAY;yCA/GT,wBAAwB;2CAAxB,wBAAwB;CAwHpC"}