@plitzi/nexus 0.32.0 → 0.32.2

package/dist/react/index.d.ts

@@ -0,0 +1,17 @@
+export { default as StoreProvider, StoreContext, StoreRegistryContext } from './StoreProvider';
+export { findStoreInRegistry } from './StoreContext';
+export { createStoreHook } from './createStoreHook';
+export { default as useStore, defaultMultiEqualityFn } from './hooks/useStore';
+export { default as useStoreById } from './hooks/useStoreById';
+export { default as useStoreGetter } from './hooks/useStoreGetter';
+export { default as useStoreSetter } from './hooks/useStoreSetter';
+export { default as useStoreSync } from './hooks/useStoreSync';
+export { useAsync } from './hooks/useAsync';
+export { useAsyncValue } from './hooks/useAsyncValue';
+export { useDerived } from './hooks/useDerived';
+export { useStoreHistory } from './hooks/useStoreHistory';
+export { useEntity, useEntityOne, useEntityIds, useEntityAll } from './hooks/useEntity';
+export { default as useIsomorphicLayoutEffect } from './useIsomorphicLayoutEffect';
+export type { StoreProviderProps } from './StoreProvider';
+export type { StoreRegistry } from './StoreContext';
+export type { UseStoreHistoryReturn } from './hooks/useStoreHistory';

package/dist/react/index.mjs

@@ -0,0 +1,16 @@
+import { StoreContext as e, StoreRegistryContext as t, findStoreInRegistry as n } from "./StoreContext.mjs";
+import { defaultMultiEqualityFn as r } from "./hooks/shared.mjs";
+import i from "./useIsomorphicLayoutEffect.mjs";
+import a from "./hooks/useStoreSync.mjs";
+import o from "./StoreProvider.mjs";
+import s from "./hooks/useStore.mjs";
+import c from "./hooks/useStoreGetter.mjs";
+import l from "./hooks/useStoreSetter.mjs";
+import { createStoreHook as u } from "./createStoreHook.mjs";
+import d from "./hooks/useStoreById.mjs";
+import { useAsync as f } from "./hooks/useAsync.mjs";
+import { useAsyncValue as p } from "./hooks/useAsyncValue.mjs";
+import { useDerived as m } from "./hooks/useDerived.mjs";
+import { useStoreHistory as h } from "./hooks/useStoreHistory.mjs";
+import { useEntity as g, useEntityAll as _, useEntityIds as v, useEntityOne as y } from "./hooks/useEntity.mjs";
+export { e as StoreContext, o as StoreProvider, t as StoreRegistryContext, u as createStoreHook, r as defaultMultiEqualityFn, n as findStoreInRegistry, f as useAsync, p as useAsyncValue, m as useDerived, g as useEntity, _ as useEntityAll, v as useEntityIds, y as useEntityOne, i as useIsomorphicLayoutEffect, s as useStore, d as useStoreById, c as useStoreGetter, h as useStoreHistory, l as useStoreSetter, a as useStoreSync };

package/dist/{helpers → react}/useIsomorphicLayoutEffect.mjs

@@ -1,5 +1,5 @@
 import { useEffect as e, useLayoutEffect as t } from "react";
-//#region src/helpers/useIsomorphicLayoutEffect.ts
+//#region src/react/useIsomorphicLayoutEffect.ts
 var n = typeof window < "u" ? t : e;
 //#endregion
 export { n as default };

package/dist/types/StoreTypes.d.ts

@@ -27,6 +27,8 @@ export type StoreChange<T> = {
     path: PathOf<T> | undefined;
     prev: T;
     next: T;
+    prevValue: unknown;
+    nextValue: unknown;
 };
 export type ChangeListener<T> = (change: StoreChange<T>) => void;
 export declare const CANCEL: unique symbol;
