@necto-react/state 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Corinvo, LLC. and affiliates. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var m=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var U=(t,e)=>{for(var r in e)m(t,r,{get:e[r],enumerable:!0})},E=(t,e,r,S)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of O(e))!w.call(t,o)&&o!==r&&m(t,o,{get:()=>e[o],enumerable:!(S=y(e,o))||S.enumerable});return t};var b=t=>E(m({},"__esModule",{value:!0}),t);var k={};U(k,{Provider:()=>V,useSetState:()=>p,useState:()=>d,useStateValue:()=>i,useStore:()=>s});module.exports=b(k);var n=require("react");var a=require("react"),l=require("@necto/state"),x=(0,a.createContext)(void 0);function s(t){let e=(0,a.useContext)(x);return t?.store||e||(0,l.getDefaultStore)()}function V({children:t,store:e}){let r=(0,a.useRef)(null);return e?(0,a.createElement)(x.Provider,{value:e},t):(r.current===null&&(r.current=(0,l.createStore)()),(0,a.createElement)(x.Provider,{value:r.current},t))}function i(t,e){let r=s(e),[[S,o,g],c]=(0,n.useReducer)(u=>{let A=r.get(t);return Object.is(u[0],A)&&u[1]===r&&u[2]===t?u:[A,r,t]},void 0,()=>[r.get(t),r,t]),f=S;return(o!==r||g!==t)&&(c(),f=r.get(t)),(0,n.useEffect)(()=>{let u=r.sub(t,()=>{c()});return c(),u},[r,t]),(0,n.useDebugValue)(f),f}var R=require("react");function p(t,e){let r=s(e);return(0,R.useCallback)((...o)=>{if(!("write"in t))throw new Error("state is not writable");return r.set(t,...o)},[r,t])}function d(t,e){return[i(t,e),p(t,e)]}0&&(module.exports={Provider,useSetState,useState,useStateValue,useStore});

package/dist/index.d.cts

