schematex 0.1.0

package/dist/index-BXefHVce.d.cts

@@ -0,0 +1,150 @@
+import { n as FlowchartAST, o as FlowchartLayoutResult, b as DiagramPlugin } from './types-DqfcYkcY.cjs';
+
+/**
+ * Flowchart DSL parser (M1).
+ *
+ * Supports a mermaid-inspired subset:
+ *   flowchart TD | TB | BT | LR | RL
+ *   A[Label]              rect
+ *   A(Label)              round
+ *   A([Label])            stadium
+ *   A{Label}              diamond
+ *   A[/Label/]            parallelogram
+ *   A --> B               solid edge
+ *   A --- B               no-arrow edge
+ *   A -.-> B              dotted
+ *   A ==> B               thick
+ *   A <--> B              bidirectional
+ *   A --x B               crossed end
+ *   A --o B               round end
+ *   A -->|yes| B          edge with pipe label
+ *   A -- yes --> B        edge with inline label
+ *   A --> B --> C         chain
+ *   %% comment
+ *
+ * Hand-written tokenizer + recursive descent. Zero deps.
+ */
+
+/** Top-level parser entry. */
+declare function parseFlowchart(source: string): FlowchartAST;
+
+/**
+ * Flowchart Sugiyama-style layered layout (M1).
+ *
+ * Phases:
+ *   1. Cycle removal — Greedy-FAS (Eades-Lin-Smyth 1993)
+ *   2. Layer assignment — Longest-path layering
+ *   3. Dummy node insertion for edges spanning > 1 layer
+ *   4. Crossing minimization — median heuristic, bi-directional sweep
+ *   5. X-coordinate assignment — simple symmetric pass
+ *      (Brandes-Köpf full 4-alignment is deferred; for M1 a centered
+ *       median-based placement produces visually indistinguishable results
+ *       on graphs ≤ 20 nodes, which is the M1 target.)
+ *
+ * Zero runtime dependencies. All heuristics hand-written.
+ */
+
+declare const FC_CONST: {
+    readonly nodeWidth: 120;
+    readonly nodeHeight: 44;
+    readonly nodeSpacingX: 32;
+    readonly layerSpacingY: 56;
+    readonly dummyWidth: 1;
+    readonly padding: 24;
+    readonly charWidth: 6.8;
+    readonly labelHPad: 16;
+    readonly minNodeWidth: 72;
+    readonly maxLabelWidth: 220;
+    readonly crossingSweepIters: 24;
+};
+declare function layoutFlowchart(ast: FlowchartAST): FlowchartLayoutResult;
+
+/**
+ * Shared design-token system for all Schematex diagram renderers.
+ *
+ * Two-layer architecture:
+ *   1. BaseTheme — universal tokens every diagram uses
+ *   2. Semantic extensions — diagram-family tokens (PersonTokens, BiologyTokens, …)
+ *
+ * Three built-in presets: default, monochrome, dark.
+ * All tokens are also exposed as CSS custom properties (--schematex-*)
+ * so consumers can override them.
+ */
+type ThemeName = "default" | "monochrome" | "dark";
+interface BaseTheme {
+    bg: string;
+    text: string;
+    textMuted: string;
+    stroke: string;
+    fill: string;
+    fillMuted: string;
+    /** Emphasis / interactive / link color. Use for net labels, focus, selected. */
+    accent: string;
+    positive: string;
+    negative: string;
+    /** Mid-gray. Use for muted strokes, neutral-valence edges, dashed separators. */
+    neutral: string;
+    warn: string;
+    /** Category palette — 8 distinguishable colors for ecomap systems, sociogram groups, etc. */
+    palette: readonly string[];
+}
+interface PersonTokens {
+    maleFill: string;
+    femaleFill: string;
+    unknownFill: string;
+    deceasedMark: string;
+    conditionFill: string;
+}
+interface BiologyTokens {
+    cladeColors: readonly string[];
+    supportGood: string;
+    supportMedium: string;
+    supportWarn: string;
+    supportBad: string;
+}
+/**
+ * Tokens for set-theory diagrams (Venn / Euler). Paletteof set fills is
+ * tuned slightly softer than BaseTheme to blend nicely under
+ * `mix-blend-mode: multiply`.
+ */
+interface VennTokens {
+    vennSetColors: readonly string[];
+    vennBlendMode: "multiply" | "screen" | "none";
+    vennSetOpacity: number;
+    vennSetStroke: string;
+    vennLabelColor: string;
+    vennCountColor: string;
+    vennLeaderColor: string;
+}
+type ResolvedTheme<T = object> = BaseTheme & T;
+declare const BASE_THEMES: Record<ThemeName, BaseTheme>;
+declare const PERSON_TOKENS: Record<ThemeName, PersonTokens>;
+declare const BIOLOGY_TOKENS: Record<ThemeName, BiologyTokens>;
+declare const VENN_TOKENS: Record<ThemeName, VennTokens>;
+declare function resolveBaseTheme(name: string): BaseTheme;
+declare function resolvePersonTheme(name: string): ResolvedTheme<PersonTokens>;
+declare function resolveBiologyTheme(name: string): ResolvedTheme<BiologyTokens>;
+/**
+ * Fishbone uses BaseTheme directly — its bone colors come from `theme.palette`.
+ * Kept as a named resolver so callers don't have to know that.
+ */
+declare function resolveFishboneTheme(name: string): BaseTheme;
+declare function resolveVennTheme(name: string): ResolvedTheme<VennTokens>;
+declare function resolveGenogramTheme(name: string): ResolvedTheme<PersonTokens>;
+
+/**
+ * Flowchart renderer — LayoutResult → SVG string.
+ *
+ * Produces semantic, themeable SVG per spec §12:
+ *   - <title>/<desc> for a11y
+ *   - data-* attributes for interaction hooks
+ *   - CSS custom properties from resolveBaseTheme
+ *   - Arrowhead markers in <defs>
+ */
+
+declare function renderFlowchartAST(ast: FlowchartAST, themeName?: ThemeName): string;
+declare function renderFlowchart(text: string, themeName?: ThemeName): string;
+
+declare const flowchart: DiagramPlugin;
+
+export { BASE_THEMES as B, FC_CONST as F, PERSON_TOKENS as P, type ResolvedTheme as R, type ThemeName as T, VENN_TOKENS as V, BIOLOGY_TOKENS as a, type BaseTheme as b, type BiologyTokens as c, type PersonTokens as d, type VennTokens as e, flowchart as f, resolveBiologyTheme as g, resolveFishboneTheme as h, resolveGenogramTheme as i, resolvePersonTheme as j, resolveVennTheme as k, layoutFlowchart as l, renderFlowchart as m, renderFlowchartAST as n, parseFlowchart as p, resolveBaseTheme as r };