@vielzeug/craftit 2.0.1 → 2.1.0

package/dist/host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.cjs","names":[],"sources":["../src/host.ts"],"sourcesContent":["/**\n * Host utilities — component context injection, slot observation, and attribute/class reflection.\n *\n * - Context API (provide, inject, createContext, syncContextProps)\n * - Slot observation and detection (setup slots)\n * - Host element binding (reflect) for attributes, classes, and host listeners\n */\n\nimport { type ReadonlySignal, type Signal, signal } from '@vielzeug/stateit';\n\nimport { listen, setAttr } from './internal';\nimport { currentRuntime } from './runtime-core';\nimport { effect, onCleanup, onMount, type HostEventListeners } from './runtime-lifecycle';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// CONTEXT API\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst contextRegistry = new WeakMap<HTMLElement, Map<InjectionKey<unknown> | string | symbol, unknown>>();\n\nexport type InjectionKey<T> = symbol & {\n  readonly __craftit_injection_key?: T;\n};\n\nexport const provide = <T>(key: InjectionKey<T> | string | symbol, value: T): void => {\n  const el = currentRuntime().el;\n\n  if (!contextRegistry.has(el)) contextRegistry.set(el, new Map());\n\n  contextRegistry.get(el)!.set(key, value);\n};\n\nexport function inject<T>(key: InjectionKey<T> | string | symbol): T | undefined;\nexport function inject<T>(key: InjectionKey<T> | string | symbol, fallback: T): T;\nexport function inject<T>(key: InjectionKey<T> | string | symbol, ...rest: [T?]): T | undefined {\n  let node: Node | null = currentRuntime().el;\n\n  while (node) {\n    if (node instanceof HTMLElement) {\n      const v = contextRegistry.get(node)?.get(key);\n\n      if (v !== undefined) return v as T;\n    }\n\n    const root = node.getRootNode() as Node;\n\n    node = (node as HTMLElement).parentElement ?? (root instanceof ShadowRoot ? root.host : null);\n  }\n\n  return rest.length > 0 ? rest[0] : undefined;\n}\n\nexport function createContext<T>(description?: string): InjectionKey<T> {\n  return Symbol(description) as InjectionKey<T>;\n}\n\n/**\n * Reactively inherits prop values from a context object provided by an ancestor component.\n * For each key, when the context value is not `undefined`, it is written into the matching prop signal.\n * The effect is automatically cleaned up when the component unmounts.\n *\n * Deferred to `onMount` so context values win over HTML attribute values set on the child.\n *\n * @example\n * syncContextProps(inject(BUTTON_GROUP_CTX), props, ['color', 'size', 'variant']);\n */\nexport const syncContextProps = <\n  K extends string,\n  Ctx extends Partial<Record<K, ReadonlySignal<unknown>>>,\n  Props extends Record<K, Signal<unknown>>,\n>(\n  ctx: Ctx | undefined,\n  props: Props,\n  keys: K[],\n): void => {\n  if (!ctx) return;\n\n  onMount(() => {\n    effect(() => {\n      const target = props as Record<K, Signal<unknown>>;\n\n      for (const k of keys) {\n        const v = ctx[k]?.value;\n\n        if (v !== undefined) target[k].value = v;\n      }\n    });\n  });\n};\n\nexport type HostContextAttributeBridge = {\n  contextDisabled?: ReadonlySignal<boolean | undefined>;\n  contextSize?: ReadonlySignal<string | undefined>;\n  contextVariant?: ReadonlySignal<string | undefined>;\n  ownDisabled?: ReadonlySignal<boolean | undefined>;\n  ownSize?: ReadonlySignal<string | undefined>;\n  ownVariant?: ReadonlySignal<string | undefined>;\n};\n\nexport const bridgeContextAttributes = (host: HTMLElement, options: HostContextAttributeBridge): void => {\n  let contextDisabledActive = false;\n\n  effect(() => {\n    const contextDisabled = Boolean(options.contextDisabled?.value);\n\n    if (contextDisabled && !contextDisabledActive) {\n      host.setAttribute('disabled', '');\n      contextDisabledActive = true;\n    } else if (!contextDisabled && contextDisabledActive && !options.ownDisabled?.value) {\n      host.removeAttribute('disabled');\n      contextDisabledActive = false;\n    }\n\n    const contextSize = options.contextSize?.value;\n    const hasOwnSize = Boolean(options.ownSize?.value);\n\n    if (contextSize && !hasOwnSize) host.setAttribute('size', contextSize);\n    else if (!hasOwnSize) host.removeAttribute('size');\n\n    const contextVariant = options.contextVariant?.value;\n    const hasOwnVariant = Boolean(options.ownVariant?.value);\n\n    if (contextVariant && !hasOwnVariant) host.setAttribute('variant', contextVariant);\n    else if (!hasOwnVariant) host.removeAttribute('variant');\n  });\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// SLOTS API\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst SLOT_DEFAULT = 'default';\nconst normalizeSlotName = (slotName: string | null | undefined): string => {\n  if (!slotName || slotName === SLOT_DEFAULT) return SLOT_DEFAULT;\n\n  return slotName;\n};\n\nconst slotsRegistry = new WeakMap<HTMLElement, ComponentSlots>();\n\nexport type ComponentSlots = {\n  elements: (name?: string) => ReadonlySignal<Element[]>;\n  has: (name?: string) => ReadonlySignal<boolean>;\n};\n\n/**\n * Creates first-class slot signals for setup context.\n *\n * - `slots.has(name?)`: whether a slot has assigned elements\n * - `slots.elements(name?)`: assigned elements for a slot (flattened)\n */\nexport const createSlots = (): ComponentSlots => {\n  const host = currentRuntime().el;\n  const cached = slotsRegistry.get(host);\n\n  if (cached) return cached;\n\n  const presenceSignals = new Map<string, Signal<boolean>>();\n  const elementSignals = new Map<string, Signal<Element[]>>();\n  const slotNodesByName = new Map<string, Set<HTMLSlotElement>>();\n  const slotCleanupMap = new Map<HTMLSlotElement, () => void>();\n  let isDisposing = false;\n\n  const ensurePresenceSignal = (name: string): Signal<boolean> => {\n    const normalized = normalizeSlotName(name);\n    let s = presenceSignals.get(normalized);\n\n    if (!s) {\n      s = signal(false);\n      presenceSignals.set(normalized, s);\n    }\n\n    return s;\n  };\n\n  const ensureElementSignal = (name: string): Signal<Element[]> => {\n    const normalized = normalizeSlotName(name);\n    let s = elementSignals.get(normalized);\n\n    if (!s) {\n      s = signal<Element[]>([]);\n      elementSignals.set(normalized, s);\n    }\n\n    return s;\n  };\n\n  const recomputeSlot = (name: string): void => {\n    const normalized = normalizeSlotName(name);\n    const slotsForName = slotNodesByName.get(normalized);\n    const assigned: Element[] = [];\n\n    if (slotsForName) {\n      for (const slotEl of slotsForName) {\n        assigned.push(...slotEl.assignedElements({ flatten: true }));\n      }\n    }\n\n    ensureElementSignal(normalized).value = assigned;\n    ensurePresenceSignal(normalized).value = assigned.length > 0;\n  };\n\n  const bindSlot = (slotEl: HTMLSlotElement): void => {\n    if (slotCleanupMap.has(slotEl)) return;\n\n    const name = normalizeSlotName(slotEl.getAttribute('name'));\n    const setForName = slotNodesByName.get(name) ?? new Set<HTMLSlotElement>();\n\n    setForName.add(slotEl);\n    slotNodesByName.set(name, setForName);\n\n    const onChange = () => recomputeSlot(name);\n\n    slotEl.addEventListener('slotchange', onChange);\n\n    const cleanup = () => {\n      slotEl.removeEventListener('slotchange', onChange);\n      slotCleanupMap.delete(slotEl);\n\n      if (isDisposing) return;\n\n      const currentSet = slotNodesByName.get(name);\n\n      if (!currentSet) return;\n\n      currentSet.delete(slotEl);\n\n      if (currentSet.size === 0) {\n        slotNodesByName.delete(name);\n      }\n\n      recomputeSlot(name);\n    };\n\n    slotCleanupMap.set(slotEl, cleanup);\n\n    recomputeSlot(name);\n  };\n\n  const unbindSlot = (slotEl: HTMLSlotElement): void => {\n    slotCleanupMap.get(slotEl)?.();\n  };\n\n  const bindAllSlots = (): void => {\n    host.shadowRoot?.querySelectorAll('slot').forEach((slotEl) => bindSlot(slotEl));\n  };\n\n  ensurePresenceSignal(SLOT_DEFAULT);\n  ensureElementSignal(SLOT_DEFAULT);\n\n  bindAllSlots();\n\n  const observer = new MutationObserver((mutations) => {\n    for (const mutation of mutations) {\n      mutation.addedNodes.forEach((node) => {\n        if (node instanceof HTMLSlotElement) {\n          bindSlot(node);\n\n          return;\n        }\n\n        if (node instanceof Element) {\n          node.querySelectorAll('slot').forEach((slotEl) => bindSlot(slotEl));\n        }\n      });\n\n      mutation.removedNodes.forEach((node) => {\n        if (node instanceof HTMLSlotElement) {\n          unbindSlot(node);\n\n          return;\n        }\n\n        if (node instanceof Element) {\n          node.querySelectorAll('slot').forEach((slotEl) => unbindSlot(slotEl));\n        }\n      });\n    }\n  });\n\n  if (host.shadowRoot) {\n    observer.observe(host.shadowRoot, { childList: true, subtree: true });\n  }\n\n  onCleanup(() => {\n    isDisposing = true;\n    observer.disconnect();\n\n    for (const cleanup of [...slotCleanupMap.values()]) cleanup();\n\n    slotCleanupMap.clear();\n    slotNodesByName.clear();\n  });\n\n  const slots: ComponentSlots = {\n    elements: (name?: string) => ensureElementSignal(normalizeSlotName(name)),\n    has: (name?: string) => ensurePresenceSignal(normalizeSlotName(name)),\n  };\n\n  slotsRegistry.set(host, slots);\n\n  return slots;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// REFLECT API (HOST ATTRIBUTE/EVENT/CLASS BINDING)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Describes a reactive or static host binding value.\n */\nexport type HostBindingValue =\n  | (() => Record<string, boolean>)\n  | (() => string | number | boolean | null | undefined)\n  | string\n  | number\n  | boolean\n  | null\n  | undefined;\n\n/**\n * Configuration for host attribute bindings.\n */\nexport type ReflectConfig = Record<string, HostBindingValue>;\n\nexport type HostBindConfig<CustomEvents extends Record<string, unknown> = Record<string, never>> =\n  | { attr: ReflectConfig }\n  | { class: () => Record<string, boolean> }\n  | { on: HostEventListeners<CustomEvents> };\n\nexport type HostBindTarget = 'attr' | 'class' | 'on';\n\nexport type ComponentHost = {\n  bind: {\n    <CustomEvents extends Record<string, unknown> = Record<string, never>>(\n      config: HostBindConfig<CustomEvents>,\n      options?: AddEventListenerOptions,\n    ): () => void;\n    <CustomEvents extends Record<string, unknown> = Record<string, never>>(\n      target: 'attr',\n      config: ReflectConfig,\n    ): () => void;\n    (target: 'class', getter: () => Record<string, boolean>): () => void;\n    <CustomEvents extends Record<string, unknown> = Record<string, never>>(\n      target: 'on',\n      hostEvents: HostEventListeners<CustomEvents>,\n      options?: AddEventListenerOptions,\n    ): () => void;\n  };\n  el: HTMLElement;\n  shadowRoot: ShadowRoot;\n};\n\nexport const createHost = (): ComponentHost => {\n  const el = currentRuntime().el;\n\n  return {\n    bind: (\n      targetOrConfig: HostBindTarget | HostBindConfig,\n      configOrOptions?: ReflectConfig | (() => Record<string, boolean>) | HostEventListeners | AddEventListenerOptions,\n      maybeOptions?: AddEventListenerOptions,\n    ) => {\n      const disposers: Array<() => void> = [];\n\n      const config =\n        typeof targetOrConfig === 'string'\n          ? ({ [targetOrConfig]: configOrOptions } as HostBindConfig)\n          : (targetOrConfig as HostBindConfig);\n      const options =\n        typeof targetOrConfig === 'string' && targetOrConfig === 'on'\n          ? (maybeOptions as AddEventListenerOptions | undefined)\n          : (configOrOptions as AddEventListenerOptions | undefined);\n\n      if ('attr' in config) {\n        for (const [key, value] of Object.entries(config.attr)) {\n          const name =\n            key.startsWith('aria-') || key === 'role'\n              ? key\n              : key.startsWith('aria')\n                ? `aria-${key.slice(4).toLowerCase()}`\n                : key;\n          const dispose = applyAttribute(el, name, value);\n\n          if (dispose) disposers.push(dispose);\n        }\n      }\n\n      if ('class' in config) {\n        disposers.push(applyClassMap(el, config.class));\n      }\n\n      if ('on' in config) {\n        for (const event of Object.keys(config.on) as Array<keyof typeof config.on>) {\n          const listener = config.on[event];\n\n          if (!listener) continue;\n\n          disposers.push(listen(el, event as string, listener as EventListener, options));\n        }\n      }\n\n      const cleanup = () => {\n        while (disposers.length > 0) disposers.pop()?.();\n      };\n\n      onCleanup(cleanup);\n\n      return cleanup;\n    },\n    el,\n    shadowRoot: el.shadowRoot as ShadowRoot,\n  };\n};\n\nfunction applyAttribute(host: HTMLElement, name: string, value: HostBindingValue): (() => void) | void {\n  if (typeof value === 'function') {\n    return effect(() => setAttr(host, name, (value as () => HostBindingValue)()));\n  } else {\n    setAttr(host, name, value);\n  }\n}\n\nfunction applyClassMap(host: HTMLElement, getter: () => Record<string, boolean>): () => void {\n  let prev = new Set<string>();\n\n  return effect(() => {\n    const next = new Set(\n      Object.entries(getter())\n        .filter(([, active]) => active)\n        .map(([cls]) => cls),\n    );\n\n    for (const cls of prev) if (!next.has(cls)) host.classList.remove(cls);\n    for (const cls of next) if (!prev.has(cls)) host.classList.add(cls);\n\n    prev = next;\n  });\n}\n"],"mappings":"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"}

