monowind 0.1.10 → 0.2.1

package/README.md

@@ -38,6 +38,47 @@ import { defineMonoWind } from "monowind";
 defineMonoWind();
 ```
 
+## Border & rule glyphs
+
+Border styles render through a **glyph set** — swap the characters
+without touching your markup. Pick a built-in with a `borders-*`
+utility on the element that owns the decoration (or any ancestor —
+it inherits):
+
+```html
+<div class="border borders-rounded">╭─╮ corners</div>
+<div class="border border-double borders-ascii">+=+ everywhere</div>
+<div class="border border-double borders-single">─│ only, DEC-style</div>
+```
+
+Built-ins: `default`, `rounded`, `ascii`, `single`, `blocks`, `cp437`. Or register your
+own (per-glyph fallback — override only what you need) and reference
+it the same way:
+
+```js
+import { registerBorderGlyphs } from "monowind";
+registerBorderGlyphs("stars", { solid: { tl: "✧", tr: "✧", bl: "✧", br: "✧" } });
+```
+
+```css
+.fancy {
+  --mw-border-glyphs: stars; /* what the borders-* utilities set */
+}
+```
+
+## Companion packages
+
+The core is self-contained; these are optional:
+
+- [`@monowind/themes`](https://www.npmjs.com/package/@monowind/themes) —
+  class-scoped themes modeled on real systems (`dos`, `c64`,
+  `green-phosphor`, …): authentic palettes, period fonts, era-correct
+  border characters
+- [`@monowind/ascii`](https://www.npmjs.com/package/@monowind/ascii) —
+  `<mono-ascii>` FIGlet banner text with gradient/metal effects
+- [`@monowind/vite`](https://www.npmjs.com/package/@monowind/vite) —
+  zero-config Vite plugin, Tailwind included
+
 ## Docs
 
 - [Storybook](https://storybook.monowind.benface.com) — live examples of

package/dist/borders.d.ts

@@ -1,3 +1,4 @@
+import type { BorderGlyphSet } from "./glyphs.ts";
 import type { RuleBreak, RuleVisibilityItems, BorderRun, BorderStyle, CellStyle, GapRule, Insets, LayoutNode, PerSide, Rect } from "./types.ts";
 export type { BorderRun } from "./types.ts";
 /**
@@ -22,13 +23,14 @@ export declare function zIndexApplies(child: LayoutNode, parent: LayoutNode): bo
  * allocation-free. */
 export declare function paintOrderedChildren(node: LayoutNode): LayoutNode[];
 /** A style's straight line glyph, for lattice segments. */
-export declare function lineGlyph(style: BorderStyle, axis: "h" | "v"): string;
+export declare function lineGlyph(style: BorderStyle, axis: "h" | "v", set?: BorderGlyphSet): string;
 /** Junction glyph for a lattice intersection, from which of the four
  * arms exist. `double` has a full junction set; dashed/dotted (and mixed
  * styles, decided by the caller) use the light set — the corner
  * convention (specs/cell-model.md). Stubs (≤1 arm) fall back to plain
- * line glyphs. */
-export declare function junctionGlyph(style: BorderStyle, up: boolean, down: boolean, left: boolean, right: boolean): string;
+ * line glyphs. An active glyph SET (specs/theming.md) overrides PER
+ * GLYPH by junction role. */
+export declare function junctionGlyph(style: BorderStyle, up: boolean, down: boolean, left: boolean, right: boolean, set?: BorderGlyphSet): string;
 /** One gap band a rule may occupy: `bandStart`/`bandSize` across the
  * band's axis (x for a vertical rule), `start`/`end` along it. All in
  * content-box cells. A `half` endpoint is an overlap-join extension
@@ -78,6 +80,8 @@ export interface GapRuleContext {
     borderStyle: PerSide<BorderStyle>;
     borderColor: PerSide<string | undefined>;
     padding: Insets;
+    /** The owning container's resolved glyph set (specs/theming.md). */
+    glyphs?: BorderGlyphSet | undefined;
 }
 /**
  * Paint gap rules as node-local glyph runs: each rule centers in its

package/dist/borders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"borders.d.ts","sourceRoot":"","sources":["../src/borders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,SAAS,EACT,OAAO,EACP,MAAM,EACN,UAAU,EACV,OAAO,EACP,IAAI,EACL,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkB5C;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,CAoBrF;AA+FD;iDACiD;AACjD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAM5E;AAED;;;;;sBAKsB;AACtB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAiBnE;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,CAGrE;AAED;;;;kBAIkB;AAClB,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,GACb,MAAM,CAGR;AAgED;;;;oEAIoE;AACpE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;iEACiE;AACjE,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,QAAQ,EAAE,EAClB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,MAAM,GAAG,cAAc,GAC7B,UAAU,EAAE,CAwDd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,wEAAwE;IACxE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,WAAW,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS,EAAE,CAgFnE"}
+{"version":3,"file":"borders.d.ts","sourceRoot":"","sources":["../src/borders.ts"],"names":[],"mappings":"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"}