@cosystem/react 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Coaction
+
+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.d.ts

@@ -0,0 +1,26 @@
+import { Context, ReactElement, ReactNode } from "react";
+import { App, InjectionToken } from "@cosystem/core";
+
+//#region src/index.d.ts
+interface CoSystemProviderProps {
+  readonly app: App;
+  readonly children?: ReactNode;
+}
+interface UseSelectorOptions<T> {
+  readonly equals?: (value: T, previous: T) => boolean;
+}
+type AppSelector<T> = (app: App) => T;
+type ModuleSelector<TModule, TValue> = (module: TModule, app: App) => TValue;
+declare const CoSystemContext: Context<App | null>;
+declare function CoSystemProvider({
+  app,
+  children
+}: CoSystemProviderProps): ReactElement;
+declare function useCoSystem(): App;
+declare function useApp(): App;
+declare function useModule<T>(token: InjectionToken<T>): T;
+declare function useSelector<T>(selector: AppSelector<T>, options?: UseSelectorOptions<T>): T;
+declare function useSelector<TModule, TValue>(token: InjectionToken<TModule>, selector: ModuleSelector<TModule, TValue>, options?: UseSelectorOptions<TValue>): TValue;
+//#endregion
+export { AppSelector, CoSystemContext, CoSystemProvider, CoSystemProviderProps, ModuleSelector, UseSelectorOptions, useApp, useCoSystem, useModule, useSelector };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;UAciB,qBAAA;EAAA,SACN,GAAA,EAAK,GAAA;EAAA,SACL,QAAA,GAAW,SAAA;AAAA;AAAA,UAGL,kBAAA;EAAA,SACN,MAAA,IAAU,KAAA,EAAO,CAAA,EAAG,QAAA,EAAU,CAAA;AAAA;AAAA,KAG7B,WAAA,OAAkB,GAAA,EAAK,GAAA,KAAQ,CAAA;AAAA,KAC/B,cAAA,qBAAmC,MAAA,EAAQ,OAAA,EAAS,GAAA,EAAK,GAAA,KAAQ,MAAA;AAAA,cAEhE,eAAA,EAAiB,OAAA,CAAQ,GAAA;AAAA,iBAEtB,gBAAA;EAAmB,GAAA;EAAK;AAAA,GAAY,qBAAA,GAAwB,YAAA;AAAA,iBAI5D,WAAA,IAAe,GAAA;AAAA,iBAUf,MAAA,IAAU,GAAA;AAAA,iBAIV,SAAA,IAAa,KAAA,EAAO,cAAA,CAAe,CAAA,IAAK,CAAA;AAAA,iBAIxC,WAAA,IAAe,QAAA,EAAU,WAAA,CAAY,CAAA,GAAI,OAAA,GAAU,kBAAA,CAAmB,CAAA,IAAK,CAAA;AAAA,iBAC3E,WAAA,kBACd,KAAA,EAAO,cAAA,CAAe,OAAA,GACtB,QAAA,EAAU,cAAA,CAAe,OAAA,EAAS,MAAA,GAClC,OAAA,GAAU,kBAAA,CAAmB,MAAA,IAC5B,MAAA"}

package/dist/index.js

