@hypersoniclabs/helix-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,274 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const node_path_1 = require("node:path");
+const lib_1 = require("./lib");
+const bundle_1 = require("./bundle");
+const ability_1 = require("./ability");
+const initAbility_1 = require("./initAbility");
+const config_1 = require("./config");
+const init_1 = require("./init");
+const prompt_1 = require("./prompt");
+const program = new commander_1.Command();
+program
+    .name('helix')
+    .description('HELIX creator CLI — scaffold, validate, and publish Instant Worlds')
+    .version((0, lib_1.cliVersion)());
+function fail(message) {
+    console.error(message);
+    process.exit(1);
+}
+function requireAuth() {
+    const creds = (0, config_1.loadCredentials)();
+    if (!creds)
+        fail('Not logged in (or token expired). Run: helix login');
+    return creds;
+}
+program
+    .command('login')
+    .description('Store a HELIX client token for the CLI')
+    .option('--api-url <url>', 'platform API base URL', config_1.DEFAULT_API_URL)
+    .option('--token <token>', 'client token (otherwise prompted)')
+    .action(async (opts) => {
+    try {
+        console.log('Generate a client token in the Creator Hub (Settings → Client Tokens),\n' +
+            'then paste it here. It is stored in ~/.helix/credentials.json.');
+        const token = opts.token ?? (await (0, prompt_1.askHidden)('Client token: '));
+        if (!token)
+            fail('✖ No token provided.');
+        const api = new lib_1.HelixApi(opts.apiUrl, token);
+        const user = await (0, lib_1.whoAmI)(api); // validates the token
+        const expiresAt = (0, config_1.jwtExpiresAtIso)(token);
+        (0, config_1.saveCredentials)({
+            apiUrl: opts.apiUrl,
+            token,
+            expiresAt,
+            username: user.username,
+        });
+        const until = expiresAt ? ` (valid until ${expiresAt.slice(0, 10)})` : '';
+        console.log(`✔ Logged in as ${user.username}${until}`);
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? `${err.render()}\n  (is the token valid and not expired?)`
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
+program
+    .command('logout')
+    .description('Remove the stored client token')
+    .action(() => {
+    (0, config_1.clearCredentials)();
+    console.log('✔ Logged out.');
+});
+program
+    .command('whoami')
+    .description('Show the current login status')
+    .action(() => {
+    const status = (0, lib_1.authStatus)();
+    if (!status.loggedIn) {
+        console.log('Not logged in. Run: helix login');
+        return;
+    }
+    const until = status.expiresAt ? ` (until ${status.expiresAt.slice(0, 10)})` : '';
+    console.log(`${status.username} @ ${status.apiUrl}${until}`);
+});
+program
+    .command('init')
+    .description('Scaffold a minimal HELIX Instant world (or, with --ability, a humanoid-character ability) in a new directory')
+    .argument('<directory>', 'directory to create')
+    .option('--ability', 'scaffold an ability bundle for the humanoid-character system instead of a world')
+    .action((directory, opts) => {
+    try {
+        if (opts.ability) {
+            const created = (0, initAbility_1.initAbilityTemplate)((0, node_path_1.resolve)(directory));
+            console.log(`✔ Created ${created.length} files in ${directory}`);
+            console.log(`\nNext steps:\n  1. Edit ${directory}/ability.json — pick your own id\n` +
+                `  2. helix validate-bundle ${directory}\n  3. From your world project: helix install ${directory} --first-party`);
+            return;
+        }
+        const created = (0, init_1.initTemplate)((0, node_path_1.resolve)(directory));
+        console.log(`✔ Created ${created.length} files in ${directory}`);
+        console.log(`\nNext steps:\n  1. Edit ${directory}/helix.json — pick your own slug\n` +
+            `  2. helix validate ${directory}\n  3. helix publish ${directory}`);
+    }
+    catch (err) {
+        fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
+program
+    .command('validate-bundle')
+    .description('Validate an ability bundle against the frozen ability-v1 contract (the same module the runtime loader runs)')
+    .argument('[directory]', 'bundle directory (the built dist/)', '.')
+    .action(async (directory) => {
+    const validator = await (0, ability_1.loadVendoredValidator)();
+    const result = (0, ability_1.checkAbilityBundle)((0, node_path_1.resolve)(directory), validator);
+    if (result.errors.length || result.manifest === null) {
+        fail(`✖ ${result.errors.length} problem(s):\n${result.errors
+            .map((e) => `  - ${e}`)
+            .join('\n')}`);
+    }
+    const m = result.manifest;
+    console.log(`✔ Valid ability bundle: "${m.title}" (${m.id}@${m.version}, activation: ${m.activation.mode}, ${(m.clips ?? []).length} clips)`);
+});
+program
+    .command('install')
+    .description("Resolve this v0.2 world's system/ability pins, download their code, and write installed.json + helix.lock.json")
+    .argument('[path]', 'a local ability bundle to copy in (requires --first-party); omit for the world resolve+install')
+    .option('--update', 're-resolve pins against the live catalog and rewrite the lock (else the existing lock is replayed)')
+    .option('--first-party', 'FIRST-PARTY only: copy the local <path> bundle (code AND clips) into helix_modules — for engine devs testing co-located assets')
+    .option('--local', 'alias of --first-party (deprecated)')
+    .option('--api-url <url>', 'platform API base URL', config_1.DEFAULT_API_URL)
+    .action(async (path, opts) => {
+    const firstParty = Boolean(opts.firstParty || opts.local);
+    if (path !== undefined || firstParty) {
+        if (!path) {
+            fail('✖ --first-party needs a bundle path: helix install <bundle> --first-party');
+        }
+        if (!firstParty) {
+            fail("✖ to copy a local ability bundle use: helix install <bundle> --first-party\n  (a bare `helix install` resolves this world's pins)");
+        }
+        try {
+            const [validator, indexValidator] = await Promise.all([
+                (0, ability_1.loadVendoredValidator)(),
+                (0, ability_1.loadInstalledIndexValidator)(),
+            ]);
+            const result = (0, ability_1.installLocalAbility)((0, node_path_1.resolve)(path), process.cwd(), validator, indexValidator);
+            console.log(`✔ Installed (first-party) ${result.id}@${result.version} -> ${ability_1.MODULES_DIR}/${result.path}/ (${result.installedCount} installed)`);
+        }
+        catch (err) {
+            fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return;
+    }
+    try {
+        const result = await (0, lib_1.installWorld)(process.cwd(), {
+            apiUrl: opts.apiUrl,
+            update: opts.update,
+            onProgress: (msg) => console.log(msg),
+        });
+        const sys = result.systems.map((s) => `${s.slug}@${s.version}`).join(', ') || '(none)';
+        const abl = result.abilities.map((a) => `${a.slug}@${a.version}`).join(', ') || '(none)';
+        console.log(`✔ ${result.reresolved ? 'Resolved' : 'Replayed lock'} — systems: ${sys}; abilities: ${abl}`);
+        console.log(`  code -> public/${ability_1.MODULES_DIR}/  ·  assets stream from the CDN  ·  lock -> ${lib_1.LOCKFILE}`);
+        if (result.runtime) {
+            console.log(`  three ${result.runtime.threeVersion} -> import map + src/helix.runtime.ts wired to the hosted runtime`);
+        }
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? err.render()
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
+program
+    .command('validate')
+    .description('Validate a world bundle locally (same rules the server enforces)')
+    .argument('[directory]', 'bundle directory', '.')
+    .action((directory) => {
+    const result = (0, bundle_1.checkBundle)((0, node_path_1.resolve)(directory));
+    if (result.errors.length) {
+        fail(`✖ ${result.errors.length} problem(s):\n${result.errors
+            .map((e) => `  - ${e}`)
+            .join('\n')}`);
+    }
+    const total = result.files.reduce((sum, f) => sum + f.size, 0);
+    console.log(`✔ Valid bundle: "${result.manifest.title}" (${result.files.length} files, ${(total / 1024).toFixed(1)} KiB)`);
+});
+program
+    .command('publish')
+    .description('Publish a world to HELIX Instant')
+    .argument('[directory]', 'bundle directory', '.')
+    .action(async (directory) => {
+    const creds = requireAuth();
+    try {
+        const result = await (0, lib_1.publishWorld)((0, node_path_1.resolve)(directory), creds, (msg) => console.log(msg));
+        console.log(`✔ Published "${result.title}" build ${result.buildNumber}`);
+        if (result.playUrl)
+            console.log(`  play: ${result.playUrl}`);
+        console.log(`  api:  ${result.worldUrl}`);
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? err.render()
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
+program
+    .command('publish-package')
+    .description('Publish a system / ability / asset-pack bundle (requires an admin account)')
+    .argument('[directory]', 'bundle directory (the built dist/)', '.')
+    .action(async (directory) => {
+    const creds = requireAuth();
+    try {
+        const result = await (0, lib_1.publishPackage)((0, node_path_1.resolve)(directory), creds, (msg) => console.log(msg));
+        console.log(`✔ Published ${result.kind} ${result.slug}@${result.version} (revision ${result.revision})`);
+        console.log(`  code:   ${result.codeBaseUrl}`);
+        if (result.assetBaseUrl)
+            console.log(`  assets: ${result.assetBaseUrl}`);
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? err.render()
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
+async function printCatalog(kind, system, apiUrlOpt) {
+    const apiUrl = apiUrlOpt ?? (0, config_1.loadCredentials)()?.apiUrl ?? config_1.DEFAULT_API_URL;
+    try {
+        const res = await (0, lib_1.listPackages)(apiUrl, kind, system);
+        const plural = kind === 'ability' ? 'abilities' : kind === 'asset-pack' ? 'asset-packs' : `${kind}s`;
+        if (res.data.length === 0) {
+            console.log(`No ${plural} published yet.`);
+            return;
+        }
+        for (const p of res.data) {
+            const sys = p.targetSystem
+                ? `  [system: ${p.targetSystem.id}${p.targetSystem.range ? `@${p.targetSystem.range}` : ''}]`
+                : '';
+            console.log(`- ${p.slug}@${p.latestVersion ?? '?'} — ${p.title}${sys}`);
+        }
+    }
+    catch (err) {
+        fail(err instanceof lib_1.ApiError
+            ? err.render()
+            : `✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+program
+    .command('list-systems')
+    .description('List the systems published on HELIX Instant')
+    .option('--api-url <url>', 'platform API base URL')
+    .action((opts) => printCatalog('system', undefined, opts.apiUrl));
+program
+    .command('list-abilities')
+    .description('List the abilities published on HELIX Instant')
+    .option('--system <id>', 'only abilities targeting this system id')
+    .option('--api-url <url>', 'platform API base URL')
+    .action((opts) => printCatalog('ability', opts.system, opts.apiUrl));
+program
+    .command('doctor')
+    .description('Health check: login state + whether the @helix toolchain (CLI/MCP/SDK/manifest) is up to date')
+    .option('--project <dir>', 'a world/ability project dir to also check its pinned @helix deps', '.')
+    .action(async (opts) => {
+    const status = (0, lib_1.authStatus)();
+    console.log(status.loggedIn
+        ? `✔ Logged in as ${status.username} (${status.apiUrl})`
+        : '• Not logged in — run: helix login');
+    const rows = await (0, lib_1.checkForUpdates)({ projectDir: (0, node_path_1.resolve)(opts.project) });
+    console.log('\n@helix toolchain:');
+    for (const r of rows) {
+        const mark = r.status === 'current' ? '✔' : r.status === 'update-available' ? '⬆' : '•';
+        const line = `  ${mark} ${r.name.padEnd(20)} ${(r.installed ?? '—').padEnd(8)} (latest ${r.latest ?? '?'})`;
+        console.log(r.status === 'update-available' ? `${line}  → ${r.updateHint}` : line);
+    }
+    const stale = rows.filter((r) => r.status === 'update-available');
+    console.log(stale.length
+        ? `\n${stale.length} update(s) available.`
+        : '\nAll detected packages are current.');
+});
+program
+    .parseAsync()
+    .catch((err) => fail(`✖ ${err instanceof Error ? err.message : String(err)}`));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare function initTemplate(targetDir: string): string[];

package/dist/init.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initTemplate = initTemplate;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// Minimal no-build starter: plain Three.js from a CDN import map, no bundler.
+// The SDK-integrated Vite templates (template-spinning-scene, template-hangout)
+// are the real starting points; this exists so `helix init` works standalone.
+const TEMPLATE_FILES = {
+    'helix.json': (slug) => JSON.stringify({
+        helixVersion: '0.1',
+        title: 'My HELIX World',
+        slug,
+        entry: 'index.html',
+        maxPlayers: 1,
+        permissions: [],
+        supportsMobile: true,
+        contentRating: 'everyone',
+    }, null, 2) + '\n',
+    'index.html': () => `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>My HELIX World</title>
+    <style>html, body { margin: 0; height: 100%; overflow: hidden; background: #0a0a12; }</style>
+    <script type="importmap">
+      { "imports": { "three": "https://cdn.jsdelivr.net/npm/three@0.172.0/build/three.module.js" } }
+    </script>
+  </head>
+  <body>
+    <script type="module" src="main.js"></script>
+  </body>
+</html>
+`,
+    'main.js': () => `import * as THREE from 'three';
+
+const scene = new THREE.Scene();
+const camera = new THREE.PerspectiveCamera(70, innerWidth / innerHeight, 0.1, 100);
+camera.position.z = 3;
+
+const renderer = new THREE.WebGLRenderer({ antialias: true });
+renderer.setSize(innerWidth, innerHeight);
+document.body.appendChild(renderer.domElement);
+
+const cube = new THREE.Mesh(
+  new THREE.BoxGeometry(),
+  new THREE.MeshStandardMaterial({ color: 0x7c4dff }),
+);
+scene.add(cube);
+scene.add(new THREE.AmbientLight(0xffffff, 0.4));
+const light = new THREE.DirectionalLight(0xffffff, 1.2);
+light.position.set(2, 3, 4);
+scene.add(light);
+
+addEventListener('resize', () => {
+  camera.aspect = innerWidth / innerHeight;
+  camera.updateProjectionMatrix();
+  renderer.setSize(innerWidth, innerHeight);
+});
+
+renderer.setAnimationLoop(() => {
+  cube.rotation.x += 0.01;
+  cube.rotation.y += 0.013;
+  renderer.render(scene, camera);
+});
+`,
+};
+function initTemplate(targetDir) {
+    if ((0, node_fs_1.existsSync)(targetDir))
+        throw new Error(`directory already exists: ${targetDir}`);
+    const slug = (0, node_path_1.basename)(targetDir)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 50)
+        .padEnd(3, '0');
+    const created = [];
+    for (const [path, render] of Object.entries(TEMPLATE_FILES)) {
+        const absolute = (0, node_path_1.join)(targetDir, path);
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(absolute), { recursive: true });
+        (0, node_fs_1.writeFileSync)(absolute, render(slug), 'utf8');
+        created.push(path);
+    }
+    return created;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":";;AAwEA,oCAiBC;AAzFD,qCAA+D;AAC/D,yCAAoD;AAEpD,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,MAAM,cAAc,GAA6C;IAC/D,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CACrB,IAAI,CAAC,SAAS,CACZ;QACE,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,gBAAgB;QACvB,IAAI;QACJ,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAAE;QACf,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,UAAU;KAC1B,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI;IACV,YAAY,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;CAerB;IACC,SAAS,EAAE,GAAG,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB;CACA,CAAC;AAEF,SAAgB,YAAY,CAAC,SAAiB;IAC5C,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,IAAA,oBAAQ,EAAC,SAAS,CAAC;SAC7B,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAElB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvC,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,IAAA,uBAAa,EAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/initAbility.d.ts

@@ -0,0 +1 @@
+export declare function initAbilityTemplate(targetDir: string): string[];

package/dist/initAbility.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initAbilityTemplate = initAbilityTemplate;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// Minimal no-build ability scaffold for the humanoid-character system: plain-JS entry, directly
+// installable (`helix install <dir> --local`) with no build step. The TS template with vendored
+// system types (helix-instant-templates/humanoid-character-ability) is the real starting point;
+// this exists so `helix init --ability` works standalone — mirroring the world `init` pattern.
+const TEMPLATE_FILES = {
+    'ability.json': (id) => JSON.stringify({
+        $schema: 'https://helix.dev/schemas/ability-v1.schema.json',
+        schemaVersion: 1,
+        id,
+        version: '0.1.0',
+        title: 'My Ability',
+        description: 'Describe what the ability does and any blackboard params the world must publish.',
+        system: { id: 'humanoid-character', version: '^0.1.0', skeleton: 'helix-humanoid@1' },
+        activation: { mode: 'manual', action: `${id}.toggle`, style: 'toggle' },
+        actions: [{ id: `${id}.toggle`, kind: 'button', defaultBinding: { keys: ['KeyG'] } }],
+        configSchema: 'schema/config.schema.json',
+        entry: 'index.js',
+    }, null, 2) + '\n',
+    'schema/config.schema.json': () => JSON.stringify({
+        type: 'object',
+        properties: {
+            power: { type: 'number', default: 1, minimum: 0, maximum: 10, description: 'Example tunable; agents set it live as <abilityId>.power.' },
+        },
+    }, null, 2) + '\n',
+    'index.js': (id) => `// Ability entry — the default export implements the system Ability interface.
+// No runtime imports: bare specifiers don't resolve when the platform import()s this file;
+// everything the ability touches comes through the AbilityContext (ctx) the system passes in.
+export default class MyAbility {
+  manifest = { id: '${id}' };
+
+  onActivate(ctx) {
+    // Activated by the manifest action (KeyG). Channels declared in ability.json are claimed.
+    void ctx;
+  }
+
+  onTick(dt, ctx) {
+    const power = ctx.config.get('power'); // agents see this as '${id}.power'
+    void dt;
+    void power;
+  }
+
+  onDeactivate(ctx) {
+    void ctx;
+  }
+}
+`,
+};
+function initAbilityTemplate(targetDir) {
+    if ((0, node_fs_1.existsSync)(targetDir))
+        throw new Error(`directory already exists: ${targetDir}`);
+    const id = (0, node_path_1.basename)(targetDir)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 50)
+        .padEnd(3, '0');
+    const created = [];
+    for (const [path, render] of Object.entries(TEMPLATE_FILES)) {
+        const absolute = (0, node_path_1.join)(targetDir, path);
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(absolute), { recursive: true });
+        (0, node_fs_1.writeFileSync)(absolute, render(id), 'utf8');
+        created.push(path);
+    }
+    return created;
+}
+//# sourceMappingURL=initAbility.js.map

package/dist/initAbility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initAbility.js","sourceRoot":"","sources":["../src/initAbility.ts"],"names":[],"mappings":";;AA6DA,kDAiBC;AA9ED,qCAA+D;AAC/D,yCAAoD;AAEpD,gGAAgG;AAChG,gGAAgG;AAChG,gGAAgG;AAChG,+FAA+F;AAC/F,MAAM,cAAc,GAA2C;IAC7D,cAAc,EAAE,CAAC,EAAE,EAAE,EAAE,CACrB,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,kDAAkD;QAC3D,aAAa,EAAE,CAAC;QAChB,EAAE;QACF,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,kFAAkF;QAC/F,MAAM,EAAE,EAAE,EAAE,EAAE,oBAAoB,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE;QACrF,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;QACvE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACrF,YAAY,EAAE,2BAA2B;QACzC,KAAK,EAAE,UAAU;KAClB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI;IACV,2BAA2B,EAAE,GAAG,EAAE,CAChC,IAAI,CAAC,SAAS,CACZ;QACE,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,2DAA2D,EAAE;SACzI;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI;IACV,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;;;;sBAIA,EAAE;;;;;;;;oEAQ4C,EAAE;;;;;;;;;CASrE;CACA,CAAC;AAEF,SAAgB,mBAAmB,CAAC,SAAiB;IACnD,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;IACrF,MAAM,EAAE,GAAG,IAAA,oBAAQ,EAAC,SAAS,CAAC;SAC3B,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAElB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvC,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,IAAA,uBAAa,EAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,51 @@
+import { type ManifestIssue } from './ability';
+import { type ResolvedPackage, type ResolvedPins, type WorldPins } from './resolve';
+export declare const MODULES_DIR = "helix_modules";
+export declare const INSTALLED_INDEX = "installed.json";
+export declare const LOCKFILE = "helix.lock.json";
+export declare const RUNTIME_MODULE = "helix.runtime.ts";
+/** A v2 install-index entry: code from a (here local, root-absolute) base; clips from the CDN. */
+export type InstalledEntry = {
+    id: string;
+    version: string;
+    codeUrl: string;
+    assetBaseUrl: string;
+};
+export type WorldLock = {
+    lockfileVersion: 1;
+    systems: ResolvedPackage[];
+    abilities: ResolvedPackage[];
+};
+export type InstallWorldResult = {
+    manifestPath: string;
+    modulesDir: string;
+    systems: Array<{
+        slug: string;
+        version: string;
+    }>;
+    abilities: Array<{
+        slug: string;
+        version: string;
+    }>;
+    /** true when --update re-resolved the catalog; false when the existing lock was replayed. */
+    reresolved: boolean;
+    /** The hosted-three URLs install wired into index.html + src/helix.runtime.ts (null if no system pinned). */
+    runtime: {
+        threeVersion: string;
+        threeModuleUrl: string;
+        transcoderPath: string;
+    } | null;
+};
+export type InstallDeps = {
+    resolve(pins: WorldPins): Promise<ResolvedPins>;
+    download(codeBaseUrl: string, files: string[], destDir: string): Promise<void>;
+    satisfies(version: string, normalizedRange: string): boolean;
+    validateIndex(value: unknown): ManifestIssue[];
+};
+export type InstallWorldOptions = {
+    apiUrl: string;
+    update?: boolean;
+    onProgress?: (msg: string) => void;
+    deps?: InstallDeps;
+};
+export declare function installWorld(worldDir: string, opts: InstallWorldOptions): Promise<InstallWorldResult>;