semiotic 3.8.6 → 3.8.8
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/CLAUDE.md +34 -8
- package/README.md +93 -56
- package/ai/behaviorContracts.cjs +86 -1
- package/ai/componentMetadata.cjs +4 -9
- package/ai/dist/mcp-server.js +125 -12
- package/ai/examples.md +154 -7
- package/ai/schema.json +1742 -156
- package/ai/surface-manifest.json +12 -10
- package/ai/system-prompt.md +9 -3
- package/dist/{chunk-chartContainerDataAudit-FEOD5GTQ.module.min.js → chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js} +1 -1
- package/dist/chunk-chunk-2B3AIKUZ.module.min.js +2 -0
- package/dist/chunk-chunk-2NVFEB7P.module.min.js +2 -0
- package/dist/chunk-chunk-3GCILWPB.module.min.js +2 -0
- package/dist/chunk-chunk-46KRGJQP.module.min.js +1 -0
- package/dist/{chunk-chunk-G7WFWHAD.module.min.js → chunk-chunk-4ITOQRXM.module.min.js} +1 -1
- package/dist/chunk-chunk-4MLLQUGW.module.min.js +2 -0
- package/dist/chunk-chunk-57RBPDBQ.module.min.js +2 -0
- package/dist/chunk-chunk-5VVNW5AZ.module.min.js +1 -0
- package/dist/chunk-chunk-66PCWJUG.module.min.js +1 -0
- package/dist/chunk-chunk-6V5VQVCT.module.min.js +2 -0
- package/dist/chunk-chunk-7LE56WAE.module.min.js +2 -0
- package/dist/chunk-chunk-7T25U75Z.module.min.js +2 -0
- package/dist/chunk-chunk-AF53TBSN.module.min.js +2 -0
- package/dist/chunk-chunk-BTZYH2IE.module.min.js +1 -0
- package/dist/chunk-chunk-BWV55BZK.module.min.js +2 -0
- package/dist/chunk-chunk-BZNOAHJV.module.min.js +2 -0
- package/dist/chunk-chunk-CD6PVVS3.module.min.js +2 -0
- package/dist/chunk-chunk-DTSNLGRK.module.min.js +2 -0
- package/dist/chunk-chunk-FC3NZWYR.module.min.js +2 -0
- package/dist/chunk-chunk-FEPXDKJP.module.min.js +1 -0
- package/dist/chunk-chunk-FJ76HWQZ.module.min.js +1 -0
- package/dist/chunk-chunk-FQPKOAIH.module.min.js +2 -0
- package/dist/chunk-chunk-FRGBMTZR.module.min.js +1 -0
- package/dist/chunk-chunk-G75OPF5N.module.min.js +2 -0
- package/dist/chunk-chunk-H5IFO6CU.module.min.js +2 -0
- package/dist/chunk-chunk-HADHLMY5.module.min.js +1 -0
- package/dist/chunk-chunk-HBFA4NN6.module.min.js +1 -0
- package/dist/chunk-chunk-HCNDE26Q.module.min.js +2 -0
- package/dist/chunk-chunk-J5QD4RAM.module.min.js +2 -0
- package/dist/chunk-chunk-JJ4BSUYL.module.min.js +2 -0
- package/dist/chunk-chunk-JRHXQGEV.module.min.js +2 -0
- package/dist/chunk-chunk-L6FFYGYS.module.min.js +1 -0
- package/dist/chunk-chunk-LJDH3WV3.module.min.js +2 -0
- package/dist/chunk-chunk-LSJUXBMF.module.min.js +1 -0
- package/dist/chunk-chunk-N3Q33XCB.module.min.js +2 -0
- package/dist/chunk-chunk-NWIGA3UK.module.min.js +1 -0
- package/dist/chunk-chunk-OG3TTJGJ.module.min.js +2 -0
- package/dist/{chunk-chunk-XEVJDUTH.module.min.js → chunk-chunk-OZK46A5U.module.min.js} +1 -1
- package/dist/chunk-chunk-PMR47KRY.module.min.js +2 -0
- package/dist/chunk-chunk-QQJNG23C.module.min.js +2 -0
- package/dist/chunk-chunk-RGJ6TKAH.module.min.js +2 -0
- package/dist/{chunk-chunk-RA7JCG7D.module.min.js → chunk-chunk-SFLUSZ73.module.min.js} +1 -1
- package/dist/chunk-chunk-SV4XAZ3Q.module.min.js +1 -0
- package/dist/chunk-chunk-TCMHJWFJ.module.min.js +1 -0
- package/dist/chunk-chunk-TSCFL235.module.min.js +1 -0
- package/dist/{chunk-chunk-XP3OHHFX.module.min.js → chunk-chunk-UEZ6SHW5.module.min.js} +1 -1
- package/dist/chunk-chunk-UOQRPGPK.module.min.js +2 -0
- package/dist/chunk-chunk-VUWYT7DY.module.min.js +2 -0
- package/dist/{chunk-chunk-GFTVACTO.module.min.js → chunk-chunk-W5HWGQMD.module.min.js} +1 -1
- package/dist/chunk-chunk-WFHZHWT7.module.min.js +1 -0
- package/dist/chunk-chunk-WGROBM3I.module.min.js +2 -0
- package/dist/chunk-chunk-WSDJFBKX.module.min.js +2 -0
- package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +2 -0
- package/dist/components/ai/SemioticVACPBridge.d.ts +22 -0
- package/dist/components/ai/chartCapabilities.d.ts +4 -3
- package/dist/components/ai/conversationArc.d.ts +2 -176
- package/dist/components/ai/conversationArcTypes.d.ts +202 -0
- package/dist/components/ai/readerGrounding.d.ts +12 -0
- package/dist/components/ai/vacpAdapter.d.ts +13 -0
- package/dist/components/ai/vacpAdapterActions.d.ts +2 -0
- package/dist/components/ai/vacpAdapterModel.d.ts +7 -0
- package/dist/components/ai/vacpAdapterRuntime.d.ts +26 -0
- package/dist/components/ai/vacpAdapterState.d.ts +3 -0
- package/dist/components/ai/vacpAdapterTypes.d.ts +169 -0
- package/dist/components/ai/vacpTypes.d.ts +160 -0
- package/dist/components/charts/index.d.ts +6 -6
- package/dist/components/charts/network/ProcessSankey.d.ts +105 -74
- package/dist/components/charts/network/processSankey/accessors.d.ts +7 -0
- package/dist/components/charts/network/processSankey/algorithm.d.ts +14 -193
- package/dist/components/charts/network/processSankey/axisChrome.d.ts +31 -0
- package/dist/components/charts/network/processSankey/bandPaths.d.ts +45 -0
- package/dist/components/charts/network/processSankey/buildScenes.d.ts +41 -3
- package/dist/components/charts/network/processSankey/fixtures.d.ts +17 -0
- package/dist/components/charts/network/processSankey/frameMargins.d.ts +11 -0
- package/dist/components/charts/network/processSankey/groupBonding.d.ts +13 -0
- package/dist/components/charts/network/processSankey/inventoryAtTime.d.ts +41 -0
- package/dist/components/charts/network/processSankey/labelPlacement.d.ts +34 -0
- package/dist/components/charts/network/processSankey/layoutGeometry.d.ts +47 -0
- package/dist/components/charts/network/processSankey/layoutOrchestrator.d.ts +44 -0
- package/dist/components/charts/network/processSankey/layoutQualityProduct.d.ts +27 -0
- package/dist/components/charts/network/processSankey/massSimulation.d.ts +16 -0
- package/dist/components/charts/network/processSankey/ordering.d.ts +55 -0
- package/dist/components/charts/network/processSankey/orderingBond.d.ts +33 -0
- package/dist/components/charts/network/processSankey/orientation.d.ts +5 -0
- package/dist/components/charts/network/processSankey/packing.d.ts +8 -0
- package/dist/components/charts/network/processSankey/packingCache.d.ts +23 -0
- package/dist/components/charts/network/processSankey/processSankeyLayoutAsync.d.ts +27 -0
- package/dist/components/charts/network/processSankey/processSankeyLayoutWorkerClient.d.ts +72 -0
- package/dist/components/charts/network/processSankey/processSankeyTooltip.d.ts +26 -0
- package/dist/components/charts/network/processSankey/processSankeyTypes.d.ts +163 -0
- package/dist/components/charts/network/processSankey/ribbonInputs.d.ts +26 -2
- package/dist/components/charts/network/processSankey/ribbonRunway.d.ts +45 -0
- package/dist/components/charts/network/processSankey/streamingLayout.d.ts +23 -0
- package/dist/components/charts/network/processSankey/time.d.ts +11 -0
- package/dist/components/charts/network/processSankey/useProcessSankeyPush.d.ts +29 -0
- package/dist/components/charts/network/processSankey/useProcessSankeyScenes.d.ts +26 -0
- package/dist/components/charts/network/processSankey/validation.d.ts +33 -0
- package/dist/components/charts/physics/ChainReactionChart.capability.d.ts +9 -0
- package/dist/components/charts/physics/ChainReactionChart.d.ts +29 -0
- package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
- package/dist/components/charts/physics/EventDropChart.d.ts +7 -2
- package/dist/components/charts/physics/GaltonBoardChart.d.ts +1 -1
- package/dist/components/charts/physics/{PhysicsPileChart.capability.d.ts → PacketFlowChart.capability.d.ts} +1 -1
- package/dist/components/charts/physics/{PhysicalFlowChart.d.ts → PacketFlowChart.d.ts} +22 -6
- package/dist/components/charts/physics/PhysicsCustomChart.d.ts +1 -1
- package/dist/components/charts/physics/ProcessFlowChart.d.ts +7 -4
- package/dist/components/charts/physics/{PhysicalFlowChart.capability.d.ts → UnitPileChart.capability.d.ts} +1 -1
- package/dist/components/charts/physics/{PhysicsPileChart.d.ts → UnitPileChart.d.ts} +19 -6
- package/dist/components/charts/physics/crucibleChartProps.d.ts +1 -1
- package/dist/components/charts/physics/crucibleChartUtils.d.ts +9 -0
- package/dist/components/charts/physics/gauntletChartProps.d.ts +6 -1
- package/dist/components/charts/physics/gauntletTerminal.d.ts +61 -0
- package/dist/components/charts/physics/packetFlowSemantics.d.ts +6 -0
- package/dist/components/charts/physics/physicsHocUtils.d.ts +45 -2
- package/dist/components/charts/shared/auditAccessibilityStyles.d.ts +9 -0
- package/dist/components/charts/shared/chartFamilySets.d.ts +1 -0
- package/dist/components/charts/shared/formatUtils.d.ts +12 -1
- package/dist/components/charts/shared/hatchFill.d.ts +2 -0
- package/dist/components/charts/shared/hooks.d.ts +1 -1
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- package/dist/components/charts/shared/leastSquaresRegression.d.ts +31 -0
- package/dist/components/charts/shared/styleRules.d.ts +5 -1
- package/dist/components/charts/shared/useChartLegend.d.ts +14 -1
- package/dist/components/charts/shared/useChartSetup.d.ts +8 -1
- package/dist/components/charts/shared/validateProps.d.ts +2 -2
- package/dist/components/charts/shared/withChartWrapper.d.ts +0 -6
- package/dist/components/data/numericFieldProfiler.d.ts +2 -0
- package/dist/components/data/portability/capabilityBinding.d.ts +41 -0
- package/dist/components/data/portability/index.d.ts +2 -0
- package/dist/components/legendLayout.d.ts +56 -0
- package/dist/components/recipes/geographicDotGrid.d.ts +82 -0
- package/dist/components/recipes/geographicGrid.d.ts +100 -0
- package/dist/components/recipes/layout1d.d.ts +68 -0
- package/dist/components/recipes/physics.d.ts +2 -0
- package/dist/components/recipes/physicsStageGeography.d.ts +137 -0
- package/dist/components/semiotic-ai.d.ts +4 -3
- package/dist/components/semiotic-experimental-vacp.d.ts +11 -0
- package/dist/components/semiotic-experimental.d.ts +6 -3
- package/dist/components/semiotic-geo.d.ts +4 -0
- package/dist/components/semiotic-network.d.ts +2 -2
- package/dist/components/semiotic-physics.d.ts +9 -6
- package/dist/components/semiotic-recipes-core.d.ts +8 -1
- package/dist/components/semiotic.d.ts +2 -0
- package/dist/components/server/renderEvidence.d.ts +1 -1
- package/dist/components/server/renderToStaticSVG.d.ts +2 -1
- package/dist/components/server/serverChartConfigHeatmap.d.ts +6 -0
- package/dist/components/server/serverChartConfigNetworkStyles.d.ts +12 -0
- package/dist/components/server/serverChartConfigShared.d.ts +16 -0
- package/dist/components/server/serverChartConfigs.d.ts +2 -2
- package/dist/components/server/serverChartConfigsPhysics.d.ts +2 -2
- package/dist/components/server/serverChartConfigsXY.d.ts +0 -1
- package/dist/components/server/staticLegend.d.ts +6 -0
- package/dist/components/server/staticSVGChrome.d.ts +12 -3
- package/dist/components/server/staticValue.d.ts +8 -0
- package/dist/components/store/createStore.d.ts +2 -0
- package/dist/components/stream/OrdinalPipelineStore.d.ts +3 -0
- package/dist/components/stream/PipelineStore.d.ts +5 -0
- package/dist/components/stream/accessorUtils.d.ts +21 -0
- package/dist/components/stream/frameKeyboardNavigation.d.ts +3 -2
- package/dist/components/stream/geoPipelineConfig.d.ts +10 -0
- package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +3 -8
- package/dist/components/stream/layouts/index.d.ts +1 -1
- package/dist/components/stream/legendRenderer.d.ts +8 -0
- package/dist/components/stream/moduleWorkerSession.d.ts +67 -0
- package/dist/components/stream/networkTypes.d.ts +2 -0
- package/dist/components/stream/ordinalSceneBuilders/sceneBuilderMap.d.ts +2 -1
- package/dist/components/stream/physics/PhysicsEvidence.d.ts +37 -0
- package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
- package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +9 -0
- package/dist/components/stream/physics/PhysicsSettledScene.d.ts +5 -0
- package/dist/components/stream/physics/physicsFramePipelineConfig.d.ts +19 -0
- package/dist/components/stream/physics/physicsPipelineSettle.d.ts +52 -0
- package/dist/components/stream/physics/physicsRegionRuntime.d.ts +23 -0
- package/dist/components/stream/pipelineIntroCancellation.d.ts +6 -0
- package/dist/components/stream/pipelineTransitions.d.ts +15 -1
- package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +16 -4
- package/dist/components/stream/renderers/symbolCanvasRenderer.d.ts +4 -0
- package/dist/components/stream/symbolPath.d.ts +8 -0
- package/dist/components/stream/types.d.ts +4 -0
- package/dist/components/stream/useCanvasFrameHost.d.ts +6 -0
- package/dist/components/stream/useSemanticFrameInteractions.d.ts +12 -3
- package/dist/components/stream/xyFrameAxisTypes.d.ts +4 -0
- package/dist/components/types/legendTypes.d.ts +17 -1
- package/dist/controls.min.js +1 -1
- package/dist/controls.module.min.js +1 -1
- package/dist/forceLayoutWorker.js +1 -1
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/physicsWorker.js +1 -1
- package/dist/processSankeyLayoutWorker.js +1 -0
- package/dist/realtime.min.js +1 -1
- package/dist/realtime.module.min.js +1 -1
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai.d.ts +4 -3
- package/dist/semiotic-ai.min.js +1 -1
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-experimental-vacp.d.ts +11 -0
- package/dist/semiotic-experimental-vacp.min.js +1 -0
- package/dist/semiotic-experimental-vacp.module.min.js +1 -0
- package/dist/semiotic-experimental.d.ts +6 -3
- package/dist/semiotic-experimental.min.js +2 -1
- package/dist/semiotic-experimental.module.min.js +2 -1
- package/dist/semiotic-geo.d.ts +4 -0
- package/dist/semiotic-network.d.ts +2 -2
- package/dist/semiotic-physics.d.ts +9 -6
- package/dist/semiotic-realtime-core.min.js +1 -1
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-recipes-core.d.ts +8 -1
- package/dist/semiotic-recipes-core.min.js +1 -1
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-recipes.min.js +1 -1
- package/dist/semiotic-recipes.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-themes-core.module.min.js +1 -1
- package/dist/semiotic-themes-react.module.min.js +1 -1
- package/dist/semiotic-themes.module.min.js +1 -1
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic-utils-react.module.min.js +1 -1
- package/dist/semiotic-utils.min.js +1 -1
- package/dist/semiotic-utils.module.min.js +1 -1
- package/dist/semiotic-value.min.js +1 -1
- package/dist/semiotic-value.module.min.js +1 -1
- package/dist/semiotic.d.ts +2 -0
- package/dist/semiotic.min.js +1 -1
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +1 -1
- package/dist/server.module.min.js +1 -1
- package/dist/xy.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +21 -4
- package/spec/README.md +94 -2
- package/spec/bindings/README.md +14 -3
- package/spec/v0.1/examples/annotation-provenance-reviewed-revision.json +27 -0
- package/spec/v0.1/examples/annotation-provenance-watcher-threshold.json +21 -0
- package/spec/v0.1/examples/audience-profile-executive-review.json +24 -0
- package/spec/v0.1/examples/audience-profile-incident-operators.json +42 -0
- package/spec/v0.1/examples/chart-capability-bar-comparison.json +48 -0
- package/spec/v0.1/examples/chart-capability-service-flow.json +54 -0
- package/dist/chunk-chunk-2CHN2TA3.module.min.js +0 -1
- package/dist/chunk-chunk-3NGIKFD6.module.min.js +0 -1
- package/dist/chunk-chunk-3SHB24AG.module.min.js +0 -1
- package/dist/chunk-chunk-4MMOOYTX.module.min.js +0 -2
- package/dist/chunk-chunk-5RKXZQ2P.module.min.js +0 -1
- package/dist/chunk-chunk-75OTQSXS.module.min.js +0 -1
- package/dist/chunk-chunk-7ALTGHK6.module.min.js +0 -1
- package/dist/chunk-chunk-A5GRQUOF.module.min.js +0 -1
- package/dist/chunk-chunk-AAF5LZAU.module.min.js +0 -2
- package/dist/chunk-chunk-ARZGA4LJ.module.min.js +0 -2
- package/dist/chunk-chunk-C4YA6TDR.module.min.js +0 -1
- package/dist/chunk-chunk-CAFLML4L.module.min.js +0 -2
- package/dist/chunk-chunk-CO5KQMGH.module.min.js +0 -1
- package/dist/chunk-chunk-DSNGDNJY.module.min.js +0 -1
- package/dist/chunk-chunk-FHBN7OEB.module.min.js +0 -2
- package/dist/chunk-chunk-GMQ5AYTD.module.min.js +0 -1
- package/dist/chunk-chunk-IP2UE74X.module.min.js +0 -1
- package/dist/chunk-chunk-ITDWLZXV.module.min.js +0 -2
- package/dist/chunk-chunk-JCG72SGW.module.min.js +0 -2
- package/dist/chunk-chunk-LPSPATPC.module.min.js +0 -1
- package/dist/chunk-chunk-OM6NWS4H.module.min.js +0 -2
- package/dist/chunk-chunk-PRDGLMJT.module.min.js +0 -2
- package/dist/chunk-chunk-PX5YQGDP.module.min.js +0 -2
- package/dist/chunk-chunk-Q2BS46W2.module.min.js +0 -2
- package/dist/chunk-chunk-QSQVBIJA.module.min.js +0 -1
- package/dist/chunk-chunk-RCF52Z42.module.min.js +0 -2
- package/dist/chunk-chunk-RNUHEXZA.module.min.js +0 -2
- package/dist/chunk-chunk-ROZWKEUG.module.min.js +0 -1
- package/dist/chunk-chunk-SMVD3EQJ.module.min.js +0 -2
- package/dist/chunk-chunk-T2FKJD4O.module.min.js +0 -2
- package/dist/chunk-chunk-UDREYOLV.module.min.js +0 -1
- package/dist/chunk-chunk-VOWE3SAP.module.min.js +0 -2
- package/dist/chunk-chunk-VQPNBUSW.module.min.js +0 -2
- package/dist/chunk-chunk-WAWCIHFJ.module.min.js +0 -1
- package/dist/chunk-chunk-WCX6U47H.module.min.js +0 -2
- package/dist/chunk-chunk-WYARAXHR.module.min.js +0 -2
- package/dist/chunk-chunk-XV3KGYTR.module.min.js +0 -2
- package/dist/chunk-chunk-YC2IVEPX.module.min.js +0 -1
- package/dist/chunk-chunk-ZOAQDIJO.module.min.js +0 -1
- package/dist/chunk-chunk-ZXIXAPRE.module.min.js +0 -2
- package/dist/chunk-statisticalOverlays-6MVAK5RW.module.min.js +0 -2
- package/dist/components/stream/renderers/networkSymbolRenderer.d.ts +0 -2
package/ai/dist/mcp-server.js
CHANGED
|
@@ -3645,7 +3645,12 @@ var require_fast_uri = __commonJS({
|
|
|
3645
3645
|
}
|
|
3646
3646
|
function resolve2(baseURI, relativeURI, options) {
|
|
3647
3647
|
const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
|
|
3648
|
-
const
|
|
3648
|
+
const { parsed: baseParsed, malformedAuthorityOrPort: baseMalformed } = parseWithStatus(baseURI, schemelessOptions);
|
|
3649
|
+
const { parsed: relativeParsed, malformedAuthorityOrPort: relativeMalformed } = parseWithStatus(relativeURI, schemelessOptions);
|
|
3650
|
+
if (baseMalformed || relativeMalformed) {
|
|
3651
|
+
throw new Error(baseParsed.error || relativeParsed.error || "URI is malformed.");
|
|
3652
|
+
}
|
|
3653
|
+
const resolved = resolveComponent(baseParsed, relativeParsed, schemelessOptions, true);
|
|
3649
3654
|
schemelessOptions.skipEscape = true;
|
|
3650
3655
|
return serialize(resolved, schemelessOptions);
|
|
3651
3656
|
}
|
|
@@ -3770,6 +3775,8 @@ var require_fast_uri = __commonJS({
|
|
|
3770
3775
|
return uriTokens.join("");
|
|
3771
3776
|
}
|
|
3772
3777
|
var URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:?]*)(?::(\d*))?))?([^#?]*)(?:\?([^#]*))?(?:#((?:.|[\n\r])*))?/u;
|
|
3778
|
+
var AUTHORITY_PREFIX = /^(?:[^#/:?]+:)?\/\/([^/?#]*)/;
|
|
3779
|
+
var AUTHORITY_INTRODUCER_REGION = /^(?:[^#/:?]+:)?([/\\\t\n\r]*)/;
|
|
3773
3780
|
function getParseError(parsed, matches) {
|
|
3774
3781
|
if (matches[2] !== void 0 && parsed.path && parsed.path[0] !== "/") {
|
|
3775
3782
|
return 'URI path must start with "/" when authority is present.';
|
|
@@ -3799,6 +3806,25 @@ var require_fast_uri = __commonJS({
|
|
|
3799
3806
|
uri = "//" + uri;
|
|
3800
3807
|
}
|
|
3801
3808
|
}
|
|
3809
|
+
const authorityMatch = uri.match(AUTHORITY_PREFIX);
|
|
3810
|
+
if (authorityMatch !== null && authorityMatch[1].indexOf("\\") !== -1) {
|
|
3811
|
+
parsed.error = "URI authority must not contain a literal backslash.";
|
|
3812
|
+
malformedAuthorityOrPort = true;
|
|
3813
|
+
}
|
|
3814
|
+
const introducerMatch = uri.match(AUTHORITY_INTRODUCER_REGION);
|
|
3815
|
+
if (introducerMatch !== null) {
|
|
3816
|
+
const region = introducerMatch[1];
|
|
3817
|
+
const normalizedRegion = region.replace(/[\t\n\r]/g, "");
|
|
3818
|
+
if (normalizedRegion.length >= 2) {
|
|
3819
|
+
if (normalizedRegion.slice(0, 2) !== "//") {
|
|
3820
|
+
parsed.error = parsed.error || "URI authority must not contain a literal backslash.";
|
|
3821
|
+
malformedAuthorityOrPort = true;
|
|
3822
|
+
} else if (region.length !== normalizedRegion.length) {
|
|
3823
|
+
parsed.error = parsed.error || "URI authority introducer must not contain whitespace.";
|
|
3824
|
+
malformedAuthorityOrPort = true;
|
|
3825
|
+
}
|
|
3826
|
+
}
|
|
3827
|
+
}
|
|
3802
3828
|
const matches = uri.match(URI_PARSE);
|
|
3803
3829
|
if (matches) {
|
|
3804
3830
|
parsed.scheme = matches[1];
|
|
@@ -3842,7 +3868,7 @@ var require_fast_uri = __commonJS({
|
|
|
3842
3868
|
if (!options.unicodeSupport && (!schemeHandler || !schemeHandler.unicodeSupport)) {
|
|
3843
3869
|
if (parsed.host && (options.domainHost || schemeHandler && schemeHandler.domainHost) && isIP === false && nonSimpleDomain(parsed.host)) {
|
|
3844
3870
|
try {
|
|
3845
|
-
parsed.host = URL
|
|
3871
|
+
parsed.host = new URL("http://" + parsed.host).hostname;
|
|
3846
3872
|
} catch (e) {
|
|
3847
3873
|
parsed.error = parsed.error || "Host's domain name can not be converted to ASCII: " + e;
|
|
3848
3874
|
}
|
|
@@ -6956,12 +6982,13 @@ var require_componentMetadata = __commonJS({
|
|
|
6956
6982
|
physics: [
|
|
6957
6983
|
"GaltonBoardChart",
|
|
6958
6984
|
"EventDropChart",
|
|
6959
|
-
"
|
|
6985
|
+
"UnitPileChart",
|
|
6960
6986
|
"CollisionSwarmChart",
|
|
6961
|
-
"
|
|
6987
|
+
"PacketFlowChart",
|
|
6962
6988
|
"ProcessFlowChart",
|
|
6963
6989
|
"GauntletChart",
|
|
6964
|
-
"CrucibleChart"
|
|
6990
|
+
"CrucibleChart",
|
|
6991
|
+
"ChainReactionChart"
|
|
6965
6992
|
],
|
|
6966
6993
|
value: [
|
|
6967
6994
|
"BigNumber"
|
|
@@ -6991,12 +7018,11 @@ var require_componentMetadata = __commonJS({
|
|
|
6991
7018
|
const name = typeof entryOrName === "string" ? entryOrName : entryOrName.name;
|
|
6992
7019
|
const category = categoryForComponent(name);
|
|
6993
7020
|
const isPushOnly = category === "realtime" && name.startsWith("Realtime");
|
|
6994
|
-
const isValueCategory = category === "value";
|
|
6995
7021
|
return {
|
|
6996
7022
|
name,
|
|
6997
7023
|
category,
|
|
6998
7024
|
importPath: importPathForCategory(category),
|
|
6999
|
-
renderable: !isPushOnly
|
|
7025
|
+
renderable: !isPushOnly,
|
|
7000
7026
|
description: typeof entryOrName === "string" ? void 0 : entryOrName.description
|
|
7001
7027
|
};
|
|
7002
7028
|
}
|
|
@@ -7519,7 +7545,7 @@ var require_behaviorContracts = __commonJS({
|
|
|
7519
7545
|
required: ["value"],
|
|
7520
7546
|
staticRequired: ["value"],
|
|
7521
7547
|
pushRequired: [],
|
|
7522
|
-
summary: "GaugeChart is value-only. thresholds,
|
|
7548
|
+
summary: "GaugeChart is value-only. Its thresholds use { value, color, label? }; BigNumber thresholds use the distinct { at, level, color?, label? } vocabulary."
|
|
7523
7549
|
},
|
|
7524
7550
|
{
|
|
7525
7551
|
component: "ForceDirectedGraph",
|
|
@@ -7557,7 +7583,16 @@ var require_behaviorContracts = __commonJS({
|
|
|
7557
7583
|
"SankeyDiagram",
|
|
7558
7584
|
"ChordDiagram",
|
|
7559
7585
|
"ProportionalSymbolMap",
|
|
7560
|
-
"DistanceCartogram"
|
|
7586
|
+
"DistanceCartogram",
|
|
7587
|
+
"GaltonBoardChart",
|
|
7588
|
+
"EventDropChart",
|
|
7589
|
+
"UnitPileChart",
|
|
7590
|
+
"CollisionSwarmChart",
|
|
7591
|
+
"PacketFlowChart",
|
|
7592
|
+
"ProcessFlowChart",
|
|
7593
|
+
"GauntletChart",
|
|
7594
|
+
"CrucibleChart",
|
|
7595
|
+
"ChainReactionChart"
|
|
7561
7596
|
];
|
|
7562
7597
|
var STATIC_DATA_COMPONENTS = loadStaticDataComponentsFromSchema();
|
|
7563
7598
|
var BEHAVIOR_CONTRACTS2 = [
|
|
@@ -7615,6 +7650,18 @@ var require_behaviorContracts = __commonJS({
|
|
|
7615
7650
|
summary: "HOC push mode is selected by omitting the data prop entirely. Passing data={[]} is static empty data and can clear/reinitialize the frame on render.",
|
|
7616
7651
|
agentAction: "For live charts, create a ref, omit data, then call ref.current.push() or pushMany(). For static renderChart/MCP snapshots, provide data because renderChart cannot push later."
|
|
7617
7652
|
},
|
|
7653
|
+
{
|
|
7654
|
+
id: "streaming.serialized-proposal-snapshot",
|
|
7655
|
+
category: "streaming",
|
|
7656
|
+
title: "Serialized proposals keep the initial snapshot",
|
|
7657
|
+
severity: "warning",
|
|
7658
|
+
appliesTo: {
|
|
7659
|
+
components: PUSH_MODE_COMPONENTS
|
|
7660
|
+
},
|
|
7661
|
+
summary: "A JSON component/props proposal for MCP, SSR, or evaluation is a static snapshot even when the request mentions future pushes. Keep the supplied initial rows in the component's real data prop and do not invent pushRows, pushRequirement, ref, or method props.",
|
|
7662
|
+
agentAction: "Return renderable initial props in JSON. If the requested deliverable is React push code, separately omit the controlled data prop in JSX, attach a ref, and call the documented imperative method from an effect or event handler.",
|
|
7663
|
+
example: 'JSON snapshot: { "component": "LineChart", "props": { "data": [{"week":1,"users":120}], "xAccessor":"week", "yAccessor":"users" } }. React push code instead omits data and calls ref.current?.push(row).'
|
|
7664
|
+
},
|
|
7618
7665
|
{
|
|
7619
7666
|
id: "streaming.ref-mutations-require-id-accessors",
|
|
7620
7667
|
category: "streaming",
|
|
@@ -7634,6 +7681,66 @@ var require_behaviorContracts = __commonJS({
|
|
|
7634
7681
|
appliesTo: {},
|
|
7635
7682
|
summary: "MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot. Browser-only realtime components and future ref pushes are not renderable through that path.",
|
|
7636
7683
|
agentAction: "Use renderChart only with renderable HOC components and complete static data. For live behavior, return React code with a ref and do not promise MCP-rendered output."
|
|
7684
|
+
},
|
|
7685
|
+
{
|
|
7686
|
+
id: "serialization.formatters-are-react-callbacks",
|
|
7687
|
+
category: "serialization",
|
|
7688
|
+
title: "Axis formatters are React callbacks",
|
|
7689
|
+
severity: "error",
|
|
7690
|
+
appliesTo: {
|
|
7691
|
+
propsAny: ["xFormat", "yFormat", "categoryFormat", "valueFormat"]
|
|
7692
|
+
},
|
|
7693
|
+
summary: "xFormat, yFormat, categoryFormat, and valueFormat are callback props, not d3 format strings or axis-title strings. They are intentionally absent from JSON/MCP schemas and string values fail validation.",
|
|
7694
|
+
agentAction: "In serialized props, omit formatter callbacks and use xLabel, yLabel, categoryLabel, or valueLabel for axis titles. In React JSX, pass a function such as xFormat={value => formatAxis(value)}.",
|
|
7695
|
+
example: 'JSON: { "xLabel": "Payload (KB)", "yLabel": "Response time (ms)" }. React-only: xFormat={value => formatNumber(value, { maximumFractionDigits: 0 })}.'
|
|
7696
|
+
},
|
|
7697
|
+
{
|
|
7698
|
+
id: "value.bignumber-wire-contract",
|
|
7699
|
+
category: "value",
|
|
7700
|
+
title: "Value components do not inherit chart-HOC props",
|
|
7701
|
+
severity: "error",
|
|
7702
|
+
appliesTo: {
|
|
7703
|
+
components: ["BigNumber"]
|
|
7704
|
+
},
|
|
7705
|
+
summary: "BigNumber is a value component, not a chart HOC, so it does not inherit the common chart-HOC prop list. It uses label as its visible heading and supports description and summary; title and accessibleTable are invalid. Its percent format expects a ratio such as 0.97 and renders it as 97%.",
|
|
7706
|
+
agentAction: 'Validate BigNumber against its own prop schema and remove inherited chart-HOC props such as title and accessibleTable before returning a proposal. Use label, description, and summary for text. For a 97-of-100 KPI, either pass value={0.97} with format="percent" or pass value={97} with format="number" and suffix="%"; do not combine value={97} with format="percent".',
|
|
7707
|
+
example: '{ "component": "BigNumber", "props": { "value": 97, "label": "SLA attainment", "format": "number", "suffix": "%", "target": { "value": 99, "label": "target", "format": "number" } } }'
|
|
7708
|
+
},
|
|
7709
|
+
{
|
|
7710
|
+
id: "geo.proportional-symbol-wire-shape",
|
|
7711
|
+
category: "geo",
|
|
7712
|
+
title: "Proportional symbol maps use geographic props",
|
|
7713
|
+
severity: "error",
|
|
7714
|
+
appliesTo: {
|
|
7715
|
+
components: ["ProportionalSymbolMap"]
|
|
7716
|
+
},
|
|
7717
|
+
summary: "ProportionalSymbolMap reads point rows from points, longitude from xAccessor (default lon), latitude from yAccessor (default lat), and radius from sizeBy. sizeRange is the two-number pixel-radius range.",
|
|
7718
|
+
agentAction: "Use points, xAccessor, yAccessor, and sizeBy. Do not rename points to data or sizeBy to valueAccessor merely because the map renders circles.",
|
|
7719
|
+
example: '{ "points": [{"city":"A","longitude":-122.4,"latitude":37.8,"incidents":18}], "xAccessor":"longitude", "yAccessor":"latitude", "sizeBy":"incidents", "sizeRange":[5,40] }'
|
|
7720
|
+
},
|
|
7721
|
+
{
|
|
7722
|
+
id: "physics.sample-and-mechanical-inputs",
|
|
7723
|
+
category: "physics",
|
|
7724
|
+
title: "Physics charts separate chart mode from simulation input",
|
|
7725
|
+
severity: "warning",
|
|
7726
|
+
appliesTo: {
|
|
7727
|
+
components: ["GaltonBoardChart", "UnitPileChart", "CollisionSwarmChart"]
|
|
7728
|
+
},
|
|
7729
|
+
summary: `Sample simulations use data plus the chart's accessors. Seeded no-data demonstrations use simulationMode="mechanical" (legacy mode="mechanical" remains accepted); mode otherwise carries chart display modes such as primary or sparkline.`,
|
|
7730
|
+
agentAction: "For observed Galton values pass data + valueAccessor. For unit piles pass data + categoryAccessor + valueAccessor. Use seed for reproducibility, bins for Galton columns, and unitValue for the amount represented by one UnitPile body.",
|
|
7731
|
+
example: '{ "component": "GaltonBoardChart", "props": { "data": [{"id":"a","value":1}], "valueAccessor":"value", "bins":4, "seed":42 } }'
|
|
7732
|
+
},
|
|
7733
|
+
{
|
|
7734
|
+
id: "physics.push-uses-source-records",
|
|
7735
|
+
category: "physics",
|
|
7736
|
+
title: "Physics push methods ingest source records",
|
|
7737
|
+
severity: "error",
|
|
7738
|
+
appliesTo: {
|
|
7739
|
+
components: ["GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart"]
|
|
7740
|
+
},
|
|
7741
|
+
summary: "Physics HOC refs push source records through the chart's accessors. pushRows and dataIdAccessor are not component props; stable source id fields are retained on spawned bodies without an invented accessor.",
|
|
7742
|
+
agentAction: "For React live code, call ref.current?.push(row) or pushMany(rows). For serialized snapshots, append the rows to data. Keep category/value/time accessors, but omit pushRows and dataIdAccessor.",
|
|
7743
|
+
example: 'ref.current?.push({ id: "c", team: "Blue", value: 2 }); <UnitPileChart ref={ref} categoryAccessor="team" valueAccessor="value" unitValue={1} />'
|
|
7637
7744
|
}
|
|
7638
7745
|
];
|
|
7639
7746
|
function hasOwn(value, key) {
|
|
@@ -7687,6 +7794,7 @@ var require_behaviorContracts = __commonJS({
|
|
|
7687
7794
|
lines.push(` ${formatRequiredCombination(combo)}`);
|
|
7688
7795
|
}
|
|
7689
7796
|
}
|
|
7797
|
+
if (contract.example) lines.push(` Example: ${contract.example}`);
|
|
7690
7798
|
lines.push(` Action: ${contract.agentAction}`);
|
|
7691
7799
|
}
|
|
7692
7800
|
return lines.join("\n");
|
|
@@ -7709,6 +7817,9 @@ var require_behaviorContracts = __commonJS({
|
|
|
7709
7817
|
const combos = contract.combinations.map(formatRequiredCombination).join(" ");
|
|
7710
7818
|
lines.push(` Required combinations: ${combos}`);
|
|
7711
7819
|
}
|
|
7820
|
+
if (!compact && contract.example) {
|
|
7821
|
+
lines.push(` Example: \`${contract.example}\``);
|
|
7822
|
+
}
|
|
7712
7823
|
}
|
|
7713
7824
|
lines.push("", DOC_MARKER_END);
|
|
7714
7825
|
return lines.join("\n");
|
|
@@ -33059,12 +33170,14 @@ var COMPONENT_REGISTRY = {
|
|
|
33059
33170
|
DistanceCartogram: { component: import_geo.DistanceCartogram, category: "geo" },
|
|
33060
33171
|
GaltonBoardChart: { component: import_ai.GaltonBoardChart, category: "physics" },
|
|
33061
33172
|
EventDropChart: { component: import_ai.EventDropChart, category: "physics" },
|
|
33062
|
-
|
|
33173
|
+
UnitPileChart: { component: import_ai.UnitPileChart, category: "physics" },
|
|
33063
33174
|
CollisionSwarmChart: { component: import_ai.CollisionSwarmChart, category: "physics" },
|
|
33064
|
-
|
|
33175
|
+
PacketFlowChart: { component: import_ai.PacketFlowChart, category: "physics" },
|
|
33065
33176
|
ProcessFlowChart: { component: import_ai.ProcessFlowChart, category: "physics" },
|
|
33066
33177
|
GauntletChart: { component: import_ai.GauntletChart, category: "physics" },
|
|
33067
|
-
CrucibleChart: { component: import_ai.CrucibleChart, category: "physics" }
|
|
33178
|
+
CrucibleChart: { component: import_ai.CrucibleChart, category: "physics" },
|
|
33179
|
+
ChainReactionChart: { component: import_ai.ChainReactionChart, category: "physics" },
|
|
33180
|
+
BigNumber: { component: import_ai.BigNumber, category: "value" }
|
|
33068
33181
|
};
|
|
33069
33182
|
|
|
33070
33183
|
// ai/renderHOCToSVG.tsx
|
package/ai/examples.md
CHANGED
|
@@ -57,6 +57,34 @@ const data = [
|
|
|
57
57
|
|
|
58
58
|
Key props: `lineBy` groups flat array into separate lines, `colorBy` colors them
|
|
59
59
|
|
|
60
|
+
### LineChart (dynamic value accessor)
|
|
61
|
+
|
|
62
|
+
When each row identifies which numeric field to plot, use an accessor function
|
|
63
|
+
instead of forcing the value through a single field name. This is especially
|
|
64
|
+
useful for multi-line data with a different metric per series.
|
|
65
|
+
|
|
66
|
+
```jsx
|
|
67
|
+
import { LineChart } from "semiotic/ai"
|
|
68
|
+
|
|
69
|
+
const data = [
|
|
70
|
+
{ timestamp: 1, metricLabel: "valueA", valueA: 12, valueB: 60 },
|
|
71
|
+
{ timestamp: 2, metricLabel: "valueA", valueA: 18, valueB: 55 },
|
|
72
|
+
{ timestamp: 1, metricLabel: "valueB", valueA: 12, valueB: 60 },
|
|
73
|
+
{ timestamp: 2, metricLabel: "valueB", valueA: 18, valueB: 55 }
|
|
74
|
+
]
|
|
75
|
+
|
|
76
|
+
<LineChart
|
|
77
|
+
data={data}
|
|
78
|
+
xAccessor="timestamp"
|
|
79
|
+
yAccessor={(d) => d[d.metricLabel]}
|
|
80
|
+
lineBy="metricLabel"
|
|
81
|
+
colorBy="metricLabel"
|
|
82
|
+
/>
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Key props: accessors accept a field-name string or a function. Prefer a string
|
|
86
|
+
for a direct lookup; use a function for a computed or dynamic value.
|
|
87
|
+
|
|
60
88
|
### Scatterplot
|
|
61
89
|
|
|
62
90
|
```jsx
|
|
@@ -826,6 +854,33 @@ Key props: **`edges`** (required), shows bidirectional relationships in a circle
|
|
|
826
854
|
|
|
827
855
|
## Realtime — Push API via Ref
|
|
828
856
|
|
|
857
|
+
### Serialized snapshot versus React push code
|
|
858
|
+
|
|
859
|
+
When an MCP, SSR, or evaluation request asks for component/props JSON and also
|
|
860
|
+
mentions future pushes, keep the supplied initial rows in the serialized
|
|
861
|
+
snapshot. `pushRows`, `pushRequirement`, `ref`, and `method` are orchestration
|
|
862
|
+
instructions, not chart props.
|
|
863
|
+
|
|
864
|
+
```json
|
|
865
|
+
{
|
|
866
|
+
"component": "LineChart",
|
|
867
|
+
"props": {
|
|
868
|
+
"data": [
|
|
869
|
+
{ "week": 1, "users": 120 },
|
|
870
|
+
{ "week": 2, "users": 138 }
|
|
871
|
+
],
|
|
872
|
+
"xAccessor": "week",
|
|
873
|
+
"yAccessor": "users",
|
|
874
|
+
"xLabel": "Week",
|
|
875
|
+
"yLabel": "Active users"
|
|
876
|
+
}
|
|
877
|
+
}
|
|
878
|
+
```
|
|
879
|
+
|
|
880
|
+
React push code has a different lifecycle: omit `data`, attach a ref, and push
|
|
881
|
+
the initial or newly arrived rows from an effect. Formatter callbacks such as
|
|
882
|
+
`xFormat` are JSX-only; serialized axis titles belong in `xLabel` and `yLabel`.
|
|
883
|
+
|
|
829
884
|
### RealtimeLineChart
|
|
830
885
|
|
|
831
886
|
```jsx
|
|
@@ -1306,6 +1361,40 @@ Key APIs: `WordTrailsWordInfo` gives `word`, `column`, `weight`, and `segment` p
|
|
|
1306
1361
|
|
|
1307
1362
|
---
|
|
1308
1363
|
|
|
1364
|
+
## Geographic Charts
|
|
1365
|
+
|
|
1366
|
+
### ProportionalSymbolMap
|
|
1367
|
+
|
|
1368
|
+
```jsx
|
|
1369
|
+
import { ProportionalSymbolMap } from "semiotic/geo"
|
|
1370
|
+
|
|
1371
|
+
const incidents = [
|
|
1372
|
+
{ id: "a", city: "A", longitude: -122.4, latitude: 37.8, incidents: 18 },
|
|
1373
|
+
{ id: "b", city: "B", longitude: -74.0, latitude: 40.7, incidents: 31 },
|
|
1374
|
+
{ id: "c", city: "C", longitude: -87.6, latitude: 41.9, incidents: 12 },
|
|
1375
|
+
]
|
|
1376
|
+
|
|
1377
|
+
<ProportionalSymbolMap
|
|
1378
|
+
points={incidents}
|
|
1379
|
+
xAccessor="longitude"
|
|
1380
|
+
yAccessor="latitude"
|
|
1381
|
+
sizeBy="incidents"
|
|
1382
|
+
sizeRange={[5, 40]}
|
|
1383
|
+
colorBy="city"
|
|
1384
|
+
showLegend
|
|
1385
|
+
/>
|
|
1386
|
+
```
|
|
1387
|
+
|
|
1388
|
+
The geographic wire vocabulary is deliberate: rows live in `points`,
|
|
1389
|
+
longitude and latitude use `xAccessor` and `yAccessor`, and symbol radius uses
|
|
1390
|
+
`sizeBy`. Do not substitute the generic `data` or `valueAccessor` names.
|
|
1391
|
+
|
|
1392
|
+
For live React code, omit `points` and push source records through the ref:
|
|
1393
|
+
`ref.current?.push({ id, longitude, latitude, incidents })`. For a static JSON
|
|
1394
|
+
snapshot, keep all observed records in `points`.
|
|
1395
|
+
|
|
1396
|
+
---
|
|
1397
|
+
|
|
1309
1398
|
## Physics Charts — Motion With A Settled Projection
|
|
1310
1399
|
|
|
1311
1400
|
### GaltonBoardChart (distribution drop)
|
|
@@ -1352,12 +1441,12 @@ import { EventDropChart } from "semiotic/physics"
|
|
|
1352
1441
|
|
|
1353
1442
|
Key props: `timeAccessor` assigns the event-time window, `arrivalAccessor` controls arrival replay, `windows.size` creates barriers, and `watermark.delay` sends late events to the late path.
|
|
1354
1443
|
|
|
1355
|
-
###
|
|
1444
|
+
### UnitPileChart (unitized category piles)
|
|
1356
1445
|
|
|
1357
1446
|
```jsx
|
|
1358
|
-
import {
|
|
1447
|
+
import { UnitPileChart } from "semiotic/physics"
|
|
1359
1448
|
|
|
1360
|
-
<
|
|
1449
|
+
<UnitPileChart
|
|
1361
1450
|
data={[
|
|
1362
1451
|
{ category: "Orders", value: 18 },
|
|
1363
1452
|
{ category: "Queued", value: 11 },
|
|
@@ -1373,6 +1462,34 @@ import { PhysicsPileChart } from "semiotic/physics"
|
|
|
1373
1462
|
|
|
1374
1463
|
Key props: `unitValue` controls how many simulated bodies appear. Increase it for large values so the settled piles remain readable and the frame budget stays bounded.
|
|
1375
1464
|
|
|
1465
|
+
For a live unit pile, the ref ingests the same source-row shape the static
|
|
1466
|
+
`data` prop uses:
|
|
1467
|
+
|
|
1468
|
+
```jsx
|
|
1469
|
+
import { useEffect, useRef } from "react"
|
|
1470
|
+
import { UnitPileChart } from "semiotic/physics"
|
|
1471
|
+
|
|
1472
|
+
const pileRef = useRef(null)
|
|
1473
|
+
|
|
1474
|
+
useEffect(() => {
|
|
1475
|
+
pileRef.current?.push({ id: "c", team: "Blue", value: 2 })
|
|
1476
|
+
}, [])
|
|
1477
|
+
|
|
1478
|
+
<UnitPileChart
|
|
1479
|
+
ref={pileRef}
|
|
1480
|
+
categoryAccessor="team"
|
|
1481
|
+
valueAccessor="value"
|
|
1482
|
+
unitValue={1}
|
|
1483
|
+
seed={42}
|
|
1484
|
+
title="Queued work by team"
|
|
1485
|
+
/>
|
|
1486
|
+
```
|
|
1487
|
+
|
|
1488
|
+
`pushRows` and `dataIdAccessor` are not physics chart props. Keep an `id` on
|
|
1489
|
+
source records when identity matters; the physics HOC retains it on the spawned
|
|
1490
|
+
bodies. For a static JSON proposal, append the incoming rows to `data` so the
|
|
1491
|
+
snapshot can render immediately.
|
|
1492
|
+
|
|
1376
1493
|
### CollisionSwarmChart (axis-preserving collision layout)
|
|
1377
1494
|
|
|
1378
1495
|
```jsx
|
|
@@ -1397,12 +1514,12 @@ import { CollisionSwarmChart } from "semiotic/physics"
|
|
|
1397
1514
|
Key props: `xAccessor` preserves the quantitative position, `groupAccessor` creates lanes, and collision settings separate overlapping records without losing the axis.
|
|
1398
1515
|
|
|
1399
1516
|
|
|
1400
|
-
###
|
|
1517
|
+
### PacketFlowChart (packet flow over routes)
|
|
1401
1518
|
|
|
1402
1519
|
```jsx
|
|
1403
|
-
import {
|
|
1520
|
+
import { PacketFlowChart } from "semiotic/physics"
|
|
1404
1521
|
|
|
1405
|
-
<
|
|
1522
|
+
<PacketFlowChart
|
|
1406
1523
|
nodes={[
|
|
1407
1524
|
{ id: "Inbound", x: 0.08, y: 0.5 },
|
|
1408
1525
|
{ id: "Queue", x: 0.45, y: 0.32 },
|
|
@@ -1449,6 +1566,36 @@ import { ProcessFlowChart } from "semiotic/physics"
|
|
|
1449
1566
|
|
|
1450
1567
|
Key props: `stages` declare force / capacity / absorb behavior, `groupBy` forms feature sockets that complete when every member is absorbed, and `liveCapacity` installs FIFO queue controllers for capacitated stages. Prefer ProcessFlowChart for many independent work items; use GauntletChart for one compound project degraded by gates.
|
|
1451
1568
|
|
|
1569
|
+
### ChainReactionChart (dependency reach and blockers)
|
|
1570
|
+
|
|
1571
|
+
```jsx
|
|
1572
|
+
import { ChainReactionChart } from "semiotic/physics"
|
|
1573
|
+
|
|
1574
|
+
const releaseTasks = [
|
|
1575
|
+
{ id: "brief", title: "Brief", lane: "Product", dependsOn: [], status: "done", completedAt: 1 },
|
|
1576
|
+
{ id: "privacy", title: "Privacy review", lane: "Product", dependsOn: ["brief"], status: "blocked", blocker: "Legal review" },
|
|
1577
|
+
{ id: "schema", title: "Schema", lane: "Data", dependsOn: ["privacy"], status: "waiting" },
|
|
1578
|
+
{ id: "ingest", title: "Ingest", lane: "Data", dependsOn: ["schema"], status: "waiting" },
|
|
1579
|
+
]
|
|
1580
|
+
|
|
1581
|
+
<ChainReactionChart
|
|
1582
|
+
data={releaseTasks}
|
|
1583
|
+
taskIDAccessor="id"
|
|
1584
|
+
labelAccessor="title"
|
|
1585
|
+
laneAccessor="lane"
|
|
1586
|
+
dependencyAccessor="dependsOn"
|
|
1587
|
+
statusAccessor="status"
|
|
1588
|
+
completionTimeAccessor="completedAt"
|
|
1589
|
+
blockerAccessor="blocker"
|
|
1590
|
+
currentTime={10}
|
|
1591
|
+
mode="snapshot"
|
|
1592
|
+
insight="blocker-amplification"
|
|
1593
|
+
size={[800, 420]}
|
|
1594
|
+
/>
|
|
1595
|
+
```
|
|
1596
|
+
|
|
1597
|
+
Key props: `dependencyAccessor` must name explicit prerequisite ids — the chart never invents edges from a flat table. `statusAccessor` and `completionTimeAccessor` are authored task facts; delivery balls only enact satisfied prerequisites. Use `insight="blocker-amplification"` to expose how many unfinished downstream tasks and lanes each blocker reaches.
|
|
1598
|
+
|
|
1452
1599
|
### GauntletChart (compound project through timed gates)
|
|
1453
1600
|
|
|
1454
1601
|
```jsx
|
|
@@ -1590,7 +1737,7 @@ import { BigNumber } from "semiotic/value"
|
|
|
1590
1737
|
/>
|
|
1591
1738
|
```
|
|
1592
1739
|
|
|
1593
|
-
Key props: `value` (the
|
|
1740
|
+
Key props: `value` (the focal number), `label` (the visible heading), `description` and `summary` (accessible text), `comparison`, `target`, and `thresholds`. BigNumber does not use chart-frame `title` or `accessibleTable` props. Built-in `format` values are `"number"`, `"currency"`, `"percent"`, `"compact"`, and `"duration"`; custom formatter functions are React-only. `"percent"` treats its input as a ratio, so `0.97` renders as 97%. For an existing 0–100 value such as 97, use `format="number"` with `suffix="%"`. Suppress decoration via `mode="thumbnail"` for dense grids or `mode="inline"` for prose. Stream via `ref.current.push({ value, time })` — pair with `stalenessThreshold` to dim the card when updates stop.
|
|
1594
1741
|
|
|
1595
1742
|
### BigNumber with a Semiotic chart embedded via `trendSlot` (wide / rectangular)
|
|
1596
1743
|
|