@funnelsgrove/runtime 0.1.56 → 0.1.59

package/dist/validation/fixtures/valid-v3-project.d.ts

@@ -0,0 +1,419 @@
+export declare const validV3ProjectManifest: {
+    stepContractVersion: number;
+    meta: {
+        description: string;
+        title: "Contract fixture";
+    };
+    steps: ({
+        readonly id: "step-1";
+        readonly name: "step-one";
+        readonly path: "/step-1";
+        readonly filePath: "src/steps/step-01.tsx";
+        readonly componentKey: "stepOne";
+        readonly type: "intro_hero";
+        readonly title: "Introduction";
+    } | {
+        readonly id: "step-2";
+        readonly name: "device-choice";
+        readonly path: "/step-2";
+        readonly filePath: "src/steps/step-02.tsx";
+        readonly componentKey: "stepTwo";
+        readonly type: "multi_select_choice";
+        readonly choice: {
+            readonly answerKey: "selectedDevices";
+            readonly allowEmpty: true;
+        };
+        readonly title: "Choose devices";
+    } | {
+        readonly id: "email-capture";
+        readonly name: "email-capture";
+        readonly path: "/email-capture";
+        readonly filePath: "src/steps/step-31-email-capture.tsx";
+        readonly componentKey: "stepEmailCapture";
+        readonly type: "form_input";
+        readonly title: "Email capture";
+    } | {
+        readonly id: "paywall";
+        readonly name: "paywall";
+        readonly path: "/paywall";
+        readonly filePath: "src/steps/step-32-paywall.tsx";
+        readonly componentKey: "stepPaywall";
+        readonly type: "paywall_offer";
+        readonly kind: "paywall";
+        readonly title: "Paywall";
+    } | {
+        readonly id: "paywall-b";
+        readonly name: "paywall-b";
+        readonly path: "/paywall-b";
+        readonly filePath: "src/steps/step-32b-paywall-b.tsx";
+        readonly componentKey: "stepPaywallB";
+        readonly type: "paywall_offer";
+        readonly kind: "paywall";
+        readonly title: "Paywall B";
+    } | {
+        readonly id: "manage-subscription";
+        readonly name: "manage-subscription";
+        readonly path: "/manage-subscription";
+        readonly filePath: "src/steps/step-35-manage-subscription.tsx";
+        readonly componentKey: "stepManageSubscription";
+        readonly type: "subscription_management";
+        readonly kind: "manage-subscription";
+        readonly title: "Manage subscription";
+    } | {
+        type: "purchase_completed";
+        id: "subscription-started";
+        name: "subscription-started";
+        path: "/subscription-started";
+        filePath: "src/steps/step-33-subscription-started.tsx";
+        componentKey: "stepSubscriptionStarted";
+        kind: "subscription-handoff";
+        title: "Subscription started";
+    })[];
+    templateArchitectureVersion: 1;
+    viewport: {
+        readonly width: 390;
+        readonly height: 844;
+    };
+    assets: {};
+    entryPoints: readonly [{
+        readonly id: "default";
+        readonly stepId: "step-1";
+        readonly isDefault: true;
+    }, {
+        readonly id: "manage-subscription";
+        readonly stepId: "manage-subscription";
+    }];
+    edgesByStepId: {
+        readonly 'step-1': readonly [{
+            readonly toStepId: "step-2";
+        }];
+        readonly 'step-2': readonly [{
+            readonly toStepId: "email-capture";
+        }];
+        readonly 'email-capture': readonly [{
+            readonly toStepId: "paywall";
+        }];
+        readonly paywall: readonly [{
+            readonly toStepId: "subscription-started";
+        }];
+        readonly 'paywall-b': readonly [{
+            readonly toStepId: "subscription-started";
+        }];
+    };
+    branches: readonly [{
+        readonly id: "device-owners";
+        readonly name: "Device owners";
+        readonly sourceStepId: "step-2";
+        readonly stepIds: readonly ["email-capture", "paywall"];
+    }];
+    experiments: readonly [{
+        readonly experimentId: "paywall-offer";
+        readonly stepId: "paywall";
+        readonly variants: readonly [{
+            readonly variantKey: "control";
+            readonly routeToStepId: "paywall";
+        }, {
+            readonly variantKey: "variant-b";
+            readonly routeToStepId: "paywall-b";
+        }];
+    }];
+};
+export declare const validV3ProjectComponentMetaByKey: {
+    readonly stepSubscriptionStarted: {
+        readonly type: "purchase_completed";
+        readonly description: "Complete the funnel after a verified purchase.";
+        readonly id: "subscription-started";
+        readonly name: "subscription-started";
+        readonly kind: "subscription-handoff";
+        readonly figmaNodeId: "fixture:subscription-started";
+        readonly title: "Subscription started";
+    };
+    readonly stepOne: {
+        readonly id: "step-1";
+        readonly name: "step-one";
+        readonly type: "intro_hero";
+        readonly figmaNodeId: "fixture:step-1";
+        readonly title: "Introduction";
+        readonly description: "Introduce the funnel.";
+    };
+    readonly stepTwo: {
+        readonly id: "step-2";
+        readonly name: "device-choice";
+        readonly type: "multi_select_choice";
+        readonly choice: {
+            readonly answerKey: "selectedDevices";
+            readonly allowEmpty: true;
+        };
+        readonly figmaNodeId: "fixture:step-2";
+        readonly title: "Choose devices";
+        readonly description: "Choose every device that applies.";
+    };
+    readonly stepEmailCapture: {
+        readonly id: "email-capture";
+        readonly name: "email-capture";
+        readonly type: "form_input";
+        readonly figmaNodeId: "fixture:email-capture";
+        readonly title: "Email capture";
+        readonly description: "Capture an email address.";
+    };
+    readonly stepPaywall: {
+        readonly id: "paywall";
+        readonly name: "paywall";
+        readonly type: "paywall_offer";
+        readonly kind: "paywall";
+        readonly figmaNodeId: "fixture:paywall";
+        readonly title: "Paywall";
+        readonly description: "Present the primary offer.";
+    };
+    readonly stepPaywallB: {
+        readonly id: "paywall-b";
+        readonly name: "paywall-b";
+        readonly type: "paywall_offer";
+        readonly kind: "paywall";
+        readonly figmaNodeId: "fixture:paywall-b";
+        readonly title: "Paywall B";
+        readonly description: "Present the alternate offer.";
+    };
+    readonly stepManageSubscription: {
+        readonly id: "manage-subscription";
+        readonly name: "manage-subscription";
+        readonly type: "subscription_management";
+        readonly kind: "manage-subscription";
+        readonly figmaNodeId: "fixture:manage-subscription";
+        readonly title: "Manage subscription";
+        readonly description: "Manage the active subscription.";
+    };
+};
+export declare const validV3ProjectSnapshot: {
+    readonly manifest: {
+        stepContractVersion: number;
+        meta: {
+            description: string;
+            title: "Contract fixture";
+        };
+        steps: ({
+            readonly id: "step-1";
+            readonly name: "step-one";
+            readonly path: "/step-1";
+            readonly filePath: "src/steps/step-01.tsx";
+            readonly componentKey: "stepOne";
+            readonly type: "intro_hero";
+            readonly title: "Introduction";
+        } | {
+            readonly id: "step-2";
+            readonly name: "device-choice";
+            readonly path: "/step-2";
+            readonly filePath: "src/steps/step-02.tsx";
+            readonly componentKey: "stepTwo";
+            readonly type: "multi_select_choice";
+            readonly choice: {
+                readonly answerKey: "selectedDevices";
+                readonly allowEmpty: true;
+            };
+            readonly title: "Choose devices";
+        } | {
+            readonly id: "email-capture";
+            readonly name: "email-capture";
+            readonly path: "/email-capture";
+            readonly filePath: "src/steps/step-31-email-capture.tsx";
+            readonly componentKey: "stepEmailCapture";
+            readonly type: "form_input";
+            readonly title: "Email capture";
+        } | {
+            readonly id: "paywall";
+            readonly name: "paywall";
+            readonly path: "/paywall";
+            readonly filePath: "src/steps/step-32-paywall.tsx";
+            readonly componentKey: "stepPaywall";
+            readonly type: "paywall_offer";
+            readonly kind: "paywall";
+            readonly title: "Paywall";
+        } | {
+            readonly id: "paywall-b";
+            readonly name: "paywall-b";
+            readonly path: "/paywall-b";
+            readonly filePath: "src/steps/step-32b-paywall-b.tsx";
+            readonly componentKey: "stepPaywallB";
+            readonly type: "paywall_offer";
+            readonly kind: "paywall";
+            readonly title: "Paywall B";
+        } | {
+            readonly id: "manage-subscription";
+            readonly name: "manage-subscription";
+            readonly path: "/manage-subscription";
+            readonly filePath: "src/steps/step-35-manage-subscription.tsx";
+            readonly componentKey: "stepManageSubscription";
+            readonly type: "subscription_management";
+            readonly kind: "manage-subscription";
+            readonly title: "Manage subscription";
+        } | {
+            type: "purchase_completed";
+            id: "subscription-started";
+            name: "subscription-started";
+            path: "/subscription-started";
+            filePath: "src/steps/step-33-subscription-started.tsx";
+            componentKey: "stepSubscriptionStarted";
+            kind: "subscription-handoff";
+            title: "Subscription started";
+        })[];
+        templateArchitectureVersion: 1;
+        viewport: {
+            readonly width: 390;
+            readonly height: 844;
+        };
+        assets: {};
+        entryPoints: readonly [{
+            readonly id: "default";
+            readonly stepId: "step-1";
+            readonly isDefault: true;
+        }, {
+            readonly id: "manage-subscription";
+            readonly stepId: "manage-subscription";
+        }];
+        edgesByStepId: {
+            readonly 'step-1': readonly [{
+                readonly toStepId: "step-2";
+            }];
+            readonly 'step-2': readonly [{
+                readonly toStepId: "email-capture";
+            }];
+            readonly 'email-capture': readonly [{
+                readonly toStepId: "paywall";
+            }];
+            readonly paywall: readonly [{
+                readonly toStepId: "subscription-started";
+            }];
+            readonly 'paywall-b': readonly [{
+                readonly toStepId: "subscription-started";
+            }];
+        };
+        branches: readonly [{
+            readonly id: "device-owners";
+            readonly name: "Device owners";
+            readonly sourceStepId: "step-2";
+            readonly stepIds: readonly ["email-capture", "paywall"];
+        }];
+        experiments: readonly [{
+            readonly experimentId: "paywall-offer";
+            readonly stepId: "paywall";
+            readonly variants: readonly [{
+                readonly variantKey: "control";
+                readonly routeToStepId: "paywall";
+            }, {
+                readonly variantKey: "variant-b";
+                readonly routeToStepId: "paywall-b";
+            }];
+        }];
+    };
+    readonly componentMetaByKey: {
+        readonly stepSubscriptionStarted: {
+            readonly type: "purchase_completed";
+            readonly description: "Complete the funnel after a verified purchase.";
+            readonly id: "subscription-started";
+            readonly name: "subscription-started";
+            readonly kind: "subscription-handoff";
+            readonly figmaNodeId: "fixture:subscription-started";
+            readonly title: "Subscription started";
+        };
+        readonly stepOne: {
+            readonly id: "step-1";
+            readonly name: "step-one";
+            readonly type: "intro_hero";
+            readonly figmaNodeId: "fixture:step-1";
+            readonly title: "Introduction";
+            readonly description: "Introduce the funnel.";
+        };
+        readonly stepTwo: {
+            readonly id: "step-2";
+            readonly name: "device-choice";
+            readonly type: "multi_select_choice";
+            readonly choice: {
+                readonly answerKey: "selectedDevices";
+                readonly allowEmpty: true;
+            };
+            readonly figmaNodeId: "fixture:step-2";
+            readonly title: "Choose devices";
+            readonly description: "Choose every device that applies.";
+        };
+        readonly stepEmailCapture: {
+            readonly id: "email-capture";
+            readonly name: "email-capture";
+            readonly type: "form_input";
+            readonly figmaNodeId: "fixture:email-capture";
+            readonly title: "Email capture";
+            readonly description: "Capture an email address.";
+        };
+        readonly stepPaywall: {
+            readonly id: "paywall";
+            readonly name: "paywall";
+            readonly type: "paywall_offer";
+            readonly kind: "paywall";
+            readonly figmaNodeId: "fixture:paywall";
+            readonly title: "Paywall";
+            readonly description: "Present the primary offer.";
+        };
+        readonly stepPaywallB: {
+            readonly id: "paywall-b";
+            readonly name: "paywall-b";
+            readonly type: "paywall_offer";
+            readonly kind: "paywall";
+            readonly figmaNodeId: "fixture:paywall-b";
+            readonly title: "Paywall B";
+            readonly description: "Present the alternate offer.";
+        };
+        readonly stepManageSubscription: {
+            readonly id: "manage-subscription";
+            readonly name: "manage-subscription";
+            readonly type: "subscription_management";
+            readonly kind: "manage-subscription";
+            readonly figmaNodeId: "fixture:manage-subscription";
+            readonly title: "Manage subscription";
+            readonly description: "Manage the active subscription.";
+        };
+    };
+    readonly registeredComponentKeys: string[];
+    readonly contentOptionsByStepId: {
+        readonly 'step-2': readonly [{
+            readonly id: "phone";
+            readonly label: "Phone";
+            readonly imageSrc: "/images/phone.png";
+        }];
+    };
+    readonly edgesByStepId: {
+        readonly 'step-1': readonly [{
+            readonly toStepId: "step-2";
+        }];
+        readonly 'step-2': readonly [{
+            readonly toStepId: "email-capture";
+        }];
+        readonly 'email-capture': readonly [{
+            readonly toStepId: "paywall";
+        }];
+        readonly paywall: readonly [{
+            readonly toStepId: "subscription-started";
+        }];
+        readonly 'paywall-b': readonly [{
+            readonly toStepId: "subscription-started";
+        }];
+    };
+    readonly experiments: readonly [{
+        readonly experimentId: "paywall-offer";
+        readonly stepId: "paywall";
+        readonly variants: readonly [{
+            readonly variantKey: "control";
+            readonly routeToStepId: "paywall";
+        }, {
+            readonly variantKey: "variant-b";
+            readonly routeToStepId: "paywall-b";
+        }];
+    }];
+    readonly docs: {
+        readonly schemaVersion: 1;
+        readonly bundleVersion: "3.0.0";
+        readonly stepContractVersion: 3;
+        readonly contractHash: "d761e91d5ac6ff9e72c6d49c5bcd014270912473a66f99c49d726c65998085cf";
+        readonly missing: readonly [];
+        readonly changed: readonly [];
+        readonly conflicts: readonly [];
+    };
+};

