@picked/client 0.0.1-dev.1777938796953 → 0.0.1-dev.1778136207545

package/dist/types/entities/predicate/predicate.d.ts

@@ -1,5 +1,5 @@
-import { Store } from 'effector';
-import { StateSnapshot } from '../../utils/state-snaphot';
+import { EventCallable, Store } from 'effector';
+import { StateSnapshot } from '../../lifecycle/state-snapshot';
 import { Picked } from '../../picked';
 export type Predicate = (snapshot: StateSnapshot & {
     args: unknown[];
@@ -12,7 +12,10 @@ export interface PredicateIndexItem {
 declare const createPredicateIndexFactory: ({ client }: {
     client: Picked;
 }) => {
-    register: (name: string, predicate: Predicate) => void;
+    register: EventCallable<{
+        name: string;
+        predicate: Predicate;
+    }>;
     getByName: (name: string) => Store<Predicate | undefined>;
     listStore: Store<{
         name: string;
@@ -20,7 +23,25 @@ declare const createPredicateIndexFactory: ({ client }: {
     }[]>;
     getEvokablePredicate: (predicateName: string) => Store<() => ReturnType<Predicate>>;
 };
+/**
+ * Creates a predicate index with stores and registration logic.
+ *
+ * @template T - Factory parameter type.
+ * @param {T} params - Factory parameters including the client.
+ * @returns {ReturnType<typeof createPredicateIndexFactory>} The predicate index.
+ * @example
+ * const predicates = createPredicateIndex({ client })
+ */
 export declare function createPredicateIndex<T extends Parameters<typeof createPredicateIndexFactory>[0]>(params: T): ReturnType<typeof createPredicateIndexFactory>;
+/**
+ * Convenience helper that dispatches `predicates.register` with object-payload shape.
+ *
+ * @param {string} name - Predicate name.
+ * @param {Predicate} predicate - The predicate function.
+ * @param {PredicatesStore} predicates - The predicates index.
+ * @example
+ * setupPredicate('isAdmin', ({ user }) => user.isAdmin === true, predicatesIndex)
+ */
 export declare const setupPredicate: (name: string, predicate: Predicate, predicates: PredicatesStore) => void;
 export {};
 //# sourceMappingURL=predicate.d.ts.map

package/dist/types/entities/predicate/predicate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"predicate.d.ts","sourceRoot":"","sources":["../../../../src/entities/predicate/predicate.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8D,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAGjG,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,MAAM,MAAM,SAAS,GAAG,CACtB,QAAQ,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,KAE3C,OAAO,GACP,OAAO,CAAC,OAAO,CAAC,GAChB,MAAM,GACN,OAAO,CAAC,MAAM,CAAC,GACf,MAAM,EAAE,GACR,OAAO,CAAC,MAAM,EAAE,CAAC,GACjB,SAAS,CAAA;AAEb,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAErE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;CACrB;AAKD,QAAA,MAAM,2BAA2B,eAA8B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;qBAoBvD,MAAM,aAAa,SAAS,KAAG,IAAI;sBAiBlC,MAAM;;cAlCrB,MAAM;mBACD,SAAS;;0CAqCqB,MAAM,KAAG,KAAK,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;CAuCxF,CAAA;AAEF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC,CAAC,EAC9F,MAAM,EAAE,CAAC,GACR,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAEhD;AAED,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,WAAW,SAAS,EAAE,YAAY,eAAe,SAE7F,CAAA"}
+{"version":3,"file":"predicate.d.ts","sourceRoot":"","sources":["../../../../src/entities/predicate/predicate.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,OAAO,EAML,KAAK,aAAa,EAElB,KAAK,KAAK,EACX,MAAM,UAAU,CAAA;AAGjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,MAAM,MAAM,SAAS,GAAG,CACtB,QAAQ,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,KAE3C,OAAO,GACP,OAAO,CAAC,OAAO,CAAC,GAChB,MAAM,GACN,OAAO,CAAC,MAAM,CAAC,GACf,MAAM,EAAE,GACR,OAAO,CAAC,MAAM,EAAE,CAAC,GACjB,SAAS,CAAA;AAEb,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAErE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,SAAS,CAAA;CACrB;AAID,QAAA,MAAM,2BAA2B,eAA8B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;;cAwBzC,MAAM;mBAAa,SAAS;;sBAiCzC,MAAM;;cAtDrB,MAAM;mBACD,SAAS;;0CAiEqB,MAAM,KAAG,KAAK,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;CA0CxF,CAAA;AAEF;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC,CAAC,EAC9F,MAAM,EAAE,CAAC,GACR,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAEhD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,WAAW,SAAS,EAAE,YAAY,eAAe,SAE7F,CAAA"}

package/dist/types/entities/session/session.d.ts

@@ -0,0 +1,45 @@
+import { EventCallable, Store } from 'effector';
+/** Plain shape of a persisted session — id, optional isUser flag, optional identifiers map. */
+export interface Session {
+    id: string;
+    isUser?: boolean;
+    identifiers?: Record<string, string>;
+}
+/**
+ * Session entity exposing the reactive `Session` store and mutator events. Field reads
+ * derive from the store via `.map`, which is reference-equality memoised so per-field
+ * subscribers only re-emit when their slice actually changes.
+ *
+ * @example
+ * ```typescript
+ * const session = createSession()
+ * session.store.map((s) => s.id).watch((id) => console.log('Session id:', id))
+ * session.setIsUser(true)
+ * session.setIdentifier({ key: 'fp_id', value: 'abc' })
+ * ```
+ */
+export interface SessionEntity {
+    /** Reactive store of the full session. Hydrated synchronously from localStorage when available; otherwise minted fresh in memory. */
+    store: Store<Session>;
+    /** Event — sets the isUser flag. */
+    setIsUser: EventCallable<boolean>;
+    /** Event — adds or replaces an identifier in the identifiers map. */
+    setIdentifier: EventCallable<{
+        key: string;
+        value: string;
+    }>;
+    /** Event — removes an identifier from the identifiers map. */
+    removeIdentifier: EventCallable<string>;
+}
+/**
+ * Initialises a session entity. Always succeeds — persistence is gated internally on `supportsLocalStorage()`, so callers do not need to null-check the result.
+ *
+ * @returns {SessionEntity} A ready-to-use session entity.
+ * @example
+ * ```typescript
+ * const session = initialiseSession()
+ * console.log(session.store.getState().id)
+ * ```
+ */
+export declare function initialiseSession(): SessionEntity;
+//# sourceMappingURL=session.d.ts.map

package/dist/types/entities/session/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/entities/session/session.ts"],"names":[],"mappings":"AAAA,kMAAkM;AAClM,OAAO,EAAkC,KAAK,aAAa,EAAU,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAKjG,+FAA+F;AAC/F,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,qIAAqI;IACrI,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAErB,oCAAoC;IACpC,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACjC,qEAAqE;IACrE,aAAa,EAAE,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5D,8DAA8D;IAC9D,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACxC;AA+GD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD"}

package/dist/types/entities/step/step.d.ts

@@ -1,4 +1,5 @@
 import { Store } from 'effector';
+import { Content } from '../content/content';
 export type StepsStore = ReturnType<typeof createStepIndex>;
 export interface ExperienceStep {
     id: string;
@@ -6,6 +7,19 @@ export interface ExperienceStep {
     name: string;
     fieldKeys: string[];
     layoutName?: string | null;
+    /**
+     * Optional reference to a CMS Content record that supplies the step's layout data.
+     * The actual content is registered separately via `client.registerContent` and
+     * resolved at render time through `layoutContentStore` against the global content registry.
+     */
+    layoutContentId?: string | null;
+    /**
+     * Reactive store of the content record this step references. Composed at registration
+     * time against `client.contents.getById(layoutContentId)`. `null` when the step has no
+     * `layoutContentId`. Reads stay reactive — content registered after the step
+     * (or updated mid-session) flows through automatically.
+     */
+    layoutContentStore?: Store<Content | null> | null;
 }
 declare const createStepIndexFactory: () => {
     register: (step: ExperienceStep) => void;

package/dist/types/entities/step/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/entities/step/step.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAA2B,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAG9D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAI3D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAGD,QAAA,MAAM,sBAAsB;qBAuBF,cAAc,KAAG,IAAI;kBAkBxB,cAAc,CAAC,IAAI,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;oBAcjD,cAAc,CAAC,KAAK,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;;;;;CAa3E,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG,IAAI,CAE/F"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/entities/step/step.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAA2B,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAE9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAI3D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;CAClD;AAGD,QAAA,MAAM,sBAAsB;qBAuBF,cAAc,KAAG,IAAI;kBAkBxB,cAAc,CAAC,IAAI,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;oBAcjD,cAAc,CAAC,KAAK,CAAC,KAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;;;;;CAa3E,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG,IAAI,CAE/F"}

package/dist/types/exports.d.ts

@@ -7,11 +7,17 @@ export type * from './utils/storage';
 export { evaluateRuleLogic } from './utils/rules-logic';
 export { getPickedConfig } from './utils/picked-config';
 export { lazyComponent, isLazyLoader } from './entities/component/lazyComponent';
+export { createPluginEffect } from './entities/plugin/plugin';
 /**
- * Create a new Picked client instance and bind it to the window
+ * Creates a new Picked client instance and binds it to the window object.
  *
- * @param options - The client context options including organizationId and projectId
- * @returns The initialized Picked client instance
+ * @param {CreateClientOptions} options - The client context options including `organizationId` and `projectId`.
+ * @returns {Picked} The initialised Picked client instance.
+ * @example
+ * ```typescript
+ * const client = createClient({ organizationId: 'org-1', projectId: 'proj-1' })
+ * client.start()
+ * ```
  */
 export declare const createClient: (options: CreateClientOptions) => Picked;
 export type { LaunchExperienceOptions, OpenExperienceOptions, } from './entities/experience/experience';

package/dist/types/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/exports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,mBAAmB,iBAAiB,CAAA;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAEhF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,WAIxD,CAAA;AAED,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,kCAAkC,CAAA"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/exports.ts"],"names":[],"mappings":"AAAA,8IAA8I;AAC9I,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,mBAAmB,iBAAiB,CAAA;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAE7D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,mBAAmB,KAAG,MAI3D,CAAA;AAED,YAAY,EACV,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,kCAAkC,CAAA"}

package/dist/types/index.d.ts

@@ -1,7 +1,9 @@
+/** @file Top-level public entry point — re-exports the client class, public utilities, and entity types. */
 export * from './exports';
 export type * from './client';
 export type * from './entities/action/action';
 export type * from './entities/condition/condition';
+export type * from './entities/content/content';
 export type * from './entities/component/component';
 export type * from './entities/component/lazyComponent';
 export type * from './entities/experience-instance/experience-instance';
@@ -13,7 +15,7 @@ export type * from './entities/framework/framework';
 export type * from './entities/history/history';
 export type * from './entities/plugin/plugin';
 export type * from './entities/predicate/predicate';
-export type * from './utils/state-snaphot';
+export type * from './lifecycle/state-snapshot';
 export type * from './utils/events';
 export type * from './utils/search-params';
 export type * from './entities/response/response';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,oCAAoC,CAAA;AACvD,mBAAmB,oDAAoD,CAAA;AACvE,mBAAmB,kCAAkC,CAAA;AACrD,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,wBAAwB,CAAA;AAC3C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,8BAA8B,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,cAAc,WAAW,CAAA;AACzB,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,oCAAoC,CAAA;AACvD,mBAAmB,oDAAoD,CAAA;AACvE,mBAAmB,kCAAkC,CAAA;AACrD,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,wBAAwB,CAAA;AAC3C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,gCAAgC,CAAA;AACnD,mBAAmB,4BAA4B,CAAA;AAC/C,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,8BAA8B,CAAA;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA"}

package/dist/types/lifecycle/lifecycle.d.ts

@@ -0,0 +1,47 @@
+import { Effect, EventCallable, StoreWritable } from 'effector';
+import { Picked } from '../picked';
+import { LogicRule } from '../logic-engine';
+/** Discrete stages of the SDK lifecycle. */
+export type LifecycleStage = 'idle' | 'starting' | 'ready' | 'failed';
+/** A logic-engine gate rule, a literal boolean override, or `undefined` to indicate no gate is configured. */
+type GateConfig = LogicRule | boolean | undefined;
+/** Public effector units exposed by the lifecycle module. */
+interface Lifecycle {
+    /** Public trigger — fires the start chain. `await allSettled(start, { scope })` resolves once the chain has fully settled. */
+    start: EventCallable<void>;
+    /** Reactive store of the readiness flag. */
+    readyStore: StoreWritable<boolean>;
+    /** Reactive store of the precondition-gate result (`undefined` until `start` is fired). */
+    preconditionPassedStore: StoreWritable<boolean | undefined>;
+    /** Reactive store of the condition-gate result (`undefined` until `start` is fired). */
+    conditionPassedStore: StoreWritable<boolean | undefined>;
+    /** Reactive store of the current lifecycle stage. */
+    lifecycleStageStore: StoreWritable<LifecycleStage>;
+    /** Event — registers a plugin onStart hook effect. */
+    registerPluginStartHook: EventCallable<Effect<void, void, Error>>;
+    /** Event — sets the precondition gate rule (called once during construction). */
+    setPrecondition: EventCallable<GateConfig>;
+    /** Event — sets the condition gate rule (called once during construction). */
+    setCondition: EventCallable<GateConfig>;
+}
+/**
+ * Creates the lifecycle module for a Picked client. Owns the start chain as an effector
+ * event graph: `start` triggers a fan-out of effects (ping, plugin hooks, domInteractive)
+ * whose `.done` events drive the next phases via `sample`.
+ *
+ * @param {object} params - Factory params.
+ * @param {Picked} params.client - The Picked client instance.
+ * @returns {Lifecycle} The lifecycle module exposing public events and read-only reactive stores.
+ * @example
+ * ```typescript
+ * const lifecycle = createLifecycle({ client })
+ * lifecycle.setPrecondition(myRule)
+ * lifecycle.start()
+ * await allSettled(lifecycle.start, { scope })
+ * ```
+ */
+export declare function createLifecycle(params: {
+    client: Picked;
+}): Lifecycle;
+export {};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/types/lifecycle/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/lifecycle.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAOL,KAAK,MAAM,EACX,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAA;AAEjB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAOhD,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAA;AAErE,8GAA8G;AAC9G,KAAK,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;AAEjD,6DAA6D;AAC7D,UAAU,SAAS;IACjB,8HAA8H;IAC9H,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAA;IAE1B,4CAA4C;IAC5C,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAClC,2FAA2F;IAC3F,uBAAuB,EAAE,aAAa,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IAC3D,wFAAwF;IACxF,oBAAoB,EAAE,aAAa,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IACxD,qDAAqD;IACrD,mBAAmB,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAElD,sDAAsD;IACtD,uBAAuB,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAEjE,iFAAiF;IACjF,eAAe,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IAC1C,8EAA8E;IAC9E,YAAY,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CACxC;AAqOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAErE"}

package/dist/types/lifecycle/rules-logic.d.ts

@@ -0,0 +1,24 @@
+import { Effect } from 'effector';
+import { LogicObject, LogicRule } from '../logic-engine';
+import { Picked } from '../picked';
+/** Parameters for `evaluateRuleLogicFx` — the rule to evaluate and an optional context override. */
+export interface EvaluateRuleLogicParams {
+    rule: LogicRule;
+    context?: LogicObject;
+}
+/**
+ * Creates an effector effect that evaluates a json-logic rule against the client's reactive state. The effect uses `attach({ source })` so all reads are scope-aware and reactive — no `.getState()` calls.
+ *
+ * @param {object} params - Factory params.
+ * @param {Picked} params.client - The Picked client instance whose stores back the evaluation context.
+ * @returns {Effect<EvaluateRuleLogicParams, unknown, Error>} An effect that evaluates a rule and resolves to the result.
+ * @example
+ * ```typescript
+ * const evaluateRuleLogicFx = createEvaluateRuleLogicFx({ client })
+ * const result = await evaluateRuleLogicFx({ rule: someRule, context: { extra: 'data' } })
+ * ```
+ */
+export declare function createEvaluateRuleLogicFx(params: {
+    client: Picked;
+}): Effect<EvaluateRuleLogicParams, unknown, Error>;
+//# sourceMappingURL=rules-logic.d.ts.map

package/dist/types/lifecycle/rules-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-logic.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/rules-logic.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,KAAK,EAAgB,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC,oGAAoG;AACpG,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAuED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,MAAM,CAAC,uBAAuB,EAAE,OAAO,EAAE,KAAK,CAAC,CAElD"}

package/dist/types/lifecycle/state-snapshot.d.ts

@@ -0,0 +1,37 @@
+import { Store } from 'effector';
+import { Picked } from '../picked';
+import { Field, FieldValue } from '../entities/field/field';
+/** Immutable snapshot of the current client state, suitable for passing to user-supplied predicates, actions, and rule evaluators. */
+export interface StateSnapshot {
+    client: Picked;
+    location?: Window['location'];
+    document?: Window['document'];
+    sessionStorage?: Window['sessionStorage'];
+    localStorage?: Window['localStorage'];
+    responses: {
+        fieldKey: string;
+        value: FieldValue | undefined;
+    }[];
+    fields: Field[];
+}
+/**
+ * Creates a reactive store that always reflects the current client state — responses, fields, browser globals, and the client reference.
+ *
+ * Consumers reading the snapshot inside an effect should use `attach({ source: stateSnapshotStore })` rather than `.getState()` so reads remain scope-aware and reactive.
+ *
+ * @param {object} params - Factory params.
+ * @param {Picked} params.client - The Picked client instance to derive the snapshot from.
+ * @returns {Store<StateSnapshot>} A derived store of the current state snapshot.
+ * @example
+ * ```typescript
+ * const stateSnapshotStore = createStateSnapshotStore({ client })
+ * const evaluateFx = attach({
+ *   source: stateSnapshotStore,
+ *   effect: (snapshot, rule) => evaluate(snapshot, rule),
+ * })
+ * ```
+ */
+export declare function createStateSnapshotStore(params: {
+    client: Picked;
+}): Store<StateSnapshot>;
+//# sourceMappingURL=state-snapshot.d.ts.map

package/dist/types/lifecycle/state-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-snapshot.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/state-snapshot.ts"],"names":[],"mappings":"AAAA,gIAAgI;AAChI,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAE9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEhE,sIAAsI;AACtI,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;IACrC,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;KAC9B,EAAE,CAAA;IACH,MAAM,EAAE,KAAK,EAAE,CAAA;CAChB;AA0BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,aAAa,CAAC,CAEzF"}

package/dist/types/logic-engine.d.ts

@@ -4,7 +4,7 @@
  * For the original implementation, see https://github.com/jwadhams/json-logic-js.
  */
 export type SyncLogicValue = string | number | boolean | null | undefined | LogicArray | LogicObject;
-export type LogicValue = SyncLogicValue | (() => LogicValue) | (() => Promise<SyncLogicValue>) | Promise<SyncLogicValue>;
+export type LogicValue = SyncLogicValue | ((...args: unknown[]) => LogicValue) | ((...args: unknown[]) => Promise<SyncLogicValue>) | Promise<SyncLogicValue>;
 export interface LogicObject {
     [key: string]: LogicValue;
 }

package/dist/types/logic-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logic-engine.d.ts","sourceRoot":"","sources":["../../src/logic-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;AAEpG,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,CAAC,MAAM,UAAU,CAAC,GAClB,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,GAC/B,OAAO,CAAC,cAAc,CAAC,CAAA;AAE3B,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAC1B;AAED,KAAK,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;AAEnC,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,SAAS,GACT,SAAS,EAAE,GACX,cAAc,EAAE,CAAA;AAEpB,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,EAAE,CAAA;CACjD;AAED,MAAM,MAAM,YAAY,GACpB;IACE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAC1B,GACD,UAAU,CAAA;AAwSd;;;;;;;GAOG;AAEH,wBAAsB,KAAK,CACzB,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,EAC3C,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,UAAU,CAAC,CAmJrB"}
+{"version":3,"file":"logic-engine.d.ts","sourceRoot":"","sources":["../../src/logic-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;AAEpG,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,CAAC,GACpC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,GACjD,OAAO,CAAC,cAAc,CAAC,CAAA;AAE3B,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAC1B;AAED,KAAK,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;AAEnC,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,SAAS,GACT,SAAS,EAAE,GACX,cAAc,EAAE,CAAA;AAEpB,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,EAAE,CAAA;CACjD;AAED,MAAM,MAAM,YAAY,GACpB;IACE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAC1B,GACD,UAAU,CAAA;AAuSd;;;;;;;GAOG;AAEH,wBAAsB,KAAK,CACzB,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,EAC3C,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,UAAU,CAAC,CAmJrB"}