@x12i/made-easy 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x12i
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,58 @@
-# Temporary Holding Version
+# @x12i/made-easy
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The headless SDK for **Made Easy**: two-track guides built from one source bundle.
+
+- A **human track**: a short ebook in a fixed six-section arc (decision, working model, ownership, operator brief, evidence review, next decision).
+- An **operator track**: a reference an agent or engineer can act on (scope, procedure, interface, example, recovery), pinned by digest so the human guide can say exactly which reference it matches.
+
+No React, no service dependencies, and no mandatory model provider. A build works offline: HTML, Markdown, a JSON brief, a manifest and a ZIP never need a browser or a network. PDF output uses an installed Chrome or Edge through the optional peer `playwright-core`.
+
+```bash
+npm install @x12i/made-easy
+```
+
+Node 22 or newer. ESM only.
+
+## Use
+
+```ts
+import { createGuide, validateGuide, buildGuide, writeBundle } from '@x12i/made-easy';
+
+// 1. Scaffold from a recipe (profile.preset: market|product|service|sdk x quickstart|handbook).
+const created = await createGuide({ recipe: 'sdk.quickstart', subject: { name: 'ms' } });
+await writeBundle(created.files, './guide');
+
+// 2. Validate. Draft mode treats [[TODO: ...]] as warnings; release mode makes them errors.
+const report = await validateGuide('./guide', { mode: 'release', audience: 'public' });
+for (const d of report.diagnostics) console.log(d.path, d.line, d.code, d.message);
+
+// 3. Build. Output is deterministic: same bundle, same bytes.
+const build = await buildGuide('./guide', { mode: 'release', audience: 'public', out: './out', formats: ['html', 'pdf'] });
+console.log(build.status, build.artifacts.map((a) => a.path));
+```
+
+The same functions accept an in-memory bundle (`{ kind: 'files', files }` via `memorySource`) or a `.zip`, so a server can use them without a disk.
+
+## What it checks
+
+Every diagnostic has the shape `{ code, severity, path, line?, column?, blockId?, pointer?, hint?, message }`. Release mode blocks, among others:
+
+| Code | Meaning |
+| --- | --- |
+| `PLACEHOLDER_PRESENT` | A `[[TODO: ...]]` remains |
+| `PIN_STALE`, `PIN_MISSING`, `PIN_UNRESOLVED` | The brief no longer matches the operator reference |
+| `EXAMPLE_UNVERIFIED` | An executable example has no verification record |
+| `SDK_INTEGRITY_MISSING` | An SDK guide lacks a registry integrity value |
+| `SECRET_DETECTED` | A credential-shaped value (never echoed back) |
+| `PUBLICATION_PRIVATE_REFERENCE` | Public output refers to a private source or asset |
+| `BUNDLE_PATH_UNSAFE`, `BUNDLE_LIMIT_EXCEEDED` | Unsafe paths, oversized or zip-bomb bundles |
+
+## Optional parts
+
+- `draftGuide` / `applyDraftProposal`: propose section text from a pinned source snapshot. Bring your own adapter (`createTemplateDraftAdapter` is offline; `createChatCompletionsAdapter` talks to any OpenAI-compatible endpoint). A proposal never changes the bundle until applied against the revision it was drafted from.
+- `resolveNpmPackage` and `verifyExamples`: explicit network and execution helpers. A build never calls them.
+- `@x12i/made-easy/contracts`: the Zod schemas and block definitions the other packages share. JSON Schemas ship in `schemas/`.
+
+See the [repository](https://github.com/x12i/made-easy) for the CLI, hosted service, HTTP API, MCP server and Studio.
+
+MIT © x12i

package/dist/analysis.d.ts

@@ -0,0 +1,19 @@
+import { type GuideModel } from './model.js';
+import type { RefKind } from './contracts/index.js';
+export interface Usage {
+    sources: Set<string>;
+    assets: Set<string>;
+    claims: Set<string>;
+}
+/** Parse `kind:id#anchor` references used by block props. */
+export declare function parseRef(ref: string): {
+    kind: RefKind;
+    id: string;
+    anchor?: string;
+} | undefined;
+/**
+ * Which sources, claims and assets are rendered (and therefore must be publishable).
+ * Claims are all rendered in the evidence appendix, so their sources count as used.
+ */
+export declare function computeUsage(model: GuideModel): Usage;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAe,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrB;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIhG;AAeD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CA8CrD"}

package/dist/analysis.js

@@ -0,0 +1,90 @@
+import { extractImagePaths, extractInlineRefs } from './markdown-doc.js';
+import { allBlocks } from './model.js';
+/** Parse `kind:id#anchor` references used by block props. */
+export function parseRef(ref) {
+    const m = /^([a-z]+):([a-z0-9][a-z0-9_-]*)(?:#([A-Za-z0-9_-]+))?$/.exec(ref);
+    if (!m)
+        return undefined;
+    return { kind: m[1], id: m[2], anchor: m[3] };
+}
+function blockRefs(block) {
+    const p = block.props;
+    const out = [];
+    const evidence = (v) => {
+        if (Array.isArray(v))
+            for (const r of v)
+                if (typeof r === 'string')
+                    out.push(r);
+    };
+    if (block.type === 'decision') {
+        evidence(p.evidence);
+        if (Array.isArray(p.options))
+            for (const o of p.options)
+                evidence(o?.evidence);
+    }
+    return out;
+}
+/**
+ * Which sources, claims and assets are rendered (and therefore must be publishable).
+ * Claims are all rendered in the evidence appendix, so their sources count as used.
+ */
+export function computeUsage(model) {
+    const usage = { sources: new Set(), assets: new Set(), claims: new Set() };
+    const addEvidence = (list) => list?.forEach((e) => usage.sources.add(e.source));
+    for (const c of model.sources?.claims ?? []) {
+        usage.claims.add(c.id);
+        addEvidence(c.evidence);
+    }
+    for (const ce of model.sources?.checkEvidence ?? [])
+        addEvidence(ce.evidence);
+    for (const r of model.checks?.results ?? []) {
+        for (const rc of r.checks ?? []) {
+            for (const ref of rc.evidence ?? []) {
+                const p = parseRef(ref);
+                if (p?.kind === 'source')
+                    usage.sources.add(p.id);
+                if (p?.kind === 'claim')
+                    usage.claims.add(p.id);
+            }
+        }
+    }
+    for (const { block } of allBlocks(model)) {
+        if (block.type === 'figure' && typeof block.props.asset === 'string') {
+            usage.assets.add(block.props.asset);
+        }
+        for (const ref of blockRefs(block)) {
+            const p = parseRef(ref);
+            if (p?.kind === 'source')
+                usage.sources.add(p.id);
+            if (p?.kind === 'claim')
+                usage.claims.add(p.id);
+        }
+    }
+    const assetIdByPath = new Map((model.assets?.assets ?? []).map((a) => [a.path, a.id]));
+    for (const e of model.entries) {
+        for (const n of e.nodes) {
+            if (n.kind !== 'markdown')
+                continue;
+            // A Markdown image embeds the asset it points at, so it counts as use of that asset.
+            for (const path of extractImagePaths(n)) {
+                const id = assetIdByPath.get(path);
+                if (id)
+                    usage.assets.add(id);
+            }
+            for (const r of extractInlineRefs(n)) {
+                if (r.kind === 'source')
+                    usage.sources.add(r.id);
+                if (r.kind === 'asset')
+                    usage.assets.add(r.id);
+                if (r.kind === 'claim')
+                    usage.claims.add(r.id);
+            }
+        }
+    }
+    // Claims pull in their sources.
+    for (const c of model.sources?.claims ?? [])
+        if (usage.claims.has(c.id))
+            addEvidence(c.evidence);
+    return usage;
+}
+//# sourceMappingURL=analysis.js.map

package/dist/analysis.js.map

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

package/dist/build.d.ts

@@ -0,0 +1,36 @@
+import { type ArtifactDescriptor, type Diagnostic, type DiagnosticSummary, type Paper, type ValidationMode } from './contracts/index.js';
+import { type ValidationReport } from './validate.js';
+import { allBlocks, type GuideModel } from './model.js';
+export declare const MEDIA_TYPES: Record<string, string>;
+export declare function mediaTypeFor(path: string): string;
+export interface ResolvedBuildOptions {
+    mode: ValidationMode;
+    formats: ('html' | 'pdf')[];
+    paper: Paper[];
+    audience: 'private' | 'public';
+    zip: boolean;
+    allowPartial: boolean;
+}
+export interface ArtifactBuildOptions extends ResolvedBuildOptions {
+    browserPath?: string;
+    signal?: AbortSignal;
+}
+export interface ArtifactBuild {
+    ok: boolean;
+    status: 'succeeded' | 'partial' | 'failed';
+    complete: boolean;
+    visibility: 'private' | 'public';
+    report: ValidationReport;
+    diagnostics: Diagnostic[];
+    summary: DiagnosticSummary;
+    /** Staged files keyed by output-relative path. Empty when the build failed. */
+    files: Map<string, Uint8Array>;
+    artifacts: ArtifactDescriptor[];
+}
+/** Render every output for one normalized guide revision, in memory. Nothing is executed or fetched. */
+export declare function buildArtifacts(model: GuideModel, options: ArtifactBuildOptions): Promise<ArtifactBuild>;
+/** Stage outputs next to the target, then swap in. A failure leaves any existing output intact. */
+export declare function deliverFiles(outDir: string, files: Map<string, Uint8Array>, overwrite: boolean): Promise<Diagnostic | undefined>;
+export declare function listDir(dir: string): Promise<string[]>;
+export { allBlocks };
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,KAAK,EACV,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAgC,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,SAAS,EAAc,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AASpE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqB9C,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC;IAC5B,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,+EAA+E;IAC/E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC/B,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAgBD,wGAAwG;AACxG,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAuJ7G;AAaD,mGAAmG;AACnG,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9B,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAyCjC;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE5D;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/build.js

@@ -0,0 +1,260 @@
+import { randomBytes } from 'node:crypto';
+import { mkdir, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import JSZip from 'jszip';
+import { artifactIdForPath, summarizeDiagnostics, sortDiagnostics, } from './contracts/index.js';
+import { computeUsage } from './analysis.js';
+import { exampleBlocks, validateModel } from './validate.js';
+import { allBlocks, guideTitle } from './model.js';
+import { renderPage } from './render/html.js';
+import { buildBriefDocument } from './render/brief.js';
+import { renderBriefJson, renderBriefMarkdown, renderReferenceMarkdown } from './render/markdown-out.js';
+import { renderPdfDocuments } from './render/pdf.js';
+import { canonicalJson, sha256Hex, toBytes } from './util.js';
+import { VERSION } from './version.js';
+import { SCHEMA_VERSION } from './contracts/index.js';
+export const MEDIA_TYPES = {
+    html: 'text/html',
+    md: 'text/markdown',
+    json: 'application/json',
+    pdf: 'application/pdf',
+    zip: 'application/zip',
+    yaml: 'application/yaml',
+    yml: 'application/yaml',
+    txt: 'text/plain',
+    csv: 'text/csv',
+    css: 'text/css',
+    js: 'text/javascript',
+    mjs: 'text/javascript',
+    ts: 'text/plain',
+    sh: 'text/plain',
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    svg: 'image/svg+xml',
+};
+export function mediaTypeFor(path) {
+    const ext = path.split('.').pop()?.toLowerCase() ?? '';
+    return MEDIA_TYPES[ext] ?? 'application/octet-stream';
+}
+function dataUri(mediaType, bytes) {
+    return `data:${mediaType};base64,${Buffer.from(bytes).toString('base64')}`;
+}
+function describe(path, bytes) {
+    return {
+        id: artifactIdForPath(path),
+        path,
+        mediaType: mediaTypeFor(path),
+        size: bytes.length,
+        sha256: sha256Hex(bytes),
+    };
+}
+/** Render every output for one normalized guide revision, in memory. Nothing is executed or fetched. */
+export async function buildArtifacts(model, options) {
+    const report = validateModel(model, { mode: options.mode, audience: options.audience });
+    const failed = (extra = []) => {
+        const diagnostics = sortDiagnostics([...report.diagnostics, ...extra]);
+        return {
+            ok: false,
+            status: 'failed',
+            complete: false,
+            visibility: 'private',
+            report,
+            diagnostics,
+            summary: summarizeDiagnostics(diagnostics),
+            files: new Map(),
+            artifacts: [],
+        };
+    };
+    if (!report.ok || !model.guide)
+        return failed();
+    const draft = options.mode === 'draft';
+    const files = new Map();
+    const put = (path, data) => files.set(path, toBytes(data));
+    const extra = [];
+    const draftNote = `${report.summary.warnings} warning(s) and ${report.summary.infos} note(s) in draft validation.`;
+    const usage = computeUsage(model);
+    /* companions */
+    put('brief.md', renderBriefMarkdown(buildBriefDocument(model)));
+    put('brief.json', renderBriefJson(model));
+    put('operator/reference.md', renderReferenceMarkdown(model));
+    /* assets and fixtures (only what is referenced; public builds only what is public) */
+    for (const asset of model.assets?.assets ?? []) {
+        if (!usage.assets.has(asset.id))
+            continue;
+        if (options.audience === 'public' && (asset.visibility ?? 'private') !== 'public')
+            continue;
+        const bytes = model.files.bytes(asset.path);
+        if (bytes)
+            put(asset.path, bytes);
+    }
+    const fixtureDirs = new Set(exampleBlocks(model)
+        .map(({ block }) => String(block.props.fixture ?? '').replace(/\/$/, ''))
+        .filter(Boolean));
+    for (const p of model.files.paths()) {
+        if (p === 'operator/fixtures/verification.yaml' || [...fixtureDirs].some((d) => p.startsWith(`${d}/`))) {
+            put(p.replace(/^operator\//, ''), model.files.bytes(p));
+        }
+    }
+    /* html */
+    if (options.formats.includes('html')) {
+        put('index.html', renderPage({ model, page: 'human', version: VERSION, audience: options.audience, draft, draftNote }));
+        put('operator/index.html', renderPage({ model, page: 'operator', version: VERSION, audience: options.audience, draft, draftNote }));
+    }
+    /* pdf */
+    let pdfEngine = null;
+    let pdfOk = true;
+    if (options.formats.includes('pdf')) {
+        const assetSrc = (a) => {
+            const b = model.files.bytes(a.path);
+            return b ? dataUri(a.mediaType, b) : undefined;
+        };
+        const html = renderPage({
+            model,
+            page: 'human',
+            version: VERSION,
+            standalone: true,
+            audience: options.audience,
+            draft,
+            draftNote,
+            assetSrc,
+        });
+        const footer = `Operator reference ${model.referenceRevision.slice(7, 19)} \u00B7 guide ${model.guide.guideId} \u00B7 revision ${model.revision.slice(7, 19)}`;
+        const outputs = await renderPdfDocuments(options.paper.map((paper) => ({
+            html,
+            options: { paper, title: guideTitle(model.guide), footer, draft, executablePath: options.browserPath, signal: options.signal },
+        })), options.browserPath);
+        outputs.forEach((o, i) => {
+            extra.push(...o.diagnostics);
+            if (!o.ok || !o.bytes) {
+                pdfOk = false;
+                return;
+            }
+            pdfEngine = o.browser ?? null;
+            const name = options.paper.length > 1 ? `guide.${options.paper[i]}.pdf` : 'guide.pdf';
+            put(name, o.bytes);
+        });
+    }
+    const complete = options.formats.includes('html') && options.formats.includes('pdf') && pdfOk;
+    const hasError = extra.some((d) => d.severity === 'error');
+    if (!pdfOk && !options.allowPartial)
+        return failed(extra);
+    if (hasError && !options.allowPartial)
+        return failed(extra);
+    const diagnostics = sortDiagnostics([...report.diagnostics, ...extra]);
+    const visibility = options.mode === 'release' && options.audience === 'public' && complete ? 'public' : 'private';
+    const base = [...files.entries()].map(([path, bytes]) => describe(path, bytes)).sort((a, b) => (a.path < b.path ? -1 : 1));
+    const manifest = {
+        schemaVersion: SCHEMA_VERSION,
+        guideId: model.guide.guideId,
+        jobId: model.guide.jobId,
+        title: guideTitle(model.guide),
+        locale: model.guide.locale,
+        mode: options.mode,
+        audience: options.audience,
+        visibility,
+        draft,
+        complete,
+        revision: model.revision,
+        referenceRevision: model.referenceRevision,
+        recipe: model.guide.recipe,
+        theme: model.guide.theme,
+        renderers: {
+            'made-easy': VERSION,
+            html: options.formats.includes('html') ? `made-easy-html/${VERSION}` : null,
+            pdf: pdfEngine,
+        },
+        paper: options.formats.includes('pdf') ? options.paper : [],
+        formats: options.formats,
+        diagnostics: summarizeDiagnostics(diagnostics),
+        artifacts: base,
+    };
+    put('manifest.json', `${JSON.stringify(JSON.parse(canonicalJson(manifest)), null, 2)}\n`);
+    if (options.zip) {
+        const zip = new JSZip();
+        const fixed = new Date(Date.UTC(1980, 0, 1));
+        for (const path of [...files.keys()].sort()) {
+            zip.file(path, files.get(path), { date: fixed, createFolders: false, unixPermissions: 0o644 });
+        }
+        const bytes = await zip.generateAsync({ type: 'uint8array', compression: 'DEFLATE', compressionOptions: { level: 9 }, platform: 'UNIX' });
+        put(`${model.guide.guideId}.zip`, bytes);
+    }
+    const artifacts = [...files.entries()].map(([path, bytes]) => describe(path, bytes)).sort((a, b) => (a.path < b.path ? -1 : 1));
+    const status = complete ? 'succeeded' : 'partial';
+    return {
+        ok: complete || options.allowPartial,
+        status,
+        complete,
+        visibility,
+        report,
+        diagnostics,
+        summary: summarizeDiagnostics(diagnostics),
+        files,
+        artifacts,
+    };
+}
+/* ------------------------------ delivery ------------------------------ */
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Stage outputs next to the target, then swap in. A failure leaves any existing output intact. */
+export async function deliverFiles(outDir, files, overwrite) {
+    const target = resolve(outDir);
+    if (await exists(target)) {
+        if (!overwrite) {
+            return {
+                code: 'OUTPUT_EXISTS',
+                severity: 'error',
+                path: outDir,
+                message: `${outDir} already exists. Pass --overwrite (overwrite: true) to replace it.`,
+            };
+        }
+    }
+    const token = randomBytes(4).toString('hex');
+    const staging = `${target}.staging-${token}`;
+    const backup = `${target}.old-${token}`;
+    try {
+        await mkdir(dirname(target), { recursive: true });
+        for (const [rel, bytes] of files) {
+            const abs = join(staging, ...rel.split('/'));
+            await mkdir(dirname(abs), { recursive: true });
+            await writeFile(abs, bytes);
+        }
+        const had = await exists(target);
+        if (had)
+            await rename(target, backup);
+        try {
+            await rename(staging, target);
+        }
+        catch (e) {
+            if (had)
+                await rename(backup, target);
+            throw e;
+        }
+        if (had)
+            await rm(backup, { recursive: true, force: true });
+        return undefined;
+    }
+    catch (e) {
+        await rm(staging, { recursive: true, force: true }).catch(() => undefined);
+        return {
+            code: 'OUTPUT_FAILED',
+            severity: 'error',
+            path: outDir,
+            message: `Could not deliver the build to ${outDir}: ${e.message}. Any existing output was left in place.`,
+        };
+    }
+}
+export async function listDir(dir) {
+    return readdir(dir).catch(() => []);
+}
+export { allBlocks };
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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