@prometheus-ags/entity-graph-solid 3.0.0-alpha.0 → 3.0.1

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# @prometheus-ags/entity-graph-solid
+
+## 3.0.0
+
+### Patch Changes
+
+- 30fc348: Require applications to supply one compatible entity-graph core instance across every stable framework binding, and verify the installed singleton through packed consumers.
+- Updated dependencies [30fc348]
+- Updated dependencies [7b64d76]
+  - @prometheus-ags/entity-graph-core@3.0.0
+
+## 3.0.0-rc.1
+
+### Patch Changes
+
+- Require applications to supply one compatible entity-graph core instance across every stable framework binding, and verify the installed singleton through packed consumers.
+  - @prometheus-ags/entity-graph-core@3.0.0-rc.1
+
+## 3.0.0
+
+### Major Changes
+
+- v3.0.0 — Universal Platform Evolution
+
+  Evolves the React-only entity graph into a cross-platform, multi-framework,
+  AI-native, local-first ecosystem.
+  - **Monorepo split (breaking, but consumer-safe):** the framework-agnostic core
+    is extracted into `@prometheus-ags/entity-graph-core` (zero React). The
+    published `@prometheus-ags/prometheus-entity-management` package is the React
+    binding over the vanilla core. Existing React hook names remain available,
+    while core-only imperative consumers migrate from `useGraphStore.getState()`
+    to `graphStore.getState()`; the deprecated core alias remains through the
+    next-major removal window.
+  - **New framework bindings:** `entity-graph-svelte` (Svelte 5 runes),
+    `entity-graph-solid`, `entity-graph-web-components` (Lit 3), `entity-graph-alpine`,
+    `entity-graph-htmx` (Node SSE fragment server).
+  - **Peer sync:** `entity-graph-sync` with a pluggable SyncProvider — Yjs (default)
+    and Loro (reusing the 2.2.0 merge seam).
+  - **AI-native:** `entity-graph-a2a` plus `a2ui-react` with official A2UI
+    v0.9.1 rendering and default-deny graph actions; legacy
+    EntityChat/Copilot/Stream/Diff/Approval APIs live under `./ag-ui`.
+  - **Codegen contract:** `entity-graph-sdl` (schema → validated IR).
+  - **Native (published outside npm):** `entity-graph-cli` + `entity-graph-mcp`
+    (Rust, via crates.io), `entity-graph-tauri` (Tauri v2 plugin), and
+    `entity_graph_flutter` (Riverpod 3, via pub.dev).
+
+  All integrations ship as optional peer dependencies; the core bundle stays
+  `zustand + immer`.
+
+### Patch Changes
+
+- Updated dependencies
+  - @prometheus-ags/entity-graph-core@3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Travis James / Prometheus AGS / KnowMe LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -8,7 +8,7 @@ SolidJS bindings for `@prometheus-ags/entity-graph-core` — fine-grained reacti
 Component (SolidJS)
   └─ createEntity / createEntityList  (this package, Layer 2)
        └─ core engine fetchEntity / fetchList  (entity-graph-core, Layer 1)
-            └─ useGraphStore (Zustand, Layer 0)
+            └─ graphStore (vanilla Zustand, Layer 0)
 ```
 
 Components access data only through `createEntity` / `createEntityList`. The store (Zustand) is the single source of truth; SolidJS signals mirror it for fine-grained reactivity.
@@ -19,6 +19,8 @@ Components access data only through `createEntity` / `createEntityList`. The sto
 pnpm add @prometheus-ags/entity-graph-solid @prometheus-ags/entity-graph-core solid-js
 ```
 
+`@prometheus-ags/entity-graph-core` is a required peer: install it explicitly so the application owns the one compatible graph instance. The Solid binding must not install a private core copy. See the [binding singleton contract](../../release/binding-singleton-contract.md).
+
 ## Quick Start
 
 ### 1. Configure the engine once at app boot
@@ -163,6 +165,10 @@ console.log(invoiceCount()); // reactive SolidJS signal
 
 Returns a fine-grained SolidJS accessor that updates when the selected graph slice changes.
 
+### `graphStore` and deprecated `useGraphStore`
+
+`graphStore` is the vanilla StoreApi re-exported from the application-owned core and is intended for framework internals, adapters, and imperative integration code. The same-named Solid `createGraphStore(selector)` above returns a reactive accessor; it does not create an independent normalized graph. `useGraphStore` remains a deprecated core StoreApi alias for alpha migration and is not a Solid primitive.
+
 ### `setupGraphProvider(opts?)`
 
 Configures the engine and attaches browser listeners. Call once at app startup. Returns a cleanup function.

package/dist/{index.js → index.cjs}

@@ -30,7 +30,7 @@ function createEntity(opts) {
     if (!id || !enabled) return null;
     const engineOpts = entityGraphCore.getEngineOptions();
     const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;
-    const graphState = entityGraphCore.useGraphStore.getState();
+    const graphState = entityGraphCore.graphStore.getState();
     const cachedEntityState = graphState.entityStates[`${type}:${id}`];
     const cachedEntity = graphState.readEntity(type, id);
     const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);
@@ -51,7 +51,7 @@ function createEntity(opts) {
       },
       { ...entityGraphCore.getEngineOptions(), defaultStaleTime: effectiveStaleTime }
     );
