@pihanga2/shadcn 0.2.23 → 0.2.25

package/cards.schema.json

@@ -1,6 +1,6 @@
 {
   "library": "@pihanga2/shadcn",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "generatedBy": "scripts/schema/extract-card-schemas.mjs",
   "cards": {
     "empty-card": {
@@ -4861,8 +4861,8 @@
           "description": "Field name, mirrors the `name` prop if provided."
         },
         "value": {
-          "type": "number",
-          "description": "New numeric value after the change."
+          "$ref": "#/definitions/PiSliderValue",
+          "description": "New scalar or range value after the change."
         }
       },
       "required": [
@@ -4877,8 +4877,8 @@
           "description": "Field name, mirrors the `name` prop if provided."
         },
         "value": {
-          "type": "number",
-          "description": "Final settled value when the user released the thumb."
+          "$ref": "#/definitions/PiSliderValue",
+          "description": "Final settled scalar or range value when the user released a thumb."
         }
       },
       "required": [
@@ -4893,11 +4893,11 @@
           "description": "Field name used to bind to FormContext when inside a pi/form card. When provided the component reads its value from form data and writes back via form.handleChange."
         },
         "value": {
-          "type": "number",
-          "description": "Controlled numeric value (single thumb). Ignored when `name` is set and the component is inside a pi/form, and also ignored when `selfManaged` is true (use `defaultValue` instead)."
+          "$ref": "#/definitions/PiSliderValue",
+          "description": "Controlled value. A number renders one thumb; a tuple renders two thumbs with the selected range highlighted between them. Ignored when `name` is set and the component is inside a pi/form, and also ignored when `selfManaged` is true (use `defaultValue` instead)."
         },
         "defaultValue": {
-          "type": "number",
+          "$ref": "#/definitions/PiSliderValue",
           "description": "Initial value used when `selfManaged` is true. Falls back to `value` → `min` → 0 if not provided."
         },
         "selfManaged": {
@@ -4916,6 +4916,10 @@
           "type": "number",
           "description": "Stepping interval between selectable values. Defaults to 1."
         },
+        "minStepsBetweenThumbs": {
+          "type": "number",
+          "description": "Minimum permitted distance between two thumbs, measured in `step` increments. Only applies when `value` is a range."
+        },
         "disabled": {
           "type": "boolean",
           "description": "When true, the slider is disabled and non-interactive."
@@ -4961,6 +4965,22 @@
         }
       }
     },
+    "PiSliderValue": {
+      "anyOf": [
+        {
+          "type": "number"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "minItems": 2,
+          "maxItems": 2
+        }
+      ],
+      "description": "A single selected value or an inclusive two-thumb range."
+    },
     "PiSliderValueProps": {
       "type": "object",
       "properties": {
@@ -6044,6 +6064,16 @@
           "type": "string",
           "description": "For a hovered transition: call id of the caller-side process (activity) that sent the call and receives its reply. That activity is highlighted."
         },
+        "steps": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SwimlaneRow"
+          },
+          "description": "For `target.kind === \"step\"`: every row belonging to that step."
+        },
+        "meta": {
+          "description": "Caller `meta` for the target, if any was set on the originating event: the `call`'s `meta` for `transition`/`activity`/`pending`, the `state` event's `meta` for `state`, the `lane` event's `meta` for `lane`. Not set for `step` (see `steps`, which carries each row's own event/meta)."
+        },
         "clientX": {
           "type": "number"
         },
@@ -6076,6 +6106,16 @@
         },
         "process": {
           "type": "string"
+        },
+        "steps": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SwimlaneRow"
+          },
+          "description": "For `target.kind === \"step\"`: every row belonging to that step."
+        },
+        "meta": {
+          "description": "See `SwimlaneHoverChangedEvent.meta`."
         }
       },
       "required": [
@@ -6125,6 +6165,25 @@
           },
           "description": "Optional display names."
         },
+        "laneMeta": {
+          "type": "object",
+          "additionalProperties": {},
+          "description": "Caller `meta` from each lane's `lane` event(s), most recent wins."
+        },
+        "laneActivityClassName": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "`activityClassName` from each lane's `lane` event(s)/seed, most recent wins."
+        },
+        "laneActivityStyle": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/ReactValue"
+          },
+          "description": "`activityStyle` from each lane's `lane` event(s)/seed, most recent wins."
+        },
         "current": {
           "$ref": "#/definitions/SwimlaneLanesSnapshot",
           "description": "Current snapshot (== `post` of the last row)."
@@ -6159,6 +6218,9 @@
       "required": [
         "laneOrder",
         "laneLabels",
+        "laneMeta",
+        "laneActivityClassName",
+        "laneActivityStyle",
         "current",
         "rows",
         "pending",
@@ -6195,6 +6257,9 @@
         },
         "timeoutMs": {
           "type": "number"
+        },
+        "meta": {
+          "description": "Copied from the originating `call` (implied reply) or `expect` event."
         }
       },
       "required": [
@@ -6254,8 +6319,20 @@
           "type": "number",
           "description": "Clock (epoch ms) used for \"waiting …\" timers and overdue detection of outstanding messages. When omitted the card ticks its own wall clock (4×/s, only while something is outstanding). Pass it to drive the card entirely from props — e.g. for replaying a recorded trace or for tests."
         },
