@forgeax/engine-gltf 0.1.27 → 0.1.28

package/package.json

@@ -1,14 +1,11 @@
 {
   "name": "@forgeax/engine-gltf",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
-  "description": "Runtime glTF 2.0 importer (Tier-B subset: scenes + nodes + meshes (POSITION + INDICES) + UnlitMaterial.baseColor + Camera.perspective). Pure-function pipeline parseGlb / parseGltf / toAssetPack consumed by build-time CLI (forgeax-engine-remote-gltf import) writing <source>.meta.json (external-asset-package; assetType=gltf) for runtime loadByGuid<SceneAsset>.",
-  "bin": {
-    "forgeax-engine-remote-gltf": "./dist/cli-gltf.mjs"
-  },
+  "description": "Runtime glTF 2.0 importer and build-time producer. Pure-function parseGlb / parseGltf / toAssetPack is invoked by the unified ForgeaX asset command and writes <source>.meta.json for runtime loadByGuid<SceneAsset>.",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -38,21 +35,21 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-animation": "0.1.27",
-    "@forgeax/engine-geometry": "0.1.27",
-    "@forgeax/engine-import": "0.1.27",
-    "@forgeax/engine-math": "0.1.27",
-    "@forgeax/engine-pack": "0.1.27",
-    "@forgeax/engine-scene": "0.1.27",
-    "@forgeax/engine-types": "0.1.27",
+    "@forgeax/engine-animation": "0.1.28",
+    "@forgeax/engine-geometry": "0.1.28",
+    "@forgeax/engine-import": "0.1.28",
+    "@forgeax/engine-math": "0.1.28",
+    "@forgeax/engine-pack": "0.1.28",
+    "@forgeax/engine-scene": "0.1.28",
+    "@forgeax/engine-types": "0.1.28",
     "@webgpu/types": "^0.1.71",
     "meshoptimizer": "^0.20.0"
   },
   "devDependencies": {
-    "@forgeax/engine-assets-runtime": "0.1.27",
-    "@forgeax/engine-picking": "0.1.27",
-    "@forgeax/engine-render": "0.1.27",
-    "@forgeax/engine-runtime": "0.1.27",
+    "@forgeax/engine-assets-runtime": "0.1.28",
+    "@forgeax/engine-picking": "0.1.28",
+    "@forgeax/engine-render": "0.1.28",
+    "@forgeax/engine-runtime": "0.1.28",
     "@types/node": "^20.14.0"
   },
   "forgeax": {

package/src/__tests__/cli-gltf.integration.test.ts

@@ -1,6 +1,6 @@
 // packages/gltf/src/__tests__/cli-gltf.integration.test.ts
 //
-// Integration test: run `forgeax-engine-remote-gltf import` against real
+// Integration test: run `forgeax asset import import` against real
 // glTF files and verify the written .meta.json sidecar contains texture
 // sub-assets (feat-20260608 M6 w29 AC-18).
 //

package/src/__tests__/gltf.unit.test.ts

@@ -189,7 +189,7 @@ function unwrapReimport(result: ReturnType<typeof reimportReuseMeta>) {
       await rm(tempDir, { recursive: true, force: true });
     });
 
-    describe('cli-gltf (forgeax-engine-remote-gltf plugin bin)', () => {
+    describe('cli-gltf (forgeax asset import plugin bin)', () => {
       describe('subcommand routing (a)', () => {
         it('prints help on --help and exits 0', async () => {
           const io = makeIO();

package/src/cli-gltf.ts

@@ -1,18 +1,16 @@
 #!/usr/bin/env node
-// @forgeax/engine-gltf/src/cli-gltf — `forgeax-engine-remote-gltf` plugin
-// bin (feat-20260516-console-dependency-inversion plan-strategy section
-// 2.9). Discovered by the base bin via the kubectl 4th-path
-// `forgeax-engine-remote-` prefix scanner.
+// @forgeax/engine-gltf/src/cli-gltf — internal producer used by DevKit's
+// unified `forgeax asset import` command. It is deliberately not a package bin.
 //
 // Single subcommand `import` for v1 (UX break vs the prior
-// `forgeax-engine-remote-asset import`):
+// `forgeax asset import`):
 //
-//   write mode  `forgeax-engine-remote-gltf import <gltf-or-glb>`
+//   write mode  `forgeax asset import <gltf-or-glb> --root <project>`
 //                Parses the source via parseGlb / parseGltf and writes the
 //                sibling `<source>.meta.json` sidecar (sorted-keys, LF line
 //                ending — byte-stable so a clean reimport produces no diff).
 //
-//   --check     `forgeax-engine-remote-gltf import --check <dir>`
+//   --check     `forgeax asset import <dir> --dry-run --root <project>`
 //                Dry-run: traverse <dir> reusing SCANNER_BLACKLIST from
 //                @forgeax/engine-pack/scanner and surface the first orphan
 //                .gltf / .glb whose `<source>.meta.json` is absent as
@@ -55,14 +53,14 @@ function emitError(ctx: AssetCtx, err: ErrShape): number {
 
 function helpBody(): string {
   return [
-    'forgeax-engine-remote-gltf — glTF / GLB sidecar importer (produces texture/mesh/material/scene sub-assets)',
+    'forgeax asset import — 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');
 }
@@ -77,7 +75,7 @@ export async function runCliGltf(rest: string[], ctx: AssetCtx): Promise<number>
     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 },
     });
   }
@@ -100,8 +98,8 @@ async function runImport(rest: string[], ctx: AssetCtx): Promise<number> {
     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 },
     });
   }
@@ -110,8 +108,8 @@ async function runImport(rest: string[], ctx: AssetCtx): Promise<number> {
     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>',
+        ? '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',
     });
   }
@@ -192,7 +190,7 @@ async function runCheck(target: string, ctx: AssetCtx): Promise<number> {
     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 },
     });

package/src/errors.ts

@@ -267,7 +267,7 @@ const 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"',
@@ -305,7 +305,7 @@ const 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',
@@ -334,7 +334,7 @@ const 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: