@vibecook/ice 0.1.0

package/dist/types/packages/core/src/catalog/camera-derived.d.ts

@@ -0,0 +1,144 @@
+/** The single live camera (F2). `gesturing` gates the compositor DPR (design-004). */
+export declare const Camera: import("@vibecook/strata-ecs").Resource<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly gesturing: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly gesturing: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>;
+/** Viewport size + device pixel ratio. */
+export declare const Viewport: import("@vibecook/strata-ecs").Resource<import("@vibecook/strata-ecs").ValueOf<{
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dpr: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dpr: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** The active tool id (defaults to select). */
+export declare const ActiveTool: import("@vibecook/strata-ecs").Resource<import("@vibecook/strata-ecs").ValueOf<{
+    readonly id: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>, {
+    readonly id: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>;
+/** Global snap toggle + threshold in screen px (scaled by zoom at use, design-003 §5.2). */
+export declare const SnapConfig: import("@vibecook/strata-ecs").Resource<import("@vibecook/strata-ecs").ValueOf<{
+    readonly enabled: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly thresholdPx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly enabled: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly thresholdPx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Per-container view-state memory — a runtime rider on container widgets (design-001 §5.7). */
+export declare const ContainerCamera: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Widget's ChildOf chain roots in the CURRENT nav frame (activeMembership system). */
+export declare const Active: import("@vibecook/strata-ecs").Tag;
+/** In the viewport. Invariant: Active widgets are Visible ⊕ Culled. */
+export declare const Visible: import("@vibecook/strata-ecs").Tag;
+/** Outside the viewport. */
+export declare const Culled: import("@vibecook/strata-ecs").Tag;
+/** LOD tier + the effective size it was computed from (5 thresholds, width AND height). */
+export declare const WidgetBreakpoint: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly tier: import("@vibecook/strata-ecs").FieldSpec<import("@vibecook/strata-ecs").EnumType<"micro" | "compact" | "normal" | "expanded" | "detailed">, true>;
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"u16", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"u16", true>;
+}>, {
+    readonly tier: import("@vibecook/strata-ecs").FieldSpec<import("@vibecook/strata-ecs").EnumType<"micro" | "compact" | "normal" | "expanded" | "detailed">, true>;
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"u16", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"u16", true>;
+}>;
+/** Session rider on auto-sized widgets (ResizeObserver → queue → ingest; never committed). */
+export declare const MeasuredSize: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Selection outline rect. */
+export declare const SelectionBox: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** A resize handle's anchor (the one chrome kind behaviors capture). */
+export declare const HandleSpec: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly anchor: import("@vibecook/strata-ecs").EnumType<"w" | "n" | "e" | "s" | "nw" | "ne" | "se" | "sw">;
+}>, {
+    readonly anchor: import("@vibecook/strata-ecs").EnumType<"w" | "n" | "e" | "s" | "nw" | "ne" | "se" | "sw">;
+}>;
+/** A snap guide line along one axis. */
+export declare const GuideLine: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly axis: import("@vibecook/strata-ecs").EnumType<"x" | "y">;
+    readonly at: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly from: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly to: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>, {
+    readonly axis: import("@vibecook/strata-ecs").EnumType<"x" | "y">;
+    readonly at: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly from: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly to: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>;
+/** Marquee selection rect. */
+export declare const MarqueeBox: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly w: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly h: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Cursor appearance — local (OS cursor) vs remote (custom node). */
+export declare const CursorVisual: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly kind: import("@vibecook/strata-ecs").EnumType<"local" | "remote">;
+    readonly pressed: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>, {
+    readonly kind: import("@vibecook/strata-ecs").EnumType<"local" | "remote">;
+    readonly pressed: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>;
+/** cursor → pointer or presence peer. */
+export declare const Follows: import("@vibecook/strata-ecs").Relation;
+/** chrome → its source (recognizer, selection). */
+export declare const VisualOf: import("@vibecook/strata-ecs").Relation;
+/** Depth of a nav entry (root = 0). */
+export declare const NavDepth: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly d: import("@vibecook/strata-ecs").FieldSpec<"u8", true>;
+}>, {
+    readonly d: import("@vibecook/strata-ecs").FieldSpec<"u8", true>;
+}>;
+/** Camera stored on a nav entry. */
+export declare const NavCamera: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** nav entry → container widget. */
+export declare const NavFrame: import("@vibecook/strata-ecs").Relation;
+/** The canvas background entity, so picking always resolves to *something* (design-001 §4). */
+export declare const CanvasSurface: import("@vibecook/strata-ecs").Tag;

package/dist/types/packages/core/src/catalog/gesture.d.ts

@@ -0,0 +1,254 @@
+/** Continuous drag. Origin from dead-zone exit; totals/velocities accumulate; `zoomAtClaim` anchors widget-move math. */
+export declare const Drag: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly startX: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly startY: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly totalX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly totalY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly velX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly velY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly zoomAtClaim: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly startX: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly startY: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly totalX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly totalY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly velX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly velY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly zoomAtClaim: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/**
+ * Discrete tap — claims at up within the tap window & slop. `count` is the
+ * multi-tap tally (v2 gesture.ts): 0 while the (next) tap is in progress; each
+ * clean release increments it. Without a `MultiTap` opt-in on the capture
+ * target the first release Recognizes at count 1 — zero added latency.
+ */
+export declare const Tap: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly downAt: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly count: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
+}>, {
+    readonly downAt: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly count: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
+}>;
+/** Discrete-with-tail: claims at the long-press hold, then tracks cur X/Y per frame (touch marquee rides it). */
+export declare const LongPress: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly downAt: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly startX: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly startY: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly curX: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly curY: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>, {
+    readonly downAt: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly startX: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly startY: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly curX: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly curY: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>;
+/** Continuous two-finger pinch. `startDist` re-baselines at activation; `cx/cy` is the centroid. */
+export declare const Pinch: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly startDist: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly startZoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly cx: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly cy: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoomAtClaim: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly startDist: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly startZoom: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly cx: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly cy: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly zoomAtClaim: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Continuous wheel pan (`Simultaneous` — never claims pointers). `anchorX/Y` is the screen anchor. */
+export declare const WheelPan: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly dx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dy: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly dx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dy: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Continuous wheel zoom (`Simultaneous`). `pinch` is the accumulated zoom signal; `anchorX/Y` the pin point. */
+export declare const WheelZoom: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly pinch: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly pinch: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly anchorY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/**
+ * The recognizer lifecycle as ONE PhaseSet (design-003 §4.2): seven mutually-exclusive
+ * phases. Each mints a persistent `Gesture<Phase>` tag AND a one-tick `GestureJust<Phase>`
+ * marker (plain concatenation — the doc vocabulary "GesturePossible"… is unchanged), so
+ * behaviors edge-trigger discrete/terminal actions on the markers exactly once while a
+ * terminal tag lingers through the reap window (§4.2, §4.1). The named phase tags below
+ * are re-exports of `GesturePhases.tags.*` for ergonomics + `ops/claims` compatibility.
+ * `GesturePossible` etc. is the ONLY definition path for these tag names (strata's schema
+ * registry is process-global — a second `defineTag("GesturePossible")` would throw).
+ *
+ * `Pending` (restored from v2 gesture.ts — the design-003 §4.2 "dead machinery" drop is
+ * superseded now that a real gesture ships it): criteria met but recognition withheld —
+ * a multi-tap awaiting its inter-tap window, or a recognizer parked behind a
+ * `Sequence`/`RequiresFail` edge. NEVER reaped; exempt from integrity's watched-pointer
+ * count (a pending multi-tap legitimately outlives its lifted touch pointer).
+ */
+export declare const GesturePhases: import("..").PhaseSet<"Possible" | "Active" | "Pending" | "Recognized" | "Ended" | "Failed" | "Cancelled">;
+/** Recognizer alive, not yet claiming. */
+export declare const GesturePossible: import("@vibecook/strata-ecs").Tag;
+/** Continuous kinds' claiming phase + per-frame work gate. */
+export declare const GestureActive: import("@vibecook/strata-ecs").Tag;
+/** Recognition withheld (multi-tap window / dependency edge); never reaped. */
+export declare const GesturePending: import("@vibecook/strata-ecs").Tag;
+/** Discrete kinds' terminal claim. */
+export declare const GestureRecognized: import("@vibecook/strata-ecs").Tag;
+/** Continuous kinds' terminal (release). */
+export declare const GestureEnded: import("@vibecook/strata-ecs").Tag;
+/** Recognizer failed its predicate or lost arbitration. */
+export declare const GestureFailed: import("@vibecook/strata-ecs").Tag;
+/** Recognizer cancelled (pointercancel / integrity / CancelRequest). */
+export declare const GestureCancelled: import("@vibecook/strata-ecs").Tag;
+/** Suspended (a pinch suspends the single-pointer recognizers) — "suspend, don't kill". */
+export declare const GestureSuspended: import("@vibecook/strata-ecs").Tag;
+/**
+ * The recognizer latched a `Captures` target at spawn (design-003 §4.1 integrity).
+ * Relations auto-clear on target despawn, so "had a capture, has none now" is
+ * detectable only with this spawn-time mark — integrity cancels on that edge loss.
+ */
+export declare const HadCapture: import("@vibecook/strata-ecs").Tag;
+/** Runs alongside claims without competing (wheel pan/zoom) — keeps zoom-while-dragging legal. */
+export declare const Simultaneous: import("@vibecook/strata-ecs").Tag;
+export declare const RoutedMove: import("@vibecook/strata-ecs").Tag;
+export declare const RoutedResize: import("@vibecook/strata-ecs").Tag;
+export declare const RoutedConnect: import("@vibecook/strata-ecs").Tag;
+export declare const RoutedMarquee: import("@vibecook/strata-ecs").Tag;
+export declare const RoutedPan: import("@vibecook/strata-ecs").Tag;
+/** Draw-tool drag: the release rect creates a widget (design-005 §3, M10). */
+export declare const RoutedDraw: import("@vibecook/strata-ecs").Tag;
+/**
+ * Per-target multi-tap opt-in (v2 gesture.ts): declares "this target counts
+ * multi-taps", read via the recognizer's `Captures` target. Absent → max 1,
+ * zero latency (a plain widget stays instant). `windowMs` = the inter-tap
+ * wait; `slopPx` = max screen gap between taps for the rejoin.
+ */
+export declare const MultiTap: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly max: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
+    readonly windowMs: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly slopPx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly max: import("@vibecook/strata-ecs").FieldSpec<"u32", true>;
+    readonly windowMs: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly slopPx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** recognizer → watched pointer(s). */
+export declare const Watches: import("@vibecook/strata-ecs").Relation;
+/**
+ * Sequencing edges (v2 gesture.ts; resolved by the dependency system at the end
+ * of `ctl:recognize`). `Sequence` gates the ENTRANCE: a `Pending` recognizer
+ * waits for `after` to pass (Active/Recognized), then hands off — Down rebases
+ * to the current pointer and the source retires. `RequiresFail` gates the EXIT:
+ * a `Pending` recognizer finishes only once `other` fails (discrete →
+ * Recognized, continuous → Active); if `other` wins, it loses. Edges auto-clear
+ * on despawn, so each carries a `Had*` spawn-time mark (the `HadCapture`
+ * pattern): "had an edge, has none" = orphaned → Failed.
+ */
+export declare const Sequence: import("@vibecook/strata-ecs").Relation;
+export declare const RequiresFail: import("@vibecook/strata-ecs").Relation;
+/** The recognizer was given a `Sequence` edge (orphan detection — see above). */
+export declare const HadSequence: import("@vibecook/strata-ecs").Tag;
+/** The recognizer was given a `RequiresFail` edge (orphan detection — see above). */
+export declare const HadRequiresFail: import("@vibecook/strata-ecs").Tag;
+/** recognizer → grabbed entity (widget/port/handle/canvas), latched at down. */
+export declare const Captures: import("@vibecook/strata-ecs").Relation;
+/** recognizer → affected widgets (live edge set; remote despawns auto-clear their edge). */
+export declare const Drags: import("@vibecook/strata-ecs").Relation;
+/** pointer → the recognizer that claimed it (arbitration output, design-003 §4.3). */
+export declare const ClaimedBy: import("@vibecook/strata-ecs").Relation;
+/** recognizer → candidate container under the dragged bounds (design-003 §5 dropSystem). */
+export declare const DropTarget: import("@vibecook/strata-ecs").Relation;
+/**
+ * Per-dragged-widget origin, attached at claim time with the CURRENT transform embedded
+ * (design-001 §3, design-003 §4.5). Bare on purpose: a defaulted zero origin would corrupt
+ * the cancel-restore of Position/StackZ.
+ */
+export declare const Grab: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: "f64";
+    readonly y: "f64";
+    readonly w: "f32";
+    readonly h: "f32";
+    readonly z: "f64";
+}>, {
+    readonly x: "f64";
+    readonly y: "f64";
+    readonly w: "f32";
+    readonly h: "f32";
+    readonly z: "f64";
+}>;
+/** Snap offset — in the Drag prefab's essential set (present from spawn, zeroed — writers never race an attach). */
+export declare const SnapState: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly dx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dy: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly dx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dy: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/**
+ * The down point + timestamp latched on the recognizer at spawn (design-003 §4.1). Bare: it must
+ * carry the real down sample.
+ */
+export declare const Down: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: "f64";
+    readonly y: "f64";
+    readonly ms: "f64";
+}>, {
+    readonly x: "f64";
+    readonly y: "f64";
+    readonly ms: "f64";
+}>;
+/** On widgets, toggled O(1) when the drop candidate changes (design-001 §5.5). */
+export declare const OverlapCandidate: import("@vibecook/strata-ecs").Tag;
+/**
+ * Capability: a SOLID widget is a drop-REJECTING target — dragging another
+ * widget onto it and releasing flies the dragged set back (v1's iOS-card
+ * overlap contract, field report 2026-07-12). Opt-in via `defineWidget`
+ * `interaction.solid`; free-overlap apps (moodboard) never equip it.
+ */
+export declare const Solid: import("@vibecook/strata-ecs").Tag;
+/**
+ * Capability: this widget's drag starts on LONG-PRESS (the iOS home-screen
+ * model — hold to lift, then move; taps and widget-internal interactions stay
+ * instant). Opt-in via `defineWidget` `interaction.dragOn: "longPress"`.
+ * Mechanically: `recognizerSpawn` parks the widget's Drag recognizer
+ * `Pending` behind a `Sequence` edge to the same pointer's LongPress — the
+ * restored Pending machinery's hand-off does the rest (design-003 §4.2
+ * amendment; first production wiring, 2026-07-12).
+ */
+export declare const LongPressDrag: import("@vibecook/strata-ecs").Tag;
+/**
+ * On a hovered Solid widget (or a mismatched container) while a drag's bounds
+ * overlap it: the REJECT half of the drop signal pair (OverlapCandidate is the
+ * accept half) — chrome renders the weak "won't take it" glow. Change-only,
+ * cleared on move-off and on every move terminal.
+ */
+export declare const OverlapRejected: import("@vibecook/strata-ecs").Tag;
+/**
+ * Fly-back tween easing Position → target (design-003 §5 move outcome; design-001 §3 amends the
+ * per-cell guard so a live tween IS the diverging authority until reconvergence).
+ *
+ * Minimal shape not spelled out field-by-field in design-001 §5: the target (`toX/toY`) and
+ * `durationMs` are supplied at attach (bare); `elapsedMs` starts at 0 and the tween system advances
+ * it, removing the component on arrival.
+ */
+export declare const TransformTween: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly toX: "f64";
+    readonly toY: "f64";
+    readonly durationMs: "f32";
+    readonly elapsedMs: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly toX: "f64";
+    readonly toY: "f64";
+    readonly durationMs: "f32";
+    readonly elapsedMs: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;

package/dist/types/packages/core/src/catalog/graph.d.ts

@@ -0,0 +1,55 @@
+/** Marks an entity as a wire. */
+export declare const Wire: import("@vibecook/strata-ecs").Tag;
+/** wire → source widget (durable-eligible). */
+export declare const WireFrom: import("@vibecook/strata-ecs").Relation;
+/** wire → target widget (durable-eligible). */
+export declare const WireTo: import("@vibecook/strata-ecs").Relation;
+/** The port ids (from each widget's port schema) the wire binds to. */
+export declare const WirePorts: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly from: "string";
+    readonly to: "string";
+}>, {
+    readonly from: "string";
+    readonly to: "string";
+}>;
+/** A widget port descriptor — spawned only for interaction (connect tool / hover proximity). */
+export declare const Port: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly id: "string";
+    readonly side: import("@vibecook/strata-ecs").EnumType<"w" | "n" | "e" | "s">;
+    readonly index: import("@vibecook/strata-ecs").FieldSpec<"u8", true>;
+}>, {
+    readonly id: "string";
+    readonly side: import("@vibecook/strata-ecs").EnumType<"w" | "n" | "e" | "s">;
+    readonly index: import("@vibecook/strata-ecs").FieldSpec<"u8", true>;
+}>;
+/** port → widget. */
+export declare const PortOf: import("@vibecook/strata-ecs").Relation;
+/** Derive-owned world coordinates of a port anchor. */
+export declare const PortAnchor: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>;
+/** Marks a widget as a container (accepts children via the drop system). */
+export declare const Container: import("@vibecook/strata-ecs").Tag;
+/** JSON list of provides-keys this container accepts. */
+export declare const Accepts: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly list: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>, {
+    readonly list: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>;
+/** JSON list of provides-keys this widget offers to containers. */
+export declare const Provides: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly list: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>, {
+    readonly list: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>;
+/**
+ * The durable wire prefab (design-001 §5.3): PrefabId "wire" + WirePorts;
+ * Wire tag + WireFrom/WireTo edges ride the spawn (doc commit sink executes
+ * connect intents). Registered here so the version gate stamps
+ * `engine.pack.wire.<v>` like every durable pack.
+ */
+export declare const WirePrefab: import("..").Prefab;

package/dist/types/packages/core/src/catalog/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The component / tag / relation / resource CATALOG — the vocabulary contract
+ * (design-001 §5, design-003 §4). A faithful transcription: names match the
+ * design EXACTLY, since these strings are the durable + cross-peer schema.
+ *
+ * Everything is defined through the recording wrappers in ../schema/meta (never
+ * strata directly), so prefab validation and devtools can introspect the shapes.
+ *
+ * DEFAULTS POLICY (design-001 §5 says "match the doc"; the task asks for prefab
+ * ergonomics — reconciled here):
+ *  - Essential geometry/identity a prefab or commit ALWAYS supplies stays bare
+ *    (required at spawn): Position, Size, StackZ, WirePorts, Pointer.id/device,
+ *    Port.id/side, PresenceInfo.
+ *  - Origin-latch riders that MUST carry real values stay bare: Grab, Down —
+ *    a defaulted zero origin would corrupt a cancel-restore.
+ *  - Enum-identity fields that differ per entity stay bare: HandleSpec.anchor,
+ *    GuideLine.axis, CursorVisual.kind, PresenceCursor.device.
+ *  - Everything else — runtime accumulators/scratch (recognizer kind components,
+ *    per-frame value writes), optional-eligible components (Rotation), derived
+ *    state, and resources — carries a zero/identity default so an ad-hoc attach
+ *    or `ctx.spawn` needs no boilerplate. Resources especially: one live value
+ *    that must initialize sanely (origin, zoom 1, select tool).
+ *
+ * PrefabId is NOT here — it is defined once in ../schema/prefab (§2 rule 5).
+ */
+export * from "./scene";
+export * from "./graph";
+export * from "./pointer";
+export * from "./gesture";
+export * from "./selection-presence";
+export * from "./camera-derived";
+export * from "./settings-resources";

package/dist/types/packages/core/src/catalog/pointer.d.ts

@@ -0,0 +1,111 @@
+/** Pointer identity. `owner` is the peer/user id ("" for the local device). */
+export declare const Pointer: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly id: "string";
+    readonly device: import("@vibecook/strata-ecs").EnumType<"mouse" | "touch" | "pen">;
+    readonly owner: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>, {
+    readonly id: "string";
+    readonly device: import("@vibecook/strata-ecs").EnumType<"mouse" | "touch" | "pen">;
+    readonly owner: import("@vibecook/strata-ecs").FieldSpec<"string", true>;
+}>;
+/** Screen-space position, CSS px. */
+export declare const PointerScreen: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Button bitmask + the screen point/time where the current press began. */
+export declare const PointerButtons: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly buttons: import("@vibecook/strata-ecs").FieldSpec<"u8", true>;
+    readonly downX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly downY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    /** The down EVENT's timestamp (0 = unknown ⇒ consumers fall back to frame now). */
+    readonly downMs: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>, {
+    readonly buttons: import("@vibecook/strata-ecs").FieldSpec<"u8", true>;
+    readonly downX: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly downY: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    /** The down EVENT's timestamp (0 = unknown ⇒ consumers fall back to frame now). */
+    readonly downMs: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>;
+/** Keyboard modifiers latched with the pointer sample. */
+export declare const PointerMods: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly shift: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly ctrl: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly alt: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly meta: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>, {
+    readonly shift: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly ctrl: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly alt: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly meta: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>;
+/** Wheel deltas — accumulate within a tick, zeroed in cleanup. `pinch` is the ctrl-wheel zoom signal. */
+export declare const PointerWheel: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly dx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dy: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly pinch: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly dx: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly dy: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+    readonly pinch: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Touch-forgiveness radius, screen px (0 = exact, for mouse/pen). */
+export declare const PointerRadius: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly r: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly r: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** One-tick: pointer went down this tick (cleared in cleanup). */
+export declare const WentDown: import("@vibecook/strata-ecs").Tag;
+/** One-tick: pointer went up this tick. */
+export declare const WentUp: import("@vibecook/strata-ecs").Tag;
+/** One-tick: pointer was cancelled this tick (pointercancel / touch lost / blur). */
+export declare const WentCancelled: import("@vibecook/strata-ecs").Tag;
+/** The down was consumed by a widget's own DOM handler — recognizers skip it. */
+export declare const HandledByWidget: import("@vibecook/strata-ecs").Tag;
+/** Marks the local device's pointer(s) (vs. presence projections). */
+export declare const LocalPointer: import("@vibecook/strata-ecs").Tag;
+/** Derive-owned world position — screen × camera, recomputed every tick. */
+export declare const PointerWorld: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>, {
+    readonly x: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+    readonly y: import("@vibecook/strata-ecs").FieldSpec<"f64", true>;
+}>;
+/**
+ * Keyboard modifier state (design-003 §2 — minimal keyboard). Written by ingest
+ * from adapter key events. `space` is the pan gesture modifier (design-003 §4.4);
+ * shortcuts are app handlers between frames, never a tick system.
+ */
+export declare const Keyboard: import("@vibecook/strata-ecs").Resource<import("@vibecook/strata-ecs").ValueOf<{
+    readonly shift: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly ctrl: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly alt: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly meta: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly space: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>, {
+    readonly shift: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly ctrl: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly alt: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly meta: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+    readonly space: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>;
+/**
+ * ONE-TICK cancel request (design-003 §4.1/§8): escape / tool switch / doc
+ * detach all converge here via `cancelActiveGestures()`. The ctl:spawn sweep
+ * consumes it; cleanup clears it — a latched cancel would kill every future
+ * gesture forever.
+ */
+export declare const CancelRequest: import("@vibecook/strata-ecs").Resource<import("@vibecook/strata-ecs").ValueOf<{
+    readonly active: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>, {
+    readonly active: import("@vibecook/strata-ecs").FieldSpec<"bool", true>;
+}>;
+/** pointer → hovered entity (radiused pick — "hover is forgiving"). */
+export declare const Targets: import("@vibecook/strata-ecs").Relation;
+/** pointer → r=0 point-pick target ("grab is precise"). */
+export declare const TouchesExact: import("@vibecook/strata-ecs").Relation;

package/dist/types/packages/core/src/catalog/scene.d.ts

@@ -0,0 +1,34 @@
+/** Frame-local position, world units. f64 — the infinite canvas loses integer precision in f32 past ~16.7M. */
+export declare const Position: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly x: "f64";
+    readonly y: "f64";
+}>, {
+    readonly x: "f64";
+    readonly y: "f64";
+}>;
+/** Widget size, world units. f32 — sizes never need f64's range. */
+export declare const Size: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly w: "f32";
+    readonly h: "f32";
+}>, {
+    readonly w: "f32";
+    readonly h: "f32";
+}>;
+/** Optional-eligible rotation, radians. Identity default so a bare attach is ergonomic. */
+export declare const Rotation: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly r: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>, {
+    readonly r: import("@vibecook/strata-ecs").FieldSpec<"f32", true>;
+}>;
+/** Fractional stacking order — z-reorder is one cell write; midpoints jittered, ties break by key. */
+export declare const StackZ: import("@vibecook/strata-ecs").Component<import("@vibecook/strata-ecs").ValueOf<{
+    readonly z: "f64";
+}>, {
+    readonly z: "f64";
+}>;
+/**
+ * child → parent frame (durable-eligible). Replaces the ParentFrame/ContainerChildren triad:
+ * children-of-x = `Related(ChildOf, x)`; ancestor walk = forward `getRelation`; engine cascade
+ * walks `getReverse(e, ChildOf)` (see ops/cascade.ts).
+ */
+export declare const ChildOf: import("@vibecook/strata-ecs").Relation;