@forumulate/cli 0.8.0 → 0.10.0

package/dist/publish/studio-edits.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.studioConflicts = studioConflicts;
+exports.conflictText = conflictText;
+const context_1 = require("./context");
+/** The pages this plan would overwrite that were edited since the last publish. */
+async function studioConflicts(ctx, plan, live) {
+    const bySlug = new Map(live.pages.map((p) => [p.slug, p]));
+    const touched = new Map();
+    for (const sends of plan.sends.values())
+        for (const s of sends) {
+            const page = s.why === 'update' ? bySlug.get(s.page.slug) : undefined;
+            if (page)
+                touched.set(page.id, page.slug);
+        }
+    for (const p of plan.slotWrites) {
+        const page = bySlug.get(p.slug);
+        if (page)
+            touched.set(page.id, page.slug);
+    }
+    if (touched.size === 0)
+        return [];
+    let rows = [];
+    try {
+        // Chunked: a query string has a limit, and a big docs space has hundreds.
+        const ids = [...touched.keys()];
+        for (let i = 0; i < ids.length; i += 100) {
+            const res = await ctx.api.get((0, context_1.spacePath)(ctx, '/sync-state'), {
+                pageIds: ids.slice(i, i + 100).join(','),
+            });
+            rows.push(...(res.pages ?? []));
+        }
+    }
+    catch (e) {
+        // An API from before the baseline existed: nothing to compare with, which
+        // is the state every page was in before this check — publish as before.
+        if (e.status === 404)
+            return [];
+        throw e;
+    }
+    rows = rows.filter((r) => r.editedSinceSync && touched.has(r.pageId));
+    return rows.map((r) => ({
+        slug: r.slug,
+        pageId: r.pageId,
+        by: r.lastEdit?.by.name ?? r.lastEdit?.by.email ?? 'someone',
+        at: r.lastEdit?.at ?? 'an unknown time',
+    }));
+}
+/** The line and the error a conflict prints, in the words the docs promise. */
+function conflictText(c) {
+    return `CONFLICT ${c.slug} edited in studio by ${c.by} at ${c.at}`;
+}
+//# sourceMappingURL=studio-edits.js.map

package/dist/publish/studio-edits.js.map

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

package/dist/publish/tags.d.ts

@@ -0,0 +1,9 @@
+import { type SpaceCtx } from './context';
+import type { TagSpec } from './types';
+/** One declared tag → the body its door takes, and the keys nothing here understands. */
+export declare function tagBody(spec: TagSpec): {
+    body: Record<string, unknown>;
+    unknown: string[];
+};
+export declare function syncTags(ctx: SpaceCtx, apply: boolean, existingAssets: Map<string, string>): Promise<void>;
+//# sourceMappingURL=tags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/publish/tags.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrD,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,SAAS,CAAC;AA+DhD,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAc3F;AAkBD,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAsFf"}

