@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/screenshot/staticServe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticServe.js","sourceRoot":"","sources":["../../src/screenshot/staticServe.ts"],"names":[],"mappings":";;AAiDA,8CAqFC;AAtID,yGAAyG;AACzG,oGAAoG;AACpG,sGAAsG;AACtG,uGAAuG;AACvG,6FAA6F;AAC7F,qCAAqD;AACrD,yCAAiG;AACjG,yCAA0D;AAE1D,8GAA8G;AAC9G,MAAM,aAAa,GAA2B;IAC5C,OAAO,EAAE,0BAA0B;IACnC,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,gCAAgC;IACxC,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,iCAAiC;IACzC,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,0BAA0B;IACnC,MAAM,EAAE,0BAA0B;IAClC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,YAAY;CACvB,CAAC;AAgBF,qHAAqH;AACrH,6FAA6F;AAC7F,8FAA8F;AAC9F,gGAAgG;AAChG,0DAA0D;AAC1D,SAAgB,iBAAiB,CAC/B,IAAY,EACZ,iBAAyC,EAAE;AAC3C,iGAAiG;AACjG,iGAAiG;AACjG,yFAAyF;AACzF,sFAAsF;AACtF,WAAW,GAAG,EAAE,EAChB,UAA+B,EAAE;IAEjC,MAAM,cAAc,GAAG,IAAA,qBAAS,EAAC,IAAI,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,WAAW;QACxB,CAAC,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG;QAC9C,CAAC,CAAC,GAAG,CAAC;IACR,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,EAAE,GAAG,EAAE,IAAA,qBAAS,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACvG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErD,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,GAAW,EAAuD,EAAE;QACnG,MAAM,IAAI,GAAG,IAAA,qBAAS,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,eAAG,CAAC;YAAE,OAAO,WAAW,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAW,IAAA,wBAAY,EAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC/C,IAAI,CAAC;gBACH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;oBAAE,OAAO;gBACtC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;gBACxD,IAAI,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAE3C,uFAAuF;gBACvF,mFAAmF;gBACnF,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC5B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;wBACpC,OAAO;oBACT,CAAC;oBACD,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACrC,CAAC;gBACD,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,GAAG,IAAI,YAAY,CAAC;gBAE3C,IAAI,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC/E,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBACpC,OAAO;gBACT,CAAC;gBAED,IAAI,GAAG,GAAG,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;gBACzC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;wBAC3B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC;4BAAE,SAAS;wBAC5C,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;wBAC/D,MAAM;oBACR,CAAC;gBACH,CAAC;gBACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;oBACxB,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBACpC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,CAAC;oBACT,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBACpC,OAAO;gBACT,CAAC;gBACD,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,aAAa,CAAC,IAAA,mBAAO,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B,CAAC,CAAC;gBAC5G,GAAG,CAAC,SAAS,CAAC,gBAAgB,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1C,IAAA,0BAAgB,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YACjD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACvE,cAAc,CAAC;gBACb,IAAI;gBACJ,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;aAC7D,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/source-archive.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Directory/file names dropped no matter what any `.gitignore` says.
+ *
+ * This is deliberately the SAME list the Dreamer checkpoint uses
+ * (`dreamer-worker:src/runtime/CloudflareSandboxRuntime.ts` → `excludes`), so a
+ * world whose source arrives from the CLI and a world whose source arrives from
+ * a sandbox backup produce the same workspace shape. Edit mode restores both
+ * through one code path; if the two origins disagreed about what a workspace
+ * contains, that path would need to know where the source came from.
+ *
+ * Not overridable by a `.gitignore` negation. A creator who writes
+ * `!node_modules` has not thought about a 400 MB upload, and "hard" that a
+ * config file can switch off is not hard.
+ */
+export declare const SOURCE_HARD_EXCLUDES: readonly string[];
+/**
+ * Client-side size cap, mirroring the server's `SOURCE_MAX_BYTES`
+ * (`helix-backend-api:src/instant-worlds/constants/world-source.ts`). Duplicated
+ * rather than imported because it lives in a different repo behind an authed
+ * endpoint; the point of holding it here is to refuse an over-cap archive
+ * BEFORE any network call, so the creator gets one readable sentence instead of
+ * a 400 after a long upload.
+ */
+export declare const SOURCE_MAX_BYTES: number;
+/** The IANA registration. The server also accepts `application/x-gzip`; we only ever send this one. */
+export declare const SOURCE_CONTENT_TYPE = "application/gzip";
+/** What the archive is called in creator-facing messages. */
+export declare const SOURCE_ARCHIVE_FILENAME = "helix-source.tar.gz";
+export type IgnoreRule = {
+    /** Directory the rule was declared in, relative to the source root ('' for the root file). */
+    readonly base: string;
+    /** A `!` rule: a later match re-includes. */
+    readonly negated: boolean;
+    /** A trailing-slash rule: matches directories only. */
+    readonly dirOnly: boolean;
+    /** True when the pattern contains a slash, so it is anchored to `base` rather than matching a basename at any depth. */
+    readonly anchored: boolean;
+    readonly source: string;
+    readonly re: RegExp;
+};
+/**
+ * Parse one `.gitignore` into rules. PURE — takes the text, not a path — so
+ * every pattern form is testable without a filesystem.
+ *
+ * @param base directory the file was found in, relative to the source root.
+ */
+export declare function parseGitignore(text: string, base?: string): IgnoreRule[];
+/**
+ * Does this path match the rule set? PURE, and shared with the bundle walker's
+ * `.helixignore` (`bundle.ts`), which uses the same grammar but none of the
+ * source archive's hard excludes.
+ *
+ * Rules are applied in order and the LAST match wins, which is what makes
+ * `!keep-me` work.
+ *
+ * @param relPath slash-separated path relative to the root the rules were read at.
+ */
+export declare function matchesIgnoreRules(relPath: string, isDirectory: boolean, rules: readonly IgnoreRule[]): boolean;
+/**
+ * Should this entry be left out of the archive?
+ *
+ * PURE, and the whole selection policy: the walker below decides nothing on its
+ * own. Hard excludes are checked first and are not negotiable.
+ *
+ * @param relPath slash-separated path relative to the source root.
+ */
+export declare function isSourceExcluded(relPath: string, isDirectory: boolean, rules: readonly IgnoreRule[]): boolean;
+export type SourceEntry = {
+    /** Slash-separated path inside the archive. */
+    readonly path: string;
+    readonly absolutePath: string;
+    readonly size: number;
+    /** True when the file carries the owner-execute bit, so scripts stay runnable after extraction. */
+    readonly executable: boolean;
+};
+/** Every file that belongs in the source archive, sorted, `.gitignore` and hard excludes applied. */
+export declare function collectSourceFiles(root: string): SourceEntry[];
+/** Build an uncompressed tar from in-memory entries. Pure. */
+export declare function tarBytes(entries: ReadonlyArray<{
+    path: string;
+    content: Buffer;
+    executable?: boolean;
+}>): Buffer;
+export type SourceArchive = {
+    readonly bytes: Buffer;
+    readonly files: readonly string[];
+    readonly uncompressedBytes: number;
+};
+/**
+ * Build the archive for `root`, or throw a sentence a creator can act on.
+ *
+ * `maxBytes` is a parameter rather than a constant read so a test can pin BOTH
+ * sides of the bound with a small fixture: a cap-sized archive must be accepted
+ * and a cap-plus-one archive must be refused. A test that only checks the
+ * refusal passes for every smaller cap too, which is not a bound.
+ */
+export declare function createSourceArchive(root: string, options?: {
+    maxBytes?: number;
+}): SourceArchive;
+/** Creator-facing size, e.g. `2.1 MB`. SI units, one decimal; sub-megabyte reads in KB. */
+export declare function formatArchiveSize(bytes: number): string;

