semiotic 3.8.8 → 3.9.0
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.
- package/README.md +82 -66
- package/agent-skill/semiotic-charts/SKILL.md +11 -2
- package/ai/behaviorContracts.cjs +33 -3
- package/ai/cli.js +53 -2
- package/ai/componentMetadata.cjs +15 -0
- package/ai/dist/mcp-server.js +1530 -611
- package/ai/examples.md +48 -42
- package/{CLAUDE.md → ai/reference.md} +46 -24
- package/ai/schema.json +10704 -825
- package/ai/surface-manifest.json +643 -2
- package/ai/system-prompt.md +83 -130
- package/dist/c-3BLJEQNG.min.js +1 -0
- package/dist/c-3KZD6AXJ.min.js +1 -0
- package/dist/c-4TWEX5HG.min.js +1 -0
- package/dist/c-52TEGIUJ.min.js +1 -0
- package/dist/c-5YCIX3VZ.min.js +1 -0
- package/dist/c-6FEKTA3U.min.js +1 -0
- package/dist/c-6O5EVOPH.min.js +1 -0
- package/dist/c-74HEEZGK.min.js +1 -0
- package/dist/c-AKAF6JAD.min.js +1 -0
- package/dist/c-BBKITSXB.min.js +1 -0
- package/dist/c-BWNB6USU.min.js +1 -0
- package/dist/c-C25ENHIK.min.js +1 -0
- package/dist/c-CDR5AO3R.min.js +1 -0
- package/dist/c-COHXCW3Q.min.js +1 -0
- package/dist/{chunk-scatterplotMatrixBrushOverlay-SDIZSN66.module.min.js → c-DADXPJXV.min.js} +0 -1
- package/dist/c-E3JFRRMI.min.js +1 -0
- package/dist/c-EBFPQHHO.min.js +1 -0
- package/dist/c-G36WS6LN.min.js +1 -0
- package/dist/c-GIKRQI4X.min.js +1 -0
- package/dist/c-GPYOFETM.min.js +1 -0
- package/dist/c-IDUHYYSI.min.js +1 -0
- package/dist/{chunk-chunk-FQPKOAIH.module.min.js → c-IUHFPMHD.min.js} +0 -1
- package/dist/c-J5G56TUH.min.js +1 -0
- package/dist/c-JAZ73J32.min.js +1 -0
- package/dist/c-KG3NXHAL.min.js +1 -0
- package/dist/c-KII3PLZE.min.js +1 -0
- package/dist/c-LIXGXMNS.min.js +1 -0
- package/dist/c-LVEY6D6B.min.js +1 -0
- package/dist/c-M4Y3BHFR.min.js +1 -0
- package/dist/c-MAIICR2Z.min.js +1 -0
- package/dist/c-MG5DM6VE.min.js +1 -0
- package/dist/{chunk-minimapBrushOverlay-JU57U7NM.module.min.js → c-MNF2S4AA.min.js} +0 -1
- package/dist/c-MT3WBK7M.min.js +1 -0
- package/dist/c-NY3JWV2K.min.js +1 -0
- package/dist/c-O6U6K4CW.min.js +1 -0
- package/dist/c-OCI56QF2.min.js +1 -0
- package/dist/c-OQ7M4AGV.min.js +1 -0
- package/dist/c-OXYMVK7Q.min.js +1 -0
- package/dist/c-PPWDL5ZI.min.js +1 -0
- package/dist/c-QHF5YON3.min.js +1 -0
- package/dist/c-RR3GO5SW.min.js +1 -0
- package/dist/{chunk-chunk-J5QD4RAM.module.min.js → c-RSVIHIQ4.min.js} +0 -1
- package/dist/{chunk-chunk-EMO5NUGE.module.min.js → c-S2BXNNJN.min.js} +0 -1
- package/dist/{chunk-chunk-YCQYG6J5.module.min.js → c-SLGMUBUL.min.js} +0 -1
- package/dist/c-SUILCHWU.min.js +1 -0
- package/dist/c-TZW3JGJ5.min.js +1 -0
- package/dist/c-US5ZFT6E.min.js +1 -0
- package/dist/{chunk-chunk-RZH7VZYS.module.min.js → c-USFMFKIH.min.js} +0 -1
- package/dist/c-UUKVD4WB.min.js +1 -0
- package/dist/{chunk-chunk-SV4XAZ3Q.module.min.js → c-VGW3VG3I.min.js} +0 -1
- package/dist/c-W3CE4A4S.min.js +1 -0
- package/dist/{chunk-chunk-2NVFEB7P.module.min.js → c-WJCD5EUY.min.js} +0 -1
- package/dist/{chunk-chunk-2JGJ5GUG.module.min.js → c-X5UBGU2V.min.js} +0 -1
- package/dist/c-YDAY2WFR.min.js +1 -0
- package/dist/c-ZOWWU34K.min.js +1 -0
- package/dist/components/AccessibleNavTree.d.ts +1 -1
- package/dist/components/CategoryColors.d.ts +1 -1
- package/dist/components/GradientLegend.d.ts +14 -0
- package/dist/components/Legend.d.ts +2 -7
- package/dist/components/LinkedCharts.d.ts +1 -1
- package/dist/components/MobileAnnotationCalloutList.d.ts +1 -1
- package/dist/components/ObservationReadout.d.ts +45 -0
- package/dist/components/ThemeProvider.d.ts +4 -4
- package/dist/components/Tooltip/FlippingTooltip.d.ts +5 -7
- package/dist/components/Tooltip/Tooltip.d.ts +83 -5
- package/dist/components/Tooltip/tooltipChrome.d.ts +43 -0
- package/dist/components/ai/chartCapabilityTypes.d.ts +86 -2
- package/dist/components/ai/chartClinic.d.ts +2 -0
- package/dist/components/ai/deriveProfileFields.d.ts +40 -0
- package/dist/components/ai/evaluateChart.d.ts +85 -0
- package/dist/components/ai/fieldPolicy.d.ts +7 -0
- package/dist/components/ai/fieldRoles.d.ts +24 -0
- package/dist/components/ai/generativeChart.d.ts +18 -2
- package/dist/components/ai/inferIntent.d.ts +26 -2
- package/dist/components/ai/intents.d.ts +35 -0
- package/dist/components/ai/navigationTree.d.ts +2 -2
- package/dist/components/ai/observedSceneAudit.d.ts +2 -1
- package/dist/components/ai/profileData.d.ts +11 -0
- package/dist/components/ai/repairChartConfig.d.ts +2 -3
- package/dist/components/ai/semanticEvidence.d.ts +4 -0
- package/dist/components/ai/semanticViability.d.ts +11 -0
- package/dist/components/ai/semanticViabilityRegistry.d.ts +5 -0
- package/dist/components/ai/streamingTypes.d.ts +4 -0
- package/dist/components/ai/suggestCharts.d.ts +5 -6
- package/dist/components/ai/suggestDashboard.d.ts +2 -3
- package/dist/components/ai/suggestStreamCharts.d.ts +1 -1
- package/dist/components/ai/suggestStretchCharts.d.ts +2 -3
- package/dist/components/ai/suggestionPropContracts.d.ts +20 -0
- package/dist/components/ai/variantDiscovery.d.ts +3 -1
- package/dist/components/charts/custom/NetworkCustomChart.d.ts +3 -0
- package/dist/components/charts/custom/OrdinalCustomChart.d.ts +3 -0
- package/dist/components/charts/custom/XYCustomChart.d.ts +1 -1
- package/dist/components/charts/geo/ChoroplethMap.d.ts +3 -1
- package/dist/components/charts/geo/DistanceCartogram.d.ts +2 -7
- package/dist/components/charts/geo/cartogramOverlay.d.ts +28 -0
- package/dist/components/charts/index.d.ts +4 -3
- package/dist/components/charts/network/ProcessSankey.d.ts +2 -136
- package/dist/components/charts/network/ProcessSankeyProps.d.ts +139 -0
- package/dist/components/charts/network/Treemap.d.ts +2 -1
- package/dist/components/charts/network/processSankey/boundaryHubOrdering.d.ts +23 -0
- package/dist/components/charts/network/processSankey/layoutGeometry.d.ts +2 -0
- package/dist/components/charts/network/processSankey/ordering.d.ts +3 -41
- package/dist/components/charts/network/processSankey/orderingTypes.d.ts +32 -0
- package/dist/components/charts/network/processSankey/packing.d.ts +1 -1
- package/dist/components/charts/network/processSankey/packingCache.d.ts +1 -1
- package/dist/components/charts/network/processSankey/packingOptimization.d.ts +72 -0
- package/dist/components/charts/ordinal/BarChart.d.ts +4 -3
- package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +3 -2
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +4 -3
- package/dist/components/charts/ordinal/SwimlaneChart.d.ts +2 -2
- package/dist/components/charts/physics/GaltonBoardChart.d.ts +2 -9
- package/dist/components/charts/physics/GauntletChart.d.ts +10 -41
- package/dist/components/charts/physics/ProcessFlowChart.d.ts +1 -1
- package/dist/components/charts/physics/chainReactionAccessibleTable.d.ts +9 -0
- package/dist/components/charts/physics/chainReactionRuntime.d.ts +2 -1
- package/dist/components/charts/physics/chainReactionTypes.d.ts +6 -1
- package/dist/components/charts/physics/crucibleBodyRenderers.d.ts +2 -2
- package/dist/components/charts/physics/crucibleClone.d.ts +6 -0
- package/dist/components/charts/physics/crucibleEffects.d.ts +1 -2
- package/dist/components/charts/physics/crucibleRecord.d.ts +7 -0
- package/dist/components/charts/physics/gauntletChrome.d.ts +4 -4
- package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
- package/dist/components/charts/physics/gauntletPublic.d.ts +4 -0
- package/dist/components/charts/physics/packetFlowOverlay.d.ts +7 -0
- package/dist/components/charts/physics/physicsChartLayout.d.ts +8 -0
- package/dist/components/charts/physics/physicsChartShared.d.ts +3 -1
- package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
- package/dist/components/charts/physics/physicsHocUtils.d.ts +26 -13
- package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +24 -0
- package/dist/components/charts/physics/processFlowOverlays.d.ts +9 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +17 -12
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +12 -7
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +37 -14
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +23 -14
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +22 -13
- package/dist/components/charts/realtime/aggregate.d.ts +4 -1
- package/dist/components/charts/realtime/eventTime.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +27 -0
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +30 -0
- package/dist/components/charts/realtime/useRealtimeCategoryColors.d.ts +30 -0
- package/dist/components/charts/shared/FrameTextAnnotationSVG.d.ts +10 -0
- package/dist/components/charts/shared/annotationActivation.d.ts +3 -7
- package/dist/components/charts/shared/annotationBandFill.d.ts +6 -0
- package/dist/components/charts/shared/annotationDispatch.d.ts +31 -0
- package/dist/components/charts/shared/annotationIdentity.d.ts +8 -0
- package/dist/components/charts/shared/annotationRules.d.ts +1 -15
- package/dist/components/charts/shared/boundedCategoryRegistry.d.ts +8 -0
- package/dist/components/charts/shared/chainReactionChartSpec.d.ts +3 -0
- package/dist/components/charts/shared/chartMode.d.ts +3 -2
- package/dist/components/charts/shared/chartSpecCore.d.ts +1 -0
- package/dist/components/charts/shared/formatUtils.d.ts +40 -9
- package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
- package/dist/components/charts/shared/gradient.d.ts +16 -0
- package/dist/components/charts/shared/hatchFill.d.ts +15 -0
- package/dist/components/charts/shared/hooks.d.ts +4 -4
- package/dist/components/charts/shared/legendUtils.d.ts +1 -0
- package/dist/components/charts/shared/streamPropsHelpers.d.ts +3 -1
- package/dist/components/charts/shared/styleRules.d.ts +9 -2
- package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
- package/dist/components/charts/shared/types.d.ts +26 -10
- package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
- package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
- package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
- package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
- package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
- package/dist/components/charts/value/types.d.ts +1 -1
- package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
- package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
- package/dist/components/charts/xy/BumpChart.d.ts +13 -73
- package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
- package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
- package/dist/components/charts/xy/LineChart.d.ts +2 -2
- package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
- package/dist/components/charts/xy/bumpData.d.ts +44 -0
- package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
- package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
- package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
- package/dist/components/legendLayout.d.ts +131 -4
- package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
- package/dist/components/realtime/types.d.ts +10 -1
- package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
- package/dist/components/recipes/directedReachability.d.ts +14 -0
- package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
- package/dist/components/recipes/gridObservatory.d.ts +1 -1
- package/dist/components/recipes/networkAnalysis.d.ts +1 -18
- package/dist/components/recipes/physics.d.ts +7 -4
- package/dist/components/recipes/processPhysics.d.ts +0 -1
- package/dist/components/recipes/waffle.d.ts +7 -4
- package/dist/components/semiotic-ai-core.d.ts +13 -4
- package/dist/components/semiotic-ai-observations.d.ts +3 -0
- package/dist/components/semiotic-ai.d.ts +16 -9
- package/dist/components/semiotic-client-shared.d.ts +10 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-geo.d.ts +4 -1
- package/dist/components/semiotic-network.d.ts +7 -4
- package/dist/components/semiotic-ordinal.d.ts +4 -1
- package/dist/components/semiotic-physics.d.ts +11 -4
- package/dist/components/semiotic-realtime-core.d.ts +11 -4
- package/dist/components/semiotic-realtime-react.d.ts +4 -3
- package/dist/components/semiotic-realtime.d.ts +3 -1
- package/dist/components/semiotic-recipes-core.d.ts +7 -5
- package/dist/components/semiotic-server-edge.d.ts +3 -2
- package/dist/components/semiotic-server.d.ts +3 -2
- package/dist/components/semiotic-themes-core.d.ts +5 -48
- package/dist/components/semiotic-utils-core.d.ts +11 -5
- package/dist/components/semiotic-utils-react.d.ts +2 -0
- package/dist/components/semiotic-xy.d.ts +4 -1
- package/dist/components/semiotic.d.ts +68 -25
- package/dist/components/server/animatedGif.d.ts +1 -1
- package/dist/components/server/renderEvidence.d.ts +25 -2
- package/dist/components/server/renderToStaticSVG.d.ts +15 -7
- package/dist/components/server/serverChartConfigShared.d.ts +8 -1
- package/dist/components/server/serverChartConfigs.d.ts +1 -0
- package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
- package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
- package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
- package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
- package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
- package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
- package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
- package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
- package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
- package/dist/components/server/staticAnnotations.d.ts +28 -1
- package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
- package/dist/components/server/staticLegend.d.ts +1 -1
- package/dist/components/server/staticLegendMargin.d.ts +41 -0
- package/dist/components/server/staticOrdinal.d.ts +8 -2
- package/dist/components/server/staticPhysics.d.ts +13 -1
- package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
- package/dist/components/server/staticRawLegend.d.ts +15 -0
- package/dist/components/server/staticSVGChrome.d.ts +16 -55
- package/dist/components/server/staticXYAxes.d.ts +27 -0
- package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
- package/dist/components/server/staticXYGrid.d.ts +11 -0
- package/dist/components/server/themeResolver.d.ts +5 -1
- package/dist/components/store/ThemeStore.d.ts +2 -98
- package/dist/components/store/designTokens.d.ts +1 -1
- package/dist/components/store/themeCSSVariables.d.ts +10 -0
- package/dist/components/store/themeCore.d.ts +91 -0
- package/dist/components/store/themePresets.d.ts +81 -0
- package/dist/components/store/themeSerialization.d.ts +2 -1
- package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
- package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
- package/dist/components/stream/GeoTileRenderer.d.ts +3 -0
- package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
- package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
- package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
- package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
- package/dist/components/stream/SVGChartTitle.d.ts +9 -0
- package/dist/components/stream/SVGOverlay.d.ts +1 -21
- package/dist/components/stream/SVGUnderlay.d.ts +24 -0
- package/dist/components/stream/SceneToSVG.d.ts +1 -1
- package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
- package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
- package/dist/components/stream/StreamXYFrame.d.ts +1 -1
- package/dist/components/stream/accessibleDataRows.d.ts +11 -0
- package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
- package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
- package/dist/components/stream/axisTickUtils.d.ts +19 -0
- package/dist/components/stream/canvasBackground.d.ts +10 -0
- package/dist/components/stream/canvasSetup.d.ts +24 -4
- package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
- package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
- package/dist/components/stream/frameGraphics.d.ts +18 -0
- package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
- package/dist/components/stream/frameLegendOptions.d.ts +18 -0
- package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
- package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
- package/dist/components/stream/geoTypes.d.ts +12 -11
- package/dist/components/stream/hitTarget.d.ts +61 -2
- package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
- package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
- package/dist/components/stream/networkCustomLayout.d.ts +2 -2
- package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
- package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
- package/dist/components/stream/networkFramePaint.d.ts +15 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
- package/dist/components/stream/networkTypes.d.ts +32 -32
- package/dist/components/stream/normalizeXYData.d.ts +7 -0
- package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
- package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
- package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
- package/dist/components/stream/ordinalTypes.d.ts +12 -4
- package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
- package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
- package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
- package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
- package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
- package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
- package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
- package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
- package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
- package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +25 -4
- package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
- package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
- package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
- package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
- package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
- package/dist/components/stream/pipelineConfig.d.ts +8 -17
- package/dist/components/stream/pipelineDomainResolution.d.ts +2 -2
- package/dist/components/stream/renderBackend.d.ts +2 -0
- package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
- package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
- package/dist/components/stream/responsiveSize.d.ts +17 -0
- package/dist/components/stream/sceneCursor.d.ts +41 -0
- package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
- package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
- package/dist/components/stream/types.d.ts +33 -13
- package/dist/components/stream/useCanvasFrameHost.d.ts +12 -1
- package/dist/components/stream/useFrame.d.ts +24 -1
- package/dist/components/stream/useResponsiveSize.d.ts +6 -1
- package/dist/components/stream/useStalenessCheck.d.ts +1 -1
- package/dist/components/stream/xyFrameAxisTypes.d.ts +20 -4
- package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
- package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
- package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
- package/dist/components/types/legendTypes.d.ts +6 -0
- package/dist/components/types/marginType.d.ts +7 -8
- package/dist/controls.min.js +1 -1
- package/dist/controls.module.min.js +1 -1
- package/dist/forceLayoutWorker.js +1 -1
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics-matter.module.min.js +1 -1
- package/dist/physics-rapier.module.min.js +1 -1
- package/dist/physics.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/physicsWorker.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -1
- package/dist/realtime.min.js +1 -1
- package/dist/realtime.module.min.js +1 -1
- package/dist/rough.min.js +1 -1
- package/dist/rough.module.min.js +1 -1
- package/dist/semiotic-ai-core.d.ts +13 -4
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai.d.ts +16 -9
- package/dist/semiotic-ai.min.js +1 -1
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-client-cjs-shared.min.js +1 -0
- package/dist/semiotic-client-glyph.module.min.js +2 -0
- package/dist/semiotic-client-responsive.module.min.js +2 -0
- package/dist/semiotic-client-shared.module.min.js +2 -0
- package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
- package/dist/semiotic-experimental-node.module.min.js +2 -0
- package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
- package/dist/semiotic-experimental-vacp.min.js +1 -1
- package/dist/semiotic-experimental-vacp.module.min.js +1 -1
- package/dist/semiotic-experimental.d.ts +1 -1
- package/dist/semiotic-experimental.min.js +1 -1
- package/dist/semiotic-experimental.module.min.js +1 -1
- package/dist/semiotic-geo.d.ts +4 -1
- package/dist/semiotic-network.d.ts +7 -4
- package/dist/semiotic-ordinal.d.ts +4 -1
- package/dist/semiotic-physics.d.ts +11 -4
- package/dist/semiotic-realtime-core.d.ts +11 -4
- package/dist/semiotic-realtime-core.min.js +2 -1
- package/dist/semiotic-realtime-core.module.min.js +2 -1
- package/dist/semiotic-realtime-react.d.ts +4 -3
- package/dist/semiotic-realtime-react.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-realtime.d.ts +3 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
- package/dist/semiotic-recipes-core.d.ts +7 -5
- package/dist/semiotic-recipes-core.min.js +9 -1
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
- package/dist/semiotic-recipes-react.min.js +1 -1
- package/dist/semiotic-recipes-react.module.min.js +1 -1
- package/dist/semiotic-recipes.min.js +7 -1
- package/dist/semiotic-recipes.module.min.js +2 -1
- package/dist/semiotic-server-edge-node.module.min.js +1 -0
- package/dist/semiotic-server-edge.d.ts +3 -2
- package/dist/semiotic-server-edge.min.js +1 -1
- package/dist/semiotic-server-edge.module.min.js +1 -1
- package/dist/semiotic-server-node.min.js +1 -1
- package/dist/semiotic-server-node.module.min.js +1 -1
- package/dist/semiotic-server.d.ts +3 -2
- package/dist/semiotic-themes-core.d.ts +5 -48
- package/dist/semiotic-themes-core.min.js +1 -1
- package/dist/semiotic-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes-react.min.js +1 -1
- package/dist/semiotic-themes-react.module.min.js +1 -1
- package/dist/semiotic-themes.min.js +1 -1
- package/dist/semiotic-themes.module.min.js +1 -1
- package/dist/semiotic-utils-core.d.ts +11 -5
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-utils-react.d.ts +2 -0
- package/dist/semiotic-utils-react.min.js +1 -1
- package/dist/semiotic-utils-react.module.min.js +1 -1
- package/dist/semiotic-utils.min.js +2 -1
- package/dist/semiotic-utils.module.min.js +2 -1
- package/dist/semiotic-value.min.js +1 -1
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic-xy.d.ts +4 -1
- package/dist/semiotic.d.ts +68 -25
- package/dist/semiotic.min.js +1 -1
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +1 -1
- package/dist/server.module.min.js +1 -1
- package/dist/xy.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +53 -19
- package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
- package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
- package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
- package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
- package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
- package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
- package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
- package/dist/chunk-chunk-3GCILWPB.module.min.js +0 -2
- package/dist/chunk-chunk-46KRGJQP.module.min.js +0 -1
- package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
- package/dist/chunk-chunk-4MLLQUGW.module.min.js +0 -2
- package/dist/chunk-chunk-57RBPDBQ.module.min.js +0 -2
- package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
- package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
- package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
- package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
- package/dist/chunk-chunk-7LE56WAE.module.min.js +0 -2
- package/dist/chunk-chunk-7T25U75Z.module.min.js +0 -2
- package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
- package/dist/chunk-chunk-AF53TBSN.module.min.js +0 -2
- package/dist/chunk-chunk-BTZYH2IE.module.min.js +0 -1
- package/dist/chunk-chunk-BWV55BZK.module.min.js +0 -2
- package/dist/chunk-chunk-BZNOAHJV.module.min.js +0 -2
- package/dist/chunk-chunk-CD6PVVS3.module.min.js +0 -2
- package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
- package/dist/chunk-chunk-FC3NZWYR.module.min.js +0 -2
- package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
- package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
- package/dist/chunk-chunk-FRGBMTZR.module.min.js +0 -1
- package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
- package/dist/chunk-chunk-H5IFO6CU.module.min.js +0 -2
- package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
- package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
- package/dist/chunk-chunk-HCNDE26Q.module.min.js +0 -2
- package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
- package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
- package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
- package/dist/chunk-chunk-JJ4BSUYL.module.min.js +0 -2
- package/dist/chunk-chunk-JRHXQGEV.module.min.js +0 -2
- package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
- package/dist/chunk-chunk-L6FFYGYS.module.min.js +0 -1
- package/dist/chunk-chunk-LJDH3WV3.module.min.js +0 -2
- package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
- package/dist/chunk-chunk-N3Q33XCB.module.min.js +0 -2
- package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
- package/dist/chunk-chunk-OG3TTJGJ.module.min.js +0 -2
- package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
- package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
- package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
- package/dist/chunk-chunk-QQJNG23C.module.min.js +0 -2
- package/dist/chunk-chunk-RGJ6TKAH.module.min.js +0 -2
- package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
- package/dist/chunk-chunk-SFLUSZ73.module.min.js +0 -2
- package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
- package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
- package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
- package/dist/chunk-chunk-UEZ6SHW5.module.min.js +0 -2
- package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
- package/dist/chunk-chunk-VUWYT7DY.module.min.js +0 -2
- package/dist/chunk-chunk-W5HWGQMD.module.min.js +0 -2
- package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
- package/dist/chunk-chunk-WGROBM3I.module.min.js +0 -2
- package/dist/chunk-chunk-WSDJFBKX.module.min.js +0 -2
- package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
- package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
- package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
- package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
- package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
- package/dist/test-utils/canvasMock.d.ts +0 -86
- package/dist/test-utils/capturedFrameProps.d.ts +0 -67
- package/dist/test-utils/frameMock.d.ts +0 -81
- package/dist/test-utils/ordinalFixtures.d.ts +0 -48
- /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
- /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
- /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
- /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
package/README.md
CHANGED
|
@@ -17,28 +17,40 @@ AI coding assistants generate correct chart code on the first try.
|
|
|
17
17
|
<img src="./docs/public/assets/img/semiotic-release-dashboard.svg" alt="Semiotic release dashboard showing chart count, bundle sizes, capability coverage, chart families, and documentation growth" width="100%">
|
|
18
18
|
<!-- semiotic-readme-dashboard:end -->
|
|
19
19
|
|
|
20
|
-
## What's New in 3.
|
|
21
|
-
|
|
22
|
-
3.
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
20
|
+
## What's New in 3.9.0
|
|
21
|
+
|
|
22
|
+
3.9.0 closes renderer and API gaps while making chart interaction easier to express:
|
|
23
|
+
|
|
24
|
+
- Retained mark styles accept datum-specific CSS cursors across canvas, SVG, and static rendering;
|
|
25
|
+
realtime chart HOCs also accept a top-level cursor default, including `TemporalHistogram`.
|
|
26
|
+
Cursor presentation stays separate from click and keyboard behavior so applications keep control
|
|
27
|
+
of interaction semantics.
|
|
28
|
+
- Realtime charts now share the generic typing, accessibility metadata, loading/empty states,
|
|
29
|
+
legends, selection, linked-hover, and observation contracts of the high-level chart families;
|
|
30
|
+
RealtimeLineChart also supports bounded event-time reordering, window aggregation, and explicit
|
|
31
|
+
end-of-stream flushing.
|
|
32
|
+
- Static rendering gains OrbitDiagram plus broad client-parity fixes for grouped XY data, custom
|
|
33
|
+
layouts, geo flows, gradients, background layers, empty scenes, and zero-valued network edges.
|
|
34
|
+
- New observation, tooltip, snapshot-flow, network hit-target, responsive, and theme-CSS helpers
|
|
35
|
+
are public, while stricter package, API, performance, docs, npm, Cloud Run, and MCP Registry
|
|
36
|
+
gates protect the release artifact end to end.
|
|
37
|
+
- `evaluateChart` now combines data-contract, representation, accessibility, and optional
|
|
38
|
+
render-evidence findings for the AI API, CLI, and MCP server. AI descriptions also distinguish
|
|
39
|
+
value components such as `BigNumber` from chart HOCs, and CommonJS recipe imports keep their
|
|
40
|
+
geographic dependencies lazy.
|
|
41
|
+
- Side legends reserve their focus-ring clearance consistently in browser and static output; use
|
|
42
|
+
the typed `frameProps.legendLayout.edgeGutter` to tune that clearance when necessary.
|
|
31
43
|
|
|
32
44
|
```jsx
|
|
33
|
-
import {
|
|
45
|
+
import { ForceDirectedGraph } from "semiotic/network"
|
|
34
46
|
|
|
35
|
-
<
|
|
47
|
+
<ForceDirectedGraph
|
|
36
48
|
nodes={nodes}
|
|
37
|
-
edges={
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
49
|
+
edges={edges}
|
|
50
|
+
styleRules={[
|
|
51
|
+
{ when: node => Boolean(node.url), style: { cursor: "pointer" } }
|
|
52
|
+
]}
|
|
53
|
+
onClick={node => node?.url && openNode(node.url)}
|
|
42
54
|
/>
|
|
43
55
|
```
|
|
44
56
|
|
|
@@ -73,7 +85,10 @@ correct visualizations without trial and error:
|
|
|
73
85
|
- **`npx semiotic-ai --doctor`** — validate component + props JSON from the command line with typo suggestions and anti-pattern detection
|
|
74
86
|
- **`diagnoseConfig(component, props)`** — programmatic anti-pattern detector with actionable fixes, spanning validation, encoding, accessibility, and misleading-design (deception) checks
|
|
75
87
|
- **`auditData(component, props, data?)`** — chart-aware numeric preflight for inputs that pass schema validation but break the math: non-finite values, zero-span domains, invalid log inputs, negative size geometry, unsafe normalized totals, and scale-dominating outliers. Returns bounded row evidence and flows into `diagnoseConfig`, Chart Clinic, CLI doctor, and opt-in `ChartContainer` notifications
|
|
76
|
-
- **`
|
|
88
|
+
- **`AGENTS.md`** — concise repository workflow shared by modern coding agents;
|
|
89
|
+
`CLAUDE.md` imports it and Copilot receives a short compatibility bridge
|
|
90
|
+
- **`ai/reference.md`** — complete on-demand product reference, kept out of
|
|
91
|
+
always-loaded coding-agent context
|
|
77
92
|
- **`llms.txt`** — machine-readable documentation following the emerging standard
|
|
78
93
|
|
|
79
94
|
Every chart includes a built-in error boundary, dev-mode validation
|
|
@@ -404,35 +419,35 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
404
419
|
|
|
405
420
|
| Entry Point | gzip | What's inside |
|
|
406
421
|
|---|---|---|
|
|
407
|
-
| `semiotic/xy` | **
|
|
408
|
-
| `semiotic/ordinal` | **
|
|
409
|
-
| `semiotic/network` | **
|
|
410
|
-
| `semiotic/geo` | **
|
|
411
|
-
| `semiotic/realtime` | **
|
|
412
|
-
| `semiotic/realtime/core` | **
|
|
422
|
+
| `semiotic/xy` | **152 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
|
|
423
|
+
| `semiotic/ordinal` | **128 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
|
|
424
|
+
| `semiotic/network` | **149 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
|
|
425
|
+
| `semiotic/geo` | **109 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
|
|
426
|
+
| `semiotic/realtime` | **163 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
|
|
427
|
+
| `semiotic/realtime/core` | **162 KB** | Streaming chart types, HOCs, and buffer helpers |
|
|
413
428
|
| `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
|
|
414
|
-
| `semiotic/server` | **
|
|
415
|
-
| `semiotic/server/node` | **
|
|
416
|
-
| `semiotic/server/edge` | **
|
|
417
|
-
| `semiotic/utils` | **
|
|
418
|
-
| `semiotic/utils/core` | **
|
|
419
|
-
| `semiotic/utils/react` | **
|
|
420
|
-
| `semiotic/recipes` | **
|
|
421
|
-
| `semiotic/recipes/core` | **
|
|
422
|
-
| `semiotic/recipes/react` | **
|
|
423
|
-
| `semiotic/themes` | **
|
|
424
|
-
| `semiotic/themes/core` | **
|
|
429
|
+
| `semiotic/server` | **195 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
430
|
+
| `semiotic/server/node` | **195 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
431
|
+
| `semiotic/server/edge` | **200 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
|
|
432
|
+
| `semiotic/utils` | **93 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
|
|
433
|
+
| `semiotic/utils/core` | **86 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
|
|
434
|
+
| `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
|
|
435
|
+
| `semiotic/recipes` | **94 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
436
|
+
| `semiotic/recipes/core` | **86 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
437
|
+
| `semiotic/recipes/react` | **7 KB** | Glyph and React layout-selection helpers |
|
|
438
|
+
| `semiotic/themes` | **6 KB** | Theme presets only (tufte, carbon, etc.) |
|
|
439
|
+
| `semiotic/themes/core` | **6 KB** | Theme presets and token helpers |
|
|
425
440
|
| `semiotic/themes/react` | **6 KB** | ThemeProvider/useTheme and hooks |
|
|
426
441
|
| `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
|
|
427
|
-
| `semiotic/value` | **
|
|
428
|
-
| `semiotic/physics` | **
|
|
442
|
+
| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
|
|
443
|
+
| `semiotic/physics` | **164 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
|
|
429
444
|
| `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
|
|
430
445
|
| `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
|
|
431
|
-
| `semiotic/ai` | **
|
|
432
|
-
| `semiotic/ai/core` | **
|
|
433
|
-
| `semiotic/controls` | **
|
|
434
|
-
| `semiotic/rough` | **
|
|
435
|
-
| `semiotic` | **
|
|
446
|
+
| `semiotic/ai` | **520 KB** | All schema-backed charts + validation — optimized for LLM code generation |
|
|
447
|
+
| `semiotic/ai/core` | **87 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
|
|
448
|
+
| `semiotic/controls` | **11 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
|
|
449
|
+
| `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
|
|
450
|
+
| `semiotic` | **334 KB** | Everything below (full bundle) |
|
|
436
451
|
|
|
437
452
|
<!-- semiotic-bundle-sizes:end -->
|
|
438
453
|
|
|
@@ -453,32 +468,32 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
453
468
|
|
|
454
469
|
| Public named import | Runtime | gzip cold-consumer bundle |
|
|
455
470
|
|---|---:|---:|
|
|
456
|
-
| `import { LineChart } from "semiotic"` | browser | **
|
|
457
|
-
| `import { LineChart } from "semiotic/xy"` | browser | **
|
|
458
|
-
| `import { BarChart } from "semiotic/ordinal"` | browser | **
|
|
459
|
-
| `import { SankeyDiagram } from "semiotic/network"` | browser | **
|
|
460
|
-
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **
|
|
461
|
-
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **
|
|
471
|
+
| `import { LineChart } from "semiotic"` | browser | **162.5 KiB** |
|
|
472
|
+
| `import { LineChart } from "semiotic/xy"` | browser | **162.2 KiB** |
|
|
473
|
+
| `import { BarChart } from "semiotic/ordinal"` | browser | **130.5 KiB** |
|
|
474
|
+
| `import { SankeyDiagram } from "semiotic/network"` | browser | **152.7 KiB** |
|
|
475
|
+
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **135.4 KiB** |
|
|
476
|
+
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
|
|
462
477
|
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
|
|
463
|
-
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **
|
|
478
|
+
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.2 KiB** |
|
|
464
479
|
| `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
|
|
465
480
|
| `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
|
|
466
|
-
| `import { renderChart } from "semiotic/server"` | node | **
|
|
467
|
-
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **
|
|
468
|
-
| `import { renderToImage } from "semiotic/server/node"` | node | **
|
|
469
|
-
| `import { suggestCharts } from "semiotic/ai"` | browser | **
|
|
470
|
-
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **
|
|
481
|
+
| `import { renderChart } from "semiotic/server"` | node | **243.2 KiB** |
|
|
482
|
+
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **86.5 KiB** |
|
|
483
|
+
| `import { renderToImage } from "semiotic/server/node"` | node | **243.6 KiB** |
|
|
484
|
+
| `import { suggestCharts } from "semiotic/ai"` | browser | **239.2 KiB** |
|
|
485
|
+
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **38.1 KiB** |
|
|
471
486
|
| `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
|
|
472
|
-
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **
|
|
473
|
-
| `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.
|
|
474
|
-
| `import { resolveThemePreset } from "semiotic/themes"` | browser | **
|
|
475
|
-
| `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **
|
|
476
|
-
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **
|
|
477
|
-
| `import { validateProps } from "semiotic/utils"` | browser | **
|
|
478
|
-
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **
|
|
479
|
-
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **
|
|
480
|
-
| `import { waffleLayout } from "semiotic/recipes"` | browser | **2.
|
|
481
|
-
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **2.
|
|
487
|
+
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **114.6 KiB** |
|
|
488
|
+
| `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.1 KiB** |
|
|
489
|
+
| `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
|
|
490
|
+
| `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
|
|
491
|
+
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.1 KiB** |
|
|
492
|
+
| `import { validateProps } from "semiotic/utils"` | browser | **9.1 KiB** |
|
|
493
|
+
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **6.8 KiB** |
|
|
494
|
+
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.3 KiB** |
|
|
495
|
+
| `import { waffleLayout } from "semiotic/recipes"` | browser | **2.9 KiB** |
|
|
496
|
+
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **2.9 KiB** |
|
|
482
497
|
| `import { Glyph } from "semiotic/recipes/react"` | browser | **0.8 KiB** |
|
|
483
498
|
| `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
|
|
484
499
|
| `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
|
|
@@ -734,7 +749,8 @@ Secondary-directory freshness and release ownership are tracked in
|
|
|
734
749
|
|
|
735
750
|
Agent-facing API surface:
|
|
736
751
|
|
|
737
|
-
- **`
|
|
752
|
+
- **`AGENTS.md`** is the concise repository development contract and **`CLAUDE.md`** imports it for Claude Code. These stay repository-local rather than shipping irrelevant contributor instructions to package consumers.
|
|
753
|
+
- **`ai/reference.md`**, **`ai/schema.json`**, **`ai/surface-manifest.json`**, **`ai/behaviorContracts.cjs`**, and **`agent-skill/semiotic-charts/SKILL.md`** are bundled in the npm tarball (see `package.json#files`). The reference is the on-demand product guide printed by `npx semiotic-ai`; the schema, manifest, contracts, and portable skill provide structured generation and validation guidance.
|
|
738
754
|
- [**`semiotic.nteract.io/llms.txt`**](https://semiotic.nteract.io/llms.txt) + [**`/llms-full.txt`**](https://semiotic.nteract.io/llms-full.txt) — deployed at the docs site per the [llms.txt standard](https://llmstxt.org). Agents fetch the navigation map (`llms.txt`) or the full inlined docs (`llms-full.txt`) over HTTP; they're not part of the npm package itself.
|
|
739
755
|
|
|
740
756
|
## Documentation
|
|
@@ -14,6 +14,14 @@ The cardinal rule: **do not hand-write chart JSX and hope it paints.** Emit a
|
|
|
14
14
|
`{ component, props }` proposal and run it through the trust loop, which is
|
|
15
15
|
validated and diagnosed; when a renderer is available, proven to paint. Otherwise it returns reasons and ranked alternatives to retry with.
|
|
16
16
|
|
|
17
|
+
## Context discipline
|
|
18
|
+
|
|
19
|
+
Start with the task and the exact component schema. Use the MCP `getSchema` tool
|
|
20
|
+
or `npx semiotic-ai --schema <Component>`, then read one nearby example if
|
|
21
|
+
needed. Do not load the full reference, schema, or example catalog by default;
|
|
22
|
+
retrieve broader context only when validation or diagnosis shows that it is
|
|
23
|
+
necessary.
|
|
24
|
+
|
|
17
25
|
## The trust loop — generate → validate → diagnose → repair → prove
|
|
18
26
|
|
|
19
27
|
`prepareChart` (from `semiotic/ai`) composes the whole loop. Call it on every
|
|
@@ -120,14 +128,15 @@ const note = withProvenance(
|
|
|
120
128
|
## Tooling
|
|
121
129
|
|
|
122
130
|
- **MCP server:** `npx semiotic-mcp` — tools for `renderChart` (SVG + render
|
|
123
|
-
evidence), `suggestCharts`, `groundChart`, `diagnoseConfig`, `repairChartConfig`,
|
|
131
|
+
evidence), `suggestCharts`, `groundChart`, `diagnoseConfig`, `evaluateChart`, `repairChartConfig`,
|
|
124
132
|
`proposeChartVariants`, and more. Prefer these over guessing.
|
|
125
133
|
- **Public app profile:** `npx semiotic-mcp --profile public` exposes the five
|
|
126
134
|
task-oriented tools `createChart`, `improveChart`, `explainChart`,
|
|
127
135
|
`auditChart`, and `getChartSchema`; use it when tool discovery matters more
|
|
128
136
|
than expert-level control.
|
|
129
137
|
- **CLI gate:** `npx semiotic-ai --doctor` validates a `{ component, props }` JSON
|
|
130
|
-
(`--audit-a11y` for an accessibility audit
|
|
138
|
+
(`--audit-a11y` for an accessibility audit, `--evaluate` for the unified
|
|
139
|
+
data/deception/accessibility pass). Run it before shipping generated code.
|
|
131
140
|
- **Machine-readable docs:** the published `llms.txt` is the chart catalog with
|
|
132
141
|
per-chart communicative-act labels; read it for the full surface rather than
|
|
133
142
|
guessing component names.
|
package/ai/behaviorContracts.cjs
CHANGED
|
@@ -163,7 +163,19 @@ const BEHAVIOR_CONTRACTS = [
|
|
|
163
163
|
severity: "warning",
|
|
164
164
|
appliesTo: {},
|
|
165
165
|
summary: "High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.",
|
|
166
|
-
agentAction:
|
|
166
|
+
agentAction: 'Put title, description, summary, and accessibleTable directly on the chart component when they appear in its schema. If a consumer-owned role=img wraps the chart, use accessibleTable: { portalTarget: "element-id" } and render that target outside the image. For generated L1–L3 description or a navigable chart tree, use ChartContainer with chartConfig plus describe and/or navigable; do not invent frameProps fields.',
|
|
167
|
+
},
|
|
168
|
+
{
|
|
169
|
+
id: "interaction.cursor-is-presentation-only",
|
|
170
|
+
category: "interaction",
|
|
171
|
+
title: "Cursor styling does not create behavior",
|
|
172
|
+
severity: "warning",
|
|
173
|
+
appliesTo: {
|
|
174
|
+
propsAny: ["cursor"],
|
|
175
|
+
propPathsAny: [["styleRules", "*", "style", "cursor"]],
|
|
176
|
+
},
|
|
177
|
+
summary: "Cursor values in realtime props, retained mark styles, styleRules, and custom hit targets change pointer presentation only. They do not install click handlers, keyboard activation, observations, or accessibility semantics.",
|
|
178
|
+
agentAction: "Use an actionable cursor only when the application separately supplies documented click or observation behavior and an accessible activation path. Treat cursor in serialized/static output as visual metadata, never as proof that a mark is interactive.",
|
|
167
179
|
},
|
|
168
180
|
{
|
|
169
181
|
id: "props.data-required-by-usage-mode",
|
|
@@ -320,8 +332,26 @@ function appliesToComponent(contract, component) {
|
|
|
320
332
|
|
|
321
333
|
function appliesToProps(contract, props) {
|
|
322
334
|
const propsAny = contract.appliesTo?.propsAny
|
|
323
|
-
|
|
324
|
-
|
|
335
|
+
const propPathsAny = contract.appliesTo?.propPathsAny
|
|
336
|
+
if (
|
|
337
|
+
(!propsAny || propsAny.length === 0) &&
|
|
338
|
+
(!propPathsAny || propPathsAny.length === 0)
|
|
339
|
+
)
|
|
340
|
+
return true
|
|
341
|
+
|
|
342
|
+
if (propsAny?.some((prop) => hasOwn(props, prop) && props[prop] !== undefined)) return true
|
|
343
|
+
return propPathsAny?.some((path) => hasDefinedPath(props, path)) ?? false
|
|
344
|
+
}
|
|
345
|
+
|
|
346
|
+
function hasDefinedPath(value, path) {
|
|
347
|
+
if (path.length === 0) return value !== undefined
|
|
348
|
+
if (value === null || typeof value !== "object") return false
|
|
349
|
+
|
|
350
|
+
const [segment, ...rest] = path
|
|
351
|
+
if (segment === "*") {
|
|
352
|
+
return Array.isArray(value) && value.some((item) => hasDefinedPath(item, rest))
|
|
353
|
+
}
|
|
354
|
+
return hasOwn(value, segment) && hasDefinedPath(value[segment], rest)
|
|
325
355
|
}
|
|
326
356
|
|
|
327
357
|
function behaviorContractsFor({ component, props } = {}) {
|
package/ai/cli.js
CHANGED
|
@@ -24,7 +24,7 @@ const {
|
|
|
24
24
|
} = require("./behaviorContracts.cjs")
|
|
25
25
|
|
|
26
26
|
const FILES = {
|
|
27
|
-
default: path.join(pkgRoot, "
|
|
27
|
+
default: path.join(pkgRoot, "ai", "reference.md"),
|
|
28
28
|
"--schema": path.join(__dirname, "schema.json"),
|
|
29
29
|
"--compact": path.join(__dirname, "system-prompt.md"),
|
|
30
30
|
"--examples": path.join(__dirname, "examples.md"),
|
|
@@ -39,7 +39,7 @@ const HELP = `
|
|
|
39
39
|
semiotic-ai — Dump Semiotic AI context to stdout
|
|
40
40
|
|
|
41
41
|
Usage:
|
|
42
|
-
npx semiotic-ai Print
|
|
42
|
+
npx semiotic-ai Print ai/reference.md (full reference)
|
|
43
43
|
npx semiotic-ai --list List components, categories, imports, and renderability
|
|
44
44
|
npx semiotic-ai --list --json Print component index as JSON
|
|
45
45
|
npx semiotic-ai --schema Print ai/schema.json (all tool definitions)
|
|
@@ -54,6 +54,8 @@ Usage:
|
|
|
54
54
|
npx semiotic-ai --audit-a11y Audit { component, props, inChartContainer?, describe?, navigable? }
|
|
55
55
|
npx semiotic-ai --audit-mobile Audit { component, props, viewportWidth?, targetSize?, inChartContainer? }
|
|
56
56
|
JSON against Chartability (POUR-CAF) accessibility heuristics
|
|
57
|
+
npx semiotic-ai --evaluate Evaluate { component, props, data?, inChartContainer?, describe?, navigable? }
|
|
58
|
+
with data, deception, and accessibility checks (add --json for a machine-readable report)
|
|
57
59
|
npx semiotic-ai --help Show this help message
|
|
58
60
|
`.trim()
|
|
59
61
|
|
|
@@ -485,6 +487,55 @@ if (flag === "--audit-mobile") {
|
|
|
485
487
|
}
|
|
486
488
|
}
|
|
487
489
|
|
|
490
|
+
// --evaluate: run the unified data/deception/accessibility evaluator
|
|
491
|
+
if (flag === "--evaluate") {
|
|
492
|
+
const input = readJSONInput("Usage: npx semiotic-ai --evaluate '{\"component\":\"LineChart\",\"props\":{\"xAccessor\":\"x\",\"yAccessor\":\"y\"},\"data\":[...]}'")
|
|
493
|
+
const asJson = process.argv.includes("--json")
|
|
494
|
+
|
|
495
|
+
try {
|
|
496
|
+
const { component, props, data, inChartContainer, describe, navigable } = JSON.parse(input)
|
|
497
|
+
if (!component || !props) {
|
|
498
|
+
const msg = "Input must be JSON with { component, props } fields."
|
|
499
|
+
if (asJson) console.log(JSON.stringify({ ok: false, error: msg }, null, 2))
|
|
500
|
+
else console.error(msg)
|
|
501
|
+
process.exit(1)
|
|
502
|
+
}
|
|
503
|
+
|
|
504
|
+
const distPath = path.join(pkgRoot, "dist", "semiotic-ai.min.js")
|
|
505
|
+
let evaluateChart, formatEvaluateChart
|
|
506
|
+
try {
|
|
507
|
+
if (!process.env.SEMIOTIC_AI_SCHEMA_ONLY) {
|
|
508
|
+
const mod = require(distPath)
|
|
509
|
+
evaluateChart = mod.evaluateChart
|
|
510
|
+
formatEvaluateChart = mod.formatEvaluateChart
|
|
511
|
+
}
|
|
512
|
+
} catch (e) {
|
|
513
|
+
// Dist unavailable.
|
|
514
|
+
}
|
|
515
|
+
|
|
516
|
+
if (!evaluateChart || !formatEvaluateChart) {
|
|
517
|
+
const msg = "Chart evaluation requires the built library. Run `npm run dist` first, or use the MCP `evaluateChart` tool."
|
|
518
|
+
if (asJson) console.log(JSON.stringify({ ok: false, error: msg }, null, 2))
|
|
519
|
+
else console.error(msg)
|
|
520
|
+
process.exit(2)
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
const result = evaluateChart(component, props, Array.isArray(data) ? data : undefined, {
|
|
524
|
+
inChartContainer: inChartContainer === true,
|
|
525
|
+
describe: describe === true,
|
|
526
|
+
navigable: navigable === true,
|
|
527
|
+
})
|
|
528
|
+
if (asJson) console.log(JSON.stringify(result, null, 2))
|
|
529
|
+
else console.log(formatEvaluateChart(result))
|
|
530
|
+
process.exit(result.ok ? 0 : 1)
|
|
531
|
+
} catch (err) {
|
|
532
|
+
const msg = `Failed to parse input: ${errorMessage(err)}`
|
|
533
|
+
if (asJson) console.log(JSON.stringify({ ok: false, error: msg }, null, 2))
|
|
534
|
+
else console.error(msg)
|
|
535
|
+
process.exit(1)
|
|
536
|
+
}
|
|
537
|
+
}
|
|
538
|
+
|
|
488
539
|
const filePath = flag ? FILES[flag] : FILES.default
|
|
489
540
|
|
|
490
541
|
if (!filePath) {
|
package/ai/componentMetadata.cjs
CHANGED
|
@@ -41,6 +41,14 @@ for (const [category, names] of Object.entries(COMPONENTS_BY_CATEGORY)) {
|
|
|
41
41
|
}
|
|
42
42
|
}
|
|
43
43
|
|
|
44
|
+
// AI's component catalog can expose imperative/custom-layout charts that
|
|
45
|
+
// deliberately have no JSON schema. Keep that small extension separate from
|
|
46
|
+
// the schema-backed metadata above so chart-spec drift checks retain their
|
|
47
|
+
// exact one-to-one inventory contract.
|
|
48
|
+
const AI_EXPORT_ONLY_CATEGORIES = {
|
|
49
|
+
PhysicsCustomChart: "physics",
|
|
50
|
+
}
|
|
51
|
+
|
|
44
52
|
function schemaEntries(schema) {
|
|
45
53
|
return schema.tools.map((tool) => tool.function)
|
|
46
54
|
}
|
|
@@ -53,6 +61,10 @@ function categoryForComponent(name) {
|
|
|
53
61
|
return category
|
|
54
62
|
}
|
|
55
63
|
|
|
64
|
+
function categoryForAIExport(name) {
|
|
65
|
+
return COMPONENT_TO_CATEGORY.get(name) ?? AI_EXPORT_ONLY_CATEGORIES[name]
|
|
66
|
+
}
|
|
67
|
+
|
|
56
68
|
function importPathForCategory(category) {
|
|
57
69
|
if (category === "physics") return "semiotic/physics"
|
|
58
70
|
return category === "geo" ? "semiotic/geo" : `semiotic/${category}`
|
|
@@ -73,6 +85,7 @@ function metadataForComponent(entryOrName) {
|
|
|
73
85
|
category,
|
|
74
86
|
importPath: importPathForCategory(category),
|
|
75
87
|
renderable: !isPushOnly,
|
|
88
|
+
requiresLiveData: isPushOnly,
|
|
76
89
|
description: typeof entryOrName === "string" ? undefined : entryOrName.description,
|
|
77
90
|
}
|
|
78
91
|
}
|
|
@@ -106,6 +119,7 @@ function componentIndexFromSchema(schema) {
|
|
|
106
119
|
totalComponents: components.length,
|
|
107
120
|
renderableComponents: components.filter((component) => component.renderable).length,
|
|
108
121
|
browserOnlyComponents: components.filter((component) => !component.renderable).length,
|
|
122
|
+
requiresLiveDataComponents: components.filter((component) => component.requiresLiveData).length,
|
|
109
123
|
categories,
|
|
110
124
|
components,
|
|
111
125
|
}
|
|
@@ -115,6 +129,7 @@ module.exports = {
|
|
|
115
129
|
CATEGORY_ORDER,
|
|
116
130
|
COMPONENTS_BY_CATEGORY,
|
|
117
131
|
categoryForComponent,
|
|
132
|
+
categoryForAIExport,
|
|
118
133
|
componentIndexFromSchema,
|
|
119
134
|
findComponent,
|
|
120
135
|
importPathForCategory,
|