@caelo-cms/shared 0.10.57 → 0.10.59

package/dist/content.js

@@ -544,14 +544,14 @@ export const pageUpdateSchema = z
     templateId: z.string().uuid().optional(),
     status: pageStatusSchema.optional(),
     /**
-     * Only meaningful together with `slug`. A slug change rewrites the page's
-     * public URL, so the op creates a 301 from the old path by default and
-     * rewrites every nav-menu / link-list / module-body link that pointed at
-     * it — all inside the same transaction as the slug write.
+     * Only meaningful together with `slug`. A slug change moves the page's
+     * public URL, so the op creates a 301 from the old path by default,
+     * inside the same transaction as the slug write. Links on the site are
+     * page references (epic #724) and follow the page without a rewrite;
+     * the 301 is for links from outside the site.
      *
-     * `'skip'` suppresses ONLY the redirect (the link rewrites still run) and
-     * is for the rare case where the operator explicitly says the old URL
-     * should 404. Defaults to `'auto'`: silently dropping the 301 would strand
+     * `'skip'` suppresses the redirect and is for the rare case where the
+     * operator explicitly says the old URL should 404. Defaults to `'auto'`: silently dropping the 301 would strand
      * every inbound link, which is never a safe default (CLAUDE.md §2).
      */
     redirectFromOld: z.enum(["auto", "skip"]).optional(),

package/dist/edit-markers.d.ts

@@ -0,0 +1,49 @@
+/** Comment prefix of an opening marker; the closing marker is `/caelo:f`. */
+export declare const EDIT_MARKER_PREFIX = "caelo:f";
+/** Field shape {@link wrapEditableValues} needs: name + kind. */
+export interface EditableFieldDef {
+    readonly name: string;
+    readonly kind?: string;
+}
+/**
+ * Wrap the editable text of a content instance's values in sentinels.
+ * Returns a new object; non-editable values pass through untouched.
+ *
+ * Paths: `<field>` for a `text` / `url` / `image` field, `<field>.<i>`
+ * for a `text-list` item, `<field>.<i>.label` / `<field>.<i>.href` for a
+ * `link-list` item's label / target.
+ *
+ * @example
+ * wrapEditableValues({ hero_title: "Hi" }, [{ name: "hero_title", kind: "text" }]);
+ * // → { hero_title: "\uE000hero_title\uE001Hi\uE002" }
+ */
+export declare function wrapEditableValues(values: Readonly<Record<string, unknown>>, fields: readonly EditableFieldDef[]): Record<string, unknown>;
+/**
+ * Turn sentinels in rendered module HTML into marker comments (text
+ * content) or drop them (everywhere else). See the file header.
+ *
+ * A tag whose `href` / `src` / `alt` value is exactly one marked value
+ * gets `data-caelo-fields="href=<path> …"` plus the placement
+ * (`data-caelo-placement`, `data-caelo-shared`), so the editor can offer
+ * "Edit link" / "Replace image" (#918). A value assembled from several
+ * parts (`href="/blog/{{slug}}"`) is not editable and is not marked.
+ *
+ * @param placement The placement key, `<blockName>#<position>`.
+ * @param sharedPages 0 for a placement with its own content; for a synced
+ *   (shared) one, the number of pages that show the same content.
+ */
+export declare function finalizeEditMarkers(html: string, placement: string, sharedPages: number): string;
+/** A parsed opening marker. */
+export interface EditMarker {
+    readonly blockName: string;
+    readonly position: number;
+    readonly synced: boolean;
+    readonly field: string;
+    readonly index?: number;
+}
+/**
+ * Parse an opening marker's comment text (without `<!--`/`-->`), or null.
+ * Mirrors what the preview runtime does in the browser.
+ */
+export declare function parseEditMarker(comment: string): EditMarker | null;
+//# sourceMappingURL=edit-markers.d.ts.map

package/dist/edit-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-markers.d.ts","sourceRoot":"","sources":["../src/edit-markers.ts"],"names":[],"mappings":"AAoCA,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAY5C,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAyBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA2ChG;AA+BD,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAgBlE"}

package/dist/edit-markers.js

