@number10/jsx-core 5.0.0

package/dist/design-tokens/design-token-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-presets.d.ts","sourceRoot":"","sources":["../../src/design-tokens/design-token-presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,eAAe,EAChB,MAAM,sBAAsB,CAAA;AAE7B;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAOlC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAO/B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAOjC,CAAA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CA+CxE;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAAkD,CAAA;AAEvF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAQpE"}

package/dist/design-tokens/design-token-presets.js

@@ -0,0 +1,91 @@
+const defaultSpacingTokens = {
+  xs: 4,
+  sm: 8,
+  md: 16,
+  lg: 24,
+  xl: 32,
+  xxl: 48
+};
+const defaultSizeTokens = {
+  xs: 16,
+  sm: 24,
+  md: 32,
+  lg: 48,
+  xl: 64,
+  xxl: 96
+};
+const defaultRadiusTokens = {
+  none: 0,
+  sm: 4,
+  md: 8,
+  lg: 16,
+  xl: 24,
+  xxl: 48
+};
+function createTextStyleTokens(textColor) {
+  return {
+    DEFAULT: {
+      fontSize: "16px",
+      color: textColor,
+      fontFamily: "Arial",
+      align: "left"
+    },
+    small: {
+      fontSize: "12px",
+      color: textColor,
+      fontFamily: "Arial",
+      align: "left"
+    },
+    medium: {
+      fontSize: "16px",
+      color: textColor,
+      fontFamily: "Arial",
+      align: "left"
+    },
+    large: {
+      fontSize: "20px",
+      color: textColor,
+      fontFamily: "Arial",
+      align: "left"
+    },
+    title: {
+      fontSize: "28px",
+      color: textColor,
+      fontFamily: "Arial",
+      fontStyle: "bold",
+      align: "left"
+    },
+    heading: {
+      fontSize: "36px",
+      color: textColor,
+      fontFamily: "Arial",
+      fontStyle: "bold",
+      align: "left"
+    },
+    caption: {
+      fontSize: "10px",
+      color: textColor,
+      fontFamily: "Arial",
+      align: "left"
+    }
+  };
+}
+const defaultTextStyleTokens = createTextStyleTokens("#ffffff");
+function createDesignTokens(preset) {
+  return {
+    colors: preset.colors,
+    textStyles: createTextStyleTokens(preset.colors.text.DEFAULT.toString()),
+    spacing: defaultSpacingTokens,
+    sizes: defaultSizeTokens,
+    radius: defaultRadiusTokens
+  };
+}
+export {
+  createDesignTokens,
+  createTextStyleTokens,
+  defaultRadiusTokens,
+  defaultSizeTokens,
+  defaultSpacingTokens,
+  defaultTextStyleTokens
+};
+//# sourceMappingURL=design-token-presets.js.map