package/dist/source-archive.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOURCE_ARCHIVE_FILENAME = exports.SOURCE_CONTENT_TYPE = exports.SOURCE_MAX_BYTES = exports.SOURCE_HARD_EXCLUDES = void 0;
+exports.parseGitignore = parseGitignore;
+exports.matchesIgnoreRules = matchesIgnoreRules;
+exports.isSourceExcluded = isSourceExcluded;
+exports.collectSourceFiles = collectSourceFiles;
+exports.tarBytes = tarBytes;
+exports.createSourceArchive = createSourceArchive;
+exports.formatArchiveSize = formatArchiveSize;
+// `helix-source.tar.gz` — the opt-in world SOURCE archive (CH-1457 edit-mode spec §9.1).
+//
+// This is what `helix publish --upload-source` sends up the SECOND channel, into
+// a private bucket. It is never part of the build's file list: the bundle
+// content-type allowlist has no archive type, raw `.ts` is deliberately excluded
+// from it, the 50 MiB bundle budget is the PLAYABLE budget, and every build file
+// is written to a public CDN path with a year-long immutable cache — a source
+// tarball there would be publicly downloadable.
+//
+// WHY A TAR WRITER LIVES HERE INSTEAD OF A DEPENDENCY. The archive must be
+// byte-reproducible and its contents must be assertable in a unit test, and it
+// must not depend on a `tar` binary being on PATH (this CLI runs on creators'
+// machines and inside CI images). ustar is ~60 lines and the alternative was a
+// new runtime dependency on the publish path for that. The test extracts the
+// result with the system `tar` to prove the bytes are a real archive rather than
+// a shape this file agrees with itself about.
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_zlib_1 = require("node:zlib");
+/**
+ * Directory/file names dropped no matter what any `.gitignore` says.
+ *
+ * This is deliberately the SAME list the Dreamer checkpoint uses
+ * (`dreamer-worker:src/runtime/CloudflareSandboxRuntime.ts` → `excludes`), so a
+ * world whose source arrives from the CLI and a world whose source arrives from
+ * a sandbox backup produce the same workspace shape. Edit mode restores both
+ * through one code path; if the two origins disagreed about what a workspace
+ * contains, that path would need to know where the source came from.
+ *
+ * Not overridable by a `.gitignore` negation. A creator who writes
+ * `!node_modules` has not thought about a 400 MB upload, and "hard" that a
+ * config file can switch off is not hard.
+ */
+exports.SOURCE_HARD_EXCLUDES = ['node_modules', '.git', 'dist', '.vite'];
+/**
+ * Client-side size cap, mirroring the server's `SOURCE_MAX_BYTES`
+ * (`helix-backend-api:src/instant-worlds/constants/world-source.ts`). Duplicated
+ * rather than imported because it lives in a different repo behind an authed
+ * endpoint; the point of holding it here is to refuse an over-cap archive
+ * BEFORE any network call, so the creator gets one readable sentence instead of
+ * a 400 after a long upload.
+ */
+exports.SOURCE_MAX_BYTES = 128 * 1024 * 1024;
+/** The IANA registration. The server also accepts `application/x-gzip`; we only ever send this one. */
+exports.SOURCE_CONTENT_TYPE = 'application/gzip';
+/** What the archive is called in creator-facing messages. */
+exports.SOURCE_ARCHIVE_FILENAME = 'helix-source.tar.gz';
+// Glob → RegExp for one gitignore pattern. `**` crosses separators, `*` and `?` do not.
+function patternToRegExp(pattern) {
+    let out = '';
+    for (let i = 0; i < pattern.length; i += 1) {
+        const c = pattern[i];
+        if (c === '*') {
+            if (pattern[i + 1] === '*') {
+                // `**/` collapses to "zero or more path segments"; a bare `**` crosses separators.
+                if (pattern[i + 2] === '/') {
+                    out += '(?:.*/)?';
+                    i += 2;
+                }
+                else {
+                    out += '.*';
+                    i += 1;
+                }
+            }
+            else {
+                out += '[^/]*';
+            }
+        }
+        else if (c === '?') {
+            out += '[^/]';
+        }
+        else if (c === '[') {
+            const close = pattern.indexOf(']', i + 1);
+            if (close === -1) {
+                out += '\\[';
+            }
+            else {
+                const body = pattern.slice(i + 1, close).replace(/^!/, '^');
+                out += `[${body}]`;
+                i = close;
+            }
+        }
+        else {
+            out += c.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+        }
+    }
+    return new RegExp(`^${out}$`);
+}
+/**
+ * Parse one `.gitignore` into rules. PURE — takes the text, not a path — so
+ * every pattern form is testable without a filesystem.
+ *
+ * @param base directory the file was found in, relative to the source root.
+ */
+function parseGitignore(text, base = '') {
+    const rules = [];
+    for (const rawLine of text.split(/\r?\n/)) {
+        // Trailing whitespace is insignificant unless backslash-escaped; leading is significant.
+        const line = rawLine.replace(/(?<!\\)\s+$/, '');
+        if (!line || line.startsWith('#'))
+            continue;
+        let pattern = line;
+        let negated = false;
+        if (pattern.startsWith('!')) {
+            negated = true;
+            pattern = pattern.slice(1);
+        }
+        else if (pattern.startsWith('\\!') || pattern.startsWith('\\#')) {
+            pattern = pattern.slice(1);
+        }
+        let dirOnly = false;
+        if (pattern.endsWith('/')) {
+            dirOnly = true;
+            pattern = pattern.slice(0, -1);
+        }
+        if (!pattern)
+            continue;
+        // A slash anywhere but the end anchors the pattern to the declaring directory.
+        const anchored = pattern.includes('/');
+        if (pattern.startsWith('/'))
+            pattern = pattern.slice(1);
+        rules.push({ base, negated, dirOnly, anchored, source: line, re: patternToRegExp(pattern) });
+    }
+    return rules;
+}
+function withinBase(relPath, base) {
+    if (!base)
+        return relPath;
+    const prefix = `${base}/`;
+    return relPath.startsWith(prefix) ? relPath.slice(prefix.length) : null;
+}
+/**
+ * Does this path match the rule set? PURE, and shared with the bundle walker's
+ * `.helixignore` (`bundle.ts`), which uses the same grammar but none of the
+ * source archive's hard excludes.
+ *
+ * Rules are applied in order and the LAST match wins, which is what makes
+ * `!keep-me` work.
+ *
+ * @param relPath slash-separated path relative to the root the rules were read at.
+ */
+function matchesIgnoreRules(relPath, isDirectory, rules) {
+    let excluded = false;
+    for (const rule of rules) {
+        if (rule.dirOnly && !isDirectory)
+            continue;
+        const candidate = withinBase(relPath, rule.base);
+        if (candidate === null)
+            continue;
+        const subject = rule.anchored ? candidate : candidate.slice(candidate.lastIndexOf('/') + 1);
+        if (rule.re.test(subject))
+            excluded = !rule.negated;
+    }
+    return excluded;
+}
+/**
+ * Should this entry be left out of the archive?
+ *
+ * PURE, and the whole selection policy: the walker below decides nothing on its
+ * own. Hard excludes are checked first and are not negotiable.
+ *
+ * @param relPath slash-separated path relative to the source root.
+ */
+function isSourceExcluded(relPath, isDirectory, rules) {
+    const name = relPath.slice(relPath.lastIndexOf('/') + 1);
+    if (exports.SOURCE_HARD_EXCLUDES.includes(name))
+        return true;
+    return matchesIgnoreRules(relPath, isDirectory, rules);
+}
+function walk(absDir, relDir, inherited, out) {
+    const ignoreFile = (0, node_path_1.join)(absDir, '.gitignore');
+    const rules = (0, node_fs_1.existsSync)(ignoreFile)
+        ? [...inherited, ...parseGitignore((0, node_fs_1.readFileSync)(ignoreFile, 'utf8'), relDir)]
+        : inherited;
+    for (const entry of (0, node_fs_1.readdirSync)(absDir, { withFileTypes: true }).sort((a, b) => (a.name < b.name ? -1 : 1))) {
+        // Symlinks, sockets and fifos are skipped: a tarball that carries a link out
+        // of the project extracts into a workspace where it points at nothing, and
+        // following it would silently pull in whatever it aimed at.
+        if (!entry.isDirectory() && !entry.isFile())
+            continue;
+        const rel = relDir ? `${relDir}/${entry.name}` : entry.name;
+        if (isSourceExcluded(rel, entry.isDirectory(), rules))
+            continue;
+        if (entry.isDirectory()) {
+            // Pruning, not filtering: git cannot re-include a file whose parent
+            // directory is excluded, and neither can we.
+            walk((0, node_path_1.join)(absDir, entry.name), rel, rules, out);
+        }
+        else {
+            const stat = (0, node_fs_1.statSync)((0, node_path_1.join)(absDir, entry.name));
+            out.push({
+                path: rel,
+                absolutePath: (0, node_path_1.join)(absDir, entry.name),
+                size: stat.size,
+                executable: (stat.mode & 0o100) !== 0,
+            });
+        }
+    }
+}
+/** Every file that belongs in the source archive, sorted, `.gitignore` and hard excludes applied. */
+function collectSourceFiles(root) {
+    const out = [];
+    walk(root, '', [], out);
+    return out.sort((a, b) => (a.path < b.path ? -1 : 1));
+}
+// --- tar ------------------------------------------------------------------
+const BLOCK = 512;
+function octal(value, width) {
+    return value.toString(8).padStart(width - 1, '0') + '\0';
+}
+// One ustar header block. `mtime` is fixed at 0 by the caller so the same tree
+// always produces the same bytes — a reproducible archive is what lets a test
+// assert the archive rather than assert that some bytes were produced.
+function tarHeader(path, size, mode) {
+    let name = path;
+    let prefix = '';
+    if (Buffer.byteLength(name) > 100) {
+        // ustar splits a long path at a '/' into prefix (<=155) + name (<=100).
+        // Take the EARLIEST split that makes the tail fit, which leaves the most
+        // room in the prefix for the head.
+        const at = [...path].reduce((acc, ch, i) => (ch === '/' ? [...acc, i] : acc), []).find((i) => Buffer.byteLength(path.slice(i + 1)) <= 100);
+        if (at === undefined || Buffer.byteLength(path.slice(0, at)) > 155) {
+            throw new Error(`cannot archive "${path}": the path does not fit tar's 100-byte name / 155-byte prefix limits. ` +
+                'Shorten the path or exclude it in .gitignore.');
+        }
+        prefix = path.slice(0, at);
+        name = path.slice(at + 1);
+    }
+    const header = Buffer.alloc(BLOCK);
+    header.write(name, 0, 100, 'utf8');
+    header.write(octal(mode, 8), 100, 8, 'ascii');
+    header.write(octal(0, 8), 108, 8, 'ascii'); // uid
+    header.write(octal(0, 8), 116, 8, 'ascii'); // gid
+    header.write(octal(size, 12), 124, 12, 'ascii');
+    header.write(octal(0, 12), 136, 12, 'ascii'); // mtime — fixed, see above
+    header.write('        ', 148, 8, 'ascii'); // checksum placeholder: 8 spaces
+    header.write('0', 156, 1, 'ascii'); // typeflag: regular file
+    header.write('ustar\0', 257, 6, 'ascii');
+    header.write('00', 263, 2, 'ascii');
+    header.write(prefix, 345, 155, 'utf8');
+    let sum = 0;
+    for (const byte of header)
+        sum += byte;
+    header.write(octal(sum, 7) + ' ', 148, 8, 'ascii');
+    return header;
+}
+function pad(size) {
+    const rem = size % BLOCK;
+    return rem === 0 ? 0 : BLOCK - rem;
+}
+/** Build an uncompressed tar from in-memory entries. Pure. */
+function tarBytes(entries) {
+    const parts = [];
+    for (const entry of entries) {
+        parts.push(tarHeader(entry.path, entry.content.byteLength, entry.executable ? 0o755 : 0o644));
+        parts.push(entry.content);
+        parts.push(Buffer.alloc(pad(entry.content.byteLength)));
+    }
+    parts.push(Buffer.alloc(BLOCK * 2)); // end-of-archive
+    return Buffer.concat(parts);
+}
+/**
+ * Build the archive for `root`, or throw a sentence a creator can act on.
+ *
+ * `maxBytes` is a parameter rather than a constant read so a test can pin BOTH
+ * sides of the bound with a small fixture: a cap-sized archive must be accepted
+ * and a cap-plus-one archive must be refused. A test that only checks the
+ * refusal passes for every smaller cap too, which is not a bound.
+ */
+function createSourceArchive(root, options = {}) {
+    const maxBytes = options.maxBytes ?? exports.SOURCE_MAX_BYTES;
+    if (!(0, node_fs_1.existsSync)(root) || !(0, node_fs_1.statSync)(root).isDirectory()) {
+        throw new Error(`source directory "${root}" does not exist — pass --source-dir <path> to point at the project`);
+    }
+    const selected = collectSourceFiles(root);
+    if (selected.length === 0) {
+        throw new Error(`no source files found in "${root}" — everything there is excluded by .gitignore or by ${exports.SOURCE_HARD_EXCLUDES.join('/')}. ` +
+            'Pass --source-dir <path> to point at the project directory rather than the built bundle.');
+    }
+    const tar = tarBytes(selected.map((file) => ({
+        path: file.path,
+        content: (0, node_fs_1.readFileSync)(file.absolutePath),
+        executable: file.executable,
+    })));
+    const bytes = (0, node_zlib_1.gzipSync)(tar, { level: 9 });
+    if (bytes.byteLength > maxBytes) {
+        throw new Error(`${exports.SOURCE_ARCHIVE_FILENAME} is ${formatArchiveSize(bytes.byteLength)} — the source upload limit is ` +
+            `${formatArchiveSize(maxBytes)}. Nothing was uploaded. Exclude large files in .gitignore, or publish ` +
+            'without --upload-source.');
+    }
+    return { bytes, files: selected.map((f) => f.path), uncompressedBytes: tar.byteLength };
+}
+/** Creator-facing size, e.g. `2.1 MB`. SI units, one decimal; sub-megabyte reads in KB. */
+function formatArchiveSize(bytes) {
+    if (bytes >= 1_000_000)
+        return `${(bytes / 1_000_000).toFixed(1)} MB`;
+    return `${Math.max(1, Math.round(bytes / 1000))} KB`;
+}
+//# sourceMappingURL=source-archive.js.map

