npm - fluidcad - Versions diffs - 0.0.34 → 0.0.35 - Mend

fluidcad 0.0.34 → 0.0.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (174) hide show

package/README.md +69 -0
package/bin/commands/login.js +120 -0
package/bin/commands/pack.js +49 -0
package/bin/commands/publish.js +136 -0
package/bin/fluidcad.js +6 -0
package/bin/lib/api-client.js +40 -0
package/bin/lib/browser.js +16 -0
package/bin/lib/config.js +39 -0
package/bin/lib/model-config.js +38 -0
package/bin/lib/workspace.js +57 -0
package/lib/dist/common/shape-factory.d.ts +2 -1
package/lib/dist/common/shape-factory.js +4 -0
package/lib/dist/common/transformable-primitive.d.ts +6 -5
package/lib/dist/common/transformable-primitive.js +8 -7
package/lib/dist/common/vertex.js +0 -1
package/lib/dist/core/2d/aline.d.ts +4 -3
package/lib/dist/core/2d/aline.js +3 -2
package/lib/dist/core/2d/arc.d.ts +3 -2
package/lib/dist/core/2d/arc.js +4 -3
package/lib/dist/core/2d/bezier.d.ts +8 -6
package/lib/dist/core/2d/circle.d.ts +4 -3
package/lib/dist/core/2d/circle.js +3 -2
package/lib/dist/core/2d/ellipse.d.ts +5 -4
package/lib/dist/core/2d/ellipse.js +5 -4
package/lib/dist/core/2d/hline.d.ts +4 -3
package/lib/dist/core/2d/hline.js +5 -3
package/lib/dist/core/2d/line.js +1 -0
package/lib/dist/core/2d/offset.d.ts +3 -2
package/lib/dist/core/2d/offset.js +6 -5
package/lib/dist/core/2d/polygon.d.ts +5 -4
package/lib/dist/core/2d/polygon.js +10 -9
package/lib/dist/core/2d/rect.d.ts +4 -3
package/lib/dist/core/2d/rect.js +10 -9
package/lib/dist/core/2d/slot.d.ts +14 -6
package/lib/dist/core/2d/slot.js +19 -8
package/lib/dist/core/2d/vline.d.ts +4 -3
package/lib/dist/core/2d/vline.js +5 -3
package/lib/dist/core/chamfer.d.ts +5 -4
package/lib/dist/core/chamfer.js +7 -6
package/lib/dist/core/color.d.ts +3 -2
package/lib/dist/core/color.js +2 -1
package/lib/dist/core/cut.d.ts +4 -3
package/lib/dist/core/cut.js +5 -4
package/lib/dist/core/cylinder.d.ts +2 -1
package/lib/dist/core/cylinder.js +2 -1
package/lib/dist/core/draft.d.ts +3 -2
package/lib/dist/core/draft.js +3 -2
package/lib/dist/core/extrude.d.ts +4 -3
package/lib/dist/core/extrude.js +5 -4
package/lib/dist/core/fillet.d.ts +5 -4
package/lib/dist/core/fillet.js +6 -5
package/lib/dist/core/index.d.ts +1 -0
package/lib/dist/core/index.js +1 -0
package/lib/dist/core/interfaces.d.ts +25 -24
package/lib/dist/core/param.d.ts +74 -0
package/lib/dist/core/param.js +147 -0
package/lib/dist/core/repeat.d.ts +2 -1
package/lib/dist/core/repeat.js +10 -8
package/lib/dist/core/revolve.d.ts +2 -1
package/lib/dist/core/revolve.js +3 -2
package/lib/dist/core/rib.d.ts +3 -2
package/lib/dist/core/rib.js +6 -2
package/lib/dist/core/rotate.d.ts +5 -4
package/lib/dist/core/rotate.js +4 -3
package/lib/dist/core/shell.d.ts +3 -2
package/lib/dist/core/shell.js +3 -2
package/lib/dist/core/sphere.d.ts +3 -2
package/lib/dist/core/sphere.js +2 -1
package/lib/dist/core/translate.d.ts +7 -6
package/lib/dist/core/translate.js +6 -5
package/lib/dist/features/2d/arc.js +5 -5
package/lib/dist/features/2d/bezier.js +16 -16
package/lib/dist/features/2d/circle.js +4 -0
package/lib/dist/features/2d/ellipse.js +4 -0
package/lib/dist/features/2d/hline.d.ts +3 -0
package/lib/dist/features/2d/hline.js +9 -2
package/lib/dist/features/2d/line.d.ts +3 -0
package/lib/dist/features/2d/line.js +11 -3
package/lib/dist/features/2d/sketch.js +5 -1
package/lib/dist/features/2d/slot.d.ts +5 -0
package/lib/dist/features/2d/slot.js +52 -7
package/lib/dist/features/2d/tarc-to-point-tangent.js +3 -0
package/lib/dist/features/2d/tarc-to-point.js +3 -0
package/lib/dist/features/2d/tarc-with-tangent.js +3 -0
package/lib/dist/features/2d/tarc.js +3 -0
package/lib/dist/features/2d/vline.d.ts +3 -0
package/lib/dist/features/2d/vline.js +9 -2
package/lib/dist/features/copy-circular.d.ts +4 -3
package/lib/dist/features/copy-circular.js +16 -9
package/lib/dist/features/copy-circular2d.js +16 -9
package/lib/dist/features/copy-linear.d.ts +4 -3
package/lib/dist/features/copy-linear.js +18 -12
package/lib/dist/features/copy-linear2d.js +18 -12
package/lib/dist/features/extrude-base.d.ts +4 -3
package/lib/dist/features/extrude-base.js +10 -3
package/lib/dist/features/mirror-shape2d.js +2 -2
package/lib/dist/features/repeat-base.d.ts +13 -0
package/lib/dist/features/repeat-base.js +21 -0
package/lib/dist/features/repeat-circular.d.ts +6 -5
package/lib/dist/features/repeat-circular.js +3 -6
package/lib/dist/features/repeat-linear.d.ts +7 -7
package/lib/dist/features/repeat-linear.js +3 -6
package/lib/dist/index.d.ts +5 -0
package/lib/dist/index.js +8 -1
package/lib/dist/io/file-import.d.ts +7 -0
package/lib/dist/io/file-import.js +30 -10
package/lib/dist/math/lazy-matrix.d.ts +5 -0
package/lib/dist/math/lazy-matrix.js +78 -10
package/lib/dist/oc/boolean-ops.d.ts +2 -2
package/lib/dist/param-registry.d.ts +34 -0
package/lib/dist/param-registry.js +60 -0
package/lib/dist/rendering/mesh-builder.js +2 -1
package/lib/dist/tests/features/copy-circular.test.js +1 -1
package/lib/dist/tests/features/copy-linear.test.js +10 -10
package/lib/dist/tests/features/repeat-user-repro-cache.test.d.ts +1 -0
package/lib/dist/tests/features/repeat-user-repro-cache.test.js +97 -0
package/lib/dist/tsconfig.tsbuildinfo +1 -1
package/llm-docs/api/bezier.md +10 -11
package/llm-docs/api/index.json +1 -1
package/llm-docs/api/types/arc-points.md +2 -2
package/llm-docs/api/types/cut.md +10 -10
package/llm-docs/api/types/extrude.md +10 -10
package/llm-docs/api/types/loft.md +6 -6
package/llm-docs/api/types/revolve.md +6 -6
package/llm-docs/api/types/rib.md +2 -2
package/llm-docs/api/types/slot.md +2 -2
package/llm-docs/api/types/sweep.md +10 -10
package/llm-docs/api/types/transformable.md +14 -14
package/llm-docs/index.json +12 -12
package/mcp/dist/client.d.ts +1 -0
package/mcp/dist/client.js +8 -1
package/mcp/dist/server.js +14 -1
package/mcp/dist/tools/engine.d.ts +16 -0
package/mcp/dist/tools/engine.js +45 -0
package/package.json +9 -3
package/server/dist/api.d.ts +37 -0
package/server/dist/api.js +44 -0
package/server/dist/code-editor.d.ts +64 -0
package/server/dist/code-editor.js +520 -2
package/server/dist/fluidcad-server.d.ts +68 -1
package/server/dist/fluidcad-server.js +224 -88
package/server/dist/host/blocked-imports.d.ts +8 -0
package/server/dist/host/blocked-imports.js +30 -0
package/server/dist/{vite-manager.d.ts → host/local-scene-host.d.ts} +3 -1
package/server/dist/{vite-manager.js → host/local-scene-host.js} +6 -26
package/server/dist/host/scene-host.d.ts +19 -0
package/server/dist/host/scene-host.js +1 -0
package/server/dist/index.js +24 -117
package/server/dist/model-package/capture-params.d.ts +19 -0
package/server/dist/model-package/capture-params.js +42 -0
package/server/dist/model-package/pack.d.ts +23 -0
package/server/dist/model-package/pack.js +229 -0
package/server/dist/model-package/types.d.ts +78 -0
package/server/dist/model-package/types.js +17 -0
package/server/dist/routes/hit-test.d.ts +3 -0
package/server/dist/routes/hit-test.js +17 -0
package/server/dist/routes/pack.d.ts +10 -0
package/server/dist/routes/pack.js +47 -0
package/server/dist/routes/params.d.ts +3 -0
package/server/dist/routes/params.js +75 -0
package/server/dist/routes/sketch-edits.d.ts +3 -0
package/server/dist/routes/sketch-edits.js +542 -0
package/server/dist/routes/timeline.d.ts +3 -0
package/server/dist/routes/timeline.js +49 -0
package/server/dist/server-core.d.ts +53 -0
package/server/dist/server-core.js +147 -0
package/server/dist/ws-protocol.d.ts +101 -2
package/ui/dist/assets/index-CDJmUpFI.css +2 -0
package/ui/dist/assets/index-MRqwG9Vh.js +5417 -0
package/ui/dist/index.html +2 -2
package/server/dist/routes/actions.d.ts +0 -3
package/server/dist/routes/actions.js +0 -309
package/ui/dist/assets/index-BdqrMDRu.js +0 -4946
package/ui/dist/assets/index-DR7c2Qk9.css +0 -2

