@the_library/public 1.0.0

package/dist/models/solid.d.ts

@@ -0,0 +1,73 @@
+import * as solid_js from 'solid-js';
+import { L as LevelState } from '../level-state-J3pj64Tr.js';
+import { S as SessionBootstrapOptions } from '../session-vqOnyxga.js';
+export { r as resetModelsV2Session } from '../session-vqOnyxga.js';
+import { O as Orm } from '../orm-BvkX0aBT.js';
+
+/**
+ * **Composes** the Solid.js reactivity system into the models_v2 record tracker
+ * (does not replace other frameworks' systems — see `addReactivitySystem`).
+ * Each tracked ORM record maps to a Solid signal in a `WeakMap`, so a read
+ * inside a reactive scope subscribes and a mutation (`record.patch()` /
+ * generated setters) triggers a fine-grained update. Signals are created in a
+ * detached `createRoot` so they survive component unmount / navigation.
+ *
+ * Idempotent — repeated calls (e.g. per `astro:after-swap`) keep the single
+ * registration. Returns an unregister function.
+ */
+declare const installSolidReactivity: () => (() => void);
+/**
+ * Establishes a **persistent models_v2 session** for Solid — the full front-end
+ * data load (resolve sidecars → worker → `hydrateAll` → replay) plus Solid
+ * reactivity, retained across every live URL navigation.
+ *
+ * Thin wrapper over the shared `bootstrapSession()` glue (worker boot, once-only
+ * promise, Astro `<ClientRouter />` persistence) with Solid's reactivity
+ * installer injected — the same one-call entry exists in the vue/react adapters.
+ *
+ * @example
+ * import { Book, Tag, Person, NewBookWithId, NewTagWithId, NewPersonWithId } from '@the_library/public/models/models';
+ * await bootstrapModelsV2({
+ *   models: [
+ *     { type: Book.type,   create: NewBookWithId },
+ *     { type: Tag.type,    create: NewTagWithId },
+ *     { type: Person.type, create: NewPersonWithId },
+ *   ],
+ *   localMode: '/corpus_v2',        // dev: serve bin/ + corpus-index.json locally
+ *   // registry: { dataBlock },     // prod: resolve Arweave TX-ids from registry_v2
+ *   selectedLangs: ['eng'],
+ * });
+ */
+declare const bootstrapModelsV2: (opts: SessionBootstrapOptions) => Promise<void>;
+/**
+ * Returns a Solid signal accessor for the given username's LevelState.
+ * The signal updates whenever that user's level changes.
+ *
+ * @example
+ * const level = useLevel('mine');
+ * return <div>{level().level}</div>;
+ */
+declare const useLevel: (username: string) => solid_js.Accessor<LevelState>;
+/**
+ * Solid signal accessor over the global trash store (models/trash.ts) for one
+ * object type, merged across `usernames` (empty = every known username).
+ * Population and live updates are entirely automatic — nothing to register,
+ * nothing to feed it.
+ *
+ * @example
+ * const { count, getIds } = useTrash(Tag.type, ['mine']);
+ * return <span>{count()}</span>;
+ */
+declare const useTrash: (objectType: number, usernames?: string[]) => {
+    count: solid_js.Accessor<number>;
+    getIds: () => number[];
+};
+
+declare const useDraft: <T extends Orm>(model: () => T) => {
+    draft: solid_js.Accessor<T>;
+    isDirty: () => boolean;
+    commit: () => void;
+    rollback: () => void;
+};
+
+export { bootstrapModelsV2, installSolidReactivity, useDraft, useLevel, useTrash };

package/dist/models/solid.js

