@forgeax/engine-gltf 0.1.27 → 0.1.28

package/README.md

@@ -51,7 +51,7 @@ reflection, Pack refs, Catalog/load, and runtime sampling.
 > structured `material-tangent-required` error. The importer persists generated
 > tangents in `MeshAsset.attributes.tangent` and never writes an identity guess.
 
-> Runtime glTF 2.0 importer (Tier-C subset). Pure-function pipeline `parseGlb` / `parseGltf` / `toAssetPack` consumed by build-time CLI plugin bin `forgeax-engine-remote-gltf` (resolved via PATH-prefix scan for `forgeax-engine-remote-`) writing `<source>.meta.json` (external-asset-package; dispatch on top-level `importer: 'gltf'`); runtime spawn happens via the existing `loadByGuid<SceneAsset>` plus `world.instantiateScene` 4-step recipe (no `loadGltf(url)` parallel API).
+> Runtime glTF 2.0 importer (Tier-C subset). Pure-function pipeline `parseGlb` / `parseGltf` / `toAssetPack` is selected by the unified `forgeax asset import` producer, which writes `<source>.meta.json` (external-asset-package; dispatch on top-level `importer: 'gltf'`); runtime spawn happens via the existing `loadByGuid<SceneAsset>` plus `world.instantiateScene` 4-step recipe (no `loadGltf(url)` parallel API).
 
 > [!IMPORTANT]
 > `toAssetPack` and `reimportReuseMeta` return `Result` values. The producer derives semantic `sourceKey` values before GUID reuse; duplicate or ambiguous identities return `duplicate-source-key` / `ambiguous-source-key` and the CLI leaves the previous sidecar untouched. `sourceIndex` is a locator only, never a generated identity.
@@ -248,19 +248,21 @@ const root = engine.assets.instantiate(sceneResult.value, world);
 // equivalent to world.instantiateScene(handle).
 ```
 
-## CLI plugin — `forgeax-engine-remote-gltf`
+## Unified asset producer
 
-The build-time CLI subcommand `import` ships as a standalone plugin bin `forgeax-engine-remote-gltf` (entry `dist/cli-gltf.mjs`) declared in this package's `package.json#bin`, discovered via PATH-prefix scan for `forgeax-engine-remote-`.
+The glTF producer is selected by the unified `asset import` command. DevKit
+loads this package's producer only when a `.gltf` or `.glb` source is passed;
+the package no longer publishes an independent executable.
 
 | Subcommand | Description | Exit code |
 |:--|:--|:--|
-| `forgeax-engine-remote-gltf import <path>` | Parse `.gltf` / `.glb`; write sidecar `<source>.meta.json` (top-level `importer: 'gltf'`) next to source; UUIDv7 GUIDs assigned per sub-asset in document order | 0 success / 1 `GltfError` |
-| `forgeax-engine-remote-gltf import <path> --check` | Dry-run mode — no sidecar write; surfaces `gltf-meta-missing` route b (cf. importer route a) | 0 if sidecar already present / 1 if missing |
+| `forgeax asset import <path> --root <project>` | Parse `.gltf` / `.glb`; write sidecar `<source>.meta.json` (top-level `importer: 'gltf'`) next to source; UUIDv7 GUIDs assigned per sub-asset in document order | 0 success / 1 `GltfError` |
+| `forgeax asset import <path> --dry-run --root <project>` | Validate the producer path without writing a sidecar | 0 if valid / 1 if missing or invalid |
 
 ```bash
-# Direct invocation (after pnpm -F @forgeax/engine-gltf build)
-forgeax-engine-remote-gltf import apps/hello/gltf/assets/box.glb
-forgeax-engine-remote-gltf import apps/hello/gltf/assets/ --check
+# Unified invocation
+forgeax asset import apps/hello/gltf/assets/box.glb --root ./game --json
+forgeax asset import apps/hello/gltf/assets/ --dry-run --root ./game --json
 ```
 
 ### End-to-end source-to-Pack route
@@ -270,14 +272,14 @@ Pack/DDC publication path. Keep these steps together when adding a glTF LOD:
 
 ```mermaid
 flowchart LR
-    source["source .gltf/.glb"] --> cli["remote-gltf import"]
+    source["source .gltf/.glb"] --> cli["forgeax asset import"]
     cli --> meta["source.meta.json"]
     meta --> registry["ImporterRegistry + gltfImporter"]
     registry --> runner["runImport"]
     runner --> pack["Pack/DDC + Catalog"]
 ```
 
-1. Run `forgeax-engine-remote-gltf import <source>` to create or refresh the
+1. Run `forgeax asset import <source> --root <project>` to create or refresh the
    adjacent `<source>.meta.json` and its stable sub-asset GUIDs.
 2. Register `gltfImporter` with the build-time `ImporterRegistry` and pass the
    sidecar to `runImport`; this validates the declared LOD GUID closure and

