@ontrails/warden 1.0.0-beta.14 → 1.0.0-beta.16

package/dist/drift.js

@@ -1,61 +0,0 @@
-/**
- * Topo lock drift detection.
- *
- * Compares the committed `trails.lock` hash against a freshly generated
- * trailhead map hash to detect when the trail topology has changed without
- * updating the lock file. The committed lock may be structured JSON or the
- * legacy single-line hash format.
- */
-import { existsSync, statSync } from 'node:fs';
-import { createTopoStore, NotFoundError, ValidationError, } from '@ontrails/core';
-import { resolveTrailsDir } from '@ontrails/core/internal/trails-db';
-import { generateTrailheadMap, hashTrailheadMap, readTrailheadLockData, } from '@ontrails/schema';
-/**
- * Check whether the committed trails.lock is stale compared to the current topology.
- *
- * When no topo is provided, returns a clean result (no drift detectable without runtime info).
- */
-export const checkDrift = async (rootDir, topo) => {
-    try {
-        const trailsDir = resolveTrailsDir({ rootDir });
-        const committedLock = existsSync(rootDir) && statSync(rootDir).isDirectory()
-            ? await readTrailheadLockData({ dir: trailsDir })
-            : null;
-        // Prefer the stored hash (computed by the export pipeline) to avoid
-        // divergence between the schema and store hash pipelines.
-        const storedHash = (() => {
-            try {
-                return createTopoStore({ rootDir }).exports.get()?.trailheadHash;
-            }
-            catch (error) {
-                if (error instanceof NotFoundError) {
-                    return;
-                }
-                throw error;
-            }
-        })();
-        const currentHash = storedHash ??
-            (topo === undefined
-                ? 'unknown'
-                : hashTrailheadMap(generateTrailheadMap(topo)));
-        return {
-            committedHash: committedLock?.hash ?? null,
-            currentHash,
-            stale: committedLock !== null &&
-                currentHash !== 'unknown' &&
-                committedLock.hash !== currentHash,
-        };
-    }
-    catch (error) {
-        if (!(error instanceof ValidationError)) {
-            throw error;
-        }
-        return {
-            blockedReason: error.message,
-            committedHash: null,
-            currentHash: 'blocked',
-            stale: true,
-        };
-    }
-};
-//# sourceMappingURL=drift.js.map

