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

package/dist/render/parse.js

@@ -0,0 +1,145 @@
+import { Marked } from 'marked';
+import * as z from 'zod/v4';
+import { parseFrontmatter } from "./frontmatter.js";
+/**
+ * Parse a `:::name{key="val" key2="val2"}` opening line. Returns the name and
+ * attrs map, or null when the line isn't a directive opener.
+ *
+ * Attribute parsing accepts:
+ *   - `key="quoted value"` (preserves spaces inside quotes)
+ *   - `key='single quoted'`
+ *   - `key=unquoted` (no spaces)
+ *   - `flag` (presence-only; resolves to `flag="true"`)
+ */
+function parseDirectiveOpener(line) {
+    const m = line.match(/^:::([a-zA-Z][a-zA-Z0-9_-]*)\s*(\{([^}]*)\})?\s*$/);
+    if (!m)
+        return null;
+    const name = m[1];
+    const attrStr = m[3] ?? '';
+    const attrs = {};
+    // Match key="..." | key='...' | key=value | flag (presence-only)
+    const attrRegex = /([a-zA-Z][a-zA-Z0-9_-]*)\s*(?:=\s*(?:"([^"]*)"|'([^']*)'|([^\s}]+)))?/g;
+    let match;
+    while ((match = attrRegex.exec(attrStr)) !== null) {
+        const key = match[1];
+        const value = match[2] ?? match[3] ?? match[4] ?? 'true';
+        attrs[key] = value;
+    }
+    return { name, attrs };
+}
+/**
+ * Marked tokenizer extension that recognizes block-level directives.
+ *
+ * Matches:
+ *   :::name{key=val}
+ *   body lines...
+ *   :::
+ *
+ * Critical: this runs as a `block` tokenizer, NOT inline, so directives
+ * INSIDE fenced code blocks (` ```...``` `) are left untouched by marked's
+ * code-block tokenizer (which runs first / higher priority in the same scan).
+ */
+const directiveTokenizer = {
+    name: 'directive',
+    level: 'block',
+    start(src) {
+        const idx = src.indexOf(':::');
+        return idx >= 0 ? idx : undefined;
+    },
+    tokenizer(src) {
+        // Must be at start (block tokenizer is called with the line at the head).
+        const match = src.match(/^:::([a-zA-Z][a-zA-Z0-9_-]*)([^\n]*)\n/);
+        if (!match)
+            return undefined;
+        const header = `:::${match[1]}${match[2]}`;
+        const opener = parseDirectiveOpener(header);
+        if (!opener)
+            return undefined;
+        // Find the closing fence `:::` on its own line. Line-based scan beats
+        // a single regex: a non-greedy body group keeps extending across legitimate
+        // empty-body close fences, which would let a `:::descriptor{}\n:::\n`
+        // silently swallow following sections up to the next `:::` of any kind.
+        const rest = src.slice(match[0].length);
+        const restLines = rest.split('\n');
+        let closeLineIdx = -1;
+        for (let i = 0; i < restLines.length; i++) {
+            if (/^:::\s*$/.test(restLines[i])) {
+                closeLineIdx = i;
+                break;
+            }
+        }
+        if (closeLineIdx < 0)
+            return undefined;
+        const body = restLines.slice(0, closeLineIdx).join('\n');
+        // Length of the consumed text in `rest`: body + trailing `\n` (if any body) +
+        // the close line + trailing `\n` (if not at end-of-source).
+        const closeText = restLines.slice(0, closeLineIdx + 1).join('\n');
+        const trailingNewline = closeLineIdx + 1 < restLines.length ? '\n' : '';
+        const raw = match[0] + closeText + trailingNewline;
+        const token = {
+            type: 'directive',
+            raw,
+            name: opener.name,
+            attrs: opener.attrs,
+            body
+        };
+        return token;
+    }
+};
+/**
+ * Stub renderer — marked requires every extension to expose `renderer`. The
+ * terminal/web renderers walk the token tree themselves via `lexer()`, so this
+ * passthrough is only invoked if a caller hands a directive-containing token
+ * tree to marked's default renderer (which we don't).
+ */
+const DirectiveBodySchema = z.object({
+    body: z.string()
+});
+const directiveRenderer = {
+    name: 'directive',
+    renderer(token) {
+        const parsed = DirectiveBodySchema.safeParse(token);
+        return parsed.success ? parsed.data.body : '';
+    }
+};
+/**
+ * Build a configured `marked` instance with the directive extension installed.
+ * Exposed so consumers (terminal renderer, future web renderer) can share the
+ * same lexer.
+ */
+export function createMarked() {
+    const md = new Marked();
+    md.use({
+        extensions: [directiveTokenizer, directiveRenderer]
+    });
+    return md;
+}
+/**
+ * Parse a topic body — strips frontmatter and lexes to a token tree.
+ */
+export function parseMarkdown(source) {
+    const { frontmatter, content } = parseFrontmatter(source);
+    const md = createMarked();
+    const tokens = md.lexer(content);
+    return { frontmatter, tokens };
+}
+/**
+ * Map a parsed directive token onto the `DirectiveNode` shape consumed by
+ * downstream renderers.
+ */
+export function tokenToDirectiveNode(token) {
+    if (token.type !== 'directive' || !token.name)
+        return null;
+    const node = {
+        type: 'directive',
+        name: token.name,
+        attrs: token.attrs ?? {},
+        body: token.body ?? ''
+    };
+    if (token.highlighted) {
+        node.highlighted = token.highlighted;
+    }
+    return node;
+}
+//# sourceMappingURL=parse.js.map

