@caratlogic/design-system 0.1.13 → 0.1.19

package/README.md

@@ -50,4 +50,4 @@ import { Input } from '@caratlogic/design-system/ui';
 yarn install
 yarn build
 yarn test
-``` 
+```  

package/dist/components/molecules/CustomField/CustomField.types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Value and type primitives shared by every custom-field surface —
+ * manufacturing stages and inventory Extra properties alike.
+ *
+ * Feature folders import from here; they never import from each other.
+ */
+/** KYC-aligned set the backends accept. `boolean` is legacy — prefer `toggle`. */
+export type CustomFieldType = 'text' | 'textarea' | 'email' | 'phone' | 'number' | 'date' | 'time' | 'dropdown' | 'radio' | 'checkbox' | 'multiSelect' | 'toggle' | 'boolean' | 'image' | 'file' | 'docsWithExpiry';
+/** An uploaded object, stored verbatim by the backend as an opaque `value`. */
+export interface UploadedFileValue {
+    /** S3 key returned by the presigned-URL flow. */
+    key: string;
+    name: string;
+    url?: string;
+    size?: number;
+    mimeType?: string;
+}
+/** `docsWithExpiry` pairs one upload with an expiry date. */
+export interface DocsWithExpiryValue {
+    file?: UploadedFileValue | null;
+    expiryDate?: string | null;
+}
+/**
+ * Any single value a custom field can hold. Callers with extra cases compose
+ * on top — manufacturing's `StageValue` adds its certificate array.
+ */
+export type FieldValue = string | number | boolean | string[] | UploadedFileValue | DocsWithExpiryValue | null;
+//# sourceMappingURL=CustomField.types.d.ts.map

package/dist/components/molecules/CustomField/CustomField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomField.types.d.ts","sourceRoot":"","sources":["../../../../src/components/molecules/CustomField/CustomField.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kFAAkF;AAClF,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,UAAU,GACV,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,UAAU,GACV,OAAO,GACP,UAAU,GACV,aAAa,GACb,QAAQ,GACR,SAAS,GACT,OAAO,GACP,MAAM,GACN,gBAAgB,CAAC;AAErB,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,EAAE,GACR,iBAAiB,GACjB,mBAAmB,GACnB,IAAI,CAAC"}

package/dist/components/molecules/CustomField/CustomFieldInput.d.ts

@@ -0,0 +1,43 @@
+import type { ReactNode } from 'react';
+import type { FieldValue } from './CustomField.types';
+/** Upload variants, which the caller renders via `renderUpload`. */
+export type CustomFieldUploadVariant = 'image' | 'file' | 'docsWithExpiry';
+export interface CustomFieldDescriptor {
+    /** DOM id / form key for the rendered control. */
+    id: string;
+    type: string;
+    label?: string;
+    placeholder?: string;
+    options?: string[];
+    /** Latest date the picker allows. */
+    maxDate?: Date;
+    expiryDateLabel?: string;
+}
+export interface CustomFieldInputProps {
+    field: CustomFieldDescriptor;
+    value: FieldValue;
+    disabled?: boolean;
+    invalid?: boolean;
+    onChange: (value: FieldValue) => void;
+    /**
+     * Upload control, supplied by the caller. Uploading needs an API client, so
+     * it is injected rather than imported — that is what keeps this component
+     * free of app dependencies.
+     */
+    renderUpload?: (args: {
+        id: string;
+        variant: CustomFieldUploadVariant;
+        value: FieldValue;
+        expiryDateLabel?: string;
+        disabled?: boolean;
+        onChange: (value: FieldValue) => void;
+    }) => ReactNode;
+}
+/**
+ * Renders one control for a field described by `type` and its option metadata.
+ *
+ * Covers the field types shared by every custom-field surface. Types specific
+ * to one feature stay with that feature, which handles them before delegating.
+ */
+export declare function CustomFieldInput({ field, value, disabled, invalid, onChange, renderUpload, }: CustomFieldInputProps): ReactNode;
+//# sourceMappingURL=CustomFieldInput.d.ts.map

