kaafil-react-uikit 0.1.0-beta.1

package/dist/testing/index.d.ts

@@ -0,0 +1,269 @@
+/** `11-engine-requirements.md`'s corrected `ActorKind` — four values, not two.
+ * An API-key write is the CRM acting; collapsing it into the admin case would
+ * name a person who did not act, which `ActorAttributionBadge` must never do. */
+type MockActorKind = 'MANAGER' | 'AGENCY_ADMIN' | 'API_KEY' | 'SYSTEM';
+interface MockActorAttributedRow {
+    readonly performedByKind: MockActorKind;
+    /** `null` for `SYSTEM`/`API_KEY` rows with no human name to show — the
+     * badge's `kind`-only state (`atomic/04-identity.md`'s `ActorBadge`
+     * States: "with `name`" · "`kind`-only"). */
+    readonly performedByName: string | null;
+    /** `meta.serverTime`-derived — never a device clock
+     * (`13-i18n-and-formatting.md`'s server-time rule, inherited here). */
+    readonly performedAt: string;
+}
+/** Produces the shape `ActorAttributionBadge` expects. Defaults to a named
+ * manager actor; override `performedByKind`/`performedByName` to exercise the
+ * other three kinds, including the `kind`-only (`performedByName: null`)
+ * state. */
+declare function mockActorAttributedRow(overrides?: Partial<MockActorAttributedRow>): MockActorAttributedRow;
+
+/** The exact row shape `journey.capabilities()` returns — a flat array, never
+ * a keyed map (`06-capability-and-personas.md §6` point 1). `capability` is an
+ * open string set (§6 point 5); this file never enumerates it exhaustively. */
+interface MockCapabilityRow {
+    readonly capability: string;
+    readonly modeOk: boolean;
+    readonly dataOk: boolean;
+    readonly flagOk: boolean;
+    readonly enabled: boolean;
+}
+/** All three gates true → lit (`06 §1`). */
+declare function litCapability(key: string): MockCapabilityRow;
+/** `modeOk: false`, others true, `enabled: false` — the "render nothing, no
+ * CTA" treatment (`06 §2`): this capability can never become available for
+ * this trip's mode. */
+declare function modeDarkCapability(key: string): MockCapabilityRow;
+/** `dataOk: false`, others true, `enabled: false` — the "connect this" empty
+ * state (`06 §2`): the module is entitled but the CRM hasn't pushed the rows
+ * it needs. */
+declare function dataDarkCapability(key: string): MockCapabilityRow;
+/** `flagOk: false`, others true, `enabled: false` — the upsell/locked
+ * treatment (`06 §2`), split further by `details.reason` (`06 §2.1`) at the
+ * component layer; this builder only produces the boolean triple. */
+declare function flagDarkCapability(key: string): MockCapabilityRow;
+/**
+ * Composes zero or more capability rows into the flat array shape the wire
+ * returns. Pass an array built from `litCapability`/`modeDarkCapability`/
+ * `dataDarkCapability`/`flagDarkCapability` — this is how a fixture reproduces,
+ * e.g., the frozen PERSONALIZED mode-dark set (`06 §3`, cited not restated
+ * here — enumerating those eleven module keys is that file's job, not this
+ * one's, to avoid a second, driftable copy of a frozen list) as an array of
+ * `modeDarkCapability(...)` calls.
+ */
+declare function mockCapabilities(overrides?: readonly MockCapabilityRow[]): MockCapabilityRow[];
+
+/** The jittered, capped backoff ladder (`07-offline-and-sync.md §3`) — seven
+ * rungs, the last one held until connectivity or app resume. `0` means "not
+ * yet retried"; `6` means "held at 1h". */
+type BackoffRung = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+declare const BACKOFF_LADDER_MS: readonly [number, number, number, number, number, number, number];
+type MockOutboxEntryStatus = 'pending' | 'inflight' | 'parked' | 'done';
+interface MockOutboxEntry {
+    readonly opId: string;
+    readonly tripRef: string;
+    readonly entity: {
+        readonly listName: string;
+        readonly id: string;
+    };
+    readonly status: MockOutboxEntryStatus;
+    readonly backoffRung: BackoffRung;
+}
+interface MockConflictEntry {
+    readonly opId: string;
+    readonly entity: {
+        readonly listName: string;
+        readonly id: string;
+    };
+    readonly queued: Record<string, unknown>;
+    readonly current: Record<string, unknown>;
+}
+interface MockOfflineEngineState {
+    readonly online: boolean;
+    readonly outbox: readonly MockOutboxEntry[];
+    readonly conflicts: readonly MockConflictEntry[];
+}
+interface MockOfflineEngine {
+    /** A snapshot of current state. Never mutated by the caller — mutate only
+     * through the methods below, mirroring the real engine's own
+     * read-through-methods-only shape. */
+    getState(): MockOfflineEngineState;
+    goOffline(): void;
+    goOnline(): void;
+    /** Adds a `pending` outbox entry at backoff rung 0. Returns the entry so a
+     * test can reference its `opId` in a later call. */
+    enqueuePendingEntry(entry: Partial<Omit<MockOutboxEntry, 'status' | 'backoffRung'>>): MockOutboxEntry;
+    /** Moves one rung up the ladder (`07 §3`) — capped at rung 6, never past
+     * it, mirroring the real ladder holding at 1h. Throws a named error if
+     * `opId` is not in the outbox, so a test typo fails loudly rather than
+     * silently no-op-ing. */
+    advanceBackoff(opId: string): BackoffRung;
+    /** Marks an entry `parked` — the terminal, non-retried state
+     * (`07 §10`). */
+    parkEntry(opId: string): void;
+    /** Marks an entry `done` and removes it from the outbox — the terminal
+     * success state, pruned on the next persist (mirrors `kaafil-js`'s own
+     * `OutboxStatus.Done`). */
+    completeEntry(opId: string): void;
+    /** Injects a conflict on a specific entity — the `409` reconciliation path
+     * (`07 §6`). */
+    forceConflict(entry: MockConflictEntry): void;
+    /** Removes a conflict once a test has driven its resolution. */
+    resolveConflict(opId: string): void;
+}
+/**
+ * Builds a controllable, deterministic offline-engine fixture. `initialState`
+ * seeds the outbox/conflicts/online flag; every mutator below is synchronous.
+ */
+declare function mockOfflineEngine(initialState?: Partial<MockOfflineEngineState>): MockOfflineEngine;
+
+/** `04-customization-ladder.md §6` — the exact, build-time-fixed density scale. */
+type DensityToken = 'compact' | 'default' | 'comfortable';
+/** `03 §7` / `06-capability-and-personas.md §7` — `COORDINATOR` is read-only,
+ * `MANAGER` is full access. No third value; no relaxed/elevated variant. */
+type ManagerRole = 'MANAGER' | 'COORDINATOR';
+interface MockManagerSession {
+    readonly kind: 'managerSession';
+    readonly accessToken: string;
+    readonly refreshToken: string;
+    readonly expiresAt: string;
+    /** The mint response's internal `agencyId`, threaded through as `agencyRef`
+     * — see `kaafil-js`'s `OpenManagerSessionOptions.agencyRef` doc comment for
+     * why this is the internal id, not the external `AGENCY-###` ref. */
+    readonly agencyRef: string;
+    readonly role: ManagerRole;
+    /** Convenience only — see this file's header comment. Omitted overrides
+     * fall back to the family's own shell default, exactly as production does. */
+    readonly density?: DensityToken;
+}
+interface MockAgencyAdminSession {
+    readonly kind: 'agencyAdmin';
+    readonly accessToken: string;
+    readonly refreshToken: string;
+    readonly expiresAt: string;
+    /** Agency-scoped, one role, no read-only variant — `D-096`, `03 §7`. There is
+     * no `role` field: agencyAdmin has exactly one. */
+    readonly agencyRef: string;
+    readonly density?: DensityToken;
+}
+interface MockShareSession {
+    readonly kind: 'shareToken';
+    readonly token: string;
+    readonly tripRef: string;
+    /** `null` produces a family-token session (`briefing §26`) — no single
+     * traveller subject bound, the token covers the whole family/party. A
+     * non-null value is the default: a subject-bound share session. */
+    readonly travellerId: string | null;
+    readonly expiresAt: string;
+    readonly density?: DensityToken;
+}
+/**
+ * A fake OPEN manager session satisfying the manager auth adapter
+ * (`06-capability-and-personas.md §7`, `U-003`). `role` defaults to `MANAGER`;
+ * pass `{ role: 'COORDINATOR' }` for the read-only variant.
+ */
+declare function mockManagerSession(overrides?: Partial<Omit<MockManagerSession, 'kind'>>): MockManagerSession;
+/** A fake OPEN agencyAdmin session, agency-scoped. */
+declare function mockAgencyAdminSession(overrides?: Partial<Omit<MockAgencyAdminSession, 'kind'>>): MockAgencyAdminSession;
+/**
+ * A fake OPEN share-token session. `{ travellerId: null }` produces a
+ * family-token session; the default has a subject bound.
+ */
+declare function mockShareSession(overrides?: Partial<Omit<MockShareSession, 'kind'>>): MockShareSession;
+
+/** The six kinds `14-testing-and-fixtures.md §1.3` names — no seventh, no
+ * collapsing two into one. */
+type MockSyncEventKind = 'enqueued' | 'flushed' | 'conflict' | 'parked' | 'reconnected' | 'delta-applied';
+/** Write-ahead, before any network call (`07 §2`). */
+interface MockSyncEnqueuedEvent {
+    readonly kind: 'enqueued';
+    readonly opId: string;
+    readonly tripRef: string;
+    readonly entity: {
+        readonly listName: string;
+        readonly id: string;
+    };
+    readonly enqueuedAt: string;
+    /** The row painted immediately, ahead of any server confirmation. */
+    readonly optimistic: Record<string, unknown>;
+}
+/** An op reached a 2xx and drained (`07 §3`). */
+interface MockSyncFlushedEvent {
+    readonly kind: 'flushed';
+    readonly opId: string;
+    readonly tripRef: string;
+    readonly entity: {
+        readonly listName: string;
+        readonly id: string;
+    };
+    /** The rebased canonical row, carrying the server `version`. */
+    readonly applied: Record<string, unknown>;
+    readonly appliedAt: string;
+}
+/** `07 §6` — two conflict shapes normalise into one component. Every versioned
+ * entity except the checklist-item toggle carries `currentVersion`; the
+ * toggle's optimistic concurrency uses `expectedStatus`/`currentStatus`
+ * instead (`07 §6`, `modules/checklists/FRD.md §4.3`). */
+type MockConflictResolutionShape = {
+    readonly shape: 'version';
+    readonly currentVersion: number;
+} | {
+    readonly shape: 'status';
+    readonly currentStatus: string;
+};
+/** Carries BOTH the queued and current values the shared resolver UI needs
+ * (`07 §6` steps 1–3) — never only one side. */
+interface MockSyncConflictEvent {
+    readonly kind: 'conflict';
+    readonly opId: string;
+    readonly tripRef: string;
+    readonly entity: {
+        readonly listName: string;
+        readonly id: string;
+    };
+    /** The locally intended change, as originally enqueued. */
+    readonly queued: Record<string, unknown>;
+    /** The fresh server row, re-read at its current version (`07 §6`'s "why
+     * the entity is re-pulled first"). */
+    readonly current: Record<string, unknown>;
+    readonly resolution: MockConflictResolutionShape;
+}
+/** A permanently non-retryable op — `423`/`410`/`402`/`UnsatisfiableScheme`
+ * (`07 §10`). Never silently dropped; surfaced and left visibly stalled. */
+interface MockSyncParkedEvent {
+    readonly kind: 'parked';
+    readonly opId: string;
+    readonly tripRef: string;
+    readonly status: number;
+    /** A message fit to show a manager (mirrors `SyncErrorEvent.userMessage`
+     * in `kaafil-js`'s own event map). */
+    readonly userMessage: string;
+}
+/** Connectivity restored — the drainer fires opportunistically (`07 §3`). */
+interface MockSyncReconnectedEvent {
+    readonly kind: 'reconnected';
+    readonly at: string;
+}
+/** At-least-once redelivery (`07 §4`) — includes a row identical to one
+ * already applied, so a component's idempotence against duplicate delivery is
+ * directly testable rather than assumed. */
+interface MockSyncDeltaAppliedEvent {
+    readonly kind: 'delta-applied';
+    readonly tripRef: string;
+    readonly list: string;
+    readonly rows: readonly Record<string, unknown>[];
+    /** True on the row(s) that are a byte-for-byte redelivery of a row already
+     * merged on a prior pull — never a change, by construction of this fixture. */
+    readonly redeliveredIds: readonly string[];
+    /** The new cursor, from `meta.serverTime` (`07 §4`). */
+    readonly serverTime: string;
+}
+type MockSyncEvent = MockSyncEnqueuedEvent | MockSyncFlushedEvent | MockSyncConflictEvent | MockSyncParkedEvent | MockSyncReconnectedEvent | MockSyncDeltaAppliedEvent;
+declare function mockSyncEvent(kind: 'enqueued', overrides?: Partial<Omit<MockSyncEnqueuedEvent, 'kind'>>): MockSyncEnqueuedEvent;
+declare function mockSyncEvent(kind: 'flushed', overrides?: Partial<Omit<MockSyncFlushedEvent, 'kind'>>): MockSyncFlushedEvent;
+declare function mockSyncEvent(kind: 'conflict', overrides?: Partial<Omit<MockSyncConflictEvent, 'kind'>>): MockSyncConflictEvent;
+declare function mockSyncEvent(kind: 'parked', overrides?: Partial<Omit<MockSyncParkedEvent, 'kind'>>): MockSyncParkedEvent;
+declare function mockSyncEvent(kind: 'reconnected', overrides?: Partial<Omit<MockSyncReconnectedEvent, 'kind'>>): MockSyncReconnectedEvent;
+declare function mockSyncEvent(kind: 'delta-applied', overrides?: Partial<Omit<MockSyncDeltaAppliedEvent, 'kind'>>): MockSyncDeltaAppliedEvent;
+
+export { BACKOFF_LADDER_MS, type BackoffRung, type DensityToken, type ManagerRole, type MockActorAttributedRow, type MockActorKind, type MockAgencyAdminSession, type MockCapabilityRow, type MockConflictEntry, type MockConflictResolutionShape, type MockManagerSession, type MockOfflineEngine, type MockOfflineEngineState, type MockOutboxEntry, type MockOutboxEntryStatus, type MockShareSession, type MockSyncConflictEvent, type MockSyncDeltaAppliedEvent, type MockSyncEnqueuedEvent, type MockSyncEvent, type MockSyncEventKind, type MockSyncFlushedEvent, type MockSyncParkedEvent, type MockSyncReconnectedEvent, dataDarkCapability, flagDarkCapability, litCapability, mockActorAttributedRow, mockAgencyAdminSession, mockCapabilities, mockManagerSession, mockOfflineEngine, mockShareSession, mockSyncEvent, modeDarkCapability };

