semiotic 3.10.2 → 3.10.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/README.md +21 -26
  2. package/ai/artifact-surface-inventory.json +1 -1
  3. package/ai/behaviorContracts.cjs +15 -5
  4. package/ai/behaviorContracts.d.cts +3 -0
  5. package/ai/cli.js +17 -166
  6. package/ai/componentMetadata.cjs +68 -15
  7. package/ai/componentMetadata.d.cts +3 -0
  8. package/ai/dist/diagnose-operation.js +3 -0
  9. package/ai/dist/mcp-server.js +59 -59
  10. package/ai/reference.md +6 -6
  11. package/ai/schema.json +1 -1
  12. package/ai/surface-manifest.json +1 -1
  13. package/ai/system-prompt.md +2 -2
  14. package/ai/task-packets/compare-category-totals.json +7 -7
  15. package/ai/task-packets/compare-category-totals.md +3 -3
  16. package/ai/task-packets/correct-published-chart.json +7 -7
  17. package/ai/task-packets/correct-published-chart.md +3 -3
  18. package/ai/task-packets/index.json +6 -6
  19. package/ai/task-packets/update-live-chart.json +7 -7
  20. package/ai/task-packets/update-live-chart.md +3 -3
  21. package/dist/c-2MHSD3TN.min.js +209 -0
  22. package/dist/{c-PZ3NEGNG.min.js → c-6XGGN5OS.min.js} +1 -1
  23. package/dist/{c-FDUQDCBC.min.js → c-CO4NDAD6.min.js} +23 -23
  24. package/dist/c-EK6XI2U7.min.js +26 -0
  25. package/dist/c-FMCUQ6JX.min.js +1 -0
  26. package/dist/{c-C4KIXUWU.min.js → c-GK263BF4.min.js} +1 -1
  27. package/dist/{c-TTKWXGAI.min.js → c-HNHKIMIV.min.js} +3 -3
  28. package/dist/c-IJCZGUG6.min.js +31 -0
  29. package/dist/{c-4XLHPQTP.min.js → c-JBWPJNTJ.min.js} +1 -1
  30. package/dist/{c-4MD53L2J.min.js → c-JC76YAHB.min.js} +28 -28
  31. package/dist/{c-VXIYF7V2.min.js → c-JOPGDP6N.min.js} +1 -1
  32. package/dist/c-KWP4QTCM.min.js +4 -0
  33. package/dist/c-LRV7PO45.min.js +393 -0
  34. package/dist/c-LVHJJUOF.min.js +1 -0
  35. package/dist/c-M43PK7K4.min.js +1 -0
  36. package/dist/c-NUBZ63VU.min.js +1 -0
  37. package/dist/{c-7ASK4WBF.min.js → c-PITYSOPK.min.js} +1 -1
  38. package/dist/{c-2TW5H5PD.min.js → c-QPO24R7Q.min.js} +1 -1
  39. package/dist/{c-SG2Y7EBY.min.js → c-RWHLEUX6.min.js} +1 -1
  40. package/dist/{c-4JKDJUYD.min.js → c-S746GRV4.min.js} +1 -1
  41. package/dist/{c-KGROWFT2.min.js → c-SAP5KY6R.min.js} +2 -2
  42. package/dist/c-UMGHCBH5.min.js +114 -0
  43. package/dist/c-UQBWSYKI.min.js +41 -0
  44. package/dist/{c-6ZU3QVLB.min.js → c-VEMCBQZZ.min.js} +33 -33
  45. package/dist/{c-IPYGNVN6.min.js → c-WD2RL76M.min.js} +45 -45
  46. package/dist/{c-PQOZPM4G.min.js → c-YL7HJL5J.min.js} +1 -1
  47. package/dist/c-Z6GRGS53.min.js +1 -0
  48. package/dist/components/CategoryColors.d.ts +7 -0
  49. package/dist/components/LinkedCharts.d.ts +2 -1
  50. package/dist/components/ai/chartClinic.d.ts +1 -1
  51. package/dist/components/ai/chartClinicMetadata.generated.d.ts +2 -2
  52. package/dist/components/charts/shared/{chartDefinitionPilot.d.ts → chartDefinition.d.ts} +30 -34
  53. package/dist/components/charts/shared/chartDefinitions.d.ts +10 -0
  54. package/dist/components/charts/shared/chartDefinitionsNetwork.d.ts +17 -0
  55. package/dist/components/charts/shared/chartDefinitionsOrdinal.d.ts +23 -0
  56. package/dist/components/charts/shared/chartDefinitionsPhysics.d.ts +17 -0
  57. package/dist/components/charts/shared/chartDefinitionsRealtime.d.ts +12 -0
  58. package/dist/components/charts/shared/chartDefinitionsXY.d.ts +26 -0
  59. package/dist/components/charts/shared/useChartSetup.d.ts +1 -1
  60. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +1 -1
  61. package/dist/components/data/transforms.d.ts +1 -0
  62. package/dist/components/server/serverChartConfigs.d.ts +36 -36
  63. package/dist/components/server/serverChartConfigsNetwork.generated.d.ts +17 -0
  64. package/dist/components/server/serverChartConfigsOrdinal.generated.d.ts +23 -0
  65. package/dist/components/server/serverChartConfigsPhysics.generated.d.ts +17 -0
  66. package/dist/components/server/serverChartConfigsRealtime.generated.d.ts +13 -0
  67. package/dist/components/server/serverChartConfigsXY.generated.d.ts +22 -0
  68. package/dist/components/stream/physics/PhysicsOptionalEngineAdapters.d.ts +5 -0
  69. package/dist/geo.min.js +3 -3
  70. package/dist/geo.module.min.js +10 -10
  71. package/dist/network.module.min.js +1 -1
  72. package/dist/ordinal.module.min.js +1 -1
  73. package/dist/physics-matter.min.js +4 -1
  74. package/dist/physics-matter.module.min.js +1 -1
  75. package/dist/physics-rapier.min.js +4 -1
  76. package/dist/physics-rapier.module.min.js +1 -1
  77. package/dist/physics.module.min.js +1 -1
  78. package/dist/physicsWorker.js +1 -1
  79. package/dist/semiotic-ai-core.min.js +3 -3
  80. package/dist/semiotic-ai-core.module.min.js +3 -3
  81. package/dist/semiotic-ai.module.min.js +7 -7
  82. package/dist/semiotic-artifact.min.js +1 -1
  83. package/dist/semiotic-artifact.module.min.js +1 -1
  84. package/dist/semiotic-atlas-selection.module.min.js +1 -1
  85. package/dist/semiotic-client-cjs-shared.min.js +903 -902
  86. package/dist/semiotic-data.min.js +1 -1
  87. package/dist/semiotic-data.module.min.js +1 -1
  88. package/dist/semiotic-experimental-auxiliary.module.min.js +3 -3
  89. package/dist/semiotic-experimental-node-auxiliary.module.min.js +3 -3
  90. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  91. package/dist/semiotic-line.module.min.js +1 -1
  92. package/dist/semiotic-realtime-core.module.min.js +1 -1
  93. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  94. package/dist/semiotic-recipes-core.module.min.js +13 -13
  95. package/dist/semiotic-server-edge-node.module.min.js +393 -391
  96. package/dist/semiotic-server-edge.min.js +393 -391
  97. package/dist/semiotic-server-edge.module.min.js +374 -372
  98. package/dist/semiotic-server-node.min.js +393 -391
  99. package/dist/semiotic-server-node.module.min.js +1 -1
  100. package/dist/semiotic-utils-core.min.js +1 -1
  101. package/dist/semiotic-utils-core.module.min.js +1 -1
  102. package/dist/semiotic.module.min.js +10 -10
  103. package/dist/server.min.js +393 -391
  104. package/dist/server.module.min.js +1 -1
  105. package/dist/xy.module.min.js +1 -1
  106. package/package.json +12 -8
  107. package/dist/c-3OFVBWQY.min.js +0 -1
  108. package/dist/c-6IVBV5NO.min.js +0 -1
  109. package/dist/c-72CBVNYX.min.js +0 -209
  110. package/dist/c-7LY46QUI.min.js +0 -41
  111. package/dist/c-AKLBQMQF.min.js +0 -391
  112. package/dist/c-F2GGJB2S.min.js +0 -31
  113. package/dist/c-G53AVC42.min.js +0 -113
  114. package/dist/c-HQ27AHMC.min.js +0 -1
  115. package/dist/c-IHWZ2C6D.min.js +0 -26
  116. package/dist/c-MOP2NGLH.min.js +0 -1
  117. package/dist/c-PKY4JFY5.min.js +0 -1
  118. package/dist/c-UBHICVSC.min.js +0 -1
