@call-me-sensei/toonlab 0.4.21 → 0.4.23

package/types/rockgen/rockDocument.d.ts

@@ -1,35 +1,186 @@
+export function isRockSourceMeshReference(reference: any): boolean;
+/** Deterministic browser-safe identity for the complete saved C8 control/high/semantic authority. */
+export function createC8ReferenceAuthoritySourceId(reference: any): string;
+/** Deterministic browser-safe identity for the exact live C8 control geometry. */
+export function createC8ReferenceGeometrySourceId(reference: any): string;
+/** Surface derivative identity, separate from geometry and explicit about the C7 recipe. */
+export function createC8ReferenceSurfaceSourceId(reference: any): string;
 /**
  * Portable identity for a source-GLB project. Geometry stays outside the JSON
- * document; the document stores only the stable catalog id, deterministic
- * generation/deformation seed, and exact LOD contract needed to rebuild and
- * decode the first-party GLB source.
+ * document; the document stores either the stable catalog id or the exact C8
+ * control/high hashes, plus deterministic edit state needed to rebuild and
+ * decode the source GLB.
  */
 export function createRockReferenceIdentity(options?: any): {
-    archetype: string;
-    catalogVersion: number;
-    family: string;
-    id: string;
-    lodRatios: any;
-    lodTriangles: any;
-    meshEdits: {
-        deltas: any;
-        meshIndex: number;
-    }[];
+    variationSettings?: {
+        version: number;
+        scope: string;
+        anchorBase: boolean;
+        locks: {};
+    };
     role: string;
     series: string;
     sourceMode: string;
-    surfacePackage: {
+    surfacePackage: any;
+    surfaceMode: string;
+    targetTriangles: number;
+    topFinish: any;
+    variation: number;
+    variationSeed: number;
+    authoritySourceId?: string;
+    customMeshSource?: {
+        authority: string;
+        control: {
+            boundsMetres: {
+                max: any[];
+                min: any[];
+            };
+            byteLength: number;
+            contentHash: any;
+            coordinateSystem: string;
+            dimensionsMetres: any[];
+            geometryAudit: {
+                topologyHash: any;
+                meshVertexCounts: any;
+                triangleCount: number;
+                vertexCount: number;
+            };
+            id: string;
+            metreUnitScale: number;
+            mimeType: string;
+            role: any;
+            sourceRevision: number;
+            topologyHash: any;
+            unit: string;
+            uri: string;
+        };
+        editEnvelope: {
+            maximumDisplacementMetres: number;
+            maximumVariationStrength: number;
+            mode: string;
+        };
+        highDetail: {
+            boundsMetres: {
+                max: any[];
+                min: any[];
+            };
+            byteLength: number;
+            contentHash: any;
+            coordinateSystem: string;
+            dimensionsMetres: any[];
+            geometryAudit: {
+                topologyHash: any;
+                meshVertexCounts: any;
+                triangleCount: number;
+                vertexCount: number;
+            };
+            id: string;
+            metreUnitScale: number;
+            mimeType: string;
+            role: any;
+            sourceRevision: number;
+            topologyHash: any;
+            unit: string;
+            uri: string;
+        };
+        schema: string;
+        semanticRegions: {
+            id: string;
+            label: string;
+            landmarkIds: any;
+            role: string;
+            selector: {
+                attribute: string;
+                kind: string;
+                value: number;
+            };
+        }[];
+        version: number;
+    };
+    derivedArtifactState?: {
+        surfaceReprojection: {
+            authoritySourceId: any;
+            contentHash: any;
+            geometrySourceId: any;
+            method: any;
+            sourceRevision: any;
+            status: string;
+            surfaceSourceId: any;
+            trueHighToLowBake: boolean;
+            reason?: undefined;
+        } | {
+            authoritySourceId: any;
+            contentHash: any;
+            geometrySourceId: any;
+            reason: string;
+            sourceRevision: any;
+            status: string;
+            surfaceSourceId: any;
+            trueHighToLowBake: boolean;
+            method?: undefined;
+        };
+    };
+    geology?: string;
+    geometrySourceId?: string;
+    identityLandmarks?: {
+        id: string;
+        positionMetres: any[];
+        role: string;
+    }[];
+    label?: string;
+    sourceRevision?: number;
+    surfaceSourceId?: string;
+    surfaceReprojection?: {
+        reprojectionContentId: string;
+        authoritySourceId: any;
+        controlContentHash: any;
+        dimensionsMetres: any[];
+        editOperationCount: any;
         geology: string;
+        geometrySourceId: any;
         mapResolution: number;
+        method: string;
+        projection: Readonly<{
+            characteristicMetres: number;
+            dimensionsMetres: readonly number[];
+            mode: "world-metre-triplanar-isotropic";
+            nearDetailScaleMetres: number;
+            scaleMetres: number;
+            axisScale: readonly number[];
+            tileSpan: readonly number[];
+        }>;
         schema: string;
         seed: number;
+        sourceContentId: any;
+        sourceId: any;
+        sourceRevision: any;
+        surfaceSourceId: any;
+        trueHighToLowBake: boolean;
         version: number;
     };
-    surfaceMode: string;
-    targetTriangles: number;
-    topFinish: any;
-    variation: number;
-    variationSeed: number;
+    thumbnailUrl?: string;
+    archetype: string;
+    catalogVersion: number;
+    family: string;
+    id: string;
+    lodRatios: any;
+    lodTriangles: any;
+    meshCuts: {
+        depth: number;
+        meshIndex: number;
+        normal: any;
+        point: any;
+        radius: number;
+        roughness: number;
+        seed: number;
+        through: boolean;
+    }[];
+    meshEdits: {
+        deltas: any;
+        meshIndex: any;
+    }[];
+    meshOperationOrder: any[];
+    meshSnapshots: any[];
 };
 /**
  * Creates one rock piece. Accepts a registered piece-preset name, or a
@@ -79,31 +230,175 @@ export function createRockDocument(options?: any): {
     pieces: any[];
     preset: string;
     reference: {
-        archetype: string;
-        catalogVersion: number;
-        family: string;
-        id: string;
-        lodRatios: any;
-        lodTriangles: any;
-        meshEdits: {
-            deltas: any;
-            meshIndex: number;
-        }[];
+        variationSettings?: {
+            version: number;
+            scope: string;
+            anchorBase: boolean;
+            locks: {};
+        };
         role: string;
         series: string;
         sourceMode: string;
-        surfacePackage: {
+        surfacePackage: any;
+        surfaceMode: string;
+        targetTriangles: number;
+        topFinish: any;
+        variation: number;
+        variationSeed: number;
+        authoritySourceId?: string;
+        customMeshSource?: {
+            authority: string;
+            control: {
+                boundsMetres: {
+                    max: any[];
+                    min: any[];
+                };
+                byteLength: number;
+                contentHash: any;
+                coordinateSystem: string;
+                dimensionsMetres: any[];
+                geometryAudit: {
+                    topologyHash: any;
+                    meshVertexCounts: any;
+                    triangleCount: number;
+                    vertexCount: number;
+                };
+                id: string;
+                metreUnitScale: number;
+                mimeType: string;
+                role: any;
+                sourceRevision: number;
+                topologyHash: any;
+                unit: string;
+                uri: string;
+            };
+            editEnvelope: {
+                maximumDisplacementMetres: number;
+                maximumVariationStrength: number;
+                mode: string;
+            };
+            highDetail: {
+                boundsMetres: {
+                    max: any[];
+                    min: any[];
+                };
+                byteLength: number;
+                contentHash: any;
+                coordinateSystem: string;
+                dimensionsMetres: any[];
+                geometryAudit: {
+                    topologyHash: any;
+                    meshVertexCounts: any;
+                    triangleCount: number;
+                    vertexCount: number;
+                };
+                id: string;
+                metreUnitScale: number;
+                mimeType: string;
+                role: any;
+                sourceRevision: number;
+                topologyHash: any;
+                unit: string;
+                uri: string;
+            };
+            schema: string;
+            semanticRegions: {
+                id: string;
+                label: string;
+                landmarkIds: any;
+                role: string;
+                selector: {
+                    attribute: string;
+                    kind: string;
+                    value: number;
+                };
+            }[];
+            version: number;
+        };
+        derivedArtifactState?: {
+            surfaceReprojection: {
+                authoritySourceId: any;
+                contentHash: any;
+                geometrySourceId: any;
+                method: any;
+                sourceRevision: any;
+                status: string;
+                surfaceSourceId: any;
+                trueHighToLowBake: boolean;
+                reason?: undefined;
+            } | {
+                authoritySourceId: any;
+                contentHash: any;
+                geometrySourceId: any;
+                reason: string;
+                sourceRevision: any;
+                status: string;
+                surfaceSourceId: any;
+                trueHighToLowBake: boolean;
+                method?: undefined;
+            };
+        };
+        geology?: string;
+        geometrySourceId?: string;
+        identityLandmarks?: {
+            id: string;
+            positionMetres: any[];
+            role: string;
+        }[];
+        label?: string;
+        sourceRevision?: number;
+        surfaceSourceId?: string;
+        surfaceReprojection?: {
+            reprojectionContentId: string;
+            authoritySourceId: any;
+            controlContentHash: any;
+            dimensionsMetres: any[];
+            editOperationCount: any;
             geology: string;
+            geometrySourceId: any;
             mapResolution: number;
+            method: string;
+            projection: Readonly<{
+                characteristicMetres: number;
+                dimensionsMetres: readonly number[];
+                mode: "world-metre-triplanar-isotropic";
+                nearDetailScaleMetres: number;
+                scaleMetres: number;
+                axisScale: readonly number[];
+                tileSpan: readonly number[];
+            }>;
             schema: string;
             seed: number;
+            sourceContentId: any;
+            sourceId: any;
+            sourceRevision: any;
+            surfaceSourceId: any;
+            trueHighToLowBake: boolean;
             version: number;
         };
-        surfaceMode: string;
-        targetTriangles: number;
-        topFinish: any;
-        variation: number;
-        variationSeed: number;
+        thumbnailUrl?: string;
+        archetype: string;
+        catalogVersion: number;
+        family: string;
+        id: string;
+        lodRatios: any;
+        lodTriangles: any;
+        meshCuts: {
+            depth: number;
+            meshIndex: number;
+            normal: any;
+            point: any;
+            radius: number;
+            roughness: number;
+            seed: number;
+            through: boolean;
+        }[];
+        meshEdits: {
+            deltas: any;
+            meshIndex: any;
+        }[];
+        meshOperationOrder: any[];
+        meshSnapshots: any[];
     };
     revision: number;
     schemaVersion: number;
@@ -124,31 +419,175 @@ export function rebaseRockDocumentStyle(document: any, style?: string): {
     pieces: any[];
     preset: string;
     reference: {
-        archetype: string;
-        catalogVersion: number;
-        family: string;
-        id: string;
-        lodRatios: any;
-        lodTriangles: any;
-        meshEdits: {
-            deltas: any;
-            meshIndex: number;
-        }[];
+        variationSettings?: {
+            version: number;
+            scope: string;
+            anchorBase: boolean;
+            locks: {};
+        };
         role: string;
         series: string;
         sourceMode: string;
-        surfacePackage: {
+        surfacePackage: any;
+        surfaceMode: string;
+        targetTriangles: number;
+        topFinish: any;
+        variation: number;
+        variationSeed: number;
+        authoritySourceId?: string;
+        customMeshSource?: {
+            authority: string;
+            control: {
+                boundsMetres: {
+                    max: any[];
+                    min: any[];
+                };
+                byteLength: number;
+                contentHash: any;
+                coordinateSystem: string;
+                dimensionsMetres: any[];
+                geometryAudit: {
+                    topologyHash: any;
+                    meshVertexCounts: any;
+                    triangleCount: number;
+                    vertexCount: number;
+                };
+                id: string;
+                metreUnitScale: number;
+                mimeType: string;
+                role: any;
+                sourceRevision: number;
+                topologyHash: any;
+                unit: string;
+                uri: string;
+            };
+            editEnvelope: {
+                maximumDisplacementMetres: number;
+                maximumVariationStrength: number;
+                mode: string;
+            };
+            highDetail: {
+                boundsMetres: {
+                    max: any[];
+                    min: any[];
+                };
+                byteLength: number;
+                contentHash: any;
+                coordinateSystem: string;
+                dimensionsMetres: any[];
+                geometryAudit: {
+                    topologyHash: any;
+                    meshVertexCounts: any;
+                    triangleCount: number;
+                    vertexCount: number;
+                };
+                id: string;
+                metreUnitScale: number;
+                mimeType: string;
+                role: any;
+                sourceRevision: number;
+                topologyHash: any;
+                unit: string;
+                uri: string;
+            };
+            schema: string;
+            semanticRegions: {
+                id: string;
+                label: string;
+                landmarkIds: any;
+                role: string;
+                selector: {
+                    attribute: string;
+                    kind: string;
+                    value: number;
+                };
+            }[];
+            version: number;
+        };
+        derivedArtifactState?: {
+            surfaceReprojection: {
+                authoritySourceId: any;
+                contentHash: any;
+                geometrySourceId: any;
+                method: any;
+                sourceRevision: any;
+                status: string;
+                surfaceSourceId: any;
+                trueHighToLowBake: boolean;
+                reason?: undefined;
+            } | {
+                authoritySourceId: any;
+                contentHash: any;
+                geometrySourceId: any;
+                reason: string;
+                sourceRevision: any;
+                status: string;
+                surfaceSourceId: any;
+                trueHighToLowBake: boolean;
+                method?: undefined;
+            };
+        };
+        geology?: string;
+        geometrySourceId?: string;
+        identityLandmarks?: {
+            id: string;
+            positionMetres: any[];
+            role: string;
+        }[];
+        label?: string;
+        sourceRevision?: number;
+        surfaceSourceId?: string;
+        surfaceReprojection?: {
+            reprojectionContentId: string;
+            authoritySourceId: any;
+            controlContentHash: any;
+            dimensionsMetres: any[];
+            editOperationCount: any;
             geology: string;
+            geometrySourceId: any;
             mapResolution: number;
+            method: string;
+            projection: Readonly<{
+                characteristicMetres: number;
+                dimensionsMetres: readonly number[];
+                mode: "world-metre-triplanar-isotropic";
+                nearDetailScaleMetres: number;
+                scaleMetres: number;
+                axisScale: readonly number[];
+                tileSpan: readonly number[];
+            }>;
             schema: string;
             seed: number;
+            sourceContentId: any;
+            sourceId: any;
+            sourceRevision: any;
+            surfaceSourceId: any;
+            trueHighToLowBake: boolean;
             version: number;
         };
-        surfaceMode: string;
-        targetTriangles: number;
-        topFinish: any;
-        variation: number;
-        variationSeed: number;
+        thumbnailUrl?: string;
+        archetype: string;
+        catalogVersion: number;
+        family: string;
+        id: string;
+        lodRatios: any;
+        lodTriangles: any;
+        meshCuts: {
+            depth: number;
+            meshIndex: number;
+            normal: any;
+            point: any;
+            radius: number;
+            roughness: number;
+            seed: number;
+            through: boolean;
+        }[];
+        meshEdits: {
+            deltas: any;
+            meshIndex: any;
+        }[];
+        meshOperationOrder: any[];
+        meshSnapshots: any[];
     };
     revision: number;
     schemaVersion: number;
@@ -197,31 +636,175 @@ export function deserializeRockDocument(jsonOrObject: any): {
     pieces: any[];
     preset: string;
     reference: {
-        archetype: string;
-        catalogVersion: number;
-        family: string;
-        id: string;
-        lodRatios: any;
-        lodTriangles: any;
-        meshEdits: {
-            deltas: any;
-            meshIndex: number;
-        }[];
+        variationSettings?: {
+            version: number;
+            scope: string;
+            anchorBase: boolean;
+            locks: {};
+        };
         role: string;
         series: string;
         sourceMode: string;
-        surfacePackage: {
+        surfacePackage: any;
+        surfaceMode: string;
+        targetTriangles: number;
+        topFinish: any;
+        variation: number;
+        variationSeed: number;
+        authoritySourceId?: string;
+        customMeshSource?: {
+            authority: string;
+            control: {
+                boundsMetres: {
+                    max: any[];
+                    min: any[];
+                };
+                byteLength: number;
+                contentHash: any;
+                coordinateSystem: string;
+                dimensionsMetres: any[];
+                geometryAudit: {
+                    topologyHash: any;
+                    meshVertexCounts: any;
+                    triangleCount: number;
+                    vertexCount: number;
+                };
+                id: string;
+                metreUnitScale: number;
+                mimeType: string;
+                role: any;
+                sourceRevision: number;
+                topologyHash: any;
+                unit: string;
+                uri: string;
+            };
+            editEnvelope: {
+                maximumDisplacementMetres: number;
+                maximumVariationStrength: number;
+                mode: string;
+            };
+            highDetail: {
+                boundsMetres: {
+                    max: any[];
+                    min: any[];
+                };
+                byteLength: number;
+                contentHash: any;
+                coordinateSystem: string;
+                dimensionsMetres: any[];
+                geometryAudit: {
+                    topologyHash: any;
+                    meshVertexCounts: any;
+                    triangleCount: number;
+                    vertexCount: number;
+                };
+                id: string;
+                metreUnitScale: number;
+                mimeType: string;
+                role: any;
+                sourceRevision: number;
+                topologyHash: any;
+                unit: string;
+                uri: string;
+            };
+            schema: string;
+            semanticRegions: {
+                id: string;
+                label: string;
+                landmarkIds: any;
+                role: string;
+                selector: {
+                    attribute: string;
+                    kind: string;
+                    value: number;
+                };
+            }[];
+            version: number;
+        };
+        derivedArtifactState?: {
+            surfaceReprojection: {
+                authoritySourceId: any;
+                contentHash: any;
+                geometrySourceId: any;
+                method: any;
+                sourceRevision: any;
+                status: string;
+                surfaceSourceId: any;
+                trueHighToLowBake: boolean;
+                reason?: undefined;
+            } | {
+                authoritySourceId: any;
+                contentHash: any;
+                geometrySourceId: any;
+                reason: string;
+                sourceRevision: any;
+                status: string;
+                surfaceSourceId: any;
+                trueHighToLowBake: boolean;
+                method?: undefined;
+            };
+        };
+        geology?: string;
+        geometrySourceId?: string;
+        identityLandmarks?: {
+            id: string;
+            positionMetres: any[];
+            role: string;
+        }[];
+        label?: string;
+        sourceRevision?: number;
+        surfaceSourceId?: string;
+        surfaceReprojection?: {
+            reprojectionContentId: string;
+            authoritySourceId: any;
+            controlContentHash: any;
+            dimensionsMetres: any[];
+            editOperationCount: any;
             geology: string;
+            geometrySourceId: any;
             mapResolution: number;
+            method: string;
+            projection: Readonly<{
+                characteristicMetres: number;
+                dimensionsMetres: readonly number[];
+                mode: "world-metre-triplanar-isotropic";
+                nearDetailScaleMetres: number;
+                scaleMetres: number;
+                axisScale: readonly number[];
+                tileSpan: readonly number[];
+            }>;
             schema: string;
             seed: number;
+            sourceContentId: any;
+            sourceId: any;
+            sourceRevision: any;
+            surfaceSourceId: any;
+            trueHighToLowBake: boolean;
             version: number;
         };
-        surfaceMode: string;
-        targetTriangles: number;
-        topFinish: any;
-        variation: number;
-        variationSeed: number;
+        thumbnailUrl?: string;
+        archetype: string;
+        catalogVersion: number;
+        family: string;
+        id: string;
+        lodRatios: any;
+        lodTriangles: any;
+        meshCuts: {
+            depth: number;
+            meshIndex: number;
+            normal: any;
+            point: any;
+            radius: number;
+            roughness: number;
+            seed: number;
+            through: boolean;
+        }[];
+        meshEdits: {
+            deltas: any;
+            meshIndex: any;
+        }[];
+        meshOperationOrder: any[];
+        meshSnapshots: any[];
     };
     revision: number;
     schemaVersion: number;
@@ -234,10 +817,10 @@ export function deserializeRockDocument(jsonOrObject: any): {
 /** Document type tag stamped on saved rockgen project JSON. */
 export const ROCKGEN_PROJECT_DOCUMENT_TYPE: "toonlab/rockgen-project";
 /** Current schema version for rockgen project documents. */
-export const ROCKGEN_PROJECT_SCHEMA_VERSION: 6;
-/** Sparse source-mesh edits are packed into the portable document so normal
- * sculpting remains below the hosted creation-document limit. Runtime state
- * is still the convenient array form consumed by the editor and compiler. */
+export const ROCKGEN_PROJECT_SCHEMA_VERSION: 9;
+/** Legacy MCP request budgets. The interactive Rock Lab editor no longer uses
+ * these as sculpt, drill, persistence, or replay ceilings. */
 export const ROCKGEN_MAX_MESH_EDIT_OPERATIONS: 200;
 export const ROCKGEN_MAX_MESH_EDIT_DELTAS: 10000;
+export const ROCKGEN_MAX_MESH_CUT_OPERATIONS: 64;
 export const ROCKGEN_MESH_EDIT_ENCODING: "base64-f32le-v1";