package/dist/validation/fixtures/valid-v3-project.js

@@ -0,0 +1,30 @@
+import { CURRENT_STEP_CONTRACT_HASH } from '../../generated/step-contract-hash.js';
+import { validV2ProjectComponentMetaByKey, validV2ProjectManifest, } from './valid-v2-project.js';
+export const validV3ProjectManifest = Object.assign(Object.assign({}, validV2ProjectManifest), { stepContractVersion: 3, meta: Object.assign(Object.assign({}, validV2ProjectManifest.meta), { description: 'A valid version 3 funnel contract fixture.' }), steps: validV2ProjectManifest.steps.map((step) => (step.id === 'subscription-started'
+        ? Object.assign(Object.assign({}, step), { type: 'purchase_completed' }) : step)) });
+export const validV3ProjectComponentMetaByKey = Object.assign(Object.assign({}, validV2ProjectComponentMetaByKey), { stepSubscriptionStarted: Object.assign(Object.assign({}, validV2ProjectComponentMetaByKey.stepSubscriptionStarted), { type: 'purchase_completed', description: 'Complete the funnel after a verified purchase.' }) });
+export const validV3ProjectSnapshot = {
+    manifest: validV3ProjectManifest,
+    componentMetaByKey: validV3ProjectComponentMetaByKey,
+    registeredComponentKeys: Object.keys(validV3ProjectComponentMetaByKey),
+    contentOptionsByStepId: {
+        'step-2': [
+            {
+                id: 'phone',
+                label: 'Phone',
+                imageSrc: '/images/phone.png',
+            },
+        ],
+    },
+    edgesByStepId: validV3ProjectManifest.edgesByStepId,
+    experiments: validV3ProjectManifest.experiments,
+    docs: {
+        schemaVersion: 1,
+        bundleVersion: '3.0.0',
+        stepContractVersion: 3,
+        contractHash: CURRENT_STEP_CONTRACT_HASH,
+        missing: [],
+        changed: [],
+        conflicts: [],
+    },
+};

