@geenius/tools 0.1.0 → 0.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@geenius/tools",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Geenius Tools — Reusable dev tools for React, Solid, and Convex",
   "author": "Antigravity HQ",
   "license": "MIT",
@@ -19,12 +19,32 @@
     "solidjs",
     "geenius"
   ],
+  "files": [
+    "packages/env/dist",
+    "packages/errors/dist",
+    "packages/errors/react/dist",
+    "packages/errors/solidjs/dist",
+    "packages/logger/dist",
+    "packages/logger/react/dist",
+    "packages/logger/solidjs/dist",
+    "packages/perf/dist",
+    "packages/perf/react/dist",
+    "packages/perf/solidjs/dist",
+    "packages/devtools/dist",
+    "packages/devtools/react/dist",
+    "packages/devtools/solidjs/dist",
+    "packages/shared/dist",
+    "packages/convex/shared/dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "dev": "pnpm -r --parallel type-check",
-    "build": "pnpm -r build",
+    "build": "pnpm -r --no-bail build",
     "clean": "pnpm -r clean",
     "lint": "pnpm -r --parallel type-check",
-    "test": "echo \"No tests configured yet\" && exit 0",
+    "test": "pnpm -r test",
     "type-check": "pnpm -r type-check",
     "format": "prettier --write \"packages/*/src/**/*.{ts,tsx}\"",
     "version:patch": "pnpm -r exec -- npm version patch --no-git-tag-version && npm version patch -m 'v%s'",
@@ -32,9 +52,12 @@
     "version:major": "pnpm -r exec -- npm version major --no-git-tag-version && npm version major -m 'v%s'",
     "release": "git push && git push --tags",
     "publish:all": "pnpm -r publish --access public",
+    "publish:root": "npm publish --access public",
+    "prepublishOnly": "pnpm build",
     "stop": "pkill -f 'vite.*geenius-tools' || true"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "prettier": "^3.8.1"
   },
   "engines": {
@@ -68,6 +91,42 @@
     "./convex": {
       "types": "./packages/convex/shared/dist/index.d.ts",
       "import": "./packages/convex/shared/dist/index.js"
+    },
+    "./shared": {
+      "types": "./packages/shared/dist/index.d.ts",
+      "import": "./packages/shared/dist/index.js"
+    },
+    "./errors-react": {
+      "types": "./packages/errors/react/dist/index.d.ts",
+      "import": "./packages/errors/react/dist/index.js"
+    },
+    "./errors-solid": {
+      "types": "./packages/errors/solidjs/dist/index.d.ts",
+      "import": "./packages/errors/solidjs/dist/index.js"
+    },
+    "./devtools/react": {
+      "types": "./packages/devtools/react/dist/index.d.ts",
+      "import": "./packages/devtools/react/dist/index.js"
+    },
+    "./devtools/solidjs": {
+      "types": "./packages/devtools/solidjs/dist/index.d.ts",
+      "import": "./packages/devtools/solidjs/dist/index.js"
+    },
+    "./logger/react": {
+      "types": "./packages/logger/react/dist/index.d.ts",
+      "import": "./packages/logger/react/dist/index.js"
+    },
+    "./logger/solidjs": {
+      "types": "./packages/logger/solidjs/dist/index.d.ts",
+      "import": "./packages/logger/solidjs/dist/index.js"
+    },
+    "./perf/react": {
+      "types": "./packages/perf/react/dist/index.d.ts",
+      "import": "./packages/perf/react/dist/index.js"
+    },
+    "./perf/solidjs": {
+      "types": "./packages/perf/solidjs/dist/index.d.ts",
+      "import": "./packages/perf/solidjs/dist/index.js"
     }
   },
   "main": "./packages/env/dist/index.js",

package/packages/convex/shared/README.md

@@ -1 +1 @@
-# ✦ @geenius-tools/convex\n\n> Typed error system for Convex applications\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-tools/convex\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-tools/convex';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/tools-convex\n\n> Typed error system for Convex applications\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/tools-convex\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/tools-convex';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/devtools/dist/index.d.ts

