@vantageos/mosaic 0.3.1 → 0.5.0

package/dist/display.d.cts

@@ -1,229 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { Observable } from 'rxjs';
-import { z } from 'zod';
-
-type ColumnDef<TRow extends Record<string, unknown> = Record<string, unknown>> = {
-    key: string;
-    header: string;
-    render?: (row: TRow) => ReactNode;
-};
-/**
- * Validates the serialisable (non-function) portion of TableView props.
- * The `rows$` Observable and `render` callbacks are not Zod-parseable and
- * must be validated at the call-site type level.
- */
-declare const TableViewPropsSchema: z.ZodObject<{
-    columns: z.ZodArray<z.ZodObject<{
-        key: z.ZodString;
-        header: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        key: string;
-        header: string;
-    }, {
-        key: string;
-        header: string;
-    }>, "many">;
-    virtualizeThreshold: z.ZodDefault<z.ZodNumber>;
-    ariaLabel: z.ZodString;
-    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
-}, "strip", z.ZodTypeAny, {
-    locale: "en" | "fr";
-    columns: {
-        key: string;
-        header: string;
-    }[];
-    virtualizeThreshold: number;
-    ariaLabel: string;
-}, {
-    columns: {
-        key: string;
-        header: string;
-    }[];
-    ariaLabel: string;
-    locale?: "en" | "fr" | undefined;
-    virtualizeThreshold?: number | undefined;
-}>;
-type TableViewPropsSchemaInput = z.input<typeof TableViewPropsSchema>;
-type TableViewPropsSchemaOutput = z.output<typeof TableViewPropsSchema>;
-/**
- * Props for the static TableView — accepts a plain array of rows.
- * Primary API for already-fetched data (no rxjs required).
- */
-type TableViewProps<TRow extends Record<string, unknown> = Record<string, unknown>> = {
-    columns: ColumnDef<TRow>[];
-    rows: Partial<TRow>[];
-    virtualizeThreshold?: number;
-    ariaLabel: string;
-    locale?: "en" | "fr";
-    /** v0.2.1+: when provided, rows become keyboard-activable (role=button + tabIndex=0 + Enter/Space). 5-BU ABSOLUTE blocker fix. */
-    onRowClick?: (row: TRow, index: number) => void;
-};
-/**
- * Props for StreamingTableView — accepts an RxJS Observable for incremental row appending.
- * Consumers using this variant MUST install rxjs ^7.8.0 in their project.
- */
-type StreamingTableViewProps<TRow extends Record<string, unknown> = Record<string, unknown>> = {
-    columns: ColumnDef<TRow>[];
-    rows$: Observable<Partial<TRow>[]>;
-    virtualizeThreshold?: number;
-    ariaLabel: string;
-    locale?: "en" | "fr";
-    /** v0.2.1+: same semantics as static TableView. */
-    onRowClick?: (row: TRow, index: number) => void;
-};
-declare function validateTableViewProps(raw: unknown): TableViewPropsSchemaOutput;
-
-/**
- * TableView — Static rows variant (primary API).
- *
- * Accepts `rows: Row[]` for already-fetched data — no rxjs required.
- * Activates TanStack Virtual v3 windowing when rows.length > virtualizeThreshold.
- * Zod-validates serialisable props; renders role="alert" fallback on failure.
- * Fully accessible: aria-rowcount, aria-label, scope="col".
- */
-declare function TableView<TRow extends Record<string, unknown> = Record<string, unknown>>(props: TableViewProps<TRow>): react_jsx_runtime.JSX.Element;
-/**
- * StreamingTableView — Streaming rows variant (advanced, opt-in).
- *
- * Pattern 4 Streaming Hydration reference implementation.
- * Consumes an RxJS Observable<Row[]> for incremental row appending.
- * Consumers MUST install rxjs ^7.8.0 in their project.
- * Activates TanStack Virtual v3 windowing when rows.length > virtualizeThreshold.
- * Zod-validates serialisable props; renders role="alert" fallback on failure.
- * Fully accessible: aria-rowcount, aria-label, scope="col".
- */
-declare function StreamingTableView<TRow extends Record<string, unknown> = Record<string, unknown>>(props: StreamingTableViewProps<TRow>): react_jsx_runtime.JSX.Element;
-
-/**
- * EmptyState component props schema.
- *
- * Empty-set illustration + title + description + optional CTA.
- * Consumer-driven i18n: caller passes already-localized strings.
- *
- * icon        — optional ReactNode / PreactNode passed by the caller
- * title       — required heading (h2, consumer-driven i18n)
- * description — optional supporting text
- * action      — optional CTA: { label, onClick, variant? }
- */
-declare const EmptyStatePropsSchema: z.ZodObject<{
-    title: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    action: z.ZodOptional<z.ZodObject<{
-        label: z.ZodString;
-        variant: z.ZodDefault<z.ZodEnum<["primary", "secondary"]>>;
-    }, "strip", z.ZodTypeAny, {
-        label: string;
-        variant: "primary" | "secondary";
-    }, {
-        label: string;
-        variant?: "primary" | "secondary" | undefined;
-    }>>;
-    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
-}, "strip", z.ZodTypeAny, {
-    locale: "en" | "fr";
-    title: string;
-    description?: string | undefined;
-    action?: {
-        label: string;
-        variant: "primary" | "secondary";
-    } | undefined;
-}, {
-    title: string;
-    locale?: "en" | "fr" | undefined;
-    description?: string | undefined;
-    action?: {
-        label: string;
-        variant?: "primary" | "secondary" | undefined;
-    } | undefined;
-}>;
-type EmptyStatePropsSchemaInput = z.input<typeof EmptyStatePropsSchema>;
-type EmptyStatePropsSchemaOutput = z.output<typeof EmptyStatePropsSchema>;
-/**
- * Full EmptyState props including framework-specific node types and callback.
- * `icon` and `action.onClick` are excluded from Zod (functions/nodes are not serializable).
- *
- * Note: action.variant is optional for callers — Zod applies "primary" default at parse time.
- */
-type EmptyStateProps = Omit<EmptyStatePropsSchemaOutput, "action"> & {
-    icon?: any;
-    action?: {
-        label: string;
-        variant?: "primary" | "secondary";
-        onClick: () => void;
-    };
-};
-declare function validateEmptyStateProps(raw: unknown): EmptyStatePropsSchemaOutput;
-
-/**
- * Skeleton — cross-runtime loading placeholder (React 19 implementation).
- *
- * Accepts `Record<string, unknown>` for MCP postMessage injection safety.
- * Zod validation narrows before render. Invalid props → accessible error span.
- *
- * Animation "none" is auto-applied when prefers-reduced-motion is set (via
- * Tailwind's animate-pulse which respects the media query natively), or by
- * passing animation="none" explicitly.
- *
- * WCAG-AA:
- * - role="status" + aria-busy="true" on the container
- * - aria-label resolves via t() in EN/FR
- * - aria-hidden="true" on individual line spans (status role covers the group)
- */
-declare function Skeleton(raw: Record<string, unknown>): react_jsx_runtime.JSX.Element;
-
-/**
- * Skeleton component props schema.
- *
- * variant  — shape of the placeholder:
- *            "rect"   → rectangular block (default)
- *            "circle" → circular avatar / icon placeholder
- *            "text"   → single or multi-line text placeholder
- *
- * width / height — CSS values (string) or pixels (number).
- *   "rect" defaults: width="100%", height=100
- *   "circle" defaults: width=height (equal, square rendered as circle)
- *   "text" defaults: width="100%", height=16
- *
- * count  — number of text line spans (only meaningful for variant="text").
- *          Default 1. Ignored for rect/circle.
- *
- * animation — shimmer style:
- *   "pulse" → opacity pulse (default)
- *   "wave"  → left-to-right gradient sweep
- *   "none"  → static placeholder (auto-selected when prefers-reduced-motion)
- */
-declare const SkeletonPropsSchema: z.ZodObject<{
-    variant: z.ZodDefault<z.ZodEnum<["rect", "circle", "text"]>>;
-    width: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    height: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    count: z.ZodDefault<z.ZodNumber>;
-    animation: z.ZodDefault<z.ZodEnum<["pulse", "wave", "none"]>>;
-    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
-}, "strip", z.ZodTypeAny, {
-    locale: "en" | "fr";
-    variant: "text" | "rect" | "circle";
-    count: number;
-    animation: "none" | "pulse" | "wave";
-    width?: string | number | undefined;
-    height?: string | number | undefined;
-}, {
-    locale?: "en" | "fr" | undefined;
-    width?: string | number | undefined;
-    variant?: "text" | "rect" | "circle" | undefined;
-    count?: number | undefined;
-    height?: string | number | undefined;
-    animation?: "none" | "pulse" | "wave" | undefined;
-}>;
-type SkeletonProps = z.infer<typeof SkeletonPropsSchema>;
-declare function validateSkeletonProps(raw: unknown): SkeletonProps;
-/**
- * Resolve final width/height CSS values given the variant and raw props.
- * Centralised here so React + Preact runtimes share identical defaults.
- */
-declare function resolveSkeletonDimensions(variant: SkeletonProps["variant"], width: SkeletonProps["width"], height: SkeletonProps["height"]): {
-    widthCss: string;
-    heightCss: string;
-};
-
-export { type ColumnDef, type EmptyStateProps, EmptyStatePropsSchema, type EmptyStatePropsSchemaInput, type EmptyStatePropsSchemaOutput, Skeleton, type SkeletonProps, SkeletonPropsSchema, StreamingTableView, type StreamingTableViewProps, TableView, type TableViewProps, TableViewPropsSchema, type TableViewPropsSchemaInput, type TableViewPropsSchemaOutput, resolveSkeletonDimensions, validateEmptyStateProps, validateSkeletonProps, validateTableViewProps };
+export { B as BalanceCard, a as BalanceCardProps, b as BalanceCardPropsOutput, c as BalanceCardPropsSchema, C as ColumnDef, d as ColumnKind, E as EmptyStateProps, e as EmptyStatePropsSchema, f as EmptyStatePropsSchemaInput, g as EmptyStatePropsSchemaOutput, F as FeedMessage, M as MessageFeed, h as MessageFeedProps, i as MessageFeedPropsOutput, j as MessageFeedPropsSchema, k as MessageFeedViewProps, P as PipelineBoard, l as PipelineBoardProps, m as PipelineBoardPropsOutput, n as PipelineBoardPropsSchema, o as PipelineBoardViewProps, p as PipelineDeal, q as PipelineStage, S as SelectionMode, r as Skeleton, s as SkeletonProps, t as SkeletonPropsSchema, u as SortDirection, v as SortState, w as StatCard, x as StatCardProps, y as StatCardPropsOutput, z as StatCardPropsSchema, A as StreamingTableView, D as StreamingTableViewProps, T as TableView, G as TableViewOptions, H as TableViewProps, I as TableViewPropsSchema, J as TableViewPropsSchemaInput, K as TableViewPropsSchemaOutput, L as compareDecimalStrings, N as nextSort, O as resolveSkeletonDimensions, Q as sortItems, R as validateBalanceCardProps, U as validateEmptyStateProps, V as validateMessageFeedProps, W as validatePipelineBoardProps, X as validateSkeletonProps, Y as validateStatCardProps, Z as validateTableViewProps } from './PipelineBoard-FucyGArR.cjs';
+export { b as balanceCardToMarkdown, m as messageFeedToMarkdown, p as pipelineBoardToMarkdown, s as statCardToMarkdown } from './PipelineBoard.markdown-DIcvrS-2.cjs';
+import 'react/jsx-runtime';
+import 'react';
+import 'rxjs';
+import 'zod';