package/dist/components/molecules/CustomField/CustomFieldInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomFieldInput.d.ts","sourceRoot":"","sources":["../../../../src/components/molecules/CustomField/CustomFieldInput.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,OAAO,CAAC;AAWrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,oEAAoE;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,wBAAwB,CAAC;QAClC,KAAK,EAAE,UAAU,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;KACvC,KAAK,SAAS,CAAC;CACjB;AAOD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,YAAY,GACb,EAAE,qBAAqB,GAAG,SAAS,CA6LnC"}

package/dist/components/molecules/CustomField/CustomFieldValue.d.ts

@@ -0,0 +1,17 @@
+import type { ReactElement } from 'react';
+import type { FieldValue } from './CustomField.types';
+/** Muted dash, so an uncaptured field reads as blank rather than as a value. */
+export declare const EmptyValue: () => ReactElement;
+export interface CustomFieldValueProps {
+    type: string;
+    value: FieldValue;
+    /** Appended after a numeric value, e.g. `ct`. */
+    unit?: string;
+}
+/**
+ * A captured value rendered for reading rather than editing. Edit forms use
+ * real inputs; a disabled input full of placeholders is much harder to scan
+ * than plain text, and reads as broken rather than empty.
+ */
+export declare function CustomFieldValue({ type, value, unit, }: CustomFieldValueProps): ReactElement;
+//# sourceMappingURL=CustomFieldValue.d.ts.map

package/dist/components/molecules/CustomField/CustomFieldValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CustomFieldValue.d.ts","sourceRoot":"","sources":["../../../../src/components/molecules/CustomField/CustomFieldValue.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAEV,UAAU,EAEX,MAAM,qBAAqB,CAAC;AAmC7B,gFAAgF;AAChF,eAAO,MAAM,UAAU,QAAO,YAE7B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,KAAK,EACL,IAAI,GACL,EAAE,qBAAqB,GAAG,YAAY,CAgDtC"}

package/dist/components/molecules/CustomField/fieldTypeIcon.d.ts

@@ -0,0 +1,4 @@
+import { type LucideIcon } from 'lucide-react';
+/** Glyph for a field type, so a list of fields is scannable at a glance. */
+export declare function fieldTypeIcon(type: string): LucideIcon;
+//# sourceMappingURL=fieldTypeIcon.d.ts.map

package/dist/components/molecules/CustomField/fieldTypeIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldTypeIcon.d.ts","sourceRoot":"","sources":["../../../../src/components/molecules/CustomField/fieldTypeIcon.ts"],"names":[],"mappings":"AAAA,OAAO,EAeL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAqBtB,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEtD"}

package/dist/components/molecules/CustomField/fieldValueHelpers.d.ts

@@ -0,0 +1,10 @@
+import type { FieldValue } from './CustomField.types';
+/** Shown in a read-only control whose value was never filled in. */
+export declare const NOT_CAPTURED = "Not captured";
+export declare const asText: (value: FieldValue) => string;
+export declare const asList: (value: FieldValue) => string[];
+/** Blank for display purposes — a number `0` is a real value, not blank. */
+export declare const isBlank: (value: FieldValue) => boolean;
+/** Treats blank strings, empty arrays and empty upload objects as uncaptured. */
+export declare function isValueEmpty(value: FieldValue | undefined): boolean;
+//# sourceMappingURL=fieldValueHelpers.d.ts.map

package/dist/components/molecules/CustomField/fieldValueHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldValueHelpers.d.ts","sourceRoot":"","sources":["../../../../src/components/molecules/CustomField/fieldValueHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,oEAAoE;AACpE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,eAAO,MAAM,MAAM,GAAI,OAAO,UAAU,KAAG,MACH,CAAC;AAEzC,eAAO,MAAM,MAAM,GAAI,OAAO,UAAU,KAAG,MAAM,EAGzC,CAAC;AAET,4EAA4E;AAC5E,eAAO,MAAM,OAAO,GAAI,OAAO,UAAU,KAAG,OAC0B,CAAC;AAEvE,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAOnE"}

package/dist/components/molecules/CustomField/index.d.ts

