@fusion.dev/helix-headless 0.121.0 → 0.122.0

package/custom-elements.json

@@ -50654,13 +50654,13 @@
                 {
                   "name": "positions",
                   "type": {
-                    "text": "Record<string, { x: number; y: number }>"
+                    "text": "Record<string, { x: number; y: number; z?: number | undefined }>"
                   }
                 }
               ],
               "description": "Says where a layout put each note, by its `id`: sends\n`helix-graph-layout` for the page to keep. Called by `connectGraph` once\nits layout has settled; a page laying out its own graph calls it the same\nway.",
               "type": {
-                "text": "laidOut(positions: Record<string, { x: number; y: number }>) => void"
+                "text": "laidOut(positions: Record<string, { x: number; y: number; z?: number | undefined }>) => void"
               }
             },
             {
@@ -52112,7 +52112,7 @@
               "type": {
                 "text": "HelixGraphLayoutEvent"
               },
-              "description": "A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`.",
+              "description": "A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions.",
               "name": "helix-graph-layout",
               "reactProp": "onhelix-graph-layout"
             },

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

@@ -38,6 +38,8 @@ export interface GraphNode {
     x?: number | undefined;
     /** Where the note stands, where the page already knows. Laid out where it does not. */
     y?: number | undefined;
+    /** How near the viewer the note stands, for a renderer that draws in three dimensions. */
+    z?: number | undefined;
 }
 /** One link between two notes, from `source` to `target`. */
 export interface GraphLink {

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

@@ -41,7 +41,7 @@ declare const HelixHeadlessGraph_base: (new (...args: any[]) => import("@fusion.
  *
  * @event {HelixActivateEvent} helix-activate - A note was selected, in the list or in the drawing. The detail's `value` is its `id`.
  * @event {HelixBeforeActivateEvent} helix-before-activate - A note is about to be selected. Cancelable: cancel it to keep the selection in your own state.
- * @event {HelixGraphLayoutEvent} helix-graph-layout - A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`.
+ * @event {HelixGraphLayoutEvent} helix-graph-layout - A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions.
  * @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.
@@ -157,6 +157,7 @@ export declare class HelixHeadlessGraph extends HelixHeadlessGraph_base {
     laidOut(positions: Record<string, {
         x: number;
         y: number;
+        z?: number | undefined;
     }>): void;
     /**
      * Shows something passing from one note to another, such as a message, a

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.121.0",
+  "version": "0.122.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.121.0",
-    "@fusion.dev/helix-icons": "0.121.0",
+    "@fusion.dev/helix-core": "0.122.0",
+    "@fusion.dev/helix-icons": "0.122.0",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.121.0",
-    "@fusion.dev/helix-testing": "0.121.0",
+    "@fusion.dev/helix-cem": "0.122.0",
+    "@fusion.dev/helix-testing": "0.122.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

@@ -9629,7 +9629,7 @@ Ignored once `active` is written. */
   "onhelix-before-activate"?: ((
     e: HelixHeadlessGraphHelixBeforeActivateElementEvent,
   ) => void) | undefined;
-  /** A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`. */
+  /** A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions. */
   "onhelix-graph-layout"?: ((
     e: HelixHeadlessGraphHelixGraphLayoutElementEvent,
   ) => void) | undefined;
@@ -9891,7 +9891,7 @@ Ignored once `active` is written. */
   "on:helix-before-activate"?: ((
     e: HelixHeadlessGraphHelixBeforeActivateElementEvent,
   ) => void) | undefined;
-  /** A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`. */
+  /** A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions. */
   "on:helix-graph-layout"?: ((
     e: HelixHeadlessGraphHelixGraphLayoutElementEvent,
   ) => void) | undefined;
@@ -31398,7 +31398,7 @@ export type CustomElements = {
    *
    * - `helix-activate`: A note was selected, in the list or in the drawing. The detail's `value` is its `id`.
    * - `helix-before-activate`: A note is about to be selected. Cancelable: cancel it to keep the selection in your own state.
-   * - `helix-graph-layout`: A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`.
+   * - `helix-graph-layout`: A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions.
    * - `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.
@@ -31423,7 +31423,7 @@ export type CustomElements = {
    * its own graph calls it when that graph is finished. The first call after
    * the graph was not drawn sends `helix-graph-ready` and turns on
    * `:state(ready)`.
-   * - `laidOut(positions: Record<string, { x: number; y: number }>) => void`: Says where a layout put each note, by its `id`: sends
+   * - `laidOut(positions: Record<string, { x: number; y: number; z?: number | undefined }>) => void`: Says where a layout put each note, by its `id`: sends
    * `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.
@@ -51775,7 +51775,7 @@ export type CustomElementsSolidJs = {
    *
    * - `helix-activate`: A note was selected, in the list or in the drawing. The detail's `value` is its `id`.
    * - `helix-before-activate`: A note is about to be selected. Cancelable: cancel it to keep the selection in your own state.
-   * - `helix-graph-layout`: A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`.
+   * - `helix-graph-layout`: A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions.
    * - `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.
@@ -51800,7 +51800,7 @@ export type CustomElementsSolidJs = {
    * its own graph calls it when that graph is finished. The first call after
    * the graph was not drawn sends `helix-graph-ready` and turns on
    * `:state(ready)`.
-   * - `laidOut(positions: Record<string, { x: number; y: number }>) => void`: Says where a layout put each note, by its `id`: sends
+   * - `laidOut(positions: Record<string, { x: number; y: number; z?: number | undefined }>) => void`: Says where a layout put each note, by its `id`: sends
    * `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.

package/types/vue.d.ts

@@ -5065,7 +5065,7 @@ export type HelixHeadlessGraphVueEvents = {
   "helix-activate": HelixHeadlessGraphHelixActivateElementEvent;
   /** A note is about to be selected. Cancelable: cancel it to keep the selection in your own state. */
   "helix-before-activate": HelixHeadlessGraphHelixBeforeActivateElementEvent;
-  /** A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`. */
+  /** A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions. */
   "helix-graph-layout": HelixHeadlessGraphHelixGraphLayoutElementEvent;
   /** A pan button or arrow key was pressed. `connectGraph` moves the drawing. */
   "helix-graph-pan": HelixHeadlessGraphHelixGraphPanElementEvent;