@wordpress/widget-dashboard 0.1.0

package/build-module/hooks/use-dashboard-container-column-count.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/use-dashboard-container-column-count.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { useResizeObserver, useMergeRefs } from '@wordpress/compose';\nimport {\n\tuseLayoutEffect,\n\tuseMemo,\n\tuseState,\n\ttype Ref,\n} from '@wordpress/element';\n\n/**\n * Internal dependencies\n */\nimport { resolveDashboardColumnCount } from '../utils/resolve-dashboard-column-count/resolve-dashboard-column-count';\n\ninterface UseDashboardContainerColumnCountResult {\n\tcontainerRef: Ref< HTMLDivElement >;\n\tcolumnCount: number;\n}\n\n/**\n * Tracks the dashboard grid container width and maps it to an opinionated\n * column count (4 → 2 → 1). Measurement is container-based via\n * `ResizeObserver`, not viewport media queries.\n *\n * @param {Ref< HTMLDivElement >} [forwardedRef] Ref forwarded from the grid wrapper.\n */\nexport function useDashboardContainerColumnCount(\n\tforwardedRef?: Ref< HTMLDivElement >\n): UseDashboardContainerColumnCountResult {\n\tconst [ container, setContainer ] = useState< HTMLDivElement | null >(\n\t\tnull\n\t);\n\tconst [ containerWidth, setContainerWidth ] = useState( 0 );\n\n\tconst resizeObserverRef = useResizeObserver( ( [ { contentRect } ] ) => {\n\t\tsetContainerWidth( contentRect.width );\n\t} );\n\n\tconst containerRef = useMergeRefs( [\n\t\tsetContainer,\n\t\tresizeObserverRef,\n\t\tforwardedRef ?? null,\n\t] );\n\n\tuseLayoutEffect( () => {\n\t\tif ( ! container ) {\n\t\t\treturn;\n\t\t}\n\t\tconst { width } = container.getBoundingClientRect();\n\t\tif ( width > 0 ) {\n\t\t\tsetContainerWidth( width );\n\t\t}\n\t}, [ container ] );\n\n\tconst columnCount = useMemo(\n\t\t() => resolveDashboardColumnCount( containerWidth ),\n\t\t[ containerWidth ]\n\t);\n\n\treturn { containerRef, columnCount };\n}\n"],
+  "mappings": ";AAGA,SAAS,mBAAmB,oBAAoB;AAChD;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,OAEM;AAKP,SAAS,mCAAmC;AAcrC,SAAS,iCACf,cACyC;AACzC,QAAM,CAAE,WAAW,YAAa,IAAI;AAAA,IACnC;AAAA,EACD;AACA,QAAM,CAAE,gBAAgB,iBAAkB,IAAI,SAAU,CAAE;AAE1D,QAAM,oBAAoB,kBAAmB,CAAE,CAAE,EAAE,YAAY,CAAE,MAAO;AACvE,sBAAmB,YAAY,KAAM;AAAA,EACtC,CAAE;AAEF,QAAM,eAAe,aAAc;AAAA,IAClC;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,EACjB,CAAE;AAEF,kBAAiB,MAAM;AACtB,QAAK,CAAE,WAAY;AAClB;AAAA,IACD;AACA,UAAM,EAAE,MAAM,IAAI,UAAU,sBAAsB;AAClD,QAAK,QAAQ,GAAI;AAChB,wBAAmB,KAAM;AAAA,IAC1B;AAAA,EACD,GAAG,CAAE,SAAU,CAAE;AAEjB,QAAM,cAAc;AAAA,IACnB,MAAM,4BAA6B,cAAe;AAAA,IAClD,CAAE,cAAe;AAAA,EAClB;AAEA,SAAO,EAAE,cAAc,YAAY;AACpC;",
+  "names": []
+}

package/build-module/index.mjs

@@ -0,0 +1,18 @@
+// packages/widget-dashboard/src/index.ts
+import { WidgetDashboard } from "./widget-dashboard.mjs";
+import { WIDGET_DASHBOARD_COLUMN_COUNT } from "./types.mjs";
+import { DEFAULT_GRID } from "./utils/default-grid/index.mjs";
+import { normalizeGridSettings } from "./utils/normalize-grid-settings/index.mjs";
+import {
+  ROW_HEIGHT_PRESETS,
+  DEFAULT_ROW_HEIGHT
+} from "./utils/row-height-presets/index.mjs";
+export {
+  DEFAULT_GRID,
+  DEFAULT_ROW_HEIGHT,
+  ROW_HEIGHT_PRESETS,
+  WIDGET_DASHBOARD_COLUMN_COUNT,
+  WidgetDashboard,
+  normalizeGridSettings
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["export { WidgetDashboard } from './widget-dashboard';\nexport type { DashboardWidget, WidgetGridSettings } from './types';\nexport { WIDGET_DASHBOARD_COLUMN_COUNT } from './types';\nexport { DEFAULT_GRID } from './utils/default-grid';\nexport { normalizeGridSettings } from './utils/normalize-grid-settings';\nexport {\n\tROW_HEIGHT_PRESETS,\n\tDEFAULT_ROW_HEIGHT,\n} from './utils/row-height-presets';\n"],
+  "mappings": ";AAAA,SAAS,uBAAuB;AAEhC,SAAS,qCAAqC;AAC9C,SAAS,oBAAoB;AAC7B,SAAS,6BAA6B;AACtC;AAAA,EACC;AAAA,EACA;AAAA,OACM;",
+  "names": []
+}

package/build-module/lock-unlock.mjs

@@ -0,0 +1,11 @@
+// packages/widget-dashboard/src/lock-unlock.ts
+import { __dangerousOptInToUnstableAPIsOnlyForCoreModules } from "@wordpress/private-apis";
+var { lock, unlock } = __dangerousOptInToUnstableAPIsOnlyForCoreModules(
+  "I acknowledge private features are not for use in themes or plugins and doing so will break in the next version of WordPress.",
+  "@wordpress/widget-dashboard"
+);
+export {
+  lock,
+  unlock
+};
+//# sourceMappingURL=lock-unlock.mjs.map

package/build-module/lock-unlock.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/lock-unlock.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { __dangerousOptInToUnstableAPIsOnlyForCoreModules } from '@wordpress/private-apis';\n\nexport const { lock, unlock } =\n\t__dangerousOptInToUnstableAPIsOnlyForCoreModules(\n\t\t'I acknowledge private features are not for use in themes or plugins and doing so will break in the next version of WordPress.',\n\t\t'@wordpress/widget-dashboard'\n\t);\n"],
+  "mappings": ";AAGA,SAAS,wDAAwD;AAE1D,IAAM,EAAE,MAAM,OAAO,IAC3B;AAAA,EACC;AAAA,EACA;AACD;",
+  "names": []
+}

package/build-module/types.mjs

@@ -0,0 +1,6 @@
+// packages/widget-dashboard/src/types.ts
+var WIDGET_DASHBOARD_COLUMN_COUNT = 4;
+export {
+  WIDGET_DASHBOARD_COLUMN_COUNT
+};
+//# sourceMappingURL=types.mjs.map

