@lingbi/studio 0.3.2 → 0.4.0

package/Application.d.ts

@@ -1,3 +1,4 @@
+import type { ModelResourceSceneSource } from './ModelResourceSceneSource';
 import type { ObjImportResult } from './ObjImportResult';
 import type { ObjImportSource } from './ObjImportSource';
 import type { ObjResourceListSource } from './ObjResourceListSource';
@@ -5,18 +6,34 @@ import type { ObjResourceSceneSource } from './ObjResourceSceneSource';
 import type { ObjSceneSource } from './ObjSceneSource';
 export declare class Application {
     private disposed;
+    private lastPublishedEditState;
+    private lastPublishedInset;
     private renderer;
-    attach(canvas: HTMLCanvasElement): void;
+    private workspace;
+    mount(container: HTMLElement): void;
     importObj(source: ObjImportSource): Promise<ObjImportResult>;
+    importModelResourceScene(source: ModelResourceSceneSource): Promise<ObjImportResult>;
     importObjResources(source: ObjResourceListSource): Promise<ObjImportResult>;
     importObjResourceScene(source: ObjResourceSceneSource): Promise<ObjImportResult>;
     importObjScene(source: ObjSceneSource): Promise<ObjImportResult>;
     resetView(): void;
     takeScreenshot(): Promise<Blob>;
     dispose(): void;
+    private handleEditRequested;
+    private handleEditExited;
     private assertNotDisposed;
     private getRenderer;
-    private releaseRenderer;
+    private hasValidSceneSource;
+    private releaseRuntime;
     private mapObjImportResult;
+    private mapObjImportSource;
+    private mapModelResourceSceneSource;
+    private mapModelResourceListSource;
+    private mapObjResourceSceneSource;
+    private mapObjSceneSource;
+    private mapObjResourceListSource;
+    private mapUpAxis;
+    private mapStoneBasePoseMode;
     private mapAsyncObjImportResult;
+    private mapWarnings;
 }

package/ModelResourceListSource.d.ts

@@ -0,0 +1,5 @@
+import type { ModelUpAxis } from './ModelUpAxis';
+export interface ModelResourceListSource {
+    readonly fileUrls: readonly string[];
+    readonly upAxis?: ModelUpAxis;
+}

package/ModelResourceSceneSource.d.ts

@@ -0,0 +1,14 @@
+import type { ModelResourceListSource } from './ModelResourceListSource';
+import type { StoneBasePoseMode } from './StoneBasePoseMode';
+interface SingleStoneModelResourceSceneSource {
+    readonly base?: never;
+    readonly poseMode?: never;
+    readonly stone: ModelResourceListSource;
+}
+interface StoneBaseModelResourceSceneSource {
+    readonly base: ModelResourceListSource;
+    readonly poseMode: StoneBasePoseMode;
+    readonly stone: ModelResourceListSource;
+}
+export type ModelResourceSceneSource = SingleStoneModelResourceSceneSource | StoneBaseModelResourceSceneSource;
+export {};

package/ModelUpAxis.d.ts

@@ -0,0 +1,4 @@
+export declare enum ModelUpAxis {
+    Y = "y",
+    Z = "z"
+}

package/ObjImportResult.d.ts

@@ -3,7 +3,14 @@ export declare enum ObjImportFailureCode {
     InvalidSource = "invalid-source",
     Unavailable = "unavailable"
 }
+export declare enum ObjImportWarningCode {
+    IncompleteMaterial = "incomplete-material"
+}
+export interface ObjImportWarning {
+    readonly code: ObjImportWarningCode;
+}
 export interface ObjImportResult {
     readonly success: boolean;
     readonly code?: ObjImportFailureCode;
+    readonly warnings?: readonly ObjImportWarning[];
 }

package/ObjImportSource.d.ts

@@ -1,5 +1,7 @@
+import type { ModelUpAxis } from './ModelUpAxis';
 export interface ObjImportSource {
     readonly mtlUrl?: string;
     readonly objUrl: string;
     readonly textureUrls?: Readonly<Record<string, string>>;
+    readonly upAxis?: ModelUpAxis;
 }

package/ObjResourceListSource.d.ts

