/** Offsets use JavaScript UTF-16 code units, so content.slice(start, end) is exact. */ export interface WritingSpan { start: number; end: number; } export type WritingContext = 'prose' | 'code' | 'quote' | 'inventory' | 'checklist' | 'questionnaire' | 'literal'; export interface DiagnosticRule { id: string; /** Literal phrase matching: user preferences are data, never executable regexes. */ phrase: string; explanation: string; suggestion: string; authority: 'advisory' | 'user'; enabled?: boolean; } export interface WritingException extends WritingSpan { ruleId: string; contentHash: string; reason: string; } export interface ContextualDiagnostic extends WritingSpan { id: string; ruleId: string; text: string; context: WritingContext; explanation: string; suggestion: string; authority: 'advisory' | 'user'; /** A heuristic match is not calibrated statistical confidence. */ confidence: { kind: 'heuristic'; calibrated: false; }; resolution: 'review' | 'retained'; reason?: string; } export interface DiagnosticOptions { language?: string; rules?: DiagnosticRule[]; /** Explicit user rules override defaults by ID; disabled rules suppress the default. */ overrides?: DiagnosticRule[]; contexts?: Array; exceptions?: WritingException[]; /** Domain terms are exempt from advisory phrase matches, but not explicit user rules. */ terminology?: string[]; } export interface ContextualDiagnosticResult { schemaVersion: 1; contentHash: string; language: string; offsetEncoding: 'utf-16'; diagnostics: ContextualDiagnostic[]; notices: string[]; publicationGate: false; } export declare function writingContentHash(content: string): string; /** Advisory editorial findings, without an authorship score or automatic rewrite. */ export declare function diagnoseWriting(content: string, options?: DiagnosticOptions): ContextualDiagnosticResult; /** Cross-document exact paragraph repetition; document IDs must be unique. */ export declare function diagnoseWritingBatch(documents: Array<{ id: string; content: string; }>, options?: DiagnosticOptions): Map; //# sourceMappingURL=contextual-diagnostics.d.ts.map