js.documents 1.96.4 → 1.97.0

package/dist/bin-dispatch.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/bin-dispatch.ts
+const RUNNERS = {
+	npm: {
+		command: "npx",
+		prefixArgs: ["-y"]
+	},
+	pnpm: {
+		command: "pnpm",
+		prefixArgs: ["dlx"]
+	},
+	yarn: {
+		command: "yarn",
+		prefixArgs: ["dlx"]
+	},
+	bun: {
+		command: "bunx",
+		prefixArgs: []
+	}
+};
+function detectPackageManager(userAgent) {
+	const ua = userAgent ?? "";
+	if (ua.startsWith("yarn/")) return ua.startsWith("yarn/1.") ? "npm" : "yarn";
+	if (ua.startsWith("pnpm/")) return "pnpm";
+	if (ua.startsWith("bun/")) return "bun";
+	return "npm";
+}
+/**
+* Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+*/
+function resolveBinDispatch(argv, userAgent) {
+	const head = argv[0];
+	const pkg = head === "mcp" ? "document-mcp" : "document-cli";
+	const passThrough = head === "mcp" || head === "cli" ? argv.slice(1) : argv;
+	const { command, prefixArgs } = RUNNERS[detectPackageManager(userAgent)];
+	return {
+		pkg,
+		command,
+		runnerArgs: [
+			...prefixArgs,
+			pkg,
+			...passThrough
+		]
+	};
+}
+//#endregion
+exports.resolveBinDispatch = resolveBinDispatch;

package/dist/bin-dispatch.d.cts

@@ -0,0 +1,15 @@
+//#region src/bin-dispatch.d.ts
+interface BinDispatch {
+  /** The npm package the launcher resolves and invokes. */
+  readonly pkg: 'document-cli' | 'document-mcp';
+  /** The executable to spawn -- each JS package manager's own download-and-run command. */
+  readonly command: 'npx' | 'pnpm' | 'yarn' | 'bunx';
+  /** Arguments after the command itself -- begins with the manager's fetch flags, then the package name, then the passthrough args. */
+  readonly runnerArgs: readonly string[];
+}
+/**
+ * Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+ */
+declare function resolveBinDispatch(argv: readonly string[], userAgent: string | undefined): BinDispatch;
+//#endregion
+export { BinDispatch, resolveBinDispatch };

package/dist/bin-dispatch.d.ts

@@ -0,0 +1,15 @@
+//#region src/bin-dispatch.d.ts
+interface BinDispatch {
+  /** The npm package the launcher resolves and invokes. */
+  readonly pkg: 'document-cli' | 'document-mcp';
+  /** The executable to spawn -- each JS package manager's own download-and-run command. */
+  readonly command: 'npx' | 'pnpm' | 'yarn' | 'bunx';
+  /** Arguments after the command itself -- begins with the manager's fetch flags, then the package name, then the passthrough args. */
+  readonly runnerArgs: readonly string[];
+}
+/**
+ * Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+ */
+declare function resolveBinDispatch(argv: readonly string[], userAgent: string | undefined): BinDispatch;
+//#endregion
+export { BinDispatch, resolveBinDispatch };

package/dist/bin-dispatch.js

@@ -0,0 +1,46 @@
+//#region src/bin-dispatch.ts
+const RUNNERS = {
+	npm: {
+		command: "npx",
+		prefixArgs: ["-y"]
+	},
+	pnpm: {
+		command: "pnpm",
+		prefixArgs: ["dlx"]
+	},
+	yarn: {
+		command: "yarn",
+		prefixArgs: ["dlx"]
+	},
+	bun: {
+		command: "bunx",
+		prefixArgs: []
+	}
+};
+function detectPackageManager(userAgent) {
+	const ua = userAgent ?? "";
+	if (ua.startsWith("yarn/")) return ua.startsWith("yarn/1.") ? "npm" : "yarn";
+	if (ua.startsWith("pnpm/")) return "pnpm";
+	if (ua.startsWith("bun/")) return "bun";
+	return "npm";
+}
+/**
+* Resolves a launcher invocation into the companion package to run and the runner argument list to spawn it with. A bare invocation or any args that are not the `mcp` dispatch token run the interactive CLI; `mcp` launches the server. `cli` is the explicit escape hatch for the one collision a dispatcher that reserves a subcommand name necessarily has: a leading bare `mcp` is intercepted as "launch the server", so targeting a CLI command on a file literally named `mcp` needs `documents.js cli mcp`. document-cli's own commands never start with `mcp`, so the collision is narrow in practice -- the same "dispatcher reserves a subcommand name" model `git` uses.
+*/
+function resolveBinDispatch(argv, userAgent) {
+	const head = argv[0];
+	const pkg = head === "mcp" ? "document-mcp" : "document-cli";
+	const passThrough = head === "mcp" || head === "cli" ? argv.slice(1) : argv;
+	const { command, prefixArgs } = RUNNERS[detectPackageManager(userAgent)];
+	return {
+		pkg,
+		command,
+		runnerArgs: [
+			...prefixArgs,
+			pkg,
+			...passThrough
+		]
+	};
+}
+//#endregion
+export { resolveBinDispatch };

package/dist/bin.cjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+const require_bin_dispatch = require("./bin-dispatch.cjs");
+let node_child_process = require("node:child_process");
+//#region src/bin.ts
+const { command, runnerArgs } = require_bin_dispatch.resolveBinDispatch(process.argv.slice(2), process.env.npm_config_user_agent);
+const { status } = (0, node_child_process.spawnSync)(command, [...runnerArgs], { stdio: "inherit" });
+process.exit(status ?? 1);
+//#endregion

package/dist/bin.d.cts

@@ -0,0 +1 @@
+export {}

package/dist/bin.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/bin.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { resolveBinDispatch } from "./bin-dispatch.js";
+import { spawnSync } from "node:child_process";
+//#region src/bin.ts
+const { command, runnerArgs } = resolveBinDispatch(process.argv.slice(2), process.env.npm_config_user_agent);
+const { status } = spawnSync(command, [...runnerArgs], { stdio: "inherit" });
+process.exit(status ?? 1);
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js.documents",
-  "version": "1.96.4",
+  "version": "1.97.0",
   "description": "Bidirectional docx/pptx <-> PDF conversion and a read+write editable OOXML document model, built on ooxml.js and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -32,6 +32,9 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "documents.js": "./dist/bin.js"
+  },
   "files": [
     "dist"
   ],