@luzmo/analytics-components-kit 1.0.4-beta.4 → 1.0.5-beta.1

package/components/wordcloud-chart-positioning.config-CmakCQG0.js

@@ -0,0 +1,55 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+import { n as e } from "./item-slot-drop-panel-BevGCcMh.js";
+//#region node_modules/@luzmo/dashboard-contents-types/src/lib/wordcloud-chart/wordcloud-chart-positioning.config.js
+var t = {
+	grid: {
+		columns: 2,
+		rows: 2,
+		columnSizes: ["1fr", e],
+		rowSizes: ["1fr", e],
+		gap: "0"
+	},
+	slots: {
+		measure: {
+			column: 1,
+			row: 1,
+			align: "center",
+			justify: "center",
+			rotate: !1
+		},
+		category: {
+			column: 1,
+			row: 2,
+			align: "center",
+			justify: "center",
+			rotate: !1
+		},
+		color: {
+			column: 2,
+			row: 1,
+			align: "center",
+			justify: "center",
+			rotate: !0
+		}
+	}
+};
+//#endregion
+export { t as wordcloudChartPositioningConfig };

package/components/wordcloud-chart-slots.config-B8s8B47F.js

@@ -0,0 +1,45 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+import { s as e } from "./pragmatic-element-adapter-e5LbH_lv.js";
+//#region node_modules/@luzmo/dashboard-contents-types/src/lib/wordcloud-chart/wordcloud-chart-slots.config.js
+var t = /* @__PURE__ */ e({ wordcloudChartSlotsConfig: () => n }), n = [
+	{
+		name: "measure",
+		rotate: !1,
+		label: "Measure",
+		type: "numeric",
+		canAcceptFormula: !0
+	},
+	{
+		name: "category",
+		rotate: !1,
+		label: "Category",
+		type: "categorical",
+		isRequired: !0
+	},
+	{
+		name: "color",
+		rotate: !0,
+		label: "Color",
+		type: "categorical"
+	}
+];
+//#endregion
+export { t as n, n as t };

package/components/wordcloud-chart-slots.config-C303nwAz.cjs

@@ -0,0 +1,20 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+var e=require("./chunk-mLOUI7ql.cjs").n({wordcloudChartSlotsConfig:()=>t}),t=[{name:`measure`,rotate:!1,label:`Measure`,type:`numeric`,canAcceptFormula:!0},{name:`category`,rotate:!1,label:`Category`,type:`categorical`,isRequired:!0},{name:`color`,rotate:!0,label:`Color`,type:`categorical`}];Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});

package/custom-elements.json

@@ -5725,15 +5725,67 @@
               "description": "The slot type",
               "attribute": "slot-type"
             },
+            {
+              "kind": "field",
+              "name": "slotName",
+              "type": {
+                "text": "SlotName"
+              },
+              "default": "'measure'",
+              "description": "The slot name used to distinguish measure and dimension calculations.",
+              "attribute": "slot-name"
+            },
             {
               "kind": "field",
               "name": "slotContent",
               "type": {
-                "text": "GenericSlotContent"
+                "text": "SlotContent"
               },
               "default": "{}",
               "description": "The slot content model (label, formatting, aggregation, etc.) for the field being configured."
             },
+            {
+              "kind": "field",
+              "name": "datasetsDataFields",
+              "type": {
+                "text": "DatasetDataFields[]"
+              },
+              "default": "[]",
+              "description": "Datasets used to resolve column names in ad-hoc calculation previews."
+            },
+            {
+              "kind": "field",
+              "name": "apiUrl",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'https://api.luzmo.com'",
+              "description": "The API URL used when resolving calculation previews by dataset id.",
+              "attribute": "api-url",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "authKey",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "''",
+              "description": "The auth key used when resolving calculation previews by dataset id.",
+              "attribute": "auth-key",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "authToken",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "''",
+              "description": "The auth token used when resolving calculation previews by dataset id.",
+              "attribute": "auth-token",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "measureColumns",
@@ -5923,6 +5975,42 @@
               "description": "The slot type",
               "fieldName": "slotType"
             },