package/dist/publish/tags.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tagBody = tagBody;
+exports.syncTags = syncTags;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const compare_1 = require("./compare");
+const context_1 = require("./context");
+const diff_1 = require("./diff");
+const api_1 = require("./api");
+const names_1 = require("./names");
+/**
+ * A blog's categories: how each tag looks — label, colours, description,
+ * cover, icon, the tag it sits under.
+ *
+ * Declared in the manifest (`tags:` on the space) or in `_tags.yml` beside the
+ * posts; the manifest wins key by key. Matched by slug, compared key by key
+ * against `GET …/blog/tag-info`, and only a tag that differs is written
+ * (`PUT …/blog/tags/{slug}`, which merges). A local `cover:` or image `icon:`
+ * is uploaded once, by content hash, like any image a post points at.
+ *
+ * Only a BLOG has this door; a tag list on another type is reported, not
+ * silently dropped.
+ */
+/** `PUT …/blog/tags/{slug}`'s own keys. */
+const TAG_KEYS = [
+    'label',
+    'color',
+    'textColor',
+    'colorDark',
+    'textColorDark',
+    'gradient',
+    'description',
+    'pageScheme',
+    'pagePalette',
+    'coverUrl',
+    'icon',
+    'parent',
+    'translations',
+    'internal',
+];
+const BY_FOLD = new Map(TAG_KEYS.map((k) => [k.toLowerCase(), k]));
+/** The spellings people write first. */
+const ALIAS = {
+    name: 'label',
+    title: 'label',
+    colour: 'color',
+    textcolour: 'textColor',
+    colourdark: 'colorDark',
+    textcolourdark: 'textColorDark',
+    cover: 'coverUrl',
+    coverimage: 'coverUrl',
+    image: 'coverUrl',
+    scheme: 'pageScheme',
+    palette: 'pagePalette',
+};
+const COLOR_KEYS = new Set(['color', 'textColor', 'colorDark', 'textColorDark']);
+/** A value that is a path to a local image, to upload rather than send. */
+const IMAGE = /\.(png|jpe?g|gif|webp|svg|avif|ico)$/i;
+/** The API's colour rule (lower-case, a hex gets its `#`), so a compare is not fooled by spelling. */
+function canonColor(v) {
+    if (typeof v !== 'string')
+        return v;
+    const raw = v.trim().toLowerCase();
+    return /^#?([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/.test(raw) && !raw.startsWith('#')
+        ? `#${raw}`
+        : raw;
+}
+/** One declared tag → the body its door takes, and the keys nothing here understands. */
+function tagBody(spec) {
+    const body = {};
+    const unknown = [];
+    for (const [k, v] of Object.entries(spec ?? {})) {
+        const fold = k.toLowerCase().replace(/[-_\s]/g, '');
+        const key = BY_FOLD.get(fold) ?? ALIAS[fold];
+        if (!key) {
+            unknown.push(k);
+            continue;
+        }
+        body[key] = COLOR_KEYS.has(key) ? canonColor(v) : typeof v === 'string' ? v.trim() : v;
+    }
+    if (typeof body.parent === 'string')
+        body.parent = (0, names_1.slugify)(body.parent, '');
+    return { body, unknown };
+}
+/** A live tag in the same terms as a declared one. */
+function liveBody(t) {
+    const out = {};
+    for (const k of TAG_KEYS)
+        out[k] = k in t ? t[k] : null;
+    // `label` reads back as the slug when nobody named the tag.
+    if (out.label === t.slug)
+        out.label = null;
+    for (const k of COLOR_KEYS)
+        out[k] = canonColor(out[k]);
+    return out;
+}
+/** Does a tag hold any display of its own (beyond being used by a post)? */
+function described(t) {
+    const b = liveBody(t);
+    return TAG_KEYS.some((k) => b[k] !== null && b[k] !== undefined && b[k] !== false);
+}
+async function syncTags(ctx, apply, existingAssets) {
+    const declared = { ...ctx.scan.tags };
+    for (const [slug, spec] of Object.entries(ctx.spec.tags ?? {}))
+        declared[slug] = { ...(declared[slug] ?? {}), ...(spec ?? {}) };
+    if (!Object.keys(declared).length || !ctx.only.part('tags', ctx.spec))
+        return;
+    if (ctx.type !== 'BLOG') {
+        ctx.line({
+            verb: 'warn',
+            what: 'tags',
+            detail: `a ${ctx.type} space has no tag display to set — only a blog's categories are synced`,
+        });
+        return;
+    }
+    const live = await ctx.api.tagInfo(ctx.org, ctx.spaceId);
+    if (live === null) {
+        ctx.line({ verb: 'meta', what: 'tags', detail: 'cannot compare without a token' });
+        return;
+    }
+    const bySlug = new Map(live.map((t) => [t.slug, t]));
+    const seen = new Set();
+    for (const [raw, spec] of Object.entries(declared)) {
+        const slug = (0, names_1.slugify)(raw, '');
+        if (!slug) {
+            ctx.errors.push(`tags: "${raw}" is not a tag slug (letters, numbers and dashes)`);
+            continue;
+        }
+        seen.add(slug);
+        const { body, unknown } = tagBody(spec);
+        if (unknown.length)
+            ctx.line({
+                verb: 'warn',
+                what: `tag ${slug}`,
+                detail: `not understood, not sent: ${unknown.join(', ')}`,
+            });
+        for (const k of ['coverUrl', 'icon']) {
+            const v = body[k];
+            if (typeof v !== 'string' || !IMAGE.test(v) || /^[a-z][a-z0-9+.-]*:|^\//i.test(v))
+                continue;
+            const abs = (0, node_path_1.resolve)(ctx.scan.absDir, v);
+            if (!(0, node_fs_1.existsSync)(abs) || !(0, node_fs_1.statSync)(abs).isFile()) {
+                ctx.errors.push(`tag ${slug}: ${k} ${v} is not a file in ${ctx.scan.dir || '.'}/`);
+                delete body[k];
+                continue;
+            }
+            // Uploaded once, by content; a plan names it by the URL it already has.
+            const known = (0, api_1.lookupAsset)(existingAssets, abs);
+            if (known)
+                body[k] = known;
+            else if (!apply)
+                ctx.line({
+                    verb: 'upload',
+                    what: abs.slice(ctx.root.length + 1) || abs,
+                    detail: `tag ${slug}'s ${k} — uploaded by a real run`,
+                });
+            else {
+                const had = existingAssets.size;
+                body[k] = await ctx.api.upload(ctx.org, ctx.spaceId, abs, existingAssets);
+                if (existingAssets.size > had)
+                    ctx.line({ verb: 'upload', what: abs.slice(ctx.root.length + 1) || abs, detail: String(body[k]) });
+            }
+        }
+        const current = bySlug.get(slug);
+        const was = current ? liveBody(current) : undefined;
+        const keys = (0, compare_1.differingKeys)(was, body);
+        if (!keys.length)
+            continue;
+        ctx.line({
+            verb: current && described(current) ? 'update' : 'create',
+            what: `tag ${slug}`,
+            detail: keys.join(', '),
+            diff: (0, diff_1.fieldDiff)(was, body, keys),
+        });
+        if (apply)
+            await ctx.api.put((0, context_1.spacePath)(ctx, `/blog/tags/${encodeURIComponent(slug)}`), Object.fromEntries(keys.map((k) => [k, body[k]])));
+    }
+    // `--prune`: a described tag the folder no longer describes loses its look.
+    // Its posts keep the tag; only the display is cleared (`DELETE …/tags/{slug}`).
+    if (!ctx.prune)
+        return;
+    if (!ctx.only.all)
+        return;
+    const keep = new Set(ctx.spec.keep ?? []);
+    for (const t of live) {
+        if (seen.has(t.slug) || keep.has(t.slug) || !described(t))
+            continue;
+        ctx.line({ verb: 'prune', what: `tag ${t.slug}`, detail: 'not declared — display cleared, posts keep the tag' });
+        if (apply)
+            await ctx.api.del((0, context_1.spacePath)(ctx, `/blog/tags/${encodeURIComponent(t.slug)}`));
+    }
+}
+//# sourceMappingURL=tags.js.map

package/dist/publish/tags.js.map

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

package/dist/publish/types.d.ts

@@ -1,3 +1,4 @@
+import type { Slot } from './slots';
 /**
  * The shapes `forumulate publish <folder>` works in.
  *
@@ -34,6 +35,12 @@ export interface LocalPage {
     unknown: string[];
     /** Synthesised to stand for a folder that has no index file of its own. */
     stub?: boolean;
+    /**
+     * Named slots the front matter fills (`short-answer:` on an FAQ question),
+     * by the shape's own keys. Empty when the file declares none, which is the
+     * common case: the body alone is the page.
+     */
+    sections: Record<string, string>;
 }
 /** One top-level folder of a docs space. */
 export interface LocalCollection {
@@ -65,7 +72,25 @@ export interface LocalSpace {
     /** Local files (images, PDFs) referenced from pages or posts, absolute paths. */
     assets: Set<string>;
     warnings: string[];
+    /**
+     * Slugs of the files marked `draft: true`. Never created or published — and
+     * never pruned either: marking a live post as a draft must not delete it.
+     */
+    drafts: Set<string>;
+    /** Markdown files left out because of their name (README, `_drafts/…`, `ignore:`). */
+    skipped: {
+        file: string;
+        reason: string;
+    }[];
+    /** Blog categories declared in `_tags.yml` beside the files (the manifest's `tags:` wins). */
+    tags: Record<string, TagSpec>;
 }
+/**
+ * How one blog category looks, as written in the manifest or `_tags.yml`.
+ * The keys are `PUT …/blog/tags/{slug}`'s own, plus the spellings people
+ * reach for first (`name`, `colour`, `cover`, `image`), mapped in `tags.ts`.
+ */
+export type TagSpec = Record<string, unknown>;
 /** A space as the manifest describes it. */
 export interface SpaceSpec {
     /** Folder under the publish root. */
@@ -93,8 +118,35 @@ export interface SpaceSpec {
     }>;
     openapi?: OpenApiSpec[];
     monitors?: Record<string, unknown>[];
+    /** An ABOUT space's parts (`PUT …/about`), inline or a YAML/JSON file beside the manifest. */
+    about?: Record<string, unknown> | string;
     /** Slugs (pages/posts) or collection slugs that `--prune` must never remove. */
     keep?: string[];
+    /**
+     * What a README is in this space: `index` (a folder's own page, GitBook's
+     * convention, and the default for page-backed spaces) or `skip`. A posts
+     * space always skips it — see `reserved.ts`.
+     */
+    readme?: 'index' | 'skip';
+    /** Extra names to leave out, as globs relative to the space folder. */
+    ignore?: string[];
+    /** Blog categories by slug: label, colours, description, cover, icon, parent. */
+    tags?: Record<string, TagSpec>;
+    /**
+     * Redirects this space keeps (FMU-F09): a list of rules, or a CSV file
+     * (relative to the manifest) in the redirect manager's columns. Merged into
+     * the space's table by `publish` — never deletes a rule the file does not
+     * name, and never touches the platform's own rename rules.
+     */
+    redirects?: ManifestRedirect[] | string;
+}
+/** One redirect a manifest declares — the same keys as `PUT …/redirects`. */
+export interface ManifestRedirect {
+    from: string;
+    to: string;
+    status?: 301 | 302 | 307 | 308;
+    type?: 'redirect' | 'rewrite';
+    passQuery?: boolean;
 }
 export interface OpenApiSpec {
     /** A file relative to the manifest, JSON or YAML. */
@@ -145,11 +197,42 @@ export interface LivePost {
     markdown?: string;
     sections?: Record<string, string>;
 }
+/** A tag's display as `GET …/blog/tag-info` answers it. */
+export interface LiveTag {
+    slug: string;
+    [key: string]: unknown;
+}
 /** What a piece of the plan does — one line in the dry run, one or more calls in the real one. */
-export type Verb = 'create' | 'update' | 'meta' | 'move' | 'order' | 'prune' | 'upload' | 'patch' | 'import' | 'same' | 'skip' | 'warn';
+export type Verb = 'create' | 'update' | 'meta' | 'move' | 'order' | 'prune' | 'upload' | 'patch' | 'import' | 'same' | 'skip' | 'warn'
+/** A page edited in the studio since the last publish (FMU-D18). */
+ | 'conflict'
+/** A page sent to a pull-request preview instead of published (FMU-F01). */
+ | 'preview';
 export interface PlanLine {
     verb: Verb;
     what: string;
     detail?: string;
+    /** For an update: the changed lines, `-` live and `+` the file (printed with `--diff`). */
+    diff?: string[];
+}
+export interface ScanResult extends LocalSpace {
+    /** Per file (relative to the space folder): reference as written → absolute asset path. */
+    refs: Map<string, Map<string, string>>;
+    /** Every Markdown file of the space (relative to the space folder) → its slug. */
+    slugByFile: Map<string, string>;
+}
+export type Reader = (abs: string) => {
+    rel: string;
+    text: string;
+    data: Record<string, unknown>;
+    body: string;
+};
+/** Shared with `scan-docs.ts`, which walks the docs half. */
+export interface DocsWalk {
+    fieldKeys: string[];
+    slots: Slot[];
+    skip: (abs: string, name: string) => boolean;
+    hasMarkdown: (dir: string) => boolean;
+    isIndex: (file: string) => boolean;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/publish/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kFAAkF;IAClF,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,SAAS,CAAC;IAChB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,iFAAiF;IACjF,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAE,CAAC;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAClB,MAAM,EACN;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAChF,CAAC;IACF,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,kGAAkG;AAClG,MAAM,MAAM,IAAI,GACZ,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/publish/types.ts"],"names":[],"mappings":"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"}

package/dist/publish/types.js

@@ -1,13 +1,3 @@
 "use strict";
-/**
- * The shapes `forumulate publish <folder>` works in.
- *
- * Three layers, kept apart on purpose: what is ON DISK (`Local*`), what is
- * LIVE (`Live*`), and what would change (`Plan`). Every customer publisher we
- * were shown (four of them, in three languages) mixed the first two — they
- * wrote while they read — so a dry run was a different code path from the real
- * one and drifted from it. Here a plan is computed from the two snapshots and
- * nothing else, and the real run executes that same plan.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/publish/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/publish/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/publish/types.ts"],"names":[],"mappings":""}

package/dist/publish-command.d.ts

@@ -0,0 +1,55 @@
+import type { ForumulateClient } from '@forumulate/sdk';
+/**
+ * `forumulate publish` and `forumulate sync` as the CLI runs them: the
+ * argument forms, the purge, and the run report (FMU-DOC07, D04, D16).
+ *
+ * Three argument forms grew up over time — a page id, a folder, and the folder
+ * with org and space as positionals — and the guides used all three, so an
+ * integrator could not tell which was current. One form is documented now
+ * (`publish <folder> --org … --space …`); the others still work and say so on
+ * stderr, with the line to use instead.
+ */
+export interface PublishCliDeps {
+    client: ForumulateClient;
+    authed: boolean;
+    out: (l: string) => void;
+    err: (l: string) => void;
+    env?: NodeJS.ProcessEnv;
+    upload?: (path: string, form: FormData) => Promise<unknown>;
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface FolderFlags {
+    org?: string;
+    space?: string;
+    manifest?: string;
+    dryRun: boolean;
+    prune: boolean;
+    force: boolean;
+    verify: boolean;
+    only?: string[];
+    paceMs: number;
+    json: boolean;
+    diff: boolean;
+    purge?: string;
+    report: boolean;
+    command: 'publish' | 'sync';
+    /** `--preview <name>` (FMU-F01): send the plan's pages to a preview, publish nothing. */
+    preview?: string;
+    /** `--preview-ttl <days>`. */
+    previewTtl?: string;
+    /** `--comment`: post (or update) the preview's comment on the pull request. */
+    comment?: boolean;
+}
+/** `publish …` in any of its forms. */
+export declare function runPublishCli(rest: string[], flags: Omit<FolderFlags, 'command'>, deps: PublishCliDeps): Promise<number>;
+/** The folder publish/sync, its run reported to the API, its summary printed. */
+export declare function runFolder(folder: string, flags: FolderFlags, deps: PublishCliDeps): Promise<number>;
+/** Many `purged` answers (one per import batch) as one. */
+export declare function mergePurged(answers: Record<string, unknown>[]): {
+    scope: string;
+    urlCount: number;
+    urls: string[];
+    edge: string;
+    edges: unknown[];
+} | null;
+//# sourceMappingURL=publish-command.d.ts.map

package/dist/publish-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-command.d.ts","sourceRoot":"","sources":["../src/publish-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,MAAM,CAAC;IAC5B,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAaD,uCAAuC;AACvC,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EACnC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED,iFAAiF;AACjF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CA4FjB;AAgDD,2DAA2D;AAC3D,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,IAAI,CAuB5F"}