@mosaicajs/react 0.3.0 → 0.4.0

package/dist/components.d.ts

@@ -49,7 +49,8 @@ export declare const MosaicaStore: import("@lit/react").ReactWebComponent<StoreE
  * it has a handler prop for each of them: `onPick` for `mosaica-pick`, and so on for every event
  * in {@link MosaicaEvents} except `mosaica-chipopen`, which it does not fire. The `open` prop
  * is the function the item card's Open button calls, and `openUrl` the address it goes to.
- * `onOpen` is called on every press.
+ * `onOpen` is called on every press. `onLevelChange` reports `{layer, level}`: the explorer keeps a
+ * level for each layer, and a choice changes that layer's alone.
  */
 export declare const MosaicaExplorer: import("@lit/react").ReactWebComponent<ExplorerElement, {
     onArtifactFit: EventName<CustomEvent<{
@@ -59,6 +60,7 @@ export declare const MosaicaExplorer: import("@lit/react").ReactWebComponent<Exp
         colourBy: string | null;
     }>>;
     onLevelChange: EventName<CustomEvent<{
+        layer: string;
         level: number | null;
     }>>;
     onValueColour: EventName<CustomEvent<{
@@ -103,8 +105,8 @@ export declare const MosaicaExplorer: import("@lit/react").ReactWebComponent<Exp
     onBudgetChange: EventName<CustomEvent<{
         budget: number;
     }>>;
-    onClusterBudgetChange: EventName<CustomEvent<{
-        budget: number;
+    onClusterSpacingChange: EventName<CustomEvent<{
+        spacing: number;
     }>>;
     onFold: EventName<CustomEvent<{
         field: string;
@@ -168,6 +170,7 @@ export declare const MosaicaExplorer: import("@lit/react").ReactWebComponent<Exp
     }>>;
     onSelectChange: EventName<CustomEvent<{
         shape: import("@mosaicajs/components").SelectionShapeDetail | null;
+        view?: string;
         status?: import("@mosaicajs/client").RegionProjection["status"] | "cleared";
         visible?: import("@mosaicajs/client").Masked | null;
         matched?: import("@mosaicajs/client").Masked;
@@ -217,6 +220,7 @@ export declare const MosaicaMap: import("@lit/react").ReactWebComponent<MapEleme
     }>>;
     onSelectChange: EventName<CustomEvent<{
         shape: import("@mosaicajs/components").SelectionShapeDetail | null;
+        view?: string;
         status?: import("@mosaicajs/client").RegionProjection["status"] | "cleared";
         visible?: import("@mosaicajs/client").Masked | null;
         matched?: import("@mosaicajs/client").Masked;
@@ -277,7 +281,9 @@ export declare const MosaicaItemCard: import("@lit/react").ReactWebComponent<Ite
  * (`mosaica-filterchange`), `onChipOpen` (`mosaica-chipopen`), and from its cards
  * `onClauseChange` (`mosaica-clausechange`), `onColourChange` (`mosaica-colourchange`),
  * `onLevelChange` (`mosaica-levelchange`), `onValueColour` (`mosaica-valuecolour`),
- * `onClusterColour` (`mosaica-clustercolour`) and `onFold` (`mosaica-fold`).
+ * `onClusterColour` (`mosaica-clustercolour`) and `onFold` (`mosaica-fold`). `onLevelChange`
+ * reports `{layer, level}`; to keep the choice, set it in the `Map` passed as `clusterLevels`, here
+ * and on the map.
  */
 export declare const MosaicaFilterPanel: import("@lit/react").ReactWebComponent<FilterPanelElement, {
     onFilterChange: EventName<CustomEvent<{
@@ -300,6 +306,7 @@ export declare const MosaicaFilterPanel: import("@lit/react").ReactWebComponent<
         colourBy: string | null;
     }>>;
     onLevelChange: EventName<CustomEvent<{
+        layer: string;
         level: number | null;
     }>>;
     onValueColour: EventName<CustomEvent<{
@@ -343,6 +350,7 @@ export declare const MosaicaClusterFilter: import("@lit/react").ReactWebComponen
 export declare const MosaicaSelection: import("@lit/react").ReactWebComponent<SelectionElement, {
     onSelectChange: EventName<CustomEvent<{
         shape: import("@mosaicajs/components").SelectionShapeDetail | null;
+        view?: string;
         status?: import("@mosaicajs/client").RegionProjection["status"] | "cleared";
         visible?: import("@mosaicajs/client").Masked | null;
         matched?: import("@mosaicajs/client").Masked;
@@ -397,6 +405,7 @@ export declare const MosaicaArtifactCard: import("@lit/react").ReactWebComponent
  * (`mosaica-filterchange`), `onClauseChange` (`mosaica-clausechange`), `onColourChange`
  * (`mosaica-colourchange`), `onLevelChange` (`mosaica-levelchange`), `onValueColour`
  * (`mosaica-valuecolour`), `onClusterColour` (`mosaica-clustercolour`) and `onFold` (`mosaica-fold`).
+ * `onLevelChange` reports `{layer, level}` for the card's layer.
  */
 export declare const MosaicaFieldCard: import("@lit/react").ReactWebComponent<FieldCardElement, {
     onFold: EventName<CustomEvent<{
@@ -419,6 +428,7 @@ export declare const MosaicaFieldCard: import("@lit/react").ReactWebComponent<Fi
         colourBy: string | null;
     }>>;
     onLevelChange: EventName<CustomEvent<{
+        layer: string;
         level: number | null;
     }>>;
     onValueColour: EventName<CustomEvent<{

package/dist/components.js

@@ -79,7 +79,8 @@ export const MosaicaStore = withStableAuthorise(wrap('mosaica-store', StoreEleme
  * it has a handler prop for each of them: `onPick` for `mosaica-pick`, and so on for every event
  * in {@link MosaicaEvents} except `mosaica-chipopen`, which it does not fire. The `open` prop
  * is the function the item card's Open button calls, and `openUrl` the address it goes to.
- * `onOpen` is called on every press.
+ * `onOpen` is called on every press. `onLevelChange` reports `{layer, level}`: the explorer keeps a
+ * level for each layer, and a choice changes that layer's alone.
  */
 export const MosaicaExplorer = withStableAuthorise(wrap('mosaica-explorer', ExplorerElement, {
     ...mapEvents,
@@ -93,7 +94,7 @@ export const MosaicaExplorer = withStableAuthorise(wrap('mosaica-explorer', Expl
     onDisplayChange: ev('mosaica-displaychange'),
     onSizeChange: ev('mosaica-sizechange'),
     onBudgetChange: ev('mosaica-budgetchange'),
-    onClusterBudgetChange: ev('mosaica-clusterbudgetchange'),
+    onClusterSpacingChange: ev('mosaica-clusterspacingchange'),
     onFold: ev('mosaica-fold'),
     onFilterChange: ev('mosaica-filterchange'),
     onStateChange: ev('mosaica-statechange'),
@@ -130,7 +131,9 @@ export const MosaicaItemCard = wrap('mosaica-item-card', ItemCardElement, { onOp
  * (`mosaica-filterchange`), `onChipOpen` (`mosaica-chipopen`), and from its cards
  * `onClauseChange` (`mosaica-clausechange`), `onColourChange` (`mosaica-colourchange`),
  * `onLevelChange` (`mosaica-levelchange`), `onValueColour` (`mosaica-valuecolour`),
- * `onClusterColour` (`mosaica-clustercolour`) and `onFold` (`mosaica-fold`).
+ * `onClusterColour` (`mosaica-clustercolour`) and `onFold` (`mosaica-fold`). `onLevelChange`
+ * reports `{layer, level}`; to keep the choice, set it in the `Map` passed as `clusterLevels`, here
+ * and on the map.
  */
 export const MosaicaFilterPanel = wrap('mosaica-filter-panel', FilterPanelElement, {
     onFilterChange: ev('mosaica-filterchange'),
@@ -169,6 +172,7 @@ export const MosaicaArtifactCard = wrap('mosaica-artifact-card', ArtifactCardEle
  * (`mosaica-filterchange`), `onClauseChange` (`mosaica-clausechange`), `onColourChange`
  * (`mosaica-colourchange`), `onLevelChange` (`mosaica-levelchange`), `onValueColour`
  * (`mosaica-valuecolour`), `onClusterColour` (`mosaica-clustercolour`) and `onFold` (`mosaica-fold`).
+ * `onLevelChange` reports `{layer, level}` for the card's layer.
  */
 export const MosaicaFieldCard = wrap('mosaica-field-card', FieldCardElement, {
     onFold: ev('mosaica-fold'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mosaicajs/react",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "React hooks over the headless store, and typed wrappers for the mosaica-* elements behind a separate entry.",
   "keywords": [
     "mosaica",
@@ -45,11 +45,11 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@mosaicajs/client": "^0.3.0"
+    "@mosaicajs/client": "^0.4.0"
   },
   "peerDependencies": {
     "@lit/react": "^1.0.0",
-    "@mosaicajs/components": "^0.3.0",
+    "@mosaicajs/components": "^0.4.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
@@ -62,7 +62,7 @@
   },
   "devDependencies": {
     "@lit/react": "^1.0.8",
-    "@mosaicajs/components": "^0.3.0",
+    "@mosaicajs/components": "^0.4.0",
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "happy-dom": "^21.0.4",