package/README.md CHANGED Viewed

@@ -115,6 +115,11 @@ Import and export STEP files with full color support. Bring in existing CAD mode
 FluidCAD ships official extensions for **VS Code** and **Neovim**, but works with any editor -- just point the CLI at your project.
+### LLM / AI Agent Integration (MCP)
+FluidCAD ships an [MCP](https://modelcontextprotocol.io) server so AI agents (Claude Code, Claude Desktop, Cursor, opencode, etc.) can drive a running workspace -- take screenshots, inspect geometry, edit `.fluid.js` files, and look up the API by symbol. See [Set Up the MCP Server](#3-optional-set-up-the-mcp-server) below.
 ---
 ## Tutorials
@@ -234,6 +239,70 @@ This starts a local server and opens a 3D viewport in your browser. Edit your `.
 </details>
+### 3. (Optional) Set Up the MCP Server
+FluidCAD bundles an [MCP](https://modelcontextprotocol.io) server so LLM agents can drive your workspace -- screenshots, geometry inspection, source edits, API lookup. It's included in the `fluidcad` package; no separate install needed.
+Wire it into your MCP client:
+<details>
+<summary><strong>Claude Code</strong></summary>
+Register at user scope so it's available in every project:
+```bash
+claude mcp add --scope user FluidCAD -- npx -y fluidcad mcp
+```
+</details>
+<details>
+<summary><strong>Claude Desktop / Cursor</strong></summary>
+Add to `claude_desktop_config.json` or `~/.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "FluidCAD": {
+      "command": "npx",
+      "args": ["-y", "fluidcad", "mcp"]
+    }
+  }
+}
+```
+</details>
+<details>
+<summary><strong>opencode</strong></summary>
+Run `opencode mcp add` and answer the prompts, or add to `~/.config/opencode/opencode.json`:
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "FluidCAD": {
+      "type": "local",
+      "command": ["npx", "-y", "fluidcad", "mcp"],
+      "enabled": true
+    }
+  }
+}
+```
+</details>
+Then install the companion skill so agents follow the FluidCAD workflow:
+```bash
+npx skills add Fluid-CAD/FluidCAD
+```
+See the [MCP README](mcp/README.md) for the full tool surface, transport details, and local-testing guide.
 ---
 ## License

