c64-kb 0.17.0

package/dist/graph/extract/recipe.js

@@ -0,0 +1,71 @@
+/** recipe pages (docs/CONVENTIONS-recipes.md): frontmatter lists plus load addresses read from the listing. */
+import { group, parseFrontmatter } from "./common.js";
+// Recipe listings declare where they load: KickAssembler `* = $0900`,
+// Oscar64 `#pragma region( name, 0x0a00, 0x1000, ...)`, ca65 `.org $0801`.
+const KICK_ORIGIN = /^\s*\*\s*=\s*\$([0-9A-Fa-f]{4})\b/gm;
+const CA65_ORIGIN = /^\s*\.org\s+\$([0-9A-Fa-f]{4})\b/gm;
+const OSCAR_REGION = /#pragma\s+region\s*\(\s*\w+\s*,\s*0x([0-9A-Fa-f]+)\s*,\s*0x([0-9A-Fa-f]+)/g;
+/** A YAML flow-style list, "[A, B, C]" or "[]"; absent reads as empty. */
+function parseArray(v) {
+    if (!v)
+        return [];
+    const inner = v.replace(/^\[/, "").replace(/\]$/, "").trim();
+    if (!inner)
+        return [];
+    return inner
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/** Load addresses from the listing itself -> OCCUPIES edges to the MemoryRegion nodes they fall in. */
+function occupiesEntities(content, recipe) {
+    const ranges = [];
+    for (const m of content.matchAll(KICK_ORIGIN))
+        ranges.push([parseInt(group(m, 1), 16), parseInt(group(m, 1), 16)]);
+    for (const m of content.matchAll(CA65_ORIGIN))
+        ranges.push([parseInt(group(m, 1), 16), parseInt(group(m, 1), 16)]);
+    for (const m of content.matchAll(OSCAR_REGION))
+        ranges.push([parseInt(group(m, 1), 16), parseInt(group(m, 2), 16) - 1]);
+    const seen = new Set();
+    const entities = [];
+    for (const [start, end] of ranges) {
+        const key = `${start}:${end}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        entities.push({ type: "recipe_occupies", recipe, start, end });
+    }
+    return entities;
+}
+export function parseRecipeDoc(content, sourcePath) {
+    const { fm } = parseFrontmatter(content);
+    if (!fm.recipe || !fm.toolchain || !fm.output_format || !fm.region)
+        return [];
+    // Canonical recipe name: <toolchain>-<recipe>
+    const name = `${fm.toolchain}-${fm.recipe}`;
+    const techniques = parseArray(fm.techniques);
+    const file_formats = parseArray(fm.file_formats);
+    // scaffolds: Archetype names this recipe is a starting point for
+    // (docs/CONVENTIONS-recipes.md). Optional; absent reads as empty.
+    const scaffolds = parseArray(fm.scaffolds);
+    return [
+        {
+            type: "recipe",
+            name,
+            toolchain: fm.toolchain,
+            output_format: fm.output_format,
+            region: fm.region,
+            techniques,
+            file_formats,
+            uses_registers: parseArray(fm.uses_registers),
+            uses_kernal: parseArray(fm.uses_kernal),
+            scaffolds,
+            source_doc: sourcePath,
+        },
+        ...techniques.map((technique) => ({ type: "implements", recipe: name, technique })),
+        ...scaffolds.map((archetype) => ({ type: "scaffolds", recipe: name, archetype })),
+        ...file_formats.map((format) => ({ type: "produces_format", recipe: name, format })),
+        ...occupiesEntities(content, name),
+    ];
+}
+//# sourceMappingURL=recipe.js.map

package/dist/graph/extract/recipe.js.map

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

package/dist/graph/extract/technique-entities.js

@@ -0,0 +1,180 @@
+/**
+ * Turn one finished technique section (its H2 plus the metadata lines read
+ * under it) into the Technique entity and its edges, refusing any word
+ * outside the vocabularies with a warning.
+ */
+import { CLAIMS_BASIS_WORDS, isClaimsBasis } from "../claims.js";
+import { warn } from "./common.js";
+import { COST_BASIS_WORDS, DEMAND_VOCABULARY, isCostBasis, vocabularyEntry, } from "./vocabulary.js";
+export const TECHNIQUE_NAME = /^[a-z][a-z0-9_]*$/;
+// `<toolchain>-<recipe>` with an optional trailing `(conditions)`.
+const MEASURED_ON = /^`?([a-z0-9]+-[a-z0-9][a-z0-9-]*)`?(?:\s+\(([^()]+)\))?\s*$/;
+/** A typical figure is only meaningful beside the worst one, and never above it. */
+function checkedTypical(cost, where) {
+    const typical = cost.cycles_per_frame_typical;
+    if (typical === undefined)
+        return cost;
+    const worst = cost.cycles_per_frame;
+    if (worst !== undefined && typical <= worst)
+        return cost;
+    warn(worst === undefined
+        ? `${where} has cycles_per_frame_typical without cycles_per_frame — typical figure skipped (see CONVENTIONS-techniques.md)`
+        : `${where} has cycles_per_frame_typical=${typical} above cycles_per_frame=${worst} — typical figure skipped`);
+    const rest = { ...cost };
+    delete rest.cycles_per_frame_typical;
+    return rest;
+}
+/** The recipe and conditions of a **Cost measured on:** line, or {} (with a warning) when refused. */
+function measuredOn(value, where) {
+    if (value === undefined)
+        return {};
+    const m = MEASURED_ON.exec(value);
+    const recipe = m?.at(1);
+    if (!recipe) {
+        warn(`${where} has **Cost measured on:** ${JSON.stringify(value)}, which is not a recipe name (toolchain-recipe) with optional (conditions) — not ingested (see CONVENTIONS-techniques.md)`);
+        return {};
+    }
+    const conditions = m?.at(2)?.trim();
+    return { cost_recipe: recipe, ...(conditions ? { cost_conditions: conditions } : {}) };
+}
+/** Technique names from a **Cost includes:** line; a malformed name or the technique itself is refused. */
+function includedTechniques(names, head, where) {
+    const out = [];
+    for (const n of names ?? []) {
+        if (!TECHNIQUE_NAME.test(n)) {
+            warn(`${where} has **Cost includes:** "${n}", which is not a snake_case technique name — not ingested`);
+        }
+        else if (n === head.name) {
+            warn(`${where} lists itself under **Cost includes:** — not ingested`);
+        }
+        else if (!out.includes(n))
+            out.push(n);
+    }
+    return out;
+}
+/**
+ * Cost rides the technique entity itself, not an edge, so it is settled
+ * before the push. A Cost line without an honest basis is dropped whole,
+ * and its measured-on and includes lines with it.
+ */
+function settledCost({ head, meta, sourcePath }) {
+    const where = `${sourcePath}: technique ${head.name}`;
+    if (meta.cost === undefined) {
+        if (meta.costBasis !== undefined)
+            warn(`${where} has a **Cost basis:** line but no **Cost:** line — ignored`);
+        if (meta.costMeasuredOn !== undefined || meta.costIncludes !== undefined)
+            warn(`${where} has a **Cost measured on:** or **Cost includes:** line but no **Cost:** line — ignored`);
+        return null;
+    }
+    const basis = meta.costBasis;
+    if (basis === undefined) {
+        warn(`${where} has a **Cost:** line but no **Cost basis:** line — Cost not ingested (see CONVENTIONS-techniques.md)`);
+        return null;
+    }
+    if (!isCostBasis(basis)) {
+        warn(`${where} has cost basis "${basis}", which is not one of ${COST_BASIS_WORDS.join(", ")} — Cost not ingested (see CONVENTIONS-techniques.md)`);
+        return null;
+    }
+    const cost = checkedTypical(meta.cost, where);
+    if (Object.keys(cost).length === 0) {
+        warn(`${where} has a **Cost:** line with no usable pair — Cost not ingested`);
+        return null;
+    }
+    const includes = includedTechniques(meta.costIncludes, head, where);
+    return {
+        cost,
+        cost_basis: basis,
+        ...measuredOn(meta.costMeasuredOn, where),
+        ...(includes.length > 0 ? { cost_includes: includes } : {}),
+    };
+}
+/**
+ * Claims ride edges, but whether the page states them rides the node:
+ * "stated", "none", or absent (unknown). A line refused for its grammar, or
+ * with no usable basis, leaves the technique unknown.
+ */
+function settledClaims({ head, meta, sourcePath }) {
+    const where = `${sourcePath}: technique ${head.name}`;
+    if (meta.claims === undefined) {
+        if (meta.claimsBasis !== undefined && !meta.claimsRefused)
+            warn(`${where} has a **Claims basis:** line but no **Claims:** line — ignored`);
+        return null;
+    }
+    const basis = meta.claimsBasis;
+    if (basis === undefined) {
+        warn(`${where} has a **Claims:** line but no **Claims basis:** line — Claims not ingested, so its claims read as unknown (see CONVENTIONS-techniques.md)`);
+        return null;
+    }
+    if (!isClaimsBasis(basis)) {
+        warn(`${where} has claims basis "${basis}", which is not one of ${CLAIMS_BASIS_WORDS.join(", ")} — Claims not ingested (see CONVENTIONS-techniques.md)`);
+        return null;
+    }
+    return { claims: meta.claims, basis };
+}
+function demandEntities({ head, meta, sourcePath }) {
+    const out = [];
+    for (const d of meta.demands ?? []) {
+        const description = vocabularyEntry(DEMAND_VOCABULARY, d);
+        if (description === undefined) {
+            warn(`${sourcePath}: technique ${head.name} demands unknown resource "${d}" — not ingested (see CONVENTIONS-techniques.md)`);
+            continue;
+        }
+        out.push({ type: "technique_demands", technique: head.name, resource: d, description });
+    }
+    return out;
+}
+function requiresEntities({ head, meta, sourcePath }) {
+    const out = [];
+    const seen = new Set();
+    for (const r of meta.requires ?? []) {
+        if (!TECHNIQUE_NAME.test(r)) {
+            warn(`${sourcePath}: technique ${head.name} requires "${r}", which is not a snake_case technique name — not ingested (see CONVENTIONS-techniques.md)`);
+            continue;
+        }
+        if (r === head.name) {
+            warn(`${sourcePath}: technique ${head.name} lists itself under **Requires:** — not ingested`);
+            continue;
+        }
+        if (seen.has(r))
+            continue;
+        seen.add(r);
+        out.push({ type: "technique_requires", technique: head.name, requires: r });
+    }
+    return out;
+}
+export function techniqueEntities(head, meta, sourcePath) {
+    const section = { head, meta, sourcePath };
+    const technique = head.name;
+    const cost = settledCost(section);
+    const claims = settledClaims(section);
+    const out = [
+        {
+            type: "technique",
+            ...head,
+            ...(cost ?? {}),
+            ...(meta.rasterBand !== undefined ? { raster_band: meta.rasterBand } : {}),
+            ...(claims
+                ? {
+                    claims_stated: claims.claims.length > 0 ? "stated" : "none",
+                    claims_basis: claims.basis,
+                }
+                : {}),
+        },
+    ];
+    if (claims) {
+        for (const c of claims.claims)
+            out.push({ type: "claims", owner: technique, ownerKind: "Technique", ...c, basis: claims.basis });
+    }
+    if (head.chip)
+        out.push({ type: "technique_belongs_to", technique, chip: head.chip });
+    out.push(...demandEntities(section), ...requiresEntities(section));
+    if (meta.region && meta.region !== "both") {
+        out.push({ type: "technique_requires_region", technique, region: meta.region });
+    }
+    for (const register of meta.usesReg ?? [])
+        out.push({ type: "technique_uses_register", technique, register });
+    for (const kernal of meta.usesKernal ?? [])
+        out.push({ type: "technique_uses_kernal", technique, kernal });
+    return out;
+}
+//# sourceMappingURL=technique-entities.js.map

package/dist/graph/extract/technique-entities.js.map

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

package/dist/graph/extract/technique.js

@@ -0,0 +1,179 @@
+/**
+ * technique-reference pages (docs/CONVENTIONS-techniques.md). Each
+ * `## name — Title` H2 is one Technique; the bold metadata lines under it
+ * become its properties and edges.
+ */
+import { group, parseFrontmatter, warn } from "./common.js";
+import { parseClaims } from "../claims.js";
+import { parseRasterBand } from "./raster-band.js";
+import { techniqueEntities } from "./technique-entities.js";
+import { COST_MAXIMUM, COST_VOCABULARY, TECHNIQUE_CATEGORIES } from "./vocabulary.js";
+export const ENTITY_H2 = /^##\s+([a-z][a-z0-9_]*)\s+(?:—|--)\s+(.+)$/;
+const COMPLEXITY_LINE = /^\*\*Complexity:\*\*\s+(low|medium|high|scene-tier)\s*$/;
+export const REGION_LINE = /^\*\*Region:\*\*\s+(PAL|NTSC|both)\s*$/im;
+const USES_REGISTERS = /^\*\*Uses registers:\*\*\s+(.+)$/;
+const USES_KERNAL = /^\*\*Uses kernal:\*\*\s+(.+)$/;
+const DEMANDS_LINE = /^\*\*Demands:\*\*\s+(.+)$/;
+// **Requires:** names other Technique H2s that must be set up before, or run
+// underneath, this one. Each word must be a snake_case technique name;
+// whether it names an existing node is settled at link time, where a miss is
+// warned about and counted.
+const REQUIRES_LINE = /^\*\*Requires:\*\*\s+(.+)$/;
+const RASTER_BAND_LINE = /^\*\*Raster band:\*\*\s+(.+)$/;
+// **Cost:** carries key=value pairs from COST_VOCABULARY and **Cost basis:**
+// one word from COST_BASIS_WORDS. A pair with an unknown key or a
+// non-integer value is warned about and skipped; a basis word outside the
+// set, or a Cost line with no basis line at all, drops the whole Cost line,
+// because a number without an honest basis is worse than no number.
+const COST_LINE = /^\*\*Cost:\*\*\s+(.+)$/;
+const COST_BASIS_LINE = /^\*\*Cost basis:\*\*\s+(.+)$/;
+const COST_PAIR = /^([a-z_]+)\s*=\s*(-?\d+)$/;
+// **Cost measured on:** names the recipe the Cost figures were measured on
+// or counted from, with an optional parenthetical of conditions ("screen
+// blanked", "whole PRG"); **Cost includes:** names the techniques whose work
+// is already inside this technique's figure (schema 27). Both belong to the
+// Cost line and are dropped with it.
+const COST_MEASURED_ON_LINE = /^\*\*Cost measured on:\*\*\s+(.+)$/;
+const COST_INCLUDES_LINE = /^\*\*Cost includes:\*\*\s+(.+)$/;
+// **Claims:** names the hardware units the technique holds while it runs,
+// and how; **Claims basis:** says how that was established (schema 25,
+// src/graph/claims.ts). No line means unknown, which is not `none`.
+const CLAIMS_LINE = /^\*\*Claims:\*\*\s+(.+)$/;
+const CLAIMS_BASIS_LINE = /^\*\*Claims basis:\*\*\s+(.+)$/;
+const INTEGER = /^-?\d+$/;
+// Treat "(none)" / "none" / "[]" / "-" as empty so docs can author
+// explicit-empty without leaking sentinel names into the graph.
+function isEmptySentinel(v) {
+    const t = v.trim().toLowerCase();
+    return t === "" || t === "(none)" || t === "none" || t === "[]" || t === "-";
+}
+function nameList(value, stripBackticks = false) {
+    if (isEmptySentinel(value))
+        return [];
+    return value
+        .split(",")
+        .map((s) => (stripBackticks ? s.trim().replace(/`/g, "") : s.trim()))
+        .filter((s) => s !== "" && !isEmptySentinel(s));
+}
+/** One `key=value` Cost pair, or null (with a warning) when it is refused. */
+function costPair(pair, where) {
+    const eq = pair.indexOf("=");
+    const key = (eq >= 0 ? pair.slice(0, eq) : pair).trim();
+    const val = eq >= 0 ? pair.slice(eq + 1).trim() : "";
+    if (!Object.hasOwn(COST_VOCABULARY, key)) {
+        warn(`${where} has cost key "${key}", which is not in the cost vocabulary — pair skipped (see CONVENTIONS-techniques.md)`);
+        return null;
+    }
+    if (!COST_PAIR.test(pair) || !INTEGER.test(val) || Number(val) < 0) {
+        warn(`${where} has cost ${key}=${JSON.stringify(val)}, which is not a non-negative integer — pair skipped (see CONVENTIONS-techniques.md)`);
+        return null;
+    }
+    const ceiling = COST_MAXIMUM[key];
+    if (ceiling !== undefined && Number(val) > ceiling) {
+        warn(`${where} has cost ${key}=${val}, above the hardware maximum of ${ceiling} — pair skipped (see CONVENTIONS-techniques.md)`);
+        return null;
+    }
+    return [key, Number(val)];
+}
+function parseCost(value, where) {
+    const cost = {};
+    const pairs = isEmptySentinel(value)
+        ? []
+        : value
+            .split(",")
+            .map((s) => s.trim().replace(/`/g, ""))
+            .filter((s) => s !== "");
+    for (const pair of pairs) {
+        const parsed = costPair(pair, where);
+        if (parsed)
+            cost[parsed[0]] = parsed[1];
+    }
+    return cost;
+}
+function applyRasterBand(value, c) {
+    const band = parseRasterBand(value);
+    if ("error" in band) {
+        warn(`${c.sourcePath}: technique ${c.head.name} has **Raster band:** ${JSON.stringify(value.trim())}: ${band.error} — band not ingested, so the technique conflicts as if it had none (see CONVENTIONS-techniques.md)`);
+    }
+    else {
+        c.meta.rasterBand = band.canonical;
+    }
+}
+/** A Claims line outside the grammar is refused whole: a partial set would read as complete. */
+function applyClaims(value, c) {
+    const parsed = parseClaims(value);
+    if ("error" in parsed) {
+        warn(`${c.sourcePath}: technique ${c.head.name} has **Claims:** ${JSON.stringify(value.trim())}: ${parsed.error} — Claims not ingested, so its claims read as unknown (see CONVENTIONS-techniques.md)`);
+        c.meta.claimsRefused = true;
+    }
+    else {
+        c.meta.claims = parsed;
+    }
+}
+/** Metadata lines under a technique H2, tried in order; the first whose pattern matches handles the line. */
+const LINE_RULES = [
+    { re: COMPLEXITY_LINE, apply: (v, c) => (c.head.complexity = v) },
+    { re: REGION_LINE, apply: (v, c) => (c.meta.region = v) },
+    { re: USES_REGISTERS, apply: (v, c) => (c.meta.usesReg = nameList(v)) },
+    { re: USES_KERNAL, apply: (v, c) => (c.meta.usesKernal = nameList(v)) },
+    { re: DEMANDS_LINE, apply: (v, c) => (c.meta.demands = nameList(v)) },
+    { re: REQUIRES_LINE, apply: (v, c) => (c.meta.requires = nameList(v, true)) },
+    { re: RASTER_BAND_LINE, apply: applyRasterBand },
+    { re: COST_BASIS_LINE, apply: (v, c) => (c.meta.costBasis = v.trim().replace(/`/g, "")) },
+    { re: COST_MEASURED_ON_LINE, apply: (v, c) => (c.meta.costMeasuredOn = v.trim()) },
+    { re: COST_INCLUDES_LINE, apply: (v, c) => (c.meta.costIncludes = nameList(v, true)) },
+    { re: CLAIMS_BASIS_LINE, apply: (v, c) => (c.meta.claimsBasis = v.trim().replace(/`/g, "")) },
+    { re: CLAIMS_LINE, apply: applyClaims },
+    {
+        re: COST_LINE,
+        apply: (v, c) => (c.meta.cost = parseCost(v, `${c.sourcePath}: technique ${c.head.name}`)),
+    },
+];
+function applyLine(line, c) {
+    for (const { re, apply } of LINE_RULES) {
+        const m = re.exec(line);
+        if (m) {
+            apply(group(m, 1), c);
+            return;
+        }
+    }
+}
+/** The category from frontmatter, or null (with a warning when it is outside the ontology). */
+function checkedCategory(category, sourcePath) {
+    if (!category)
+        return null;
+    if (TECHNIQUE_CATEGORIES.has(category))
+        return category;
+    warn(`${sourcePath}: technique doc category "${category}" is not in the ontology's category set — no techniques ingested from this file (see CONVENTIONS-techniques.md)`);
+    return null;
+}
+export function parseTechniqueDoc(content, sourcePath) {
+    const { fm, rest } = parseFrontmatter(content);
+    const category = checkedCategory(fm.category, sourcePath);
+    if (category === null)
+        return [];
+    const docChip = fm.chip;
+    const entities = [];
+    let current = null;
+    const flush = () => {
+        if (current)
+            entities.push(...techniqueEntities(current.head, current.meta, sourcePath));
+        current = null;
+    };
+    for (const line of rest.split("\n")) {
+        const h2 = ENTITY_H2.exec(line);
+        if (h2) {
+            flush();
+            const head = { name: group(h2, 1), title: group(h2, 2).trim(), category };
+            if (docChip !== undefined)
+                head.chip = docChip;
+            current = { head, meta: {}, sourcePath };
+        }
+        else if (current) {
+            applyLine(line, current);
+        }
+    }
+    flush();
+    return entities;
+}
+//# sourceMappingURL=technique.js.map

package/dist/graph/extract/technique.js.map

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

package/dist/graph/extract/toolchain.js

@@ -0,0 +1,67 @@
+/**
+ * toolchain-reference and format-reference pages. Both carry FileFormat H3s
+ * (`### .PRG — …`) with **Produced by:** / **Consumed by:** lines under them;
+ * a toolchain page also names its Tool in frontmatter and its target chips
+ * on **Targets:** lines.
+ */
+import { group, parseFrontmatter, splitList } from "./common.js";
+const FORMAT_H3 = /^###\s+(\.[A-Z0-9]+)\s+(?:—|--)\s+(.+)$/;
+const PRODUCED_BY = /^\*\*Produced by:\*\*\s+(.+)$/;
+const CONSUMED_BY = /^\*\*Consumed by:\*\*\s+(.+)$/;
+const TARGETS = /^\*\*Targets:\*\*\s+(.+)$/;
+/**
+ * Walk lines for FileFormat H3s and the Produced/Consumed lines under them.
+ * With `tool` set, **Targets:** lines become TARGETS edges from that tool.
+ */
+function formatEntities(body, tool) {
+    const entities = [];
+    let format = null;
+    for (const line of body.split("\n")) {
+        const f = FORMAT_H3.exec(line);
+        if (f) {
+            format = group(f, 1).replace(/^\./, "");
+            entities.push({ type: "file_format", name: format, description: group(f, 2) });
+        }
+        else {
+            entities.push(...lineEntities(line, format, tool));
+        }
+    }
+    return entities;
+}
+/** Edges from one line under a FileFormat H3 (`format`), or from a **Targets:** line anywhere. */
+function lineEntities(line, format, tool) {
+    const p = PRODUCED_BY.exec(line);
+    if (p && format)
+        return splitList(group(p, 1)).map((t) => ({ type: "produces", tool: t, format }));
+    const c = CONSUMED_BY.exec(line);
+    if (c && format)
+        return splitList(group(c, 1)).map((t) => ({ type: "consumes", tool: t, format }));
+    const tg = TARGETS.exec(line);
+    if (tg && tool)
+        return splitList(group(tg, 1)).map((chip) => ({ type: "targets", tool, chip }));
+    return [];
+}
+function toolEntity(fm) {
+    if (!fm.tool || !fm.tool_kind || !fm.home_url)
+        return null;
+    return {
+        type: "tool",
+        name: fm.tool,
+        kind: fm.tool_kind,
+        ...(fm.maintainer !== undefined ? { maintainer: fm.maintainer } : {}),
+        ...(fm.license !== undefined ? { license: fm.license } : {}),
+        home_url: fm.home_url,
+        // The version the repo's gates ran with (CONVENTIONS-toolchain-reference.md).
+        ...(fm.version_verified ? { version_verified: fm.version_verified.replace(/^["']|["']$/g, "") } : {}),
+    };
+}
+export function parseToolchainDoc(content) {
+    const { fm, rest } = parseFrontmatter(content);
+    const tool = toolEntity(fm);
+    return [...(tool ? [tool] : []), ...formatEntities(rest, fm.tool)];
+}
+/** A format-reference page: FileFormat H3s and Produced/Consumed only, no Tool. */
+export function parseFormatDoc(content) {
+    return formatEntities(content, undefined);
+}
+//# sourceMappingURL=toolchain.js.map

package/dist/graph/extract/toolchain.js.map

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

package/dist/graph/extract/types.js

@@ -0,0 +1,3 @@
+/** The entities the extractor emits. Node types and edge types share one union; see src/graph/apply.ts. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/graph/extract/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/graph/extract/types.ts"],"names":[],"mappings":"AAAA,2GAA2G"}

package/dist/graph/extract/vocabulary.js

@@ -0,0 +1,65 @@
+/**
+ * Fixed vocabularies the extractor checks page metadata against: technique
+ * categories, **Demands:** words, **Cost:** keys and **Cost basis:** words
+ * (docs/CONVENTIONS-techniques.md). A word outside a set is a doc error; the
+ * extractor warns and ingests nothing for it.
+ */
+export const COST_VOCABULARY = {
+    cycles_per_line: "CPU cycles the technique takes on each raster line it is active on",
+    cycles_per_frame: "CPU cycles the technique takes per frame (PAL 19,656 unless the page says otherwise)",
+    cycles_per_frame_typical: "CPU cycles on a typical frame, measured, when cycles_per_frame is a worst frame (schema 27); never above cycles_per_frame",
+    lines_active: "raster lines per frame on which the technique runs code",
+    bytes_code: "bytes of code in the built recipe's segments",
+    bytes_data: "bytes of tables, buffers and other data in the built recipe's segments",
+    zp_bytes: "zero-page bytes the technique claims",
+    irq_slots: "raster or timer interrupts the technique needs per frame",
+    sprites_per_line: "the most hardware sprites displayed on one raster line of the technique's lines (0-8)",
+};
+// Keys whose value has a hardware ceiling; a figure above it is refused.
+export const COST_MAXIMUM = { sprites_per_line: 8 };
+export const COST_BASIS_WORDS = ["measured-vice", "derived-listing", "arithmetic", "estimated"];
+export function isCostBasis(word) {
+    return COST_BASIS_WORDS.some((w) => w === word);
+}
+// Technique categories the graph accepts. A technique doc whose frontmatter
+// names a category outside this set is refused with a warning, the same way
+// an unknown Demands word is; before this set existed `render` reached the
+// graph without ever appearing in ONTOLOGY.md. Keep in step with
+// docs/ONTOLOGY.md (Technique.category) and docs/CONVENTIONS-techniques.md.
+export const TECHNIQUE_CATEGORIES = new Set([
+    "raster",
+    "sprite",
+    "scroll",
+    "bitmap",
+    "effect",
+    "music",
+    "cpu",
+    "banking",
+    "loader",
+    "render",
+    "input",
+    "logic",
+    "maths",
+    "text",
+    "io",
+]);
+// The fixed vocabulary for **Demands:** (docs/CONVENTIONS-techniques.md).
+// A word outside it is a doc error and is reported, not ingested.
+export const DEMAND_VOCABULARY = {
+    cpu_every_line: "needs every CPU cycle on every raster line of its region",
+    constant_sprite_set: "the set of active sprites must not change inside its region",
+    badline_free_region: "no badline may occur inside its region",
+    midframe_raster_irqs: "takes raster interrupts inside the display area",
+    changes_sprite_set: "changes which hardware sprites are active during the frame",
+    continuous_interrupts: "takes timer or NMI interrupts every few raster lines, all frame",
+    kernal_rom_out: "runs with the KERNAL ROM banked out",
+    serial_bus_exclusive: "owns the drive and its serial bus while resident: KERNAL disk I/O to that drive stalls until it is uninstalled",
+};
+/**
+ * The value for `key` when the vocabulary defines it as its own key. A
+ * prototype name such as `toString` is not a vocabulary word.
+ */
+export function vocabularyEntry(vocabulary, key) {
+    return Object.hasOwn(vocabulary, key) ? vocabulary[key] : undefined;
+}
+//# sourceMappingURL=vocabulary.js.map

package/dist/graph/extract/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../../src/graph/extract/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,eAAe,EAAE,oEAAoE;IACrF,gBAAgB,EAAE,sFAAsF;IACxG,wBAAwB,EACtB,2HAA2H;IAC7H,YAAY,EAAE,yDAAyD;IACvE,UAAU,EAAE,8CAA8C;IAC1D,UAAU,EAAE,wEAAwE;IACpF,QAAQ,EAAE,sCAAsC;IAChD,SAAS,EAAE,0DAA0D;IACrE,gBAAgB,EAAE,uFAAuF;CAC1G,CAAC;AACF,yEAAyE;AACzE,MAAM,CAAC,MAAM,YAAY,GAAoC,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;AAIrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,CAAU,CAAC;AAGzG,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,iEAAiE;AACjE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IAC/D,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,KAAK;IACL,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,IAAI;CACL,CAAC,CAAC;AAEH,0EAA0E;AAC1E,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,cAAc,EAAE,0DAA0D;IAC1E,mBAAmB,EAAE,6DAA6D;IAClF,mBAAmB,EAAE,wCAAwC;IAC7D,oBAAoB,EAAE,iDAAiD;IACvE,kBAAkB,EAAE,4DAA4D;IAChF,qBAAqB,EAAE,iEAAiE;IACxF,cAAc,EAAE,qCAAqC;IACrD,oBAAoB,EAClB,gHAAgH;CACnH,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,UAA4C,EAC5C,GAAW;IAEX,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC"}