towel-txt 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog, and this project uses Semantic
+Versioning.
+
+## Unreleased
+
+### Added
+
+- Release workflow serialization and timeout guardrails for safer publishing.
+- Maintainer release preflight check for repository metadata, branch protection,
+  workflow health, npm package state, and publish credentials.
+- Automated coverage for release preflight success and failure scenarios.
+
+## 0.1.0 - 2026-05-30
+
+### Added
+
+- Initial open-source project scaffold.
+- CLI file rendering from Markdown input to printable HTML output.
+- Complete CLI reference for options, config fields, and common workflows.
+- Custom CSS support for generated HTML documents.
+- Dependabot update groups for npm dependencies and GitHub Actions.
+- Documented the production readiness roadmap.
+- Explicit page break markers and print break helper classes.
+- Example Markdown document and generated printable HTML output.
+- Example custom print CSS file.
+- Front matter metadata parsing for document title, subtitle, author, date, and cover fields.
+- GitHub Actions workflow dependencies updated to Node 24-compatible majors.
+- Local relative image asset copying with copied, skipped, and missing diagnostics.
+- Local image paths with Windows separators are handled consistently across platforms.
+- Local image asset output directories with generated image path rewriting.
+- Minor and patch Dependabot grouping with manual handling for major npm updates.
+- Markdown heading extraction with stable heading IDs.
+- Markdown body HTML rendering with safe raw HTML escaping.
+- Named document themes: `default`, `compact`, and `report`.
+- Optional cover pages from metadata, config, or CLI flags.
+- Optional minified HTML output with `--minify` or config defaults.
+- Optional table of contents suppression with `--no-toc`.
+- Output overwrite protection with `--force`.
+- Package metadata, exports, and publishable file list readiness checks.
+- CodeQL code scanning for JavaScript and TypeScript security analysis.
+- Package smoke testing for packed CLI installs.
+- PDF export through a local Chrome, Edge, or Chromium browser.
+- Production examples for reports, briefs, technical notes, images, and custom CSS.
+- Print page size and margin options for generated HTML documents.
+- Printable HTML document rendering with default screen and print styles.
+- Project config files with `--config` and `--no-config`.
+- Release checks for changelog, package metadata, and version consistency.
+- Release workflow for verified package dry-runs and optional publishing.
+- Release workflow publish prerequisite validation for npm credentials.
+- Security audit and performance smoke gates in CI and release verification.
+- Vitest upgraded to a patched 4.x release for GHSA-5xrq-8626-4rwp.
+- Windows CI coverage for cross-platform CLI verification.
+- Print-friendly footnotes with backlinks.
+- Render summary JSON files for CI and script workflows.
+- Security and limits documentation for rendering, image copying, CSS, and PDF export.
+- Stable CLI exit codes for usage errors, render errors, and strict warning failures.
+- Strict mode for failing renders when warnings are detected.
+- Stdin Markdown input with `--stdin`.
+- Stdout HTML output with `--stdout`.
+- Syntax highlighting for JavaScript, TypeScript, JSON, and shell code fences.
+- Table of contents tree building and HTML rendering.
+- Watch mode with `--watch` for local Markdown and CSS rebuilds.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Towel.txt 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,334 @@
+# Towel.txt
+
+Towel.txt is a small command-line tool for turning Markdown into clean,
+printable HTML and PDF documents.
+
+It is designed for notes, reports, project writeups, briefs, and other
+documents that start as plain Markdown but need a polished browser-printable
+output.
+
+## Status
+
+Towel.txt can currently generate self-contained printable HTML and PDF files
+from Markdown. PDF export uses a local Chrome, Edge, or Chromium browser.
+The first public package release is prepared as `0.1.0`; publishing requires
+the maintainer release workflow and npm credentials.
+
+## Goals
+
+- Convert Markdown files into readable HTML documents.
+- Generate a table of contents from document headings.
+- Include print-friendly CSS by default.
+- Highlight common code fences with print-friendly colors.
+- Render footnotes with backlinks for longer documents.
+- Add an optional cover page from document metadata.
+- Insert explicit print page breaks when a document needs fixed pagination.
+- Keep output simple enough to inspect, customize, and share.
+- Provide a focused CLI that works well in scripts and local workflows.
+
+## Install From Source
+
+```bash
+git clone https://github.com/kaleab-kali/towel.txt.git
+cd towel.txt
+pnpm install
+pnpm build
+```
+
+## Usage
+
+```bash
+towel-txt document.md -o document.html
+```
+
+For every command option, config field, conflict rule, and common workflow, see
+[docs/cli-reference.md](docs/cli-reference.md).
+
+Append a custom CSS file to the built-in print styles:
+
+```bash
+towel-txt document.md -o document.html --css examples/print.css
+```
+
+Place copied local image assets under a specific output folder:
+
+```bash
+towel-txt document.md -o dist/document.html --asset-dir assets
+```
+
+Generate compact HTML with layout whitespace removed:
+
+```bash
+towel-txt document.md -o document.html --minify
+```
+
+Write a JSON summary for CI or scripts:
+
+```bash
+towel-txt document.md -o document.html --summary-json summary.json
+```
+
+Fail the render when warnings are detected:
+
+```bash
+towel-txt document.md -o document.html --strict
+```
+
+Set print page size and margins:
+
+```bash
+towel-txt document.md -o document.html --page-size "A4 landscape" --margin 18mm
+```
+
+Generate a PDF:
+
+```bash
+towel-txt document.md --format pdf -o document.pdf
+```
+
+The CLI also infers PDF output from a `.pdf` output path:
+
+```bash
+towel-txt document.md -o document.pdf
+```
+
+Use a specific browser executable for PDF export:
+
+```bash
+towel-txt document.md --format pdf -o document.pdf --browser /path/to/chrome
+```
+
+Select a built-in theme:
+
+```bash
+towel-txt document.md -o document.html --theme report
+```
+
+Add a cover page for a rendered document:
+
+```bash
+towel-txt document.md -o document.html --cover --subtitle "Quarterly planning notes"
+```
+
+Insert a print page break by placing a marker on its own line:
+
+```md
+First section.
+
+[[page-break]]
+
+Second section.
+```
+
+Rebuild output when the Markdown or custom CSS file changes:
+
+```bash
+towel-txt document.md -o document.html --watch
+```
+
+Load defaults from a config file:
+
+```bash
+towel-txt document.md --config towel-txt.config.yaml
+```
+
+Overwrite an existing output file intentionally:
+
+```bash
+towel-txt document.md -o document.html --force
+```
+
+Disable the automatic table of contents:
+
+```bash
+towel-txt document.md -o document.html --no-toc
+```
+
+Write generated HTML to stdout for piping:
+
+```bash
+towel-txt document.md --stdout
+```
+
+Read Markdown from stdin:
+
+```bash
+cat document.md | towel-txt --stdin --stdout
+```
+
+During local development, run the CLI through pnpm:
+
+```bash
+pnpm dev examples/sample.md --output examples/sample.html
+```
+
+The CLI supports:
+
+- Markdown input files.
+- HTML output files.
+- PDF output files through Chrome, Edge, or Chromium.
+- Configurable copied asset output directories with `--asset-dir`.
+- Syntax highlighting for JavaScript, TypeScript, JSON, and shell code fences.
+- Footnotes using `[^label]` references and matching definitions.
+- Optional cover pages from metadata, config, or `--cover`.
+- Explicit page break markers: `[[page-break]]`, `\pagebreak`, and `\newpage`.
+- Document title configuration.
+- Front matter metadata for title, subtitle, author, date, and cover pages.
+- Custom CSS appended to the default document styles.
+- Heading anchors.
+- Named themes: `default`, `compact`, and `report`.
+- Output overwrite protection with an explicit `--force` option.
+- Optional minified HTML output with `--minify`.
+- Print page size and margin configuration.
+- Relative local image asset copying with copied, skipped, and missing diagnostics.
+- Table of contents generation.
+- Optional table of contents suppression.
+- Project config files for shared defaults.
+- Render summary JSON files for CI and scripts.
+- Watch mode for rebuilding file output during local editing.
+- Stdout output for shell pipelines.
+- Stdin input for shell pipelines.
+- Strict mode for CI workflows that should fail on warnings.
+- Stable CLI exit codes for scripts.
+- Default screen and print styles.
+
+## Metadata
+
+Documents can include YAML front matter at the top of the Markdown file:
+
+```md
+---
+title: Project Brief
+subtitle: Quarterly planning notes
+author: Kaleab
+date: 2026-05-27
+cover: true
+---
+
+# Project Brief
+```
+
+The `title` field controls the generated HTML document title unless `--title` is
+provided on the CLI. Set `cover: true` to render a cover page before the table of
+contents and document body. Use `--no-cover` to disable a metadata or config
+cover page for one command.
+
+## Footnotes
+
+Use `[^label]` references in the document body and matching definitions later in
+the Markdown file:
+
+```md
+Detailed context can live in a note.[^context]
+
+[^context]: Footnotes support Markdown such as **strong text** and links.
+```
+
+Generated footnotes are rendered at the end of the document with backlinks to
+their references.
+
+## Page Breaks
+
+Use `[[page-break]]`, `\pagebreak`, or `\newpage` on its own line to insert an
+explicit print break. The generated CSS also includes `.break-before-page`,
+`.break-after-page`, and `.avoid-page-break` helpers for custom styles.
+
+## Configuration
+
+Towel.txt automatically looks for `towel-txt.config.yaml`,
+`towel-txt.config.yml`, or `towel-txt.config.json` in the current working
+directory. Use `--config <path>` to load a specific config file, or
+`--no-config` to disable discovery.
+
+```yaml
+output: dist/document.html
+assetDir: assets
+css: examples/print.css
+format: html
+theme: report
+title: Project Brief
+subtitle: Quarterly planning notes
+cover: true
+pageSize: A4
+margin: 18mm
+minify: false
+strict: false
+summaryJson: dist/summary.json
+tableOfContents: true
+```
+
+CLI flags override config defaults. Use `--toc` when a config file disables the
+table of contents and one command needs it enabled.
+
+Supported config fields are `output`, `assetDir`, `css`, `format`, `theme`,
+`title`, `subtitle`, `cover`, `pageSize`, `margin`, `minify`,
+`strict`, `summaryJson`, `tableOfContents`, and `browser`.
+
+## Strict Mode
+
+Use `--strict` to fail the command when warnings are detected. Strict mode
+currently fails on missing or skipped image assets and front matter metadata
+that would otherwise be ignored, such as unsupported fields or invalid value
+types. Use `--no-strict` to disable a config default for one command.
+
+## JSON Summary
+
+Use `--summary-json <path>` to write a machine-readable summary file after a
+successful render. The summary includes the output format, absolute input and
+output paths, bytes written, minify status, copied image results, and warning
+messages.
+
+## Example
+
+See [examples/sample.md](examples/sample.md) and the generated
+[examples/sample.html](examples/sample.html).
+
+See [examples/print.css](examples/print.css) for a small custom CSS example.
+See [examples/towel-txt.config.yaml](examples/towel-txt.config.yaml) for a
+small config example.
+See [docs/examples.md](docs/examples.md) for report, brief, technical note,
+image, and custom CSS workflows.
+See [docs/security-and-limits.md](docs/security-and-limits.md) for renderer
+security behavior and operational limits.
+
+The generated HTML is self-contained, so it can be opened directly in a browser
+and printed from the browser print dialog.
+
+When output is written to a different directory, safe relative Markdown image
+paths such as `images/diagram.png` are copied beside the generated HTML output.
+The CLI reports copied images, skipped remote or unsafe sources, and missing
+local files. Use `--asset-dir <dir>` or config `assetDir` to place copied assets
+under a dedicated output folder and rewrite the generated image paths.
+
+PDF output uses browser print automation. Install Chrome, Edge, or Chromium, or
+pass `--browser <path>` if the executable is not on the default search path.
+
+## Development
+
+This repository uses Node.js, TypeScript, and pnpm.
+
+```bash
+pnpm install
+pnpm release:check
+pnpm lint
+pnpm security:audit
+pnpm typecheck
+pnpm test
+pnpm build
+pnpm perf:smoke
+pnpm smoke:package
+```
+
+## Roadmap
+
+See [docs/production-roadmap.md](docs/production-roadmap.md) for the production
+readiness backlog.
+
+## Contributing
+
+Contributions should be small, focused, and easy to review. See
+[CONTRIBUTING.md](CONTRIBUTING.md) for local setup and pull request standards.
+
+## License
+
+MIT

