@blockml/compiler 0.1.0

package/dist/index.js

@@ -0,0 +1,6 @@
+export { registerTarget, getTarget, clearTargets, registeredTargetNames } from "./target-registry.js";
+export { resolveScope, scopeAccepts } from "./scope.js";
+export { compileBmlToBom, validateRegistryDocuments } from "./compile-bml-to-bom.js";
+export { compileToOutput, compileBomToOutput, compileBmlToOutput, } from "./compile-to-output.js";
+export { createRenderContext, buildRenderSession } from "./render-context.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/render-context.d.ts

@@ -0,0 +1,12 @@
+import type { RenderContext, RenderSession } from "./types.js";
+export declare function createRenderContext(session: RenderSession, blockFqn?: string, outputRelativePath?: string): RenderContext;
+export declare function buildRenderSession(options: {
+    typeRegistry: RenderSession["typeRegistry"];
+    targetName: string;
+    outputBasePath?: string;
+    sourceFilePath?: string;
+    scopeKind: RenderSession["scopeKind"];
+    libraryPaths?: string[];
+    corpusRoots?: string[];
+}): RenderSession;
+//# sourceMappingURL=render-context.d.ts.map

package/dist/render-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsB/D,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,QAAQ,SAAK,EACb,kBAAkB,SAAK,GACtB,aAAa,CAEf;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE;IACP,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,GACA,aAAa,CAef"}

package/dist/render-context.js

@@ -0,0 +1,33 @@
+class RenderContextImpl {
+    session;
+    blockFqn;
+    outputRelativePath;
+    constructor(session, blockFqn, outputRelativePath) {
+        this.session = session;
+        this.blockFqn = blockFqn;
+        this.outputRelativePath = outputRelativePath;
+    }
+    child(overrides) {
+        return new RenderContextImpl(this.session, overrides.blockFqn ?? this.blockFqn, overrides.outputRelativePath ?? this.outputRelativePath);
+    }
+}
+export function createRenderContext(session, blockFqn = "", outputRelativePath = "") {
+    return new RenderContextImpl(session, blockFqn, outputRelativePath);
+}
+export function buildRenderSession(options) {
+    const session = {
+        typeRegistry: options.typeRegistry,
+        sourceFilePath: options.sourceFilePath ?? "<scope>",
+        outputBasePath: options.outputBasePath ?? ".",
+        targetName: options.targetName,
+        scopeKind: options.scopeKind,
+    };
+    if (options.libraryPaths !== undefined) {
+        session.libraryPaths = options.libraryPaths;
+    }
+    if (options.corpusRoots !== undefined) {
+        session.corpusRoots = options.corpusRoots;
+    }
+    return session;
+}
+//# sourceMappingURL=render-context.js.map

package/dist/render-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../src/render-context.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB;IACZ,OAAO,CAAgB;IACvB,QAAQ,CAAS;IACjB,kBAAkB,CAAS;IAEpC,YAAY,OAAsB,EAAE,QAAgB,EAAE,kBAA0B;QAC9E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAA4D;QAChE,OAAO,IAAI,iBAAiB,CAC1B,IAAI,CAAC,OAAO,EACZ,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EACnC,SAAS,CAAC,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,CACxD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAsB,EACtB,QAAQ,GAAG,EAAE,EACb,kBAAkB,GAAG,EAAE;IAEvB,OAAO,IAAI,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAQC;IAED,MAAM,OAAO,GAAkB;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,SAAS;QACnD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,GAAG;QAC7C,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;IACF,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/scope.d.ts

@@ -0,0 +1,8 @@
+import type { Diagnostic } from "@blockml/bom";
+import type { CompileScope, ResolvedScope, ScopeConfigHints } from "./types.js";
+export declare function resolveScope(scope: CompileScope, hints?: ScopeConfigHints): {
+    resolved: ResolvedScope | null;
+    diagnostics: Diagnostic[];
+};
+export declare function scopeAccepts(resolvedKind: Exclude<ResolvedScope["kind"], never>, accepts: Array<ResolvedScope["kind"] | "auto">): boolean;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,EACnB,KAAK,GAAE,gBAAqB,GAC3B;IAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,CAiE/D;AAED,wBAAgB,YAAY,CAC1B,YAAY,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,EACnD,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GAC7C,OAAO,CAWT"}

package/dist/scope.js