package/bin/commands/login.js ADDED Viewed

@@ -0,0 +1,120 @@
+import http from 'http';
+import { randomBytes, createHash } from 'crypto';
+import { getHubUrl, writeCredentials } from '../lib/config.js';
+import { HubClient } from '../lib/api-client.js';
+import { openBrowser } from '../lib/browser.js';
+const CLIENT_ID = 'fluidcad-cli';
+const LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
+function base64url(buf) {
+  return buf.toString('base64url');
+}
+/**
+ * Loopback + PKCE login (RFC 8252): spin up a one-shot 127.0.0.1 server, send
+ * the browser to the hub's /cli/authorize, receive the code on /callback,
+ * exchange it (with the PKCE verifier) for a token, and save it.
+ */
+function runLogin(opts) {
+  return new Promise((resolve, reject) => {
+    const hubUrl = getHubUrl(opts.hub);
+    const verifier = base64url(randomBytes(32));
+    const challenge = base64url(createHash('sha256').update(verifier).digest());
+    const state = base64url(randomBytes(16));
+    let redirectUri;
+    let settled = false;
+    const finish = (fn, arg) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(timer);
+      server.close();
+      fn(arg);
+    };
+    const server = http.createServer((req, res) => {
+      const url = new URL(req.url, 'http://127.0.0.1');
+      if (url.pathname !== '/callback') {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+      res.writeHead(200, { 'content-type': 'text/html' });
+      res.end(
+        '<!doctype html><meta charset="utf-8"><body style="font-family:system-ui;text-align:center;padding-top:3rem">' +
+          '<h2>FluidCAD CLI</h2><p>You can close this tab and return to your terminal.</p>',
+      );
+      const error = url.searchParams.get('error');
+      const code = url.searchParams.get('code');
+      const returnedState = url.searchParams.get('state');
+      (async () => {
+        if (error) {
+          throw new Error(`authorization ${error}`);
+        }
+        if (returnedState !== state) {
+          throw new Error('state mismatch — aborting (possible CSRF)');
+        }
+        if (!code) {
+          throw new Error('no authorization code in callback');
+        }
+        const { status, body } = await new HubClient(hubUrl).postJson('/api/cli/token', {
+          client_id: CLIENT_ID,
+          code,
+          code_verifier: verifier,
+          redirect_uri: redirectUri,
+        });
+        if (status !== 200 || !body.access_token) {
+          throw new Error(`token exchange failed: ${body.error_description || body.error || `HTTP ${status}`}`);
+        }
+        writeCredentials({ token: body.access_token, email: body.user?.email ?? null, hubUrl });
+        return body.user?.email ?? null;
+      })().then(
+        (email) => finish(resolve, email),
+        (err) => finish(reject, err),
+      );
+    });
+    const timer = setTimeout(
+      () => finish(reject, new Error('login timed out — no response within 5 minutes')),
+      LOGIN_TIMEOUT_MS,
+    );
+    server.on('error', (err) => finish(reject, err));
+    server.listen(0, '127.0.0.1', () => {
+      const { port } = server.address();
+      redirectUri = `http://127.0.0.1:${port}/callback`;
+      const authorizeUrl =
+        `${hubUrl}/cli/authorize?` +
+        new URLSearchParams({
+          response_type: 'code',
+          client_id: CLIENT_ID,
+          redirect_uri: redirectUri,
+          code_challenge: challenge,
+          code_challenge_method: 'S256',
+          state,
+        });
+      console.log('Opening your browser to authorize the FluidCAD CLI…');
+      console.log(`\n  ${authorizeUrl}\n`);
+      openBrowser(authorizeUrl);
+    });
+  });
+}
+export function registerLoginCommand(program) {
+  program
+    .command('login')
+    .description('Authenticate this machine with the FluidCAD hub')
+    .option('--hub <url>', 'Hub base URL (default: $FLUIDCAD_HUB_URL or https://hub.fluidcad.io)')
+    .action((opts) => {
+      runLogin(opts)
+        .then((email) => console.log(`Logged in as ${email ?? 'your account'}`))
+        .catch((err) => {
+          console.error(err?.message ?? err);
+          process.exit(1);
+        });
+    });
+}

