semiotic 3.9.2 → 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 +99 -74
- package/agent-skill/semiotic-charts/SKILL.md +13 -7
- 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/dist/mcp-server.js +68 -68
- package/ai/examples.md +1 -1
- package/ai/reference.md +31 -14
- package/ai/schema.json +1868 -438
- package/ai/surface-manifest.json +11 -4
- package/ai/system-prompt.md +2 -0
- 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-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-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
- 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 +2 -1
- package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
- package/dist/components/ai/chartRecipes.d.ts +4 -0
- package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
- package/dist/components/ai/describePhysicsSource.d.ts +13 -0
- 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/ordinal/DonutChart.d.ts +2 -0
- package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
- package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
- package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
- package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
- package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -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/ProcessFlowChart.d.ts +6 -0
- package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
- 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/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/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 +4 -0
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
- package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
- package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
- package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
- package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
- package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -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/auditAccessibilityText.d.ts +4 -2
- 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/tooltipUtils.d.ts +1 -1
- package/dist/components/charts/shared/useChartLegend.d.ts +4 -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/MinimapChart.d.ts +7 -0
- package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
- package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
- package/dist/components/charts/xy/WaterfallChart.d.ts +8 -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 +16 -8
- 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 +3 -1
- 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/recipes/firstAvailableTrack.d.ts +17 -0
- package/dist/components/recipes/intervals.d.ts +1 -1
- package/dist/components/semiotic-ai-core.d.ts +33 -22
- package/dist/components/semiotic-ai.d.ts +15 -3
- package/dist/components/semiotic-artifact-react.d.ts +10 -0
- package/dist/components/semiotic-artifact.d.ts +23 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-text.d.ts +2 -0
- package/dist/components/semiotic-utils-core.d.ts +18 -18
- package/dist/components/semiotic.d.ts +3 -3
- package/dist/components/server/renderEvidence.d.ts +12 -0
- package/dist/components/server/renderToStaticSVG.d.ts +3 -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 +6 -0
- package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
- package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
- package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
- 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/hitTestUtils.d.ts +2 -0
- 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 +3 -0
- 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/pipelineStoreUpdateResults.d.ts +1 -1
- 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 +4 -53
- package/dist/components/stream/useGeoFrameHandle.d.ts +16 -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/xyDateTicks.d.ts +3 -2
- package/dist/components/stream/xyFrameAxisTypes.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/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.module.min.js +1 -1
- package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
- package/dist/semiotic-ai-core.d.ts +33 -22
- 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 +15 -3
- 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.min.js +1 -1
- package/dist/semiotic-evidence.module.min.js +1 -1
- 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.module.min.js +1 -1
- package/dist/semiotic-physics.d.ts +4 -4
- 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.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.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 +18 -18
- 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.d.ts +3 -3
- 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 +55 -14
- 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-3SCUN5HI.min.js +0 -1
- package/dist/c-3VVKFA4M.min.js +0 -1
- package/dist/c-43TJZS3F.min.js +0 -1
- package/dist/c-4DTZPSUD.min.js +0 -1
- package/dist/c-4ES5367Y.min.js +0 -1
- package/dist/c-52TEGIUJ.min.js +0 -1
- package/dist/c-54IRWOGM.min.js +0 -1
- package/dist/c-5D2S4RMI.min.js +0 -1
- package/dist/c-5JWCTX3G.min.js +0 -1
- package/dist/c-6CMMSN6N.min.js +0 -1
- package/dist/c-6HRB2L7H.min.js +0 -1
- package/dist/c-6O5EVOPH.min.js +0 -1
- package/dist/c-7W4SV36A.min.js +0 -1
- package/dist/c-A4WRGZFX.min.js +0 -1
- package/dist/c-AG7WWVIH.min.js +0 -1
- package/dist/c-AH6J4MTN.min.js +0 -1
- package/dist/c-AKAF6JAD.min.js +0 -1
- package/dist/c-ALYR5LKK.min.js +0 -1
- package/dist/c-BBKITSXB.min.js +0 -1
- package/dist/c-BYDPC44I.min.js +0 -1
- package/dist/c-CFFIU2MW.min.js +0 -1
- package/dist/c-CGNHBHCE.min.js +0 -1
- package/dist/c-CJYSXIFV.min.js +0 -1
- package/dist/c-CZF7MV67.min.js +0 -1
- package/dist/c-D53OKBSY.min.js +0 -1
- package/dist/c-DADXPJXV.min.js +0 -1
- package/dist/c-DBQ2V7CH.min.js +0 -1
- package/dist/c-DPMVAUAW.min.js +0 -1
- package/dist/c-ECJCKLYY.min.js +0 -1
- package/dist/c-EGATGOWJ.min.js +0 -1
- package/dist/c-EGR6VYBW.min.js +0 -1
- package/dist/c-ESNR43AN.min.js +0 -1
- package/dist/c-F3LIKINL.min.js +0 -1
- package/dist/c-F5ZB5GJ6.min.js +0 -1
- package/dist/c-G36WS6LN.min.js +0 -1
- package/dist/c-G3VYMHKE.min.js +0 -1
- package/dist/c-GGISSW5E.min.js +0 -1
- package/dist/c-GR6MOEQC.min.js +0 -1
- package/dist/c-GSVCN34B.min.js +0 -1
- package/dist/c-GYOQCEFP.min.js +0 -1
- package/dist/c-H3DNMTCC.min.js +0 -1
- package/dist/c-I6J3FEZE.min.js +0 -1
- package/dist/c-IGH6MGJ5.min.js +0 -1
- package/dist/c-II2EEAJN.min.js +0 -1
- package/dist/c-IUHFPMHD.min.js +0 -1
- package/dist/c-J6M4JHRS.min.js +0 -1
- package/dist/c-JM3MGLQV.min.js +0 -1
- package/dist/c-KM3N7F7R.min.js +0 -1
- package/dist/c-LF5BZFNC.min.js +0 -1
- package/dist/c-LKBSGFQC.min.js +0 -1
- package/dist/c-MNF2S4AA.min.js +0 -1
- package/dist/c-MT3WBK7M.min.js +0 -1
- package/dist/c-NDJADPIF.min.js +0 -1
- package/dist/c-NVPQCIL5.min.js +0 -1
- package/dist/c-NY3JWV2K.min.js +0 -1
- package/dist/c-OFWJBEE5.min.js +0 -1
- package/dist/c-OYFHP5F5.min.js +0 -1
- package/dist/c-PGKQGGQ2.min.js +0 -1
- package/dist/c-PPWDL5ZI.min.js +0 -1
- package/dist/c-Q2IPZ3MU.min.js +0 -1
- package/dist/c-QKHMBE2E.min.js +0 -1
- package/dist/c-QMVM3AY6.min.js +0 -1
- package/dist/c-QSGWX53A.min.js +0 -1
- package/dist/c-RJKEKZOO.min.js +0 -1
- package/dist/c-RSVIHIQ4.min.js +0 -1
- package/dist/c-S6U5CGT5.min.js +0 -1
- package/dist/c-SFDIIU5G.min.js +0 -1
- package/dist/c-SLGMUBUL.min.js +0 -1
- package/dist/c-SRTBCRVE.min.js +0 -1
- package/dist/c-T6UAIKBH.min.js +0 -1
- package/dist/c-TMCTEVVW.min.js +0 -1
- package/dist/c-TMOSJLT3.min.js +0 -1
- package/dist/c-TZW3JGJ5.min.js +0 -1
- package/dist/c-U6ESPM7V.min.js +0 -1
- package/dist/c-UC5PTTFI.min.js +0 -1
- package/dist/c-USFMFKIH.min.js +0 -1
- package/dist/c-VGKUEZBC.min.js +0 -1
- package/dist/c-VGW3VG3I.min.js +0 -1
- package/dist/c-VN2HG5BS.min.js +0 -1
- package/dist/c-VPZDY5Q4.min.js +0 -1
- package/dist/c-VRXUB2F2.min.js +0 -1
- package/dist/c-VUBQNQJH.min.js +0 -1
- package/dist/c-VUH4PGZY.min.js +0 -1
- package/dist/c-W3CE4A4S.min.js +0 -1
- package/dist/c-X5UBGU2V.min.js +0 -1
- package/dist/c-XDRV7RKW.min.js +0 -1
- package/dist/c-YGZHURXZ.min.js +0 -1
- package/dist/c-YZVRZGX2.min.js +0 -1
- /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
- /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
- /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
package/README.md
CHANGED
|
@@ -9,52 +9,60 @@
|
|
|
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
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
-
|
|
43
|
-
|
|
44
|
-
diagnostics, and stricter shipped-product and contributor gates.
|
|
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.
|
|
45
51
|
|
|
46
52
|
## Why Semiotic
|
|
47
53
|
|
|
48
54
|
Semiotic is a data visualization library for React that combines broad chart
|
|
49
|
-
coverage with
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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.
|
|
53
60
|
|
|
54
61
|
### Built for AI-assisted development
|
|
55
62
|
|
|
56
|
-
Semiotic
|
|
57
|
-
|
|
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.
|
|
58
66
|
|
|
59
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.
|
|
60
68
|
- **`ai/schema.json`** — machine-readable prop schemas for every component
|
|
@@ -392,7 +400,7 @@ loadConversationArc(sink.load(), { enabled: false })
|
|
|
392
400
|
|
|
393
401
|
## Bundle Sizes
|
|
394
402
|
|
|
395
|
-
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.
|
|
396
404
|
|
|
397
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.
|
|
398
406
|
|
|
@@ -401,21 +409,23 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
401
409
|
|
|
402
410
|
| Entry Point | gzip | What's inside |
|
|
403
411
|
|---|---|---|
|
|
404
|
-
| `semiotic/access` | **
|
|
412
|
+
| `semiotic/access` | **36 KB** | Chart Access Contract factory and first-wave baseline contracts |
|
|
405
413
|
| `semiotic/evidence` | **50 KB** | Chart Evidence Envelope, deterministic hashing, and publication gate |
|
|
406
|
-
| `semiotic/
|
|
407
|
-
| `semiotic/
|
|
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 |
|
|
408
418
|
| `semiotic/ordinal` | **130 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
|
|
409
|
-
| `semiotic/network` | **
|
|
410
|
-
| `semiotic/geo` | **
|
|
411
|
-
| `semiotic/realtime` | **
|
|
412
|
-
| `semiotic/realtime/core` | **
|
|
419
|
+
| `semiotic/network` | **150 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
|
|
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 |
|
|
413
423
|
| `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` | **
|
|
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 |
|
|
419
429
|
| `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
|
|
420
430
|
| `semiotic/recipes` | **100 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
421
431
|
| `semiotic/recipes/core` | **92 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
@@ -423,16 +433,17 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
423
433
|
| `semiotic/themes` | **12 KB** | Theme presets only (tufte, carbon, etc.) |
|
|
424
434
|
| `semiotic/themes/core` | **12 KB** | Theme presets and token helpers |
|
|
425
435
|
| `semiotic/themes/react` | **7 KB** | ThemeProvider/useTheme and hooks |
|
|
426
|
-
| `semiotic/data` | **
|
|
436
|
+
| `semiotic/data` | **3 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
|
|
427
437
|
| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
|
|
428
|
-
| `semiotic/physics` | **
|
|
438
|
+
| `semiotic/physics` | **165 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
|
|
429
439
|
| `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
|
|
430
440
|
| `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
|
|
431
|
-
| `semiotic/ai` | **
|
|
432
|
-
| `semiotic/ai/core` | **
|
|
433
|
-
| `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 |
|
|
434
444
|
| `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
|
|
435
|
-
| `semiotic` | **
|
|
445
|
+
| `semiotic/text` | **1 KB** | Optional Pretext annotation hook — peer package excluded |
|
|
446
|
+
| `semiotic` | **371 KB** | Full chart API and shared utilities |
|
|
436
447
|
|
|
437
448
|
<!-- semiotic-bundle-sizes:end -->
|
|
438
449
|
|
|
@@ -453,32 +464,35 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
453
464
|
|
|
454
465
|
| Public named import | Runtime | gzip cold-consumer bundle |
|
|
455
466
|
|---|---:|---:|
|
|
456
|
-
| `import { LineChart } from "semiotic"` | browser | **
|
|
457
|
-
| `import { LineChart } from "semiotic/xy"` | browser | **
|
|
458
|
-
| `import { LineChart } from "semiotic/line"` | browser | **
|
|
459
|
-
| `import { BarChart } from "semiotic/ordinal"` | browser | **133.
|
|
460
|
-
| `import { SankeyDiagram } from "semiotic/network"` | browser | **
|
|
461
|
-
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **
|
|
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** |
|
|
462
473
|
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
|
|
463
474
|
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
|
|
464
|
-
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **
|
|
475
|
+
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **149.8 KiB** |
|
|
465
476
|
| `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
|
|
466
477
|
| `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
|
|
467
|
-
| `import { renderChart } from "semiotic/server"` | node | **
|
|
468
|
-
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **
|
|
469
|
-
| `import { renderToImage } from "semiotic/server/node"` | node | **
|
|
470
|
-
| `import { suggestCharts } from "semiotic/ai"` | browser | **
|
|
471
|
-
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **
|
|
472
|
-
| `import {
|
|
473
|
-
| `import {
|
|
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** |
|
|
474
487
|
| `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
|
|
475
|
-
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **
|
|
476
|
-
| `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** |
|
|
477
491
|
| `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
|
|
478
492
|
| `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
|
|
479
493
|
| `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.2 KiB** |
|
|
480
|
-
| `import { validateProps } from "semiotic/utils"` | browser | **
|
|
481
|
-
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **
|
|
494
|
+
| `import { validateProps } from "semiotic/utils"` | browser | **10.2 KiB** |
|
|
495
|
+
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **7.9 KiB** |
|
|
482
496
|
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.4 KiB** |
|
|
483
497
|
| `import { waffleLayout } from "semiotic/recipes"` | browser | **1.7 KiB** |
|
|
484
498
|
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.7 KiB** |
|
|
@@ -486,7 +500,7 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
486
500
|
| `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
|
|
487
501
|
| `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
|
|
488
502
|
|
|
489
|
-
**Line-boundary interpretation:** the retained named import from `semiotic/line` emits
|
|
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%.
|
|
490
504
|
|
|
491
505
|
<!-- semiotic-cold-consumer:end -->
|
|
492
506
|
|
|
@@ -495,8 +509,8 @@ and declares them as normal runtime dependencies. Consumers do not need to
|
|
|
495
509
|
install d3 packages manually; their bundler resolves, deduplicates, and
|
|
496
510
|
tree-shakes that dependency graph. A packed webpack comparison favored this
|
|
497
511
|
model in three of four representative chart families, and a Next 16 webpack
|
|
498
|
-
route was
|
|
499
|
-
bundled win, Sankey, was only
|
|
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,
|
|
500
514
|
1.9 MB unpacked d3 install closure in exchange for smaller common application
|
|
501
515
|
graphs and an ordinary dependency contract. The checked policy is
|
|
502
516
|
`npm run check:d3-packaging`; the reproducible evidence is in
|
|
@@ -625,11 +639,22 @@ host-header allowlisting. For ChatGPT Apps domain verification, set
|
|
|
625
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. |
|
|
626
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. |
|
|
627
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.
|
|
628
652
|
|
|
629
653
|
### Resources
|
|
630
654
|
|
|
631
655
|
| Resource | Description |
|
|
632
656
|
|----------|-------------|
|
|
657
|
+
| **`semiotic://artifact-contract-schema`** | Standalone JSON Schema for portable purpose, claim, evidence, timing, review, and transfer metadata. |
|
|
633
658
|
| **`semiotic://schema`** | Full machine-readable component schema JSON. |
|
|
634
659
|
| **`semiotic://schema-index`** | Compact discovery index with categories, renderability, import paths, and each component's schema resource URI. |
|
|
635
660
|
| **`semiotic://schema/{component}`** | One component's schema, metadata, accessibility guidance, and behavior contracts (for example `semiotic://schema/LineChart`). |
|
|
@@ -1,18 +1,24 @@
|
|
|
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
|
|
|
@@ -46,7 +52,7 @@ if (result.ok) {
|
|
|
46
52
|
|
|
47
53
|
`result` carries `{ ok, config, jsx, validation, diagnostics, repair?, reasons }`.
|
|
48
54
|
In a server/SSR context you can inject `render: renderChartWithEvidence` (from
|
|
49
|
-
`semiotic/server`) so the loop also *
|
|
55
|
+
`semiotic/server`) so the loop also *checks that the static scene is nonempty* and reads back
|
|
50
56
|
render evidence (mark count, domains, ARIA label) — the first-try oracle.
|
|
51
57
|
|
|
52
58
|
### As an agent tool
|