semiotic 3.8.5 → 3.8.7

package/dist/xy.module.min.js

@@ -1,2 +1,2 @@
 "use client";
-import{DEFAULT_HIT_RADIUS as m,hitTargetPoint as n,hitTargetRect as u}from"./chunk-chunk-J3XWETBJ.module.min.js";import{AreaChart as o,BubbleChart as c,CandlestickChart as h,ConnectedScatterplot as i,DifferenceChart as k,Heatmap as r,LineChart as e,MinimapChart as t,MultiAxisLineChart as p,QuadrantChart as s,Scatterplot as d,ScatterplotMatrix as j,StackedAreaChart as l,XYCustomChart as X}from"./chunk-chunk-RPU4IZAV.module.min.js";import"./chunk-chunk-YCQYG6J5.module.min.js";import"./chunk-chunk-JCG72SGW.module.min.js";import"./chunk-chunk-SKMBCFIL.module.min.js";import{StreamXYFrame_default as C}from"./chunk-chunk-CKMD5NV3.module.min.js";import"./chunk-chunk-ZXIXAPRE.module.min.js";import"./chunk-chunk-BANTPINB.module.min.js";import"./chunk-chunk-L6EA5V3G.module.min.js";import"./chunk-chunk-PZJ2SBLL.module.min.js";import"./chunk-chunk-TMWIZL3K.module.min.js";import"./chunk-chunk-XXWSHGPL.module.min.js";import{useCustomLayoutSelection as L}from"./chunk-chunk-5UKL5W76.module.min.js";import{composeStyleRules as W,makeRuleValueResolver as f,makeXYRuleContext as B,matchesThreshold as E,resolveStyleRules as I,ruleMatches as J}from"./chunk-chunk-EMO5NUGE.module.min.js";import{hatchFillId as G,hatchPatternDef as M,isHatchFill as P,resolveResponsiveRules as Z,resolveSvgFill as A,responsiveRuleMatches as H}from"./chunk-chunk-CWQ5YIHX.module.min.js";import"./chunk-chunk-JJ2OOIET.module.min.js";import"./chunk-chunk-WCX6U47H.module.min.js";import{glyphExtent as K,glyphPlacement as N}from"./chunk-chunk-KTWEBFMX.module.min.js";import"./chunk-chunk-ACLDBMRH.module.min.js";import"./chunk-chunk-YHNZCPOZ.module.min.js";export{o as AreaChart,c as BubbleChart,h as CandlestickChart,i as ConnectedScatterplot,m as DEFAULT_HIT_RADIUS,k as DifferenceChart,r as Heatmap,e as LineChart,t as MinimapChart,p as MultiAxisLineChart,s as QuadrantChart,d as Scatterplot,j as ScatterplotMatrix,l as StackedAreaChart,C as StreamXYFrame,X as XYCustomChart,W as composeStyleRules,K as glyphExtent,N as glyphPlacement,G as hatchFillId,M as hatchPatternDef,n as hitTargetPoint,u as hitTargetRect,P as isHatchFill,f as makeRuleValueResolver,B as makeXYRuleContext,E as matchesThreshold,Z as resolveResponsiveRules,I as resolveStyleRules,A as resolveSvgFill,H as responsiveRuleMatches,J as ruleMatches,L as useCustomLayoutSelection};
+import{DEFAULT_HIT_RADIUS as m,hitTargetPoint as n,hitTargetRect as u}from"./chunk-chunk-J3XWETBJ.module.min.js";import{AreaChart as o,BubbleChart as c,BumpChart as h,CandlestickChart as i,ConnectedScatterplot as k,DifferenceChart as r,Heatmap as e,LineChart as t,MinimapChart as p,MultiAxisLineChart as s,QuadrantChart as d,Scatterplot as j,ScatterplotMatrix as l,StackedAreaChart as B,XYCustomChart as E,rankBumpData as X}from"./chunk-chunk-7TTBHSAG.module.min.js";import"./chunk-chunk-YCQYG6J5.module.min.js";import"./chunk-chunk-FBUNUIPV.module.min.js";import"./chunk-chunk-J5QD4RAM.module.min.js";import{StreamXYFrame_default as J}from"./chunk-chunk-KXAFCCDB.module.min.js";import"./chunk-chunk-MX35T6RX.module.min.js";import"./chunk-chunk-6V5VQVCT.module.min.js";import"./chunk-chunk-2YAZHXL4.module.min.js";import"./chunk-chunk-ONMLEXHR.module.min.js";import"./chunk-chunk-NJETWX42.module.min.js";import"./chunk-chunk-OI7R7EJB.module.min.js";import"./chunk-chunk-NH4MEAKP.module.min.js";import{useCustomLayoutSelection as H}from"./chunk-chunk-5UKL5W76.module.min.js";import"./chunk-chunk-BNGBEY7N.module.min.js";import{composeStyleRules as N,makeRuleValueResolver as T,makeXYRuleContext as f,matchesThreshold as C,resolveStyleRules as M,ruleMatches as Y}from"./chunk-chunk-EMO5NUGE.module.min.js";import"./chunk-chunk-5SD6BHVW.module.min.js";import{hatchFillId as A,hatchPatternDef as O,isHatchFill as W,resolveResponsiveRules as D,resolveSvgFill as K,responsiveRuleMatches as R}from"./chunk-chunk-7ZDJSYKI.module.min.js";import"./chunk-chunk-JJ2OOIET.module.min.js";import"./chunk-chunk-WCX6U47H.module.min.js";import{glyphExtent as U,glyphPlacement as V}from"./chunk-chunk-KTWEBFMX.module.min.js";import"./chunk-chunk-ACLDBMRH.module.min.js";import"./chunk-chunk-YHNZCPOZ.module.min.js";export{o as AreaChart,c as BubbleChart,h as BumpChart,i as CandlestickChart,k as ConnectedScatterplot,m as DEFAULT_HIT_RADIUS,r as DifferenceChart,e as Heatmap,t as LineChart,p as MinimapChart,s as MultiAxisLineChart,d as QuadrantChart,j as Scatterplot,l as ScatterplotMatrix,B as StackedAreaChart,J as StreamXYFrame,E as XYCustomChart,N as composeStyleRules,U as glyphExtent,V as glyphPlacement,A as hatchFillId,O as hatchPatternDef,n as hitTargetPoint,u as hitTargetRect,W as isHatchFill,T as makeRuleValueResolver,f as makeXYRuleContext,C as matchesThreshold,X as rankBumpData,D as resolveResponsiveRules,M as resolveStyleRules,K as resolveSvgFill,R as responsiveRuleMatches,Y as ruleMatches,H as useCustomLayoutSelection};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "semiotic",
-  "version": "3.8.5",
+  "version": "3.8.7",
   "mcpName": "io.github.nteract/semiotic",
   "description": "Verified generative visualization for React and agents, with deterministic chart validation, repair, rendering evidence, and MCP.",
   "main": "dist/semiotic.min.js",
