@jamesyong42/infinite-canvas 1.3.0 → 1.4.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { $ as WidgetBreakpoint, A as ContainerCamera, B as OverlapTarget, C as ViewportResource, D as CardOverlapHotPoint, E as Card, F as Dragging, G as Selected, H as PreDragLayer, I as InteractionRole, J as SnapTarget, K as SelectionFrame, L as Layer, M as Culled, N as CursorHint, O as Children, P as Draggable, Q as Widget, R as Locked, S as SpatialIndexResource, T as Active, U as Resizable, V as ParentFrame, W as Selectable, X as TransformTween, Y as Transform2D, Z as Visible, _ as CursorResource, a as useEntityTags, b as NavigationStackResource, c as useRegisteredTags, d as useTaggedEntities, et as WidgetData, f as EngineProvider, g as CardPresetsResource, h as CameraResource, i as useEntityComponents, j as ContainerChildren, k as Container, l as useResource, m as BreakpointConfigResource, n as useCamera, o as useQuery, p as useLayoutEngine, q as SnapSource, r as useComponent, s as useRegisteredComponents, t as useAllEntities, tt as ZIndex, u as useTag, v as DEFAULT_CARD_PRESET_SIZES, w as ZoomConfigResource, x as RootCameraResource, y as LayerOrderResource, z as OverlapCandidate } from "./ecs-3kimUV5Z.mjs";
 import { B as Profiler, C as selectBand, F as useWidgetResolver, I as ContainerRefProvider, L as useContainerRef, M as inputGroupStart, N as inputLog, P as WidgetResolverProvider, R as computeSnapGuides, S as isOutOfBand, a as useWidgetInvalidate, c as SelectionOverlaySlot, d as DEFAULT_SNAP_GUIDE_CONFIG, f as DEFAULT_SELECTION_CONFIG, g as R3FManager, i as useWidgetAnimation, j as sharedGlowUniforms, l as CardChrome, m as DEFAULT_GRID_CONFIG, n as useSharedMaterial, o as useWidgetPhase, r as useSharedTexture, s as WidgetSlot, t as useSharedGeometry, u as WebGLManager, x as ZOOM_BANDS, z as SpatialIndex } from "./hooks-gsQDDE56.mjs";
-import { SystemScheduler, createWorld, defineSystem } from "@jamesyong42/reactive-ecs";
+import { PhasedScheduler, createWorld, defineSystem } from "@jamesyong42/reactive-ecs";
 import React, { useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/ecs/archetype.ts
@@ -279,6 +279,7 @@ function clamp(value, min, max) {
 */
 const breakpointSystem = defineSystem({
 	name: "breakpoint",
+	phase: "derive",
 	after: "cull",
 	execute: (world) => {
 		const camera = world.getResource(CameraResource);
@@ -323,6 +324,7 @@ const breakpointSystem = defineSystem({
 */
 const cardSystem = defineSystem({
 	name: "card",
+	phase: "derive",
 	execute: (world) => {
 		const resource = world.getResource(CardPresetsResource);
 		if (!resource) return;
@@ -353,7 +355,7 @@ const cardSystem = defineSystem({
 */
 const cullSystem = defineSystem({
 	name: "cull",
-	after: "navigationFilter",
+	phase: "derive",
 	execute: (world) => {
 		const camera = world.getResource(CameraResource);
 		const viewport = world.getResource(ViewportResource);
@@ -398,14 +400,13 @@ const cullSystem = defineSystem({
 *   Dragging present, no PreDragLayer  → promote (stash old layer, set overlay)
 *   PreDragLayer present, no Dragging  → restore (write back stashed layer)
 *
-* RFC-010 Phase 1 — migrates the two `onTagAdded(Dragging)` /
-* `onTagRemoved(Dragging)` observers out of `LayoutEngine.ts` into a
-* `SystemScheduler` system. The `before: 'cull'` constraint is conservative
-* and becomes implicit once RFC-010 Phase 2 stamps `phase: 'react'`.
+* RFC-010 — runs in the `react` phase so the promote/restore is settled
+* before `derive`-phase systems (`cull`, `breakpoint`, `sort`) and the
+* `present`-phase visibility / frame-changes assembly run.
 */
 const dragPromoteSystem = defineSystem({
 	name: "dragPromote",
-	before: "cull",
+	phase: "react",
 	execute: (world) => {
 		for (const entity of world.queryTagged(Dragging)) {
 			if (world.hasComponent(entity, PreDragLayer)) continue;
@@ -453,6 +454,7 @@ function reconcileEntityActive(world, entity) {
 */
 const navigationFilterSystem = defineSystem({
 	name: "navigationFilter",
+	phase: "control",
 	execute: (world) => {
 		const navStack = world.getResource(NavigationStackResource);
 		const stackChanged = navStack.changed;
@@ -477,6 +479,7 @@ const navigationFilterSystem = defineSystem({
 */
 const sortSystem = defineSystem({
 	name: "sort",
+	phase: "derive",
 	after: "breakpoint",
 	execute: (_world) => {}
 });
@@ -514,6 +517,7 @@ function applyEasing(p, easing) {
 */
 const transformTweenSystem = defineSystem({
 	name: "transformTween",
+	phase: "simulate",
 	execute: (world) => {
 		const nowMs = typeof performance !== "undefined" ? performance.now() : Date.now();
 		for (const entity of world.query(TransformTween)) {
@@ -1481,6 +1485,35 @@ function createInteractionRuntime(ctx) {
 	};
 }
 //#endregion
+//#region src/ecs/engine/phases.ts
+/**
+* Pipeline phases for the infinite-canvas `LayoutEngine`.
+*
+* `reactive-ecs` ships zero phase vocabulary — phase names and order are the
+* consumer's responsibility. These names are infinite-canvas's choice; a UI
+* tool, a game engine, and an agent simulator would each pick differently.
+*
+* Phase intent:
+* - `input`     — drain external intent (gestures, raw flag captures) into the world
+* - `react`     — maintain invariants in response to mutations from prior writes
+* - `control`   — state machines, intent resolution, navigation
+* - `simulate`  — time-driven mutations (tweens, animation)
+* - `derive`    — compute frame-local derived state (visibility, sort, layout)
+* - `present`   — build outputs for renderers (frame-changes, visible lists)
+* - `cleanup`   — end-of-frame bookkeeping (clearDirty, incrementTick, emitFrame)
+*
+* See RFC-010 for the full architectural rationale.
+*/
+const ENGINE_PHASES = [
+	"input",
+	"react",
+	"control",
+	"simulate",
+	"derive",
+	"present",
+	"cleanup"
+];
+//#endregion
 //#region src/ecs/engine/widget-binding.ts
 function createWidgetRegistry(defs = []) {
 	const map = /* @__PURE__ */ new Map();
@@ -1505,7 +1538,10 @@ function createWidgetRegistry(defs = []) {
 */
 function createLayoutEngine(config) {
 	const world = createWorld();
-	const scheduler = new SystemScheduler();
+	const scheduler = new PhasedScheduler({
+		phases: ENGINE_PHASES,
+		defaultPhase: "derive"
+	});
 	const spatialIndex = new SpatialIndex();
 	const profiler = new Profiler();
 	scheduler.profiler = profiler;