npm - @brightspot/ui - Versions diffs - 5.0.4-pre.20260624 → 5.2.0 - Mend

@brightspot/ui 5.0.4-pre.20260624 → 5.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (142) hide show

package/dist/tailwind.config.ts CHANGED Viewed

@@ -44,6 +44,7 @@ export default {
     { pattern: /^btu-avatar(-.*)?$/ },
     { pattern: /^btu-badge(-.*)?$/ },
     { pattern: /^btu-button(-.*)?$/ },
+    { pattern: /^btu-card(-.*)?$/ },
     { pattern: /^btu-checkbox(-.*)?$/ },
     { pattern: /^btu-dropdown(-.*)?$/ },
     { pattern: /^btu-empty-state(-.*)?$/ },
@@ -456,8 +457,7 @@ export default {
         dialog: 'light-dark(oklch(0.04 0.02 278.29 / 0.25), oklch(0.78 0.01 0 / 0.36))',
       },
       backgroundImage: {
-        'ai-gradient':
-          'linear-gradient(223deg,oklch(0.7 0.3281 339.6) 17.79%,oklch(0.5346 0.3041 294.17) 71.63%,oklch(0.5884 0.2375 262.18) 85.1%)',
+        'ai-gradient': 'linear-gradient(223deg,oklch(0.5754 0.2089 26.88) 0%,oklch(0.7469 0.17 62.06) 100%)',
         'ai-sparkles':
           'url(\'data:image/svg+xml,<svg id="eTZ5ivXu8Rf1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" shape-rendering="geometricPrecision" text-rendering="geometricPrecision" project-id="17efa608cdf84d16a374e63788db1b50" export-id="0bf32ebf687749fba502bd708375e386" cached="false"><style><![CDATA[%23eTZ5ivXu8Rf2 {animation: eTZ5ivXu8Rf2__m 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf2__m { 0% {d: path("M9.937,15.5C9.755178,14.795197,9.204803,14.244822,8.5,14.063L2.365,12.481C2.149933,12.419956,2.001525,12.223562,2.001525,12C2.001525,11.776438,2.149933,11.580044,2.365,11.519L8.5,9.936C9.204544,9.754352,9.754861,9.204417,9.937,8.5L11.519,2.365C11.579435,2.149051,11.776254,1.999751,12.0005,1.999751C12.224746,1.999751,12.421565,2.149051,12.482,2.365L14.063,8.5C14.244822,9.204803,14.795197,9.755178,15.5,9.937L21.635,11.518C21.851842,11.577812,22.002049,11.775061,22.002049,12C22.002049,12.224939,21.851842,12.422188,21.635,12.482L15.5,14.063C14.795197,14.244822,14.244822,14.795197,14.063,15.5L12.481,21.635C12.420565,21.850949,12.223746,22.000249,11.9995,22.000249C11.775254,22.000249,11.578435,21.850949,11.518,21.635L9.937,15.5Z");animation-timing-function: cubic-bezier(0.445,0.05,0.55,0.95)} 16% {d: path("M10.737,14.7C10.555178,13.995197,3.511222,19.051796,9.3,13.263L2.365,12.481C2.149933,12.419956,2.001525,12.223562,2.001525,12C2.001525,11.776438,2.149933,11.580044,2.365,11.519L9.3,10.736C10.004544,10.554352,5.006893,3.569889,10.737,9.3L11.519,2.365C11.579435,2.149051,11.776254,1.999751,12.0005,1.999751C12.224746,1.999751,12.421565,2.149051,12.482,2.365L13.263,9.3C13.444822,10.004803,21.218511,4.218506,14.7,10.737L21.635,11.518C21.851842,11.577812,22.002049,11.775061,22.002049,12C22.002049,12.224939,21.851842,12.422188,21.635,12.482L14.7,13.263C20.320377,18.883378,13.444822,13.995197,13.263,14.7L12.481,21.635C12.420565,21.850949,12.223746,22.000249,11.9995,22.000249C11.775254,22.000249,11.578435,21.850949,11.518,21.635L10.737,14.7Z");animation-timing-function: cubic-bezier(0.445,0.05,0.55,0.95)} 22% {d: path("M10.794143,14.642857C10.612321,13.938054,5.423674,17.392661,9.357143,13.205857L2.365,12.481C2.149933,12.419956,1.141856,12.223562,1.141856,12C1.141856,11.776438,2.149933,11.580044,2.365,11.519L9.357143,10.793143C10.061687,10.611495,6.64917,5.465468,10.794143,9.357143L11.519,2.365C11.579435,2.149051,11.775254,1.727963,11.9995,1.727963C12.223746,1.727963,12.421565,2.149051,12.482,2.365L13.205857,9.357143C13.387679,10.061946,19.097564,6.086127,14.642857,10.794143L21.635,11.518C21.851842,11.577812,22.858144,11.775061,22.858144,12C22.858144,12.224939,21.851842,12.422188,21.635,12.482L14.642857,13.205857C18.45604,17.272362,13.387679,13.938054,13.205857,14.642857L12.481,21.635C12.420565,21.850949,12.223746,22.603619,11.9995,22.603619C11.775254,22.603619,11.578435,21.850949,11.518,21.635L10.794143,14.642857Z");animation-timing-function: cubic-bezier(0.445,0.05,0.55,0.95)} 30% {d: path("M10.937,14.5C10.755178,13.795197,10.204803,13.244822,9.5,13.063L2.365,12.481C2.149933,12.419956,2.001525,12.223562,2.001525,12C2.001525,11.776438,2.149933,11.580044,2.365,11.519L9.5,10.936C10.204544,10.754352,10.754861,10.204417,10.937,9.5L11.519,2.365C11.579435,2.149051,11.776254,1.999751,12.0005,1.999751C12.224746,1.999751,12.421565,2.149051,12.482,2.365L13.063,9.5C13.244822,10.204803,13.795197,10.755178,14.5,10.937L21.635,11.518C21.851842,11.577812,22.002049,11.775061,22.002049,12C22.002049,12.224939,21.851842,12.422188,21.635,12.482L14.5,13.063C13.795197,13.244822,13.244822,13.795197,13.063,14.5L12.481,21.635C12.420565,21.850949,12.223746,22.000249,11.9995,22.000249C11.775254,22.000249,11.578435,21.850949,11.518,21.635L10.937,14.5Z")} 42% {d: path("M9.937,15.5C9.755178,14.795197,9.204803,14.244822,8.5,14.063L2.365,12.481C2.149933,12.419956,2.001525,12.223562,2.001525,12C2.001525,11.776438,2.149933,11.580044,2.365,11.519L8.5,9.936C9.204544,9.754352,9.754861,9.204417,9.937,8.5L11.519,2.365C11.579435,2.149051,11.776254,1.999751,12.0005,1.999751C12.224746,1.999751,12.421565,2.149051,12.482,2.365L14.063,8.5C14.244822,9.204803,14.795197,9.755178,15.5,9.937L21.635,11.518C21.851842,11.577812,22.002049,11.775061,22.002049,12C22.002049,12.224939,21.851842,12.422188,21.635,12.482L15.5,14.063C14.795197,14.244822,14.244822,14.795197,14.063,15.5L12.481,21.635C12.420565,21.850949,12.223746,22.000249,11.9995,22.000249C11.775254,22.000249,11.578435,21.850949,11.518,21.635L9.937,15.5Z")} 100% {d: path("M9.937,15.5C9.755178,14.795197,9.204803,14.244822,8.5,14.063L2.365,12.481C2.149933,12.419956,2.001525,12.223562,2.001525,12C2.001525,11.776438,2.149933,11.580044,2.365,11.519L8.5,9.936C9.204544,9.754352,9.754861,9.204417,9.937,8.5L11.519,2.365C11.579435,2.149051,11.776254,1.999751,12.0005,1.999751C12.224746,1.999751,12.421565,2.149051,12.482,2.365L14.063,8.5C14.244822,9.204803,14.795197,9.755178,15.5,9.937L21.635,11.518C21.851842,11.577812,22.002049,11.775061,22.002049,12C22.002049,12.224939,21.851842,12.422188,21.635,12.482L15.5,14.063C14.795197,14.244822,14.244822,14.795197,14.063,15.5L12.481,21.635C12.420565,21.850949,12.223746,22.000249,11.9995,22.000249C11.775254,22.000249,11.578435,21.850949,11.518,21.635L9.937,15.5Z")}} %23eTZ5ivXu8Rf2_tr {animation: eTZ5ivXu8Rf2_tr__tr 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf2_tr__tr { 0% {transform: translate(12.001787px,12px) rotate(0deg)} 18% {transform: translate(12.001787px,12px) rotate(8.312442deg)} 32% {transform: translate(12.001787px,12px) rotate(0.234247deg)} 100% {transform: translate(12.001787px,12px) rotate(0.234247deg)}} %23eTZ5ivXu8Rf2_ts {animation: eTZ5ivXu8Rf2_ts__ts 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf2_ts__ts { 0% {transform: skewX(0.92deg) skewY(0.92deg) scale(0.86,0.86)} 22% {transform: skewX(0.92deg) skewY(0.92deg) scale(0.97,0.97)} 42% {transform: skewX(0.92deg) skewY(0.92deg) scale(0.86,0.87)} 100% {transform: skewX(0.92deg) skewY(0.92deg) scale(0.86,0.87)}} %23eTZ5ivXu8Rf3 {animation: eTZ5ivXu8Rf3__fl 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf3__fl { 0% {filter: blur(0.424264px)} 42% {filter: blur(0.424264px)} 100% {filter: blur(0.424264px)}} %23eTZ5ivXu8Rf4_tr {animation: eTZ5ivXu8Rf4_tr__tr 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf4_tr__tr { 0% {transform: translate(20px,5px) rotate(0deg)} 20% {transform: translate(20px,5px) rotate(0deg);animation-timing-function: cubic-bezier(0.42,0,1,1)} 28% {transform: translate(20px,5px) rotate(90deg)} 100% {transform: translate(20px,5px) rotate(90deg)}} %23eTZ5ivXu8Rf5_tr {animation: eTZ5ivXu8Rf5_tr__tr 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf5_tr__tr { 0% {transform: translate(20px,5px) rotate(0deg)} 20% {transform: translate(20px,5px) rotate(0deg);animation-timing-function: cubic-bezier(0.42,0,1,1)} 28% {transform: translate(20px,5px) rotate(90deg)} 100% {transform: translate(20px,5px) rotate(90deg)}} %23eTZ5ivXu8Rf6_ts {animation: eTZ5ivXu8Rf6_ts__ts 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf6_ts__ts { 0% {transform: translate(4px,18px) scale(1,1);animation-timing-function: cubic-bezier(0.42,0,1,1)} 8% {transform: translate(4px,18px) scale(1.322243,1.322243);animation-timing-function: cubic-bezier(0.42,0,0.58,1)} 16% {transform: translate(4px,18px) scale(0.802685,0.802685)} 100% {transform: translate(4px,18px) scale(0.802685,0.802685)}} %23eTZ5ivXu8Rf6 {animation: eTZ5ivXu8Rf6__fl 2976.190476190476ms linear infinite normal forwards}@keyframes eTZ5ivXu8Rf6__fl { 0% {filter: blur(0px)} 8% {filter: blur(0.424264px)} 16% {filter: blur(0px)} 100% {filter: blur(0px)}}]]></style><defs><filter id="eTZ5ivXu8Rf2-filter" x="-150%" y="-150%" width="400%" height="400%"><feGaussianBlur id="eTZ5ivXu8Rf2-filter-blur-0" stdDeviation="0,0" result="result"/></filter></defs><g id="eTZ5ivXu8Rf2_tr" transform="translate(12.001787,12) rotate(0)"><g id="eTZ5ivXu8Rf2_ts" transform="skewX(0.92) skewY(0.92) scale(0.86,0.86)"><path id="eTZ5ivXu8Rf2" d="M9.937,15.5c-.181822-.704803-.732197-1.255178-1.437-1.437L2.365,12.481c-.215067-.061044-.363475-.257438-.363475-.481s.148408-.419956.363475-.481L8.5,9.936c.704544-.181648,1.254861-.731583,1.437-1.436l1.582-6.135c.060435-.215949.257254-.365249.4815-.365249s.421065.1493.4815.365249L14.063,8.5c.181822.704803.732197,1.255178,1.437,1.437l6.135,1.581c.216842.059812.367049.257061.367049.482s-.150207.422188-.367049.482L15.5,14.063c-.704803.181822-1.255178.732197-1.437,1.437l-1.582,6.135c-.060435.215949-.257254.365249-.4815.365249s-.421065-.1493-.4815-.365249L9.937,15.5Z" transform="translate(-12.001787,-12)" filter="url(%23eTZ5ivXu8Rf2-filter)" fill="none" stroke="%23000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></g></g><g id="eTZ5ivXu8Rf3" style="filter:blur(0.424264px)"><g id="eTZ5ivXu8Rf4_tr" transform="translate(20,5) rotate(0)"><path d="M20,3v4" transform="translate(-20,-5)" fill="none" stroke="%23000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></g><g id="eTZ5ivXu8Rf5_tr" transform="translate(20,5) rotate(0)"><path d="M22,5h-4" transform="translate(-20,-5)" fill="none" stroke="%23000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></g></g><g id="eTZ5ivXu8Rf6_ts" transform="translate(4,18) scale(1,1)"><g id="eTZ5ivXu8Rf6" style="filter:blur(0px)" transform="translate(-4,-18)"><path d="M4,17v2" fill="none" stroke="%23000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/><path d="M5,18h-2" fill="none" stroke="%23000" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/></g></g></svg>\')',
         'rect-outline-primary':
@@ -701,6 +701,7 @@ export default {
     require('./tailwind-plugin-badge.ts'),
     require('./tailwind-plugin-button.ts'),
     require('./tailwind-plugin-button-group.ts'),
+    require('./tailwind-plugin-card.ts'),
     require('./tailwind-plugin-checkbox.ts'),
     require('./tailwind-plugin-dropdown.ts'),
     require('./tailwind-plugin-empty-state.ts'),

package/dist/util/EventEmitterMixin.d.ts CHANGED Viewed

@@ -125,6 +125,11 @@ export interface CustomEventMap {
         message: string;
     }>;
     'btu-upload-ready': CustomEvent<unknown>;
+    'btu-card-ready': CustomEvent<unknown>;
+    'btu-esca-avatar-ready': CustomEvent<unknown>;
+    'btu-esca-avatar-complete': CustomEvent<{
+        state: string;
+    }>;
 }
 interface CombinedEventMap extends HTMLElementEventMap, CustomEventMap {
 }

package/dist/util/EventEmitterMixin.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"EventEmitterMixin.d.ts","sourceRoot":"","sources":["../../src/util/EventEmitterMixin.ts"],"names":[],"mappings":"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~~CACzC~~;AAED,UAAU,gBAAiB,SAAQ,mBAAmB,EAAE,cAAc;CAAG;AAEzE;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,0BAA0B;IAC7C,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACtG,gBAAgB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAC/C,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC9D,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI;IACP,mBAAmB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAClD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC9D,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GACvC,IAAI;CACR;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,KAsD/C,WAAW,CAAC,0BAA0B,CAAC,GAAG,CAC5E,CAAA"}
1	+ {"version":3,"file":"EventEmitterMixin.d.ts","sourceRoot":"","sources":["../../src/util/EventEmitterMixin.ts"],"names":[],"mappings":"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"}

package/dist/util/EventEmitterMixin.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"EventEmitterMixin.js","sourceRoot":"","sources":["../../src/util/EventEmitterMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;~~AA8FhC~~;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAoC,UAAa,EAAE,EAAE;IACpF,MAAM,sBAAuB,SAAQ,UAAU;QAC7C;;;;WAIG;QACH,iBAAiB;YACf,KAAK,CAAC,iBAAiB,EAAE,CAAA;YACzB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CACpB,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,EAC5C,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CACnD,CAAA;QACH,CAAC;QAED;;;;WAIG;QACH,oBAAoB;YAClB,KAAK,CAAC,oBAAoB,EAAE,CAAA;YAC5B,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QACvC,CAAC;QAED;;;;;;;;;;;;;;;;WAgBG;QACH,IAAI,CAAiC,IAAO,EAAE,MAA6C;YACzF,yEAAyE;YACzE,wDAAwD;YACxD,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;gBAClC,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,IAAI;gBACd,MAAM;aACP,CAAC,CAAA;YACF,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAClC,CAAC;KACF;IACD,OAAO,sBAAqE,CAAA;AAC9E,CAAC,CAAA"}
1	+ {"version":3,"file":"EventEmitterMixin.js","sourceRoot":"","sources":["../../src/util/EventEmitterMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAiGhC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAoC,UAAa,EAAE,EAAE;IACpF,MAAM,sBAAuB,SAAQ,UAAU;QAC7C;;;;WAIG;QACH,iBAAiB;YACf,KAAK,CAAC,iBAAiB,EAAE,CAAA;YACzB,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CACpB,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,EAC5C,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,CAAC,CACnD,CAAA;QACH,CAAC;QAED;;;;WAIG;QACH,oBAAoB;YAClB,KAAK,CAAC,oBAAoB,EAAE,CAAA;YAC5B,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QACvC,CAAC;QAED;;;;;;;;;;;;;;;;WAgBG;QACH,IAAI,CAAiC,IAAO,EAAE,MAA6C;YACzF,yEAAyE;YACzE,wDAAwD;YACxD,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;gBAClC,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,IAAI;gBACd,MAAM;aACP,CAAC,CAAA;YACF,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAClC,CAAC;KACF;IACD,OAAO,sBAAqE,CAAA;AAC9E,CAAC,CAAA"}

package/dist/util/OnFindMixin.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import { LitElement } from 'lit';
+import { type Selectors } from './onFind.js';
+type Constructor<T = object> = new (...args: any[]) => T;
+export interface OnFindRegistration {
+    /** Selector(s) passed to onFind, scoped to this element as the root. */
+    selectors: Selectors;
+    /** Invoked for each matching element onFind discovers. Must be idempotent. */
+    callback: (el: Element) => void;
+}
+export declare class OnFindMixinInterface {
+    /**
+     * Return this component's onFind registration(s), or null to skip registering
+     * (e.g. required containers aren't present yet). Return an array to register
+     * several independent sweeps; each is disposed together on disconnect.
+     * Re-invoked on every (re)registration — query containers HERE rather than
+     * capturing them once, so a reattach re-binds against the current DOM.
+     */
+    onFindRegistration(): OnFindRegistration | OnFindRegistration[] | null;
+}
+/**
+ * @mixin
+ * Registers an {@link onFind} child-redistribution callback and tears it down on
+ * disconnect, so a detached component is garbage-collectable and stops being
+ * visited on every document mutation. Handles the detach/reattach dance: the
+ * onFind registration only lives while connected, and is re-armed on reattach
+ * (Lit's `firstUpdated` fires only once).
+ *
+ * Subclasses declare what to register via {@link onFindRegistration} and MUST
+ * call `super.firstUpdated()` so the initial registration runs. Return a single
+ * registration, or an array for several independent sweeps (all disposed
+ * together on disconnect).
+ *
+ * @example
+ * ```typescript
+ * class Card extends OnFindMixin(LitElement) {
+ *   firstUpdated(changed) {
+ *     super.firstUpdated(changed) // arms onFind
+ *   }
+ *   onFindRegistration() {
+ *     return { selectors: ':scope > [slot]', callback: el => this.place(el) }
+ *   }
+ * }
+ *
+ * // Or several independent sweeps:
+ * onFindRegistration() {
+ *   return [
+ *     { selectors: ':scope > [slot]', callback: el => this.place(el) },
+ *     { selectors: '.btu-deep-thing', callback: el => this.enhance(el) },
+ *   ]
+ * }
+ * ```
+ */
+export declare const OnFindMixin: <T extends Constructor<LitElement>>(superClass: T) => Constructor<OnFindMixinInterface> & T;
+export {};
+//# sourceMappingURL=OnFindMixin.d.ts.map

package/dist/util/OnFindMixin.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"OnFindMixin.d.ts","sourceRoot":"","sources":["../../src/util/OnFindMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAChC,OAAe,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AAEpD,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAExD,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,SAAS,EAAE,SAAS,CAAA;IACpB,8EAA8E;IAC9E,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,CAAA;CAChC;AAED,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACvC;;;;;;OAMG;IACH,kBAAkB,IAAI,kBAAkB,GAAG,kBAAkB,EAAE,GAAG,IAAI;CACvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,KAkC/C,WAAW,CAAC,oBAAoB,CAAC,GAAG,CAChE,CAAA"}

package/dist/util/OnFindMixin.js ADDED Viewed

@@ -0,0 +1,70 @@
+import { LitElement } from 'lit';
+import onFind, {} from './onFind.js';
+/**
+ * @mixin
+ * Registers an {@link onFind} child-redistribution callback and tears it down on
+ * disconnect, so a detached component is garbage-collectable and stops being
+ * visited on every document mutation. Handles the detach/reattach dance: the
+ * onFind registration only lives while connected, and is re-armed on reattach
+ * (Lit's `firstUpdated` fires only once).
+ *
+ * Subclasses declare what to register via {@link onFindRegistration} and MUST
+ * call `super.firstUpdated()` so the initial registration runs. Return a single
+ * registration, or an array for several independent sweeps (all disposed
+ * together on disconnect).
+ *
+ * @example
+ * ```typescript
+ * class Card extends OnFindMixin(LitElement) {
+ *   firstUpdated(changed) {
+ *     super.firstUpdated(changed) // arms onFind
+ *   }
+ *   onFindRegistration() {
+ *     return { selectors: ':scope > [slot]', callback: el => this.place(el) }
+ *   }
+ * }
+ *
+ * // Or several independent sweeps:
+ * onFindRegistration() {
+ *   return [
+ *     { selectors: ':scope > [slot]', callback: el => this.place(el) },
+ *     { selectors: '.btu-deep-thing', callback: el => this.enhance(el) },
+ *   ]
+ * }
+ * ```
+ */
+export const OnFindMixin = (superClass) => {
+    class OnFindMixinClass extends superClass {
+        #stopFns = [];
+        onFindRegistration() {
+            return null;
+        }
+        #armFind() {
+            if (this.#stopFns.length)
+                return; // idempotent — already registered
+            const reg = this.onFindRegistration();
+            if (!reg)
+                return;
+            const regs = Array.isArray(reg) ? reg : [reg];
+            this.#stopFns = regs.map(r => onFind(this, r.selectors, r.callback));
+        }
+        connectedCallback() {
+            super.connectedCallback();
+            // Re-arm on reattach only. On first connect the render root doesn't exist
+            // yet, so firstUpdated does the initial registration.
+            if (this.hasUpdated)
+                this.#armFind();
+        }
+        firstUpdated(changedProperties) {
+            super.firstUpdated(changedProperties);
+            this.#armFind();
+        }
+        disconnectedCallback() {
+            super.disconnectedCallback();
+            this.#stopFns.forEach(stop => stop());
+            this.#stopFns = [];
+        }
+    }
+    return OnFindMixinClass;
+};
+//# sourceMappingURL=OnFindMixin.js.map

package/dist/util/OnFindMixin.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"OnFindMixin.js","sourceRoot":"","sources":["../../src/util/OnFindMixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AAChC,OAAO,MAAM,EAAE,EAAkB,MAAM,aAAa,CAAA;AAsBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAoC,UAAa,EAAE,EAAE;IAC9E,MAAM,gBAAiB,SAAQ,UAAU;QACvC,QAAQ,GAAsB,EAAE,CAAA;QAEhC,kBAAkB;YAChB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,QAAQ;YACN,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAAE,OAAM,CAAC,kCAAkC;YACnE,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAA;YACrC,IAAI,CAAC,GAAG;gBAAE,OAAM;YAChB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAU,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/E,CAAC;QAED,iBAAiB;YACf,KAAK,CAAC,iBAAiB,EAAE,CAAA;YACzB,0EAA0E;YAC1E,sDAAsD;YACtD,IAAI,IAAI,CAAC,UAAU;gBAAE,IAAI,CAAC,QAAQ,EAAE,CAAA;QACtC,CAAC;QAED,YAAY,CAAC,iBAAyD;YACpE,KAAK,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAA;YACrC,IAAI,CAAC,QAAQ,EAAE,CAAA;QACjB,CAAC;QAED,oBAAoB;YAClB,KAAK,CAAC,oBAAoB,EAAE,CAAA;YAC5B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;YACrC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;QACpB,CAAC;KACF;IACD,OAAO,gBAAyD,CAAA;AAClE,CAAC,CAAA"}

package/dist/util/onFind.d.ts CHANGED Viewed

@@ -1,7 +1,9 @@
 export type CallbackFunction<E extends Element> = (element: E) => void;
 export type Selectors = string | string[];
-declare function onFind<E extends Element>(root: ParentNode, selectors: Selectors, fn: CallbackFunction<E>): void;
-declare function onFind<E extends Element>(selectors: Selectors, fn: CallbackFunction<E>): void;
+/** Unregisters a callback registered via {@link onFind}. Safe to call more than once. */
+export type Unregister = () => void;
+declare function onFind<E extends Element>(root: ParentNode, selectors: Selectors, fn: CallbackFunction<E>): Unregister;
+declare function onFind<E extends Element>(selectors: Selectors, fn: CallbackFunction<E>): Unregister;
 declare namespace onFind {
     var triggerCallbacks: (mutations?: MutationRecord[]) => void;
     var pause: () => void;

package/dist/util/onFind.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"onFind.d.ts","sourceRoot":"","sources":["../../src/util/onFind.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AACtE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;AA0OzC,iBAAS,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,~~IAAI~~,CAAA;~~AAEzG~~,iBAAS,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,~~IAAI~~,CAAA;~~kBAA9E~~,MAAM;~~uCA/GuB~~,cAAc,EAAE;;;+~~BAyJvB~~,MAAM,EAAE;;AAcvC,eAAe,MAAM,CAAA"}
1	+ {"version":3,"file":"onFind.d.ts","sourceRoot":"","sources":["../../src/util/onFind.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AACtE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAAA;AA0OzC,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,IAAI,CAAA;AAEnC,iBAAS,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAA;AAE/G,iBAAS,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAA;kBAApF,MAAM;uCAlHuB,cAAc,EAAE;;;+BAwKvB,MAAM,EAAE;;AAcvC,eAAe,MAAM,CAAA"}

package/dist/util/onFind.js CHANGED Viewed

@@ -204,6 +204,18 @@ function onFind(rootOrSelectors, selectorsOrFn, fn) {
     const callback = new Callback(root, selectors, fn);
     callback.trigger();
     getState().callbacks.push(callback);
+    // Returns a disposer so callers with a lifecycle (e.g. web components) can
+    // remove their callback on teardown — otherwise it lives for the page and
+    // keeps `root` reachable. Re-reads state and guards the index so it is safe
+    // to call multiple times. The disposer only ever runs from a caller's own
+    // teardown (synchronous), never while `triggerCallbacks` is iterating the
+    // array (async via the observer / rAF), so the splice cannot corrupt a loop.
+    return () => {
+        const { callbacks } = getState();
+        const i = callbacks.indexOf(callback);
+        if (i !== -1)
+            callbacks.splice(i, 1);
+    };
 }
 onFind.triggerCallbacks = triggerCallbacks;
 onFind.pause = () => {

package/dist/util/onFind.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"onFind.js","sourceRoot":"","sources":["../../src/util/onFind.ts"],"names":[],"mappings":"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~~AAMD~~,SAAS,MAAM,CACb,eAAuC,EACvC,aAA8C,EAC9C,EAAwB;IAExB,iBAAiB,EAAE,CAAA;IAEnB,IAAI,IAAgB,CAAA;IACpB,IAAI,SAAoB,CAAA;IAExB,IAAI,OAAO,EAAE,KAAK,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,eAA0B,CAAA;QACjC,SAAS,GAAG,aAA0B,CAAA;IACxC,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,QAAQ,CAAA;QACf,SAAS,GAAG,eAA4B,CAAA;QACxC,EAAE,GAAG,aAAoC,CAAA;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,~~CAAC~~,CAAA;~~IAClD~~,QAAQ,CAAC,OAAO,EAAE,CAAA;IAClB,QAAQ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,~~QAA6B~~,CAAC,CAAA;~~AAC1D~~,CAAC;AAED,MAAM,CAAC,gBAAgB,GAAG,gBAAgB,CAAA;AAE1C,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE;IAClB,QAAQ,EAAE,CAAC,aAAa,GAAG,IAAI,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE;IACnB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAA;IACxB,KAAK,CAAC,aAAa,GAAG,KAAK,CAAA;IAE3B,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,KAAK,CAAC,eAAe,GAAG,KAAK,CAAA;QAC7B,UAAU,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;IACnC,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,SAAmB,EAAE,EAAE;IACzC,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED,eAAe,MAAM,CAAA"}
1	+ {"version":3,"file":"onFind.js","sourceRoot":"","sources":["../../src/util/onFind.ts"],"names":[],"mappings":"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"}

package/docs/components/ButtonGroup.md CHANGED Viewed

@@ -15,6 +15,7 @@
 | `RovingTabindexMixin`  | /src/util/RovingTabindexMixin.js  |         |
 | `ComponentStatesMixin` | /src/util/ComponentStatesMixin.js |         |
 | `EventEmitterMixin`    | /src/util/EventEmitterMixin.js    |         |
+| `OnFindMixin`          | /src/util/OnFindMixin.js          |         |
 | `ReadyMixin`           | /src/util/ReadyMixin.js           |         |
 ### Static Fields
@@ -35,12 +36,15 @@
 | `selection`   |         | `'none' \| 'single' \| 'multiple'` | `'none'`       | Enables toggle/selection behavior.&#xA;\`single\` allows one active button; \`multiple\` allows many.                                                               |                |
 | `value`       |         | `string`                           | `''`           | Reflects the currently selected button value(s).&#xA;For \`single\`, the value of the active button.&#xA;For \`multiple\`, a comma-delimited list of active values. |                |
 | `name`        |         | `string`                           | `''`           | When set, creates hidden input(s) for native form participation.                                                                                                    |                |
+| `#stopFns`    | private | `Array<() => void>`                | `[]`           |                                                                                                                                                                     | OnFindMixin    |
 ### Methods
-| Name   | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
-| ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
-| `emit` |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean` | EventEmitterMixin |
+| Name                 | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return                                               | Inherited From    |
+| -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------- | ----------------- |
+| `emit`               |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean`                                            | EventEmitterMixin |
+| `onFindRegistration` |         |                                                                                                                                                                                                                                                                                    |                                                         | `OnFindRegistration \| OnFindRegistration[] \| null` | OnFindMixin       |
+| `#armFind`           | private |                                                                                                                                                                                                                                                                                    |                                                         |                                                      | OnFindMixin       |
 ### Events

package/docs/components/Card.md ADDED Viewed

@@ -0,0 +1,83 @@
+# `src/components/card/Card.ts`:
+## class: `Card`, `btu-card`
+### Superclass
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+### Mixins
+| Name                | Module                         | Package |
+| ------------------- | ------------------------------ | ------- |
+| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `OnFindMixin`       | /src/util/OnFindMixin.js       |         |
+| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
+### Fields
+| Name           | Privacy | Type                  | Default | Description                                                                                                                                         | Inherited From |
+| -------------- | ------- | --------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `heading`      |         | `string`              | `''`    | Heading text displayed on the card.                                                                                                                 |                |
+| `headingLevel` |         | `number`              | `2`     | Heading level (1-6) for the card heading element. Drives the semantic h1–h6 tag.&#xA;Invalid values log a warning and fall back to the default (2). |                |
+| `description`  |         | `string \| undefined` |         | Supporting body text. Truncated to 3 lines via CSS.                                                                                                 |                |
+| `compact`      |         | `boolean`             | `false` | Renders the card as a compact quick-start tile.&#xA;Badge, image, fields, and secondary-action children are ignored in this case.                   |                |
+| `disabled`     |         | `boolean`             | `false` | Whether the card is disabled.                                                                                                                       |                |
+| `href`         |         | `string \| undefined` |         | Navigation URL for the entire card surface.&#xA;When set, the card renders as a link.                                                               |                |
+| `#stopFns`     | private | `Array<() => void>`   | `[]`    |                                                                                                                                                     | OnFindMixin    |
+### Methods
+| Name                 | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return                                               | Inherited From    |
+| -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------- | ----------------- |
+| `emit`               |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean`                                            | EventEmitterMixin |
+| `onFindRegistration` |         |                                                                                                                                                                                                                                                                                    |                                                         | `OnFindRegistration \| OnFindRegistration[] \| null` | OnFindMixin       |
+| `#armFind`           | private |                                                                                                                                                                                                                                                                                    |                                                         |                                                      | OnFindMixin       |
+### Events
+| Name             | Type          | Description                                 | Inherited From |
+| ---------------- | ------------- | ------------------------------------------- | -------------- |
+| `btu-card-ready` | `CustomEvent` | Fired after first render and initialization |                |
+### Attributes
+| Name            | Field        | Inherited From |
+| --------------- | ------------ | -------------- |
+| `heading`       | heading      |                |
+| `heading-level` | headingLevel |                |
+| `description`   | description  |                |
+| `compact`       | compact      |                |
+| `disabled`      | disabled     |                |
+| `href`          | href         |                |
+### CSS Properties
+| Name                     | Default | Description                                                                                           |
+| ------------------------ | ------- | ----------------------------------------------------------------------------------------------------- |
+| `--card-min-width`       |         | Minimum width of the card (default: 160px)                                                            |
+| `--card-background`      |         | Background color (default: var(--btu-theme-white))                                                    |
+| `--card-border`          |         | Border style (default: 1px solid gray-200)                                                            |
+| `--card-radius`          |         | Corner rounding (default: 8px)                                                                        |
+| `--card-img-ratio`       |         | Fixed aspect ratio for the thumbnail when an \`\<img>\` child is present (default: 16 / 9)            |
+| `--card-img-fit`         |         | Object-fit mode for the \`\<img>\` child thumbnail (default: contain)                                 |
+| `--card-icon-background` |         | Background color behind the composed icon (compact card and media-image fallback) (default: gray-100) |
+### Slots
+| Name               | Description                                                                     |
+| ------------------ | ------------------------------------------------------------------------------- |
+| `action`           | Intended for a single action in the top-right corner of the card.               |
+| `secondary-action` | Intended for a single action next to the title.                                 |
+| `fields`           | Intended for additional metadata fields displayed below the title & description |
+<hr/>
+## Exports
+| Kind                        | Name       | Declaration | Module                      | Package |
+| --------------------------- | ---------- | ----------- | --------------------------- | ------- |
+| `js`                        | `default`  | Card        | src/components/card/Card.ts |         |
+| `custom-element-definition` | `btu-card` | Card        | src/components/card/Card.ts |         |

package/docs/components/EmptyState.md CHANGED Viewed

@@ -13,6 +13,7 @@
 | Name                | Module                         | Package |
 | ------------------- | ------------------------------ | ------- |
 | `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `OnFindMixin`       | /src/util/OnFindMixin.js       |         |
 | `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
 ### Fields
@@ -24,15 +25,18 @@
 | `size`           |         | `'sm' \| 'md' \| 'lg'` | `'md'`  | Size variant of the empty state. Affects spacing, description text, graphic size,&#xA;and — when \`heading-level\` is unset — the default heading level (sm→5, md→4, lg→3).                                                                                                        |                |
 | `headingLevel`   |         | `number \| undefined`  |         | Heading level (1-6). When set to a valid integer 1-6, overrides the size-based&#xA;default and drives both the semantic h1-h6 tag and the visual heading size&#xA;(btu-heading-1 through btu-heading-6). Invalid values log a warning and fall&#xA;back to the size-based default. |                |
 | `initialClasses` | private | `string[]`             | `[]`    |                                                                                                                                                                                                                                                                                    |                |
+| `#stopFns`       | private | `Array<() => void>`    | `[]`    |                                                                                                                                                                                                                                                                                    | OnFindMixin    |
 ### Methods
-| Name                  | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return                     | Inherited From    |
-| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | -------------------------- | ----------------- |
-| `syncGraphicIconSize` | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`                     |                   |
-| `resolveHeadingLevel` | private |                                                                                                                                                                                                                                                                                    |                                                         | `HeadingLevel`             |                   |
-| `renderHeading`       | private |                                                                                                                                                                                                                                                                                    | `level: HeadingLevel, className: string`                | `TemplateResult \| string` |                   |
-| `emit`                |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean`                  | EventEmitterMixin |
+| Name                  | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return                                               | Inherited From    |
+| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------- | ----------------- |
+| `syncGraphicIconSize` | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`                                               |                   |
+| `resolveHeadingLevel` | private |                                                                                                                                                                                                                                                                                    |                                                         | `HeadingLevel`                                       |                   |
+| `renderHeading`       | private |                                                                                                                                                                                                                                                                                    | `level: HeadingLevel, className: string`                | `TemplateResult \| string`                           |                   |
+| `emit`                |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean`                                            | EventEmitterMixin |
+| `onFindRegistration`  |         |                                                                                                                                                                                                                                                                                    |                                                         | `OnFindRegistration \| OnFindRegistration[] \| null` | OnFindMixin       |
+| `#armFind`            | private |                                                                                                                                                                                                                                                                                    |                                                         |                                                      | OnFindMixin       |
 ### Events

package/docs/components/EscaAvatar.md ADDED Viewed

@@ -0,0 +1,70 @@
+# `src/components/esca-avatar/EscaAvatar.ts`:
+## class: `EscaAvatar`, `btu-esca-avatar`
+### Superclass
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+### Mixins
+| Name                | Module                         | Package |
+| ------------------- | ------------------------------ | ------- |
+| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
+### Fields
+| Name                    | Privacy | Type                                | Default  | Description                                                                                   | Inherited From |
+| ----------------------- | ------- | ----------------------------------- | -------- | --------------------------------------------------------------------------------------------- | -------------- |
+| `state`                 |         | `EscaAvatarState`                   | `'idle'` | Animation to play; changing it swaps the clip.                                                |                |
+| `size`                  |         | `EscaAvatarSize`                    | `'md'`   | Size of the avatar, mirroring \`\<btu-avatar>\`'s scale. \`--esca-avatar-size\` overrides it. |                |
+| `_containerRef`         | private | `Ref<HTMLDivElement>`               |          |                                                                                               |                |
+| `_animation`            | private | `AnimationItem \| null`             | `null`   |                                                                                               |                |
+| `_rendered`             | private | `EscaAvatarState \| null`           | `null`   |                                                                                               |                |
+| `_reduceMotion`         | private | `boolean`                           | `false`  |                                                                                               |                |
+| `_loadToken`            | private | `number`                            | `0`      |                                                                                               |                |
+| `_resizeObserver`       | private | `ResizeObserver \| undefined`       |          |                                                                                               |                |
+| `_intersectionObserver` | private | `IntersectionObserver \| undefined` |          |                                                                                               |                |
+| `_motionQuery`          | private | `MediaQueryList \| undefined`       |          |                                                                                               |                |
+| `_onMotionChange`       | private |                                     |          |                                                                                               |                |
+### Methods
+| Name         | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
+| ------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
+| `_applySize` | private |                                                                                                                                                                                                                                                                                    |                                                         |           |                   |
+| `_play`      | private |                                                                                                                                                                                                                                                                                    |                                                         |           |                   |
+| `_destroy`   | private |                                                                                                                                                                                                                                                                                    |                                                         |           |                   |
+| `emit`       |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean` | EventEmitterMixin |
+### Events
+| Name                       | Type                           | Description                                 | Inherited From |
+| -------------------------- | ------------------------------ | ------------------------------------------- | -------------- |
+| `btu-esca-avatar-ready`    | `CustomEvent`                  | Fired after the first render                |                |
+| `btu-esca-avatar-complete` | `CustomEvent<{state: string}>` | Fired when a non-looping animation finishes |                |
+### Attributes
+| Name    | Field | Inherited From |
+| ------- | ----- | -------------- |
+| `state` | state |                |
+| `size`  | size  |                |
+### CSS Properties
+| Name                 | Default | Description                                                                        |
+| -------------------- | ------- | ---------------------------------------------------------------------------------- |
+| `--esca-avatar-size` |         | Width and height of the avatar; overrides the \`size\` attribute (default: 2.5rem) |
+<hr/>
+## Exports
+| Kind                        | Name              | Declaration | Module                                   | Package |
+| --------------------------- | ----------------- | ----------- | ---------------------------------------- | ------- |
+| `js`                        | `default`         | EscaAvatar  | src/components/esca-avatar/EscaAvatar.ts |         |
+| `custom-element-definition` | `btu-esca-avatar` | EscaAvatar  | src/components/esca-avatar/EscaAvatar.ts |         |

package/docs/components/README.md CHANGED Viewed

@@ -10,6 +10,7 @@ This directory contains auto-generated API documentation for all Brightspot UI w
 - [`<btu-avatar-group>` - AvatarGroup](AvatarGroup.md)
 - [`<btu-badge>` - Badge](Badge.md)
 - [`<btu-button-group>` - ButtonGroup](ButtonGroup.md)
+- [`<btu-card>` - Card](Card.md)
 - [`<btu-checkbox>` - Checkbox](Checkbox.md)
 - [`<btu-circular-progress>` - CircularProgress](CircularProgress.md)
 - [`<btu-copy-to-clipboard>` - CopyToClipboard](CopyToClipboard.md)
@@ -17,6 +18,7 @@ This directory contains auto-generated API documentation for all Brightspot UI w
 - [`<btu-dropdown-item>` - DropdownItem](DropdownItem.md)
 - [`<btu-dropdown-menu>` - DropdownMenu](DropdownMenu.md)
 - [`<btu-empty-state>` - EmptyState](EmptyState.md)
+- [`<btu-esca-avatar>` - EscaAvatar](EscaAvatar.md)
 - [`<btu-icon>` - Icon](Icon.md)
 - [`<btu-icon-button>` - IconButton](IconButton.md)
 - [`<btu-linear-progress>` - LinearProgress](LinearProgress.md)