@vibesdotdev/docs 0.0.0-stage → 1.0.0-rc.2

package/dist/prompts/descriptors/vibes-platform.prompt.descriptor.d.ts

@@ -0,0 +1,113 @@
+export declare const vibesPlatformPromptDescriptor: {
+    id: string;
+    kind: "prompts/manifest";
+    owner: string;
+    manifest: {
+        id: string;
+        version: string;
+        name: string;
+        description: string;
+        type: "system" | "workflow" | "specialist" | "tool" | "extraction";
+        tags: string[];
+        scope: "user" | "shared" | "builtin" | "project";
+        isPublic: boolean;
+        content: string;
+        generator: "static" | "template" | "dynamic";
+        category?: "custom" | "generation" | "extraction" | "development" | "knowledge" | "chat" | "analysis" | "validation" | undefined;
+        ownerId?: string | undefined;
+        projectId?: string | undefined;
+        sections?: {
+            key: string;
+            title: string;
+            content: string;
+            order: number;
+            collapsible: boolean;
+            conditional?: string | undefined;
+        }[] | undefined;
+        contentPath?: string | undefined;
+        tools?: string[] | undefined;
+        contextRequired?: string[] | undefined;
+        modelConfig?: {
+            model?: string | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            topP?: number | undefined;
+            stopSequences?: string[] | undefined;
+        } | undefined;
+        knowledgeBaseIds?: string[] | undefined;
+        dependencies?: string[] | undefined;
+        composedWith?: string[] | undefined;
+        inject?: "tools"[] | undefined;
+        arguments?: {
+            name: string;
+            description: string;
+            type: "string" | "number" | "boolean" | "file" | "select" | "multiselect" | "text" | "json";
+            required: boolean;
+            default?: unknown;
+            options?: {
+                label: string;
+                value: string;
+                description?: string | undefined;
+            }[] | undefined;
+            validation?: string | undefined;
+            placeholder?: string | undefined;
+        }[] | undefined;
+        templateEngine?: "handlebars" | "mustache" | "native" | undefined;
+        transform?: {
+            inputSchema?: Record<string, unknown> | undefined;
+            transformPath?: string | undefined;
+            transformSpread?: {
+                spreadFrom?: ("data" | "user" | "project" | "session")[] | undefined;
+                assigns?: Record<string, {
+                    literal: import("@vibesdotdev/kernel/bootstrap").JsonValue;
+                } | {
+                    path: string;
+                }> | undefined;
+            } | undefined;
+        } | undefined;
+        versions?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        }[] | undefined;
+        currentVersion?: {
+            version: string;
+            createdAt: string;
+            changelog?: string | undefined;
+            parentVersion?: string | undefined;
+            author?: string | undefined;
+        } | undefined;
+        metadata?: {
+            author?: string | undefined;
+            license?: string | undefined;
+            source?: string | undefined;
+            related?: string[] | undefined;
+            custom?: Record<string, unknown> | undefined;
+        } | undefined;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+    };
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+export default vibesPlatformPromptDescriptor;
+//# sourceMappingURL=vibes-platform.prompt.descriptor.d.ts.map

package/dist/prompts/descriptors/vibes-platform.prompt.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-platform.prompt.descriptor.d.ts","sourceRoot":"","sources":["../../../src/prompts/descriptors/vibes-platform.prompt.descriptor.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BiI,CAAC;AAE5K,eAAe,6BAA6B,CAAC"}

package/dist/prompts/descriptors/vibes-platform.prompt.descriptor.js

