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

package/dist/scoped/scoped.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.58.1",
+    "toolVersion": "7.60.1",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -178,7 +178,7 @@
   },
   "kind": "Package",
   "canonicalReference": "@lushly-dev/fast-element!",
-  "docComment": "/**\n * Scoped Custom Element Registries support for FAST-AF.\n *\n * @remarks\n *\n * This module provides utilities for working with Scoped Custom Element Registries, enabling isolated component definitions within shadow roots. This solves namespace collisions for micro-frontends and design system versioning.\n *\n * @example\n *\n * Using ScopedRegistryMixin (recommended)\n * ```typescript\n * import { FASTElement, html } from '@lushly-dev/fast-element';\n * import { ScopedRegistryMixin } from '@lushly-dev/fast-element/scoped.js';\n *\n * class MyButton extends HTMLElement {}\n *\n * class MyCard extends ScopedRegistryMixin(FASTElement) {\n *   static elementDefinitions = {\n *     'my-button': MyButton,\n *   };\n * }\n *\n * // The shadow root gets the scoped registry, so <my-button> is upgraded without\n * // being defined globally.\n * await FASTElement.define(MyCard, {\n *   name: 'my-card',\n *   template: html`<my-button>Click me</my-button>`,\n *   shadowOptions: MyCard.getShadowOptions(),\n * });\n * ```\n *\n * @example\n *\n * Using createRegistry directly\n * ```typescript\n * import {\n *   createRegistry,\n *   createRegistryAsync,\n *   supportsScopedRegistries,\n *   ensureScopedRegistrySupport,\n * } from '@lushly-dev/fast-element/scoped.js';\n *\n * class MyButton extends HTMLElement {}\n * class MyInput extends HTMLElement {}\n *\n * // Check support\n * if (supportsScopedRegistries()) {\n *   const registry = createRegistry([\n *     [MyButton, 'my-button'],\n *     [MyInput, 'my-input'],\n *   ]);\n *\n *   element.attachShadow({\n *     mode: 'open',\n *     customElementRegistry: registry,\n *   });\n * }\n *\n * // Or use async version with automatic polyfill\n * const registry = await createRegistryAsync([\n *   [MyButton, 'my-button'],\n * ]);\n * ```\n *\n * @packageDocumentation\n */\n",
+  "docComment": "/**\n * Scoped Custom Element Registries support for FAST-AF.\n *\n * @remarks\n *\n * This module provides utilities for working with Scoped Custom Element Registries,\n * enabling isolated component definitions within shadow roots. This solves namespace\n * collisions for micro-frontends and design system versioning.\n *\n * @example\n *\n * Using ScopedRegistryMixin (recommended)\n * ```typescript\n * import { FASTElement, html } from '@lushly-dev/fast-element';\n * import { ScopedRegistryMixin } from '@lushly-dev/fast-element/scoped.js';\n *\n * class MyButton extends HTMLElement {}\n *\n * class MyCard extends ScopedRegistryMixin(FASTElement) {\n *   static elementDefinitions = {\n *     'my-button': MyButton,\n *   };\n * }\n *\n * // The shadow root gets the scoped registry, so <my-button> is upgraded without\n * // being defined globally.\n * await FASTElement.define(MyCard, {\n *   name: 'my-card',\n *   template: html`<my-button>Click me</my-button>`,\n *   shadowOptions: MyCard.getShadowOptions(),\n * });\n * ```\n *\n * @example\n *\n * Using createRegistry directly\n * ```typescript\n * import {\n *   createRegistry,\n *   createRegistryAsync,\n *   supportsScopedRegistries,\n *   ensureScopedRegistrySupport,\n * } from '@lushly-dev/fast-element/scoped.js';\n *\n * class MyButton extends HTMLElement {}\n * class MyInput extends HTMLElement {}\n *\n * // Check support\n * if (supportsScopedRegistries()) {\n *   const registry = createRegistry([\n *     [MyButton, 'my-button'],\n *     [MyInput, 'my-input'],\n *   ]);\n *\n *   element.attachShadow({\n *     mode: 'open',\n *     customElementRegistry: registry,\n *   });\n * }\n *\n * // Or use async version with automatic polyfill\n * const registry = await createRegistryAsync([\n *   [MyButton, 'my-button'],\n * ]);\n * ```\n *\n * @packageDocumentation\n */\n",
   "name": "@lushly-dev/fast-element",
   "preserveMemberOrder": false,
   "members": [
@@ -191,7 +191,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!createRegistry:function(1)",
-          "docComment": "/**\n * Creates a scoped custom element registry with the provided element definitions.\n *\n * @remarks\n *\n * When scoped registries are supported, creates a new CustomElementRegistry and defines all provided elements in it. When not supported, falls back to registering elements on the global `customElements` registry (with a dev warning).\n *\n * In strict mode, throws an error if scoped registries are not supported instead of falling back to the global registry.\n *\n * @param definitions - Array of [Constructor, tagName] tuples to register\n *\n * @param options - Configuration options\n *\n * @returns The created registry, or undefined if fallback to global occurred\n *\n * @example\n * ```typescript\n * // Basic usage\n * const registry = createRegistry([\n *   [MyButton, 'my-button'],\n *   [MyInput, 'my-input'],\n * ]);\n *\n * if (registry) {\n *   element.attachShadow({ mode: 'open', customElementRegistry: registry });\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Strict mode - throws if not supported\n * const registry = createRegistry(\n *   [[MyButton, 'my-button']],\n *   { strict: true }\n * );\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Creates a scoped custom element registry with the provided element definitions.\n *\n * @remarks\n *\n * When scoped registries are supported, creates a new CustomElementRegistry\n * and defines all provided elements in it. When not supported, falls back to\n * registering elements on the global `customElements` registry (with a dev warning).\n *\n * In strict mode, throws an error if scoped registries are not supported\n * instead of falling back to the global registry.\n *\n * @param definitions - Array of [Constructor, tagName] tuples to register\n *\n * @param options - Configuration options\n *\n * @returns The created registry, or undefined if fallback to global occurred\n *\n * @example\n * ```typescript\n * // Basic usage\n * const registry = createRegistry([\n *   [MyButton, 'my-button'],\n *   [MyInput, 'my-input'],\n * ]);\n *\n * if (registry) {\n *   element.attachShadow({ mode: 'open', customElementRegistry: registry });\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Strict mode - throws if not supported\n * const registry = createRegistry(\n *   [[MyButton, 'my-button']],\n *   { strict: true }\n * );\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -263,7 +263,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!createRegistryAsync:function(1)",
-          "docComment": "/**\n * Creates a scoped custom element registry with automatic polyfill loading.\n *\n * @remarks\n *\n * This async version first ensures scoped registry support is available (loading the polyfill if necessary), then creates the registry.\n *\n * Unlike `createRegistry()`, this function always operates in strict mode after polyfill loading, as the polyfill should provide support. If the polyfill fails to load, the underlying `ensureScopedRegistrySupport()` will throw.\n *\n * @param definitions - Array of [Constructor, tagName] tuples to register\n *\n * @param options - Configuration options (strict is always true after polyfill)\n *\n * @returns Promise resolving to the created registry\n *\n * @throws\n *\n * Error if polyfill loading fails\n *\n * @example\n * ```typescript\n * // Automatically loads polyfill if needed\n * const registry = await createRegistryAsync([\n *   [MyButton, 'my-button'],\n *   [MyInput, 'my-input'],\n * ]);\n *\n * element.attachShadow({ mode: 'open', customElementRegistry: registry });\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Creates a scoped custom element registry with automatic polyfill loading.\n *\n * @remarks\n *\n * This async version first ensures scoped registry support is available\n * (loading the polyfill if necessary), then creates the registry.\n *\n * Unlike `createRegistry()`, this function always operates in strict mode\n * after polyfill loading, as the polyfill should provide support. If the\n * polyfill fails to load, the underlying `ensureScopedRegistrySupport()`\n * will throw.\n *\n * @param definitions - Array of [Constructor, tagName] tuples to register\n *\n * @param options - Configuration options (strict is always true after polyfill)\n *\n * @returns Promise resolving to the created registry\n *\n * @throws\n *\n * Error if polyfill loading fails\n *\n * @example\n * ```typescript\n * // Automatically loads polyfill if needed\n * const registry = await createRegistryAsync([\n *   [MyButton, 'my-button'],\n *   [MyInput, 'my-input'],\n * ]);\n *\n * element.attachShadow({ mode: 'open', customElementRegistry: registry });\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -359,7 +359,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@lushly-dev/fast-element!CreateRegistryOptions#strict:member",
-              "docComment": "/**\n * If true, throw when unsupported instead of falling back to global registry. Default: false (uses global registry fallback)\n */\n",
+              "docComment": "/**\n * If true, throw when unsupported instead of falling back to global registry.\n * Default: false (uses global registry fallback)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -424,7 +424,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@lushly-dev/fast-element!ElementDefinitionMap:type",
-          "docComment": "/**\n * Map of element definitions: tag-name to constructor.\n *\n * @remarks\n *\n * Used with ScopedRegistryMixin to define child elements that should be registered in the component's scoped registry.\n *\n * @example\n * ```typescript\n * static elementDefinitions: ElementDefinitionMap = {\n *   'my-button': MyButton,\n *   'my-input': MyInput,\n * };\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Map of element definitions: tag-name to constructor.\n *\n * @remarks\n *\n * Used with ScopedRegistryMixin to define child elements that should\n * be registered in the component's scoped registry.\n *\n * @example\n * ```typescript\n * static elementDefinitions: ElementDefinitionMap = {\n *   'my-button': MyButton,\n *   'my-input': MyInput,\n * };\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -464,7 +464,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!ensureScopedRegistrySupport:function(1)",
-          "docComment": "/**\n * Idempotency-safe polyfill loading for Scoped Custom Element Registries.\n *\n * @remarks\n *\n * Safe to call from multiple micro-frontend bundles. Uses a global flag (`window.__scopedRegistryPolyfillApplied`) to prevent double-patching which could corrupt the CustomElementRegistry prototype.\n *\n * If native support is detected, returns immediately without loading the polyfill. On polyfill load failure, the flag is reset to allow retry on subsequent calls.\n *\n * @throws\n *\n * Error if the polyfill fails to load (network error, etc.)\n *\n * @example\n * ```typescript\n * // At app startup\n * await ensureScopedRegistrySupport();\n *\n * // Now safe to use scoped registries\n * const registry = new CustomElementRegistry();\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Idempotency-safe polyfill loading for Scoped Custom Element Registries.\n *\n * @remarks\n *\n * Safe to call from multiple micro-frontend bundles. Uses a global flag\n * (`window.__scopedRegistryPolyfillApplied`) to prevent double-patching\n * which could corrupt the CustomElementRegistry prototype.\n *\n * If native support is detected, returns immediately without loading the polyfill.\n * On polyfill load failure, the flag is reset to allow retry on subsequent calls.\n *\n * @throws\n *\n * Error if the polyfill fails to load (network error, etc.)\n *\n * @example\n * ```typescript\n * // At app startup\n * await ensureScopedRegistrySupport();\n *\n * // Now safe to use scoped registries\n * const registry = new CustomElementRegistry();\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -700,7 +700,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryMixin:function(1)",
-          "docComment": "/**\n * Creates a mixin that enables scoped custom element registries for a FASTElement.\n *\n * @remarks\n *\n * The ScopedRegistryMixin provides a way to define child elements that are scoped to the component's shadow root, preventing namespace collisions in micro-frontend scenarios and enabling design system versioning.\n *\n * The mixin adds: - A static `elementDefinitions` property for defining child elements - A static `scopedRegistry` getter that lazily creates the registry - A method to get shadow root options with the scoped registry\n *\n * When scoped registries are not supported by the browser, elements fall back to the global registry with a development warning.\n *\n * @param Base - The FASTElement base class to extend\n *\n * @returns A class that supports scoped element definitions\n *\n * @example\n * ```typescript\n * import { FASTElement, html, css } from '@lushly-dev/fast-element';\n * import { ScopedRegistryMixin } from '@lushly-dev/fast-element/scoped.js';\n *\n * // Children can be plain custom elements. FASTElement children must be composed\n * // first (FASTElementDefinition.compose(MyIcon, { name: 'my-icon' })) so the\n * // registry can reuse their FAST definition; creating an element of an\n * // undefined FASTElement class throws FAST error 1401.\n * class MyButton extends HTMLElement {\n *   // Button implementation\n * }\n *\n * class MyCard extends ScopedRegistryMixin(FASTElement) {\n *   static elementDefinitions = {\n *     'my-button': MyButton,\n *   };\n * }\n *\n * // Attach the scoped registry to the shadow root through getShadowOptions().\n * // The template's <my-button> is created against it and does not need to be\n * // (and here is not) defined in the global registry.\n * await FASTElement.define(MyCard, {\n *   name: 'my-card',\n *   template: html`<my-button>Click me</my-button>`,\n *   shadowOptions: MyCard.getShadowOptions(),\n * });\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Creates a mixin that enables scoped custom element registries for a FASTElement.\n *\n * @remarks\n *\n * The ScopedRegistryMixin provides a way to define child elements that are\n * scoped to the component's shadow root, preventing namespace collisions\n * in micro-frontend scenarios and enabling design system versioning.\n *\n * The mixin adds:\n * - A static `elementDefinitions` property for defining child elements\n * - A static `scopedRegistry` getter that lazily creates the registry\n * - A method to get shadow root options with the scoped registry\n *\n * When scoped registries are not supported by the browser, elements fall back\n * to the global registry with a development warning.\n *\n * @param Base - The FASTElement base class to extend\n *\n * @returns A class that supports scoped element definitions\n *\n * @example\n * ```typescript\n * import { FASTElement, html, css } from '@lushly-dev/fast-element';\n * import { ScopedRegistryMixin } from '@lushly-dev/fast-element/scoped.js';\n *\n * // Children can be plain custom elements. FASTElement children must be composed\n * // first (FASTElementDefinition.compose(MyIcon, { name: 'my-icon' })) so the\n * // registry can reuse their FAST definition; creating an element of an\n * // undefined FASTElement class throws FAST error 1401.\n * class MyButton extends HTMLElement {\n *   // Button implementation\n * }\n *\n * class MyCard extends ScopedRegistryMixin(FASTElement) {\n *   static elementDefinitions = {\n *     'my-button': MyButton,\n *   };\n * }\n *\n * // Attach the scoped registry to the shadow root through getShadowOptions().\n * // The template's <my-button> is created against it and does not need to be\n * // (and here is not) defined in the global registry.\n * await FASTElement.define(MyCard, {\n *   name: 'my-card',\n *   template: html`<my-button>Click me</my-button>`,\n *   shadowOptions: MyCard.getShadowOptions(),\n * });\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -772,7 +772,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!ScopedShadowRootInit:interface",
-          "docComment": "/**\n * Extended ShadowRootInit with registry support.\n *\n * @remarks\n *\n * Extends the standard ShadowRootInit to support scoped custom element registries. The `customElementRegistry` property is the native spec key (Safari 26+, Chrome 133+ OT). The `registry` property is deprecated and will be removed in a future version.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Extended ShadowRootInit with registry support.\n *\n * @remarks\n *\n * Extends the standard ShadowRootInit to support scoped custom element registries.\n * The `customElementRegistry` property is the native spec key (Safari 26+, Chrome 133+ OT).\n * The `registry` property is deprecated and will be removed in a future version.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -860,7 +860,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!supportsScopedRegistries:function(1)",
-          "docComment": "/**\n * Robust feature detection for Scoped Custom Element Registries.\n *\n * @remarks\n *\n * Tests the full API surface, not just the constructor existence. This ensures the browser actually supports attaching a custom registry to a shadow root, which is the critical functionality.\n *\n * @returns true if the browser supports scoped custom element registries\n *\n * @example\n * ```typescript\n * if (supportsScopedRegistries()) {\n *   const registry = new CustomElementRegistry();\n *   element.attachShadow({ mode: 'open', customElementRegistry: registry });\n * }\n * ```\n *\n * @public\n */\n",
+          "docComment": "/**\n * Robust feature detection for Scoped Custom Element Registries.\n *\n * @remarks\n *\n * Tests the full API surface, not just the constructor existence.\n * This ensures the browser actually supports attaching a custom registry\n * to a shadow root, which is the critical functionality.\n *\n * @returns true if the browser supports scoped custom element registries\n *\n * @example\n * ```typescript\n * if (supportsScopedRegistries()) {\n *   const registry = new CustomElementRegistry();\n *   element.attachShadow({ mode: 'open', customElementRegistry: registry });\n * }\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/dist/trust/trust.api.json

@@ -1,7 +1,7 @@
 {
   "metadata": {
     "toolPackage": "@microsoft/api-extractor",
-    "toolVersion": "7.58.1",
+    "toolVersion": "7.60.1",
     "schemaVersion": 1011,
     "oldestForwardsCompatibleVersion": 1001,
     "tsdocConfig": {
@@ -191,7 +191,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@lushly-dev/fast-element!getTrustSignals:function(1)",
-          "docComment": "/**\n * Extract trust signals from a CustomEvent. Returns empty object if no trust signals present.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Extract trust signals from a CustomEvent.\n * Returns empty object if no trust signals present.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -284,7 +284,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@lushly-dev/fast-element!TRUST_KEY:var",
-          "docComment": "/**\n * Property key (the string `\"__trust\"`) under which trust metadata is stored in event detail.\n *\n * @public\n */\n",
+          "docComment": "/**\n * Property key (the string `\"__trust\"`) under which trust metadata is stored in\n * event detail.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -468,7 +468,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@lushly-dev/fast-element!Warning:interface",
-          "docComment": "/**\n * A non-fatal issue surfaced alongside an event.\n *\n * @remarks\n *\n * Local stub that mirrors the `Warning` type of AFD's `CommandResult`; it can be re-exported from `@lushly-dev/afd-core` once that package is a dependency.\n *\n * @public\n */\n",
+          "docComment": "/**\n * A non-fatal issue surfaced alongside an event.\n *\n * @remarks\n *\n * Local stub that mirrors the `Warning` type of AFD's `CommandResult`; it can be\n * re-exported from `@lushly-dev/afd-core` once that package is a dependency.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lushly-dev/fast-element",
   "description": "A library for constructing Web Components",
-  "version": "3.0.1-preview.1",
+  "version": "3.0.1-preview.2",
   "author": "Lushly Dev (forked from Microsoft FAST)",
   "homepage": "https://github.com/lushly-dev/afd/tree/main/foundations/fast-af/packages/element/packages/fast-element#readme",
   "license": "MIT",
@@ -175,17 +175,15 @@
     "@webcomponents/scoped-custom-element-registry": "^0.0.10"
   },
   "devDependencies": {
-    "@ast-grep/cli": "^0.51.0",
-    "@biomejs/biome": "^2.4.7",
-    "@microsoft/api-extractor": "7.58.1",
-    "@playwright/test": "1.64.0",
-    "@rollup/plugin-terser": "1.0.0",
-    "@rollup/plugin-typescript": "12.3.0",
-    "concurrently": "10.0.3",
-    "esbuild": "0.27.7",
-    "rollup": "4.59.0",
-    "tslib": "^2.8.1",
-    "typescript": "~5.9.3",
+    "@ast-grep/cli": "^0.51.1",
+    "@biomejs/biome": "^2.6.6",
+    "@microsoft/api-extractor": "7.60.1",
+    "@playwright/test": "1.64.1",
+    "@rollup/plugin-terser": "1.0.2",
+    "concurrently": "10.0.7",
+    "esbuild": "0.28.2",
+    "rollup": "4.68.0",
+    "typescript": "^7.0.2",
     "vite": "8.3.5"
   },
   "files": [