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

package/dist/sceneImport/compiler.d.ts

@@ -0,0 +1,36 @@
+export type KnownSceneSource = 'helsinki-672496d1' | 'bistro-interior';
+export declare function inventoryKnownSceneSource(source: KnownSceneSource, archivePath: string): Promise<{
+    schemaVersion: string;
+    source: KnownSceneSource;
+    originalSha256: string;
+    archive: {
+        entries: number;
+        compressedBytes: number;
+        uncompressedBytes: number;
+    };
+    selected: {
+        entries: number;
+        uncompressedBytes: number;
+        paths: string[];
+    };
+    attribution: {
+        license: string;
+        licenseUrl: string;
+        creator: string;
+        title: string;
+        url: string;
+        citation?: string;
+        changes: string;
+    };
+}>;
+export declare function compileKnownSceneSource(input: {
+    source: KnownSceneSource;
+    archivePath: string;
+    outputDir: string;
+}): Promise<{
+    scenePath: string;
+    receiptPath: string;
+    resourcePaths: string[];
+    totalBytes: number;
+    scene: import("@hypersoniclabs/helix-manifest").HelixSceneV2;
+}>;

package/dist/sceneImport/compiler.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inventoryKnownSceneSource = inventoryKnownSceneSource;
+exports.compileKnownSceneSource = compileKnownSceneSource;
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const archive_1 = require("./archive");
+const fbx_1 = require("./fbx");
+const obj_1 = require("./obj");
+const helsinkiTiles_1 = require("./helsinkiTiles");
+const package_1 = require("./package");
+const types_1 = require("./types");
+const HELSINKI_SHA = '38cdce6d0a1570aa0b11bc74ba955d08ac422867d69cf0d1af1d19ad20110a32';
+const BISTRO_SHA = '0d50e3c724c6c5da19f8eb99ad3f53e36fec37ffa2df9621f9ccf0603f3934e1';
+const BISTRO_MEMBERS = {
+    fbx: 'Bistro_v5_2/BistroInterior.fbx',
+};
+async function inventoryKnownSceneSource(source, archivePath) {
+    const profile = sourceProfile(source);
+    const inventory = await (0, archive_1.inventorySourceArchive)(archivePath, profile.sha256);
+    const selected = source === 'helsinki-672496d1'
+        ? inventory.entries.filter((entry) => entry.path.startsWith('672496d1/'))
+        : inventory.entries.filter((entry) => entry.path === BISTRO_MEMBERS.fbx || /\.(dds|tga)$/i.test(entry.path));
+    return {
+        schemaVersion: 'helix.scene-source-inventory/1',
+        source,
+        originalSha256: inventory.sha256,
+        archive: {
+            entries: inventory.entries.length,
+            compressedBytes: inventory.compressedBytes,
+            uncompressedBytes: inventory.uncompressedBytes,
+        },
+        selected: {
+            entries: selected.length,
+            uncompressedBytes: selected.reduce((sum, entry) => sum + entry.uncompressedSize, 0),
+            paths: selected.map((entry) => entry.path),
+        },
+        attribution: profile.receipt.attribution,
+    };
+}
+async function compileKnownSceneSource(input) {
+    await (0, package_1.assertEmptySceneOutput)(input.outputDir);
+    return input.source === 'helsinki-672496d1'
+        ? compileHelsinki(input.archivePath, input.outputDir)
+        : compileBistro(input.archivePath, input.outputDir);
+}
+async function compileHelsinki(archivePath, outputDir) {
+    const profile = sourceProfile('helsinki-672496d1');
+    const work = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'helix-helsinki-'));
+    try {
+        const detailMembers = (0, helsinkiTiles_1.helsinkiDetailMembers)(helsinkiTiles_1.HELSINKI_DETAIL_LEVEL);
+        const files = await (0, archive_1.extractArchiveMembers)({
+            archivePath,
+            expectedSha256: profile.sha256,
+            members: [
+                helsinkiTiles_1.HELSINKI_PROXY_OBJ,
+                ...detailMembers.flatMap((member) => [member.obj, member.texture]),
+            ],
+            outputDir: work,
+        });
+        const cellOrigin = [6500, 4500, 0];
+        const proxy = await (0, obj_1.compileObjGlb)({
+            sourceName: (0, node_path_1.basename)(helsinkiTiles_1.HELSINKI_PROXY_OBJ),
+            obj: await (0, promises_1.readFile)(required(files, helsinkiTiles_1.HELSINKI_PROXY_OBJ)),
+            localOrigin: cellOrigin,
+            receipt: profile.receipt,
+            axisMapping: helsinkiToHelix,
+        });
+        proxy.filename = 'helsinki-672496d1-l13.proxy.glb';
+        const detail = await (0, obj_1.compileObjParts)({
+            sourceName: `${helsinkiTiles_1.HELSINKI_TILE_PREFIX}_L${helsinkiTiles_1.HELSINKI_DETAIL_LEVEL}.obj`,
+            parts: await Promise.all(detailMembers.map(async (member) => ({
+                name: (0, node_path_1.basename)(member.obj),
+                obj: await (0, promises_1.readFile)(required(files, member.obj)),
+                texture: {
+                    bytes: await (0, promises_1.readFile)(required(files, member.texture)),
+                    mimeType: 'image/jpeg',
+                },
+            }))),
+            localOrigin: cellOrigin,
+            receipt: profile.receipt,
+            axisMapping: helsinkiToHelix,
+        });
+        detail.filename = `helsinki-672496d1-l${helsinkiTiles_1.HELSINKI_DETAIL_LEVEL}.detail.glb`;
+        return (0, package_1.createSceneV2Package)({
+            outputDir,
+            title: 'Helsinki 672496d1',
+            sourceId: profile.receipt.sourceId,
+            proxy,
+            detail,
+            bounds: unionBounds(proxy.bounds, detail.bounds),
+            receipt: profile.receipt,
+        });
+    }
+    finally {
+        await (0, promises_1.rm)(work, { recursive: true, force: true });
+    }
+}
+async function compileBistro(archivePath, outputDir) {
+    const profile = sourceProfile('bistro-interior');
+    const inventory = await (0, archive_1.inventorySourceArchive)(archivePath, profile.sha256);
+    const archiveTextureMembers = inventory.entries
+        .map((entry) => entry.path)
+        .filter((path) => /\.(dds|tga)$/i.test(path));
+    const archiveMemberByBasename = new Map();
+    for (const member of archiveTextureMembers) {
+        const key = (0, node_path_1.basename)(member).toLowerCase();
+        if (!archiveMemberByBasename.has(key))
+            archiveMemberByBasename.set(key, member);
+    }
+    const work = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'helix-bistro-'));
+    try {
+        const files = await (0, archive_1.extractArchiveMembers)({
+            archivePath,
+            expectedSha256: profile.sha256,
+            members: Object.values(BISTRO_MEMBERS),
+            outputDir: work,
+        });
+        const converted = await (0, fbx_1.compileFbxGeometryGlbs)({
+            path: required(files, BISTRO_MEMBERS.fbx),
+            sourceName: 'BistroInterior.fbx',
+            receipt: profile.receipt,
+            maxTextureDimension: 384,
+            resolveTextures: (basenames) => resolveBistroTextures({ archivePath, expectedSha256: profile.sha256, archiveMemberByBasename, basenames }),
+        });
+        const receipt = {
+            ...profile.receipt,
+            unsupported: converted.detailPlan.unsupported,
+        };
+        const packaged = await (0, package_1.createSceneV2Package)({
+            outputDir,
+            title: 'Amazon Lumberyard Bistro Interior',
+            sourceId: receipt.sourceId,
+            ...(converted.proxy ? { proxy: converted.proxy } : {}),
+            detail: converted.detail,
+            bounds: converted.proxy
+                ? unionBounds(converted.proxy.bounds, converted.detail.bounds)
+                : converted.detail.bounds,
+            receipt,
+        });
+        const detailPlanPath = (0, node_path_1.join)(outputDir, 'bistro-detail-plan.json');
+        await (0, promises_1.writeFile)(detailPlanPath, `${JSON.stringify(converted.detailPlan, null, 2)}\n`);
+        return { ...packaged, detailPlanPath };
+    }
+    finally {
+        await (0, promises_1.rm)(work, { recursive: true, force: true });
+    }
+}
+async function resolveBistroTextures(input) {
+    const memberByRequested = new Map();
+    for (const requested of input.basenames) {
+        const member = input.archiveMemberByBasename.get(requested.toLowerCase());
+        if (member)
+            memberByRequested.set(requested, member);
+    }
+    const result = new Map();
+    if (memberByRequested.size === 0)
+        return result;
+    const work = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'helix-bistro-textures-'));
+    try {
+        const extracted = await (0, archive_1.extractArchiveMembers)({
+            archivePath: input.archivePath,
+            expectedSha256: input.expectedSha256,
+            members: [...new Set(memberByRequested.values())],
+            outputDir: work,
+        });
+        for (const [requested, member] of memberByRequested) {
+            const filePath = extracted.get(member);
+            if (filePath)
+                result.set(requested, await (0, promises_1.readFile)(filePath));
+        }
+        return result;
+    }
+    finally {
+        await (0, promises_1.rm)(work, { recursive: true, force: true });
+    }
+}
+function sourceProfile(source) {
+    if (source === 'helsinki-672496d1') {
+        return {
+            sha256: HELSINKI_SHA,
+            receipt: {
+                schemaVersion: 'helix.scene-source-conversion/1',
+                sourceId: 'city-of-helsinki.2017.672496d1',
+                originalSha256: HELSINKI_SHA,
+                attribution: {
+                    license: 'CC BY 4.0',
+                    licenseUrl: 'https://creativecommons.org/licenses/by/4.0/',
+                    creator: 'City of Helsinki',
+                    title: 'Helsinki 3D 2017 reality mesh, sheet 672496x2',
+                    url: 'https://www.hel.fi/en/decision-making/information-on-helsinki/maps-and-geospatial-data/helsinki-3d',
+                    changes: 'HELIX selected cell 672496d1, normalized its local origin and axes, compiled L13/L16 GLBs, and packaged two Scene v2 LODs.',
+                },
+                rights: (0, types_1.sourceRightsForLicense)('CC BY 4.0'),
+                sourceCrs: 'EPSG:3879+5773',
+                sourceOrigin: [25490000, 6668000, 0],
+                conversion: {
+                    geometry: 'L13 proxy and L16 detail; cell-local origin [6500,4500,0] subtracted; source east/north/height mapped to HELIX +X/-Z/+Y meters',
+                    materials: 'L13 geometry-only default material; L16 source JPEG base color embedded in GLB',
+                    normalMaps: 'not present in selected Helsinki OBJ renditions',
+                    orm: 'not present in selected Helsinki OBJ renditions',
+                },
+                unsupported: [],
+            },
+        };
+    }
+    return {
+        sha256: BISTRO_SHA,
+        receipt: {
+            schemaVersion: 'helix.scene-source-conversion/1',
+            sourceId: 'nvidia-orca.amazon-lumberyard-bistro.v5.2.interior',
+            originalSha256: BISTRO_SHA,
+            attribution: {
+                license: 'CC BY 4.0',
+                licenseUrl: 'https://creativecommons.org/licenses/by/4.0/',
+                creator: 'Amazon Lumberyard',
+                title: 'Amazon Lumberyard Bistro, Open Research Content Archive (ORCA)',
+                url: 'https://developer.nvidia.com/orca/amazon-lumberyard-bistro',
+                citation: 'Amazon Lumberyard Bistro, Open Research Content Archive (ORCA), Amazon Lumberyard, 2017',
+                changes: 'HELIX preserved FBX node transforms and material assignments, simplified geometry into proxy/detail GLBs, decoded referenced DDS/TGA textures, converted DirectX normals to glTF tangent space, downscaled textures to a 384px maximum dimension, embedded the converted textures in the detail GLB, and emitted an explicit conversion plan.',
+            },
+            rights: (0, types_1.sourceRightsForLicense)('CC BY 4.0'),
+            sourceCrs: null,
+            sourceOrigin: [0, 0, 0],
+            conversion: {
+                geometry: 'FBX source hierarchy preserved; detail and geometry-only proxy simplified deterministically',
+                materials: 'detail bakes decoded base-color/opacity, DirectX-normal and packed-ORM/emissive textures referenced by each FBX material directly into the GLB, bounded to a maximum texture dimension; textures a material references but that are missing or in an unsupported format are listed under unsupported and left on the flat HELIX fallback color; proxy uses one HELIX default material',
+                normalMaps: 'DDS/TGA DirectX normals are decoded (BC5/ATI2) and green-channel inverted to OpenGL/glTF tangent space before embedding',
+                orm: 'Bistro Specular DDS/TGA (BC3/DXT5) is decoded and packed unchanged as R=occlusion, G=roughness, B=metalness into a combined glTF occlusion+metallicRoughness texture',
+            },
+            unsupported: [],
+        },
+    };
+}
+function helsinkiToHelix([east, north, height]) {
+    return [east, height, -north];
+}
+function unionBounds(a, b) {
+    return {
+        min: a.min.map((value, axis) => Math.min(value, b.min[axis])),
+        max: a.max.map((value, axis) => Math.max(value, b.max[axis])),
+    };
+}
+function required(files, member) {
+    const path = files.get(member);
+    if (!path)
+        throw new Error(`extracted source is missing ${member}`);
+    return path;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/sceneImport/compiler.js.map

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

package/dist/sceneImport/composeMounts.d.ts

@@ -0,0 +1,159 @@
+import { type HelixSceneV2, type SceneBounds, type SceneQuaternion, type SceneShadow, type SceneVec3 } from '@hypersoniclabs/helix-manifest';
+export interface ComposeMountEntry {
+    /** Document-local mount id, e.g. `mount.exterior`. */
+    id: string;
+    /** The child's published entry URL (`.../scene-v2/<sha256>/scene.helix-scene.json`). */
+    entryUrl?: string;
+    /** Path to a `scene-source publish` receipt; its `receipt.scene.entryUrl` is used. */
+    receipt?: string;
+    /** Path to a local child document. Offline authoring; publication is NOT proven. */
+    document?: string;
+    /** Which of the child's profiles to instantiate. Defaults to the parent's profile id. */
+    profile?: string;
+    position?: SceneVec3;
+    rotation?: SceneQuaternion;
+    /** Uniform positive scale. A mount transform may not be non-uniform or mirrored. */
+    scale?: number;
+    mode?: 'eager' | 'distance';
+    priority?: number;
+    /** Override the activation volume. Defaults to the child's own composed footprint. */
+    bounds?: SceneBounds;
+    /** Metres of slack added around the derived footprint. Default 2. */
+    padM?: number;
+    /** Free-form label carried into the receipt. SceneNode has no name field. */
+    name?: string;
+}
+export interface ComposeMountsPlan {
+    sceneId: string;
+    revision: string;
+    title: string;
+    profile?: string;
+    memoryBudgetMiB?: number;
+    streamRadiusM?: number;
+    environment?: Partial<HelixSceneV2['environment']>;
+    /** Root/global physical lights. Mounted children keep only resident practicals. */
+    lights?: ComposeLightEntry[];
+    /** Renderer hints for the composed world. Defaults to the first child's. */
+    runtimeExtensions?: HelixSceneV2['runtimeExtensions'];
+    spawn?: {
+        position: SceneVec3;
+        rotation?: SceneQuaternion;
+        clearanceRadiusM?: number;
+        clearanceHeightM?: number;
+    };
+    attribution: {
+        license: string;
+        licenseUrl: string;
+        creator: string;
+        title?: string;
+        url: string;
+    };
+    mounts: ComposeMountEntry[];
+}
+type ComposeLightBase = {
+    id: string;
+    position?: SceneVec3;
+    rotation?: SceneQuaternion;
+    color: string;
+    shadow?: SceneShadow;
+    required?: boolean;
+};
+export type ComposeLightEntry = ComposeLightBase & ({
+    type: 'directional';
+    illuminanceLux: number;
+} | {
+    type: 'point';
+    luminousIntensityCandela: number;
+    rangeM: number;
+} | {
+    type: 'spot';
+    luminousIntensityCandela: number;
+    rangeM: number;
+    innerConeDeg: number;
+    outerConeDeg: number;
+});
+export interface ResolvedChild {
+    entry: ComposeMountEntry;
+    /** Where the bytes came from, verbatim, for the receipt. */
+    origin: string;
+    /** True only when the bytes were read back over the network from the lane. */
+    published: boolean;
+    scene: HelixSceneV2;
+    sha256: string;
+    profileId: string;
+    budgetMiB: number;
+    depth: number;
+    /** The child's own footprint, in child space, before the mount transform. */
+    childBounds: SceneBounds;
+}
+export interface ComposeMountsResult {
+    scene: HelixSceneV2;
+    sceneBytes: number;
+    mounts: Array<{
+        id: string;
+        scene: string;
+        revision: string;
+        sha256: string;
+        budgetMiB: number;
+        depth: number;
+        published: boolean;
+        bounds: SceneBounds;
+        mode: string;
+    }>;
+    mountDepth: number;
+    memoryBudgetMiB: number;
+    streamRadiusM: number;
+    bounds: SceneBounds;
+    warnings: string[];
+}
+type Fetcher = (url: string) => Promise<{
+    ok: boolean;
+    status: number;
+    bytes: Buffer;
+}>;
+/**
+ * Read one child's bytes and answer every question the backend's `resolveMount`
+ * will ask, before a single byte of the parent is written.
+ *
+ * The child is addressed by its own document digest, which is also its storage
+ * address, so a fetched document that hashes to something else is not a stale
+ * mirror to tolerate — it is a different document, and the pin would be a lie.
+ */
+export declare function resolveChildScene(entry: ComposeMountEntry, options: {
+    defaultProfile: string;
+    fetchImpl?: Fetcher;
+}): Promise<ResolvedChild>;
+/**
+ * A child's footprint, taken from the activation volumes it already authored.
+ *
+ * Stream-cell bounds are the child compiler's own measurement of where its
+ * geometry is; node transforms are pivots and would under-report a mesh that
+ * extends away from its origin. Cells outside the mounted profile's root are
+ * not loaded, so they are not part of the footprint either.
+ */
+export declare function sceneFootprint(scene: HelixSceneV2, profileId: string): SceneBounds;
+/** Rotate/scale/translate an AABB's eight corners and re-fit an AABB to them. */
+export declare function transformBounds(bounds: SceneBounds, position: SceneVec3, rotation: SceneQuaternion, scale: number): SceneBounds;
+/**
+ * Build the parent document.
+ *
+ * One mount = one node = one stream group = one cell. A mount node's TRANSFORM
+ * places the child's geometry; the CELL's bounds decide when it activates, and
+ * the two are independent on purpose: children cut out of one shared coordinate
+ * space are mounted at identity and would otherwise all sit in one cell at the
+ * origin and stream as a single unit.
+ */
+export declare function composeMountedScene(plan: ComposeMountsPlan, children: ResolvedChild[]): ComposeMountsResult;
+/**
+ * Resolve every child, compose the parent, and write a package directory that
+ * `scene-source publish` accepts as-is.
+ */
+export declare function composeMountsPackage(input: {
+    plan: ComposeMountsPlan;
+    outputDir: string;
+    fetchImpl?: Fetcher;
+}): Promise<ComposeMountsResult & {
+    outputDir: string;
+}>;
+export declare function readComposePlan(path: string): Promise<ComposeMountsPlan>;
+export {};