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

package/dist/scoped/scoped.api.json

@@ -0,0 +1,891 @@
+{
+  "metadata": {
+    "toolPackage": "@microsoft/api-extractor",
+    "toolVersion": "7.60.1",
+    "schemaVersion": 1011,
+    "oldestForwardsCompatibleVersion": 1001,
+    "tsdocConfig": {
+      "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+      "noStandardTags": true,
+      "tagDefinitions": [
+        {
+          "tagName": "@alpha",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@beta",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@defaultValue",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@decorator",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@deprecated",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@eventProperty",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@example",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@experimental",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@inheritDoc",
+          "syntaxKind": "inline"
+        },
+        {
+          "tagName": "@internal",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@label",
+          "syntaxKind": "inline"
+        },
+        {
+          "tagName": "@link",
+          "syntaxKind": "inline",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@override",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@packageDocumentation",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@param",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@privateRemarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@public",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@readonly",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@remarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@returns",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@sealed",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@see",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@throws",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@typeParam",
+          "syntaxKind": "block",
+          "allowMultiple": true
+        },
+        {
+          "tagName": "@virtual",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@jsx",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxRuntime",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxFrag",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@jsxImportSource",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@betaDocumentation",
+          "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@internalRemarks",
+          "syntaxKind": "block"
+        },
+        {
+          "tagName": "@preapproved",
+          "syntaxKind": "modifier"
+        }
+      ],
+      "supportForTags": {
+        "@alpha": true,
+        "@beta": true,
+        "@defaultValue": true,
+        "@decorator": true,
+        "@deprecated": true,
+        "@eventProperty": true,
+        "@example": true,
+        "@experimental": true,
+        "@inheritDoc": true,
+        "@internal": true,
+        "@label": true,
+        "@link": true,
+        "@override": true,
+        "@packageDocumentation": true,
+        "@param": true,
+        "@privateRemarks": true,
+        "@public": true,
+        "@readonly": true,
+        "@remarks": true,
+        "@returns": true,
+        "@sealed": true,
+        "@see": true,
+        "@throws": true,
+        "@typeParam": true,
+        "@virtual": true,
+        "@betaDocumentation": true,
+        "@internalRemarks": true,
+        "@preapproved": true
+      },
+      "reportUnsupportedHtmlElements": false
+    }
+  },
+  "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,\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": [
+    {
+      "kind": "EntryPoint",
+      "canonicalReference": "@lushly-dev/fast-element!",
+      "name": "",
+      "preserveMemberOrder": false,
+      "members": [
+        {
+          "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\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",
+              "text": "export declare function createRegistry(definitions: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ElementDefinition",
+              "canonicalReference": "@lushly-dev/fast-element!ElementDefinition:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "CreateRegistryOptions",
+              "canonicalReference": "@lushly-dev/fast-element!CreateRegistryOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "CustomElementRegistry",
+              "canonicalReference": "!CustomElementRegistry:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " | undefined"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/registry.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 6,
+            "endIndex": 8
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "definitions",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "createRegistry"
+        },
+        {
+          "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\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",
+              "text": "export declare function createRegistryAsync(definitions: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ElementDefinition",
+              "canonicalReference": "@lushly-dev/fast-element!ElementDefinition:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[]"
+            },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "CreateRegistryOptions",
+              "canonicalReference": "@lushly-dev/fast-element!CreateRegistryOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "CustomElementRegistry",
+              "canonicalReference": "!CustomElementRegistry:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/registry.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 6,
+            "endIndex": 10
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "definitions",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "createRegistryAsync"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@lushly-dev/fast-element!CreateRegistryOptions:interface",
+          "docComment": "/**\n * Options for createRegistry helper.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface CreateRegistryOptions "
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/types.d.ts",
+          "releaseTag": "Public",
+          "name": "CreateRegistryOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@lushly-dev/fast-element!CreateRegistryOptions#strict:member",
+              "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",
+                  "text": "strict?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "strict",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@lushly-dev/fast-element!ElementDefinition:type",
+          "docComment": "/**\n * Element definition tuple: [Constructor, tag-name]\n *\n * @remarks\n *\n * Used with createRegistry() to define elements in a scoped registry.\n *\n * @example\n * ```typescript\n * const definitions: ElementDefinition[] = [\n *   [MyButton, 'my-button'],\n *   [MyInput, 'my-input'],\n * ];\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ElementDefinition = "
+            },
+            {
+              "kind": "Content",
+              "text": "["
+            },
+            {
+              "kind": "Reference",
+              "text": "CustomElementConstructor",
+              "canonicalReference": "!CustomElementConstructor:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", string]"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/types.d.ts",
+          "releaseTag": "Public",
+          "name": "ElementDefinition",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
+          }
+        },
+        {
+          "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\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",
+              "text": "export type ElementDefinitionMap = "
+            },
+            {
+              "kind": "Reference",
+              "text": "Record",
+              "canonicalReference": "!Record:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<string, "
+            },
+            {
+              "kind": "Reference",
+              "text": "CustomElementConstructor",
+              "canonicalReference": "!CustomElementConstructor:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/mixin.d.ts",
+          "releaseTag": "Public",
+          "name": "ElementDefinitionMap",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 5
+          }
+        },
+        {
+          "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\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",
+              "text": "export declare function ensureScopedRegistrySupport(): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<void>"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/detection.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 3
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "ensureScopedRegistrySupport"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHost:interface",
+          "docComment": "/**\n * Interface for classes that host a scoped registry.\n *\n * @remarks\n *\n * Implemented by classes using the ScopedRegistryMixin.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ScopedRegistryHost "
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/mixin.d.ts",
+          "releaseTag": "Public",
+          "name": "ScopedRegistryHost",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHost#elementDefinitions:member",
+              "docComment": "/**\n * Static element definitions for the scoped registry.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "elementDefinitions?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ElementDefinitionMap",
+                  "canonicalReference": "@lushly-dev/fast-element!ElementDefinitionMap:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "elementDefinitions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHost#scopedRegistry:member",
+              "docComment": "/**\n * The scoped registry created from elementDefinitions.\n *\n * @remarks\n *\n * Lazily created on first access.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "scopedRegistry: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CustomElementRegistry",
+                  "canonicalReference": "!CustomElementRegistry:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "scopedRegistry",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHostConstructor:interface",
+          "docComment": "/**\n * Static interface for ScopedRegistryMixin classes.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ScopedRegistryHostConstructor "
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/mixin.d.ts",
+          "releaseTag": "Public",
+          "name": "ScopedRegistryHostConstructor",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHostConstructor#elementDefinitions:member",
+              "docComment": "/**\n * Static element definitions for the scoped registry.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "elementDefinitions?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ElementDefinitionMap",
+                  "canonicalReference": "@lushly-dev/fast-element!ElementDefinitionMap:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "elementDefinitions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHostConstructor#getShadowOptions:member(1)",
+              "docComment": "/**\n * Gets shadow root options with the scoped registry configured.\n *\n * @param baseOptions - Optional base shadow root options to extend\n *\n * @returns Shadow root options with customElementRegistry if applicable\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getShadowOptions(baseOptions?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ScopedShadowRootInit",
+                  "canonicalReference": "@lushly-dev/fast-element!ScopedShadowRootInit:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ScopedShadowRootInit",
+                  "canonicalReference": "@lushly-dev/fast-element!ScopedShadowRootInit:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "baseOptions",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "getShadowOptions"
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHostConstructor#scopedRegistry:member",
+              "docComment": "/**\n * The scoped registry created from elementDefinitions.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly scopedRegistry: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CustomElementRegistry",
+                  "canonicalReference": "!CustomElementRegistry:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": " | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "scopedRegistry",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "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\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",
+              "text": "export declare function ScopedRegistryMixin<T extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "CustomElementConstructor",
+              "canonicalReference": "!CustomElementConstructor:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">(Base: "
+            },
+            {
+              "kind": "Content",
+              "text": "T"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "T & "
+            },
+            {
+              "kind": "Reference",
+              "text": "ScopedRegistryHostConstructor",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedRegistryHostConstructor:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/mixin.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 7
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "Base",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            }
+          ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              }
+            }
+          ],
+          "name": "ScopedRegistryMixin"
+        },
+        {
+          "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.\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",
+              "text": "export interface ScopedShadowRootInit extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "ShadowRootInit",
+              "canonicalReference": "!ShadowRootInit:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/types.d.ts",
+          "releaseTag": "Public",
+          "name": "ScopedShadowRootInit",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedShadowRootInit#customElementRegistry:member",
+              "docComment": "/**\n * Native spec key - preferred (Safari 26+, Chrome 133+ Origin Trial)\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "customElementRegistry?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CustomElementRegistry",
+                  "canonicalReference": "!CustomElementRegistry:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "customElementRegistry",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@lushly-dev/fast-element!ScopedShadowRootInit#registry:member",
+              "docComment": "/**\n * @deprecated\n *\n * Use customElementRegistry instead\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "registry?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CustomElementRegistry",
+                  "canonicalReference": "!CustomElementRegistry:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "registry",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
+        },
+        {
+          "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.\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",
+              "text": "export declare function supportsScopedRegistries(): "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/dts/scoped/detection.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "supportsScopedRegistries"
+        }
+      ]
+    }
+  ]
+}