@flamingo-stack/openframe-frontend-core 0.0.296-snapshot.20260621021605 → 0.0.296

package/src/components/shared/dev-section/dev-section-page.tsx

@@ -25,15 +25,7 @@ import {
   type OpenframeDevSectionKey,
 } from '../../../utils/dev-sections/openframe-dev-sections';
 
-/** Re-export the constant so existing dev-section call sites keep their
- *  old import path. The canonical home is `src/utils/page-header-constants.ts`
- *  (NOT a `'use client'` module) so server modules can import it without
- *  Next.js turning it into a client reference proxy — that proxy is what
- *  blew up lucide's `mergeClasses().trim()` when used as
- *  `<Icon className={SECTION_HERO_ICON_CLASS} />` inside a hub
- *  server-component preset. */
-import { SECTION_HERO_ICON_CLASS } from '../../../utils/page-header-constants';
-export { SECTION_HERO_ICON_CLASS };
+const SECTION_HERO_ICON_CLASS = 'h-10 w-10 text-ods-accent';
 
 export interface DevSectionPageProps {
   sectionKey: OpenframeDevSectionKey;

package/src/components/shared/dev-section/dev-section-view.tsx

@@ -19,7 +19,6 @@ import { useState, useEffect } from 'react';
 import { useRouter, useSearchParams, usePathname } from '../../../embed-shims';
 import { SearchInput } from '../../ui';
 import { StatusFilterComponent } from '../../features';
-import { PageHeader } from '../../layout/page-header';
 import {
   OPENFRAME_DEV_SECTIONS,
   type OpenframeDevSectionKey,
@@ -96,19 +95,15 @@ export function DevSectionView({ sectionKey, hero, preControls, children }: DevS
   return (
     <div className="w-full flex flex-col gap-10">
       {hero ? (
-        // Render through the shared `<PageHeader>` primitive so the dev-
-        // section hero (Releases, Roadmap, Onboarding catalog) and the
-        // docs-hub hero (Knowledge Hub, Data Room) are LITERALLY the same
-        // component rendering the same DOM/CSS. `noBottomMargin` because
-        // the parent `gap-10` already supplies the spacing to the next
-        // sibling (preControls / search / filter).
-        <PageHeader
-          title={hero.title ?? section.hero.title}
-          titleIcon={hero.icon}
-          subtitle={hero.description}
-          noBottomMargin
-          noTopPadding
-        />
+        <div className="space-y-4">
+          <h1 className="text-h1 tracking-[-1.12px] text-ods-text-primary flex items-center gap-3">
+            {hero.icon}
+            {hero.title ?? section.hero.title}
+          </h1>
+          <p className="font-['DM_Sans'] font-medium text-[18px] leading-[28px] text-ods-text-secondary max-w-3xl">
+            {hero.description}
+          </p>
+        </div>
       ) : (
         <div className="flex items-center justify-between w-full">
           <h2 className="font-['Azeret_Mono'] font-semibold text-[32px] md:text-[40px] lg:text-[48px] leading-[40px] md:leading-[48px] lg:leading-[56px] text-ods-text-primary tracking-[-0.64px] md:tracking-[-0.8px] lg:tracking-[-0.96px]">

package/src/components/shared/dev-section/index.ts

@@ -1,5 +1,5 @@
 export { DevSectionView, type DevSectionViewProps } from './dev-section-view';
-export { DevSectionPage, type DevSectionPageProps, SECTION_HERO_ICON_CLASS } from './dev-section-page';
+export { DevSectionPage, type DevSectionPageProps } from './dev-section-page';
 export {
   DevCardRowContent,
   DevCardRowSkeleton,

package/src/components/shared/doc-search/use-doc-search.ts

@@ -80,7 +80,7 @@ export function useDocSearch(config: UseDocSearchConfig) {
     onNavigate,
     tableIds,
     onInPageSwap,
-    searchEndpoint,
+    searchEndpoint = '/api/docs/search',
   } = config
   const tableIdsKey = tableIds && tableIds.length > 0 ? tableIds.join(',') : ''
 
@@ -88,11 +88,7 @@ export function useDocSearch(config: UseDocSearchConfig) {
   // Optional chat-runtime read — when present and mode='embed' the
   // search-result row click short-circuits to a new-tab open against
   // the absolutized URL. Null/host preserves today's behavior.
-  // Also used as the proxy-prefix fallback for `searchEndpoint`, matching
-  // how tickets resolves `findTicketUrl`.
   const runtime = useChatRuntime()
-  const resolvedSearchEndpoint =
-    searchEndpoint ?? runtime?.endpoints.docsSearchUrl ?? '/api/docs/search'
 
   const [query, setQuery] = useState('')
   const [results, setResults] = useState<SearchResult[]>([])
@@ -118,7 +114,7 @@ export function useDocSearch(config: UseDocSearchConfig) {
         })
         if (tableIdsKey) params.set('tableIds', tableIdsKey)
 
-        const response = await fetch(`${resolvedSearchEndpoint}?${params.toString()}`)
+        const response = await fetch(`${searchEndpoint}?${params.toString()}`)
         if (!response.ok) {
           throw new Error(`Search request failed: ${response.status}`)
         }
@@ -146,7 +142,7 @@ export function useDocSearch(config: UseDocSearchConfig) {
     return () => {
       cancelled = true
     }
-  }, [debouncedQuery, source, tableIdsKey, resolvedSearchEndpoint])
+  }, [debouncedQuery, source, tableIdsKey, searchEndpoint])
 
   // Derived loading state — single source of truth for "should the
   // dropdown show 'Loading...' instead of 'No results found'":

package/src/components/shared/legal-document/legal-document-page.tsx

@@ -19,7 +19,7 @@
 
 import type { ComponentType } from 'react';
 import { PageShell, PageLayout, PageHeading } from '../../ui';
-import { RichMarkdownRenderer } from '../../ui/rich-markdown-renderer';
+import { SimpleMarkdownRenderer } from '../../ui/simple-markdown-renderer';
 import { useRouter } from '../../../embed-shims/next-navigation';
 import { useLegalDocs, type LegalDocument } from './use-legal-docs';
 import { formatLegalDate } from '../../../utils/format';
@@ -76,7 +76,7 @@ export function LegalDocumentPage({
   initialData = null,
   initialLastUpdatedLabel = null,
   apiEndpoint,
-  MarkdownRenderer = RichMarkdownRenderer,
+  MarkdownRenderer = SimpleMarkdownRenderer,
   backButton,
 }: LegalDocumentPageProps) {
   const router = useRouter();

package/src/components/shared/product-release/release-detail-page.tsx

@@ -10,7 +10,6 @@ import { Card, CardContent } from '../../ui/card';
 import { PageShell } from '../../layout/article-detail-layout';
 import { PageLayout } from '../../layout/page-layout';
 import { ReleaseChangelogSection } from '../../ui/release-changelog-section';
-import { RichMarkdownRenderer } from '../../ui/rich-markdown-renderer';
 import { EntityTagBadges } from '../../features/entity-tag-badges';
 import { EntityMetadataAuthorCell } from '../../chat/entity-cards/entity-author-card';
 import type { EntityAuthor } from '../../../types/entity-author';
@@ -110,11 +109,10 @@ export interface ReleaseDetailPageProps {
   authorHref?: string;
 }
 
-// Default renderer = the lib's `RichMarkdownRenderer` so out-of-the-box
-// release pages get full rich-link previews, embedded media, social cards,
-// etc. Hosts that want a different rendering (or a Supabase-aware preset)
-// override via the `MarkdownRenderer` prop.
-const DefaultMarkdownRenderer = RichMarkdownRenderer;
+// Default simple markdown renderer (just renders as text)
+function DefaultMarkdownRenderer({ content }: MarkdownRendererProps) {
+  return <div className="whitespace-pre-wrap">{content}</div>;
+}
 
 export function ReleaseDetailPage({
   authorHref,

package/src/components/ui/index.ts

@@ -61,7 +61,6 @@ export * from './hover-dropdown'
 export * from '../chat'
 export * from '../layout/list-page-layout'
 export * from '../layout/page-container'
-export * from '../layout/page-header'
 export * from '../layout/page-heading'
 export * from '../layout/page-layout'
 export * from '../layout/article-detail-layout'
@@ -161,6 +160,5 @@ export * from './ticket-attachments-list'
 export * from './ticket-note-card'
 export * from './ticket-notes-section'
 export * from './simple-markdown-renderer'
-export { RichMarkdownRenderer, type RichMarkdownRendererProps } from './rich-markdown-renderer'
 export * from './filter-pill-row'
 

package/src/components/ui/release-changelog-section.tsx

@@ -3,7 +3,6 @@
 import React, { useState, useRef, useEffect } from 'react';
 import { Badge } from './badge';
 import { ChevronDown } from 'lucide-react';
-import { RichMarkdownRenderer } from './rich-markdown-renderer';
 import type { ChangelogEntry } from '../../types/product-release';
 
 interface ReleaseChangelogSectionProps {
@@ -32,11 +31,7 @@ interface ReleaseChangelogSectionProps {
    *  visual taxonomy across catalog and detail. Inherits the title's color
    *  (secondary for normal sections, red for breaking). */
   icon?: React.ReactNode;
-  /** Markdown renderer for each entry's description. Optional — defaults to
-   *  the lib's `RichMarkdownRenderer` so changelog rich-link previews
-   *  (YouTube, OG cards, etc.) work out of the box. Hosts that already
-   *  wrap with a Supabase-aware preset can keep passing their own. */
-  SimpleMarkdownRenderer?: React.ComponentType<{ content: string }>;
+  SimpleMarkdownRenderer: React.ComponentType<{ content: string }>;
 }
 
 // Collapsed height for the preview-first mode. ~120px shows the first
@@ -52,7 +47,7 @@ export function ReleaseChangelogSection({
   defaultCollapsed = true,
   previewFirst = false,
   icon,
-  SimpleMarkdownRenderer = RichMarkdownRenderer,
+  SimpleMarkdownRenderer
 }: ReleaseChangelogSectionProps) {
   const [collapsed, setCollapsed] = useState(collapsible ? defaultCollapsed : false);
   const [previewExpanded, setPreviewExpanded] = useState(false);

package/src/components/ui/simple-markdown-renderer.tsx

@@ -11,9 +11,6 @@ import { visit } from 'unist-util-visit';
 import Image from '../../embed-shims/next-image';
 import { AlertCircleIcon } from '../icons-v2-generated';
 import { cn } from '../../utils/cn';
-import type { ResolveLinkResult } from '../../types/doc-source';
-
-export type { ResolveLinkResult };
 
 // ---------------------------------------------------------------------------
 // rehype HAST sanitizer — runs AFTER rehype-raw to strip XSS vectors
@@ -526,10 +523,17 @@ function resolveTextSizeConfig(config?: TextSizeConfig): Record<TextSizeElement,
   return { ...defaultSizes, ...config };
 }
 
-// `ResolveLinkResult` lives in `../../types/doc-source` so it's the single
-// canonical home shared by `DocRenderHandlers.onResolveLink`, `DocViewer`'s
-// resolver, and this renderer's `onResolveLink` prop. Re-exported at the top
-// of this file for back-compat with callers that import from here.
+// ---------------------------------------------------------------------------
+// Resolved link result used by onResolveLink callback
+// ---------------------------------------------------------------------------
+export interface ResolveLinkResult {
+  success: boolean;
+  resolvedPath?: string;
+  type?: string;
+  action?: string;
+  error?: string;
+  message?: string;
+}
 
 // ---------------------------------------------------------------------------
 // Props

package/src/contexts/chat-runtime-context.tsx

@@ -57,20 +57,6 @@ export interface ChatRuntime {
     listEngagementsUrl?: string
     /** GET slash-command catalog. Hub: '/api/docs/commands'. */
     commandsUrl: string
-    /** GET RAG-search endpoint behind `<DocSearchBar>` (the in-source search
-     *  bar mounted by `<DocViewer>` / `<DocsHubPage>` when `showAIChat` is on).
-     *  Hub: '/api/docs/search'. OPTIONAL — falls back to the hub path so
-     *  same-origin Next.js hosts don't need to set it. Cross-origin embedders
-     *  set their proxied path so the search bar routes through the same
-     *  reverse proxy as everything else. Same pattern as `findTicketUrl`. */
-    docsSearchUrl?: string
-    /** POST internal-link resolver. The in-source markdown renderer (lib or
-     *  custom) calls `<DocViewer>`'s `handlers.onResolveLink(href, currentPath)`
-     *  for relative hrefs like `./getting-started/intro.md` — that callback
-     *  posts to this URL with `{ link, currentPath, source }` and expects a
-     *  `ResolveLinkResult` back. Hub: '/api/docs/resolve-link'. OPTIONAL — same
-     *  fall-back chain as `docsSearchUrl`: prop override → runtime → default. */
-    docsResolveLinkUrl?: string
     /** GET per-platform empty-state config (admin-edited in
      *  `/admin/chat-config`): `{ greeting, enabledRagTableIds, suggestedQueries }`.
      *  Hub: '/api/docs/empty-state'. OPTIONAL — the in-app (host-mode) chat

package/src/types/doc-source.ts

@@ -25,13 +25,6 @@ export interface DocNode {
   children?: DocNode[]
 }
 
-/**
- * Named alias for `DocNode['documentType']` (non-nullable). Use this as the
- * key type when building per-document-type renderer maps — keeps consumers
- * from re-declaring the union or having to dig into `DocNode`.
- */
-export type DocumentType = NonNullable<DocNode['documentType']>
-
 /**
  * Content payload returned by a doc-source DAL's `getContent` call. Carries
  * everything any consumer's renderer might need; markdown-only fields and
@@ -78,21 +71,6 @@ export interface DocSourceDal<Client = unknown> {
  */
 export type DocSourceId = 'openframe-docs' | 'data-room-docs'
 
-/**
- * Result returned by the resolve-link endpoint. Discriminator-style: `success`
- * + `type` jointly decide what the renderer does (navigate, expand folder,
- * show broken-link badge). Backed by hub `/api/docs/resolve-link` and any
- * embedder-proxied equivalent.
- */
-export interface ResolveLinkResult {
-  success: boolean
-  resolvedPath?: string
-  type?: string
-  action?: string
-  error?: string
-  message?: string
-}
-
 /**
  * Handlers the viewer passes to a consumer's `renderContent` callback.
  * The page shell wires `renderContent` directly — no `DocContentRenderer`
@@ -105,16 +83,6 @@ export interface DocRenderHandlers {
   ) => void
   currentPath: string
   /** Registry source id (e.g. `'openframe-docs'`, `'data-room-docs'`) — used by
-   *  the consumer's `/api/docs/resolve-link` POST to disambiguate the doc source. */
+   *  the consumer's `/api/resolve-link` POST to disambiguate the doc source. */
   sourceId: DocSourceId
-  /**
-   * Async link resolver — POSTs the raw markdown href + the current doc's path
-   * to the embedder's resolve-link endpoint and returns the resolved tree path.
-   * The lib auto-wires this when `DocViewer` knows the resolve-link endpoint
-   * (via `resolveLinkEndpoint` prop, `ChatRuntime.endpoints.docsResolveLinkUrl`,
-   * or the `/api/docs/resolve-link` default). Consumers thread it directly into
-   * their markdown renderer's `onResolveLink` prop — without it, relative
-   * hrefs like `./intro.md` end up fetched verbatim and 404.
-   */
-  onResolveLink?: (href: string, currentPath: string) => Promise<ResolveLinkResult>
 }

package/src/utils/index.ts

@@ -317,4 +317,3 @@ export * from './tree-builder'
 export * from './markdown-section-extractor'
 export * from './markdown-to-plain'
 export * from './embed-url-converters'
-export * from './page-header-constants'