@lushly-dev/fast-element 3.0.1-preview.1 → 3.0.1-preview.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log - @microsoft/fast-element
 
+## 3.0.1-preview.2
+
+### Patch Changes
+
+- [#960](https://github.com/lushly-dev/afd/pull/960) [`2393aaa`](https://github.com/lushly-dev/afd/commit/2393aaa8a753e9f03aebc99f2e6009da517f79a0) Thanks [@Falkicon](https://github.com/Falkicon)! - fast-element is now built with TypeScript 7. The ESM modules and declarations describe the same API: the JavaScript differs only in formatting (line wraps, separate `var` declarations for helper temporaries, their numbering), and five declaration files spell types differently (numeric keys in brackets, member and union order, `typeof noop` for `() => undefined`). The `dist/fast-element*.js` bundles are now built from that ESM output: they inline TypeScript's `__rest` helper in the two modules that use it instead of importing one copy from tslib, which adds 290 bytes to the minified bundles (gzipped, they stay within 4 bytes of before).
+
 ## 3.0.1-preview.1
 
 ### Patch Changes

package/dist/command/command.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.58.1",
+    "toolVersion": "7.60.1",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -504,7 +504,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!Action:interface",
-          "docComment": "/**\n * Action format for command palette integration. Compatible with ninja-keys and similar libraries.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Action format for command palette integration.\n * Compatible with ninja-keys and similar libraries.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1018,7 +1018,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!command:function(1)",
-          "docComment": "/**\n * Decorator that registers a method as a command. Commands are discoverable by AI agents and command palettes.\n *\n * @remarks\n *\n * - Command IDs must include a namespace prefix (e.g., \"app.action\") - Runtime warning is emitted if namespace is missing - Metadata is stored using FAST's push() pattern - Commands are registered with CommandRegistry when element connects\n *\n * @param id - Namespace-prefixed command identifier (e.g., \"editor.save\")\n *\n * @param options - Optional command configuration\n *\n * @returns A method decorator\n *\n * @example\n * ```typescript\n * class TextEditor extends FASTElement {\n *   // Basic command\n *   @command('editor.selectAll')\n *   selectAll(): CommandResult {\n *     return success({ selected: true });\n *   }\n *\n *   // Command with full options\n *   @command('editor.save', {\n *     label: 'Save Document',\n *     icon: 'save',\n *     description: 'Save the current document',\n *     category: 'File',\n *     keybinding: 'Ctrl+S',\n *     when: 'editorFocus'\n *   })\n *   save(): CommandResult {\n *     return success({ saved: true });\n *   }\n * }\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Decorator that registers a method as a command.\n * Commands are discoverable by AI agents and command palettes.\n *\n * @remarks\n *\n * - Command IDs must include a namespace prefix (e.g., \"app.action\")\n * - Runtime warning is emitted if namespace is missing\n * - Metadata is stored using FAST's push() pattern\n * - Commands are registered with CommandRegistry when element connects\n *\n * @param id - Namespace-prefixed command identifier (e.g., \"editor.save\")\n *\n * @param options - Optional command configuration\n *\n * @returns A method decorator\n *\n * @example\n * ```typescript\n * class TextEditor extends FASTElement {\n *   // Basic command\n *   @command('editor.selectAll')\n *   selectAll(): CommandResult {\n *     return success({ selected: true });\n *   }\n *\n *   // Command with full options\n *   @command('editor.save', {\n *     label: 'Save Document',\n *     icon: 'save',\n *     description: 'Save the current document',\n *     category: 'File',\n *     keybinding: 'Ctrl+S',\n *     when: 'editorFocus'\n *   })\n *   save(): CommandResult {\n *     return success({ saved: true });\n *   }\n * }\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1095,7 +1095,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@lushly-dev/fast-element!CommandBehavior:class",
-          "docComment": "/**\n * Behavior that manages command lifecycle for FASTElement components.\n *\n * @remarks\n *\n * - Discovers `command`-decorated methods via getCommandMetadata - Registers commands with CommandRegistry on connect - Unregisters commands on disconnect - Provides reactive canExecute/when getters via Observable.track()\n *\n * @public\n */\n",
+          "docComment": "/**\n * Behavior that manages command lifecycle for FASTElement components.\n *\n * @remarks\n *\n * - Discovers `command`-decorated methods via getCommandMetadata\n * - Registers commands with CommandRegistry on connect\n * - Unregisters commands on disconnect\n * - Provides reactive canExecute/when getters via Observable.track()\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1111,7 +1111,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!CommandBehavior#addedCallback:member(1)",
-              "docComment": "/**\n * Called when the behavior is first attached to a controller. Discovers all `command`-decorated methods on the host element.\n *\n * @param controller - The host controller managing this behavior\n */\n",
+              "docComment": "/**\n * Called when the behavior is first attached to a controller.\n * Discovers all `command`-decorated methods on the host element.\n *\n * @param controller - The host controller managing this behavior\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1160,7 +1160,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!CommandBehavior#connectedCallback:member(1)",
-              "docComment": "/**\n * Called when the host element connects to the DOM. Registers all discovered commands with the CommandRegistry.\n *\n * @param controller - The host controller managing this behavior\n */\n",
+              "docComment": "/**\n * Called when the host element connects to the DOM.\n * Registers all discovered commands with the CommandRegistry.\n *\n * @param controller - The host controller managing this behavior\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1209,7 +1209,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!CommandBehavior#disconnectedCallback:member(1)",
-              "docComment": "/**\n * Called when the host element disconnects from the DOM. Unregisters all commands from the CommandRegistry.\n *\n * @param controller - The host controller managing this behavior\n */\n",
+              "docComment": "/**\n * Called when the host element disconnects from the DOM.\n * Unregisters all commands from the CommandRegistry.\n *\n * @param controller - The host controller managing this behavior\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1261,7 +1261,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!CommandEntry:interface",
-          "docComment": "/**\n * Runtime command entry in the CommandRegistry. Uses AFD's CommandResult for full ecosystem alignment.\n *\n * @remarks\n *\n * Created at connect-time by CommandBehavior from CommandMetadata. The source WeakRef allows garbage collection of disconnected elements.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Runtime command entry in the CommandRegistry.\n * Uses AFD's CommandResult for full ecosystem alignment.\n *\n * @remarks\n *\n * Created at connect-time by CommandBehavior from CommandMetadata.\n * The source WeakRef allows garbage collection of disconnected elements.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1276,7 +1276,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!CommandEntry#canExecute:member",
-              "docComment": "/**\n * Whether the command can currently be executed. Reactive via Observable.track() on the source element.\n */\n",
+              "docComment": "/**\n * Whether the command can currently be executed.\n * Reactive via Observable.track() on the source element.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1411,7 +1411,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!CommandEntry#execute:member",
-              "docComment": "/**\n * Execute the command with optional arguments. Returns AFD CommandResult for consistent error handling.\n */\n",
+              "docComment": "/**\n * Execute the command with optional arguments.\n * Returns AFD CommandResult for consistent error handling.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1629,7 +1629,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!CommandEntry#methodName:member",
-              "docComment": "/**\n * Name of the method on the source element that implements the command. Set by CommandBehavior; used for conventions such as `${methodName}Undo()`.\n */\n",
+              "docComment": "/**\n * Name of the method on the source element that implements the command.\n * Set by CommandBehavior; used for conventions such as `${methodName}Undo()`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1684,7 +1684,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!CommandEntry#source:member",
-              "docComment": "/**\n * WeakRef to the source element. Allows garbage collection of disconnected elements.\n */\n",
+              "docComment": "/**\n * WeakRef to the source element.\n * Allows garbage collection of disconnected elements.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1720,7 +1720,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!CommandEntry#when:member",
-              "docComment": "/**\n * Whether the command should be visible in UI. Reactive via Observable.track() on the source element.\n */\n",
+              "docComment": "/**\n * Whether the command should be visible in UI.\n * Reactive via Observable.track() on the source element.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1954,7 +1954,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!CommandId:type",
-          "docComment": "/**\n * Namespace-prefixed command ID. TypeScript template literal enforces at compile time.\n *\n * @remarks\n *\n * Commands must include a namespace prefix to avoid collisions. Format: \"namespace.action\" or \"\\@scope/namespace.action\"\n *\n * @example\n * ```typescript\n * // Valid IDs:\n * const id1: CommandId = \"editor.save\";\n * const id2: CommandId = \"app.settings.toggle\";\n * const id3: CommandId = \"@myorg/editor.format\";\n *\n * // Invalid (compile error):\n * const bad: CommandId = \"save\"; // Missing namespace\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Namespace-prefixed command ID.\n * TypeScript template literal enforces at compile time.\n *\n * @remarks\n *\n * Commands must include a namespace prefix to avoid collisions.\n * Format: \"namespace.action\" or \"\\@scope/namespace.action\"\n *\n * @example\n * ```typescript\n * // Valid IDs:\n * const id1: CommandId = \"editor.save\";\n * const id2: CommandId = \"app.settings.toggle\";\n * const id3: CommandId = \"@myorg/editor.format\";\n *\n * // Invalid (compile error):\n * const bad: CommandId = \"save\"; // Missing namespace\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2006,7 +2006,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!CommandMetadata:interface",
-          "docComment": "/**\n * Decorator metadata stored via createMetadataLocator. Represents the compile-time configuration of a command.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Decorator metadata stored via createMetadataLocator.\n * Represents the compile-time configuration of a command.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2378,7 +2378,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!CommandOptions:interface",
-          "docComment": "/**\n * Options passed to the `command` decorator. All fields except id are optional.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Options passed to the `command` decorator.\n * All fields except id are optional.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2695,7 +2695,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@lushly-dev/fast-element!CommandRegistry:var",
-          "docComment": "/**\n * Global CommandRegistry singleton.\n *\n * @remarks\n *\n * The CommandRegistry is the central hub for command management. Commands are registered automatically when FASTElement components with \\@command decorators connect to the DOM.\n *\n * Key features: - SSR-safe with lazy initialization - Reactive: subscribe to changes via onChange() - Command palette integration via getActions() - Telemetry hooks for analytics\n *\n * @example\n * ```typescript\n * import { CommandRegistry, success, failure } from '\\@lushly-dev/fast-element/command.js';\n *\n * // Manual command registration (usually done automatically)\n * CommandRegistry.register('custom.action', \\{\n *   id: 'custom.action',\n *   label: 'Custom Action',\n *   execute: () => success(\\{ done: true \\}),\n *   canExecute: true,\n *   when: true,\n *   source: new WeakRef(document.body),\n * \\});\n *\n * // Execute command\n * const result = await CommandRegistry.execute('custom.action');\n *\n * // Command palette integration\n * const actions = CommandRegistry.getActions();\n * ninjaKeys.data = actions;\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Global CommandRegistry singleton.\n *\n * @remarks\n *\n * The CommandRegistry is the central hub for command management.\n * Commands are registered automatically when FASTElement components\n * with \\@command decorators connect to the DOM.\n *\n * Key features:\n * - SSR-safe with lazy initialization\n * - Reactive: subscribe to changes via onChange()\n * - Command palette integration via getActions()\n * - Telemetry hooks for analytics\n *\n * @example\n * ```typescript\n * import { CommandRegistry, success, failure } from '\\@lushly-dev/fast-element/command.js';\n *\n * // Manual command registration (usually done automatically)\n * CommandRegistry.register('custom.action', \\{\n *   id: 'custom.action',\n *   label: 'Custom Action',\n *   execute: () => success(\\{ done: true \\}),\n *   canExecute: true,\n *   when: true,\n *   source: new WeakRef(document.body),\n * \\});\n *\n * // Execute command\n * const result = await CommandRegistry.execute('custom.action');\n *\n * // Command palette integration\n * const actions = CommandRegistry.getActions();\n * ninjaKeys.data = actions;\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -3506,7 +3506,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!CommandResult:type",
-          "docComment": "/**\n * Result type for command execution. Discriminated union based on success field.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Result type for command execution.\n * Discriminated union based on success field.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -3580,7 +3580,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!CommandSchema:interface",
-          "docComment": "/**\n * Schema describing a command palette action. Populated by the `command` decorator during schema extraction.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Schema describing a command palette action.\n * Populated by the `command` decorator during schema extraction.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4436,7 +4436,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@lushly-dev/fast-element!ConfirmBehavior:class",
-          "docComment": "/**\n * Behavior that intercepts destructive commands and prompts for user confirmation.\n *\n * @remarks\n *\n * - Installs a shared `confirm` interceptor with the CommandRegistry while at least one instance is connected (reference counted: the interceptor is added by the first instance and removed when the last one disconnects) - Intercepts commands where `destructive: true` - When several instances are connected, the most recently connected one handles confirmations; if it disconnects, the previous one takes over - Concurrent confirmations are queued: `pendingConfirmation` is the oldest unsettled one, and each `executeConfirmed()`/`cancelPending()` settles it and exposes the next - `pendingConfirmation` is observable, so templates binding to it update - Cancels any pending confirmation on disconnect\n *\n * @public\n */\n",
+          "docComment": "/**\n * Behavior that intercepts destructive commands and prompts for user confirmation.\n *\n * @remarks\n *\n * - Installs a shared `confirm` interceptor with the CommandRegistry while at\n *  least one instance is connected (reference counted: the interceptor is added\n *  by the first instance and removed when the last one disconnects)\n * - Intercepts commands where `destructive: true`\n * - When several instances are connected, the most recently connected one handles\n *  confirmations; if it disconnects, the previous one takes over\n * - Concurrent confirmations are queued: `pendingConfirmation` is the oldest\n *  unsettled one, and each `executeConfirmed()`/`cancelPending()` settles it and\n *  exposes the next\n * - `pendingConfirmation` is observable, so templates binding to it update\n * - Cancels any pending confirmation on disconnect\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4452,7 +4452,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ConfirmBehavior#cancelPending:member(1)",
-              "docComment": "/**\n * Cancels the current pending operation.\n *\n * @remarks\n *\n * Call this when the user clicks \"Cancel\" in your confirmation UI. The intercepted command will return a USER_CANCELLED error.\n */\n",
+              "docComment": "/**\n * Cancels the current pending operation.\n *\n * @remarks\n *\n * Call this when the user clicks \"Cancel\" in your confirmation UI.\n * The intercepted command will return a USER_CANCELLED error.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4483,7 +4483,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ConfirmBehavior#connectedCallback:member(1)",
-              "docComment": "/**\n * Called when the host element connects to the DOM. Registers this instance and, for the first one, the shared interceptor.\n *\n * @param controller - The host controller managing this behavior\n */\n",
+              "docComment": "/**\n * Called when the host element connects to the DOM.\n * Registers this instance and, for the first one, the shared interceptor.\n *\n * @param controller - The host controller managing this behavior\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4532,7 +4532,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ConfirmBehavior#disconnectedCallback:member(1)",
-              "docComment": "/**\n * Called when the host element disconnects from the DOM. Cancels pending confirmations, and removes the shared interceptor when this was the last connected instance.\n *\n * @param controller - The host controller managing this behavior\n */\n",
+              "docComment": "/**\n * Called when the host element disconnects from the DOM.\n * Cancels pending confirmations, and removes the shared interceptor when this\n * was the last connected instance.\n *\n * @param controller - The host controller managing this behavior\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4581,7 +4581,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!ConfirmBehavior#executeConfirmed:member(1)",
-              "docComment": "/**\n * Confirms the current pending operation and allows it to proceed.\n *\n * @remarks\n *\n * Call this when the user clicks \"Confirm\" in your confirmation UI. The intercepted command will then execute normally.\n */\n",
+              "docComment": "/**\n * Confirms the current pending operation and allows it to proceed.\n *\n * @remarks\n *\n * Call this when the user clicks \"Confirm\" in your confirmation UI.\n * The intercepted command will then execute normally.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4612,7 +4612,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@lushly-dev/fast-element!ConfirmBehavior#pendingConfirmation:member",
-              "docComment": "/**\n * Gets the oldest pending confirmation, if any.\n *\n * @remarks\n *\n * Observable: use this in templates to show a confirmation dialog and to get the prompt text. When several confirmations are queued, the next one becomes current after the present one is settled.\n *\n * @returns The pending confirmation or null\n */\n",
+              "docComment": "/**\n * Gets the oldest pending confirmation, if any.\n *\n * @remarks\n *\n * Observable: use this in templates to show a confirmation dialog and to get the\n * prompt text. When several confirmations are queued, the next one becomes\n * current after the present one is settled.\n *\n * @returns The pending confirmation or null\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4647,7 +4647,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@lushly-dev/fast-element!ConfirmBehavior#pendingCount:member",
-              "docComment": "/**\n * Gets the number of unsettled confirmations, including the current one. Observable.\n */\n",
+              "docComment": "/**\n * Gets the number of unsettled confirmations, including the current one.\n * Observable.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -4894,7 +4894,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@lushly-dev/fast-element!DEFAULT_EXPOSE_CONFIG:var",
-          "docComment": "/**\n * Default expose configuration. Secure defaults: palette and agent are enabled, mcp and cli require opt-in.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Default expose configuration.\n * Secure defaults: palette and agent are enabled, mcp and cli require opt-in.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4931,7 +4931,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!defineConfirmDialog:function(1)",
-          "docComment": "/**\n * Defines the confirmation dialog in the provided registry.\n *\n * @remarks\n *\n * Registration is explicit so importing the command API remains side-effect free. Repeated calls for the same registry are safe.\n *\n * @param registry - Registry in which to define the dialog.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Defines the confirmation dialog in the provided registry.\n *\n * @remarks\n *\n * Registration is explicit so importing the command API remains side-effect free.\n * Repeated calls for the same registry are safe.\n *\n * @param registry - Registry in which to define the dialog.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -5109,7 +5109,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!ExposeConfig:interface",
-          "docComment": "/**\n * Configuration for which interfaces a command is exposed to. Secure defaults: palette and agent are opt-out, mcp and cli are opt-in.\n *\n * @remarks\n *\n * - palette: Command palette UI (ninja-keys, etc.) - agent: AI agents interacting with the component - mcp: Model Context Protocol servers - cli: Command-line interface tools\n *\n * @public\n */\n",
+          "docComment": "/**\n * Configuration for which interfaces a command is exposed to.\n * Secure defaults: palette and agent are opt-out, mcp and cli are opt-in.\n *\n * @remarks\n *\n * - palette: Command palette UI (ninja-keys, etc.)\n * - agent: AI agents interacting with the component\n * - mcp: Model Context Protocol servers\n * - cli: Command-line interface tools\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -5358,7 +5358,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!Interceptor:interface",
-          "docComment": "/**\n * Interceptor for command execution. Interceptors can modify, block, or wrap command execution.\n *\n * @remarks\n *\n * Interceptors run in priority order (lower priority runs first). Each interceptor must call `next()` to continue the chain.\n *\n * @example\n * ```typescript\n * CommandRegistry.addInterceptor({\n *   name: 'confirm',\n *   priority: 10,\n *   intercept: async (command, args, next) => {\n *     if (command.destructive) {\n *       const confirmed = await showConfirm('Are you sure?');\n *       if (!confirmed) return { success: false, error: { code: 'USER_CANCELLED', message: 'Cancelled' } };\n *     }\n *     return next();\n *   }\n * });\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Interceptor for command execution.\n * Interceptors can modify, block, or wrap command execution.\n *\n * @remarks\n *\n * Interceptors run in priority order (lower priority runs first).\n * Each interceptor must call `next()` to continue the chain.\n *\n * @example\n * ```typescript\n * CommandRegistry.addInterceptor({\n *   name: 'confirm',\n *   priority: 10,\n *   intercept: async (command, args, next) => {\n *     if (command.destructive) {\n *       const confirmed = await showConfirm('Are you sure?');\n *       if (!confirmed) return { success: false, error: { code: 'USER_CANCELLED', message: 'Cancelled' } };\n *     }\n *     return next();\n *   }\n * });\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -5373,7 +5373,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!Interceptor#confirms:member",
-              "docComment": "/**\n * Marks the interceptor as one that asks for user confirmation of destructive commands.\n *\n * @remarks\n *\n * Externally-originated invocations (see {@link CommandRegistryAPI.invoke}) of `destructive` commands fail closed with `CONFIRMATION_REQUIRED` unless an interceptor with this flag, or one named `confirm`, is installed.\n */\n",
+              "docComment": "/**\n * Marks the interceptor as one that asks for user confirmation of destructive\n * commands.\n *\n * @remarks\n *\n * Externally-originated invocations (see {@link CommandRegistryAPI.invoke}) of\n * `destructive` commands fail closed with `CONFIRMATION_REQUIRED` unless an\n * interceptor with this flag, or one named `confirm`, is installed.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5608,7 +5608,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!InvokeOptions#origin:member",
-              "docComment": "/**\n * The interface the invocation arrives through (`agent`, `mcp`, `cli` or `palette`). The command's `expose` configuration must enable it.\n */\n",
+              "docComment": "/**\n * The interface the invocation arrives through (`agent`, `mcp`, `cli` or\n * `palette`). The command's `expose` configuration must enable it.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5802,7 +5802,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!JSONSchema:type",
-          "docComment": "/**\n * JSONSchema type for parameter validation. Flexible until formal JSON Schema type is added.\n *\n * @public\n */\n",
+          "docComment": "/**\n * JSONSchema type for parameter validation.\n * Flexible until formal JSON Schema type is added.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -6469,7 +6469,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!PostHook:interface",
-          "docComment": "/**\n * PostHook for observing command execution results. PostHooks run after command execution completes (success or failure).\n *\n * @remarks\n *\n * Unlike interceptors, post-hooks cannot modify the result. They are useful for: - Logging and analytics - Building undo stacks - Triggering side effects\n *\n * @example\n * ```typescript\n * CommandRegistry.addPostHook({\n *   name: 'undo',\n *   afterExecute: (command, args, result) => {\n *     if (result.success && command.undoable) {\n *       undoStack.push({ command, args, result });\n *     }\n *   }\n * });\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * PostHook for observing command execution results.\n * PostHooks run after command execution completes (success or failure).\n *\n * @remarks\n *\n * Unlike interceptors, post-hooks cannot modify the result.\n * They are useful for:\n * - Logging and analytics\n * - Building undo stacks\n * - Triggering side effects\n *\n * @example\n * ```typescript\n * CommandRegistry.addPostHook({\n *   name: 'undo',\n *   afterExecute: (command, args, result) => {\n *     if (result.success && command.undoable) {\n *       undoStack.push({ command, args, result });\n *     }\n *   }\n * });\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -6855,7 +6855,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!registerComponentCommands:function(1)",
-          "docComment": "/**\n * Register fast.component.* commands with the CommandRegistry. Called during fast-element initialization.\n *\n * @remarks\n *\n * These commands provide runtime introspection of registered FAST elements. They have no dependencies on Creator or design-to-code packages.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Register fast.component.* commands with the CommandRegistry.\n * Called during fast-element initialization.\n *\n * @remarks\n *\n * These commands provide runtime introspection of registered FAST elements.\n * They have no dependencies on Creator or design-to-code packages.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -6883,7 +6883,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!registerValidationCommands:function(1)",
-          "docComment": "/**\n * Register fast.lint.* and fast.a11y.* commands with the CommandRegistry. Called during fast-element initialization.\n *\n * @remarks\n *\n * These commands provide code validation and accessibility auditing: - fast.lint.check: Validates code against FAST best practices - fast.a11y.audit: Runs WCAG accessibility audit on DOM elements\n *\n * @public\n */\n",
+          "docComment": "/**\n * Register fast.lint.* and fast.a11y.* commands with the CommandRegistry.\n * Called during fast-element initialization.\n *\n * @remarks\n *\n * These commands provide code validation and accessibility auditing:\n * - fast.lint.check: Validates code against FAST best practices\n * - fast.a11y.audit: Runs WCAG accessibility audit on DOM elements\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7214,7 +7214,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@lushly-dev/fast-element!UndoBehavior:class",
-          "docComment": "/**\n * Behavior that manages an undo stack for undoable commands.\n *\n * @remarks\n *\n * - Installs a shared PostHook with the CommandRegistry while at least one instance is connected (reference counted: added by the first instance, removed when the last one disconnects) - When several instances are connected, the most recently connected one records undo entries and handles the keyboard shortcut - Captures undo functions from `${methodName}Undo()` convention - Maintains a limited stack of undo entries - Provides `undo()` method and Ctrl/Cmd+Z keyboard shortcut; the shortcut is left to the browser when the event target is an editable element - Cleans up on disconnect\n *\n * @public\n */\n",
+          "docComment": "/**\n * Behavior that manages an undo stack for undoable commands.\n *\n * @remarks\n *\n * - Installs a shared PostHook with the CommandRegistry while at least one instance\n *  is connected (reference counted: added by the first instance, removed when the\n *  last one disconnects)\n * - When several instances are connected, the most recently connected one records\n *  undo entries and handles the keyboard shortcut\n * - Captures undo functions from `${methodName}Undo()` convention\n * - Maintains a limited stack of undo entries\n * - Provides `undo()` method and Ctrl/Cmd+Z keyboard shortcut; the shortcut is left\n *  to the browser when the event target is an editable element\n * - Cleans up on disconnect\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7324,7 +7324,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!UndoBehavior#connectedCallback:member(1)",
-              "docComment": "/**\n * Called when the host element connects to the DOM. Registers the undo post-hook with CommandRegistry.\n *\n * @param controller - The host controller managing this behavior\n */\n",
+              "docComment": "/**\n * Called when the host element connects to the DOM.\n * Registers the undo post-hook with CommandRegistry.\n *\n * @param controller - The host controller managing this behavior\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7373,7 +7373,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!UndoBehavior#disconnectedCallback:member(1)",
-              "docComment": "/**\n * Called when the host element disconnects from the DOM. Removes the post-hook (when this was the last instance) and cleans up state.\n *\n * @param controller - The host controller managing this behavior\n */\n",
+              "docComment": "/**\n * Called when the host element disconnects from the DOM.\n * Removes the post-hook (when this was the last instance) and cleans up state.\n *\n * @param controller - The host controller managing this behavior\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7528,7 +7528,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@lushly-dev/fast-element!UndoBehavior#undo:member(1)",
-              "docComment": "/**\n * Undoes the most recent operation.\n *\n * @remarks\n *\n * Pops the most recent entry from the stack and executes its undo function. If the undo function is async, this returns a Promise.\n *\n * @returns Promise that resolves when the undo is complete\n */\n",
+              "docComment": "/**\n * Undoes the most recent operation.\n *\n * @remarks\n *\n * Pops the most recent entry from the stack and executes its undo function.\n * If the undo function is async, this returns a Promise.\n *\n * @returns Promise that resolves when the undo is complete\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",

package/dist/context/context.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.58.1",
+    "toolVersion": "7.60.1",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -230,7 +230,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@lushly-dev/fast-element!Context:var",
-          "docComment": "/**\n * Enables using: {@link https://github.com/webcomponents-cg/community-protocols/blob/main/proposals/context.md | W3C Community Context protocol.}\n *\n * @public\n */\n",
+          "docComment": "/**\n * Enables using:\n * {@link https://github.com/webcomponents-cg/community-protocols/blob/main/proposals/context.md | W3C Community Context protocol.}\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -474,7 +474,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!ContextCallback:type",
-          "docComment": "/**\n * A callback which is provided by a context requester and is called with the value satisfying the request. This callback can be called multiple times by context providers as the requested value is changed.\n *\n * @public\n */\n",
+          "docComment": "/**\n * A callback which is provided by a context requester and is called with the value satisfying the request.\n * This callback can be called multiple times by context providers as the requested value is changed.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -513,7 +513,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!ContextDecorator:type",
-          "docComment": "/**\n * A constant key that can be used to represent a Context dependency. The key can be used for context or DI but also doubles as a decorator for resolving the associated dependency.\n *\n * @public\n */\n",
+          "docComment": "/**\n * A constant key that can be used to represent a Context dependency.\n * The key can be used for context or DI but also doubles as a decorator for\n * resolving the associated dependency.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -588,7 +588,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@lushly-dev/fast-element!ContextEvent:class",
-          "docComment": "/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `multiple` value, then a provider can call the callback multiple times if the value is changed, if this is the case the provider should pass a `dispose` method to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n *\n * @public\n */\n",
+          "docComment": "/**\n * An event fired by a context requester to signal it desires a named context.\n *\n * A provider should inspect the `context` property of the event to determine if it has a value that can\n * satisfy the request, calling the `callback` with the requested value if so.\n *\n * If the requested context event contains a truthy `multiple` value, then a provider can call the callback\n * multiple times if the value is changed, if this is the case the provider should pass a `dispose`\n * method to the callback which requesters can invoke to indicate they no longer wish to receive these updates.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -881,7 +881,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!FASTContext:type",
-          "docComment": "/**\n * A Context object defines an optional initial value for a Context, as well as a name identifier for debugging purposes. The FASTContext can also be used as a decorator to declare context dependencies or as a key for DI.\n *\n * @public\n */\n",
+          "docComment": "/**\n * A Context object defines an optional initial value for a Context, as well as a name identifier for debugging purposes.\n * The FASTContext can also be used as a decorator to declare context dependencies or as a key for DI.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",