@@ -0,0 +1,51 @@
+import { createContext, createElement, useCallback, useContext, useRef, useSyncExternalStore } from "react";
+import { CosystemError } from "@cosystem/core";
+//#region src/index.ts
+const CoSystemContext = createContext(null);
+function CoSystemProvider({ app, children }) {
+	return createElement(CoSystemContext.Provider, { value: app }, children);
+}
+function useCoSystem() {
+	const app = useContext(CoSystemContext);
+	if (app === null) throw new CosystemError("Missing CoSystemProvider.");
+	return app;
+}
+function useApp() {
+	return useCoSystem();
+}
+function useModule(token) {
+	return useCoSystem().getModule(token);
+}
+function useSelector(first, second, third) {
+	return useSelectedValue(useCoSystem(), typeof second === "function" ? (currentApp) => second(currentApp.getModule(first), currentApp) : first, (typeof second === "function" ? third : second) ?? {});
+}
+function useSelectedValue(app, selector, options) {
+	const selectorRef = useRef(selector);
+	const equalsRef = useRef(options.equals ?? objectIs);
+	const snapshotRef = useRef(void 0);
+	selectorRef.current = selector;
+	equalsRef.current = options.equals ?? objectIs;
+	const getSnapshot = useCallback(() => {
+		const next = selectorRef.current(app);
+		const current = snapshotRef.current;
+		if (current === void 0 || !equalsRef.current(next, current.value)) {
+			const snapshot = { value: next };
+			snapshotRef.current = snapshot;
+			return snapshot.value;
+		}
+		return current.value;
+	}, [app]);
+	return useSyncExternalStore(useCallback((notify) => app.watch(() => selectorRef.current(app), (value) => {
+		const current = snapshotRef.current;
+		if (current !== void 0 && equalsRef.current(value, current.value)) return;
+		snapshotRef.current = { value };
+		notify();
+	}, { equals: (value, previous) => equalsRef.current(value, previous) }), [app]), getSnapshot, getSnapshot);
+}
+function objectIs(value, previous) {
+	return Object.is(value, previous);
+}
+//#endregion
+export { CoSystemContext, CoSystemProvider, useApp, useCoSystem, useModule, useSelector };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  useCallback,\n  useContext,\n  useRef,\n  useSyncExternalStore,\n  type Context,\n  type ReactElement,\n  type ReactNode,\n} from \"react\";\n\nimport { CosystemError, type App, type InjectionToken } from \"@cosystem/core\";\n\nexport interface CoSystemProviderProps {\n  readonly app: App;\n  readonly children?: ReactNode;\n}\n\nexport interface UseSelectorOptions<T> {\n  readonly equals?: (value: T, previous: T) => boolean;\n}\n\nexport type AppSelector<T> = (app: App) => T;\nexport type ModuleSelector<TModule, TValue> = (module: TModule, app: App) => TValue;\n\nexport const CoSystemContext: Context<App | null> = createContext<App | null>(null);\n\nexport function CoSystemProvider({ app, children }: CoSystemProviderProps): ReactElement {\n  return createElement(CoSystemContext.Provider, { value: app }, children);\n}\n\nexport function useCoSystem(): App {\n  const app = useContext(CoSystemContext);\n\n  if (app === null) {\n    throw new CosystemError(\"Missing CoSystemProvider.\");\n  }\n\n  return app;\n}\n\nexport function useApp(): App {\n  return useCoSystem();\n}\n\nexport function useModule<T>(token: InjectionToken<T>): T {\n  return useCoSystem().getModule(token);\n}\n\nexport function useSelector<T>(selector: AppSelector<T>, options?: UseSelectorOptions<T>): T;\nexport function useSelector<TModule, TValue>(\n  token: InjectionToken<TModule>,\n  selector: ModuleSelector<TModule, TValue>,\n  options?: UseSelectorOptions<TValue>,\n): TValue;\nexport function useSelector<TModule, TValue>(\n  first: AppSelector<TValue> | InjectionToken<TModule>,\n  second?: ModuleSelector<TModule, TValue> | UseSelectorOptions<TValue>,\n  third?: UseSelectorOptions<TValue>,\n): TValue {\n  const app = useCoSystem();\n  const selector =\n    typeof second === \"function\"\n      ? (currentApp: App) =>\n          second(currentApp.getModule(first as InjectionToken<TModule>), currentApp)\n      : (first as AppSelector<TValue>);\n  const options = typeof second === \"function\" ? third : second;\n\n  return useSelectedValue(app, selector, options ?? {});\n}\n\nfunction useSelectedValue<T>(\n  app: App,\n  selector: AppSelector<T>,\n  options: UseSelectorOptions<T>,\n): T {\n  const selectorRef = useRef(selector);\n  const equalsRef = useRef(options.equals ?? objectIs);\n  const snapshotRef = useRef<{ readonly value: T }>(undefined);\n\n  selectorRef.current = selector;\n  equalsRef.current = options.equals ?? objectIs;\n\n  const getSnapshot = useCallback(() => {\n    const next = selectorRef.current(app);\n    const current = snapshotRef.current;\n\n    if (current === undefined || !equalsRef.current(next, current.value)) {\n      const snapshot = { value: next };\n      snapshotRef.current = snapshot;\n      return snapshot.value;\n    }\n\n    return current.value;\n  }, [app]);\n\n  const subscribe = useCallback(\n    (notify: () => void) =>\n      app.watch(\n        () => selectorRef.current(app),\n        (value) => {\n          const current = snapshotRef.current;\n\n          if (current !== undefined && equalsRef.current(value, current.value)) {\n            return;\n          }\n\n          snapshotRef.current = { value };\n          notify();\n        },\n        {\n          equals: (value, previous) => equalsRef.current(value, previous),\n        },\n      ),\n    [app],\n  );\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n}\n\nfunction objectIs<T>(value: T, previous: T): boolean {\n  return Object.is(value, previous);\n}\n"],"mappings":";;;AA0BA,MAAa,kBAAuC,cAA0B,IAAI;AAElF,SAAgB,iBAAiB,EAAE,KAAK,YAAiD;CACvF,OAAO,cAAc,gBAAgB,UAAU,EAAE,OAAO,IAAI,GAAG,QAAQ;AACzE;AAEA,SAAgB,cAAmB;CACjC,MAAM,MAAM,WAAW,eAAe;CAEtC,IAAI,QAAQ,MACV,MAAM,IAAI,cAAc,2BAA2B;CAGrD,OAAO;AACT;AAEA,SAAgB,SAAc;CAC5B,OAAO,YAAY;AACrB;AAEA,SAAgB,UAAa,OAA6B;CACxD,OAAO,YAAY,CAAC,CAAC,UAAU,KAAK;AACtC;AAQA,SAAgB,YACd,OACA,QACA,OACQ;CASR,OAAO,iBARK,YAQc,GANxB,OAAO,WAAW,cACb,eACC,OAAO,WAAW,UAAU,KAAgC,GAAG,UAAU,IAC1E,QACS,OAAO,WAAW,aAAa,QAAQ,WAEL,CAAC,CAAC;AACtD;AAEA,SAAS,iBACP,KACA,UACA,SACG;CACH,MAAM,cAAc,OAAO,QAAQ;CACnC,MAAM,YAAY,OAAO,QAAQ,UAAU,QAAQ;CACnD,MAAM,cAAc,OAA8B,KAAA,CAAS;CAE3D,YAAY,UAAU;CACtB,UAAU,UAAU,QAAQ,UAAU;CAEtC,MAAM,cAAc,kBAAkB;EACpC,MAAM,OAAO,YAAY,QAAQ,GAAG;EACpC,MAAM,UAAU,YAAY;EAE5B,IAAI,YAAY,KAAA,KAAa,CAAC,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;GACpE,MAAM,WAAW,EAAE,OAAO,KAAK;GAC/B,YAAY,UAAU;GACtB,OAAO,SAAS;EAClB;EAEA,OAAO,QAAQ;CACjB,GAAG,CAAC,GAAG,CAAC;CAuBR,OAAO,qBArBW,aACf,WACC,IAAI,YACI,YAAY,QAAQ,GAAG,IAC5B,UAAU;EACT,MAAM,UAAU,YAAY;EAE5B,IAAI,YAAY,KAAA,KAAa,UAAU,QAAQ,OAAO,QAAQ,KAAK,GACjE;EAGF,YAAY,UAAU,EAAE,MAAM;EAC9B,OAAO;CACT,GACA,EACE,SAAS,OAAO,aAAa,UAAU,QAAQ,OAAO,QAAQ,EAChE,CACF,GACF,CAAC,GAAG,CAG8B,GAAG,aAAa,WAAW;AACjE;AAEA,SAAS,SAAY,OAAU,UAAsB;CACnD,OAAO,OAAO,GAAG,OAAO,QAAQ;AAClC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@cosystem/react",
+  "version": "0.0.0",
+  "description": "React adapter for CoSystem.",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cosystem/core": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.17",
+    "@types/react-test-renderer": "19.1.0",
+    "react": "19.2.7",
+    "react-test-renderer": "19.2.7",
+    "tsdown": "0.22.3",
+    "typescript": "6.0.3",
+    "vitest": "4.1.9",
+    "@cosystem/tsconfig": "0.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.3.0 || >=19.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf coverage dist .turbo",
+    "dev": "tsdown --watch",
+    "test": "cd ../.. && vitest run --project @cosystem/react",
+    "test:coverage": "cd ../.. && vitest run --coverage --project @cosystem/react",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}