@@ -0,0 +1,35 @@
+import { definePromptManifestDescriptor } from '@vibesdotdev/ai-schemas';
+export const vibesPlatformPromptDescriptor = definePromptManifestDescriptor({
+    id: 'vibes.platform-context',
+    name: 'Vibes Platform Context',
+    description: 'Foundational prompt informing agents about the Vibes platform architecture, repository-collection packages, and the docs search companion tool.',
+    tags: ['platform', 'docs', 'context', 'foundational'],
+    type: 'system',
+    scope: 'builtin',
+    content: `## Vibes Platform & Architecture Context
+
+You are operating within the Vibes platform, a cutting-edge synthetic intelligence workspace designed to close the gap between biological and synthetic consciousness.
+
+### 1. Repository Collection Organization
+The codebase is structured as a unified repository-collection divided into three principal directories:
+- **apps/**: Independent web applications and services.
+  - \`chat-web\`: The premium multi-user and multi-agent chat interface.
+  - \`ai-web\`: Agent lifecycle orchestration, model routing, and evaluation playground.
+  - \`knowledge-web\`: Semantically-indexed ingestion pipelines and personal databases.
+  - \`docs\`: The central static documentation hub (accessible at docs.vibes.dev).
+- ****: Shared feature-scoped modules.
+  - \`docs\`: Core documentation runtime engine, directives parser, and search client.
+  - \`tools\`: Unified execution plugin for MCP, CLI, and agent workers.
+  - \`ai\`: Cost routing, model provider integrations, and embeddings.
+  - \`runtime\`: Micro-kernel coordinating kinds, loader specifications, and dynamic registry.
+- **libraries/**: Common helper suites.
+  - \`vibeskit\` (\`@vibesdotdev/kit\`): Design system, UI primitives, and code/chat/OpenAPI components.
+
+### 2. Using the Docs Companion Tool
+You have been equipped with the powerful \`docs\` tool to explore platform documentation dynamically. The documentation is composed of modular fragments (known as \`docs/topic\` descriptors) contributed by individual packages.
+- Always use the \`docs\` tool with \`action: "search"\` to find topics, or \`action: "list"\` to explore topics when requested or if you lack context about a Vibes package or app.
+- Use \`action: "read"\` with the \`topicId\` to fetch the full detailed markdown instructions, usage examples, and specifications of a topic.
+- Avoid guessing or inventing details about the Vibes repository-collection architecture. Use your \`docs\` companion tool to verify platform truth.`
+}, { owner: 'docs' });
+export default vibesPlatformPromptDescriptor;
+//# sourceMappingURL=vibes-platform.prompt.descriptor.js.map

package/dist/prompts/descriptors/vibes-platform.prompt.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-platform.prompt.descriptor.js","sourceRoot":"","sources":["../../../src/prompts/descriptors/vibes-platform.prompt.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAEzE,MAAM,CAAC,MAAM,6BAA6B,GAAG,8BAA8B,CAAC;IAC3E,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,iJAAiJ;IAC9J,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC;IACrD,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;qJAuB2I;CAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAE5K,eAAe,6BAA6B,CAAC"}

package/dist/render/ansi.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Tiny ANSI helper — raw escape codes (matches `cli/src/commands/completion/completion.impl.ts`
+ * convention; no chalk/kleur dependency).
+ *
+ * Honors the no-color contract at call time without loading TUI theme:
+ * `NO_COLOR` / `VIBES_NO_COLOR` / `TERM=dumb` suppress escapes so `vibes docs`
+ * directive renderers emit none. Commander `--no-color` is still applied by
+ * the `docs.show` command on top of this (it also covers escapes that arrive
+ * inside topic bodies).
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+/** Env slice the wrappers read; build it with `readAnsiEnv(runtime)`. */
+export type AnsiColorEnv = {
+    NO_COLOR?: string;
+    VIBES_NO_COLOR?: string;
+    TERM?: string;
+};
+/** Local no-color check; do not import TUI theme. */
+export declare function isNoColorActive(env?: AnsiColorEnv): boolean;
+/** The no-color env slice of `runtime` (the handed runtime, never an ambient one). */
+export declare function readAnsiEnv(runtime: Pick<VibesRuntime, 'getEnv'>): AnsiColorEnv;
+/** True when color escapes should be emitted for `env`. */
+export declare function ansiColorEnabled(env: AnsiColorEnv): boolean;
+declare const CODES: {
+    readonly bold: "1";
+    readonly dim: "2";
+    readonly italic: "3";
+    readonly underline: "4";
+    readonly black: "30";
+    readonly red: "31";
+    readonly green: "32";
+    readonly yellow: "33";
+    readonly blue: "34";
+    readonly magenta: "35";
+    readonly cyan: "36";
+    readonly white: "37";
+    readonly gray: "90";
+    readonly brightRed: "91";
+    readonly brightGreen: "92";
+    readonly brightYellow: "93";
+    readonly brightBlue: "94";
+    readonly brightMagenta: "95";
+    readonly brightCyan: "96";
+};
+type AnsiStyle = keyof typeof CODES;
+/** Painters that take the env per call. */
+export declare const ansi: {
+    bold: (text: string, env: AnsiColorEnv) => string;
+    dim: (text: string, env: AnsiColorEnv) => string;
+    italic: (text: string, env: AnsiColorEnv) => string;
+    underline: (text: string, env: AnsiColorEnv) => string;
+    black: (text: string, env: AnsiColorEnv) => string;
+    red: (text: string, env: AnsiColorEnv) => string;
+    green: (text: string, env: AnsiColorEnv) => string;
+    yellow: (text: string, env: AnsiColorEnv) => string;
+    blue: (text: string, env: AnsiColorEnv) => string;
+    magenta: (text: string, env: AnsiColorEnv) => string;
+    cyan: (text: string, env: AnsiColorEnv) => string;
+    white: (text: string, env: AnsiColorEnv) => string;
+    gray: (text: string, env: AnsiColorEnv) => string;
+    brightRed: (text: string, env: AnsiColorEnv) => string;
+    brightGreen: (text: string, env: AnsiColorEnv) => string;
+    brightYellow: (text: string, env: AnsiColorEnv) => string;
+    brightBlue: (text: string, env: AnsiColorEnv) => string;
+    brightMagenta: (text: string, env: AnsiColorEnv) => string;
+    brightCyan: (text: string, env: AnsiColorEnv) => string;
+};
+/** Reset code for `env`, or '' when no-color is active so hand-built strings stay clean. */
+export declare function ansiReset(env: AnsiColorEnv): string;
+/** Painters bound to one env slice. */
+export type BoundAnsi = {
+    [K in AnsiStyle]: (text: string) => string;
+} & {
+    readonly reset: string;
+};
+/** Bind every painter to `env` so renderers do not thread it per call. */
+export declare function createAnsi(env: AnsiColorEnv): BoundAnsi;
+/**
+ * Strip ANSI escape sequences from a string. Used for length calculations
+ * (envelope alignment, box widths) and for test assertions.
+ */
+export declare function stripAnsi(text: string): string;
+/** Visual width of `text` with ANSI escapes removed. */
+export declare function visibleLength(text: string): number;
+export {};
+//# sourceMappingURL=ansi.d.ts.map

