@ship-it-ui/shipit 0.0.3 → 0.0.5

package/dist/index.d.cts

@@ -3,6 +3,7 @@ export { cn } from '@ship-it-ui/ui';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, MouseEventHandler, SVGAttributes, Ref } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ConnectorName } from '@ship-it-ui/icons';
 
 /**
  * AskBar — the primary "ask anything" input. The leading ✦ glyph + accent
@@ -28,6 +29,12 @@ interface AskBarProps extends Omit<HTMLAttributes<HTMLFormElement>, 'onSubmit' |
     disabled?: boolean;
     /** Pixel max-width. Default 620. */
     maxWidth?: number | string;
+    /**
+     * `'comfortable'` (default) renders the desktop ask bar. `'touch'` swaps to
+     * the mobile composer: larger text, 44pt send button, ⌘↵ hint hidden (no
+     * hardware keyboard), and scope chips wrap to a second row.
+     */
+    density?: 'comfortable' | 'touch';
 }
 declare const AskBar: react.ForwardRefExoticComponent<AskBarProps & react.RefAttributes<HTMLFormElement>>;
 
@@ -76,6 +83,13 @@ interface CopilotMessageProps extends HTMLAttributes<HTMLDivElement> {
     avatar?: ReactNode;
     /** Streaming caret at the end of the body. */
     streaming?: boolean;
+    /**
+     * `'comfortable'` (default) renders the desktop bubble. `'touch'` switches
+     * to the mobile chat layout: user bubbles right-aligned on `bg-accent`,
+     * assistant bubbles left-aligned on `bg-panel`, larger 15px text, and a
+     * max-width that keeps bubbles within 85% of the viewport.
+     */
+    density?: 'comfortable' | 'touch';
 }
 declare const CopilotMessage: react.ForwardRefExoticComponent<CopilotMessageProps & react.RefAttributes<HTMLDivElement>>;
 
