@openuji/speculator 0.3.2 → 0.4.0

package/dist/preprocess/pipeline.js.map

@@ -0,0 +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"}

package/dist/preprocess/types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Preprocess Stage Types
+ *
+ * Types for spec configuration loading and file composition before parsing.
+ */
+import type { SourcePos } from '#src/types/ast.generated';
+/**
+ * Supported input formats for spec files
+ */
+export type SourceFormat = 'markdown' | 'html';
+/**
+ * Infer format from file extension
+ */
+export declare function inferFormat(path: string): SourceFormat;
+/**
+ * A parsed include directive from source content
+ */
+export interface IncludeDirective {
+    /** Relative path as written in source (e.g., "./intro.md") */
+    relativePath: string;
+    /** Explicit format if specified, otherwise inferred from extension */
+    format?: SourceFormat;
+    /** Position of the directive in source */
+    sourcePos: SourcePos;
+    /** Start offset in content (for splitting) */
+    startOffset: number;
+    /** End offset in content (for splitting) */
+    endOffset: number;
+}
+/**
+ * A unit of source content with its origin file
+ *
+ * The preprocess stage splits content at include points to preserve
+ * sourcePos.file for each fragment. This enables accurate error reporting
+ * that points to the correct file.
+ */
+export interface SourceUnit {
+    /** Canonical file path */
+    file: string;
+    /** Content format */
+    format: SourceFormat;
+    /** Raw content (not the entire file if split at includes) */
+    content: string;
+    /**
+     * Display-friendly file path for error messages
+     * (e.g., relative to spec root)
+     */
+    displayFile?: string;
+    /**
+     * 1-indexed line number where this unit's content starts in the source file.
+     * Used to compute accurate sourcePos for parsed AST nodes.
+     */
+    startLine: number;
+}
+/**
+ * Edge in the include graph
+ */
+export interface IncludeEdge {
+    /** Canonical path of included file */
+    target: string;
+    /** Position where include occurred */
+    sourcePos: SourcePos;
+}
+/**
+ * Include graph tracking parent→children relationships
+ * Maps canonical file path to list of includes from that file
+ */
+export type IncludeGraph = Map<string, IncludeEdge[]>;
+/**
+ * Composed source document from entry file and includes
+ *
+ * The units array is ordered by document flow - includes are expanded
+ * in-place where they appear in the source.
+ */
+export interface CompositeSource {
+    /** Canonical path of entry file */
+    entryFile: string;
+    /** Format of entry file */
+    entryFormat: SourceFormat;
+    /**
+     * Ordered source units representing document flow.
+     * Includes are expanded in-place (encounter order).
+     */
+    units: SourceUnit[];
+    /** Include relationship graph for diagnostics */
+    includeGraph: IncludeGraph;
+}
+/**
+ * Person entry for editors/authors
+ */
+export interface PersonEntry {
+    name: string;
+    url?: string;
+    company?: string;
+    companyURL?: string;
+    email?: string;
+}
+/**
+ * Normalized spec configuration
+ *
+ * Internal representation derived from ReSpec-like config files.
+ * All optional fields have sensible defaults applied.
+ */
+export interface SpecConfig {
+    /** Document title */
+    title?: string;
+    /** Short name for URLs/references (e.g., "html", "css-grid") */
+    shortName?: string;
+    /** Subtitle or tagline */
+    subtitle?: string;
+    /** Spec status (e.g., "ED", "WD", "CR", "REC", "NOTE") */
+    status?: string;
+    /** Publication date (ISO 8601: YYYY-MM-DD) */
+    publishDate?: string;
+    /** This version URL */
+    thisVersion?: string;
+    /** Latest version URL */
+    latestVersion?: string;
+    /** Previous version URL */
+    previousVersion?: string;
+    /** Editor list */
+    editors?: PersonEntry[];
+    /** Author list */
+    authors?: PersonEntry[];
+    /** Abstract text (if not in document body) */
+    abstract?: string;
+    /** Copyright notice */
+    copyright?: string;
+    /** License URL */
+    license?: string;
+    /** Additional logos */
+    logos?: Array<{
+        src: string;
+        alt?: string;
+        href?: string;
+    }>;
+    /** Enable table of contents generation */
+    tocEnabled?: boolean;
+    /** Maximum ToC depth */
+    maxTocLevel?: number;
+    /** Custom specification profile/variant */
+    specProfile?: string;
+}
+/**
+ * Complete preprocessed specification ready for parsing
+ */
+export interface PreprocessedSpec {
+    /** Normalized configuration */
+    config: SpecConfig;
+    /** Composed source with includes resolved */
+    source: CompositeSource;
+}
+/**
+ * Diagnostic severity levels
+ */
+export type DiagnosticSeverity = 'error' | 'warning' | 'info';
+/**
+ * Preprocess diagnostic codes
+ */
+export type PreprocessDiagnosticCode = 'include-cycle' | 'include-not-found' | 'config-parse-error' | 'config-not-found' | 'invalid-include-directive' | 'unknown-format';
+/**
+ * Diagnostic message from preprocessing
+ */
+export interface Diagnostic {
+    /** Severity level */
+    severity: DiagnosticSeverity;
+    /** Machine-readable error code */
+    code: PreprocessDiagnosticCode;
+    /** Human-readable message */
+    message: string;
+    /** File where issue occurred */
+    file?: string;
+    /** Position in file (if applicable) */
+    sourcePos?: SourcePos;
+    /** Related information (e.g., cycle path) */
+    related?: Array<{
+        file: string;
+        message: string;
+        sourcePos?: SourcePos;
+    }>;
+}
+/**
+ * Create a diagnostic helper
+ */
+export declare function createDiagnostic(severity: DiagnosticSeverity, code: PreprocessDiagnosticCode, message: string, file?: string, sourcePos?: SourcePos): Diagnostic;
+/**
+ * Result of preprocessing with diagnostics
+ */
+export interface PreprocessResult {
+    /** Preprocessed spec (may be partial if errors occurred) */
+    result?: PreprocessedSpec;
+    /** Diagnostics collected during preprocessing */
+    diagnostics: Diagnostic[];
+    /** Quick check for any errors */
+    hasErrors: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/preprocess/types.js

@@ -0,0 +1,22 @@
+/**
+ * Preprocess Stage Types
+ *
+ * Types for spec configuration loading and file composition before parsing.
+ */
+/**
+ * Infer format from file extension
+ */
+export function inferFormat(path) {
+    const ext = path.split('.').pop()?.toLowerCase();
+    if (ext === 'html' || ext === 'htm') {
+        return 'html';
+    }
+    return 'markdown';
+}
+/**
+ * Create a diagnostic helper
+ */
+export function createDiagnostic(severity, code, message, file, sourcePos) {
+    return { severity, code, message, file, sourcePos };
+}
+//# sourceMappingURL=types.js.map

package/dist/preprocess/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/preprocess/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IACjD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAoPD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,QAA4B,EAC5B,IAA8B,EAC9B,OAAe,EACf,IAAa,EACb,SAAqB;IAErB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACxD,CAAC"}