@phtngyn/cms 0.2.0-beta.7 → 0.3.0

package/src/Query-C0kGJF5_.d.ts

@@ -0,0 +1,261 @@
+import { i as RevisionRenderNode } from "./Document-TgwYKJZM.js";
+import { Schema } from "effect";
+//#region ../model/src/Query.d.ts
+declare const DocumentQuerySort: Schema.Struct<{
+  readonly field: Schema.NonEmptyString;
+  readonly direction: Schema.optionalKey<Schema.Literals<readonly ["asc", "desc"]>>;
+}>;
+type DocumentQuerySort = typeof DocumentQuerySort.Type;
+declare const DocumentQuery: Schema.Struct<{
+  readonly collection: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly locale: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly limit: Schema.Int;
+  readonly offset: Schema.optionalKey<Schema.Int>;
+  readonly where: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>]>>>;
+  readonly sort: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly field: Schema.NonEmptyString;
+    readonly direction: Schema.optionalKey<Schema.Literals<readonly ["asc", "desc"]>>;
+  }>>>;
+}>;
+type DocumentQuery = typeof DocumentQuery.Type;
+declare const DocumentQueryItem: Schema.Struct<{
+  readonly path: Schema.String;
+  readonly canonicalPath: Schema.String;
+  readonly locale: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly requestedLocale: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly identity: Schema.Struct<{
+    readonly documentId: Schema.brand<Schema.String, "DocumentId">;
+    readonly collection: Schema.NonEmptyString;
+  }>;
+  readonly source: Schema.Struct<{
+    readonly settings: Schema.Struct<{
+      readonly placement: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"home">;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"entry">;
+        readonly parentDocumentId: Schema.brand<Schema.String, "DocumentId">;
+        readonly slug: Schema.NonEmptyString;
+      }>]>;
+      readonly seo: Schema.optionalKey<Schema.Struct<{
+        readonly title: Schema.optionalKey<Schema.String>;
+        readonly description: Schema.optionalKey<Schema.String>;
+        readonly socialTitle: Schema.optionalKey<Schema.String>;
+        readonly socialDescription: Schema.optionalKey<Schema.String>;
+        readonly socialImage: Schema.optionalKey<Schema.Struct<{
+          readonly mediaId: Schema.brand<Schema.String, "MediaId">;
+          readonly alt: Schema.String;
+        }>>;
+        readonly index: Schema.optionalKey<Schema.Boolean>;
+        readonly follow: Schema.optionalKey<Schema.Boolean>;
+        readonly canonicalUrl: Schema.optionalKey<Schema.String>;
+        readonly structuredData: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+          readonly type: Schema.Literal<"WebPage">;
+        }>, Schema.Struct<{
+          readonly type: Schema.Literal<"Article">;
+          readonly headline: Schema.optionalKey<Schema.String>;
+          readonly datePublished: Schema.optionalKey<Schema.String>;
+          readonly dateModified: Schema.optionalKey<Schema.String>;
+        }>]>>;
+      }>>;
+      readonly translatedSeo: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly title: Schema.optionalKey<Schema.String>;
+        readonly description: Schema.optionalKey<Schema.String>;
+        readonly socialTitle: Schema.optionalKey<Schema.String>;
+        readonly socialDescription: Schema.optionalKey<Schema.String>;
+        readonly socialImage: Schema.optionalKey<Schema.Struct<{
+          readonly mediaId: Schema.brand<Schema.String, "MediaId">;
+          readonly alt: Schema.String;
+        }>>;
+        readonly index: Schema.optionalKey<Schema.Boolean>;
+        readonly follow: Schema.optionalKey<Schema.Boolean>;
+        readonly canonicalUrl: Schema.optionalKey<Schema.String>;
+        readonly structuredData: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+          readonly type: Schema.Literal<"WebPage">;
+        }>, Schema.Struct<{
+          readonly type: Schema.Literal<"Article">;
+          readonly headline: Schema.optionalKey<Schema.String>;
+          readonly datePublished: Schema.optionalKey<Schema.String>;
+          readonly dateModified: Schema.optionalKey<Schema.String>;
+        }>]>>;
+      }>>>;
+    }>;
+    readonly translations: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Struct<{
+      readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+      readonly body: Schema.Struct<{
+        readonly type: Schema.Literal<"doc">;
+        readonly content: Schema.$Array<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      }>;
+    }>>>;
+    readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    readonly body: Schema.Struct<{
+      readonly type: Schema.Literal<"doc">;
+      readonly content: Schema.$Array<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    }>;
+    readonly format: Schema.Literal<1>;
+  }>;
+  readonly savedRevisionId: Schema.brand<Schema.String, "RevisionId">;
+  readonly draft: Schema.Boolean;
+  readonly publishedAt: Schema.optionalKey<Schema.String>;
+  readonly referencePaths: Schema.$Record<Schema.String, Schema.String>;
+  readonly renderPlan: Schema.optionalKey<Schema.Struct<{
+    readonly fields: Schema.Struct<{
+      readonly mode: Schema.Literals<readonly ["current", "readable"]>;
+      readonly values: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    }>;
+    readonly body: Schema.$Array<Schema.Codec<RevisionRenderNode, RevisionRenderNode, never, never>>;
+  }>>;
+  readonly renderIssues: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly severity: Schema.Literal<"warning">;
+    readonly recovery: Schema.Literals<readonly ["render", "readable", "placeholder", "disabled"]>;
+    readonly code: Schema.String;
+    readonly location: Schema.Union<readonly [Schema.Struct<{
+      readonly kind: Schema.Literal<"field">;
+      readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"block">;
+      readonly blockId: Schema.optionalKey<Schema.String>;
+      readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"seo">;
+      readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"placement">;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"body">;
+      readonly path: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>>;
+    }>, Schema.Struct<{
+      readonly kind: Schema.Literal<"document">;
+    }>]>;
+    readonly message: Schema.String;
+    readonly details: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly locale: Schema.optionalKey<Schema.String>;
+  }>>>;
+  readonly alternatives: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+    readonly locale: Schema.String;
+    readonly path: Schema.String;
+  }>>>;
+}>;
+type DocumentQueryItem = typeof DocumentQueryItem.Type;
+declare const DocumentQueryPage: Schema.Struct<{
+  readonly items: Schema.$Array<Schema.Struct<{
+    readonly path: Schema.String;
+    readonly canonicalPath: Schema.String;
+    readonly locale: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly requestedLocale: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly identity: Schema.Struct<{
+      readonly documentId: Schema.brand<Schema.String, "DocumentId">;
+      readonly collection: Schema.NonEmptyString;
+    }>;
+    readonly source: Schema.Struct<{
+      readonly settings: Schema.Struct<{
+        readonly placement: Schema.Union<readonly [Schema.Struct<{
+          readonly kind: Schema.Literal<"home">;
+        }>, Schema.Struct<{
+          readonly kind: Schema.Literal<"entry">;
+          readonly parentDocumentId: Schema.brand<Schema.String, "DocumentId">;
+          readonly slug: Schema.NonEmptyString;
+        }>]>;
+        readonly seo: Schema.optionalKey<Schema.Struct<{
+          readonly title: Schema.optionalKey<Schema.String>;
+          readonly description: Schema.optionalKey<Schema.String>;
+          readonly socialTitle: Schema.optionalKey<Schema.String>;
+          readonly socialDescription: Schema.optionalKey<Schema.String>;
+          readonly socialImage: Schema.optionalKey<Schema.Struct<{
+            readonly mediaId: Schema.brand<Schema.String, "MediaId">;
+            readonly alt: Schema.String;
+          }>>;
+          readonly index: Schema.optionalKey<Schema.Boolean>;
+          readonly follow: Schema.optionalKey<Schema.Boolean>;
+          readonly canonicalUrl: Schema.optionalKey<Schema.String>;
+          readonly structuredData: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.Literal<"WebPage">;
+          }>, Schema.Struct<{
+            readonly type: Schema.Literal<"Article">;
+            readonly headline: Schema.optionalKey<Schema.String>;
+            readonly datePublished: Schema.optionalKey<Schema.String>;
+            readonly dateModified: Schema.optionalKey<Schema.String>;
+          }>]>>;
+        }>>;
+        readonly translatedSeo: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Struct<{
+          readonly title: Schema.optionalKey<Schema.String>;
+          readonly description: Schema.optionalKey<Schema.String>;
+          readonly socialTitle: Schema.optionalKey<Schema.String>;
+          readonly socialDescription: Schema.optionalKey<Schema.String>;
+          readonly socialImage: Schema.optionalKey<Schema.Struct<{
+            readonly mediaId: Schema.brand<Schema.String, "MediaId">;
+            readonly alt: Schema.String;
+          }>>;
+          readonly index: Schema.optionalKey<Schema.Boolean>;
+          readonly follow: Schema.optionalKey<Schema.Boolean>;
+          readonly canonicalUrl: Schema.optionalKey<Schema.String>;
+          readonly structuredData: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.Literal<"WebPage">;
+          }>, Schema.Struct<{
+            readonly type: Schema.Literal<"Article">;
+            readonly headline: Schema.optionalKey<Schema.String>;
+            readonly datePublished: Schema.optionalKey<Schema.String>;
+            readonly dateModified: Schema.optionalKey<Schema.String>;
+          }>]>>;
+        }>>>;
+      }>;
+      readonly translations: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Struct<{
+        readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        readonly body: Schema.Struct<{
+          readonly type: Schema.Literal<"doc">;
+          readonly content: Schema.$Array<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+        }>;
+      }>>>;
+      readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+      readonly body: Schema.Struct<{
+        readonly type: Schema.Literal<"doc">;
+        readonly content: Schema.$Array<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      }>;
+      readonly format: Schema.Literal<1>;
+    }>;
+    readonly savedRevisionId: Schema.brand<Schema.String, "RevisionId">;
+    readonly draft: Schema.Boolean;
+    readonly publishedAt: Schema.optionalKey<Schema.String>;
+    readonly referencePaths: Schema.$Record<Schema.String, Schema.String>;
+    readonly renderPlan: Schema.optionalKey<Schema.Struct<{
+      readonly fields: Schema.Struct<{
+        readonly mode: Schema.Literals<readonly ["current", "readable"]>;
+        readonly values: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+      }>;
+      readonly body: Schema.$Array<Schema.Codec<RevisionRenderNode, RevisionRenderNode, never, never>>;
+    }>>;
+    readonly renderIssues: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly severity: Schema.Literal<"warning">;
+      readonly recovery: Schema.Literals<readonly ["render", "readable", "placeholder", "disabled"]>;
+      readonly code: Schema.String;
+      readonly location: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"field">;
+        readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"block">;
+        readonly blockId: Schema.optionalKey<Schema.String>;
+        readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"seo">;
+        readonly path: Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"placement">;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"body">;
+        readonly path: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>>;
+      }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"document">;
+      }>]>;
+      readonly message: Schema.String;
+      readonly details: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+      readonly locale: Schema.optionalKey<Schema.String>;
+    }>>>;
+    readonly alternatives: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+      readonly locale: Schema.String;
+      readonly path: Schema.String;
+    }>>>;
+  }>>;
+  readonly total: Schema.Int;
+}>;
+type DocumentQueryPage = typeof DocumentQueryPage.Type;
+//#endregion
+export { DocumentQuerySort as i, DocumentQueryItem as n, DocumentQueryPage as r, DocumentQuery as t };

