@nebula-spatial/studio 0.1.0 → 0.1.2

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.
Files changed (50) hide show
  1. package/README.md +2 -0
  2. package/dist/assets/openusd_three_loader-DLiqJWUM.js +13769 -0
  3. package/dist/assets/usd-export-worker-BRxTLqer.js +182 -0
  4. package/dist/assets/usd-worker-DekqMsQv.js +1392 -0
  5. package/dist/{builders-BAXRR5o5.js → builders-lydx4-Rh.js} +1 -1
  6. package/dist/core/session-persistence-controller.d.ts +55 -0
  7. package/dist/doc/placement-policy.d.ts +4 -0
  8. package/dist/editor/editor.d.ts +3 -1
  9. package/dist/editor/index.d.ts +2 -0
  10. package/dist/editor/session-persistence.d.ts +54 -0
  11. package/dist/editor.js +727 -490
  12. package/dist/export-evidence-z2Ne7Trf.js +2387 -0
  13. package/dist/generalization.js +2 -2
  14. package/dist/index.d.ts +4 -2
  15. package/dist/index.js +314 -306
  16. package/dist/mjcf-visual-IOy-ucto.js +72 -0
  17. package/dist/mujoco-runtime-BYZnrvbR.js +467 -0
  18. package/dist/persist/indexeddb-store.d.ts +22 -2
  19. package/dist/persist/session.d.ts +22 -0
  20. package/dist/persist/snapshot.d.ts +24 -0
  21. package/dist/{physics-facts-tfQYyNTD.js → physics-facts-D-URIBrt.js} +8 -7
  22. package/dist/{placement-policy-DY_FNRDu.js → placement-policy-C6dV6Tf-.js} +161 -141
  23. package/dist/ports/persistence.d.ts +45 -1
  24. package/dist/project/contracts.d.ts +3 -0
  25. package/dist/remote-asset-resolver-D-UeyDMD.js +311 -0
  26. package/dist/{scene-graph-DBLKAhxa.js → scene-graph-DVOXjMmp.js} +2 -2
  27. package/dist/scene-session-PhoFXFCY.js +22006 -0
  28. package/dist/scene.js +2 -2
  29. package/dist/session-2bp8YOA4.js +963 -0
  30. package/dist/session-B3WbC7Y2.js +296 -0
  31. package/dist/session-B9kEf4xN.js +915 -0
  32. package/dist/session-DYThdzLZ.js +825 -0
  33. package/dist/studio/index.d.ts +5 -0
  34. package/dist/studio/indexeddb-persistence.d.ts +2 -0
  35. package/dist/studio/indexeddb-session-persistence.d.ts +11 -0
  36. package/dist/studio/scene-package-asset-sources.d.ts +14 -0
  37. package/dist/studio.js +1423 -1220
  38. package/dist/urdf-session-CRXL4bHf.js +1230 -0
  39. package/dist/usd-session-CTzInpNy.js +7385 -0
  40. package/dist/version.d.ts +1 -1
  41. package/dist/view/scene-session.d.ts +5 -1
  42. package/dist/wasm-module-DZn2AM1W.js +13 -0
  43. package/dist/xacro-IpPHTMYs.js +76 -0
  44. package/package.json +1 -1
  45. package/dist/asset-source-BExlEcRt.js +0 -444
  46. package/dist/assets/usd-export-worker-BsGubtAE.js +0 -1
  47. package/dist/editorial-BkAFWfbg.js +0 -83
  48. package/dist/export-evidence-B_0zRmb8.js +0 -5027
  49. package/dist/remote-asset-resolver-Cb8cfNmw.js +0 -136
  50. package/dist/scene-session-BV1HnxNh.js +0 -3506
@@ -1,7 +1,7 @@
1
1
  var Ge = Object.defineProperty;
