ccstate 3.0.0 → 4.0.0

package/README.md

@@ -7,7 +7,6 @@
 ![NPM Version](https://img.shields.io/npm/v/ccstate)
 ![npm package minimized gzipped size](https://img.shields.io/bundlejs/size/ccstate)
 [![CI](https://github.com/e7h4n/ccstate/actions/workflows/ci.yaml/badge.svg)](https://github.com/e7h4n/ccstate/actions/workflows/ci.yaml)
-[![CodSpeed Badge](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json)](https://codspeed.io/e7h4n/ccstate)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 CCState is a semantic, strict, and flexible state management library suitable for medium to large single-page applications with complex state management needs.
@@ -19,7 +18,7 @@ The name of CCState comes from three basic data types: computed, command, and st
 - 💯 Simple & Intuitive: Crystal-clear API design with just 3 data types and 2 operations
 - ✅ Rock-solid Reliability: Comprehensive test coverage reaching 100% branch coverage
 - 🪶 Ultra-lightweight: Zero dependencies, only 500 lines of core code
-- 💡 Framework Agnostic: Seamlessly works with [React](docs/react.md), [Vue](docs/vue.md), or any UI framework
+- 💡 Framework Agnostic: Seamlessly works with [React](docs/react.md), [Vue](docs/vue.md), [Solid.js](docs/solid.md), [Vanilla](docs/vanilla.md), or any UI framework
 - 🚀 Blazing Fast: Optimized performance from day one, 2x-7x faster than Jotai across scenarios
 
 ## Getting Started
@@ -85,27 +84,15 @@ export default function App() {
     </div>
   );
 }
-```
-
-Use `createStore` and `StoreProvider` to provide a CCState store to React, all states and computations will only affect this isolated store.
 
-```tsx
 // main.jsx
-import { createStore } from 'ccstate';
-import { StoreProvider } from 'ccstate-react';
 import { createRoot } from 'react-dom/client';
-
 import App from './App';
 
 const rootElement = document.getElementById('root');
 const root = createRoot(rootElement);
 
-const store = createStore();
-root.render(
-  <StoreProvider value={store}>
-    <App />
-  </StoreProvider>,
-);
+root.render(<App />);
 ```
 
 That's it! [Click here to see the full example](https://codesandbox.io/p/sandbox/cr3xg6).
@@ -288,6 +275,14 @@ That's it! Next, you can learn how to use CCState in React.
 
 [Using in Vue](docs/vue.md)
 
+## Using in Solid.js
+
+[Using in Solid.js](docs/solid.md)
+
+## Using in Vanilla
+
+[Using in Vanilla](docs/vanilla.md)
+
 ### Testing & Debugging
 
 Testing Value/Computed should be as simple as testing a Map.
@@ -821,10 +816,9 @@ So, I think the only way to implement `Computed`'s effect-less is to separate th
 
 Here are some new ideas:
 
-- Integration with svelte / solid.js
-- Enhance devtools
+- Integration with svelte
+- Enhance debug ability
   - Support viewing current subscription graph and related atom values
-  - Enable logging and breakpoints for specific atoms in devtools
 - Performance improvements
   - Mount atomState directly on atoms when there's only one store in the application to reduce WeakMap lookup overhead
   - Support static declaration of upstream dependencies for Computed to improve performance by disabling runtime dependency analysis

package/core/index.cjs

@@ -1015,8 +1015,16 @@ function createStore() {
   var listenerManager = new ListenerManager();
   return new StoreImpl(atomManager, listenerManager);
 }
+var defaultStore = undefined;
+function getDefaultStore() {
+  if (!defaultStore) {
+    defaultStore = createStore();
+  }
+  return defaultStore;
+}
 
 exports.command = command;
 exports.computed = computed;
 exports.createStore = createStore;
+exports.getDefaultStore = getDefaultStore;
 exports.state = state;

package/core/index.d.cts

@@ -48,5 +48,6 @@ type CallbackFunc<T> = Command<T, []>;
 type Subscribe = (atoms$: ReadableAtom<unknown>[] | ReadableAtom<unknown>, callback: CallbackFunc<unknown>, options?: SubscribeOptions) => () => void;
 
 declare function createStore(): Store;
+declare function getDefaultStore(): Store;
 
-export { type Command, type Computed, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createStore, state };
+export { type Command, type Computed, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createStore, getDefaultStore, state };

package/core/index.d.ts

@@ -48,5 +48,6 @@ type CallbackFunc<T> = Command<T, []>;
 type Subscribe = (atoms$: ReadableAtom<unknown>[] | ReadableAtom<unknown>, callback: CallbackFunc<unknown>, options?: SubscribeOptions) => () => void;
 
 declare function createStore(): Store;
+declare function getDefaultStore(): Store;
 
-export { type Command, type Computed, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createStore, state };
+export { type Command, type Computed, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createStore, getDefaultStore, state };

package/core/index.js

@@ -1013,5 +1013,12 @@ function createStore() {
   var listenerManager = new ListenerManager();
   return new StoreImpl(atomManager, listenerManager);
 }
+var defaultStore = undefined;
+function getDefaultStore() {
+  if (!defaultStore) {
+    defaultStore = createStore();
+  }
+  return defaultStore;
+}
 
-export { command, computed, createStore, state };
+export { command, computed, createStore, getDefaultStore, state };

package/debug/index.cjs

@@ -1209,11 +1209,12 @@ var ConsoleInterceptor = /*#__PURE__*/_createClass(function ConsoleInterceptor(w
 function createDebugStore() {
   var watches = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   var defaultActions = arguments.length > 1 ? arguments[1] : undefined;
+  var parsedDefaultActions = defaultActions ? new Set(defaultActions) : undefined;
   var parsedWatches = watches.map(function (watch) {
     if (typeof watch === 'string' || watch instanceof RegExp) {
       return {
         target: watch,
-        actions: defaultActions ? new Set(defaultActions) : undefined
+        actions: parsedDefaultActions
       };
     }
     if ('target' in watch) {
@@ -1221,7 +1222,7 @@ function createDebugStore() {
     }
     return {
       target: watch,
-      actions: defaultActions ? new Set(defaultActions) : undefined
+      actions: parsedDefaultActions
     };
   });
   var interceptor = new ConsoleInterceptor(parsedWatches);

package/debug/index.js

@@ -1207,11 +1207,12 @@ var ConsoleInterceptor = /*#__PURE__*/_createClass(function ConsoleInterceptor(w
 function createDebugStore() {
   var watches = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   var defaultActions = arguments.length > 1 ? arguments[1] : undefined;
+  var parsedDefaultActions = defaultActions ? new Set(defaultActions) : undefined;
   var parsedWatches = watches.map(function (watch) {
     if (typeof watch === 'string' || watch instanceof RegExp) {
       return {
         target: watch,
-        actions: defaultActions ? new Set(defaultActions) : undefined
+        actions: parsedDefaultActions
       };
     }
     if ('target' in watch) {
@@ -1219,7 +1220,7 @@ function createDebugStore() {
     }
     return {
       target: watch,
-      actions: defaultActions ? new Set(defaultActions) : undefined
+      actions: parsedDefaultActions
     };
   });
   var interceptor = new ConsoleInterceptor(parsedWatches);

package/index.cjs

@@ -1076,6 +1076,13 @@ function createStore() {
   var listenerManager = new ListenerManager();
   return new StoreImpl(atomManager, listenerManager);
 }
+var defaultStore = undefined;
+function getDefaultStore() {
+  if (!defaultStore) {
+    defaultStore = createStore();
+  }
+  return defaultStore;
+}
 
 var DebugStoreImpl = /*#__PURE__*/function (_StoreImpl) {
   function DebugStoreImpl() {
@@ -1253,11 +1260,12 @@ var ConsoleInterceptor = /*#__PURE__*/_createClass(function ConsoleInterceptor(w
 function createDebugStore() {
   var watches = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   var defaultActions = arguments.length > 1 ? arguments[1] : undefined;
+  var parsedDefaultActions = defaultActions ? new Set(defaultActions) : undefined;
   var parsedWatches = watches.map(function (watch) {
     if (typeof watch === 'string' || watch instanceof RegExp) {
       return {
         target: watch,
-        actions: defaultActions ? new Set(defaultActions) : undefined
+        actions: parsedDefaultActions
       };
     }
     if ('target' in watch) {
@@ -1265,7 +1273,7 @@ function createDebugStore() {
     }
     return {
       target: watch,
-      actions: defaultActions ? new Set(defaultActions) : undefined
+      actions: parsedDefaultActions
     };
   });
   var interceptor = new ConsoleInterceptor(parsedWatches);
@@ -1276,4 +1284,5 @@ exports.command = command;
 exports.computed = computed;
 exports.createDebugStore = createDebugStore;
 exports.createStore = createStore;
+exports.getDefaultStore = getDefaultStore;
 exports.state = state;

package/index.d.cts

@@ -49,6 +49,7 @@ type Subscribe = (atoms$: ReadableAtom<unknown>[] | ReadableAtom<unknown>, callb
 type StoreEventType = 'set' | 'get' | 'sub' | 'unsub' | 'mount' | 'unmount' | 'notify' | 'computed';
 
 declare function createStore(): Store;
+declare function getDefaultStore(): Store;
 
 type NestedAtom = (State<unknown> | Computed<unknown> | Command<unknown, unknown[]> | NestedAtom)[];
 interface DebugStore extends Store {
@@ -64,4 +65,4 @@ interface AtomWatch {
 }
 declare function createDebugStore(watches?: (AtomWatch | string | RegExp | State<unknown> | Computed<unknown> | Command<unknown, unknown[]>)[], defaultActions?: StoreEventType[]): DebugStore;
 
-export { type Command, type Computed, type DebugStore, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createDebugStore, createStore, state };
+export { type Command, type Computed, type DebugStore, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createDebugStore, createStore, getDefaultStore, state };

package/index.d.ts

@@ -49,6 +49,7 @@ type Subscribe = (atoms$: ReadableAtom<unknown>[] | ReadableAtom<unknown>, callb
 type StoreEventType = 'set' | 'get' | 'sub' | 'unsub' | 'mount' | 'unmount' | 'notify' | 'computed';
 
 declare function createStore(): Store;
+declare function getDefaultStore(): Store;
 
 type NestedAtom = (State<unknown> | Computed<unknown> | Command<unknown, unknown[]> | NestedAtom)[];
 interface DebugStore extends Store {
@@ -64,4 +65,4 @@ interface AtomWatch {
 }
 declare function createDebugStore(watches?: (AtomWatch | string | RegExp | State<unknown> | Computed<unknown> | Command<unknown, unknown[]>)[], defaultActions?: StoreEventType[]): DebugStore;
 
-export { type Command, type Computed, type DebugStore, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createDebugStore, createStore, state };
+export { type Command, type Computed, type DebugStore, type Getter, type Read, type Setter, type State, type Store, type Subscribe, type Updater, type Write, command, computed, createDebugStore, createStore, getDefaultStore, state };

package/index.js

@@ -1074,6 +1074,13 @@ function createStore() {
   var listenerManager = new ListenerManager();
   return new StoreImpl(atomManager, listenerManager);
 }
+var defaultStore = undefined;
+function getDefaultStore() {
+  if (!defaultStore) {
+    defaultStore = createStore();
+  }
+  return defaultStore;
+}
 
 var DebugStoreImpl = /*#__PURE__*/function (_StoreImpl) {
   function DebugStoreImpl() {
@@ -1251,11 +1258,12 @@ var ConsoleInterceptor = /*#__PURE__*/_createClass(function ConsoleInterceptor(w
 function createDebugStore() {
   var watches = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
   var defaultActions = arguments.length > 1 ? arguments[1] : undefined;
+  var parsedDefaultActions = defaultActions ? new Set(defaultActions) : undefined;
   var parsedWatches = watches.map(function (watch) {
     if (typeof watch === 'string' || watch instanceof RegExp) {
       return {
         target: watch,
-        actions: defaultActions ? new Set(defaultActions) : undefined
+        actions: parsedDefaultActions
       };
     }
     if ('target' in watch) {
@@ -1263,11 +1271,11 @@ function createDebugStore() {
     }
     return {
       target: watch,
-      actions: defaultActions ? new Set(defaultActions) : undefined
+      actions: parsedDefaultActions
     };
   });
   var interceptor = new ConsoleInterceptor(parsedWatches);
   return createDebugStoreInternal(interceptor);
 }
 
-export { command, computed, createDebugStore, createStore, state };
+export { command, computed, createDebugStore, createStore, getDefaultStore, state };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccstate",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "description": "CCState Core",
   "private": false,
   "repository": {