@unrulysystems/native-motion-core 0.1.0-alpha.0

package/dist/layout/tree.d.cts

@@ -0,0 +1,70 @@
+import type { Rect } from "./types.cjs";
+export type ProjectionStaleNodeCode = 'projection-stale-node' | 'projection-unregistered-node' | 'projection-orphaned-path' | 'projection-invalid-frame-input' | 'projection-invalid-radius-correction' | 'projection-non-finite-output' | 'projection-report-overflow';
+export interface ProjectionStaleNodeReport {
+    readonly source: 'projection-tree';
+    readonly code: ProjectionStaleNodeCode;
+    readonly detail: string;
+}
+export type ProjectionTreeOptions = {
+    readonly onStaleProjectionNode: (report: ProjectionStaleNodeReport) => void;
+} | {
+    readonly delivery: 'drain';
+};
+export interface CorrectedRadius {
+    readonly x: number;
+    readonly y: number;
+}
+export interface ProjectionNodeOutput {
+    readonly translateX: number;
+    readonly translateY: number;
+    readonly scaleX: number;
+    readonly scaleY: number;
+    readonly borderRadius: CorrectedRadius | null;
+    readonly targetDeltaScaleX: number;
+    readonly targetDeltaScaleY: number;
+    readonly treeScaleX: number;
+    readonly treeScaleY: number;
+}
+export interface ProjectionTreeNode {
+    readonly componentId: string;
+    readonly parentId: string | null;
+    readonly depth: number;
+    readonly path: readonly string[];
+    readonly target: Rect | null;
+    readonly treeScaleX: number;
+    readonly treeScaleY: number;
+    readonly output: ProjectionNodeOutput;
+}
+export interface ProjectionTree {
+    register(componentId: string, parentId: string | null, projectionParticipant?: boolean): void;
+    unregister(componentId: string): void;
+    setTarget(componentId: string, target: Rect | null): void;
+    setProjection(componentId: string, source: Rect, target: Rect, progress: number): void;
+    /**
+     * Publish a transform that another native lane already paints on this host. The tree carries
+     * it into descendants but emits only ancestor correction for this node, preventing a layoutId
+     * holder's own FLIP transform from being applied twice.
+     */
+    setDirectProjection(componentId: string, translateX: number, translateY: number, scaleX: number, scaleY: number): void;
+    setHostFrame(componentId: string, currentX: number, currentY: number, currentWidth: number, currentHeight: number, targetX: number, targetY: number, targetWidth: number, targetHeight: number): void;
+    clearProjection(componentId: string): void;
+    setBorderRadius(componentId: string, radius: number | null): void;
+    project(visitor?: (node: ProjectionTreeNode) => void): void;
+    output(componentId: string): ProjectionNodeOutput;
+    /**
+     * Drain the bounded stale-report ring (iOS AUTO SIGABRT campaign): returns and clears every
+     * report recorded since the last drain. A quiet frame returns the shared frozen empty array —
+     * no allocation (REQ-DRIVER-021).
+     */
+    drainStaleReports(): readonly ProjectionStaleNodeReport[];
+}
+/**
+ * Creates a stable, depth-sorted component tree. `project()` deliberately walks parents before
+ * children: a non-projecting intermediate has identity output but preserves its ancestor's scale
+ * in `treeScale`, which is precisely the muggle-through capability required by REQ-LAYOUT-012.
+ *
+ * iOS AUTO SIGABRT campaign: every frame/update path is NON-FATAL on a stale id, an orphaned
+ * path, or torn-down frame input — expected teardown races report once per id per episode into a
+ * bounded ring (drained by the host's severity channel); they never throw on the UI runtime.
+ */
+export declare function createProjectionTree(options: ProjectionTreeOptions): ProjectionTree;

package/dist/layout/tree.d.ts

@@ -0,0 +1,70 @@
+import type { Rect } from "./types.js";
+export type ProjectionStaleNodeCode = 'projection-stale-node' | 'projection-unregistered-node' | 'projection-orphaned-path' | 'projection-invalid-frame-input' | 'projection-invalid-radius-correction' | 'projection-non-finite-output' | 'projection-report-overflow';
+export interface ProjectionStaleNodeReport {
+    readonly source: 'projection-tree';
+    readonly code: ProjectionStaleNodeCode;
+    readonly detail: string;
+}
+export type ProjectionTreeOptions = {
+    readonly onStaleProjectionNode: (report: ProjectionStaleNodeReport) => void;
+} | {
+    readonly delivery: 'drain';
+};
+export interface CorrectedRadius {
+    readonly x: number;
+    readonly y: number;
+}
+export interface ProjectionNodeOutput {
+    readonly translateX: number;
+    readonly translateY: number;
+    readonly scaleX: number;
+    readonly scaleY: number;
+    readonly borderRadius: CorrectedRadius | null;
+    readonly targetDeltaScaleX: number;
+    readonly targetDeltaScaleY: number;
+    readonly treeScaleX: number;
+    readonly treeScaleY: number;
+}
+export interface ProjectionTreeNode {
+    readonly componentId: string;
+    readonly parentId: string | null;
+    readonly depth: number;
+    readonly path: readonly string[];
+    readonly target: Rect | null;
+    readonly treeScaleX: number;
+    readonly treeScaleY: number;
+    readonly output: ProjectionNodeOutput;
+}
+export interface ProjectionTree {
+    register(componentId: string, parentId: string | null, projectionParticipant?: boolean): void;
+    unregister(componentId: string): void;
+    setTarget(componentId: string, target: Rect | null): void;
+    setProjection(componentId: string, source: Rect, target: Rect, progress: number): void;
+    /**
+     * Publish a transform that another native lane already paints on this host. The tree carries
+     * it into descendants but emits only ancestor correction for this node, preventing a layoutId
+     * holder's own FLIP transform from being applied twice.
+     */
+    setDirectProjection(componentId: string, translateX: number, translateY: number, scaleX: number, scaleY: number): void;
+    setHostFrame(componentId: string, currentX: number, currentY: number, currentWidth: number, currentHeight: number, targetX: number, targetY: number, targetWidth: number, targetHeight: number): void;
+    clearProjection(componentId: string): void;
+    setBorderRadius(componentId: string, radius: number | null): void;
+    project(visitor?: (node: ProjectionTreeNode) => void): void;
+    output(componentId: string): ProjectionNodeOutput;
+    /**
+     * Drain the bounded stale-report ring (iOS AUTO SIGABRT campaign): returns and clears every
+     * report recorded since the last drain. A quiet frame returns the shared frozen empty array —
+     * no allocation (REQ-DRIVER-021).
+     */
+    drainStaleReports(): readonly ProjectionStaleNodeReport[];
+}
+/**
+ * Creates a stable, depth-sorted component tree. `project()` deliberately walks parents before
+ * children: a non-projecting intermediate has identity output but preserves its ancestor's scale
+ * in `treeScale`, which is precisely the muggle-through capability required by REQ-LAYOUT-012.
+ *
+ * iOS AUTO SIGABRT campaign: every frame/update path is NON-FATAL on a stale id, an orphaned
+ * path, or torn-down frame input — expected teardown races report once per id per episode into a
+ * bounded ring (drained by the host's severity channel); they never throw on the UI runtime.
+ */
+export declare function createProjectionTree(options: ProjectionTreeOptions): ProjectionTree;