@@ -186,6 +186,12 @@
       "require": "./dist/semiotic-experimental.min.js",
       "default": "./dist/semiotic-experimental.module.min.js"
     },
+    "./experimental/vacp": {
+      "types": "./dist/semiotic-experimental-vacp.d.ts",
+      "import": "./dist/semiotic-experimental-vacp.module.min.js",
+      "require": "./dist/semiotic-experimental-vacp.min.js",
+      "default": "./dist/semiotic-experimental-vacp.module.min.js"
+    },
     "./value": {
       "types": "./dist/semiotic-value.d.ts",
       "import": "./dist/semiotic-value.module.min.js",
@@ -228,7 +234,7 @@
     "test:dist": "playwright test",
     "test:examples:source": "playwright test --config playwright.docs-examples.config.ts",
     "test:visual:update": "playwright test --update-snapshots",
-    "test:visual:bootstrap": "playwright test --update-snapshots=missing",
+    "test:visual:bootstrap": "node scripts/run-playwright-missing-snapshot-bootstrap.mjs",
     "test:visual:update:docker": "node scripts/run-playwright-linux-bootstrap.mjs --update-snapshots=all",
     "test:visual:bootstrap:docker": "node scripts/run-playwright-linux-bootstrap.mjs --update-snapshots=missing",
     "bench": "vitest bench",
@@ -267,6 +273,10 @@
     "generate:gofish-fixtures": "node --experimental-strip-types scripts/gen-gofish-fixtures.ts --write",
     "generate:demo-gifs": "node -e \"try{require.resolve('sharp');require.resolve('gifenc')}catch{console.log('Skipping GIF generation (sharp/gifenc not installed)');process.exit(0)}\" && npx tsx scripts/generate-demo-gifs.ts",
     "generate:weather-baselines": "npx tsx scripts/generate-open-meteo-preset-baselines.mjs",
+    "generate:hra-wpp-pilot": "node scripts/build-hra-wpp-kidney-pilot.mjs --write",
+    "test:hra-wpp-pilot": "node --test scripts/build-hra-wpp-kidney-pilot.test.mjs",
+    "capture:conference-demo": "node scripts/capture-conference-demo.mjs",
+    "test:conference-demo-assets": "node --test scripts/conference-demo-assets.test.mjs",
     "generate:blog-og-cards": "node scripts/generate-blog-og-cards.mjs",
     "generate:example-og-cards": "node scripts/generate-example-og-cards.mjs",
     "generate:blog-rss": "node scripts/generate-blog-rss.mjs",
@@ -298,6 +308,11 @@
     "check:ai-surface": "node scripts/generate-ai-surface-manifest.mjs --check",
     "check:agent-skill": "node scripts/check-agent-skill.mjs",
     "eval:ai": "node scripts/run-ai-evals.mjs",
+    "eval:ai:openai": "node scripts/run-openai-ai-evals.mjs",
+    "eval:ai:trials": "node scripts/summarize-openai-ai-eval-trials.mjs",
+    "test:ai-evals": "node --test scripts/ai-eval-scoring.test.mjs scripts/ai-eval-report-summary.test.mjs scripts/run-openai-ai-evals.test.mjs scripts/summarize-openai-ai-eval-trials.test.mjs",
+    "test:ai:openai": "node --test scripts/run-openai-ai-evals.test.mjs",
+    "prepare:ai-evals": "node scripts/prepare-ai-evals.mjs",
     "check:ai-contracts": "node scripts/generate-ai-behavior-contracts.mjs --check",
     "check:ai-instructions": "node scripts/sync-ai-instructions.mjs --check",
     "check:ssr": "node scripts/check-ssr-alignment.js",
@@ -462,6 +477,7 @@
     "eslint": "^10.6.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
+    "ffmpeg-static": "^5.3.0",
     "globals": "^17.7.0",
     "gofish-graphics": "^0.1.0-nightly.20260624",
     "gofish-ir": "^0.1.0-nightly.20260624",

package/spec/README.md

@@ -47,11 +47,43 @@ faithful to the runtime contract — recognized values are documented, but a con
 own label and it is preserved. Genuinely closed unions (`lifecycle.freshness`, `lifecycle.status`,
 `lifecycle.anchor`) use a strict `enum`.
 
+### The paper/runtime union for annotation metadata
+
+The annotation schema publishes the **union** of the research vocabulary and the fields learned
+while implementing it. The paper emphasized `provenance.basis` and the editorial
+`lifecycle.status` / `lifecycle.supersedes` chain; the shipping runtime added the stable and
+temporal mechanics needed to make those claims survive refreshes:
+`provenance.stableId`, `lifecycle.anchor`, and `lifecycle.freshness`. The remaining provenance
+fields (`author`, `authorKind`, `source`, `confidence`, `createdAt`, `dataVersion`) and
+`lifecycle.ttlHint` are the shared connective vocabulary.
+
+That origin history is not a maturity label. Every field in this v0.1 union is implemented by the
+reference runtime and therefore carries `x-idid-status: "shipped"`. A future paper-only or
+design-only addition must carry `"proposed"` until a reference implementation makes it executable
+and testable.
+
 Chart capabilities may also include a `mobile` block. This is intentionally part of capability,
 not rendering props: it lets a custom chart, Vega-Lite binding, or recipe adapter state its mobile
 strategy, breakpoints, mark budget, touch target, label plan, and custom scene semantics without
 requiring the receiving library to execute the renderer.
 
+### Stretch-pick admission is a rule
+
+`AudienceProfile.exposureLevel` controls a separate, visibly labeled stretch surface; it never
+silently turns a stretch into the primary recommendation. Level `0` disables stretch picks. At
+level `1`, a candidate's effective familiarity must be at most `3`; level `2` widens that ceiling
+to `4`. A host admits a candidate only when all of the following are true:
+
+1. the host's chart implementation says the chart fits the data;
+2. it is at or below the active familiarity ceiling; and
+3. it is either an explicit `targets[component].direction: "increase"` choice or scores within
+   the host's declared tolerance of the top familiar choice for the same task (the reference
+   implementation defaults to `1.5` score points).
+
+Each admitted stretch should retain its rationale and caveats, name the familiar chart it could
+replace when one exists, and ship with interpretation scaffolding. This is governed literacy
+exposure, not a novelty bonus.
+
 ## Versioning
 
 The spec is versioned by directory (`v0.1/`). A `0.x` line may add `proposed` fields and tighten