package/build-module/types.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": ["/**\n * Dashboard-specific types: `DashboardWidget`, grid settings, and the\n * `WidgetDashboard` prop bag.\n *\n * The widget contract types (`WidgetName`, `WidgetType`, `WidgetRenderProps`,\n * `ResolveWidgetModule`) live in `@wordpress/widget-primitives` and are\n * imported from there directly; this module does not re-export them.\n */\n\n/**\n * External dependencies\n */\nimport type { ReactNode } from 'react';\n\n/**\n * WordPress dependencies\n */\nimport type {\n\tDashboardGridLayoutItem,\n\tDashboardLanesLayoutItem,\n} from '@wordpress/grid';\nimport type {\n\tWidgetName,\n\tWidgetType,\n\tResolveWidgetModule,\n} from '@wordpress/widget-primitives';\n\nexport type GridTilePlacement = Omit< DashboardGridLayoutItem, 'key' >;\nexport type MasonryTilePlacement = Omit< DashboardLanesLayoutItem, 'key' >;\n\n/**\n * Storage shape for a widget's placement.\n *\n * Structurally a union of every supported per-model shape, but the\n * intended invariant is stronger than the type suggests: every\n * placement in a given layout must match the shape of the currently\n * active `gridSettings.model`. `migrateLayout` is the only correct\n * way to transition placements across model changes; the render\n * layer is allowed to trust the active model and treat each\n * placement as the matching shape.\n *\n * The type system cannot enforce that invariant on its own (there is\n * no discriminator on the placement itself), so consider this union a\n * declaration of which shapes are *valid*, not which shape any given\n * placement happens to be at runtime.\n */\nexport type DashboardTilePlacement = GridTilePlacement | MasonryTilePlacement;\n\n/**\n * A widget placed on the dashboard.\n *\n * A `WidgetType` describes the blueprint. A `DashboardWidget` is a\n * concrete placement of that type on a specific dashboard: its unique\n * id, the type it references, user-configured attributes, and its\n * `placement` in the grid.\n */\nexport interface DashboardWidget< Item = unknown > {\n\t/**\n\t * Unique instance identifier.\n\t */\n\tuuid: string;\n\n\t/**\n\t * Widget type name — must match a `WidgetType.name` in `widgetTypes`.\n\t */\n\ttype: WidgetName;\n\n\t/**\n\t * User-configured attributes for this instance.\n\t */\n\tattributes?: Item;\n\n\t/**\n\t * Grid-model-specific placement (column/row spans, ordering,\n\t * etc.). Must match the shape implied by the dashboard's active\n\t * `gridSettings.model`; see `DashboardTilePlacement` for the\n\t * invariant and `migrateLayout` for the transition mechanism.\n\t */\n\tplacement?: DashboardTilePlacement;\n}\n\n/**\n * Identity of a widget within the rendering tree. Returned by\n * `useWidgetContext()`; `null` when called outside a widget render subtree.\n */\nexport interface WidgetContextValue {\n\t/**\n\t * Widget instance id.\n\t */\n\tuuid: string;\n\n\t/**\n\t * Widget type name.\n\t */\n\tname: WidgetName;\n\n\t/**\n\t * Index of the widget in the `layout` array.\n\t */\n\tindex: number;\n}\n\n/**\n * Identifier for the active grid model. Drives which `@wordpress/grid`\n * surface the dashboard mounts and which per-model settings the\n * `WidgetGridSettings` union admits.\n *\n * Model names describe user-facing concepts. The mapping to the\n * underlying `@wordpress/grid` component is an implementation detail\n * resolved in the render layer; `'masonry'` is rendered today through\n * `DashboardLanes` (skyline placement) but could swap to a future\n * native `display: grid-lanes` path without affecting the model name.\n */\nexport type WidgetGridModel = 'grid' | 'masonry';\n\n/**\n * Maximum column count for the widget dashboard on wide containers.\n * Not exposed in layout settings; container width steps the count down\n * to two and one column at fixed breakpoints.\n */\nexport const WIDGET_DASHBOARD_COLUMN_COUNT = 4;\n\n/**\n * Settings common to every grid model. Column count is resolved from\n * the dashboard container width (see\n * `utils/resolve-dashboard-column-count`). `columns` and `minColumnWidth`\n * on this type remain for persisted payloads and `@wordpress/grid`\n * compatibility; the dashboard ignores user-facing values for both.\n *\n * `spacing` is intentionally absent: the gap between tiles is\n * presentational and lives with the design-system theme/density, not\n * with per-dashboard settings. The grid surface keeps the prop for\n * programmatic overrides, but the dashboard does not propagate it.\n */\ninterface BaseWidgetGridSettings {\n\t/**\n\t * Target column count (cap). The dashboard always uses\n\t * {@link WIDGET_DASHBOARD_COLUMN_COUNT}; persisted values are ignored.\n\t */\n\tcolumns?: number;\n\n\t/**\n\t * Per-tile minimum width in pixels. Unused by the dashboard; column\n\t * count is derived from container width instead.\n\t */\n\tminColumnWidth?: number;\n}\n\n/**\n * 2D packed grid settings. Items declare explicit width and height\n * spans; rows use a uniform track height via `rowHeight`.\n */\nexport interface WidgetGridLayoutSettings extends BaseWidgetGridSettings {\n\tmodel?: 'grid';\n\n\t/**\n\t * Row height in pixels (`200` small, `300` medium, `400` large). Every\n\t * tile in a row fills the row vertically.\n\t */\n\trowHeight?: number;\n}\n\n/**\n * Masonry settings. Heights are content-driven; resize is\n * horizontal-only. `flowTolerance` tunes how aggressively the placer\n * preserves source order vs. minimizing empty regions.\n */\nexport interface WidgetMasonryLayoutSettings extends BaseWidgetGridSettings {\n\tmodel: 'masonry';\n\n\t/**\n\t * Pixel tolerance for source-order tiebreaking when two candidate\n\t * columns have similar baselines.\n\t */\n\tflowTolerance?: number;\n}\n\n/**\n * Discriminated union of supported grid-model configurations.\n *\n * When `model` is omitted the dashboard treats the settings as the\n * 2D packed grid (`'grid'`) for backwards compatibility with the\n * pre-union shape.\n */\nexport type WidgetGridSettings =\n\t| WidgetGridLayoutSettings\n\t| WidgetMasonryLayoutSettings;\n\n/**\n * Props for `WidgetDashboard`.\n *\n * The consumer owns the committed layout state; the dashboard maintains\n * a staging copy internally for in-progress edits, and `onLayoutChange`\n * fires only when the user commits via the Done action.\n */\nexport interface WidgetDashboardProps {\n\t/**\n\t * Widget instances to render. Consumer owns this state.\n\t */\n\tlayout: DashboardWidget[];\n\n\t/**\n\t * Called when the user commits in-progress edits via the Done action.\n\t * Receives the full layout array as it should be persisted. In-progress\n\t * mutations (reorder, resize, add, remove, attribute edits) accumulate\n\t * in the dashboard's internal staging layer and do not fire this\n\t * callback until commit.\n\t */\n\tonLayoutChange: ( layout: DashboardWidget[] ) => void;\n\n\t/**\n\t * Called when the layout is reset to the default.\n\t */\n\tonLayoutReset?: () => void;\n\n\t/**\n\t * Widget types available for rendering. The dashboard never queries a\n\t * store directly — consumers scope and filter via this prop.\n\t */\n\twidgetTypes: WidgetType[];\n\n\t/**\n\t * When true, widget types are still loading. Instances whose type is\n\t * not yet in `widgetTypes` show a loading state instead of missing.\n\t */\n\tisResolvingWidgetTypes?: boolean;\n\n\t/**\n\t * Whether the dashboard is in edit mode (enables drag/resize).\n\t */\n\teditMode?: boolean;\n\n\t/**\n\t * Called when edit mode toggles via `WidgetDashboard.Actions`.\n\t */\n\tonEditChange?: ( next: boolean ) => void;\n\n\t/**\n\t * Overrides the default `import()` resolution of\n\t * `WidgetType.renderModule`. Useful for tests, Storybook, or future\n\t * remote-URL loading.\n\t */\n\tresolveWidgetModule?: ResolveWidgetModule;\n\n\t/**\n\t * Grid model configuration. See `WidgetGridSettings` for the shape.\n\t */\n\tgridSettings?: WidgetGridSettings;\n\n\t/**\n\t * Called when the user commits in-progress grid-settings edits via\n\t * the Done action. The dashboard maintains a staging copy of\n\t * settings internally; mutations stay local until commit. When\n\t * omitted, the `Layout settings` button in the customize toolbar is\n\t * hidden, since there is nowhere to persist the change.\n\t */\n\tonGridSettingsChange?: ( gridSettings: WidgetGridSettings ) => void;\n\n\tchildren?: ReactNode;\n}\n"],
+  "mappings": ";AAwHO,IAAM,gCAAgC;",
+  "names": []
+}