package/dist/host.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Host utilities — component context injection, slot observation, and attribute/class reflection.
+ *
+ * - Context API (provide, inject, createContext, syncContextProps)
+ * - Slot observation and detection (setup slots)
+ * - Host element binding (reflect) for attributes, classes, and host listeners
+ */
+import { type ReadonlySignal, type Signal } from '@vielzeug/stateit';
+import { type HostEventListeners } from './runtime-lifecycle';
+export type InjectionKey<T> = symbol & {
+    readonly __craftit_injection_key?: T;
+};
+export declare const provide: <T>(key: InjectionKey<T> | string | symbol, value: T) => void;
+export declare function inject<T>(key: InjectionKey<T> | string | symbol): T | undefined;
+export declare function inject<T>(key: InjectionKey<T> | string | symbol, fallback: T): T;
+export declare function createContext<T>(description?: string): InjectionKey<T>;
+/**
+ * Reactively inherits prop values from a context object provided by an ancestor component.
+ * For each key, when the context value is not `undefined`, it is written into the matching prop signal.
+ * The effect is automatically cleaned up when the component unmounts.
+ *
+ * Deferred to `onMount` so context values win over HTML attribute values set on the child.
+ *
+ * @example
+ * syncContextProps(inject(BUTTON_GROUP_CTX), props, ['color', 'size', 'variant']);
+ */
+export declare const syncContextProps: <K extends string, Ctx extends Partial<Record<K, ReadonlySignal<unknown>>>, Props extends Record<K, Signal<unknown>>>(ctx: Ctx | undefined, props: Props, keys: K[]) => void;
+export type HostContextAttributeBridge = {
+    contextDisabled?: ReadonlySignal<boolean | undefined>;
+    contextSize?: ReadonlySignal<string | undefined>;
+    contextVariant?: ReadonlySignal<string | undefined>;
+    ownDisabled?: ReadonlySignal<boolean | undefined>;
+    ownSize?: ReadonlySignal<string | undefined>;
+    ownVariant?: ReadonlySignal<string | undefined>;
+};
+export declare const bridgeContextAttributes: (host: HTMLElement, options: HostContextAttributeBridge) => void;
+export type ComponentSlots = {
+    elements: (name?: string) => ReadonlySignal<Element[]>;
+    has: (name?: string) => ReadonlySignal<boolean>;
+};
+/**
+ * Creates first-class slot signals for setup context.
+ *
+ * - `slots.has(name?)`: whether a slot has assigned elements
+ * - `slots.elements(name?)`: assigned elements for a slot (flattened)
+ */
+export declare const createSlots: () => ComponentSlots;
+/**
+ * Describes a reactive or static host binding value.
+ */
+export type HostBindingValue = (() => Record<string, boolean>) | (() => string | number | boolean | null | undefined) | string | number | boolean | null | undefined;
+/**
+ * Configuration for host attribute bindings.
+ */
+export type ReflectConfig = Record<string, HostBindingValue>;
+export type HostBindConfig<CustomEvents extends Record<string, unknown> = Record<string, never>> = {
+    attr: ReflectConfig;
+} | {
+    class: () => Record<string, boolean>;
+} | {
+    on: HostEventListeners<CustomEvents>;
+};
+export type HostBindTarget = 'attr' | 'class' | 'on';
+export type ComponentHost = {
+    bind: {
+        <CustomEvents extends Record<string, unknown> = Record<string, never>>(config: HostBindConfig<CustomEvents>, options?: AddEventListenerOptions): () => void;
+        <CustomEvents extends Record<string, unknown> = Record<string, never>>(target: 'attr', config: ReflectConfig): () => void;
+        (target: 'class', getter: () => Record<string, boolean>): () => void;
+        <CustomEvents extends Record<string, unknown> = Record<string, never>>(target: 'on', hostEvents: HostEventListeners<CustomEvents>, options?: AddEventListenerOptions): () => void;
+    };
+    el: HTMLElement;
+    shadowRoot: ShadowRoot;
+};
+export declare const createHost: () => ComponentHost;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}

package/dist/host.js

