monowind 0.1.8 → 0.1.9

package/dist/leaf.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Public leaf-renderer API (specs/leaf-renderers.md): a custom element
+ * registers as a GRID LEAF and supplies its own cell content instead
+ * of laid-out children — the generalization of what the tree builder
+ * special-cases for form controls. `@monowind/ascii` is the first
+ * consumer.
+ *
+ * Stability contract: this surface is public — every future change is
+ * ADDITIVE (new optional fields/parameters), per the spec's evolution
+ * policy.
+ */
+/** Per-cell styling for a run — an extensible subset of what the grid
+ * paints. Color values are CSS `<color>` strings, vars welcome
+ * (`var(--mw-ansi-red)`); they resolve at paint time against the
+ * host, so themes restyle content with no re-render. */
+export interface LeafPaint {
+    color?: string;
+    backgroundColor?: string;
+    fontWeight?: string;
+    fontStyle?: string;
+    textDecorationLine?: string;
+}
+/** One painted span of a content line: cells `[start, end)` of
+ * `lines[line]`. */
+export interface LeafRun {
+    line: number;
+    start: number;
+    end: number;
+    paint: LeafPaint;
+}
+/** What a renderer returns: preformatted content lines (the leaf's
+ * intrinsic width is the longest line, height the line count —
+ * white-space styling does not apply to renderer content) plus
+ * optional paint runs. */
+export interface LeafContent {
+    lines: string[];
+    runs?: LeafRun[];
+}
+export interface LeafRegistration {
+    /** Custom-element tag name (must contain a hyphen — built-ins are
+     * never claimable). Stored lowercased. */
+    tag: string;
+    /** SYNCHRONOUS and DOM-read-only; called each layout pass (caching
+     * is the renderer's own business). Asynchrony (font loading, …)
+     * lives outside: finish the work, then `invalidateLeaves()`. Must
+     * also run under happy-dom/Node — `renderPlainText` traverses the
+     * same tree. */
+    render: (el: Element) => LeafContent;
+    /** Attributes whose changes re-render this leaf (merged into the
+     * host's mutation-observer filter; `class`/`style` and character
+     * data are always observed). */
+    observedAttributes?: string[];
+}
+/** Register (or last-wins replace, with a warning) a leaf renderer.
+ * Connected hosts relayout, so registration after first paint is
+ * safe — the post-hoc-registration idiom every monowind registry
+ * shares. */
+export declare function registerLeafRenderer(registration: LeafRegistration): void;
+/** Relayout every connected host — the invalidation hook for leaf
+ * content whose inputs changed outside the DOM (a font finished
+ * registering, …). Coalesced per frame by the hosts themselves. */
+export declare function invalidateLeaves(): void;
+export declare function leafRendererFor(tagName: string): LeafRegistration | undefined;
+/** The union of every registration's observed attributes — the host
+ * extends its MutationObserver filter with these. */
+export declare function leafObservedAttributes(): string[];
+/** Host subscription to registry changes (registration or
+ * invalidation); returns the unsubscriber. Internal to the engine. */
+export declare function onLeafRegistryChange(listener: () => void): () => void;
+/** Run a renderer with the spec's error contract: a throw must never
+ * break layout — warn once per element and render nothing this pass. */
+export declare function renderLeafContent(leaf: LeafRegistration, el: Element): LeafContent | null;
+//# sourceMappingURL=leaf.d.ts.map

package/dist/leaf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaf.d.ts","sourceRoot":"","sources":["../src/leaf.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH;;;wDAGwD;AACxD,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;oBACoB;AACpB,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;0BAG0B;AAC1B,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B;8CAC0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;oBAIgB;IAChB,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,WAAW,CAAC;IACrC;;oCAEgC;IAChC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAKD;;;aAGa;AACb,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAezE;AAED;;mEAEmE;AACnE,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE7E;AAED;qDACqD;AACrD,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAMjD;AAED;sEACsE;AACtE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGrE;AAED;wEACwE;AACxE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAOzF"}

package/dist/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAW,MAAM,YAAY,CAAC;AAEnE;;;;4DAI4D;AAC5D,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,WAAW,EACzB,cAAc,CAAC,EAAE,cAAc,GAC9B,UAAU,GAAG,IAAI,CA4JnB;AA6UD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAIlD;AAED;;oCAEoC;AACpC,eAAO,MAAM,mBAAmB,QAE6B,CAAC;AAE9D;8DAC8D;AAC9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAW,MAAM,YAAY,CAAC;AAEnE;;;;4DAI4D;AAC5D,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,WAAW,EACzB,cAAc,CAAC,EAAE,cAAc,GAC9B,UAAU,GAAG,IAAI,CAmKnB;AAgZD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAIlD;AAED;;oCAEoC;AACpC,eAAO,MAAM,mBAAmB,QAE6B,CAAC;AAE9D;8DAC8D;AAC9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monowind",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Text-based user interfaces (TUI) on the web, from ordinary HTML and Tailwind utility classes",
   "keywords": [
     "ascii",