contentbase 0.4.0 → 0.4.1

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+import type { z } from "zod";
+import type { AstQuery } from "./ast-query";
+/** The raw item stored in Collection.items before a Document is created */
+export interface CollectionItem {
+    raw: string;
+    content: string;
+    meta: Record<string, unknown>;
+    path: string;
+    createdAt: Date;
+    updatedAt: Date;
+    size: number;
+}
+/** File metadata returned by stat and listFiles */
+export interface FileStat {
+    createdAt: Date;
+    updatedAt: Date;
+    size: number;
+}
+/** A file entry returned from listFiles — key plus pre-fetched stat */
+export interface FileEntry {
+    key: string;
+    stat: FileStat;
+}
+/**
+ * Abstracts file system operations so Collections can run on top of
+ * any storage backend (local disk, Cloudflare R2, S3, etc.).
+ *
+ * Implement this interface and pass it as `adapter` in CollectionOptions.
+ */
+export interface StorageAdapter {
+    /** List all file keys under rootPath whose names match the extension pattern.
+     *  Returns key + pre-fetched stat so load() avoids per-file round-trips. */
+    listFiles(rootPath: string, match: RegExp): Promise<FileEntry[]>;
+    /** Read file content as a UTF-8 string */
+    readFile(key: string): Promise<string>;
+    /** Fetch metadata for a single key */
+    stat(key: string): Promise<FileStat>;
+    /** Write content to key, creating any parent directories/prefixes as needed */
+    writeFile(key: string, content: string): Promise<void>;
+    /** Delete the file at key (silently succeeds if the key does not exist) */
+    deleteFile(key: string): Promise<void>;
+    /** Join a root and path segments into a full key (e.g. path.resolve for local FS) */
+    join(root: string, ...parts: string[]): string;
+    /** Strip the root prefix from a full key to get a relative key */
+    relative(root: string, key: string): string;
+    /** Return the file extension including the leading dot (e.g. ".md") */
+    extname(key: string): string;
+}
+/** Options when constructing a Collection */
+export interface CollectionOptions {
+    rootPath: string;
+    extensions?: string[];
+    name?: string;
+    /** When true (default), load() looks for a models.{ts,js,mjs} in rootPath and auto-registers exported model definitions. */
+    autoDiscover?: boolean;
+    /** Optional custom module loader for models.ts discovery. When provided, used instead of native import(). Enables VM-based loading in compiled binaries where node_modules aren't available. */
+    moduleLoader?: (filePath: string) => Record<string, any> | Promise<Record<string, any>>;
+    /**
+     * Storage adapter for file system operations.
+     * Defaults to NodeStorageAdapter (local disk via fs/promises).
+     * Swap in a custom adapter to use Cloudflare R2, S3, or any other backend.
+     */
+    adapter?: StorageAdapter;
+}
+/**
+ * A section definition declares how to extract structured data from
+ * a heading-based section of a document.
+ */
+export interface SectionDefinition<T = unknown> {
+    /** The heading text to find in the document */
+    heading: string;
+    /** Alternative heading texts to try if the primary heading is not found */
+    alternatives?: string[];
+    /** Extract structured data from the section's AST query */
+    extract: (query: AstQuery) => T;
+    /** Optional Zod schema to validate the extracted value */
+    schema?: z.ZodType<T>;
+}
+export interface HasManyDefinition<TTarget extends ModelDefinition<any, any, any, any, any> = any> {
+    type: "hasMany";
+    target: () => TTarget;
+    /** Extract children from sub-headings under this heading in the parent document */
+    heading?: string;
+    /** Find children by querying for target documents where meta[foreignKey] matches this document's slug */
+    foreignKey?: string;
+    meta?: (self: any) => Record<string, unknown>;
+    id?: (slug: string) => string;
+}
+export interface BelongsToDefinition<TTarget extends ModelDefinition<any, any, any, any, any> = any> {
+    type: "belongsTo";
+    target: () => TTarget;
+    foreignKey: (doc: DocumentRef) => string;
+}
+export type RelationshipDefinition<TTarget extends ModelDefinition<any, any, any, any, any> = any> = HasManyDefinition<TTarget> | BelongsToDefinition<TTarget>;
+/** A minimal document reference for relationship foreign key functions */
+export interface DocumentRef {
+    id: string;
+    meta: Record<string, unknown>;
+}
+/**
+ * ModelDefinition is the static config object produced by defineModel().
+ * It carries all type parameters needed to fully type a model instance.
+ *
+ * TName - string literal type for the model name
+ * TMeta - the Zod schema type for frontmatter metadata
+ * TSections - record of section definitions
+ * TRelationships - record of relationship definitions
+ * TComputed - record of computed property functions
+ */
+export interface ModelDefinition<TName extends string = string, TMeta extends z.ZodType = z.ZodType, TSections extends Record<string, SectionDefinition<any>> = Record<string, never>, TRelationships extends Record<string, RelationshipDefinition<any>> = Record<string, never>, TComputed extends Record<string, (self: any) => any> = Record<string, never>> {
+    readonly name: TName;
+    prefix: string;
+    meta: TMeta;
+    sections: TSections;
+    relationships: TRelationships;
+    computed: TComputed;
+    /** Human-readable description of this model, auto-generated if not provided */
+    description: string;
+    /** Named scopes — reusable query presets */
+    scopes: Record<string, (query: any) => any>;
+    match?: (doc: DocumentRef) => boolean;
+    defaults?: Partial<z.input<TMeta>>;
+    pattern?: string | string[];
+    /** Glob patterns or RegExp to exclude matching pathIds from queries, listings, and TOC */
+    exclude?: (string | RegExp)[];
+    /** When true, documents are not required to have an H1 title */
+    titleOptional?: boolean;
+    /** The inferred Zod schema for convenience (same as meta) */
+    schema: TMeta;
+}
+/**
+ * InferModelInstance takes a ModelDefinition and produces the shape
+ * of the runtime model instance.
+ */
+export type InferModelInstance<TDef extends ModelDefinition<any, any, any, any, any>> = TDef extends ModelDefinition<infer _TName, infer TMeta, infer TSections, infer TRelationships, infer TComputed> ? {
+    readonly id: string;
+    readonly title: string;
+    readonly slug: string;
+    readonly document: import("./document.js").Document;
+    readonly collection: import("./collection.js").Collection;
+    readonly createdAt: Date | undefined;
+    readonly updatedAt: Date | undefined;
+    readonly size: number | undefined;
+    readonly meta: z.infer<TMeta>;
+    readonly sections: {
+        readonly [K in keyof TSections]: TSections[K] extends SectionDefinition<infer U> ? U : never;
+    };
+    readonly relationships: {
+        [K in keyof TRelationships]: TRelationships[K] extends HasManyDefinition<infer TTarget> ? HasManyAccessor<TTarget> : TRelationships[K] extends BelongsToDefinition<infer TTarget> ? BelongsToAccessor<TTarget> : never;
+    };
+    readonly computed: {
+        readonly [K in keyof TComputed]: TComputed[K] extends (self: any) => infer R ? R : never;
+    };
+    validate(): Promise<ValidationResult>;
+    readonly errors: Map<string, import("zod").ZodIssue>;
+    readonly hasErrors: boolean;
+    toJSON(options?: SerializeOptions): Record<string, unknown>;
+    runAction(name: string, options?: Record<string, unknown>): Promise<unknown>;
+    save(options?: SaveOptions): Promise<void>;
+} : never;
+export interface HasManyAccessor<TTarget extends ModelDefinition<any, any, any, any, any>> {
+    fetchAll(): InferModelInstance<TTarget>[];
+    first(): InferModelInstance<TTarget> | undefined;
+    last(): InferModelInstance<TTarget> | undefined;
+    create(): Promise<InferModelInstance<TTarget>[]>;
+}
+export interface BelongsToAccessor<TTarget extends ModelDefinition<any, any, any, any, any>> {
+    fetch(): InferModelInstance<TTarget>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: import("zod").ZodIssue[];
+}
+export interface SerializeOptions {
+    related?: string[];
+    sections?: string[];
+    computed?: string[];
+}
+export interface SaveOptions {
+    normalize?: boolean;
+    extension?: string;
+}
+/** Factory function type used to break circular dependency between model-instance and relationships */
+export type ModelInstanceFactory = (doc: import("./document.js").Document, definition: ModelDefinition<any, any, any, any, any>, collection: import("./collection.js").Collection) => any;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,mDAAmD;AACnD,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;gFAC4E;IAC5E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAEjE,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvC,sCAAsC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErC,+EAA+E;IAC/E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,2EAA2E;IAC3E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,qFAAqF;IACrF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE/C,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5C,uEAAuE;IACvE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4HAA4H;IAC5H,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gMAAgM;IAChM,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACxF;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAID;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2DAA2D;IAC3D,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,CAAC,CAAC;IAChC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CACvB;AAID,MAAM,WAAW,iBAAiB,CAChC,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG;IAE9D,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB,CAClC,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG;IAE9D,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,CAAC;CAC1C;AAED,MAAM,MAAM,sBAAsB,CAChC,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,IAC5D,iBAAiB,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE9D,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe,CAC9B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,KAAK,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,EACnC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAC/D,MAAM,EACN,KAAK,CACN,EACD,cAAc,SAAS,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CACzE,MAAM,EACN,KAAK,CACN,EACD,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,MAAM,CAC3D,MAAM,EACN,KAAK,CACN;IAED,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,SAAS,CAAC;IACpB,aAAa,EAAE,cAAc,CAAC;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,0FAA0F;IAC1F,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC9B,gEAAgE;IAChE,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,6DAA6D;IAC7D,MAAM,EAAE,KAAK,CAAC;CACf;AAID;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAC5B,IAAI,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAErD,IAAI,SAAS,eAAe,CAC1B,MAAM,MAAM,EACZ,MAAM,KAAK,EACX,MAAM,SAAS,EACf,MAAM,cAAc,EACpB,MAAM,SAAS,CAChB,GACG;IAEE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,eAAe,EAAE,QAAQ,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,iBAAiB,EAAE,UAAU,CAAC;IAG1D,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAGlC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAG9B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,EAAE,CAAC,IAAI,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,iBAAiB,CACrE,MAAM,CAAC,CACR,GACG,CAAC,GACD,KAAK;KACV,CAAC;IAGF,QAAQ,CAAC,aAAa,EAAE;SACrB,CAAC,IAAI,MAAM,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,iBAAiB,CACtE,MAAM,OAAO,CACd,GACG,eAAe,CAAC,OAAO,CAAC,GACxB,cAAc,CAAC,CAAC,CAAC,SAAS,mBAAmB,CAAC,MAAM,OAAO,CAAC,GAC1D,iBAAiB,CAAC,OAAO,CAAC,GAC1B,KAAK;KACZ,CAAC;IAGF,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,EAAE,CAAC,IAAI,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CACpD,IAAI,EAAE,GAAG,KACN,MAAM,CAAC,GACR,CAAC,GACD,KAAK;KACV,CAAC;IAGF,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAG5B,MAAM,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAG5D,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC,CAAC;IAGpB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C,GACD,KAAK,CAAC;AAEZ,MAAM,WAAW,eAAe,CAC9B,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAExD,QAAQ,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,KAAK,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IACjD,IAAI,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAChD,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB,CAChC,OAAO,SAAS,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAExD,KAAK,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uGAAuG;AACvG,MAAM,MAAM,oBAAoB,GAAG,CACjC,GAAG,EAAE,OAAO,eAAe,EAAE,QAAQ,EACrC,UAAU,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACpD,UAAU,EAAE,OAAO,iBAAiB,EAAE,UAAU,KAC7C,GAAG,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { pluralize, singularize, kebabCase, camelCase, upperFirst, } from "./inflect";
+export { stringifyAst } from "./stringify-ast";
+export { parseTable } from "./parse-table";
+export { normalizeHeadings } from "./normalize-headings";
+export { readDirectory } from "./read-directory";
+export { matchPattern, matchPatterns } from "./match-pattern";
+export { stripMarkdown } from "./strip-markdown";
+export type { StripMarkdownOptions } from "./strip-markdown";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+export { pluralize, singularize, kebabCase, camelCase, upperFirst, } from "./inflect";
+export { stringifyAst } from "./stringify-ast";
+export { parseTable } from "./parse-table";
+export { normalizeHeadings } from "./normalize-headings";
+export { readDirectory } from "./read-directory";
+export { matchPattern, matchPatterns } from "./match-pattern";
+export { stripMarkdown } from "./strip-markdown";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/inflect.d.ts

