@lingbi/studio 0.5.0 → 0.7.0

package/Application.d.ts

@@ -1,4 +1,5 @@
 import { ImportPerformanceMode } from './ImportPerformanceMode';
+import type { ModelInventoryConfirmationHandler, ModelInventoryHandler } from './ModelInventory';
 import type { ModelResourceSceneSource } from './ModelResourceSceneSource';
 import type { ObjImportResult } from './ObjImportResult';
 export declare class Application {
@@ -15,16 +16,29 @@ export declare class Application {
     private editedArchiveResourceContext;
     private importGeneration;
     private importPerformanceMode;
+    private inventoryConfirmationController;
+    private inventoryConfirming;
+    private inventoryError;
+    private inventorying;
+    private modelInventoryConfirmationHandler;
+    private modelInventoryController;
+    private modelInventoryHandler;
+    private editStatusMessage;
     private lastPublishedInset;
     private lastPublishedToolbarBusinessStateKey;
     private lastPublishedToolbarState;
     private latestRendererWorkspaceState;
     private nextArchiveTaskId;
     private nextDownloadTaskId;
+    private nextInventoryTaskId;
     private renderer;
     private workspace;
     mount(container: HTMLElement): void;
     setImportPerformanceMode(mode: ImportPerformanceMode): void;
+    /** Injects the host-owned business operation used by the inventory button. */
+    setModelInventoryHandler(handler?: ModelInventoryHandler): void;
+    /** Injects the host confirmation shown before inventory preparation starts. */
+    setModelInventoryConfirmationHandler(handler?: ModelInventoryConfirmationHandler): void;
     importModelResourceScene(source: ModelResourceSceneSource): Promise<ObjImportResult>;
     /**
      * Imports one ZIP produced by Studio's download command as a preserved-pose
@@ -36,6 +50,8 @@ export declare class Application {
     takeScreenshot(): Promise<Blob>;
     dispose(): void;
     private cancelDownload;
+    private cancelInventory;
+    private cancelInventoryConfirmation;
     private cancelArchiveImport;
     private completeModelResourceSceneImport;
     private completeEditedArchiveImport;
@@ -52,11 +68,20 @@ export declare class Application {
     private getRenderer;
     private handleDownloadFailure;
     private handleDownloadSuccess;
+    private handleInventoryFailure;
+    private handleInventorySuccess;
     private handleDownloadRequested;
+    private handleInventoryRequested;
+    /** Both call sites validate disposal, handler identity, and scene readiness first. */
+    private startInventory;
+    private confirmInventoryAndStart;
     private handleBooleanRequested;
     private handleModelVisibilityRequested;
     private createExportJobFromCurrentScene;
+    private createInventoryJobFromCurrentScene;
     private handleDownloadStateChanged;
+    private handleInventoryStateChanged;
+    private handleEditOperationBlocked;
     private handleEditExited;
     private handleEditRequested;
     private handleBooleanEditConfirmed;
@@ -77,6 +102,9 @@ export declare class Application {
     private isSameModelVisibility;
     private shouldDeferToolbarState;
     private canDownload;
+    private canInventory;
+    private isInventorySceneReady;
+    private isInventoryVisible;
     private isExportReady;
     private assertNotDisposed;
     private releaseRuntime;

package/ModelInventory.d.ts

@@ -0,0 +1,19 @@
+/** The complete, latest file set for one stone-and-base inventory request. */
+export interface ModelInventoryFiles {
+    readonly base: readonly File[];
+    readonly stone: readonly File[];
+}
+/** Data handed to the host after Studio has prepared the inventory files. */
+export interface ModelInventoryRequest {
+    readonly files: ModelInventoryFiles;
+    /** Aborts when Studio invalidates the in-flight inventory task. */
+    readonly signal: AbortSignal;
+}
+/** Data handed to the host before Studio starts preparing inventory files. */
+export interface ModelInventoryConfirmationRequest {
+    readonly signal: AbortSignal;
+}
+/** Allows the host to confirm an inventory request before any export work starts. */
+export type ModelInventoryConfirmationHandler = (request: ModelInventoryConfirmationRequest) => Promise<boolean>;
+/** Host-owned business operation which receives the prepared files. */
+export type ModelInventoryHandler = (request: ModelInventoryRequest) => Promise<void>;

package/ModelInventoryController.d.ts

@@ -0,0 +1,29 @@
+import type { ExportJobRequest } from './export/ExportJobRequest';
+import type { ModelExportWorkerClientListener } from './export/ModelExportWorkerClientListener';
+import type { ModelExportWorkerFactory } from './export/ModelExportWorkerFactory';
+import type { ModelInventoryHandler } from './ModelInventory';
+/** Owns preparation, collection and host hand-off for one inventory task. */
+export declare class ModelInventoryController implements ModelExportWorkerClientListener {
+    private readonly onInventoryFailed;
+    private readonly onInventorySucceeded;
+    private readonly onInventoryStateChanged;
+    private readonly workerFactory;
+    private activeTask;
+    private disposed;
+    constructor(onInventoryFailed: () => void, onInventorySucceeded: () => void, onInventoryStateChanged: (inProgress: boolean) => void, workerFactory?: ModelExportWorkerFactory);
+    cancel(): void;
+    dispose(): void;
+    reportExportError(_taskId: number, _message: string): void;
+    reportExportProgress(_taskId: number, _completedFileCount: number, _totalFileCount: number): void;
+    start(createJob: () => ExportJobRequest | undefined, handler: ModelInventoryHandler): void;
+    writeZipChunk(taskId: number, chunk: Uint8Array): Promise<void>;
+    private completeTask;
+    private concatenate;
+    private createFiles;
+    private copyBytes;
+    private getMimeType;
+    private run;
+    private isCancelled;
+    private isAbortError;
+    private isCurrentTask;
+}

package/StudioToolbarState.d.ts

@@ -12,6 +12,11 @@ export interface StudioToolbarState {
     readonly editActive: boolean;
     readonly editEnabled: boolean;
     readonly editVisible: boolean;
+    readonly editStatusMessage?: string;
+    readonly inventoryEnabled?: boolean;
+    readonly inventoryError?: string;
+    readonly inventoryInProgress?: boolean;
+    readonly inventoryVisible?: boolean;
     readonly modelVisibility?: {
         readonly baseVisible: boolean;
         readonly enabled: boolean;

package/StudioWorkspace.d.ts

@@ -19,10 +19,14 @@ export declare class StudioWorkspace {
     private readonly booleanEditConfirmationElement;
     private readonly bottomToolbarElement;
     private readonly downloadButtonElement;
+    private readonly downloadButtonWrapperElement;
     private readonly downloadStatusElement;
     private readonly downloadSuccessElement;
     private readonly editButtonElement;
     private readonly editStatusElement;
+    private readonly editStatusTextElement;
+    private readonly inventoryButtonElement;
+    private readonly inventoryButtonWrapperElement;
     private readonly modelButtonElement;
     private readonly modelVisibilityElement;
     private readonly stoneVisibilityButtonElement;
@@ -30,13 +34,18 @@ export declare class StudioWorkspace {
     private readonly listenerAbortController;
     private readonly rootElement;
     private readonly styleElement;
+    private currentEditActive;
     private modelPanelVisible;
-    constructor(container: HTMLElement, onEditRequested: () => void, onEditExited: () => void, onDownloadRequested: () => void, onBooleanRequested?: () => void, onBooleanEditConfirmed?: () => void, onBooleanEditCancelled?: () => void, onModelVisibilityRequested?: (role: StudioModelRole, visible: boolean) => void);
+    constructor(container: HTMLElement, onEditRequested: () => void, onEditExited: () => void, onDownloadRequested: () => void, onBooleanRequested?: () => void, onBooleanEditConfirmed?: () => void, onBooleanEditCancelled?: () => void, onModelVisibilityRequested?: (role: StudioModelRole, visible: boolean) => void, onInventoryRequested?: () => void, onEditOperationBlocked?: () => void);
     /** Applies Application's combined renderer and download state. */
     setToolbarState(state: StudioToolbarState): void;
     getViewportBottomInset(): number;
     dispose(): void;
     private wrapClick;
+    private wrapOperationClick;
+    private wrapOperationKeyDown;
+    private setInventoryButtonVisible;
+    private updateOperationButtonWrapper;
     private toggleModelVisibilityPanel;
     private wrapModelVisibilityClick;
     private updateModelVisibilityButton;

package/THIRD_PARTY_LICENSES.md

@@ -2,6 +2,30 @@
 
 The app bundles dependencies which contain the following licenses:
 
+## fflate - 0.8.3 (MIT)
+
+MIT License
+
+Copyright (c) 2026 Arjun Barrett
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 ## three - 0.185.1 (MIT)
 
 The MIT License

package/index.d.ts

@@ -1,5 +1,6 @@
 export { Application } from './Application';
 export { ImportPerformanceMode } from './ImportPerformanceMode';
+export type { ModelInventoryConfirmationHandler, ModelInventoryConfirmationRequest, ModelInventoryFiles, ModelInventoryHandler, ModelInventoryRequest, } from './ModelInventory';
 export type { ModelResourceListSource } from './ModelResourceListSource';
 export type { ModelResourceSceneSource } from './ModelResourceSceneSource';
 export { ModelUpAxis } from './ModelUpAxis';