@nebula-spatial/studio 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +206 -3
- package/dist/ai/contract.d.ts +73 -0
- package/dist/ai/host.d.ts +28 -0
- package/dist/asset/dependency-scan.d.ts +78 -0
- package/dist/asset/intake.d.ts +84 -0
- package/dist/asset/layout-detect.d.ts +40 -0
- package/dist/asset/media-type.d.ts +10 -0
- package/dist/asset/model-inspection.d.ts +127 -0
- package/dist/asset/record.d.ts +35 -0
- package/dist/asset/remote-asset-resolver.d.ts +36 -0
- package/dist/asset/repairs.d.ts +53 -0
- package/dist/asset/resource-locator.d.ts +15 -0
- package/dist/asset/revision-diff.d.ts +33 -0
- package/dist/asset/source-contracts.d.ts +21 -0
- package/dist/asset/source-paths.d.ts +15 -0
- package/dist/asset/usd-inspection.d.ts +39 -0
- package/dist/asset/usd-source-metadata.d.ts +142 -0
- package/dist/asset/visual-intake.d.ts +27 -0
- package/dist/asset/visual-record.d.ts +22 -0
- package/dist/asset/web-intake.d.ts +46 -0
- package/dist/asset-source-BExlEcRt.js +444 -0
- package/dist/assets/openusd_three_loader-DLiqJWUM.js +13769 -0
- package/dist/assets/usd-export-worker-BRxTLqer.js +182 -0
- package/dist/assets/usd-worker-DekqMsQv.js +1392 -0
- package/dist/builders-BAXRR5o5.js +1854 -0
- package/dist/core/asset-task.d.ts +105 -0
- package/dist/core/context.d.ts +23 -0
- package/dist/core/host.d.ts +432 -0
- package/dist/core/persistence-controller.d.ts +58 -0
- package/dist/core/plugins.d.ts +139 -0
- package/dist/core/scene-tree.d.ts +62 -0
- package/dist/core/versions.d.ts +2 -0
- package/dist/core/when.d.ts +13 -0
- package/dist/core/write-policy.d.ts +29 -0
- package/dist/delivery/build-plan.d.ts +2 -0
- package/dist/delivery/contracts.d.ts +362 -0
- package/dist/delivery/digest.d.ts +3 -0
- package/dist/delivery/evidence.d.ts +10 -0
- package/dist/delivery/export-evidence.d.ts +3 -0
- package/dist/delivery/index.d.ts +9 -0
- package/dist/delivery/prim-name.d.ts +17 -0
- package/dist/delivery/profile.d.ts +4 -0
- package/dist/doc/builders.d.ts +99 -0
- package/dist/doc/command.d.ts +195 -0
- package/dist/doc/domain-extensions.d.ts +34 -0
- package/dist/doc/node-facts.d.ts +87 -0
- package/dist/doc/physics-facts.d.ts +74 -0
- package/dist/doc/placement-policy.d.ts +71 -0
- package/dist/doc/random-placement.d.ts +30 -0
- package/dist/doc/scene-graph.d.ts +80 -0
- package/dist/doc/scene-regions.d.ts +29 -0
- package/dist/doc/schema.d.ts +452 -0
- package/dist/doc/task.d.ts +71 -0
- package/dist/doc/validate.d.ts +68 -0
- package/dist/editor/asset-source.d.ts +15 -0
- package/dist/editor/editor.d.ts +246 -0
- package/dist/editor/index.d.ts +22 -0
- package/dist/editor/shortcuts.d.ts +2 -0
- package/dist/editor/types.d.ts +143 -0
- package/dist/editor/ui-plugins.d.ts +64 -0
- package/dist/editor.js +1755 -0
- package/dist/editorial-BkAFWfbg.js +83 -0
- package/dist/export-evidence-DMNRhgL9.js +2705 -0
- package/dist/generalization/domain.d.ts +10 -0
- package/dist/generalization/generalization.d.ts +371 -0
- package/dist/generalization/index.d.ts +11 -0
- package/dist/generalization.js +1659 -0
- package/dist/history/undo-stack.d.ts +74 -0
- package/dist/index.d.ts +91 -0
- package/dist/index.js +2840 -0
- package/dist/mjcf-visual-Bt4bUxd1.js +72 -0
- package/dist/mujoco-runtime-BYZnrvbR.js +467 -0
- package/dist/persist/content-addressed.d.ts +11 -0
- package/dist/persist/create-scene-package-from-host.d.ts +7 -0
- package/dist/persist/indexeddb-store.d.ts +69 -0
- package/dist/persist/scene-file.d.ts +52 -0
- package/dist/persist/scene-package.d.ts +8 -0
- package/dist/persist/snapshot.d.ts +5 -0
- package/dist/physics-facts-tfQYyNTD.js +337 -0
- package/dist/placement-policy-DY_FNRDu.js +405 -0
- package/dist/ports/asset-ingestor.d.ts +41 -0
- package/dist/ports/asset-source.d.ts +57 -0
- package/dist/ports/delivery.d.ts +13 -0
- package/dist/ports/persistence.d.ts +29 -0
- package/dist/project/asset-catalog.d.ts +21 -0
- package/dist/project/contracts.d.ts +272 -0
- package/dist/project/editorial.d.ts +16 -0
- package/dist/project/identity.d.ts +20 -0
- package/dist/project/index.d.ts +9 -0
- package/dist/project/scene-document.d.ts +5 -0
- package/dist/project/source-dependencies.d.ts +7 -0
- package/dist/remote-asset-resolver-Cb8cfNmw.js +136 -0
- package/dist/scene/index.d.ts +12 -0
- package/dist/scene-graph-DBLKAhxa.js +681 -0
- package/dist/scene-session-Cy6vDJ1l.js +21981 -0
- package/dist/scene.js +244 -0
- package/dist/session-BRBrCLdd.js +963 -0
- package/dist/session-DI5tPJxn.js +825 -0
- package/dist/session-q3uuG7OP.js +296 -0
- package/dist/studio/delivery-catalog.d.ts +28 -0
- package/dist/studio/in-memory-asset-source.d.ts +15 -0
- package/dist/studio/index.d.ts +31 -0
- package/dist/studio/indexeddb-asset-source.d.ts +32 -0
- package/dist/studio/indexeddb-persistence.d.ts +13 -0
- package/dist/studio/remote-asset-importer.d.ts +56 -0
- package/dist/studio/source-package.d.ts +9 -0
- package/dist/studio/usd-export-client.d.ts +13 -0
- package/dist/studio/usd-export-protocol.d.ts +98 -0
- package/dist/studio/usd-export-worker.d.ts +1 -0
- package/dist/studio/usd-zip-reader.d.ts +14 -0
- package/dist/studio/web-asset-ingestor.d.ts +10 -0
- package/dist/studio/web-host.d.ts +8 -0
- package/dist/studio.js +5545 -0
- package/dist/urdf-session-CQir2nb2.js +1230 -0
- package/dist/usd-session-DZJnEEOs.js +7385 -0
- package/dist/util/asset-facts.d.ts +3 -0
- package/dist/util/data.d.ts +17 -0
- package/dist/util/diagnostics.d.ts +38 -0
- package/dist/util/geometry.d.ts +11 -0
- package/dist/util/hash.d.ts +9 -0
- package/dist/util/ids.d.ts +20 -0
- package/dist/util/math.d.ts +47 -0
- package/dist/util/ply-metadata.d.ts +19 -0
- package/dist/util/studio-source.d.ts +23 -0
- package/dist/version.d.ts +5 -0
- package/dist/view/appearance.d.ts +13 -0
- package/dist/view/authoring-appearance.d.ts +25 -0
- package/dist/view/bounds-preview.d.ts +34 -0
- package/dist/view/bounds.d.ts +11 -0
- package/dist/view/camera-zoom.d.ts +3 -0
- package/dist/view/geometry-anchors.d.ts +20 -0
- package/dist/view/gizmo-appearance.d.ts +5 -0
- package/dist/view/gizmo.d.ts +81 -0
- package/dist/view/group-selection.d.ts +13 -0
- package/dist/view/node-features.d.ts +39 -0
- package/dist/view/picking.d.ts +49 -0
- package/dist/view/placement.d.ts +48 -0
- package/dist/view/region-editing.d.ts +25 -0
- package/dist/view/rotation-guide.d.ts +36 -0
- package/dist/view/runtime-capabilities.d.ts +22 -0
- package/dist/view/scene-session.d.ts +258 -0
- package/dist/view/screen-bounds.d.ts +17 -0
- package/dist/view/selection-transform.d.ts +20 -0
- package/dist/wasm-module-DZn2AM1W.js +13 -0
- package/dist/xacro-DLRXyk60.js +76 -0
- package/node_modules/@nebula-spatial/cad-loader/CHANGELOG.md +48 -0
- package/node_modules/@nebula-spatial/cad-loader/README.md +108 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/cad-types.d.ts +26 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/errors.d.ts +5 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/index.d.ts +24 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/index.js +2354 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/bin-group-reader.d.ts +9 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/bin-parser.d.ts +78 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/dxbs-sidecar.d.ts +24 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/geometry-segments.d.ts +20 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/text-roundtrip.d.ts +4 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/parser/types.d.ts +81 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/runtime-text-decoder.d.ts +8 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/types.d.ts +153 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/utils/insert-bbox.d.ts +10 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/core/utils/viewport-rect.d.ts +21 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/index.d.ts +36 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/index.js +5829 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/geo-loader.d.ts +59 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/automatic-external-resources.d.ts +26 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/external-variant-sidecar-fetch.d.ts +13 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/flow-control.d.ts +29 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/frame-budget-scheduler.d.ts +21 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-compact-executor.d.ts +19 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-local-adapter.d.ts +2 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-pipeline.d.ts +92 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-loader-worker-adapter.d.ts +13 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node-builder.d.ts +34 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node-load-sink.d.ts +28 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-node.d.ts +304 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare-worker-types.d.ts +94 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare.d.ts +38 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/geo-prepare.worker.d.ts +1 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/insert-model-builder.d.ts +10 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/insert-runtime-geometry.d.ts +15 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/line-canonical.d.ts +37 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/line-quality.d.ts +9 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/prepare-credit-gate.d.ts +20 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/loader/internal/transport.d.ts +2 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/render-resource/cad-render-node.d.ts +80 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/render-resource/geo-node-cad-render-node.d.ts +12 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/scene/geo-cad-line-geometry.d.ts +28 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/scene/geo-cad-line-material.d.ts +18 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/block-geometry-registry.d.ts +35 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/insert-instance-table.d.ts +23 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/scene/instancing/viewport-instance-presenter.d.ts +66 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/selection/cad-insert-selection.d.ts +35 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/selection/cad-text-selection.d.ts +31 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/annotation-idle-gate.d.ts +14 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-document-session.d.ts +187 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-font-runtime.d.ts +11 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-insert-id.d.ts +6 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/cad-text-warmup.d.ts +38 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/create-cad-document-session.d.ts +5 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/load-session.d.ts +90 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/session/viewport-coverage.d.ts +32 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/abort.d.ts +3 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/cad-display-color.d.ts +55 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/cad-load-source.d.ts +8 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/color-buffer.d.ts +6 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/constants.d.ts +11 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/display-color-buffer.d.ts +27 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/errors.d.ts +2 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/text-builder.d.ts +25 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/text-font.d.ts +12 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/types.d.ts +57 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/insert-bbox.d.ts +1 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/timing.d.ts +2 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/utils/viewport-rect.d.ts +1 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/shared/viewer-theme.d.ts +2 -0
- package/node_modules/@nebula-spatial/cad-loader/dist/workers/geo-prepare.worker.js +2264 -0
- package/node_modules/@nebula-spatial/cad-loader/package.json +62 -0
- package/node_modules/@nebula-spatial/viewer/CHANGELOG.md +426 -0
- package/node_modules/@nebula-spatial/viewer/FBX-MATERIAL-CONVERSION.md +97 -0
- package/node_modules/@nebula-spatial/viewer/README.md +1056 -0
- package/node_modules/@nebula-spatial/viewer/USD-VISUAL-MATERIAL-SUPPORT.md +89 -0
- package/node_modules/@nebula-spatial/viewer/basis/basis_transcoder.js +19 -0
- package/node_modules/@nebula-spatial/viewer/basis/basis_transcoder.wasm +0 -0
- package/node_modules/@nebula-spatial/viewer/dist/asset-ir-DEOK9SqE.js +382 -0
- package/node_modules/@nebula-spatial/viewer/dist/assets/ground-grid.d.ts +6 -0
- package/node_modules/@nebula-spatial/viewer/dist/assets/source-types.d.ts +19 -0
- package/node_modules/@nebula-spatial/viewer/dist/assets/types.d.ts +393 -0
- package/node_modules/@nebula-spatial/viewer/dist/assets/usd-worker-Bom5cjz3.js +1392 -0
- package/node_modules/@nebula-spatial/viewer/dist/cad/text.d.ts +2 -0
- package/node_modules/@nebula-spatial/viewer/dist/cad/types.d.ts +368 -0
- package/node_modules/@nebula-spatial/viewer/dist/index-ByBlfVc0.js +12132 -0
- package/node_modules/@nebula-spatial/viewer/dist/index.d.ts +32 -0
- package/node_modules/@nebula-spatial/viewer/dist/index.js +26 -0
- package/node_modules/@nebula-spatial/viewer/dist/inspection/types.d.ts +112 -0
- package/node_modules/@nebula-spatial/viewer/dist/mjcf-visual-DVRa0w90.js +72 -0
- package/node_modules/@nebula-spatial/viewer/dist/mujoco-runtime-Dhx6Ua2u.js +463 -0
- package/node_modules/@nebula-spatial/viewer/dist/plugins.d.ts +179 -0
- package/node_modules/@nebula-spatial/viewer/dist/scene/instances.d.ts +36 -0
- package/node_modules/@nebula-spatial/viewer/dist/scene/types.d.ts +258 -0
- package/node_modules/@nebula-spatial/viewer/dist/session-B-j6KdA-.js +389 -0
- package/node_modules/@nebula-spatial/viewer/dist/session-B4AICTeJ.js +963 -0
- package/node_modules/@nebula-spatial/viewer/dist/session-BAG5cDYe.js +9153 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/mujoco-runtime.d.ts +118 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/mujoco-wasm-module.d.ts +11 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/openusd-wasm-module.d.ts +10 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/physics-runtime-state.d.ts +75 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/types.d.ts +129 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-inspection.d.ts +66 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-query.d.ts +50 -0
- package/node_modules/@nebula-spatial/viewer/dist/simulation/usd-resource-policy.d.ts +28 -0
- package/node_modules/@nebula-spatial/viewer/dist/types.d.ts +278 -0
- package/node_modules/@nebula-spatial/viewer/dist/ui/types.d.ts +48 -0
- package/node_modules/@nebula-spatial/viewer/dist/urdf-session-kemAnBn8.js +3231 -0
- package/node_modules/@nebula-spatial/viewer/dist/usd-session-QtwGKI7v.js +6771 -0
- package/node_modules/@nebula-spatial/viewer/dist/version.d.ts +5 -0
- package/node_modules/@nebula-spatial/viewer/dist/viewer.d.ts +2 -0
- package/node_modules/@nebula-spatial/viewer/dist/xacro-CYTPS7mh.js +1537 -0
- package/node_modules/@nebula-spatial/viewer/openusd/openusd-runtime-manifest.json +15 -0
- package/node_modules/@nebula-spatial/viewer/openusd/openusd_probe.js +14 -0
- package/node_modules/@nebula-spatial/viewer/openusd/openusd_probe.wasm +0 -0
- package/node_modules/@nebula-spatial/viewer/package.json +66 -0
- package/package.json +87 -6
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import type { LocalTransform, SceneAssetNode, SceneDocument, SceneDomainNode, SceneGroupNode, SceneNode, ScenePlaceholderNode, AssetRevision, StudioEditorialState, SceneVisualNode, VisualAssetRevision } from './schema';
|
|
2
|
+
export interface SceneNodeLocation {
|
|
3
|
+
readonly node: SceneNode;
|
|
4
|
+
readonly parent: SceneGroupNode;
|
|
5
|
+
readonly index: number;
|
|
6
|
+
}
|
|
7
|
+
export declare function walkSceneNodes(root: SceneGroupNode): readonly SceneNode[];
|
|
8
|
+
export declare function listSceneAssetNodes(document: SceneDocument): readonly SceneAssetNode[];
|
|
9
|
+
export declare function listSceneVisualNodes(document: SceneDocument): readonly SceneVisualNode[];
|
|
10
|
+
export declare function listScenePlaceholderNodes(document: SceneDocument): readonly ScenePlaceholderNode[];
|
|
11
|
+
export declare function listSceneDomainNodes(document: SceneDocument): readonly SceneDomainNode[];
|
|
12
|
+
export declare function findSceneNode(root: SceneGroupNode, nodeId: string): SceneNode | null;
|
|
13
|
+
export declare function findSceneNodeLocation(root: SceneGroupNode, nodeId: string): SceneNodeLocation | null;
|
|
14
|
+
export declare function sceneNodePath(root: SceneGroupNode, nodeId: string): readonly SceneNode[];
|
|
15
|
+
export declare function effectiveEditorialState(root: SceneGroupNode, nodeId: string, editorial: Readonly<Record<string, StudioEditorialState>>): StudioEditorialState;
|
|
16
|
+
export declare function isSceneNodeEffectivelyVisible(root: SceneGroupNode, nodeId: string, editorial: Readonly<Record<string, StudioEditorialState>>): boolean;
|
|
17
|
+
export declare function isSceneNodeEffectivelyLocked(root: SceneGroupNode, nodeId: string, editorial: Readonly<Record<string, StudioEditorialState>>): boolean;
|
|
18
|
+
export declare function updateSceneNode(root: SceneGroupNode, nodeId: string, update: (node: SceneNode) => SceneNode | null): {
|
|
19
|
+
readonly root: SceneGroupNode;
|
|
20
|
+
readonly node: SceneNode | null;
|
|
21
|
+
};
|
|
22
|
+
export declare function updateSceneAssetNode(root: SceneGroupNode, nodeId: string, update: (node: SceneAssetNode) => SceneAssetNode | null): {
|
|
23
|
+
readonly root: SceneGroupNode;
|
|
24
|
+
readonly node: SceneAssetNode | null;
|
|
25
|
+
};
|
|
26
|
+
export declare function insertSceneNode(root: SceneGroupNode, node: SceneNode, parentNodeId?: string): SceneGroupNode | null;
|
|
27
|
+
export declare function removeSceneNode(root: SceneGroupNode, nodeId: string): {
|
|
28
|
+
readonly root: SceneGroupNode;
|
|
29
|
+
readonly removed: SceneNode | null;
|
|
30
|
+
};
|
|
31
|
+
export declare function collectReferencedRevisionIds(document: SceneDocument): readonly string[];
|
|
32
|
+
export declare function findSceneAssetNode(document: SceneDocument, nodeId: string): SceneAssetNode | null;
|
|
33
|
+
export declare function findSceneVisualNode(document: SceneDocument, nodeId: string): SceneVisualNode | null;
|
|
34
|
+
export declare function findScenePlaceholderNode(document: SceneDocument, nodeId: string): ScenePlaceholderNode | null;
|
|
35
|
+
export declare function findSceneDomainNode(document: SceneDocument, nodeId: string): SceneDomainNode | null;
|
|
36
|
+
export declare function findAssetRevision(document: SceneDocument, revisionId: string): AssetRevision | null;
|
|
37
|
+
export declare function findAssetRevisionByAssetId(document: SceneDocument, assetId: string): AssetRevision | null;
|
|
38
|
+
export declare function assetRevisionForNode(document: SceneDocument, node: SceneAssetNode): AssetRevision | null;
|
|
39
|
+
export declare function findVisualAssetRevision(document: SceneDocument, visualRevisionId: string): VisualAssetRevision | null;
|
|
40
|
+
export declare function findVisualAssetRevisionByAssetId(document: SceneDocument, assetId: string): VisualAssetRevision | null;
|
|
41
|
+
export declare function visualRevisionForNode(document: SceneDocument, node: SceneVisualNode): VisualAssetRevision | null;
|
|
42
|
+
/** Pivot in the node's source-content coordinates. */
|
|
43
|
+
export declare function nodePivotLocal(node: SceneNode): readonly [number, number, number];
|
|
44
|
+
/**
|
|
45
|
+
* Maps source-content coordinates into the node's pivot-root coordinates.
|
|
46
|
+
* This primitive translation is the only content correction required by a
|
|
47
|
+
* SceneNode pivot.
|
|
48
|
+
*/
|
|
49
|
+
export declare function nodeContentTransform(node: SceneNode): LocalTransform;
|
|
50
|
+
/**
|
|
51
|
+
* Moves the pivot while preserving the world transform of existing content.
|
|
52
|
+
* Pivot points are both expressed in the node's source-content coordinates.
|
|
53
|
+
*/
|
|
54
|
+
export declare function transformForPivotChange(transform: LocalTransform, beforePivot: readonly [number, number, number], afterPivot: readonly [number, number, number]): LocalTransform;
|
|
55
|
+
/**
|
|
56
|
+
* Composes parent and child transforms using the same TRS semantics as the
|
|
57
|
+
* USD Xform hierarchy. Non-uniform parent scale plus a rotated child can imply
|
|
58
|
+
* shear that LocalTransform cannot represent; callers that flatten the graph
|
|
59
|
+
* must surface that limitation instead of silently approximating export.
|
|
60
|
+
*/
|
|
61
|
+
export declare function composeLocalTransforms(parent: LocalTransform, child: LocalTransform): LocalTransform;
|
|
62
|
+
export declare class SceneTransformNotRepresentableError extends Error {
|
|
63
|
+
constructor(message: string);
|
|
64
|
+
}
|
|
65
|
+
export declare function tryComposeLocalTransforms(parent: LocalTransform, child: LocalTransform): LocalTransform | null;
|
|
66
|
+
/** Returns the node pivot root's world transform, including the document root. */
|
|
67
|
+
export declare function worldTransformForNode(root: SceneGroupNode, nodeId: string): LocalTransform | null;
|
|
68
|
+
/** Returns the world transform of a node's source-content coordinate frame. */
|
|
69
|
+
export declare function worldContentTransformForNode(root: SceneGroupNode, nodeId: string): LocalTransform | null;
|
|
70
|
+
/** Returns the content-frame world transform of the node's parent group. */
|
|
71
|
+
export declare function parentWorldTransformForNode(root: SceneGroupNode, nodeId: string): LocalTransform | null;
|
|
72
|
+
/** Converts a desired world transform back to a node's parent-local transform. */
|
|
73
|
+
export declare function localTransformFromWorld(world: LocalTransform, parentWorld: LocalTransform): LocalTransform | null;
|
|
74
|
+
export interface NonRepresentableSceneTransform {
|
|
75
|
+
readonly parentNodeId: string;
|
|
76
|
+
readonly nodeId: string;
|
|
77
|
+
}
|
|
78
|
+
export declare function findNonRepresentableSceneTransforms(root: SceneGroupNode): readonly NonRepresentableSceneTransform[];
|
|
79
|
+
/** A subtree mutation must not move, remove or duplicate any locked descendant. */
|
|
80
|
+
export declare function isSceneNodeSubtreeLocked(root: SceneGroupNode, nodeId: string, editorial: Readonly<Record<string, StudioEditorialState>>): boolean;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { LocalTransform } from './schema';
|
|
2
|
+
export type Vec2 = readonly [number, number];
|
|
3
|
+
export type RegionNormalAxis = '+X' | '-X' | '+Y' | '-Y' | '+Z' | '-Z';
|
|
4
|
+
export type RegionShape = {
|
|
5
|
+
readonly kind: 'rectangle';
|
|
6
|
+
readonly widthM: number;
|
|
7
|
+
readonly heightM: number;
|
|
8
|
+
} | {
|
|
9
|
+
readonly kind: 'box';
|
|
10
|
+
readonly widthM: number;
|
|
11
|
+
readonly depthM: number;
|
|
12
|
+
readonly heightM: number;
|
|
13
|
+
} | {
|
|
14
|
+
readonly kind: 'polygon';
|
|
15
|
+
readonly points: readonly Vec2[];
|
|
16
|
+
readonly heightM: number;
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Domain-neutral spatial overlay descriptor. View code renders these records;
|
|
20
|
+
* domain packages own their meaning and mutation semantics.
|
|
21
|
+
*/
|
|
22
|
+
export interface StudioSceneRegionOverlay {
|
|
23
|
+
readonly regionId: string;
|
|
24
|
+
readonly label: string;
|
|
25
|
+
readonly parentNodeId: string;
|
|
26
|
+
readonly frame: LocalTransform;
|
|
27
|
+
readonly shape: RegionShape;
|
|
28
|
+
readonly normalAxis: RegionNormalAxis;
|
|
29
|
+
}
|
|
@@ -0,0 +1,452 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Canonical scene facts shared by editing, persistence, inspection, simulation
|
|
3
|
+
* and export planning.
|
|
4
|
+
*
|
|
5
|
+
* This module is plain data only. Three.js objects, editor state, runtime poses,
|
|
6
|
+
* package plans and generated USD prim paths belong to their owning systems.
|
|
7
|
+
*/
|
|
8
|
+
import type { StudioAssetResourceLocator } from '../util/studio-source';
|
|
9
|
+
export type { StudioAssetResourceLocator } from '../util/studio-source';
|
|
10
|
+
export declare const SCENE_SCHEMA_VERSION: 9;
|
|
11
|
+
export type SceneSchemaVersion = typeof SCENE_SCHEMA_VERSION;
|
|
12
|
+
export declare const ID_PREFIX: {
|
|
13
|
+
readonly scene: "scene_";
|
|
14
|
+
readonly node: "node_";
|
|
15
|
+
readonly asset: "asset_";
|
|
16
|
+
readonly revision: "rev_";
|
|
17
|
+
readonly visualRevision: "vrev_";
|
|
18
|
+
readonly resource: "res_";
|
|
19
|
+
readonly command: "cmd_";
|
|
20
|
+
};
|
|
21
|
+
export type Units = {
|
|
22
|
+
readonly length: 'm';
|
|
23
|
+
readonly mass: 'kg';
|
|
24
|
+
};
|
|
25
|
+
export type UpAxis = 'Z';
|
|
26
|
+
export type ForwardAxis = '+X' | '-X' | '+Y' | '-Y' | '+Z' | '-Z';
|
|
27
|
+
export type Vec3 = readonly [number, number, number];
|
|
28
|
+
/** Quaternion in `[x, y, z, w]` order. */
|
|
29
|
+
export type Quat = readonly [number, number, number, number];
|
|
30
|
+
export interface Vec3Bounds {
|
|
31
|
+
readonly min: Vec3;
|
|
32
|
+
readonly max: Vec3;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Versioned, opaque payload owned by a document domain. The core validates the
|
|
36
|
+
* envelope and delegates payload semantics to the registered domain extension.
|
|
37
|
+
*/
|
|
38
|
+
export interface SceneDocumentDomainPayload {
|
|
39
|
+
readonly dataVersion: number;
|
|
40
|
+
readonly data: unknown;
|
|
41
|
+
}
|
|
42
|
+
export type SceneDocumentDomains = Readonly<Record<string, SceneDocumentDomainPayload>>;
|
|
43
|
+
export interface LocalTransform {
|
|
44
|
+
readonly position: Vec3;
|
|
45
|
+
readonly rotation: Quat;
|
|
46
|
+
readonly scale: Vec3;
|
|
47
|
+
}
|
|
48
|
+
export type Transform = LocalTransform;
|
|
49
|
+
/**
|
|
50
|
+
* Instance-level transform pivot in the node's source-content coordinates.
|
|
51
|
+
*
|
|
52
|
+
* The node root is placed at this pivot. Source content is translated by the
|
|
53
|
+
* inverse pivot before the node TRS is applied. Absence means the source model
|
|
54
|
+
* origin `[0, 0, 0]`.
|
|
55
|
+
*/
|
|
56
|
+
export interface NodePivot {
|
|
57
|
+
readonly local: Vec3;
|
|
58
|
+
}
|
|
59
|
+
/** @deprecated Use the explicit `NodePivot` name. */
|
|
60
|
+
export type NodeOriginIntent = NodePivot;
|
|
61
|
+
export interface CoordinateSystem {
|
|
62
|
+
readonly upAxis: UpAxis;
|
|
63
|
+
readonly forwardAxis: ForwardAxis;
|
|
64
|
+
readonly units: Units;
|
|
65
|
+
readonly origin: Vec3;
|
|
66
|
+
}
|
|
67
|
+
export type InstanceRole = 'actor' | 'object' | 'mechanism' | 'support' | 'environment';
|
|
68
|
+
export declare const INSTANCE_ROLES: readonly InstanceRole[];
|
|
69
|
+
export declare const INSTANCE_ROLE_LABELS: Readonly<Record<InstanceRole, string>>;
|
|
70
|
+
export declare function defaultRoleForCategory(category: string, tags?: readonly string[]): InstanceRole;
|
|
71
|
+
export interface PhysicsMaterialOverride {
|
|
72
|
+
readonly densityKgPerM3?: number;
|
|
73
|
+
readonly staticFriction?: number;
|
|
74
|
+
readonly dynamicFriction?: number;
|
|
75
|
+
readonly restitution?: number;
|
|
76
|
+
}
|
|
77
|
+
export interface PhysicsJointOverride {
|
|
78
|
+
readonly jointPrimPath: string;
|
|
79
|
+
readonly driveType?: 'position' | 'velocity';
|
|
80
|
+
readonly target?: number;
|
|
81
|
+
readonly stiffness?: number;
|
|
82
|
+
readonly damping?: number;
|
|
83
|
+
readonly maxForce?: number;
|
|
84
|
+
}
|
|
85
|
+
interface PhysicsOverrideBase {
|
|
86
|
+
readonly colliderPrimPaths?: readonly string[];
|
|
87
|
+
readonly physicsMaterial?: PhysicsMaterialOverride;
|
|
88
|
+
readonly jointOverrides?: readonly PhysicsJointOverride[];
|
|
89
|
+
}
|
|
90
|
+
export type PhysicsOverride = (PhysicsOverrideBase & {
|
|
91
|
+
readonly kind: 'asset-authored';
|
|
92
|
+
}) | (PhysicsOverrideBase & {
|
|
93
|
+
readonly kind: 'static';
|
|
94
|
+
}) | (PhysicsOverrideBase & {
|
|
95
|
+
readonly kind: 'kinematic';
|
|
96
|
+
}) | (PhysicsOverrideBase & {
|
|
97
|
+
readonly kind: 'dynamic';
|
|
98
|
+
readonly massKg?: number;
|
|
99
|
+
readonly centerOfMassM?: Vec3;
|
|
100
|
+
});
|
|
101
|
+
export interface InitialPose {
|
|
102
|
+
/** Joint name to position (metres for prismatic, radians for revolute). */
|
|
103
|
+
readonly joints: Readonly<Record<string, number>>;
|
|
104
|
+
}
|
|
105
|
+
export interface SceneAppearance {
|
|
106
|
+
/** Linear RGB in 0..1. */
|
|
107
|
+
readonly color?: Vec3;
|
|
108
|
+
readonly opacity?: number;
|
|
109
|
+
readonly metallic?: number;
|
|
110
|
+
readonly roughness?: number;
|
|
111
|
+
}
|
|
112
|
+
/** Editor-only state; never part of the persisted SceneDocument. */
|
|
113
|
+
export interface StudioEditorialState {
|
|
114
|
+
readonly hidden: boolean;
|
|
115
|
+
readonly locked: boolean;
|
|
116
|
+
}
|
|
117
|
+
export type SemanticSource = 'authored' | 'imported' | 'annotated';
|
|
118
|
+
export type SemanticValue = string | number | boolean | null;
|
|
119
|
+
export type SemanticAttributes = Readonly<Record<string, SemanticValue>>;
|
|
120
|
+
export interface ObjectSemantic {
|
|
121
|
+
readonly source: SemanticSource;
|
|
122
|
+
readonly labels?: readonly string[];
|
|
123
|
+
readonly taxonomy?: readonly string[];
|
|
124
|
+
readonly tags?: readonly string[];
|
|
125
|
+
readonly attributes?: SemanticAttributes;
|
|
126
|
+
}
|
|
127
|
+
export interface StudioExternalAssetRef {
|
|
128
|
+
readonly system: string;
|
|
129
|
+
readonly assetId: string;
|
|
130
|
+
readonly versionId?: string;
|
|
131
|
+
}
|
|
132
|
+
export interface SceneAnnotation {
|
|
133
|
+
readonly annotationId: string;
|
|
134
|
+
readonly label: string;
|
|
135
|
+
readonly targetNodeIds: readonly string[];
|
|
136
|
+
readonly kind: string;
|
|
137
|
+
readonly attributes?: SemanticAttributes;
|
|
138
|
+
readonly source: SemanticSource;
|
|
139
|
+
}
|
|
140
|
+
export interface SceneTaskSemantic {
|
|
141
|
+
readonly taskId?: string;
|
|
142
|
+
readonly label: string;
|
|
143
|
+
readonly description?: string;
|
|
144
|
+
readonly tags?: readonly string[];
|
|
145
|
+
readonly source: SemanticSource;
|
|
146
|
+
}
|
|
147
|
+
export interface SceneSemantic {
|
|
148
|
+
readonly source: SemanticSource;
|
|
149
|
+
readonly task?: SceneTaskSemantic;
|
|
150
|
+
readonly taxonomy?: readonly string[];
|
|
151
|
+
readonly annotations?: readonly SceneAnnotation[];
|
|
152
|
+
}
|
|
153
|
+
interface SceneNodeBase {
|
|
154
|
+
readonly nodeId: string;
|
|
155
|
+
readonly label: string;
|
|
156
|
+
/** Pivot-root transform in the parent node's content coordinate system. */
|
|
157
|
+
readonly localTransform: LocalTransform;
|
|
158
|
+
/** Source-content-local pivot. Absence is equivalent to `{ local: [0, 0, 0] }`. */
|
|
159
|
+
readonly origin?: NodePivot;
|
|
160
|
+
}
|
|
161
|
+
export interface SceneGroupNode extends SceneNodeBase {
|
|
162
|
+
readonly nodeType: 'group';
|
|
163
|
+
readonly children: readonly SceneNode[];
|
|
164
|
+
}
|
|
165
|
+
export interface SceneAssetNode extends SceneNodeBase {
|
|
166
|
+
readonly nodeType: 'asset';
|
|
167
|
+
readonly assetRevisionId: string;
|
|
168
|
+
readonly role: InstanceRole;
|
|
169
|
+
readonly visible: boolean;
|
|
170
|
+
readonly variantSelections: Readonly<Record<string, string>>;
|
|
171
|
+
readonly appearance?: SceneAppearance;
|
|
172
|
+
readonly physics: PhysicsOverride;
|
|
173
|
+
readonly initialPose?: InitialPose;
|
|
174
|
+
readonly semantic?: ObjectSemantic;
|
|
175
|
+
}
|
|
176
|
+
export type VisualAssetFormat = 'glb' | 'gltf' | 'fbx' | 'ply-mesh' | 'ply-point-cloud' | 'gaussian-ply' | 'gaussian-spz' | 'gaussian-sog' | 'gaussian-splat' | 'gaussian-ksplat' | 'gaussian-rad';
|
|
177
|
+
export declare const GAUSSIAN_VISUAL_FORMATS: readonly VisualAssetFormat[];
|
|
178
|
+
export interface VisualAssetCapabilities {
|
|
179
|
+
readonly renderable: true;
|
|
180
|
+
readonly collidable: false;
|
|
181
|
+
readonly rigidBody: false;
|
|
182
|
+
readonly articulated: false;
|
|
183
|
+
}
|
|
184
|
+
export interface VisualAssetMetrics {
|
|
185
|
+
readonly splatCount?: number;
|
|
186
|
+
readonly pointCount?: number;
|
|
187
|
+
readonly meshCount?: number;
|
|
188
|
+
readonly byteSize?: number;
|
|
189
|
+
}
|
|
190
|
+
export interface VisualAssetProvenance {
|
|
191
|
+
readonly source: 'builtin' | 'user' | 'import' | 'fixture';
|
|
192
|
+
readonly sourceLabel?: string;
|
|
193
|
+
readonly sourceUrl?: string;
|
|
194
|
+
readonly license?: string;
|
|
195
|
+
readonly importedAt?: string;
|
|
196
|
+
}
|
|
197
|
+
export interface VisualAppearance {
|
|
198
|
+
/** Linear RGB in 0..1. */
|
|
199
|
+
readonly color?: Vec3;
|
|
200
|
+
readonly opacity?: number;
|
|
201
|
+
}
|
|
202
|
+
export interface VisualAssetRevision {
|
|
203
|
+
readonly visualRevisionId: string;
|
|
204
|
+
readonly assetId: string;
|
|
205
|
+
/** Hash of immutable visual facts, excluding provenance timestamps. */
|
|
206
|
+
readonly contentHash: string;
|
|
207
|
+
readonly label: string;
|
|
208
|
+
readonly format: VisualAssetFormat;
|
|
209
|
+
readonly entryResourceId: string;
|
|
210
|
+
readonly resources: readonly AssetResource[];
|
|
211
|
+
readonly capabilities: VisualAssetCapabilities;
|
|
212
|
+
readonly bounds?: Vec3Bounds;
|
|
213
|
+
readonly upAxis: 'y' | 'y-down' | 'z';
|
|
214
|
+
readonly suggestedScale: Vec3;
|
|
215
|
+
readonly metrics?: VisualAssetMetrics;
|
|
216
|
+
readonly provenance: VisualAssetProvenance;
|
|
217
|
+
}
|
|
218
|
+
export type VisualRenderLayer = 'default' | 'foreground' | 'background';
|
|
219
|
+
export type VisualSelectionMode = 'bounds' | 'exact';
|
|
220
|
+
export interface SceneVisualNode extends SceneNodeBase {
|
|
221
|
+
readonly nodeType: 'visual';
|
|
222
|
+
readonly visualRevisionId: string;
|
|
223
|
+
readonly visible: boolean;
|
|
224
|
+
readonly renderLayer: VisualRenderLayer;
|
|
225
|
+
readonly selectionMode: VisualSelectionMode;
|
|
226
|
+
readonly appearance?: VisualAppearance;
|
|
227
|
+
readonly semantic?: ObjectSemantic;
|
|
228
|
+
}
|
|
229
|
+
export interface ScenePlaceholderNode extends SceneNodeBase {
|
|
230
|
+
readonly nodeType: 'placeholder';
|
|
231
|
+
readonly placeholderVersion: 1;
|
|
232
|
+
readonly size: Vec3;
|
|
233
|
+
readonly role: InstanceRole;
|
|
234
|
+
readonly visible: boolean;
|
|
235
|
+
/** Optional binding to a known revision; it does not mount asset bytes. */
|
|
236
|
+
readonly assetRevisionId?: string;
|
|
237
|
+
readonly externalRef?: StudioExternalAssetRef;
|
|
238
|
+
readonly semantic?: ObjectSemantic;
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* Controlled extension node. Domain packages own the payload schema and runtime
|
|
242
|
+
* projection while the core owns identity, hierarchy, selection, commands and
|
|
243
|
+
* persistence.
|
|
244
|
+
*/
|
|
245
|
+
export interface SceneDomainNode extends SceneNodeBase {
|
|
246
|
+
readonly nodeType: 'domain';
|
|
247
|
+
readonly domainId: string;
|
|
248
|
+
readonly dataVersion: number;
|
|
249
|
+
readonly payload: unknown;
|
|
250
|
+
readonly visible: boolean;
|
|
251
|
+
readonly selectable: boolean;
|
|
252
|
+
readonly bounds?: Vec3Bounds;
|
|
253
|
+
readonly semantic?: ObjectSemantic;
|
|
254
|
+
}
|
|
255
|
+
export type SceneNode = SceneGroupNode | SceneAssetNode | SceneVisualNode | ScenePlaceholderNode | SceneDomainNode;
|
|
256
|
+
export type AssetCategory = 'robot' | 'robot_arm' | 'pallet' | 'rack' | 'conveyor' | 'workbench' | 'bin' | 'basket' | 'bottle' | 'package' | 'container' | 'obstacle' | 'ground' | 'other';
|
|
257
|
+
export declare const ASSET_CATEGORIES: readonly AssetCategory[];
|
|
258
|
+
export type AssetLayout = 'simready-package' | 'usdz' | 'single-layer' | 'glb';
|
|
259
|
+
export type AssetFileKind = 'usd' | 'glb';
|
|
260
|
+
export interface AssetResource {
|
|
261
|
+
readonly resourceId: string;
|
|
262
|
+
readonly locator: StudioAssetResourceLocator;
|
|
263
|
+
readonly mediaType: string;
|
|
264
|
+
readonly byteSize: number;
|
|
265
|
+
/** Lower-case SHA-256 of the exact resource bytes. */
|
|
266
|
+
readonly sha256: string;
|
|
267
|
+
}
|
|
268
|
+
export interface AssetVariantSet {
|
|
269
|
+
readonly name: string;
|
|
270
|
+
readonly options: readonly string[];
|
|
271
|
+
readonly authoredDefault?: string;
|
|
272
|
+
}
|
|
273
|
+
export interface AssetCapabilities {
|
|
274
|
+
readonly rendering: 'supported' | 'unknown' | 'unsupported';
|
|
275
|
+
readonly physics: 'authored' | 'none' | 'unknown';
|
|
276
|
+
readonly articulation: boolean;
|
|
277
|
+
readonly rigidBody: boolean;
|
|
278
|
+
readonly colliderGeometry: boolean;
|
|
279
|
+
}
|
|
280
|
+
export interface AssetHints {
|
|
281
|
+
readonly approximateSize?: Vec3;
|
|
282
|
+
readonly defaultRole?: InstanceRole;
|
|
283
|
+
readonly defaultPhysics?: PhysicsOverride;
|
|
284
|
+
readonly forwardAxis?: ForwardAxis;
|
|
285
|
+
readonly tags?: readonly string[];
|
|
286
|
+
}
|
|
287
|
+
export interface AssetMetrics {
|
|
288
|
+
readonly jointCount?: number;
|
|
289
|
+
readonly meshCount?: number;
|
|
290
|
+
}
|
|
291
|
+
export interface AssetSemantic extends ObjectSemantic {
|
|
292
|
+
readonly category?: AssetCategory;
|
|
293
|
+
}
|
|
294
|
+
export interface AssetRepair {
|
|
295
|
+
readonly kind: string;
|
|
296
|
+
readonly detail: string;
|
|
297
|
+
readonly at: string;
|
|
298
|
+
}
|
|
299
|
+
export interface AssetProvenance {
|
|
300
|
+
readonly source: 'builtin' | 'user' | 'import';
|
|
301
|
+
readonly sourceLabel?: string;
|
|
302
|
+
readonly importedAt?: string;
|
|
303
|
+
readonly repairs: readonly AssetRepair[];
|
|
304
|
+
readonly externalRef?: StudioExternalAssetRef;
|
|
305
|
+
}
|
|
306
|
+
export interface AssetRevision {
|
|
307
|
+
readonly revisionId: string;
|
|
308
|
+
readonly assetId: string;
|
|
309
|
+
/** Hash of immutable asset facts, excluding timestamps and provenance. */
|
|
310
|
+
readonly contentHash: string;
|
|
311
|
+
/** URL-safe logical-asset slug used by authoring tools, not scene identity. */
|
|
312
|
+
readonly slug: string;
|
|
313
|
+
readonly label: string;
|
|
314
|
+
readonly layout: AssetLayout;
|
|
315
|
+
readonly fileKind: AssetFileKind;
|
|
316
|
+
readonly entryResourceId: string;
|
|
317
|
+
readonly resources: readonly AssetResource[];
|
|
318
|
+
readonly variantSets: readonly AssetVariantSet[];
|
|
319
|
+
readonly capabilities: AssetCapabilities;
|
|
320
|
+
readonly bounds?: Vec3Bounds;
|
|
321
|
+
readonly category?: AssetCategory;
|
|
322
|
+
readonly hints?: AssetHints;
|
|
323
|
+
readonly metrics?: AssetMetrics;
|
|
324
|
+
readonly semantic?: AssetSemantic;
|
|
325
|
+
readonly provenance: AssetProvenance;
|
|
326
|
+
}
|
|
327
|
+
export type RenderingBackground = {
|
|
328
|
+
readonly kind: 'environment';
|
|
329
|
+
} | {
|
|
330
|
+
readonly kind: 'none';
|
|
331
|
+
} | {
|
|
332
|
+
readonly kind: 'color';
|
|
333
|
+
readonly color: Vec3;
|
|
334
|
+
};
|
|
335
|
+
export interface RenderingEnvironment {
|
|
336
|
+
readonly kind: 'preset' | 'hdr' | 'unknown' | 'unsupported';
|
|
337
|
+
readonly presetId?: string;
|
|
338
|
+
readonly hdrResourceId?: string;
|
|
339
|
+
readonly background: RenderingBackground;
|
|
340
|
+
readonly rotationRadians: number;
|
|
341
|
+
readonly intensity: number;
|
|
342
|
+
}
|
|
343
|
+
export interface PhysicsSolverConfig {
|
|
344
|
+
readonly kind: 'mujoco' | 'physx' | 'unknown' | 'unsupported';
|
|
345
|
+
readonly integrator?: 'euler' | 'implicitfast' | 'rk4';
|
|
346
|
+
readonly solverIterations?: number;
|
|
347
|
+
}
|
|
348
|
+
export interface PhysicsEnvironment {
|
|
349
|
+
readonly gravity: Vec3;
|
|
350
|
+
readonly timeStepSeconds: number;
|
|
351
|
+
readonly solver: PhysicsSolverConfig;
|
|
352
|
+
readonly colliderVisibility?: 'never' | 'selected' | 'always';
|
|
353
|
+
}
|
|
354
|
+
export interface SceneEnvironment {
|
|
355
|
+
readonly rendering: RenderingEnvironment;
|
|
356
|
+
readonly physics: PhysicsEnvironment;
|
|
357
|
+
}
|
|
358
|
+
export interface SceneMeta {
|
|
359
|
+
readonly name: string;
|
|
360
|
+
readonly description?: string;
|
|
361
|
+
readonly createdAt: string;
|
|
362
|
+
readonly updatedAt: string;
|
|
363
|
+
readonly createdBy?: {
|
|
364
|
+
readonly kind: 'human' | 'ai' | 'import';
|
|
365
|
+
readonly ref?: string;
|
|
366
|
+
};
|
|
367
|
+
}
|
|
368
|
+
export interface SceneDocument {
|
|
369
|
+
readonly schemaVersion: SceneSchemaVersion;
|
|
370
|
+
readonly sceneId: string;
|
|
371
|
+
readonly meta: SceneMeta;
|
|
372
|
+
readonly coordinateSystem: CoordinateSystem;
|
|
373
|
+
readonly environment: SceneEnvironment;
|
|
374
|
+
readonly assets: readonly AssetRevision[];
|
|
375
|
+
readonly visualAssets: readonly VisualAssetRevision[];
|
|
376
|
+
readonly root: SceneGroupNode;
|
|
377
|
+
readonly semantic?: SceneSemantic;
|
|
378
|
+
readonly domains?: SceneDocumentDomains;
|
|
379
|
+
readonly extensions?: Readonly<Record<string, unknown>>;
|
|
380
|
+
}
|
|
381
|
+
export declare function createDefaultCoordinateSystem(): CoordinateSystem;
|
|
382
|
+
export declare function createDefaultEnvironment(): SceneEnvironment;
|
|
383
|
+
export declare function createIdentityTransform(): LocalTransform;
|
|
384
|
+
export declare function createSceneGroupNode(options: {
|
|
385
|
+
readonly nodeId: string;
|
|
386
|
+
readonly label: string;
|
|
387
|
+
readonly localTransform?: LocalTransform;
|
|
388
|
+
readonly origin?: NodePivot;
|
|
389
|
+
readonly children?: readonly SceneNode[];
|
|
390
|
+
}): SceneGroupNode;
|
|
391
|
+
export declare function createSceneAssetNode(options: {
|
|
392
|
+
readonly nodeId: string;
|
|
393
|
+
readonly label: string;
|
|
394
|
+
readonly assetRevisionId: string;
|
|
395
|
+
readonly role: InstanceRole;
|
|
396
|
+
readonly localTransform?: LocalTransform;
|
|
397
|
+
readonly origin?: NodePivot;
|
|
398
|
+
readonly visible?: boolean;
|
|
399
|
+
readonly variantSelections?: Readonly<Record<string, string>>;
|
|
400
|
+
readonly appearance?: SceneAppearance;
|
|
401
|
+
readonly physics?: PhysicsOverride;
|
|
402
|
+
readonly initialPose?: InitialPose;
|
|
403
|
+
readonly semantic?: ObjectSemantic;
|
|
404
|
+
}): SceneAssetNode;
|
|
405
|
+
export declare function createSceneVisualNode(options: {
|
|
406
|
+
readonly nodeId: string;
|
|
407
|
+
readonly label: string;
|
|
408
|
+
readonly visualRevisionId: string;
|
|
409
|
+
readonly localTransform?: LocalTransform;
|
|
410
|
+
readonly origin?: NodePivot;
|
|
411
|
+
readonly visible?: boolean;
|
|
412
|
+
readonly renderLayer?: VisualRenderLayer;
|
|
413
|
+
readonly selectionMode?: VisualSelectionMode;
|
|
414
|
+
readonly appearance?: VisualAppearance;
|
|
415
|
+
readonly semantic?: ObjectSemantic;
|
|
416
|
+
}): SceneVisualNode;
|
|
417
|
+
export declare function createScenePlaceholderNode(options: {
|
|
418
|
+
readonly nodeId: string;
|
|
419
|
+
readonly label: string;
|
|
420
|
+
readonly size: Vec3;
|
|
421
|
+
readonly role?: InstanceRole;
|
|
422
|
+
readonly localTransform?: LocalTransform;
|
|
423
|
+
readonly origin?: NodePivot;
|
|
424
|
+
readonly visible?: boolean;
|
|
425
|
+
readonly assetRevisionId?: string;
|
|
426
|
+
readonly externalRef?: StudioExternalAssetRef;
|
|
427
|
+
readonly semantic?: ObjectSemantic;
|
|
428
|
+
}): ScenePlaceholderNode;
|
|
429
|
+
export declare function createSceneDomainNode(options: {
|
|
430
|
+
readonly nodeId: string;
|
|
431
|
+
readonly label: string;
|
|
432
|
+
readonly domainId: string;
|
|
433
|
+
readonly dataVersion: number;
|
|
434
|
+
readonly payload: unknown;
|
|
435
|
+
readonly localTransform?: LocalTransform;
|
|
436
|
+
readonly origin?: NodePivot;
|
|
437
|
+
readonly visible?: boolean;
|
|
438
|
+
readonly selectable?: boolean;
|
|
439
|
+
readonly bounds?: Vec3Bounds;
|
|
440
|
+
readonly semantic?: ObjectSemantic;
|
|
441
|
+
}): SceneDomainNode;
|
|
442
|
+
export interface CreateSceneDocumentOptions {
|
|
443
|
+
readonly sceneId: string;
|
|
444
|
+
readonly name: string;
|
|
445
|
+
readonly description?: string;
|
|
446
|
+
readonly now?: string;
|
|
447
|
+
readonly coordinateSystem?: CoordinateSystem;
|
|
448
|
+
readonly environment?: SceneEnvironment;
|
|
449
|
+
readonly createdBy?: SceneMeta['createdBy'];
|
|
450
|
+
readonly domains?: SceneDocumentDomains;
|
|
451
|
+
}
|
|
452
|
+
export declare function createSceneDocument(options: CreateSceneDocumentOptions): SceneDocument;
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import type { InstanceRole, SceneDocument, Transform } from './schema';
|
|
2
|
+
export declare const WORKFLOW_EXTENSION_KEY = "studio.sim-workflow";
|
|
3
|
+
export interface TaskSlot {
|
|
4
|
+
readonly id: string;
|
|
5
|
+
readonly label: string;
|
|
6
|
+
readonly category: string;
|
|
7
|
+
readonly role: InstanceRole;
|
|
8
|
+
readonly quantity: number;
|
|
9
|
+
readonly tags: readonly string[];
|
|
10
|
+
readonly physics: 'any' | 'collider' | 'rigid-body' | 'articulation';
|
|
11
|
+
readonly maxSizeM?: number;
|
|
12
|
+
}
|
|
13
|
+
export interface TaskContract {
|
|
14
|
+
readonly id: string;
|
|
15
|
+
readonly title: string;
|
|
16
|
+
readonly description: string;
|
|
17
|
+
readonly successCriteria: readonly string[];
|
|
18
|
+
readonly slots: readonly TaskSlot[];
|
|
19
|
+
readonly relations?: readonly TaskRelation[];
|
|
20
|
+
}
|
|
21
|
+
/** Relations belong to this task; they are never intrinsic asset roles. */
|
|
22
|
+
export interface TaskRelation {
|
|
23
|
+
readonly kind: 'acts-on' | 'source' | 'destination' | 'obstacle';
|
|
24
|
+
readonly subjectSlotId: string;
|
|
25
|
+
readonly objectSlotId: string;
|
|
26
|
+
}
|
|
27
|
+
export interface TaskInstanceState {
|
|
28
|
+
readonly obstacle?: boolean;
|
|
29
|
+
/** Written by "生成场景": the instance was laid out from the task, not by hand. */
|
|
30
|
+
readonly generated?: boolean;
|
|
31
|
+
}
|
|
32
|
+
export interface SceneVariant {
|
|
33
|
+
readonly id: string;
|
|
34
|
+
readonly name: string;
|
|
35
|
+
readonly seed: number;
|
|
36
|
+
readonly offsetM: number;
|
|
37
|
+
readonly transforms: Readonly<Record<string, Transform>>;
|
|
38
|
+
}
|
|
39
|
+
/** User annotations are kept apart from capabilities probed from asset files. */
|
|
40
|
+
export interface AssetAnnotation {
|
|
41
|
+
readonly tags?: readonly string[];
|
|
42
|
+
readonly hasPhysics?: boolean;
|
|
43
|
+
readonly hasRigidBody?: boolean;
|
|
44
|
+
readonly hasColliderGeometry?: boolean;
|
|
45
|
+
readonly hasArticulation?: boolean;
|
|
46
|
+
}
|
|
47
|
+
export interface WorkflowState {
|
|
48
|
+
readonly version: 1;
|
|
49
|
+
readonly task: TaskContract | null;
|
|
50
|
+
readonly bindings: Readonly<Record<string, readonly string[]>>;
|
|
51
|
+
readonly variants: readonly SceneVariant[];
|
|
52
|
+
readonly assetAnnotations?: Readonly<Record<string, AssetAnnotation>>;
|
|
53
|
+
readonly instanceStates?: Readonly<Record<string, TaskInstanceState>>;
|
|
54
|
+
}
|
|
55
|
+
export declare function createEmptyWorkflow(): WorkflowState;
|
|
56
|
+
/** Invalid saved extension data never becomes trusted UI or command input. */
|
|
57
|
+
export declare function readWorkflow(doc: SceneDocument): WorkflowState;
|
|
58
|
+
/** Legacy migration is deliberately not part of the normal load path. */
|
|
59
|
+
export declare function normalizeLegacyWorkflow(value: unknown): unknown;
|
|
60
|
+
export declare const TASK_TEMPLATES: readonly {
|
|
61
|
+
readonly id: string;
|
|
62
|
+
readonly title: string;
|
|
63
|
+
readonly description: string;
|
|
64
|
+
readonly task: TaskContract;
|
|
65
|
+
}[];
|
|
66
|
+
/**
|
|
67
|
+
* Local keyword parser for an editable draft; no network or asset generation.
|
|
68
|
+
* A task that names no asset category retains an empty slot list for manual input.
|
|
69
|
+
*/
|
|
70
|
+
export declare function parseTaskDescription(text: string): TaskContract;
|
|
71
|
+
export declare function isWorkflowState(value: unknown): value is WorkflowState;
|