@sgummalla-works/sketchon 0.1.0

package/dist/domain/validate.js

@@ -0,0 +1,69 @@
+/**
+ * Validate structural integrity of a spec: unique node ids, edges/groups/
+ * annotations referencing real nodes, non-empty labels.
+ *
+ * @param spec the diagram spec to check
+ * @returns a list of issues; empty means valid
+ */
+export function validateSpec(spec) {
+    const issues = [];
+    if (!spec.id)
+        issues.push({ path: 'id', message: 'spec.id is required' });
+    if (!spec.kind)
+        issues.push({ path: 'kind', message: 'spec.kind is required' });
+    if (!Array.isArray(spec.nodes) || spec.nodes.length === 0) {
+        issues.push({ path: 'nodes', message: 'spec.nodes must be a non-empty array' });
+    }
+    const ids = new Set();
+    spec.nodes?.forEach((n, i) => {
+        if (!n.id)
+            issues.push({ path: `nodes[${i}].id`, message: 'node id is required' });
+        else if (ids.has(n.id))
+            issues.push({ path: `nodes[${i}].id`, message: `duplicate node id "${n.id}"` });
+        else
+            ids.add(n.id);
+        if (!n.label?.trim())
+            issues.push({ path: `nodes[${i}].label`, message: `node "${n.id}" has an empty label` });
+    });
+    spec.edges?.forEach((e, i) => {
+        if (!ids.has(e.from))
+            issues.push({ path: `edges[${i}].from`, message: `edge from unknown node "${e.from}"` });
+        if (!ids.has(e.to))
+            issues.push({ path: `edges[${i}].to`, message: `edge to unknown node "${e.to}"` });
+    });
+    const groupIds = new Set();
+    spec.groups?.forEach((g, i) => {
+        if (groupIds.has(g.id))
+            issues.push({ path: `groups[${i}].id`, message: `duplicate group id "${g.id}"` });
+        groupIds.add(g.id);
+        g.members.forEach((m) => {
+            if (!ids.has(m))
+                issues.push({ path: `groups[${i}].members`, message: `group "${g.id}" has unknown member "${m}"` });
+        });
+    });
+    spec.groups?.forEach((g, i) => {
+        if (g.parent && !groupIds.has(g.parent))
+            issues.push({ path: `groups[${i}].parent`, message: `group "${g.id}" has unknown parent "${g.parent}"` });
+    });
+    spec.annotations?.forEach((a, i) => {
+        if (a.target && !ids.has(a.target) && !groupIds.has(a.target))
+            issues.push({ path: `annotations[${i}].target`, message: `annotation targets unknown id "${a.target}"` });
+        if (!a.text?.trim())
+            issues.push({ path: `annotations[${i}].text`, message: 'annotation has empty text' });
+    });
+    // Categories: unique ids; nodes referencing a category must reference a real one.
+    const categoryIds = new Set();
+    spec.categories?.forEach((c, i) => {
+        if (categoryIds.has(c.id))
+            issues.push({ path: `categories[${i}].id`, message: `duplicate category id "${c.id}"` });
+        categoryIds.add(c.id);
+        if (!c.label?.trim())
+            issues.push({ path: `categories[${i}].label`, message: `category "${c.id}" has an empty label` });
+    });
+    spec.nodes?.forEach((n, i) => {
+        if (n.category && categoryIds.size > 0 && !categoryIds.has(n.category))
+            issues.push({ path: `nodes[${i}].category`, message: `node "${n.id}" references unknown category "${n.category}"` });
+    });
+    return issues;
+}
+//# sourceMappingURL=validate.js.map