@@ -0,0 +1,8 @@
+export { CustomFieldInput } from './CustomFieldInput';
+export { CustomFieldValue, EmptyValue } from './CustomFieldValue';
+export { fieldTypeIcon } from './fieldTypeIcon';
+export { asList, asText, isBlank, isValueEmpty, NOT_CAPTURED, } from './fieldValueHelpers';
+export type { CustomFieldDescriptor, CustomFieldInputProps, CustomFieldUploadVariant, } from './CustomFieldInput';
+export type { CustomFieldValueProps } from './CustomFieldValue';
+export type { CustomFieldType, DocsWithExpiryValue, FieldValue, UploadedFileValue, } from './CustomField.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/molecules/CustomField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/molecules/CustomField/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/components/organisms/ActivityFeed/ActivityFeed.accessibility.d.ts

@@ -0,0 +1,10 @@
+export declare const ACTIVITY_FEED_ARIA: {
+    readonly feedLabel: "Activity feed";
+    readonly expandRow: (summary: string) => string;
+    readonly collapseRow: (summary: string) => string;
+    readonly expandAutomatedGroup: (count: number) => string;
+    readonly collapseAutomatedGroup: (count: number) => string;
+    readonly copyReference: "Copy reference";
+    readonly changesTable: "Fields changed by this entry";
+};
+//# sourceMappingURL=ActivityFeed.accessibility.d.ts.map

package/dist/components/organisms/ActivityFeed/ActivityFeed.accessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFeed.accessibility.d.ts","sourceRoot":"","sources":["../../../../src/components/organisms/ActivityFeed/ActivityFeed.accessibility.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;kCAER,MAAM;oCACJ,MAAM;2CACC,MAAM;6CAEJ,MAAM;;;CAI9B,CAAC"}

package/dist/components/organisms/ActivityFeed/ActivityFeed.components.d.ts

@@ -0,0 +1,22 @@
+import { type ReactElement } from 'react';
+import type { ActivityDayGroup, ActivityEntry, ActivityStatusTone } from './ActivityFeed.types';
+export declare function ActivityDayHeader({ group, }: {
+    group: ActivityDayGroup;
+}): ReactElement;
+interface ActivityRowProps {
+    entry: ActivityEntry;
+    showRail: boolean;
+    statusColors: Record<string, ActivityStatusTone>;
+}
+export declare function ActivityRow({ entry, showRail, statusColors, }: ActivityRowProps): ReactElement;
+interface AutomatedGroupRowProps {
+    entries: ActivityEntry[];
+    statusColors: Record<string, ActivityStatusTone>;
+}
+/**
+ * A run of automated entries folded into one line. Scheduled reminders are the
+ * bulk of a busy day and rarely the thing a reader came for.
+ */
+export declare function ActivityAutomatedGroupRow({ entries, statusColors, }: AutomatedGroupRowProps): ReactElement;
+export {};
+//# sourceMappingURL=ActivityFeed.components.d.ts.map

package/dist/components/organisms/ActivityFeed/ActivityFeed.components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFeed.components.d.ts","sourceRoot":"","sources":["../../../../src/components/organisms/ActivityFeed/ActivityFeed.components.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAgBpD,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,GACN,EAAE;IACD,KAAK,EAAE,gBAAgB,CAAC;CACzB,GAAG,YAAY,CAYf;AA6ND,UAAU,gBAAgB;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAClD;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,YAAY,GACb,EAAE,gBAAgB,GAAG,YAAY,CAyFjC;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,OAAO,EACP,YAAY,GACb,EAAE,sBAAsB,GAAG,YAAY,CAwDvC"}

package/dist/components/organisms/ActivityFeed/ActivityFeed.constants.d.ts

