@number10/jsx-core 5.0.0

package/dist/dev-config.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Development and debugging configuration
+ * Runtime-configurable settings for debugging and development
+ */
+/**
+ * Development configuration object
+ * Can be modified at runtime from user code for debugging
+ *
+ * @example
+ * ```typescript
+ * import { DevConfig } from '@number10/phaserjsx'
+ *
+ * // Enable specific debug categories
+ * DevConfig.debug.enabled = true
+ * DevConfig.debug.layout = true
+ *
+ * // Customize visual debugging
+ * DevConfig.visual.maskFillColor = 0xff00ff  // Pink
+ * DevConfig.visual.maskAlpha = 0.3           // Semi-transparent
+ * ```
+ */
+export declare const DevConfig: {
+    /**
+     * Debug logging configuration
+     * Controls console output for different subsystems
+     */
+    debug: {
+        /**
+         * Master switch - disables all debug output when false
+         * @default false
+         */
+        enabled: boolean;
+        /**
+         * Detailed layout calculation logs
+         * Shows container sizing, positioning, and flex distribution
+         * @default false
+         */
+        layout: boolean;
+        /**
+         * Overflow mask positioning logs
+         * Shows world coordinate calculations and mask updates
+         * @default false
+         */
+        overflowMask: boolean;
+        /**
+         * Flex distribution calculations
+         * Shows flex space allocation across children
+         * @default false
+         */
+        flex: boolean;
+        /**
+         * Child sizing and positioning
+         * Shows individual child dimension calculations
+         * @default false
+         */
+        positioning: boolean;
+        /**
+         * VDOM mount/patch/unmount operations
+         * Shows virtual DOM updates and reconciliation
+         * @default false
+         */
+        vdom: boolean;
+        /**
+         * Performance timing measurements
+         * Shows execution time for layout operations
+         * @default false
+         */
+        performance: boolean;
+        /**
+         * Theme system logs
+         * Shows theme registry updates and prop merging
+         * @default false
+         */
+        theme: boolean;
+    };
+    /**
+     * VDOM warnings and development checks
+     * These help catch common mistakes that lead to performance issues
+     */
+    warnings: {
+        /**
+         * Warn when list items (siblings) don't have key props
+         * Similar to React's "Each child in a list should have a unique key prop" warning
+         * @default true (in development)
+         */
+        missingKeys: boolean;
+        /**
+         * Warn when props change causes full remount instead of update
+         * Detects JSX/callback recreation that prevents VDOM optimization
+         * @default true (in development)
+         */
+        unnecessaryRemounts: boolean;
+        /**
+         * Warn when VNodes are frozen/sealed and need copying
+         * Happens in production builds or with certain bundler optimizations
+         * @default false (usually only relevant in production)
+         */
+        frozenVNodes: boolean;
+    };
+    /**
+     * Visual debugging aids
+     * Runtime-configurable visual settings
+     */
+    visual: {
+        /**
+         * Show overflow mask areas
+         * When true, masks are visible (alpha > 0) for debugging
+         * @default false
+         */
+        showOverflowMasks: boolean;
+        /**
+         * Mask fill color
+         * @default 0xffffff (white, invisible with alpha=0)
+         * @example 0xff00ff (pink for debugging)
+         */
+        maskFillColor: number;
+        /**
+         * Mask alpha transparency
+         * @default 0.0 (invisible)
+         * @example 0.3 (semi-transparent for debugging)
+         */
+        maskAlpha: number;
+    };
+    /**
+     * Performance tuning
+     */
+    performance: {
+        /**
+         * Enable deferred layout queue batching
+         * When false, deferred updates execute immediately (not batched)
+         * @default true
+         */
+        useDeferredQueue: boolean;
+        /**
+         * Log deferred queue statistics
+         * Shows number of batched callbacks per frame
+         * @default false
+         */
+        logQueueStats: boolean;
+    };
+};
+/**
+ * Debug logger with category support
+ * Only logs when global debug is enabled AND category is enabled
+ *
+ * @example
+ * ```typescript
+ * DebugLogger.log('layout', 'Container size:', { width: 100, height: 200 })
+ * // Only logs if DevConfig.debug.enabled && DevConfig.debug.layout
+ * ```
+ */
+export declare class DebugLogger {
+    /**
+     * Debounced console.log instances per category-message combination
+     */
+    private static debouncedLoggers;
+    /**
+     * Log a message with category filtering and debouncing
+     * @param category - Debug category to check
+     * @param message - Message to log
+     * @param args - Additional arguments to log (only first element is used)
+     */
+    static log(category: keyof typeof DevConfig.debug, message: string, ...args: unknown[]): void;
+    /**
+     * Log a warning message (always shown, even if debug disabled)
+     * @param category - Category for context
+     * @param message - Warning message
+     * @param args - Additional arguments
+     */
+    static warn(category: string, message: string, ...args: unknown[]): void;
+    /**
+     * Log an error message (always shown, even if debug disabled)
+     * @param category - Category for context
+     * @param message - Error message
+     * @param args - Additional arguments
+     */
+    static error(category: string, message: string, ...args: unknown[]): void;
+    /**
+     * Start a performance timer
+     * @param category - Debug category to check
+     * @param label - Timer label
+     */
+    static time(category: keyof typeof DevConfig.debug, label: string): void;
+    /**
+     * End a performance timer
+     * @param category - Debug category to check
+     * @param label - Timer label
+     */
+    static timeEnd(category: keyof typeof DevConfig.debug, label: string): void;
+}
+/**
+ * Predefined configuration presets for common debugging scenarios
+ *
+ * @example
+ * ```typescript
+ * import { DevPresets } from '@number10/phaserjsx'
+ *
+ * // Quick activation of overflow debugging
+ * DevPresets.debugOverflow()
+ *
+ * // Revert to production settings
+ * DevPresets.production()
+ * ```
+ */
+export declare const DevPresets: {
+    /**
+     * Production configuration
+     * All debugging disabled, optimal performance
+     */
+    production: () => void;
+    /**
+     * Debug layout issues
+     * Enables layout, positioning, and flex logs
+     */
+    debugLayout: () => void;
+    /**
+     * Debug overflow masking
+     * Enables overflow logs and makes masks visible
+     */
+    debugOverflow: () => void;
+    /**
+     * Performance profiling
+     * Enables performance timing and queue statistics
+     */
+    profilePerformance: () => void;
+    /**
+     * Debug VDOM operations
+     * Enables virtual DOM mount/patch/unmount logs
+     */
+    debugVDOM: () => void;
+    debugTheme: () => void;
+    /**
+     * Enable all debug categories (verbose!)
+     * Use with caution - produces lots of console output
+     */
+    debugAll: () => void;
+};
+//# sourceMappingURL=dev-config.d.ts.map

