@seed-ship/mcp-ui-spec 5.0.2 → 5.0.4

package/dist/schemas.d.ts

@@ -18,7 +18,7 @@ export declare const GridPositionSchema: z.ZodObject<{
     rowStart?: number | undefined;
     rowSpan?: number | undefined;
 }>;
-export declare const ComponentTypeSchema: z.ZodEnum<["chart", "table", "metric", "text", "composite", "grid", "iframe", "image", "link", "action", "footer", "carousel", "artifact", "form", "modal", "action-group", "image-gallery", "video", "code", "map"]>;
+export declare const ComponentTypeSchema: z.ZodEnum<["chart", "table", "metric", "text", "composite", "grid", "iframe", "image", "link", "action", "footer", "carousel", "artifact", "form", "modal", "action-group", "image-gallery", "video", "code", "map", "graph"]>;
 export declare const FormFieldOptionSchema: z.ZodObject<{
     label: z.ZodString;
     value: z.ZodString;
@@ -1005,6 +1005,236 @@ export declare const MapComponentParamsSchema: z.ZodObject<{
     tileLayer?: string | undefined;
     attribution?: string | undefined;
 }>;
+export declare const GraphNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>>;
+    /**
+     * Generic ranking / importance signal. Drives default node size when
+     * `size` is omitted, and acts as the sort key for the `concentric`
+     * layout (highest weight at center). Domain semantics opaque to the lib.
+     */
+    weight: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type?: string | undefined;
+    label?: string | undefined;
+    size?: number | [number, number] | undefined;
+    weight?: number | undefined;
+    style?: Record<string, unknown> | undefined;
+    data?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    type?: string | undefined;
+    label?: string | undefined;
+    size?: number | [number, number] | undefined;
+    weight?: number | undefined;
+    style?: Record<string, unknown> | undefined;
+    data?: Record<string, unknown> | undefined;
+}>;
+export declare const GraphEdgeSchema: z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    /**
+     * Generic strength signal. Drives default edge stroke width and acts
+     * as attractive force in `force` layouts. Domain semantics opaque.
+     */
+    weight: z.ZodOptional<z.ZodNumber>;
+    style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    target: string;
+    type?: string | undefined;
+    label?: string | undefined;
+    weight?: number | undefined;
+    style?: Record<string, unknown> | undefined;
+    data?: Record<string, unknown> | undefined;
+}, {
+    source: string;
+    target: string;
+    type?: string | undefined;
+    label?: string | undefined;
+    weight?: number | undefined;
+    style?: Record<string, unknown> | undefined;
+    data?: Record<string, unknown> | undefined;
+}>;
+/**
+ * Layout names exposed in the spec. Narrow on purpose — `force` covers
+ * generic networks, `dagre` covers DAGs, `concentric` covers
+ * weight-ordered ring layouts, `mindmap` + `tree` cover hierarchical
+ * fan-outs, `circular` + `grid` cover small-N ordered layouts. Power
+ * users opt into other G6 layouts via the object form
+ * `{ type: 'force', options: { ... } }` — `options` is a passthrough.
+ */
+export declare const GraphLayoutNameSchema: z.ZodEnum<["force", "dagre", "mindmap", "tree", "circular", "grid", "concentric"]>;
+export declare const GraphLayoutSchema: z.ZodUnion<[z.ZodEnum<["force", "dagre", "mindmap", "tree", "circular", "grid", "concentric"]>, z.ZodObject<{
+    type: z.ZodEnum<["force", "dagre", "mindmap", "tree", "circular", "grid", "concentric"]>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric";
+    options?: Record<string, unknown> | undefined;
+}, {
+    type: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric";
+    options?: Record<string, unknown> | undefined;
+}>]>;
+export declare const GraphComponentParamsSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>>;
+        /**
+         * Generic ranking / importance signal. Drives default node size when
+         * `size` is omitted, and acts as the sort key for the `concentric`
+         * layout (highest weight at center). Domain semantics opaque to the lib.
+         */
+        weight: z.ZodOptional<z.ZodNumber>;
+        style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        size?: number | [number, number] | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }, {
+        id: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        size?: number | [number, number] | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }>, "many">;
+    edges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        /**
+         * Generic strength signal. Drives default edge stroke width and acts
+         * as attractive force in `force` layouts. Domain semantics opaque.
+         */
+        weight: z.ZodOptional<z.ZodNumber>;
+        style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        target: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }, {
+        source: string;
+        target: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    /**
+     * Layout shorthand string OR object form. When omitted, the renderer
+     * picks a sensible default: `'force'` if edges are present, `'circular'`
+     * otherwise.
+     */
+    layout: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["force", "dagre", "mindmap", "tree", "circular", "grid", "concentric"]>, z.ZodObject<{
+        type: z.ZodEnum<["force", "dagre", "mindmap", "tree", "circular", "grid", "concentric"]>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric";
+        options?: Record<string, unknown> | undefined;
+    }, {
+        type: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric";
+        options?: Record<string, unknown> | undefined;
+    }>]>>;
+    height: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodString>;
+    rendererPref: z.ZodOptional<z.ZodEnum<["canvas", "svg"]>>;
+    fitView: z.ZodOptional<z.ZodBoolean>;
+    enableZoom: z.ZodOptional<z.ZodBoolean>;
+    enableDrag: z.ZodOptional<z.ZodBoolean>;
+    enableSelect: z.ZodOptional<z.ZodBoolean>;
+    tooltip: z.ZodOptional<z.ZodBoolean>;
+    className: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        id: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        size?: number | [number, number] | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }[];
+    title?: string | undefined;
+    layout?: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric" | {
+        type: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric";
+        options?: Record<string, unknown> | undefined;
+    } | undefined;
+    tooltip?: boolean | undefined;
+    height?: string | undefined;
+    edges?: {
+        source: string;
+        target: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    width?: string | undefined;
+    rendererPref?: "canvas" | "svg" | undefined;
+    fitView?: boolean | undefined;
+    enableZoom?: boolean | undefined;
+    enableDrag?: boolean | undefined;
+    enableSelect?: boolean | undefined;
+    className?: string | undefined;
+}, {
+    nodes: {
+        id: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        size?: number | [number, number] | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }[];
+    title?: string | undefined;
+    layout?: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric" | {
+        type: "grid" | "force" | "dagre" | "mindmap" | "tree" | "circular" | "concentric";
+        options?: Record<string, unknown> | undefined;
+    } | undefined;
+    tooltip?: boolean | undefined;
+    height?: string | undefined;
+    edges?: {
+        source: string;
+        target: string;
+        type?: string | undefined;
+        label?: string | undefined;
+        weight?: number | undefined;
+        style?: Record<string, unknown> | undefined;
+        data?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    width?: string | undefined;
+    rendererPref?: "canvas" | "svg" | undefined;
+    fitView?: boolean | undefined;
+    enableZoom?: boolean | undefined;
+    enableDrag?: boolean | undefined;
+    enableSelect?: boolean | undefined;
+    className?: string | undefined;
+}>;
 export declare const ChartTypeSchema: z.ZodEnum<["bar", "line", "pie", "doughnut", "radar", "scatter", "bubble", "polarArea"]>;
 export declare const ChartDatasetSchema: z.ZodObject<{
     label: z.ZodString;
@@ -1207,6 +1437,7 @@ export declare const ChartComponentParamsSchema: z.ZodObject<{
     } | undefined;
     title?: string | undefined;
     height?: string | undefined;
+    className?: string | undefined;
     renderer?: "iframe" | "auto" | "native" | undefined;
     exportable?: boolean | undefined;
     timeAxis?: {
@@ -1216,7 +1447,6 @@ export declare const ChartComponentParamsSchema: z.ZodObject<{
         unit?: "day" | "week" | "month" | "quarter" | "year" | undefined;
         tooltipFormat?: string | undefined;
     } | undefined;
-    className?: string | undefined;
 }, {
     type: "bar" | "line" | "pie" | "doughnut" | "radar" | "scatter" | "bubble" | "polarArea";
     data: {
@@ -1243,6 +1473,7 @@ export declare const ChartComponentParamsSchema: z.ZodObject<{
     } | undefined;
     title?: string | undefined;
     height?: string | undefined;
+    className?: string | undefined;
     renderer?: "iframe" | "auto" | "native" | undefined;
     exportable?: boolean | undefined;
     timeAxis?: {
@@ -1252,7 +1483,6 @@ export declare const ChartComponentParamsSchema: z.ZodObject<{
         unit?: "day" | "week" | "month" | "quarter" | "year" | undefined;
         tooltipFormat?: string | undefined;
     } | undefined;
-    className?: string | undefined;
 }>;
 export declare const TableColumnSchema: z.ZodObject<{
     key: z.ZodString;
@@ -1262,13 +1492,13 @@ export declare const TableColumnSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     label: string;
     key: string;
-    sortable?: boolean | undefined;
     width?: string | undefined;
+    sortable?: boolean | undefined;
 }, {
     label: string;
     key: string;
-    sortable?: boolean | undefined;
     width?: string | undefined;
+    sortable?: boolean | undefined;
 }>;
 export declare const TablePaginationSchema: z.ZodObject<{
     currentPage: z.ZodNumber;
@@ -1309,6 +1539,19 @@ export declare const TableExportableSchema: z.ZodUnion<[z.ZodBoolean, z.ZodObjec
     filename?: string | undefined;
     formats?: ("csv" | "tsv" | "json")[] | undefined;
 }>]>;
+export declare const CitationEntrySchema: z.ZodObject<{
+    page: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+    file: z.ZodOptional<z.ZodString>;
+    file_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+}, "strip", z.ZodTypeAny, {
+    page: string | number;
+    file?: string | undefined;
+    file_id?: string | number | undefined;
+}, {
+    page: string | number;
+    file?: string | undefined;
+    file_id?: string | number | undefined;
+}>;
 export declare const TableComponentParamsSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     columns: z.ZodArray<z.ZodObject<{
@@ -1319,13 +1562,13 @@ export declare const TableComponentParamsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         label: string;
         key: string;
-        sortable?: boolean | undefined;
         width?: string | undefined;
+        sortable?: boolean | undefined;
     }, {
         label: string;
         key: string;
-        sortable?: boolean | undefined;
         width?: string | undefined;
+        sortable?: boolean | undefined;
     }>, "many">;
     rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
     pagination: z.ZodOptional<z.ZodObject<{
@@ -1368,20 +1611,33 @@ export declare const TableComponentParamsSchema: z.ZodObject<{
         formats?: ("csv" | "tsv" | "json")[] | undefined;
     }>]>>;
     className: z.ZodOptional<z.ZodString>;
+    citationMap: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        page: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        file: z.ZodOptional<z.ZodString>;
+        file_id: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        page: string | number;
+        file?: string | undefined;
+        file_id?: string | number | undefined;
+    }, {
+        page: string | number;
+        file?: string | undefined;
+        file_id?: string | number | undefined;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     rows: Record<string, unknown>[];
     columns: {
         label: string;
         key: string;
-        sortable?: boolean | undefined;
         width?: string | undefined;
+        sortable?: boolean | undefined;
     }[];
     title?: string | undefined;
+    className?: string | undefined;
     exportable?: boolean | {
         filename?: string | undefined;
         formats?: ("csv" | "tsv" | "json")[] | undefined;
     } | undefined;
-    className?: string | undefined;
     pagination?: {
         currentPage: number;
         pageSize: number;
@@ -1393,20 +1649,25 @@ export declare const TableComponentParamsSchema: z.ZodObject<{
         overscan?: number | undefined;
         threshold?: number | undefined;
     } | undefined;
+    citationMap?: Record<string, {
+        page: string | number;
+        file?: string | undefined;
+        file_id?: string | number | undefined;
+    }> | undefined;
 }, {
     rows: Record<string, unknown>[];
     columns: {
         label: string;
         key: string;
-        sortable?: boolean | undefined;
         width?: string | undefined;
+        sortable?: boolean | undefined;
     }[];
     title?: string | undefined;
+    className?: string | undefined;
     exportable?: boolean | {
         filename?: string | undefined;
         formats?: ("csv" | "tsv" | "json")[] | undefined;
     } | undefined;
-    className?: string | undefined;
     pagination?: {
         currentPage: number;
         pageSize: number;
@@ -1418,6 +1679,11 @@ export declare const TableComponentParamsSchema: z.ZodObject<{
         overscan?: number | undefined;
         threshold?: number | undefined;
     } | undefined;
+    citationMap?: Record<string, {
+        page: string | number;
+        file?: string | undefined;
+        file_id?: string | number | undefined;
+    }> | undefined;
 }>;
 export declare const MetricTrendSchema: z.ZodObject<{
     value: z.ZodNumber;
@@ -1450,8 +1716,8 @@ export declare const MetricComponentParamsSchema: z.ZodObject<{
     value: string | number;
     title: string;
     icon?: string | undefined;
-    unit?: string | undefined;
     className?: string | undefined;
+    unit?: string | undefined;
     trend?: {
         value: number;
         direction: "up" | "down" | "neutral";
@@ -1461,8 +1727,8 @@ export declare const MetricComponentParamsSchema: z.ZodObject<{
     value: string | number;
     title: string;
     icon?: string | undefined;
-    unit?: string | undefined;
     className?: string | undefined;
+    unit?: string | undefined;
     trend?: {
         value: number;
         direction: "up" | "down" | "neutral";
@@ -1648,7 +1914,7 @@ export declare const ComponentExampleSchema: z.ZodObject<{
 }>;
 export declare const ComponentSchema: z.ZodObject<{
     id: z.ZodString;
-    type: z.ZodEnum<["chart", "table", "metric", "text", "composite", "grid", "iframe", "image", "link", "action", "footer", "carousel", "artifact", "form", "modal", "action-group", "image-gallery", "video", "code", "map"]>;
+    type: z.ZodEnum<["chart", "table", "metric", "text", "composite", "grid", "iframe", "image", "link", "action", "footer", "carousel", "artifact", "form", "modal", "action-group", "image-gallery", "video", "code", "map", "graph"]>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     schema: z.ZodObject<{
@@ -1739,7 +2005,7 @@ export declare const ComponentSchema: z.ZodObject<{
     deprecated: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     deprecationMessage: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video";
+    type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video" | "graph";
     name: string;
     id: string;
     schema: {
@@ -1775,7 +2041,7 @@ export declare const ComponentSchema: z.ZodObject<{
     deprecated?: boolean | undefined;
     deprecationMessage?: string | undefined;
 }, {
-    type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video";
+    type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video" | "graph";
     name: string;
     id: string;
     schema: {
@@ -1847,7 +2113,7 @@ export declare const ComponentRegistrySchema: z.ZodObject<{
     }>>;
     components: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        type: z.ZodEnum<["chart", "table", "metric", "text", "composite", "grid", "iframe", "image", "link", "action", "footer", "carousel", "artifact", "form", "modal", "action-group", "image-gallery", "video", "code", "map"]>;
+        type: z.ZodEnum<["chart", "table", "metric", "text", "composite", "grid", "iframe", "image", "link", "action", "footer", "carousel", "artifact", "form", "modal", "action-group", "image-gallery", "video", "code", "map", "graph"]>;
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         schema: z.ZodObject<{
@@ -1938,7 +2204,7 @@ export declare const ComponentRegistrySchema: z.ZodObject<{
         deprecated: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
         deprecationMessage: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video";
+        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video" | "graph";
         name: string;
         id: string;
         schema: {
@@ -1974,7 +2240,7 @@ export declare const ComponentRegistrySchema: z.ZodObject<{
         deprecated?: boolean | undefined;
         deprecationMessage?: string | undefined;
     }, {
-        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video";
+        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video" | "graph";
         name: string;
         id: string;
         schema: {
@@ -2013,7 +2279,7 @@ export declare const ComponentRegistrySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     version: "1.0.0";
     components: {
-        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video";
+        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video" | "graph";
         name: string;
         id: string;
         schema: {
@@ -2058,7 +2324,7 @@ export declare const ComponentRegistrySchema: z.ZodObject<{
 }, {
     version: "1.0.0";
     components: {
-        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video";
+        type: "code" | "map" | "chart" | "table" | "metric" | "text" | "composite" | "grid" | "iframe" | "image" | "link" | "action" | "footer" | "carousel" | "artifact" | "form" | "modal" | "action-group" | "image-gallery" | "video" | "graph";
         name: string;
         id: string;
         schema: {
@@ -2135,6 +2401,11 @@ export type LatLngTuple = z.infer<typeof LatLngTupleSchema>;
 export type LatLngPoint = z.infer<typeof LatLngPointSchema>;
 export type MapMarker = z.infer<typeof MapMarkerSchema>;
 export type MapComponentParams = z.infer<typeof MapComponentParamsSchema>;
+export type GraphNode = z.infer<typeof GraphNodeSchema>;
+export type GraphEdge = z.infer<typeof GraphEdgeSchema>;
+export type GraphLayoutName = z.infer<typeof GraphLayoutNameSchema>;
+export type GraphLayout = z.infer<typeof GraphLayoutSchema>;
+export type GraphComponentParams = z.infer<typeof GraphComponentParamsSchema>;
 export type ChartType = z.infer<typeof ChartTypeSchema>;
 export type ChartDataset = z.infer<typeof ChartDatasetSchema>;
 export type ChartTimeAxis = z.infer<typeof ChartTimeAxisSchema>;
@@ -2143,6 +2414,7 @@ export type TableColumn = z.infer<typeof TableColumnSchema>;
 export type TablePagination = z.infer<typeof TablePaginationSchema>;
 export type TableVirtualizeOptions = z.infer<typeof TableVirtualizeOptionsSchema>;
 export type TableExportable = z.infer<typeof TableExportableSchema>;
+export type CitationEntry = z.infer<typeof CitationEntrySchema>;
 export type TableComponentParams = z.infer<typeof TableComponentParamsSchema>;
 export type MetricTrend = z.infer<typeof MetricTrendSchema>;
 export type MetricComponentParams = z.infer<typeof MetricComponentParamsSchema>;

package/dist/schemas.js

@@ -34,8 +34,10 @@ const ComponentTypeSchema = z.enum([
   // Sprint 5: Video embed (YouTube, Vimeo, direct)
   "code",
   // Sprint 6: Syntax highlighted code block
-  "map"
+  "map",
   // Sprint 6: Interactive map (Leaflet)
+  "graph"
+  // v5.0.4: node-link graph (peer @antv/g6)
 ]);
 const FormFieldOptionSchema = z.object({
   label: z.string().min(1),
@@ -259,6 +261,83 @@ const MapComponentParamsSchema = z.object({
   tileLayer: z.string().optional(),
   attribution: z.string().optional()
 });
+const GraphNodeSchema = z.object({
+  id: z.string().min(1),
+  label: z.string().optional(),
+  type: z.string().optional(),
+  // G6 node type: 'circle' | 'rect' | 'image' | …
+  size: z.union([z.number(), z.tuple([z.number(), z.number()])]).optional(),
+  /**
+   * Generic ranking / importance signal. Drives default node size when
+   * `size` is omitted, and acts as the sort key for the `concentric`
+   * layout (highest weight at center). Domain semantics opaque to the lib.
+   */
+  weight: z.number().optional(),
+  style: z.record(z.unknown()).optional(),
+  // passthrough G6 NodeStyle
+  data: z.record(z.unknown()).optional()
+  // arbitrary metadata for tooltips / click handlers
+});
+const GraphEdgeSchema = z.object({
+  source: z.string().min(1),
+  // must match a node.id
+  target: z.string().min(1),
+  // must match a node.id
+  label: z.string().optional(),
+  type: z.string().optional(),
+  // G6 edge type: 'line' | 'arc' | 'cubic' | 'polyline' | …
+  /**
+   * Generic strength signal. Drives default edge stroke width and acts
+   * as attractive force in `force` layouts. Domain semantics opaque.
+   */
+  weight: z.number().optional(),
+  style: z.record(z.unknown()).optional(),
+  data: z.record(z.unknown()).optional()
+});
+const GraphLayoutNameSchema = z.enum([
+  "force",
+  "dagre",
+  "mindmap",
+  "tree",
+  "circular",
+  "grid",
+  "concentric"
+]);
+const GraphLayoutSchema = z.union([
+  GraphLayoutNameSchema,
+  z.object({
+    type: GraphLayoutNameSchema,
+    options: z.record(z.unknown()).optional()
+  })
+]);
+const GraphComponentParamsSchema = z.object({
+  title: z.string().optional(),
+  nodes: z.array(GraphNodeSchema).min(1),
+  edges: z.array(GraphEdgeSchema).optional(),
+  /**
+   * Layout shorthand string OR object form. When omitted, the renderer
+   * picks a sensible default: `'force'` if edges are present, `'circular'`
+   * otherwise.
+   */
+  layout: GraphLayoutSchema.optional(),
+  height: z.string().optional(),
+  // CSS length, default '400px'
+  width: z.string().optional(),
+  // CSS length, default '100%'
+  rendererPref: z.enum(["canvas", "svg"]).optional(),
+  // default 'canvas'
+  fitView: z.boolean().optional(),
+  // default true
+  enableZoom: z.boolean().optional(),
+  // default true
+  enableDrag: z.boolean().optional(),
+  // default true (drag nodes)
+  enableSelect: z.boolean().optional(),
+  // default true (click-select highlight)
+  tooltip: z.boolean().optional(),
+  // default true (label + data summary on hover)
+  className: z.string().optional()
+});
 const ChartTypeSchema = z.enum([
   "bar",
   "line",
@@ -339,6 +418,11 @@ const TableExportableSchema = z.union([
     filename: z.string().optional()
   })
 ]);
+const CitationEntrySchema = z.object({
+  page: z.union([z.number(), z.string()]),
+  file: z.string().optional(),
+  file_id: z.union([z.number(), z.string()]).optional()
+});
 const TableComponentParamsSchema = z.object({
   title: z.string().optional(),
   columns: z.array(TableColumnSchema).min(1),
@@ -346,7 +430,9 @@ const TableComponentParamsSchema = z.object({
   pagination: TablePaginationSchema.optional(),
   virtualize: z.union([z.boolean(), TableVirtualizeOptionsSchema]).optional(),
   exportable: TableExportableSchema.optional(),
-  className: z.string().optional()
+  className: z.string().optional(),
+  // v5.0.3 — opt-in citation chip rendering inside cells
+  citationMap: z.record(z.string(), CitationEntrySchema).optional()
 });
 const MetricTrendSchema = z.object({
   value: z.number(),
@@ -461,6 +547,7 @@ export {
   ChartDatasetSchema,
   ChartTimeAxisSchema,
   ChartTypeSchema,
+  CitationEntrySchema,
   CodeComponentParamsSchema,
   ComponentExampleSchema,
   ComponentRegistrySchema,
@@ -473,6 +560,11 @@ export {
   FormFieldTypeSchema,
   FormSubmitActionSchema,
   GalleryImageSchema,
+  GraphComponentParamsSchema,
+  GraphEdgeSchema,
+  GraphLayoutNameSchema,
+  GraphLayoutSchema,
+  GraphNodeSchema,
   GridPositionSchema,
   IframeComponentParamsSchema,
   ImageComponentParamsSchema,