package/dist/validation/funnel-contract-diagnostics.d.ts

@@ -0,0 +1,49 @@
+import { type DeferrableFunnelContractDiagnosticCode } from '../steps/step-contract.js';
+export declare const FUNNEL_CONTRACT_DIAGNOSTIC_CODES: readonly ["FG-VERSION-001", "FG-VERSION-002", "FG-STEP-001", "FG-STEP-002", "FG-STEP-104", "FG-RESERVED-001", "FG-RESERVED-002", "FG-PARITY-001", "FG-REGISTRY-001", "FG-CONTENT-001", "FG-FLOW-001", "FG-FLOW-002", "FG-CHOICE-001", "FG-CHOICE-002", "FG-CHOICE-006", "FG-ANALYTICS-001", "FG-ANALYTICS-002", "FG-ANALYTICS-003", "FG-DOC-001", "FG-DOC-002", "FG-CLIENT-001", "FG-CANDIDATE-001"];
+export type FunnelContractDiagnosticCode = (typeof FUNNEL_CONTRACT_DIAGNOSTIC_CODES)[number];
+export declare const FUNNEL_CONTRACT_DIAGNOSTIC_SUMMARIES: Readonly<{
+    'FG-VERSION-001': string;
+    'FG-VERSION-002': string;
+    'FG-STEP-001': string;
+    'FG-STEP-002': string;
+    'FG-STEP-104': string;
+    'FG-RESERVED-001': string;
+    'FG-RESERVED-002': string;
+    'FG-PARITY-001': string;
+    'FG-REGISTRY-001': string;
+    'FG-CONTENT-001': string;
+    'FG-FLOW-001': string;
+    'FG-FLOW-002': string;
+    'FG-CHOICE-001': string;
+    'FG-CHOICE-002': string;
+    'FG-CHOICE-006': string;
+    'FG-ANALYTICS-001': string;
+    'FG-ANALYTICS-002': string;
+    'FG-ANALYTICS-003': string;
+    'FG-DOC-001': string;
+    'FG-DOC-002': string;
+    'FG-CLIENT-001': string;
+    'FG-CANDIDATE-001': string;
+}>;
+type FunnelContractDiagnosticDetails = {
+    file: string | null;
+    stepId: string | null;
+    expected: unknown;
+    received: unknown;
+    reason: string;
+    guide: string;
+    repair: string;
+};
+export type FunnelContractErrorDiagnostic = FunnelContractDiagnosticDetails & {
+    code: FunnelContractDiagnosticCode;
+    severity: 'error';
+};
+export type FunnelContractDiagnostic = FunnelContractErrorDiagnostic;
+export type FunnelContractDiagnosticInput = Omit<FunnelContractDiagnosticDetails, 'file' | 'stepId'> & {
+    code: FunnelContractDiagnosticCode;
+    file?: string | null;
+    stepId?: string | null;
+};
+export declare const isDeferrableFunnelContractDiagnosticCode: (code: FunnelContractDiagnosticCode) => code is DeferrableFunnelContractDiagnosticCode;
+export declare const createFunnelContractDiagnostic: (input: FunnelContractDiagnosticInput) => FunnelContractDiagnostic;
+export {};

