mdzilla 0.0.0 → 0.0.2

package/dist/index.d.mts

@@ -0,0 +1,161 @@
+//#region src/docs/nav.d.ts
+interface NavEntry {
+  /** URL-friendly path segment (without numeric prefix) */
+  slug: string;
+  /** Full resolved URL path from docs root */
+  path: string;
+  /** Display title (from frontmatter → first heading → humanized slug) */
+  title: string;
+  /** Original numeric prefix used for ordering */
+  order: number;
+  /** Icon from frontmatter, navigation override, or .navigation.yml */
+  icon?: string;
+  /** Description from frontmatter or navigation override */
+  description?: string;
+  /** `false` when directory has no index page (non-clickable group) */
+  page?: false;
+  /** Nested children (for directories) */
+  children?: NavEntry[];
+  /** Arbitrary extra frontmatter/meta fields */
+  [key: string]: unknown;
+}
+//#endregion
+//#region src/docs/sources/_base.d.ts
+declare abstract class DocsSource {
+  abstract load(): Promise<{
+    tree: NavEntry[];
+    fileMap: Map<string, string>;
+  }>;
+  abstract readContent(filePath: string): Promise<string>;
+}
+//#endregion
+//#region src/docs/sources/fs.d.ts
+declare class DocsSourceFS extends DocsSource {
+  dir: string;
+  constructor(dir: string);
+  load(): Promise<{
+    tree: NavEntry[];
+    fileMap: Map<string, string>;
+  }>;
+  readContent(filePath: string): Promise<string>;
+}
+//#endregion
+//#region src/docs/sources/git.d.ts
+interface DocsSourceGitOptions {
+  /** Authorization token for private repos */
+  auth?: string;
+  /** Subdirectory within the repo containing docs */
+  subdir?: string;
+}
+declare class DocsSourceGit extends DocsSource {
+  src: string;
+  options: DocsSourceGitOptions;
+  private _fs?;
+  constructor(src: string, options?: DocsSourceGitOptions);
+  load(): Promise<{
+    tree: NavEntry[];
+    fileMap: Map<string, string>;
+  }>;
+  readContent(filePath: string): Promise<string>;
+}
+//#endregion
+//#region src/docs/sources/http.d.ts
+interface DocsSourceHTTPOptions {
+  /** Additional headers to send with each request */
+  headers?: Record<string, string>;
+}
+declare class DocsSourceHTTP extends DocsSource {
+  url: string;
+  options: DocsSourceHTTPOptions;
+  private _contentCache;
+  private _tree;
+  private _fileMap;
+  private _npmPackage?;
+  constructor(url: string, options?: DocsSourceHTTPOptions);
+  load(): Promise<{
+    tree: NavEntry[];
+    fileMap: Map<string, string>;
+  }>;
+  /** Try fetching /llms.txt and parse it into a nav tree */
+  private _tryLlmsTxt;
+  readContent(filePath: string): Promise<string>;
+  /** Crawl index.md pages and attach their links as children */
+  private _crawlTocPages;
+  /** Load an npm package README from the registry */
+  private _loadNpm;
+  private _fetch;
+}
+//#endregion
+//#region src/docs/sources/npm.d.ts
+interface DocsSourceNpmOptions {
+  /** Subdirectory within the package containing docs */
+  subdir?: string;
+}
+declare class DocsSourceNpm extends DocsSource {
+  src: string;
+  options: DocsSourceNpmOptions;
+  private _fs?;
+  constructor(src: string, options?: DocsSourceNpmOptions);
+  load(): Promise<{
+    tree: NavEntry[];
+    fileMap: Map<string, string>;
+  }>;
+  readContent(filePath: string): Promise<string>;
+}
+//#endregion
+//#region src/docs/manager.d.ts
+interface FlatEntry {
+  entry: NavEntry;
+  depth: number;
+  filePath?: string;
+}
+declare class DocsManager {
+  source: DocsSource;
+  tree: NavEntry[];
+  flat: FlatEntry[];
+  private _fileMap;
+  private _contentCache;
+  constructor(source: DocsSource);
+  load(): Promise<void>;
+  reload(): Promise<void>;
+  /** Get raw file content for a flat entry (cached). */
+  getContent(entry: FlatEntry): Promise<string | undefined>;
+  /** Invalidate cached content for a specific file path. */
+  invalidate(filePath: string): void;
+  /** Fuzzy filter flat entries by query string. */
+  filter(query: string): FlatEntry[];
+  /** Flat entries that are navigable pages (excludes directory stubs). */
+  get pages(): FlatEntry[];
+  /** Find a flat entry by path (exact or with trailing slash). */
+  findByPath(path: string): FlatEntry | undefined;
+  /**
+   * Resolve a page path to its content, trying:
+   * 1. Exact match in the navigation tree
+   * 2. Stripped common prefix (e.g., /docs/guide/... → /guide/...)
+   * 3. Direct source fetch (for HTTP sources with uncrawled paths)
+   */
+  resolvePage(path: string): Promise<{
+    entry?: FlatEntry;
+    raw?: string;
+  }>;
+  /** Return indices of matching flat entries (case-insensitive substring). */
+  matchIndices(query: string): number[];
+}
+//#endregion
+//#region src/docs/exporter.d.ts
+interface ExportOptions {
+  /** Include entries where page === false (directory stubs). Default: false */
+  includeStubs?: boolean;
+  /** Compile markdown to plain text using md4x. Default: false */
+  plainText?: boolean;
+}
+declare abstract class DocsExporter {
+  abstract export(manager: DocsManager, options?: ExportOptions): Promise<void>;
+}
+declare class DocsExporterFS extends DocsExporter {
+  dir: string;
+  constructor(dir: string);
+  export(manager: DocsManager, options?: ExportOptions): Promise<void>;
+}
+//#endregion
+export { DocsExporter, DocsExporterFS, DocsManager, DocsSource, DocsSourceFS, DocsSourceGit, type DocsSourceGitOptions, DocsSourceHTTP, type DocsSourceHTTPOptions, DocsSourceNpm, type DocsSourceNpmOptions, type ExportOptions, type FlatEntry, type NavEntry };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as DocsSourceGit, c as DocsManager, i as DocsSourceHTTP, n as DocsExporterFS, o as DocsSourceFS, r as DocsSourceNpm, s as DocsSource, t as DocsExporter } from "./_chunks/exporter.mjs";
+export { DocsExporter, DocsExporterFS, DocsManager, DocsSource, DocsSourceFS, DocsSourceGit, DocsSourceHTTP, DocsSourceNpm };

