@forumulate/cli 0.8.0 → 0.10.0

package/dist/publish/preview.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIEW_NAME = void 0;
+exports.ciSource = ciSource;
+exports.sendPreview = sendPreview;
+const api_1 = require("./api");
+const context_1 = require("./context");
+const docs_apply_1 = require("./docs-apply");
+/** The name a preview may have — the API's rule (`pr-123`, `mr-45`, `feature-x`). */
+exports.PREVIEW_NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/i;
+/**
+ * The pull request this run is for, from the CI's own variables — GitHub
+ * Actions, GitLab CI, Bitbucket Pipelines, Gitea/Forgejo Actions, Azure
+ * Pipelines — or `FORUMULATE_PREVIEW_*` for anything else. Every field is
+ * optional: a preview made from a laptop simply has no source.
+ */
+function ciSource(env) {
+    const pick = (...vals) => vals.find((v) => v && v.trim())?.trim();
+    if (env.FORUMULATE_PREVIEW_PROVIDER || env.FORUMULATE_PREVIEW_URL)
+        return clean({
+            provider: env.FORUMULATE_PREVIEW_PROVIDER,
+            repository: env.FORUMULATE_PREVIEW_REPOSITORY,
+            number: env.FORUMULATE_PREVIEW_NUMBER,
+            ref: env.FORUMULATE_PREVIEW_REF,
+            sha: env.FORUMULATE_PREVIEW_SHA,
+            url: env.FORUMULATE_PREVIEW_URL,
+        });
+    if (env.GITLAB_CI)
+        return clean({
+            provider: 'gitlab',
+            repository: env.CI_PROJECT_PATH,
+            number: env.CI_MERGE_REQUEST_IID,
+            ref: pick(env.CI_MERGE_REQUEST_SOURCE_BRANCH_NAME, env.CI_COMMIT_REF_NAME),
+            sha: env.CI_COMMIT_SHA,
+            url: env.CI_PROJECT_URL && env.CI_MERGE_REQUEST_IID
+                ? `${env.CI_PROJECT_URL}/-/merge_requests/${env.CI_MERGE_REQUEST_IID}`
+                : undefined,
+        });
+    if (env.BITBUCKET_REPO_FULL_NAME)
+        return clean({
+            provider: 'bitbucket',
+            repository: env.BITBUCKET_REPO_FULL_NAME,
+            number: env.BITBUCKET_PR_ID,
+            ref: env.BITBUCKET_BRANCH,
+            sha: env.BITBUCKET_COMMIT,
+            url: env.BITBUCKET_PR_ID
+                ? `https://bitbucket.org/${env.BITBUCKET_REPO_FULL_NAME}/pull-requests/${env.BITBUCKET_PR_ID}`
+                : undefined,
+        });
+    if (env.GITHUB_ACTIONS || env.GITEA_ACTIONS) {
+        const number = /^refs\/pull\/(\d+)\//.exec(env.GITHUB_REF ?? '')?.[1];
+        const server = (env.GITHUB_SERVER_URL ?? 'https://github.com').replace(/\/$/, '');
+        return clean({
+            provider: env.GITEA_ACTIONS ? 'gitea' : 'github',
+            repository: env.GITHUB_REPOSITORY,
+            number,
+            ref: pick(env.GITHUB_HEAD_REF, env.GITHUB_REF_NAME),
+            sha: env.GITHUB_SHA,
+            url: number && env.GITHUB_REPOSITORY ? `${server}/${env.GITHUB_REPOSITORY}/pull/${number}` : undefined,
+        });
+    }
+    if (env.TF_BUILD)
+        return clean({
+            provider: 'azure',
+            repository: env.BUILD_REPOSITORY_NAME,
+            number: env.SYSTEM_PULLREQUEST_PULLREQUESTID,
+            ref: env.SYSTEM_PULLREQUEST_SOURCEBRANCH,
+            sha: env.BUILD_SOURCEVERSION,
+        });
+    return {};
+}
+function clean(s) {
+    return Object.fromEntries(Object.entries(s).filter(([, v]) => v));
+}
+/** Bytes per request: comfortably under the API's body limit. */
+const BATCH_BYTES = 3_000_000;
+/** Send this space's planned pages to the preview; returns what the API answered. */
+async function sendPreview(ctx, plan, existingAssets, opts) {
+    const sends = [...plan.sends.values()].flat();
+    const removed = plan.prunePages.map((p) => p.slug);
+    if (!sends.length && !removed.length) {
+        ctx.line({ verb: 'same', what: `preview ${opts.name}`, detail: 'nothing differs from what is published' });
+    }
+    // A preview writes no page, but it does upload the pictures those pages use.
+    const writer = new api_1.PublishApi({ ...ctx.api.opts, readOnly: false });
+    const wctx = { ...ctx, api: writer };
+    const urls = await (0, docs_apply_1.uploadAssetsFor)(wctx, sends.map((s) => s.page.file), existingAssets);
+    const pages = sends.map((s) => ({
+        slug: s.page.slug,
+        title: s.page.title,
+        file: s.page.file,
+        markdown: (0, docs_apply_1.payloadOf)(wctx, s.page, urls.get(s.page.file) ?? new Map()),
+    }));
+    const batches = [[]];
+    let size = 0;
+    for (const p of pages) {
+        if (size + p.markdown.length > BATCH_BYTES && batches[batches.length - 1].length) {
+            batches.push([]);
+            size = 0;
+        }
+        batches[batches.length - 1].push(p);
+        size += p.markdown.length;
+    }
+    let answer = null;
+    for (const [i, batch] of batches.entries()) {
+        answer = await writer.post((0, context_1.spacePath)(ctx, '/previews'), {
+            name: opts.name,
+            pages: batch,
+            // Removals ride on the first request; later ones only add pages.
+            ...(i === 0 && removed.length ? { removed } : {}),
+            ...(i > 0 ? { append: true } : {}),
+            ...(Object.keys(opts.source).length ? { source: opts.source } : {}),
+            ...(opts.ttlDays ? { ttlDays: opts.ttlDays } : {}),
+        });
+    }
+    if (!answer)
+        return null;
+    for (const s of sends)
+        ctx.line({ verb: 'preview', what: `page ${s.page.slug}`, detail: `${s.why} — in preview ${opts.name}` });
+    for (const slug of removed)
+        ctx.line({ verb: 'preview', what: `page ${slug}`, detail: `removed — in preview ${opts.name}` });
+    return {
+        space: ctx.spec.space ?? ctx.spaceId,
+        id: answer.preview.id,
+        name: answer.preview.name,
+        token: answer.token,
+        urls: answer.urls,
+        expiresAt: answer.preview.expiresAt,
+        summary: answer.preview.summary,
+        comment: answer.comment,
+    };
+}
+//# sourceMappingURL=preview.js.map

