@openuji/speculator 0.5.3 → 0.5.4

package/dist/preprocess/config/types.d.ts

@@ -4,37 +4,72 @@
  * Types for document-level configuration (config.json).
  * Used to define document IDs, dependencies, and optional respec configuration.
  */
-import type { RawRespecConfig } from './loader.js';
+export type DocumentId = string;
+export type ISODateString = `${number}-${number}-${number}`;
+export type MaturityLevel = 'incubating' | 'draft' | 'prerelease' | 'stable';
 /**
- * Document configuration schema
- *
- * Located in config.json sibling to spec entry files.
+ * Raw person entry from ReSpec config
  */
-export interface DocumentConfig {
-    /** Unique document identifier within the workspace */
-    id?: string;
-    /**
-     * Array of document IDs this document depends on.
-     * Dependencies are processed before this document.
-     */
-    deps?: string[];
-    /**
-     * Optional ReSpec configuration embedded in config.json.
-     * If present, this replaces the need for a separate config.respec.json file.
-     */
-    respec?: RawRespecConfig;
+export interface RawPersonEntry {
+    name: string;
+    url?: string;
+    company?: string;
+    companyURL?: string;
+    mailto?: string;
+    email?: string;
 }
 /**
- * Resolved document config with guaranteed fields
+ * Raw ReSpec configuration as embedded in config.json
  */
+export interface RawRespecConfig {
+    title?: string;
+    shortName?: string;
+    subtitle?: string;
+    specStatus?: string;
+    publishDate?: string;
+    modificationDate?: string;
+    thisVersion?: string;
+    latestVersion?: string;
+    prevVersion?: string;
+    editors?: RawPersonEntry[];
+    authors?: RawPersonEntry[];
+    abstract?: string;
+    license?: string;
+    logos?: Array<{
+        src: string;
+        alt?: string;
+        href?: string;
+        url?: string;
+    }>;
+    noTOC?: boolean;
+    maxTocLevel?: number;
+    localBiblio?: Record<string, unknown>;
+}
 export interface ResolvedDocumentConfig {
     /** Document ID (from config or auto-generated) */
-    id: string;
+    id: DocumentId;
     /** Dependencies (empty array if none) */
-    deps: string[];
+    deps: DocumentId[];
+    /** Document title (core config setting, takes priority over respec.title) */
+    title?: string;
+    /** Last update date (core config setting, takes priority over respec.modificationDate) */
+    lastUpdateDate?: ISODateString;
+    /** Maturity level (core config setting, takes priority over mapped respec.specStatus) */
+    maturityLevel?: MaturityLevel;
+    /** Optional ReSpec configuration embedded in config.json */
+    respec?: RawRespecConfig;
+    /**
+     * Custom user-defined properties.
+     * Highest priority - overwrites both root and respec values.
+     */
+    custom?: Record<string, unknown>;
     /** Whether the ID was auto-generated */
     autoGenerated: boolean;
-    /** Optional respec configuration if present in config.json */
-    respec?: RawRespecConfig;
 }
+/**
+ * Raw config as read from config.json:
+ * - id and deps are optional
+ * - autoGenerated should not be user-provided, so we remove it
+ */
+export type DocumentConfig = Omit<Partial<ResolvedDocumentConfig>, 'autoGenerated'>;
 //# sourceMappingURL=types.d.ts.map

package/dist/preprocess/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/preprocess/config/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IAEX,yCAAyC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IAEvB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,eAAe,CAAC;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/preprocess/config/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAChC,MAAM,MAAM,aAAa,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAG3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAG1E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,EAAE,EAAE,UAAU,CAAC;IAEf,yCAAyC;IACzC,IAAI,EAAE,UAAU,EAAE,CAAC;IAEnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0FAA0F;IAC1F,cAAc,CAAC,EAAE,aAAa,CAAC;IAE/B,yFAAyF;IACzF,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,4DAA4D;IAC5D,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACxB,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,eAAe,CAAC,CAAC"}

package/dist/preprocess/include/index.d.ts

@@ -3,5 +3,5 @@
  */
 export { scanMarkdownIncludes } from '#src/preprocess/include/scan-markdown';
 export { scanHtmlIncludes } from '#src/preprocess/include/scan-html';
-export { resolveIncludes } from '#src/preprocess/include/resolver';
+export { resolveIncludes, IncludeResolveError } from '#src/preprocess/include/resolver';
 //# sourceMappingURL=index.d.ts.map

package/dist/preprocess/include/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preprocess/include/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preprocess/include/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/preprocess/include/index.js

@@ -3,5 +3,5 @@
  */
 export { scanMarkdownIncludes } from '#src/preprocess/include/scan-markdown';
 export { scanHtmlIncludes } from '#src/preprocess/include/scan-html';
-export { resolveIncludes } from '#src/preprocess/include/resolver';
+export { resolveIncludes, IncludeResolveError } from '#src/preprocess/include/resolver';
 //# sourceMappingURL=index.js.map

package/dist/preprocess/include/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/preprocess/include/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/preprocess/include/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/preprocess/include/resolver.d.ts

@@ -6,22 +6,31 @@
  *
  * Key behaviors:
  * - Deterministic order: includes are processed in encounter order
- * - Cycle detection: prevents infinite loops with clear diagnostics
+ * - Cycle detection: prevents infinite loops with clear errors
  * - Content splitting: preserves sourcePos.file for each fragment
  */
 import type { FileProvider } from '#src/file-provider/types';
-import type { SourceFormat, CompositeSource, Diagnostic } from '#src/preprocess/types';
+import type { SourceFormat, CompositeSource } from '#src/preprocess/types';
+/**
+ * Error thrown when include resolution fails
+ */
+export declare class IncludeResolveError extends Error {
+    readonly code: 'include-cycle' | 'include-not-found';
+    readonly path: string;
+    constructor(message: string, code: 'include-cycle' | 'include-not-found', path: string);
+}
 /**
  * Resolve all includes from an entry file
  *
  * @param entry - Canonical path to entry file
  * @param entryFormat - Format of entry file (inferred if not provided)
  * @param fileProvider - File provider for reading files
- * @returns CompositeSource with resolved includes and diagnostics
+ * @returns CompositeSource with resolved includes
+ * @throws IncludeResolveError on cycle detection or file not found
  *
  * @example
  * ```typescript
- * const { source, diagnostics } = await resolveIncludes(
+ * const source = await resolveIncludes(
  *   '/spec/format.md',
  *   'markdown',
  *   fileProvider
@@ -33,8 +42,5 @@ import type { SourceFormat, CompositeSource, Diagnostic } from '#src/preprocess/
  * }
  * ```
  */
-export declare function resolveIncludes(entry: string, entryFormat: SourceFormat | undefined, fileProvider: FileProvider): Promise<{
-    source: CompositeSource;
-    diagnostics: Diagnostic[];
-}>;
+export declare function resolveIncludes(entry: string, entryFormat: SourceFormat | undefined, fileProvider: FileProvider): Promise<CompositeSource>;
 //# sourceMappingURL=resolver.d.ts.map

package/dist/preprocess/include/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/preprocess/include/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EACR,YAAY,EAKZ,eAAe,EACf,UAAU,EACb,MAAM,uBAAuB,CAAC;AAqL/B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACjC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAuBjE"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/preprocess/include/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EACR,YAAY,EAKZ,eAAe,EAClB,MAAM,uBAAuB,CAAC;AAK/B;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAGtB,IAAI,EAAE,eAAe,GAAG,mBAAmB;aAC3C,IAAI,EAAE,MAAM;gBAF5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,eAAe,GAAG,mBAAmB,EAC3C,IAAI,EAAE,MAAM;CAKnC;AA6KD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CACjC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/preprocess/include/resolver.js

@@ -6,13 +6,26 @@
  *
  * Key behaviors:
  * - Deterministic order: includes are processed in encounter order
- * - Cycle detection: prevents infinite loops with clear diagnostics
+ * - Cycle detection: prevents infinite loops with clear errors
  * - Content splitting: preserves sourcePos.file for each fragment
  */
 import { isFileNotFoundError } from '#src/file-provider/types';
-import { inferFormat, createDiagnostic } from '#src/preprocess/types';
+import { inferFormat } from '#src/preprocess/types';
 import { scanMarkdownIncludes } from '#src/preprocess/include/scan-markdown';
 import { scanHtmlIncludes } from '#src/preprocess/include/scan-html';
+/**
+ * Error thrown when include resolution fails
+ */
+export class IncludeResolveError extends Error {
+    code;
+    path;
+    constructor(message, code, path) {
+        super(message);
+        this.code = code;
+        this.path = path;
+        this.name = 'IncludeResolveError';
+    }
+}
 /**
  * Count lines up to an offset
  */
@@ -37,14 +50,14 @@ function scanIncludes(content, file, format) {
  * Split content at include points and recursively resolve
  *
  * Returns SourceUnits in document order (includes expanded in-place)
+ * @throws IncludeResolveError on cycle detection or file not found
  */
 async function resolveFile(file, format, ctx) {
-    const { fileProvider, includeGraph, diagnostics, activePath, visited } = ctx;
+    const { fileProvider, includeGraph, activePath, visited } = ctx;
     // Cycle detection
     if (activePath.has(file)) {
         const cycle = [...activePath, file];
-        diagnostics.push(createDiagnostic('error', 'include-cycle', `Include cycle detected: ${cycle.join(' → ')}`, file));
-        return [];
+        throw new IncludeResolveError(`Include cycle detected: ${cycle.join(' → ')}`, 'include-cycle', file);
     }
     // Check if already processed (for diamond includes - A includes B and C, both include D)
     const cached = visited.get(file);
@@ -64,12 +77,11 @@ async function resolveFile(file, format, ctx) {
     }
     catch (error) {
         if (isFileNotFoundError(error)) {
-            diagnostics.push(createDiagnostic('error', 'include-not-found', `Included file not found: ${file}`, file));
+            throw new IncludeResolveError(`Included file not found: ${file}`, 'include-not-found', file);
         }
         else {
-            diagnostics.push(createDiagnostic('error', 'include-not-found', `Failed to read included file: ${file} - ${error instanceof Error ? error.message : String(error)}`, file));
+            throw new IncludeResolveError(`Failed to read included file: ${file} - ${error instanceof Error ? error.message : String(error)}`, 'include-not-found', file);
         }
-        return [];
     }
     // Cache for diamond include handling
     visited.set(file, { content, format });
@@ -147,11 +159,12 @@ async function resolveFile(file, format, ctx) {
  * @param entry - Canonical path to entry file
  * @param entryFormat - Format of entry file (inferred if not provided)
  * @param fileProvider - File provider for reading files
- * @returns CompositeSource with resolved includes and diagnostics
+ * @returns CompositeSource with resolved includes
+ * @throws IncludeResolveError on cycle detection or file not found
  *
  * @example
  * ```typescript
- * const { source, diagnostics } = await resolveIncludes(
+ * const source = await resolveIncludes(
  *   '/spec/format.md',
  *   'markdown',
  *   fileProvider
@@ -169,19 +182,15 @@ export async function resolveIncludes(entry, entryFormat, fileProvider) {
     const ctx = {
         fileProvider,
         includeGraph: new Map(),
-        diagnostics: [],
         activePath: new Set(),
         visited: new Map(),
     };
     const units = await resolveFile(canonicalEntry, format, ctx);
     return {
-        source: {
-            entryFile: canonicalEntry,
-            entryFormat: format,
-            units,
-            includeGraph: ctx.includeGraph,
-        },
-        diagnostics: ctx.diagnostics,
+        entryFile: canonicalEntry,
+        entryFormat: format,
+        units,
+        includeGraph: ctx.includeGraph,
     };
 }
 //# sourceMappingURL=resolver.js.map

package/dist/preprocess/include/resolver.js.map

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

package/dist/preprocess/index.d.ts

@@ -6,11 +6,11 @@
  * - Resolving includes to produce ordered SourceUnits
  * - Preserving source file information for accurate error reporting
  */
-export { preprocess, validateEntry } from '#src/preprocess/pipeline';
+export { preprocess, validateEntry, PreprocessError } from '#src/preprocess/pipeline';
 export type { PreprocessOptions } from '#src/preprocess/pipeline';
-export type { SourceFormat, IncludeDirective, SourceUnit, IncludeGraph, IncludeEdge, CompositeSource, PersonEntry, SpecConfig, PreprocessedSpec, DiagnosticSeverity, PreprocessDiagnosticCode, Diagnostic, PreprocessResult, } from '#src/preprocess/types';
-export { inferFormat, createDiagnostic } from '#src/preprocess/types';
-export { loadRespecConfig, normalizeRespecConfig, createDefaultConfig, } from '#src/preprocess/config/index';
-export type { RawRespecConfig, RawPersonEntry } from '#src/preprocess/config/index';
-export { scanMarkdownIncludes, scanHtmlIncludes, resolveIncludes, } from '#src/preprocess/include/index';
+export type { SourceFormat, IncludeDirective, SourceUnit, IncludeGraph, IncludeEdge, CompositeSource, PersonEntry, SpecConfig, PreprocessedSpec, MaturityLevel, } from '#src/preprocess/types';
+export { inferFormat } from '#src/preprocess/types';
+export { loadConfig, normalizeConfig, createDefaultConfig, ConfigLoadError, } from '#src/preprocess/config/index';
+export type { RawRespecConfig, RawPersonEntry, DocumentConfig, ResolvedDocumentConfig } from '#src/preprocess/config/index';
+export { scanMarkdownIncludes, scanHtmlIncludes, resolveIncludes, IncludeResolveError, } from '#src/preprocess/include/index';
 //# sourceMappingURL=index.d.ts.map

package/dist/preprocess/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,YAAY,EACR,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,UAAU,EACV,gBAAgB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EACH,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAClB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,YAAY,EACR,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,aAAa,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EACH,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,GAClB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAG5H,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACtB,MAAM,+BAA+B,CAAC"}

package/dist/preprocess/index.js

@@ -7,10 +7,10 @@
  * - Preserving source file information for accurate error reporting
  */
 // Main orchestrator
-export { preprocess, validateEntry } from '#src/preprocess/pipeline';
-export { inferFormat, createDiagnostic } from '#src/preprocess/types';
+export { preprocess, validateEntry, PreprocessError } from '#src/preprocess/pipeline';
+export { inferFormat } from '#src/preprocess/types';
 // Config submodule (for advanced use)
-export { loadRespecConfig, normalizeRespecConfig, createDefaultConfig, } from '#src/preprocess/config/index';
+export { loadConfig, normalizeConfig, createDefaultConfig, ConfigLoadError, } from '#src/preprocess/config/index';
 // Include submodule (for advanced use)
-export { scanMarkdownIncludes, scanHtmlIncludes, resolveIncludes, } from '#src/preprocess/include/index';
+export { scanMarkdownIncludes, scanHtmlIncludes, resolveIncludes, IncludeResolveError, } from '#src/preprocess/include/index';
 //# sourceMappingURL=index.js.map

package/dist/preprocess/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/preprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAoBrE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,sCAAsC;AACtC,OAAO,EACH,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,8BAA8B,CAAC;AAGtC,uCAAuC;AACvC,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAClB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/preprocess/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAiBtF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,sCAAsC;AACtC,OAAO,EACH,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,GAClB,MAAM,8BAA8B,CAAC;AAGtC,uCAAuC;AACvC,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACtB,MAAM,+BAA+B,CAAC"}

package/dist/preprocess/pipeline.d.ts

@@ -5,7 +5,7 @@
  * This is the main entry point for the preprocess stage.
  */
 import type { FileProvider } from '#src/file-provider/types';
-import type { SourceFormat, PreprocessResult, Diagnostic } from '#src/preprocess/types';
+import type { SourceFormat, PreprocessedSpec } from '#src/preprocess/types';
 /**
  * Options for preprocessing a specification
  */
@@ -19,6 +19,14 @@ export interface PreprocessOptions {
     /** File provider for reading files */
     fileProvider: FileProvider;
 }
+/**
+ * Error thrown when preprocessing fails
+ */
+export declare class PreprocessError extends Error {
+    readonly code: string;
+    readonly path?: string | undefined;
+    constructor(message: string, code: string, path?: string | undefined);
+}
 /**
  * Preprocess a specification document
  *
@@ -26,32 +34,27 @@ export interface PreprocessOptions {
  * to produce a PreprocessedSpec ready for parsing.
  *
  * @param options - Preprocess options
- * @returns PreprocessResult with spec and diagnostics
+ * @returns PreprocessedSpec with config and source
+ * @throws PreprocessError on failure
  *
  * @example
  * ```typescript
- * const result = await preprocess({
+ * const spec = await preprocess({
  *   entry: '/specs/my-spec/format.md',
- *   configPath: '/specs/my-spec/config.respec.json',
+ *   configPath: '/specs/my-spec/config.json',
  *   fileProvider: new NodeFileProvider(),
  * });
  *
- * if (result.hasErrors) {
- *   console.error('Preprocess errors:', result.diagnostics);
- * } else {
- *   // result.result contains PreprocessedSpec
- *   for (const unit of result.result.source.units) {
- *     console.log(`Processing: ${unit.file}`);
- *   }
+ * // spec contains PreprocessedSpec
+ * for (const unit of spec.source.units) {
+ *   console.log(`Processing: ${unit.file}`);
  * }
  * ```
  */
-export declare function preprocess(options: PreprocessOptions): Promise<PreprocessResult>;
+export declare function preprocess(options: PreprocessOptions): Promise<PreprocessedSpec>;
 /**
  * Quick check if an entry file exists and is readable
+ * @throws PreprocessError if entry file not found
  */
-export declare function validateEntry(entry: string, fileProvider: FileProvider): Promise<{
-    valid: boolean;
-    diagnostics: Diagnostic[];
-}>;
+export declare function validateEntry(entry: string, fileProvider: FileProvider): Promise<void>;
 //# sourceMappingURL=pipeline.d.ts.map

package/dist/preprocess/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/preprocess/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACR,YAAY,EAEZ,gBAAgB,EAChB,UAAU,EACb,MAAM,uBAAuB,CAAC;AAK/B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IAEd,yEAAyE;IACzE,WAAW,CAAC,EAAE,YAAY,CAAC;IAE3B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+CtF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAgBxD"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/preprocess/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACR,YAAY,EAEZ,gBAAgB,EACnB,MAAM,uBAAuB,CAAC;AAK/B;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IAEd,yEAAyE;IACzE,WAAW,CAAC,EAAE,YAAY,CAAC;IAE3B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGlB,IAAI,EAAE,MAAM;aACZ,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsCtF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/preprocess/pipeline.js

@@ -5,8 +5,21 @@
  * This is the main entry point for the preprocess stage.
  */
 import { inferFormat } from '#src/preprocess/types';
-import { loadRespecConfig, normalizeRespecConfig, createDefaultConfig } from '#src/preprocess/config/index';
-import { resolveIncludes } from '#src/preprocess/include/index';
+import { loadConfig, normalizeConfig, createDefaultConfig, ConfigLoadError } from '#src/preprocess/config/index';
+import { resolveIncludes, IncludeResolveError } from '#src/preprocess/include/index';
+/**
+ * Error thrown when preprocessing fails
+ */
+export class PreprocessError extends Error {
+    code;
+    path;
+    constructor(message, code, path) {
+        super(message);
+        this.code = code;
+        this.path = path;
+        this.name = 'PreprocessError';
+    }
+}
 /**
  * Preprocess a specification document
  *
@@ -14,87 +27,72 @@ import { resolveIncludes } from '#src/preprocess/include/index';
  * to produce a PreprocessedSpec ready for parsing.
  *
  * @param options - Preprocess options
- * @returns PreprocessResult with spec and diagnostics
+ * @returns PreprocessedSpec with config and source
+ * @throws PreprocessError on failure
  *
  * @example
  * ```typescript
- * const result = await preprocess({
+ * const spec = await preprocess({
  *   entry: '/specs/my-spec/format.md',
- *   configPath: '/specs/my-spec/config.respec.json',
+ *   configPath: '/specs/my-spec/config.json',
  *   fileProvider: new NodeFileProvider(),
  * });
  *
- * if (result.hasErrors) {
- *   console.error('Preprocess errors:', result.diagnostics);
- * } else {
- *   // result.result contains PreprocessedSpec
- *   for (const unit of result.result.source.units) {
- *     console.log(`Processing: ${unit.file}`);
- *   }
+ * // spec contains PreprocessedSpec
+ * for (const unit of spec.source.units) {
+ *   console.log(`Processing: ${unit.file}`);
  * }
  * ```
  */
 export async function preprocess(options) {
     const { entry, entryFormat, configPath, fileProvider } = options;
-    const diagnostics = [];
     // Canonicalize entry path
     const canonicalEntry = fileProvider.canonicalize(entry);
     const format = entryFormat ?? inferFormat(canonicalEntry);
     // Load config if provided
     let config;
     if (configPath) {
-        const configResult = await loadRespecConfig(fileProvider, configPath);
-        diagnostics.push(...configResult.diagnostics);
-        if (configResult.config) {
-            config = normalizeRespecConfig(configResult.config);
+        try {
+            const docConfig = await loadConfig(fileProvider, configPath);
+            config = normalizeConfig(docConfig);
         }
-        else {
-            // Config load failed, use defaults but continue
-            config = createDefaultConfig();
+        catch (error) {
+            if (error instanceof ConfigLoadError) {
+                throw new PreprocessError(error.message, error.code, error.path);
+            }
+            throw error;
         }
     }
     else {
         config = createDefaultConfig();
     }
     // Resolve includes
-    const includeResult = await resolveIncludes(canonicalEntry, format, fileProvider);
-    diagnostics.push(...includeResult.diagnostics);
-    // Check for errors
-    const hasErrors = diagnostics.some(d => d.severity === 'error');
-    // Even with errors, return partial result if we have units
-    if (includeResult.source.units.length === 0 && hasErrors) {
-        return {
-            diagnostics,
-            hasErrors,
-        };
+    let source;
+    try {
+        source = await resolveIncludes(canonicalEntry, format, fileProvider);
+    }
+    catch (error) {
+        if (error instanceof IncludeResolveError) {
+            throw new PreprocessError(error.message, error.code, error.path);
+        }
+        throw error;
     }
     return {
-        result: {
-            config,
-            source: includeResult.source,
-        },
-        diagnostics,
-        hasErrors,
+        config,
+        source,
     };
 }
 /**
  * Quick check if an entry file exists and is readable
+ * @throws PreprocessError if entry file not found
  */
 export async function validateEntry(entry, fileProvider) {
-    const diagnostics = [];
     const canonicalEntry = fileProvider.canonicalize(entry);
     try {
         await fileProvider.readText(canonicalEntry);
-        return { valid: true, diagnostics };
     }
     catch {
-        diagnostics.push({
-            severity: 'error',
-            code: 'include-not-found',
-            message: `Entry file not found: ${canonicalEntry}`,
-            file: canonicalEntry,
-        });
-        return { valid: false, diagnostics };
+        throw new PreprocessError(`Entry file not found: ${canonicalEntry}`, 'entry-not-found', canonicalEntry);
     }
 }
 //# sourceMappingURL=pipeline.js.map

package/dist/preprocess/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/preprocess/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAmBhE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACvD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACjE,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,0BAA0B;IAC1B,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,WAAW,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;IAE1D,0BAA0B;IAC1B,IAAI,MAAkB,CAAC;IACvB,IAAI,UAAU,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACtE,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QAE9C,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACJ,gDAAgD;YAChD,MAAM,GAAG,mBAAmB,EAAE,CAAC;QACnC,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACnC,CAAC;IAED,mBAAmB;IACnB,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IAClF,WAAW,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAE/C,mBAAmB;IACnB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAEhE,2DAA2D;IAC3D,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QACvD,OAAO;YACH,WAAW;YACX,SAAS;SACZ,CAAC;IACN,CAAC;IAED,OAAO;QACH,MAAM,EAAE;YACJ,MAAM;YACN,MAAM,EAAE,aAAa,CAAC,MAAM;SAC/B;QACD,WAAW;QACX,SAAS;KACZ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,KAAa,EACb,YAA0B;IAE1B,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC;QACD,MAAM,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC5C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACL,WAAW,CAAC,IAAI,CAAC;YACb,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,yBAAyB,cAAc,EAAE;YAClD,IAAI,EAAE,cAAc;SACvB,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IACzC,CAAC;AACL,CAAC"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/preprocess/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAmBrF;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGlB;IACA;IAHpB,YACI,OAAe,EACC,IAAY,EACZ,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAClC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACvD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEjE,0BAA0B;IAC1B,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,WAAW,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;IAE1D,0BAA0B;IAC1B,IAAI,MAAkB,CAAC;IACvB,IAAI,UAAU,EAAE,CAAC;QACb,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAC7D,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACnC,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACnC,CAAC;IAED,mBAAmB;IACnB,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACD,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;YACvC,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,KAAK,CAAC;IAChB,CAAC;IAED,OAAO;QACH,MAAM;QACN,MAAM;KACT,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,KAAa,EACb,YAA0B;IAE1B,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC;QACD,MAAM,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,eAAe,CACrB,yBAAyB,cAAc,EAAE,EACzC,iBAAiB,EACjB,cAAc,CACjB,CAAC;IACN,CAAC;AACL,CAAC"}