@@ -0,0 +1,204 @@
+/**
+ * @geenius/tools-devtools — Development tools and utilities
+ *
+ * Provides utilities for development, debugging, and development-time configuration.
+ * Includes feature flags, mock data, and debugging helpers.
+ */
+/**
+ * Feature flag configuration
+ */
+interface FeatureFlag {
+    /** Flag name */
+    name: string;
+    /** Whether flag is enabled */
+    enabled: boolean;
+    /** When flag was created */
+    createdAt?: Date;
+    /** When flag will be removed */
+    expiresAt?: Date;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Feature flags manager
+ *
+ * @example
+ * ```ts
+ * const flags = new FeatureFlagManager()
+ * flags.set('newUI', true)
+ * if (flags.isEnabled('newUI')) {
+ *   // Use new UI
+ * }
+ * ```
+ */
+declare class FeatureFlagManager {
+    private flags;
+    private listeners;
+    /**
+     * Sets a feature flag
+     */
+    set(name: string, enabled: boolean, description?: string): void;
+    /**
+     * Checks if feature is enabled
+     */
+    isEnabled(name: string): boolean;
+    /**
+     * Gets flag info
+     */
+    getFlag(name: string): FeatureFlag | undefined;
+    /**
+     * Gets all flags
+     */
+    getAllFlags(): FeatureFlag[];
+    /**
+     * Removes a flag
+     */
+    remove(name: string): void;
+    /**
+     * Clears all flags
+     */
+    clear(): void;
+    /**
+     * Listens for flag changes
+     */
+    onChange(callback: (name: string, enabled: boolean) => void): () => void;
+}
+/**
+ * Type-safe feature flag helper
+ *
+ * @example
+ * ```ts
+ * type AppFlags = 'newUI' | 'betaFeatures' | 'darkMode'
+ * const flags = createTypedFlags<AppFlags>()
+ * flags.set('newUI', true)
+ * ```
+ */
+declare function createTypedFlags<T extends string = string>(): {
+    set: (name: T, enabled: boolean) => void;
+    isEnabled: (name: T) => boolean;
+    getFlag: (name: T) => FeatureFlag | undefined;
+    getAllFlags: () => FeatureFlag[];
+    remove: (name: T) => void;
+    clear: () => void;
+    onChange: (callback: (name: T, enabled: boolean) => void) => () => void;
+};
+/**
+ * Development mode detector
+ *
+ * @returns True if running in development
+ */
+declare function isDevelopment(): boolean;
+/**
+ * Production mode detector
+ *
+ * @returns True if running in production
+ */
+declare function isProduction(): boolean;
+/**
+ * Debug helper for logging in dev mode only
+ *
+ * @example
+ * ```ts
+ * devLog('user state:', user)
+ * ```
+ */
+declare function devLog(...args: any[]): void;
+/**
+ * Debug warning in dev mode only
+ */
+declare function devWarn(...args: any[]): void;
+/**
+ * Assertion utility for development
+ *
+ * @throws Error if condition is false in development
+ */
+declare function devAssert(condition: boolean, message: string): void;
+/**
+ * Creates a mock data generator
+ *
+ * @example
+ * ```ts
+ * const mockUsers = generateMocks(10, () => ({
+ *   id: faker.string.uuid(),
+ *   name: faker.person.fullName(),
+ *   email: faker.internet.email()
+ * }))
+ * ```
+ */
+declare function generateMocks<T>(count: number, generator: () => T): T[];
+/**
+ * Measures React component render time
+ *
+ * @example
+ * ```ts
+ * function MyComponent() {
+ *   devMeasureRender('MyComponent')
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+declare function devMeasureRender(componentName: string): (() => void) | undefined;
+/**
+ * Deep object comparison for development assertions
+ *
+ * @returns True if objects are deeply equal
+ */
+declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * Creates a performance monitor that logs slow operations
+ *
+ * @example
+ * ```ts
+ * const monitor = createSlowOpMonitor(100) // log if > 100ms
+ * await monitor.track('api-call', async () => {
+ *   return fetch('/api/data')
+ * })
+ * ```
+ */
+declare function createSlowOpMonitor(thresholdMs: number): {
+    track: <T>(name: string, fn: () => Promise<T>) => Promise<T>;
+};
+/**
+ * Type assertion helper
+ *
+ * @throws Error if value is undefined/null in development
+ *
+ * @example
+ * ```ts
+ * const user = devAssertExists(data.user, 'user')
+ * ```
+ */
+declare function devAssertExists<T>(value: T | null | undefined, name: string): T;
+/**
+ * Global devtools window object
+ */
+interface DevtoolsWindow {
+    __GEENIUS_DEVTOOLS__?: {
+        flags: FeatureFlagManager;
+        isDevelopment: () => boolean;
+        devLog: (...args: any[]) => void;
+    };
+}
+/**
+ * Initializes global devtools object (browser only)
+ *
+ * @example
+ * ```ts
+ * initGlobalDevtools()
+ * window.__GEENIUS_DEVTOOLS__.devLog('debug info')
+ * ```
+ */
+declare function initGlobalDevtools(): void;
+/**
+ * Initializes devtools from environment
+ * Useful for loading feature flags from build-time environment variables
+ *
+ * @example
+ * ```ts
+ * const flags = createTypedFlags<'newUI' | 'beta'>()
+ * initDevtoolsFromEnv(flags, ['FEATURE_NEW_UI', 'FEATURE_BETA'])
+ * ```
+ */
+declare function initDevtoolsFromEnv<T extends string>(flags: ReturnType<typeof createTypedFlags<T>>, envKeys: string[]): void;
+
+export { type DevtoolsWindow, type FeatureFlag, FeatureFlagManager, createSlowOpMonitor, createTypedFlags, deepEqual, devAssert, devAssertExists, devLog, devMeasureRender, devWarn, generateMocks, initDevtoolsFromEnv, initGlobalDevtools, isDevelopment, isProduction };

package/packages/devtools/dist/index.js

@@ -0,0 +1,186 @@
+// src/index.ts
+var FeatureFlagManager = class {
+  flags = /* @__PURE__ */ new Map();
+  listeners = /* @__PURE__ */ new Set();
+  /**
+   * Sets a feature flag
+   */
+  set(name, enabled, description) {
+    this.flags.set(name, {
+      name,
+      enabled,
+      description,
+      createdAt: /* @__PURE__ */ new Date()
+    });
+    for (const listener of this.listeners) {
+      listener(name, enabled);
+    }
+  }
+  /**
+   * Checks if feature is enabled
+   */
+  isEnabled(name) {
+    return this.flags.get(name)?.enabled ?? false;
+  }
+  /**
+   * Gets flag info
+   */
+  getFlag(name) {
+    return this.flags.get(name);
+  }
+  /**
+   * Gets all flags
+   */
+  getAllFlags() {
+    return Array.from(this.flags.values());
+  }
+  /**
+   * Removes a flag
+   */
+  remove(name) {
+    this.flags.delete(name);
+  }
+  /**
+   * Clears all flags
+   */
+  clear() {
+    this.flags.clear();
+  }
+  /**
+   * Listens for flag changes
+   */
+  onChange(callback) {
+    this.listeners.add(callback);
+    return () => this.listeners.delete(callback);
+  }
+};
+function createTypedFlags() {
+  const manager = new FeatureFlagManager();
+  return {
+    set: (name, enabled) => manager.set(name, enabled),
+    isEnabled: (name) => manager.isEnabled(name),
+    getFlag: (name) => manager.getFlag(name),
+    getAllFlags: () => manager.getAllFlags(),
+    remove: (name) => manager.remove(name),
+    clear: () => manager.clear(),
+    onChange: (callback) => manager.onChange(callback)
+  };
+}
+function isDevelopment() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.NODE_ENV === "development" || process.env.DEBUG === "true" || false;
+  }
+  if (typeof window !== "undefined") {
+    return window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1";
+  }
+  return false;
+}
+function isProduction() {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.NODE_ENV === "production";
+  }
+  return !isDevelopment();
+}
+function devLog(...args) {
+  if (isDevelopment()) {
+    console.log("[DEV]", ...args);
+  }
+}
+function devWarn(...args) {
+  if (isDevelopment()) {
+    console.warn("[DEV WARN]", ...args);
+  }
+}
+function devAssert(condition, message) {
+  if (isDevelopment() && !condition) {
+    throw new Error(`[DEV ASSERTION] ${message}`);
+  }
+}
+function generateMocks(count, generator) {
+  return Array.from({ length: count }, () => generator());
+}
+function devMeasureRender(componentName) {
+  if (!isDevelopment()) return;
+  const start = performance.now();
+  return () => {
+    const duration = performance.now() - start;
+    if (duration > 16) {
+      console.warn(
+        `[PERF] ${componentName} render took ${duration.toFixed(2)}ms`
+      );
+    }
+  };
+}
+function deepEqual(a, b) {
+  if (a === b) return true;
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
+    return false;
+  }
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  for (const key of keysA) {
+    if (!deepEqual(a[key], b[key])) {
+      return false;
+    }
+  }
+  return true;
+}
+function createSlowOpMonitor(thresholdMs) {
+  return {
+    track: async (name, fn) => {
+      const start = performance.now();
+      const result = await fn();
+      const duration = performance.now() - start;
+      if (duration > thresholdMs) {
+        console.warn(
+          `[SLOW OP] ${name} took ${duration.toFixed(2)}ms (threshold: ${thresholdMs}ms)`
+        );
+      }
+      return result;
+    }
+  };
+}
+function devAssertExists(value, name) {
+  if (isDevelopment() && (value === null || value === void 0)) {
+    throw new Error(`Expected ${name} to exist, got ${value}`);
+  }
+  return value;
+}
+function initGlobalDevtools() {
+  if (typeof window === "undefined") return;
+  const flags = new FeatureFlagManager();
+  window.__GEENIUS_DEVTOOLS__ = {
+    flags,
+    isDevelopment,
+    devLog,
+    devWarn,
+    devAssert
+  };
+}
+function initDevtoolsFromEnv(flags, envKeys) {
+  for (const key of envKeys) {
+    const enabled = typeof process !== "undefined" && process.env[key] === "true";
+    if (enabled) {
+      const flagName = key.replace(/^FEATURE_/, "").toLowerCase();
+      flags.set(flagName, true);
+    }
+  }
+}
+export {
+  FeatureFlagManager,
+  createSlowOpMonitor,
+  createTypedFlags,
+  deepEqual,
+  devAssert,
+  devAssertExists,
+  devLog,
+  devMeasureRender,
+  devWarn,
+  generateMocks,
+  initDevtoolsFromEnv,
+  initGlobalDevtools,
+  isDevelopment,
+  isProduction
+};
+//# sourceMappingURL=index.js.map