package/dist/publish/preview.js.map

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

package/dist/publish/redirects.d.ts

@@ -0,0 +1,13 @@
+import { type SpaceCtx } from './context';
+import type { ManifestRedirect } from './types';
+/** The rules a CSV file declares, by column name when it has a header. */
+export declare function rulesFromCsv(text: string): ManifestRedirect[];
+/** The rules as CSV in the import's columns — what the API is sent. */
+export declare function rulesToCsv(rules: ManifestRedirect[]): string;
+/** What the manifest declares for this space, read from the list or the file. */
+export declare function declaredRedirects(spec: {
+    redirects?: ManifestRedirect[] | string;
+}, manifestFile: string | null, root: string): ManifestRedirect[];
+/** Plan or apply this space's declared redirects. */
+export declare function syncRedirects(ctx: SpaceCtx, apply: boolean, manifestFile: string | null): Promise<void>;
+//# sourceMappingURL=redirects.d.ts.map

package/dist/publish/redirects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/publish/redirects.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAwDhD,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAqB7D;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAM5D;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAA;CAAE,EACjD,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,IAAI,EAAE,MAAM,GACX,gBAAgB,EAAE,CAMpB;AAMD,qDAAqD;AACrD,wBAAsB,aAAa,CACjC,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/publish/redirects.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rulesFromCsv = rulesFromCsv;
+exports.rulesToCsv = rulesToCsv;
+exports.declaredRedirects = declaredRedirects;
+exports.syncRedirects = syncRedirects;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const context_1 = require("./context");
+/**
+ * `redirects:` in forumulate.yaml, applied by `publish` (FMU-F09).
+ *
+ * A docs repository moves pages, and the redirects that keep the old addresses
+ * working belong in the same pull request as the move — not in a console
+ * someone has to remember to visit after the merge. So a space in the manifest
+ * may list them:
+ *
+ *     redirects:
+ *       - { from: /getting-started, to: /quickstart }
+ *       - { from: /v1/*, to: /*, status: 301 }
+ *
+ * or name a CSV file in the redirect manager's columns
+ * (`redirects: redirects.csv`, `from,to,status,type,passQuery`).
+ *
+ * Merged, never replaced: a rule the file does not name is left alone (the
+ * console's rules, the platform's rename rules), so declaring three redirects
+ * cannot delete three hundred. The write is the redirect manager's own import
+ * (`POST …/redirects/import`, mode `merge`), which validates every rule,
+ * refuses loops and duplicates, and keeps the platform's rules — one door,
+ * whichever way a rule arrives.
+ */
+/** A minimal CSV split — quoted fields and doubled quotes — for a manifest's CSV file. */
+function records(text) {
+    const out = [];
+    let row = [];
+    let cell = '';
+    let quoted = false;
+    const src = text.replace(/^/, '');
+    for (let i = 0; i < src.length; i++) {
+        const c = src[i];
+        if (quoted) {
+            if (c === '"' && src[i + 1] === '"') {
+                cell += '"';
+                i++;
+            }
+            else if (c === '"')
+                quoted = false;
+            else
+                cell += c;
+        }
+        else if (c === '"' && cell === '')
+            quoted = true;
+        else if (c === ',') {
+            row.push(cell);
+            cell = '';
+        }
+        else if (c === '\n' || c === '\r') {
+            if (c === '\r' && src[i + 1] === '\n')
+                i++;
+            row.push(cell);
+            out.push(row);
+            row = [];
+            cell = '';
+        }
+        else
+            cell += c;
+    }
+    if (cell || row.length)
+        out.push([...row, cell]);
+    return out.filter((r) => r.some((c) => c.trim()));
+}
+/** The rules a CSV file declares, by column name when it has a header. */
+function rulesFromCsv(text) {
+    const rows = records(text);
+    let cols = { from: 0, to: 1, status: 2, type: 3, passquery: 4 };
+    if (rows[0]?.some((c) => c.trim().toLowerCase() === 'from')) {
+        cols = {};
+        rows[0].forEach((c, i) => (cols[c.trim().toLowerCase()] = i));
+        rows.shift();
+    }
+    const get = (r, k) => (cols[k] === undefined ? '' : (r[cols[k]] ?? '').trim());
+    return rows
+        .filter((r) => !r[0].trim().startsWith('#'))
+        .map((r) => {
+        const rule = { from: get(r, 'from'), to: get(r, 'to') };
+        const status = Number(get(r, 'status'));
+        if ([301, 302, 307, 308].includes(status))
+            rule.status = status;
+        const type = get(r, 'type');
+        if (type === 'redirect' || type === 'rewrite')
+            rule.type = type;
+        const pass = get(r, 'passquery').toLowerCase();
+        if (pass)
+            rule.passQuery = ['true', '1', 'yes'].includes(pass);
+        return rule;
+    });
+}
+/** The rules as CSV in the import's columns — what the API is sent. */
+function rulesToCsv(rules) {
+    const q = (v) => `"${String(v ?? '').replace(/"/g, '""')}"`;
+    return [
+        'from,to,status,type,passQuery',
+        ...rules.map((r) => [r.from, r.to, r.status ?? '', r.type ?? '', r.passQuery ?? ''].map(q).join(',')),
+    ].join('\n');
+}
+/** What the manifest declares for this space, read from the list or the file. */
+function declaredRedirects(spec, manifestFile, root) {
+    if (!spec.redirects)
+        return [];
+    if (Array.isArray(spec.redirects))
+        return spec.redirects;
+    const file = (0, node_path_1.resolve)(manifestFile ? (0, node_path_1.dirname)(manifestFile) : root, spec.redirects);
+    if (!(0, node_fs_1.existsSync)(file))
+        throw new Error(`redirects: no file at ${file}`);
+    return rulesFromCsv((0, node_fs_1.readFileSync)(file, 'utf8'));
+}
+/** The match key a stored rule and a declared one share (path + query condition). */
+const keyOf = (r) => `${r.from}${r.match?.query && r.match.query !== 'ignore' ? `?${JSON.stringify(r.match.query)}` : ''}`;
+/** Plan or apply this space's declared redirects. */
+async function syncRedirects(ctx, apply, manifestFile) {
+    const declared = declaredRedirects(ctx.spec, manifestFile, ctx.root);
+    if (!declared.length)
+        return;
+    const live = await ctx.api
+        .get((0, context_1.spacePath)(ctx, '/redirects'))
+        .then((r) => r.redirects ?? [])
+        .catch(() => []);
+    const byKey = new Map(live.map((r) => [keyOf(r), r]));
+    const changes = declared.filter((d) => {
+        const had = byKey.get(keyOf(d));
+        return (!had ||
+            had.auto === true ||
+            had.to !== d.to ||
+            (had.status ?? 308) !== (d.status ?? 308) ||
+            (had.type ?? 'redirect') !== (d.type ?? 'redirect'));
+    });
+    if (!changes.length) {
+        ctx.line({ verb: 'same', what: 'redirects', detail: `${declared.length} declared, all in place` });
+        return;
+    }
+    for (const r of changes)
+        ctx.line({
+            verb: byKey.has(keyOf(r)) ? 'update' : 'create',
+            what: `redirect ${r.from}`,
+            detail: `→ ${r.to}${r.status ? ` (${r.status})` : ''}`,
+        });
+    if (!apply)
+        return;
+    await ctx.api.post((0, context_1.spacePath)(ctx, '/redirects/import'), {
+        csv: rulesToCsv(changes),
+        mode: 'merge',
+    });
+}
+//# sourceMappingURL=redirects.js.map