package/package.json

@@ -1 +1,52 @@
-{"name":"mdzilla","version":"0.0.0"}
+{
+  "name": "mdzilla",
+  "version": "0.0.2",
+  "description": "",
+  "license": "MIT",
+  "repository": "pi0/mdzilla",
+  "bin": {
+    "mdz": "./dist/cli/main.mjs",
+    "mdzilla": "./dist/cli/main.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": "./dist/index.mjs"
+  },
+  "scripts": {
+    "build": "obuild",
+    "dev": "vitest dev",
+    "fmt": "automd && oxlint . --fix && oxfmt .",
+    "lint": "oxlint . && oxfmt --check .",
+    "prepack": "pnpm build",
+    "mdzilla": "node src/cli/main.ts",
+    "mdz": "node src/cli/main.ts",
+    "release": "pnpm test && pnpm build && changelogen --release && npm publish && git push --follow-tags",
+    "test": "pnpm lint && pnpm typecheck && vitest run --coverage",
+    "typecheck": "tsgo --noEmit --skipLibCheck"
+  },
+  "dependencies": {
+    "@speed-highlight/core": "^1.2.14",
+    "giget": "^3.1.2",
+    "md4x": ">=0.0.21",
+    "mdream": "^0.16.0",
+    "std-env": "4.0.0-rc.1"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "@typescript/native-preview": "latest",
+    "@vitest/coverage-v8": "latest",
+    "automd": "latest",
+    "changelogen": "latest",
+    "obuild": "latest",
+    "oxfmt": "latest",
+    "oxlint": "latest",
+    "typescript": "latest",
+    "vitest": "latest"
+  },
+  "packageManager": "pnpm@10.29.3"
+}