@junejuly-lockstep/model 0.0.0-stage → 0.1.0

package/dist/card.d.ts.map

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

package/dist/card.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { MachineJson, StateMeta, TriggerBinding } from './journey.js';
+export const CardGrain = z.enum(['journey', 'micro', 'finding', 'backend']);
+export const CardSource = z.enum(['human', 'reconciler', 'canvas']);
+/** Board columns. Derived from state; never set directly. */
+export const BoardColumn = z.enum([
+    'planned',
+    'declared',
+    'dispatched',
+    'needs_judgment',
+    'in_lockstep',
+]);
+export const BOARD_COLUMN_LABELS = {
+    planned: 'Planned',
+    declared: 'Declared',
+    dispatched: 'Dispatched',
+    needs_judgment: 'Needs judgment',
+    in_lockstep: 'In lockstep',
+};
+export const CardEventKind = z.enum([
+    'created',
+    'dispatched',
+    'verdict',
+    'adopted',
+    'deferred',
+    'approved',
+    'acknowledged',
+    'sealed',
+    'pr_linked',
+    'pr_merged',
+    'reopened',
+]);
+/** A delta against the machine JSON: whole states or single transitions. */
+export const MachineDelta = z.object({
+    addStates: z
+        .record(z.string(), z.object({ config: z.record(z.string(), z.unknown()), meta: StateMeta }))
+        .default({}),
+    removeStates: z.array(z.string()).default([]),
+    addTransitions: z
+        .array(z.object({
+        from: z.string(),
+        event: z.string(),
+        to: z.string(),
+        guard: z.string().optional(),
+    }))
+        .default([]),
+    removeTransitions: z
+        .array(z.object({ from: z.string(), event: z.string(), to: z.string() }))
+        .default([]),
+    updateMeta: z.record(z.string(), StateMeta.partial()).default({}),
+    addBindings: z.array(TriggerBinding).default([]),
+});
+/** The core primitive: a proposed change to the declared journey model. */
+export const IntentDiff = z.object({
+    kind: z.literal('intent'),
+    journeyKey: z.string().nullable(),
+    narrative: z.string().default(''),
+    rules: z.array(z.string()).default([]),
+    /** Whole new journey (phase one) or a delta on an existing one (phase two). */
+    newMachine: MachineJson.nullable().default(null),
+    delta: MachineDelta.nullable().default(null),
+    scenarios: z.array(z.string()).default([]),
+    referenceAssets: z.array(z.string().url()).default([]),
+});
+/** A finding the reconciler raised. */
+export const FindingPayload = z.object({
+    kind: z.literal('finding'),
+    family: z.enum(['structural', 'visual', 'contract', 'reach']),
+    journeyKey: z.string().nullable(),
+    elementKind: z.string(),
+    elementKey: z.string(),
+    runId: z.string().uuid(),
+    detail: z.record(z.string(), z.unknown()).default({}),
+    /** AI-generated two-sentence explanation; always labeled generated in the UI. */
+    explanation: z.string().nullable().default(null),
+});
+/** A backend change with no direct journey surface. */
+export const BackendPayload = z.object({
+    kind: z.literal('backend'),
+    changeKind: z.enum(['dependency', 'contract', 'declared']),
+    title: z.string(),
+    summary: z.string().default(''),
+    declaredReach: z
+        .object({
+        journeys: z.array(z.string()).default([]),
+        transitions: z.array(z.string()).default([]),
+        states: z.array(z.string()).default([]),
+    })
+        .nullable()
+        .default(null),
+    seams: z.array(z.string()).default([]),
+    runId: z.string().uuid().nullable().default(null),
+    reachSummary: z.string().nullable().default(null),
+});
+export const CardPayload = z.discriminatedUnion('kind', [
+    IntentDiff,
+    FindingPayload,
+    BackendPayload,
+]);
+/** Compiled form of a card's intent diff, stored on the card. */
+export const WorkOrder = z.object({
+    cardRef: z.string(),
+    brief: z.string(),
+    briefGenerated: z.boolean(),
+    machineDelta: z.unknown(),
+    scenarioFixtures: z.array(z.object({ name: z.string(), seed: z.number(), overrides: z.unknown() })),
+    acceptancePaths: z.array(z.array(z.string())),
+    bindings: z.array(TriggerBinding),
+    conventions: z.string().default(''),
+    compiledAt: z.string().datetime(),
+});
+export const Reach = z.object({
+    transitions: z.array(z.string()).default([]),
+    states: z.array(z.string()).default([]),
+    journeys: z.array(z.string()).default([]),
+    operations: z.array(z.string()).default([]),
+});
+/** Render FERN-12 from project key and seq. */
+export function cardRef(projectKey, seq) {
+    return `${projectKey}-${seq}`;
+}
+//# sourceMappingURL=card.js.map

