@ship-it-ui/shipit 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -1,9 +1,8 @@
-import { ClassValue } from 'clsx';
+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, SVGAttributes } from 'react';
-import { BadgeProps } from '@ship-it-ui/ui';
-
-declare function cn(...inputs: ClassValue[]): string;
+import { HTMLAttributes, ReactNode, ButtonHTMLAttributes, MouseEventHandler, SVGAttributes, Ref } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * AskBar — the primary "ask anything" input. The leading ✦ glyph + accent
@@ -32,7 +31,7 @@ interface AskBarProps extends Omit<HTMLAttributes<HTMLFormElement>, 'onSubmit' |
 }
 declare const AskBar: react.ForwardRefExoticComponent<AskBarProps & react.RefAttributes<HTMLFormElement>>;
 
-interface CitationProps extends HTMLAttributes<HTMLSpanElement> {
+interface CitationProps extends HTMLAttributes<HTMLElement> {
     /** Citation number (1-indexed). */
     index: number;
     /** Source label — e.g., `runbook-oncall.md:L42`. */
@@ -42,7 +41,7 @@ interface CitationProps extends HTMLAttributes<HTMLSpanElement> {
     /** Inline superscript variant (renders the number only, no source row). */
     inline?: boolean;
 }
-declare const Citation: react.ForwardRefExoticComponent<CitationProps & react.RefAttributes<HTMLSpanElement>>;
+declare const Citation: react.ForwardRefExoticComponent<CitationProps & react.RefAttributes<HTMLElement>>;
 
 /**
  * ConfidenceIndicator — horizontal bar + percent + tier label. The tier tone
@@ -187,8 +186,34 @@ declare const EntityCard: react.ForwardRefExoticComponent<EntityCardProps & reac
  * optional trailing meta.
  *
  * Renders as a button when `onClick` is supplied; otherwise a plain row.
+ *
+ * For strongly-typed refs use the specialized exports `EntityListRowDiv`
+ * (non-interactive) and `EntityListRowButton` (interactive). The default
+ * `EntityListRow` is a thin wrapper that picks the right underlying element
+ * based on whether `onClick` is provided.
  */
-interface EntityListRowProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+interface EntityListRowCommonProps {
+    type: EntityType;
+    /** Entity name / id. Rendered in mono. */
+    name: ReactNode;
+    /** Trailing pill (e.g., relation type: `OWNED_BY`). */
+    relation?: ReactNode;
+    /** Trailing meta line (e.g., a timestamp). */
+    meta?: ReactNode;
+    /** When true, hides the leading glyph dot. */
+    hideGlyph?: boolean;
+}
+interface EntityListRowDivProps extends EntityListRowCommonProps, Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'name'> {
+}
+/** Non-interactive row. Use this when you have a static list of entities. */
+declare const EntityListRowDiv: react.ForwardRefExoticComponent<EntityListRowDivProps & react.RefAttributes<HTMLDivElement>>;
+interface EntityListRowButtonProps extends EntityListRowCommonProps, Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'title' | 'type' | 'name' | 'onClick'> {
+    /** Click handler. Required for the button variant. */
+    onClick: MouseEventHandler<HTMLButtonElement>;
+}
+/** Interactive row rendered as a `<button>`. Use this when the row navigates. */
+declare const EntityListRowButton: react.ForwardRefExoticComponent<EntityListRowButtonProps & react.RefAttributes<HTMLButtonElement>>;
+interface EntityListRowProps extends Omit<HTMLAttributes<HTMLElement>, 'title' | 'name' | 'onClick'> {
     type: EntityType;
     /** Entity name / id. Rendered in mono. */
     name: ReactNode;
@@ -197,11 +222,19 @@ interface EntityListRowProps extends Omit<HTMLAttributes<HTMLElement>, 'title'>
     /** Trailing meta line (e.g., a timestamp). */
     meta?: ReactNode;
     /** When provided, the row becomes a clickable button. */
-    onClick?: () => void;
+    onClick?: MouseEventHandler<HTMLButtonElement>;
     /** When true, hides the leading glyph dot. */
     hideGlyph?: boolean;
 }
-declare const EntityListRow: react.ForwardRefExoticComponent<EntityListRowProps & react.RefAttributes<HTMLElement>>;
+/**
+ * Convenience wrapper: chooses `EntityListRowButton` when `onClick` is
+ * supplied, otherwise `EntityListRowDiv`. Does not forward refs — when you
+ * need a typed ref, reach for the specialized component directly.
+ */
+declare function EntityListRow({ type, name, relation, meta, hideGlyph, onClick, className, ...props }: EntityListRowProps): react_jsx_runtime.JSX.Element;
+declare namespace EntityListRow {
+    var displayName: string;
+}
 
 /**
  * GraphEdge — SVG `<line>` (or `<path>` if curve points are provided) rendered
@@ -423,14 +456,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. */
@@ -458,4 +499,37 @@ 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, 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, cn };
+/**
+ * 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, 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 };