package/build-module/utils/create-dashboard-widget/create-dashboard-widget.mjs

@@ -0,0 +1,19 @@
+// packages/widget-dashboard/src/utils/create-dashboard-widget/create-dashboard-widget.ts
+import { v4 as uuid } from "uuid";
+var DEFAULT_PLACEMENT = {
+  width: 1,
+  height: 2,
+  order: 0
+};
+function createDashboardWidget(widgetType, initialAttributes) {
+  return {
+    uuid: uuid(),
+    type: widgetType.name,
+    attributes: initialAttributes ?? widgetType.example?.attributes,
+    placement: DEFAULT_PLACEMENT
+  };
+}
+export {
+  createDashboardWidget
+};
+//# sourceMappingURL=create-dashboard-widget.mjs.map

package/build-module/utils/create-dashboard-widget/create-dashboard-widget.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/create-dashboard-widget/create-dashboard-widget.ts"],
+  "sourcesContent": ["/**\n * External dependencies\n */\nimport { v4 as uuid } from 'uuid';\n\n/**\n * WordPress dependencies\n */\nimport type { WidgetType } from '@wordpress/widget-primitives';\n\n/**\n * Internal dependencies\n */\nimport type { DashboardWidget, GridTilePlacement } from '../../types';\n\nconst DEFAULT_PLACEMENT: GridTilePlacement = {\n\twidth: 1,\n\theight: 2,\n\torder: 0,\n};\n\n/**\n * Create a new dashboard widget from a widget type.\n *\n * Generates a unique id and applies default placement. If no initial\n * attributes are provided, falls back to the type's `example.attributes`\n * (matching the `widget.json` schema).\n *\n * @param widgetType        Source widget type.\n * @param initialAttributes Initial attributes; default to the type's example.\n */\nexport function createDashboardWidget< T >(\n\twidgetType: WidgetType,\n\tinitialAttributes?: T\n): DashboardWidget< T > {\n\treturn {\n\t\tuuid: uuid(),\n\t\ttype: widgetType.name,\n\t\tattributes:\n\t\t\tinitialAttributes ?? ( widgetType.example?.attributes as T ),\n\t\tplacement: DEFAULT_PLACEMENT,\n\t};\n}\n"],
+  "mappings": ";AAGA,SAAS,MAAM,YAAY;AAY3B,IAAM,oBAAuC;AAAA,EAC5C,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AACR;AAYO,SAAS,sBACf,YACA,mBACuB;AACvB,SAAO;AAAA,IACN,MAAM,KAAK;AAAA,IACX,MAAM,WAAW;AAAA,IACjB,YACC,qBAAuB,WAAW,SAAS;AAAA,IAC5C,WAAW;AAAA,EACZ;AACD;",
+  "names": []
+}

package/build-module/utils/create-dashboard-widget/index.mjs

@@ -0,0 +1,6 @@
+// packages/widget-dashboard/src/utils/create-dashboard-widget/index.ts
+import { createDashboardWidget } from "./create-dashboard-widget.mjs";
+export {
+  createDashboardWidget
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/utils/create-dashboard-widget/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/create-dashboard-widget/index.ts"],
+  "sourcesContent": ["export { createDashboardWidget } from './create-dashboard-widget';\n"],
+  "mappings": ";AAAA,SAAS,6BAA6B;",
+  "names": []
+}

package/build-module/utils/default-grid/default-grid.mjs

@@ -0,0 +1,12 @@
+// packages/widget-dashboard/src/utils/default-grid/default-grid.ts
+import { WIDGET_DASHBOARD_COLUMN_COUNT } from "../../types.mjs";
+import { DEFAULT_ROW_HEIGHT } from "../row-height-presets/index.mjs";
+var DEFAULT_GRID = {
+  model: "grid",
+  columns: WIDGET_DASHBOARD_COLUMN_COUNT,
+  rowHeight: DEFAULT_ROW_HEIGHT
+};
+export {
+  DEFAULT_GRID
+};
+//# sourceMappingURL=default-grid.mjs.map

package/build-module/utils/default-grid/default-grid.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/default-grid/default-grid.ts"],
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport type { WidgetGridSettings } from '../../types';\nimport { WIDGET_DASHBOARD_COLUMN_COUNT } from '../../types';\nimport { DEFAULT_ROW_HEIGHT } from '../row-height-presets';\n\n/**\n * Canonical default grid settings. Applied by the dashboard when the\n * consumer omits `gridSettings`, and the baseline hosts should treat as\n * the factory default when persisting their own copy.\n */\nexport const DEFAULT_GRID: WidgetGridSettings = {\n\tmodel: 'grid',\n\tcolumns: WIDGET_DASHBOARD_COLUMN_COUNT,\n\trowHeight: DEFAULT_ROW_HEIGHT,\n};\n"],
+  "mappings": ";AAIA,SAAS,qCAAqC;AAC9C,SAAS,0BAA0B;AAO5B,IAAM,eAAmC;AAAA,EAC/C,OAAO;AAAA,EACP,SAAS;AAAA,EACT,WAAW;AACZ;",
+  "names": []
+}

package/build-module/utils/default-grid/index.mjs

@@ -0,0 +1,6 @@
+// packages/widget-dashboard/src/utils/default-grid/index.ts
+import { DEFAULT_GRID } from "./default-grid.mjs";
+export {
+  DEFAULT_GRID
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/utils/default-grid/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/default-grid/index.ts"],
+  "sourcesContent": ["export { DEFAULT_GRID } from './default-grid';\n"],
+  "mappings": ";AAAA,SAAS,oBAAoB;",
+  "names": []
+}

package/build-module/utils/grid-model-change/grid-model-change.mjs

