@pascal-app/viewer 0.9.1 → 1.0.0-beta.1

package/README.md

@@ -5,19 +5,19 @@
 ## Installation
 
 ```bash
-npm install @pascal-app/viewer @pascal-app/core
+npm install @pascal-app/core @pascal-app/viewer @pascal-app/editor @pascal-app/nodes
 ```
 
 ## Peer Dependencies
 
 ```bash
-npm install react three @react-three/fiber @react-three/drei
+npm install next react react-dom three @react-three/fiber @react-three/drei lucide-react zustand
 ```
 
 ## What's Included
 
 - **Viewer Component** - WebGPU-powered 3D viewer with camera controls
-- **Node Renderers** - React Three Fiber components for all node types
+- **Node Rendering Runtime** - Registry-driven dispatch for node renderers supplied by `@pascal-app/nodes`
 - **Post-Processing** - SSGI (ambient occlusion + global illumination), TRAA (anti-aliasing), outline effects
 - **Level System** - Level visibility and positioning (stacked/exploded/solo modes)
 - **Wall Cutout System** - Dynamic wall hiding based on camera position
@@ -26,10 +26,22 @@ npm install react three @react-three/fiber @react-three/drei
 ## Usage
 
 ```typescript
-import { Viewer, useViewer } from '@pascal-app/viewer'
-import { useScene } from '@pascal-app/core'
+import { loadPlugin } from '@pascal-app/core'
+import { builtinPlugin } from '@pascal-app/nodes'
+import { Viewer } from '@pascal-app/viewer'
+import { useEffect, useState } from 'react'
+
+const registryReady = loadPlugin(builtinPlugin)
 
 function App() {
+  const [ready, setReady] = useState(false)
+
+  useEffect(() => {
+    void registryReady.then(() => setReady(true))
+  }, [])
+
+  if (!ready) return null
+
   return (
     <div style={{ width: '100vw', height: '100vh' }}>
       <Viewer />
@@ -38,6 +50,9 @@ function App() {
 }
 ```
 