package/dist/dev-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-config.d.ts","sourceRoot":"","sources":["../src/dev-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;IACpB;;;OAGG;;QAED;;;WAGG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;;IAIL;;;OAGG;;QAED;;;;WAIG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;;IAIL;;;OAGG;;QAED;;;;WAIG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;;IAIL;;OAEG;;QAED;;;;WAIG;;QAGH;;;;WAIG;;;CAGN,CAAA;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAkD;IAEjF;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,OAAO,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAmB7F;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIxE;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIzE;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOxE;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAM5E;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU;IACrB;;;OAGG;sBACa,IAAI;IAQpB;;;OAGG;uBACc,IAAI;IAWrB;;;OAGG;yBACgB,IAAI;IAcvB;;;OAGG;8BACqB,IAAI;IAY5B;;;OAGG;qBACY,IAAI;sBAWH,IAAI;IAYpB;;;OAGG;oBACW,IAAI;CAanB,CAAA"}

package/dist/dev-config.js

@@ -0,0 +1,296 @@
+function debounce(fn, delay) {
+  let timeoutId;
+  return (...args) => {
+    if (timeoutId !== void 0) clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => {
+      timeoutId = void 0;
+      fn(...args);
+    }, delay);
+  };
+}
+const DevConfig = {
+  /**
+   * Debug logging configuration
+   * Controls console output for different subsystems
+   */
+  debug: {
+    /**
+     * Master switch - disables all debug output when false
+     * @default false
+     */
+    enabled: false,
+    /**
+     * Detailed layout calculation logs
+     * Shows container sizing, positioning, and flex distribution
+     * @default false
+     */
+    layout: false,
+    /**
+     * Overflow mask positioning logs
+     * Shows world coordinate calculations and mask updates
+     * @default false
+     */
+    overflowMask: false,
+    /**
+     * Flex distribution calculations
+     * Shows flex space allocation across children
+     * @default false
+     */
+    flex: false,
+    /**
+     * Child sizing and positioning
+     * Shows individual child dimension calculations
+     * @default false
+     */
+    positioning: false,
+    /**
+     * VDOM mount/patch/unmount operations
+     * Shows virtual DOM updates and reconciliation
+     * @default false
+     */
+    vdom: false,
+    /**
+     * Performance timing measurements
+     * Shows execution time for layout operations
+     * @default false
+     */
+    performance: false,
+    /**
+     * Theme system logs
+     * Shows theme registry updates and prop merging
+     * @default false
+     */
+    theme: false
+  },
+  /**
+   * VDOM warnings and development checks
+   * These help catch common mistakes that lead to performance issues
+   */
+  warnings: {
+    /**
+     * Warn when list items (siblings) don't have key props
+     * Similar to React's "Each child in a list should have a unique key prop" warning
+     * @default true (in development)
+     */
+    missingKeys: false,
+    // temp disable because of detection issues, will re-enable later
+    /**
+     * Warn when props change causes full remount instead of update
+     * Detects JSX/callback recreation that prevents VDOM optimization
+     * @default true (in development)
+     */
+    unnecessaryRemounts: false,
+    /**
+     * Warn when VNodes are frozen/sealed and need copying
+     * Happens in production builds or with certain bundler optimizations
+     * @default false (usually only relevant in production)
+     */
+    frozenVNodes: false
+  },
+  /**
+   * Visual debugging aids
+   * Runtime-configurable visual settings
+   */
+  visual: {
+    /**
+     * Show overflow mask areas
+     * When true, masks are visible (alpha > 0) for debugging
+     * @default false
+     */
+    showOverflowMasks: false,
+    /**
+     * Mask fill color
+     * @default 0xffffff (white, invisible with alpha=0)
+     * @example 0xff00ff (pink for debugging)
+     */
+    maskFillColor: 16777215,
+    /**
+     * Mask alpha transparency
+     * @default 0.0 (invisible)
+     * @example 0.3 (semi-transparent for debugging)
+     */
+    maskAlpha: 0
+  },
+  /**
+   * Performance tuning
+   */
+  performance: {
+    /**
+     * Enable deferred layout queue batching
+     * When false, deferred updates execute immediately (not batched)
+     * @default true
+     */
+    useDeferredQueue: true,
+    /**
+     * Log deferred queue statistics
+     * Shows number of batched callbacks per frame
+     * @default false
+     */
+    logQueueStats: false
+  }
+};
+class DebugLogger {
+  /**
+   * Debounced console.log instances per category-message combination
+   */
+  static debouncedLoggers = /* @__PURE__ */ new Map();
+  /**
+   * Log a message with category filtering and debouncing
+   * @param category - Debug category to check
+   * @param message - Message to log
+   * @param args - Additional arguments to log (only first element is used)
+   */
+  static log(category, message, ...args) {
+    if (!DevConfig.debug.enabled) return;
+    if (category !== "enabled" && !DevConfig.debug[category]) return;
+    const key = `${String(category)}:${message}`;
+    let debouncedLog = this.debouncedLoggers.get(key);
+    if (!debouncedLog) {
+      debouncedLog = debounce(() => {
+        console.log(`[${category}] ${message}`, args[0]);
+      }, 300);
+      this.debouncedLoggers.set(key, debouncedLog);
+    }
+    debouncedLog();
+  }
+  /**
+   * Log a warning message (always shown, even if debug disabled)
+   * @param category - Category for context
+   * @param message - Warning message
+   * @param args - Additional arguments
+   */
+  static warn(category, message, ...args) {
+    console.warn(`[${category}] ${message}`, ...args);
+  }
+  /**
+   * Log an error message (always shown, even if debug disabled)
+   * @param category - Category for context
+   * @param message - Error message
+   * @param args - Additional arguments
+   */
+  static error(category, message, ...args) {
+    console.error(`[${category}] ${message}`, ...args);
+  }
+  /**
+   * Start a performance timer
+   * @param category - Debug category to check
+   * @param label - Timer label
+   */
+  static time(category, label) {
+    if (!DevConfig.debug.enabled) return;
+    if (category !== "enabled" && !DevConfig.debug[category]) return;
+    console.time(`[${category}] ${label}`);
+  }
+  /**
+   * End a performance timer
+   * @param category - Debug category to check
+   * @param label - Timer label
+   */
+  static timeEnd(category, label) {
+    if (!DevConfig.debug.enabled) return;
+    if (category !== "enabled" && !DevConfig.debug[category]) return;
+    console.timeEnd(`[${category}] ${label}`);
+  }
+}
+const DevPresets = {
+  /**
+   * Production configuration
+   * All debugging disabled, optimal performance
+   */
+  production: () => {
+    DevConfig.debug.enabled = false;
+    DevConfig.visual.showOverflowMasks = false;
+    DevConfig.visual.maskAlpha = 0;
+    DevConfig.visual.maskFillColor = 16777215;
+    DevConfig.performance.logQueueStats = false;
+  },
+  /**
+   * Debug layout issues
+   * Enables layout, positioning, and flex logs
+   */
+  debugLayout: () => {
+    DevConfig.debug.enabled = true;
+    DevConfig.debug.layout = true;
+    DevConfig.debug.positioning = true;
+    DevConfig.debug.flex = true;
+    DevConfig.debug.overflowMask = false;
+    DevConfig.debug.vdom = false;
+    DevConfig.debug.performance = false;
+  },
+  /**
+   * Debug overflow masking
+   * Enables overflow logs and makes masks visible
+   */
+  debugOverflow: () => {
+    DevConfig.debug.enabled = true;
+    DevConfig.debug.overflowMask = true;
+    DevConfig.visual.showOverflowMasks = true;
+    DevConfig.visual.maskFillColor = 16711935;
+    DevConfig.visual.maskAlpha = 0.3;
+    DevConfig.debug.layout = false;
+    DevConfig.debug.positioning = false;
+    DevConfig.debug.flex = false;
+    DevConfig.debug.vdom = false;
+    DevConfig.debug.performance = false;
+  },
+  /**
+   * Performance profiling
+   * Enables performance timing and queue statistics
+   */
+  profilePerformance: () => {
+    DevConfig.debug.enabled = true;
+    DevConfig.debug.performance = true;
+    DevConfig.performance.logQueueStats = true;
+    DevConfig.debug.layout = false;
+    DevConfig.debug.overflowMask = false;
+    DevConfig.debug.positioning = false;
+    DevConfig.debug.flex = false;
+    DevConfig.debug.vdom = false;
+  },
+  /**
+   * Debug VDOM operations
+   * Enables virtual DOM mount/patch/unmount logs
+   */
+  debugVDOM: () => {
+    DevConfig.debug.enabled = true;
+    DevConfig.debug.vdom = true;
+    DevConfig.debug.layout = false;
+    DevConfig.debug.overflowMask = false;
+    DevConfig.debug.positioning = false;
+    DevConfig.debug.flex = false;
+    DevConfig.debug.performance = false;
+  },
+  debugTheme: () => {
+    DevConfig.debug.enabled = true;
+    DevConfig.debug.theme = true;
+    DevConfig.debug.layout = false;
+    DevConfig.debug.overflowMask = false;
+    DevConfig.debug.positioning = false;
+    DevConfig.debug.flex = false;
+    DevConfig.debug.performance = false;
+    DevConfig.debug.vdom = false;
+  },
+  /**
+   * Enable all debug categories (verbose!)
+   * Use with caution - produces lots of console output
+   */
+  debugAll: () => {
+    DevConfig.debug.enabled = true;
+    DevConfig.debug.layout = true;
+    DevConfig.debug.overflowMask = true;
+    DevConfig.debug.flex = true;
+    DevConfig.debug.positioning = true;
+    DevConfig.debug.vdom = true;
+    DevConfig.debug.performance = true;
+    DevConfig.visual.showOverflowMasks = true;
+    DevConfig.visual.maskFillColor = 16711935;
+    DevConfig.visual.maskAlpha = 0.3;
+    DevConfig.performance.logQueueStats = true;
+  }
+};
+export {
+  DebugLogger,
+  DevConfig,
+  DevPresets
+};
+//# sourceMappingURL=dev-config.js.map

