@divami-artefacts/ai-design-system 1.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,344 @@
+import { ReactNode } from 'react';
+export type VisualizationFrameProps = {
+    className?: string;
+};
+export type VizRow = {
+    id?: string;
+    vendor: string;
+    pricing?: number;
+};
+export type PointPair = [string, string | number];
+export type MiniBarRow = [string, number, string];
+export type SankeyNodeData = {
+    id: string;
+    name: string;
+    valueLabel?: string;
+};
+export type SankeyLinkData = {
+    source: string;
+    target: string;
+    value: number;
+};
+export type SeriesChartColors = {
+    axisLine?: string;
+    line?: string;
+    areaFill?: string;
+    point?: string;
+};
+export type BarChartColors = {
+    axisLine?: string;
+    bars?: string[];
+    valueLabel?: string;
+};
+export type PieChartColors = {
+    slices?: string[];
+};
+export type TrendChartColors = {
+    axisLine?: string;
+    line?: string;
+    point?: string;
+};
+export type SankeyChartColors = {
+    links?: string;
+    activeLinks?: string;
+    nodes?: string[];
+    activeNodes?: string;
+};
+export type BarChartProps = {
+    rows?: VizRow[];
+    colors?: BarChartColors;
+} & VisualizationFrameProps;
+export type LineChartProps = {
+    rows?: VizRow[];
+    colors?: SeriesChartColors;
+} & VisualizationFrameProps;
+export type AreaChartProps = {
+    rows?: VizRow[];
+    colors?: SeriesChartColors;
+} & VisualizationFrameProps;
+export type PieChartProps = {
+    rows?: VizRow[];
+    variant: 'pie' | 'donut';
+    colors?: PieChartColors;
+} & VisualizationFrameProps;
+export type DonutChartProps = {
+    rows?: VizRow[];
+    colors?: PieChartColors;
+} & VisualizationFrameProps;
+export type MiniBarsProps = {
+    rows?: MiniBarRow[];
+    colors?: PieChartColors;
+} & VisualizationFrameProps;
+export type ProcessSankeyProps = {
+    selectedEntity?: string | null;
+    colors?: SankeyChartColors;
+} & VisualizationFrameProps;
+export type RankingSankeyProps = {
+    rows?: VizRow[];
+    colors?: SankeyChartColors;
+} & VisualizationFrameProps;
+export type SankeySvgProps = {
+    nodes: SankeyNodeData[];
+    links: SankeyLinkData[];
+    width?: number;
+    height?: number;
+    ariaLabel: string;
+    selectedEntity?: string | null;
+    colors?: SankeyChartColors;
+} & VisualizationFrameProps;
+export type SeriesChartProps = {
+    rows?: VizRow[];
+    variant: 'line' | 'area';
+    colors?: SeriesChartColors;
+} & VisualizationFrameProps;
+export type TrendChartProps = {
+    points?: PointPair[];
+    colors?: TrendChartColors;
+} & VisualizationFrameProps;
+export type ChartFrameProps = {
+    children: ReactNode;
+    className?: string;
+};
+export type BaseVisualizationConfig = {
+    type: 'line' | 'area' | 'bar' | 'pie' | 'donut' | 'sankey';
+    rows: VizRow[];
+} | {
+    type: 'flow';
+    selectedEntity?: string | null;
+} | {
+    type: 'trend';
+    points: PointPair[];
+} | {
+    type: 'mini-bars';
+    rows: MiniBarRow[];
+} | {
+    type: 'contract-value-orb';
+    data: ContractData;
+} | {
+    type: 'contract-bars';
+    contractors: ContractorRow[];
+} | {
+    type: 'commitment-race';
+    contractors: ContractorRow[];
+} | {
+    type: 'status-arc';
+    segments: EWStatusRow[];
+    title?: string;
+} | {
+    type: 'ew-category';
+    categories: EWCategoryRow[];
+    title?: string;
+} | {
+    type: 'contractor-rank';
+    contractors: EWOpenContractorRow[];
+    title?: string;
+} | {
+    type: 'severity-bands';
+    severities: EWSeverityRow[];
+    title?: string;
+} | {
+    type: 'nce-tree';
+    total: number;
+    byContractor: NCEContractorRow[];
+} | {
+    type: 'compensation-gauge';
+    pct: number;
+    confirmed: number;
+    total: number;
+} | {
+    type: 'variation-split';
+    contractors: VariationRow[];
+} | {
+    type: 'quotation-balance';
+    accepted: QuotationSide;
+    submitted: QuotationSide;
+} | {
+    type: 'quotation-trend';
+    trend: QuotationTrendPoint[];
+} | {
+    type: 'weekly-flow';
+    contractors: ContractorRow[];
+};
+export type VisualizationRendererProps = {
+    config: BaseVisualizationConfig;
+    className?: string;
+};
+export type ContractorRow = {
+    id: string;
+    name: string;
+    shortName: string;
+    base: number;
+    variations: number;
+    totalCommitment: number;
+    commitmentPct: number;
+};
+export type ContractData = {
+    contractors: ContractorRow[];
+    totals: {
+        base: number;
+        variations: number;
+        totalCommitment: number;
+    };
+};
+export type EWStatusRow = {
+    status: string;
+    count: number;
+};
+export type EWCategoryRow = {
+    category: string;
+    fullName: string;
+    count: number;
+};
+export type EWSeverityRow = {
+    severity: string;
+    count: number;
+};
+export type EWOpenContractorRow = {
+    id: string;
+    name: string;
+    shortName: string;
+    openCount: number;
+};
+export type NCEContractorRow = {
+    id: string;
+    name: string;
+    shortName: string;
+    count: number;
+};
+export type NCECompensationData = {
+    total: number;
+    confirmed: number;
+    pctConfirmed: number;
+};
+export type VariationRow = {
+    id: string;
+    name: string;
+    shortName: string;
+    implemented: number;
+    unimplemented: number;
+};
+export type QuotationSide = {
+    value: number;
+    count: number;
+    label: string;
+};
+export type QuotationSummary = {
+    accepted: QuotationSide;
+    submitted: QuotationSide;
+};
+export type QuotationTrendPoint = {
+    week: string;
+    count: number;
+    value: number;
+};
+export type KeyHighlightChip = {
+    value: string;
+    label: string;
+    color?: string;
+};
+export type KeyHighlightBadge = {
+    text: string;
+    severity: 'red' | 'amber' | 'green';
+};
+export type KeyHighlightDot = {
+    val: number;
+    color: string;
+    name: string;
+};
+export type FlagsListRow = {
+    text: string;
+    tag: string;
+    date: string;
+    severity: 'red' | 'amber' | 'green';
+};
+export type ComparisonRow = {
+    label: string;
+    cells: string[];
+    color?: string;
+};
+export type ScorecardRow = {
+    name: string;
+    value: string;
+    pct: number;
+    color: string;
+    badge?: string;
+    badgeSeverity?: 'green' | 'amber' | 'red';
+    sublabel?: string;
+};
+export type KeyHighlightBlock = {
+    type: 'stats';
+    items: Array<{
+        value: string;
+        label: string;
+        color?: string;
+    }>;
+    takeaway?: string;
+} | {
+    type: 'chips';
+    items: KeyHighlightChip[];
+    takeaway?: string;
+} | {
+    type: 'ranked';
+    items: Array<{
+        name: string;
+        value: string;
+        color: string;
+        kpiLabel?: string;
+    }>;
+    takeaway?: string;
+} | {
+    type: 'proportion';
+    leftPct: number;
+    leftLabel: string;
+    leftValue: string;
+    leftColor: string;
+    rightPct: number;
+    rightLabel: string;
+    rightValue: string;
+    rightColor: string;
+    chips?: KeyHighlightChip[];
+    takeaway?: string;
+} | {
+    type: 'ring';
+    pct: number;
+    label: string;
+    color: string;
+    chips?: KeyHighlightChip[];
+    takeaway?: string;
+} | {
+    type: 'badges';
+    items: KeyHighlightBadge[];
+    textSize?: number;
+    takeaway?: string;
+} | {
+    type: 'dot-strip';
+    min: number;
+    max: number;
+    unit: string;
+    dots: KeyHighlightDot[];
+    chips?: KeyHighlightChip[];
+    takeaway?: string;
+} | {
+    type: 'scorecard-rows';
+    items: ScorecardRow[];
+    takeaway?: string;
+} | {
+    type: 'flags-list';
+    items: FlagsListRow[];
+    takeaway?: string;
+} | {
+    type: 'comparison-rows';
+    columns: string[];
+    rows: ComparisonRow[];
+    takeaway?: string;
+};
+export type NarrativeStep = {
+    id: string;
+    questionText: string;
+    title: string;
+    insight: string;
+    vizConfigs: BaseVisualizationConfig[];
+    followupIds: string[];
+    keyInsights: string[];
+    keyHighlights?: KeyHighlightBlock;
+};