2
2
  var Be = (i, e, r) => e in i ? Ge(i, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : i[e] = r;
3
3
  var J = (i, e, r) => Be(i, typeof e != "symbol" ? e + "" : e, r);
4
- import { S as fe, A as qe, b as he, G as Ke, a as l, s as y, z as m, L as Ae, l as Ne, B as T, R as z, O as pe, H as ie, w as G, Q as Je, I as B, p as Ye, U as X, M as Ee, a8 as Xe, Y as We, m as Ze, k as oe, c as Qe, X as ei, r as ii } from "./scene-graph-DBLKAhxa.js";
4
+ import { S as fe, A as qe, b as he, G as Ke, a as l, s as y, z as m, L as Ae, l as Ne, B as T, R as z, O as pe, H as ie, w as G, Q as Je, I as B, p as Ye, U as X, M as Ee, a8 as Xe, Y as We, m as Ze, k as oe, c as Qe, X as ei, r as ii } from "./scene-graph-DVOXjMmp.js";
5
5
  const ve = "0123456789ABCDEFGHJKMNPQRSTVWXYZ", ri = 10, ni = 16;
6
6
  let re = -1, Se = [];
7
7
  function L(i = Date.now()) {
@@ -0,0 +1,55 @@
1
+ import type { StudioLoadedSession, StudioSessionPersistenceAdapter, StudioSessionPersistenceConflict, StudioSessionPersistenceSaveMode, StudioSessionPersistenceSaveResult } from '../ports/persistence';
2
+ import type { StudioSessionSnapshot } from '../persist/snapshot';
3
+ export interface StudioSessionPersistenceError {
4
+ readonly code: string;
5
+ readonly message: string;
6
+ }
7
+ export interface StudioSessionPersistenceState {
8
+ readonly available: boolean;
9
+ readonly dirty: boolean;
10
+ readonly saving: boolean;
11
+ readonly lastSavedRevision: string | null;
12
+ readonly lastSavedEtag: string | null;
13
+ readonly lastSavedAt: string | null;
14
+ readonly conflict: StudioSessionPersistenceConflict | null;
15
+ readonly error: StudioSessionPersistenceError | null;
16
+ }
17
+ export interface StudioSessionPersistenceControllerOptions {
18
+ readonly adapter: StudioSessionPersistenceAdapter;
19
+ readonly capture: () => StudioSessionSnapshot;
20
+ readonly currentSignature: () => string;
21
+ readonly autosaveDelayMs?: number;
22
+ readonly now?: () => string;
23
+ readonly createId?: () => string;
24
+ readonly onState?: (state: StudioSessionPersistenceState) => void;
25
+ }
26
+ /**
27
+ * Serializes complete-session saves and exposes optimistic concurrency state.
28
+ * Autosave requests are debounced; checkpoints and publishes join the same
29
+ * serial queue so a later save cannot overtake an in-flight snapshot.
30
+ */
31
+ export declare class StudioSessionPersistenceController {
32
+ private readonly options;
33
+ private state;
34
+ private running;
35
+ private requestedMode;
36
+ private activeSaveController;
37
+ private autosaveTimer;
38
+ private disposed;
39
+ constructor(options: StudioSessionPersistenceControllerOptions);
40
+ getState(): StudioSessionPersistenceState;
41
+ markDirty(): void;
42
+ scheduleAutosave(): void;
43
+ restoreBaseline(session: StudioLoadedSession | null): void;
44
+ clearConflict(): void;
45
+ clearError(): void;
46
+ save(mode?: StudioSessionPersistenceSaveMode): Promise<StudioSessionPersistenceSaveResult>;
47
+ flush(mode?: Extract<StudioSessionPersistenceSaveMode, 'checkpoint' | 'publish'>): Promise<StudioSessionPersistenceSaveResult>;
48
+ retry(mode?: StudioSessionPersistenceSaveMode): Promise<StudioSessionPersistenceSaveResult>;
49
+ cancel(): void;
50
+ dispose(closeAdapter?: boolean): Promise<void>;
51
+ private drain;
52
+ private performSave;
53
+ private clearAutosaveTimer;
54
+ private setState;
55
+ }
@@ -48,6 +48,8 @@ export declare function normalizePlacementPolicy(policy: Partial<StudioPlacement
48
48
  /** Selects a stable, human-readable grid level from the object's largest dimension. */
49
49
  export declare function adaptiveGridStepForBounds(bounds: Vec3Bounds): number;
50
50
  export declare function effectiveGridStep(bounds: Vec3Bounds, policy: Pick<StudioPlacementPolicy, 'gridStepM' | 'adaptiveGridSnap'>): number;
51
+ /** Deterministic XY offsets ordered outward by increasing ring. */
52
+ export declare function placementAvoidanceOffsets(bounds: Vec3Bounds, transform: LocalTransform, clearanceM?: number, maxRings?: number): readonly Vec3[];
51
53
  export declare function isSupportSurfaceNormal(normal: Vec3): boolean;
52
54
  /** Full 15-axis SAT. Face/edge contact is legal; a positive volume intersection is not. */
53
55
  export declare function placementVolumesOverlap(a: StudioPlacementVolume, b: StudioPlacementVolume, tolerance?: number): boolean;
@@ -69,3 +71,5 @@ export declare function supportContactAllowsVolumeOverlap(moved: StudioPlacement
69
71
  /** Checks the complete candidate transaction, including siblings moved in the same batch. */
70
72
  export declare function validatePlacementChanges(before: SceneDocument, after: SceneDocument, policy: StudioPlacementPolicy, measuredBounds?: (node: SceneNode) => Vec3Bounds | null, allowOverlapNodeIds?: ReadonlySet<string>, supportContacts?: readonly StudioSupportContact[]): readonly import('../util/diagnostics').Diagnostic[];
71
73
  export declare function isContainerNode(document: SceneDocument, node: SceneNode): boolean;
74
+ /** Visual-only nodes are renderable but explicitly non-collidable. */
75
+ export declare function isPlacementCollisionNode(node: SceneNode): boolean;
@@ -1,5 +1,5 @@
1
1
  /** UI-independent scene authoring controller. All UI clients share this bridge. */
2
- import type { StudioCommandResult, StudioHost, StudioSelection } from '../core/host';
2
+ import type { StudioCommandResult, StudioBoundingBoxInput, StudioHost, StudioSelection } from '../core/host';
3
3
  import type { CommandRecord } from '../doc/command';
4
4
  import { createAssetNodeFromRevision } from '../doc/builders';
5
5
  import type { LocalTransform, NodePivot, PhysicsOverride, SceneDocument, StudioEditorialState, Vec3 } from '../doc/schema';
@@ -122,6 +122,7 @@ export declare class StudioEditor {
122
122
  captureViewport(options?: import('../view/scene-session').StudioCaptureOptions): Promise<import('../view/scene-session').StudioCaptureResult>;
123
123
  getPlacementPolicy(): StudioPlacementPolicy;
124
124
  setPlacementPolicy(policy: Partial<StudioPlacementPolicy>): void;
125
+ addBoundingBoxPlaceholder(input: StudioBoundingBoxInput): StudioCommandResult;
125
126
  prepareAssetPlacement(input: {
126
127
  readonly revisionId: string;
127
128
  readonly point?: Vec3;
@@ -129,6 +130,7 @@ export declare class StudioEditor {
129
130
  readonly surface?: StudioPlacementSurface | null;
130
131
  readonly parentNodeId?: string;
131
132
  readonly allowOverlap?: boolean;
133
+ readonly autoAvoidOverlap?: boolean;
132
134
  readonly signal?: AbortSignal;
133
135
  }): Promise<StudioAssetPlacementPlan>;
134
136
  commitAssetPlacement(plan: StudioAssetPlacementPlan, input: {
@@ -1,5 +1,7 @@
1
1
  export { StudioEditor, createStudioEditor } from './editor';
2
2
  export type { StudioEditorOptions, StudioAddAssetOptions } from './editor';
3
+ export { captureStudioSessionSnapshot, createStudioSessionPersistence, restoreStudioSessionSnapshot, } from './session-persistence';
4
+ export type { StudioSessionCaptureOptions, StudioSessionPersistenceBinding, StudioSessionPersistenceOptions, StudioSessionRestoreOptions, } from './session-persistence';
3
5
  export type { StudioNodeDisplayOptions, StudioNodeDisplayState, } from '../view/scene-session';
4
6
  export type { StudioNodeFeatureSource, StudioNodeFeatureCapability, StudioNodeCoordinateCapability, StudioNodeFeatures, StudioNodePhysicsVisualization, StudioNodePhysicsVisualizationKey, StudioNodePhysicsVisualizationResult, StudioNodePhysicsVisualizationState, } from '../view/node-features';
5
7
  export type { StudioEffectiveNodeState, StudioNodeCapabilities, StudioSceneTreeNode, StudioSceneTreeSnapshot, } from '../core/scene-tree';
@@ -0,0 +1,54 @@
1
+ import type { StudioHost } from '../core/host';
2
+ import { StudioSessionPersistenceController, type StudioSessionPersistenceState } from '../core/session-persistence-controller';
3
+ import type { StudioLoadedSession, StudioSessionPersistenceAdapter, StudioSessionPersistenceSaveMode, StudioSessionPersistenceSaveResult } from '../ports/persistence';
4
+ import type { StudioAssetSource } from '../ports/asset-source';
5
+ import type { StudioAssetClosureRef, StudioSessionSnapshot } from '../persist/snapshot';
6
+ import type { StudioEditor } from './editor';
7
+ export interface StudioSessionCaptureOptions {
8
+ readonly assetClosure?: () => StudioAssetClosureRef | null;
9
+ }
10
+ export interface StudioSessionRestoreOptions {
11
+ readonly signal?: AbortSignal;
12
+ readonly sources?: readonly StudioAssetSource[];
13
+ }
14
+ export interface StudioSessionPersistenceOptions {
15
+ readonly host: StudioHost;
16
+ readonly editor: StudioEditor;
17
+ readonly adapter: StudioSessionPersistenceAdapter;
18
+ /** Resolve source-provider registrations before opening the document. */
19
+ readonly resolveSources?: (session: StudioLoadedSession, options: {
20
+ readonly signal?: AbortSignal;
21
+ }) => readonly StudioAssetSource[] | Promise<readonly StudioAssetSource[]>;
22
+ readonly assetClosure?: () => StudioAssetClosureRef | null;
23
+ readonly autoRestore?: boolean;
24
+ readonly trackEditorChanges?: boolean;
25
+ readonly autosaveDelayMs?: number;
26
+ readonly now?: () => string;
27
+ readonly createId?: () => string;
28
+ readonly onState?: (state: StudioSessionPersistenceState) => void;
29
+ }
30
+ export interface StudioSessionPersistenceBinding {
31
+ readonly controller: StudioSessionPersistenceController;
32
+ readonly ready: Promise<StudioLoadedSession | null>;
33
+ capture(): StudioSessionSnapshot;
34
+ restore(options?: StudioSessionRestoreOptions): Promise<StudioLoadedSession | null>;
35
+ scheduleAutosave(): void;
36
+ markDirty(): void;
37
+ save(mode?: StudioSessionPersistenceSaveMode): Promise<StudioSessionPersistenceSaveResult>;
38
+ flush(mode?: Extract<StudioSessionPersistenceSaveMode, 'checkpoint' | 'publish'>): Promise<StudioSessionPersistenceSaveResult>;
39
+ retry(mode?: StudioSessionPersistenceSaveMode): Promise<StudioSessionPersistenceSaveResult>;
40
+ dispose(options?: {
41
+ readonly closeAdapter?: boolean;
42
+ }): Promise<void>;
43
+ }
44
+ /**
45
+ * Captures the document and editor-owned view state as one immutable session.
46
+ * Asset closure is a reference only; resource bytes remain provider-owned.
47
+ */
48
+ export declare function captureStudioSessionSnapshot(host: Pick<StudioHost, 'createStateSnapshot'>, editor: Pick<StudioEditor, 'captureEditorialState'>, options?: StudioSessionCaptureOptions): StudioSessionSnapshot;
49
+ /**
50
+ * Applies a loaded session in the only valid order:
51
+ * document -> scene sync -> editorial selection/visibility/camera.
52
+ */
53
+ export declare function restoreStudioSessionSnapshot(host: Pick<StudioHost, 'openSceneText' | 'ready'>, editor: Pick<StudioEditor, 'ready' | 'sync' | 'applyEditorialState'>, snapshot: StudioSessionSnapshot, options?: StudioSessionRestoreOptions): Promise<void>;
54
+ export declare function createStudioSessionPersistence(options: StudioSessionPersistenceOptions): StudioSessionPersistenceBinding;