@@ -0,0 +1,95 @@
+import {
+  commitDraft,
+  createDraft,
+  isDraftDirty,
+  rollbackDraft
+} from "../chunk-OEZK7IX7.js";
+import {
+  bootstrapSession,
+  resetModelsV2Session
+} from "../chunk-2HFOWE5R.js";
+import {
+  getLevel,
+  subscribeLevel
+} from "../chunk-4CWVFPBN.js";
+import {
+  trashStore
+} from "../chunk-Y7RS6RTM.js";
+import {
+  addReactivitySystem
+} from "../chunk-JDUYLUDJ.js";
+import "../chunk-ZEZGI2TP.js";
+
+// src/models/adapters/solid.ts
+import { createSignal, onCleanup, createRoot } from "solid-js";
+import { createMemo } from "solid-js";
+var _solidUnregister = null;
+var installSolidReactivity = () => {
+  if (_solidUnregister) return _solidUnregister;
+  const signals = /* @__PURE__ */ new WeakMap();
+  const system = {
+    track(o) {
+      let s = signals.get(o);
+      if (!s) {
+        s = createRoot(() => {
+          const [get, set] = createSignal(0);
+          return { get, set };
+        });
+        signals.set(o, s);
+      }
+      s.get();
+    },
+    trigger(o) {
+      const s = signals.get(o);
+      if (s) s.set(s.get() + 1);
+    }
+  };
+  _solidUnregister = addReactivitySystem(system);
+  return _solidUnregister;
+};
+var bootstrapModelsV2 = (opts) => bootstrapSession(opts, installSolidReactivity);
+var useLevel = (username) => {
+  const [state, setState] = createSignal(getLevel(username));
+  const unsub = subscribeLevel((u) => {
+    if (u === username) setState(getLevel(username));
+  });
+  onCleanup(unsub);
+  return state;
+};
+var useTrash = (objectType, usernames = []) => {
+  const [count, setCount] = createSignal(trashStore.count(objectType, usernames));
+  const unsub = trashStore.subscribe(objectType, () => setCount(trashStore.count(objectType, usernames)));
+  onCleanup(unsub);
+  return {
+    count,
+    getIds: () => trashStore.list(objectType, usernames)
+  };
+};
+var useDraft = (model) => {
+  const [tick, setTick] = createSignal(0);
+  const draft = createMemo(() => createDraft(model(), () => setTick((t) => t + 1)));
+  return {
+    draft,
+    isDirty: () => {
+      tick();
+      return isDraftDirty(draft());
+    },
+    commit: () => {
+      commitDraft(draft());
+      setTick((t) => t + 1);
+    },
+    rollback: () => {
+      rollbackDraft(draft());
+      setTick((t) => t + 1);
+    }
+  };
+};
+export {
+  bootstrapModelsV2,
+  installSolidReactivity,
+  resetModelsV2Session,
+  useDraft,
+  useLevel,
+  useTrash
+};
+//# sourceMappingURL=solid.js.map

package/dist/models/solid.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/models/adapters/solid.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAcA,SAAS,cAAc,WAAW,kBAAkB;AA2GpD,SAAS,kBAAkB;AAnG3B,IAAI,mBAAwC;AAarC,IAAM,yBAAyB,MAAoB;AACtD,MAAI,iBAAkB,QAAO;AAC7B,QAAM,UAAU,oBAAI,QAAiE;AACrF,QAAM,SAA2B;AAAA,IAC7B,MAAM,GAAW;AACb,UAAI,IAAI,QAAQ,IAAI,CAAC;AACrB,UAAI,CAAC,GAAG;AAEJ,YAAI,WAAW,MAAM;AAAE,gBAAM,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC;AAAG,iBAAO,EAAE,KAAK,IAAI;AAAA,QAAG,CAAC;AACjF,gBAAQ,IAAI,GAAG,CAAC;AAAA,MACpB;AACA,QAAE,IAAI;AAAA,IACV;AAAA,IACA,QAAQ,GAAW;AACf,YAAM,IAAI,QAAQ,IAAI,CAAC;AACvB,UAAI,EAAG,GAAE,IAAI,EAAE,IAAI,IAAI,CAAC;AAAA,IAC5B;AAAA,EACJ;AACA,qBAAmB,oBAAoB,MAAM;AAC7C,SAAO;AACX;AAwBO,IAAM,oBAAoB,CAAC,SAC9B,iBAAiB,MAAM,sBAAsB;AAU1C,IAAM,WAAW,CAAC,aAAqB;AAC1C,QAAM,CAAC,OAAO,QAAQ,IAAI,aAAa,SAAS,QAAQ,CAAC;AACzD,QAAM,QAAQ,eAAe,OAAK;AAAE,QAAI,MAAM,SAAU,UAAS,SAAS,QAAQ,CAAC;AAAA,EAAG,CAAC;AACvF,YAAU,KAAK;AACf,SAAO;AACX;AAYO,IAAM,WAAW,CAAC,YAAoB,YAAsB,CAAC,MAAM;AACtE,QAAM,CAAC,OAAO,QAAQ,IAAI,aAAa,WAAW,MAAM,YAAY,SAAS,CAAC;AAC9E,QAAM,QAAQ,WAAW,UAAU,YAAY,MAAM,SAAS,WAAW,MAAM,YAAY,SAAS,CAAC,CAAC;AACtG,YAAU,KAAK;AACf,SAAO;AAAA,IACH;AAAA,IACA,QAAQ,MAAM,WAAW,KAAK,YAAY,SAAS;AAAA,EACvD;AACJ;AAUO,IAAM,WAAW,CAAgB,UAAmB;AACvD,QAAM,CAAC,MAAM,OAAO,IAAI,aAAa,CAAC;AAEtC,QAAM,QAAQ,WAAW,MAAM,YAAY,MAAM,GAAG,MAAM,QAAQ,OAAK,IAAI,CAAC,CAAC,CAAC;AAE9E,SAAO;AAAA,IACH;AAAA,IACA,SAAS,MAAM;AACX,WAAK;AACL,aAAO,aAAa,MAAM,CAAC;AAAA,IAC/B;AAAA,IACA,QAAQ,MAAM;AACV,kBAAY,MAAM,CAAC;AACnB,cAAQ,OAAK,IAAI,CAAC;AAAA,IACtB;AAAA,IACA,UAAU,MAAM;AACZ,oBAAc,MAAM,CAAC;AACrB,cAAQ,OAAK,IAAI,CAAC;AAAA,IACtB;AAAA,EACJ;AACJ;","names":[]}