@@ -65,6 +97,30 @@ The canonical files ship in the `semiotic` npm tarball and are exposed as
 `semiotic/spec/v0.1/<schema-name>` resource paths; they also remain available in this directory
 for repository consumers.
 
+The exact npm resource paths are:
+
+```text
+semiotic/spec/v0.1/chart-capability.schema.json
+semiotic/spec/v0.1/audience-profile.schema.json
+semiotic/spec/v0.1/annotation-provenance.schema.json
+semiotic/spec/v0.1/examples/<example-name>.json
+semiotic/spec/bindings/vega-lite.mjs
+```
+
+CommonJS can load a schema directly:
+
+```js
+const capabilitySchema =
+  require("semiotic/spec/v0.1/chart-capability.schema.json")
+```
+
+Node ESM can use a JSON import attribute:
+
+```js
+import capabilitySchema from
+  "semiotic/spec/v0.1/chart-capability.schema.json" with { type: "json" }
+```
+
 ## Validation
 
 These are plain [JSON Schema 2020-12](https://json-schema.org/draft/2020-12) documents. Validate
@@ -72,6 +128,18 @@ with any compliant validator (ajv, `jsonschema`, etc.) — no library dependency
 is the point. A reference implementation also ships small dependency-free structural validators
 (see *The Vega-Lite binding*, below) for hosts that do not want to pull in a full schema engine.
 
+## Worked examples
+
+Each schema has exactly two canonical JSON fixtures. They are packed with npm and validated in CI
+against both the published Draft 2020-12 schema and the reference implementation's
+dependency-free structural validator.
+
+| Schema | Example 1 | Example 2 |
+|---|---|---|
+| Chart Capability | [`chart-capability-bar-comparison.json`](./v0.1/examples/chart-capability-bar-comparison.json) — a familiar categorical comparison with a ranked variant and mobile contract | [`chart-capability-service-flow.json`](./v0.1/examples/chart-capability-service-flow.json) — an operational flow view with accessible interaction alternatives and a namespaced domain extension |
+| Audience Profile | [`audience-profile-executive-review.json`](./v0.1/examples/audience-profile-executive-review.json) — visual executive readers with inspectable adoption targets | [`audience-profile-incident-operators.json`](./v0.1/examples/audience-profile-incident-operators.json) — screen-reader reception plus namespaced role, literacy, and decision context |
+| Annotation Provenance & Lifecycle | [`annotation-provenance-watcher-threshold.json`](./v0.1/examples/annotation-provenance-watcher-threshold.json) — a proposed watcher threshold with semantic anchoring | [`annotation-provenance-reviewed-revision.json`](./v0.1/examples/annotation-provenance-reviewed-revision.json) — a human-reviewed accepted note that supersedes an earlier claim |
+
 ## The Vega-Lite binding (carrying IDID metadata on a portable spec)
 
 Vega-Lite is the closest thing the ecosystem has to a neutral chart-interchange format, but it has
@@ -98,8 +166,11 @@ namespaced key:
 }
 ```
 
-A consumer reads `spec.usermeta.idid.capability` and routes it straight into a chart-suggestion
-engine; the spec still renders as ordinary Vega-Lite everywhere else.
+A consumer reads `spec.usermeta.idid.capability` as the static scoring and communication metadata
+for its own chart implementation; the spec still renders as ordinary Vega-Lite everywhere else.
+A portable descriptor deliberately has no executable `fits` or `buildProps` functions. A host
+whose suggestion engine requires those functions must resolve the descriptor's `component` to a
+host implementation rather than inventing a permissive fit.
 
 ### Provenanced annotations → `usermeta.idid.annotations`
 
@@ -145,6 +216,27 @@ semantics. Unsupported composition or chart semantics must return a typed refusa
 plausible fallback. IDID-enriched annotation layers recover their one base view, while arbitrary
 Vega-Lite layer composition remains deliberately unsupported.
 
+## Appendix: typology crosswalk
+
+The core schemas are intentionally small. They carry axes that already have interoperable runtime
+behavior and leave organization- or domain-specific classifications in namespaced extension
+vocabularies. Because the three root schemas permit additional properties, a consumer can add one
+object such as `x-example-context` without pretending its local ontology is universal.
+
+| Typology axis | Where it lives in v0.1 | Core or extension? |
+|---|---|---|
+| Data/domain entity + scale | `ChartCapability.family`, `tags`, and `mobile` describe chart/rendering characteristics, not domain entities or scientific/organizational scale. Put entity types, units, granularity, and domain scale in a namespaced context object. | **Extension vocabulary.** Do not overload `family` with a domain ontology. |
+| Analytical task | `ChartCapability.intentScores`, keyed by open intent ids. The schema lists the reference implementation's 13 recognized tasks without closing the vocabulary. | **Core field; extensible values.** |
+| Communicative act | Some acts can be inferred by a host from the strongest analytical intent, but v0.1 has no separate act field for report, alert, explain, persuade, teach, and similar purposes. | **Extension vocabulary** when task and act differ. |
+| Audience role + literacy | `AudienceProfile.familiarity`, `targets`, and `exposureLevel` carry chart familiarity and governed literacy growth. Job/reader role, domain knowledge, and mastered visualization concepts are not core fields. | **Mixed:** chart familiarity/growth are core; role, domain literacy, and concept mastery are extensions. |
+| Reception modality | `AudienceProfile.receptionModality`: `visual`, `screen-reader`, `sonified`, or `agent`. | **Core field and closed vocabulary in v0.1.** |
+| Decision/use context | No core field. Put decision type, workflow stage, urgency, cadence, collaboration setting, or regulatory context in a namespaced context object. | **Extension vocabulary.** |
+| Provenance + lifecycle | An annotation's `provenance` records actor, evidence basis, confidence, time/data version, and stable identity; `lifecycle` records freshness, editorial status, supersession, TTL, and anchoring. | **Core fields.** Open source/basis labels permit local evidence vocabularies; freshness/status/anchor remain closed. |
+
+Extension vocabularies should be documented, versioned, and preserved verbatim by bindings. They
+should graduate into a future core schema only after more than one adopter needs interoperable
+behavior, not merely because one domain has a useful label.
+
 ---
 
 *This directory is the canonical published copy of the schemas and is packed unchanged into npm.

package/spec/bindings/README.md

@@ -17,17 +17,28 @@ meaning travel together.
 import {
   attachIdid, readIdid, attachIdidAnnotations, readIdidAnnotations,
   suggestionInputFromSpec,
-} from "./vega-lite.mjs"
+} from "semiotic/spec/bindings/vega-lite.mjs"
 
 let spec = { mark: "bar", encoding: { /* … */ } }
 spec = attachIdid(spec, { capability, audience })          // ride under usermeta.idid
 spec = attachIdidAnnotations(spec, [provenancedNote])       // + a note with its evidence
 
-// An IDID-aware host reads it back and acts on it — e.g. routes the carried
-// capability + audience through any chart-suggestion engine:
+// An IDID-aware host reads it back and acts on it:
 const input = suggestionInputFromSpec(spec)                 // { capability, audience } | null
 ```
 
