@dogsbay/format-astro 0.2.0-beta.12 → 0.2.0-beta.121

package/dist/redirects.js

@@ -0,0 +1,224 @@
+/**
+ * Redirects — `redirect:` / `aliases:` frontmatter and the `redirects:` config
+ * key, turned into rules and then into whatever the deploy target can honour.
+ *
+ * See plans/redirects-and-aliases.md. Three things drove the design:
+ *
+ * 1. **`redirect:` was accepted everywhere and emitted nowhere.** The schema
+ *    took it, `ExportPage` carried it, the sitemap excluded the page and
+ *    `format-dogsbay-md` round-tripped it — and `format-astro` wrote a normal
+ *    empty page. Four consumers honouring a field is what made it look
+ *    supported. So the page skip lives here too, not just the rule.
+ *
+ * 2. **A rule's paths are SERVED paths.** Cloudflare matches the request path,
+ *    which carries the mount prefix. `/old → /new` on a site mounted at
+ *    `/blog` must be written `/blog/old → /blog/new` or it never fires.
+ *
+ * 3. **Trailing slashes decide whether a redirect costs one hop or two.**
+ *    Sites serve `/guide/auth/` (docs-dev/url-shape.md). A rule targeting
+ *    `/guide/auth` redirects to a path that itself redirects. Internal paths
+ *    are normalized to the served form.
+ *
+ * This module is pure: it does no IO, so every rule and every refusal is
+ * testable without building a site.
+ */
+import { isExternalUrl, renderRedirectStub, renderRedirectsFile as renderRedirectsLines, resolveRedirects, } from "@dogsbay/site-files";
+const VALID_STATUS = new Set([301, 302, 303, 307, 308]);
+const isExternal = isExternalUrl;
+/**
+ * A page slug → the path it is served at. Mirrors the emitter: pages are
+ * directories with a trailing slash, `index` is the prefix root.
+ */
+export function slugToServedPath(slug, prefix) {
+    const clean = slug.replace(/^\/+|\/+$/g, "").replace(/(^|\/)index$/, "");
+    const base = prefix.replace(/\/+$/, "");
+    if (!clean)
+        return `${base}/`;
+    return `${base}/${clean}/`;
+}
+/**
+ * The site-path prefix a page's source is published under (its namespace,
+ * language and version segments, as `latest` or `en/v3`): its slug without
+ * the path the source gave it. "" for a site without those axes.
+ */
+export function pageUnitPrefix(page) {
+    const clean = (s) => s.replace(/^\/+|\/+$/g, "").replace(/(^|\/)index$/, "");
+    const slug = clean(page.slug);
+    const inside = clean(page.multiSource?.originalSlug ?? page.slug);
+    if (!inside)
+        return slug;
+    if (slug === inside)
+        return "";
+    return slug.endsWith(`/${inside}`) ? slug.slice(0, -inside.length - 1) : "";
+}
+/**
+ * A path written in a page's front matter (`redirect:`, `aliases:`) as a site
+ * path: relative to the page's unit (its language and version), unless it
+ * already starts with it, as dogsbay-ssg reads it (issue #096). A copied
+ * version (`latest` snapshotted to `v4/`) keeps its redirects inside itself.
+ * `mount` (urlBase + basePath) may be written or not; URLs pass through.
+ */
+export function inPageUnit(raw, unit, mount) {
+    if (!unit || isExternal(raw))
+        return raw;
+    const t = raw.trim();
+    const cut = t.search(/[?#]/);
+    const suffix = cut < 0 ? "" : t.slice(cut);
+    let p = (cut < 0 ? t : t.slice(0, cut)).replace(/^\/+/, "");
+    const m = mount.replace(/^\/+|\/+$/g, "");
+    if (m && (p === m || p.startsWith(`${m}/`)))
+        p = p.slice(m.length).replace(/^\/+/, "");
+    if (!(p === unit || p.startsWith(`${unit}/`)))
+        p = p ? `${unit}/${p}` : unit;
+    return `/${p}${suffix}`;
+}
+/**
+ * Normalize an authored path to the served form: leading slash, mount prefix
+ * applied once, trailing slash unless it names a file. External URLs pass
+ * through untouched.
+ */
+export function normalizeTarget(raw, prefix) {
+    if (isExternal(raw))
+        return raw;
+    // A "#anchor" or "?query" stays on the target as written; only the path is
+    // normalized (it used to become "/a#x/", which matched no page).
+    const trimmed = raw.trim();
+    const cut = trimmed.search(/[?#]/);
+    const suffix = cut < 0 ? "" : trimmed.slice(cut);
+    let p = cut < 0 ? trimmed : trimmed.slice(0, cut);
+    if (!p.startsWith("/"))
+        p = `/${p}`;
+    const base = prefix.replace(/\/+$/, "");
+    if (base && p !== base && !p.startsWith(`${base}/`)) {
+        p = `${base}${p}`;
+    }
+    const last = p.split("/").pop() ?? "";
+    if (!last.includes(".") && !p.endsWith("/"))
+        p = `${p}/`;
+    return p + suffix;
+}
+/**
+ * Gather every declared redirect, resolve paths, and refuse the ones that
+ * would be wrong at runtime. Pure — `errors` is the caller's cue to throw.
+ */
+export function collectRedirects(input) {
+    const { pages, config, prefix } = input;
+    const errors = [];
+    const warnings = [];
+    const livePaths = new Set();
+    for (const page of pages) {
+        // A page that only redirects is not a live page — it is the thing being
+        // redirected away from, and emitAstroPages skips it.
+        if (!page.redirect)
+            livePaths.add(slugToServedPath(page.slug, prefix));
+    }
+    // Duplicates are resolved (and reported) by resolveRedirects.
+    const candidates = [];
+    const add = (rule) => {
+        candidates.push(rule);
+    };
+    // 1. Page frontmatter: `redirect:` (this page forwards) and `aliases:` (old
+    //    paths that forward TO this page).
+    for (const page of pages) {
+        const here = slugToServedPath(page.slug, prefix);
+        // Front matter paths are relative to the page's language and version (#096).
+        const unit = pageUnitPrefix(page);
+        if (page.redirect) {
+            add({
+                from: here,
+                to: normalizeTarget(inPageUnit(page.redirect, unit, prefix), prefix),
+                status: 301,
+                origin: "frontmatter",
+                declaredBy: page.slug,
+            });
+        }
+        const aliases = page.frontmatter?.aliases;
+        if (aliases !== undefined) {
+            if (!Array.isArray(aliases) || aliases.some((a) => typeof a !== "string")) {
+                errors.push(`aliases: on ${page.slug} must be a list of paths. ` +
+                    `To fix: use a YAML list of strings.`);
+            }
+            else {
+                for (const alias of aliases) {
+                    add({
+                        from: normalizeTarget(inPageUnit(alias, unit, prefix), prefix),
+                        to: here,
+                        status: 301,
+                        origin: "aliases",
+                        declaredBy: page.slug,
+                    });
+                }
+            }
+        }
+    }
+    // 2. Config, which wins over frontmatter for the same source.
+    for (const [from, value] of Object.entries(config ?? {})) {
+        const to = typeof value === "string" ? value : value.to;
+        const status = typeof value === "string" ? 301 : (value.status ?? 301);
+        if (typeof to !== "string" || !to.trim()) {
+            errors.push(`redirects: entry "${from}" has no target. To fix: give it a path or URL.`);
+            continue;
+        }
+        if (!VALID_STATUS.has(status)) {
+            errors.push(`redirects: entry "${from}" has status ${status}. ` +
+                `To fix: use one of ${[...VALID_STATUS].join(", ")}.`);
+            continue;
+        }
+        add({
+            from: normalizeTarget(from, prefix),
+            to: normalizeTarget(to, prefix),
+            status,
+            origin: "config",
+        });
+    }
+    const resolved = resolveRedirects(candidates, {
+        strict: true,
+        // A target's "#anchor" or "?query" is not part of the page it names.
+        isPage: (path) => livePaths.has(path.split(/[?#]/)[0]),
+        cloudflareLimits: true,
+    });
+    return {
+        rules: resolved.rules,
+        errors: [...errors, ...resolved.errors],
+        warnings: [...warnings, ...resolved.warnings],
+    };
+}
+/** The `_redirects` file Workers Static Assets reads from the assets root. */
+export function renderRedirectsFile(rules) {
+    return renderRedirectsLines(rules);
+}
+/**
+ * A static stub for hosts with no redirect mechanism (GitHub Pages, plain
+ * static hosting). This is a genuine downgrade and is reported as one: the
+ * response is 200, and the redirect is a hint rather than a status code.
+ * `noindex` plus a canonical keeps crawlers pointed at the real page.
+ */
+export function renderMetaRefreshPage(rule, siteUrl) {
+    const canonical = siteUrl && !isExternal(rule.to)
+        ? `${siteUrl.replace(/\/+$/, "")}${rule.to}`
+        : isExternal(rule.to)
+            ? rule.to
+            : undefined;
+    return renderRedirectStub(rule.to, canonical);
+}
+/**
+ * Where a stub page goes inside `public/`, relative to it. The served path
+ * already carries the mount prefix, but `public/` is copied into the mount
+ * directory, so the prefix is stripped back off here — otherwise the stub
+ * lands at `<mount>/<mount>/old/`.
+ */
+export function stubPathForRule(rule, prefix) {
+    const base = prefix.replace(/\/+$/, "");
+    let p = rule.from;
+    if (base && p.startsWith(base))
+        p = p.slice(base.length);
+    p = p.replace(/^\/+|\/+$/g, "");
+    // The stub is written at this path under public/. resolveRedirects refuses
+    // such a source already; this is the last line before a file write, so a
+    // `..` that reached it some other way cannot leave the site.
+    if (p.split("/").some((seg) => seg === ".." || seg === ".") || /[\\\u0000]/.test(p)) {
+        throw new Error(`redirect source ${JSON.stringify(rule.from)} would write outside the site`);
+    }
+    return p ? `${p}/index.html` : "index.html";
+}
+//# sourceMappingURL=redirects.js.map

package/dist/redirects.js.map

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

package/dist/serialize.d.ts

@@ -19,11 +19,25 @@ export interface AstroGenOptions {
     imageOptimization?: boolean;
     /** Controls CodeBlock title bar: true = always (default), "auto" = only with explicit title */
     codeBlockTitle?: boolean | "auto";
+    /** A paragraph that is one titled image renders as a captioned figure (`content.imageCaptions: title`). */
+    imageCaptions?: boolean;
+    /**
+     * Combined URL prefix (urlBase + basePath). When non-empty, the
+     * caller is expected to have already pre-rewritten absolute image
+     * srcs in the tree to include this prefix; the serializer uses
+     * the prefix only to strip it back off for the imageMap lookup
+     * key (which is keyed off the unprefixed publicPath built via
+     * `import.meta.glob` at runtime).
+     */
+    combinedPrefix?: string;
 }
+import { TONE_CLASSES } from "./tone-classes.js";
+export { TONE_CLASSES };
 /** Escape for use inside an Astro {expression}. Uses JSON.stringify for safety. */
 export declare function escapeExpr(s: string): string;
 /** Escape for use in an HTML attribute value (double-quoted). */
 export declare function escapeAttr(s: string): string;
+export declare function componentAttr(name: string, value: string): string;
 /** Escape text for use directly in an Astro template (not inside an expression). */
 export declare function escapeTemplate(s: string): string;
 export declare function treeToAstro(nodes: TreeNode[], options?: AstroGenOptions): AstroGenResult;

package/dist/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAYpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+FAA+F;IAC/F,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACnC;AA+GD,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAahD;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CA0CxF"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAcxE;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,CAAC;AAiCpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+FAA+F;IAC/F,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,2GAA2G;IAC3G,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,CAAC;AA8FxB,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5C;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AA0CD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjE;AA6BD,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAahD;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CAgDxF"}