package/bin/commands/pack.js ADDED Viewed

@@ -0,0 +1,49 @@
+import { writeFileSync } from 'fs';
+import { resolve, basename } from 'path';
+import { findEntry, readPackageVersion } from '../lib/workspace.js';
+async function runPack(opts) {
+  // The packer lives in server/ because esbuild + jszip belong at that layer;
+  // import it lazily so the rest of the CLI doesn't pay the cost.
+  const { packModel } = await import('../../server/dist/model-package/pack.js');
+  const workspace = resolve(opts.workspace ?? process.cwd());
+  const entry = findEntry(workspace, opts.entry);
+  const fluidcadVersion = readPackageVersion();
+  const { manifest, zip } = await packModel({
+    entryPath: entry,
+    workspacePath: workspace,
+    fluidcadVersion,
+    name: opts.name,
+    description: opts.description,
+  });
+  const outPath = opts.out
+    ? resolve(opts.out)
+    : resolve(workspace, basename(entry).replace(/\.fluid\.js$/i, '') + '.fluidpkg');
+  writeFileSync(outPath, zip);
+  const fileCount = manifest.files?.length ?? 0;
+  const assetCount = manifest.assets.length;
+  console.log(
+    `Wrote ${outPath} (${zip.length} bytes, ${fileCount} file${fileCount === 1 ? '' : 's'}, ` +
+      `${assetCount} asset${assetCount === 1 ? '' : 's'})`,
+  );
+}
+export function registerPackCommand(program) {
+  program
+    .command('pack')
+    .description('Package a .fluid.js model into a shareable .fluidpkg archive')
+    .option('-w, --workspace <path>', 'Workspace directory (defaults to cwd)')
+    .option('-e, --entry <file>', 'Entry .fluid.js file (auto-detected if only one exists)')
+    .option('-o, --out <path>', 'Output path (defaults to <entry-basename>.fluidpkg in the workspace)')
+    .option('-n, --name <name>', 'Package name (defaults to the entry file basename)')
+    .option('-d, --description <text>', 'Optional human description')
+    .action((opts) => {
+      runPack(opts).catch((err) => {
+        console.error(err?.message ?? err);
+        process.exit(1);
+      });
+    });
+}