@@ -74,12 +76,31 @@ export type BoundStore<TBase> = {
     setState: SetFromBaseFn<TBase>;
     subscribe: (listener: Listener) => () => void;
     subscribePath: TBase extends object ? <SubP extends PathOf<TBase>>(subPath: SubP, listener: Listener) => () => void : (listener: Listener) => () => void;
+    get: TBase extends object ? {
+        (): TBase | undefined;
+        <SubP extends PathOf<TBase>>(subPath: SubP): PathValue<TBase, SubP> | undefined;
+    } : () => TBase | undefined;
+    set: SetFromBaseFn<TBase>;
+    watch: TBase extends object ? {
+        (listener: Listener): () => void;
+        <SubP extends PathOf<TBase>>(subPath: SubP, listener: Listener): () => void;
+    } : (listener: Listener) => () => void;
 };
 export type StoreApi<T> = {
     id?: string;
+    scopePath?: string;
     getState: GetState<T>;
     getPath: <P extends PathOf<T>>(path: P) => PathValue<T, P> | undefined;
     setState: SetState<T>;
+    get: {
+        (): T;
+        <P extends PathOf<T>>(path: P): PathValue<T, P> | undefined;
+    };
+    set: SetState<T>;
+    watch: {
+        (listener: Listener): () => void;
+        <P extends PathOf<T>>(path: P, listener: Listener): () => void;
+    };
     withBase: <P extends PathOf<T>>(basePath: P) => BoundStore<NonNullable<PathValue<T, P>>>;
     batch: <R>(fn: () => R) => R;
     subscribe: (listener: Listener) => () => void;

package/dist/vue/index.d.ts

@@ -0,0 +1,8 @@
+export { provideStore, injectStore } from './injection';
+export { useStore, useStoreValue, createStoreComposable } from './useStore';
+export { useEntity, useEntityOne, useEntityIds, useEntityAll } from './useEntity';
+export { useDerived } from './useDerived';
+export { useAsync } from './useAsync';
+export { useStoreHistory } from './useStoreHistory';
+export type { UseStoreOptions } from './useStore';
+export type { UseStoreHistoryReturn } from './useStoreHistory';

package/dist/vue/index.mjs

@@ -0,0 +1,7 @@
+import { injectStore as e, provideStore as t } from "./injection.mjs";
+import { createStoreComposable as n, useStore as r, useStoreValue as i } from "./useStore.mjs";
+import { useEntity as a, useEntityAll as o, useEntityIds as s, useEntityOne as c } from "./useEntity.mjs";
+import { useDerived as l } from "./useDerived.mjs";
+import { useAsync as u } from "./useAsync.mjs";
+import { useStoreHistory as d } from "./useStoreHistory.mjs";
+export { n as createStoreComposable, e as injectStore, t as provideStore, u as useAsync, l as useDerived, a as useEntity, o as useEntityAll, s as useEntityIds, c as useEntityOne, r as useStore, d as useStoreHistory, i as useStoreValue };

package/dist/vue/injection.d.ts

@@ -0,0 +1,3 @@
+import { StoreApi } from '../types';
+export declare function provideStore<TState extends object>(store: StoreApi<TState>): void;
+export declare function injectStore<TState extends object>(): StoreApi<TState>;

package/dist/vue/injection.mjs

@@ -0,0 +1,13 @@
+import { inject as e, provide as t } from "vue";
+//#region src/vue/injection.ts
+var n = Symbol("@plitzi/nexus/vue/store");
+function r(e) {
+	t(n, e);
+}
+function i() {
+	let t = e(n);
+	if (!t) throw Error("@plitzi/nexus/vue: no store provided. Call provideStore(store) in a parent component, or pass { store } to the composable.");
+	return t;
+}
+//#endregion
+export { i as injectStore, r as provideStore };

package/dist/vue/useAsync.d.ts

@@ -0,0 +1,3 @@
+import { AsyncResource, AsyncSnapshot } from '../async/createAsync';
+import { Ref } from 'vue';
+export declare function useAsync<T, Args extends readonly unknown[]>(resource: AsyncResource<T, Args>): Ref<AsyncSnapshot<T>>;

package/dist/vue/useAsync.mjs

@@ -0,0 +1,10 @@
+import { onScopeDispose as e, shallowRef as t } from "vue";
+//#region src/vue/useAsync.ts
+function n(n) {
+	let r = t(n.get());
+	return e(n.subscribe(() => {
+		r.value = n.get();
+	})), r;
+}
+//#endregion
+export { n as useAsync };

package/dist/vue/useDerived.d.ts

@@ -0,0 +1,3 @@
+import { Derived } from '../derived/createDerived';
+import { Ref } from 'vue';
+export declare function useDerived<R>(derived: Derived<R>): Ref<R>;

package/dist/vue/useDerived.mjs

@@ -0,0 +1,10 @@
+import { onScopeDispose as e, shallowRef as t } from "vue";
+//#region src/vue/useDerived.ts
+function n(n) {
+	let r = t(n.get());
+	return e(n.subscribe(() => {
+		r.value = n.get();
+	})), r;
+}
+//#endregion
+export { n as useDerived };

package/dist/vue/useEntity.d.ts

@@ -0,0 +1,11 @@
+import { EntityId } from '../entities/createEntityAdapter';
+import { EntityStore } from '../entities/createEntityStore';
+import { Ref } from 'vue';
+export declare function useEntityOne<T>(store: EntityStore<T>, id: EntityId): Ref<T | undefined>;
+export declare function useEntityIds<T>(store: EntityStore<T>): Ref<string[]>;
+export declare function useEntityAll<T>(store: EntityStore<T>): Ref<T[]>;
+export declare function useEntity<T>(store: EntityStore<T>): {
+    useOne: (id: EntityId) => Ref<T | undefined, T | undefined>;
+    useIds: () => Ref<string[], string[]>;
+    useAll: () => Ref<T[], T[]>;
+};

package/dist/vue/useEntity.mjs

@@ -0,0 +1,29 @@
+import { onScopeDispose as e, shallowRef as t } from "vue";
+//#region src/vue/useEntity.ts
+function n(n, r) {
+	let i = String(r), a = t(n.getOne(i));
+	return e(n.subscribeOne(i, () => {
+		a.value = n.getOne(i);
+	})), a;
+}
+function r(n) {
+	let r = t(n.getIds());
+	return e(n.subscribeIds(() => {
+		r.value = n.getIds();
+	})), r;
+}
+function i(n) {
+	let r = t(n.getAll());
+	return e(n.subscribeAll(() => {
+		r.value = n.getAll();
+	})), r;
+}
+function a(e) {
+	return {
+		useOne: (t) => n(e, t),
+		useIds: () => r(e),
+		useAll: () => i(e)
+	};
+}
+//#endregion
+export { a as useEntity, i as useEntityAll, r as useEntityIds, n as useEntityOne };

package/dist/vue/useStore.d.ts

@@ -0,0 +1,13 @@
+import { PathOf, PathValue, StoreApi } from '../types';
+import { Ref, WritableComputedRef } from 'vue';
+export type UseStoreOptions<TState extends object> = {
+    store?: StoreApi<TState>;
+};
+export declare function useStoreValue<TState extends object>(options?: UseStoreOptions<TState>): Ref<TState>;
+export declare function useStoreValue<TState extends object, P extends PathOf<TState>>(path: P, options?: UseStoreOptions<TState>): Ref<PathValue<TState, P> | undefined>;
+export declare function useStore<TState extends object, P extends PathOf<TState>>(path: P, options?: UseStoreOptions<TState>): WritableComputedRef<PathValue<TState, P> | undefined>;
+export declare function createStoreComposable<TState extends object>(): {
+    useStore: <P extends PathOf<TState>>(path: P, options?: UseStoreOptions<TState>) => WritableComputedRef<PathValue<TState, P> | undefined, PathValue<TState, P> | undefined>;
+    useStoreValue: <P extends PathOf<TState>>(path: P, options?: UseStoreOptions<TState>) => Ref<PathValue<TState, P> | undefined, PathValue<TState, P> | undefined>;
+    useStoreState: (options?: UseStoreOptions<TState>) => Ref<TState, TState>;
+};

package/dist/vue/useStore.mjs

@@ -0,0 +1,31 @@
+import { injectStore as e } from "./injection.mjs";
+import { computed as t, onScopeDispose as n, shallowRef as r } from "vue";
+//#region src/vue/useStore.ts
+function i(e, t) {
+	let i = () => t === void 0 ? e.getState() : e.getPath(t), a = r(i());
+	return n(t === void 0 ? e.subscribe(() => {
+		a.value = i();
+	}) : e.subscribePath(t, () => {
+		a.value = i();
+	})), a;
+}
+function a(t, n) {
+	let r = typeof t == "string", a = r ? t : void 0;
+	return i(((r ? n : t) ?? {}).store ?? e(), a);
+}
+function o(n, r) {
+	let i = r?.store ?? e(), o = a(n, { store: i });
+	return t({
+		get: () => o.value,
+		set: (e) => i.set(n, e)
+	});
+}
+function s() {
+	return {
+		useStore: (e, t) => o(e, t),
+		useStoreValue: (e, t) => a(e, t),
+		useStoreState: (e) => a(e)
+	};
+}
+//#endregion
+export { s as createStoreComposable, o as useStore, a as useStoreValue };

package/dist/vue/useStoreHistory.d.ts

@@ -0,0 +1,12 @@
+import { HistorySnapshot } from '../middleware/historyMiddleware';
+import { StoreApi } from '../types';
+import { ComputedRef } from 'vue';
+export type UseStoreHistoryReturn<TState> = HistorySnapshot<TState> & {
+    undo: () => void;
+    redo: () => void;
+    travelTo: (index: number) => void;
+    clear: () => void;
+};
+export declare function useStoreHistory<TState extends object>(options?: {
+    store?: StoreApi<TState>;
+}): ComputedRef<UseStoreHistoryReturn<TState>>;

package/dist/vue/useStoreHistory.mjs

@@ -0,0 +1,33 @@
+import { getStoreHistory as e } from "../middleware/historyMiddleware.mjs";
+import { isProd as t } from "../env.mjs";
+import { injectStore as n } from "./injection.mjs";
+import { computed as r, onScopeDispose as i, shallowRef as a } from "vue";
+//#region src/vue/useStoreHistory.ts
+var o = {
+	entries: [],
+	index: -1,
+	canUndo: !1,
+	canRedo: !1
+}, s = () => {}, c = /* @__PURE__ */ new WeakSet(), l = (e) => {
+	t || c.has(e) || (c.add(e), console.warn("[nexus] useStoreHistory: this store has no history. Add `historyMiddleware()` to its middlewares to record an action log — until then the composable returns an empty, no-op view."));
+};
+function u(t) {
+	let c = t?.store ?? n(), u = e(c);
+	u || l(c);
+	let d = a(u ? u.getSnapshot() : o);
+	u && i(u.subscribe(() => {
+		d.value = u.getSnapshot();
+	}));
+	let f = {
+		undo: u?.undo ?? s,
+		redo: u?.redo ?? s,
+		travelTo: u?.travelTo ?? s,
+		clear: u?.clear ?? s
+	};
+	return r(() => ({
+		...d.value,
+		...f
+	}));
+}
+//#endregion
+export { u as useStoreHistory };

package/logo.svg

@@ -1,29 +1,51 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="640" height="180" viewBox="0 0 640 180" fill="none" role="img" aria-label="@plitzi/nexus">
+<svg xmlns="http://www.w3.org/2000/svg" width="640" height="210" viewBox="0 0 640 210" fill="none" role="img" aria-label="@plitzi/nexus — one store, every framework">
   <defs>
-    <linearGradient id="bg" x1="0" y1="0" x2="640" y2="180" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#0c0c12" />
-      <stop offset="1" stop-color="#16161f" />
+    <linearGradient id="bg" x1="0" y1="0" x2="640" y2="210" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#0b0b11" />
+      <stop offset="1" stop-color="#15131f" />
     </linearGradient>
+    <radialGradient id="glow" cx="0.5" cy="0.5" r="0.5">
+      <stop stop-color="#7c3aed" stop-opacity="0.55" />
+      <stop offset="1" stop-color="#7c3aed" stop-opacity="0" />
+    </radialGradient>
     <linearGradient id="mark" x1="0" y1="0" x2="1" y2="1">
-      <stop stop-color="#a78bfa" />
+      <stop stop-color="#c4b5fd" />
       <stop offset="1" stop-color="#7c3aed" />
     </linearGradient>
-    <linearGradient id="word" x1="150" y1="0" x2="560" y2="0" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#ede9fe" />
-      <stop offset="1" stop-color="#a78bfa" />
+    <linearGradient id="hero" x1="0" y1="0" x2="1" y2="0">
+      <stop stop-color="#8b5cf6" />
+      <stop offset="1" stop-color="#6d28d9" />
     </linearGradient>
+    <linearGradient id="word" x1="150" y1="0" x2="600" y2="0" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#ffffff" />
+      <stop offset="1" stop-color="#b794f6" />
+    </linearGradient>
+    <linearGradient id="pill" x1="0" y1="0" x2="0" y2="1">
+      <stop stop-color="#ffffff" stop-opacity="0.10" />
+      <stop offset="1" stop-color="#ffffff" stop-opacity="0.025" />
+    </linearGradient>
+    <filter id="soft" x="-60%" y="-60%" width="220%" height="220%">
+      <feGaussianBlur stdDeviation="7" result="b" />
+      <feMerge>
+        <feMergeNode in="b" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
   </defs>
 
-  <rect width="640" height="180" rx="20" fill="url(#bg)" />
-  <rect x="0.5" y="0.5" width="639" height="179" rx="19.5" fill="none" stroke="#2a2a38" />
+  <rect width="640" height="210" rx="22" fill="url(#bg)" />
+  <rect x="0.5" y="0.5" width="639" height="209" rx="21.5" fill="none" stroke="#2a2740" />
 
-  <circle cx="96" cy="90" r="130" fill="#7c3aed" opacity="0.10" />
+  <!-- ambient glow -->
+  <circle cx="92" cy="105" r="150" fill="url(#glow)" />
 
   <!-- nexus mark -->
-  <g transform="translate(90 90)">
-    <rect x="-36" y="-36" width="72" height="72" rx="18" fill="url(#mark)" />
-    <g transform="scale(2.0)" stroke="#fff" stroke-linecap="round" stroke-linejoin="round">
-      <path d="M0 -8.5 7.4 -4.25 7.4 4.25 0 8.5 -7.4 4.25 -7.4 -4.25 Z" stroke-width="1.3" stroke-opacity="0.45" />
+  <g transform="translate(92 105)">
+    <g filter="url(#soft)">
+      <rect x="-38" y="-38" width="76" height="76" rx="20" fill="url(#mark)" />
+    </g>
+    <g transform="scale(2.1)" stroke="#fff" stroke-linecap="round" stroke-linejoin="round">
+      <path d="M0 -8.5 7.4 -4.25 7.4 4.25 0 8.5 -7.4 4.25 -7.4 -4.25 Z" stroke-width="1.2" stroke-opacity="0.4" />
       <g stroke-width="1.5">
         <path d="M0 0 0 -8.5" />
         <path d="M0 0 7.4 -4.25" />
@@ -33,7 +55,7 @@
         <path d="M0 0 -7.4 -4.25" />
       </g>
     </g>
-    <g transform="scale(2.0)" fill="#fff">
+    <g transform="scale(2.1)" fill="#fff">
       <circle cx="0" cy="-8.5" r="1.7" />
       <circle cx="7.4" cy="-4.25" r="1.7" />
       <circle cx="7.4" cy="4.25" r="1.7" />
@@ -45,13 +67,46 @@
   </g>
 
   <!-- wordmark -->
-  <text x="158" y="86" font-family="'Inter', system-ui, sans-serif" font-size="46" font-weight="800" letter-spacing="-1" fill="url(#word)">
+  <text x="166" y="70" font-family="'Inter', system-ui, sans-serif" font-size="46" font-weight="800" letter-spacing="-1.5" fill="url(#word)">
     @plitzi/nexus
   </text>
-  <text x="160" y="120" font-family="'Inter', system-ui, sans-serif" font-size="20" font-weight="500" fill="#a1a1aa">
-    A tiny, type-safe React store
-  </text>
-  <text x="160" y="146" font-family="'JetBrains Mono', ui-monospace, monospace" font-size="15" fill="#8b5cf6">
-    path subscriptions · scoped stores · time-travel
+
+  <!-- punchy tagline -->
+  <text x="168" y="103" font-family="'Inter', system-ui, sans-serif" font-size="21" font-weight="600" letter-spacing="-0.3" fill="#ece7ff">
+    One store. Every framework.
   </text>
+
+  <!-- hero attribute — the headline feature -->
+  <g>
+    <rect x="166" y="120" width="264" height="32" rx="16" fill="url(#hero)" filter="url(#soft)" />
+    <rect x="166" y="120" width="264" height="32" rx="16" fill="url(#hero)" />
+    <path transform="translate(186 136)" d="M2.2 -8 L-4.4 1.2 L0 1.2 L-2.2 8 L4.4 -1.2 L0 -1.2 Z" fill="#fff" />
+    <text x="200" y="141" font-family="'Inter', system-ui, sans-serif" font-size="14.5" font-weight="700" letter-spacing="-0.2" fill="#ffffff">
+      Re-renders only what changed
+    </text>
+  </g>
+
+  <!-- framework pills -->
+  <g font-family="'JetBrains Mono', ui-monospace, monospace" font-size="13" font-weight="500" letter-spacing="0.3" text-anchor="middle">
+    <g>
+      <rect x="166" y="164" width="74" height="28" rx="14" fill="url(#pill)" stroke="#a78bfa" stroke-opacity="0.4" />
+      <text x="203" y="182.5" fill="#d4c6ff">React</text>
+    </g>
+    <g>
+      <rect x="250" y="164" width="60" height="28" rx="14" fill="url(#pill)" stroke="#a78bfa" stroke-opacity="0.4" />
+      <text x="280" y="182.5" fill="#d4c6ff">Vue</text>
+    </g>
+    <g>
+      <rect x="320" y="164" width="66" height="28" rx="14" fill="url(#pill)" stroke="#a78bfa" stroke-opacity="0.4" />
+      <text x="353" y="182.5" fill="#d4c6ff">Next</text>
+    </g>
+    <g>
+      <rect x="396" y="164" width="80" height="28" rx="14" fill="url(#pill)" stroke="#a78bfa" stroke-opacity="0.4" />
+      <text x="436" y="182.5" fill="#d4c6ff">Svelte</text>
+    </g>
+    <g>
+      <rect x="486" y="164" width="100" height="28" rx="14" fill="url(#pill)" stroke="#a78bfa" stroke-opacity="0.4" />
+      <text x="536" y="182.5" fill="#d4c6ff">SSR · RSC</text>
+    </g>
+  </g>
 </svg>