+        "formatTs": {
+          "not": {},
+          "description": "Formats the timestamp column (`ts`, epoch ms). Defaults to `formatTs` from `swimlane.model` (local wall-clock `HH:MM:SS.mmm`). Override to show a different clock — e.g. a virtual time derived from `ts`, or both virtual and wall-clock time in one string."
+        },
+        "formatWait": {
+          "not": {},
+          "description": "Formats the \"waiting …\" duration (ms) shown on outstanding messages below the \"now\" line. Defaults to `${(ms / 1000).toFixed(1)}s`."
+        },
         "className": {
           "type": "string"
+        },
+        "style": {
+          "$ref": "#/definitions/ReactValue",
+          "description": "Inline styles for the card's root element, alongside `className`."
         }
       },
       "required": [
@@ -6266,7 +6343,8 @@
       "type": "object",
       "properties": {
         "id": {
-          "type": "number"
+          "$ref": "#/definitions/SwimlaneRowId",
+          "description": "The event's own `rowId` when it was set and did not collide with an existing row; an internally assigned number otherwise. See `SwimlaneEventBase.rowId`."
         },
         "event": {
           "$ref": "#/definitions/SwimlaneRowEvent"
@@ -6330,9 +6408,35 @@
               "type": "string",
               "description": "Display name (defaults to `lane`)."
             },
+            "activityClassName": {
+              "type": "string",
+              "description": "Extra class(es) added to this lane's activity bar (the `<g className=\"swl-act\">` drawn on the lifeline while the lane is handling a call), alongside the default `swl-act`/highlight classes. Use this to give different lane\n*types* their own themed colour via CSS (e.g. `.swl-act-tool rect { fill: var(--my-tool-color); }`) instead of hard-coding colours per lane. Most recent `lane` event for a lane wins, same as `label`/`meta`."
+            },
+            "activityStyle": {
+              "$ref": "#/definitions/ReactValue",
+              "description": "Inline style merged onto the activity bar's `<rect>` (fill) and `<path>` (border) elements, for one-off colours that don't warrant a CSS class. Takes precedence over `activityClassName`'s rules for any property it sets. Most recent `lane` event for a lane wins, same as `label`/`meta`."
+            },
+            "announce": {
+              "type": "boolean",
+              "description": "When `false`, this event still registers the lane (and updates its label/meta/activity style exactly as usual) but produces no row — as if the lane had been present from the start via `createSwimlaneModel({lanes})`. Only has an effect the first time a lane is seen: a later `lane` event for an already-known lane never produces a row regardless of `announce` (same as today), so there is no way to retroactively force a \"joined\" row to appear for a lane once it is known. Default `true`."
+            },
             "fulfils": {
               "type": "string",
               "description": "Id of an `expect` event that this real event resolves."
+            },
+            "rowId": {
+              "$ref": "#/definitions/SwimlaneRowId",
+              "description": "Use this as the resulting row's id instead of the model's internal counter. Lets a caller that rebuilds the whole model from scratch on every refresh (e.g. to replay a run, or after a rollback to an earlier point) keep row ids stable across rebuilds, instead of them being renumbered each time.\n\nContract: must be unique among the model's current rows (an id freed by ring-buffer trimming may be reused). If it collides with an existing row, the card falls back to an internal id for that row rather than producing two rows with the same id — check `SwimlaneRow.id` if you need to confirm which id was actually used.\n\nDistinct from a `call`/`reply`/`done` event's own `id` (the call id, shared between its call and reply rows) — `rowId` identifies one row."
+            },
+            "step": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Groups events that belong to one logical step (for example several calls and a state change produced by a single engine tick). Rows are grouped only when adjacent in `rows` (ingest order): the card draws the timestamp for the first row of a run of same-`step` rows and replaces it with a connecting mark on the rest, joining them into one block. Comparison is `===`; omit it to draw every row on its own line as before."
+            },
+            "meta": {
+              "description": "Arbitrary caller data, opaque to the card. Carried onto the row (and, for `call`/`expect` events, the resulting span/pending message) and echoed back verbatim in `onHoverChanged` / `onItemClicked` for that target — so the caller does not need a side table to recover context (e.g. which domain object a row/span id stands for) on every hover or click. Not interpreted or serialised specially by the card."
             }
           },
           "required": [
@@ -6358,9 +6462,27 @@
             "state": {
               "$ref": "#/definitions/SwimlaneRunState"
             },
+            "showLabel": {
+              "type": "boolean",
+              "description": "Draw the \"→ state\" text beside the dot. Default `true`."
+            },
             "fulfils": {
               "type": "string",
               "description": "Id of an `expect` event that this real event resolves."
+            },
+            "rowId": {
+              "$ref": "#/definitions/SwimlaneRowId",
+              "description": "Use this as the resulting row's id instead of the model's internal counter. Lets a caller that rebuilds the whole model from scratch on every refresh (e.g. to replay a run, or after a rollback to an earlier point) keep row ids stable across rebuilds, instead of them being renumbered each time.\n\nContract: must be unique among the model's current rows (an id freed by ring-buffer trimming may be reused). If it collides with an existing row, the card falls back to an internal id for that row rather than producing two rows with the same id — check `SwimlaneRow.id` if you need to confirm which id was actually used.\n\nDistinct from a `call`/`reply`/`done` event's own `id` (the call id, shared between its call and reply rows) — `rowId` identifies one row."
+            },
+            "step": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Groups events that belong to one logical step (for example several calls and a state change produced by a single engine tick). Rows are grouped only when adjacent in `rows` (ingest order): the card draws the timestamp for the first row of a run of same-`step` rows and replaces it with a connecting mark on the rest, joining them into one block. Comparison is `===`; omit it to draw every row on its own line as before."
+            },
+            "meta": {
+              "description": "Arbitrary caller data, opaque to the card. Carried onto the row (and, for `call`/`expect` events, the resulting span/pending message) and echoed back verbatim in `onHoverChanged` / `onItemClicked` for that target — so the caller does not need a side table to recover context (e.g. which domain object a row/span id stands for) on every hover or click. Not interpreted or serialised specially by the card."
             }
           },
           "required": [
@@ -6408,6 +6530,20 @@
             "fulfils": {
               "type": "string",
               "description": "Id of an `expect` event that this real event resolves."
+            },
+            "rowId": {
+              "$ref": "#/definitions/SwimlaneRowId",
+              "description": "Use this as the resulting row's id instead of the model's internal counter. Lets a caller that rebuilds the whole model from scratch on every refresh (e.g. to replay a run, or after a rollback to an earlier point) keep row ids stable across rebuilds, instead of them being renumbered each time.\n\nContract: must be unique among the model's current rows (an id freed by ring-buffer trimming may be reused). If it collides with an existing row, the card falls back to an internal id for that row rather than producing two rows with the same id — check `SwimlaneRow.id` if you need to confirm which id was actually used.\n\nDistinct from a `call`/`reply`/`done` event's own `id` (the call id, shared between its call and reply rows) — `rowId` identifies one row."
+            },
+            "step": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Groups events that belong to one logical step (for example several calls and a state change produced by a single engine tick). Rows are grouped only when adjacent in `rows` (ingest order): the card draws the timestamp for the first row of a run of same-`step` rows and replaces it with a connecting mark on the rest, joining them into one block. Comparison is `===`; omit it to draw every row on its own line as before."
+            },
+            "meta": {
+              "description": "Arbitrary caller data, opaque to the card. Carried onto the row (and, for `call`/`expect` events, the resulting span/pending message) and echoed back verbatim in `onHoverChanged` / `onItemClicked` for that target — so the caller does not need a side table to recover context (e.g. which domain object a row/span id stands for) on every hover or click. Not interpreted or serialised specially by the card."
             }
           },
           "required": [
@@ -6444,6 +6580,20 @@
             "fulfils": {
               "type": "string",
               "description": "Id of an `expect` event that this real event resolves."
+            },
+            "rowId": {
+              "$ref": "#/definitions/SwimlaneRowId",
+              "description": "Use this as the resulting row's id instead of the model's internal counter. Lets a caller that rebuilds the whole model from scratch on every refresh (e.g. to replay a run, or after a rollback to an earlier point) keep row ids stable across rebuilds, instead of them being renumbered each time.\n\nContract: must be unique among the model's current rows (an id freed by ring-buffer trimming may be reused). If it collides with an existing row, the card falls back to an internal id for that row rather than producing two rows with the same id — check `SwimlaneRow.id` if you need to confirm which id was actually used.\n\nDistinct from a `call`/`reply`/`done` event's own `id` (the call id, shared between its call and reply rows) — `rowId` identifies one row."
+            },
+            "step": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Groups events that belong to one logical step (for example several calls and a state change produced by a single engine tick). Rows are grouped only when adjacent in `rows` (ingest order): the card draws the timestamp for the first row of a run of same-`step` rows and replaces it with a connecting mark on the rest, joining them into one block. Comparison is `===`; omit it to draw every row on its own line as before."
+            },
+            "meta": {
+              "description": "Arbitrary caller data, opaque to the card. Carried onto the row (and, for `call`/`expect` events, the resulting span/pending message) and echoed back verbatim in `onHoverChanged` / `onItemClicked` for that target — so the caller does not need a side table to recover context (e.g. which domain object a row/span id stands for) on every hover or click. Not interpreted or serialised specially by the card."
             }
           },
           "required": [
@@ -6471,6 +6621,20 @@
             "fulfils": {
               "type": "string",
               "description": "Id of an `expect` event that this real event resolves."
+            },
+            "rowId": {
+              "$ref": "#/definitions/SwimlaneRowId",
+              "description": "Use this as the resulting row's id instead of the model's internal counter. Lets a caller that rebuilds the whole model from scratch on every refresh (e.g. to replay a run, or after a rollback to an earlier point) keep row ids stable across rebuilds, instead of them being renumbered each time.\n\nContract: must be unique among the model's current rows (an id freed by ring-buffer trimming may be reused). If it collides with an existing row, the card falls back to an internal id for that row rather than producing two rows with the same id — check `SwimlaneRow.id` if you need to confirm which id was actually used.\n\nDistinct from a `call`/`reply`/`done` event's own `id` (the call id, shared between its call and reply rows) — `rowId` identifies one row."
+            },
+            "step": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Groups events that belong to one logical step (for example several calls and a state change produced by a single engine tick). Rows are grouped only when adjacent in `rows` (ingest order): the card draws the timestamp for the first row of a run of same-`step` rows and replaces it with a connecting mark on the rest, joining them into one block. Comparison is `===`; omit it to draw every row on its own line as before."
+            },
+            "meta": {
+              "description": "Arbitrary caller data, opaque to the card. Carried onto the row (and, for `call`/`expect` events, the resulting span/pending message) and echoed back verbatim in `onHoverChanged` / `onItemClicked` for that target — so the caller does not need a side table to recover context (e.g. which domain object a row/span id stands for) on every hover or click. Not interpreted or serialised specially by the card."
             }
           },
           "required": [
@@ -6482,6 +6646,13 @@
       ],
       "description": "A row event is any stream event except `expect` (which never makes a row)."
     },
