@fusion.dev/helix-headless 0.120.0 → 0.122.0

package/custom-elements.json

@@ -49992,6 +49992,38 @@
             "module": "./root/graph-model.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "GraphNodeEmphasis",
+          "declaration": {
+            "name": "GraphNodeEmphasis",
+            "module": "./root/graph-model.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphNodeMaterial",
+          "declaration": {
+            "name": "GraphNodeMaterial",
+            "module": "./root/graph-model.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphNodeShape",
+          "declaration": {
+            "name": "GraphNodeShape",
+            "module": "./root/graph-model.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GraphNodeTone",
+          "declaration": {
+            "name": "GraphNodeTone",
+            "module": "./root/graph-model.js"
+          }
+        },
         {
           "kind": "js",
           "name": "Relation",
@@ -50622,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"
               }
             },
             {
@@ -52080,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/index.d.ts

@@ -1,3 +1,3 @@
-export type { Adjacency, Entry, GraphLink, GraphNode, Relation } from './root/graph-model.js';
+export type { Adjacency, Entry, GraphLink, GraphNode, GraphNodeEmphasis, GraphNodeMaterial, GraphNodeShape, GraphNodeTone, Relation, } from './root/graph-model.js';
 export { adjacencyOf, entriesOf, nameOf, sortedOf, within } from './root/graph-model.js';
 export { HelixHeadlessGraph } from './root/graph-root.js';

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

@@ -1,17 +1,45 @@
+/** The shapes a note can be drawn in, from the `shape` axis. */
+export type GraphNodeShape = 'circle' | 'diamond' | 'ring' | 'square';
+/** How heavily a note is drawn, from the `emphasis` axis. */
+export type GraphNodeEmphasis = 'outlined' | 'solid' | 'subtle';
+/** What a note is drawn as made of, from the `material` axis. */
+export type GraphNodeMaterial = 'frosted' | 'glass';
+/** What a note means, from the `tone` axis, which colors it over its group. */
+export type GraphNodeTone = 'accent' | 'danger' | 'info' | 'neutral' | 'primary' | 'success' | 'warning';
 /** One note in a graph. */
 export interface GraphNode {
     /** Unique in the graph, and what `active` and a link's ends name. */
     id: string;
     /** What the note is called. Its `id` where it has none. */
     label?: string | undefined;
+    /**
+     * How heavily it is drawn: `solid`, filled, which unset is; `outlined`, a
+     * ring with the ground showing through; `subtle`, a tinted fill with a
+     * ring. Unset is the renderer's own.
+     */
+    emphasis?: GraphNodeEmphasis | undefined;
     /** A kind the note belongs to, such as a tag, which a renderer colors it by. */
     group?: string | undefined;
+    /** What it is drawn as made of: `glass` or `frosted`. Unset is the renderer's own. */
+    material?: GraphNodeMaterial | undefined;
+    /**
+     * Its shape, which says what kind of note it is at a glance: a person as a
+     * circle and a document as a square. Unset is the renderer's own.
+     */
+    shape?: GraphNodeShape | undefined;
+    /**
+     * What it means, which colors it over its group's color: `danger` for an
+     * incident, `success` for something done.
+     */
+    tone?: GraphNodeTone | undefined;
     /** How large the renderer draws it, relative to the others. */
     size?: number | undefined;
     /** Where the note stands, where the page already knows. Laid out where it does not. */
     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.120.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.120.0",
-    "@fusion.dev/helix-icons": "0.120.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.120.0",
-    "@fusion.dev/helix-testing": "0.120.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;