+The binding is available from the npm package at
+`semiotic/spec/bindings/vega-lite.mjs`; the three schemas and six worked
+fixtures resolve under `semiotic/spec/v0.1/`.
+
+`suggestionInputFromSpec` extracts metadata; it does not invent executable
+chart behavior. The portable capability contains static rubric/intent metadata
+but deliberately omits host-specific `fits` and `buildProps` functions. A host
+with a suggestion engine that requires those functions must resolve
+`capability.component` to its own implementation before scoring it. This
+standalone binding refuses to assume that every carried chart fits every
+dataset.
+
 The output is byte-compatible with Semiotic's TypeScript binding
 (`semiotic/experimental`: `unstable_attachIDID`, `unstable_readIDID`,
 `unstable_attachIDIDAnnotations`, …), so a spec enriched in one can be read in

package/spec/v0.1/examples/annotation-provenance-reviewed-revision.json

@@ -0,0 +1,27 @@
+{
+  "type": "callout",
+  "x": "2026-07-25T14:18:00Z",
+  "y": 1280,
+  "label": "Database pool saturation confirmed after trace review.",
+  "provenance": {
+    "author": "operator-17",
+    "authorKind": "human",
+    "source": "user",
+    "basis": "manual-review",
+    "confidence": 1,
+    "createdAt": "2026-07-25T14:31:00Z",
+    "dataVersion": "incident-1842-window-8",
+    "stableId": "annotation:incident-1842:confirmed-cause"
+  },
+  "lifecycle": {
+    "freshness": "fresh",
+    "status": "accepted",
+    "supersedes": "annotation:incident-1842:suspected-cause",
+    "ttlHint": 86400000,
+    "anchor": "fixed"
+  },
+  "x-example-context": {
+    "review": "incident-1842-postmortem",
+    "decisionUse": "retain as the accepted causal note"
+  }
+}