package/dist/validation/funnel-contract-diagnostics.js

@@ -0,0 +1,67 @@
+import { DEFERRABLE_FUNNEL_CONTRACT_DIAGNOSTIC_CODES, } from '../steps/step-contract.js';
+export const FUNNEL_CONTRACT_DIAGNOSTIC_CODES = Object.freeze([
+    'FG-VERSION-001',
+    'FG-VERSION-002',
+    'FG-STEP-001',
+    'FG-STEP-002',
+    'FG-STEP-104',
+    'FG-RESERVED-001',
+    'FG-RESERVED-002',
+    'FG-PARITY-001',
+    'FG-REGISTRY-001',
+    'FG-CONTENT-001',
+    'FG-FLOW-001',
+    'FG-FLOW-002',
+    'FG-CHOICE-001',
+    'FG-CHOICE-002',
+    'FG-CHOICE-006',
+    'FG-ANALYTICS-001',
+    'FG-ANALYTICS-002',
+    'FG-ANALYTICS-003',
+    'FG-DOC-001',
+    'FG-DOC-002',
+    'FG-CLIENT-001',
+    'FG-CANDIDATE-001',
+]);
+export const FUNNEL_CONTRACT_DIAGNOSTIC_SUMMARIES = Object.freeze({
+    'FG-VERSION-001': 'Future or unsupported funnel step contract version.',
+    'FG-VERSION-002': 'Legacy or downgraded contract used for authoring or publish.',
+    'FG-STEP-001': 'Unknown step type or kind.',
+    'FG-STEP-002': 'Invalid step type/kind/name contract.',
+    'FG-STEP-104': 'Non-purchasable screen incorrectly classified as a paywall.',
+    'FG-RESERVED-001': 'Reserved identity/type/kind mismatch or duplicate reserved identity.',
+    'FG-RESERVED-002': 'Missing or duplicate primary paywall.',
+    'FG-PARITY-001': 'Component and manifest metadata do not match.',
+    'FG-REGISTRY-001': 'Declared step is missing from the component registry.',
+    'FG-CONTENT-001': 'Choice options or content registry entry is missing.',
+    'FG-FLOW-001': 'Step or edge references an unwritten declared path.',
+    'FG-FLOW-002': 'Hard-coded or outcome-less navigation bypasses manifest/controller routing.',
+    'FG-CHOICE-001': 'Choice descriptor or answer key is missing or invalid.',
+    'FG-CHOICE-002': 'Choice option ID, cardinality, or emoji schema is invalid.',
+    'FG-CHOICE-006': 'Choice write bypasses useStepChoices.',
+    'FG-ANALYTICS-001': 'Shared analytics adapter is missing.',
+    'FG-ANALYTICS-002': 'Provider-direct analytics or a manually emitted owned event is forbidden.',
+    'FG-ANALYTICS-003': 'Checkout metadata is incomplete or a preview emitted analytics.',
+    'FG-DOC-001': 'Managed documentation is unsupported, stale, or missing.',
+    'FG-DOC-002': 'Managed-document conflict is unresolved.',
+    'FG-CLIENT-001': 'Legacy client protocol cannot provide an atomic version-2 candidate.',
+    'FG-CANDIDATE-001': 'Candidate ownership, resource, path, hash, or base invariant failed.',
+});
+const DEFERRABLE_DIAGNOSTIC_CODE_SET = new Set(DEFERRABLE_FUNNEL_CONTRACT_DIAGNOSTIC_CODES);
+export const isDeferrableFunnelContractDiagnosticCode = (code) => {
+    return DEFERRABLE_DIAGNOSTIC_CODE_SET.has(code);
+};
+export const createFunnelContractDiagnostic = (input) => {
+    var _a, _b;
+    return {
+        code: input.code,
+        severity: 'error',
+        file: (_a = input.file) !== null && _a !== void 0 ? _a : null,
+        stepId: (_b = input.stepId) !== null && _b !== void 0 ? _b : null,
+        expected: input.expected,
+        received: input.received,
+        reason: input.reason,
+        guide: input.guide,
+        repair: input.repair,
+    };
+};