package/dist/cli-gltf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-gltf.d.ts","sourceRoot":"","sources":["../src/cli-gltf.ts"],"names":[],"mappings":";AAgCA,UAAU,QAAQ;IAChB,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAkCD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAe/E"}
+{"version":3,"file":"cli-gltf.d.ts","sourceRoot":"","sources":["../src/cli-gltf.ts"],"names":[],"mappings":";AA8BA,UAAU,QAAQ;IAChB,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAkCD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAe/E"}

package/dist/cli-gltf.mjs

@@ -14,7 +14,7 @@ var GLTF_MESHOPT_FILTERS = ["NONE", "OCTAHEDRAL", "QUATERNION", "EXPONENTIAL"];
 var gltfErrorPolicy = {
   "gltf-malformed-header": {
     expected: "GLB 12-byte header (magic 0x46546C67 + version=2 + length) plus mandatory JSON chunk",
-    hint: "verify .glb is not truncated; rerun: forgeax-engine-remote-gltf import <path>"
+    hint: "verify .glb is not truncated; rerun: forgeax asset import <path> --root <project> --json"
   },
   "gltf-version-unsupported": {
     expected: 'asset.version === "2.0"',
@@ -50,7 +50,7 @@ var gltfErrorPolicy = {
   },
   "gltf-meta-missing": {
     expected: "sidecar <source>.meta.json (importer: 'gltf') present in same directory",
-    hint: "run: forgeax-engine-remote-gltf import <path>"
+    hint: "run: forgeax asset import <path> --root <project> --json"
   },
   "gltf-instancing-count-mismatch": {
     expected: "all instance attribute accessors share the same count",
@@ -78,7 +78,7 @@ var gltfErrorPolicy = {
   },
   "gltf-image-extract-failed": {
     expected: "image bytes extractable from bufferView / data-URI / external URI without corruption",
-    hint: "verify the bufferView byte range / data: URI base64 / external URI sibling file is intact next to the .gltf source; rerun: forgeax-engine-remote-gltf import <path>"
+    hint: "verify the bufferView byte range / data: URI base64 / external URI sibling file is intact next to the .gltf source; rerun: forgeax asset import <path> --root <project> --json"
   },
   "gltf-skin-attr-asymmetric": {
     expected: "mesh primitive declares JOINTS_0 and WEIGHTS_0 symmetrically (both present or both absent)",
@@ -2612,14 +2612,14 @@ function emitError(ctx, err3) {
 }
 function helpBody() {
   return [
-    "forgeax-engine-remote-gltf \u2014 glTF / GLB sidecar importer (produces texture/mesh/material/scene sub-assets)",
+    "forgeax asset import \u2014 glTF / GLB sidecar importer (internal producer)",
     "",
     "Usage:",
-    "  forgeax-engine-remote-gltf import <path.gltf|path.glb>",
-    "  forgeax-engine-remote-gltf import --check <dir>",
+    "  forgeax asset import <path.gltf|path.glb> --root <project>",
+    "  forgeax asset import <dir> --dry-run --root <project>",
     "",
-    "Produces a sibling <source>.meta.json sidecar with sub-asset entries",
-    "for every glTF asset category: texture, mesh, material, scene.",
+    "produces texture, mesh, material, and scene sub-asset entries in a sibling",
+    "<source>.meta.json sidecar.",
     ""
   ].join("\n");
 }
@@ -2633,7 +2633,7 @@ async function runCliGltf(rest, ctx) {
     return emitError(ctx, {
       code: "unknown-subcommand",
       expected: "subcommand 'import'",
-      hint: "run 'forgeax-engine-remote-gltf --help' for usage",
+      hint: "run 'forgeax help asset import' for usage",
       detail: { subcommand: sub }
     });
   }
@@ -2655,8 +2655,8 @@ async function runImport(rest, ctx) {
     const message = e instanceof Error ? e.message : String(e);
     return emitError(ctx, {
       code: "cli-parse-error",
-      expected: "forgeax-engine-remote-gltf import [--check] <path>",
-      hint: "run 'forgeax-engine-remote-gltf --help' for usage",
+      expected: "forgeax asset import [--dry-run] <path> --root <project>",
+      hint: "run 'forgeax help asset import' for usage",
       detail: { message }
     });
   }
@@ -2664,7 +2664,7 @@ async function runImport(rest, ctx) {
   if (target === void 0) {
     return emitError(ctx, {
       code: "cli-parse-error",
-      expected: check ? "forgeax-engine-remote-gltf import --check <dir>" : "forgeax-engine-remote-gltf import <path.gltf|path.glb>",
+      expected: check ? "forgeax asset import <dir> --dry-run --root <project>" : "forgeax asset import <path.gltf|path.glb> --root <project>",
       hint: "pass a positional <gltf-or-glb> argument; with --check pass a directory"
     });
   }
@@ -2730,7 +2730,7 @@ async function runCheck(target, ctx) {
     const message = e instanceof Error ? e.message : String(e);
     return emitError(ctx, {
       code: "cli-parse-error",
-      expected: "forgeax-engine-remote-gltf import --check <dir>",
+      expected: "forgeax asset import <dir> --dry-run --root <project>",
       hint: "pass a directory that exists and is readable",
       detail: { path: target, message }
     });