@flamingo-stack/openframe-frontend-core 0.0.257 → 0.0.258

package/dist/components/onboarding-guides/index.cjs

@@ -4,7 +4,7 @@
 
 
 
-var _chunk4MXBBBHBcjs = require('../../chunk-4MXBBBHB.cjs');
+var _chunkKQQDN2WKcjs = require('../../chunk-KQQDN2WK.cjs');
 
 
 var _chunkT7AJBKZPcjs = require('../../chunk-T7AJBKZP.cjs');
@@ -140,7 +140,7 @@ function OnboardingGuidesCatalogView({
     });
   };
   const source = _nullishCoalesce(_optionalChain([runtime, 'optionalAccess', _4 => _4.source]), () => ( "openframe"));
-  const docSearch = _chunk4MXBBBHBcjs.useDocSearch.call(void 0, {
+  const docSearch = _chunkKQQDN2WKcjs.useDocSearch.call(void 0, {
     source,
     baseRoute: basePath,
     onNavigate: (path) => router.push(path),
@@ -166,7 +166,7 @@ function OnboardingGuidesCatalogView({
   const renderCardFn = _nullishCoalesce(renderCard, () => ( defaultRenderCard));
   const preControls = /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk4MXBBBHBcjs.DocSearchBar,
+      _chunkKQQDN2WKcjs.DocSearchBar,
       {
         placeholder: "Search onboarding guides, releases, case studies\u2026",
         query: docSearch.query,
@@ -238,7 +238,7 @@ function OnboardingGuideDetailView({
     return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEB76VWM4cjs.LoadError, { message: "Guide not found.", onRetry: reload });
   }
   if (!guide) {
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk4MXBBBHBcjs.DetailPageSkeleton, { showImageGallery: false });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkKQQDN2WKcjs.DetailPageSkeleton, { showImageGallery: false });
   }
   const captionsUrl = _chunkEB76VWM4cjs.getCaptionsUrl.call(void 0, "onboarding_guide", guide.id, guide.srt_content);
   const videoPoster = guide.main_video_thumbnail || guide.featured_image || guide.og_image_url || _optionalChain([runtime, 'optionalAccess', _9 => _9.resolvePlaceholderUrl, 'optionalCall', _10 => _10(guide.title, { aspect: "wide" })]) || void 0;
@@ -307,7 +307,7 @@ function OnboardingGuideDetailView({
       }
     ),
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk4MXBBBHBcjs.ArticleAuthorByline,
+      _chunkKQQDN2WKcjs.ArticleAuthorByline,
       {
         author: _nullishCoalesce(_optionalChain([guide, 'access', _12 => _12.author, 'optionalAccess', _13 => _13.full_name]), () => ( null)),
         avatar: _optionalChain([guide, 'access', _14 => _14.author, 'optionalAccess', _15 => _15.avatar_url]),

package/dist/components/onboarding-guides/index.js

@@ -4,7 +4,7 @@ import {
   DetailPageSkeleton,
   DocSearchBar,
   useDocSearch
-} from "../../chunk-IJHORDN5.js";
+} from "../../chunk-ACJPRIZC.js";
 import {
   useSelfFetch
 } from "../../chunk-L4LAAA5Q.js";

package/dist/components/shared/article-author-byline.d.ts

@@ -2,10 +2,9 @@
  * Shared "author byline" card used by article-shaped detail pages
  * (blog post, product release, onboarding guide, investor update).
  *
- * MOVED from the hub (`components/shared/article-author-byline.tsx`) so any
- * consuming app can embed it; the hub keeps a thin wrapper that pre-binds its
- * host-specific injections (the platform-aware `fallbackBio` default derived
- * from `getAppConfig()`).
+ * MOVED from the hub so any consuming app can embed it; hub call sites
+ * import it directly and pass their platform-aware copy explicitly
+ * (`fallbackBio={defaultAuthorFallbackBio()}` from the hub's app-config).
  *
  * Embed-readiness contract:
  *   - `Link` / `Image` render through the embed-shims (plain `<a>` / `<img>`

package/dist/components/shared/article-author-byline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"article-author-byline.d.ts","sourceRoot":"","sources":["../../../src/components/shared/article-author-byline.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAClC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiBD,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,GAAG,EACH,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,WAAW,EACX,IAAW,EACX,aAAa,EACb,SAAS,GACV,EAAE,wBAAwB,4BA4F1B"}
+{"version":3,"file":"article-author-byline.d.ts","sourceRoot":"","sources":["../../../src/components/shared/article-author-byline.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAClC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiBD,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,MAAM,EACN,GAAG,EACH,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,WAAW,EACX,IAAW,EACX,aAAa,EACb,SAAS,GACV,EAAE,wBAAwB,4BA4F1B"}

package/dist/types/entity-author.d.ts

@@ -18,4 +18,29 @@ export interface EntityAuthor {
     /** Present only on server/admin payloads — public DALs strip it. */
     email?: string | null;
 }
+/** One curated social link on an author profile (host junction:
+ *  `profile_social_links` ordered by display_order in the hub). */
+export interface AuthorSocialLink {
+    /** Platform key fed to `SocialIconRow` (e.g. 'linkedin', 'x'). */
+    platform: string;
+    url: string;
+    username?: string | null;
+}
+/**
+ * Public author-page view model — what `<AuthorDetailView>` renders. The
+ * hub's `PublicAuthor` (authors DAL) extends this with server-side extras
+ * (`updatedAt`); embedders construct it from whatever directory they have.
+ */
+export interface AuthorProfile {
+    id: string;
+    slug: string;
+    fullName: string;
+    avatarUrl: string | null;
+    about: string | null;
+    jobTitle: string | null;
+    company: string | null;
+    knowsAbout: string[];
+    /** Ordered by display_order. */
+    socialLinks: AuthorSocialLink[];
+}
 //# sourceMappingURL=entity-author.d.ts.map

package/dist/types/entity-author.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-author.d.ts","sourceRoot":"","sources":["../../src/types/entity-author.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;2EACuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;8EAC0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB"}
+{"version":3,"file":"entity-author.d.ts","sourceRoot":"","sources":["../../src/types/entity-author.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;2EACuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;8EAC0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;mEACmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gCAAgC;IAChC,WAAW,EAAE,gBAAgB,EAAE,CAAA;CAChC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.257",
+  "version": "0.0.258",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/authors/author-detail-view.tsx

@@ -0,0 +1,130 @@
+'use client'
+
+/**
+ * Author detail-page body — identity header (avatar → name → job title →
+ * socials), bio, expertise badges, and a `children` slot for the authored-
+ * content rail. THE one implementation behind the hub's `/authors/[slug]`
+ * page AND embedded author pages (react-embedding-example) — hosts fetch
+ * the `AuthorProfile` however they like and drill it in.
+ *
+ * Embed-readiness contract (same rules as ArticleAuthorByline):
+ *   - `Image` renders through the embed shim (plain `<img>` in non-Next
+ *     hosts; the real `next/image` once registered at app init).
+ *   - Avatar proxying rides the OPTIONAL ambient `ChatRuntime`
+ *     (`endpoints.imageProxyUrlPrefix`) — no provider ⇒ raw URL, never
+ *     throws. `proxyImageUrl` prop wins over the runtime.
+ *   - The authored-content rail is a SLOT (`children`), not a baked-in
+ *     fetch: the hub passes its pre-bound `RelatedContentSection` with SSR
+ *     `initialItems`; embedders pass the lib section with `apiBaseUrl`.
+ *     The view stays data-in, markup-out.
+ *
+ * Heading semantics are the HOST's: the view renders the name as a styled
+ * `<p>` (like the hub profile header) so a hosting page can own its `<h1>`
+ * (the hub uses an sr-only h1 for crawlers).
+ */
+
+import React from 'react'
+import Image from '../../embed-shims/next-image'
+import { cn } from '../../utils/cn'
+import { formatBioText } from '../../utils/format'
+import { getProxiedImageUrl } from '../../utils/image-proxy'
+import { useChatRuntime } from '../../contexts/chat-runtime-context'
+import { SocialIconRow } from '../social-icon-row'
+import { StatusBadge } from '../ui/status-badge'
+import type { AuthorProfile } from '../../types/entity-author'
+
+export interface AuthorDetailViewProps {
+  author: AuthorProfile
+  /** Host-injected avatar-URL mapper — wins over the ambient runtime. */
+  proxyImageUrl?: (url: string) => string
+  /** Authored-content rail (or anything else) rendered below the profile. */
+  children?: React.ReactNode
+  className?: string
+}
+
+export function AuthorDetailView({
+  author,
+  proxyImageUrl,
+  children,
+  className,
+}: AuthorDetailViewProps) {
+  // Optional runtime — null-safe outside a provider (bare embeds render the
+  // raw avatar URL; the hub's app-wide HubRuntimeProvider supplies the proxy).
+  const runtime = useChatRuntime()
+
+  const proxiedAvatar = author.avatarUrl
+    ? proxyImageUrl
+      ? proxyImageUrl(author.avatarUrl)
+      : (getProxiedImageUrl(author.avatarUrl, {
+          proxyPrefix: runtime?.endpoints.imageProxyUrlPrefix,
+          skipDomains: runtime?.endpoints.imageProxySkipDomains,
+          directHttps: true,
+        }) ?? author.avatarUrl)
+    : null
+
+  const subtitle = [author.jobTitle, author.company].filter(Boolean).join(' @ ')
+  const bioText = formatBioText(author.about)
+
+  return (
+    <div className={cn('flex flex-col gap-5 md:gap-6', className)}>
+      {/* Identity header: avatar left; name → subtitle → socials stacked right. */}
+      <div className="flex gap-6 w-full items-start">
+        <div className="relative shrink-0 h-24 w-24">
+          <div className="rounded-full overflow-hidden bg-ods-bg-secondary border border-ods-border w-full h-full relative">
+            {proxiedAvatar ? (
+              <Image
+                src={proxiedAvatar}
+                alt={author.fullName}
+                fill
+                className="object-cover"
+                unoptimized
+              />
+            ) : (
+              <div className="flex items-center justify-center h-full w-full text-3xl text-ods-text-secondary font-['Azeret_Mono']">
+                {author.fullName.charAt(0).toUpperCase()}
+              </div>
+            )}
+          </div>
+        </div>
+
+        <div className="min-w-0 flex flex-col justify-center gap-2">
+          <p className="text-h2 text-ods-text-primary leading-none truncate">
+            {author.fullName}
+          </p>
+          {subtitle && (
+            <p className="font-body text-lg text-ods-text-secondary leading-none truncate">
+              {subtitle}
+            </p>
+          )}
+          {author.socialLinks.length > 0 && (
+            // Ghost compact row (transparent 32px) — metadata, not CTAs.
+            <SocialIconRow
+              compact
+              links={author.socialLinks.map((link) => ({
+                platform: link.platform,
+                href: link.url,
+                label: `${author.fullName}'s ${link.platform}`,
+              }))}
+            />
+          )}
+        </div>
+      </div>
+
+      {bioText && (
+        <p className="font-body text-base leading-relaxed text-ods-text-secondary">
+          {bioText}
+        </p>
+      )}
+
+      {author.knowsAbout.length > 0 && (
+        <div className="flex flex-wrap gap-2">
+          {author.knowsAbout.map((topic) => (
+            <StatusBadge key={topic} text={topic} variant="button" colorScheme="cyan" singleLine />
+          ))}
+        </div>
+      )}
+
+      {children}
+    </div>
+  )
+}

package/src/components/index.ts

@@ -91,9 +91,14 @@ export * from './shared/legal-document'
 export { DetailPageSkeleton, type DetailPageSkeletonProps } from './shared/detail-page-skeleton'
 
 // Author byline card (end-of-article author description) — embeddable via
-// embed-shims + optional-runtime avatar proxying; the hub wraps it to inject
-// its platform-aware fallbackBio default.
+// embed-shims + optional-runtime avatar proxying; hosts pass their own
+// fallbackBio copy (the hub uses defaultAuthorFallbackBio()).
 export { ArticleAuthorByline, type ArticleAuthorBylineProps } from './shared/article-author-byline'
 
+// Author detail-page body (identity + socials + bio + expertise, rail as
+// children) — the one implementation behind /authors/[slug] and embedded
+// author pages.
+export { AuthorDetailView, type AuthorDetailViewProps } from './authors/author-detail-view'
+
 // Priority UI components that exist in main components directory
 // Note: These are re-exported from ./ui already, no need to duplicate

package/src/components/shared/article-author-byline.tsx

@@ -4,10 +4,9 @@
  * Shared "author byline" card used by article-shaped detail pages
  * (blog post, product release, onboarding guide, investor update).
  *
- * MOVED from the hub (`components/shared/article-author-byline.tsx`) so any
- * consuming app can embed it; the hub keeps a thin wrapper that pre-binds its
- * host-specific injections (the platform-aware `fallbackBio` default derived
- * from `getAppConfig()`).
+ * MOVED from the hub so any consuming app can embed it; hub call sites
+ * import it directly and pass their platform-aware copy explicitly
+ * (`fallbackBio={defaultAuthorFallbackBio()}` from the hub's app-config).
  *
  * Embed-readiness contract:
  *   - `Link` / `Image` render through the embed-shims (plain `<a>` / `<img>`

package/src/types/entity-author.ts

@@ -18,3 +18,30 @@ export interface EntityAuthor {
   /** Present only on server/admin payloads — public DALs strip it. */
   email?: string | null
 }
+
+/** One curated social link on an author profile (host junction:
+ *  `profile_social_links` ordered by display_order in the hub). */
+export interface AuthorSocialLink {
+  /** Platform key fed to `SocialIconRow` (e.g. 'linkedin', 'x'). */
+  platform: string
+  url: string
+  username?: string | null
+}
+
+/**
+ * Public author-page view model — what `<AuthorDetailView>` renders. The
+ * hub's `PublicAuthor` (authors DAL) extends this with server-side extras
+ * (`updatedAt`); embedders construct it from whatever directory they have.
+ */
+export interface AuthorProfile {
+  id: string
+  slug: string
+  fullName: string
+  avatarUrl: string | null
+  about: string | null
+  jobTitle: string | null
+  company: string | null
+  knowsAbout: string[]
+  /** Ordered by display_order. */
+  socialLinks: AuthorSocialLink[]
+}