package/packages/devtools/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @geenius/tools-devtools — Development tools and utilities\n *\n * Provides utilities for development, debugging, and development-time configuration.\n * Includes feature flags, mock data, and debugging helpers.\n */\n\n/**\n * Feature flag configuration\n */\nexport interface FeatureFlag {\n  /** Flag name */\n  name: string\n  /** Whether flag is enabled */\n  enabled: boolean\n  /** When flag was created */\n  createdAt?: Date\n  /** When flag will be removed */\n  expiresAt?: Date\n  /** Optional description */\n  description?: string\n}\n\n/**\n * Feature flags manager\n *\n * @example\n * ```ts\n * const flags = new FeatureFlagManager()\n * flags.set('newUI', true)\n * if (flags.isEnabled('newUI')) {\n *   // Use new UI\n * }\n * ```\n */\nexport class FeatureFlagManager {\n  private flags: Map<string, FeatureFlag> = new Map()\n  private listeners: Set<(flag: string, enabled: boolean) => void> = new Set()\n\n  /**\n   * Sets a feature flag\n   */\n  set(name: string, enabled: boolean, description?: string) {\n    this.flags.set(name, {\n      name,\n      enabled,\n      description,\n      createdAt: new Date(),\n    })\n\n    // Notify listeners\n    for (const listener of this.listeners) {\n      listener(name, enabled)\n    }\n  }\n\n  /**\n   * Checks if feature is enabled\n   */\n  isEnabled(name: string): boolean {\n    return this.flags.get(name)?.enabled ?? false\n  }\n\n  /**\n   * Gets flag info\n   */\n  getFlag(name: string): FeatureFlag | undefined {\n    return this.flags.get(name)\n  }\n\n  /**\n   * Gets all flags\n   */\n  getAllFlags(): FeatureFlag[] {\n    return Array.from(this.flags.values())\n  }\n\n  /**\n   * Removes a flag\n   */\n  remove(name: string) {\n    this.flags.delete(name)\n  }\n\n  /**\n   * Clears all flags\n   */\n  clear() {\n    this.flags.clear()\n  }\n\n  /**\n   * Listens for flag changes\n   */\n  onChange(callback: (name: string, enabled: boolean) => void): () => void {\n    this.listeners.add(callback)\n    return () => this.listeners.delete(callback)\n  }\n}\n\n/**\n * Type-safe feature flag helper\n *\n * @example\n * ```ts\n * type AppFlags = 'newUI' | 'betaFeatures' | 'darkMode'\n * const flags = createTypedFlags<AppFlags>()\n * flags.set('newUI', true)\n * ```\n */\nexport function createTypedFlags<T extends string = string>() {\n  const manager = new FeatureFlagManager()\n\n  return {\n    set: (name: T, enabled: boolean) => manager.set(name, enabled),\n    isEnabled: (name: T) => manager.isEnabled(name),\n    getFlag: (name: T) => manager.getFlag(name),\n    getAllFlags: () => manager.getAllFlags(),\n    remove: (name: T) => manager.remove(name),\n    clear: () => manager.clear(),\n    onChange: (callback: (name: T, enabled: boolean) => void) =>\n      manager.onChange(callback as any),\n  }\n}\n\n/**\n * Development mode detector\n *\n * @returns True if running in development\n */\nexport function isDevelopment(): boolean {\n  if (typeof process !== 'undefined' && process.env) {\n    return (\n      process.env.NODE_ENV === 'development' ||\n      process.env.DEBUG === 'true' ||\n      false\n    )\n  }\n\n  if (typeof window !== 'undefined') {\n    return (\n      window.location.hostname === 'localhost' ||\n      window.location.hostname === '127.0.0.1'\n    )\n  }\n\n  return false\n}\n\n/**\n * Production mode detector\n *\n * @returns True if running in production\n */\nexport function isProduction(): boolean {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.NODE_ENV === 'production'\n  }\n\n  return !isDevelopment()\n}\n\n/**\n * Debug helper for logging in dev mode only\n *\n * @example\n * ```ts\n * devLog('user state:', user)\n * ```\n */\nexport function devLog(...args: any[]) {\n  if (isDevelopment()) {\n    console.log('[DEV]', ...args)\n  }\n}\n\n/**\n * Debug warning in dev mode only\n */\nexport function devWarn(...args: any[]) {\n  if (isDevelopment()) {\n    console.warn('[DEV WARN]', ...args)\n  }\n}\n\n/**\n * Assertion utility for development\n *\n * @throws Error if condition is false in development\n */\nexport function devAssert(condition: boolean, message: string) {\n  if (isDevelopment() && !condition) {\n    throw new Error(`[DEV ASSERTION] ${message}`)\n  }\n}\n\n/**\n * Creates a mock data generator\n *\n * @example\n * ```ts\n * const mockUsers = generateMocks(10, () => ({\n *   id: faker.string.uuid(),\n *   name: faker.person.fullName(),\n *   email: faker.internet.email()\n * }))\n * ```\n */\nexport function generateMocks<T>(count: number, generator: () => T): T[] {\n  return Array.from({ length: count }, () => generator())\n}\n\n/**\n * Measures React component render time\n *\n * @example\n * ```ts\n * function MyComponent() {\n *   devMeasureRender('MyComponent')\n *   return <div>...</div>\n * }\n * ```\n */\nexport function devMeasureRender(componentName: string) {\n  if (!isDevelopment()) return\n\n  const start = performance.now()\n\n  return () => {\n    const duration = performance.now() - start\n    if (duration > 16) {\n      // Longer than 60fps frame\n      console.warn(\n        `[PERF] ${componentName} render took ${duration.toFixed(2)}ms`\n      )\n    }\n  }\n}\n\n/**\n * Deep object comparison for development assertions\n *\n * @returns True if objects are deeply equal\n */\nexport function deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true\n\n  if (\n    typeof a !== 'object' ||\n    typeof b !== 'object' ||\n    a === null ||\n    b === null\n  ) {\n    return false\n  }\n\n  const keysA = Object.keys(a)\n  const keysB = Object.keys(b)\n\n  if (keysA.length !== keysB.length) return false\n\n  for (const key of keysA) {\n    if (!deepEqual((a as any)[key], (b as any)[key])) {\n      return false\n    }\n  }\n\n  return true\n}\n\n/**\n * Creates a performance monitor that logs slow operations\n *\n * @example\n * ```ts\n * const monitor = createSlowOpMonitor(100) // log if > 100ms\n * await monitor.track('api-call', async () => {\n *   return fetch('/api/data')\n * })\n * ```\n */\nexport function createSlowOpMonitor(thresholdMs: number) {\n  return {\n    track: async <T,>(name: string, fn: () => Promise<T>): Promise<T> => {\n      const start = performance.now()\n      const result = await fn()\n      const duration = performance.now() - start\n\n      if (duration > thresholdMs) {\n        console.warn(\n          `[SLOW OP] ${name} took ${duration.toFixed(2)}ms (threshold: ${thresholdMs}ms)`\n        )\n      }\n\n      return result\n    },\n  }\n}\n\n/**\n * Type assertion helper\n *\n * @throws Error if value is undefined/null in development\n *\n * @example\n * ```ts\n * const user = devAssertExists(data.user, 'user')\n * ```\n */\nexport function devAssertExists<T>(value: T | null | undefined, name: string): T {\n  if (isDevelopment() && (value === null || value === undefined)) {\n    throw new Error(`Expected ${name} to exist, got ${value}`)\n  }\n  return value as T\n}\n\n/**\n * Global devtools window object\n */\nexport interface DevtoolsWindow {\n  __GEENIUS_DEVTOOLS__?: {\n    flags: FeatureFlagManager\n    isDevelopment: () => boolean\n    devLog: (...args: any[]) => void\n  }\n}\n\n/**\n * Initializes global devtools object (browser only)\n *\n * @example\n * ```ts\n * initGlobalDevtools()\n * window.__GEENIUS_DEVTOOLS__.devLog('debug info')\n * ```\n */\nexport function initGlobalDevtools() {\n  if (typeof window === 'undefined') return\n\n  const flags = new FeatureFlagManager()\n\n  ;(window as any).__GEENIUS_DEVTOOLS__ = {\n    flags,\n    isDevelopment,\n    devLog,\n    devWarn,\n    devAssert,\n  }\n}\n\n/**\n * Initializes devtools from environment\n * Useful for loading feature flags from build-time environment variables\n *\n * @example\n * ```ts\n * const flags = createTypedFlags<'newUI' | 'beta'>()\n * initDevtoolsFromEnv(flags, ['FEATURE_NEW_UI', 'FEATURE_BETA'])\n * ```\n */\nexport function initDevtoolsFromEnv<T extends string>(\n  flags: ReturnType<typeof createTypedFlags<T>>,\n  envKeys: string[]\n) {\n  for (const key of envKeys) {\n    const enabled =\n      typeof process !== 'undefined' &&\n      process.env[key] === 'true'\n\n    if (enabled) {\n      const flagName = key\n        .replace(/^FEATURE_/, '')\n        .toLowerCase() as T\n      flags.set(flagName, true)\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/packages/devtools/react/README.md

@@ -1 +1 @@
-# ✦ @geenius-tools/devtools-react\n\n> React dev-tools UI — floating toolbar, performance panel, inspector, GitHub issues\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-tools/devtools-react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-tools/devtools-react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/tools-devtools-react\n\n> React dev-tools UI — floating toolbar, performance panel, inspector, GitHub issues\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/tools-devtools-react\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/tools-devtools-react';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/devtools/solidjs/README.md

@@ -1 +1 @@
-# ✦ @geenius-tools/devtools-solidjs\n\n> SolidJS dev-tools UI — floating toolbar, performance panel, inspector, GitHub issues\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-tools/devtools-solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-tools/devtools-solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n
+# ✦ @geenius/tools-devtools-solidjs\n\n> SolidJS dev-tools UI — floating toolbar, performance panel, inspector, GitHub issues\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius/tools-devtools-solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius/tools-devtools-solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n