package/dist/design-tokens/design-token-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-presets.js","sources":["../../src/design-tokens/design-token-presets.ts"],"sourcesContent":["/**\n * Default design token presets\n * Provides sensible defaults for text styles, spacing, sizes, and radius,\n * plus factory functions to create complete DesignTokens from color presets.\n */\nimport type { ColorPreset } from '../colors/color-presets'\nimport type {\n  DesignTokens,\n  RadiusTokens,\n  SizeTokens,\n  SpacingTokens,\n  TextStyleTokens,\n} from './design-token-types'\n\n/**\n * Default spacing scale\n * Based on 4px base unit\n */\nexport const defaultSpacingTokens: SpacingTokens = {\n  xs: 4,\n  sm: 8,\n  md: 16,\n  lg: 24,\n  xl: 32,\n  xxl: 48,\n}\n\n/**\n * Default size scale\n * For width, height, icon sizes, etc.\n */\nexport const defaultSizeTokens: SizeTokens = {\n  xs: 16,\n  sm: 24,\n  md: 32,\n  lg: 48,\n  xl: 64,\n  xxl: 96,\n}\n\n/**\n * Default border radius scale\n */\nexport const defaultRadiusTokens: RadiusTokens = {\n  none: 0,\n  sm: 4,\n  md: 8,\n  lg: 16,\n  xl: 24,\n  xxl: 48,\n}\n\n/**\n * Create text style tokens with the given base text color\n * @param textColor - Base text color (hex string)\n * @returns TextStyleTokens with color applied\n */\nexport function createTextStyleTokens(textColor: string): TextStyleTokens {\n  return {\n    DEFAULT: {\n      fontSize: '16px',\n      color: textColor,\n      fontFamily: 'Arial',\n      align: 'left',\n    },\n    small: {\n      fontSize: '12px',\n      color: textColor,\n      fontFamily: 'Arial',\n      align: 'left',\n    },\n    medium: {\n      fontSize: '16px',\n      color: textColor,\n      fontFamily: 'Arial',\n      align: 'left',\n    },\n    large: {\n      fontSize: '20px',\n      color: textColor,\n      fontFamily: 'Arial',\n      align: 'left',\n    },\n    title: {\n      fontSize: '28px',\n      color: textColor,\n      fontFamily: 'Arial',\n      fontStyle: 'bold',\n      align: 'left',\n    },\n    heading: {\n      fontSize: '36px',\n      color: textColor,\n      fontFamily: 'Arial',\n      fontStyle: 'bold',\n      align: 'left',\n    },\n    caption: {\n      fontSize: '10px',\n      color: textColor,\n      fontFamily: 'Arial',\n      align: 'left',\n    },\n  }\n}\n\n/**\n * Default text style tokens (white text)\n */\nexport const defaultTextStyleTokens: TextStyleTokens = createTextStyleTokens('#ffffff')\n\n/**\n * Create complete design tokens from a color preset.\n * Combines colors with default text styles, spacing, sizes, and radius tokens.\n * @param preset - Color preset (e.g., oceanBluePreset)\n * @returns Complete DesignTokens object\n */\nexport function createDesignTokens(preset: ColorPreset): DesignTokens {\n  return {\n    colors: preset.colors,\n    textStyles: createTextStyleTokens(preset.colors.text.DEFAULT.toString()),\n    spacing: defaultSpacingTokens,\n    sizes: defaultSizeTokens,\n    radius: defaultRadiusTokens,\n  }\n}\n"],"names":[],"mappings":"AAkBO,MAAM,uBAAsC;AAAA,EACjD,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,KAAK;AACP;AAMO,MAAM,oBAAgC;AAAA,EAC3C,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,KAAK;AACP;AAKO,MAAM,sBAAoC;AAAA,EAC/C,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,KAAK;AACP;AAOO,SAAS,sBAAsB,WAAoC;AACxE,SAAO;AAAA,IACL,SAAS;AAAA,MACP,UAAU;AAAA,MACV,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,OAAO;AAAA,IAAA;AAAA,IAET,OAAO;AAAA,MACL,UAAU;AAAA,MACV,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,OAAO;AAAA,IAAA;AAAA,IAET,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,OAAO;AAAA,IAAA;AAAA,IAET,OAAO;AAAA,MACL,UAAU;AAAA,MACV,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,OAAO;AAAA,IAAA;AAAA,IAET,OAAO;AAAA,MACL,UAAU;AAAA,MACV,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,OAAO;AAAA,IAAA;AAAA,IAET,SAAS;AAAA,MACP,UAAU;AAAA,MACV,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,OAAO;AAAA,IAAA;AAAA,IAET,SAAS;AAAA,MACP,UAAU;AAAA,MACV,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,OAAO;AAAA,IAAA;AAAA,EACT;AAEJ;AAKO,MAAM,yBAA0C,sBAAsB,SAAS;AAQ/E,SAAS,mBAAmB,QAAmC;AACpE,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf,YAAY,sBAAsB,OAAO,OAAO,KAAK,QAAQ,UAAU;AAAA,IACvE,SAAS;AAAA,IACT,OAAO;AAAA,IACP,QAAQ;AAAA,EAAA;AAEZ;"}

package/dist/design-tokens/design-token-types.d.ts

