@prenta/admin 1.17.1 → 1.17.2

package/src/views/Pages.tsx

@@ -24,7 +24,7 @@ import { FolderTree, type FolderSelection } from '../components/FolderTree.js'
 
 type PageSortKey = 'title' | 'author' | 'template' | 'status' | 'date'
 
-export interface PagesProps {
+interface PagesProps {
   onNavigate?: (path: string) => void
 }
 

package/src/views/Redirects.tsx

@@ -22,7 +22,7 @@ import { cmsApi } from '../lib/api.js'
 
 type RedirectSortKey = 'from' | 'to' | 'type' | 'hits' | 'active'
 
-export interface RedirectsProps {
+interface RedirectsProps {
   onNavigate?: (path: string) => void
 }
 

package/src/views/page-editor/section-types.ts

@@ -10,27 +10,18 @@ export {
   SECTION_TYPES,
   SECTION_TYPE_LIST,
   getSectionType,
-  getSectionTypesForScope,
   getAddableSectionTypesForScope,
-  isSectionTypeAddable,
   isSectionTypeHideable,
   isSectionEffectivelyVisible,
-  sectionTypeLabel,
-  isKnownSectionType,
   resolveRepeaterField,
-  isRepeaterField,
   blankRepeaterRow,
 } from '@prenta/core/page-sections'
 
 export type {
   SectionTypeId,
   SectionScope,
-  SectionFieldType,
   SectionFieldDef,
   SectionSettings,
-  SectionTypeDef,
   ResolvedRepeater,
-  RepeaterRow,
   PostHeaderConfig,
-  PostTemplate,
 } from '@prenta/core/page-sections'

package/src/views/page-editor/sections/admin-renderers.tsx

@@ -62,7 +62,7 @@ export interface AdminSectionPostContext {
  * Paint budget to protect, but sections-react renderers call `claim()` during
  * render, so the shape must exist or a real renderer throws on its first image.
  */
-export interface AdminLcpController {
+interface AdminLcpController {
   claim(): boolean
   readonly claimed: boolean
 }

package/src/views/page-editor/theme-chrome/index.ts

@@ -1,12 +1,4 @@
-export {
-  ThemeChromeProvider,
-  useThemeChromeSpec,
-  useThemeChromeContext,
-} from './ThemeChromeProvider.js'
+export { ThemeChromeProvider, useThemeChromeContext } from './ThemeChromeProvider.js'
 export { ThemeChromeFrame } from './ThemeChromeFrame.js'
-export type { ThemeChromeFrameProps, ThemeChromeHealthState } from './ThemeChromeFrame.js'
+
 export { ThemeChromeHealth } from './ThemeChromeHealth.js'
-export type { ThemeChromeHealthProps } from './ThemeChromeHealth.js'
-export { ThemeChromeModeToggle } from './ThemeChromeModeToggle.js'
-export type { ThemeChromeModeToggleProps } from './ThemeChromeModeToggle.js'
-export { useThemeChromeMode } from './useThemeChromeMode.js'

package/src/views/page-editor/viewports.ts

@@ -5,9 +5,6 @@
  * mid-migration; import from `../../lib/breakpoints.js` in new code.
  */
 export {
-  BREAKPOINTS as VIEWPORTS,
   DEFAULT_BREAKPOINT as DEFAULT_VIEWPORT,
-  getBreakpoint as getViewport,
-  type Breakpoint as Viewport,
   type BreakpointId as ViewportId,
 } from '../../lib/breakpoints.js'

package/src/views/settings/AISettingsTab.tsx

@@ -54,7 +54,14 @@ export function AISettingsTab({ role, config }: AISettingsTabProps) {
           'Connect an AI provider under Provider connections before generating a brand voice profile.',
       }
     }
-    if (!ai.form.defaultModelId) {
+    // The runtime resolves the provider's curated default when no default
+    // model is set. Only built-in providers have a curated catalog — a
+    // `custom` endpoint cannot supply that default, so a custom-only site (or
+    // one with no keyed built-in connection) still needs an explicit model.
+    const hasKeyedProvider = ai.providers.some(
+      (p) => p.enabled && p.hasKey && p.provider !== 'custom',
+    )
+    if (!ai.form.defaultModelId && !hasKeyedProvider) {
       return {
         ready: false,
         message:
@@ -67,8 +74,13 @@ export function AISettingsTab({ role, config }: AISettingsTabProps) {
         message: 'Save your AI settings before generating a brand voice profile.',
       }
     }
-    return { ready: true }
-  }, [ai.dirty, ai.form.defaultModelId, ai.form.features, ai.providers.length])
+    return {
+      ready: true,
+      ...(ai.form.defaultModelId
+        ? {}
+        : { note: 'No default model selected — using the provider’s recommended default.' }),
+    }
+  }, [ai.dirty, ai.form.defaultModelId, ai.form.features, ai.providers])
 
   if (ai.loading) {
     return (

package/src/views/settings/BrandVoiceCard.tsx

@@ -9,7 +9,7 @@ import {
   type BrandAlignmentScoreResult,
   type BrandVoiceStructuredProfile,
 } from '@prenta/core/brand-voice'
-import { AlertTriangle, Download, FileUp, Link2, Loader2, Sparkles } from 'lucide-react'
+import { AlertTriangle, Download, FileUp, Info, Link2, Loader2, Sparkles } from 'lucide-react'
 import { useCallback, useId, useMemo, useRef, useState } from 'react'
 import { toast } from 'sonner'
 import { BrandVoiceAlignmentPanel } from './brand-voice/BrandVoiceAlignmentPanel.js'
@@ -95,7 +95,10 @@ function downloadTextFile(filename: string, contents: string) {
  */
 export interface BrandVoiceAiReadiness {
   ready: boolean
+  /** Why AI generation is blocked (rendered as a warning when `ready` is false). */
   message?: string
+  /** Informational context when ready — e.g. running on the provider's default model. */
+  note?: string
 }
 
 export function BrandVoiceCard({
@@ -348,6 +351,13 @@ export function BrandVoiceCard({
           </div>
         )}
 
+        {aiReadiness?.ready && aiReadiness.note && (
+          <p className="text-muted-foreground flex items-start gap-2 text-sm">
+            <Info size={16} className="mt-0.5 shrink-0" aria-hidden="true" />
+            <span>{aiReadiness.note}</span>
+          </p>
+        )}
+
         <div className="flex flex-wrap items-center gap-2">
           <button
             type="button"

package/src/views/settings/brand-voice/BrandVoiceAlignmentPanel.tsx

@@ -5,7 +5,7 @@ import { BRAND_VOICE_CHANNEL_PRESETS } from '@prenta/core/brand-voice'
 import { Loader2, Wand2 } from 'lucide-react'
 import { useId, useState } from 'react'
 import { toast } from 'sonner'
-import { fixBrandVoiceContent } from '../../../lib/brand-voice-client.js'
+import { brandVoiceFixAiNotice, fixBrandVoiceContent } from '../../../lib/brand-voice-client.js'
 
 const INPUT_CLASS =
   'w-full rounded-md border border-border bg-input-background px-3 py-2 text-base text-foreground focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none disabled:cursor-not-allowed disabled:opacity-60'
@@ -78,6 +78,8 @@ export function BrandVoiceAlignmentPanel({
           ? 'Copy revised to match brand voice.'
           : 'Applied brand voice rule fixes.',
       )
+      const notice = brandVoiceFixAiNotice(res.result)
+      if (notice) toast.info(notice)
     } finally {
       setFixing(false)
     }

package/src/views/settings/featureModel.ts

@@ -21,13 +21,13 @@ const CAPABILITY_LABELS: Record<string, string> = {
   longContext: 'long context',
 }
 
-export function findModel(models: AiModelView[], id: string | undefined): AiModelView | undefined {
+function findModel(models: AiModelView[], id: string | undefined): AiModelView | undefined {
   if (!id) return undefined
   return models.find((m) => m.id === id || m.providerModelId === id)
 }
 
 /** Required capabilities a model is missing. Unknown capability strings are ignored. */
-export function missingCapabilities(model: AiModelView | undefined, required: string[]): string[] {
+function missingCapabilities(model: AiModelView | undefined, required: string[]): string[] {
   const wanted = required.filter((c) => c in CAPABILITY_LABELS)
   if (!model) return wanted
   return wanted.filter((c) => !model.capabilities?.[c])

package/src/views/settings/useAiSettings.ts

@@ -31,7 +31,7 @@ export type AiConnectionStatus =
   | 'provider_down'
   | 'needs_setup'
   | 'unknown'
-export type AiModelStatus = 'available' | 'unavailable' | 'deprecated' | 'unknown'
+type AiModelStatus = 'available' | 'unavailable' | 'deprecated' | 'unknown'
 
 export interface AiModelView {
   id: string
@@ -147,7 +147,7 @@ const EMPTY_BRAND_VOICE: BrandVoiceForm = {
 }
 
 /** The buffered (Save-bar) portion of AI settings. */
-export interface AiSettingsForm {
+interface AiSettingsForm {
   defaultProviderId: string
   defaultModelId: string
   features: AiFeatureView[]
@@ -453,7 +453,12 @@ export function useAiSettings(canEdit: boolean): UseAiSettings {
           method: 'POST',
           body: JSON.stringify(input),
         })
-        if (res.error) return { ok: false, error: res.error }
+        if (res.error) {
+          // 503 "not configured" bodies carry the runtime's setup `hint`
+          // separately from `error` (same contract as every other AI route).
+          const hint = (res.errorBody as { hint?: unknown } | undefined)?.hint
+          return { ok: false, error: typeof hint === 'string' ? `${res.error} ${hint}` : res.error }
+        }
         if (!res.data?.draft) return { ok: false, error: 'No draft profile was returned.' }
         const structured = res.data.draft.document?.trim()
           ? parseStructuredProfile(res.data.draft.document)

package/src/views/settings/useAppearanceSettings.ts

@@ -30,10 +30,10 @@ import { cmsApi } from '../../lib/api.js'
 import { BRAND_UPDATED_EVENT } from '../../lib/favicon.js'
 import type { SettingsSourceMetadata, ValidationIssue } from './useGeneralSettings.js'
 
-export type SaveState = 'idle' | 'saving' | 'success' | 'error'
+type SaveState = 'idle' | 'saving' | 'success' | 'error'
 
 /** Theme + typography + motion form (the `appearance` settings blob). */
-export interface AppearanceForm {
+interface AppearanceForm {
   colorMode: ColorMode
   accent: string
   density: SidebarDensity
@@ -42,7 +42,7 @@ export interface AppearanceForm {
 }
 
 /** Brand asset references + admin branding mode (the `brand` settings blob). */
-export interface BrandForm {
+interface BrandForm {
   mode: AdminBrandingMode
   publicPrimaryLogoAssetId?: string
   publicLogoMarkAssetId?: string
@@ -64,7 +64,7 @@ export type BrandAssetField =
   | 'adminDarkLogoAssetId'
   | 'faviconSourceAssetId'
 
-export const FIELD_ROLE: Record<BrandAssetField, BrandAssetRole> = {
+const FIELD_ROLE: Record<BrandAssetField, BrandAssetRole> = {
   publicPrimaryLogoAssetId: 'publicPrimaryLogo',
   publicLogoMarkAssetId: 'publicLogoMark',
   publicDarkLogoAssetId: 'publicDarkLogo',
@@ -74,8 +74,6 @@ export const FIELD_ROLE: Record<BrandAssetField, BrandAssetRole> = {
   faviconSourceAssetId: 'faviconSource',
 }
 
-export type { AssetPreview } from '../../lib/appearance-api.js'
-
 /** An existing media-library asset chosen for a brand field via the picker. */
 export interface SelectedBrandAsset {
   id: string

package/src/views/settings/useEmailSettings.ts

@@ -5,7 +5,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
 import { cmsApi } from '../../lib/api.js'
 
 export type EmailProviderKey = 'resend' | 'smtpcom' | 'ses' | 'smtp'
-export type SaveState = 'idle' | 'saving' | 'success' | 'error'
+type SaveState = 'idle' | 'saving' | 'success' | 'error'
 
 export const EMAIL_PROVIDER_OPTIONS: Array<{ value: EmailProviderKey; label: string }> = [
   { value: 'resend', label: 'Resend' },
@@ -15,7 +15,7 @@ export const EMAIL_PROVIDER_OPTIONS: Array<{ value: EmailProviderKey; label: str
 ]
 
 /** Form state. Secrets are write-only: inputs start empty and never echo stored values. */
-export interface EmailSettingsForm {
+interface EmailSettingsForm {
   /** Empty string = email delivery not configured here. */
   provider: EmailProviderKey | ''
   from: string

package/src/views/settings/useGeneralSettings.ts

@@ -16,7 +16,7 @@ export interface GeneralSettingsForm {
   noIndexNonProduction: boolean
 }
 
-export type SettingsSource = 'config' | 'environment' | 'database' | 'plugin' | 'computed'
+type SettingsSource = 'config' | 'environment' | 'database' | 'plugin' | 'computed'
 
 export interface SettingsSourceMetadata {
   source: SettingsSource
@@ -24,12 +24,7 @@ export interface SettingsSourceMetadata {
   reason?: string
 }
 
-export type IndexStatusLevel =
-  | 'indexable'
-  | 'protected'
-  | 'blocked'
-  | 'partially_blocked'
-  | 'unknown'
+type IndexStatusLevel = 'indexable' | 'protected' | 'blocked' | 'partially_blocked' | 'unknown'
 
 export interface SiteIndexStatus {
   status: IndexStatusLevel
@@ -69,7 +64,7 @@ const EMPTY_FORM: GeneralSettingsForm = {
 }
 
 /** Validate a site URL: absolute http(s), no trailing slash, parseable. */
-export function validateSiteUrl(value: string): { valid: boolean; error?: string } {
+function validateSiteUrl(value: string): { valid: boolean; error?: string } {
   const trimmed = value.trim()
   if (!trimmed) return { valid: true }
   let url: URL
@@ -88,7 +83,7 @@ export function validateSiteUrl(value: string): { valid: boolean; error?: string
 }
 
 /** Best-effort IANA timezone check using the Intl API. */
-export function isValidTimeZone(tz: string): boolean {
+function isValidTimeZone(tz: string): boolean {
   if (!tz) return false
   try {
     new Intl.DateTimeFormat('en-US', { timeZone: tz })
@@ -99,7 +94,7 @@ export function isValidTimeZone(tz: string): boolean {
 }
 
 /** Best-effort BCP 47 locale check. */
-export function isValidLocale(locale: string): boolean {
+function isValidLocale(locale: string): boolean {
   if (!locale) return false
   try {
     // Throws RangeError on structurally invalid tags.

package/src/views/settings/useSeoSettings.ts

@@ -49,7 +49,7 @@ export interface SeoSettingsForm {
   organizationSameAs: string
 }
 
-export interface SitemapSummary {
+interface SitemapSummary {
   sitemapUrl: string
   lastGeneratedAt: string | null
   pagesIncluded: number

package/src/views/settings/useUpdates.ts

@@ -20,7 +20,7 @@ export interface UpdateChangelogItem {
   type?: UpdateChangeType
 }
 
-export interface UpdatePluginCompatibility {
+interface UpdatePluginCompatibility {
   name: string
   compatible: boolean
   minVersion?: string
@@ -52,7 +52,7 @@ interface GithubForm {
 const REPO_PATTERN = /^[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/
 
 /** Admin/Owner may manage updates (matches the server's `requireAdminScope`). */
-export function canManageUpdates(role: string | null | undefined): boolean {
+function canManageUpdates(role: string | null | undefined): boolean {
   const r = (role ?? '').toUpperCase()
   return r === 'ADMIN' || r === 'OWNER'
 }