@aruzone/aze-forge 0.1.0

package/dist/watch-dependencies.js

@@ -0,0 +1,93 @@
+import { realpath } from "node:fs/promises";
+import { extname, resolve } from "node:path";
+import { isAbsoluteSource, isContained, isRemoteSource } from "./assets.js";
+const SUPPORTED_IMAGE_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".svg"]);
+function collectInlineSources(nodes, out) {
+    for (const node of nodes) {
+        if (node.kind === "image") {
+            out.push(node.src);
+        }
+        else if (node.kind === "link") {
+            collectInlineSources(node.children, out);
+        }
+        else if (node.kind === "emphasis" || node.kind === "strong") {
+            collectInlineSources(node.children, out);
+        }
+    }
+}
+function collectBlockSources(blocks, out) {
+    for (const block of blocks) {
+        switch (block.kind) {
+            case "heading":
+            case "paragraph":
+                collectInlineSources(block.children, out);
+                break;
+            case "blockquote":
+                collectBlockSources(block.children, out);
+                break;
+            case "list":
+                for (const item of block.items)
+                    collectBlockSources(item.blocks, out);
+                break;
+            case "callout":
+                collectBlockSources(block.children, out);
+                if (block.title !== undefined)
+                    collectInlineSources(block.title, out);
+                break;
+            case "table":
+                for (const row of block.data.header)
+                    collectInlineSources(row, out);
+                for (const row of block.data.rows) {
+                    for (const cell of row)
+                        collectInlineSources(cell, out);
+                }
+                if (block.caption !== undefined)
+                    collectInlineSources(block.caption, out);
+                break;
+            default:
+                break;
+        }
+    }
+}
+/** Every image `src` referenced by a Document, in Source order. */
+export function collectImageSources(document) {
+    const out = [];
+    collectBlockSources(document.blocks, out);
+    return out;
+}
+/**
+ * Partition image references into existing files and missing root-confined
+ * candidates. Remote, absolute, escaping, and unsupported-type references are
+ * compile errors, not watch targets, so they are skipped here.
+ */
+export async function resolveWatchPaths(projectRoot, imageSources) {
+    const files = new Set();
+    const missing = new Set();
+    for (const src of imageSources) {
+        if (src.trim() === "" || src.includes("\0"))
+            continue;
+        if (isAbsoluteSource(src) || isRemoteSource(src))
+            continue;
+        if (!SUPPORTED_IMAGE_EXTENSIONS.has(extname(src).toLowerCase()))
+            continue;
+        const candidate = resolve(projectRoot, src);
+        if (!isContained(projectRoot, candidate))
+            continue;
+        let candidateReal;
+        try {
+            candidateReal = await realpath(candidate);
+        }
+        catch {
+            missing.add(candidate);
+            continue;
+        }
+        if (!isContained(projectRoot, candidateReal))
+            continue;
+        files.add(candidateReal);
+    }
+    return {
+        files: [...files].sort(),
+        missing: [...missing].sort(),
+    };
+}
+//# sourceMappingURL=watch-dependencies.js.map

package/dist/watch-dependencies.js.map

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

package/dist/watch-events.d.ts

@@ -0,0 +1,51 @@
+import type { ArtifactMetadata, ContentHash, Diagnostic } from "./model.js";
+import { TOOL_VERSION } from "./tool-version.js";
+export declare const WATCH_EVENT_SCHEMA_ID: "azeforge.event/v1";
+export type WatchCommand = "watch" | "serve";
+export type WatchEventKind = "started" | "result" | "stopped";
+interface WatchEventBase {
+    readonly schema: typeof WATCH_EVENT_SCHEMA_ID;
+    readonly schemaVersion: 1;
+    readonly tool: Readonly<{
+        name: "azeforge";
+        version: typeof TOOL_VERSION;
+    }>;
+    readonly command: WatchCommand;
+    readonly seq: number;
+    readonly kind: WatchEventKind;
+}
+export interface WatchStartedEvent extends WatchEventBase {
+    readonly kind: "started";
+    readonly source: string;
+    /** Watch only: the file Artifact destination. */
+    readonly artifact?: string;
+    /** Watch only: the Artifact format. */
+    readonly format?: "html" | "svg" | "png" | "pdf";
+    /** Serve only: the loopback preview URL. */
+    readonly url?: string;
+}
+export interface WatchResultEvent extends WatchEventBase {
+    readonly kind: "result";
+    readonly success: boolean;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly contentHash?: ContentHash;
+    readonly artifact?: ArtifactMetadata;
+    /** Serve only: the loopback preview URL. */
+    readonly url?: string;
+    /** Serve only: opaque asset URLs for the current manifest. */
+    readonly assets?: readonly Readonly<{
+        url: string;
+        mediaType: string;
+        byteLength: number;
+    }>[];
+}
+export interface WatchStoppedEvent extends WatchEventBase {
+    readonly kind: "stopped";
+    readonly reason: string;
+}
+export type WatchEvent = WatchStartedEvent | WatchResultEvent | WatchStoppedEvent;
+export declare function createStartedEvent(command: WatchCommand, seq: number, details: Omit<WatchStartedEvent, "schema" | "schemaVersion" | "tool" | "command" | "seq" | "kind">): WatchStartedEvent;
+export declare function createResultEvent(command: WatchCommand, seq: number, details: Omit<WatchResultEvent, "schema" | "schemaVersion" | "tool" | "command" | "seq" | "kind">): WatchResultEvent;
+export declare function createStoppedEvent(command: WatchCommand, seq: number, reason: string): WatchStoppedEvent;
+export declare function serializeEvent(event: WatchEvent): string;
+export {};

