@punica/editor 1.9.1 → 1.10.1

package/package.json

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

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

@@ -64,7 +64,7 @@ declare module 'punica' {
 
       /** A profile's app bar composition (see `ProfileShellSpec.appBar`). */
       interface AppBarSpec {
-        /** Bar height in px. Defaults to 38. */
+        /** Bar height in px. Defaults to 30. */
         height?: number;
         /** What the centre region shows. Defaults to `'workspace'`. */
         title?: AppBarTitleMode;

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

@@ -36,6 +36,7 @@ declare module 'punica' {
         | 'punica-date-picker'
         | 'punica-drawer'
         | 'punica-paper'
+        | 'punica-split'
         | 'punica-split-button'
         | 'punica-card'
         | 'punica-card-header'
@@ -73,6 +74,8 @@ declare module 'punica' {
         | 'punica-toggle-button-group'
         | 'punica-context-menu'
         | 'punica-context-menu-item'
+        | 'punica-context-menu-separator'
+        /** @deprecated Misspelling of `punica-context-menu-separator`. */
         | 'punica-context-menu-sperator'
         | 'punica-toolbar'
         | 'punica-toast'

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

@@ -133,15 +133,33 @@ declare module 'punica' {
         }
 
         interface TypographyOptions {
+          /**
+           * Every variant `punica-typography` ships a `:host([variant=…])`
+           * rule for, and nothing else.
+           *
+           * This list was previously `'h1'..'h6' | 'body' | 'caption'`, of
+           * which only `caption` was real. An unknown variant is not a
+           * harmless no-op: the component stamps `variant="body1"` on any
+           * element created *without* one, so passing a name it does not
+           * implement suppresses that default and leaves the text at the
+           * inherited size, `inline`, with no `role=heading` and no
+           * `aria-level`. `createTypography` therefore drops anything outside
+           * this list rather than writing it to the DOM.
+           */
           variant?:
-            | 'h1'
-            | 'h2'
-            | 'h3'
-            | 'h4'
-            | 'h5'
-            | 'h6'
-            | 'body'
-            | 'caption';
+            | 'headline1'
+            | 'headline2'
+            | 'headline3'
+            | 'headline4'
+            | 'headline5'
+            | 'headline6'
+            | 'subtitle1'
+            | 'subtitle2'
+            | 'body1'
+            | 'body2'
+            | 'button'
+            | 'caption'
+            | 'overline';
           color?: 'primary' | 'secondary' | 'error';
           fontWeight?: 'normal' | 'bold';
           style?: Record<string, string> | string;
@@ -298,12 +316,22 @@ declare module 'punica' {
           attrs?: Record<string, string>;
           children?: HTMLElement[];
           onChange?: (value: string) => void;
+          style?: Record<string, string> | string;
+          className?: string;
         }
 
         interface TabItemOptions {
           value: string;
           text?: string;
           attrs?: Record<string, string>;
+          /**
+           * A tab is rarely just text: the shell's own strips put an icon
+           * column, a truncating label and a close button inside one, so the
+           * item has to accept a subtree and carry its own sizing.
+           */
+          children?: HTMLElement[];
+          style?: Record<string, string> | string;
+          className?: string;
         }
 
         interface TabPanelOptions {
@@ -338,6 +366,37 @@ declare module 'punica' {
           style?: Record<string, string> | string;
           className?: string;
           children?: HTMLElement[];
+          /**
+           * Raw markup for the row's body, for the cases `text` cannot express
+           * — an icon, a label and a checkmark on one line. `punica-menu-item`
+           * slots into a `display: block` host and the menu clones itself into
+           * `document.body`, out of reach of any scoped stylesheet, so that
+           * row has to arrive as inline-styled markup. Written before
+           * `children`, and `text` still wins if both are given.
+           */
+          innerHTML?: string;
+        }
+
+        interface SplitOptions {
+          orientation?: 'horizontal' | 'vertical';
+          /** Pane sizes as percentages, in pane order. */
+          sizes?: number[];
+          attrs?: Record<string, string>;
+          children?: HTMLElement[];
+          style?: Record<string, string> | string;
+          className?: string;
+        }
+
+        interface ContextMenuOptions {
+          /**
+           * CSS selector for the element the menu attaches to, written to the
+           * component's `target` attribute.
+           */
+          target?: string;
+          /** Built once, unlike `attachContextMenu`'s per-right-click items. */
+          items: MenuItemSpec[];
+          onSelect: (value: string) => void;
+          attrs?: Record<string, string>;
         }
 
         interface LinkOptions {
@@ -370,15 +429,21 @@ declare module 'punica' {
           options?: CreateElementOptions
         ): HTMLElement;
 
+        /**
+         * `onClick` receives the click event. It was declared `() => void`,
+         * which no handler that needs the event (to stop propagation, or to
+         * position a flyout off the cursor) could satisfy.
+         */
         function createButton(
           label: string,
-          onClick: () => void,
+          onClick: (event: MouseEvent) => void,
           options?: ButtonOptions
         ): HTMLElement;
 
+        /** `onClick` receives the click event — see `createButton`. */
         function createIconButton(
           iconClass: string,
-          onClick: () => void,
+          onClick: (event: MouseEvent) => void,
           options?: IconButtonOptions
         ): HTMLElement;
 
@@ -427,6 +492,15 @@ declare module 'punica' {
 
         function createMenuItem(options?: MenuItemOptions): HTMLElement;
 
+        /** A resizable pane container. Children become the panes, in order. */
+        function createSplit(options?: SplitOptions): HTMLElement;
+
+        /**
+         * A right-click menu whose items are fixed. Use `attachContextMenu`
+         * instead when the items depend on the row under the cursor.
+         */
+        function createContextMenu(options: ContextMenuOptions): HTMLElement;
+
         function createLink(text: string, options: LinkOptions): HTMLElement;
 
         function createToolbar(options?: ToolbarOptions): HTMLElement;