@ship-it-ui/shipit 0.0.2 → 0.0.4

package/dist/index.d.cts

@@ -1,8 +1,9 @@
-import { BadgeProps } from '@ship-it-ui/ui';
+import { BadgeProps, DataTableProps, DataTableColumn } from '@ship-it-ui/ui';
 export { cn } from '@ship-it-ui/ui';
 import * as react from 'react';
-import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, MouseEventHandler, SVGAttributes } 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
@@ -133,15 +134,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 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>;
+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.
+ */
+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 +355,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 +409,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'> {
@@ -456,14 +526,22 @@ declare const Hero: react.ForwardRefExoticComponent<HeroProps & react.RefAttribu
  * PricingCard — single tier in a pricing table. Shows tier name, price,
  * description, list of features (with ✓ markers), and an action button slot.
  *
+ * The card establishes a CSS container, so the price scales with the card's
+ * own inline-size rather than the viewport — when three cards crowd into a
+ * narrow column the price doesn't blow out the layout.
+ *
  * Pass `featured` to highlight the card with an accent border + tinted
- * background for the "recommended" tier.
+ * background for the "recommended" tier. Use `priceUnit` for per-period
+ * suffixes (e.g. `/ user / mo`) so the unit lays out next to the price
+ * baseline-aligned and wraps cleanly when there isn't room.
  */
 interface PricingCardProps extends HTMLAttributes<HTMLDivElement> {
     /** Tier name — e.g., `Pro`, `Team`. */
     tier: ReactNode;
-    /** Price. Pass JSX (`<span>$29</span><span> / mo</span>`) for layout. */
+    /** Headline price, e.g. `$29` or `Talk to us`. */
     price: ReactNode;
+    /** Optional small unit rendered next to the price, e.g. `/ user / mo`. */
+    priceUnit?: ReactNode;
     /** Short description below the tier name. */
     description?: ReactNode;
     /** Feature bullet list. */
@@ -491,4 +569,73 @@ interface TestimonialProps extends Omit<HTMLAttributes<HTMLElement>, 'cite' | 'r
 }
 declare const Testimonial: react.ForwardRefExoticComponent<TestimonialProps & react.RefAttributes<HTMLElement>>;
 
-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, 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 };
+/**
+ * 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
+ * standalone type column. Everything else (sort, selection, sticky header)
+ * comes from `@ship-it-ui/ui` DataTable as-is.
+ */
+interface MinimalEntity {
+    id: string;
+    type: EntityType;
+    name: string;
+}
+type EntityTableProps<T extends MinimalEntity> = Omit<DataTableProps<T>, 'rowKey'> & {
+    rowKey?: (row: T) => string;
+};
+declare function EntityTable<T extends MinimalEntity>(props: EntityTableProps<T> & {
+    ref?: Ref<HTMLTableElement>;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Pre-built column for the entity name. Renders the type glyph (in the type's
+ * tone) followed by the name in mono. Sorts on `name`.
+ */
+declare function entityColumn<T extends MinimalEntity>(options?: {
+    key?: string;
+    header?: string;
+}): DataTableColumn<T>;
+/**
+ * Pre-built column rendering the canonical EntityBadge.
+ */
+declare function entityTypeColumn<T extends MinimalEntity>(options?: {
+    key?: string;
+    header?: string;
+}): DataTableColumn<T>;
+
+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, 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

@@ -1,8 +1,9 @@
-import { BadgeProps } from '@ship-it-ui/ui';
+import { BadgeProps, DataTableProps, DataTableColumn } from '@ship-it-ui/ui';
 export { cn } from '@ship-it-ui/ui';
 import * as react from 'react';
-import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, MouseEventHandler, SVGAttributes } 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
@@ -133,15 +134,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 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>;
+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.
+ */
+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 +355,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 +409,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'> {
@@ -456,14 +526,22 @@ declare const Hero: react.ForwardRefExoticComponent<HeroProps & react.RefAttribu
  * PricingCard — single tier in a pricing table. Shows tier name, price,
  * description, list of features (with ✓ markers), and an action button slot.
  *
+ * The card establishes a CSS container, so the price scales with the card's
+ * own inline-size rather than the viewport — when three cards crowd into a
+ * narrow column the price doesn't blow out the layout.
+ *
  * Pass `featured` to highlight the card with an accent border + tinted
- * background for the "recommended" tier.
+ * background for the "recommended" tier. Use `priceUnit` for per-period
+ * suffixes (e.g. `/ user / mo`) so the unit lays out next to the price
+ * baseline-aligned and wraps cleanly when there isn't room.
  */
 interface PricingCardProps extends HTMLAttributes<HTMLDivElement> {
     /** Tier name — e.g., `Pro`, `Team`. */
     tier: ReactNode;
-    /** Price. Pass JSX (`<span>$29</span><span> / mo</span>`) for layout. */
+    /** Headline price, e.g. `$29` or `Talk to us`. */
     price: ReactNode;
+    /** Optional small unit rendered next to the price, e.g. `/ user / mo`. */
+    priceUnit?: ReactNode;
     /** Short description below the tier name. */
     description?: ReactNode;
     /** Feature bullet list. */
@@ -491,4 +569,73 @@ interface TestimonialProps extends Omit<HTMLAttributes<HTMLElement>, 'cite' | 'r
 }
 declare const Testimonial: react.ForwardRefExoticComponent<TestimonialProps & react.RefAttributes<HTMLElement>>;
 
-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, 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 };
+/**
+ * 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
+ * standalone type column. Everything else (sort, selection, sticky header)
+ * comes from `@ship-it-ui/ui` DataTable as-is.
+ */
+interface MinimalEntity {
+    id: string;
+    type: EntityType;
+    name: string;
+}
+type EntityTableProps<T extends MinimalEntity> = Omit<DataTableProps<T>, 'rowKey'> & {
+    rowKey?: (row: T) => string;
+};
+declare function EntityTable<T extends MinimalEntity>(props: EntityTableProps<T> & {
+    ref?: Ref<HTMLTableElement>;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Pre-built column for the entity name. Renders the type glyph (in the type's
+ * tone) followed by the name in mono. Sorts on `name`.
+ */
+declare function entityColumn<T extends MinimalEntity>(options?: {
+    key?: string;
+    header?: string;
+}): DataTableColumn<T>;
+/**
+ * Pre-built column rendering the canonical EntityBadge.
+ */
+declare function entityTypeColumn<T extends MinimalEntity>(options?: {
+    key?: string;
+    header?: string;
+}): DataTableColumn<T>;
+
+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, 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 };