package/src/RevisionPreview-IVwbJ9Wy.js

@@ -0,0 +1,133 @@
+import { A as RevisionPreviewIssue, h as DocumentSettings, j as RevisionRenderPlan, l as DocumentId, s as DocumentContent, u as DocumentIdentity, x as RevisionId } from "./Document-CKXMSEf1.js";
+import { t as Locale } from "./Locales-Ch7a5xuA.js";
+import { c as FormSteps, o as FormReference } from "./contracts-rprW3ZOB.js";
+import { Schema } from "effect";
+//#region ../model/src/RevisionPreview.ts
+/** The website adapter renders this dedicated route; it carries the token in its URL. */
+const revisionPreviewPath = "/_cms/revision-preview";
+const revisionPreviewQueryKey = "__cms_revision";
+const savedRevisionPreviewDocumentQueryKey = "__cms_saved_document";
+const savedRevisionPreviewQueryKey = "__cms_saved_revision";
+const SavedRevisionPreviewSelection = Schema.Struct({
+	documentId: DocumentId,
+	revisionId: RevisionId
+});
+const RevisionLinkId = Schema.String.check(Schema.isUUID()).pipe(Schema.brand("RevisionLinkId"));
+const RevisionLinkToken = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9_-]{43}$/u));
+/** A saved preview stays attached to an ordinary site address without a shared browser cookie. */
+function revisionPreviewLocation(path, token, locale) {
+	const url = previewUrl(path);
+	Schema.decodeSync(RevisionLinkToken)(token);
+	url.searchParams.set(url.pathname === "/_cms/revision-preview" ? "token" : revisionPreviewQueryKey, token);
+	if (locale) url.searchParams.set("locale", locale);
+	return `${url.pathname}${url.search}${url.hash}`;
+}
+/** Session-authenticated preview selects saved content without issuing a sharing credential. */
+function savedRevisionPreviewLocation(path, documentId, revisionId, locale) {
+	const url = previewUrl(path);
+	Schema.decodeSync(SavedRevisionPreviewSelection)({
+		documentId,
+		revisionId
+	});
+	url.searchParams.set(url.pathname === "/_cms/revision-preview" ? "documentId" : savedRevisionPreviewDocumentQueryKey, documentId);
+	url.searchParams.set(url.pathname === "/_cms/revision-preview" ? "revisionId" : savedRevisionPreviewQueryKey, revisionId);
+	if (locale) url.searchParams.set("locale", locale);
+	return `${url.pathname}${url.search}${url.hash}`;
+}
+function previewUrl(path) {
+	const url = new URL(path, "https://cms.invalid");
+	if (url.origin !== "https://cms.invalid") throw new Error("Revision preview must belong to this site.");
+	for (const key of [
+		"__cms_preview",
+		revisionPreviewQueryKey,
+		savedRevisionPreviewDocumentQueryKey,
+		savedRevisionPreviewQueryKey,
+		"token",
+		"locale"
+	]) url.searchParams.delete(key);
+	if (url.pathname === "/_cms/revision-preview") {
+		url.searchParams.delete("documentId");
+		url.searchParams.delete("revisionId");
+	}
+	return url;
+}
+function revisionPreviewRequested(route) {
+	return route.path === "/_cms/revision-preview" || Object.hasOwn(route.query, "__cms_revision") || savedRevisionPreviewRequested(route);
+}
+function revisionPreviewToken(route) {
+	if (savedRevisionPreviewRequested(route)) return null;
+	const value = route.query[route.path === "/_cms/revision-preview" ? "token" : revisionPreviewQueryKey];
+	return Schema.is(RevisionLinkToken)(value) ? value : null;
+}
+function savedRevisionPreviewRequested(route) {
+	return Object.hasOwn(route.query, "__cms_saved_document") || Object.hasOwn(route.query, "__cms_saved_revision") || route.path === "/_cms/revision-preview" && (Object.hasOwn(route.query, "documentId") || Object.hasOwn(route.query, "revisionId"));
+}
+function savedRevisionPreviewSelection(route) {
+	const selection = {
+		documentId: route.query[route.path === "/_cms/revision-preview" ? "documentId" : savedRevisionPreviewDocumentQueryKey],
+		revisionId: route.query[route.path === "/_cms/revision-preview" ? "revisionId" : savedRevisionPreviewQueryKey]
+	};
+	return Schema.is(SavedRevisionPreviewSelection)(selection) ? selection : null;
+}
+/** Preserve the active saved selection across ordinary site routes and language switches. */
+function revisionPreviewNavigationLocation(path, route, locale) {
+	const selection = savedRevisionPreviewSelection(route);
+	if (selection) return savedRevisionPreviewLocation(path, selection.documentId, selection.revisionId, locale);
+	const token = revisionPreviewToken(route);
+	return token ? revisionPreviewLocation(path, token, locale) : null;
+}
+const RevisionLink = Schema.Struct({
+	id: RevisionLinkId,
+	documentId: DocumentId,
+	revisionId: RevisionId,
+	createdAt: Schema.String,
+	createdBy: Schema.String,
+	expiresAt: Schema.String,
+	revokedAt: Schema.NullOr(Schema.String),
+	revokedBy: Schema.NullOr(Schema.String)
+});
+const CreateRevisionLink = Schema.Struct({
+	revisionId: RevisionId,
+	expiresAt: Schema.optionalKey(Schema.String)
+});
+/** The plaintext token is returned once. Listing links never returns a token or digest. */
+const IssuedRevisionLink = Schema.Struct({
+	link: RevisionLink,
+	token: RevisionLinkToken,
+	previewPath: Schema.Literal(revisionPreviewPath)
+});
+const RevisionPreviewForm = Schema.Struct({
+	...FormReference.fields,
+	name: Schema.String,
+	steps: FormSteps,
+	preview: Schema.Literal(true)
+});
+const RevisionPreviewDocument = Schema.Struct({
+	mode: Schema.Literal("revision"),
+	primary: Schema.Boolean,
+	identity: DocumentIdentity,
+	revision: Schema.Struct({
+		id: RevisionId,
+		number: Schema.Int.check(Schema.isGreaterThan(0)),
+		savedAt: Schema.String
+	}),
+	expiresAt: Schema.NullOr(Schema.String),
+	previewPath: Schema.Literal(revisionPreviewPath),
+	logicalPath: Schema.NullOr(Schema.String),
+	livePath: Schema.NullOr(Schema.String),
+	locale: Schema.optionalKey(Locale),
+	requestedLocale: Schema.optionalKey(Locale),
+	settings: DocumentSettings,
+	content: DocumentContent,
+	renderPlan: RevisionRenderPlan,
+	issues: Schema.Array(RevisionPreviewIssue),
+	/** null explicitly disables a destination; a renderer must never fall back to its stored old path. */
+	referencePaths: Schema.Record(Schema.String, Schema.NullOr(Schema.String)),
+	forms: Schema.Array(RevisionPreviewForm)
+});
+const RevisionPreviewQueryPage = Schema.Struct({
+	items: Schema.Array(RevisionPreviewDocument),
+	total: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0))
+});
+//#endregion
+export { savedRevisionPreviewSelection as _, RevisionLinkToken as a, SavedRevisionPreviewSelection as c, revisionPreviewQueryKey as d, revisionPreviewRequested as f, savedRevisionPreviewRequested as g, savedRevisionPreviewQueryKey as h, RevisionLinkId as i, revisionPreviewNavigationLocation as l, savedRevisionPreviewDocumentQueryKey as m, IssuedRevisionLink as n, RevisionPreviewDocument as o, revisionPreviewToken as p, RevisionLink as r, RevisionPreviewQueryPage as s, CreateRevisionLink as t, revisionPreviewPath as u };