@@ -0,0 +1,96 @@
+import { Store, WritableState, PrimitiveState, SetStateAction, State, ExtractStateValue, ExtractStateArgs, ExtractStateResult } from '@necto/state';
+import { ReactNode, ReactElement } from 'react';
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseStateOptions = {
+    store?: Store;
+};
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type SetState$1<Args extends unknown[], Result> = (...args: Args) => Result;
+/** useState(writableState) — returns [value, setter] */
+declare function useState<Value, Args extends unknown[], Result>(s: WritableState<Value, Args, Result>, options?: UseStateOptions): [Awaited<Value>, SetState$1<Args, Result>];
+/** useState(primitiveState) — returns [value, setter] for a primitive state */
+declare function useState<Value>(s: PrimitiveState<Value>, options?: UseStateOptions): [Awaited<Value>, SetState$1<[SetStateAction<Value>], void>];
+/** useState(readOnlyState) — returns [value, never] for a read-only state */
+declare function useState<Value>(s: State<Value>, options?: UseStateOptions): [Awaited<Value>, never];
+/** useState(state) — generic overload */
+declare function useState<S extends WritableState<unknown, never[], unknown>>(s: S, options?: UseStateOptions): [
+    Awaited<ExtractStateValue<S>>,
+    SetState$1<ExtractStateArgs<S>, ExtractStateResult<S>>
+];
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseStateValueOptions = {
+    store?: Store;
+};
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/** useStateValue(state) — subscribe and return the current value */
+declare function useStateValue<Value>(s: State<Value>, options?: UseStateValueOptions): Awaited<Value>;
+declare function useStateValue<S extends State<unknown>>(s: S, options?: UseStateValueOptions): Awaited<ExtractStateValue<S>>;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseSetStateOptions = {
+    store?: Store;
+};
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type SetState<Args extends unknown[], Result> = (...args: Args) => Result;
+/** useSetState(state) — returns a stable setter function */
+declare function useSetState<Value, Args extends unknown[], Result>(s: WritableState<Value, Args, Result>, options?: UseSetStateOptions): SetState<Args, Result>;
+declare function useSetState<S extends WritableState<unknown, never[], unknown>>(s: S, options?: UseSetStateOptions): SetState<ExtractStateArgs<S>, ExtractStateResult<S>>;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseStoreOptions = {
+    store?: Store;
+};
+declare function useStore(options?: UseStoreOptions): Store;
+declare function Provider({ children, store, }: {
+    children?: ReactNode;
+    store?: Store;
+}): ReactElement;
+
+export { Provider, type UseSetStateOptions, type UseStateOptions, type UseStateValueOptions, useSetState, useState, useStateValue, useStore };

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import { Store, WritableState, PrimitiveState, SetStateAction, State, ExtractStateValue, ExtractStateArgs, ExtractStateResult } from '@necto/state';
+import { ReactNode, ReactElement } from 'react';
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseStateOptions = {
+    store?: Store;
+};
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type SetState$1<Args extends unknown[], Result> = (...args: Args) => Result;
+/** useState(writableState) — returns [value, setter] */
+declare function useState<Value, Args extends unknown[], Result>(s: WritableState<Value, Args, Result>, options?: UseStateOptions): [Awaited<Value>, SetState$1<Args, Result>];
+/** useState(primitiveState) — returns [value, setter] for a primitive state */
+declare function useState<Value>(s: PrimitiveState<Value>, options?: UseStateOptions): [Awaited<Value>, SetState$1<[SetStateAction<Value>], void>];
+/** useState(readOnlyState) — returns [value, never] for a read-only state */
+declare function useState<Value>(s: State<Value>, options?: UseStateOptions): [Awaited<Value>, never];
+/** useState(state) — generic overload */
+declare function useState<S extends WritableState<unknown, never[], unknown>>(s: S, options?: UseStateOptions): [
+    Awaited<ExtractStateValue<S>>,
+    SetState$1<ExtractStateArgs<S>, ExtractStateResult<S>>
+];
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseStateValueOptions = {
+    store?: Store;
+};
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/** useStateValue(state) — subscribe and return the current value */
+declare function useStateValue<Value>(s: State<Value>, options?: UseStateValueOptions): Awaited<Value>;
+declare function useStateValue<S extends State<unknown>>(s: S, options?: UseStateValueOptions): Awaited<ExtractStateValue<S>>;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseSetStateOptions = {
+    store?: Store;
+};
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type SetState<Args extends unknown[], Result> = (...args: Args) => Result;
+/** useSetState(state) — returns a stable setter function */
+declare function useSetState<Value, Args extends unknown[], Result>(s: WritableState<Value, Args, Result>, options?: UseSetStateOptions): SetState<Args, Result>;
+declare function useSetState<S extends WritableState<unknown, never[], unknown>>(s: S, options?: UseSetStateOptions): SetState<ExtractStateArgs<S>, ExtractStateResult<S>>;
+
+/**
+ * Copyright (c) Corinvo, LLC. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+type UseStoreOptions = {
+    store?: Store;
+};
+declare function useStore(options?: UseStoreOptions): Store;
+declare function Provider({ children, store, }: {
+    children?: ReactNode;
+    store?: Store;
+}): ReactElement;
+
+export { Provider, type UseSetStateOptions, type UseStateOptions, type UseStateValueOptions, useSetState, useState, useStateValue, useStore };

package/dist/index.js

@@ -0,0 +1 @@
+import{useDebugValue as O,useEffect as w,useReducer as U}from"react";import{createContext as d,createElement as f,useContext as A,useRef as R}from"react";import{createStore as g,getDefaultStore as y}from"@necto/state";var p=d(void 0);function a(t){let r=A(p);return t?.store||r||y()}function m({children:t,store:r}){let e=R(null);return r?f(p.Provider,{value:r},t):(e.current===null&&(e.current=g()),f(p.Provider,{value:e.current},t))}function s(t,r){let e=a(r),[[l,n,V],S]=U(o=>{let c=e.get(t);return Object.is(o[0],c)&&o[1]===e&&o[2]===t?o:[c,e,t]},void 0,()=>[e.get(t),e,t]),i=l;return(n!==e||V!==t)&&(S(),i=e.get(t)),w(()=>{let o=e.sub(t,()=>{S()});return S(),o},[e,t]),O(i),i}import{useCallback as E}from"react";function u(t,r){let e=a(r);return E((...n)=>{if(!("write"in t))throw new Error("state is not writable");return e.set(t,...n)},[e,t])}function x(t,r){return[s(t,r),u(t,r)]}export{m as Provider,u as useSetState,x as useState,s as useStateValue,a as useStore};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@necto-react/state",
+  "version": "0.0.1",
+  "description": "React bindings for @necto/state.",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "author": "Corinvo OSS Team",
+  "license": "MIT",
+  "dependencies": {
+    "@necto/state": "0.0.1"
+  },
+  "peerDependencies": {
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.1.2",
+    "@types/react-dom": "^19.1.2",
+    "jsdom": "^26.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.4.0"
+  },
+  "scripts": {
+    "build": "tsup --minify",
+    "test": "vitest"
+  }
+}