package/dist/domain/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/domain/validate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @sgummalla-works/sketchon — public API + COMPOSITION ROOT.
+ *
+ * ── HEXAGONAL ARCHITECTURE — COMPOSITION ROOT RULES ──────────────────────────
+ * This file is the ONLY place in the package that may import concrete adapters.
+ * All other application/domain files must be free of adapter imports.
+ * The dependency rules are enforced by architecture guard tests
+ * (src/application/architecture.test.ts).
+ *
+ * Dependency flow (all arrows point inward):
+ *   adapters/ ──► application/ ──► domain/
+ *   adapters/ ──► ports/
+ *   index.ts (composition root) wires all layers together.
+ *
+ * ── STABLE PUBLIC API ────────────────────────────────────────────────────────
+ *   renderDiagram(spec)    → SVG + metadata (auto-routes engine)
+ *   validateSpec(spec)     → ValidationIssue[]  (pure, zero deps)
+ *   selectEngineKey(spec)  → EngineKey
+ *   selectEngine(spec)     → Technique
+ *   TECHNIQUES             → all registered engines (for the lab)
+ *   DiagramSpec + all spec types
+ */
+export * from './domain/spec.js';
+export * from './domain/validate.js';
+export * from './domain/theme.js';
+export type { Technique, RenderResult, PlacedBox, PlacedEdge, StructuralFeatures, } from './ports/Technique.js';
+export { TechniqueRegistry } from './application/registry.js';
+export { type EngineKey } from './application/router.js';
+export * from './constants.js';
+export { esc, estimateTextWidth, wrapText, palette, PALETTE, arrowDefs, svgDocument, } from './adapters/svg.js';
+export { loadFonts } from './adapters/fonts.js';
+export { emojiToDataUri, emojiCode } from './adapters/emoji.js';
+export { satoriTechnique } from './adapters/satori.js';
+export { elkTechnique } from './adapters/elk.js';
+export { sequenceTechnique } from './adapters/sequence.js';
+export { baselineTechnique } from './adapters/baseline.js';
+import { TechniqueRegistry } from './application/registry.js';
+/**
+ * The application-wide registry. Pre-populated with all built-in engines.
+ * Consumers may call `.register()` to add custom engines.
+ */
+export declare const REGISTRY: TechniqueRegistry;
+/** All registered techniques — used by the lab harness. */
+export declare const TECHNIQUES: import("./ports/Technique.js").Technique[];
+/**
+ * Select the engine key that would render a spec.
+ * Useful for logging / debugging which engine was chosen.
+ */
+export declare const selectEngineKey: (spec: import("./domain/spec.js").DiagramSpec) => import("./application/router.js").EngineKey;
+/**
+ * Resolve the Technique that will render a spec.
+ */
+export declare const selectEngine: (spec: import("./domain/spec.js").DiagramSpec) => import("./ports/Technique.js").Technique;
+/**
+ * Production render entry point.
+ * Validates routing and delegates to the chosen layout engine.
+ *
+ * @param spec the coordinate-free diagram spec
+ * @returns the rendered SVG + width/height/metadata
+ */
+export declare const renderDiagram: (spec: import("./domain/spec.js").DiagramSpec) => import("./ports/Technique.js").RenderResult | Promise<import("./ports/Technique.js").RenderResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAGlC,YAAY,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,UAAU,EACV,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,GAAG,EACH,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,MAAsB,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAE,eAAe,EAAE,MAAQ,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAW,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAO9D;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,iBAImB,CAAC;AAQ3C,2DAA2D;AAC3D,eAAO,MAAM,UAAU,4CAAwB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,eAAe,+FAAsC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,YAAY,4FAAmC,CAAC;AAE7D;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,sJAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,83 @@
+/**
+ * @sgummalla-works/sketchon — public API + COMPOSITION ROOT.
+ *
+ * ── HEXAGONAL ARCHITECTURE — COMPOSITION ROOT RULES ──────────────────────────
+ * This file is the ONLY place in the package that may import concrete adapters.
+ * All other application/domain files must be free of adapter imports.
+ * The dependency rules are enforced by architecture guard tests
+ * (src/application/architecture.test.ts).
+ *
+ * Dependency flow (all arrows point inward):
+ *   adapters/ ──► application/ ──► domain/
+ *   adapters/ ──► ports/
+ *   index.ts (composition root) wires all layers together.
+ *
+ * ── STABLE PUBLIC API ────────────────────────────────────────────────────────
+ *   renderDiagram(spec)    → SVG + metadata (auto-routes engine)
+ *   validateSpec(spec)     → ValidationIssue[]  (pure, zero deps)
+ *   selectEngineKey(spec)  → EngineKey
+ *   selectEngine(spec)     → Technique
+ *   TECHNIQUES             → all registered engines (for the lab)
+ *   DiagramSpec + all spec types
+ */
+// ── Domain (pure — zero external deps) ───────────────────────────────────────
+export * from './domain/spec.js';
+export * from './domain/validate.js';
+export * from './domain/theme.js';
+// ── Application (registry + router — no adapter imports) ──────────────────────
+export { TechniqueRegistry } from './application/registry.js';
+export {} from './application/router.js';
+// ── Constants + shared render helpers ────────────────────────────────────────
+export * from './constants.js';
+export { esc, estimateTextWidth, wrapText, palette, PALETTE, arrowDefs, svgDocument, } from './adapters/svg.js';
+// ── Node-only loaders (filesystem — not browser-safe) ────────────────────────
+export { loadFonts } from './adapters/fonts.js';
+export { emojiToDataUri, emojiCode } from './adapters/emoji.js';
+// ── Concrete adapters (exported for advanced use + the lab) ───────────────────
+export { satoriTechnique } from './adapters/satori.js';
+export { elkTechnique } from './adapters/elk.js';
+export { sequenceTechnique } from './adapters/sequence.js';
+export { baselineTechnique } from './adapters/baseline.js';
+// ── COMPOSITION ROOT ──────────────────────────────────────────────────────────
+// Wire all adapters into the registry. This is the only place that is allowed
+// to import adapters. Everything below is infrastructure glue.
+import { TechniqueRegistry } from './application/registry.js';
+import { Router } from './application/router.js';
+import { satoriTechnique } from './adapters/satori.js';
+import { elkTechnique } from './adapters/elk.js';
+import { sequenceTechnique } from './adapters/sequence.js';
+import { baselineTechnique } from './adapters/baseline.js';
+/**
+ * The application-wide registry. Pre-populated with all built-in engines.
+ * Consumers may call `.register()` to add custom engines.
+ */
+export const REGISTRY = new TechniqueRegistry()
+    .register('baseline', baselineTechnique)
+    .register('satori', satoriTechnique)
+    .register('elk', elkTechnique)
+    .register('sequence', sequenceTechnique);
+/**
+ * The application-wide router, wired to the shared registry.
+ * Exposes the primary use-case functions as bound methods.
+ */
+const router = new Router(REGISTRY);
+/** All registered techniques — used by the lab harness. */
+export const TECHNIQUES = REGISTRY.techniques();
+/**
+ * Select the engine key that would render a spec.
+ * Useful for logging / debugging which engine was chosen.
+ */
+export const selectEngineKey = router.selectEngineKey.bind(router);
+/**
+ * Resolve the Technique that will render a spec.
+ */
+export const selectEngine = router.selectEngine.bind(router);
+/**
+ * Production render entry point.
+ * Validates routing and delegates to the chosen layout engine.
+ *
+ * @param spec the coordinate-free diagram spec
+ * @returns the rendered SVG + width/height/metadata
+ */
+export const renderDiagram = router.renderDiagram.bind(router);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,gFAAgF;AAChF,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAWlC,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAkB,MAAM,yBAAyB,CAAC;AAEzD,gFAAgF;AAChF,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,GAAG,EACH,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,OAAO,EAAE,SAAS,EAAE,MAAsB,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAQ,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAW,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,iFAAiF;AACjF,8EAA8E;AAC9E,+DAA+D;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAQ,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAW,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsB,IAAI,iBAAiB,EAAE;KAC/D,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;KACvC,QAAQ,CAAC,QAAQ,EAAI,eAAe,CAAC;KACrC,QAAQ,CAAC,KAAK,EAAO,YAAY,CAAC;KAClC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC"}

