astroidjs 0.12.1 → 0.14.0

package/dist/project/scaffold.js

@@ -9,8 +9,8 @@
 //   src/worker.ts      → import { handleQueueMessage } from "./queue.js"
 //   src/middleware.ts  → import { resolvePortalUser } from "./portal-auth.js"
 //
-// The files behind those imports were written in exactly one place —
-// `create-astroid`'s CLI — and nothing else could produce them. So turning a
+// The files behind those imports were written in exactly one
+// place—`create-astroid`'s CLI—and nothing else could produce them. So turning a
 // module on AFTER scaffold, by editing the one typed config the framework is
 // built around, regenerated a trio importing files that did not exist. `astroid
 // doctor` reported "healthy" and the project failed in Vite.
@@ -37,11 +37,56 @@ import { generateAstroidEditSession } from "../realtime/scaffold.js";
 import { generatePwaHeaders, generateServiceWorker, generateWebManifest, resolvePwa, } from "../pwa/generate.js";
 import { astroidUsesQueues } from "../queues/messages.js";
 import { generateAstroidQueueSeam, generateAstroidWebhookRoutes } from "../queues/scaffold.js";
+/** `src/pages-hooks.ts`—the site's pages-route hooks, scaffolded once. */
+function generateAstroidPagesHooks() {
+    return [
+        "// The pages route's site-owned hooks. The generated worker passes",
+        "// `pagesHooks` to astroidPagesWriteHooks, which runs your `transform` before",
+        "// Astroid's own section sanitize and validate. Scaffolded once and yours to",
+        "// edit.",
+        "//",
+        "// `transform` gets the allowlisted fields of a write and returns what to",
+        "// store: normalize the slug, clamp a title, fill a new page's defaults.",
+        "// `validate` rejects a write by throwing a LouiseValidationError (a 422).",
+        "// `reservedSlugs` adds to the paths no page may take (ASTROID_RESERVED_SLUGS),",
+        "// such as one of your own file routes.",
+        'import type { AstroidPagesHooks } from "astroidjs";',
+        "",
+        "export const pagesHooks: AstroidPagesHooks = {",
+        "  reservedSlugs: [],",
+        "};",
+        "",
+    ].join("\n");
+}
+/** `src/settings-hooks.ts`—the site's settings sanitizers, scaffolded once. */
+function generateAstroidSettingsHooks() {
+    return [
+        "// The Settings panel's sanitize + read hooks. The generated worker spreads",
+        "// `settingsHooks` into its settingsRoute call, and src/actions/index.ts",
+        "// passes `sanitize` to the settings Action, so both write paths clean a value",
+        "// the same way. Scaffolded once and yours to edit.",
+        "//",
+        "// `sanitize` maps a settings key to a function that returns the value to",
+        "// store. It runs before the link-scheme and media-URL checks, and only on",
+        "// keys the allowlist (settings.columns + settings.customKeys) already accepts.",
+        "// `read` transforms the merged settings on GET, for example to fill keys an",
+        "// older row lacks from your defaults.",
+        'import type { SettingsRouteHooks } from "louise-toolkit/editor";',
+        "",
+        "export const settingsHooks: SettingsRouteHooks = {",
+        "  sanitize: {",
+        "    // For example, trim and cap a headline:",
+        '    // heroHeadline: (v) => (typeof v === "string" ? v.trim().slice(0, 120) : ""),',
+        "  },",
+        "};",
+        "",
+    ].join("\n");
+}
 /**
  * Every scaffold-once file this config implies.
  *
  * Ordered by module so a `generate` that writes several prints them in a stable
- * sequence. Returns `[]` for a plain marketing site with no modules — the
+ * sequence. Returns `[]` for a plain marketing site with no modules—the
  * baseline floor is entirely the regenerated trio plus the static template.
  */
 export function generateAstroidScaffoldFiles(config) {
@@ -56,7 +101,7 @@ export function generateAstroidScaffoldFiles(config) {
         files.push({ path: "migrations/0003_catalog.sql", contents: catalogSql });
     // --- the CWV beacon -------------------------------------------------------
     // A static file under public/, so it is same-origin and covered by
-    // `script-src 'self'` — an inline script carrying generated content could not
+    // `script-src 'self'`—an inline script carrying generated content could not
     // be hashed into the CSP and would be blocked.
     const beacon = generateAstroidVitalsBeacon(config, cwvBeaconScript());
     files.push({ path: beacon.path, contents: beacon.contents });
@@ -68,15 +113,26 @@ export function generateAstroidScaffoldFiles(config) {
     files.push({
         path: "src/schema.site.ts",
         contents: [
-            "// Site-owned Drizzle tables — the ones Astroid doesn't manage. Declare them",
+            "// Site-owned Drizzle tables—the ones Astroid doesn't manage. Declare them",
             "// here; the generated src/schema.ts re-exports everything from this file, so",
             "// drizzle-kit sees them and the worker can import them. Empty by default.",
             "//",
-            '// e.g.  export const redirects = sqliteTable("redirects", { … });',
+            '// For example: export const redirects = sqliteTable("redirects", { … });',
             "export {};",
             "",
         ].join("\n"),
     });
+    // --- pages: the transform + reserved-slugs seam ---------------------------
+    if (config.pages?.hooks) {
+        files.push({ path: "src/pages-hooks.ts", contents: generateAstroidPagesHooks() });
+    }
+    // --- settings: the sanitize + read seam ------------------------------------
+    // Only when asked for (settings.hooks): the generated worker and the Actions
+    // surface both import it, so it must exist whenever either does. Scaffolded
+    // empty, which leaves the route exactly as it is without hooks.
+    if (config.settings?.hooks) {
+        files.push({ path: "src/settings-hooks.ts", contents: generateAstroidSettingsHooks() });
+    }
     // --- the typed Astro Actions surface --------------------------------------
     // Always: every project has editable pages, and the routes alone leave the
     // Astro-native half of ADR 0001 unbuilt. Scaffold-once because it is meant to
@@ -96,7 +152,7 @@ export function generateAstroidScaffoldFiles(config) {
     // is why `astroid generate` must never rewrite them.
     if (astroidUsesQueues(config)) {
         files.push({ path: "src/queue.ts", contents: generateAstroidQueueSeam(config) });
-        // One receiver per provider — a site can run two (invoicing + storefront).
+        // One receiver per provider—a site can run two (invoicing + storefront).
         for (const route of generateAstroidWebhookRoutes(config)) {
             files.push({ path: route.path, contents: route.contents });
         }
@@ -107,14 +163,14 @@ export function generateAstroidScaffoldFiles(config) {
     if (gallery)
         files.push({ path: "src/pages/work.astro", contents: gallery });
     // --- pwa: the service worker, manifest, and its headers -------------------
-    // Static files under public/, not generated source — a service worker is not
+    // Static files under public/, not generated source—a service worker is not
     // bundled, and `_headers` is shared with whatever else writes to it.
     const sw = generateServiceWorker(config);
     if (sw) {
         // `emitDir` puts them where the BROWSER will ask for them. A PWA on its own
         // subdomain that rewrites to a path prefix (studio.example.com/ → /studio/)
-        // fetches /sw.js at its own origin root, which rewrites to /studio/sw.js —
-        // so a worker emitted at the public root is a 404 nothing explains.
+        // fetches /sw.js at its own origin root, which rewrites to /studio/sw.js—so
+        // a worker emitted at the public root is a 404 nothing explains.
         const pwaDir = resolvePwa(config).emitDir;
         const publicBase = pwaDir ? `public/${pwaDir}` : "public";
         files.push({ path: `${publicBase}/sw.js`, contents: sw });
@@ -125,7 +181,7 @@ export function generateAstroidScaffoldFiles(config) {
         const headers = generatePwaHeaders(config);
         if (headers) {
             files.push({
-                // `_headers` stays at the public root wherever the worker lives — it is
+                // `_headers` stays at the public root wherever the worker lives—it is
                 // one file for the whole site, and Cloudflare only reads it there.
                 path: "public/_headers",
                 contents: headers,
@@ -154,7 +210,7 @@ export function generateAstroidScaffoldFiles(config) {
         files.push({ path: "src/edit-session.ts", contents: editSession });
     // --- tenancy: what a subdomain maps to ------------------------------------
     // Astroid owns the wildcard route and the middleware wiring; this file owns
-    // every decision — the lookup, its caching, and what an unknown host means.
+    // every decision—the lookup, its caching, and what an unknown host means.
     const tenancy = generateAstroidTenancy(config);
     if (tenancy)
         files.push({ path: "src/tenancy.ts", contents: tenancy });
@@ -167,7 +223,7 @@ export function generateAstroidScaffoldFiles(config) {
         const route = generateAstroidPortalAuthRoute(config);
         // Always non-null alongside portalAuth (same `astroidPortal` gate), but the
         // types don't know that and a silent drop here is a portal that cannot
-        // authenticate — so assert it rather than `?.`-ing it away.
+        // authenticate—so assert it rather than `?.`-ing it away.
         //
         // The route file lives at the mount path, because Astro routing is
         // file-path-based: a portal mounted at `/api/shop-auth` needs its catch-all

package/dist/project/seed.d.ts

@@ -0,0 +1,22 @@
+import type { AstroidConfig, SectionKind } from "../config.js";
+/** A stored section item: its `_type`, field values, and settings tokens. */
+export interface AstroidSeedSection {
+    _type: SectionKind;
+    _settings?: Record<string, string>;
+    [field: string]: unknown;
+}
+/**
+ * The sections a new project's home page starts with: the config's `sections`,
+ * or its archetype's default when the config doesn't list any, each with
+ * sample content.
+ */
+export declare function astroidHomeSeedSections(config: AstroidConfig): AstroidSeedSection[];
+/**
+ * `seed/home.seed.sql`: one idempotent insert of the published `home` page,
+ * with the sections from {@link astroidHomeSeedSections}.
+ *
+ * Every value is escaped here, so a brand name with an apostrophe produces
+ * valid SQL. The template's token substitution can't escape, which is why the
+ * seed isn't a template file.
+ */
+export declare function generateAstroidHomeSeed(config: AstroidConfig): string;

package/dist/project/seed.js

@@ -0,0 +1,214 @@
+// Copyright (c) 2026 BowenLabs. Astroid is MIT licensed.
+//
+// The home page a new project seeds, built from its own config.
+//
+// This used to be a fixed file in the `create-astroid` template, and it seeded
+// the marketing sections (`hero`, `featureGrid`, `cta`) for every archetype. A
+// portfolio's config listed `hero`, `gallery`, `aboutIntro`, and `contact`, but
+// its first page showed a feature grid and a call to action instead. Building
+// the seed from the same section list the config holds means the two can't
+// disagree.
+//
+// It isn't in `generateAstroidScaffoldFiles`, on purpose: a seed runs once,
+// against a fresh database, so `astroid generate` has no reason to write it
+// back into a project that deleted it.
+import { ASTROID_ARCHETYPE_SECTIONS } from "../config.js";
+/**
+ * Sample content for every section kind, keyed by `SectionKind`.
+ *
+ * A `Record` over the whole vocabulary rather than just the kinds an archetype
+ * uses today, so adding a section to the catalog is a compile error here until
+ * it has a sample. That keeps a site's `sections` override seedable, whatever
+ * it lists.
+ *
+ * The copy tells the owner how to replace it, because it's the first thing they
+ * see after signing in. Images are left empty: a new project has no media, and
+ * every section with an image renders without one.
+ */
+const SAMPLES = {
+    hero: (brand) => ({
+        heading: brand,
+        subheading: "Sign in, switch on edit mode, and type to change this text.",
+        ctaLabel: "Get in touch",
+        ctaHref: "/contact",
+        _settings: { colorway: "base", align: "center" },
+    }),
+    featureGrid: () => ({
+        heading: "What you offer",
+        items: [
+            { title: "First thing", body: "Describe it here." },
+            { title: "Second thing", body: "And this one." },
+            { title: "Third thing", body: "And this one too." },
+        ],
+        _settings: { colorway: "base" },
+    }),
+    cta: () => ({
+        heading: "Ready when you are",
+        body: "Replace this copy with your own.",
+        ctaLabel: "Contact us",
+        ctaHref: "/contact",
+        _settings: { colorway: "brand", align: "center" },
+    }),
+    gallery: () => ({
+        heading: "Selected work",
+        items: [],
+        _settings: { colorway: "base" },
+    }),
+    media: () => ({
+        heading: "A closer look",
+        _settings: { colorway: "base" },
+    }),
+    splitImage: () => ({
+        heading: "Tell your story",
+        body: "<p>Add an image and a few sentences about what makes this place yours.</p>",
+        _layout: "imageStart",
+        _settings: { colorway: "base" },
+    }),
+    steps: () => ({
+        heading: "How it works",
+        items: [
+            { title: "Get in touch", body: "Say what you need." },
+            { title: "Plan it together", body: "Agree on the details." },
+            { title: "Done", body: "Describe the result here." },
+        ],
+        _settings: { colorway: "base" },
+    }),
+    banner: () => ({
+        text: "Announce something here, like new hours or a seasonal special.",
+        _settings: { colorway: "brand", align: "center" },
+    }),
+    faq: () => ({
+        heading: "Questions",
+        items: [
+            { question: "What's the first question people ask?", answer: "<p>Answer it here.</p>" },
+            { question: "And the second?", answer: "<p>Answer that one here.</p>" },
+        ],
+        _settings: { colorway: "base" },
+    }),
+    pricingTiers: () => ({
+        heading: "Pricing",
+        items: [
+            {
+                name: "Starter",
+                price: "$10",
+                period: "/mo",
+                features: [{ text: "Describe what's included" }],
+                featured: "no",
+            },
+            {
+                name: "Plus",
+                price: "$20",
+                period: "/mo",
+                features: [{ text: "Everything in Starter" }, { text: "And more" }],
+                featured: "yes",
+            },
+        ],
+        _settings: { colorway: "base" },
+    }),
+    testimonial: () => ({
+        quote: "Put a favorite thing a customer said about you here.",
+        attribution: "Alex",
+        role: "Customer",
+        _settings: { colorway: "base", align: "center" },
+    }),
+    aboutIntro: (brand) => ({
+        heading: `About ${brand}`,
+        body: "<p>Say who you are, what you make, and why it matters to you.</p>",
+        _settings: { colorway: "base" },
+    }),
+    productGrid: () => ({
+        heading: "Featured",
+        items: [
+            { name: "First product", price: "$12" },
+            { name: "Second product", price: "$18" },
+            { name: "Third product", price: "$24" },
+        ],
+        _settings: { colorway: "base" },
+    }),
+    locationHours: () => ({
+        heading: "Visit",
+        address: "Your street address\nCity, region, and postal code",
+        phone: "800-555-0100",
+        items: [
+            { day: "Monday to Friday", hours: "8 AM to 6 PM" },
+            { day: "Saturday and Sunday", hours: "9 AM to 4 PM" },
+        ],
+        _settings: { colorway: "base" },
+    }),
+    contact: () => ({
+        heading: "Get in touch",
+        blurb: "Questions, orders, or just saying hello: send a message.",
+        _settings: { colorway: "secondary" },
+    }),
+};
+/**
+ * The sections a new project's home page starts with: the config's `sections`,
+ * or its archetype's default when the config doesn't list any, each with
+ * sample content.
+ */
+export function astroidHomeSeedSections(config) {
+    const kinds = config.sections ?? ASTROID_ARCHETYPE_SECTIONS[config.archetype];
+    return kinds.map((kind) => ({ _type: kind, ...SAMPLES[kind](config.theme.name) }));
+}
+/** A SQLite string literal. Doubling `'` is the only escape SQLite needs. */
+function sqlString(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+/**
+ * `seed/home.seed.sql`: one idempotent insert of the published `home` page,
+ * with the sections from {@link astroidHomeSeedSections}.
+ *
+ * Every value is escaped here, so a brand name with an apostrophe produces
+ * valid SQL. The template's token substitution can't escape, which is why the
+ * seed isn't a template file.
+ */
+export function generateAstroidHomeSeed(config) {
+    const brand = config.theme.name;
+    const sections = JSON.stringify(astroidHomeSeedSections(config), null, 2);
+    const body = `<p>Welcome to ${escapeHtml(brand)}. Sign in at <code>/login</code>, switch on edit mode, and change this text in place, then select Publish.</p>`;
+    return [
+        "-- Seed the editable home page (slug `home`) that src/pages/index.astro renders.",
+        "-- Idempotent. Apply once after migrations:",
+        "--   wrangler d1 execute DB --file seed/home.seed.sql --remote",
+        "--   (drop --remote for the local dev D1)",
+        "--",
+        "-- `sections` is the page-builder array: the same shape the on-canvas editor",
+        "-- reads and the server validates against the section catalog on write. Each item",
+        '-- is `{"_type": …, …fields, "_settings": {…}}`, and `_settings` holds TOKENS',
+        "-- (colorway, align), never CSS, so a re-theme needs no content change. The list",
+        "-- matches `sections` in astroid.config.ts.",
+        "--",
+        "-- Seeding it is deliberate: an empty array renders an empty page, and a blank",
+        "-- canvas is a worse first run than having something real to click on and edit.",
+        "--",
+        "-- Full-text search (the editor's Pages search) is kept in sync on PUBLISH, so a",
+        "-- row inserted with raw SQL like this isn't in the index until you either",
+        "-- publish an edit to it or backfill once with `POST /api/louise/pages/reindex`",
+        "-- (signed in). The page renders fine either way; only in-editor search is",
+        "-- affected.",
+        "--",
+        "-- To override just the <head> title and description (not the on-page H1), add",
+        "-- `seo_title` and `seo_description` columns below. `seo_title` is run through the",
+        "-- config's title template, which already appends the brand, so set the page",
+        '-- part only ("Pricing"), not "Pricing | Your brand".',
+        "INSERT OR IGNORE INTO pages (slug, title, body, sections, status, sort_order, created_at, updated_at)",
+        "VALUES (",
+        "  'home',",
+        `  ${sqlString(brand)},`,
+        `  ${sqlString(body)},`,
+        `  json(${sqlString(sections)}),`,
+        "  'published',",
+        "  0,",
+        "  unixepoch(),",
+        "  unixepoch()",
+        ");",
+        "",
+    ].join("\n");
+}
+function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}

package/dist/pwa/generate.d.ts

@@ -21,38 +21,38 @@ export interface PwaConfig {
     /** Extra paths to precache alongside the scope root. */
     shell?: string[];
     /**
-     * A prerendered page to serve when a navigation fails offline, e.g.
+     * A prerendered page to serve when a navigation fails offline, for example,
      * `"/offline"`.
      *
-     * Without it the fallback is the scope root — the *dynamic* app shell, which
+     * Without it the fallback is the scope root—the *dynamic* app shell, which
      * is exactly the wrong thing to precache when the app is auth-gated: that
      * response carries `Cache-Control: no-store`, so either nothing is cached and
      * the fallback is empty, or a signed-in shell is stored and later served to
      * whoever opens the app next.
      *
      * Point it at a page with no session-specific markup. It is precached with the
-     * shell, so it must be prerendered — a dynamic route here fails at exactly the
+     * shell, so it must be prerendered—a dynamic route here fails at exactly the
      * moment it is needed.
      */
     offlineFallback?: string;
     /**
-     * Subdirectory under `public/` to emit `sw.js` and the manifest into, e.g.
+     * Subdirectory under `public/` to emit `sw.js` and the manifest into, for example,
      * `"studio"`. Default: the public root.
      *
-     * For a PWA served from its own subdomain that rewrites to a path prefix —
-     * `studio.example.com/` → `/studio/` — the browser fetches `/sw.js` at *its*
+     * For a PWA served from its own subdomain that rewrites to a path prefix—`studio.example.com/`
+     * → `/studio/`—the browser fetches `/sw.js` at *its*
      * origin root, which rewrites to `/studio/sw.js`. Emitting at the public root
      * puts the file where nothing will ask for it.
      *
      * Set this to the same prefix the host rewrites to. With `scope` equal to the
-     * serving path, no `Service-Worker-Allowed` header is needed — a worker may
+     * serving path, no `Service-Worker-Allowed` header is needed—a worker may
      * always control its own directory and below.
      */
     emitDir?: string;
 }
 /** True when this project switched the PWA on. */
 export declare const usesPwa: (config: AstroidConfig) => boolean;
-/** Resolved PWA settings — config over derivation over default. */
+/** Resolved PWA settings—config over derivation over default. */
 export declare function resolvePwa(config: AstroidConfig): Required<Omit<PwaConfig, "shell" | "offlineFallback" | "emitDir">> & {
     shell: string[];
     /** `null` when the app falls back to the scope root (see the config note). */
@@ -63,18 +63,18 @@ export declare function resolvePwa(config: AstroidConfig): Required<Omit<PwaConf
 /**
  * `public/manifest.webmanifest`.
  *
- * Icons are declared but NOT generated — a brand's icon is not something a
+ * Icons are declared but NOT generated—a brand's icon is not something a
  * scaffold can invent, and emitting placeholders would produce an installable
  * app with a grey square for a face. The generated README step says to add them.
  */
 export declare function generateWebManifest(config: AstroidConfig): string | null;
-/** `public/sw.js`. Plain JS — a service worker is not bundled. */
+/** `public/sw.js`. Plain JS—a service worker is not bundled. */
 export declare function generateServiceWorker(config: AstroidConfig): string | null;
 /**
  * The `public/_headers` block the PWA needs.
  *
  * `Service-Worker-Allowed` is emitted ONLY when the scope is broader than the
- * script's own location — which, with `sw.js` at the root, never is. Emitting it
+ * script's own location—which, with `sw.js` at the root, never is. Emitting it
  * unconditionally (as the reference does) is harmless but misleading: it implies
  * a requirement that isn't there, and someone later moving the script will trust
  * a header that no longer says what they need.

package/dist/pwa/generate.js

@@ -1,21 +1,21 @@
 // Copyright (c) 2026 BowenLabs. Astroid is MIT licensed.
 //
-// The PWA scaffold — a scoped service worker, a manifest, and the headers they
+// The PWA scaffold—a scoped service worker, a manifest, and the headers they
 // need.
 //
 // The scoping is the whole design, not a detail. A Louise site is CMS-edited:
 // an editor signs in, flips edit mode on, and edits the live page in place. A
 // service worker that cached HTML across the whole origin would serve that
-// editor a stale copy of the page they are trying to change — and the bug would
+// editor a stale copy of the page they are trying to change—and the bug would
 // present as "my edits don't save", which is about as far from the cause as a
 // report can get.
 //
 // So the generated worker is scoped, and inside its scope it still refuses to
 // touch anything dynamic:
 //
-//   • `/api/*`        never cached — checkout, auth, and every Louise write
-//   • editor routes   never cached — the studio must always be live
-//   • edit-mode URLs  never cached — `?louise` marks a request as an editing
+//   • `/api/*`        never cached—checkout, auth, and every Louise write
+//   • editor routes   never cached—the studio must always be live
+//   • edit-mode URLs  never cached—`?louise` marks a request as an editing
 //                     session, and caching one poisons it for everyone
 //
 // Everything else is the ordinary split: navigations network-first with a
@@ -23,7 +23,7 @@
 // when their content does.
 /** True when this project switched the PWA on. */
 export const usesPwa = (config) => (config.modules ?? []).includes("pwa");
-/** Resolved PWA settings — config over derivation over default. */
+/** Resolved PWA settings—config over derivation over default. */
 export function resolvePwa(config) {
     const pwa = config.pwa ?? {};
     // Normalized to a leading slash and no trailing one (except root), because
@@ -41,7 +41,7 @@ export function resolvePwa(config) {
         themeColor: pwa.themeColor ?? config.theme.colors.brand,
         offlineFallback: pwa.offlineFallback ?? null,
         emitDir: (pwa.emitDir ?? "").replace(/^\/+|\/+$/g, ""),
-        // The offline page is precached with the shell — a fallback fetched on
+        // The offline page is precached with the shell—a fallback fetched on
         // demand is a fallback that isn't there when the network is.
         shell: [
             scope,
@@ -51,7 +51,7 @@ export function resolvePwa(config) {
         ],
     };
 }
-/** URL prefix the emitted `sw.js` + manifest are served from — `""` at the
+/** URL prefix the emitted `sw.js` + manifest are served from—`""` at the
  *  public root, `"/studio"` under an `emitDir`. */
 function assetBase(emitDir) {
     const dir = (emitDir ?? "").replace(/^\/+|\/+$/g, "");
@@ -60,7 +60,7 @@ function assetBase(emitDir) {
 /**
  * `public/manifest.webmanifest`.
  *
- * Icons are declared but NOT generated — a brand's icon is not something a
+ * Icons are declared but NOT generated—a brand's icon is not something a
  * scaffold can invent, and emitting placeholders would produce an installable
  * app with a grey square for a face. The generated README step says to add them.
  */
@@ -100,7 +100,7 @@ export function generateWebManifest(config) {
         ],
     }, null, 2)}\n`;
 }
-/** `public/sw.js`. Plain JS — a service worker is not bundled. */
+/** `public/sw.js`. Plain JS—a service worker is not bundled. */
 export function generateServiceWorker(config) {
     if (!usesPwa(config))
         return null;
@@ -111,11 +111,11 @@ export function generateServiceWorker(config) {
     return [
         `// Service worker for the ${config.theme.name} PWA, scoped to ${pwa.scope}.`,
         "//",
-        "// Generated by Astroid. Safe to edit — bump CACHE to invalidate everything",
+        "// Generated by Astroid. Safe to edit—bump CACHE to invalidate everything",
         "// on the next visit.",
         "//",
         "// What it deliberately never caches, and why:",
-        "//   /api/*        checkout, auth, and every Louise write — a cached POST",
+        "//   /api/*        checkout, auth, and every Louise write—a cached POST",
         "//                 response or a stale session is worse than being offline",
         "//   editor routes the studio must always be live",
         "//   ?louise URLs  an edit-mode request; caching one would serve an editor a",
@@ -126,8 +126,8 @@ export function generateServiceWorker(config) {
         ...(pwa.offlineFallback
             ? [
                 "// A prerendered page with no session-specific markup. The scope root is",
-                "// the app SHELL, which on an auth-gated app is `Cache-Control: no-store`",
-                "// — so falling back to it serves either nothing or someone else's shell.",
+                "// the app SHELL, which on an auth-gated app is `Cache-Control: no-store`—",
+                "// so falling back to it serves either nothing or someone else's shell.",
                 `const OFFLINE = ${JSON.stringify(pwa.offlineFallback)};`,
             ]
             : []),
@@ -165,7 +165,7 @@ export function generateServiceWorker(config) {
         "  );",
         "}",
         "",
-        "/** Hashed build output — the filename changes when the content does, so it",
+        "/** Hashed build output—the filename changes when the content does, so it",
         " *  can be cached forever without a staleness risk. */",
         "function isImmutable(url) {",
         "  return url.pathname.startsWith('/_astro/') || url.pathname.startsWith('/icons/');",
@@ -181,7 +181,7 @@ export function generateServiceWorker(config) {
         "  // Cross-origin requests belong to whoever serves them.",
         "  if (url.origin !== self.location.origin) return;",
         "  if (isDynamic(url)) return;",
-        "  // Outside the scope this worker has no business intercepting — the rest of",
+        "  // Outside the scope this worker has no business intercepting—the rest of",
         "  // the site is CMS-edited and must stay live.",
         "  if (SCOPE !== '/' && !url.pathname.startsWith(SCOPE)) return;",
         "",
@@ -230,7 +230,7 @@ export function generateServiceWorker(config) {
  * The `public/_headers` block the PWA needs.
  *
  * `Service-Worker-Allowed` is emitted ONLY when the scope is broader than the
- * script's own location — which, with `sw.js` at the root, never is. Emitting it
+ * script's own location—which, with `sw.js` at the root, never is. Emitting it
  * unconditionally (as the reference does) is harmless but misleading: it implies
  * a requirement that isn't there, and someone later moving the script will trust
  * a header that no longer says what they need.
@@ -238,14 +238,14 @@ export function generateServiceWorker(config) {
 export function generatePwaHeaders(config) {
     if (!usesPwa(config))
         return null;
-    // Paths must match where the files are actually emitted — a stanza for
+    // Paths must match where the files are actually emitted—a stanza for
     // `/sw.js` while the worker lives at `/studio/sw.js` sets headers on nothing,
     // and the no-cache rule is what stops a bad worker sticking around.
     const base = assetBase(config.pwa?.emitDir);
     return [
         "",
         "# The service worker must revalidate on every load, or a bad worker sticks",
-        "# around until its cache entry expires — and it controls every page in scope.",
+        "# around until its cache entry expires—and it controls every page in scope.",
         `${base}/sw.js`,
         "  Cache-Control: no-cache",
         "",

package/dist/queues/consumer.d.ts

@@ -1,12 +1,12 @@
 import { type AstroidQueueMessage } from "./messages.js";
 export interface QueueHandlerOptions {
     /**
-     * Re-sync whatever the provider owns — the catalog mirror, a cache. Called
+     * Re-sync whatever the provider owns—the catalog mirror, a cache. Called
      * for a periodic refresh and for webhooks that touched the catalog.
      *
      * Receives the message that triggered it, so a site running more than one
      * commerce provider can branch on `message.provider` rather than refreshing
-     * everything for everything. A zero-argument seam stays valid — the parameter
+     * everything for everything. A zero-argument seam stays valid—the parameter
      * is there to be ignored until it's needed.
      *
      * Throwing marks the message for retry, which is usually right: a failed
@@ -24,7 +24,7 @@ export interface QueueHandlerOptions {
      * storefront and Square as its POS, at which point `refreshCatalog` means
      * "re-pull Fourthwall" while Square emits `inventory.count.updated` on every
      * single sale. Unscoped, a good Saturday becomes a sync storm against an
-     * unrelated provider's rate limit — and the periodic refresh is unaffected, so
+     * unrelated provider's rate limit—and the periodic refresh is unaffected, so
      * the site looks fine until the day it's busy.
      */
     catalogProvider?: string;

package/dist/queues/consumer.js

@@ -9,8 +9,8 @@
 // acks as a no-op.
 //
 // That last part matters more than it looks. Order, payment, and subscription
-// events are read live from the provider, so there is nothing local to update —
-// but they still arrive, in volume. A consumer that treats every event as
+// events are read live from the provider, so there is nothing local to
+// update—but they still arrive, in volume. A consumer that treats every event as
 // actionable turns a busy sales day into a catalog-refresh storm.
 import { affectsCatalog } from "./messages.js";
 /**