package/bin/commands/publish.js ADDED Viewed

@@ -0,0 +1,136 @@
+import { resolve } from 'path';
+import { getHubUrl, readCredentials } from '../lib/config.js';
+import { HubClient } from '../lib/api-client.js';
+import { findEntry, readPackageVersion, readWorkspacePackage } from '../lib/workspace.js';
+import { readModelId, writeModelId } from '../lib/model-config.js';
+import { openBrowser } from '../lib/browser.js';
+async function runPublish(opts) {
+  const creds = readCredentials();
+  if (!creds) {
+    throw new Error('Not logged in. Run `fluidcad login` first.');
+  }
+  const hubUrl = getHubUrl(opts.hub || creds.hubUrl);
+  const workspace = resolve(opts.workspace ?? process.cwd());
+  const entry = findEntry(workspace, opts.entry);
+  // Prefills from the model's own package.json + the stable identity from
+  // fluidcad.json (null on the first publish → the hub mints one).
+  const pkg = readWorkspacePackage(workspace);
+  const name = opts.name ?? pkg.name;
+  const description = opts.description ?? pkg.description;
+  const modelId = readModelId(workspace);
+  // Render once to capture the full param schema for the manifest. This also
+  // acts as a build gate — a compile/runtime error fails the publish here,
+  // before anything is uploaded.
+  //
+  // Dynamic import is deliberate (and necessary): this pulls in the whole
+  // engine — Vite + OC wasm, ~40MB / ~110ms. bin/fluidcad.js eagerly loads
+  // every command module at startup, so a top-level import here would make
+  // `init`, `serve`, `login`, `--help` etc. pay that cost too. Loading it only
+  // when `publish` actually runs is the justified exception to "no inline
+  // imports".
+  console.log('Building model…');
+  const { captureParamDefinitions } = await import(
+    '../../server/dist/model-package/capture-params.js'
+  );
+  let paramDefinitions;
+  try {
+    paramDefinitions = await captureParamDefinitions(entry, workspace);
+  } catch (err) {
+    throw new Error(`Model failed to build — fix the error and retry:\n${err?.message ?? err}`);
+  }
+  // Pack the whole workspace (Pack v2), embedding the captured params. Lazy
+  // import for the same reason (keeps esbuild/jszip off the startup path of
+  // non-publish commands), consistent with how `pack` loads it.
+  const { packModel } = await import('../../server/dist/model-package/pack.js');
+  const { manifest, zip } = await packModel({
+    entryPath: entry,
+    workspacePath: workspace,
+    fluidcadVersion: readPackageVersion(),
+    name,
+    description,
+    paramDefinitions,
+  });
+  // Show exactly what's going up so stray files/secrets get caught before they
+  // leave the machine (the .gitignore guard plus an always-exclude list).
+  const files = manifest.files ?? [];
+  console.log(`\nUploading ${files.length} file${files.length === 1 ? '' : 's'} (${(zip.length / 1024).toFixed(1)} KB):`);
+  for (const f of files) {
+    console.log(`  ${f}`);
+  }
+  const form = new FormData();
+  form.append('fluidpkg', new Blob([zip], { type: 'application/zip' }), 'model.fluidpkg');
+  if (modelId) {
+    form.append('modelId', modelId);
+  }
+  if (name) {
+    form.append('name', name);
+  }
+  if (opts.visibility) {
+    form.append('visibility', opts.visibility);
+  }
+  const { status, body } = await new HubClient(hubUrl, creds.token).postForm('/api/publish', form);
+  if (status === 401) {
+    throw new Error('Your session has expired. Run `fluidcad login` again.');
+  }
+  if (status === 403) {
+    throw new Error(body.error || 'That model belongs to another account.');
+  }
+  if (status === 422) {
+    throw new Error(body.error || 'That FluidCAD version is not hosted yet.');
+  }
+  if (status !== 200 && status !== 201) {
+    throw new Error(body.error || `Publish failed (HTTP ${status})`);
+  }
+  // First publish for this workspace → persist the hub-minted id so the next
+  // publish lands as a new version of the same model.
+  if (!modelId && body.modelId) {
+    writeModelId(workspace, body.modelId);
+  }
+  console.log('');
+  if (body.isNewVersion) {
+    console.log(`A new version (v${body.version}) will be published — add details in your browser.`);
+  } else {
+    console.log('Created model — finish setup in your browser.');
+  }
+  if (body.formUrl) {
+    const formUrl = body.formUrl.startsWith('http') ? body.formUrl : hubUrl + body.formUrl;
+    console.log(`\n  ${formUrl}\n`);
+    await openBrowser(formUrl);
+  } else if (body.shareUrl) {
+    // Fallback for a pre-v2 hub that deployed synchronously and has no form.
+    console.log(`\n  ${body.shareUrl}\n`);
+  }
+}
+export function registerPublishCommand(program) {
+  program
+    .command('publish')
+    .description('Pack the current model and publish it to the FluidCAD hub')
+    .option('-w, --workspace <path>', 'Workspace directory (defaults to cwd)')
+    .option('-e, --entry <file>', 'Entry .fluid.js file (auto-detected if only one exists)')
+    .option('-n, --name <name>', 'Model name (defaults to the package name)')
+    .option('-d, --description <text>', 'Optional human description')
+    .option('--visibility <visibility>', 'public | unlisted | private (default: unlisted)')
+    .option('--hub <url>', 'Hub base URL (default: the hub you logged into)')
+    .action((opts) => {
+      runPublish(opts)
+        // The render spins up engine + Vite handles; exit explicitly so a
+        // successful publish doesn't hang waiting for the loop to drain.
+        .then(() => process.exit(0))
+        .catch((err) => {
+          console.error(err?.message ?? err);
+          process.exit(1);
+        });
+    });
+}

