@logixjs/query 0.0.1

package/dist/Query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Query.ts","../src/internal/logics/auto-trigger.ts","../src/Engine.ts","../src/internal/middleware/middleware.ts","../src/internal/logics/invalidate.ts","../src/Traits.ts"],"sourcesContent":["import * as Logix from '@logixjs/core'\nimport { Effect, Schema } from 'effect'\nimport { autoTrigger } from './internal/logics/auto-trigger.js'\nimport { invalidate } from './internal/logics/invalidate.js'\nimport type { InvalidateRequest } from './Engine.js'\nimport { toStateTraitSpec, type QueryBuilder, type QuerySourceConfig, type QueryResourceData, type QueryResourceError } from './Traits.js'\n\ntype AnyQuerySourceConfig<TParams, TUI> = QuerySourceConfig<TParams, TUI, any, any>\n\ntype EnsureQueries<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>>\n  ? {}\n  : {\n      readonly __queries_must_be_QuerySourceConfig__: never\n    }\n\ntype QueriesOf<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> ? TQueries : never\n\nexport type QueryState<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly params: TParams\n  readonly ui: TUI\n  readonly queries: {\n    readonly [K in keyof TQueries]: Logix.Resource.ResourceSnapshot<\n      QueryResourceData<TQueries[K]['resource']>,\n      QueryResourceError<TQueries[K]['resource']>\n    >\n  }\n}\n\nexport type QueryName<TQueries extends Record<string, any>> = Extract<keyof TQueries, string>\n\ntype ForbiddenQueryName = 'params' | 'ui' | 'queries'\ntype ForbidQueryNames = {\n  readonly [K in ForbiddenQueryName]?: never\n}\n\nexport type QueryActions<TParams, TUI = unknown, TQueries extends Record<string, any> = {}> = {\n  readonly setParams: Schema.Schema<TParams, any>\n  readonly setUi: Schema.Schema<TUI, any>\n  readonly refresh: Schema.Schema<QueryName<TQueries> | undefined, any>\n  readonly invalidate: Schema.Schema<InvalidateRequest, any>\n}\n\nexport type QueryShape<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>, any>, QueryActions<TParams, TUI, TQueries>>\n\nexport type QueryAction<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.ActionOf<QueryShape<TParams, TUI, TQueries>>\n\nexport interface QueryMakeConfig<\n  TParams,\n  TUI = unknown,\n  TQueries = {},\n> {\n  readonly params: Schema.Schema<TParams, any>\n  readonly initialParams: TParams\n  readonly ui?: TUI\n  readonly queries?: (q: QueryBuilder<TParams, TUI>) => TQueries & ForbidQueryNames\n  readonly traits?: unknown\n}\n\nexport interface QueryController<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> {\n  readonly runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>\n  readonly getState: Effect.Effect<QueryState<TParams, TUI, TQueries>>\n  readonly dispatch: (action: QueryAction<TParams, TUI, TQueries>) => Effect.Effect<void>\n\n  readonly controller: {\n    readonly setParams: (params: TParams) => Effect.Effect<void>\n    readonly setUi: (ui: TUI) => Effect.Effect<void>\n    readonly refresh: (target?: QueryName<TQueries>) => Effect.Effect<void>\n    readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void>\n  }\n}\n\nexport type QueryModuleController<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly make: (\n    runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>,\n  ) => QueryController<TParams, TUI, TQueries>\n}\n\nexport type QueryHandleExt<\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = {\n  readonly controller: QueryController<TParams, TUI, TQueries>['controller']\n}\n\nexport type QueryModule<\n  Id extends string,\n  TParams,\n  TUI = unknown,\n  TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {},\n> = Logix.Module.Module<Id, QueryShape<TParams, TUI, TQueries>, QueryHandleExt<TParams, TUI, TQueries>, any> & {\n  readonly controller: QueryModuleController<TParams, TUI, TQueries>\n}\n\nconst InvalidateRequestSchema = Schema.Union(\n  Schema.Struct({\n    kind: Schema.Literal('byResource'),\n    resourceId: Schema.String,\n  }),\n  Schema.Struct({\n    kind: Schema.Literal('byParams'),\n    resourceId: Schema.String,\n    keyHash: Schema.String,\n  }),\n  Schema.Struct({\n    kind: Schema.Literal('byTag'),\n    tag: Schema.String,\n  }),\n) as Schema.Schema<InvalidateRequest, any>\n\nconst assertQueryName = (name: string): void => {\n  if (!name) {\n    throw new Error(`[Query.make] query name must be non-empty`)\n  }\n  if (name.includes('.')) {\n    throw new Error(`[Query.make] query name must not include \".\"; got \"${name}\"`)\n  }\n  if (name === 'params' || name === 'ui' || name === 'queries') {\n    throw new Error(`[Query.make] query name \"${name}\" is reserved`)\n  }\n}\n\nexport const make = <\n  Id extends string,\n  TParams,\n  TUI = unknown,\n  const TQueries = {},\n>(\n  id: Id,\n  config: QueryMakeConfig<TParams, TUI, TQueries> & EnsureQueries<TParams, TUI, TQueries>,\n): QueryModule<Id, TParams, TUI, QueriesOf<TParams, TUI, TQueries>> => {\n  type Queries = QueriesOf<TParams, TUI, TQueries>\n  const queryBuilder: QueryBuilder<TParams, TUI> = {\n    source: (q: any) => q,\n  }\n\n\t  const queries = ((): Queries => {\n\t    const raw = config.queries\n\t    if (!raw) return {} as Queries\n\t    return raw(queryBuilder) as Queries\n\t  })()\n\n  const queriesForTraits: Readonly<Record<string, AnyQuerySourceConfig<TParams, TUI>>> = queries\n  for (const name of Object.keys(queries)) {\n    assertQueryName(name)\n  }\n\n\t  const RefreshTargetSchema = (() => {\n\t    const names = Object.keys(queries) as Array<QueryName<Queries>>\n\t    if (names.length === 0) return Schema.Never as unknown as Schema.Schema<QueryName<Queries>, any>\n\t    if (names.length === 1) {\n\t      return Schema.Literal(names[0] as any) as unknown as Schema.Schema<QueryName<Queries>, any>\n\t    }\n    const asUnionMembers = <A>(items: ReadonlyArray<A>): readonly [A, A, ...Array<A>] => {\n      if (items.length < 2) {\n        throw new Error(`[Query.make] internal error: expected at least 2 query names for union`)\n      }\n      return items as unknown as readonly [A, A, ...Array<A>]\n    }\n\n\t    const members = names.map((n) => Schema.Literal(n as any))\n\t    return Schema.Union(...asUnionMembers(members)) as unknown as Schema.Schema<QueryName<Queries>, any>\n\t  })()\n\n  const UiSchema = Schema.Unknown as Schema.Schema<TUI, any>\n\n\t  const QueriesSchema = Schema.Struct(\n\t    Object.fromEntries((Object.keys(queries) as Array<keyof Queries>).map((k) => [k, Schema.Unknown])) as Record<\n\t      string,\n\t      Schema.Schema<any, any>\n\t    >,\n\t  )\n\n  const StateSchema = Schema.Struct({\n    params: config.params,\n    ui: UiSchema,\n    queries: QueriesSchema,\n  }) as unknown as Schema.Schema<QueryState<TParams, TUI, Queries>, any>\n\n  const Actions = {\n    setParams: config.params,\n    setUi: UiSchema,\n    refresh: Schema.UndefinedOr(RefreshTargetSchema),\n    invalidate: InvalidateRequestSchema,\n  } satisfies QueryActions<TParams, TUI, Queries>\n\n  type Reducers = Logix.ReducersFromMap<typeof StateSchema, typeof Actions>\n\n  const reducers: Reducers = {\n    setParams: (state, action, sink) => {\n      sink?.('params')\n      return { ...state, params: action.payload ?? state.params }\n    },\n    setUi: (state, action, sink) => {\n      sink?.('ui')\n      return { ...state, ui: action.payload ?? state.ui }\n    },\n    refresh: (state) => state,\n    invalidate: (state) => state,\n  } satisfies Reducers\n\n  const queryTraits =\n    Object.keys(queriesForTraits).length > 0 ? toStateTraitSpec<TParams, TUI>({ queries: queriesForTraits }) : undefined\n\n  const traits =\n    queryTraits || config.traits\n      ? ({\n          ...(queryTraits as any),\n          ...(config.traits as any),\n        } as any)\n      : undefined\n\n  const module = Logix.Module.make(id, {\n    state: StateSchema,\n    actions: Actions,\n    reducers,\n    traits,\n  })\n\n  const logics = [\n    autoTrigger<any, TParams, TUI>(module.tag as any, { queries: queriesForTraits }),\n    invalidate<any, TParams, TUI>(module.tag as any, { queries: queriesForTraits }),\n  ] satisfies ReadonlyArray<Logix.ModuleLogic<any, any, any>>\n\n  const initial = (params?: TParams): QueryState<TParams, TUI, Queries> =>\n    ({\n      params: params ?? config.initialParams,\n      ui: (config.ui ?? ({} as unknown as TUI)) as TUI,\n      queries: Object.fromEntries(\n        (Object.keys(queries) as Array<keyof Queries>).map((k) => [k, Logix.Resource.Snapshot.idle()]),\n      ),\n    }) as QueryState<TParams, TUI, Queries>\n\n\t  const controller: QueryModuleController<TParams, TUI, Queries> = {\n\t    make: (\n\t      runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, Queries>, QueryAction<TParams, TUI, Queries>>,\n\t    ): QueryController<TParams, TUI, Queries> => {\n\t      const dispatch = runtime.dispatch\n\t      const actions = module.actions as unknown as {\n\t        readonly setParams: (params: TParams) => QueryAction<TParams, TUI, Queries>\n\t        readonly setUi: (ui: TUI) => QueryAction<TParams, TUI, Queries>\n\t        readonly refresh: (target: QueryName<Queries> | undefined) => QueryAction<TParams, TUI, Queries>\n\t        readonly invalidate: (request: InvalidateRequest) => QueryAction<TParams, TUI, Queries>\n\t      }\n\t\t      return {\n\t\t        runtime,\n\t\t        getState: runtime.getState as Effect.Effect<QueryState<TParams, TUI, Queries>>,\n\t\t        dispatch,\n\t        controller: {\n\t          setParams: (params: TParams) => dispatch(actions.setParams(params)),\n\t          setUi: (ui: TUI) => dispatch(actions.setUi(ui)),\n\t          refresh: (target?: QueryName<Queries>) => dispatch(actions.refresh(target)),\n\t\t          invalidate: (request: InvalidateRequest) => dispatch(actions.invalidate(request)),\n\t\t        },\n\t\t      } as QueryController<TParams, TUI, Queries>\n\t\t    },\n\t\t  }\n\n  ;(module as any).controller = controller\n\n  const EXTEND_HANDLE = Symbol.for('logix.module.handle.extend')\n  ;(module.tag as any)[EXTEND_HANDLE] = (\n    runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, Queries>, QueryAction<TParams, TUI, Queries>>,\n    base: Logix.ModuleHandle<any>,\n  ) => {\n    const c = controller.make(runtime)\n    return {\n      ...base,\n      controller: c.controller,\n    }\n  }\n\n  return module.implement({\n    initial: initial(),\n    logics: [...logics],\n  }) as unknown as QueryModule<Id, TParams, TUI, Queries>\n}\n","import * as Logix from '@logixjs/core'\nimport { Duration, Effect, Fiber } from 'effect'\nimport type { QuerySourceConfig, QueryTrigger } from '../../Traits.js'\nimport { Engine } from '../../Engine.js'\n\nconst defaultTriggers = ['onMount', 'onKeyChange'] as const\n\nconst getTriggers = (triggers: ReadonlyArray<QueryTrigger> | undefined): ReadonlyArray<QueryTrigger> =>\n  triggers ?? defaultTriggers\n\nconst isManualOnly = (triggers: ReadonlyArray<QueryTrigger>): boolean =>\n  triggers.length === 1 && triggers[0] === 'manual'\n\nconst getSnapshotKeyHash = (snapshot: unknown): string | undefined => {\n  if (!snapshot || typeof snapshot !== 'object') return undefined\n  const keyHash = (snapshot as any).keyHash\n  return typeof keyHash === 'string' ? keyHash : undefined\n}\n\nconst getSnapshotStatus = (snapshot: unknown): string | undefined => {\n  if (!snapshot || typeof snapshot !== 'object') return undefined\n  const status = (snapshot as any).status\n  return typeof status === 'string' ? status : undefined\n}\n\nexport interface AutoTriggerLogicConfig<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>\n}\n\n/**\n * Query auto-trigger logic:\n * - onMount: triggers once on initialization (if the key is valid and current snapshot does not match the same keyHash).\n * - onKeyChange: triggers after params/ui state changes (can debounce; only when keyHash changes or current is idle).\n * - manual-only: when triggers=[\"manual\"], disable onMount/onKeyChange auto triggering.\n */\nexport const autoTrigger = <Sh extends Logix.AnyModuleShape, TParams, TUI>(\n  module: Logix.ModuleTagType<any, Sh>,\n  config: AutoTriggerLogicConfig<TParams, TUI>,\n): Logix.ModuleLogic<Sh, any, never> =>\n  module.logic(($) => {\n    type _State = Logix.StateOf<Sh> & { readonly queries: Record<string, unknown> }\n    type QueryName = Extract<keyof typeof config.queries, string>\n\n    const pending = new Map<string, Fiber.RuntimeFiber<void, any>>()\n    const lastKeyHash = new Map<string, string | undefined>()\n\n    const hydrateFromFreshCache = (\n      name: QueryName,\n      q: QuerySourceConfig<TParams, TUI>,\n      keyHash: string,\n    ): Effect.Effect<boolean, never, any> =>\n      Effect.gen(function* () {\n        const engineOpt = yield* Effect.serviceOption(Engine)\n        if (engineOpt._tag === 'None') return false\n\n        const engine = engineOpt.value\n        if (!engine.peekFresh) return false\n\n        const dataOpt = yield* engine.peekFresh({\n          resourceId: q.resource.id,\n          keyHash,\n        })\n        if (dataOpt._tag === 'None') return false\n\n        const snapshot = Logix.Resource.Snapshot.success({\n          keyHash,\n          data: dataOpt.value,\n        })\n        yield* $.state.mutate((draft) => {\n          ;(draft as Logix.Logic.Draft<_State>).queries[name] = snapshot\n        })\n\n        return true\n      })\n\n    const cancelPending = (name: string): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        const prev = pending.get(name)\n        if (!prev) return\n        pending.delete(name)\n        yield* Fiber.interruptFork(prev)\n      })\n\n    const sourcePathOf = (name: QueryName): string => `queries.${name}`\n\n    const refresh = (name: QueryName, options?: { readonly force?: boolean }): Effect.Effect<void, never, any> =>\n      $.traits.source.refresh(sourcePathOf(name) as any, options as any) as Effect.Effect<void, never, any>\n\n    const scheduleDebounced = (name: QueryName, ms: number): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        yield* cancelPending(name)\n        const fiber = yield* Effect.forkScoped(\n          Effect.sleep(Duration.millis(ms)).pipe(\n            Effect.zipRight(refresh(name)),\n            Effect.ensuring(Effect.sync(() => pending.delete(name))),\n            Effect.catchAllCause(() => Effect.void),\n          ),\n        )\n        pending.set(name, fiber)\n      })\n\n    const computeKeyHash = (state: any, q: QuerySourceConfig<TParams, TUI>): string | undefined => {\n      const getAtPath = (root: any, path: string): unknown => {\n        const parts = path.split('.')\n        let cur = root\n        for (const p of parts) {\n          if (cur == null) return undefined\n          cur = cur[p]\n        }\n        return cur\n      }\n\n      try {\n        const keyState = { params: state.params as any, ui: state.ui as any } as any\n        const args = (q.deps as ReadonlyArray<string>).map((dep) => getAtPath(keyState, dep))\n        const key = (q.key as any)(...args)\n        if (key === undefined) return undefined\n        return Logix.Resource.keyHash(key)\n      } catch {\n        return undefined\n      }\n    }\n\n    const maybeAutoRefresh = (\n      phase: 'mount' | 'keyChange',\n      stateOverride?: unknown,\n    ): Effect.Effect<void, never, any> =>\n      Effect.gen(function* () {\n        const state = (stateOverride ?? (yield* $.state.read)) as any\n\n        for (const [name, q] of Object.entries(config.queries)) {\n          const queryName = name as QueryName\n          const triggers = getTriggers(q.triggers)\n          if (isManualOnly(triggers)) {\n            continue\n          }\n\n          if (phase === 'mount' && !triggers.includes('onMount')) {\n            continue\n          }\n\n          if (phase === 'keyChange' && !triggers.includes('onKeyChange')) {\n            continue\n          }\n\n          const keyHash = computeKeyHash(state, q)\n          const snapshot = state?.queries?.[queryName]\n          const snapshotKeyHash = getSnapshotKeyHash(snapshot)\n          const snapshotStatus = getSnapshotStatus(snapshot)\n\n          // Key is unavailable: do not refresh (idle reaping is guaranteed by kernel syncIdleInTransaction).\n          if (keyHash === undefined) {\n            lastKeyHash.set(queryName, undefined)\n            continue\n          }\n\n          // keyHash unchanged and we already have a non-idle snapshot: avoid re-entering loading (reuse existing result).\n          const last = lastKeyHash.get(queryName)\n          if (snapshotStatus && snapshotStatus !== 'idle' && snapshotKeyHash === keyHash && last === keyHash) {\n            continue\n          }\n\n          // If current snapshot is already success/error/loading with the same keyHash: update lastKeyHash and skip.\n          if (snapshotStatus && snapshotStatus !== 'idle' && snapshotKeyHash === keyHash) {\n            lastKeyHash.set(queryName, keyHash)\n            continue\n          }\n\n          lastKeyHash.set(queryName, keyHash)\n\n          // TanStack Query scenario: if we can hit the fresh cache, write a success snapshot directly,\n          // skipping source.refresh (avoids UI jitter and extra transactions like \"cache hit but still loading -> success\").\n          const hydrated = yield* hydrateFromFreshCache(queryName, q, keyHash)\n          if (hydrated) {\n            yield* cancelPending(queryName)\n            continue\n          }\n\n          const debounceMs = q.debounceMs ?? 0\n          if (phase === 'keyChange' && debounceMs > 0) {\n            yield* scheduleDebounced(queryName, debounceMs)\n          } else {\n            // mount / no debounce: trigger immediately\n            yield* cancelPending(queryName)\n            yield* refresh(queryName)\n          }\n        }\n      })\n\n    const refreshAll = (options?: { readonly force?: boolean }): Effect.Effect<void, never, any> =>\n      Effect.forEach(Object.keys(config.queries), (name) =>\n        cancelPending(name).pipe(Effect.zipRight(refresh(name as QueryName, options))),\n      ).pipe(Effect.asVoid)\n\n    const setup = $.lifecycle.onStart(maybeAutoRefresh('mount'))\n\n    const run = Effect.suspend(() =>\n      Effect.all(\n        [\n          // params/ui changes: handled by Query's default logic, avoiding scattered UI-side useEffect triggers.\n          $.onAction('setParams').runFork((action: any) =>\n            Effect.gen(function* () {\n              const state = (yield* $.state.read) as any\n              const next = { ...state, params: action.payload }\n              yield* maybeAutoRefresh('keyChange', next)\n            }),\n          ),\n          $.onAction('setUi').runFork((action: any) =>\n            Effect.gen(function* () {\n              const state = (yield* $.state.read) as any\n              const next = { ...state, ui: action.payload }\n              yield* maybeAutoRefresh('keyChange', next)\n            }),\n          ),\n\n          // Manual refresh: not restricted by triggers (manual-only still allows explicit refresh).\n          $.onAction('refresh').runFork((action: any) =>\n            Effect.gen(function* () {\n              const target = action.payload as QueryName | undefined\n              if (typeof target === 'string' && target.length > 0) {\n                yield* cancelPending(target)\n                yield* refresh(target, { force: true })\n              } else {\n                yield* refreshAll({ force: true })\n              }\n            }),\n          ),\n        ],\n        { concurrency: 'unbounded' },\n      ).pipe(Effect.asVoid),\n    )\n\n    return { setup, run }\n  }) as Logix.ModuleLogic<Sh, any, never>\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport { Context, Effect, Layer, Option } from 'effect'\nimport { middleware as middlewareImpl, type MiddlewareConfig } from './internal/middleware/middleware.js'\n\nexport type InvalidateRequest =\n  | { readonly kind: 'byResource'; readonly resourceId: string }\n  | { readonly kind: 'byParams'; readonly resourceId: string; readonly keyHash: string }\n  | { readonly kind: 'byTag'; readonly tag: string }\n\nexport interface Engine {\n  readonly fetch: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n    readonly effect: Effect.Effect<A, unknown, any>\n    /**\n     * MUST be serializable and slim; recommended default is undefined (lazy),\n     * and only populate it when diagnostics/devtools require it.\n     */\n    readonly meta?: unknown\n  }) => Effect.Effect<A, unknown, any>\n\n  /**\n   * perf: optional fast path to avoid allocations on the hot path.\n   * Semantics must match `fetch({ ... })`.\n   */\n  readonly fetchFast?: <A>(\n    resourceId: string,\n    keyHash: string,\n    effect: Effect.Effect<A, unknown, any>,\n    meta?: unknown,\n  ) => Effect.Effect<A, unknown, any>\n\n  readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void, unknown, any>\n\n  /**\n   * Read-only fast path: must not trigger IO; used to short-circuit to success before refresh,\n   * avoiding loading jitter.\n   */\n  readonly peekFresh?: <A>(args: {\n    readonly resourceId: string\n    readonly keyHash: string\n  }) => Effect.Effect<Option.Option<A>, never, any>\n}\n\nclass EngineTagImpl extends Context.Tag('@logixjs/query/Engine')<EngineTagImpl, Engine>() {}\n\nexport const Engine = Object.assign(EngineTagImpl, {\n  layer: (engine: Engine): Layer.Layer<EngineTagImpl, never, never> => Layer.succeed(EngineTagImpl, engine),\n  middleware: (config?: MiddlewareConfig): EffectOp.Middleware => middlewareImpl(config),\n})\n\nexport type { MiddlewareConfig }\n","import type * as EffectOp from '@logixjs/core/EffectOp'\nimport { Effect, Option } from 'effect'\nimport { Engine } from '../../Engine.js'\nimport type { Engine as EngineService } from '../../Engine.js'\n\nexport interface MiddlewareConfig {\n  /**\n   * Default: only applies to EffectOp that carries resourceId+keyHash (from StateTrait.source).\n   * Optional: further filter by resourceId.\n   */\n  readonly useFor?: (resourceId: string) => boolean\n}\n\n/**\n * Query middleware (EffectOp): external engine takeover point.\n * - Delegates ResourceSpec.load execution to Engine (cache / in-flight dedupe / invalidation, etc.)\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics\n */\nexport const middleware = (config?: MiddlewareConfig): EffectOp.Middleware =>\n  (() => {\n    // perf: within the same Runtime instance, Engine injection is stable.\n    // Cache it in the middleware closure to avoid a Context lookup on every fetch.\n    let cachedEngine: EngineService | undefined\n\n    return (op) => {\n      if ((op.kind !== 'service' && op.kind !== 'trait-source') || !op.meta?.resourceId || !op.meta.keyHash) {\n        return op.effect as any\n      }\n\n      const resourceId = op.meta.resourceId\n      if (config?.useFor && !config.useFor(resourceId)) {\n        return op.effect as any\n      }\n\n      const keyHash = op.meta.keyHash as string\n\n      if (cachedEngine) {\n        if (cachedEngine.fetchFast) {\n          return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n        }\n        return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n      }\n\n      return Effect.serviceOption(Engine).pipe(\n        Effect.flatMap((engineOpt) => {\n          if (Option.isNone(engineOpt)) {\n            return Effect.fail(\n              new Error(\n                `[Query.Engine.middleware] Missing Query.Engine in the Runtime scope; please provide Query.Engine.layer(Query.TanStack.engine(new QueryClient())) (recommended) or Query.Engine.layer(customEngine).`,\n              ),\n            )\n          }\n          cachedEngine = engineOpt.value\n          if (cachedEngine.fetchFast) {\n            return cachedEngine.fetchFast(resourceId, keyHash, op.effect as any)\n          }\n          return cachedEngine.fetch({ resourceId, keyHash, effect: op.effect as any })\n        }),\n      ) as any\n    }\n  })()\n","import * as Logix from '@logixjs/core'\nimport { Effect } from 'effect'\nimport { Engine, type InvalidateRequest } from '../../Engine.js'\nimport type { QuerySourceConfig } from '../../Traits.js'\n\nexport interface InvalidateLogicConfig<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>\n}\n\nconst toInvalidateTargets = <TParams, TUI>(\n  request: InvalidateRequest,\n  queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI>>>,\n): ReadonlyArray<{ readonly name: string; readonly resourceId: string }> => {\n  if (request.kind === 'byResource') {\n    return Object.entries(queries)\n      .filter(([, q]) => q.resource.id === request.resourceId)\n      .map(([name, q]) => ({ name, resourceId: q.resource.id }))\n  }\n\n  if (request.kind === 'byParams') {\n    return Object.entries(queries)\n      .filter(([, q]) => q.resource.id === request.resourceId)\n      .map(([name, q]) => ({ name, resourceId: q.resource.id }))\n  }\n\n  // byTag: prefer QuerySourceConfig.tags for static filtering; if tags are missing, conservatively fall back to refreshing all.\n  const entries = Object.entries(queries)\n  const tagged = entries.filter(([, q]) => Array.isArray(q.tags) && q.tags.includes(request.tag))\n  const selected = tagged.length > 0 ? tagged : entries\n  return selected.map(([name, q]) => ({ name, resourceId: q.resource.id }))\n}\n\nexport const invalidate = <Sh extends Logix.AnyModuleShape, TParams, TUI>(\n  module: Logix.ModuleTagType<any, Sh>,\n  config: InvalidateLogicConfig<TParams, TUI>,\n): Logix.ModuleLogic<Sh, any, never> =>\n  module.logic(($) =>\n    Effect.gen(function* () {\n      yield* $.onAction('invalidate').runFork((action: any) =>\n        Effect.gen(function* () {\n          const request = action.payload as InvalidateRequest\n\n          // 1) Eventize: goes into ReplayLog (kernel-owned).\n          yield* Logix.TraitLifecycle.scopedExecute($ as any, {\n            kind: 'query:invalidate',\n            request,\n          })\n\n          // 2) Call external engine (optional): does not block the fallback path.\n          const engineOpt = yield* Effect.serviceOption(Engine)\n          if (engineOpt._tag !== 'None') {\n            yield* engineOpt.value.invalidate(request)\n          }\n\n          // 3) Immediately refresh related sources (write-back gating is still guaranteed by kernel keyHash).\n          const targets = toInvalidateTargets<TParams, TUI>(request, config.queries)\n          const sourcePathOf = (name: string): string => `queries.${name}`\n          yield* Effect.forEach(\n            targets,\n            (t) =>\n              $.traits.source.refresh(sourcePathOf(t.name) as any, { force: true }) as Effect.Effect<void, never, any>,\n          ).pipe(Effect.asVoid)\n        }),\n      )\n    }),\n  ) as Logix.ModuleLogic<Sh, any, never>\n","import * as Logix from '@logixjs/core'\n\nexport type QueryTrigger = 'onMount' | 'onKeyChange' | 'manual'\n\nexport type QueryConcurrency = 'switch' | 'exhaust'\n\nexport type QueryResourceRef = { readonly id: string }\n\nexport type QueryResource = QueryResourceRef | Logix.Resource.ResourceSpec<any, any, any, any>\n\nexport type QueryResourceKey<R> = R extends Logix.Resource.ResourceSpec<infer Key, any, any, any> ? Key : unknown\n\nexport type QueryResourceData<R> = R extends Logix.Resource.ResourceSpec<any, infer Data, any, any> ? Data : unknown\n\nexport type QueryResourceError<R> = R extends Logix.Resource.ResourceSpec<any, any, infer Err, any> ? Err : unknown\n\nexport type QueryKeyState<TParams, TUI> = Readonly<{\n  readonly params: TParams\n  readonly ui: TUI\n}>\n\nexport type QueryDepsPath<TParams, TUI> = Logix.StateTrait.StateFieldPath<QueryKeyState<TParams, TUI>>\n\ntype DepsArgs<S extends object, Deps extends ReadonlyArray<string>> = {\n  readonly [K in keyof Deps]: Deps[K] extends Logix.StateTrait.StateFieldPath<S>\n    ? Logix.StateTrait.StateAtPath<S, Deps[K]>\n    : any\n}\n\ntype BivariantCallback<Args extends ReadonlyArray<any>, R> = {\n  bivarianceHack(...args: Args): R\n}['bivarianceHack']\n\nexport interface QuerySourceConfig<\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n> {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  /**\n   * Optional static tags for invalidate(byTag), used to narrow byTag from \"refresh all\" to a matched subset.\n   * - Must be serializable (recommend: string constants only)\n   * - If omitted, byTag conservatively falls back to refreshing everything\n   */\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: BivariantCallback<DepsArgs<QueryKeyState<TParams, TUI>, Deps>, QueryResourceKey<R> | undefined>\n}\n\nexport type QueryBuilder<TParams, TUI> = {\n  readonly source: <\n    R extends QueryResource,\n    const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n  >(config: {\n    readonly resource: R\n    readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n    readonly triggers?: ReadonlyArray<QueryTrigger>\n    readonly tags?: ReadonlyArray<string>\n    readonly debounceMs?: number\n    readonly concurrency?: QueryConcurrency\n    readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n  }) => QuerySourceConfig<TParams, TUI, R, Deps>\n}\n\n/**\n * Query.source:\n * - Strongly typed helper to preserve `deps` as a tuple and infer `key(...depsValues)` argument types from it.\n * - Recommended usage inside `Query.make(..., { queries: { name: Query.source({ ... }) } })`.\n */\nexport const source = <\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n>(config: {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n}): QuerySourceConfig<TParams, TUI, R, Deps> => config as QuerySourceConfig<TParams, TUI, R, Deps>\n\nexport interface QueryTraitsInput<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI, any>>>\n}\n\n/**\n * Lowering rules (Query -> StateTrait):\n * - Each Query rule maps to a `StateTrait.source`, writing back to `queries.<name>` (isomorphic to module state).\n * - keySelector computes key from `{ params; ui }`; keyHash/race gating is guaranteed by the kernel source runtime.\n *\n * Notes:\n * - deps uses module-root paths (e.g. \"params.q\" / \"ui.query.autoEnabled\"), aligned with the constraints in 007/004.\n * - concurrency \"exhaust\" is represented as \"exhaust-trailing\" in the kernel.\n */\nexport const toStateTraitSpec = <TParams, TUI>(\n  input: QueryTraitsInput<TParams, TUI>,\n): Logix.StateTrait.StateTraitSpec<any> => {\n  const out: Record<string, Logix.StateTrait.StateTraitEntry<any, any>> = {}\n\n  for (const [name, q] of Object.entries(input.queries)) {\n    const triggers = q.triggers ?? (['onMount', 'onKeyChange'] as const)\n\n    // \"manual\" must be exclusive to avoid ambiguous semantics (configuration error).\n    if (triggers.includes('manual') && triggers.length > 1) {\n      throw new Error(\n        `[Query.traits] \"manual\" must be exclusive, but got triggers=[${triggers.join(', ')}] for query \"${name}\".`,\n      )\n    }\n\n    out[`queries.${name}`] = Logix.StateTrait.source({\n      // deps: used for graph building/diagnostics/future reverse-closure; Query also reuses deps to converge triggers.\n      deps: q.deps as any,\n      resource: q.resource.id,\n      triggers,\n      debounceMs: q.debounceMs,\n      concurrency: q.concurrency === 'exhaust' ? 'exhaust-trailing' : q.concurrency,\n      key: (...depsValues: ReadonlyArray<any>) => (q.key as any)(...depsValues),\n    })\n  }\n\n  return out as Logix.StateTrait.StateTraitSpec<any>\n}\n"],"mappings":"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","names":["Logix","import_effect","import_effect","import_effect","module","Logix","import_effect","module","Logix","module"]}

package/dist/Query.d.cts

@@ -0,0 +1,61 @@
+import * as Logix from '@logixjs/core';
+import { Schema, Effect } from 'effect';
+import { InvalidateRequest } from './Engine.cjs';
+import { QuerySourceConfig, QueryResourceData, QueryResourceError, QueryBuilder } from './Traits.cjs';
+import '@logixjs/core/EffectOp';
+
+type AnyQuerySourceConfig<TParams, TUI> = QuerySourceConfig<TParams, TUI, any, any>;
+type EnsureQueries<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> ? {} : {
+    readonly __queries_must_be_QuerySourceConfig__: never;
+};
+type QueriesOf<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> ? TQueries : never;
+type QueryState<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = {
+    readonly params: TParams;
+    readonly ui: TUI;
+    readonly queries: {
+        readonly [K in keyof TQueries]: Logix.Resource.ResourceSnapshot<QueryResourceData<TQueries[K]['resource']>, QueryResourceError<TQueries[K]['resource']>>;
+    };
+};
+type QueryName<TQueries extends Record<string, any>> = Extract<keyof TQueries, string>;
+type ForbiddenQueryName = 'params' | 'ui' | 'queries';
+type ForbidQueryNames = {
+    readonly [K in ForbiddenQueryName]?: never;
+};
+type QueryActions<TParams, TUI = unknown, TQueries extends Record<string, any> = {}> = {
+    readonly setParams: Schema.Schema<TParams, any>;
+    readonly setUi: Schema.Schema<TUI, any>;
+    readonly refresh: Schema.Schema<QueryName<TQueries> | undefined, any>;
+    readonly invalidate: Schema.Schema<InvalidateRequest, any>;
+};
+type QueryShape<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>, any>, QueryActions<TParams, TUI, TQueries>>;
+type QueryAction<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.ActionOf<QueryShape<TParams, TUI, TQueries>>;
+interface QueryMakeConfig<TParams, TUI = unknown, TQueries = {}> {
+    readonly params: Schema.Schema<TParams, any>;
+    readonly initialParams: TParams;
+    readonly ui?: TUI;
+    readonly queries?: (q: QueryBuilder<TParams, TUI>) => TQueries & ForbidQueryNames;
+    readonly traits?: unknown;
+}
+interface QueryController<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> {
+    readonly runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>;
+    readonly getState: Effect.Effect<QueryState<TParams, TUI, TQueries>>;
+    readonly dispatch: (action: QueryAction<TParams, TUI, TQueries>) => Effect.Effect<void>;
+    readonly controller: {
+        readonly setParams: (params: TParams) => Effect.Effect<void>;
+        readonly setUi: (ui: TUI) => Effect.Effect<void>;
+        readonly refresh: (target?: QueryName<TQueries>) => Effect.Effect<void>;
+        readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void>;
+    };
+}
+type QueryModuleController<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = {
+    readonly make: (runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>) => QueryController<TParams, TUI, TQueries>;
+};
+type QueryHandleExt<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = {
+    readonly controller: QueryController<TParams, TUI, TQueries>['controller'];
+};
+type QueryModule<Id extends string, TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Module.Module<Id, QueryShape<TParams, TUI, TQueries>, QueryHandleExt<TParams, TUI, TQueries>, any> & {
+    readonly controller: QueryModuleController<TParams, TUI, TQueries>;
+};
+declare const make: <Id extends string, TParams, TUI = unknown, const TQueries = {}>(id: Id, config: QueryMakeConfig<TParams, TUI, TQueries> & EnsureQueries<TParams, TUI, TQueries>) => QueryModule<Id, TParams, TUI, QueriesOf<TParams, TUI, TQueries>>;
+
+export { type QueryAction, type QueryActions, type QueryController, type QueryHandleExt, type QueryMakeConfig, type QueryModule, type QueryModuleController, type QueryName, type QueryShape, type QueryState, make };

package/dist/Query.d.ts

@@ -0,0 +1,61 @@
+import * as Logix from '@logixjs/core';
+import { Schema, Effect } from 'effect';
+import { InvalidateRequest } from './Engine.js';
+import { QuerySourceConfig, QueryResourceData, QueryResourceError, QueryBuilder } from './Traits.js';
+import '@logixjs/core/EffectOp';
+
+type AnyQuerySourceConfig<TParams, TUI> = QuerySourceConfig<TParams, TUI, any, any>;
+type EnsureQueries<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> ? {} : {
+    readonly __queries_must_be_QuerySourceConfig__: never;
+};
+type QueriesOf<TParams, TUI, TQueries> = TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> ? TQueries : never;
+type QueryState<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = {
+    readonly params: TParams;
+    readonly ui: TUI;
+    readonly queries: {
+        readonly [K in keyof TQueries]: Logix.Resource.ResourceSnapshot<QueryResourceData<TQueries[K]['resource']>, QueryResourceError<TQueries[K]['resource']>>;
+    };
+};
+type QueryName<TQueries extends Record<string, any>> = Extract<keyof TQueries, string>;
+type ForbiddenQueryName = 'params' | 'ui' | 'queries';
+type ForbidQueryNames = {
+    readonly [K in ForbiddenQueryName]?: never;
+};
+type QueryActions<TParams, TUI = unknown, TQueries extends Record<string, any> = {}> = {
+    readonly setParams: Schema.Schema<TParams, any>;
+    readonly setUi: Schema.Schema<TUI, any>;
+    readonly refresh: Schema.Schema<QueryName<TQueries> | undefined, any>;
+    readonly invalidate: Schema.Schema<InvalidateRequest, any>;
+};
+type QueryShape<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Shape<Schema.Schema<QueryState<TParams, TUI, TQueries>, any>, QueryActions<TParams, TUI, TQueries>>;
+type QueryAction<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.ActionOf<QueryShape<TParams, TUI, TQueries>>;
+interface QueryMakeConfig<TParams, TUI = unknown, TQueries = {}> {
+    readonly params: Schema.Schema<TParams, any>;
+    readonly initialParams: TParams;
+    readonly ui?: TUI;
+    readonly queries?: (q: QueryBuilder<TParams, TUI>) => TQueries & ForbidQueryNames;
+    readonly traits?: unknown;
+}
+interface QueryController<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> {
+    readonly runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>;
+    readonly getState: Effect.Effect<QueryState<TParams, TUI, TQueries>>;
+    readonly dispatch: (action: QueryAction<TParams, TUI, TQueries>) => Effect.Effect<void>;
+    readonly controller: {
+        readonly setParams: (params: TParams) => Effect.Effect<void>;
+        readonly setUi: (ui: TUI) => Effect.Effect<void>;
+        readonly refresh: (target?: QueryName<TQueries>) => Effect.Effect<void>;
+        readonly invalidate: (request: InvalidateRequest) => Effect.Effect<void>;
+    };
+}
+type QueryModuleController<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = {
+    readonly make: (runtime: Logix.ModuleRuntime<QueryState<TParams, TUI, TQueries>, QueryAction<TParams, TUI, TQueries>>) => QueryController<TParams, TUI, TQueries>;
+};
+type QueryHandleExt<TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = {
+    readonly controller: QueryController<TParams, TUI, TQueries>['controller'];
+};
+type QueryModule<Id extends string, TParams, TUI = unknown, TQueries extends Record<string, AnyQuerySourceConfig<TParams, TUI>> = {}> = Logix.Module.Module<Id, QueryShape<TParams, TUI, TQueries>, QueryHandleExt<TParams, TUI, TQueries>, any> & {
+    readonly controller: QueryModuleController<TParams, TUI, TQueries>;
+};
+declare const make: <Id extends string, TParams, TUI = unknown, const TQueries = {}>(id: Id, config: QueryMakeConfig<TParams, TUI, TQueries> & EnsureQueries<TParams, TUI, TQueries>) => QueryModule<Id, TParams, TUI, QueriesOf<TParams, TUI, TQueries>>;
+
+export { type QueryAction, type QueryActions, type QueryController, type QueryHandleExt, type QueryMakeConfig, type QueryModule, type QueryModuleController, type QueryName, type QueryShape, type QueryState, make };

package/dist/Query.js

@@ -0,0 +1,10 @@
+import {
+  make
+} from "./chunk-NXFX6RIH.js";
+import "./chunk-THVAADR2.js";
+import "./chunk-V3F5KWNH.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  make
+};
+//# sourceMappingURL=Query.js.map

package/dist/Query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/TanStack-C3mxN6Aj.d.cts

@@ -0,0 +1,40 @@
+import { QueryClient, QueryObserver } from '@tanstack/query-core';
+import { Engine } from './Engine.cjs';
+import { Effect } from 'effect';
+
+interface TanStackEngineConfig {
+    /**
+     * The max number of entries per resourceId in the local fast cache.
+     * - Goal: prevent unbounded memory growth when the key space is unbounded.
+     * - Semantics: evicts oldest entries in insertion order (FIFO); cache misses fall back to re-loading.
+     * - Set to Infinity to disable the cap (not recommended for long-running processes).
+     */
+    readonly maxEntriesPerResource?: number;
+}
+/**
+ * TanStack engine：
+ * - Uses QueryClient for invalidation (easy integration with TanStack ecosystem).
+ * - fetch/peekFresh uses a slim in-memory cache to avoid frequently creating Query objects on the Logix runtime hot path.
+ * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics.
+ */
+declare const engine: (queryClient: QueryClient, config?: TanStackEngineConfig) => Engine;
+
+/**
+ * observe (subscribe within scope + cleanup):
+ * - For scenarios where you want "TanStack-like automatic tracking" of enabled/queryKey changes.
+ * - Provided as infrastructure; domain logic can choose to use it (no hard dependency).
+ */
+declare const observe: <TData = unknown>(params: {
+    readonly queryClient: QueryClient;
+    readonly options: ConstructorParameters<typeof QueryObserver<TData>>[1];
+    readonly onResult: (result: unknown) => void;
+}) => Effect.Effect<QueryObserver<TData>, never, any>;
+
+type TanStack_TanStackEngineConfig = TanStackEngineConfig;
+declare const TanStack_engine: typeof engine;
+declare const TanStack_observe: typeof observe;
+declare namespace TanStack {
+  export { type TanStack_TanStackEngineConfig as TanStackEngineConfig, TanStack_engine as engine, TanStack_observe as observe };
+}
+
+export { TanStack as T, type TanStackEngineConfig as a, engine as e, observe as o };

package/dist/TanStack-jQhqYG8i.d.ts

@@ -0,0 +1,40 @@
+import { QueryClient, QueryObserver } from '@tanstack/query-core';
+import { Engine } from './Engine.js';
+import { Effect } from 'effect';
+
+interface TanStackEngineConfig {
+    /**
+     * The max number of entries per resourceId in the local fast cache.
+     * - Goal: prevent unbounded memory growth when the key space is unbounded.
+     * - Semantics: evicts oldest entries in insertion order (FIFO); cache misses fall back to re-loading.
+     * - Set to Infinity to disable the cap (not recommended for long-running processes).
+     */
+    readonly maxEntriesPerResource?: number;
+}
+/**
+ * TanStack engine：
+ * - Uses QueryClient for invalidation (easy integration with TanStack ecosystem).
+ * - fetch/peekFresh uses a slim in-memory cache to avoid frequently creating Query objects on the Logix runtime hot path.
+ * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics.
+ */
+declare const engine: (queryClient: QueryClient, config?: TanStackEngineConfig) => Engine;
+
+/**
+ * observe (subscribe within scope + cleanup):
+ * - For scenarios where you want "TanStack-like automatic tracking" of enabled/queryKey changes.
+ * - Provided as infrastructure; domain logic can choose to use it (no hard dependency).
+ */
+declare const observe: <TData = unknown>(params: {
+    readonly queryClient: QueryClient;
+    readonly options: ConstructorParameters<typeof QueryObserver<TData>>[1];
+    readonly onResult: (result: unknown) => void;
+}) => Effect.Effect<QueryObserver<TData>, never, any>;
+
+type TanStack_TanStackEngineConfig = TanStackEngineConfig;
+declare const TanStack_engine: typeof engine;
+declare const TanStack_observe: typeof observe;
+declare namespace TanStack {
+  export { type TanStack_TanStackEngineConfig as TanStackEngineConfig, TanStack_engine as engine, TanStack_observe as observe };
+}
+
+export { TanStack as T, type TanStackEngineConfig as a, engine as e, observe as o };

package/dist/TanStack.cjs

@@ -0,0 +1,139 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/TanStack.ts
+var TanStack_exports = {};
+__export(TanStack_exports, {
+  engine: () => engine,
+  observe: () => observe
+});
+module.exports = __toCommonJS(TanStack_exports);
+
+// src/internal/engine/tanstack.ts
+var import_effect = require("effect");
+var makeQueryKey = (resourceId, keyHash) => [resourceId, keyHash];
+var engine = (queryClient, config) => {
+  const byResourceId = /* @__PURE__ */ new Map();
+  const maxEntriesPerResource = config?.maxEntriesPerResource ?? 2e3;
+  try {
+    const queryCache = queryClient.getQueryCache?.();
+    if (queryCache && typeof queryCache.clear === "function") {
+      const original = queryCache.clear.bind(queryCache);
+      queryCache.clear = () => {
+        byResourceId.clear();
+        return original();
+      };
+    }
+  } catch {
+  }
+  const ensureBucket = (resourceId) => {
+    let bucket = byResourceId.get(resourceId);
+    if (!bucket) {
+      bucket = /* @__PURE__ */ new Map();
+      byResourceId.set(resourceId, bucket);
+    }
+    return bucket;
+  };
+  const evictIfNeeded = (bucket) => {
+    if (maxEntriesPerResource === Infinity) return;
+    if (!Number.isFinite(maxEntriesPerResource) || maxEntriesPerResource <= 0) return;
+    while (bucket.size > maxEntriesPerResource) {
+      const firstKey = bucket.keys().next().value;
+      if (firstKey === void 0) return;
+      bucket.delete(firstKey);
+    }
+  };
+  const fetchFast = (resourceId, keyHash, effect) => import_effect.Effect.suspend(() => {
+    const hit = byResourceId.get(resourceId)?.get(keyHash);
+    if (hit !== void 0) {
+      return import_effect.Effect.succeed(hit);
+    }
+    return import_effect.Effect.map(effect, (out) => {
+      if (out !== void 0) {
+        const bucket = ensureBucket(resourceId);
+        bucket.set(keyHash, out);
+        evictIfNeeded(bucket);
+      }
+      return out;
+    });
+  });
+  return {
+    fetch: ({ resourceId, keyHash, effect }) => fetchFast(resourceId, keyHash, effect),
+    fetchFast,
+    invalidate: (request) => import_effect.Effect.gen(function* () {
+      yield* import_effect.Effect.sync(() => {
+        if (request.kind === "byParams") {
+          const bucket = byResourceId.get(request.resourceId);
+          if (!bucket) return;
+          bucket.delete(request.keyHash);
+          if (bucket.size === 0) {
+            byResourceId.delete(request.resourceId);
+          }
+          return;
+        }
+        if (request.kind === "byResource") {
+          byResourceId.delete(request.resourceId);
+          return;
+        }
+        byResourceId.clear();
+      });
+      yield* import_effect.Effect.tryPromise({
+        try: () => {
+          if (request.kind === "byResource") {
+            return queryClient.invalidateQueries({
+              queryKey: [request.resourceId]
+            });
+          }
+          if (request.kind === "byParams") {
+            return queryClient.invalidateQueries({
+              queryKey: makeQueryKey(request.resourceId, request.keyHash)
+            });
+          }
+          return queryClient.invalidateQueries({
+            predicate: (q) => {
+              const tags = q.meta?.tags;
+              return Array.isArray(tags) && tags.includes(request.tag);
+            }
+          });
+        },
+        catch: (e) => e
+      }).pipe(import_effect.Effect.asVoid);
+    }),
+    peekFresh: ({ resourceId, keyHash }) => import_effect.Effect.sync(() => {
+      const hit = byResourceId.get(resourceId)?.get(keyHash);
+      return hit === void 0 ? import_effect.Option.none() : import_effect.Option.some(hit);
+    })
+  };
+};
+
+// src/internal/tanstack/observer.ts
+var import_effect2 = require("effect");
+var import_query_core = require("@tanstack/query-core");
+var observe = (params) => import_effect2.Effect.gen(function* () {
+  const observer = new import_query_core.QueryObserver(params.queryClient, params.options);
+  const unsubscribe = observer.subscribe(params.onResult);
+  yield* import_effect2.Effect.addFinalizer(() => import_effect2.Effect.sync(() => unsubscribe()));
+  return observer;
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  engine,
+  observe
+});
+//# sourceMappingURL=TanStack.cjs.map

package/dist/TanStack.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/TanStack.ts","../src/internal/engine/tanstack.ts","../src/internal/tanstack/observer.ts"],"sourcesContent":["export * from './internal/engine/tanstack.js'\nexport * from './internal/tanstack/observer.js'\n","import { Effect, Option } from 'effect'\nimport type { QueryClient } from '@tanstack/query-core'\nimport type { Engine, InvalidateRequest } from '../../Engine.js'\n\nconst makeQueryKey = (resourceId: string, keyHash: string) => [resourceId, keyHash] as const\n\nexport interface TanStackEngineConfig {\n  /**\n   * The max number of entries per resourceId in the local fast cache.\n   * - Goal: prevent unbounded memory growth when the key space is unbounded.\n   * - Semantics: evicts oldest entries in insertion order (FIFO); cache misses fall back to re-loading.\n   * - Set to Infinity to disable the cap (not recommended for long-running processes).\n   */\n  readonly maxEntriesPerResource?: number\n}\n\n/**\n * TanStack engine：\n * - Uses QueryClient for invalidation (easy integration with TanStack ecosystem).\n * - fetch/peekFresh uses a slim in-memory cache to avoid frequently creating Query objects on the Logix runtime hot path.\n * - Still preserves Logix Runtime's keyHash gating and ResourceSnapshot source-of-truth semantics.\n */\nexport const engine = (queryClient: QueryClient, config?: TanStackEngineConfig): Engine => {\n  const byResourceId = new Map<string, Map<string, unknown>>()\n  const maxEntriesPerResource = config?.maxEntriesPerResource ?? 2000\n\n  // Align with external QueryClient.clear(): when QueryCache is cleared, clear the local fast cache as well.\n  try {\n    const queryCache: any = (queryClient as any).getQueryCache?.()\n    if (queryCache && typeof queryCache.clear === 'function') {\n      const original = queryCache.clear.bind(queryCache)\n      queryCache.clear = () => {\n        byResourceId.clear()\n        return original()\n      }\n    }\n  } catch {\n    // ignore\n  }\n\n  const ensureBucket = (resourceId: string): Map<string, unknown> => {\n    let bucket = byResourceId.get(resourceId)\n    if (!bucket) {\n      bucket = new Map<string, unknown>()\n      byResourceId.set(resourceId, bucket)\n    }\n    return bucket\n  }\n\n  const evictIfNeeded = (bucket: Map<string, unknown>): void => {\n    if (maxEntriesPerResource === Infinity) return\n    if (!Number.isFinite(maxEntriesPerResource) || maxEntriesPerResource <= 0) return\n    while (bucket.size > maxEntriesPerResource) {\n      const firstKey = bucket.keys().next().value as string | undefined\n      if (firstKey === undefined) return\n      bucket.delete(firstKey)\n    }\n  }\n\n  const fetchFast: Engine['fetchFast'] = (resourceId, keyHash, effect) =>\n    Effect.suspend(() => {\n      const hit = byResourceId.get(resourceId)?.get(keyHash)\n      if (hit !== undefined) {\n        return Effect.succeed(hit as any)\n      }\n\n      return Effect.map(effect, (out) => {\n        if (out !== undefined) {\n          const bucket = ensureBucket(resourceId)\n          bucket.set(keyHash, out)\n          evictIfNeeded(bucket)\n        }\n        return out as any\n      })\n    })\n\n  return {\n    fetch: ({ resourceId, keyHash, effect }) => fetchFast!(resourceId, keyHash, effect),\n\n    fetchFast,\n\n    invalidate: (request: InvalidateRequest) =>\n      Effect.gen(function* () {\n        yield* Effect.sync(() => {\n          if (request.kind === 'byParams') {\n            const bucket = byResourceId.get(request.resourceId)\n            if (!bucket) return\n            bucket.delete(request.keyHash)\n            if (bucket.size === 0) {\n              byResourceId.delete(request.resourceId)\n            }\n            return\n          }\n\n          if (request.kind === 'byResource') {\n            byResourceId.delete(request.resourceId)\n            return\n          }\n\n          // byTag: we currently lack a serializable tags mapping; conservatively clear all (explainable but coarse).\n          byResourceId.clear()\n        })\n\n        // Sync to QueryClient (if there are external observers/ecosystem consumers).\n        yield* Effect.tryPromise({\n          try: () => {\n            if (request.kind === 'byResource') {\n              return queryClient.invalidateQueries({\n                queryKey: [request.resourceId],\n              })\n            }\n\n            if (request.kind === 'byParams') {\n              return queryClient.invalidateQueries({\n                queryKey: makeQueryKey(request.resourceId, request.keyHash),\n              })\n            }\n\n            return queryClient.invalidateQueries({\n              predicate: (q) => {\n                const tags = (q.meta as any)?.tags\n                return Array.isArray(tags) && tags.includes(request.tag)\n              },\n            })\n          },\n          catch: (e) => e,\n        }).pipe(Effect.asVoid)\n      }),\n\n    peekFresh: <A>({ resourceId, keyHash }: { readonly resourceId: string; readonly keyHash: string }) =>\n      Effect.sync(() => {\n        const hit = byResourceId.get(resourceId)?.get(keyHash) as A | undefined\n        return hit === undefined ? Option.none<A>() : Option.some(hit)\n      }),\n  }\n}\n","import { Effect } from 'effect'\nimport type { QueryClient } from '@tanstack/query-core'\nimport { QueryObserver } from '@tanstack/query-core'\n\n/**\n * observe (subscribe within scope + cleanup):\n * - For scenarios where you want \"TanStack-like automatic tracking\" of enabled/queryKey changes.\n * - Provided as infrastructure; domain logic can choose to use it (no hard dependency).\n */\nexport const observe = <TData = unknown>(params: {\n  readonly queryClient: QueryClient\n  readonly options: ConstructorParameters<typeof QueryObserver<TData>>[1]\n  readonly onResult: (result: unknown) => void\n}): Effect.Effect<QueryObserver<TData>, never, any> =>\n  Effect.gen(function* () {\n    const observer = new QueryObserver<TData>(params.queryClient, params.options as any)\n    const unsubscribe = observer.subscribe(params.onResult as any)\n    yield* Effect.addFinalizer(() => Effect.sync(() => unsubscribe()))\n    return observer\n  })\n"],"mappings":"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","names":["import_effect"]}

package/dist/TanStack.d.cts

@@ -0,0 +1,5 @@
+export { a as TanStackEngineConfig, e as engine, o as observe } from './TanStack-C3mxN6Aj.cjs';
+import '@tanstack/query-core';
+import './Engine.cjs';
+import '@logixjs/core/EffectOp';
+import 'effect';

package/dist/TanStack.d.ts

@@ -0,0 +1,5 @@
+export { a as TanStackEngineConfig, e as engine, o as observe } from './TanStack-jQhqYG8i.js';
+import '@tanstack/query-core';
+import './Engine.js';
+import '@logixjs/core/EffectOp';
+import 'effect';

package/dist/TanStack.js

@@ -0,0 +1,10 @@
+import {
+  engine,
+  observe
+} from "./chunk-L745BR5P.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  engine,
+  observe
+};
+//# sourceMappingURL=TanStack.js.map

package/dist/TanStack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/Traits.cjs

@@ -0,0 +1,65 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/Traits.ts
+var Traits_exports = {};
+__export(Traits_exports, {
+  source: () => source,
+  toStateTraitSpec: () => toStateTraitSpec
+});
+module.exports = __toCommonJS(Traits_exports);
+var Logix = __toESM(require("@logixjs/core"), 1);
+var source = (config) => config;
+var toStateTraitSpec = (input) => {
+  const out = {};
+  for (const [name, q] of Object.entries(input.queries)) {
+    const triggers = q.triggers ?? ["onMount", "onKeyChange"];
+    if (triggers.includes("manual") && triggers.length > 1) {
+      throw new Error(
+        `[Query.traits] "manual" must be exclusive, but got triggers=[${triggers.join(", ")}] for query "${name}".`
+      );
+    }
+    out[`queries.${name}`] = Logix.StateTrait.source({
+      // deps: used for graph building/diagnostics/future reverse-closure; Query also reuses deps to converge triggers.
+      deps: q.deps,
+      resource: q.resource.id,
+      triggers,
+      debounceMs: q.debounceMs,
+      concurrency: q.concurrency === "exhaust" ? "exhaust-trailing" : q.concurrency,
+      key: (...depsValues) => q.key(...depsValues)
+    });
+  }
+  return out;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  source,
+  toStateTraitSpec
+});
+//# sourceMappingURL=Traits.cjs.map

package/dist/Traits.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Traits.ts"],"sourcesContent":["import * as Logix from '@logixjs/core'\n\nexport type QueryTrigger = 'onMount' | 'onKeyChange' | 'manual'\n\nexport type QueryConcurrency = 'switch' | 'exhaust'\n\nexport type QueryResourceRef = { readonly id: string }\n\nexport type QueryResource = QueryResourceRef | Logix.Resource.ResourceSpec<any, any, any, any>\n\nexport type QueryResourceKey<R> = R extends Logix.Resource.ResourceSpec<infer Key, any, any, any> ? Key : unknown\n\nexport type QueryResourceData<R> = R extends Logix.Resource.ResourceSpec<any, infer Data, any, any> ? Data : unknown\n\nexport type QueryResourceError<R> = R extends Logix.Resource.ResourceSpec<any, any, infer Err, any> ? Err : unknown\n\nexport type QueryKeyState<TParams, TUI> = Readonly<{\n  readonly params: TParams\n  readonly ui: TUI\n}>\n\nexport type QueryDepsPath<TParams, TUI> = Logix.StateTrait.StateFieldPath<QueryKeyState<TParams, TUI>>\n\ntype DepsArgs<S extends object, Deps extends ReadonlyArray<string>> = {\n  readonly [K in keyof Deps]: Deps[K] extends Logix.StateTrait.StateFieldPath<S>\n    ? Logix.StateTrait.StateAtPath<S, Deps[K]>\n    : any\n}\n\ntype BivariantCallback<Args extends ReadonlyArray<any>, R> = {\n  bivarianceHack(...args: Args): R\n}['bivarianceHack']\n\nexport interface QuerySourceConfig<\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n> {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  /**\n   * Optional static tags for invalidate(byTag), used to narrow byTag from \"refresh all\" to a matched subset.\n   * - Must be serializable (recommend: string constants only)\n   * - If omitted, byTag conservatively falls back to refreshing everything\n   */\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: BivariantCallback<DepsArgs<QueryKeyState<TParams, TUI>, Deps>, QueryResourceKey<R> | undefined>\n}\n\nexport type QueryBuilder<TParams, TUI> = {\n  readonly source: <\n    R extends QueryResource,\n    const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n  >(config: {\n    readonly resource: R\n    readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n    readonly triggers?: ReadonlyArray<QueryTrigger>\n    readonly tags?: ReadonlyArray<string>\n    readonly debounceMs?: number\n    readonly concurrency?: QueryConcurrency\n    readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n  }) => QuerySourceConfig<TParams, TUI, R, Deps>\n}\n\n/**\n * Query.source:\n * - Strongly typed helper to preserve `deps` as a tuple and infer `key(...depsValues)` argument types from it.\n * - Recommended usage inside `Query.make(..., { queries: { name: Query.source({ ... }) } })`.\n */\nexport const source = <\n  TParams,\n  TUI = unknown,\n  R extends QueryResource = QueryResource,\n  const Deps extends ReadonlyArray<string> = ReadonlyArray<QueryDepsPath<TParams, TUI>>,\n>(config: {\n  readonly resource: R\n  readonly deps: Deps & ReadonlyArray<QueryDepsPath<TParams, TUI>>\n  readonly triggers?: ReadonlyArray<QueryTrigger>\n  readonly tags?: ReadonlyArray<string>\n  readonly debounceMs?: number\n  readonly concurrency?: QueryConcurrency\n  readonly key: (...depsValues: DepsArgs<QueryKeyState<TParams, TUI>, Deps>) => QueryResourceKey<R> | undefined\n}): QuerySourceConfig<TParams, TUI, R, Deps> => config as QuerySourceConfig<TParams, TUI, R, Deps>\n\nexport interface QueryTraitsInput<TParams, TUI> {\n  readonly queries: Readonly<Record<string, QuerySourceConfig<TParams, TUI, any>>>\n}\n\n/**\n * Lowering rules (Query -> StateTrait):\n * - Each Query rule maps to a `StateTrait.source`, writing back to `queries.<name>` (isomorphic to module state).\n * - keySelector computes key from `{ params; ui }`; keyHash/race gating is guaranteed by the kernel source runtime.\n *\n * Notes:\n * - deps uses module-root paths (e.g. \"params.q\" / \"ui.query.autoEnabled\"), aligned with the constraints in 007/004.\n * - concurrency \"exhaust\" is represented as \"exhaust-trailing\" in the kernel.\n */\nexport const toStateTraitSpec = <TParams, TUI>(\n  input: QueryTraitsInput<TParams, TUI>,\n): Logix.StateTrait.StateTraitSpec<any> => {\n  const out: Record<string, Logix.StateTrait.StateTraitEntry<any, any>> = {}\n\n  for (const [name, q] of Object.entries(input.queries)) {\n    const triggers = q.triggers ?? (['onMount', 'onKeyChange'] as const)\n\n    // \"manual\" must be exclusive to avoid ambiguous semantics (configuration error).\n    if (triggers.includes('manual') && triggers.length > 1) {\n      throw new Error(\n        `[Query.traits] \"manual\" must be exclusive, but got triggers=[${triggers.join(', ')}] for query \"${name}\".`,\n      )\n    }\n\n    out[`queries.${name}`] = Logix.StateTrait.source({\n      // deps: used for graph building/diagnostics/future reverse-closure; Query also reuses deps to converge triggers.\n      deps: q.deps as any,\n      resource: q.resource.id,\n      triggers,\n      debounceMs: q.debounceMs,\n      concurrency: q.concurrency === 'exhaust' ? 'exhaust-trailing' : q.concurrency,\n      key: (...depsValues: ReadonlyArray<any>) => (q.key as any)(...depsValues),\n    })\n  }\n\n  return out as Logix.StateTrait.StateTraitSpec<any>\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAAuB;AAyEhB,IAAM,SAAS,CAKpB,WAQ8C;AAezC,IAAM,mBAAmB,CAC9B,UACyC;AACzC,QAAM,MAAkE,CAAC;AAEzE,aAAW,CAAC,MAAM,CAAC,KAAK,OAAO,QAAQ,MAAM,OAAO,GAAG;AACrD,UAAM,WAAW,EAAE,YAAa,CAAC,WAAW,aAAa;AAGzD,QAAI,SAAS,SAAS,QAAQ,KAAK,SAAS,SAAS,GAAG;AACtD,YAAM,IAAI;AAAA,QACR,gEAAgE,SAAS,KAAK,IAAI,CAAC,gBAAgB,IAAI;AAAA,MACzG;AAAA,IACF;AAEA,QAAI,WAAW,IAAI,EAAE,IAAU,iBAAW,OAAO;AAAA;AAAA,MAE/C,MAAM,EAAE;AAAA,MACR,UAAU,EAAE,SAAS;AAAA,MACrB;AAAA,MACA,YAAY,EAAE;AAAA,MACd,aAAa,EAAE,gBAAgB,YAAY,qBAAqB,EAAE;AAAA,MAClE,KAAK,IAAI,eAAoC,EAAE,IAAY,GAAG,UAAU;AAAA,IAC1E,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}