@@ -0,0 +1,30 @@
+// packages/widget-dashboard/src/utils/grid-model-change/grid-model-change.ts
+import { migrateLayout } from "../migrate-layout/index.mjs";
+import { WIDGET_DASHBOARD_COLUMN_COUNT } from "../../types.mjs";
+function getGridModel(settings) {
+  return settings.model ?? "grid";
+}
+function computeGridModelChange({
+  layout,
+  gridSettings,
+  targetModel
+}) {
+  const currentModel = getGridModel(gridSettings);
+  if (currentModel === targetModel) {
+    return null;
+  }
+  return {
+    layout: migrateLayout(layout, currentModel, targetModel, {
+      columns: WIDGET_DASHBOARD_COLUMN_COUNT
+    }),
+    gridSettings: {
+      ...gridSettings,
+      model: targetModel
+    }
+  };
+}
+export {
+  computeGridModelChange,
+  getGridModel
+};
+//# sourceMappingURL=grid-model-change.mjs.map

package/build-module/utils/grid-model-change/grid-model-change.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/grid-model-change/grid-model-change.ts"],
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport { migrateLayout } from '../migrate-layout';\nimport type {\n\tDashboardWidget,\n\tWidgetGridModel,\n\tWidgetGridSettings,\n} from '../../types';\nimport { WIDGET_DASHBOARD_COLUMN_COUNT } from '../../types';\n\nexport function getGridModel( settings: WidgetGridSettings ): WidgetGridModel {\n\treturn settings.model ?? 'grid';\n}\n\ntype ComputeGridModelChangeProps = {\n\tlayout: DashboardWidget[];\n\tgridSettings: WidgetGridSettings;\n\ttargetModel: WidgetGridModel;\n};\n\ntype ComputeGridModelChangeResult = {\n\tlayout: DashboardWidget[];\n\tgridSettings: WidgetGridSettings;\n} | null;\n\n/**\n * Computes the staged layout and grid settings after a layout-model change.\n *\n * @param {ComputeGridModelChangeProps} params Layout, current settings, and target model.\n * @return {ComputeGridModelChangeResult} Migrated layout and settings, or `null` when the model is unchanged.\n */\nexport function computeGridModelChange( {\n\tlayout,\n\tgridSettings,\n\ttargetModel,\n}: ComputeGridModelChangeProps ): ComputeGridModelChangeResult {\n\tconst currentModel = getGridModel( gridSettings );\n\n\tif ( currentModel === targetModel ) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tlayout: migrateLayout( layout, currentModel, targetModel, {\n\t\t\tcolumns: WIDGET_DASHBOARD_COLUMN_COUNT,\n\t\t} ),\n\t\tgridSettings: {\n\t\t\t...gridSettings,\n\t\t\tmodel: targetModel,\n\t\t} as WidgetGridSettings,\n\t};\n}\n"],
+  "mappings": ";AAGA,SAAS,qBAAqB;AAM9B,SAAS,qCAAqC;AAEvC,SAAS,aAAc,UAAgD;AAC7E,SAAO,SAAS,SAAS;AAC1B;AAmBO,SAAS,uBAAwB;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AACD,GAA+D;AAC9D,QAAM,eAAe,aAAc,YAAa;AAEhD,MAAK,iBAAiB,aAAc;AACnC,WAAO;AAAA,EACR;AAEA,SAAO;AAAA,IACN,QAAQ,cAAe,QAAQ,cAAc,aAAa;AAAA,MACzD,SAAS;AAAA,IACV,CAAE;AAAA,IACF,cAAc;AAAA,MACb,GAAG;AAAA,MACH,OAAO;AAAA,IACR;AAAA,EACD;AACD;",
+  "names": []
+}

package/build-module/utils/grid-model-change/index.mjs

@@ -0,0 +1,7 @@
+// packages/widget-dashboard/src/utils/grid-model-change/index.ts
+import { computeGridModelChange, getGridModel } from "./grid-model-change.mjs";
+export {
+  computeGridModelChange,
+  getGridModel
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/utils/grid-model-change/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/grid-model-change/index.ts"],
+  "sourcesContent": ["export { computeGridModelChange, getGridModel } from './grid-model-change';\n"],
+  "mappings": ";AAAA,SAAS,wBAAwB,oBAAoB;",
+  "names": []
+}

package/build-module/utils/index.mjs

@@ -0,0 +1,8 @@
+// packages/widget-dashboard/src/utils/index.ts
+import { createDashboardWidget } from "./create-dashboard-widget/index.mjs";
+import { migrateLayout } from "./migrate-layout/index.mjs";
+export {
+  createDashboardWidget,
+  migrateLayout
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/utils/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/index.ts"],
+  "sourcesContent": ["export { createDashboardWidget } from './create-dashboard-widget';\nexport { migrateLayout } from './migrate-layout';\n"],
+  "mappings": ";AAAA,SAAS,6BAA6B;AACtC,SAAS,qBAAqB;",
+  "names": []
+}

package/build-module/utils/migrate-layout/index.mjs

@@ -0,0 +1,6 @@
+// packages/widget-dashboard/src/utils/migrate-layout/index.ts
+import { migrateLayout } from "./migrate-layout.mjs";
+export {
+  migrateLayout
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/utils/migrate-layout/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/migrate-layout/index.ts"],
+  "sourcesContent": ["export { migrateLayout } from './migrate-layout';\n"],
+  "mappings": ";AAAA,SAAS,qBAAqB;",
+  "names": []
+}

package/build-module/utils/migrate-layout/migrate-layout.mjs

@@ -0,0 +1,69 @@
+// packages/widget-dashboard/src/utils/migrate-layout/migrate-layout.ts
+var FALLBACK_COLUMNS = 6;
+function gridWidthToMasonryWidth(width, targetColumns) {
+  if (width === "full") {
+    return targetColumns;
+  }
+  if (width === "fill" || width === void 0) {
+    return 1;
+  }
+  return width;
+}
+function migratePlacementGridToMasonry(placement, context) {
+  if (!placement) {
+    return {};
+  }
+  const next = {};
+  const width = gridWidthToMasonryWidth(placement.width, context.columns);
+  if (width !== 1) {
+    next.width = width;
+  }
+  if (placement.order !== void 0) {
+    next.order = placement.order;
+  }
+  return next;
+}
+function migratePlacementMasonryToGrid(placement) {
+  if (!placement) {
+    return { height: 1 };
+  }
+  const next = { height: 1 };
+  if (placement.width !== void 0) {
+    next.width = placement.width;
+  }
+  if (placement.order !== void 0) {
+    next.order = placement.order;
+  }
+  return next;
+}
+function migrateLayout(widgets, from, to, context = {}) {
+  const resolvedFrom = from ?? "grid";
+  if (resolvedFrom === to) {
+    return widgets;
+  }
+  const resolvedContext = {
+    columns: context.columns ?? FALLBACK_COLUMNS
+  };
+  if (resolvedFrom === "grid" && to === "masonry") {
+    return widgets.map((widget) => ({
+      ...widget,
+      placement: migratePlacementGridToMasonry(
+        widget.placement,
+        resolvedContext
+      )
+    }));
+  }
+  if (resolvedFrom === "masonry" && to === "grid") {
+    return widgets.map((widget) => ({
+      ...widget,
+      placement: migratePlacementMasonryToGrid(
+        widget.placement
+      )
+    }));
+  }
+  return widgets;
+}
+export {
+  migrateLayout
+};
+//# sourceMappingURL=migrate-layout.mjs.map