package/bin/fluidcad.js CHANGED Viewed

@@ -7,6 +7,9 @@ import { fileURLToPath } from 'url';
 import { registerInitCommand } from './commands/init.js';
 import { registerServeCommand } from './commands/serve.js';
 import { registerMcpCommand } from './commands/mcp.js';
+import { registerPackCommand } from './commands/pack.js';
+import { registerLoginCommand } from './commands/login.js';
+import { registerPublishCommand } from './commands/publish.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
@@ -19,5 +22,8 @@ const program = new Command()
 registerInitCommand(program);
 registerServeCommand(program);
 registerMcpCommand(program);
+registerPackCommand(program);
+registerLoginCommand(program);
+registerPublishCommand(program);
 program.parseAsync(process.argv);

package/bin/lib/api-client.js ADDED Viewed

@@ -0,0 +1,40 @@
+import { getHubUrl } from './config.js';
+/**
+ * Tiny client for the hub API. The CLI commands are pure API clients — open a
+ * browser, store a token, POST a package — so this just wraps `fetch` with the
+ * bearer header and a uniform `{ status, body }` result.
+ */
+export class HubClient {
+  constructor(hubUrl, token) {
+    this.base = getHubUrl(hubUrl);
+    this.token = token;
+  }
+  #authHeaders(extra = {}) {
+    return { ...(this.token ? { authorization: `Bearer ${this.token}` } : {}), ...extra };
+  }
+  async #result(res) {
+    const body = await res.json().catch(() => ({}));
+    return { status: res.status, body };
+  }
+  async postJson(path, body) {
+    const res = await fetch(this.base + path, {
+      method: 'POST',
+      headers: this.#authHeaders({ 'content-type': 'application/json' }),
+      body: JSON.stringify(body),
+    });
+    return this.#result(res);
+  }
+  async postForm(path, form) {
+    const res = await fetch(this.base + path, {
+      method: 'POST',
+      headers: this.#authHeaders(),
+      body: form,
+    });
+    return this.#result(res);
+  }
+}