package/dist/display.d.ts

@@ -1,229 +1,6 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { Observable } from 'rxjs';
-import { z } from 'zod';
-
-type ColumnDef<TRow extends Record<string, unknown> = Record<string, unknown>> = {
-    key: string;
-    header: string;
-    render?: (row: TRow) => ReactNode;
-};
-/**
- * Validates the serialisable (non-function) portion of TableView props.
- * The `rows$` Observable and `render` callbacks are not Zod-parseable and
- * must be validated at the call-site type level.
- */
-declare const TableViewPropsSchema: z.ZodObject<{
-    columns: z.ZodArray<z.ZodObject<{
-        key: z.ZodString;
-        header: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        key: string;
-        header: string;
-    }, {
-        key: string;
-        header: string;
-    }>, "many">;
-    virtualizeThreshold: z.ZodDefault<z.ZodNumber>;
-    ariaLabel: z.ZodString;
-    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
-}, "strip", z.ZodTypeAny, {
-    locale: "en" | "fr";
-    columns: {
-        key: string;
-        header: string;
-    }[];
-    virtualizeThreshold: number;
-    ariaLabel: string;
-}, {
-    columns: {
-        key: string;
-        header: string;
-    }[];
-    ariaLabel: string;
-    locale?: "en" | "fr" | undefined;
-    virtualizeThreshold?: number | undefined;
-}>;
-type TableViewPropsSchemaInput = z.input<typeof TableViewPropsSchema>;
-type TableViewPropsSchemaOutput = z.output<typeof TableViewPropsSchema>;
-/**
- * Props for the static TableView — accepts a plain array of rows.
- * Primary API for already-fetched data (no rxjs required).
- */
-type TableViewProps<TRow extends Record<string, unknown> = Record<string, unknown>> = {
-    columns: ColumnDef<TRow>[];
-    rows: Partial<TRow>[];
-    virtualizeThreshold?: number;
-    ariaLabel: string;
-    locale?: "en" | "fr";
-    /** v0.2.1+: when provided, rows become keyboard-activable (role=button + tabIndex=0 + Enter/Space). 5-BU ABSOLUTE blocker fix. */
-    onRowClick?: (row: TRow, index: number) => void;
-};
-/**
- * Props for StreamingTableView — accepts an RxJS Observable for incremental row appending.
- * Consumers using this variant MUST install rxjs ^7.8.0 in their project.
- */
-type StreamingTableViewProps<TRow extends Record<string, unknown> = Record<string, unknown>> = {
-    columns: ColumnDef<TRow>[];
-    rows$: Observable<Partial<TRow>[]>;
-    virtualizeThreshold?: number;
-    ariaLabel: string;
-    locale?: "en" | "fr";
-    /** v0.2.1+: same semantics as static TableView. */
-    onRowClick?: (row: TRow, index: number) => void;
-};
-declare function validateTableViewProps(raw: unknown): TableViewPropsSchemaOutput;
-
-/**
- * TableView — Static rows variant (primary API).
- *
- * Accepts `rows: Row[]` for already-fetched data — no rxjs required.
- * Activates TanStack Virtual v3 windowing when rows.length > virtualizeThreshold.
- * Zod-validates serialisable props; renders role="alert" fallback on failure.
- * Fully accessible: aria-rowcount, aria-label, scope="col".
- */
-declare function TableView<TRow extends Record<string, unknown> = Record<string, unknown>>(props: TableViewProps<TRow>): react_jsx_runtime.JSX.Element;
-/**
- * StreamingTableView — Streaming rows variant (advanced, opt-in).
- *
- * Pattern 4 Streaming Hydration reference implementation.
- * Consumes an RxJS Observable<Row[]> for incremental row appending.
- * Consumers MUST install rxjs ^7.8.0 in their project.
- * Activates TanStack Virtual v3 windowing when rows.length > virtualizeThreshold.
- * Zod-validates serialisable props; renders role="alert" fallback on failure.
- * Fully accessible: aria-rowcount, aria-label, scope="col".
- */
-declare function StreamingTableView<TRow extends Record<string, unknown> = Record<string, unknown>>(props: StreamingTableViewProps<TRow>): react_jsx_runtime.JSX.Element;
-
-/**
- * EmptyState component props schema.
- *
- * Empty-set illustration + title + description + optional CTA.
- * Consumer-driven i18n: caller passes already-localized strings.
- *
- * icon        — optional ReactNode / PreactNode passed by the caller
- * title       — required heading (h2, consumer-driven i18n)
- * description — optional supporting text
- * action      — optional CTA: { label, onClick, variant? }
- */
-declare const EmptyStatePropsSchema: z.ZodObject<{
-    title: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    action: z.ZodOptional<z.ZodObject<{
-        label: z.ZodString;
-        variant: z.ZodDefault<z.ZodEnum<["primary", "secondary"]>>;
-    }, "strip", z.ZodTypeAny, {
-        label: string;
-        variant: "primary" | "secondary";
-    }, {
-        label: string;
-        variant?: "primary" | "secondary" | undefined;
-    }>>;
-    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
-}, "strip", z.ZodTypeAny, {
-    locale: "en" | "fr";
-    title: string;
-    description?: string | undefined;
-    action?: {
-        label: string;
-        variant: "primary" | "secondary";
-    } | undefined;
-}, {
-    title: string;
-    locale?: "en" | "fr" | undefined;
-    description?: string | undefined;
-    action?: {
-        label: string;
-        variant?: "primary" | "secondary" | undefined;
-    } | undefined;
-}>;
-type EmptyStatePropsSchemaInput = z.input<typeof EmptyStatePropsSchema>;
-type EmptyStatePropsSchemaOutput = z.output<typeof EmptyStatePropsSchema>;
-/**
- * Full EmptyState props including framework-specific node types and callback.
- * `icon` and `action.onClick` are excluded from Zod (functions/nodes are not serializable).
- *
- * Note: action.variant is optional for callers — Zod applies "primary" default at parse time.
- */
-type EmptyStateProps = Omit<EmptyStatePropsSchemaOutput, "action"> & {
-    icon?: any;
-    action?: {
-        label: string;
-        variant?: "primary" | "secondary";
-        onClick: () => void;
-    };
-};
-declare function validateEmptyStateProps(raw: unknown): EmptyStatePropsSchemaOutput;
-
-/**
- * Skeleton — cross-runtime loading placeholder (React 19 implementation).
- *
- * Accepts `Record<string, unknown>` for MCP postMessage injection safety.
- * Zod validation narrows before render. Invalid props → accessible error span.
- *
- * Animation "none" is auto-applied when prefers-reduced-motion is set (via
- * Tailwind's animate-pulse which respects the media query natively), or by
- * passing animation="none" explicitly.
- *
- * WCAG-AA:
- * - role="status" + aria-busy="true" on the container
- * - aria-label resolves via t() in EN/FR
- * - aria-hidden="true" on individual line spans (status role covers the group)
- */
-declare function Skeleton(raw: Record<string, unknown>): react_jsx_runtime.JSX.Element;
-
-/**
- * Skeleton component props schema.
- *
- * variant  — shape of the placeholder:
- *            "rect"   → rectangular block (default)
- *            "circle" → circular avatar / icon placeholder
- *            "text"   → single or multi-line text placeholder
- *
- * width / height — CSS values (string) or pixels (number).
- *   "rect" defaults: width="100%", height=100
- *   "circle" defaults: width=height (equal, square rendered as circle)
- *   "text" defaults: width="100%", height=16
- *
- * count  — number of text line spans (only meaningful for variant="text").
- *          Default 1. Ignored for rect/circle.
- *
- * animation — shimmer style:
- *   "pulse" → opacity pulse (default)
- *   "wave"  → left-to-right gradient sweep
- *   "none"  → static placeholder (auto-selected when prefers-reduced-motion)
- */
-declare const SkeletonPropsSchema: z.ZodObject<{
-    variant: z.ZodDefault<z.ZodEnum<["rect", "circle", "text"]>>;
-    width: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    height: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    count: z.ZodDefault<z.ZodNumber>;
-    animation: z.ZodDefault<z.ZodEnum<["pulse", "wave", "none"]>>;
-    locale: z.ZodDefault<z.ZodEnum<["en", "fr"]>>;
-}, "strip", z.ZodTypeAny, {
-    locale: "en" | "fr";
-    variant: "text" | "rect" | "circle";
-    count: number;
-    animation: "none" | "pulse" | "wave";
-    width?: string | number | undefined;
-    height?: string | number | undefined;
-}, {
-    locale?: "en" | "fr" | undefined;
-    width?: string | number | undefined;
-    variant?: "text" | "rect" | "circle" | undefined;
-    count?: number | undefined;
-    height?: string | number | undefined;
-    animation?: "none" | "pulse" | "wave" | undefined;
-}>;
-type SkeletonProps = z.infer<typeof SkeletonPropsSchema>;
-declare function validateSkeletonProps(raw: unknown): SkeletonProps;
-/**
- * Resolve final width/height CSS values given the variant and raw props.
- * Centralised here so React + Preact runtimes share identical defaults.
- */
-declare function resolveSkeletonDimensions(variant: SkeletonProps["variant"], width: SkeletonProps["width"], height: SkeletonProps["height"]): {
-    widthCss: string;
-    heightCss: string;
-};
-
-export { type ColumnDef, type EmptyStateProps, EmptyStatePropsSchema, type EmptyStatePropsSchemaInput, type EmptyStatePropsSchemaOutput, Skeleton, type SkeletonProps, SkeletonPropsSchema, StreamingTableView, type StreamingTableViewProps, TableView, type TableViewProps, TableViewPropsSchema, type TableViewPropsSchemaInput, type TableViewPropsSchemaOutput, resolveSkeletonDimensions, validateEmptyStateProps, validateSkeletonProps, validateTableViewProps };
+export { B as BalanceCard, a as BalanceCardProps, b as BalanceCardPropsOutput, c as BalanceCardPropsSchema, C as ColumnDef, d as ColumnKind, E as EmptyStateProps, e as EmptyStatePropsSchema, f as EmptyStatePropsSchemaInput, g as EmptyStatePropsSchemaOutput, F as FeedMessage, M as MessageFeed, h as MessageFeedProps, i as MessageFeedPropsOutput, j as MessageFeedPropsSchema, k as MessageFeedViewProps, P as PipelineBoard, l as PipelineBoardProps, m as PipelineBoardPropsOutput, n as PipelineBoardPropsSchema, o as PipelineBoardViewProps, p as PipelineDeal, q as PipelineStage, S as SelectionMode, r as Skeleton, s as SkeletonProps, t as SkeletonPropsSchema, u as SortDirection, v as SortState, w as StatCard, x as StatCardProps, y as StatCardPropsOutput, z as StatCardPropsSchema, A as StreamingTableView, D as StreamingTableViewProps, T as TableView, G as TableViewOptions, H as TableViewProps, I as TableViewPropsSchema, J as TableViewPropsSchemaInput, K as TableViewPropsSchemaOutput, L as compareDecimalStrings, N as nextSort, O as resolveSkeletonDimensions, Q as sortItems, R as validateBalanceCardProps, U as validateEmptyStateProps, V as validateMessageFeedProps, W as validatePipelineBoardProps, X as validateSkeletonProps, Y as validateStatCardProps, Z as validateTableViewProps } from './PipelineBoard-FucyGArR.js';
+export { b as balanceCardToMarkdown, m as messageFeedToMarkdown, p as pipelineBoardToMarkdown, s as statCardToMarkdown } from './PipelineBoard.markdown-DIcvrS-2.js';
+import 'react/jsx-runtime';
+import 'react';
+import 'rxjs';
+import 'zod';