@number10/jsx-core 5.0.0

package/dist/host-adapter.d.ts

@@ -0,0 +1,414 @@
+/**
+ * Host Adapter — renderer-neutral interface for VDOM ↔ engine bridge.
+ *
+ * Defines the abstract contracts that every renderer (Phaser, PixiJS, ...)
+ * must implement. The VDOM operates exclusively against these interfaces.
+ *
+ * This file lives alongside the existing host.ts during Phase 1 migration.
+ * Once vdom.ts runs entirely through these interfaces, host.ts becomes the
+ * Phaser-specific implementation of HostAdapter + SurfaceAdapter.
+ *
+ * @migration(audit:scene-portal-mount) Phase 1 — HostAdapter + SurfaceAdapter definieren
+ */
+/** Opaque handle for any renderer-native node (GameObject, DisplayObject, ...) */
+export type HostNode = unknown;
+/** Opaque handle for any renderer-native parent (Scene, Container, Stage, ...) */
+export type HostParent = unknown;
+/** Opaque handle for the renderer-native mount target (Scene, Stage, Canvas, App, ...) */
+export type SurfaceTarget = unknown;
+/** Node type identifier — maps to renderer-specific intrinsic elements */
+export type NodeType = string;
+/** Generic props bag — renderer declares its own typed subsets */
+export type Props = Record<string, unknown>;
+/** Renderer-bound VDOM operations for portable components */
+export interface VDOMOperations {
+    /** Mount a VNode into a parent */
+    mount: (parent: HostParent, vnode: unknown) => HostNode;
+    /** Patch an existing VNode tree */
+    patchVNode: (parent: HostParent, oldV: unknown | null, newV: unknown | null) => void;
+    /** Unmount and cleanup a VNode */
+    unmount: (vnode: unknown | null | undefined | false) => void;
+}
+/** Logical viewport dimensions for a surface */
+export interface SurfaceViewport {
+    readonly width: number;
+    readonly height: number;
+}
+/** Opaque handle for cancelling a scheduled callback or lifecycle listener */
+export type HostCancelHandle = {
+    cancel(): void;
+};
+/**
+ * Scheduler abstraction for frame ticks and timer-based deferred work.
+ *
+ * This deliberately does not model renderer tween systems yet. Tweens are a
+ * higher-level animation capability and can remain renderer-native until the
+ * portable contract is clear.
+ */
+export interface HostScheduler {
+    /**
+     * Schedule a callback for the next frame/animation tick.
+     * Returns a cancel handle.
+     */
+    requestAnimationFrame(callback: (dt: number) => void): HostCancelHandle;
+    /**
+     * Register a persistent per-frame callback.
+     * Returns a cancel handle.
+     * Equivalent to: scene.events.on('update', callback)
+     */
+    onFrame(callback: (dt: number) => void): HostCancelHandle;
+    /**
+     * Schedule a one-shot callback after `delay` milliseconds.
+     * Returns a cancel handle.
+     * Equivalent to: scene.time.addEvent({ delay, callback })
+     */
+    setTimeout(callback: () => void, delay: number): HostCancelHandle;
+    /**
+     * Schedule a repeating callback every `interval` milliseconds.
+     * Returns a cancel handle.
+     * Equivalent to: scene.time.addEvent({ delay: interval, loop: true, callback })
+     */
+    setInterval(callback: () => void, interval: number): HostCancelHandle;
+}
+/**
+ * Portable texture loader — renderer-agnostic asset loading.
+ *
+ * Each renderer provides its own implementation. The useTexture hook
+ * delegates to this interface so components never import renderer code.
+ */
+export interface TextureLoader {
+    /**
+     * Load a texture from a URL and register it under `key`.
+     * Returns a promise that resolves when loading is complete.
+     * If the texture is already loaded, resolves immediately.
+     */
+    load(key: string, url: string): Promise<void>;
+    /**
+     * Load a texture atlas (spritesheet) from image + data URLs.
+     * Registers the atlas under `key` so frames can be referenced
+     * via `<Image texture={key} frame="frameName" />`.
+     */
+    loadAtlas(key: string, imageUrl: string, dataUrl: string): Promise<void>;
+    /**
+     * Render an SVG string to a texture and register it under `key`.
+     * The renderer creates a canvas, draws the SVG, and registers
+     * the resulting bitmap as a texture.
+     */
+    loadSVG(key: string, svg: string, width: number, height: number): Promise<void>;
+    /**
+     * Check whether a texture key is ready for use.
+     */
+    isLoaded(key: string): boolean;
+}
+/**
+ * Pixel rectangle within a texture.
+ * Used by portable components (e.g. NineSlice) to reference sub-regions
+ * of an atlas frame or standalone texture.
+ */
+export interface FrameRect {
+    /** Left offset in pixels (relative to texture or frame origin) */
+    x: number;
+    /** Top offset in pixels */
+    y: number;
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+}
+/**
+ * Logical size (width × height) in pixels.
+ */
+export interface Size {
+    width: number;
+    height: number;
+}
+/**
+ * Portable metadata for a single atlas frame.
+ */
+export interface AtlasFrameInfo {
+    /** Frame name within the atlas */
+    name: string;
+    /** Frame region in atlas pixel coordinates */
+    rect: FrameRect;
+    /** Whether the frame is rotated in atlas packing */
+    rotated: boolean;
+    /** Whether the frame is trimmed in atlas packing */
+    trimmed: boolean;
+    /** Original untrimmed source dimensions, when available */
+    sourceSize?: Size | undefined;
+    /** Placement of the trimmed sprite within the untrimmed source bounds */
+    spriteSourceRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+}
+/**
+ * Extended texture loader with frame/region metadata queries.
+ *
+ * Portable components that need to inspect atlas frame geometry
+ * (e.g. NineSlice slicing) depend on this interface instead of
+ * renderer-specific texture APIs.
+ *
+ * Each renderer provides its own implementation — typically a thin
+ * wrapper around the native texture manager.
+ */
+export interface TextureResolver extends TextureLoader {
+    /**
+     * All available frame names within the atlas identified by `key`.
+     * Returns an empty array if the key has no atlas frames or is not loaded.
+     */
+    getFrameNames(key: string): string[];
+    /**
+     * Pixel region of a named frame within the atlas identified by `key`.
+     * Returns `undefined` if the key or frame is not loaded.
+     */
+    getFrameRect(key: string, frame: string): FrameRect | undefined;
+    /**
+     * Full metadata for a named atlas frame.
+     * Returns `undefined` if the key or frame is not loaded.
+     */
+    getFrameInfo(key: string, frame: string): AtlasFrameInfo | undefined;
+    /**
+     * Total pixel dimensions of the texture registered under `key`.
+     * Returns `undefined` if the key is not loaded.
+     */
+    getTextureSize(key: string): Size | undefined;
+}
+/**
+ * Context for a single renderer surface (scene, stage, root view).
+ * This is the context passed to the VDOM, hooks, layout and host descriptors.
+ */
+export interface SurfaceContext {
+    /** Viewport dimensions for this surface in logical pixels */
+    readonly viewport: SurfaceViewport;
+    /** Scheduler tied to this surface's lifecycle */
+    readonly scheduler: HostScheduler;
+    /** Set of capability flags the renderer supports */
+    readonly capabilities: ReadonlySet<string>;
+    /** Design tokens for this surface (colors, text styles, spacing, sizes, radius) */
+    readonly themeTokens?: Record<string, unknown> | undefined;
+    /** Escape hatch: the underlying renderer-native context (Phaser.Scene, PIXI.Application, ...) */
+    readonly raw?: SurfaceTarget;
+    /**
+     * RootSurface that owns this context.
+     * Enables portable overlays to nest relative to the currently active surface
+     * instead of always falling back to the renderer target.
+     */
+    readonly rootSurface?: RootSurface;
+    /**
+     * SurfaceAdapter for this renderer instance.
+     * Set by the renderer during surface creation. Enables portable hooks
+     * (e.g., usePortalSurface) to create/destroy portal surfaces without
+     * importing renderer-specific code.
+     */
+    readonly adapter?: SurfaceAdapter;
+    /**
+     * Renderer-bound VDOM operations (mount, patchVNode, unmount).
+     * Set by the renderer during surface creation. Enables portable components
+     * (e.g., Portal) to manipulate the VDOM without importing renderer-specific
+     * modules. Each renderer has its own VDOM runtime — this field ensures
+     * the correct one is used even when multiple renderers coexist.
+     */
+    readonly vdom?: VDOMOperations;
+    /** Optional texture loader — enables portable useTexture hook. */
+    readonly textureLoader?: TextureLoader;
+    /**
+     * Optional debug snapshot collector provided by the renderer.
+     * Returns a partial debug snapshot (key → string|number).
+     * The generic {@link useDebugSnapshot} hook delegates to this
+     * function when available. Each renderer wires its own collector
+     * (e.g., Phaser provides FPS/texture count, Pixi provides ticker stats).
+     */
+    readonly debugSnapshotCollector?: (() => Record<string, string | number>) | undefined;
+}
+/**
+ * Compatibility name for operations that conceptually run on host nodes.
+ * SurfaceContext is the single source of truth to avoid two diverging context
+ * shapes during the migration.
+ */
+export type HostContext = SurfaceContext;
+/**
+ * Descriptor for a single node type.
+ * Each renderer registers one descriptor per intrinsic element it supports.
+ */
+export interface HostDescriptor<TProps extends Props = Props, TNode extends HostNode = HostNode> {
+    /** Create a new node instance from props */
+    create(props: TProps, ctx: HostContext): TNode;
+    /** Apply prop changes to an existing node. Called by VDOM diff. */
+    patch(node: TNode, prev: TProps, next: TProps, ctx: HostContext): void;
+    /** Optional: explicit destruction. If not provided, HostAdapter.remove handles cleanup. */
+    destroy?(node: TNode, ctx: HostContext): void;
+}
+/**
+ * Central adapter that the VDOM calls for all node operations.
+ * Each renderer package provides its own implementation.
+ */
+export interface HostAdapter {
+    /**
+     * Create a node of the given type.
+     * Delegates to the registered HostDescriptor for that type.
+     */
+    create(type: NodeType, props: Props, ctx: HostContext): HostNode;
+    /**
+     * Update properties on an existing node.
+     * Delegates to the registered HostDescriptor for that type.
+     */
+    patch(type: NodeType, node: HostNode, prev: Props, next: Props, ctx: HostContext): void;
+    /**
+     * Append a child node to a parent.
+     * The parent may be a root container, a scene, or another node.
+     */
+    append(parent: HostParent, child: HostNode, ctx: HostContext): void;
+    /**
+     * Optional: insert a child before an existing sibling without remounting.
+     * Used by keyed VDOM reconciliation and z/order-sensitive renderers.
+     */
+    insertBefore?(parent: HostParent, child: HostNode, before: HostNode | null, ctx: HostContext): void;
+    /**
+     * Remove a child node from a parent and destroy it.
+     */
+    remove(parent: HostParent, child: HostNode, ctx: HostContext): void;
+    /**
+     * Get children of a parent node.
+     * Used by layout engine and portal sorting.
+     */
+    getChildren(parent: HostParent): readonly HostNode[];
+    /**
+     * Check if a node or parent is still alive (not destroyed, surface not shut down).
+     * Used by MountRegistry and lifecycle checks.
+     */
+    isAlive(target: HostNode | HostParent): boolean;
+    /**
+     * Optional: check if a parent is a top-level surface (scene/stage).
+     * Replaces isPhaserScene() type guards.
+     */
+    isSurface?(target: SurfaceTarget): boolean;
+    /**
+     * Set node position in local coordinate space.
+     * Used by layout engine for child placement.
+     */
+    setPosition?(node: HostNode, x: number, y: number): void;
+    /**
+     * Set node dimensions.
+     * Used by layout engine for child sizing.
+     */
+    setSize?(node: HostNode, width: number, height: number): void;
+    /**
+     * Set node depth/z-order in the display list.
+     */
+    setDepth?(node: HostNode, depth: number): void;
+    /**
+     * Set node visibility.
+     */
+    setVisible?(node: HostNode, visible: boolean): void;
+    /**
+     * Set node alpha/opacity (0 = transparent, 1 = opaque).
+     */
+    setAlpha?(node: HostNode, alpha: number): void;
+    /**
+     * Derive SurfaceContext from a parent or node.
+     * Enables hooks and components to access viewport, scheduler, capabilities.
+     */
+    getSurfaceContext?(target: HostNode | HostParent): SurfaceContext;
+}
+/**
+ * A mounted root — either the main scene root (Portal 0) or a Portal overlay.
+ */
+export interface RootSurface {
+    /** Unique identifier for this root */
+    readonly id: string;
+    /** Semantic kind */
+    readonly kind: 'root' | 'portal';
+    /** Z-order among sibling root surfaces (higher = on top) */
+    readonly zIndex: number;
+    /** Optional parent surface (for portal nesting) */
+    readonly parent?: RootSurface;
+    /** Context for this surface */
+    readonly context: SurfaceContext;
+    /** The renderer-native root container for mounting VDOM children */
+    readonly root: HostParent;
+}
+export type RootSurfaceKind = RootSurface['kind'];
+interface RootSurfaceOptionsBase {
+    /** Unique identifier for this root */
+    readonly id?: string;
+    /** Z-order among sibling root surfaces (higher = on top) */
+    readonly zIndex?: number;
+    /** Initial viewport width for this root */
+    readonly width: number;
+    /** Initial viewport height for this root */
+    readonly height: number;
+}
+export type CreateRootSurfaceOptions = (RootSurfaceOptionsBase & {
+    /** Portal 0 / main mount root */
+    readonly kind?: Extract<RootSurfaceKind, 'root'>;
+    /** Renderer-native target for the root surface */
+    readonly target: SurfaceTarget;
+    readonly parent?: undefined;
+}) | (RootSurfaceOptionsBase & {
+    /** Additional portal root */
+    readonly kind: Extract<RootSurfaceKind, 'portal'>;
+    /** Parent surface that owns the renderer context and z-order group */
+    readonly parent: RootSurface;
+    /**
+     * Optional override target. If omitted, the adapter uses the parent
+     * surface's renderer target.
+     */
+    readonly target?: SurfaceTarget;
+});
+export interface UpdateRootSurfaceOptions {
+    readonly zIndex?: number;
+    readonly width?: number;
+    readonly height?: number;
+}
+/**
+ * Adapter for creating and managing root surfaces.
+ * Each renderer provides its own implementation.
+ */
+export interface SurfaceAdapter {
+    /**
+     * Create a new root surface. For Phaser this wraps scene.add.container().
+     * For the main mount (Portal 0), this creates the implicit root.
+     * For <Portal>, this creates an overlay root container.
+     */
+    createRoot(options: CreateRootSurfaceOptions): RootSurface;
+    /**
+     * Update an existing root surface's properties.
+     */
+    updateRoot(surface: RootSurface, options: UpdateRootSurfaceOptions): void;
+    /**
+     * Destroy a root surface and all its children.
+     */
+    destroyRoot(surface: RootSurface): void;
+    /**
+     * Optional: re-sort root surfaces by zIndex.
+     * Called when portal z-order changes.
+     */
+    sortRoots?(roots: readonly RootSurface[]): void;
+    /**
+     * Optional: check if a root surface is still backed by a live renderer target.
+     */
+    isAlive?(surface: RootSurface): boolean;
+    /**
+     * Optional: callback when the surface's lifecycle ends (scene shutdown, stage destroy).
+     * The Core calls this to clean up MountRegistry entries.
+     */
+    onDestroy?(surface: RootSurface, callback: () => void): HostCancelHandle;
+    /**
+     * Optional: find a root surface by its renderer-native target.
+     * Used by Portal to locate the parent RootSurface for a given scene/stage.
+     *
+     * @migration(audit:scene-portal-mount) Phase 6B — enables Portal → SurfaceAdapter migration.
+     */
+    getRootByTarget?(target: SurfaceTarget): RootSurface | undefined;
+    /**
+     * Optional: synchronize event blocking for a portal surface.
+     * Implementations should register or unregister the portal root as a
+     * transparent blocker and refresh its hit area from the rendered content.
+     */
+    syncPortalEventBlocking?(surface: RootSurface, blockEvents: boolean): void;
+}
+export {};
+//# sourceMappingURL=host-adapter.d.ts.map

