scribe-cms 0.0.8 → 0.0.10

package/dist/cli/index.js

@@ -222,14 +222,14 @@ var SLUG_PLACEHOLDER = "{slug}";
 function isRoutableType(type) {
   return typeof type.path === "string" && type.path.length > 0;
 }
-function assertValidPathTemplate(path14, typeId) {
-  if (!path14.startsWith("/")) {
-    throw new Error(`Content type "${typeId}": path must start with / (got "${path14}")`);
+function assertValidPathTemplate(path16, typeId) {
+  if (!path16.startsWith("/")) {
+    throw new Error(`Content type "${typeId}": path must start with / (got "${path16}")`);
   }
-  const count = (path14.match(/\{slug\}/g) ?? []).length;
+  const count = (path16.match(/\{slug\}/g) ?? []).length;
   if (count !== 1) {
     throw new Error(
-      `Content type "${typeId}": path must contain exactly one {slug} (got "${path14}")`
+      `Content type "${typeId}": path must contain exactly one {slug} (got "${path16}")`
     );
   }
 }
@@ -243,19 +243,69 @@ function pathSuffix(template) {
   if (idx === -1) throw new Error(`Invalid path template (missing {slug}): ${template}`);
   return template.slice(idx + SLUG_PLACEHOLDER.length);
 }
-function resolvePath(template, slug, locale, defaultLocale) {
-  const relative = template.replace(SLUG_PLACEHOLDER, slug);
-  if (locale === defaultLocale) return relative;
-  return `/${locale}${relative}`;
-}
-function extractSlugFromResolvedPath(template, resolvedPath) {
-  const prefix = pathPrefix(template);
-  const suffix = pathSuffix(template);
-  if (!resolvedPath.startsWith(prefix)) return null;
-  if (suffix && !resolvedPath.endsWith(suffix)) return null;
-  const slugEnd = suffix ? resolvedPath.length - suffix.length : resolvedPath.length;
-  const slug = resolvedPath.slice(prefix.length, slugEnd);
-  return slug.length > 0 ? slug : null;
+function resolveDefaultLocaleRouting() {
+  return { strategy: "path-prefix", prefixDefaultLocale: false };
+}
+function splitPathAndSearch(pathname) {
+  const q = pathname.indexOf("?");
+  if (q === -1) return { pathname, search: "" };
+  return { pathname: pathname.slice(0, q), search: pathname.slice(q) };
+}
+function createUrlBuilder(config) {
+  const localeRouting = config.localeRouting ?? resolveDefaultLocaleRouting();
+  const defaultLocale = config.defaultLocale;
+  const prefixedLocales = localeRouting.strategy === "path-prefix" ? localeRouting.prefixDefaultLocale ? [...config.locales] : config.locales.filter((locale) => locale !== defaultLocale) : config.locales.filter((locale) => locale !== defaultLocale);
+  function applyLocaleToPath(pathname, locale) {
+    if (locale === defaultLocale) {
+      if (localeRouting.strategy === "path-prefix" && localeRouting.prefixDefaultLocale) {
+        return `/${defaultLocale}${pathname}`;
+      }
+      return pathname;
+    }
+    if (localeRouting.strategy === "search-param") {
+      const { pathname: base, search } = splitPathAndSearch(pathname);
+      const params = new URLSearchParams(search.startsWith("?") ? search.slice(1) : search);
+      params.set(localeRouting.param, locale);
+      const qs = params.toString();
+      return qs ? `${base}?${qs}` : base;
+    }
+    return `/${locale}${pathname}`;
+  }
+  function resolvePath(template, slug, locale) {
+    const relative = template.replace(SLUG_PLACEHOLDER, slug);
+    return applyLocaleToPath(relative, locale);
+  }
+  function extractSlugFromResolvedPath(template, resolvedPath) {
+    let pathname = resolvedPath;
+    if (localeRouting.strategy === "search-param") {
+      pathname = splitPathAndSearch(resolvedPath).pathname;
+    } else if (localeRouting.strategy === "path-prefix") {
+      for (const locale of config.locales) {
+        if (locale === defaultLocale && !localeRouting.prefixDefaultLocale) continue;
+        const prefix2 = `/${locale}`;
+        if (pathname === prefix2 || pathname.startsWith(`${prefix2}/`)) {
+          pathname = pathname.slice(prefix2.length) || "/";
+          break;
+        }
+      }
+    }
+    const prefix = pathPrefix(template);
+    const suffix = pathSuffix(template);
+    if (!pathname.startsWith(prefix)) return null;
+    if (suffix && !pathname.endsWith(suffix)) return null;
+    const slugEnd = suffix ? pathname.length - suffix.length : pathname.length;
+    const slug = pathname.slice(prefix.length, slugEnd);
+    return slug.length > 0 ? slug : null;
+  }
+  return {
+    defaultLocale,
+    locales: config.locales,
+    localeRouting,
+    prefixedLocales,
+    resolvePath,
+    extractSlugFromResolvedPath,
+    applyLocaleToPath
+  };
 }
 
 // src/config/resolve-config.ts
@@ -278,6 +328,13 @@ function resolveConfig(input, baseDir) {
       `scribe config: defaultLocale "${defaultLocale}" is not in locales [${raw.locales.join(", ")}]`
     );
   }
+  const localeRouting = raw.localeRouting ?? {
+    strategy: "path-prefix",
+    prefixDefaultLocale: false
+  };
+  if (localeRouting.strategy === "search-param" && !localeRouting.param) {
+    throw new Error('scribe config: localeRouting search-param requires a "param" name');
+  }
   const projectRoot = path4.resolve(baseDir ?? process.cwd(), raw.rootDir);
   const contentRoot = path4.resolve(projectRoot, raw.contentDir ?? "content");
   const storePath = path4.resolve(projectRoot, raw.store ?? ".scribe/store.sqlite");
@@ -305,6 +362,7 @@ function resolveConfig(input, baseDir) {
     assetsPath,
     locales: [...raw.locales],
     defaultLocale,
+    localeRouting,
     localePresets: raw.localePresets,
     translate: raw.translate,
     types
@@ -359,10 +417,10 @@ function introspectSchema(schema, prefix = []) {
 }
 function extractByPaths(data, paths) {
   const out = {};
-  for (const path14 of paths) {
-    const value = getAtPath(data, path14);
+  for (const path16 of paths) {
+    const value = getAtPath(data, path16);
     if (value !== void 0) {
-      setAtPath(out, path14.filter((p) => p !== "*"), value);
+      setAtPath(out, path16.filter((p) => p !== "*"), value);
     }
   }
   return out;
@@ -380,13 +438,13 @@ function mergeStructuralOntoLocale(localeData, enData, schema) {
   const translatable = pickTranslatable(localeData, schema);
   return deepMerge(structural, translatable);
 }
-function getAtPath(obj, path14) {
+function getAtPath(obj, path16) {
   let current = obj;
-  for (const segment of path14) {
+  for (const segment of path16) {
     if (segment === "*") {
       if (!Array.isArray(current)) return void 0;
       return current.map(
-        (item) => typeof item === "object" && item !== null ? getAtPath(item, path14.slice(path14.indexOf("*") + 1)) : void 0
+        (item) => typeof item === "object" && item !== null ? getAtPath(item, path16.slice(path16.indexOf("*") + 1)) : void 0
       );
     }
     if (typeof current !== "object" || current === null || Array.isArray(current)) return void 0;
@@ -394,13 +452,13 @@ function getAtPath(obj, path14) {
   }
   return current;
 }
-function setAtPath(obj, path14, value) {
-  if (path14.length === 0) return;
-  if (path14.length === 1) {
-    obj[path14[0]] = value;
+function setAtPath(obj, path16, value) {
+  if (path16.length === 0) return;
+  if (path16.length === 1) {
+    obj[path16[0]] = value;
     return;
   }
-  const [head, ...rest] = path14;
+  const [head, ...rest] = path16;
   if (!(head in obj) || typeof obj[head] !== "object" || obj[head] === null) {
     obj[head] = {};
   }
@@ -451,45 +509,23 @@ var LOCALE_BUILTIN_KEYS = [
   ["translationOf", "translationOf is internal; remove from locale translation"],
   ["enSlug", "enSlug is internal; remove from locale translation"]
 ];
-function extractBuiltinEnFields(data, pathTemplate, enSlug, defaultLocale) {
+var DEPRECATED_REDIRECT_FIELDS = [
+  [
+    "aliases",
+    "aliases frontmatter is removed \u2014 add redirects to content/<type>/_redirects.json instead"
+  ],
+  [
+    "redirect_to",
+    "redirect_to frontmatter is removed \u2014 add redirects to content/<type>/_redirects.json instead"
+  ]
+];
+function extractBuiltinEnFields(data, _pathTemplate, _enSlug, _defaultLocale) {
   const issues = [];
   const rest = { ...data };
-  const aliasesResult = z.array(slugPatternSchema).max(20).optional().default([]).safeParse(rest.aliases ?? []);
-  delete rest.aliases;
-  const redirectRaw = rest.redirect_to;
-  delete rest.redirect_to;
-  let redirectTo;
-  if (redirectRaw !== void 0 && redirectRaw !== null && redirectRaw !== "") {
-    if (typeof redirectRaw !== "string") {
-      issues.push({
-        field: "redirect_to",
-        message: "redirect_to must be a string path",
-        level: "error"
-      });
-    } else if (!pathTemplate) {
-      issues.push({
-        field: "redirect_to",
-        message: "redirect_to is not allowed on reference-only content types",
-        level: "error"
-      });
-    } else if (!extractSlugFromResolvedPath(pathTemplate, redirectRaw)) {
-      issues.push({
-        field: "redirect_to",
-        message: `redirect_to must match path template "${pathTemplate}" (prefix "${pathPrefix(pathTemplate)}"${pathSuffix(pathTemplate) ? `, suffix "${pathSuffix(pathTemplate)}"` : ""})`,
-        level: "error"
-      });
-    } else {
-      redirectTo = redirectRaw;
-    }
-  }
-  const aliases = aliasesResult.success ? aliasesResult.data : [];
-  if (!aliasesResult.success) {
-    for (const issue of aliasesResult.error.issues) {
-      issues.push({
-        field: `aliases.${issue.path.join(".")}`,
-        message: issue.message,
-        level: "error"
-      });
+  for (const [field2, message] of DEPRECATED_REDIRECT_FIELDS) {
+    if (rest[field2] !== void 0) {
+      issues.push({ field: field2, message, level: "error" });
+      delete rest[field2];
     }
   }
   let publishedAt;
@@ -551,8 +587,6 @@ function extractBuiltinEnFields(data, pathTemplate, enSlug, defaultLocale) {
   }
   return {
     builtin: {
-      aliases,
-      redirectTo,
       publishedAt,
       updatedAt,
       noindex,
@@ -571,20 +605,24 @@ function validateLocaleBuiltinFields(data) {
   }
   return issues;
 }
-function resolveCanonicalPathname(type, doc, defaultLocale) {
+function resolveCanonicalPathname(type, doc, defaultLocale, localeRouting) {
+  const urlBuilder = createUrlBuilder({
+    locales: [defaultLocale, ...doc.locale !== defaultLocale ? [doc.locale] : []],
+    defaultLocale,
+    localeRouting: localeRouting ?? { strategy: "path-prefix", prefixDefaultLocale: false }
+  });
   if (doc.canonicalPathOverride) {
-    if (doc.locale === defaultLocale) return doc.canonicalPathOverride;
-    return `/${doc.locale}${doc.canonicalPathOverride}`;
+    return urlBuilder.applyLocaleToPath(doc.canonicalPathOverride, doc.locale);
   }
   if (!type.path) return `/${doc.slug}`;
-  return resolvePath(type.path, doc.slug, doc.locale, defaultLocale);
+  return urlBuilder.resolvePath(type.path, doc.slug, doc.locale);
 }
-function mergeBuiltinsIntoFrontmatter(frontmatter, doc, type, defaultLocale) {
+function mergeBuiltinsIntoFrontmatter(frontmatter, doc, type, defaultLocale, localeRouting) {
   const out = { ...frontmatter };
   if (doc.publishedAt !== void 0) out.publishedAt = doc.publishedAt;
   if (doc.updatedAt !== void 0) out.updatedAt = doc.updatedAt;
   out.noindex = doc.noindex;
-  out.canonicalPath = resolveCanonicalPathname(type, doc, defaultLocale);
+  out.canonicalPath = resolveCanonicalPathname(type, doc, defaultLocale, localeRouting);
   return out;
 }
 function seoFieldsFromEn(enDoc) {
@@ -592,8 +630,7 @@ function seoFieldsFromEn(enDoc) {
     publishedAt: enDoc.publishedAt,
     updatedAt: enDoc.updatedAt,
     noindex: enDoc.noindex,
-    canonicalPathOverride: enDoc.canonicalPathOverride,
-    redirectTo: enDoc.redirectTo
+    canonicalPathOverride: enDoc.canonicalPathOverride
   };
 }
 
@@ -668,11 +705,6 @@ function getTranslation(db, contentType, enSlug, locale) {
 function listTranslationsForType(db, contentType) {
   return db.prepare(`SELECT * FROM translations WHERE content_type = ? ORDER BY en_slug, locale`).all(contentType);
 }
-function listTranslationsForEnSlug(db, contentType, enSlug) {
-  return db.prepare(
-    `SELECT * FROM translations WHERE content_type = ? AND en_slug = ? ORDER BY locale`
-  ).all(contentType, enSlug);
-}
 function listTranslationsForLocale(db, contentType, locale) {
   return db.prepare(`SELECT * FROM translations WHERE content_type = ? AND locale = ? ORDER BY en_slug`).all(contentType, locale);
 }
@@ -756,7 +788,8 @@ function parseEnMdx(filePath, config, type) {
       locale: config.defaultLocale
     },
     type,
-    config.defaultLocale
+    config.defaultLocale,
+    config.localeRouting
   );
   const crossIssues = type.crossValidate?.(result.data, {
     locale: config.defaultLocale,
@@ -770,8 +803,6 @@ function parseEnMdx(filePath, config, type) {
     slug,
     enSlug: slug,
     locale: config.defaultLocale,
-    aliases: builtin.aliases,
-    redirectTo: builtin.redirectTo,
     publishedAt: builtin.publishedAt,
     updatedAt: builtin.updatedAt,
     noindex: builtin.noindex,
@@ -782,7 +813,7 @@ function parseEnMdx(filePath, config, type) {
   };
   return { document, issues };
 }
-function buildDocumentFromTranslation(row, enDoc, type) {
+function buildDocumentFromTranslation(row, enDoc, type, config) {
   const localeFm = JSON.parse(row.frontmatter_json);
   const merged = mergeStructuralOntoLocale(localeFm, enDoc.frontmatter, type.schema);
   const seo = seoFieldsFromEn(enDoc);
@@ -790,14 +821,13 @@ function buildDocumentFromTranslation(row, enDoc, type) {
     merged,
     { ...seo, slug: row.slug, locale: row.locale },
     type,
-    enDoc.locale
+    config.defaultLocale,
+    config.localeRouting
   );
   return {
     slug: row.slug,
     enSlug: row.en_slug,
     locale: row.locale,
-    aliases: [],
-    redirectTo: seo.redirectTo,
     publishedAt: seo.publishedAt,
     updatedAt: seo.updatedAt,
     noindex: seo.noindex,
@@ -875,7 +905,7 @@ function createContentLoader(config, type) {
       for (const row of rowsByLocale.get(locale) ?? []) {
         const enDoc = englishBySlug.get(row.en_slug);
         if (!enDoc) continue;
-        const doc = buildDocumentFromTranslation(row, enDoc, type);
+        const doc = buildDocumentFromTranslation(row, enDoc, type, config);
         bySlug.set(doc.slug, doc);
         byEnSlug.set(row.en_slug, doc);
       }
@@ -924,56 +954,16 @@ function getTranslatablePayload(doc, type) {
 
 // src/i18n/resolve-document.ts
 init_esm_shims();
-function findEnDocByAlias(slug, allDocs, defaultLocale) {
-  const enIdx = allDocs.get(defaultLocale);
-  if (!enIdx) return null;
-  for (const doc of enIdx.bySlug.values()) {
-    if (doc.aliases.includes(slug)) return doc;
-  }
-  return null;
-}
-function enCanonicalDoc(doc, allDocs, defaultLocale) {
-  if (doc.locale === defaultLocale) return doc;
-  return allDocs.get(defaultLocale)?.bySlug.get(doc.enSlug) ?? doc;
-}
-function redirectPathForDocument(doc, locale, defaultLocale, allDocs, type) {
-  if (!type.path) return void 0;
-  const enDoc = enCanonicalDoc(doc, allDocs, defaultLocale);
-  if (!enDoc.redirectTo) return void 0;
-  const targetEnSlug = extractSlugFromResolvedPath(type.path, enDoc.redirectTo);
-  if (!targetEnSlug) return void 0;
-  const targetEnDoc = allDocs.get(defaultLocale)?.bySlug.get(targetEnSlug);
-  const targetSlug = targetEnDoc ? getSlugForLocale(targetEnDoc, defaultLocale, locale, allDocs, defaultLocale) ?? targetEnSlug : targetEnSlug;
-  return resolvePath(type.path, targetSlug, locale, defaultLocale);
-}
-function withRedirectTo(result, locale, defaultLocale, allDocs, type) {
-  if (result.shouldRedirectTo || !result.document) return result;
-  const redirect = redirectPathForDocument(result.document, locale, defaultLocale, allDocs, type);
-  if (!redirect) return result;
-  return {
-    document: null,
-    actualLocale: result.actualLocale,
-    shouldRedirectTo: redirect
-  };
-}
-function resolveLocalizedDocument(slug, locale, defaultLocale, allDocs, type) {
+function resolveLocalizedDocument(slug, locale, defaultLocale, allDocs, type, localeRouting) {
+  const urlBuilder = createUrlBuilder({
+    locales: [defaultLocale, locale],
+    defaultLocale,
+    localeRouting: localeRouting ?? { strategy: "path-prefix", prefixDefaultLocale: false }
+  });
   const idx = allDocs.get(locale);
   const direct = idx?.bySlug.get(slug);
   if (direct) {
-    return withRedirectTo({ document: direct, actualLocale: locale }, locale, defaultLocale, allDocs, type);
-  }
-  const aliasDoc = findEnDocByAlias(slug, allDocs, defaultLocale);
-  if (aliasDoc && type.path) {
-    const canonicalSlug = aliasDoc.slug;
-    const localizedSlug = getSlugForLocale(aliasDoc, defaultLocale, locale, allDocs, defaultLocale);
-    const targetSlug = localizedSlug ?? canonicalSlug;
-    if (targetSlug !== slug) {
-      return {
-        document: null,
-        actualLocale: locale,
-        shouldRedirectTo: resolvePath(type.path, targetSlug, locale, defaultLocale)
-      };
-    }
+    return { document: direct, actualLocale: locale };
   }
   for (const [docLocale, docIdx] of allDocs) {
     const found = docIdx.bySlug.get(slug);
@@ -986,17 +976,11 @@ function resolveLocalizedDocument(slug, locale, defaultLocale, allDocs, type) {
       return {
         document: null,
         actualLocale: locale,
-        shouldRedirectTo: resolvePath(type.path, correctSlug, locale, defaultLocale)
+        shouldRedirectTo: urlBuilder.resolvePath(type.path, correctSlug, locale)
       };
     }
     if (docLocale === defaultLocale) {
-      return withRedirectTo(
-        { document: found, actualLocale: defaultLocale },
-        locale,
-        defaultLocale,
-        allDocs,
-        type
-      );
+      return { document: found, actualLocale: defaultLocale };
     }
     if (!type.path) {
       return { document: null, actualLocale: locale };
@@ -1004,39 +988,21 @@ function resolveLocalizedDocument(slug, locale, defaultLocale, allDocs, type) {
     return {
       document: null,
       actualLocale: locale,
-      shouldRedirectTo: resolvePath(type.path, found.enSlug, locale, defaultLocale)
+      shouldRedirectTo: urlBuilder.resolvePath(type.path, found.enSlug, locale)
     };
   }
   if (locale !== defaultLocale) {
     const enDoc = allDocs.get(defaultLocale)?.bySlug.get(slug);
     if (enDoc && type.indexFallback === "en") {
-      return withRedirectTo(
-        { document: enDoc, actualLocale: defaultLocale },
-        locale,
-        defaultLocale,
-        allDocs,
-        type
-      );
+      return { document: enDoc, actualLocale: defaultLocale };
     }
     const byEn = idx?.byEnSlug.get(slug);
     if (byEn) {
-      return withRedirectTo(
-        { document: byEn, actualLocale: locale },
-        locale,
-        defaultLocale,
-        allDocs,
-        type
-      );
+      return { document: byEn, actualLocale: locale };
     }
     const fallback = allDocs.get(defaultLocale)?.bySlug.get(slug);
     if (fallback && type.indexFallback === "en") {
-      return withRedirectTo(
-        { document: fallback, actualLocale: defaultLocale },
-        locale,
-        defaultLocale,
-        allDocs,
-        type
-      );
+      return { document: fallback, actualLocale: defaultLocale };
     }
   }
   return { document: null, actualLocale: locale };
@@ -1078,6 +1044,7 @@ function buildRuntime(config, type, getRuntime) {
     }
     return type.path;
   }
+  const urlBuilder = createUrlBuilder(config);
   const runtime = {
     id: type.id,
     config: type,
@@ -1093,15 +1060,21 @@ function buildRuntime(config, type, getRuntime) {
       return load().get(locale)?.bySlug.get(slug) ?? null;
     },
     resolve(slug, locale) {
-      const result = resolveLocalizedDocument(slug, locale, config.defaultLocale, load(), type);
+      const result = resolveLocalizedDocument(
+        slug,
+        locale,
+        config.defaultLocale,
+        load(),
+        type,
+        config.localeRouting
+      );
       if (result.document && type.path) {
         return {
           ...result,
-          canonicalPath: resolvePath(
+          canonicalPath: urlBuilder.resolvePath(
             type.path,
             result.document.slug,
-            result.actualLocale,
-            config.defaultLocale
+            result.actualLocale
           )
         };
       }
@@ -1125,10 +1098,9 @@ function buildRuntime(config, type, getRuntime) {
     alternates(doc) {
       const pathTemplate = assertRoutable("alternates");
       const out = {
-        [config.defaultLocale]: resolvePath(
+        [config.defaultLocale]: urlBuilder.resolvePath(
           pathTemplate,
           doc.enSlug,
-          config.defaultLocale,
           config.defaultLocale
         )
       };
@@ -1137,7 +1109,7 @@ function buildRuntime(config, type, getRuntime) {
         if (locale === config.defaultLocale) continue;
         const translated = all.get(locale)?.byEnSlug.get(doc.enSlug);
         if (translated) {
-          out[locale] = resolvePath(pathTemplate, translated.slug, locale, config.defaultLocale);
+          out[locale] = urlBuilder.resolvePath(pathTemplate, translated.slug, locale);
         }
       }
       return out;
@@ -1152,7 +1124,7 @@ function buildRuntime(config, type, getRuntime) {
     },
     url(slug, locale) {
       const pathTemplate = assertRoutable("url");
-      return resolvePath(pathTemplate, slug, locale, config.defaultLocale);
+      return urlBuilder.resolvePath(pathTemplate, slug, locale);
     },
     related(doc, fieldName, locale) {
       const meta = relationFields.get(fieldName);
@@ -1221,208 +1193,141 @@ init_esm_shims();
 // src/redirects/build-redirects.ts
 init_esm_shims();
 
-// src/core/slug-aliases.ts
-init_esm_shims();
-
 // src/core/alias-helpers.ts
 init_esm_shims();
 function enFileExists(config, type, enSlug) {
   const dir = path4.join(config.rootDir, type.contentDir);
   return fs2.existsSync(path4.join(dir, `${enSlug}.mdx`)) || fs2.existsSync(path4.join(dir, `${enSlug}.md`));
 }
-function sqliteHasTranslations(db, contentTypeId, enSlug) {
-  return listTranslationsForEnSlug(db, contentTypeId, enSlug).length > 0;
-}
-function isAliasKnown(config, type, aliasEnSlug, db) {
-  return enFileExists(config, type, aliasEnSlug) || sqliteHasTranslations(db, type.id, aliasEnSlug);
-}
 function listEnSlugs(rootDir, contentDir) {
   const dir = path4.join(rootDir, contentDir);
   if (!fs2.existsSync(dir)) return [];
   return fs2.readdirSync(dir).filter(isPublishableContentFile).map((f) => f.replace(/\.(md|mdx)$/, ""));
 }
 
-// src/core/slug-aliases.ts
+// src/i18n/translation-index.ts
+init_esm_shims();
+
+// src/redirects/build-redirects.ts
 init_sqlite();
-function buildGlobalAliasIndex(project) {
-  const { config } = project;
-  const aliasToTarget = /* @__PURE__ */ new Map();
-  const allAliasSlugs = /* @__PURE__ */ new Set();
-  const issues = [];
-  const canonicalSlugsByType = /* @__PURE__ */ new Map();
-  for (const type of config.types) {
-    const slugs = listEnSlugs(config.rootDir, type.contentDir);
-    canonicalSlugsByType.set(type.id, new Set(slugs));
+
+// src/redirects/build-json-redirects.ts
+init_esm_shims();
+init_sqlite();
+
+// src/redirects/load-type-redirects.ts
+init_esm_shims();
+
+// src/redirects/redirect-schema.ts
+init_esm_shims();
+var redirectFromSchema = z.union([
+  slugPatternSchema,
+  z.array(slugPatternSchema).min(1).max(20)
+]);
+var typeRedirectEntrySchema = z.object({
+  from: redirectFromSchema,
+  toSlug: slugPatternSchema.optional(),
+  toType: z.string().min(1).optional(),
+  toUrl: z.string().min(1).optional(),
+  permanent: z.boolean().optional()
+}).superRefine((entry, ctx) => {
+  const hasToSlug = entry.toSlug !== void 0;
+  const hasToUrl = entry.toUrl !== void 0;
+  const hasToType = entry.toType !== void 0;
+  const targetCount = Number(hasToSlug) + Number(hasToUrl);
+  if (targetCount !== 1) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Each redirect must specify exactly one of toSlug/toType+toSlug or toUrl",
+      path: ["toSlug"]
+    });
+    return;
   }
-  for (const type of config.types) {
-    if (!type.path) continue;
-    const canonicalSlugs = canonicalSlugsByType.get(type.id) ?? /* @__PURE__ */ new Set();
-    for (const enSlug of canonicalSlugs) {
-      const doc = readEnDocument(config, type, enSlug);
-      if (!doc) continue;
-      for (const alias of doc.aliases) {
-        if (alias === enSlug) {
-          issues.push({
-            contentTypeId: type.id,
-            enSlug,
-            field: "aliases",
-            message: `Alias "${alias}" must not equal the canonical slug`,
-            level: "error"
-          });
-          continue;
-        }
-        if (canonicalSlugs.has(alias)) {
-          issues.push({
-            contentTypeId: type.id,
-            enSlug,
-            field: "aliases",
-            message: `Alias "${alias}" collides with another document's canonical slug`,
-            level: "error"
-          });
-          continue;
-        }
-        const existing = aliasToTarget.get(alias);
-        if (existing) {
-          issues.push({
-            contentTypeId: type.id,
-            enSlug,
-            field: "aliases",
-            message: `Alias "${alias}" is already claimed by ${existing.contentTypeId}/${existing.canonicalSlug}`,
-            level: "error"
-          });
-          continue;
-        }
-        aliasToTarget.set(alias, {
-          contentTypeId: type.id,
-          canonicalSlug: enSlug,
-          path: type.path
-        });
-        allAliasSlugs.add(alias);
-      }
-    }
+  if (hasToUrl && hasToType) {
+    ctx.addIssue({
+      code: "custom",
+      message: "toUrl cannot be combined with toType",
+      path: ["toUrl"]
+    });
+  }
+  if (hasToType && !hasToSlug) {
+    ctx.addIssue({
+      code: "custom",
+      message: "Cross-type redirects require both toType and toSlug",
+      path: ["toSlug"]
+    });
   }
-  return { aliasToTarget, allAliasSlugs, issues };
+});
+var typeRedirectsFileSchema = z.object({
+  redirects: z.array(typeRedirectEntrySchema).max(500)
+});
+function normalizeRedirectFrom(from) {
+  return Array.isArray(from) ? from : [from];
 }
-function validateAliasCoverage(project) {
-  const { config } = project;
-  const { aliasToTarget } = buildGlobalAliasIndex(project);
-  const issues = [];
-  const db = openStore(config, "readonly");
-  try {
-    for (const [alias, target] of aliasToTarget) {
-      const type = config.types.find((t) => t.id === target.contentTypeId);
-      if (!type) continue;
-      const known = isAliasKnown(config, type, alias, db);
-      if (!known) {
-        issues.push({
-          contentTypeId: type.id,
-          enSlug: target.canonicalSlug,
-          field: "aliases",
-          message: `Alias "${alias}" is unknown (no EN file or sqlite translations) \u2014 only EN redirect will work`,
-          level: "warning"
-        });
-      }
-      if (enFileExists(config, type, alias)) {
-        issues.push({
-          contentTypeId: type.id,
-          enSlug: target.canonicalSlug,
-          field: "aliases",
-          message: `Alias "${alias}" still has an EN file on disk \u2014 delete it manually`,
-          level: "warning"
-        });
-      }
-      const sqliteRows = listTranslationsForEnSlug(db, type.id, alias);
-      if (sqliteRows.length > 0) {
-        issues.push({
-          contentTypeId: type.id,
-          enSlug: target.canonicalSlug,
-          field: "aliases",
-          message: `${sqliteRows.length} sqlite translation(s) for alias "${alias}" retained for locale redirects and history`,
-          level: "info"
-        });
-      }
-      for (const locale of config.locales) {
-        if (locale === config.defaultLocale) continue;
-        const canonicalRow = listTranslationsForEnSlug(db, type.id, target.canonicalSlug).find(
-          (r) => r.locale === locale
-        );
-        if (!canonicalRow) continue;
-        const aliasRow = sqliteRows.find((r) => r.locale === locale);
-        if (!aliasRow && known) {
-          issues.push({
-            contentTypeId: type.id,
-            enSlug: target.canonicalSlug,
-            field: "aliases",
-            message: `Alias "${alias}" has no locale slug mapping for ${locale} \u2014 old localized URL may miss redirect`,
-            level: "warning"
-          });
-        }
-      }
-    }
-  } finally {
-    db.close();
+function parseRedirectEntry(entry) {
+  const fromSlugs = normalizeRedirectFrom(entry.from);
+  if (entry.toUrl !== void 0) {
+    return {
+      fromSlugs,
+      kind: "anywhere",
+      toUrl: entry.toUrl,
+      permanent: entry.permanent ?? true
+    };
   }
-  return issues;
+  if (entry.toType !== void 0) {
+    return {
+      fromSlugs,
+      kind: "cross-type",
+      toType: entry.toType,
+      toSlug: entry.toSlug,
+      permanent: entry.permanent ?? true
+    };
+  }
+  return {
+    fromSlugs,
+    kind: "same-type",
+    toSlug: entry.toSlug,
+    permanent: entry.permanent ?? true
+  };
 }
-function validateAliasRedirectChains(project) {
-  const { config } = project;
-  const { aliasToTarget, allAliasSlugs } = buildGlobalAliasIndex(project);
-  const issues = [];
-  for (const [alias, target] of aliasToTarget) {
-    const doc = readEnDocument(
-      config,
-      project.getType(target.contentTypeId).config,
-      target.canonicalSlug
+
+// src/redirects/load-type-redirects.ts
+var TYPE_REDIRECTS_FILENAME = "_redirects.json";
+function redirectsFilePath(config, type) {
+  return path4.join(config.rootDir, type.contentDir, TYPE_REDIRECTS_FILENAME);
+}
+function loadTypeRedirectsFile(config, type) {
+  const filePath = redirectsFilePath(config, type);
+  if (!fs2.existsSync(filePath)) return null;
+  let raw;
+  try {
+    raw = JSON.parse(fs2.readFileSync(filePath, "utf8"));
+  } catch (error) {
+    throw new Error(
+      `${type.id}: failed to parse ${TYPE_REDIRECTS_FILENAME}: ${error instanceof Error ? error.message : String(error)}`
     );
-    if (doc?.redirectTo) {
-      issues.push({
-        contentTypeId: target.contentTypeId,
-        enSlug: target.canonicalSlug,
-        field: "aliases",
-        message: `Alias "${alias}" points at "${target.canonicalSlug}" which has redirect_to \u2014 resolve to the final canonical slug`,
-        level: "error"
-      });
-    }
   }
+  const parsed = typeRedirectsFileSchema.safeParse(raw);
+  if (!parsed.success) {
+    const details = parsed.error.issues.map((issue) => `${issue.path.join(".") || "root"}: ${issue.message}`).join("; ");
+    throw new Error(`${type.id}: invalid ${TYPE_REDIRECTS_FILENAME}: ${details}`);
+  }
+  return {
+    contentTypeId: type.id,
+    contentDir: type.contentDir,
+    filePath,
+    entries: parsed.data.redirects.map(parseRedirectEntry)
+  };
+}
+function loadAllTypeRedirects(config) {
+  const out = [];
   for (const type of config.types) {
-    if (!type.path) continue;
-    for (const enSlug of listEnSlugs(config.rootDir, type.contentDir)) {
-      const doc = readEnDocument(config, type, enSlug);
-      if (!doc?.redirectTo) continue;
-      const targetSlug = extractSlugFromResolvedPath(type.path, doc.redirectTo);
-      if (targetSlug && allAliasSlugs.has(targetSlug)) {
-        issues.push({
-          contentTypeId: type.id,
-          enSlug,
-          field: "redirect_to",
-          message: `redirect_to target "${targetSlug}" is an alias slug \u2014 chain detected`,
-          level: "error"
-        });
-      }
-      const targetDoc = targetSlug ? readEnDocument(config, type, targetSlug) : null;
-      if (targetDoc?.redirectTo) {
-        issues.push({
-          contentTypeId: type.id,
-          enSlug,
-          field: "redirect_to",
-          message: `redirect_to chain detected: "${enSlug}" \u2192 "${targetSlug}" \u2192 "${targetDoc.redirectTo}"`,
-          level: "error"
-        });
-      }
-    }
+    const loaded = loadTypeRedirectsFile(config, type);
+    if (loaded) out.push(loaded);
   }
-  return issues;
+  return out;
 }
 
-// src/redirects/translation-index.ts
-init_esm_shims();
-
-// src/i18n/translation-index.ts
-init_esm_shims();
-
-// src/redirects/translation-index.ts
-init_sqlite();
-
 // src/sitemap/join-base-url.ts
 init_esm_shims();
 
@@ -1474,6 +1379,174 @@ function loadConfigSync(options = {}) {
 
 // src/validate/validate-project.ts
 init_esm_shims();
+
+// src/validate/validate-redirects.ts
+init_esm_shims();
+function liveDocExists(config, typeId, enSlug) {
+  const type = config.types.find((entry) => entry.id === typeId);
+  if (!type) return false;
+  return enFileExists(config, type, enSlug);
+}
+function resolveRedirectTarget(project, sourceTypeId, entry) {
+  if (entry.kind === "anywhere") return null;
+  if (entry.kind === "cross-type") {
+    return { typeId: entry.toType, enSlug: entry.toSlug };
+  }
+  return { typeId: sourceTypeId, enSlug: entry.toSlug };
+}
+function matchRoutableTarget(project, toUrl) {
+  const urlBuilder = createUrlBuilder(project.config);
+  for (const type of project.config.types) {
+    if (!type.path) continue;
+    const enSlug = urlBuilder.extractSlugFromResolvedPath(type.path, toUrl);
+    if (enSlug && liveDocExists(project.config, type.id, enSlug)) {
+      return { typeId: type.id, enSlug };
+    }
+  }
+  return null;
+}
+function validateTypeRedirects(project) {
+  const issues = [];
+  const globalFrom = /* @__PURE__ */ new Map();
+  for (const type of project.config.types) {
+    const filePath = path4.join(project.config.rootDir, type.contentDir, TYPE_REDIRECTS_FILENAME);
+    if (!fs2.existsSync(filePath)) continue;
+    let loaded;
+    try {
+      loaded = loadTypeRedirectsFile(project.config, type);
+    } catch (error) {
+      issues.push({
+        level: "error",
+        contentType: type.id,
+        field: TYPE_REDIRECTS_FILENAME,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      continue;
+    }
+    if (!loaded) continue;
+    if (!isRoutableType(type)) {
+      issues.push({
+        level: "error",
+        contentType: type.id,
+        field: TYPE_REDIRECTS_FILENAME,
+        message: `Redirects are only supported on routable content types (missing path)`
+      });
+      continue;
+    }
+    for (const entry of loaded.entries) {
+      for (const from of entry.fromSlugs) {
+        if (entry.kind === "same-type" && from === entry.toSlug) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            enSlug: from,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Redirect source "${from}" must not equal its target slug`
+          });
+        }
+        if (liveDocExists(project.config, type.id, from)) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            enSlug: from,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Redirect source "${from}" still has a live EN file \u2014 delete or rename the MDX first`
+          });
+        }
+        const existing = globalFrom.get(from);
+        if (existing && existing.typeId !== type.id) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            enSlug: from,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Redirect source "${from}" is already claimed by ${existing.typeId}`
+          });
+        } else if (existing) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            enSlug: from,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Duplicate redirect source "${from}" in ${TYPE_REDIRECTS_FILENAME}`
+          });
+        } else {
+          globalFrom.set(from, { typeId: type.id, filePath: loaded.filePath });
+        }
+      }
+      if (entry.kind === "cross-type") {
+        const targetType = project.config.types.find((candidate) => candidate.id === entry.toType);
+        if (!targetType) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Unknown redirect target type "${entry.toType}"`
+          });
+          continue;
+        }
+        if (!isRoutableType(targetType)) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Redirect target type "${entry.toType}" is not routable (missing path)`
+          });
+          continue;
+        }
+      }
+      const target = resolveRedirectTarget(project, type.id, entry);
+      if (target) {
+        if (!liveDocExists(project.config, target.typeId, target.enSlug)) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Redirect target ${target.typeId}/${target.enSlug} does not exist`
+          });
+        }
+        continue;
+      }
+      if (entry.kind === "anywhere" && entry.toUrl?.startsWith("/")) {
+        const matched = matchRoutableTarget(project, entry.toUrl);
+        if (matched && !liveDocExists(project.config, matched.typeId, matched.enSlug)) {
+          issues.push({
+            level: "error",
+            contentType: type.id,
+            field: TYPE_REDIRECTS_FILENAME,
+            message: `Redirect toUrl "${entry.toUrl}" does not resolve to a live document`
+          });
+        }
+      }
+    }
+  }
+  const allLoaded = loadAllTypeRedirects(project.config);
+  for (const file of allLoaded) {
+    for (const entry of file.entries) {
+      if (entry.kind === "anywhere" || !entry.toSlug) continue;
+      const targetTypeId = entry.kind === "cross-type" ? entry.toType : file.contentTypeId;
+      const targetType = project.config.types.find((type) => type.id === targetTypeId);
+      if (!targetType?.path) continue;
+      for (const from of entry.fromSlugs) {
+        if (globalFrom.get(from)?.typeId !== file.contentTypeId) continue;
+        const targetAsSource = globalFrom.get(entry.toSlug);
+        if (!targetAsSource) continue;
+        const sameSlugCrossType = entry.kind === "cross-type" && entry.fromSlugs.includes(entry.toSlug) && targetAsSource.typeId === file.contentTypeId;
+        if (sameSlugCrossType) continue;
+        issues.push({
+          level: "error",
+          contentType: file.contentTypeId,
+          enSlug: from,
+          field: TYPE_REDIRECTS_FILENAME,
+          message: `Redirect chain detected: "${from}" \u2192 "${entry.toSlug}" \u2192 existing redirect source`
+        });
+      }
+    }
+  }
+  return issues;
+}
+
+// src/validate/validate-project.ts
 init_sqlite();
 
 // src/validate/validate-relations.ts
@@ -1674,7 +1747,7 @@ function validateTranslationSlugSuffixes(config, db) {
 }
 
 // src/validate/validate-project.ts
-function listEnSlugs2(rootDir, contentDir) {
+function listEnSlugs3(rootDir, contentDir) {
   const dir = path4.join(rootDir, contentDir);
   if (!fs2.existsSync(dir)) return [];
   return fs2.readdirSync(dir).filter(isPublishableContentFile).map((f) => f.replace(/\.(md|mdx)$/, ""));
@@ -1692,7 +1765,7 @@ function validateProject(config) {
   }
   const db = openStore(config, "readonly");
   for (const type of config.types) {
-    const enSlugs = listEnSlugs2(config.rootDir, type.contentDir);
+    const enSlugs = listEnSlugs3(config.rootDir, type.contentDir);
     const englishSlugs = new Set(enSlugs);
     if (!type.translate && isRoutableType(type)) {
       issues.push({
@@ -1774,33 +1847,8 @@ function validateProject(config) {
     }
   }
   db.close();
-  const aliasIndex = buildGlobalAliasIndex(project);
-  for (const issue of aliasIndex.issues) {
-    issues.push({
-      level: issue.level,
-      contentType: issue.contentTypeId,
-      enSlug: issue.enSlug,
-      field: issue.field,
-      message: issue.message
-    });
-  }
-  for (const issue of validateAliasRedirectChains(project)) {
-    issues.push({
-      level: issue.level,
-      contentType: issue.contentTypeId,
-      enSlug: issue.enSlug,
-      field: issue.field,
-      message: issue.message
-    });
-  }
-  for (const issue of validateAliasCoverage(project)) {
-    issues.push({
-      level: issue.level,
-      contentType: issue.contentTypeId,
-      enSlug: issue.enSlug,
-      field: issue.field,
-      message: issue.message
-    });
+  for (const issue of validateTypeRedirects(project)) {
+    issues.push(issue);
   }
   for (const issue of validateRelations(project)) {
     issues.push({
@@ -1844,7 +1892,7 @@ function computePageEnHash(translatableFrontmatter, body) {
 
 // src/translate/worklist.ts
 init_sqlite();
-function listEnSlugs3(rootDir, contentDir) {
+function listEnSlugs4(rootDir, contentDir) {
   const dir = path4.join(rootDir, contentDir);
   if (!fs2.existsSync(dir)) return [];
   return fs2.readdirSync(dir).filter(isPublishableContentFile).map((f) => f.replace(/\.(md|mdx)$/, ""));
@@ -1855,7 +1903,7 @@ function buildWorklist(config, options = {}) {
   const locales = options.locales ?? config.locales.filter((locale) => locale !== config.defaultLocale);
   for (const type of config.types) {
     if (options.contentType && type.id !== options.contentType) continue;
-    const enSlugs = options.enSlug ? [options.enSlug] : listEnSlugs3(config.rootDir, type.contentDir);
+    const enSlugs = options.enSlug ? [options.enSlug] : listEnSlugs4(config.rootDir, type.contentDir);
     for (const enSlug of enSlugs) {
       const enDoc = readEnDocument(config, type, enSlug);
       if (!enDoc) continue;
@@ -2542,6 +2590,7 @@ function buildStaticRawExports(project, options = {}) {
   const excludeNoindex = options.excludeNoindex ?? false;
   const typeFilter = options.types ? new Set(options.types) : null;
   const out = [];
+  const urlBuilder = createUrlBuilder(config);
   for (const type of project.listTypes()) {
     if (!isRoutableType(type.config)) continue;
     if (typeFilter && !typeFilter.has(type.id)) continue;
@@ -2557,7 +2606,7 @@ function buildStaticRawExports(project, options = {}) {
         if (excludeNoindex && resolved.document.noindex) continue;
         const doc = resolved.document;
         const slugWithExt = `${doc.slug}${extension}`;
-        const urlPath = resolvePath(pathTemplate, slugWithExt, locale, config.defaultLocale);
+        const urlPath = urlBuilder.resolvePath(pathTemplate, slugWithExt, locale);
         out.push({
           relativePath: urlPath.slice(1),
           urlPath,