semiotic 3.8.9 → 3.9.1
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 +55 -81
- 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} +43 -22
- package/ai/schema.json +10603 -986
- 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 +30 -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 +5 -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 +25 -12
- 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 +15 -12
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +10 -7
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +35 -14
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +21 -14
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +20 -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/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 +2 -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 +18 -9
- 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 +10 -5
- package/dist/components/semiotic-utils-react.d.ts +2 -0
- package/dist/components/semiotic-utils.d.ts +1 -1
- package/dist/components/semiotic-xy.d.ts +4 -1
- package/dist/components/semiotic.d.ts +68 -26
- 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 +2 -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 +9 -0
- 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 +10 -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 +7 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
- package/dist/components/stream/networkTypes.d.ts +30 -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 +10 -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 +23 -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 +6 -17
- package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
- 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 +25 -12
- package/dist/components/stream/useCanvasFrameHost.d.ts +3 -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 +15 -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 +10 -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.d.ts +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 -26
- 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-2X3FJCME.module.min.js +0 -1
- package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
- package/dist/chunk-chunk-4ITOQRXM.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-5ZON5NMV.module.min.js +0 -2
- package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
- package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
- package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
- package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
- package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
- package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
- package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
- package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
- package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
- package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
- package/dist/chunk-chunk-DVCWU7MT.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-FSIHAW6L.module.min.js +0 -2
- package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
- package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
- package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
- package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
- package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
- package/dist/chunk-chunk-HIV7AW2V.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-JZAMMSQQ.module.min.js +0 -2
- package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
- package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
- package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
- package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
- package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
- package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
- package/dist/chunk-chunk-OHLRAEQZ.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-PRNXOCYZ.module.min.js +0 -2
- package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
- package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
- package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
- package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
- package/dist/chunk-chunk-SKLYXNYW.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-U4NZCU5T.module.min.js +0 -2
- package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
- package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
- package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
- package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
- package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
- package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
- package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
- package/dist/chunk-chunk-XYZDTYAF.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,42 +17,12 @@ 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.
|
|
20
|
+
## What's New in 3.9.1
|
|
21
21
|
|
|
22
|
-
3.
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
- XY axes now support per-axis `"nice"` / `"exact"` extent modes consistently across domain
|
|
27
|
-
padding, ticks, grids, client SVG, and static SSR — including top- and right-only axis configs.
|
|
28
|
-
- Adaptive time ticks accept IANA time zones, and multi-series tooltips have a first-class
|
|
29
|
-
configuration object with optional custom content.
|
|
30
|
-
|
|
31
|
-
```jsx
|
|
32
|
-
import { LineChart } from "semiotic/xy"
|
|
33
|
-
|
|
34
|
-
<LineChart
|
|
35
|
-
data={salesData}
|
|
36
|
-
xAccessor="month"
|
|
37
|
-
yAccessor="revenue"
|
|
38
|
-
axisExtent="exact"
|
|
39
|
-
frameProps={{
|
|
40
|
-
axes: [{ orient: "left", extent: "nice" }]
|
|
41
|
-
}}
|
|
42
|
-
/>
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
Simple charts stay five lines:
|
|
46
|
-
|
|
47
|
-
```jsx
|
|
48
|
-
import { LineChart } from "semiotic/xy"
|
|
49
|
-
|
|
50
|
-
<LineChart
|
|
51
|
-
data={salesData}
|
|
52
|
-
xAccessor="month"
|
|
53
|
-
yAccessor="revenue"
|
|
54
|
-
/>
|
|
55
|
-
```
|
|
22
|
+
3.9.1 is a focused patch release. It removes the webpack “conflicting star
|
|
23
|
+
exports” warning emitted by `semiotic/utils`, while keeping every existing
|
|
24
|
+
utility—including `resolveResponsiveDimension` and `useResponsiveSize`—available
|
|
25
|
+
from the same public entry point.
|
|
56
26
|
|
|
57
27
|
## Why Semiotic
|
|
58
28
|
|
|
@@ -73,7 +43,10 @@ correct visualizations without trial and error:
|
|
|
73
43
|
- **`npx semiotic-ai --doctor`** — validate component + props JSON from the command line with typo suggestions and anti-pattern detection
|
|
74
44
|
- **`diagnoseConfig(component, props)`** — programmatic anti-pattern detector with actionable fixes, spanning validation, encoding, accessibility, and misleading-design (deception) checks
|
|
75
45
|
- **`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
|
-
- **`
|
|
46
|
+
- **`AGENTS.md`** — concise repository workflow shared by modern coding agents;
|
|
47
|
+
`CLAUDE.md` imports it and Copilot receives a short compatibility bridge
|
|
48
|
+
- **`ai/reference.md`** — complete on-demand product reference, kept out of
|
|
49
|
+
always-loaded coding-agent context
|
|
77
50
|
- **`llms.txt`** — machine-readable documentation following the emerging standard
|
|
78
51
|
|
|
79
52
|
Every chart includes a built-in error boundary, dev-mode validation
|
|
@@ -404,35 +377,35 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
404
377
|
|
|
405
378
|
| Entry Point | gzip | What's inside |
|
|
406
379
|
|---|---|---|
|
|
407
|
-
| `semiotic/xy` | **
|
|
408
|
-
| `semiotic/ordinal` | **
|
|
409
|
-
| `semiotic/network` | **
|
|
410
|
-
| `semiotic/geo` | **
|
|
411
|
-
| `semiotic/realtime` | **
|
|
412
|
-
| `semiotic/realtime/core` | **
|
|
380
|
+
| `semiotic/xy` | **154 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
|
|
381
|
+
| `semiotic/ordinal` | **129 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
|
|
382
|
+
| `semiotic/network` | **150 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
|
|
383
|
+
| `semiotic/geo` | **110 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
|
|
384
|
+
| `semiotic/realtime` | **165 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
|
|
385
|
+
| `semiotic/realtime/core` | **164 KB** | Streaming chart types, HOCs, and buffer helpers |
|
|
413
386
|
| `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` | **
|
|
387
|
+
| `semiotic/server` | **197 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
388
|
+
| `semiotic/server/node` | **197 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
389
|
+
| `semiotic/server/edge` | **202 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
|
|
390
|
+
| `semiotic/utils` | **93 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
|
|
391
|
+
| `semiotic/utils/core` | **86 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
|
|
392
|
+
| `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
|
|
393
|
+
| `semiotic/recipes` | **94 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
394
|
+
| `semiotic/recipes/core` | **86 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
395
|
+
| `semiotic/recipes/react` | **7 KB** | Glyph and React layout-selection helpers |
|
|
423
396
|
| `semiotic/themes` | **7 KB** | Theme presets only (tufte, carbon, etc.) |
|
|
424
397
|
| `semiotic/themes/core` | **7 KB** | Theme presets and token helpers |
|
|
425
398
|
| `semiotic/themes/react` | **6 KB** | ThemeProvider/useTheme and hooks |
|
|
426
399
|
| `semiotic/data` | **4 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
|
|
427
|
-
| `semiotic/value` | **
|
|
428
|
-
| `semiotic/physics` | **
|
|
400
|
+
| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
|
|
401
|
+
| `semiotic/physics` | **165 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
|
|
429
402
|
| `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
|
|
430
403
|
| `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` | **
|
|
404
|
+
| `semiotic/ai` | **522 KB** | All schema-backed charts + validation — optimized for LLM code generation |
|
|
405
|
+
| `semiotic/ai/core` | **88 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
|
|
406
|
+
| `semiotic/controls` | **11 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
|
|
407
|
+
| `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
|
|
408
|
+
| `semiotic` | **335 KB** | Everything below (full bundle) |
|
|
436
409
|
|
|
437
410
|
<!-- semiotic-bundle-sizes:end -->
|
|
438
411
|
|
|
@@ -453,32 +426,32 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
453
426
|
|
|
454
427
|
| Public named import | Runtime | gzip cold-consumer bundle |
|
|
455
428
|
|---|---:|---:|
|
|
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 | **
|
|
429
|
+
| `import { LineChart } from "semiotic"` | browser | **162.5 KiB** |
|
|
430
|
+
| `import { LineChart } from "semiotic/xy"` | browser | **162.2 KiB** |
|
|
431
|
+
| `import { BarChart } from "semiotic/ordinal"` | browser | **130.6 KiB** |
|
|
432
|
+
| `import { SankeyDiagram } from "semiotic/network"` | browser | **152.7 KiB** |
|
|
433
|
+
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **135.4 KiB** |
|
|
434
|
+
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
|
|
462
435
|
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
|
|
463
|
-
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **
|
|
436
|
+
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.3 KiB** |
|
|
464
437
|
| `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
|
|
465
438
|
| `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 | **
|
|
439
|
+
| `import { renderChart } from "semiotic/server"` | node | **243.4 KiB** |
|
|
440
|
+
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **86.6 KiB** |
|
|
441
|
+
| `import { renderToImage } from "semiotic/server/node"` | node | **243.9 KiB** |
|
|
442
|
+
| `import { suggestCharts } from "semiotic/ai"` | browser | **239.3 KiB** |
|
|
443
|
+
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **38.2 KiB** |
|
|
471
444
|
| `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.
|
|
445
|
+
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **114.6 KiB** |
|
|
446
|
+
| `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.1 KiB** |
|
|
447
|
+
| `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
|
|
448
|
+
| `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
|
|
449
|
+
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.1 KiB** |
|
|
450
|
+
| `import { validateProps } from "semiotic/utils"` | browser | **9.1 KiB** |
|
|
451
|
+
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **6.8 KiB** |
|
|
452
|
+
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.3 KiB** |
|
|
453
|
+
| `import { waffleLayout } from "semiotic/recipes"` | browser | **2.9 KiB** |
|
|
454
|
+
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **2.9 KiB** |
|
|
482
455
|
| `import { Glyph } from "semiotic/recipes/react"` | browser | **0.8 KiB** |
|
|
483
456
|
| `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
|
|
484
457
|
| `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
|
|
@@ -734,7 +707,8 @@ Secondary-directory freshness and release ownership are tracked in
|
|
|
734
707
|
|
|
735
708
|
Agent-facing API surface:
|
|
736
709
|
|
|
737
|
-
- **`
|
|
710
|
+
- **`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.
|
|
711
|
+
- **`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
712
|
- [**`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
713
|
|
|
740
714
|
## 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,
|