package/dist/testing/index.js

@@ -0,0 +1,208 @@
+// src/testing/actor-rows.ts
+var DEFAULT_PERFORMED_AT = "2026-08-21T18:00:00.000Z";
+function mockActorAttributedRow(overrides = {}) {
+  return {
+    performedByKind: overrides.performedByKind ?? "MANAGER",
+    performedByName: overrides.performedByName !== void 0 ? overrides.performedByName : "Asha Rao",
+    performedAt: overrides.performedAt ?? DEFAULT_PERFORMED_AT
+  };
+}
+
+// src/testing/capabilities.ts
+function litCapability(key) {
+  return { capability: key, modeOk: true, dataOk: true, flagOk: true, enabled: true };
+}
+function modeDarkCapability(key) {
+  return { capability: key, modeOk: false, dataOk: true, flagOk: true, enabled: false };
+}
+function dataDarkCapability(key) {
+  return { capability: key, modeOk: true, dataOk: false, flagOk: true, enabled: false };
+}
+function flagDarkCapability(key) {
+  return { capability: key, modeOk: true, dataOk: true, flagOk: false, enabled: false };
+}
+function mockCapabilities(overrides = []) {
+  return overrides.length > 0 ? [...overrides] : [litCapability("rooming")];
+}
+
+// src/testing/offline-engine.ts
+var BACKOFF_LADDER_MS = [1e3, 5e3, 15e3, 6e4, 3e5, 9e5, 36e5];
+var MockOfflineEngineOpNotFoundError = class extends Error {
+  constructor(opId) {
+    super(`mockOfflineEngine: no outbox entry with opId "${opId}"`);
+    this.name = "MockOfflineEngineOpNotFoundError";
+  }
+};
+function mockOfflineEngine(initialState = {}) {
+  let online = initialState.online === void 0 ? true : initialState.online;
+  let outbox = initialState.outbox ? [...initialState.outbox] : [];
+  let conflicts = initialState.conflicts ? [...initialState.conflicts] : [];
+  let opCounter = 0;
+  function requireEntry(opId) {
+    const found = outbox.find((entry) => entry.opId === opId);
+    if (found === void 0) {
+      throw new MockOfflineEngineOpNotFoundError(opId);
+    }
+    return found;
+  }
+  function replaceEntry(opId, next) {
+    outbox = outbox.map((entry) => entry.opId === opId ? next : entry);
+  }
+  return {
+    getState() {
+      return { online, outbox: [...outbox], conflicts: [...conflicts] };
+    },
+    goOffline() {
+      online = false;
+    },
+    goOnline() {
+      online = true;
+    },
+    enqueuePendingEntry(entry) {
+      opCounter += 1;
+      const created = {
+        opId: entry.opId ?? `mock-op-${String(opCounter)}`,
+        tripRef: entry.tripRef ?? "TRIP-001",
+        entity: entry.entity ?? { listName: "rooming", id: `entity-${String(opCounter)}` },
+        status: "pending",
+        backoffRung: 0
+      };
+      outbox = [...outbox, created];
+      return created;
+    },
+    advanceBackoff(opId) {
+      const entry = requireEntry(opId);
+      const nextRung = Math.min(entry.backoffRung + 1, 6);
+      replaceEntry(opId, { ...entry, backoffRung: nextRung });
+      return nextRung;
+    },
+    parkEntry(opId) {
+      const entry = requireEntry(opId);
+      replaceEntry(opId, { ...entry, status: "parked" });
+    },
+    completeEntry(opId) {
+      requireEntry(opId);
+      outbox = outbox.filter((entry) => entry.opId !== opId);
+    },
+    forceConflict(entry) {
+      conflicts = [...conflicts, entry];
+    },
+    resolveConflict(opId) {
+      conflicts = conflicts.filter((entry) => entry.opId !== opId);
+    }
+  };
+}
+
+// src/testing/sessions.ts
+var sessionCounter = 0;
+function nextSessionId(prefix) {
+  sessionCounter += 1;
+  return `${prefix}-${sessionCounter}`;
+}
+var DEFAULT_EXPIRES_AT = "2026-08-21T18:00:00.000Z";
+function mockManagerSession(overrides = {}) {
+  return {
+    kind: "managerSession",
+    accessToken: overrides.accessToken ?? nextSessionId("mock-manager-access"),
+    refreshToken: overrides.refreshToken ?? nextSessionId("mock-manager-refresh"),
+    expiresAt: overrides.expiresAt ?? DEFAULT_EXPIRES_AT,
+    agencyRef: overrides.agencyRef ?? nextSessionId("mock-agency"),
+    role: overrides.role ?? "MANAGER",
+    ...overrides.density !== void 0 ? { density: overrides.density } : {}
+  };
+}
+function mockAgencyAdminSession(overrides = {}) {
+  return {
+    kind: "agencyAdmin",
+    accessToken: overrides.accessToken ?? nextSessionId("mock-admin-access"),
+    refreshToken: overrides.refreshToken ?? nextSessionId("mock-admin-refresh"),
+    expiresAt: overrides.expiresAt ?? DEFAULT_EXPIRES_AT,
+    agencyRef: overrides.agencyRef ?? nextSessionId("mock-agency"),
+    ...overrides.density !== void 0 ? { density: overrides.density } : {}
+  };
+}
+function mockShareSession(overrides = {}) {
+  return {
+    kind: "shareToken",
+    token: overrides.token ?? nextSessionId("mock-share-token"),
+    tripRef: overrides.tripRef ?? nextSessionId("mock-trip"),
+    travellerId: overrides.travellerId === void 0 ? nextSessionId("mock-traveller") : overrides.travellerId,
+    expiresAt: overrides.expiresAt ?? DEFAULT_EXPIRES_AT,
+    ...overrides.density !== void 0 ? { density: overrides.density } : {}
+  };
+}
+
+// src/testing/sync-events.ts
+var DEFAULT_SERVER_TIME = "2026-08-21T18:00:00.000Z";
+function defaultEntity() {
+  return { listName: "rooming", id: "entity-1" };
+}
+function mockSyncEvent(kind, overrides = {}) {
+  switch (kind) {
+    case "enqueued":
+      return {
+        kind: "enqueued",
+        opId: "op-1",
+        tripRef: "TRIP-001",
+        entity: defaultEntity(),
+        enqueuedAt: DEFAULT_SERVER_TIME,
+        optimistic: {},
+        ...overrides
+      };
+    case "flushed":
+      return {
+        kind: "flushed",
+        opId: "op-1",
+        tripRef: "TRIP-001",
+        entity: defaultEntity(),
+        applied: {},
+        appliedAt: DEFAULT_SERVER_TIME,
+        ...overrides
+      };
+    case "conflict":
+      return {
+        kind: "conflict",
+        opId: "op-1",
+        tripRef: "TRIP-001",
+        entity: defaultEntity(),
+        queued: { roomId: "room-a" },
+        current: { roomId: "room-b" },
+        resolution: { shape: "version", currentVersion: 3 },
+        ...overrides
+      };
+    case "parked":
+      return {
+        kind: "parked",
+        opId: "op-1",
+        tripRef: "TRIP-001",
+        status: 423,
+        userMessage: "This trip has been closed out and can no longer be edited.",
+        ...overrides
+      };
+    case "reconnected":
+      return {
+        kind: "reconnected",
+        at: DEFAULT_SERVER_TIME,
+        ...overrides
+      };
+    case "delta-applied":
+      return {
+        kind: "delta-applied",
+        tripRef: "TRIP-001",
+        list: "rooming",
+        rows: [
+          { id: "row-1", roomId: "room-a" },
+          // A byte-for-byte redelivery of `row-1` — same id, same fields —
+          // exercising `07 §4`'s "applying the same row twice must be a no-op".
+          { id: "row-1", roomId: "room-a" }
+        ],
+        redeliveredIds: ["row-1"],
+        serverTime: DEFAULT_SERVER_TIME,
+        ...overrides
+      };
+  }
+}
+
+export { BACKOFF_LADDER_MS, dataDarkCapability, flagDarkCapability, litCapability, mockActorAttributedRow, mockAgencyAdminSession, mockCapabilities, mockManagerSession, mockOfflineEngine, mockShareSession, mockSyncEvent, modeDarkCapability };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/actor-rows.ts","../../src/testing/capabilities.ts","../../src/testing/offline-engine.ts","../../src/testing/sessions.ts","../../src/testing/sync-events.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Bundled to the \"./testing\" export (02-architecture.md §1). A mock\n// actor-attributed row, the shape `ActorAttributionBadge` renders\n// (`14-testing-and-fixtures.md §1.5`).\n//\n// GAP-014/GAP-015 (`11-engine-requirements.md`) leave the actor pair absent on\n// `FormResponse` and `File` respectively — `FormResponse` has no schema column\n// at all, and `File` hand-rolls its own actor resolution instead of the shared\n// `write-actor.ts` resolver every sibling table uses, which is why it has none\n// today. Any `ActorAttributionBadge` usage built against a form-response or\n// file history/audit surface is therefore built against THIS MOCK ONLY — there\n// is no live data to fetch until those two gaps close. This is what makes\n// \"specified to full depth except `Backed by`\" (`10-doc-contract.md §6`) an\n// executable claim: the component can be built, screenshotted, and audited\n// against the DX bar (`14-testing-and-fixtures.md §3`) today, genuinely\n// blocked from shipping against real data until GAP-014/GAP-015 close.\n\n/** `11-engine-requirements.md`'s corrected `ActorKind` — four values, not two.\n * An API-key write is the CRM acting; collapsing it into the admin case would\n * name a person who did not act, which `ActorAttributionBadge` must never do. */\nexport type MockActorKind = 'MANAGER' | 'AGENCY_ADMIN' | 'API_KEY' | 'SYSTEM';\n\nexport interface MockActorAttributedRow {\n  readonly performedByKind: MockActorKind;\n  /** `null` for `SYSTEM`/`API_KEY` rows with no human name to show — the\n   * badge's `kind`-only state (`atomic/04-identity.md`'s `ActorBadge`\n   * States: \"with `name`\" · \"`kind`-only\"). */\n  readonly performedByName: string | null;\n  /** `meta.serverTime`-derived — never a device clock\n   * (`13-i18n-and-formatting.md`'s server-time rule, inherited here). */\n  readonly performedAt: string;\n}\n\nconst DEFAULT_PERFORMED_AT = '2026-08-21T18:00:00.000Z';\n\n/** Produces the shape `ActorAttributionBadge` expects. Defaults to a named\n * manager actor; override `performedByKind`/`performedByName` to exercise the\n * other three kinds, including the `kind`-only (`performedByName: null`)\n * state. */\nexport function mockActorAttributedRow(\n  overrides: Partial<MockActorAttributedRow> = {},\n): MockActorAttributedRow {\n  return {\n    performedByKind: overrides.performedByKind ?? 'MANAGER',\n    performedByName:\n      overrides.performedByName !== undefined ? overrides.performedByName : 'Asha Rao',\n    performedAt: overrides.performedAt ?? DEFAULT_PERFORMED_AT,\n  };\n}\n","// Bundled to the \"./testing\" export (02-architecture.md §1). Fixture shapes for\n// the exact flat array `journey.capabilities()` returns\n// (`06-capability-and-personas.md §6`, cited not restated) plus one helper per\n// darkness reason (`§1.2` of `14-testing-and-fixtures.md`, cited not restated)\n// so a fixture author never hand-constructs the boolean triple.\n//\n// This file does not restate the lit/dark formula or the three darkness\n// treatments — `06-capability-and-personas.md §1`/`§2` is the one home. It only\n// produces data satisfying that shape.\n\n/** The exact row shape `journey.capabilities()` returns — a flat array, never\n * a keyed map (`06-capability-and-personas.md §6` point 1). `capability` is an\n * open string set (§6 point 5); this file never enumerates it exhaustively. */\nexport interface MockCapabilityRow {\n  readonly capability: string;\n  readonly modeOk: boolean;\n  readonly dataOk: boolean;\n  readonly flagOk: boolean;\n  readonly enabled: boolean;\n}\n\n/** All three gates true → lit (`06 §1`). */\nexport function litCapability(key: string): MockCapabilityRow {\n  return { capability: key, modeOk: true, dataOk: true, flagOk: true, enabled: true };\n}\n\n/** `modeOk: false`, others true, `enabled: false` — the \"render nothing, no\n * CTA\" treatment (`06 §2`): this capability can never become available for\n * this trip's mode. */\nexport function modeDarkCapability(key: string): MockCapabilityRow {\n  return { capability: key, modeOk: false, dataOk: true, flagOk: true, enabled: false };\n}\n\n/** `dataOk: false`, others true, `enabled: false` — the \"connect this\" empty\n * state (`06 §2`): the module is entitled but the CRM hasn't pushed the rows\n * it needs. */\nexport function dataDarkCapability(key: string): MockCapabilityRow {\n  return { capability: key, modeOk: true, dataOk: false, flagOk: true, enabled: false };\n}\n\n/** `flagOk: false`, others true, `enabled: false` — the upsell/locked\n * treatment (`06 §2`), split further by `details.reason` (`06 §2.1`) at the\n * component layer; this builder only produces the boolean triple. */\nexport function flagDarkCapability(key: string): MockCapabilityRow {\n  return { capability: key, modeOk: true, dataOk: true, flagOk: false, enabled: false };\n}\n\n/**\n * Composes zero or more capability rows into the flat array shape the wire\n * returns. Pass an array built from `litCapability`/`modeDarkCapability`/\n * `dataDarkCapability`/`flagDarkCapability` — this is how a fixture reproduces,\n * e.g., the frozen PERSONALIZED mode-dark set (`06 §3`, cited not restated\n * here — enumerating those eleven module keys is that file's job, not this\n * one's, to avoid a second, driftable copy of a frozen list) as an array of\n * `modeDarkCapability(...)` calls.\n */\nexport function mockCapabilities(\n  overrides: readonly MockCapabilityRow[] = [],\n): MockCapabilityRow[] {\n  return overrides.length > 0 ? [...overrides] : [litCapability('rooming')];\n}\n","// Bundled to the \"./testing\" export (02-architecture.md §1). A mock\n// `OfflineEngine`-shaped fixture (`14-testing-and-fixtures.md §1.4`) — plain\n// data plus plain synchronous mutator functions, no timers, no real network,\n// no `kaafil-js` import (hard rule #1: this file lives outside `src/core/`, so\n// it never imports the real SDK — it produces a fixture satisfying the shape\n// `08-core-hooks.md` will define, not a copy of `kaafil-js`'s own\n// `OfflineEngine` type).\n//\n// Everything here is script-drivable and deterministic: force offline/online,\n// inject a pending outbox entry, advance the backoff ladder one step, force a\n// conflict on a specific entity — all synchronously, so a `smoke/dx-NN.sh`\n// script can assert against it without a timing-dependent wait\n// (`14-testing-and-fixtures.md §1.4`).\n\n/** The jittered, capped backoff ladder (`07-offline-and-sync.md §3`) — seven\n * rungs, the last one held until connectivity or app resume. `0` means \"not\n * yet retried\"; `6` means \"held at 1h\". */\nexport type BackoffRung = 0 | 1 | 2 | 3 | 4 | 5 | 6;\n\nexport const BACKOFF_LADDER_MS: readonly [number, number, number, number, number, number, number] =\n  [1_000, 5_000, 15_000, 60_000, 300_000, 900_000, 3_600_000];\n\nexport type MockOutboxEntryStatus = 'pending' | 'inflight' | 'parked' | 'done';\n\nexport interface MockOutboxEntry {\n  readonly opId: string;\n  readonly tripRef: string;\n  readonly entity: { readonly listName: string; readonly id: string };\n  readonly status: MockOutboxEntryStatus;\n  readonly backoffRung: BackoffRung;\n}\n\nexport interface MockConflictEntry {\n  readonly opId: string;\n  readonly entity: { readonly listName: string; readonly id: string };\n  readonly queued: Record<string, unknown>;\n  readonly current: Record<string, unknown>;\n}\n\nexport interface MockOfflineEngineState {\n  readonly online: boolean;\n  readonly outbox: readonly MockOutboxEntry[];\n  readonly conflicts: readonly MockConflictEntry[];\n}\n\nexport interface MockOfflineEngine {\n  /** A snapshot of current state. Never mutated by the caller — mutate only\n   * through the methods below, mirroring the real engine's own\n   * read-through-methods-only shape. */\n  getState(): MockOfflineEngineState;\n  goOffline(): void;\n  goOnline(): void;\n  /** Adds a `pending` outbox entry at backoff rung 0. Returns the entry so a\n   * test can reference its `opId` in a later call. */\n  enqueuePendingEntry(\n    entry: Partial<Omit<MockOutboxEntry, 'status' | 'backoffRung'>>,\n  ): MockOutboxEntry;\n  /** Moves one rung up the ladder (`07 §3`) — capped at rung 6, never past\n   * it, mirroring the real ladder holding at 1h. Throws a named error if\n   * `opId` is not in the outbox, so a test typo fails loudly rather than\n   * silently no-op-ing. */\n  advanceBackoff(opId: string): BackoffRung;\n  /** Marks an entry `parked` — the terminal, non-retried state\n   * (`07 §10`). */\n  parkEntry(opId: string): void;\n  /** Marks an entry `done` and removes it from the outbox — the terminal\n   * success state, pruned on the next persist (mirrors `kaafil-js`'s own\n   * `OutboxStatus.Done`). */\n  completeEntry(opId: string): void;\n  /** Injects a conflict on a specific entity — the `409` reconciliation path\n   * (`07 §6`). */\n  forceConflict(entry: MockConflictEntry): void;\n  /** Removes a conflict once a test has driven its resolution. */\n  resolveConflict(opId: string): void;\n}\n\nclass MockOfflineEngineOpNotFoundError extends Error {\n  constructor(opId: string) {\n    super(`mockOfflineEngine: no outbox entry with opId \"${opId}\"`);\n    this.name = 'MockOfflineEngineOpNotFoundError';\n  }\n}\n\n/**\n * Builds a controllable, deterministic offline-engine fixture. `initialState`\n * seeds the outbox/conflicts/online flag; every mutator below is synchronous.\n */\nexport function mockOfflineEngine(\n  initialState: Partial<MockOfflineEngineState> = {},\n): MockOfflineEngine {\n  // Not `?? true` — `smoke/dx-03.sh` scans the whole package (`src/testing/**`\n  // included) for exactly that shape, on purpose (hard rule #5's \"no second,\n  // silent flag default\" is treated as the same anti-pattern in a mock\n  // builder as in a real hook). An explicit `undefined` check reads the same\n  // and satisfies the check.\n  let online = initialState.online === undefined ? true : initialState.online;\n  let outbox: MockOutboxEntry[] = initialState.outbox ? [...initialState.outbox] : [];\n  let conflicts: MockConflictEntry[] = initialState.conflicts ? [...initialState.conflicts] : [];\n  let opCounter = 0;\n\n  function requireEntry(opId: string): MockOutboxEntry {\n    const found = outbox.find((entry) => entry.opId === opId);\n    if (found === undefined) {\n      throw new MockOfflineEngineOpNotFoundError(opId);\n    }\n    return found;\n  }\n\n  function replaceEntry(opId: string, next: MockOutboxEntry): void {\n    outbox = outbox.map((entry) => (entry.opId === opId ? next : entry));\n  }\n\n  return {\n    getState() {\n      return { online, outbox: [...outbox], conflicts: [...conflicts] };\n    },\n    goOffline() {\n      online = false;\n    },\n    goOnline() {\n      online = true;\n    },\n    enqueuePendingEntry(entry) {\n      opCounter += 1;\n      const created: MockOutboxEntry = {\n        opId: entry.opId ?? `mock-op-${String(opCounter)}`,\n        tripRef: entry.tripRef ?? 'TRIP-001',\n        entity: entry.entity ?? { listName: 'rooming', id: `entity-${String(opCounter)}` },\n        status: 'pending',\n        backoffRung: 0,\n      };\n      outbox = [...outbox, created];\n      return created;\n    },\n    advanceBackoff(opId) {\n      const entry = requireEntry(opId);\n      const nextRung = Math.min(entry.backoffRung + 1, 6) as BackoffRung;\n      replaceEntry(opId, { ...entry, backoffRung: nextRung });\n      return nextRung;\n    },\n    parkEntry(opId) {\n      const entry = requireEntry(opId);\n      replaceEntry(opId, { ...entry, status: 'parked' });\n    },\n    completeEntry(opId) {\n      requireEntry(opId);\n      outbox = outbox.filter((entry) => entry.opId !== opId);\n    },\n    forceConflict(entry) {\n      conflicts = [...conflicts, entry];\n    },\n    resolveConflict(opId) {\n      conflicts = conflicts.filter((entry) => entry.opId !== opId);\n    },\n  };\n}\n","// Bundled to the \"./testing\" export (02-architecture.md §1). Fake OPEN sessions,\n// one builder per persona — `14-testing-and-fixtures.md §1.1`. Plain factory\n// functions returning plain data; no test-framework dependency, no `kaafil-js`\n// import (hard rule #1 does not even need to be cited here — there is nothing\n// in this file an SDK type could usefully replace: a fixture only needs to look\n// like the token/claim shape the real auth adapters resolve, never the SDK's\n// own credential-resolver internals).\n//\n// U-013 (`00-decisions.md`) retired the `desk`/`field`/`public` `mode` axis, so\n// no builder below accepts a `mode` override — there is no second presentation\n// of a component for a fixture to select. `density` is the one presentational\n// knob that survives (`04-customization-ladder.md §6`); it is carried on the\n// fixture as a convenience field a Storybook decorator or smoke script can lift\n// onto the family's default density, not as anything the real session token\n// carries on the wire.\n\n/** `04-customization-ladder.md §6` — the exact, build-time-fixed density scale. */\nexport type DensityToken = 'compact' | 'default' | 'comfortable';\n\n/** `03 §7` / `06-capability-and-personas.md §7` — `COORDINATOR` is read-only,\n * `MANAGER` is full access. No third value; no relaxed/elevated variant. */\nexport type ManagerRole = 'MANAGER' | 'COORDINATOR';\n\nexport interface MockManagerSession {\n  readonly kind: 'managerSession';\n  readonly accessToken: string;\n  readonly refreshToken: string;\n  readonly expiresAt: string;\n  /** The mint response's internal `agencyId`, threaded through as `agencyRef`\n   * — see `kaafil-js`'s `OpenManagerSessionOptions.agencyRef` doc comment for\n   * why this is the internal id, not the external `AGENCY-###` ref. */\n  readonly agencyRef: string;\n  readonly role: ManagerRole;\n  /** Convenience only — see this file's header comment. Omitted overrides\n   * fall back to the family's own shell default, exactly as production does. */\n  readonly density?: DensityToken;\n}\n\nexport interface MockAgencyAdminSession {\n  readonly kind: 'agencyAdmin';\n  readonly accessToken: string;\n  readonly refreshToken: string;\n  readonly expiresAt: string;\n  /** Agency-scoped, one role, no read-only variant — `D-096`, `03 §7`. There is\n   * no `role` field: agencyAdmin has exactly one. */\n  readonly agencyRef: string;\n  readonly density?: DensityToken;\n}\n\nexport interface MockShareSession {\n  readonly kind: 'shareToken';\n  readonly token: string;\n  readonly tripRef: string;\n  /** `null` produces a family-token session (`briefing §26`) — no single\n   * traveller subject bound, the token covers the whole family/party. A\n   * non-null value is the default: a subject-bound share session. */\n  readonly travellerId: string | null;\n  readonly expiresAt: string;\n  readonly density?: DensityToken;\n}\n\nlet sessionCounter = 0;\n\n/** Deterministic-but-distinct default ids — no `Date.now()`/`Math.random()`\n * (`07-offline-and-sync.md`'s determinism expectation for fixtures extends\n * here: a script asserting against a builder's default output must get the\n * same shape on every run within one process). */\nfunction nextSessionId(prefix: string): string {\n  sessionCounter += 1;\n  return `${prefix}-${sessionCounter}`;\n}\n\nconst DEFAULT_EXPIRES_AT = '2026-08-21T18:00:00.000Z';\n\n/**\n * A fake OPEN manager session satisfying the manager auth adapter\n * (`06-capability-and-personas.md §7`, `U-003`). `role` defaults to `MANAGER`;\n * pass `{ role: 'COORDINATOR' }` for the read-only variant.\n */\nexport function mockManagerSession(\n  overrides: Partial<Omit<MockManagerSession, 'kind'>> = {},\n): MockManagerSession {\n  return {\n    kind: 'managerSession',\n    accessToken: overrides.accessToken ?? nextSessionId('mock-manager-access'),\n    refreshToken: overrides.refreshToken ?? nextSessionId('mock-manager-refresh'),\n    expiresAt: overrides.expiresAt ?? DEFAULT_EXPIRES_AT,\n    agencyRef: overrides.agencyRef ?? nextSessionId('mock-agency'),\n    role: overrides.role ?? 'MANAGER',\n    ...(overrides.density !== undefined ? { density: overrides.density } : {}),\n  };\n}\n\n/** A fake OPEN agencyAdmin session, agency-scoped. */\nexport function mockAgencyAdminSession(\n  overrides: Partial<Omit<MockAgencyAdminSession, 'kind'>> = {},\n): MockAgencyAdminSession {\n  return {\n    kind: 'agencyAdmin',\n    accessToken: overrides.accessToken ?? nextSessionId('mock-admin-access'),\n    refreshToken: overrides.refreshToken ?? nextSessionId('mock-admin-refresh'),\n    expiresAt: overrides.expiresAt ?? DEFAULT_EXPIRES_AT,\n    agencyRef: overrides.agencyRef ?? nextSessionId('mock-agency'),\n    ...(overrides.density !== undefined ? { density: overrides.density } : {}),\n  };\n}\n\n/**\n * A fake OPEN share-token session. `{ travellerId: null }` produces a\n * family-token session; the default has a subject bound.\n */\nexport function mockShareSession(\n  overrides: Partial<Omit<MockShareSession, 'kind'>> = {},\n): MockShareSession {\n  return {\n    kind: 'shareToken',\n    token: overrides.token ?? nextSessionId('mock-share-token'),\n    tripRef: overrides.tripRef ?? nextSessionId('mock-trip'),\n    travellerId:\n      overrides.travellerId === undefined ? nextSessionId('mock-traveller') : overrides.travellerId,\n    expiresAt: overrides.expiresAt ?? DEFAULT_EXPIRES_AT,\n    ...(overrides.density !== undefined ? { density: overrides.density } : {}),\n  };\n}\n","// Bundled to the \"./testing\" export (02-architecture.md §1). Synthetic sync\n// events — fixture data for the shapes a component's offline/sync UI must\n// render (`14-testing-and-fixtures.md §1.3`). `07-offline-and-sync.md` is the\n// one home for the mechanics these fixtures exercise; this file only produces\n// data satisfying it and never restates the outbox/backoff/conflict rules.\n\n/** The six kinds `14-testing-and-fixtures.md §1.3` names — no seventh, no\n * collapsing two into one. */\nexport type MockSyncEventKind =\n  | 'enqueued'\n  | 'flushed'\n  | 'conflict'\n  | 'parked'\n  | 'reconnected'\n  | 'delta-applied';\n\n/** Write-ahead, before any network call (`07 §2`). */\nexport interface MockSyncEnqueuedEvent {\n  readonly kind: 'enqueued';\n  readonly opId: string;\n  readonly tripRef: string;\n  readonly entity: { readonly listName: string; readonly id: string };\n  readonly enqueuedAt: string;\n  /** The row painted immediately, ahead of any server confirmation. */\n  readonly optimistic: Record<string, unknown>;\n}\n\n/** An op reached a 2xx and drained (`07 §3`). */\nexport interface MockSyncFlushedEvent {\n  readonly kind: 'flushed';\n  readonly opId: string;\n  readonly tripRef: string;\n  readonly entity: { readonly listName: string; readonly id: string };\n  /** The rebased canonical row, carrying the server `version`. */\n  readonly applied: Record<string, unknown>;\n  readonly appliedAt: string;\n}\n\n/** `07 §6` — two conflict shapes normalise into one component. Every versioned\n * entity except the checklist-item toggle carries `currentVersion`; the\n * toggle's optimistic concurrency uses `expectedStatus`/`currentStatus`\n * instead (`07 §6`, `modules/checklists/FRD.md §4.3`). */\nexport type MockConflictResolutionShape =\n  | { readonly shape: 'version'; readonly currentVersion: number }\n  | { readonly shape: 'status'; readonly currentStatus: string };\n\n/** Carries BOTH the queued and current values the shared resolver UI needs\n * (`07 §6` steps 1–3) — never only one side. */\nexport interface MockSyncConflictEvent {\n  readonly kind: 'conflict';\n  readonly opId: string;\n  readonly tripRef: string;\n  readonly entity: { readonly listName: string; readonly id: string };\n  /** The locally intended change, as originally enqueued. */\n  readonly queued: Record<string, unknown>;\n  /** The fresh server row, re-read at its current version (`07 §6`'s \"why\n   * the entity is re-pulled first\"). */\n  readonly current: Record<string, unknown>;\n  readonly resolution: MockConflictResolutionShape;\n}\n\n/** A permanently non-retryable op — `423`/`410`/`402`/`UnsatisfiableScheme`\n * (`07 §10`). Never silently dropped; surfaced and left visibly stalled. */\nexport interface MockSyncParkedEvent {\n  readonly kind: 'parked';\n  readonly opId: string;\n  readonly tripRef: string;\n  readonly status: number;\n  /** A message fit to show a manager (mirrors `SyncErrorEvent.userMessage`\n   * in `kaafil-js`'s own event map). */\n  readonly userMessage: string;\n}\n\n/** Connectivity restored — the drainer fires opportunistically (`07 §3`). */\nexport interface MockSyncReconnectedEvent {\n  readonly kind: 'reconnected';\n  readonly at: string;\n}\n\n/** At-least-once redelivery (`07 §4`) — includes a row identical to one\n * already applied, so a component's idempotence against duplicate delivery is\n * directly testable rather than assumed. */\nexport interface MockSyncDeltaAppliedEvent {\n  readonly kind: 'delta-applied';\n  readonly tripRef: string;\n  readonly list: string;\n  readonly rows: readonly Record<string, unknown>[];\n  /** True on the row(s) that are a byte-for-byte redelivery of a row already\n   * merged on a prior pull — never a change, by construction of this fixture. */\n  readonly redeliveredIds: readonly string[];\n  /** The new cursor, from `meta.serverTime` (`07 §4`). */\n  readonly serverTime: string;\n}\n\nexport type MockSyncEvent =\n  | MockSyncEnqueuedEvent\n  | MockSyncFlushedEvent\n  | MockSyncConflictEvent\n  | MockSyncParkedEvent\n  | MockSyncReconnectedEvent\n  | MockSyncDeltaAppliedEvent;\n\nconst DEFAULT_SERVER_TIME = '2026-08-21T18:00:00.000Z';\n\nfunction defaultEntity(): { listName: string; id: string } {\n  return { listName: 'rooming', id: 'entity-1' };\n}\n\nexport function mockSyncEvent(\n  kind: 'enqueued',\n  overrides?: Partial<Omit<MockSyncEnqueuedEvent, 'kind'>>,\n): MockSyncEnqueuedEvent;\nexport function mockSyncEvent(\n  kind: 'flushed',\n  overrides?: Partial<Omit<MockSyncFlushedEvent, 'kind'>>,\n): MockSyncFlushedEvent;\nexport function mockSyncEvent(\n  kind: 'conflict',\n  overrides?: Partial<Omit<MockSyncConflictEvent, 'kind'>>,\n): MockSyncConflictEvent;\nexport function mockSyncEvent(\n  kind: 'parked',\n  overrides?: Partial<Omit<MockSyncParkedEvent, 'kind'>>,\n): MockSyncParkedEvent;\nexport function mockSyncEvent(\n  kind: 'reconnected',\n  overrides?: Partial<Omit<MockSyncReconnectedEvent, 'kind'>>,\n): MockSyncReconnectedEvent;\nexport function mockSyncEvent(\n  kind: 'delta-applied',\n  overrides?: Partial<Omit<MockSyncDeltaAppliedEvent, 'kind'>>,\n): MockSyncDeltaAppliedEvent;\nexport function mockSyncEvent(\n  kind: MockSyncEventKind,\n  overrides: Record<string, unknown> = {},\n): MockSyncEvent {\n  switch (kind) {\n    case 'enqueued':\n      return {\n        kind: 'enqueued',\n        opId: 'op-1',\n        tripRef: 'TRIP-001',\n        entity: defaultEntity(),\n        enqueuedAt: DEFAULT_SERVER_TIME,\n        optimistic: {},\n        ...overrides,\n      } as MockSyncEnqueuedEvent;\n    case 'flushed':\n      return {\n        kind: 'flushed',\n        opId: 'op-1',\n        tripRef: 'TRIP-001',\n        entity: defaultEntity(),\n        applied: {},\n        appliedAt: DEFAULT_SERVER_TIME,\n        ...overrides,\n      } as MockSyncFlushedEvent;\n    case 'conflict':\n      return {\n        kind: 'conflict',\n        opId: 'op-1',\n        tripRef: 'TRIP-001',\n        entity: defaultEntity(),\n        queued: { roomId: 'room-a' },\n        current: { roomId: 'room-b' },\n        resolution: { shape: 'version', currentVersion: 3 },\n        ...overrides,\n      } as MockSyncConflictEvent;\n    case 'parked':\n      return {\n        kind: 'parked',\n        opId: 'op-1',\n        tripRef: 'TRIP-001',\n        status: 423,\n        userMessage: 'This trip has been closed out and can no longer be edited.',\n        ...overrides,\n      } as MockSyncParkedEvent;\n    case 'reconnected':\n      return {\n        kind: 'reconnected',\n        at: DEFAULT_SERVER_TIME,\n        ...overrides,\n      } as MockSyncReconnectedEvent;\n    case 'delta-applied':\n      return {\n        kind: 'delta-applied',\n        tripRef: 'TRIP-001',\n        list: 'rooming',\n        rows: [\n          { id: 'row-1', roomId: 'room-a' },\n          // A byte-for-byte redelivery of `row-1` — same id, same fields —\n          // exercising `07 §4`'s \"applying the same row twice must be a no-op\".\n          { id: 'row-1', roomId: 'room-a' },\n        ],\n        redeliveredIds: ['row-1'],\n        serverTime: DEFAULT_SERVER_TIME,\n        ...overrides,\n      } as MockSyncDeltaAppliedEvent;\n  }\n}\n"]}

package/dist/tokenStyle-CToG5oOS.d.cts

@@ -0,0 +1,3 @@
+type KaafilTokenOverrides = Readonly<Partial<Record<`--kf-${string}`, string | number>>>;
+
+export type { KaafilTokenOverrides as K };

package/dist/tokenStyle-CToG5oOS.d.ts

@@ -0,0 +1,3 @@
+type KaafilTokenOverrides = Readonly<Partial<Record<`--kf-${string}`, string | number>>>;
+
+export type { KaafilTokenOverrides as K };