package/dist/utils/mounts.d.ts

@@ -0,0 +1,4 @@
+import { BaseVisualizationConfig } from '../types';
+export declare function cleanupVisualizationMounts(): void;
+export declare function hydrateVisualizationMounts(): void;
+export declare function serializeVisualizationConfig(config: BaseVisualizationConfig): string;

package/dist/utils/workspace.utils.d.ts

@@ -0,0 +1,17 @@
+export declare function formatThreadTime(value: number): string;
+export declare function formatResponseTime(response: {
+    createdAt?: number;
+    timestamp?: string;
+}): string;
+export declare function formatLabelFor(format: string): string;
+export declare function supportsTimeRange(format: string): boolean;
+export declare function rangeFactor(range: string): number;
+export declare function summarizeText(value: string, max?: number): string;
+export declare function escapeHtml(value: unknown): string;
+export declare function storyToneClass(tone: string): string;
+export declare function storyTrendMeta(trend: string): {
+    label: string;
+    icon: string;
+    className: string;
+};
+export declare function monthToPercent(month: string): number;

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@divami-artefacts/ai-design-system",
+  "version": "1.0.1",
+  "type": "module",
+  "license": "MIT",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles": "./dist/ai-design-system.css"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "build:lib": "vite build --config vite.lib.config.ts",
+    "prepublishOnly": "npm run build:lib",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^24.12.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.57.0",
+    "vite": "^8.0.1",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}
+