@svgrid/enterprise 3.0.0 → 3.0.2

package/dist/install.js

@@ -1,17 +1,18 @@
-import { exportGrid, copyExportToClipboard, } from './export';
-import { printGrid } from './print';
-import { importData } from './import';
-import { isLicenseKeySet } from './license';
-import { emitUnlicensedNudge } from './watermark';
+import { exportGrid, copyExportToClipboard, } from './export.js';
+import { printGrid } from './print.js';
+import { importData } from './import.js';
+import { isLicenseKeySet } from './license.js';
+import { emitUnlicensedNudge } from './watermark.js';
 // AI helpers are built-in + free in @svgrid/grid now; enterprise just wires them
 // into the Pro API and registers its export engine so AI exports can write xlsx/pdf.
 import { aiFilter, aiSmartFill, aiSummarize, aiClassify, aiExport, aiFindAnomalies, aiChart, enableAiCharting, registerExportProvider, } from '@svgrid/grid';
-import { createPivotModel, } from './pivot';
-import { enableSchedulerView } from './scheduler';
-import { enableBoardView } from './board';
-import { enableSelectionBar } from './selection-bar';
-import { enableAdvancedFilter } from './advanced-filter-enable';
-import { enablePivot } from './pivot-enable';
+import { createPivotModel, } from './pivot.js';
+import { enableSchedulerView } from './scheduler.js';
+import { enableBoardView } from './board.js';
+import { enableSelectionBar } from './selection-bar.js';
+import { enableAdvancedFilter } from './advanced-filter-enable.js';
+import { enablePivot } from './pivot-enable.js';
+import { enableSheet } from './sheet-enable.js';
 /**
  * Augment a SvGridApi instance with Pro methods (`exportData`, `print`,
  * `ai.*`). Mutates and returns the same object so existing references
@@ -49,6 +50,10 @@ export function installEnterprise(api) {
     registerExportProvider(exportGrid);
     enablePivot();
     enableAdvancedFilter();
+    // Register the Excel keymap (Ctrl+Arrow, Ctrl+D, Ctrl+A and the rest). The
+    // grid interprets a key itself only when nothing claims it, so a free grid
+    // is unaffected.
+    enableSheet();
     pro.pivot = {
         build: (config) => createPivotModel(pro.getData(), config),
         buildFrom: (data, config) => 

package/dist/license.d.ts

@@ -1,5 +1,6 @@
-import { type EnterpriseFeatureLabel } from './upgrade-prompt';
-export { checkLicenseKey, type LicenseInfo, type LicenseStatus } from './license-core';
+import { type EnterpriseFeatureLabel } from './upgrade-prompt.js';
+export { checkLicenseKey, type LicenseInfo, type LicenseStatus } from './license-core.js';
+export { dismissUnlicensedNudge } from './watermark.js';
 export declare function setLicenseKey(key: string): void;
 export declare function clearLicenseKey(): void;
 export declare function getLicenseKey(): string | null;

package/dist/license.js

@@ -18,10 +18,15 @@
 //                                        + the upgrade card. Stays a soft gate
 //                                        so a trial ending cannot break a build.
 //   any other "SVENTERPRISE-..."             -> works silently (paid production)
-import { checkLicenseKey, VALID_PREFIX } from './license-core';
-import { emitUnlicensedNudge } from './watermark';
-import { showUpgradePrompt } from './upgrade-prompt';
-export { checkLicenseKey } from './license-core';
+import { checkLicenseKey, VALID_PREFIX } from './license-core.js';
+import { emitUnlicensedNudge } from './watermark.js';
+import { showUpgradePrompt } from './upgrade-prompt.js';
+export { checkLicenseKey } from './license-core.js';
+// The nudge the key silences, on the same subpath as the key: an app that only
+// wants to set its licence imports `@svgrid/enterprise/license` and never
+// pulls the component barrel (the package has no `sideEffects` flag, so a
+// barrel import carries every module it reaches into the importer's chunk).
+export { dismissUnlicensedNudge } from './watermark.js';
 let currentKey = null;
 let noticedDev = false;
 let noticedExpired = false;

package/dist/node/studio.js

@@ -1,5 +1,4 @@
 import { defaultThemePreset, getThemePreset, resolveThemeTokens as resolveThemeTokens$1, themePresets } from "@svgrid/grid/themes";
-import { isRangeOperator, isSetOperator, isValuelessOperator } from "@svgrid/grid/filtering";
 //#region src/schema.ts
 /** `first_name` / `firstName` / `first-name` -> `First Name`. */
 function titleCase$2(field) {
@@ -1130,7 +1129,7 @@ function introspectOpenApi(specText) {
 }
 //#endregion
 //#region src/studio/introspect-db.ts
-function truthy$1(v) {
+function truthy(v) {
 	return v === 1 || v === "1" || v === true;
 }
 function identQuote(name) {
@@ -1165,7 +1164,7 @@ function fieldFrom(name, rawType, pk, notNull) {
 }
 /** Map catalog rows (aliased name/type/nullable/pk) from information_schema dialects. */
 function infoSchemaFields(rows) {
-	return rows.map((r) => fieldFrom(String(r.name), String(r.type ?? ""), truthy$1(r.pk), !truthy$1(r.nullable)));
+	return rows.map((r) => fieldFrom(String(r.name), String(r.type ?? ""), truthy(r.pk), !truthy(r.nullable)));
 }
 /** Map SQLite `PRAGMA table_info` rows (name/type/notnull/pk-as-index). */
 function sqliteFields(rows) {
@@ -2011,112 +2010,6 @@ function scaffoldApp(schemas, options = {}) {
 	return { files };
 }
 //#endregion
-//#region src/expressions/expression-columns.ts
-/**
-* Column metadata for the expression layer - the small, self-contained operator
-* catalogue the editor draws from, plus name <-> id resolution for the
-* `[Bracketed Name]` reference syntax.
-*
-* The operator set mirrors the grid's own filter row (text / number / date),
-* so an expression's operators line up with what a user already knows from the
-* column menu.
-*
-* Identity and input-shape semantics come from the grid's shared catalogue, so
-* the two surfaces cannot disagree about which operators exist or which need a
-* chip input / no input / a second value. Labels and ordering stay local on
-* purpose: the editor leads with `Equals` where the filter menu leads with
-* `Contains`, and each is right for its context.
-*/
-var TEXT = ["text"];
-var NUM = ["number"];
-var DATES = ["date", "datetime"];
-var ALL = [
-	"text",
-	"number",
-	"date",
-	"datetime",
-	"boolean"
-];
-/** The full operator catalogue, ordered as the editor should present it. */
-var OPERATORS = [
-	{
-		value: "equals",
-		label: "Equals",
-		types: ALL
-	},
-	{
-		value: "notEquals",
-		label: "Not equals",
-		types: ALL
-	},
-	{
-		value: "contains",
-		label: "Contains",
-		types: TEXT
-	},
-	{
-		value: "notContains",
-		label: "Not contains",
-		types: TEXT
-	},
-	{
-		value: "startsWith",
-		label: "Starts with",
-		types: TEXT
-	},
-	{
-		value: "endsWith",
-		label: "Ends with",
-		types: TEXT
-	},
-	{
-		value: "regex",
-		label: "Matches regex",
-		types: TEXT
-	},
-	{
-		value: "greaterThan",
-		label: "Greater than",
-		types: [...NUM, ...DATES]
-	},
-	{
-		value: "lessThan",
-		label: "Less than",
-		types: [...NUM, ...DATES]
-	},
-	{
-		value: "between",
-		label: "Between",
-		types: [...NUM, ...DATES]
-	},
-	{
-		value: "in",
-		label: "In",
-		types: ["text", "number"]
-	},
-	{
-		value: "notIn",
-		label: "Not in",
-		types: ["text", "number"]
-	},
-	{
-		value: "isBlank",
-		label: "Is blank",
-		types: ALL
-	},
-	{
-		value: "isNotBlank",
-		label: "Is not blank",
-		types: ALL
-	}
-].map((op) => ({
-	...op,
-	...isValuelessOperator(op.value) ? { valueless: true } : {},
-	...isSetOperator(op.value) ? { set: true } : {},
-	...isRangeOperator(op.value) ? { range: true } : {}
-}));
-new Map(OPERATORS.map((op) => [op.value, op]));
-//#endregion
 //#region src/expressions/parse.ts
 /** Every column id referenced anywhere in a predicate (deduped, in order). */
 function collectColumnRefs(expr) {
@@ -9056,11 +8949,34 @@ var GENERATED_UI_SURFACE = {
 				"description": "Prepend a header row (the column labels) to copied cell ranges, so pasting into Excel / Sheets includes the headers. Applies per copied range.",
 				"group": "common"
 			},
+			{
+				"key": "processCellForFill",
+				"label": "Process Cell For Fill",
+				"type": "json",
+				"description": "Decide what the fill handle writes into one cell, ahead of the grid's own pattern rules (series, weekdays, \"Item 1\"). Receives the source cell's value and how far the target sits from it; return the value to write, or `undefined` to let the pattern decide. A spreadsheet uses it to move a formula's references by the distance filled, which the pattern rules would otherwise mangle (\"=A1+B1\" reads as \"Item 1\").",
+				"code": true,
+				"group": "advanced"
+			},
 			{
 				"key": "processCellForClipboard",
 				"label": "Process Cell For Clipboard",
 				"type": "json",
-				"description": "Transform each cell value on its way to the clipboard - e.g. strip currency symbols, expand codes to labels, or redact. Receives the display value plus the row/column context; return the string (or value) to copy.",
+				"code": true,
+				"group": "advanced"
+			},
+			{
+				"key": "clipboardHtml",
+				"label": "Clipboard Html",
+				"type": "json",
+				"description": "An HTML rendering of what Ctrl+C copies, written to the clipboard as `text/html` beside the TSV. Excel and Google Sheets read the HTML first, so a table with inline styles pastes into them with its formats, and the same markup can carry what the text cannot (a formula in a `data-` attribute) for a round trip back into a grid that reads it. Called after every cell has been through `processCellForClipboard`, with the rectangles copied and the text about to be written. Return nothing to write text alone. Runs synchronously inside the key press, which is what the clipboard needs.",
+				"code": true,
+				"group": "advanced"
+			},
+			{
+				"key": "processCellFromClipboard",
+				"label": "Process Cell From Clipboard",
+				"type": "json",
+				"description": "Transform each cell on its way IN from the clipboard, before the grid coerces it for the column's editor. Symmetric with `processCellForClipboard`: the pair is what lets a round trip survive. Receives the raw clipboard text for the cell plus where it is landing. Return the value to write, or `undefined` to leave the cell untouched. This is also the seam a feature pack uses to take over a paste entirely: `@svgrid/enterprise`'s paste-special reads the clipboard's `text/html` for formats and formulas and writes through here.",
 				"code": true,
 				"group": "advanced"
 			},
@@ -9071,6 +8987,13 @@ var GENERATED_UI_SURFACE = {
 				"description": "Inline cell editing: F2 or double-click opens an editor in the active cell, Enter commits, Esc cancels. Off by default. A column still needs an `editorType` to pick its editor (text, number, date, checkbox, list, ...); without one it gets a plain text editor. `editable` is the shortcut alias and wins over this.",
 				"group": "common"
 			},
+			{
+				"key": "editOnSecondClick",
+				"label": "Edit On Second Click",
+				"type": "boolean",
+				"description": "A click on the cell that is already active opens its editor, the way a second click on a selected file name starts renaming it. On by default. A spreadsheet turns it off: Excel edits on double-click or F2 only, and a user clicking the cell they are on to get back to it after a dialog would otherwise find the next shortcut typed into an editor.",
+				"group": "common"
+			},
 			{
 				"key": "fullRowEditing",
 				"label": "Full Row Editing",
@@ -9276,6 +9199,20 @@ var GENERATED_UI_SURFACE = {
 				"description": "Rows to pin to the TOP of the grid - rendered above the regular rows and sticky-positioned so they stay visible while the user scrolls. Typical use: a \"totals\" or \"headline\" row that should always be in view. Rows are read-only (no inline editing, no row-selection checkbox). They share the column schema with the main grid; field/format/cell/cellClass all apply.",
 				"group": "common"
 			},
+			{
+				"key": "frozenRows",
+				"label": "Frozen Rows",
+				"type": "number",
+				"description": "Freeze the first N rows: they stay under the header while the body scrolls, and unlike `pinnedTopRows` they are the grid's own rows, still editable, selectable and numbered as rows 1..N. Excel's Freeze Panes, for the row half; the column half is `columnPinning`. Under `virtualization` the frozen rows are always rendered and the window skips them.",
+				"group": "common"
+			},
+			{
+				"key": "mergedCells",
+				"label": "Merged Cells",
+				"type": "json",
+				"description": "Merged cells: rectangles drawn as one cell, a spreadsheet's Merge & Center. Each entry is the top-left cell (display indices) and how many rows and columns it covers. The origin's td takes the span and shows the origin's value; the covered cells are not drawn, a selection grows to whole merges, the active cell inside a merge is its origin, and the arrow keys step over a merge as one cell. A merge that crosses the frozen boundary or the rendered window is drawn in parts, one per band. The grid does not write into covered cells on its own; a consumer that merges cells keeps them empty or marks them read-only through the column's `editable`.",
+				"group": "common"
+			},
 			{
 				"key": "pinnedBottomRows",
 				"label": "Pinned Bottom Rows",
@@ -9352,6 +9289,24 @@ var GENERATED_UI_SURFACE = {
 				"prop": "onPaginationChange",
 				"description": "Fires when the user changes page or page size while `externalPagination` is on. Fetch that page and update `data` / `rowCount` / `pageIndex`."
 			},
+			{
+				"key": "columnResize",
+				"label": "Column Resize",
+				"prop": "onColumnResize",
+				"description": "The user dragged a column's edge (or double-clicked it to autosize). Programmatic `api.setColumnWidth` does not fire it."
+			},
+			{
+				"key": "rowResize",
+				"label": "Row Resize",
+				"prop": "onRowResize",
+				"description": "The user dragged a row's edge, or double-clicked it: `height` is then `null`, the row back at its declared height. Programmatic `api.setRowHeight` does not fire it."
+			},
+			{
+				"key": "pasteClipboard",
+				"label": "Paste Clipboard",
+				"prop": "onPasteClipboard",
+				"description": "Take over a paste. Receives the clipboard's `text/plain` and, when the source put one there, its `text/html` (Excel's carries formats and formulas; a grid's own `clipboardHtml` carries whatever it chose to). Return `true` to say the paste was applied; anything else lets the grid paste the text as it always has. Runs inside one history group, so every `setCellValue` and `recordUndo` the handler makes is one Ctrl+Z. With this set, Ctrl+V lets the browser's own `paste` event through (that is where the unsanitised HTML is), and the async Clipboard API is the fallback for a browser that does not deliver it. `source` says which path the payload came by."
+			},
 			{
 				"key": "apiReady",
 				"label": "Api Ready",
@@ -11408,7 +11363,8 @@ var GRID_CURATED_PROPS = /* @__PURE__ */ new Set([
 	"conditionalFormats",
 	"features",
 	"editable",
-	"enableInlineEditing"
+	"enableInlineEditing",
+	"icons"
 ]);
 /** The Grid's raw prop surface for the "All properties" panel: every extracted SvGrid
 *  prop the curated controls do NOT already manage. Sorted by group then label. */
@@ -11423,6 +11379,83 @@ function gridPropSurface() {
 	};
 	return g.props.filter((p) => !GRID_CURATED_PROPS.has(p.key)).map((p) => ({ ...p })).sort((a, b) => order[a.group ?? "common"] - order[b.group ?? "common"] || a.label.localeCompare(b.label));
 }
+var GRID_ICON_GROUP_RULES = [
+	{
+		label: "Header + column menu",
+		match: (n) => [
+			"sort",
+			"sort-asc",
+			"sort-desc",
+			"filter",
+			"menu",
+			"chevron-down",
+			"chevron-right",
+			"autosize",
+			"columns",
+			"reset"
+		].includes(n)
+	},
+	{
+		label: "Filter operators",
+		match: (n) => n.startsWith("op-")
+	},
+	{
+		label: "Pinning",
+		match: (n) => n === "pin-left" || n === "pin-right" || n === "unpin"
+	},
+	{
+		label: "Rows + grouping",
+		match: (n) => [
+			"group",
+			"group-add",
+			"row-number",
+			"pinned-row-top",
+			"pinned-row-bottom",
+			"drag-handle",
+			"breadcrumb-separator"
+		].includes(n)
+	},
+	{
+		label: "Toolbar + overlays",
+		match: (n) => [
+			"search",
+			"tool-panel",
+			"chart",
+			"advanced-filter",
+			"column-group-caret"
+		].includes(n)
+	},
+	{
+		label: "Pager",
+		match: (n) => n.startsWith("page-")
+	},
+	{
+		label: "Find + move",
+		match: (n) => n.startsWith("find-") || n.startsWith("move-")
+	},
+	{
+		label: "Close + clear",
+		match: (n) => [
+			"x",
+			"close",
+			"clear",
+			"remove"
+		].includes(n)
+	},
+	{
+		label: "Other",
+		match: () => true
+	}
+];
+/** Split the grid's icon catalogue into the picker's display groups, in order,
+*  dropping any that came out empty. Takes the names rather than importing them so
+*  the studio metadata module stays free of a runtime dependency on the grid. */
+function gridIconGroups(names) {
+	return GRID_ICON_GROUP_RULES.map((rule, i) => ({
+		label: rule.label,
+		names: names.filter((n) => GRID_ICON_GROUP_RULES.findIndex((c) => c.match(n)) === i)
+	})).filter((g) => g.names.length);
+}
 var GRID_API_UNSETTABLE = /* @__PURE__ */ new Set([
 	"data",
 	"columns",
@@ -15880,7 +15913,7 @@ function hasFieldConditions(schema) {
 *
 * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
 */
-var SVGRID_VERSION = "3.0.0";
+var SVGRID_VERSION = "3.0.2";
 //#endregion
 //#region src/studio/emit-project.ts
 var has = (blocks, kind) => blocks.some((b) => b.config.kind === kind);
@@ -16000,17 +16033,18 @@ function blockMarkup(entity, schemaVar, typeName, block, resolve, ctx = { hasRec
 			const idSafe = block.id.replace(/-/g, "_");
 			const colVar = `columns_${idSafe}`;
 			const emptyMsg = `No ${(entity.label ?? entity.name).toLowerCase()} yet.`;
+			const gridIcons = gridIconParts(cfg, idSafe);
 			if (cfg.scheduler) {
 				const schDisp = relationDisplayFields(ctx.rawEntity ?? entity, resolve);
 				const schAsText = (f) => schDisp.get(f) ?? f;
 				return `    <div ${span}${cls}>
-      <SvGrid
+${gridIcons.decls}      <SvGrid
         data={allRows}
         columns={${colVar}}
         getRowId={(r) => String((r as Record<string, unknown>)[idField])}
         loading={!allRowsReady}
         scheduler={${schedulerConfigExpr(cfg.scheduler, typeName, schAsText)}}
-        containerHeight=${ctx.pane ? "\"100%\"" : `{${block.height ?? 640}}`}
+${gridIcons.attr ? `        ${gridIcons.attr}\n` : ""}        containerHeight=${ctx.pane ? "\"100%\"" : `{${block.height ?? 640}}`}
       />
     </div>`;
 			}
@@ -16090,6 +16124,7 @@ function blockMarkup(entity, schemaVar, typeName, block, resolve, ctx = { hasRec
 			if (apiBody.length === 1 && ctx.captureApi && !grouped) lines.push(`onApiReady={(a) => (${ctx.captureApi} = a)}`);
 			else if (apiBody.length) lines.push(`onApiReady={(a) => { ${apiBody.join("; ")} }}`);
 			lines.push(`containerHeight=${ctx.pane ? "\"100%\"" : `{${block.height ?? 360}}`}`);
+			if (gridIcons.attr) lines.push(gridIcons.attr);
 			if (cfg.props && Object.keys(cfg.props).length) {
 				const emitted = new Set(lines.map((l) => l.split(/[=\s]/)[0]));
 				for (const [k, v] of Object.entries(cfg.props)) {
@@ -16097,8 +16132,9 @@ function blockMarkup(entity, schemaVar, typeName, block, resolve, ctx = { hasRec
 					lines.push(v === true ? k : `${k}={${JSON.stringify(v)}}`);
 				}
 			}
+			const exportBar = gridHasExport(cfg) && ctx.captureApi ? exportToolbarMarkup(cfg.export, ctx.captureApi, entity.name) : "";
 			return `    <div ${span}${cls}>
-${gridHasExport(cfg) && ctx.captureApi ? exportToolbarMarkup(cfg.export, ctx.captureApi, entity.name) : ""}      <SvGrid
+${gridIcons.decls}${exportBar}      <SvGrid
         ${lines.join("\n        ")}
       />
     </div>`;
@@ -16434,6 +16470,41 @@ function conditionalFormatsExpr(cfg) {
 	}
 	return entries.length ? `[${entries.join(", ")}]` : null;
 }
+/** Snippet declarations + the `icons={...}` attribute for a grid's no-code icon
+*  overrides. SvGrid's `icons` prop takes a map of SNIPPETS, so each override has to
+*  become a real snippet declared next to the grid; it cannot be a value the way
+*  every other prop in the panel is. That is the whole reason icons get their own
+*  config field instead of riding along in `props`, which is JSON.stringify'd.
+*
+*  A value that reads as a tag is emitted as markup, so a user can paste an inline
+*  `<svg>` or reference a component they imported in code-behind. Anything else goes
+*  through an expression rather than as bare template text, so a glyph containing a
+*  brace, a quote or an angle bracket cannot break the page it lands in. That last
+*  case is not hypothetical: `<` and `>` are perfectly good pager arrows, which is
+*  why this looks for a whole tag rather than just a leading bracket.
+*
+*  Snippets are declared inside the block's own wrapper and prefixed with the block
+*  id, so two grids on one screen can override the same icon differently. */
+function gridIconParts(cfg, idSafe) {
+	const entries = Object.entries(cfg.icons ?? {}).filter(([name, v]) => name && typeof v === "string" && v.trim() !== "");
+	if (!entries.length) return {
+		decls: "",
+		attr: ""
+	};
+	const decls = [];
+	const pairs = [];
+	for (const [name, glyph] of entries) {
+		const snip = `icon_${idSafe}_${name.replace(/[^A-Za-z0-9]/g, "_")}`;
+		const g = glyph.trim();
+		const body = /^<[a-zA-Z][\s\S]*>$/.test(g) ? g : `{${jsStr(glyph)}}`;
+		decls.push(`      {#snippet ${snip}()}${body}{/snippet}`);
+		pairs.push(`${jsStr(name)}: ${snip}`);
+	}
+	return {
+		decls: decls.join("\n") + "\n",
+		attr: `icons={{ ${pairs.join(", ")} }}`
+	};
+}
 var fieldLabel = (f) => f.label ?? f.field;
 /** Stable per-block identifiers for a filter panel's state + apply function. */
 var facetNames = (block) => {
@@ -41586,4 +41657,4 @@ function checkLicenseKey(key, now = /* @__PURE__ */ new Date()) {
 	};
 }
 //#endregion
-export { CANVAS_COLS, CANVAS_GAP_PX, CANVAS_ROW_PX, CONTAINER_CHILD_KINDS, CONTAINER_DISPLAY_KINDS, CRUD_ACTIONS, DEFAULT_PORT, DRIVER_PACKAGE, FORM_SUBMIT, GRID_API_MEMBERS, GRID_CURATED_PROPS, GRID_EVENTS, GRID_PRESETS, MANAGED_END, MANAGED_START, ON_LOAD, PANE_LAYOUTS, STANDARD_UI_EVENTS, TAB_CHILD_KINDS, TRIGGER_EVENTS, UI_COMPONENT_REGISTRY, UserError, addAccordionBlock, addAccordionComponent, addAccordionSection, addBlock, addBlockAt, addComponentBlock, addCrudSuite, addEntity, addFormSection, addFreestandingScreen, addHandlerStep, addScreen, addScreenAction, addScreenFromTemplate, addStateVar, addTab, addTabBlock, addTabComponent, applyGridPreset, blockClassName, blockColumns, blockPalette, blockStyleCss, buildCanvasLayout, buildConnectionString, buildCopilotMessages, buildDockLayout, buildStudioBugReport, canvasOpts, canvasRectOf, changeSlot, checkLicenseKey, clickSlot, compileCondition, compileHandlerSteps, compileStep, compileTriggerStep, compileTriggerSteps, compileValue, componentHandleMembers, componentHandleName, componentHasBindings, countTableRows, createProject, crudAppFromSchemas, crudSuiteScreens, csvToEntity, ctxAmbientDts, ctxCompletions, dashScreen, defaultBlockConfig, defaultEntitySource, defaultScreenFor, defaultStudioTheme, deployCommands, detailScreen, detectDelimiter, disableScreenCode, dockOpts, dockPaneIds, dockPaneTitleOf, duplicateBlock, duplicateScreen, emitEntityModules, emitStudioApp, emitStudioAppBundle, emitStudioFragment, emitStudioProject, enableScreenCode, entityDataSource, entityOf, entityScreenPage, eventSlot, flattenBlocks, formControlSettings, formControlsFor, formPlan, formScreen, generateRows, generateValue, getLiveDataSample, getSampleApp, getStarterDataset, getStudioTheme, gridApiSettableProps, gridColumns, gridConfig, gridOpts, gridPresetLabel, gridPropSurface, inferType, insertBlock, introspectDatabase, introspectDrizzle, introspectDrizzleAll, introspectJson, introspectOpenApi, introspectPrisma, introspectPrismaAll, isDarkTheme, isFieldHidden, isFileDialect, isPaneLayout, isProjectValid, isTenantScoped, isUserError, linkRelationLabels, listDatabaseTables, listScreen, liveDataSamples, mapSqlType, mergeBlockStyle, mergeManaged, missingEnvKeys, moveBlock, moveFormField, moveFormFields, moveFormSection, moveHandlerStep, parseConnectionString, parseCsv, parseProject, parseSelection, pickLabelField, prepareEntities, probeConnection, projectFromModelText, reconcileDock, redactConnectionString, refineField, refineFields, removeAccordionBlock, removeAccordionSection, removeBlock, removeEntity, removeFormSection, removeScreen, removeScreenAction, removeStateVar, removeTab, removeTabBlock, renameAccordionSection, renameTab, reorderBlock, reorderScreen, reseedScreenDock, resolveDeployTarget, resolveIdField, resolveSchema, resolveSchemas, resolveThemeTokens, resolveThemeTokensFor, roleCanAction, roleCanScreen, rowSelectSlot, runStudioAdd, runStudioAddApp, runStudioInit, runtimeDeps, sampleApps, sanitizeClassName, sanitizeProject, sanitizeStudioProject, scaffold, scaffoldApp, schemaToColumns, schemaToFormFields, screenDataset, screenFromTemplate, screenHandles, screenLayoutOf, seedUsers, serializeProject, setAccordionMultiple, setAuth, setCanvasRect, setComponentBinding, setComponentName, setDataLayer, setDataSource, setDeployTarget, setDockPaneTitle, setEntityDataSource, setEntityForm, setFieldConditions, setFieldHidden, setFieldInput, setFormColumns, setHandlerBody, setHandlerSteps, setJob, setLayoutOpts, setScreenDock, setScreenHandlersSource, setScreenLayout, setScreenRenderGrid, setScreenRenderMode, setShell, setTenancy, setTheme, setThemePreset, setTrigger, skipUserOwned, splitOpts, ssrEligible, ssrScreenShape, stackOpts, starterDatasets, starterProject, stateInitExpr, stateTsType, statusPills, stepsToCode, studioDeployInfo, studioThemes, suggestFormSections, summarizeVerify, syncDockPanes, tenantField, themeStyleString, triggersOf, uiComponentSpec, updateBlock, updateEntity, updateEntityField, updateFormSection, updateHandlerStep, updateScreen, updateStateVar, validateProject, verifyScaffold, withSsrDefaults };
+export { CANVAS_COLS, CANVAS_GAP_PX, CANVAS_ROW_PX, CONTAINER_CHILD_KINDS, CONTAINER_DISPLAY_KINDS, CRUD_ACTIONS, DEFAULT_PORT, DRIVER_PACKAGE, FORM_SUBMIT, GRID_API_MEMBERS, GRID_CURATED_PROPS, GRID_EVENTS, GRID_PRESETS, MANAGED_END, MANAGED_START, ON_LOAD, PANE_LAYOUTS, STANDARD_UI_EVENTS, TAB_CHILD_KINDS, TRIGGER_EVENTS, UI_COMPONENT_REGISTRY, UserError, addAccordionBlock, addAccordionComponent, addAccordionSection, addBlock, addBlockAt, addComponentBlock, addCrudSuite, addEntity, addFormSection, addFreestandingScreen, addHandlerStep, addScreen, addScreenAction, addScreenFromTemplate, addStateVar, addTab, addTabBlock, addTabComponent, applyGridPreset, blockClassName, blockColumns, blockPalette, blockStyleCss, buildCanvasLayout, buildConnectionString, buildCopilotMessages, buildDockLayout, buildStudioBugReport, canvasOpts, canvasRectOf, changeSlot, checkLicenseKey, clickSlot, compileCondition, compileHandlerSteps, compileStep, compileTriggerStep, compileTriggerSteps, compileValue, componentHandleMembers, componentHandleName, componentHasBindings, countTableRows, createProject, crudAppFromSchemas, crudSuiteScreens, csvToEntity, ctxAmbientDts, ctxCompletions, dashScreen, defaultBlockConfig, defaultEntitySource, defaultScreenFor, defaultStudioTheme, deployCommands, detailScreen, detectDelimiter, disableScreenCode, dockOpts, dockPaneIds, dockPaneTitleOf, duplicateBlock, duplicateScreen, emitEntityModules, emitStudioApp, emitStudioAppBundle, emitStudioFragment, emitStudioProject, enableScreenCode, entityDataSource, entityOf, entityScreenPage, eventSlot, flattenBlocks, formControlSettings, formControlsFor, formPlan, formScreen, generateRows, generateValue, getLiveDataSample, getSampleApp, getStarterDataset, getStudioTheme, gridApiSettableProps, gridColumns, gridConfig, gridIconGroups, gridOpts, gridPresetLabel, gridPropSurface, inferType, insertBlock, introspectDatabase, introspectDrizzle, introspectDrizzleAll, introspectJson, introspectOpenApi, introspectPrisma, introspectPrismaAll, isDarkTheme, isFieldHidden, isFileDialect, isPaneLayout, isProjectValid, isTenantScoped, isUserError, linkRelationLabels, listDatabaseTables, listScreen, liveDataSamples, mapSqlType, mergeBlockStyle, mergeManaged, missingEnvKeys, moveBlock, moveFormField, moveFormFields, moveFormSection, moveHandlerStep, parseConnectionString, parseCsv, parseProject, parseSelection, pickLabelField, prepareEntities, probeConnection, projectFromModelText, reconcileDock, redactConnectionString, refineField, refineFields, removeAccordionBlock, removeAccordionSection, removeBlock, removeEntity, removeFormSection, removeScreen, removeScreenAction, removeStateVar, removeTab, removeTabBlock, renameAccordionSection, renameTab, reorderBlock, reorderScreen, reseedScreenDock, resolveDeployTarget, resolveIdField, resolveSchema, resolveSchemas, resolveThemeTokens, resolveThemeTokensFor, roleCanAction, roleCanScreen, rowSelectSlot, runStudioAdd, runStudioAddApp, runStudioInit, runtimeDeps, sampleApps, sanitizeClassName, sanitizeProject, sanitizeStudioProject, scaffold, scaffoldApp, schemaToColumns, schemaToFormFields, screenDataset, screenFromTemplate, screenHandles, screenLayoutOf, seedUsers, serializeProject, setAccordionMultiple, setAuth, setCanvasRect, setComponentBinding, setComponentName, setDataLayer, setDataSource, setDeployTarget, setDockPaneTitle, setEntityDataSource, setEntityForm, setFieldConditions, setFieldHidden, setFieldInput, setFormColumns, setHandlerBody, setHandlerSteps, setJob, setLayoutOpts, setScreenDock, setScreenHandlersSource, setScreenLayout, setScreenRenderGrid, setScreenRenderMode, setShell, setTenancy, setTheme, setThemePreset, setTrigger, skipUserOwned, splitOpts, ssrEligible, ssrScreenShape, stackOpts, starterDatasets, starterProject, stateInitExpr, stateTsType, statusPills, stepsToCode, studioDeployInfo, studioThemes, suggestFormSections, summarizeVerify, syncDockPanes, tenantField, themeStyleString, triggersOf, uiComponentSpec, updateBlock, updateEntity, updateEntityField, updateFormSection, updateHandlerStep, updateScreen, updateStateVar, validateProject, verifyScaffold, withSsrDefaults };

package/dist/pivot-chart.d.ts

@@ -13,16 +13,40 @@
  *     measure). The grand-total column is excluded unless `includeTotals`.
  *   - values     = each leaf row's aggregated cell for that series column.
  */
-import type { ChartSpec, ChartType, TableFeatures } from '@svgrid/grid';
-import type { PivotResult } from './pivot';
+import { type CellFormatConfig, type ChartSpec, type ChartType, type TableFeatures } from '@svgrid/grid';
+import type { PivotResult } from './pivot.js';
+/** Options for {@link pivotToChartSpec}: the chart type and stacking, whether totals chart, a category cap, the measure's format and the value-axis name. */
 export type PivotChartOptions = {
     /** Chart type. Default `'bar'`. */
     type?: ChartType;
     /** Stack the series. Default false. */
     stacked?: boolean;
+    /** Stack to 100%. Implies `stacked`. Default false. */
+    stacked100?: boolean;
     /** Include the grand-total column / row as a series / category. Default false. */
     includeTotals?: boolean;
     /** Cap the number of categories (row leaves) charted. */
     maxCategories?: number;
+    /**
+     * The measure's cell format, carried to the chart as `valueFormat` (with
+     * `currency` and `locale`), so a cell the table shows as "$469,662" charts
+     * as "$470k" on the axis and "$469,662" in the tooltip rather than "470k".
+     * The designer passes the first value chip's format; with several
+     * measures in different formats, pass none and the chart formats plainly.
+     */
+    format?: CellFormatConfig;
+    /**
+     * Name the value axis. Default: the measure's label when the layout has
+     * one measure, nothing otherwise.
+     */
+    yAxisTitle?: string | null;
 };
+/**
+ * A computed pivot as a `ChartSpec` for the free chart: row leaves become
+ * categories (nested rows a grouped axis), column leaves the series, totals
+ * left out unless asked for, the measure's format carried over and an empty
+ * cell read as a gap. The designer's Chart view is this function, and the
+ * grid's own Chart panel runs the same mapping (`pivotResultToChartSpec` in
+ * `@svgrid/grid`) in pivot mode.
+ */
 export declare function pivotToChartSpec<TFeatures extends TableFeatures>(result: PivotResult<TFeatures>, opts?: PivotChartOptions): ChartSpec;

package/dist/pivot-chart.js

@@ -1,71 +1,27 @@
+/**
+ * Pivot -> chart bridge.
+ *
+ * Turns a computed {@link PivotResult} (the row/column/value matrix the pivot
+ * engine produces) into a core {@link ChartSpec} the free `SvGridChart` can
+ * render - so one pivot layout drives both a table and a chart (the Excel
+ * PivotTable <-> PivotChart pairing).
+ *
+ * Mapping:
+ *   - categories = the row-axis LEAF rows (deepest grouping; subtotals and the
+ *     grand-total row are skipped). With no row dims, the single total row.
+ *   - series     = the column-axis leaf value columns (one per col-path x
+ *     measure). The grand-total column is excluded unless `includeTotals`.
+ *   - values     = each leaf row's aggregated cell for that series column.
+ */
+import { pivotResultToChartSpec } from '@svgrid/grid';
+/**
+ * A computed pivot as a `ChartSpec` for the free chart: row leaves become
+ * categories (nested rows a grouped axis), column leaves the series, totals
+ * left out unless asked for, the measure's format carried over and an empty
+ * cell read as a gap. The designer's Chart view is this function, and the
+ * grid's own Chart panel runs the same mapping (`pivotResultToChartSpec` in
+ * `@svgrid/grid`) in pivot mode.
+ */
 export function pivotToChartSpec(result, opts = {}) {
-    const type = opts.type ?? 'bar';
-    // Category rows: the row-axis leaves. Fall back to the grand-total (single
-    // "All") row when no row dims are configured, then to every row.
-    let catRows = result.rows.filter((r) => r.__pivotKind === 'leaf');
-    if (!catRows.length)
-        catRows = result.rows.filter((r) => r.__pivotKind === 'grandTotal');
-    if (!catRows.length)
-        catRows = result.rows.slice();
-    if (opts.maxCategories && catRows.length > opts.maxCategories) {
-        catRows = catRows.slice(0, opts.maxCategories);
-    }
-    // Categories are the leaf's OWN label; when rows are nested, emit a parent
-    // tier (categoryGroups) so the axis reads "Americas | Canada · USA ..." as a
-    // grouped axis rather than colliding on a bare repeated leaf label.
-    const byId = new Map(result.rows.map((r) => [r.__pivotId, r]));
-    const ownLabel = (r) => String(r.__pivotLabel ?? '').trim() || '(blank)';
-    const categories = catRows.map(ownLabel);
-    const parentOf = (r) => r.__pivotParentId ? byId.get(r.__pivotParentId) : undefined;
-    const nested = catRows.length > 0 && catRows.every((r) => parentOf(r) !== undefined);
-    let categoryGroups;
-    if (nested) {
-        categoryGroups = [];
-        let prevId;
-        for (const r of catRows) {
-            const pid = r.__pivotParentId;
-            const last = categoryGroups[categoryGroups.length - 1];
-            if (last && pid === prevId)
-                last.span += 1;
-            else {
-                categoryGroups.push({ label: ownLabel(parentOf(r)), span: 1 });
-                prevId = pid;
-            }
-        }
-    }
-    const leaves = [];
-    const walk = (cols, path) => {
-        for (const c of cols ?? []) {
-            if (!c || c.id === '__pivotRowHeader')
-                continue;
-            // Skip the grand-total column group (and its leaves) unless asked for.
-            if (!opts.includeTotals && typeof c.id === 'string' && c.id.startsWith('pv_group__grand'))
-                continue;
-            if (Array.isArray(c.columns))
-                walk(c.columns, [...path, String(c.header ?? '')]);
-            else if (typeof c.id === 'string')
-                leaves.push({ id: c.id, path, header: String(c.header ?? '') });
-        }
-    };
-    walk(result.columns, []);
-    const filtered = opts.includeTotals ? leaves : leaves.filter((l) => !l.id.includes('__total'));
-    const uniqueHeaders = new Set(filtered.map((l) => l.header));
-    const series = filtered.map((l) => ({
-        label: l.path.length === 0
-            ? l.header
-            : uniqueHeaders.size > 1
-                ? [...l.path, l.header].join(' · ')
-                : l.path.join(' · '),
-        values: catRows.map((r) => {
-            const v = r[l.id];
-            return typeof v === 'number' ? v : Number(v) || 0;
-        }),
-    }));
-    return {
-        type,
-        categories,
-        series,
-        ...(categoryGroups && categoryGroups.length > 1 ? { categoryGroups } : {}),
-        ...(opts.stacked ? { stacked: true } : {}),
-    };
+    return pivotResultToChartSpec(result, opts);
 }

package/dist/pivot-designer.d.ts

@@ -7,7 +7,7 @@
  * normalisation + serialisation without instantiating the component.
  */
 import type { CellFormatConfig } from '@svgrid/grid';
-import type { PivotAggregatorId } from './pivot';
+import type { PivotAggregatorId } from './pivot.js';
 /** One field the designer offers in its left-rail picker.
  *  Dimensions land in Rows by default; measures land in Values. */
 export type PivotField<T extends Record<string, unknown> = Record<string, unknown>> = {