package/dist/publish/redirects.js.map

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

package/dist/publish/reserved.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Names in a content folder that are never content (R-N11).
+ *
+ * A repository that holds a blog also holds a README that explains the
+ * repository, a LICENSE, editor folders and a `_drafts` folder of posts nobody
+ * has finished. Every customer publisher we were shown carried its own list of
+ * these, and the first version of each list was the one that published the
+ * README as a post — readers met "How to run this repo locally" at the top of
+ * a newsroom. The list lives here, once, and the guide prints it
+ * (docs/guides/content-as-code.md, "Reserved names").
+ *
+ * Three groups, each for its own reason:
+ *
+ *  - Hidden and private: anything starting with `.` (`.git`, `.github`,
+ *    `.DS_Store`) or `_` (`_drafts`, `_templates`, and the metadata files this
+ *    tool reads itself: `_collection.yml`, `_tags.yml`). `node_modules`.
+ *  - The manifest: `forumulate.yaml`, `.yml`, `.json`.
+ *  - Repository paperwork, in any case and with any Markdown extension:
+ *    README, LICENSE/LICENCE, CONTRIBUTING, CODE_OF_CONDUCT, SECURITY,
+ *    CODEOWNERS, and GitBook's SUMMARY (a table of contents, not a page).
+ *
+ * README is the one with a second meaning. In a DOCS tree it is GitBook's way
+ * of naming a folder's own page, and existing docs repositories rely on that,
+ * so a page-backed space keeps it as the folder's index unless its manifest
+ * says `readme: skip`. A posts space has no folder pages, so there a README is
+ * always paperwork.
+ */
+export declare const MANIFEST_NAMES: string[];
+/** Repository paperwork, by file stem (lower-cased, extension dropped). */
+export declare const PAPERWORK: readonly ["readme", "license", "licence", "contributing", "code_of_conduct", "code-of-conduct", "security", "codeowners", "summary"];
+/** Folders that are never content, beyond the `.` and `_` prefixes. */
+export declare const RESERVED_FOLDERS: readonly ["node_modules"];
+/** Is this README-shaped (`README.md`, `readme.mdx`, `Readme.markdown`)? */
+export declare const isReadme: (name: string) => boolean;
+/**
+ * Why `name` is skipped, or null when it is content.
+ *
+ * `readmeIsIndex`: a docs space keeps README as a folder's page (see above).
+ */
+export declare function reservedReason(name: string, isDir: boolean, readmeIsIndex: boolean): string | null;
+/**
+ * The manifest's `ignore:` patterns, as a matcher over paths relative to the
+ * space folder. A small glob: `*` is any run within one segment, `**` any run
+ * of segments, `?` one character; a pattern without a `/` matches a name at
+ * any depth (`*.draft.md`), one with a `/` matches from the space folder
+ * (`archive/**`). A folder that matches is skipped with everything under it.
+ */
+export declare function ignoreMatcher(patterns: readonly string[] | undefined): (rel: string) => boolean;
+//# sourceMappingURL=reserved.d.ts.map

