@punica/editor 1.18.0 → 1.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/punica.module.shell.view.d.ts

@@ -655,6 +655,43 @@ declare module 'punica' {
           count?: string;
         }
 
+        interface EmptyStateAction {
+          label: string;
+          onClick: () => void;
+          /** Defaults to `filled` for the first action, `outlined` for the rest. */
+          variant?: 'filled' | 'outlined' | 'text';
+        }
+
+        interface EmptyStateOptions {
+          /** What is missing, as a noun phrase. */
+          title: string;
+          /** One sentence on how to fix it. */
+          detail?: string;
+          /** FontAwesome classes. Drawn in the `panel` variant only. */
+          icon?: string;
+          /** Icon colour. Defaults to `muted`. */
+          tone?: 'muted' | 'warning' | 'error';
+          /** Omit for a state with nothing to offer but its text. */
+          actions?: EmptyStateAction[];
+          /**
+           * `panel` (default) — the whole view has nothing. `section` — one
+           * section of a multi-section panel, or a popover list.
+           */
+          variant?: 'panel' | 'section';
+          /**
+           * Centre against the viewport instead of the container. For a panel
+           * whose ancestor columns do not propagate a height, where the state
+           * would otherwise sit at the top of the blank area.
+           */
+          fillViewport?: boolean;
+          /**
+           * Anything the two text lines cannot carry — a code snippet to paste,
+           * a row of chips. Appended inside the centred column, so a caller
+           * never has to append a sibling and fight `min-height: 100%`.
+           */
+          extra?: HTMLElement | HTMLElement[];
+        }
+
         interface MenuItemSpec {
           label: string;
           value: string;
@@ -690,6 +727,18 @@ declare module 'punica' {
           options: GroupHeaderOptions | string
         ): HTMLElement;
 
+        /**
+         * Build the shared no-data state: centred on both axes, with an
+         * optional icon, an optional sentence and zero or more buttons.
+         *
+         * Shared because a panel with nothing in it is the first thing a new
+         * user sees. Before this, 44 extension repos had each written their own
+         * `*-empty*` class, and they disagreed on alignment, colour and whether
+         * an empty section is even worth a sentence. CSS is injected once
+         * (theme-aware).
+         */
+        function createEmptyState(options: EmptyStateOptions): HTMLElement;
+
         /**
          * Wire a right-click context menu on a list container. Items are
          * rebuilt per right-click (state-aware) from the row under the cursor