package/dist/render/parse.js.map

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

package/dist/render/sections.d.ts

@@ -0,0 +1,24 @@
+import { type MarkdownSectionRequest } from '@vibesdotdev/docs-contracts';
+/** The existing lexer owns Markdown syntax; offsets always refer to the original supplied source. */
+export declare function selectMarkdownSection(input: MarkdownSectionRequest): {
+    status: "selected";
+    section: {
+        slug: string;
+        title: string;
+        level: number;
+        start: number;
+        end: number;
+    };
+} | {
+    status: "missing";
+} | {
+    status: "ambiguous";
+    sections: {
+        slug: string;
+        title: string;
+        level: number;
+        start: number;
+        end: number;
+    }[];
+};
+//# sourceMappingURL=sections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/render/sections.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6D,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AASrI,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;;EAsDlE"}

package/dist/render/sections.js

@@ -0,0 +1,76 @@
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { MarkdownSectionRequestSchema, MarkdownSectionResultSchema } from '@vibesdotdev/docs-contracts';
+import { createMarked } from "./parse.js";
+import { markdownHeadingSlug } from "./frontmatter.js";
+import GithubSlugger from 'github-slugger';
+import { Lexer, Parser, TextRenderer } from 'marked';
+import { decodeHTML } from 'entities';
+const HeadingSchema = z.object({ depth: z.number().int().min(1).max(6), text: z.string() });
+/** The existing lexer owns Markdown syntax; offsets always refer to the original supplied source. */
+export function selectMarkdownSection(input) {
+    const { text, slug } = MarkdownSectionRequestSchema.parse(input);
+    const normalized = text.replace(/\r\n|\r/g, '\n');
+    const headings = [];
+    const slugger = new GithubSlugger();
+    const parser = new Parser();
+    const renderer = new TextRenderer();
+    const plain = (tokens) => parser.parseInline(tokens, renderer);
+    renderer.strong = ({ tokens }) => plain(tokens);
+    renderer.em = ({ tokens }) => plain(tokens);
+    renderer.del = ({ tokens }) => plain(tokens);
+    renderer.link = ({ tokens }) => plain(tokens);
+    renderer.html = () => '';
+    renderer.image = () => '';
+    renderer.text = ({ text }) => decodeHTML(text);
+    let cursor = 0;
+    for (const token of createMarked().lexer(normalized)) {
+        const start = normalized.indexOf(token.raw, cursor);
+        if (start < 0 || normalized.slice(cursor, start).trim()) {
+            throw new CapabilityError('The Markdown lexer cannot retain source offsets.', 'UNAVAILABLE', {
+                reason: 'markdown-section-source-offsets-unavailable'
+            });
+        }
+        if (token.type === 'heading') {
+            const heading = HeadingSchema.parse(token);
+            const title = plain(Lexer.lexInline(heading.text));
+            headings.push({
+                start, title, level: heading.depth, slug: slugger.slug(title),
+                legacy: markdownHeadingSlug(heading.text)
+            });
+        }
+        cursor = start + token.raw.length;
+    }
+    const canonical = headings.some(heading => heading.slug === slug);
+    const matches = headings.flatMap((heading, index) => {
+        if ((canonical ? heading.slug : heading.legacy) !== slug)
+            return [];
+        let end = normalized.length;
+        for (let next = index + 1; next < headings.length; next++) {
+            const candidate = headings[next];
+            if (candidate && candidate.level <= heading.level) {
+                end = candidate.start;
+                break;
+            }
+        }
+        return [{
+                slug: heading.slug || slug, title: heading.title, level: heading.level,
+                start: sourceOffset(text, heading.start), end: sourceOffset(text, end)
+            }];
+    });
+    if (matches.length === 0)
+        return MarkdownSectionResultSchema.parse({ status: 'missing' });
+    if (matches.length === 1)
+        return MarkdownSectionResultSchema.parse({ status: 'selected', section: matches[0] });
+    return MarkdownSectionResultSchema.parse({ status: 'ambiguous', sections: matches });
+}
+/** Marked normalizes line endings; CRLF occupies two UTF-16 positions in the original source. */
+function sourceOffset(text, offset) {
+    let original = 0;
+    for (let normalized = 0; normalized < offset; normalized++, original++) {
+        if (text[original] === '\r' && text[original + 1] === '\n')
+            original++;
+    }
+    return original;
+}
+//# sourceMappingURL=sections.js.map

