@jamesyong42/infinite-canvas 1.2.0 → 1.3.0

package/dist/engine-CCjuFMC-.d.cts

@@ -1,982 +0,0 @@
-import * as _$_jamesyong42_reactive_ecs0 from "@jamesyong42/reactive-ecs";
-import { ComponentInit, ComponentType, EntityId, SystemDef, TagType, Unsubscribe, World } from "@jamesyong42/reactive-ecs";
-
-//#region src/archetype.d.ts
-/**
- * An archetype is a recipe for creating an entity: it declares which components
- * and tags the entity should have on spawn. Archetypes may reference a widget
- * type (for visible entities) or stand alone (for logic-only entities).
- *
- * The engine auto-generates a default archetype for every registered widget
- * that does not have an explicit one — so simple widgets don't need to ship
- * an archetype at all. Write an archetype only when you need to bundle extra
- * behaviour (Container, Locked, custom components) with a widget.
- */
-interface Archetype {
-  /** Unique archetype id. Pass this to `engine.spawn(id, ...)`. */
-  id: string;
-  /**
-   * The widget type this archetype renders as. Required for visible entities;
-   * omit for logic-only entities that have no view.
-   */
-  widget?: string;
-  /** Extra components added on spawn, beyond Transform2D / Widget / WidgetData / ZIndex. */
-  components?: ComponentInit[];
-  /** Extra tags added on spawn, beyond the interactive defaults. */
-  tags?: TagType[];
-  /**
-   * Which interaction capabilities to grant on spawn.
-   *
-   * - `true` (default) / `undefined`: add Selectable, Draggable, Resizable,
-   *   and the SelectionFrame (engine-drawn outline).
-   * - `false`: add none (backdrops, decorations, locked entities).
-   * - object form: pick and choose — e.g. iOS-style cards use
-   *   `{ selectable: true, draggable: true, resizable: false, selectionFrame: false }`
-   *   so they can be moved and selected but never resized, and they render
-   *   their own chrome instead of the engine-drawn frame.
-   *
-   * Omitted interaction keys default to `false`. `selectionFrame` is an
-   * exception: if omitted, it follows `selectable` (an entity you can
-   * select gets a frame unless you explicitly opt out).
-   */
-  interactive?: boolean | {
-    selectable?: boolean;
-    draggable?: boolean;
-    resizable?: boolean;
-    selectionFrame?: boolean;
-  };
-  /** Overrides the widget's defaultSize. */
-  defaultSize?: {
-    width: number;
-    height: number;
-  };
-}
-/**
- * Options for `engine.spawn(archetypeId, opts)`.
- * All fields are optional — defaults come from the archetype + widget.
- */
-interface SpawnOptions {
-  /** World-space position. Defaults to { x: 0, y: 0 }. */
-  at?: {
-    x: number;
-    y: number;
-  };
-  /** World-space size. Falls back to archetype.defaultSize → widget.defaultSize. */
-  size?: {
-    width: number;
-    height: number;
-  };
-  /** Initial rotation in radians. Default 0. */
-  rotation?: number;
-  /** Data patch merged into the widget's defaultData. */
-  data?: Record<string, unknown>;
-  /** Z-order. Default 0. */
-  zIndex?: number;
-  /** Parent entity for hierarchy nesting. */
-  parent?: EntityId;
-}
-/** Simple in-memory archetype registry. */
-interface ArchetypeRegistry {
-  register(archetype: Archetype): void;
-  get(id: string): Archetype | null;
-  getAll(): Archetype[];
-}
-declare function createArchetypeRegistry(archetypes?: Archetype[]): ArchetypeRegistry;
-//#endregion
-//#region src/commands.d.ts
-interface Command {
-  execute(world: World): void;
-  undo(world: World): void;
-}
-declare class CommandBuffer {
-  private undoStack;
-  private redoStack;
-  private currentGroup;
-  /** Start grouping commands (e.g., on pointerdown). All commands until endGroup() are one undo step. */
-  beginGroup(): void;
-  /** Execute a command and record it for undo. */
-  execute(command: Command, world: World): void;
-  /** Close the current group — all commands since beginGroup() become one undo step. */
-  endGroup(): void;
-  /** Undo the last command group. */
-  undo(world: World): boolean;
-  /** Redo the last undone command group. */
-  redo(world: World): boolean;
-  canUndo(): boolean;
-  canRedo(): boolean;
-  clear(): void;
-  get undoSize(): number;
-  get redoSize(): number;
-}
-declare class MoveCommand implements Command {
-  private entityIds;
-  private dx;
-  private dy;
-  private transformType;
-  private beforePositions;
-  private afterPositions;
-  private captured;
-  constructor(entityIds: EntityId[], dx: number, dy: number, transformType: ComponentType<{
-    x: number;
-    y: number;
-  }>);
-  execute(world: World): void;
-  undo(world: World): void;
-}
-declare class ResizeCommand implements Command {
-  private entityId;
-  private before;
-  private after;
-  private transformType;
-  constructor(entityId: EntityId, before: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  }, after: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  }, transformType: ComponentType<{
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  }>);
-  execute(world: World): void;
-  undo(world: World): void;
-}
-declare class SetComponentCommand<T> implements Command {
-  private entityId;
-  private type;
-  private before;
-  private after;
-  constructor(entityId: EntityId, type: ComponentType<T>, before: Partial<T>, after: Partial<T>);
-  execute(world: World): void;
-  undo(world: World): void;
-}
-//#endregion
-//#region src/components.d.ts
-/** Position, size, and rotation of an entity in local coordinates (world units). */
-declare const Transform2D: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-  rotation: number;
-}>;
-/** Computed world-space bounding box. Read-only -- updated by the transform propagation system. */
-declare const WorldBounds: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  worldX: number;
-  worldY: number;
-  worldWidth: number;
-  worldHeight: number;
-}>;
-/** Rendering and hit-test ordering. Higher values render on top. */
-declare const ZIndex: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  value: number;
-}>;
-/** Parent entity reference. Used for nested containers and handle sync. */
-declare const Parent: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  id: EntityId;
-}>;
-/** Child entity IDs. Used for nested containers and handle sync. */
-declare const Children: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  ids: EntityId[];
-}>;
-/** Marks an entity as a renderable widget with a type identifier and rendering surface. */
-declare const Widget$1: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  surface: "dom" | "webgl" | "webview";
-  type: string;
-}>;
-/** Arbitrary application data attached to a widget entity. Access via useWidgetData(). */
-declare const WidgetData: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  data: Record<string, unknown>;
-}>;
-/** Computed responsive breakpoint based on screen-space size. Read-only. */
-declare const WidgetBreakpoint: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  current: "micro" | "compact" | "normal" | "expanded" | "detailed";
-  screenWidth: number;
-  screenHeight: number;
-}>;
-/** iOS-style card size presets. Actual dimensions live in CardPresetsResource. */
-type CardPreset = 'small' | 'medium' | 'large' | 'xl';
-/**
- * Marks an entity as an iOS-style card with a fixed preset size.
- * The `cardSystem` reconciles `Transform2D.width/height` from the preset
- * each tick, so cards cannot be resized freely — change `preset` instead.
- */
-declare const Card: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  preset: CardPreset;
-}>;
-/** Marks an entity as an enterable container (double-click/double-tap to enter). */
-declare const Container: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  enterable: boolean;
-}>;
-/** Resize handle positions — 4 edges + 4 corners. */
-type ResizeHandlePos = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
-/**
- * Rectangular interactable region anchored relative to the parent entity's WorldBounds.
- * Anchor values are in 0..1 space: 0 = parent min edge, 1 = parent max edge.
- * Widget bodies do NOT need Hitbox — their WorldBounds is already their hit area.
- * Hitbox is only for sub-entities (handles, ports) whose position is parent-relative.
- */
-declare const Hitbox: _$_jamesyong42_reactive_ecs0.ComponentType<{
-  anchorX: number;
-  anchorY: number;
-  width: number;
-  height: number;
-}>;
-/** Discriminated union of interaction roles an entity can fulfil. */
-type InteractionRoleType = {
-  type: 'drag';
-} | {
-  type: 'select';
-} | {
-  type: 'resize';
-  handle: ResizeHandlePos;
-} | {
-  type: 'rotate';
-} | {
-  type: 'connect';
-} | {
-  type: 'canvas';
-};
-type InteractionRoleData = {
-  /** Hit-test priority — higher wins when multiple entities contain the point. */layer: number; /** Discriminated role + role-specific data. */
-  role: InteractionRoleType;
-};
-/**
- * Declares what happens when this entity is hit, plus its hit-test priority.
- * Canonical layers: 0=canvas, 5=widget body, 10=edge handles, 15=corner handles, 20=reserved.
- */
-declare const InteractionRole: _$_jamesyong42_reactive_ecs0.ComponentType<InteractionRoleData>;
-/** Data shape for the HandleSet component. */
-type HandleSetData = {
-  ids: EntityId[];
-};
-/**
- * Component on the parent entity listing the EntityIds of its spawned handle children.
- * Enables O(1) cascade destroy without a reverse-index scan of Parent components.
- */
-declare const HandleSet: _$_jamesyong42_reactive_ecs0.ComponentType<HandleSetData>;
-/** CSS cursor values the canvas may request. */
-type CSSCursor = 'default' | 'grab' | 'grabbing' | 'crosshair' | 'n-resize' | 's-resize' | 'e-resize' | 'w-resize' | 'ne-resize' | 'nw-resize' | 'se-resize' | 'sw-resize';
-type CursorHintData = {
-  /** Cursor when this entity is hovered in idle state. */hover: CSSCursor; /** Cursor while this entity is being dragged/resized. */
-  active: CSSCursor;
-};
-/** Declares the cursor this entity requests when hovered and when active. */
-declare const CursorHint: _$_jamesyong42_reactive_ecs0.ComponentType<CursorHintData>;
-/** Marks an entity as selectable by click or marquee. */
-declare const Selectable: _$_jamesyong42_reactive_ecs0.TagType;
-/** Marks an entity as draggable via pointer interaction. */
-declare const Draggable: _$_jamesyong42_reactive_ecs0.TagType;
-/** Marks an entity as resizable via edge/corner handles. */
-declare const Resizable: _$_jamesyong42_reactive_ecs0.TagType;
-/** Prevents an entity from being moved or resized. */
-declare const Locked: _$_jamesyong42_reactive_ecs0.TagType;
-/** Indicates the entity is currently selected. */
-declare const Selected: _$_jamesyong42_reactive_ecs0.TagType;
-/**
- * Indicates the entity is currently being dragged by the user.
- * Added after the drag dead-zone is crossed; removed on pointer up/cancel.
- * Renderers read this to apply transient drag affordances (e.g. scale/shadow lift).
- */
-declare const Dragging: _$_jamesyong42_reactive_ecs0.TagType;
-/**
- * Entities with this tag get the engine-drawn selection + hover outline frame.
- * Granted automatically to Selectable entities unless explicitly disabled via
- * `Archetype.interactive.selectionFrame: false`. Widgets that render their own
- * selected/hover chrome (e.g. iOS-style cards) opt out.
- */
-declare const SelectionFrame: _$_jamesyong42_reactive_ecs0.TagType;
-/** Indicates the entity is currently being interacted with (drag, resize). */
-declare const Active: _$_jamesyong42_reactive_ecs0.TagType;
-/** Indicates the entity is within the visible viewport. Set by the cull system. */
-declare const Visible: _$_jamesyong42_reactive_ecs0.TagType;
-//#endregion
-//#region src/profiler.d.ts
-/**
- * Multi-layer performance profiler.
- *
- * Tracks three independent rendering concerns:
- *
- *   1. ECS tick — systems, visibility, entity counts. Driven by `engine.tick()`.
- *   2. WebGL engine pass — the library's grid + selection renderers. Runs
- *      inside the rAF loop immediately after each ECS tick, so samples share
- *      the ECS ring and carry matched tick ids.
- *   3. R3F canvas — the user's 3D widgets inside the shared `<Canvas>`. Runs
- *      continuously at rAF cadence regardless of engine ticks, so it has its
- *      own ring.
- *
- * All methods are no-ops when disabled — zero cost for production builds.
- * User Timing API marks are emitted when enabled so traces line up with
- * Chrome DevTools' Performance panel.
- */
-interface TickSample {
-  tick: number;
-  timestamp: number;
-  /** Total tick duration (ms) = ECS tick + WebGL engine pass. */
-  totalMs: number;
-  ecs: {
-    /** Per-system durations (ms). */systems: Record<string, number>; /** Visible entity computation (ms). */
-    visibilityMs: number; /** Entity counts at this frame. */
-    entityCount: number;
-    visibleCount: number;
-  };
-  webgl: {
-    /** Grid renderer pass duration (ms). */gridMs: number; /** Selection + hover + snap-guide render pass duration (ms). */
-    selectionMs: number; /** Total `renderer.info.render.calls` across all passes this tick. */
-    drawCalls: number; /** Total `renderer.info.render.triangles` across all passes this tick. */
-    triangles: number; /** Selection frames drawn this tick. */
-    selectionFrames: number; /** Snap guides drawn this tick. */
-    snapGuides: number; /** Equal-spacing indicators drawn this tick. */
-    spacingIndicators: number; /** DOM slot.transform writes this tick (from changes.positionsChanged). */
-    domPositionsUpdated: number;
-  };
-}
-interface R3FSample {
-  timestamp: number;
-  /** Delta since the previous R3F frame (ms). */
-  dtMs: number;
-  /** three.js renderer.info snapshot. */
-  drawCalls: number;
-  triangles: number;
-  points: number;
-  lines: number;
-  programs: number;
-  geometries: number;
-  textures: number;
-  activeWidgets: number;
-}
-interface FrameTimeStats {
-  avg: number;
-  p50: number;
-  p95: number;
-  p99: number;
-  max: number;
-}
-interface EcsStats {
-  fps: number;
-  frameTime: FrameTimeStats;
-  systemAvg: Record<string, number>;
-  systemP95: Record<string, number>;
-  /** Avg frame time as % of 16.67ms (60 fps). */
-  budgetUsed: number;
-  sampleCount: number;
-}
-interface WebGLStats {
-  /** Tick cadence — matches ECS since both fire together. */
-  fps: number;
-  /** Avg combined pass time (ms) and percentile breakdown. */
-  frameTime: FrameTimeStats;
-  /** Avg combined pass time as % of 16.67ms budget. */
-  budgetUsed: number;
-  gridAvg: number;
-  gridP95: number;
-  selectionAvg: number;
-  selectionP95: number;
-  avgDrawCalls: number;
-  avgTriangles: number;
-  avgSelectionFrames: number;
-  avgSnapGuides: number;
-  avgDomUpdates: number;
-  sampleCount: number;
-}
-interface R3FStats {
-  fps: number;
-  frameTime: FrameTimeStats;
-  avgDrawCalls: number;
-  avgTriangles: number;
-  /** Latest snapshots — these don't average meaningfully. */
-  programs: number;
-  geometries: number;
-  textures: number;
-  activeWidgets: number;
-  sampleCount: number;
-}
-interface ProfilerStats {
-  ecs: EcsStats;
-  webgl: WebGLStats;
-  r3f: R3FStats;
-}
-/** What's being timed inside the library's WebGL engine pass. */
-type WebGLPass = 'grid' | 'selection';
-declare class Profiler {
-  private enabled;
-  private tickRing;
-  private tickWrite;
-  private tickFilled;
-  private r3fRing;
-  private r3fWrite;
-  private r3fFilled;
-  private frameStart;
-  private currentSystems;
-  private visibilityMs;
-  private webglGridMs;
-  private webglSelectionMs;
-  private webglDrawCalls;
-  private webglTriangles;
-  private webglSelectionFrames;
-  private webglSnapGuides;
-  private webglSpacingIndicators;
-  private webglDomPositionsUpdated;
-  private currentTick;
-  /** Enable/disable profiling. When disabled, all methods are no-ops. */
-  setEnabled(on: boolean): void;
-  isEnabled(): boolean;
-  /** Call at the start of engine.tick(). */
-  beginFrame(tick: number): void;
-  /** Call around each ECS system execution. */
-  beginSystem(name: string): void;
-  endSystem(name: string): void;
-  beginVisibility(): void;
-  endVisibility(): void;
-  /** Call right before the named engine WebGL pass renders. */
-  beginWebGL(pass: WebGLPass): void;
-  /** Call right after the named engine WebGL pass renders. */
-  endWebGL(pass: WebGLPass): void;
-  /**
-   * Record WebGL engine pass counters for the current tick. `drawCalls` and
-   * `triangles` should be the totals from `renderer.info.render` accumulated
-   * across all engine passes in this tick (grid + selection). Callers must
-   * reset `renderer.info` at the start of the tick (with `autoReset=false`)
-   * so these values cover both passes.
-   */
-  recordWebGLStats(stats: {
-    drawCalls: number;
-    triangles: number;
-    selectionFrames: number;
-    snapGuides: number;
-    spacingIndicators: number;
-    domPositionsUpdated: number;
-  }): void;
-  /** Call at the end of engine.tick() — flushes a TickSample to the ring. */
-  endFrame(entityCount: number, visibleCount: number): void;
-  /**
-   * Push one R3F frame sample. Called from the R3F canvas via a probe
-   * component that has access to `useThree`.
-   */
-  recordR3FFrame(sample: Omit<R3FSample, 'timestamp'>): void;
-  /** Get the last N tick samples (newest first). */
-  getSamples(count?: number): TickSample[];
-  /** Get the last N R3F samples (newest first). */
-  getR3FSamples(count?: number): R3FSample[];
-  /** Compute rolling statistics across all three layers. */
-  getStats(): ProfilerStats;
-  private getEcsStats;
-  private getWebGLStats;
-  private getR3FStats;
-  /** Clear all collected data. */
-  clear(): void;
-}
-//#endregion
-//#region src/schema.d.ts
-/**
- * Minimal Standard Schema v1 type definition.
- *
- * Compatible with Zod 3.24+, Valibot, ArkType, and any other library that
- * implements the spec at https://standardschema.dev. We do not depend on any
- * validator — users bring their own.
- *
- * Today we only carry the type parameter for `T`. Runtime validation via
- * `validate()` is wired in by features that need it (inspector, serialization).
- */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-  readonly '~standard': StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-  interface Props<Input = unknown, Output = Input> {
-    readonly version: 1;
-    readonly vendor: string;
-    readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
-    readonly types?: Types<Input, Output>;
-  }
-  type Result<Output> = SuccessResult<Output> | FailureResult;
-  interface SuccessResult<Output> {
-    readonly value: Output;
-    readonly issues?: undefined;
-  }
-  interface FailureResult {
-    readonly issues: ReadonlyArray<Issue>;
-  }
-  interface Issue {
-    readonly message: string;
-    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
-  }
-  interface PathSegment {
-    readonly key: PropertyKey;
-  }
-  interface Types<Input = unknown, Output = Input> {
-    readonly input: Input;
-    readonly output: Output;
-  }
-  type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
-}
-//#endregion
-//#region src/react/registry.d.ts
-/** Rendering surface for a widget. */
-type WidgetSurface = 'dom' | 'webgl';
-/** Props passed to every DOM widget component. */
-interface DomWidgetProps {
-  entityId: EntityId;
-}
-/** Props passed to every R3F widget component. Rendered in local coords. */
-interface R3FWidgetProps {
-  entityId: EntityId;
-  /** Widget width in world units. */
-  width: number;
-  /** Widget height in world units. */
-  height: number;
-}
-interface WidgetBase<T> {
-  /** Unique widget type id. Matches `Widget { type }` on spawned entities. */
-  type: string;
-  /**
-   * Standard Schema v1-compatible schema for the widget's data.
-   * Use Zod 3.24+, Valibot, ArkType, or any other conforming validator.
-   * The schema's output type drives the widget's data type.
-   */
-  schema: StandardSchemaV1<any, T>;
-  /** Default data shape for new instances. Merged with user-supplied data at spawn. */
-  defaultData: T;
-  /** Default world-space size at spawn. */
-  defaultSize: {
-    width: number;
-    height: number;
-  };
-  /** Minimum world-space size when resizing. */
-  minSize?: {
-    width: number;
-    height: number;
-  };
-}
-/** A DOM-rendered widget. The component is wrapped in a sized div — size via CSS. */
-interface DomWidget<T = Record<string, unknown>> extends WidgetBase<T> {
-  surface?: 'dom';
-  component: React.ComponentType<DomWidgetProps>;
-}
-/** An R3F (React Three Fiber) widget. The component receives local-space width/height. */
-interface R3FWidget<T = Record<string, unknown>> extends WidgetBase<T> {
-  surface: 'webgl';
-  component: React.ComponentType<R3FWidgetProps>;
-}
-/** Either kind of widget. */
-type Widget<T = Record<string, unknown>> = DomWidget<T> | R3FWidget<T>;
-interface WidgetRegistry {
-  register(def: Widget): void;
-  get(type: string): Widget | null;
-  getAll(): Widget[];
-}
-declare function createWidgetRegistry(defs?: Widget[]): WidgetRegistry;
-/** Narrows to the R3F variant. */
-declare function isR3FWidget<T>(widget: Widget<T>): widget is R3FWidget<T>;
-//#endregion
-//#region src/resources.d.ts
-/** A single frame in the navigation stack, capturing the container and camera state. */
-interface NavigationFrame {
-  containerId: EntityId | null;
-  camera: {
-    x: number;
-    y: number;
-    zoom: number;
-  };
-}
-/** Data shape for the CursorResource. */
-type CursorResourceData = {
-  cursor: CSSCursor;
-};
-/**
- * Output sink for the cursor system. Written by cursorSystem each tick;
- * read by the RAF loop to apply style.cursor on the root container div.
- */
-declare const CursorResource: _$_jamesyong42_reactive_ecs0.ResourceType<CursorResourceData>;
-/** Camera state: world-space position (x, y) and zoom level. Updated by pan/zoom gestures. */
-declare const CameraResource: _$_jamesyong42_reactive_ecs0.ResourceType<{
-  x: number;
-  y: number;
-  zoom: number;
-}>;
-/** Viewport dimensions in CSS pixels and device pixel ratio. Updated on resize. */
-declare const ViewportResource: _$_jamesyong42_reactive_ecs0.ResourceType<{
-  width: number;
-  height: number;
-  dpr: number;
-}>;
-/** Minimum and maximum zoom levels. */
-declare const ZoomConfigResource: _$_jamesyong42_reactive_ecs0.ResourceType<{
-  min: number;
-  max: number;
-}>;
-/** Screen-space pixel thresholds for responsive breakpoints (micro/compact/normal/expanded/detailed). */
-declare const BreakpointConfigResource: _$_jamesyong42_reactive_ecs0.ResourceType<{
-  micro: number;
-  compact: number;
-  normal: number;
-  expanded: number;
-}>;
-/** Navigation stack for hierarchical container traversal. */
-declare const NavigationStackResource: _$_jamesyong42_reactive_ecs0.ResourceType<{
-  frames: NavigationFrame[];
-  changed: boolean;
-}>;
-/** Responsive breakpoint name derived from a widget's screen-space size. */
-type Breakpoint = 'micro' | 'compact' | 'normal' | 'expanded' | 'detailed';
-/**
- * iOS-style card preset size map. Lookup happens by `Card.preset`; the
- * `cardSystem` stamps `Transform2D.width/height` from the resolved size.
- *
- * Defaults mirror iOS widget conventions — 155×155 tile + 19px gap.
- * Override at `createLayoutEngine({ cardPresets })` for tablet-scale or
- * custom design systems.
- */
-declare const CardPresetsResource: _$_jamesyong42_reactive_ecs0.ResourceType<{
-  presets: Record<CardPreset, {
-    width: number;
-    height: number;
-  }>; /** Gap between adjacent tiles (future tile-snap system reads this). */
-  gap: number;
-}>;
-//#endregion
-//#region src/snap.d.ts
-/**
- * Snap guide computation for alignment during drag operations.
- * Implements Figma-style snapping:
- * 1. Edge/center alignment guides
- * 2. Equal spacing snap + indicators
- */
-interface SnapGuide {
-  /** Axis this guide aligns on */
-  axis: 'x' | 'y';
-  /** World-space coordinate of the alignment line */
-  position: number;
-  /** What kind of alignment */
-  type: 'edge' | 'center';
-}
-interface EqualSpacingIndicator {
-  /** Axis along which the equal gaps run */
-  axis: 'x' | 'y';
-  /** The equal gap value (world units) */
-  gap: number;
-  /** Pairs of (from, to) marking each equal gap segment */
-  segments: {
-    from: number;
-    to: number;
-  }[];
-  /** Position on the perpendicular axis (for rendering) */
-  perpPosition: number;
-}
-interface SnapResult {
-  /** Snap-corrected delta (world units). Apply to entity position. */
-  snapDx: number;
-  snapDy: number;
-  /** Active alignment guide lines to render */
-  guides: SnapGuide[];
-  /** Equal spacing indicators */
-  spacings: EqualSpacingIndicator[];
-}
-interface EntityBounds {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-}
-/**
- * Compute snap guides for a dragged entity against reference entities.
- */
-declare function computeSnapGuides(dragged: EntityBounds, references: EntityBounds[], threshold: number): SnapResult;
-//#endregion
-//#region src/math.d.ts
-interface Vec2 {
-  x: number;
-  y: number;
-}
-interface Rect {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-}
-interface AABB {
-  minX: number;
-  minY: number;
-  maxX: number;
-  maxY: number;
-}
-/** Convert WorldBounds-shaped data to AABB */
-declare function worldBoundsToAABB(wb: {
-  worldX: number;
-  worldY: number;
-  worldWidth: number;
-  worldHeight: number;
-}): AABB;
-/** Test if two AABBs overlap */
-declare function intersectsAABB(a: AABB, b: AABB): boolean;
-/** Test if a point is inside an AABB */
-declare function pointInAABB(px: number, py: number, a: AABB): boolean;
-/** Convert screen coordinates to world coordinates */
-declare function screenToWorld(screenX: number, screenY: number, camera: {
-  x: number;
-  y: number;
-  zoom: number;
-}): Vec2;
-/** Convert world coordinates to screen coordinates */
-declare function worldToScreen(worldX: number, worldY: number, camera: {
-  x: number;
-  y: number;
-  zoom: number;
-}): Vec2;
-/** Clamp a value between min and max */
-declare function clamp(value: number, min: number, max: number): number;
-//#endregion
-//#region src/spatial.d.ts
-interface SpatialEntry extends AABB {
-  entityId: EntityId;
-}
-/**
- * Spatial index backed by an R-tree (rbush).
- * Stores world-space AABBs for fast viewport culling and hit testing.
- */
-declare class SpatialIndex {
-  private tree;
-  private entries;
-  upsert(entityId: EntityId, bounds: AABB): void;
-  remove(entityId: EntityId): void;
-  /** Query all entries intersecting the given AABB */
-  search(bounds: AABB): SpatialEntry[];
-  /** Find the topmost entity at a point (by z-order — caller sorts) */
-  searchPoint(x: number, y: number, tolerance?: number): SpatialEntry[];
-  clear(): void;
-  get size(): number;
-}
-//#endregion
-//#region src/engine.d.ts
-/** ECS resource holding the SpatialIndex instance for viewport culling and hit testing. */
-declare const SpatialIndexResource: _$_jamesyong42_reactive_ecs0.ResourceType<{
-  instance: SpatialIndex | null;
-}>;
-/** Directive returned by pointer handlers indicating how the canvas should handle capture. */
-type PointerDirective = {
-  action: 'passthrough';
-} | {
-  action: 'passthrough-track-drag';
-} | {
-  action: 'capture-drag';
-} | {
-  action: 'capture-resize';
-  handle: ResizeHandlePos;
-} | {
-  action: 'capture-marquee';
-};
-/** Keyboard modifier state captured alongside pointer events. */
-interface Modifiers {
-  shift: boolean;
-  ctrl: boolean;
-  alt: boolean;
-  meta: boolean;
-}
-/** A visible entity with its computed world-space bounds and display metadata. */
-interface VisibleEntity {
-  entityId: EntityId;
-  worldX: number;
-  worldY: number;
-  worldWidth: number;
-  worldHeight: number;
-  breakpoint: Breakpoint;
-  zIndex: number;
-  surface: string;
-  widgetType: string;
-}
-/** Per-frame change flags indicating what changed during the last tick. */
-interface FrameChanges {
-  /** Entities whose world-space position or size changed. */
-  positionsChanged: EntityId[];
-  /** Entities whose responsive breakpoint changed. */
-  breakpointsChanged: EntityId[];
-  /** Entities that entered the visible viewport. */
-  entered: EntityId[];
-  /** Entities that exited the visible viewport. */
-  exited: EntityId[];
-  /** Whether the camera position or zoom changed. */
-  cameraChanged: boolean;
-  /** Whether the navigation stack changed (entered/exited container). */
-  navigationChanged: boolean;
-  /** Whether the selection set changed. */
-  selectionChanged: boolean;
-}
-/** Configuration options for `createLayoutEngine()`. */
-interface LayoutEngineConfig {
-  /** Maximum entity count (default: 10000). */
-  maxEntities?: number;
-  /** Minimum and maximum zoom levels. */
-  zoom?: {
-    min: number;
-    max: number;
-  };
-  /** Screen-space pixel thresholds for responsive breakpoints. */
-  breakpoints?: {
-    micro: number;
-    compact: number;
-    normal: number;
-    expanded: number;
-  };
-  /** Snap alignment configuration. */
-  snap?: {
-    /** Whether snapping is enabled initially. */enabled?: boolean; /** Snap distance threshold in screen pixels. */
-    threshold?: number;
-  };
-  /** Widget definitions available to `spawn()`. */
-  widgets?: Widget[];
-  /** Archetype definitions available to `spawn()`. */
-  archetypes?: Archetype[];
-  /**
-   * Override the default iOS-style card preset sizes (small/medium/large/xl).
-   * Partial — unspecified presets keep their built-in defaults.
-   */
-  cardPresets?: {
-    presets?: Partial<Record<CardPreset, {
-      width: number;
-      height: number;
-    }>>;
-    gap?: number;
-  };
-}
-/**
- * The core layout engine. Manages the ECS world, camera, input, undo/redo,
- * spatial indexing, and frame lifecycle for an infinite canvas.
- */
-interface LayoutEngine {
-  /** The underlying ECS world. Use for direct component/tag/resource access. */
-  readonly world: World;
-  /** Creates a bare entity with optional initial components/tags. Low-level escape hatch. */
-  createEntity(inits?: ComponentInit[]): EntityId;
-  /**
-   * Spawns a new entity from a registered archetype or widget type.
-   * If `id` matches a registered archetype, that archetype is used.
-   * Otherwise, if `id` matches a registered widget, a default archetype is synthesized.
-   * Otherwise, a bare default archetype with type=`id` is used (useful in tests).
-   */
-  spawn(id: string, opts?: SpawnOptions): EntityId;
-  /** Spawns at the current camera viewport centre (sized from the archetype/widget default). */
-  spawnAtCameraCenter(id: string, opts?: Omit<SpawnOptions, 'at'>): EntityId;
-  /** Removes an entity and cleans up all components, tags, and spatial index entries. */
-  destroyEntity(id: EntityId): void;
-  /** Registers a widget definition. Auto-creates a matching default archetype if none exists. */
-  registerWidget(widget: Widget): void;
-  /** Returns a registered widget by type, or null. */
-  getWidget(type: string): Widget | null;
-  /** Returns all registered widgets. */
-  getWidgets(): Widget[];
-  /** Registers a custom archetype. */
-  registerArchetype(archetype: Archetype): void;
-  /** Returns a registered archetype by id, or null. */
-  getArchetype(id: string): Archetype | null;
-  /** Reads a component from an entity. Returns undefined if not present. */
-  get<T>(entity: EntityId, type: ComponentType<T>): T | undefined;
-  /** Updates a component on an entity (partial merge). */
-  set<T>(entity: EntityId, type: ComponentType<T>, data: Partial<T>): void;
-  /** Checks if an entity has a component or tag. */
-  has(entity: EntityId, type: ComponentType | TagType): boolean;
-  /** Attaches a component to an entity. Uses type defaults if `data` is omitted. Marks dirty. */
-  addComponent<T>(entity: EntityId, type: ComponentType<T>, data?: T): void;
-  /** Removes a component from an entity. Marks dirty. */
-  removeComponent(entity: EntityId, type: ComponentType): void;
-  /** Adds a tag to an entity. Marks dirty. */
-  addTag(entity: EntityId, type: TagType): void;
-  /** Removes a tag from an entity. Marks dirty. */
-  removeTag(entity: EntityId, type: TagType): void;
-  /** Returns the Standard Schema for a widget entity's `WidgetData.data`, if the widget declared one. */
-  getSchemaFor(entity: EntityId): StandardSchemaV1 | undefined;
-  /** Registers a custom ECS system to run each tick. */
-  registerSystem(system: SystemDef): void;
-  /** Removes a registered system by name. */
-  removeSystem(name: string): void;
-  /** Returns the current camera state {x, y, zoom}. */
-  getCamera(): {
-    x: number;
-    y: number;
-    zoom: number;
-  };
-  /** Moves the camera by the specified screen-space delta. */
-  panBy(dx: number, dy: number): void;
-  /** Moves the camera to the specified world coordinates. */
-  panTo(worldX: number, worldY: number): void;
-  /** Adjusts zoom level anchored at a screen point. Delta is a multiplier offset. */
-  zoomAtPoint(screenX: number, screenY: number, delta: number): void;
-  /** Sets the zoom level directly. */
-  zoomTo(zoom: number): void;
-  /** Adjusts camera to fit all entities (or specified entities) in the viewport. */
-  zoomToFit(entityIds?: EntityId[], padding?: number): void;
-  /** Updates the viewport dimensions. Called automatically by InfiniteCanvas on resize. */
-  setViewport(width: number, height: number, dpr?: number): void;
-  /** Pointer-down handler. Returns a directive for how the canvas should capture the pointer. */
-  handlePointerDown(screenX: number, screenY: number, button: number, modifiers: Modifiers): PointerDirective;
-  /** Pointer-move handler. Returns a directive reflecting the current interaction. */
-  handlePointerMove(screenX: number, screenY: number, modifiers: Modifiers): PointerDirective;
-  /** Pointer-up handler. Commits drags/resizes and returns a directive. */
-  handlePointerUp(): PointerDirective;
-  /** Cancels the current pointer interaction without committing changes. */
-  handlePointerCancel(): void;
-  /** Returns IDs of all currently selected entities. */
-  getSelectedEntities(): EntityId[];
-  /** Returns the entity currently under the pointer, or null. */
-  getHoveredEntity(): EntityId | null;
-  /** Navigates into a container entity, pushing the current camera onto the navigation stack. */
-  enterContainer(entity: EntityId): void;
-  /** Navigates out of the current container, restoring the previous camera state. */
-  exitContainer(): void;
-  /** Returns the entity ID of the currently active container, or null if at root. */
-  getActiveContainer(): EntityId | null;
-  /** Returns the current navigation depth (0 = root). */
-  getNavigationDepth(): number;
-  /** Executes a command and pushes it onto the undo stack. */
-  execute(command: Command): void;
-  /** Begins a command group -- subsequent commands are bundled into one undo step. */
-  beginCommandGroup(): void;
-  /** Ends the current command group. */
-  endCommandGroup(): void;
-  /** Undoes the last command or command group. Returns true if anything was undone. */
-  undo(): boolean;
-  /** Redoes the last undone command. Returns true if anything was redone. */
-  redo(): boolean;
-  /** Returns whether there is a command to undo. */
-  canUndo(): boolean;
-  /** Returns whether there is a command to redo. */
-  canRedo(): boolean;
-  /** Schedules a tick on the next animation frame. Call after programmatic changes. */
-  markDirty(): void;
-  /** Runs one frame: executes all ECS systems, updates spatial index, emits frame events. */
-  tick(): void;
-  /** Ticks only if dirty. Returns true if a tick was performed. */
-  flushIfDirty(): boolean;
-  /** Returns visible entities with their world-space bounds, breakpoint, and surface info. */
-  getVisibleEntities(): VisibleEntity[];
-  /** Returns per-frame change flags from the last tick. */
-  getFrameChanges(): FrameChanges;
-  /** Returns the spatial index used for viewport culling and hit testing. */
-  getSpatialIndex(): SpatialIndex;
-  /** Returns active snap guide lines from the last tick. */
-  getSnapGuides(): SnapGuide[];
-  /** Returns equal-spacing indicators from the last tick. */
-  getEqualSpacing(): EqualSpacingIndicator[];
-  /** Enables or disables snap alignment. */
-  setSnapEnabled(on: boolean): void;
-  /** Sets the snap distance threshold in world pixels. */
-  setSnapThreshold(worldPx: number): void;
-  /** Performance profiler for measuring system execution times. */
-  readonly profiler: Profiler;
-  /** Registers a callback invoked after each tick. Returns an unsubscribe function. */
-  onFrame(handler: () => void): Unsubscribe;
-  /** Destroys the engine, releasing all resources and subscriptions. */
-  destroy(): void;
-}
-/**
- * Creates a new LayoutEngine instance with the given configuration.
- * This is the main entry point for the infinite canvas library.
- */
-declare function createLayoutEngine(config?: LayoutEngineConfig): LayoutEngine;
-//#endregion
-export { Active as $, NavigationFrame as A, CommandBuffer as At, WidgetSurface as B, computeSnapGuides as C, Visible as Ct, CardPresetsResource as D, WorldBounds as Dt, CameraResource as E, WidgetData as Et, DomWidgetProps as F, ArchetypeRegistry as Ft, FrameTimeStats as G, isR3FWidget as H, R3FWidget as I, SpawnOptions as It, R3FSample as J, Profiler as K, R3FWidgetProps as L, createArchetypeRegistry as Lt, ViewportResource as M, ResizeCommand as Mt, ZoomConfigResource as N, SetComponentCommand as Nt, CursorResource as O, ZIndex as Ot, DomWidget as P, Archetype as Pt, WebGLStats as Q, Widget as R, SnapResult as S, Transform2D as St, BreakpointConfigResource as T, WidgetBreakpoint as Tt, StandardSchemaV1 as U, createWidgetRegistry as V, EcsStats as W, TickSample as X, R3FStats as Y, WebGLPass as Z, worldBoundsToAABB as _, Resizable as _t, PointerDirective as a, CursorHint as at, EqualSpacingIndicator as b, Selected as bt, createLayoutEngine as c, Dragging as ct, Rect as d, Hitbox as dt, CSSCursor as et, Vec2 as f, InteractionRole as ft, screenToWorld as g, Parent as gt, pointInAABB as h, Locked as ht, Modifiers as i, Container as it, NavigationStackResource as j, MoveCommand as jt, CursorResourceData as k, Command as kt, SpatialIndex as l, HandleSet as lt, intersectsAABB as m, InteractionRoleType as mt, LayoutEngine as n, CardPreset as nt, SpatialIndexResource as o, CursorHintData as ot, clamp as p, InteractionRoleData as pt, ProfilerStats as q, LayoutEngineConfig as r, Children as rt, VisibleEntity as s, Draggable as st, FrameChanges as t, Card as tt, AABB as u, HandleSetData as ut, worldToScreen as v, ResizeHandlePos as vt, Breakpoint as w, Widget$1 as wt, SnapGuide as x, SelectionFrame as xt, EntityBounds as y, Selectable as yt, WidgetRegistry as z };
-//# sourceMappingURL=engine-CCjuFMC-.d.cts.map