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

package/dist/sceneImport/materials/recipe.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMaterialPackageRecipe = buildMaterialPackageRecipe;
+exports.buildMaterialBulkRecipe = buildMaterialBulkRecipe;
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const identity_1 = require("../../continuum/identity");
+function rgba(hex) {
+    if (!/^#[0-9a-f]{6}$/i.test(hex))
+        throw new Error(`invalid material swatch ${hex}`);
+    const value = Number.parseInt(hex.slice(1), 16);
+    return [(value >> 16) / 255, ((value >> 8) & 255) / 255, (value & 255) / 255, 1];
+}
+function sortedTextureSet(textures) {
+    return Object.fromEntries(Object.entries(textures)
+        .filter((entry) => Boolean(entry[1]))
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([role, texture]) => [
+        role,
+        { ...texture, object: { ...texture.object } },
+    ]));
+}
+function uniqueObjects(root, definition) {
+    const objects = new Map([[root.cid, root]]);
+    (0, helix_manifest_1.continuumMaterialObjectReferences)(definition).forEach((object) => objects.set(object.cid, object));
+    return [...objects.values()];
+}
+/**
+ * Deterministic publication intent. It emits no URLs and performs no upload;
+ * the backend seals the exact objects and Package Version later.
+ */
+function buildMaterialPackageRecipe(input) {
+    const packageId = input.packageId ?? (0, identity_1.deterministicContinuumUuid)(`helix.material.catalog/1\0${input.entry.id}`);
+    (0, identity_1.assertContinuumUuid)(packageId, 'Material Package id');
+    const entry = {
+        ...input.entry,
+        tags: [...new Set(input.entry.tags)].sort(),
+        requiredMaps: [...new Set(input.entry.requiredMaps)].sort(),
+        provenance: { ...input.entry.provenance },
+        ...(input.entry.legacy ? { legacy: { ...input.entry.legacy } } : {}),
+    };
+    const variants = input.artifacts.variants
+        .map((variant) => ({ ...variant, textures: sortedTextureSet(variant.textures) }))
+        .sort((a, b) => a.id.localeCompare(b.id));
+    const definition = {
+        schema: helix_manifest_1.CONTINUUM_MATERIAL_DEFINITION_SCHEMA,
+        shaderModel: 'pbr-metallic-roughness',
+        surfaceModel: entry.surfaceModel,
+        baseColorFactor: rgba(entry.swatch),
+        repeatPerMeter: entry.repeatPerMeter,
+        roughnessFactor: entry.roughness,
+        metallicFactor: entry.metalness,
+        transmissionFactor: entry.transmission ?? 0,
+        ior: 1.5,
+        normalScale: entry.normalScale,
+        occlusionStrength: 1,
+        emissiveFactor: [0, 0, 0],
+        opacity: entry.opacityMode === 'mask' ? { mode: 'mask', cutoff: 0.5 } : { mode: entry.opacityMode },
+        doubleSided: entry.surfaceModel === 'foliage',
+        sampler: {
+            wrapS: 'repeat',
+            wrapT: 'repeat',
+            minFilter: 'linear-mipmap-linear',
+            magFilter: 'linear',
+            anisotropy: 8,
+        },
+        textures: sortedTextureSet(input.artifacts.sourceTextures ?? {}),
+        variants,
+        ...(input.artifacts.sourceFallback
+            ? {
+                sourceFallback: {
+                    ...input.artifacts.sourceFallback,
+                    object: { ...input.artifacts.sourceFallback.object },
+                },
+            }
+            : {}),
+    };
+    const definitionBytes = (0, helix_manifest_1.canonicalContinuumMaterialDefinitionBytes)(definition);
+    const definitionCid = (0, helix_manifest_1.continuumMaterialDefinitionCid)(definition);
+    const root = {
+        cid: definitionCid,
+        bytes: definitionBytes.byteLength,
+        mediaType: 'application/vnd.helix.material+json;version=1',
+        role: 'material-definition',
+    };
+    const objects = uniqueObjects(root, definition);
+    const pkg = {
+        schema: helix_manifest_1.CONTINUUM_PACKAGE_SCHEMA,
+        id: packageId,
+        type: 'material',
+        name: entry.name,
+    };
+    const packageVersion = {
+        schema: helix_manifest_1.CONTINUUM_PACKAGE_VERSION_SCHEMA,
+        package: { id: pkg.id, type: pkg.type },
+        version: input.version,
+        root,
+        dependencies: [],
+        variants: [],
+        compatibility: {
+            contract: 'helix.material/1',
+            requires: [],
+            provides: [`surface.${entry.family}/1`],
+        },
+        provenance: { ...entry.provenance },
+        expectedClosure: {
+            objectCount: objects.length,
+            totalBytes: objects.reduce((sum, object) => sum + object.bytes, 0),
+        },
+        material: definition,
+    };
+    const validation = (0, helix_manifest_1.validateMaterialPackage)(packageVersion);
+    if (!validation.valid)
+        throw new TypeError(validation.errors.join('; '));
+    return {
+        package: pkg,
+        definition,
+        packageVersion: validation.manifest,
+        definitionBytes,
+        definitionCid,
+        packageVersionCid: (0, helix_manifest_1.canonicalJsonCid)(validation.manifest),
+    };
+}
+/** Same normalized input always produces the same ordered package/CID set. */
+function buildMaterialBulkRecipe(inputs) {
+    const ids = new Set();
+    const sorted = [...inputs].sort((a, b) => a.entry.id.localeCompare(b.entry.id));
+    for (const input of sorted) {
+        if (ids.has(input.entry.id))
+            throw new Error(`duplicate material recipe id "${input.entry.id}"`);
+        ids.add(input.entry.id);
+    }
+    return sorted.map(buildMaterialPackageRecipe);
+}
+//# sourceMappingURL=recipe.js.map