package/dist/watch-events.js

@@ -0,0 +1,27 @@
+import { TOOL_VERSION } from "./tool-version.js";
+export const WATCH_EVENT_SCHEMA_ID = "azeforge.event/v1";
+function toolIdentity() {
+    return { name: "azeforge", version: TOOL_VERSION };
+}
+function baseEvent(command, seq) {
+    return {
+        schema: WATCH_EVENT_SCHEMA_ID,
+        schemaVersion: 1,
+        tool: toolIdentity(),
+        command,
+        seq,
+    };
+}
+export function createStartedEvent(command, seq, details) {
+    return { ...baseEvent(command, seq), kind: "started", ...details };
+}
+export function createResultEvent(command, seq, details) {
+    return { ...baseEvent(command, seq), kind: "result", ...details };
+}
+export function createStoppedEvent(command, seq, reason) {
+    return { ...baseEvent(command, seq), kind: "stopped", reason };
+}
+export function serializeEvent(event) {
+    return JSON.stringify(event);
+}
+//# sourceMappingURL=watch-events.js.map

package/dist/watch-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-events.js","sourceRoot":"","sources":["../src/watch-events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAA4B,CAAC;AAgDlE,SAAS,YAAY;IACnB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,OAAqB,EAAE,GAAW;IACnD,OAAO;QACL,MAAM,EAAE,qBAAqB;QAC7B,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,YAAY,EAAE;QACpB,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,GAAW,EACX,OAAkG;IAElG,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAqB,EACrB,GAAW,EACX,OAAiG;IAEjG,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,GAAW,EACX,MAAc;IAEd,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACjE,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/watch-loop.d.ts

@@ -0,0 +1,39 @@
+export interface CompileOutcome {
+    /** Image `src` values observed in the latest Document, if any compiled. */
+    readonly imageSources: readonly string[];
+}
+export interface WatchDriverOptions {
+    /** Canonical Source path. */
+    readonly sourcePath: string;
+    /** Canonical project root. */
+    readonly projectRoot: string;
+    /** Milliseconds to coalesce rapid change notifications. */
+    readonly debounceMs: number;
+    /** Resolve watch paths for the latest compile outcome. */
+    readonly watchPathsFor: (outcome: CompileOutcome | undefined) => Promise<{
+        readonly files: readonly string[];
+        readonly missing: readonly string[];
+    }>;
+    readonly onChange: () => void;
+    readonly onWatcherFailed: (error: unknown) => void;
+}
+/**
+ * Serialized, coalescing file watcher. Change notifications during an active
+ * compile collapse into one scheduled follow-up cycle; the caller serializes
+ * compiles and invokes `onChange` per settled trigger.
+ */
+export declare class WatchDriver {
+    private readonly options;
+    private watchers;
+    private timer;
+    private closed;
+    private failed;
+    private constructor();
+    static start(options: WatchDriverOptions, initialOutcome: CompileOutcome | undefined): Promise<WatchDriver>;
+    /** Signal that the current compile settled; watch paths refresh. */
+    rearm(outcome: CompileOutcome | undefined): Promise<void>;
+    private observe;
+    private schedule;
+    private fail;
+    close(): Promise<void>;
+}

package/dist/watch-loop.js