@@ -0,0 +1,6 @@
+export declare function pluralize(word: string): string;
+export declare function singularize(word: string): string;
+export declare function kebabCase(str: string): string;
+export declare function camelCase(str: string): string;
+export declare function upperFirst(str: string): string;
+//# sourceMappingURL=inflect.d.ts.map

package/dist/utils/inflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflect.d.ts","sourceRoot":"","sources":["../../src/utils/inflect.ts"],"names":[],"mappings":"AA4BA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBhD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/utils/inflect.js

@@ -0,0 +1,75 @@
+const IRREGULAR = {
+    person: "people",
+    child: "children",
+    man: "men",
+    woman: "women",
+    mouse: "mice",
+    goose: "geese",
+    ox: "oxen",
+    datum: "data",
+    index: "indices",
+    matrix: "matrices",
+    vertex: "vertices",
+};
+const UNCOUNTABLE = new Set([
+    "sheep",
+    "fish",
+    "deer",
+    "series",
+    "species",
+    "money",
+    "rice",
+    "information",
+    "equipment",
+    "media",
+    "data",
+]);
+export function pluralize(word) {
+    const lower = word.toLowerCase();
+    if (UNCOUNTABLE.has(lower))
+        return word;
+    if (IRREGULAR[lower]) {
+        return word[0] + IRREGULAR[lower].slice(1);
+    }
+    if (/s$/i.test(word))
+        return word;
+    if (/([^aeiou])y$/i.test(word))
+        return word.replace(/y$/i, "ies");
+    if (/(x|ch|ss|sh)$/i.test(word))
+        return word + "es";
+    return word + "s";
+}
+export function singularize(word) {
+    const lower = word.toLowerCase();
+    if (UNCOUNTABLE.has(lower))
+        return word;
+    const irregularEntry = Object.entries(IRREGULAR).find(([, v]) => v === lower);
+    if (irregularEntry) {
+        return word[0] + irregularEntry[0].slice(1);
+    }
+    if (word.endsWith("ies"))
+        return word.slice(0, -3) + "y";
+    if (/ses$/i.test(word) || /xes$/i.test(word) || /ches$/i.test(word) || /shes$/i.test(word)) {
+        return word.slice(0, -2);
+    }
+    if (word.endsWith("s") && !word.endsWith("ss")) {
+        return word.slice(0, -1);
+    }
+    return word;
+}
+export function kebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
+        .replace(/[\s_]+/g, "-")
+        .replace(/[^\w-]/g, "")
+        .toLowerCase();
+}
+export function camelCase(str) {
+    return str
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
+        .replace(/^[A-Z]/, (c) => c.toLowerCase());
+}
+export function upperFirst(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=inflect.js.map

package/dist/utils/inflect.js.map

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

package/dist/utils/match-pattern.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Express-style path pattern matching for extracting named parameters
+ * from document pathIds.
+ *
+ * Patterns use `:param` syntax for named segments and literal segments
+ * for exact matching. Segment counts must match exactly.
+ *
+ * Examples:
+ *   matchPattern("plans/:project/:slug", "plans/acme/launch")
+ *   // => { project: "acme", slug: "launch" }
+ *
+ *   matchPattern("plans/:project/:slug", "stories/acme/launch")
+ *   // => null (literal mismatch)
+ */
+/**
+ * Match a single pattern against a pathId.
+ * Returns extracted params on match, null on mismatch.
+ */
+export declare function matchPattern(pattern: string, pathId: string): Record<string, string> | null;
+/**
+ * Try multiple patterns against a pathId, returning the first match.
+ * Accepts a single pattern string or an array of patterns.
+ */
+export declare function matchPatterns(patterns: string | string[], pathId: string): Record<string, string> | null;
+//# sourceMappingURL=match-pattern.d.ts.map

package/dist/utils/match-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-pattern.d.ts","sourceRoot":"","sources":["../../src/utils/match-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAsB/B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAC3B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAW/B"}

package/dist/utils/match-pattern.js

@@ -0,0 +1,52 @@
+/**
+ * Express-style path pattern matching for extracting named parameters
+ * from document pathIds.
+ *
+ * Patterns use `:param` syntax for named segments and literal segments
+ * for exact matching. Segment counts must match exactly.
+ *
+ * Examples:
+ *   matchPattern("plans/:project/:slug", "plans/acme/launch")
+ *   // => { project: "acme", slug: "launch" }
+ *
+ *   matchPattern("plans/:project/:slug", "stories/acme/launch")
+ *   // => null (literal mismatch)
+ */
+/**
+ * Match a single pattern against a pathId.
+ * Returns extracted params on match, null on mismatch.
+ */
+export function matchPattern(pattern, pathId) {
+    const patternParts = pattern.split("/").filter(Boolean);
+    const pathParts = pathId.split("/").filter(Boolean);
+    if (patternParts.length !== pathParts.length) {
+        return null;
+    }
+    const params = {};
+    for (let i = 0; i < patternParts.length; i++) {
+        const pat = patternParts[i];
+        const val = pathParts[i];
+        if (pat.startsWith(":")) {
+            params[pat.slice(1)] = val;
+        }
+        else if (pat !== val) {
+            return null;
+        }
+    }
+    return params;
+}
+/**
+ * Try multiple patterns against a pathId, returning the first match.
+ * Accepts a single pattern string or an array of patterns.
+ */
+export function matchPatterns(patterns, pathId) {
+    const list = Array.isArray(patterns) ? patterns : [patterns];
+    for (const pattern of list) {
+        const result = matchPattern(pattern, pathId);
+        if (result !== null) {
+            return result;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=match-pattern.js.map

package/dist/utils/match-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-pattern.js","sourceRoot":"","sources":["../../src/utils/match-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,MAAc;IAEd,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEpD,IAAI,YAAY,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;QAE1B,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAC7B,CAAC;aAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA2B,EAC3B,MAAc;IAEd,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE7D,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/normalize-headings.d.ts

@@ -0,0 +1,8 @@
+import type { Root } from "mdast";
+/**
+ * Normalize heading depths so the minimum heading is depth 1.
+ * If the shallowest heading is h2, all headings are shifted up by 1.
+ * Mutates the AST in place and returns it.
+ */
+export declare function normalizeHeadings(ast: Root): Root;
+//# sourceMappingURL=normalize-headings.d.ts.map

package/dist/utils/normalize-headings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-headings.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-headings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAW,MAAM,OAAO,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAuBjD"}

package/dist/utils/normalize-headings.js

@@ -0,0 +1,19 @@
+/**
+ * Normalize heading depths so the minimum heading is depth 1.
+ * If the shallowest heading is h2, all headings are shifted up by 1.
+ * Mutates the AST in place and returns it.
+ */
+export function normalizeHeadings(ast) {
+    const headings = ast.children.filter((n) => n.type === "heading");
+    if (headings.length === 0)
+        return ast;
+    const minDepth = Math.min(...headings.map((h) => h.depth));
+    const diff = 1 - minDepth;
+    if (diff !== 0) {
+        for (const heading of headings) {
+            heading.depth = Math.max(1, Math.min(6, heading.depth + diff));
+        }
+    }
+    return ast;
+}
+//# sourceMappingURL=normalize-headings.js.map

package/dist/utils/normalize-headings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-headings.js","sourceRoot":"","sources":["../../src/utils/normalize-headings.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAS;IACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAClC,CAAC,CAAC,EAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAC1C,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC;IAE1B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAMxD,CAAC;QACR,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/parse-table.d.ts

@@ -0,0 +1,7 @@
+import type { Content } from "mdast";
+/**
+ * Parse a markdown table AST node into an array of row objects.
+ * Each row is an object whose keys are the column header texts.
+ */
+export declare function parseTable(tableNode: Content): Record<string, string>[];
+//# sourceMappingURL=parse-table.d.ts.map

package/dist/utils/parse-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-table.d.ts","sourceRoot":"","sources":["../../src/utils/parse-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC;;;GAGG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,OAAO,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAoB1B"}

package/dist/utils/parse-table.js

@@ -0,0 +1,17 @@
+import { toString } from "mdast-util-to-string";
+/**
+ * Parse a markdown table AST node into an array of row objects.
+ * Each row is an object whose keys are the column header texts.
+ */
+export function parseTable(tableNode) {
+    const rows = tableNode.children?.filter((n) => n.type === "tableRow");
+    if (!rows || rows.length < 2)
+        return [];
+    const [headingsRow, ...dataRows] = rows;
+    const headings = headingsRow.children.map((c) => toString(c));
+    return dataRows.map((row) => Object.fromEntries(row.children.map((cell, index) => [
+        headings[index] ?? `col${index}`,
+        toString(cell),
+    ])));
+}
+//# sourceMappingURL=parse-table.js.map

package/dist/utils/parse-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-table.js","sourceRoot":"","sources":["../../src/utils/parse-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,SAAkB;IAElB,MAAM,IAAI,GAAI,SAAiB,CAAC,QAAQ,EAAE,MAAM,CAC9C,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAClC,CAAC;IAEF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC;IACxC,MAAM,QAAQ,GAAa,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAC7D,QAAQ,CAAC,CAAC,CAAC,CACZ,CAAC;IAEF,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAC/B,MAAM,CAAC,WAAW,CAChB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,KAAa,EAAE,EAAE,CAAC;QAC7C,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,KAAK,EAAE;QAChC,QAAQ,CAAC,IAAI,CAAC;KACf,CAAC,CACH,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/read-directory.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Recursively read a directory and return file paths matching a regex.
+ */
+export declare function readDirectory(dirPath: string, match?: RegExp, recursive?: boolean): Promise<string[]>;
+//# sourceMappingURL=read-directory.d.ts.map

package/dist/utils/read-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-directory.d.ts","sourceRoot":"","sources":["../../src/utils/read-directory.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAmB,EAC1B,SAAS,GAAE,OAAc,GACxB,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBnB"}

package/dist/utils/read-directory.js

@@ -0,0 +1,29 @@
+import fs from "fs/promises";
+import path from "path";
+/**
+ * Recursively read a directory and return file paths matching a regex.
+ */
+export async function readDirectory(dirPath, match = /\.mdx?$/i, recursive = true) {
+    let paths = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dirPath);
+    }
+    catch {
+        return paths;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith("."))
+            continue;
+        const filePath = path.join(dirPath, entry);
+        const stat = await fs.stat(filePath);
+        if (stat.isDirectory() && recursive) {
+            paths = paths.concat(await readDirectory(filePath, match, recursive));
+        }
+        else if (stat.isFile() && match.test(filePath)) {
+            paths.push(filePath);
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=read-directory.js.map

package/dist/utils/read-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-directory.js","sourceRoot":"","sources":["../../src/utils/read-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,QAAgB,UAAU,EAC1B,YAAqB,IAAI;IAEzB,IAAI,KAAK,GAAa,EAAE,CAAC;IAEzB,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAErC,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,SAAS,EAAE,CAAC;YACpC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QACxE,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/stringify-ast.d.ts

@@ -0,0 +1,6 @@
+import type { Root } from "mdast";
+/**
+ * Convert an MDAST tree back to a markdown string.
+ */
+export declare function stringifyAst(ast: Root): string;
+//# sourceMappingURL=stringify-ast.d.ts.map

package/dist/utils/stringify-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-ast.d.ts","sourceRoot":"","sources":["../../src/utils/stringify-ast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAE9C"}

package/dist/utils/stringify-ast.js

@@ -0,0 +1,8 @@
+import { toMarkdown } from "mdast-util-to-markdown";
+/**
+ * Convert an MDAST tree back to a markdown string.
+ */
+export function stringifyAst(ast) {
+    return toMarkdown(ast);
+}
+//# sourceMappingURL=stringify-ast.js.map

package/dist/utils/stringify-ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-ast.js","sourceRoot":"","sources":["../../src/utils/stringify-ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAS;IACpC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/strip-markdown.d.ts

@@ -0,0 +1,11 @@
+import type { Root } from "mdast";
+export interface StripMarkdownOptions {
+    preserveLists?: boolean;
+}
+/**
+ * Strip markdown syntax from an MDAST, returning plain text.
+ * Headings, paragraphs, code blocks, blockquotes, etc. become plain text.
+ * With preserveLists: true, list items retain their bullet/number formatting.
+ */
+export declare function stripMarkdown(ast: Root, options?: StripMarkdownOptions): string;
+//# sourceMappingURL=strip-markdown.d.ts.map

package/dist/utils/strip-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-markdown.d.ts","sourceRoot":"","sources":["../../src/utils/strip-markdown.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAqB,MAAM,OAAO,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,IAAI,EACT,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAYR"}

package/dist/utils/strip-markdown.js

@@ -0,0 +1,48 @@
+import { toString } from "mdast-util-to-string";
+/**
+ * Strip markdown syntax from an MDAST, returning plain text.
+ * Headings, paragraphs, code blocks, blockquotes, etc. become plain text.
+ * With preserveLists: true, list items retain their bullet/number formatting.
+ */
+export function stripMarkdown(ast, options = {}) {
+    const { preserveLists = false } = options;
+    return ast.children
+        .map((node) => {
+        if (preserveLists && (node.type === "list")) {
+            return renderList(node, 0).trimEnd();
+        }
+        return toString(node);
+    })
+        .filter(Boolean)
+        .join("\n\n");
+}
+function renderList(list, depth) {
+    const indent = "  ".repeat(depth);
+    let index = list.start ?? 1;
+    return list.children
+        .map((item) => {
+        const bullet = list.ordered ? `${index++}.` : "-";
+        const lines = [];
+        let firstContent = true;
+        for (const child of item.children) {
+            if (child.type === "list") {
+                lines.push(renderList(child, depth + 1));
+            }
+            else {
+                const text = toString(child);
+                if (!text)
+                    continue;
+                if (firstContent) {
+                    lines.push(`${indent}${bullet} ${text}`);
+                    firstContent = false;
+                }
+                else {
+                    lines.push(`${indent}  ${text}`);
+                }
+            }
+        }
+        return lines.join("\n");
+    })
+        .join("\n");
+}
+//# sourceMappingURL=strip-markdown.js.map

package/dist/utils/strip-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-markdown.js","sourceRoot":"","sources":["../../src/utils/strip-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAQhD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAS,EACT,UAAgC,EAAE;IAElC,MAAM,EAAE,aAAa,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE1C,OAAO,GAAG,CAAC,QAAQ;SAChB,GAAG,CAAC,CAAC,IAAiB,EAAE,EAAE;QACzB,IAAI,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;YAC5C,OAAO,UAAU,CAAC,IAAY,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,IAAU,EAAE,KAAa;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAE5B,OAAO,IAAI,CAAC,QAAQ;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,YAAY,GAAG,IAAI,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,IAAI,YAAY,EAAE,CAAC;oBACjB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;oBACzC,YAAY,GAAG,KAAK,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}