@@ -0,0 +1,97 @@
+import { ColorTokens } from '../colors/color-types';
+import { PortableTextStyle } from '../primitive-contracts';
+/**
+ * Text style preset token — compatible with PortableTextStyle.
+ */
+export type TextStyleToken = PortableTextStyle;
+/**
+ * Text style tokens for different use cases
+ * Provides semantic presets for common text styles
+ */
+export interface TextStyleTokens {
+    /** Default text style - base body text (16px) */
+    DEFAULT: TextStyleToken;
+    /** Small text - captions, labels (12px) */
+    small: TextStyleToken;
+    /** Medium text - body, paragraphs (16px) */
+    medium: TextStyleToken;
+    /** Large text - subheadings, emphasis (20px) */
+    large: TextStyleToken;
+    /** Title text - section titles (28px) */
+    title: TextStyleToken;
+    /** Heading text - page headings (36px) */
+    heading: TextStyleToken;
+    /** Caption text - footnotes, metadata (10px, reduced opacity) */
+    caption: TextStyleToken;
+}
+/**
+ * Spacing scale tokens
+ * Consistent spacing values for padding, margin, gaps
+ */
+export interface SpacingTokens {
+    /** Extra small - 4px */
+    xs: number;
+    /** Small - 8px */
+    sm: number;
+    /** Medium - 16px */
+    md: number;
+    /** Large - 24px */
+    lg: number;
+    /** Extra large - 32px */
+    xl: number;
+    /** Extra extra large - 48px */
+    xxl: number;
+}
+/**
+ * Size scale tokens
+ * For width, height, icon sizes, etc.
+ */
+export interface SizeTokens {
+    /** Extra small - 16px */
+    xs: number;
+    /** Small - 24px */
+    sm: number;
+    /** Medium - 32px */
+    md: number;
+    /** Large - 48px */
+    lg: number;
+    /** Extra large - 64px */
+    xl: number;
+    /** Extra extra large - 96px */
+    xxl: number;
+}
+/**
+ * Border radius tokens
+ * Consistent corner radius values
+ */
+export interface RadiusTokens {
+    /** None - 0px */
+    none: number;
+    /** Small - 4px */
+    sm: number;
+    /** Medium - 8px */
+    md: number;
+    /** Large - 16px */
+    lg: number;
+    /** Extra large - 24px */
+    xl: number;
+    /** Full - 9999px (pill shape) */
+    xxl: number;
+}
+/**
+ * Complete design token system
+ * Combines colors with semantic style tokens
+ */
+export interface DesignTokens {
+    /** Color tokens - semantic color scales */
+    colors: ColorTokens;
+    /** Text style presets - ready-to-use text styles */
+    textStyles: TextStyleTokens;
+    /** Spacing scale - padding, margin, gaps */
+    spacing: SpacingTokens;
+    /** Size scale - width, height, icon sizes */
+    sizes: SizeTokens;
+    /** Border radius scale - corner radius values */
+    radius: RadiusTokens;
+}
+//# sourceMappingURL=design-token-types.d.ts.map

package/dist/design-tokens/design-token-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-types.d.ts","sourceRoot":"","sources":["../../src/design-tokens/design-token-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE/D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,OAAO,EAAE,cAAc,CAAA;IACvB,2CAA2C;IAC3C,KAAK,EAAE,cAAc,CAAA;IACrB,4CAA4C;IAC5C,MAAM,EAAE,cAAc,CAAA;IACtB,gDAAgD;IAChD,KAAK,EAAE,cAAc,CAAA;IACrB,yCAAyC;IACzC,KAAK,EAAE,cAAc,CAAA;IACrB,0CAA0C;IAC1C,OAAO,EAAE,cAAc,CAAA;IACvB,iEAAiE;IACjE,OAAO,EAAE,cAAc,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,MAAM,EAAE,WAAW,CAAA;IACnB,oDAAoD;IACpD,UAAU,EAAE,eAAe,CAAA;IAC3B,4CAA4C;IAC5C,OAAO,EAAE,aAAa,CAAA;IACtB,6CAA6C;IAC7C,KAAK,EAAE,UAAU,CAAA;IACjB,iDAAiD;IACjD,MAAM,EAAE,YAAY,CAAA;CACrB"}