package/dist/dev-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-config.js","sources":["../src/dev-config.ts"],"sourcesContent":["/**\n * Development and debugging configuration\n * Runtime-configurable settings for debugging and development\n */\n\n/**\n * Simple debounce implementation — avoids pulling in ~1.1 MB of lodash\n * @internal\n */\nfunction debounce<T extends (...args: unknown[]) => void>(\n  fn: T,\n  delay: number\n): (...args: unknown[]) => void {\n  let timeoutId: ReturnType<typeof setTimeout> | undefined\n  return (...args: unknown[]) => {\n    if (timeoutId !== undefined) clearTimeout(timeoutId)\n    timeoutId = setTimeout(() => {\n      timeoutId = undefined\n      fn(...args)\n    }, delay)\n  }\n}\n\n/**\n * Development configuration object\n * Can be modified at runtime from user code for debugging\n *\n * @example\n * ```typescript\n * import { DevConfig } from '@number10/phaserjsx'\n *\n * // Enable specific debug categories\n * DevConfig.debug.enabled = true\n * DevConfig.debug.layout = true\n *\n * // Customize visual debugging\n * DevConfig.visual.maskFillColor = 0xff00ff  // Pink\n * DevConfig.visual.maskAlpha = 0.3           // Semi-transparent\n * ```\n */\nexport const DevConfig = {\n  /**\n   * Debug logging configuration\n   * Controls console output for different subsystems\n   */\n  debug: {\n    /**\n     * Master switch - disables all debug output when false\n     * @default false\n     */\n    enabled: false,\n\n    /**\n     * Detailed layout calculation logs\n     * Shows container sizing, positioning, and flex distribution\n     * @default false\n     */\n    layout: false,\n\n    /**\n     * Overflow mask positioning logs\n     * Shows world coordinate calculations and mask updates\n     * @default false\n     */\n    overflowMask: false,\n\n    /**\n     * Flex distribution calculations\n     * Shows flex space allocation across children\n     * @default false\n     */\n    flex: false,\n\n    /**\n     * Child sizing and positioning\n     * Shows individual child dimension calculations\n     * @default false\n     */\n    positioning: false,\n\n    /**\n     * VDOM mount/patch/unmount operations\n     * Shows virtual DOM updates and reconciliation\n     * @default false\n     */\n    vdom: false,\n\n    /**\n     * Performance timing measurements\n     * Shows execution time for layout operations\n     * @default false\n     */\n    performance: false,\n\n    /**\n     * Theme system logs\n     * Shows theme registry updates and prop merging\n     * @default false\n     */\n    theme: false,\n  },\n\n  /**\n   * VDOM warnings and development checks\n   * These help catch common mistakes that lead to performance issues\n   */\n  warnings: {\n    /**\n     * Warn when list items (siblings) don't have key props\n     * Similar to React's \"Each child in a list should have a unique key prop\" warning\n     * @default true (in development)\n     */\n    missingKeys: false, // temp disable because of detection issues, will re-enable later\n\n    /**\n     * Warn when props change causes full remount instead of update\n     * Detects JSX/callback recreation that prevents VDOM optimization\n     * @default true (in development)\n     */\n    unnecessaryRemounts: false,\n\n    /**\n     * Warn when VNodes are frozen/sealed and need copying\n     * Happens in production builds or with certain bundler optimizations\n     * @default false (usually only relevant in production)\n     */\n    frozenVNodes: false,\n  },\n\n  /**\n   * Visual debugging aids\n   * Runtime-configurable visual settings\n   */\n  visual: {\n    /**\n     * Show overflow mask areas\n     * When true, masks are visible (alpha > 0) for debugging\n     * @default false\n     */\n    showOverflowMasks: false,\n\n    /**\n     * Mask fill color\n     * @default 0xffffff (white, invisible with alpha=0)\n     * @example 0xff00ff (pink for debugging)\n     */\n    maskFillColor: 0xffffff,\n\n    /**\n     * Mask alpha transparency\n     * @default 0.0 (invisible)\n     * @example 0.3 (semi-transparent for debugging)\n     */\n    maskAlpha: 0.0,\n  },\n\n  /**\n   * Performance tuning\n   */\n  performance: {\n    /**\n     * Enable deferred layout queue batching\n     * When false, deferred updates execute immediately (not batched)\n     * @default true\n     */\n    useDeferredQueue: true,\n\n    /**\n     * Log deferred queue statistics\n     * Shows number of batched callbacks per frame\n     * @default false\n     */\n    logQueueStats: false,\n  },\n}\n\n/**\n * Debug logger with category support\n * Only logs when global debug is enabled AND category is enabled\n *\n * @example\n * ```typescript\n * DebugLogger.log('layout', 'Container size:', { width: 100, height: 200 })\n * // Only logs if DevConfig.debug.enabled && DevConfig.debug.layout\n * ```\n */\nexport class DebugLogger {\n  /**\n   * Debounced console.log instances per category-message combination\n   */\n  private static debouncedLoggers = new Map<string, (...args: unknown[]) => void>()\n\n  /**\n   * Log a message with category filtering and debouncing\n   * @param category - Debug category to check\n   * @param message - Message to log\n   * @param args - Additional arguments to log (only first element is used)\n   */\n  static log(category: keyof typeof DevConfig.debug, message: string, ...args: unknown[]): void {\n    if (!DevConfig.debug.enabled) return\n    if (category !== 'enabled' && !DevConfig.debug[category]) return\n\n    const key = `${String(category)}:${message}`\n    let debouncedLog = this.debouncedLoggers.get(key)\n\n    // console.log(`[${category}] ${message}`, args[0])\n\n    if (!debouncedLog) {\n      debouncedLog = debounce(() => {\n        console.log(`[${category}] ${message}`, args[0])\n      }, 300)\n      this.debouncedLoggers.set(key, debouncedLog)\n    }\n\n    debouncedLog()\n  }\n\n  /**\n   * Log a warning message (always shown, even if debug disabled)\n   * @param category - Category for context\n   * @param message - Warning message\n   * @param args - Additional arguments\n   */\n  static warn(category: string, message: string, ...args: unknown[]): void {\n    console.warn(`[${category}] ${message}`, ...args)\n  }\n\n  /**\n   * Log an error message (always shown, even if debug disabled)\n   * @param category - Category for context\n   * @param message - Error message\n   * @param args - Additional arguments\n   */\n  static error(category: string, message: string, ...args: unknown[]): void {\n    console.error(`[${category}] ${message}`, ...args)\n  }\n\n  /**\n   * Start a performance timer\n   * @param category - Debug category to check\n   * @param label - Timer label\n   */\n  static time(category: keyof typeof DevConfig.debug, label: string): void {\n    if (!DevConfig.debug.enabled) return\n    if (category !== 'enabled' && !DevConfig.debug[category]) return\n\n    console.time(`[${category}] ${label}`)\n  }\n\n  /**\n   * End a performance timer\n   * @param category - Debug category to check\n   * @param label - Timer label\n   */\n  static timeEnd(category: keyof typeof DevConfig.debug, label: string): void {\n    if (!DevConfig.debug.enabled) return\n    if (category !== 'enabled' && !DevConfig.debug[category]) return\n\n    console.timeEnd(`[${category}] ${label}`)\n  }\n}\n\n/**\n * Predefined configuration presets for common debugging scenarios\n *\n * @example\n * ```typescript\n * import { DevPresets } from '@number10/phaserjsx'\n *\n * // Quick activation of overflow debugging\n * DevPresets.debugOverflow()\n *\n * // Revert to production settings\n * DevPresets.production()\n * ```\n */\nexport const DevPresets = {\n  /**\n   * Production configuration\n   * All debugging disabled, optimal performance\n   */\n  production: (): void => {\n    DevConfig.debug.enabled = false\n    DevConfig.visual.showOverflowMasks = false\n    DevConfig.visual.maskAlpha = 0.0\n    DevConfig.visual.maskFillColor = 0xffffff\n    DevConfig.performance.logQueueStats = false\n  },\n\n  /**\n   * Debug layout issues\n   * Enables layout, positioning, and flex logs\n   */\n  debugLayout: (): void => {\n    DevConfig.debug.enabled = true\n    DevConfig.debug.layout = true\n    DevConfig.debug.positioning = true\n    DevConfig.debug.flex = true\n    // Keep other categories off\n    DevConfig.debug.overflowMask = false\n    DevConfig.debug.vdom = false\n    DevConfig.debug.performance = false\n  },\n\n  /**\n   * Debug overflow masking\n   * Enables overflow logs and makes masks visible\n   */\n  debugOverflow: (): void => {\n    DevConfig.debug.enabled = true\n    DevConfig.debug.overflowMask = true\n    DevConfig.visual.showOverflowMasks = true\n    DevConfig.visual.maskFillColor = 0xff00ff // Pink\n    DevConfig.visual.maskAlpha = 0.3 // Semi-transparent\n    // Keep other categories off\n    DevConfig.debug.layout = false\n    DevConfig.debug.positioning = false\n    DevConfig.debug.flex = false\n    DevConfig.debug.vdom = false\n    DevConfig.debug.performance = false\n  },\n\n  /**\n   * Performance profiling\n   * Enables performance timing and queue statistics\n   */\n  profilePerformance: (): void => {\n    DevConfig.debug.enabled = true\n    DevConfig.debug.performance = true\n    DevConfig.performance.logQueueStats = true\n    // Keep other categories off\n    DevConfig.debug.layout = false\n    DevConfig.debug.overflowMask = false\n    DevConfig.debug.positioning = false\n    DevConfig.debug.flex = false\n    DevConfig.debug.vdom = false\n  },\n\n  /**\n   * Debug VDOM operations\n   * Enables virtual DOM mount/patch/unmount logs\n   */\n  debugVDOM: (): void => {\n    DevConfig.debug.enabled = true\n    DevConfig.debug.vdom = true\n    // Keep other categories off\n    DevConfig.debug.layout = false\n    DevConfig.debug.overflowMask = false\n    DevConfig.debug.positioning = false\n    DevConfig.debug.flex = false\n    DevConfig.debug.performance = false\n  },\n\n  debugTheme: (): void => {\n    DevConfig.debug.enabled = true\n    DevConfig.debug.theme = true\n    // Keep other categories off\n    DevConfig.debug.layout = false\n    DevConfig.debug.overflowMask = false\n    DevConfig.debug.positioning = false\n    DevConfig.debug.flex = false\n    DevConfig.debug.performance = false\n    DevConfig.debug.vdom = false\n  },\n\n  /**\n   * Enable all debug categories (verbose!)\n   * Use with caution - produces lots of console output\n   */\n  debugAll: (): void => {\n    DevConfig.debug.enabled = true\n    DevConfig.debug.layout = true\n    DevConfig.debug.overflowMask = true\n    DevConfig.debug.flex = true\n    DevConfig.debug.positioning = true\n    DevConfig.debug.vdom = true\n    DevConfig.debug.performance = true\n    DevConfig.visual.showOverflowMasks = true\n    DevConfig.visual.maskFillColor = 0xff00ff\n    DevConfig.visual.maskAlpha = 0.3\n    DevConfig.performance.logQueueStats = true\n  },\n}\n"],"names":[],"mappings":"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"}

package/dist/effects.cjs

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const effectDefinitions = require("./animation/effect-definitions.cjs");
+const effectEngine = require("./animation/effect-engine.cjs");
+function resolveEffect(props, theme) {
+  return {
+    effect: props.effect ?? theme.effect,
+    effectConfig: props.effectConfig ?? theme.effectConfig
+  };
+}
+const DEFAULT_EFFECT = {
+  effect: "pulse",
+  effectConfig: { intensity: 1.1, time: 100 }
+};
+function applyEffectByName(applyFn, effectName, effectConfig) {
+  const name = effectName ?? DEFAULT_EFFECT.effect;
+  const config = effectConfig ?? DEFAULT_EFFECT.effectConfig;
+  applyFn(name, config);
+  return true;
+}
+function resolveEffectTransformOrigin(effect) {
+  return effectDefinitions.resolveEffectTransformOrigin(effect);
+}
+function registerEffect(name, definition) {
+  effectDefinitions.EFFECT_DEFINITIONS[name] = definition;
+}
+const _effectRunners = [];
+const _effectStopRunners = [];
+function registerEffectRunner(runner) {
+  _effectRunners.push(runner);
+}
+function registerEffectStopRunner(runner) {
+  _effectStopRunners.push(runner);
+}
+function applyEffect(a, b, c, d) {
+  if (arguments.length === 4 && b && typeof b === "object" && "onUpdate" in b) {
+    const targetKey = a;
+    const target = b;
+    const effect2 = c;
+    const config2 = d ?? {};
+    if (!effect2 || effect2 === "none") return null;
+    const def = effectDefinitions.EFFECT_DEFINITIONS[effect2];
+    if (!def) return null;
+    return effectEngine.runEffect(targetKey, target, def, config2);
+  }
+  const node = a;
+  const effect = b;
+  const config = c ?? {};
+  if (!effect || effect === "none") return;
+  for (const runner of _effectRunners) {
+    runner(node, effect, config);
+  }
+}
+function stopEffect(key) {
+  effectEngine.stopEffect(key);
+  for (const runner of _effectStopRunners) {
+    runner(key);
+  }
+}
+exports.DEFAULT_EFFECT = DEFAULT_EFFECT;
+exports.applyEffect = applyEffect;
+exports.applyEffectByName = applyEffectByName;
+exports.registerEffect = registerEffect;
+exports.registerEffectRunner = registerEffectRunner;
+exports.registerEffectStopRunner = registerEffectStopRunner;
+exports.resolveEffect = resolveEffect;
+exports.resolveEffectTransformOrigin = resolveEffectTransformOrigin;
+exports.stopEffect = stopEffect;
+//# sourceMappingURL=effects.cjs.map

package/dist/effects.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.cjs","sources":["../src/effects.ts"],"sourcesContent":["/**\n * Portable effect system — renderer-agnostic effect contracts.\n *\n * Components declare their effect intent via props/theme. The central\n * effect engine (animation/effect-engine.ts) handles all effect execution.\n *\n * ## Portable usage (recommended for new components)\n *\n * Portable components implement `EffectTarget` to connect their node to\n * the central engine. Use the 4-arg `applyEffect()` overload directly:\n *\n * ```typescript\n * import { applyEffect, type EffectTarget } from '@number10/jsx-core'\n *\n * // Inside a portable component:\n * const target: EffectTarget = {\n *   onUpdate: (values) => {\n *     // Apply animated values to the renderer node\n *     node.setPosition(values.x ?? node.x, values.y ?? node.y)\n *     node.alpha = values.alpha ?? node.alpha\n *   },\n *   getSnapshot: () => ({\n *     x: node.x, y: node.y, alpha: node.alpha,\n *     scaleX: node.scaleX, scaleY: node.scaleY,\n *     rotation: node.rotation,\n *   }),\n *   getScheduler: () => surface.scheduler,\n *   getSize: () => ({ width: node.width, height: node.height }),\n * }\n *\n * applyEffect(node, target, 'pulse', { duration: 300 })\n * ```\n *\n * ## Legacy API (transitional)\n *\n * Renderer bridges (Pixi/Phaser) use the 3-arg `applyEffect(node, effect, config)`\n * which dispatches via a runner registry. New components should prefer the\n * direct 4-arg overload above.\n *\n * @migration Transitional architecture — two paths coexist:\n *   1. Legacy: `applyEffect(node, effect, config)` — dispatches via runner registry\n *      (Pixi/Phaser bridges register runners that internally create EffectTargets)\n *   2. Direct: `applyEffect(targetKey, target, effect, config)` — skips runners,\n *      calls the engine directly. Used by portable components that have an EffectTarget.\n */\n\nimport {\n  EFFECT_DEFINITIONS,\n  resolveEffectTransformOrigin as resolveOrigin,\n  type EffectDefinition as EngineEffectDefinition,\n} from './animation/effect-definitions'\nimport {\n  runEffect,\n  stopEffect as stopEngineEffect,\n  type EffectHandle,\n  type EffectTarget,\n} from './animation/effect-engine'\nimport type { EffectConfig as EngineEffectConfig } from './animation/types'\n\n// ---------------------------------------------------------------------------\n// Effect name types — extensible via declaration merging\n// ---------------------------------------------------------------------------\n\n/**\n * Built-in effect names available in all renderers.\n */\nexport type BuiltInEffectName =\n  | 'none'\n  | 'pulse'\n  | 'shake'\n  | 'bounce'\n  | 'press'\n  | 'flash'\n  | 'jello'\n  | 'fade'\n  | 'fadeIn'\n  | 'fadeOut'\n  | 'wobble'\n  | 'tada'\n  | 'swing'\n  | 'wiggle'\n  | 'slideIn'\n  | 'slideOut'\n  | 'zoomIn'\n  | 'zoomOut'\n  | 'flipIn'\n  | 'flipOut'\n  | 'float'\n  | 'breathe'\n  | 'spin'\n\n/**\n * Extension point for custom effect names.\n * Use declaration merging to add custom effects:\n *\n * @example\n * ```typescript\n * declare module '@number10/jsx-core' {\n *   interface EffectNameExtensions {\n *     squash: 'squash'\n *   }\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type\nexport interface EffectNameExtensions {}\n\n/**\n * Known effect names (built-in + custom extensions).\n */\nexport type EffectName =\n  | BuiltInEffectName\n  | (keyof EffectNameExtensions extends never ? never : keyof EffectNameExtensions)\n\n/** Configuration for an effect (duration, intensity, direction, etc.). */\nexport type EffectConfig = EngineEffectConfig\n\n/** Canonical transform origin used by built-in effects across renderers. */\nexport type EffectTransformOrigin = import('./animation/effect-definitions').EffectTransformOrigin\n\n/**\n * Props that any component can extend to declare effects.\n */\nexport interface EffectDefinition {\n  /** Effect to apply on interaction (e.g., 'press', 'pulse') */\n  effect?: EffectName | undefined\n  /** Configuration for the effect */\n  effectConfig?: EffectConfig | undefined\n}\n\n/**\n * Resolve which effect to use from props vs theme.\n * @param props - Explicit component props\n * @param theme - Resolved theme (with effect/effectConfig)\n * @returns The resolved effect name and config\n */\nexport function resolveEffect(\n  props: EffectDefinition,\n  theme: Record<string, unknown>\n): { effect?: EffectName | undefined; effectConfig?: EffectConfig | undefined } {\n  return {\n    effect: props.effect ?? (theme.effect as EffectName | undefined),\n    effectConfig: props.effectConfig ?? (theme.effectConfig as EffectConfig | undefined),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Default effect + convenience helper\n// ---------------------------------------------------------------------------\n\n/**\n * Default effect configuration used as fallback when no effect is specified.\n */\nexport const DEFAULT_EFFECT = {\n  effect: 'pulse' as EffectName,\n  effectConfig: { intensity: 1.1, time: 100 } as EffectConfig,\n}\n\n/**\n * Apply an effect by name with automatic DEFAULT_EFFECT fallback.\n *\n * Convenience wrapper around a renderer's applyEffect function that fills in\n * defaults when effect name or config are omitted.\n *\n * @param applyFn - Renderer-specific applyEffect function\n * @param effectName - Name of the effect to apply (defaults to 'pulse')\n * @param effectConfig - Optional configuration for the effect\n * @returns true if effect was applied, false otherwise\n */\nexport function applyEffectByName(\n  applyFn: (name: EffectName, config?: EffectConfig) => void,\n  effectName?: EffectName,\n  effectConfig?: EffectConfig\n): boolean {\n  const name = effectName ?? DEFAULT_EFFECT.effect\n  const config = effectConfig ?? DEFAULT_EFFECT.effectConfig\n\n  applyFn(name, config)\n  return true\n}\n\n/**\n * Resolve the canonical transform origin for a built-in effect.\n * Delegates to the central effect-definitions registry.\n */\nexport function resolveEffectTransformOrigin(\n  effect: EffectName | undefined\n): EffectTransformOrigin {\n  return resolveOrigin(effect)\n}\n\n// ---------------------------------------------------------------------------\n// Custom effect registration\n// ---------------------------------------------------------------------------\n\n/**\n * Register a custom effect definition so it becomes available via\n * `applyEffect()` and `effect=\"customName\"` in components.\n *\n * Combine with declaration merging on `EffectNameExtensions` to maintain\n * type safety:\n *\n * @example\n * ```typescript\n * declare module '@number10/jsx-core' {\n *   interface EffectNameExtensions { squash: 'squash' }\n * }\n * registerEffect('squash', {\n *   name: 'squash',\n *   steps: (base, config) => [\n *     { type: 'tween', to: { scaleX: base.scaleX * 1.5, scaleY: base.scaleY / 1.5 },\n *       duration: config.time ?? 200, ease: 'Sine.easeInOut' },\n *     { type: 'tween', to: { scaleX: base.scaleX, scaleY: base.scaleY },\n *       duration: config.time ?? 200 },\n *   ],\n *   loop: false,\n *   origin: 'center',\n * })\n * ```\n *\n * @param name - Unique effect name\n * @param definition - Effect definition (steps, loop, origin)\n */\nexport function registerEffect(name: string, definition: EngineEffectDefinition): void {\n  EFFECT_DEFINITIONS[name] = definition\n}\n\n// ---------------------------------------------------------------------------\n// Transitional: Runner registry (used by Pixi/Phaser bridges)\n// ---------------------------------------------------------------------------\n\n/** Legacy runner signature — receives a renderer node, effect name, and config */\nexport type EffectRunner = (node: unknown, effect: EffectName, config?: EffectConfig) => void\nexport type EffectStopRunner = (node: unknown) => void\n\nconst _effectRunners: EffectRunner[] = []\nconst _effectStopRunners: EffectStopRunner[] = []\n\n/**\n * Register a renderer-specific effect runner (transitional).\n *\n * During migration, Pixi/Phaser bridges register runners that create\n * an EffectTarget internally and delegate to the central engine.\n * After full migration, this pattern is replaced by direct EffectTarget usage.\n */\nexport function registerEffectRunner(runner: EffectRunner): void {\n  _effectRunners.push(runner)\n}\n\n/**\n * Register a renderer-specific effect stop runner (transitional).\n */\nexport function registerEffectStopRunner(runner: EffectStopRunner): void {\n  _effectStopRunners.push(runner)\n}\n\n// ---------------------------------------------------------------------------\n// Legacy API: applyEffect(node, effect, config) — dispatches via runners\n// ---------------------------------------------------------------------------\n\n/**\n * Apply an effect using the legacy runner-registry dispatch.\n *\n * Renderer bridges (Pixi, Phaser) register runners that create an EffectTarget\n * and delegate to the central engine internally.\n *\n * @param node - Renderer-native node (PIXI.Container, Phaser.GameObjects.Container, ...)\n * @param effect - Effect name to apply\n * @param config - Effect configuration\n */\nexport function applyEffect(\n  node: unknown,\n  effect: EffectName | undefined,\n  config?: EffectConfig\n): void\n\n/**\n * Apply an effect directly using the central engine.\n *\n * Portable components that have an EffectTarget can use this overload\n * to skip the runner-registry dispatch.\n *\n * @param targetKey - Object used as animation state key (typically the renderer node)\n * @param target - EffectTarget implementation for this renderer\n * @param effect - Effect name to apply\n * @param config - Effect configuration\n * @returns EffectHandle or null if effect is unknown\n */\nexport function applyEffect(\n  targetKey: object,\n  target: EffectTarget,\n  effect: EffectName | undefined,\n  config?: EffectConfig\n): EffectHandle | null\n\n/** Implementation — supports both 3-arg (legacy) and 4-arg (direct) signatures */\nexport function applyEffect(\n  a: unknown | object,\n  b: EffectTarget | EffectName | undefined,\n  c?: EffectName | EffectConfig | undefined,\n  d?: EffectConfig\n): void | EffectHandle | null {\n  // 4-arg overload: applyEffect(targetKey, target, effect, config)\n  if (arguments.length === 4 && b && typeof b === 'object' && 'onUpdate' in b) {\n    const targetKey = a as object\n    const target = b as EffectTarget\n    const effect = c as EffectName | undefined\n    const config = (d ?? {}) as EffectConfig\n    if (!effect || effect === 'none') return null\n    const def = EFFECT_DEFINITIONS[effect]\n    if (!def) return null\n    return runEffect(targetKey, target, def, config)\n  }\n\n  // 3-arg overload: applyEffect(node, effect, config) — dispatches via runners\n  const node = a\n  const effect = b as EffectName | undefined\n  const config = (c ?? {}) as EffectConfig\n  if (!effect || effect === 'none') return\n  for (const runner of _effectRunners) {\n    runner(node, effect, config)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Legacy API: stopEffect(node) — dispatches via runners\n// ---------------------------------------------------------------------------\n\n/**\n * Stop effects using the legacy runner-registry dispatch.\n * @param node - Renderer-native node\n */\nexport function stopEffect(node: unknown): void\n\n/**\n * Stop effects directly via the central engine.\n * @param targetKey - Object used as animation state key\n */\nexport function stopEffect(targetKey: object): void\n\n/** Implementation */\nexport function stopEffect(key: unknown | object): void {\n  // Check if we should use the engine directly (only if it's likely an engine-tracked key)\n  // The engine tracks via WeakMap, so calling with any object is safe\n  stopEngineEffect(key as object)\n\n  // Also dispatch via legacy stop runners for backward compatibility\n  for (const runner of _effectStopRunners) {\n    runner(key)\n  }\n}\n"],"names":["resolveOrigin","EFFECT_DEFINITIONS","effect","config","runEffect","stopEngineEffect"],"mappings":";;;;AAwIO,SAAS,cACd,OACA,OAC8E;AAC9E,SAAO;AAAA,IACL,QAAQ,MAAM,UAAW,MAAM;AAAA,IAC/B,cAAc,MAAM,gBAAiB,MAAM;AAAA,EAAA;AAE/C;AASO,MAAM,iBAAiB;AAAA,EAC5B,QAAQ;AAAA,EACR,cAAc,EAAE,WAAW,KAAK,MAAM,IAAA;AACxC;AAaO,SAAS,kBACd,SACA,YACA,cACS;AACT,QAAM,OAAO,cAAc,eAAe;AAC1C,QAAM,SAAS,gBAAgB,eAAe;AAE9C,UAAQ,MAAM,MAAM;AACpB,SAAO;AACT;AAMO,SAAS,6BACd,QACuB;AACvB,SAAOA,kBAAAA,6BAAc,MAAM;AAC7B;AAkCO,SAAS,eAAe,MAAc,YAA0C;AACrFC,oBAAAA,mBAAmB,IAAI,IAAI;AAC7B;AAUA,MAAM,iBAAiC,CAAA;AACvC,MAAM,qBAAyC,CAAA;AASxC,SAAS,qBAAqB,QAA4B;AAC/D,iBAAe,KAAK,MAAM;AAC5B;AAKO,SAAS,yBAAyB,QAAgC;AACvE,qBAAmB,KAAK,MAAM;AAChC;AA0CO,SAAS,YACd,GACA,GACA,GACA,GAC4B;AAE5B,MAAI,UAAU,WAAW,KAAK,KAAK,OAAO,MAAM,YAAY,cAAc,GAAG;AAC3E,UAAM,YAAY;AAClB,UAAM,SAAS;AACf,UAAMC,UAAS;AACf,UAAMC,UAAU,KAAK,CAAA;AACrB,QAAI,CAACD,WAAUA,YAAW,OAAQ,QAAO;AACzC,UAAM,MAAMD,kBAAAA,mBAAmBC,OAAM;AACrC,QAAI,CAAC,IAAK,QAAO;AACjB,WAAOE,aAAAA,UAAU,WAAW,QAAQ,KAAKD,OAAM;AAAA,EACjD;AAGA,QAAM,OAAO;AACb,QAAM,SAAS;AACf,QAAM,SAAU,KAAK,CAAA;AACrB,MAAI,CAAC,UAAU,WAAW,OAAQ;AAClC,aAAW,UAAU,gBAAgB;AACnC,WAAO,MAAM,QAAQ,MAAM;AAAA,EAC7B;AACF;AAmBO,SAAS,WAAW,KAA6B;AAGtDE,eAAAA,WAAiB,GAAa;AAG9B,aAAW,UAAU,oBAAoB;AACvC,WAAO,GAAG;AAAA,EACZ;AACF;;;;;;;;;;"}