@tenphi/create-cookbook 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrey Yamanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @tenphi/create-cookbook
+
+Create a static docs project from the actual contents of a published package:
+
+```sh
+npm create @tenphi/cookbook@latest my-docs -- --package your-package --yes
+```

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { n as scaffold } from "./scaffold-B1o_OYiO.js";
+import { spawn } from "node:child_process";
+import { parseArgs } from "node:util";
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+//#region src/prompts.ts
+async function prompt(question) {
+	const readline = createInterface({
+		input: stdin,
+		output: stdout
+	});
+	try {
+		return (await readline.question(question)).trim();
+	} finally {
+		readline.close();
+	}
+}
+async function confirm(question) {
+	const answer = (await prompt(`${question} [y/N] `)).toLowerCase();
+	return answer === "y" || answer === "yes";
+}
+//#endregion
+//#region src/cli.ts
+const { positionals, values } = parseArgs({
+	allowPositionals: true,
+	allowNegative: true,
+	options: {
+		package: { type: "string" },
+		yes: {
+			type: "boolean",
+			short: "y",
+			default: false
+		},
+		brand: { type: "string" },
+		site: { type: "string" },
+		base: { type: "string" },
+		deploy: { type: "string" },
+		"package-manager": { type: "string" },
+		install: {
+			type: "boolean",
+			default: true
+		},
+		open: {
+			type: "boolean",
+			default: false
+		},
+		vendor: {
+			type: "boolean",
+			default: false
+		},
+		"trust-package": {
+			type: "boolean",
+			default: false
+		},
+		help: {
+			type: "boolean",
+			short: "h",
+			default: false
+		}
+	}
+});
+if (values.help) printHelp();
+const packageSpecifier = values.package ?? (values.yes ? void 0 : await prompt("npm package: "));
+if (!packageSpecifier) {
+	console.error("--package is required in non-interactive mode.");
+	printHelp(1);
+}
+const manager = values["package-manager"];
+if (manager && ![
+	"npm",
+	"pnpm",
+	"yarn"
+].includes(manager)) throw new Error(`Invalid package manager: ${manager}.`);
+const deployment = values.deploy;
+if (deployment && deployment !== "github-pages" && deployment !== "none") throw new Error(`Invalid deploy preset: ${deployment}.`);
+const result = await scaffold({
+	package: packageSpecifier,
+	...positionals[0] ? { destination: positionals[0] } : {},
+	...manager ? { packageManager: manager } : {},
+	install: values.install,
+	...values.brand ? { brand: values.brand } : {},
+	...values.site ? { site: values.site } : {},
+	...values.base ? { base: values.base } : {},
+	...deployment ? { deploy: deployment } : {},
+	trustPackage: values["trust-package"],
+	vendor: values.vendor,
+	...!values.yes ? { confirmNonEmpty: (destination) => confirm(`${destination} is not empty. Continue and overwrite generated files?`) } : {}
+});
+console.log(`\nPackage  ${result.lock.resolved}\nHome     ${result.discovery.home ?? "(none)"}\nPages    ${result.discovery.pages.length}\nAssets   ${result.discovery.assets.length}\n\nCreated ${result.destination}`);
+if (values.open) {
+	if (!values.install) throw new Error("--open requires dependency installation; remove --no-install.");
+	const args = result.packageManager === "npm" ? [
+		"run",
+		"dev",
+		"--",
+		"--open"
+	] : [
+		"run",
+		"dev",
+		"--open"
+	];
+	spawn(result.packageManager, args, {
+		cwd: result.destination,
+		detached: true,
+		stdio: "ignore"
+	}).unref();
+}
+function printHelp(code = 0) {
+	console.log(`Usage: create-cookbook [destination] --package <specifier> [options]\n\nOptions:\n  --yes, -y\n  --brand <color>\n  --site <url>\n  --base <path>\n  --deploy github-pages|none\n  --package-manager npm|pnpm|yarn\n  --no-install\n  --vendor\n  --trust-package\n  --open`);
+	process.exit(code);
+}
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/prompts.ts","../src/cli.ts"],"sourcesContent":["import { createInterface } from \"node:readline/promises\";\nimport { stdin, stdout } from \"node:process\";\n\nexport async function prompt(question: string): Promise<string> {\n  const readline = createInterface({ input: stdin, output: stdout });\n  try {\n    return (await readline.question(question)).trim();\n  } finally {\n    readline.close();\n  }\n}\n\nexport async function confirm(question: string): Promise<boolean> {\n  const answer = (await prompt(`${question} [y/N] `)).toLowerCase();\n  return answer === \"y\" || answer === \"yes\";\n}\n","import { spawn } from \"node:child_process\";\nimport { parseArgs } from \"node:util\";\nimport { confirm, prompt } from \"./prompts.js\";\nimport { scaffold, type PackageManager } from \"./scaffold.js\";\n\nconst { positionals, values } = parseArgs({\n  allowPositionals: true,\n  allowNegative: true,\n  options: {\n    package: { type: \"string\" },\n    yes: { type: \"boolean\", short: \"y\", default: false },\n    brand: { type: \"string\" },\n    site: { type: \"string\" },\n    base: { type: \"string\" },\n    deploy: { type: \"string\" },\n    \"package-manager\": { type: \"string\" },\n    install: { type: \"boolean\", default: true },\n    open: { type: \"boolean\", default: false },\n    vendor: { type: \"boolean\", default: false },\n    \"trust-package\": { type: \"boolean\", default: false },\n    help: { type: \"boolean\", short: \"h\", default: false },\n  },\n});\n\nif (values.help) printHelp();\n\nconst packageSpecifier =\n  values.package ?? (values.yes ? undefined : await prompt(\"npm package: \"));\nif (!packageSpecifier) {\n  console.error(\"--package is required in non-interactive mode.\");\n  printHelp(1);\n}\n\nconst manager = values[\"package-manager\"];\nif (manager && ![\"npm\", \"pnpm\", \"yarn\"].includes(manager))\n  throw new Error(`Invalid package manager: ${manager}.`);\nconst deployment = values.deploy;\nif (deployment && deployment !== \"github-pages\" && deployment !== \"none\")\n  throw new Error(`Invalid deploy preset: ${deployment}.`);\n\nconst result = await scaffold({\n  package: packageSpecifier,\n  ...(positionals[0] ? { destination: positionals[0] } : {}),\n  ...(manager ? { packageManager: manager as PackageManager } : {}),\n  install: values.install,\n  ...(values.brand ? { brand: values.brand } : {}),\n  ...(values.site ? { site: values.site } : {}),\n  ...(values.base ? { base: values.base } : {}),\n  ...(deployment ? { deploy: deployment as \"github-pages\" | \"none\" } : {}),\n  trustPackage: values[\"trust-package\"],\n  vendor: values.vendor,\n  ...(!values.yes\n    ? {\n        confirmNonEmpty: (destination: string) =>\n          confirm(\n            `${destination} is not empty. Continue and overwrite generated files?`,\n          ),\n      }\n    : {}),\n});\n\nconsole.log(\n  `\\nPackage  ${result.lock.resolved}\\nHome     ${result.discovery.home ?? \"(none)\"}\\nPages    ${result.discovery.pages.length}\\nAssets   ${result.discovery.assets.length}\\n\\nCreated ${result.destination}`,\n);\nif (values.open) {\n  if (!values.install) {\n    throw new Error(\n      \"--open requires dependency installation; remove --no-install.\",\n    );\n  }\n  const args =\n    result.packageManager === \"npm\"\n      ? [\"run\", \"dev\", \"--\", \"--open\"]\n      : [\"run\", \"dev\", \"--open\"];\n  const server = spawn(result.packageManager, args, {\n    cwd: result.destination,\n    detached: true,\n    stdio: \"ignore\",\n  });\n  server.unref();\n}\n\nfunction printHelp(code = 0): never {\n  console.log(\n    `Usage: create-cookbook [destination] --package <specifier> [options]\\n\\nOptions:\\n  --yes, -y\\n  --brand <color>\\n  --site <url>\\n  --base <path>\\n  --deploy github-pages|none\\n  --package-manager npm|pnpm|yarn\\n  --no-install\\n  --vendor\\n  --trust-package\\n  --open`,\n  );\n  process.exit(code);\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+
+import { PackageDiscovery, PackageLockSource } from "@tenphi/docs";
+//#region src/scaffold.d.ts
+type PackageManager = "npm" | "pnpm" | "yarn";
+interface ScaffoldOptions {
+  package: string;
+  destination?: string;
+  packageManager?: PackageManager;
+  install?: boolean;
+  brand?: string;
+  site?: string;
+  base?: string;
+  deploy?: "github-pages" | "none";
+  trustPackage?: boolean;
+  vendor?: boolean;
+  confirmNonEmpty?: (destination: string) => Promise<boolean>;
+}
+interface ScaffoldResult {
+  destination: string;
+  lock: PackageLockSource;
+  discovery: PackageDiscovery;
+  packageManager: PackageManager;
+}
+declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
+declare function inferPackageManager(userAgent?: string | undefined): PackageManager;
+//#endregion
+export { type PackageManager, type ScaffoldOptions, type ScaffoldResult, inferPackageManager, scaffold };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/scaffold.ts"],"mappings":";;;KAcY;UAEK;EACf;EACA;EACA,iBAAiB;EACjB;EACA;EACA;EACA;EACA;EACA;EACA;EACA,mBAAmB,wBAAwB;;UAG5B;EACf;EACA,MAAM;EACN,WAAW;EACX,gBAAgB;;iBAGI,SACpB,SAAS,kBACR,QAAQ;iBAmJK,oBACd,iCACC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { n as scaffold, t as inferPackageManager } from "./scaffold-B1o_OYiO.js";
+export { inferPackageManager, scaffold };