package/build-module/utils/migrate-layout/migrate-layout.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/migrate-layout/migrate-layout.ts"],
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport type {\n\tDashboardWidget,\n\tGridTilePlacement,\n\tMasonryTilePlacement,\n\tWidgetGridModel,\n} from '../../types';\n\ninterface MigrationContext {\n\t/**\n\t * Column count of the currently-mounted grid surface. Used to\n\t * resolve `'full'` widths to a concrete numeric span when going\n\t * from the 2D grid model to masonry. When the surface is in\n\t * responsive mode and the runtime column count is unknown,\n\t * callers should pass a sensible fallback (e.g., the default of\n\t * 6 used by `@wordpress/grid`).\n\t */\n\tcolumns: number;\n}\n\nconst FALLBACK_COLUMNS = 6;\n\n/**\n * Coerces a `'fill'`/`'full'`/numeric width into a concrete numeric\n * span when migrating from `'grid'` to `'masonry'`. `'fill'` collapses\n * to a single column; resolving it against per-row remainder would\n * require either DOM measurement or replicating CSS-Grid's auto-flow\n * placement, both of which were judged not worth the complexity for\n * a one-shot migration the user can correct visually in staging.\n *\n * @param width         Source width from a grid placement.\n * @param targetColumns Column count to use for `'full'` widths.\n */\nfunction gridWidthToMasonryWidth(\n\twidth: GridTilePlacement[ 'width' ],\n\ttargetColumns: number\n): number {\n\tif ( width === 'full' ) {\n\t\treturn targetColumns;\n\t}\n\tif ( width === 'fill' || width === undefined ) {\n\t\treturn 1;\n\t}\n\treturn width;\n}\n\n/**\n * Transforms a single placement from the 2D grid shape to the masonry\n * shape. Drops `height` (masonry derives heights from content),\n * preserves `order`, leaves `lane` unset so the auto-flow placer\n * arranges items by source order.\n *\n * @param placement Source grid placement.\n * @param context   Migration context (column count).\n */\nfunction migratePlacementGridToMasonry(\n\tplacement: GridTilePlacement | undefined,\n\tcontext: MigrationContext\n): MasonryTilePlacement {\n\tif ( ! placement ) {\n\t\treturn {};\n\t}\n\n\tconst next: MasonryTilePlacement = {};\n\tconst width = gridWidthToMasonryWidth( placement.width, context.columns );\n\tif ( width !== 1 ) {\n\t\tnext.width = width;\n\t}\n\tif ( placement.order !== undefined ) {\n\t\tnext.order = placement.order;\n\t}\n\treturn next;\n}\n\n/**\n * Transforms a single placement from the masonry shape to the 2D grid\n * shape. Preserves the numeric width, drops `lane` (the 2D grid\n * auto-packs and has no pin-to-column concept), and seeds `height: 1`\n * since masonry never persisted a height. The user is expected to\n * resize tiles vertically after the migration.\n *\n * @param placement Source masonry placement.\n */\nfunction migratePlacementMasonryToGrid(\n\tplacement: MasonryTilePlacement | undefined\n): GridTilePlacement {\n\tif ( ! placement ) {\n\t\treturn { height: 1 };\n\t}\n\n\tconst next: GridTilePlacement = { height: 1 };\n\tif ( placement.width !== undefined ) {\n\t\tnext.width = placement.width;\n\t}\n\tif ( placement.order !== undefined ) {\n\t\tnext.order = placement.order;\n\t}\n\treturn next;\n}\n\n/**\n * Migrates every widget's `placement` between grid models.\n *\n * The two storage shapes overlap on `width` and `order` but diverge\n * on the rest: 2D grid carries `height` and discriminated string\n * widths (`'fill'`/`'full'`), lanes carries `lane` and only numeric\n * widths. Each conversion loses information that the target model\n * cannot represent. The caller is responsible for surfacing the\n * result to the user in a way that lets them correct visually.\n *\n * When `from === to`, the input is returned unchanged.\n *\n * @param widgets Widgets to migrate.\n * @param from    Source model. `undefined` is treated as `'grid'`.\n * @param to      Target model.\n * @param context Information that depends on the live render (today\n *                only `columns`).\n */\nexport function migrateLayout(\n\twidgets: DashboardWidget[],\n\tfrom: WidgetGridModel | undefined,\n\tto: WidgetGridModel,\n\tcontext: Partial< MigrationContext > = {}\n): DashboardWidget[] {\n\tconst resolvedFrom: WidgetGridModel = from ?? 'grid';\n\tif ( resolvedFrom === to ) {\n\t\treturn widgets;\n\t}\n\n\tconst resolvedContext: MigrationContext = {\n\t\tcolumns: context.columns ?? FALLBACK_COLUMNS,\n\t};\n\n\tif ( resolvedFrom === 'grid' && to === 'masonry' ) {\n\t\treturn widgets.map( ( widget ) => ( {\n\t\t\t...widget,\n\t\t\tplacement: migratePlacementGridToMasonry(\n\t\t\t\twidget.placement as GridTilePlacement | undefined,\n\t\t\t\tresolvedContext\n\t\t\t),\n\t\t} ) );\n\t}\n\n\tif ( resolvedFrom === 'masonry' && to === 'grid' ) {\n\t\treturn widgets.map( ( widget ) => ( {\n\t\t\t...widget,\n\t\t\tplacement: migratePlacementMasonryToGrid(\n\t\t\t\twidget.placement as MasonryTilePlacement | undefined\n\t\t\t),\n\t\t} ) );\n\t}\n\n\treturn widgets;\n}\n"],
+  "mappings": ";AAsBA,IAAM,mBAAmB;AAazB,SAAS,wBACR,OACA,eACS;AACT,MAAK,UAAU,QAAS;AACvB,WAAO;AAAA,EACR;AACA,MAAK,UAAU,UAAU,UAAU,QAAY;AAC9C,WAAO;AAAA,EACR;AACA,SAAO;AACR;AAWA,SAAS,8BACR,WACA,SACuB;AACvB,MAAK,CAAE,WAAY;AAClB,WAAO,CAAC;AAAA,EACT;AAEA,QAAM,OAA6B,CAAC;AACpC,QAAM,QAAQ,wBAAyB,UAAU,OAAO,QAAQ,OAAQ;AACxE,MAAK,UAAU,GAAI;AAClB,SAAK,QAAQ;AAAA,EACd;AACA,MAAK,UAAU,UAAU,QAAY;AACpC,SAAK,QAAQ,UAAU;AAAA,EACxB;AACA,SAAO;AACR;AAWA,SAAS,8BACR,WACoB;AACpB,MAAK,CAAE,WAAY;AAClB,WAAO,EAAE,QAAQ,EAAE;AAAA,EACpB;AAEA,QAAM,OAA0B,EAAE,QAAQ,EAAE;AAC5C,MAAK,UAAU,UAAU,QAAY;AACpC,SAAK,QAAQ,UAAU;AAAA,EACxB;AACA,MAAK,UAAU,UAAU,QAAY;AACpC,SAAK,QAAQ,UAAU;AAAA,EACxB;AACA,SAAO;AACR;AAoBO,SAAS,cACf,SACA,MACA,IACA,UAAuC,CAAC,GACpB;AACpB,QAAM,eAAgC,QAAQ;AAC9C,MAAK,iBAAiB,IAAK;AAC1B,WAAO;AAAA,EACR;AAEA,QAAM,kBAAoC;AAAA,IACzC,SAAS,QAAQ,WAAW;AAAA,EAC7B;AAEA,MAAK,iBAAiB,UAAU,OAAO,WAAY;AAClD,WAAO,QAAQ,IAAK,CAAE,YAAc;AAAA,MACnC,GAAG;AAAA,MACH,WAAW;AAAA,QACV,OAAO;AAAA,QACP;AAAA,MACD;AAAA,IACD,EAAI;AAAA,EACL;AAEA,MAAK,iBAAiB,aAAa,OAAO,QAAS;AAClD,WAAO,QAAQ,IAAK,CAAE,YAAc;AAAA,MACnC,GAAG;AAAA,MACH,WAAW;AAAA,QACV,OAAO;AAAA,MACR;AAAA,IACD,EAAI;AAAA,EACL;AAEA,SAAO;AACR;",
+  "names": []
+}

