@replayablejs/cli 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Replayable contributors
+
+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,29 @@
+# @replayablejs/cli
+
+Run assets, configuration, development, build and export commands.
+
+Part of [Replayable](https://github.com/replayablejs/replayable) **0.1.0-alpha.0**.
+APIs may change during the alpha series.
+
+## Install
+
+```sh
+pnpm add -D @replayablejs/cli@0.1.0-alpha.0
+```
+
+## Public surface
+
+Executable: `replayable`. This package has no library export entry.
+
+[Usage and reference](https://github.com/replayablejs/replayable/blob/main/docs/reference/cli.md).
+The package manifest defines supported import paths; internal source files are not public APIs.
+
+## Development
+
+From the repository root, install with `pnpm install --frozen-lockfile` and build dependencies
+with `pnpm build`. Run `pnpm --filter @replayablejs/cli test` for this package's tests.
+
+## License
+
+Original code is [MIT licensed](https://github.com/replayablejs/replayable/blob/main/LICENSE). Bundled third-party resources retain
+their accompanying license terms.

package/bin/replayable.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// oxlint-disable-next-line import/no-unassigned-import -- This shim executes the compiled CLI.
+import '../dist/cli.mjs';

package/dist/cli.mjs

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+import { inspect, styleText } from "node:util";
+import { Command, InvalidArgumentError } from "commander";
+import { assetConfigSchema, buildAssets } from "@replayablejs/assets";
+import { join, relative, resolve } from "node:path";
+import { createJiti } from "jiti";
+import { buildProject, servePreview } from "@replayablejs/build";
+import { createVariants, replayableConfigSchema } from "@replayablejs/config";
+import { createHash } from "node:crypto";
+import { mkdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import open from "open";
+import { createScript, createStyleSheet, dump, themes } from "@poppinss/dumper/html";
+import { toHtml } from "hast-util-to-html";
+import { h } from "hastscript";
+import { exportProject } from "@replayablejs/export";
+//#region src/errors/report-cli-error.ts
+/** Reports actionable nested failures without a stack dump and marks the command as failed. */
+function reportCliError(error) {
+	console.error(formatError(error, /* @__PURE__ */ new Set()));
+	process.exitCode = 1;
+}
+/** Preserves aggregate members and causes, guarding against circular error chains. */
+function formatError(error, ancestors) {
+	if (!(error instanceof Error)) return typeof error === "string" ? error : inspect(error, {
+		colors: false,
+		depth: 2
+	});
+	if (ancestors.has(error)) return "[Circular error]";
+	ancestors.add(error);
+	const lines = [error.message || error.name];
+	if (error instanceof AggregateError) {
+		const members = error.errors;
+		for (const member of members) lines.push(indent(formatError(member, ancestors)));
+	}
+	if (error.cause !== void 0) lines.push(indent(`Caused by: ${formatError(error.cause, ancestors)}`));
+	ancestors.delete(error);
+	return lines.join("\n");
+}
+/** Keeps multiline validation messages aligned beneath their parent failure. */
+function indent(message) {
+	return message.split("\n").map((line) => `  ${line}`).join("\n");
+}
+//#endregion
+//#region src/config/load-default-export.ts
+const jiti = createJiti(import.meta.url, { interopDefault: false });
+/** Loads the default export from one project configuration module. */
+async function loadDefaultExport(path) {
+	const file = resolve(path);
+	const module = await jiti.import(file);
+	if (typeof module !== "object" || module === null || !("default" in module)) throw new Error(`Configuration ${path} must have a default export.`);
+	return module.default;
+}
+//#endregion
+//#region src/commands/assets.ts
+function registerAssetsCommand(program) {
+	program.command("assets").description("Build optimized, typed assets").option("-c, --config <file>", "path to the asset configuration", "replayable.assets.ts").action(async ({ config }) => build(config));
+}
+async function build(configPath) {
+	const config = assetConfigSchema.parse(await loadDefaultExport(configPath));
+	const result = await buildAssets(config);
+	console.log(`Built ${result.emittedAssets} asset${result.emittedAssets === 1 ? "" : "s"} (${result.emittedFiles} file${result.emittedFiles === 1 ? "" : "s"}) into ${result.outputDirectory}`);
+}
+//#endregion
+//#region src/commands/build.ts
+/** Registers the command that builds every configured playable variant. */
+function registerBuildCommand(program) {
+	program.command("build").description("Build every configured playable variant").option("-c, --config <file>", "path to the Replayable config", "replayable.config.ts").action(async ({ config }) => runBuildCommand(config));
+}
+/** Loads one project config, builds it, and reports the generated playables. */
+async function runBuildCommand(configPath) {
+	const config = replayableConfigSchema.parse(await loadDefaultExport(configPath));
+	const result = await buildProject(config);
+	for (const variant of result.variants) {
+		const htmlFile = relative(process.cwd(), variant.htmlFile);
+		console.log(`Built ${variant.variantId} → ${htmlFile}`);
+	}
+	const count = result.variants.length;
+	console.log(`Built ${count} playable variant${count === 1 ? "" : "s"}.`);
+}
+//#endregion
+//#region src/config/config-viewer.css?inline
+var config_viewer_default = ":root{color-scheme:dark;background:#061626}body{margin:0;padding:32px}main{max-width:1200px;margin:0 auto}h1{color:#d6deeb;margin:0 0 16px;font:600 24px/1.4 system-ui,sans-serif}dl{grid-template-columns:max-content 1fr;margin:0 0 24px;font:14px/1.6 system-ui,sans-serif;display:grid}dt{color:#7fdbca;padding-right:24px;font-weight:600}dd{color:#d6deeb;margin:0}.dumper-dump pre{margin:0;overflow:auto}\n";
+//#endregion
+//#region src/config/render-config-viewer.ts
+/** Renders the viewer; authored values remain text, while Dumper owns its HTML. */
+function renderConfigViewer(config, variants) {
+	const head = h("head", [
+		h("meta", { charSet: "UTF-8" }),
+		h("meta", {
+			name: "viewport",
+			content: "width=device-width, initial-scale=1.0"
+		}),
+		h("title", "Replayable Variants"),
+		h("style", createStyleSheet() + config_viewer_default),
+		h("script", createScript())
+	]);
+	const summary = h("dl", [
+		h("dt", "Project"),
+		h("dd", config.name),
+		h("dt", "Entry"),
+		h("dd", config.entry),
+		h("dt", "Variants"),
+		h("dd", String(variants.length))
+	]);
+	const content = dump(variants, {
+		expand: true,
+		styles: themes.nightOwl
+	});
+	return `<!doctype html>
+<html lang="en">
+  ${toHtml(head)}
+  <body><main>
+    <h1>Replayable Variants</h1>
+    ${toHtml(summary)}
+    ${content}
+  </main></body>
+</html>\n`;
+}
+//#endregion
+//#region src/config/open-config-viewer.ts
+/** Writes a self-contained, collapsible variant viewer and opens it in the browser. */
+async function openConfigViewer(config, variants, configPath) {
+	const viewerDirectory = join(tmpdir(), "replayable");
+	const viewerPath = join(viewerDirectory, createViewerFileName(configPath));
+	await mkdir(viewerDirectory, { recursive: true });
+	await writeFile(viewerPath, renderConfigViewer(config, variants), "utf8");
+	await open(viewerPath);
+}
+/** Gives each project config a stable temporary viewer file without exposing its path. */
+function createViewerFileName(configPath) {
+	return `variants-${createHash("sha256").update(resolve(configPath)).digest("hex").slice(0, 12)}.html`;
+}
+//#endregion
+//#region src/commands/config.ts
+/** Registers the command that presents every configured playable variant. */
+function registerConfigCommand(program) {
+	program.command("config").description("Show the configured playable variants").option("-c, --config <file>", "path to the Replayable config", "replayable.config.ts").option("--json", "print machine-readable JSON").action(async ({ config, json }) => showConfig(config, json ?? false));
+}
+/** Loads one project config and presents its concrete playable variants. */
+async function showConfig(configPath, json) {
+	const config = replayableConfigSchema.parse(await loadDefaultExport(configPath));
+	const variants = createVariants(config);
+	if (json) {
+		console.log(JSON.stringify(variants, null, 2));
+		return;
+	}
+	await openConfigViewer(config, variants, configPath);
+	console.log("Opened the playable variants in your browser.");
+}
+//#endregion
+//#region src/commands/dev.ts
+/** Registers the command that runs one playable variant with Vite HMR. */
+function registerDevCommand(program) {
+	program.command("dev").description("Run one playable variant locally").option("-c, --config <file>", "path to the Replayable config", "replayable.config.ts").option("--host <host>", "hostname or IP address to expose").option("--language <language>", "playable language to run").option("-o, --open", "open the playable in the default browser").option("-p, --port <port>", "development server port", parsePort).option("--version <version>", "playable version to run").action(async (options) => runDevCommand(options));
+}
+/** Loads the project, starts local development, and reports reachable URLs. */
+async function runDevCommand(options) {
+	const { config: configPath, ...developmentOptions } = options;
+	const config = replayableConfigSchema.parse(await loadDefaultExport(configPath));
+	const result = await servePreview(config, {
+		...developmentOptions,
+		projectRoot: process.cwd()
+	});
+	logDevelopmentValue("Playable", result.variantId);
+	for (const url of result.localUrls) logDevelopmentValue("Local", url);
+	for (const url of result.networkUrls) logDevelopmentValue("Network", url);
+	console.log();
+}
+/** Prints one aligned and colored development server value. */
+function logDevelopmentValue(label, value) {
+	const coloredLabel = styleText("green", label.padEnd(10));
+	const coloredValue = styleText("cyan", value);
+	console.log(`${coloredLabel}${coloredValue}`);
+}
+/** Parses and validates Commander's string-valued port option. */
+function parsePort(value) {
+	const port = Number(value);
+	if (!Number.isInteger(port) || port < 1 || port > 65535) throw new InvalidArgumentError("Port must be an integer from 1 through 65535.");
+	return port;
+}
+//#endregion
+//#region src/commands/export.ts
+/** Registers the command that creates upload-ready network artifacts. */
+function registerExportCommand(program) {
+	program.command("export").description("Export every configured playable build").option("-c, --config <file>", "path to the Replayable config", "replayable.config.ts").option("-o, --output <directory>", "directory for exported artifacts").action(async (options) => runExportCommand(options));
+}
+/** Loads one project config, exports every variant, and reports their files. */
+async function runExportCommand(options) {
+	const config = replayableConfigSchema.parse(await loadDefaultExport(options.config));
+	const result = await exportProject(config, {
+		...options.output === void 0 ? {} : { outputDirectory: options.output },
+		projectRoot: process.cwd()
+	});
+	for (const variant of result.variants) console.log(`Exported ${variant.variantId} → ${relative(process.cwd(), variant.file)}`);
+	const count = result.variants.length;
+	console.log(`Exported ${count} playable variant${count === 1 ? "" : "s"}.`);
+}
+//#endregion
+//#region src/program.ts
+function createProgram() {
+	const program = new Command().name("replayable").description("Build playable ads with Replayable").showHelpAfterError();
+	registerBuildCommand(program);
+	registerDevCommand(program);
+	registerExportCommand(program);
+	registerConfigCommand(program);
+	registerAssetsCommand(program);
+	return program;
+}
+//#endregion
+//#region src/cli.ts
+createProgram().parseAsync().catch(reportCliError);
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["styles"],"sources":["../src/errors/report-cli-error.ts","../src/config/load-default-export.ts","../src/commands/assets.ts","../src/commands/build.ts","../src/config/config-viewer.css?inline","../src/config/render-config-viewer.ts","../src/config/open-config-viewer.ts","../src/commands/config.ts","../src/commands/dev.ts","../src/commands/export.ts","../src/program.ts","../src/cli.ts"],"sourcesContent":["import { inspect } from 'node:util';\n\n/** Reports actionable nested failures without a stack dump and marks the command as failed. */\nexport function reportCliError(error: unknown): void {\n  console.error(formatError(error, new Set()));\n  process.exitCode = 1;\n}\n\n/** Preserves aggregate members and causes, guarding against circular error chains. */\nfunction formatError(error: unknown, ancestors: Set<Error>): string {\n  if (!(error instanceof Error)) {\n    return typeof error === 'string' ? error : inspect(error, { colors: false, depth: 2 });\n  }\n  if (ancestors.has(error)) {\n    return '[Circular error]';\n  }\n\n  ancestors.add(error);\n  const lines = [error.message || error.name];\n\n  if (error instanceof AggregateError) {\n    const members: readonly unknown[] = error.errors;\n    for (const member of members) {\n      lines.push(indent(formatError(member, ancestors)));\n    }\n  }\n  if (error.cause !== undefined) {\n    lines.push(indent(`Caused by: ${formatError(error.cause, ancestors)}`));\n  }\n\n  ancestors.delete(error);\n  return lines.join('\\n');\n}\n\n/** Keeps multiline validation messages aligned beneath their parent failure. */\nfunction indent(message: string): string {\n  return message\n    .split('\\n')\n    .map((line) => `  ${line}`)\n    .join('\\n');\n}\n","import { resolve } from 'node:path';\n\nimport { createJiti } from 'jiti';\n\nconst jiti = createJiti(import.meta.url, { interopDefault: false });\n\n/** Loads the default export from one project configuration module. */\nexport async function loadDefaultExport(path: string): Promise<unknown> {\n  const file = resolve(path);\n  const module: unknown = await jiti.import(file);\n\n  if (typeof module !== 'object' || module === null || !('default' in module)) {\n    throw new Error(`Configuration ${path} must have a default export.`);\n  }\n\n  return module.default;\n}\n","import { assetConfigSchema, buildAssets } from '@replayablejs/assets';\nimport type { Command } from 'commander';\n\nimport { loadDefaultExport } from '../config/load-default-export.js';\nimport type { AssetsOptions } from '../types/commands.js';\n\nexport function registerAssetsCommand(program: Command): void {\n  program\n    .command('assets')\n    .description('Build optimized, typed assets')\n    .option('-c, --config <file>', 'path to the asset configuration', 'replayable.assets.ts')\n    .action(async ({ config }: AssetsOptions) => build(config));\n}\n\nasync function build(configPath: string): Promise<void> {\n  const config = assetConfigSchema.parse(await loadDefaultExport(configPath));\n  const result = await buildAssets(config);\n\n  console.log(\n    `Built ${result.emittedAssets} asset${result.emittedAssets === 1 ? '' : 's'} (${result.emittedFiles} file${result.emittedFiles === 1 ? '' : 's'}) into ${result.outputDirectory}`,\n  );\n}\n","import { relative } from 'node:path';\n\nimport { buildProject } from '@replayablejs/build';\nimport { replayableConfigSchema } from '@replayablejs/config';\nimport type { Command } from 'commander';\n\nimport { loadDefaultExport } from '../config/load-default-export.js';\nimport type { BuildOptions } from '../types/commands.js';\n\n/** Registers the command that builds every configured playable variant. */\nexport function registerBuildCommand(program: Command): void {\n  program\n    .command('build')\n    .description('Build every configured playable variant')\n    .option('-c, --config <file>', 'path to the Replayable config', 'replayable.config.ts')\n    .action(async ({ config }: BuildOptions) => runBuildCommand(config));\n}\n\n/** Loads one project config, builds it, and reports the generated playables. */\nasync function runBuildCommand(configPath: string): Promise<void> {\n  const config = replayableConfigSchema.parse(await loadDefaultExport(configPath));\n  const result = await buildProject(config);\n\n  for (const variant of result.variants) {\n    const htmlFile = relative(process.cwd(), variant.htmlFile);\n\n    console.log(`Built ${variant.variantId} → ${htmlFile}`);\n  }\n\n  const count = result.variants.length;\n\n  console.log(`Built ${count} playable variant${count === 1 ? '' : 's'}.`);\n}\n",":root {\n  color-scheme: dark;\n  background: #061626;\n}\n\nbody {\n  margin: 0;\n  padding: 32px;\n}\n\nmain {\n  margin: 0 auto;\n  max-width: 1200px;\n}\n\nh1 {\n  color: #d6deeb;\n  font:\n    600 24px/1.4 system-ui,\n    sans-serif;\n  margin: 0 0 16px;\n}\n\ndl {\n  display: grid;\n  font:\n    14px/1.6 system-ui,\n    sans-serif;\n  grid-template-columns: max-content 1fr;\n  margin: 0 0 24px;\n}\n\ndt {\n  color: #7fdbca;\n  font-weight: 600;\n  padding-right: 24px;\n}\n\ndd {\n  color: #d6deeb;\n  margin: 0;\n}\n\n.dumper-dump pre {\n  margin: 0;\n  overflow: auto;\n}\n","import { createScript, createStyleSheet, dump, themes } from '@poppinss/dumper/html';\nimport type { PlayableVariant, ReplayableConfig } from '@replayablejs/config';\nimport { toHtml } from 'hast-util-to-html';\nimport { h } from 'hastscript';\n\nimport styles from './config-viewer.css?inline';\n\n/** Renders the viewer; authored values remain text, while Dumper owns its HTML. */\nexport function renderConfigViewer(\n  config: ReplayableConfig,\n  variants: readonly PlayableVariant[],\n): string {\n  const head = h('head', [\n    h('meta', { charSet: 'UTF-8' }),\n    h('meta', { name: 'viewport', content: 'width=device-width, initial-scale=1.0' }),\n    h('title', 'Replayable Variants'),\n    h('style', createStyleSheet() + styles),\n    h('script', createScript()),\n  ]);\n  const summary = h('dl', [\n    h('dt', 'Project'),\n    h('dd', config.name),\n    h('dt', 'Entry'),\n    h('dd', config.entry),\n    h('dt', 'Variants'),\n    h('dd', String(variants.length)),\n  ]);\n  const content = dump(variants, { expand: true, styles: themes.nightOwl });\n\n  // Both serializers own escaping. The shell embeds their completed markup unchanged.\n  return `<!doctype html>\n<html lang=\"en\">\n  ${toHtml(head)}\n  <body><main>\n    <h1>Replayable Variants</h1>\n    ${toHtml(summary)}\n    ${content}\n  </main></body>\n</html>\\n`;\n}\n","import { createHash } from 'node:crypto';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join, resolve } from 'node:path';\n\nimport type { PlayableVariant, ReplayableConfig } from '@replayablejs/config';\nimport open from 'open';\n\nimport { renderConfigViewer } from './render-config-viewer.js';\n\n/** Writes a self-contained, collapsible variant viewer and opens it in the browser. */\nexport async function openConfigViewer(\n  config: ReplayableConfig,\n  variants: readonly PlayableVariant[],\n  configPath: string,\n): Promise<void> {\n  const viewerDirectory = join(tmpdir(), 'replayable');\n  const viewerPath = join(viewerDirectory, createViewerFileName(configPath));\n\n  await mkdir(viewerDirectory, { recursive: true });\n  await writeFile(viewerPath, renderConfigViewer(config, variants), 'utf8');\n  await open(viewerPath);\n}\n\n/** Gives each project config a stable temporary viewer file without exposing its path. */\nfunction createViewerFileName(configPath: string): string {\n  const configId = createHash('sha256').update(resolve(configPath)).digest('hex').slice(0, 12);\n\n  return `variants-${configId}.html`;\n}\n","import { createVariants, replayableConfigSchema } from '@replayablejs/config';\nimport type { Command } from 'commander';\n\nimport { loadDefaultExport } from '../config/load-default-export.js';\nimport { openConfigViewer } from '../config/open-config-viewer.js';\nimport type { ConfigOptions } from '../types/commands.js';\n\n/** Registers the command that presents every configured playable variant. */\nexport function registerConfigCommand(program: Command): void {\n  program\n    .command('config')\n    .description('Show the configured playable variants')\n    .option('-c, --config <file>', 'path to the Replayable config', 'replayable.config.ts')\n    .option('--json', 'print machine-readable JSON')\n    .action(async ({ config, json }: ConfigOptions) => showConfig(config, json ?? false));\n}\n\n/** Loads one project config and presents its concrete playable variants. */\nasync function showConfig(configPath: string, json: boolean): Promise<void> {\n  const config = replayableConfigSchema.parse(await loadDefaultExport(configPath));\n  const variants = createVariants(config);\n\n  if (json) {\n    console.log(JSON.stringify(variants, null, 2));\n\n    return;\n  }\n\n  await openConfigViewer(config, variants, configPath);\n  console.log('Opened the playable variants in your browser.');\n}\n","import { styleText } from 'node:util';\n\nimport { servePreview } from '@replayablejs/build';\nimport { replayableConfigSchema } from '@replayablejs/config';\nimport { InvalidArgumentError, type Command } from 'commander';\n\nimport { loadDefaultExport } from '../config/load-default-export.js';\nimport type { DevOptions } from '../types/commands.js';\n\n/** Registers the command that runs one playable variant with Vite HMR. */\nexport function registerDevCommand(program: Command): void {\n  program\n    .command('dev')\n    .description('Run one playable variant locally')\n    .option('-c, --config <file>', 'path to the Replayable config', 'replayable.config.ts')\n    .option('--host <host>', 'hostname or IP address to expose')\n    .option('--language <language>', 'playable language to run')\n    .option('-o, --open', 'open the playable in the default browser')\n    .option('-p, --port <port>', 'development server port', parsePort)\n    .option('--version <version>', 'playable version to run')\n    .action(async (options: DevOptions) => runDevCommand(options));\n}\n\n/** Loads the project, starts local development, and reports reachable URLs. */\nasync function runDevCommand(options: DevOptions): Promise<void> {\n  const { config: configPath, ...developmentOptions } = options;\n  const config = replayableConfigSchema.parse(await loadDefaultExport(configPath));\n  const result = await servePreview(config, {\n    ...developmentOptions,\n    projectRoot: process.cwd(),\n  });\n\n  logDevelopmentValue('Playable', result.variantId);\n\n  for (const url of result.localUrls) {\n    logDevelopmentValue('Local', url);\n  }\n\n  for (const url of result.networkUrls) {\n    logDevelopmentValue('Network', url);\n  }\n\n  console.log();\n}\n\n/** Prints one aligned and colored development server value. */\nfunction logDevelopmentValue(label: string, value: string): void {\n  const coloredLabel = styleText('green', label.padEnd(10));\n  const coloredValue = styleText('cyan', value);\n\n  console.log(`${coloredLabel}${coloredValue}`);\n}\n\n/** Parses and validates Commander's string-valued port option. */\nfunction parsePort(value: string): number {\n  const port = Number(value);\n\n  if (!Number.isInteger(port) || port < 1 || port > 65_535) {\n    throw new InvalidArgumentError('Port must be an integer from 1 through 65535.');\n  }\n\n  return port;\n}\n","import { relative } from 'node:path';\n\nimport { replayableConfigSchema } from '@replayablejs/config';\nimport { exportProject } from '@replayablejs/export';\nimport type { Command } from 'commander';\n\nimport { loadDefaultExport } from '../config/load-default-export.js';\nimport type { ExportOptions } from '../types/commands.js';\n\n/** Registers the command that creates upload-ready network artifacts. */\nexport function registerExportCommand(program: Command): void {\n  program\n    .command('export')\n    .description('Export every configured playable build')\n    .option('-c, --config <file>', 'path to the Replayable config', 'replayable.config.ts')\n    .option('-o, --output <directory>', 'directory for exported artifacts')\n    .action(async (options: ExportOptions) => runExportCommand(options));\n}\n\n/** Loads one project config, exports every variant, and reports their files. */\nasync function runExportCommand(options: ExportOptions): Promise<void> {\n  const config = replayableConfigSchema.parse(await loadDefaultExport(options.config));\n  const result = await exportProject(config, {\n    ...(options.output === undefined ? {} : { outputDirectory: options.output }),\n    projectRoot: process.cwd(),\n  });\n\n  for (const variant of result.variants) {\n    console.log(`Exported ${variant.variantId} → ${relative(process.cwd(), variant.file)}`);\n  }\n\n  const count = result.variants.length;\n\n  console.log(`Exported ${count} playable variant${count === 1 ? '' : 's'}.`);\n}\n","import { Command } from 'commander';\n\nimport { registerAssetsCommand } from './commands/assets.js';\nimport { registerBuildCommand } from './commands/build.js';\nimport { registerConfigCommand } from './commands/config.js';\nimport { registerDevCommand } from './commands/dev.js';\nimport { registerExportCommand } from './commands/export.js';\n\nexport function createProgram(): Command {\n  const program = new Command()\n    .name('replayable')\n    .description('Build playable ads with Replayable')\n    .showHelpAfterError();\n\n  registerBuildCommand(program);\n  registerDevCommand(program);\n  registerExportCommand(program);\n  registerConfigCommand(program);\n  registerAssetsCommand(program);\n\n  return program;\n}\n","#!/usr/bin/env node\n\nimport { reportCliError } from './errors/report-cli-error.js';\nimport { createProgram } from './program.js';\n\ncreateProgram().parseAsync().catch(reportCliError);\n"],"mappings":";;;;;;;;;;;;;;;;;;AAGA,SAAgB,eAAe,OAAsB;CACnD,QAAQ,MAAM,YAAY,uBAAO,IAAI,IAAI,CAAC,CAAC;CAC3C,QAAQ,WAAW;AACrB;;AAGA,SAAS,YAAY,OAAgB,WAA+B;CAClE,IAAI,EAAE,iBAAiB,QACrB,OAAO,OAAO,UAAU,WAAW,QAAQ,QAAQ,OAAO;EAAE,QAAQ;EAAO,OAAO;CAAE,CAAC;CAEvF,IAAI,UAAU,IAAI,KAAK,GACrB,OAAO;CAGT,UAAU,IAAI,KAAK;CACnB,MAAM,QAAQ,CAAC,MAAM,WAAW,MAAM,IAAI;CAE1C,IAAI,iBAAiB,gBAAgB;EACnC,MAAM,UAA8B,MAAM;EAC1C,KAAK,MAAM,UAAU,SACnB,MAAM,KAAK,OAAO,YAAY,QAAQ,SAAS,CAAC,CAAC;CAErD;CACA,IAAI,MAAM,UAAU,KAAA,GAClB,MAAM,KAAK,OAAO,cAAc,YAAY,MAAM,OAAO,SAAS,GAAG,CAAC;CAGxE,UAAU,OAAO,KAAK;CACtB,OAAO,MAAM,KAAK,IAAI;AACxB;;AAGA,SAAS,OAAO,SAAyB;CACvC,OAAO,QACJ,MAAM,IAAI,CAAC,CACX,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,KAAK,IAAI;AACd;;;ACpCA,MAAM,OAAO,WAAW,YAAY,KAAK,EAAE,gBAAgB,MAAM,CAAC;;AAGlE,eAAsB,kBAAkB,MAAgC;CACtE,MAAM,OAAO,QAAQ,IAAI;CACzB,MAAM,SAAkB,MAAM,KAAK,OAAO,IAAI;CAE9C,IAAI,OAAO,WAAW,YAAY,WAAW,QAAQ,EAAE,aAAa,SAClE,MAAM,IAAI,MAAM,iBAAiB,KAAK,6BAA6B;CAGrE,OAAO,OAAO;AAChB;;;ACVA,SAAgB,sBAAsB,SAAwB;CAC5D,QACG,QAAQ,QAAQ,CAAC,CACjB,YAAY,+BAA+B,CAAC,CAC5C,OAAO,uBAAuB,mCAAmC,sBAAsB,CAAC,CACxF,OAAO,OAAO,EAAE,aAA4B,MAAM,MAAM,CAAC;AAC9D;AAEA,eAAe,MAAM,YAAmC;CACtD,MAAM,SAAS,kBAAkB,MAAM,MAAM,kBAAkB,UAAU,CAAC;CAC1E,MAAM,SAAS,MAAM,YAAY,MAAM;CAEvC,QAAQ,IACN,SAAS,OAAO,cAAc,QAAQ,OAAO,kBAAkB,IAAI,KAAK,IAAI,IAAI,OAAO,aAAa,OAAO,OAAO,iBAAiB,IAAI,KAAK,IAAI,SAAS,OAAO,iBAClK;AACF;;;;ACXA,SAAgB,qBAAqB,SAAwB;CAC3D,QACG,QAAQ,OAAO,CAAC,CAChB,YAAY,yCAAyC,CAAC,CACtD,OAAO,uBAAuB,iCAAiC,sBAAsB,CAAC,CACtF,OAAO,OAAO,EAAE,aAA2B,gBAAgB,MAAM,CAAC;AACvE;;AAGA,eAAe,gBAAgB,YAAmC;CAChE,MAAM,SAAS,uBAAuB,MAAM,MAAM,kBAAkB,UAAU,CAAC;CAC/E,MAAM,SAAS,MAAM,aAAa,MAAM;CAExC,KAAK,MAAM,WAAW,OAAO,UAAU;EACrC,MAAM,WAAW,SAAS,QAAQ,IAAI,GAAG,QAAQ,QAAQ;EAEzD,QAAQ,IAAI,SAAS,QAAQ,UAAU,KAAK,UAAU;CACxD;CAEA,MAAM,QAAQ,OAAO,SAAS;CAE9B,QAAQ,IAAI,SAAS,MAAM,mBAAmB,UAAU,IAAI,KAAK,IAAI,EAAE;AACzE;;;AChCA,IAAA,wBAAA;;;;ACQA,SAAgB,mBACd,QACA,UACQ;CACR,MAAM,OAAO,EAAE,QAAQ;EACrB,EAAE,QAAQ,EAAE,SAAS,QAAQ,CAAC;EAC9B,EAAE,QAAQ;GAAE,MAAM;GAAY,SAAS;EAAwC,CAAC;EAChF,EAAE,SAAS,qBAAqB;EAChC,EAAE,SAAS,iBAAiB,IAAIA,qBAAM;EACtC,EAAE,UAAU,aAAa,CAAC;CAC5B,CAAC;CACD,MAAM,UAAU,EAAE,MAAM;EACtB,EAAE,MAAM,SAAS;EACjB,EAAE,MAAM,OAAO,IAAI;EACnB,EAAE,MAAM,OAAO;EACf,EAAE,MAAM,OAAO,KAAK;EACpB,EAAE,MAAM,UAAU;EAClB,EAAE,MAAM,OAAO,SAAS,MAAM,CAAC;CACjC,CAAC;CACD,MAAM,UAAU,KAAK,UAAU;EAAE,QAAQ;EAAM,QAAQ,OAAO;CAAS,CAAC;CAGxE,OAAO;;IAEL,OAAO,IAAI,EAAE;;;MAGX,OAAO,OAAO,EAAE;MAChB,QAAQ;;;AAGd;;;;AC5BA,eAAsB,iBACpB,QACA,UACA,YACe;CACf,MAAM,kBAAkB,KAAK,OAAO,GAAG,YAAY;CACnD,MAAM,aAAa,KAAK,iBAAiB,qBAAqB,UAAU,CAAC;CAEzE,MAAM,MAAM,iBAAiB,EAAE,WAAW,KAAK,CAAC;CAChD,MAAM,UAAU,YAAY,mBAAmB,QAAQ,QAAQ,GAAG,MAAM;CACxE,MAAM,KAAK,UAAU;AACvB;;AAGA,SAAS,qBAAqB,YAA4B;CAGxD,OAAO,YAFU,WAAW,QAAQ,CAAC,CAAC,OAAO,QAAQ,UAAU,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAE/D,EAAE;AAC9B;;;;ACrBA,SAAgB,sBAAsB,SAAwB;CAC5D,QACG,QAAQ,QAAQ,CAAC,CACjB,YAAY,uCAAuC,CAAC,CACpD,OAAO,uBAAuB,iCAAiC,sBAAsB,CAAC,CACtF,OAAO,UAAU,6BAA6B,CAAC,CAC/C,OAAO,OAAO,EAAE,QAAQ,WAA0B,WAAW,QAAQ,QAAQ,KAAK,CAAC;AACxF;;AAGA,eAAe,WAAW,YAAoB,MAA8B;CAC1E,MAAM,SAAS,uBAAuB,MAAM,MAAM,kBAAkB,UAAU,CAAC;CAC/E,MAAM,WAAW,eAAe,MAAM;CAEtC,IAAI,MAAM;EACR,QAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;EAE7C;CACF;CAEA,MAAM,iBAAiB,QAAQ,UAAU,UAAU;CACnD,QAAQ,IAAI,+CAA+C;AAC7D;;;;ACpBA,SAAgB,mBAAmB,SAAwB;CACzD,QACG,QAAQ,KAAK,CAAC,CACd,YAAY,kCAAkC,CAAC,CAC/C,OAAO,uBAAuB,iCAAiC,sBAAsB,CAAC,CACtF,OAAO,iBAAiB,kCAAkC,CAAC,CAC3D,OAAO,yBAAyB,0BAA0B,CAAC,CAC3D,OAAO,cAAc,0CAA0C,CAAC,CAChE,OAAO,qBAAqB,2BAA2B,SAAS,CAAC,CACjE,OAAO,uBAAuB,yBAAyB,CAAC,CACxD,OAAO,OAAO,YAAwB,cAAc,OAAO,CAAC;AACjE;;AAGA,eAAe,cAAc,SAAoC;CAC/D,MAAM,EAAE,QAAQ,YAAY,GAAG,uBAAuB;CACtD,MAAM,SAAS,uBAAuB,MAAM,MAAM,kBAAkB,UAAU,CAAC;CAC/E,MAAM,SAAS,MAAM,aAAa,QAAQ;EACxC,GAAG;EACH,aAAa,QAAQ,IAAI;CAC3B,CAAC;CAED,oBAAoB,YAAY,OAAO,SAAS;CAEhD,KAAK,MAAM,OAAO,OAAO,WACvB,oBAAoB,SAAS,GAAG;CAGlC,KAAK,MAAM,OAAO,OAAO,aACvB,oBAAoB,WAAW,GAAG;CAGpC,QAAQ,IAAI;AACd;;AAGA,SAAS,oBAAoB,OAAe,OAAqB;CAC/D,MAAM,eAAe,UAAU,SAAS,MAAM,OAAO,EAAE,CAAC;CACxD,MAAM,eAAe,UAAU,QAAQ,KAAK;CAE5C,QAAQ,IAAI,GAAG,eAAe,cAAc;AAC9C;;AAGA,SAAS,UAAU,OAAuB;CACxC,MAAM,OAAO,OAAO,KAAK;CAEzB,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,OAAO,OAChD,MAAM,IAAI,qBAAqB,+CAA+C;CAGhF,OAAO;AACT;;;;ACpDA,SAAgB,sBAAsB,SAAwB;CAC5D,QACG,QAAQ,QAAQ,CAAC,CACjB,YAAY,wCAAwC,CAAC,CACrD,OAAO,uBAAuB,iCAAiC,sBAAsB,CAAC,CACtF,OAAO,4BAA4B,kCAAkC,CAAC,CACtE,OAAO,OAAO,YAA2B,iBAAiB,OAAO,CAAC;AACvE;;AAGA,eAAe,iBAAiB,SAAuC;CACrE,MAAM,SAAS,uBAAuB,MAAM,MAAM,kBAAkB,QAAQ,MAAM,CAAC;CACnF,MAAM,SAAS,MAAM,cAAc,QAAQ;EACzC,GAAI,QAAQ,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,iBAAiB,QAAQ,OAAO;EAC1E,aAAa,QAAQ,IAAI;CAC3B,CAAC;CAED,KAAK,MAAM,WAAW,OAAO,UAC3B,QAAQ,IAAI,YAAY,QAAQ,UAAU,KAAK,SAAS,QAAQ,IAAI,GAAG,QAAQ,IAAI,GAAG;CAGxF,MAAM,QAAQ,OAAO,SAAS;CAE9B,QAAQ,IAAI,YAAY,MAAM,mBAAmB,UAAU,IAAI,KAAK,IAAI,EAAE;AAC5E;;;AC1BA,SAAgB,gBAAyB;CACvC,MAAM,UAAU,IAAI,QAAQ,CAAC,CAC1B,KAAK,YAAY,CAAC,CAClB,YAAY,oCAAoC,CAAC,CACjD,mBAAmB;CAEtB,qBAAqB,OAAO;CAC5B,mBAAmB,OAAO;CAC1B,sBAAsB,OAAO;CAC7B,sBAAsB,OAAO;CAC7B,sBAAsB,OAAO;CAE7B,OAAO;AACT;;;AChBA,cAAc,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,cAAc"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@replayablejs/cli",
+  "version": "0.1.0-alpha.0",
+  "description": "Command-line interface for Replayable",
+  "homepage": "https://github.com/replayablejs/replayable#readme",
+  "bugs": {
+    "url": "https://github.com/replayablejs/replayable/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/replayablejs/replayable.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "replayable": "./bin/replayable.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@poppinss/dumper": "0.7.0",
+    "commander": "15.0.0",
+    "hast-util-to-html": "9.0.5",
+    "hastscript": "9.0.1",
+    "jiti": "2.7.0",
+    "open": "11.0.1",
+    "@replayablejs/assets": "0.1.0-alpha.0",
+    "@replayablejs/build": "0.1.0-alpha.0",
+    "@replayablejs/export": "0.1.0-alpha.0",
+    "@replayablejs/config": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@tsdown/css": "0.22.14",
+    "@types/node": "26.2.0",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "oxlint --type-aware --max-warnings 0 .",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}