package/dist/render/sections.js.map

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

package/dist/render/terminal.d.ts

@@ -0,0 +1,15 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { DocsTopicDescriptor } from '../schemas/topic.schema.ts';
+export interface RenderTopicOptions {
+    /** Other topic ids in the same parent — feeds SEE ALSO synthesis. */
+    siblingTopicIds?: readonly string[];
+    /** Disable the man envelope (useful when the caller wraps in their own UI). */
+    bare?: boolean;
+}
+/**
+ * Render a topic descriptor + markdown source to ANSI text suitable for
+ * `process.stdout.write`. When `bare` is false, wraps the body in the
+ * man-page envelope. Color follows the handed runtime's no-color env.
+ */
+export declare function renderTopicToTerminal(runtime: Pick<VibesRuntime, 'getEnv'>, descriptor: DocsTopicDescriptor, body: string, options?: RenderTopicOptions): string;
+//# sourceMappingURL=terminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/render/terminal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,4BAA4B,CAAC;AAmQpF,MAAM,WAAW,kBAAkB;IAClC,qEAAqE;IACrE,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EACrC,UAAU,EAAE,mBAAmB,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC9B,MAAM,CAyDR"}

package/dist/render/terminal.js

@@ -0,0 +1,293 @@
+import { createAnsi, readAnsiEnv, visibleLength } from "./ansi.js";
+import { parseMarkdown, tokenToDirectiveNode } from "./parse.js";
+import { renderDirectiveCli } from "../cli/directives/index.js";
+const INDENT = '    ';
+const ENVELOPE_WIDTH = 78;
+function tokenRawText(tok) {
+    if ('raw' in tok && Boolean(tok.raw)) {
+        return String(tok.raw);
+    }
+    return null;
+}
+function isTextToken(tok) {
+    return tok.type === 'text';
+}
+function isStrongToken(tok) {
+    return tok.type === 'strong';
+}
+function isEmToken(tok) {
+    return tok.type === 'em';
+}
+function isCodespanToken(tok) {
+    return tok.type === 'codespan';
+}
+function isLinkToken(tok) {
+    return tok.type === 'link';
+}
+function isDelToken(tok) {
+    return tok.type === 'del';
+}
+function isEscapeToken(tok) {
+    return tok.type === 'escape';
+}
+function isHeadingToken(tok) {
+    return tok.type === 'heading';
+}
+function isParagraphToken(tok) {
+    return tok.type === 'paragraph';
+}
+function isCodeToken(tok) {
+    return tok.type === 'code';
+}
+function isListToken(tok) {
+    return tok.type === 'list';
+}
+function isBlockquoteToken(tok) {
+    return tok.type === 'blockquote';
+}
+function isHtmlToken(tok) {
+    return tok.type === 'html';
+}
+function isDirectiveToken(tok) {
+    return tok.type === 'directive';
+}
+/**
+ * Walk inline tokens (within a paragraph/heading/list-item) and emit ANSI.
+ */
+function renderInline(ansi, tokens) {
+    let out = '';
+    for (const tok of tokens) {
+        if (isTextToken(tok)) {
+            out += tok.text;
+        }
+        else if (isStrongToken(tok)) {
+            out += ansi.bold(renderInline(ansi, tok.tokens ?? []));
+        }
+        else if (isEmToken(tok)) {
+            out += ansi.italic(renderInline(ansi, tok.tokens ?? []));
+        }
+        else if (isCodespanToken(tok)) {
+            out += ansi.cyan(`\`${tok.text}\``);
+        }
+        else if (isLinkToken(tok)) {
+            const label = renderInline(ansi, tok.tokens ?? []);
+            out += `${ansi.underline(label)} ${ansi.gray(`(${tok.href})`)}`;
+        }
+        else if (isDelToken(tok)) {
+            out += ansi.dim(renderInline(ansi, tok.tokens ?? []));
+        }
+        else if (tok.type === 'br') {
+            out += '\n';
+        }
+        else if (isEscapeToken(tok)) {
+            out += tok.text;
+        }
+        else {
+            out += tokenRawText(tok) ?? '';
+        }
+    }
+    return out;
+}
+/**
+ * Walk block-level tokens and emit ANSI lines.
+ */
+function renderBlocks(ansi, tokens) {
+    const chunks = [];
+    for (const tok of tokens) {
+        if (isDirectiveToken(tok)) {
+            const node = tokenToDirectiveNode(tok);
+            if (node) {
+                chunks.push(renderDirectiveCli(node, ansi));
+                continue;
+            }
+        }
+        if (isHeadingToken(tok)) {
+            const text = renderInline(ansi, tok.tokens ?? []);
+            const prefix = '#'.repeat(tok.depth);
+            chunks.push(`${ansi.bold(ansi.brightCyan(`${prefix} ${text}`))}`);
+        }
+        else if (isParagraphToken(tok)) {
+            chunks.push(renderInline(ansi, tok.tokens ?? []));
+        }
+        else if (isCodeToken(tok)) {
+            const lang = tok.lang ?? '';
+            const header = lang ? ansi.gray(`── ${lang} ──`) : ansi.gray('──────');
+            const body = tok.text
+                .split('\n')
+                .map((line) => `${INDENT}${ansi.dim(line)}`)
+                .join('\n');
+            chunks.push(`${header}\n${body}`);
+        }
+        else if (isListToken(tok)) {
+            const lines = [];
+            let idx = 1;
+            for (const item of tok.items) {
+                const marker = tok.ordered ? `${idx}.` : '•';
+                const inner = renderBlocks(ansi, item.tokens ?? []);
+                const innerLines = inner.split('\n');
+                const first = innerLines.shift() ?? '';
+                lines.push(`  ${ansi.cyan(marker)} ${first}`);
+                for (const rest of innerLines) {
+                    lines.push(`     ${rest}`);
+                }
+                idx += 1;
+            }
+            chunks.push(lines.join('\n'));
+        }
+        else if (isBlockquoteToken(tok)) {
+            const inner = renderBlocks(ansi, tok.tokens ?? []);
+            const quoted = inner
+                .split('\n')
+                .map((line) => `${ansi.gray('│')} ${ansi.dim(line)}`)
+                .join('\n');
+            chunks.push(quoted);
+        }
+        else if (tok.type === 'hr') {
+            chunks.push(ansi.gray('─'.repeat(ENVELOPE_WIDTH)));
+        }
+        else if (tok.type === 'space') {
+            // ignored
+        }
+        else if (isHtmlToken(tok)) {
+            chunks.push(tok.text);
+        }
+        else {
+            const raw = tokenRawText(tok);
+            if (raw !== null) {
+                chunks.push(raw);
+            }
+        }
+    }
+    return chunks.join('\n\n');
+}
+/**
+ * Build the top header line of the man envelope:
+ *
+ *   TOOLS.LIST(1)                     Vibes Manual                    TOOLS.LIST(1)
+ */
+function envelopeHeaderLine(ansi, name, section) {
+    const ref = `${name.toUpperCase()}(${section})`;
+    const middle = 'Vibes Manual';
+    const slack = ENVELOPE_WIDTH - visibleLength(ref) * 2 - visibleLength(middle);
+    const side = Math.max(2, Math.floor(slack / 2));
+    const pad = ' '.repeat(side);
+    const remainder = slack - side * 2;
+    const rightPad = ' '.repeat(Math.max(0, remainder));
+    return `${ansi.bold(ref)}${pad}${middle}${pad}${rightPad}${ansi.bold(ref)}`;
+}
+function envelopeFooterLine(ansi, name, section) {
+    const ref = `${name.toUpperCase()}(${section})`;
+    const left = 'VIBES';
+    const middle = new Date().toISOString().slice(0, 10);
+    const slack = ENVELOPE_WIDTH - visibleLength(left) - visibleLength(middle) - visibleLength(ref);
+    const side = Math.max(2, Math.floor(slack / 2));
+    const pad = ' '.repeat(side);
+    const remainder = slack - side * 2;
+    const rightPad = ' '.repeat(Math.max(0, remainder));
+    return `${left}${pad}${middle}${pad}${rightPad}${ansi.bold(ref)}`;
+}
+/**
+ * Synthesize a `DocsTopicMan` from descriptor fields when none is provided.
+ * Drives the NAME, SYNOPSIS-ish line, and SEE ALSO list.
+ */
+function synthesizeMan(inputs) {
+    const { descriptor, siblingTopicIds } = inputs;
+    const synthesized = {
+        name: descriptor.summary
+            ? `${descriptor.id} — ${descriptor.summary}`
+            : `${descriptor.id} — ${descriptor.title}`,
+        section: 1,
+        seeAlso: siblingTopicIds.filter((id) => id !== descriptor.id).slice(0, 6)
+    };
+    return synthesized;
+}
+/**
+ * Render a `OPTIONS` block from `DocsTopicMan.options`.
+ */
+function renderOptions(ansi, man) {
+    const opts = man.options ?? [];
+    if (opts.length === 0)
+        return null;
+    const lines = opts.map((o) => `${INDENT}${ansi.bold(o.flag.padEnd(14))} ${o.description}`);
+    return lines.join('\n');
+}
+/**
+ * Render an `EXAMPLES` block from `DocsTopicMan.examples`.
+ */
+function renderExamples(ansi, man) {
+    const ex = man.examples ?? [];
+    if (ex.length === 0)
+        return null;
+    const lines = [];
+    for (const e of ex) {
+        lines.push(`${INDENT}${ansi.dim(e.description)}`);
+        lines.push(`${INDENT}${ansi.green('$')} ${ansi.bold(e.command)}`);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd();
+}
+/**
+ * Render a `SEE ALSO` line from man.seeAlso.
+ */
+function renderSeeAlso(man) {
+    const refs = man.seeAlso ?? [];
+    if (refs.length === 0)
+        return null;
+    const formatted = refs.map((r) => `${r}(1)`).join(', ');
+    return `${INDENT}${formatted}`;
+}
+/**
+ * Render a topic descriptor + markdown source to ANSI text suitable for
+ * `process.stdout.write`. When `bare` is false, wraps the body in the
+ * man-page envelope. Color follows the handed runtime's no-color env.
+ */
+export function renderTopicToTerminal(runtime, descriptor, body, options = {}) {
+    const ansi = createAnsi(readAnsiEnv(runtime));
+    const siblings = options.siblingTopicIds ?? [];
+    const man = descriptor.man ?? synthesizeMan({ descriptor, siblingTopicIds: siblings });
+    const parsed = parseMarkdown(body);
+    const rendered = renderBlocks(ansi, parsed.tokens);
+    const descriptionIndented = rendered
+        .split('\n')
+        .map((line) => (line.length === 0 ? '' : `${INDENT}${line}`))
+        .join('\n');
+    if (options.bare) {
+        return descriptionIndented;
+    }
+    const section = man.section ?? 1;
+    const name = man.name ?? `${descriptor.id} — ${descriptor.title}`;
+    const synopsis = man.synopsis ?? `vibes man ${descriptor.id}`;
+    const sections = [];
+    sections.push(envelopeHeaderLine(ansi, descriptor.id, section));
+    sections.push('');
+    sections.push(ansi.bold('NAME'));
+    sections.push(`${INDENT}${name}`);
+    sections.push('');
+    sections.push(ansi.bold('SYNOPSIS'));
+    sections.push(`${INDENT}${ansi.bold(synopsis)}`);
+    sections.push('');
+    sections.push(ansi.bold('DESCRIPTION'));
+    sections.push(descriptionIndented);
+    const opts = renderOptions(ansi, man);
+    if (opts) {
+        sections.push('');
+        sections.push(ansi.bold('OPTIONS'));
+        sections.push(opts);
+    }
+    const examples = renderExamples(ansi, man);
+    if (examples) {
+        sections.push('');
+        sections.push(ansi.bold('EXAMPLES'));
+        sections.push(examples);
+    }
+    const seeAlso = renderSeeAlso(man);
+    if (seeAlso) {
+        sections.push('');
+        sections.push(ansi.bold('SEE ALSO'));
+        sections.push(seeAlso);
+    }
+    sections.push('');
+    sections.push(envelopeFooterLine(ansi, descriptor.id, section));
+    return sections.join('\n');
+}
+//# sourceMappingURL=terminal.js.map

package/dist/render/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/render/terminal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAkB,MAAM,WAAW,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,MAAM,MAAM,GAAG,MAAM,CAAC;AACtB,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,SAAS,YAAY,CAAC,GAAU;IAC/B,IAAI,KAAK,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,GAAU;IAC9B,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,SAAS,aAAa,CAAC,GAAU;IAChC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9B,CAAC;AAED,SAAS,SAAS,CAAC,GAAU;IAC5B,OAAO,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,GAAU;IAClC,OAAO,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC;AAChC,CAAC;AAED,SAAS,WAAW,CAAC,GAAU;IAC9B,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,SAAS,UAAU,CAAC,GAAU;IAC7B,OAAO,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC;AAC3B,CAAC;AAED,SAAS,aAAa,CAAC,GAAU;IAChC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC9B,CAAC;AAED,SAAS,cAAc,CAAC,GAAU;IACjC,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAU;IACnC,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,GAAU;IAC9B,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,SAAS,WAAW,CAAC,GAAU;IAC9B,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAU;IACpC,OAAO,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AAClC,CAAC;AAED,SAAS,WAAW,CAAC,GAAU;IAC9B,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAU;IAOnC,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAe,EAAE,MAAe;IACrD,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACnD,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACjE,CAAC;aAAM,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9B,GAAG,IAAI,IAAI,CAAC;QACb,CAAC;aAAM,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACP,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAe,EAAE,MAAe;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,IAAI,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC5C,SAAS;YACV,CAAC;QACF,CAAC;QAED,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI;iBACnB,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;iBAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC7C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBACpD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;gBAC9C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;oBAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;gBAC5B,CAAC;gBACD,GAAG,IAAI,CAAC,CAAC;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,KAAK;iBAClB,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;iBACpD,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,UAAU;QACX,CAAC;aAAM,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACP,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,IAAe,EAAE,IAAY,EAAE,OAAe;IACzE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,OAAO,GAAG,CAAC;IAChD,MAAM,MAAM,GAAG,cAAc,CAAC;IAC9B,MAAM,KAAK,GAAG,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAe,EAAE,IAAY,EAAE,OAAe;IACzE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,OAAO,GAAG,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,GACV,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAOD;;;GAGG;AACH,SAAS,aAAa,CAAC,MAAuB;IAC7C,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAC/C,MAAM,WAAW,GAAiB;QACjC,IAAI,EAAE,UAAU,CAAC,OAAO;YACvB,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,MAAM,UAAU,CAAC,OAAO,EAAE;YAC5C,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,MAAM,UAAU,CAAC,KAAK,EAAE;QAC3C,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;KACzE,CAAC;IACF,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,IAAe,EAAE,GAAiB;IACxD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAClE,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAe,EAAE,GAAiB;IACzD,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,GAAiB;IACvC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;AAChC,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACpC,OAAqC,EACrC,UAA+B,EAC/B,IAAY,EACZ,UAA8B,EAAE;IAEhC,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEvF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,mBAAmB,GAAG,QAAQ;SAClC,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;SAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,mBAAmB,CAAC;IAC5B,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,UAAU,CAAC,EAAE,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,aAAa,UAAU,CAAC,EAAE,EAAE,CAAC;IAC9D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAEnC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,IAAI,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,QAAQ,EAAE,CAAC;QACd,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAEhE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/runbooks/index.d.ts

@@ -0,0 +1,4 @@
+/** Runbooks moved to `@vibesdotdev/runbooks` (2026-10-06). This path forwards there. */
+export { RunbookManager, createRunbook } from '@vibesdotdev/runbooks/catalog';
+export type { RunbookStep, RunbookPhase, Runbook } from '@vibesdotdev/runbooks/catalog';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runbooks/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runbooks/index.js

@@ -0,0 +1,3 @@
+/** Runbooks moved to `@vibesdotdev/runbooks` (2026-10-06). This path forwards there. */
+export { RunbookManager, createRunbook } from '@vibesdotdev/runbooks/catalog';
+//# sourceMappingURL=index.js.map

package/dist/runbooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runbooks/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runbooks/runbooks.plugin.d.ts

@@ -0,0 +1,3 @@
+/** Runbooks moved to `@vibesdotdev/runbooks` (2026-10-06). This path forwards there. */
+export { default } from '@vibesdotdev/runbooks/plugin';
+//# sourceMappingURL=runbooks.plugin.d.ts.map

package/dist/runbooks/runbooks.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbooks.plugin.d.ts","sourceRoot":"","sources":["../../src/runbooks/runbooks.plugin.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/runbooks/runbooks.plugin.js

@@ -0,0 +1,3 @@
+/** Runbooks moved to `@vibesdotdev/runbooks` (2026-10-06). This path forwards there. */
+export { default } from '@vibesdotdev/runbooks/plugin';
+//# sourceMappingURL=runbooks.plugin.js.map

package/dist/runbooks/runbooks.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runbooks.plugin.js","sourceRoot":"","sources":["../../src/runbooks/runbooks.plugin.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/schemas/citations.schema.d.ts

@@ -0,0 +1,21 @@
+import * as z from 'zod/v4';
+export declare const DocsCitationSubjectSchema: z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare const DocsCitationQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+    maxTopics: z.ZodOptional<z.ZodNumber>;
+    stalenessThresholdDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    subject: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strip>, z.ZodEnum<{
+        package: "package";
+        entity: "entity";
+    }>]>;
+    maxTopics: z.ZodOptional<z.ZodNumber>;
+    stalenessThresholdDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>]>;
+//# sourceMappingURL=citations.schema.d.ts.map