eidotter 0.20.1 → 0.21.0

package/dist/components/TimelineContainer/components/TimelineContainer.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { TimelineEntryData, ZoomLevel } from './types';
+import type { TimelineEntryData, TimelineRenderEntry, ZoomLevel } from './types';
 import './TimelineContainer.css';
 import './views/views.css';
 export interface TimelineContainerProps extends React.HTMLAttributes<HTMLDivElement> {
@@ -8,10 +8,13 @@ export interface TimelineContainerProps extends React.HTMLAttributes<HTMLDivElem
     /**
      * Display mode
      * - "interactive" (default): zoom controls, selection, keyboard shortcuts
-     * - "static": read-only vertical feed of expandable entries (replaces TimelineList)
+     * - "static": read-only vertical feed of always-expanded entries (replaces TimelineList)
+     * - "feed": paginated vertical list with collapsed-by-default entries that
+     *   expand on selection. Renders a DOS-style "LOAD MORE..." button while
+     *   more entries are available. No zoom controls.
      * @default 'interactive'
      */
-    mode?: 'interactive' | 'static';
+    mode?: 'interactive' | 'static' | 'feed';
     /**
      * Controlled zoom level — overrides internal state when provided.
      * Use with `onZoomChange` for full control. Disables drill-down navigation.
@@ -51,6 +54,27 @@ export interface TimelineContainerProps extends React.HTMLAttributes<HTMLDivElem
      * @default true
      */
     keyboardShortcuts?: boolean;
+    /**
+     * Pluggable entry renderer. When provided, this is called for every entry
+     * in every zoom-level view (and in static / feed modes) instead of rendering
+     * the built-in `TimelineEntryCard`. Return `context.defaultRender()` to keep
+     * the default card for some entries while customising others.
+     *
+     * Use this to render different card UIs per entry type — blog posts,
+     * photos, financial records, etc.
+     */
+    renderEntry?: TimelineRenderEntry;
+    /**
+     * Number of entries to show per page in feed mode. Ignored for other modes.
+     * @default 10
+     */
+    pageSize?: number;
+    /**
+     * Fired in feed mode after the user clicks "LOAD MORE…", with the new total
+     * number of visible entries. Use this to fetch the next batch from a backend
+     * and append to `entries`, or for analytics.
+     */
+    onLoadMore?: (visibleCount: number) => void;
 }
 /**
  * TimelineContainer - Interactive multi-level zoom timeline

package/dist/components/TimelineContainer/components/TimelineContent.d.ts

@@ -1,11 +1,12 @@
 import React from 'react';
-import type { ZoomLevel, DateBucket } from './types';
+import type { ZoomLevel, DateBucket, TimelineRenderEntry } from './types';
 export interface TimelineContentProps {
     zoomLevel: ZoomLevel;
     buckets: readonly DateBucket[];
     selectedEntryId: string | null;
     onEntrySelect?: (entryId: string) => void;
     onBucketClick?: (bucket: DateBucket) => void;
+    renderEntry?: TimelineRenderEntry;
 }
 /**
  * View switcher that renders the appropriate zoom level view.

package/dist/components/TimelineContainer/components/index.d.ts

@@ -1,5 +1,5 @@
 export { TimelineContainer } from './TimelineContainer';
 export type { TimelineContainerProps } from './TimelineContainer';
 export { ZOOM_LEVELS } from './types';
-export type { TimelineEntry, TimelineEntryData, DateBucket, ZoomLevel } from './types';
+export type { TimelineEntry, TimelineEntryData, TimelineEntryRenderContext, TimelineRenderEntry, DateBucket, ZoomLevel, } from './types';
 export type { DrillDownEntry, UseDrillDownReturn } from './useDrillDown';

package/dist/components/TimelineContainer/components/types.d.ts

@@ -27,6 +27,24 @@ export interface TimelineEntryData {
  * @deprecated Use TimelineEntryData instead.
  */
 export type TimelineEntry = TimelineEntryData;
+/**
+ * Context passed to a `renderEntry` function so consumers can decide how
+ * to render their custom entry, while still being able to fall back to
+ * the built-in `TimelineEntryCard` rendering when needed.
+ */
+export interface TimelineEntryRenderContext {
+    /** True when this entry is currently expanded (its content is visible). */
+    isExpanded: boolean;
+    /** True when this entry is the currently selected entry. */
+    isSelected: boolean;
+    /** Render the built-in `TimelineEntryCard` for this entry. */
+    defaultRender: () => ReactNode;
+}
+/**
+ * Pluggable entry renderer. Return `defaultRender()` to delegate back to the
+ * built-in card, or any custom ReactNode to take over the entry slot.
+ */
+export type TimelineRenderEntry = (entry: TimelineEntryData, context: TimelineEntryRenderContext) => ReactNode;
 export interface DateBucket {
     /** Human-readable label, e.g. "2024", "March 2024", "Mar 15" */
     label: string;
@@ -45,4 +63,6 @@ export interface TimelineViewProps {
     selectedEntryId?: string | null;
     /** Callback when a bucket header is clicked (for drill-down) */
     onBucketClick?: (bucket: DateBucket) => void;
+    /** Optional pluggable entry renderer */
+    renderEntry?: TimelineRenderEntry;
 }

package/dist/components/TimelineContainer/index.d.ts

@@ -1,3 +1,3 @@
 export { TimelineContainer } from './components';
-export type { TimelineContainerProps, TimelineEntry, TimelineEntryData, DateBucket, ZoomLevel } from './components';
+export type { TimelineContainerProps, TimelineEntry, TimelineEntryData, TimelineEntryRenderContext, TimelineRenderEntry, DateBucket, ZoomLevel, } from './components';
 export { ZOOM_LEVELS } from './components';