package/dist/source-archive.js.map

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

package/dist/stdioBlocking.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/stdioBlocking.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+for (const stream of [process.stdout, process.stderr]) {
+    try {
+        stream._handle?.setBlocking?.(true);
+    }
+    catch { /* not a pipe/TTY handle: nothing to do */ }
+}
+//# sourceMappingURL=stdioBlocking.js.map

package/dist/stdioBlocking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioBlocking.js","sourceRoot":"","sources":["../src/stdioBlocking.ts"],"names":[],"mappings":";;AAKA,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAA2B,EAAE,CAAC;IAChF,IAAI,CAAC;QAAC,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,0CAA0C,CAAC,CAAC;AACnG,CAAC"}

package/dist/terrain/bake.d.ts

@@ -0,0 +1,40 @@
+import { type SceneTerrainMaterialRole } from '@hypersoniclabs/helix-manifest';
+import { type HeightGrid } from './grid';
+import { type TerrainPreset } from './presets';
+import { type TerrainSource } from './tile';
+/** A channel of an authored splat image, in the order sharp hands them back. */
+export type TerrainSplatChannel = 'R' | 'G' | 'B' | 'A';
+/**
+ * An RGBA8 splat authored outside the CLI, covering the grid's world extent exactly: column 0 sits on `originX`,
+ * row 0 on `originZ`. A role named in `roles` takes its weight from that channel instead of the preset's rule.
+ */
+export interface TerrainSplatSource {
+    width: number;
+    height: number;
+    channels: 4;
+    data: Uint8Array;
+    roles: Partial<Record<TerrainSplatChannel, SceneTerrainMaterialRole>>;
+}
+export interface BakeTerrainOptions {
+    /** Seed of the per-role noise term; the landform's own seed is irrelevant to it. */
+    seed?: number;
+    /**
+     * The authoring grid the source was tiled from. Without it the bake reassembles the grid from the tiles, whose
+     * heights are u16 over the TILE's range: a 400 m tile quantizes to 6 mm steps, which terraces the normals.
+     */
+    grid?: HeightGrid;
+    /** An authored splat that overrides the preset's rules for the roles it names. */
+    splat?: TerrainSplatSource;
+}
+/** Channels one splat pixel carries; a role past the fourth is folded into the kept role with the most weight. */
+export declare const SPLAT_CHANNELS = 4;
+/**
+ * Evaluates the preset's rules at every splat pixel and writes one RGBA8 PNG per tile plus one for the coarse layer,
+ * and the matching normal map beside each. Slope, curvature and the normals come from the reassembled full grid, so
+ * neither the weights nor the normals step at a tile boundary.
+ */
+export declare function bakeTerrainSplats(source: TerrainSource, preset: TerrainPreset, options?: BakeTerrainOptions): Promise<TerrainSource>;
+/** Loads an authored RGBA8 splat off disk in the shape `bakeTerrainSplats` takes, alpha included whatever the PNG carries. */
+export declare function readTerrainSplatSource(pngPath: string, roles: Partial<Record<TerrainSplatChannel, SceneTerrainMaterialRole>>): Promise<TerrainSplatSource>;
+/** Authoring consumers sample semantic roles before the four-channel material folding. */
+export declare function createTerrainRoleSampler(grid: HeightGrid, preset: TerrainPreset, seed?: number): (i: number, j: number) => Partial<Record<SceneTerrainMaterialRole, number>>;