@dcl/sdk-commands 7.12.1-18948473009.commit-a279e87 → 7.12.1-18976734253.commit-271785b

package/dist/commands/code-to-composite/asset-migrator.d.ts

@@ -0,0 +1,25 @@
+import { IEngine } from '@dcl/ecs/dist-cjs';
+import { CliComponents } from '../../components';
+import { SceneProject } from '../../logic/project-validations';
+/**
+ * Asset Migrator for code-to-composite command
+ *
+ * This module handles migrating asset files to the Creator Hub directory structure:
+ * - Models: assets/scene/Models/{modelName}/*.{gltf,glb} (with dependencies)
+ * - Images: assets/scene/Images/*.{png,jpg,jpeg,bmp}
+ * - Audio: assets/scene/Audio/*.{mp3,wav,ogg}
+ * - Video: assets/scene/Video/*.{mp4}
+ *
+ * Models are treated specially: each model gets its own folder with all dependencies
+ * (textures, .bin files) copied into it, even if originally shared between models.
+ */
+export type AssetType = 'Models' | 'Images' | 'Audio' | 'Video' | 'Other';
+/**
+ * Main asset migration function
+ *
+ * Process:
+ * 1. Scan all components to find asset references
+ * 2. Copy asset files to new Creator Hub structure
+ * 3. Update all components with new asset paths
+ */
+export declare function migrateAssets(components: Pick<CliComponents, 'fs' | 'logger'>, project: SceneProject, engine: IEngine): Promise<number>;

package/dist/commands/code-to-composite/asset-migrator.js