@@ -0,0 +1,225 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * #917 — field markers for the Live Edit preview. They let the preview
+ * iframe tell which placement + field a piece of visible text came from,
+ * so the operator can edit that text in place.
+ *
+ * Two steps around the normal module render:
+ *
+ *   1. {@link wrapEditableValues} wraps every plain-text value of a
+ *      placement's content instance in private-use sentinels that carry
+ *      the field path. The template engine substitutes the wrapped value
+ *      like any other string (its escape is the identity), so the
+ *      sentinels land wherever the module author put `{{field}}`.
+ *   2. {@link finalizeEditMarkers} scans the rendered HTML. A sentinel in
+ *      text content becomes a pair of HTML comments around the value:
+ *      `<!--caelo:f p=<placement> s=<0|1> f=<path>-->value<!--/caelo:f-->`.
+ *      Comments do not affect layout or CSS selectors. A sentinel in a
+ *      comment or a raw-text element (`<script>`, `<style>`, `<title>`,
+ *      `<textarea>`) is removed and the value stays as it was. In a tag
+ *      it is removed too; an `href` / `src` / `alt` that is exactly one
+ *      marked value also gets `data-caelo-fields` on its tag (#918).
+ *
+ * Only the editor preview runs this. Published output never carries
+ * markers: the static generator and every other caller of
+ * `pages.render_preview` leave `editMarkers` off.
+ *
+ * Only values without `<` are wrapped: a value that carries markup cannot
+ * be edited as plain text without destroying that markup.
+ */
+const START = "\uE000";
+const SEP = "\uE001";
+const END = "\uE002";
+const SENTINELS = /[\uE000-\uE002]/g;
+/** Comment prefix of an opening marker; the closing marker is `/caelo:f`. */
+export const EDIT_MARKER_PREFIX = "caelo:f";
+/**
+ * Field kinds the preview marks: text (`text`, `text-list` items,
+ * `link-list` labels) and link / image targets (`url`, `image`,
+ * `link-list` hrefs, #918) — the latter usually land in `href` / `src`.
+ */
+const EDITABLE_KINDS = new Set(["text", "text-list", "link-list", "url", "image"]);
+/** Attributes whose marked value the editor can change (link target, image, alt text). */
+const MARKABLE_ATTRIBUTES = new Set(["href", "src", "alt"]);
+function editable(value) {
+    return typeof value === "string" && value.trim().length > 0 && !value.includes("<");
+}
+function wrap(path, value) {
+    return `${START}${path}${SEP}${value.replace(SENTINELS, "")}${END}`;
+}
+/**
+ * Wrap the editable text of a content instance's values in sentinels.
+ * Returns a new object; non-editable values pass through untouched.
+ *
+ * Paths: `<field>` for a `text` / `url` / `image` field, `<field>.<i>`
+ * for a `text-list` item, `<field>.<i>.label` / `<field>.<i>.href` for a
+ * `link-list` item's label / target.
+ *
+ * @example
+ * wrapEditableValues({ hero_title: "Hi" }, [{ name: "hero_title", kind: "text" }]);
+ * // → { hero_title: "\uE000hero_title\uE001Hi\uE002" }
+ */
+export function wrapEditableValues(values, fields) {
+    const out = { ...values };
+    for (const f of fields) {
+        const kind = f.kind ?? "text";
+        if (!EDITABLE_KINDS.has(kind))
+            continue;
+        const v = values[f.name];
+        if (kind === "text" || kind === "url" || kind === "image") {
+            if (editable(v))
+                out[f.name] = wrap(f.name, v);
+        }
+        else if (kind === "text-list" && Array.isArray(v)) {
+            out[f.name] = v.map((item, i) => (editable(item) ? wrap(`${f.name}.${i}`, item) : item));
+        }
+        else if (kind === "link-list" && Array.isArray(v)) {
+            out[f.name] = v.map((item, i) => {
+                if (typeof item !== "object" || item === null)
+                    return item;
+                const { label, href } = item;
+                return {
+                    ...item,
+                    ...(editable(label) ? { label: wrap(`${f.name}.${i}.label`, label) } : {}),
+                    ...(editable(href) ? { href: wrap(`${f.name}.${i}.href`, href) } : {}),
+                };
+            });
+        }
+    }
+    return out;
+}
+/** Comment-safe encoding: no `--`, no `>`, no whitespace. */
+function attr(value) {
+    return encodeURIComponent(value).replace(/-/g, "%2D");
+}
+const RAW_TEXT_ELEMENTS = new Set(["script", "style", "title", "textarea"]);
+/** End index (exclusive) of the tag starting at `i`, honouring quoted attribute values. */
+function tagEnd(html, i) {
+    let quote = null;
+    for (let j = i + 1; j < html.length; j += 1) {
+        const c = html[j];
+        if (quote) {
+            if (c === quote)
+                quote = null;
+        }
+        else if (c === '"' || c === "'") {
+            quote = c;
+        }
+        else if (c === ">") {
+            return j + 1;
+        }
+    }
+    return html.length;
+}
+/**
+ * Turn sentinels in rendered module HTML into marker comments (text
+ * content) or drop them (everywhere else). See the file header.
+ *
+ * A tag whose `href` / `src` / `alt` value is exactly one marked value
+ * gets `data-caelo-fields="href=<path> …"` plus the placement
+ * (`data-caelo-placement`, `data-caelo-shared`), so the editor can offer
+ * "Edit link" / "Replace image" (#918). A value assembled from several
+ * parts (`href="/blog/{{slug}}"`) is not editable and is not marked.
+ *
+ * @param placement The placement key, `<blockName>#<position>`.
+ * @param sharedPages 0 for a placement with its own content; for a synced
+ *   (shared) one, the number of pages that show the same content.
+ */
+export function finalizeEditMarkers(html, placement, sharedPages) {
+    if (!html.includes(START))
+        return html;
+    const open = (path) => `<!--${EDIT_MARKER_PREFIX} p=${attr(placement)} s=${sharedPages} f=${attr(path)}-->`;
+    const close = `<!--/${EDIT_MARKER_PREFIX}-->`;
+    let out = "";
+    let i = 0;
+    while (i < html.length) {
+        const c = html[i];
+        if (c === "<" && html.startsWith("<!--", i)) {
+            const end = html.indexOf("-->", i + 4);
+            const stop = end === -1 ? html.length : end + 3;
+            out += stripSentinels(html.slice(i, stop));
+            i = stop;
+            continue;
+        }
+        if (c === "<" && /[a-zA-Z/!?]/.test(html[i + 1] ?? "")) {
+            const stop = tagEnd(html, i);
+            const tag = html.slice(i, stop);
+            out += markTag(tag, placement, sharedPages);
+            i = stop;
+            const name = /^<([a-zA-Z][a-zA-Z0-9-]*)/.exec(tag)?.[1]?.toLowerCase();
+            if (name && RAW_TEXT_ELEMENTS.has(name) && !tag.endsWith("/>")) {
+                const closeAt = html.toLowerCase().indexOf(`</${name}`, i);
+                const rawStop = closeAt === -1 ? html.length : closeAt;
+                out += stripSentinels(html.slice(i, rawStop));
+                i = rawStop;
+            }
+            continue;
+        }
+        if (c === START) {
+            const sep = html.indexOf(SEP, i);
+            const end = html.indexOf(END, i);
+            if (sep !== -1 && end !== -1 && sep < end) {
+                out += `${open(html.slice(i + 1, sep))}${html.slice(sep + 1, end)}${close}`;
+                i = end + 1;
+                continue;
+            }
+        }
+        if (c !== SEP && c !== END && c !== START)
+            out += c;
+        i += 1;
+    }
+    return out;
+}
+const ATTRIBUTE = /([^\s"'=<>/]+)(\s*=\s*)(?:"([^"]*)"|'([^']*)')/g;
+const WHOLE_VALUE = /^\uE000([^\uE001]*)\uE001[^\uE002]*\uE002$/;
+/** Strip sentinels from a tag and mark its editable attributes (see finalizeEditMarkers). */
+function markTag(tag, placement, sharedPages) {
+    if (!tag.includes(START))
+        return tag;
+    const marks = [];
+    const cleaned = stripSentinels(tag.replace(ATTRIBUTE, (m, name, eq, dq, sq) => {
+        const value = dq ?? sq ?? "";
+        if (!value.includes(START))
+            return m;
+        const whole = WHOLE_VALUE.exec(value);
+        const lower = name.toLowerCase();
+        if (whole?.[1] && MARKABLE_ATTRIBUTES.has(lower))
+            marks.push(`${lower}=${attr(whole[1])}`);
+        const quote = dq !== undefined ? '"' : "'";
+        return `${name}${eq}${quote}${stripSentinels(value)}${quote}`;
+    }));
+    if (marks.length === 0)
+        return cleaned;
+    const extra = ` data-caelo-fields="${marks.join(" ")}" data-caelo-placement="${attr(placement)}" data-caelo-shared="${sharedPages}"`;
+    const at = cleaned.endsWith("/>") ? cleaned.length - 2 : cleaned.length - 1;
+    return `${cleaned.slice(0, at)}${extra}${cleaned.slice(at)}`;
+}
+/** Drop sentinels and the path they carry, keeping the wrapped value. */
+function stripSentinels(s) {
+    return s.replace(/\uE000[^\uE001]*\uE001/g, "").replace(SENTINELS, "");
+}
+/**
+ * Parse an opening marker's comment text (without `<!--`/`-->`), or null.
+ * Mirrors what the preview runtime does in the browser.
+ */
+export function parseEditMarker(comment) {
+    const m = /^caelo:f p=(\S+) s=([01]) f=(\S+)$/.exec(comment.trim());
+    if (!m?.[1] || !m[2] || !m[3])
+        return null;
+    const placement = decodeURIComponent(m[1]);
+    const hash = placement.lastIndexOf("#");
+    const position = Number(placement.slice(hash + 1));
+    if (hash <= 0 || !Number.isInteger(position))
+        return null;
+    const [field, index] = decodeURIComponent(m[3]).split(".");
+    if (!field)
+        return null;
+    return {
+        blockName: placement.slice(0, hash),
+        position,
+        synced: m[2] === "1",
+        field,
+        ...(index !== undefined ? { index: Number(index) } : {}),
+    };
+}
+//# sourceMappingURL=edit-markers.js.map

package/dist/edit-markers.js.map

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

package/dist/google-oauth.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Issue #914 — the shape of a Google OAuth client and the redirect URI IAP
+ * needs on it. Shared so the admin's server-side validation and the setup
+ * page (which shows IAP's redirect URI as the Owner types the client ID)
+ * use one definition.
+ */
+/**
+ * A Google OAuth 2.0 client ID (`<project number>-<random>.apps.googleusercontent.com`).
+ * Same pattern as the `operator_oauth_client` CHECK constraint (migration 0323).
+ */
+export declare const GOOGLE_OAUTH_CLIENT_ID: RegExp;
+/**
+ * IAP's redirect URI for a custom OAuth client: Google sends a signed-in
+ * visitor back to IAP here, so the client must list it among its authorized
+ * redirect URIs (cloud.google.com/iap/docs/custom-oauth-configuration).
+ *
+ * @example
+ *   iapRedirectUri("123-abc.apps.googleusercontent.com")
+ *   // → "https://iap.googleapis.com/v1/oauth/clientIds/123-abc.apps.googleusercontent.com:handleRedirect"
+ */
+export declare function iapRedirectUri(clientId: string): string;
+//# sourceMappingURL=google-oauth.d.ts.map

package/dist/google-oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-oauth.d.ts","sourceRoot":"","sources":["../src/google-oauth.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAqD,CAAC;AAEzF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/google-oauth.js

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: MPL-2.0
+/**
+ * Issue #914 — the shape of a Google OAuth client and the redirect URI IAP
+ * needs on it. Shared so the admin's server-side validation and the setup
+ * page (which shows IAP's redirect URI as the Owner types the client ID)
+ * use one definition.
+ */
+/**
+ * A Google OAuth 2.0 client ID (`<project number>-<random>.apps.googleusercontent.com`).
+ * Same pattern as the `operator_oauth_client` CHECK constraint (migration 0323).
+ */
+export const GOOGLE_OAUTH_CLIENT_ID = /^[0-9]+-[a-z0-9]+\.apps\.googleusercontent\.com$/;
+/**
+ * IAP's redirect URI for a custom OAuth client: Google sends a signed-in
+ * visitor back to IAP here, so the client must list it among its authorized
+ * redirect URIs (cloud.google.com/iap/docs/custom-oauth-configuration).
+ *
+ * @example
+ *   iapRedirectUri("123-abc.apps.googleusercontent.com")
+ *   // → "https://iap.googleapis.com/v1/oauth/clientIds/123-abc.apps.googleusercontent.com:handleRedirect"
+ */
+export function iapRedirectUri(clientId) {
+    return `https://iap.googleapis.com/v1/oauth/clientIds/${clientId}:handleRedirect`;
+}
+//# sourceMappingURL=google-oauth.js.map

package/dist/google-oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-oauth.js","sourceRoot":"","sources":["../src/google-oauth.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,kDAAkD,CAAC;AAEzF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,iDAAiD,QAAQ,iBAAiB,CAAC;AACpF,CAAC"}

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from "./ai-tools.js";
 export * from "./auth-forms.js";
 export * from "./auto-update.js";
 export * from "./base-css.js";
+export * from "./bug-intake.js";
 export * from "./build-page.js";
 export * from "./cap-failures.js";
 export * from "./cloud-shell-install.js";
@@ -13,6 +14,7 @@ export * from "./css-var-scan.js";
 export * from "./database-url.js";
 export * from "./design-draft-shell.js";
 export * from "./document-language.js";
+export * from "./edit-markers.js";
 export * from "./font-assets.js";
 export * from "./font-axis-policy.js";
 export * from "./font-usage.js";
@@ -20,8 +22,10 @@ export * from "./fonts.js";
 export * from "./genesis.js";
 export * from "./genesis-inventory.js";
 export * from "./google-models.js";
+export * from "./google-oauth.js";
 export * from "./image-capabilities.js";
 export * from "./interactions.js";
+export * from "./link-canonicalise.js";
 export * from "./link-refs.js";
 export { type LogContext, type Logger, type LoggerOptions, type LogLevel, makeLogger, mintRequestId, redact, type ServiceName, type StructuredLogEntry, } from "./logger.js";
 export * from "./markup-structure.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,UAAU,EACV,aAAa,EACb,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,YAAY,EACjB,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,UAAU,EACV,aAAa,EACb,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,YAAY,EACjB,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ export * from "./ai-tools.js";
 export * from "./auth-forms.js";
 export * from "./auto-update.js";
 export * from "./base-css.js";
+export * from "./bug-intake.js";
 export * from "./build-page.js";
 export * from "./cap-failures.js";
 export * from "./cloud-shell-install.js";
@@ -14,6 +15,7 @@ export * from "./css-var-scan.js";
 export * from "./database-url.js";
 export * from "./design-draft-shell.js";
 export * from "./document-language.js";
+export * from "./edit-markers.js";
 export * from "./font-assets.js";
 export * from "./font-axis-policy.js";
 export * from "./font-usage.js";
@@ -21,8 +23,10 @@ export * from "./fonts.js";
 export * from "./genesis.js";
 export * from "./genesis-inventory.js";
 export * from "./google-models.js";
+export * from "./google-oauth.js";
 export * from "./image-capabilities.js";
 export * from "./interactions.js";
+export * from "./link-canonicalise.js";
 export * from "./link-refs.js";
 export { makeLogger, mintRequestId, redact, } from "./logger.js";
 export * from "./markup-structure.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AAExC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAKL,UAAU,EACV,aAAa,EACb,MAAM,GAGP,MAAM,aAAa,CAAC;AACrB,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,aAAa,EACb,aAAa,EAEb,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AAExC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAKL,UAAU,EACV,aAAa,EACb,MAAM,GAGP,MAAM,aAAa,CAAC;AACrB,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,UAAU,CAAC;AACzB,OAAO,EACL,aAAa,EACb,aAAa,EAEb,cAAc,EACd,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/link-canonicalise.d.ts

@@ -0,0 +1,109 @@
+/** What the canonicaliser needs to know about the site. */
+export interface LinkTargetLookup {
+    /**
+     * The page served at `path` (leading slash, no trailing slash except
+     * the root "/"), following one redirect hop when the path is an old
+     * URL whose redirect lands on a page. Null when no page answers it.
+     */
+    pageIdForPath(path: string): string | null;
+    /** The live media asset with this slug, or null. */
+    mediaIdForSlug(slug: string): string | null;
+    pageExists(pageId: string): boolean;
+    mediaExists(mediaId: string): boolean;
+    /** True when `host` (lowercase, may carry a port) is the site's own. */
+    isOwnHost(host: string): boolean;
+    /**
+     * True when `path` names a page that does not exist YET but is planned:
+     * a page of the site import the writing chat is rebuilding, not built
+     * so far (#724 rollout C, maintainer decision on open point 1). Such a
+     * link keeps its literal path and lands in
+     * {@link LinkCanonicaliseRun.pending} instead of being an issue; the
+     * import converts it once the page exists. Absent = nothing is pending
+     * (every write outside an import run).
+     */
+    isPendingPagePath?(path: string): boolean;
+}
+/** A link to a planned (not yet built) page, kept literal for now. */
+export interface PendingLinkTarget {
+    /** The link exactly as written (trimmed). */
+    readonly value: string;
+    /** Its normalised path: the planned page's path. */
+    readonly path: string;
+    readonly where: string;
+}
+/** One link the canonicaliser could not turn into a reference. */
+export interface LinkCanonicaliseIssue {
+    readonly kind: "unknown-page-path" | "unknown-media" | "dangling-page-ref" | "dangling-media-ref" | "unknown-file" | "unsupported-link-form" | "malformed-link-ref";
+    /** The link exactly as written. */
+    readonly value: string;
+    /** Where it was found: `values.cta_href`, `html`, `fields.nav.default[2].href`, `items[0].href`. */
+    readonly where: string;
+}
+/** A canonicalisation run over one write. */
+export interface LinkCanonicaliseRun {
+    readonly lookup: LinkTargetLookup;
+    /**
+     * `strict` (actor writes): unknown targets are issues the op refuses.
+     * `report` (imports): unknown targets stay literal and are reported.
+     * Either way they land in {@link issues}.
+     */
+    readonly mode: "strict" | "report";
+    /** Link literals already present in the stored state; see file header. */
+    readonly grandfathered: ReadonlySet<string>;
+    readonly issues: LinkCanonicaliseIssue[];
+    /** Links to planned pages (see {@link LinkTargetLookup.isPendingPagePath}). */
+    readonly pending: PendingLinkTarget[];
+}
+/** Start a run. */
+export declare function linkCanonicaliseRun(lookup: LinkTargetLookup, opts?: {
+    mode?: "strict" | "report";
+    grandfathered?: ReadonlySet<string>;
+}): LinkCanonicaliseRun;
+/** Key / field names whose whole value is a URL. */
+export declare function isLinkKeyName(name: string): boolean;
+/** `/a/b/` → `/a/b`; `/` stays `/`. Linear, no regex backtracking. */
+export declare function normaliseLinkPath(path: string): string;
+/**
+ * Canonicalise one URL value. Returns the stored form: a reference, or
+ * the value unchanged (external, non-page, or an issue was recorded).
+ *
+ * @param scope `pages+media` for link positions (`href`, link fields);
+ *   `media` for image positions (`src`, `srcset`, `poster`).
+ */
+export declare function canonicaliseUrl(value: string, run: LinkCanonicaliseRun, where: string, scope?: "pages+media" | "media"): string;
+/** Canonicalise the link-bearing attributes of an HTML fragment. */
+export declare function canonicaliseHtmlLinks(html: string, run: LinkCanonicaliseRun, where: string): string;
+/**
+ * Canonicalise any JSON value: whole-value URLs where the key says so
+ * (`asUrl`), HTML attributes in every string, recursing through arrays
+ * and objects (object keys decide per {@link isLinkKeyName}).
+ */
+export declare function canonicaliseJsonLinks(value: unknown, run: LinkCanonicaliseRun, where: string, asUrl?: boolean): unknown;
+/** A module field as canonicalisation needs it. */
+export interface CanonicaliseField {
+    readonly name: string;
+    readonly kind: string;
+    readonly default?: unknown;
+}
+/**
+ * Canonicalise a content instance's values against its module's fields.
+ * Values without a declared field are still scanned (key-name rule +
+ * HTML) — a stale value renders nowhere today but may again tomorrow.
+ */
+export declare function canonicaliseContentValues(fields: readonly CanonicaliseField[], values: Readonly<Record<string, unknown>>, run: LinkCanonicaliseRun): Record<string, unknown>;
+/** Canonicalise every field's `default` (layout chrome content lives there). */
+export declare function canonicaliseFieldDefaults<F extends CanonicaliseField>(fields: readonly F[], run: LinkCanonicaliseRun): F[];
+/**
+ * Every link literal inside a stored state (values, defaults, set items,
+ * module HTML) — the {@link LinkCanonicaliseRun.grandfathered} set of the
+ * next write. Collected with a lookup that knows nothing, so every
+ * candidate surfaces as an "issue" carrying its raw value.
+ */
+export declare function collectLinkLiterals(state: unknown): Set<string>;
+/**
+ * One AI-actionable message for a refused write (CLAUDE.md §11): what is
+ * wrong with each link and the next step. Paths only — the author never
+ * sees reference ids except for a reference that is already broken.
+ */
+export declare function describeLinkIssues(issues: readonly LinkCanonicaliseIssue[]): string;
+//# sourceMappingURL=link-canonicalise.d.ts.map

package/dist/link-canonicalise.d.ts.map

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