@mhmo91/schmancy 0.10.29 → 0.10.31

package/skills/schmancy/form.md

@@ -85,6 +85,40 @@ async _onSubmit(e: CustomEvent<SchmancyFormSubmitDetail>) {
 }
 ```
 
+## Submit-handler discipline
+
+A `@submit` handler narrows the draft type, then passes the persist promise to `ev.detail.until(...)` in one expression. The form already enforces field-level `required` and renders a rejected `until` promise inline via `formError` state — anything the handler adds on top is duplication.
+
+Anti-patterns:
+
+- Wrapping a single `await api(...)` call in an `(async () => { ... })()` IIFE solely to use `await`. `until(api(...))` accepts a promise directly; the IIFE adds nothing.
+- `if (!draft.name.trim()) throw new Error('Fill in the name.')` when the field is `<schmancy-input required>`. Required-field violations never reach the handler — schmancy-form blocks the submit dispatch before they would.
+- `throw new Error(...)` on a kind-narrowing branch (`if (draft?.kind !== 'organization')`). The other branch is impossible by construction (the form's `<schmancy-context>` isolates that kind's draft). Narrowing branches use `return`, not `throw`.
+
+The remaining legitimate throws are cross-component invariants the form can't see — e.g., "Pick a legal entity first" when a sibling picker writes to a different state singleton. Express them by passing `Promise.reject(new Error(...))` to `until`, not by re-introducing an IIFE.
+
+```ts
+// ❌ wrong
+ev.detail.until((async () => {
+  if (!draft.name.trim()) throw new Error('Fill in the name.');
+  if (auth.currentUser === null) throw new Error('Sign in.');
+  await updateWorkspace(draft.id, { name: draft.name.trim() });
+})());
+
+// ✓ right
+const draft = state.value;
+if (draft?.kind !== 'organization' || !draft.id) return;
+ev.detail.until(updateWorkspace(draft.id, { name: draft.name.trim() }));
+
+// ✓ cross-component invariant: reject inline
+const parent = ws.legalEntity.value;
+if (parent?.kind !== 'legalEntity') {
+  ev.detail.until(Promise.reject(new Error('Pick a legal entity first.')));
+  return;
+}
+ev.detail.until(createWorkspace(/* ...assembled with parent.id... */));
+```
+
 ## CSS state hooks (free)
 
 Every field broadcasts these via `:state(...)`:

package/src/state/index.ts

@@ -19,11 +19,11 @@ import { Signal } from '@lit-labs/signals'
 // `@lit/context` re-exports `ContextRequestEvent` as `ContextEvent` from
 // its public entry. Same class, just a shorter public name.
 import { ContextEvent as ContextRequestEvent, createContext } from '@lit/context'
-import { Observable } from 'rxjs'
+import { Observable, type MonoTypeOperatorFunction } from 'rxjs'
 import { produce, type Draft } from 'immer'
 
 import { createAdapter, type StorageAdapter, type StorageBackend } from './persist'
-import { resolveActiveHost, stateContextKey } from './active-host'
+import { _activeHost, resolveActiveHost, stateContextKey } from './active-host'
 // Side-effect import: registers the `<schmancy-context>` element so users
 // only need to import from `@mhmo91/schmancy/state` to get both the factory
 // and the scoping primitive.
@@ -897,3 +897,28 @@ export function observe<T>(source: ObservableState<T>) {
 		})
 	}
 }
+
+
+/**
+ * RxJS operator that restores `host` as the active schmancy context for every
+ * emission. Drop this into any pipeline whose subscriber calls state mutators
+ * from an async scheduler that bypasses the Promise.then patch (Firestore
+ * onSnapshot, WebSockets, native timers, etc.).
+ *
+ * ```ts
+ * snapshotDoc$(ref).pipe(
+ *   schmancyContext(this),
+ *   takeUntil(this.disconnecting),
+ * ).subscribe(snap => { ws.legalEntity.set(parse(snap)) })
+ * ```
+ */
+export function schmancyContext<T>(host: HTMLElement): MonoTypeOperatorFunction<T> {
+	return (source) =>
+		new Observable<T>((subscriber) =>
+			source.subscribe({
+				next: (v) => _activeHost.run(host, () => subscriber.next(v)),
+				error: (e) => subscriber.error(e),
+				complete: () => subscriber.complete(),
+			}),
+		)
+}

package/src/state/schmancy-context.ts

@@ -11,10 +11,11 @@
 // connected. `disconnectedCallback` destroys all isolated copies; their
 // pending writes flush, their adapters close.
 
-import { LitElement, html } from 'lit'
-import { property } from 'lit/decorators.js'
-import { ContextProvider, createContext, type Context } from '@lit/context'
-import { _publishEventHost, stateContextKey } from './active-host'
+import { type Context, ContextProvider, createContext } from '@lit/context';
+import { SchmancyElement } from '@mixins/SchmancyElement';
+import { html } from 'lit';
+import { property } from 'lit/decorators.js';
+import { _publishEventHost, stateContextKey } from './active-host';
 
 // Curated set of DOM event types that descendants are likely to bind state-
 // mutating handlers to. The capture-phase listener publishes `this` as the
@@ -22,109 +23,109 @@ import { _publishEventHost, stateContextKey } from './active-host'
 // inline handlers (or any code reached during the synchronous chain) call a
 // state mutator can resolve back to the isolated copy this context provides.
 const EVENT_TYPES = [
-	'click',
-	'dblclick',
-	'submit',
-	'change',
-	'input',
-	'keydown',
-	'keyup',
-	'keypress',
-	'pointerdown',
-	'pointerup',
-	'mousedown',
-	'mouseup',
-	'focus',
-	'blur',
-	'paste',
-	'drop',
-] as const
+  'click',
+  'dblclick',
+  'submit',
+  'change',
+  'input',
+  'keydown',
+  'keyup',
+  'keypress',
+  'pointerdown',
+  'pointerup',
+  'mousedown',
+  'mouseup',
+  'focus',
+  'blur',
+  'paste',
+  'drop',
+] as const;
 
 /** Duck-typed view of what the `state()` factory hands out, restricted to the
  *  bits `<schmancy-context>` needs. Kept internal — consumers see the full
  *  `State<>` type and never refer to this. */
 export interface StateTemplate {
-	readonly namespace: string
-	readonly value: unknown
-	/** Internal hook the factory adds to every state instance. Builds a fresh
-	 *  per-context copy seeded with the current value, sharing nothing with the
-	 *  global instance. The returned object exposes `destroy()` so the context
-	 *  element can flush + close on disconnect. */
-	_isolatedInstance(): { destroy(): void } & Record<string | symbol, unknown>
+  readonly namespace: string;
+  readonly value: unknown;
+  /** Internal hook the factory adds to every state instance. Builds a fresh
+   *  per-context copy seeded with the current value, sharing nothing with the
+   *  global instance. The returned object exposes `destroy()` so the context
+   *  element can flush + close on disconnect. */
+  _isolatedInstance(): { destroy(): void } & Record<string | symbol, unknown>;
 }
 
-export class SchmancyContext extends LitElement {
-	/** States to isolate under this subtree. Pass the same instances you import
-	 *  at module scope (e.g. `provides={[cart, menu]}`). Outside this element
-	 *  they continue to behave as module-scoped globals; descendants of this
-	 *  element see a per-element isolated copy. */
-	@property({ attribute: false }) provides: readonly StateTemplate[] = []
+export class SchmancyContext extends SchmancyElement {
+  /** States to isolate under this subtree. Pass the same instances you import
+   *  at module scope (e.g. `provides={[cart, menu]}`). Outside this element
+   *  they continue to behave as module-scoped globals; descendants of this
+   *  element see a per-element isolated copy. */
+  @property({ attribute: false }) provides: readonly StateTemplate[] = [];
 
-	// Per-mount records. Keep both the provider (so we can release it on
-	// disconnect) and the isolated instance (so we can destroy it).
-	private _scoped: Array<{
-		isolated: { destroy(): void }
-		provider: ContextProvider<Context<unknown, unknown>>
-	}> = []
+  // Per-mount records. Keep both the provider (so we can release it on
+  // disconnect) and the isolated instance (so we can destroy it).
+  private _scoped: Array<{
+    isolated: { destroy(): void };
+    provider: ContextProvider<Context<unknown, unknown>>;
+  }> = [];
 
-	private _publishEventTargetAsHost = (e: Event): void => {
-		// Publish the deepest event target (across shadow boundaries) rather
-		// than `this`. The downstream `ContextRequestEvent` will be dispatched
-		// from this host and must bubble up through `<schmancy-context>` to
-		// reach our `ContextProvider`. `@lit/context` skips self-registration
-		// (`consumerHost === this.host` ⇒ no-op), so dispatching from
-		// schmancy-context itself would silently fall back to the global.
-		const path = e.composedPath()
-		for (const node of path) {
-			if (node instanceof HTMLElement) {
-				_publishEventHost(node)
-				return
-			}
-		}
-	}
+  private _publishEventTargetAsHost = (e: Event): void => {
+    // Publish the deepest event target (across shadow boundaries) rather
+    // than `this`. The downstream `ContextRequestEvent` will be dispatched
+    // from this host and must bubble up through `<schmancy-context>` to
+    // reach our `ContextProvider`. `@lit/context` skips self-registration
+    // (`consumerHost === this.host` ⇒ no-op), so dispatching from
+    // schmancy-context itself would silently fall back to the global.
+    const path = e.composedPath();
+    for (const node of path) {
+      if (node instanceof HTMLElement) {
+        _publishEventHost(node);
+        return;
+      }
+    }
+  };
 
-	override connectedCallback(): void {
-		super.connectedCallback()
-		for (const tmpl of this.provides) {
-			const isolated = tmpl._isolatedInstance()
-			const ctx = createContext<unknown>(stateContextKey(tmpl.namespace))
-			// ContextProvider auto-wires via the host's ReactiveControllerHost
-			// interface (LitElement satisfies it). It listens for
-			// `context-request` events and responds with `isolated` for any
-			// requester whose `event.context === ctx`.
-			const provider = new ContextProvider(this, { context: ctx, initialValue: isolated })
-			this._scoped.push({ isolated, provider })
-		}
-		for (const type of EVENT_TYPES) {
-			this.addEventListener(type, this._publishEventTargetAsHost, { capture: true })
-		}
-	}
+  override connectedCallback(): void {
+    super.connectedCallback();
+    for (const tmpl of this.provides) {
+      const isolated = tmpl._isolatedInstance();
+      const ctx = createContext<unknown>(stateContextKey(tmpl.namespace));
+      // ContextProvider auto-wires via the host's ReactiveControllerHost
+      // interface (LitElement satisfies it). It listens for
+      // `context-request` events and responds with `isolated` for any
+      // requester whose `event.context === ctx`.
+      const provider = new ContextProvider(this, { context: ctx, initialValue: isolated });
+      this._scoped.push({ isolated, provider });
+    }
+    for (const type of EVENT_TYPES) {
+      this.addEventListener(type, this._publishEventTargetAsHost, { capture: true });
+    }
+  }
 
-	override disconnectedCallback(): void {
-		for (const type of EVENT_TYPES) {
-			this.removeEventListener(type, this._publishEventTargetAsHost, { capture: true })
-		}
-		for (const entry of this._scoped) {
-			entry.isolated.destroy()
-		}
-		this._scoped = []
-		super.disconnectedCallback()
-	}
+  override disconnectedCallback(): void {
+    for (const type of EVENT_TYPES) {
+      this.removeEventListener(type, this._publishEventTargetAsHost, { capture: true });
+    }
+    for (const entry of this._scoped) {
+      entry.isolated.destroy();
+    }
+    this._scoped = [];
+    super.disconnectedCallback();
+  }
 
-	override render() {
-		return html`<slot></slot>`
-	}
+  override render() {
+    return html`<slot></slot>`;
+  }
 }
 
 // Imperative define so a second load (source + dist) is a no-op rather than
 // a throw — the registry is process-global; whichever class wins serves the
 // element identity for the page.
 if (!customElements.get('schmancy-context')) {
-	customElements.define('schmancy-context', SchmancyContext)
+  customElements.define('schmancy-context', SchmancyContext);
 }
 
 declare global {
-	interface HTMLElementTagNameMap {
-		'schmancy-context': SchmancyContext
-	}
+  interface HTMLElementTagNameMap {
+    'schmancy-context': SchmancyContext;
+  }
 }

package/src/surface/surface.styles.ts

@@ -25,13 +25,15 @@ export const surfaceTypeStyles = css`
 		color: var(--schmancy-sys-color-surface-on);
 	}
 