@@ -0,0 +1,19 @@
+import { type LucideIcon } from 'lucide-react';
+import type { ActivityCategory } from './ActivityFeed.types';
+interface CategoryMeta {
+    label: string;
+    icon: LucideIcon;
+    /** Token-based tone for the row's icon disc and the filter pill's dot. */
+    iconClassName: string;
+    dotClassName: string;
+}
+/**
+ * Categories carry both a colour and a distinct icon — the colour alone never
+ * distinguishes them, so the feed stays readable without relying on hue.
+ */
+export declare const ACTIVITY_CATEGORY_META: Record<ActivityCategory, CategoryMeta>;
+export declare const ACTIVITY_CATEGORIES: ActivityCategory[];
+/** Feed grid: time gutter, icon rail, content, expand control. */
+export declare const ACTIVITY_ROW_GRID = "grid grid-cols-[52px_32px_minmax(0,1fr)_36px] gap-x-3";
+export {};
+//# sourceMappingURL=ActivityFeed.constants.d.ts.map

package/dist/components/organisms/ActivityFeed/ActivityFeed.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFeed.constants.d.ts","sourceRoot":"","sources":["../../../../src/components/organisms/ActivityFeed/ActivityFeed.constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,gBAAgB,EAAE,YAAY,CA+BzE,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAE3B,gBAAgB,EAAE,CAAC;AAExB,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,0DAC2B,CAAC"}

package/dist/components/organisms/ActivityFeed/ActivityFeed.d.ts

@@ -0,0 +1,11 @@
+import { type ReactElement } from 'react';
+import type { ActivityFeedProps } from './ActivityFeed.types';
+/**
+ * Day-grouped activity feed: a time gutter, a category icon on a connecting
+ * rail, a one-sentence description, and per-row details on demand.
+ *
+ * Presentational by design — it fetches nothing and knows no domain vocabulary.
+ * The host maps its records to `ActivityEntry` and owns paging via `onLoadMore`.
+ */
+export declare function ActivityFeed({ entries, isLoading, hasMore, isLoadingMore, onLoadMore, groupAutomated, fill, statusColors, emptyMessage, className, }: ActivityFeedProps): ReactElement;
+//# sourceMappingURL=ActivityFeed.d.ts.map

package/dist/components/organisms/ActivityFeed/ActivityFeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFeed.d.ts","sourceRoot":"","sources":["../../../../src/components/organisms/ActivityFeed/ActivityFeed.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAYnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAiB9D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,SAAiB,EACjB,OAAe,EACf,aAAqB,EACrB,UAAU,EACV,cAAqB,EACrB,IAAY,EACZ,YAAiB,EACjB,YAA0C,EAC1C,SAAS,GACV,EAAE,iBAAiB,GAAG,YAAY,CAyElC"}

