@number10/jsx-core 5.0.0

package/dist/colors/contrast-contracts.js

@@ -0,0 +1,265 @@
+import { numberToHex, getContrastRatio, ensureContrast } from "./color-utils.js";
+const contrastBackgroundRoles = {
+  "background/default": {
+    description: "Main application background.",
+    color: { group: "background", shade: "DEFAULT" }
+  },
+  "surface/default": {
+    description: "Default surface for panels, cards, and controls.",
+    color: { group: "surface", shade: "DEFAULT" }
+  },
+  "surface/elevated": {
+    description: "Elevated surface used for stronger separation.",
+    color: { group: "surface", shade: "light" }
+  },
+  "brand/primary": {
+    description: "Primary brand background.",
+    color: { group: "primary", shade: "dark" }
+  },
+  "feedback/success": {
+    description: "Success-state background.",
+    color: { group: "success", shade: "dark" }
+  },
+  "feedback/warning": {
+    description: "Warning-state background.",
+    color: { group: "warning", shade: "dark" }
+  },
+  "feedback/error": {
+    description: "Error-state background.",
+    color: { group: "error", shade: "dark" }
+  }
+};
+const contrastForegroundRoles = {
+  "text/default": {
+    description: "Default body text.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "DEFAULT" },
+      { group: "text", shade: "dark" },
+      { group: "text", shade: "darkest" },
+      { group: "text", shade: "light" }
+    ]
+  },
+  "text/muted": {
+    description: "Secondary or supporting text.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "light" },
+      { group: "text", shade: "medium" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "text/strong": {
+    description: "Emphasized text on neutral surfaces.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "darkest" },
+      { group: "text", shade: "dark" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "text/on-brand": {
+    description: "Text intended for strong brand or colored backgrounds.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "text/on-danger": {
+    description: "Text intended for danger/error backgrounds.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "icon/on-brand": {
+    description: "Icon tint intended for strong brand or colored backgrounds.",
+    kind: "icon",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "icon/on-danger": {
+    description: "Icon tint intended for danger/error backgrounds.",
+    kind: "icon",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  }
+};
+const defaultContrastContracts = [
+  {
+    id: "body-on-background",
+    description: "Default body text on the main application background.",
+    foregroundRole: "text/default",
+    backgroundRole: "background/default",
+    minRatio: 4.5
+  },
+  {
+    id: "body-on-surface",
+    description: "Default body text on standard surfaces and cards.",
+    foregroundRole: "text/default",
+    backgroundRole: "surface/default",
+    minRatio: 4.5
+  },
+  {
+    id: "muted-on-surface",
+    description: "Muted supporting text on standard surfaces.",
+    foregroundRole: "text/muted",
+    backgroundRole: "surface/default",
+    minRatio: 4.5
+  },
+  {
+    id: "strong-on-surface",
+    description: "Strong emphasized text on elevated surfaces.",
+    foregroundRole: "text/strong",
+    backgroundRole: "surface/elevated",
+    minRatio: 4.5
+  },
+  {
+    id: "text-on-primary",
+    description: "Readable text on the primary brand background.",
+    foregroundRole: "text/on-brand",
+    backgroundRole: "brand/primary",
+    minRatio: 4.5
+  },
+  {
+    id: "text-on-error",
+    description: "Readable text on the error background.",
+    foregroundRole: "text/on-danger",
+    backgroundRole: "feedback/error",
+    minRatio: 4.5
+  },
+  {
+    id: "icon-on-primary",
+    description: "Readable icon tint on the primary brand background.",
+    foregroundRole: "icon/on-brand",
+    backgroundRole: "brand/primary",
+    minRatio: 3
+  },
+  {
+    id: "icon-on-error",
+    description: "Readable icon tint on the error background.",
+    foregroundRole: "icon/on-danger",
+    backgroundRole: "feedback/error",
+    minRatio: 3
+  }
+];
+function resolveContrastColorRef(colors, ref) {
+  return colors[ref.group][ref.shade].toNumber();
+}
+function resolveContrastBackgroundRole(colors, role) {
+  const definition = contrastBackgroundRoles[role];
+  const value = resolveContrastColorRef(colors, definition.color);
+  return {
+    role,
+    value,
+    hex: numberToHex(value)
+  };
+}
+function resolveContrastForegroundRole(colors, role, background, minRatio) {
+  const definition = contrastForegroundRoles[role];
+  const resolvedCandidates = definition.candidates.map((candidate) => ({
+    candidate,
+    value: resolveContrastColorRef(colors, candidate)
+  }));
+  const exactMatch = resolvedCandidates.find(
+    ({ value }) => getContrastRatio(value, background) >= minRatio
+  );
+  if (exactMatch) {
+    return {
+      role,
+      kind: definition.kind,
+      source: "token",
+      candidate: exactMatch.candidate,
+      value: exactMatch.value,
+      hex: numberToHex(exactMatch.value)
+    };
+  }
+  const preferred = resolvedCandidates[0];
+  if (!preferred) {
+    throw new Error(`Contrast foreground role "${role}" has no candidate colors.`);
+  }
+  const adjustedValue = ensureContrast(preferred.value, background, minRatio);
+  return {
+    role,
+    kind: definition.kind,
+    source: "adjusted",
+    candidate: preferred.candidate,
+    value: adjustedValue,
+    hex: numberToHex(adjustedValue)
+  };
+}
+function resolveContrastContract(colors, contract) {
+  const background = resolveContrastBackgroundRole(colors, contract.backgroundRole);
+  const foreground = resolveContrastForegroundRole(
+    colors,
+    contract.foregroundRole,
+    background.value,
+    contract.minRatio
+  );
+  const ratio = getContrastRatio(foreground.value, background.value);
+  return {
+    contract,
+    foreground,
+    background,
+    ratio,
+    passes: ratio >= contract.minRatio
+  };
+}
+function validateContrastContracts(colors, contracts = defaultContrastContracts) {
+  return contracts.map((contract) => resolveContrastContract(colors, contract));
+}
+function getFailingContrastContracts(colors, contracts = defaultContrastContracts) {
+  return validateContrastContracts(colors, contracts).filter((result) => !result.passes);
+}
+function getContrastContract(contractId) {
+  return defaultContrastContracts.find((contract) => contract.id === contractId);
+}
+function resolveContrastContractById(colors, contractId) {
+  const contract = getContrastContract(contractId);
+  if (!contract) throw new Error(`Contrast contract not found: ${contractId}`);
+  return resolveContrastContract(colors, contract);
+}
+function resolveContrastTextColor(colors, foregroundRole, background, minRatio = 4.5) {
+  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).hex;
+}
+function resolveContrastTintColor(colors, foregroundRole, background, minRatio = 3) {
+  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).value;
+}
+function formatResolvedContrastContract(resolved) {
+  const { contract, foreground, background, ratio } = resolved;
+  const status = resolved.passes ? "✓" : "✗";
+  return [
+    `${status} ${contract.id}`,
+    `  ${contract.description}`,
+    `  fg: ${foreground.hex}  role=${foreground.role}  kind=${foreground.kind}  src=${foreground.source}`,
+    `  bg: ${background.hex}  role=${background.role}`,
+    `  ratio: ${ratio.toFixed(2)}:1  (need ≥ ${contract.minRatio}:1)`
+  ].join("\n");
+}
+export {
+  contrastBackgroundRoles,
+  contrastForegroundRoles,
+  defaultContrastContracts,
+  formatResolvedContrastContract,
+  getContrastContract,
+  getFailingContrastContracts,
+  resolveContrastBackgroundRole,
+  resolveContrastColorRef,
+  resolveContrastContract,
+  resolveContrastContractById,
+  resolveContrastForegroundRole,
+  resolveContrastTextColor,
+  resolveContrastTintColor,
+  validateContrastContracts
+};
+//# sourceMappingURL=contrast-contracts.js.map

package/dist/colors/contrast-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast-contracts.js","sources":["../../src/colors/contrast-contracts.ts"],"sourcesContent":["/**\n * Semantic contrast contracts for theme and preset authors.\n *\n * This file is intentionally a small first step:\n * - define a shared language for meaningful foreground/background pairings\n * - expose helpers that can resolve and validate those pairings\n * - keep room for a second step where component defaults and tests adopt them\n *\n * TODO(step-2): let theme-default builders consume these contracts directly.\n * TODO(step-2): move component-level contrast test heuristics onto this model.\n * TODO(step-3): add context-aware contracts for alpha/translucent surfaces.\n */\n\nimport type { ColorTokens, ShadeLevel } from './color-types'\nimport { ensureContrast, getContrastRatio, numberToHex } from './color-utils'\n\ntype TokenColorGroup =\n  | 'background'\n  | 'surface'\n  | 'text'\n  | 'border'\n  | 'primary'\n  | 'secondary'\n  | 'accent'\n  | 'success'\n  | 'warning'\n  | 'error'\n  | 'info'\n\nexport interface ContrastColorRef {\n  group: TokenColorGroup\n  shade: ShadeLevel | 'DEFAULT'\n}\n\nexport interface ContrastBackgroundRoleDefinition {\n  description: string\n  color: ContrastColorRef\n}\n\nexport interface ContrastForegroundRoleDefinition {\n  description: string\n  kind: 'text' | 'icon'\n  candidates: readonly ContrastColorRef[]\n}\n\nexport const contrastBackgroundRoles = {\n  'background/default': {\n    description: 'Main application background.',\n    color: { group: 'background', shade: 'DEFAULT' },\n  },\n  'surface/default': {\n    description: 'Default surface for panels, cards, and controls.',\n    color: { group: 'surface', shade: 'DEFAULT' },\n  },\n  'surface/elevated': {\n    description: 'Elevated surface used for stronger separation.',\n    color: { group: 'surface', shade: 'light' },\n  },\n  'brand/primary': {\n    description: 'Primary brand background.',\n    color: { group: 'primary', shade: 'dark' },\n  },\n  'feedback/success': {\n    description: 'Success-state background.',\n    color: { group: 'success', shade: 'dark' },\n  },\n  'feedback/warning': {\n    description: 'Warning-state background.',\n    color: { group: 'warning', shade: 'dark' },\n  },\n  'feedback/error': {\n    description: 'Error-state background.',\n    color: { group: 'error', shade: 'dark' },\n  },\n} as const satisfies Record<string, ContrastBackgroundRoleDefinition>\n\nexport type ContrastBackgroundRole = keyof typeof contrastBackgroundRoles\n\nexport const contrastForegroundRoles = {\n  'text/default': {\n    description: 'Default body text.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'DEFAULT' },\n      { group: 'text', shade: 'dark' },\n      { group: 'text', shade: 'darkest' },\n      { group: 'text', shade: 'light' },\n    ],\n  },\n  'text/muted': {\n    description: 'Secondary or supporting text.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'medium' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'text/strong': {\n    description: 'Emphasized text on neutral surfaces.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'darkest' },\n      { group: 'text', shade: 'dark' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'text/on-brand': {\n    description: 'Text intended for strong brand or colored backgrounds.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'text/on-danger': {\n    description: 'Text intended for danger/error backgrounds.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'icon/on-brand': {\n    description: 'Icon tint intended for strong brand or colored backgrounds.',\n    kind: 'icon',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'icon/on-danger': {\n    description: 'Icon tint intended for danger/error backgrounds.',\n    kind: 'icon',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n} as const satisfies Record<string, ContrastForegroundRoleDefinition>\n\nexport type ContrastForegroundRole = keyof typeof contrastForegroundRoles\n\nexport interface ContrastContract {\n  id: string\n  description: string\n  foregroundRole: ContrastForegroundRole\n  backgroundRole: ContrastBackgroundRole\n  minRatio: number\n}\n\nexport const defaultContrastContracts = [\n  {\n    id: 'body-on-background',\n    description: 'Default body text on the main application background.',\n    foregroundRole: 'text/default',\n    backgroundRole: 'background/default',\n    minRatio: 4.5,\n  },\n  {\n    id: 'body-on-surface',\n    description: 'Default body text on standard surfaces and cards.',\n    foregroundRole: 'text/default',\n    backgroundRole: 'surface/default',\n    minRatio: 4.5,\n  },\n  {\n    id: 'muted-on-surface',\n    description: 'Muted supporting text on standard surfaces.',\n    foregroundRole: 'text/muted',\n    backgroundRole: 'surface/default',\n    minRatio: 4.5,\n  },\n  {\n    id: 'strong-on-surface',\n    description: 'Strong emphasized text on elevated surfaces.',\n    foregroundRole: 'text/strong',\n    backgroundRole: 'surface/elevated',\n    minRatio: 4.5,\n  },\n  {\n    id: 'text-on-primary',\n    description: 'Readable text on the primary brand background.',\n    foregroundRole: 'text/on-brand',\n    backgroundRole: 'brand/primary',\n    minRatio: 4.5,\n  },\n  {\n    id: 'text-on-error',\n    description: 'Readable text on the error background.',\n    foregroundRole: 'text/on-danger',\n    backgroundRole: 'feedback/error',\n    minRatio: 4.5,\n  },\n  {\n    id: 'icon-on-primary',\n    description: 'Readable icon tint on the primary brand background.',\n    foregroundRole: 'icon/on-brand',\n    backgroundRole: 'brand/primary',\n    minRatio: 3,\n  },\n  {\n    id: 'icon-on-error',\n    description: 'Readable icon tint on the error background.',\n    foregroundRole: 'icon/on-danger',\n    backgroundRole: 'feedback/error',\n    minRatio: 3,\n  },\n] as const satisfies readonly ContrastContract[]\n\nexport interface ResolvedContrastColor {\n  role: ContrastForegroundRole | ContrastBackgroundRole\n  value: number\n  hex: string\n}\n\nexport interface ResolvedContrastForeground extends ResolvedContrastColor {\n  kind: 'text' | 'icon'\n  source: 'token' | 'adjusted'\n  candidate: ContrastColorRef\n}\n\nexport interface ResolvedContrastContract {\n  contract: ContrastContract\n  foreground: ResolvedContrastForeground\n  background: ResolvedContrastColor\n  ratio: number\n  passes: boolean\n}\n\nexport function resolveContrastColorRef(colors: ColorTokens, ref: ContrastColorRef): number {\n  return colors[ref.group][ref.shade].toNumber()\n}\n\nexport function resolveContrastBackgroundRole(\n  colors: ColorTokens,\n  role: ContrastBackgroundRole\n): ResolvedContrastColor {\n  const definition = contrastBackgroundRoles[role]\n  const value = resolveContrastColorRef(colors, definition.color)\n\n  return {\n    role,\n    value,\n    hex: numberToHex(value),\n  }\n}\n\nexport function resolveContrastForegroundRole(\n  colors: ColorTokens,\n  role: ContrastForegroundRole,\n  background: number,\n  minRatio: number\n): ResolvedContrastForeground {\n  const definition = contrastForegroundRoles[role]\n  const resolvedCandidates = definition.candidates.map((candidate) => ({\n    candidate,\n    value: resolveContrastColorRef(colors, candidate),\n  }))\n\n  const exactMatch = resolvedCandidates.find(\n    ({ value }) => getContrastRatio(value, background) >= minRatio\n  )\n\n  if (exactMatch) {\n    return {\n      role,\n      kind: definition.kind,\n      source: 'token',\n      candidate: exactMatch.candidate,\n      value: exactMatch.value,\n      hex: numberToHex(exactMatch.value),\n    }\n  }\n\n  const preferred = resolvedCandidates[0]\n  if (!preferred) {\n    throw new Error(`Contrast foreground role \"${role}\" has no candidate colors.`)\n  }\n\n  const adjustedValue = ensureContrast(preferred.value, background, minRatio)\n\n  return {\n    role,\n    kind: definition.kind,\n    source: 'adjusted',\n    candidate: preferred.candidate,\n    value: adjustedValue,\n    hex: numberToHex(adjustedValue),\n  }\n}\n\nexport function resolveContrastContract(\n  colors: ColorTokens,\n  contract: ContrastContract\n): ResolvedContrastContract {\n  const background = resolveContrastBackgroundRole(colors, contract.backgroundRole)\n  const foreground = resolveContrastForegroundRole(\n    colors,\n    contract.foregroundRole,\n    background.value,\n    contract.minRatio\n  )\n  const ratio = getContrastRatio(foreground.value, background.value)\n\n  return {\n    contract,\n    foreground,\n    background,\n    ratio,\n    passes: ratio >= contract.minRatio,\n  }\n}\n\nexport function validateContrastContracts(\n  colors: ColorTokens,\n  contracts: readonly ContrastContract[] = defaultContrastContracts\n): ResolvedContrastContract[] {\n  return contracts.map((contract) => resolveContrastContract(colors, contract))\n}\n\nexport function getFailingContrastContracts(\n  colors: ColorTokens,\n  contracts: readonly ContrastContract[] = defaultContrastContracts\n): ResolvedContrastContract[] {\n  return validateContrastContracts(colors, contracts).filter((result) => !result.passes)\n}\n\nexport function getContrastContract(contractId: string): ContrastContract | undefined {\n  return defaultContrastContracts.find((contract) => contract.id === contractId)\n}\n\n/**\n * Resolve a contract by id, throwing if the contract is not found.\n * Convenience wrapper around getContrastContract + resolveContrastContract.\n * @param colors - The color token set\n * @param contractId - The contract identifier (e.g. 'text-on-primary')\n * @returns Resolved contract with foreground, background, ratio, and pass/fail\n * @throws If no contract with the given id exists\n */\nexport function resolveContrastContractById(\n  colors: ColorTokens,\n  contractId: string\n): ResolvedContrastContract {\n  const contract = getContrastContract(contractId)\n  if (!contract) throw new Error(`Contrast contract not found: ${contractId}`)\n  return resolveContrastContract(colors, contract)\n}\n\n/**\n * Convenience: resolve a foreground role against a numeric background and\n * return the resulting hex color string (for Text style `.color`).\n * @param colors - The color token set\n * @param foregroundRole - Semantic foreground role (e.g. 'text/on-brand')\n * @param background - Numeric background color to check contrast against\n * @param minRatio - Minimum contrast ratio (defaults to WCAG AA 4.5:1)\n * @returns Hex color string suitable for Text style `.color`\n */\nexport function resolveContrastTextColor(\n  colors: ColorTokens,\n  foregroundRole: ContrastForegroundRole,\n  background: number,\n  minRatio = 4.5\n): string {\n  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).hex\n}\n\n/**\n * Convenience: resolve a foreground role against a numeric background and\n * return the resulting numeric color (for Icon `.tint` or similar).\n * @param colors - The color token set\n * @param foregroundRole - Semantic foreground role (e.g. 'icon/on-brand')\n * @param background - Numeric background color to check contrast against\n * @param minRatio - Minimum contrast ratio (defaults to 3:1 for icons/UI graphics)\n * @returns Numeric color value\n */\nexport function resolveContrastTintColor(\n  colors: ColorTokens,\n  foregroundRole: ContrastForegroundRole,\n  background: number,\n  minRatio = 3\n): number {\n  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).value\n}\n\n/**\n * Format a resolved contract as a human-readable multi-line string.\n * Useful for debugging, CLI output, and authoring tools.\n * @param resolved - A resolved contrast contract\n * @returns Formatted description string\n */\nexport function formatResolvedContrastContract(resolved: ResolvedContrastContract): string {\n  const { contract, foreground, background, ratio } = resolved\n  const status = resolved.passes ? '✓' : '✗'\n  return [\n    `${status} ${contract.id}`,\n    `  ${contract.description}`,\n    `  fg: ${foreground.hex}  role=${foreground.role}  kind=${foreground.kind}  src=${foreground.source}`,\n    `  bg: ${background.hex}  role=${background.role}`,\n    `  ratio: ${ratio.toFixed(2)}:1  (need ≥ ${contract.minRatio}:1)`,\n  ].join('\\n')\n}\n"],"names":[],"mappings":"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"}

package/dist/colors/index.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const colorTypes = require("./color-types.cjs");
+const colorUtils = require("./color-utils.cjs");
+const contrastContracts = require("./contrast-contracts.cjs");
+const colorPresets = require("./color-presets.cjs");
+const colorThemeHelpers = require("./color-theme-helpers.cjs");
+exports.HexColor = colorTypes.HexColor;
+exports.alpha = colorUtils.alpha;
+exports.createTextStyle = colorUtils.createTextStyle;
+exports.darken = colorUtils.darken;
+exports.darkenHex = colorUtils.darkenHex;
+exports.ensureContrast = colorUtils.ensureContrast;
+exports.getContrastRatio = colorUtils.getContrastRatio;
+exports.hexToNumber = colorUtils.hexToNumber;
+exports.hslToNumber = colorUtils.hslToNumber;
+exports.hslToRgb = colorUtils.hslToRgb;
+exports.lighten = colorUtils.lighten;
+exports.lightenHex = colorUtils.lightenHex;
+exports.normalizeColorNumber = colorUtils.normalizeColorNumber;
+exports.normalizeTextColor = colorUtils.normalizeTextColor;
+exports.numberToHex = colorUtils.numberToHex;
+exports.numberToHsl = colorUtils.numberToHsl;
+exports.numberToRgb = colorUtils.numberToRgb;
+exports.rgbToHsl = colorUtils.rgbToHsl;
+exports.rgbToNumber = colorUtils.rgbToNumber;
+exports.contrastBackgroundRoles = contrastContracts.contrastBackgroundRoles;
+exports.contrastForegroundRoles = contrastContracts.contrastForegroundRoles;
+exports.defaultContrastContracts = contrastContracts.defaultContrastContracts;
+exports.formatResolvedContrastContract = contrastContracts.formatResolvedContrastContract;
+exports.getContrastContract = contrastContracts.getContrastContract;
+exports.getFailingContrastContracts = contrastContracts.getFailingContrastContracts;
+exports.resolveContrastBackgroundRole = contrastContracts.resolveContrastBackgroundRole;
+exports.resolveContrastColorRef = contrastContracts.resolveContrastColorRef;
+exports.resolveContrastContract = contrastContracts.resolveContrastContract;
+exports.resolveContrastContractById = contrastContracts.resolveContrastContractById;
+exports.resolveContrastForegroundRole = contrastContracts.resolveContrastForegroundRole;
+exports.resolveContrastTextColor = contrastContracts.resolveContrastTextColor;
+exports.resolveContrastTintColor = contrastContracts.resolveContrastTintColor;
+exports.validateContrastContracts = contrastContracts.validateContrastContracts;
+exports.applyDarkMode = colorPresets.applyDarkMode;
+exports.applyLightMode = colorPresets.applyLightMode;
+exports.forestGreenPreset = colorPresets.forestGreenPreset;
+exports.generateColorScale = colorPresets.generateColorScale;
+exports.getPreset = colorPresets.getPreset;
+exports.getPresetWithMode = colorPresets.getPresetWithMode;
+exports.midnightPreset = colorPresets.midnightPreset;
+exports.oceanBluePreset = colorPresets.oceanBluePreset;
+exports.presets = colorPresets.presets;
+exports.colorsToTheme = colorThemeHelpers.colorsToTheme;
+exports.getBackgroundColor = colorThemeHelpers.getBackgroundColor;
+exports.getBorderColor = colorThemeHelpers.getBorderColor;
+exports.getSurfaceColor = colorThemeHelpers.getSurfaceColor;
+exports.getTextColor = colorThemeHelpers.getTextColor;
+//# sourceMappingURL=index.cjs.map

package/dist/colors/index.cjs.map

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

package/dist/colors/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Color system — renderer-neutral color math and presets.
+ *
+ * @migration(audit:scene-portal-mount) Phase 3C — extracted from packages/ui/src/colors.
+ *   Pure color types, utilities, and presets. Theme-dependent hooks stay in Phaser package.
+ */
+export { HexColor } from './color-types';
+export type { ColorMode, ColorShade, ColorTokens, RGBColor, ShadeLevel } from './color-types';
+export { hexToNumber, hslToNumber, hslToRgb, normalizeColorNumber, normalizeTextColor, numberToHex, numberToHsl, numberToRgb, rgbToHsl, rgbToNumber, } from './color-utils';
+export { alpha, darken, darkenHex, lighten, lightenHex } from './color-utils';
+export type { HSLColor } from './color-utils';
+export { createTextStyle, ensureContrast, getContrastRatio } from './color-utils';
+export { contrastBackgroundRoles, contrastForegroundRoles, defaultContrastContracts, formatResolvedContrastContract, getContrastContract, getFailingContrastContracts, resolveContrastBackgroundRole, resolveContrastColorRef, resolveContrastContract, resolveContrastContractById, resolveContrastForegroundRole, resolveContrastTextColor, resolveContrastTintColor, validateContrastContracts, type ContrastBackgroundRole, type ContrastBackgroundRoleDefinition, type ContrastColorRef, type ContrastContract, type ContrastForegroundRole, type ContrastForegroundRoleDefinition, type ResolvedContrastColor, type ResolvedContrastContract, type ResolvedContrastForeground, } from './contrast-contracts';
+export { applyDarkMode, applyLightMode, forestGreenPreset, generateColorScale, getPreset, getPresetWithMode, midnightPreset, oceanBluePreset, presets, type ColorPreset, type PresetName, } from './color-presets';
+export { colorsToTheme, getBackgroundColor, getBorderColor, getSurfaceColor, getTextColor, } from './color-theme-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/colors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/colors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG7F,OAAO,EACL,WAAW,EACX,WAAW,EACX,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,GACZ,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC7E,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGjF,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,mBAAmB,EACnB,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACrC,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,GAChC,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,uBAAuB,CAAA"}

package/dist/colors/index.js

@@ -0,0 +1,55 @@
+import { HexColor } from "./color-types.js";
+import { alpha, createTextStyle, darken, darkenHex, ensureContrast, getContrastRatio, hexToNumber, hslToNumber, hslToRgb, lighten, lightenHex, normalizeColorNumber, normalizeTextColor, numberToHex, numberToHsl, numberToRgb, rgbToHsl, rgbToNumber } from "./color-utils.js";
+import { contrastBackgroundRoles, contrastForegroundRoles, defaultContrastContracts, formatResolvedContrastContract, getContrastContract, getFailingContrastContracts, resolveContrastBackgroundRole, resolveContrastColorRef, resolveContrastContract, resolveContrastContractById, resolveContrastForegroundRole, resolveContrastTextColor, resolveContrastTintColor, validateContrastContracts } from "./contrast-contracts.js";
+import { applyDarkMode, applyLightMode, forestGreenPreset, generateColorScale, getPreset, getPresetWithMode, midnightPreset, oceanBluePreset, presets } from "./color-presets.js";
+import { colorsToTheme, getBackgroundColor, getBorderColor, getSurfaceColor, getTextColor } from "./color-theme-helpers.js";
+export {
+  HexColor,
+  alpha,
+  applyDarkMode,
+  applyLightMode,
+  colorsToTheme,
+  contrastBackgroundRoles,
+  contrastForegroundRoles,
+  createTextStyle,
+  darken,
+  darkenHex,
+  defaultContrastContracts,
+  ensureContrast,
+  forestGreenPreset,
+  formatResolvedContrastContract,
+  generateColorScale,
+  getBackgroundColor,
+  getBorderColor,
+  getContrastContract,
+  getContrastRatio,
+  getFailingContrastContracts,
+  getPreset,
+  getPresetWithMode,
+  getSurfaceColor,
+  getTextColor,
+  hexToNumber,
+  hslToNumber,
+  hslToRgb,
+  lighten,
+  lightenHex,
+  midnightPreset,
+  normalizeColorNumber,
+  normalizeTextColor,
+  numberToHex,
+  numberToHsl,
+  numberToRgb,
+  oceanBluePreset,
+  presets,
+  resolveContrastBackgroundRole,
+  resolveContrastColorRef,
+  resolveContrastContract,
+  resolveContrastContractById,
+  resolveContrastForegroundRole,
+  resolveContrastTextColor,
+  resolveContrastTintColor,
+  rgbToHsl,
+  rgbToNumber,
+  validateContrastContracts
+};
+//# sourceMappingURL=index.js.map

package/dist/colors/index.js.map

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

package/dist/core-props.cjs

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function clampToViewport(x, y, boxWidth, boxHeight, viewport, padding = 8) {
+  return {
+    x: Math.min(Math.max(padding, x), Math.max(padding, viewport.width - boxWidth - padding)),
+    y: Math.min(Math.max(padding, y), Math.max(padding, viewport.height - boxHeight - padding))
+  };
+}
+function getOverlayPosition(placement, anchor, contentWidth, contentHeight, offset = 4) {
+  const cx = anchor.x + anchor.width / 2;
+  const cy = anchor.y + anchor.height / 2;
+  switch (placement) {
+    case "top":
+      return { x: cx - contentWidth / 2, y: anchor.y - contentHeight - offset };
+    case "bottom":
+      return { x: cx - contentWidth / 2, y: anchor.y + anchor.height + offset };
+    case "left":
+      return { x: anchor.x - contentWidth - offset, y: cy - contentHeight / 2 };
+    case "right":
+      return { x: anchor.x + anchor.width + offset, y: cy - contentHeight / 2 };
+    case "top-start":
+      return { x: anchor.x, y: anchor.y - contentHeight - offset };
+    case "top-end":
+      return { x: anchor.x + anchor.width - contentWidth, y: anchor.y - contentHeight - offset };
+    case "bottom-start":
+      return { x: anchor.x, y: anchor.y + anchor.height + offset };
+    case "bottom-end":
+      return { x: anchor.x + anchor.width - contentWidth, y: anchor.y + anchor.height + offset };
+    case "left-start":
+      return { x: anchor.x - contentWidth - offset, y: anchor.y };
+    case "left-end":
+      return { x: anchor.x - contentWidth - offset, y: anchor.y + anchor.height - contentHeight };
+    case "right-start":
+      return { x: anchor.x + anchor.width + offset, y: anchor.y };
+    case "right-end":
+      return { x: anchor.x + anchor.width + offset, y: anchor.y + anchor.height - contentHeight };
+    default:
+      return { x: cx - contentWidth / 2, y: anchor.y + anchor.height + offset };
+  }
+}
+function normalizeEdgeInsets(value) {
+  if (value === void 0) return {};
+  if (typeof value === "number") {
+    return { top: value, right: value, bottom: value, left: value };
+  }
+  return value;
+}
+function normalizeCornerRadius(value) {
+  if (value === void 0) return 0;
+  if (typeof value === "number") return value;
+  return value;
+}
+function normalizeGap(value) {
+  if (value === void 0) return { horizontal: 0, vertical: 0 };
+  if (typeof value === "number") return { horizontal: value, vertical: value };
+  return {
+    horizontal: value.horizontal ?? 0,
+    vertical: value.vertical ?? 0
+  };
+}
+exports.clampToViewport = clampToViewport;
+exports.getOverlayPosition = getOverlayPosition;
+exports.normalizeCornerRadius = normalizeCornerRadius;
+exports.normalizeEdgeInsets = normalizeEdgeInsets;
+exports.normalizeGap = normalizeGap;
+//# sourceMappingURL=core-props.cjs.map

package/dist/core-props.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-props.cjs","sources":["../src/core-props.ts"],"sourcesContent":["/**\n * Core prop type definitions — renderer-neutral component properties.\n * These prop groups can be composed to build component-specific props.\n *\n * @migration(audit:scene-portal-mount) Phase 3A — split from packages/ui/src/core-props.ts.\n *   Portable types live here in @number10/jsx-core. Phaser-specific props\n *   (PhaserProps, TextSpecificProps, GestureProps) remain in the Phaser package.\n */\n\nimport type { AnimatedSignal } from './animation/animated-signal'\n\n// ---------------------------------------------------------------------------\n// Animatable value helper\n// ---------------------------------------------------------------------------\n\n/**\n * Utility type that allows a value to be either a direct value or an\n * {@link AnimatedSignal}. Enables direct binding of `useSpring` / `useTween`\n * signals to JSX props without needing `useForceRedraw` + `.value`.\n *\n * @example\n * ```tsx\n * const [x, setX] = useSpring(0)\n * <View x={x} />  // ✅ x is Animatable<number> → accepts AnimatedSignal\n * ```\n */\nexport type Animatable<T> = T | AnimatedSignal\n\n// ---------------------------------------------------------------------------\n// Size value types\n// ---------------------------------------------------------------------------\n\n/**\n * Valid CSS-like size values with type safety\n * - Fixed pixels: number or \"20px\"\n * - Percentage: \"50%\", \"100%\"\n * - Viewport units: \"100vw\", \"50vh\"\n * - Keywords: \"auto\", \"fill\"\n * - Calc expressions: \"calc(100% - 20px)\"\n */\nexport type SizeValue =\n  | number\n  | 'auto'\n  | 'fill'\n  | `${number}%`\n  | `${number}px`\n  | `${number}vw`\n  | `${number}vh`\n  | `calc(${string})`\n\n/**\n * Flex basis size values (subset of SizeValue, no \"fill\" keyword)\n */\nexport type FlexBasisValue =\n  | number\n  | 'auto'\n  | `${number}%`\n  | `${number}px`\n  | `${number}vw`\n  | `${number}vh`\n  | `calc(${string})`\n\n/**\n * Display mode for visibility control\n * - 'visible': Rendered and takes up layout space (default)\n * - 'invisible': Not rendered but takes up layout space\n * - 'none': Not rendered and does not take up layout space\n */\nexport type Display = 'visible' | 'invisible' | 'none'\n\n// ---------------------------------------------------------------------------\n// Viewport helpers (portable, for overlay positioning)\n// ---------------------------------------------------------------------------\n\n/**\n * Viewport dimensions used for overlay clamping and positioning.\n */\nexport interface ViewportSize {\n  width: number\n  height: number\n}\n\n/**\n * Clamp a position so that a box of the given size stays within the viewport.\n * @param x - Desired x position (left edge of the box)\n * @param y - Desired y position (top edge of the box)\n * @param boxWidth - Width of the box to clamp\n * @param boxHeight - Height of the box to clamp\n * @param viewport - Viewport dimensions\n * @param padding - Minimum padding from viewport edges (default 8)\n * @returns Clamped { x, y } position\n */\nexport function clampToViewport(\n  x: number,\n  y: number,\n  boxWidth: number,\n  boxHeight: number,\n  viewport: ViewportSize,\n  padding = 8\n): { x: number; y: number } {\n  return {\n    x: Math.min(Math.max(padding, x), Math.max(padding, viewport.width - boxWidth - padding)),\n    y: Math.min(Math.max(padding, y), Math.max(padding, viewport.height - boxHeight - padding)),\n  }\n}\n\n/**\n * Calculate the preferred placement for an overlay relative to an anchor rect.\n * Returns the anchor-relative position before viewport clamping.\n * @param placement - Preferred placement direction\n * @param anchor - Anchor rect in viewport coordinates\n * @param contentWidth - Width of the overlay content\n * @param contentHeight - Height of the overlay content\n * @param offset - Gap between anchor and overlay (default 4)\n * @returns Position relative to the anchor\n */\nexport function getOverlayPosition(\n  placement:\n    | 'top'\n    | 'bottom'\n    | 'left'\n    | 'right'\n    | 'top-start'\n    | 'top-end'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'left-start'\n    | 'left-end'\n    | 'right-start'\n    | 'right-end',\n  anchor: { x: number; y: number; width: number; height: number },\n  contentWidth: number,\n  contentHeight: number,\n  offset = 4\n): { x: number; y: number } {\n  const cx = anchor.x + anchor.width / 2\n  const cy = anchor.y + anchor.height / 2\n\n  switch (placement) {\n    case 'top':\n      return { x: cx - contentWidth / 2, y: anchor.y - contentHeight - offset }\n    case 'bottom':\n      return { x: cx - contentWidth / 2, y: anchor.y + anchor.height + offset }\n    case 'left':\n      return { x: anchor.x - contentWidth - offset, y: cy - contentHeight / 2 }\n    case 'right':\n      return { x: anchor.x + anchor.width + offset, y: cy - contentHeight / 2 }\n    case 'top-start':\n      return { x: anchor.x, y: anchor.y - contentHeight - offset }\n    case 'top-end':\n      return { x: anchor.x + anchor.width - contentWidth, y: anchor.y - contentHeight - offset }\n    case 'bottom-start':\n      return { x: anchor.x, y: anchor.y + anchor.height + offset }\n    case 'bottom-end':\n      return { x: anchor.x + anchor.width - contentWidth, y: anchor.y + anchor.height + offset }\n    case 'left-start':\n      return { x: anchor.x - contentWidth - offset, y: anchor.y }\n    case 'left-end':\n      return { x: anchor.x - contentWidth - offset, y: anchor.y + anchor.height - contentHeight }\n    case 'right-start':\n      return { x: anchor.x + anchor.width + offset, y: anchor.y }\n    case 'right-end':\n      return { x: anchor.x + anchor.width + offset, y: anchor.y + anchor.height - contentHeight }\n    default:\n      return { x: cx - contentWidth / 2, y: anchor.y + anchor.height + offset }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Geometric properties\n// ---------------------------------------------------------------------------\n\n/**\n * Transform properties — geometric transformations (position, rotation, scale)\n * and visual opacity.\n */\nexport interface TransformProps {\n  x?: Animatable<number>\n  y?: Animatable<number>\n  rotation?: Animatable<number>\n  scale?: Animatable<number>\n  scaleX?: Animatable<number>\n  scaleY?: Animatable<number>\n  /** Alpha transparency (0 = fully transparent, 1 = fully opaque) */\n  alpha?: Animatable<number>\n  /**\n   * Z-order / render depth. Higher values render on top.\n   * Supported by both Phaser (native depth property) and Pixi (child index).\n   */\n  depth?: number\n}\n\n// ---------------------------------------------------------------------------\n// Spacing types\n// ---------------------------------------------------------------------------\n\n/** Edge insets for margins and padding */\nexport interface EdgeInsets {\n  top?: number\n  right?: number\n  bottom?: number\n  left?: number\n}\n\n/** Gap insets for horizontal and vertical gaps */\nexport interface GapInsets {\n  horizontal?: number\n  vertical?: number\n}\n\n/** Corner radius specification */\nexport interface CornerRadiusInsets {\n  tl?: number\n  tr?: number\n  bl?: number\n  br?: number\n}\n\n// ---------------------------------------------------------------------------\n// Normalization helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize edge insets — converts number to all-sides object\n */\nexport function normalizeEdgeInsets(value: number | EdgeInsets | undefined): EdgeInsets {\n  if (value === undefined) return {}\n  if (typeof value === 'number') {\n    return { top: value, right: value, bottom: value, left: value }\n  }\n  return value\n}\n\n/**\n * Normalize corner radius — converts number to all-corners object\n */\nexport function normalizeCornerRadius(\n  value: number | CornerRadiusInsets | undefined\n): number | CornerRadiusInsets {\n  if (value === undefined) return 0\n  if (typeof value === 'number') return value\n  return value\n}\n\n/**\n * Normalize gap values — converts number to GapInsets object\n */\nexport function normalizeGap(value: number | GapInsets | undefined): {\n  horizontal: number\n  vertical: number\n} {\n  if (value === undefined) return { horizontal: 0, vertical: 0 }\n  if (typeof value === 'number') return { horizontal: value, vertical: value }\n  return {\n    horizontal: value.horizontal ?? 0,\n    vertical: value.vertical ?? 0,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Layout properties\n// ---------------------------------------------------------------------------\n\n/**\n * Layout properties — sizing, spacing, and layout participation.\n * Renderer-neutral. Every renderer maps these to its native layout system.\n */\nexport interface LayoutProps {\n  /** Visibility and layout participation */\n  visible?: boolean | Display\n\n  /** If true, object is rendered but excluded from layout calculations */\n  headless?: boolean\n\n  /** Width: number (px), \"50%\", \"100vw\", \"auto\", \"fill\", \"calc(...)\" */\n  width?: SizeValue | undefined\n\n  /** Height: number (px), \"50%\", \"100vh\", \"auto\", \"fill\", \"calc(...)\" */\n  height?: SizeValue | undefined\n\n  /** Minimum width constraint */\n  minWidth?: SizeValue | undefined\n\n  /** Minimum height constraint */\n  minHeight?: SizeValue | undefined\n\n  /** Maximum width constraint */\n  maxWidth?: SizeValue | undefined\n\n  /** Maximum height constraint */\n  maxHeight?: SizeValue | undefined\n\n  /** Margin outside the container */\n  margin?: number | EdgeInsets | undefined\n\n  /** Padding inside the container */\n  padding?: number | EdgeInsets | undefined\n\n  /** Layout direction: 'column' (default), 'row', 'stack' */\n  direction?: 'row' | 'column' | 'stack'\n\n  /** Gap between children */\n  gap?: number | GapInsets | undefined\n\n  /** Main axis alignment */\n  justifyContent?: 'start' | 'center' | 'end' | 'space-between' | 'space-around' | 'space-evenly'\n\n  /** Cross axis alignment */\n  alignItems?: 'start' | 'center' | 'end' | 'stretch'\n\n  /** Flex grow factor */\n  flex?: number\n\n  /** Flex shrink factor */\n  flexShrink?: number\n\n  /** Flex basis — initial size before flex distribution */\n  flexBasis?: FlexBasisValue | undefined\n\n  /** Overflow handling: 'visible' (default) or 'hidden' (clipped) */\n  overflow?: 'visible' | 'hidden'\n\n  /** Wrapping behavior for flex layouts */\n  flexWrap?: 'nowrap' | 'wrap' | 'wrap-reverse'\n\n  /** Alignment of wrapped lines */\n  alignContent?: 'start' | 'center' | 'end' | 'space-between' | 'space-around' | 'stretch'\n}\n\n// ---------------------------------------------------------------------------\n// Advanced border types (BorderPropsV2)\n// ---------------------------------------------------------------------------\n\n/**\n * Border line style for advanced border rendering.\n * - `'solid'`: Continuous line (default)\n * - `'dashed'`: Segmented line\n * - `'dotted'`: Rounded dotted line\n */\nexport type BorderLineStyle = 'solid' | 'dashed' | 'dotted'\n\n/**\n * Per-side inset values for border widths.\n * Each side can have a different thickness.\n */\nexport type BorderSideInsets<T> = {\n  top?: T\n  right?: T\n  bottom?: T\n  left?: T\n}\n\n/**\n * Advanced border configuration — extended border styling beyond\n * the legacy `borderWidth`/`borderColor`/`borderAlpha` props.\n *\n * When set on `BackgroundProps.border`, this object takes precedence\n * over the legacy border props.\n */\nexport interface BorderPropsV2 {\n  /** Border color (number, e.g. 0xff0000 for red) */\n  color?: number\n  /**\n   * Border opacity.\n   * Accepts either a plain value or an {@link AnimatedSignal}.\n   */\n  alpha?: Animatable<number>\n  /**\n   * Border width in pixels.\n   * - `number`: uniform width on all sides (supports `cornerRadius`)\n   * - `BorderSideInsets<number>`: per-side widths (supports `cornerRadius`)\n   */\n  width?: number | BorderSideInsets<number>\n  /** Line style: `'solid'` (default), `'dashed'`, or `'dotted'` */\n  style?: BorderLineStyle\n  /**\n   * Stroke pattern configuration.\n   *\n   * For `style: 'dashed'`, values are interpreted as alternating dash/gap\n   * lengths, e.g. `[5, 3]`.\n   *\n   * For `style: 'dotted'`, `dash[0]` is the gap and `dash[1]` optionally\n   * overrides the dot diameter.\n   */\n  dash?: number[]\n  /** Offset where the dash pattern starts */\n  dashOffset?: number\n  /** Line cap style: `'butt'`, `'round'`, `'square'`. */\n  cap?: 'butt' | 'round' | 'square'\n  /** Line join style: `'miter'`, `'round'`, `'bevel'`. */\n  join?: 'miter' | 'round' | 'bevel'\n  /**\n   * Border alignment relative to the edge: `'center'`, `'inside'`, `'outside'`.\n   * - `center`: centered on the edge\n   * - `inside`: fully inside the box\n   * - `outside`: fully outside the box\n   */\n  align?: 'center' | 'inside' | 'outside'\n}\n\n// ---------------------------------------------------------------------------\n// Background properties\n// ---------------------------------------------------------------------------\n\n/**\n * Background styling properties — renderer-neutral.\n * Each renderer maps colors and corner radii to its native drawing API.\n */\nexport interface BackgroundProps {\n  backgroundColor?: number | undefined\n  /**\n   * Background fill opacity.\n   * Accepts either a plain value or an {@link AnimatedSignal}.\n   */\n  backgroundAlpha?: Animatable<number> | undefined\n  cornerRadius?: number | CornerRadiusInsets | undefined\n  borderWidth?: number | undefined\n  borderColor?: number | undefined\n  /**\n   * Border stroke opacity.\n   * Accepts either a plain value or an {@link AnimatedSignal}.\n   */\n  borderAlpha?: Animatable<number> | undefined\n  /**\n   * Advanced border configuration (BorderPropsV2).\n   * When set, takes precedence over legacy `borderWidth`/`borderColor`/`borderAlpha`.\n   */\n  border?: BorderPropsV2 | undefined\n}\n\n// ---------------------------------------------------------------------------\n// Gesture properties — renderer-neutral touch / mouse / pointer contracts\n// ---------------------------------------------------------------------------\n\n/**\n * Touch move gesture state.\n */\nexport type TouchMoveState = 'start' | 'move' | 'end'\n\n/**\n * Data passed to gesture event handlers.\n * Renderer-agnostic — the pointer field is opaque.\n * Each renderer fills it with its own pointer type.\n */\nexport interface GestureEventData<TPointer = unknown> {\n  /** Renderer-specific pointer object */\n  pointer: TPointer\n  /** Local X coordinate relative to container origin (0,0) */\n  localX: number\n  /** Local Y coordinate relative to container origin (0,0) */\n  localY: number\n  /** Delta X since last move event (only for onTouchMove) */\n  dx?: number\n  /** Delta Y since last move event (only for onTouchMove) */\n  dy?: number\n  /** Width of the container's hit area */\n  width: number\n  /** Height of the container's hit area */\n  height: number\n  /** Whether pointer is currently inside the container hit area */\n  isInside?: boolean\n  /** Current state of touch move gesture (only for onTouchMove) */\n  state?: TouchMoveState\n\n  /** Stop event propagation to parent containers (DOM-style bubbling) */\n  stopPropagation(): void\n\n  /** Check if propagation has been stopped */\n  isPropagationStopped(): boolean\n}\n\n/**\n * Data passed to wheel event handlers.\n * Renderer-agnostic — pointer/originalEvent are opaque.\n */\nexport interface WheelEventData<TPointer = unknown, TOriginalEvent = unknown> {\n  /** Renderer-specific pointer object, if available */\n  pointer: TPointer\n  /** Local X coordinate relative to container origin (0,0) */\n  localX: number\n  /** Local Y coordinate relative to container origin (0,0) */\n  localY: number\n  /** Wheel scroll delta X (horizontal scrolling) */\n  deltaX: number\n  /** Wheel scroll delta Y (vertical scrolling) */\n  deltaY: number\n  /** Wheel scroll delta Z */\n  deltaZ: number\n  /** Delta mode: 0 = pixels, 1 = lines, 2 = pages */\n  deltaMode: number\n  /** Width of the container's hit area */\n  width: number\n  /** Height of the container's hit area */\n  height: number\n  /** Original platform wheel event */\n  originalEvent: TOriginalEvent\n\n  /** Stop event propagation to parent containers (DOM-style bubbling) */\n  stopPropagation(): void\n\n  /** Check if propagation has been stopped */\n  isPropagationStopped(): boolean\n\n  /** Prevent default browser behavior */\n  preventDefault(): void\n}\n\n/**\n * Tooltip position relative to the target element.\n */\nexport type TooltipPosition = 'top' | 'bottom' | 'left' | 'right'\n\n/**\n * Renderer-neutral tooltip animation configuration.\n * Renderers may ignore fields they cannot represent.\n */\nexport interface TooltipAnimation {\n  fadeIn?: number\n  fadeOut?: number\n  move?: { dx?: number; dy?: number }\n  pulse?: boolean\n  pulseScale?: [number, number]\n}\n\n/**\n * Tooltip configuration returned by `onTooltip`.\n * Text-only on purpose so each renderer can draw it natively.\n */\nexport interface TooltipConfig {\n  content: string\n  position?: TooltipPosition\n  showDelay?: number\n  hideDelay?: number\n  offset?: number\n  disabled?: boolean\n  autoDismiss?: number\n  animation?: TooltipAnimation\n}\n\n/**\n * Tooltip callback function.\n * Return `null` / `undefined` to disable the tooltip for the current hover.\n */\nexport type TooltipCallback = () => TooltipConfig | string | null | undefined\n\n/**\n * High-level gesture interaction props.\n * Renderer-neutral — each renderer provides its own GestureManager.\n */\nexport interface GestureProps<TPointer = unknown> {\n  /** Enable gesture system for this container */\n  enableGestures?: boolean\n\n  /** Called on pointer down + up on the same target (click/tap) */\n  onTouch?: (data: GestureEventData<TPointer>) => void\n\n  /** Called when pointer up occurs outside the container */\n  onTouchOutside?: (data: GestureEventData<TPointer>) => void\n\n  /** Called during pointer movement */\n  onTouchMove?: (data: GestureEventData<TPointer>) => void\n\n  /** Called when double tap/click is detected */\n  onDoubleTap?: (data: GestureEventData<TPointer>) => void\n\n  /** Called when pointer is held down for configured duration */\n  onLongPress?: (data: GestureEventData<TPointer>) => void\n\n  /** Called when mouse wheel / trackpad scroll occurs over the container */\n  onWheel?: (data: WheelEventData<TPointer>) => void\n\n  /**\n   * Tooltip configuration callback (desktop / pointer hover only).\n   * The API is portable, the renderer decides how to draw it.\n   */\n  onTooltip?: TooltipCallback\n\n  /** Duration in ms to trigger long press (default: 500ms) */\n  longPressDuration?: number\n\n  /** Max time in ms between taps for double tap (default: 300ms) */\n  doubleTapDelay?: number\n\n  /** Max time in ms for a valid touch/click (default: 500ms) */\n  maxTouchDuration?: number\n}\n"],"names":[],"mappings":";;AA4FO,SAAS,gBACd,GACA,GACA,UACA,WACA,UACA,UAAU,GACgB;AAC1B,SAAO;AAAA,IACL,GAAG,KAAK,IAAI,KAAK,IAAI,SAAS,CAAC,GAAG,KAAK,IAAI,SAAS,SAAS,QAAQ,WAAW,OAAO,CAAC;AAAA,IACxF,GAAG,KAAK,IAAI,KAAK,IAAI,SAAS,CAAC,GAAG,KAAK,IAAI,SAAS,SAAS,SAAS,YAAY,OAAO,CAAC;AAAA,EAAA;AAE9F;AAYO,SAAS,mBACd,WAaA,QACA,cACA,eACA,SAAS,GACiB;AAC1B,QAAM,KAAK,OAAO,IAAI,OAAO,QAAQ;AACrC,QAAM,KAAK,OAAO,IAAI,OAAO,SAAS;AAEtC,UAAQ,WAAA;AAAA,IACN,KAAK;AACH,aAAO,EAAE,GAAG,KAAK,eAAe,GAAG,GAAG,OAAO,IAAI,gBAAgB,OAAA;AAAA,IACnE,KAAK;AACH,aAAO,EAAE,GAAG,KAAK,eAAe,GAAG,GAAG,OAAO,IAAI,OAAO,SAAS,OAAA;AAAA,IACnE,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,eAAe,QAAQ,GAAG,KAAK,gBAAgB,EAAA;AAAA,IACxE,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,OAAO,QAAQ,QAAQ,GAAG,KAAK,gBAAgB,EAAA;AAAA,IACxE,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,GAAG,GAAG,OAAO,IAAI,gBAAgB,OAAA;AAAA,IACtD,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,OAAO,QAAQ,cAAc,GAAG,OAAO,IAAI,gBAAgB,OAAA;AAAA,IACpF,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,GAAG,GAAG,OAAO,IAAI,OAAO,SAAS,OAAA;AAAA,IACtD,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,OAAO,QAAQ,cAAc,GAAG,OAAO,IAAI,OAAO,SAAS,OAAA;AAAA,IACpF,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,eAAe,QAAQ,GAAG,OAAO,EAAA;AAAA,IAC1D,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,eAAe,QAAQ,GAAG,OAAO,IAAI,OAAO,SAAS,cAAA;AAAA,IAC9E,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,OAAO,QAAQ,QAAQ,GAAG,OAAO,EAAA;AAAA,IAC1D,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,IAAI,OAAO,QAAQ,QAAQ,GAAG,OAAO,IAAI,OAAO,SAAS,cAAA;AAAA,IAC9E;AACE,aAAO,EAAE,GAAG,KAAK,eAAe,GAAG,GAAG,OAAO,IAAI,OAAO,SAAS,OAAA;AAAA,EAAO;AAE9E;AA2DO,SAAS,oBAAoB,OAAoD;AACtF,MAAI,UAAU,OAAW,QAAO,CAAA;AAChC,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,KAAK,OAAO,OAAO,OAAO,QAAQ,OAAO,MAAM,MAAA;AAAA,EAC1D;AACA,SAAO;AACT;AAKO,SAAS,sBACd,OAC6B;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,SAAO;AACT;AAKO,SAAS,aAAa,OAG3B;AACA,MAAI,UAAU,OAAW,QAAO,EAAE,YAAY,GAAG,UAAU,EAAA;AAC3D,MAAI,OAAO,UAAU,SAAU,QAAO,EAAE,YAAY,OAAO,UAAU,MAAA;AACrE,SAAO;AAAA,IACL,YAAY,MAAM,cAAc;AAAA,IAChC,UAAU,MAAM,YAAY;AAAA,EAAA;AAEhC;;;;;;"}