package/dist/drift.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"drift.js","sourceRoot":"","sources":["../src/drift.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAgB1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,OAAe,EACf,IAAuB,EACD,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,MAAM,aAAa,GACjB,UAAU,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;YACpD,CAAC,CAAC,MAAM,qBAAqB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;YACjD,CAAC,CAAC,IAAI,CAAC;QACX,oEAAoE;QACpE,0DAA0D;QAC1D,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE;YACvB,IAAI,CAAC;gBACH,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC;YACnE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;oBACnC,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,WAAW,GACf,UAAU;YACV,CAAC,IAAI,KAAK,SAAS;gBACjB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpD,OAAO;YACL,aAAa,EAAE,aAAa,EAAE,IAAI,IAAI,IAAI;YAC1C,WAAW;YACX,KAAK,EACH,aAAa,KAAK,IAAI;gBACtB,WAAW,KAAK,SAAS;gBACzB,aAAa,CAAC,IAAI,KAAK,WAAW;SACrC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,eAAe,CAAC,EAAE,CAAC;YACxC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO;YACL,aAAa,EAAE,KAAK,CAAC,OAAO;YAC5B,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,SAAS;YACtB,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/formatters.d.ts

@@ -1,30 +0,0 @@
-/**
- * CI-oriented formatters for warden reports.
- *
- * Each formatter takes a `WardenReport` and produces output suited to a
- * specific CI environment: GitHub Actions annotations, structured JSON,
- * or a concise markdown summary.
- */
-import type { WardenReport } from './cli.js';
-/**
- * Produce GitHub Actions workflow command annotations, one per diagnostic.
- *
- * Severity mapping: `error` to `::error`, `warn` to `::warning`.
- * Drift staleness or established-export blocking is emitted as a single
- * `::error` annotation when detected.
- */
-export declare const formatGitHubAnnotations: (report: WardenReport) => string;
-/**
- * Produce a structured JSON string from the report.
- *
- * Includes a `summary` object with error, warning, and suggestion counts
- * for easy consumption by downstream tooling.
- */
-export declare const formatJson: (report: WardenReport) => string;
-/**
- * Produce a concise markdown summary suitable for a GitHub job summary or PR comment.
- *
- * Groups diagnostics by severity and includes drift status when relevant.
- */
-export declare const formatSummary: (report: WardenReport) => string;
-//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAS7C;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,YAAY,KAAG,MAmB9D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,YAAY,KAAG,MAiBjD,CAAC;AAqCF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,YAAY,KAAG,MAapD,CAAC"}

package/dist/formatters.js

@@ -1,98 +0,0 @@
-/**
- * CI-oriented formatters for warden reports.
- *
- * Each formatter takes a `WardenReport` and produces output suited to a
- * specific CI environment: GitHub Actions annotations, structured JSON,
- * or a concise markdown summary.
- */
-/** Map warden severity to GitHub Actions annotation level. */
-const ghLevel = {
-    error: 'error',
-    warn: 'warning',
-};
-/**
- * Produce GitHub Actions workflow command annotations, one per diagnostic.
- *
- * Severity mapping: `error` to `::error`, `warn` to `::warning`.
- * Drift staleness or established-export blocking is emitted as a single
- * `::error` annotation when detected.
- */
-export const formatGitHubAnnotations = (report) => {
-    const lines = [];
-    for (const d of report.diagnostics) {
-        const level = ghLevel[d.severity];
-        lines.push(`::${level} file=${d.filePath},line=${String(d.line)}::${d.rule}: ${d.message}`);
-    }
-    if (report.drift?.blockedReason !== undefined) {
-        lines.push(`::error::drift: ${report.drift.blockedReason}`);
-    }
-    else if (report.drift?.stale) {
-        lines.push('::error::drift: trails.lock is stale (regenerate with `trails topo export`)');
-    }
-    return lines.join('\n');
-};
-/**
- * Produce a structured JSON string from the report.
- *
- * Includes a `summary` object with error, warning, and suggestion counts
- * for easy consumption by downstream tooling.
- */
-export const formatJson = (report) => {
-    const summary = {
-        errors: report.errorCount,
-        suggestions: 0,
-        warnings: report.warnCount,
-    };
-    return JSON.stringify({
-        diagnostics: report.diagnostics,
-        drift: report.drift,
-        passed: report.passed,
-        summary,
-    }, null, 2);
-};
-/** Format a diagnostic as a markdown list item. */
-const diagnosticLine = (d) => `- \`${d.filePath}:${String(d.line)}\` — ${d.rule}: ${d.message}`;
-/** Render a severity group as a headed markdown section, or empty array. */
-const severitySection = (heading, diagnostics) => {
-    if (diagnostics.length === 0) {
-        return [];
-    }
-    return ['', `### ${heading}`, ...diagnostics.map(diagnosticLine)];
-};
-/** Render a drift section if stale, otherwise empty array. */
-const driftSection = (drift) => {
-    if (drift?.blockedReason !== undefined) {
-        return [
-            '',
-            '### Drift',
-            `- established exports are blocked: ${drift.blockedReason}`,
-        ];
-    }
-    if (!drift?.stale) {
-        return [];
-    }
-    return [
-        '',
-        '### Drift',
-        '- trails.lock is stale (regenerate with `trails topo export`)',
-    ];
-};
-/**
- * Produce a concise markdown summary suitable for a GitHub job summary or PR comment.
- *
- * Groups diagnostics by severity and includes drift status when relevant.
- */
-export const formatSummary = (report) => {
-    const result = report.passed ? 'PASS' : 'FAIL';
-    const errors = report.diagnostics.filter((d) => d.severity === 'error');
-    const warnings = report.diagnostics.filter((d) => d.severity === 'warn');
-    return [
-        '## Warden Report',
-        '',
-        `**Result: ${result}** | ${String(report.errorCount)} errors, ${String(report.warnCount)} warnings`,
-        ...severitySection('Errors', errors),
-        ...severitySection('Warnings', warnings),
-        ...driftSection(report.drift),
-    ].join('\n');
-};
-//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

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

package/dist/index.d.ts

@@ -1,37 +0,0 @@
-/**
- * Warden - Governance package for Trails.
- *
- * Provides lint rules, drift detection, and a CLI runner to enforce
- * contract-first discipline at development time.
- *
- * Package: `@ontrails/warden`
- */
-export type { ProjectAwareWardenRule, ProjectContext, WardenDiagnostic, WardenRule, WardenSeverity, } from './rules/index.js';
-export { noThrowInImplementation } from './rules/no-throw-in-implementation.js';
-export { contextNoTrailheadTypes } from './rules/context-no-trailhead-types.js';
-export { draftFileMarking } from './rules/draft-file-marking.js';
-export { draftVisibleDebt } from './rules/draft-visible-debt.js';
-export { validDetourRefs } from './rules/valid-detour-refs.js';
-export { noDirectImplInRoute } from './rules/no-direct-impl-in-route.js';
-export { noDirectImplementationCall } from './rules/no-direct-implementation-call.js';
-export { noSyncResultAssumption } from './rules/no-sync-result-assumption.js';
-export { implementationReturnsResult } from './rules/implementation-returns-result.js';
-export { noThrowInDetourTarget } from './rules/no-throw-in-detour-target.js';
-export { preferSchemaInference } from './rules/prefer-schema-inference.js';
-export { provisionDeclarations } from './rules/provision-declarations.js';
-export { provisionExists } from './rules/provision-exists.js';
-export { validDescribeRefs } from './rules/valid-describe-refs.js';
-export { wardenRules } from './rules/index.js';
-export type { WardenOptions, WardenReport } from './cli.js';
-export { formatWardenReport, runWarden } from './cli.js';
-export { formatGitHubAnnotations, formatJson, formatSummary, } from './formatters.js';
-export type { DriftResult } from './drift.js';
-export { checkDrift } from './drift.js';
-export { DRAFT_FILE_PREFIX, DRAFT_FILE_SEGMENT, isDraftMarkedFile, stripDraftFileMarkers, } from './draft.js';
-export { findStringLiterals, getStringValue, isStringLiteral, offsetToLine, parse, walk, } from './rules/ast.js';
-export type { AstNode, StringLiteralMatch } from './rules/ast.js';
-export { wardenTopo } from './trails/topo.js';
-export { runWardenTrails } from './trails/run.js';
-export { contextNoTrailheadTypesTrail, crossDeclarationsTrail, diagnosticSchema, implementationReturnsResultTrail, noDirectImplInRouteTrail, noDirectImplementationCallTrail, noSyncResultAssumptionTrail, noThrowInDetourTargetTrail, noThrowInImplementationTrail, preferSchemaInferenceTrail, ruleInput, ruleOutput, provisionDeclarationsTrail, provisionExistsTrail, validDescribeRefsTrail, validDetourRefsTrail, } from './trails/index.js';
-export type { RuleInput, RuleOutput } from './trails/index.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGzD,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,KAAK,EACL,IAAI,GACL,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,gBAAgB,EAChB,gCAAgC,EAChC,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,SAAS,EACT,UAAU,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,38 +0,0 @@
-/**
- * Warden - Governance package for Trails.
- *
- * Provides lint rules, drift detection, and a CLI runner to enforce
- * contract-first discipline at development time.
- *
- * Package: `@ontrails/warden`
- */
-// Individual rules
-export { noThrowInImplementation } from './rules/no-throw-in-implementation.js';
-export { contextNoTrailheadTypes } from './rules/context-no-trailhead-types.js';
-export { draftFileMarking } from './rules/draft-file-marking.js';
-export { draftVisibleDebt } from './rules/draft-visible-debt.js';
-export { validDetourRefs } from './rules/valid-detour-refs.js';
-export { noDirectImplInRoute } from './rules/no-direct-impl-in-route.js';
-export { noDirectImplementationCall } from './rules/no-direct-implementation-call.js';
-export { noSyncResultAssumption } from './rules/no-sync-result-assumption.js';
-export { implementationReturnsResult } from './rules/implementation-returns-result.js';
-export { noThrowInDetourTarget } from './rules/no-throw-in-detour-target.js';
-export { preferSchemaInference } from './rules/prefer-schema-inference.js';
-export { provisionDeclarations } from './rules/provision-declarations.js';
-export { provisionExists } from './rules/provision-exists.js';
-export { validDescribeRefs } from './rules/valid-describe-refs.js';
-// Rule registry
-export { wardenRules } from './rules/index.js';
-export { formatWardenReport, runWarden } from './cli.js';
-// CI formatters
-export { formatGitHubAnnotations, formatJson, formatSummary, } from './formatters.js';
-export { checkDrift } from './drift.js';
-// Draft helpers
-export { DRAFT_FILE_PREFIX, DRAFT_FILE_SEGMENT, isDraftMarkedFile, stripDraftFileMarkers, } from './draft.js';
-// AST helpers for repo-local tooling
-export { findStringLiterals, getStringValue, isStringLiteral, offsetToLine, parse, walk, } from './rules/ast.js';
-// Trail gate
-export { wardenTopo } from './trails/topo.js';
-export { runWardenTrails } from './trails/run.js';
-export { contextNoTrailheadTypesTrail, crossDeclarationsTrail, diagnosticSchema, implementationReturnsResultTrail, noDirectImplInRouteTrail, noDirectImplementationCallTrail, noSyncResultAssumptionTrail, noThrowInDetourTargetTrail, noThrowInImplementationTrail, preferSchemaInferenceTrail, ruleInput, ruleOutput, provisionDeclarationsTrail, provisionExistsTrail, validDescribeRefsTrail, validDetourRefsTrail, } from './trails/index.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,mBAAmB;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzD,gBAAgB;AAChB,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,gBAAgB;AAChB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,qCAAqC;AACrC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,KAAK,EACL,IAAI,GACL,MAAM,gBAAgB,CAAC;AAGxB,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,gBAAgB,EAChB,gCAAgC,EAChC,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,SAAS,EACT,UAAU,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/rules/ast.d.ts

@@ -1,82 +0,0 @@
-/**
- * Shared AST utilities for warden rules.
- *
- * Uses oxc-parser for native-speed TypeScript parsing. Provides a lightweight
- * walker and helpers for finding trail implementation bodies.
- */
-export interface AstNode {
-    readonly type: string;
-    readonly start: number;
-    readonly end: number;
-    readonly key?: {
-        readonly name?: string;
-    };
-    readonly value?: AstNode;
-    readonly body?: AstNode | readonly AstNode[];
-    readonly [key: string]: unknown;
-}
-/** Parse TypeScript source into an AST. Returns null on parse failure. */
-export declare const parse: (filePath: string, sourceCode: string) => AstNode | null;
-type WalkFn = (node: unknown, visit: (node: AstNode) => void) => void;
-/** Walk an AST node tree, calling `visit` on every node. */
-export declare const walk: WalkFn;
-/**
- * Walk an AST node tree without descending into nested function scopes.
- * The root node is always traversed; only inner function boundaries are skipped.
- * Useful for provision-access analysis where inner functions may shadow
- * the trail context parameter name.
- */
-export declare const walkScope: WalkFn;
-/** Find the byte offset's line number (1-based) in source code. */
-export declare const offsetToLine: (sourceCode: string, offset: number) => number;
-/** Get the name of an Identifier node, or null. */
-export declare const identifierName: (node: AstNode | undefined) => string | null;
-/** Check if a node is a string literal. */
-export declare const isStringLiteral: (node: AstNode | undefined) => node is AstNode;
-/** Extract the string value from a string literal node. */
-export declare const getStringValue: (node: AstNode) => string | null;
-/** Extract a string literal value, or null when the node is not a string. */
-export declare const extractStringLiteral: (node: AstNode | undefined) => string | null;
-export interface StringLiteralMatch {
-    readonly end: number;
-    readonly node: AstNode;
-    readonly start: number;
-    readonly value: string;
-}
-export declare const findStringLiterals: (ast: AstNode, predicate?: (value: string, node: AstNode) => boolean) => StringLiteralMatch[];
-/** Extract the first string argument from a CallExpression. */
-export declare const extractFirstStringArg: (node: AstNode) => string | null;
-/** Collect `const foo = provision('id', ...)` bindings from a parsed file. */
-export declare const collectNamedProvisionIds: (ast: AstNode) => ReadonlyMap<string, string>;
-/** Collect all inline `provision('id', ...)` definition IDs from a parsed file. */
-export declare const collectProvisionDefinitionIds: (ast: AstNode) => ReadonlySet<string>;
-/** Backward-compatible aliases while the migration is in flight. */
-export declare const collectNamedServiceIds: (ast: AstNode) => ReadonlyMap<string, string>;
-/** Backward-compatible aliases while the migration is in flight. */
-export declare const collectServiceDefinitionIds: (ast: AstNode) => ReadonlySet<string>;
-/** Find a Property node by key name inside an ObjectExpression config. */
-export declare const findConfigProperty: (config: AstNode, propertyName: string) => AstNode | null;
-export interface TrailDefinition {
-    /** Trail ID string, e.g. "entity.show" */
-    readonly id: string;
-    /** "trail" or "signal" */
-    readonly kind: string;
-    /** The config object argument (second arg to trail() call) */
-    readonly config: AstNode;
-    /** Start offset of the call expression */
-    readonly start: number;
-}
-export declare const findTrailDefinitions: (ast: AstNode) => TrailDefinition[];
-/**
- * Find `blaze:` property values.
- *
- * When given an ObjectExpression (trail config), returns only its direct `blaze:`
- * properties. When given a full AST, finds trail definitions first and extracts
- * `blaze:` from each config — in both cases ignoring nested `blaze:` properties
- * (e.g. `meta: { blaze: ... }`).
- */
-export declare const findBlazeBodies: (node: AstNode) => AstNode[];
-/** Check if a node is a call to `.blaze()` on some object. */
-export declare const isBlazeCall: (node: AstNode) => boolean;
-export {};
-//# sourceMappingURL=ast.d.ts.map

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

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