+Load the built-in plugin once, before mounting any viewer. Without it, the registry has no node
+definitions and scene nodes cannot render. Host-provided plugins use the same `loadPlugin` API.
+
 ## Custom Camera Controls
 
 ```typescript

package/dist/components/error-boundary.d.ts

@@ -5,6 +5,11 @@ interface ErrorBoundaryProps {
     fallback: ReactNode;
     /** Tag for log lines so we can tell which boundary swallowed an error. */
     scope?: string;
+    /** Notified once per caught error — lets the host schedule a retry. */
+    onError?: (error: Error) => void;
+    /** Changing this key clears a caught error and re-mounts `children` — the
+     * retry half of `onError` (bump it after clearing whatever failed). */
+    resetKey?: unknown;
 }
 export declare class ErrorBoundary extends Component<ErrorBoundaryProps, {
     hasError: boolean;
@@ -16,6 +21,7 @@ export declare class ErrorBoundary extends Component<ErrorBoundaryProps, {
         hasError: boolean;
     };
     componentDidCatch(error: Error, info: ErrorInfo): void;
+    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
     render(): ReactNode;
 }
 export {};

package/dist/components/error-boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/components/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;IACrF,KAAK;;MAAsB;IAC3B,MAAM,CAAC,wBAAwB;;;IAG/B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS;IAO/C,MAAM;CAGP"}
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/components/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC;2EACuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;IACrF,KAAK;;MAAsB;IAC3B,MAAM,CAAC,wBAAwB;;;IAG/B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS;IAQ/C,kBAAkB,CAAC,SAAS,EAAE,kBAAkB;IAKhD,MAAM;CAGP"}

package/dist/components/error-boundary.js

@@ -6,6 +6,12 @@ export class ErrorBoundary extends Component {
     }
     componentDidCatch(error, info) {
         console.error(`[viewer] ErrorBoundary caught${this.props.scope ? ` (${this.props.scope})` : ''}:`, error, info.componentStack);
+        this.props.onError?.(error);
+    }
+    componentDidUpdate(prevProps) {
+        if (this.state.hasError && prevProps.resetKey !== this.props.resetKey) {
+            this.setState({ hasError: false });
+        }
     }
     render() {
         return this.state.hasError ? this.props.fallback : this.props.children;

package/dist/components/renderers/node-renderer.d.ts

@@ -1,4 +1,8 @@
-import { type AnyNode } from '@pascal-app/core';
+import { type AnyNode, type RendererSource } from '@pascal-app/core';
+import { type ComponentType } from 'react';
+export declare function getRegistryRenderer(source: RendererSource<AnyNode>): ComponentType<{
+    node: AnyNode;
+}> | null;
 export declare const NodeRenderer: ({ nodeId }: {
     nodeId: AnyNode["id"];
 }) => import("react").JSX.Element | null;

package/dist/components/renderers/node-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/renderers/node-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAA+C,MAAM,kBAAkB,CAAA;AAqB5F,eAAO,MAAM,YAAY,GAAI,YAAY;IAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,uCAwBjE,CAAA"}
+{"version":3,"file":"node-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/renderers/node-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,OAAO,EAGZ,KAAK,cAAc,EAEpB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,OAAO,CAAA;AAO1D,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,GAC9B,aAAa,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,IAAI,CASzC;AAED,eAAO,MAAM,YAAY,GAAI,YAAY;IAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,uCA0BjE,CAAA"}

package/dist/components/renderers/node-renderer.js

@@ -1,12 +1,12 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { nodeRegistry, useScene } from '@pascal-app/core';
+import { isNodeKindEnabled, nodeRegistry, useScene, } from '@pascal-app/core';
 import { lazy, Suspense } from 'react';
 import { ParametricNodeRenderer } from './parametric-node-renderer';
 // Cache lazy components by their RendererSource so React.lazy isn't re-invoked
 // on every render — that would create a new Suspense boundary each time.
 const lazyCache = new WeakMap();
-function getRegistryRenderer(source) {
+export function getRegistryRenderer(source) {
     const cached = lazyCache.get(source);
     if (cached)
         return cached;
@@ -20,8 +20,11 @@ function getRegistryRenderer(source) {
 }
 export const NodeRenderer = ({ nodeId }) => {
     const node = useScene((state) => state.nodes[nodeId]);
+    const installedPlugins = useScene((state) => state.installedPlugins);
     if (!node)
         return null;
+    if (!isNodeKindEnabled(node.type, installedPlugins))
+        return null;
     const def = nodeRegistry.get(node.type);
     if (!def)
         return null;

package/dist/components/renderers/parametric-node-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parametric-node-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/renderers/parametric-node-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,OAAO,EAMb,MAAM,kBAAkB,CAAA;AAwCzB,eAAO,MAAM,sBAAsB,GAAI,UAAU;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,gCA4CjE,CAAA"}
+{"version":3,"file":"parametric-node-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/renderers/parametric-node-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,OAAO,EAMb,MAAM,kBAAkB,CAAA;AAwCzB,eAAO,MAAM,sBAAsB,GAAI,UAAU;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,gCAgDjE,CAAA"}

package/dist/components/renderers/parametric-node-renderer.js

@@ -24,11 +24,14 @@ export const ParametricNodeRenderer = ({ node }) => {
     }, [node.id]);
     const position = liveTransform?.position ?? overridePosition ?? n.position ?? [0, 0, 0];
     const rawRotation = overrideRotation ?? n.rotation;
+    const baseRotation = typeof rawRotation === 'number' ? [0, rawRotation, 0] : (rawRotation ?? [0, 0, 0]);
+    // The live transform carries only the plan-view Y rotation; keep the
+    // node's own X/Z so 3D-oriented kinds (e.g. a duct-fitting riser at
+    // X=π/2) don't visually flatten to horizontal mid-drag. Matches the
+    // move tool's commit, which also replaces only the Y component.
     const rotation = liveTransform?.rotation !== undefined
-        ? [0, liveTransform.rotation, 0]
-        : typeof rawRotation === 'number'
-            ? [0, rawRotation, 0]
-            : (rawRotation ?? [0, 0, 0]);
+        ? [baseRotation[0], liveTransform.rotation, baseRotation[2]]
+        : baseRotation;
     return (_jsx("group", { position: position, ref: ref, rotation: rotation, visible: n.visible !== false, ...handlers, children: Array.isArray(n.children) &&
             n.children.map((childId) => (_jsx(NodeRenderer, { nodeId: childId }, `${node.id}:${childId}`))) }));
 };

package/dist/components/viewer/bvh-ecctrl.d.ts

@@ -0,0 +1,77 @@
+import '@react-three/fiber';
+import { type ThreeElements } from '@react-three/fiber';
+import type { ReactNode } from 'react';
+import * as THREE from 'three';
+export type MovementInput = {
+    forward?: boolean;
+    backward?: boolean;
+    leftward?: boolean;
+    rightward?: boolean;
+    joystick?: {
+        x: number;
+        y: number;
+    };
+    run?: boolean;
+    jump?: boolean;
+};
+export type CharacterAnimationStatus = 'IDLE' | 'WALK' | 'RUN' | 'JUMP_START' | 'JUMP_IDLE' | 'JUMP_FALL' | 'JUMP_LAND';
+export type FloatCheckType = 'RAYCAST' | 'SHAPECAST' | 'BOTH';
+export interface BVHEcctrlApi {
+    group: THREE.Group | null;
+    model: THREE.Group | null;
+    resetLinVel: () => void;
+    addLinVel: (v: THREE.Vector3) => void;
+    setLinVel: (v: THREE.Vector3) => void;
+    setMovement: (input: MovementInput) => void;
+}
+export interface EcctrlProps extends Omit<ThreeElements['group'], 'ref'> {
+    children?: ReactNode;
+    debug?: boolean;
+    colliderMeshes?: THREE.Mesh[];
+    colliderCapsuleArgs?: [
+        radius: number,
+        length: number,
+        capSegments: number,
+        radialSegments: number
+    ];
+    paused?: boolean;
+    delay?: number;
+    gravity?: number;
+    fallGravityFactor?: number;
+    maxFallSpeed?: number;
+    mass?: number;
+    sleepTimeout?: number;
+    slowMotionFactor?: number;
+    turnSpeed?: number;
+    maxWalkSpeed?: number;
+    maxRunSpeed?: number;
+    acceleration?: number;
+    deceleration?: number;
+    counterAccFactor?: number;
+    airDragFactor?: number;
+    jumpVel?: number;
+    floatCheckType?: FloatCheckType;
+    maxSlope?: number;
+    floatHeight?: number;
+    floatPullBackHeight?: number;
+    floatSensorRadius?: number;
+    floatSpringK?: number;
+    floatDampingC?: number;
+    collisionCheckIteration?: number;
+    collisionPushBackDamping?: number;
+    collisionPushBackThreshold?: number;
+}
+type CharacterStatus = {
+    position: THREE.Vector3;
+    linvel: THREE.Vector3;
+    quaternion: THREE.Quaternion;
+    inputDir: THREE.Vector3;
+    movingDir: THREE.Vector3;
+    isOnGround: boolean;
+    isOnMovingPlatform: boolean;
+    animationStatus: CharacterAnimationStatus;
+};
+export declare const characterStatus: CharacterStatus;
+declare const BVHEcctrl: import("react").ForwardRefExoticComponent<EcctrlProps & import("react").RefAttributes<BVHEcctrlApi>>;
+export default BVHEcctrl;
+//# sourceMappingURL=bvh-ecctrl.d.ts.map

package/dist/components/viewer/bvh-ecctrl.d.ts.map

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