package/dist/scaffold-B1o_OYiO.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { cp, mkdir, readdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { defaultLock, discoverPackage, materializePackage, packageNameFromSpecifier, resolvePackageLock, writeDocsLock } from "@tenphi/docs";
+//#region src/scaffold.ts
+async function scaffold(options) {
+	const packageName = packageNameFromSpecifier(options.package);
+	const destination = resolve(options.destination ?? `${packageName.replace(/^@[^/]+\//, "")}-docs`);
+	const packageManager = options.packageManager ?? inferPackageManager();
+	const lock = await resolvePackageLock(options.package);
+	const packageRoot = await materializePackage(lock, {
+		strict: true,
+		ci: false,
+		base: "/",
+		cacheDir: "",
+		maxArtifactBytes: 26214400,
+		maxUnpackedBytes: 104857600,
+		maxFiles: 1e4,
+		maxPathDepth: 24,
+		maxAssetBytes: 20971520
+	});
+	const discovery = await discoverPackage(packageRoot);
+	await mkdir(destination, { recursive: true });
+	if ((await readdir(destination)).length > 0) {
+		if (!await options.confirmNonEmpty?.(destination)) throw new Error(`Destination is not empty: ${destination}.`);
+	}
+	const projectLock = options.vendor ? {
+		...lock,
+		vendored: ".cookbook/vendor/package"
+	} : lock;
+	if (options.vendor && projectLock.vendored) {
+		await mkdir(join(destination, ".cookbook", "vendor"), { recursive: true });
+		await cp(packageRoot, join(destination, projectLock.vendored), { recursive: true });
+	}
+	await Promise.all([
+		writeFile(join(destination, "package.json"), packageJson(packageManager), "utf8"),
+		writeFile(join(destination, "astro.config.ts"), astroConfig(options), "utf8"),
+		writeFile(join(destination, "tsconfig.json"), tsconfig(), "utf8"),
+		writeFile(join(destination, ".gitignore"), "node_modules/\ndist/\n.astro/\n", "utf8"),
+		writeDocsLock(destination, defaultLock([projectLock]))
+	]);
+	if (options.deploy === "github-pages") await writeGithubWorkflow(destination);
+	if (options.install !== false) await installDependencies(destination, packageManager);
+	return {
+		destination,
+		lock: projectLock,
+		discovery,
+		packageManager
+	};
+}
+function packageJson(packageManager) {
+	const packageManagerVersion = {
+		npm: "npm@11",
+		pnpm: "pnpm@11",
+		yarn: "yarn@4"
+	}[packageManager];
+	return `${JSON.stringify({
+		name: "cookbook-site",
+		version: "0.0.0",
+		private: true,
+		type: "module",
+		packageManager: packageManagerVersion,
+		scripts: {
+			dev: "astro dev",
+			build: "astro build",
+			preview: "astro preview",
+			doctor: "cookbook doctor",
+			update: "cookbook update"
+		},
+		dependencies: {
+			astro: "^7.2.9",
+			"@tenphi/cookbook": "^0.4.0"
+		}
+	}, null, 2)}\n`;
+}
+function astroConfig(options) {
+	const source = {
+		package: options.package,
+		...options.trustPackage ? { trust: "mdx" } : {}
+	};
+	const docsConfig = {
+		...options.site ? { site: { url: options.site } } : {},
+		content: { sources: [source] },
+		...options.brand ? { theme: { brand: { from: options.brand } } } : {},
+		...options.base ? { build: { base: options.base } } : {}
+	};
+	return `import { defineConfig } from 'astro/config';\nimport cookbook from '@tenphi/cookbook';\n\nconst docs = ${JSON.stringify(docsConfig, null, 2)};\n\nexport default defineConfig({\n  ${options.site ? `site: ${JSON.stringify(options.site)},\n  ` : ""}${options.base ? `base: ${JSON.stringify(options.base)},\n  ` : ""}output: 'static',\n  integrations: [cookbook({ config: docs })],\n});\n`;
+}
+function tsconfig() {
+	return `${JSON.stringify({
+		extends: "astro/tsconfigs/strict",
+		include: [".astro/types.d.ts", "**/*"],
+		exclude: ["dist"]
+	}, null, 2)}\n`;
+}
+async function writeGithubWorkflow(destination) {
+	const directory = join(destination, ".github", "workflows");
+	await mkdir(directory, { recursive: true });
+	await writeFile(join(directory, "deploy.yml"), `name: Deploy documentation\non:\n  push:\n    branches: [main]\npermissions:\n  contents: read\n  pages: write\n  id-token: write\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: 22\n      - run: npm ci\n      - run: npm run build\n      - uses: actions/upload-pages-artifact@v3\n        with:\n          path: dist\n      - uses: actions/deploy-pages@v4\n`);
+}
+async function installDependencies(destination, manager) {
+	await new Promise((resolvePromise, reject) => {
+		const child = spawn(manager, ["install"], {
+			cwd: destination,
+			stdio: "inherit",
+			shell: process.platform === "win32"
+		});
+		child.once("error", reject);
+		child.once("exit", (code) => code === 0 ? resolvePromise() : reject(/* @__PURE__ */ new Error(`${manager} install exited with ${code}.`)));
+	});
+}
+function inferPackageManager(userAgent = process.env.npm_config_user_agent) {
+	if (userAgent?.startsWith("pnpm/")) return "pnpm";
+	if (userAgent?.startsWith("yarn/")) return "yarn";
+	return "npm";
+}
+//#endregion
+export { scaffold as n, inferPackageManager as t };
+
+//# sourceMappingURL=scaffold-B1o_OYiO.js.map

package/dist/scaffold-B1o_OYiO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-B1o_OYiO.js","names":[],"sources":["../src/scaffold.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { cp, mkdir, readdir, writeFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport {\n  defaultLock,\n  discoverPackage,\n  materializePackage,\n  packageNameFromSpecifier,\n  resolvePackageLock,\n  writeDocsLock,\n  type PackageDiscovery,\n  type PackageLockSource,\n} from \"@tenphi/docs\";\n\nexport type PackageManager = \"npm\" | \"pnpm\" | \"yarn\";\n\nexport interface ScaffoldOptions {\n  package: string;\n  destination?: string;\n  packageManager?: PackageManager;\n  install?: boolean;\n  brand?: string;\n  site?: string;\n  base?: string;\n  deploy?: \"github-pages\" | \"none\";\n  trustPackage?: boolean;\n  vendor?: boolean;\n  confirmNonEmpty?: (destination: string) => Promise<boolean>;\n}\n\nexport interface ScaffoldResult {\n  destination: string;\n  lock: PackageLockSource;\n  discovery: PackageDiscovery;\n  packageManager: PackageManager;\n}\n\nexport async function scaffold(\n  options: ScaffoldOptions,\n): Promise<ScaffoldResult> {\n  const packageName = packageNameFromSpecifier(options.package);\n  const destination = resolve(\n    options.destination ?? `${packageName.replace(/^@[^/]+\\//, \"\")}-docs`,\n  );\n  const packageManager = options.packageManager ?? inferPackageManager();\n  const lock = await resolvePackageLock(options.package);\n  const buildDefaults = {\n    strict: true,\n    ci: false,\n    base: \"/\",\n    cacheDir: \"\",\n    maxArtifactBytes: 25 * 1024 * 1024,\n    maxUnpackedBytes: 100 * 1024 * 1024,\n    maxFiles: 10_000,\n    maxPathDepth: 24,\n    maxAssetBytes: 20 * 1024 * 1024,\n  };\n  const packageRoot = await materializePackage(lock, buildDefaults);\n  const discovery = await discoverPackage(packageRoot);\n\n  await mkdir(destination, { recursive: true });\n  const existing = await readdir(destination);\n  if (existing.length > 0) {\n    const confirmed = await options.confirmNonEmpty?.(destination);\n    if (!confirmed)\n      throw new Error(`Destination is not empty: ${destination}.`);\n  }\n\n  const projectLock = options.vendor\n    ? { ...lock, vendored: \".cookbook/vendor/package\" }\n    : lock;\n  if (options.vendor && projectLock.vendored) {\n    await mkdir(join(destination, \".cookbook\", \"vendor\"), {\n      recursive: true,\n    });\n    await cp(packageRoot, join(destination, projectLock.vendored), {\n      recursive: true,\n    });\n  }\n\n  await Promise.all([\n    writeFile(\n      join(destination, \"package.json\"),\n      packageJson(packageManager),\n      \"utf8\",\n    ),\n    writeFile(\n      join(destination, \"astro.config.ts\"),\n      astroConfig(options),\n      \"utf8\",\n    ),\n    writeFile(join(destination, \"tsconfig.json\"), tsconfig(), \"utf8\"),\n    writeFile(\n      join(destination, \".gitignore\"),\n      \"node_modules/\\ndist/\\n.astro/\\n\",\n      \"utf8\",\n    ),\n    writeDocsLock(destination, defaultLock([projectLock])),\n  ]);\n  if (options.deploy === \"github-pages\") await writeGithubWorkflow(destination);\n  if (options.install !== false)\n    await installDependencies(destination, packageManager);\n  return { destination, lock: projectLock, discovery, packageManager };\n}\n\nfunction packageJson(packageManager: PackageManager): string {\n  const packageManagerVersion = {\n    npm: \"npm@11\",\n    pnpm: \"pnpm@11\",\n    yarn: \"yarn@4\",\n  }[packageManager];\n  return `${JSON.stringify(\n    {\n      name: \"cookbook-site\",\n      version: \"0.0.0\",\n      private: true,\n      type: \"module\",\n      packageManager: packageManagerVersion,\n      scripts: {\n        dev: \"astro dev\",\n        build: \"astro build\",\n        preview: \"astro preview\",\n        doctor: \"cookbook doctor\",\n        update: \"cookbook update\",\n      },\n      dependencies: { astro: \"^7.2.9\", \"@tenphi/cookbook\": \"^0.4.0\" },\n    },\n    null,\n    2,\n  )}\\n`;\n}\n\nfunction astroConfig(options: ScaffoldOptions): string {\n  const source = {\n    package: options.package,\n    ...(options.trustPackage ? { trust: \"mdx\" as const } : {}),\n  };\n  const docsConfig = {\n    ...(options.site ? { site: { url: options.site } } : {}),\n    content: { sources: [source] },\n    ...(options.brand ? { theme: { brand: { from: options.brand } } } : {}),\n    ...(options.base ? { build: { base: options.base } } : {}),\n  };\n  return `import { defineConfig } from 'astro/config';\\nimport cookbook from '@tenphi/cookbook';\\n\\nconst docs = ${JSON.stringify(docsConfig, null, 2)};\\n\\nexport default defineConfig({\\n  ${options.site ? `site: ${JSON.stringify(options.site)},\\n  ` : \"\"}${options.base ? `base: ${JSON.stringify(options.base)},\\n  ` : \"\"}output: 'static',\\n  integrations: [cookbook({ config: docs })],\\n});\\n`;\n}\n\nfunction tsconfig(): string {\n  return `${JSON.stringify(\n    {\n      extends: \"astro/tsconfigs/strict\",\n      include: [\".astro/types.d.ts\", \"**/*\"],\n      exclude: [\"dist\"],\n    },\n    null,\n    2,\n  )}\\n`;\n}\n\nasync function writeGithubWorkflow(destination: string): Promise<void> {\n  const directory = join(destination, \".github\", \"workflows\");\n  await mkdir(directory, { recursive: true });\n  await writeFile(\n    join(directory, \"deploy.yml\"),\n    `name: Deploy documentation\\non:\\n  push:\\n    branches: [main]\\npermissions:\\n  contents: read\\n  pages: write\\n  id-token: write\\njobs:\\n  build:\\n    runs-on: ubuntu-latest\\n    steps:\\n      - uses: actions/checkout@v4\\n      - uses: actions/setup-node@v4\\n        with:\\n          node-version: 22\\n      - run: npm ci\\n      - run: npm run build\\n      - uses: actions/upload-pages-artifact@v3\\n        with:\\n          path: dist\\n      - uses: actions/deploy-pages@v4\\n`,\n  );\n}\n\nasync function installDependencies(\n  destination: string,\n  manager: PackageManager,\n): Promise<void> {\n  await new Promise<void>((resolvePromise, reject) => {\n    const child = spawn(manager, [\"install\"], {\n      cwd: destination,\n      stdio: \"inherit\",\n      shell: process.platform === \"win32\",\n    });\n    child.once(\"error\", reject);\n    child.once(\"exit\", (code) =>\n      code === 0\n        ? resolvePromise()\n        : reject(new Error(`${manager} install exited with ${code}.`)),\n    );\n  });\n}\n\nexport function inferPackageManager(\n  userAgent = process.env.npm_config_user_agent,\n): PackageManager {\n  if (userAgent?.startsWith(\"pnpm/\")) return \"pnpm\";\n  if (userAgent?.startsWith(\"yarn/\")) return \"yarn\";\n  return \"npm\";\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@tenphi/create-cookbook",
+  "version": "0.4.0",
+  "description": "Create a reproducible Cookbook site from a published npm package",
+  "type": "module",
+  "bin": {
+    "create-cookbook": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.14"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tenphi/cookbook.git",
+    "directory": "packages/create"
+  },
+  "homepage": "https://github.com/tenphi/cookbook#readme",
+  "bugs": {
+    "url": "https://github.com/tenphi/cookbook/issues"
+  },
+  "author": "Andrey Yamanov",
+  "license": "MIT",
+  "dependencies": {
+    "@tenphi/docs": "0.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.2",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsdown --config tsdown.config.ts",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}