@openuji/speculator 0.3.0 → 0.3.2

package/dist/cli/export-assertions.d.cts

@@ -0,0 +1,25 @@
+interface CliIO {
+    readFile?: (p: string, enc?: BufferEncoding) => Promise<string>;
+    writeFile?: (p: string, data: string, enc?: BufferEncoding) => Promise<void>;
+    stat?: (p: string) => Promise<{
+        isFile(): boolean;
+    }>;
+    env?: Record<string, string | undefined>;
+    log?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error?: (msg: string) => void;
+}
+interface ExportResultItem {
+    id: string;
+    url: string;
+    type: 'MUST' | 'MUST NOT' | 'SHOULD' | 'MAY';
+}
+interface ExportAssertionsResult {
+    exitCode: number;
+    outPath?: string;
+    items?: ExportResultItem[];
+    warnings: string[];
+}
+declare function exportAssertions(argv: string[], io?: CliIO): Promise<ExportAssertionsResult>;
+
+export { type CliIO, type ExportAssertionsResult, type ExportResultItem, exportAssertions };

package/dist/cli/export-assertions.d.ts

@@ -0,0 +1,25 @@
+interface CliIO {
+    readFile?: (p: string, enc?: BufferEncoding) => Promise<string>;
+    writeFile?: (p: string, data: string, enc?: BufferEncoding) => Promise<void>;
+    stat?: (p: string) => Promise<{
+        isFile(): boolean;
+    }>;
+    env?: Record<string, string | undefined>;
+    log?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error?: (msg: string) => void;
+}
+interface ExportResultItem {
+    id: string;
+    url: string;
+    type: 'MUST' | 'MUST NOT' | 'SHOULD' | 'MAY';
+}
+interface ExportAssertionsResult {
+    exitCode: number;
+    outPath?: string;
+    items?: ExportResultItem[];
+    warnings: string[];
+}
+declare function exportAssertions(argv: string[], io?: CliIO): Promise<ExportAssertionsResult>;
+
+export { type CliIO, type ExportAssertionsResult, type ExportResultItem, exportAssertions };

package/dist/cli/export-assertions.js

@@ -0,0 +1,107 @@
+import {
+  LinkedomHtmlRenderer,
+  Speculator
+} from "../chunk-KC3NVWHK.js";
+import "../chunk-ONLMOJIJ.js";
+
+// src/cli/export-assertions.ts
+import fs from "fs/promises";
+import path from "path";
+import { pathToFileURL } from "url";
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a.startsWith("--")) continue;
+    const key = a.slice(2);
+    const next = argv[i + 1];
+    if (key === "strict" || key === "help") {
+      args[key] = true;
+    } else if (next && !next.startsWith("--")) {
+      args[key] = next;
+      i++;
+    } else {
+      args[key] = true;
+    }
+  }
+  return args;
+}
+async function exportAssertions(argv, io = {}) {
+  const warnings = [];
+  const readFile = io.readFile || ((p) => fs.readFile(p, "utf8"));
+  const writeFile = io.writeFile || ((p, d) => fs.writeFile(p, d, "utf8"));
+  const stat = io.stat || ((p) => fs.stat(p));
+  const env = io.env || process.env;
+  const log = io.log || ((m) => console.log(m));
+  const warn = io.warn || ((m) => console.warn(m));
+  const error = io.error || ((m) => console.error(m));
+  const args = parseArgs(argv);
+  if (args.help) {
+    log("Usage: speculator export:assertion [--input path|--spec <s> --version <v>] [--spec-dir dir] [--base url] [--out file] [--strict]");
+    return { exitCode: 0, warnings };
+  }
+  let input = args.input;
+  let spec = args.spec;
+  let version = args.version;
+  const strict = !!args.strict;
+  const specDir = args["spec-dir"] || env.SPEC_DIR || path.resolve(process.cwd(), "spec");
+  if (!input) {
+    if (!spec || !version) {
+      error("Either --input or both --spec and --version are required.");
+      return { exitCode: 1, warnings };
+    }
+    input = path.join(specDir, spec, version, "index.spec.html");
+  }
+  const exists = await stat(input).then((s) => s.isFile()).catch(() => false);
+  if (!exists) {
+    error(`Input not found: ${input}`);
+    return { exitCode: 1, warnings };
+  }
+  try {
+    if (!spec || !version) {
+      const parts = path.normalize(input).split(path.sep).filter(Boolean);
+      if (parts.length >= 3) {
+        spec = parts[parts.length - 3];
+        version = parts[parts.length - 2];
+      }
+    }
+  } catch {
+  }
+  const baseUrl = new URL("./", pathToFileURL(input)).toString();
+  const html = await readFile(input, "utf8");
+  const assertions = {};
+  if (spec) assertions.spec = spec;
+  if (version) assertions.version = version;
+  const speculator = new Speculator({ baseUrl, postprocess: { assertions } });
+  let captured = [];
+  const hook = (_container, outs) => {
+    const items2 = outs["assertions"];
+    if (Array.isArray(items2)) captured = items2;
+  };
+  const htmlRenderer = new LinkedomHtmlRenderer();
+  const container = htmlRenderer.parse(html);
+  const sections = Array.from(container.children);
+  const areas = ["assertions"];
+  const res = await speculator.renderDocument({ sections, postProcess: hook }, areas);
+  warnings.push(...res.warnings);
+  const base = args.base || (spec && version ? `https://spec.openuji.dev/${spec}/${version}/` : "");
+  const outPath = args.out || "assertions.json";
+  const items = captured.map((it) => ({
+    id: it.id,
+    url: base ? `${base}#${it.anchorId}` : `#${it.anchorId}`,
+    type: it.type,
+    snippet: it.snippet
+  }));
+  await writeFile(outPath, JSON.stringify(items, null, 2) + "\n", "utf8");
+  const multiWarnings = warnings.filter((w) => /Multiple normative keywords/.test(w));
+  if (multiWarnings.length) {
+    warn(`Found ${multiWarnings.length} blocks with multiple normative keywords:`);
+    for (const w of multiWarnings) warn(" - " + w);
+    if (strict) return { exitCode: 2, outPath, items, warnings };
+  }
+  log(`Wrote ${items.length} assertions to ${outPath}`);
+  return { exitCode: 0, outPath, items, warnings };
+}
+export {
+  exportAssertions
+};