monowind 0.1.0 → 0.1.2

package/dist/element.d.ts

@@ -1,14 +1,17 @@
-export declare class MonoWindElement extends HTMLElement {
+declare const HTMLElementBase: typeof HTMLElement;
+export declare class MonoWindElement extends HTMLElementBase {
     #private;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
 }
-/** Register the <mono-wind> element (idempotent). */
+/** Register the <mono-wind> element (idempotent; no-op without a DOM, so
+ * calling it from code that also runs server-side is safe). */
 export declare function defineMonoWind(): void;
 declare global {
     interface HTMLElementTagNameMap {
         "mono-wind": MonoWindElement;
     }
 }
+export {};
 //# sourceMappingURL=element.d.ts.map

package/dist/element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAmBA,qBAAa,eAAgB,SAAQ,WAAW;;IAS9C,cAKC;IAED,iBAAiB,IAAI,IAAI,CAqCxB;IAED,oBAAoB,IAAI,IAAI,CAS3B;CA8GF;AAED,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,eAAe,CAAC;KAC9B;CACF"}
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AA2BA,QAAA,MAAM,eAAe,EAEhB,OAAO,WAAW,CAAC;AAExB,qBAAa,eAAgB,SAAQ,eAAe;;IASlD,cAsBC;IAED,iBAAiB,IAAI,IAAI,CAiCxB;IAED,oBAAoB,IAAI,IAAI,CAM3B;CA0IF;AAED;+DAC+D;AAC/D,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,eAAe,CAAC;KAC9B;CACF"}

package/dist/flex.d.ts

@@ -0,0 +1,47 @@
+import type { IntrinsicCache } from "./layout.ts";
+import type { CellStyle, Insets, LayoutNode } from "./types.ts";
+/**
+ * Flexbox (specs/flex.md): row and column algorithms, CSS §9.7 flexible
+ * length resolution, and the shared distribution/alignment helpers. See
+ * layout.ts for the deliberate import cycle between the layout modules.
+ */
+export declare function layoutFlexRow(node: LayoutNode, innerWidth: number, innerHeight: number, definiteInnerHeight: number | undefined, border: Insets, padding: Insets, cache: IntrinsicCache): number;
+export declare function layoutFlexColumn(node: LayoutNode, innerWidth: number, innerHeight: number, heightIsDefinite: boolean, border: Insets, padding: Insets, cache: IntrinsicCache): number;
+/**
+ * Position each item along the main axis given its size and leftover space.
+ * Returns the offset from container inner origin for each item.
+ */
+export declare function mainAxisOffsets(justify: CellStyle["justifyContent"], sizes: number[], leftover: number): number[];
+/**
+ * Resolve flex main-axis sizes per CSS Flexbox §9.7 ("Resolving Flexible
+ * Lengths"), adapted to integers: distribute free space proportionally to
+ * grow factors (or shrink weights = base × shrink), clamp each result to the
+ * item's own min/max, FREEZE the items whose clamp fired, and redistribute
+ * among the rest — repeating until nothing new violates. Without the
+ * redistribution rounds, an item clamped up to `min-w-*` would keep space
+ * its neighbors were already told they could use, and boxes would overlap.
+ *
+ * `min`/`max` are outer main sizes in cells, already resolved from percent.
+ * When clamps bind, the returned sizes may sum to less or more than
+ * `available` — that's CSS (`justify-content` sees the underfill; overflow
+ * handles the excess).
+ */
+export declare function resolveFlexMainAxis(items: ReadonlyArray<{
+    base: number;
+    grow: number;
+    shrink: number;
+    min?: number | undefined;
+    max?: number | undefined;
+}>, available: number): number[];
+/**
+ * Distribute `total` integer units across N slots proportionally to `weights`,
+ * with the remainder (from flooring) given to the slots with the largest
+ * fractional part — deterministic, document order for ties.
+ */
+export declare function distributeInteger(weights: number[], total: number): number[];
+/** A flex item's cross alignment: its own align-self, else the parent's
+ * align-items. */
+export declare function effectiveAlign(child: LayoutNode, parent: LayoutNode): CellStyle["alignItems"];
+export declare function alignCrossOffset(align: CellStyle["alignItems"], container: number, child: number): number;
+export declare function effectiveJustify(style: CellStyle): CellStyle["justifyContent"];
+//# sourceMappingURL=flex.d.ts.map

package/dist/flex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex.d.ts","sourceRoot":"","sources":["../src/flex.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAC;AAEhF;;;;GAIG;AAEH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,GAAG,SAAS,EACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,MAAM,CAgNR;AAyBD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,OAAO,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,MAAM,CA4JR;AAgDD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,CAAC,gBAAgB,CAAC,EACpC,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CA0CV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC,EACF,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CA+DV;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB5E;AAED;kBACkB;AAClB,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,YAAY,CAAC,CAI7F;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AA+CD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAS9E"}

package/dist/grid.d.ts

@@ -0,0 +1,104 @@
+import type { IntrinsicCache } from "./layout.ts";
+import type { GridAutoFlow, GridLine, Insets, LayoutNode, TrackSize } from "./types.ts";
+/**
+ * Grid layout (specs/grid.md): template resolution, CSS §8.5 auto-
+ * placement, the §11 track sizing algorithm adapted to integer cells, and
+ * item placement in areas. Shares the integer distribution and alignment
+ * offset machinery with flex. See layout.ts for the deliberate import
+ * cycle between the layout modules.
+ */
+export declare function layoutGrid(node: LayoutNode, innerWidth: number, innerHeight: number, border: Insets, padding: Insets, cache: IntrinsicCache): number;
+/** The container's intrinsic content widths (specs/grid.md interaction
+ * section): run placement and column sizing under a min-content
+ * constraint — min-content = the track bases, max-content = the track
+ * growth limits (fr tracks report their flex-fraction size), plus gaps.
+ * One placement + sizing pass computes both, cached per node. */
+export declare function gridIntrinsicInnerWidths(node: LayoutNode, cache: IntrinsicCache): {
+    min: number;
+    max: number;
+};
+interface AxisSpec {
+    /** Normalized 0-based track index of the start line (explicit tracks
+     * occupy [0, explicitCount)); may be negative (implicit tracks before
+     * the explicit grid) or null for auto. */
+    start: number | null;
+    span: number;
+}
+/** The explicit grid of one axis for line resolution: its track count
+ * and the names on each of its `explicitCount + 1` lines (template
+ * `[name]` groups plus the `<area>-start` / `<area>-end` lines areas
+ * imply). Line indices are 0-based; indices outside `0 … explicitCount`
+ * are implicit lines. */
+export interface AxisLines {
+    explicitCount: number;
+    names: string[][];
+}
+/**
+ * Resolve one axis of an item's placement from the two line longhands
+ * (CSS §8.3). Both lines definite: start = the earlier line, span = the
+ * distance (equal lines → the end line is discarded, span 1). One
+ * definite line + a span → definite. Only spans (or nothing) →
+ * indefinite with the requested span (a named span against `auto` is a
+ * plain span — specs/grid.md deviation).
+ */
+export declare function resolveAxisPlacement(startLine: GridLine, endLine: GridLine, lines: AxisLines): AxisSpec;
+interface PlacedAxis {
+    start: number;
+    span: number;
+}
+interface PlacementResult {
+    items: {
+        col: PlacedAxis;
+        row: PlacedAxis;
+    }[];
+    colOrigin: number;
+    colCount: number;
+    rowOrigin: number;
+    rowCount: number;
+}
+/**
+ * CSS §8.5 auto-placement. The flow's major axis grows (rows for `row`
+ * flow); the minor axis has a bounded track count. Sparse (default): the
+ * cursor only moves forward; `dense` restarts the scan from the grid's
+ * start for every item. Items are expected in order-then-document order.
+ */
+export declare function placeItems(specs: {
+    col: AxisSpec;
+    row: AxisSpec;
+}[], explicitCols: number, explicitRows: number, flow: GridAutoFlow): PlacementResult;
+interface SizingItem {
+    start: number;
+    span: number;
+    /** Min-content outer contribution (cells). */
+    min: number;
+    /** Max-content outer contribution (cells). */
+    max: number;
+}
+interface SizingResult {
+    sizes: number[];
+    /** Gap preceding each track (0 for the first and for collapsed tracks). */
+    gapBefore: number[];
+    /** Final growth limits (for the container's max-content size). */
+    limits: number[];
+}
+/**
+ * Size one axis's tracks. `space` is the definite inner size in the axis,
+ * or the intrinsic sizing constraint when the axis is indefinite:
+ * `"max-content"` for actual layout of an unbounded axis (rows of an
+ * auto-height container), `"min-content"` for the container's min-content
+ * measure. Steps: initialize from the minmax pairs; grow intrinsic
+ * bases/limits from item contributions in ascending span order
+ * (equal-weight integer distribution — specs/grid.md deviation); clamp
+ * bases to fixed limits (the limit wins, emulating the spec's
+ * limited-contribution rule). Definite: maximize bases up to limits
+ * (§11.6), distribute the leftover to fr tracks floored at their bases
+ * (§11.7), stretch auto-limited tracks over any remainder when the axis's
+ * content-distribution is `stretch` (§11.8). Indefinite: fr tracks size
+ * to the shared flex fraction (§11.7 with indefinite space), and under
+ * the max-content constraint every track maximizes to its growth limit —
+ * a fixed minmax max fills even without content, per CSS (§11.6's
+ * infinite free space; all three browser engines agree).
+ */
+export declare function sizeTracks(trackSizes: TrackSize[], collapsed: boolean[], items: SizingItem[], space: number | "min-content" | "max-content", gap: number, stretchAuto: boolean): SizingResult;
+export {};
+//# sourceMappingURL=grid.d.ts.map

package/dist/grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../src/grid.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAEV,YAAY,EACZ,QAAQ,EAGR,MAAM,EAEN,UAAU,EAIV,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AAEH,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,MAAM,CAkPR;AA+OD;;;;iEAIiE;AACjE,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,cAAc,GACpB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA8B9B;AAwTD,UAAU,QAAQ;IAChB;;8CAE0C;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;yBAIyB;AACzB,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;CACnB;AAwDD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,KAAK,EAAE,SAAS,GACf,QAAQ,CAkBV;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,eAAe;IACvB,KAAK,EAAE;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAA;CAAE,EAAE,EACzC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,YAAY,GACjB,eAAe,CAyIjB;AAKD,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAkBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,SAAS,EAAE,EACvB,SAAS,EAAE,OAAO,EAAE,EACpB,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,EAC7C,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,OAAO,GACnB,YAAY,CA4Qd"}