@pascal-app/nodes 1.0.0-beta.4 → 1.0.0

package/dist/shared/distribution-run-tool.d.ts

@@ -0,0 +1,107 @@
+import { type AnyNodeId } from '@pascal-app/core';
+import { type DimensionPillPart } from '@pascal-app/editor';
+import { type RefObject } from 'react';
+import { type Group } from 'three';
+import type { RunSurfaceTarget } from './distribution-run-contract';
+import type { RunBodyHit, ScenePort } from './ports';
+import { type RunDirectionMode } from './run-direction-feedback';
+import { type PortScreenPoint } from './run-port-snap';
+export type RunPoint = [number, number, number];
+export type RunSurfaceFrame = {
+    origin: RunPoint;
+    normal: RunPoint;
+    tangent: RunPoint;
+    bitangent: RunPoint;
+};
+export type RunConnection = {
+    port: ScenePort | null;
+    body: RunBodyHit | null;
+};
+export type RunCommitResult = {
+    nextStart: RunPoint;
+    nextConnection: RunConnection;
+};
+export type RunCursorRay = {
+    origin: RunPoint;
+    direction: RunPoint;
+};
+export type CameraDirectionProjection = {
+    point: RunPoint;
+    direction: RunPoint;
+};
+/** Build a stable 2D drawing frame for a floor, wall, ceiling, or sloped face. */
+export declare function createRunSurfaceFrame(origin: readonly number[], surfaceNormal?: readonly number[]): RunSurfaceFrame;
+export declare function projectRunPointToSurface(point: readonly number[], frame: RunSurfaceFrame): RunPoint;
+export declare function snapRunPointToSurface(point: readonly number[], frame: RunSurfaceFrame, step: number): RunPoint;
+export declare function projectRunToSurfaceAngleLock(from: readonly number[], raw: readonly number[], frame: RunSurfaceFrame, sourceDirection?: readonly number[] | null): RunPoint;
+type DistributionRunToolConfig = {
+    active: boolean;
+    levelId: AnyNodeId | null;
+    toolName: 'duct-segment' | 'pipe-segment';
+    initialStart?: RunPoint | null;
+    initialConnection?: RunConnection | null;
+    getPorts: () => ScenePort[];
+    findBody: (point: RunPoint, surface: RunSurfaceTarget | null) => RunBodyHit | null;
+    surfaceClearance?: (surface: RunSurfaceTarget | null) => number;
+    resolveFreeEnd?: (start: RunPoint, end: RunPoint, startConnection: RunConnection) => RunPoint;
+    /** Minimum drawable centerline length, including fitting clearance. */
+    minimumSegmentLength?: number;
+    inheritFromConnection?: (connection: RunConnection) => void;
+    commit: (args: {
+        start: RunPoint;
+        end: RunPoint;
+        startConnection: RunConnection;
+        endConnection: RunConnection;
+        surfaceTarget: RunSurfaceTarget | null;
+    }) => RunCommitResult | null;
+    onShortcut?: (event: KeyboardEvent, start: RunPoint | null) => void;
+};
+export declare const RUN_PREVIEW_OPACITY = 0.55;
+export declare const RUN_SNAP_CURSOR_COLOR = "#22c55e";
+export declare function runSectionHalfSizeM(nominalInches: number): number;
+export declare function snapRunValue(value: number, step: number): number;
+export declare function runDistanceSquared(a: readonly number[], b: readonly number[]): number;
+export declare function projectRunToAngleLock(from: RunPoint, raw: RunPoint, sourceDirection?: readonly [number, number, number] | null): RunPoint;
+export declare function snapRunLength(from: RunPoint, point: RunPoint, step: number): RunPoint;
+export declare function projectRunToDirection(from: RunPoint, raw: RunPoint, direction: readonly [number, number, number]): RunPoint;
+export declare function projectRunToCameraDirection(from: RunPoint, ray: RunCursorRay, sourceDirection: readonly [number, number, number], minimumDistance: number, gridStep: number, candidates?: RunPoint[], surfaceFrame?: RunSurfaceFrame, screen?: {
+    project: (point: RunPoint) => [number, number] | null;
+    pointer: [number, number];
+    previous: RunPoint | null;
+}): CameraDirectionProjection | null;
+export declare function stepNominalRunSize(sizes: readonly number[], current: number, direction: 1 | -1): number;
+export declare function useDistributionRunTool(config: DistributionRunToolConfig): {
+    refreshCursor: () => void;
+    start: RunPoint | null;
+    cursor: RunPoint | null;
+    snapTarget: RunPoint | null;
+    snapScreen: PortScreenPoint | null;
+    altActive: boolean;
+    directionMode: RunDirectionMode;
+    lengthInput: string;
+    validationMessage: string | null;
+    onLengthInputChange: (value: string) => void;
+    onDirectionSelect: (direction: RunPoint) => void;
+    startConnection: RunConnection;
+    endConnection: RunConnection;
+    surfaceTarget: RunSurfaceTarget | null;
+};
+export declare function DistributionRunCursor({ cursor, start, snapTarget, snapScreen, altActive, unit, extraParts, cursorRef, directionMode, startDirection, lengthInput, validationMessage, onLengthInputChange, onDirectionSelect, }: {
+    cursor: RunPoint | null;
+    start: RunPoint | null;
+    snapTarget: RunPoint | null;
+    snapScreen?: PortScreenPoint | null;
+    altActive: boolean;
+    unit: 'metric' | 'imperial';
+    extraParts?: DimensionPillPart[];
+    cursorRef?: RefObject<Group | null>;
+    directionMode: RunDirectionMode;
+    startDirection?: readonly [number, number, number] | null;
+    lengthInput?: string;
+    validationMessage?: string | null;
+    minimumSegmentLength?: number;
+    onLengthInputChange?: (value: string) => void;
+    onDirectionSelect?: (direction: RunPoint) => void;
+}): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=distribution-run-tool.d.ts.map

package/dist/shared/distribution-run-tool.d.ts.map

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