package/spec/v0.1/examples/annotation-provenance-watcher-threshold.json

@@ -0,0 +1,21 @@
+{
+  "type": "y-threshold",
+  "value": 1000,
+  "label": "SLA breach threshold",
+  "provenance": {
+    "author": "latency-watcher",
+    "authorKind": "watcher",
+    "source": "computed",
+    "basis": "statistical-test",
+    "confidence": 0.82,
+    "createdAt": "2026-07-25T14:00:00Z",
+    "dataVersion": "incident-1842-window-7",
+    "stableId": "annotation:incident-1842:latency-threshold"
+  },
+  "lifecycle": {
+    "freshness": "fresh",
+    "status": "proposed",
+    "ttlHint": "PT6H",
+    "anchor": "semantic"
+  }
+}

package/spec/v0.1/examples/audience-profile-executive-review.json

@@ -0,0 +1,24 @@
+{
+  "specVersion": "0.1",
+  "name": "Quarterly executive review",
+  "familiarity": {
+    "BarChart": 5,
+    "LineChart": 5,
+    "PieChart": 5,
+    "BoxPlot": 2
+  },
+  "targets": {
+    "PieChart": {
+      "direction": "decrease",
+      "weight": 2,
+      "reason": "Prefer position and length when exact category comparison matters."
+    },
+    "BoxPlot": {
+      "direction": "increase",
+      "weight": 1,
+      "reason": "Build familiarity with distribution rather than reporting only averages."
+    }
+  },
+  "exposureLevel": 1,
+  "receptionModality": "visual"
+}

