@ignite-agent/agent 0.5.0 → 0.6.0

package/dist/wiki-content/load.js

@@ -0,0 +1,92 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { parseWikiEntity, validateWikiSet } from './schema.js';
+export const DEFAULT_WIKI_DIR = 'content/wiki';
+export function wikiDir(explicit) {
+    return resolve(process.cwd(), explicit?.trim() || process.env.IGNITE_WIKI_DIR?.trim() || DEFAULT_WIKI_DIR);
+}
+// Reads every `<slug>.json` in the directory. Never throws for content problems: the issues list is the
+// verdict, and `loadWikiEntities` turns a non-empty list into a build failure.
+export function readWikiSet(dir) {
+    if (!existsSync(dir))
+        return { dir, entities: [], issues: [] };
+    const files = readdirSync(dir)
+        .filter((name) => name.endsWith('.json') && !name.startsWith('_'))
+        .sort()
+        .map((name) => join(dir, name));
+    const entities = [];
+    const issues = [];
+    for (const file of files) {
+        let raw;
+        try {
+            raw = JSON.parse(readFileSync(file, 'utf8'));
+        }
+        catch (error) {
+            issues.push({ file, message: `invalid JSON: ${error.message}` });
+            continue;
+        }
+        const parsed = parseWikiEntity(file, raw);
+        issues.push(...parsed.issues);
+        if (parsed.entity)
+            entities.push({ file, entity: parsed.entity });
+    }
+    issues.push(...validateWikiSet(entities));
+    return { dir, entities, issues };
+}
+export class WikiContentError extends Error {
+    issues;
+    constructor(issues) {
+        super(`[@ignite-agent/agent] wiki content failed validation:\n${issues.map(formatIssue).join('\n')}`);
+        this.issues = issues;
+        this.name = 'WikiContentError';
+    }
+}
+export function formatIssue(issue) {
+    return `BUILD ERROR ${issue.file}: ${issue.message}`;
+}
+// The page loader. Throws on any drift so `next build` fails instead of shipping a page the gate refused.
+export function loadWikiEntities(dir) {
+    const set = readWikiSet(wikiDir(dir));
+    if (set.issues.length > 0)
+        throw new WikiContentError(set.issues);
+    return set.entities.map((entry) => entry.entity);
+}
+export function findWikiEntity(slug, dir) {
+    return loadWikiEntities(dir).find((entity) => entity.slug === slug) ?? null;
+}
+// One source of truth for freshness: newest changelog date, else the import stamp, else the file's git
+// commit date, else its mtime. Footer, JSON-LD, metadata and sitemap all read this.
+export function lastReviewed(entity, file) {
+    const dates = entity.changelog.map((entry) => entry.date).sort();
+    const newest = dates[dates.length - 1];
+    if (newest)
+        return newest;
+    if (entity.imported_from?.dateModified)
+        return entity.imported_from.dateModified.slice(0, 10);
+    if (file && existsSync(file)) {
+        const committed = gitCommitDate(file);
+        if (committed)
+            return committed;
+        return statSync(file).mtime.toISOString().slice(0, 10);
+    }
+    return new Date().toISOString().slice(0, 10);
+}
+function gitCommitDate(file) {
+    try {
+        const out = execFileSync('git', ['log', '-1', '--format=%cs', '--', file], {
+            cwd: resolve(file, '..'),
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString()
+            .trim();
+        return /^\d{4}-\d{2}-\d{2}$/.test(out) ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function entityFile(dir, slug) {
+    return join(dir, `${slug}.json`);
+}
+//# sourceMappingURL=load.js.map

package/dist/wiki-content/load.js.map

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

package/dist/wiki-content/metadata.d.ts

@@ -0,0 +1,13 @@
+import type { Metadata, MetadataRoute } from 'next';
+import { type WikiSiteOptions } from './jsonld.js';
+import { type WikiEntity } from './schema.js';
+export declare const TITLE_MAX = 60;
+export declare const DESCRIPTION_MIN = 130;
+export declare const DESCRIPTION_MAX = 160;
+export declare function entityTitle(entity: WikiEntity, siteName?: string | undefined): string;
+export declare function entityDescription(entity: WikiEntity): string;
+export declare function entityMetadata(entity: WikiEntity, options: WikiSiteOptions): Metadata;
+export declare function wikiContentSitemap(entries: Array<{
+    entity: WikiEntity;
+    lastReviewed: string;
+}>, options: WikiSiteOptions): MetadataRoute.Sitemap;

package/dist/wiki-content/metadata.js

@@ -0,0 +1,61 @@
+import { entityUrl } from './jsonld.js';
+import { definitionLede, entityTypeLabel } from './schema.js';
+export const TITLE_MAX = 60;
+export const DESCRIPTION_MIN = 130;
+export const DESCRIPTION_MAX = 160;
+// "{canonical_name} — {category} | {site}", clamped to 60 characters. The name survives the clamp first;
+// the category and site suffix go before it does.
+export function entityTitle(entity, siteName) {
+    const category = entity.definition.category?.trim() || entityTypeLabel(entity.entity_type);
+    const full = siteName ? `${entity.canonical_name} — ${category} | ${siteName}` : `${entity.canonical_name} — ${category}`;
+    if (full.length <= TITLE_MAX)
+        return full;
+    const withoutSite = `${entity.canonical_name} — ${category}`;
+    if (withoutSite.length <= TITLE_MAX)
+        return withoutSite;
+    return clamp(entity.canonical_name, TITLE_MAX);
+}
+// The definition lede clamped to 160 characters. A lede under 130 characters stays as it is: the text is not
+// padded, because there is nothing true to pad it with.
+export function entityDescription(entity) {
+    return clamp(definitionLede(entity), DESCRIPTION_MAX);
+}
+export function entityMetadata(entity, options) {
+    const canonical = entityUrl(entity, options);
+    const title = entityTitle(entity, options.siteName);
+    const description = entityDescription(entity);
+    const metadata = {
+        title,
+        description,
+        alternates: { canonical },
+        openGraph: {
+            title,
+            description,
+            type: 'article',
+            url: canonical,
+            ...(options.siteName ? { siteName: options.siteName } : {}),
+            ...(options.locale ? { locale: options.locale } : {}),
+        },
+        twitter: { card: 'summary', title, description },
+        metadataBase: new URL(new URL(options.siteUrl.includes('://') ? options.siteUrl : `https://${options.siteUrl}`).origin),
+    };
+    if (entity.author) {
+        metadata.authors = [{ name: entity.author.name, ...(entity.author.url ? { url: entity.author.url } : {}) }];
+    }
+    return metadata;
+}
+export function wikiContentSitemap(entries, options) {
+    return entries.map(({ entity, lastReviewed }) => ({
+        url: entityUrl(entity, options),
+        lastModified: lastReviewed,
+        changeFrequency: 'monthly',
+    }));
+}
+function clamp(value, max) {
+    if (value.length <= max)
+        return value;
+    const cut = value.slice(0, max - 1);
+    const atSpace = cut.lastIndexOf(' ');
+    return `${(atSpace > max * 0.6 ? cut.slice(0, atSpace) : cut).replace(/[\s,;:.]+$/, '')}…`;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/wiki-content/metadata.js.map

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

package/dist/wiki-content/pull.d.ts

@@ -0,0 +1,23 @@
+import type { IgniteClient } from '../client.js';
+import type { FeedPage } from '../types.js';
+import { type WikiEntityInput } from './schema.js';
+export type PullSummary = {
+    published: number;
+    written: string[];
+    unchanged: string[];
+    kept: string[];
+    skipped: Array<{
+        slug: string;
+        reason: string;
+    }>;
+    unresolvedMarkers: number;
+};
+export declare function feedPageToEntity(page: FeedPage, siteUrl?: string): {
+    entity: WikiEntityInput;
+    unresolvedMarkers: number;
+};
+export declare function pullWiki(client: IgniteClient, dir: string, options: {
+    siteUrl?: string | undefined;
+    dryRun?: boolean | undefined;
+    log?: ((line: string) => void) | undefined;
+}): Promise<PullSummary>;

package/dist/wiki-content/pull.js

@@ -0,0 +1,160 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { entityFile } from './load.js';
+import { parseWikiEntity } from './schema.js';
+const MARKER = /\[(\d+)\]/g;
+// Maps one published Ignite wiki page onto the entity contract. Only what the page states is carried over:
+// its lede, its sections, the paragraphs that cite a source, the source list, its author and its dates.
+// Type and aliases are the reviewer's call, so the file starts as a `concept` with no aliases.
+export function feedPageToEntity(page, siteUrl) {
+    const html = page.html;
+    const title = firstMatch(html, /<h1\b[^>]*>([\s\S]*?)<\/h1>/i) ?? page.title;
+    const body = html.replace(/<h1\b[^>]*>[\s\S]*?<\/h1>/i, '');
+    const sourcesIndex = body.search(/<h2\b[^>]*>\s*Sources\s*<\/h2>/i);
+    const content = sourcesIndex >= 0 ? body.slice(0, sourcesIndex) : body;
+    const sourcesHtml = sourcesIndex >= 0 ? body.slice(sourcesIndex) : '';
+    const citations = [...sourcesHtml.matchAll(/<li\b[^>]*>\s*<a\b[^>]*href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi)].map((match, i) => ({
+        n: i + 1,
+        url: decode(match[1] ?? ''),
+        title: textOf(match[2] ?? '') || decode(match[1] ?? ''),
+        accessed: (page.dateModified ?? page.updatedAt).slice(0, 10),
+    }));
+    const known = new Set(citations.map((c) => c.n));
+    const chunks = content.split(/(?=<h2\b)/i);
+    const lead = [];
+    const sections = [];
+    const crossLinks = [];
+    let unresolved = 0;
+    for (const chunk of chunks) {
+        const heading = firstMatch(chunk, /<h2\b[^>]*>([\s\S]*?)<\/h2>/i);
+        const rest = heading === null ? chunk : chunk.replace(/<h2\b[^>]*>[\s\S]*?<\/h2>/i, '');
+        for (const link of rest.matchAll(/<ul class="wiki-related">([\s\S]*?)<\/ul>/gi)) {
+            for (const anchor of (link[1] ?? '').matchAll(/href=["']([^"']+)["']/gi)) {
+                const slug = ownWikiSlug(anchor[1] ?? '', siteUrl);
+                if (slug)
+                    crossLinks.push({ target_slug: slug });
+            }
+        }
+        const paragraphs = [...rest.matchAll(/<p\b([^>]*)>([\s\S]*?)<\/p>/gi)]
+            .filter((m) => !/wiki-(questions|related)-label/.test(m[1] ?? ''))
+            .map((m) => textOf(m[2] ?? ''))
+            .filter((t) => t !== '');
+        if (heading === null) {
+            lead.push(...paragraphs);
+            continue;
+        }
+        const section = { heading: textOf(heading), paragraphs: [], stats: [] };
+        for (const paragraph of paragraphs) {
+            const markers = [...paragraph.matchAll(MARKER)].map((m) => Number(m[1]));
+            const resolvable = markers.filter((n) => known.has(n));
+            if (resolvable.length > 0) {
+                section.stats.push({ text: paragraph, citation: resolvable[0] });
+            }
+            else {
+                if (markers.length > 0)
+                    unresolved += markers.length;
+                section.paragraphs.push(paragraph.replace(/\s*\[\d+\]/g, '').replace(/\s{2,}/g, ' ').trim());
+            }
+        }
+        if (section.paragraphs.length + section.stats.length > 0)
+            sections.push(section);
+    }
+    const lede = lead[0] ?? sections[0]?.paragraphs[0] ?? '';
+    const dateModified = page.dateModified ?? page.updatedAt;
+    const entity = {
+        entity_type: 'concept',
+        canonical_name: textOf(title),
+        slug: page.slug,
+        aliases: [],
+        definition: { lede },
+        sections,
+        cross_links: dedupe(crossLinks).filter((link) => link.target_slug !== page.slug),
+        citations,
+        changelog: [{ date: dateModified.slice(0, 10), note: 'Imported from the published Ignite page' }],
+        same_as: [],
+        imported_from: { source: 'ignite', slug: page.slug, dateModified },
+    };
+    if (page.author?.name) {
+        entity.author = { name: page.author.name, ...(page.author.url ? { url: page.author.url } : {}) };
+    }
+    return { entity, unresolvedMarkers: unresolved };
+}
+export async function pullWiki(client, dir, options) {
+    const { pages } = await client.pages();
+    const wiki = pages.filter((page) => page.kind === 'wiki');
+    const summary = { published: wiki.length, written: [], unchanged: [], kept: [], skipped: [], unresolvedMarkers: 0 };
+    const log = options.log ?? (() => undefined);
+    if (!options.dryRun)
+        mkdirSync(dir, { recursive: true });
+    for (const page of wiki) {
+        const { entity, unresolvedMarkers } = feedPageToEntity(page, options.siteUrl);
+        summary.unresolvedMarkers += unresolvedMarkers;
+        const file = entityFile(dir, page.slug);
+        const parsed = parseWikiEntity(file, entity);
+        if (!parsed.entity) {
+            summary.skipped.push({ slug: page.slug, reason: parsed.issues.map((i) => i.message).join('; ') });
+            continue;
+        }
+        const existing = readExisting(file);
+        if (existing && !existing.imported_from) {
+            summary.kept.push(page.slug);
+            log(`  keep  ${file} (authored here; not overwritten)`);
+            continue;
+        }
+        if (existing?.imported_from?.dateModified === (page.dateModified ?? page.updatedAt)) {
+            summary.unchanged.push(page.slug);
+            continue;
+        }
+        if (!options.dryRun)
+            writeFileSync(file, `${JSON.stringify(parsed.entity, null, 2)}\n`);
+        summary.written.push(page.slug);
+        log(`  ${options.dryRun ? 'would write' : 'write'} ${file}`);
+    }
+    return summary;
+}
+function readExisting(file) {
+    if (!existsSync(file))
+        return null;
+    try {
+        const parsed = parseWikiEntity(file, JSON.parse(readFileSync(file, 'utf8')));
+        return parsed.entity;
+    }
+    catch {
+        return null;
+    }
+}
+function ownWikiSlug(href, siteUrl) {
+    let path = href;
+    try {
+        const url = new URL(href, siteUrl ?? 'https://placeholder.invalid');
+        if (siteUrl && url.host !== new URL(siteUrl).host && url.host !== 'placeholder.invalid')
+            return null;
+        path = url.pathname;
+    }
+    catch {
+        return null;
+    }
+    const match = path.match(/^\/(?:w|wiki)\/([a-z0-9]+(?:-[a-z0-9]+)*)\/?$/);
+    return match?.[1] ?? null;
+}
+function dedupe(links) {
+    const seen = new Set();
+    return links.filter((link) => (seen.has(link.target_slug) ? false : (seen.add(link.target_slug), true)));
+}
+function firstMatch(html, pattern) {
+    const match = html.match(pattern);
+    return match?.[1] ?? null;
+}
+function textOf(html) {
+    return decode(html.replace(/<[^>]+>/g, ' ')).replace(/\s+/g, ' ').trim();
+}
+function decode(value) {
+    return value
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&#x27;/g, "'")
+        .replace(/&nbsp;/g, ' ');
+}
+//# sourceMappingURL=pull.js.map

package/dist/wiki-content/pull.js.map

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

package/dist/wiki-content/render.d.ts

@@ -0,0 +1,29 @@
+import { type IgniteTokens } from '../operator/ui.js';
+import { type WikiSiteOptions } from './jsonld.js';
+import { type EntityType, type WikiEntity } from './schema.js';
+export type WikiRenderOptions = WikiSiteOptions & {
+    tokens?: IgniteTokens | undefined;
+    injectCss?: boolean | undefined;
+};
+export declare function CitedText({ text, citations }: {
+    text: string;
+    citations: Set<number>;
+}): import("react").JSX.Element;
+export declare function WikiEntityArticle({ entity, entities, lastReviewed, options, }: {
+    entity: WikiEntity;
+    entities: WikiEntity[];
+    lastReviewed: string;
+    options: WikiRenderOptions;
+}): import("react").JSX.Element;
+export declare function groupByType(entities: WikiEntity[]): Array<{
+    type: EntityType;
+    entities: WikiEntity[];
+}>;
+export declare function WikiEntityIndex({ entities, options }: {
+    entities: WikiEntity[];
+    options: WikiRenderOptions;
+}): import("react").JSX.Element | null;
+export declare function WikiEntitySidebar({ entities, options }: {
+    entities: WikiEntity[];
+    options: WikiRenderOptions;
+}): import("react").JSX.Element | null;

package/dist/wiki-content/render.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { IGNITE_CSS, tokensToStyle } from '../operator/ui.js';
+import { entityJsonLd, entityPath, jsonLdText } from './jsonld.js';
+import { definitionLede, ENTITY_TYPES, entityTypeLabel } from './schema.js';
+const MARKER = /\[(\d+)\]/g;
+// Same frame the feed pages use, without the context provider, so this file stays importable outside Next.
+function IgniteFrame({ tokens, injectCss = true, children }) {
+    const style = tokensToStyle(tokens);
+    return (_jsxs("div", { className: "ignite", style: style, children: [injectCss ? _jsx("style", { "data-ignite": "css", children: IGNITE_CSS }) : null, children] }));
+}
+// Text with `[n]` markers becomes text with links to `#cite-n`. A marker whose citation is absent stays plain
+// text; the validator has already failed the build for that case, so this only matters for ad-hoc renders.
+export function CitedText({ text, citations }) {
+    const parts = [];
+    let last = 0;
+    let key = 0;
+    for (const match of text.matchAll(MARKER)) {
+        const index = match.index ?? 0;
+        const n = Number(match[1]);
+        if (index > last)
+            parts.push(text.slice(last, index));
+        if (citations.has(n)) {
+            parts.push(_jsxs("a", { className: "ignite-wiki-cite", href: `#cite-${n}`, "aria-label": `Source ${n}`, children: ["[", n, "]"] }, key++));
+        }
+        else {
+            parts.push(match[0]);
+        }
+        last = index + match[0].length;
+    }
+    if (last < text.length)
+        parts.push(text.slice(last));
+    return _jsx(_Fragment, { children: parts });
+}
+function statText(text, citation) {
+    return new RegExp(`\\[${citation}\\]`).test(text) ? text : `${text} [${citation}]`;
+}
+function hostOf(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+// The six regions, in order, from the payload alone. No freeform body.
+export function WikiEntityArticle({ entity, entities, lastReviewed, options, }) {
+    const bySlug = new Map(entities.map((e) => [e.slug, e]));
+    const targets = entity.cross_links
+        .map((link) => bySlug.get(link.target_slug))
+        .filter((target) => target !== undefined);
+    const citationIndices = new Set(entity.citations.map((c) => c.n));
+    const citations = [...entity.citations].sort((a, b) => a.n - b.n);
+    const changelog = [...entity.changelog].sort((a, b) => (a.date < b.date ? 1 : -1));
+    const jsonLd = entityJsonLd(entity, { ...options, lastReviewed, crossLinkTargets: targets });
+    const base = entityPath({ slug: '' }, options).replace(/\/$/, '');
+    return (_jsx(IgniteFrame, { tokens: options.tokens, injectCss: options.injectCss, children: _jsxs("article", { className: "ignite-article ignite-wiki-entity", "data-entity-type": entity.entity_type, children: [_jsxs("nav", { className: "ignite-kicker", "aria-label": "Breadcrumb", children: [_jsx("a", { href: "/", children: "Home" }), _jsx("span", { "aria-hidden": "true", children: " / " }), _jsx("a", { href: base || '/', children: "Wiki" }), _jsx("span", { "aria-hidden": "true", children: " / " }), _jsx("a", { href: `${base}#${entity.entity_type}`, children: entityTypeLabel(entity.entity_type) })] }), _jsx("h1", { className: "ignite-title", children: entity.canonical_name }), _jsx("p", { className: "ignite-wiki-definition", id: "definition", children: definitionLede(entity) }), entity.sections.map((section, i) => (_jsxs("section", { className: "ignite-wiki-section", children: [_jsx("h2", { id: `s-${i + 1}`, children: section.heading }), section.paragraphs.map((paragraph, p) => (_jsx("p", { children: _jsx(CitedText, { text: paragraph, citations: citationIndices }) }, p))), section.stats.map((stat, s) => (_jsx("p", { className: "ignite-wiki-stat", children: _jsx(CitedText, { text: statText(stat.text, stat.citation), citations: citationIndices }) }, `stat-${s}`)))] }, i))), targets.length > 0 ? (_jsxs("section", { className: "ignite-wiki-related", "aria-labelledby": "related", children: [_jsx("h2", { id: "related", children: "Related" }), _jsx("ul", { children: targets.map((target) => (_jsxs("li", { children: [_jsx("a", { href: entityPath(target, options), children: target.canonical_name }), _jsxs("span", { className: "ignite-wiki-related-type", children: [" \u00B7 ", entityTypeLabel(target.entity_type)] })] }, target.slug))) })] })) : null, citations.length > 0 ? (_jsxs("section", { className: "ignite-wiki-citations", "aria-labelledby": "sources", children: [_jsx("h2", { id: "sources", children: "Sources" }), _jsx("ol", { children: citations.map((citation) => (_jsxs("li", { id: `cite-${citation.n}`, value: citation.n, children: [_jsx("a", { href: citation.url, children: citation.title }), _jsxs("span", { className: "ignite-wiki-cite-host", children: [" \u00B7 ", hostOf(citation.url)] }), _jsxs("span", { className: "ignite-wiki-cite-accessed", children: [" \u00B7 accessed ", citation.accessed] })] }, citation.n))) })] })) : null, _jsxs("footer", { className: "ignite-wiki-footer", children: [entity.author ? (_jsxs("p", { className: "ignite-wiki-author", children: ["By ", entity.author.url ? _jsx("a", { href: entity.author.url, children: entity.author.name }) : entity.author.name] })) : null, _jsxs("p", { className: "ignite-wiki-reviewed", children: ["Last reviewed ", _jsx("time", { dateTime: lastReviewed, children: lastReviewed })] }), changelog.length > 0 ? (_jsx("ul", { className: "ignite-wiki-changelog", children: changelog.map((entry, i) => (_jsxs("li", { children: [_jsx("time", { dateTime: entry.date, children: entry.date }), " \u2014 ", entry.note] }, i))) })) : null] }), _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: jsonLdText(jsonLd) } })] }) }));
+}
+export function groupByType(entities) {
+    return ENTITY_TYPES.map((type) => ({
+        type,
+        entities: entities
+            .filter((entity) => entity.entity_type === type)
+            .sort((a, b) => a.canonical_name.localeCompare(b.canonical_name)),
+    })).filter((group) => group.entities.length > 0);
+}
+// The index: one definition lede per entity, grouped by type. Renders nothing for an empty set.
+export function WikiEntityIndex({ entities, options }) {
+    const groups = groupByType(entities);
+    if (groups.length === 0)
+        return null;
+    return (_jsxs(IgniteFrame, { tokens: options.tokens, injectCss: options.injectCss, children: [_jsx("h1", { className: "ignite-index-title", children: "Wiki" }), groups.map((group) => (_jsxs("section", { className: "ignite-wiki-group", id: group.type, children: [_jsx("h2", { children: entityTypeLabel(group.type) }), _jsx("ul", { className: "ignite-tree", children: group.entities.map((entity) => (_jsxs("li", { className: "ignite-wiki-entry", children: [_jsx("a", { className: "ignite-wiki-link ignite-wiki-title", href: entityPath(entity, options), children: entity.canonical_name }), _jsx("p", { className: "ignite-wiki-meta", children: definitionLede(entity) })] }, entity.slug))) })] }, group.type)))] }));
+}
+// Sidebar for a wiki layout: every entity grouped by type, canonical names as anchors.
+export function WikiEntitySidebar({ entities, options }) {
+    const groups = groupByType(entities);
+    if (groups.length === 0)
+        return null;
+    return (_jsx("nav", { className: "ignite ignite-wiki-sidebar", "aria-label": "Wiki", children: groups.map((group) => (_jsxs("div", { children: [_jsx("p", { className: "ignite-wiki-meta", children: entityTypeLabel(group.type) }), _jsx("ul", { className: "ignite-tree", children: group.entities.map((entity) => (_jsx("li", { children: _jsx("a", { className: "ignite-wiki-link", href: entityPath(entity, options), children: entity.canonical_name }) }, entity.slug))) })] }, group.type))) }));
+}
+//# sourceMappingURL=render.js.map

package/dist/wiki-content/render.js.map

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

package/dist/wiki-content/schema.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+export declare const ENTITY_TYPES: readonly ["company", "product", "person", "concept", "location", "offering"];
+export type EntityType = (typeof ENTITY_TYPES)[number];
+export declare const wikiEntitySchema: z.ZodObject<{
+    entity_type: z.ZodEnum<{
+        company: "company";
+        product: "product";
+        person: "person";
+        concept: "concept";
+        location: "location";
+        offering: "offering";
+    }>;
+    canonical_name: z.ZodString;
+    slug: z.ZodString;
+    aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    definition: z.ZodObject<{
+        lede: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        founded: z.ZodOptional<z.ZodString>;
+        function: z.ZodOptional<z.ZodString>;
+        differentiator: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        heading: z.ZodString;
+        paragraphs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        stats: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            citation: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    cross_links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        target_slug: z.ZodString;
+        anchor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    citations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        n: z.ZodNumber;
+        url: z.ZodString;
+        title: z.ZodString;
+        accessed: z.ZodString;
+    }, z.core.$strip>>>;
+    author: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    changelog: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>>>;
+    same_as: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    imported_from: z.ZodOptional<z.ZodObject<{
+        source: z.ZodLiteral<"ignite">;
+        slug: z.ZodString;
+        dateModified: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WikiEntity = z.infer<typeof wikiEntitySchema>;
+export type WikiEntityInput = z.input<typeof wikiEntitySchema>;
+export type WikiIssue = {
+    file: string;
+    message: string;
+};
+export declare function parseWikiEntity(file: string, raw: unknown): {
+    entity: WikiEntity | null;
+    issues: WikiIssue[];
+};
+export declare function validateWikiSet(entries: Array<{
+    file: string;
+    entity: WikiEntity;
+}>): WikiIssue[];
+export declare function fileSlug(file: string): string | null;
+export declare function entityTypeLabel(type: EntityType): string;
+export declare function schemaOrgType(type: EntityType): string;
+export declare function definitionLede(entity: WikiEntity): string;