@fusion.dev/helix 0.119.0 → 0.120.0

package/custom-elements.json

@@ -63290,6 +63290,44 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "signal",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "from",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "to",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "{ tone?: GraphSignalDetail['tone'] }"
+                  }
+                }
+              ],
+              "description": "Shows something passing from one note to another, such as a message, a\nrequest or a payment, drawn traveling along the drawing and arriving with\na pulse. `tone` says what it means and colors it. Call it as often as\nthings happen; each call is one signal.\n\n**Drawn, and never said.** A signal is motion in the drawing, which a\nscreen reader does not hear: where what passed matters to a reader, say it\nin the page's own words as well.",
+              "type": {
+                "text": "signal(from: string, to: string, options: { tone?: GraphSignalDetail['tone'] } = {}) => void"
+              },
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "countText",
@@ -63785,7 +63823,7 @@
                 "slug": "preview"
               },
               {
-                "description": "A graph of company notes drawn by Sigma.js and laid out by ForceAtlas2, with the list beside it.",
+                "description": "A graph of company notes drawn by Sigma.js, with notes arriving and messages passing between them as they happen.",
                 "slug": "live"
               }
             ],
@@ -64222,6 +64260,18 @@
                 "module": "src/graph/root/graph-root.ts"
               }
             },
+            {
+              "type": {
+                "text": "HelixGraphSignalEvent"
+              },
+              "description": "Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it.",
+              "name": "helix-graph-signal",
+              "reactProp": "onhelix-graph-signal",
+              "inheritedFrom": {
+                "name": "HelixHeadlessGraph",
+                "module": "src/graph/root/graph-root.ts"
+              }
+            },
             {
               "type": {
                 "text": "HelixGraphZoomEvent"

package/dist/element-events.generated.js

@@ -94,6 +94,7 @@ registerElementEvents({
         'helix-graph-pan',
         'helix-graph-part-change',
         'helix-graph-ready',
+        'helix-graph-signal',
         'helix-graph-zoom',
     ],
     'helix-heatmap': ['helix-resize'],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix",
   "description": "Styled component tier. Extends the headless tier with token-driven presentation.",
-  "version": "0.119.0",
+  "version": "0.120.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -51,13 +51,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.119.0",
-    "@fusion.dev/helix-headless": "0.119.0",
-    "@fusion.dev/helix-styles": "0.119.0"
+    "@fusion.dev/helix-core": "0.120.0",
+    "@fusion.dev/helix-headless": "0.120.0",
+    "@fusion.dev/helix-styles": "0.120.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.119.0",
-    "@fusion.dev/helix-testing": "0.119.0",
+    "@fusion.dev/helix-cem": "0.120.0",
+    "@fusion.dev/helix-testing": "0.120.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^4.1.0",

package/types/jsx.d.ts

@@ -87,6 +87,7 @@ import type {
   HelixGraphPanEvent,
   HelixGraphPartChangeEvent,
   HelixGraphReadyEvent,
+  HelixGraphSignalEvent,
   HelixGraphZoomEvent,
   HelixGrid,
   HelixHeadlessFilterField,
@@ -11118,6 +11119,9 @@ export type HelixGraphHelixGraphPartChangeElementEvent =
 /** `helix-graph-ready` event type */
 export type HelixGraphHelixGraphReadyElementEvent =
   HelixGraphElementEvent<HelixGraphReadyEvent>;
+/** `helix-graph-signal` event type */
+export type HelixGraphHelixGraphSignalElementEvent =
+  HelixGraphElementEvent<HelixGraphSignalEvent>;
 /** `helix-graph-zoom` event type */
 export type HelixGraphHelixGraphZoomElementEvent =
   HelixGraphElementEvent<HelixGraphZoomEvent>;
@@ -11367,6 +11371,8 @@ Required. */
   ) => void) | undefined;
   /** The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not. */
   "onhelix-graph-ready"?: ((e: HelixGraphHelixGraphReadyElementEvent) => void) | undefined;
+  /** Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it. */
+  "onhelix-graph-signal"?: ((e: HelixGraphHelixGraphSignalElementEvent) => void) | undefined;
   /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "onhelix-graph-zoom"?: ((e: HelixGraphHelixGraphZoomElementEvent) => void) | undefined;
 };
@@ -11615,6 +11621,8 @@ Required. */
   ) => void) | undefined;
   /** The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not. */
   "on:helix-graph-ready"?: ((e: HelixGraphHelixGraphReadyElementEvent) => void) | undefined;
