semiotic 3.10.3 → 3.10.4

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.
Files changed (81) hide show
  1. package/README.md +17 -18
  2. package/ai/artifact-surface-inventory.json +1 -1
  3. package/ai/behaviorContracts.cjs +14 -4
  4. package/ai/behaviorContracts.d.cts +3 -0
  5. package/ai/cli.js +17 -166
  6. package/ai/componentMetadata.cjs +68 -15
  7. package/ai/componentMetadata.d.cts +3 -0
  8. package/ai/dist/diagnose-operation.js +3 -0
  9. package/ai/dist/mcp-server.js +59 -59
  10. package/ai/reference.md +3 -3
  11. package/ai/schema.json +1 -1
  12. package/ai/surface-manifest.json +1 -1
  13. package/ai/system-prompt.md +1 -1
  14. package/ai/task-packets/compare-category-totals.json +7 -7
  15. package/ai/task-packets/compare-category-totals.md +3 -3
  16. package/ai/task-packets/correct-published-chart.json +7 -7
  17. package/ai/task-packets/correct-published-chart.md +3 -3
  18. package/ai/task-packets/index.json +6 -6
  19. package/ai/task-packets/update-live-chart.json +7 -7
  20. package/ai/task-packets/update-live-chart.md +3 -3
  21. package/dist/{c-FHNY57SO.min.js → c-2MHSD3TN.min.js} +46 -46
  22. package/dist/{c-5PIKBUMF.min.js → c-6XGGN5OS.min.js} +1 -1
  23. package/dist/c-EK6XI2U7.min.js +26 -0
  24. package/dist/{c-4XLHPQTP.min.js → c-JBWPJNTJ.min.js} +1 -1
  25. package/dist/c-KWP4QTCM.min.js +4 -0
  26. package/dist/c-LRV7PO45.min.js +393 -0
  27. package/dist/c-LVHJJUOF.min.js +1 -0
  28. package/dist/c-NUBZ63VU.min.js +1 -0
  29. package/dist/{c-ZVOFLE2P.min.js → c-RWHLEUX6.min.js} +6 -6
  30. package/dist/{c-4JKDJUYD.min.js → c-S746GRV4.min.js} +1 -1
  31. package/dist/{c-ISA6IJ6V.min.js → c-UQBWSYKI.min.js} +5 -5
  32. package/dist/components/ai/chartClinic.d.ts +1 -1
  33. package/dist/components/ai/chartClinicMetadata.generated.d.ts +2 -2
  34. package/dist/components/charts/shared/{chartDefinitionPilot.d.ts → chartDefinition.d.ts} +30 -34
  35. package/dist/components/charts/shared/chartDefinitions.d.ts +10 -0
  36. package/dist/components/charts/shared/chartDefinitionsNetwork.d.ts +17 -0
  37. package/dist/components/charts/shared/chartDefinitionsOrdinal.d.ts +23 -0
  38. package/dist/components/charts/shared/chartDefinitionsPhysics.d.ts +17 -0
  39. package/dist/components/charts/shared/chartDefinitionsRealtime.d.ts +12 -0
  40. package/dist/components/charts/shared/chartDefinitionsXY.d.ts +26 -0
  41. package/dist/components/server/serverChartConfigs.d.ts +36 -36
  42. package/dist/components/server/serverChartConfigsNetwork.generated.d.ts +17 -0
  43. package/dist/components/server/serverChartConfigsOrdinal.generated.d.ts +23 -0
  44. package/dist/components/server/serverChartConfigsPhysics.generated.d.ts +17 -0
  45. package/dist/components/server/serverChartConfigsRealtime.generated.d.ts +13 -0
  46. package/dist/components/server/serverChartConfigsXY.generated.d.ts +22 -0
  47. package/dist/components/stream/physics/PhysicsOptionalEngineAdapters.d.ts +5 -0
  48. package/dist/network.module.min.js +1 -1
  49. package/dist/physics-matter.min.js +4 -1
  50. package/dist/physics-matter.module.min.js +1 -1
  51. package/dist/physics-rapier.min.js +4 -1
  52. package/dist/physics-rapier.module.min.js +1 -1
  53. package/dist/physics.module.min.js +1 -1
  54. package/dist/semiotic-ai-core.min.js +3 -3
  55. package/dist/semiotic-ai-core.module.min.js +3 -3
  56. package/dist/semiotic-ai.module.min.js +2 -2
  57. package/dist/semiotic-artifact.min.js +1 -1
  58. package/dist/semiotic-artifact.module.min.js +1 -1
  59. package/dist/semiotic-client-cjs-shared.min.js +4 -4
  60. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  61. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  62. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  63. package/dist/semiotic-realtime-core.module.min.js +1 -1
  64. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  65. package/dist/semiotic-recipes-core.module.min.js +13 -13
  66. package/dist/semiotic-server-edge-node.module.min.js +393 -391
  67. package/dist/semiotic-server-edge.min.js +393 -391
  68. package/dist/semiotic-server-edge.module.min.js +374 -372
  69. package/dist/semiotic-server-node.min.js +393 -391
  70. package/dist/semiotic-server-node.module.min.js +1 -1
  71. package/dist/semiotic-utils-core.min.js +1 -1
  72. package/dist/semiotic-utils-core.module.min.js +1 -1
  73. package/dist/semiotic.module.min.js +9 -9
  74. package/dist/server.min.js +393 -391
  75. package/dist/server.module.min.js +1 -1
  76. package/package.json +8 -4
  77. package/dist/c-3OFVBWQY.min.js +0 -1
  78. package/dist/c-43XNOQNQ.min.js +0 -391
  79. package/dist/c-6IVBV5NO.min.js +0 -1
  80. package/dist/c-KXH7LFIL.min.js +0 -26
  81. package/dist/c-UBHICVSC.min.js +0 -1
