/**
 * Lint a single source string for the Phase-1 stx footguns.
 *
 * @example
 * ```ts
 * const diagnostics = lintStxStrict(source, { filePath: 'resources/views/login.stx' })
 * for (const d of diagnostics)
 *   console.error(`${d.line}:${d.column} ${d.ruleId} — ${d.message}`)
 * ```
 */
export declare function lintStxStrict(source: string, options?: StxStrictOptions): StxStrictDiagnostic[];
export declare interface StxStrictDiagnostic {
  ruleId: StxStrictRuleId
  message: string
  line: number
  column: number
  severity: 'error' | 'warning'
}
export declare interface StxStrictOptions {
  filePath?: string
  fileKind?: 'view' | 'component'
  rules?: Partial<Record<StxStrictRuleId, boolean>>
}
/**
 * stx-strict — the documented-footgun linter (stacksjs/stx#1744, Phase 1).
 *
 * A self-contained detection engine: feed it `.stx` (or store `.ts`) source
 * and it returns diagnostics for the patterns that "look correct but do
 * nothing / do the wrong thing" at runtime. It deliberately has NO imports
 * from the rest of the package (no template pipeline, no i18n) so it's cheap
 * to run and trivially unit-testable; wiring it into pickier / the CLI / the
 * editor is a thin follow-up (Phase 1 ships the hard part — correct detection
 * with low false-positive rate).
 *
 * Phase 1 covers the five highest-hit footguns from the issue:
 *   1. stx/no-bare-function-ref-in-event       `@click="toggleLike"` (no parens)
 *   2. stx/no-view-level-script-client         `<script client>` in a view file
 *   3. stx/store-value-imports-must-be-local   value import escaping resources/stores/
 *   4. stx/no-signal-call-in-for-iteration-var calling the `:for` loop var like a signal
 *   5. stx/no-backticks-in-html-comments       a backtick inside an HTML comment
 *
 * Remaining footguns (web-components, template tags, @include loop-var
 * forwarding, etc.) are Phase 2.
 */
export type StxStrictRuleId = | 'stx/no-bare-function-ref-in-event'
  | 'stx/no-view-level-script-client'
  | 'stx/store-value-imports-must-be-local'
  | 'stx/no-signal-call-in-for-iteration-var'
  | 'stx/no-backticks-in-html-comments';