package/dist/sceneImport/materials/recipe.js.map

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

package/dist/sceneImport/multiAsset.d.ts

@@ -0,0 +1,79 @@
+import { type DefaultMaterialMapping, type DefaultMaterialSummary } from './defaultMaterials';
+import type { CompiledSceneArtifact, SourceConversionReceipt, Vec3 } from './types';
+/**
+ * Pack-agnostic multi-asset Scene compiler front door.
+ *
+ * Enumerates every mesh file in a source directory (FBX/OBJ/GLB), compiles EACH
+ * placed mesh into its own detail+proxy GLB pair reusing the proven Helsinki/
+ * Bistro machinery, deduplicates identical meshes by content hash so repeated
+ * props share resources, optionally swaps imported materials/textures for the
+ * shared HELIX default set, clusters instances spatially into distance-mode
+ * stream cells, probes a standing spawn across ALL placed collider proxies, and
+ * emits one schema-valid Scene v2 package of N individually streamed nodes.
+ */
+export declare const SUPPORTED_MESH_EXTENSIONS: readonly [".fbx", ".obj", ".glb"];
+export type MultiAssetCompileResult = {
+    scenePath: string;
+    receiptPath: string;
+    resourcePaths: string[];
+    totalBytes: number;
+    placements: number;
+    uniqueMeshes: number;
+    proxiesKept: number;
+    proxiesDropped: number;
+    streamGroups: number;
+    cells: number;
+    spawn: Vec3;
+    defaultMaterials?: DefaultMaterialSummary;
+};
+export declare function compileMultiAssetScene(input: {
+    sourceDir: string;
+    outputDir: string;
+    title: string;
+    sourceId: string;
+    receipt: SourceConversionReceipt;
+    /** Subtracted from OBJ vertex positions before conversion (packs authored in a map CRS). */
+    localOrigin?: Vec3;
+    axisMapping?: (source: Vec3) => Vec3;
+    /** Swap imported materials/textures for the shared HELIX default set (opt-in per import). */
+    defaultMaterials?: boolean | {
+        mapping?: DefaultMaterialMapping;
+    };
+    maxTextureDimension?: number;
+    proxyTargetTriangles?: number;
+    detailTargetTriangles?: number;
+    cellSizeM?: number;
+}): Promise<MultiAssetCompileResult>;
+/**
+ * Deterministic digest over a whole source pack: sorted relative paths plus
+ * every file's bytes. This is the `originalSha256` a pack receipt pins, the
+ * same role the immutable archive hash plays for single-archive imports.
+ */
+export declare function packOriginalSha256(sourceDir: string): Promise<string>;
+/** Builds an explicit rights-clean receipt for one mesh pack, license-agnostically. */
+export declare function receiptForPack(input: {
+    sourceId: string;
+    originalSha256: string;
+    title: string;
+    creator: string;
+    license: string;
+    licenseUrl: string;
+    sourceUrl: string;
+}): SourceConversionReceipt;
+/** Recursively lists supported mesh files; refuses loudly on known-but-unsupported mesh formats. */
+export declare function listMeshFiles(root: string): Promise<string[]>;
+/**
+ * Content hash over what a compiled asset IS geometrically — its node
+ * hierarchy and each node's TRS, which mesh hangs on which node, primitive
+ * modes, accessor buffers, indices, material parameters and texture payloads —
+ * with node/mesh/material names, filenames and receipt metadata excluded. Two
+ * compilations of the same source asset therefore hash equal even when their
+ * GLBs differ byte-for-byte.
+ *
+ * The hierarchy is part of the identity, not decoration. Digesting only the
+ * mesh list makes two multi-part props that differ solely by a child node's
+ * rotation hash identical, so dedup collapses them and one placement renders
+ * the other's part orientation — the exact failure mode of any kitbash or FBX
+ * prop assembled from separately-transformed pieces.
+ */
+export declare function geometryContentHash(artifact: CompiledSceneArtifact): Promise<string>;