package/bin/lib/browser.js ADDED Viewed

@@ -0,0 +1,16 @@
+import open from 'open';
+/**
+ * Best-effort browser open, shared by `login` and `publish`. The caller always
+ * prints the URL too, so a failure here (headless box, SSH, no DISPLAY) is
+ * non-fatal — the user can open it manually.
+ */
+export async function openBrowser(url) {
+  try {
+    const child = await open(url);
+    // Detach so a one-shot CLI process isn't held open by the browser handle.
+    child.unref?.();
+  } catch {
+    /* ignore — the URL is printed regardless */
+  }
+}

package/bin/lib/config.js ADDED Viewed

@@ -0,0 +1,39 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdirSync, readFileSync, writeFileSync, existsSync, chmodSync } from 'fs';
+// Where the CLI keeps its hub credentials. XDG-ish; one file, mode 0600.
+const CONFIG_DIR = join(homedir(), '.config', 'fluidcad');
+export const CREDENTIALS_PATH = join(CONFIG_DIR, 'credentials.json');
+const DEFAULT_HUB_URL = 'https://hub.fluidcad.io';
+/** Resolve the hub base URL: explicit override → $FLUIDCAD_HUB_URL → default. */
+export function getHubUrl(override) {
+  const url = override || process.env.FLUIDCAD_HUB_URL || DEFAULT_HUB_URL;
+  return url.replace(/\/+$/, '');
+}
+/** Read saved credentials, or null if not logged in / unreadable. */
+export function readCredentials() {
+  try {
+    const creds = JSON.parse(readFileSync(CREDENTIALS_PATH, 'utf8'));
+    return creds && creds.token ? creds : null;
+  } catch {
+    return null;
+  }
+}
+/** Persist credentials at mode 0600 (re-chmod in case the file pre-existed). */
+export function writeCredentials(creds) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CREDENTIALS_PATH, JSON.stringify(creds, null, 2) + '\n', { mode: 0o600 });
+  chmodSync(CREDENTIALS_PATH, 0o600);
+}
+/** Forget saved credentials (used by `logout`). */
+export function clearCredentials() {
+  if (existsSync(CREDENTIALS_PATH)) {
+    writeFileSync(CREDENTIALS_PATH, '{}\n', { mode: 0o600 });
+  }
+}

package/bin/lib/model-config.js ADDED Viewed