@@ -1,3 +1,5 @@
+import type { ModelUpAxis } from './ModelUpAxis';
 export interface ObjResourceListSource {
     readonly fileUrls: readonly string[];
+    readonly upAxis?: ModelUpAxis;
 }

package/ObjResourceSceneSource.d.ts

@@ -1,5 +1,14 @@
 import type { ObjResourceListSource } from './ObjResourceListSource';
-export interface ObjResourceSceneSource {
-    readonly stone?: ObjResourceListSource;
-    readonly base?: ObjResourceListSource;
+import type { StoneBasePoseMode } from './StoneBasePoseMode';
+interface SingleStoneObjResourceSceneSource {
+    readonly base?: never;
+    readonly poseMode?: never;
+    readonly stone: ObjResourceListSource;
 }
+interface StoneBaseObjResourceSceneSource {
+    readonly base: ObjResourceListSource;
+    readonly poseMode: StoneBasePoseMode;
+    readonly stone: ObjResourceListSource;
+}
+export type ObjResourceSceneSource = SingleStoneObjResourceSceneSource | StoneBaseObjResourceSceneSource;
+export {};

package/ObjSceneSource.d.ts

@@ -1,5 +1,14 @@
 import type { ObjImportSource } from './ObjImportSource';
-export interface ObjSceneSource {
-    readonly stone?: ObjImportSource;
-    readonly base?: ObjImportSource;
+import type { StoneBasePoseMode } from './StoneBasePoseMode';
+interface SingleStoneObjSceneSource {
+    readonly base?: never;
+    readonly poseMode?: never;
+    readonly stone: ObjImportSource;
 }
+interface StoneBaseObjSceneSource {
+    readonly base: ObjImportSource;
+    readonly poseMode: StoneBasePoseMode;
+    readonly stone: ObjImportSource;
+}
+export type ObjSceneSource = SingleStoneObjSceneSource | StoneBaseObjSceneSource;
+export {};

package/StoneBasePoseMode.d.ts

@@ -0,0 +1,4 @@
+export declare enum StoneBasePoseMode {
+    AutoCorrect = "auto-correct",
+    PreservePose = "preserve-pose"
+}

package/StudioWorkspace.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Studio-owned chrome around the render canvas: the viewport, the bottom
+ * toolbar with its edit control, and the floating edit-status bubble that
+ * appears above it while editing. The workspace renders whatever state
+ * Application forwards; it never inspects models or WebGL objects.
+ */
+export declare class StudioWorkspace {
+    readonly canvas: HTMLCanvasElement;
+    private static readonly EDIT_BUTTON_VIEWPORT_BOTTOM_INSET;
+    private readonly bottomToolbarElement;
+    private readonly editButtonElement;
+    private readonly editStatusElement;
+    private readonly listenerAbortController;
+    private readonly rootElement;
+    private readonly styleElement;
+    constructor(container: HTMLElement, onEditRequested: () => void, onEditExited: () => void);
+    /**
+     * Single entry point that reflects the renderer-owned edit truth onto the
+     * toolbar: viewing shows an inert 编辑 until a dual-model scene enables
+     * it; editing floats a hint bubble with a dedicated exit above it.
+     */
+    setEditButtonState(visible: boolean, enabled: boolean, active: boolean): void;
+    getViewportBottomInset(): number;
+    dispose(): void;
+    private wrapClick;
+}

package/index.d.ts

@@ -1,7 +1,12 @@
 export { Application } from './Application';
+export type { ModelResourceListSource } from './ModelResourceListSource';
+export type { ModelResourceSceneSource } from './ModelResourceSceneSource';
+export { ModelUpAxis } from './ModelUpAxis';
 export type { ObjImportResult } from './ObjImportResult';
-export { ObjImportFailureCode } from './ObjImportResult';
+export type { ObjImportWarning } from './ObjImportResult';
+export { ObjImportFailureCode, ObjImportWarningCode } from './ObjImportResult';
 export type { ObjImportSource } from './ObjImportSource';
 export type { ObjResourceListSource } from './ObjResourceListSource';
 export type { ObjResourceSceneSource } from './ObjResourceSceneSource';
 export type { ObjSceneSource } from './ObjSceneSource';
+export { StoneBasePoseMode } from './StoneBasePoseMode';