@ontrails/warden 1.0.0-beta.0

package/dist/rules/specs.d.ts

@@ -0,0 +1,29 @@
+export interface ParsedEntry {
+    readonly line: number;
+    readonly start: number;
+    readonly text: string;
+}
+export interface ObjectProperty extends ParsedEntry {
+    readonly key: string;
+    readonly value: string;
+}
+export interface TrailLikeSpec {
+    readonly id: string;
+    readonly kind: 'hike' | 'trail';
+    readonly line: number;
+    readonly properties: ReadonlyMap<string, ObjectProperty>;
+    readonly specText: string;
+    readonly start: number;
+}
+export interface SchemaFieldInfo {
+    readonly derivedLabel: string;
+    readonly options?: readonly string[] | undefined;
+    readonly required: boolean;
+}
+export declare const parseStringLiteral: (text: string) => string | null;
+export declare const parseArrayEntries: (arrayText: string, arrayStart: number, sourceCode: string) => readonly ParsedEntry[];
+export declare const parseObjectProperties: (objectText: string, objectStart: number, sourceCode: string) => ReadonlyMap<string, ObjectProperty>;
+export declare const findTrailLikeSpecs: (sourceCode: string) => readonly TrailLikeSpec[];
+export declare const collectTrailIds: (sourceCode: string) => ReadonlySet<string>;
+export declare const parseZodObjectShape: (schemaText: string) => ReadonlyMap<string, SchemaFieldInfo>;
+//# sourceMappingURL=specs.d.ts.map

package/dist/rules/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/rules/specs.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAuFD,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,IAc1D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,YAAY,MAAM,KACjB,SAAS,WAAW,EActB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,YAAY,MAAM,KACjB,WAAW,CAAC,MAAM,EAAE,cAAc,CAcpC,CAAC;AA2KF,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,KACjB,SAAS,aAAa,EAiBxB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,YAAY,MAAM,KAAG,WAAW,CAAC,MAAM,CACP,CAAC;AAEjE,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,KACjB,WAAW,CAAC,MAAM,EAAE,eAAe,CAcrC,CAAC"}

package/dist/rules/specs.js