@@ -0,0 +1,38 @@
+import { readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+// `fluidcad.json` at the workspace root holds the stable, hub-minted model
+// identity (and room to grow: default visibility, name, …). It's meant to be
+// committed — like `fly.toml`, it ties a workspace to the model it publishes
+// to, so re-publishing creates a new VERSION rather than an unrelated model.
+const FILENAME = 'fluidcad.json';
+export function modelConfigPath(workspace) {
+  return join(workspace, FILENAME);
+}
+/** Read `fluidcad.json`, or an empty object if missing/unreadable. */
+export function readModelConfig(workspace) {
+  try {
+    const cfg = JSON.parse(readFileSync(modelConfigPath(workspace), 'utf8'));
+    return cfg && typeof cfg === 'object' ? cfg : {};
+  } catch {
+    return {};
+  }
+}
+/** The persisted hub model id for this workspace, or null on first publish. */
+export function readModelId(workspace) {
+  const cfg = readModelConfig(workspace);
+  return typeof cfg.modelId === 'string' && cfg.modelId ? cfg.modelId : null;
+}
+/**
+ * Persist the hub-minted model id, preserving any other fields already in
+ * `fluidcad.json`. Called after the first publish writes back the new id.
+ */
+export function writeModelId(workspace, modelId) {
+  const cfg = readModelConfig(workspace);
+  cfg.modelId = modelId;
+  writeFileSync(modelConfigPath(workspace), JSON.stringify(cfg, null, 2) + '\n');
+}

package/bin/lib/workspace.js ADDED Viewed

@@ -0,0 +1,57 @@
+import { readFileSync, existsSync, readdirSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Shared by `pack` and `publish`: both resolve the entry `.fluid.js` the same
+// way and stamp the same fluidcad version onto the package.
+/** The installed fluidcad version (from the package's own package.json). */
+export function readPackageVersion() {
+  try {
+    const pkgPath = resolve(__dirname, '..', '..', 'package.json');
+    return JSON.parse(readFileSync(pkgPath, 'utf8')).version ?? '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+/**
+ * Read the MODEL workspace's own `package.json` for publish prefills: name and
+ * description (→ short description). Distinct from `readPackageVersion`, which
+ * reads the fluidcad engine's version. Missing/unreadable fields come back
+ * undefined. (The published version number is hub-assigned, not read here.)
+ */
+export function readWorkspacePackage(workspace) {
+  try {
+    const pkg = JSON.parse(readFileSync(join(workspace, 'package.json'), 'utf8'));
+    return {
+      name: typeof pkg.name === 'string' ? pkg.name : undefined,
+      description: typeof pkg.description === 'string' ? pkg.description : undefined,
+    };
+  } catch {
+    return {};
+  }
+}
+/** Resolve the entry `.fluid.js`: the override if given, else the sole one. */
+export function findEntry(workspace, override) {
+  if (override) {
+    const abs = resolve(workspace, override);
+    if (!existsSync(abs)) {
+      throw new Error(`Entry file not found: ${abs}`);
+    }
+    return abs;
+  }
+  const candidates = readdirSync(workspace).filter((f) => f.endsWith('.fluid.js'));
+  if (candidates.length === 0) {
+    throw new Error('No .fluid.js files found in the workspace. Pass --entry to specify one.');
+  }
+  if (candidates.length > 1) {
+    throw new Error(
+      `Multiple .fluid.js files found: ${candidates.join(', ')}. Pass --entry to choose one.`,
+    );
+  }
+  return resolve(workspace, candidates[0]);
+}

package/lib/dist/common/shape-factory.d.ts CHANGED Viewed

@@ -3,6 +3,7 @@ import { Solid } from "./solid.js";
 import { Wire } from "./wire.js";
 import { Face } from "./face.js";
 import { Edge } from "./edge.js";
+import { Vertex } from "./vertex.js";
 export declare class ShapeFactory {
-    static fromShape(shape: TopoDS_Shape): Edge | Wire | Solid | Face;
+    static fromShape(shape: TopoDS_Shape): Vertex | Edge | Wire | Solid | Face;
 }

package/lib/dist/common/shape-factory.js CHANGED Viewed

@@ -3,6 +3,7 @@ import { Solid } from "./solid.js";
 import { Wire } from "./wire.js";
 import { Face } from "./face.js";
 import { Edge } from "./edge.js";
+import { Vertex } from "./vertex.js";
 export class ShapeFactory {
     static fromShape(shape) {
         if (Explorer.isSolid(shape)) {
@@ -17,6 +18,9 @@ export class ShapeFactory {
         if (Explorer.isEdge(shape)) {
             return Edge.fromTopoDSEdge(Explorer.toEdge(shape));
         }
+        if (Explorer.isVertex(shape)) {
+            return Vertex.fromTopoDSVertex(Explorer.toVertex(shape));
+        }
         if (Explorer.isCompound(shape) || Explorer.isCompoundSolid(shape)) {
             const solids = Explorer.findShapes(shape, Explorer.getOcShapeType("solid"));
             if (solids.length === 1) {

package/lib/dist/common/transformable-primitive.d.ts CHANGED Viewed

@@ -3,14 +3,15 @@ import { Matrix4 } from "../math/matrix4.js";
 import type { AxisLike } from "../math/axis.js";
 import type { PlaneLike } from "../math/plane.js";
 import type { PointLike } from "../math/point.js";
+import { type NumberParam } from "../core/param.js";
 export declare abstract class TransformablePrimitive extends SceneObject {
     transform(matrix: Matrix4): this;
-    translate(x: number): this;
-    translate(x: number, y: number): this;
-    translate(x: number, y: number, z: number): this;
+    translate(x: NumberParam): this;
+    translate(x: NumberParam, y: NumberParam): this;
+    translate(x: NumberParam, y: NumberParam, z: NumberParam): this;
     translate(p: PointLike): this;
-    rotate(angle: number): this;
-    rotate(axis: AxisLike, angle: number): this;
+    rotate(angle: NumberParam): this;
+    rotate(axis: AxisLike, angle: NumberParam): this;
     mirror(plane: PlaneLike): this;
     mirror(axis: AxisLike): this;
 }