@taprootio/espalier 3.9.0 → 4.1.0

package/dist/shared/events.d.ts

@@ -34,8 +34,10 @@ export { type FontPickerValueChangedDetail, type GoogleFont, type WebSafeFont, }
 export { type EspThemeToggleEventDetail } from "../header/esp-header.js";
 export { type PageWorkspaceResizeDetail, type PageWorkspaceResizeSource, type PageWorkspaceSeparator, } from "../page/esp-page.js";
 import type { EspalierDetails } from "../details/esp-details.js";
+import type { ActionMenuSelectDetail } from "../action-menu/esp-action-menu.js";
+import type { FocusChangedDetail } from "../focus-picker/esp-focus-picker.js";
 import type { FlyoutCloseReason } from "./flyout-events.js";
-import type { ValidityChangedDetail } from "./validation.js";
+import { type ValidityChangedDetail } from "./validation.js";
 import type { GridClickedEvent, GridItemsChangedEventDetail, GridLoadErrorEventDetail, GridLoadStartEventDetail, GridLoadSuccessEventDetail } from "../grid/esp-grid.js";
 import type { DestroyEspalierInfo } from "../info/esp-info.js";
 import type { PickerItem } from "../pickers/esp-picker-item.js";
@@ -44,6 +46,7 @@ export type { UploadEventDetail } from "../image-upload/image-helpers.js";
 import type { FontPickerValueChangedDetail } from "../font-picker/esp-font-picker.js";
 import type { EspThemeToggleEventDetail } from "../header/esp-header.js";
 import type { PageWorkspaceResizeDetail } from "../page/esp-page.js";
