@nebutra/3d-pipeline 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/3d-pipeline",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "BrandContext-first mesh generation, export manifests, and previews",
   "private": false,
   "license": "MIT",
@@ -23,16 +23,20 @@
     "category": "ai",
     "summary": "BrandContext-first mesh, preview, and export surface"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "@nebutra/capability-kit": "0.2.2",
-    "@nebutra/errors": "0.1.2",
-    "@nebutra/generation-context": "0.1.2",
-    "@nebutra/image-pipeline": "0.1.2"
+    "@nebutra/generation-context": "0.1.3",
+    "@nebutra/capability-kit": "0.2.4",
+    "@nebutra/image-pipeline": "0.1.3",
+    "@nebutra/errors": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -53,6 +57,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @nebutra/3d-pipeline@0.1.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/3d-pipeline
-> tsup
-
-CLI Building entry: src/cli.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/3d-pipeline/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/index.js              148.00 B
-ESM dist/cli.js                1.19 KB
-ESM dist/chunk-PGYUP7CZ.js     4.24 KB
-ESM dist/index.js.map          71.00 B
-ESM dist/cli.js.map            2.08 KB
-ESM dist/chunk-PGYUP7CZ.js.map 8.78 KB
-ESM ⚡️ Build success in 31ms
-DTS Build start
-DTS ⚡️ Build success in 2748ms
-DTS dist/cli.d.ts   13.00 B
-DTS dist/index.d.ts 1.56 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/3d-pipeline@0.1.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/3d-pipeline
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/3d-pipeline
-
- ✓ src/index.test.ts (2 tests) 106ms
-
- Test Files  1 passed (1)
-      Tests  2 passed (2)
-   Start at  09:38:45
-   Duration  1.02s (transform 98ms, setup 0ms, import 151ms, tests 106ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/3d-pipeline@0.1.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/ai/3d-pipeline
-> tsc --noEmit
-

package/examples/export.ts

@@ -1,7 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { MeshPipeline } from "../src/index";
-
-const pipeline = new MeshPipeline();
-const asset = await pipeline.fromText("a 3D debugging loop logo", createDemoBrandContext());
-
-process.stdout.write(`${JSON.stringify(await pipeline.export(asset, "gltf"), null, 2)}\n`);

package/examples/from-text.ts

@@ -1,6 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { MeshPipeline } from "../src/index";
-
-const asset = await new MeshPipeline().fromText("a sleek robot mascot", createDemoBrandContext());
-
-process.stdout.write(`${asset.gltfPath}\n`);

package/examples/preview.ts

@@ -1,7 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { MeshPipeline } from "../src/index";
-
-const pipeline = new MeshPipeline();
-const asset = await pipeline.fromText("product mockup", createDemoBrandContext());
-
-process.stdout.write(`${JSON.stringify(await pipeline.preview(asset), null, 2)}\n`);

package/src/cli.ts

@@ -1,28 +0,0 @@
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { MeshPipeline, readMeshDebug } from "./index";
-
-const command = process.argv[2] ?? "doctor";
-const pipeline = new MeshPipeline();
-
-if (command === "doctor") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "3d-pipeline", results: await pipeline.doctor() }, null, 2)}\n`,
-  );
-} else if (command === "debug") {
-  process.stdout.write(
-    `${JSON.stringify({ capability: "3d-pipeline", entries: await readMeshDebug() }, null, 2)}\n`,
-  );
-} else if (command === "preview") {
-  const asset = await pipeline.fromText("sleek debugging mascot", createDemoBrandContext());
-  process.stdout.write(
-    `${JSON.stringify({ capability: "3d-pipeline", preview: await pipeline.preview(asset) }, null, 2)}\n`,
-  );
-} else if (command === "export") {
-  const asset = await pipeline.fromText("sleek debugging mascot", createDemoBrandContext());
-  process.stdout.write(
-    `${JSON.stringify({ capability: "3d-pipeline", export: await pipeline.export(asset, "gltf") }, null, 2)}\n`,
-  );
-} else {
-  process.stderr.write(`Unknown 3d-pipeline command: ${command}\n`);
-  process.exitCode = 1;
-}

package/src/index.test.ts

@@ -1,32 +0,0 @@
-import { mkdtemp, readFile, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { createDemoBrandContext } from "@nebutra/generation-context";
-import { afterEach, describe, expect, it } from "vitest";
-import { MeshPipeline, readMeshDebug } from "./index";
-
-let root: string | undefined;
-
-afterEach(async () => {
-  if (root) await rm(root, { recursive: true, force: true });
-  root = undefined;
-});
-
-describe("MeshPipeline", () => {
-  it("requires BrandContext", async () => {
-    await expect(new MeshPipeline().fromText("robot", undefined)).rejects.toMatchObject({
-      capability: "3d-pipeline",
-    });
-  });
-
-  it("writes a glTF asset and preview", async () => {
-    root = await mkdtemp(join(tmpdir(), "mesh-pipeline-"));
-    const asset = await new MeshPipeline({ root }).fromText(
-      "robot mascot",
-      createDemoBrandContext(),
-    );
-    expect(JSON.parse(await readFile(asset.gltfPath, "utf8")).asset.version).toBe("2.0");
-    expect(await readFile(asset.previewImagePath, "utf8")).toContain("<svg");
-    expect(await readMeshDebug(root)).toHaveLength(1);
-  });
-});

package/src/index.ts

@@ -1,176 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
-import {
-  assetId,
-  type BrandContext,
-  type GeneratedAsset,
-  requireBrandContext,
-  summarizeBrandContext,
-} from "@nebutra/generation-context";
-import type { ImageAsset } from "@nebutra/image-pipeline";
-
-export type MeshIntent =
-  | { type: "product-mockup"; description: string }
-  | { type: "logo-extrusion"; depth: number }
-  | { type: "icon-pack"; count: number };
-
-export interface MeshAsset extends GeneratedAsset {
-  readonly kind: "mesh";
-  readonly gltfPath: string;
-  readonly usdzPath?: string;
-  readonly objPath?: string;
-  readonly fbxPath?: string;
-  readonly previewImagePath: string;
-  readonly triangleCount: number;
-  readonly format: "gltf";
-}
-
-export interface MeshHealth {
-  readonly provider: string;
-  readonly ok: boolean;
-  readonly suggestion?: string;
-}
-
-export interface MeshPipelineOptions {
-  readonly root?: string;
-}
-
-export async function readMeshDebug(root = process.cwd(), limit = 10): Promise<unknown[]> {
-  return readCapabilityDebug("3d-pipeline", { root, limit });
-}
-
-function gltfDocument(brand: BrandContext, intent: MeshIntent): Record<string, unknown> {
-  return {
-    asset: { version: "2.0", generator: "@nebutra/3d-pipeline deterministic mesh" },
-    scene: 0,
-    scenes: [{ nodes: [0] }],
-    nodes: [{ mesh: 0, name: `${brand.name} ${intent.type}` }],
-    meshes: [
-      {
-        primitives: [
-          {
-            attributes: { POSITION: 0 },
-            indices: 1,
-            material: 0,
-          },
-        ],
-      },
-    ],
-    materials: [{ name: brand.palette[0]?.name ?? "brand", pbrMetallicRoughness: {} }],
-    extras: { brand: summarizeBrandContext(brand), intent },
-  };
-}
-
-function previewSvg(brand: BrandContext, intent: MeshIntent): string {
-  const primary = brand.palette[0]?.hex ?? "#111111";
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="640" height="480">
-  <rect width="640" height="480" fill="${primary}"/>
-  <polygon points="320,72 520,360 120,360" fill="#ffffff" opacity="0.88"/>
-  <text x="64" y="430" fill="#ffffff" font-family="${brand.typography.body}" font-size="28">${brand.name} ${intent.type}</text>
-</svg>`;
-}
-
-export class MeshPipeline {
-  readonly #root: string;
-
-  constructor(options: MeshPipelineOptions = {}) {
-    this.#root = options.root ?? process.cwd();
-  }
-
-  async fromText(description: string, brandInput: BrandContext | undefined): Promise<MeshAsset> {
-    return this.#write({ type: "product-mockup", description }, brandInput);
-  }
-
-  async fromImage(
-    image: Pick<ImageAsset, "path">,
-    brandInput: BrandContext | undefined,
-  ): Promise<MeshAsset> {
-    return this.#write(
-      { type: "product-mockup", description: `image-to-mesh source ${image.path}` },
-      brandInput,
-    );
-  }
-
-  async batchFromIntent(
-    intent: MeshIntent,
-    brandInput: BrandContext | undefined,
-  ): Promise<MeshAsset[]> {
-    const count = intent.type === "icon-pack" ? Math.max(1, Math.min(intent.count, 10)) : 1;
-    const assets: MeshAsset[] = [];
-    for (let index = 0; index < count; index += 1) {
-      assets.push(await this.#write(intent, brandInput));
-    }
-    return assets;
-  }
-
-  async preview(asset: MeshAsset): Promise<{ path: string }> {
-    return { path: asset.previewImagePath };
-  }
-
-  async export(
-    asset: MeshAsset,
-    format: "gltf" | "obj" | "usdz" | "fbx" = "gltf",
-  ): Promise<{ path: string }> {
-    if (format === "gltf") return { path: asset.gltfPath };
-    const path = join(
-      this.#root,
-      ".nebutra",
-      "generated",
-      "3d-pipeline",
-      `${asset.id}.${format}.json`,
-    );
-    await writeFile(
-      path,
-      `${JSON.stringify({ source: asset.gltfPath, format }, null, 2)}\n`,
-      "utf8",
-    );
-    return { path };
-  }
-
-  async doctor(): Promise<MeshHealth[]> {
-    return [
-      { provider: "gltf-local", ok: true },
-      {
-        provider: "local-mesh-model",
-        ok: Boolean(process.env.MESH_LOCAL_MODEL_PATH),
-        suggestion: "Set MESH_LOCAL_MODEL_PATH to enable local mesh generation.",
-      },
-      {
-        provider: "remote-mesh",
-        ok: Boolean(process.env.MESH_REMOTE_API_KEY),
-        suggestion: "Set MESH_REMOTE_API_KEY to enable remote mesh fallback.",
-      },
-    ];
-  }
-
-  async #write(intent: MeshIntent, brandInput: BrandContext | undefined): Promise<MeshAsset> {
-    const brand = requireBrandContext(brandInput, "3d-pipeline");
-    const id = assetId("mesh", `${intent.type}_${brand.brandId}`);
-    const dir = join(this.#root, ".nebutra", "generated", "3d-pipeline");
-    const gltfPath = join(dir, `${id}.gltf`);
-    const previewImagePath = join(dir, `${id}.svg`);
-    await mkdir(dir, { recursive: true });
-    await writeFile(gltfPath, `${JSON.stringify(gltfDocument(brand, intent), null, 2)}\n`, "utf8");
-    await writeFile(previewImagePath, previewSvg(brand, intent), "utf8");
-
-    const asset: MeshAsset = {
-      id,
-      tenantId: brand.tenantId,
-      kind: "mesh",
-      path: gltfPath,
-      gltfPath,
-      previewImagePath,
-      brandId: brand.brandId,
-      provider: "gltf-local",
-      model: "brand-context-gltf-v1",
-      createdAt: new Date().toISOString(),
-      license: { status: "commercial-ok", source: "deterministic local mesh" },
-      triangleCount: 1,
-      format: "gltf",
-      metadata: { intent, brandSource: brand.sourcePath },
-    };
-    await appendCapabilityDebug("3d-pipeline", { type: "mesh", asset }, { root: this.#root });
-    return asset;
-  }
-}

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "target": "esnext",
-    "types": ["node"],
-    "incremental": false
-  },
-  "include": ["src", "examples"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,16 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts", "src/cli.ts"],
-  format: ["esm"],
-  dts: true,
-  sourcemap: true,
-  clean: true,
-  target: "es2022",
-  external: [
-    "@nebutra/capability-kit/debug",
-    "@nebutra/errors",
-    "@nebutra/generation-context",
-    "@nebutra/image-pipeline",
-  ],
-});