react-state-custom 1.0.24 → 1.0.25

package/dist/state-utils/createAutoCtx.d.ts

@@ -50,6 +50,6 @@ export declare const AutoRootCtx: ({ Wrapper }: {
  * ```
  * AutoRootCtx will subscribe/unsubscribe instances per unique params and render the appropriate Root under the hood.
  */
-export declare const createAutoCtx: <U extends object, V extends object>({ Root, useCtxState, useCtxStateStrict, resolveCtxName }: ReturnType<typeof createRootCtx<U, V>>, unmountTime?: number) => {
+export declare const createAutoCtx: <U extends object, V extends object>({ Root, resolveCtxName, name }: ReturnType<typeof createRootCtx<U, V>>, timeToClean?: number) => {
     useCtxState: (e: U) => Context<V>;
 };

package/dist/state-utils/createRootCtx.d.ts

@@ -29,6 +29,7 @@ import { Context } from './ctx';
  *   mount a single <AutoRootCtx Wrapper={ErrorBoundary} /> at the app root so you don't manually mount `Root`.
  */
 export declare const createRootCtx: <U extends object, V extends object>(name: string, useFn: (e: U) => V) => {
+    name: string;
     resolveCtxName: (e: U) => string;
     Root: import('react').FC<U>;
     /**

package/dist/state-utils/ctx.d.ts

@@ -17,6 +17,7 @@ export declare class Context<D> extends EventTarget {
      * Registry for tracking active keys (for duplicate detection).
      */
     registry: Set<string>;
+    useCounter: number;
     /**
      * Publish a value to the context and notify subscribers if it changed.
      * @param key - The key to update.

package/package.json

@@ -1,11 +1,23 @@
 {
   "name": "react-state-custom",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "The `react-state-custom` library provides a powerful set of tools for managing shared state in React applications",
   "type": "module",
   "main": "dist/index.umd.js",
   "module": "dist/index.es.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist/index.d.ts",
+    "dist/index.es.js",
+    "dist/index.es.js.map",
+    "dist/index.umd.js",
+    "dist/index.umd.js.map",
+    "dist/react-state-custom.css",
+    "dist/state-utils",
+    "dist/dev-tool",
+    "README.md",
+    "LICENSE"
+  ],
   "bugs": {
     "url": "https://github.com/vothanhdat/react-state-custom/issues"
   },
@@ -16,9 +28,11 @@
   "scripts": {
     "build": "vite build",
     "build:demo": "vite build --config vite.config.dev.ts",
-    "dev": "vite --config vite.config.dev.ts",
+    "dev": "vite",
+    "dev:playground": "vite --config vite.config.dev.ts",
     "test": "echo \"No tests specified\" && exit 0",
-    "preview": "vite preview --config vite.config.dev.ts"
+    "preview": "vite preview --config vite.config.dev.ts",
+    "prepublishOnly": "yarn build"
   },
   "keywords": [
     "frontend",
@@ -42,7 +56,7 @@
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-obj-view": "^1.0.4",
-    "react-state-custom": "^1.0.23",
+    "react-state-custom": "^1.0.24",
     "typescript": "^5.8.3",
     "vite": "7",
     "vite-bundle-analyzer": "^1.1.0",

package/.github/copilot-instructions.md

@@ -1,57 +0,0 @@
-## Project Snapshot
-- `react-state-custom` is a hook-first state management library; entrypoint `src/index.ts` re-exports context factories and subscription hooks.
-- TypeScript only; consumers are expected to be React 19 apps (see `package.json` peerDependencies).
-- Library build artifacts live in `dist/`; all source utilities reside under `src/state-utils/`.
-- Live demo at https://vothanhdat.github.io/react-state-custom/ showcases interactive examples.
-
-## Context Core
-- `Context` (`src/state-utils/ctx.ts`) extends `EventTarget`; `data` stores the latest values and `publish` fires per-key DOM events when a loose `!=` comparison detects change.
-- `getContext` memoizes by context name; `useDataContext(name)` memoizes the lookup via React `useMemo`.
-- `useDataSource`/`useDataSourceMultiple` publish new values and register keys in `ctx.registry`; duplicate sources log via `useRegistryChecker`.
-
-## Root Contexts
-- `createRootCtx(name, useFn)` (`src/state-utils/createRootCtx.tsx`) wraps your hook (`useFn`) in a hidden `Root` component that pushes its result into a derived context namespace.
-- Context names come from `name` plus sorted prop key/value pairs; keep props serializable and stable to avoid collisions.
-- `ctxMountedCheck` blocks multiple `Root` instances for the same name; duplicates throw with the original call stack.
-- Use `useCtxStateStrict` to hard-fail when the `Root` is missing, or `useCtxState` to surface a delayed console error instead.
-
-## Auto Context Lifecycle
-- `AutoRootCtx` (`src/state-utils/createAutoCtx.tsx`) maintains a global `'auto-ctx'` context exposing `subscribe(Root, params)` and reference counts for each instance.
-- Mount `<AutoRootCtx Wrapper={YourErrorBoundary}>` once near the app root; it renders requested `Root` components inside the optional wrapper.
-- `createAutoCtx(rootCtx, unmountTime?)` returns `useCtxState(params)` that subscribes through `'auto-ctx'` and hands back `useDataContext` for the resolved name.
-- Multiple callers with identical params share a single `Root`; `unmountTime` delays teardown to absorb rapid mount/unmount cycles.
-
-## Developer Tools
-- `DevToolContainer` (`src/dev-tool/DevTool.tsx`) provides a debugging UI for inspecting all context data; mount it alongside `<AutoRootCtx />`.
-- Accepts optional `Component` prop (type `DataViewComponent`) for custom data rendering; defaults to JSON stringify.
-- Import styles with `import 'react-state-custom/dist/react-state-custom.css'` when using DevTool.
-- Used in demo (`src/dev.tsx`, `src/examples/`) with `react-obj-view` for rich object inspection.
-
-## Subscription Patterns
-- `useDataSourceMultiple(ctx, ...entries)` expects stable `[key, value]` tuples; internal `useArrayHash` hashes length and reference equality only.
-- Use `useDataSubscribe(ctx, key, debounceMs)` or `useDataSubscribeMultiple(ctx, ...keys)` for keyed reads; debounce variants batch updates when values bounce.
-- `useDataSubscribeWithTransform` recomputes the transformed shape only on change; memoize the `transform` fn to avoid churn.
-- `useQuickSubscribe(ctx)` returns a proxy over `ctx.data`; destructure needed fields immediately during render and avoid storing the proxy for later use.
-
-## Utilities and Gotchas
-- Value comparisons are shallow; mutate objects before republishing or provide new references so `publish` sees changes.
-- `useArrayHash`/`useObjectHash` generate random hashes when array/object shape changes; they do not deep-compare nested content.
-- The reserved `'auto-ctx'` namespace powers `AutoRootCtx`; do not manually reuse this context name.
-
-## Examples
-- Five complete examples in `src/examples/`: counter, todo, form, timer, cart.
-- `Playground.tsx` uses `@codesandbox/sandpack-react` to render interactive examples with live editing.
-- Each example has `state.ts` (hook), `view.tsx` (components), `app.tsx` (root), and `index.ts` (exports).
-- Demo uses `?raw` imports to show source code in Sandpack editor.
-
-## Build and Tooling
-- `yarn build` runs Vite with `@vitejs/plugin-react`, `vite-plugin-dts`, and `vite-bundle-analyzer`; the analyzer spins up a server after builds—stop it in CI if unused.
-- `yarn dev` starts the Vite dev server on port 3000 with demo examples; `yarn build:demo` creates GitHub Pages build.
-- `yarn preview` previews demo build locally with correct base path (`/react-state-custom/`).
-- Tests are stubbed (`yarn test` exits 0 after printing "No tests specified"); add coverage before depending on test gates.
-- Repo is Yarn 4 (PnP); if editors struggle with module resolution, run `./fix-vscode-yarn-pnp.sh`.
-- GitHub Actions workflow (`.github/workflows/deploy.yml`) auto-deploys demo to GitHub Pages on push to master.
-
-## Reference Docs
-- README (`README.md`) offers narrative examples and positioning; includes live demo link.
-- API reference (`API_DOCUMENTATION.md`) documents every export; update alongside code changes.

package/.github/workflows/deploy.yml

@@ -1,56 +0,0 @@
-name: Deploy Demo to GitHub Pages
-
-on:
-  push:
-    branches:
-      - master
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-
-      - name: Enable Corepack
-        run: corepack enable
-
-      - name: Install dependencies
-        run: yarn install --immutable
-
-      - name: Build demo
-        run: yarn build:demo
-
-      - name: Setup Pages
-        uses: actions/configure-pages@v4
-
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: './demo-dist'
-
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4

package/.vscode/extensions.json

@@ -1,5 +0,0 @@
-{
-  "recommendations": [
-    "arcanis.vscode-zipfs"
-  ]
-}

package/.vscode/settings.json

@@ -1,8 +0,0 @@
-{
-  "typescript.tsdk": ".yarn/sdks/typescript/lib",
-  "typescript.enablePromptUseWorkspaceTsdk": true,
-  "search.exclude": {
-    "**/.yarn": true,
-    "**/.pnp.*": true
-  }
-}