@flamingo-stack/openframe-frontend-core 0.0.396-snapshot.20260709212121 → 0.0.396

package/dist/components/chat/entity-cards/entity-portrait-card.d.ts

@@ -1,59 +0,0 @@
-/**
- * <EntityPortraitCard> — THE portrait (rail/strip) card anatomy, shared by
- * EVERY entity card's `size="portrait"` density (case study, blog post,
- * customer interview, program, investor update, onboarding guide, …).
- *
- * One rail = one anatomy (2026 card-UI practice): identical zone boxes across
- * all content types —
- *   media  : aspect-[1200/630] slot + content-type chip overlay
- *   title  : fixed 72px zone, 3-line clamp (typography per entity via
- *            `titleClassName` — e.g. Azeret Mono for programs)
- *   footer : fixed 60px person zone (author avatar + name + subtitle, with
- *            the optional bottom-right icon overlay — the case-study MSP
- *            pattern)
- * Card surface, padding (p-6/gap-6) and the hover treatment (accent border +
- * accent shadow) are encoded HERE exactly once, so no per-card drift is
- * possible. Entity cards only MAP their row onto these props.
- *
- * Media rule ("our common way"): the REAL cover always wins. Wide covers
- * (OG-style 1200×630) fill the slot `object-cover`; a non-wide cover (square
- * podcast artwork) renders contained on an `useImageEdgeColor` background —
- * the SAME edge-sampled fill the media/news cards use (OGLinkPreview) — never
- * a flat filler and never the generic placeholder while a real image exists.
- * The cover → placeholder → hide resolution is the shared
- * `useCoverImageFallback` chain (one fallback logic for all entity cards).
- *
- * The content-type chip is the common <StatusBadge> and lives ABOVE the title
- * (an eyebrow inside the title zone), never overlaid on the artwork — branded
- * covers carry their own marks (Flamingo logo top-left) that an overlay would
- * collide with.
- */
-import React from 'react';
-export interface EntityPortraitPerson {
-    name: string;
-    avatarUrl?: string | null;
-    subtitle?: string | null;
-    /** Small round overlay on the avatar's bottom-right corner (e.g. MSP icon). */
-    iconOverlayUrl?: string | null;
-}
-export interface EntityPortraitCardProps {
-    href: string;
-    target?: '_blank';
-    rel?: string;
-    /** Content-type chip ('Case Study', 'Podcast', …). OMIT to hide the chip —
-     *  single-type rails don't need per-card type identification; only mixed
-     *  rails pass it. */
-    typeLabel?: string;
-    imageUrl?: string | null;
-    /** Branded wide OG fallback — used when `imageUrl` is missing, errors, or
-     *  isn't wide. */
-    placeholderUrl?: string | null;
-    imageAlt: string;
-    title: string;
-    /** Typography override for the title (entity identity), zone box unchanged. */
-    titleClassName?: string;
-    person?: EntityPortraitPerson | null;
-    className?: string;
-}
-export declare function EntityPortraitCard({ href, target, rel, typeLabel, imageUrl, placeholderUrl, imageAlt, title, titleClassName, person, className, }: EntityPortraitCardProps): React.JSX.Element;
-//# sourceMappingURL=entity-portrait-card.d.ts.map

package/dist/components/chat/entity-cards/entity-portrait-card.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity-portrait-card.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/entity-cards/entity-portrait-card.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAA;AAYlD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;yBAEqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;sBACkB;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,MAAM,EACN,GAAG,EACH,SAAS,EACT,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,KAAK,EACL,cAAc,EACd,MAAM,EACN,SAAS,GACV,EAAE,uBAAuB,qBAmHzB"}

package/dist/components/chat/entity-cards/use-cover-image-fallback.d.ts

