semiotic 3.9.2 → 3.10.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +97 -76
- 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/componentMetadata.cjs +3 -1
- package/ai/dist/mcp-server.js +68 -68
- package/ai/examples.md +68 -1
- package/ai/reference.md +105 -14
- package/ai/schema.json +6646 -18
- package/ai/surface-manifest.json +34 -6
- 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-2RL2QPZJ.min.js +1 -0
- package/dist/c-2WK7YJLL.min.js +1 -0
- package/dist/c-42PLDTX7.min.js +1 -0
- package/dist/c-45CQWZZ6.min.js +1 -0
- package/dist/c-4BRHKVKV.min.js +1 -0
- package/dist/c-7242NXSG.min.js +1 -0
- package/dist/c-7DVPSB5C.min.js +1 -0
- package/dist/c-7EGHJU2F.min.js +1 -0
- package/dist/c-A7OGOFSL.min.js +1 -0
- package/dist/c-AFBSWT77.min.js +1 -0
- package/dist/c-AH5HWZWS.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-B7GW7IHJ.min.js +1 -0
- package/dist/c-BNFJMDHN.min.js +1 -0
- package/dist/c-BOHCQILI.min.js +1 -0
- package/dist/c-C3TZLTZK.min.js +1 -0
- package/dist/c-CGQAQWBV.min.js +1 -0
- package/dist/c-CPV4N35K.min.js +1 -0
- package/dist/c-D6HAAPTX.min.js +1 -0
- package/dist/c-DIPEYUOW.min.js +1 -0
- package/dist/c-E4JDJH4I.min.js +1 -0
- package/dist/c-E72OTUZU.min.js +1 -0
- package/dist/c-E7I2L7CU.min.js +1 -0
- package/dist/c-ELDWAO2V.min.js +1 -0
- package/dist/c-EUBTECGM.min.js +1 -0
- package/dist/c-EUMPMDCS.min.js +1 -0
- package/dist/c-EZZT2WAE.min.js +1 -0
- package/dist/c-FHBVFCQB.min.js +1 -0
- package/dist/c-G4HCO2IQ.min.js +1 -0
- package/dist/c-G5VIJEOK.min.js +1 -0
- package/dist/c-GHVOXAYH.min.js +1 -0
- package/dist/c-GNTXRXRN.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-HP4ZFM47.min.js +1 -0
- package/dist/c-HPOYKCCG.min.js +1 -0
- package/dist/c-HYDTS5OP.min.js +1 -0
- package/dist/c-I4QJ6YLM.min.js +1 -0
- package/dist/c-IK33LNZ6.min.js +1 -0
- package/dist/c-IK3PZHRY.min.js +1 -0
- package/dist/c-J6DVC236.min.js +1 -0
- package/dist/c-JIMJF6F6.min.js +1 -0
- package/dist/c-JUKIWTBJ.min.js +1 -0
- package/dist/c-KKPMHAZC.min.js +1 -0
- package/dist/c-L6WNDBHV.min.js +1 -0
- package/dist/c-LDEX5OFW.min.js +1 -0
- package/dist/c-LESEUVC5.min.js +1 -0
- package/dist/c-LYQMZMZQ.min.js +1 -0
- package/dist/c-MB6CV5NC.min.js +1 -0
- package/dist/c-MOKJOIPE.min.js +1 -0
- package/dist/c-MVR3RWF3.min.js +1 -0
- package/dist/c-N3FXLRNT.min.js +1 -0
- package/dist/c-N5NPTJVJ.min.js +1 -0
- package/dist/c-NHBL4J67.min.js +1 -0
- package/dist/c-ODG6TFSY.min.js +1 -0
- package/dist/c-ORLEBW72.min.js +1 -0
- package/dist/c-P65V6HLO.min.js +1 -0
- package/dist/c-PRIKOLTE.min.js +1 -0
- package/dist/c-PSKKFZNP.min.js +1 -0
- package/dist/c-PSNI6KAZ.min.js +1 -0
- package/dist/c-QA3HMQJP.min.js +1 -0
- package/dist/c-R2P4RR7Q.min.js +1 -0
- package/dist/c-RFC7UAG7.min.js +1 -0
- package/dist/c-S3AZX5PP.min.js +1 -0
- package/dist/c-SGAURYHG.min.js +1 -0
- package/dist/c-SJMWU6UX.min.js +1 -0
- package/dist/c-STIIGQOD.min.js +1 -0
- package/dist/c-T2ASIJVZ.min.js +1 -0
- package/dist/c-T2V7O2LO.min.js +1 -0
- package/dist/c-TKG2NP7G.min.js +1 -0
- package/dist/c-TX3THUTO.min.js +1 -0
- package/dist/c-TX7XJM3Z.min.js +1 -0
- package/dist/c-UC7SIU2W.min.js +1 -0
- package/dist/c-UMXSJIOV.min.js +1 -0
- package/dist/c-VJTDST2R.min.js +1 -0
- package/dist/c-VRSXMLYF.min.js +1 -0
- package/dist/c-VSLWSAN2.min.js +1 -0
- package/dist/c-VXLOLYTO.min.js +1 -0
- package/dist/c-W4ZUKSEQ.min.js +1 -0
- package/dist/c-WCBRPILW.min.js +1 -0
- package/dist/c-WGHT7OCY.min.js +1 -0
- package/dist/c-WUWXGQYA.min.js +1 -0
- package/dist/c-WWCW3APR.min.js +1 -0
- package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
- package/dist/c-Y6PYUMFU.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-ZIVPFTOC.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/chartDataProps.d.ts +3 -0
- package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
- package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
- package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
- package/dist/components/charts/shared/hooks.d.ts +3 -1
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- 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/atlas/DependencyForestChart.d.ts +20 -0
- package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
- package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
- package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
- package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
- package/dist/components/recipes/atlas/braid.d.ts +62 -0
- package/dist/components/recipes/atlas/capsules.d.ts +18 -0
- package/dist/components/recipes/atlas/compare.d.ts +4 -0
- package/dist/components/recipes/atlas/completeness.d.ts +2 -0
- package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
- package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
- package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
- package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
- package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
- package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
- package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
- package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
- package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
- package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
- package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
- package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
- package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
- package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
- package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
- package/dist/components/recipes/atlas/forests.d.ts +11 -0
- package/dist/components/recipes/atlas/ids.d.ts +6 -0
- package/dist/components/recipes/atlas/index.d.ts +26 -0
- package/dist/components/recipes/atlas/ledger.d.ts +7 -0
- package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
- package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
- package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
- package/dist/components/recipes/atlas/motifs.d.ts +3 -0
- package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
- package/dist/components/recipes/atlas/prepare.d.ts +14 -0
- package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
- package/dist/components/recipes/atlas/profile.d.ts +19 -0
- package/dist/components/recipes/atlas/publish.d.ts +10 -0
- package/dist/components/recipes/atlas/queries.d.ts +34 -0
- package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
- package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
- package/dist/components/recipes/atlas/sections.d.ts +3 -0
- package/dist/components/recipes/atlas/support.d.ts +7 -0
- package/dist/components/recipes/atlas/types.d.ts +278 -0
- package/dist/components/recipes/atlas/validate.d.ts +12 -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-atlas-core.d.ts +20 -0
- package/dist/components/semiotic-atlas.d.ts +8 -0
- package/dist/components/semiotic-experimental.d.ts +1 -1
- package/dist/components/semiotic-physics.d.ts +4 -4
- package/dist/components/semiotic-recipes-core.d.ts +9 -0
- 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/serverChartConfigs.d.ts +3 -0
- package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -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/NetworkPipelineStore.d.ts +1 -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/canvasSetup.d.ts +1 -2
- package/dist/components/stream/fontLoading.d.ts +4 -0
- package/dist/components/stream/hitTestUtils.d.ts +2 -0
- package/dist/components/stream/networkCustomLayout.d.ts +8 -0
- package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
- 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 +11 -0
- package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
- package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -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/shallowEqual.d.ts +2 -0
- package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
- package/dist/components/stream/types.d.ts +4 -53
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
- 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-atlas-core.d.ts +20 -0
- package/dist/semiotic-atlas-core.min.js +1 -0
- package/dist/semiotic-atlas-core.module.min.js +1 -0
- package/dist/semiotic-atlas-selection.module.min.js +2 -0
- package/dist/semiotic-atlas.d.ts +8 -0
- package/dist/semiotic-atlas.min.js +2 -0
- package/dist/semiotic-atlas.module.min.js +2 -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.d.ts +9 -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.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 +70 -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,52 @@
|
|
|
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
|
-
ordinal, XY, network, geo, realtime, and physics families, and structured
|
|
37
|
-
navigation provides overview-first hierarchy and choropleth semantics.
|
|
38
|
-
- Renderer and interaction fixes cover constant-value heatmaps, linked
|
|
39
|
-
selection and hover, automatic network legends, Waterfall and Radar geometry,
|
|
40
|
-
marginal graphics, custom layouts, tree-shaken network registration, and
|
|
41
|
-
instance-local accessible names.
|
|
42
|
-
- Release evidence now includes controlled dense-browser measurements,
|
|
43
|
-
deterministic linked-hover cohorts, generated bundle guidance, stronger AI
|
|
44
|
-
diagnostics, and stricter shipped-product and contributor gates.
|
|
27
|
+
## What's New in 3.10.1
|
|
28
|
+
|
|
29
|
+
3.10.1 adds Network Atlas recipes and reduces repeated layout work when charts
|
|
30
|
+
mount or resize.
|
|
31
|
+
|
|
32
|
+
- Network Atlas includes Motif Braid, Dependency X-Ray, and Flow Circuit
|
|
33
|
+
recipes, with interactive examples and an acceptance lab.
|
|
34
|
+
- Network charts reuse custom layouts when inputs are unchanged, avoid
|
|
35
|
+
duplicate worker solves, and treat palette and font changes as paint-only
|
|
36
|
+
updates where possible.
|
|
37
|
+
- Atlas readers integrate with themes and observers; network keyboard
|
|
38
|
+
activation and live hover announcements are corrected.
|
|
39
|
+
- Documentation preview checks and API snapshot parameter extraction are
|
|
40
|
+
more reliable.
|
|
41
|
+
|
|
42
|
+
See [the changelog](CHANGELOG.md#3101) for details.
|
|
45
43
|
|
|
46
44
|
## Why Semiotic
|
|
47
45
|
|
|
48
46
|
Semiotic is a data visualization library for React that combines broad chart
|
|
49
|
-
coverage with
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
47
|
+
coverage with AI tooling. It supports network graphs, streaming data,
|
|
48
|
+
statistical distributions and coordinated views, with schemas, examples and
|
|
49
|
+
diagnostics for implementing and checking each task. Check the project's
|
|
50
|
+
existing dependencies first: extending its current charting library may be
|
|
51
|
+
the best fit for a small change.
|
|
53
52
|
|
|
54
53
|
### Built for AI-assisted development
|
|
55
54
|
|
|
56
|
-
Semiotic
|
|
57
|
-
|
|
55
|
+
Semiotic provides a workflow for generating, checking and repairing chart
|
|
56
|
+
configurations. The [July 27, 2026 evaluation](evals/reports/openai-gpt-5.6-2026-07-27/README.md)
|
|
57
|
+
reports model- and task-specific results; it does not guarantee first-try correctness.
|
|
58
58
|
|
|
59
59
|
- **`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
60
|
- **`ai/schema.json`** — machine-readable prop schemas for every component
|
|
@@ -392,7 +392,7 @@ loadConversationArc(sink.load(), { enabled: false })
|
|
|
392
392
|
|
|
393
393
|
## Bundle Sizes
|
|
394
394
|
|
|
395
|
-
Semiotic ships
|
|
395
|
+
Semiotic ships 37 stable JavaScript entry points (36 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
396
|
|
|
397
397
|
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
398
|
|
|
@@ -401,38 +401,43 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
|
|
|
401
401
|
|
|
402
402
|
| Entry Point | gzip | What's inside |
|
|
403
403
|
|---|---|---|
|
|
404
|
-
| `semiotic/
|
|
404
|
+
| `semiotic/atlas` | **273 KB** | Motif Braid, Dependency Forest, and Flow Circuit readers |
|
|
405
|
+
| `semiotic/atlas/core` | **14 KB** | Network Atlas preparation, projections, and evidence queries |
|
|
406
|
+
| `semiotic/access` | **36 KB** | Chart Access Contract factory and first-wave baseline contracts |
|
|
405
407
|
| `semiotic/evidence` | **50 KB** | Chart Evidence Envelope, deterministic hashing, and publication gate |
|
|
406
|
-
| `semiotic/
|
|
407
|
-
| `semiotic/
|
|
408
|
-
| `semiotic/
|
|
409
|
-
| `semiotic/
|
|
410
|
-
| `semiotic/
|
|
411
|
-
| `semiotic/
|
|
412
|
-
| `semiotic/
|
|
408
|
+
| `semiotic/artifact` | **121 KB** | Renderer-independent contracts, claims, time, policy, grounding, and transfer audits |
|
|
409
|
+
| `semiotic/artifact/react` | **4 KB** | Accessible progressive disclosure for artifact contracts and policy evaluations |
|
|
410
|
+
| `semiotic/line` | **132 KB** | LineChart only — one-chart micro boundary |
|
|
411
|
+
| `semiotic/xy` | **163 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
|
|
412
|
+
| `semiotic/ordinal` | **131 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
|
|
413
|
+
| `semiotic/network` | **151 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
|
|
414
|
+
| `semiotic/geo` | **108 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
|
|
415
|
+
| `semiotic/realtime` | **161 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
|
|
416
|
+
| `semiotic/realtime/core` | **160 KB** | Streaming chart types, HOCs, and buffer helpers |
|
|
413
417
|
| `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` | **
|
|
418
|
+
| `semiotic/server` | **241 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
419
|
+
| `semiotic/server/node` | **241 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
|
|
420
|
+
| `semiotic/server/edge` | **248 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
|
|
421
|
+
| `semiotic/utils` | **99 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
|
|
422
|
+
| `semiotic/utils/core` | **91 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
|
|
419
423
|
| `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
|
|
420
|
-
| `semiotic/recipes` | **
|
|
421
|
-
| `semiotic/recipes/core` | **
|
|
424
|
+
| `semiotic/recipes` | **111 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
425
|
+
| `semiotic/recipes/core` | **103 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
|
|
422
426
|
| `semiotic/recipes/react` | **8 KB** | Glyph and React layout-selection helpers |
|
|
423
427
|
| `semiotic/themes` | **12 KB** | Theme presets only (tufte, carbon, etc.) |
|
|
424
428
|
| `semiotic/themes/core` | **12 KB** | Theme presets and token helpers |
|
|
425
429
|
| `semiotic/themes/react` | **7 KB** | ThemeProvider/useTheme and hooks |
|
|
426
|
-
| `semiotic/data` | **
|
|
430
|
+
| `semiotic/data` | **3 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
|
|
427
431
|
| `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
|
|
428
|
-
| `semiotic/physics` | **
|
|
432
|
+
| `semiotic/physics` | **167 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
|
|
429
433
|
| `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
|
|
430
434
|
| `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
|
|
431
|
-
| `semiotic/ai` | **
|
|
432
|
-
| `semiotic/ai/core` | **
|
|
433
|
-
| `semiotic/controls` | **
|
|
435
|
+
| `semiotic/ai` | **595 KB** | All schema-backed charts + validation — optimized for LLM code generation |
|
|
436
|
+
| `semiotic/ai/core` | **139 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
|
|
437
|
+
| `semiotic/controls` | **10 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
|
|
434
438
|
| `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
|
|
435
|
-
| `semiotic` | **
|
|
439
|
+
| `semiotic/text` | **1 KB** | Optional Pretext annotation hook — peer package excluded |
|
|
440
|
+
| `semiotic` | **374 KB** | Full chart API and shared utilities |
|
|
436
441
|
|
|
437
442
|
<!-- semiotic-bundle-sizes:end -->
|
|
438
443
|
|
|
@@ -453,32 +458,37 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
453
458
|
|
|
454
459
|
| Public named import | Runtime | gzip cold-consumer bundle |
|
|
455
460
|
|---|---:|---:|
|
|
456
|
-
| `import {
|
|
457
|
-
| `import {
|
|
458
|
-
| `import { LineChart } from "semiotic
|
|
459
|
-
| `import {
|
|
460
|
-
| `import {
|
|
461
|
-
| `import {
|
|
461
|
+
| `import { MotifBraidChart } from "semiotic/atlas"` | browser | **161.4 KiB** |
|
|
462
|
+
| `import { prepareNetworkAtlas } from "semiotic/atlas/core"` | browser | **6.4 KiB** |
|
|
463
|
+
| `import { LineChart } from "semiotic"` | browser | **141.4 KiB** |
|
|
464
|
+
| `import { LineChart } from "semiotic/xy"` | browser | **141.8 KiB** |
|
|
465
|
+
| `import { LineChart } from "semiotic/line"` | browser | **141.7 KiB** |
|
|
466
|
+
| `import { BarChart } from "semiotic/ordinal"` | browser | **133.5 KiB** |
|
|
467
|
+
| `import { SankeyDiagram } from "semiotic/network"` | browser | **156.9 KiB** |
|
|
468
|
+
| `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **142.5 KiB** |
|
|
462
469
|
| `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
|
|
463
470
|
| `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
|
|
464
471
|
| `import { GaltonBoardChart } from "semiotic/physics"` | browser | **150.3 KiB** |
|
|
465
472
|
| `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
|
|
466
473
|
| `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 {
|
|
474
|
+
| `import { renderChart } from "semiotic/server"` | node | **280.8 KiB** |
|
|
475
|
+
| `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **146.7 KiB** |
|
|
476
|
+
| `import { renderToImage } from "semiotic/server/node"` | node | **281.5 KiB** |
|
|
477
|
+
| `import { suggestCharts } from "semiotic/ai"` | browser | **259.1 KiB** |
|
|
478
|
+
| `import { suggestCharts } from "semiotic/ai/core"` | browser | **46.5 KiB** |
|
|
479
|
+
| `import { buildArtifactContract } from "semiotic/artifact"` | browser | **19.7 KiB** |
|
|
480
|
+
| `import { ArtifactInspector } from "semiotic/artifact/react"` | browser | **3.8 KiB** |
|
|
481
|
+
| `import { createChartAccessContract } from "semiotic/access"` | browser | **33.4 KiB** |
|
|
482
|
+
| `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **49.1 KiB** |
|
|
474
483
|
| `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
|
|
475
|
-
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **
|
|
476
|
-
| `import {
|
|
484
|
+
| `import { ChoroplethMap } from "semiotic/geo"` | browser | **116.7 KiB** |
|
|
485
|
+
| `import { usePretextAnnotations } from "semiotic/text"` | browser | **1.5 KiB** |
|
|
486
|
+
| `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.2 KiB** |
|
|
477
487
|
| `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
|
|
478
488
|
| `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
|
|
479
489
|
| `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 | **
|
|
490
|
+
| `import { validateProps } from "semiotic/utils"` | browser | **10.4 KiB** |
|
|
491
|
+
| `import { smartTickFormat } from "semiotic/utils/core"` | browser | **8.1 KiB** |
|
|
482
492
|
| `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.4 KiB** |
|
|
483
493
|
| `import { waffleLayout } from "semiotic/recipes"` | browser | **1.7 KiB** |
|
|
484
494
|
| `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.7 KiB** |
|
|
@@ -486,7 +496,7 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
|
|
|
486
496
|
| `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
|
|
487
497
|
| `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
|
|
488
498
|
|
|
489
|
-
**Line-boundary interpretation:** the retained named import from `semiotic/line` emits 422.
|
|
499
|
+
**Line-boundary interpretation:** the retained named import from `semiotic/line` emits 422.6 KiB raw versus 422.6 KiB from `semiotic/xy`; gzip differs by 0.1 KiB (0.0%). 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
500
|
|
|
491
501
|
<!-- semiotic-cold-consumer:end -->
|
|
492
502
|
|
|
@@ -495,8 +505,8 @@ and declares them as normal runtime dependencies. Consumers do not need to
|
|
|
495
505
|
install d3 packages manually; their bundler resolves, deduplicates, and
|
|
496
506
|
tree-shakes that dependency graph. A packed webpack comparison favored this
|
|
497
507
|
model in three of four representative chart families, and a Next 16 webpack
|
|
498
|
-
route was
|
|
499
|
-
bundled win, Sankey, was only
|
|
508
|
+
route was 22.7 KiB gzip smaller than the fully bundled alternative. The one
|
|
509
|
+
bundled win, Sankey, was only 0.4 KiB gzip. This choice retains a 22-package,
|
|
500
510
|
1.9 MB unpacked d3 install closure in exchange for smaller common application
|
|
501
511
|
graphs and an ordinary dependency contract. The checked policy is
|
|
502
512
|
`npm run check:d3-packaging`; the reproducible evidence is in
|
|
@@ -625,11 +635,22 @@ host-header allowlisting. For ChatGPT Apps domain verification, set
|
|
|
625
635
|
| **`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
636
|
| **`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
637
|
| **`applyTheme`** | List named theme presets or return ThemeProvider/CSS/token usage for a preset such as `{ name: "tufte" }`. |
|
|
638
|
+
| **`auditArtifact`** | Evaluate an explicit artifact contract under a named policy without inferring missing source, review, or timing facts. |
|
|
639
|
+
| **`recommendRepresentation`** | Compare chart and non-chart outcomes against supplied data, claims, evidence, time state, and policy requirements. |
|
|
640
|
+
| **`repairArtifact`** | Propose contract repairs and optionally fill missing identity fields; existing mismatches require a revision and claim reassessment. |
|
|
641
|
+
| **`explainRefusal`** | Explain which explicit policy obligations prevent publication or action and identify safe follow-up work. |
|
|
642
|
+
|
|
643
|
+
Artifact tools are opt-in diagnostics, not publication authorization. A
|
|
644
|
+
`conditional` result (including CLI exit code 0) retains open work. Ordinary
|
|
645
|
+
`renderChart` calls do not enforce artifact policy; governed hosts must enforce
|
|
646
|
+
their own release boundary. Manual-check resolution and revision-bound release
|
|
647
|
+
approval remain separate host workflow work.
|
|
628
648
|
|
|
629
649
|
### Resources
|
|
630
650
|
|
|
631
651
|
| Resource | Description |
|
|
632
652
|
|----------|-------------|
|
|
653
|
+
| **`semiotic://artifact-contract-schema`** | Standalone JSON Schema for portable purpose, claim, evidence, timing, review, and transfer metadata. |
|
|
633
654
|
| **`semiotic://schema`** | Full machine-readable component schema JSON. |
|
|
634
655
|
| **`semiotic://schema-index`** | Compact discovery index with categories, renderability, import paths, and each component's schema resource URI. |
|
|
635
656
|
| **`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
|