stroid 0.1.1 → 0.1.2

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @module store-lifecycle/types
+ *
+ * LAYER: Store lifecycle
+ * OWNS:  Module-level behavior and exports for store-lifecycle/types.
+ *
+ * Consumers: Internal imports and public API.
+ */
+type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+type PrevDepth = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+type PathInternal<T, Depth extends number> = Depth extends 0 ? never : T extends Primitive ? never : {
+    [K in keyof T & (string | number)]: T[K] extends Primitive | Array<unknown> ? `${K}` : `${K}` | `${K}.${PathInternal<T[K], PrevDepth[Depth]>}`;
+}[keyof T & (string | number)];
+type Path<T, Depth extends number = 10> = PathInternal<T, Depth>;
+type PathValue<T, P extends Path<T>> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? Rest extends Path<T[K]> ? PathValue<T[K], Rest> : never : never : P extends keyof T ? T[P] : never;
+type PartialDeep<T> = T extends Primitive ? T : unknown extends T ? T : {
+    [K in keyof T]?: PartialDeep<T[K]>;
+};
+type StoreValue = unknown;
+type HydrateSnapshotFor<Map extends object> = Partial<{
+    [K in keyof Map & string]: Map[K];
+}>;
+type HydrationFailureReason = "invalid-name" | "create-failed" | "merge-failed";
+type HydrationFailure = {
+    name: string;
+    reason: HydrationFailureReason;
+    cause?: unknown;
+    received?: unknown;
+};
+type HydrationBlockReason = "transaction" | "untrusted" | "validation-error" | "validation-failed";
+type HydrationResult = {
+    hydrated: string[];
+    created: string[];
+    failed: HydrationFailure[];
+    blocked?: {
+        reason: HydrationBlockReason;
+        cause?: unknown;
+    };
+};
+interface StoreStateMap {
+}
+interface StrictStoreMap {
+}
+type RegisteredStoreMap = StoreStateMap & StrictStoreMap;
+declare const storeNameBrand: unique symbol;
+type BrandedStoreName = string & {
+    readonly [storeNameBrand]: true;
+};
+type StoreName = (keyof RegisteredStoreMap & string) | BrandedStoreName;
+type StateFor<Name extends string> = Name extends keyof RegisteredStoreMap ? RegisteredStoreMap[Name] : StoreValue;
+type StoreKey<Name extends string = string, State = StoreValue> = StoreDefinition<Name, State> & {
+    __store?: true;
+};
+interface StoreDefinition<Name extends string = string, State = StoreValue> {
+    name: Name;
+    state?: State;
+}
+type WriteResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "not-found" | "validate" | "path" | "middleware" | "ssr" | "invalid-args" | "lazy-uninitialized";
+};
+
+export type { HydrateSnapshotFor as H, PartialDeep as P, StoreStateMap as S, WriteResult as W, StoreDefinition as a, StoreKey as b, StoreName as c, StoreValue as d, StateFor as e, StrictStoreMap as f, HydrationResult as g, HydrationFailure as h, Path as i, PathValue as j };

package/dist/utility.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module types/utility
+ *
+ * LAYER: Types
+ * OWNS:  Shared utility types for cross-module reuse.
+ *
+ * Consumers: store-create.ts, store-name.ts, computed.ts, testing.ts.
+ */
+type NonFunction<T> = T extends Function ? never : T;
+type TraceContext = {
+    traceId: string;
+    spanId: string;
+} & Record<string, unknown>;
+
+export type { NonFunction as N, TraceContext as T };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stroid",
-  "version": "0.1.1",
-  "description": "Named-store state engine for JavaScript/React with optional persistence, async caching, sync, and devtools.",
+  "version": "0.1.2",
+  "description": "SSR-Safe, Named-store state engine for JavaScript/React with optional persistence, async caching, sync, and devtools.",
   "keywords": [
     "state-management",
     "state",
@@ -77,8 +77,16 @@
       "import": "./dist/devtools.js"
     },
     "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js"
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "import": "./dist/vue/index.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "import": "./dist/svelte/index.js"
     },
     "./testing": {
       "types": "./dist/testing.d.ts",
@@ -104,19 +112,26 @@
   "sideEffects": [
     "./src/persist.ts",
     "./src/sync.ts",
-    "./src/devtools.ts",
+    "./src/devtools/index.ts",
+    "./src/core/store-notify.ts",
     "./dist/persist.js",
     "./dist/sync.js",
     "./dist/devtools.js"
   ],
   "scripts": {
-    "test": "node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test tests/async-cleanup.test.ts tests/async-revalidate-cleanup.test.ts tests/async.test.ts tests/computed.test.ts tests/coverage-extra.test.ts tests/feature-api.test.ts tests/helpers.test.ts tests/options-adapter.test.ts tests/persist.test.ts tests/react-hooks.test.tsx tests/regressions.test.ts tests/selectors-devfreeze.test.ts tests/ssr-carrier.test.ts tests/store.core.test.ts tests/store.node-env.test.ts tests/strict-missing-features.test.ts tests/sync.core.test.ts tests/testing.test.ts tests/utils.test.ts",
-    "test:coverage": "c8 --check-coverage --lines 80 --branches 80 --functions 80 --statements 80 node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test tests/async-cleanup.test.ts tests/async-revalidate-cleanup.test.ts tests/async.test.ts tests/computed.test.ts tests/coverage-extra.test.ts tests/feature-api.test.ts tests/helpers.test.ts tests/options-adapter.test.ts tests/persist.test.ts tests/react-hooks.test.tsx tests/regressions.test.ts tests/selectors-devfreeze.test.ts tests/ssr-carrier.test.ts tests/store.core.test.ts tests/store.node-env.test.ts tests/strict-missing-features.test.ts tests/sync.core.test.ts tests/testing.test.ts tests/utils.test.ts",
-    "test:heavy": "node --import tsx --test tests/heavy/store.heavy.ts",
-    "test:types": "npm run build && tsc -p tsconfig.typetests.json",
+    "test": "node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test-concurrency=1 --test tests/unit/**/*.test.ts tests/unit/**/*.test.tsx tests/integration/**/*.test.ts tests/integration/**/*.test.tsx tests/regression/**/*.test.ts tests/ssr/**/*.test.ts tests/utils/**/*.test.ts",
+    "test:coverage": "c8 node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test tests/unit/**/*.test.ts tests/unit/**/*.test.tsx tests/integration/**/*.test.ts tests/integration/**/*.test.tsx tests/regression/**/*.test.ts tests/ssr/**/*.test.ts tests/utils/**/*.test.ts",
+    "test:performance": "node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test-concurrency=1 --test tests/performance/**/*.test.ts",
+    "test:heavy": "npm run test:performance",
+    "check:react-types": "node scripts/check-react-types.mjs",
+    "docs:api": "api-extractor run --local",
+    "test:dts": "tsc -p tsconfig.dtscheck.json --noEmit",
+    "test:types": "npm run build && npm run check:react-types && npm run docs:api && npm run test:dts && tsc -p tsconfig.typetests.json",
     "typecheck": "tsc -p tsconfig.types.json",
-    "build": "tsup",
-    "test:all": "npm test && npm run test:types"
+    "typecheck:layers": "tsc -b tsconfig.layers.json",
+    "build": "tsup && node scripts/normalize-dts.mjs",
+    "test:all": "npm test && npm run test:types",
+    "test:full": "npm run test:coverage && npm run test:types"
   },
   "engines": {
     "node": ">=18"