@squinch/core 0.1.0

package/dist/grammar/parser.terms.js

@@ -0,0 +1,115 @@
+// This file was generated by lezer-generator. You probably shouldn't edit it.
+export const
+  Comment = 1,
+  File = 2,
+  PackStmt = 4,
+  Ident = 5,
+  pack = 6,
+  from = 7,
+  String = 8,
+  PersonDecl = 9,
+  person = 10,
+  Tag = 11,
+  Container = 12,
+  system = 13,
+  container = 14,
+  NodeKind = 15,
+  external = 16,
+  datastore = 17,
+  ContainerBody = 20,
+  NodeDecl = 21,
+  IconRef = 23,
+  box = 25,
+  AttrBlock = 26,
+  Attr = 28,
+  Value = 30,
+  Number = 31,
+  Path = 32,
+  EdgeStmt = 33,
+  Arrow = 34,
+  PathList = 35,
+  ZoneDecl = 36,
+  zone = 37,
+  ZoneKind = 38,
+  ZoneBody = 39,
+  ContainsStmt = 40,
+  contains = 41,
+  FlowDecl = 42,
+  flow = 43,
+  FlowBody = 44,
+  FlowChain = 45,
+  View = 46,
+  view = 47,
+  ViewBody = 48,
+  TitleStmt = 49,
+  title = 50,
+  ThemeStmt = 51,
+  theme = 52,
+  ScopeStmt = 53,
+  scope = 54,
+  OnlyStmt = 55,
+  only = 56,
+  TargetList = 57,
+  Target = 58,
+  IncludeStmt = 59,
+  include = 60,
+  Star = 61,
+  ExcludeStmt = 63,
+  exclude = 64,
+  DetailStmt = 65,
+  detail = 66,
+  ExpandStmt = 67,
+  expand = 68,
+  ContextStmt = 69,
+  context = 70,
+  auto = 71,
+  off = 72,
+  HighlightStmt = 73,
+  highlight = 74,
+  ColorStmt = 75,
+  color = 76,
+  ShowStmt = 77,
+  show = 78,
+  descriptions = 79,
+  NoteStmt = 80,
+  note = 81,
+  NoteAnchor = 82,
+  RelPos = 83,
+  above = 86,
+  below = 87,
+  on = 88,
+  Corner = 89,
+  LegendStmt = 94,
+  legend = 95,
+  TitleBlockStmt = 96,
+  titleblock = 97,
+  LayoutBlock = 98,
+  layout = 99,
+  DirectionStmt = 100,
+  direction = 101,
+  down = 102,
+  right = 103,
+  LinesStmt = 104,
+  lines = 105,
+  DensityStmt = 106,
+  density = 107,
+  RowsStmt = 108,
+  rows = 109,
+  Rank = 112,
+  ColsStmt = 113,
+  cols = 114,
+  PlaceStmt = 115,
+  place = 116,
+  AlignStmt = 117,
+  align = 118,
+  RouteStmt = 119,
+  route = 120,
+  Side = 121,
+  north = 122,
+  south = 123,
+  east = 124,
+  west = 125,
+  to = 126,
+  ChannelStmt = 127,
+  channel = 128,
+  FileTheme = 129

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import "./packs/node-fs.js";
+export * from "./api.js";
+export { registerPack, preloadIcons, packInfo } from "./packs/registry.js";
+export type { PackManifest, AssetLoader } from "./packs/registry.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+// Node entry: registers packs found on disk, then re-exports the pipeline.
+import "./packs/node-fs.js";
+export * from "./api.js";
+export { registerPack, preloadIcons, packInfo } from "./packs/registry.js";

package/dist/layout/layout.d.ts