@@ -133,15 +147,75 @@ interface ToolCallCardProps extends HTMLAttributes<HTMLDivElement> {
 declare const ToolCallCard: react.ForwardRefExoticComponent<ToolCallCardProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
- * Canonical ShipIt entity vocabulary. The six types are the categories the
- * graph cares about — anything else is rendered as `service` by default.
+ * ShipIt entity vocabulary. Six built-in categories — `service`, `person`,
+ * `document`, `deployment`, `incident`, `ticket` — cover the graph's core
+ * shapes. The `EntityType` type is intentionally open: consumers may pass any
+ * string and register metadata for it via {@link registerEntityType} so their
+ * domain types (Repository, Pipeline, Monitor, …) render with the right glyph,
+ * label, and tone.
+ *
+ * Unregistered types fall back to the `service` visuals so a stray value never
+ * crashes the UI; consumers can detect them via the `data-entity-type` attribute
+ * that entity components forward to the DOM.
+ */
+type KnownEntityType = 'service' | 'person' | 'document' | 'deployment' | 'incident' | 'ticket';
+type EntityType = KnownEntityType | (string & {});
+/**
+ * Variant key for the shared `Badge` component in `@ship-it-ui/ui`. Inlined here
+ * to keep `types.ts` free of cross-package value imports.
+ */
+type EntityBadgeVariant = 'neutral' | 'accent' | 'ok' | 'warn' | 'err' | 'purple' | 'pink';
+interface EntityTypeMeta {
+    /** Single-character glyph rendered next to the type label. */
+    glyph: string;
+    /** Human-readable type name (e.g. `'Service'`). */
+    label: string;
+    /** Tailwind text-color class for the glyph and accent text. */
+    toneClass: string;
+    /** Tailwind background-color class for the icon plate. */
+    toneBg: string;
+    /** CSS color value used by graph chrome (node ring + legend dot). */
+    colorVar: string;
+    /** Variant for the shared `Badge` component. */
+    badgeVariant: EntityBadgeVariant;
+}
+/**
+ * Register or replace metadata for an entity type. Pass any string key — the
+ * built-in six can be overridden too. Returns the registered metadata.
+ */
+declare function registerEntityType(type: string, meta: EntityTypeMeta): EntityTypeMeta;
+/** Bulk-register a map of entity types. */
+declare function registerEntityTypes(map: Record<string, EntityTypeMeta>): void;
+/**
+ * Resolve metadata for an entity type. Unknown types fall back to the `service`
+ * metadata so consumers never crash on a stray value.
  */
-type EntityType = 'service' | 'person' | 'document' | 'deployment' | 'incident' | 'ticket';
-declare const ENTITY_GLYPH: Record<EntityType, string>;
-declare const ENTITY_LABEL: Record<EntityType, string>;
-declare const ENTITY_TONE_CLASS: Record<EntityType, string>;
-declare const ENTITY_TONE_BG: Record<EntityType, string>;
+declare function getEntityTypeMeta(type: EntityType): EntityTypeMeta;
+/**
+ * Snapshot every registered entity type as `[type, meta]` tuples. Used by
+ * downstream packages (e.g. `@ship-it-ui/cytoscape`) to enumerate types when
+ * emitting per-type styles. Cheap — just `Array.from(map)`.
+ */
+declare function listEntityTypes(): ReadonlyArray<readonly [string, EntityTypeMeta]>;
+/** Test-only helper: drop all consumer registrations and re-seed the built-ins. */
+declare function resetEntityTypeRegistry(): void;
+/**
+ * @deprecated Prefer `getEntityTypeMeta(type).glyph`. Retained for the six
+ * built-in types so existing consumers keep working.
+ */
+declare const ENTITY_GLYPH: Record<KnownEntityType, string>;
+/** @deprecated Prefer `getEntityTypeMeta(type).label`. */
+declare const ENTITY_LABEL: Record<KnownEntityType, string>;
+/** @deprecated Prefer `getEntityTypeMeta(type).toneClass`. */
+declare const ENTITY_TONE_CLASS: Record<KnownEntityType, string>;
+/** @deprecated Prefer `getEntityTypeMeta(type).toneBg`. */
+declare const ENTITY_TONE_BG: Record<KnownEntityType, string>;
 
+/**
+ * EntityBadge — small chip identifying an entity type. Resolves the canonical
+ * glyph + label from the type, but accepts a `label` override for cases where
+ * the consumer wants to show the entity's actual name.
+ */
 interface EntityBadgeProps extends Omit<BadgeProps, 'variant'> {
     type: EntityType;
     /** Override the visible label. Defaults to the canonical type label. */
@@ -294,11 +368,18 @@ interface GraphInspectorProps extends Omit<HTMLAttributes<HTMLDivElement>, 'titl
 }
 declare const GraphInspector: react.ForwardRefExoticComponent<GraphInspectorProps & react.RefAttributes<HTMLDivElement>>;
 
+/**
+ * GraphLegend — translucent floating legend panel for the graph viewport.
+ * Use the `entries` prop for the canonical entity-type list, or compose
+ * children directly for a custom legend. Entry colors and labels resolve
+ * through the shared entity-type registry, so consumer-registered types
+ * appear with their own visuals.
+ */
 interface GraphLegendEntry {
     /** Entity type (resolves color + label automatically) or a custom shape. */
     type?: EntityType;
     color?: string;
-    label: ReactNode;
+    label?: ReactNode;
 }
 interface GraphLegendProps extends HTMLAttributes<HTMLDivElement> {
     entries?: ReadonlyArray<GraphLegendEntry>;
@@ -341,9 +422,11 @@ interface GraphMinimapProps extends HTMLAttributes<HTMLDivElement> {
 declare const GraphMinimap: react.ForwardRefExoticComponent<GraphMinimapProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
- * GraphNode — visual representation of a graph node. Six entity-type variants
- * × five states (default, hover, selected, on-path, dimmed). The component
- * itself is presentation-only; pan / zoom / drag is the host's job.
+ * GraphNode — visual representation of a graph node. Resolves color + glyph
+ * from the shared entity-type registry, so consumer-registered types render
+ * with their own visuals. Five states (default, hover, selected, on-path,
+ * dimmed). The component itself is presentation-only; pan / zoom / drag is
+ * the host's job.
  */
 type GraphNodeState = 'default' | 'hover' | 'selected' | 'path' | 'dim';
 interface GraphNodeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
@@ -499,6 +582,42 @@ interface TestimonialProps extends Omit<HTMLAttributes<HTMLElement>, 'cite' | 'r
 }
 declare const Testimonial: react.ForwardRefExoticComponent<TestimonialProps & react.RefAttributes<HTMLElement>>;
 
+/**
+ * ConnectorCard — integration card for "connector hubs". Renders a connector
+ * logo (via `@ship-it-ui/icons` connector glyphs), the connector name, a
+ * sync-state dot, a relative last-sync timestamp, an optional summary, and a
+ * trailing action slot.
+ *
+ * When `onClick` is provided the whole card becomes a button; otherwise it
+ * renders as a plain `<div>`.
+ */
+type ConnectorStatus = 'connected' | 'syncing' | 'error' | 'disconnected';
+interface ConnectorCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'onClick'> {
+    /** Connector name keyed into `@ship-it-ui/icons` connectorGlyphs. */
+    connector: ConnectorName | (string & {});
+    /** Display name shown next to the logo. */
+    name: ReactNode;
+    /** Sync status. Drives the status dot tone + the default status label. */
+    status: ConnectorStatus;
+    /** Last successful sync timestamp. Formatted relative to `relativeNow`. */
+    lastSyncedAt?: Date | string | number;
+    /** Reference time for relative formatting (injectable for tests/SSR). */
+    relativeNow?: Date;
+    /** Free-text summary (e.g. "1,243 docs · 8 channels"). */
+    summary?: ReactNode;
+    /** Trailing action slot — typically a `Button` or `DropdownMenu` trigger. */
+    actions?: ReactNode;
+    /** Click handler. When provided, the card becomes a button. */
+    onClick?: () => void;
+    /**
+     * Accessible name override. Required when `onClick` is set *and* `name` is
+     * not a string — without it the button has no accessible name (axe
+     * `button-name`). Optional otherwise.
+     */
+    accessibleName?: string;
+}
+declare const ConnectorCard: react.ForwardRefExoticComponent<ConnectorCardProps & react.RefAttributes<HTMLDivElement>>;
+
 /**
  * EntityTable — DataTable preset with two ShipIt-aware column helpers:
  * `entityColumn(...)` for the typed name cell and `entityTypeColumn()` for a
@@ -532,4 +651,40 @@ declare function entityTypeColumn<T extends MinimalEntity>(options?: {
     header?: string;
 }): DataTableColumn<T>;
 
-export { AskBar, type AskBarProps, CTAStrip, type CTAStripProps, Citation, type CitationProps, ConfidenceIndicator, type ConfidenceIndicatorProps, type ConfidenceTier, CopilotMessage, type CopilotMessageProps, type CopilotRole, ENTITY_GLYPH, ENTITY_LABEL, ENTITY_TONE_BG, ENTITY_TONE_CLASS, EntityBadge, type EntityBadgeProps, EntityCard, type EntityCardProps, EntityListRow, EntityListRowButton, type EntityListRowButtonProps, EntityListRowDiv, type EntityListRowDivProps, type EntityListRowProps, type EntityStat, EntityTable, type EntityTableProps, type EntityType, type Feature, FeatureGrid, type FeatureGridProps, Footer, type FooterColumn, type FooterLink, type FooterProps, GraphEdge, type GraphEdgeProps, type GraphEdgeStyle, GraphInspector, type GraphInspectorProps, GraphLegend, type GraphLegendEntry, type GraphLegendProps, GraphMinimap, type GraphMinimapProps, GraphNode, type GraphNodeProps, type GraphNodeState, Hero, type HeroProps, type InspectorProperty, type InspectorRelation, type MinimapPoint, type MinimapViewport, PathOverlay, type PathOverlayProps, type PathPoint, PricingCard, type PricingCardProps, ReasoningBlock, type ReasoningBlockProps, ReasoningStep, type ReasoningStepProps, SuggestionChip, type SuggestionChipProps, Testimonial, type TestimonialProps, ToolCallCard, type ToolCallCardProps, entityColumn, entityTypeColumn };
+/**
+ * NotifRow — single row in the mobile Inbox / notification list. Shows an
+ * unread dot (tone-colored), a tight title + body block, and a right-aligned
+ * relative time. Pair with `isFirst` / `isLast` props from a parent list
+ * wrapper to round the corners of the group like an iOS grouped list.
+ *
+ * No desktop sibling — desktop uses the standard `Notifications` flyout
+ * inside CommandPalette. This composite is mobile-only and lives under
+ * `packages/shipit/src/notifications/`.
+ */
+type NotifTone = 'ok' | 'warn' | 'err' | 'neutral';
+interface NotifRowProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Bold first-line summary. */
+    title: ReactNode;
+    /** One-line body underneath. Truncates to a single line for now. */
+    body?: ReactNode;
+    /** Right-aligned relative time string (e.g. `9:32`, `Mon`). */
+    time?: ReactNode;
+    /** Coloring of the unread dot. */
+    tone?: NotifTone;
+    /** When true, render the unread dot. */
+    unread?: boolean;
+    /** Round the top corners — set when this is the first row in a group. */
+    isFirst?: boolean;
+    /** Round the bottom corners — set when this is the last row in a group. */
+    isLast?: boolean;
+    /**
+     * Navigate when the row is tapped. Renders the row as an `<a>` and wins
+     * over `onClick` for the render shape — but any `onClick` you pass is
+     * still forwarded onto the anchor, which is the right place for
+     * analytics callbacks (the link still navigates).
+     */
+    href?: string;
+}
+declare const NotifRow: react.ForwardRefExoticComponent<NotifRowProps & react.RefAttributes<HTMLDivElement>>;
+
+export { AskBar, type AskBarProps, CTAStrip, type CTAStripProps, Citation, type CitationProps, ConfidenceIndicator, type ConfidenceIndicatorProps, type ConfidenceTier, ConnectorCard, type ConnectorCardProps, type ConnectorStatus, CopilotMessage, type CopilotMessageProps, type CopilotRole, ENTITY_GLYPH, ENTITY_LABEL, ENTITY_TONE_BG, ENTITY_TONE_CLASS, EntityBadge, type EntityBadgeProps, type EntityBadgeVariant, EntityCard, type EntityCardProps, EntityListRow, EntityListRowButton, type EntityListRowButtonProps, EntityListRowDiv, type EntityListRowDivProps, type EntityListRowProps, type EntityStat, EntityTable, type EntityTableProps, type EntityType, type EntityTypeMeta, type Feature, FeatureGrid, type FeatureGridProps, Footer, type FooterColumn, type FooterLink, type FooterProps, GraphEdge, type GraphEdgeProps, type GraphEdgeStyle, GraphInspector, type GraphInspectorProps, GraphLegend, type GraphLegendEntry, type GraphLegendProps, GraphMinimap, type GraphMinimapProps, GraphNode, type GraphNodeProps, type GraphNodeState, Hero, type HeroProps, type InspectorProperty, type InspectorRelation, type KnownEntityType, type MinimapPoint, type MinimapViewport, NotifRow, type NotifRowProps, type NotifTone, PathOverlay, type PathOverlayProps, type PathPoint, PricingCard, type PricingCardProps, ReasoningBlock, type ReasoningBlockProps, ReasoningStep, type ReasoningStepProps, SuggestionChip, type SuggestionChipProps, Testimonial, type TestimonialProps, ToolCallCard, type ToolCallCardProps, entityColumn, entityTypeColumn, getEntityTypeMeta, listEntityTypes, registerEntityType, registerEntityTypes, resetEntityTypeRegistry };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { cn } from '@ship-it-ui/ui';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, MouseEventHandler, SVGAttributes, Ref } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ConnectorName } from '@ship-it-ui/icons';
 
 /**
  * AskBar — the primary "ask anything" input. The leading ✦ glyph + accent
@@ -28,6 +29,12 @@ interface AskBarProps extends Omit<HTMLAttributes<HTMLFormElement>, 'onSubmit' |
     disabled?: boolean;
     /** Pixel max-width. Default 620. */
     maxWidth?: number | string;
