semiotic 3.10.2 → 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.
- package/README.md +21 -26
- package/ai/artifact-surface-inventory.json +1 -1
- package/ai/behaviorContracts.cjs +15 -5
- package/ai/behaviorContracts.d.cts +3 -0
- package/ai/cli.js +17 -166
- package/ai/componentMetadata.cjs +68 -15
- package/ai/componentMetadata.d.cts +3 -0
- package/ai/dist/diagnose-operation.js +3 -0
- package/ai/dist/mcp-server.js +59 -59
- package/ai/reference.md +6 -6
- package/ai/schema.json +1 -1
- package/ai/surface-manifest.json +1 -1
- package/ai/system-prompt.md +2 -2
- package/ai/task-packets/compare-category-totals.json +7 -7
- package/ai/task-packets/compare-category-totals.md +3 -3
- package/ai/task-packets/correct-published-chart.json +7 -7
- package/ai/task-packets/correct-published-chart.md +3 -3
- package/ai/task-packets/index.json +6 -6
- package/ai/task-packets/update-live-chart.json +7 -7
- package/ai/task-packets/update-live-chart.md +3 -3
- package/dist/c-2MHSD3TN.min.js +209 -0
- package/dist/{c-PZ3NEGNG.min.js → c-6XGGN5OS.min.js} +1 -1
- package/dist/{c-FDUQDCBC.min.js → c-CO4NDAD6.min.js} +23 -23
- package/dist/c-EK6XI2U7.min.js +26 -0
- package/dist/c-FMCUQ6JX.min.js +1 -0
- package/dist/{c-C4KIXUWU.min.js → c-GK263BF4.min.js} +1 -1
- package/dist/{c-TTKWXGAI.min.js → c-HNHKIMIV.min.js} +3 -3
- package/dist/c-IJCZGUG6.min.js +31 -0
- package/dist/{c-4XLHPQTP.min.js → c-JBWPJNTJ.min.js} +1 -1
- package/dist/{c-4MD53L2J.min.js → c-JC76YAHB.min.js} +28 -28
- package/dist/{c-VXIYF7V2.min.js → c-JOPGDP6N.min.js} +1 -1
- package/dist/c-KWP4QTCM.min.js +4 -0
- package/dist/c-LRV7PO45.min.js +393 -0
- package/dist/c-LVHJJUOF.min.js +1 -0
- package/dist/c-M43PK7K4.min.js +1 -0
- package/dist/c-NUBZ63VU.min.js +1 -0
- package/dist/{c-7ASK4WBF.min.js → c-PITYSOPK.min.js} +1 -1
- package/dist/{c-2TW5H5PD.min.js → c-QPO24R7Q.min.js} +1 -1
- package/dist/{c-SG2Y7EBY.min.js → c-RWHLEUX6.min.js} +1 -1
- package/dist/{c-4JKDJUYD.min.js → c-S746GRV4.min.js} +1 -1
- package/dist/{c-KGROWFT2.min.js → c-SAP5KY6R.min.js} +2 -2
- package/dist/c-UMGHCBH5.min.js +114 -0
- package/dist/c-UQBWSYKI.min.js +41 -0
- package/dist/{c-6ZU3QVLB.min.js → c-VEMCBQZZ.min.js} +33 -33
- package/dist/{c-IPYGNVN6.min.js → c-WD2RL76M.min.js} +45 -45
- package/dist/{c-PQOZPM4G.min.js → c-YL7HJL5J.min.js} +1 -1
- package/dist/c-Z6GRGS53.min.js +1 -0
- package/dist/components/CategoryColors.d.ts +7 -0
- package/dist/components/LinkedCharts.d.ts +2 -1
- package/dist/components/ai/chartClinic.d.ts +1 -1
- package/dist/components/ai/chartClinicMetadata.generated.d.ts +2 -2
- package/dist/components/charts/shared/{chartDefinitionPilot.d.ts → chartDefinition.d.ts} +30 -34
- package/dist/components/charts/shared/chartDefinitions.d.ts +10 -0
- package/dist/components/charts/shared/chartDefinitionsNetwork.d.ts +17 -0
- package/dist/components/charts/shared/chartDefinitionsOrdinal.d.ts +23 -0
- package/dist/components/charts/shared/chartDefinitionsPhysics.d.ts +17 -0
- package/dist/components/charts/shared/chartDefinitionsRealtime.d.ts +12 -0
- package/dist/components/charts/shared/chartDefinitionsXY.d.ts +26 -0
- package/dist/components/charts/shared/useChartSetup.d.ts +1 -1
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +1 -1
- package/dist/components/data/transforms.d.ts +1 -0
- package/dist/components/server/serverChartConfigs.d.ts +36 -36
- package/dist/components/server/serverChartConfigsNetwork.generated.d.ts +17 -0
- package/dist/components/server/serverChartConfigsOrdinal.generated.d.ts +23 -0
- package/dist/components/server/serverChartConfigsPhysics.generated.d.ts +17 -0
- package/dist/components/server/serverChartConfigsRealtime.generated.d.ts +13 -0
- package/dist/components/server/serverChartConfigsXY.generated.d.ts +22 -0
- package/dist/components/stream/physics/PhysicsOptionalEngineAdapters.d.ts +5 -0
- package/dist/geo.min.js +3 -3
- package/dist/geo.module.min.js +10 -10
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics-matter.min.js +4 -1
- package/dist/physics-matter.module.min.js +1 -1
- package/dist/physics-rapier.min.js +4 -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/semiotic-ai-core.min.js +3 -3
- package/dist/semiotic-ai-core.module.min.js +3 -3
- package/dist/semiotic-ai.module.min.js +7 -7
- package/dist/semiotic-artifact.min.js +1 -1
- package/dist/semiotic-artifact.module.min.js +1 -1
- package/dist/semiotic-atlas-selection.module.min.js +1 -1
- package/dist/semiotic-client-cjs-shared.min.js +903 -902
- package/dist/semiotic-data.min.js +1 -1
- package/dist/semiotic-data.module.min.js +1 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +3 -3
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +3 -3
- package/dist/semiotic-experimental-vacp.module.min.js +1 -1
- package/dist/semiotic-line.module.min.js +1 -1
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
- package/dist/semiotic-recipes-core.module.min.js +13 -13
- package/dist/semiotic-server-edge-node.module.min.js +393 -391
- package/dist/semiotic-server-edge.min.js +393 -391
- package/dist/semiotic-server-edge.module.min.js +374 -372
- package/dist/semiotic-server-node.min.js +393 -391
- package/dist/semiotic-server-node.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.module.min.js +10 -10
- package/dist/server.min.js +393 -391
- package/dist/server.module.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +12 -8
- package/dist/c-3OFVBWQY.min.js +0 -1
- package/dist/c-6IVBV5NO.min.js +0 -1
- package/dist/c-72CBVNYX.min.js +0 -209
- package/dist/c-7LY46QUI.min.js +0 -41
- package/dist/c-AKLBQMQF.min.js +0 -391
- package/dist/c-F2GGJB2S.min.js +0 -31
- package/dist/c-G53AVC42.min.js +0 -113
- package/dist/c-HQ27AHMC.min.js +0 -1
- package/dist/c-IHWZ2C6D.min.js +0 -26
- package/dist/c-MOP2NGLH.min.js +0 -1
- package/dist/c-PKY4JFY5.min.js +0 -1
- 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` (
|
|
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
|
|
|
@@ -338,7 +338,7 @@ or geo custom charts; a server renderer cannot read a browser's selection store.
|
|
|
338
338
|
**LinkedCharts** — `selections`. **CategoryColorProvider** — `colors`|`categories` + `colorScheme`.
|
|
339
339
|
Chart props: `selection`, `linkedHover`, `linkedBrush`. Hooks: `useSelection`, `useLinkedHover`, `useBrushSelection`. Works for `NetworkCustomChart` too — the resolved selection predicate is threaded into the custom layout as `ctx.selection`.
|
|
340
340
|
**`useSelectionActions(name)`** — write-only access (`selectPoints`/`clear`) that does NOT subscribe to selection state, so a *container* can push a selection (e.g. from a hover handler) without re-rendering; only the leaf consumers reading the selection re-render. The provider-at-top / consumers-at-leaves pattern for interaction-heavy coordinated views.
|
|
341
|
-
**Shared categories inside LinkedCharts
|
|
341
|
+
**Shared categories inside LinkedCharts:** generated colors keep charts without an explicit palette consistent. A child's `colorScheme` overrides those generated defaults; wrap in `CategoryColorProvider` to explicitly assign shared category colors above each child's palette. LinkedCharts builds its unified legend from resolved chart colors. If charts use different colors for the same category, it retains individual legends instead.
|
|
342
342
|
**Linked crosshair**: `linkedHover={{ name: "sync", mode: "x-position", xField: "time" }}`. Click locks crosshair (dashed white); click/Escape unlocks.
|
|
343
343
|
**Linked series highlight** (series↔bar cross-highlight): `linkedHover={{ name: "sync", mode: "series" }}` auto-resolves the chart's series-identity field (colorBy/lineBy/areaBy/stackBy/groupBy) and keys the linked selection off it — no hand-wired `fields`. Add `seriesField: "region"` to override (align charts whose series live under different prop names). Modes are exclusive: `mode` is `"field"` (default) | `"x-position"` (crosshair) | `"series"`.
|
|
344
344
|
**CircularBrush** — accessible range brush over a **cyclical** domain (day-of-year, hour, compass): `value` ({start,end}) / `onChange` (value | updater) / `period` (365) / `radius` / `step`+`largeStep` / `formatValue` / `arcFill`/`stroke`. Wrap-around ranges, pointer-capture drag, and full keyboard control (each handle + the range is a `role="slider"`, ←/→ nudges, Shift = `largeStep`). The radial counterpart to the linear `RealtimeHistogram` brush. **Control-surface contract**: it takes value/domain/geometry/`onChange` and never reaches into a chart — layer it over a chart sharing its coordinate space and feed `onChange` into your state (or the selection store). Built on the cyclical + radial kit.
|
|
@@ -399,7 +399,7 @@ CSS custom properties: `--semiotic-{bg, text, text-secondary, border, grid, prim
|
|
|
399
399
|
<ThemeProvider theme={{ mode: "dark", colors: { categorical: [...] } }}> {/* merge onto dark base */}
|
|
400
400
|
```
|
|
401
401
|
|
|
402
|
-
**Color priority** (with `colorBy`): CategoryColorProvider
|
|
402
|
+
**Color priority** (with `colorBy`): explicit CategoryColorProvider mappings (including those inherited through LinkedCharts) > `colorScheme` > ThemeProvider `colors.categorical` > `"category10"`. LinkedCharts registration-order defaults do not override `colorScheme`. `colorScheme` accepts a named scheme (`"tableau10"`), an array, or a `{category: color}` **object map** for exact per-category colors (no array ordering to keep in sync).
|
|
403
403
|
Presets: `light`, `dark`, `high-contrast`, `pastels`(-dark), `bi-tool`(-dark), `italian`(-dark), `tufte`(-dark), `journalist`(-dark), `playful`(-dark), `carbon`(-dark).
|
|
404
404
|
Serialization: `themeToCSS(theme, selector)`, `themeToTokens(theme)`, `designTokensToTheme(tokens)`, `resolveThemePreset(name)`. Native `semiotic.*` tokens round-trip title/legend size, family, and weight along with the base typography and color roles.
|
|
405
405
|
|
|
@@ -499,7 +499,7 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
|
|
|
499
499
|
Agent action: Use an actionable cursor only when the application separately supplies documented click or observation behavior and an accessible activation path. Treat cursor in serialized/static output as visual metadata, never as proof that a mark is interactive.
|
|
500
500
|
- **Data required by usage mode** (`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.
|
|
501
501
|
Agent action: 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.
|
|
502
|
-
- **Categorical color precedence** (`color.category-precedence`): When colorBy is set, CategoryColorProvider
|
|
502
|
+
- **Categorical color precedence** (`color.category-precedence`): When colorBy is set, explicit CategoryColorProvider mappings, including those inherited through LinkedCharts, win for mapped categories. Unmapped categories fall back to explicit colorScheme, then ThemeProvider colors.categorical, then the built-in categorical fallback. Generated LinkedCharts colors do not override a child's colorScheme.
|
|
503
503
|
Agent action: Use colorBy for categorical encodings. Use CategoryColorProvider or LinkedCharts for cross-chart consistency, colorScheme for per-chart fallback palettes, and avoid frameProps style functions unless intentionally bypassing HOC color resolution.
|
|
504
504
|
- **Required prop combinations** (`props.required-combinations`): Some chart families need semantic props beyond data. These combinations are enforced by validation/schema for static configs and remain required in push mode unless explicitly noted.
|
|
505
505
|
Agent action: Before returning code, check the selected component against the required combinations list. For push mode, omit data but keep semantic props such as areaBy, sizeBy, stackBy, and groupBy.
|
|
@@ -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.
|
|
515
|
-
Agent action: Use
|
|
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
package/ai/surface-manifest.json
CHANGED
package/ai/system-prompt.md
CHANGED
|
@@ -113,13 +113,13 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
|
|
|
113
113
|
- **Accessible chart text uses direct chart props** (`accessibility.description-props`): High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.
|
|
114
114
|
- **Cursor styling does not create behavior** (`interaction.cursor-is-presentation-only`): Cursor values in realtime props, retained mark styles, styleRules, and custom hit targets change pointer presentation only. They do not install click handlers, keyboard activation, observations, or accessibility semantics.
|
|
115
115
|
- **Data required by usage mode** (`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.
|
|
116
|
-
- **Categorical color precedence** (`color.category-precedence`): When colorBy is set, CategoryColorProvider
|
|
116
|
+
- **Categorical color precedence** (`color.category-precedence`): When colorBy is set, explicit CategoryColorProvider mappings, including those inherited through LinkedCharts, win for mapped categories. Unmapped categories fall back to explicit colorScheme, then ThemeProvider colors.categorical, then the built-in categorical fallback. Generated LinkedCharts colors do not override a child's colorScheme.
|
|
117
117
|
- **Required prop combinations** (`props.required-combinations`): Some chart families need semantic props beyond data. These combinations are enforced by validation/schema for static configs and remain required in push mode unless explicitly noted.
|
|
118
118
|
Required combinations: StackedAreaChart: static data + areaBy; push areaBy. Stacked areas need a flat data array plus areaBy to identify the stacked series. BubbleChart: static data + sizeBy; push sizeBy. Bubbles need sizeBy in addition to x/y accessors so radius encodes data rather than a constant point size. StackedBarChart: static data + stackBy; push stackBy. Stacked bars need stackBy to split each category into stack segments. GroupedBarChart: static data + groupBy; push groupBy. Grouped bars need groupBy to split each category into side-by-side bars. SwimlaneChart: static data + subcategoryAccessor; push subcategoryAccessor. Swimlanes need subcategoryAccessor; colorBy defaults to the same field when not provided. GaugeChart: static value; push not supported. GaugeChart is value-only. Its thresholds use { value, color, label? }; BigNumber thresholds use the distinct { at, level, color?, label? } vocabulary. ForceDirectedGraph: static nodes + edges; push nodes + edges. ForceDirectedGraph schema/rendering requires nodes and edges. If an agent infers nodes from edge endpoints, it must materialize a nodes array before returning code.
|
|
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.
|
|
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.
|
|
10
|
+
"packageVersion": "3.10.4",
|
|
11
11
|
"channel": "source",
|
|
12
|
-
"sourceRevision": "sha256:
|
|
12
|
+
"sourceRevision": "sha256:47c46b50f17f8286c1feceea1ec829cb2ef66812f372f8d1e37cf520a5b11494",
|
|
13
13
|
"revisionKind": "content-digest",
|
|
14
14
|
"runtime": {
|
|
15
|
-
"digest": "sha256:
|
|
16
|
-
"fileCount":
|
|
15
|
+
"digest": "sha256:af26a70e4afc489483afea4c01de73a5bd43e02ddeb9237b2f35135667e00287",
|
|
16
|
+
"fileCount": 1186
|
|
17
17
|
},
|
|
18
18
|
"taskSources": {
|
|
19
|
-
"digest": "sha256:
|
|
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.
|
|
161
|
-
"action": "Use
|
|
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.
|
|
8
|
-
Source revision: sha256:
|
|
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
|
|
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.
|
|
10
|
+
"packageVersion": "3.10.4",
|
|
11
11
|
"channel": "source",
|
|
12
|
-
"sourceRevision": "sha256:
|
|
12
|
+
"sourceRevision": "sha256:d94dc075bad41909efe996b4ed233b31fe794b9941a2b29576bc9d6dd11dc54d",
|
|
13
13
|
"revisionKind": "content-digest",
|
|
14
14
|
"runtime": {
|
|
15
|
-
"digest": "sha256:
|
|
16
|
-
"fileCount":
|
|
15
|
+
"digest": "sha256:af26a70e4afc489483afea4c01de73a5bd43e02ddeb9237b2f35135667e00287",
|
|
16
|
+
"fileCount": 1186
|
|
17
17
|
},
|
|
18
18
|
"taskSources": {
|
|
19
|
-
"digest": "sha256:
|
|
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.
|
|
138
|
-
"action": "Use
|
|
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.
|
|
8
|
-
Source revision: sha256:
|
|
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
|
|
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.
|
|
12
|
-
"sourceRevision": "sha256:
|
|
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.
|
|
23
|
-
"sourceRevision": "sha256:
|
|
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.
|
|
34
|
-
"sourceRevision": "sha256:
|
|
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.
|
|
10
|
+
"packageVersion": "3.10.4",
|
|
11
11
|
"channel": "source",
|
|
12
|
-
"sourceRevision": "sha256:
|
|
12
|
+
"sourceRevision": "sha256:3248653f5f63ab2317f75c2743843296116cffe568c7a64ef988cac16889fdbb",
|
|
13
13
|
"revisionKind": "content-digest",
|
|
14
14
|
"runtime": {
|
|
15
|
-
"digest": "sha256:
|
|
16
|
-
"fileCount":
|
|
15
|
+
"digest": "sha256:af26a70e4afc489483afea4c01de73a5bd43e02ddeb9237b2f35135667e00287",
|
|
16
|
+
"fileCount": 1186
|
|
17
17
|
},
|
|
18
18
|
"taskSources": {
|
|
19
|
-
"digest": "sha256:
|
|
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.
|
|
154
|
-
"action": "Use
|
|
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.
|
|
8
|
-
Source revision: sha256:
|
|
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
|
|
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
|
|