package/ai/reference.md CHANGED
@@ -10,7 +10,7 @@ diagnostic tools; when possible, confirm a non-empty render with evidence.
10
10
  - Install: `npm install semiotic`
11
11
  <!-- semiotic-bundle-sizes:start -->
12
12
  <!-- Auto-generated by scripts/sync-bundle-sizes.mjs — do not edit by hand. -->
13
- - **Use sub-path imports** — `semiotic/atlas` (270KB gz), `semiotic/atlas/core` (13KB gz), `semiotic/access` (28KB gz), `semiotic/evidence` (44KB gz), `semiotic/artifact` (121KB gz), `semiotic/artifact/react` (4KB gz), `semiotic/line` (134KB gz), `semiotic/xy` (164KB gz), `semiotic/ordinal` (128KB gz), `semiotic/network` (148KB gz), `semiotic/geo` (106KB gz), `semiotic/realtime` (164KB gz), `semiotic/realtime/core` (163KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (243KB gz), `semiotic/server/node` (243KB gz), `semiotic/server/edge` (250KB gz), `semiotic/utils` (99KB gz), `semiotic/utils/core` (92KB gz), `semiotic/utils/react` (7KB gz), `semiotic/recipes` (110KB gz), `semiotic/recipes/core` (102KB gz), `semiotic/recipes/react` (7KB gz), `semiotic/themes` (11KB gz), `semiotic/themes/core` (11KB gz), `semiotic/themes/react` (6KB gz), `semiotic/data` (4KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (165KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (595KB gz), `semiotic/ai/core` (138KB gz), `semiotic/controls` (11KB gz), `semiotic/rough` (3KB gz), `semiotic/text` (2KB gz). Full `semiotic` is 374KB gz.
13
+ - **Use sub-path imports** — `semiotic/atlas` (270KB gz), `semiotic/atlas/core` (13KB gz), `semiotic/access` (28KB gz), `semiotic/evidence` (44KB gz), `semiotic/artifact` (121KB gz), `semiotic/artifact/react` (4KB gz), `semiotic/line` (134KB gz), `semiotic/xy` (164KB gz), `semiotic/ordinal` (128KB gz), `semiotic/network` (148KB gz), `semiotic/geo` (106KB gz), `semiotic/realtime` (164KB gz), `semiotic/realtime/core` (162KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (243KB gz), `semiotic/server/node` (243KB gz), `semiotic/server/edge` (250KB gz), `semiotic/utils` (99KB gz), `semiotic/utils/core` (92KB gz), `semiotic/utils/react` (7KB gz), `semiotic/recipes` (110KB gz), `semiotic/recipes/core` (102KB gz), `semiotic/recipes/react` (7KB gz), `semiotic/themes` (11KB gz), `semiotic/themes/core` (11KB gz), `semiotic/themes/react` (6KB gz), `semiotic/data` (4KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (164KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (595KB gz), `semiotic/ai/core` (138KB gz), `semiotic/controls` (11KB gz), `semiotic/rough` (3KB gz), `semiotic/text` (2KB gz). Full `semiotic` is 374KB gz.
14
14
  <!-- semiotic-bundle-sizes:end -->
15
15
  - CLI: `npx semiotic-ai [--schema|--compact|--examples|--doctor|--audit-a11y|--evaluate]` · MCP: `npx semiotic-mcp`
16
16
 
@@ -511,8 +511,8 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
511
511
  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).`
512
512
  - **Ref mutations need stable IDs** (`streaming.ref-mutations-require-id-accessors`): push() and pushMany() can append without IDs, but remove(id) and update(id, updater) require a stable ID accessor: pointIdAccessor for XY/realtime charts, dataIdAccessor for ordinal charts, and nodeIDAccessor/edgeIdAccessor for network operations.
513
513
  Agent action: When generating code that calls remove() or update(), include the matching ID accessor and make sure pushed rows carry that ID field.
514
- - **renderChart uses static props only** (`rendering.renderchart-static-props`): 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.
515
- Agent action: 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.
514
+ - **renderChart uses static props only** (`rendering.renderchart-static-props`): MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram.
515
+ Agent action: Use complete static data for snapshots. For a Realtime component snapshot, use semiotic/server directly; for live behavior, return React code with a ref and do not promise MCP-rendered output.
516
516
  - **Axis formatters are React callbacks** (`serialization.formatters-are-react-callbacks`): 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.
517
517
  Agent action: 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)}.
518
518
  Example: `JSON: { "xLabel": "Payload (KB)", "yLabel": "Response time (ms)" }. React-only: xFormat={value => formatNumber(value, { maximumFractionDigits: 0 })}.`
package/ai/schema.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "name": "semiotic",
4
- "version": "3.10.3",
4
+ "version": "3.10.4",
5
5
  "description": "React data visualization library for charts, networks, and beyond",
6
6
  "tools": [
7
7
  {
@@ -7,7 +7,7 @@
7
7
  "src/components/semiotic-ai.ts",
8
8
  "ai/mcp-server.ts"
9
9
  ],
10
- "version": "3.10.3",
10
+ "version": "3.10.4",
11
11
  "components": {
12
12
  "schema": 64,
13
13
  "aiChartExports": 56,
@@ -119,7 +119,7 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
119
119
  - **Push mode omits data** (`streaming.push-mode-data`): 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.
120
120
  - **Serialized proposals keep the initial snapshot** (`streaming.serialized-proposal-snapshot`): 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.
121
121
  - **Ref mutations need stable IDs** (`streaming.ref-mutations-require-id-accessors`): push() and pushMany() can append without IDs, but remove(id) and update(id, updater) require a stable ID accessor: pointIdAccessor for XY/realtime charts, dataIdAccessor for ordinal charts, and nodeIDAccessor/edgeIdAccessor for network operations.
122
- - **renderChart uses static props only** (`rendering.renderchart-static-props`): 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.
122
+ - **renderChart uses static props only** (`rendering.renderchart-static-props`): MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram.
123
123
  - **Axis formatters are React callbacks** (`serialization.formatters-are-react-callbacks`): 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.
124
124
  - **Value components do not inherit chart-HOC props** (`value.bignumber-wire-contract`): 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%.
125
125
  - **Proportional symbol maps use geographic props** (`geo.proportional-symbol-wire-shape`): 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.
@@ -7,16 +7,16 @@
7
7
  "route": "/tasks/compare-category-totals",
8
8
  "identity": {
9
9
  "packageName": "semiotic",
10
- "packageVersion": "3.10.3",
10
+ "packageVersion": "3.10.4",
11
11
  "channel": "source",
12
- "sourceRevision": "sha256:03b9d282fdf261fc90d262ec74bead44e05d6e3a8c11c2357d9b8242d8d1bc7b",
12
+ "sourceRevision": "sha256:47c46b50f17f8286c1feceea1ec829cb2ef66812f372f8d1e37cf520a5b11494",
13
13
  "revisionKind": "content-digest",
14
14
  "runtime": {
15
- "digest": "sha256:8aa926db2e659e8e7a1fa37d00c7d22c67179d97c9b192b44e86bb678f1f22f4",
16
- "fileCount": 1171
15
+ "digest": "sha256:af26a70e4afc489483afea4c01de73a5bd43e02ddeb9237b2f35135667e00287",
16
+ "fileCount": 1186
17
17
  },
18
18
  "taskSources": {
19
- "digest": "sha256:bd8f750c15145f453eb3be245e55cf5fe6efd2c976761edd3efbbd2f798abbf9",
19
+ "digest": "sha256:4498bc0d388b009686656636ea2b3e26260d989de232b312564307e95afa317a",
20
20
  "fileCount": 36
21
21
  },
22
22
  "availability": "Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks."
@@ -157,8 +157,8 @@
157
157
  {
158
158
  "id": "rendering.renderchart-static-props",
159
159
  "title": "renderChart uses static props only",
160
- "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.",
161
- "action": "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."
160
+ "summary": "MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram.",
161
+ "action": "Use complete static data for snapshots. For a Realtime component snapshot, use semiotic/server directly; for live behavior, return React code with a ref and do not promise MCP-rendered output."
162
162
  },
163
163
  {
164
164
  "id": "serialization.formatters-are-react-callbacks",
@@ -4,8 +4,8 @@
4
4
 
5
5
  Compare three totals in React, inspect their exact values, and verify the server-rendered bar geometry.
6
6
 
7
- Source package: semiotic@3.10.3. Channel: source.
8
- Source revision: sha256:03b9d282fdf261fc90d262ec74bead44e05d6e3a8c11c2357d9b8242d8d1bc7b. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
7
+ Source package: semiotic@3.10.4. Channel: source.
8
+ Source revision: sha256:47c46b50f17f8286c1feceea1ec829cb2ef66812f372f8d1e37cf520a5b11494. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
9
9
 
10
10
  ## The job
11
11
 
@@ -160,7 +160,7 @@ Full component resource: semiotic://schema/BarChart. Machine packet: /tasks/comp
160
160
 
161
161
  - **props.data-required-by-usage-mode:** Static usage (`renderChart`, MCP previews, SSR snapshots, and copy/paste examples with immediate data) requires data in props. React push mode selects live ingestion by omitting data and mutating through a ref. Pass usageMode="push" to `semiotic-ai --doctor` when validating ref-based JSX with no data prop. Keep usageMode="static" or omit it for renderChart/MCP/static configs where data must be present.
162
162
 
163
- - **rendering.renderchart-static-props:** 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. 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.
163
+ - **rendering.renderchart-static-props:** MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram. Use complete static data for snapshots. For a Realtime component snapshot, use semiotic/server directly; for live behavior, return React code with a ref and do not promise MCP-rendered output.
164
164
 
165
165
  - **serialization.formatters-are-react-callbacks:** 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. 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)}.
166
166
 
@@ -7,16 +7,16 @@
7
7
  "route": "/tasks/correct-published-chart",
8
8
  "identity": {
9
9
  "packageName": "semiotic",
10
- "packageVersion": "3.10.3",
10
+ "packageVersion": "3.10.4",
11
11
  "channel": "source",
12
- "sourceRevision": "sha256:c6d593c99b338782c0c63e6e1d9a83062df31cbcafed1d44173e9e36540a3115",
12
+ "sourceRevision": "sha256:d94dc075bad41909efe996b4ed233b31fe794b9941a2b29576bc9d6dd11dc54d",
13
13
  "revisionKind": "content-digest",
14
14
  "runtime": {
15
- "digest": "sha256:8aa926db2e659e8e7a1fa37d00c7d22c67179d97c9b192b44e86bb678f1f22f4",
16
- "fileCount": 1171
15
+ "digest": "sha256:af26a70e4afc489483afea4c01de73a5bd43e02ddeb9237b2f35135667e00287",
16
+ "fileCount": 1186
17
17
  },
18
18
  "taskSources": {
19
- "digest": "sha256:bd8f750c15145f453eb3be245e55cf5fe6efd2c976761edd3efbbd2f798abbf9",
19
+ "digest": "sha256:4498bc0d388b009686656636ea2b3e26260d989de232b312564307e95afa317a",
20
20
  "fileCount": 36
21
21
  },
22
22
  "availability": "Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks."
@@ -134,8 +134,8 @@
134
134
  {
135
135
  "id": "rendering.renderchart-static-props",
136
136
  "title": "renderChart uses static props only",
137
- "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.",
138
- "action": "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."
137
+ "summary": "MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram.",
138
+ "action": "Use complete static data for snapshots. For a Realtime component snapshot, use semiotic/server directly; for live behavior, return React code with a ref and do not promise MCP-rendered output."
139
139
  }
140
140
  ]
141
141
  },
@@ -4,8 +4,8 @@
4
4
 
5
5
  Apply a source correction, replace affected claims explicitly, and preserve the context a later reader needs.
6
6
 
7
- Source package: semiotic@3.10.3. Channel: source.
8
- Source revision: sha256:c6d593c99b338782c0c63e6e1d9a83062df31cbcafed1d44173e9e36540a3115. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
7
+ Source package: semiotic@3.10.4. Channel: source.
8
+ Source revision: sha256:d94dc075bad41909efe996b4ed233b31fe794b9941a2b29576bc9d6dd11dc54d. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
9
9
 
10
10
  ## The job
11
11
 
@@ -571,7 +571,7 @@ Full component resource: semiotic://schema/BarChart. Machine packet: /tasks/corr
571
571
 
572
572
  - **props.data-required-by-usage-mode:** Static usage (`renderChart`, MCP previews, SSR snapshots, and copy/paste examples with immediate data) requires data in props. React push mode selects live ingestion by omitting data and mutating through a ref. Pass usageMode="push" to `semiotic-ai --doctor` when validating ref-based JSX with no data prop. Keep usageMode="static" or omit it for renderChart/MCP/static configs where data must be present.
573
573
 
574
- - **rendering.renderchart-static-props:** 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. 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.
574
+ - **rendering.renderchart-static-props:** MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram. Use complete static data for snapshots. For a Realtime component snapshot, use semiotic/server directly; for live behavior, return React code with a ref and do not promise MCP-rendered output.
575
575
 
576
576
  ## Maintenance context
577
577
 
@@ -8,8 +8,8 @@
8
8
  "title": "Compare category totals you can check",
9
9
  "summary": "Compare three totals in React, inspect their exact values, and verify the server-rendered bar geometry.",
10
10
  "route": "/tasks/compare-category-totals",
11
- "packageVersion": "3.10.3",
12
- "sourceRevision": "sha256:03b9d282fdf261fc90d262ec74bead44e05d6e3a8c11c2357d9b8242d8d1bc7b",
11
+ "packageVersion": "3.10.4",
12
+ "sourceRevision": "sha256:47c46b50f17f8286c1feceea1ec829cb2ef66812f372f8d1e37cf520a5b11494",
13
13
  "markdown": "/tasks/compare-category-totals.md",
14
14
  "json": "/tasks/compare-category-totals.json",
15
15
  "evidenceStatus": "stale"
@@ -19,8 +19,8 @@
19
19
  "title": "Update a live chart by record ID",
20
20
  "summary": "Maintain a bounded window of incoming records, apply corrections, and reconcile the display after reconnecting.",
21
21
  "route": "/tasks/update-live-chart",
22
- "packageVersion": "3.10.3",
23
- "sourceRevision": "sha256:67787d71b76562dccdd1cfea052f9e05fac0af91d9239dacf5b7bcbea2ff76a4",
22
+ "packageVersion": "3.10.4",
23
+ "sourceRevision": "sha256:3248653f5f63ab2317f75c2743843296116cffe568c7a64ef988cac16889fdbb",
24
24
  "markdown": "/tasks/update-live-chart.md",
25
25
  "json": "/tasks/update-live-chart.json",
26
26
  "evidenceStatus": "stale"
@@ -30,8 +30,8 @@
30
30
  "title": "Correct a chart after its source changes",
31
31
  "summary": "Apply a source correction, replace affected claims explicitly, and preserve the context a later reader needs.",
32
32
  "route": "/tasks/correct-published-chart",
33
- "packageVersion": "3.10.3",
34
- "sourceRevision": "sha256:c6d593c99b338782c0c63e6e1d9a83062df31cbcafed1d44173e9e36540a3115",
33
+ "packageVersion": "3.10.4",
34
+ "sourceRevision": "sha256:d94dc075bad41909efe996b4ed233b31fe794b9941a2b29576bc9d6dd11dc54d",
35
35
  "markdown": "/tasks/correct-published-chart.md",
36
36
  "json": "/tasks/correct-published-chart.json",
37
37
  "evidenceStatus": "stale"
@@ -7,16 +7,16 @@
7
7
  "route": "/tasks/update-live-chart",
8
8
  "identity": {
9
9
  "packageName": "semiotic",
10
- "packageVersion": "3.10.3",
10
+ "packageVersion": "3.10.4",
11
11
  "channel": "source",
12
- "sourceRevision": "sha256:67787d71b76562dccdd1cfea052f9e05fac0af91d9239dacf5b7bcbea2ff76a4",
12
+ "sourceRevision": "sha256:3248653f5f63ab2317f75c2743843296116cffe568c7a64ef988cac16889fdbb",
13
13
  "revisionKind": "content-digest",
14
14
  "runtime": {
15
- "digest": "sha256:8aa926db2e659e8e7a1fa37d00c7d22c67179d97c9b192b44e86bb678f1f22f4",
16
- "fileCount": 1171
15
+ "digest": "sha256:af26a70e4afc489483afea4c01de73a5bd43e02ddeb9237b2f35135667e00287",
16
+ "fileCount": 1186
17
17
  },
18
18
  "taskSources": {
19
- "digest": "sha256:bd8f750c15145f453eb3be245e55cf5fe6efd2c976761edd3efbbd2f798abbf9",
19
+ "digest": "sha256:4498bc0d388b009686656636ea2b3e26260d989de232b312564307e95afa317a",
20
20
  "fileCount": 36
21
21
  },
22
22
  "availability": "Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks."
@@ -150,8 +150,8 @@
150
150
  {
151
151
  "id": "rendering.renderchart-static-props",
152
152
  "title": "renderChart uses static props only",
153
- "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.",
154
- "action": "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."
153
+ "summary": "MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram.",
154
+ "action": "Use complete static data for snapshots. For a Realtime component snapshot, use semiotic/server directly; for live behavior, return React code with a ref and do not promise MCP-rendered output."
155
155
  }
156
156
  ]
157
157
  },
@@ -4,8 +4,8 @@
4
4
 
5
5
  Maintain a bounded window of incoming records, apply corrections, and reconcile the display after reconnecting.
6
6
 
7
- Source package: semiotic@3.10.3. Channel: source.
8
- Source revision: sha256:67787d71b76562dccdd1cfea052f9e05fac0af91d9239dacf5b7bcbea2ff76a4. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
7
+ Source package: semiotic@3.10.4. Channel: source.
8
+ Source revision: sha256:3248653f5f63ab2317f75c2743843296116cffe568c7a64ef988cac16889fdbb. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
9
9
 
10
10
  ## The job
11
11
 
@@ -398,7 +398,7 @@ Full component resource: semiotic://schema/LineChart. Machine packet: /tasks/upd
398
398
 
399
399
  - **streaming.ref-mutations-require-id-accessors:** push() and pushMany() can append without IDs, but remove(id) and update(id, updater) require a stable ID accessor: pointIdAccessor for XY/realtime charts, dataIdAccessor for ordinal charts, and nodeIDAccessor/edgeIdAccessor for network operations. When generating code that calls remove() or update(), include the matching ID accessor and make sure pushed rows carry that ID field.
400
400
 
401
- - **rendering.renderchart-static-props:** 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. 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.
401
+ - **rendering.renderchart-static-props:** MCP renderChart and semiotic/server renderChart render a single static SVG/PNG snapshot, never future ref pushes. semiotic/server accepts bounded data for realtime charts; MCP rendering excludes the five live Realtime components but includes TemporalHistogram. Use complete static data for snapshots. For a Realtime component snapshot, use semiotic/server directly; for live behavior, return React code with a ref and do not promise MCP-rendered output.
402
402
 
403
403
  ## Maintenance context
404
404