-    return entityGraphCore.useGraphStore.getState().readEntity(type, id);
+    return entityGraphCore.graphStore.getState().readEntity(type, id);
   });
   solidJs.createEffect(() => {
     const id = idAccessor();
@@ -59,14 +59,14 @@ function createEntity(opts) {
     const subKey = `${type}:${id}`;
     const token = entityGraphCore.registerSubscriber(subKey);
     const syncFromGraph = () => {
-      const s = entityGraphCore.useGraphStore.getState();
+      const s = entityGraphCore.graphStore.getState();
       const entity = s.readEntity(type, id);
       const entityState = s.entityStates[subKey] ?? entityGraphCore.EMPTY_ENTITY_STATE;
       setSnapshot("data", entity);
       setSnapshot("entityState", (prev) => ({ ...prev, ...entityState }));
     };
     syncFromGraph();
-    const unsub = entityGraphCore.useGraphStore.subscribe(
+    const unsub = entityGraphCore.graphStore.subscribe(
       (s) => ({
         entity: s.readEntity(type, id),
         entityState: s.entityStates[subKey] ?? entityGraphCore.EMPTY_ENTITY_STATE
@@ -86,7 +86,7 @@ function createEntity(opts) {
   const refetch = async () => {
     const id = idAccessor();
     if (!id) return;
-    entityGraphCore.useGraphStore.getState().setEntityStale(type, id, true);
+    entityGraphCore.graphStore.getState().setEntityStale(type, id, true);
     await entityGraphCore.fetchEntity(
       { type, id, fetch, normalize, idField, onSuccess, onError },
       entityGraphCore.getEngineOptions()
@@ -147,13 +147,13 @@ function createEntityList(opts) {
     listState: { ...entityGraphCore.EMPTY_LIST_STATE }
   });
   function resolveItems(key) {
-    const s = entityGraphCore.useGraphStore.getState();
+    const s = entityGraphCore.graphStore.getState();
     const list = s.lists[key];
     if (!list) return [];
     return list.ids.map((id) => s.readEntity(type, id)).filter((e) => e !== null);
   }
   async function doInitialFetch(key) {
-    const s = entityGraphCore.useGraphStore.getState();
+    const s = entityGraphCore.graphStore.getState();
     const listState = s.lists[key];
     const effectiveStaleTime = staleTime ?? entityGraphCore.getEngineOptions().defaultStaleTime;
     const age = Date.now() - (listState?.lastFetched ?? 0);
@@ -178,14 +178,14 @@ function createEntityList(opts) {
     const key = entityGraphCore.serializeKey(rawKey);
     const enabled = enabledAccessor ? enabledAccessor() : true;
     const syncFromGraph = () => {
-      const s = entityGraphCore.useGraphStore.getState();
+      const s = entityGraphCore.graphStore.getState();
       const listState = s.lists[key] ?? entityGraphCore.EMPTY_LIST_STATE;
       const items = resolveItems(key);
       setSlice("listState", (prev) => ({ ...prev, ...listState }));
       setSlice("items", items);
     };
     syncFromGraph();
-    const unsub = entityGraphCore.useGraphStore.subscribe(
+    const unsub = entityGraphCore.graphStore.subscribe(
       (s) => {
         const listState = s.lists[key] ?? entityGraphCore.EMPTY_LIST_STATE;
         const entityBucket = s.entities[type];
@@ -207,7 +207,7 @@ function createEntityList(opts) {
   });
   async function fetchNextPage() {
     const key = entityGraphCore.serializeKey(queryKeyAccessor());
-    const s = entityGraphCore.useGraphStore.getState();
+    const s = entityGraphCore.graphStore.getState();
     const listState = s.lists[key] ?? entityGraphCore.EMPTY_LIST_STATE;
     if (!listState.hasNextPage || listState.isFetchingMore) return;
     await entityGraphCore.fetchList(
@@ -228,7 +228,7 @@ function createEntityList(opts) {
   }
   async function refetch() {
     const key = entityGraphCore.serializeKey(queryKeyAccessor());
-    entityGraphCore.useGraphStore.getState().setListStale(key, true);
+    entityGraphCore.graphStore.getState().setListStale(key, true);
     await entityGraphCore.fetchList(
       {
         type,
@@ -266,9 +266,9 @@ function createEntityList(opts) {
 }
 function createGraphStore(selector, equalityFn) {
   const eq = equalityFn ?? ((a, b) => a === b);
-  const initial = selector(entityGraphCore.useGraphStore.getState());
+  const initial = selector(entityGraphCore.graphStore.getState());
   const [value, setValue] = solidJs.createSignal(initial);
-  const unsub = entityGraphCore.useGraphStore.subscribe(
+  const unsub = entityGraphCore.graphStore.subscribe(
     selector,
     (next, prev) => {
       if (!eq(next, prev)) {
@@ -302,6 +302,10 @@ Object.defineProperty(exports, "TransientError", {
   enumerable: true,
   get: function () { return entityGraphCore.TransientError; }
 });
+Object.defineProperty(exports, "graphStore", {
+  enumerable: true,
+  get: function () { return entityGraphCore.graphStore; }
+});
 Object.defineProperty(exports, "useGraphStore", {
   enumerable: true,
   get: function () { return entityGraphCore.useGraphStore; }
@@ -310,5 +314,5 @@ exports.createEntity = createEntity;
 exports.createEntityList = createEntityList;
 exports.createGraphStore = createGraphStore;
 exports.setupGraphProvider = setupGraphProvider;
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/create-entity.ts","../src/create-entity-list.ts","../src/create-graph-store.ts","../src/graph-provider.ts"],"names":["createStore","EMPTY_ENTITY_STATE","createResource","getEngineOptions","graphStore","fetchEntity","createEffect","registerSubscriber","onCleanup","unregisterSubscriber","createSignal","EMPTY_LIST_STATE","fetchList","serializeKey","configureEngine","attachGlobalListeners","startGarbageCollector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * createEntity — SolidJS primitive that bridges a single entity to the\n * normalized entity graph via `createResource`.\n *\n * Architecture:\n *   createEntity  (this file, Layer 2)\n *     └─ core engine fetchEntity  (Layer 1 / transport)\n *          └─ graphStore  (Layer 0 / Zustand graph)\n *\n * SolidJS `createResource` owns the async lifecycle; the graph is the\n * single source of truth for the entity payload. Once fetchEntity writes to\n * the graph, a Zustand subscription (via `createStore`) propagates the merged\n * entity back to SolidJS as a fine-grained reactive signal.\n */\n\nimport {\n  createResource,\n  createSignal,\n  createEffect,\n  onCleanup,\n} from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  graphStore,\n  fetchEntity,\n  getEngineOptions,\n  registerSubscriber,\n  unregisterSubscriber,\n  EMPTY_ENTITY_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityState, EntityError } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityOptions, CreateEntityReturn } from \"./types\";\n\n// ── Internal snapshot shape kept in the Solid store ─────────────────────────\n\ninterface EntitySnapshot<TEntity extends object> {\n  data: TEntity | null;\n  entityState: EntityState;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for a single entity.\n *\n * - Uses `createResource` as the async driver so Suspense and ErrorBoundary\n *   boundaries work naturally.\n * - Subscribes to the Zustand graph with `graphStore.subscribe` and mirrors\n *   the merged entity into a `createStore`-backed signal for fine-grained\n *   SolidJS reactivity (only the changed field triggers updates).\n * - Registers / unregisters a subscriber token with the core engine so idle\n *   entities stop background revalidation when no components are observing them.\n *\n * @example\n * ```tsx\n * const invoice = createEntity({\n *   type: \"Invoice\",\n *   id: () => props.invoiceId,\n *   fetch: (id) => api.get(`/invoices/${id}`),\n *   normalize: (raw) => ({ ...raw, id: raw.invoice_id }),\n * });\n *\n * return (\n *   <Show when={!invoice.isLoading()} fallback={<Spinner />}>\n *     <p>{invoice.data()?.amount}</p>\n *   </Show>\n * );\n * ```\n */\nexport function createEntity<TRaw, TEntity extends object>(\n  opts: CreateEntityOptions<TRaw, TEntity>,\n): CreateEntityReturn<TEntity> {\n  const {\n    type,\n    id: idAccessor,\n    fetch,\n    normalize,\n    idField = \"id\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Reactive source for createResource ─────────────────────────────────────\n  // Returns [id, enabled] so resource re-fires when either changes.\n  const source = (): [string | null | undefined, boolean] => {\n    const id = idAccessor();\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n    return [id ?? null, enabled];\n  };\n\n  // ── Solid store: mirrors graph state for fine-grained reactivity ────────────\n  const [snapshot, setSnapshot] = createStore<EntitySnapshot<TEntity>>({\n    data: null,\n    entityState: { ...EMPTY_ENTITY_STATE },\n  });\n\n  // ── createResource: drives Suspense / ErrorBoundary + triggers fetches ──────\n  const [resource] = createResource(source, async ([id, enabled]) => {\n    if (!id || !enabled) return null;\n\n    const engineOpts = getEngineOptions();\n    const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;\n\n    // Check if cached data is fresh enough to skip a network round-trip.\n    const graphState = graphStore.getState();\n    const cachedEntityState = graphState.entityStates[`${type}:${id}`];\n    const cachedEntity = graphState.readEntity<TEntity>(type, id);\n    const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);\n\n    if (cachedEntity && age < effectiveStaleTime && !cachedEntityState?.stale) {\n      // Fresh cache hit: update snapshot and skip fetch.\n      setSnapshot(\"data\", cachedEntity);\n      setSnapshot(\"entityState\", (s) => ({ ...s, ...cachedEntityState }));\n      return cachedEntity;\n    }\n\n    // Delegate to core engine — handles dedup, retries, and graph writes.\n    await fetchEntity(\n      {\n        type,\n        id,\n        fetch,\n        normalize,\n        idField,\n        onSuccess,\n        onError,\n      },\n      { ...getEngineOptions(), defaultStaleTime: effectiveStaleTime },\n    );\n\n    // Return the graph value after the fetch completes.\n    return graphStore.getState().readEntity<TEntity>(type, id);\n  });\n\n  // ── Subscribe to Zustand graph for live fine-grained updates ───────────────\n  createEffect(() => {\n    const id = idAccessor();\n    if (!id) return;\n\n    const subKey = `${type}:${id}`;\n    const token = registerSubscriber(subKey);\n\n    // Sync initial graph state into the Solid store.\n    const syncFromGraph = () => {\n      const s = graphStore.getState();\n      const entity = s.readEntity<TEntity>(type, id);\n      const entityState = s.entityStates[subKey] ?? EMPTY_ENTITY_STATE;\n      setSnapshot(\"data\", entity);\n      setSnapshot(\"entityState\", (prev) => ({ ...prev, ...entityState }));\n    };\n\n    syncFromGraph();\n\n    // Subscribe to graph changes that affect this entity.\n    const unsub = graphStore.subscribe(\n      (s) => ({\n        entity: s.readEntity<TEntity>(type, id),\n        entityState: s.entityStates[subKey] ?? EMPTY_ENTITY_STATE,\n      }),\n      (next) => {\n        setSnapshot(\"data\", next.entity);\n        setSnapshot(\"entityState\", (prev) => ({ ...prev, ...next.entityState }));\n      },\n      { equalityFn: shallowEqual },\n    );\n\n    onCleanup(() => {\n      unsub();\n      unregisterSubscriber(subKey, token);\n    });\n  });\n\n  // ── Imperative refetch ──────────────────────────────────────────────────────\n  const [_refetchTrigger, setRefetchTrigger] = createSignal(0);\n\n  const refetch = async () => {\n    const id = idAccessor();\n    if (!id) return;\n    graphStore.getState().setEntityStale(type, id, true);\n    await fetchEntity(\n      { type, id, fetch, normalize, idField, onSuccess, onError },\n      getEngineOptions(),\n    );\n  };\n\n  // ── Derived signals ──────────────────────────────────────────────────────────\n  const isLoading = () => {\n    const res = resource();\n    const es = snapshot.entityState;\n    return resource.loading || (es.isFetching && snapshot.data === null);\n  };\n\n  const isRefetching = () => {\n    const es = snapshot.entityState;\n    return es.isFetching && snapshot.data !== null;\n  };\n\n  const error = () => snapshot.entityState.error;\n\n  // Typed error: pull from the graph's entityStates — the engine writes\n  // TerminalError / TransientError instances into listState.lastError for lists,\n  // and for single entities the error string is sufficient. We re-expose it as\n  // EntityError | null for API consistency (callers may cast if needed).\n  const typedError = (): EntityError | null => {\n    const errStr = snapshot.entityState.error;\n    if (!errStr) return null;\n    // Surface the string-backed error as a plain Error (full typed errors are on\n    // lists; single-entity fetch only has string form in the graph).\n    return null;\n  };\n\n  return {\n    data: () => snapshot.data,\n    isLoading,\n    isRefetching,\n    error,\n    typedError,\n    refetch,\n    entityState: () => snapshot.entityState,\n  };\n}\n\n// ── Shallow equality helper for Zustand selector ─────────────────────────────\n\nfunction shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  if (a === b) return true;\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  for (const k of keysA) {\n    if (a[k] !== b[k]) return false;\n  }\n  return true;\n}\n","/**\n * createEntityList — SolidJS primitive for reactive normalized entity lists.\n *\n * Architecture:\n *   createEntityList  (this file, Layer 2)\n *     └─ core engine fetchList  (Layer 1 / transport)\n *          └─ graphStore  (Layer 0 / Zustand graph)\n *\n * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows\n * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.\n * Changing `queryKey()` re-serializes to a new list slot, triggering a fresh\n * fetch while keeping existing data visible (stale-while-revalidate).\n */\n\nimport { createEffect, onCleanup } from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  graphStore,\n  fetchList,\n  serializeKey,\n  getEngineOptions,\n  EMPTY_LIST_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityId, ListState } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityListOptions, CreateEntityListReturn } from \"./types\";\n\n// ── Internal store shape ──────────────────────────────────────────────────────\n\ninterface ListSlice<TEntity extends object> {\n  items: TEntity[];\n  listState: ListState;\n}\n\n// ── Equality helper for list subscription ────────────────────────────────────\n\nfunction listSliceEqual(\n  a: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n  b: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n): boolean {\n  return a.listState === b.listState && a.entityBucket === b.entityBucket;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for an entity list.\n *\n * - Subscribes to `graphStore` to mirror list state (ids + pagination)\n *   and resolves the entity rows by joining ids → graph entities on each read.\n * - Changing `queryKey()` triggers a new fetch and subscribes to the new list\n *   slot; the previous subscription is cleaned up automatically.\n * - Supports pagination (`fetchNextPage`) and imperative refetch.\n *\n * @example\n * ```tsx\n * const invoices = createEntityList({\n *   type: \"Invoice\",\n *   queryKey: () => [\"invoices\", { status: filter() }],\n *   fetch: (params) => api.getInvoices(params),\n *   normalize: (raw) => ({ id: raw.invoice_id, data: { ...raw } }),\n * });\n *\n * return (\n *   <For each={invoices.items()}>\n *     {(invoice) => <InvoiceRow invoice={invoice} />}\n *   </For>\n * );\n * ```\n */\nexport function createEntityList<TRaw, TEntity extends object>(\n  opts: CreateEntityListOptions<TRaw, TEntity>,\n): CreateEntityListReturn<TEntity> {\n  const {\n    type,\n    queryKey: queryKeyAccessor,\n    fetch,\n    normalize,\n    mode = \"replace\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Fine-grained Solid store ─────────────────────────────────────────────────\n  const [slice, setSlice] = createStore<ListSlice<TEntity>>({\n    items: [],\n    listState: { ...EMPTY_LIST_STATE },\n  });\n\n  // ── Helper: resolve items from current graph state for a given key ───────────\n  function resolveItems(key: string): TEntity[] {\n    const s = graphStore.getState();\n    const list = s.lists[key];\n    if (!list) return [];\n    return list.ids\n      .map((id: EntityId) => s.readEntity<TEntity>(type, id))\n      .filter((e): e is TEntity => e !== null);\n  }\n\n  // ── Initial / stale-while-revalidate fetch ────────────────────────────────────\n  // Declared before createEffect so it is always defined when the effect runs\n  // (the effect mock executes the callback synchronously in tests).\n  async function doInitialFetch(key: string): Promise<void> {\n    const s = graphStore.getState();\n    const listState = s.lists[key];\n    const effectiveStaleTime = staleTime ?? getEngineOptions().defaultStaleTime;\n    const age = Date.now() - (listState?.lastFetched ?? 0);\n    const isFresh = listState && !listState.stale && age < effectiveStaleTime;\n    if (isFresh) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode,\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Reactive effect: subscribe to graph whenever queryKey changes ─────────────\n  createEffect(() => {\n    const rawKey = queryKeyAccessor();\n    const key = serializeKey(rawKey);\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n\n    // Sync snapshot immediately with whatever is already in the graph.\n    const syncFromGraph = () => {\n      const s = graphStore.getState();\n      const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n      const items = resolveItems(key);\n      setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n      setSlice(\"items\", items);\n    };\n\n    syncFromGraph();\n\n    // Subscribe to any graph change that could affect this list.\n    // Solid's fine-grained update system means only changed fields propagate.\n    const unsub = graphStore.subscribe(\n      (s) => {\n        const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n        const entityBucket = s.entities[type];\n        return { listState, entityBucket };\n      },\n      ({ listState }) => {\n        const items = resolveItems(key);\n        setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n        setSlice(\"items\", items);\n      },\n      { equalityFn: listSliceEqual },\n    );\n\n    // Kick off the fetch when enabled and data may be stale.\n    if (enabled && (fetch || normalize)) {\n      void doInitialFetch(key);\n    }\n\n    onCleanup(() => {\n      unsub();\n    });\n  });\n\n  // ── fetchNextPage ─────────────────────────────────────────────────────────────\n  async function fetchNextPage(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    const s = graphStore.getState();\n    const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n    if (!listState.hasNextPage || listState.isFetchingMore) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"append\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      { cursor: listState.nextCursor ?? undefined },\n      getEngineOptions(),\n      true, // isLoadMore\n    );\n  }\n\n  // ── Imperative refetch ────────────────────────────────────────────────────────\n  async function refetch(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    graphStore.getState().setListStale(key, true);\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"replace\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Derived signals ───────────────────────────────────────────────────────────\n  const isLoading = () => slice.listState.isFetching && slice.items.length === 0;\n  const isLoadingMore = () => slice.listState.isFetchingMore;\n  const error = () => slice.listState.error;\n  const typedError = () => slice.listState.lastError;\n  const total = () => slice.listState.total;\n  const hasNextPage = () => slice.listState.hasNextPage;\n  const hasPrevPage = () => slice.listState.hasPrevPage;\n\n  return {\n    items: () => slice.items,\n    isLoading,\n    isLoadingMore,\n    error,\n    typedError,\n    total,\n    hasNextPage,\n    hasPrevPage,\n    fetchNextPage,\n    refetch,\n    listState: () => slice.listState,\n  };\n}\n","/**\n * createGraphStore — SolidJS fine-grained reactive bridge to the entire\n * Zustand entity graph.\n *\n * Consumers that need ad-hoc access to the graph outside `createEntity` /\n * `createEntityList` can use this to read any slice of `GraphState` as a\n * SolidJS signal. The subscription is scoped to only the selected slice,\n * so unrelated graph mutations do not trigger re-computations.\n *\n * @example\n * ```ts\n * // Read total entity count for a devtools panel.\n * const entityCount = createGraphStore(\n *   (s) => Object.keys(s.entities).reduce((n, t) => n + Object.keys(s.entities[t]).length, 0),\n * );\n * console.log(entityCount()); // reactive SolidJS accessor\n * ```\n */\n\nimport { createSignal, onCleanup } from \"solid-js\";\nimport { graphStore } from \"@prometheus-ags/entity-graph-core\";\nimport type { GraphState } from \"@prometheus-ags/entity-graph-core\";\n\n/**\n * Subscribe to a selector over the entity graph.\n * Returns a SolidJS accessor that updates whenever the selected slice changes.\n *\n * @param selector - Pure function that maps the full `GraphState` to a derived value.\n * @param equalityFn - Optional equality check (default: strict reference equality `===`).\n */\nexport function createGraphStore<T>(\n  selector: (state: GraphState) => T,\n  equalityFn?: (a: T, b: T) => boolean,\n): () => T {\n  const eq = equalityFn ?? ((a, b) => a === b);\n  const initial = selector(graphStore.getState());\n  const [value, setValue] = createSignal<T>(initial);\n\n  const unsub = graphStore.subscribe(\n    selector,\n    (next, prev) => {\n      if (!eq(next, prev)) {\n        setValue(() => next);\n      }\n    },\n  );\n\n  onCleanup(() => unsub());\n\n  return value;\n}\n","/**\n * GraphProvider utilities for SolidJS.\n *\n * Provides boot-time setup helpers for attaching global focus/reconnect\n * listeners and configuring the engine from within a SolidJS application root.\n *\n * Usage in the application root (e.g. `src/index.tsx`):\n *\n * ```ts\n * import { setupGraphProvider } from \"@prometheus-ags/entity-graph-solid\";\n * import { configureEngine, attachGlobalListeners } from \"@prometheus-ags/entity-graph-core\";\n *\n * setupGraphProvider({\n *   staleTime: 60_000,\n *   revalidateOnFocus: true,\n * });\n * ```\n */\n\nimport {\n  configureEngine,\n  attachGlobalListeners,\n  startGarbageCollector,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EngineOptions } from \"@prometheus-ags/entity-graph-core\";\n\nexport interface GraphProviderOptions extends EngineOptions {\n  /**\n   * Whether to attach window focus/online listeners for stale-while-revalidate.\n   * Defaults to `true` in browser environments.\n   */\n  attachListeners?: boolean;\n  /**\n   * Whether to start the periodic garbage collector.\n   * Defaults to `true`.\n   */\n  startGc?: boolean;\n}\n\n/**\n * Configures the entity-graph engine and wires browser-level listeners.\n * Call this once at application startup before mounting the root component.\n *\n * Returns a cleanup function that stops the GC interval (useful for tests).\n */\nexport function setupGraphProvider(opts: GraphProviderOptions = {}): () => void {\n  const { attachListeners = true, startGc = true, ...engineOpts } = opts;\n\n  if (Object.keys(engineOpts).length > 0) {\n    configureEngine(engineOpts);\n  }\n\n  if (attachListeners && typeof window !== \"undefined\") {\n    attachGlobalListeners();\n  }\n\n  let stopGc: (() => void) | undefined;\n  if (startGc && typeof window !== \"undefined\") {\n    stopGc = startGarbageCollector();\n  }\n\n  return () => stopGc?.();\n}\n"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { EntityType, EntityId, EntityError, ListState, EntityState, GraphState, EngineOptions } from '@prometheus-ags/entity-graph-core';
-export { EntityError, EntityId, EntityState, EntityType, FilterSpec, ListState, SortSpec, TerminalError, TransientError, ViewDescriptor, useGraphStore } from '@prometheus-ags/entity-graph-core';
+export { EntityError, EntityId, EntityState, EntityType, FilterSpec, ListState, SortSpec, TerminalError, TransientError, ViewDescriptor, graphStore, useGraphStore } from '@prometheus-ags/entity-graph-core';
 
 /**
  * Shared option types for SolidJS entity-graph bindings.
@@ -156,7 +156,7 @@ interface CreateEntityListReturn<TEntity extends object> {
  * Architecture:
  *   createEntity  (this file, Layer 2)
  *     └─ core engine fetchEntity  (Layer 1 / transport)
- *          └─ useGraphStore  (Layer 0 / Zustand graph)
+ *          └─ graphStore  (Layer 0 / Zustand graph)
  *
  * SolidJS `createResource` owns the async lifecycle; the graph is the
  * single source of truth for the entity payload. Once fetchEntity writes to
@@ -169,7 +169,7 @@ interface CreateEntityListReturn<TEntity extends object> {
  *
  * - Uses `createResource` as the async driver so Suspense and ErrorBoundary
  *   boundaries work naturally.
- * - Subscribes to the Zustand graph with `useGraphStore.subscribe` and mirrors
+ * - Subscribes to the Zustand graph with `graphStore.subscribe` and mirrors
  *   the merged entity into a `createStore`-backed signal for fine-grained
  *   SolidJS reactivity (only the changed field triggers updates).
  * - Registers / unregisters a subscriber token with the core engine so idle
@@ -199,7 +199,7 @@ declare function createEntity<TRaw, TEntity extends object>(opts: CreateEntityOp
  * Architecture:
  *   createEntityList  (this file, Layer 2)
  *     └─ core engine fetchList  (Layer 1 / transport)
- *          └─ useGraphStore  (Layer 0 / Zustand graph)
+ *          └─ graphStore  (Layer 0 / Zustand graph)
  *
  * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows
  * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.
@@ -210,7 +210,7 @@ declare function createEntity<TRaw, TEntity extends object>(opts: CreateEntityOp
 /**
  * Creates a fine-grained SolidJS reactive primitive for an entity list.
  *
- * - Subscribes to `useGraphStore` to mirror list state (ids + pagination)
+ * - Subscribes to `graphStore` to mirror list state (ids + pagination)
  *   and resolves the entity rows by joining ids → graph entities on each read.
  * - Changing `queryKey()` triggers a new fetch and subscribes to the new list
  *   slot; the previous subscription is cleaned up automatically.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { EntityType, EntityId, EntityError, ListState, EntityState, GraphState, EngineOptions } from '@prometheus-ags/entity-graph-core';
-export { EntityError, EntityId, EntityState, EntityType, FilterSpec, ListState, SortSpec, TerminalError, TransientError, ViewDescriptor, useGraphStore } from '@prometheus-ags/entity-graph-core';
+export { EntityError, EntityId, EntityState, EntityType, FilterSpec, ListState, SortSpec, TerminalError, TransientError, ViewDescriptor, graphStore, useGraphStore } from '@prometheus-ags/entity-graph-core';
 
 /**
  * Shared option types for SolidJS entity-graph bindings.
@@ -156,7 +156,7 @@ interface CreateEntityListReturn<TEntity extends object> {
  * Architecture:
  *   createEntity  (this file, Layer 2)
  *     └─ core engine fetchEntity  (Layer 1 / transport)
- *          └─ useGraphStore  (Layer 0 / Zustand graph)
+ *          └─ graphStore  (Layer 0 / Zustand graph)
  *
  * SolidJS `createResource` owns the async lifecycle; the graph is the
  * single source of truth for the entity payload. Once fetchEntity writes to
@@ -169,7 +169,7 @@ interface CreateEntityListReturn<TEntity extends object> {
  *
  * - Uses `createResource` as the async driver so Suspense and ErrorBoundary
  *   boundaries work naturally.
- * - Subscribes to the Zustand graph with `useGraphStore.subscribe` and mirrors
+ * - Subscribes to the Zustand graph with `graphStore.subscribe` and mirrors
  *   the merged entity into a `createStore`-backed signal for fine-grained
  *   SolidJS reactivity (only the changed field triggers updates).
  * - Registers / unregisters a subscriber token with the core engine so idle
@@ -199,7 +199,7 @@ declare function createEntity<TRaw, TEntity extends object>(opts: CreateEntityOp
  * Architecture:
  *   createEntityList  (this file, Layer 2)
  *     └─ core engine fetchList  (Layer 1 / transport)
- *          └─ useGraphStore  (Layer 0 / Zustand graph)
+ *          └─ graphStore  (Layer 0 / Zustand graph)
  *
  * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows
  * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.
@@ -210,7 +210,7 @@ declare function createEntity<TRaw, TEntity extends object>(opts: CreateEntityOp
 /**
  * Creates a fine-grained SolidJS reactive primitive for an entity list.
  *
- * - Subscribes to `useGraphStore` to mirror list state (ids + pagination)
+ * - Subscribes to `graphStore` to mirror list state (ids + pagination)
  *   and resolves the entity rows by joining ids → graph entities on each read.
  * - Changing `queryKey()` triggers a new fetch and subscribes to the new list
  *   slot; the previous subscription is cleaned up automatically.

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { createResource, createEffect, onCleanup, createSignal } from 'solid-js';
 import { createStore } from 'solid-js/store';
-import { EMPTY_ENTITY_STATE, getEngineOptions, useGraphStore, fetchEntity, registerSubscriber, unregisterSubscriber, EMPTY_LIST_STATE, serializeKey, configureEngine, attachGlobalListeners, startGarbageCollector, fetchList } from '@prometheus-ags/entity-graph-core';
-export { TerminalError, TransientError, useGraphStore } from '@prometheus-ags/entity-graph-core';
+import { EMPTY_ENTITY_STATE, getEngineOptions, graphStore, fetchEntity, registerSubscriber, unregisterSubscriber, EMPTY_LIST_STATE, serializeKey, configureEngine, attachGlobalListeners, startGarbageCollector, fetchList } from '@prometheus-ags/entity-graph-core';
+export { TerminalError, TransientError, graphStore, useGraphStore } from '@prometheus-ags/entity-graph-core';
 
 // src/create-entity.ts
 function createEntity(opts) {
@@ -29,7 +29,7 @@ function createEntity(opts) {
     if (!id || !enabled) return null;
     const engineOpts = getEngineOptions();
     const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;
-    const graphState = useGraphStore.getState();
+    const graphState = graphStore.getState();
     const cachedEntityState = graphState.entityStates[`${type}:${id}`];
     const cachedEntity = graphState.readEntity(type, id);
     const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);
@@ -50,7 +50,7 @@ function createEntity(opts) {
       },
       { ...getEngineOptions(), defaultStaleTime: effectiveStaleTime }
     );
-    return useGraphStore.getState().readEntity(type, id);
+    return graphStore.getState().readEntity(type, id);
   });
   createEffect(() => {
     const id = idAccessor();
@@ -58,14 +58,14 @@ function createEntity(opts) {
     const subKey = `${type}:${id}`;
     const token = registerSubscriber(subKey);
     const syncFromGraph = () => {
-      const s = useGraphStore.getState();
+      const s = graphStore.getState();
       const entity = s.readEntity(type, id);
       const entityState = s.entityStates[subKey] ?? EMPTY_ENTITY_STATE;
       setSnapshot("data", entity);
       setSnapshot("entityState", (prev) => ({ ...prev, ...entityState }));
     };
     syncFromGraph();
-    const unsub = useGraphStore.subscribe(
+    const unsub = graphStore.subscribe(
       (s) => ({
         entity: s.readEntity(type, id),
         entityState: s.entityStates[subKey] ?? EMPTY_ENTITY_STATE
@@ -85,7 +85,7 @@ function createEntity(opts) {
   const refetch = async () => {
     const id = idAccessor();
     if (!id) return;
-    useGraphStore.getState().setEntityStale(type, id, true);
+    graphStore.getState().setEntityStale(type, id, true);
     await fetchEntity(
       { type, id, fetch, normalize, idField, onSuccess, onError },
       getEngineOptions()
@@ -146,13 +146,13 @@ function createEntityList(opts) {
     listState: { ...EMPTY_LIST_STATE }
   });
   function resolveItems(key) {
-    const s = useGraphStore.getState();
+    const s = graphStore.getState();
     const list = s.lists[key];
     if (!list) return [];
     return list.ids.map((id) => s.readEntity(type, id)).filter((e) => e !== null);
   }
   async function doInitialFetch(key) {
-    const s = useGraphStore.getState();
+    const s = graphStore.getState();
     const listState = s.lists[key];
     const effectiveStaleTime = staleTime ?? getEngineOptions().defaultStaleTime;
     const age = Date.now() - (listState?.lastFetched ?? 0);
@@ -177,14 +177,14 @@ function createEntityList(opts) {
     const key = serializeKey(rawKey);
     const enabled = enabledAccessor ? enabledAccessor() : true;
     const syncFromGraph = () => {
-      const s = useGraphStore.getState();
+      const s = graphStore.getState();
       const listState = s.lists[key] ?? EMPTY_LIST_STATE;
       const items = resolveItems(key);
       setSlice("listState", (prev) => ({ ...prev, ...listState }));
       setSlice("items", items);
     };
     syncFromGraph();
-    const unsub = useGraphStore.subscribe(
+    const unsub = graphStore.subscribe(
       (s) => {
         const listState = s.lists[key] ?? EMPTY_LIST_STATE;
         const entityBucket = s.entities[type];
@@ -206,7 +206,7 @@ function createEntityList(opts) {
   });
   async function fetchNextPage() {
     const key = serializeKey(queryKeyAccessor());
-    const s = useGraphStore.getState();
+    const s = graphStore.getState();
     const listState = s.lists[key] ?? EMPTY_LIST_STATE;
     if (!listState.hasNextPage || listState.isFetchingMore) return;
     await fetchList(
@@ -227,7 +227,7 @@ function createEntityList(opts) {
   }
   async function refetch() {
     const key = serializeKey(queryKeyAccessor());
-    useGraphStore.getState().setListStale(key, true);
+    graphStore.getState().setListStale(key, true);
     await fetchList(
       {
         type,
@@ -265,9 +265,9 @@ function createEntityList(opts) {
 }
 function createGraphStore(selector, equalityFn) {
   const eq = equalityFn ?? ((a, b) => a === b);
-  const initial = selector(useGraphStore.getState());
+  const initial = selector(graphStore.getState());
   const [value, setValue] = createSignal(initial);
-  const unsub = useGraphStore.subscribe(
+  const unsub = graphStore.subscribe(
     selector,
     (next, prev) => {
       if (!eq(next, prev)) {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/create-entity.ts","../src/create-entity-list.ts","../src/create-graph-store.ts","../src/graph-provider.ts"],"names":["createStore","useGraphStore","getEngineOptions","createEffect","onCleanup","createSignal"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * createEntity — SolidJS primitive that bridges a single entity to the\n * normalized entity graph via `createResource`.\n *\n * Architecture:\n *   createEntity  (this file, Layer 2)\n *     └─ core engine fetchEntity  (Layer 1 / transport)\n *          └─ useGraphStore  (Layer 0 / Zustand graph)\n *\n * SolidJS `createResource` owns the async lifecycle; the graph is the\n * single source of truth for the entity payload. Once fetchEntity writes to\n * the graph, a Zustand subscription (via `createStore`) propagates the merged\n * entity back to SolidJS as a fine-grained reactive signal.\n */\n\nimport {\n  createResource,\n  createSignal,\n  createEffect,\n  onCleanup,\n} from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  useGraphStore,\n  fetchEntity,\n  getEngineOptions,\n  registerSubscriber,\n  unregisterSubscriber,\n  EMPTY_ENTITY_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityState, EntityError } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityOptions, CreateEntityReturn } from \"./types\";\n\n// ── Internal snapshot shape kept in the Solid store ─────────────────────────\n\ninterface EntitySnapshot<TEntity extends object> {\n  data: TEntity | null;\n  entityState: EntityState;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for a single entity.\n *\n * - Uses `createResource` as the async driver so Suspense and ErrorBoundary\n *   boundaries work naturally.\n * - Subscribes to the Zustand graph with `useGraphStore.subscribe` and mirrors\n *   the merged entity into a `createStore`-backed signal for fine-grained\n *   SolidJS reactivity (only the changed field triggers updates).\n * - Registers / unregisters a subscriber token with the core engine so idle\n *   entities stop background revalidation when no components are observing them.\n *\n * @example\n * ```tsx\n * const invoice = createEntity({\n *   type: \"Invoice\",\n *   id: () => props.invoiceId,\n *   fetch: (id) => api.get(`/invoices/${id}`),\n *   normalize: (raw) => ({ ...raw, id: raw.invoice_id }),\n * });\n *\n * return (\n *   <Show when={!invoice.isLoading()} fallback={<Spinner />}>\n *     <p>{invoice.data()?.amount}</p>\n *   </Show>\n * );\n * ```\n */\nexport function createEntity<TRaw, TEntity extends object>(\n  opts: CreateEntityOptions<TRaw, TEntity>,\n): CreateEntityReturn<TEntity> {\n  const {\n    type,\n    id: idAccessor,\n    fetch,\n    normalize,\n    idField = \"id\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Reactive source for createResource ─────────────────────────────────────\n  // Returns [id, enabled] so resource re-fires when either changes.\n  const source = (): [string | null | undefined, boolean] => {\n    const id = idAccessor();\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n    return [id ?? null, enabled];\n  };\n\n  // ── Solid store: mirrors graph state for fine-grained reactivity ────────────\n  const [snapshot, setSnapshot] = createStore<EntitySnapshot<TEntity>>({\n    data: null,\n    entityState: { ...EMPTY_ENTITY_STATE },\n  });\n\n  // ── createResource: drives Suspense / ErrorBoundary + triggers fetches ──────\n  const [resource] = createResource(source, async ([id, enabled]) => {\n    if (!id || !enabled) return null;\n\n    const engineOpts = getEngineOptions();\n    const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;\n\n    // Check if cached data is fresh enough to skip a network round-trip.\n    const graphState = useGraphStore.getState();\n    const cachedEntityState = graphState.entityStates[`${type}:${id}`];\n    const cachedEntity = graphState.readEntity<TEntity>(type, id);\n    const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);\n\n    if (cachedEntity && age < effectiveStaleTime && !cachedEntityState?.stale) {\n      // Fresh cache hit: update snapshot and skip fetch.\n      setSnapshot(\"data\", cachedEntity);\n      setSnapshot(\"entityState\", (s) => ({ ...s, ...cachedEntityState }));\n      return cachedEntity;\n    }\n\n    // Delegate to core engine — handles dedup, retries, and graph writes.\n    await fetchEntity(\n      {\n        type,\n        id,\n        fetch,\n        normalize,\n        idField,\n        onSuccess,\n        onError,\n      },\n      { ...getEngineOptions(), defaultStaleTime: effectiveStaleTime },\n    );\n\n    // Return the graph value after the fetch completes.\n    return useGraphStore.getState().readEntity<TEntity>(type, id);\n  });\n\n  // ── Subscribe to Zustand graph for live fine-grained updates ───────────────\n  createEffect(() => {\n    const id = idAccessor();\n    if (!id) return;\n\n    const subKey = `${type}:${id}`;\n    const token = registerSubscriber(subKey);\n\n    // Sync initial graph state into the Solid store.\n    const syncFromGraph = () => {\n      const s = useGraphStore.getState();\n      const entity = s.readEntity<TEntity>(type, id);\n      const entityState = s.entityStates[subKey] ?? EMPTY_ENTITY_STATE;\n      setSnapshot(\"data\", entity);\n      setSnapshot(\"entityState\", (prev) => ({ ...prev, ...entityState }));\n    };\n\n    syncFromGraph();\n\n    // Subscribe to graph changes that affect this entity.\n    const unsub = useGraphStore.subscribe(\n      (s) => ({\n        entity: s.readEntity<TEntity>(type, id),\n        entityState: s.entityStates[subKey] ?? EMPTY_ENTITY_STATE,\n      }),\n      (next) => {\n        setSnapshot(\"data\", next.entity);\n        setSnapshot(\"entityState\", (prev) => ({ ...prev, ...next.entityState }));\n      },\n      { equalityFn: shallowEqual },\n    );\n\n    onCleanup(() => {\n      unsub();\n      unregisterSubscriber(subKey, token);\n    });\n  });\n\n  // ── Imperative refetch ──────────────────────────────────────────────────────\n  const [_refetchTrigger, setRefetchTrigger] = createSignal(0);\n\n  const refetch = async () => {\n    const id = idAccessor();\n    if (!id) return;\n    useGraphStore.getState().setEntityStale(type, id, true);\n    await fetchEntity(\n      { type, id, fetch, normalize, idField, onSuccess, onError },\n      getEngineOptions(),\n    );\n  };\n\n  // ── Derived signals ──────────────────────────────────────────────────────────\n  const isLoading = () => {\n    const res = resource();\n    const es = snapshot.entityState;\n    return resource.loading || (es.isFetching && snapshot.data === null);\n  };\n\n  const isRefetching = () => {\n    const es = snapshot.entityState;\n    return es.isFetching && snapshot.data !== null;\n  };\n\n  const error = () => snapshot.entityState.error;\n\n  // Typed error: pull from the graph's entityStates — the engine writes\n  // TerminalError / TransientError instances into listState.lastError for lists,\n  // and for single entities the error string is sufficient. We re-expose it as\n  // EntityError | null for API consistency (callers may cast if needed).\n  const typedError = (): EntityError | null => {\n    const errStr = snapshot.entityState.error;\n    if (!errStr) return null;\n    // Surface the string-backed error as a plain Error (full typed errors are on\n    // lists; single-entity fetch only has string form in the graph).\n    return null;\n  };\n\n  return {\n    data: () => snapshot.data,\n    isLoading,\n    isRefetching,\n    error,\n    typedError,\n    refetch,\n    entityState: () => snapshot.entityState,\n  };\n}\n\n// ── Shallow equality helper for Zustand selector ─────────────────────────────\n\nfunction shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  if (a === b) return true;\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  for (const k of keysA) {\n    if (a[k] !== b[k]) return false;\n  }\n  return true;\n}\n","/**\n * createEntityList — SolidJS primitive for reactive normalized entity lists.\n *\n * Architecture:\n *   createEntityList  (this file, Layer 2)\n *     └─ core engine fetchList  (Layer 1 / transport)\n *          └─ useGraphStore  (Layer 0 / Zustand graph)\n *\n * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows\n * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.\n * Changing `queryKey()` re-serializes to a new list slot, triggering a fresh\n * fetch while keeping existing data visible (stale-while-revalidate).\n */\n\nimport { createEffect, onCleanup } from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  useGraphStore,\n  fetchList,\n  serializeKey,\n  getEngineOptions,\n  EMPTY_LIST_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityId, ListState } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityListOptions, CreateEntityListReturn } from \"./types\";\n\n// ── Internal store shape ──────────────────────────────────────────────────────\n\ninterface ListSlice<TEntity extends object> {\n  items: TEntity[];\n  listState: ListState;\n}\n\n// ── Equality helper for list subscription ────────────────────────────────────\n\nfunction listSliceEqual(\n  a: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n  b: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n): boolean {\n  return a.listState === b.listState && a.entityBucket === b.entityBucket;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for an entity list.\n *\n * - Subscribes to `useGraphStore` to mirror list state (ids + pagination)\n *   and resolves the entity rows by joining ids → graph entities on each read.\n * - Changing `queryKey()` triggers a new fetch and subscribes to the new list\n *   slot; the previous subscription is cleaned up automatically.\n * - Supports pagination (`fetchNextPage`) and imperative refetch.\n *\n * @example\n * ```tsx\n * const invoices = createEntityList({\n *   type: \"Invoice\",\n *   queryKey: () => [\"invoices\", { status: filter() }],\n *   fetch: (params) => api.getInvoices(params),\n *   normalize: (raw) => ({ id: raw.invoice_id, data: { ...raw } }),\n * });\n *\n * return (\n *   <For each={invoices.items()}>\n *     {(invoice) => <InvoiceRow invoice={invoice} />}\n *   </For>\n * );\n * ```\n */\nexport function createEntityList<TRaw, TEntity extends object>(\n  opts: CreateEntityListOptions<TRaw, TEntity>,\n): CreateEntityListReturn<TEntity> {\n  const {\n    type,\n    queryKey: queryKeyAccessor,\n    fetch,\n    normalize,\n    mode = \"replace\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Fine-grained Solid store ─────────────────────────────────────────────────\n  const [slice, setSlice] = createStore<ListSlice<TEntity>>({\n    items: [],\n    listState: { ...EMPTY_LIST_STATE },\n  });\n\n  // ── Helper: resolve items from current graph state for a given key ───────────\n  function resolveItems(key: string): TEntity[] {\n    const s = useGraphStore.getState();\n    const list = s.lists[key];\n    if (!list) return [];\n    return list.ids\n      .map((id: EntityId) => s.readEntity<TEntity>(type, id))\n      .filter((e): e is TEntity => e !== null);\n  }\n\n  // ── Initial / stale-while-revalidate fetch ────────────────────────────────────\n  // Declared before createEffect so it is always defined when the effect runs\n  // (the effect mock executes the callback synchronously in tests).\n  async function doInitialFetch(key: string): Promise<void> {\n    const s = useGraphStore.getState();\n    const listState = s.lists[key];\n    const effectiveStaleTime = staleTime ?? getEngineOptions().defaultStaleTime;\n    const age = Date.now() - (listState?.lastFetched ?? 0);\n    const isFresh = listState && !listState.stale && age < effectiveStaleTime;\n    if (isFresh) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode,\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Reactive effect: subscribe to graph whenever queryKey changes ─────────────\n  createEffect(() => {\n    const rawKey = queryKeyAccessor();\n    const key = serializeKey(rawKey);\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n\n    // Sync snapshot immediately with whatever is already in the graph.\n    const syncFromGraph = () => {\n      const s = useGraphStore.getState();\n      const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n      const items = resolveItems(key);\n      setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n      setSlice(\"items\", items);\n    };\n\n    syncFromGraph();\n\n    // Subscribe to any graph change that could affect this list.\n    // Solid's fine-grained update system means only changed fields propagate.\n    const unsub = useGraphStore.subscribe(\n      (s) => {\n        const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n        const entityBucket = s.entities[type];\n        return { listState, entityBucket };\n      },\n      ({ listState }) => {\n        const items = resolveItems(key);\n        setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n        setSlice(\"items\", items);\n      },\n      { equalityFn: listSliceEqual },\n    );\n\n    // Kick off the fetch when enabled and data may be stale.\n    if (enabled && (fetch || normalize)) {\n      void doInitialFetch(key);\n    }\n\n    onCleanup(() => {\n      unsub();\n    });\n  });\n\n  // ── fetchNextPage ─────────────────────────────────────────────────────────────\n  async function fetchNextPage(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    const s = useGraphStore.getState();\n    const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n    if (!listState.hasNextPage || listState.isFetchingMore) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"append\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      { cursor: listState.nextCursor ?? undefined },\n      getEngineOptions(),\n      true, // isLoadMore\n    );\n  }\n\n  // ── Imperative refetch ────────────────────────────────────────────────────────\n  async function refetch(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    useGraphStore.getState().setListStale(key, true);\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"replace\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Derived signals ───────────────────────────────────────────────────────────\n  const isLoading = () => slice.listState.isFetching && slice.items.length === 0;\n  const isLoadingMore = () => slice.listState.isFetchingMore;\n  const error = () => slice.listState.error;\n  const typedError = () => slice.listState.lastError;\n  const total = () => slice.listState.total;\n  const hasNextPage = () => slice.listState.hasNextPage;\n  const hasPrevPage = () => slice.listState.hasPrevPage;\n\n  return {\n    items: () => slice.items,\n    isLoading,\n    isLoadingMore,\n    error,\n    typedError,\n    total,\n    hasNextPage,\n    hasPrevPage,\n    fetchNextPage,\n    refetch,\n    listState: () => slice.listState,\n  };\n}\n","/**\n * createGraphStore — SolidJS fine-grained reactive bridge to the entire\n * Zustand entity graph.\n *\n * Consumers that need ad-hoc access to the graph outside `createEntity` /\n * `createEntityList` can use this to read any slice of `GraphState` as a\n * SolidJS signal. The subscription is scoped to only the selected slice,\n * so unrelated graph mutations do not trigger re-computations.\n *\n * @example\n * ```ts\n * // Read total entity count for a devtools panel.\n * const entityCount = createGraphStore(\n *   (s) => Object.keys(s.entities).reduce((n, t) => n + Object.keys(s.entities[t]).length, 0),\n * );\n * console.log(entityCount()); // reactive SolidJS accessor\n * ```\n */\n\nimport { createSignal, onCleanup } from \"solid-js\";\nimport { useGraphStore } from \"@prometheus-ags/entity-graph-core\";\nimport type { GraphState } from \"@prometheus-ags/entity-graph-core\";\n\n/**\n * Subscribe to a selector over the entity graph.\n * Returns a SolidJS accessor that updates whenever the selected slice changes.\n *\n * @param selector - Pure function that maps the full `GraphState` to a derived value.\n * @param equalityFn - Optional equality check (default: strict reference equality `===`).\n */\nexport function createGraphStore<T>(\n  selector: (state: GraphState) => T,\n  equalityFn?: (a: T, b: T) => boolean,\n): () => T {\n  const eq = equalityFn ?? ((a, b) => a === b);\n  const initial = selector(useGraphStore.getState());\n  const [value, setValue] = createSignal<T>(initial);\n\n  const unsub = useGraphStore.subscribe(\n    selector,\n    (next, prev) => {\n      if (!eq(next, prev)) {\n        setValue(() => next);\n      }\n    },\n  );\n\n  onCleanup(() => unsub());\n\n  return value;\n}\n","/**\n * GraphProvider utilities for SolidJS.\n *\n * Provides boot-time setup helpers for attaching global focus/reconnect\n * listeners and configuring the engine from within a SolidJS application root.\n *\n * Usage in the application root (e.g. `src/index.tsx`):\n *\n * ```ts\n * import { setupGraphProvider } from \"@prometheus-ags/entity-graph-solid\";\n * import { configureEngine, attachGlobalListeners } from \"@prometheus-ags/entity-graph-core\";\n *\n * setupGraphProvider({\n *   staleTime: 60_000,\n *   revalidateOnFocus: true,\n * });\n * ```\n */\n\nimport {\n  configureEngine,\n  attachGlobalListeners,\n  startGarbageCollector,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EngineOptions } from \"@prometheus-ags/entity-graph-core\";\n\nexport interface GraphProviderOptions extends EngineOptions {\n  /**\n   * Whether to attach window focus/online listeners for stale-while-revalidate.\n   * Defaults to `true` in browser environments.\n   */\n  attachListeners?: boolean;\n  /**\n   * Whether to start the periodic garbage collector.\n   * Defaults to `true`.\n   */\n  startGc?: boolean;\n}\n\n/**\n * Configures the entity-graph engine and wires browser-level listeners.\n * Call this once at application startup before mounting the root component.\n *\n * Returns a cleanup function that stops the GC interval (useful for tests).\n */\nexport function setupGraphProvider(opts: GraphProviderOptions = {}): () => void {\n  const { attachListeners = true, startGc = true, ...engineOpts } = opts;\n\n  if (Object.keys(engineOpts).length > 0) {\n    configureEngine(engineOpts);\n  }\n\n  if (attachListeners && typeof window !== \"undefined\") {\n    attachGlobalListeners();\n  }\n\n  let stopGc: (() => void) | undefined;\n  if (startGc && typeof window !== \"undefined\") {\n    stopGc = startGarbageCollector();\n  }\n\n  return () => stopGc?.();\n}\n"]}
+{"version":3,"sources":["../src/create-entity.ts","../src/create-entity-list.ts","../src/create-graph-store.ts","../src/graph-provider.ts"],"names":["createStore","graphStore","getEngineOptions","createEffect","onCleanup","createSignal"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * createEntity — SolidJS primitive that bridges a single entity to the\n * normalized entity graph via `createResource`.\n *\n * Architecture:\n *   createEntity  (this file, Layer 2)\n *     └─ core engine fetchEntity  (Layer 1 / transport)\n *          └─ graphStore  (Layer 0 / Zustand graph)\n *\n * SolidJS `createResource` owns the async lifecycle; the graph is the\n * single source of truth for the entity payload. Once fetchEntity writes to\n * the graph, a Zustand subscription (via `createStore`) propagates the merged\n * entity back to SolidJS as a fine-grained reactive signal.\n */\n\nimport {\n  createResource,\n  createSignal,\n  createEffect,\n  onCleanup,\n} from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  graphStore,\n  fetchEntity,\n  getEngineOptions,\n  registerSubscriber,\n  unregisterSubscriber,\n  EMPTY_ENTITY_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityState, EntityError } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityOptions, CreateEntityReturn } from \"./types\";\n\n// ── Internal snapshot shape kept in the Solid store ─────────────────────────\n\ninterface EntitySnapshot<TEntity extends object> {\n  data: TEntity | null;\n  entityState: EntityState;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for a single entity.\n *\n * - Uses `createResource` as the async driver so Suspense and ErrorBoundary\n *   boundaries work naturally.\n * - Subscribes to the Zustand graph with `graphStore.subscribe` and mirrors\n *   the merged entity into a `createStore`-backed signal for fine-grained\n *   SolidJS reactivity (only the changed field triggers updates).\n * - Registers / unregisters a subscriber token with the core engine so idle\n *   entities stop background revalidation when no components are observing them.\n *\n * @example\n * ```tsx\n * const invoice = createEntity({\n *   type: \"Invoice\",\n *   id: () => props.invoiceId,\n *   fetch: (id) => api.get(`/invoices/${id}`),\n *   normalize: (raw) => ({ ...raw, id: raw.invoice_id }),\n * });\n *\n * return (\n *   <Show when={!invoice.isLoading()} fallback={<Spinner />}>\n *     <p>{invoice.data()?.amount}</p>\n *   </Show>\n * );\n * ```\n */\nexport function createEntity<TRaw, TEntity extends object>(\n  opts: CreateEntityOptions<TRaw, TEntity>,\n): CreateEntityReturn<TEntity> {\n  const {\n    type,\n    id: idAccessor,\n    fetch,\n    normalize,\n    idField = \"id\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Reactive source for createResource ─────────────────────────────────────\n  // Returns [id, enabled] so resource re-fires when either changes.\n  const source = (): [string | null | undefined, boolean] => {\n    const id = idAccessor();\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n    return [id ?? null, enabled];\n  };\n\n  // ── Solid store: mirrors graph state for fine-grained reactivity ────────────\n  const [snapshot, setSnapshot] = createStore<EntitySnapshot<TEntity>>({\n    data: null,\n    entityState: { ...EMPTY_ENTITY_STATE },\n  });\n\n  // ── createResource: drives Suspense / ErrorBoundary + triggers fetches ──────\n  const [resource] = createResource(source, async ([id, enabled]) => {\n    if (!id || !enabled) return null;\n\n    const engineOpts = getEngineOptions();\n    const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;\n\n    // Check if cached data is fresh enough to skip a network round-trip.\n    const graphState = graphStore.getState();\n    const cachedEntityState = graphState.entityStates[`${type}:${id}`];\n    const cachedEntity = graphState.readEntity<TEntity>(type, id);\n    const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);\n\n    if (cachedEntity && age < effectiveStaleTime && !cachedEntityState?.stale) {\n      // Fresh cache hit: update snapshot and skip fetch.\n      setSnapshot(\"data\", cachedEntity);\n      setSnapshot(\"entityState\", (s) => ({ ...s, ...cachedEntityState }));\n      return cachedEntity;\n    }\n\n    // Delegate to core engine — handles dedup, retries, and graph writes.\n    await fetchEntity(\n      {\n        type,\n        id,\n        fetch,\n        normalize,\n        idField,\n        onSuccess,\n        onError,\n      },\n      { ...getEngineOptions(), defaultStaleTime: effectiveStaleTime },\n    );\n\n    // Return the graph value after the fetch completes.\n    return graphStore.getState().readEntity<TEntity>(type, id);\n  });\n\n  // ── Subscribe to Zustand graph for live fine-grained updates ───────────────\n  createEffect(() => {\n    const id = idAccessor();\n    if (!id) return;\n\n    const subKey = `${type}:${id}`;\n    const token = registerSubscriber(subKey);\n\n    // Sync initial graph state into the Solid store.\n    const syncFromGraph = () => {\n      const s = graphStore.getState();\n      const entity = s.readEntity<TEntity>(type, id);\n      const entityState = s.entityStates[subKey] ?? EMPTY_ENTITY_STATE;\n      setSnapshot(\"data\", entity);\n      setSnapshot(\"entityState\", (prev) => ({ ...prev, ...entityState }));\n    };\n\n    syncFromGraph();\n\n    // Subscribe to graph changes that affect this entity.\n    const unsub = graphStore.subscribe(\n      (s) => ({\n        entity: s.readEntity<TEntity>(type, id),\n        entityState: s.entityStates[subKey] ?? EMPTY_ENTITY_STATE,\n      }),\n      (next) => {\n        setSnapshot(\"data\", next.entity);\n        setSnapshot(\"entityState\", (prev) => ({ ...prev, ...next.entityState }));\n      },\n      { equalityFn: shallowEqual },\n    );\n\n    onCleanup(() => {\n      unsub();\n      unregisterSubscriber(subKey, token);\n    });\n  });\n\n  // ── Imperative refetch ──────────────────────────────────────────────────────\n  const [_refetchTrigger, setRefetchTrigger] = createSignal(0);\n\n  const refetch = async () => {\n    const id = idAccessor();\n    if (!id) return;\n    graphStore.getState().setEntityStale(type, id, true);\n    await fetchEntity(\n      { type, id, fetch, normalize, idField, onSuccess, onError },\n      getEngineOptions(),\n    );\n  };\n\n  // ── Derived signals ──────────────────────────────────────────────────────────\n  const isLoading = () => {\n    const res = resource();\n    const es = snapshot.entityState;\n    return resource.loading || (es.isFetching && snapshot.data === null);\n  };\n\n  const isRefetching = () => {\n    const es = snapshot.entityState;\n    return es.isFetching && snapshot.data !== null;\n  };\n\n  const error = () => snapshot.entityState.error;\n\n  // Typed error: pull from the graph's entityStates — the engine writes\n  // TerminalError / TransientError instances into listState.lastError for lists,\n  // and for single entities the error string is sufficient. We re-expose it as\n  // EntityError | null for API consistency (callers may cast if needed).\n  const typedError = (): EntityError | null => {\n    const errStr = snapshot.entityState.error;\n    if (!errStr) return null;\n    // Surface the string-backed error as a plain Error (full typed errors are on\n    // lists; single-entity fetch only has string form in the graph).\n    return null;\n  };\n\n  return {\n    data: () => snapshot.data,\n    isLoading,\n    isRefetching,\n    error,\n    typedError,\n    refetch,\n    entityState: () => snapshot.entityState,\n  };\n}\n\n// ── Shallow equality helper for Zustand selector ─────────────────────────────\n\nfunction shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  if (a === b) return true;\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  for (const k of keysA) {\n    if (a[k] !== b[k]) return false;\n  }\n  return true;\n}\n","/**\n * createEntityList — SolidJS primitive for reactive normalized entity lists.\n *\n * Architecture:\n *   createEntityList  (this file, Layer 2)\n *     └─ core engine fetchList  (Layer 1 / transport)\n *          └─ graphStore  (Layer 0 / Zustand graph)\n *\n * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows\n * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.\n * Changing `queryKey()` re-serializes to a new list slot, triggering a fresh\n * fetch while keeping existing data visible (stale-while-revalidate).\n */\n\nimport { createEffect, onCleanup } from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  graphStore,\n  fetchList,\n  serializeKey,\n  getEngineOptions,\n  EMPTY_LIST_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityId, ListState } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityListOptions, CreateEntityListReturn } from \"./types\";\n\n// ── Internal store shape ──────────────────────────────────────────────────────\n\ninterface ListSlice<TEntity extends object> {\n  items: TEntity[];\n  listState: ListState;\n}\n\n// ── Equality helper for list subscription ────────────────────────────────────\n\nfunction listSliceEqual(\n  a: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n  b: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n): boolean {\n  return a.listState === b.listState && a.entityBucket === b.entityBucket;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for an entity list.\n *\n * - Subscribes to `graphStore` to mirror list state (ids + pagination)\n *   and resolves the entity rows by joining ids → graph entities on each read.\n * - Changing `queryKey()` triggers a new fetch and subscribes to the new list\n *   slot; the previous subscription is cleaned up automatically.\n * - Supports pagination (`fetchNextPage`) and imperative refetch.\n *\n * @example\n * ```tsx\n * const invoices = createEntityList({\n *   type: \"Invoice\",\n *   queryKey: () => [\"invoices\", { status: filter() }],\n *   fetch: (params) => api.getInvoices(params),\n *   normalize: (raw) => ({ id: raw.invoice_id, data: { ...raw } }),\n * });\n *\n * return (\n *   <For each={invoices.items()}>\n *     {(invoice) => <InvoiceRow invoice={invoice} />}\n *   </For>\n * );\n * ```\n */\nexport function createEntityList<TRaw, TEntity extends object>(\n  opts: CreateEntityListOptions<TRaw, TEntity>,\n): CreateEntityListReturn<TEntity> {\n  const {\n    type,\n    queryKey: queryKeyAccessor,\n    fetch,\n    normalize,\n    mode = \"replace\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Fine-grained Solid store ─────────────────────────────────────────────────\n  const [slice, setSlice] = createStore<ListSlice<TEntity>>({\n    items: [],\n    listState: { ...EMPTY_LIST_STATE },\n  });\n\n  // ── Helper: resolve items from current graph state for a given key ───────────\n  function resolveItems(key: string): TEntity[] {\n    const s = graphStore.getState();\n    const list = s.lists[key];\n    if (!list) return [];\n    return list.ids\n      .map((id: EntityId) => s.readEntity<TEntity>(type, id))\n      .filter((e): e is TEntity => e !== null);\n  }\n\n  // ── Initial / stale-while-revalidate fetch ────────────────────────────────────\n  // Declared before createEffect so it is always defined when the effect runs\n  // (the effect mock executes the callback synchronously in tests).\n  async function doInitialFetch(key: string): Promise<void> {\n    const s = graphStore.getState();\n    const listState = s.lists[key];\n    const effectiveStaleTime = staleTime ?? getEngineOptions().defaultStaleTime;\n    const age = Date.now() - (listState?.lastFetched ?? 0);\n    const isFresh = listState && !listState.stale && age < effectiveStaleTime;\n    if (isFresh) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode,\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Reactive effect: subscribe to graph whenever queryKey changes ─────────────\n  createEffect(() => {\n    const rawKey = queryKeyAccessor();\n    const key = serializeKey(rawKey);\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n\n    // Sync snapshot immediately with whatever is already in the graph.\n    const syncFromGraph = () => {\n      const s = graphStore.getState();\n      const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n      const items = resolveItems(key);\n      setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n      setSlice(\"items\", items);\n    };\n\n    syncFromGraph();\n\n    // Subscribe to any graph change that could affect this list.\n    // Solid's fine-grained update system means only changed fields propagate.\n    const unsub = graphStore.subscribe(\n      (s) => {\n        const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n        const entityBucket = s.entities[type];\n        return { listState, entityBucket };\n      },\n      ({ listState }) => {\n        const items = resolveItems(key);\n        setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n        setSlice(\"items\", items);\n      },\n      { equalityFn: listSliceEqual },\n    );\n\n    // Kick off the fetch when enabled and data may be stale.\n    if (enabled && (fetch || normalize)) {\n      void doInitialFetch(key);\n    }\n\n    onCleanup(() => {\n      unsub();\n    });\n  });\n\n  // ── fetchNextPage ─────────────────────────────────────────────────────────────\n  async function fetchNextPage(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    const s = graphStore.getState();\n    const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n    if (!listState.hasNextPage || listState.isFetchingMore) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"append\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      { cursor: listState.nextCursor ?? undefined },\n      getEngineOptions(),\n      true, // isLoadMore\n    );\n  }\n\n  // ── Imperative refetch ────────────────────────────────────────────────────────\n  async function refetch(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    graphStore.getState().setListStale(key, true);\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"replace\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Derived signals ───────────────────────────────────────────────────────────\n  const isLoading = () => slice.listState.isFetching && slice.items.length === 0;\n  const isLoadingMore = () => slice.listState.isFetchingMore;\n  const error = () => slice.listState.error;\n  const typedError = () => slice.listState.lastError;\n  const total = () => slice.listState.total;\n  const hasNextPage = () => slice.listState.hasNextPage;\n  const hasPrevPage = () => slice.listState.hasPrevPage;\n\n  return {\n    items: () => slice.items,\n    isLoading,\n    isLoadingMore,\n    error,\n    typedError,\n    total,\n    hasNextPage,\n    hasPrevPage,\n    fetchNextPage,\n    refetch,\n    listState: () => slice.listState,\n  };\n}\n","/**\n * createGraphStore — SolidJS fine-grained reactive bridge to the entire\n * Zustand entity graph.\n *\n * Consumers that need ad-hoc access to the graph outside `createEntity` /\n * `createEntityList` can use this to read any slice of `GraphState` as a\n * SolidJS signal. The subscription is scoped to only the selected slice,\n * so unrelated graph mutations do not trigger re-computations.\n *\n * @example\n * ```ts\n * // Read total entity count for a devtools panel.\n * const entityCount = createGraphStore(\n *   (s) => Object.keys(s.entities).reduce((n, t) => n + Object.keys(s.entities[t]).length, 0),\n * );\n * console.log(entityCount()); // reactive SolidJS accessor\n * ```\n */\n\nimport { createSignal, onCleanup } from \"solid-js\";\nimport { graphStore } from \"@prometheus-ags/entity-graph-core\";\nimport type { GraphState } from \"@prometheus-ags/entity-graph-core\";\n\n/**\n * Subscribe to a selector over the entity graph.\n * Returns a SolidJS accessor that updates whenever the selected slice changes.\n *\n * @param selector - Pure function that maps the full `GraphState` to a derived value.\n * @param equalityFn - Optional equality check (default: strict reference equality `===`).\n */\nexport function createGraphStore<T>(\n  selector: (state: GraphState) => T,\n  equalityFn?: (a: T, b: T) => boolean,\n): () => T {\n  const eq = equalityFn ?? ((a, b) => a === b);\n  const initial = selector(graphStore.getState());\n  const [value, setValue] = createSignal<T>(initial);\n\n  const unsub = graphStore.subscribe(\n    selector,\n    (next, prev) => {\n      if (!eq(next, prev)) {\n        setValue(() => next);\n      }\n    },\n  );\n\n  onCleanup(() => unsub());\n\n  return value;\n}\n","/**\n * GraphProvider utilities for SolidJS.\n *\n * Provides boot-time setup helpers for attaching global focus/reconnect\n * listeners and configuring the engine from within a SolidJS application root.\n *\n * Usage in the application root (e.g. `src/index.tsx`):\n *\n * ```ts\n * import { setupGraphProvider } from \"@prometheus-ags/entity-graph-solid\";\n * import { configureEngine, attachGlobalListeners } from \"@prometheus-ags/entity-graph-core\";\n *\n * setupGraphProvider({\n *   staleTime: 60_000,\n *   revalidateOnFocus: true,\n * });\n * ```\n */\n\nimport {\n  configureEngine,\n  attachGlobalListeners,\n  startGarbageCollector,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EngineOptions } from \"@prometheus-ags/entity-graph-core\";\n\nexport interface GraphProviderOptions extends EngineOptions {\n  /**\n   * Whether to attach window focus/online listeners for stale-while-revalidate.\n   * Defaults to `true` in browser environments.\n   */\n  attachListeners?: boolean;\n  /**\n   * Whether to start the periodic garbage collector.\n   * Defaults to `true`.\n   */\n  startGc?: boolean;\n}\n\n/**\n * Configures the entity-graph engine and wires browser-level listeners.\n * Call this once at application startup before mounting the root component.\n *\n * Returns a cleanup function that stops the GC interval (useful for tests).\n */\nexport function setupGraphProvider(opts: GraphProviderOptions = {}): () => void {\n  const { attachListeners = true, startGc = true, ...engineOpts } = opts;\n\n  if (Object.keys(engineOpts).length > 0) {\n    configureEngine(engineOpts);\n  }\n\n  if (attachListeners && typeof window !== \"undefined\") {\n    attachGlobalListeners();\n  }\n\n  let stopGc: (() => void) | undefined;\n  if (startGc && typeof window !== \"undefined\") {\n    stopGc = startGarbageCollector();\n  }\n\n  return () => stopGc?.();\n}\n"]}

package/package.json

@@ -1,31 +1,37 @@
 {
   "name": "@prometheus-ags/entity-graph-solid",
-  "version": "3.0.0-alpha.0",
+  "version": "3.0.1",
   "description": "SolidJS bindings for @prometheus-ags/entity-graph-core — fine-grained reactive entity and list primitives over the normalized entity graph.",
+  "author": "Travis James <travis@prometheus.dev>",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     }
   },
   "sideEffects": false,
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@prometheus-ags/entity-graph-core": "3.0.0-alpha.0"
-  },
   "peerDependencies": {
-    "solid-js": ">=1.8.0"
+    "solid-js": ">=1.8.0",
+    "@prometheus-ags/entity-graph-core": "^3.0.1"
   },
   "peerDependenciesMeta": {
     "solid-js": {
@@ -33,10 +39,11 @@
     }
   },
   "devDependencies": {
-    "solid-js": "^1.9.7",
-    "tsup": ">=8",
-    "typescript": ">=6",
-    "vitest": ">=4"
+    "solid-js": "^1.9.14",
+    "tsup": "8.5.1",
+    "typescript": "6.0.2",
+    "vitest": "4.1.10",
+    "@prometheus-ags/entity-graph-core": "3.0.1"
   },
   "keywords": [
     "solid",
@@ -47,9 +54,23 @@
     "reactive",
     "fine-grained-reactivity"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prometheus-ags/prometheus-entity-management.git",
+    "directory": "packages/entity-graph-solid"
+  },
+  "homepage": "https://github.com/prometheus-ags/prometheus-entity-management/tree/main/packages/entity-graph-solid#readme",
+  "bugs": {
+    "url": "https://github.com/prometheus-ags/prometheus-entity-management/issues"
+  },
+  "engines": {
+    "node": "^22.14.0 || ^24.0.0 || >=26.0.0"
+  },
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run"
+    "test": "vitest run",
+    "refresh:exports": "pnpm run build && node ../../scripts/refresh-exports-ledger.mjs --pkg solid",
+    "verify:skills": "node ../../scripts/verify-skills-exports.mjs --pkg solid"
   }
 }

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/create-entity.ts","../src/create-entity-list.ts","../src/create-graph-store.ts","../src/graph-provider.ts"],"names":["createStore","EMPTY_ENTITY_STATE","createResource","getEngineOptions","useGraphStore","fetchEntity","createEffect","registerSubscriber","onCleanup","unregisterSubscriber","createSignal","EMPTY_LIST_STATE","fetchList","serializeKey","configureEngine","attachGlobalListeners","startGarbageCollector"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * createEntity — SolidJS primitive that bridges a single entity to the\n * normalized entity graph via `createResource`.\n *\n * Architecture:\n *   createEntity  (this file, Layer 2)\n *     └─ core engine fetchEntity  (Layer 1 / transport)\n *          └─ useGraphStore  (Layer 0 / Zustand graph)\n *\n * SolidJS `createResource` owns the async lifecycle; the graph is the\n * single source of truth for the entity payload. Once fetchEntity writes to\n * the graph, a Zustand subscription (via `createStore`) propagates the merged\n * entity back to SolidJS as a fine-grained reactive signal.\n */\n\nimport {\n  createResource,\n  createSignal,\n  createEffect,\n  onCleanup,\n} from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  useGraphStore,\n  fetchEntity,\n  getEngineOptions,\n  registerSubscriber,\n  unregisterSubscriber,\n  EMPTY_ENTITY_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityState, EntityError } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityOptions, CreateEntityReturn } from \"./types\";\n\n// ── Internal snapshot shape kept in the Solid store ─────────────────────────\n\ninterface EntitySnapshot<TEntity extends object> {\n  data: TEntity | null;\n  entityState: EntityState;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for a single entity.\n *\n * - Uses `createResource` as the async driver so Suspense and ErrorBoundary\n *   boundaries work naturally.\n * - Subscribes to the Zustand graph with `useGraphStore.subscribe` and mirrors\n *   the merged entity into a `createStore`-backed signal for fine-grained\n *   SolidJS reactivity (only the changed field triggers updates).\n * - Registers / unregisters a subscriber token with the core engine so idle\n *   entities stop background revalidation when no components are observing them.\n *\n * @example\n * ```tsx\n * const invoice = createEntity({\n *   type: \"Invoice\",\n *   id: () => props.invoiceId,\n *   fetch: (id) => api.get(`/invoices/${id}`),\n *   normalize: (raw) => ({ ...raw, id: raw.invoice_id }),\n * });\n *\n * return (\n *   <Show when={!invoice.isLoading()} fallback={<Spinner />}>\n *     <p>{invoice.data()?.amount}</p>\n *   </Show>\n * );\n * ```\n */\nexport function createEntity<TRaw, TEntity extends object>(\n  opts: CreateEntityOptions<TRaw, TEntity>,\n): CreateEntityReturn<TEntity> {\n  const {\n    type,\n    id: idAccessor,\n    fetch,\n    normalize,\n    idField = \"id\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Reactive source for createResource ─────────────────────────────────────\n  // Returns [id, enabled] so resource re-fires when either changes.\n  const source = (): [string | null | undefined, boolean] => {\n    const id = idAccessor();\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n    return [id ?? null, enabled];\n  };\n\n  // ── Solid store: mirrors graph state for fine-grained reactivity ────────────\n  const [snapshot, setSnapshot] = createStore<EntitySnapshot<TEntity>>({\n    data: null,\n    entityState: { ...EMPTY_ENTITY_STATE },\n  });\n\n  // ── createResource: drives Suspense / ErrorBoundary + triggers fetches ──────\n  const [resource] = createResource(source, async ([id, enabled]) => {\n    if (!id || !enabled) return null;\n\n    const engineOpts = getEngineOptions();\n    const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;\n\n    // Check if cached data is fresh enough to skip a network round-trip.\n    const graphState = useGraphStore.getState();\n    const cachedEntityState = graphState.entityStates[`${type}:${id}`];\n    const cachedEntity = graphState.readEntity<TEntity>(type, id);\n    const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);\n\n    if (cachedEntity && age < effectiveStaleTime && !cachedEntityState?.stale) {\n      // Fresh cache hit: update snapshot and skip fetch.\n      setSnapshot(\"data\", cachedEntity);\n      setSnapshot(\"entityState\", (s) => ({ ...s, ...cachedEntityState }));\n      return cachedEntity;\n    }\n\n    // Delegate to core engine — handles dedup, retries, and graph writes.\n    await fetchEntity(\n      {\n        type,\n        id,\n        fetch,\n        normalize,\n        idField,\n        onSuccess,\n        onError,\n      },\n      { ...getEngineOptions(), defaultStaleTime: effectiveStaleTime },\n    );\n\n    // Return the graph value after the fetch completes.\n    return useGraphStore.getState().readEntity<TEntity>(type, id);\n  });\n\n  // ── Subscribe to Zustand graph for live fine-grained updates ───────────────\n  createEffect(() => {\n    const id = idAccessor();\n    if (!id) return;\n\n    const subKey = `${type}:${id}`;\n    const token = registerSubscriber(subKey);\n\n    // Sync initial graph state into the Solid store.\n    const syncFromGraph = () => {\n      const s = useGraphStore.getState();\n      const entity = s.readEntity<TEntity>(type, id);\n      const entityState = s.entityStates[subKey] ?? EMPTY_ENTITY_STATE;\n      setSnapshot(\"data\", entity);\n      setSnapshot(\"entityState\", (prev) => ({ ...prev, ...entityState }));\n    };\n\n    syncFromGraph();\n\n    // Subscribe to graph changes that affect this entity.\n    const unsub = useGraphStore.subscribe(\n      (s) => ({\n        entity: s.readEntity<TEntity>(type, id),\n        entityState: s.entityStates[subKey] ?? EMPTY_ENTITY_STATE,\n      }),\n      (next) => {\n        setSnapshot(\"data\", next.entity);\n        setSnapshot(\"entityState\", (prev) => ({ ...prev, ...next.entityState }));\n      },\n      { equalityFn: shallowEqual },\n    );\n\n    onCleanup(() => {\n      unsub();\n      unregisterSubscriber(subKey, token);\n    });\n  });\n\n  // ── Imperative refetch ──────────────────────────────────────────────────────\n  const [_refetchTrigger, setRefetchTrigger] = createSignal(0);\n\n  const refetch = async () => {\n    const id = idAccessor();\n    if (!id) return;\n    useGraphStore.getState().setEntityStale(type, id, true);\n    await fetchEntity(\n      { type, id, fetch, normalize, idField, onSuccess, onError },\n      getEngineOptions(),\n    );\n  };\n\n  // ── Derived signals ──────────────────────────────────────────────────────────\n  const isLoading = () => {\n    const res = resource();\n    const es = snapshot.entityState;\n    return resource.loading || (es.isFetching && snapshot.data === null);\n  };\n\n  const isRefetching = () => {\n    const es = snapshot.entityState;\n    return es.isFetching && snapshot.data !== null;\n  };\n\n  const error = () => snapshot.entityState.error;\n\n  // Typed error: pull from the graph's entityStates — the engine writes\n  // TerminalError / TransientError instances into listState.lastError for lists,\n  // and for single entities the error string is sufficient. We re-expose it as\n  // EntityError | null for API consistency (callers may cast if needed).\n  const typedError = (): EntityError | null => {\n    const errStr = snapshot.entityState.error;\n    if (!errStr) return null;\n    // Surface the string-backed error as a plain Error (full typed errors are on\n    // lists; single-entity fetch only has string form in the graph).\n    return null;\n  };\n\n  return {\n    data: () => snapshot.data,\n    isLoading,\n    isRefetching,\n    error,\n    typedError,\n    refetch,\n    entityState: () => snapshot.entityState,\n  };\n}\n\n// ── Shallow equality helper for Zustand selector ─────────────────────────────\n\nfunction shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  if (a === b) return true;\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  for (const k of keysA) {\n    if (a[k] !== b[k]) return false;\n  }\n  return true;\n}\n","/**\n * createEntityList — SolidJS primitive for reactive normalized entity lists.\n *\n * Architecture:\n *   createEntityList  (this file, Layer 2)\n *     └─ core engine fetchList  (Layer 1 / transport)\n *          └─ useGraphStore  (Layer 0 / Zustand graph)\n *\n * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows\n * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.\n * Changing `queryKey()` re-serializes to a new list slot, triggering a fresh\n * fetch while keeping existing data visible (stale-while-revalidate).\n */\n\nimport { createEffect, onCleanup } from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  useGraphStore,\n  fetchList,\n  serializeKey,\n  getEngineOptions,\n  EMPTY_LIST_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityId, ListState } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityListOptions, CreateEntityListReturn } from \"./types\";\n\n// ── Internal store shape ──────────────────────────────────────────────────────\n\ninterface ListSlice<TEntity extends object> {\n  items: TEntity[];\n  listState: ListState;\n}\n\n// ── Equality helper for list subscription ────────────────────────────────────\n\nfunction listSliceEqual(\n  a: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n  b: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n): boolean {\n  return a.listState === b.listState && a.entityBucket === b.entityBucket;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for an entity list.\n *\n * - Subscribes to `useGraphStore` to mirror list state (ids + pagination)\n *   and resolves the entity rows by joining ids → graph entities on each read.\n * - Changing `queryKey()` triggers a new fetch and subscribes to the new list\n *   slot; the previous subscription is cleaned up automatically.\n * - Supports pagination (`fetchNextPage`) and imperative refetch.\n *\n * @example\n * ```tsx\n * const invoices = createEntityList({\n *   type: \"Invoice\",\n *   queryKey: () => [\"invoices\", { status: filter() }],\n *   fetch: (params) => api.getInvoices(params),\n *   normalize: (raw) => ({ id: raw.invoice_id, data: { ...raw } }),\n * });\n *\n * return (\n *   <For each={invoices.items()}>\n *     {(invoice) => <InvoiceRow invoice={invoice} />}\n *   </For>\n * );\n * ```\n */\nexport function createEntityList<TRaw, TEntity extends object>(\n  opts: CreateEntityListOptions<TRaw, TEntity>,\n): CreateEntityListReturn<TEntity> {\n  const {\n    type,\n    queryKey: queryKeyAccessor,\n    fetch,\n    normalize,\n    mode = \"replace\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Fine-grained Solid store ─────────────────────────────────────────────────\n  const [slice, setSlice] = createStore<ListSlice<TEntity>>({\n    items: [],\n    listState: { ...EMPTY_LIST_STATE },\n  });\n\n  // ── Helper: resolve items from current graph state for a given key ───────────\n  function resolveItems(key: string): TEntity[] {\n    const s = useGraphStore.getState();\n    const list = s.lists[key];\n    if (!list) return [];\n    return list.ids\n      .map((id: EntityId) => s.readEntity<TEntity>(type, id))\n      .filter((e): e is TEntity => e !== null);\n  }\n\n  // ── Initial / stale-while-revalidate fetch ────────────────────────────────────\n  // Declared before createEffect so it is always defined when the effect runs\n  // (the effect mock executes the callback synchronously in tests).\n  async function doInitialFetch(key: string): Promise<void> {\n    const s = useGraphStore.getState();\n    const listState = s.lists[key];\n    const effectiveStaleTime = staleTime ?? getEngineOptions().defaultStaleTime;\n    const age = Date.now() - (listState?.lastFetched ?? 0);\n    const isFresh = listState && !listState.stale && age < effectiveStaleTime;\n    if (isFresh) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode,\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Reactive effect: subscribe to graph whenever queryKey changes ─────────────\n  createEffect(() => {\n    const rawKey = queryKeyAccessor();\n    const key = serializeKey(rawKey);\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n\n    // Sync snapshot immediately with whatever is already in the graph.\n    const syncFromGraph = () => {\n      const s = useGraphStore.getState();\n      const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n      const items = resolveItems(key);\n      setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n      setSlice(\"items\", items);\n    };\n\n    syncFromGraph();\n\n    // Subscribe to any graph change that could affect this list.\n    // Solid's fine-grained update system means only changed fields propagate.\n    const unsub = useGraphStore.subscribe(\n      (s) => {\n        const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n        const entityBucket = s.entities[type];\n        return { listState, entityBucket };\n      },\n      ({ listState }) => {\n        const items = resolveItems(key);\n        setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n        setSlice(\"items\", items);\n      },\n      { equalityFn: listSliceEqual },\n    );\n\n    // Kick off the fetch when enabled and data may be stale.\n    if (enabled && (fetch || normalize)) {\n      void doInitialFetch(key);\n    }\n\n    onCleanup(() => {\n      unsub();\n    });\n  });\n\n  // ── fetchNextPage ─────────────────────────────────────────────────────────────\n  async function fetchNextPage(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    const s = useGraphStore.getState();\n    const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n    if (!listState.hasNextPage || listState.isFetchingMore) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"append\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      { cursor: listState.nextCursor ?? undefined },\n      getEngineOptions(),\n      true, // isLoadMore\n    );\n  }\n\n  // ── Imperative refetch ────────────────────────────────────────────────────────\n  async function refetch(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    useGraphStore.getState().setListStale(key, true);\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"replace\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Derived signals ───────────────────────────────────────────────────────────\n  const isLoading = () => slice.listState.isFetching && slice.items.length === 0;\n  const isLoadingMore = () => slice.listState.isFetchingMore;\n  const error = () => slice.listState.error;\n  const typedError = () => slice.listState.lastError;\n  const total = () => slice.listState.total;\n  const hasNextPage = () => slice.listState.hasNextPage;\n  const hasPrevPage = () => slice.listState.hasPrevPage;\n\n  return {\n    items: () => slice.items,\n    isLoading,\n    isLoadingMore,\n    error,\n    typedError,\n    total,\n    hasNextPage,\n    hasPrevPage,\n    fetchNextPage,\n    refetch,\n    listState: () => slice.listState,\n  };\n}\n","/**\n * createGraphStore — SolidJS fine-grained reactive bridge to the entire\n * Zustand entity graph.\n *\n * Consumers that need ad-hoc access to the graph outside `createEntity` /\n * `createEntityList` can use this to read any slice of `GraphState` as a\n * SolidJS signal. The subscription is scoped to only the selected slice,\n * so unrelated graph mutations do not trigger re-computations.\n *\n * @example\n * ```ts\n * // Read total entity count for a devtools panel.\n * const entityCount = createGraphStore(\n *   (s) => Object.keys(s.entities).reduce((n, t) => n + Object.keys(s.entities[t]).length, 0),\n * );\n * console.log(entityCount()); // reactive SolidJS accessor\n * ```\n */\n\nimport { createSignal, onCleanup } from \"solid-js\";\nimport { useGraphStore } from \"@prometheus-ags/entity-graph-core\";\nimport type { GraphState } from \"@prometheus-ags/entity-graph-core\";\n\n/**\n * Subscribe to a selector over the entity graph.\n * Returns a SolidJS accessor that updates whenever the selected slice changes.\n *\n * @param selector - Pure function that maps the full `GraphState` to a derived value.\n * @param equalityFn - Optional equality check (default: strict reference equality `===`).\n */\nexport function createGraphStore<T>(\n  selector: (state: GraphState) => T,\n  equalityFn?: (a: T, b: T) => boolean,\n): () => T {\n  const eq = equalityFn ?? ((a, b) => a === b);\n  const initial = selector(useGraphStore.getState());\n  const [value, setValue] = createSignal<T>(initial);\n\n  const unsub = useGraphStore.subscribe(\n    selector,\n    (next, prev) => {\n      if (!eq(next, prev)) {\n        setValue(() => next);\n      }\n    },\n  );\n\n  onCleanup(() => unsub());\n\n  return value;\n}\n","/**\n * GraphProvider utilities for SolidJS.\n *\n * Provides boot-time setup helpers for attaching global focus/reconnect\n * listeners and configuring the engine from within a SolidJS application root.\n *\n * Usage in the application root (e.g. `src/index.tsx`):\n *\n * ```ts\n * import { setupGraphProvider } from \"@prometheus-ags/entity-graph-solid\";\n * import { configureEngine, attachGlobalListeners } from \"@prometheus-ags/entity-graph-core\";\n *\n * setupGraphProvider({\n *   staleTime: 60_000,\n *   revalidateOnFocus: true,\n * });\n * ```\n */\n\nimport {\n  configureEngine,\n  attachGlobalListeners,\n  startGarbageCollector,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EngineOptions } from \"@prometheus-ags/entity-graph-core\";\n\nexport interface GraphProviderOptions extends EngineOptions {\n  /**\n   * Whether to attach window focus/online listeners for stale-while-revalidate.\n   * Defaults to `true` in browser environments.\n   */\n  attachListeners?: boolean;\n  /**\n   * Whether to start the periodic garbage collector.\n   * Defaults to `true`.\n   */\n  startGc?: boolean;\n}\n\n/**\n * Configures the entity-graph engine and wires browser-level listeners.\n * Call this once at application startup before mounting the root component.\n *\n * Returns a cleanup function that stops the GC interval (useful for tests).\n */\nexport function setupGraphProvider(opts: GraphProviderOptions = {}): () => void {\n  const { attachListeners = true, startGc = true, ...engineOpts } = opts;\n\n  if (Object.keys(engineOpts).length > 0) {\n    configureEngine(engineOpts);\n  }\n\n  if (attachListeners && typeof window !== \"undefined\") {\n    attachGlobalListeners();\n  }\n\n  let stopGc: (() => void) | undefined;\n  if (startGc && typeof window !== \"undefined\") {\n    stopGc = startGarbageCollector();\n  }\n\n  return () => stopGc?.();\n}\n"]}