@@ -1,26 +0,0 @@
-/**
- * THE common cover-image fallback chain for entity cards:
- *   real cover → branded placeholder → nothing (hide the media element).
- *
- * One hook so no card hand-rolls its own `imageError` state / `displayImage`
- * ternary (they drift: the pre-hook BlogCard chain couldn't recover from a
- * FAILING placeholder, EntityPortraitCard duplicated the same logic with
- * different state). Cards wire `src` + `onError` and render their own
- * empty-state when `src` is null.
- *
- * Implementation note: state is the SET of candidate URLs that failed, and
- * `src` is derived — so a prop change (new cover URL) re-resolves instantly
- * with no reset effect, and a URL that failed once isn't retried in a loop.
- */
-import { type SyntheticEvent } from 'react';
-export interface CoverImageFallback {
-    /** Resolved source: first non-failed of [imageUrl, placeholderUrl], else null. */
-    src: string | null;
-    /** Wire to the media element's `onError`. */
-    onError: () => void;
-}
-export declare function useCoverImageFallback(imageUrl?: string | null, placeholderUrl?: string | null): CoverImageFallback;
-/** Fallback for cards with NO placeholder chain (compact/sm image slots):
- *  a broken cover simply disappears, leaving the slot's background. */
-export declare const hideOnError: (e: SyntheticEvent<HTMLImageElement>) => void;
-//# sourceMappingURL=use-cover-image-fallback.d.ts.map

package/dist/components/chat/entity-cards/use-cover-image-fallback.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-cover-image-fallback.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/entity-cards/use-cover-image-fallback.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,OAAO,CAAA;AAElE,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,kBAAkB,CAcpB;AAED;uEACuE;AACvE,eAAO,MAAM,WAAW,GAAI,GAAG,cAAc,CAAC,gBAAgB,CAAC,SAE9D,CAAA"}

package/src/components/chat/entity-cards/entity-portrait-card.tsx