package/spec/v0.1/examples/audience-profile-incident-operators.json

@@ -0,0 +1,42 @@
+{
+  "specVersion": "0.1",
+  "name": "Incident review operators",
+  "familiarity": {
+    "LineChart": 5,
+    "Heatmap": 4,
+    "SankeyDiagram": 3,
+    "ForceDirectedGraph": 2
+  },
+  "targets": {
+    "SankeyDiagram": {
+      "direction": "increase",
+      "weight": 2,
+      "reason": "Practice tracing affected traffic through service dependencies."
+    }
+  },
+  "exposureLevel": 2,
+  "receptionModality": "screen-reader",
+  "x-example-context": {
+    "roles": [
+      "on-call operator",
+      "incident commander"
+    ],
+    "visualizationLiteracy": {
+      "mastered": [
+        "ordered-series",
+        "threshold"
+      ],
+      "learning": [
+        "flow"
+      ]
+    },
+    "domainKnowledge": [
+      "service topology",
+      "latency objectives"
+    ],
+    "useContext": {
+      "decision": "incident triage",
+      "cadence": "live"
+    }
+  }
+}

package/spec/v0.1/examples/chart-capability-bar-comparison.json

@@ -0,0 +1,48 @@
+{
+  "specVersion": "0.1",
+  "component": "BarChart",
+  "family": "categorical",
+  "importPath": "semiotic/ordinal",
+  "rubric": {
+    "familiarity": 5,
+    "accuracy": 5,
+    "precision": 4
+  },
+  "intentScores": {
+    "compare-categories": 5,
+    "rank": 4
+  },
+  "variants": [
+    {
+      "key": "ranked",
+      "label": "Ranked bars",
+      "description": "Sort categories by value when rank is the primary task.",
+      "intentDeltas": {
+        "rank": 1
+      },
+      "props": {
+        "sort": "descending"
+      }
+    }
+  ],
+  "caveats": [
+    "Dense category sets should be filtered or grouped before rendering."
+  ],
+  "mobile": {
+    "strategy": "direct-labels",
+    "responsive": true,
+    "breakpoints": [
+      480
+    ],
+    "maxMarks": 12,
+    "minimumHitTarget": 24,
+    "labels": {
+      "strategy": "direct",
+      "minFontSize": 12
+    }
+  },
+  "tags": [
+    "comparison",
+    "categorical"
+  ]
+}

