@fusion.dev/helix-core 0.100.0 → 0.102.0

package/custom-elements.json

@@ -3196,6 +3196,50 @@
           },
           "helix": {}
         },
+        {
+          "kind": "class",
+          "description": "The reader asked the map to move, which is as far as this library goes.\n\n**Helix draws no map and moves nobody's.** A tile renderer is a library and\nthe frame around it is what this adds, so panning is a request the consumer\nanswers against whatever they slotted: MapLibre, Leaflet, Google, or their\nown. The direction is in reading order rather than compass order, because the\ncontrol that sent it is a button a reader pressed and `start` on a\nright-to-left page is east.\n\nNot cancelable. Nothing here moves on its own, and an event whose\n`preventDefault` means nothing is an event that lies about what it offers.",
+          "name": "HelixMapPanEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-map-pan'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
+        {
+          "kind": "class",
+          "description": "The reader asked the map to zoom, and for the same reason it is a request.\n\n`by` is a direction rather than a level: a scale a consumer's map understands\nis the consumer's to decide, and a frame that said \"go to zoom 14\" would be\nasserting a numbering that Leaflet, MapLibre and a static tile server do not\nagree on.",
+          "name": "HelixMapZoomEvent",
+          "members": [
+            {
+              "kind": "field",
+              "name": "eventName",
+              "type": {
+                "text": "string"
+              },
+              "static": true,
+              "readonly": true,
+              "default": "'helix-map-zoom'"
+            }
+          ],
+          "superclass": {
+            "name": "CustomEvent",
+            "module": "src/events/events.ts"
+          },
+          "helix": {}
+        },
         {
           "kind": "class",
           "description": "A message is about to be pinned or unpinned, and can be refused.",
@@ -3837,6 +3881,22 @@
             "module": "src/events/events.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixMapPanEvent",
+          "declaration": {
+            "name": "HelixMapPanEvent",
+            "module": "src/events/events.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapZoomEvent",
+          "declaration": {
+            "name": "HelixMapZoomEvent",
+            "module": "src/events/events.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixBeforePinEvent",
@@ -5705,6 +5765,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "HelixMapPanEvent",
+          "declaration": {
+            "name": "HelixMapPanEvent",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HelixMapZoomEvent",
+          "declaration": {
+            "name": "HelixMapZoomEvent",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "HelixNavigateEvent",
@@ -5817,6 +5893,22 @@
             "module": "./events/events.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "MapPanDetail",
+          "declaration": {
+            "name": "MapPanDetail",
+            "module": "./events/events.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MapZoomDetail",
+          "declaration": {
+            "name": "MapZoomDetail",
+            "module": "./events/events.js"
+          }
+        },
         {
           "kind": "js",
           "name": "NavigateDetail",

package/dist/events/events.d.ts

@@ -70,6 +70,18 @@ export interface SkipDetail {
     /** Which way the reader asked to go. */
     to: 'next' | 'previous';
 }
+/** Detail carried by `helix-map-pan`. */
+export interface MapPanDetail {
+    /** Which way the reader asked to go, in reading order rather than compass order. */
+    to: 'up' | 'down' | 'start' | 'end';
+    /** How far, as a fraction of the viewport the map is drawn in. */
+    by: number;
+}
+/** Detail carried by `helix-map-zoom`. */
+export interface MapZoomDetail {
+    /** Which way, `1` in and `-1` out, so a consumer can multiply by their own step. */
+    by: number;
+}
 /** Detail carried by `helix-navigate`. */
 export interface NavigateDetail {
     /** Where the view is moving to, in whatever the component pages by. */
@@ -282,6 +294,35 @@ export declare class HelixActivateEvent extends CustomEvent<ChangeDetail> {
     static readonly eventName = "helix-activate";
     constructor(detail: ChangeDetail);
 }
+/**
+ * The reader asked the map to move, which is as far as this library goes.
+ *
+ * **Helix draws no map and moves nobody's.** A tile renderer is a library and
+ * the frame around it is what this adds, so panning is a request the consumer
+ * answers against whatever they slotted: MapLibre, Leaflet, Google, or their
+ * own. The direction is in reading order rather than compass order, because the
+ * control that sent it is a button a reader pressed and `start` on a
+ * right-to-left page is east.
+ *
+ * Not cancelable. Nothing here moves on its own, and an event whose
+ * `preventDefault` means nothing is an event that lies about what it offers.
+ */
+export declare class HelixMapPanEvent extends CustomEvent<MapPanDetail> {
+    static readonly eventName = "helix-map-pan";
+    constructor(detail: MapPanDetail);
+}
+/**
+ * The reader asked the map to zoom, and for the same reason it is a request.
+ *
+ * `by` is a direction rather than a level: a scale a consumer's map understands
+ * is the consumer's to decide, and a frame that said "go to zoom 14" would be
+ * asserting a numbering that Leaflet, MapLibre and a static tile server do not
+ * agree on.
+ */
+export declare class HelixMapZoomEvent extends CustomEvent<MapZoomDetail> {
+    static readonly eventName = "helix-map-zoom";
+    constructor(detail: MapZoomDetail);
+}
 /** A message is about to be pinned or unpinned, and can be refused. */
 export declare class HelixBeforePinEvent extends CustomEvent<ChangeDetail> {
     static readonly eventName = "helix-before-pin";
@@ -752,6 +793,8 @@ declare const registry: {
     readonly HelixFacetEvent: typeof HelixFacetEvent;
     readonly HelixFilterEvent: typeof HelixFilterEvent;
     readonly HelixHistoryEvent: typeof HelixHistoryEvent;
+    readonly HelixMapPanEvent: typeof HelixMapPanEvent;
+    readonly HelixMapZoomEvent: typeof HelixMapZoomEvent;
     readonly HelixNavigateEvent: typeof HelixNavigateEvent;
     readonly HelixNextEvent: typeof HelixNextEvent;
     readonly HelixPreviousEvent: typeof HelixPreviousEvent;

package/dist/events/events.js

@@ -98,6 +98,28 @@ export class HelixActivateEvent extends CustomEvent {
         });
     }
 }
+export class HelixMapPanEvent extends CustomEvent {
+    static { this.eventName = 'helix-map-pan'; }
+    constructor(detail) {
+        super(HelixMapPanEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
+export class HelixMapZoomEvent extends CustomEvent {
+    static { this.eventName = 'helix-map-zoom'; }
+    constructor(detail) {
+        super(HelixMapZoomEvent.eventName, {
+            bubbles: true,
+            cancelable: false,
+            composed: true,
+            detail,
+        });
+    }
+}
 export class HelixBeforePinEvent extends CustomEvent {
     static { this.eventName = 'helix-before-pin'; }
     constructor(detail) {
@@ -394,6 +416,8 @@ const registry = {
     HelixFacetEvent,
     HelixFilterEvent,
     HelixHistoryEvent,
+    HelixMapPanEvent,
+    HelixMapZoomEvent,
     HelixNavigateEvent,
     HelixNextEvent,
     HelixPreviousEvent,

package/dist/index.d.ts

@@ -19,7 +19,7 @@ export { SourceController, type SourceHost, } from './controllers/source-control
 export { type TokenColor, TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
 export { type Rendered, VirtualizeController, type VirtualizeOptions, type Window as VirtualizeWindow, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { type CaretDetail, type ChangeDetail, type CompleteDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCaretEvent, HelixCompleteEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixHistoryEvent, HelixNavigateEvent, HelixNextEvent, HelixPreviousEvent, HelixReadEvent, HelixReorderEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixTourAskEvent, type NavigateDetail, type OpenDetail, type ReadDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type ToggleDetail, } from './events/events.js';
+export { type CaretDetail, type ChangeDetail, type CompleteDetail, type ConsoleDetail, type CopyDetail, type CreateDetail, type DismissDetail, type FacetDetail, type FilterDetail, HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCaretEvent, HelixCompleteEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixHistoryEvent, HelixMapPanEvent, HelixMapZoomEvent, HelixNavigateEvent, HelixNextEvent, HelixPreviousEvent, HelixReadEvent, HelixReorderEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixTourAskEvent, type MapPanDetail, type MapZoomDetail, type NavigateDetail, type OpenDetail, type ReadDetail, type ResizeDetail, type ScrolledDetail, type SelectDetail, type SendDetail, type ShortcutDetail, type SkipDetail, type SortDetail, type ToggleDetail, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { MixinChartSource, type MixinChartSourceInterface, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';

package/dist/index.js

@@ -19,7 +19,7 @@ export { SourceController, } from './controllers/source-controller/source-contro
 export { TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
 export { VirtualizeController, } from './controllers/virtualize-controller/virtualize-controller.js';
 export { eventsForTag, registerElementEvents } from './events/element-events.js';
-export { HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCaretEvent, HelixCompleteEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixHistoryEvent, HelixNavigateEvent, HelixNextEvent, HelixPreviousEvent, HelixReadEvent, HelixReorderEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixTourAskEvent, } from './events/events.js';
+export { HelixActivateEvent, HelixBeforeActivateEvent, HelixBeforeChangeEvent, HelixBeforeCloseEvent, HelixBeforeCollapseEvent, HelixBeforeEditEvent, HelixBeforeOpenEvent, HelixBeforePanelResizeEvent, HelixBeforePinEvent, HelixBeforeResizeEvent, HelixBeforeSplitEvent, HelixBeforeToggleEvent, HelixCaretEvent, HelixCompleteEvent, HelixConsoleEvent, HelixCopyEvent, HelixCreateEvent, HelixDismissEvent, HelixFacetEvent, HelixFilterEvent, HelixHistoryEvent, HelixMapPanEvent, HelixMapZoomEvent, HelixNavigateEvent, HelixNextEvent, HelixPreviousEvent, HelixReadEvent, HelixReorderEvent, HelixResizeEvent, HelixSampleEndEvent, HelixSampleStartEvent, HelixScrolledEvent, HelixSelectEvent, HelixSendEvent, HelixShortcutEvent, HelixSortEvent, HelixTourAskEvent, } from './events/events.js';
 export { HelixElement, whenHydrated } from './helix-element/helix-element.js';
 export { HelixFormElement } from './helix-form-element/helix-form-element.js';
 export { MixinChartSource, PALETTE, PLOT_HEIGHT, PLOT_WIDTH, seriesIndex, seriesNames, } from './mixins/mixin-chart-source/mixin-chart-source.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.100.0",
+  "version": "0.102.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -34,11 +34,11 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.100.0"
+    "@fusion.dev/helix-icons": "0.102.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.100.0",
-    "@fusion.dev/helix-testing": "0.100.0",
+    "@fusion.dev/helix-cem": "0.102.0",
+    "@fusion.dev/helix-testing": "0.102.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },