monowind 0.2.11 → 0.2.13

package/README.md

@@ -111,11 +111,78 @@ registerBorderGlyphs("stars", { solid: { tl: "✧", tr: "✧", bl: "✧", br: "
 }
 ```
 
+A registered set is frozen; to change one, register it again.
+
+A set can also register corner glyphs by `border-radius` — a corner
+draws the registration nearest its radius in cells, the plain corner
+counting at 0 (the defaults round light-line corners to `╭ ╮ ╰ ╯`
+from `rounded-xs` up) — and the shade ramp box shadows step through,
+densest first (default `█ ▓ ▒ ░`):
+
+```js
+registerBorderGlyphs("soft", {
+  solid: {
+    rounded: [{ radius: 2, tl: "◜", tr: "◝", bl: "◟", br: "◞" }],
+    shadow: ["▓", "▒", "░", "·"],
+  },
+});
+```
+
+`border-width` is a **weight** the set interprets: the defaults draw
+`border-2` and up as heavy lines (`━ ┃ ┏ ┓ ┗ ┛`) in one cell, and
+`rule-2` on a gap the same way. A set registers its own weight bands —
+glyphs for a width, and the cells it takes — so a theme whose font has
+no heavy glyphs can draw two rings instead, which is what `ascii`,
+`single`, `rounded`, and `blocks` do (`cp437` draws double, as DOS
+did):
+
+```js
+registerBorderGlyphs("rings", { solid: { weights: [{ width: 2, cells: 2 }] } });
+registerBorderGlyphs("bold", {
+  solid: { weights: [{ width: 2, h: "═", v: "║", tl: "╔", tr: "╗", bl: "╚", br: "╝" }] },
+});
+```
+
 Borders, blocks, and scrollbars tile in any font: where a font draws
 its box-drawing or block glyphs shorter than the row (Menlo and SF
 Mono do, and any font under a taller `leading-*`), the grid fits them
 to it, so rows never show a seam.
 
+## Shadows and rounded corners
+
+`shadow-*` paints a box's silhouette behind it in shade glyphs from
+the glyph set: offsets in whole cells (a `4px` offset is one cell, the
+classic DOS shadow), blur as rings that fade outward, spread in cells,
+a translucent color as a lighter shade leaning on the theme's
+foreground, `inset` shadows inside the padding box. Tailwind's presets
+are pixel recipes, and their blur and spread convert on the spacing
+scale (4px to a cell), so `shadow-2xl`
+is a six-ring halo. For presets tuned to the grid, redefine them in
+your Tailwind theme:
+
+```css
+@theme {
+  --shadow-sm: 4px 4px 0 0 rgb(0 0 0 / 0.1);
+  --shadow-md: 4px 4px 8px 0 rgb(0 0 0 / 0.1);
+  --shadow-lg: 4px 4px 16px 0 rgb(0 0 0 / 0.1);
+}
+```
+
+`rounded-*` picks the corner glyphs a set registers nearest the radius
+— the defaults' `╭ ╮ ╰ ╯` for light-line borders — while heavy and
+double borders stay square.
+
+## Gradients
+
+`bg-linear-*`, `bg-radial`, and `bg-conic` (with `from-*`, `via-*`,
+`to-*`, positions, and a space such as `/srgb`, `/oklch`, `/longer`)
+paint a color per cell: each cell takes the gradient's color at its
+center, in CSS's geometry for the box, the stops interpolated as CSS
+does, layers composited over the plain color. Text keeps its own
+color, and `bg-clip-text text-transparent` shows the gradient through
+it. Sizes, positions, and repeats of the background image are ignored,
+as are `url()` images: a gradient always covers the box once.
+
 ## Companion packages
 
 The core is self-contained; these are optional:
@@ -137,7 +204,8 @@ The core is self-contained; these are optional:
   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)
+  — the layout semantics (spacing scale: 1 cell = 0.25rem; border
+  width as a weight the glyph set draws; what's deliberately
+  unsupported)
 - [Example apps](https://github.com/benface/monowind/tree/main/apps) — CDN
   mode, Vite + Tailwind, and more

package/dist/borders.d.ts

@@ -4,14 +4,24 @@ export type { BorderRun } from "./types.ts";
 /**
  * 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 weight band of N cells (a set's rings, specs/theming.md) allocates N
+ * cells per edge; we render them as N concentric rings. Styles, weights,
+ * 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;
+/**
+ * Emit a box's shadows (specs/box-shadow.md), `inset` the ones drawn
+ * inside the padding box, else the outer ones: each a silhouette in the
+ * owner's shade ramp — an outer shadow the border box moved by its
+ * offsets and grown by its spread, blurred into `round(blur / 2)` rings
+ * fading outward, the cells under the box left out; an inset shadow the
+ * padding box less that same rectangle moved inward, its rings fading
+ * into the box — the last declared first, so the first paints on top.
+ */
+export declare function collectShadowRuns(style: CellStyle, box: Rect, inset: boolean, out: BorderRun[]): void;
 /** Whether the child paints in the positioned step (Appendix E step
  * 8+): positioned elements, and flex/grid items with an explicit
  * z-index (z-index applies there per CSS, but `auto` items paint as
@@ -25,15 +35,17 @@ export declare function paintsInPositionedStep(child: LayoutNode, parent: Layout
  * order breaks ties. Bucketed instead of full-sorted so the common
  * case (single bucket, no z-index) is 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", set?: BorderGlyphSet): string;
+/** A style's straight line glyph at a weight (px), for lattice
+ * segments and rules. */
+export declare function lineGlyph(style: BorderStyle, weight: number, 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
+ * arms exist, at a weight (px) — the heaviest arm's, decided by the
+ * caller. `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. 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;
+export declare function junctionGlyph(style: BorderStyle, weight: number, 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
@@ -81,6 +93,9 @@ export interface GapRuleContext {
     contentHeight: number;
     border: Insets;
     borderStyle: PerSide<BorderStyle>;
+    /** The border's weight per side (px): a rule tees into it with the
+     * heavier of the two (junctionWeight). */
+    borderWeight: PerSide<number>;
     borderColor: PerSide<string | undefined>;
     padding: Insets;
     /** The owning container's resolved glyph set (specs/theming.md). */
@@ -91,7 +106,8 @@ export interface GapRuleContext {
  * band (floor on the leading side), crossings get junction glyphs from
  * their arms, and a rule that reaches the content edge through zero
  * padding tees into the container's innermost border ring. Mixed styles
- * fall back to the light set; all-double crossings use the double set.
+ * fall back to the light set; all-double crossings use the double set;
+ * a crossing of weights draws the heavier.
  */
 export declare function collectGapRuleRuns(ctx: GapRuleContext): BorderRun[];
 //# sourceMappingURL=borders.d.ts.map

package/dist/borders.d.ts.map

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