package/dist/design-tokens/index.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const designTokenPresets = require("./design-token-presets.cjs");
+exports.createDesignTokens = designTokenPresets.createDesignTokens;
+exports.createTextStyleTokens = designTokenPresets.createTextStyleTokens;
+exports.defaultRadiusTokens = designTokenPresets.defaultRadiusTokens;
+exports.defaultSizeTokens = designTokenPresets.defaultSizeTokens;
+exports.defaultSpacingTokens = designTokenPresets.defaultSpacingTokens;
+exports.defaultTextStyleTokens = designTokenPresets.defaultTextStyleTokens;
+//# sourceMappingURL=index.cjs.map

package/dist/design-tokens/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/design-tokens/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Design token system — renderer-neutral semantic tokens.
+ *
+ * @migration(audit:scene-portal-mount) Phase 3C — extracted from packages/ui/src/design-tokens.
+ *   Pure token types and presets. Theme-dependent hooks + component size presets stay in Phaser package.
+ */
+export { createDesignTokens, createTextStyleTokens, defaultRadiusTokens, defaultSizeTokens, defaultSpacingTokens, defaultTextStyleTokens, } from './design-token-presets';
+export type { DesignTokens, RadiusTokens, SizeTokens, SpacingTokens, TextStyleToken, TextStyleTokens, } from './design-token-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/design-tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/design-tokens/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,sBAAsB,CAAA"}

package/dist/design-tokens/index.js

@@ -0,0 +1,10 @@
+import { createDesignTokens, createTextStyleTokens, defaultRadiusTokens, defaultSizeTokens, defaultSpacingTokens, defaultTextStyleTokens } from "./design-token-presets.js";
+export {
+  createDesignTokens,
+  createTextStyleTokens,
+  defaultRadiusTokens,
+  defaultSizeTokens,
+  defaultSpacingTokens,
+  defaultTextStyleTokens
+};
+//# sourceMappingURL=index.js.map

package/dist/design-tokens/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/dev-config.cjs

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+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;
+  }
+};
+exports.DebugLogger = DebugLogger;
+exports.DevConfig = DevConfig;
+exports.DevPresets = DevPresets;
+//# sourceMappingURL=dev-config.cjs.map