package/spec/v0.1/examples/chart-capability-service-flow.json

@@ -0,0 +1,54 @@
+{
+  "specVersion": "0.1",
+  "component": "SankeyDiagram",
+  "family": "flow",
+  "importPath": "semiotic/network",
+  "rubric": {
+    "familiarity": 3,
+    "accuracy": 4,
+    "precision": 2
+  },
+  "intentScores": {
+    "flow": 5,
+    "change-detection": 3
+  },
+  "caveats": [
+    "Link width supports flow comparison but is not a precise lookup channel.",
+    "Cycles require a host-specific layout strategy."
+  ],
+  "mobile": {
+    "strategy": "summary-cards",
+    "responsive": true,
+    "minViewportWidth": 320,
+    "maxMarks": 40,
+    "summary": "Lead with the largest sources, destinations, and bottlenecks.",
+    "interaction": {
+      "primary": "select-flow",
+      "alternatives": [
+        "accessible-flow-table"
+      ],
+      "hoverFallback": "focus-or-tap",
+      "targetSize": 24
+    },
+    "custom": {
+      "dataBearingSceneNodes": true,
+      "stableIds": true,
+      "navigationGranularity": "source, target, then link"
+    }
+  },
+  "tags": [
+    "flow",
+    "operations"
+  ],
+  "x-example-context": {
+    "domainEntities": [
+      "service",
+      "request"
+    ],
+    "domainScale": {
+      "entityLevel": "service",
+      "measure": "requests-per-minute"
+    },
+    "communicativeAct": "diagnose"
+  }
+}