@prodara/compiler 0.1.0

package/dist/doc-gen/product-renderer.js

@@ -0,0 +1,101 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Product Overview Renderer
+// ---------------------------------------------------------------------------
+// Renders the top-level README.md with product info, module table, and
+// cross-module actor/capability summary.
+import { renderBanner, renderTable, humanize, getArrayProp, shortName } from './format-helpers.js';
+// ---------------------------------------------------------------------------
+// Product overview
+// ---------------------------------------------------------------------------
+/**
+ * Render the product-level README.md overview document.
+ */
+export function renderProductOverview(graph, resolveString) {
+    const lines = [];
+    lines.push(...renderBanner(`${graph.product.name}.prd`));
+    const title = resolveString(graph.product.title) ?? humanize(graph.product.name);
+    lines.push(`# ${title}`);
+    lines.push('');
+    if (graph.product.version) {
+        lines.push(`**Version:** ${graph.product.version}`);
+        lines.push('');
+    }
+    // Module table
+    lines.push('## Modules');
+    lines.push('');
+    lines.push(...renderTable(['Module', 'Description'], graph.modules.map(m => [
+        `[${humanize(m.name)}](${m.name}.md)`,
+        getModuleSummary(m),
+    ])));
+    lines.push('');
+    // Cross-module actor summary
+    const allActors = [];
+    const allCapabilities = [];
+    for (const mod of graph.modules) {
+        for (const actor of getArrayProp(mod, 'actors')) {
+            allActors.push({ actor, module: mod.name });
+        }
+        for (const cap of getArrayProp(mod, 'capabilities')) {
+            allCapabilities.push({ cap, module: mod.name });
+        }
+    }
+    if (allActors.length > 0) {
+        lines.push('## Actors');
+        lines.push('');
+        lines.push(...renderTable(['Actor', 'Module', 'Description'], allActors.map(({ actor, module }) => [
+            `**${humanize(actor.name)}**`,
+            `[${humanize(module)}](${module}.md)`,
+            /* v8 ignore next -- actor always has description */
+            actor.description ?? actor.title ?? '—',
+        ])));
+        lines.push('');
+    }
+    if (allCapabilities.length > 0) {
+        lines.push('## Capabilities');
+        lines.push('');
+        lines.push(...renderTable(['Capability', 'Module', 'Actors'], allCapabilities.map(({ cap, module }) => [
+            `**${humanize(cap.name)}**`,
+            `[${humanize(module)}](${module}.md)`,
+            /* v8 ignore next -- capability always has actors */
+            cap.actors.map(a => shortName(a)).join(', ') || '—',
+        ])));
+        lines.push('');
+    }
+    // Module dependency diagram (if any imports exist)
+    const hasImports = graph.modules.some(m => m.imports.length > 0);
+    if (hasImports) {
+        lines.push('## Module Dependencies');
+        lines.push('');
+        lines.push('```mermaid');
+        lines.push('graph LR');
+        for (const mod of graph.modules) {
+            for (const imp of mod.imports) {
+                lines.push(`    ${mod.name} --> ${imp.from}`);
+            }
+        }
+        lines.push('```');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getModuleSummary(mod) {
+    const counts = [];
+    const categories = [
+        ['entities', 'entities'],
+        ['workflows', 'workflows'],
+        ['surfaces', 'surfaces'],
+        ['events', 'events'],
+        ['tokens', 'token sets'],
+    ];
+    for (const [key, label] of categories) {
+        const arr = getArrayProp(mod, key);
+        if (arr.length > 0) {
+            counts.push(`${arr.length} ${label}`);
+        }
+    }
+    return counts.length > 0 ? counts.join(', ') : '—';
+}
+//# sourceMappingURL=product-renderer.js.map

package/dist/doc-gen/product-renderer.js.map

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

package/dist/doc-gen/section-renderers.d.ts

@@ -0,0 +1,20 @@
+import type { ModuleNode, GraphEdge } from '../graph/graph-types.js';
+export interface SectionContext {
+    readonly mod: ModuleNode;
+    readonly edges: readonly GraphEdge[];
+    readonly resolveString: (ref: string | null) => string | null;
+    readonly resolveLink: (nodeId: string, fromModule: string) => string;
+}
+export declare function renderActorsSection(ctx: SectionContext): string[];
+export declare function renderDomainSection(ctx: SectionContext): string[];
+export declare function renderRulesSection(ctx: SectionContext): string[];
+export declare function renderWorkflowsSection(ctx: SectionContext): string[];
+export declare function renderActionsSection(ctx: SectionContext): string[];
+export declare function renderEventsSection(ctx: SectionContext): string[];
+export declare function renderSchedulesSection(ctx: SectionContext): string[];
+export declare function renderSurfacesSection(ctx: SectionContext): string[];
+export declare function renderDesignSection(ctx: SectionContext): string[];
+export declare function renderStorageSection(ctx: SectionContext): string[];
+export declare function renderGovernanceSection(ctx: SectionContext): string[];
+export declare function renderTestsSection(ctx: SectionContext): string[];
+//# sourceMappingURL=section-renderers.d.ts.map

package/dist/doc-gen/section-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-renderers.d.ts","sourceRoot":"","sources":["../../src/doc-gen/section-renderers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAgB,MAAM,yBAAyB,CAAC;AAenF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9D,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CACtE;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAiCjE;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAmDjE;AAeD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAgBhE;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CA6EpE;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAelE;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAejE;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAepE;AAMD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CA2CnE;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAuBjE;AAkBD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAgBlE;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CA+BrE;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,EAAE,CAYhE"}

package/dist/doc-gen/section-renderers.js

@@ -0,0 +1,357 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen Section Renderers
+// ---------------------------------------------------------------------------
+// Individual section rendering functions. Each returns string[] (lines).
+// Follows the governance module's line-accumulation pattern.
+import { section, renderTable, formatTypeRef, humanize, getArrayProp, shortName } from './format-helpers.js';
+import { renderEntityErDiagram, renderWorkflowFlowchart } from './mermaid-renderers.js';
+import { renderSurfaceAscii } from './surface-ascii.js';
+// ---------------------------------------------------------------------------
+// Actors & Capabilities
+// ---------------------------------------------------------------------------
+export function renderActorsSection(ctx) {
+    const actors = getArrayProp(ctx.mod, 'actors');
+    const capabilities = getArrayProp(ctx.mod, 'capabilities');
+    if (actors.length === 0 && capabilities.length === 0)
+        return [];
+    const lines = [...section('Actors & Capabilities')];
+    if (actors.length > 0) {
+        lines.push(...renderTable(['Actor', 'Description'], actors.map(a => [
+            `**${humanize(a.name)}**`,
+            a.description ?? a.title ?? '—',
+        ])));
+        lines.push('');
+    }
+    if (capabilities.length > 0) {
+        lines.push(...section('Capabilities', 3));
+        lines.push(...renderTable(['Capability', 'Description', 'Actors'], capabilities.map(c => [
+            `**${humanize(c.name)}**`,
+            /* v8 ignore next -- capability always has description */
+            c.description ?? c.title ?? '—',
+            c.actors.map(a => shortName(a)).join(', ') || '—',
+        ])));
+        lines.push('');
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Domain Model
+// ---------------------------------------------------------------------------
+export function renderDomainSection(ctx) {
+    const entities = getArrayProp(ctx.mod, 'entities');
+    const enums = getArrayProp(ctx.mod, 'enums');
+    const values = getArrayProp(ctx.mod, 'values');
+    if (entities.length === 0 && enums.length === 0 && values.length === 0)
+        return [];
+    const lines = [...section('Domain Model')];
+    // Mermaid ER diagram
+    const er = renderEntityErDiagram(ctx.mod, ctx.edges);
+    if (er.length > 0) {
+        lines.push(...er);
+        lines.push('');
+    }
+    // Entity tables
+    for (const entity of entities) {
+        lines.push(...section(`Entity: ${humanize(entity.name)}`, 3));
+        lines.push(...renderTable(['Field', 'Type'], entity.fields.map(f => [
+            `\`${f.name}\``,
+            formatTypeDisplay(f.type, ctx),
+        ])));
+        lines.push('');
+    }
+    // Value objects
+    for (const value of values) {
+        lines.push(...section(`Value: ${humanize(value.name)}`, 3));
+        lines.push(...renderTable(['Field', 'Type'], value.fields.map(f => [
+            `\`${f.name}\``,
+            formatTypeDisplay(f.type, ctx),
+        ])));
+        lines.push('');
+    }
+    // Enums
+    for (const en of enums) {
+        lines.push(...section(`Enum: ${humanize(en.name)}`, 3));
+        for (const member of en.members) {
+            lines.push(`- \`${member.name}\``);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+function formatTypeDisplay(type, ctx) {
+    if (typeof type === 'string')
+        return `\`${type}\``;
+    if ('ref' in type)
+        return ctx.resolveLink(type.ref, ctx.mod.name);
+    /* v8 ignore next -- generic type display */
+    if ('generic' in type)
+        return `\`${formatTypeRef(type)}\``;
+    /* v8 ignore next 2 -- exhaustive check */
+    return `\`${String(type)}\``;
+}
+// ---------------------------------------------------------------------------
+// Business Rules
+// ---------------------------------------------------------------------------
+export function renderRulesSection(ctx) {
+    const rules = getArrayProp(ctx.mod, 'rules');
+    if (rules.length === 0)
+        return [];
+    const lines = [...section('Business Rules')];
+    lines.push(...renderTable(['Rule', 'Entity', 'Message'], rules.map(r => [
+        `**${humanize(r.name)}**`,
+        shortName(r.entity),
+        /* v8 ignore next -- resolveString fallback */
+        ctx.resolveString(r.message) ?? r.message,
+    ])));
+    lines.push('');
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Workflows
+// ---------------------------------------------------------------------------
+export function renderWorkflowsSection(ctx) {
+    const workflows = getArrayProp(ctx.mod, 'workflows');
+    if (workflows.length === 0)
+        return [];
+    const lines = [...section('Workflows')];
+    for (const wf of workflows) {
+        lines.push(...section(`Workflow: ${humanize(wf.name)}`, 3));
+        // Authorization
+        if (wf.authorization && wf.authorization.length > 0) {
+            lines.push('**Authorization:**');
+            for (const auth of wf.authorization) {
+                lines.push(`- **${shortName(auth.actor)}**: ${auth.permissions.join(', ')}`);
+            }
+            lines.push('');
+        }
+        // Input
+        if (wf.input && wf.input.length > 0) {
+            lines.push('**Input:**');
+            lines.push(...renderTable(['Field', 'Type'], wf.input.map(f => [`\`${f.name}\``, formatTypeDisplay(f.type, ctx)])));
+            lines.push('');
+        }
+        // Reads / Writes
+        if (wf.reads && wf.reads.length > 0) {
+            lines.push(`**Reads:** ${wf.reads.map(r => ctx.resolveLink(r, ctx.mod.name)).join(', ')}`);
+            lines.push('');
+        }
+        if (wf.writes && wf.writes.length > 0) {
+            lines.push(`**Writes:** ${wf.writes.map(w => ctx.resolveLink(w, ctx.mod.name)).join(', ')}`);
+            lines.push('');
+        }
+        // Flowchart
+        const flowchart = renderWorkflowFlowchart(wf);
+        if (flowchart.length > 0) {
+            lines.push(...flowchart);
+            lines.push('');
+        }
+        // Transitions
+        if (wf.transitions && wf.transitions.length > 0) {
+            lines.push('**Transitions:**');
+            for (const t of wf.transitions) {
+                lines.push(`- \`${shortName(t.entity)}.${t.field}\`: ${t.from} → ${t.to}`);
+            }
+            lines.push('');
+        }
+        // Effects
+        if (wf.effects && wf.effects.length > 0) {
+            lines.push('**Effects:**');
+            for (const effect of wf.effects) {
+                /* v8 ignore next -- effect always has entries */
+                const [kind, value] = Object.entries(effect)[0] ?? ['effect', 'unknown'];
+                lines.push(`- ${kind}: \`${value}\``);
+            }
+            lines.push('');
+        }
+        // Returns
+        if (wf.returns && wf.returns.length > 0) {
+            lines.push('**Returns:**');
+            lines.push(...renderTable(['Outcome', 'Type'], wf.returns.map(r => [r.name, formatTypeDisplay(r.type, ctx)])));
+            lines.push('');
+        }
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Actions
+// ---------------------------------------------------------------------------
+export function renderActionsSection(ctx) {
+    const actions = getArrayProp(ctx.mod, 'actions');
+    if (actions.length === 0)
+        return [];
+    const lines = [...section('Actions')];
+    lines.push(...renderTable(['Action', 'Title', 'Workflow'], actions.map(a => [
+        `**${humanize(a.name)}**`,
+        ctx.resolveString(a.title) ?? a.title ?? '—',
+        a.workflow ? ctx.resolveLink(a.workflow, ctx.mod.name) : '—',
+    ])));
+    lines.push('');
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Events
+// ---------------------------------------------------------------------------
+export function renderEventsSection(ctx) {
+    const events = getArrayProp(ctx.mod, 'events');
+    if (events.length === 0)
+        return [];
+    const lines = [...section('Events')];
+    lines.push(...renderTable(['Event', 'Payload', 'Description'], events.map(e => [
+        `**${humanize(e.name)}**`,
+        e.payload ? formatTypeDisplay(e.payload, ctx) : '—',
+        ctx.resolveString(e.description) ?? e.description ?? '—',
+    ])));
+    lines.push('');
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Schedules
+// ---------------------------------------------------------------------------
+export function renderSchedulesSection(ctx) {
+    const schedules = getArrayProp(ctx.mod, 'schedules');
+    if (schedules.length === 0)
+        return [];
+    const lines = [...section('Schedules')];
+    lines.push(...renderTable(['Schedule', 'Cron', 'Description'], schedules.map(s => [
+        `**${humanize(s.name)}**`,
+        s.cron ? `\`${s.cron}\`` : '—',
+        ctx.resolveString(s.description) ?? s.description ?? '—',
+    ])));
+    lines.push('');
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Surfaces
+// ---------------------------------------------------------------------------
+export function renderSurfacesSection(ctx) {
+    const surfaces = getArrayProp(ctx.mod, 'surfaces');
+    const renderings = getArrayProp(ctx.mod, 'renderings');
+    if (surfaces.length === 0 && renderings.length === 0)
+        return [];
+    // Build rendering lookup by target
+    const renderingByTarget = new Map();
+    for (const r of renderings) {
+        if (r.target)
+            renderingByTarget.set(r.target, r);
+    }
+    const lines = [...section('Surfaces')];
+    for (const surface of surfaces) {
+        lines.push(...section(`Surface: ${humanize(surface.name)}`, 3));
+        // Find matching rendering
+        const rendering = renderingByTarget.get(surface.id) ?? null;
+        // Resolve actions exposed by this surface
+        const actionEdges = ctx.edges.filter(e => e.from === surface.id && e.kind === 'exposes_action');
+        const actionNames = actionEdges.map(e => shortName(e.to));
+        lines.push(...renderSurfaceAscii(surface, rendering, ctx.resolveString, actionNames));
+        lines.push('');
+    }
+    // Standalone renderings (not targeting a listed surface)
+    const surfaceIds = new Set(surfaces.map(s => s.id));
+    const standaloneRenderings = renderings.filter(r => !r.target || !surfaceIds.has(r.target));
+    for (const rendering of standaloneRenderings) {
+        lines.push(...section(`Rendering: ${humanize(rendering.name)}`, 3));
+        lines.push(`- **Platform:** ${rendering.platform ?? '—'}`);
+        lines.push(`- **Layout:** ${rendering.layout ?? '—'}`);
+        if (rendering.target) {
+            lines.push(`- **Target:** ${ctx.resolveLink(rendering.target, ctx.mod.name)}`);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Design System
+// ---------------------------------------------------------------------------
+export function renderDesignSection(ctx) {
+    const tokens = getArrayProp(ctx.mod, 'tokens');
+    if (tokens.length === 0)
+        return [];
+    const lines = [...section('Design System')];
+    for (const tokenSet of tokens) {
+        lines.push(...section(`Tokens: ${humanize(tokenSet.name)}`, 3));
+        for (const cat of tokenSet.categories) {
+            lines.push(...section(humanize(cat.name), 4));
+            lines.push(...renderTable(['Token', 'Value'], cat.tokens.map(t => [
+                `\`${t.name}\``,
+                formatTokenValue(t.name, t.value),
+            ])));
+            lines.push('');
+        }
+    }
+    return lines;
+}
+function formatTokenValue(name, value) {
+    if (typeof value === 'string') {
+        // Color swatch for hex values
+        if (/^#[0-9a-fA-F]{3,8}$/.test(value)) {
+            return `\`${value}\` 🎨`;
+        }
+        return `\`${value}\``;
+    }
+    if (typeof value === 'number')
+        return `\`${value}\``;
+    return `\`${JSON.stringify(value)}\``;
+}
+// ---------------------------------------------------------------------------
+// Storage
+// ---------------------------------------------------------------------------
+export function renderStorageSection(ctx) {
+    const storages = getArrayProp(ctx.mod, 'storages');
+    if (storages.length === 0)
+        return [];
+    const lines = [...section('Storage')];
+    lines.push(...renderTable(['Storage', 'Target', 'Model', 'Table'], storages.map(s => [
+        `**${humanize(s.name)}**`,
+        s.target ? ctx.resolveLink(s.target, ctx.mod.name) : '—',
+        s.model ?? '—',
+        s.table ?? '—',
+    ])));
+    lines.push('');
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Governance
+// ---------------------------------------------------------------------------
+export function renderGovernanceSection(ctx) {
+    const security = getArrayProp(ctx.mod, 'security');
+    const privacy = getArrayProp(ctx.mod, 'privacy');
+    if (security.length === 0 && privacy.length === 0)
+        return [];
+    const lines = [...section('Governance')];
+    if (security.length > 0) {
+        lines.push(...section('Security Policies', 3));
+        for (const s of security) {
+            lines.push(`- **${humanize(s.name)}** — applies to: ${s.applies_to.map(a => shortName(a)).join(', ')}`);
+        }
+        lines.push('');
+    }
+    if (privacy.length > 0) {
+        lines.push(...section('Privacy Policies', 3));
+        lines.push(...renderTable(['Policy', 'Classification', 'Retention', 'Exportable', 'Erasable'], privacy.map(p => [
+            `**${humanize(p.name)}**`,
+            p.classification ?? '—',
+            p.retention ?? '—',
+            p.exportable ?? '—',
+            p.erasable ?? '—',
+        ])));
+        lines.push('');
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+export function renderTestsSection(ctx) {
+    const tests = getArrayProp(ctx.mod, 'tests');
+    if (tests.length === 0)
+        return [];
+    const lines = [...section('Tests')];
+    lines.push(`${tests.length} spec test(s) defined:`);
+    lines.push('');
+    for (const t of tests) {
+        lines.push(`- \`${t.name}\``);
+    }
+    lines.push('');
+    return lines;
+}
+//# sourceMappingURL=section-renderers.js.map

package/dist/doc-gen/section-renderers.js.map

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

package/dist/doc-gen/string-resolver.d.ts

@@ -0,0 +1,8 @@
+import type { ProductGraph } from '../graph/graph-types.js';
+/**
+ * Create a string resolver that resolves qualified refs like
+ * `module.string_set.key` to their default-locale string values.
+ * Falls back to the raw reference path if unresolvable.
+ */
+export declare function createStringResolver(graph: ProductGraph): (ref: string | null) => string | null;
+//# sourceMappingURL=string-resolver.d.ts.map

package/dist/doc-gen/string-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-resolver.d.ts","sourceRoot":"","sources":["../../src/doc-gen/string-resolver.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,GAClB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAqCvC"}

package/dist/doc-gen/string-resolver.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// Prodara Compiler — Doc-Gen String Resolver
+// ---------------------------------------------------------------------------
+// Resolves qualified string references (e.g. "board.board_strings.title")
+// to default-locale values from the product graph's strings nodes.
+import { getArrayProp } from './format-helpers.js';
+/**
+ * Create a string resolver that resolves qualified refs like
+ * `module.string_set.key` to their default-locale string values.
+ * Falls back to the raw reference path if unresolvable.
+ */
+export function createStringResolver(graph) {
+    const stringsMap = new Map();
+    for (const mod of graph.modules) {
+        const stringsNodes = getArrayProp(mod, 'strings');
+        for (const node of stringsNodes) {
+            // Key by qualified id: "module.strings.set_name"
+            stringsMap.set(node.id, node.entries);
+            // Also key by "module.set_name" for the common shorthand
+            stringsMap.set(`${mod.name}.${node.name}`, node.entries);
+        }
+    }
+    return (ref) => {
+        if (!ref)
+            return null;
+        // Try three-part: module.string_set.key
+        const parts = ref.split('.');
+        if (parts.length >= 3) {
+            // Try "module.string_set" → entries[key]
+            const key = parts[parts.length - 1];
+            const setPath = parts.slice(0, -1).join('.');
+            const entries = stringsMap.get(setPath);
+            if (entries && key in entries) {
+                return entries[key];
+            }
+            // Try with "module.strings.set_name" prefix
+            const altSetPath = `${parts[0]}.strings.${parts[1]}`;
+            const altEntries = stringsMap.get(altSetPath);
+            if (altEntries && key in altEntries) {
+                return altEntries[key];
+            }
+        }
+        // Unresolvable — return raw ref as fallback
+        return ref;
+    };
+}
+//# sourceMappingURL=string-resolver.js.map

package/dist/doc-gen/string-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-resolver.js","sourceRoot":"","sources":["../../src/doc-gen/string-resolver.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAC9E,0EAA0E;AAC1E,mEAAmE;AAGnE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAmB;IAEnB,MAAM,UAAU,GAAG,IAAI,GAAG,EAA4C,CAAC;IAEvE,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,YAAY,CAAc,GAAG,EAAE,SAAS,CAAC,CAAC;QAAI,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YACnG,iDAAiD;YACjD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACtC,yDAAyD;YACzD,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAkB,EAAiB,EAAE;QAC3C,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,wCAAwC;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,yCAAyC;YACzC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;YACrC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxC,IAAI,OAAO,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,GAAG,CAAE,CAAC;YACvB,CAAC;YAED,4CAA4C;YAC5C,MAAM,UAAU,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;gBACpC,OAAO,UAAU,CAAC,GAAG,CAAE,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC"}

package/dist/doc-gen/surface-ascii.d.ts

@@ -0,0 +1,7 @@
+import type { SurfaceNode, RenderingNode } from './doc-gen-types.js';
+/**
+ * Render an ASCII art box for a surface, optionally enriched with
+ * rendering layout info.
+ */
+export declare function renderSurfaceAscii(surface: SurfaceNode, rendering: RenderingNode | null, resolveString: (ref: string | null) => string | null, actions: string[]): string[];
+//# sourceMappingURL=surface-ascii.d.ts.map

package/dist/doc-gen/surface-ascii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-ascii.d.ts","sourceRoot":"","sources":["../../src/doc-gen/surface-ascii.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAerE;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,aAAa,GAAG,IAAI,EAC/B,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,EACpD,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CAoBV"}