package/dist/card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.js","sourceRoot":"","sources":["../src/card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAG5E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGpE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;IAChC,SAAS;IACT,UAAU;IACV,YAAY;IACZ,gBAAgB;IAChB,aAAa;CACd,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC;IAClC,SAAS;IACT,YAAY;IACZ,SAAS;IACT,SAAS;IACT,UAAU;IACV,UAAU;IACV,cAAc;IACd,QAAQ;IACR,WAAW;IACX,WAAW;IACX,UAAU;CACX,CAAC,CAAC;AAGH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC;SACT,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;SAC5F,OAAO,CAAC,EAAE,CAAC;IACd,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7C,cAAc,EAAE,CAAC;SACd,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC,CACH;SACA,OAAO,CAAC,EAAE,CAAC;IACd,iBAAiB,EAAE,CAAC;SACjB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SACxE,OAAO,CAAC,EAAE,CAAC;IACd,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACjD,CAAC,CAAC;AAGH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,+EAA+E;IAC/E,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC;AAGH,uCAAuC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC7D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,iFAAiF;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACjD,CAAC,CAAC;AAGH,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/B,aAAa,EAAE,CAAC;SACb,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KACxC,CAAC;SACD,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;IAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACjD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAClD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACtD,UAAU;IACV,cAAc;IACd,cAAc;CACf,CAAC,CAAC;AAGH,iEAAiE;AACjE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CACvB,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CACzE;IACD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5C,CAAC,CAAC;AAGH,+CAA+C;AAC/C,MAAM,UAAU,OAAO,CAAC,UAAkB,EAAE,GAAW;IACrD,OAAO,GAAG,UAAU,IAAI,GAAG,EAAE,CAAC;AAChC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+/**
+ * Fraction of differing pixels above which a screenshot is `changed` (rule 3) when neither the
+ * client's `lockstep.config.ts` nor the project's platform config says otherwise. The reconciler
+ * only reports scores; the API decides `changed` with the project's configured threshold.
+ */
+export declare const DEFAULT_VISUAL_DIFF_THRESHOLD = 0.001;
+/** Shape of `lockstep.config.ts` at the client repo root. */
+export declare const LockstepConfig: z.ZodObject<{
+    projectKey: z.ZodString;
+    apiBaseUrl: z.ZodString;
+    journeysGlob: z.ZodDefault<z.ZodString>;
+    scenariosPath: z.ZodDefault<z.ZodString>;
+    seams: z.ZodArray<z.ZodString, "many">;
+    visualDiffThreshold: z.ZodDefault<z.ZodNumber>;
+    bootCommand: z.ZodString;
+    port: z.ZodNumber;
+    /** Base URL the app under test talks to; must be a mock origin. */
+    appApiBase: z.ZodOptional<z.ZodString>;
+    /** Regex (string) the appApiBase must match for walks to be allowed. */
+    mockApiPattern: z.ZodDefault<z.ZodString>;
+    schema: z.ZodOptional<z.ZodObject<{
+        sdlPath: z.ZodString;
+        codegenOutput: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sdlPath: string;
+        codegenOutput: string;
+    }, {
+        sdlPath: string;
+        codegenOutput: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    projectKey: string;
+    apiBaseUrl: string;
+    journeysGlob: string;
+    scenariosPath: string;
+    seams: string[];
+    visualDiffThreshold: number;
+    bootCommand: string;
+    port: number;
+    mockApiPattern: string;
+    appApiBase?: string | undefined;
+    schema?: {
+        sdlPath: string;
+        codegenOutput: string;
+    } | undefined;
+}, {
+    projectKey: string;
+    apiBaseUrl: string;
+    seams: string[];
+    bootCommand: string;
+    port: number;
+    journeysGlob?: string | undefined;
+    scenariosPath?: string | undefined;
+    visualDiffThreshold?: number | undefined;
+    appApiBase?: string | undefined;
+    mockApiPattern?: string | undefined;
+    schema?: {
+        sdlPath: string;
+        codegenOutput: string;
+    } | undefined;
+}>;
+export type LockstepConfig = z.infer<typeof LockstepConfig>;
+/** Project configuration stored on the platform side (projects.config JSONB). */
+export declare const ProjectConfig: z.ZodObject<{
+    seams: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    visualDiffThreshold: z.ZodDefault<z.ZodNumber>;
+    defaultScenario: z.ZodOptional<z.ZodString>;
+    failOnUnresolvedNavigation: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    seams: string[];
+    visualDiffThreshold: number;
+    failOnUnresolvedNavigation: boolean;
+    defaultScenario?: string | undefined;
+}, {
+    seams?: string[] | undefined;
+    visualDiffThreshold?: number | undefined;
+    defaultScenario?: string | undefined;
+    failOnUnresolvedNavigation?: boolean | undefined;
+}>;
+export type ProjectConfig = z.infer<typeof ProjectConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,6DAA6D;AAC7D,eAAO,MAAM,cAAc;;;;;;;;;IAazB,mEAAmE;;IAEnE,wEAAwE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQxE,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,iFAAiF;AACjF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/config.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/**
+ * Fraction of differing pixels above which a screenshot is `changed` (rule 3) when neither the
+ * client's `lockstep.config.ts` nor the project's platform config says otherwise. The reconciler
+ * only reports scores; the API decides `changed` with the project's configured threshold.
+ */
+export const DEFAULT_VISUAL_DIFF_THRESHOLD = 0.001;
+/** Shape of `lockstep.config.ts` at the client repo root. */
+export const LockstepConfig = z.object({
+    projectKey: z
+        .string()
+        .min(2)
+        .max(8)
+        .regex(/^[A-Z][A-Z0-9]*$/, 'project key must be uppercase, e.g. FERN'),
+    apiBaseUrl: z.string().url(),
+    journeysGlob: z.string().min(1).default('src/journeys/*.journey.ts'),
+    scenariosPath: z.string().min(1).default('src/journeys/scenarios.ts'),
+    seams: z.array(z.string().min(1)).min(6).max(8),
+    visualDiffThreshold: z.number().min(0).max(1).default(DEFAULT_VISUAL_DIFF_THRESHOLD),
+    bootCommand: z.string().min(1),
+    port: z.number().int().min(1).max(65535),
+    /** Base URL the app under test talks to; must be a mock origin. */
+    appApiBase: z.string().optional(),
+    /** Regex (string) the appApiBase must match for walks to be allowed. */
+    mockApiPattern: z.string().default('^(mock|msw):|localhost|127\\.0\\.0\\.1'),
+    schema: z
+        .object({
+        sdlPath: z.string().min(1),
+        codegenOutput: z.string().min(1),
+    })
+        .optional(),
+});
+/** Project configuration stored on the platform side (projects.config JSONB). */
+export const ProjectConfig = z.object({
+    seams: z.array(z.string().min(1)).min(1).max(8).default([]),
+    visualDiffThreshold: z.number().min(0).max(1).default(DEFAULT_VISUAL_DIFF_THRESHOLD),
+    defaultScenario: z.string().optional(),
+    failOnUnresolvedNavigation: z.boolean().default(false),
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAEnD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,KAAK,CAAC,kBAAkB,EAAE,0CAA0C,CAAC;IACxE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC;IACpE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,2BAA2B,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC;IACpF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACxC,mEAAmE;IACnE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,wEAAwE;IACxE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC;IAC5E,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KACjC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAGH,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC;IACpF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,0BAA0B,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvD,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './journey.js';
+export * from './config.js';
+export * from './run.js';
+export * from './verdict.js';
+export * from './card.js';
+export * from './api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './journey.js';
+export * from './config.js';
+export * from './run.js';
+export * from './verdict.js';
+export * from './card.js';
+export * from './api.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}