monowind 0.2.12 → 0.2.14

package/README.md

@@ -111,6 +111,8 @@ 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 `╭ ╮ ╰ ╯`
@@ -126,6 +128,21 @@ registerBorderGlyphs("soft", {
 });
 ```
 
+`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
@@ -137,8 +154,9 @@ to it, so rows never show a seam.
 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. Tailwind's presets are pixel recipes, and their blur and
-spread convert on the spacing scale (4px to a cell), so `shadow-2xl`
+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:
 
@@ -151,8 +169,19 @@ your Tailwind theme:
 ```
 
 `rounded-*` picks the corner glyphs a set registers nearest the radius
-— the defaults' `╭ ╮ ╰ ╯` for light-line borders — while double
-borders stay square.
+— 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
 
@@ -175,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/animate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA2BH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,mBAAmB,GAAG,MAAM,CA0B3F;AAED;;;;;;;qDAOqD;AACrD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CA2BhE;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CASnD"}
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA6BH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,mBAAmB,GAAG,MAAM,CAgC3F;AAED;;;;;;;qDAOqD;AACrD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CA2BhE;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CASnD"}

package/dist/animation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Keyframe animations sampled like transitions (specs/animations.md):
+ * a light element's running CSS animations, read through
+ * `getAnimations()`, classified by the properties their keyframes
+ * touch into what a frame must do to show them.
+ */
+import type { LayoutNode } from "./types.ts";
+/** What a frame does for an element's running animations: `box`
+ * places its layer's box again from the computed effects; `paint`
+ * resamples its live paint-only properties into its node and
+ * repaints the last layout; `layout` re-lays-out, which reads every
+ * animated value under `[measuring]`. */
+export type AnimationPath = "box" | "paint" | "layout";
+/** The properties of `el`'s running CSS animations, camel-cased as
+ * keyframes name them; empty without one, or where the platform has
+ * no `getAnimations`. With the computed style at hand — a measure
+ * pass's read — an `animation-name` of none skips the call, and an
+ * animating element is noted for its host. */
+export declare function animatedProperties(el: Element, cs?: CSSStyleDeclaration): Set<string>;
+/** The elements a pass found animating inside `host`, once each. */
+export declare function drainAnimated(host: Element): Element[];
+/** The path for a set of animated properties on an element's layout
+ * node (null for an inline element); null with nothing animated. A
+ * `color` repaints only on a leaf without inline elements, since the
+ * children's and the inline runs' colors are snapshots of what they
+ * inherited; a border color only off a collapsed table, whose lattice
+ * took its colors at layout. */
+export declare function animationPath(properties: Set<string>, node: LayoutNode | null): AnimationPath | null;
+/** Whether `el` animates a layer effect, for the read: a running
+ * animation or transition of one keeps the element a layer root
+ * through its identity frames, a transition's first among them. A
+ * `transition-duration` of zero skips the call. */
+export declare function animatesEffect(el: Element, cs: CSSStyleDeclaration): boolean;
+/** Whether `el` animates its background: its value is the browser's,
+ * read as it is. */
+export declare function animatesBackground(el: Element, cs: CSSStyleDeclaration): boolean;
+/** The layout node of an element, found once per layout: the
+ * element's own, an anonymous run of its text left to it. */
+export declare function nodeIndex(root: LayoutNode): Map<Element, LayoutNode>;
+//# sourceMappingURL=animation.d.ts.map

package/dist/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;yCAIyC;AACzC,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AA2BvD;;;;8CAI8C;AAC9C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,mBAAmB,GAAG,GAAG,CAAC,MAAM,CAAC,CAarF;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAQtD;AAED;;;;;gCAKgC;AAChC,wBAAgB,aAAa,CAC3B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,IAAI,EAAE,UAAU,GAAG,IAAI,GACtB,aAAa,GAAG,IAAI,CAYtB;AAED;;;mDAGmD;AACnD,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAQ5E;AAED;oBACoB;AACpB,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAEhF;AAED;6DAC6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAQpE"}

package/dist/borders.d.ts

@@ -4,22 +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 outer shadows (specs/box-shadow.md): each the border box
- * moved by its offsets and grown by its spread, blurred into
- * `round(blur / 2)` rings of the owner's shade ramp fading outward,
- * the cells under the box left out — the last declared first, so the
- * first paints on top.
+ * 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, out: BorderRun[]): void;
+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
@@ -33,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
@@ -89,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). */
@@ -99,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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"}