-	/* Subtle — frosted glass, clearly readable */
+	/* Subtle — bright vibrant glass: near-white tint, saturated blur, top-edge highlight */
 	:host([type='subtle']) {
-		--glass-base: var(--schmancy-sys-color-surface-container);
+		--glass-base: var(--schmancy-sys-color-surface-lowest);
 		--glass-tint: var(--schmancy-sys-color-surface-on);
-		background: color-mix(in srgb, var(--glass-base) 78%, transparent);
-		backdrop-filter: blur(8px) saturate(130%);
-		-webkit-backdrop-filter: blur(8px) saturate(130%);
+		background: color-mix(in srgb, var(--glass-base) 30%, transparent);
+		backdrop-filter: blur(12px) saturate(160%);
+		-webkit-backdrop-filter: blur(12px) saturate(160%);
+		border: 1px solid color-mix(in srgb, var(--schmancy-sys-color-outlineVariant) 60%, transparent);
+		box-shadow: inset 0 1px 0 color-mix(in srgb, var(--schmancy-sys-color-surface-on) 8%, transparent);
 		color: var(--schmancy-sys-color-surface-on);
 	}
 
@@ -147,14 +149,16 @@ export const surfaceTypeStyles = css`
 		color: var(--schmancy-sys-color-surface-on);
 	}
 
-	/* subtle aliases — frosted glass */
+	/* subtle aliases — bright vibrant glass */
 	:host([type='containerLow']),
 	:host([type='container']) {
-		--glass-base: var(--schmancy-sys-color-surface-container);
+		--glass-base: var(--schmancy-sys-color-surface-lowest);
 		--glass-tint: var(--schmancy-sys-color-surface-on);
-		background: color-mix(in srgb, var(--glass-base) 78%, transparent);
-		backdrop-filter: blur(8px) saturate(130%);
-		-webkit-backdrop-filter: blur(8px) saturate(130%);
+		background: color-mix(in srgb, var(--glass-base) 30%, transparent);
+		backdrop-filter: blur(12px) saturate(160%);
+		-webkit-backdrop-filter: blur(12px) saturate(160%);
+		border: 1px solid color-mix(in srgb, var(--schmancy-sys-color-outlineVariant) 60%, transparent);
+		box-shadow: inset 0 1px 0 color-mix(in srgb, var(--schmancy-sys-color-surface-on) 8%, transparent);
 		color: var(--schmancy-sys-color-surface-on);
 	}
 

package/types/src/state/index.d.ts

@@ -1,5 +1,5 @@
 import { Signal } from '@lit-labs/signals';
-import { Observable } from 'rxjs';
+import { Observable, type MonoTypeOperatorFunction } from 'rxjs';
 import { type Draft } from 'immer';
 import { type StorageBackend } from './persist';
 import './schmancy-context';
@@ -143,3 +143,17 @@ export interface BoundState<T> {
 }
 export declare function bindState<T>(host: ReactiveControllerHost, source: ObservableState<T>): BoundState<T>;
 export declare function observe<T>(source: ObservableState<T>): (proto: object, propertyKey: string | symbol) => void;
+/**
+ * RxJS operator that restores `host` as the active schmancy context for every
+ * emission. Drop this into any pipeline whose subscriber calls state mutators
+ * from an async scheduler that bypasses the Promise.then patch (Firestore
+ * onSnapshot, WebSockets, native timers, etc.).
+ *
+ * ```ts
+ * snapshotDoc$(ref).pipe(
+ *   schmancyContext(this),
+ *   takeUntil(this.disconnecting),
+ * ).subscribe(snap => { ws.legalEntity.set(parse(snap)) })
+ * ```
+ */
+export declare function schmancyContext<T>(host: HTMLElement): MonoTypeOperatorFunction<T>;

package/types/src/state/schmancy-context.d.ts

@@ -1,4 +1,4 @@
-import { LitElement } from 'lit';
+import { SchmancyElement } from '@mixins/SchmancyElement';
 /** Duck-typed view of what the `state()` factory hands out, restricted to the
  *  bits `<schmancy-context>` needs. Kept internal — consumers see the full
  *  `State<>` type and never refer to this. */
@@ -13,7 +13,7 @@ export interface StateTemplate {
         destroy(): void;
     } & Record<string | symbol, unknown>;
 }
-export declare class SchmancyContext extends LitElement {
+export declare class SchmancyContext extends SchmancyElement {
     /** States to isolate under this subtree. Pass the same instances you import
      *  at module scope (e.g. `provides={[cart, menu]}`). Outside this element
      *  they continue to behave as module-scoped globals; descendants of this

package/dist/active-host-BP0zy_Y9.js

@@ -1,63 +0,0 @@
-function e(e, t, n, r) {
-	var i, a = arguments.length, o = a < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r;
-	if (typeof Reflect == "object" && typeof Reflect.decorate == "function") o = Reflect.decorate(e, t, n, r);
-	else for (var s = e.length - 1; s >= 0; s--) (i = e[s]) && (o = (a < 3 ? i(o) : a > 3 ? i(t, n, o) : i(t, n)) || o);
-	return a > 3 && o && Object.defineProperty(t, n, o), o;
-}
-var t = Symbol.for("schmancy.state.activeHost.stack"), n = globalThis;
-n[t] ??= { stack: [void 0] };
-var r = n[t].stack;
-if (typeof Promise < "u" && !("t" in Promise.prototype)) {
-	Object.defineProperty(Promise.prototype, "t", {
-		value: !0,
-		configurable: !1,
-		enumerable: !1,
-		writable: !1
-	});
-	let e = Promise.prototype.then;
-	Promise.prototype.then = function(t, n) {
-		let i = r[r.length - 1], a = t && ((e) => {
-			r.push(i);
-			try {
-				return t(e);
-			} finally {
-				r.pop();
-			}
-		}), o = n && ((e) => {
-			r.push(i);
-			try {
-				return n(e);
-			} finally {
-				r.pop();
-			}
-		});
-		return e.call(this, a, o);
-	};
-}
-var i = {
-	run(e, t) {
-		r.push(e);
-		try {
-			return t();
-		} finally {
-			r.pop();
-		}
-	},
-	get: () => r[r.length - 1]
-}, a = Symbol.for("schmancy.state.activeHost.eventHost"), o = globalThis[a] ??= {
-	host: void 0,
-	scheduled: !1
-};
-function s(e) {
-	o.host = e, o.scheduled || (o.scheduled = !0, queueMicrotask(() => {
-		o.scheduled = !1, o.host = void 0;
-	}));
-}
-function c() {
-	let e = i.get();
-	return e === void 0 ? o.host === void 0 ? typeof document < "u" && document.activeElement instanceof HTMLElement ? document.activeElement : void 0 : o.host : e;
-}
-function l(e) {
-	return Symbol.for(`schmancy.state:${e}`);
-}
-export { e as a, l as i, s as n, c as r, i as t };

package/dist/active-host-BP0zy_Y9.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"active-host-BP0zy_Y9.js","names":[],"sources":["../src/state/active-host.ts"],"sourcesContent":["// `_`-prefixed identifiers below are an intentional naming convention for\n// module-private infrastructure. `_activeHost` is exported only so the\n// $LitElement mixin can wrap render/lifecycle in `_activeHost.run`; the\n// underscore signals \"not part of the public state API.\"\n/* oxlint-disable no-underscore-dangle */\n\n// Active-host tracker for context-aware state resolution.\n//\n// Polyfills the TC39 `AsyncContext.Variable` propagation primitive using a\n// stack + a one-time `Promise.prototype.then` patch. The stack value carries\n// across `await`, `queueMicrotask`, RxJS subscription callbacks, and any\n// other code path that ultimately routes through `Promise.then`. This is the\n// same capture-and-restore technique zone.js, async-hooks, and the various\n// AsyncContext userland polyfills use.\n//\n// Why we own this:\n//   - The TC39 proposal is at stage 2; no official polyfill ships from TC39.\n//   - The `async-context@1.0.0` package on npm is unrelated (a 2014 Node\n//     callback helper), and the available userland polyfills either depend\n//     on zone.js (~50 KB) or are Node-only / hobby quality.\n//   - The patch surface is ~30 lines, idempotent, preserves Promise\n//     semantics (delegates to the original `then`, so `Symbol.species` and\n//     subclassing work unchanged), and decommissions cleanly the day a real\n//     polyfill or native AsyncContext lands (drop the file, swap the\n//     `_activeHost` export for the standard primitive).\n//\n// Known limitation — native await on a native Promise: V8's await\n// optimization (since 7.x) skips the spec-prescribed\n// `Promise.resolve(x).then(continuation)` step, so userland `then`\n// patches don't intercept the resumption. Class methods that mutate\n// state across an `await` boundary will fall back to the\n// module-scoped global, not the active-host's isolated copy. To\n// preserve the host across awaits, either keep the mutation in the\n// synchronous prelude before the first `await`, or explicitly chain\n// with `.then()` (which still routes through the patched method).\n// A real fix requires either a build-time async-function transform\n// or native AsyncContext.Variable in the runtime.\n//\n// resolveActiveHost() fallback chain:\n//   1. Stack value set by `_activeHost.run(host, fn)` — covers render(),\n//      Lit lifecycle methods, and class-method handlers (all wrapped by\n//      SchmancyElement's prototype-chain wrap).\n//   2. The closest `<schmancy-context>` whose subtree currently has an\n//      in-flight DOM event. The element installs capture-phase listeners\n//      that publish itself as the event-host while the synchronous\n//      handler chain runs; the slot clears via microtask. Covers\n//      template-bound inline arrow handlers attached to descendants.\n//   3. document.activeElement — keyboard handlers in focus.\n//   4. undefined → caller falls back to the module-scoped global instance.\n\n// Singleton across any number of schmancy module copies (source + dist, ESM\n// + CJS, hoisted vs. nested node_modules) via the runtime-global symbol\n// registry. The first copy to load creates the slot; later copies reuse it.\n// Without this, two stacks → mixins push to one, state reads from the other,\n// and active-host context is lost across the boundary.\nconst STACK_KEY = Symbol.for('schmancy.state.activeHost.stack')\ntype StackSlot = { stack: Array<HTMLElement | undefined> }\nconst _g = globalThis as { [STACK_KEY]?: StackSlot }\n_g[STACK_KEY] ??= { stack: [undefined] }\nconst _stack = _g[STACK_KEY].stack\n\n// One-time Promise.prototype.then patch at module init. Each .then() call\n// captures the stack head at chain time; firing the callback restores that\n// captured value for the duration of the callback. The guard property\n// prevents double-patching across HMR / duplicate module loads.\ndeclare global {\n\tinterface Promise<T> {\n\t\t// Marker symbol so we can detect (and skip) re-patching.\n\t\treadonly __schmancyActiveHostPatched?: true\n\t}\n}\n\n// Patching Promise.prototype is the entire mechanism this module exists to\n// provide — the lint rules below intentionally do not apply.\n/* oxlint-disable no-extend-native, unicorn/no-thenable */\nif (typeof Promise !== 'undefined' && !('__schmancyActiveHostPatched' in Promise.prototype)) {\n\tObject.defineProperty(Promise.prototype, '__schmancyActiveHostPatched', {\n\t\tvalue: true,\n\t\tconfigurable: false,\n\t\tenumerable: false,\n\t\twritable: false,\n\t})\n\tconst _origThen = Promise.prototype.then\n\t// Replace with our wrapper. We delegate to the original `then` via\n\t// `_origThen.call(this, …)` so Promise subclassing / Symbol.species behave\n\t// exactly as before — the only added work is the stack push/pop around\n\t// each user callback.\n\tPromise.prototype.then = function schmancyThen<T, R1, R2>(\n\t\tthis: Promise<T>,\n\t\tonfulfilled?: ((value: T) => R1 | PromiseLike<R1>) | null,\n\t\tonrejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null,\n\t): Promise<R1 | R2> {\n\t\tconst captured = _stack[_stack.length - 1]\n\t\tconst wrapFulfilled = onfulfilled\n\t\t\t? (v: T): R1 | PromiseLike<R1> => {\n\t\t\t\t\t_stack.push(captured)\n\t\t\t\t\ttry {\n\t\t\t\t\t\treturn onfulfilled(v)\n\t\t\t\t\t} finally {\n\t\t\t\t\t\t_stack.pop()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t: onfulfilled\n\t\tconst wrapRejected = onrejected\n\t\t\t? (r: unknown): R2 | PromiseLike<R2> => {\n\t\t\t\t\t_stack.push(captured)\n\t\t\t\t\ttry {\n\t\t\t\t\t\treturn onrejected(r)\n\t\t\t\t\t} finally {\n\t\t\t\t\t\t_stack.pop()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t: onrejected\n\t\treturn _origThen.call(this, wrapFulfilled, wrapRejected) as Promise<R1 | R2>\n\t}\n}\n/* oxlint-enable no-extend-native, unicorn/no-thenable */\n\nexport const _activeHost = {\n\t/** Run `fn` with `host` as the active host for the duration of `fn` and\n\t *  any awaits / microtasks / Promise chains that descend from it. */\n\trun<R>(host: HTMLElement | undefined, fn: () => R): R {\n\t\t_stack.push(host)\n\t\ttry {\n\t\t\treturn fn()\n\t\t} finally {\n\t\t\t_stack.pop()\n\t\t}\n\t},\n\t/** The current active host, or undefined if no `run()` is on the stack. */\n\tget(): HTMLElement | undefined {\n\t\treturn _stack[_stack.length - 1]\n\t},\n}\n\n// Tier 2 of the resolveActiveHost() fallback chain. A `<schmancy-context>`\n// publishes itself here from a capture-phase event listener attached to\n// itself; the slot clears in the next microtask, after the synchronous\n// event-handler chain has run. `window.event` is unreliable across both\n// engines and time (it can outlive its event — a stale `message` event\n// from postMessage can leak BODY for arbitrary later resolution calls), so\n// we own this slot rather than read the legacy global.\n//\n// Singleton across module copies for the same reason as `_stack` above.\nconst EVENT_HOST_KEY = Symbol.for('schmancy.state.activeHost.eventHost')\ntype EventHostSlot = { host: HTMLElement | undefined; scheduled: boolean }\nconst _eventHostSlot: EventHostSlot =\n\t((globalThis as { [EVENT_HOST_KEY]?: EventHostSlot })[EVENT_HOST_KEY] ??= {\n\t\thost: undefined,\n\t\tscheduled: false,\n\t})\n\n/** Publish `host` as the active event-host. The slot self-clears at the\n *  end of the current microtask checkpoint — long enough for the entire\n *  synchronous event-handler chain to read it, short enough that no\n *  later, unrelated microtask sees a stale value. */\nexport function _publishEventHost(host: HTMLElement): void {\n\t_eventHostSlot.host = host\n\tif (_eventHostSlot.scheduled) return\n\t_eventHostSlot.scheduled = true\n\tqueueMicrotask(() => {\n\t\t_eventHostSlot.scheduled = false\n\t\t_eventHostSlot.host = undefined\n\t})\n}\n\nexport function resolveActiveHost(): HTMLElement | undefined {\n\t// 1. Stack (set by _activeHost.run).\n\tconst fromStack = _activeHost.get()\n\tif (fromStack !== undefined) return fromStack\n\n\t// 2. Closest <schmancy-context> with an in-flight event in its subtree.\n\tif (_eventHostSlot.host !== undefined) return _eventHostSlot.host\n\n\t// 3. document.activeElement — keyboard / focus handlers.\n\tif (typeof document !== 'undefined' && document.activeElement instanceof HTMLElement) {\n\t\treturn document.activeElement\n\t}\n\n\t// 4. undefined — caller falls back to module-scoped.\n\treturn undefined\n}\n\n/** Stable context key for a state namespace. `Symbol.for(...)` so the same\n *  namespace string yields the same symbol across module boundaries — the\n *  ContextProvider on `<schmancy-context>` and the ContextRequestEvent\n *  dispatched by a state read must agree on identity. */\nexport function stateContextKey(namespace: string): symbol {\n\treturn Symbol.for(`schmancy.state:${namespace}`)\n}\n"],"mappings":";;;;;;AAuDA,IAAM,IAAY,OAAO,IAAI,kCAAA,EAEvB,IAAK;AACX,EAAG,OAAe,EAAE,OAAO,CAAA,KAAC,EAAA,EAAA;AAC5B,IAAM,IAAS,EAAG,GAAW;AAgB7B,IAAuB,OAAZ,UAAY,OAAZ,EAA6B,OAAiC,QAAQ,YAAY;CAC5F,OAAO,eAAe,QAAQ,WAAW,KAA+B;EACvE,OAAA,CAAO;EACP,cAAA,CAAc;EACd,YAAA,CAAY;EACZ,UAAA,CAAU;EAAA,CAAA;CAEX,IAAM,IAAY,QAAQ,UAAU;CAKpC,QAAQ,UAAU,OAAO,SAExB,GACA,GAAA;EAEA,IAAM,IAAW,EAAO,EAAO,SAAS,IAClC,IAAgB,OAClB,MAAA;GACD,EAAO,KAAK,EAAA;GACZ,IAAA;IACC,OAAO,EAAY,EAAA;aAAA;IAEnB,EAAO,KAAA;;MAIL,IAAe,OACjB,MAAA;GACD,EAAO,KAAK,EAAA;GACZ,IAAA;IACC,OAAO,EAAW,EAAA;aAAA;IAElB,EAAO,KAAA;;;EAIX,OAAO,EAAU,KAAK,MAAM,GAAe,EAAA;;;AAK7C,IAAa,IAAc;CAG1B,IAAO,GAA+B,GAAA;EACrC,EAAO,KAAK,EAAA;EACZ,IAAA;GACC,OAAO,GAAA;YAAA;GAEP,EAAO,KAAA;;;CAIT,WACQ,EAAO,EAAO,SAAS;CAAA,EAa1B,IAAiB,OAAO,IAAI,sCAAA,EAE5B,IACJ,WAAqD,OAAoB;CACzE,MAAA,KAAM;CACN,WAAA,CAAW;CAAA;AAOb,SAAgB,EAAkB,GAAA;CACjC,EAAe,OAAO,GAClB,EAAe,cACnB,EAAe,YAAA,CAAY,GAC3B,qBAAA;EACC,EAAe,YAAA,CAAY,GAC3B,EAAe,OAAA,KAAO;GAAA;;AAIxB,SAAgB,IAAA;CAEf,IAAM,IAAY,EAAY,KAAA;CAC9B,OAAI,MAAJ,KAAkB,IAGd,EAAe,SAHiB,KAGR,IAGJ,OAAb,WAAa,OAAe,SAAS,yBAAyB,cACjE,SAAS,gBAAA,KADjB,IAH8C,EAAe,OAHzB;;AAkBrC,SAAgB,EAAgB,GAAA;CAC/B,OAAO,OAAO,IAAI,kBAAkB,IAAA;;AAAA,SAAA,KAAA,GAAA,KAAA,GAAA,KAAA,GAAA,QAAA,KAAA"}

package/dist/active-host-jH3iloCR.cjs

@@ -1 +0,0 @@
-function e(e,t,n,r){var i,a=arguments.length,o=a<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)o=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(i=e[s])&&(o=(a<3?i(o):a>3?i(t,n,o):i(t,n))||o);return a>3&&o&&Object.defineProperty(t,n,o),o}var t=Symbol.for(`schmancy.state.activeHost.stack`),n=globalThis;n[t]??={stack:[void 0]};var r=n[t].stack;if(typeof Promise<`u`&&!(`o`in Promise.prototype)){Object.defineProperty(Promise.prototype,`o`,{value:!0,configurable:!1,enumerable:!1,writable:!1});let e=Promise.prototype.then;Promise.prototype.then=function(t,n){let i=r[r.length-1],a=t&&(e=>{r.push(i);try{return t(e)}finally{r.pop()}}),o=n&&(e=>{r.push(i);try{return n(e)}finally{r.pop()}});return e.call(this,a,o)}}var i={run(e,t){r.push(e);try{return t()}finally{r.pop()}},get:()=>r[r.length-1]},a=Symbol.for(`schmancy.state.activeHost.eventHost`),o=globalThis[a]??={host:void 0,scheduled:!1};function s(e){o.host=e,o.scheduled||(o.scheduled=!0,queueMicrotask(()=>{o.scheduled=!1,o.host=void 0}))}function c(){let e=i.get();return e===void 0?o.host===void 0?typeof document<`u`&&document.activeElement instanceof HTMLElement?document.activeElement:void 0:o.host:e}function l(e){return Symbol.for(`schmancy.state:${e}`)}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});

package/dist/active-host-jH3iloCR.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"active-host-jH3iloCR.cjs","names":[],"sources":["../src/state/active-host.ts"],"sourcesContent":["// `_`-prefixed identifiers below are an intentional naming convention for\n// module-private infrastructure. `_activeHost` is exported only so the\n// $LitElement mixin can wrap render/lifecycle in `_activeHost.run`; the\n// underscore signals \"not part of the public state API.\"\n/* oxlint-disable no-underscore-dangle */\n\n// Active-host tracker for context-aware state resolution.\n//\n// Polyfills the TC39 `AsyncContext.Variable` propagation primitive using a\n// stack + a one-time `Promise.prototype.then` patch. The stack value carries\n// across `await`, `queueMicrotask`, RxJS subscription callbacks, and any\n// other code path that ultimately routes through `Promise.then`. This is the\n// same capture-and-restore technique zone.js, async-hooks, and the various\n// AsyncContext userland polyfills use.\n//\n// Why we own this:\n//   - The TC39 proposal is at stage 2; no official polyfill ships from TC39.\n//   - The `async-context@1.0.0` package on npm is unrelated (a 2014 Node\n//     callback helper), and the available userland polyfills either depend\n//     on zone.js (~50 KB) or are Node-only / hobby quality.\n//   - The patch surface is ~30 lines, idempotent, preserves Promise\n//     semantics (delegates to the original `then`, so `Symbol.species` and\n//     subclassing work unchanged), and decommissions cleanly the day a real\n//     polyfill or native AsyncContext lands (drop the file, swap the\n//     `_activeHost` export for the standard primitive).\n//\n// Known limitation — native await on a native Promise: V8's await\n// optimization (since 7.x) skips the spec-prescribed\n// `Promise.resolve(x).then(continuation)` step, so userland `then`\n// patches don't intercept the resumption. Class methods that mutate\n// state across an `await` boundary will fall back to the\n// module-scoped global, not the active-host's isolated copy. To\n// preserve the host across awaits, either keep the mutation in the\n// synchronous prelude before the first `await`, or explicitly chain\n// with `.then()` (which still routes through the patched method).\n// A real fix requires either a build-time async-function transform\n// or native AsyncContext.Variable in the runtime.\n//\n// resolveActiveHost() fallback chain:\n//   1. Stack value set by `_activeHost.run(host, fn)` — covers render(),\n//      Lit lifecycle methods, and class-method handlers (all wrapped by\n//      SchmancyElement's prototype-chain wrap).\n//   2. The closest `<schmancy-context>` whose subtree currently has an\n//      in-flight DOM event. The element installs capture-phase listeners\n//      that publish itself as the event-host while the synchronous\n//      handler chain runs; the slot clears via microtask. Covers\n//      template-bound inline arrow handlers attached to descendants.\n//   3. document.activeElement — keyboard handlers in focus.\n//   4. undefined → caller falls back to the module-scoped global instance.\n\n// Singleton across any number of schmancy module copies (source + dist, ESM\n// + CJS, hoisted vs. nested node_modules) via the runtime-global symbol\n// registry. The first copy to load creates the slot; later copies reuse it.\n// Without this, two stacks → mixins push to one, state reads from the other,\n// and active-host context is lost across the boundary.\nconst STACK_KEY = Symbol.for('schmancy.state.activeHost.stack')\ntype StackSlot = { stack: Array<HTMLElement | undefined> }\nconst _g = globalThis as { [STACK_KEY]?: StackSlot }\n_g[STACK_KEY] ??= { stack: [undefined] }\nconst _stack = _g[STACK_KEY].stack\n\n// One-time Promise.prototype.then patch at module init. Each .then() call\n// captures the stack head at chain time; firing the callback restores that\n// captured value for the duration of the callback. The guard property\n// prevents double-patching across HMR / duplicate module loads.\ndeclare global {\n\tinterface Promise<T> {\n\t\t// Marker symbol so we can detect (and skip) re-patching.\n\t\treadonly __schmancyActiveHostPatched?: true\n\t}\n}\n\n// Patching Promise.prototype is the entire mechanism this module exists to\n// provide — the lint rules below intentionally do not apply.\n/* oxlint-disable no-extend-native, unicorn/no-thenable */\nif (typeof Promise !== 'undefined' && !('__schmancyActiveHostPatched' in Promise.prototype)) {\n\tObject.defineProperty(Promise.prototype, '__schmancyActiveHostPatched', {\n\t\tvalue: true,\n\t\tconfigurable: false,\n\t\tenumerable: false,\n\t\twritable: false,\n\t})\n\tconst _origThen = Promise.prototype.then\n\t// Replace with our wrapper. We delegate to the original `then` via\n\t// `_origThen.call(this, …)` so Promise subclassing / Symbol.species behave\n\t// exactly as before — the only added work is the stack push/pop around\n\t// each user callback.\n\tPromise.prototype.then = function schmancyThen<T, R1, R2>(\n\t\tthis: Promise<T>,\n\t\tonfulfilled?: ((value: T) => R1 | PromiseLike<R1>) | null,\n\t\tonrejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null,\n\t): Promise<R1 | R2> {\n\t\tconst captured = _stack[_stack.length - 1]\n\t\tconst wrapFulfilled = onfulfilled\n\t\t\t? (v: T): R1 | PromiseLike<R1> => {\n\t\t\t\t\t_stack.push(captured)\n\t\t\t\t\ttry {\n\t\t\t\t\t\treturn onfulfilled(v)\n\t\t\t\t\t} finally {\n\t\t\t\t\t\t_stack.pop()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t: onfulfilled\n\t\tconst wrapRejected = onrejected\n\t\t\t? (r: unknown): R2 | PromiseLike<R2> => {\n\t\t\t\t\t_stack.push(captured)\n\t\t\t\t\ttry {\n\t\t\t\t\t\treturn onrejected(r)\n\t\t\t\t\t} finally {\n\t\t\t\t\t\t_stack.pop()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t: onrejected\n\t\treturn _origThen.call(this, wrapFulfilled, wrapRejected) as Promise<R1 | R2>\n\t}\n}\n/* oxlint-enable no-extend-native, unicorn/no-thenable */\n\nexport const _activeHost = {\n\t/** Run `fn` with `host` as the active host for the duration of `fn` and\n\t *  any awaits / microtasks / Promise chains that descend from it. */\n\trun<R>(host: HTMLElement | undefined, fn: () => R): R {\n\t\t_stack.push(host)\n\t\ttry {\n\t\t\treturn fn()\n\t\t} finally {\n\t\t\t_stack.pop()\n\t\t}\n\t},\n\t/** The current active host, or undefined if no `run()` is on the stack. */\n\tget(): HTMLElement | undefined {\n\t\treturn _stack[_stack.length - 1]\n\t},\n}\n\n// Tier 2 of the resolveActiveHost() fallback chain. A `<schmancy-context>`\n// publishes itself here from a capture-phase event listener attached to\n// itself; the slot clears in the next microtask, after the synchronous\n// event-handler chain has run. `window.event` is unreliable across both\n// engines and time (it can outlive its event — a stale `message` event\n// from postMessage can leak BODY for arbitrary later resolution calls), so\n// we own this slot rather than read the legacy global.\n//\n// Singleton across module copies for the same reason as `_stack` above.\nconst EVENT_HOST_KEY = Symbol.for('schmancy.state.activeHost.eventHost')\ntype EventHostSlot = { host: HTMLElement | undefined; scheduled: boolean }\nconst _eventHostSlot: EventHostSlot =\n\t((globalThis as { [EVENT_HOST_KEY]?: EventHostSlot })[EVENT_HOST_KEY] ??= {\n\t\thost: undefined,\n\t\tscheduled: false,\n\t})\n\n/** Publish `host` as the active event-host. The slot self-clears at the\n *  end of the current microtask checkpoint — long enough for the entire\n *  synchronous event-handler chain to read it, short enough that no\n *  later, unrelated microtask sees a stale value. */\nexport function _publishEventHost(host: HTMLElement): void {\n\t_eventHostSlot.host = host\n\tif (_eventHostSlot.scheduled) return\n\t_eventHostSlot.scheduled = true\n\tqueueMicrotask(() => {\n\t\t_eventHostSlot.scheduled = false\n\t\t_eventHostSlot.host = undefined\n\t})\n}\n\nexport function resolveActiveHost(): HTMLElement | undefined {\n\t// 1. Stack (set by _activeHost.run).\n\tconst fromStack = _activeHost.get()\n\tif (fromStack !== undefined) return fromStack\n\n\t// 2. Closest <schmancy-context> with an in-flight event in its subtree.\n\tif (_eventHostSlot.host !== undefined) return _eventHostSlot.host\n\n\t// 3. document.activeElement — keyboard / focus handlers.\n\tif (typeof document !== 'undefined' && document.activeElement instanceof HTMLElement) {\n\t\treturn document.activeElement\n\t}\n\n\t// 4. undefined — caller falls back to module-scoped.\n\treturn undefined\n}\n\n/** Stable context key for a state namespace. `Symbol.for(...)` so the same\n *  namespace string yields the same symbol across module boundaries — the\n *  ContextProvider on `<schmancy-context>` and the ContextRequestEvent\n *  dispatched by a state read must agree on identity. */\nexport function stateContextKey(namespace: string): symbol {\n\treturn Symbol.for(`schmancy.state:${namespace}`)\n}\n"],"mappings":"qUAuDA,IAAM,EAAY,OAAO,IAAI,kCAAA,CAEvB,EAAK,WACX,EAAG,KAAe,CAAE,MAAO,CAAA,IAAC,GAAA,CAAA,CAC5B,IAAM,EAAS,EAAG,GAAW,MAgB7B,GAAuB,OAAZ,QAAY,KAAZ,EAA6B,MAAiC,QAAQ,WAAY,CAC5F,OAAO,eAAe,QAAQ,UAAW,IAA+B,CACvE,MAAA,CAAO,EACP,aAAA,CAAc,EACd,WAAA,CAAY,EACZ,SAAA,CAAU,EAAA,CAAA,CAEX,IAAM,EAAY,QAAQ,UAAU,KAKpC,QAAQ,UAAU,KAAO,SAExB,EACA,EAAA,CAEA,IAAM,EAAW,EAAO,EAAO,OAAS,GAClC,EAAgB,IAClB,GAAA,CACD,EAAO,KAAK,EAAA,CACZ,GAAA,CACC,OAAO,EAAY,EAAA,QAAA,CAEnB,EAAO,KAAA,IAIL,EAAe,IACjB,GAAA,CACD,EAAO,KAAK,EAAA,CACZ,GAAA,CACC,OAAO,EAAW,EAAA,QAAA,CAElB,EAAO,KAAA,IAIX,OAAO,EAAU,KAAK,KAAM,EAAe,EAAA,EAK7C,IAAa,EAAc,CAG1B,IAAO,EAA+B,EAAA,CACrC,EAAO,KAAK,EAAA,CACZ,GAAA,CACC,OAAO,GAAA,QAAA,CAEP,EAAO,KAAA,GAIT,QACQ,EAAO,EAAO,OAAS,GAAA,CAa1B,EAAiB,OAAO,IAAI,sCAAA,CAE5B,EACJ,WAAqD,KAAoB,CACzE,KAAA,IAAM,GACN,UAAA,CAAW,EAAA,CAOb,SAAgB,EAAkB,EAAA,CACjC,EAAe,KAAO,EAClB,EAAe,YACnB,EAAe,UAAA,CAAY,EAC3B,mBAAA,CACC,EAAe,UAAA,CAAY,EAC3B,EAAe,KAAA,IAAO,IAAA,EAIxB,SAAgB,GAAA,CAEf,IAAM,EAAY,EAAY,KAAA,CAC9B,OAAI,IAAJ,IAAkB,GAGd,EAAe,OAHiB,IAGR,GAGJ,OAAb,SAAa,KAAe,SAAS,yBAAyB,YACjE,SAAS,cAAA,IADjB,GAH8C,EAAe,KAHzB,EAkBrC,SAAgB,EAAgB,EAAA,CAC/B,OAAO,OAAO,IAAI,kBAAkB,IAAA,CAAA,OAAA,eAAA,QAAA,IAAA,CAAA,WAAA,CAAA,EAAA,IAAA,UAAA,CAAA,OAAA,GAAA,CAAA,CAAA,OAAA,eAAA,QAAA,IAAA,CAAA,WAAA,CAAA,EAAA,IAAA,UAAA,CAAA,OAAA,GAAA,CAAA,CAAA,OAAA,eAAA,QAAA,IAAA,CAAA,WAAA,CAAA,EAAA,IAAA,UAAA,CAAA,OAAA,GAAA,CAAA,CAAA,OAAA,eAAA,QAAA,IAAA,CAAA,WAAA,CAAA,EAAA,IAAA,UAAA,CAAA,OAAA,GAAA,CAAA,CAAA,OAAA,eAAA,QAAA,IAAA,CAAA,WAAA,CAAA,EAAA,IAAA,UAAA,CAAA,OAAA,GAAA,CAAA"}