package/dist/models/vue.d.ts

@@ -0,0 +1,51 @@
+import * as vue from 'vue';
+import { Ref } from 'vue';
+import { L as LevelState } from '../level-state-J3pj64Tr.js';
+import { S as SessionBootstrapOptions } from '../session-vqOnyxga.js';
+export { r as resetModelsV2Session } from '../session-vqOnyxga.js';
+import { O as Orm } from '../orm-BvkX0aBT.js';
+
+/**
+ * **Composes** the Vue 3 reactivity system into the models_v2 record tracker
+ * (coexists with other frameworks — see `addReactivitySystem`). Each tracked
+ * ORM record maps to a `shallowRef` in a `WeakMap`; a read inside a reactive
+ * effect subscribes and a mutation bumps the ref. Idempotent; returns an
+ * unregister function.
+ */
+declare const installVueReactivity: () => (() => void);
+/**
+ * Persistent models_v2 session for Vue — full front-end boot + Vue reactivity,
+ * retained across URL navigation (SPA / Astro `<ClientRouter />`). Thin wrapper
+ * over the shared `bootstrapSession()` glue with Vue's reactivity installer.
+ */
+declare const bootstrapModelsV2: (opts: SessionBootstrapOptions) => Promise<void>;
+/**
+ * Returns a Vue computed ref that updates whenever the given user's level changes.
+ * Automatically unsubscribes when the calling component is unmounted.
+ *
+ * @example
+ * const { level, progress } = useLevel('mine').value;
+ */
+declare const useLevel: (username: string) => vue.ComputedRef<LevelState>;
+/**
+ * Reactive view over the global trash store (models/trash.ts) for one object
+ * type, merged across `usernames` (empty = every known username). Population
+ * and live updates are entirely automatic (boot scan + reactivity-system hook
+ * inside trash.ts) — nothing to register, nothing to feed it.
+ *
+ * @example
+ * const { count, getIds } = useTrash(Tag.type, ['mine']);
+ */
+declare const useTrash: (objectType: number, usernames?: string[]) => {
+    count: vue.ComputedRef<number>;
+    getIds: () => number[];
+};
+
+declare const useDraft: <T extends Orm>(model: Ref<T> | (() => T)) => {
+    draft: vue.ComputedRef<T>;
+    isDirty: vue.ComputedRef<boolean>;
+    commit: () => void;
+    rollback: () => void;
+};
+
+export { bootstrapModelsV2, installVueReactivity, useDraft, useLevel, useTrash };

package/dist/models/vue.js

@@ -0,0 +1,98 @@
+import {
+  commitDraft,
+  createDraft,
+  isDraftDirty,
+  rollbackDraft
+} from "../chunk-OEZK7IX7.js";
+import {
+  bootstrapSession,
+  resetModelsV2Session
+} from "../chunk-2HFOWE5R.js";
+import {
+  getLevel,
+  subscribeLevel
+} from "../chunk-4CWVFPBN.js";
+import {
+  trashStore
+} from "../chunk-Y7RS6RTM.js";
+import {
+  addReactivitySystem
+} from "../chunk-JDUYLUDJ.js";
+import "../chunk-ZEZGI2TP.js";
+
+// src/models/adapters/vue.ts
+import { computed, onUnmounted, shallowRef } from "vue";
+var _vueUnregister = null;
+var installVueReactivity = () => {
+  if (_vueUnregister) return _vueUnregister;
+  const refs = /* @__PURE__ */ new WeakMap();
+  const system = {
+    track(o) {
+      let r = refs.get(o);
+      if (!r) {
+        r = shallowRef(0);
+        refs.set(o, r);
+      }
+      void r.value;
+    },
+    trigger(o) {
+      const r = refs.get(o);
+      if (r) r.value++;
+    }
+  };
+  _vueUnregister = addReactivitySystem(system);
+  return _vueUnregister;
+};
+var bootstrapModelsV2 = (opts) => bootstrapSession(opts, installVueReactivity);
+var useLevel = (username) => {
+  const tick = shallowRef(0);
+  const unsub = subscribeLevel((u) => {
+    if (u === username) tick.value++;
+  });
+  onUnmounted(unsub);
+  return computed(() => (tick.value, getLevel(username)));
+};
+var useTrash = (objectType, usernames = []) => {
+  const tick = shallowRef(0);
+  const unsub = trashStore.subscribe(objectType, () => {
+    tick.value++;
+  });
+  onUnmounted(unsub);
+  return {
+    count: computed(() => (tick.value, trashStore.count(objectType, usernames))),
+    getIds: () => trashStore.list(objectType, usernames)
+  };
+};
+var useDraft = (model) => {
+  const tick = shallowRef(0);
+  const draft = computed(() => {
+    const m = typeof model === "function" ? model() : model.value;
+    return createDraft(m, () => {
+      tick.value++;
+    });
+  });
+  return {
+    draft,
+    isDirty: computed(() => {
+      void tick.value;
+      return isDraftDirty(draft.value);
+    }),
+    commit: () => {
+      commitDraft(draft.value);
+      tick.value++;
+    },
+    rollback: () => {
+      rollbackDraft(draft.value);
+      tick.value++;
+    }
+  };
+};
+export {
+  bootstrapModelsV2,
+  installVueReactivity,
+  resetModelsV2Session,
+  useDraft,
+  useLevel,
+  useTrash
+};
+//# sourceMappingURL=vue.js.map