package/dist/cli/args.d.ts

@@ -0,0 +1,45 @@
+import { type ThemeName } from "../theme/themes.js";
+import { type CliExitCode } from "./exit-codes.js";
+export type OutputFormat = "html" | "pdf";
+export type CliCommand = {
+    kind: "help";
+} | {
+    browserPath?: string;
+    assetDirectory?: string;
+    configPath?: string;
+    cover: boolean;
+    coverSpecified: boolean;
+    cssPath?: string;
+    force: boolean;
+    format?: OutputFormat;
+    inputPath?: string;
+    kind: "render";
+    margin?: string;
+    minify: boolean;
+    minifySpecified: boolean;
+    noConfig: boolean;
+    outputPath?: string;
+    pageSize?: string;
+    stdout: boolean;
+    stdin: boolean;
+    strict: boolean;
+    strictSpecified: boolean;
+    subtitle?: string;
+    summaryJsonPath?: string;
+    tableOfContents: boolean;
+    tableOfContentsSpecified: boolean;
+    theme?: ThemeName;
+    title?: string;
+    watch: boolean;
+} | {
+    kind: "version";
+};
+export declare class CliUsageError extends Error {
+    readonly exitCode: CliExitCode;
+    constructor(message: string, exitCode?: CliExitCode);
+}
+export declare class CliStrictModeError extends CliUsageError {
+    constructor(message: string);
+}
+export declare function parseCliArgs(argv: string[]): CliCommand;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1C,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,wBAAwB,EAAE,OAAO,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAqC;CAK7E;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA+JvD"}