package/dist/ports/Technique.d.ts

@@ -0,0 +1,69 @@
+/**
+ * The Technique port — the single contract every layout engine must implement.
+ *
+ * A Technique is the "half B" of the pipeline: it takes a coordinate-free
+ * DiagramSpec and produces a rendered SVG. The application layer depends only
+ * on this interface — never on a concrete adapter (Satori, ELK, Sequence…).
+ * New engines are added by implementing this interface and registering them;
+ * no existing code changes.
+ */
+import type { DiagramSpec } from '../domain/spec.js';
+/** An axis-aligned box placed by the layout engine, for geometry eval. */
+export interface PlacedBox {
+    id: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    label: string;
+    fontSize: number;
+    /** Actual width of the widest rendered line (for wrapped labels). */
+    contentWidth?: number;
+    role: 'node' | 'group' | 'annotation';
+}
+/** A straight edge segment, for crossing detection. */
+export interface PlacedEdge {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    fromId: string;
+    toId: string;
+}
+/**
+ * Structural features a technique actually rendered.
+ * Used by the fidelity metric to detect "geometrically clean but wrong kind
+ * of picture" — a geometry score alone cannot tell a box-stack from a rich
+ * card-column.
+ */
+export interface StructuralFeatures {
+    cards: boolean;
+    checkpoints: boolean;
+    twoColumn: boolean;
+    legend: boolean;
+    categoryColors: boolean;
+}
+/** The complete output of a layout engine for a single spec. */
+export interface RenderResult {
+    svg: string;
+    width: number;
+    height: number;
+    /** Omit when overlap is structurally impossible (e.g. Satori flexbox). */
+    boxes?: PlacedBox[];
+    edges?: PlacedEdge[];
+    features?: StructuralFeatures;
+}
+/**
+ * The Strategy interface every rendering adapter implements.
+ * `render` may be async — Satori is asynchronous.
+ */
+export interface Technique {
+    /** Stable key used to select this engine from the registry. */
+    readonly key: string;
+    /** Human label shown in the gallery header. */
+    readonly name: string;
+    /** One-line blurb describing the approach. */
+    readonly blurb: string;
+    render(spec: DiagramSpec): RenderResult | Promise<RenderResult>;
+}
+//# sourceMappingURL=Technique.d.ts.map

package/dist/ports/Technique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Technique.d.ts","sourceRoot":"","sources":["../../src/ports/Technique.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;CACvC;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACjE"}

package/dist/ports/Technique.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Technique.js.map

package/dist/ports/Technique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Technique.js","sourceRoot":"","sources":["../../src/ports/Technique.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@sgummalla-works/sketchon",
+  "version": "0.1.0",
+  "description": "Sketchon — coordinate-free diagram rendering. A model authors the spec; a deterministic engine computes every pixel. Spec in, SVG out.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "assets/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prebuild": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sgummalla79/sgummalla_works_js_packages"
+  },
+  "keywords": [
+    "diagram",
+    "rendering",
+    "svg",
+    "satori",
+    "elkjs",
+    "browser",
+    "react"
+  ],
+  "dependencies": {
+    "elkjs": "^0.11.0",
+    "satori": "^0.26.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.7"
+  }
+}