@@ -0,0 +1,192 @@
+import { captureBalanced, lineNumberAt, splitTopLevelEntriesWithOffsets, } from './structure.js';
+const TRAIL_LIKE_PATTERN = /\b(trail|hike)\s*\(/g;
+const PROPERTY_PATTERN = /^(?:readonly\s+)?(?:(["'`])([^"'`]+)\1|([A-Za-z_$][\w$]*))\s*:\s*([\s\S]+)$/;
+const OPTIONALISH_PATTERN = /(?:^|[^\w])z\.(?:default|nullish|optional)\s*\(|\.(?:default|nullish|optional)\s*\(/;
+const humanize = (str) => str
+    .replaceAll(/([a-z])([A-Z])/g, '$1 $2')
+    .replaceAll(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+    .replace(/^./, (ch) => ch.toUpperCase());
+const trimWrapped = (text, open, close) => {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith(open) || !trimmed.endsWith(close)) {
+        return null;
+    }
+    return trimmed.slice(1, -1);
+};
+const firstEntry = (text) => {
+    const [entry] = splitTopLevelEntriesWithOffsets(text);
+    return entry ?? null;
+};
+const createParsedEntry = (sourceCode, start, text) => ({
+    line: lineNumberAt(sourceCode, start),
+    start,
+    text,
+});
+const createObjectProperty = (entry, key, value, objectStart, objectOffset, sourceCode) => {
+    const start = objectStart + objectOffset + 1 + entry.start;
+    return {
+        key,
+        line: lineNumberAt(sourceCode, start),
+        start,
+        text: entry.text,
+        value,
+    };
+};
+const parsePropertyEntry = (entry, objectStart, objectOffset, sourceCode) => {
+    const propertyMatch = entry.text.match(PROPERTY_PATTERN);
+    const key = propertyMatch?.[2] ?? propertyMatch?.[3];
+    const value = propertyMatch?.[4]?.trim();
+    if (!key || !value) {
+        return null;
+    }
+    return createObjectProperty(entry, key, value, objectStart, objectOffset, sourceCode);
+};
+const isDefined = (value) => value !== null;
+export const parseStringLiteral = (text) => {
+    const trimmed = text.trim();
+    const [quote = ''] = trimmed;
+    const closer = quote === "'" || quote === '"' || quote === '`' ? quote : null;
+    if (closer === null || trimmed.at(-1) !== closer) {
+        return null;
+    }
+    const value = trimmed.slice(1, -1);
+    if (quote === '`' && value.includes('${')) {
+        return null;
+    }
+    return value;
+};
+export const parseArrayEntries = (arrayText, arrayStart, sourceCode) => {
+    const inner = trimWrapped(arrayText, '[', ']');
+    if (inner === null) {
+        return [];
+    }
+    const arrayOffset = arrayText.indexOf('[');
+    return splitTopLevelEntriesWithOffsets(inner).map((entry) => createParsedEntry(sourceCode, arrayStart + arrayOffset + 1 + entry.start, entry.text));
+};
+export const parseObjectProperties = (objectText, objectStart, sourceCode) => {
+    const inner = trimWrapped(objectText, '{', '}');
+    if (inner === null) {
+        return new Map();
+    }
+    const objectOffset = objectText.indexOf('{');
+    const properties = splitTopLevelEntriesWithOffsets(inner)
+        .map((entry) => parsePropertyEntry(entry, objectStart, objectOffset, sourceCode))
+        .filter(isDefined);
+    return new Map(properties.map((property) => [property.key, property]));
+};
+const resolveSpecTarget = (args) => {
+    const [firstArg, secondArg] = args;
+    if (!firstArg) {
+        return null;
+    }
+    const id = parseStringLiteral(firstArg.text);
+    return {
+        id,
+        specArg: id === null ? firstArg : (secondArg ?? firstArg),
+    };
+};
+const parseCallArguments = (sourceCode, callStart) => {
+    const openParen = sourceCode.indexOf('(', callStart);
+    const call = openParen === -1 ? null : captureBalanced(sourceCode, openParen);
+    if (call === null || openParen === -1) {
+        return null;
+    }
+    return {
+        argsStart: openParen + 1,
+        argsText: call.text.slice(1, -1),
+    };
+};
+const isSpecObject = (entry) => entry !== undefined && entry.text.trim().startsWith('{');
+const resolveSpecId = (resolved, properties) => resolved.id ?? parseStringLiteral(properties.get('id')?.value ?? '');
+const buildTrailLikeSpec = (sourceCode, kind, specArg, specStart, id, properties) => ({
+    id,
+    kind,
+    line: lineNumberAt(sourceCode, specStart),
+    properties,
+    specText: specArg.text,
+    start: specStart,
+});
+const parseResolvedSpec = (sourceCode, resolved, call) => {
+    const specStart = call.argsStart + resolved.specArg.start;
+    const properties = parseObjectProperties(resolved.specArg.text, specStart, sourceCode);
+    const id = resolveSpecId(resolved, properties);
+    return id === null ? null : { id, properties, specStart };
+};
+const resolveTrailLikeSpec = (sourceCode, callStart) => {
+    const call = parseCallArguments(sourceCode, callStart);
+    if (call === null) {
+        return null;
+    }
+    const resolved = resolveSpecTarget(splitTopLevelEntriesWithOffsets(call.argsText));
+    if (!resolved || !isSpecObject(resolved.specArg)) {
+        return null;
+    }
+    const parsed = parseResolvedSpec(sourceCode, resolved, call);
+    return parsed === null ? null : { parsed, resolved };
+};
+const parseTrailLikeMatch = (sourceCode, kind, callStart) => {
+    const resolved = resolveTrailLikeSpec(sourceCode, callStart);
+    if (resolved === null) {
+        return null;
+    }
+    return buildTrailLikeSpec(sourceCode, kind, resolved.resolved.specArg, resolved.parsed.specStart, resolved.parsed.id, resolved.parsed.properties);
+};
+const findCallArguments = (sourceText, pattern) => {
+    const index = pattern.exec(sourceText)?.index;
+    if (index === undefined) {
+        return null;
+    }
+    return parseCallArguments(sourceText, index)?.argsText ?? null;
+};
+const parseStringArrayLiteral = (arrayText) => {
+    const inner = trimWrapped(arrayText, '[', ']');
+    if (inner === null) {
+        return null;
+    }
+    const values = splitTopLevelEntriesWithOffsets(inner).map((entry) => parseStringLiteral(entry.text));
+    const strings = values.filter((value) => value !== null);
+    return strings.length === values.length ? strings : null;
+};
+const parseDescribeLabel = (fieldText) => {
+    const args = findCallArguments(fieldText, /\.describe\s*\(/);
+    return args === null ? undefined : (parseStringLiteral(args) ?? undefined);
+};
+const parseEnumValues = (fieldText) => {
+    const args = findCallArguments(fieldText, /\bz\.enum\s*\(/);
+    const entry = args === null ? null : firstEntry(args);
+    return entry ? (parseStringArrayLiteral(entry.text) ?? undefined) : undefined;
+};
+const toSchemaFieldInfo = (key, property) => ({
+    derivedLabel: parseDescribeLabel(property.value) ?? humanize(key),
+    options: parseEnumValues(property.value),
+    required: !OPTIONALISH_PATTERN.test(property.value),
+});
+export const findTrailLikeSpecs = (sourceCode) => {
+    const specs = [];
+    for (const match of sourceCode.matchAll(TRAIL_LIKE_PATTERN)) {
+        const callStart = match.index;
+        if (callStart === undefined) {
+            continue;
+        }
+        const kind = match[1] === 'hike' ? 'hike' : 'trail';
+        const spec = parseTrailLikeMatch(sourceCode, kind, callStart);
+        if (spec !== null) {
+            specs.push(spec);
+        }
+    }
+    return specs;
+};
+export const collectTrailIds = (sourceCode) => new Set(findTrailLikeSpecs(sourceCode).map((spec) => spec.id));
+export const parseZodObjectShape = (schemaText) => {
+    const args = findCallArguments(schemaText, /\bz\.object\s*\(/);
+    const shapeEntry = args === null ? null : firstEntry(args);
+    if (!shapeEntry || !shapeEntry.text.trim().startsWith('{')) {
+        return new Map();
+    }
+    const shape = parseObjectProperties(shapeEntry.text, 0, shapeEntry.text);
+    return new Map([...shape.entries()].map(([key, property]) => [
+        key,
+        toSchemaFieldInfo(key, property),
+    ]));
+};
+//# sourceMappingURL=specs.js.map

package/dist/rules/specs.js.map

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

package/dist/rules/structure.d.ts

@@ -0,0 +1,13 @@
+interface BalancedSegment {
+    readonly end: number;
+    readonly text: string;
+}
+export interface SplitEntry {
+    readonly start: number;
+    readonly text: string;
+}
+export declare const captureBalanced: (sourceText: string, startIndex: number) => BalancedSegment | null;
+export declare const lineNumberAt: (sourceText: string, startIndex: number) => number;
+export declare const splitTopLevelEntriesWithOffsets: (sourceText: string) => SplitEntry[];
+export {};
+//# sourceMappingURL=structure.d.ts.map

package/dist/rules/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/rules/structure.ts"],"names":[],"mappings":"AAYA,UAAU,eAAe;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAmHD,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,EAClB,YAAY,MAAM,KACjB,eAAe,GAAG,IAiBpB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,EAAE,YAAY,MAAM,KAAG,MAClB,CAAC;AAuDrD,eAAO,MAAM,+BAA+B,GAC1C,YAAY,MAAM,KACjB,UAAU,EAkBZ,CAAC"}

package/dist/rules/structure.js

@@ -0,0 +1,142 @@
+const createState = () => ({
+    braceDepth: 0,
+    bracketDepth: 0,
+    escaped: false,
+    parenDepth: 0,
+    quoteMode: null,
+});
+const enterQuote = (ch) => {
+    if (ch === "'" || ch === '"' || ch === '`') {
+        return ch;
+    }
+    return null;
+};
+const clearEscape = (state) => {
+    if (!state.escaped) {
+        return false;
+    }
+    state.escaped = false;
+    return true;
+};
+const beginEscape = (state, ch) => {
+    if (ch !== '\\') {
+        return false;
+    }
+    state.escaped = true;
+    return true;
+};
+const closeQuote = (state, ch) => {
+    if (ch === state.quoteMode) {
+        state.quoteMode = null;
+    }
+};
+const updateQuotedState = (state, ch) => {
+    if (state.quoteMode === null) {
+        return false;
+    }
+    if (clearEscape(state)) {
+        return true;
+    }
+    if (beginEscape(state, ch)) {
+        return true;
+    }
+    closeQuote(state, ch);
+    return true;
+};
+const STRUCTURAL_DELTAS = {
+    '(': ['parenDepth', 1],
+    ')': ['parenDepth', -1],
+    '[': ['bracketDepth', 1],
+    ']': ['bracketDepth', -1],
+    '{': ['braceDepth', 1],
+    '}': ['braceDepth', -1],
+};
+const updateStructuralDepth = (state, ch) => {
+    if (!(ch in STRUCTURAL_DELTAS)) {
+        return;
+    }
+    const delta = STRUCTURAL_DELTAS[ch];
+    const [key, amount] = delta;
+    state[key] += amount;
+};
+const isTopLevel = (state) => state.braceDepth === 0 &&
+    state.bracketDepth === 0 &&
+    state.parenDepth === 0 &&
+    state.quoteMode === null;
+const scanCharacter = (state, ch) => {
+    if (updateQuotedState(state, ch)) {
+        return;
+    }
+    const nextQuoteMode = enterQuote(ch);
+    if (nextQuoteMode !== null) {
+        state.quoteMode = nextQuoteMode;
+        return;
+    }
+    updateStructuralDepth(state, ch);
+};
+const isBalancedOpener = (ch) => ch === '{' || ch === '[' || ch === '(';
+const appendBalancedCharacter = (sourceText, state, index, text) => {
+    const ch = sourceText[index];
+    if (!ch) {
+        return text;
+    }
+    scanCharacter(state, ch);
+    return `${text}${ch}`;
+};
+export const captureBalanced = (sourceText, startIndex) => {
+    if (!isBalancedOpener(sourceText[startIndex])) {
+        return null;
+    }
+    const state = createState();
+    let text = '';
+    for (let index = startIndex; index < sourceText.length; index += 1) {
+        text = appendBalancedCharacter(sourceText, state, index, text);
+        if (index > startIndex && isTopLevel(state)) {
+            return { end: index, text };
+        }
+    }
+    return null;
+};
+export const lineNumberAt = (sourceText, startIndex) => sourceText.slice(0, startIndex).split('\n').length;
+const createSplitEntry = (sourceText, startIndex, endIndex) => {
+    const raw = sourceText.slice(startIndex, endIndex);
+    const firstContent = raw.search(/\S/);
+    if (firstContent === -1) {
+        return null;
+    }
+    const trailingWhitespace = raw.match(/\s*$/)?.[0].length ?? 0;
+    const trimmedEnd = raw.length - trailingWhitespace;
+    return {
+        start: startIndex + firstContent,
+        text: raw.slice(firstContent, trimmedEnd),
+    };
+};
+const pushSplitEntry = (entries, sourceText, startIndex, endIndex) => {
+    const entry = createSplitEntry(sourceText, startIndex, endIndex);
+    if (entry !== null) {
+        entries.push(entry);
+    }
+};
+const processSplitCharacter = (entries, sourceText, state, entryStart, index) => {
+    const ch = sourceText[index];
+    if (!ch) {
+        return entryStart;
+    }
+    if (ch === ',' && isTopLevel(state)) {
+        pushSplitEntry(entries, sourceText, entryStart, index);
+        return index + 1;
+    }
+    scanCharacter(state, ch);
+    return entryStart;
+};
+export const splitTopLevelEntriesWithOffsets = (sourceText) => {
+    const entries = [];
+    const state = createState();
+    let entryStart = 0;
+    for (let index = 0; index < sourceText.length; index += 1) {
+        entryStart = processSplitCharacter(entries, sourceText, state, entryStart, index);
+    }
+    pushSplitEntry(entries, sourceText, entryStart, sourceText.length);
+    return entries;
+};
+//# sourceMappingURL=structure.js.map

package/dist/rules/structure.js.map

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

package/dist/rules/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Severity level for warden diagnostics.
+ */
+export type WardenSeverity = 'error' | 'warn';
+/**
+ * A single diagnostic reported by a warden rule.
+ */
+export interface WardenDiagnostic {
+    /** Rule identifier, e.g. "no-throw-in-implementation" */
+    readonly rule: string;
+    /** Severity level */
+    readonly severity: WardenSeverity;
+    /** Human-readable message describing the violation */
+    readonly message: string;
+    /** 1-based line number where the violation was detected */
+    readonly line: number;
+    /** File path that was analyzed */
+    readonly filePath: string;
+}
+/**
+ * A warden rule is a function that analyzes source code and returns diagnostics.
+ *
+ * Rules use string/regex analysis (not full AST parsing) to detect patterns
+ * that violate Trails conventions.
+ */
+export interface WardenRule {
+    /** Unique rule identifier */
+    readonly name: string;
+    /** Default severity */
+    readonly severity: WardenSeverity;
+    /** Human-readable description of what the rule enforces */
+    readonly description: string;
+    /** Run the rule against source code and return any diagnostics */
+    readonly check: (sourceCode: string, filePath: string) => readonly WardenDiagnostic[];
+}
+/**
+ * Options for cross-file rules that need knowledge of all trail IDs in a project.
+ */
+export interface ProjectContext {
+    /** All known trail IDs in the project */
+    readonly knownTrailIds: ReadonlySet<string>;
+    /** All trail IDs referenced as detour targets across the project */
+    readonly detourTargetTrailIds?: ReadonlySet<string>;
+}
+/**
+ * A project-aware rule that requires knowledge of all trail IDs.
+ */
+export interface ProjectAwareWardenRule extends WardenRule {
+    /** Run the rule with project-level context */
+    readonly checkWithContext: (sourceCode: string, filePath: string, context: ProjectContext) => readonly WardenDiagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rules/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,KACb,SAAS,gBAAgB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,oEAAoE;IACpE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,KACpB,SAAS,gBAAgB,EAAE,CAAC;CAClC"}

package/dist/rules/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rules/types.ts"],"names":[],"mappings":""}

package/dist/rules/valid-describe-refs.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectAwareWardenRule } from './types.js';
+/**
+ * Warns when @see references inside Zod .describe() strings point at unknown
+ * trails.
+ */
+export declare const validDescribeRefs: ProjectAwareWardenRule;
+//# sourceMappingURL=valid-describe-refs.d.ts.map

package/dist/rules/valid-describe-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valid-describe-refs.d.ts","sourceRoot":"","sources":["../../src/rules/valid-describe-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAsEpB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,sBAe/B,CAAC"}

package/dist/rules/valid-describe-refs.js

@@ -0,0 +1,51 @@
+import { isTestFile } from './scan.js';
+import { collectTrailIds, parseStringLiteral } from './specs.js';
+import { captureBalanced, lineNumberAt } from './structure.js';
+const DESCRIBE_PATTERN = /\.describe\s*\(/g;
+const SEE_PATTERN = /@see\s+([A-Za-z0-9_.-]+)/g;
+const describeTextAt = (sourceCode, matchIndex) => {
+    const openParen = sourceCode.indexOf('(', matchIndex);
+    if (openParen === -1) {
+        return null;
+    }
+    return captureBalanced(sourceCode, openParen)?.text.slice(1, -1) ?? null;
+};
+const refsInDescription = (description, line) => [...description.matchAll(SEE_PATTERN)].flatMap((see) => see[1] ? [{ line, ref: see[1] }] : []);
+const refsForDescribe = (sourceCode, matchIndex) => {
+    const args = describeTextAt(sourceCode, matchIndex);
+    const description = args ? parseStringLiteral(args) : null;
+    return description === null
+        ? []
+        : refsInDescription(description, lineNumberAt(sourceCode, matchIndex));
+};
+const collectDescribeRefs = (sourceCode) => [...sourceCode.matchAll(DESCRIBE_PATTERN)].flatMap((match) => match.index === undefined ? [] : refsForDescribe(sourceCode, match.index));
+const checkDescribeRefs = (sourceCode, filePath, knownTrailIds) => {
+    if (isTestFile(filePath)) {
+        return [];
+    }
+    return collectDescribeRefs(sourceCode)
+        .filter(({ ref }) => !knownTrailIds.has(ref))
+        .map(({ line, ref }) => ({
+        filePath,
+        line,
+        message: `@see reference "${ref}" does not resolve to a defined trail.`,
+        rule: 'valid-describe-refs',
+        severity: 'warn',
+    }));
+};
+/**
+ * Warns when @see references inside Zod .describe() strings point at unknown
+ * trails.
+ */
+export const validDescribeRefs = {
+    check(sourceCode, filePath) {
+        return checkDescribeRefs(sourceCode, filePath, collectTrailIds(sourceCode));
+    },
+    checkWithContext(sourceCode, filePath, context) {
+        return checkDescribeRefs(sourceCode, filePath, context.knownTrailIds);
+    },
+    description: 'Ensure @see tags inside schema .describe() strings reference defined trails.',
+    name: 'valid-describe-refs',
+    severity: 'warn',
+};
+//# sourceMappingURL=valid-describe-refs.js.map

package/dist/rules/valid-describe-refs.js.map

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

package/dist/rules/valid-detour-refs.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectAwareWardenRule } from './types.js';
+/**
+ * Checks that all trail IDs referenced in `detours` declarations exist.
+ */
+export declare const validDetourRefs: ProjectAwareWardenRule;
+//# sourceMappingURL=valid-detour-refs.d.ts.map

package/dist/rules/valid-detour-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valid-detour-refs.d.ts","sourceRoot":"","sources":["../../src/rules/valid-detour-refs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,YAAY,CAAC;AAoKpB;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,sBAc7B,CAAC"}