@markdy/core 0.8.20 → 0.8.21

package/dist/index.d.ts

@@ -4,7 +4,7 @@
  */
 type LayoutDirection = "LR" | "RL" | "TB" | "BT";
 type EdgeKind = "request" | "response" | "event" | "dependency";
-type DiagramType = "architecture" | "flowchart" | "tree" | "state" | "sequence" | "constellation";
+type DiagramType = "architecture" | "flowchart" | "tree" | "state" | "sequence" | "constellation" | "loop" | "flywheel" | "medallion" | "quadrant" | "swimlane" | "pyramid" | "radar" | "timeline" | "gantt" | "venn" | "layers" | "nested";
 type NodeShape = "card" | "rounded" | "diamond" | "circle" | "pill" | "terminal";
 type SceneMeta = {
     title?: string;
@@ -60,6 +60,8 @@ type AnnotationDecl = {
     text: string;
     target?: string;
     position?: string;
+    /** Callout color intent: neutral (default), accent, or muted. */
+    intent?: string;
     props: Record<string, unknown>;
     line: number;
 };
@@ -185,6 +187,8 @@ type ThemeTokens = {
     flatCards?: boolean;
     roles: Record<string, string>;
     edges: Record<EdgeKind, string>;
+    /** Multi-series palette for chart types (radar, line, bar). */
+    series?: string[];
     fonts?: {
         title?: string;
         nodeName?: string;
@@ -325,6 +329,25 @@ declare function parseAndCompile(source: string): ParseResult;
 declare const THEMES: Record<string, ThemeTokens>;
 declare function resolveTheme(name: string): ThemeTokens;
 
+/**
+ * packages/core/src/theme-generator.ts
+ * Algorithmic Theme Token Generator for Markdy.
+ * Computes WCAG-compliant high-contrast theme palettes from any base brand color.
+ * Zero external dependencies.
+ */
+
+interface ThemeGeneratorOptions {
+    name: string;
+    accentHex: string;
+    mode?: "light" | "dark";
+    canvasHex?: string;
+    inkHex?: string;
+}
+/**
+ * Dynamically computes a cohesive ThemeTokens set from an accent color.
+ */
+declare function generateThemeFromBrand(opts: ThemeGeneratorOptions): ThemeTokens;
+
 declare const NODE_KINDS: Set<string>;
 declare const DIAGRAM_TYPES: Set<string>;
 declare const EDGE_OPERATORS: Record<string, "request" | "response" | "event" | "dependency">;
@@ -338,8 +361,180 @@ declare function humanizeId(id: string): string;
 declare const NODE_ALIASES: Record<string, string>;
 declare function canonicalNodeKind(kind: string): string;
 
-declare const TECHNICAL_NODE_TYPES: readonly ["service", "api", "microservice", "backend", "server", "worker", "job", "scheduler", "cron", "batch", "function", "lambda", "edge", "controller", "handler", "repository", "module", "package", "library", "sdk", "cli", "runtime", "process", "client", "user", "browser", "web", "mobile", "desktop", "frontend", "app", "page", "view", "component", "store", "db", "database", "sql", "nosql", "table", "index", "warehouse", "lake", "object_store", "bucket", "blob", "volume", "disk", "search", "cache", "queue", "topic", "stream", "event", "event_bus", "bus", "broker", "pubsub", "kafka", "producer", "consumer", "dead_letter", "dlq", "webhook", "cloud", "region", "vpc", "subnet", "network", "internet", "dns", "cdn", "proxy", "gateway", "api_gateway", "load_balancer", "reverse_proxy", "router", "switch", "nat", "firewall", "waf", "vpn", "bastion", "container", "cluster", "pod", "node", "deployment", "replicaset", "statefulset", "daemonset", "namespace", "ingress", "service_mesh", "sidecar", "image", "registry", "docker", "compose", "helm", "chart", "configmap", "pvc", "auth", "identity", "oauth", "oidc", "jwt", "session", "policy", "role", "permission", "vault", "secret", "key", "certificate", "repo", "branch", "commit", "pipeline", "workflow", "runner", "build", "test", "artifact", "deploy", "release", "environment", "preview", "monitor", "metrics", "logs", "trace", "alert", "dashboard", "probe", "slo", "start", "end", "state", "decision", "condition", "step", "loop", "sequence", "participant", "replica", "shard", "leader", "follower", "quorum", "consensus", "lock", "class", "interface", "method", "object", "enum", "type"];
-declare const VISUAL_PRIMITIVE_TYPES: readonly ["panel", "surface", "terminal", "metric", "stat", "grid", "matrix", "lane", "track", "marker", "dot", "token_strip", "chips", "glyph_card", "glyph"];
+declare const TECHNICAL_NODE_TYPES: readonly ["service", "api", "microservice", "backend", "server", "worker", "job", "scheduler", "cron", "batch", "function", "lambda", "edge", "controller", "handler", "repository", "module", "package", "library", "sdk", "cli", "runtime", "process", "client", "user", "browser", "web", "mobile", "desktop", "frontend", "app", "page", "view", "component", "store", "db", "database", "sql", "nosql", "table", "index", "warehouse", "lake", "object_store", "storage", "bucket", "blob", "volume", "disk", "search", "cache", "queue", "topic", "stream", "event", "event_bus", "bus", "broker", "pubsub", "kafka", "producer", "consumer", "dead_letter", "dlq", "webhook", "cloud", "region", "vpc", "subnet", "network", "internet", "dns", "cdn", "proxy", "gateway", "api_gateway", "load_balancer", "reverse_proxy", "router", "switch", "nat", "firewall", "waf", "vpn", "bastion", "container", "cluster", "pod", "node", "deployment", "replicaset", "statefulset", "daemonset", "namespace", "ingress", "service_mesh", "sidecar", "image", "registry", "docker", "compose", "helm", "chart", "configmap", "pvc", "auth", "identity", "oauth", "oidc", "jwt", "session", "policy", "role", "permission", "vault", "secret", "key", "certificate", "security", "repo", "branch", "commit", "pipeline", "workflow", "runner", "build", "test", "artifact", "deploy", "release", "environment", "preview", "monitor", "metrics", "logs", "trace", "alert", "dashboard", "probe", "slo", "start", "end", "state", "decision", "condition", "step", "loop", "sequence", "participant", "hub", "station", "bronze", "silver", "gold", "lane", "replica", "shard", "leader", "follower", "quorum", "consensus", "lock", "class", "interface", "method", "object", "enum", "type"];
+declare const VISUAL_PRIMITIVE_TYPES: readonly ["panel", "surface", "terminal", "metric", "stat", "grid", "matrix", "lane", "track", "marker", "dot", "token_strip", "chips", "glyph_card", "glyph", "external", "optional"];
 declare const TECHNICAL_NODE_KINDS: Record<(typeof TECHNICAL_NODE_TYPES)[number], string>;
 
-export { type AnnotationDecl, BEAT_CUE_KEYWORDS, type BeatDecl, type BeatRange, CUE_ALIASES, type Cue, DIAGRAM_TYPES, type Diagnostic, type DiagramAST, type DiagramType, EDGE_OPERATORS, type EdgeDecl, type EdgeKind, type FlowSegment, type GroupBoundary, type GroupDecl, type LayoutDirection, NODE_ALIASES, NODE_KINDS, type NodeDecl, type NodeShape, ParseError, type ParseOptions, type ParseResult, type PatternDecl, type PositionedNode, type RenderPlan, type RoutedEdge, SCENE_KEYS, type SceneMeta, type SequenceActivation, type SequenceMessage, type StyleDecl, TECHNICAL_NODE_KINDS, TECHNICAL_NODE_TYPES, THEMES, type ThemeTokens, type TimedCue, type TreeBus, VISUAL_PRIMITIVE_TYPES, canonicalNodeKind, compile, compilePlan, humanizeId, nodeRole, parse, parseAndCompile, resolveTheme };
+/**
+ * packages/core/src/arch-lint.ts
+ * Architecture topology and governance validation for MarkdyScript ASTs.
+ * Zero runtime dependencies.
+ */
+
+type RuleSeverity = "error" | "warning" | "info";
+type ArchRuleType = "cannot-connect" | "must-connect" | "forbidden-cycle" | "must-have-role" | "role-count-limit";
+interface NodeSelector {
+    id?: string;
+    kindEquals?: string;
+    roleEquals?: string;
+    labelContains?: string;
+}
+interface EdgeSelector {
+    kind?: EdgeKind;
+    labelContains?: string;
+}
+interface ArchitectureRule {
+    id: string;
+    name: string;
+    description: string;
+    severity: RuleSeverity;
+    type: ArchRuleType;
+    from?: NodeSelector;
+    to?: NodeSelector;
+    edge?: EdgeSelector;
+    min?: number;
+    max?: number;
+}
+interface ArchitectureViolation {
+    ruleId: string;
+    ruleName: string;
+    message: string;
+    severity: RuleSeverity;
+    nodeIds: string[];
+    edgeKeys: string[];
+    line?: number;
+}
+interface ArchitecturePreset {
+    id: string;
+    name: string;
+    description: string;
+    rules: ArchitectureRule[];
+}
+declare const ARCH_RULE_PRESETS: Record<string, ArchitecturePreset>;
+declare function validateArchitecture(ast: DiagramAST, rules?: ArchitectureRule[]): ArchitectureViolation[];
+interface MarkdyConfig {
+    extends?: string[];
+    rules?: (ArchitectureRule | string)[];
+    severityOverrides?: Record<string, RuleSeverity>;
+}
+declare function resolveArchitectureConfig(config?: MarkdyConfig | null): ArchitectureRule[];
+
+/**
+ * packages/core/src/classifier.ts
+ * Deep Technology and Semantic Classifier for Markdy.
+ * Zero external dependencies.
+ */
+interface SemanticProfile {
+    kind: string;
+    role: string;
+    suggestedTheme: string;
+    badge?: string;
+}
+declare function classifyTechnology(id: string, label?: string): SemanticProfile;
+
+/**
+ * packages/core/src/diff.ts
+ * Semantic AST Diffing and Architectural Evolution for MarkdyScript.
+ * Zero external dependencies.
+ */
+
+type DiffChangeType = "added" | "removed" | "modified" | "unchanged";
+interface NodeDiff {
+    id: string;
+    status: DiffChangeType;
+    before?: NodeDecl;
+    after?: NodeDecl;
+    changes: string[];
+}
+interface EdgeDiff {
+    key: string;
+    status: DiffChangeType;
+    before?: EdgeDecl;
+    after?: EdgeDecl;
+}
+interface DiagramDiffResult {
+    nodes: NodeDiff[];
+    edges: EdgeDiff[];
+    addedNodesCount: number;
+    removedNodesCount: number;
+    modifiedNodesCount: number;
+    summaryMarkdown: string;
+    evolutionMarkdyScript: string;
+}
+declare function diffDiagramASTs(beforeAST: DiagramAST, afterAST: DiagramAST): DiagramDiffResult;
+
+/**
+ * packages/core/src/url-codec.ts
+ * Web Standard CompressionStream / DecompressionStream state codec for Markdy.
+ * Zero external dependencies. Works across modern browsers, Node, Bun, Deno.
+ */
+declare function compressMarkdyToUrlHash(code: string): Promise<string>;
+declare function decompressMarkdyFromUrlHash(hash: string): Promise<string>;
+
+/**
+ * packages/core/src/router.ts
+ * Collision-aware Orthogonal Manhattan Router for Markdy.
+ * Zero external dependencies.
+ */
+interface Point {
+    x: number;
+    y: number;
+}
+interface Box {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+type CardinalPort = "left" | "right" | "top" | "bottom";
+interface RoutedPath {
+    sourcePort: CardinalPort;
+    targetPort: CardinalPort;
+    startPoint: Point;
+    endPoint: Point;
+    waypoints: Point[];
+    svgPathData: string;
+}
+declare function getBoxPortPosition(box: Box, port: CardinalPort): Point;
+declare function selectOptimalPorts(sourceBox: Box, targetBox: Box): {
+    sourcePort: CardinalPort;
+    targetPort: CardinalPort;
+};
+declare function routeOrthogonalEdge(sourceBox: Box, targetBox: Box): RoutedPath;
+
+/**
+ * packages/core/src/ai-healing.ts
+ * Self-healing AI Prompt Generation & Diagnostic Repair Loop for Markdy.
+ * Zero external dependencies.
+ */
+
+interface RepairPromptBundle {
+    isValid: boolean;
+    repairPrompt?: string;
+    syntaxErrors: string[];
+    archViolations: ArchitectureViolation[];
+}
+declare function analyzeAndBuildRepairPrompt(sourceCode: string): RepairPromptBundle;
+
+/**
+ * Output size presets for various export targets.
+ * Maps named presets to viewBox dimensions and safe margins.
+ */
+interface OutputPreset {
+    name: string;
+    width: number;
+    height: number;
+    /** Safe margin inset from each edge (px). */
+    safeArea: number;
+    /** Aspect ratio label for human display. */
+    aspect: string;
+    /** Intended output context. */
+    context: string;
+}
+declare const OUTPUT_PRESETS: Record<string, OutputPreset>;
+/** Resolve a preset by name, falling back to doc-inline. */
+declare function resolveOutputPreset(name: string): OutputPreset;
+/** List all available preset names. */
+declare function listOutputPresets(): string[];
+
+export { ARCH_RULE_PRESETS, type AnnotationDecl, type ArchRuleType, type ArchitecturePreset, type ArchitectureRule, type ArchitectureViolation, BEAT_CUE_KEYWORDS, type BeatDecl, type BeatRange, type Box, CUE_ALIASES, type CardinalPort, type Cue, DIAGRAM_TYPES, type Diagnostic, type DiagramAST, type DiagramDiffResult, type DiagramType, type DiffChangeType, EDGE_OPERATORS, type EdgeDecl, type EdgeDiff, type EdgeKind, type EdgeSelector, type FlowSegment, type GroupBoundary, type GroupDecl, type LayoutDirection, type MarkdyConfig, NODE_ALIASES, NODE_KINDS, type NodeDecl, type NodeDiff, type NodeSelector, type NodeShape, OUTPUT_PRESETS, type OutputPreset, ParseError, type ParseOptions, type ParseResult, type PatternDecl, type Point, type PositionedNode, type RenderPlan, type RepairPromptBundle, type RoutedEdge, type RoutedPath, type RuleSeverity, SCENE_KEYS, type SceneMeta, type SemanticProfile, type SequenceActivation, type SequenceMessage, type StyleDecl, TECHNICAL_NODE_KINDS, TECHNICAL_NODE_TYPES, THEMES, type ThemeGeneratorOptions, type ThemeTokens, type TimedCue, type TreeBus, VISUAL_PRIMITIVE_TYPES, analyzeAndBuildRepairPrompt, canonicalNodeKind, classifyTechnology, compile, compilePlan, compressMarkdyToUrlHash, decompressMarkdyFromUrlHash, diffDiagramASTs, generateThemeFromBrand, getBoxPortPosition, humanizeId, listOutputPresets, nodeRole, parse, parseAndCompile, resolveArchitectureConfig, resolveOutputPreset, resolveTheme, routeOrthogonalEdge, selectOptimalPorts, validateArchitecture };