@@ -1 +1 @@
1
- function e(e){if(null==e)return;if("number"==typeof e)return{top:e,right:e,bottom:e,left:e};let t={};return"number"==typeof e.top&&(t.top=e.top),"number"==typeof e.right&&(t.right=e.right),"number"==typeof e.bottom&&(t.bottom=e.bottom),"number"==typeof e.left&&(t.left=e.left),t}function t(t){return e(t)}function n(e){let n=m(null);return r(e.imperativeRef,{variant:e.imperativeVariant,frameRef:n}),{frameRef:n,resolved:a(e.mode,{width:e.width,height:e.height,showGrid:e.showGrid,enableHover:e.enableHover,showLegend:e.showLegend,title:e.title,description:e.description,summary:e.summary,accessibleTable:e.accessibleTable,xLabel:e.xLabel,yLabel:e.yLabel,mobileInteraction:e.mobileInteraction,mobileSemantics:e.mobileSemantics,responsiveRules:e.responsiveRules}),normalizedMargin:l(()=>t(e.margin),[e.margin])}}function o(e){let t=n(e),{resolved:o,normalizedMargin:r}=t,a=i({data:e.data??[],rawData:e.data,colorBy:e.colorBy,colorScheme:e.colorScheme,legendInteraction:e.legendInteraction,legendPosition:e.legendPosition,frameLegend:e.frameLegend,selection:e.selection,linkedHover:e.linkedHover,hoverHighlight:e.hoverHighlight,fallbackFields:"string"==typeof e.colorBy?[e.colorBy]:[],unwrapData:e.unwrapData,onObservation:e.onObservation,onClick:e.onClick,mobileInteraction:e.mobileInteraction,mobileSemantics:e.mobileSemantics,chartType:e.chartTypeLabel,chartId:e.chartId,showLegend:o.showLegend,legend:e.legend,userMargin:r,marginDefaults:o.marginDefaults,loading:e.loading,loadingContent:e.loadingContent,emptyContent:e.emptyContent,width:o.width,height:o.height});return{...t,safeData:a.data,setup:a,earlyReturn:a.earlyReturn}}import{b as i,c as r}from"./c-HQ27AHMC.min.js";import{Mb as a}from"./c-G53AVC42.min.js";import{useMemo as l,useRef as m}from"react";export{e as a,n as b,o as c};
1
+ function e(e){if(null==e)return;if("number"==typeof e)return{top:e,right:e,bottom:e,left:e};let t={};return"number"==typeof e.top&&(t.top=e.top),"number"==typeof e.right&&(t.right=e.right),"number"==typeof e.bottom&&(t.bottom=e.bottom),"number"==typeof e.left&&(t.left=e.left),t}function t(t){return e(t)}function n(e){let n=m(null);return r(e.imperativeRef,{variant:e.imperativeVariant,frameRef:n}),{frameRef:n,resolved:a(e.mode,{width:e.width,height:e.height,showGrid:e.showGrid,enableHover:e.enableHover,showLegend:e.showLegend,title:e.title,description:e.description,summary:e.summary,accessibleTable:e.accessibleTable,xLabel:e.xLabel,yLabel:e.yLabel,mobileInteraction:e.mobileInteraction,mobileSemantics:e.mobileSemantics,responsiveRules:e.responsiveRules}),normalizedMargin:l(()=>t(e.margin),[e.margin])}}function o(e){let t=n(e),{resolved:o,normalizedMargin:r}=t,a=i({data:e.data??[],rawData:e.data,colorBy:e.colorBy,colorScheme:e.colorScheme,legendInteraction:e.legendInteraction,legendPosition:e.legendPosition,frameLegend:e.frameLegend,selection:e.selection,linkedHover:e.linkedHover,hoverHighlight:e.hoverHighlight,fallbackFields:"string"==typeof e.colorBy?[e.colorBy]:[],unwrapData:e.unwrapData,onObservation:e.onObservation,onClick:e.onClick,mobileInteraction:e.mobileInteraction,mobileSemantics:e.mobileSemantics,chartType:e.chartTypeLabel,chartId:e.chartId,showLegend:o.showLegend,legend:e.legend,userMargin:r,marginDefaults:o.marginDefaults,loading:e.loading,loadingContent:e.loadingContent,emptyContent:e.emptyContent,width:o.width,height:o.height});return{...t,safeData:a.data,setup:a,earlyReturn:a.earlyReturn}}import{b as i,c as r}from"./c-FMCUQ6JX.min.js";import{Nb as a}from"./c-UMGHCBH5.min.js";import{useMemo as l,useRef as m}from"react";export{e as a,n as b,o as c};
@@ -0,0 +1 @@
1
+ function e({isPushMode:e,colorBy:u,colorScheme:y,showLegend:h,legendPosition:p="right",trackCategoryDomain:b=!0,registerLinkedCategories:C=!0}){let[S,A]=c(0),w=o(null!=y),M=t(),P=i(),j=e&&!!u&&(b||P),v="function"==typeof u?m:u,k=f(()=>({lifecycle:{colorByDomainKey:v,isPushMode:e,shouldTrackCategoryDomain:j},categories:/* @__PURE__ */new Set,ordered:[]}),[v,e,j]),B=d(e=>u?("function"==typeof u?u(e):e[u])+"":null,[u]),D=d(e=>{if(!j)return;let r=!1;for(let t of e){if(!t||"object"!=typeof t)continue;let e=B(t);null!=e&&!k.categories.has(e)&&(k.categories.add(e),k.ordered.push(e),r=!0)}r&&A(e=>e+1)},[k,B,j]),L=d(e=>{if(!j)return;let r=Array.from(new Set(e.map(String))),t=k.ordered;t.length===r.length&&t.every((e,t)=>e===r[t])||(k.categories=new Set(r),k.ordered=r,A(e=>e+1))},[k,j]),x=d(e=>r=>{D([r]),e(r)},[D]),F=d(e=>r=>{D(r),e(r)},[D]),H=d(()=>{k.categories=/* @__PURE__ */new Set,k.ordered=[],A(e=>e+1)},[k]),K=f(()=>j?[...k.ordered]:[],[k,j,S]);a(C&&e&&u?K:[]);let _=f(()=>{if(!e||!u||!1===h)return;let t=k.ordered;if(0===t.length)return;let o=Array.isArray(y)&&y.length>0||"string"==typeof y&&y.length>0?y:M&&M.length>0?M:n,a="string"==typeof u?u:"__streamCat",i=t.map(e=>({[a]:e})),c=g(i,a,o),d=y&&"object"==typeof y&&!Array.isArray(y)?y:void 0;return r({data:i,colorBy:a,colorScale:e=>(w?l(w,e):void 0)??(d?l(d,e):void 0)??c(e)??"#999",getColor:s})},[e,u,h,y,w,M,S,k]),G=f(()=>{if(_)return"right"===p?{right:110}:"left"===p?{left:110}:"top"===p?{top:50}:"bottom"===p?{bottom:80}:{right:110}},[_,p]);return{wrapPush:x,wrapPushMany:F,resetCategories:H,categories:K,categoryDomainProps:j?{legendCategoryAccessor:u,onCategoriesChange:L}:{},streamingLegend:_,streamingMarginAdjust:G}}import{Ab as r,Fb as t,eb as o,xb as a,yb as i}from"./c-UMGHCBH5.min.js";import{p as n,r as s,s as l,t as g}from"./c-Y342FJ6K.min.js";import{useState as c,useCallback as d,useMemo as f}from"react";var m=/* @__PURE__ */Symbol("streaming-function-color-domain");export{e as a};
@@ -5,6 +5,13 @@ import * as React from "react";
5
5
  * colors consistently regardless of what subset of categories each chart displays.
