@pterodoc/core 0.2.0

package/LICENCE.md

@@ -0,0 +1,10 @@
+Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
+
+Copyright (c) Onyx <hello@onyx.ac> (https://onyx.ac)
+
+This work is licensed under the Creative Commons Attribution-ShareAlike 4.0
+International License. You are free to share and adapt this work, including
+commercially, provided you give appropriate attribution and distribute any
+derivative works under the same license.
+
+Full legal text: https://creativecommons.org/licenses/by-sa/4.0/legalcode

package/README.md

@@ -0,0 +1,12 @@
+# @pterodoc/core
+
+The parts of [pterodoc](https://github.com/onyx-ac/pterodoc) that know neither where a
+documentation model came from nor where it is going: markdown and MDX rendering to
+Gutenberg blocks, the site model and page tree, the target contract, configuration, and
+the reconciler.
+
+You probably want the [`pterodoc`](https://www.npmjs.com/package/pterodoc) package
+instead. This one is what a source package (`@pterodoc/docusaurus`) or a target package
+(`@pterodoc/wordpress`) builds on.
+
+Licensed CC-BY-SA-4.0.

package/lib/chunks/capture-BhdvHwrN.js

@@ -0,0 +1,428 @@
+import 'node:fs';
+import 'node:crypto';
+import { t as titleCase, C as ConfigError, V as VERSION } from './paths-Bh6UsRI9.js';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+/**
+ * The page tree.
+ *
+ * Docusaurus hands over resolved sidebars — autogenerated ones already
+ * expanded — and documents that already know their permalink and their
+ * neighbours. This turns that into the tree of pages the target will mirror:
+ * one node per page, ordered as the sidebar orders them.
+ */
+/** The longest directory prefix shared by a set of tree paths. */
+function commonDirectory(paths) {
+    if (paths.length === 0)
+        return '';
+    const dirOf = (value) => {
+        const parts = value.split('/').filter(Boolean);
+        return parts.slice(0, -1);
+    };
+    let common = dirOf(paths[0]);
+    for (const value of paths.slice(1)) {
+        const parts = dirOf(value);
+        let index = 0;
+        while (index < common.length && index < parts.length && common[index] === parts[index])
+            index += 1;
+        common = common.slice(0, index);
+        if (common.length === 0)
+            break;
+    }
+    return common.join('/');
+}
+/**
+ * Walk resolved sidebars into document order and the categories that can name
+ * a directory.
+ */
+function flattenSidebars(items, docsById, issues) {
+    const order = [];
+    const categories = [];
+    const pathOf = (id) => docsById.get(id)?.treePath;
+    const walk = (nodes, deep, direct) => {
+        for (const node of nodes) {
+            if (node.type === 'ref') {
+                // A ref points into a different sidebar. It is a cross-reference, not a
+                // page of this one, so it never becomes a page here.
+                issues.add({
+                    code: 'sidebar-ref-item',
+                    severity: 'info',
+                    message: `The sidebar cross-references "${node.id}", which belongs to another sidebar and was not published here.`,
+                });
+                continue;
+            }
+            if (node.type === 'doc') {
+                const treePath = pathOf(node.id);
+                if (treePath === undefined) {
+                    issues.add({
+                        code: 'sidebar-doc-missing',
+                        severity: 'warning',
+                        message: `The sidebar lists "${node.id}", but no such document was loaded.`,
+                    });
+                    continue;
+                }
+                order.push(treePath);
+                deep?.push(treePath);
+                direct?.push(treePath);
+                continue;
+            }
+            if (node.type === 'category') {
+                const category = node;
+                const deepPaths = [];
+                const directPaths = [];
+                let linkPath;
+                if (category.link?.type === 'doc') {
+                    // The category's own page comes before its members. It is deliberately
+                    // kept out of `deepPaths`: it sits one level above them, and counting
+                    // it as a member would drag the shared directory up with it.
+                    linkPath = pathOf(category.link.id);
+                    if (linkPath !== undefined)
+                        order.push(linkPath);
+                }
+                walk(category.items ?? [], deepPaths, directPaths);
+                categories.push({ label: category.label, linkPath, deepPaths, directPaths });
+                // The parent does see it, because it really is one of the parent's pages.
+                if (linkPath !== undefined)
+                    deep?.push(linkPath);
+                deep?.push(...deepPaths);
+                continue;
+            }
+            // `link` and `html` entries are navigation furniture, not pages.
+            issues.add({
+                code: node.type === 'link' ? 'sidebar-link-item' : 'sidebar-html-item',
+                severity: 'info',
+                message: node.type === 'link'
+                    ? `The sidebar link "${node.label}" has no page to publish.`
+                    : 'A raw HTML sidebar entry has no page to publish.',
+            });
+        }
+    };
+    walk(items, null, null);
+    return { order, categories };
+}
+/**
+ * Build one version's page tree.
+ */
+function buildPageTree(input) {
+    const { version, issues } = input;
+    const sidebarNames = input.sidebars === 'all' ? Object.keys(version.sidebars) : input.sidebars;
+    const publishable = version.docs.filter((doc) => {
+        if (doc.unlisted && input.includeUnlisted !== true) {
+            issues.addFor(doc, {
+                code: 'doc-unlisted',
+                severity: 'info',
+                message: `"${doc.id}" is unlisted and was not published.`,
+            });
+            return false;
+        }
+        return true;
+    });
+    const docsById = new Map(publishable.map((doc) => [doc.id, doc]));
+    const order = [];
+    const categories = [];
+    for (const name of sidebarNames) {
+        const items = version.sidebars[name];
+        if (!items) {
+            issues.add({
+                code: 'sidebar-missing',
+                severity: 'warning',
+                message: `This version has no sidebar called "${name}".`,
+            });
+            continue;
+        }
+        const flattened = flattenSidebars(items, docsById, issues);
+        order.push(...flattened.order);
+        categories.push(...flattened.categories);
+    }
+    // Outermost category wins a directory; the rest become section labels.
+    const claimed = new Map();
+    const virtual = [];
+    for (const category of categories) {
+        if (category.deepPaths.length === 0 && category.linkPath === undefined) {
+            issues.add({
+                code: 'sidebar-category-empty',
+                severity: 'info',
+                message: `The sidebar category "${category.label}" has no published documents.`,
+            });
+            continue;
+        }
+        const directory = category.linkPath ?? commonDirectory(category.deepPaths);
+        if (directory && !claimed.has(directory))
+            claimed.set(directory, category.label);
+        else
+            virtual.push(category);
+    }
+    const byPath = new Map();
+    const root = {
+        path: '',
+        slug: '',
+        kind: 'root',
+        title: input.rootTitle,
+        children: [],
+        menuOrder: 0,
+        navIndex: -1,
+        sections: [],
+        versionName: version.name,
+        inSidebar: true,
+    };
+    byPath.set('', root);
+    const parentPathOf = (value) => {
+        const parts = value.split('/').filter(Boolean);
+        return parts.slice(0, -1).join('/');
+    };
+    const ensureDir = (dirPath) => {
+        if (dirPath === '')
+            return root;
+        const existing = byPath.get(dirPath);
+        if (existing)
+            return existing;
+        const parent = ensureDir(parentPathOf(dirPath));
+        const slug = dirPath.slice(dirPath.lastIndexOf('/') + 1);
+        const node = {
+            path: dirPath,
+            slug,
+            kind: 'dir',
+            title: claimed.get(dirPath) ?? titleCase(slug),
+            parent,
+            children: [],
+            menuOrder: 0,
+            navIndex: -1,
+            sections: [],
+            versionName: version.name,
+            inSidebar: false,
+        };
+        byPath.set(dirPath, node);
+        return node;
+    };
+    // Only what a published sidebar reaches becomes a page. A document that
+    // belongs to another sidebar — a generated API reference, say — is not
+    // orphaned, it simply is not part of what was asked for.
+    const reachable = new Set(order);
+    const included = publishable.filter((doc) => {
+        if (doc.treePath === '' || reachable.has(doc.treePath))
+            return true;
+        if (doc.sidebarName === undefined && input.includeOrphans === true)
+            return true;
+        return false;
+    });
+    // The version root can be a document too, when one has the version's own slug.
+    const rootDoc = included.find((doc) => doc.treePath === '');
+    if (rootDoc) {
+        root.doc = rootDoc;
+        if (!input.rootTitle)
+            root.title = rootDoc.title;
+    }
+    for (const doc of included) {
+        if (doc.treePath === '')
+            continue;
+        const existing = byPath.get(doc.treePath);
+        if (existing) {
+            // A directory page and a document at the same path: the document wins,
+            // which is how an `index.md` or a front-matter slug takes over a folder.
+            existing.doc = doc;
+            existing.description = doc.description;
+            if (!claimed.has(doc.treePath))
+                existing.title = doc.title;
+            continue;
+        }
+        const parent = ensureDir(parentPathOf(doc.treePath));
+        const slug = doc.treePath.slice(doc.treePath.lastIndexOf('/') + 1);
+        byPath.set(doc.treePath, {
+            path: doc.treePath,
+            slug,
+            kind: 'doc',
+            // A category that names this page wins the title: on WordPress the page
+            // title is also its navigation label, and the sidebar label is what a
+            // reader saw in the navigation on Docusaurus.
+            title: claimed.get(doc.treePath) ?? doc.title,
+            description: doc.description,
+            doc,
+            parent,
+            children: [],
+            menuOrder: 0,
+            navIndex: -1,
+            sections: [],
+            versionName: version.name,
+            inSidebar: false,
+        });
+    }
+    // Sidebar order first: placing a node places any ancestor not yet placed, so
+    // a directory lands at the position of its first member.
+    const placed = new Set(['']);
+    const place = (node) => {
+        if (placed.has(node.path))
+            return;
+        const parent = node.parent ?? root;
+        place(parent);
+        parent.children.push(node);
+        placed.add(node.path);
+    };
+    for (const treePath of order) {
+        const node = byPath.get(treePath);
+        if (!node)
+            continue;
+        node.inSidebar = true;
+        if (node !== root)
+            place(node);
+    }
+    for (const node of [...byPath.values()].sort((a, b) => a.path.localeCompare(b.path))) {
+        if (placed.has(node.path))
+            continue;
+        place(node);
+        issues.addFor(node.doc, {
+            code: 'doc-not-in-sidebar',
+            severity: 'info',
+            message: `"${node.path}" is not in a published sidebar; it was placed after the pages that are.`,
+            path: node.path,
+        });
+    }
+    // Grouping for generated indexes.
+    const sectionLabelOf = new Map();
+    for (const category of virtual) {
+        for (const treePath of category.directPaths)
+            sectionLabelOf.set(treePath, category.label);
+    }
+    const chain = [];
+    const finish = (node) => {
+        node.children.forEach((child, index) => {
+            child.menuOrder = index * 10;
+        });
+        const sections = [];
+        for (const child of node.children) {
+            const label = sectionLabelOf.get(child.path);
+            const last = sections[sections.length - 1];
+            if (last && last.label === label)
+                last.children.push(child);
+            else
+                sections.push({ label, children: [child] });
+        }
+        node.sections = sections;
+        for (const child of node.children) {
+            child.navIndex = chain.length;
+            chain.push(child);
+            finish(child);
+        }
+    };
+    finish(root);
+    // Pagination walks the pages that exist here.
+    //
+    // Docusaurus's own previous/next skip a category that has no document of its
+    // own, because on that site such a category is not a page. Here it is one:
+    // it has a URL a reader can land on, so sending them past it would be wrong.
+    chain.forEach((node, index) => {
+        const previous = chain[index - 1];
+        const next = chain[index + 1];
+        if (previous)
+            node.previousPath = previous.path;
+        if (next)
+            node.nextPath = next.path;
+    });
+    const byPermalink = new Map();
+    const bySourcePath = new Map();
+    for (const node of byPath.values()) {
+        if (!node.doc)
+            continue;
+        byPermalink.set(node.doc.permalink, node);
+        byPermalink.set(node.doc.permalink.replace(/\/$/, ''), node);
+        bySourcePath.set(node.doc.sourceRelativePath, node);
+    }
+    return { root, chain, byPath, byPermalink, bySourcePath };
+}
+
+/**
+ * Where a site model comes from.
+ *
+ * The rest of the tool takes a reader rather than calling a source directly,
+ * which is what lets it be tested against a captured model, driven by a build,
+ * or pointed at a real site. The interface lives here, with the model it
+ * produces; each source implements it in its own package.
+ */
+/**
+ * Read from a model already in hand, which is what a build-time plugin does.
+ *
+ * @param model The model to serve.
+ */
+function createMemoryReader(model) {
+    return {
+        kind: 'memory',
+        async locales() {
+            return [model.locale];
+        },
+        async read() {
+            return model;
+        },
+    };
+}
+
+/**
+ * Capturing a site model to disk.
+ *
+ * A captured model is how the tests avoid needing a Docusaurus install, how a
+ * user files a reproducible bug, and how a site whose Docusaurus version this
+ * tool cannot load can still be rendered.
+ */
+/** Serialise a model. */
+function serializeModel(model) {
+    const captured = {
+        capture: 1,
+        pterodoc: VERSION,
+        capturedAt: new Date().toISOString(),
+        model,
+    };
+    return `${JSON.stringify(captured, null, 2)}\n`;
+}
+/** Write a model to a file, creating its directory. */
+async function writeCapture(file, model) {
+    await fs.mkdir(path.dirname(path.resolve(file)), { recursive: true });
+    await fs.writeFile(file, serializeModel(model), 'utf8');
+}
+/**
+ * Read a captured model.
+ *
+ * @param file Path of the capture.
+ */
+async function readCapture(file) {
+    let raw;
+    try {
+        raw = await fs.readFile(file, 'utf8');
+    }
+    catch {
+        throw new ConfigError(`Could not read the model at ${file}.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new ConfigError(`${file} is not valid JSON.`);
+    }
+    if (parsed.capture !== 1 || !parsed.model) {
+        throw new ConfigError(`${file} is not a pterodoc model capture. Produce one with \`pterodoc capture\`.`);
+    }
+    return parsed.model;
+}
+/**
+ * Read from a model captured earlier.
+ *
+ * @param file Path to the capture.
+ */
+function createCaptureReader(file) {
+    let cached;
+    const load = async () => {
+        cached ??= await readCapture(file);
+        return cached;
+    };
+    return {
+        kind: 'captured',
+        async locales() {
+            return [(await load()).locale];
+        },
+        async read() {
+            return load();
+        },
+    };
+}
+
+export { createMemoryReader as a, buildPageTree as b, createCaptureReader as c, readCapture as r, serializeModel as s, writeCapture as w };
+//# sourceMappingURL=capture-BhdvHwrN.js.map

package/lib/chunks/capture-BhdvHwrN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-BhdvHwrN.js","sources":["../../src/model/tree.ts","../../src/model/reader.ts","../../src/model/capture.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":";;;;;;AAAA;;;;;;;AAOG;AAwEH;AACA,SAAS,eAAe,CAAC,KAAe,EAAA;AACtC,IAAA,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;AACjC,IAAA,MAAM,KAAK,GAAG,CAAC,KAAa,KAAc;AACxC,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;AAC3B,IAAA,CAAC;IACD,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;AAClC,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,IAAI,KAAK,GAAG,CAAC;QACb,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC;QAClG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;AAC/B,QAAA,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE;IAC3B;AACA,IAAA,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AACzB;AAaA;;;AAGG;AACH,SAAS,eAAe,CACtB,KAAoB,EACpB,QAA0B,EAC1B,MAAsB,EAAA;IAEtB,MAAM,KAAK,GAAa,EAAE;IAC1B,MAAM,UAAU,GAAmB,EAAE;AAErC,IAAA,MAAM,MAAM,GAAG,CAAC,EAAU,KAAyB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ;IAE7E,MAAM,IAAI,GAAG,CAAC,KAAoB,EAAE,IAAqB,EAAE,MAAuB,KAAU;AAC1F,QAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;AACxB,YAAA,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE;;;gBAGvB,MAAM,CAAC,GAAG,CAAC;AACT,oBAAA,IAAI,EAAE,kBAAkB;AACxB,oBAAA,QAAQ,EAAE,MAAM;AAChB,oBAAA,OAAO,EAAE,CAAA,8BAAA,EAAiC,IAAI,CAAC,EAAE,CAAA,+DAAA,CAAiE;AACnH,iBAAA,CAAC;gBACF;YACF;AAEA,YAAA,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE;gBACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AAChC,gBAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;oBAC1B,MAAM,CAAC,GAAG,CAAC;AACT,wBAAA,IAAI,EAAE,qBAAqB;AAC3B,wBAAA,QAAQ,EAAE,SAAS;AACnB,wBAAA,OAAO,EAAE,CAAA,mBAAA,EAAsB,IAAI,CAAC,EAAE,CAAA,mCAAA,CAAqC;AAC5E,qBAAA,CAAC;oBACF;gBACF;AACA,gBAAA,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;AACpB,gBAAA,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;AACpB,gBAAA,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;gBACtB;YACF;AAEA,YAAA,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE;gBAC5B,MAAM,QAAQ,GAAG,IAA2B;gBAC5C,MAAM,SAAS,GAAa,EAAE;gBAC9B,MAAM,WAAW,GAAa,EAAE;AAChC,gBAAA,IAAI,QAA4B;gBAEhC,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,KAAK,KAAK,EAAE;;;;oBAIjC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,IAAI,QAAQ,KAAK,SAAS;AAAE,wBAAA,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAClD;gBACA,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC;AAClD,gBAAA,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;;gBAE5E,IAAI,QAAQ,KAAK,SAAS;AAAE,oBAAA,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;AAChD,gBAAA,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;gBACxB;YACF;;YAGA,MAAM,CAAC,GAAG,CAAC;AACT,gBAAA,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,MAAM,GAAG,mBAAmB,GAAG,mBAAmB;AACtE,gBAAA,QAAQ,EAAE,MAAM;AAChB,gBAAA,OAAO,EACL,IAAI,CAAC,IAAI,KAAK;AACZ,sBAAE,CAAA,kBAAA,EAAqB,IAAI,CAAC,KAAK,CAAA,yBAAA;AACjC,sBAAE,kDAAkD;AACzD,aAAA,CAAC;QACJ;AACF,IAAA,CAAC;AAED,IAAA,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC;AACvB,IAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE;AAC9B;AAEA;;AAEG;AACG,SAAU,aAAa,CAAC,KAAyB,EAAA;AACrD,IAAA,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK;IACjC,MAAM,YAAY,GAChB,KAAK,CAAC,QAAQ,KAAK,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ;IAE3E,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,KAAI;QAC9C,IAAI,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,eAAe,KAAK,IAAI,EAAE;AAClD,YAAA,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;AACjB,gBAAA,IAAI,EAAE,cAAc;AACpB,gBAAA,QAAQ,EAAE,MAAM;AAChB,gBAAA,OAAO,EAAE,CAAA,CAAA,EAAI,GAAG,CAAC,EAAE,CAAA,oCAAA,CAAsC;AAC1D,aAAA,CAAC;AACF,YAAA,OAAO,KAAK;QACd;AACA,QAAA,OAAO,IAAI;AACb,IAAA,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAEjE,MAAM,KAAK,GAAa,EAAE;IAC1B,MAAM,UAAU,GAAmB,EAAE;AACrC,IAAA,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,CAAC,GAAG,CAAC;AACT,gBAAA,IAAI,EAAE,iBAAiB;AACvB,gBAAA,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,CAAA,oCAAA,EAAuC,IAAI,CAAA,EAAA,CAAI;AACzD,aAAA,CAAC;YACF;QACF;QACA,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC;QAC9B,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC;IAC1C;;AAGA,IAAA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB;IACzC,MAAM,OAAO,GAAmB,EAAE;AAClC,IAAA,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE;AACjC,QAAA,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE;YACtE,MAAM,CAAC,GAAG,CAAC;AACT,gBAAA,IAAI,EAAE,wBAAwB;AAC9B,gBAAA,QAAQ,EAAE,MAAM;AAChB,gBAAA,OAAO,EAAE,CAAA,sBAAA,EAAyB,QAAQ,CAAC,KAAK,CAAA,6BAAA,CAA+B;AAChF,aAAA,CAAC;YACF;QACF;AACA,QAAA,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC1E,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC;;AAC3E,YAAA,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC7B;AAEA,IAAA,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB;AAC1C,IAAA,MAAM,IAAI,GAAa;AACrB,QAAA,IAAI,EAAE,EAAE;AACR,QAAA,IAAI,EAAE,EAAE;AACR,QAAA,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,KAAK,CAAC,SAAS;AACtB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,EAAE;AACZ,QAAA,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,OAAO,CAAC,IAAI;AACzB,QAAA,SAAS,EAAE,IAAI;KAChB;AACD,IAAA,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC;AAEpB,IAAA,MAAM,YAAY,GAAG,CAAC,KAAa,KAAY;AAC7C,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;AAC9C,QAAA,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;AACrC,IAAA,CAAC;AAED,IAAA,MAAM,SAAS,GAAG,CAAC,OAAe,KAAc;QAC9C,IAAI,OAAO,KAAK,EAAE;AAAE,YAAA,OAAO,IAAI;QAC/B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;AACpC,QAAA,IAAI,QAAQ;AAAE,YAAA,OAAO,QAAQ;QAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/C,QAAA,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACxD,QAAA,MAAM,IAAI,GAAa;AACrB,YAAA,IAAI,EAAE,OAAO;YACb,IAAI;AACJ,YAAA,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC;YAC9C,MAAM;AACN,YAAA,QAAQ,EAAE,EAAE;AACZ,YAAA,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,EAAE;AACZ,YAAA,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,OAAO,CAAC,IAAI;AACzB,YAAA,SAAS,EAAE,KAAK;SACjB;AACD,QAAA,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;AACzB,QAAA,OAAO,IAAI;AACb,IAAA,CAAC;;;;AAKD,IAAA,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC;IAChC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,KAAI;AAC1C,QAAA,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;AAAE,YAAA,OAAO,IAAI;QACnE,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI;AAAE,YAAA,OAAO,IAAI;AAC/E,QAAA,OAAO,KAAK;AACd,IAAA,CAAC,CAAC;;AAGF,IAAA,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC;IAC3D,IAAI,OAAO,EAAE;AACX,QAAA,IAAI,CAAC,GAAG,GAAG,OAAO;QAClB,IAAI,CAAC,KAAK,CAAC,SAAS;AAAE,YAAA,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK;IAClD;AAEA,IAAA,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE;AAC1B,QAAA,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;YAAE;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzC,IAAI,QAAQ,EAAE;;;AAGZ,YAAA,QAAQ,CAAC,GAAG,GAAG,GAAG;AAClB,YAAA,QAAQ,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW;YACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;AAAE,gBAAA,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK;YAC1D;QACF;QACA,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACpD,QAAA,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAClE,QAAA,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,IAAI;AACJ,YAAA,IAAI,EAAE,KAAK;;;;AAIX,YAAA,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,KAAK;YAC7C,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,GAAG;YACH,MAAM;AACN,YAAA,QAAQ,EAAE,EAAE;AACZ,YAAA,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,EAAE;AACZ,YAAA,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,OAAO,CAAC,IAAI;AACzB,YAAA,SAAS,EAAE,KAAK;AACjB,SAAA,CAAC;IACJ;;;IAIA,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS,CAAC,EAAE,CAAC,CAAC;AACpC,IAAA,MAAM,KAAK,GAAG,CAAC,IAAc,KAAU;AACrC,QAAA,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE;AAC3B,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI;QAClC,KAAK,CAAC,MAAM,CAAC;AACb,QAAA,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;AAC1B,QAAA,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AACvB,IAAA,CAAC;AAED,IAAA,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;AACjC,QAAA,IAAI,CAAC,IAAI;YAAE;AACX,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI;QACrB,IAAI,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC;IAChC;AAEA,IAAA,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE;AACpF,QAAA,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE;QAC3B,KAAK,CAAC,IAAI,CAAC;AACX,QAAA,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;AACtB,YAAA,IAAI,EAAE,oBAAoB;AAC1B,YAAA,QAAQ,EAAE,MAAM;AAChB,YAAA,OAAO,EAAE,CAAA,CAAA,EAAI,IAAI,CAAC,IAAI,CAAA,wEAAA,CAA0E;YAChG,IAAI,EAAE,IAAI,CAAC,IAAI;AAChB,SAAA,CAAC;IACJ;;AAGA,IAAA,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB;AAChD,IAAA,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE;AAC9B,QAAA,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,WAAW;YAAE,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;IAC3F;IAEA,MAAM,KAAK,GAAe,EAAE;AAC5B,IAAA,MAAM,MAAM,GAAG,CAAC,IAAc,KAAU;QACtC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,KAAI;AACrC,YAAA,KAAK,CAAC,SAAS,GAAG,KAAK,GAAG,EAAE;AAC9B,QAAA,CAAC,CAAC;QACF,MAAM,QAAQ,GAAyB,EAAE;AACzC,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1C,YAAA,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;AAAE,gBAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;;AACtD,gBAAA,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD;AACA,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;AACjC,YAAA,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,MAAM;AAC7B,YAAA,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC;QACf;AACF,IAAA,CAAC;IACD,MAAM,CAAC,IAAI,CAAC;;;;;;IAOZ,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,KAAI;QAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;AAC7B,QAAA,IAAI,QAAQ;AAAE,YAAA,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,IAAI;AAC/C,QAAA,IAAI,IAAI;AAAE,YAAA,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI;AACrC,IAAA,CAAC,CAAC;AAEF,IAAA,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB;AAC/C,IAAA,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB;IAChD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE;QACf,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC;AACzC,QAAA,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC;QAC5D,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC;IACrD;IAEA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE;AAC3D;;AC/ZA;;;;;;;AAOG;AAcH;;;;AAIG;AACG,SAAU,kBAAkB,CAAC,KAAgB,EAAA;IACjD,OAAO;AACL,QAAA,IAAI,EAAE,QAAQ;AACd,QAAA,MAAM,OAAO,GAAA;AACX,YAAA,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QACvB,CAAC;AACD,QAAA,MAAM,IAAI,GAAA;AACR,YAAA,OAAO,KAAK;QACd,CAAC;KACF;AACH;;ACpCA;;;;;;AAMG;AAoBH;AACM,SAAU,cAAc,CAAC,KAAgB,EAAA;AAC7C,IAAA,MAAM,QAAQ,GAAkB;AAC9B,QAAA,OAAO,EAAE,CAAC;AACV,QAAA,QAAQ,EAAE,OAAO;AACjB,QAAA,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,KAAK;KACN;AACD,IAAA,OAAO,CAAA,EAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA,EAAA,CAAI;AACjD;AAEA;AACO,eAAe,YAAY,CAAC,IAAY,EAAE,KAAgB,EAAA;IAC/D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACrE,IAAA,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;AACzD;AAEA;;;;AAIG;AACI,eAAe,WAAW,CAAC,IAAY,EAAA;AAC5C,IAAA,IAAI,GAAW;AACf,IAAA,IAAI;QACF,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACvC;AAAE,IAAA,MAAM;AACN,QAAA,MAAM,IAAI,WAAW,CAAC,+BAA+B,IAAI,CAAA,CAAA,CAAG,CAAC;IAC/D;AAEA,IAAA,IAAI,MAA8B;AAClC,IAAA,IAAI;AACF,QAAA,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B;IACpD;AAAE,IAAA,MAAM;AACN,QAAA,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,CAAA,mBAAA,CAAqB,CAAC;IACrD;IAEA,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;AACzC,QAAA,MAAM,IAAI,WAAW,CACnB,GAAG,IAAI,CAAA,wEAAA,CAA0E,CAClF;IACH;IACA,OAAO,MAAM,CAAC,KAAK;AACrB;AAEA;;;;AAIG;AACG,SAAU,mBAAmB,CAAC,IAAY,EAAA;AAC9C,IAAA,IAAI,MAA6B;AACjC,IAAA,MAAM,IAAI,GAAG,YAA+B;AAC1C,QAAA,MAAM,KAAK,MAAM,WAAW,CAAC,IAAI,CAAC;AAClC,QAAA,OAAO,MAAM;AACf,IAAA,CAAC;IACD,OAAO;AACL,QAAA,IAAI,EAAE,UAAU;AAChB,QAAA,MAAM,OAAO,GAAA;YACX,OAAO,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,CAAC;QAChC,CAAC;AACD,QAAA,MAAM,IAAI,GAAA;YACR,OAAO,IAAI,EAAE;QACf,CAAC;KACF;AACH;;"}

package/lib/chunks/issues-DBsPh6ek.js

@@ -0,0 +1,55 @@
+/**
+ * Structured diagnostics.
+ *
+ * Everything a run wants to tell the user goes through here rather than into
+ * free-form strings, so the CLI can group them, `--json` can emit them, and
+ * `--strict` can decide whether they should fail the run.
+ */
+const ORDER = { info: 0, warning: 1, error: 2 };
+/** Accumulates issues during a run. */
+class IssueCollector {
+    issues = [];
+    /** Record an issue. */
+    add(issue) {
+        this.issues.push(issue);
+    }
+    /** Record an issue that inherits a document's file and id. */
+    addFor(doc, issue) {
+        this.add({
+            ...issue,
+            docId: doc?.id,
+            file: issue.file ?? doc?.sourceRelativePath,
+        });
+    }
+    /** True when any issue is at least as severe as `severity`. */
+    hasAtLeast(severity) {
+        return this.issues.some((issue) => ORDER[issue.severity] >= ORDER[severity]);
+    }
+    /** Issues at least as severe as `severity`. */
+    atLeast(severity) {
+        return this.issues.filter((issue) => ORDER[issue.severity] >= ORDER[severity]);
+    }
+    /** How many issues carry each code, for a compact summary. */
+    countByCode() {
+        const counts = {};
+        for (const issue of this.issues)
+            counts[issue.code] = (counts[issue.code] ?? 0) + 1;
+        return counts;
+    }
+}
+/** Compare two severities; positive when `a` is more severe than `b`. */
+function compareSeverity(a, b) {
+    return ORDER[a] - ORDER[b];
+}
+/** Render an issue as one line, with its position when it has one. */
+function formatIssue(issue) {
+    const where = issue.file
+        ? `${issue.file}${issue.line ? `:${issue.line}${issue.column ? `:${issue.column}` : ''}` : ''}: `
+        : issue.path
+            ? `${issue.path || '(root)'}: `
+            : '';
+    return `${where}${issue.message}`;
+}
+
+export { IssueCollector as I, compareSeverity as c, formatIssue as f };
+//# sourceMappingURL=issues-DBsPh6ek.js.map

package/lib/chunks/issues-DBsPh6ek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues-DBsPh6ek.js","sources":["../../src/util/issues.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;AAMG;AAKH,MAAM,KAAK,GAA6B,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;AAsBzE;MACa,cAAc,CAAA;IAChB,MAAM,GAAY,EAAE;;AAG7B,IAAA,GAAG,CAAC,KAAY,EAAA;AACd,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IACzB;;IAGA,MAAM,CACJ,GAA4D,EAC5D,KAAwD,EAAA;QAExD,IAAI,CAAC,GAAG,CAAC;AACP,YAAA,GAAG,KAAK;YACR,KAAK,EAAE,GAAG,EAAE,EAAE;AACd,YAAA,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,kBAAkB;AAC5C,SAAA,CAAC;IACJ;;AAGA,IAAA,UAAU,CAAC,QAAkB,EAAA;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9E;;AAGA,IAAA,OAAO,CAAC,QAAkB,EAAA;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChF;;IAGA,WAAW,GAAA;QACT,MAAM,MAAM,GAA2B,EAAE;AACzC,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;AAAE,YAAA,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACnF,QAAA,OAAO,MAAM;IACf;AACD;AAED;AACM,SAAU,eAAe,CAAC,CAAW,EAAE,CAAW,EAAA;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AAC5B;AAEA;AACM,SAAU,WAAW,CAAC,KAAY,EAAA;AACtC,IAAA,MAAM,KAAK,GAAG,KAAK,CAAC;AAClB,UAAE,CAAA,EAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,CAAA,CAAA,EAAI,KAAK,CAAC,IAAI,CAAA,EAAG,KAAK,CAAC,MAAM,GAAG,CAAA,CAAA,EAAI,KAAK,CAAC,MAAM,CAAA,CAAE,GAAG,EAAE,CAAA,CAAE,GAAG,EAAE,CAAA,EAAA;UAC3F,KAAK,CAAC;AACN,cAAE,CAAA,EAAG,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAA,EAAA;cACzB,EAAE;AACR,IAAA,OAAO,GAAG,KAAK,CAAA,EAAG,KAAK,CAAC,OAAO,EAAE;AACnC;;"}

package/lib/chunks/mime-2SUyOolJ.js

@@ -0,0 +1,62 @@
+import { createHash } from 'node:crypto';
+
+/** Content hashing, used to give an uploaded asset a stable identity. */
+/**
+ * A short content hash.
+ *
+ * Sixteen hex characters of SHA-256: long enough that a collision across one
+ * site's assets is not a practical concern, short enough to sit inside a
+ * WordPress slug without dominating it.
+ */
+function contentHash(bytes) {
+    return createHash('sha256').update(bytes).digest('hex').slice(0, 16);
+}
+
+/**
+ * Extension to media type.
+ *
+ * A twenty-entry table rather than a dependency: these are the types a
+ * documentation site actually embeds, and WordPress rejects most others.
+ */
+const TYPES = {
+    '.apng': 'image/apng',
+    '.avif': 'image/avif',
+    '.bmp': 'image/bmp',
+    '.gif': 'image/gif',
+    '.ico': 'image/x-icon',
+    '.jpeg': 'image/jpeg',
+    '.jpg': 'image/jpeg',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.tif': 'image/tiff',
+    '.tiff': 'image/tiff',
+    '.webp': 'image/webp',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.ogv': 'video/ogg',
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.pdf': 'application/pdf',
+    '.zip': 'application/zip',
+    '.json': 'application/json',
+    '.txt': 'text/plain',
+};
+/** The media type for a file name, or undefined when we do not recognise it. */
+function mimeTypeFor(fileName) {
+    const dot = fileName.lastIndexOf('.');
+    if (dot === -1)
+        return undefined;
+    return TYPES[fileName.slice(dot).toLowerCase()];
+}
+/**
+ * True for types WordPress refuses by default.
+ *
+ * SVG is the one that surprises people: it is blocked unless a plugin allows
+ * it, because an SVG can carry script.
+ */
+function isBlockedByDefault(mime) {
+    return mime === 'image/svg+xml';
+}
+
+export { contentHash as c, isBlockedByDefault as i, mimeTypeFor as m };
+//# sourceMappingURL=mime-2SUyOolJ.js.map

package/lib/chunks/mime-2SUyOolJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-2SUyOolJ.js","sources":["../../src/util/hash.ts","../../src/util/mime.ts"],"sourcesContent":[null,null],"names":[],"mappings":";;AAAA;AAIA;;;;;;AAMG;AACG,SAAU,WAAW,CAAC,KAA0B,EAAA;IACpD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;AACtE;;ACbA;;;;;AAKG;AAEH,MAAM,KAAK,GAA2B;AACpC,IAAA,OAAO,EAAE,YAAY;AACrB,IAAA,OAAO,EAAE,YAAY;AACrB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,MAAM,EAAE,cAAc;AACtB,IAAA,OAAO,EAAE,YAAY;AACrB,IAAA,MAAM,EAAE,YAAY;AACpB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,MAAM,EAAE,eAAe;AACvB,IAAA,MAAM,EAAE,YAAY;AACpB,IAAA,OAAO,EAAE,YAAY;AACrB,IAAA,OAAO,EAAE,YAAY;AACrB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,OAAO,EAAE,YAAY;AACrB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,MAAM,EAAE,YAAY;AACpB,IAAA,MAAM,EAAE,WAAW;AACnB,IAAA,MAAM,EAAE,iBAAiB;AACzB,IAAA,MAAM,EAAE,iBAAiB;AACzB,IAAA,OAAO,EAAE,kBAAkB;AAC3B,IAAA,MAAM,EAAE,YAAY;CACrB;AAED;AACM,SAAU,WAAW,CAAC,QAAgB,EAAA;IAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC;IACrC,IAAI,GAAG,KAAK,EAAE;AAAE,QAAA,OAAO,SAAS;AAChC,IAAA,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACjD;AAEA;;;;;AAKG;AACG,SAAU,kBAAkB,CAAC,IAAY,EAAA;IAC7C,OAAO,IAAI,KAAK,eAAe;AACjC;;"}