package/dist/host-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-adapter.d.ts","sourceRoot":"","sources":["../src/host-adapter.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxDevRuntime = require("./jsx-dev-runtime.cjs");
+const jsxRuntime = require("./jsx-runtime.cjs");
+const memo = require("./memo.cjs");
+const devConfig = require("./dev-config.cjs");
+const coreProps = require("./core-props.cjs");
+const borderGeometry = require("./border-geometry.cjs");
+const placeholder = require("./placeholder.cjs");
+const portal = require("./portal.cjs");
+const layoutEngine = require("./layout/layout-engine.cjs");
+const childUtils = require("./layout/utils/child-utils.cjs");
+const dimensionCalculator = require("./layout/utils/dimension-calculator.cjs");
+const flexDistributor = require("./layout/utils/flex-distributor.cjs");
+const sizeResolver = require("./layout/utils/size-resolver.cjs");
+const spacingCalculator = require("./layout/utils/spacing-calculator.cjs");
+const baseStrategy = require("./layout/strategies/base-strategy.cjs");
+const columnLayout = require("./layout/strategies/column-layout.cjs");
+const rowLayout = require("./layout/strategies/row-layout.cjs");
+const stackLayout = require("./layout/strategies/stack-layout.cjs");
+const colorTypes = require("./colors/color-types.cjs");
+const colorUtils = require("./colors/color-utils.cjs");
+const contrastContracts = require("./colors/contrast-contracts.cjs");
+const colorPresets = require("./colors/color-presets.cjs");
+const colorThemeHelpers = require("./colors/color-theme-helpers.cjs");
+const designTokenPresets = require("./design-tokens/design-token-presets.cjs");
+const theme = require("./theme.cjs");
+const effects = require("./effects.cjs");
+const hooks = require("./hooks.cjs");
+const effectEngine = require("./animation/effect-engine.cjs");
+const animatedSignal = require("./animation/animated-signal.cjs");
+const createSpring = require("./animation/create-spring.cjs");
+const easing = require("./animation/easing.cjs");
+const effectDefinitions = require("./animation/effect-definitions.cjs");
+const springPhysics = require("./animation/spring-physics.cjs");
+const tween = require("./animation/tween.cjs");
+const useSpring = require("./animation/useSpring.cjs");
+const useTween = require("./animation/useTween.cjs");
+const primitiveContracts = require("./primitive-contracts.cjs");
+const createRuntime = require("./vdom/create-runtime.cjs");
+const utils = require("./vdom/utils.cjs");
+const ninesliceContract = require("./nineslice-contract.cjs");
+const signalsCore = require("@preact/signals-core");
+exports.jsxDEV = jsxDevRuntime.jsxDEV;
+exports.Fragment = jsxRuntime.Fragment;
+exports.jsx = jsxRuntime.jsx;
+exports.jsxs = jsxRuntime.jsxs;
+exports.memo = memo.memo;
+exports.noMemo = memo.noMemo;
+exports.DebugLogger = devConfig.DebugLogger;
+exports.DevConfig = devConfig.DevConfig;
+exports.DevPresets = devConfig.DevPresets;
+exports.clampToViewport = coreProps.clampToViewport;
+exports.getOverlayPosition = coreProps.getOverlayPosition;
+exports.normalizeCornerRadius = coreProps.normalizeCornerRadius;
+exports.normalizeEdgeInsets = coreProps.normalizeEdgeInsets;
+exports.normalizeGap = coreProps.normalizeGap;
+exports.drawBorderGeometry = borderGeometry.drawBorderGeometry;
+exports.hasAnyCornerRadius = borderGeometry.hasAnyCornerRadius;
+exports.isUniformBorder = borderGeometry.isUniformBorder;
+exports.resolveBorderSides = borderGeometry.resolveBorderSides;
+exports.resolveCornerRadii = borderGeometry.resolveCornerRadii;
+exports.shouldUseCoreBorderGeometry = borderGeometry.shouldUseCoreBorderGeometry;
+exports.logNotYetImplemented = placeholder.logNotYetImplemented;
+exports.usePortalSurface = portal.usePortalSurface;
+exports.DeferredLayoutQueue = layoutEngine.DeferredLayoutQueue;
+exports.LayoutBatchQueue = layoutEngine.LayoutBatchQueue;
+exports.calculateLayout = layoutEngine.calculateLayout;
+exports.registerApplyOverflowClip = layoutEngine.registerApplyOverflowClip;
+exports.setAfterLayout = layoutEngine.setAfterLayout;
+exports.setApplyOverflowClip = layoutEngine.setApplyOverflowClip;
+exports.getChildSize = childUtils.getChildSize;
+exports.getMargin = childUtils.getMargin;
+exports.isLayoutChild = childUtils.isLayoutChild;
+exports.processNestedContainer = childUtils.processNestedContainer;
+exports.calculateContainerSize = dimensionCalculator.calculateContainerSize;
+exports.calculateContentDimensions = dimensionCalculator.calculateContentDimensions;
+exports.normalizePadding = dimensionCalculator.normalizePadding;
+exports.distributeFlexSpace = flexDistributor.distributeFlexSpace;
+exports.hasFlexChildren = flexDistributor.hasFlexChildren;
+exports.clampSize = sizeResolver.clampSize;
+exports.clearSizeCaches = sizeResolver.clearSizeCaches;
+exports.isExplicit = sizeResolver.isExplicit;
+exports.parseSize = sizeResolver.parseSize;
+exports.requiresParent = sizeResolver.requiresParent;
+exports.resolveSize = sizeResolver.resolveSize;
+exports.calculateAlignItems = spacingCalculator.calculateAlignItems;
+exports.calculateJustifyContent = spacingCalculator.calculateJustifyContent;
+exports.BaseLayoutStrategy = baseStrategy.BaseLayoutStrategy;
+exports.ColumnLayoutStrategy = columnLayout.ColumnLayoutStrategy;
+exports.RowLayoutStrategy = rowLayout.RowLayoutStrategy;
+exports.StackLayoutStrategy = stackLayout.StackLayoutStrategy;
+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;
+exports.createDesignTokens = designTokenPresets.createDesignTokens;
+exports.createTextStyleTokens = designTokenPresets.createTextStyleTokens;
+exports.defaultRadiusTokens = designTokenPresets.defaultRadiusTokens;
+exports.defaultSizeTokens = designTokenPresets.defaultSizeTokens;
+exports.defaultSpacingTokens = designTokenPresets.defaultSpacingTokens;
+exports.defaultTextStyleTokens = designTokenPresets.defaultTextStyleTokens;
+exports.KNOWN_COMPONENTS = theme.KNOWN_COMPONENTS;
+exports.createDefaultTheme = theme.createDefaultTheme;
+exports.createTheme = theme.createTheme;
+exports.deepMergeDefined = theme.deepMergeDefined;
+exports.defaultTheme = theme.defaultTheme;
+exports.extractNestedThemes = theme.extractNestedThemes;
+exports.getAvailablePresets = theme.getAvailablePresets;
+exports.getCurrentPreset = theme.getCurrentPreset;
+exports.getGlobalThemeDefaults = theme.getGlobalThemeDefaults;
+exports.getThemedProps = theme.getThemedProps;
+exports.mergeThemes = theme.mergeThemes;
+exports.normalizeThemeComponentName = theme.normalizeThemeComponentName;
+exports.registerComponentDefaults = theme.registerComponentDefaults;
+exports.registerComponentDefaultsIfMissing = theme.registerComponentDefaultsIfMissing;
+exports.registerComponentThemeDefaults = theme.registerComponentThemeDefaults;
+exports.resolveComponentTheme = theme.resolveComponentTheme;
+exports.setColorMode = theme.setColorMode;
+exports.setColorPreset = theme.setColorPreset;
+exports.setThemeRemountHandler = theme.setThemeRemountHandler;
+exports.themeRegistry = theme.themeRegistry;
+exports.DEFAULT_EFFECT = effects.DEFAULT_EFFECT;
+exports.applyEffect = effects.applyEffect;
+exports.applyEffectByName = effects.applyEffectByName;
+exports.registerEffect = effects.registerEffect;
+exports.registerEffectRunner = effects.registerEffectRunner;
+exports.registerEffectStopRunner = effects.registerEffectStopRunner;
+exports.resolveEffect = effects.resolveEffect;
+exports.resolveEffectTransformOrigin = effects.resolveEffectTransformOrigin;
+exports.stopEffect = effects.stopEffect;
+exports.depsChanged = hooks.depsChanged;
+exports.disposeCtx = hooks.disposeCtx;
+exports.getCurrentCtx = hooks.getCurrentCtx;
+exports.getCurrentOrThrow = hooks.getCurrentOrThrow;
+exports.setCurrentCtx = hooks.setCurrentCtx;
+exports.setUpdateHandler = hooks.setUpdateHandler;
+exports.shallowEqual = hooks.shallowEqual;
+exports.shouldComponentUpdate = hooks.shouldComponentUpdate;
+exports.useAtlas = hooks.useAtlas;
+exports.useCallback = hooks.useCallback;
+exports.useDebugSnapshot = hooks.useDebugSnapshot;
+exports.useEffect = hooks.useEffect;
+exports.useForceRedraw = hooks.useForceRedraw;
+exports.useLayoutEffect = hooks.useLayoutEffect;
+exports.useMemo = hooks.useMemo;
+exports.useRedraw = hooks.useRedraw;
+exports.useRef = hooks.useRef;
+exports.useSVGTexture = hooks.useSVGTexture;
+exports.useState = hooks.useState;
+exports.useSurface = hooks.useSurface;
+exports.useTexture = hooks.useTexture;
+exports.useTheme = hooks.useTheme;
+exports.useThemeTokens = hooks.useThemeTokens;
+exports.useViewportSize = hooks.useViewportSize;
+exports.withHooks = hooks.withHooks;
+exports.runEffect = effectEngine.runEffect;
+exports.stopAnimationEffect = effectEngine.stopEffect;
+exports.animatedSignal = animatedSignal.animatedSignal;
+exports.isAnimatedSignal = animatedSignal.isAnimatedSignal;
+exports.unwrapSignal = animatedSignal.unwrapSignal;
+exports.createSpring = createSpring.createSpring;
+exports.Easing = easing.Easing;
+exports.EFFECT_DEFINITIONS = effectDefinitions.EFFECT_DEFINITIONS;
+exports.DEFAULT_SPRING_CONFIG = springPhysics.DEFAULT_SPRING_CONFIG;
+exports.SPRING_PRESETS = springPhysics.SPRING_PRESETS;
+exports.SpringPhysics = springPhysics.SpringPhysics;
+exports.createTween = tween.createTween;
+exports.useSpring = useSpring.useSpring;
+exports.useSprings = useSpring.useSprings;
+exports.TWEEN_PRESETS = useTween.TWEEN_PRESETS;
+exports.useTween = useTween.useTween;
+exports.useTweens = useTween.useTweens;
+exports.PRIMITIVE_NODES = primitiveContracts.PRIMITIVE_NODES;
+exports.createVDOMRuntime = createRuntime.createVDOMRuntime;
+exports.createElement = utils.createElement;
+exports.normalizeVNodeLike = utils.normalizeVNodeLike;
+exports.computeSourceSlices = ninesliceContract.computeSourceSlices;
+exports.computeTargetXs = ninesliceContract.computeTargetXs;
+exports.computeTargetYs = ninesliceContract.computeTargetYs;
+exports.deriveTargetRects = ninesliceContract.deriveTargetRects;
+Object.defineProperty(exports, "computed", {
+  enumerable: true,
+  get: () => signalsCore.computed
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

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