+import type { EspTreeEditDetail, EspTreeGraftDetail, EspTreeGraftInputDetail, EspTreeGraftRequestDetail, EspTreeNodeActionDetail, EspTreeSelectDetail, EspTreeToggleDetail } from "../tree/esp-tree.js";
 /**
  * Canonical event name strings for every CustomEvent in the library.
  *
@@ -58,47 +61,67 @@ import type { PageWorkspaceResizeDetail } from "../page/esp-page.js";
  * @menuLabel ESP_EVENTS
  */
 export declare const ESP_EVENTS: {
-    readonly VALUE_CHANGED: "value-changed";
-    readonly VALIDITY_CHANGED: "validity-changed";
-    readonly CLICKED: "clicked";
-    readonly ESP_SUBMIT: "esp-submit";
-    readonly ESP_SUBMIT_RESPONSE: "esp-submit-response";
-    readonly ESP_SUBMIT_ERROR: "esp-submit-error";
-    readonly ESP_TAB_CHANGED: "esp-tab-changed";
-    readonly ESP_TAB_UPDATED: "esp-tab-updated";
-    readonly ESP_TOGGLE: "esp-toggle";
-    readonly ESP_ACCORDION_CHANGE: "esp-accordion-change";
-    readonly DRAWER_OPENED: "drawer-opened";
-    readonly DRAWER_CLOSED: "drawer-closed";
-    readonly ESP_THEME_TOGGLE: "esp-theme-toggle";
-    readonly FLYOUT_OPENED: "flyout-opened";
-    readonly FLYOUT_CLOSED: "flyout-closed";
-    readonly FLYOUT_STATE_CHANGED: "flyout-state-changed";
-    readonly ESP_PAGE_WORKSPACE_RESIZE: "esp-page-workspace-resize";
-    readonly POPOVER_OPENED: "popover-opened";
-    readonly POPOVER_CLOSED: "popover-closed";
-    readonly GRID_EVENT: "grid-event";
+    readonly VALUE_CHANGED: "esp-value-changed";
+    readonly VALIDITY_CHANGED: "esp-validity-changed";
+    readonly CLICKED: "esp-clicked";
+    readonly ACTION_MENU_SELECT: "esp-action-menu-select";
+    readonly BURGER_OPENED: "esp-burger-opened";
+    readonly BURGER_CLOSED: "esp-burger-closed";
+    readonly DETAILS_TOGGLE: "esp-details-toggle";
+    readonly DETAILS_GROUP_CHANGE: "esp-details-group-change";
+    readonly DIALOG_OPENED: "esp-dialog-opened";
+    readonly DIALOG_CLOSING: "esp-dialog-closing";
+    readonly DIALOG_CLOSED: "esp-dialog-closed";
+    readonly FILE_UPLOAD_FILES_SELECTED: "esp-file-upload-files-selected";
+    readonly FLYOUT_OPENED: "esp-flyout-opened";
+    readonly FLYOUT_CLOSED: "esp-flyout-closed";
+    readonly FLYOUT_STATE_CHANGED: "esp-flyout-state-changed";
+    readonly FOCUS_PICKER_CHANGED: "esp-focus-picker-changed";
+    readonly FORM_DIALOG_CLOSE_REQUESTED: "esp-form-dialog-close-requested";
+    readonly FORM_SUBMIT: "esp-form-submit";
+    readonly FORM_SUBMIT_RESPONSE: "esp-form-submit-response";
+    readonly FORM_SUBMIT_ERROR: "esp-form-submit-error";
+    readonly GRID_EVENT: "esp-grid-event";
     readonly GRID_LOAD_START: "esp-grid-load-start";
     readonly GRID_LOAD_SUCCESS: "esp-grid-load-success";
     readonly GRID_LOAD_ERROR: "esp-grid-load-error";
     readonly GRID_ITEMS_CHANGED: "esp-grid-items-changed";
-    readonly DESTROY: "destroy";
-    readonly FILE_SELECTED: "file-selected";
-    readonly FILE_REMOVED: "file-removed";
-    readonly FILES_SELECTED: "files-selected";
-    readonly FILES_REJECTED: "files-rejected";
-    readonly UPLOAD_RETRY: "upload-retry";
-    readonly RETRY_UPLOAD: "retry-upload";
-    readonly IMAGES_REORDERED: "images-reordered";
-    readonly SEARCH_REQUESTED: "search-requested";
-    readonly RESULT_SELECTED: "result-selected";
-    readonly SEARCH_CLOSED: "search-closed";
-    readonly SELECTION_CHANGED: "selection-changed";
-    readonly CLOSE_MENU: "close-menu";
-    readonly REMOVE_IMAGE: "remove-image";
+    readonly HEADER_THEME_TOGGLE: "esp-header-theme-toggle";
+    readonly IMAGE_UPLOAD_FILE_SELECTED: "esp-image-upload-file-selected";
+    readonly IMAGE_UPLOAD_FILE_REMOVED: "esp-image-upload-file-removed";
+    readonly IMAGE_UPLOAD_FILES_REJECTED: "esp-image-upload-files-rejected";
+    readonly IMAGE_UPLOAD_RETRY: "esp-image-upload-retry";
+    readonly IMAGE_UPLOAD_IMAGES_REORDERED: "esp-image-upload-images-reordered";
+    readonly INFO_DESTROY: "esp-info-destroy";
+    readonly INPUT_ICON_CLICKED: "esp-input-icon-clicked";
+    readonly LIGHTBOX_CHANGED: "esp-lightbox-changed";
+    readonly MENU_GROUP_TOGGLE: "esp-menu-group-toggle";
+    readonly MENU_DRAWER_OPENED: "esp-menu-drawer-opened";
+    readonly MENU_DRAWER_CLOSED: "esp-menu-drawer-closed";
+    readonly PAGE_WORKSPACE_RESIZE: "esp-page-workspace-resize";
+    readonly PICKER_MENU_SELECTION_CHANGED: "esp-picker-menu-selection-changed";
+    readonly PICKER_MENU_CLOSE_REQUESTED: "esp-picker-menu-close-requested";
+    readonly PICKER_MENU_RANGE_CHANGED: "esp-picker-menu-range-changed";
+    readonly POPOVER_OPENED: "esp-popover-opened";
+    readonly POPOVER_CLOSED: "esp-popover-closed";
+    readonly SEARCH_REQUESTED: "esp-search-requested";
+    readonly SEARCH_RESULT_SELECTED: "esp-search-result-selected";
+    readonly SEARCH_CLOSED: "esp-search-closed";
+    readonly TAB_GROUP_CHANGED: "esp-tab-group-changed";
+    readonly TREE_SELECT: "esp-tree-select";
+    readonly TREE_TOGGLE: "esp-tree-toggle";
+    readonly TREE_GRAFT_REQUEST: "esp-tree-graft-request";
+    readonly TREE_GRAFT: "esp-tree-graft";
+    readonly TREE_EDIT: "esp-tree-edit";
+    readonly TREE_DELETE: "esp-tree-delete";
+    readonly TREE_MOVE_UP: "esp-tree-move-up";
+    readonly TREE_MOVE_DOWN: "esp-tree-move-down";
+    readonly TREE_CUT: "esp-tree-cut";
+    readonly TREE_PASTE_CHILD: "esp-tree-paste-child";
+    readonly TREE_GRAFT_INPUT: "esp-tree-graft-input";
 };
 /**
- * Detail for `value-changed` on toggle controls
+ * Detail for `esp-value-changed` on toggle controls
  * (`esp-checkbox`, `esp-switch`, `esp-radio-button`).
  *
  * @docUrl /api/toggle-value-changed-detail
@@ -112,7 +135,7 @@ export interface ToggleValueChangedDetail {
     value: string;
 }
 /**
- * Detail for `value-changed` on `esp-color-picker`.
+ * Detail for `esp-value-changed` on `esp-color-picker`.
  *
  * @docUrl /api/color-value-changed-detail
  * @menuGroup Event Details
@@ -125,7 +148,7 @@ export interface ColorValueChangedDetail {
     lightness: number;
 }
 /**
- * Detail for `esp-submit` on `esp-form`.
+ * Detail for `esp-form-submit` on `esp-form`.
  *
  * @docUrl /api/esp-submit-detail
  * @menuGroup Event Details
@@ -136,7 +159,7 @@ export interface EspSubmitDetail {
     form: HTMLFormElement;
 }
 /**
- * Detail for `esp-submit-response` on `esp-form`.
+ * Detail for `esp-form-submit-response` on `esp-form`.
  *
  * @docUrl /api/esp-submit-response-detail
  * @menuGroup Event Details
@@ -147,7 +170,7 @@ export interface EspSubmitResponseDetail {
     ok: boolean;
 }
 /**
- * Detail for `esp-submit-error` on `esp-form`.
+ * Detail for `esp-form-submit-error` on `esp-form`.
  *
  * @docUrl /api/esp-submit-error-detail
  * @menuGroup Event Details
@@ -157,7 +180,7 @@ export interface EspSubmitErrorDetail {
     error: unknown;
 }
 /**
- * Detail for `esp-tab-changed` on `esp-tab-group`.
+ * Detail for `esp-tab-group-changed` on `esp-tab-group`.
  *
  * @docUrl /api/esp-tab-changed-detail
  * @menuGroup Event Details
@@ -168,7 +191,7 @@ export interface EspTabChangedDetail {
     label: string;
 }
 /**
- * Detail for `esp-toggle` on `esp-details`.
+ * Detail for `esp-details-toggle` on `esp-details`.
  *
  * @docUrl /api/esp-toggle-detail
  * @menuGroup Event Details
@@ -178,7 +201,7 @@ export interface EspToggleDetail {
     open: boolean;
 }
 /**
- * Detail for `esp-accordion-change` on `esp-details-group`.
+ * Detail for `esp-details-group-change` on `esp-details-group`.
  *
  * @docUrl /api/esp-accordion-change-detail
  * @menuGroup Event Details
@@ -195,6 +218,7 @@ export interface EspalierButtonEventMap {
 export interface EspalierInputEventMap {
     [ESP_EVENTS.VALUE_CHANGED]: CustomEvent<string>;
     [ESP_EVENTS.VALIDITY_CHANGED]: CustomEvent<ValidityChangedDetail>;
+    [ESP_EVENTS.INPUT_ICON_CLICKED]: CustomEvent<void>;
 }
 /** Events fired by `<esp-textarea>`. */
 export interface EspalierTextareaEventMap {
@@ -219,7 +243,6 @@ export interface EspalierSwitchEventMap {
 /** Events fired by `<esp-radio-button>`. */
 export interface EspalierRadioButtonEventMap {
     [ESP_EVENTS.VALUE_CHANGED]: CustomEvent<ToggleValueChangedDetail>;
-    [ESP_EVENTS.VALIDITY_CHANGED]: CustomEvent<ValidityChangedDetail>;
 }
 /** Events fired by `<esp-radio-button-group>`. */
 export interface EspalierRadioButtonGroupEventMap {
@@ -239,12 +262,10 @@ export interface EspalierPickSomeEventMap {
 /** Events fired by `<esp-color-picker>`. */
 export interface EspalierColorPickerEventMap {
     [ESP_EVENTS.VALUE_CHANGED]: CustomEvent<ColorValueChangedDetail>;
-    [ESP_EVENTS.VALIDITY_CHANGED]: CustomEvent<ValidityChangedDetail>;
 }
 /** Events fired by `<esp-font-picker>`. */
 export interface EspalierFontPickerEventMap {
     [ESP_EVENTS.VALUE_CHANGED]: CustomEvent<FontPickerValueChangedDetail>;
-    [ESP_EVENTS.VALIDITY_CHANGED]: CustomEvent<ValidityChangedDetail>;
 }
 /** Events fired by `<esp-date-picker>`. */
 export interface EspalierDatePickerEventMap {
@@ -253,31 +274,56 @@ export interface EspalierDatePickerEventMap {
 }
 /** Events fired by `<esp-form>`. */
 export interface EspalierFormEventMap {
-    [ESP_EVENTS.ESP_SUBMIT]: CustomEvent<EspSubmitDetail>;
-    [ESP_EVENTS.ESP_SUBMIT_RESPONSE]: CustomEvent<EspSubmitResponseDetail>;
-    [ESP_EVENTS.ESP_SUBMIT_ERROR]: CustomEvent<EspSubmitErrorDetail>;
+    [ESP_EVENTS.FORM_DIALOG_CLOSE_REQUESTED]: CustomEvent<Record<string, never>>;
+    [ESP_EVENTS.FORM_SUBMIT]: CustomEvent<EspSubmitDetail>;
+    [ESP_EVENTS.FORM_SUBMIT_RESPONSE]: CustomEvent<EspSubmitResponseDetail>;
+    [ESP_EVENTS.FORM_SUBMIT_ERROR]: CustomEvent<EspSubmitErrorDetail>;
+}
+/** Events fired by `<esp-action-menu>`. */
+export interface EspalierActionMenuEventMap {
+    [ESP_EVENTS.ACTION_MENU_SELECT]: CustomEvent<ActionMenuSelectDetail>;
 }
 /** Events fired by `<esp-tab-group>`. */
 export interface EspalierTabGroupEventMap {
-    [ESP_EVENTS.ESP_TAB_CHANGED]: CustomEvent<EspTabChangedDetail>;
+    [ESP_EVENTS.TAB_GROUP_CHANGED]: CustomEvent<EspTabChangedDetail>;
 }
 /** Events fired by `<esp-details>`. */
 export interface EspalierDetailsEventMap {
-    [ESP_EVENTS.ESP_TOGGLE]: CustomEvent<EspToggleDetail>;
+    [ESP_EVENTS.DETAILS_TOGGLE]: CustomEvent<EspToggleDetail>;
 }
 /** Events fired by `<esp-details-group>`. */
 export interface EspalierDetailsGroupEventMap {
-    [ESP_EVENTS.ESP_ACCORDION_CHANGE]: CustomEvent<EspAccordionChangeDetail>;
+    [ESP_EVENTS.DETAILS_GROUP_CHANGE]: CustomEvent<EspAccordionChangeDetail>;
 }
 /** Events fired by `<esp-popover>`. */
 export interface EspalierPopoverEventMap {
     [ESP_EVENTS.POPOVER_OPENED]: CustomEvent<void>;
     [ESP_EVENTS.POPOVER_CLOSED]: CustomEvent<void>;
 }
+/** Events fired by `<esp-dialog>`. */
+export interface EspalierDialogEventMap {
+    [ESP_EVENTS.DIALOG_OPENED]: CustomEvent<Record<string, never>>;
+    [ESP_EVENTS.DIALOG_CLOSING]: CustomEvent<{
+        reason: "escape" | "close-dialog" | "api";
+    }>;
+    [ESP_EVENTS.DIALOG_CLOSED]: CustomEvent<{
+        reason: "escape" | "close-dialog" | "api";
+    }>;
+}
 /** Events fired by `<esp-menu>`. */
 export interface EspalierMenuEventMap {
-    [ESP_EVENTS.DRAWER_OPENED]: CustomEvent<void>;
-    [ESP_EVENTS.DRAWER_CLOSED]: CustomEvent<void>;
+    [ESP_EVENTS.MENU_DRAWER_OPENED]: CustomEvent<void>;
+    [ESP_EVENTS.MENU_DRAWER_CLOSED]: CustomEvent<void>;
+}
+/** Events fired by `<esp-menu-group>`. */
+export interface EspalierMenuGroupEventMap {
+    [ESP_EVENTS.MENU_GROUP_TOGGLE]: CustomEvent<{
+        open: boolean;
+    }>;
+}
+/** Events fired by `<esp-menu-item>`. */
+export interface EspalierMenuItemEventMap {
+    [ESP_EVENTS.CLICKED]: CustomEvent<Record<string, never>>;
 }
 /** Events fired by `<esp-flyout>`. */
 export interface EspalierFlyoutEventMap {
@@ -289,7 +335,11 @@ export interface EspalierFlyoutEventMap {
 }
 /** Events fired by `<esp-page>`. */
 export interface EspalierPageEventMap {
-    [ESP_EVENTS.ESP_PAGE_WORKSPACE_RESIZE]: CustomEvent<PageWorkspaceResizeDetail>;
+    [ESP_EVENTS.PAGE_WORKSPACE_RESIZE]: CustomEvent<PageWorkspaceResizeDetail>;
+}
+/** Events fired by `<esp-focus-picker>`. */
+export interface EspalierFocusPickerEventMap {
+    [ESP_EVENTS.FOCUS_PICKER_CHANGED]: CustomEvent<FocusChangedDetail>;
 }
 /** Events fired by `<esp-header-button>`. */
 export interface EspalierHeaderButtonEventMap {
@@ -297,7 +347,7 @@ export interface EspalierHeaderButtonEventMap {
 }
 /** Events fired by `<esp-header>`. */
 export interface EspalierHeaderEventMap {
-    [ESP_EVENTS.ESP_THEME_TOGGLE]: CustomEvent<EspThemeToggleEventDetail>;
+    [ESP_EVENTS.HEADER_THEME_TOGGLE]: CustomEvent<EspThemeToggleEventDetail>;
 }
 /** Events fired by `<esp-grid>`. */
 export interface EspalierGridEventMap {
@@ -309,10 +359,16 @@ export interface EspalierGridEventMap {
 }
 /** Events fired by `<esp-info>`. */
 export interface EspalierInfoEventMap {
-    [ESP_EVENTS.DESTROY]: CustomEvent<DestroyEspalierInfo>;
+    [ESP_EVENTS.INFO_DESTROY]: CustomEvent<DestroyEspalierInfo>;
+}
+/** Events fired by `<esp-lightbox>`. */
+export interface EspalierLightboxEventMap {
+    [ESP_EVENTS.LIGHTBOX_CHANGED]: CustomEvent<{
+        index: number;
+    }>;
 }
 /**
- * Detail for `images-reordered` on `esp-image-upload`.
+ * Detail for `esp-image-upload-images-reordered` on `esp-image-upload`.
  *
  * @docUrl /api/images-reordered-detail
  * @menuGroup Event Details
@@ -322,7 +378,7 @@ export interface ImagesReorderedDetail {
     images: EspalierUploadImage[];
 }
 /**
- * Detail for `files-rejected` on `esp-image-upload`.
+ * Detail for `esp-image-upload-files-rejected` on `esp-image-upload`.
  *
  * Fired when some of the user's selected files are skipped. Route it to a
  * toast or inline message if the component's built-in notice is not enough.
@@ -339,23 +395,33 @@ export interface FilesRejectedDetail {
 }
 /** Events fired by `<esp-image-upload>`. */
 export interface EspalierImageUploadEventMap {
-    [ESP_EVENTS.FILE_SELECTED]: CustomEvent<UploadEventDetail>;
-    [ESP_EVENTS.FILE_REMOVED]: CustomEvent<EspalierUploadImage>;
-    [ESP_EVENTS.FILES_REJECTED]: CustomEvent<FilesRejectedDetail>;
-    [ESP_EVENTS.UPLOAD_RETRY]: CustomEvent<UploadEventDetail>;
-    [ESP_EVENTS.IMAGES_REORDERED]: CustomEvent<ImagesReorderedDetail>;
+    [ESP_EVENTS.IMAGE_UPLOAD_FILE_SELECTED]: CustomEvent<UploadEventDetail>;
+    [ESP_EVENTS.IMAGE_UPLOAD_FILE_REMOVED]: CustomEvent<EspalierUploadImage>;
+    [ESP_EVENTS.IMAGE_UPLOAD_FILES_REJECTED]: CustomEvent<FilesRejectedDetail>;
+    [ESP_EVENTS.IMAGE_UPLOAD_RETRY]: CustomEvent<UploadEventDetail>;
+    [ESP_EVENTS.IMAGE_UPLOAD_IMAGES_REORDERED]: CustomEvent<ImagesReorderedDetail>;
 }
 /** Events fired by `<esp-file-upload>`. */
 export interface EspalierFileUploadEventMap {
-    [ESP_EVENTS.FILES_SELECTED]: CustomEvent<FileList>;
+    [ESP_EVENTS.FILE_UPLOAD_FILES_SELECTED]: CustomEvent<FileList>;
 }
 /** Events fired by `<esp-burger>`. */
 export interface EspalierBurgerEventMap {
-    [ESP_EVENTS.DRAWER_OPENED]: CustomEvent<void>;
-    [ESP_EVENTS.DRAWER_CLOSED]: CustomEvent<void>;
+    [ESP_EVENTS.BURGER_OPENED]: CustomEvent<void>;
+    [ESP_EVENTS.BURGER_CLOSED]: CustomEvent<void>;
+}
+/** Events fired by `<esp-picker-menu>`. */
+export interface EspalierPickerMenuEventMap {
+    [ESP_EVENTS.PICKER_MENU_SELECTION_CHANGED]: CustomEvent<PickerItem[]>;
+    [ESP_EVENTS.PICKER_MENU_CLOSE_REQUESTED]: CustomEvent<PickerItem[]>;
+    [ESP_EVENTS.PICKER_MENU_RANGE_CHANGED]: CustomEvent<{
+        first: number;
+        last: number;
+        items: PickerItem[];
+    }>;
 }
 /**
- * Detail for `search-requested` on `esp-search`.
+ * Detail for `esp-search-requested` on `esp-search`.
  *
  * @docUrl /api/search-requested-detail
  * @menuGroup Event Details
@@ -366,7 +432,7 @@ export interface SearchRequestedDetail {
     query: string;
 }
 /**
- * Detail for `result-selected` on `esp-search`.
+ * Detail for `esp-search-result-selected` on `esp-search`.
  *
  * @docUrl /api/result-selected-detail
  * @menuGroup Event Details
@@ -384,6 +450,21 @@ export interface EspalierSliderEventMap {
 /** Events fired by `<esp-search>`. */
 export interface EspalierSearchEventMap {
     [ESP_EVENTS.SEARCH_REQUESTED]: CustomEvent<SearchRequestedDetail>;
-    [ESP_EVENTS.RESULT_SELECTED]: CustomEvent<ResultSelectedDetail>;
+    [ESP_EVENTS.SEARCH_RESULT_SELECTED]: CustomEvent<ResultSelectedDetail>;
     [ESP_EVENTS.SEARCH_CLOSED]: CustomEvent<Record<string, never>>;
 }
+/** Events fired by `<esp-tree>`. */
+export interface EspalierTreeEventMap {
+    [ESP_EVENTS.VALIDITY_CHANGED]: CustomEvent<ValidityChangedDetail>;
+    [ESP_EVENTS.TREE_SELECT]: CustomEvent<EspTreeSelectDetail>;
+    [ESP_EVENTS.TREE_TOGGLE]: CustomEvent<EspTreeToggleDetail>;
+    [ESP_EVENTS.TREE_GRAFT_REQUEST]: CustomEvent<EspTreeGraftRequestDetail>;
+    [ESP_EVENTS.TREE_GRAFT]: CustomEvent<EspTreeGraftDetail>;
+    [ESP_EVENTS.TREE_EDIT]: CustomEvent<EspTreeEditDetail>;
+    [ESP_EVENTS.TREE_DELETE]: CustomEvent<EspTreeNodeActionDetail>;
+    [ESP_EVENTS.TREE_MOVE_UP]: CustomEvent<EspTreeNodeActionDetail>;
+    [ESP_EVENTS.TREE_MOVE_DOWN]: CustomEvent<EspTreeNodeActionDetail>;
+    [ESP_EVENTS.TREE_CUT]: CustomEvent<EspTreeNodeActionDetail>;
+    [ESP_EVENTS.TREE_PASTE_CHILD]: CustomEvent<EspTreeNodeActionDetail>;
+    [ESP_EVENTS.TREE_GRAFT_INPUT]: CustomEvent<EspTreeGraftInputDetail>;
+}

package/dist/shared/events.js

@@ -1 +1 @@
-import{VALIDITY_CHANGED_EVENT as s}from"./validation.js";const e={VALUE_CHANGED:"value-changed",VALIDITY_CHANGED:"validity-changed",CLICKED:"clicked",ESP_SUBMIT:"esp-submit",ESP_SUBMIT_RESPONSE:"esp-submit-response",ESP_SUBMIT_ERROR:"esp-submit-error",ESP_TAB_CHANGED:"esp-tab-changed",ESP_TAB_UPDATED:"esp-tab-updated",ESP_TOGGLE:"esp-toggle",ESP_ACCORDION_CHANGE:"esp-accordion-change",DRAWER_OPENED:"drawer-opened",DRAWER_CLOSED:"drawer-closed",ESP_THEME_TOGGLE:"esp-theme-toggle",FLYOUT_OPENED:"flyout-opened",FLYOUT_CLOSED:"flyout-closed",FLYOUT_STATE_CHANGED:"flyout-state-changed",ESP_PAGE_WORKSPACE_RESIZE:"esp-page-workspace-resize",POPOVER_OPENED:"popover-opened",POPOVER_CLOSED:"popover-closed",GRID_EVENT:"grid-event",GRID_LOAD_START:"esp-grid-load-start",GRID_LOAD_SUCCESS:"esp-grid-load-success",GRID_LOAD_ERROR:"esp-grid-load-error",GRID_ITEMS_CHANGED:"esp-grid-items-changed",DESTROY:"destroy",FILE_SELECTED:"file-selected",FILE_REMOVED:"file-removed",FILES_SELECTED:"files-selected",FILES_REJECTED:"files-rejected",UPLOAD_RETRY:"upload-retry",RETRY_UPLOAD:"retry-upload",IMAGES_REORDERED:"images-reordered",SEARCH_REQUESTED:"search-requested",RESULT_SELECTED:"result-selected",SEARCH_CLOSED:"search-closed",SELECTION_CHANGED:"selection-changed",CLOSE_MENU:"close-menu",REMOVE_IMAGE:"remove-image"};export{e as ESP_EVENTS,s as VALIDITY_CHANGED_EVENT};
+import{VALIDITY_CHANGED_EVENT as r}from"./validation.js";import{VALIDITY_CHANGED_EVENT as e}from"./validation.js";const _={VALUE_CHANGED:"esp-value-changed",VALIDITY_CHANGED:e,CLICKED:"esp-clicked",ACTION_MENU_SELECT:"esp-action-menu-select",BURGER_OPENED:"esp-burger-opened",BURGER_CLOSED:"esp-burger-closed",DETAILS_TOGGLE:"esp-details-toggle",DETAILS_GROUP_CHANGE:"esp-details-group-change",DIALOG_OPENED:"esp-dialog-opened",DIALOG_CLOSING:"esp-dialog-closing",DIALOG_CLOSED:"esp-dialog-closed",FILE_UPLOAD_FILES_SELECTED:"esp-file-upload-files-selected",FLYOUT_OPENED:"esp-flyout-opened",FLYOUT_CLOSED:"esp-flyout-closed",FLYOUT_STATE_CHANGED:"esp-flyout-state-changed",FOCUS_PICKER_CHANGED:"esp-focus-picker-changed",FORM_DIALOG_CLOSE_REQUESTED:"esp-form-dialog-close-requested",FORM_SUBMIT:"esp-form-submit",FORM_SUBMIT_RESPONSE:"esp-form-submit-response",FORM_SUBMIT_ERROR:"esp-form-submit-error",GRID_EVENT:"esp-grid-event",GRID_LOAD_START:"esp-grid-load-start",GRID_LOAD_SUCCESS:"esp-grid-load-success",GRID_LOAD_ERROR:"esp-grid-load-error",GRID_ITEMS_CHANGED:"esp-grid-items-changed",HEADER_THEME_TOGGLE:"esp-header-theme-toggle",IMAGE_UPLOAD_FILE_SELECTED:"esp-image-upload-file-selected",IMAGE_UPLOAD_FILE_REMOVED:"esp-image-upload-file-removed",IMAGE_UPLOAD_FILES_REJECTED:"esp-image-upload-files-rejected",IMAGE_UPLOAD_RETRY:"esp-image-upload-retry",IMAGE_UPLOAD_IMAGES_REORDERED:"esp-image-upload-images-reordered",INFO_DESTROY:"esp-info-destroy",INPUT_ICON_CLICKED:"esp-input-icon-clicked",LIGHTBOX_CHANGED:"esp-lightbox-changed",MENU_GROUP_TOGGLE:"esp-menu-group-toggle",MENU_DRAWER_OPENED:"esp-menu-drawer-opened",MENU_DRAWER_CLOSED:"esp-menu-drawer-closed",PAGE_WORKSPACE_RESIZE:"esp-page-workspace-resize",PICKER_MENU_SELECTION_CHANGED:"esp-picker-menu-selection-changed",PICKER_MENU_CLOSE_REQUESTED:"esp-picker-menu-close-requested",PICKER_MENU_RANGE_CHANGED:"esp-picker-menu-range-changed",POPOVER_OPENED:"esp-popover-opened",POPOVER_CLOSED:"esp-popover-closed",SEARCH_REQUESTED:"esp-search-requested",SEARCH_RESULT_SELECTED:"esp-search-result-selected",SEARCH_CLOSED:"esp-search-closed",TAB_GROUP_CHANGED:"esp-tab-group-changed",TREE_SELECT:"esp-tree-select",TREE_TOGGLE:"esp-tree-toggle",TREE_GRAFT_REQUEST:"esp-tree-graft-request",TREE_GRAFT:"esp-tree-graft",TREE_EDIT:"esp-tree-edit",TREE_DELETE:"esp-tree-delete",TREE_MOVE_UP:"esp-tree-move-up",TREE_MOVE_DOWN:"esp-tree-move-down",TREE_CUT:"esp-tree-cut",TREE_PASTE_CHILD:"esp-tree-paste-child",TREE_GRAFT_INPUT:"esp-tree-graft-input"};export{_ as ESP_EVENTS,r as VALIDITY_CHANGED_EVENT};

package/dist/shared/flyout-events.d.ts

@@ -1,5 +1,5 @@
 /**
- * The reason a flyout closed, carried on the `flyout-closed`
+ * The reason a flyout closed, carried on the `esp-flyout-closed`
  * event detail.
  *
  * - `"escape"` — the user pressed the Escape key

package/dist/shared/flyout-events.js

@@ -1 +1 @@
-import{getEspBus as o}from"./bus-events.js";const u=new WeakSet,r="flyout-full-height-requested";function n(t={}){s(t)}function s(t={}){const e={...t};return o().publish("show-flyout",e),u.has(e)}function c(t){u.add(t)}function i(){o().publish("close-flyout",{})}export{r as FLYOUT_FULL_HEIGHT_REQUEST_EVENT,i as closeFlyout,c as markFlyoutRequestServiced,s as publishFlyoutRequest,n as showFlyout};
+import{getEspBus as o}from"./bus-events.js";const u=new WeakSet,n="esp-internal-flyout-full-height-requested";function r(t={}){s(t)}function s(t={}){const e={...t};return o().publish("show-flyout",e),u.has(e)}function i(t){u.add(t)}function c(){o().publish("close-flyout",{})}export{n as FLYOUT_FULL_HEIGHT_REQUEST_EVENT,c as closeFlyout,i as markFlyoutRequestServiced,s as publishFlyoutRequest,r as showFlyout};

package/dist/shared/form-field-controller.d.ts

@@ -69,7 +69,7 @@ export declare class FormFieldController implements ReactiveController {
     /**
      * Push the current value into `ElementInternals` for form
      * participation, then run constraint validation and dispatch
-     * a `validity-changed` event.
+     * a `esp-validity-changed` event.
      *
      * Call this whenever the host's value changes.
      */
@@ -84,7 +84,7 @@ export declare class FormFieldController implements ReactiveController {
     syncValueSilently(): void;
     /**
      * Run constraint validation against the host's current state
-     * and dispatch a `validity-changed` event.
+     * and dispatch a `esp-validity-changed` event.
      */
     validate(): void;
     /**
@@ -99,7 +99,7 @@ export declare class FormFieldController implements ReactiveController {
     /**
      * Delegate for the host's `formResetCallback()`.
      * Calls the `onReset` hook, silently re-syncs the form value
-     * and validity, then dispatches `validity-changed` with
+     * and validity, then dispatches `esp-validity-changed` with
      * `valid: true` so that `esp-form-item` clears any displayed
      * errors. The internals are updated to reflect the real
      * (possibly invalid) state, but the event always reports

package/dist/shared/intent-values.d.ts

@@ -4,18 +4,6 @@ export declare const DEFAULT_ICON_VIEW_BOX = "0 0 24 24";
 export declare const INTENT_VARIANTS: readonly EspalierIntentVariant[];
 export declare function normalizeIntentVariant(value: string | null | undefined): EspalierIntentVariant;
 export declare function getIconHrefForHost(icon: string | null | undefined, host?: Element | null | undefined): string;
-/**
- * Former name of `getIconHrefForHost`.
- *
- * @deprecated Use `getIconHrefForHost`. This alias is retained for one release
- * so existing consumers keep compiling; it will be removed after that.
- *
- * NOTE: do not use an inline `{@link}` tag in this comment. On an exported
- * `const` alias the custom-elements-manifest analyzer tries to resolve the link
- * target and serializes the TypeScript AST node, which fails `build-cem` with
- * "Converting circular structure to JSON". A plain backticked name is safe.
- */
-export declare const getIconHref: typeof getIconHrefForHost;
 /**
  * The configured sprite, classified (ESP0176).
  *

package/dist/shared/intent-values.js

@@ -1 +1 @@
-import{traverseToClosest as i}from"./utilities.js";const u="/assets/icons.svg",N="0 0 24 24",a=/^[A-Za-z0-9][A-Za-z0-9_-]*$/u,l=100,o=new Set,s=[],d=["neutral","success","warning","danger","info"];function _(n){return d.includes(n)?n:"neutral"}function I(n,e=null){const t=n?.trim()??"";if(!a.test(t))return t.length>0&&m(t)&&console.warn(`Invalid Espalier icon name "${t}". Icon names must start with a letter or number and may only contain letters, numbers, dashes, and underscores.`),"";const r=c(e);switch(r.kind){case"url":return`${r.url}#${t}`;case"document":return`#${t}`;default:return""}}const g=I;function c(n){const e=n?i(n,"esp-root"):null;return f(e?e.iconSpriteUrl:u)}function f(n){const e=(n??"").trim();if(e.startsWith("#")){const r=e.slice(1).trim();return r?{kind:"document",spriteId:r}:{kind:"none"}}const t=e.split("#")[0]?.trim()||"";return t?{kind:"url",url:t}:{kind:"none"}}function A(n){const e=c(n);return e.kind==="url"?e.url:""}function m(n){if(o.has(n))return!1;if(o.add(n),s.push(n),s.length>l){const e=s.shift();e&&o.delete(e)}return!0}function h(){o.clear(),s.length=0}export{u as DEFAULT_ICON_SPRITE_URL,N as DEFAULT_ICON_VIEW_BOX,d as INTENT_VARIANTS,f as classifyIconSpriteValue,g as getIconHref,I as getIconHrefForHost,c as getIconSpriteReference,A as getIconSpriteUrl,_ as normalizeIntentVariant,h as resetWarnedInvalidIconNames};
+import{traverseToClosest as c}from"./utilities.js";const u="/assets/icons.svg",p="0 0 24 24",a=/^[A-Za-z0-9][A-Za-z0-9_-]*$/u,l=100,o=new Set,s=[],d=["neutral","success","warning","danger","info"];function N(n){return d.includes(n)?n:"neutral"}function _(n,e=null){const t=n?.trim()??"";if(!a.test(t))return t.length>0&&f(t)&&console.warn(`Invalid Espalier icon name "${t}". Icon names must start with a letter or number and may only contain letters, numbers, dashes, and underscores.`),"";const r=i(e);switch(r.kind){case"url":return`${r.url}#${t}`;case"document":return`#${t}`;default:return""}}function i(n){const e=n?c(n,"esp-root"):null;return I(e?e.iconSpriteUrl:u)}function I(n){const e=(n??"").trim();if(e.startsWith("#")){const r=e.slice(1).trim();return r?{kind:"document",spriteId:r}:{kind:"none"}}const t=e.split("#")[0]?.trim()||"";return t?{kind:"url",url:t}:{kind:"none"}}function A(n){const e=i(n);return e.kind==="url"?e.url:""}function f(n){if(o.has(n))return!1;if(o.add(n),s.push(n),s.length>l){const e=s.shift();e&&o.delete(e)}return!0}function g(){o.clear(),s.length=0}export{u as DEFAULT_ICON_SPRITE_URL,p as DEFAULT_ICON_VIEW_BOX,d as INTENT_VARIANTS,I as classifyIconSpriteValue,_ as getIconHrefForHost,i as getIconSpriteReference,A as getIconSpriteUrl,N as normalizeIntentVariant,g as resetWarnedInvalidIconNames};

package/dist/shared/theme.d.ts

@@ -480,6 +480,15 @@ export interface EspalierTheme {
     chroma: Record<SemanticColorName, ChromaRange>;
     /** Maps each semantic token to its color source + lightness. */
     semanticMappings: SemanticMappings;
+    /**
+     * Tokens in {@link semanticMappings} that were authored as explicit pins.
+     *
+     * A resolved theme also contains mappings generated by {@link roles}. This
+     * compact marker preserves that distinction when a complete theme document
+     * is serialized, then rehydrated through {@link mergeTheme}. Consumers
+     * normally do not author this field; `mergeTheme` maintains it.
+     */
+    explicitMappingTokens?: SemanticColorName[];
     /**
      * Named brand colors available to semantic mappings as
      * `anchor:<name>` sources. Empty by default — a single-color brand
@@ -679,10 +688,10 @@ export declare function encodeTheme(partial: PartialTheme): string;
 /**
  * Recover explicit mapping provenance from a resolved theme.
  *
- * Themes produced in this process carry exact provenance in the WeakMap.
- * The comparison fallback preserves the historical behavior for a fully
- * resolved theme reconstructed outside `mergeTheme`, where provenance is
- * necessarily unavailable because it is not part of the serialized model.
+ * Themes produced in this process carry exact provenance in the WeakMap and
+ * serialize it in `explicitMappingTokens`. The comparison fallback preserves
+ * historical behavior for a legacy or manually reconstructed resolved theme
+ * that carries neither form.
  *
  * Exported for the fit report (ESP0175), which marks explicit tokens so
  * a zone's surprising value traces to the mapping that pinned it.