@@ -1,201 +0,0 @@
-'use client'
-
-/**
- * <EntityPortraitCard> — THE portrait (rail/strip) card anatomy, shared by
- * EVERY entity card's `size="portrait"` density (case study, blog post,
- * customer interview, program, investor update, onboarding guide, …).
- *
- * One rail = one anatomy (2026 card-UI practice): identical zone boxes across
- * all content types —
- *   media  : aspect-[1200/630] slot + content-type chip overlay
- *   title  : fixed 72px zone, 3-line clamp (typography per entity via
- *            `titleClassName` — e.g. Azeret Mono for programs)
- *   footer : fixed 60px person zone (author avatar + name + subtitle, with
- *            the optional bottom-right icon overlay — the case-study MSP
- *            pattern)
- * Card surface, padding (p-6/gap-6) and the hover treatment (accent border +
- * accent shadow) are encoded HERE exactly once, so no per-card drift is
- * possible. Entity cards only MAP their row onto these props.
- *
- * Media rule ("our common way"): the REAL cover always wins. Wide covers
- * (OG-style 1200×630) fill the slot `object-cover`; a non-wide cover (square
- * podcast artwork) renders contained on an `useImageEdgeColor` background —
- * the SAME edge-sampled fill the media/news cards use (OGLinkPreview) — never
- * a flat filler and never the generic placeholder while a real image exists.
- * The cover → placeholder → hide resolution is the shared
- * `useCoverImageFallback` chain (one fallback logic for all entity cards).
- *
- * The content-type chip is the common <StatusBadge> and lives ABOVE the title
- * (an eyebrow inside the title zone), never overlaid on the artwork — branded
- * covers carry their own marks (Flamingo logo top-left) that an overlay would
- * collide with.
- */
-
-import React, { useEffect, useState } from 'react'
-import Image from '../../../embed-shims/next-image'
-import { Card } from '../../ui/card'
-import { StatusBadge } from '../../ui/status-badge'
-import { useImageEdgeColor } from '../../../hooks/ui/use-image-edge-color'
-import { useCoverImageFallback } from './use-cover-image-fallback'
-import { cn } from '../../../utils/cn'
-
-/** Sources narrower than this are "not wide" → contained on the edge-color
- *  fill. Wide covers are 1200/630 ≈ 1.9; squares are 1.0; 1.3 splits safely. */
-const MIN_WIDE_RATIO = 1.3
-
-export interface EntityPortraitPerson {
-  name: string
-  avatarUrl?: string | null
-  subtitle?: string | null
-  /** Small round overlay on the avatar's bottom-right corner (e.g. MSP icon). */
-  iconOverlayUrl?: string | null
-}
-
-export interface EntityPortraitCardProps {
-  href: string
-  target?: '_blank'
-  rel?: string
-  /** Content-type chip ('Case Study', 'Podcast', …). OMIT to hide the chip —
-   *  single-type rails don't need per-card type identification; only mixed
-   *  rails pass it. */
-  typeLabel?: string
-  imageUrl?: string | null
-  /** Branded wide OG fallback — used when `imageUrl` is missing, errors, or
-   *  isn't wide. */
-  placeholderUrl?: string | null
-  imageAlt: string
-  title: string
-  /** Typography override for the title (entity identity), zone box unchanged. */
-  titleClassName?: string
-  person?: EntityPortraitPerson | null
-  className?: string
-}
-
-export function EntityPortraitCard({
-  href,
-  target,
-  rel,
-  typeLabel,
-  imageUrl,
-  placeholderUrl,
-  imageAlt,
-  title,
-  titleClassName,
-  person,
-  className,
-}: EntityPortraitCardProps) {
-  const { src, onError: onMediaError } = useCoverImageFallback(imageUrl, placeholderUrl)
-  // null = unknown (assume wide until the image reports its natural size).
-  const [isWide, setIsWide] = useState<boolean | null>(null)
-  useEffect(() => {
-    // Re-detect whenever the resolved source changes (prop change OR the
-    // fallback chain advancing to the placeholder).
-    setIsWide(null)
-  }, [src])
-
-  const onMediaLoad = (e: React.SyntheticEvent<HTMLImageElement>) => {
-    const img = e.currentTarget
-    if (img.naturalWidth > 0 && img.naturalHeight > 0) {
-      setIsWide(img.naturalWidth / img.naturalHeight >= MIN_WIDE_RATIO)
-    }
-  }
-
-  // Edge-sampled slot fill for non-wide covers — the SAME hook/fallback the
-  // media/news cards use (og-link-preview.tsx).
-  const edgeColor = useImageEdgeColor(isWide === false ? src : null, 'var(--ods-bg-secondary)')
-
-  return (
-    <a href={href} target={target} rel={rel} className={cn('block h-full', className)} aria-label={`Open ${title}`}>
-      <Card className="bg-ods-card border border-ods-border hover:border-ods-accent hover:shadow-lg hover:shadow-ods-accent/[0.08] transition-all duration-200 p-6 flex flex-col gap-6 overflow-hidden h-full">
-        {/* Media zone — the real cover always wins: wide → cover-fill;
-            non-wide → contained on the edge-color fill (news-card treatment). */}
-        <div
-          className="relative w-full aspect-[1200/630] rounded-sm overflow-hidden bg-ods-bg shrink-0 flex items-center justify-center transition-colors duration-300"
-          style={isWide === false ? { backgroundColor: edgeColor } : undefined}
-        >
-          {src && (
-            <Image
-              src={src}
-              alt={imageAlt}
-              className={cn('w-full h-full', isWide === false ? 'object-contain' : 'object-cover')}
-              sizes="(min-width: 800px) 400px, 100vw"
-              fill
-              unoptimized
-              onLoad={onMediaLoad}
-              onError={onMediaError}
-            />
-          )}
-        </div>
-
-        {/* Title zone — fixed box. Mixed rails: common StatusBadge eyebrow +
-            2-line title (chip lives here, never on the artwork). Single-type
-            rails (no typeLabel): centered 3-line title. */}
-        <div className="h-[72px] flex flex-col justify-center gap-1.5 shrink-0">
-          {typeLabel && (
-            <StatusBadge
-              variant="button"
-              colorScheme="accentBorder"
-              singleLine
-              text={typeLabel}
-              className="self-start"
-            />
-          )}
-          <h3
-            className={cn(
-              'text-h4 leading-6 text-ods-text-primary break-words',
-              typeLabel ? 'line-clamp-2' : 'line-clamp-3',
-              titleClassName,
-            )}
-          >
-            {title}
-          </h3>
-        </div>
-
-        {/* Person/footer zone — fixed box (kept even when empty so every card
-            in a rail shares baselines). */}
-        <div className="h-[60px] flex items-center shrink-0">
-          {person && (
-            <div className="flex items-center gap-3 min-w-0 w-full">
-              <div className="relative shrink-0 w-12 h-12">
-                {person.avatarUrl ? (
-                  <Image
-                    src={person.avatarUrl}
-                    alt={person.name}
-                    className="w-12 h-12 rounded-full object-cover bg-ods-bg border border-ods-border"
-                    width={48}
-                    height={48}
-                    unoptimized
-                  />
-                ) : (
-                  <div className="w-12 h-12 rounded-full bg-ods-bg border border-ods-border flex items-center justify-center">
-                    <span className="text-ods-text-secondary font-medium text-xl">
-                      {person.name.charAt(0).toUpperCase()}
-                    </span>
-                  </div>
-                )}
-                {person.iconOverlayUrl && (
-                  <div className="absolute -bottom-1 -right-1 w-6 h-6 rounded-full bg-ods-text-primary ring-1 ring-ods-bg overflow-hidden flex items-center justify-center">
-                    <Image
-                      src={person.iconOverlayUrl}
-                      alt=""
-                      className="w-full h-full object-cover"
-                      width={24}
-                      height={24}
-                      unoptimized
-                    />
-                  </div>
-                )}
-              </div>
-              <div className="flex flex-col min-w-0">
-                <span className="font-['DM_Sans'] font-bold text-ods-text-primary truncate">{person.name}</span>
-                {person.subtitle && (
-                  <span className="font-['DM_Sans'] text-sm text-ods-text-secondary truncate">{person.subtitle}</span>
-                )}
-              </div>
-            </div>
-          )}
-        </div>
-      </Card>
-    </a>
-  )
-}