6
6
  */
7
7
  export type CategoryColorMap = Record<string, string>;
8
+ /** Internal: publish linked defaults without promoting them to explicit overrides. */
9
+ export declare function LinkedCategoryColorProvider({ colors, children }: {
10
+ colors: CategoryColorMap;
11
+ children: React.ReactNode;
12
+ }): React.JSX.Element;
13
+ /** Internal: a chart's own palette takes priority over generated linked defaults. */
14
+ export declare function useChartCategoryColors(hasOwnColors: boolean): CategoryColorMap | null;
8
15
  export interface CategoryColorProviderProps {
9
16
  /** Explicit category→color mapping */
10
17
  colors?: CategoryColorMap;
@@ -10,7 +10,7 @@ export declare function useLinkedLegendSuppression(): boolean;
10
10
  /** Hook: returns true when descendants are already inside a LinkedCharts provider. */
11
11
  export declare function useLinkedChartsActive(): boolean;
12
12
  /** Register a chart's current color categories with the nearest LinkedCharts. */
13
- export declare function useLinkedChartCategories(categories: string[]): void;
13
+ export declare function useLinkedChartCategories(categories: string[], colorScale?: (category: string) => string): void;
14
14
  /** True when a chart can register live categories with a parent LinkedCharts. */
15
15
  export declare function useLinkedChartCategoryRegistryActive(): boolean;
16
16
  export interface LinkedChartsProps {
@@ -22,6 +22,7 @@ export interface LinkedChartsProps {
22
22
  /**
23
23
  * Show a unified legend for all linked charts.
24
24
  * When true, child chart legends are automatically suppressed unless explicitly set.
25
+ * If charts use different colors for the same category, retain their own legends.
25
26
  * @default true
26
27
  */
27
28
  showLegend?: boolean;
@@ -63,7 +63,7 @@ export interface ChartClinicRevisionStatus {
63
63
  }
64
64
  export interface ChartClinicBundleGuidance {
65
65
  readonly category?: ChartCategory;
66
- /** Prefer the pilot's explicit module when available, otherwise a family facade. */
66
+ /** Prefer the definition's explicit module when available, otherwise a family facade. */
67
67
  readonly recommendedImport?: string;
68
68
  readonly serverImport?: "semiotic/server";
69
69
  readonly docsRoute?: string;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * AUTO-GENERATED from chartSpecs.ts and chartDefinitionPilot.ts by
2
+ * AUTO-GENERATED from chartSpecs.ts and chartDefinitions.ts by
3
3
  * scripts/regenerate-schema.ts.
4
4
  * Do not edit by hand; run `npm run docs:chart-specs:schema`.
5
5
  */
@@ -9,7 +9,7 @@ interface ChartClinicMetadata {
9
9
  readonly recommendedImport: string;
10
10
  readonly serverImport?: "semiotic/server";
11
11
  readonly docsRoute?: string;
12
- readonly pilot?: true;
12
+ readonly definition?: true;
13
13
  }
14
14
  export declare const CHART_CLINIC_METADATA: Readonly<Record<string, ChartClinicMetadata>>;
15
15
  export {};
@@ -1,20 +1,9 @@
1
- /**
2
- * Additive ChartDefinition pilot registry.
3
- *
4
- * This is deliberately a descriptive, pure layer: it imports chart-spec
5
- * metadata but never React components, frame stores, server renderers, or
6
- * docs modules. The implementation, server, capability, and example links
7
- * are strings so hosts can decide what to load. Existing registries remain
8
- * authoritative while this seven-chart slice proves the boundary; the AI
9
- * schema generator now consumes this pilot for its seven component entries.
10
- */
11
- import { type ChartCapabilities, type ChartCategory, type ChartPropSpec, type ChartSpec, type PropType } from "./chartSpecs";
1
+ /** Pure chart definitions: metadata only, never component or renderer imports. */
2
+ import { type ChartCapabilities, type ChartCategory, type ChartPropSpec, type ChartSpec, type PropType } from "./chartSpecCore";
12
3
  /** Version of the definition shape, independently from the package version. */
13
4
  export declare const CHART_DEFINITION_SCHEMA_VERSION: 1;
14
- /** Version of this intentionally small, additive pilot manifest. */
15
- export declare const CHART_DEFINITION_PILOT_VERSION: "1.0.0";
16
- export declare const CHART_DEFINITION_PILOT_IDS: readonly ["LineChart", "BarChart", "ForceDirectedGraph", "FlowMap", "GaltonBoardChart", "RealtimeLineChart", "BigNumber"];
17
- export type ChartDefinitionPilotId = (typeof CHART_DEFINITION_PILOT_IDS)[number];
5
+ /** Version of the incremental chart definition manifest. */
6
+ export declare const CHART_DEFINITION_VERSION: "1.0.0";
18
7
  export type WireJsonType = Exclude<PropType, "function">;
19
8
  /**
20
9
  * Strictly serializable portion of a runtime prop. Function-only and
@@ -45,6 +34,7 @@ export interface LazyImplementationReference {
45
34
  export type ChartDefinitionServerSupport = {
46
35
  readonly mode: "render-chart";
47
36
  readonly chartConfig: string;
37
+ readonly implementation?: LazyImplementationReference;
48
38
  } | {
49
39
  readonly mode: "react-ssr-only";
50
40
  readonly reason: string;
@@ -52,9 +42,17 @@ export type ChartDefinitionServerSupport = {
52
42
  readonly mode: "unavailable";
53
43
  readonly reason: string;
54
44
  };
45
+ /** MCP rendering can be narrower than the public static server API. */
46
+ export type ChartDefinitionMCPSupport = {
47
+ readonly mode: "render-chart";
48
+ readonly category?: ChartCategory;
49
+ } | {
50
+ readonly mode: "unavailable";
51
+ readonly reason: string;
52
+ };
55
53
  /**
56
54
  * References into the current docs surface. They remain links for now: the
57
- * future ExampleDefinition registry will become the source of truth for them.
55
+ * ExampleDefinition registry owns gallery routes; chart-doc links name authored guides.
58
56
  */
59
57
  export interface ChartDefinitionExampleReference {
60
58
  /** `chart-doc` is an interactive documentation demo pending ExampleDefinition migration. */
@@ -62,7 +60,7 @@ export interface ChartDefinitionExampleReference {
62
60
  readonly route: string;
63
61
  readonly source: string;
64
62
  }
65
- /** Explicitly additive lifecycle truth; no pilot chart is deprecated. */
63
+ /** Explicit lifecycle metadata; no registered chart is deprecated. */
66
64
  export interface ChartDefinitionLifecycle {
67
65
  readonly status: "stable" | "experimental" | "deprecated" | "internal";
68
66
  readonly since?: string;
@@ -71,7 +69,7 @@ export interface ChartDefinitionLifecycle {
71
69
  readonly replacement?: string;
72
70
  };
73
71
  }
74
- /** Public docs page and the component identifier consumed by PropTable. */
72
+ /** Public guide and component identifier (also consumed by PropTable pages). */
75
73
  export interface ChartDefinitionPropDocs {
76
74
  readonly componentName: string;
77
75
  readonly route: string;
@@ -79,6 +77,8 @@ export interface ChartDefinitionPropDocs {
79
77
  }
80
78
  export interface ChartDefinitionMetadata {
81
79
  readonly description: string;
80
+ /** Explicit ChartSpec import override for AI schemas and MCP registration. */
81
+ readonly importPath?: string;
82
82
  /** Reused directly from ChartSpec while the existing capability registry leads. */
83
83
  readonly capabilities: ChartCapabilities;
84
84
  readonly capabilityModule: string;
@@ -89,11 +89,12 @@ export interface ChartDefinitionMetadata {
89
89
  readonly support: {
90
90
  readonly browser: "react";
91
91
  readonly server: ChartDefinitionServerSupport;
92
+ readonly mcp?: ChartDefinitionMCPSupport;
92
93
  };
93
94
  readonly examples: readonly ChartDefinitionExampleReference[];
94
95
  }
95
96
  /**
96
- * Minimal RFC-aligned manifest shape for the pilot. `wire` is intentionally
97
+ * Incremental manifest shape. `wire` is intentionally
97
98
  * serializable; richer prop metadata and lazy implementation references stay
98
99
  * under `runtime`.
99
100
  */
@@ -103,7 +104,7 @@ export interface ChartDefinition<TChart extends string = string> {
103
104
  readonly chartKind: TChart;
104
105
  readonly wire: {
105
106
  readonly chart: TChart;
106
- readonly version: typeof CHART_DEFINITION_PILOT_VERSION;
107
+ readonly version: typeof CHART_DEFINITION_VERSION;
107
108
  readonly schema: ChartDefinitionWireSchema;
108
109
  };
109
110
  readonly runtime: {
@@ -112,6 +113,14 @@ export interface ChartDefinition<TChart extends string = string> {
112
113
  };
113
114
  readonly metadata: ChartDefinitionMetadata;
114
115
  }
116
+ export interface ChartDefinitionReferences {
117
+ readonly implementation: LazyImplementationReference;
118
+ readonly capabilityModule: string;
119
+ readonly propDocs: ChartDefinitionPropDocs;
120
+ readonly server: ChartDefinitionServerSupport;
121
+ readonly mcp?: ChartDefinitionMCPSupport;
122
+ readonly examples: readonly ChartDefinitionExampleReference[];
123
+ }
115
124
  /**
116
125
  * Build a strict wire schema from the current ChartSpec without duplicating
117
126
  * the public prop declaration. This deliberately differs from the legacy AI
@@ -120,14 +129,7 @@ export interface ChartDefinition<TChart extends string = string> {
120
129
  * persisted/MCP wire boundary.
121
130
  */
122
131
  export declare function createChartDefinitionWireSchema(spec: ChartSpec): ChartDefinitionWireSchema;
123
- /**
124
- * One representative per chart family. The AI schema projection is the first
125
- * migrated downstream registry; other consumers remain on their established
126
- * registries until this boundary has enough evidence to expand.
127
- */
128
- export declare const CHART_DEFINITION_PILOT: Readonly<{
129
- [TChart in ChartDefinitionPilotId]: ChartDefinition<TChart>;
130
- }>;
132
+ export declare function createChartDefinition(spec: ChartSpec, references: ChartDefinitionReferences): ChartDefinition;
131
133
  export interface ChartDefinitionArtifact {
132
134
  readonly chart: string;
133
135
  readonly schemaVersion: typeof CHART_DEFINITION_SCHEMA_VERSION;
@@ -138,9 +140,3 @@ export interface ChartDefinitionArtifact {
138
140
  };
139
141
  readonly metadata: ChartDefinitionMetadata;
140
142
  }
141
- /**
142
- * Pure generation hook for future schema/docs/registry emitters. Its output is
143
- * JSON-serializable and intentionally has no component or server imports.
144
- */
145
- export declare function generateChartDefinitionArtifacts(registry?: Readonly<Record<string, ChartDefinition>>): readonly ChartDefinitionArtifact[];
146
- export declare function getChartDefinition(chart: string): ChartDefinition<ChartDefinitionPilotId> | undefined;
@@ -0,0 +1,10 @@
1
+ import { type ChartDefinition, type ChartDefinitionArtifact } from "./chartDefinition";
2
+ export * from "./chartDefinition";
3
+ export declare const CHART_DEFINITIONS: Readonly<Record<string, ChartDefinition>>;
4
+ export declare const CHART_DEFINITION_IDS: string[];
5
+ /**
6
+ * Pure generation hook for future schema/docs/registry emitters. Its output is
7
+ * JSON-serializable and intentionally has no component or server imports.
8
+ */
9
+ export declare function generateChartDefinitionArtifacts(registry?: Readonly<Record<string, ChartDefinition>>): readonly ChartDefinitionArtifact[];
10
+ export declare function getChartDefinition(chart: string): ChartDefinition | undefined;
@@ -0,0 +1,17 @@
1
+ import { type ChartDefinition } from "./chartDefinition";
2
+ /** Network registration references, including the two network Atlas readers. */
3
+ declare const references: {
4
+ readonly MotifBraidChart: readonly ["motif-braid-chart", "motifBraidChart", "serverChartConfigsAtlas"];
5
+ readonly DependencyForestChart: readonly ["dependency-forest-chart", "dependencyForestChart", "serverChartConfigsAtlas"];
6
+ readonly ForceDirectedGraph: readonly ["force-directed-graph", "forceDirectedGraph", "serverChartConfigsNetwork"];
7
+ readonly SankeyDiagram: readonly ["sankey-diagram", "sankeyDiagram", "serverChartConfigsNetwork"];
8
+ readonly ProcessSankey: readonly ["process-sankey", "processSankey", "serverChartConfigsNetwork"];
9
+ readonly ChordDiagram: readonly ["chord-diagram", "chordDiagram", "serverChartConfigsNetwork"];
10
+ readonly TreeDiagram: readonly ["tree-diagram", "treeDiagram", "serverChartConfigsNetwork"];
11
+ readonly Treemap: readonly ["treemap", "treemap", "serverChartConfigsNetwork"];
12
+ readonly CirclePack: readonly ["circle-pack", "circlePack", "serverChartConfigsNetwork"];
13
+ readonly OrbitDiagram: readonly ["orbit-diagram", "orbitDiagram", "serverChartConfigsNetwork"];
14
+ };
15
+ export type NetworkChartDefinitionId = keyof typeof references;
16
+ export declare const NETWORK_CHART_DEFINITIONS: Readonly<Record<NetworkChartDefinitionId, ChartDefinition>>;
17
+ export {};
@@ -0,0 +1,23 @@
1
+ import { type ChartDefinition } from "./chartDefinition";
2
+ /** Ordinal registration references; chart specs continue to own props and capabilities. */
3
+ declare const references: {
4
+ readonly BarChart: readonly ["bar-chart", "barChart"];
5
+ readonly StackedBarChart: readonly ["stacked-bar-chart", "stackedBarChart"];
6
+ readonly GroupedBarChart: readonly ["grouped-bar-chart", "groupedBarChart"];
7
+ readonly SwarmPlot: readonly ["swarm-plot", "swarmPlot"];
8
+ readonly BoxPlot: readonly ["box-plot", "boxPlot"];
9
+ readonly Histogram: readonly ["histogram", "histogram"];
10
+ readonly ViolinPlot: readonly ["violin-plot", "violinPlot"];
11
+ readonly RidgelinePlot: readonly ["ridgeline-plot", "ridgelinePlot"];
12
+ readonly DotPlot: readonly ["dot-plot", "dotPlot"];
13
+ readonly PieChart: readonly ["pie-chart", "pieChart"];
14
+ readonly DonutChart: readonly ["donut-chart", "donutChart"];
15
+ readonly GaugeChart: readonly ["gauge-chart", "gaugeChart"];
16
+ readonly FunnelChart: readonly ["funnel-chart", "funnelChart"];
17
+ readonly RadarChart: readonly ["radar-chart", "radarChart"];
18
+ readonly SwimlaneChart: readonly ["swimlane-chart", "swimlaneChart"];
19
+ readonly LikertChart: readonly ["likert-chart", "likertChart"];
20
+ };
21
+ export type OrdinalChartDefinitionId = keyof typeof references;
22
+ export declare const ORDINAL_CHART_DEFINITIONS: Readonly<Record<OrdinalChartDefinitionId, ChartDefinition>>;
23
+ export {};
@@ -0,0 +1,17 @@
1
+ import { type ChartDefinition } from "./chartDefinition";
2
+ /** Physics registration references, including the Atlas Flow Circuit reader. */
3
+ declare const references: {
4
+ readonly FlowCircuitChart: readonly ["flow-circuit-chart", "flowCircuitChart", "serverChartConfigsAtlas"];
5
+ readonly GaltonBoardChart: readonly ["galton-board-chart", "galtonBoardChart", "serverChartConfigsPhysics"];
6
+ readonly EventDropChart: readonly ["event-drop-chart", "eventDropChart", "serverChartConfigsPhysics"];
7
+ readonly UnitPileChart: readonly ["unit-pile-chart", "unitPileChart", "serverChartConfigsPhysics"];
8
+ readonly CollisionSwarmChart: readonly ["collision-swarm-chart", "collisionSwarmChart", "serverChartConfigsPhysics"];
9
+ readonly PacketFlowChart: readonly ["packet-flow-chart", "packetFlowChart", "serverChartConfigsPhysics"];
10
+ readonly ProcessFlowChart: readonly ["process-flow-chart", "processFlowChart", "serverChartConfigsPhysics"];
11
+ readonly GauntletChart: readonly ["gauntlet-chart", "gauntletChart", "serverChartConfigsPhysics"];
12
+ readonly CrucibleChart: readonly ["crucible-chart", "crucibleChart", "serverChartConfigsPhysics"];
13
+ readonly ChainReactionChart: readonly ["chain-reaction-chart", "chainReactionChart", "serverChartConfigsComposite"];
14
+ };
15
+ export type PhysicsChartDefinitionId = keyof typeof references;
16
+ export declare const PHYSICS_CHART_DEFINITIONS: Readonly<Record<PhysicsChartDefinitionId, ChartDefinition>>;
17
+ export {};
@@ -0,0 +1,12 @@
1
+ import { type ChartDefinition } from "./chartDefinition";
2
+ declare const references: {
3
+ readonly RealtimeLineChart: readonly ["realtime-line-chart", "realtimeLineChart"];
4
+ readonly RealtimeHistogram: readonly ["realtime-histogram", "realtimeHistogram"];
5
+ readonly TemporalHistogram: readonly ["realtime-histogram", "temporalHistogram"];
6
+ readonly RealtimeSwarmChart: readonly ["realtime-swarm-chart", "realtimeSwarmChart"];
7
+ readonly RealtimeWaterfallChart: readonly ["realtime-waterfall-chart", "realtimeWaterfallChart"];
8
+ readonly RealtimeHeatmap: readonly ["realtime-heatmap", "realtimeHeatmap"];
9
+ };
10
+ export type RealtimeChartDefinitionId = keyof typeof references;
11
+ export declare const REALTIME_CHART_DEFINITIONS: Readonly<Record<RealtimeChartDefinitionId, ChartDefinition>>;
12
+ export {};
@@ -0,0 +1,26 @@
1
+ import { type ChartDefinition } from "./chartDefinition";
2
+ /**
3
+ * Author the XY registration once. The chart specs still own props and
4
+ * capabilities; these references own documentation and renderer wiring.
5
+ * Paths are data for generators, never runtime imports.
6
+ */
7
+ declare const references: {
8
+ readonly LineChart: readonly ["line-chart", "lineChart", "serverChartConfigsXY"];
9
+ readonly BumpChart: readonly ["bump-chart", "bumpChart", "serverChartConfigsXY"];
10
+ readonly AreaChart: readonly ["area-chart", "areaChart", "serverChartConfigsXY"];
11
+ readonly DifferenceChart: readonly ["difference-chart", "differenceChart", "serverChartConfigsXY"];
12
+ readonly StackedAreaChart: readonly ["stacked-area-chart", "stackedAreaChart", "serverChartConfigsXY"];
13
+ readonly Scatterplot: readonly ["scatterplot", "scatterplot", "serverChartConfigsXY"];
14
+ readonly BubbleChart: readonly ["bubble-chart", "bubbleChart", "serverChartConfigsXY"];
15
+ readonly Heatmap: readonly ["heatmap", "heatmap", "serverChartConfigHeatmap"];
16
+ readonly QuadrantChart: readonly ["quadrant-chart", "quadrantChart", "serverChartConfigsXY"];
17
+ readonly MultiAxisLineChart: readonly ["multi-axis-line-chart", "multiAxisLineChart", "serverChartConfigsXY"];
18
+ readonly WaterfallChart: readonly ["waterfall-chart", "waterfallChart", "serverChartConfigsXY"];
19
+ readonly CandlestickChart: readonly ["candlestick-chart", "candlestickChart", "serverChartConfigsXY"];
20
+ readonly ConnectedScatterplot: readonly ["connected-scatterplot", "connectedScatterplot", "serverChartConfigsXY"];
21
+ readonly ScatterplotMatrix: readonly ["scatterplot-matrix", "scatterplotMatrix", "serverChartConfigsComposite"];
22
+ readonly MinimapChart: readonly ["time-series-brush", "minimapChart", "serverChartConfigsComposite"];
23
+ };
24
+ export type XYChartDefinitionId = keyof typeof references;
25
+ export declare const XY_CHART_DEFINITIONS: Readonly<Record<XYChartDefinitionId, ChartDefinition>>;
26
+ export {};
@@ -103,7 +103,7 @@ export interface ChartSetupResult {
103
103
  * memo cache hits are preserved in the common case.
104
104
  */
105
105
  data: Array<Datum>;
106
- /** Color scale function, or undefined if no colorBy */
106
+ /** Color scale for controlled or discovered push categories; undefined without colorBy. */
107
107
  colorScale: ((v: string) => string) | undefined;
108
108
  /** Resolved category colors, including categories discovered in push mode. */
109
109
  categoryColorScale: ((v: string) => string) | undefined;
@@ -78,7 +78,7 @@ export interface NetworkChartSetupResult {
78
78
  /** Sparse-filtered edges. Identity-equal to input when nothing was dropped. */
79
79
  safeEdges: Datum[];
80
80
  /**
81
- * Color scale built from `(safeNodes, colorBy, colorScheme)`.
81
+ * Color scale built from controlled nodes or frame-discovered push categories.
82
82
  * `undefined` when colorBy is unset.
83
83
  */
84
84
  colorScale: ((v: string) => string) | undefined;
@@ -6,6 +6,7 @@ import type { Datum } from "../charts/shared/datumTypes";
6
6
  /**
7
7
  * Bin continuous data into histogram-ready format.
8
8
  * Returns array of { category, value } objects suitable for BarChart.
9
+ * Values outside a custom domain are excluded; both endpoints are included.
9
10
  */
10
11
  export declare function bin<T extends Datum>(data: T[], options: {
11
12
  field: string;
@@ -1,57 +1,61 @@
1
- /**
2
- * Chart-specific prop mapping for renderChart().
3
- *
4
- * Family implementations live in serverChartConfigs{XY,Ordinal,Network,Geo,Custom,Physics}.ts.
5
- */
6
1
  import type { ChartConfig } from "./serverChartConfigShared";
7
2
  export declare const CHART_CONFIGS: {
8
- MotifBraidChart: ChartConfig;
9
- DependencyForestChart: ChartConfig;
10
- FlowCircuitChart: ChartConfig;
11
3
  Sparkline: ChartConfig;
12
- BumpChart: ChartConfig;
4
+ XYCustomChart: ChartConfig;
5
+ OrdinalCustomChart: ChartConfig;
6
+ ParallelCoordinatesRecipe: ChartConfig;
7
+ CalendarHeatmapRecipe: ChartConfig;
8
+ NetworkCustomChart: ChartConfig;
9
+ ChoroplethMap: ChartConfig;
10
+ ProportionalSymbolMap: ChartConfig;
11
+ FlowMap: ChartConfig;
12
+ DistanceCartogram: ChartConfig;
13
+ GeoCustomChart: ChartConfig;
14
+ PhysicsCustomChart: ChartConfig;
15
+ } & {
13
16
  LineChart: ChartConfig;
17
+ BumpChart: ChartConfig;
14
18
  AreaChart: ChartConfig;
15
19
  DifferenceChart: ChartConfig;
16
20
  StackedAreaChart: ChartConfig;
17
21
  Scatterplot: ChartConfig;
18
- CandlestickChart: ChartConfig;
19
22
  BubbleChart: ChartConfig;
20
- ConnectedScatterplot: ChartConfig;
21
- QuadrantChart: ChartConfig;
22
23
  Heatmap: ChartConfig;
23
- WaterfallChart: ChartConfig;
24
+ QuadrantChart: ChartConfig;
24
25
  MultiAxisLineChart: ChartConfig;
25
- MinimapChart: ChartConfig;
26
+ WaterfallChart: ChartConfig;
27
+ CandlestickChart: ChartConfig;
28
+ ConnectedScatterplot: ChartConfig;
26
29
  ScatterplotMatrix: ChartConfig;
27
- TemporalHistogram: ChartConfig;
30
+ MinimapChart: ChartConfig;
31
+ } & {
28
32
  RealtimeLineChart: ChartConfig;
29
33
  RealtimeHistogram: ChartConfig;
30
- RealtimeHeatmap: ChartConfig;
34
+ TemporalHistogram: ChartConfig;
31
35
  RealtimeSwarmChart: ChartConfig;
32
36
  RealtimeWaterfallChart: ChartConfig;
33
- XYCustomChart: ChartConfig;
37
+ RealtimeHeatmap: ChartConfig;
38
+ } & {
34
39
  BarChart: ChartConfig;
35
40
  StackedBarChart: ChartConfig;
36
41
  GroupedBarChart: ChartConfig;
37
- PieChart: ChartConfig;
38
- DonutChart: ChartConfig;
39
- Histogram: ChartConfig;
42
+ SwarmPlot: ChartConfig;
40
43
  BoxPlot: ChartConfig;
44
+ Histogram: ChartConfig;
41
45
  ViolinPlot: ChartConfig;
42
- SwarmPlot: ChartConfig;
43
- DotPlot: ChartConfig;
44
- SwimlaneChart: ChartConfig;
45
46
  RidgelinePlot: ChartConfig;
46
- LikertChart: ChartConfig;
47
+ DotPlot: ChartConfig;
48
+ PieChart: ChartConfig;
49
+ DonutChart: ChartConfig;
50
+ GaugeChart: ChartConfig;
47
51
  FunnelChart: ChartConfig;
48
52
  RadarChart: ChartConfig;
49
- GaugeChart: ChartConfig;
50
- OrdinalCustomChart: ChartConfig;
51
- ParallelCoordinatesRecipe: ChartConfig;
52
- CalendarHeatmapRecipe: ChartConfig;
53
+ SwimlaneChart: ChartConfig;
54
+ LikertChart: ChartConfig;
55
+ } & {
56
+ MotifBraidChart: ChartConfig;
57
+ DependencyForestChart: ChartConfig;
53
58
  ForceDirectedGraph: ChartConfig;
54
- NetworkCustomChart: ChartConfig;
55
59
  SankeyDiagram: ChartConfig;
56
60
  ProcessSankey: ChartConfig;
57
61
  ChordDiagram: ChartConfig;
@@ -59,19 +63,15 @@ export declare const CHART_CONFIGS: {
59
63
  Treemap: ChartConfig;
60
64
  CirclePack: ChartConfig;
61
65
  OrbitDiagram: ChartConfig;
62
- ChoroplethMap: ChartConfig;
63
- ProportionalSymbolMap: ChartConfig;
64
- FlowMap: ChartConfig;
65
- DistanceCartogram: ChartConfig;
66
- GeoCustomChart: ChartConfig;
66
+ } & {
67
+ FlowCircuitChart: ChartConfig;
67
68
  GaltonBoardChart: ChartConfig;
68
69
  EventDropChart: ChartConfig;
69
70
  UnitPileChart: ChartConfig;
70
71
  CollisionSwarmChart: ChartConfig;
72
+ PacketFlowChart: ChartConfig;
71
73
  ProcessFlowChart: ChartConfig;
72
74
  GauntletChart: ChartConfig;
73
75
  CrucibleChart: ChartConfig;
74
- PacketFlowChart: ChartConfig;
75
76
  ChainReactionChart: ChartConfig;
76
- PhysicsCustomChart: ChartConfig;
77
77
  };
@@ -0,0 +1,17 @@
1
+ /**
2
+ * AUTO-GENERATED from chartDefinitionsNetwork.ts by scripts/regenerate-schema.ts.
3
+ * Do not edit by hand; run `npm run docs:chart-specs:schema`.
4
+ */
5
+ import type { ChartConfig } from "./serverChartConfigShared";
6
+ export declare const NETWORK_CHART_CONFIGS: {
7
+ MotifBraidChart: ChartConfig;
8
+ DependencyForestChart: ChartConfig;
9
+ ForceDirectedGraph: ChartConfig;
10
+ SankeyDiagram: ChartConfig;
11
+ ProcessSankey: ChartConfig;
12
+ ChordDiagram: ChartConfig;
13
+ TreeDiagram: ChartConfig;
14
+ Treemap: ChartConfig;
15
+ CirclePack: ChartConfig;
16
+ OrbitDiagram: ChartConfig;
17
+ };
@@ -0,0 +1,23 @@
1
+ /**
2
+ * AUTO-GENERATED from chartDefinitionsOrdinal.ts by scripts/regenerate-schema.ts.
3
+ * Do not edit by hand; run `npm run docs:chart-specs:schema`.
4
+ */
5
+ import type { ChartConfig } from "./serverChartConfigShared";
6
+ export declare const ORDINAL_CHART_CONFIGS: {
7
+ BarChart: ChartConfig;
8
+ StackedBarChart: ChartConfig;
9
+ GroupedBarChart: ChartConfig;
10
+ SwarmPlot: ChartConfig;
11
+ BoxPlot: ChartConfig;
12
+ Histogram: ChartConfig;
13
+ ViolinPlot: ChartConfig;
14
+ RidgelinePlot: ChartConfig;
15
+ DotPlot: ChartConfig;
16
+ PieChart: ChartConfig;
17
+ DonutChart: ChartConfig;
18
+ GaugeChart: ChartConfig;
19
+ FunnelChart: ChartConfig;
20
+ RadarChart: ChartConfig;
21
+ SwimlaneChart: ChartConfig;
22
+ LikertChart: ChartConfig;
23
+ };
@@ -0,0 +1,17 @@
1
+ /**
2
+ * AUTO-GENERATED from chartDefinitionsPhysics.ts by scripts/regenerate-schema.ts.
3
+ * Do not edit by hand; run `npm run docs:chart-specs:schema`.
4
+ */
5
+ import type { ChartConfig } from "./serverChartConfigShared";
6
+ export declare const PHYSICS_CHART_CONFIGS: {
7
+ FlowCircuitChart: ChartConfig;
8
+ GaltonBoardChart: ChartConfig;
9
+ EventDropChart: ChartConfig;
10
+ UnitPileChart: ChartConfig;
11
+ CollisionSwarmChart: ChartConfig;
12
+ PacketFlowChart: ChartConfig;
13
+ ProcessFlowChart: ChartConfig;
14
+ GauntletChart: ChartConfig;
15
+ CrucibleChart: ChartConfig;
16
+ ChainReactionChart: ChartConfig;
17
+ };
@@ -0,0 +1,13 @@
1
+ /**
2
+ * AUTO-GENERATED from chartDefinitionsRealtime.ts by scripts/regenerate-schema.ts.
3
+ * Do not edit by hand; run `npm run docs:chart-specs:schema`.
4
+ */
5
+ import type { ChartConfig } from "./serverChartConfigShared";
6
+ export declare const REALTIME_CHART_CONFIGS: {
7
+ RealtimeLineChart: ChartConfig;
8
+ RealtimeHistogram: ChartConfig;
9
+ TemporalHistogram: ChartConfig;
10
+ RealtimeSwarmChart: ChartConfig;
11
+ RealtimeWaterfallChart: ChartConfig;
12
+ RealtimeHeatmap: ChartConfig;
13
+ };
@@ -0,0 +1,22 @@
1
+ /**
2
+ * AUTO-GENERATED from chartDefinitionsXY.ts by scripts/regenerate-schema.ts.
3
+ * Do not edit by hand; run `npm run docs:chart-specs:schema`.
4
+ */
5
+ import type { ChartConfig } from "./serverChartConfigShared";
6
+ export declare const XY_CHART_CONFIGS: {
7
+ LineChart: ChartConfig;
8
+ BumpChart: ChartConfig;
9
+ AreaChart: ChartConfig;
10
+ DifferenceChart: ChartConfig;
11
+ StackedAreaChart: ChartConfig;
12
+ Scatterplot: ChartConfig;
13
+ BubbleChart: ChartConfig;
14
+ Heatmap: ChartConfig;
15
+ QuadrantChart: ChartConfig;
16
+ MultiAxisLineChart: ChartConfig;
17
+ WaterfallChart: ChartConfig;
18
+ CandlestickChart: ChartConfig;
19
+ ConnectedScatterplot: ChartConfig;
20
+ ScatterplotMatrix: ChartConfig;
21
+ MinimapChart: ChartConfig;
22
+ };
@@ -9,4 +9,9 @@ export declare class PhysicsOptionalEngineDependencyError extends Error {
9
9
  constructor(details: PhysicsOptionalEngineInstallDetails, cause?: unknown);
10
10
  }
11
11
  export declare function optionalEngineDependencyError(details: PhysicsOptionalEngineInstallDetails, cause?: unknown): PhysicsOptionalEngineDependencyError;
12
+ /**
13
+ * Load a runtime-selected specifier using the host's native import resolver.
14
+ * Browsers require a resolvable URL or an import map for bare package names.
15
+ * Use the named Matter/Rapier loaders for bundler-managed npm dependencies.
16
+ */
12
17
  export declare function loadOptionalPhysicsPeer(details: PhysicsOptionalEngineInstallDetails): Promise<unknown>;