+    "SwimlaneRowId": {
+      "type": [
+        "string",
+        "number"
+      ],
+      "description": "Row id: either an internal counter value, or a caller-supplied value (see `rowId`)."
+    },
     "SwimlaneRunState": {
       "type": "string",
       "enum": [
@@ -6489,9 +6660,12 @@
         "starting",
         "running",
         "degraded",
-        "stopped"
+        "stopped",
+        "in_progress",
+        "succeeded",
+        "failed"
       ],
-      "description": "Run state of a service, drawn on its lifeline."
+      "description": "Run state of a service, drawn on its lifeline.\n\n`created` … `stopped` describe a long-running service's lifecycle. `in_progress` / `succeeded` / `failed` are first-class outcome states for one-shot work (e.g. a tool call or task) that does not fit that lifecycle — use these instead of borrowing `running` / `stopped` / `degraded`."
     },
     "SwimlaneSpan": {
       "type": "object",
@@ -6532,6 +6706,9 @@
         "parent": {
           "type": "string",
           "description": "Call whose processing caused this one (explicit `parentId` or inferred)."
+        },
+        "meta": {
+          "description": "Copied from the originating `call` event."
         }
       },
       "required": [
@@ -6553,13 +6730,13 @@
         },
         "id": {
           "type": "string",
-          "description": "Call id (transition/activity/pending) or `state-<rowId>` (state)."
+          "description": "Call id (`transition`/`activity`/`pending`), `state-<rowId>` (`state`), the row's `step` value stringified (`step`), or the lane id (`lane`)."
         },
         "lane": {
           "type": "string"
         },
         "rowId": {
-          "type": "number"
+          "$ref": "#/definitions/SwimlaneRowId"
         }
       },
       "required": [
@@ -6573,7 +6750,9 @@
         "transition",
         "activity",
         "state",
-        "pending"
+        "pending",
+        "step",
+        "lane"
       ],
       "description": "What the pointer is over."
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pihanga2/shadcn",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "description": "Pihanga core card components built on shadcn/ui and Radix UI — the npm distribution of pihanga-shadcn.",
   "type": "module",
   "exports": {