package/dist/models/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/models/adapters/vue.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAcA,SAAS,UAAU,aAAa,kBAAkB;AAOlD,IAAI,iBAAsC;AASnC,IAAM,uBAAuB,MAAoB;AACpD,MAAI,eAAgB,QAAO;AAC3B,QAAM,OAAO,oBAAI,QAAmC;AACpD,QAAM,SAA2B;AAAA,IAC7B,MAAM,GAAW;AACb,UAAI,IAAI,KAAK,IAAI,CAAC;AAClB,UAAI,CAAC,GAAG;AAAE,YAAI,WAAW,CAAC;AAAG,aAAK,IAAI,GAAG,CAAC;AAAA,MAAG;AAC7C,WAAK,EAAE;AAAA,IACX;AAAA,IACA,QAAQ,GAAW;AACf,YAAM,IAAI,KAAK,IAAI,CAAC;AACpB,UAAI,EAAG,GAAE;AAAA,IACb;AAAA,EACJ;AACA,mBAAiB,oBAAoB,MAAM;AAC3C,SAAO;AACX;AAOO,IAAM,oBAAoB,CAAC,SAC9B,iBAAiB,MAAM,oBAAoB;AASxC,IAAM,WAAW,CAAC,aAAqB;AAC1C,QAAM,OAAO,WAAW,CAAC;AACzB,QAAM,QAAQ,eAAe,OAAK;AAAE,QAAI,MAAM,SAAU,MAAK;AAAA,EAAS,CAAC;AACvE,cAAY,KAAK;AACjB,SAAO,SAAS,OAAO,KAAK,OAAO,SAAS,QAAQ,EAAE;AAC1D;AAWO,IAAM,WAAW,CAAC,YAAoB,YAAsB,CAAC,MAAM;AACtE,QAAM,OAAO,WAAW,CAAC;AACzB,QAAM,QAAQ,WAAW,UAAU,YAAY,MAAM;AAAE,SAAK;AAAA,EAAS,CAAC;AACtE,cAAY,KAAK;AACjB,SAAO;AAAA,IACH,OAAO,SAAS,OAAO,KAAK,OAAO,WAAW,MAAM,YAAY,SAAS,EAAE;AAAA,IAC3E,QAAQ,MAAM,WAAW,KAAK,YAAY,SAAS;AAAA,EACvD;AACJ;AAUO,IAAM,WAAW,CAAgB,UAA8B;AAClE,QAAM,OAAO,WAAW,CAAC;AAEzB,QAAM,QAAQ,SAAS,MAAM;AACzB,UAAM,IAAI,OAAO,UAAU,aAAa,MAAM,IAAI,MAAM;AACxD,WAAO,YAAY,GAAG,MAAM;AAAE,WAAK;AAAA,IAAS,CAAC;AAAA,EACjD,CAAC;AAED,SAAO;AAAA,IACH;AAAA,IACA,SAAS,SAAS,MAAM;AACpB,WAAK,KAAK;AACV,aAAO,aAAa,MAAM,KAAK;AAAA,IACnC,CAAC;AAAA,IACD,QAAQ,MAAM;AACV,kBAAY,MAAM,KAAK;AACvB,WAAK;AAAA,IACT;AAAA,IACA,UAAU,MAAM;AACZ,oBAAc,MAAM,KAAK;AACzB,WAAK;AAAA,IACT;AAAA,EACJ;AACJ;","names":[]}