package/dist/render/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/render/ansi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAaF,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,GAAG,GAAE,YAAiB,GAAG,OAAO,CAE/D;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,YAAY,CAM/E;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAE3D;AAED,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;CAoBD,CAAC;AAEX,KAAK,SAAS,GAAG,MAAM,OAAO,KAAK,CAAC;AAOpC,2CAA2C;AAC3C,eAAO,MAAM,IAAI;iBALF,MAAM,OAAO,YAAY,KAAG,MAAM;gBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;mBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;sBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;kBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;gBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;kBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;mBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;iBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;oBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;iBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;kBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;iBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;sBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;wBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;yBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;uBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;0BAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;uBAAlC,MAAM,OAAO,YAAY,KAAG,MAAM;CAyByB,CAAC;AAE3E,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAEnD;AAED,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG;KAAG,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,CAuBvD;AAID;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/render/ansi.js

@@ -0,0 +1,125 @@
+/**
+ * Tiny ANSI helper — raw escape codes (matches `cli/src/commands/completion/completion.impl.ts`
+ * convention; no chalk/kleur dependency).
+ *
+ * Honors the no-color contract at call time without loading TUI theme:
+ * `NO_COLOR` / `VIBES_NO_COLOR` / `TERM=dumb` suppress escapes so `vibes docs`
+ * directive renderers emit none. Commander `--no-color` is still applied by
+ * the `docs.show` command on top of this (it also covers escapes that arrive
+ * inside topic bodies).
+ */
+const ESC = '\x1b[';
+const RESET = `${ESC}0m`;
+function isTruthyEnv(value) {
+    if (!value)
+        return false;
+    const normalized = value.toLowerCase();
+    return (normalized !== '0' &&
+        normalized !== 'false' &&
+        normalized !== 'no' &&
+        normalized !== 'off');
+}
+/** Local no-color check; do not import TUI theme. */
+export function isNoColorActive(env = {}) {
+    return isTruthyEnv(env.NO_COLOR) || isTruthyEnv(env.VIBES_NO_COLOR) || env.TERM === 'dumb';
+}
+/** The no-color env slice of `runtime` (the handed runtime, never an ambient one). */
+export function readAnsiEnv(runtime) {
+    return {
+        NO_COLOR: runtime.getEnv('NO_COLOR'),
+        VIBES_NO_COLOR: runtime.getEnv('VIBES_NO_COLOR'),
+        TERM: runtime.getEnv('TERM')
+    };
+}
+/** True when color escapes should be emitted for `env`. */
+export function ansiColorEnabled(env) {
+    return !isNoColorActive(env);
+}
+const CODES = {
+    bold: '1',
+    dim: '2',
+    italic: '3',
+    underline: '4',
+    black: '30',
+    red: '31',
+    green: '32',
+    yellow: '33',
+    blue: '34',
+    magenta: '35',
+    cyan: '36',
+    white: '37',
+    gray: '90',
+    brightRed: '91',
+    brightGreen: '92',
+    brightYellow: '93',
+    brightBlue: '94',
+    brightMagenta: '95',
+    brightCyan: '96'
+};
+function wrap(code) {
+    return (text, env) => ansiColorEnabled(env) ? `${ESC}${code}m${text}${RESET}` : text;
+}
+/** Painters that take the env per call. */
+export const ansi = {
+    bold: wrap(CODES.bold),
+    dim: wrap(CODES.dim),
+    italic: wrap(CODES.italic),
+    underline: wrap(CODES.underline),
+    black: wrap(CODES.black),
+    red: wrap(CODES.red),
+    green: wrap(CODES.green),
+    yellow: wrap(CODES.yellow),
+    blue: wrap(CODES.blue),
+    magenta: wrap(CODES.magenta),
+    cyan: wrap(CODES.cyan),
+    white: wrap(CODES.white),
+    gray: wrap(CODES.gray),
+    brightRed: wrap(CODES.brightRed),
+    brightGreen: wrap(CODES.brightGreen),
+    brightYellow: wrap(CODES.brightYellow),
+    brightBlue: wrap(CODES.brightBlue),
+    brightMagenta: wrap(CODES.brightMagenta),
+    brightCyan: wrap(CODES.brightCyan)
+};
+/** Reset code for `env`, or '' when no-color is active so hand-built strings stay clean. */
+export function ansiReset(env) {
+    return ansiColorEnabled(env) ? RESET : '';
+}
+/** Bind every painter to `env` so renderers do not thread it per call. */
+export function createAnsi(env) {
+    return {
+        bold: (text) => ansi.bold(text, env),
+        dim: (text) => ansi.dim(text, env),
+        italic: (text) => ansi.italic(text, env),
+        underline: (text) => ansi.underline(text, env),
+        black: (text) => ansi.black(text, env),
+        red: (text) => ansi.red(text, env),
+        green: (text) => ansi.green(text, env),
+        yellow: (text) => ansi.yellow(text, env),
+        blue: (text) => ansi.blue(text, env),
+        magenta: (text) => ansi.magenta(text, env),
+        cyan: (text) => ansi.cyan(text, env),
+        white: (text) => ansi.white(text, env),
+        gray: (text) => ansi.gray(text, env),
+        brightRed: (text) => ansi.brightRed(text, env),
+        brightGreen: (text) => ansi.brightGreen(text, env),
+        brightYellow: (text) => ansi.brightYellow(text, env),
+        brightBlue: (text) => ansi.brightBlue(text, env),
+        brightMagenta: (text) => ansi.brightMagenta(text, env),
+        brightCyan: (text) => ansi.brightCyan(text, env),
+        reset: ansiReset(env)
+    };
+}
+const ANSI_STRIP_REGEX = new RegExp(`${String.fromCharCode(0x1b)}\\[[0-9;]*m`, 'g');
+/**
+ * Strip ANSI escape sequences from a string. Used for length calculations
+ * (envelope alignment, box widths) and for test assertions.
+ */
+export function stripAnsi(text) {
+    return text.replace(ANSI_STRIP_REGEX, '');
+}
+/** Visual width of `text` with ANSI escapes removed. */
+export function visibleLength(text) {
+    return stripAnsi(text).length;
+}
+//# sourceMappingURL=ansi.js.map