@@ -0,0 +1,117 @@
+import { watch } from "node:fs";
+import { stat } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+async function nearestExistingAncestor(candidate) {
+    let current = candidate;
+    for (;;) {
+        try {
+            await stat(current);
+            return current;
+        }
+        catch {
+            const parent = dirname(current);
+            if (parent === current)
+                return current;
+            current = parent;
+        }
+    }
+}
+/**
+ * Serialized, coalescing file watcher. Change notifications during an active
+ * compile collapse into one scheduled follow-up cycle; the caller serializes
+ * compiles and invokes `onChange` per settled trigger.
+ */
+export class WatchDriver {
+    options;
+    watchers = [];
+    timer;
+    closed = false;
+    failed = false;
+    constructor(options) {
+        this.options = options;
+    }
+    static async start(options, initialOutcome) {
+        const driver = new WatchDriver(options);
+        await driver.rearm(initialOutcome);
+        return driver;
+    }
+    /** Signal that the current compile settled; watch paths refresh. */
+    async rearm(outcome) {
+        if (this.closed || this.failed)
+            return;
+        for (const watcher of this.watchers)
+            watcher.close();
+        this.watchers = [];
+        let paths;
+        try {
+            paths = await this.options.watchPathsFor(outcome);
+        }
+        catch (error) {
+            this.fail(error);
+            return;
+        }
+        const targets = new Set(paths.files);
+        targets.add(this.options.sourcePath);
+        const ancestors = new Set();
+        for (const missing of paths.missing) {
+            const parent = dirname(resolve(missing));
+            ancestors.add(await nearestExistingAncestor(parent));
+        }
+        ancestors.add(await nearestExistingAncestor(dirname(this.options.sourcePath)));
+        for (const target of [...targets].sort())
+            this.observe(target);
+        for (const ancestor of [...ancestors].sort()) {
+            if (!targets.has(ancestor))
+                this.observe(ancestor);
+        }
+    }
+    observe(target) {
+        if (this.closed || this.failed)
+            return;
+        let watcher;
+        try {
+            watcher = watch(target, { persistent: true }, () => this.schedule());
+        }
+        catch (error) {
+            this.fail(error);
+            return;
+        }
+        watcher.on("error", (error) => this.fail(error));
+        this.watchers.push(watcher);
+    }
+    schedule() {
+        if (this.closed || this.failed)
+            return;
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            this.options.onChange();
+        }, this.options.debounceMs);
+        this.timer.unref?.();
+    }
+    fail(error) {
+        if (this.closed || this.failed)
+            return;
+        this.failed = true;
+        if (this.timer !== undefined) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        for (const watcher of this.watchers)
+            watcher.close();
+        this.watchers = [];
+        this.options.onWatcherFailed(error);
+    }
+    async close() {
+        this.closed = true;
+        if (this.timer !== undefined) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        for (const watcher of this.watchers)
+            watcher.close();
+        this.watchers = [];
+    }
+}
+//# sourceMappingURL=watch-loop.js.map

package/dist/watch-loop.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@aruzone/aze-forge",
+  "version": "0.1.0",
+  "description": "Deterministic AzeMark compiler: readable source in, self-contained HTML, SVG, PNG, and PDF artifacts out.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aruzone/aze-forge.git"
+  },
+  "keywords": [
+    "azemark",
+    "markdown",
+    "publishing",
+    "pdf",
+    "svg"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "azeforge": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "engines": {
+    "node": ">=22 <23 || >=24 <25"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build --silent",
+    "test": "npm run build --silent && node --test test/*.test.mjs",
+    "test:matrix": "node --test --test-reporter=tap test/capabilities.test.mjs test/cli.test.mjs test/compatibility.test.mjs test/compiler.test.mjs test/equation.test.mjs test/fail-closed.test.mjs test/format.test.mjs test/installed-cli.test.mjs test/schemas.test.mjs test/theme-assets.test.mjs test/watch-serve.test.mjs",
+    "test:browser-smoke": "node --test --test-reporter=tap test/browser-smoke.test.mjs",
+    "test:canonical": "node scripts/acceptance.mjs --json",
+    "test:canonical-suite": "node --test --test-reporter=tap test/acceptance.test.mjs test/mermaid.test.mjs test/pdf.test.mjs test/png.test.mjs test/svg.test.mjs",
+    "test:compiler": "npm run build --silent && node --test test/compiler.test.mjs",
+    "test:cli": "npm run build --silent && node --test test/cli.test.mjs",
+    "test:acceptance": "npm run build --silent && node --test test/acceptance.test.mjs",
+    "acceptance": "node scripts/acceptance.mjs",
+    "acceptance:refresh": "node scripts/acceptance.mjs --refresh"
+  },
+  "dependencies": {
+    "@fontsource/inter": "5.3.0",
+    "@fontsource/jetbrains-mono": "5.2.8",
+    "@puppeteer/browsers": "3.2.2",
+    "katex": "0.18.5",
+    "mermaid": "11.17.2",
+    "puppeteer": "25.10.0",
+    "puppeteer-core": "25.10.0",
+    "saxes": "6.0.0",
+    "yaml": "2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.3.0",
+    "typescript": "5.9.2"
+  },
+  "allowScripts": {
+    "puppeteer@25.10.0": true
+  }
+}

package/schemas/acceptance.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "azeforge.acceptance/v1",
+  "type": "object",
+  "required": [
+    "schema",
+    "schemaVersion",
+    "catalog",
+    "entries"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schema": {
+      "const": "azeforge.acceptance/v1"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "catalog": {
+      "type": "object",
+      "required": [
+        "id",
+        "version"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "const": "azeforge.acceptance/v1"
+        },
+        "version": {
+          "const": 1
+        }
+      }
+    },
+    "entries": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "gate",
+          "area",
+          "given",
+          "when",
+          "then",
+          "evidence",
+          "required",
+          "contracts"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^P0[A-Z0-9]*-[A-Z]+-[0-9]{3}$"
+          },
+          "gate": {
+            "enum": [
+              "p0",
+              "p0.5"
+            ]
+          },
+          "area": {
+            "type": "string",
+            "minLength": 1
+          },
+          "given": {
+            "type": "string",
+            "minLength": 1
+          },
+          "when": {
+            "type": "string",
+            "minLength": 1
+          },
+          "then": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "evidence": {
+            "enum": [
+              "automated",
+              "manual"
+            ]
+          },
+          "required": {
+            "const": true
+          },
+          "contracts": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      }
+    }
+  }
+}