@@ -0,0 +1,239 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateAssets = void 0;
+const path_1 = __importDefault(require("path"));
+const gltf_validator_ts_1 = require("@dcl/gltf-validator-ts");
+/**
+ * Determines the asset type based on file extension
+ */
+function getAssetType(extension) {
+    const ext = extension.toLowerCase().replace(/^\./, '');
+    switch (ext) {
+        case 'gltf':
+        case 'glb':
+            return 'Models';
+        case 'png':
+        case 'jpg':
+        case 'jpeg':
+        case 'bmp':
+            return 'Images';
+        case 'mp3':
+        case 'wav':
+        case 'ogg':
+            return 'Audio';
+        case 'mp4':
+            return 'Video';
+        default:
+            return 'Other';
+    }
+}
+/**
+ * Checks if a string value looks like an asset path
+ */
+function looksLikeAssetPath(value) {
+    if (typeof value !== 'string' || value.length === 0) {
+        return false;
+    }
+    const ext = path_1.default.extname(value);
+    if (!ext) {
+        return false;
+    }
+    return getAssetType(ext) !== 'Other';
+}
+/**
+ * Extracts dependencies from a GLTF file using @dcl/gltf-validator-ts
+ */
+async function extractGltfDependencies(components, gltfPath) {
+    const { fs, logger } = components;
+    const dependencies = {
+        textures: [],
+        binaries: []
+    };
+    try {
+        const gltfBuffer = await fs.readFile(gltfPath);
+        const result = await (0, gltf_validator_ts_1.validateBytes)(new Uint8Array(gltfBuffer), {
+            externalResourceFunction: () => Promise.resolve(new Uint8Array())
+        });
+        if (result.info && result.info.resources) {
+            for (const resource of result.info.resources) {
+                if (resource.storage === 'external' && resource.uri) {
+                    const uri = resource.uri;
+                    if (resource.pointer && resource.pointer.includes('image')) {
+                        dependencies.textures.push(uri);
+                    }
+                    else if (resource.pointer && resource.pointer.includes('buffer')) {
+                        dependencies.binaries.push(uri);
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        logger.error(`  ⚠  Failed to extract dependencies from GLTF "${gltfPath}": ${error}`);
+    }
+    return dependencies;
+}
+/**
+ * Builds the destination path following Creator Hub conventions
+ */
+function getDestinationPath(sceneRoot, originalPath) {
+    const fileName = path_1.default.basename(originalPath);
+    const extension = path_1.default.extname(originalPath);
+    const assetType = getAssetType(extension);
+    if (assetType === 'Models') {
+        // Models get their own folder: assets/scene/Models/{modelName}/file.glb
+        const modelName = path_1.default.basename(originalPath, extension);
+        return path_1.default.join(sceneRoot, 'assets', 'scene', 'Models', modelName, fileName);
+    }
+    // Other assets go directly in type folder: assets/scene/Images/file.png
+    return path_1.default.join(sceneRoot, 'assets', 'scene', assetType, fileName);
+}
+/**
+ * Recursively finds all asset paths in component data
+ */
+function collectAssetPaths(data, assetPaths) {
+    if (data === null || data === undefined) {
+        return;
+    }
+    if (typeof data === 'string') {
+        if (looksLikeAssetPath(data)) {
+            assetPaths.add(data);
+        }
+        return;
+    }
+    if (Array.isArray(data)) {
+        for (const item of data) {
+            collectAssetPaths(item, assetPaths);
+        }
+        return;
+    }
+    if (typeof data === 'object') {
+        for (const value of Object.values(data)) {
+            collectAssetPaths(value, assetPaths);
+        }
+    }
+}
+/**
+ * Recursively replaces asset paths in component data
+ * Returns an object with the updated data and a flag indicating if changes were made
+ */
+function replaceAssetPaths(data, pathMapping) {
+    if (data === null || data === undefined) {
+        return { data, hasChanges: false };
+    }
+    if (typeof data === 'string') {
+        const newPath = pathMapping.get(data);
+        if (newPath !== undefined) {
+            return { data: newPath, hasChanges: true };
+        }
+        return { data, hasChanges: false };
+    }
+    if (Array.isArray(data)) {
+        let hasChanges = false;
+        const result = data.map((item) => {
+            const replaced = replaceAssetPaths(item, pathMapping);
+            if (replaced.hasChanges)
+                hasChanges = true;
+            return replaced.data;
+        });
+        return { data: result, hasChanges };
+    }
+    if (typeof data === 'object') {
+        let hasChanges = false;
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            const replaced = replaceAssetPaths(value, pathMapping);
+            if (replaced.hasChanges)
+                hasChanges = true;
+            result[key] = replaced.data;
+        }
+        return { data: result, hasChanges };
+    }
+    return { data, hasChanges: false };
+}
+/**
+ * Main asset migration function
+ *
+ * Process:
+ * 1. Scan all components to find asset references
+ * 2. Copy asset files to new Creator Hub structure
+ * 3. Update all components with new asset paths
+ */
+async function migrateAssets(components, project, engine) {
+    const { fs, logger } = components;
+    const sceneRoot = project.workingDirectory;
+    // Step 1: find all asset paths in the engine
+    const assetPaths = new Set();
+    for (const component of engine.componentsIter()) {
+        for (const [entity] of engine.getEntitiesWith(component)) {
+            const componentData = component.get(entity);
+            if (componentData) {
+                collectAssetPaths(componentData, assetPaths);
+            }
+        }
+    }
+    if (assetPaths.size === 0) {
+        logger.log('No assets found to migrate');
+        return 0;
+    }
+    logger.log(`Found ${assetPaths.size} asset reference(s)`);
+    // Step 2: copy files to new locations
+    const pathMapping = new Map();
+    for (const originalPath of assetPaths) {
+        const absoluteOriginalPath = path_1.default.isAbsolute(originalPath) ? originalPath : path_1.default.join(sceneRoot, originalPath);
+        if (!(await fs.fileExists(absoluteOriginalPath))) {
+            logger.warn(`  ⚠  Asset not found: ${originalPath}`);
+            continue;
+        }
+        const assetType = getAssetType(path_1.default.extname(originalPath));
+        const newAbsolutePath = getDestinationPath(sceneRoot, originalPath);
+        const newRelativePath = path_1.default.relative(sceneRoot, newAbsolutePath);
+        await fs.mkdir(path_1.default.dirname(newAbsolutePath), { recursive: true });
+        await fs.copyFile(absoluteOriginalPath, newAbsolutePath);
+        pathMapping.set(originalPath, newRelativePath);
+        logger.log(`  ✓  ${originalPath} → ${newRelativePath}`);
+        // special handling for models: copy dependencies
+        if (assetType === 'Models') {
+            const dependencies = await extractGltfDependencies(components, absoluteOriginalPath);
+            if (dependencies.textures.length === 0 && dependencies.binaries.length === 0) {
+                continue;
+            }
+            const allDependencies = [...dependencies.textures, ...dependencies.binaries];
+            for (const depFileName of allDependencies) {
+                const depOriginalPath = path_1.default.join(path_1.default.dirname(absoluteOriginalPath), depFileName);
+                if (await fs.fileExists(depOriginalPath)) {
+                    const depNewPath = path_1.default.join(path_1.default.dirname(newAbsolutePath), depFileName);
+                    await fs.copyFile(depOriginalPath, depNewPath);
+                    const depOriginalRelative = path_1.default.join(path_1.default.dirname(originalPath), depFileName);
+                    const depNewRelative = path_1.default.relative(sceneRoot, depNewPath);
+                    pathMapping.set(depOriginalRelative, depNewRelative);
+                    logger.log(`    ↳  ${depFileName}`);
+                }
+            }
+        }
+    }
+    logger.log(`Migrated ${pathMapping.size} asset file(s)`);
+    // Step 3: update components with new paths
+    let updatedCount = 0;
+    for (const component of engine.componentsIter()) {
+        for (const [entity] of engine.getEntitiesWith(component)) {
+            const componentData = component.get(entity);
+            if (componentData) {
+                const { data: updatedData, hasChanges } = replaceAssetPaths(componentData, pathMapping);
+                if (hasChanges) {
+                    // only supporting LastWriteWinElementSetComponentDefinition (inspector does the same thing)
+                    if ('createOrReplace' in component) {
+                        component.createOrReplace(entity, updatedData);
+                        updatedCount++;
+                    }
+                }
+            }
+        }
+    }
+    return updatedCount;
+}
+exports.migrateAssets = migrateAssets;
+//# sourceMappingURL=asset-migrator.js.map

package/dist/commands/code-to-composite/asset-migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-migrator.js","sourceRoot":"","sources":["../../../src/commands/code-to-composite/asset-migrator.ts"],"names":[],"mappings":"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"}

package/dist/commands/code-to-composite/code-commenter.d.ts

@@ -0,0 +1,11 @@
+import { CliComponents } from '../../components';
+/**
+ * Replaces the entrypoint file with a stub main() function
+ */
+export declare function commentEntrypoint({ fs }: Pick<CliComponents, 'fs'>, entrypointPath: string): Promise<void>;
+/**
+ * Comments out the entrypoint and all source files in the src directory
+ *
+ * NOTE: Need to comment out all the src files otherwise typechecker will fail preventing deploys, etc.
+ */
+export declare function commentSourceFiles(components: Pick<CliComponents, 'fs'>, sceneCodeEntrypoint: string, bundleEntrypoint: string): Promise<number>;

package/dist/commands/code-to-composite/code-commenter.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commentSourceFiles = exports.commentEntrypoint = void 0;
+const path_1 = __importDefault(require("path"));
+const glob_1 = require("glob");
+const COMMENT_MARKER = 'COMMENTED BY "@dcl/sdk-commands code-to-composite" COMMAND';
+/**
+ * Checks if a file has already been commented by this command
+ */
+function isAlreadyCommented(content) {
+    return content.includes(COMMENT_MARKER);
+}
+/**
+ * Generates the comment header for migrated files
+ */
+function generateCommentHeader(content) {
+    // use line-by-line commenting to avoid issues with existing /* */ comments
+    const commentedLines = content.split('\n').map(line => `// ${line}`).join('\n');
+    return `// ============================================================================
+// ${COMMENT_MARKER}
+//
+// This code has been migrated to main.composite and main.crdt files.
+// The scene can now be edited visually using the Creator Hub app.
+//
+// To restore code-based workflow: Uncomment the code below
+// For hybrid workflow: Uncomment specific parts you want to keep dynamic
+//
+// Learn more: https://docs.decentraland.org/creator
+// ============================================================================
+//
+${commentedLines}`;
+}
+/**
+ * Replaces the entrypoint file with a stub main() function
+ */
+async function commentEntrypoint({ fs }, entrypointPath) {
+    const stubContent = `// ${COMMENT_MARKER}
+// Scene content is managed by Creator Hub (main.composite)
+
+export function main() {
+  // Add dynamic code, systems, or event handlers here
+}
+`;
+    await fs.writeFile(entrypointPath, stubContent);
+}
+exports.commentEntrypoint = commentEntrypoint;
+/**
+ * Comments out a single source file
+ */
+async function commentSourceFile({ fs }, filePath) {
+    const currentContent = await fs.readFile(filePath, 'utf-8');
+    if (isAlreadyCommented(currentContent)) {
+        return;
+    }
+    const commentedContent = generateCommentHeader(currentContent) + '\n';
+    await fs.writeFile(filePath, commentedContent);
+}
+/**
+ * Comments out the entrypoint and all source files in the src directory
+ *
+ * NOTE: Need to comment out all the src files otherwise typechecker will fail preventing deploys, etc.
+ */
+async function commentSourceFiles(components, sceneCodeEntrypoint, bundleEntrypoint) {
+    const normalizedBundleEntrypoint = path_1.default.normalize(bundleEntrypoint);
+    const normalizedSceneCodeEntrypoint = path_1.default.normalize(sceneCodeEntrypoint);
+    const srcDir = path_1.default.dirname(normalizedSceneCodeEntrypoint);
+    const sourceFiles = (0, glob_1.globSync)('**/*.{ts,tsx,js,jsx}', {
+        cwd: srcDir,
+        absolute: true,
+        ignore: ['**/*.d.ts', '**/node_modules/**']
+    });
+    const filesToComment = sourceFiles.filter(file => {
+        const normalized = path_1.default.normalize(file);
+        return normalized !== normalizedBundleEntrypoint &&
+            normalized !== normalizedSceneCodeEntrypoint;
+    });
+    await Promise.all([
+        commentEntrypoint(components, normalizedBundleEntrypoint),
+        commentSourceFile(components, normalizedSceneCodeEntrypoint),
+        ...filesToComment.map(file => commentSourceFile(components, file))
+    ]);
+    return filesToComment.length;
+}
+exports.commentSourceFiles = commentSourceFiles;
+//# sourceMappingURL=code-commenter.js.map

package/dist/commands/code-to-composite/code-commenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-commenter.js","sourceRoot":"","sources":["../../../src/commands/code-to-composite/code-commenter.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAuB;AACvB,+BAA+B;AAI/B,MAAM,cAAc,GAAG,4DAA4D,CAAA;AAEnF;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;AACzC,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,2EAA2E;IAC3E,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAE/E,OAAO;KACJ,cAAc;;;;;;;;;;;EAWjB,cAAc,EAAE,CAAA;AAClB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAAC,EAAE,EAAE,EAA6B,EAAE,cAAsB;IAC/F,MAAM,WAAW,GAAG,MAAM,cAAc;;;;;;CAMzC,CAAA;IAEC,MAAM,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;AACjD,CAAC;AAVD,8CAUC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,EAAE,EAAE,EAA6B,EAAE,QAAgB;IAClF,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAE3D,IAAI,kBAAkB,CAAC,cAAc,CAAC,EAAE;QACtC,OAAM;KACP;IAED,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,cAAc,CAAC,GAAG,IAAI,CAAA;IAErE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;AAChD,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CACtC,UAAqC,EACrC,mBAA2B,EAC3B,gBAAwB;IAExB,MAAM,0BAA0B,GAAG,cAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;IACnE,MAAM,6BAA6B,GAAG,cAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;IACzE,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAA;IAE1D,MAAM,WAAW,GAAG,IAAA,eAAQ,EAAC,sBAAsB,EAAE;QACnD,GAAG,EAAE,MAAM;QACX,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC;KAC5C,CAAC,CAAA;IAEF,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QAC/C,MAAM,UAAU,GAAG,cAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO,UAAU,KAAK,0BAA0B;YACzC,UAAU,KAAK,6BAA6B,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,iBAAiB,CAAC,UAAU,EAAE,0BAA0B,CAAC;QACzD,iBAAiB,CAAC,UAAU,EAAE,6BAA6B,CAAC;QAC5D,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;KACnE,CAAC,CAAA;IAEF,OAAO,cAAc,CAAC,MAAM,CAAA;AAC9B,CAAC;AA5BD,gDA4BC"}

package/dist/commands/code-to-composite/composite-generator.d.ts

@@ -0,0 +1,6 @@
+import { CliComponents } from '../../components';
+import { IEngine } from '@dcl/ecs/dist-cjs';
+/**
+ * Generates composite and CRDT files from an ECS engine state.
+ */
+export declare function generateCompositeFiles(components: Pick<CliComponents, 'fs' | 'logger'>, engine: IEngine, compositeFilePath: string, crdtFilePath: string, entityNamesFilePath: string): Promise<void>;

package/dist/commands/code-to-composite/composite-generator.js

@@ -0,0 +1,56 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCompositeFiles = void 0;
+const inspector_1 = require("@dcl/inspector");
+const fs_1 = require("../start/data-layer/fs");
+const dist_cjs_1 = require("@dcl/ecs/dist-cjs");
+const path = __importStar(require("path"));
+async function ensureDirectoryExists({ fs }, filePath) {
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * Generates composite and CRDT files from an ECS engine state.
+ */
+async function generateCompositeFiles(components, engine, compositeFilePath, crdtFilePath, entityNamesFilePath) {
+    const { fs } = components;
+    // ensure all directories exist
+    await ensureDirectoryExists(components, compositeFilePath);
+    await ensureDirectoryExists(components, crdtFilePath);
+    await ensureDirectoryExists(components, entityNamesFilePath);
+    const _engine = engine;
+    // generate composite JSON
+    const composite = (0, inspector_1.dumpEngineToComposite)(_engine, 'json');
+    await fs.writeFile(compositeFilePath, JSON.stringify(dist_cjs_1.Composite.toJson(composite), null, 2));
+    // generate CRDT binary
+    const crdtData = (0, inspector_1.dumpEngineToCrdtCommands)(_engine);
+    await fs.writeFile(crdtFilePath, crdtData);
+    const workingDirectory = path.dirname(compositeFilePath);
+    const fsAdapter = (0, fs_1.createFileSystemInterfaceFromFsComponent)({ fs }, workingDirectory);
+    await (0, inspector_1.generateEntityNamesType)(_engine, entityNamesFilePath, 'EntityNames', fsAdapter);
+}
+exports.generateCompositeFiles = generateCompositeFiles;
+//# sourceMappingURL=composite-generator.js.map

package/dist/commands/code-to-composite/composite-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-generator.js","sourceRoot":"","sources":["../../../src/commands/code-to-composite/composite-generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8CAKuB;AAEvB,+CAAiF;AAEjF,gDAAsD;AACtD,2CAA4B;AAE5B,KAAK,UAAU,qBAAqB,CAAC,EAAE,EAAE,EAA6B,EAAE,QAAgB;IACtF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC1C,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,sBAAsB,CAC1C,UAAgD,EAChD,MAAe,EACf,iBAAyB,EACzB,YAAoB,EACpB,mBAA2B;IAE3B,MAAM,EAAE,EAAE,EAAE,GAAG,UAAU,CAAA;IAEzB,+BAA+B;IAC/B,MAAM,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAA;IAC1D,MAAM,qBAAqB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IACrD,MAAM,qBAAqB,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAA;IAE5D,MAAM,OAAO,GAAG,MAA2B,CAAA;IAE3C,0BAA0B;IAC1B,MAAM,SAAS,GAAG,IAAA,iCAAqB,EAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACxD,MAAM,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAS,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAE3F,uBAAuB;IACvB,MAAM,QAAQ,GAAG,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAA;IAClD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;IAE1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACxD,MAAM,SAAS,GAAwB,IAAA,6CAAwC,EAAC,EAAE,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAA;IACzG,MAAM,IAAA,mCAAuB,EAAC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,SAAS,CAAC,CAAA;AACvF,CAAC;AA3BD,wDA2BC"}

package/dist/commands/code-to-composite/index.d.ts

@@ -0,0 +1,16 @@
+import { Result } from 'arg';
+import { CliComponents } from '../../components';
+interface Options {
+    args: Result<typeof args>;
+    components: Pick<CliComponents, 'fs' | 'logger' | 'analytics' | 'spawner'>;
+}
+export declare const args: {
+    '--dir': StringConstructor;
+    '--help': BooleanConstructor;
+    '-h': string;
+    '--yes': BooleanConstructor;
+    '-y': string;
+};
+export declare function help(options: Options): void;
+export declare function main(options: Options): Promise<void>;
+export {};

package/dist/commands/code-to-composite/index.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = exports.help = exports.args = void 0;
+const path_1 = __importDefault(require("path"));
+const prompts_1 = __importDefault(require("prompts"));
+const args_1 = require("../../logic/args");
+const workspace_validations_1 = require("../../logic/workspace-validations");
+const beautiful_logs_1 = require("../../logic/beautiful-logs");
+const scene_executor_1 = require("./scene-executor");
+const composite_generator_1 = require("./composite-generator");
+const code_commenter_1 = require("./code-commenter");
+const asset_migrator_1 = require("./asset-migrator");
+const name_generator_1 = require("./name-generator");
+exports.args = (0, args_1.declareArgs)({
+    '--dir': String,
+    '--help': Boolean,
+    '-h': '--help',
+    '--yes': Boolean,
+    '-y': '--yes',
+});
+function help(options) {
+    options.components.logger.log(`
+  Usage: 'sdk-commands code-to-composite [options]'
+
+  Description:
+
+    Migrates a code-only scene to Creator Hub-compatible format by generating
+    composite/crdt files and commenting out the original code.
+
+  Options:
+
+    -h, --help                Displays complete help
+    --dir                     Path to directory to export
+    -y, --yes                 Skip the confirmation prompt
+
+  Example:
+
+    - Export a code-only scene to Creator Hub format:
+      '$ sdk-commands code-to-composite'
+
+    - Export a specific directory:
+      '$ sdk-commands code-to-composite --dir ./my-scene'
+  `);
+}
+exports.help = help;
+async function main(options) {
+    const workingDirectory = path_1.default.resolve(process.cwd(), options.args['--dir'] || '.');
+    const workspace = await (0, workspace_validations_1.getValidWorkspace)(options.components, workingDirectory);
+    const shouldContinue = options.args['--yes'] ? true : await promptForDestructiveAction(options.components);
+    if (!shouldContinue)
+        return;
+    const MAX_STEPS = 5;
+    for (const project of workspace.projects) {
+        (0, beautiful_logs_1.printCurrentProjectStarting)(options.components.logger, project, workspace);
+        if (project.kind === 'scene') {
+            await exportSceneToCrdt(options, project, MAX_STEPS);
+        }
+        else {
+            options.components.logger.warn(`Project ${project.workingDirectory} is not a scene, skipping...`);
+        }
+    }
+}
+exports.main = main;
+async function promptForDestructiveAction(components) {
+    const { logger } = components;
+    (0, beautiful_logs_1.printWarning)(logger, 'This command will modify your scene code by commenting it out and creating composite/CRDT files.');
+    logger.log('  - Your original code will be backed up with a .backup.ts extension');
+    logger.log('  - The scene will be converted to Creator Hub format');
+    logger.log('  - Files will be moved around');
+    logger.log('  - If you are not using any version control system, undoing this operation will be REALLY cumbersome');
+    logger.log('');
+    let cancelled = false;
+    const onCancel = () => {
+        cancelled = true;
+    };
+    const { confirmed } = await (0, prompts_1.default)({
+        type: 'confirm',
+        name: 'confirmed',
+        message: 'Do you want to continue?',
+        initial: false
+    }, { onCancel });
+    if (cancelled || !confirmed) {
+        logger.log('Operation cancelled by user.');
+        return false;
+    }
+    return true;
+}
+async function exportSceneToCrdt(options, project, maxSteps) {
+    const { logger } = options.components;
+    let currentStep = 1;
+    const compositeFilePath = path_1.default.join(project.workingDirectory, 'assets', 'scene', 'main.composite');
+    const crdtFilePath = path_1.default.join(project.workingDirectory, 'main.crdt');
+    const entityNamesFilePath = path_1.default.join(project.workingDirectory, 'src', 'entity-names.ts');
+    // Step 1: execute scene code to populate engine
+    (0, beautiful_logs_1.printProgressStep)(logger, 'Executing scene code to capture state', currentStep++, maxSteps);
+    const { engine, sceneCodeEntrypoint } = await (0, scene_executor_1.executeSceneCode)(options.components, project, crdtFilePath);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Engine state captured successfully`);
+    // Step 2: migrate assets (before generating composite/crdt)
+    (0, beautiful_logs_1.printProgressStep)(logger, 'Organizing assets for Creator Hub', currentStep++, maxSteps);
+    const updatedCount = await (0, asset_migrator_1.migrateAssets)(options.components, project, engine);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Migrated ${updatedCount} asset file(s) successfully`);
+    // Step 3: generate entity names
+    (0, beautiful_logs_1.printProgressStep)(logger, 'Generating names for entities', currentStep++, maxSteps);
+    const namedEntitiesCount = await (0, name_generator_1.generateEntityNames)(options.components, engine);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Generated names for ${namedEntitiesCount} entity/entities`);
+    // Step 4: generate composite and crdt files (with updated asset paths and names)
+    (0, beautiful_logs_1.printProgressStep)(logger, 'Generating composite and crdt files', currentStep++, maxSteps);
+    await (0, composite_generator_1.generateCompositeFiles)(options.components, engine, compositeFilePath, crdtFilePath, entityNamesFilePath);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Generated main.composite ✅ (${compositeFilePath})`);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Generated main.crdt ✅ (${crdtFilePath})`);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Generated entity-names.ts ✅ (${entityNamesFilePath})`);
+    // Step 5: comment out original code
+    (0, beautiful_logs_1.printProgressStep)(logger, 'Commenting out original code', currentStep++, maxSteps);
+    const bundleEntrypoint = path_1.default.join(project.workingDirectory, project.scene.main);
+    const commentedFiles = await (0, code_commenter_1.commentSourceFiles)(options.components, sceneCodeEntrypoint, bundleEntrypoint);
+    const relativeEntrypoint = path_1.default.relative(project.workingDirectory, sceneCodeEntrypoint);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Commented out bundle entrypoint ${project.scene.main} and added stub main() function`);
+    (0, beautiful_logs_1.printProgressInfo)(logger, `Commented out scene code entrypoint ${relativeEntrypoint}`);
+    if (commentedFiles > 0) {
+        (0, beautiful_logs_1.printProgressInfo)(logger, `Commented out ${commentedFiles} additional source file(s)`);
+    }
+    (0, beautiful_logs_1.printSuccess)(logger, 'Scene successfully migrated to Creator Hub format!', `\nNext steps:
+  - Open your scene in the Creator Hub to edit visually
+  - Uncomment parts of the code in src/ for hybrid workflows
+  - Use "src/entity-names.ts" to reference entities by name in code`);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/code-to-composite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/code-to-composite/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/code-to-composite/name-generator.d.ts

@@ -0,0 +1,9 @@
+import { IEngine } from '@dcl/ecs/dist-cjs';
+import { CliComponents } from '../../components';
+/**
+ * Generates Name components for entities that don't have them
+ *
+ * Automatically generates Name components for entities based on their other components.
+ * This makes entities easier to identify and work with in the Creator Hub.
+ */
+export declare function generateEntityNames(components: Pick<CliComponents, 'logger'>, engine: IEngine): Promise<number>;