@veams/status-quo 1.5.0 → 1.6.0

package/dist/store/observable-state-handler.js

@@ -1,6 +1,6 @@
 import { BehaviorSubject, distinctUntilChanged, distinctUntilKeyChanged, map } from 'rxjs';
-import { BaseStateHandler } from './base-state-handler.js';
 import { resolveDistinctOptions } from '../config/status-quo-config.js';
+import { BaseStateHandler } from './base-state-handler.js';
 export class ObservableStateHandler extends BaseStateHandler {
     state$;
     distinctOptions;
@@ -16,10 +16,10 @@ export class ObservableStateHandler extends BaseStateHandler {
     setStateValue(nextState) {
         this.state$.next(nextState);
     }
-    getStateItemAsObservable(key) {
+    getObservableItem(key) {
         return this.state$.pipe(distinctUntilKeyChanged(key), map((state) => state[key]));
     }
-    getStateAsObservable(options = {}) {
+    getObservable(options = {}) {
         const useDistinctUntilChanged = options.useDistinctUntilChanged ?? this.distinctOptions.enabled;
         if (!useDistinctUntilChanged) {
             return this.state$;
@@ -28,15 +28,8 @@ export class ObservableStateHandler extends BaseStateHandler {
             return this.distinctOptions.comparator(previous, next);
         }));
     }
-    getObservable(key) {
-        return this.getStateItemAsObservable(key);
-    }
-    /** @deprecated Use getObservable instead. */
-    getObservableItem(key) {
-        return this.getObservable(key);
-    }
     subscribe(listener) {
-        const subscription = this.getStateAsObservable().subscribe((nextState) => {
+        const subscription = this.getObservable().subscribe((nextState) => {
             listener(nextState);
         });
         return () => subscription.unsubscribe();

package/dist/store/observable-state-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"observable-state-handler.js","sourceRoot":"","sources":["../../src/store/observable-state-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAmBxE,MAAM,OAAgB,sBAA6B,SAAQ,gBAAsB;IAC9D,MAAM,CAAqB;IAC3B,eAAe,CAA+C;IAE/E,YAAsB,EAAE,YAAY,EAAE,OAAO,EAAkC;QAC7E,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAI,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,eAAe,GAAG,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;QACnG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAES,aAAa;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAES,aAAa,CAAC,SAAY;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,wBAAwB,CAAC,GAAY;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,uBAAuB,CAAC,GAAG,CAAC,EAC5B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,UAAkC,EAAE;QACvD,MAAM,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAElE,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,oBAAoB,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;YACtC,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CACc,CAAC;IACrB,CAAC;IAED,aAAa,CAAC,GAAY;QACxB,OAAO,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,6CAA6C;IAC7C,iBAAiB,CAAC,GAAY;QAC5B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAID,SAAS,CAAC,QAA4B;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YACvE,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"observable-state-handler.js","sourceRoot":"","sources":["../../src/store/observable-state-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAE3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgB3D,MAAM,OAAgB,sBAA6B,SAAQ,gBAAsB;IAC9D,MAAM,CAAqB;IAC3B,eAAe,CAA+C;IAE/E,YAAsB,EAAE,YAAY,EAAE,OAAO,EAAkC;QAC7E,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAI,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,eAAe,GAAG,sBAAsB,CAC3C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,uBAAuB,CACjC,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAES,aAAa;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAES,aAAa,CAAC,SAAY;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,iBAAiB,CAAoB,GAAM;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,uBAAuB,CAAC,GAAG,CAAC,EAC5B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAC3B,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,UAAkC,EAAE;QAChD,MAAM,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;QAEhG,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACrB,oBAAoB,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;YACtC,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAID,SAAS,CAAC,QAA4B;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YAChE,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/store/signal-state-handler.d.ts

@@ -1,13 +1,10 @@
 import { BaseStateHandler } from './base-state-handler.js';
+import type { DevToolsOptions, DistinctOptions } from '../config/status-quo-config.js';
 import type { Signal } from '@preact/signals-core';
-import type { DistinctOptions } from '../config/status-quo-config.js';
 type SignalStateHandlerProps<S> = {
     initialState: S;
     options?: {
-        devTools?: {
-            enabled?: boolean;
-            namespace: string;
-        };
+        devTools?: DevToolsOptions;
         distinct?: DistinctOptions<S>;
         useDistinctUntilChanged?: boolean;
     };

package/dist/store/signal-state-handler.js

@@ -1,6 +1,6 @@
 import { signal } from '@preact/signals-core';
-import { BaseStateHandler } from './base-state-handler.js';
 import { resolveDistinctOptions } from '../config/status-quo-config.js';
+import { BaseStateHandler } from './base-state-handler.js';
 export class SignalStateHandler extends BaseStateHandler {
     state;
     distinctOptions;
@@ -23,7 +23,8 @@ export class SignalStateHandler extends BaseStateHandler {
                 listener(nextState);
                 return;
             }
-            if (this.distinctOptions.enabled && this.distinctOptions.comparator(previousSnapshot, nextState)) {
+            if (this.distinctOptions.enabled &&
+                this.distinctOptions.comparator(previousSnapshot, nextState)) {
                 previousSnapshot = nextState;
                 return;
             }

package/dist/store/signal-state-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal-state-handler.js","sourceRoot":"","sources":["../../src/store/signal-state-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAiBxE,MAAM,OAAgB,kBAAyB,SAAQ,gBAAsB;IAC1D,KAAK,CAAY;IACjB,eAAe,CAA+C;IAE/E,YAAsB,EAAE,YAAY,EAAE,OAAO,EAA8B;QACzE,KAAK,CAAC,YAAY,CAAC,CAAC;QAEpB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAI,YAAY,CAAC,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC;QACnG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAID,SAAS,CAAC,QAA4B;QACpC,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAExC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YACxC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,gBAAgB,GAAG,SAAS,CAAC;gBAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YAED,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,IAAI,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAAE,CAAC;gBACjG,gBAAgB,GAAG,SAAS,CAAC;gBAC7B,OAAO;YACT,CAAC;YAED,gBAAgB,GAAG,SAAS,CAAC;YAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAES,aAAa;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAES,aAAa,CAAC,SAAY;QAClC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"signal-state-handler.js","sourceRoot":"","sources":["../../src/store/signal-state-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAc3D,MAAM,OAAgB,kBAAyB,SAAQ,gBAAsB;IAC1D,KAAK,CAAY;IACjB,eAAe,CAA+C;IAE/E,YAAsB,EAAE,YAAY,EAAE,OAAO,EAA8B;QACzE,KAAK,CAAC,YAAY,CAAC,CAAC;QAEpB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAI,YAAY,CAAC,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,sBAAsB,CAC3C,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,uBAAuB,CACjC,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAID,SAAS,CAAC,QAA4B;QACpC,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAExC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE;YACxC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC;gBACnB,gBAAgB,GAAG,SAAS,CAAC;gBAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YAED,IACE,IAAI,CAAC,eAAe,CAAC,OAAO;gBAC5B,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAC5D,CAAC;gBACD,gBAAgB,GAAG,SAAS,CAAC;gBAC7B,OAAO;YACT,CAAC;YAED,gBAAgB,GAAG,SAAS,CAAC;YAC7B,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAES,aAAa;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAES,aAAa,CAAC,SAAY;QAClC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC;IAC/B,CAAC;CACF"}

package/dist/store/state-singleton.js

@@ -1,4 +1,4 @@
-export function makeStateSingleton(stateHandlerFactory, { destroyOnNoConsumers = true } = {}) {
+export function makeStateSingleton(stateHandlerFactory, { destroyOnNoConsumers = false } = {}) {
     let instance = null;
     const singleton = {
         destroyOnNoConsumers,

package/dist/store/state-singleton.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-singleton.js","sourceRoot":"","sources":["../../src/store/state-singleton.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,kBAAkB,CAChC,mBAAyD,EACzD,EAAE,oBAAoB,GAAG,IAAI,KAA4B,EAAE;IAE3D,IAAI,QAAQ,GAA0C,IAAI,CAAC;IAC3D,MAAM,SAAS,GAGX;QACF,oBAAoB;QACpB,WAAW;YACT,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,mBAAmB,EAAE,CAAC;YACnC,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,eAAe;YACb,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"state-singleton.js","sourceRoot":"","sources":["../../src/store/state-singleton.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,kBAAkB,CAChC,mBAAyD,EACzD,EAAE,oBAAoB,GAAG,KAAK,KAA4B,EAAE;IAE5D,IAAI,QAAQ,GAA0C,IAAI,CAAC;IAC3D,MAAM,SAAS,GAGX;QACF,oBAAoB;QACpB,WAAW;YACT,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,mBAAmB,EAAE,CAAC;YACnC,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,eAAe;YACb,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/eslint.config.mjs

@@ -0,0 +1,75 @@
+import { fileURLToPath } from 'node:url';
+
+import js from '@eslint/js';
+import { defineConfig } from 'eslint/config';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import jsxA11yPlugin from 'eslint-plugin-jsx-a11y';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+const packageRoot = fileURLToPath(new URL('.', import.meta.url));
+const sourceFiles = ['src/**/*.{ts,tsx}'];
+const testFiles = ['src/**/*.{spec,test}.{ts,tsx}', 'src/**/__tests__/**/*.{ts,tsx}'];
+
+export default defineConfig(
+  {
+    ignores: ['dist/**', 'coverage/**'],
+  },
+  js.configs.recommended,
+  tseslint.configs.recommended,
+  tseslint.configs.recommendedTypeChecked,
+  {
+    files: sourceFiles,
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+        projectService: true,
+        tsconfigRootDir: packageRoot,
+      },
+      sourceType: 'module',
+    },
+    plugins: {
+      react: reactPlugin,
+      'react-hooks': reactHooksPlugin,
+      'jsx-a11y': jsxA11yPlugin,
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+    rules: {
+      ...reactPlugin.configs.flat.recommended.rules,
+      ...reactPlugin.configs.flat['jsx-runtime'].rules,
+      ...jsxA11yPlugin.flatConfigs.recommended.rules,
+      ...reactHooksPlugin.configs.recommended.rules,
+      '@typescript-eslint/consistent-type-imports': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+        },
+      ],
+      'react/prop-types': 'off',
+    },
+  },
+  {
+    files: testFiles,
+    languageOptions: {
+      globals: {
+        ...globals.jest,
+      },
+    },
+    rules: {
+      'react/display-name': 'off',
+    },
+  }
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veams/status-quo",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "The manager to rule states in frontend.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -12,12 +12,12 @@
       },
       "require": "./dist/index.js"
     },
-    "./hooks": {
+    "./react": {
       "import": {
-        "types": "./dist/hooks/index.d.ts",
-        "default": "./dist/hooks/index.js"
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
       },
-      "require": "./dist/hooks/index.js"
+      "require": "./dist/react/index.js"
     },
     "./store": {
       "import": {
@@ -37,12 +37,9 @@
     "compile": "npm-run-all bundle:ts",
     "dev": "npm-run-all --parallel watch:**",
     "generate:types": "tsc --project tsconfig.json --emitDeclarationOnly true --declaration true --declarationDir ./dist/types",
-    "lint": "pnpm run lint:ts",
-    "lint:ts": "eslint --fix \"src/**/*.{tsx,ts}\" --config ./.eslintrc.cjs",
+    "lint": "npm run lint:ts",
+    "lint:ts": "eslint --fix \"src/**/*.{tsx,ts}\"",
     "start": "npm-run-all --parallel watch:**",
-    "playground": "vite --config playground/vite.config.ts",
-    "docs:build": "vite build --config playground/vite.config.ts",
-    "docs:preview": "vite preview --config playground/vite.config.ts",
     "watch:bundle:ts": "npm run bundle:ts -- -w",
     "watch:generate:types": "npm run generate:types -- --watch",
     "test": "cross-env NODE_ENV=test jest --config jest.config.cjs",
@@ -56,25 +53,20 @@
   },
   "devDependencies": {
     "@preact/signals-core": "^1.13.0",
-    "@types/prismjs": "^1.26.4",
     "@types/react-dom": "^19.0.0",
     "@types/jest": "30.0.0",
     "@types/node": "25.2.3",
     "@types/react": "19.2.14",
-    "@vitejs/plugin-react": "^5.0.0",
     "cross-env": "10.1.0",
-    "eslint": "8.55.0",
-    "jest": "30.2.0",
-    "jest-environment-jsdom": "30.2.0",
+    "jest": "30.3.0",
+    "jest-environment-jsdom": "30.3.0",
     "npm-run-all": "4.1.5",
     "prettier": "3.8.1",
-    "prismjs": "^1.29.0",
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "rxjs": "7.8.2",
     "tslib": "2.8.1",
     "typescript": "5.9.3",
-    "vite": "^5.0.0",
     "@swc/jest": "0.2.39",
     "@swc/core": "1.15.11",
     "release-it": "19.2.4"
@@ -86,5 +78,13 @@
     "access": "public"
   },
   "author": "Sebastian Fitzner",
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Veams/veams.git",
+    "directory": "packages/status-quo"
+  },
+  "bugs": {
+    "url": "https://github.com/Veams/veams/issues"
+  }
 }

package/src/config/status-quo-config.ts

@@ -5,7 +5,17 @@ export type DistinctOptions<T = unknown> = {
   comparator?: DistinctComparator<T>;
 };
 
+export type DevToolsOptions = {
+  enabled?: boolean;
+  namespace?: string;
+};
+
+export type GlobalDevToolsOptions = {
+  enabled?: boolean;
+};
+
 export type StatusQuoConfig<T = unknown> = {
+  devTools?: GlobalDevToolsOptions;
   distinct?: DistinctOptions<T>;
 };
 
@@ -14,7 +24,12 @@ type ResolvedDistinctOptions<T = unknown> = {
   comparator: DistinctComparator<T>;
 };
 
+type ResolvedDevToolsOptions = {
+  enabled: boolean;
+};
+
 type ResolvedStatusQuoConfig = {
+  devTools: ResolvedDevToolsOptions;
   distinct: ResolvedDistinctOptions;
 };
 
@@ -32,6 +47,9 @@ function distinctAsJson(previous: unknown, next: unknown) {
 
 function createDefaultStatusQuoConfig(): ResolvedStatusQuoConfig {
   return {
+    devTools: {
+      enabled: false,
+    },
     distinct: {
       enabled: true,
       comparator: distinctAsJson,
@@ -43,6 +61,9 @@ let statusQuoConfig = createDefaultStatusQuoConfig();
 
 export function setupStatusQuo<T = unknown>(config: StatusQuoConfig<T> = {}) {
   statusQuoConfig = {
+    devTools: {
+      enabled: config.devTools?.enabled ?? false,
+    },
     distinct: {
       enabled: config.distinct?.enabled ?? true,
       comparator: (config.distinct?.comparator ?? distinctAsJson) as DistinctComparator,
@@ -57,12 +78,21 @@ export function resolveDistinctOptions<T>(
   return {
     enabled: options?.enabled ?? useDistinctUntilChanged ?? statusQuoConfig.distinct.enabled,
     comparator: (options?.comparator ??
-      statusQuoConfig.distinct.comparator) as DistinctComparator<T>,
+      statusQuoConfig.distinct.comparator),
+  };
+}
+
+export function resolveDevToolsOptions(options?: DevToolsOptions): ResolvedDevToolsOptions {
+  return {
+    enabled: options?.enabled ?? statusQuoConfig.devTools.enabled,
   };
 }
 
 export function getStatusQuoConfig() {
   return {
+    devTools: {
+      enabled: statusQuoConfig.devTools.enabled,
+    },
     distinct: {
       enabled: statusQuoConfig.distinct.enabled,
       comparator: statusQuoConfig.distinct.comparator,

package/src/index.ts

@@ -1,19 +1,18 @@
-import {
-  useStateActions,
-  useStateFactory,
-  useStateHandler,
-  useStateSingleton,
-  useStateSubscription,
-} from './hooks';
+import { setupStatusQuo } from './config/status-quo-config.js';
 import {
   BaseStateHandler,
   makeStateSingleton,
   ObservableStateHandler,
   SignalStateHandler,
 } from './store';
-import { setupStatusQuo } from './config/status-quo-config.js';
 
-import type { DistinctComparator, DistinctOptions, StatusQuoConfig } from './config/status-quo-config.js';
+import type {
+  DevToolsOptions,
+  GlobalDevToolsOptions,
+  DistinctComparator,
+  DistinctOptions,
+  StatusQuoConfig,
+} from './config/status-quo-config.js';
 import type { StateSingleton, StateSingletonOptions } from './store';
 import type { StateSubscriptionHandler } from './types/types.js';
 
@@ -21,16 +20,13 @@ export {
   BaseStateHandler,
   makeStateSingleton,
   ObservableStateHandler,
-  SignalStateHandler,
   setupStatusQuo,
-  useStateActions,
-  useStateFactory,
-  useStateHandler,
-  useStateSingleton,
-  useStateSubscription,
+  SignalStateHandler,
 };
 
 export type {
+  DevToolsOptions,
+  GlobalDevToolsOptions,
   DistinctComparator,
   DistinctOptions,
   StateSingleton,

package/src/react/hooks/__tests__/state-provider.spec.tsx

@@ -0,0 +1,286 @@
+import React, { act } from 'react';
+import { createRoot } from 'react-dom/client';
+
+import {
+  StateProvider,
+  useProvidedStateActions,
+  useProvidedStateHandler,
+  useProvidedStateSubscription,
+} from '../state-provider.js';
+
+import type { StateSubscriptionHandler } from '../../../types/types.js';
+
+declare global {
+  // React 19 requires this flag in test environments that use manual act() calls.
+
+  var IS_REACT_ACT_ENVIRONMENT: boolean;
+}
+
+type TestState = {
+  count: number;
+  label: string;
+};
+
+type TestActions = {
+  increment: () => void;
+  rename: (label: string) => void;
+};
+
+class TestStateHandler implements StateSubscriptionHandler<TestState, TestActions> {
+  private readonly initialState: TestState;
+  private state: TestState;
+  private readonly listeners = new Set<(value: TestState) => void>();
+
+  destroy = jest.fn();
+
+  constructor(initialState: TestState) {
+    this.initialState = initialState;
+    this.state = initialState;
+  }
+
+  subscribe(listener: () => void): () => void;
+  subscribe(listener: (value: TestState) => void): () => void;
+  subscribe(listener: ((value: TestState) => void) | (() => void)) {
+    const typedListener = listener as (value: TestState) => void;
+    this.listeners.add(typedListener);
+
+    return () => {
+      this.listeners.delete(typedListener);
+    };
+  }
+
+  getSnapshot = () => {
+    return this.state;
+  };
+
+  getInitialState = () => {
+    return this.initialState;
+  };
+
+  getActions = () => {
+    return {
+      increment: () => {
+        this.state = {
+          ...this.state,
+          count: this.state.count + 1,
+        };
+
+        this.emitStateChange();
+      },
+      rename: (label: string) => {
+        this.state = {
+          ...this.state,
+          label,
+        };
+
+        this.emitStateChange();
+      },
+    };
+  };
+
+  private emitStateChange() {
+    const nextState = this.state;
+    this.listeners.forEach((listener) => listener(nextState));
+  }
+}
+
+function CountConsumer({ onRender }: { onRender: (count: number) => void }) {
+  const [count] = useProvidedStateSubscription<TestState, TestActions, number>(
+    (state) => state.count
+  );
+
+  onRender(count);
+
+  return <span>{count}</span>;
+}
+
+function FullStateConsumer({
+  onActionsReady,
+  onRender,
+}: {
+  onActionsReady: (actions: TestActions) => void;
+  onRender: (state: TestState) => void;
+}) {
+  const [state, actions] = useProvidedStateSubscription<TestState, TestActions>();
+
+  onRender(state);
+  onActionsReady(actions);
+
+  return <span>{state.label}</span>;
+}
+
+function ActionsOnlyConsumer({
+  onActionsReady,
+  onRender,
+}: {
+  onActionsReady: (actions: TestActions) => void;
+  onRender: () => void;
+}) {
+  const actions = useProvidedStateActions<TestState, TestActions>();
+
+  onRender();
+  onActionsReady(actions);
+
+  return <span>actions-only</span>;
+}
+
+function HandlerConsumer({
+  onHandlerReady,
+}: {
+  onHandlerReady: (handler: StateSubscriptionHandler<TestState, TestActions>) => void;
+}) {
+  const handler = useProvidedStateHandler<TestState, TestActions>();
+
+  onHandlerReady(handler);
+
+  return <span>handler</span>;
+}
+
+function MissingProviderConsumer() {
+  useProvidedStateActions<TestState, TestActions>();
+
+  return null;
+}
+
+describe('StateProvider', () => {
+  let container: HTMLDivElement;
+  let root: ReturnType<typeof createRoot>;
+
+  beforeAll(() => {
+    globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+  });
+
+  beforeEach(() => {
+    container = document.createElement('div');
+    document.body.appendChild(container);
+    root = createRoot(container);
+  });
+
+  afterEach(() => {
+    act(() => {
+      root.unmount();
+    });
+
+    container.remove();
+  });
+
+  afterAll(() => {
+    globalThis.IS_REACT_ACT_ENVIRONMENT = false;
+  });
+
+  it('should share one handler instance across the provider subtree', () => {
+    const stateHandler = new TestStateHandler({
+      count: 0,
+      label: 'Counter',
+    });
+    const countRenderSpy = jest.fn<void, [number]>();
+    const actionsRenderSpy = jest.fn();
+    const actionsReadySpy = jest.fn<void, [TestActions]>();
+    const handlerReadySpy = jest.fn<void, [StateSubscriptionHandler<TestState, TestActions>]>();
+
+    act(() => {
+      root.render(
+        <StateProvider instance={stateHandler}>
+          <CountConsumer onRender={countRenderSpy} />
+          <ActionsOnlyConsumer onActionsReady={actionsReadySpy} onRender={actionsRenderSpy} />
+          <HandlerConsumer onHandlerReady={handlerReadySpy} />
+        </StateProvider>
+      );
+    });
+
+    expect(countRenderSpy).toHaveBeenCalledTimes(1);
+    expect(countRenderSpy).toHaveBeenLastCalledWith(0);
+    expect(actionsRenderSpy).toHaveBeenCalledTimes(1);
+    expect(handlerReadySpy).toHaveBeenCalledWith(stateHandler);
+
+    const [[actions]] = actionsReadySpy.mock.calls as [[TestActions]];
+
+    act(() => {
+      actions.rename('Renamed');
+    });
+
+    expect(countRenderSpy).toHaveBeenCalledTimes(1);
+    expect(actionsRenderSpy).toHaveBeenCalledTimes(1);
+
+    act(() => {
+      actions.increment();
+    });
+
+    expect(countRenderSpy).toHaveBeenCalledTimes(2);
+    expect(countRenderSpy).toHaveBeenLastCalledWith(1);
+    expect(actionsRenderSpy).toHaveBeenCalledTimes(1);
+  });
+
+  it('should return the full snapshot when no selector is provided', () => {
+    const stateHandler = new TestStateHandler({
+      count: 2,
+      label: 'Counter',
+    });
+    const renderSpy = jest.fn<void, [TestState]>();
+    const actionsReadySpy = jest.fn<void, [TestActions]>();
+
+    act(() => {
+      root.render(
+        <StateProvider instance={stateHandler}>
+          <FullStateConsumer onActionsReady={actionsReadySpy} onRender={renderSpy} />
+        </StateProvider>
+      );
+    });
+
+    expect(renderSpy).toHaveBeenCalledTimes(1);
+    expect(renderSpy).toHaveBeenLastCalledWith({ count: 2, label: 'Counter' });
+
+    const [[actions]] = actionsReadySpy.mock.calls as [[TestActions]];
+
+    act(() => {
+      actions.increment();
+    });
+
+    expect(renderSpy).toHaveBeenCalledTimes(2);
+    expect(renderSpy).toHaveBeenLastCalledWith({ count: 3, label: 'Counter' });
+  });
+
+  it('should follow a new instance when the provider instance changes', () => {
+    const firstHandler = new TestStateHandler({
+      count: 1,
+      label: 'First',
+    });
+    const secondHandler = new TestStateHandler({
+      count: 8,
+      label: 'Second',
+    });
+    const renderSpy = jest.fn<void, [number]>();
+
+    act(() => {
+      root.render(
+        <StateProvider instance={firstHandler}>
+          <CountConsumer onRender={renderSpy} />
+        </StateProvider>
+      );
+    });
+
+    act(() => {
+      root.render(
+        <StateProvider instance={secondHandler}>
+          <CountConsumer onRender={renderSpy} />
+        </StateProvider>
+      );
+    });
+
+    expect(renderSpy).toHaveBeenCalledTimes(2);
+    expect(renderSpy).toHaveBeenNthCalledWith(1, 1);
+    expect(renderSpy).toHaveBeenNthCalledWith(2, 8);
+  });
+
+  it('should throw when provider hooks are used outside StateProvider', () => {
+    const consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => undefined);
+
+    expect(() => {
+      act(() => {
+        root.render(<MissingProviderConsumer />);
+      });
+    }).toThrow('No StateProvider instance found in the current React tree.');
+
+    consoleErrorSpy.mockRestore();
+  });
+});