@fusion.dev/helix-headless 0.119.0 → 0.120.0

package/custom-elements.json

@@ -50631,6 +50631,40 @@
                 "text": "laidOut(positions: Record<string, { x: number; y: number }>) => void"
               }
             },
+            {
+              "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"
+              }
+            },
             {
               "kind": "method",
               "name": "panEvent",
@@ -52074,6 +52108,14 @@
               "name": "helix-graph-ready",
               "reactProp": "onhelix-graph-ready"
             },
+            {
+              "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"
+            },
             {
               "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-headless-heatmap': ['helix-resize'],

package/dist/graph/root/graph-root.d.ts

@@ -1,4 +1,4 @@
-import { HelixElement, type ViewportGestureLabels, type ViewportPanDetail, type ViewportZoomDetail } from '@fusion.dev/helix-core';
+import { type GraphSignalDetail, HelixElement, type ViewportGestureLabels, type ViewportPanDetail, type ViewportZoomDetail } from '@fusion.dev/helix-core';
 import { type PropertyValues, type TemplateResult } from 'lit';
 import { type GraphLink, type GraphNode } from './graph-model.js';
 declare const HelixHeadlessGraph_base: (new (...args: any[]) => import("@fusion.dev/helix-core").ViewportElement) & (new (...args: any[]) => import("@fusion.dev/helix-core").MixinControllerActiveInterface) & typeof HelixElement;
@@ -45,6 +45,7 @@ declare const HelixHeadlessGraph_base: (new (...args: any[]) => import("@fusion.
  * @event {HelixGraphPanEvent} helix-graph-pan - A pan button or arrow key was pressed. `connectGraph` moves the drawing.
  * @event {HelixGraphPartChangeEvent} 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.
  * @event {HelixGraphReadyEvent} 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.
+ * @event {HelixGraphSignalEvent} helix-graph-signal - Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it.
  * @event {HelixGraphZoomEvent} helix-graph-zoom - A zoom button or key was pressed. `connectGraph` zooms the drawing.
  *
  * @csspart after - The room the notes after those drawn would take, so the list scrolls its whole length.
@@ -157,6 +158,19 @@ export declare class HelixHeadlessGraph extends HelixHeadlessGraph_base {
         x: number;
         y: number;
     }>): 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.
+     */
+    signal(from: string, to: string, options?: {
+        tone?: GraphSignalDetail['tone'];
+    }): void;
     protected willUpdate(changed: PropertyValues): void;
     protected updated(changed: PropertyValues): void;
     protected panEvent(detail: ViewportPanDetail): Event;

package/dist/graph/root/graph-root.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { customElement, fillTemplate, formatNumbers, HelixElement, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphZoomEvent, MixinControllerActive, MixinViewport, VirtualizeController, } from '@fusion.dev/helix-core';
+import { customElement, fillTemplate, formatNumbers, HelixElement, HelixGraphLayoutEvent, HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphReadyEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, MixinControllerActive, MixinViewport, VirtualizeController, } from '@fusion.dev/helix-core';
 import { magnifyingGlass } from '@fusion.dev/helix-icons';
 import { html, nothing } from 'lit';
 import { property, state } from 'lit/decorators.js';
@@ -98,6 +98,9 @@ let HelixHeadlessGraph = class HelixHeadlessGraph extends MixinViewport(MixinCon
     laidOut(positions) {
         this.dispatchEvent(new HelixGraphLayoutEvent({ positions }));
     }
+    signal(from, to, options = {}) {
+        this.dispatchEvent(new HelixGraphSignalEvent({ from, to, tone: options.tone }));
+    }
     willUpdate(changed) {
         super.willUpdate(changed);
         this.toggleState('fullscreen', this.filled);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-headless",
   "description": "Headless component tier. Structure, accessibility, state, and form participation. No styling.",
-  "version": "0.119.0",
+  "version": "0.120.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -46,13 +46,13 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.119.0",
-    "@fusion.dev/helix-icons": "0.119.0",
+    "@fusion.dev/helix-core": "0.120.0",
+    "@fusion.dev/helix-icons": "0.120.0",
     "uqr": "^0.1.3"
   },
   "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

@@ -40,6 +40,7 @@ import type {
   HelixGraphPanEvent,
   HelixGraphPartChangeEvent,
   HelixGraphReadyEvent,
+  HelixGraphSignalEvent,
   HelixGraphZoomEvent,
   HelixHeadlessAccordion,
   HelixHeadlessAccordionItem,
@@ -9386,6 +9387,9 @@ export type HelixHeadlessGraphHelixGraphPartChangeElementEvent =
 /** `helix-graph-ready` event type */
 export type HelixHeadlessGraphHelixGraphReadyElementEvent =
   HelixHeadlessGraphElementEvent<HelixGraphReadyEvent>;
+/** `helix-graph-signal` event type */
+export type HelixHeadlessGraphHelixGraphSignalElementEvent =
+  HelixHeadlessGraphElementEvent<HelixGraphSignalEvent>;
 /** `helix-graph-zoom` event type */
 export type HelixHeadlessGraphHelixGraphZoomElementEvent =
   HelixHeadlessGraphElementEvent<HelixGraphZoomEvent>;
@@ -9641,6 +9645,10 @@ Ignored once `active` is written. */
   "onhelix-graph-ready"?: ((
     e: HelixHeadlessGraphHelixGraphReadyElementEvent,
   ) => 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: HelixHeadlessGraphHelixGraphSignalElementEvent,
+  ) => void) | undefined;
   /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "onhelix-graph-zoom"?: ((
     e: HelixHeadlessGraphHelixGraphZoomElementEvent,
@@ -9899,6 +9907,10 @@ Ignored once `active` is written. */
   "on:helix-graph-ready"?: ((
     e: HelixHeadlessGraphHelixGraphReadyElementEvent,
   ) => 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: HelixHeadlessGraphHelixGraphSignalElementEvent,
+  ) => void) | undefined;
   /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "on:helix-graph-zoom"?: ((
     e: HelixHeadlessGraphHelixGraphZoomElementEvent,
@@ -31390,6 +31402,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
@@ -31414,6 +31427,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.
    * - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
    * - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
    * - `toggleFullscreen() => void`: Turns fullscreen on or off.
@@ -51758,6 +51779,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
@@ -51782,6 +51804,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.
    * - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
    * - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
    * - `toggleFullscreen() => void`: Turns fullscreen on or off.

package/types/vue.d.ts

@@ -200,6 +200,7 @@ import type {
   HelixGraphPanEvent,
   HelixGraphPartChangeEvent,
   HelixGraphReadyEvent,
+  HelixGraphSignalEvent,
   HelixGraphZoomEvent,
   HelixResizeEvent,
   HelixShortcutEvent,
@@ -4822,6 +4823,9 @@ export type HelixHeadlessGraphHelixGraphPartChangeElementEvent =
 /** `helix-graph-ready` event type */
 export type HelixHeadlessGraphHelixGraphReadyElementEvent =
   HelixHeadlessGraphElementEvent<HelixGraphReadyEvent>;
+/** `helix-graph-signal` event type */
+export type HelixHeadlessGraphHelixGraphSignalElementEvent =
+  HelixHeadlessGraphElementEvent<HelixGraphSignalEvent>;
 /** `helix-graph-zoom` event type */
 export type HelixHeadlessGraphHelixGraphZoomElementEvent =
   HelixHeadlessGraphElementEvent<HelixGraphZoomEvent>;
@@ -5069,6 +5073,8 @@ export type HelixHeadlessGraphVueEvents = {
   "helix-graph-part-change": HelixHeadlessGraphHelixGraphPartChangeElementEvent;
   /** 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": HelixHeadlessGraphHelixGraphReadyElementEvent;
+  /** Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it. */
+  "helix-graph-signal": HelixHeadlessGraphHelixGraphSignalElementEvent;
   /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
   "helix-graph-zoom": HelixHeadlessGraphHelixGraphZoomElementEvent;
 };