package/dist/validation/funnel-contract-validator.d.ts

@@ -0,0 +1,30 @@
+import type { FunnelManifest } from '../config/funnel.manifest.types.js';
+import { type FunnelChoiceOption, type FunnelEmojiChoiceOption } from '../steps/step-contract.js';
+import type { FunnelStepMeta } from '../steps/types.js';
+import { type FunnelContractDiagnostic } from './funnel-contract-diagnostics.js';
+export type FunnelContractValidationMode = 'legacy-read' | 'authoring' | 'publish';
+export type FunnelManifestContractInput = Omit<FunnelManifest, 'stepContractVersion'> & {
+    stepContractVersion?: number;
+};
+export type FunnelManifestContractValidationOptions = {
+    mode: FunnelContractValidationMode;
+};
+export type FunnelStepContractProjectSnapshot = {
+    manifest: FunnelManifest;
+    componentMetaByKey: Record<string, FunnelStepMeta>;
+    registeredComponentKeys: readonly string[];
+    contentOptionsByStepId: Record<string, readonly (FunnelChoiceOption | FunnelEmojiChoiceOption)[]>;
+    edgesByStepId: FunnelManifest['edgesByStepId'];
+    experiments: FunnelManifest['experiments'];
+    docs: {
+        schemaVersion: number;
+        bundleVersion: string;
+        stepContractVersion: number;
+        contractHash: string;
+        missing: readonly string[];
+        changed: readonly string[];
+        conflicts: readonly string[];
+    };
+};
+export declare const validateFunnelManifestContract: (input: unknown, options: FunnelManifestContractValidationOptions) => FunnelContractDiagnostic[];
+export declare const validateFunnelStepContractSnapshot: (input: FunnelStepContractProjectSnapshot, options: FunnelManifestContractValidationOptions) => FunnelContractDiagnostic[];