@x12i/made-easy 0.0.0-stage → 0.1.0

package/dist/render/markdown-out.js

@@ -0,0 +1,121 @@
+import { stringify } from 'yaml';
+import { entriesOf, guideTitle } from '../model.js';
+import { renderBlockMarkdown } from './blocks.js';
+import { buildBriefDocument } from './brief.js';
+import { makeContext } from './context.js';
+import { REF_PATTERN } from '../markdown-doc.js';
+function mapOutsideFences(source, fn) {
+    let fence;
+    return source
+        .split('\n')
+        .map((l) => {
+        const m = /^ {0,3}(`{3,}|~{3,})/.exec(l);
+        if (m) {
+            if (!fence)
+                fence = m[1][0].repeat(m[1].length);
+            else if (m[1][0] === fence[0] && m[1].length >= fence.length)
+                fence = undefined;
+            return l;
+        }
+        return fence ? l : fn(l);
+    })
+        .join('\n');
+}
+function lowerProse(source, shift) {
+    return mapOutsideFences(source, (l) => l
+        .replace(/^(#{1,6})([ \t]+.*?)(?:[ \t]+\{#[A-Za-z0-9][A-Za-z0-9_-]*\})?[ \t]*$/, (_m, hashes, rest) => `${'#'.repeat(Math.min(6, hashes.length + shift))}${rest}`)
+        .replace(new RegExp(REF_PATTERN.source, 'g'), (_raw, kind, id, anchor) => `\`${kind}:${id}${anchor ?? ''}\``));
+}
+export function renderEntryMarkdown(entry, ctx, shift) {
+    const body = entry.nodes
+        .map((n) => (n.kind === 'markdown' ? lowerProse(n.source, shift) : renderBlockMarkdown(n, ctx)))
+        .filter((s) => s.trim() !== '')
+        .join('\n\n');
+    const heading = entry.hasChapterHeading ? '' : `${'#'.repeat(Math.min(6, 1 + shift))} ${entry.title}\n\n`;
+    return `${heading}${body}`;
+}
+/** A whole track as plain Markdown with pinned revision metadata (operator/reference.md for the operator track). */
+export function renderTrackMarkdown(model, track) {
+    const guide = model.guide;
+    const ctx = makeContext(model, { page: track, standalone: true });
+    const pins = (model.brief?.operatorReference?.entries ?? []).map((p) => ({
+        id: p.id,
+        digest: entriesOf(model, 'operator').find((e) => e.id === p.id)?.digest ?? p.digest ?? '',
+    }));
+    const title = `${guideTitle(guide)}${track === 'operator' ? ' \u2014 Operator reference' : ''}`;
+    const front = stringify({
+        guide: guide.guideId,
+        job: guide.jobId,
+        title,
+        track,
+        revision: model.revision,
+        referenceRevision: model.referenceRevision,
+        pinnedEntries: pins,
+    }).trimEnd();
+    const parts = entriesOf(model, track).map((e) => renderEntryMarkdown(e, ctx, 1));
+    return `---\n${front}\n---\n\n# ${title}\n\n> Reference revision \`${model.referenceRevision.slice(7, 19)}\` \u00B7 guide \`${guide.guideId}\`\n\n${parts.join('\n\n')}\n`;
+}
+export function renderReferenceMarkdown(model) {
+    return renderTrackMarkdown(model, 'operator');
+}
+const bullet = (xs) => (xs.length ? xs.map((x) => `- ${x}`).join('\n') : '- _none_');
+function inputsMd(values, tick) {
+    return values.length
+        ? values.map((v) => `- **${v.label}** (\`${v.id}\`): ${v.value ? (tick ? `\`${v.value}\`` : v.value) : '_no value_'}`).join('\n')
+        : '- _none_';
+}
+/** brief.md: printable worked brief, blank template and review checklist. */
+export function renderBriefMarkdown(doc) {
+    const shared = (d) => `
+**Goal:** ${d.outcome}
+
+### Authority
+**May read**
+${bullet(d.authority.reads)}
+
+**May change**
+${bullet(d.authority.changes)}
+
+### Limits
+${bullet(d.limits)}
+
+### Pause rules
+${d.pauseRules.length ? d.pauseRules.map((p) => `- **${p.id}** \u2014 Pause when: ${p.trigger} Decision owner: ${p.owner}. May continue: ${p.mayContinue} Resume when: ${p.resumeWhen}`).join('\n') : '- _none_'}
+
+### Acceptance checks
+${d.acceptanceChecks.length ? d.acceptanceChecks.map((c) => `- **${c.id}** \u2014 ${c.observable} Pass when: ${c.passCondition} If missing: ${c.onMissing} If contradictory: ${c.onContradictory}`).join('\n') : '- _none_'}
+
+### Return
+${d.reportBack.length ? d.reportBack.map((r) => `- **${r.label}** (\`${r.id}\`)${r.description ? ` \u2014 ${r.description}` : ''}`).join('\n') : '- _none_'}
+`;
+    return `# ${doc.title} \u2014 Operator brief
+
+Job \`${doc.jobId}\` \u00B7 revision \`${doc.revision.slice(7, 19)}\` \u00B7 operator reference \`${doc.referenceRevision.slice(7, 19)}\`
+
+## Blank template
+
+Fill in the inputs, then give the whole brief to the operator.
+
+### Inputs
+${inputsMd(doc.template.inputs, true)}
+${shared(doc)}
+## Worked brief
+
+### Inputs
+${inputsMd(doc.worked.inputs, false)}
+${shared(doc)}
+## Operator reference (pinned)
+
+Reference revision \`${doc.referenceRevision}\`
+
+${doc.operatorReference.entries.length ? doc.operatorReference.entries.map((e) => `- ${e.title} (\`${e.path}\`, \`${e.digest.slice(7, 19)}\`)`).join('\n') : '- _none_'}
+
+## Review checklist
+
+${doc.checklist.length ? doc.checklist.map((c) => `- [ ] **${c.id}** \u2014 ${c.text} (pass when: ${c.passCondition})`).join('\n') : '- _none_'}
+`;
+}
+export function renderBriefJson(model) {
+    return `${JSON.stringify(buildBriefDocument(model), null, 2)}\n`;
+}
+//# sourceMappingURL=markdown-out.js.map

package/dist/render/markdown-out.js.map

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

package/dist/render/pdf.d.ts

@@ -0,0 +1,23 @@
+import type { Diagnostic, Paper } from '../contracts/index.js';
+export interface PdfOptions {
+    paper: Paper;
+    title: string;
+    /** Left footer text, e.g. reference revision and bundle path. */
+    footer: string;
+    draft: boolean;
+    executablePath?: string;
+    signal?: AbortSignal;
+}
+export interface PdfOutput {
+    ok: boolean;
+    bytes?: Uint8Array;
+    pages?: number;
+    browser?: string;
+    diagnostics: Diagnostic[];
+}
+export declare function findBrowser(explicit?: string): string | undefined;
+export declare function renderPdfDocuments(jobs: {
+    html: string;
+    options: PdfOptions;
+}[], executablePath?: string): Promise<PdfOutput[]>;
+//# sourceMappingURL=pdf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/render/pdf.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG/D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAID,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA0BjE;AAoBD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,EAAE,EAC7C,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAyGtB"}

package/dist/render/pdf.js

@@ -0,0 +1,138 @@
+import { existsSync } from 'node:fs';
+import { delimiter, join } from 'node:path';
+import { escapeHtml } from '../util.js';
+const ENV_VARS = ['MADE_EASY_BROWSER', 'REPORTIC_BROWSER', 'CHROME_PATH', 'PUPPETEER_EXECUTABLE_PATH'];
+export function findBrowser(explicit) {
+    const candidates = [];
+    if (explicit)
+        candidates.push(explicit);
+    for (const v of ENV_VARS)
+        if (process.env[v])
+            candidates.push(process.env[v]);
+    if (process.platform === 'win32') {
+        const roots = [process.env['PROGRAMFILES'], process.env['PROGRAMFILES(X86)'], process.env['LOCALAPPDATA']].filter(Boolean);
+        for (const r of roots) {
+            candidates.push(join(r, 'Google', 'Chrome', 'Application', 'chrome.exe'), join(r, 'Microsoft', 'Edge', 'Application', 'msedge.exe'), join(r, 'Chromium', 'Application', 'chrome.exe'));
+        }
+    }
+    else if (process.platform === 'darwin') {
+        candidates.push('/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge', '/Applications/Chromium.app/Contents/MacOS/Chromium');
+    }
+    else {
+        const dirs = (process.env['PATH'] ?? '').split(delimiter);
+        for (const name of ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser', 'microsoft-edge', 'microsoft-edge-stable']) {
+            for (const d of dirs)
+                candidates.push(join(d, name));
+        }
+    }
+    return candidates.find((c) => c && existsSync(c));
+}
+const PAPER_CONTENT_HEIGHT_PX = { A4: 960, Letter: 940 };
+export async function renderPdfDocuments(jobs, executablePath) {
+    const noBrowser = (message) => jobs.map(() => ({
+        ok: false,
+        diagnostics: [{ code: 'PDF_BROWSER_NOT_FOUND', severity: 'error', path: 'pdf', message }],
+    }));
+    const exe = findBrowser(executablePath);
+    if (!exe) {
+        return noBrowser('No Chromium-based browser was found. Install Chrome, Edge or Chromium and set MADE_EASY_BROWSER to its executable path, or build HTML only with --formats html.');
+    }
+    let pw;
+    try {
+        const specifier = 'playwright-core';
+        pw = (await import(specifier));
+    }
+    catch {
+        return noBrowser('PDF output needs the optional peer dependency playwright-core. Run "npm install playwright-core" next to @x12i/made-easy, or build HTML only with --formats html.');
+    }
+    let browser;
+    try {
+        browser = await pw.chromium.launch({ executablePath: exe, headless: true, args: ['--no-sandbox', '--disable-dev-shm-usage', '--disable-gpu'] });
+    }
+    catch (e) {
+        return noBrowser(`The browser at ${exe} could not be started: ${e.message.split('\n')[0]}. Check MADE_EASY_BROWSER.`);
+    }
+    const results = [];
+    try {
+        for (const job of jobs) {
+            const diagnostics = [];
+            const blocked = [];
+            try {
+                job.options.signal?.throwIfAborted();
+                const context = await browser.newContext({ javaScriptEnabled: false, offline: true, acceptDownloads: false, serviceWorkers: 'block' });
+                await context.route('**/*', async (route) => {
+                    const url = route.request().url();
+                    if (url.startsWith('data:') || url === 'about:blank')
+                        await route.continue();
+                    else {
+                        blocked.push(url);
+                        await route.abort();
+                    }
+                });
+                const page = await context.newPage();
+                await page.setContent(job.html, { waitUntil: 'load' });
+                await page.emulateMedia({ media: 'print' });
+                const limit = PAPER_CONTENT_HEIGHT_PX[job.options.paper];
+                const tall = await page.evaluate((max) => {
+                    const out = [];
+                    for (const el of Array.from(document.querySelectorAll('.block, .result, figure, tr'))) {
+                        const cs = getComputedStyle(el);
+                        if (cs.breakInside === 'avoid' && el.getBoundingClientRect().height > max) {
+                            out.push(el.id || el.className || el.tagName);
+                        }
+                    }
+                    return out;
+                }, limit);
+                for (const id of tall) {
+                    diagnostics.push({
+                        code: 'PDF_LAYOUT_OVERFLOW',
+                        severity: 'warning',
+                        path: 'pdf',
+                        message: `Block "${id}" is taller than one page; it breaks across pages.`,
+                    });
+                }
+                const e = escapeHtml;
+                const footer = `<div style="font:8px system-ui,Arial,sans-serif;color:#555;width:100%;padding:0 16mm;display:flex;justify-content:space-between;gap:8px"><span style="overflow:hidden;white-space:nowrap;text-overflow:ellipsis;max-width:80%">${e(job.options.footer)}</span><span style="white-space:nowrap">Page <span class="pageNumber"></span> of <span class="totalPages"></span></span></div>`;
+                const header = `<div style="font:8px system-ui,Arial,sans-serif;color:${job.options.draft ? '#8a1c1c' : '#555'};width:100%;padding:0 16mm;display:flex;justify-content:space-between"><span>${e(job.options.title)}</span><span>${job.options.draft ? 'DRAFT \u2014 not for publication' : ''}</span></div>`;
+                const buffer = await page.pdf({
+                    format: job.options.paper,
+                    printBackground: true,
+                    displayHeaderFooter: true,
+                    headerTemplate: header,
+                    footerTemplate: footer,
+                    margin: { top: '20mm', bottom: '20mm', left: '16mm', right: '16mm' },
+                    tagged: true,
+                    outline: true,
+                });
+                const bytes = new Uint8Array(buffer);
+                const pages = (Buffer.from(bytes).toString('latin1').match(/\/Type\s*\/Page\b/g) ?? []).length;
+                if (blocked.length) {
+                    diagnostics.push({
+                        code: 'PDF_NETWORK_BLOCKED',
+                        severity: 'error',
+                        path: 'pdf',
+                        message: `The renderer blocked ${blocked.length} network request(s): ${[...new Set(blocked)].slice(0, 3).join(', ')}`,
+                    });
+                    results.push({ ok: false, diagnostics });
+                }
+                else {
+                    results.push({ ok: true, bytes, pages, browser: `chromium ${browser.version()}`, diagnostics });
+                }
+            }
+            catch (e) {
+                diagnostics.push({
+                    code: 'PDF_RENDER_FAILED',
+                    severity: 'error',
+                    path: 'pdf',
+                    message: `PDF rendering failed: ${e.message.split('\n')[0]}`,
+                });
+                results.push({ ok: false, diagnostics });
+            }
+        }
+    }
+    finally {
+        await browser.close().catch(() => undefined);
+    }
+    return results;
+}
+//# sourceMappingURL=pdf.js.map

package/dist/render/pdf.js.map

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

package/dist/render/prose.d.ts

@@ -0,0 +1,15 @@
+import { type RenderContext } from './context.js';
+/** Remove trailing `{#anchor}` from ATX headings outside fenced code. */
+export declare function stripHeadingAnchors(source: string): string;
+export interface ProseOptions {
+    /** Heading ids in document order, `<entry>--<anchor>`. */
+    headingIds?: string[];
+    /** Added to authored heading levels (authored h1 becomes the chapter title). */
+    levelShift?: number;
+    inline?: boolean;
+}
+/** Post-process rendered HTML: replace [[kind:id]] refs and [[TODO:]] placeholders outside code. */
+export declare function decorate(html: string, ctx: RenderContext): string;
+export declare function renderProse(source: string, ctx: RenderContext, options?: ProseOptions): string;
+export declare function renderInline(text: string | undefined, ctx: RenderContext): string;
+//# sourceMappingURL=prose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prose.d.ts","sourceRoot":"","sources":["../../src/render/prose.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAc9D,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe1D;AAED,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,oGAAoG;AACpG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAoBjE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAyClG;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAGjF"}

package/dist/render/prose.js

@@ -0,0 +1,110 @@
+import { Marked } from 'marked';
+import { REF_PATTERN, PLACEHOLDER_PATTERN } from '../markdown-doc.js';
+import { escapeHtml } from '../util.js';
+import { resolveRef } from './context.js';
+const SAFE_SCHEME = /^(https?:|mailto:|#)/i;
+const ANY_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+function safeHref(href) {
+    const h = href.trim();
+    if (SAFE_SCHEME.test(h))
+        return h;
+    if (ANY_SCHEME.test(h))
+        return undefined;
+    if (h.startsWith('//'))
+        return undefined;
+    return h;
+}
+/** Remove trailing `{#anchor}` from ATX headings outside fenced code. */
+export function stripHeadingAnchors(source) {
+    let fence;
+    return source
+        .split('\n')
+        .map((l) => {
+        const m = /^ {0,3}(`{3,}|~{3,})/.exec(l);
+        if (m) {
+            if (!fence)
+                fence = m[1][0].repeat(m[1].length);
+            else if (m[1][0] === fence[0] && m[1].length >= fence.length)
+                fence = undefined;
+            return l;
+        }
+        if (fence)
+            return l;
+        return l.replace(/^(#{1,6}[ \t]+.*?)[ \t]+\{#[A-Za-z0-9][A-Za-z0-9_-]*\}[ \t]*$/, '$1');
+    })
+        .join('\n');
+}
+/** Post-process rendered HTML: replace [[kind:id]] refs and [[TODO:]] placeholders outside code. */
+export function decorate(html, ctx) {
+    const parts = html.split(/(<pre[\s\S]*?<\/pre>|<code[\s\S]*?<\/code>)/);
+    return parts
+        .map((part, i) => {
+        if (i % 2 === 1)
+            return part;
+        return part
+            .replace(new RegExp(REF_PATTERN.source, 'g'), (raw, kind, id, anchor) => {
+            const r = resolveRef(ctx, kind, id, anchor?.slice(1));
+            if (!r)
+                return `<span class="ref ref-unresolved" title="Unresolved reference">${escapeHtml(raw)}</span>`;
+            const title = r.title ? ` title="${escapeHtml(r.title)}"` : '';
+            return r.href
+                ? `<a class="ref ref-${kind}" href="${escapeHtml(r.href)}"${title}>${escapeHtml(r.label)}</a>`
+                : `<span class="ref ref-${kind}"${title}>${escapeHtml(r.label)}</span>`;
+        })
+            .replace(new RegExp(PLACEHOLDER_PATTERN.source, 'g'), (raw) => {
+            const text = raw.slice(2, -2);
+            return `<mark class="placeholder" title="Placeholder to complete before release">${escapeHtml(text)}</mark>`;
+        });
+    })
+        .join('');
+}
+export function renderProse(source, ctx, options = {}) {
+    const ids = [...(options.headingIds ?? [])];
+    const shift = options.levelShift ?? 1;
+    const marked = new Marked({ gfm: true, breaks: false });
+    marked.use({
+        renderer: {
+            html(token) {
+                return escapeHtml(token.text);
+            },
+            heading(token) {
+                const level = Math.min(6, token.depth + shift);
+                const id = ids.shift();
+                const text = this.parser.parseInline(token.tokens);
+                return `<h${level}${id ? ` id="${escapeHtml(id)}"` : ''}>${text}${id ? ` <a class="anchor" href="#${escapeHtml(id)}" aria-label="Link to this section">#</a>` : ''}</h${level}>\n`;
+            },
+            link(token) {
+                const text = this.parser.parseInline(token.tokens);
+                const href = safeHref(token.href);
+                if (!href)
+                    return text;
+                const external = /^https?:/i.test(href);
+                return `<a href="${escapeHtml(href)}"${token.title ? ` title="${escapeHtml(token.title)}"` : ''}${external ? ' rel="noopener noreferrer"' : ''}>${text}</a>`;
+            },
+            image(token) {
+                const asset = ctx.assetByPath.get(token.href) ?? ctx.assetByPath.get(token.href.replace(/^\.\//, ''));
+                const src = asset ? ctx.assetSrc(asset) : undefined;
+                if (!asset || !src)
+                    return `<span class="missing-image">${escapeHtml(token.text)}</span>`;
+                const alt = asset.decorative ? '' : (asset.alt ?? token.text);
+                return `<img src="${escapeHtml(src)}" alt="${escapeHtml(alt)}" loading="lazy">`;
+            },
+            code(token) {
+                const lang = (token.lang ?? '').split(/\s+/)[0]?.replace(/[^A-Za-z0-9_+-]/g, '') ?? '';
+                return `<pre class="code" tabindex="0"><code${lang ? ` class="language-${lang}"` : ''}>${escapeHtml(token.text)}</code></pre>\n`;
+            },
+        },
+    });
+    const cleaned = stripHeadingAnchors(source);
+    const html = options.inline ? marked.parseInline(cleaned) : marked.parse(cleaned);
+    const wrapped = html
+        .replace(/<table>/g, '<div class="table-wrap" role="region" tabindex="0" aria-label="Table"><table>')
+        .replace(/<\/table>/g, '</table></div>');
+    return decorate(wrapped, ctx);
+}
+export function renderInline(text, ctx) {
+    if (!text)
+        return '';
+    return renderProse(text, ctx, { inline: true });
+}
+//# sourceMappingURL=prose.js.map

package/dist/render/prose.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,13 @@
+import { type CreateGuideRequest } from './contracts/index.js';
+export interface CreatedGuide {
+    guideId: string;
+    recipe: string;
+    /** Bundle files by relative path (UTF-8 text). */
+    files: Record<string, string>;
+    revision: string;
+}
+/** Scaffold a complete two-track bundle from a recipe, without any model. */
+export declare function scaffoldGuide(input: CreateGuideRequest): Omit<CreatedGuide, 'revision'>;
+/** Create a bundle and report its revision, computed by the same reader every adapter uses. */
+export declare function createGuide(input: CreateGuideRequest): Promise<CreatedGuide>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,kBAAkB,EAExB,MAAM,sBAAsB,CAAC;AAM9B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2RD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAgKvF;AAED,+FAA+F;AAC/F,wBAAsB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAIlF"}