package/src/Routes-BaZvm2LE.js

@@ -0,0 +1,126 @@
+import { i as studioErrorReason } from "./StudioErrors-T5zLGQ1M.js";
+//#region ../model/src/Routes.ts
+/** Projects paths from stable identities and revisioned placement without changing either. */
+function projectRoutes(documents, collections, locales) {
+	const byId = new Map(documents.map((document) => [document.identity.documentId, document]));
+	const byCollection = new Map(collections.map((collection) => [collection.collection, collection.pattern]));
+	const cache = /* @__PURE__ */ new Map();
+	const active = /* @__PURE__ */ new Set();
+	const issues = [];
+	const homes = /* @__PURE__ */ new Set();
+	const localePrefix = locales?.prefixDefault ? `/${locales.defaultLocale}` : "";
+	function issue(code, documentId, reason) {
+		issues.push(reason.details ? {
+			code,
+			documentId,
+			message: reason.message,
+			details: reason.details
+		} : {
+			code,
+			documentId,
+			message: reason.message
+		});
+	}
+	function pathFor(document) {
+		const { documentId, collection } = document.identity;
+		if (cache.has(documentId)) return cache.get(documentId);
+		if (active.has(documentId)) return issue("cycle", documentId, studioErrorReason("errors.route.cycle"));
+		const pattern = byCollection.get(collection);
+		if (!pattern) return issue("collection", documentId, studioErrorReason("errors.route.collection", { collection }));
+		if (!pattern.startsWith("/") || pattern.startsWith("//") || !pattern.endsWith("/:path*")) return issue("pattern", documentId, studioErrorReason("errors.route.pattern", { collection }));
+		const prefix = `${localePrefix}${pattern.slice(0, -7)}`;
+		active.add(documentId);
+		let segments = [];
+		if (document.placement.kind === "home") {
+			const homeKey = collection;
+			if (homes.has(homeKey)) issue("home", documentId, studioErrorReason("errors.route.home"));
+			homes.add(homeKey);
+		} else {
+			const parent = byId.get(document.placement.parentDocumentId);
+			if (!parent || parent.identity.collection !== collection) {
+				active.delete(documentId);
+				return issue("parent", documentId, studioErrorReason("errors.route.parent"));
+			}
+			const parentPath = pathFor(parent);
+			if (!parentPath) {
+				active.delete(documentId);
+				return;
+			}
+			segments = [...parentPath.slice(prefix.length).split("/").filter(Boolean).map(decodeURIComponent), document.placement.slug];
+		}
+		active.delete(documentId);
+		const path = normalizePath(`${prefix}/${segments.map(encodeURIComponent).join("/")}`);
+		cache.set(documentId, path);
+		if (locales && (localeFromPath(path, locales) !== locales.defaultLocale || canonicalLocalePath(path, locales) !== path)) issue("locale", documentId, studioErrorReason("errors.route.locale", { path }));
+		return path;
+	}
+	const routes = [];
+	const occupied = /* @__PURE__ */ new Map();
+	for (const document of documents) {
+		const path = pathFor(document);
+		if (!path) continue;
+		const previous = occupied.get(path);
+		if (previous && previous !== document.identity.documentId) issue("collision", document.identity.documentId, studioErrorReason("errors.route.collision", { path }));
+		else occupied.set(path, document.identity.documentId);
+		routes.push({
+			documentId: document.identity.documentId,
+			path
+		});
+	}
+	return {
+		routes,
+		issues
+	};
+}
+function normalizePath(path) {
+	return path === "/" ? path : path.replace(/\/$/u, "");
+}
+function splitSitePath(path) {
+	const suffixIndex = path.search(/[?#]/u);
+	const pathname = suffixIndex === -1 ? path : path.slice(0, suffixIndex);
+	if (!pathname.startsWith("/") || pathname.startsWith("//")) throw new Error("A locale path must start with one slash.");
+	return {
+		pathname,
+		suffix: suffixIndex === -1 ? "" : path.slice(suffixIndex)
+	};
+}
+function prefixedLocale(pathname, routes) {
+	const first = pathname.split("/")[1] ?? "";
+	return routes.supported.some((definition) => definition.code === first) ? first : void 0;
+}
+/** Removes only an exact configured language prefix, keeping the query and fragment. */
+function unlocalizedPath(path, routes) {
+	const { pathname, suffix } = splitSitePath(path);
+	if (!routes) return path;
+	const current = prefixedLocale(pathname, routes);
+	return `${current ? pathname.slice(current.length + 1) || "/" : pathname}${suffix}`;
+}
+/** Resolves the configured language from a site path, including an optional default prefix. */
+function localeFromPath(path, routes) {
+	if (!routes) return void 0;
+	return prefixedLocale(splitSitePath(path).pathname, routes) ?? routes.defaultLocale;
+}
+/** Prefixes an unlocalized site path according to the CMS route policy. */
+function localePath(path, locale, routes) {
+	const { pathname, suffix } = splitSitePath(path);
+	if (!routes) return path;
+	if (!routes.supported.some((definition) => definition.code === locale)) throw new Error(`Unknown locale "${locale}".`);
+	return `${`${routes.prefixDefault || locale !== routes.defaultLocale ? `/${locale}` : ""}${pathname === "/" ? "" : pathname}` || "/"}${suffix}`;
+}
+/** Returns the configured URL form for a path that already identifies its language. */
+function canonicalLocalePath(path, routes) {
+	const { pathname } = splitSitePath(path);
+	if (!routes) return path;
+	const current = prefixedLocale(pathname, routes);
+	return localePath(unlocalizedPath(path, routes), current ?? routes.defaultLocale, routes);
+}
+/** Switches the language of a shared Document address. */
+function switchLocalePath(path, locale, routes) {
+	return localePath(unlocalizedPath(path, routes), locale, routes);
+}
+/** Resolve the single stored Document route from any configured language address. */
+function documentRoutePath(path, locales) {
+	return locales ? switchLocalePath(path, locales.defaultLocale, locales) : path;
+}
+//#endregion
+export { projectRoutes as a, localePath as i, documentRoutePath as n, switchLocalePath as o, localeFromPath as r, unlocalizedPath as s, canonicalLocalePath as t };

package/src/Routes-DM1rRp3r.d.ts

@@ -0,0 +1,15 @@
+import "./Document-TgwYKJZM.js";
+import { r as LocaleConfiguration } from "./Locales-jwbmJaOp.js";
+//#region ../model/src/Routes.d.ts
+/** Removes only an exact configured language prefix, keeping the query and fragment. */
+declare function unlocalizedPath(path: string, routes?: LocaleConfiguration): string;
+/** Resolves the configured language from a site path, including an optional default prefix. */
+declare function localeFromPath(path: string, routes?: LocaleConfiguration): string | undefined;
+/** Prefixes an unlocalized site path according to the CMS route policy. */
+declare function localePath(path: string, locale: string, routes?: LocaleConfiguration): string;
+/** Returns the configured URL form for a path that already identifies its language. */
+declare function canonicalLocalePath(path: string, routes?: LocaleConfiguration): string;
+/** Switches the language of a shared Document address. */
+declare function switchLocalePath(path: string, locale: string, routes?: LocaleConfiguration): string;
+//#endregion
+export { unlocalizedPath as a, switchLocalePath as i, localeFromPath as n, localePath as r, canonicalLocalePath as t };