+            {
+              "name": "slot-name",
+              "type": {
+                "text": "SlotName"
+              },
+              "default": "'measure'",
+              "description": "The slot name used to distinguish measure and dimension calculations.",
+              "fieldName": "slotName"
+            },
+            {
+              "name": "api-url",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "'https://api.luzmo.com'",
+              "description": "The API URL used when resolving calculation previews by dataset id.",
+              "fieldName": "apiUrl"
+            },
+            {
+              "name": "auth-key",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "''",
+              "description": "The auth key used when resolving calculation previews by dataset id.",
+              "fieldName": "authKey"
+            },
+            {
+              "name": "auth-token",
+              "type": {
+                "text": "string | undefined"
+              },
+              "default": "''",
+              "description": "The auth token used when resolving calculation previews by dataset id.",
+              "fieldName": "authToken"
+            },
             {
               "name": "measureColumns",
               "type": {
@@ -18800,7 +18888,7 @@
               "kind": "field",
               "name": "slotContents",
               "type": {
-                "text": "GenericSlotContent[] | undefined"
+                "text": "SlotContent[] | undefined"
               },
               "description": "The contents (columns/formulas) assigned to this slot.",
               "attribute": "slot-contents"
@@ -18872,6 +18960,15 @@
               "attribute": "auth-token",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "datasetsDataFields",
+              "type": {
+                "text": "DatasetDataFields[]"
+              },
+              "default": "[]",
+              "description": "Datasets used to resolve column names in ad-hoc calculation previews."
+            },
             {
               "kind": "field",
               "name": "_activeIndex"
@@ -19166,7 +19263,7 @@
             {
               "name": "slot-contents",
               "type": {
-                "text": "GenericSlotContent[] | undefined"
+                "text": "SlotContent[] | undefined"
               },
               "description": "The contents (columns/formulas) assigned to this slot.",
               "fieldName": "slotContents"
@@ -19289,12 +19386,34 @@
               "kind": "field",
               "name": "slotContents",
               "type": {
-                "text": "GenericSlotContent[]"
+                "text": "SlotContent[]"
               },
               "default": "[]",
               "description": "The list of slot contents (columns/formulas) shown in the reorderable list.",
               "attribute": "slotContents"
             },
+            {
+              "kind": "field",
+              "name": "slotName",
+              "type": {
+                "text": "SlotName"
+              },
+              "default": "'measure'",
+              "description": "The containing slot name used to identify measure calculations.",
+              "attribute": "slot-name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "slotType",
+              "type": {
+                "text": "string"
+              },
+              "default": "'numeric'",
+              "description": "The containing slot type used to identify measure calculations.",
+              "attribute": "slot-type",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "activeIndex",
@@ -19424,12 +19543,30 @@
             {
               "name": "slotContents",
               "type": {
-                "text": "GenericSlotContent[]"
+                "text": "SlotContent[]"
               },
               "default": "[]",
               "description": "The list of slot contents (columns/formulas) shown in the reorderable list.",
               "fieldName": "slotContents"
             },
+            {
+              "name": "slot-name",
+              "type": {
+                "text": "SlotName"
+              },
+              "default": "'measure'",
+              "description": "The containing slot name used to identify measure calculations.",
+              "fieldName": "slotName"
+            },
+            {
+              "name": "slot-type",
+              "type": {
+                "text": "string"
+              },
+              "default": "'numeric'",
+              "description": "The containing slot type used to identify measure calculations.",
+              "fieldName": "slotType"
+            },
             {
               "name": "activeIndex",
               "type": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luzmo/analytics-components-kit",
-  "version": "1.0.4-beta.4",
+  "version": "1.0.5-beta.1",
   "type": "module",
   "main": "./components/index.js",
   "module": "./components/index.js",
@@ -330,7 +330,7 @@
     "@lit/task": "^1.0.1",
     "@luzmo/embed": "^6.13.0",
     "@luzmo/icons": "^1.0.1-alpha.41",
-    "@luzmo/lucero": "^1.0.3-alpha.5",
+    "@luzmo/lucero": "^1.0.3-alpha.7",
     "colorjs.io": "^0.5.2",
     "lit": "^3.3.1",
     "react": "^18.0.0 || ^19.0.0",
@@ -354,7 +354,7 @@
     "@codemirror/view": "^6.43.1",
     "@luzmo/dashboard-contents-types": "1.0.31",
     "@tanstack/query-core": "^5.90.5",
-    "dompurify": "^3.3.0",
+    "dompurify": "^3.4.12",
     "gridstack": "^12.3.3",
     "marked": "^18.0.5",
     "uuid": "^14.0.0"

package/react/utils/formula/config/tests/build-datasets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/react/utils/slot-content/ad-hoc-slot-content.d.ts

@@ -0,0 +1,7 @@
+import type { SlotConfig } from '@luzmo/dashboard-contents-types';
+import type { SlotContent } from '../../types/slot.types';
+export declare const isAdHocFormula: (content: SlotContent | undefined) => boolean;
+export declare const isAdHocExpression: (content: SlotContent | undefined) => boolean;
+export declare const getAdHocExpression: (content: SlotContent | undefined) => string | undefined;
+export declare const getSlotContentIdentityKey: (content: SlotContent | undefined) => string | undefined;
+export declare const shouldSurfaceAsFormula: (content: SlotContent | undefined, slotConfiguration: SlotConfig) => boolean;

package/react/utils/slot-content/render-calculation-label.d.ts

@@ -0,0 +1,7 @@
+import { type TemplateResult } from 'lit';
+import type { SlotContent } from '../../types/slot.types';
+/**
+ * Renders the compact ad-hoc calculation label (icon + "Formula"/"Expression")
+ * shared by the slot picker, drop target and slot menu surfaces.
+ */
+export declare const renderAdHocCalculationLabel: (content: SlotContent | undefined) => TemplateResult;

package/react/utils/slot-content/tests/ad-hoc-slot-content.test.d.ts

@@ -0,0 +1 @@
+export {};

package/react/utils/slot-state/slot-store.d.ts

@@ -5,7 +5,7 @@ export declare class SlotStore {
     /**
      * Holds all contents for this item slot drop target.
      */
-    readonly slotContents: import("signal-polyfill").Signal.State<import("@luzmo/dashboard-contents-types").GenericSlotContent[]>;
+    readonly slotContents: import("signal-polyfill").Signal.State<SlotContent[]>;
     readonly slotsContents: import("signal-polyfill").Signal.State<VizItemSlot[]>;
     readonly periodOverPeriodUiType: import("signal-polyfill").Signal.State<PeriodOverPeriodCondition | null>;
     readonly linkedDataset: import("signal-polyfill").Signal.State<{
@@ -14,7 +14,7 @@ export declare class SlotStore {
         columns: any[];
     }[]>;
     private readonly _popEnabledChartTypes;
-    readonly activeSlotContents: import("signal-polyfill").Signal.Computed<import("@luzmo/dashboard-contents-types").GenericSlotContent>;
+    readonly activeSlotContents: import("signal-polyfill").Signal.Computed<SlotContent>;
     /**
      * Index of the content currently selected / active in a slot menu.
      */

package/react/utils/store/index.d.ts

@@ -9,7 +9,7 @@
  * @example
  * ```typescript
  * // Standalone item with undo/redo
- * import { createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { createItemStore } from '../../utils/store';
  *
  * const itemStore = createItemStore({
  *   type: 'bar-chart',
@@ -31,7 +31,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '@luzmo/analytics-components-kit/utils/store';
+ * } from '../../utils/store';
  *
  * // Create and register stores
  * const store = registerItemStore({ type: 'bar-chart' });
@@ -46,7 +46,7 @@
  * @example
  * ```typescript
  * // Dashboard with real-time collaboration
- * import { createDashboardStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { createDashboardStore } from '../../utils/store';
  *
  * const dashboardStore = createDashboardStore(dashboardConfig);
  *
@@ -67,7 +67,7 @@ import type { ItemState, ItemStoreConfig, ItemStore, DashboardState, DashboardSt
  *
  * @example
  * ```typescript
- * import { ready, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { ready, createItemStore } from '../../utils/store';
  *
  * await ready;
  * const store = createItemStore({ type: 'bar-chart' });
@@ -82,7 +82,7 @@ export declare const ready: Promise<void>;
  *
  * @example
  * ```typescript
- * import { onReady, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { onReady, createItemStore } from '../../utils/store';
  *
  * onReady(() => {
  *   const store = createItemStore({ type: 'bar-chart' });

package/react/utils/store/store-registry.d.ts

@@ -11,7 +11,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '@luzmo/analytics-components-kit/utils/store';
+ * } from '../../utils/store';
  *
  * // Create and register a store (auto-registers with its ID)
  * const store = registerItemStore({ type: 'bar-chart' });

package/types/slot.types.d.ts

@@ -1,5 +1,14 @@
 import type { GenericSlotContent, SlotName, VizItemSlot } from '@luzmo/dashboard-contents-types';
-export type SlotContent = GenericSlotContent;
+/**
+ * Slot content accepted by ACK.
+ *
+ * `expression` is the inline, non-aggregating equivalent of an ad-hoc `formula`.
+ * It is part of the visuals slot model but is not yet present in the released
+ * dashboard-contents-types package.
+ */
+export type SlotContent = GenericSlotContent & {
+    expression?: string;
+};
 export type SlotConstraintType = 'keepOnlyFirstWhenOtherSlotFilled' | 'clearWhenOtherSlotHasMultipleItems' | 'clearSlotsWhenUnlinkedDataset';
 export interface SlotConstraint {
     type: SlotConstraintType;

package/utils/formula/config/tests/build-datasets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/slot-content/ad-hoc-slot-content.d.ts

@@ -0,0 +1,7 @@
+import type { SlotConfig } from '@luzmo/dashboard-contents-types';
+import type { SlotContent } from '../../types/slot.types';
+export declare const isAdHocFormula: (content: SlotContent | undefined) => boolean;
+export declare const isAdHocExpression: (content: SlotContent | undefined) => boolean;
+export declare const getAdHocExpression: (content: SlotContent | undefined) => string | undefined;
+export declare const getSlotContentIdentityKey: (content: SlotContent | undefined) => string | undefined;
+export declare const shouldSurfaceAsFormula: (content: SlotContent | undefined, slotConfiguration: SlotConfig) => boolean;

package/utils/slot-content/render-calculation-label.d.ts

@@ -0,0 +1,7 @@
+import { type TemplateResult } from 'lit';
+import type { SlotContent } from '../../types/slot.types';
+/**
+ * Renders the compact ad-hoc calculation label (icon + "Formula"/"Expression")
+ * shared by the slot picker, drop target and slot menu surfaces.
+ */
+export declare const renderAdHocCalculationLabel: (content: SlotContent | undefined) => TemplateResult;

package/utils/slot-content/tests/ad-hoc-slot-content.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/slot-state/slot-store.d.ts

@@ -5,7 +5,7 @@ export declare class SlotStore {
     /**
      * Holds all contents for this item slot drop target.
      */
-    readonly slotContents: import("signal-polyfill").Signal.State<import("@luzmo/dashboard-contents-types").GenericSlotContent[]>;
+    readonly slotContents: import("signal-polyfill").Signal.State<SlotContent[]>;
     readonly slotsContents: import("signal-polyfill").Signal.State<VizItemSlot[]>;
     readonly periodOverPeriodUiType: import("signal-polyfill").Signal.State<PeriodOverPeriodCondition | null>;
     readonly linkedDataset: import("signal-polyfill").Signal.State<{
@@ -14,7 +14,7 @@ export declare class SlotStore {
         columns: any[];
     }[]>;
     private readonly _popEnabledChartTypes;
-    readonly activeSlotContents: import("signal-polyfill").Signal.Computed<import("@luzmo/dashboard-contents-types").GenericSlotContent>;
+    readonly activeSlotContents: import("signal-polyfill").Signal.Computed<SlotContent>;
     /**
      * Index of the content currently selected / active in a slot menu.
      */

package/utils/store/index.d.ts

@@ -9,7 +9,7 @@
  * @example
  * ```typescript
  * // Standalone item with undo/redo
- * import { createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { createItemStore } from '../../utils/store';
  *
  * const itemStore = createItemStore({
  *   type: 'bar-chart',
@@ -31,7 +31,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '@luzmo/analytics-components-kit/utils/store';
+ * } from '../../utils/store';
  *
  * // Create and register stores
  * const store = registerItemStore({ type: 'bar-chart' });
@@ -46,7 +46,7 @@
  * @example
  * ```typescript
  * // Dashboard with real-time collaboration
- * import { createDashboardStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { createDashboardStore } from '../../utils/store';
  *
  * const dashboardStore = createDashboardStore(dashboardConfig);
  *
@@ -67,7 +67,7 @@ import type { ItemState, ItemStoreConfig, ItemStore, DashboardState, DashboardSt
  *
  * @example
  * ```typescript
- * import { ready, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { ready, createItemStore } from '../../utils/store';
  *
  * await ready;
  * const store = createItemStore({ type: 'bar-chart' });
@@ -82,7 +82,7 @@ export declare const ready: Promise<void>;
  *
  * @example
  * ```typescript
- * import { onReady, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ * import { onReady, createItemStore } from '../../utils/store';
  *
  * onReady(() => {
  *   const store = createItemStore({ type: 'bar-chart' });

package/utils/store/store-registry.d.ts

@@ -11,7 +11,7 @@
  * import {
  *   registerItemStore,
  *   getStore
- * } from '@luzmo/analytics-components-kit/utils/store';
+ * } from '../../utils/store';
  *
  * // Create and register a store (auto-registers with its ID)
  * const store = registerItemStore({ type: 'bar-chart' });