@streetui/compiler 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StreetUI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @streetui/compiler
+
+StreetUI compiler — DSL → validation → Semantic Application Graph
+
+Part of [StreetUI](https://github.com/streetui/streetui) — a semantic,
+signal-based UI framework with its own reactivity and keyed DOM reconciler
+(no virtual DOM).
+
+## Install
+
+```sh
+npm install @streetui/compiler
+```
+
+## Usage
+
+```ts
+import * as pkg from '@streetui/compiler';
+```
+
+Both ESM (`import`) and CommonJS (`require`) entry points are shipped, with
+matching TypeScript declarations.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,178 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  compile: () => compile,
+  compileGraph: () => compileGraph,
+  transformGraph: () => transformGraph,
+  validateGraph: () => validateGraph
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/compile.ts
+var import_core2 = require("@streetui/core");
+
+// src/validation/validator.ts
+var import_core = require("@streetui/core");
+function validateGraph(graph) {
+  const dc = new import_core.DiagnosticCollector();
+  dc.merge(graph.validate());
+  const pages = graph.findByType("page");
+  if (pages.length === 0) {
+    dc.warn(
+      "COMPILER_NO_PAGES",
+      "Application has no pages defined. At least one page is recommended."
+    );
+  }
+  graph.walk((node) => {
+    validateNode(node, dc);
+  });
+  return dc;
+}
+function validateNode(node, dc) {
+  switch (node.type) {
+    case "heading": {
+      const text = node.getProp("text");
+      if (text === void 0 || text === "") {
+        dc.warn("COMPILER_EMPTY_HEADING", `Heading node "${node.id}" has no text content`, {
+          nodeId: node.id
+        });
+      }
+      break;
+    }
+    case "image": {
+      const src = node.getProp("src");
+      const alt = node.getProp("alt");
+      if (!src) {
+        dc.error("COMPILER_IMAGE_NO_SRC", `Image node "${node.id}" is missing src`, {
+          nodeId: node.id
+        });
+      }
+      if (!alt) {
+        dc.warn("COMPILER_IMAGE_NO_ALT", `Image node "${node.id}" is missing alt text`, {
+          nodeId: node.id
+        });
+      }
+      break;
+    }
+    case "link": {
+      const href = node.getProp("href");
+      if (!href) {
+        dc.error("COMPILER_LINK_NO_HREF", `Link node "${node.id}" is missing href`, {
+          nodeId: node.id
+        });
+      }
+      break;
+    }
+    default:
+      break;
+  }
+}
+
+// src/transform/transform.ts
+function transformGraph(graph) {
+  graph.walk((node, depth) => {
+    applyDefaults(node);
+    ensureRenderKey(node, depth);
+  });
+}
+function applyDefaults(node) {
+  switch (node.type) {
+    case "heading": {
+      if (node.getProp("level") === void 0) {
+        node.setProp("level", 1);
+      }
+      break;
+    }
+    case "input": {
+      if (node.getProp("inputType") === void 0) {
+        node.setProp("inputType", "text");
+      }
+      break;
+    }
+    case "link": {
+      if (node.getProp("external") === void 0) {
+        node.setProp("external", false);
+      }
+      break;
+    }
+    default:
+      break;
+  }
+}
+function ensureRenderKey(node, depth) {
+  if (node.getProp("_renderKey") === void 0) {
+    const key = node.key ?? `${node.type}:${node.id}:${depth}`;
+    node.setProp("_renderKey", key);
+  }
+}
+
+// src/compile.ts
+function compile(app, options = {}) {
+  const strict = options.strict ?? true;
+  const strictWarnings = options.strictWarnings ?? false;
+  const dc = new import_core2.DiagnosticCollector();
+  const graph = app.graph;
+  const validationDc = validateGraph(graph);
+  dc.merge(validationDc);
+  if (strict && dc.hasErrors) {
+    dc.throwIfErrors();
+  }
+  if (strictWarnings && dc.hasWarnings) {
+    throw new Error(
+      `[StreetUI Compiler] Compilation failed: warnings treated as errors.
+` + dc.diagnostics.filter((d) => d.severity === "warning").map((d) => `  [${d.code}] ${d.message}`).join("\n")
+    );
+  }
+  transformGraph(graph);
+  return {
+    graph,
+    diagnostics: dc,
+    name: graph.name,
+    version: graph.version,
+    compiledAt: Date.now()
+  };
+}
+function compileGraph(graph, options = {}) {
+  const strict = options.strict ?? true;
+  const dc = new import_core2.DiagnosticCollector();
+  const validationDc = validateGraph(graph);
+  dc.merge(validationDc);
+  if (strict && dc.hasErrors) {
+    dc.throwIfErrors();
+  }
+  transformGraph(graph);
+  return {
+    graph,
+    diagnostics: dc,
+    name: graph.name,
+    version: graph.version,
+    compiledAt: Date.now()
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  compile,
+  compileGraph,
+  transformGraph,
+  validateGraph
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/compile.ts","../src/validation/validator.ts","../src/transform/transform.ts"],"sourcesContent":["export * from './compile.js';\nexport * from './validation/validator.js';\nexport * from './transform/transform.js';\n","/**\n * StreetUI compiler entry point.\n *\n * Pipeline:\n *   StreetApp (DSL)\n *     → ApplicationGraph (build)\n *     → validate\n *     → transform\n *     → CompiledApplication\n */\n\nimport { DiagnosticCollector } from '@streetui/core';\nimport { type ApplicationGraph } from '@streetui/graph';\nimport { type StreetApp } from '@streetui/dsl';\nimport { validateGraph } from './validation/validator.js';\nimport { transformGraph } from './transform/transform.js';\n\nexport interface CompiledApplication {\n  /** The fully built, validated, and transformed graph. */\n  readonly graph: ApplicationGraph;\n  /** Diagnostics accumulated during compilation. */\n  readonly diagnostics: DiagnosticCollector;\n  /** Metadata */\n  readonly name: string;\n  readonly version: string;\n  readonly compiledAt: number;\n}\n\nexport interface CompileOptions {\n  /** If true, compilation throws on errors. Defaults to true. */\n  readonly strict?: boolean;\n  /** If true, also throw on warnings. Defaults to false. */\n  readonly strictWarnings?: boolean;\n}\n\n/**\n * Compile a StreetApp DSL definition into a CompiledApplication\n * ready for the runtime to execute.\n */\nexport function compile(\n  app: StreetApp,\n  options: CompileOptions = {},\n): CompiledApplication {\n  const strict = options.strict ?? true;\n  const strictWarnings = options.strictWarnings ?? false;\n  const dc = new DiagnosticCollector();\n\n  // 1. Build the graph from the DSL\n  const graph = app.graph;\n\n  // 2. Validate\n  const validationDc = validateGraph(graph);\n  dc.merge(validationDc);\n\n  if (strict && dc.hasErrors) {\n    dc.throwIfErrors();\n  }\n  if (strictWarnings && dc.hasWarnings) {\n    throw new Error(\n      `[StreetUI Compiler] Compilation failed: warnings treated as errors.\\n` +\n        dc.diagnostics\n          .filter(d => d.severity === 'warning')\n          .map(d => `  [${d.code}] ${d.message}`)\n          .join('\\n'),\n    );\n  }\n\n  // 3. Transform\n  transformGraph(graph);\n\n  return {\n    graph,\n    diagnostics: dc,\n    name: graph.name,\n    version: graph.version,\n    compiledAt: Date.now(),\n  };\n}\n\n/**\n * Compile from a pre-built ApplicationGraph (used when the graph\n * was constructed programmatically rather than through the DSL).\n */\nexport function compileGraph(\n  graph: ApplicationGraph,\n  options: CompileOptions = {},\n): CompiledApplication {\n  const strict = options.strict ?? true;\n  const dc = new DiagnosticCollector();\n\n  const validationDc = validateGraph(graph);\n  dc.merge(validationDc);\n\n  if (strict && dc.hasErrors) {\n    dc.throwIfErrors();\n  }\n\n  transformGraph(graph);\n\n  return {\n    graph,\n    diagnostics: dc,\n    name: graph.name,\n    version: graph.version,\n    compiledAt: Date.now(),\n  };\n}\n","/**\n * Compiler-phase validation of the ApplicationGraph.\n *\n * This runs after the DSL has built the graph but before the runtime\n * receives a CompiledApplication. More checks live here than in the\n * graph's own validate() because the compiler has broader context.\n */\n\nimport { DiagnosticCollector } from '@streetui/core';\nimport { ApplicationGraph, GraphNode } from '@streetui/graph';\n\nexport function validateGraph(graph: ApplicationGraph): DiagnosticCollector {\n  const dc = new DiagnosticCollector();\n\n  // Merge built-in graph validations\n  dc.merge(graph.validate());\n\n  // Must have at least one page\n  const pages = graph.findByType('page');\n  if (pages.length === 0) {\n    dc.warn(\n      'COMPILER_NO_PAGES',\n      'Application has no pages defined. At least one page is recommended.',\n    );\n  }\n\n  // Walk and validate individual nodes\n  graph.walk((node) => {\n    validateNode(node, dc);\n  });\n\n  return dc;\n}\n\nfunction validateNode(node: GraphNode, dc: DiagnosticCollector): void {\n  switch (node.type) {\n    case 'heading': {\n      const text = node.getProp('text');\n      if (text === undefined || text === '') {\n        dc.warn('COMPILER_EMPTY_HEADING', `Heading node \"${node.id}\" has no text content`, {\n          nodeId: node.id,\n        });\n      }\n      break;\n    }\n    case 'image': {\n      const src = node.getProp('src');\n      const alt = node.getProp('alt');\n      if (!src) {\n        dc.error('COMPILER_IMAGE_NO_SRC', `Image node \"${node.id}\" is missing src`, {\n          nodeId: node.id,\n        });\n      }\n      if (!alt) {\n        dc.warn('COMPILER_IMAGE_NO_ALT', `Image node \"${node.id}\" is missing alt text`, {\n          nodeId: node.id,\n        });\n      }\n      break;\n    }\n    case 'link': {\n      const href = node.getProp('href');\n      if (!href) {\n        dc.error('COMPILER_LINK_NO_HREF', `Link node \"${node.id}\" is missing href`, {\n          nodeId: node.id,\n        });\n      }\n      break;\n    }\n    default:\n      break;\n  }\n}\n","/**\n * Graph transformation pass.\n *\n * After validation, the transformer prepares the graph for the runtime by:\n *  - Resolving implicit defaults (e.g. heading level defaults to 1)\n *  - Normalizing prop names\n *  - Assigning deterministic render keys where missing\n *  - Flattening / hoisting where beneficial\n */\n\nimport { ApplicationGraph, GraphNode } from '@streetui/graph';\n\nexport function transformGraph(graph: ApplicationGraph): void {\n  graph.walk((node, depth) => {\n    applyDefaults(node);\n    ensureRenderKey(node, depth);\n  });\n}\n\nfunction applyDefaults(node: GraphNode): void {\n  switch (node.type) {\n    case 'heading': {\n      if (node.getProp('level') === undefined) {\n        node.setProp('level', 1);\n      }\n      break;\n    }\n    case 'input': {\n      if (node.getProp('inputType') === undefined) {\n        node.setProp('inputType', 'text');\n      }\n      break;\n    }\n    case 'link': {\n      if (node.getProp('external') === undefined) {\n        node.setProp('external', false);\n      }\n      break;\n    }\n    default:\n      break;\n  }\n}\n\nfunction ensureRenderKey(node: GraphNode, depth: number): void {\n  if (node.getProp('_renderKey') === undefined) {\n    const key = node.key ?? `${node.type}:${node.id}:${depth}`;\n    node.setProp('_renderKey', key);\n  }\n}\n"],"mappings":"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","names":["import_core"]}

package/dist/index.d.cts

@@ -0,0 +1,65 @@
+import { DiagnosticCollector } from '@streetui/core';
+import { ApplicationGraph } from '@streetui/graph';
+import { StreetApp } from '@streetui/dsl';
+
+/**
+ * StreetUI compiler entry point.
+ *
+ * Pipeline:
+ *   StreetApp (DSL)
+ *     → ApplicationGraph (build)
+ *     → validate
+ *     → transform
+ *     → CompiledApplication
+ */
+
+interface CompiledApplication {
+    /** The fully built, validated, and transformed graph. */
+    readonly graph: ApplicationGraph;
+    /** Diagnostics accumulated during compilation. */
+    readonly diagnostics: DiagnosticCollector;
+    /** Metadata */
+    readonly name: string;
+    readonly version: string;
+    readonly compiledAt: number;
+}
+interface CompileOptions {
+    /** If true, compilation throws on errors. Defaults to true. */
+    readonly strict?: boolean;
+    /** If true, also throw on warnings. Defaults to false. */
+    readonly strictWarnings?: boolean;
+}
+/**
+ * Compile a StreetApp DSL definition into a CompiledApplication
+ * ready for the runtime to execute.
+ */
+declare function compile(app: StreetApp, options?: CompileOptions): CompiledApplication;
+/**
+ * Compile from a pre-built ApplicationGraph (used when the graph
+ * was constructed programmatically rather than through the DSL).
+ */
+declare function compileGraph(graph: ApplicationGraph, options?: CompileOptions): CompiledApplication;
+
+/**
+ * Compiler-phase validation of the ApplicationGraph.
+ *
+ * This runs after the DSL has built the graph but before the runtime
+ * receives a CompiledApplication. More checks live here than in the
+ * graph's own validate() because the compiler has broader context.
+ */
+
+declare function validateGraph(graph: ApplicationGraph): DiagnosticCollector;
+
+/**
+ * Graph transformation pass.
+ *
+ * After validation, the transformer prepares the graph for the runtime by:
+ *  - Resolving implicit defaults (e.g. heading level defaults to 1)
+ *  - Normalizing prop names
+ *  - Assigning deterministic render keys where missing
+ *  - Flattening / hoisting where beneficial
+ */
+
+declare function transformGraph(graph: ApplicationGraph): void;
+
+export { type CompileOptions, type CompiledApplication, compile, compileGraph, transformGraph, validateGraph };

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { DiagnosticCollector } from '@streetui/core';
+import { ApplicationGraph } from '@streetui/graph';
+import { StreetApp } from '@streetui/dsl';
+
+/**
+ * StreetUI compiler entry point.
+ *
+ * Pipeline:
+ *   StreetApp (DSL)
+ *     → ApplicationGraph (build)
+ *     → validate
+ *     → transform
+ *     → CompiledApplication
+ */
+
+interface CompiledApplication {
+    /** The fully built, validated, and transformed graph. */
+    readonly graph: ApplicationGraph;
+    /** Diagnostics accumulated during compilation. */
+    readonly diagnostics: DiagnosticCollector;
+    /** Metadata */
+    readonly name: string;
+    readonly version: string;
+    readonly compiledAt: number;
+}
+interface CompileOptions {
+    /** If true, compilation throws on errors. Defaults to true. */
+    readonly strict?: boolean;
+    /** If true, also throw on warnings. Defaults to false. */
+    readonly strictWarnings?: boolean;
+}
+/**
+ * Compile a StreetApp DSL definition into a CompiledApplication
+ * ready for the runtime to execute.
+ */
+declare function compile(app: StreetApp, options?: CompileOptions): CompiledApplication;
+/**
+ * Compile from a pre-built ApplicationGraph (used when the graph
+ * was constructed programmatically rather than through the DSL).
+ */
+declare function compileGraph(graph: ApplicationGraph, options?: CompileOptions): CompiledApplication;
+
+/**
+ * Compiler-phase validation of the ApplicationGraph.
+ *
+ * This runs after the DSL has built the graph but before the runtime
+ * receives a CompiledApplication. More checks live here than in the
+ * graph's own validate() because the compiler has broader context.
+ */
+
+declare function validateGraph(graph: ApplicationGraph): DiagnosticCollector;
+
+/**
+ * Graph transformation pass.
+ *
+ * After validation, the transformer prepares the graph for the runtime by:
+ *  - Resolving implicit defaults (e.g. heading level defaults to 1)
+ *  - Normalizing prop names
+ *  - Assigning deterministic render keys where missing
+ *  - Flattening / hoisting where beneficial
+ */
+
+declare function transformGraph(graph: ApplicationGraph): void;
+
+export { type CompileOptions, type CompiledApplication, compile, compileGraph, transformGraph, validateGraph };

package/dist/index.js

@@ -0,0 +1,148 @@
+// src/compile.ts
+import { DiagnosticCollector as DiagnosticCollector2 } from "@streetui/core";
+
+// src/validation/validator.ts
+import { DiagnosticCollector } from "@streetui/core";
+function validateGraph(graph) {
+  const dc = new DiagnosticCollector();
+  dc.merge(graph.validate());
+  const pages = graph.findByType("page");
+  if (pages.length === 0) {
+    dc.warn(
+      "COMPILER_NO_PAGES",
+      "Application has no pages defined. At least one page is recommended."
+    );
+  }
+  graph.walk((node) => {
+    validateNode(node, dc);
+  });
+  return dc;
+}
+function validateNode(node, dc) {
+  switch (node.type) {
+    case "heading": {
+      const text = node.getProp("text");
+      if (text === void 0 || text === "") {
+        dc.warn("COMPILER_EMPTY_HEADING", `Heading node "${node.id}" has no text content`, {
+          nodeId: node.id
+        });
+      }
+      break;
+    }
+    case "image": {
+      const src = node.getProp("src");
+      const alt = node.getProp("alt");
+      if (!src) {
+        dc.error("COMPILER_IMAGE_NO_SRC", `Image node "${node.id}" is missing src`, {
+          nodeId: node.id
+        });
+      }
+      if (!alt) {
+        dc.warn("COMPILER_IMAGE_NO_ALT", `Image node "${node.id}" is missing alt text`, {
+          nodeId: node.id
+        });
+      }
+      break;
+    }
+    case "link": {
+      const href = node.getProp("href");
+      if (!href) {
+        dc.error("COMPILER_LINK_NO_HREF", `Link node "${node.id}" is missing href`, {
+          nodeId: node.id
+        });
+      }
+      break;
+    }
+    default:
+      break;
+  }
+}
+
+// src/transform/transform.ts
+function transformGraph(graph) {
+  graph.walk((node, depth) => {
+    applyDefaults(node);
+    ensureRenderKey(node, depth);
+  });
+}
+function applyDefaults(node) {
+  switch (node.type) {
+    case "heading": {
+      if (node.getProp("level") === void 0) {
+        node.setProp("level", 1);
+      }
+      break;
+    }
+    case "input": {
+      if (node.getProp("inputType") === void 0) {
+        node.setProp("inputType", "text");
+      }
+      break;
+    }
+    case "link": {
+      if (node.getProp("external") === void 0) {
+        node.setProp("external", false);
+      }
+      break;
+    }
+    default:
+      break;
+  }
+}
+function ensureRenderKey(node, depth) {
+  if (node.getProp("_renderKey") === void 0) {
+    const key = node.key ?? `${node.type}:${node.id}:${depth}`;
+    node.setProp("_renderKey", key);
+  }
+}
+
+// src/compile.ts
+function compile(app, options = {}) {
+  const strict = options.strict ?? true;
+  const strictWarnings = options.strictWarnings ?? false;
+  const dc = new DiagnosticCollector2();
+  const graph = app.graph;
+  const validationDc = validateGraph(graph);
+  dc.merge(validationDc);
+  if (strict && dc.hasErrors) {
+    dc.throwIfErrors();
+  }
+  if (strictWarnings && dc.hasWarnings) {
+    throw new Error(
+      `[StreetUI Compiler] Compilation failed: warnings treated as errors.
+` + dc.diagnostics.filter((d) => d.severity === "warning").map((d) => `  [${d.code}] ${d.message}`).join("\n")
+    );
+  }
+  transformGraph(graph);
+  return {
+    graph,
+    diagnostics: dc,
+    name: graph.name,
+    version: graph.version,
+    compiledAt: Date.now()
+  };
+}
+function compileGraph(graph, options = {}) {
+  const strict = options.strict ?? true;
+  const dc = new DiagnosticCollector2();
+  const validationDc = validateGraph(graph);
+  dc.merge(validationDc);
+  if (strict && dc.hasErrors) {
+    dc.throwIfErrors();
+  }
+  transformGraph(graph);
+  return {
+    graph,
+    diagnostics: dc,
+    name: graph.name,
+    version: graph.version,
+    compiledAt: Date.now()
+  };
+}
+export {
+  compile,
+  compileGraph,
+  transformGraph,
+  validateGraph
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/compile.ts","../src/validation/validator.ts","../src/transform/transform.ts"],"sourcesContent":["/**\n * StreetUI compiler entry point.\n *\n * Pipeline:\n *   StreetApp (DSL)\n *     → ApplicationGraph (build)\n *     → validate\n *     → transform\n *     → CompiledApplication\n */\n\nimport { DiagnosticCollector } from '@streetui/core';\nimport { type ApplicationGraph } from '@streetui/graph';\nimport { type StreetApp } from '@streetui/dsl';\nimport { validateGraph } from './validation/validator.js';\nimport { transformGraph } from './transform/transform.js';\n\nexport interface CompiledApplication {\n  /** The fully built, validated, and transformed graph. */\n  readonly graph: ApplicationGraph;\n  /** Diagnostics accumulated during compilation. */\n  readonly diagnostics: DiagnosticCollector;\n  /** Metadata */\n  readonly name: string;\n  readonly version: string;\n  readonly compiledAt: number;\n}\n\nexport interface CompileOptions {\n  /** If true, compilation throws on errors. Defaults to true. */\n  readonly strict?: boolean;\n  /** If true, also throw on warnings. Defaults to false. */\n  readonly strictWarnings?: boolean;\n}\n\n/**\n * Compile a StreetApp DSL definition into a CompiledApplication\n * ready for the runtime to execute.\n */\nexport function compile(\n  app: StreetApp,\n  options: CompileOptions = {},\n): CompiledApplication {\n  const strict = options.strict ?? true;\n  const strictWarnings = options.strictWarnings ?? false;\n  const dc = new DiagnosticCollector();\n\n  // 1. Build the graph from the DSL\n  const graph = app.graph;\n\n  // 2. Validate\n  const validationDc = validateGraph(graph);\n  dc.merge(validationDc);\n\n  if (strict && dc.hasErrors) {\n    dc.throwIfErrors();\n  }\n  if (strictWarnings && dc.hasWarnings) {\n    throw new Error(\n      `[StreetUI Compiler] Compilation failed: warnings treated as errors.\\n` +\n        dc.diagnostics\n          .filter(d => d.severity === 'warning')\n          .map(d => `  [${d.code}] ${d.message}`)\n          .join('\\n'),\n    );\n  }\n\n  // 3. Transform\n  transformGraph(graph);\n\n  return {\n    graph,\n    diagnostics: dc,\n    name: graph.name,\n    version: graph.version,\n    compiledAt: Date.now(),\n  };\n}\n\n/**\n * Compile from a pre-built ApplicationGraph (used when the graph\n * was constructed programmatically rather than through the DSL).\n */\nexport function compileGraph(\n  graph: ApplicationGraph,\n  options: CompileOptions = {},\n): CompiledApplication {\n  const strict = options.strict ?? true;\n  const dc = new DiagnosticCollector();\n\n  const validationDc = validateGraph(graph);\n  dc.merge(validationDc);\n\n  if (strict && dc.hasErrors) {\n    dc.throwIfErrors();\n  }\n\n  transformGraph(graph);\n\n  return {\n    graph,\n    diagnostics: dc,\n    name: graph.name,\n    version: graph.version,\n    compiledAt: Date.now(),\n  };\n}\n","/**\n * Compiler-phase validation of the ApplicationGraph.\n *\n * This runs after the DSL has built the graph but before the runtime\n * receives a CompiledApplication. More checks live here than in the\n * graph's own validate() because the compiler has broader context.\n */\n\nimport { DiagnosticCollector } from '@streetui/core';\nimport { ApplicationGraph, GraphNode } from '@streetui/graph';\n\nexport function validateGraph(graph: ApplicationGraph): DiagnosticCollector {\n  const dc = new DiagnosticCollector();\n\n  // Merge built-in graph validations\n  dc.merge(graph.validate());\n\n  // Must have at least one page\n  const pages = graph.findByType('page');\n  if (pages.length === 0) {\n    dc.warn(\n      'COMPILER_NO_PAGES',\n      'Application has no pages defined. At least one page is recommended.',\n    );\n  }\n\n  // Walk and validate individual nodes\n  graph.walk((node) => {\n    validateNode(node, dc);\n  });\n\n  return dc;\n}\n\nfunction validateNode(node: GraphNode, dc: DiagnosticCollector): void {\n  switch (node.type) {\n    case 'heading': {\n      const text = node.getProp('text');\n      if (text === undefined || text === '') {\n        dc.warn('COMPILER_EMPTY_HEADING', `Heading node \"${node.id}\" has no text content`, {\n          nodeId: node.id,\n        });\n      }\n      break;\n    }\n    case 'image': {\n      const src = node.getProp('src');\n      const alt = node.getProp('alt');\n      if (!src) {\n        dc.error('COMPILER_IMAGE_NO_SRC', `Image node \"${node.id}\" is missing src`, {\n          nodeId: node.id,\n        });\n      }\n      if (!alt) {\n        dc.warn('COMPILER_IMAGE_NO_ALT', `Image node \"${node.id}\" is missing alt text`, {\n          nodeId: node.id,\n        });\n      }\n      break;\n    }\n    case 'link': {\n      const href = node.getProp('href');\n      if (!href) {\n        dc.error('COMPILER_LINK_NO_HREF', `Link node \"${node.id}\" is missing href`, {\n          nodeId: node.id,\n        });\n      }\n      break;\n    }\n    default:\n      break;\n  }\n}\n","/**\n * Graph transformation pass.\n *\n * After validation, the transformer prepares the graph for the runtime by:\n *  - Resolving implicit defaults (e.g. heading level defaults to 1)\n *  - Normalizing prop names\n *  - Assigning deterministic render keys where missing\n *  - Flattening / hoisting where beneficial\n */\n\nimport { ApplicationGraph, GraphNode } from '@streetui/graph';\n\nexport function transformGraph(graph: ApplicationGraph): void {\n  graph.walk((node, depth) => {\n    applyDefaults(node);\n    ensureRenderKey(node, depth);\n  });\n}\n\nfunction applyDefaults(node: GraphNode): void {\n  switch (node.type) {\n    case 'heading': {\n      if (node.getProp('level') === undefined) {\n        node.setProp('level', 1);\n      }\n      break;\n    }\n    case 'input': {\n      if (node.getProp('inputType') === undefined) {\n        node.setProp('inputType', 'text');\n      }\n      break;\n    }\n    case 'link': {\n      if (node.getProp('external') === undefined) {\n        node.setProp('external', false);\n      }\n      break;\n    }\n    default:\n      break;\n  }\n}\n\nfunction ensureRenderKey(node: GraphNode, depth: number): void {\n  if (node.getProp('_renderKey') === undefined) {\n    const key = node.key ?? `${node.type}:${node.id}:${depth}`;\n    node.setProp('_renderKey', key);\n  }\n}\n"],"mappings":"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","names":["DiagnosticCollector","DiagnosticCollector"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@streetui/compiler",
+  "version": "1.0.0",
+  "description": "StreetUI compiler — DSL → validation → Semantic Application Graph",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@streetui/core": "1.0.0",
+    "@streetui/graph": "1.0.0",
+    "@streetui/dsl": "1.0.0",
+    "@streetui/state": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "*",
+    "tsup": "*",
+    "vitest": "*"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}