@@ -0,0 +1,2 @@
+import{currentRuntime as e}from"./runtime-core.js";import{effect as t,onCleanup as n,onMount as r}from"./runtime-lifecycle.js";import{listen as i,setAttr as a}from"./internal.js";import{signal as o}from"@vielzeug/stateit";var s=new WeakMap,c=(t,n)=>{let r=e().el;s.has(r)||s.set(r,new Map),s.get(r).set(t,n)};function l(t,...n){let r=e().el;for(;r;){if(r instanceof HTMLElement){let e=s.get(r)?.get(t);if(e!==void 0)return e}let e=r.getRootNode();r=r.parentElement??(e instanceof ShadowRoot?e.host:null)}return n.length>0?n[0]:void 0}function u(e){return Symbol(e)}var d=(e,n,i)=>{e&&r(()=>{t(()=>{let t=n;for(let n of i){let r=e[n]?.value;r!==void 0&&(t[n].value=r)}})})},f=(e,n)=>{let r=!1;t(()=>{let t=!!n.contextDisabled?.value;t&&!r?(e.setAttribute(`disabled`,``),r=!0):!t&&r&&!n.ownDisabled?.value&&(e.removeAttribute(`disabled`),r=!1);let i=n.contextSize?.value,a=!!n.ownSize?.value;i&&!a?e.setAttribute(`size`,i):a||e.removeAttribute(`size`);let o=n.contextVariant?.value,s=!!n.ownVariant?.value;o&&!s?e.setAttribute(`variant`,o):s||e.removeAttribute(`variant`)})},p=`default`,m=e=>!e||e===p?p:e,h=new WeakMap,g=()=>{let t=e().el,r=h.get(t);if(r)return r;let i=new Map,a=new Map,s=new Map,c=new Map,l=!1,u=e=>{let t=m(e),n=i.get(t);return n||(n=o(!1),i.set(t,n)),n},d=e=>{let t=m(e),n=a.get(t);return n||(n=o([]),a.set(t,n)),n},f=e=>{let t=m(e),n=s.get(t),r=[];if(n)for(let e of n)r.push(...e.assignedElements({flatten:!0}));d(t).value=r,u(t).value=r.length>0},g=e=>{if(c.has(e))return;let t=m(e.getAttribute(`name`)),n=s.get(t)??new Set;n.add(e),s.set(t,n);let r=()=>f(t);e.addEventListener(`slotchange`,r),c.set(e,()=>{if(e.removeEventListener(`slotchange`,r),c.delete(e),l)return;let n=s.get(t);n&&(n.delete(e),n.size===0&&s.delete(t),f(t))}),f(t)},_=e=>{c.get(e)?.()};u(p),d(p),t.shadowRoot?.querySelectorAll(`slot`).forEach(e=>g(e));let v=new MutationObserver(e=>{for(let t of e)t.addedNodes.forEach(e=>{if(e instanceof HTMLSlotElement){g(e);return}e instanceof Element&&e.querySelectorAll(`slot`).forEach(e=>g(e))}),t.removedNodes.forEach(e=>{if(e instanceof HTMLSlotElement){_(e);return}e instanceof Element&&e.querySelectorAll(`slot`).forEach(e=>_(e))})});t.shadowRoot&&v.observe(t.shadowRoot,{childList:!0,subtree:!0}),n(()=>{l=!0,v.disconnect();for(let e of[...c.values()])e();c.clear(),s.clear()});let y={elements:e=>d(m(e)),has:e=>u(m(e))};return h.set(t,y),y},_=()=>{let t=e().el;return{bind:(e,r,a)=>{let o=[],s=typeof e==`string`?{[e]:r}:e,c=typeof e==`string`&&e===`on`?a:r;if(`attr`in s)for(let[e,n]of Object.entries(s.attr)){let r=v(t,e.startsWith(`aria-`)||e===`role`?e:e.startsWith(`aria`)?`aria-${e.slice(4).toLowerCase()}`:e,n);r&&o.push(r)}if(`class`in s&&o.push(y(t,s.class)),`on`in s)for(let e of Object.keys(s.on)){let n=s.on[e];n&&o.push(i(t,e,n,c))}let l=()=>{for(;o.length>0;)o.pop()?.()};return n(l),l},el:t,shadowRoot:t.shadowRoot}};function v(e,n,r){if(typeof r==`function`)return t(()=>a(e,n,r()));a(e,n,r)}function y(e,n){let r=new Set;return t(()=>{let t=new Set(Object.entries(n()).filter(([,e])=>e).map(([e])=>e));for(let n of r)t.has(n)||e.classList.remove(n);for(let n of t)r.has(n)||e.classList.add(n);r=t})}export{f as bridgeContextAttributes,u as createContext,_ as createHost,g as createSlots,l as inject,c as provide,d as syncContextProps};
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","names":[],"sources":["../src/host.ts"],"sourcesContent":["/**\n * Host utilities — component context injection, slot observation, and attribute/class reflection.\n *\n * - Context API (provide, inject, createContext, syncContextProps)\n * - Slot observation and detection (setup slots)\n * - Host element binding (reflect) for attributes, classes, and host listeners\n */\n\nimport { type ReadonlySignal, type Signal, signal } from '@vielzeug/stateit';\n\nimport { listen, setAttr } from './internal';\nimport { currentRuntime } from './runtime-core';\nimport { effect, onCleanup, onMount, type HostEventListeners } from './runtime-lifecycle';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// CONTEXT API\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst contextRegistry = new WeakMap<HTMLElement, Map<InjectionKey<unknown> | string | symbol, unknown>>();\n\nexport type InjectionKey<T> = symbol & {\n  readonly __craftit_injection_key?: T;\n};\n\nexport const provide = <T>(key: InjectionKey<T> | string | symbol, value: T): void => {\n  const el = currentRuntime().el;\n\n  if (!contextRegistry.has(el)) contextRegistry.set(el, new Map());\n\n  contextRegistry.get(el)!.set(key, value);\n};\n\nexport function inject<T>(key: InjectionKey<T> | string | symbol): T | undefined;\nexport function inject<T>(key: InjectionKey<T> | string | symbol, fallback: T): T;\nexport function inject<T>(key: InjectionKey<T> | string | symbol, ...rest: [T?]): T | undefined {\n  let node: Node | null = currentRuntime().el;\n\n  while (node) {\n    if (node instanceof HTMLElement) {\n      const v = contextRegistry.get(node)?.get(key);\n\n      if (v !== undefined) return v as T;\n    }\n\n    const root = node.getRootNode() as Node;\n\n    node = (node as HTMLElement).parentElement ?? (root instanceof ShadowRoot ? root.host : null);\n  }\n\n  return rest.length > 0 ? rest[0] : undefined;\n}\n\nexport function createContext<T>(description?: string): InjectionKey<T> {\n  return Symbol(description) as InjectionKey<T>;\n}\n\n/**\n * Reactively inherits prop values from a context object provided by an ancestor component.\n * For each key, when the context value is not `undefined`, it is written into the matching prop signal.\n * The effect is automatically cleaned up when the component unmounts.\n *\n * Deferred to `onMount` so context values win over HTML attribute values set on the child.\n *\n * @example\n * syncContextProps(inject(BUTTON_GROUP_CTX), props, ['color', 'size', 'variant']);\n */\nexport const syncContextProps = <\n  K extends string,\n  Ctx extends Partial<Record<K, ReadonlySignal<unknown>>>,\n  Props extends Record<K, Signal<unknown>>,\n>(\n  ctx: Ctx | undefined,\n  props: Props,\n  keys: K[],\n): void => {\n  if (!ctx) return;\n\n  onMount(() => {\n    effect(() => {\n      const target = props as Record<K, Signal<unknown>>;\n\n      for (const k of keys) {\n        const v = ctx[k]?.value;\n\n        if (v !== undefined) target[k].value = v;\n      }\n    });\n  });\n};\n\nexport type HostContextAttributeBridge = {\n  contextDisabled?: ReadonlySignal<boolean | undefined>;\n  contextSize?: ReadonlySignal<string | undefined>;\n  contextVariant?: ReadonlySignal<string | undefined>;\n  ownDisabled?: ReadonlySignal<boolean | undefined>;\n  ownSize?: ReadonlySignal<string | undefined>;\n  ownVariant?: ReadonlySignal<string | undefined>;\n};\n\nexport const bridgeContextAttributes = (host: HTMLElement, options: HostContextAttributeBridge): void => {\n  let contextDisabledActive = false;\n\n  effect(() => {\n    const contextDisabled = Boolean(options.contextDisabled?.value);\n\n    if (contextDisabled && !contextDisabledActive) {\n      host.setAttribute('disabled', '');\n      contextDisabledActive = true;\n    } else if (!contextDisabled && contextDisabledActive && !options.ownDisabled?.value) {\n      host.removeAttribute('disabled');\n      contextDisabledActive = false;\n    }\n\n    const contextSize = options.contextSize?.value;\n    const hasOwnSize = Boolean(options.ownSize?.value);\n\n    if (contextSize && !hasOwnSize) host.setAttribute('size', contextSize);\n    else if (!hasOwnSize) host.removeAttribute('size');\n\n    const contextVariant = options.contextVariant?.value;\n    const hasOwnVariant = Boolean(options.ownVariant?.value);\n\n    if (contextVariant && !hasOwnVariant) host.setAttribute('variant', contextVariant);\n    else if (!hasOwnVariant) host.removeAttribute('variant');\n  });\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// SLOTS API\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst SLOT_DEFAULT = 'default';\nconst normalizeSlotName = (slotName: string | null | undefined): string => {\n  if (!slotName || slotName === SLOT_DEFAULT) return SLOT_DEFAULT;\n\n  return slotName;\n};\n\nconst slotsRegistry = new WeakMap<HTMLElement, ComponentSlots>();\n\nexport type ComponentSlots = {\n  elements: (name?: string) => ReadonlySignal<Element[]>;\n  has: (name?: string) => ReadonlySignal<boolean>;\n};\n\n/**\n * Creates first-class slot signals for setup context.\n *\n * - `slots.has(name?)`: whether a slot has assigned elements\n * - `slots.elements(name?)`: assigned elements for a slot (flattened)\n */\nexport const createSlots = (): ComponentSlots => {\n  const host = currentRuntime().el;\n  const cached = slotsRegistry.get(host);\n\n  if (cached) return cached;\n\n  const presenceSignals = new Map<string, Signal<boolean>>();\n  const elementSignals = new Map<string, Signal<Element[]>>();\n  const slotNodesByName = new Map<string, Set<HTMLSlotElement>>();\n  const slotCleanupMap = new Map<HTMLSlotElement, () => void>();\n  let isDisposing = false;\n\n  const ensurePresenceSignal = (name: string): Signal<boolean> => {\n    const normalized = normalizeSlotName(name);\n    let s = presenceSignals.get(normalized);\n\n    if (!s) {\n      s = signal(false);\n      presenceSignals.set(normalized, s);\n    }\n\n    return s;\n  };\n\n  const ensureElementSignal = (name: string): Signal<Element[]> => {\n    const normalized = normalizeSlotName(name);\n    let s = elementSignals.get(normalized);\n\n    if (!s) {\n      s = signal<Element[]>([]);\n      elementSignals.set(normalized, s);\n    }\n\n    return s;\n  };\n\n  const recomputeSlot = (name: string): void => {\n    const normalized = normalizeSlotName(name);\n    const slotsForName = slotNodesByName.get(normalized);\n    const assigned: Element[] = [];\n\n    if (slotsForName) {\n      for (const slotEl of slotsForName) {\n        assigned.push(...slotEl.assignedElements({ flatten: true }));\n      }\n    }\n\n    ensureElementSignal(normalized).value = assigned;\n    ensurePresenceSignal(normalized).value = assigned.length > 0;\n  };\n\n  const bindSlot = (slotEl: HTMLSlotElement): void => {\n    if (slotCleanupMap.has(slotEl)) return;\n\n    const name = normalizeSlotName(slotEl.getAttribute('name'));\n    const setForName = slotNodesByName.get(name) ?? new Set<HTMLSlotElement>();\n\n    setForName.add(slotEl);\n    slotNodesByName.set(name, setForName);\n\n    const onChange = () => recomputeSlot(name);\n\n    slotEl.addEventListener('slotchange', onChange);\n\n    const cleanup = () => {\n      slotEl.removeEventListener('slotchange', onChange);\n      slotCleanupMap.delete(slotEl);\n\n      if (isDisposing) return;\n\n      const currentSet = slotNodesByName.get(name);\n\n      if (!currentSet) return;\n\n      currentSet.delete(slotEl);\n\n      if (currentSet.size === 0) {\n        slotNodesByName.delete(name);\n      }\n\n      recomputeSlot(name);\n    };\n\n    slotCleanupMap.set(slotEl, cleanup);\n\n    recomputeSlot(name);\n  };\n\n  const unbindSlot = (slotEl: HTMLSlotElement): void => {\n    slotCleanupMap.get(slotEl)?.();\n  };\n\n  const bindAllSlots = (): void => {\n    host.shadowRoot?.querySelectorAll('slot').forEach((slotEl) => bindSlot(slotEl));\n  };\n\n  ensurePresenceSignal(SLOT_DEFAULT);\n  ensureElementSignal(SLOT_DEFAULT);\n\n  bindAllSlots();\n\n  const observer = new MutationObserver((mutations) => {\n    for (const mutation of mutations) {\n      mutation.addedNodes.forEach((node) => {\n        if (node instanceof HTMLSlotElement) {\n          bindSlot(node);\n\n          return;\n        }\n\n        if (node instanceof Element) {\n          node.querySelectorAll('slot').forEach((slotEl) => bindSlot(slotEl));\n        }\n      });\n\n      mutation.removedNodes.forEach((node) => {\n        if (node instanceof HTMLSlotElement) {\n          unbindSlot(node);\n\n          return;\n        }\n\n        if (node instanceof Element) {\n          node.querySelectorAll('slot').forEach((slotEl) => unbindSlot(slotEl));\n        }\n      });\n    }\n  });\n\n  if (host.shadowRoot) {\n    observer.observe(host.shadowRoot, { childList: true, subtree: true });\n  }\n\n  onCleanup(() => {\n    isDisposing = true;\n    observer.disconnect();\n\n    for (const cleanup of [...slotCleanupMap.values()]) cleanup();\n\n    slotCleanupMap.clear();\n    slotNodesByName.clear();\n  });\n\n  const slots: ComponentSlots = {\n    elements: (name?: string) => ensureElementSignal(normalizeSlotName(name)),\n    has: (name?: string) => ensurePresenceSignal(normalizeSlotName(name)),\n  };\n\n  slotsRegistry.set(host, slots);\n\n  return slots;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// REFLECT API (HOST ATTRIBUTE/EVENT/CLASS BINDING)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Describes a reactive or static host binding value.\n */\nexport type HostBindingValue =\n  | (() => Record<string, boolean>)\n  | (() => string | number | boolean | null | undefined)\n  | string\n  | number\n  | boolean\n  | null\n  | undefined;\n\n/**\n * Configuration for host attribute bindings.\n */\nexport type ReflectConfig = Record<string, HostBindingValue>;\n\nexport type HostBindConfig<CustomEvents extends Record<string, unknown> = Record<string, never>> =\n  | { attr: ReflectConfig }\n  | { class: () => Record<string, boolean> }\n  | { on: HostEventListeners<CustomEvents> };\n\nexport type HostBindTarget = 'attr' | 'class' | 'on';\n\nexport type ComponentHost = {\n  bind: {\n    <CustomEvents extends Record<string, unknown> = Record<string, never>>(\n      config: HostBindConfig<CustomEvents>,\n      options?: AddEventListenerOptions,\n    ): () => void;\n    <CustomEvents extends Record<string, unknown> = Record<string, never>>(\n      target: 'attr',\n      config: ReflectConfig,\n    ): () => void;\n    (target: 'class', getter: () => Record<string, boolean>): () => void;\n    <CustomEvents extends Record<string, unknown> = Record<string, never>>(\n      target: 'on',\n      hostEvents: HostEventListeners<CustomEvents>,\n      options?: AddEventListenerOptions,\n    ): () => void;\n  };\n  el: HTMLElement;\n  shadowRoot: ShadowRoot;\n};\n\nexport const createHost = (): ComponentHost => {\n  const el = currentRuntime().el;\n\n  return {\n    bind: (\n      targetOrConfig: HostBindTarget | HostBindConfig,\n      configOrOptions?: ReflectConfig | (() => Record<string, boolean>) | HostEventListeners | AddEventListenerOptions,\n      maybeOptions?: AddEventListenerOptions,\n    ) => {\n      const disposers: Array<() => void> = [];\n\n      const config =\n        typeof targetOrConfig === 'string'\n          ? ({ [targetOrConfig]: configOrOptions } as HostBindConfig)\n          : (targetOrConfig as HostBindConfig);\n      const options =\n        typeof targetOrConfig === 'string' && targetOrConfig === 'on'\n          ? (maybeOptions as AddEventListenerOptions | undefined)\n          : (configOrOptions as AddEventListenerOptions | undefined);\n\n      if ('attr' in config) {\n        for (const [key, value] of Object.entries(config.attr)) {\n          const name =\n            key.startsWith('aria-') || key === 'role'\n              ? key\n              : key.startsWith('aria')\n                ? `aria-${key.slice(4).toLowerCase()}`\n                : key;\n          const dispose = applyAttribute(el, name, value);\n\n          if (dispose) disposers.push(dispose);\n        }\n      }\n\n      if ('class' in config) {\n        disposers.push(applyClassMap(el, config.class));\n      }\n\n      if ('on' in config) {\n        for (const event of Object.keys(config.on) as Array<keyof typeof config.on>) {\n          const listener = config.on[event];\n\n          if (!listener) continue;\n\n          disposers.push(listen(el, event as string, listener as EventListener, options));\n        }\n      }\n\n      const cleanup = () => {\n        while (disposers.length > 0) disposers.pop()?.();\n      };\n\n      onCleanup(cleanup);\n\n      return cleanup;\n    },\n    el,\n    shadowRoot: el.shadowRoot as ShadowRoot,\n  };\n};\n\nfunction applyAttribute(host: HTMLElement, name: string, value: HostBindingValue): (() => void) | void {\n  if (typeof value === 'function') {\n    return effect(() => setAttr(host, name, (value as () => HostBindingValue)()));\n  } else {\n    setAttr(host, name, value);\n  }\n}\n\nfunction applyClassMap(host: HTMLElement, getter: () => Record<string, boolean>): () => void {\n  let prev = new Set<string>();\n\n  return effect(() => {\n    const next = new Set(\n      Object.entries(getter())\n        .filter(([, active]) => active)\n        .map(([cls]) => cls),\n    );\n\n    for (const cls of prev) if (!next.has(cls)) host.classList.remove(cls);\n    for (const cls of next) if (!prev.has(cls)) host.classList.add(cls);\n\n    prev = next;\n  });\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./core/internal.cjs`),t=require(`./core/runtime-lifecycle.cjs`),n=require(`./core/utilities.cjs`),r=require(`./core/host.cjs`),i=require(`./core/template.cjs`),a=require(`./core/component.cjs`),o=require(`./labs/observers.cjs`);exports.aria=t.aria,exports.createContext=r.createContext,exports.createFormIds=n.createFormIds,exports.createId=n.createId,exports.css=n.css,exports.defineComponent=a.defineComponent,exports.defineField=a.defineField,exports.effect=t.effect,exports.escapeHtml=n.escapeHtml,exports.fire=t.fire,exports.guard=n.guard,exports.handle=t.handle,exports.html=i.html,exports.inject=r.inject,exports.observeResize=o.observeResize,exports.onCleanup=t.onCleanup,exports.onError=t.onError,exports.onMount=t.onMount,exports.onSlotChange=r.onSlotChange,exports.prop=a.prop,exports.provide=r.provide,exports.ref=e.ref,exports.reflect=r.reflect,exports.refs=e.refs,exports.syncContextProps=r.syncContextProps,exports.toKebab=n.toKebab,exports.typed=a.typed,exports.watch=t.watch;var s=require(`@vielzeug/stateit`);Object.keys(s).forEach(function(e){e!==`default`&&!Object.prototype.hasOwnProperty.call(exports,e)&&Object.defineProperty(exports,e,{enumerable:!0,get:function(){return s[e]}})});
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./runtime-core.cjs`),t=require(`./runtime-lifecycle.cjs`),n=require(`./runtime.cjs`),r=require(`./internal.cjs`),i=require(`./form.cjs`),a=require(`./host.cjs`),o=require(`./template.cjs`),s=require(`./component.cjs`);let c=require(`@vielzeug/stateit`);Object.defineProperty(exports,`batch`,{enumerable:!0,get:function(){return c.batch}}),exports.bridgeContextAttributes=a.bridgeContextAttributes,Object.defineProperty(exports,`computed`,{enumerable:!0,get:function(){return c.computed}}),exports.createCleanupSignal=t.createCleanupSignal,exports.createContext=a.createContext,exports.createId=r.createId,exports.css=r.css,exports.currentRuntime=e.currentRuntime,exports.define=s.define,exports.defineField=i.defineField,exports.effect=t.effect,exports.fire=n.fire,exports.handle=t.handle,exports.html=o.html,exports.inject=a.inject,Object.defineProperty(exports,`isSignal`,{enumerable:!0,get:function(){return c.isSignal}}),exports.onCleanup=t.onCleanup,exports.onElement=t.onElement,exports.onError=t.onError,exports.onMount=t.onMount,Object.defineProperty(exports,`peekValue`,{enumerable:!0,get:function(){return c.peekValue}}),exports.provide=a.provide,Object.defineProperty(exports,`readonly`,{enumerable:!0,get:function(){return c.readonly}}),exports.ref=r.ref,exports.refs=r.refs,Object.defineProperty(exports,`signal`,{enumerable:!0,get:function(){return c.signal}}),exports.syncContextProps=a.syncContextProps,Object.defineProperty(exports,`toValue`,{enumerable:!0,get:function(){return c.toValue}}),Object.defineProperty(exports,`untrack`,{enumerable:!0,get:function(){return c.untrack}}),exports.watch=t.watch,Object.defineProperty(exports,`writable`,{enumerable:!0,get:function(){return c.writable}});

package/dist/index.d.ts

@@ -1,10 +1,9 @@
-export * from '@vielzeug/stateit';
-export { aria, effect, fire, handle, onCleanup, onError, onMount, watch } from './core/runtime-lifecycle';
-export { defineComponent, defineField, prop, typed, type BuildPropSchema, type DefineComponentOptions, type DefineComponentSetupContext, type FormFieldCallbacks, type FormFieldHandle, type FormFieldOptions, type InferPropsSignals, type PropDef, type PropOptions, } from './core/component';
-export { createContext, inject, onSlotChange, provide, syncContextProps, type InjectionKey, type Slots, } from './core/host';
-export { reflect, type HostBindingValue, type ReflectConfig } from './core/host';
-export { html, type KeyedNode } from './core/template';
-export { ref, refs, type Directive, type HTMLResult, type Ref, type RefCallback, type Refs } from './core/internal';
-export { createFormIds, createId, css, escapeHtml, guard, toKebab, type CSSResult, type EmitFn, } from './core/utilities';
-export { observeResize } from './labs/observers';
+export { batch, computed, isSignal, peekValue, readonly, signal, toValue, untrack, writable, type ReadonlySignal, type Signal, type WatchOptions, } from '@vielzeug/stateit';
+export { createCleanupSignal, effect, fire, handle, onCleanup, onElement, onError, onMount, watch, type HostEventListeners, type HostEventMap, } from './runtime';
+export { currentRuntime, type ComponentRuntime } from './runtime-core';
+export { define, type ComponentDefinition, type ComponentOptions, type ComponentSetupContext, type InferPropsSignals, type PropDef, type PropsInput, type PropOptions, } from './component';
+export { defineField, type FormFieldCallbacks, type FormFieldHandle, type FormFieldOptions } from './form';
+export { createContext, inject, provide, bridgeContextAttributes, syncContextProps, type ComponentHost, type ComponentSlots, type HostBindingValue, type InjectionKey, type ReflectConfig, type HostContextAttributeBridge, } from './host';
+export { html, type KeyedNode } from './template';
+export { css, createId, ref, refs, type CSSResult, type Directive, type EmitFn, type HTMLResult, type Ref, type RefCallback, type Refs, } from './internal';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAE1G,OAAO,EACL,eAAe,EACf,WAAW,EACX,IAAI,EACJ,KAAK,EACL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,MAAM,EACN,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,KAAK,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,GAAG,EAAE,KAAK,WAAW,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEpH,OAAO,EACL,aAAa,EACb,QAAQ,EACR,GAAG,EACH,UAAU,EACV,KAAK,EACL,OAAO,EACP,KAAK,SAAS,EACd,KAAK,MAAM,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,OAAO,EACP,QAAQ,EACR,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,MAAM,EACN,IAAI,EACJ,MAAM,EACN,SAAS,EACT,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EACL,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE3G,OAAO,EACL,aAAa,EACb,MAAM,EACN,OAAO,EACP,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,0BAA0B,GAChC,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,GAAG,EACH,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,IAAI,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1 +1 @@
-import{ref as e,refs as t}from"./core/internal.js";import{aria as n,effect as r,fire as i,handle as a,onCleanup as o,onError as s,onMount as c,watch as l}from"./core/runtime-lifecycle.js";import{createFormIds as u,createId as d,css as f,escapeHtml as p,guard as m,toKebab as h}from"./core/utilities.js";import{createContext as g,inject as _,onSlotChange as v,provide as y,reflect as b,syncContextProps as x}from"./core/host.js";import{html as S}from"./core/template.js";import{defineComponent as C,defineField as w,prop as T,typed as E}from"./core/component.js";import{observeResize as D}from"./labs/observers.js";export*from"@vielzeug/stateit";export{n as aria,g as createContext,u as createFormIds,d as createId,f as css,C as defineComponent,w as defineField,r as effect,p as escapeHtml,i as fire,m as guard,a as handle,S as html,_ as inject,D as observeResize,o as onCleanup,s as onError,c as onMount,v as onSlotChange,T as prop,y as provide,e as ref,b as reflect,t as refs,x as syncContextProps,h as toKebab,E as typed,l as watch};
+import{currentRuntime as e}from"./runtime-core.js";import{createCleanupSignal as t,effect as n,handle as r,onCleanup as i,onElement as a,onError as o,onMount as s,watch as c}from"./runtime-lifecycle.js";import{fire as l}from"./runtime.js";import{createId as u,css as d,ref as f,refs as p}from"./internal.js";import{defineField as m}from"./form.js";import{bridgeContextAttributes as h,createContext as g,inject as _,provide as v,syncContextProps as y}from"./host.js";import{html as b}from"./template.js";import{define as x}from"./component.js";import{batch as S,computed as C,isSignal as w,peekValue as T,readonly as E,signal as D,toValue as O,untrack as k,writable as A}from"@vielzeug/stateit";export{S as batch,h as bridgeContextAttributes,C as computed,t as createCleanupSignal,g as createContext,u as createId,d as css,e as currentRuntime,x as define,m as defineField,n as effect,l as fire,r as handle,b as html,_ as inject,w as isSignal,i as onCleanup,a as onElement,o as onError,s as onMount,T as peekValue,v as provide,E as readonly,f as ref,p as refs,D as signal,y as syncContextProps,O as toValue,k as untrack,c as watch,A as writable};

package/dist/internal.cjs

@@ -0,0 +1,2 @@
+const e=require(`./runtime-core.cjs`),t=require(`./runtime.cjs`);let n=require(`@vielzeug/stateit`);var r=Symbol(`craftit.htmlResultBrand`),i=0,a=()=>{i=0},o=e=>`${e?`${e}-`:`cft-`}${++i}`;function s(){return(0,n.signal)(null)}function c(){return[]}function l(e,t=[]){let n={__bindings:t,__html:e,toString(){return e}};return Object.defineProperty(n,r,{configurable:!1,enumerable:!1,value:!0,writable:!1}),n}var u=e=>typeof e==`object`&&!!e&&e[r]===!0;function d(e){return typeof e==`string`?{bindings:[],html:e}:{bindings:e.__bindings,html:e.__html}}var f=Symbol(`craftit.eachSignal`),p=e=>{let t=[...e];for(let e=t.length-1;e>=0;e--)t[e]?.()},m=(e,t,n)=>{if(/^on/i.test(t)){e.removeAttribute(t);return}n==null||n===!1?e.removeAttribute(t):n===!0?e.setAttribute(t,t.startsWith(`aria-`)?`true`:``):e.setAttribute(t,String(n))},h=(e,t,n,r)=>{let i=n;return e.addEventListener(t,i,r),()=>e.removeEventListener(t,i,r)},g=e=>e.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`),_={"'":`&#39;`,'"':`&quot;`,"&":`&amp;`,"<":`&lt;`,">":`&gt;`},v=e=>String(e).replace(/[&<>"']/g,e=>_[e]),y=()=>{let n=e.currentRuntime().el;return((e,...r)=>{t.fire.custom(n,String(e),r.length>0?{detail:r[0]}:void 0)})},b=function(){return this.content},x=(e,...t)=>{let n=``;for(let r=0;r<e.length;r++)if(n+=e[r],r<t.length){let e=t[r];n+=e&&typeof e==`object`&&`content`in e?e.content:e??``}return{content:n.trim(),toString:b}},S=new Map,C=e=>{if(e instanceof CSSStyleSheet)return e;let t=typeof e==`string`?e:e.content,n=S.get(t);if(n)return n;let r=new CSSStyleSheet;try{r.replaceSync(t),S.set(t,r)}catch(e){console.error(`[craftit:E2] style replace failed`,e)}return r};exports.EACH_SIGNAL=f,exports._resetIdCounter=a,exports.createEmitFn=y,exports.createId=o,exports.css=x,exports.escapeHtml=v,exports.extractResult=d,exports.htmlResult=l,exports.isHtmlResult=u,exports.listen=h,exports.loadStylesheet=C,exports.ref=s,exports.refs=c,exports.runAll=p,exports.setAttr=m,exports.toKebab=g;
+//# sourceMappingURL=internal.cjs.map

package/dist/internal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.cjs","names":[],"sources":["../src/internal.ts"],"sourcesContent":["/**\n * @internal — Binding type system, compiler/runtime helpers, and engine internals.\n *\n * These types and helpers define the contract between the template compiler, binding engine,\n * and component runtime.\n * They are NOT part of the public API and importing directly is an unstable contract.\n *\n * Selected author-facing exports (such as css(), CSSResult, EmitFn, HTMLResult, Directive,\n * ref(), and refs()) are re-exported from the main entry point.\n */\n\nimport { signal, type ReadonlySignal, type Signal } from '@vielzeug/stateit';\n\nimport { fire } from './runtime';\nimport { currentRuntime } from './runtime-core';\n\nconst HTML_RESULT_BRAND: unique symbol = Symbol('craftit.htmlResultBrand');\n\nlet _idCounter = 0;\n\n/** @internal — resets the ID counter. Used by _resetCounters in test/test.ts. */\nexport const _resetIdCounter = (): void => {\n  _idCounter = 0;\n};\n\n/**\n * Creates a unique, stable ID string — suitable for `aria-labelledby`, `aria-describedby`,\n * and similar accessibility linkages. Call once per component instance (at setup time or inside `onMount`).\n */\nexport const createId = (prefix?: string): string => `${prefix ? `${prefix}-` : 'cft-'}${++_idCounter}`;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// REF TYPES\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A reactive reference to a DOM element.\n *\n * Backed by a Signal — reactivity is built-in. Use with onElement()\n * for first-class element lifecycle management.\n *\n * @example\n * const inputRef = ref<HTMLInputElement>();\n *\n * onElement(inputRef, (input) => {\n *   input.focus();\n *   return () => { };  // cleanup\n * });\n *\n * // In template\n * <input ref=${inputRef} />\n */\nexport type Ref<T extends Element> = Signal<T | null>;\n\n/**\n * Create a reactive element reference.\n *\n * Returns a Signal that tracks the mounted/unmounted state of a DOM element.\n * Automatically reactive — use directly in effects or with onElement().\n *\n * @see onElement for element lifecycle integration\n *\n * @example\n * const ref = ref<HTMLInputElement>();\n * // Type: Signal<HTMLInputElement | null>\n * // Automatically updates when element mounts/unmounts\n */\nexport function ref<T extends Element>(): Ref<T> {\n  return signal<T | null>(null);\n}\n\nexport type Refs<T extends Element> = T[];\n\nexport function refs<T extends Element>(): Refs<T> {\n  return [];\n}\n\nexport type RefCallback<T extends Element> = (el: T | null) => void;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// HTML RESULT\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface HTMLResult {\n  __bindings: Binding[];\n  __html: string;\n  toString(): string;\n}\n\n/** @internal — construct an HTMLResult from a pre-built html string and bindings. */\nexport function htmlResult(html: string, bindings: Binding[] = []): HTMLResult {\n  const result = {\n    __bindings: bindings,\n    __html: html,\n    toString() {\n      return html;\n    },\n  };\n\n  Object.defineProperty(result, HTML_RESULT_BRAND, {\n    configurable: false,\n    enumerable: false,\n    value: true,\n    writable: false,\n  });\n\n  return result as HTMLResult;\n}\n\n/** @internal — strict HTMLResult runtime type guard. */\nexport const isHtmlResult = (value: unknown): value is HTMLResult =>\n  typeof value === 'object' && !!value && (value as Record<symbol, unknown>)[HTML_RESULT_BRAND] === true;\n\n/** @internal — extract html and bindings from a string or HTMLResult. */\nexport function extractResult(v: string | HTMLResult): { bindings: Binding[]; html: string } {\n  return typeof v === 'string' ? { bindings: [], html: v } : { bindings: v.__bindings, html: v.__html };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// DIRECTIVES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface DirectiveContext {\n  /** The cleanup registration function for the component. */\n  registerCleanup: (fn: () => void) => void;\n}\n\nexport interface Directive {\n  /** Invoked when the element is mounted in the DOM. */\n  mount?(el: HTMLElement, context: DirectiveContext): void;\n  /** Invoked by the template engine to render content (interpolation directives). */\n  render?(): HTMLResult | string;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// BINDING TYPES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport type TextBinding = {\n  signal: ReadonlySignal<unknown>;\n  type: 'text';\n  uid: string;\n};\n\nexport type AttrBinding = {\n  mode: 'bool' | 'attr';\n  name: string;\n  signal?: ReadonlySignal<unknown>;\n  type: 'attr';\n  uid: string;\n  value?: unknown;\n};\n\nexport type PropBinding = {\n  /** Optional writable source used for native two-way bridge (.value/.checked). */\n  model?: Signal<unknown>;\n  name: string;\n  signal?: ReadonlySignal<unknown>;\n  type: 'prop';\n  uid: string;\n  value?: unknown;\n};\n\nexport type EventBinding = {\n  handler: (e: Event) => void;\n  modifiers?: {\n    capture?: boolean;\n    once?: boolean;\n    passive?: boolean;\n    prevent?: boolean;\n    self?: boolean;\n    stop?: boolean;\n  };\n  name: string;\n  type: 'event';\n  uid: string;\n};\n\nexport type RefBinding = {\n  ref: Ref<Element> | Refs<Element> | RefCallback<Element>;\n  type: 'ref';\n  uid: string;\n};\n\nexport type CallbackBinding = {\n  apply: (el: HTMLElement, registerCleanup: (fn: () => void) => void) => void;\n  type: 'callback';\n  uid: string;\n};\n\nexport type HtmlBinding = {\n  keyed?: boolean;\n  signal: ReadonlySignal<{\n    bindings: Binding[];\n    html: string;\n    items?: Array<{ bindings: Binding[]; html: string }>;\n    keys?: (string | number)[];\n  }>;\n  type: 'html';\n  uid: string;\n};\n\nexport type Binding =\n  | TextBinding\n  | AttrBinding\n  | PropBinding\n  | EventBinding\n  | RefBinding\n  | CallbackBinding\n  | HtmlBinding;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL MARKERS & CONSTANTS\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** @internal — opaque marker for each() reactive results. */\nexport const EACH_SIGNAL: unique symbol = Symbol('craftit.eachSignal');\n\n/** @internal — binding element identifier attribute. */\nexport const CF_ID_ATTR = 'u';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL DOM & EVENT UTILITIES\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** @internal — Iterate an iterable and call every function in it. */\nexport const runAll = (fns: Iterable<() => void>): void => {\n  const callbacks = [...fns];\n\n  for (let index = callbacks.length - 1; index >= 0; index--) {\n    callbacks[index]?.();\n  }\n};\n\n/** @internal — Set an attribute on an element, handling boolean and null values. */\nexport const setAttr = (el: Element, name: string, val: unknown): void => {\n  // Avoid inline event-handler attributes (onclick, onerror, ...) to reduce injection risk.\n  if (/^on/i.test(name)) {\n    el.removeAttribute(name);\n\n    return;\n  }\n\n  if (val == null || val === false) {\n    el.removeAttribute(name);\n  } else if (val === true) {\n    el.setAttribute(name, name.startsWith('aria-') ? 'true' : '');\n  } else {\n    el.setAttribute(name, String(val));\n  }\n};\n\n/** @internal — Attach an event listener with automatic cleanup. */\nexport const listen = (\n  el: EventTarget,\n  name: string,\n  handler: (e: any) => void,\n  options?: AddEventListenerOptions,\n): (() => void) => {\n  const listener: EventListener = handler as EventListener;\n\n  el.addEventListener(name, listener, options);\n\n  return () => el.removeEventListener(name, listener, options);\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL STRING UTILITIES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const toKebab = (str: string): string => str.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);\n\nconst ESC: Record<string, string> = { \"'\": '&#39;', '\"': '&quot;', '&': '&amp;', '<': '&lt;', '>': '&gt;' };\n\n/** @internal — Escape untrusted text for HTML text/attribute contexts. */\nexport const escapeHtml = (value: unknown): string => String(value).replace(/[&<>\"']/g, (c) => ESC[c]);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL EMIT TYPES & HELPERS\n// ─────────────────────────────────────────────────────────────────────────────\n\ntype NoDetail = void | undefined | never;\ntype KeysWithoutDetail<T extends Record<string, unknown>> = {\n  [P in keyof T]: [T[P]] extends [NoDetail] ? P : never;\n}[keyof T];\n\nexport type EmitFn<T extends Record<string, unknown>> = {\n  <K extends KeysWithoutDetail<T>>(event: K): void;\n  <K extends Exclude<keyof T, KeysWithoutDetail<T>>>(event: K, detail: T[K]): void;\n};\n\n/** @internal — Create a type-safe custom event emitter for the current runtime host. */\nexport const createEmitFn = <T extends Record<string, unknown>>(): EmitFn<T> => {\n  const el = currentRuntime().el;\n\n  return ((event: keyof T, ...rest: unknown[]) => {\n    fire.custom(el, String(event), rest.length > 0 ? { detail: rest[0] } : undefined);\n  }) as EmitFn<T>;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL CSS & STYLESHEET UTILITIES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport type CSSResult = {\n  content: string;\n  toString(): string;\n};\n\nconst cssResultToString = function (this: CSSResult): string {\n  return this.content;\n};\n\n/** @internal — Compile CSS template strings into a CSSResult. */\nexport const css = (strings: TemplateStringsArray, ...values: unknown[]): CSSResult => {\n  let content = '';\n\n  for (let i = 0; i < strings.length; i++) {\n    content += strings[i];\n\n    if (i < values.length) {\n      const v = values[i];\n\n      content += v && typeof v === 'object' && 'content' in v ? (v as CSSResult).content : (v ?? '');\n    }\n  }\n\n  return { content: content.trim(), toString: cssResultToString };\n};\n\nconst stylesheetStringCache = new Map<string, CSSStyleSheet>();\n\n/** @internal — Load a stylesheet string or CSSResult into an adoptedStyleSheet. */\nexport const loadStylesheet = (style: string | CSSStyleSheet | CSSResult): CSSStyleSheet => {\n  if (style instanceof CSSStyleSheet) return style;\n\n  const cssText = typeof style === 'string' ? style : style.content;\n  const cached = stylesheetStringCache.get(cssText);\n\n  if (cached) return cached;\n\n  const sheet = new CSSStyleSheet();\n\n  try {\n    sheet.replaceSync(cssText);\n    stylesheetStringCache.set(cssText, sheet);\n  } catch (err) {\n    console.error(`[craftit:E2] style replace failed`, err);\n  }\n\n  return sheet;\n};\n"],"mappings":"oGAgBA,IAAM,EAAmC,OAAO,0BAA0B,CAEtE,EAAa,EAGJ,MAA8B,CACzC,EAAa,GAOF,EAAY,GAA4B,GAAG,EAAS,GAAG,EAAO,GAAK,SAAS,EAAE,IAsC3F,SAAgB,GAAiC,CAC/C,OAAA,EAAA,EAAA,QAAwB,KAAK,CAK/B,SAAgB,GAAmC,CACjD,MAAO,EAAE,CAgBX,SAAgB,EAAW,EAAc,EAAsB,EAAE,CAAc,CAC7E,IAAM,EAAS,CACb,WAAY,EACZ,OAAQ,EACR,UAAW,CACT,OAAO,GAEV,CASD,OAPA,OAAO,eAAe,EAAQ,EAAmB,CAC/C,aAAc,GACd,WAAY,GACZ,MAAO,GACP,SAAU,GACX,CAAC,CAEK,EAIT,IAAa,EAAgB,GAC3B,OAAO,GAAU,UAAY,CAAC,CAAC,GAAU,EAAkC,KAAuB,GAGpG,SAAgB,EAAc,EAA+D,CAC3F,OAAO,OAAO,GAAM,SAAW,CAAE,SAAU,EAAE,CAAE,KAAM,EAAG,CAAG,CAAE,SAAU,EAAE,WAAY,KAAM,EAAE,OAAQ,CAqGvG,IAAa,EAA6B,OAAO,qBAAqB,CAUzD,EAAU,GAAoC,CACzD,IAAM,EAAY,CAAC,GAAG,EAAI,CAE1B,IAAK,IAAI,EAAQ,EAAU,OAAS,EAAG,GAAS,EAAG,IACjD,EAAU,MAAU,EAKX,GAAW,EAAa,EAAc,IAAuB,CAExE,GAAI,OAAO,KAAK,EAAK,CAAE,CACrB,EAAG,gBAAgB,EAAK,CAExB,OAGE,GAAO,MAAQ,IAAQ,GACzB,EAAG,gBAAgB,EAAK,CACf,IAAQ,GACjB,EAAG,aAAa,EAAM,EAAK,WAAW,QAAQ,CAAG,OAAS,GAAG,CAE7D,EAAG,aAAa,EAAM,OAAO,EAAI,CAAC,EAKzB,GACX,EACA,EACA,EACA,IACiB,CACjB,IAAM,EAA0B,EAIhC,OAFA,EAAG,iBAAiB,EAAM,EAAU,EAAQ,KAE/B,EAAG,oBAAoB,EAAM,EAAU,EAAQ,EAOjD,EAAW,GAAwB,EAAI,QAAQ,SAAW,GAAM,IAAI,EAAE,aAAa,GAAG,CAE7F,EAA8B,CAAE,IAAK,QAAS,IAAK,SAAU,IAAK,QAAS,IAAK,OAAQ,IAAK,OAAQ,CAG9F,EAAc,GAA2B,OAAO,EAAM,CAAC,QAAQ,WAAa,GAAM,EAAI,GAAG,CAiBzF,MAAmE,CAC9E,IAAM,EAAK,EAAA,gBAAgB,CAAC,GAE5B,QAAS,EAAgB,GAAG,IAAoB,CAC9C,EAAA,KAAK,OAAO,EAAI,OAAO,EAAM,CAAE,EAAK,OAAS,EAAI,CAAE,OAAQ,EAAK,GAAI,CAAG,IAAA,GAAU,IAa/E,EAAoB,UAAmC,CAC3D,OAAO,KAAK,SAID,GAAO,EAA+B,GAAG,IAAiC,CACrF,IAAI,EAAU,GAEd,IAAK,IAAI,EAAI,EAAG,EAAI,EAAQ,OAAQ,IAGlC,GAFA,GAAW,EAAQ,GAEf,EAAI,EAAO,OAAQ,CACrB,IAAM,EAAI,EAAO,GAEjB,GAAW,GAAK,OAAO,GAAM,UAAY,YAAa,EAAK,EAAgB,QAAW,GAAK,GAI/F,MAAO,CAAE,QAAS,EAAQ,MAAM,CAAE,SAAU,EAAmB,EAG3D,EAAwB,IAAI,IAGrB,EAAkB,GAA6D,CAC1F,GAAI,aAAiB,cAAe,OAAO,EAE3C,IAAM,EAAU,OAAO,GAAU,SAAW,EAAQ,EAAM,QACpD,EAAS,EAAsB,IAAI,EAAQ,CAEjD,GAAI,EAAQ,OAAO,EAEnB,IAAM,EAAQ,IAAI,cAElB,GAAI,CACF,EAAM,YAAY,EAAQ,CAC1B,EAAsB,IAAI,EAAS,EAAM,OAClC,EAAK,CACZ,QAAQ,MAAM,oCAAqC,EAAI,CAGzD,OAAO"}

package/dist/internal.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @internal — Binding type system, compiler/runtime helpers, and engine internals.
+ *
+ * These types and helpers define the contract between the template compiler, binding engine,
+ * and component runtime.
+ * They are NOT part of the public API and importing directly is an unstable contract.
+ *
+ * Selected author-facing exports (such as css(), CSSResult, EmitFn, HTMLResult, Directive,
+ * ref(), and refs()) are re-exported from the main entry point.
+ */
+import { type ReadonlySignal, type Signal } from '@vielzeug/stateit';
+/** @internal — resets the ID counter. Used by _resetCounters in test/test.ts. */
+export declare const _resetIdCounter: () => void;
+/**
+ * Creates a unique, stable ID string — suitable for `aria-labelledby`, `aria-describedby`,
+ * and similar accessibility linkages. Call once per component instance (at setup time or inside `onMount`).
+ */
+export declare const createId: (prefix?: string) => string;
+/**
+ * A reactive reference to a DOM element.
+ *
+ * Backed by a Signal — reactivity is built-in. Use with onElement()
+ * for first-class element lifecycle management.
+ *
+ * @example
+ * const inputRef = ref<HTMLInputElement>();
+ *
+ * onElement(inputRef, (input) => {
+ *   input.focus();
+ *   return () => { };  // cleanup
+ * });
+ *
+ * // In template
+ * <input ref=${inputRef} />
+ */
+export type Ref<T extends Element> = Signal<T | null>;
+/**
+ * Create a reactive element reference.
+ *
+ * Returns a Signal that tracks the mounted/unmounted state of a DOM element.
+ * Automatically reactive — use directly in effects or with onElement().
+ *
+ * @see onElement for element lifecycle integration
+ *
+ * @example
+ * const ref = ref<HTMLInputElement>();
+ * // Type: Signal<HTMLInputElement | null>
+ * // Automatically updates when element mounts/unmounts
+ */
+export declare function ref<T extends Element>(): Ref<T>;
+export type Refs<T extends Element> = T[];
+export declare function refs<T extends Element>(): Refs<T>;
+export type RefCallback<T extends Element> = (el: T | null) => void;
+export interface HTMLResult {
+    __bindings: Binding[];
+    __html: string;
+    toString(): string;
+}
+/** @internal — construct an HTMLResult from a pre-built html string and bindings. */
+export declare function htmlResult(html: string, bindings?: Binding[]): HTMLResult;
+/** @internal — strict HTMLResult runtime type guard. */
+export declare const isHtmlResult: (value: unknown) => value is HTMLResult;
+/** @internal — extract html and bindings from a string or HTMLResult. */
+export declare function extractResult(v: string | HTMLResult): {
+    bindings: Binding[];
+    html: string;
+};
+export interface DirectiveContext {
+    /** The cleanup registration function for the component. */
+    registerCleanup: (fn: () => void) => void;
+}
+export interface Directive {
+    /** Invoked when the element is mounted in the DOM. */
+    mount?(el: HTMLElement, context: DirectiveContext): void;
+    /** Invoked by the template engine to render content (interpolation directives). */
+    render?(): HTMLResult | string;
+}
+export type TextBinding = {
+    signal: ReadonlySignal<unknown>;
+    type: 'text';
+    uid: string;
+};
+export type AttrBinding = {
+    mode: 'bool' | 'attr';
+    name: string;
+    signal?: ReadonlySignal<unknown>;
+    type: 'attr';
+    uid: string;
+    value?: unknown;
+};
+export type PropBinding = {
+    /** Optional writable source used for native two-way bridge (.value/.checked). */
+    model?: Signal<unknown>;
+    name: string;
+    signal?: ReadonlySignal<unknown>;
+    type: 'prop';
+    uid: string;
+    value?: unknown;
+};
+export type EventBinding = {
+    handler: (e: Event) => void;
+    modifiers?: {
+        capture?: boolean;
+        once?: boolean;
+        passive?: boolean;
+        prevent?: boolean;
+        self?: boolean;
+        stop?: boolean;
+    };
+    name: string;
+    type: 'event';
+    uid: string;
+};
+export type RefBinding = {
+    ref: Ref<Element> | Refs<Element> | RefCallback<Element>;
+    type: 'ref';
+    uid: string;
+};
+export type CallbackBinding = {
+    apply: (el: HTMLElement, registerCleanup: (fn: () => void) => void) => void;
+    type: 'callback';
+    uid: string;
+};
+export type HtmlBinding = {
+    keyed?: boolean;
+    signal: ReadonlySignal<{
+        bindings: Binding[];
+        html: string;
+        items?: Array<{
+            bindings: Binding[];
+            html: string;
+        }>;
+        keys?: (string | number)[];
+    }>;
+    type: 'html';
+    uid: string;
+};
+export type Binding = TextBinding | AttrBinding | PropBinding | EventBinding | RefBinding | CallbackBinding | HtmlBinding;
+/** @internal — opaque marker for each() reactive results. */
+export declare const EACH_SIGNAL: unique symbol;
+/** @internal — binding element identifier attribute. */
+export declare const CF_ID_ATTR = "u";
+/** @internal — Iterate an iterable and call every function in it. */
+export declare const runAll: (fns: Iterable<() => void>) => void;
+/** @internal — Set an attribute on an element, handling boolean and null values. */
+export declare const setAttr: (el: Element, name: string, val: unknown) => void;
+/** @internal — Attach an event listener with automatic cleanup. */
+export declare const listen: (el: EventTarget, name: string, handler: (e: any) => void, options?: AddEventListenerOptions) => (() => void);
+export declare const toKebab: (str: string) => string;
+/** @internal — Escape untrusted text for HTML text/attribute contexts. */
+export declare const escapeHtml: (value: unknown) => string;
+type NoDetail = void | undefined | never;
+type KeysWithoutDetail<T extends Record<string, unknown>> = {
+    [P in keyof T]: [T[P]] extends [NoDetail] ? P : never;
+}[keyof T];
+export type EmitFn<T extends Record<string, unknown>> = {
+    <K extends KeysWithoutDetail<T>>(event: K): void;
+    <K extends Exclude<keyof T, KeysWithoutDetail<T>>>(event: K, detail: T[K]): void;
+};
+/** @internal — Create a type-safe custom event emitter for the current runtime host. */
+export declare const createEmitFn: <T extends Record<string, unknown>>() => EmitFn<T>;
+export type CSSResult = {
+    content: string;
+    toString(): string;
+};
+/** @internal — Compile CSS template strings into a CSSResult. */
+export declare const css: (strings: TemplateStringsArray, ...values: unknown[]) => CSSResult;
+/** @internal — Load a stylesheet string or CSSResult into an adoptedStyleSheet. */
+export declare const loadStylesheet: (style: string | CSSStyleSheet | CSSResult) => CSSStyleSheet;
+export {};
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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"}

package/dist/internal.js

@@ -0,0 +1,2 @@
+import{currentRuntime as e}from"./runtime-core.js";import{fire as t}from"./runtime.js";import{signal as n}from"@vielzeug/stateit";var r=Symbol(`craftit.htmlResultBrand`),i=0,a=()=>{i=0},o=e=>`${e?`${e}-`:`cft-`}${++i}`;function s(){return n(null)}function c(){return[]}function l(e,t=[]){let n={__bindings:t,__html:e,toString(){return e}};return Object.defineProperty(n,r,{configurable:!1,enumerable:!1,value:!0,writable:!1}),n}var u=e=>typeof e==`object`&&!!e&&e[r]===!0;function d(e){return typeof e==`string`?{bindings:[],html:e}:{bindings:e.__bindings,html:e.__html}}var f=Symbol(`craftit.eachSignal`),p=e=>{let t=[...e];for(let e=t.length-1;e>=0;e--)t[e]?.()},m=(e,t,n)=>{if(/^on/i.test(t)){e.removeAttribute(t);return}n==null||n===!1?e.removeAttribute(t):n===!0?e.setAttribute(t,t.startsWith(`aria-`)?`true`:``):e.setAttribute(t,String(n))},h=(e,t,n,r)=>{let i=n;return e.addEventListener(t,i,r),()=>e.removeEventListener(t,i,r)},g=e=>e.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`),_={"'":`&#39;`,'"':`&quot;`,"&":`&amp;`,"<":`&lt;`,">":`&gt;`},v=e=>String(e).replace(/[&<>"']/g,e=>_[e]),y=()=>{let n=e().el;return((e,...r)=>{t.custom(n,String(e),r.length>0?{detail:r[0]}:void 0)})},b=function(){return this.content},x=(e,...t)=>{let n=``;for(let r=0;r<e.length;r++)if(n+=e[r],r<t.length){let e=t[r];n+=e&&typeof e==`object`&&`content`in e?e.content:e??``}return{content:n.trim(),toString:b}},S=new Map,C=e=>{if(e instanceof CSSStyleSheet)return e;let t=typeof e==`string`?e:e.content,n=S.get(t);if(n)return n;let r=new CSSStyleSheet;try{r.replaceSync(t),S.set(t,r)}catch(e){console.error(`[craftit:E2] style replace failed`,e)}return r};export{f as EACH_SIGNAL,a as _resetIdCounter,y as createEmitFn,o as createId,x as css,v as escapeHtml,d as extractResult,l as htmlResult,u as isHtmlResult,h as listen,C as loadStylesheet,s as ref,c as refs,p as runAll,m as setAttr,g as toKebab};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","names":[],"sources":["../src/internal.ts"],"sourcesContent":["/**\n * @internal — Binding type system, compiler/runtime helpers, and engine internals.\n *\n * These types and helpers define the contract between the template compiler, binding engine,\n * and component runtime.\n * They are NOT part of the public API and importing directly is an unstable contract.\n *\n * Selected author-facing exports (such as css(), CSSResult, EmitFn, HTMLResult, Directive,\n * ref(), and refs()) are re-exported from the main entry point.\n */\n\nimport { signal, type ReadonlySignal, type Signal } from '@vielzeug/stateit';\n\nimport { fire } from './runtime';\nimport { currentRuntime } from './runtime-core';\n\nconst HTML_RESULT_BRAND: unique symbol = Symbol('craftit.htmlResultBrand');\n\nlet _idCounter = 0;\n\n/** @internal — resets the ID counter. Used by _resetCounters in test/test.ts. */\nexport const _resetIdCounter = (): void => {\n  _idCounter = 0;\n};\n\n/**\n * Creates a unique, stable ID string — suitable for `aria-labelledby`, `aria-describedby`,\n * and similar accessibility linkages. Call once per component instance (at setup time or inside `onMount`).\n */\nexport const createId = (prefix?: string): string => `${prefix ? `${prefix}-` : 'cft-'}${++_idCounter}`;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// REF TYPES\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * A reactive reference to a DOM element.\n *\n * Backed by a Signal — reactivity is built-in. Use with onElement()\n * for first-class element lifecycle management.\n *\n * @example\n * const inputRef = ref<HTMLInputElement>();\n *\n * onElement(inputRef, (input) => {\n *   input.focus();\n *   return () => { };  // cleanup\n * });\n *\n * // In template\n * <input ref=${inputRef} />\n */\nexport type Ref<T extends Element> = Signal<T | null>;\n\n/**\n * Create a reactive element reference.\n *\n * Returns a Signal that tracks the mounted/unmounted state of a DOM element.\n * Automatically reactive — use directly in effects or with onElement().\n *\n * @see onElement for element lifecycle integration\n *\n * @example\n * const ref = ref<HTMLInputElement>();\n * // Type: Signal<HTMLInputElement | null>\n * // Automatically updates when element mounts/unmounts\n */\nexport function ref<T extends Element>(): Ref<T> {\n  return signal<T | null>(null);\n}\n\nexport type Refs<T extends Element> = T[];\n\nexport function refs<T extends Element>(): Refs<T> {\n  return [];\n}\n\nexport type RefCallback<T extends Element> = (el: T | null) => void;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// HTML RESULT\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface HTMLResult {\n  __bindings: Binding[];\n  __html: string;\n  toString(): string;\n}\n\n/** @internal — construct an HTMLResult from a pre-built html string and bindings. */\nexport function htmlResult(html: string, bindings: Binding[] = []): HTMLResult {\n  const result = {\n    __bindings: bindings,\n    __html: html,\n    toString() {\n      return html;\n    },\n  };\n\n  Object.defineProperty(result, HTML_RESULT_BRAND, {\n    configurable: false,\n    enumerable: false,\n    value: true,\n    writable: false,\n  });\n\n  return result as HTMLResult;\n}\n\n/** @internal — strict HTMLResult runtime type guard. */\nexport const isHtmlResult = (value: unknown): value is HTMLResult =>\n  typeof value === 'object' && !!value && (value as Record<symbol, unknown>)[HTML_RESULT_BRAND] === true;\n\n/** @internal — extract html and bindings from a string or HTMLResult. */\nexport function extractResult(v: string | HTMLResult): { bindings: Binding[]; html: string } {\n  return typeof v === 'string' ? { bindings: [], html: v } : { bindings: v.__bindings, html: v.__html };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// DIRECTIVES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface DirectiveContext {\n  /** The cleanup registration function for the component. */\n  registerCleanup: (fn: () => void) => void;\n}\n\nexport interface Directive {\n  /** Invoked when the element is mounted in the DOM. */\n  mount?(el: HTMLElement, context: DirectiveContext): void;\n  /** Invoked by the template engine to render content (interpolation directives). */\n  render?(): HTMLResult | string;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// BINDING TYPES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport type TextBinding = {\n  signal: ReadonlySignal<unknown>;\n  type: 'text';\n  uid: string;\n};\n\nexport type AttrBinding = {\n  mode: 'bool' | 'attr';\n  name: string;\n  signal?: ReadonlySignal<unknown>;\n  type: 'attr';\n  uid: string;\n  value?: unknown;\n};\n\nexport type PropBinding = {\n  /** Optional writable source used for native two-way bridge (.value/.checked). */\n  model?: Signal<unknown>;\n  name: string;\n  signal?: ReadonlySignal<unknown>;\n  type: 'prop';\n  uid: string;\n  value?: unknown;\n};\n\nexport type EventBinding = {\n  handler: (e: Event) => void;\n  modifiers?: {\n    capture?: boolean;\n    once?: boolean;\n    passive?: boolean;\n    prevent?: boolean;\n    self?: boolean;\n    stop?: boolean;\n  };\n  name: string;\n  type: 'event';\n  uid: string;\n};\n\nexport type RefBinding = {\n  ref: Ref<Element> | Refs<Element> | RefCallback<Element>;\n  type: 'ref';\n  uid: string;\n};\n\nexport type CallbackBinding = {\n  apply: (el: HTMLElement, registerCleanup: (fn: () => void) => void) => void;\n  type: 'callback';\n  uid: string;\n};\n\nexport type HtmlBinding = {\n  keyed?: boolean;\n  signal: ReadonlySignal<{\n    bindings: Binding[];\n    html: string;\n    items?: Array<{ bindings: Binding[]; html: string }>;\n    keys?: (string | number)[];\n  }>;\n  type: 'html';\n  uid: string;\n};\n\nexport type Binding =\n  | TextBinding\n  | AttrBinding\n  | PropBinding\n  | EventBinding\n  | RefBinding\n  | CallbackBinding\n  | HtmlBinding;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL MARKERS & CONSTANTS\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** @internal — opaque marker for each() reactive results. */\nexport const EACH_SIGNAL: unique symbol = Symbol('craftit.eachSignal');\n\n/** @internal — binding element identifier attribute. */\nexport const CF_ID_ATTR = 'u';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL DOM & EVENT UTILITIES\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** @internal — Iterate an iterable and call every function in it. */\nexport const runAll = (fns: Iterable<() => void>): void => {\n  const callbacks = [...fns];\n\n  for (let index = callbacks.length - 1; index >= 0; index--) {\n    callbacks[index]?.();\n  }\n};\n\n/** @internal — Set an attribute on an element, handling boolean and null values. */\nexport const setAttr = (el: Element, name: string, val: unknown): void => {\n  // Avoid inline event-handler attributes (onclick, onerror, ...) to reduce injection risk.\n  if (/^on/i.test(name)) {\n    el.removeAttribute(name);\n\n    return;\n  }\n\n  if (val == null || val === false) {\n    el.removeAttribute(name);\n  } else if (val === true) {\n    el.setAttribute(name, name.startsWith('aria-') ? 'true' : '');\n  } else {\n    el.setAttribute(name, String(val));\n  }\n};\n\n/** @internal — Attach an event listener with automatic cleanup. */\nexport const listen = (\n  el: EventTarget,\n  name: string,\n  handler: (e: any) => void,\n  options?: AddEventListenerOptions,\n): (() => void) => {\n  const listener: EventListener = handler as EventListener;\n\n  el.addEventListener(name, listener, options);\n\n  return () => el.removeEventListener(name, listener, options);\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL STRING UTILITIES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const toKebab = (str: string): string => str.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);\n\nconst ESC: Record<string, string> = { \"'\": '&#39;', '\"': '&quot;', '&': '&amp;', '<': '&lt;', '>': '&gt;' };\n\n/** @internal — Escape untrusted text for HTML text/attribute contexts. */\nexport const escapeHtml = (value: unknown): string => String(value).replace(/[&<>\"']/g, (c) => ESC[c]);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL EMIT TYPES & HELPERS\n// ─────────────────────────────────────────────────────────────────────────────\n\ntype NoDetail = void | undefined | never;\ntype KeysWithoutDetail<T extends Record<string, unknown>> = {\n  [P in keyof T]: [T[P]] extends [NoDetail] ? P : never;\n}[keyof T];\n\nexport type EmitFn<T extends Record<string, unknown>> = {\n  <K extends KeysWithoutDetail<T>>(event: K): void;\n  <K extends Exclude<keyof T, KeysWithoutDetail<T>>>(event: K, detail: T[K]): void;\n};\n\n/** @internal — Create a type-safe custom event emitter for the current runtime host. */\nexport const createEmitFn = <T extends Record<string, unknown>>(): EmitFn<T> => {\n  const el = currentRuntime().el;\n\n  return ((event: keyof T, ...rest: unknown[]) => {\n    fire.custom(el, String(event), rest.length > 0 ? { detail: rest[0] } : undefined);\n  }) as EmitFn<T>;\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// INTERNAL CSS & STYLESHEET UTILITIES\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport type CSSResult = {\n  content: string;\n  toString(): string;\n};\n\nconst cssResultToString = function (this: CSSResult): string {\n  return this.content;\n};\n\n/** @internal — Compile CSS template strings into a CSSResult. */\nexport const css = (strings: TemplateStringsArray, ...values: unknown[]): CSSResult => {\n  let content = '';\n\n  for (let i = 0; i < strings.length; i++) {\n    content += strings[i];\n\n    if (i < values.length) {\n      const v = values[i];\n\n      content += v && typeof v === 'object' && 'content' in v ? (v as CSSResult).content : (v ?? '');\n    }\n  }\n\n  return { content: content.trim(), toString: cssResultToString };\n};\n\nconst stylesheetStringCache = new Map<string, CSSStyleSheet>();\n\n/** @internal — Load a stylesheet string or CSSResult into an adoptedStyleSheet. */\nexport const loadStylesheet = (style: string | CSSStyleSheet | CSSResult): CSSStyleSheet => {\n  if (style instanceof CSSStyleSheet) return style;\n\n  const cssText = typeof style === 'string' ? style : style.content;\n  const cached = stylesheetStringCache.get(cssText);\n\n  if (cached) return cached;\n\n  const sheet = new CSSStyleSheet();\n\n  try {\n    sheet.replaceSync(cssText);\n    stylesheetStringCache.set(cssText, sheet);\n  } catch (err) {\n    console.error(`[craftit:E2] style replace failed`, err);\n  }\n\n  return sheet;\n};\n"],"mappings":"kIAgBA,IAAM,EAAmC,OAAO,0BAA0B,CAEtE,EAAa,EAGJ,MAA8B,CACzC,EAAa,GAOF,EAAY,GAA4B,GAAG,EAAS,GAAG,EAAO,GAAK,SAAS,EAAE,IAsC3F,SAAgB,GAAiC,CAC/C,OAAO,EAAiB,KAAK,CAK/B,SAAgB,GAAmC,CACjD,MAAO,EAAE,CAgBX,SAAgB,EAAW,EAAc,EAAsB,EAAE,CAAc,CAC7E,IAAM,EAAS,CACb,WAAY,EACZ,OAAQ,EACR,UAAW,CACT,OAAO,GAEV,CASD,OAPA,OAAO,eAAe,EAAQ,EAAmB,CAC/C,aAAc,GACd,WAAY,GACZ,MAAO,GACP,SAAU,GACX,CAAC,CAEK,EAIT,IAAa,EAAgB,GAC3B,OAAO,GAAU,UAAY,CAAC,CAAC,GAAU,EAAkC,KAAuB,GAGpG,SAAgB,EAAc,EAA+D,CAC3F,OAAO,OAAO,GAAM,SAAW,CAAE,SAAU,EAAE,CAAE,KAAM,EAAG,CAAG,CAAE,SAAU,EAAE,WAAY,KAAM,EAAE,OAAQ,CAqGvG,IAAa,EAA6B,OAAO,qBAAqB,CAUzD,EAAU,GAAoC,CACzD,IAAM,EAAY,CAAC,GAAG,EAAI,CAE1B,IAAK,IAAI,EAAQ,EAAU,OAAS,EAAG,GAAS,EAAG,IACjD,EAAU,MAAU,EAKX,GAAW,EAAa,EAAc,IAAuB,CAExE,GAAI,OAAO,KAAK,EAAK,CAAE,CACrB,EAAG,gBAAgB,EAAK,CAExB,OAGE,GAAO,MAAQ,IAAQ,GACzB,EAAG,gBAAgB,EAAK,CACf,IAAQ,GACjB,EAAG,aAAa,EAAM,EAAK,WAAW,QAAQ,CAAG,OAAS,GAAG,CAE7D,EAAG,aAAa,EAAM,OAAO,EAAI,CAAC,EAKzB,GACX,EACA,EACA,EACA,IACiB,CACjB,IAAM,EAA0B,EAIhC,OAFA,EAAG,iBAAiB,EAAM,EAAU,EAAQ,KAE/B,EAAG,oBAAoB,EAAM,EAAU,EAAQ,EAOjD,EAAW,GAAwB,EAAI,QAAQ,SAAW,GAAM,IAAI,EAAE,aAAa,GAAG,CAE7F,EAA8B,CAAE,IAAK,QAAS,IAAK,SAAU,IAAK,QAAS,IAAK,OAAQ,IAAK,OAAQ,CAG9F,EAAc,GAA2B,OAAO,EAAM,CAAC,QAAQ,WAAa,GAAM,EAAI,GAAG,CAiBzF,MAAmE,CAC9E,IAAM,EAAK,GAAgB,CAAC,GAE5B,QAAS,EAAgB,GAAG,IAAoB,CAC9C,EAAK,OAAO,EAAI,OAAO,EAAM,CAAE,EAAK,OAAS,EAAI,CAAE,OAAQ,EAAK,GAAI,CAAG,IAAA,GAAU,IAa/E,EAAoB,UAAmC,CAC3D,OAAO,KAAK,SAID,GAAO,EAA+B,GAAG,IAAiC,CACrF,IAAI,EAAU,GAEd,IAAK,IAAI,EAAI,EAAG,EAAI,EAAQ,OAAQ,IAGlC,GAFA,GAAW,EAAQ,GAEf,EAAI,EAAO,OAAQ,CACrB,IAAM,EAAI,EAAO,GAEjB,GAAW,GAAK,OAAO,GAAM,UAAY,YAAa,EAAK,EAAgB,QAAW,GAAK,GAI/F,MAAO,CAAE,QAAS,EAAQ,MAAM,CAAE,SAAU,EAAmB,EAG3D,EAAwB,IAAI,IAGrB,EAAkB,GAA6D,CAC1F,GAAI,aAAiB,cAAe,OAAO,EAE3C,IAAM,EAAU,OAAO,GAAU,SAAW,EAAQ,EAAM,QACpD,EAAS,EAAsB,IAAI,EAAQ,CAEjD,GAAI,EAAQ,OAAO,EAEnB,IAAM,EAAQ,IAAI,cAElB,GAAI,CACF,EAAM,YAAY,EAAQ,CAC1B,EAAsB,IAAI,EAAS,EAAM,OAClC,EAAK,CACZ,QAAQ,MAAM,oCAAqC,EAAI,CAGzD,OAAO"}

package/dist/observers/index.d.ts

@@ -0,0 +1,4 @@
+export { intersectionObserver } from './intersection-observe';
+export { mediaObserver } from './media-observe';
+export { resizeObserver } from './resize-observe';
+//# sourceMappingURL=index.d.ts.map

package/dist/observers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/observers/intersection-observe.cjs

@@ -0,0 +1,2 @@
+const e=require(`../runtime-lifecycle.cjs`);let t=require(`@vielzeug/stateit`);var n=(n,r)=>{let i=(0,t.signal)(null),a=new IntersectionObserver(([e])=>{e&&(i.value=e)},r);return a.observe(n),e.onCleanup(()=>a.disconnect()),i};exports.intersectionObserver=n;
+//# sourceMappingURL=intersection-observe.cjs.map

package/dist/observers/intersection-observe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intersection-observe.cjs","names":[],"sources":["../../src/observers/intersection-observe.ts"],"sourcesContent":["import { signal, type ReadonlySignal } from '@vielzeug/stateit';\n\nimport { onCleanup } from '../runtime-lifecycle';\n\n/**\n * Observes an element's intersection with the viewport (or a given root) via\n * `IntersectionObserver`. Returns a `ReadonlySignal` that updates whenever the\n * intersection ratio changes.\n * Must be called inside an {@link onMount} callback.\n */\nexport const intersectionObserver = (\n  el: Element,\n  options?: IntersectionObserverInit,\n): ReadonlySignal<IntersectionObserverEntry | null> => {\n  const entry = signal<IntersectionObserverEntry | null>(null);\n  const io = new IntersectionObserver(([nextEntry]) => {\n    if (nextEntry) entry.value = nextEntry;\n  }, options);\n\n  io.observe(el);\n  onCleanup(() => io.disconnect());\n\n  return entry;\n};\n"],"mappings":"+EAUA,IAAa,GACX,EACA,IACqD,CACrD,IAAM,GAAA,EAAA,EAAA,QAAiD,KAAK,CACtD,EAAK,IAAI,sBAAsB,CAAC,KAAe,CAC/C,IAAW,EAAM,MAAQ,IAC5B,EAAQ,CAKX,OAHA,EAAG,QAAQ,EAAG,CACd,EAAA,cAAgB,EAAG,YAAY,CAAC,CAEzB"}

package/dist/observers/intersection-observe.d.ts

@@ -0,0 +1,9 @@
+import { type ReadonlySignal } from '@vielzeug/stateit';
+/**
+ * Observes an element's intersection with the viewport (or a given root) via
+ * `IntersectionObserver`. Returns a `ReadonlySignal` that updates whenever the
+ * intersection ratio changes.
+ * Must be called inside an {@link onMount} callback.
+ */
+export declare const intersectionObserver: (el: Element, options?: IntersectionObserverInit) => ReadonlySignal<IntersectionObserverEntry | null>;
+//# sourceMappingURL=intersection-observe.d.ts.map

package/dist/observers/intersection-observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intersection-observe.d.ts","sourceRoot":"","sources":["../../src/observers/intersection-observe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,IAAI,OAAO,EACX,UAAU,wBAAwB,KACjC,cAAc,CAAC,yBAAyB,GAAG,IAAI,CAUjD,CAAC"}

package/dist/observers/intersection-observe.js

@@ -0,0 +1,2 @@
+import{onCleanup as e}from"../runtime-lifecycle.js";import{signal as t}from"@vielzeug/stateit";var n=(n,r)=>{let i=t(null),a=new IntersectionObserver(([e])=>{e&&(i.value=e)},r);return a.observe(n),e(()=>a.disconnect()),i};export{n as intersectionObserver};
+//# sourceMappingURL=intersection-observe.js.map

package/dist/observers/intersection-observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intersection-observe.js","names":[],"sources":["../../src/observers/intersection-observe.ts"],"sourcesContent":["import { signal, type ReadonlySignal } from '@vielzeug/stateit';\n\nimport { onCleanup } from '../runtime-lifecycle';\n\n/**\n * Observes an element's intersection with the viewport (or a given root) via\n * `IntersectionObserver`. Returns a `ReadonlySignal` that updates whenever the\n * intersection ratio changes.\n * Must be called inside an {@link onMount} callback.\n */\nexport const intersectionObserver = (\n  el: Element,\n  options?: IntersectionObserverInit,\n): ReadonlySignal<IntersectionObserverEntry | null> => {\n  const entry = signal<IntersectionObserverEntry | null>(null);\n  const io = new IntersectionObserver(([nextEntry]) => {\n    if (nextEntry) entry.value = nextEntry;\n  }, options);\n\n  io.observe(el);\n  onCleanup(() => io.disconnect());\n\n  return entry;\n};\n"],"mappings":"+FAUA,IAAa,GACX,EACA,IACqD,CACrD,IAAM,EAAQ,EAAyC,KAAK,CACtD,EAAK,IAAI,sBAAsB,CAAC,KAAe,CAC/C,IAAW,EAAM,MAAQ,IAC5B,EAAQ,CAKX,OAHA,EAAG,QAAQ,EAAG,CACd,MAAgB,EAAG,YAAY,CAAC,CAEzB"}

package/dist/observers/media-observe.cjs

@@ -0,0 +1,2 @@
+const e=require(`../runtime-lifecycle.cjs`);let t=require(`@vielzeug/stateit`);var n=n=>{let r=window.matchMedia(n),i=(0,t.signal)(r.matches),a=e=>{i.value=e.matches};return r.addEventListener(`change`,a),e.onCleanup(()=>r.removeEventListener(`change`,a)),i};exports.mediaObserver=n;
+//# sourceMappingURL=media-observe.cjs.map

package/dist/observers/media-observe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-observe.cjs","names":[],"sources":["../../src/observers/media-observe.ts"],"sourcesContent":["import { signal, type ReadonlySignal } from '@vielzeug/stateit';\n\nimport { onCleanup } from '../runtime-lifecycle';\n\n/**\n * Observes a CSS media query via `window.matchMedia`. Returns a `ReadonlySignal`\n * that is `true` when the query matches and `false` when it does not.\n * Must be called inside an {@link onMount} callback.\n */\nexport const mediaObserver = (query: string): ReadonlySignal<boolean> => {\n  const mql = window.matchMedia(query);\n  const matches = signal(mql.matches);\n  const handler = (e: MediaQueryListEvent) => {\n    matches.value = e.matches;\n  };\n\n  mql.addEventListener('change', handler);\n  onCleanup(() => mql.removeEventListener('change', handler));\n\n  return matches;\n};\n"],"mappings":"+EASA,IAAa,EAAiB,GAA2C,CACvE,IAAM,EAAM,OAAO,WAAW,EAAM,CAC9B,GAAA,EAAA,EAAA,QAAiB,EAAI,QAAQ,CAC7B,EAAW,GAA2B,CAC1C,EAAQ,MAAQ,EAAE,SAMpB,OAHA,EAAI,iBAAiB,SAAU,EAAQ,CACvC,EAAA,cAAgB,EAAI,oBAAoB,SAAU,EAAQ,CAAC,CAEpD"}

package/dist/observers/media-observe.d.ts

@@ -0,0 +1,8 @@
+import { type ReadonlySignal } from '@vielzeug/stateit';
+/**
+ * Observes a CSS media query via `window.matchMedia`. Returns a `ReadonlySignal`
+ * that is `true` when the query matches and `false` when it does not.
+ * Must be called inside an {@link onMount} callback.
+ */
+export declare const mediaObserver: (query: string) => ReadonlySignal<boolean>;
+//# sourceMappingURL=media-observe.d.ts.map

package/dist/observers/media-observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-observe.d.ts","sourceRoot":"","sources":["../../src/observers/media-observe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,cAAc,CAAC,OAAO,CAWnE,CAAC"}