package/dist/cli/args.js

@@ -0,0 +1,208 @@
+import { parseArgs } from "node:util";
+import { isThemeName } from "../theme/themes.js";
+import { cliExitCodes } from "./exit-codes.js";
+export class CliUsageError extends Error {
+    exitCode;
+    constructor(message, exitCode = cliExitCodes.usageError) {
+        super(message);
+        this.name = "CliUsageError";
+        this.exitCode = exitCode;
+    }
+}
+export class CliStrictModeError extends CliUsageError {
+    constructor(message) {
+        super(message, cliExitCodes.strictWarnings);
+        this.name = "CliStrictModeError";
+    }
+}
+export function parseCliArgs(argv) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            allowPositionals: true,
+            args: argv,
+            options: {
+                browser: {
+                    type: "string"
+                },
+                "asset-dir": {
+                    type: "string"
+                },
+                config: {
+                    type: "string"
+                },
+                cover: {
+                    type: "boolean"
+                },
+                help: {
+                    short: "h",
+                    type: "boolean"
+                },
+                css: {
+                    type: "string"
+                },
+                force: {
+                    type: "boolean"
+                },
+                format: {
+                    type: "string"
+                },
+                output: {
+                    short: "o",
+                    type: "string"
+                },
+                margin: {
+                    type: "string"
+                },
+                minify: {
+                    type: "boolean"
+                },
+                "page-size": {
+                    type: "string"
+                },
+                "no-toc": {
+                    type: "boolean"
+                },
+                "no-config": {
+                    type: "boolean"
+                },
+                "no-cover": {
+                    type: "boolean"
+                },
+                "no-minify": {
+                    type: "boolean"
+                },
+                "no-strict": {
+                    type: "boolean"
+                },
+                stdout: {
+                    type: "boolean"
+                },
+                stdin: {
+                    type: "boolean"
+                },
+                strict: {
+                    type: "boolean"
+                },
+                subtitle: {
+                    type: "string"
+                },
+                "summary-json": {
+                    type: "string"
+                },
+                title: {
+                    type: "string"
+                },
+                theme: {
+                    type: "string"
+                },
+                toc: {
+                    type: "boolean"
+                },
+                version: {
+                    type: "boolean"
+                },
+                watch: {
+                    type: "boolean"
+                }
+            },
+            strict: true
+        });
+    }
+    catch (error) {
+        throw new CliUsageError(error instanceof Error ? error.message : "Invalid arguments.");
+    }
+    if (parsed.values.help) {
+        return { kind: "help" };
+    }
+    if (parsed.values.version) {
+        return { kind: "version" };
+    }
+    if (parsed.values.toc === true && parsed.values["no-toc"] === true) {
+        throw new CliUsageError("Do not pass --toc with --no-toc.");
+    }
+    if (parsed.values.cover === true && parsed.values["no-cover"] === true) {
+        throw new CliUsageError("Do not pass --cover with --no-cover.");
+    }
+    if (parsed.values.minify === true && parsed.values["no-minify"] === true) {
+        throw new CliUsageError("Do not pass --minify with --no-minify.");
+    }
+    if (parsed.values.strict === true && parsed.values["no-strict"] === true) {
+        throw new CliUsageError("Do not pass --strict with --no-strict.");
+    }
+    if (parsed.values.stdin === true && parsed.positionals.length > 0) {
+        throw new CliUsageError("Do not pass an input file when using --stdin.");
+    }
+    if (parsed.values.stdin !== true && parsed.positionals.length !== 1) {
+        throw new CliUsageError("Expected exactly one Markdown input file.");
+    }
+    return {
+        assetDirectory: getAssetDirectoryOption(parsed.values["asset-dir"], "--asset-dir"),
+        browserPath: getStringOption(parsed.values.browser),
+        configPath: getStringOption(parsed.values.config),
+        cover: parsed.values.cover === true && parsed.values["no-cover"] !== true,
+        coverSpecified: parsed.values.cover === true || parsed.values["no-cover"] === true,
+        cssPath: getStringOption(parsed.values.css),
+        force: parsed.values.force === true,
+        format: getOutputFormatOption(parsed.values.format),
+        ...(parsed.positionals[0] ? { inputPath: parsed.positionals[0] } : {}),
+        kind: "render",
+        margin: getStringOption(parsed.values.margin),
+        minify: parsed.values.minify === true && parsed.values["no-minify"] !== true,
+        minifySpecified: parsed.values.minify === true || parsed.values["no-minify"] === true,
+        noConfig: parsed.values["no-config"] === true,
+        outputPath: getStringOption(parsed.values.output),
+        pageSize: getStringOption(parsed.values["page-size"]),
+        stdin: parsed.values.stdin === true,
+        stdout: parsed.values.stdout === true,
+        strict: parsed.values.strict === true && parsed.values["no-strict"] !== true,
+        strictSpecified: parsed.values.strict === true || parsed.values["no-strict"] === true,
+        subtitle: getStringOption(parsed.values.subtitle),
+        summaryJsonPath: getStringOption(parsed.values["summary-json"]),
+        tableOfContents: parsed.values["no-toc"] !== true,
+        tableOfContentsSpecified: parsed.values["no-toc"] === true || parsed.values.toc === true,
+        theme: getThemeOption(parsed.values.theme),
+        title: getStringOption(parsed.values.title),
+        watch: parsed.values.watch === true
+    };
+}
+function getThemeOption(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (isThemeName(value)) {
+        return value;
+    }
+    throw new CliUsageError('Expected --theme to be "default", "compact", or "report".');
+}
+function getStringOption(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function getAssetDirectoryOption(value, optionName) {
+    const directory = getStringOption(value)?.trim();
+    if (!directory) {
+        return undefined;
+    }
+    if (directory.includes("?") ||
+        directory.includes("#") ||
+        /^[a-z][a-z0-9+.-]*:/iu.test(directory) ||
+        directory.startsWith("/") ||
+        directory.startsWith("\\")) {
+        throw new CliUsageError(`Expected ${optionName} to be a safe relative directory.`);
+    }
+    const normalizedDirectory = directory.replace(/\\/g, "/");
+    const parts = normalizedDirectory.split("/");
+    if (parts.includes("..") || parts.includes("")) {
+        throw new CliUsageError(`Expected ${optionName} to be a safe relative directory.`);
+    }
+    return normalizedDirectory;
+}
+function getOutputFormatOption(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === "html" || value === "pdf") {
+        return value;
+    }
+    throw new CliUsageError('Expected --format to be "html" or "pdf".');
+}

package/dist/cli/assets.d.ts

@@ -0,0 +1,15 @@
+export interface CopyImageAssetsOptions {
+    assetDirectory?: string;
+    inputPath: string;
+    markdown: string;
+    outputPath: string;
+}
+export interface ImageAssetCopyResult {
+    error?: string;
+    reason?: string;
+    source: string;
+    status: "copied" | "missing" | "skipped";
+    targetSource?: string;
+}
+export declare function copyLocalImageAssets(options: CopyImageAssetsOptions): Promise<ImageAssetCopyResult[]>;
+//# sourceMappingURL=assets.d.ts.map

package/dist/cli/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/cli/assets.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA6CjC"}