package/dist/publish/reserved.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved.d.ts","sourceRoot":"","sources":["../../src/publish/reserved.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,UAA2D,CAAC;AAEvF,2EAA2E;AAC3E,eAAO,MAAM,SAAS,sIAUZ,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,2BAA4B,CAAC;AAI1D,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,YAA8C,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,OAAO,GACrB,MAAM,GAAG,IAAI,CASf;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CA6B/F"}

package/dist/publish/reserved.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isReadme = exports.RESERVED_FOLDERS = exports.PAPERWORK = exports.MANIFEST_NAMES = void 0;
+exports.reservedReason = reservedReason;
+exports.ignoreMatcher = ignoreMatcher;
+const node_path_1 = require("node:path");
+/**
+ * Names in a content folder that are never content (R-N11).
+ *
+ * A repository that holds a blog also holds a README that explains the
+ * repository, a LICENSE, editor folders and a `_drafts` folder of posts nobody
+ * has finished. Every customer publisher we were shown carried its own list of
+ * these, and the first version of each list was the one that published the
+ * README as a post — readers met "How to run this repo locally" at the top of
+ * a newsroom. The list lives here, once, and the guide prints it
+ * (docs/guides/content-as-code.md, "Reserved names").
+ *
+ * Three groups, each for its own reason:
+ *
+ *  - Hidden and private: anything starting with `.` (`.git`, `.github`,
+ *    `.DS_Store`) or `_` (`_drafts`, `_templates`, and the metadata files this
+ *    tool reads itself: `_collection.yml`, `_tags.yml`). `node_modules`.
+ *  - The manifest: `forumulate.yaml`, `.yml`, `.json`.
+ *  - Repository paperwork, in any case and with any Markdown extension:
+ *    README, LICENSE/LICENCE, CONTRIBUTING, CODE_OF_CONDUCT, SECURITY,
+ *    CODEOWNERS, and GitBook's SUMMARY (a table of contents, not a page).
+ *
+ * README is the one with a second meaning. In a DOCS tree it is GitBook's way
+ * of naming a folder's own page, and existing docs repositories rely on that,
+ * so a page-backed space keeps it as the folder's index unless its manifest
+ * says `readme: skip`. A posts space has no folder pages, so there a README is
+ * always paperwork.
+ */
+exports.MANIFEST_NAMES = ['forumulate.yaml', 'forumulate.yml', 'forumulate.json'];
+/** Repository paperwork, by file stem (lower-cased, extension dropped). */
+exports.PAPERWORK = [
+    'readme',
+    'license',
+    'licence',
+    'contributing',
+    'code_of_conduct',
+    'code-of-conduct',
+    'security',
+    'codeowners',
+    'summary',
+];
+/** Folders that are never content, beyond the `.` and `_` prefixes. */
+exports.RESERVED_FOLDERS = ['node_modules'];
+const stemOf = (name) => name.replace(/\.[^.]*$/, '').toLowerCase();
+/** Is this README-shaped (`README.md`, `readme.mdx`, `Readme.markdown`)? */
+const isReadme = (name) => /^readme\.(md|mdx|markdown)$/i.test(name);
+exports.isReadme = isReadme;
+/**
+ * Why `name` is skipped, or null when it is content.
+ *
+ * `readmeIsIndex`: a docs space keeps README as a folder's page (see above).
+ */
+function reservedReason(name, isDir, readmeIsIndex) {
+    if (name.startsWith('.'))
+        return 'hidden';
+    if (name.startsWith('_'))
+        return isDir ? 'private folder' : 'private file';
+    if (exports.RESERVED_FOLDERS.includes(name))
+        return 'dependency folder';
+    if (exports.MANIFEST_NAMES.includes(name))
+        return 'the manifest';
+    if (isDir)
+        return null;
+    if ((0, exports.isReadme)(name) && readmeIsIndex)
+        return null;
+    if (exports.PAPERWORK.includes(stemOf(name)))
+        return 'repository paperwork';
+    return null;
+}
+/**
+ * The manifest's `ignore:` patterns, as a matcher over paths relative to the
+ * space folder. A small glob: `*` is any run within one segment, `**` any run
+ * of segments, `?` one character; a pattern without a `/` matches a name at
+ * any depth (`*.draft.md`), one with a `/` matches from the space folder
+ * (`archive/**`). A folder that matches is skipped with everything under it.
+ */
+function ignoreMatcher(patterns) {
+    const res = (patterns ?? [])
+        .map((p) => p.trim().replace(/^\.\//, '').replace(/\/+$/, ''))
+        .filter(Boolean)
+        .map((p) => {
+        const anchored = p.includes('/');
+        let src = '';
+        for (let i = 0; i < p.length; i++) {
+            const c = p[i];
+            if (c === '*' && p[i + 1] === '*') {
+                // `**/` is "any folders, or none"; a bare `**` is "anything".
+                if (p[i + 2] === '/') {
+                    src += '(?:.*/)?';
+                    i += 2;
+                }
+                else {
+                    src += '.*';
+                    i += 1;
+                }
+            }
+            else if (c === '*')
+                src += '[^/]*';
+            else if (c === '?')
+                src += '[^/]';
+            else
+                src += c.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+        }
+        return new RegExp(anchored ? `^${src}$` : `(?:^|/)${src}$`, 'i');
+    });
+    if (!res.length)
+        return () => false;
+    return (rel) => {
+        const path = node_path_1.posix.normalize(rel.split('\\').join('/'));
+        return res.some((re) => re.test(path));
+    };
+}
+//# sourceMappingURL=reserved.js.map

package/dist/publish/reserved.js.map

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

package/dist/publish/rewrite.d.ts

@@ -17,4 +17,16 @@ export declare function rewriteLinks(source: string, file: string, slugByFile: M
 export declare function rewriteAssets(source: string, urlByRef: Map<string, string>): string;
 /** The same substitution over a metadata patch (values that were local paths). */
 export declare function rewriteValue<T>(value: T, urlByRef: Map<string, string>): T;
+/**
+ * Does the live text still point at every picture the file's body uses?
+ *
+ * The word comparison (`compare.ts`) ignores link and image targets on
+ * purpose — the importer rewrites them, so they are never the same string
+ * twice. That left one change invisible: an image replaced by a new one under
+ * the same name uploads under a new content hash, and the post kept pointing
+ * at the old picture because its words had not changed. So the targets are
+ * checked here instead, by the URL each reference resolves to: one that is
+ * not uploaded yet, or not in the live text, means the body must be sent.
+ */
+export declare function mediaChanged(body: string, refs: Map<string, string> | undefined, urls: Map<string, string>, liveText: string): boolean;
 //# sourceMappingURL=rewrite.d.ts.map

package/dist/publish/rewrite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../src/publish/rewrite.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CA0BR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAcnF;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ1E"}
+{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../src/publish/rewrite.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CA0BR;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAcnF;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAOT"}

package/dist/publish/rewrite.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.rewriteLinks = rewriteLinks;
 exports.rewriteAssets = rewriteAssets;
 exports.rewriteValue = rewriteValue;
+exports.mediaChanged = mediaChanged;
 const node_path_1 = require("node:path");
 /**
  * What changes between the file on disk and the text the API is sent.
@@ -79,4 +80,25 @@ function rewriteValue(value, urlByRef) {
         return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, rewriteValue(v, urlByRef)]));
     return value;
 }
+/**
+ * Does the live text still point at every picture the file's body uses?
+ *
+ * The word comparison (`compare.ts`) ignores link and image targets on
+ * purpose — the importer rewrites them, so they are never the same string
+ * twice. That left one change invisible: an image replaced by a new one under
+ * the same name uploads under a new content hash, and the post kept pointing
+ * at the old picture because its words had not changed. So the targets are
+ * checked here instead, by the URL each reference resolves to: one that is
+ * not uploaded yet, or not in the live text, means the body must be sent.
+ */
+function mediaChanged(body, refs, urls, liveText) {
+    for (const ref of refs?.keys() ?? []) {
+        if (!body.includes(ref))
+            continue; // a front-matter value: compared as a field
+        const url = urls.get(ref);
+        if (!url || !liveText.includes(url))
+            return true;
+    }
+    return false;
+}
 //# sourceMappingURL=rewrite.js.map

package/dist/publish/rewrite.js.map

@@ -1 +1 @@
-{"version":3,"file":"rewrite.js","sourceRoot":"","sources":["../../src/publish/rewrite.ts"],"names":[],"mappings":";;AA2BA,oCA8BC;AAMD,sCAcC;AAGD,oCAQC;AAxFD,yCAAkC;AAElC;;;;;;;;;GASG;AAEH,gEAAgE;AAChE,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAC1B,MAAc,EACd,IAAY,EACZ,UAA+B;IAE/B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,CAAC,GAAW,EAAiB,EAAE;QAC5C,MAAM,CAAC,GAAG,yEAAyE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9F,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,iBAAK,CAAC,SAAS,CAAC,iBAAK,CAAC,IAAI,CAAC,iBAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC,CAAC;IACF,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE,CAAC,GAAG,EAAE,IAAY,EAAE,GAAW,EAAE,EAAE;QACzF,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,GAAG,GAAG,GAAG,CAAC,OAAO,CACf,oCAAoC,EACpC,CAAC,GAAG,EAAE,CAAS,EAAE,GAAW,EAAE,CAAS,EAAE,EAAE;QACzC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAClC,CAAC,CACF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,MAAc,EAAE,QAA6B;IACzE,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,GAAG,GAAG,GAAG;aACN,OAAO,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;aAChE,OAAO,CAAC,IAAI,MAAM,CAAC,wCAAwC,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;aACzF,OAAO,CACN,IAAI,MAAM,CAAC,wCAAwC,CAAC,yBAAyB,EAAE,GAAG,CAAC,EACnF,OAAO,GAAG,IAAI,CACf;aACA,OAAO,CAAC,IAAI,MAAM,CAAC,yBAAyB,CAAC,yBAAyB,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kFAAkF;AAClF,SAAgB,YAAY,CAAI,KAAQ,EAAE,QAA6B;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAM,CAAC;IACjF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAM,CAAC;IAClF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CACjE,CAAC;IACT,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"rewrite.js","sourceRoot":"","sources":["../../src/publish/rewrite.ts"],"names":[],"mappings":"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"}

package/dist/publish/scan-docs.d.ts

@@ -0,0 +1,10 @@
+import type { DocsWalk, Reader, ScanResult, SpaceSpec } from './types';
+/**
+ * The docs half of reading a folder: one top-level folder per collection,
+ * files at the root in the root collection, nested folders as parent pages
+ * (the folder's `index.md` — or `README.md`, unless the space says
+ * `readme: skip` — is the parent; a folder without one gets a title-only stub
+ * so its children still have somewhere to hang).
+ */
+export declare function scanDocs(absDir: string, spec: SpaceSpec, out: ScanResult, read: Reader, w: DocsWalk): void;
+//# sourceMappingURL=scan-docs.d.ts.map

package/dist/publish/scan-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-docs.d.ts","sourceRoot":"","sources":["../../src/publish/scan-docs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAA8B,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnG;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,QAAQ,GACV,IAAI,CA8BN"}