package/build-module/utils/normalize-grid-settings/index.mjs

@@ -0,0 +1,6 @@
+// packages/widget-dashboard/src/utils/normalize-grid-settings/index.ts
+import { normalizeGridSettings } from "./normalize-grid-settings.mjs";
+export {
+  normalizeGridSettings
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/utils/normalize-grid-settings/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/normalize-grid-settings/index.ts"],
+  "sourcesContent": ["export { normalizeGridSettings } from './normalize-grid-settings';\n"],
+  "mappings": ";AAAA,SAAS,6BAA6B;",
+  "names": []
+}

package/build-module/utils/normalize-grid-settings/normalize-grid-settings.mjs

@@ -0,0 +1,21 @@
+// packages/widget-dashboard/src/utils/normalize-grid-settings/normalize-grid-settings.ts
+import { snapRowHeight } from "../row-height-presets/index.mjs";
+function normalizeGridSettings(settings, defaultRowHeight) {
+  if ((settings.model ?? "grid") === "masonry") {
+    return settings;
+  }
+  const gridSettings = settings;
+  const rowHeight = gridSettings.rowHeight;
+  const resolved = typeof rowHeight === "number" ? snapRowHeight(rowHeight) : defaultRowHeight;
+  if (rowHeight === resolved) {
+    return settings;
+  }
+  return {
+    ...gridSettings,
+    rowHeight: resolved
+  };
+}
+export {
+  normalizeGridSettings
+};
+//# sourceMappingURL=normalize-grid-settings.mjs.map

package/build-module/utils/normalize-grid-settings/normalize-grid-settings.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/normalize-grid-settings/normalize-grid-settings.ts"],
+  "sourcesContent": ["import type { WidgetGridLayoutSettings, WidgetGridSettings } from '../../types';\nimport { snapRowHeight } from '../row-height-presets';\n\n/**\n * Coerces legacy grid row heights to a dashboard preset. Standard grid\n * rows always use uniform track sizing so tiles align with the masonry\n * model boundary.\n *\n * @param settings         Grid settings to normalize.\n * @param defaultRowHeight Fallback row height when none is set.\n */\nexport function normalizeGridSettings(\n\tsettings: WidgetGridSettings,\n\tdefaultRowHeight: number\n): WidgetGridSettings {\n\tif ( ( settings.model ?? 'grid' ) === 'masonry' ) {\n\t\treturn settings;\n\t}\n\n\t// The guard above cannot narrow the union for TypeScript: `model` is\n\t// optional and the check goes through `??`.\n\tconst gridSettings = settings as WidgetGridLayoutSettings;\n\n\tconst rowHeight = gridSettings.rowHeight;\n\tconst resolved =\n\t\ttypeof rowHeight === 'number'\n\t\t\t? snapRowHeight( rowHeight )\n\t\t\t: defaultRowHeight;\n\n\tif ( rowHeight === resolved ) {\n\t\treturn settings;\n\t}\n\n\treturn {\n\t\t...gridSettings,\n\t\trowHeight: resolved,\n\t};\n}\n"],
+  "mappings": ";AACA,SAAS,qBAAqB;AAUvB,SAAS,sBACf,UACA,kBACqB;AACrB,OAAO,SAAS,SAAS,YAAa,WAAY;AACjD,WAAO;AAAA,EACR;AAIA,QAAM,eAAe;AAErB,QAAM,YAAY,aAAa;AAC/B,QAAM,WACL,OAAO,cAAc,WAClB,cAAe,SAAU,IACzB;AAEJ,MAAK,cAAc,UAAW;AAC7B,WAAO;AAAA,EACR;AAEA,SAAO;AAAA,IACN,GAAG;AAAA,IACH,WAAW;AAAA,EACZ;AACD;",
+  "names": []
+}

package/build-module/utils/resolve-dashboard-column-count/resolve-dashboard-column-count.mjs

@@ -0,0 +1,22 @@
+// packages/widget-dashboard/src/utils/resolve-dashboard-column-count/resolve-dashboard-column-count.ts
+import { WIDGET_DASHBOARD_COLUMN_COUNT } from "../../types.mjs";
+var WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_ONE_COLUMN = 600;
+var WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_TWO_COLUMNS = 960;
+function resolveDashboardColumnCount(containerWidth) {
+  if (containerWidth <= 0) {
+    return WIDGET_DASHBOARD_COLUMN_COUNT;
+  }
+  if (containerWidth < WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_ONE_COLUMN) {
+    return 1;
+  }
+  if (containerWidth < WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_TWO_COLUMNS) {
+    return 2;
+  }
+  return WIDGET_DASHBOARD_COLUMN_COUNT;
+}
+export {
+  WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_ONE_COLUMN,
+  WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_TWO_COLUMNS,
+  resolveDashboardColumnCount
+};
+//# sourceMappingURL=resolve-dashboard-column-count.mjs.map

package/build-module/utils/resolve-dashboard-column-count/resolve-dashboard-column-count.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/resolve-dashboard-column-count/resolve-dashboard-column-count.ts"],
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport { WIDGET_DASHBOARD_COLUMN_COUNT } from '../../types';\n\n/**\n * Container width (px) below which the dashboard uses a single column.\n * Matches `@container widget-dashboard (max-width: …)` in widgets CSS.\n */\nexport const WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_ONE_COLUMN = 600;\n\n/**\n * Container width (px) below which the dashboard drops from four columns\n * to two. Above this threshold (and below the four-column cap) the\n * grid uses {@link WIDGET_DASHBOARD_COLUMN_COUNT}.\n */\nexport const WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_TWO_COLUMNS = 960;\n\n/**\n * Resolves the dashboard grid column count from the widget surface\n * container width. Uses discrete steps (4 → 2 → 1), not viewport\n * media queries.\n *\n * @param containerWidth Measured inline size of the dashboard grid container.\n * @return Column count for {@link @wordpress/grid} surfaces.\n */\nexport function resolveDashboardColumnCount( containerWidth: number ): number {\n\tif ( containerWidth <= 0 ) {\n\t\treturn WIDGET_DASHBOARD_COLUMN_COUNT;\n\t}\n\n\tif ( containerWidth < WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_ONE_COLUMN ) {\n\t\treturn 1;\n\t}\n\n\tif ( containerWidth < WIDGET_DASHBOARD_CONTAINER_BREAKPOINT_TWO_COLUMNS ) {\n\t\treturn 2;\n\t}\n\n\treturn WIDGET_DASHBOARD_COLUMN_COUNT;\n}\n"],
+  "mappings": ";AAGA,SAAS,qCAAqC;AAMvC,IAAM,mDAAmD;AAOzD,IAAM,oDAAoD;AAU1D,SAAS,4BAA6B,gBAAiC;AAC7E,MAAK,kBAAkB,GAAI;AAC1B,WAAO;AAAA,EACR;AAEA,MAAK,iBAAiB,kDAAmD;AACxE,WAAO;AAAA,EACR;AAEA,MAAK,iBAAiB,mDAAoD;AACzE,WAAO;AAAA,EACR;AAEA,SAAO;AACR;",
+  "names": []
+}

