@prenta/admin 1.17.1 → 1.17.3

package/src/components/ui/Input.tsx

@@ -1,7 +1,11 @@
-import { forwardRef, type InputHTMLAttributes } from 'react'
-import { cv, type VariantProps } from '../../lib/cv.js'
+import { cv } from '../../lib/cv.js'
 import { formControlBase, formControlState } from './form-control.js'
 
+/**
+ * Input class-variance recipe shared by the header search and `SearchInput`.
+ * Consumers render their own `<input>` with `inputVariants({ size, state })`;
+ * there is no wrapper component.
+ */
 const input = cv(formControlBase, {
   variants: {
     size: {
@@ -18,16 +22,4 @@ const input = cv(formControlBase, {
   defaultVariants: { size: 'md', state: 'default' },
 })
 
-export type InputVariants = VariantProps<typeof input>
-
-export interface InputProps
-  extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>, InputVariants {}
-
-export const Input = forwardRef<HTMLInputElement, InputProps>(function Input(
-  { size, state, className, ...rest },
-  ref,
-) {
-  return <input ref={ref} className={input({ size, state, class: className })} {...rest} />
-})
-
-export { input as inputVariants, formControlBase, formControlState }
+export { input as inputVariants }

package/src/components/ui/Modal.tsx

@@ -12,7 +12,7 @@ const MODAL_SIZE_CLASS = {
   xl: 'flex max-h-[min(92vh,880px)] max-w-5xl flex-col',
 } as const
 
-export type ModalSize = keyof typeof MODAL_SIZE_CLASS
+type ModalSize = keyof typeof MODAL_SIZE_CLASS
 
 export interface ModalProps {
   open: boolean

package/src/components/ui/ResizableAside.tsx

@@ -17,11 +17,11 @@ import { Maximize2, Minimize2 } from 'lucide-react'
 export const SECTION_INSPECTOR_WIDTH_KEY = 'prenta:section-inspector-width'
 export const SECTION_INSPECTOR_DEFAULT_WIDTH = 320
 export const SECTION_INSPECTOR_MIN_WIDTH = 280
-export const SECTION_INSPECTOR_MAX_WIDTH = 640
-export const SECTION_INSPECTOR_MIN_CANVAS_WIDTH = 96
+const SECTION_INSPECTOR_MAX_WIDTH = 640
+const SECTION_INSPECTOR_MIN_CANVAS_WIDTH = 96
 /** Below this editor-row width the expand action uses an overlay panel. */
-export const SECTION_INSPECTOR_OVERLAY_BREAKPOINT = 768
-export const SECTION_INSPECTOR_OVERLAY_MAX_WIDTH = 480
+const SECTION_INSPECTOR_OVERLAY_BREAKPOINT = 768
+const SECTION_INSPECTOR_OVERLAY_MAX_WIDTH = 480
 
 function clampWidth(width: number, max = SECTION_INSPECTOR_MAX_WIDTH): number {
   return Math.min(max, Math.max(SECTION_INSPECTOR_MIN_WIDTH, width))
@@ -81,7 +81,7 @@ interface InspectorResizeContextValue {
 
 const InspectorResizeContext = createContext<InspectorResizeContextValue | null>(null)
 
-export function useInspectorResize(): InspectorResizeContextValue | null {
+function useInspectorResize(): InspectorResizeContextValue | null {
   return useContext(InspectorResizeContext)
 }
 

package/src/components/ui/StatusBadge.tsx

@@ -40,7 +40,7 @@ const DOT_CLASS: Record<NonNullable<StatusBadgeVariants['tone']>, string> = {
   muted: 'bg-[var(--muted)]',
 }
 
-export type StatusBadgeVariants = VariantProps<typeof statusBadge>
+type StatusBadgeVariants = VariantProps<typeof statusBadge>
 export type StatusBadgeTone = NonNullable<StatusBadgeVariants['tone']>
 
 export interface StatusBadgeProps extends HTMLAttributes<HTMLSpanElement>, StatusBadgeVariants {
@@ -62,5 +62,3 @@ export function StatusBadge({ tone, dot = true, className, children, ...rest }:
     </span>
   )
 }
-
-export { statusBadge as statusBadgeVariants }

package/src/components/ui/Toggle.tsx

@@ -40,7 +40,7 @@ const toggleThumb = cv(
   },
 )
 
-export type ToggleVariants = VariantProps<typeof toggleTrack>
+type ToggleVariants = VariantProps<typeof toggleTrack>
 
 export interface ToggleProps extends ToggleVariants {
   checked: boolean
@@ -82,5 +82,3 @@ export function Toggle({
     </Switch.Root>
   )
 }
-
-export { toggleTrack as toggleTrackVariants, toggleThumb as toggleThumbVariants }

package/src/fields/FieldRenderer.tsx

@@ -15,7 +15,7 @@ import { NavBuilderField } from './NavBuilderField.js'
 import { NumberField } from './NumberField.js'
 import { ComponentBlockField } from './ComponentBlockField.js'
 
-export interface FieldDefinition {
+interface FieldDefinition {
   name: string
   type: string
   label: string

package/src/fields/index.ts

@@ -1,20 +1,3 @@
-export { FieldRenderer } from './FieldRenderer.js'
-export type { FieldRendererProps, FieldDefinition } from './FieldRenderer.js'
-export { TextField } from './TextField.js'
-export { RichTextField } from './RichTextField.js'
-export { SlugField } from './SlugField.js'
-export { SelectField } from './SelectField.js'
-export { MediaField } from './MediaField.js'
-export { RelationshipField } from './RelationshipField.js'
-export { DateField } from './DateField.js'
-export { ToggleField } from './ToggleField.js'
-export { ArrayField } from './ArrayField.js'
-export { BlockBuilderField } from './BlockBuilderField.js'
-export { PRESET_BLOCKS } from './block-types.js'
-export type { BlockTypeDefinition } from './block-types.js'
-export { GroupField } from './GroupField.js'
-export { NavBuilderField } from './NavBuilderField.js'
-export { NumberField } from './NumberField.js'
 export { ComponentBlockField } from './ComponentBlockField.js'
 export type { ComponentBlockFieldProps, ComponentBlockValue } from './ComponentBlockField.js'
 export { PropInput, defaultForType } from './PropInput.js'

package/src/layout/primitives/tokens.ts

@@ -74,10 +74,3 @@ export const tokens = {
     '2xl': 1536,
   } as const,
 }
-
-/** Map a space token to the corresponding Tailwind `space-y-*` / `gap-*` value. */
-export function spaceToTw(t: SpaceToken): string {
-  // Tailwind's spacing utility already accepts the same scale, so we map
-  // 1:1. Centralizing here means callers don't repeat the string literal.
-  return t
-}

package/src/lib/brand-voice-client.ts

@@ -1,7 +1,16 @@
 import type { BrandAlignmentScoreResult } from '@prenta/core/brand-voice'
 import { cmsApi } from './api.js'
 
-export type { BrandAlignmentScoreResult }
+/**
+ * Present only when an AI rewrite was wanted (`useAi`, remaining issues) but
+ * the governed runtime refused — `code` is the runtime refusal code and `hint`
+ * the operator-facing next step for the 503 "not configured" cases.
+ */
+interface BrandVoiceFixAiUnavailable {
+  code: string
+  message: string
+  hint?: string
+}
 
 export interface BrandVoiceFixResult {
   text: string
@@ -9,6 +18,14 @@ export interface BrandVoiceFixResult {
   beforeScore: BrandAlignmentScoreResult
   afterScore: BrandAlignmentScoreResult
   usedAi: boolean
+  aiUnavailable?: BrandVoiceFixAiUnavailable
+}
+
+/** Toast copy for a fix that fell back to rule-only edits because AI refused. */
+export function brandVoiceFixAiNotice(result: BrandVoiceFixResult): string | null {
+  if (result.usedAi || !result.aiUnavailable) return null
+  const { message, hint } = result.aiUnavailable
+  return hint ? `${message} ${hint}` : message
 }
 
 export async function fixBrandVoiceContent(input: {

package/src/lib/coauthor-client.ts

@@ -64,7 +64,7 @@ export interface CoauthorOptions {
   targetLength?: number
 }
 
-export interface CoauthorResult {
+interface CoauthorResult {
   action: CoauthorAction
   text: string
   /** Populated only when `action === 'proofread'`. */

package/src/lib/collection-schema.ts

@@ -19,7 +19,7 @@ interface CollectionLike {
 }
 
 /** Look up a collection by slug; `collections` may be a record or an array. */
-export function findCollection(config: unknown, slug: string): CollectionLike | null {
+function findCollection(config: unknown, slug: string): CollectionLike | null {
   const collections = (config as { collections?: unknown } | null | undefined)?.collections
   if (!collections) return null
   if (Array.isArray(collections)) {
@@ -32,7 +32,7 @@ export function findCollection(config: unknown, slug: string): CollectionLike |
 }
 
 /** Field definitions may be a record (keyed by name) or an array of `{ name }`. */
-export function declaredFieldNames(fields: unknown): Set<string> | null {
+function declaredFieldNames(fields: unknown): Set<string> | null {
   if (!fields) return null
   if (Array.isArray(fields)) {
     return new Set(

package/src/lib/editor-seo-content.ts

@@ -3,7 +3,6 @@ import {
   isSectionEffectivelyVisible,
   type PageSection,
 } from '@prenta/core/page-sections'
-import { analyzeContent } from '@prenta/core/seo/analysis'
 
 const HTML_LIKE = /<\/?[a-z][\s\S]*>/i
 
@@ -19,27 +18,6 @@ export function buildEditorContentHtml(sections: PageSection[], body = ''): stri
   return parts.join('\n')
 }
 
-/** Live 0–100 SEO score from the current in-editor document state. */
-export function computeLiveSeoScore(input: {
-  title: string
-  slug: string
-  seoTitle: string
-  seoDescription: string
-  focusKeyword?: string
-  sections: PageSection[]
-  bodyHtml?: string
-}): number {
-  const content = buildEditorContentHtml(input.sections, input.bodyHtml ?? '')
-  return analyzeContent({
-    title: input.title,
-    slug: input.slug,
-    content,
-    metaTitle: input.seoTitle,
-    metaDescription: input.seoDescription,
-    focusKeyphrase: input.focusKeyword,
-  }).score
-}
-
 function extractSectionContentHtml(section: PageSection): string {
   const content = section.content
   if (!content || typeof content !== 'object') return ''

package/src/lib/forms-service.ts

@@ -34,21 +34,16 @@ export type {
   FormSchemaVersion,
   FormField,
   FormFieldType,
-  FormFieldOption,
-  FieldValidationRules,
   FormAnalyticsConfig,
   FormNotificationSettings,
   FormEmbedSettings,
   FormWebhookConfig,
-  FormWebhookEvent,
   FormStatus,
   FormStats,
   FormsSidebarCount,
   FormSubmission,
-  FormSubmissionFile,
   FetchFormEntriesParams,
   EntryCounts,
-  SpamStatus,
 } from '@prenta/core'
 
 /**
@@ -170,34 +165,6 @@ export async function updateForm(
   return { data: res.data, error: res.error }
 }
 
-export async function duplicateForm(
-  id: string,
-): Promise<{ data?: FormDefinition; error?: string }> {
-  const res = await cmsApi<FormDefinition>(`/forms/${encodeURIComponent(id)}/duplicate`, {
-    method: 'POST',
-  })
-  return { data: res.data, error: res.error }
-}
-
-/** Move a form to the archived state (hidden from embed pickers, no new submissions). */
-export async function archiveForm(id: string): Promise<{ error?: string }> {
-  return updateForm(id, { status: 'archived' })
-}
-
-/** Restore an archived form back to draft. */
-export async function restoreForm(id: string): Promise<{ error?: string }> {
-  return updateForm(id, { status: 'draft' })
-}
-
-export async function deleteForm(
-  id: string,
-  opts: { force?: boolean } = {},
-): Promise<{ error?: string }> {
-  const qs = opts.force ? '?force=true' : ''
-  const res = await cmsApi(`/forms/${encodeURIComponent(id)}${qs}`, { method: 'DELETE' })
-  return { error: res.error }
-}
-
 // ─── Schema ──────────────────────────────────────────────────────────────
 
 export async function fetchFormSchema(id: string): Promise<FormSchemaResult> {
@@ -496,8 +463,8 @@ export async function downloadEntriesExport(
 
 // ─── Delivery attempts (#675) ─────────────────────────────────────────────
 
-export type FormDeliveryChannel = 'email_notify' | 'email_autoresponder' | 'form_webhook'
-export type FormDeliveryStatus = 'pending' | 'retrying' | 'success' | 'failed' | 'skipped'
+type FormDeliveryChannel = 'email_notify' | 'email_autoresponder' | 'form_webhook'
+type FormDeliveryStatus = 'pending' | 'retrying' | 'success' | 'failed' | 'skipped'
 
 export interface FormDeliveryAttempt {
   id: string
@@ -560,10 +527,3 @@ export async function retryFormDelivery(
   )
   return { data: res.data, error: res.error }
 }
-
-export async function fetchFailedDeliveryCount(formId?: string): Promise<number> {
-  const qs = formId ? `?formId=${encodeURIComponent(formId)}` : ''
-  const res = await cmsApi<{ count: number }>(`/forms/deliveries/failed-count${qs}`)
-  throwIfError(res)
-  return res.data?.count ?? 0
-}

package/src/lib/notifications-client.ts

@@ -15,21 +15,21 @@ import { cmsApi, getApiBase } from './api.js'
 
 export type NotificationKind = 'comment_reply' | 'comment_resolved' | 'comment_mention'
 
-export interface CommentReplyPayload {
+interface CommentReplyPayload {
   kind: 'comment_reply'
   actorId: string | null
   actorName: string | null
   excerpt: string
 }
 
-export interface CommentResolvedPayload {
+interface CommentResolvedPayload {
   kind: 'comment_resolved'
   actorId: string | null
   actorName: string | null
   rootExcerpt: string
 }
 
-export interface CommentMentionPayload {
+interface CommentMentionPayload {
   kind: 'comment_mention'
   actorId: string | null
   actorName: string | null

package/src/lib/page-audit-input.ts

@@ -78,7 +78,7 @@ function stripHtml(html: string): string {
  * when one is set — otherwise `imageSlots` would count an empty media field
  * and fail alt-text for an image that is not on the page.
  */
-export function withPostAuditSlots(sections: PageSection[], post?: PostAuditExtras): PageSection[] {
+function withPostAuditSlots(sections: PageSection[], post?: PostAuditExtras): PageSection[] {
   if (!post) return sections
 
   const extras: PageSection[] = []

package/src/lib/page-editor-service.ts

@@ -27,7 +27,6 @@ import {
   moveSection,
   reorderSections,
   updateSectionContent,
-  updateSectionContentAtPath,
   updateSectionSettings,
   updateSectionMeta,
   coerceSections as coerceSectionsCore,
@@ -55,7 +54,6 @@ export {
   moveSection,
   reorderSections,
   updateSectionContent,
-  updateSectionContentAtPath,
   updateSectionSettings,
   updateSectionMeta,
 }
@@ -278,7 +276,7 @@ function toWriteBody(page: EditorPage, extra?: Record<string, unknown>): string
 }
 
 /** Create a new page document, returning the new id. */
-export async function createPage(page: EditorPage): Promise<EditorPage> {
+async function createPage(page: EditorPage): Promise<EditorPage> {
   const res = await cmsApi<DocumentApiRow>(`/collections/${PAGES_COLLECTION}`, {
     method: 'POST',
     body: toWriteBody(page),

package/src/lib/pages-service.ts

@@ -30,8 +30,8 @@ import { cmsApi } from './api.js'
 
 export type PageStatus = 'DRAFT' | 'PUBLISHED' | 'SCHEDULED' | 'ARCHIVED'
 
-export const PAGES_COLLECTION = 'pages'
-export const PAGE_TAGS_COLLECTION = 'page-tags'
+const PAGES_COLLECTION = 'pages'
+const PAGE_TAGS_COLLECTION = 'page-tags'
 
 export interface PageTag {
   id: string // == slug (stable join key; pages store slugs in data.tags)
@@ -47,7 +47,7 @@ export interface PageTag {
   updatedAt: string | null
 }
 
-export interface PageAuthor {
+interface PageAuthor {
   id: string
   name: string
   initials: string
@@ -222,22 +222,6 @@ async function fetchTagDocs(): Promise<DocumentApiRow[]> {
   return (res.data?.docs ?? []) as DocumentApiRow[]
 }
 
-/**
- * Fetch all tags. `pageCounts` (slug → count) is optional so the tag
- * manager / pickers can render before page data is loaded.
- */
-export async function fetchPageTags(pageCounts?: Map<string, number>): Promise<PageTag[]> {
-  const docs = await fetchTagDocs()
-  const tags = docs.map((d) => docToTag(d, pageCounts?.get(d.slug ?? d.id) ?? 0))
-  tags.sort((a, b) => a.sortOrder - b.sortOrder || a.name.localeCompare(b.name))
-  return tags
-}
-
-export async function fetchAuthors(): Promise<PageAuthor[]> {
-  const map = await fetchAuthorsMap()
-  return [...map.values()].sort((a, b) => a.name.localeCompare(b.name))
-}
-
 // ─── Pages ───────────────────────────────────────────────────────────
 
 function docToPage(d: DocumentApiRow, authors: Map<string, PageAuthor>): Page {
@@ -439,15 +423,6 @@ export async function fetchPages(query: PagesQuery = {}): Promise<PagesResult> {
   }
 }
 
-export async function fetchPageById(pageId: string): Promise<Page | null> {
-  const res = await cmsApi<DocumentApiRow>(
-    `/collections/${PAGES_COLLECTION}/${encodeURIComponent(pageId)}`,
-  )
-  if (res.error || !res.data) return null
-  const authors = await fetchAuthorsMap()
-  return docToPage(res.data, authors)
-}
-
 // ─── Bulk page mutations ─────────────────────────────────────────────
 
 export interface BulkResult {
@@ -621,7 +596,7 @@ export async function updatePageTag(
   return res.error ? { error: res.error } : {}
 }
 
-export async function deletePageTag(tagDocId: string): Promise<{ error?: string }> {
+async function deletePageTag(tagDocId: string): Promise<{ error?: string }> {
   const res = await cmsApi(`/collections/${PAGE_TAGS_COLLECTION}/${encodeURIComponent(tagDocId)}`, {
     method: 'DELETE',
   })

package/src/lib/plan.ts

@@ -1,6 +1,6 @@
 import { cmsApi } from './api.js'
 
-export type PlanTier = 'starter' | 'pro' | 'enterprise'
+type PlanTier = 'starter' | 'pro' | 'enterprise'
 
 export type PlanFeature =
   | 'seo.inlineApply'

package/src/lib/post-editor-service.ts

@@ -30,10 +30,8 @@ import {
   removeSection,
   duplicateSection,
   toggleSectionVisibility,
-  moveSection,
   reorderSections,
   updateSectionContent,
-  updateSectionContentAtPath,
   updateSectionSettings,
   updateSectionMeta,
   coerceSections,
@@ -56,17 +54,13 @@ export {
   removeSection,
   duplicateSection,
   toggleSectionVisibility,
-  moveSection,
   reorderSections,
   updateSectionContent,
-  updateSectionContentAtPath,
   updateSectionSettings,
   updateSectionMeta,
 }
 
-export type PostStatus = 'DRAFT' | 'PUBLISHED' | 'SCHEDULED' | 'ARCHIVED'
-
-export const TEMPLATES_COLLECTION = 'post-templates'
+type PostStatus = 'DRAFT' | 'PUBLISHED' | 'SCHEDULED' | 'ARCHIVED'
 
 export interface EditorPost {
   id: string | null
@@ -230,7 +224,7 @@ export interface FeaturedImageRef {
 }
 
 /** True for paths and http(s) URLs — never a bare media cuid. */
-export function isDisplayableImageSrc(value: string): boolean {
+function isDisplayableImageSrc(value: string): boolean {
   const v = value.trim()
   return v.startsWith('/') || /^https?:\/\//i.test(v)
 }
@@ -272,7 +266,7 @@ export function parseFeaturedImage(raw: unknown): string {
  * `[{ tag: 'AI' }]` rows; older/hand-rolled configs may store `['AI']`
  * directly — accept both so no site loses tags in the editor.
  */
-export function parseTags(raw: unknown): string[] {
+function parseTags(raw: unknown): string[] {
   if (!Array.isArray(raw)) return []
   const out: string[] = []
   for (const item of raw) {
@@ -435,7 +429,7 @@ function toWriteBody(post: EditorPost, extra?: Record<string, unknown>): string
   return JSON.stringify(payload)
 }
 
-export async function createPost(post: EditorPost): Promise<EditorPost> {
+async function createPost(post: EditorPost): Promise<EditorPost> {
   const res = await cmsApi<DocumentApiRow>(`/collections/${encodeURIComponent(post.postType)}`, {
     method: 'POST',
     body: toWriteBody(post),

package/src/lib/post-types-service.ts

@@ -6,7 +6,7 @@ import { cmsApi } from './api.js'
  * schemas are file-defined in `prenta.config.ts`, so the Post Type editor
  * inspects the live schema and generates config snippets for changes.
  */
-export interface PostTypeFieldSummary {
+interface PostTypeFieldSummary {
   name: string
   type: string
   required: boolean
@@ -57,7 +57,7 @@ export async function fetchPostTypeDetail(slug: string): Promise<PostTypeDetail
 }
 
 /** Friendly display names for cms-core field types (design's type badges). */
-export const FIELD_TYPE_LABELS: Record<string, string> = {
+const FIELD_TYPE_LABELS: Record<string, string> = {
   text: 'Short Text',
   richText: 'Rich Text',
   number: 'Number',

package/src/lib/posts-service.ts

@@ -13,6 +13,7 @@
  * collections the caller's scope can read.
  */
 import { cmsApi } from './api.js'
+import { publicPathFor } from './public-path.js'
 
 export type PostStatus = 'DRAFT' | 'PUBLISHED' | 'SCHEDULED' | 'ARCHIVED'
 
@@ -30,7 +31,7 @@ export interface PostType {
   active: boolean
 }
 
-export interface PostAuthor {
+interface PostAuthor {
   id: string
   name: string
   initials: string
@@ -40,6 +41,12 @@ export interface Post {
   id: string
   title: string
   slug: string
+  /**
+   * Public path (`/{urlPrefix}/{slug}`) built from the collection's
+   * `urlPrefix`, falling back to the collection slug when no prefix is known.
+   * `postTypeId` stays the API identity — never render that as the URL.
+   */
+  publicPath: string
   postTypeId: string
   postTypeName: string
   postTypeAccentColor: string | null
@@ -229,10 +236,14 @@ export async function fetchPosts(query: PostsQuery = {}): Promise<PostsResult> {
   const posts: Post[] = r.posts.map((d) => {
     const type = typeBySlug.get(d.collection)
     const authorName = d.author?.name?.trim() || 'Unknown'
+    const slug = d.slug ?? ''
     return {
       id: d.id,
       title: d.title ?? '(untitled)',
-      slug: d.slug ?? '',
+      slug,
+      // The server resolves `urlPrefix` from the running config (`''` for a
+      // root-mounted collection); a missing type row falls back to the slug.
+      publicPath: publicPathFor(type?.urlPrefix, d.collection, slug),
       postTypeId: d.collection,
       postTypeName: type?.singular ?? d.collection,
       postTypeAccentColor: type?.color ?? null,

package/src/lib/preview-link.ts

@@ -101,20 +101,6 @@ export function buildPublicUrl({
   return resolveDocumentUrl({ siteUrl, urlPrefix, slug, path, data, trailingSlash })
 }
 
-/**
- * Resolve the public site origin for link building.
- *
- * Prefer an explicit URL (effective public apex from `/site/public-url` or
- * `config.seo.siteUrl`). Falling back to `window.location.origin` is a last
- * resort — on Astro-split installs the admin tab is the Next CMS host, so that
- * fallback opens the wrong site. Callers should prefer {@link usePublicSiteUrl}.
- */
-export function resolveSiteUrl(configSiteUrl?: string | null): string {
-  if (configSiteUrl && configSiteUrl.trim()) return configSiteUrl.trim().replace(/\/+$/, '')
-  if (typeof window !== 'undefined') return window.location.origin
-  return ''
-}
-
 /** True when `siteUrl` shares an origin with the admin tab (split-deploy smell). */
 export function siteUrlMatchesAdminOrigin(
   siteUrl: string | null | undefined,

package/src/lib/public-path.ts

@@ -0,0 +1,33 @@
+/**
+ * Public path helpers for list-row subtitles.
+ *
+ * A collection's slug (`posts`) is its API / cache-tag / MCP identity; its
+ * `urlPrefix` (`blog`) is where the public site serves it. Editors read the
+ * subtitle as the live URL, so it must be built from the prefix (#921).
+ */
+
+function trimSlashes(value: string): string {
+  return value.replace(/^\/+|\/+$/g, '')
+}
+
+/**
+ * Build the public path for a document.
+ *
+ * - `urlPrefix` non-empty → `/{urlPrefix}/{slug}` (nested prefixes such as
+ *   `help/articles` are kept; stray slashes are trimmed).
+ * - `urlPrefix === ''` → `/{slug}` (collection mounted at the site root).
+ * - `urlPrefix === undefined` → `/{collectionSlug}/{slug}` (no prefix known;
+ *   the collection slug is the best available guess).
+ *
+ * An empty `slug` yields a trailing slash (`/blog/`) so callers can append a
+ * placeholder.
+ */
+export function publicPathFor(
+  urlPrefix: string | undefined,
+  collectionSlug: string,
+  slug: string,
+): string {
+  const prefix = trimSlashes(urlPrefix ?? collectionSlug)
+  const base = prefix ? `/${prefix}` : ''
+  return `${base}/${trimSlashes(slug)}`
+}

package/src/lib/rail-width.ts

@@ -10,7 +10,7 @@ export const RAIL_DEFAULT_WIDTH = 360
 /** Width of the strip that replaces the rail when it is collapsed. */
 export const RAIL_COLLAPSED_WIDTH = 38
 
-export const RAIL_WIDTH_STORAGE_KEY = 'pb.panelW'
+const RAIL_WIDTH_STORAGE_KEY = 'pb.panelW'
 
 /** Constrain a candidate width to the rail's range, rejecting junk. */
 export function clampRailWidth(width: number): number {