microtags 0.0.0

package/LICENSE

@@ -0,0 +1,168 @@
+# Big Time Public License
+
+Version 2.0.2
+
+<https://bigtimelicense.com/versions/2.0.2>
+
+## Purpose
+
+These terms let you use and share this software for noncommercial purposes
+and in small business for free, while also guaranteeing that paid licenses
+for big businesses will be available on fair, reasonable, and
+nondiscriminatory terms.
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as
+both strict obligations and conditions to all your licenses.
+
+## Noncommercial Purposes
+
+You may use the software for any noncommercial purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of
+public knowledge, personal study, private entertainment, hobby projects,
+amateur pursuits, or religious observance, without any anticipated
+commercial application, count as use for noncommercial purposes.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public
+research organization, public safety or health organization, environmental
+protection organization, or government institution counts as use for
+noncommercial purposes, regardless of the source of funding or obligations
+resulting from the funding.
+
+## Small Business
+
+You may use the software for the benefit of your company if it meets all
+these criteria:
+
+1.  had fewer than 20 total individuals working as employees and
+    independent contractors at all times during the last tax year
+
+2.  earned less than $1,000,000 total revenue in the last tax year
+
+3.  received less than $1,000,000 total debt, equity, and other investment
+    in the last five tax years, counting investment in predecessor
+    companies that reorganized into, merged with, or spun out your company
+
+All dollar figures are United States dollars as of 2019.  Adjust for them
+inflation according to the United States Bureau of Labor Statistics'
+consumer price index for all urban consumers, United States city average,
+for all items, not seasonally adjusted, with 1982–1984=100 reference base.
+
+## Big Business
+
+You may use the software for the benefit of your company:
+
+1.  for 128 days after your company stops qualifying under
+    [Small Business](#small-business)
+
+2.  indefinitely, if the licensor or their legal successor does not offer
+fair, reasonable, and nondiscriminatory terms for a commercial license for
+the software within 32 days of [written request](#how-to-request) and
+negotiate in good faith to conclude a deal
+
+## How to Request
+
+If this software includes an address for the licensor or an agent of the
+licensor in a standard place, such as in documentation, software package
+metadata, or an "about" page or screen, try to request a fair commercial
+license at that address.  If this package includes both online and offline
+addresses, try online before offline.  If you can't deliver a request that
+way, or this software doesn't include any addressees, spend one hour online
+researching an address, recording all your searches and inquiries as you
+go, and try any addresses that you find.  If you can't find any addresses,
+or if those addresses also fail, that counts as failure to offer a fair
+commercial license by the licensor under [Big Business](#big-business).
+
+## Fair, Reasonable, and Nondiscriminatory Terms
+
+Fair, reasonable, and nondiscriminatory terms may license the software
+perpetually or for a term, and may or may not cover new versions of the
+software.  If the licensor advertises license terms and a pricing structure
+for generally available commercial licenses, the licensor proposes license
+terms and a price as advertised, and a customer not affiliated with the
+licensor has bought a commercial license for the software on substantially
+equivalent terms in the past year, the proposal is fair, reasonable, and
+nondiscriminatory.
+
+## Copyright License
+
+The licensor grants you a copyright license to do everything with the
+software that would otherwise infringe the licensor's copyright in it for
+any purpose allowed by these terms.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software
+from you also gets a copy of these terms or the URL for them above, as well
+as copies of any plain-text lines beginning with `Required Notice:` that
+the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Nick Thomas (https://nichoth.com)
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers
+patent claims the licensor can license, or becomes able to license, that
+you would infringe by using the software.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms
+do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses
+to anyone else, or prevent the licensor from granting licenses to anyone
+else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to
+infringement of any patent, your patent license for the software granted
+under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of
+these terms, or done anything with the software not covered by your
+licenses, your licenses can nonetheless continue if you come into full
+compliance with these terms, and take practical steps to correct past
+violations, within 32 days of receiving notice.  Otherwise, all your
+licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty
+or condition, and the licensor will not be liable to you for any damages
+arising out of these terms or the use or nature of the software, under any
+kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and
+the **software** is the software the licensor makes available under these
+terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control
+over, are under the control of, or are under common control with that
+organization.  **Control** means ownership of substantially all the assets
+of an entity, or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software
+under these terms.
+
+**Use** means anything you do with the software requiring one of your
+licenses.
+

package/README.md

@@ -0,0 +1,246 @@
+# microtags
+
+![tests](https://github.com/nichoth/microtags/actions/workflows/nodejs.yml/badge.svg)
+[![types](https://img.shields.io/npm/types/microtags?style=flat-square)](README.md)
+[![module](https://img.shields.io/badge/module-ESM%2FCJS-blue?style=flat-square)](README.md)
+[![semantic versioning](https://img.shields.io/badge/semver-2.0.0-blue?logo=semver&style=flat-square)](https://semver.org/)
+[![Common Changelog](https://nichoth.github.io/badge/common-changelog.svg)](./CHANGELOG.md)
+[![license](https://img.shields.io/badge/license-Big_Time-blue?style=flat-square)](LICENSE)
+
+Web component helper with reactive props, automatic cleanup,
+and no Shadow DOM. Reactive via
+[alien-signals](https://github.com/stackblitz/alien-signals).
+
+Inspired by [nanotags](https://nanotags.psdcoder.dev/), with one change:
+reactive props are **alien-signals** instead of nanostores atoms.
+You call `count()` to read and `count(42)` to write — no `$` prefix,
+no `.get()` / `.set()`.
+
+<details><summary><h2>Contents</h2></summary>
+
+- [Install](#install)
+- [Quick start](#quick-start)
+- [API](#api)
+  - [define](#define)
+  - [withProps](#withprops)
+  - [withRefs](#withrefs)
+  - [withContexts](#withcontexts)
+  - [setup and ctx](#setup-and-ctx)
+- [Subpaths](#subpaths)
+  - [microtags/context](#microtagscontext)
+  - [microtags/render](#microtagsrender)
+- [Divergence from nanotags](#divergence-from-nanotags)
+
+</details>
+
+## Install
+
+```sh
+npm i -S microtags
+```
+
+## Quick start
+
+```ts
+import { define } from 'microtags'
+import { signal } from 'alien-signals'
+
+define('my-counter')
+    .withProps(p => ({
+        start: p.number(),   // hydrated from the `start` attribute
+    }))
+    .withRefs(r => ({
+        display: r.one,      // [data-ref="display"] inside the element
+        inc: r.one,
+        dec: r.one,
+    }))
+    .setup(ctx => {
+        // Create a local signal seeded from the hydrated prop.
+        const count = signal(ctx.props.start())
+
+        // Two-way bind the display's textContent to a derived value.
+        ctx.bind(ctx.refs.display as HTMLElement, 'textContent',
+            () => `Count: ${count()}`)
+
+        // Wire up click handlers — auto-removed on disconnect.
+        ctx.on(ctx.refs.inc as HTMLElement, 'click', () => count(count() + 1))
+        ctx.on(ctx.refs.dec as HTMLElement, 'click', () => count(count() - 1))
+    })
+```
+
+```html
+<my-counter start="5">
+    <div data-ref="display"></div>
+    <button data-ref="dec">-</button>
+    <button data-ref="inc">+</button>
+</my-counter>
+```
+
+## API
+
+### define
+
+```ts
+import { define } from 'microtags'
+
+define(tagName: string): ComponentBuilder
+```
+
+Returns a fluent builder. Call `.setup()` to register the custom element.
+All builder methods are chainable and fully type-inferred.
+
+### withProps
+
+```ts
+.withProps(p => ({
+    count:   p.number(),        // attribute -> number  (NaN when absent)
+    label:   p.string(),        // attribute -> string  ('' when absent)
+    active:  p.boolean(),       // attribute -> boolean (true if present)
+    data:    p.json<MyType>(),  // attribute -> JSON.parse or undefined
+    schema:  p.schema(zodSchema),  // Standard Schema (Zod, Valibot, ArkType …)
+    value:   p.prop(0),         // property-only, not observed as an attribute
+}))
+```
+
+Inside `setup()`, every prop is a callable signal:
+
+```ts
+ctx.props.count()      // read
+ctx.props.count(42)    // write
+```
+
+### withRefs
+
+```ts
+.withRefs(r => ({
+    button: r.one,   // resolves [data-ref="button"] — throws if missing
+    items:  r.all,   // resolves all [data-ref="items"] — empty array if none
+}))
+```
+
+Refs are resolved from within the element during `connectedCallback`.
+
+```ts
+ctx.refs.button  // Element
+ctx.refs.items   // Element[]
+```
+
+### withContexts
+
+```ts
+import { createContext } from 'microtags/context'
+
+const ThemeToken = createContext<string>()
+
+define('my-child')
+    .withContexts(() => ({
+        theme: ThemeToken,
+    }))
+    .setup(ctx => {
+        ctx.effect(() => {
+            console.log('theme is', ctx.contexts.theme)
+        })
+    })
+```
+
+`setup()` is deferred until all required contexts resolve. See
+[microtags/context](#microtagscontext) for the provider API.
+
+### setup and ctx
+
+```ts
+.setup(ctx => {
+    // ctx.host       — the HTMLElement itself
+    // ctx.props      — callable signals for each declared prop
+    // ctx.refs       — resolved DOM refs
+    // ctx.contexts   — consumed context values (reactive)
+
+    // Run a tracked effect; auto-disposed on disconnect.
+    ctx.effect(() => {
+        document.title = ctx.props.label()
+    })
+
+    // Bind a DOM property to a signal expression; auto-cleaned.
+    ctx.bind(el, 'textContent', () => String(ctx.props.count()))
+
+    // Add an event listener; auto-removed on disconnect.
+    ctx.on(el, 'click', handler)
+
+    // Read a signal without creating a subscription.
+    const snap = ctx.peek(ctx.props.count)
+
+    // Register arbitrary teardown logic.
+    ctx.onCleanup(() => { /* ... */ })
+
+    // Consume a context imperatively (returns value or undefined).
+    const theme = ctx.consume(ThemeToken)
+})
+```
+
+#### peek and untracked
+
+When you need a non-subscribing read outside of `ctx.peek`, both helpers are
+exported from the main entry:
+
+```ts
+import { peek, untracked } from 'microtags'
+
+ctx.effect(() => {
+    const current = peek(ctx.props.count)   // does NOT subscribe
+    untracked(() => {
+        // reads inside here do not subscribe either
+    })
+})
+```
+
+## Subpaths
+
+### microtags/context
+
+Cross-component context backed by alien-signals.
+
+```ts
+import { createContext, provide, resolveContextSignal } from 'microtags/context'
+
+const ThemeToken = createContext<string>()
+
+// In a provider component's setup():
+const cleanup = provide(ctx.host, ThemeToken, 'dark')
+ctx.onCleanup(cleanup)
+
+// In a consumer component via withContexts:
+ctx.contexts.theme   // 'dark' (reactive — re-runs effects when value changes)
+```
+
+### microtags/render
+
+DOM diffing helpers for rendering lists and single items without a virtual DOM.
+
+```ts
+import { render, renderList } from 'microtags/render'
+
+// Render a single item into a container from a <template>.
+render(container, template, {
+    data: item,
+    update: (el, item) => { el.querySelector('span')!.textContent = item.name },
+})
+
+// Render a keyed list with minimal DOM mutations.
+renderList(container, template, {
+    data: items,
+    key: item => item.id,
+    update: (el, item) => { /* update el from item */ },
+})
+```
+
+## Divergence from nanotags
+
+| nanotags (nanostores) | microtags (alien-signals) |
+|---|---|
+| `$count = atom(0)` | `const count = signal(0)` |
+| `$count.get()` | `count()` |
+| `$count.set(1)` | `count(1)` |
+| `ctx.props.$count` (store) | `ctx.props.count` (callable signal) |
+
+Props declared with `withProps` are native alien-signals callable signals.
+There is no `$` prefix convention — all prop names are plain identifiers.

package/dist/builders.d.ts

@@ -0,0 +1,46 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import type { PropDef, PropertyOnlyProp, SetupContext, Coercer, RefDef, SingleRefDef, MultipleRefDef, RefsMap, ContextToken, ContextsMap } from './types.js';
+/** The DSL object passed to the withProps callback. */
+export type PropDSL = {
+    number(): Coercer<number>;
+    string(): Coercer<string>;
+    boolean(): Coercer<boolean>;
+    json<T>(): Coercer<T | undefined>;
+    schema<T>(validator: StandardSchemaV1<unknown, T>): StandardSchemaV1<unknown, T>;
+    prop<T>(initial: T): PropertyOnlyProp<T>;
+};
+export declare const propDSL: PropDSL;
+/**
+ * DSL object passed to the withRefs callback.
+ * Assign `r.one` for a single element or `r.all` for multiple.
+ */
+export type RefsDSL = {
+    readonly one: SingleRefDef;
+    readonly all: MultipleRefDef;
+};
+export declare const refsDSL: RefsDSL;
+/**
+ * DSL object passed to the withContexts callback.
+ * Currently a no-op placeholder; the user references imported
+ * context tokens directly in the returned record.
+ */
+export type ContextDSL = Record<never, never>;
+/**
+ * Fluent builder that accumulates props/refs/contexts config
+ * before registering a custom element via `.setup()`.
+ */
+export declare class ComponentBuilder<Props extends Record<string, PropDef> = Record<never, never>, RefDefs extends Record<string, RefDef> = Record<never, never>, CtxDefs extends Record<string, ContextToken<unknown>> = Record<never, never>> {
+    readonly tagName: string;
+    private readonly _coercers;
+    private readonly _observed;
+    private readonly _refDefs;
+    private readonly _ctxDefs;
+    constructor(tagName: string, coercers?: Record<string, Coercer<unknown>>, observed?: string[], refDefs?: Record<string, RefDef>, ctxDefs?: Record<string, ContextToken<unknown>>);
+    withProps<P extends Record<string, PropDef>>(fn: (p: PropDSL) => P): ComponentBuilder<P, RefDefs, CtxDefs>;
+    withRefs<R extends Record<string, RefDef>>(fn: (r: RefsDSL) => R): ComponentBuilder<Props, R, CtxDefs>;
+    withContexts<C extends Record<string, ContextToken<unknown>>>(fn: (c: ContextDSL) => C): ComponentBuilder<Props, RefDefs, C>;
+    setup(fn: (ctx: SetupContext<Props, RefsMap<RefDefs>, ContextsMap<CtxDefs>>) => void): typeof HTMLElement;
+}
+/** Create a new component builder for the given tag name. */
+export declare function define(tagName: string): ComponentBuilder;
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

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

package/dist/context.cjs

@@ -0,0 +1,89 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var context_exports = {};
+__export(context_exports, {
+  createContext: () => createContext,
+  onContextAvailable: () => onContextAvailable,
+  provide: () => provide,
+  resolveContextSignal: () => resolveContextSignal
+});
+module.exports = __toCommonJS(context_exports);
+var import_reactivity = require("./reactivity.js");
+const providerStorage = /* @__PURE__ */ new WeakMap();
+const pendingCallbacks = /* @__PURE__ */ new Map();
+function createContext() {
+  return { id: /* @__PURE__ */ Symbol("microtag-context") };
+}
+__name(createContext, "createContext");
+function provide(element, token, value) {
+  let map = providerStorage.get(element);
+  if (!map) {
+    map = /* @__PURE__ */ new Map();
+    providerStorage.set(element, map);
+  }
+  const existing = map.get(token.id);
+  if (existing) {
+    existing(value);
+  } else {
+    const sig = (0, import_reactivity.signal)(value);
+    map.set(token.id, sig);
+  }
+  notifyPending(token.id);
+  return () => {
+    const m = providerStorage.get(element);
+    if (m) {
+      m.delete(token.id);
+      if (m.size === 0) providerStorage.delete(element);
+    }
+  };
+}
+__name(provide, "provide");
+function resolveContextSignal(element, token) {
+  let current = element.parentElement;
+  while (current) {
+    const map = providerStorage.get(current);
+    if (map && map.has(token.id)) {
+      return map.get(token.id);
+    }
+    current = current.parentElement;
+  }
+  return void 0;
+}
+__name(resolveContextSignal, "resolveContextSignal");
+function onContextAvailable(id, callback) {
+  let set = pendingCallbacks.get(id);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    pendingCallbacks.set(id, set);
+  }
+  set.add(callback);
+  return () => {
+    pendingCallbacks.get(id)?.delete(callback);
+  };
+}
+__name(onContextAvailable, "onContextAvailable");
+function notifyPending(id) {
+  const set = pendingCallbacks.get(id);
+  if (set) {
+    for (const cb of set) cb();
+  }
+}
+__name(notifyPending, "notifyPending");
+//# sourceMappingURL=context.cjs.map

package/dist/context.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/context.ts"],
+  "sourcesContent": ["import { signal } from './reactivity.js'\nimport type { ContextToken, Signal } from './types.js'\n\n// Provider storage: element -> (contextId -> Signal)\nconst providerStorage = new WeakMap<Element, Map<symbol, Signal<unknown>>>()\n\n// Pending consumers waiting for a context by id\nconst pendingCallbacks = new Map<symbol, Set<() => void>>()\n\n/**\n * Create a new context token.\n * Each token uniquely identifies a type of shared context.\n */\nexport function createContext<T> (): ContextToken<T> {\n    return { id: Symbol('microtag-context') }\n}\n\n/**\n * Provide a context value from an element to its descendants.\n * Returns a cleanup function that removes the provided value.\n */\nexport function provide<T> (\n    element: Element,\n    token: ContextToken<T>,\n    value: T\n): () => void {\n    let map = providerStorage.get(element)\n    if (!map) {\n        map = new Map()\n        providerStorage.set(element, map)\n    }\n\n    const existing = map.get(token.id) as Signal<T> | undefined\n    if (existing) {\n        existing(value)\n    } else {\n        const sig = signal(value) as unknown as Signal<T>\n        map.set(token.id, sig as Signal<unknown>)\n    }\n\n    notifyPending(token.id)\n\n    return () => {\n        const m = providerStorage.get(element)\n        if (m) {\n            m.delete(token.id)\n            if (m.size === 0) providerStorage.delete(element)\n        }\n    }\n}\n\n/**\n * Walk up the DOM from element to find the nearest provider signal.\n * Returns the signal (not the value) so callers can subscribe to changes.\n */\nexport function resolveContextSignal<T> (\n    element: Element,\n    token: ContextToken<T>\n): Signal<T> | undefined {\n    let current: Element | null = element.parentElement\n    while (current) {\n        const map = providerStorage.get(current)\n        if (map && map.has(token.id)) {\n            return map.get(token.id) as Signal<T>\n        }\n        current = current.parentElement\n    }\n    return undefined\n}\n\n/**\n * Register a callback to run when the given context becomes available.\n * Returns a cleanup function to unregister.\n */\nexport function onContextAvailable (\n    id: symbol,\n    callback: () => void\n): () => void {\n    let set = pendingCallbacks.get(id)\n    if (!set) {\n        set = new Set()\n        pendingCallbacks.set(id, set)\n    }\n    set.add(callback)\n    return () => { pendingCallbacks.get(id)?.delete(callback) }\n}\n\nfunction notifyPending (id: symbol): void {\n    const set = pendingCallbacks.get(id)\n    if (set) {\n        for (const cb of set) cb()\n    }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAuB;AAIvB,MAAM,kBAAkB,oBAAI,QAA+C;AAG3E,MAAM,mBAAmB,oBAAI,IAA6B;AAMnD,SAAS,gBAAqC;AACjD,SAAO,EAAE,IAAI,uBAAO,kBAAkB,EAAE;AAC5C;AAFgB;AAQT,SAAS,QACZ,SACA,OACA,OACU;AACV,MAAI,MAAM,gBAAgB,IAAI,OAAO;AACrC,MAAI,CAAC,KAAK;AACN,UAAM,oBAAI,IAAI;AACd,oBAAgB,IAAI,SAAS,GAAG;AAAA,EACpC;AAEA,QAAM,WAAW,IAAI,IAAI,MAAM,EAAE;AACjC,MAAI,UAAU;AACV,aAAS,KAAK;AAAA,EAClB,OAAO;AACH,UAAM,UAAM,0BAAO,KAAK;AACxB,QAAI,IAAI,MAAM,IAAI,GAAsB;AAAA,EAC5C;AAEA,gBAAc,MAAM,EAAE;AAEtB,SAAO,MAAM;AACT,UAAM,IAAI,gBAAgB,IAAI,OAAO;AACrC,QAAI,GAAG;AACH,QAAE,OAAO,MAAM,EAAE;AACjB,UAAI,EAAE,SAAS,EAAG,iBAAgB,OAAO,OAAO;AAAA,IACpD;AAAA,EACJ;AACJ;AA5BgB;AAkCT,SAAS,qBACZ,SACA,OACqB;AACrB,MAAI,UAA0B,QAAQ;AACtC,SAAO,SAAS;AACZ,UAAM,MAAM,gBAAgB,IAAI,OAAO;AACvC,QAAI,OAAO,IAAI,IAAI,MAAM,EAAE,GAAG;AAC1B,aAAO,IAAI,IAAI,MAAM,EAAE;AAAA,IAC3B;AACA,cAAU,QAAQ;AAAA,EACtB;AACA,SAAO;AACX;AAbgB;AAmBT,SAAS,mBACZ,IACA,UACU;AACV,MAAI,MAAM,iBAAiB,IAAI,EAAE;AACjC,MAAI,CAAC,KAAK;AACN,UAAM,oBAAI,IAAI;AACd,qBAAiB,IAAI,IAAI,GAAG;AAAA,EAChC;AACA,MAAI,IAAI,QAAQ;AAChB,SAAO,MAAM;AAAE,qBAAiB,IAAI,EAAE,GAAG,OAAO,QAAQ;AAAA,EAAE;AAC9D;AAXgB;AAahB,SAAS,cAAe,IAAkB;AACtC,QAAM,MAAM,iBAAiB,IAAI,EAAE;AACnC,MAAI,KAAK;AACL,eAAW,MAAM,IAAK,IAAG;AAAA,EAC7B;AACJ;AALS;",
+  "names": []
+}

package/dist/context.d.ts

@@ -0,0 +1,22 @@
+import type { ContextToken, Signal } from './types.js';
+/**
+ * Create a new context token.
+ * Each token uniquely identifies a type of shared context.
+ */
+export declare function createContext<T>(): ContextToken<T>;
+/**
+ * Provide a context value from an element to its descendants.
+ * Returns a cleanup function that removes the provided value.
+ */
+export declare function provide<T>(element: Element, token: ContextToken<T>, value: T): () => void;
+/**
+ * Walk up the DOM from element to find the nearest provider signal.
+ * Returns the signal (not the value) so callers can subscribe to changes.
+ */
+export declare function resolveContextSignal<T>(element: Element, token: ContextToken<T>): Signal<T> | undefined;
+/**
+ * Register a callback to run when the given context becomes available.
+ * Returns a cleanup function to unregister.
+ */
+export declare function onContextAvailable(id: symbol, callback: () => void): () => void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAQtD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,KAAM,YAAY,CAAC,CAAC,CAAC,CAEnD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACrB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,CAAC,GACT,MAAM,IAAI,CAwBZ;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAUvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,IAAI,GACrB,MAAM,IAAI,CAQZ"}

package/dist/context.js

@@ -0,0 +1,70 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { signal } from "./reactivity.js";
+const providerStorage = /* @__PURE__ */ new WeakMap();
+const pendingCallbacks = /* @__PURE__ */ new Map();
+function createContext() {
+  return { id: /* @__PURE__ */ Symbol("microtag-context") };
+}
+__name(createContext, "createContext");
+function provide(element, token, value) {
+  let map = providerStorage.get(element);
+  if (!map) {
+    map = /* @__PURE__ */ new Map();
+    providerStorage.set(element, map);
+  }
+  const existing = map.get(token.id);
+  if (existing) {
+    existing(value);
+  } else {
+    const sig = signal(value);
+    map.set(token.id, sig);
+  }
+  notifyPending(token.id);
+  return () => {
+    const m = providerStorage.get(element);
+    if (m) {
+      m.delete(token.id);
+      if (m.size === 0) providerStorage.delete(element);
+    }
+  };
+}
+__name(provide, "provide");
+function resolveContextSignal(element, token) {
+  let current = element.parentElement;
+  while (current) {
+    const map = providerStorage.get(current);
+    if (map && map.has(token.id)) {
+      return map.get(token.id);
+    }
+    current = current.parentElement;
+  }
+  return void 0;
+}
+__name(resolveContextSignal, "resolveContextSignal");
+function onContextAvailable(id, callback) {
+  let set = pendingCallbacks.get(id);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    pendingCallbacks.set(id, set);
+  }
+  set.add(callback);
+  return () => {
+    pendingCallbacks.get(id)?.delete(callback);
+  };
+}
+__name(onContextAvailable, "onContextAvailable");
+function notifyPending(id) {
+  const set = pendingCallbacks.get(id);
+  if (set) {
+    for (const cb of set) cb();
+  }
+}
+__name(notifyPending, "notifyPending");
+export {
+  createContext,
+  onContextAvailable,
+  provide,
+  resolveContextSignal
+};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/context.ts"],
+  "sourcesContent": ["import { signal } from './reactivity.js'\nimport type { ContextToken, Signal } from './types.js'\n\n// Provider storage: element -> (contextId -> Signal)\nconst providerStorage = new WeakMap<Element, Map<symbol, Signal<unknown>>>()\n\n// Pending consumers waiting for a context by id\nconst pendingCallbacks = new Map<symbol, Set<() => void>>()\n\n/**\n * Create a new context token.\n * Each token uniquely identifies a type of shared context.\n */\nexport function createContext<T> (): ContextToken<T> {\n    return { id: Symbol('microtag-context') }\n}\n\n/**\n * Provide a context value from an element to its descendants.\n * Returns a cleanup function that removes the provided value.\n */\nexport function provide<T> (\n    element: Element,\n    token: ContextToken<T>,\n    value: T\n): () => void {\n    let map = providerStorage.get(element)\n    if (!map) {\n        map = new Map()\n        providerStorage.set(element, map)\n    }\n\n    const existing = map.get(token.id) as Signal<T> | undefined\n    if (existing) {\n        existing(value)\n    } else {\n        const sig = signal(value) as unknown as Signal<T>\n        map.set(token.id, sig as Signal<unknown>)\n    }\n\n    notifyPending(token.id)\n\n    return () => {\n        const m = providerStorage.get(element)\n        if (m) {\n            m.delete(token.id)\n            if (m.size === 0) providerStorage.delete(element)\n        }\n    }\n}\n\n/**\n * Walk up the DOM from element to find the nearest provider signal.\n * Returns the signal (not the value) so callers can subscribe to changes.\n */\nexport function resolveContextSignal<T> (\n    element: Element,\n    token: ContextToken<T>\n): Signal<T> | undefined {\n    let current: Element | null = element.parentElement\n    while (current) {\n        const map = providerStorage.get(current)\n        if (map && map.has(token.id)) {\n            return map.get(token.id) as Signal<T>\n        }\n        current = current.parentElement\n    }\n    return undefined\n}\n\n/**\n * Register a callback to run when the given context becomes available.\n * Returns a cleanup function to unregister.\n */\nexport function onContextAvailable (\n    id: symbol,\n    callback: () => void\n): () => void {\n    let set = pendingCallbacks.get(id)\n    if (!set) {\n        set = new Set()\n        pendingCallbacks.set(id, set)\n    }\n    set.add(callback)\n    return () => { pendingCallbacks.get(id)?.delete(callback) }\n}\n\nfunction notifyPending (id: symbol): void {\n    const set = pendingCallbacks.get(id)\n    if (set) {\n        for (const cb of set) cb()\n    }\n}\n"],
+  "mappings": ";;AAAA,SAAS,cAAc;AAIvB,MAAM,kBAAkB,oBAAI,QAA+C;AAG3E,MAAM,mBAAmB,oBAAI,IAA6B;AAMnD,SAAS,gBAAqC;AACjD,SAAO,EAAE,IAAI,uBAAO,kBAAkB,EAAE;AAC5C;AAFgB;AAQT,SAAS,QACZ,SACA,OACA,OACU;AACV,MAAI,MAAM,gBAAgB,IAAI,OAAO;AACrC,MAAI,CAAC,KAAK;AACN,UAAM,oBAAI,IAAI;AACd,oBAAgB,IAAI,SAAS,GAAG;AAAA,EACpC;AAEA,QAAM,WAAW,IAAI,IAAI,MAAM,EAAE;AACjC,MAAI,UAAU;AACV,aAAS,KAAK;AAAA,EAClB,OAAO;AACH,UAAM,MAAM,OAAO,KAAK;AACxB,QAAI,IAAI,MAAM,IAAI,GAAsB;AAAA,EAC5C;AAEA,gBAAc,MAAM,EAAE;AAEtB,SAAO,MAAM;AACT,UAAM,IAAI,gBAAgB,IAAI,OAAO;AACrC,QAAI,GAAG;AACH,QAAE,OAAO,MAAM,EAAE;AACjB,UAAI,EAAE,SAAS,EAAG,iBAAgB,OAAO,OAAO;AAAA,IACpD;AAAA,EACJ;AACJ;AA5BgB;AAkCT,SAAS,qBACZ,SACA,OACqB;AACrB,MAAI,UAA0B,QAAQ;AACtC,SAAO,SAAS;AACZ,UAAM,MAAM,gBAAgB,IAAI,OAAO;AACvC,QAAI,OAAO,IAAI,IAAI,MAAM,EAAE,GAAG;AAC1B,aAAO,IAAI,IAAI,MAAM,EAAE;AAAA,IAC3B;AACA,cAAU,QAAQ;AAAA,EACtB;AACA,SAAO;AACX;AAbgB;AAmBT,SAAS,mBACZ,IACA,UACU;AACV,MAAI,MAAM,iBAAiB,IAAI,EAAE;AACjC,MAAI,CAAC,KAAK;AACN,UAAM,oBAAI,IAAI;AACd,qBAAiB,IAAI,IAAI,GAAG;AAAA,EAChC;AACA,MAAI,IAAI,QAAQ;AAChB,SAAO,MAAM;AAAE,qBAAiB,IAAI,EAAE,GAAG,OAAO,QAAQ;AAAA,EAAE;AAC9D;AAXgB;AAahB,SAAS,cAAe,IAAkB;AACtC,QAAM,MAAM,iBAAiB,IAAI,EAAE;AACnC,MAAI,KAAK;AACL,eAAW,MAAM,IAAK,IAAG;AAAA,EAC7B;AACJ;AALS;",
+  "names": []
+}