monowind 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Benoît Rouleau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# monowind
+
+Build text-based user interfaces (TUIs) on the web from ordinary HTML and
+Tailwind utility classes. A Web Component lays your HTML out on a strict
+character grid — box-drawing borders, integer-cell geometry, monospace
+everything — while native links, buttons, inputs, focus, forms, and
+accessibility semantics stay fully intact.
+
+**Early development.** APIs and behavior will change.
+
+## Try it — no build step
+
+```html
+<script src="https://unpkg.com/monowind/dist/cdn.js"></script>
+
+<mono-wind>
+  <div class="flex min-h-5 items-center justify-between border px-1">
+    <div>left</div>
+    <button>right</button>
+  </div>
+</mono-wind>
+```
+
+## With your own Tailwind (v4) build
+
+```sh
+npm install monowind
+```
+
+```css
+/* app.css */
+@import "tailwindcss";
+@import "monowind";
+```
+
+```js
+import { defineMonoWind } from "monowind";
+defineMonoWind();
+```
+
+## Docs
+
+- [Storybook](https://storybook.monowind.benface.com) — live examples of
+  every supported feature
+- [Project overview and development setup](https://github.com/benface/monowind#readme)
+- [Cell-model rules](https://github.com/benface/monowind/blob/main/.agents/specs/cell-model.md)
+  — the layout semantics (spacing scale: 1 cell = 0.25rem; border scale:
+  1px = 1 cell; what's deliberately unsupported)
+- [Example apps](https://github.com/benface/monowind/tree/main/apps) — CDN
+  mode, Vite + Tailwind, and more

package/dist/ascii.d.ts

@@ -0,0 +1,16 @@
+import type { LayoutNode } from "./types.ts";
+/**
+ * Render a laid-out tree as plain-text ASCII art: borders as box-drawing
+ * glyphs, leaf text word-wrapped inside its content box, everything else as
+ * spaces.
+ *
+ * This is the engine's "screenshot without a browser": deterministic,
+ * font-independent, and diffable — used for golden regression tests and as
+ * a debugging/agent-inspection tool. It intentionally renders geometry the
+ * way the browser would paint it (same border-run and word-wrap code), minus
+ * colors and fonts.
+ *
+ * Content that overflows the root box is clipped at the grid edges.
+ */
+export declare function renderAscii(root: LayoutNode): string;
+//# sourceMappingURL=ascii.d.ts.map

package/dist/ascii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii.d.ts","sourceRoot":"","sources":["../src/ascii.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAepD"}

package/dist/borders.d.ts

@@ -0,0 +1,21 @@
+import type { CellStyle, Rect } from "./types.ts";
+/** One run of identical border glyphs, in absolute cell coordinates. */
+export interface BorderRun {
+    glyph: string;
+    x: number;
+    y: number;
+    length: number;
+    color: string | undefined;
+}
+/**
+ * Emit runs of border glyphs for the box's engine-allocated border cells.
+ *
+ * For multi-cell borders (`border-2`, `border-3`, …) the engine allocates N
+ * cells per edge; we render them as N concentric rings. Styles and colors
+ * are per-side (see paintRing); every ring repeats them.
+ *
+ * A single-cell-thin box (width < 2 or height < 2) has no interior; we draw
+ * only vertical/horizontal runs and skip corners that would overlap.
+ */
+export declare function collectBorderRuns(style: CellStyle, box: Rect, out: BorderRun[]): void;
+//# sourceMappingURL=borders.d.ts.map

package/dist/borders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"borders.d.ts","sourceRoot":"","sources":["../src/borders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,SAAS,EAAW,IAAI,EAAE,MAAM,YAAY,CAAC;AAExE,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,CAoBrF"}

package/dist/cdn.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CDN entry point — the "Play CDN" experience, like Tailwind's:
+ *
+ *   <script src="https://unpkg.com/monowind/dist/cdn.js"></script>
+ *
+ * One classic script tag, no build step. Bundles:
+ * - `@tailwindcss/browser` (compiles Tailwind classes in the browser at
+ *   runtime, watching the DOM),
+ * - the monowind companion stylesheet (injected into <head>),
+ * - the engine, with <mono-wind> registered immediately.
+ */
+import "@tailwindcss/browser";
+//# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,sBAAsB,CAAC"}