+  /** Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it. */
+  "on:helix-graph-signal"?: ((e: HelixGraphHelixGraphSignalElementEvent) => void) | undefined;
   /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "on:helix-graph-zoom"?: ((e: HelixGraphHelixGraphZoomElementEvent) => void) | undefined;
 
@@ -35622,6 +35630,7 @@ export type CustomElements = {
    * - `helix-graph-pan`: A pan button or arrow key was pressed. `connectGraph` moves the drawing.
    * - `helix-graph-part-change`: The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
    * - `helix-graph-ready`: The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not.
+   * - `helix-graph-signal`: Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it.
    * - `helix-graph-zoom`: A zoom button or key was pressed. `connectGraph` zooms the drawing.
    *
    * ## Slots
@@ -35657,6 +35666,14 @@ export type CustomElements = {
    * `helix-graph-layout` for the page to keep. Called by `connectGraph` once
    * its layout has settled; a page laying out its own graph calls it the same
    * way.
+   * - `signal(from: string, to: string, options: { tone?: GraphSignalDetail['tone'] } = {}) => void`: Shows something passing from one note to another, such as a message, a
+   * request or a payment, drawn traveling along the drawing and arriving with
+   * a pulse. `tone` says what it means and colors it. Call it as often as
+   * things happen; each call is one signal.
+   *
+   * **Drawn, and never said.** A signal is motion in the drawing, which a
+   * screen reader does not hear: where what passed matters to a reader, say it
+   * in the page's own words as well.
    *
    * ## CSS Custom Properties
    *
@@ -57902,6 +57919,7 @@ export type CustomElementsSolidJs = {
    * - `helix-graph-pan`: A pan button or arrow key was pressed. `connectGraph` moves the drawing.
    * - `helix-graph-part-change`: The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
    * - `helix-graph-ready`: The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not.
+   * - `helix-graph-signal`: Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it.
    * - `helix-graph-zoom`: A zoom button or key was pressed. `connectGraph` zooms the drawing.
    *
    * ## Slots
@@ -57937,6 +57955,14 @@ export type CustomElementsSolidJs = {
    * `helix-graph-layout` for the page to keep. Called by `connectGraph` once
    * its layout has settled; a page laying out its own graph calls it the same
    * way.
+   * - `signal(from: string, to: string, options: { tone?: GraphSignalDetail['tone'] } = {}) => void`: Shows something passing from one note to another, such as a message, a
+   * request or a payment, drawn traveling along the drawing and arriving with
+   * a pulse. `tone` says what it means and colors it. Call it as often as
+   * things happen; each call is one signal.
+   *
+   * **Drawn, and never said.** A signal is motion in the drawing, which a
+   * screen reader does not hear: where what passed matters to a reader, say it
+   * in the page's own words as well.
    *
    * ## CSS Custom Properties
    *

package/types/vue.d.ts

@@ -192,6 +192,7 @@ import type {
   HelixGraphPanEvent,
   HelixGraphPartChangeEvent,
   HelixGraphReadyEvent,
+  HelixGraphSignalEvent,
   HelixGraphZoomEvent,
   HelixResizeEvent,
   HelixShortcutEvent,
@@ -5714,6 +5715,9 @@ export type HelixGraphHelixGraphPartChangeElementEvent =
 /** `helix-graph-ready` event type */
 export type HelixGraphHelixGraphReadyElementEvent =
   HelixGraphElementEvent<HelixGraphReadyEvent>;
+/** `helix-graph-signal` event type */
+export type HelixGraphHelixGraphSignalElementEvent =
+  HelixGraphElementEvent<HelixGraphSignalEvent>;
 /** `helix-graph-zoom` event type */
 export type HelixGraphHelixGraphZoomElementEvent =
   HelixGraphElementEvent<HelixGraphZoomEvent>;
@@ -5961,6 +5965,8 @@ export type HelixGraphVueEvents = {
   "helix-graph-part-change": HelixGraphHelixGraphPartChangeElementEvent;
   /** The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not. */
   "helix-graph-ready": HelixGraphHelixGraphReadyElementEvent;
+  /** Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it. */
+  "helix-graph-signal": HelixGraphHelixGraphSignalElementEvent;
   /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "helix-graph-zoom": HelixGraphHelixGraphZoomElementEvent;
 };