@@ -0,0 +1,197 @@
+import type { VNode } from "../view/resolve.js";
+import type { SModel, SView, Side, Diagnostic, Hue, ZoneKind, ZoneLabelPos } from "../model/types.js";
+import type { ThemeFont } from "../themes/index.js";
+/** The shelf strip along a card's bottom: child icons, `+N`, domain chip. */
+export declare const SHELF_H = 30;
+/** How far the stacked sheets bleed past a container, right and below. Not
+ *  added to the node's size on purpose — see the comment at `canvasExtent`. */
+export declare const SHEET_BLEED = 8;
+/** Zone chip height (docs/design). Shared: the placer reserves it, the
+ *  renderer fills it, and the chip straddles its border by half of it. */
+export declare const CHIP_H = 22;
+/** Room a note reserves for its leading glyph, gutter included. Shared: layout
+ *  wraps text to what is left, the renderer draws the mark in it. */
+export declare const NOTE_GUTTER = 19;
+/** The pill a label will render as, measured with the layout's font — the
+ *  single source of truth shared by the ELK reservation (here) and the
+ *  renderer's pill text (svg.ts). If these two ever diverge, the reservation
+ *  is for a different pill than the one drawn. Cap 240 mirrors computePills'
+ *  maxW; the canvas-width term is unknowable before layout and only ever
+ *  shrinks tiny diagrams, where a slightly generous reservation is harmless. */
+export declare function pillDims(text: string, font: Pick<ThemeFont, "metrics" | "scale">): {
+    label: string;
+    w: number;
+    h: number;
+};
+/** The box a note will render as, and the lines inside it — the single source
+ *  of truth shared by every path that places one (edge notes, layer notes, the
+ *  candidate-ladder resolver) and by the renderer that draws it.
+ *
+ *  It is one function because it was briefly two. The resolver kept its own
+ *  copy of this arithmetic, so when notes gained a leading glyph only the
+ *  other copy learned about the gutter: corner and `right-of` notes reserved a
+ *  box 19px narrower than the text drawn into it, and the text ran out through
+ *  the side. Exactly the failure `pillDims` exists to prevent, in the one
+ *  place that had not been given the same treatment.
+ *
+ *  The column narrows by the gutter and the box widens by it, so the text
+ *  keeps its 12px right margin whatever the glyph does. */
+export declare function noteBox(text: string, font: Pick<ThemeFont, "metrics" | "scale">): {
+    lines: string[];
+    w: number;
+    h: number;
+};
+export interface PNode extends VNode {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    rank: number;
+}
+export interface PPort {
+    edge: string;
+    node: string;
+    side: Side;
+    x: number;
+    y: number;
+}
+export interface PFrame {
+    path: string;
+    label: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    color?: Hue;
+    /** Frame-chain nesting depth, outermost = 0. Counts *frames* only — a frame
+     *  inside a zone is still depth 0 — because the renderer keys the recessed
+     *  fill off it (depth 0 only; docs/notes/full-detail.md). */
+    depth: number;
+}
+export interface PZone {
+    id: string;
+    label: string;
+    kind: ZoneKind;
+    icon?: {
+        pack: string;
+        id: string;
+    };
+    labelPos: ZoneLabelPos;
+    color?: Hue;
+    /** mono chip segment — a CIDR, an account id (SPEC §zones) */
+    detail?: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    depth: number;
+}
+export interface PEdge {
+    id: string;
+    from: string;
+    to: string;
+    label?: string;
+    async: boolean;
+    animate?: import("../model/types.js").EdgeAnimate;
+    style?: "dashed" | "dotted";
+    count: number;
+    tags: string[];
+    color?: Hue;
+    heads: "one" | "both" | "none";
+    points: {
+        x: number;
+        y: number;
+    }[];
+    /** Label space reserved by ELK at layout time (cross-rank edges). The pill
+     *  is drawn exactly here — no search, no fallback, no way to collide: the
+     *  room exists because the layout made it. Coplanar edges get theirs from
+     *  the router (phase 2); until then they are undefined and the renderer's
+     *  search still covers them. */
+    labelRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    /** Produced by the coplanar router rather than ELK. ELK's wires may cross a
+     *  frame interior legitimately (it routes them around what it knows); ours
+     *  must not cross anything, and the invariant sweep holds us to it. */
+    coplanar?: true;
+}
+export interface Positioned {
+    name: string;
+    width: number;
+    height: number;
+    nodes: PNode[];
+    edges: PEdge[];
+    ports: PPort[];
+    frames: PFrame[];
+    zones: PZone[];
+    flow?: {
+        label: string;
+        byEdge: Record<string, number[]>;
+    };
+    lines: "orthogonal" | "curved" | "straight";
+    /** Zone label chips: geometry only — colour is a theme concern and layout
+     *  is theme-free (the adaptive contract shares one layout across palettes).
+     *  Slid along their zone's border to the least-crossed spot, exactly the
+     *  algorithm that lived in svg.ts. */
+    chips: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        label: string;
+        zone: string;
+        icon?: {
+            pack: string;
+            id: string;
+        };
+        /** mono segment text, and the width reserved for it — measured here so
+         *  the renderer draws the segment the placer actually made room for */
+        detail?: string;
+        detailW?: number;
+    }[];
+    /** Flow badges, reserved for the FULL flow's step text. Walking a flow
+     *  (`flowStep`) is a viewer concern: the renderer draws the walked subset
+     *  right-aligned inside the reservation, so per-step text changes never move
+     *  or collide with anything. */
+    badges: {
+        edgeId: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        nums: number[];
+    }[];
+    /** Fully placed notes, in declaration order: the resolver lives in layout
+     *  now. Text lines are pre-wrapped (font-derived, theme-free); style/colour
+     *  stay the renderer's. */
+    notes?: {
+        i: number;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+        lines: string[];
+        leader?: {
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+        };
+    }[];
+    /** Layout-reserved note boxes by view-note index — today the edge-anchored
+     *  ones (second inline labels on their own elk edge). The resolver draws a
+     *  reserved note exactly here and skips its candidate ladder. */
+    noteBoxes?: Map<number, {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+}
+export declare function layoutView(model: SModel, view: SView, font?: Pick<ThemeFont, "metrics" | "scale">): Promise<{
+    positioned: Positioned;
+    diagnostics: Diagnostic[];
+}>;