package/dist/render/ansi.js.map

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

package/dist/render/frontmatter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Lifted from `app/src/documentation/markdown.ts` per Tier 1 plan.
+ * `app` re-exports from here for compat (see Tier 1 §"DRAFT" steps).
+ *
+ * Plain key/value YAML-lite frontmatter parser. Arrays delimited with `[…]`,
+ * booleans/numbers auto-detected, strings stripped of surrounding quotes.
+ */
+export type FrontmatterValue = string | number | boolean | string[];
+export interface ParsedFrontmatter {
+    frontmatter: Record<string, FrontmatterValue>;
+    content: string;
+}
+export interface TableOfContentsEntry {
+    level: number;
+    text: string;
+    slug: string;
+}
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+export declare function extractTableOfContents(content: string): TableOfContentsEntry[];
+export declare function markdownHeadingSlug(text: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/render/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/render/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAoCnE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAa9E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/render/frontmatter.js

@@ -0,0 +1,57 @@
+/**
+ * Lifted from `app/src/documentation/markdown.ts` per Tier 1 plan.
+ * `app` re-exports from here for compat (see Tier 1 §"DRAFT" steps).
+ *
+ * Plain key/value YAML-lite frontmatter parser. Arrays delimited with `[…]`,
+ * booleans/numbers auto-detected, strings stripped of surrounding quotes.
+ */
+export function parseFrontmatter(content) {
+    const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/;
+    const match = content.match(frontmatterRegex);
+    if (!match) {
+        return { frontmatter: {}, content };
+    }
+    const frontmatterText = match[1];
+    const mainContent = match[2];
+    const frontmatter = {};
+    const lines = frontmatterText.split('\n');
+    for (const line of lines) {
+        const colonIndex = line.indexOf(':');
+        if (colonIndex > 0) {
+            const key = line.substring(0, colonIndex).trim();
+            const value = line.substring(colonIndex + 1).trim();
+            if (value.startsWith('[') && value.endsWith(']')) {
+                frontmatter[key] = value
+                    .substring(1, value.length - 1)
+                    .split(',')
+                    .map((item) => item.trim().replace(/['"]/g, ''));
+            }
+            else if (value === 'true' || value === 'false') {
+                frontmatter[key] = value === 'true';
+            }
+            else if (!isNaN(Number(value)) && value !== '') {
+                frontmatter[key] = Number(value);
+            }
+            else {
+                frontmatter[key] = value.replace(/['"]/g, '');
+            }
+        }
+    }
+    return { frontmatter, content: mainContent };
+}
+export function extractTableOfContents(content) {
+    const headingRegex = /^(#{1,6})\s+(.+)$/gm;
+    const toc = [];
+    let match;
+    while ((match = headingRegex.exec(content)) !== null) {
+        const level = match[1].length;
+        const text = match[2];
+        const slug = markdownHeadingSlug(text);
+        toc.push({ level, text, slug });
+    }
+    return toc;
+}
+export function markdownHeadingSlug(text) {
+    return text.toLowerCase().replace(/[^\w]+/g, '-');
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/render/frontmatter.js.map

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

package/dist/render/index.d.ts

@@ -0,0 +1,10 @@
+export { parseFrontmatter, extractTableOfContents } from './frontmatter.ts';
+export type { FrontmatterValue, ParsedFrontmatter, TableOfContentsEntry } from './frontmatter.ts';
+export { createMarked, parseMarkdown, tokenToDirectiveNode } from './parse.ts';
+export { selectMarkdownSection } from './sections.ts';
+export type { ParsedTopic } from './parse.ts';
+export { renderTopicToTerminal } from './terminal.ts';
+export type { RenderTopicOptions } from './terminal.ts';
+export { ansi, ansiReset, createAnsi, readAnsiEnv, stripAnsi, visibleLength } from './ansi.ts';
+export type { AnsiColorEnv, BoundAnsi } from './ansi.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/render/index.js

@@ -0,0 +1,6 @@
+export { parseFrontmatter, extractTableOfContents } from "./frontmatter.js";
+export { createMarked, parseMarkdown, tokenToDirectiveNode } from "./parse.js";
+export { selectMarkdownSection } from "./sections.js";
+export { renderTopicToTerminal } from "./terminal.js";
+export { ansi, ansiReset, createAnsi, readAnsiEnv, stripAnsi, visibleLength } from "./ansi.js";
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/render/parse.d.ts

@@ -0,0 +1,29 @@
+import { Marked } from 'marked';
+import { type FrontmatterValue } from './frontmatter.ts';
+import type { DirectiveNode } from '../directives/types.ts';
+export interface ParsedTopic {
+    frontmatter: Record<string, FrontmatterValue>;
+    tokens: ReturnType<Marked['lexer']>;
+}
+/**
+ * Build a configured `marked` instance with the directive extension installed.
+ * Exposed so consumers (terminal renderer, future web renderer) can share the
+ * same lexer.
+ */
+export declare function createMarked(): Marked;
+/**
+ * Parse a topic body — strips frontmatter and lexes to a token tree.
+ */
+export declare function parseMarkdown(source: string): ParsedTopic;
+/**
+ * Map a parsed directive token onto the `DirectiveNode` shape consumed by
+ * downstream renderers.
+ */
+export declare function tokenToDirectiveNode(token: {
+    type: string;
+    name?: string;
+    attrs?: Record<string, string>;
+    body?: string;
+    highlighted?: string;
+}): DirectiveNode | null;
+//# sourceMappingURL=parse.d.ts.map

package/dist/render/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/render/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,MAAM,EAGN,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAwH5D,MAAM,WAAW,WAAW;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAKzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,aAAa,GAAG,IAAI,CAYvB"}