semiotic 3.9.1 → 3.10.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 +137 -58
- package/agent-skill/semiotic-charts/SKILL.md +27 -17
- package/ai/artifact-contract-reference.md +408 -0
- package/ai/artifact-surface-inventory.json +5586 -0
- package/ai/behaviorContracts.cjs +24 -2
- package/ai/cli.js +480 -56
- package/ai/componentMetadata.cjs +13 -3
- package/ai/dist/mcp-server.js +140 -36407
- package/ai/examples.md +110 -7
- package/ai/reference.md +82 -28
- package/ai/schema.json +7675 -1471
- package/ai/surface-manifest.json +60 -9
- package/ai/system-prompt.md +18 -3
- package/ai/task-packets/compare-category-totals.json +301 -0
- package/ai/task-packets/compare-category-totals.md +188 -0
- package/ai/task-packets/correct-published-chart.json +271 -0
- package/ai/task-packets/correct-published-chart.md +597 -0
- package/ai/task-packets/index.json +40 -0
- package/ai/task-packets/update-live-chart.json +289 -0
- package/ai/task-packets/update-live-chart.md +424 -0
- package/dist/c-2N7IU2NY.min.js +1 -0
- package/dist/c-2WK7YJLL.min.js +1 -0
- package/dist/c-33QOXEUG.min.js +1 -0
- package/dist/c-42PLDTX7.min.js +1 -0
- package/dist/c-447VIMRO.min.js +1 -0
- package/dist/c-4FN7Q6VQ.min.js +1 -0
- package/dist/c-553QUDKA.min.js +1 -0
- package/dist/c-55BAJ333.min.js +1 -0
- package/dist/c-7242NXSG.min.js +1 -0
- package/dist/c-7EGHJU2F.min.js +1 -0
- package/dist/c-7HP7MB2I.min.js +1 -0
- package/dist/c-7NBU5ZKS.min.js +1 -0
- package/dist/c-AFBSWT77.min.js +1 -0
- package/dist/c-AJ7EC32V.min.js +1 -0
- package/dist/c-AQADQNY7.min.js +1 -0
- package/dist/c-ATM475SA.min.js +1 -0
- package/dist/c-AVO3Q7T7.min.js +1 -0
- package/dist/c-AZKPVBOC.min.js +1 -0
- package/dist/c-BNFJMDHN.min.js +1 -0
- package/dist/c-BNG5ECK5.min.js +1 -0
- package/dist/c-BOHCQILI.min.js +1 -0
- package/dist/c-CCTGN5CK.min.js +1 -0
- package/dist/c-CPSPZH6A.min.js +1 -0
- package/dist/c-CPV4N35K.min.js +1 -0
- package/dist/c-D6HAAPTX.min.js +1 -0
- package/dist/c-DE5Q3U2X.min.js +1 -0
- package/dist/c-DK662R77.min.js +1 -0
- package/dist/c-DY2676CR.min.js +1 -0
- package/dist/c-E32M6XW5.min.js +1 -0
- package/dist/c-E4JDJH4I.min.js +1 -0
- package/dist/c-E7I2L7CU.min.js +1 -0
- package/dist/c-EBOQ7ER7.min.js +1 -0
- package/dist/c-ELDWAO2V.min.js +1 -0
- package/dist/c-EUBTECGM.min.js +1 -0
- package/dist/c-GNTXRXRN.min.js +1 -0
- package/dist/c-GSZRZRD6.min.js +1 -0
- package/dist/c-GWX7JGMF.min.js +1 -0
- package/dist/c-GXV3C3MO.min.js +1 -0
- package/dist/c-HHTK2R75.min.js +1 -0
- package/dist/c-HLLFJYTY.min.js +1 -0
- package/dist/c-HPOYKCCG.min.js +1 -0
- package/dist/c-HXDKPIKR.min.js +1 -0
- package/dist/c-I4QJ6YLM.min.js +1 -0
- package/dist/c-IDJV3CZK.min.js +1 -0
- package/dist/c-ITKX3RC5.min.js +1 -0
- package/dist/c-JG2JCQLP.min.js +1 -0
- package/dist/c-JLGRHXGZ.min.js +1 -0
- package/dist/c-JO2UGTCP.min.js +1 -0
- package/dist/c-JUKIWTBJ.min.js +1 -0
- package/dist/c-KCRJGUHP.min.js +1 -0
- package/dist/c-LMGSSD2E.min.js +1 -0
- package/dist/c-LYQMZMZQ.min.js +1 -0
- package/dist/c-LYVKDBQJ.min.js +1 -0
- package/dist/c-MVR3RWF3.min.js +1 -0
- package/dist/c-MXCP7GNZ.min.js +1 -0
- package/dist/c-NG7BLZTR.min.js +1 -0
- package/dist/c-NYZ2QNAM.min.js +1 -0
- package/dist/c-OO5QLMJC.min.js +1 -0
- package/dist/c-OOVX2JPQ.min.js +1 -0
- package/dist/c-ORLEBW72.min.js +1 -0
- package/dist/c-P65V6HLO.min.js +1 -0
- package/dist/c-PP6VY3QU.min.js +1 -0
- package/dist/c-PRIKOLTE.min.js +1 -0
- package/dist/c-PSNI6KAZ.min.js +1 -0
- package/dist/c-PYNW54D2.min.js +1 -0
- package/dist/c-QA3HMQJP.min.js +1 -0
- package/dist/c-QAVFOEUY.min.js +1 -0
- package/dist/c-ROEHCIGV.min.js +1 -0
- package/dist/c-S3AZX5PP.min.js +1 -0
- package/dist/c-T2V7O2LO.min.js +1 -0
- package/dist/c-TIXX5CAU.min.js +1 -0
- package/dist/c-TKG2NP7G.min.js +1 -0
- package/dist/c-VJTDST2R.min.js +1 -0
- package/dist/c-VXLOLYTO.min.js +1 -0
- package/dist/c-W4ZUKSEQ.min.js +1 -0
- package/dist/c-WH2O53VI.min.js +1 -0
- package/dist/c-WNGH47HF.min.js +1 -0
- package/dist/c-WUWXGQYA.min.js +1 -0
- package/dist/c-XDQKXPX4.min.js +1 -0
- package/dist/c-XSB27XPS.min.js +1 -0
- package/dist/c-YDECTEUW.min.js +1 -0
- package/dist/c-YF3YKVQI.min.js +1 -0
- package/dist/c-YLZIV3VS.min.js +1 -0
- package/dist/c-ZYPXQF7B.min.js +1 -0
- package/dist/components/Annotation.d.ts +3 -2
- package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
- package/dist/components/access/chartAccessContract.d.ts +90 -0
- package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
- package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
- package/dist/components/ai/annotationProvenance.d.ts +2 -7
- package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
- package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
- package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
- package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
- package/dist/components/ai/chartCapabilities.d.ts +3 -1
- package/dist/components/ai/chartRecipeRegistry.d.ts +7 -1
- package/dist/components/ai/chartRecipes.d.ts +10 -0
- package/dist/components/ai/colorEvidence.d.ts +12 -0
- package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
- package/dist/components/ai/describePhysicsSource.d.ts +13 -0
- package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
- package/dist/components/ai/geoNavigation.d.ts +4 -0
- package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
- package/dist/components/ai/navigationTree.d.ts +7 -1
- package/dist/components/ai/qualityFixtures.d.ts +8 -0
- package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
- package/dist/components/ai/useNavigationSync.d.ts +3 -3
- package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
- package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
- package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
- package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
- package/dist/components/artifact/artifactRevision.d.ts +54 -0
- package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
- package/dist/components/artifact/attachmentAudit.d.ts +13 -0
- package/dist/components/artifact/claimCorrections.d.ts +3 -0
- package/dist/components/artifact/claimGraph.d.ts +5 -0
- package/dist/components/artifact/claimLifecycle.d.ts +32 -0
- package/dist/components/artifact/claims.d.ts +24 -0
- package/dist/components/artifact/collection.d.ts +10 -0
- package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
- package/dist/components/artifact/collectionImpact.d.ts +11 -0
- package/dist/components/artifact/collectionLineage.d.ts +3 -0
- package/dist/components/artifact/collectionOperations.d.ts +8 -0
- package/dist/components/artifact/collectionPolicy.d.ts +22 -0
- package/dist/components/artifact/collectionTypes.d.ts +117 -0
- package/dist/components/artifact/configurationRepair.d.ts +8 -0
- package/dist/components/artifact/contract.d.ts +30 -0
- package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
- package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
- package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
- package/dist/components/artifact/evidenceSample.d.ts +8 -0
- package/dist/components/artifact/exportPaths.d.ts +8 -0
- package/dist/components/artifact/fieldPolicies.d.ts +12 -0
- package/dist/components/artifact/fingerprint.d.ts +36 -0
- package/dist/components/artifact/grounding.d.ts +51 -0
- package/dist/components/artifact/groundingBudget.d.ts +38 -0
- package/dist/components/artifact/hostTransfer.d.ts +13 -0
- package/dist/components/artifact/identity.d.ts +19 -0
- package/dist/components/artifact/inheritance.d.ts +48 -0
- package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
- package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
- package/dist/components/artifact/obligations.d.ts +3 -0
- package/dist/components/artifact/policies.d.ts +45 -0
- package/dist/components/artifact/policyRelations.d.ts +3 -0
- package/dist/components/artifact/recordProjection.d.ts +7 -0
- package/dist/components/artifact/representation.d.ts +50 -0
- package/dist/components/artifact/serialization.d.ts +40 -0
- package/dist/components/artifact/temporal.d.ts +32 -0
- package/dist/components/artifact/temporalAdapters.d.ts +75 -0
- package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
- package/dist/components/artifact/temporalPresentation.d.ts +8 -0
- package/dist/components/artifact/types.d.ts +341 -0
- package/dist/components/artifact/validation.d.ts +13 -0
- package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
- package/dist/components/artifact/validationPrimitives.d.ts +24 -0
- package/dist/components/artifact/validationSurfaces.d.ts +7 -0
- package/dist/components/artifact/validationTemporal.d.ts +3 -0
- package/dist/components/charts/geo/FlowMap.d.ts +7 -0
- package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
- package/dist/components/charts/index.d.ts +4 -0
- package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
- package/dist/components/charts/network/CirclePack.d.ts +8 -1
- package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
- package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
- package/dist/components/charts/network/Treemap.d.ts +8 -1
- package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/DonutChart.d.ts +5 -0
- package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
- package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
- package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
- package/dist/components/charts/ordinal/PieChart.d.ts +5 -0
- package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
- package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
- package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
- package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
- package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
- package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
- package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
- package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
- package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
- package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
- package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
- package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
- package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
- package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
- package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
- package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
- package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
- package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
- package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
- package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
- package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
- package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
- package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
- package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
- package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
- package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
- package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
- package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
- package/dist/components/charts/realtime/aggregate.d.ts +12 -1
- package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
- package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
- package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
- package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
- package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
- package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
- package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
- package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
- package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
- package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
- package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- package/dist/components/charts/shared/networkUtils.d.ts +14 -0
- package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
- package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
- package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
- package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
- package/dist/components/charts/shared/types.d.ts +4 -2
- package/dist/components/charts/shared/useChartLegend.d.ts +6 -1
- package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
- package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
- package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
- package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
- package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
- package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
- package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
- package/dist/components/charts/xy/Heatmap.d.ts +16 -0
- package/dist/components/charts/xy/LineChart.d.ts +9 -0
- package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
- package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
- package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
- package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
- package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
- package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
- package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
- package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
- package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
- package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
- package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
- package/dist/components/evidence/evidenceGate.d.ts +30 -0
- package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
- package/dist/components/evidence/stableJsonHash.d.ts +4 -0
- package/dist/components/export/chartConfig.d.ts +40 -5
- package/dist/components/export/chartConfigArtifact.d.ts +6 -0
- package/dist/components/legendLayout.d.ts +18 -0
- package/dist/components/legendStyles.d.ts +4 -0
- package/dist/components/realtime/BinAccumulator.d.ts +5 -1
- package/dist/components/realtime/types.d.ts +16 -7
- package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
- package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
- package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
- package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
- package/dist/components/recipes/intervals.d.ts +1 -1
- package/dist/components/recipes/lineageDag.d.ts +17 -0
- package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
- package/dist/components/recipes/transitDiagram.d.ts +75 -0
- package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
- package/dist/components/semiotic-access.d.ts +9 -0
- package/dist/components/semiotic-ai-audits.d.ts +17 -0
- package/dist/components/semiotic-ai-core.d.ts +38 -18
- package/dist/components/semiotic-ai.d.ts +20 -20
- package/dist/components/semiotic-artifact-react.d.ts +10 -0
- package/dist/components/semiotic-artifact.d.ts +23 -0
- package/dist/components/semiotic-evidence.d.ts +10 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-line.d.ts +9 -0
- package/dist/components/semiotic-network.d.ts +3 -0
- package/dist/components/semiotic-ordinal.d.ts +2 -0
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-realtime-core.d.ts +3 -2
- package/dist/components/semiotic-recipes-core.d.ts +6 -0
- package/dist/components/semiotic-text.d.ts +2 -0
- package/dist/components/semiotic-themes-core.d.ts +3 -0
- package/dist/components/semiotic-utils-core.d.ts +19 -14
- package/dist/components/semiotic-xy.d.ts +3 -0
- package/dist/components/semiotic.d.ts +11 -5
- package/dist/components/server/renderDashboard.d.ts +37 -0
- package/dist/components/server/renderEvidence.d.ts +39 -0
- package/dist/components/server/renderToStaticSVG.d.ts +5 -30
- package/dist/components/server/serverChartConfigShared.d.ts +13 -0
- package/dist/components/server/serverChartConfigs.d.ts +9 -0
- package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
- package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
- package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
- package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
- package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
- package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
- package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
- package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
- package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
- package/dist/components/server/staticSVGChrome.d.ts +1 -4
- package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
- package/dist/components/server/staticXYGrid.d.ts +1 -1
- package/dist/components/server/svgSizing.d.ts +6 -0
- package/dist/components/shared/svgRoot.d.ts +17 -0
- package/dist/components/store/selectionProvenance.d.ts +14 -0
- package/dist/components/store/themeCore.d.ts +5 -1
- package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
- package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
- package/dist/components/stream/MarginalGraphics.d.ts +3 -3
- package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
- package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
- package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
- package/dist/components/stream/PipelineStore.d.ts +1 -1
- package/dist/components/stream/SVGOverlay.d.ts +4 -0
- package/dist/components/stream/SceneToSVG.d.ts +4 -19
- package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
- package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
- package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
- package/dist/components/stream/XYGrid.d.ts +11 -0
- package/dist/components/stream/axisTickUtils.d.ts +0 -1
- package/dist/components/stream/canvasSetup.d.ts +8 -2
- package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
- package/dist/components/stream/geoTypes.d.ts +1 -1
- package/dist/components/stream/hitTestUtils.d.ts +2 -0
- package/dist/components/stream/isServerEnvironment.d.ts +6 -0
- package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
- package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
- package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
- package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
- package/dist/components/stream/layouts/index.d.ts +6 -12
- package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
- package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/layouts/registry.d.ts +12 -0
- package/dist/components/stream/marginalConfig.d.ts +3 -0
- package/dist/components/stream/networkCustomLayout.d.ts +7 -0
- package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
- package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
- package/dist/components/stream/networkTypes.d.ts +5 -1
- package/dist/components/stream/ordinalTypes.d.ts +1 -1
- package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
- package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
- package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
- package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
- package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
- package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
- package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
- package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
- package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
- package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
- package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
- package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
- package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
- package/dist/components/stream/pipelineConfig.d.ts +4 -0
- package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
- package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
- package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
- package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
- package/dist/components/stream/resolveXYAxes.d.ts +13 -0
- package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
- package/dist/components/stream/seriesGeometry.d.ts +13 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
- package/dist/components/stream/types.d.ts +12 -54
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
- package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
- package/dist/components/stream/useMarginalValues.d.ts +13 -0
- package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
- package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
- package/dist/components/stream/xyAxisTicks.d.ts +25 -0
- package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
- package/dist/components/stream/xyDateTicks.d.ts +3 -2
- package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
- package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
- package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
- package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
- package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
- package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
- package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
- package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
- package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
- package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
- package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
- package/dist/components/text/annotationTextLayout.d.ts +28 -0
- package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
- package/dist/components/text/usePretextAnnotations.d.ts +12 -0
- 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.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics-matter.min.js +1 -1
- package/dist/physics-matter.module.min.js +1 -1
- package/dist/physics-rapier.min.js +1 -1
- package/dist/physics-rapier.module.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/rough.min.js +1 -1
- package/dist/rough.module.min.js +1 -1
- package/dist/semiotic-access.d.ts +9 -0
- package/dist/semiotic-access.min.js +2 -0
- package/dist/semiotic-access.module.min.js +2 -0
- package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +38 -18
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
- package/dist/semiotic-ai.d.ts +20 -20
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-artifact-react.d.ts +10 -0
- package/dist/semiotic-artifact-react.min.js +2 -0
- package/dist/semiotic-artifact-react.module.min.js +2 -0
- package/dist/semiotic-artifact.d.ts +23 -0
- package/dist/semiotic-artifact.min.js +1 -0
- package/dist/semiotic-artifact.module.min.js +1 -0
- package/dist/semiotic-client-cjs-shared.min.js +1 -1
- package/dist/semiotic-client-glyph.module.min.js +1 -1
- package/dist/semiotic-client-responsive.module.min.js +1 -1
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-evidence.d.ts +10 -0
- package/dist/semiotic-evidence.min.js +1 -0
- package/dist/semiotic-evidence.module.min.js +1 -0
- package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
- 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-line.d.ts +9 -0
- package/dist/semiotic-line.min.js +2 -0
- package/dist/semiotic-line.module.min.js +2 -0
- package/dist/semiotic-network.d.ts +3 -0
- package/dist/semiotic-ordinal.d.ts +2 -0
- package/dist/semiotic-physics.d.ts +4 -4
- package/dist/semiotic-realtime-core.d.ts +3 -2
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
- package/dist/semiotic-recipes-core.d.ts +6 -0
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
- package/dist/semiotic-recipes-react.min.js +1 -1
- package/dist/semiotic-server-edge-node.module.min.js +1 -1
- 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-text.d.ts +2 -0
- package/dist/semiotic-text.min.js +2 -0
- package/dist/semiotic-text.module.min.js +2 -0
- package/dist/semiotic-themes-core.d.ts +3 -0
- package/dist/semiotic-themes-core.min.js +1 -1
- package/dist/semiotic-themes-core.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 +19 -14
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic-xy.d.ts +3 -0
- package/dist/semiotic.d.ts +11 -5
- 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.module.min.js +1 -1
- package/package.json +91 -71
- package/spec/README.md +8 -3
- package/spec/v0.1/artifact-contract.schema.json +2299 -0
- package/spec/v0.1/examples/artifact-contract-full.json +369 -0
- package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
- package/dist/c-3BLJEQNG.min.js +0 -1
- package/dist/c-3KZD6AXJ.min.js +0 -1
- package/dist/c-4TWEX5HG.min.js +0 -1
- package/dist/c-52TEGIUJ.min.js +0 -1
- package/dist/c-5YCIX3VZ.min.js +0 -1
- package/dist/c-6FEKTA3U.min.js +0 -1
- package/dist/c-6O5EVOPH.min.js +0 -1
- package/dist/c-74HEEZGK.min.js +0 -1
- package/dist/c-AKAF6JAD.min.js +0 -1
- package/dist/c-BBKITSXB.min.js +0 -1
- package/dist/c-BWNB6USU.min.js +0 -1
- package/dist/c-C25ENHIK.min.js +0 -1
- package/dist/c-CDR5AO3R.min.js +0 -1
- package/dist/c-COHXCW3Q.min.js +0 -1
- package/dist/c-DADXPJXV.min.js +0 -1
- package/dist/c-E3JFRRMI.min.js +0 -1
- package/dist/c-EBFPQHHO.min.js +0 -1
- package/dist/c-G36WS6LN.min.js +0 -1
- package/dist/c-GGISSW5E.min.js +0 -1
- package/dist/c-GIKRQI4X.min.js +0 -1
- package/dist/c-GPYOFETM.min.js +0 -1
- package/dist/c-IDUHYYSI.min.js +0 -1
- package/dist/c-IUHFPMHD.min.js +0 -1
- package/dist/c-J5G56TUH.min.js +0 -1
- package/dist/c-JAZ73J32.min.js +0 -1
- package/dist/c-KG3NXHAL.min.js +0 -1
- package/dist/c-KII3PLZE.min.js +0 -1
- package/dist/c-LIXGXMNS.min.js +0 -1
- package/dist/c-LVEY6D6B.min.js +0 -1
- package/dist/c-M4Y3BHFR.min.js +0 -1
- package/dist/c-MAIICR2Z.min.js +0 -1
- package/dist/c-MG5DM6VE.min.js +0 -1
- package/dist/c-MNF2S4AA.min.js +0 -1
- package/dist/c-MT3WBK7M.min.js +0 -1
- package/dist/c-NY3JWV2K.min.js +0 -1
- package/dist/c-O6U6K4CW.min.js +0 -1
- package/dist/c-OQ7M4AGV.min.js +0 -1
- package/dist/c-OXYMVK7Q.min.js +0 -1
- package/dist/c-PPWDL5ZI.min.js +0 -1
- package/dist/c-QHF5YON3.min.js +0 -1
- package/dist/c-RR3GO5SW.min.js +0 -1
- package/dist/c-RSVIHIQ4.min.js +0 -1
- package/dist/c-S2BXNNJN.min.js +0 -1
- package/dist/c-S6U5CGT5.min.js +0 -1
- package/dist/c-SLGMUBUL.min.js +0 -1
- package/dist/c-SUILCHWU.min.js +0 -1
- package/dist/c-TZW3JGJ5.min.js +0 -1
- package/dist/c-US5ZFT6E.min.js +0 -1
- package/dist/c-USFMFKIH.min.js +0 -1
- package/dist/c-UUKVD4WB.min.js +0 -1
- package/dist/c-VGW3VG3I.min.js +0 -1
- package/dist/c-W3CE4A4S.min.js +0 -1
- package/dist/c-WJCD5EUY.min.js +0 -1
- package/dist/c-X5UBGU2V.min.js +0 -1
- package/dist/c-YDAY2WFR.min.js +0 -1
- package/dist/c-ZOWWU34K.min.js +0 -1
- /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
- /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
package/README.md
CHANGED
|
@@ -9,35 +9,62 @@
|
|
|
9
9
|
|
|
10
10
|
A React data visualization library designed for AI-assisted development.
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
Start with a small chart component. Add network graphs, streaming data and
|
|
13
|
+
coordinated views when the task needs them. Structured schemas, diagnostics
|
|
14
|
+
and rendering evidence help coding assistants implement, check and repair
|
|
15
|
+
chart configurations.
|
|
16
|
+
|
|
17
|
+
Work through a complete task: [check category totals](https://semiotic.nteract.io/tasks/compare-category-totals),
|
|
18
|
+
[maintain a live chart](https://semiotic.nteract.io/tasks/update-live-chart), or
|
|
19
|
+
[correct a published chart](https://semiotic.nteract.io/tasks/correct-published-chart).
|
|
20
|
+
The [source task packets](ai/task-packets/index.json) identify their build and
|
|
21
|
+
evidence scope; source availability does not establish installed or deployed parity.
|
|
15
22
|
|
|
16
23
|
<!-- semiotic-readme-dashboard:start -->
|
|
17
24
|
<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
25
|
<!-- semiotic-readme-dashboard:end -->
|
|
19
26
|
|
|
20
|
-
## What's New in 3.
|
|
21
|
-
|
|
22
|
-
3.
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
27
|
+
## What's New in 3.10.0
|
|
28
|
+
|
|
29
|
+
3.10.0 finishes style-rule coverage on the remaining sibling charts, fixes geo
|
|
30
|
+
overlay accessible names, and lands the post-3.9.2 example, physics, and
|
|
31
|
+
renderer work:
|
|
32
|
+
|
|
33
|
+
- `styleRules` now reach `WaterfallChart`, `MultiAxisLineChart`, `FlowMap`,
|
|
34
|
+
`ProcessFlowChart`, `MinimapChart`, `CandlestickChart`, `DifferenceChart`,
|
|
35
|
+
and `ScatterplotMatrix` in both React and `renderChart`/MCP output.
|
|
36
|
+
- Geographic overlays use "Geographic chart" fallbacks and honor `description`
|
|
37
|
+
in `<desc>`, matching canvas `aria-label` and static SVG chrome across XY,
|
|
38
|
+
ordinal, network, and geo frames. Live overlay and GIF `<title>`/`<desc>`
|
|
39
|
+
ids are instance-local so two charts on one page do not collide.
|
|
40
|
+
- `BubbleChart` now exposes the same xy brush as Scatterplot; stacked and
|
|
41
|
+
grouped bars share BarChart's value-axis brush. Radar, funnel, pie, and
|
|
42
|
+
donut honor `valueFormat` in default tooltips (and radar/funnel ticks).
|
|
43
|
+
- Physics charts share source updates, replay, and fixed axes; EventDrop and
|
|
44
|
+
process-flow semantics stay aligned between live and settled output.
|
|
45
|
+
- Realtime histograms gain responsive sizing, axis control, Y inversion, and
|
|
46
|
+
linked hover/brush; threshold end caps and Gauge readouts are portable SVG.
|
|
47
|
+
- New long-form examples cover grocery receipts, the jobs report, reservoir
|
|
48
|
+
guide, plane day, and persuasion, each with pinned sources and consumer kits.
|
|
49
|
+
- Renderer hot paths (packing, LOESS, rollup, ordinal scenes, hover hit-test)
|
|
50
|
+
and evidence/artifact contracts are tighter without changing public APIs.
|
|
26
51
|
|
|
27
52
|
## Why Semiotic
|
|
28
53
|
|
|
29
54
|
Semiotic is a data visualization library for React that combines broad chart
|
|
30
|
-
coverage with
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
55
|
+
coverage with AI tooling. It supports network graphs, streaming data,
|
|
56
|
+
statistical distributions and coordinated views, with schemas, examples and
|
|
57
|
+
diagnostics for implementing and checking each task. Check the project's
|
|
58
|
+
existing dependencies first: extending its current charting library may be
|
|
59
|
+
the best fit for a small change.
|
|
34
60
|
|
|
35
61
|
### Built for AI-assisted development
|
|
36
62
|
|
|
37
|
-
Semiotic
|
|
38
|
-
|
|
63
|
+
Semiotic provides a workflow for generating, checking and repairing chart
|
|
64
|
+
configurations. The [July 27, 2026 evaluation](evals/reports/openai-gpt-5.6-2026-07-27/README.md)
|
|
65
|
+
reports model- and task-specific results; it does not guarantee first-try correctness.
|
|
39
66
|
|
|
40
|
-
- **`semiotic/ai`** — a single import with the schema-backed chart capability catalog (XY, ordinal, network, realtime, geo, value), optimized for LLM code generation. See `ai/surface-manifest.json` for the generated current inventory. Note: the published entry files are pre-bundled, so importing one chart from `semiotic/ai` still ships most of the bundle — treat it as a codegen/tooling surface and use family subpaths (`semiotic/xy`, `semiotic/geo`, `semiotic/value`, …) in production code, at roughly half the single-chart cost.
|
|
67
|
+
- **`semiotic/ai`** — a single import with the schema-backed chart capability catalog (XY, ordinal, network, realtime, geo, value, and portable recipes), optimized for LLM code generation. See `ai/surface-manifest.json` for the generated current inventory. Note: the published entry files are pre-bundled, so importing one chart from `semiotic/ai` still ships most of the bundle — treat it as a codegen/tooling surface and use family subpaths (`semiotic/xy`, `semiotic/geo`, `semiotic/value`, …) in production code, at roughly half the single-chart cost.
|
|
41
68
|
- **`ai/schema.json`** — machine-readable prop schemas for every component
|
|
42
69
|
- **`npx semiotic-mcp`** — an MCP server for tool-based chart rendering in any MCP client
|
|
43
70
|
- **`npx semiotic-ai --doctor`** — validate component + props JSON from the command line with typo suggestions and anti-pattern detection
|
|
@@ -105,6 +132,11 @@ needs to communicate more than its encoding alone.
|
|
|
105
132
|
| **Charts** | Common chart forms with chart-level props | `<LineChart data={d} xAccessor="x" yAccessor="y" />` |
|
|
106
133
|
| **Frames** | Full control over rendering, interaction, and layout | `<StreamXYFrame chartType="line" lineStyle={...} />` |
|
|
107
134
|
|
|
135
|
+
Chart HOCs register only the mark plugins they need. Direct `StreamXYFrame`
|
|
136
|
+
loads the remaining built-ins on first client paint. Call
|
|
137
|
+
`registerBuiltInXYPlugins()` from `semiotic/xy` or `semiotic/realtime/core`
|
|
138
|
+
before the first render when SSR or the first frame must include marks.
|
|
139
|
+
|
|
108
140
|
Every Chart component accepts a `frameProps` prop to access the underlying
|
|
109
141
|
Frame API without leaving the simpler interface.
|
|
110
142
|
|
|
@@ -368,7 +400,7 @@ loadConversationArc(sink.load(), { enabled: false })
|
|
|
368
400
|
|
|
369
401
|
## Bundle Sizes
|
|
370
402
|
|
|
371
|
-
Semiotic ships
|
|
403
|
+
Semiotic ships 35 stable JavaScript entry points (34 subpaths plus the root). **Don't import from `"semiotic"` unless you need everything** — use the smallest sub-path that matches your charts or tooling.
|
|
372
404
|
|
|
373
405
|
The numbers below are **first-party artifact cost**: the gzip size of Semiotic's own code for each sub-path. They exclude React and other runtime dependencies, so they are not a prediction of a cold application bundle. Do not add artifact rows to estimate an app: dependency resolution and cross-import deduplication happen in the consumer bundler and are measured separately below.
|
|
374
406
|
|
|
@@ -377,35 +409,41 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
377
409
|
|
|
378
410
|
| Entry Point | gzip | What's inside |
|
|
379
411
|
|---|---|---|
|
|
380
|
-
| `semiotic/
|
|
381
|
-
| `semiotic/
|
|
412
|
+
| `semiotic/access` | **36 KB** | Chart Access Contract factory and first-wave baseline contracts |
|
|
413
|
+
| `semiotic/evidence` | **50 KB** | Chart Evidence Envelope, deterministic hashing, and publication gate |
|
|
414
|
+
| `semiotic/artifact` | **121 KB** | Renderer-independent contracts, claims, time, policy, grounding, and transfer audits |
|
|
415
|
+
| `semiotic/artifact/react` | **4 KB** | Accessible progressive disclosure for artifact contracts and policy evaluations |
|
|
416
|
+
| `semiotic/line` | **131 KB** | LineChart only — one-chart micro boundary |
|
|
417
|
+
| `semiotic/xy` | **161 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
|
|
418
|
+
| `semiotic/ordinal` | **130 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
|
|
382
419
|
| `semiotic/network` | **150 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
|
|
383
|
-
| `semiotic/geo` | **
|
|
384
|
-
| `semiotic/realtime` | **
|
|
385
|
-
| `semiotic/realtime/core` | **
|
|
420
|
+
| `semiotic/geo` | **107 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
|
|
421
|
+
| `semiotic/realtime` | **159 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
|
|
422
|
+
| `semiotic/realtime/core` | **158 KB** | Streaming chart types, HOCs, and buffer helpers |
|
|
386
423
|
| `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
|
|
387
|
-
| `semiotic/server` | **
|
|
388
|
-
| `semiotic/server/node` | **
|
|
389
|
-
| `semiotic/server/edge` | **
|
|
390
|
-
| `semiotic/utils` | **
|
|
391
|
-
| `semiotic/utils/core` | **
|
|
424
|
+
| `semiotic/server` | **228 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
425
|
+
| `semiotic/server/node` | **228 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
426
|
+
| `semiotic/server/edge` | **230 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
|
|
427
|
+
| `semiotic/utils` | **98 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
|
|
428
|
+
| `semiotic/utils/core` | **91 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
|
|
392
429
|
| `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
|
|
393
|
-
| `semiotic/recipes` | **
|
|
394
|
-
| `semiotic/recipes/core` | **
|
|
395
|
-
| `semiotic/recipes/react` | **
|
|
396
|
-
| `semiotic/themes` | **
|
|
397
|
-
| `semiotic/themes/core` | **
|
|
398
|
-
| `semiotic/themes/react` | **
|
|
399
|
-
| `semiotic/data` | **
|
|
430
|
+
| `semiotic/recipes` | **100 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
431
|
+
| `semiotic/recipes/core` | **92 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
432
|
+
| `semiotic/recipes/react` | **8 KB** | Glyph and React layout-selection helpers |
|
|
433
|
+
| `semiotic/themes` | **12 KB** | Theme presets only (tufte, carbon, etc.) |
|
|
434
|
+
| `semiotic/themes/core` | **12 KB** | Theme presets and token helpers |
|
|
435
|
+
| `semiotic/themes/react` | **7 KB** | ThemeProvider/useTheme and hooks |
|
|
436
|
+
| `semiotic/data` | **3 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
|
|
400
437
|
| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
|
|
401
438
|
| `semiotic/physics` | **165 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
|
|
402
439
|
| `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
|
|
403
440
|
| `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
|
|
404
|
-
| `semiotic/ai` | **
|
|
405
|
-
| `semiotic/ai/core` | **
|
|
406
|
-
| `semiotic/controls` | **
|
|
441
|
+
| `semiotic/ai` | **591 KB** | All schema-backed charts + validation — optimized for LLM code generation |
|
|
442
|
+
| `semiotic/ai/core` | **138 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
|
|
443
|
+
| `semiotic/controls` | **10 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
|
|
407
444
|
| `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
|
|
408
|
-
| `semiotic` | **
|
|
445
|
+
| `semiotic/text` | **1 KB** | Optional Pretext annotation hook — peer package excluded |
|
|
446
|
+
| `semiotic` | **371 KB** | Full chart API and shared utilities |
|
|
409
447
|
|
|
410
448
|
<!-- semiotic-bundle-sizes:end -->
|
|
411
449
|
|
|
@@ -426,38 +464,60 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
426
464
|
|
|
427
465
|
| Public named import | Runtime | gzip cold-consumer bundle |
|
|
428
466
|
|---|---:|---:|
|
|
429
|
-
| `import { LineChart } from "semiotic"` | browser | **
|
|
430
|
-
| `import { LineChart } from "semiotic/xy"` | browser | **
|
|
431
|
-
| `import {
|
|
432
|
-
| `import {
|
|
433
|
-
| `import {
|
|
467
|
+
| `import { LineChart } from "semiotic"` | browser | **141.2 KiB** |
|
|
468
|
+
| `import { LineChart } from "semiotic/xy"` | browser | **141.6 KiB** |
|
|
469
|
+
| `import { LineChart } from "semiotic/line"` | browser | **141.6 KiB** |
|
|
470
|
+
| `import { BarChart } from "semiotic/ordinal"` | browser | **133.5 KiB** |
|
|
471
|
+
| `import { SankeyDiagram } from "semiotic/network"` | browser | **156.9 KiB** |
|
|
472
|
+
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **142.4 KiB** |
|
|
434
473
|
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
|
|
435
474
|
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
|
|
436
|
-
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.
|
|
475
|
+
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.8 KiB** |
|
|
437
476
|
| `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
|
|
438
477
|
| `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
|
|
439
|
-
| `import { renderChart } from "semiotic/server"` | node | **
|
|
440
|
-
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **
|
|
441
|
-
| `import { renderToImage } from "semiotic/server/node"` | node | **
|
|
442
|
-
| `import { suggestCharts } from "semiotic/ai"` | browser | **
|
|
443
|
-
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **
|
|
478
|
+
| `import { renderChart } from "semiotic/server"` | node | **268.6 KiB** |
|
|
479
|
+
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **119.7 KiB** |
|
|
480
|
+
| `import { renderToImage } from "semiotic/server/node"` | node | **269.4 KiB** |
|
|
481
|
+
| `import { suggestCharts } from "semiotic/ai"` | browser | **258.7 KiB** |
|
|
482
|
+
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **46.3 KiB** |
|
|
483
|
+
| `import { buildArtifactContract } from "semiotic/artifact"` | browser | **19.5 KiB** |
|
|
484
|
+
| `import { ArtifactInspector } from "semiotic/artifact/react"` | browser | **3.8 KiB** |
|
|
485
|
+
| `import { createChartAccessContract } from "semiotic/access"` | browser | **33.2 KiB** |
|
|
486
|
+
| `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **48.9 KiB** |
|
|
444
487
|
| `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
|
|
445
|
-
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **
|
|
446
|
-
| `import {
|
|
488
|
+
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **116.6 KiB** |
|
|
489
|
+
| `import { usePretextAnnotations } from "semiotic/text"` | browser | **1.5 KiB** |
|
|
490
|
+
| `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.2 KiB** |
|
|
447
491
|
| `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
|
|
448
492
|
| `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
|
|
449
|
-
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.
|
|
450
|
-
| `import { validateProps } from "semiotic/utils"` | browser | **
|
|
451
|
-
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **
|
|
452
|
-
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.
|
|
453
|
-
| `import { waffleLayout } from "semiotic/recipes"` | browser | **
|
|
454
|
-
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **
|
|
493
|
+
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.2 KiB** |
|
|
494
|
+
| `import { validateProps } from "semiotic/utils"` | browser | **10.2 KiB** |
|
|
495
|
+
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **7.9 KiB** |
|
|
496
|
+
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.4 KiB** |
|
|
497
|
+
| `import { waffleLayout } from "semiotic/recipes"` | browser | **1.7 KiB** |
|
|
498
|
+
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.7 KiB** |
|
|
455
499
|
| `import { Glyph } from "semiotic/recipes/react"` | browser | **0.8 KiB** |
|
|
456
500
|
| `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
|
|
457
501
|
| `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
|
|
458
502
|
|
|
503
|
+
**Line-boundary interpretation:** the retained named import from `semiotic/line` emits 421.9 KiB raw versus 421.9 KiB from `semiotic/xy`; gzip differs by 0.1 KiB (0.1%). Tree-shaking converges both paths on the same LineChart implementation graph. Treat `semiotic/line` as a narrower API/direct-ESM artifact boundary, not an application-bundle saving. Do not add another per-chart entry until its packed named import beats the family path by both 10 KiB gzip and 7%.
|
|
504
|
+
|
|
459
505
|
<!-- semiotic-cold-consumer:end -->
|
|
460
506
|
|
|
507
|
+
**d3 packaging model:** Semiotic externalizes the twelve d3 modules it imports
|
|
508
|
+
and declares them as normal runtime dependencies. Consumers do not need to
|
|
509
|
+
install d3 packages manually; their bundler resolves, deduplicates, and
|
|
510
|
+
tree-shakes that dependency graph. A packed webpack comparison favored this
|
|
511
|
+
model in three of four representative chart families, and a Next 16 webpack
|
|
512
|
+
route was 22.7 KiB gzip smaller than the fully bundled alternative. The one
|
|
513
|
+
bundled win, Sankey, was only 0.4 KiB gzip. This choice retains a 22-package,
|
|
514
|
+
1.9 MB unpacked d3 install closure in exchange for smaller common application
|
|
515
|
+
graphs and an ordinary dependency contract. The checked policy is
|
|
516
|
+
`npm run check:d3-packaging`; the reproducible evidence is in
|
|
517
|
+
`benchmarks/setup/d3-packaging.json` and can be regenerated with
|
|
518
|
+
`npm run measure:d3-packaging -- --toolchain-root <dir>` after installing
|
|
519
|
+
webpack and Next in that isolated toolchain directory.
|
|
520
|
+
|
|
461
521
|
```jsx
|
|
462
522
|
// Import from the sub-path, not from "semiotic"
|
|
463
523
|
import { LineChart } from "semiotic/xy"
|
|
@@ -470,6 +530,12 @@ import { ChoroplethMap } from "semiotic/geo"
|
|
|
470
530
|
|
|
471
531
|
**When to use `"semiotic"`**: Fine when you want one import for mixed families. Shared chunks prevent duplicated runtime code across family subpaths; the cold-consumer table above is the better guide for a single named import.
|
|
472
532
|
|
|
533
|
+
**CommonJS compatibility note:** `require("semiotic/xy")` loads the shared
|
|
534
|
+
CommonJS client bundle (about 2.1 MB before compression) so React contexts stay
|
|
535
|
+
singletons across family imports. Prefer ESM imports in browser builds when
|
|
536
|
+
bundle size matters; splitting that CJS client without a context-identity
|
|
537
|
+
contract would be unsafe.
|
|
538
|
+
|
|
473
539
|
## TypeScript
|
|
474
540
|
|
|
475
541
|
Built with `strict: true`. Full type definitions ship with the package.
|
|
@@ -573,13 +639,26 @@ host-header allowlisting. For ChatGPT Apps domain verification, set
|
|
|
573
639
|
| **`diagnoseConfig`** | Check a chart configuration for common problems — empty data, bad dimensions, missing accessors, wrong data shape, and more. Returns a human-readable diagnostic report with actionable fixes. |
|
|
574
640
|
| **`reportIssue`** | Generate a pre-filled GitHub issue URL for bug reports or feature requests. Pass `{ title: "...", body: "...", labels: ["bug"] }`. Returns a URL the user can open to submit. |
|
|
575
641
|
| **`applyTheme`** | List named theme presets or return ThemeProvider/CSS/token usage for a preset such as `{ name: "tufte" }`. |
|
|
642
|
+
| **`auditArtifact`** | Evaluate an explicit artifact contract under a named policy without inferring missing source, review, or timing facts. |
|
|
643
|
+
| **`recommendRepresentation`** | Compare chart and non-chart outcomes against supplied data, claims, evidence, time state, and policy requirements. |
|
|
644
|
+
| **`repairArtifact`** | Propose contract repairs and optionally fill missing identity fields; existing mismatches require a revision and claim reassessment. |
|
|
645
|
+
| **`explainRefusal`** | Explain which explicit policy obligations prevent publication or action and identify safe follow-up work. |
|
|
646
|
+
|
|
647
|
+
Artifact tools are opt-in diagnostics, not publication authorization. A
|
|
648
|
+
`conditional` result (including CLI exit code 0) retains open work. Ordinary
|
|
649
|
+
`renderChart` calls do not enforce artifact policy; governed hosts must enforce
|
|
650
|
+
their own release boundary. Manual-check resolution and revision-bound release
|
|
651
|
+
approval remain separate host workflow work.
|
|
576
652
|
|
|
577
653
|
### Resources
|
|
578
654
|
|
|
579
655
|
| Resource | Description |
|
|
580
656
|
|----------|-------------|
|
|
657
|
+
| **`semiotic://artifact-contract-schema`** | Standalone JSON Schema for portable purpose, claim, evidence, timing, review, and transfer metadata. |
|
|
581
658
|
| **`semiotic://schema`** | Full machine-readable component schema JSON. |
|
|
582
|
-
| **`semiotic://
|
|
659
|
+
| **`semiotic://schema-index`** | Compact discovery index with categories, renderability, import paths, and each component's schema resource URI. |
|
|
660
|
+
| **`semiotic://schema/{component}`** | One component's schema, metadata, accessibility guidance, and behavior contracts (for example `semiotic://schema/LineChart`). |
|
|
661
|
+
| **`semiotic://components`** | Backward-compatible component index showing renderable/browser-only status and MCP categories. |
|
|
583
662
|
| **`semiotic://surface-manifest`** | Generated inventory of the current AI schema, exports, renderability, tools, resources, and prompts. |
|
|
584
663
|
| **`semiotic://behavior-contracts`** | Agent-visible semantic rules for color precedence, required prop combinations, push refs, and renderability. |
|
|
585
664
|
| **`semiotic://system-prompt`** | Compact AI instructions with import rules, chart props, SSR guidance, and pitfalls. |
|
|
@@ -1,26 +1,33 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: semiotic-charts
|
|
3
|
-
description:
|
|
3
|
+
description: Build, repair, and verify charts in an existing Semiotic project, when Semiotic is explicitly requested, or when evaluating its documented capabilities against a visualization task. Preserve the project's dependency and runtime constraints; routine changes in another charting stack and tasks without a chart do not call for this skill.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Generating charts with Semiotic
|
|
7
7
|
|
|
8
|
-
Semiotic is a React data-visualization library
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
8
|
+
Semiotic is a React data-visualization library with configuration validation,
|
|
9
|
+
render evidence, structured access, and artifact revision support. Use this
|
|
10
|
+
workflow to check the parts of a chart that the task requires. A capability
|
|
11
|
+
comparison may conclude that the existing stack, a table, or another tool is
|
|
12
|
+
the better fit; the skill does not authorize adding a dependency or migrating
|
|
13
|
+
working charts.
|
|
12
14
|
|
|
13
15
|
The cardinal rule: **do not hand-write chart JSX and hope it paints.** Emit a
|
|
14
16
|
`{ component, props }` proposal and run it through the trust loop, which is
|
|
15
|
-
validated and diagnosed; when a renderer is available,
|
|
17
|
+
validated and diagnosed; when a renderer is available, checked for a nonempty
|
|
18
|
+
static scene. This does not establish correct data mapping, live browser
|
|
19
|
+
behavior, or usability with assistive technology. Check the expected values
|
|
20
|
+
and run the browser or reception checks relevant to the task. Failed proposals
|
|
21
|
+
return reasons and ranked alternatives to retry with.
|
|
16
22
|
|
|
17
23
|
## Context discipline
|
|
18
24
|
|
|
19
|
-
Start with the task and the exact component schema. Use the MCP `getSchema` tool
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
25
|
+
Start with the task and the exact component schema. Use the MCP `getSchema` tool,
|
|
26
|
+
read `semiotic://schema/{component}`, or run
|
|
27
|
+
`npx semiotic-ai --schema <Component>`, then read one nearby example if needed.
|
|
28
|
+
Use `semiotic://schema-index` when the component is not known. Do not load the
|
|
29
|
+
full reference, schema, or example catalog by default; retrieve broader context
|
|
30
|
+
only when validation or diagnosis shows that it is necessary.
|
|
24
31
|
|
|
25
32
|
## The trust loop — generate → validate → diagnose → repair → prove
|
|
26
33
|
|
|
@@ -45,7 +52,7 @@ if (result.ok) {
|
|
|
45
52
|
|
|
46
53
|
`result` carries `{ ok, config, jsx, validation, diagnostics, repair?, reasons }`.
|
|
47
54
|
In a server/SSR context you can inject `render: renderChartWithEvidence` (from
|
|
48
|
-
`semiotic/server`) so the loop also *
|
|
55
|
+
`semiotic/server`) so the loop also *checks that the static scene is nonempty* and reads back
|
|
49
56
|
render evidence (mark count, domains, ARIA label) — the first-try oracle.
|
|
50
57
|
|
|
51
58
|
### As an agent tool
|
|
@@ -76,10 +83,13 @@ const ranked = suggestCharts(data, { intent: "trend", maxResults: 3, audience })
|
|
|
76
83
|
These are enforced by validation and the `npx semiotic-ai --doctor` gate. Honor
|
|
77
84
|
them in every proposal:
|
|
78
85
|
|
|
79
|
-
1. **Sub-path imports.** Import from the
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
86
|
+
1. **Sub-path imports.** Import from the smallest stable entry that covers every
|
|
87
|
+
chart in the route, never the barrel: use `semiotic/line` when `LineChart`
|
|
88
|
+
is the only XY chart; otherwise use family entries such as `semiotic/xy`,
|
|
89
|
+
`semiotic/ordinal`, `semiotic/network`, `semiotic/geo`, `semiotic/realtime`,
|
|
90
|
+
or `semiotic/ai`. Family entries avoid loading other families and the
|
|
91
|
+
AI/server surfaces; they do not necessarily exclude unused marks within their
|
|
92
|
+
own family.
|
|
83
93
|
2. **Static usage requires data in props.** `renderChart`, SSR snapshots, and any
|
|
84
94
|
copy-paste example need `data` (or `nodes`/`edges`) present.
|
|
85
95
|
3. **Push (live) mode omits `data` entirely.** Create a ref, do NOT pass
|
|
@@ -102,7 +112,7 @@ them in every proposal:
|
|
|
102
112
|
## What good output looks like
|
|
103
113
|
|
|
104
114
|
```tsx
|
|
105
|
-
import { LineChart } from "semiotic/
|
|
115
|
+
import { LineChart } from "semiotic/line"
|
|
106
116
|
|
|
107
117
|
<LineChart
|
|
108
118
|
data={series}
|