cutline 0.0.1

package/README.md

@@ -0,0 +1,51 @@
+# Cutline
+
+Generate Markdown API reference snippets from a TypeScript entry module.
+
+`cutline` reads the public surface exported from an entry module (default
+`src/index.ts`) and turns each exported symbol into Markdown that a docs site
+can transclude with [pymdownx snippets](https://facelessuser.github.io/pymdown-extensions/extensions/snippets/)
+(`--8<-- "generated/api/Name.md"`), so the signatures shown in the docs are
+always the ones in source. Two flavours are emitted per symbol:
+
+- `Name.md` — a parsed datasheet block (lead prose + a member list with each
+  member's kind, name, type, and docs) as raw HTML.
+- `Name.bare.md` — the bare declaration in a fenced code block, for an
+  at-a-glance "shape" inline in the guides.
+
+## Usage
+
+```sh
+cutline [options]
+```
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `--tsconfig <path>` | `tsconfig.json` | tsconfig to load |
+| `--entry <path>` | `src/index.ts` | entry module whose exports define the public surface |
+| `--out <dir>` | `generated/api` | output directory |
+| `--fence <lang>` | `ts` | bare code fence language |
+| `--bare` / `--no-bare` | `--bare` | also emit a fenced `.bare.md` shape copy |
+| `--unwrap-links` / `--no-unwrap-links` | `--unwrap-links` | unwrap `{@link X}` references into plain `X` |
+| `--clean` / `--no-clean` | `--clean` | clear the output directory first |
+
+## Library
+
+The pipeline is split so it can be exercised without touching disk:
+
+```ts
+import { ApiDocGenerator } from "cutline";
+
+const generator = new ApiDocGenerator({ entryFile: "src/public.ts" });
+const symbols = generator.describe(sourceFile); // ApiSymbol[]
+const snippet = generator.render(symbols[0]); // Snippet
+generator.run(); // read tsconfig, render all, write files
+```
+
+## Development
+
+```sh
+pnpm install
+pnpm test
+pnpm run start -- --entry src/index.ts --out generated/api
+```

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { type ApiDocsConfig } from "./index.js";
+export declare function parseCliConfig(argv?: string[]): Partial<ApiDocsConfig>;

package/dist/cli.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * Command-line front end for {@link ApiDocGenerator}. Reads the entry module's
+ * public surface and writes the Markdown snippets, with every setting overridable:
+ *   tsx src/cli.ts --entry src/public.ts --out docs/api --fence typescript --no-bare
+ */
+import { fileURLToPath } from "node:url";
+import { ApiDocGenerator, DEFAULT_CONFIG } from "./index.js";
+export function parseCliConfig(argv = process.argv.slice(2)) {
+    const overrides = {};
+    const value = (i) => {
+        const v = argv[i + 1];
+        if (v === undefined || v.startsWith("--"))
+            throw new Error(`Missing value for ${argv[i]}`);
+        return v;
+    };
+    for (let i = 0; i < argv.length; i++) {
+        switch (argv[i]) {
+            case "--tsconfig":
+                overrides.tsConfigFilePath = value(i++);
+                break;
+            case "--entry":
+                overrides.entryFile = value(i++);
+                break;
+            case "--out":
+                overrides.outDir = value(i++);
+                break;
+            case "--fence":
+                overrides.fenceLanguage = value(i++);
+                break;
+            case "--bare":
+                overrides.emitBare = true;
+                break;
+            case "--no-bare":
+                overrides.emitBare = false;
+                break;
+            case "--unwrap-links":
+                overrides.unwrapLinks = true;
+                break;
+            case "--no-unwrap-links":
+                overrides.unwrapLinks = false;
+                break;
+            case "--clean":
+                overrides.cleanOutDir = true;
+                break;
+            case "--no-clean":
+                overrides.cleanOutDir = false;
+                break;
+            case "-h":
+            case "--help":
+                printHelp();
+                process.exit(0);
+                break;
+            default:
+                throw new Error(`Unknown argument: ${argv[i]}`);
+        }
+    }
+    return overrides;
+}
+function printHelp() {
+    console.log(`cutline — generate Markdown API snippets from a TypeScript entry module
+
+Usage: cutline [options]
+
+Options:
+ --tsconfig <path>                  tsconfig to load          (default: ${DEFAULT_CONFIG.tsConfigFilePath})
+ --entry <path>                     entry module              (default: ${DEFAULT_CONFIG.entryFile})
+ --out <dir>                        output directory          (default: ${DEFAULT_CONFIG.outDir})
+ --fence <lang>                     bare code fence language  (default: ${DEFAULT_CONFIG.fenceLanguage})
+ --bare | --no-bare                 emit fenced shape copy     (default: ${DEFAULT_CONFIG.emitBare})
+ --unwrap-links | --no-unwrap-links unwrap {@link X}          (default: ${DEFAULT_CONFIG.unwrapLinks})
+ --clean | --no-clean               clear out dir first       (default: ${DEFAULT_CONFIG.cleanOutDir})
+ -h, --help                         show this help`);
+}
+function main() {
+    const names = new ApiDocGenerator(parseCliConfig()).run();
+    console.log(`Generated ${names.length} API snippets: ${names.sort().join(", ")}`);
+}
+// Run only when executed directly, not when imported (e.g. by tests).
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+    main();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAsB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjF,MAAM,UAAU,cAAc,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,MAAM,SAAS,GAA2B,EAAE,CAAC;IAE7C,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3F,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,YAAY;gBACf,SAAS,CAAC,gBAAgB,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxC,MAAM;YACR,KAAK,SAAS;gBACZ,SAAS,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACjC,MAAM;YACR,KAAK,OAAO;gBACV,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,SAAS;gBACZ,SAAS,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,QAAQ;gBACX,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAC1B,MAAM;YACR,KAAK,WAAW;gBACd,SAAS,CAAC,QAAQ,GAAG,KAAK,CAAC;gBAC3B,MAAM;YACR,KAAK,gBAAgB;gBACnB,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC;gBAC7B,MAAM;YACR,KAAK,mBAAmB;gBACtB,SAAS,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC9B,MAAM;YACR,KAAK,SAAS;gBACZ,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC;gBAC7B,MAAM;YACR,KAAK,YAAY;gBACf,SAAS,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC9B,MAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;0EAK4D,cAAc,CAAC,gBAAgB;0EAC/B,cAAc,CAAC,SAAS;0EACxB,cAAc,CAAC,MAAM;0EACrB,cAAc,CAAC,aAAa;2EAC3B,cAAc,CAAC,QAAQ;0EACxB,cAAc,CAAC,WAAW;0EAC1B,cAAc,CAAC,WAAW;mDACjD,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,IAAI;IACX,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,MAAM,kBAAkB,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,sEAAsE;AACtE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+import { type SourceFile } from "ts-morph";
+export interface ApiDocsConfig {
+    /** tsconfig used to load the project. */
+    tsConfigFilePath: string;
+    /** Entry module whose exported declarations define the public surface. */
+    entryFile: string;
+    /** Directory snippets are written to. */
+    outDir: string;
+    /** Fence info-string for the bare code blocks (e.g. "ts", "typescript"). */
+    fenceLanguage: string;
+    /** Also emit a `.bare.md` (fenced declaration) variant of every snippet. */
+    emitBare: boolean;
+    /** Unwrap `{@link X}` references into plain `X`. */
+    unwrapLinks: boolean;
+    /** Remove the output directory before writing (fresh run). */
+    cleanOutDir: boolean;
+}
+export declare const DEFAULT_CONFIG: ApiDocsConfig;
+/** A documented `@param` of a function or method. */
+export interface ParamDoc {
+    name: string;
+    doc: string;
+}
+/** What a member is, which the reference shows as a tag in the gutter. */
+export type FieldKind = "property" | "method" | "accessor" | "function" | "const";
+/** One member of an interface or namespace. Text fields are raw (unescaped). */
+export interface Field {
+    name: string;
+    kind: FieldKind;
+    /** `Type` for a value, or `(params): Return` for a callable. Empty when the field is a nested object. */
+    type: string;
+    optional: boolean;
+    readonly: boolean;
+    doc: string;
+    params: ParamDoc[];
+    /** Members of an inline object type, so nested shapes keep their hierarchy. */
+    children: Field[];
+}
+/** An exported symbol reduced to what the reference renders. */
+export interface ApiSymbol {
+    /** The symbol's name (e.g. `Action`, `simulator`). */
+    name: string;
+    /** Output basename, sans extension (e.g. `Action`, `simulator.ns`). */
+    file: string;
+    kind: "interface" | "namespace";
+    doc: string;
+    fields: Field[];
+    /** The bare declaration body (pre-fence): real TS for the `.bare.md` variant. */
+    bare: string;
+}
+/** The Markdown rendered for one symbol. */
+export interface Snippet {
+    name: string;
+    file: string;
+    /** `<file>.md` — the parsed datasheet block. */
+    full: string;
+    /** `<file>.bare.md` — the fenced bare declaration. */
+    bare: string;
+}
+/** Remove the common leading indentation a nested declaration carries. */
+export declare function dedentBlock(code: string): string;
+export declare class ApiDocGenerator {
+    private readonly config;
+    constructor(config?: Partial<ApiDocsConfig>);
+    /** Read the configured tsconfig, render every export, write the files, and return the names. */
+    run(): string[];
+    /** Render every exported symbol of an entry module to its Markdown snippet(s). */
+    generate(index: SourceFile): Snippet[];
+    /** Reduce every exported symbol of an entry module to the parsed model (no rendering). */
+    describe(index: SourceFile): ApiSymbol[];
+    private describeSymbol;
+    private describeInterface;
+    private describeNamespace;
+    private fieldsFrom;
+    private fieldFromProperty;
+    private fieldFromMethod;
+    private fieldFromGetter;
+    private fieldFromFunction;
+    private fieldFromConst;
+    /** A `(params): Return` call signature with the body stripped. */
+    private signature;
+    private paramsFrom;
+    /** Unwrap `{@link X}` and collapse whitespace. Escaping happens at render time. */
+    private text;
+    /** Render one symbol to its `.md` (datasheet) and `.bare.md` (fenced) snippets. */
+    render(symbol: ApiSymbol): Snippet;
+    /**
+     * The datasheet body as one raw-HTML block. It uses only `<div>`/`<span>` (never
+     * `<p>`) and no blank lines, so a host page can keep its markdown `### heading`
+     * (for the anchor and TOC entry) without Markdown's paragraph rules reflowing
+     * this raw HTML into stray paragraphs.
+     */
+    private renderBody;
+    private renderFields;
+    private renderField;
+    private renderParams;
+    /** A declaration with its JSDoc removed, dedented, and the leading `export ` dropped. */
+    private bareDeclaration;
+    /** A namespace's bare shape: one signature per member, no JSDoc. */
+    private bareNamespace;
+    private fence;
+    private prepareOutDir;
+    private writeSnippet;
+}

package/dist/index.js

@@ -0,0 +1,301 @@
+/**
+ * API signature codegen.
+ *
+ * Reads the public surface exported from an entry module (default `src/index.ts`)
+ * and turns each exported symbol into Markdown the docs transclude with pymdownx
+ * snippets (`--8<-- "generated/api/Name.md"`), so the signatures shown are always
+ * the ones in source. Two flavours per symbol:
+ *   - `Name.md`      a parsed datasheet block (lead prose + a member list with
+ *                    each member's kind, name, type, and docs) as raw HTML.
+ *   - `Name.bare.md` the bare declaration in a fenced code block, for an
+ *                    at-a-glance "shape" inline in the guides.
+ *
+ * The pipeline is split so it can be exercised without touching disk:
+ *   describe(sourceFile) -> ApiSymbol[]   the parsed model
+ *   render(symbol)       -> Snippet       the Markdown for one symbol
+ *   run()                                 read tsconfig, render all, write files
+ */
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { Node, Project, } from "ts-morph";
+export const DEFAULT_CONFIG = {
+    tsConfigFilePath: "tsconfig.json",
+    entryFile: "src/index.ts",
+    outDir: "generated/api",
+    fenceLanguage: "ts",
+    emitBare: true,
+    unwrapLinks: true,
+    cleanOutDir: true,
+};
+/* ----------------------------------------------------------- text helpers */
+/** Remove the common leading indentation a nested declaration carries. */
+export function dedentBlock(code) {
+    const lines = code.split("\n");
+    const indents = lines
+        .slice(1)
+        .filter((l) => l.trim().length > 0)
+        .map((l) => l.match(/^[ \t]*/)?.[0].length ?? 0);
+    const common = indents.length ? Math.min(...indents) : 0;
+    if (common === 0)
+        return code;
+    return [lines[0], ...lines.slice(1).map((l) => l.slice(common))].join("\n");
+}
+function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/** Pull the description and any `@param` docs off a node's leading JSDoc. */
+function docOf(node) {
+    if (!Node.isJSDocable(node))
+        return { doc: "", params: [] };
+    const jsDoc = node.getJsDocs().at(0);
+    if (!jsDoc)
+        return { doc: "", params: [] };
+    const params = jsDoc
+        .getTags()
+        .filter(Node.isJSDocParameterTag)
+        // TSDoc allows a hyphen between the name and its description (`@param x - text`).
+        .map((tag) => ({ name: tag.getName(), doc: (tag.getCommentText() ?? "").trim().replace(/^-\s*/, "") }));
+    return { doc: jsDoc.getDescription().trim(), params };
+}
+/* ------------------------------------------------------------- generator */
+export class ApiDocGenerator {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /** Read the configured tsconfig, render every export, write the files, and return the names. */
+    run() {
+        const project = new Project({ tsConfigFilePath: this.config.tsConfigFilePath });
+        const index = project.getSourceFileOrThrow(this.config.entryFile);
+        this.prepareOutDir();
+        const snippets = this.generate(index);
+        for (const snippet of snippets)
+            this.writeSnippet(snippet);
+        return snippets.map((s) => s.name);
+    }
+    /** Render every exported symbol of an entry module to its Markdown snippet(s). */
+    generate(index) {
+        return this.describe(index).map((symbol) => this.render(symbol));
+    }
+    /** Reduce every exported symbol of an entry module to the parsed model (no rendering). */
+    describe(index) {
+        const symbols = [];
+        for (const [name, declarations] of index.getExportedDeclarations()) {
+            symbols.push(...this.describeSymbol(name, declarations[0]));
+        }
+        return symbols;
+    }
+    /* ---- extraction ---- */
+    describeSymbol(name, decl) {
+        if (Node.isInterfaceDeclaration(decl)) {
+            return [this.describeInterface(name, decl.getMembers(), decl)];
+        }
+        if (Node.isTypeAliasDeclaration(decl)) {
+            const typeNode = decl.getTypeNode();
+            const members = typeNode && Node.isTypeLiteral(typeNode) ? typeNode.getMembers() : [];
+            return [this.describeInterface(name, members, decl)];
+        }
+        if (Node.isModuleDeclaration(decl)) {
+            return this.describeNamespace(name, decl);
+        }
+        return [];
+    }
+    describeInterface(name, members, decl) {
+        return {
+            name,
+            file: name,
+            kind: "interface",
+            doc: this.text(docOf(decl).doc),
+            fields: this.fieldsFrom(members),
+            bare: this.bareDeclaration(decl.getText()),
+        };
+    }
+    describeNamespace(name, decl) {
+        const fields = [
+            ...decl.getVariableDeclarations().map((v) => this.fieldFromConst(v, name)),
+            ...decl.getFunctions().map((fn) => this.fieldFromFunction(fn, name)),
+        ];
+        const namespace = {
+            name,
+            // `.ns` suffix avoids colliding with a same-named interface on a
+            // case-insensitive filesystem (e.g. `simulator` vs `Simulator`).
+            file: `${name}.ns`,
+            kind: "namespace",
+            doc: this.text(docOf(decl).doc),
+            fields,
+            bare: this.bareNamespace(fields),
+        };
+        // Interfaces declared inside the namespace are referenced by its signatures
+        // but aren't top-level exports, so describe them too.
+        const interfaces = decl
+            .getInterfaces()
+            .map((iface) => this.describeInterface(iface.getName(), iface.getMembers(), iface));
+        return [namespace, ...interfaces];
+    }
+    fieldsFrom(members) {
+        const fields = [];
+        for (const member of members) {
+            if (Node.isPropertySignature(member))
+                fields.push(this.fieldFromProperty(member));
+            else if (Node.isMethodSignature(member))
+                fields.push(this.fieldFromMethod(member));
+            else if (Node.isGetAccessorDeclaration(member))
+                fields.push(this.fieldFromGetter(member));
+        }
+        return fields;
+    }
+    fieldFromProperty(prop) {
+        const { doc, params } = docOf(prop);
+        const typeNode = prop.getTypeNode();
+        const children = typeNode && Node.isTypeLiteral(typeNode) ? this.fieldsFrom(typeNode.getMembers()) : [];
+        const type = children.length ? "" : this.text(typeNode?.getText() ?? prop.getType().getText());
+        return {
+            name: prop.getName(),
+            kind: "property",
+            type,
+            optional: prop.hasQuestionToken(),
+            readonly: prop.isReadonly(),
+            doc: this.text(doc),
+            params: this.paramsFrom(params),
+            children,
+        };
+    }
+    fieldFromMethod(method) {
+        const { doc, params } = docOf(method);
+        return {
+            name: method.getName(),
+            kind: "method",
+            type: this.signature(method),
+            optional: method.hasQuestionToken(),
+            readonly: false,
+            doc: this.text(doc),
+            params: this.paramsFrom(params),
+            children: [],
+        };
+    }
+    fieldFromGetter(getter) {
+        const ret = getter.getReturnTypeNode()?.getText() ?? getter.getReturnType().getText();
+        return {
+            name: getter.getName(),
+            kind: "accessor",
+            type: this.text(ret),
+            optional: false,
+            readonly: false,
+            doc: this.text(docOf(getter).doc),
+            params: [],
+            children: [],
+        };
+    }
+    fieldFromFunction(fn, namespace) {
+        const { doc, params } = docOf(fn);
+        return {
+            name: `${namespace}.${fn.getName()}`,
+            kind: "function",
+            type: this.signature(fn),
+            optional: false,
+            readonly: false,
+            doc: this.text(doc),
+            params: this.paramsFrom(params),
+            children: [],
+        };
+    }
+    fieldFromConst(decl, namespace) {
+        const type = decl.getTypeNode()?.getText() ?? decl.getType().getText();
+        const statement = decl.getVariableStatement();
+        return {
+            name: `${namespace}.${decl.getName()}`,
+            kind: "const",
+            type: this.text(type),
+            optional: false,
+            readonly: false,
+            doc: this.text(statement ? docOf(statement).doc : ""),
+            params: [],
+            children: [],
+        };
+    }
+    /** A `(params): Return` call signature with the body stripped. */
+    signature(fn) {
+        const params = fn
+            .getParameters()
+            .map((p) => p.getText())
+            .join(", ");
+        const ret = fn.getReturnTypeNode()?.getText() ?? fn.getReturnType().getText();
+        return this.text(`(${params}): ${ret}`);
+    }
+    paramsFrom(params) {
+        return params.map((p) => ({ name: p.name, doc: this.text(p.doc) }));
+    }
+    /** Unwrap `{@link X}` and collapse whitespace. Escaping happens at render time. */
+    text(raw) {
+        const unwrapped = this.config.unwrapLinks ? raw.replace(/\{@link\s+([^}|]+)(\|[^}]+)?\}/g, "$1") : raw;
+        return unwrapped.replace(/\s+/g, " ").trim();
+    }
+    /* ---- rendering ---- */
+    /** Render one symbol to its `.md` (datasheet) and `.bare.md` (fenced) snippets. */
+    render(symbol) {
+        return { name: symbol.name, file: symbol.file, full: this.renderBody(symbol), bare: this.fence(symbol.bare) };
+    }
+    /**
+     * The datasheet body as one raw-HTML block. It uses only `<div>`/`<span>` (never
+     * `<p>`) and no blank lines, so a host page can keep its markdown `### heading`
+     * (for the anchor and TOC entry) without Markdown's paragraph rules reflowing
+     * this raw HTML into stray paragraphs.
+     */
+    renderBody(symbol) {
+        const lead = symbol.doc ? `<div class="api-lead">${escapeHtml(symbol.doc)}</div>` : "";
+        const fields = symbol.fields.length ? this.renderFields(symbol.fields) : "";
+        return `<div class="api-body">${lead}${fields}</div>\n`;
+    }
+    renderFields(fields) {
+        return `<div class="api-fields">${fields.map((f) => this.renderField(f)).join("")}</div>`;
+    }
+    renderField(field) {
+        const tag = `<span class="api-kind k-${field.kind}"></span>`;
+        const readonly = field.readonly ? `<span class="api-readonly">readonly</span>` : "";
+        const optional = field.optional ? `<span class="api-opt">?</span>` : "";
+        const type = field.type ? `<span class="api-type">${escapeHtml(field.type)}</span>` : "";
+        const head = `<div class="api-field-head">${readonly}<span class="api-name">${escapeHtml(field.name)}</span>${optional}${type}</div>`;
+        const doc = field.doc ? `<div class="api-field-doc">${escapeHtml(field.doc)}</div>` : "";
+        const params = field.params.length ? this.renderParams(field.params) : "";
+        const children = field.children.length ? this.renderFields(field.children) : "";
+        return `<div class="api-field f-${field.kind}">${tag}${head}${doc}${params}${children}</div>`;
+    }
+    renderParams(params) {
+        const rows = params
+            .map((p) => {
+            const doc = p.doc ? `<span class="api-param-doc">${escapeHtml(p.doc)}</span>` : "";
+            return `<div class="api-param"><span class="api-name">${escapeHtml(p.name)}</span>${doc}</div>`;
+        })
+            .join("");
+        return `<div class="api-params"><div class="api-params-label">Parameters</div>${rows}</div>`;
+    }
+    /* ---- bare (fenced) variant ---- */
+    /** A declaration with its JSDoc removed, dedented, and the leading `export ` dropped. */
+    bareDeclaration(code) {
+        return dedentBlock(code)
+            .replace(/(^|\n)export\s+/g, "$1")
+            .replace(/[ \t]*\/\*\*[\s\S]*?\*\/\n?/g, "")
+            .replace(/\n{3,}/g, "\n\n")
+            .trim();
+    }
+    /** A namespace's bare shape: one signature per member, no JSDoc. */
+    bareNamespace(fields) {
+        return fields.map((f) => (f.type.startsWith("(") ? `${f.name}${f.type}` : `${f.name}: ${f.type}`)).join("\n");
+    }
+    fence(body) {
+        return `\`\`\`${this.config.fenceLanguage}\n${body}\n\`\`\`\n`;
+    }
+    /* ---- disk ---- */
+    prepareOutDir() {
+        if (this.config.cleanOutDir)
+            rmSync(this.config.outDir, { recursive: true, force: true });
+        mkdirSync(this.config.outDir, { recursive: true });
+    }
+    writeSnippet(snippet) {
+        writeFileSync(join(this.config.outDir, `${snippet.file}.md`), snippet.full);
+        if (this.config.emitBare) {
+            writeFileSync(join(this.config.outDir, `${snippet.file}.bare.md`), snippet.bare);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "cutline",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "Generate Markdown API reference snippets from a TypeScript entry module.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "cutline": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ts-morph": "^28.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@types/node": "^25.9.1",
+    "lefthook": "^2.1.9",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "start": "tsx src/cli.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "typecheck": "tsc --noEmit"
+  }
+}