package/build-module/utils/row-height-presets/index.mjs

@@ -0,0 +1,16 @@
+// packages/widget-dashboard/src/utils/row-height-presets/index.ts
+import {
+  DEFAULT_ROW_HEIGHT,
+  ROW_HEIGHT_PRESETS,
+  presetToRowHeight,
+  rowHeightToPreset,
+  snapRowHeight
+} from "./row-height-presets.mjs";
+export {
+  DEFAULT_ROW_HEIGHT,
+  ROW_HEIGHT_PRESETS,
+  presetToRowHeight,
+  rowHeightToPreset,
+  snapRowHeight
+};
+//# sourceMappingURL=index.mjs.map

package/build-module/utils/row-height-presets/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/row-height-presets/index.ts"],
+  "sourcesContent": ["export {\n\tDEFAULT_ROW_HEIGHT,\n\tROW_HEIGHT_PRESETS,\n\tpresetToRowHeight,\n\trowHeightToPreset,\n\tsnapRowHeight,\n} from './row-height-presets';\nexport type { RowHeightPreset } from './row-height-presets';\n"],
+  "mappings": ";AAAA;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACM;",
+  "names": []
+}

package/build-module/utils/row-height-presets/row-height-presets.mjs

@@ -0,0 +1,34 @@
+// packages/widget-dashboard/src/utils/row-height-presets/row-height-presets.ts
+var ROW_HEIGHT_PRESETS = {
+  small: 200,
+  medium: 300,
+  large: 400
+};
+var DEFAULT_ROW_HEIGHT = ROW_HEIGHT_PRESETS.medium;
+var PRESET_ENTRIES = Object.entries(ROW_HEIGHT_PRESETS);
+function rowHeightToPreset(rowHeight) {
+  let closest = "medium";
+  let minDistance = Infinity;
+  for (const [preset, value] of PRESET_ENTRIES) {
+    const distance = Math.abs(rowHeight - value);
+    if (distance < minDistance) {
+      minDistance = distance;
+      closest = preset;
+    }
+  }
+  return closest;
+}
+function presetToRowHeight(preset) {
+  return ROW_HEIGHT_PRESETS[preset];
+}
+function snapRowHeight(rowHeight) {
+  return presetToRowHeight(rowHeightToPreset(rowHeight));
+}
+export {
+  DEFAULT_ROW_HEIGHT,
+  ROW_HEIGHT_PRESETS,
+  presetToRowHeight,
+  rowHeightToPreset,
+  snapRowHeight
+};
+//# sourceMappingURL=row-height-presets.mjs.map

package/build-module/utils/row-height-presets/row-height-presets.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/row-height-presets/row-height-presets.ts"],
+  "sourcesContent": ["export const ROW_HEIGHT_PRESETS = {\n\tsmall: 200,\n\tmedium: 300,\n\tlarge: 400,\n} as const;\n\nexport type RowHeightPreset = keyof typeof ROW_HEIGHT_PRESETS;\n\nexport const DEFAULT_ROW_HEIGHT = ROW_HEIGHT_PRESETS.medium;\n\nconst PRESET_ENTRIES = Object.entries( ROW_HEIGHT_PRESETS ) as [\n\tRowHeightPreset,\n\tnumber,\n][];\n\n/**\n * Maps a stored pixel height to the nearest preset so legacy freeform\n * values still resolve to a valid toggle option.\n *\n * @param rowHeight Row height in pixels.\n */\nexport function rowHeightToPreset( rowHeight: number ): RowHeightPreset {\n\tlet closest: RowHeightPreset = 'medium';\n\tlet minDistance = Infinity;\n\n\tfor ( const [ preset, value ] of PRESET_ENTRIES ) {\n\t\tconst distance = Math.abs( rowHeight - value );\n\t\tif ( distance < minDistance ) {\n\t\t\tminDistance = distance;\n\t\t\tclosest = preset;\n\t\t}\n\t}\n\n\treturn closest;\n}\n\nexport function presetToRowHeight( preset: RowHeightPreset ): number {\n\treturn ROW_HEIGHT_PRESETS[ preset ];\n}\n\nexport function snapRowHeight( rowHeight: number ): number {\n\treturn presetToRowHeight( rowHeightToPreset( rowHeight ) );\n}\n"],
+  "mappings": ";AAAO,IAAM,qBAAqB;AAAA,EACjC,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AACR;AAIO,IAAM,qBAAqB,mBAAmB;AAErD,IAAM,iBAAiB,OAAO,QAAS,kBAAmB;AAWnD,SAAS,kBAAmB,WAAqC;AACvE,MAAI,UAA2B;AAC/B,MAAI,cAAc;AAElB,aAAY,CAAE,QAAQ,KAAM,KAAK,gBAAiB;AACjD,UAAM,WAAW,KAAK,IAAK,YAAY,KAAM;AAC7C,QAAK,WAAW,aAAc;AAC7B,oBAAc;AACd,gBAAU;AAAA,IACX;AAAA,EACD;AAEA,SAAO;AACR;AAEO,SAAS,kBAAmB,QAAkC;AACpE,SAAO,mBAAoB,MAAO;AACnC;AAEO,SAAS,cAAe,WAA4B;AAC1D,SAAO,kBAAmB,kBAAmB,SAAU,CAAE;AAC1D;",
+  "names": []
+}

package/build-module/widget-dashboard.mjs

@@ -0,0 +1,61 @@
+// packages/widget-dashboard/src/widget-dashboard.tsx
+import { WidgetDashboardProvider } from "./context/dashboard-context.mjs";
+import { WidgetDashboardUIProvider } from "./context/ui-context.mjs";
+import { Actions } from "./components/actions/index.mjs";
+import { Commands } from "./components/commands/index.mjs";
+import { LayoutSettings } from "./components/layout-settings/index.mjs";
+import { NoWidgetsState } from "./components/no-widgets-state/index.mjs";
+import { ResetConfirmation } from "./components/reset-confirmation/index.mjs";
+import { WidgetChrome } from "./components/widget-chrome/index.mjs";
+import { WidgetInserter } from "./components/widget-inserter/index.mjs";
+import { WidgetSettings } from "./components/widget-settings/index.mjs";
+import { Widgets } from "./components/widgets/index.mjs";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var WidgetDashboard = Object.assign(
+  function WidgetDashboard2({
+    layout,
+    onLayoutChange,
+    onLayoutReset,
+    widgetTypes,
+    isResolvingWidgetTypes,
+    editMode,
+    onEditChange,
+    resolveWidgetModule,
+    gridSettings,
+    onGridSettingsChange,
+    children
+  }) {
+    return /* @__PURE__ */ jsx(
+      WidgetDashboardProvider,
+      {
+        layout,
+        onLayoutChange,
+        onLayoutReset,
+        widgetTypes,
+        isResolvingWidgetTypes,
+        editMode,
+        onEditChange,
+        resolveWidgetModule,
+        gridSettings,
+        onGridSettingsChange,
+        children: /* @__PURE__ */ jsxs(WidgetDashboardUIProvider, { children: [
+          children ?? /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx(NoWidgetsState, {}),
+            /* @__PURE__ */ jsx(Actions, {}),
+            /* @__PURE__ */ jsx(Widgets, {}),
+            /* @__PURE__ */ jsx(Commands, {})
+          ] }),
+          /* @__PURE__ */ jsx(WidgetInserter, {}),
+          /* @__PURE__ */ jsx(LayoutSettings, {}),
+          /* @__PURE__ */ jsx(WidgetSettings, {}),
+          /* @__PURE__ */ jsx(ResetConfirmation, {})
+        ] })
+      }
+    );
+  },
+  { Actions, Widgets, WidgetChrome, NoWidgetsState, Commands }
+);
+export {
+  WidgetDashboard
+};
+//# sourceMappingURL=widget-dashboard.mjs.map

