microtags 0.0.1 → 0.0.5

package/dist/index.js

@@ -1,5 +1,348 @@
-import { peek, untracked } from "./reactivity.js";
-import { define } from "./builders.js";
+import {
+  effect,
+  onContextAvailable,
+  peek,
+  resolveContextSignal,
+  signal,
+  untracked
+} from "./chunk-CCYWRJW6.js";
+import {
+  coerceBoolean,
+  coerceJson,
+  coerceNumber,
+  coerceString,
+  runCleanups
+} from "./chunk-E7ZGOHL3.js";
+import {
+  __name
+} from "./chunk-7QVYU63E.js";
+
+// src/setup-context.ts
+function makeSetupContext(host, props, refs, contexts, cleanups) {
+  return {
+    host,
+    props,
+    refs,
+    contexts,
+    peek,
+    on(target, type, handler, options) {
+      target.addEventListener(
+        type,
+        handler,
+        options
+      );
+      cleanups.push(() => {
+        target.removeEventListener(
+          type,
+          handler,
+          options
+        );
+      });
+    },
+    effect(fn) {
+      const dispose = effect(fn);
+      cleanups.push(dispose);
+    },
+    bind(source, control, opts) {
+      const input = control instanceof HTMLInputElement ? control : void 0;
+      let prop = "value";
+      let autoEvent = "change";
+      if (input?.type === "checkbox") {
+        prop = "checked";
+      } else if (input?.type === "number" || input?.type === "range") {
+        prop = "valueAsNumber";
+        autoEvent = "input";
+      } else if (input || control instanceof HTMLTextAreaElement) {
+        autoEvent = "input";
+      }
+      const boundProp = opts?.prop ?? prop;
+      const event = opts ? opts.event : autoEvent;
+      const el = control;
+      if (event) {
+        const handler = /* @__PURE__ */ __name(() => {
+          const writable = source;
+          writable(el[boundProp]);
+        }, "handler");
+        control.addEventListener(event, handler);
+        cleanups.push(() => {
+          control.removeEventListener(event, handler);
+        });
+      }
+      const dispose = effect(() => {
+        el[boundProp] = source();
+      });
+      cleanups.push(dispose);
+    },
+    onCleanup(fn) {
+      cleanups.push(fn);
+    },
+    consume(token) {
+      const sig = resolveContextSignal(host, token);
+      return sig ? sig() : void 0;
+    }
+  };
+}
+__name(makeSetupContext, "makeSetupContext");
+
+// src/factory.ts
+var HTMLElementBase = typeof HTMLElement !== "undefined" ? HTMLElement : class {
+};
+function collectRefs(host, defs) {
+  const result = {};
+  const missing = [];
+  for (const [key, def] of Object.entries(defs)) {
+    const sel = def.selector ?? `[data-ref="${key}"]`;
+    if (def._microtag === "ref:all") {
+      result[key] = Array.from(host.querySelectorAll(sel));
+    } else {
+      const el = host.querySelector(sel);
+      if (!el) {
+        missing.push(key);
+      } else {
+        result[key] = el;
+      }
+    }
+  }
+  if (missing.length > 0) {
+    throw new Error(
+      `${host.tagName}: missing refs: ${missing.join(", ")}`
+    );
+  }
+  return result;
+}
+__name(collectRefs, "collectRefs");
+function factory(config) {
+  const {
+    props: propDefs,
+    observedAttrNames,
+    setup,
+    refs: refDefs = {},
+    contexts: ctxDefs = {}
+  } = config;
+  class MicrotagElement extends HTMLElementBase {
+    static {
+      __name(this, "MicrotagElement");
+    }
+    static get observedAttributes() {
+      return observedAttrNames;
+    }
+    _props = {};
+    _cleanups = [];
+    constructor() {
+      super();
+      for (const [name, coercer] of Object.entries(propDefs)) {
+        this._props[name] = signal(coercer(null));
+      }
+    }
+    connectedCallback() {
+      this._cleanups = [];
+      for (const [name, coercer] of Object.entries(propDefs)) {
+        const attrVal = this.getAttribute(name);
+        if (attrVal !== null) {
+          this._props[name](coercer(attrVal));
+        }
+      }
+      const cleanups = this._cleanups;
+      const props = this._props;
+      const contexts = new Proxy({}, {
+        get: /* @__PURE__ */ __name((_target, key) => {
+          if (typeof key !== "string") return void 0;
+          const token = ctxDefs[key];
+          if (!token) return void 0;
+          const sig = resolveContextSignal(this, token);
+          return sig ? sig() : void 0;
+        }, "get"),
+        has: /* @__PURE__ */ __name((_target, key) => {
+          if (typeof key !== "string") return false;
+          return key in ctxDefs;
+        }, "has")
+      });
+      let setupRan = false;
+      const cancelCallbacks = [];
+      const tryRunSetup = /* @__PURE__ */ __name(() => {
+        if (setupRan) return;
+        for (const token of Object.values(ctxDefs)) {
+          if (!resolveContextSignal(this, token)) return;
+        }
+        setupRan = true;
+        for (const cancel of cancelCallbacks) cancel();
+        cancelCallbacks.length = 0;
+        const refs = collectRefs(this, refDefs);
+        const ctx = makeSetupContext(
+          this,
+          props,
+          refs,
+          contexts,
+          cleanups
+        );
+        setup(ctx);
+      }, "tryRunSetup");
+      const tryRunSetupIfConnected = /* @__PURE__ */ __name(() => {
+        if (!this.isConnected) return;
+        tryRunSetup();
+      }, "tryRunSetupIfConnected");
+      for (const token of Object.values(ctxDefs)) {
+        if (!resolveContextSignal(this, token)) {
+          const cancel = onContextAvailable(
+            token.id,
+            tryRunSetupIfConnected
+          );
+          cancelCallbacks.push(cancel);
+          cleanups.push(cancel);
+        }
+      }
+      tryRunSetup();
+    }
+    attributeChangedCallback(name, _old, next) {
+      const coercer = propDefs[name];
+      if (coercer !== void 0 && this._props[name] !== void 0) {
+        this._props[name](coercer(next));
+      }
+    }
+    disconnectedCallback() {
+      const fns = this._cleanups;
+      this._cleanups = [];
+      runCleanups(fns);
+    }
+  }
+  return MicrotagElement;
+}
+__name(factory, "factory");
+
+// src/builders.ts
+function isPropOnly(def) {
+  return typeof def === "object" && def !== null && "_microtag" in def && def._microtag === "prop";
+}
+__name(isPropOnly, "isPropOnly");
+function isStandardSchema(def) {
+  return typeof def === "object" && def !== null && "~standard" in def;
+}
+__name(isStandardSchema, "isStandardSchema");
+function normalizePropDef(name, def) {
+  if (isPropOnly(def)) {
+    return (_raw) => def.initial;
+  }
+  if (isStandardSchema(def)) {
+    const schema = def;
+    return (raw) => {
+      const result = schema["~standard"].validate(raw);
+      if (result instanceof Promise) {
+        throw new TypeError(
+          `withProps: async schemas are not supported (prop "${name}")`
+        );
+      }
+      if (result.issues) return void 0;
+      return result.value;
+    };
+  }
+  return def;
+}
+__name(normalizePropDef, "normalizePropDef");
+var propDSL = {
+  number: /* @__PURE__ */ __name(() => coerceNumber, "number"),
+  string: /* @__PURE__ */ __name(() => coerceString, "string"),
+  boolean: /* @__PURE__ */ __name(() => coerceBoolean, "boolean"),
+  json: /* @__PURE__ */ __name(() => coerceJson, "json"),
+  schema: /* @__PURE__ */ __name((v) => v, "schema"),
+  prop: /* @__PURE__ */ __name((initial) => ({ _microtag: "prop", initial }), "prop")
+};
+var refsDSL = {
+  one: /* @__PURE__ */ __name(((selector) => ({ _microtag: "ref:one", selector })), "one"),
+  all: /* @__PURE__ */ __name(((selector) => ({ _microtag: "ref:all", selector })), "all")
+};
+var contextDSL = {};
+var ComponentBuilder = class _ComponentBuilder {
+  constructor(tagName, coercers = {}, observed = [], refDefs = {}, ctxDefs = {}) {
+    this.tagName = tagName;
+    this._coercers = coercers;
+    this._observed = observed;
+    this._refDefs = refDefs;
+    this._ctxDefs = ctxDefs;
+  }
+  tagName;
+  static {
+    __name(this, "ComponentBuilder");
+  }
+  _coercers;
+  _observed;
+  _refDefs;
+  _ctxDefs;
+  /**
+   * The custom element tag name, e.g. 'my-counter'. Available at every
+   * point in the fluent chain since each builder method returns a new
+   * builder carrying the same tag name.
+   */
+  get TAG() {
+    return this.tagName;
+  }
+  withProps(fn) {
+    const defs = fn(propDSL);
+    const coercers = {};
+    const observed = [];
+    for (const [name, def] of Object.entries(defs)) {
+      coercers[name] = normalizePropDef(name, def);
+      if (!isPropOnly(def)) {
+        observed.push(name);
+      }
+    }
+    return new _ComponentBuilder(
+      this.tagName,
+      coercers,
+      observed,
+      this._refDefs,
+      this._ctxDefs
+    );
+  }
+  withRefs(fn) {
+    const defs = fn(refsDSL);
+    return new _ComponentBuilder(
+      this.tagName,
+      this._coercers,
+      this._observed,
+      defs,
+      this._ctxDefs
+    );
+  }
+  withContexts(fn) {
+    const defs = fn(contextDSL);
+    return new _ComponentBuilder(
+      this.tagName,
+      this._coercers,
+      this._observed,
+      this._refDefs,
+      defs
+    );
+  }
+  setup(fn) {
+    const El = factory({
+      props: this._coercers,
+      observedAttrNames: this._observed,
+      refs: this._refDefs,
+      contexts: this._ctxDefs,
+      setup: fn
+    });
+    Object.defineProperty(El, "TAG", {
+      value: this.tagName,
+      enumerable: true
+    });
+    const refNames = {};
+    for (const key of Object.keys(this._refDefs)) {
+      refNames[key] = key;
+    }
+    Object.defineProperty(El, "refs", {
+      value: Object.freeze(refNames),
+      enumerable: true
+    });
+    if (typeof customElements !== "undefined") {
+      customElements.define(this.tagName, El);
+    }
+    return El;
+  }
+};
+function define(tagName) {
+  return new ComponentBuilder(tagName);
+}
+__name(define, "define");
 export {
   define,
   peek,

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/index.ts"],
-  "sourcesContent": ["export { peek, untracked } from './reactivity.js'\nexport { define } from './builders.js'\n"],
-  "mappings": "AAAA,SAAS,MAAM,iBAAiB;AAChC,SAAS,cAAc;",
+  "sources": ["../src/setup-context.ts", "../src/factory.ts", "../src/builders.ts"],
+  "sourcesContent": ["import { effect, peek } from './reactivity.js'\nimport { resolveContextSignal } from './context.js'\nimport type {\n    SetupContext,\n    Cleanup,\n    Signal,\n    PropsSignals,\n    PropDef,\n    ContextToken,\n} from './types.js'\n\n/**\n * Build the ctx object passed to a component's setup() callback.\n * The cleanups array is mutated in place so factory.ts can drain it\n * on disconnect without copying.\n */\nexport function makeSetupContext<\n    Props extends Record<string, PropDef> = Record<string, PropDef>,\n> (\n    host:HTMLElement,\n    props:PropsSignals<Props>,\n    refs:Record<string, Element | Element[]>,\n    contexts:Record<string, unknown>,\n    cleanups:Cleanup[]\n):SetupContext<Props, any, any> {\n    return {\n        host,\n        props,\n        refs,\n        contexts,\n\n        peek,\n\n        on (target, type, handler, options?) {\n            target.addEventListener(\n                type as string,\n                handler as EventListener,\n                options\n            )\n            cleanups.push(() => {\n                target.removeEventListener(\n                    type as string,\n                    handler as EventListener,\n                    options\n                )\n            })\n        },\n\n        effect (fn) {\n            const dispose = effect(fn)\n            cleanups.push(dispose)\n        },\n\n        bind (source, control, opts) {\n            const input = control instanceof HTMLInputElement ?\n                control :\n                undefined\n            let prop = 'value'\n            let autoEvent = 'change'\n            if (input?.type === 'checkbox') {\n                prop = 'checked'\n            } else if (input?.type === 'number' ||\n                input?.type === 'range') {\n                prop = 'valueAsNumber'\n                autoEvent = 'input'\n            } else if (input || control instanceof HTMLTextAreaElement) {\n                autoEvent = 'input'\n            }\n\n            const boundProp = opts?.prop ?? prop\n            const event = opts ? opts.event : autoEvent\n            const el = control as unknown as Record<string, unknown>\n\n            if (event) {\n                const handler = () => {\n                    const writable = source as Signal<unknown>\n                    writable(el[boundProp])\n                }\n                control.addEventListener(event, handler)\n                cleanups.push(() => {\n                    control.removeEventListener(event, handler)\n                })\n            }\n\n            const dispose = effect(() => {\n                el[boundProp] = source()\n            })\n            cleanups.push(dispose)\n        },\n\n        onCleanup (fn) {\n            cleanups.push(fn)\n        },\n\n        consume<T> (token:ContextToken<T>):T | undefined {\n            const sig = resolveContextSignal(host, token)\n            return sig ? sig() : undefined\n        },\n    }\n}\n", "import { signal } from './reactivity.js'\nimport { runCleanups } from './util.js'\nimport { makeSetupContext } from './setup-context.js'\nimport {\n    resolveContextSignal,\n    onContextAvailable,\n} from './context.js'\nimport type {\n    PropsSignals,\n    Signal,\n    SetupContext,\n    Cleanup,\n    Coercer,\n    ContextToken,\n    RefDef,\n} from './types.js'\n\n/**\n * Map of prop name to coercer function.\n * The factory accepts coercers exclusively; Standard Schema support is\n * layered on top in the withProps builder (US-005).\n */\nexport type FactoryProps = Record<string, Coercer<unknown>>\n\n/**\n * The class to extend for custom elements. In the browser this is the\n * real HTMLElement; in Node (e.g. reading `.TAG` for SSR) it falls back\n * to an empty stub so the class can be defined without a DOM. The stub\n * is never instantiated or registered outside the browser.\n */\nconst HTMLElementBase = typeof HTMLElement !== 'undefined' ?\n    HTMLElement :\n    (class {} as unknown as typeof HTMLElement)\n\n/** Configuration passed to factory(). */\nexport interface FactoryConfig<Props extends FactoryProps = FactoryProps> {\n    /** Coercer for each observed attribute / prop. */\n    props:Props\n    /** Attribute names to pass to observedAttributes. */\n    observedAttrNames:string[]\n    /** Ref definitions keyed by name. */\n    refs?:Record<string, RefDef>\n    /** Context tokens keyed by name. */\n    contexts?:Record<string, ContextToken<unknown>>\n    /** Setup callback receiving the component context. */\n    setup:(ctx:SetupContext<Props, any, any>) => void\n}\n\n/**\n * Collect resolved DOM refs from within a host element.\n * Throws if any single-ref element is missing.\n */\nfunction collectRefs (\n    host:HTMLElement,\n    defs:Record<string, RefDef>\n):Record<string, Element | Element[]> {\n    const result:Record<string, Element | Element[]> = {}\n    const missing:string[] = []\n    for (const [key, def] of Object.entries(defs)) {\n        const sel = def.selector ?? `[data-ref=\"${key}\"]`\n        if (def._microtag === 'ref:all') {\n            result[key] = Array.from(host.querySelectorAll(sel))\n        } else {\n            const el = host.querySelector(sel)\n            if (!el) {\n                missing.push(key)\n            } else {\n                result[key] = el\n            }\n        }\n    }\n    if (missing.length > 0) {\n        throw new Error(\n            `${host.tagName}: missing refs: ${missing.join(', ')}`\n        )\n    }\n    return result\n}\n\n/**\n * Create an HTMLElement subclass with the microtags lifecycle.\n * The returned class has no Shadow DOM, tracks its own prop signals,\n * and runs setup() on connect / cleanups on disconnect.\n */\nexport function factory<Props extends FactoryProps = FactoryProps> (\n    config:FactoryConfig<Props>\n):typeof HTMLElement {\n    const {\n        props: propDefs,\n        observedAttrNames,\n        setup,\n        refs: refDefs = {},\n        contexts: ctxDefs = {},\n    } = config\n\n    class MicrotagElement extends HTMLElementBase {\n        static get observedAttributes () { return observedAttrNames }\n\n        _props:Record<string, Signal<unknown>> = {}\n        _cleanups:Cleanup[] = []\n\n        constructor () {\n            super()\n            for (const [name, coercer] of Object.entries(propDefs)) {\n                this._props[name] = signal(coercer(null))\n            }\n        }\n\n        connectedCallback () {\n            // Start a fresh cleanup scope for each connection cycle.\n            this._cleanups = []\n\n            // Hydrate prop signals from attributes; preserve any\n            // programmatically-set value when the attribute is absent.\n            for (const [name, coercer] of Object.entries(propDefs)) {\n                const attrVal = this.getAttribute(name)\n                if (attrVal !== null) {\n                    (this._props[name] as Signal<unknown>)(coercer(attrVal))\n                }\n            }\n\n            const cleanups = this._cleanups\n            const props = this._props as PropsSignals<Props>\n\n            // Reactive Proxy: reading a key inside a ctx.effect creates\n            // a subscription to the provider's alien-signals signal.\n            const contexts = new Proxy({} as Record<string, unknown>, {\n                get: (_target, key) => {\n                    if (typeof key !== 'string') return undefined\n                    const token = ctxDefs[key]\n                    if (!token) return undefined\n                    const sig = resolveContextSignal(this, token)\n                    return sig ? sig() : undefined\n                },\n                has: (_target, key) => {\n                    if (typeof key !== 'string') return false\n                    return key in ctxDefs\n                },\n            })\n\n            let setupRan = false\n            // Tracks pending-context cancel functions so they are\n            // removed from the global registry when setup runs or\n            // when the element disconnects.\n            const cancelCallbacks:(() => void)[] = []\n\n            const tryRunSetup = ():void => {\n                if (setupRan) return\n                for (const token of Object.values(ctxDefs)) {\n                    if (!resolveContextSignal(this, token)) return\n                }\n                setupRan = true\n                for (const cancel of cancelCallbacks) cancel()\n                cancelCallbacks.length = 0\n\n                const refs = collectRefs(this, refDefs)\n                const ctx = makeSetupContext(\n                    this, props, refs, contexts, cleanups\n                )\n                setup(ctx)\n            }\n\n            // Deferred variant: skip if element was disconnected before\n            // the context became available.\n            const tryRunSetupIfConnected = ():void => {\n                if (!this.isConnected) return\n                tryRunSetup()\n            }\n\n            // Register pending listeners for any missing contexts.\n            for (const token of Object.values(ctxDefs)) {\n                if (!resolveContextSignal(this, token)) {\n                    const cancel = onContextAvailable(\n                        token.id, tryRunSetupIfConnected\n                    )\n                    cancelCallbacks.push(cancel)\n                    // Also cancel on disconnect so we don't leak.\n                    cleanups.push(cancel)\n                }\n            }\n\n            tryRunSetup()\n        }\n\n        attributeChangedCallback (\n            name:string,\n            _old:string | null,\n            next:string | null\n        ) {\n            const coercer = propDefs[name]\n            if (coercer !== undefined && this._props[name] !== undefined) {\n                (this._props[name] as Signal<unknown>)(coercer(next))\n            }\n        }\n\n        disconnectedCallback () {\n            // Snapshot and clear BEFORE running so re-entrant calls are safe\n            // and the array is always empty after this returns (or throws).\n            const fns = this._cleanups\n            this._cleanups = []\n            runCleanups(fns)\n        }\n    }\n\n    return MicrotagElement\n}\n", "import type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type {\n    PropDef,\n    PropertyOnlyProp,\n    SetupContext,\n    Coercer,\n    RefDef,\n    SingleRefDef,\n    MultipleRefDef,\n    RefsMap,\n    ContextToken,\n    ContextsMap,\n} from './types.js'\nimport {\n    coerceNumber,\n    coerceString,\n    coerceBoolean,\n    coerceJson,\n} from './util.js'\nimport { factory } from './factory.js'\n\nfunction isPropOnly (def:unknown):def is PropertyOnlyProp<unknown> {\n    return (\n        typeof def === 'object' &&\n        def !== null &&\n        '_microtag' in def &&\n        (def as { _microtag: unknown })._microtag === 'prop'\n    )\n}\n\nfunction isStandardSchema (def:unknown):def is StandardSchemaV1 {\n    return (\n        typeof def === 'object' &&\n        def !== null &&\n        '~standard' in def\n    )\n}\n\nfunction normalizePropDef (\n    name:string,\n    def:PropDef<unknown>\n):Coercer<unknown> {\n    if (isPropOnly(def)) {\n        return (_raw:string | null) => def.initial\n    }\n    if (isStandardSchema(def)) {\n        const schema = def as StandardSchemaV1\n        return (raw:string | null):unknown => {\n            const result = schema['~standard'].validate(raw)\n            if (result instanceof Promise) {\n                throw new TypeError(\n                    `withProps: async schemas are not supported (prop \"${name}\")`\n                )\n            }\n            if (result.issues) return undefined\n            return result.value\n        }\n    }\n    return def as Coercer<unknown>\n}\n\n/** The DSL object passed to the withProps callback. */\nexport type PropDSL = {\n    number():Coercer<number>\n    string():Coercer<string>\n    boolean():Coercer<boolean>\n    json<T>():Coercer<T | undefined>\n    schema<T>(validator:StandardSchemaV1<unknown, T>):StandardSchemaV1<unknown, T>\n    prop<T>(initial:T):PropertyOnlyProp<T>\n}\n\nexport const propDSL:PropDSL = {\n    number: () => coerceNumber,\n    string: () => coerceString,\n    boolean: () => coerceBoolean,\n    json: <T>() => coerceJson as Coercer<T | undefined>,\n    schema: <T>(v:StandardSchemaV1<unknown, T>) => v,\n    prop: <T>(initial:T):PropertyOnlyProp<T> => (\n        { _microtag: 'prop', initial }\n    ),\n}\n\n/**\n * DSL object passed to the withRefs callback.\n * Call `r.one()` for a single element or `r.all()` for multiple. Pass a\n * CSS selector to query by it, or omit it to match `[data-ref=\"<key>\"]`.\n *\n * Element typing:\n * - `r.one()` defaults to `HTMLElement`.\n * - `r.one<T>()` sets the type and keeps the `[data-ref]` selector.\n * - `r.one('button')` infers the type from the tag AND queries by that\n *   tag, exactly like `document.querySelector('button')`.\n */\nexport type RefsDSL = {\n    one<K extends keyof HTMLElementTagNameMap>(\n        selector:K\n    ):SingleRefDef<HTMLElementTagNameMap[K]>\n    one<T extends HTMLElement = HTMLElement>(selector?:string):SingleRefDef<T>\n\n    all<K extends keyof HTMLElementTagNameMap>(\n        selector:K\n    ):MultipleRefDef<HTMLElementTagNameMap[K]>\n    all<T extends HTMLElement = HTMLElement>(selector?:string):MultipleRefDef<T>\n}\n\nexport const refsDSL:RefsDSL = {\n    one: ((selector?:string):SingleRefDef => (\n        { _microtag: 'ref:one', selector }\n    )) as RefsDSL['one'],\n    all: ((selector?:string):MultipleRefDef => (\n        { _microtag: 'ref:all', selector }\n    )) as RefsDSL['all'],\n}\n\n/**\n * DSL object passed to the withContexts callback.\n * Currently a no-op placeholder; the user references imported\n * context tokens directly in the returned record.\n */\nexport type ContextDSL = Record<never, never>\nconst contextDSL:ContextDSL = {}\n\n/**\n * Maps each declared ref key to its own name as a string literal. Exposed\n * as the static `refs` on a registered element so server-rendered templates\n * can fill in `data-ref` values without hardcoding the names, e.g.\n * `data-ref=\"${myCounter.refs.dec}\"`.\n */\nexport type RefNames<RefDefs extends Record<string, RefDef>> = {\n    readonly [K in keyof RefDefs]:K & string\n}\n\n/**\n * A registered custom element class that also exposes, as static members,\n * the tag name it was registered under (`TAG`) and the names of its\n * declared refs (`refs`).\n */\nexport type MicrotagElementClass<\n    RefDefs extends Record<string, RefDef> = Record<never, never>\n> = typeof HTMLElement & {\n    /** The custom element tag name, e.g. 'my-counter'. */\n    readonly TAG:string\n    /**\n     * The declared ref names, each mapping to its own `data-ref` string.\n     * Lets server-rendered markup reference refs by key instead of a magic\n     * string: `myCounter.refs.dec`.\n     */\n    readonly refs:RefNames<RefDefs>\n}\n\n/**\n * Fluent builder that accumulates props/refs/contexts config\n * before registering a custom element via `.setup()`.\n */\nexport class ComponentBuilder<\n    Props extends Record<string, PropDef> = Record<never, never>,\n    RefDefs extends Record<string, RefDef> = Record<never, never>,\n    CtxDefs extends Record<string, ContextToken<unknown>> =\n        Record<never, never>,\n> {\n    private readonly _coercers:Record<string, Coercer<unknown>>\n    private readonly _observed:string[]\n    private readonly _refDefs:Record<string, RefDef>\n    private readonly _ctxDefs:Record<string, ContextToken<unknown>>\n\n    constructor (\n        readonly tagName:string,\n        coercers:Record<string, Coercer<unknown>> = {},\n        observed:string[] = [],\n        refDefs:Record<string, RefDef> = {},\n        ctxDefs:Record<string, ContextToken<unknown>> = {}\n    ) {\n        this._coercers = coercers\n        this._observed = observed\n        this._refDefs = refDefs\n        this._ctxDefs = ctxDefs\n    }\n\n    /**\n     * The custom element tag name, e.g. 'my-counter'. Available at every\n     * point in the fluent chain since each builder method returns a new\n     * builder carrying the same tag name.\n     */\n    get TAG ():string {\n        return this.tagName\n    }\n\n    withProps<P extends Record<string, PropDef>> (\n        fn:(p:PropDSL) => P\n    ):ComponentBuilder<P, RefDefs, CtxDefs> {\n        const defs = fn(propDSL)\n        const coercers:Record<string, Coercer<unknown>> = {}\n        const observed:string[] = []\n\n        for (const [name, def] of Object.entries(defs)) {\n            coercers[name] = normalizePropDef(name, def as PropDef<unknown>)\n            if (!isPropOnly(def)) {\n                observed.push(name)\n            }\n        }\n\n        return new ComponentBuilder<P, RefDefs, CtxDefs>(\n            this.tagName, coercers, observed, this._refDefs, this._ctxDefs\n        )\n    }\n\n    withRefs<R extends Record<string, RefDef>> (\n        fn:(r:RefsDSL) => R\n    ):ComponentBuilder<Props, R, CtxDefs> {\n        const defs = fn(refsDSL)\n        return new ComponentBuilder<Props, R, CtxDefs>(\n            this.tagName,\n            this._coercers,\n            this._observed,\n            defs,\n            this._ctxDefs\n        )\n    }\n\n    withContexts<C extends Record<string, ContextToken<unknown>>> (\n        fn:(c:ContextDSL) => C\n    ):ComponentBuilder<Props, RefDefs, C> {\n        const defs = fn(contextDSL)\n        return new ComponentBuilder<Props, RefDefs, C>(\n            this.tagName,\n            this._coercers,\n            this._observed,\n            this._refDefs,\n            defs\n        )\n    }\n\n    setup (\n        fn:(ctx:SetupContext<\n            Props,\n            RefsMap<RefDefs>,\n            ContextsMap<CtxDefs>\n        >) => void\n    ):MicrotagElementClass<RefDefs> {\n        const El = factory({\n            props: this._coercers,\n            observedAttrNames: this._observed,\n            refs: this._refDefs,\n            contexts: this._ctxDefs,\n            setup: fn as any,\n        })\n        Object.defineProperty(El, 'TAG', {\n            value: this.tagName,\n            enumerable: true,\n        })\n\n        // Expose each ref key as its own `data-ref` name so server-rendered\n        // markup can reference refs by key instead of a hardcoded string.\n        const refNames:Record<string, string> = {}\n        for (const key of Object.keys(this._refDefs)) {\n            refNames[key] = key\n        }\n        Object.defineProperty(El, 'refs', {\n            value: Object.freeze(refNames),\n            enumerable: true,\n        })\n\n        if (typeof customElements !== 'undefined') {\n            customElements.define(this.tagName, El)\n        }\n        return El as MicrotagElementClass<RefDefs>\n    }\n}\n\n/** Create a new component builder for the given tag name. */\nexport function define (tagName:string):ComponentBuilder {\n    return new ComponentBuilder(tagName)\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAgBO,SAAS,iBAGZ,MACA,OACA,MACA,UACA,UAC4B;AAC5B,SAAO;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IAEA;AAAA,IAEA,GAAI,QAAQ,MAAM,SAAS,SAAU;AACjC,aAAO;AAAA,QACH;AAAA,QACA;AAAA,QACA;AAAA,MACJ;AACA,eAAS,KAAK,MAAM;AAChB,eAAO;AAAA,UACH;AAAA,UACA;AAAA,UACA;AAAA,QACJ;AAAA,MACJ,CAAC;AAAA,IACL;AAAA,IAEA,OAAQ,IAAI;AACR,YAAM,UAAU,OAAO,EAAE;AACzB,eAAS,KAAK,OAAO;AAAA,IACzB;AAAA,IAEA,KAAM,QAAQ,SAAS,MAAM;AACzB,YAAM,QAAQ,mBAAmB,mBAC7B,UACA;AACJ,UAAI,OAAO;AACX,UAAI,YAAY;AAChB,UAAI,OAAO,SAAS,YAAY;AAC5B,eAAO;AAAA,MACX,WAAW,OAAO,SAAS,YACvB,OAAO,SAAS,SAAS;AACzB,eAAO;AACP,oBAAY;AAAA,MAChB,WAAW,SAAS,mBAAmB,qBAAqB;AACxD,oBAAY;AAAA,MAChB;AAEA,YAAM,YAAY,MAAM,QAAQ;AAChC,YAAM,QAAQ,OAAO,KAAK,QAAQ;AAClC,YAAM,KAAK;AAEX,UAAI,OAAO;AACP,cAAM,UAAU,6BAAM;AAClB,gBAAM,WAAW;AACjB,mBAAS,GAAG,SAAS,CAAC;AAAA,QAC1B,GAHgB;AAIhB,gBAAQ,iBAAiB,OAAO,OAAO;AACvC,iBAAS,KAAK,MAAM;AAChB,kBAAQ,oBAAoB,OAAO,OAAO;AAAA,QAC9C,CAAC;AAAA,MACL;AAEA,YAAM,UAAU,OAAO,MAAM;AACzB,WAAG,SAAS,IAAI,OAAO;AAAA,MAC3B,CAAC;AACD,eAAS,KAAK,OAAO;AAAA,IACzB;AAAA,IAEA,UAAW,IAAI;AACX,eAAS,KAAK,EAAE;AAAA,IACpB;AAAA,IAEA,QAAY,OAAqC;AAC7C,YAAM,MAAM,qBAAqB,MAAM,KAAK;AAC5C,aAAO,MAAM,IAAI,IAAI;AAAA,IACzB;AAAA,EACJ;AACJ;AAnFgB;;;ACchB,IAAM,kBAAkB,OAAO,gBAAgB,cAC3C,cACC,MAAM;AAAC;AAoBZ,SAAS,YACL,MACA,MACkC;AAClC,QAAM,SAA6C,CAAC;AACpD,QAAM,UAAmB,CAAC;AAC1B,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC3C,UAAM,MAAM,IAAI,YAAY,cAAc,GAAG;AAC7C,QAAI,IAAI,cAAc,WAAW;AAC7B,aAAO,GAAG,IAAI,MAAM,KAAK,KAAK,iBAAiB,GAAG,CAAC;AAAA,IACvD,OAAO;AACH,YAAM,KAAK,KAAK,cAAc,GAAG;AACjC,UAAI,CAAC,IAAI;AACL,gBAAQ,KAAK,GAAG;AAAA,MACpB,OAAO;AACH,eAAO,GAAG,IAAI;AAAA,MAClB;AAAA,IACJ;AAAA,EACJ;AACA,MAAI,QAAQ,SAAS,GAAG;AACpB,UAAM,IAAI;AAAA,MACN,GAAG,KAAK,OAAO,mBAAmB,QAAQ,KAAK,IAAI,CAAC;AAAA,IACxD;AAAA,EACJ;AACA,SAAO;AACX;AAzBS;AAgCF,SAAS,QACZ,QACiB;AACjB,QAAM;AAAA,IACF,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,MAAM,UAAU,CAAC;AAAA,IACjB,UAAU,UAAU,CAAC;AAAA,EACzB,IAAI;AAAA,EAEJ,MAAM,wBAAwB,gBAAgB;AAAA,IA/FlD,OA+FkD;AAAA;AAAA;AAAA,IAC1C,WAAW,qBAAsB;AAAE,aAAO;AAAA,IAAkB;AAAA,IAE5D,SAAyC,CAAC;AAAA,IAC1C,YAAsB,CAAC;AAAA,IAEvB,cAAe;AACX,YAAM;AACN,iBAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACpD,aAAK,OAAO,IAAI,IAAI,OAAO,QAAQ,IAAI,CAAC;AAAA,MAC5C;AAAA,IACJ;AAAA,IAEA,oBAAqB;AAEjB,WAAK,YAAY,CAAC;AAIlB,iBAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACpD,cAAM,UAAU,KAAK,aAAa,IAAI;AACtC,YAAI,YAAY,MAAM;AAClB,UAAC,KAAK,OAAO,IAAI,EAAsB,QAAQ,OAAO,CAAC;AAAA,QAC3D;AAAA,MACJ;AAEA,YAAM,WAAW,KAAK;AACtB,YAAM,QAAQ,KAAK;AAInB,YAAM,WAAW,IAAI,MAAM,CAAC,GAA8B;AAAA,QACtD,KAAK,wBAAC,SAAS,QAAQ;AACnB,cAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,gBAAM,QAAQ,QAAQ,GAAG;AACzB,cAAI,CAAC,MAAO,QAAO;AACnB,gBAAM,MAAM,qBAAqB,MAAM,KAAK;AAC5C,iBAAO,MAAM,IAAI,IAAI;AAAA,QACzB,GANK;AAAA,QAOL,KAAK,wBAAC,SAAS,QAAQ;AACnB,cAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,iBAAO,OAAO;AAAA,QAClB,GAHK;AAAA,MAIT,CAAC;AAED,UAAI,WAAW;AAIf,YAAM,kBAAiC,CAAC;AAExC,YAAM,cAAc,6BAAW;AAC3B,YAAI,SAAU;AACd,mBAAW,SAAS,OAAO,OAAO,OAAO,GAAG;AACxC,cAAI,CAAC,qBAAqB,MAAM,KAAK,EAAG;AAAA,QAC5C;AACA,mBAAW;AACX,mBAAW,UAAU,gBAAiB,QAAO;AAC7C,wBAAgB,SAAS;AAEzB,cAAM,OAAO,YAAY,MAAM,OAAO;AACtC,cAAM,MAAM;AAAA,UACR;AAAA,UAAM;AAAA,UAAO;AAAA,UAAM;AAAA,UAAU;AAAA,QACjC;AACA,cAAM,GAAG;AAAA,MACb,GAdoB;AAkBpB,YAAM,yBAAyB,6BAAW;AACtC,YAAI,CAAC,KAAK,YAAa;AACvB,oBAAY;AAAA,MAChB,GAH+B;AAM/B,iBAAW,SAAS,OAAO,OAAO,OAAO,GAAG;AACxC,YAAI,CAAC,qBAAqB,MAAM,KAAK,GAAG;AACpC,gBAAM,SAAS;AAAA,YACX,MAAM;AAAA,YAAI;AAAA,UACd;AACA,0BAAgB,KAAK,MAAM;AAE3B,mBAAS,KAAK,MAAM;AAAA,QACxB;AAAA,MACJ;AAEA,kBAAY;AAAA,IAChB;AAAA,IAEA,yBACI,MACA,MACA,MACF;AACE,YAAM,UAAU,SAAS,IAAI;AAC7B,UAAI,YAAY,UAAa,KAAK,OAAO,IAAI,MAAM,QAAW;AAC1D,QAAC,KAAK,OAAO,IAAI,EAAsB,QAAQ,IAAI,CAAC;AAAA,MACxD;AAAA,IACJ;AAAA,IAEA,uBAAwB;AAGpB,YAAM,MAAM,KAAK;AACjB,WAAK,YAAY,CAAC;AAClB,kBAAY,GAAG;AAAA,IACnB;AAAA,EACJ;AAEA,SAAO;AACX;AAzHgB;;;AC/DhB,SAAS,WAAY,KAA8C;AAC/D,SACI,OAAO,QAAQ,YACf,QAAQ,QACR,eAAe,OACd,IAA+B,cAAc;AAEtD;AAPS;AAST,SAAS,iBAAkB,KAAqC;AAC5D,SACI,OAAO,QAAQ,YACf,QAAQ,QACR,eAAe;AAEvB;AANS;AAQT,SAAS,iBACL,MACA,KACe;AACf,MAAI,WAAW,GAAG,GAAG;AACjB,WAAO,CAAC,SAAuB,IAAI;AAAA,EACvC;AACA,MAAI,iBAAiB,GAAG,GAAG;AACvB,UAAM,SAAS;AACf,WAAO,CAAC,QAA8B;AAClC,YAAM,SAAS,OAAO,WAAW,EAAE,SAAS,GAAG;AAC/C,UAAI,kBAAkB,SAAS;AAC3B,cAAM,IAAI;AAAA,UACN,qDAAqD,IAAI;AAAA,QAC7D;AAAA,MACJ;AACA,UAAI,OAAO,OAAQ,QAAO;AAC1B,aAAO,OAAO;AAAA,IAClB;AAAA,EACJ;AACA,SAAO;AACX;AArBS;AAiCF,IAAM,UAAkB;AAAA,EAC3B,QAAQ,6BAAM,cAAN;AAAA,EACR,QAAQ,6BAAM,cAAN;AAAA,EACR,SAAS,6BAAM,eAAN;AAAA,EACT,MAAM,6BAAS,YAAT;AAAA,EACN,QAAQ,wBAAI,MAAmC,GAAvC;AAAA,EACR,MAAM,wBAAI,aACN,EAAE,WAAW,QAAQ,QAAQ,IAD3B;AAGV;AAyBO,IAAM,UAAkB;AAAA,EAC3B,KAAM,yBAAC,cACH,EAAE,WAAW,WAAW,SAAS,KAD/B;AAAA,EAGN,KAAM,yBAAC,cACH,EAAE,WAAW,WAAW,SAAS,KAD/B;AAGV;AAQA,IAAM,aAAwB,CAAC;AAkCxB,IAAM,mBAAN,MAAM,kBAKX;AAAA,EAME,YACa,SACT,WAA4C,CAAC,GAC7C,WAAoB,CAAC,GACrB,UAAiC,CAAC,GAClC,UAAgD,CAAC,GACnD;AALW;AAMT,SAAK,YAAY;AACjB,SAAK,YAAY;AACjB,SAAK,WAAW;AAChB,SAAK,WAAW;AAAA,EACpB;AAAA,EAVa;AAAA,EAtKjB,OA+JE;AAAA;AAAA;AAAA,EACmB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBjB,IAAI,MAAc;AACd,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,UACI,IACoC;AACpC,UAAM,OAAO,GAAG,OAAO;AACvB,UAAM,WAA4C,CAAC;AACnD,UAAM,WAAoB,CAAC;AAE3B,eAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC5C,eAAS,IAAI,IAAI,iBAAiB,MAAM,GAAuB;AAC/D,UAAI,CAAC,WAAW,GAAG,GAAG;AAClB,iBAAS,KAAK,IAAI;AAAA,MACtB;AAAA,IACJ;AAEA,WAAO,IAAI;AAAA,MACP,KAAK;AAAA,MAAS;AAAA,MAAU;AAAA,MAAU,KAAK;AAAA,MAAU,KAAK;AAAA,IAC1D;AAAA,EACJ;AAAA,EAEA,SACI,IACkC;AAClC,UAAM,OAAO,GAAG,OAAO;AACvB,WAAO,IAAI;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,MACA,KAAK;AAAA,IACT;AAAA,EACJ;AAAA,EAEA,aACI,IACkC;AAClC,UAAM,OAAO,GAAG,UAAU;AAC1B,WAAO,IAAI;AAAA,MACP,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,MACI,IAK4B;AAC5B,UAAM,KAAK,QAAQ;AAAA,MACf,OAAO,KAAK;AAAA,MACZ,mBAAmB,KAAK;AAAA,MACxB,MAAM,KAAK;AAAA,MACX,UAAU,KAAK;AAAA,MACf,OAAO;AAAA,IACX,CAAC;AACD,WAAO,eAAe,IAAI,OAAO;AAAA,MAC7B,OAAO,KAAK;AAAA,MACZ,YAAY;AAAA,IAChB,CAAC;AAID,UAAM,WAAkC,CAAC;AACzC,eAAW,OAAO,OAAO,KAAK,KAAK,QAAQ,GAAG;AAC1C,eAAS,GAAG,IAAI;AAAA,IACpB;AACA,WAAO,eAAe,IAAI,QAAQ;AAAA,MAC9B,OAAO,OAAO,OAAO,QAAQ;AAAA,MAC7B,YAAY;AAAA,IAChB,CAAC;AAED,QAAI,OAAO,mBAAmB,aAAa;AACvC,qBAAe,OAAO,KAAK,SAAS,EAAE;AAAA,IAC1C;AACA,WAAO;AAAA,EACX;AACJ;AAGO,SAAS,OAAQ,SAAiC;AACrD,SAAO,IAAI,iBAAiB,OAAO;AACvC;AAFgB;",
   "names": []
 }