@punica/editor 1.11.1 → 1.12.0

package/package.json

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

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

@@ -55,11 +55,32 @@ declare module 'punica' {
         command?: string;
         menu?: AppBarMenuItem[];
         /**
-         * Command id returning a one-line summary rendered as the menu header
-         * (e.g. the licence state). Dropped when the command is not registered,
-         * which is how a host without the surface stays quiet.
+         * Command id returning the summary rendered as the menu header (e.g. the
+         * licence state, or who the app is licensed to). Dropped when the
+         * command is not registered, which is how a host without the surface
+         * stays quiet.
+         *
+         * A returned string may carry newlines, and each line is rendered as its
+         * own row with the first one emphasised — enough for a name over an
+         * address. Lines are clipped rather than wrapped, so a long address
+         * cannot widen the menu.
          */
         summaryCommand?: string;
+        /**
+         * Command id returning the avatar's glyph, at most two characters (a
+         * user's initials). Avatar items only.
+         *
+         * This exists because the glyph is identity and identity is not known
+         * when a profile is written: `label` is static, and a host cannot patch
+         * one item without re-declaring the whole thing, menu included. So the
+         * profile names a command and the host answers it.
+         *
+         * Called when the item renders and again whenever its menu opens, which
+         * is what makes a licence activated mid-session show up. Anything other
+         * than a non-empty string leaves the glyph as `label`'s first letter, so
+         * a host with no account has nothing to implement.
+         */
+        initialsCommand?: string;
       }
 
       /** A profile's app bar composition (see `ProfileShellSpec.appBar`). */

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

@@ -250,6 +250,12 @@ declare module 'punica' {
           value?: string;
           placeholder?: string;
           type?: 'text' | 'password' | 'number' | 'email' | 'url';
+          /**
+           * A field you type into to narrow a list. The shell puts the shared
+           * magnifier in the input's start adornment; `attrs: { search: '' }`
+           * does the same thing for a caller on older types.
+           */
+          search?: boolean;
           size?: 'small' | 'medium' | 'large';
           fullwidth?: boolean;
           rounded?: boolean;