package/src/components/chat/entity-cards/use-cover-image-fallback.ts

@@ -1,50 +0,0 @@
-'use client'
-
-/**
- * THE common cover-image fallback chain for entity cards:
- *   real cover → branded placeholder → nothing (hide the media element).
- *
- * One hook so no card hand-rolls its own `imageError` state / `displayImage`
- * ternary (they drift: the pre-hook BlogCard chain couldn't recover from a
- * FAILING placeholder, EntityPortraitCard duplicated the same logic with
- * different state). Cards wire `src` + `onError` and render their own
- * empty-state when `src` is null.
- *
- * Implementation note: state is the SET of candidate URLs that failed, and
- * `src` is derived — so a prop change (new cover URL) re-resolves instantly
- * with no reset effect, and a URL that failed once isn't retried in a loop.
- */
-
-import { useCallback, useState, type SyntheticEvent } from 'react'
-
-export interface CoverImageFallback {
-  /** Resolved source: first non-failed of [imageUrl, placeholderUrl], else null. */
-  src: string | null
-  /** Wire to the media element's `onError`. */
-  onError: () => void
-}
-
-export function useCoverImageFallback(
-  imageUrl?: string | null,
-  placeholderUrl?: string | null,
-): CoverImageFallback {
-  const [failed, setFailed] = useState<ReadonlySet<string>>(() => new Set())
-
-  const src =
-    imageUrl && !failed.has(imageUrl) ? imageUrl
-    : placeholderUrl && !failed.has(placeholderUrl) ? placeholderUrl
-    : null
-
-  const onError = useCallback(() => {
-    if (!src) return
-    setFailed(prev => new Set(prev).add(src))
-  }, [src])
-
-  return { src, onError }
-}
-
-/** Fallback for cards with NO placeholder chain (compact/sm image slots):
- *  a broken cover simply disappears, leaving the slot's background. */
-export const hideOnError = (e: SyntheticEvent<HTMLImageElement>) => {
-  ;(e.currentTarget as HTMLImageElement).style.display = 'none'
-}