@react-arch/shared 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 React Arch
+
+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,32 @@
+//#region src/index.d.ts
+/**
+ * @react-arch/shared
+ *
+ * Framework-agnostic primitives shared across every React Arch package.
+ * No dependencies on React, Three.js, PixiJS, or browser APIs.
+ */
+type Vec2 = [number, number];
+type Vec3 = [number, number, number];
+type Units = "metric" | "imperial";
+/** Numeric tolerance for floating-point geometry comparisons. */
+declare const EPSILON = 0.000001;
+declare function approxEqual(a: number, b: number, eps?: number): boolean;
+declare function clamp(value: number, min: number, max: number): number;
+/** Round to a sane precision to avoid floating point noise in the model. */
+declare function round(value: number, decimals?: number): number;
+declare function createId(prefix?: string): string;
+/** Branded result of a model mutation. */
+type Severity = "error" | "warning" | "info";
+interface Diagnostic {
+  severity: Severity;
+  code: string;
+  message: string;
+  entityId?: string;
+  path?: string[];
+}
+type DeepReadonly<T> = T extends (infer R)[] ? ReadonlyArray<DeepReadonly<R>> : T extends object ? { readonly [K in keyof T]: DeepReadonly<T[K]> } : T;
+/** Structured-clone based deep copy, with a fallback for older runtimes. */
+declare function deepClone<T>(value: T): T;
+//#endregion
+export { DeepReadonly, Diagnostic, EPSILON, Severity, Units, Vec2, Vec3, approxEqual, clamp, createId, deepClone, round };
+//# 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":";;AAOA;;;;AAAgB;KAAJ,IAAA;AAAA,KACA,IAAA;AAAA,KAEA,KAAA;;cAGC,OAAA;AAAA,iBAEG,WAAA,CAAY,CAAA,UAAW,CAAA,UAAW,GAAA;AAAA,iBAIlC,KAAA,CAAM,KAAA,UAAe,GAAA,UAAa,GAAA;;iBAKlC,KAAA,CAAM,KAAA,UAAe,QAAY;AAAA,iBAUjC,QAAA,CAAS,MAAa;AArBtC;AAAA,KA6BY,QAAA;AAAA,UAEK,UAAA;EACf,QAAA,EAAU,QAAQ;EAClB,IAAA;EACA,OAAA;EACA,QAAA;EACA,IAAA;AAAA;AAAA,KAGU,YAAA,MAAkB,CAAA,uBAC1B,aAAA,CAAc,YAAA,CAAa,CAAA,KAC3B,CAAA,yCACyB,CAAA,GAAI,YAAA,CAAa,CAAA,CAAE,CAAA,OAC1C,CAAA;;iBAGU,SAAA,IAAa,KAAA,EAAO,CAAA,GAAI,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+//#region src/index.ts
+/** Numeric tolerance for floating-point geometry comparisons. */
+const EPSILON = 1e-6;
+function approxEqual(a, b, eps = EPSILON) {
+	return Math.abs(a - b) <= eps;
+}
+function clamp(value, min, max) {
+	return Math.min(max, Math.max(min, value));
+}
+/** Round to a sane precision to avoid floating point noise in the model. */
+function round(value, decimals = 4) {
+	const f = 10 ** decimals;
+	return Math.round(value * f) / f;
+}
+/**
+* Deterministic-ish id generator. Avoids `Math.random` at module load so the
+* model layer stays predictable and testable; callers may inject their own.
+*/
+let __counter = 0;
+function createId(prefix = "id") {
+	__counter += 1;
+	return `${prefix}_${Date.now().toString(36)}${__counter.toString(36)}`;
+}
+/** Structured-clone based deep copy, with a fallback for older runtimes. */
+function deepClone(value) {
+	if (typeof structuredClone === "function") return structuredClone(value);
+	return JSON.parse(JSON.stringify(value));
+}
+//#endregion
+export { EPSILON, approxEqual, clamp, createId, deepClone, round };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @react-arch/shared\n *\n * Framework-agnostic primitives shared across every React Arch package.\n * No dependencies on React, Three.js, PixiJS, or browser APIs.\n */\n\nexport type Vec2 = [number, number];\nexport type Vec3 = [number, number, number];\n\nexport type Units = \"metric\" | \"imperial\";\n\n/** Numeric tolerance for floating-point geometry comparisons. */\nexport const EPSILON = 1e-6;\n\nexport function approxEqual(a: number, b: number, eps = EPSILON): boolean {\n  return Math.abs(a - b) <= eps;\n}\n\nexport function clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value));\n}\n\n/** Round to a sane precision to avoid floating point noise in the model. */\nexport function round(value: number, decimals = 4): number {\n  const f = 10 ** decimals;\n  return Math.round(value * f) / f;\n}\n\n/**\n * Deterministic-ish id generator. Avoids `Math.random` at module load so the\n * model layer stays predictable and testable; callers may inject their own.\n */\nlet __counter = 0;\nexport function createId(prefix = \"id\"): string {\n  __counter += 1;\n  const time = Date.now().toString(36);\n  const seq = __counter.toString(36);\n  return `${prefix}_${time}${seq}`;\n}\n\n/** Branded result of a model mutation. */\nexport type Severity = \"error\" | \"warning\" | \"info\";\n\nexport interface Diagnostic {\n  severity: Severity;\n  code: string;\n  message: string;\n  entityId?: string;\n  path?: string[];\n}\n\nexport type DeepReadonly<T> = T extends (infer R)[]\n  ? ReadonlyArray<DeepReadonly<R>>\n  : T extends object\n    ? { readonly [K in keyof T]: DeepReadonly<T[K]> }\n    : T;\n\n/** Structured-clone based deep copy, with a fallback for older runtimes. */\nexport function deepClone<T>(value: T): T {\n  if (typeof structuredClone === \"function\") {\n    return structuredClone(value);\n  }\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n"],"mappings":";;AAaA,MAAa,UAAU;AAEvB,SAAgB,YAAY,GAAW,GAAW,MAAM,SAAkB;CACxE,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK;AAC5B;AAEA,SAAgB,MAAM,OAAe,KAAa,KAAqB;CACrE,OAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC3C;;AAGA,SAAgB,MAAM,OAAe,WAAW,GAAW;CACzD,MAAM,IAAI,MAAM;CAChB,OAAO,KAAK,MAAM,QAAQ,CAAC,IAAI;AACjC;;;;;AAMA,IAAI,YAAY;AAChB,SAAgB,SAAS,SAAS,MAAc;CAC9C,aAAa;CAGb,OAAO,GAAG,OAAO,GAFJ,KAAK,IAAI,CAAC,CAAC,SAAS,EAEV,IADX,UAAU,SAAS,EACF;AAC/B;;AAoBA,SAAgB,UAAa,OAAa;CACxC,IAAI,OAAO,oBAAoB,YAC7B,OAAO,gBAAgB,KAAK;CAE9B,OAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AACzC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@react-arch/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/react-arch/react-arch.git",
+    "directory": "packages/shared"
+  },
+  "license": "MIT",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "oxlint src",
+    "build": "tsdown"
+  }
+}