@flamingo-stack/openframe-frontend-core 0.0.756 → 0.0.758

package/src/components/shared/delivery/delivery-lists.tsx

@@ -31,11 +31,14 @@
 import { useEffect, useState } from 'react';
 import { useSearchParams, useRouter, usePathname } from '../../../embed-shims';
 import { useScrollToHash } from '../../../hooks/use-scroll-to-hash';
+import type { DataSync } from '../../../types/data-sync';
 import type { DeliveryItem, DeliveryResponse } from '../../../types/delivery';
 import { DEV_SECTION_PARAM_KEYS } from '../../../utils/dev-sections/dev-section-param-keys';
 import { contentFetch } from '../../../utils/embed-content-fetch';
 import { STICKY_HEADER_OFFSET_PX } from '../../../utils/same-page-hash-nav';
+import { usePageDataSync } from '../../layout/page-data-sync';
 import { ListEmptyState } from '../../list-empty-state';
+import { DataSyncLine } from '../../ui/data-attribution';
 import { LoadError } from '../../ui/error-state';
 import { DeliveryTable } from './delivery-table';
 
@@ -47,13 +50,15 @@ const DEFAULT_SEARCH_PARAM_KEY = DEV_SECTION_PARAM_KEYS.search;
 const DEFAULT_TASK_TYPE_PARAM_KEY = DEV_SECTION_PARAM_KEYS.deliveryTaskType;
 
 /**
- * Wire shape of ONE bucket endpoint — `{ items, count, pagination }`. Only
- * `items` is read here; `items` stays optional because an embedder's proxy is
+ * Wire shape of ONE bucket endpoint — `{ items, count, pagination, sync }`. Only
+ * `items` and `sync` are read here; `items` stays optional because an embedder's proxy is
  * free to answer with an empty envelope, and the render treats "no items" and
  * "empty items" identically.
  */
 interface DeliveryBucketResponse {
   items?: DeliveryItem[];
+  /** Where the tasks are mirrored from and when it last read them (both buckets read the same mirror). */
+  sync?: DataSync;
 }
 
 export interface DeliveryListsProps {
@@ -84,6 +89,7 @@ export function DeliveryLists({
   const [data, setData] = useState<DeliveryResponse | null>(null);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
+  const [sync, setSync] = useState<DataSync | null>(null);
 
   // Get filter state from URL
   const searchQuery = searchParams.get(searchParamKey) || '';
@@ -134,6 +140,7 @@ export function DeliveryLists({
           completed: completedResult.items ?? [],
           inProgress: inProgressResult.items ?? [],
         });
+        setSync(completedResult.sync ?? inProgressResult.sync ?? null);
       } catch (err) {
         if (cancelled) return;
         console.error('Error fetching delivery items:', err);
@@ -160,6 +167,8 @@ export function DeliveryLists({
   // by RoadmapView). 96 matches the sticky-header offset every
   // hash-scroll surface in the app uses.
   useScrollToHash(data, { headerOffset: STICKY_HEADER_OFFSET_PX });
+  // The page states the sync under its title; the lists shown without that page draw it above themselves.
+  const syncInPage = usePageDataSync(sync, isLoading && !data);
 
   const showCompleted = true;
   const showInProgress = true;
@@ -180,6 +189,7 @@ export function DeliveryLists({
 
   return (
     <div className="flex w-full flex-col gap-[40px]">
+      {!syncInPage && <DataSyncLine sync={sync} loading={isLoading && !data} />}
       {/* Empty state if no results after filtering */}
       {!isLoading && !hasResults && (
         <ListEmptyState

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

@@ -23,26 +23,15 @@ import {
   type OpenframeDevSectionKey,
 } from '../../../utils/dev-sections/openframe-dev-sections';
 import { StatusFilterComponent } from '../../features';
+import { PageDataSyncProvider, PageDataSyncRow } from '../../layout/page-data-sync';
+import { SectionHeading } from '../../layout/page-heading';
 import { SearchInput } from '../../ui';
 
 export interface DevSectionViewProps {
   /** Which section to render — drives title, search, and filter
    *  config via the `OPENFRAME_DEV_SECTIONS` registry. */
   sectionKey: OpenframeDevSectionKey;
-  /** When set, renders the rich page-level hero (icon + h1 + description).
-   *  Omit for the compact tab-context heading. */
-  hero?: {
-    /** Pre-rendered icon JSX. Server components render the icon themselves
-     *  and pass the element here — function references can't cross the
-     *  server→client boundary, but React elements can. */
-    icon: ReactNode;
-    /** Hero title. Falls back to `OPENFRAME_DEV_SECTIONS[sectionKey].hero.title`
-     *  when omitted, so embedders can override the (OpenFrame-specific) default
-     *  copy without forking the registry. */
-    title?: string;
-    description: string;
-  };
-  /** Optional slot rendered BETWEEN the hero and the search/filter
+  /** Optional slot rendered BETWEEN the heading and the search/filter
    *  controls. Use this for an entry-action surface that should sit
    *  above the list (e.g. the Help Center's "Open a new ticket" form).
    *  The slot is wrapped in the same `gap-10` flex column so spacing
@@ -52,7 +41,7 @@ export interface DevSectionViewProps {
   /** The page-specific list body. Reads URL params written by this
    *  component (search input + filter pills). */
   children: ReactNode;
-  /** Render this component's own title heading (hero or compact `h2`). Default
+  /** Render this component's own title heading (the section's `h2`). Default
    *  `true` — the tab context renders the compact heading itself. Pass `false`
    *  when the host already renders the title elsewhere (e.g. `DevSectionPage`
    *  routes it through the unified `PageLayout` `TitleBlock`): then only the
@@ -60,7 +49,7 @@ export interface DevSectionViewProps {
   showHeading?: boolean;
 }
 
-export function DevSectionView({ sectionKey, hero, preControls, children, showHeading = true }: DevSectionViewProps) {
+export function DevSectionView({ sectionKey, preControls, children, showHeading = true }: DevSectionViewProps) {
   const section = OPENFRAME_DEV_SECTIONS[sectionKey];
   const router = useRouter();
   const pathname = usePathname();
@@ -123,50 +112,42 @@ export function DevSectionView({ sectionKey, hero, preControls, children, showHe
     router.replace(`${pathname}?${params.toString()}`, { scroll: false });
   };
 
+  // The list reports where its records are mirrored from; the line states it at the end of the section's heading row
+  // (under the page's title when this view shows no heading of its own).
   return (
-    <div className="flex w-full flex-col gap-10">
-      {showHeading &&
-        (hero ? (
-          <div className="space-y-4">
-            <h1 className="flex items-center gap-3 tracking-[-1.12px] text-ods-text-primary text-h1">
-              {hero.icon}
-              {hero.title ?? section.hero.title}
-            </h1>
-            <p className="max-w-3xl text-ods-text-secondary text-h4">{hero.description}</p>
-          </div>
+    <PageDataSyncProvider>
+      <div className="flex w-full flex-col gap-10">
+        {showHeading ? (
+          <SectionHeading title={section.hero.title} punctuation=":" action={<PageDataSyncRow inline />} />
         ) : (
-          <div className="flex w-full items-center justify-between">
-            <h2 className="font-['Azeret_Mono'] text-[32px] font-semibold leading-[40px] tracking-[-0.64px] text-ods-text-primary content-md:text-[40px] content-md:leading-[48px] content-md:tracking-[-0.8px] content-lg:text-[48px] content-lg:leading-[56px] content-lg:tracking-[-0.96px]">
-              {section.hero.title}
-              <span className="text-ods-accent">:</span>
-            </h2>
-          </div>
-        ))}
+          <PageDataSyncRow />
+        )}
 
-      {preControls}
+        {preControls}
 
-      {(search || filter) && (
-        <div className="space-y-4">
-          {search && (
-            <SearchInput
-              showDropdown={false}
-              placeholder={search.placeholder}
-              value={searchValue}
-              onChange={handleSearchChange}
-              onSubmit={handleSearchSubmit}
-            />
-          )}
-          {filter && (
-            <StatusFilterComponent
-              selectedStatus={currentFilterValue}
-              onStatusChange={handleFilterChange}
-              statusOptions={[...filter.options]}
-            />
-          )}
-        </div>
-      )}
+        {(search || filter) && (
+          <div className="space-y-4">
+            {search && (
+              <SearchInput
+                showDropdown={false}
+                placeholder={search.placeholder}
+                value={searchValue}
+                onChange={handleSearchChange}
+                onSubmit={handleSearchSubmit}
+              />
+            )}
+            {filter && (
+              <StatusFilterComponent
+                selectedStatus={currentFilterValue}
+                onStatusChange={handleFilterChange}
+                statusOptions={[...filter.options]}
+              />
+            )}
+          </div>
+        )}
 
-      {children}
-    </div>
+        {children}
+      </div>
+    </PageDataSyncProvider>
   );
 }

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

@@ -20,10 +20,10 @@
 import type { ComponentType } from 'react';
 import Link from '../../../embed-shims/next-link';
 import { useRouter } from '../../../embed-shims/next-navigation';
-import { formatLegalDate } from '../../../utils/format';
 import { FaqSection, pageFaqProps, type PageFaqSlot } from '../../faq/faq-section';
 import { UnifiedSkeleton } from '../../loading/unified-skeleton';
 import { PageShell, PageLayout } from '../../ui';
+import { DataSyncLine } from '../../ui/data-attribution';
 import { RichMarkdownRenderer } from '../../ui/markdown';
 import { useLegalDocs, type LegalDocument } from './use-legal-docs';
 import { useLegalDocuments } from './use-legal-documents';
@@ -56,8 +56,6 @@ export interface LegalDocumentPageProps {
   emptyStateMessage?: string;
   /** SSR-prepared document, if available. */
   initialData?: LegalDocument | null;
-  /** SSR-prepared formatted "Last Updated" label. Stable across hydration. */
-  initialLastUpdatedLabel?: string | null;
   /** Override the default `/api/legal/<docType>` endpoint
    *  (reverse-proxy embedders, alternate API paths). */
   apiEndpoint?: string;
@@ -109,7 +107,6 @@ export function LegalDocumentPage({
   errorTitle: errorTitleProp,
   emptyStateMessage: emptyStateMessageProp,
   initialData = null,
-  initialLastUpdatedLabel = null,
   apiEndpoint,
   MarkdownRenderer = RichMarkdownRenderer,
   documentsEndpoint,
@@ -139,21 +136,16 @@ export function LegalDocumentPage({
   const errorTitle = errorTitleProp ?? `Unable to load ${title}`;
   const emptyStateMessage = emptyStateMessageProp ?? `${title} is not available at this time.`;
 
-  const fallbackLastUpdatedLabel = data?.lastSynced != null ? formatLegalDate(data.lastSynced) : null;
-  const effectiveLastUpdatedLabel = initialLastUpdatedLabel ?? fallbackLastUpdatedLabel;
-
   // Subtitle routes through the frozen `PageLayout` `TitleBlock` (text-h2 title
   // + subtitle) — unified header across all help-center pages. A document that
   // states its own version and effective date shows those (they are what a
-  // reader agreed to); one that states neither shows when it was last read
-  // from its source, else the fallback description.
-  const subtitle =
-    legalDocumentStampLabel(data) ??
-    (effectiveLastUpdatedLabel ? `Last Updated: ${effectiveLastUpdatedLabel}` : fallbackDescription);
+  // reader agreed to), else the fallback description. When it was last read from
+  // its repository is the shared sync line under the title.
+  const subtitle = legalDocumentStampLabel(data) ?? fallbackDescription;
 
   const inner = (
     <PageLayout title={title} subtitle={subtitle} backButton={backCfg} titleSize="h1" titleWrap>
-      {data?.sourceFile && <p className="text-ods-text-secondary opacity-75 text-h6">Source: {data.sourceFile}</p>}
+      <DataSyncLine sync={data ? { source: 'github', syncedAt: data.lastSynced } : null} loading={isLoading && !data} />
 
       <div className="flex flex-1 flex-col items-start gap-6 lg:flex-row lg:gap-10">
         <div className="flex-1">

package/src/components/shared/roadmap/roadmap-view.tsx

@@ -15,15 +15,20 @@ import { useMemo } from 'react';
 import { useSearchParams } from '../../../embed-shims';
 import { useScrollToHash } from '../../../hooks/use-scroll-to-hash';
 import { useSelfFetch } from '../../../hooks/use-self-fetch';
+import type { DataSync } from '../../../types/data-sync';
 import { DEV_SECTION_PARAM_KEYS } from '../../../utils/dev-sections/dev-section-param-keys';
 import { STICKY_HEADER_OFFSET_PX } from '../../../utils/same-page-hash-nav';
 import type { RoadmapItem } from '../../chat/types/entities/roadmap-item';
+import { usePageDataSync } from '../../layout/page-data-sync';
+import { DataSyncLine } from '../../ui/data-attribution';
 import { LoadError } from '../../ui/error-state';
 import { RoadmapGrid } from './roadmap-grid';
 import { RoadmapGridSkeleton } from './roadmap-grid-skeleton';
 import type { UseRoadmapVotingOptions } from './use-roadmap-voting';
 
 const DEFAULT_ENDPOINT = '/api/roadmap';
+/** The list under its sync line (the line the endpoint's `sync` states). */
+const SYNCED_LIST_CLASS = 'flex w-full flex-col gap-[var(--spacing-system-lf)]';
 // Defaults sourced from the ONE param-key registry the chrome (OPENFRAME_DEV_SECTIONS) also
 // reads, so the chrome's written `?key=` and this view's read can't silently diverge.
 const DEFAULT_SEARCH_PARAM_KEY = DEV_SECTION_PARAM_KEYS.search;
@@ -73,7 +78,9 @@ export function RoadmapView({
   // hook's initialData re-sync effect fires every render and clobbers the
   // optimistic vote patch below.
   const initialData = useMemo(() => (initialItems ? { items: initialItems } : undefined), [initialItems]);
-  const { data, setData, isLoading, error, reload } = useSelfFetch<{ items?: RoadmapItem[] }>(url, { initialData });
+  const { data, setData, isLoading, error, reload } = useSelfFetch<{ items?: RoadmapItem[]; sync?: DataSync }>(url, {
+    initialData,
+  });
   const items = data?.items ?? [];
 
   // Deep-link hash dispatch — `?search=<id>#roadmap-<id>` from a chat card.
@@ -84,6 +91,8 @@ export function RoadmapView({
   // them when `hasActiveFilters` is true (chat URL carries `?search=<id>`).
   // The card mounts one tick after `data` lands; the hook waits.
   useScrollToHash(data, { headerOffset: STICKY_HEADER_OFFSET_PX });
+  // The page states the sync under its title; a roadmap shown without that page draws it above the list.
+  const syncInPage = usePageDataSync(data?.sync, isLoading && !data);
 
   if (error) {
     return <LoadError message="Failed to load roadmap." onRetry={reload} />;
@@ -91,27 +100,35 @@ export function RoadmapView({
   // Skeleton only while the FIRST fetch is in flight (no data yet) — a malformed
   // body lacking `items` renders the grid (empty), never a stuck skeleton.
   if (isLoading && !data) {
-    return <RoadmapGridSkeleton showLeftMargin={showLeftMargin} />;
+    return (
+      <div className={SYNCED_LIST_CLASS}>
+        {!syncInPage && <DataSyncLine loading />}
+        <RoadmapGridSkeleton showLeftMargin={showLeftMargin} />
+      </div>
+    );
   }
 
   return (
-    <RoadmapGrid
-      items={items}
-      showLeftMargin={showLeftMargin}
-      buildRefreshUrl={buildRefreshUrl}
-      votingOptions={votingOptions}
-      // Full-page roadmap → collapsible quarter grouping (the shared RoadmapGrid
-      // capability; flat grids stay the RoadmapGrid default). When the chrome's
-      // search / status filter is active, expand every quarter so matches aren't hidden.
-      groupByQuarter
-      hasActiveFilters={search !== '' || status !== 'all'}
-      // After a vote refreshes a single task, patch it into the fetched list so
-      // the displayed counts stay live.
-      onItemUpdate={updated =>
-        setData(prev =>
-          prev ? { ...prev, items: (prev.items ?? []).map(it => (it.id === updated.id ? updated : it)) } : prev,
-        )
-      }
-    />
+    <div className={SYNCED_LIST_CLASS}>
+      {!syncInPage && <DataSyncLine sync={data?.sync} />}
+      <RoadmapGrid
+        items={items}
+        showLeftMargin={showLeftMargin}
+        buildRefreshUrl={buildRefreshUrl}
+        votingOptions={votingOptions}
+        // Full-page roadmap → collapsible quarter grouping (the shared RoadmapGrid
+        // capability; flat grids stay the RoadmapGrid default). When the chrome's
+        // search / status filter is active, expand every quarter so matches aren't hidden.
+        groupByQuarter
+        hasActiveFilters={search !== '' || status !== 'all'}
+        // After a vote refreshes a single task, patch it into the fetched list so
+        // the displayed counts stay live.
+        onItemUpdate={updated =>
+          setData(prev =>
+            prev ? { ...prev, items: (prev.items ?? []).map(it => (it.id === updated.id ? updated : it)) } : prev,
+          )
+        }
+      />
+    </div>
   );
 }

package/src/components/tickets/hooks/use-tickets-list.ts

@@ -21,6 +21,7 @@
 
 import { useQuery } from '@tanstack/react-query';
 import { useRequiredChatRuntime } from '../../../contexts/chat-runtime-context';
+import type { DataSync } from '../../../types/data-sync';
 import { embedAuthedFetch } from '../../../utils/embed-authed-fetch';
 import { PAGE_PARAM_LIMITS, pageCount, positiveInt } from '../../../utils/search-params';
 import type { TicketData } from '../types';
@@ -36,6 +37,8 @@ interface FindTicketResponse {
   pageSize?: number;
   totalPages?: number;
   scope?: 'self' | 'all';
+  /** Where the tickets are mirrored from and when it last read them. */
+  sync?: DataSync;
 }
 
 export interface UseTicketsListFilters {
@@ -71,6 +74,9 @@ export interface UseTicketsListReturn {
   /** Wall-clock timestamp of the last successful fetch; null while
    *  loading the first time. */
   lastUpdatedAt: number | null;
+  /** Where the tickets are mirrored from and when that mirror last read them (the endpoint's `sync`); null when the
+   *  host states none. */
+  sync: DataSync | null;
   /** Total ticket count across all pages (NOT just the current page).
    *  Drives the `<UnifiedPagination>` total-pages calculation. */
   totalCount: number;
@@ -168,6 +174,7 @@ export function useTicketsList(filters: UseTicketsListFilters): UseTicketsListRe
       void query.refetch();
     },
     lastUpdatedAt: query.dataUpdatedAt || null,
+    sync: data?.sync ?? null,
     totalCount,
     page: echoedPage,
     pageSize: echoedPageSize,

package/src/components/tickets/ticket-center.tsx

@@ -19,14 +19,15 @@ import { useQueryClient } from '@tanstack/react-query';
 import { RefreshCw } from 'lucide-react';
 import { useCallback, useState } from 'react';
 import { toast as defaultToast } from '../../hooks/use-toast';
-import { formatRelativeTime } from '../../utils/date-utils';
 import { devSectionAnchorId } from '../../utils/dev-sections/dev-section-param-keys';
 import { useChatIdentity } from '../chat/hooks/use-chat-identity';
 import { EmptyState } from '../empty-state';
+import { usePageDataSync } from '../layout/page-data-sync';
 import { LoadingRegion } from '../loading/loading-region';
 import { UnifiedSkeleton } from '../loading/unified-skeleton';
 import { Button } from '../ui/button';
 import { Card } from '../ui/card';
+import { DataSyncLine } from '../ui/data-attribution';
 import { useTicketActions } from './hooks/use-ticket-actions';
 import { useTicketsList } from './hooks/use-tickets-list';
 import { TicketOpenForm } from './ticket-open-form';
@@ -71,7 +72,7 @@ function TicketCenterAuthed({
   sessionEmail: string;
 }) {
   const queryClient = useQueryClient();
-  const { tickets, isLoading, isFetching, refetch, lastUpdatedAt } = useTicketsList({
+  const { tickets, isLoading, isFetching, refetch, sync } = useTicketsList({
     customerEmail: sessionEmail,
   });
   const [optimisticTickets, setOptimisticTickets] = useState<OptimisticTicket[]>([]);
@@ -117,6 +118,9 @@ function TicketCenterAuthed({
     setExpandedTicketId(prev => (prev === id ? null : id));
   }, []);
 
+  // The page states the sync under its title; the ticket list shown without that page draws it in its own header.
+  const syncInPage = usePageDataSync(sync, isLoading);
+
   const merged: AnyTicket[] = [...optimisticTickets, ...tickets];
 
   return (
@@ -131,7 +135,7 @@ function TicketCenterAuthed({
         <div className="flex items-center justify-between gap-3">
           <p className="text-ods-text-secondary text-h5">Your Current Tickets</p>
           <div className="flex items-center gap-3 text-ods-text-secondary text-h6">
-            {lastUpdatedAt && <span>Updated {formatRelativeTime(new Date(lastUpdatedAt))}</span>}
+            {!syncInPage && <DataSyncLine sync={sync} inline />}
             <Button
               type="button"
               variant="transparent"

package/src/components/ui/data-attribution.tsx

@@ -1,5 +1,9 @@
 import type { ReactNode } from 'react';
+import { DATA_SYNC_SOURCES, type DataSync, type DataSyncSource } from '../../types/data-sync';
 import { formatDate } from '../../utils/format';
+import { ClickupIcon } from '../icons-v2-generated/brand-logos/clickup-icon';
+import { GithubClassicIcon } from '../icons-v2-generated/brand-logos/github-classic-icon';
+import { HubspotIcon } from '../icons-v2-generated/brand-logos/hubspot-icon';
 import { TextSkeleton, UnifiedSkeleton } from '../loading/unified-skeleton';
 
 export interface DataAttributionProps {
@@ -61,3 +65,43 @@ export function DataAttributionSkeleton() {
     </div>
   );
 }
+
+/** The mark each sync source is drawn with (the app's standard brand marks); its name is `DATA_SYNC_SOURCES`'. */
+const DATA_SYNC_ICONS: Record<DataSyncSource, typeof ClickupIcon> = {
+  clickup: ClickupIcon,
+  hubspot: HubspotIcon,
+  github: GithubClassicIcon,
+};
+
+/**
+ * THE sync line of a shared page whose records an API reads from a mirror (the roadmap and the delivery board:
+ * ClickUp; the ticket center: HubSpot; the docs and the legal documents: GitHub). The page draws whatever `sync`
+ * its endpoint answers, so a host that states none shows no line. `loading` draws the line's skeleton, so the page
+ * does not move when it fills in. It sits on its own row, at the end; `inline` leaves it in the caller's row.
+ */
+export function DataSyncLine({
+  sync,
+  loading = false,
+  inline = false,
+  action,
+}: {
+  sync?: DataSync | null;
+  loading?: boolean;
+  inline?: boolean;
+  action?: ReactNode;
+}) {
+  if (!loading && !(sync && sync.source in DATA_SYNC_ICONS)) return null;
+  const Icon = sync ? DATA_SYNC_ICONS[sync.source] : null;
+  const line =
+    loading || !sync || !Icon ? (
+      <DataAttributionSkeleton />
+    ) : (
+      <DataAttribution
+        icon={<Icon size={16} />}
+        source={DATA_SYNC_SOURCES[sync.source]}
+        lastUpdated={sync.syncedAt}
+        action={action}
+      />
+    );
+  return inline ? line : <div className="flex w-full justify-end">{line}</div>;
+}

package/src/types/data-sync.ts

@@ -0,0 +1,26 @@
+/**
+ * Every system a shared page's records are mirrored from, with the name a page shows for it. THE list: `DataSync`,
+ * `DataSyncLine`'s marks, the docs hook and every host that answers a `sync` read it.
+ */
+export const DATA_SYNC_SOURCES = {
+  clickup: 'ClickUp',
+  hubspot: 'HubSpot',
+  github: 'GitHub',
+} as const;
+
+export type DataSyncSource = keyof typeof DATA_SYNC_SOURCES;
+
+export function isDataSyncSource(value: unknown): value is DataSyncSource {
+  return typeof value === 'string' && Object.prototype.hasOwnProperty.call(DATA_SYNC_SOURCES, value);
+}
+
+/**
+ * Where a list's records are mirrored from and when that mirror last read them: the `sync` a shared page's
+ * endpoint answers beside its records, drawn by `DataSyncLine`. Server-safe.
+ */
+export interface DataSync {
+  /** The system the records are read from. */
+  source: DataSyncSource;
+  /** ISO instant of the mirror's last successful read, or null when it never ran. */
+  syncedAt: string | null;
+}

package/src/types/doc-source.ts

@@ -1,3 +1,4 @@
+import type { DataSync } from './data-sync';
 /**
  * Single home for doc-source tree + content types.
  *
@@ -55,6 +56,9 @@ export interface DocContent {
    *  from the underlying row's sync/update timestamp. Undefined when unknown. */
   publishedAt?: string;
   updatedAt?: string;
+  /** Where the document is mirrored from and when it was last read (a synced docs source only); the viewer draws
+   *  it as the shared sync line. */
+  sync?: DataSync;
 }
 
 /**

package/src/types/index.ts

@@ -6,6 +6,7 @@ export * from './announcement';
 // Doc-source viewer types — DocNode / DocContent / DocSourceDal /
 // DocRenderHandlers. Consumed by knowledge-base, data-room, and future
 // doc-source viewers.
+export * from './data-sync';
 export * from './doc-source';
 export type { Category, CategoryCardProps, RealCategoryCardProps } from './categories';
 export * from './category';