package/dist/components/organisms/ActivityFeed/ActivityFeed.types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Data contract for the activity feed. Deliberately free of any KYC vocabulary:
+ * the host maps its own records onto these entries, so the feed can be lifted
+ * into the design system and reused by another product unchanged.
+ */
+export type ActivityCategory = 'customer' | 'form' | 'communication' | 'verification' | 'status';
+export type ActivityActorKind = 'admin' | 'customer' | 'system';
+export interface ActivityActor {
+    id?: string;
+    name: string;
+    kind: ActivityActorKind;
+}
+/** Who the entry is about, as recorded at the time it happened. */
+export interface ActivityContact {
+    id?: string;
+    name?: string;
+    company?: string;
+    email?: string;
+    roles?: string[];
+    isActive?: boolean;
+}
+/** One field-level change, rendered as a Before → After row. */
+export interface ActivityChange {
+    field: string;
+    before?: string;
+    after?: string;
+}
+export interface ActivityLink {
+    label: string;
+    onClick: () => void;
+}
+export interface ActivityEntry {
+    id: string;
+    /** ISO timestamp. Drives both the day grouping and the time gutter. */
+    createdAt: string;
+    category: ActivityCategory;
+    actor: ActivityActor;
+    /** Sentence fragment after the actor's name, e.g. "approved KYC for". */
+    action: string;
+    /** Optional linked subject closing the sentence, e.g. the company. */
+    subject?: ActivityLink;
+    /** One muted line under the sentence. Keep it to the essentials. */
+    detail?: string;
+    statusFrom?: string;
+    statusTo?: string;
+    contact?: ActivityContact;
+    changes: ActivityChange[];
+    /**
+     * Show the changes table even when `changes` is empty, to state that a field
+     * diff was expected and none was recorded. Off hides the table entirely, which
+     * is right for events that never describe a change.
+     */
+    changesExpected?: boolean;
+    /** Correlation id shown in the expanded footer. */
+    reference: string;
+    notes?: string;
+    /** Extra links in the expanded footer, e.g. "Open customer". */
+    links?: ActivityLink[];
+}
+export interface ActivityFeedProps {
+    entries: ActivityEntry[];
+    isLoading?: boolean;
+    /** Renders the load-more control when there are older entries to fetch. */
+    hasMore?: boolean;
+    isLoadingMore?: boolean;
+    onLoadMore?: () => void;
+    /**
+     * Collapse consecutive automated entries on the same day into one row that
+     * expands on demand. Off leaves every automated entry in place.
+     */
+    groupAutomated?: boolean;
+    /**
+     * Stretch to the host's height. Off (the default) leaves the feed sized to its
+     * content, which is what a page that scrolls as a whole wants.
+     */
+    fill?: boolean;
+    /** Tone map for the status chips, keyed by status label. */
+    statusColors?: Record<string, ActivityStatusTone>;
+    emptyMessage?: string;
+    className?: string;
+}
+export type ActivityStatusTone = 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'destructive';
+/** A day's worth of entries, newest-first or oldest-first as supplied. */
+export interface ActivityDayGroup {
+    key: string;
+    /** "Today" / "Yesterday" / weekday name. */
+    label: string;
+    /** Full date, shown beside the label. */
+    dateLabel: string;
+    rows: ActivityRowItem[];
+    count: number;
+}
+/** A feed row is either one entry or a collapsed run of automated ones. */
+export type ActivityRowItem = {
+    kind: 'entry';
+    entry: ActivityEntry;
+} | {
+    kind: 'automated-group';
+    id: string;
+    entries: ActivityEntry[];
+};
+//# sourceMappingURL=ActivityFeed.types.d.ts.map

package/dist/components/organisms/ActivityFeed/ActivityFeed.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFeed.types.d.ts","sourceRoot":"","sources":["../../../../src/components/organisms/ActivityFeed/ActivityFeed.types.ts"],"names":[],"mappings":"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"}

package/dist/components/organisms/ActivityFeed/ActivityFeed.utils.d.ts

@@ -0,0 +1,12 @@
+import type { ActivityDayGroup, ActivityEntry } from './ActivityFeed.types';
+export declare function formatActivityTime(iso: string): string;
+/**
+ * Bucket entries by calendar day, preserving the order they arrive in so the
+ * caller keeps control of newest-first vs oldest-first.
+ */
+export declare function groupActivityByDay(entries: ActivityEntry[], groupAutomated: boolean, now?: Date): ActivityDayGroup[];
+/** Initials for the contact avatar, capped at two letters. */
+export declare function initialsOf(name: string): string;
+/** Shortens a correlation id so it never pushes the footer's actions off-row. */
+export declare function truncateReference(reference: string, max?: number): string;
+//# sourceMappingURL=ActivityFeed.utils.d.ts.map

package/dist/components/organisms/ActivityFeed/ActivityFeed.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityFeed.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/organisms/ActivityFeed/ActivityFeed.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAEd,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQtD;AAgED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EAAE,EACxB,cAAc,EAAE,OAAO,EACvB,GAAG,GAAE,IAAiB,GACrB,gBAAgB,EAAE,CAyBpB;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,CAErE"}

package/dist/components/organisms/ActivityFeed/index.d.ts

@@ -0,0 +1,4 @@
+export { ActivityFeed } from './ActivityFeed';
+export { ACTIVITY_CATEGORIES, ACTIVITY_CATEGORY_META, } from './ActivityFeed.constants';
+export type { ActivityActor, ActivityActorKind, ActivityCategory, ActivityChange, ActivityContact, ActivityDayGroup, ActivityEntry, ActivityFeedProps, ActivityLink, ActivityRowItem, ActivityStatusTone, } from './ActivityFeed.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/organisms/ActivityFeed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/organisms/ActivityFeed/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}