@bestagentkits/render 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
+this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+Release mechanics and the compatibility contract live in
+[docs/release-policy.md](./docs/release-policy.md).
+
+## [Unreleased]
+
+### Added
+
+- Repository baseline for the public AK Render package: MIT license,
+  contribution guide, security policy, release policy, and CI covering lint,
+  typecheck, unit tests, browser tests, build, and package smoke.
+- TypeScript ESM package skeleton targeting Node >= 20.11, with a library entry
+  point, an `ak-render` CLI bin, and a `pack`/install smoke test that exercises
+  both surfaces from a throwaway consumer project.
+- Architecture decision record
+  ([ADR 0001](./docs/adr/0001-page-spec-compiler-boundary.md)) fixing the Page
+  Spec versus internal IR split, catalog/registry separation, trusted
+  interaction runtime, theme trust model, local/cloud boundary, and the
+  optional AgentKit adapter model.
+- Fixture corpus representing the plan, explain, recap, diff, dashboard, media,
+  and interactive page classes.
+- Reproducible baseline measurement of the legacy HTML presentation guidance
+  currently carried in agent model context, with captured results under
+  [docs/artifacts/](./docs/artifacts/).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentKit
+
+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

@@ -0,0 +1,166 @@
+# @bestagentkits/render
+
+Declarative page compiler for AgentKit: a constrained JSON/YAML **Page Spec**
+in, a deterministic, self-contained, interactive **standalone HTML** out.
+
+Agents describe meaning and composition. The compiler owns HTML, CSS,
+interaction, accessibility, responsive layout, theming, asset bundling, security
+policy, and byte-for-byte determinism.
+
+```bash
+npx @bestagentkits/render page.yaml --out page.html
+```
+
+The emitted file opens directly from disk (`file://`) and makes zero network
+requests by default. The local compiler is canonical: no account, no network, no
+server.
+
+> **Status:** pre-1.0, in active construction. This repository is being built in
+> milestones. The package skeleton, ADR, CI, and fixture corpus exist; the
+> schema, compiler, themes, runtime, catalog, and cloud service land in the
+> milestones described in [docs/adr/0001-page-spec-compiler-boundary.md](./docs/adr/0001-page-spec-compiler-boundary.md)
+> and the [changelog](./CHANGELOG.md). Nothing below is advertised as available
+> before it exists.
+
+## Why
+
+AgentKit's HTML-producing skills each carried the presentation layer in model
+context: layout, CSS, JavaScript, charts, responsive rules, theming, and
+verification. That costs tokens, adds latency, invites retries after
+HTML/CSS/JS mistakes, and lets skills drift against each other.
+
+`ak:diagram` already proved the alternative for diagrams: typed IR, deterministic
+compiler, trusted fragment boundary. AK Render applies the same pattern to whole
+pages.
+
+## Design in one screen
+
+```text
+Page Spec (JSON/YAML, authored by a model)
+   |  parse -> validate -> normalize
+   v
+internal IR (flat nodes, stable content-derived IDs)
+   |  resolve registry -> resolve theme -> render
+   v
+single self-contained HTML document
+   |  collect used assets/runtime features -> assemble -> verify
+   v
+deterministic artifact (opens from file://, zero network by default)
+```
+
+Six decisions define the boundary, argued in
+[ADR 0001](./docs/adr/0001-page-spec-compiler-boundary.md):
+
+1. **Page Spec is authoring; the IR is compiler-internal.** The nested,
+   model-friendly spec normalizes into a flat node graph with stable IDs for
+   rendering, future diff/patch/editor tooling, and MCP surfaces.
+2. **Catalog and registry are separate.** `catalog()` is compact and cheap;
+   `describe(type)` carries the full contract. Discovery stays out of the token
+   budget until a block is actually selected.
+3. **The interaction runtime is trusted and declarative.** A closed action
+   vocabulary, one small event-delegation script, native HTML controls first,
+   and only the feature modules a page uses.
+4. **Themes are typed data, never CSS.** Built-in presets plus user presets that
+   `extends` them. No CSS escape hatch, no CDN fonts.
+5. **Local is canonical; cloud is opt-in.** The hosted renderer reuses the same
+   compiler and is never the source of truth.
+6. **Optional capabilities arrive as adapters.** Diagrams delegate to the
+   existing `ak:diagram` compiler where installed; the public package never
+   copies paid or Engineer-only implementation.
+
+## Install
+
+```bash
+pnpm add @bestagentkits/render
+# or run without installing
+npx @bestagentkits/render --help
+```
+
+Requires Node.js >= 20.11.
+
+## Library API
+
+```ts
+import {
+  render,
+  validate,
+  normalize,
+  catalog,
+  describe,
+  loadTheme,
+} from '@bestagentkits/render';
+```
+
+| Export | Purpose | Status |
+| --- | --- | --- |
+| `VERSION` | Package version, matching `package.json` | Available |
+| `RenderError`, `isRenderError` | Stable error codes with JSON path and node ID | Available |
+| `render(spec, options)` | Compile a spec to a standalone HTML artifact | Available |
+| `validate(spec)` | Report spec diagnostics without rendering | Available |
+| `normalize(spec)` | Produce the flat internal IR | Available |
+| `catalog()` | Compact list of available blocks and actions | Available |
+| `describe(type)` | Full machine-readable contract for one entry | Available |
+| `loadTheme(input)` | Validate and resolve a theme preset | Available |
+| `buildThemeCatalog(options)` | Discover built-in, user, project, and explicit presets | Available |
+
+## CLI
+
+```bash
+ak-render page.yaml --out page.html
+ak-render validate page.json
+ak-render catalog
+ak-render describe carousel
+ak-render themes
+
+ak-render --help
+ak-render --version
+```
+
+The CLI only advertises commands it can actually run; the compiler subcommands
+are registered by the milestones that implement them.
+
+## Fixtures and snapshots
+
+`fixtures/pages/` holds the representative corpus the compiler is built
+against: plan, explain, recap, diff, dashboard, media, interactive, and theme
+showcase pages. `fixtures/snapshots/` holds one committed artifact per built-in
+preset. See [fixtures/README.md](./fixtures/README.md) and
+[docs/themes.md](./docs/themes.md). Fixtures are the specification: a new
+capability is not done until a fixture exercises it.
+
+## Repository layout
+
+| Path | Contents |
+| --- | --- |
+| `src/` | Library and CLI source |
+| `tests/unit/` | Vitest unit and contract tests |
+| `tests/browser/` | Playwright browser tests, including the zero-network audit |
+| `fixtures/` | Representative Page Spec corpus and committed cross-preset snapshots |
+| `benchmarks/` | Reproducible measurement harnesses |
+| `docs/adr/` | Architecture decision records |
+| `docs/artifacts/` | Captured measurements and evidence |
+| `apps/cloud/` | Opt-in Cloudflare renderer (cloud milestone) |
+
+## Development
+
+```bash
+pnpm install
+pnpm verify          # lint + typecheck + unit tests + build
+pnpm test:browser    # Playwright, after: pnpm exec playwright install chromium
+pnpm test:package    # pack, install into a temp project, exercise API and bin
+pnpm bench:baseline  # re-run the legacy presentation-context measurement
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the determinism, trust, and testing
+rules that changes are reviewed against, and
+[docs/release-policy.md](./docs/release-policy.md) for versioning.
+
+## Security
+
+Spec input is untrusted. Report vulnerabilities privately through GitHub's
+security advisory flow; see [SECURITY.md](./SECURITY.md) for the threat model and
+the invariants the compiler must hold.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * `ak-render` command-line entry point.
+ *
+ * Help output is generated from the command table, so a command that is not
+ * implemented cannot be advertised. Every command supports `--json` for
+ * scripted and CI use, and never prompts.
+ *
+ * `ak-render <spec> [--out <file>]` is the documented primary surface; naming a
+ * known command is optional.
+ */
+export interface CliIo {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+}
+/** Run the CLI. Returns the process exit code. */
+export declare function run(argv: readonly string[], io?: CliIo): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAYH,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAsTD,kDAAkD;AAClD,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,KAAiB,GAAG,MAAM,CAwC1E"}

package/dist/cli.js

@@ -0,0 +1,336 @@
+#!/usr/bin/env node
+/**
+ * `ak-render` command-line entry point.
+ *
+ * Help output is generated from the command table, so a command that is not
+ * implemented cannot be advertised. Every command supports `--json` for
+ * scripted and CI use, and never prompts.
+ *
+ * `ak-render <spec> [--out <file>]` is the documented primary surface; naming a
+ * known command is optional.
+ */
+import { readFileSync, realpathSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { isRenderError } from './errors.js';
+import { catalog, describe } from './registry/registry.js';
+import { compile } from './render/render.js';
+import { validate } from './spec/validate.js';
+import { buildThemeCatalog } from './theme/theme-catalog.js';
+import { PACKAGE_NAME, VERSION } from './version.js';
+const defaultIo = {
+    stdout: (text) => process.stdout.write(text),
+    stderr: (text) => process.stderr.write(text),
+};
+function readSpecFile(path, io) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch (error) {
+        io.stderr(`ak-render: cannot read ${path}: ${error instanceof Error ? error.message : String(error)}\n`);
+        return undefined;
+    }
+}
+function reportDiagnostics(io, diagnostics) {
+    for (const diagnostic of diagnostics) {
+        const location = diagnostic.nodeId === undefined ? '' : ` [${diagnostic.nodeId}]`;
+        io.stderr(`${diagnostic.severity}: ${diagnostic.path}${location}: ${diagnostic.message}\n`);
+    }
+}
+function compileCommand(args, io, flags) {
+    const file = args[0];
+    if (file === undefined) {
+        io.stderr('ak-render: a spec path is required\n');
+        return 2;
+    }
+    const text = readSpecFile(file, io);
+    if (text === undefined)
+        return 2;
+    try {
+        const result = compile(text, {
+            source: file,
+            themeCatalog: themeCatalogFor(flags, io),
+            ...(flags.theme === undefined ? {} : { theme: flags.theme }),
+        });
+        if (flags.out !== undefined) {
+            writeFileSync(flags.out, result.html, 'utf8');
+        }
+        else {
+            io.stdout(result.html);
+            // Human-readable summary goes to stderr so stdout stays a clean artifact.
+            if (!flags.json) {
+                io.stderr(`ak-render: ${result.bytes} bytes, ${result.features.length} runtime features, hash ${result.hash}\n`);
+            }
+        }
+        if (flags.json) {
+            io.stdout(`${JSON.stringify({
+                source: file,
+                out: flags.out ?? null,
+                bytes: result.bytes,
+                hash: result.hash,
+                title: result.ir.meta.title,
+                theme: result.theme.name,
+                themeBase: result.theme.base,
+                themeChain: result.theme.chain,
+                features: result.features,
+                nodes: result.ir.nodes.length,
+                warnings: result.warnings,
+            }, null, 2)}\n`);
+        }
+        else if (flags.out !== undefined) {
+            io.stdout(`wrote ${result.bytes} bytes to ${flags.out} (${result.features.length} runtime features, hash ${result.hash})\n`);
+        }
+        for (const warning of result.warnings) {
+            io.stderr(`warning: ${warning.path}: ${warning.message}\n`);
+        }
+        return 0;
+    }
+    catch (error) {
+        if (isRenderError(error)) {
+            const renderError = error;
+            io.stderr(`ak-render: ${renderError.message} (${renderError.path ?? '$'})\n`);
+            const diagnostics = renderError.details?.diagnostics;
+            if (Array.isArray(diagnostics)) {
+                reportDiagnostics(io, diagnostics);
+            }
+            return 1;
+        }
+        throw error;
+    }
+}
+const COMMANDS = {
+    compile: {
+        summary: 'Compile a Page Spec to a standalone HTML artifact.',
+        usage: 'ak-render <spec.yaml|spec.json> [--out <file.html>] [--theme <preset>] [--json]',
+        run: compileCommand,
+    },
+    validate: {
+        summary: 'Validate a Page Spec without rendering it.',
+        usage: 'ak-render validate <spec.yaml|spec.json> [--json]',
+        run: (args, io, flags) => {
+            const file = args[0];
+            if (file === undefined) {
+                io.stderr('ak-render: validate requires a spec path\n');
+                return 2;
+            }
+            const text = readSpecFile(file, io);
+            if (text === undefined)
+                return 2;
+            const result = validate(text, { source: file });
+            if (flags.json) {
+                io.stdout(`${JSON.stringify(result, null, 2)}\n`);
+            }
+            else if (result.ok) {
+                const { summary } = result;
+                io.stdout(`ok: ${file}\n  title: ${summary.title}\n  theme: ${summary.themePreset}\n  blocks: ${summary.blocks} (nodes: ${summary.nodes})\n  depth: ${summary.depth}, bytes: ${summary.bytes}\n`);
+            }
+            else {
+                reportDiagnostics(io, result.diagnostics);
+            }
+            if (!flags.json) {
+                for (const warning of result.diagnostics.filter((item) => item.severity === 'warning')) {
+                    io.stderr(`warning: ${warning.path}: ${warning.message}\n`);
+                }
+            }
+            return result.ok ? 0 : 1;
+        },
+    },
+    catalog: {
+        summary: 'List available blocks and actions (compact).',
+        usage: 'ak-render catalog [--json]',
+        run: (_args, io, flags) => {
+            const listing = catalog();
+            if (flags.json) {
+                io.stdout(`${JSON.stringify(listing, null, 2)}\n`);
+                return 0;
+            }
+            io.stdout(`Page Spec v${listing.schemaVersion} — ${listing.blockCount} blocks\n\n`);
+            for (const entry of listing.blocks) {
+                io.stdout(`${entry.type.padEnd(16)} ${entry.kind.padEnd(10)} ${entry.summary}\n`);
+            }
+            io.stdout(`\nActions: ${listing.actions.map((action) => action.type).join(', ')}\n`);
+            return 0;
+        },
+    },
+    describe: {
+        summary: 'Show the full machine-readable contract for one block type.',
+        usage: 'ak-render describe <type> [--json]',
+        run: (args, io, flags) => {
+            const type = args[0];
+            if (type === undefined) {
+                io.stderr('ak-render: describe requires a block type\n');
+                return 2;
+            }
+            let contract;
+            try {
+                contract = describe(type);
+            }
+            catch (error) {
+                if (isRenderError(error)) {
+                    io.stderr(`ak-render: ${error.message}\n`);
+                    return 1;
+                }
+                throw error;
+            }
+            if (flags.json) {
+                io.stdout(`${JSON.stringify(contract, null, 2)}\n`);
+                return 0;
+            }
+            io.stdout(`${contract.type} (${contract.kind}, v${contract.version})\n\n`);
+            io.stdout(`purpose:  ${contract.purpose}\n`);
+            io.stdout(`summary:  ${contract.summary}\n`);
+            io.stdout(`props:    ${Object.keys(contract.props).join(', ') || '(none)'}\n`);
+            io.stdout(`actions:  ${contract.actions.join(', ') || '(none)'}\n`);
+            io.stdout(`features: ${contract.runtimeFeatures.join(', ') || '(none)'}\n`);
+            io.stdout(`network:  ${contract.network}\n`);
+            io.stdout(`sizes:    ${contract.sizing.sizes.join(', ')} (default: ${contract.sizing.default})\n`);
+            io.stdout(`a11y:     ${contract.a11y}\n`);
+            return 0;
+        },
+    },
+    themes: {
+        summary: 'List available theme presets, including discovered project or user presets.',
+        usage: 'ak-render themes [--theme-file <file>] [--no-theme-discovery] [--json]',
+        run: (_args, io, flags) => {
+            const catalog = themeCatalogFor(flags, io);
+            const names = Object.keys(catalog.entries).sort();
+            if (flags.json) {
+                io.stdout(`${JSON.stringify(catalog.sources.sort((a, b) => (a.name < b.name ? -1 : 1)), null, 2)}\n`);
+                return 0;
+            }
+            for (const name of names) {
+                const source = catalog.sources.find((entry) => entry.name === name);
+                const origin = source?.origin ?? 'built-in';
+                const file = source?.file;
+                io.stdout(`${name.padEnd(16)} ${origin}${file === undefined ? '' : ` (${file})`}\n`);
+            }
+            return 0;
+        },
+    },
+};
+function helpText() {
+    const usage = Object.values(COMMANDS)
+        .map((command) => `  ${command.usage}`)
+        .join('\n');
+    const summaries = Object.entries(COMMANDS)
+        .map(([name, command]) => `  ${name.padEnd(10)} ${command.summary}`)
+        .join('\n');
+    return `${PACKAGE_NAME} ${VERSION}
+
+Deterministic, offline compiler from a declarative Page Spec (JSON/YAML) to a
+self-contained interactive HTML artifact. The local compiler is canonical: no
+account, no network, no server.
+
+Usage:
+${usage}
+  ak-render --help
+  ak-render --version
+
+Commands:
+${summaries}
+
+The first positional argument may be a spec path with the compile command
+implied. All commands accept --json and never prompt.
+`;
+}
+const VALUE_FLAGS = ['--out', '--theme', '--theme-file'];
+/** Build the preset catalog for this invocation from flags and discovery. */
+function themeCatalogFor(flags, io) {
+    const catalog = buildThemeCatalog({
+        cwd: process.cwd(),
+        home: homedir(),
+        ...(flags.themeFile === undefined ? {} : { files: [flags.themeFile] }),
+        discovery: flags.themeDiscovery,
+    });
+    for (const problem of catalog.problems) {
+        io.stderr(`warning: ${problem.path}: ${problem.message}\n`);
+    }
+    return catalog;
+}
+function parseArgs(args) {
+    const flags = { json: false, themeDiscovery: true };
+    const positional = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined)
+            continue;
+        if (arg === '--json') {
+            flags.json = true;
+            continue;
+        }
+        if (arg === '--no-theme-discovery') {
+            flags.themeDiscovery = false;
+            continue;
+        }
+        const valueFlag = VALUE_FLAGS.find((candidate) => candidate === arg);
+        if (valueFlag !== undefined) {
+            const value = args[index + 1];
+            if (value === undefined)
+                return { error: `${valueFlag} requires a value` };
+            if (valueFlag === '--out')
+                flags.out = value;
+            else if (valueFlag === '--theme')
+                flags.theme = value;
+            else
+                flags.themeFile = value;
+            index += 1;
+            continue;
+        }
+        positional.push(arg);
+    }
+    return { flags, positional };
+}
+/** Run the CLI. Returns the process exit code. */
+export function run(argv, io = defaultIo) {
+    const args = argv.filter((arg) => arg !== '');
+    const first = args[0];
+    if (args.length === 0) {
+        io.stdout(helpText());
+        return 2;
+    }
+    if (first === '--help' || first === '-h' || first === 'help') {
+        io.stdout(helpText());
+        return 0;
+    }
+    if (first === '--version' || first === '-v' || first === 'version') {
+        io.stdout(`${VERSION}\n`);
+        return 0;
+    }
+    const parsed = parseArgs(args.slice(1));
+    if ('error' in parsed) {
+        io.stderr(`ak-render: ${parsed.error}\n`);
+        return 2;
+    }
+    // `ak-render page.yaml --out page.html` is the documented primary surface.
+    const command = first === undefined ? undefined : COMMANDS[first];
+    const resolved = command ?? COMMANDS.compile;
+    const positional = command === undefined && first !== undefined
+        ? [first, ...parsed.positional]
+        : parsed.positional;
+    try {
+        return resolved === undefined ? 2 : resolved.run(positional, io, parsed.flags);
+    }
+    catch (error) {
+        if (isRenderError(error)) {
+            io.stderr(`ak-render: ${error.message}\n`);
+            return 1;
+        }
+        throw error;
+    }
+}
+/** True when this module is the process entry point (npm bin symlinks included). */
+function isMainModule() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    try {
+        return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainModule()) {
+    process.exitCode = run(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Diagnostics: how the compiler reports everything it found wrong.
+ *
+ * A diagnostic always carries a JSON path into the author-facing spec, and a
+ * node ID when the failure belongs to a node that already has one. Callers
+ * branch on `code`; `message` is for humans and may be reworded between
+ * releases.
+ */
+import type { RenderErrorCode } from './errors.js';
+export type DiagnosticSeverity = 'error' | 'warning';
+export interface Diagnostic {
+    code: RenderErrorCode;
+    severity: DiagnosticSeverity;
+    message: string;
+    /** JSON path in the author-facing spec, e.g. `blocks[2].items[0].url`. */
+    path: string;
+    /** Normalized node ID, when the diagnostic belongs to a node. */
+    nodeId?: string;
+    details?: Record<string, unknown>;
+}
+export interface DiagnosticInput {
+    code: RenderErrorCode;
+    message: string;
+    path: string;
+    severity?: DiagnosticSeverity;
+    nodeId?: string;
+    details?: Record<string, unknown>;
+}
+/** Ordered, de-duplicating collector for diagnostics. */
+export declare class DiagnosticBag {
+    private readonly items;
+    private readonly seen;
+    add(input: DiagnosticInput): void;
+    get size(): number;
+    get errorCount(): number;
+    get hasErrors(): boolean;
+    list(): Diagnostic[];
+    errors(): Diagnostic[];
+    warnings(): Diagnostic[];
+}
+/** Append an index or key to a JSON path. */
+export declare function pathKey(base: string, key: string): string;
+/** Append an array index to a JSON path. */
+export declare function pathIndex(base: string, index: number): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,yDAAyD;AACzD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAE1C,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAejC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,IAAI,UAAU,EAAE;IAIpB,MAAM,IAAI,UAAU,EAAE;IAItB,QAAQ,IAAI,UAAU,EAAE;CAGzB;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D"}