@startsimpli/ui 0.4.78 → 0.4.80

package/src/components/activity/index.ts

@@ -0,0 +1,51 @@
+/**
+ * @startsimpli/ui/activity — the shared, filterable activity feed
+ * (startsim-768w.19.5).
+ *
+ * A primitive (the generalised `ActivityTimeline`, exported from the package
+ * root) plus the page-level composer `ActivityFeedPanel`, so an app that wants
+ * a "what happened here" surface holds theme classNames and a thin wrapper
+ * instead of its own timeline — rule #9.
+ *
+ * Nothing in here knows which event types exist. Visibility was decided by the
+ * endpoint; the feed renders what it receives, humanising an action it has
+ * never seen rather than dropping or mislabelling it.
+ */
+export { ActivityFeedPanel, type ActivityFeedPanelProps } from './ActivityFeedPanel';
+export {
+  ACTIVITY_FEED_PANEL_DEFAULTS,
+  type ActivityFeedPanelClassNames,
+} from './activity-feed-panel-default-class-names';
+
+export {
+  ActivityFilterBar,
+  activityFilterCount,
+  type ActivityFilterBarProps,
+} from './ActivityFilterBar';
+export {
+  ACTIVITY_FILTER_BAR_DEFAULTS,
+  type ActivityFilterBarClassNames,
+} from './activity-filter-bar-default-class-names';
+
+export {
+  TONE_DOT,
+  SOURCE_NOTE,
+  actionOf,
+  humanizeAction,
+  activityLabel,
+  activityTone,
+  activityHead,
+  toActivityTimelineItems,
+  deriveActivityFilterOptions,
+} from './activity-events';
+
+export type {
+  ActivityClient,
+  ActivityEvent,
+  ActivityEventActor,
+  ActivityFilterOption,
+  ActivityFilterOptions,
+  ActivityFilterValue,
+  ActivityPage,
+  ActivityQuery,
+} from './types';

package/src/components/activity/types.ts

@@ -0,0 +1,94 @@
+/**
+ * @startsimpli/ui/activity — the shapes the shared activity feed renders.
+ *
+ * Structural on purpose: packages/ui imports no API client, so these mirror the
+ * event-stream row without depending on @startsimpli/api. `FoundryActivityEvent`
+ * is assignable to `ActivityEvent`, and so is any other append-only trail with
+ * an action + a timestamp.
+ *
+ * THE UI DECIDES NOTHING ABOUT VISIBILITY. The stream endpoint already filtered
+ * by the caller's resolved permission level, so every row that arrives here is
+ * renderable and there is no vocabulary of known types anywhere below.
+ */
+
+export interface ActivityEventActor {
+  id?: string;
+  email?: string | null;
+  name?: string | null;
+  avatarUrl?: string | null;
+}
+
+/** One row of an append-only event stream. Only `id` + `created_at` are
+ *  required; everything else is per-type detail the renderer treats as
+ *  optional so an unknown type still renders. */
+export interface ActivityEvent {
+  id: string;
+  /** The raw event type as the server names it, e.g. `member_invited`. */
+  action?: string;
+  /** Alias of `action` for streams that name it `type`. */
+  type?: string;
+  target_type?: string;
+  target_id?: string;
+  metadata?: Record<string, unknown>;
+  actor?: ActivityEventActor | null;
+  actor_email?: string | null;
+  /** Lifecycle detail — present on state transitions, null on everything else. */
+  state?: string | null;
+  previous_state?: string | null;
+  source?: string;
+  reason?: string;
+  error?: string;
+  run_id?: string;
+  run_kind?: string;
+  created_at: string;
+}
+
+/** Narrowing the user asked for. Every field can only SUBTRACT from the rows
+ *  the caller's level already permits — a filter is a preference, never an
+ *  access decision. */
+export interface ActivityFilterValue {
+  /** Actor user id or email. */
+  actor?: string;
+  /** One action, or several comma-separated. */
+  action?: string;
+  /** ISO-8601 lower bound on the timestamp (inclusive). */
+  since?: string;
+  /** ISO-8601 upper bound on the timestamp (inclusive). */
+  until?: string;
+  /** Free text. */
+  q?: string;
+}
+
+export interface ActivityQuery extends ActivityFilterValue {
+  page?: number;
+  pageSize?: number;
+  // Index signature so this satisfies an API client's query-params type
+  // (mirrors `FoundryActivityParams`) — the injected client is the app's own.
+  [key: string]: unknown;
+}
+
+export interface ActivityPage {
+  count: number;
+  next?: string | null;
+  previous?: string | null;
+  results: ActivityEvent[];
+}
+
+/**
+ * The one call the feed needs. The consuming app injects its authed client
+ * (`(p) => api.foundry.activity(slug, p)`), which is what keeps @startsimpli/api
+ * out of packages/ui and the app wrapper under ten lines.
+ */
+export interface ActivityClient {
+  list(params: ActivityQuery): Promise<ActivityPage>;
+}
+
+export interface ActivityFilterOption {
+  value: string;
+  label: string;
+}
+
+export interface ActivityFilterOptions {
+  actors: ActivityFilterOption[];
+  actions: ActivityFilterOption[];
+}

package/src/components/index.ts

@@ -154,8 +154,16 @@ export * from './pipeline'
 export * from './calendar'
 
 // Activity components (timeline, quick log, log dialog)
-export { ActivityTimeline } from './ActivityTimeline'
-export type { ActivityTimelineProps, ActivityTimelineItem } from './ActivityTimeline'
+export { ActivityTimeline, actorInitials, dayHeading } from './ActivityTimeline'
+export type {
+  ActivityTimelineProps,
+  ActivityTimelineItem,
+  ActivityTimelineActor,
+  ActivityTone,
+} from './ActivityTimeline'
+// The shared, filterable activity feed: filter bar + page-level composer over
+// any append-only event stream (startsim-768w.19.5).
+export * from './activity'
 export { QuickLogButtons } from './QuickLogButtons'
 export type { QuickLogButtonsProps, QuickLogAction } from './QuickLogButtons'
 export { LogActivityDialog } from './LogActivityDialog'