package/dist/dev-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-config.cjs","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":";;AASA,SAAS,SACP,IACA,OAC8B;AAC9B,MAAI;AACJ,SAAO,IAAI,SAAoB;AAC7B,QAAI,cAAc,OAAW,cAAa,SAAS;AACnD,gBAAY,WAAW,MAAM;AAC3B,kBAAY;AACZ,SAAG,GAAG,IAAI;AAAA,IACZ,GAAG,KAAK;AAAA,EACV;AACF;AAmBO,MAAM,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA,EAKvB,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,IAKL,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOT,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOR,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOd,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAON,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOb,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAON,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOb,OAAO;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMR,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOb,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOrB,cAAc;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhB,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMN,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOnB,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOf,WAAW;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMb,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMX,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOlB,eAAe;AAAA,EAAA;AAEnB;AAYO,MAAM,YAAY;AAAA;AAAA;AAAA;AAAA,EAIvB,OAAe,mBAAmB,oBAAI,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQtC,OAAO,IAAI,UAAwC,YAAoB,MAAuB;AAC5F,QAAI,CAAC,UAAU,MAAM,QAAS;AAC9B,QAAI,aAAa,aAAa,CAAC,UAAU,MAAM,QAAQ,EAAG;AAE1D,UAAM,MAAM,GAAG,OAAO,QAAQ,CAAC,IAAI,OAAO;AAC1C,QAAI,eAAe,KAAK,iBAAiB,IAAI,GAAG;AAIhD,QAAI,CAAC,cAAc;AACjB,qBAAe,SAAS,MAAM;AAC5B,gBAAQ,IAAI,IAAI,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,CAAC;AAAA,MACjD,GAAG,GAAG;AACN,WAAK,iBAAiB,IAAI,KAAK,YAAY;AAAA,IAC7C;AAEA,iBAAA;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,KAAK,UAAkB,YAAoB,MAAuB;AACvE,YAAQ,KAAK,IAAI,QAAQ,KAAK,OAAO,IAAI,GAAG,IAAI;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,MAAM,UAAkB,YAAoB,MAAuB;AACxE,YAAQ,MAAM,IAAI,QAAQ,KAAK,OAAO,IAAI,GAAG,IAAI;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,KAAK,UAAwC,OAAqB;AACvE,QAAI,CAAC,UAAU,MAAM,QAAS;AAC9B,QAAI,aAAa,aAAa,CAAC,UAAU,MAAM,QAAQ,EAAG;AAE1D,YAAQ,KAAK,IAAI,QAAQ,KAAK,KAAK,EAAE;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,QAAQ,UAAwC,OAAqB;AAC1E,QAAI,CAAC,UAAU,MAAM,QAAS;AAC9B,QAAI,aAAa,aAAa,CAAC,UAAU,MAAM,QAAQ,EAAG;AAE1D,YAAQ,QAAQ,IAAI,QAAQ,KAAK,KAAK,EAAE;AAAA,EAC1C;AACF;AAgBO,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA,EAKxB,YAAY,MAAY;AACtB,cAAU,MAAM,UAAU;AAC1B,cAAU,OAAO,oBAAoB;AACrC,cAAU,OAAO,YAAY;AAC7B,cAAU,OAAO,gBAAgB;AACjC,cAAU,YAAY,gBAAgB;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,MAAY;AACvB,cAAU,MAAM,UAAU;AAC1B,cAAU,MAAM,SAAS;AACzB,cAAU,MAAM,cAAc;AAC9B,cAAU,MAAM,OAAO;AAEvB,cAAU,MAAM,eAAe;AAC/B,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,cAAc;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAe,MAAY;AACzB,cAAU,MAAM,UAAU;AAC1B,cAAU,MAAM,eAAe;AAC/B,cAAU,OAAO,oBAAoB;AACrC,cAAU,OAAO,gBAAgB;AACjC,cAAU,OAAO,YAAY;AAE7B,cAAU,MAAM,SAAS;AACzB,cAAU,MAAM,cAAc;AAC9B,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,cAAc;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,oBAAoB,MAAY;AAC9B,cAAU,MAAM,UAAU;AAC1B,cAAU,MAAM,cAAc;AAC9B,cAAU,YAAY,gBAAgB;AAEtC,cAAU,MAAM,SAAS;AACzB,cAAU,MAAM,eAAe;AAC/B,cAAU,MAAM,cAAc;AAC9B,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,OAAO;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,WAAW,MAAY;AACrB,cAAU,MAAM,UAAU;AAC1B,cAAU,MAAM,OAAO;AAEvB,cAAU,MAAM,SAAS;AACzB,cAAU,MAAM,eAAe;AAC/B,cAAU,MAAM,cAAc;AAC9B,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,cAAc;AAAA,EAChC;AAAA,EAEA,YAAY,MAAY;AACtB,cAAU,MAAM,UAAU;AAC1B,cAAU,MAAM,QAAQ;AAExB,cAAU,MAAM,SAAS;AACzB,cAAU,MAAM,eAAe;AAC/B,cAAU,MAAM,cAAc;AAC9B,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,cAAc;AAC9B,cAAU,MAAM,OAAO;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAU,MAAY;AACpB,cAAU,MAAM,UAAU;AAC1B,cAAU,MAAM,SAAS;AACzB,cAAU,MAAM,eAAe;AAC/B,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,cAAc;AAC9B,cAAU,MAAM,OAAO;AACvB,cAAU,MAAM,cAAc;AAC9B,cAAU,OAAO,oBAAoB;AACrC,cAAU,OAAO,gBAAgB;AACjC,cAAU,OAAO,YAAY;AAC7B,cAAU,YAAY,gBAAgB;AAAA,EACxC;AACF;;;;"}