package/build-module/widget-dashboard.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/widget-dashboard.tsx"],
+  "sourcesContent": ["/**\n * Internal dependencies\n */\nimport { WidgetDashboardProvider } from './context/dashboard-context';\nimport { WidgetDashboardUIProvider } from './context/ui-context';\nimport { Actions } from './components/actions';\nimport { Commands } from './components/commands';\nimport { LayoutSettings } from './components/layout-settings';\nimport { NoWidgetsState } from './components/no-widgets-state';\nimport { ResetConfirmation } from './components/reset-confirmation';\nimport { WidgetChrome } from './components/widget-chrome';\nimport { WidgetInserter } from './components/widget-inserter';\nimport { WidgetSettings } from './components/widget-settings';\nimport { Widgets } from './components/widgets';\nimport type { WidgetDashboardProps } from './types';\n\n/**\n * Stateless rendering engine for widget dashboards.\n *\n * The consumer owns `layout` and `editMode` state; every mutation fires\n * `onLayoutChange` with the fully updated array. The engine never queries a\n * widget store; types flow in via the `widgetTypes` prop.\n *\n * ```tsx\n * import { WidgetDashboard } from '@wordpress/widget-dashboard';\n *\n * function MyDashboard() {\n * \tconst [ layout, setLayout ] = useState( defaultLayout );\n * \tconst [ editMode, setEditMode ] = useState( false );\n * \treturn (\n * \t\t<WidgetDashboard\n * \t\t\tlayout={ layout }\n * \t\t\tonLayoutChange={ setLayout }\n * \t\t\twidgetTypes={ widgetTypes }\n * \t\t\teditMode={ editMode }\n * \t\t\tonEditChange={ setEditMode }\n * \t\t>\n * \t\t\t<WidgetDashboard.NoWidgetsState>\n * \t\t\t\t<p>No widgets yet.</p>\n * \t\t\t</WidgetDashboard.NoWidgetsState>\n * \t\t\t<WidgetDashboard.Actions />\n * \t\t\t<WidgetDashboard.Widgets />\n * \t\t\t<WidgetDashboard.Commands />\n * \t\t</WidgetDashboard>\n * \t);\n * }\n * ```\n *\n * Children compose the dashboard's triggers and chrome: `Actions`,\n * `Widgets`, `Commands`, `NoWidgetsState`. The targets they open (the\n * widget inserter, the layout and widget settings editors, the reset\n * confirmation) are mounted by the engine and driven by shared UI state, so\n * a trigger works wherever it is composed without a matching target in the\n * tree. Omitting `children` renders the default arrangement.\n */\nexport const WidgetDashboard = Object.assign(\n\tfunction WidgetDashboard( {\n\t\tlayout,\n\t\tonLayoutChange,\n\t\tonLayoutReset,\n\t\twidgetTypes,\n\t\tisResolvingWidgetTypes,\n\t\teditMode,\n\t\tonEditChange,\n\t\tresolveWidgetModule,\n\t\tgridSettings,\n\t\tonGridSettingsChange,\n\t\tchildren,\n\t}: WidgetDashboardProps ) {\n\t\treturn (\n\t\t\t<WidgetDashboardProvider\n\t\t\t\tlayout={ layout }\n\t\t\t\tonLayoutChange={ onLayoutChange }\n\t\t\t\tonLayoutReset={ onLayoutReset }\n\t\t\t\twidgetTypes={ widgetTypes }\n\t\t\t\tisResolvingWidgetTypes={ isResolvingWidgetTypes }\n\t\t\t\teditMode={ editMode }\n\t\t\t\tonEditChange={ onEditChange }\n\t\t\t\tresolveWidgetModule={ resolveWidgetModule }\n\t\t\t\tgridSettings={ gridSettings }\n\t\t\t\tonGridSettingsChange={ onGridSettingsChange }\n\t\t\t>\n\t\t\t\t<WidgetDashboardUIProvider>\n\t\t\t\t\t{ children ?? (\n\t\t\t\t\t\t<>\n\t\t\t\t\t\t\t<NoWidgetsState />\n\t\t\t\t\t\t\t<Actions />\n\t\t\t\t\t\t\t<Widgets />\n\t\t\t\t\t\t\t<Commands />\n\t\t\t\t\t\t</>\n\t\t\t\t\t) }\n\n\t\t\t\t\t<WidgetInserter />\n\t\t\t\t\t<LayoutSettings />\n\t\t\t\t\t<WidgetSettings />\n\t\t\t\t\t<ResetConfirmation />\n\t\t\t\t</WidgetDashboardUIProvider>\n\t\t\t</WidgetDashboardProvider>\n\t\t);\n\t},\n\t{ Actions, Widgets, WidgetChrome, NoWidgetsState, Commands }\n);\n"],
+  "mappings": ";AAGA,SAAS,+BAA+B;AACxC,SAAS,iCAAiC;AAC1C,SAAS,eAAe;AACxB,SAAS,gBAAgB;AACzB,SAAS,sBAAsB;AAC/B,SAAS,sBAAsB;AAC/B,SAAS,yBAAyB;AAClC,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAC/B,SAAS,sBAAsB;AAC/B,SAAS,eAAe;AAuElB,mBACC,KADD;AA7BC,IAAM,kBAAkB,OAAO;AAAA,EACrC,SAASA,iBAAiB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD,GAA0B;AACzB,WACC;AAAA,MAAC;AAAA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QAEA,+BAAC,6BACE;AAAA,sBACD,iCACC;AAAA,gCAAC,kBAAe;AAAA,YAChB,oBAAC,WAAQ;AAAA,YACT,oBAAC,WAAQ;AAAA,YACT,oBAAC,YAAS;AAAA,aACX;AAAA,UAGD,oBAAC,kBAAe;AAAA,UAChB,oBAAC,kBAAe;AAAA,UAChB,oBAAC,kBAAe;AAAA,UAChB,oBAAC,qBAAkB;AAAA,WACpB;AAAA;AAAA,IACD;AAAA,EAEF;AAAA,EACA,EAAE,SAAS,SAAS,cAAc,gBAAgB,SAAS;AAC5D;",
+  "names": ["WidgetDashboard"]
+}

package/build-module/wordpress-commands.d.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=wordpress-commands.d.mjs.map

package/build-module/wordpress-commands.d.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}