react-state-basis 0.1.3 → 0.2.0

package/README.md

@@ -149,7 +149,19 @@ Replace your standard React hook imports with `react-state-basis`. This allows t
 // import { useState, useEffect } from 'react';
 
 // ✅ To this:
-import { useState, useEffect, useMemo, useContext } from 'react-state-basis';
+import { 
+  useState, 
+  useEffect, 
+  useMemo, 
+  useCallback,
+  useContext, 
+  useRef, 
+  useLayoutEffect, 
+  useId, 
+  useSyncExternalStore,
+  useDeferredValue, 
+  useTransition
+} from 'react-state-basis';
 
 function MyComponent() {
   const [data, setData] = useState([]); // Automatically vectorized and tracked
@@ -447,30 +459,29 @@ Think of it as an architectural smoke detector-not a fire marshal.
 
 ---
 
-## 🗺️ Roadmap & Future Improvements (v0.2.0+)
+## 🗺️ Roadmap: The Path to Architectural Rigor
 
-**React-State-Basis** is a solo-developed diagnostic infrastructure. I am currently working on the following features to enhance the "Zero-Friction" developer experience:
+React-State-Basis is evolving from a runtime auditor to a complete development infrastructure. Here is the planned trajectory:
 
-### 1. ⚡ Hybrid Production Strategy
-I am moving towards a "Set and Forget" model to eliminate manual import management:
-* **Production Pass-through:** A production-mode toggle that bypasses the auditing logic and maps directly to React core hooks with zero overhead.
-* **Tree-Shaking Optimization:** Ensuring the Linear Algebra engine and Circuit Breaker logic are physically excluded from production bundles via conditional exports.
+### **v0.2.0 - Full Hook Parity (Upcoming)**
+The goal is to make Basis a complete drop-in replacement for the standard React API.
+*   **Complete API Coverage:** Adding support for `useRef`, `useCallback`, `useLayoutEffect`, `useTransition`, `useDeferredValue`
+*   **Babel Enhancements:** Automated labeling for the entire hook suite to ensure zero-manual-config diagnostics.
+*   **Signature Robustness:** Smart disambiguation between dependency arrays and manual labels.
 
-### 2. 🛠️ CLI "Clean-Exit" Utility
-For engineers who prefer a purist approach or want to remove the dependency after a refactor phase:
-* **Automated Codemod:** I plan to release `npx rsb-clean`, a utility to automatically revert all `react-state-basis` imports back to standard `react` imports across your entire project.
-* **One-Command Cleanup:** Ensures a zero-overhead production build without manual searching and replacing.
+### **v0.3.0 - Modernity & Production Strategy**
+Aligning with the future of React and ensuring zero production cost.
+*   **React 19 Support:** Integration of `use()`, `useOptimistic()`, and `useActionState()` into the vector space model.
+*   **Zero-Overhead Production:** Implementing **Conditional Exports**. When in production mode, Basis will pass through raw React hooks with zero logic, ensuring no performance penalty.
 
-### 3. 📉 Dependency Topology Visualizer
-I want to transform the "Audit Report" from console logs into a visual map:
-* **Redundancy Clusters:** A 2D canvas showing "entangled" states as physical clusters.
-* **Vector Distance Mapping:** A visual representation of how close your state variables are to being collinear.
+### **v0.4.0 - Developer Ecosystem & Visuals**
+Tools for better ergonomics and high-level insights.
+*   **CLI Utilities (`rsb-init`, `rsb-clean`):** Automated codemods to instantly inject or remove Basis from large codebases. No more manual search-and-replace.
+*   **State-Space Visualizer:** A 2D topology map showing "Redundancy Clusters." Visualize your state vectors as physical nodes to identify where the architecture is collapsing.
 
-
-
-### 4. 🧪 CI/CD Integration
-* **Test-Health Reporting:** Integration with Vitest/Jest to automatically fail builds if a "Dimension Collapse" or "Infinite Loop" is detected during automated test runs.
-* **Architectural KPI tracking:** Monitoring your **System Efficiency Score** over time as the codebase grows.
+### **v1.0.0 - Formal Verification**
+*   **Architectural Gatekeeping:** CI/CD integration to fail builds on infinite loops or critical dimension collapses.
+*   **KPI Tracking:** Long-term monitoring of your application’s **System Efficiency Score**.
 
 ---
 

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import React, { Dispatch, SetStateAction, DependencyList, EffectCallback, Reducer, Context, ReactNode } from 'react';
+import * as react from 'react';
+import react__default, { Dispatch, SetStateAction, DependencyList, EffectCallback, Reducer, Context, ReactNode } from 'react';
 export { CSSProperties, Context, DependencyList, Dispatch, EffectCallback, FC, PropsWithChildren, ReactElement, ReactNode, Reducer, SetStateAction } from 'react';
 
 declare const history: Map<string, number[]>;
@@ -24,7 +25,17 @@ declare function useMemo<T>(factory: () => T, depsOrLabel?: DependencyList | str
 declare function useEffect(effect: EffectCallback, depsOrLabel?: DependencyList | string, label?: string): void;
 declare function useReducer<S, A, I>(reducer: Reducer<S, A>, initialArg: I & S, init?: any, label?: string): [S, Dispatch<A>];
 declare function createContext<T>(defaultValue: T, label?: string): Context<T>;
+declare function useCallback<T extends (...args: any[]) => any>(callback: T, depsOrLabel?: DependencyList | string, label?: string): T;
+declare function useRef<T>(initialValue: T, _label?: string): react.RefObject<T>;
+declare function useLayoutEffect(effect: EffectCallback, depsOrLabel?: DependencyList | string, label?: string): void;
 declare function useContext<T>(context: Context<T>): T;
+declare function useId(_label?: string): string;
+declare function useDebugValue<T>(value: T, formatter?: (value: T) => any, _label?: string): void;
+declare function useImperativeHandle<T, R extends T>(ref: React.Ref<T> | undefined, init: () => R, deps?: DependencyList, _label?: string): void;
+declare function useInsertionEffect(effect: EffectCallback, deps?: DependencyList, _label?: string): void;
+declare function useTransition(_label?: string): [boolean, (callback: () => void) => void];
+declare function useDeferredValue<T>(value: T, initialValueOrLabel?: T | string, label?: string): T;
+declare function useSyncExternalStore<Snapshot>(subscribe: (onStoreChange: () => void) => () => void, getSnapshot: () => Snapshot, getServerSnapshot?: () => Snapshot, _label?: string): Snapshot;
 declare const __test__: {
     registerVariable: (label: string) => void;
     unregisterVariable: (label: string) => void;
@@ -39,9 +50,9 @@ interface BasisProviderProps {
     children: ReactNode;
     debug?: boolean;
 }
-declare const BasisProvider: React.FC<BasisProviderProps>;
+declare const BasisProvider: react__default.FC<BasisProviderProps>;
 declare const useBasisConfig: () => {
     debug: boolean;
 };
 
-export { BasisProvider, __testEngine__, __test__, beginEffectTracking, createContext, currentTickBatch, endEffectTracking, history, printBasisHealthReport, recordUpdate, registerVariable, unregisterVariable, useBasisConfig, useContext, useEffect, useMemo, useReducer, useState };
+export { BasisProvider, __testEngine__, __test__, beginEffectTracking, createContext, currentTickBatch, endEffectTracking, history, printBasisHealthReport, recordUpdate, registerVariable, unregisterVariable, useBasisConfig, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore, useTransition };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import React, { Dispatch, SetStateAction, DependencyList, EffectCallback, Reducer, Context, ReactNode } from 'react';
+import * as react from 'react';
+import react__default, { Dispatch, SetStateAction, DependencyList, EffectCallback, Reducer, Context, ReactNode } from 'react';
 export { CSSProperties, Context, DependencyList, Dispatch, EffectCallback, FC, PropsWithChildren, ReactElement, ReactNode, Reducer, SetStateAction } from 'react';
 
 declare const history: Map<string, number[]>;
@@ -24,7 +25,17 @@ declare function useMemo<T>(factory: () => T, depsOrLabel?: DependencyList | str
 declare function useEffect(effect: EffectCallback, depsOrLabel?: DependencyList | string, label?: string): void;
 declare function useReducer<S, A, I>(reducer: Reducer<S, A>, initialArg: I & S, init?: any, label?: string): [S, Dispatch<A>];
 declare function createContext<T>(defaultValue: T, label?: string): Context<T>;
+declare function useCallback<T extends (...args: any[]) => any>(callback: T, depsOrLabel?: DependencyList | string, label?: string): T;
+declare function useRef<T>(initialValue: T, _label?: string): react.RefObject<T>;
+declare function useLayoutEffect(effect: EffectCallback, depsOrLabel?: DependencyList | string, label?: string): void;
 declare function useContext<T>(context: Context<T>): T;
+declare function useId(_label?: string): string;
+declare function useDebugValue<T>(value: T, formatter?: (value: T) => any, _label?: string): void;
+declare function useImperativeHandle<T, R extends T>(ref: React.Ref<T> | undefined, init: () => R, deps?: DependencyList, _label?: string): void;
+declare function useInsertionEffect(effect: EffectCallback, deps?: DependencyList, _label?: string): void;
+declare function useTransition(_label?: string): [boolean, (callback: () => void) => void];
+declare function useDeferredValue<T>(value: T, initialValueOrLabel?: T | string, label?: string): T;
+declare function useSyncExternalStore<Snapshot>(subscribe: (onStoreChange: () => void) => () => void, getSnapshot: () => Snapshot, getServerSnapshot?: () => Snapshot, _label?: string): Snapshot;
 declare const __test__: {
     registerVariable: (label: string) => void;
     unregisterVariable: (label: string) => void;
@@ -39,9 +50,9 @@ interface BasisProviderProps {
     children: ReactNode;
     debug?: boolean;
 }
-declare const BasisProvider: React.FC<BasisProviderProps>;
+declare const BasisProvider: react__default.FC<BasisProviderProps>;
 declare const useBasisConfig: () => {
     debug: boolean;
 };
 
-export { BasisProvider, __testEngine__, __test__, beginEffectTracking, createContext, currentTickBatch, endEffectTracking, history, printBasisHealthReport, recordUpdate, registerVariable, unregisterVariable, useBasisConfig, useContext, useEffect, useMemo, useReducer, useState };
+export { BasisProvider, __testEngine__, __test__, beginEffectTracking, createContext, currentTickBatch, endEffectTracking, history, printBasisHealthReport, recordUpdate, registerVariable, unregisterVariable, useBasisConfig, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore, useTransition };

package/dist/index.js

@@ -33,28 +33,35 @@ __export(index_exports, {
   registerVariable: () => registerVariable,
   unregisterVariable: () => unregisterVariable,
   useBasisConfig: () => useBasisConfig,
+  useCallback: () => useCallback,
   useContext: () => useContext,
+  useDebugValue: () => useDebugValue,
+  useDeferredValue: () => useDeferredValue,
   useEffect: () => useEffect,
+  useId: () => useId,
+  useImperativeHandle: () => useImperativeHandle,
+  useInsertionEffect: () => useInsertionEffect,
+  useLayoutEffect: () => useLayoutEffect,
   useMemo: () => useMemo,
   useReducer: () => useReducer,
-  useState: () => useState
+  useRef: () => useRef,
+  useState: () => useState,
+  useSyncExternalStore: () => useSyncExternalStore,
+  useTransition: () => useTransition
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/core/logger.ts
+var isWeb = typeof window !== "undefined" && typeof window.document !== "undefined";
 var STYLES = {
-  // Brand Colors
   basis: "background: #6c5ce7; color: white; font-weight: bold; padding: 2px 6px; border-radius: 3px;",
   version: "background: #a29bfe; color: #2d3436; padding: 2px 6px; border-radius: 3px; margin-left: -4px;",
-  // Headers
   headerRed: "background: #d63031; color: white; font-weight: bold; padding: 4px 8px; border-radius: 4px;",
   headerBlue: "background: #0984e3; color: white; font-weight: bold; padding: 4px 8px; border-radius: 4px;",
   headerGreen: "background: #00b894; color: white; font-weight: bold; padding: 4px 8px; border-radius: 4px;",
-  // Elements
   label: "background: #dfe6e9; color: #2d3436; padding: 0 4px; border-radius: 3px; font-family: monospace; font-weight: bold; border: 1px solid #b2bec3;",
   location: "color: #0984e3; font-family: monospace; font-weight: bold;",
   math: "color: #636e72; font-style: italic; font-family: serif;",
-  // Code Block
   codeBlock: `
     background: #1e1e1e; 
     color: #9cdcfe; 
@@ -66,7 +73,6 @@ var STYLES = {
     line-height: 1.4; 
     border-radius: 0 3px 3px 0;
   `,
-  // Highlights
   dim: "color: #e84393; font-weight: bold;",
   bold: "font-weight: bold;"
 };
@@ -77,9 +83,16 @@ var parseLabel = (label) => {
     name: parts[1] || label
   };
 };
+var logBasis = (message, ...styles) => {
+  if (isWeb) {
+    console.log(message, ...styles);
+  } else {
+    console.log(message.replace(/%c/g, ""));
+  }
+};
 var displayBootLog = (windowSize) => {
-  console.log(
-    `%cBasis%cAuditor v0.1.0%c Monitoring State Space | Window: ${windowSize} ticks`,
+  logBasis(
+    `%cBasis%cAuditor v0.1.4%c Monitoring State Space | Window: ${windowSize} ticks`,
     STYLES.basis,
     STYLES.version,
     "color: #636e72; font-style: italic; margin-left: 8px;"
@@ -89,87 +102,87 @@ var displayRedundancyAlert = (labelA, labelB, sim, totalDimensions) => {
   const infoA = parseLabel(labelA);
   const infoB = parseLabel(labelB);
   const isCrossFile = infoA.file !== infoB.file;
-  console.group(`%c \u{1F4D0} BASIS | DIMENSION COLLAPSE DETECTED `, STYLES.headerRed);
-  console.log(`%c\u{1F4CD} Location: %c${isCrossFile ? `${infoA.file} & ${infoB.file}` : infoA.file}`, STYLES.bold, STYLES.location);
-  console.log(
-    `%cAnalysis:%c Vectors %c${infoA.name}%c and %c${infoB.name}%c are collinear (redundant).`,
-    STYLES.bold,
-    "",
-    STYLES.label,
-    "",
-    STYLES.label,
-    ""
-  );
-  console.log(
-    `%cHow to fix:%c Project %c${infoB.name}%c as a derived value:
+  if (isWeb) {
+    console.group(`%c \u{1F4D0} BASIS | DIMENSION COLLAPSE DETECTED `, STYLES.headerRed);
+    console.log(`%c\u{1F4CD} Location: %c${isCrossFile ? `${infoA.file} & ${infoB.file}` : infoA.file}`, STYLES.bold, STYLES.location);
+    console.log(
+      `%cAnalysis:%c Vectors %c${infoA.name}%c and %c${infoB.name}%c are collinear (redundant).`,
+      STYLES.bold,
+      "",
+      STYLES.label,
+      "",
+      STYLES.label,
+      ""
+    );
+    console.log(
+      `%cHow to fix:%c Project %c${infoB.name}%c as a derived value:
 %c// \u{1F6E0}\uFE0F Basis Fix: Remove useState, use useMemo
 const ${infoB.name} = useMemo(() => deriveFrom(${infoA.name}), [${infoA.name}]);%c`,
-    "color: #00b894; font-weight: bold;",
-    "",
-    "color: #e84393; font-weight: bold;",
-    "",
-    STYLES.codeBlock,
-    ""
-  );
-  console.groupCollapsed(`%c \u{1F52C} Proof Details `, "color: #636e72; font-size: 10px; cursor: pointer;");
-  console.table({
-    "Similarity": `${(sim * 100).toFixed(2)}%`,
-    "Linear Dependency": "TRUE",
-    "Rank": totalDimensions - 1
-  });
-  console.groupEnd();
-  console.groupEnd();
+      "color: #00b894; font-weight: bold;",
+      "",
+      "color: #e84393; font-weight: bold;",
+      "",
+      STYLES.codeBlock,
+      ""
+    );
+    console.groupCollapsed(`%c \u{1F52C} Proof Details `, "color: #636e72; font-size: 10px; cursor: pointer;");
+    console.table({
+      "Similarity": `${(sim * 100).toFixed(2)}%`,
+      "Linear Dependency": "TRUE",
+      "Rank": totalDimensions - 1
+    });
+    console.groupEnd();
+    console.groupEnd();
+  } else {
+    console.log(`[BASIS] REDUNDANCY DETECTED: ${infoA.name} <-> ${infoB.name} (${(sim * 100).toFixed(0)}% similarity)`);
+    console.log(`Location: ${isCrossFile ? `${infoA.file} & ${infoB.file}` : infoA.file}`);
+  }
 };
 var displayCausalHint = (targetLabel, sourceLabel) => {
   const target = parseLabel(targetLabel);
   const source = parseLabel(sourceLabel);
   const isCrossFile = target.file !== source.file;
   const locationPath = isCrossFile ? `${source.file} \u2794 ${target.file}` : target.file;
-  console.groupCollapsed(`%c \u{1F4A1} BASIS | CAUSALITY (Sequential Update) `, STYLES.headerBlue);
-  console.log(`%c\u{1F4CD} Location: %c${locationPath}`, STYLES.bold, STYLES.location);
-  console.log(
-    `%cSequence:%c %c${source.name}%c \u2794 Effect \u2794 %c${target.name}%c`,
-    STYLES.bold,
-    "",
-    STYLES.label,
-    "",
-    STYLES.label,
-    ""
-  );
-  console.log(
-    `%cObservation:%c Variable %c${target.name}%c is being manually synchronized.
-This creates a %c"Double Render Cycle"%c.`,
-    STYLES.bold,
-    "",
-    STYLES.label,
-    "",
-    "color: #d63031; font-weight: bold;",
-    ""
-  );
-  console.log(
-    `%cHow to fix:%c Use %cuseMemo%c to calculate %c${target.name}%c during render:
-%cconst ${target.name} = useMemo(() => computeFrom(${source.name.includes("effect") ? "source" : source.name}), [${source.name.includes("effect") ? "source" : source.name}]);%c`,
-    "color: #00b894; font-weight: bold;",
-    "",
-    "color: #0984e3; font-weight: bold;",
-    "",
-    "color: #e84393; font-weight: bold;",
-    "",
-    STYLES.codeBlock,
-    ""
-  );
-  console.groupEnd();
+  if (isWeb) {
+    console.groupCollapsed(`%c \u{1F4A1} BASIS | CAUSALITY (Sequential Update) `, STYLES.headerBlue);
+    console.log(`%c\u{1F4CD} Location: %c${locationPath}`, STYLES.bold, STYLES.location);
+    console.log(
+      `%cSequence:%c %c${source.name}%c \u2794 Effect \u2794 %c${target.name}%c`,
+      STYLES.bold,
+      "",
+      STYLES.label,
+      "",
+      STYLES.label,
+      ""
+    );
+    console.log(
+      `%cObservation:%c Variable %c${target.name}%c is being manually synchronized. This creates a %c"Double Render Cycle"%c.`,
+      STYLES.bold,
+      "",
+      STYLES.label,
+      "",
+      "color: #d63031; font-weight: bold;",
+      ""
+    );
+    console.groupEnd();
+  } else {
+    console.log(`[BASIS] CAUSALITY: ${source.name} \u2794 ${target.name} (Double Render Cycle)`);
+  }
 };
 var displayInfiniteLoop = (label) => {
   const info = parseLabel(label);
-  console.group(`%c \u{1F6D1} BASIS CRITICAL | CIRCUIT BREAKER `, STYLES.headerRed);
-  console.error(
-    `Infinite oscillation detected on: %c${info.name}%c
-Execution halted to prevent browser thread lock. Check your dependency arrays.`,
-    "color: white; background: #d63031; padding: 2px 4px; border-radius: 3px;",
-    ""
-  );
-  console.groupEnd();
+  if (isWeb) {
+    console.group(`%c \u{1F6D1} BASIS CRITICAL | CIRCUIT BREAKER `, STYLES.headerRed);
+    console.error(
+      `Infinite oscillation detected on: %c${info.name}%c
+Execution halted to prevent browser thread lock.`,
+      "color: white; background: #d63031; padding: 2px 4px; border-radius: 3px;",
+      ""
+    );
+    console.groupEnd();
+  } else {
+    console.log(`[BASIS CRITICAL] INFINITE LOOP ON: ${info.name}. Execution halted.`);
+  }
 };
 var displayHealthReport = (history2, similarityFn, threshold) => {
   const entries = Array.from(history2.entries());
@@ -198,40 +211,45 @@ var displayHealthReport = (history2, similarityFn, threshold) => {
   });
   const systemRank = independentCount + clusters.length;
   const efficiency = systemRank / totalVars * 100;
-  console.group(`%c \u{1F4CA} BASIS | SYSTEM HEALTH REPORT `, STYLES.headerGreen);
-  console.log(
-    `%cBasis Efficiency: %c${efficiency.toFixed(1)}% %c(Rank: ${systemRank}/${totalVars})`,
-    STYLES.bold,
-    `color: ${efficiency > 85 ? "#00b894" : "#d63031"}; font-size: 16px; font-weight: bold;`,
-    "color: #636e72; font-style: italic;"
-  );
-  if (clusters.length > 0) {
-    console.log(`%cDetected ${clusters.length} Redundancy Clusters:`, "font-weight: bold; color: #e17055; margin-top: 10px;");
-    clusters.forEach((cluster, idx) => {
-      const names = cluster.map((l) => parseLabel(l).name).join(" \u27F7 ");
-      console.log(` %c${idx + 1}%c ${names}`, "background: #e17055; color: white; border-radius: 50%; padding: 0 5px;", "font-family: monospace;");
-    });
-  } else {
-    console.log("%c\u2728 All state variables are linearly independent. Your Basis is optimal.", "color: #00b894; font-weight: bold; margin-top: 10px;");
-  }
-  if (totalVars > 0 && totalVars < 15) {
-    console.groupCollapsed("%cView Full Correlation Matrix", "color: #636e72; font-size: 11px;");
-    const matrix = {};
-    entries.forEach(([labelA]) => {
-      const nameA = parseLabel(labelA).name;
-      matrix[nameA] = {};
-      entries.forEach(([labelB]) => {
-        const nameB = parseLabel(labelB).name;
-        const sim = similarityFn(history2.get(labelA), history2.get(labelB));
-        matrix[nameA][nameB] = sim > threshold ? `\u274C ${(sim * 100).toFixed(0)}%` : `\u2705`;
+  if (isWeb) {
+    console.group(`%c \u{1F4CA} BASIS | SYSTEM HEALTH REPORT `, STYLES.headerGreen);
+    console.log(
+      `%cBasis Efficiency: %c${efficiency.toFixed(1)}% %c(Rank: ${systemRank}/${totalVars})`,
+      STYLES.bold,
+      `color: ${efficiency > 85 ? "#00b894" : "#d63031"}; font-size: 16px; font-weight: bold;`,
+      "color: #636e72; font-style: italic;"
+    );
+    if (clusters.length > 0) {
+      console.log(`%cDetected ${clusters.length} Redundancy Clusters:`, "font-weight: bold; color: #e17055; margin-top: 10px;");
+      clusters.forEach((cluster, idx) => {
+        const names = cluster.map((l) => parseLabel(l).name).join(" \u27F7 ");
+        console.log(` %c${idx + 1}%c ${names}`, "background: #e17055; color: white; border-radius: 50%; padding: 0 5px;", "font-family: monospace;");
       });
-    });
-    console.table(matrix);
+    } else {
+      console.log("%c\u2728 All state variables are linearly independent. Your Basis is optimal.", "color: #00b894; font-weight: bold; margin-top: 10px;");
+    }
+    if (totalVars > 0 && totalVars < 15) {
+      console.groupCollapsed("%cView Full Correlation Matrix", "color: #636e72; font-size: 11px;");
+      const matrix = {};
+      entries.forEach(([labelA]) => {
+        const nameA = parseLabel(labelA).name;
+        matrix[nameA] = {};
+        entries.forEach(([labelB]) => {
+          const nameB = parseLabel(labelB).name;
+          const sim = similarityFn(history2.get(labelA), history2.get(labelB));
+          matrix[nameA][nameB] = sim > threshold ? `\u274C ${(sim * 100).toFixed(0)}%` : `\u2705`;
+        });
+      });
+      console.table(matrix);
+      console.groupEnd();
+    }
     console.groupEnd();
   } else {
-    console.log("%c[Note] Matrix hidden due to high dimensionality. Focus on clusters above.", "color: #636e72; font-size: 10px; font-style: italic;");
+    console.log(`[BASIS HEALTH] Efficiency: ${efficiency.toFixed(1)}% (Rank: ${systemRank}/${totalVars})`);
+    if (clusters.length > 0) {
+      console.log(`Redundancy Clusters: ${clusters.length}`);
+    }
   }
-  console.groupEnd();
 };
 
 // src/core/math.ts
@@ -340,7 +358,7 @@ function useState(initialValue, label) {
     registerVariable(effectiveLabel);
     return () => unregisterVariable(effectiveLabel);
   }, [effectiveLabel]);
-  const setter = (0, import_react.useCallback)((newValue) => {
+  const setter = useCallback((newValue) => {
     if (recordUpdate(effectiveLabel)) {
       setVal(newValue);
     }
@@ -377,7 +395,7 @@ function useReducer(reducer, initialArg, init, label) {
     registerVariable(effectiveLabel);
     return () => unregisterVariable(effectiveLabel);
   }, [effectiveLabel]);
-  const basisDispatch = (0, import_react.useCallback)((action) => {
+  const basisDispatch = useCallback((action) => {
     if (recordUpdate(effectiveLabel)) {
       dispatch(action);
     }
@@ -391,9 +409,74 @@ function createContext(defaultValue, label) {
   }
   return context;
 }
+function useCallback(callback, depsOrLabel, label) {
+  const isLabelAsSecondArg = typeof depsOrLabel === "string";
+  const actualDeps = isLabelAsSecondArg ? void 0 : depsOrLabel;
+  const effectiveLabel = isLabelAsSecondArg ? depsOrLabel : label || "anonymous_callback";
+  (0, import_react.useEffect)(() => {
+    if (window._basis_debug !== false) {
+      console.log(`%c [Basis] Stable Callback: "${effectiveLabel}" `, "color: #2ecc71; font-weight: bold;");
+    }
+  }, [effectiveLabel]);
+  return (0, import_react.useCallback)(callback, actualDeps || []);
+}
+function useRef(initialValue, _label) {
+  return (0, import_react.useRef)(initialValue);
+}
+function useLayoutEffect(effect, depsOrLabel, label) {
+  const isLabelAsSecondArg = typeof depsOrLabel === "string";
+  const actualDeps = isLabelAsSecondArg ? void 0 : depsOrLabel;
+  const effectiveLabel = isLabelAsSecondArg ? depsOrLabel : label || "anonymous_layout_effect";
+  (0, import_react.useLayoutEffect)(() => {
+    beginEffectTracking(effectiveLabel);
+    const cleanup = effect();
+    endEffectTracking();
+    return cleanup;
+  }, actualDeps);
+}
 function useContext(context) {
   return (0, import_react.useContext)(context);
 }
+function useId(_label) {
+  return (0, import_react.useId)();
+}
+function useDebugValue(value, formatter, _label) {
+  return (0, import_react.useDebugValue)(value, formatter);
+}
+function useImperativeHandle(ref, init, deps, _label) {
+  return (0, import_react.useImperativeHandle)(ref, init, deps);
+}
+function useInsertionEffect(effect, deps, _label) {
+  return (0, import_react.useInsertionEffect)(effect, deps);
+}
+function useTransition(_label) {
+  const [isPending, startTransition] = (0, import_react.useTransition)();
+  const effectiveLabel = _label || "anonymous_transition";
+  const basisStartTransition = (callback) => {
+    if (window._basis_debug !== false) {
+      console.log(`%c [Basis] Transition Started: "${effectiveLabel}" `, "color: #e67e22; font-weight: bold;");
+    }
+    startTransition(() => {
+      callback();
+    });
+  };
+  return [isPending, basisStartTransition];
+}
+function useDeferredValue(value, initialValueOrLabel, label) {
+  const isLabelAsSecondArg = typeof initialValueOrLabel === "string" && label === void 0;
+  const actualInitialValue = isLabelAsSecondArg ? void 0 : initialValueOrLabel;
+  const effectiveLabel = isLabelAsSecondArg ? initialValueOrLabel : label || "anonymous_deferred";
+  const deferredValue = (0, import_react.useDeferredValue)(value, actualInitialValue);
+  (0, import_react.useEffect)(() => {
+    if (window._basis_debug !== false && value !== deferredValue) {
+      console.log(`%c [Basis] Value Deferred: "${effectiveLabel}" `, "color: #e67e22; font-weight: bold;");
+    }
+  }, [value, deferredValue, effectiveLabel]);
+  return deferredValue;
+}
+function useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot, _label) {
+  return (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+}
 var __test__ = {
   registerVariable,
   unregisterVariable,
@@ -408,13 +491,14 @@ var __test__ = {
 var import_react2 = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
 var BasisContext = (0, import_react2.createContext)({ debug: false });
+var isWeb2 = typeof window !== "undefined" && typeof window.document !== "undefined";
 var BasisProvider = ({ children, debug = true }) => {
-  if (typeof window !== "undefined") {
+  if (isWeb2) {
     window._basis_debug = debug;
   }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(BasisContext.Provider, { value: { debug }, children: [
     children,
-    debug && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: {
+    debug && isWeb2 && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: {
       position: "fixed",
       bottom: 10,
       right: 10,
@@ -446,10 +530,20 @@ var useBasisConfig = () => (0, import_react2.useContext)(BasisContext);
   registerVariable,
   unregisterVariable,
   useBasisConfig,
+  useCallback,
   useContext,
+  useDebugValue,
+  useDeferredValue,
   useEffect,
+  useId,
+  useImperativeHandle,
+  useInsertionEffect,
+  useLayoutEffect,
   useMemo,
   useReducer,
-  useState
+  useRef,
+  useState,
+  useSyncExternalStore,
+  useTransition
 });
 //# sourceMappingURL=index.js.map