+    /**
+     * `'comfortable'` (default) renders the desktop ask bar. `'touch'` swaps to
+     * the mobile composer: larger text, 44pt send button, ⌘↵ hint hidden (no
+     * hardware keyboard), and scope chips wrap to a second row.
+     */
+    density?: 'comfortable' | 'touch';
 }
 declare const AskBar: react.ForwardRefExoticComponent<AskBarProps & react.RefAttributes<HTMLFormElement>>;
 
@@ -76,6 +83,13 @@ interface CopilotMessageProps extends HTMLAttributes<HTMLDivElement> {
     avatar?: ReactNode;
     /** Streaming caret at the end of the body. */
     streaming?: boolean;
+    /**
+     * `'comfortable'` (default) renders the desktop bubble. `'touch'` switches
+     * to the mobile chat layout: user bubbles right-aligned on `bg-accent`,
+     * assistant bubbles left-aligned on `bg-panel`, larger 15px text, and a
+     * max-width that keeps bubbles within 85% of the viewport.
+     */
+    density?: 'comfortable' | 'touch';
 }
 declare const CopilotMessage: react.ForwardRefExoticComponent<CopilotMessageProps & react.RefAttributes<HTMLDivElement>>;
 
@@ -133,15 +147,75 @@ interface ToolCallCardProps extends HTMLAttributes<HTMLDivElement> {
 declare const ToolCallCard: react.ForwardRefExoticComponent<ToolCallCardProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
- * Canonical ShipIt entity vocabulary. The six types are the categories the
- * graph cares about — anything else is rendered as `service` by default.
+ * ShipIt entity vocabulary. Six built-in categories — `service`, `person`,
+ * `document`, `deployment`, `incident`, `ticket` — cover the graph's core
+ * shapes. The `EntityType` type is intentionally open: consumers may pass any
+ * string and register metadata for it via {@link registerEntityType} so their
+ * domain types (Repository, Pipeline, Monitor, …) render with the right glyph,
+ * label, and tone.
+ *
+ * Unregistered types fall back to the `service` visuals so a stray value never
+ * crashes the UI; consumers can detect them via the `data-entity-type` attribute
+ * that entity components forward to the DOM.
+ */
+type KnownEntityType = 'service' | 'person' | 'document' | 'deployment' | 'incident' | 'ticket';
+type EntityType = KnownEntityType | (string & {});
+/**
+ * Variant key for the shared `Badge` component in `@ship-it-ui/ui`. Inlined here
+ * to keep `types.ts` free of cross-package value imports.
+ */
+type EntityBadgeVariant = 'neutral' | 'accent' | 'ok' | 'warn' | 'err' | 'purple' | 'pink';
+interface EntityTypeMeta {
+    /** Single-character glyph rendered next to the type label. */
+    glyph: string;
+    /** Human-readable type name (e.g. `'Service'`). */
+    label: string;
+    /** Tailwind text-color class for the glyph and accent text. */
+    toneClass: string;
+    /** Tailwind background-color class for the icon plate. */
+    toneBg: string;
+    /** CSS color value used by graph chrome (node ring + legend dot). */
+    colorVar: string;
+    /** Variant for the shared `Badge` component. */
+    badgeVariant: EntityBadgeVariant;
+}
+/**
+ * Register or replace metadata for an entity type. Pass any string key — the
+ * built-in six can be overridden too. Returns the registered metadata.
+ */
+declare function registerEntityType(type: string, meta: EntityTypeMeta): EntityTypeMeta;
+/** Bulk-register a map of entity types. */
+declare function registerEntityTypes(map: Record<string, EntityTypeMeta>): void;
+/**
+ * Resolve metadata for an entity type. Unknown types fall back to the `service`
+ * metadata so consumers never crash on a stray value.
  */
-type EntityType = 'service' | 'person' | 'document' | 'deployment' | 'incident' | 'ticket';
-declare const ENTITY_GLYPH: Record<EntityType, string>;
-declare const ENTITY_LABEL: Record<EntityType, string>;
-declare const ENTITY_TONE_CLASS: Record<EntityType, string>;
-declare const ENTITY_TONE_BG: Record<EntityType, string>;
+declare function getEntityTypeMeta(type: EntityType): EntityTypeMeta;
+/**
+ * Snapshot every registered entity type as `[type, meta]` tuples. Used by
+ * downstream packages (e.g. `@ship-it-ui/cytoscape`) to enumerate types when
+ * emitting per-type styles. Cheap — just `Array.from(map)`.
+ */
+declare function listEntityTypes(): ReadonlyArray<readonly [string, EntityTypeMeta]>;
+/** Test-only helper: drop all consumer registrations and re-seed the built-ins. */
+declare function resetEntityTypeRegistry(): void;
+/**
+ * @deprecated Prefer `getEntityTypeMeta(type).glyph`. Retained for the six
+ * built-in types so existing consumers keep working.
+ */
+declare const ENTITY_GLYPH: Record<KnownEntityType, string>;
+/** @deprecated Prefer `getEntityTypeMeta(type).label`. */
+declare const ENTITY_LABEL: Record<KnownEntityType, string>;
+/** @deprecated Prefer `getEntityTypeMeta(type).toneClass`. */
+declare const ENTITY_TONE_CLASS: Record<KnownEntityType, string>;
+/** @deprecated Prefer `getEntityTypeMeta(type).toneBg`. */
+declare const ENTITY_TONE_BG: Record<KnownEntityType, string>;
 
+/**
+ * EntityBadge — small chip identifying an entity type. Resolves the canonical
+ * glyph + label from the type, but accepts a `label` override for cases where
+ * the consumer wants to show the entity's actual name.
+ */
 interface EntityBadgeProps extends Omit<BadgeProps, 'variant'> {
     type: EntityType;
     /** Override the visible label. Defaults to the canonical type label. */
@@ -294,11 +368,18 @@ interface GraphInspectorProps extends Omit<HTMLAttributes<HTMLDivElement>, 'titl
 }
 declare const GraphInspector: react.ForwardRefExoticComponent<GraphInspectorProps & react.RefAttributes<HTMLDivElement>>;
 
+/**
+ * GraphLegend — translucent floating legend panel for the graph viewport.
+ * Use the `entries` prop for the canonical entity-type list, or compose
+ * children directly for a custom legend. Entry colors and labels resolve
+ * through the shared entity-type registry, so consumer-registered types
+ * appear with their own visuals.
+ */
 interface GraphLegendEntry {
     /** Entity type (resolves color + label automatically) or a custom shape. */
     type?: EntityType;
     color?: string;
-    label: ReactNode;
+    label?: ReactNode;
 }
 interface GraphLegendProps extends HTMLAttributes<HTMLDivElement> {
     entries?: ReadonlyArray<GraphLegendEntry>;
@@ -341,9 +422,11 @@ interface GraphMinimapProps extends HTMLAttributes<HTMLDivElement> {
 declare const GraphMinimap: react.ForwardRefExoticComponent<GraphMinimapProps & react.RefAttributes<HTMLDivElement>>;
 
 /**
- * GraphNode — visual representation of a graph node. Six entity-type variants
- * × five states (default, hover, selected, on-path, dimmed). The component
- * itself is presentation-only; pan / zoom / drag is the host's job.
+ * GraphNode — visual representation of a graph node. Resolves color + glyph
+ * from the shared entity-type registry, so consumer-registered types render
+ * with their own visuals. Five states (default, hover, selected, on-path,
+ * dimmed). The component itself is presentation-only; pan / zoom / drag is
+ * the host's job.
  */
 type GraphNodeState = 'default' | 'hover' | 'selected' | 'path' | 'dim';
 interface GraphNodeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
@@ -499,6 +582,42 @@ interface TestimonialProps extends Omit<HTMLAttributes<HTMLElement>, 'cite' | 'r
 }
 declare const Testimonial: react.ForwardRefExoticComponent<TestimonialProps & react.RefAttributes<HTMLElement>>;
 
+/**
+ * ConnectorCard — integration card for "connector hubs". Renders a connector
+ * logo (via `@ship-it-ui/icons` connector glyphs), the connector name, a
+ * sync-state dot, a relative last-sync timestamp, an optional summary, and a
+ * trailing action slot.
+ *
+ * When `onClick` is provided the whole card becomes a button; otherwise it
+ * renders as a plain `<div>`.
+ */
+type ConnectorStatus = 'connected' | 'syncing' | 'error' | 'disconnected';
+interface ConnectorCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'onClick'> {
+    /** Connector name keyed into `@ship-it-ui/icons` connectorGlyphs. */
+    connector: ConnectorName | (string & {});
+    /** Display name shown next to the logo. */
+    name: ReactNode;
+    /** Sync status. Drives the status dot tone + the default status label. */
+    status: ConnectorStatus;
+    /** Last successful sync timestamp. Formatted relative to `relativeNow`. */
+    lastSyncedAt?: Date | string | number;
+    /** Reference time for relative formatting (injectable for tests/SSR). */
+    relativeNow?: Date;
+    /** Free-text summary (e.g. "1,243 docs · 8 channels"). */
+    summary?: ReactNode;
+    /** Trailing action slot — typically a `Button` or `DropdownMenu` trigger. */
+    actions?: ReactNode;
+    /** Click handler. When provided, the card becomes a button. */
+    onClick?: () => void;
+    /**
+     * Accessible name override. Required when `onClick` is set *and* `name` is
+     * not a string — without it the button has no accessible name (axe
+     * `button-name`). Optional otherwise.
+     */
+    accessibleName?: string;
+}
+declare const ConnectorCard: react.ForwardRefExoticComponent<ConnectorCardProps & react.RefAttributes<HTMLDivElement>>;
+
 /**
  * EntityTable — DataTable preset with two ShipIt-aware column helpers:
  * `entityColumn(...)` for the typed name cell and `entityTypeColumn()` for a
@@ -532,4 +651,40 @@ declare function entityTypeColumn<T extends MinimalEntity>(options?: {
     header?: string;
 }): DataTableColumn<T>;
 
-export { AskBar, type AskBarProps, CTAStrip, type CTAStripProps, Citation, type CitationProps, ConfidenceIndicator, type ConfidenceIndicatorProps, type ConfidenceTier, CopilotMessage, type CopilotMessageProps, type CopilotRole, ENTITY_GLYPH, ENTITY_LABEL, ENTITY_TONE_BG, ENTITY_TONE_CLASS, EntityBadge, type EntityBadgeProps, EntityCard, type EntityCardProps, EntityListRow, EntityListRowButton, type EntityListRowButtonProps, EntityListRowDiv, type EntityListRowDivProps, type EntityListRowProps, type EntityStat, EntityTable, type EntityTableProps, type EntityType, type Feature, FeatureGrid, type FeatureGridProps, Footer, type FooterColumn, type FooterLink, type FooterProps, GraphEdge, type GraphEdgeProps, type GraphEdgeStyle, GraphInspector, type GraphInspectorProps, GraphLegend, type GraphLegendEntry, type GraphLegendProps, GraphMinimap, type GraphMinimapProps, GraphNode, type GraphNodeProps, type GraphNodeState, Hero, type HeroProps, type InspectorProperty, type InspectorRelation, type MinimapPoint, type MinimapViewport, PathOverlay, type PathOverlayProps, type PathPoint, PricingCard, type PricingCardProps, ReasoningBlock, type ReasoningBlockProps, ReasoningStep, type ReasoningStepProps, SuggestionChip, type SuggestionChipProps, Testimonial, type TestimonialProps, ToolCallCard, type ToolCallCardProps, entityColumn, entityTypeColumn };
+/**
+ * NotifRow — single row in the mobile Inbox / notification list. Shows an
+ * unread dot (tone-colored), a tight title + body block, and a right-aligned
+ * relative time. Pair with `isFirst` / `isLast` props from a parent list
+ * wrapper to round the corners of the group like an iOS grouped list.
+ *
+ * No desktop sibling — desktop uses the standard `Notifications` flyout
+ * inside CommandPalette. This composite is mobile-only and lives under
+ * `packages/shipit/src/notifications/`.
+ */
+type NotifTone = 'ok' | 'warn' | 'err' | 'neutral';
+interface NotifRowProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Bold first-line summary. */
+    title: ReactNode;
+    /** One-line body underneath. Truncates to a single line for now. */
+    body?: ReactNode;
+    /** Right-aligned relative time string (e.g. `9:32`, `Mon`). */
+    time?: ReactNode;
+    /** Coloring of the unread dot. */
+    tone?: NotifTone;
+    /** When true, render the unread dot. */
+    unread?: boolean;
+    /** Round the top corners — set when this is the first row in a group. */
+    isFirst?: boolean;
+    /** Round the bottom corners — set when this is the last row in a group. */
+    isLast?: boolean;
+    /**
+     * Navigate when the row is tapped. Renders the row as an `<a>` and wins
+     * over `onClick` for the render shape — but any `onClick` you pass is
+     * still forwarded onto the anchor, which is the right place for
+     * analytics callbacks (the link still navigates).
+     */
+    href?: string;
+}
+declare const NotifRow: react.ForwardRefExoticComponent<NotifRowProps & react.RefAttributes<HTMLDivElement>>;
+
+export { AskBar, type AskBarProps, CTAStrip, type CTAStripProps, Citation, type CitationProps, ConfidenceIndicator, type ConfidenceIndicatorProps, type ConfidenceTier, ConnectorCard, type ConnectorCardProps, type ConnectorStatus, CopilotMessage, type CopilotMessageProps, type CopilotRole, ENTITY_GLYPH, ENTITY_LABEL, ENTITY_TONE_BG, ENTITY_TONE_CLASS, EntityBadge, type EntityBadgeProps, type EntityBadgeVariant, EntityCard, type EntityCardProps, EntityListRow, EntityListRowButton, type EntityListRowButtonProps, EntityListRowDiv, type EntityListRowDivProps, type EntityListRowProps, type EntityStat, EntityTable, type EntityTableProps, type EntityType, type EntityTypeMeta, type Feature, FeatureGrid, type FeatureGridProps, Footer, type FooterColumn, type FooterLink, type FooterProps, GraphEdge, type GraphEdgeProps, type GraphEdgeStyle, GraphInspector, type GraphInspectorProps, GraphLegend, type GraphLegendEntry, type GraphLegendProps, GraphMinimap, type GraphMinimapProps, GraphNode, type GraphNodeProps, type GraphNodeState, Hero, type HeroProps, type InspectorProperty, type InspectorRelation, type KnownEntityType, type MinimapPoint, type MinimapViewport, NotifRow, type NotifRowProps, type NotifTone, PathOverlay, type PathOverlayProps, type PathPoint, PricingCard, type PricingCardProps, ReasoningBlock, type ReasoningBlockProps, ReasoningStep, type ReasoningStepProps, SuggestionChip, type SuggestionChipProps, Testimonial, type TestimonialProps, ToolCallCard, type ToolCallCardProps, entityColumn, entityTypeColumn, getEntityTypeMeta, listEntityTypes, registerEntityType, registerEntityTypes, resetEntityTypeRegistry };