@@ -0,0 +1,71 @@
+export function resolveScope(scope, hints = {}) {
+    const diagnostics = [];
+    if (scope.kind === "document") {
+        if (!scope.document) {
+            diagnostics.push({
+                severity: "error",
+                code: "BML_COMPILE_SCOPE_EMPTY",
+                message: "Document scope requires scope.document",
+                source: { file: hints.rootDir ?? "<config>", line: 1, column: 1 },
+            });
+            return { resolved: null, diagnostics };
+        }
+        return {
+            resolved: { kind: "document", document: scope.document },
+            diagnostics,
+        };
+    }
+    if (scope.kind === "library") {
+        const libraries = scope.libraries ?? hints.libraries ?? [];
+        if (libraries.length === 0) {
+            diagnostics.push({
+                severity: "error",
+                code: "BML_COMPILE_SCOPE_EMPTY",
+                message: "Library scope requires libraries[]",
+                source: { file: hints.rootDir ?? "<config>", line: 1, column: 1 },
+            });
+            return { resolved: null, diagnostics };
+        }
+        return { resolved: { kind: "library", libraries }, diagnostics };
+    }
+    if (scope.kind === "corpus") {
+        const roots = scope.roots ?? hints.roots ?? [];
+        if (roots.length === 0) {
+            diagnostics.push({
+                severity: "error",
+                code: "BML_COMPILE_SCOPE_EMPTY",
+                message: "Corpus scope requires roots[]",
+                source: { file: hints.rootDir ?? "<config>", line: 1, column: 1 },
+            });
+            return { resolved: null, diagnostics };
+        }
+        return { resolved: { kind: "corpus", roots }, diagnostics };
+    }
+    // auto
+    const libraries = scope.libraries ?? hints.libraries ?? [];
+    if (libraries.length > 0) {
+        return { resolved: { kind: "library", libraries }, diagnostics };
+    }
+    const roots = scope.roots ?? hints.roots ?? [];
+    if (roots.length > 0) {
+        return { resolved: { kind: "corpus", roots }, diagnostics };
+    }
+    diagnostics.push({
+        severity: "error",
+        code: "BML_COMPILE_SCOPE_EMPTY",
+        message: "Auto scope resolution found no libraries or roots",
+        source: { file: hints.rootDir ?? "<config>", line: 1, column: 1 },
+    });
+    return { resolved: null, diagnostics };
+}
+export function scopeAccepts(resolvedKind, accepts) {
+    if (accepts.includes(resolvedKind)) {
+        return true;
+    }
+    if (accepts.includes("auto") &&
+        (resolvedKind === "library" || resolvedKind === "corpus")) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

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

package/dist/target-registry.d.ts

@@ -0,0 +1,6 @@
+import type { RenderTarget } from "./types.js";
+export declare function registerTarget(target: RenderTarget): void;
+export declare function getTarget(name: string): RenderTarget | undefined;
+export declare function clearTargets(): void;
+export declare function registeredTargetNames(): string[];
+//# sourceMappingURL=target-registry.d.ts.map

package/dist/target-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.d.ts","sourceRoot":"","sources":["../src/target-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,YAAY,CAAC;AAsCjE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGzD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD"}

package/dist/target-registry.js

@@ -0,0 +1,41 @@
+const targets = new Map();
+const VALID_SCOPE_KINDS = new Set([
+    "document",
+    "library",
+    "corpus",
+    "auto",
+]);
+function assertValidTarget(target) {
+    if (!target.name || typeof target.name !== "string" || target.name.trim() === "") {
+        throw new Error("registerTarget: name must be a non-empty string");
+    }
+    if (!Array.isArray(target.accepts) || target.accepts.length === 0) {
+        throw new Error(`registerTarget: target "${target.name}" accepts must be a non-empty array`);
+    }
+    for (const kind of target.accepts) {
+        if (!VALID_SCOPE_KINDS.has(kind)) {
+            throw new Error(`registerTarget: target "${target.name}" has invalid accepts value: ${String(kind)}`);
+        }
+    }
+    if (typeof target.render !== "function") {
+        throw new Error(`registerTarget: target "${target.name}" render must be a function`);
+    }
+    if (target.validateRequest !== undefined &&
+        typeof target.validateRequest !== "function") {
+        throw new Error(`registerTarget: target "${target.name}" validateRequest must be a function when set`);
+    }
+}
+export function registerTarget(target) {
+    assertValidTarget(target);
+    targets.set(target.name, target);
+}
+export function getTarget(name) {
+    return targets.get(name);
+}
+export function clearTargets() {
+    targets.clear();
+}
+export function registeredTargetNames() {
+    return [...targets.keys()];
+}
+//# sourceMappingURL=target-registry.js.map

package/dist/target-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.js","sourceRoot":"","sources":["../src/target-registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEhD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAmB;IAClD,UAAU;IACV,SAAS;IACT,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,iBAAiB,CAAC,MAAoB;IAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,IAAI,qCAAqC,CAAC,CAAC;IAC/F,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,2BAA2B,MAAM,CAAC,IAAI,gCAAgC,MAAM,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,IAAI,6BAA6B,CAAC,CAAC;IACvF,CAAC;IACD,IACE,MAAM,CAAC,eAAe,KAAK,SAAS;QACpC,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU,EAC5C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,2BAA2B,MAAM,CAAC,IAAI,+CAA+C,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+import type { Diagnostic } from "@blockml/bom";
+import type { TypeRegistry } from "@blockml/framework";
+export type CompileScopeKind = "document" | "library" | "corpus" | "auto";
+export interface CompileInput {
+    source: string;
+    filePath: string;
+    format?: "xml";
+}
+export interface CompileScope {
+    kind: CompileScopeKind;
+    document?: CompileInput;
+    libraries?: string[];
+    roots?: string[];
+    includeDependencies?: boolean;
+}
+export interface CompileRequest {
+    scope: CompileScope;
+    targetOptions?: unknown;
+}
+export interface CompileOptions {
+    typeRegistry?: TypeRegistry;
+    outputBasePath?: string;
+    rootDir?: string;
+}
+/** Options for BOM-first Stage-3 (compileBomToOutput). typeRegistry is required. */
+export interface CompileBomOptions {
+    typeRegistry: TypeRegistry;
+    outputBasePath?: string;
+    rootDir?: string;
+    targetOptions?: unknown;
+}
+export interface CompilerResult<T> {
+    output: T | null;
+    diagnostics: Diagnostic[];
+    success: boolean;
+}
+export interface RenderOutputFile {
+    path: string;
+    content: string;
+}
+export interface RenderOutput {
+    files: RenderOutputFile[];
+    /** Files written at project root (e.g. catalog.xml). CLI-owned write path. */
+    rootFiles?: RenderOutputFile[];
+    /** Target-emitted diagnostics merged by CLI after compile. */
+    diagnostics?: Diagnostic[];
+}
+export interface RenderSession {
+    typeRegistry: TypeRegistry;
+    sourceFilePath: string;
+    outputBasePath: string;
+    targetName: string;
+    /** Resolved scope kind after auto resolution. */
+    scopeKind: Exclude<CompileScopeKind, "auto">;
+    /** Library.bml paths when scope is library. */
+    libraryPaths?: string[];
+    /** Corpus roots when scope is corpus. */
+    corpusRoots?: string[];
+}
+export interface RenderContext {
+    session: RenderSession;
+    blockFqn: string;
+    outputRelativePath: string;
+    child(overrides: Partial<Omit<RenderContext, "session" | "child">>): RenderContext;
+}
+export interface RenderTarget {
+    name: string;
+    accepts: CompileScopeKind[];
+    validateRequest?(request: CompileRequest): Diagnostic[];
+    render(request: CompileRequest, ctx: RenderContext): RenderOutput;
+}
+export interface ScopeConfigHints {
+    libraries?: string[];
+    roots?: string[];
+    rootDir?: string;
+}
+export interface ResolvedScope {
+    kind: Exclude<CompileScopeKind, "auto">;
+    document?: CompileInput;
+    libraries?: string[];
+    roots?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@blockml/compiler",
+  "version": "0.1.0",
+  "description": "BlockML compiler — facade, target registry, render pipeline",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pks5/blockml-toolchain.git",
+    "directory": "packages/compiler"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "blockml": {
+    "library": "./blocks/org/blockml/bml/compiler/runtime/Library.bml"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "blocks"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run packages/compiler/test"
+  },
+  "dependencies": {
+    "@blockml/bom": "^0.1.0",
+    "@blockml/framework": "^0.1.0",
+    "@blockml/parser": "^0.1.0",
+    "@blockml/validator": "^0.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}