riverbankcms 0.4.2 → 0.4.3

package/dist/{eventUpsertInputSchema-Dg60PKJI.mjs → eventUpsertInputSchema-7QFvBuxF.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { c as EVENT_PRESET_VALUES } from "./src-BRAF1Dee.mjs";
-import { a as classifySdkEventPricing, i as classifySdkEventSchedule, o as classifySdkEventPaymentTerms, r as sdkEventUpsertOptionalFieldSchemas } from "./sdk-event-upsert-C6zsxDcf.mjs";
+import { c as EVENT_PRESET_VALUES } from "./src-DKm0bLEA.mjs";
+import { a as classifySdkEventPricing, i as classifySdkEventSchedule, o as classifySdkEventPaymentTerms, r as sdkEventUpsertOptionalFieldSchemas } from "./sdk-event-upsert-Dy08IXYL.mjs";
 import { z } from "zod";
 
 //#region ../blocks/src/lib/typeGuards.ts
@@ -403,12 +403,6 @@ const ROUTE_METADATA_MANAGED_FIELDS_BY_TYPE = {
 		"draftStatus",
 		"scheduledPublishAt"
 	],
-	course: [
-		"draftTitle",
-		"draftSlug",
-		"draftStatus",
-		"scheduledPublishAt"
-	],
 	product: [
 		"draftTitle",
 		"draftSlug",
@@ -2082,40 +2076,6 @@ const EVENT_CONTENT_TYPE_SCHEMA = {
 		plural: "Events"
 	}
 };
-const COURSE_CONTENT_TYPE_SCHEMA = {
-	version: 1,
-	fields: [
-		{
-			id: "summary",
-			type: "textarea",
-			label: "Summary",
-			description: "Short teaser shown in listings.",
-			rows: 3
-		},
-		{
-			id: "image",
-			type: "media",
-			label: "Listing image",
-			description: "Optional image used for course cards and previews."
-		},
-		{
-			id: "body",
-			type: "richText",
-			label: "Details",
-			description: "Full course details and curriculum."
-		}
-	],
-	routing: {
-		enabled: true,
-		pattern: "/courses/{slug}",
-		slugField: "slug",
-		prefix: "/courses/"
-	},
-	labels: {
-		singular: "Course",
-		plural: "Courses"
-	}
-};
 const TEAM_MEMBER_CONTENT_TYPE_SCHEMA = {
 	version: 1,
 	fields: [
@@ -2324,7 +2284,6 @@ const PRODUCT_CATEGORY_CONTENT_TYPE_SCHEMA = {
 const BUILTIN_CONTENT_TYPE_SCHEMAS = {
 	post: POST_CONTENT_TYPE_SCHEMA,
 	event: EVENT_CONTENT_TYPE_SCHEMA,
-	course: COURSE_CONTENT_TYPE_SCHEMA,
 	"team-member": TEAM_MEMBER_CONTENT_TYPE_SCHEMA,
 	product: PRODUCT_CONTENT_TYPE_SCHEMA,
 	testimonial: TESTIMONIAL_CONTENT_TYPE_SCHEMA,
@@ -2345,7 +2304,6 @@ function deriveFieldIdSet(schema) {
 const BUILTIN_CONTENT_TYPE_FIELD_IDS = {
 	post: deriveFieldIdSet(BUILTIN_CONTENT_TYPE_SCHEMAS.post),
 	event: deriveFieldIdSet(BUILTIN_CONTENT_TYPE_SCHEMAS.event),
-	course: deriveFieldIdSet(BUILTIN_CONTENT_TYPE_SCHEMAS.course),
 	"team-member": deriveFieldIdSet(BUILTIN_CONTENT_TYPE_SCHEMAS["team-member"]),
 	product: deriveFieldIdSet(BUILTIN_CONTENT_TYPE_SCHEMAS.product),
 	testimonial: deriveFieldIdSet(BUILTIN_CONTENT_TYPE_SCHEMAS.testimonial),
@@ -2365,10 +2323,6 @@ const BUILTIN_PREVIEW_LINKED_ENTRY_EDITING = {
 		kind: "unsupported-domain-backed",
 		reason: DOMAIN_BACKED_LINKED_ENTRY_REASON
 	},
-	course: {
-		kind: "unsupported-domain-backed",
-		reason: DOMAIN_BACKED_LINKED_ENTRY_REASON
-	},
 	"team-member": { kind: "generic" },
 	product: {
 		kind: "unsupported-domain-backed",
@@ -3263,7 +3217,6 @@ function assertNever(value) {
 //#region ../content-model/src/templates/defaults.ts
 const POST_EXCERPT_FALLBACK = fallbackBinding(fieldBinding("excerpt"), transformBinding(TEMPLATE_BINDING_TRANSFORMS.RICHTEXT_FIRST_PARAGRAPH, { input: fieldBinding("body") }));
 const EVENT_SUBHEADLINE_FALLBACK = fallbackBinding(fieldBinding("summary"), transformBinding(TEMPLATE_BINDING_TRANSFORMS.RICHTEXT_FIRST_PARAGRAPH, { input: fieldBinding("body") }));
-const COURSE_SUMMARY_FALLBACK = fallbackBinding(fieldBinding("summary"), transformBinding(TEMPLATE_BINDING_TRANSFORMS.RICHTEXT_FIRST_PARAGRAPH, { input: fieldBinding("body") }));
 const ENTRY_TITLE_INLINE_TEXT = transformBinding(TEMPLATE_BINDING_TRANSFORMS.TEXT_INLINE_TEXT, { input: metaBinding("title") });
 const POST_BODY_TEXT_BINDINGS = {
 	body: fieldBinding("body"),
@@ -3366,6 +3319,7 @@ const DEFAULT_TEMPLATE_DEFINITIONS = {
 			{
 				blockKind: "block.body-text",
 				scope: "entry",
+				content: { body: createRichTextDoc([""]) },
 				bindings: EVENT_BODY_TEXT_BINDINGS
 			},
 			{
@@ -3385,7 +3339,6 @@ const DEFAULT_TEMPLATE_DEFINITIONS = {
 					showVenue: true,
 					showCapacity: true,
 					successMessage: "Thank you for registering! Check your email for confirmation details.",
-					waitlistMessage: "You've been added to the waitlist. We'll email you a claim link if a spot opens up.",
 					buttonText: "Complete Registration",
 					buttonVariant: "primary"
 				},
@@ -3396,64 +3349,6 @@ const DEFAULT_TEMPLATE_DEFINITIONS = {
 			}
 		]
 	},
-	course: {
-		templateKey: "default",
-		name: "Course detail",
-		description: "Standard landing page for multi-session courses.",
-		metadata: {},
-		blocks: [
-			{
-				blockKind: "block.hero",
-				scope: "entry",
-				bindings: {
-					eyebrow: literalBinding("Course"),
-					headline: metaBinding("title"),
-					headlineInline: ENTRY_TITLE_INLINE_TEXT,
-					subheadline: COURSE_SUMMARY_FALLBACK
-				}
-			},
-			{
-				blockKind: "block.course-details",
-				scope: "entry",
-				content: {
-					heading: "Course details",
-					showTitle: false,
-					showDescription: false,
-					showSessions: true,
-					sessionsLimit: "10",
-					showVenue: true,
-					showPrice: true,
-					showCapacity: true,
-					showEnrollmentStatus: true,
-					showMembershipNote: true
-				}
-			},
-			{
-				blockKind: SYSTEM_ENTRY_SLOT_BLOCK_KIND,
-				scope: "template",
-				content: {
-					slotKey: "main",
-					label: "Page content"
-				}
-			},
-			{
-				blockKind: "block.course-registration",
-				scope: "entry",
-				content: {
-					heading: "Enroll in this course",
-					showSessions: true,
-					showPrice: true,
-					showCapacity: true,
-					showVenue: true,
-					successMessage: "You're enrolled! Check your email for confirmation and session details.",
-					waitlistMessage: "You've been added to the waitlist. We'll email you a claim link if a spot opens up.",
-					membershipMessage: "Enrolled using your membership! Check your email for session details.",
-					buttonText: "Complete Enrollment",
-					buttonVariant: "primary"
-				}
-			}
-		]
-	},
 	"team-member": {
 		templateKey: "default",
 		name: "Team member profile",
@@ -3471,6 +3366,7 @@ const DEFAULT_TEMPLATE_DEFINITIONS = {
 		}, {
 			blockKind: "block.body-text",
 			scope: "entry",
+			content: { body: createRichTextDoc([""]) },
 			bindings: TEAM_MEMBER_BODY_TEXT_BINDINGS
 		}]
 	},

package/dist/load-config-FmixWCpv.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import "./sdk-peer-CeNepTFW.mjs";
+import { t as loadConfigFile } from "./load-config-lESIf8eO.mjs";
+
+export { loadConfigFile };

package/dist/{load-config-CCaUI4HN.mjs → load-config-lESIf8eO.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as assertCompatibleSdkPeer } from "./sdk-peer-C6kOODEY.mjs";
+import { n as assertCompatibleSdkPeer } from "./sdk-peer-CeNepTFW.mjs";
 import { dirname, resolve } from "path";
 import { createJiti } from "jiti";
 import { existsSync } from "fs";

package/dist/{plan-CaWqAqfn.mjs → plan-DPS1XAby.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { At as ok, kt as err, nt as parseSiteId } from "./src-BRAF1Dee.mjs";
+import { At as ok, kt as err, nt as parseSiteId } from "./src-DKm0bLEA.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, parse, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/scaffold/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "../src-BRAF1Dee.mjs";
-import { a as prepareScaffoldExecution, d as loadGeneratedPackageRanges, i as preflightScaffoldTargets, l as deriveGeneratedPackageRanges, o as writeScaffoldFiles, r as preflightScaffoldPlan, s as deriveScaffoldLocalManifest, t as deriveScaffoldPlan, u as findPackageManifestPath } from "../plan-CaWqAqfn.mjs";
+import "../src-DKm0bLEA.mjs";
+import { a as prepareScaffoldExecution, d as loadGeneratedPackageRanges, i as preflightScaffoldTargets, l as deriveGeneratedPackageRanges, o as writeScaffoldFiles, r as preflightScaffoldPlan, s as deriveScaffoldLocalManifest, t as deriveScaffoldPlan, u as findPackageManifestPath } from "../plan-DPS1XAby.mjs";
 
 export { deriveGeneratedPackageRanges, deriveScaffoldLocalManifest, deriveScaffoldPlan, findPackageManifestPath, loadGeneratedPackageRanges, preflightScaffoldPlan, preflightScaffoldTargets, prepareScaffoldExecution, writeScaffoldFiles };

package/dist/{sdk-event-upsert-C6zsxDcf.mjs → sdk-event-upsert-Dy08IXYL.mjs}

@@ -1,11 +1,75 @@
 #!/usr/bin/env node
-import { B as parseUtcIsoDateTimeString, W as parseBookingTimeZone } from "./src-BRAF1Dee.mjs";
+import { B as parseUtcIsoDateTimeString, W as parseBookingTimeZone } from "./src-DKm0bLEA.mjs";
 import { z } from "zod";
 
+//#region ../api/src/bookingPaymentTermSchemas.ts
+const bookingDepositRefundPolicySchema = z.enum(["refundable", "non_refundable"]);
+const bookingInstalmentPlanSchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("deposit_plus_one_remainder"),
+		depositAmountCents: z.number().int().nonnegative(),
+		depositRefundability: bookingDepositRefundPolicySchema,
+		remainderDueCount: z.number().int().positive(),
+		intervalUnit: z.enum([
+			"day",
+			"week",
+			"month"
+		])
+	}),
+	z.object({
+		kind: z.literal("deposit_plus_scheduled_instalments"),
+		depositAmountCents: z.number().int().nonnegative(),
+		depositRefundability: bookingDepositRefundPolicySchema,
+		instalmentCount: z.number().int().positive(),
+		intervalCount: z.number().int().positive(),
+		intervalUnit: z.enum([
+			"day",
+			"week",
+			"month"
+		])
+	}),
+	z.object({
+		kind: z.literal("equal_scheduled_instalments"),
+		instalmentCount: z.number().int().positive(),
+		intervalCount: z.number().int().positive(),
+		intervalUnit: z.enum([
+			"day",
+			"week",
+			"month"
+		])
+	})
+]);
+const bookingFlexibleBalanceDueDateRuleSchema = z.discriminatedUnion("kind", [z.object({
+	kind: z.literal("relative_to_start_date"),
+	daysBeforeStart: z.number().int().positive()
+}), z.object({
+	kind: z.literal("fixed_calendar_date"),
+	dueAt: z.string().datetime()
+})]);
+const bookingFlexibleBalanceConfigSchema = z.object({
+	upfrontAmountCents: z.number().int().nonnegative(),
+	dueDateRule: bookingFlexibleBalanceDueDateRuleSchema,
+	depositRefundability: bookingDepositRefundPolicySchema
+});
+const bookingPaymentCollectionOptionSchema = z.discriminatedUnion("kind", [
+	z.object({ kind: z.literal("upfront") }),
+	z.object({ kind: z.literal("deferred_manual") }),
+	z.object({
+		kind: z.literal("instalment_plan"),
+		plan: bookingInstalmentPlanSchema
+	}),
+	z.object({
+		kind: z.literal("flexible_balance"),
+		config: bookingFlexibleBalanceConfigSchema
+	})
+]);
+
+//#endregion
 //#region ../api/src/sdk-event-payment-terms.ts
 const supportedKinds = new Set([
 	"upfront",
 	"deferred_manual",
+	"instalment_plan",
 	"flexible_balance"
 ]);
 function issue$2(path, message) {
@@ -26,6 +90,13 @@ function isPositiveWholeNumber(value) {
 function isDepositRefundability(value) {
 	return value === "refundable" || value === "non_refundable";
 }
+function validateInstalmentPlan(raw, path) {
+	if (!isRecord$1(raw)) {
+		return [issue$2(path, "Instalment plan must be an object")];
+	}
+	const parsed = bookingInstalmentPlanSchema.safeParse(raw);
+	return parsed.success ? parsed.data : parsed.error.issues.map((problem) => issue$2([...path, ...problem.path.map(String)], `Invalid instalment plan: ${problem.message}`));
+}
 function isSupportedOptionKind(value) {
 	return typeof value === "string" && supportedKinds.has(value);
 }
@@ -90,15 +161,19 @@ function validateCollectionOption(raw, index) {
 	if (!isRecord$1(raw)) {
 		return [issue$2(path, "Payment option must be an object")];
 	}
-	if (raw.kind === "instalment_plan") {
-		return [issue$2([...path, "kind"], "Event instalment plans are not supported yet. Use upfront, deferred_manual, or flexible_balance.")];
-	}
 	if (!isSupportedOptionKind(raw.kind)) {
-		return [issue$2([...path, "kind"], "Payment option kind must be upfront, deferred_manual, or flexible_balance")];
+		return [issue$2([...path, "kind"], "Payment option kind must be upfront, deferred_manual, instalment_plan, or flexible_balance")];
 	}
 	switch (raw.kind) {
 		case "upfront":
 		case "deferred_manual": return { kind: raw.kind };
+		case "instalment_plan": {
+			const plan = validateInstalmentPlan(raw.plan, [...path, "plan"]);
+			return Array.isArray(plan) ? plan : {
+				kind: "instalment_plan",
+				plan
+			};
+		}
 		case "flexible_balance": {
 			const config = validateFlexibleBalanceConfig(raw.config, [...path, "config"]);
 			if (Array.isArray(config)) {
@@ -127,8 +202,8 @@ function optionCombinationIssues(options) {
 	if (options.length > 2) {
 		issues.push(issue$2(["allowedOptions"], "Event payment terms can offer one option, or a choice between upfront and one alternative option"));
 	}
-	if (options.length === 2 && (!seenKinds.has("upfront") || !seenKinds.has("deferred_manual") && !seenKinds.has("flexible_balance"))) {
-		issues.push(issue$2(["allowedOptions"], "Event payment terms with two options must combine upfront with deferred_manual or flexible_balance"));
+	if (options.length === 2 && (!seenKinds.has("upfront") || !seenKinds.has("deferred_manual") && !seenKinds.has("instalment_plan") && !seenKinds.has("flexible_balance"))) {
+		issues.push(issue$2(["allowedOptions"], "Event payment terms with two options must combine upfront with one alternative option"));
 	}
 	return issues;
 }

package/dist/{sdk-peer-C6kOODEY.mjs → sdk-peer-CeNepTFW.mjs}

@@ -3,7 +3,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, parse } from "node:path";
 
 //#region package.json
-var version = "0.4.2";
+var version = "0.4.3";
 var peerDependencies = { "@riverbankcms/sdk": ">=0.130.0 <1.0.0" };
 var package_default = {
 	name: "riverbankcms",
@@ -79,7 +79,7 @@ var package_default = {
 //#endregion
 //#region src/version.ts
 /** The package manifest is the source-run fallback; builds inject this value. */
-const CLI_VERSION = typeof "0.4.2" === "string" ? "0.4.2" : version;
+const CLI_VERSION = typeof "0.4.3" === "string" ? "0.4.3" : version;
 /**
 * The CLI's SDK peer range is bundled from the CLI manifest alongside its
 * version. Runtime config loading uses this value as the single compatibility

package/dist/{src-BRAF1Dee.mjs → src-DKm0bLEA.mjs}

@@ -53,6 +53,7 @@ const unsafeAsEventOfferingId = (id) => id;
 const unsafeAsEventSeriesId = (id) => id;
 const unsafeAsEventPageRouteSlug = (value) => value;
 const unsafeAsTicketTypeId = (id) => id;
+const unsafeAsEventSeriesRegistrationId = (id) => id;
 const unsafeAsEventCategoryId = (id) => id;
 const unsafeAsVenueId = (id) => id;
 const unsafeAsPricingOptionId = (id) => id;
@@ -104,7 +105,6 @@ const unsafeAsCheckoutLineId = (id) => id;
 const unsafeAsAttendeeId = (id) => id;
 const unsafeAsCustomerPassId = (id) => id;
 const unsafeAsCustomerMembershipId = (id) => id;
-const unsafeAsEnrollmentId = (id) => id;
 const unsafeAsAppointmentId = (id) => id;
 const unsafeAsAppointmentServiceId = (id) => id;
 const unsafeAsAppointmentResourceId = (id) => id;
@@ -194,7 +194,7 @@ const parseCustomerId = (value) => parseUuidBrand(value, unsafeAsCustomerId);
 const parseCustomerPassId = (value) => parseUuidBrand(value, unsafeAsCustomerPassId);
 const parseCustomerMembershipId = (value) => parseUuidBrand(value, unsafeAsCustomerMembershipId);
 const parseEventSeriesId = (value) => parseUuidBrand(value, unsafeAsEventSeriesId);
-const parseEnrollmentId = (value) => parseUuidBrand(value, unsafeAsEnrollmentId);
+const parseEventSeriesRegistrationId = (value) => parseUuidBrand(value, unsafeAsEventSeriesRegistrationId);
 const parseParticipantId = (value) => parseUuidBrand(value, unsafeAsParticipantId);
 const parseParticipantParticipationId = (value) => parseUuidBrand(value, unsafeAsParticipantParticipationId);
 const parseOrderItemId = (value) => parseUuidBrand(value, unsafeAsOrderItemId);
@@ -558,7 +558,7 @@ function publicEventPricingType(pricing) {
 		case "single_paid":
 		case "ticket_types":
 		case "sliding_scale":
-		case "course": return isFreePublicEventPriceDisplay(pricing.display) ? "free" : "paid";
+		case "whole_series": return isFreePublicEventPriceDisplay(pricing.display) ? "free" : "paid";
 		case "external": return "external";
 	}
 }
@@ -569,7 +569,7 @@ function publicEventPricingCurrency(pricing) {
 		case "single_paid":
 		case "ticket_types":
 		case "sliding_scale": return pricing.currency;
-		case "course": return pricing.display.display.currency;
+		case "whole_series": return pricing.display.display.currency;
 		case "external": return null;
 	}
 }
@@ -583,7 +583,7 @@ function publicEventPricingMode(pricing) {
 		case "ticket_types": return "ticket_types";
 		case "sliding_scale": return "sliding_scale";
 		case "drop_in":
-		case "course":
+		case "whole_series":
 		case "external": return undefined;
 	}
 }
@@ -593,7 +593,7 @@ function publicEventTicketTypes(pricing) {
 function isFreePublicEventPriceDisplay(display) {
 	switch (display.kind) {
 		case "free": return true;
-		case "course": return display.display.kind === "free";
+		case "whole_series": return display.display.kind === "free";
 		case "exact":
 		case "from":
 		case "range":
@@ -629,7 +629,7 @@ function formatBookingPriceDisplay(display, options = {}) {
 		case "mixed": return display.paidToAmount > display.paidFromAmount ? `Free / ${formatCurrencyAmount(display.paidFromAmount, display.currency, options)} - ${formatCurrencyAmount(display.paidToAmount, display.currency, options)}` : `Free / ${formatCurrencyAmount(display.paidFromAmount, display.currency, options)}`;
 		case "unavailable": return "Pricing unavailable";
 		case "external": return display.label;
-		case "course": return formatCoursePriceDisplayLabel(display.display, options);
+		case "whole_series": return formatCoursePriceDisplayLabel(display.display, options);
 		default: return assertNever(display);
 	}
 }
@@ -1628,7 +1628,7 @@ const RECTIFICATION_SURFACES = [
 	"customer_profile",
 	"booking_identity",
 	"event_registration_identity",
-	"course_enrollment_identity",
+	"event_series_registration_identity",
 	"person_record_entry",
 	"booking_question_snapshot",
 	"form_submission",
@@ -2141,13 +2141,13 @@ function projectAppointmentParticipantSlot(input) {
 		}
 	});
 }
-function projectCourseEnrollmentParticipantSlot(input) {
+function projectEventSeriesRegistrationParticipantSlot(input) {
 	return buildSlot({
-		slotKey: unsafeAsParticipantSlotKey(`course_enrollment:${input.enrollmentId}`),
+		slotKey: unsafeAsParticipantSlotKey(`event_series_registration:${input.registrationId}`),
 		contact: input.customer,
 		participation: {
-			kind: "course_enrollment",
-			enrollmentId: input.enrollmentId
+			kind: "event_series_registration",
+			registrationId: input.registrationId
 		}
 	});
 }
@@ -2187,20 +2187,20 @@ function projectSingleSubjectParticipantSlot(input) {
 			appointmentId: input.target.appointmentId,
 			customer: input.customer
 		});
-		case "course_enrollment": return projectCourseEnrollmentParticipantSlot({
-			enrollmentId: input.target.enrollmentId,
+		case "event_series_registration": return projectEventSeriesRegistrationParticipantSlot({
+			registrationId: input.target.registrationId,
 			customer: input.customer
 		});
 		default: return assertNever$1(input.target);
 	}
 }
-function projectCourseSessionAttendanceParticipantSlot(input) {
+function projectEventSeriesSessionAttendanceParticipantSlot(input) {
 	return {
-		slotKey: unsafeAsParticipantSlotKey(`course_session_attendance:${input.attendeeId}`),
+		slotKey: unsafeAsParticipantSlotKey(`event_series_session_attendance:${input.attendeeId}`),
 		participation: {
-			kind: "course_session_attendance",
+			kind: "event_series_session_attendance",
 			attendeeId: input.attendeeId,
-			enrollmentId: input.enrollmentId
+			registrationId: input.registrationId
 		}
 	};
 }
@@ -4401,19 +4401,35 @@ function maskEmail(email) {
 
 //#endregion
 //#region ../core/src/slug.ts
+const REMOVED_CHARACTERS = /['\u2019]/g;
+const COMBINING_DIACRITICS = /[\u0300-\u036f]/g;
+const SEPARATOR_RUN = /[^a-z0-9]+/g;
+const TRAILING_SLUG_SEPARATORS = /[-/]+$/g;
+function slugifySegment(text) {
+	return text.normalize("NFD").replace(COMBINING_DIACRITICS, "").toLowerCase().replace(REMOVED_CHARACTERS, "").replace(SEPARATOR_RUN, "-").replace(/^-+|-+$/g, "");
+}
 /**
-* Convert a string to a URL-safe slug
+* Convert a string to a URL-safe slug.
 *
-* @param text - The text to slugify
-* @returns URL-safe slug (lowercase, alphanumeric + hyphens)
+* Every non-alphanumeric character (underscores included) is a separator and
+* collapses to a single hyphen, which keeps output inside the `site_routes`
+* slug constraint `^[a-z0-9]+([a-z0-9\-/]*[a-z0-9])?$`.
+*
+* This is the single slug implementation for the monorepo: block-form and the
+* shop admin catalog delegate here rather than keeping their own variants.
 *
 * @example
 * slugify("Initial Consultation") // "initial-consultation"
-* slugify("90-Minute Deep Tissue") // "90-minute-deep-tissue"
 * slugify("Reiki & Energy Healing") // "reiki-energy-healing"
+* slugify("Don't Stop") // "dont-stop"
+* slugify("draft_post") // "draft-post"
+* slugify("Blog / My Post", { preserveSegments: true }) // "blog/my-post"
 */
-function slugify(text) {
-	return text.toString().toLowerCase().trim().replace(/\s+/g, "-").replace(/[^\w\-]+/g, "").replace(/\-\-+/g, "-").replace(/^-+/, "").replace(/-+$/, "");
+function slugify(text, options = {}) {
+	const source = text.toString().trim();
+	const slug = options.preserveSegments === true ? source.split("/").map(slugifySegment).filter((segment) => segment.length > 0).join("/") : slugifySegment(source);
+	if (options.maxLength === undefined) return slug;
+	return slug.slice(0, options.maxLength).replace(TRAILING_SLUG_SEPARATORS, "");
 }
 /**
 * Generate a unique slug by appending a number if needed