@tamagui/language-service 3.0.0-beta.924.1 → 3.0.0

package/src/core.ts

@@ -2,7 +2,7 @@
 //
 // Browser-safe by contract: no node imports, no typescript imports. Everything
 // here works from the serialized config JSON the Tamagui compiler emits
-// (`.tamagui/tamagui.config.json`), so the same engine powers the tsserver
+// (`.tamagui/tamagui.config.json`), so the same engine powers the language server
 // plugin, the VS Code extension, the CLI checker, and in-browser IDEs.
 //
 // The @tamagui/style-grammar engine owns candidate meaning; this module adds
@@ -148,7 +148,11 @@ export interface StyleTooling {
     cursor: number
   ): StyleValueCursorCompletions | null
   /** the complete static verdict for one authored value */
-  diagnostics(property: string, value: string): readonly StyleValueDiagnostic[]
+  diagnostics(
+    property: string,
+    value: string,
+    options?: { strictPayloads?: boolean }
+  ): readonly StyleValueDiagnostic[]
   /** classified spans: modifiers, tokens, keywords, literals */
   annotations(property: string, value: string): readonly StyleValueAnnotation[]
   /** hover content for the annotation under `offset`, or null */
@@ -161,7 +165,14 @@ export interface StyleTooling {
   previewThemes: readonly string[]
 }
 
-export function createStyleTooling(file: SerializedConfigFile): StyleTooling | null {
+export interface StyleToolingOptions {
+  strictPayloads?: boolean
+}
+
+export function createStyleTooling(
+  file: SerializedConfigFile,
+  toolingOptions?: StyleToolingOptions
+): StyleTooling | null {
   const serialized = file.tamaguiConfig
   if (!serialized) return null
 
@@ -171,7 +182,12 @@ export function createStyleTooling(file: SerializedConfigFile): StyleTooling | n
   )
   const registry = createModifierRegistry(config).registry
   const candidates = createCandidatePropertyVocabulary(config)
-  const engine: DiagnoseStyleValueOptions = { config, registry, candidates }
+  const engine: DiagnoseStyleValueOptions = {
+    config,
+    registry,
+    candidates,
+    strictPayloads: toolingOptions?.strictPayloads,
+  }
   const styleProps = createStylePropSet(config)
 
   // themes and tokens keep their VALUES here; the grammar view keeps names only
@@ -252,9 +268,12 @@ export function createStyleTooling(file: SerializedConfigFile): StyleTooling | n
       return completeStyleValueAtCursor(property, value, cursor, engine)
     },
 
-    diagnostics(property, value) {
+    diagnostics(property, value, diagnosticOptions) {
       if (!styleProps.has(property)) return []
-      return diagnoseStyleValueProgram(property, value, engine)
+      return diagnoseStyleValueProgram(property, value, {
+        ...engine,
+        strictPayloads: diagnosticOptions?.strictPayloads ?? engine.strictPayloads,
+      })
     },
 
     annotations,

package/src/document.ts

@@ -51,6 +51,14 @@ export interface DocumentCompletions extends StyleValueCursorCompletions {
   site: StyleSite
 }
 
+export interface DocumentDiagnosticOptions {
+  strictPayloads?: boolean
+}
+
+export interface DocumentStyleToolingOptions {
+  strictPayloads?: boolean
+}
+
 export interface DocumentStyleTooling {
   sites(source: string, fileName?: string): readonly StyleSite[]
   /** completions at a file offset, spans mapped to file offsets */
@@ -60,7 +68,11 @@ export interface DocumentStyleTooling {
     fileName?: string
   ): DocumentCompletions | null
   /** every diagnostic in the file, spans mapped to file offsets */
-  diagnostics(source: string, fileName?: string): readonly DocumentDiagnostic[]
+  diagnostics(
+    source: string,
+    fileName?: string,
+    options?: DocumentDiagnosticOptions
+  ): readonly DocumentDiagnostic[]
   /** hover at a file offset, span mapped to file offsets */
   hoverAt(source: string, offset: number, fileName?: string): DocumentHover | null
   /** every color swatch in the file, spans mapped to file offsets */
@@ -69,7 +81,8 @@ export interface DocumentStyleTooling {
 
 export function createDocumentStyleTooling(
   tooling: StyleTooling,
-  extract: ExtractStyleSites
+  extract: ExtractStyleSites,
+  toolingOptions?: DocumentStyleToolingOptions
 ): DocumentStyleTooling {
   const siteAt = (sites: readonly StyleSite[], offset: number): StyleSite | undefined =>
     sites.find((site) => offset >= site.start && offset <= site.end)
@@ -93,10 +106,14 @@ export function createDocumentStyleTooling(
       }
     },
 
-    diagnostics(source, fileName) {
+    diagnostics(source, fileName, diagnosticOptions) {
       const results: DocumentDiagnostic[] = []
+      const strictPayloads =
+        diagnosticOptions?.strictPayloads ?? toolingOptions?.strictPayloads
       for (const site of extract(source, fileName)) {
-        for (const diagnostic of tooling.diagnostics(site.property, site.value)) {
+        for (const diagnostic of tooling.diagnostics(site.property, site.value, {
+          strictPayloads,
+        })) {
           results.push({
             ...diagnostic,
             index: site.start + diagnostic.index,

package/src/index.ts

@@ -1,452 +1,4 @@
-import { isAbsolute, resolve } from 'node:path'
-
-import type ts from 'typescript'
-import {
-  completionSortText,
-  createStyleTooling,
-  type SerializedConfigFile,
-  type StyleTooling,
-} from './core'
-import { resolveTamaguiHost } from './host'
-
-const completionSource = '@tamagui/language-service'
-const diagnosticCode = 78711
-const defaultConfigPath = '.tamagui/tamagui.config.json'
-const flatStyledModules: ReadonlySet<string> = new Set([
-  'tamagui',
-  'tamagui/unstyled',
-  '@tamagui/core',
-  '@tamagui/ui',
-  '@tamagui/web',
-])
-
-export interface TamaguiLanguageServicePluginConfig {
-  /** Path to the config JSON emitted by the Tamagui compiler. */
-  configPath?: string
-}
-
-type ImportedBindings = {
-  styled: ReadonlySet<string>
-}
-
-type LiteralSite = {
-  property: string
-  /** cooked value, identical to its authored source text */
-  value: string
-  /** file offset of the value's first character */
-  contentStart: number
-  literal: ts.StringLiteralLike
-}
-
-function loadTooling(
-  info: ts.server.PluginCreateInfo,
-  configPath: string
-): StyleTooling | null {
-  const contents = info.serverHost.readFile(configPath)
-  if (contents === undefined) return null
-  try {
-    return createStyleTooling(JSON.parse(contents) as SerializedConfigFile)
-  } catch {
-    return null
-  }
-}
-
-function findStringLiteralAtPosition(
-  typescript: typeof ts,
-  sourceFile: ts.SourceFile,
-  position: number
-): ts.StringLiteralLike | null {
-  let found: ts.StringLiteralLike | null = null
-  const visit = (node: ts.Node): void => {
-    if (position < node.getFullStart() || position > node.getEnd()) return
-    if (
-      typescript.isStringLiteralLike(node) &&
-      position >= node.getStart(sourceFile) + 1 &&
-      position <= node.getEnd() - 1
-    ) {
-      found = node
-      return
-    }
-    typescript.forEachChild(node, visit)
-  }
-  visit(sourceFile)
-  return found
-}
-
-function importedBindings(
-  typescript: typeof ts,
-  sourceFile: ts.SourceFile
-): ImportedBindings {
-  const styled = new Set<string>()
-
-  for (const statement of sourceFile.statements) {
-    if (
-      !typescript.isImportDeclaration(statement) ||
-      !typescript.isStringLiteral(statement.moduleSpecifier)
-    ) {
-      continue
-    }
-    const source = statement.moduleSpecifier.text
-    if (!flatStyledModules.has(source)) continue
-    const bindings = statement.importClause?.namedBindings
-    if (!bindings) continue
-    if (typescript.isNamespaceImport(bindings)) continue
-    for (const element of bindings.elements) {
-      const imported = element.propertyName?.text || element.name.text
-      if (imported === 'styled') styled.add(element.name.text)
-    }
-  }
-
-  return { styled }
-}
-
-function propertyName(typescript: typeof ts, name: ts.PropertyName): string | null {
-  if (typescript.isIdentifier(name) || typescript.isStringLiteral(name)) {
-    return name.text
-  }
-  return null
-}
-
-function completionProperty(
-  typescript: typeof ts,
-  literal: ts.StringLiteralLike,
-  tooling: StyleTooling,
-  checker: ts.TypeChecker,
-  bindings: ImportedBindings
-): { property: string } | null {
-  let parent = literal.parent
-
-  if (typescript.isJsxExpression(parent)) parent = parent.parent
-  if (typescript.isJsxAttribute(parent)) {
-    if (!typescript.isIdentifier(parent.name)) return null
-    const property = parent.name.text
-    if (!tooling.styleProps.has(property)) return null
-    const opening = parent.parent.parent
-    if (!typescript.isJsxOpeningLikeElement(opening)) return null
-    const host = resolveTamaguiHost(checker, opening.tagName)
-    if (!host?.accepts(property)) return null
-    return { property }
-  }
-
-  if (!typescript.isPropertyAssignment(parent)) return null
-  const property = propertyName(typescript, parent.name)
-  if (!property || !tooling.styleProps.has(property)) return null
-
-  let current: ts.Node = parent
-  while (current.parent && !typescript.isCallExpression(current.parent)) {
-    current = current.parent
-  }
-  if (!current.parent || !typescript.isCallExpression(current.parent)) return null
-  const call = current.parent
-  if (
-    call.arguments[1] !== current ||
-    !typescript.isIdentifier(call.expression) ||
-    !bindings.styled.has(call.expression.text)
-  ) {
-    return null
-  }
-  const component = call.arguments[0]
-  const host = component && resolveTamaguiHost(checker, component)
-  if (!host?.accepts(property)) return null
-  return { property }
-}
-
-/**
- * The literal as a style value site, or null when it is not one: wrong parent
- * shape, not a style prop, not a tamagui host, or authored with escapes that
- * cook differently than they read (TypeScript exposes cooked values but no
- * cooked-to-source offset map, so exact-raw literals only).
- */
-function siteForLiteral(
-  typescript: typeof ts,
-  sourceFile: ts.SourceFile,
-  literal: ts.StringLiteralLike,
-  tooling: StyleTooling,
-  checker: ts.TypeChecker,
-  bindings: ImportedBindings
-): LiteralSite | null {
-  const site = completionProperty(typescript, literal, tooling, checker, bindings)
-  if (!site) return null
-  const contentStart = literal.getStart(sourceFile) + 1
-  const contentEnd = literal.getEnd() - 1
-  const sourceInput = sourceFile.text.slice(contentStart, contentEnd)
-  if (literal.text !== sourceInput) return null
-  return { property: site.property, value: literal.text, contentStart, literal }
-}
-
-function collectLiteralSites(
-  typescript: typeof ts,
-  sourceFile: ts.SourceFile,
-  tooling: StyleTooling,
-  checker: ts.TypeChecker,
-  bindings: ImportedBindings
-): LiteralSite[] {
-  const sites: LiteralSite[] = []
-  const visit = (node: ts.Node): void => {
-    if (typescript.isStringLiteralLike(node)) {
-      const site = siteForLiteral(
-        typescript,
-        sourceFile,
-        node,
-        tooling,
-        checker,
-        bindings
-      )
-      if (site) sites.push(site)
-      return
-    }
-    typescript.forEachChild(node, visit)
-  }
-  visit(sourceFile)
-  return sites
-}
-
-function copyLanguageService(service: ts.LanguageService): ts.LanguageService {
-  const proxy = Object.create(null) as ts.LanguageService
-  for (const key of Object.keys(service) as Array<keyof ts.LanguageService>) {
-    const value = service[key]
-    ;(proxy as unknown as Record<string, unknown>)[key] =
-      typeof value === 'function' ? value.bind(service) : value
-  }
-  return proxy
-}
-
-const init: ts.server.PluginModuleFactory = ({ typescript }) => ({
-  create(info) {
-    const pluginConfig = info.config as TamaguiLanguageServicePluginConfig | undefined
-    const configuredPath = pluginConfig?.configPath || defaultConfigPath
-    const configPath = isAbsolute(configuredPath)
-      ? configuredPath
-      : resolve(info.project.getCurrentDirectory(), configuredPath)
-    let tooling = loadTooling(info, configPath)
-    const watcher = info.serverHost.watchFile(configPath, () => {
-      tooling = loadTooling(info, configPath)
-    })
-
-    const proxy = copyLanguageService(info.languageService)
-    const baseCompletions = info.languageService.getCompletionsAtPosition.bind(
-      info.languageService
-    )
-    const baseDetails = info.languageService.getCompletionEntryDetails.bind(
-      info.languageService
-    )
-    const baseSemanticDiagnostics = info.languageService.getSemanticDiagnostics.bind(
-      info.languageService
-    )
-    const baseQuickInfo = info.languageService.getQuickInfoAtPosition.bind(
-      info.languageService
-    )
-    const baseDispose = info.languageService.dispose.bind(info.languageService)
-    const bindingsBySourceFile = new WeakMap<ts.SourceFile, ImportedBindings>()
-
-    const fileContext = (
-      fileName: string
-    ): {
-      sourceFile: ts.SourceFile
-      checker: ts.TypeChecker
-      bindings: ImportedBindings
-    } | null => {
-      const program = info.languageService.getProgram()
-      const sourceFile = program?.getSourceFile(fileName)
-      if (!program || !sourceFile) return null
-      let bindings = bindingsBySourceFile.get(sourceFile)
-      if (!bindings) {
-        bindings = importedBindings(typescript, sourceFile)
-        bindingsBySourceFile.set(sourceFile, bindings)
-      }
-      return { sourceFile, checker: program.getTypeChecker(), bindings }
-    }
-
-    proxy.getCompletionsAtPosition = (
-      fileName,
-      position,
-      options,
-      formattingSettings
-    ) => {
-      const getBaseCompletions = () =>
-        baseCompletions(fileName, position, options, formattingSettings)
-      if (!tooling) return getBaseCompletions()
-      const context = fileContext(fileName)
-      if (!context) return getBaseCompletions()
-      const { sourceFile, checker, bindings } = context
-      const literal = findStringLiteralAtPosition(typescript, sourceFile, position)
-      if (!literal) return getBaseCompletions()
-      const site = siteForLiteral(
-        typescript,
-        sourceFile,
-        literal,
-        tooling,
-        checker,
-        bindings
-      )
-      if (!site) return getBaseCompletions()
-
-      const cursorCompletions = tooling.completions(
-        site.property,
-        site.value,
-        position - site.contentStart
-      )
-      if (!cursorCompletions) return getBaseCompletions()
-      const replacementSpan = {
-        start: site.contentStart + cursorCompletions.replaceStart,
-        length: cursorCompletions.replaceLength,
-      }
-      const entries: ts.CompletionEntry[] = []
-      let contextualType: ts.Type | undefined
-      for (const completion of cursorCompletions.completions) {
-        const insertText = completion.insertText || completion.value
-        const modifierKind =
-          completion.kind === 'modifier'
-            ? tooling.modifierKind(completion.value)
-            : undefined
-        if (completion.kind === 'keyword') {
-          contextualType ||= checker.getContextualType(literal)
-          if (
-            !contextualType ||
-            !checker.isTypeAssignableTo(
-              checker.getStringLiteralType(insertText),
-              contextualType
-            )
-          ) {
-            continue
-          }
-        }
-        entries.push({
-          name: completion.value,
-          kind: typescript.ScriptElementKind.string,
-          kindModifiers: '',
-          sortText: completionSortText(completion, modifierKind),
-          insertText,
-          replacementSpan,
-          source: completionSource,
-          labelDetails: {
-            description: modifierKind
-              ? `Tamagui ${modifierKind} modifier`
-              : completion.kind === 'configured'
-                ? 'Tamagui configured value'
-                : 'Tamagui style keyword',
-          },
-        })
-      }
-      if (entries.length === 0) return getBaseCompletions()
-      return {
-        isGlobalCompletion: false,
-        isMemberCompletion: false,
-        isNewIdentifierLocation: true,
-        // A completion requested immediately after whitespace has an empty
-        // replacement span. Ask the editor to request again as the modifier
-        // prefix grows instead of dismissing suggestions when the cursor
-        // moves beyond that initial span.
-        isIncomplete: true,
-        entries,
-      }
-    }
-
-    proxy.getCompletionEntryDetails = (
-      fileName,
-      position,
-      entryName,
-      formatOptions,
-      source,
-      preferences,
-      data
-    ) => {
-      if (source === completionSource) {
-        return {
-          name: entryName,
-          kind: typescript.ScriptElementKind.string,
-          kindModifiers: '',
-          displayParts: [
-            {
-              text: entryName,
-              kind: 'stringLiteral',
-            },
-          ],
-          documentation: [
-            {
-              text: 'Resolved from the active Tamagui config.',
-              kind: 'text',
-            },
-          ],
-          tags: [],
-        }
-      }
-      return baseDetails(
-        fileName,
-        position,
-        entryName,
-        formatOptions,
-        source,
-        preferences,
-        data
-      )
-    }
-
-    proxy.getSemanticDiagnostics = (fileName) => {
-      const diagnostics = [...baseSemanticDiagnostics(fileName)]
-      if (!tooling) return diagnostics
-      const context = fileContext(fileName)
-      if (!context) return diagnostics
-      const { sourceFile, checker, bindings } = context
-      for (const site of collectLiteralSites(
-        typescript,
-        sourceFile,
-        tooling,
-        checker,
-        bindings
-      )) {
-        for (const diagnostic of tooling.diagnostics(site.property, site.value)) {
-          diagnostics.push({
-            file: sourceFile,
-            start: site.contentStart + diagnostic.start,
-            length: Math.max(1, diagnostic.end - diagnostic.start),
-            messageText: diagnostic.message,
-            category: typescript.DiagnosticCategory.Error,
-            code: diagnosticCode,
-            source: completionSource,
-          })
-        }
-      }
-      return diagnostics
-    }
-
-    proxy.getQuickInfoAtPosition = (fileName, position) => {
-      const getBaseQuickInfo = () => baseQuickInfo(fileName, position)
-      if (!tooling) return getBaseQuickInfo()
-      const context = fileContext(fileName)
-      if (!context) return getBaseQuickInfo()
-      const { sourceFile, checker, bindings } = context
-      const literal = findStringLiteralAtPosition(typescript, sourceFile, position)
-      if (!literal) return getBaseQuickInfo()
-      const site = siteForLiteral(
-        typescript,
-        sourceFile,
-        literal,
-        tooling,
-        checker,
-        bindings
-      )
-      if (!site) return getBaseQuickInfo()
-      const hover = tooling.hover(site.property, site.value, position - site.contentStart)
-      if (!hover) return getBaseQuickInfo()
-      return {
-        kind: typescript.ScriptElementKind.string,
-        kindModifiers: '',
-        textSpan: {
-          start: site.contentStart + hover.start,
-          length: hover.end - hover.start,
-        },
-        displayParts: [{ text: hover.text, kind: 'stringLiteral' }],
-        documentation: [{ text: hover.markdown, kind: 'text' }],
-      }
-    }
-
-    proxy.dispose = () => {
-      watcher.close()
-      baseDispose()
-    }
-    return proxy
-  },
-})
-
-export default init
+export * from './core'
+export * from './document'
+export * from './extract-estree'
+export * from './extract-sucrase'

package/types/check.d.ts

@@ -6,6 +6,8 @@ export interface CheckStyleFilesOptions {
 	configPath?: string;
 	/** explicit files to check instead of walking the root */
 	files?: readonly string[];
+	/** validate clause payloads strictly against token and keyword vocabularies */
+	strict?: boolean;
 }
 export interface CheckedFile {
 	/** root-relative display path */
@@ -17,6 +19,8 @@ export interface CheckStyleFilesResult {
 	files: readonly CheckedFile[];
 	checkedFileCount: number;
 	diagnosticCount: number;
+	/** root-relative Tamagui projects omitted because they own another config */
+	skippedProjects: readonly string[];
 }
 export declare class MissingConfigArtifactError extends Error {
 	constructor(configPath: string);

package/types/check.d.ts.map

@@ -1,11 +1,11 @@
 {
-  "mappings": "AAcA,cAEO,yBACA,yBACA;AAgBP,iBAAiB,uBAAuB;;CAEtC;;CAEA;;CAEA;;AAGF,iBAAiB,YAAY;;CAE3B;CACA;CACA,sBAAsB;;AAGxB,iBAAiB,sBAAsB;CACrC,gBAAgB;CAChB;CACA;;AAGF,OAAO,cAAM,mCAAmC,MAAM;CACpD,YAAY;;AAoBd,OAAO,iBAAS,uBACd,cAAc,2BACb;AAIH,OAAO,iBAAS,gBAAgB,SAAS,yBAAyB;;AAoFlE,OAAO,iBAAS,mBACd,QAAQ,uBACR,UAAS;CAAE",
+  "mappings": "AAeA,cAEO,yBACA,yBACA;AAuBP,iBAAiB,uBAAuB;;CAEtC;;CAEA;;CAEA;;CAEA;;AAGF,iBAAiB,YAAY;;CAE3B;CACA;CACA,sBAAsB;;AAGxB,iBAAiB,sBAAsB;CACrC,gBAAgB;CAChB;CACA;;CAEA;;AAGF,OAAO,cAAM,mCAAmC,MAAM;CACpD,YAAY;;AAgCd,OAAO,iBAAS,uBACd,cAAc,2BACb;AAIH,OAAO,iBAAS,gBAAgB,SAAS,yBAAyB;;AA+JlE,OAAO,iBAAS,mBACd,QAAQ,uBACR,UAAS;CAAE",
   "names": [],
   "sources": [
     "src/check.ts"
   ],
   "version": 3,
   "sourcesContent": [
-    "// The project checker behind `tamagui check`.\n//\n// Node-only entry: walks a project's source files, extracts every static flat\n// value site with the sucrase tokenizer, and reports the same diagnostics the\n// editor plugin and eslint rule produce, formatted as readable code frames.\n\nimport { readdirSync, readFileSync } from 'node:fs'\nimport { join, relative } from 'node:path'\n// deep paths, spelled down to the file: sucrase publishes no `exports` map, and\n// a bare `sucrase/dist/parser` is a directory import that ESM cannot resolve\nimport { parse } from 'sucrase/dist/parser/index.js'\nimport { TokenType } from 'sucrase/dist/parser/tokenizer/types.js'\n\nimport { createStyleTooling, type SerializedConfigFile } from './core'\nimport {\n  createDocumentStyleTooling,\n  type DocumentDiagnostic,\n  type ExtractStyleSites,\n} from './document'\nimport { createSucraseStyleSiteExtractor } from './extract-sucrase'\n\nconst sourceExtensions = /\\.(tsx|jsx)$/\nconst skippedDirectories = new Set([\n  'node_modules',\n  'dist',\n  'build',\n  'out',\n  'coverage',\n  '.git',\n  '.next',\n  '.expo',\n  '.tamagui',\n])\n\nexport interface CheckStyleFilesOptions {\n  /** project root; file discovery and relative display paths anchor here */\n  root: string\n  /** path to the compiler's config artifact; default `<root>/.tamagui/tamagui.config.json` */\n  configPath?: string\n  /** explicit files to check instead of walking the root */\n  files?: readonly string[]\n}\n\nexport interface CheckedFile {\n  /** root-relative display path */\n  file: string\n  source: string\n  diagnostics: readonly DocumentDiagnostic[]\n}\n\nexport interface CheckStyleFilesResult {\n  files: readonly CheckedFile[]\n  checkedFileCount: number\n  diagnosticCount: number\n}\n\nexport class MissingConfigArtifactError extends Error {\n  constructor(configPath: string) {\n    super(\n      `no Tamagui config artifact at ${configPath} — run your dev server or \\`tamagui generate\\` once so the compiler emits it`\n    )\n    this.name = 'MissingConfigArtifactError'\n  }\n}\n\nfunction walkSourceFiles(directory: string, results: string[]): void {\n  for (const entry of readdirSync(directory, { withFileTypes: true })) {\n    if (entry.isDirectory()) {\n      if (!skippedDirectories.has(entry.name) && !entry.name.startsWith('.')) {\n        walkSourceFiles(join(directory, entry.name), results)\n      }\n      continue\n    }\n    if (sourceExtensions.test(entry.name)) results.push(join(directory, entry.name))\n  }\n}\n\nexport function createProjectExtractor(\n  isStyleProp: (name: string) => boolean\n): ExtractStyleSites {\n  return createSucraseStyleSiteExtractor({ parse, TokenType }, { isStyleProp })\n}\n\nexport function checkStyleFiles(options: CheckStyleFilesOptions): CheckStyleFilesResult {\n  const configPath =\n    options.configPath ?? join(options.root, '.tamagui', 'tamagui.config.json')\n  let contents: string\n  try {\n    contents = readFileSync(configPath, 'utf8')\n  } catch {\n    throw new MissingConfigArtifactError(configPath)\n  }\n  const tooling = createStyleTooling(JSON.parse(contents) as SerializedConfigFile)\n  if (!tooling) throw new MissingConfigArtifactError(configPath)\n\n  const document = createDocumentStyleTooling(\n    tooling,\n    createProjectExtractor((name) => tooling.isStyleProp(name))\n  )\n\n  let files: string[]\n  if (options.files) {\n    files = [...options.files]\n  } else {\n    files = []\n    walkSourceFiles(options.root, files)\n    files.sort()\n  }\n\n  const checked: CheckedFile[] = []\n  let diagnosticCount = 0\n  for (const file of files) {\n    let source: string\n    try {\n      source = readFileSync(file, 'utf8')\n    } catch {\n      continue\n    }\n    let diagnostics: readonly DocumentDiagnostic[]\n    try {\n      diagnostics = document.diagnostics(source)\n    } catch {\n      // a file sucrase cannot parse is a syntax error the real compiler will\n      // report; the style checker stays quiet about it\n      continue\n    }\n    if (diagnostics.length === 0) continue\n    diagnosticCount += diagnostics.length\n    checked.push({ file: relative(options.root, file), source, diagnostics })\n  }\n\n  return { files: checked, checkedFileCount: files.length, diagnosticCount }\n}\n\nconst ansi = {\n  red: (text: string) => `\\x1b[31m${text}\\x1b[39m`,\n  dim: (text: string) => `\\x1b[2m${text}\\x1b[22m`,\n  bold: (text: string) => `\\x1b[1m${text}\\x1b[22m`,\n  cyan: (text: string) => `\\x1b[36m${text}\\x1b[39m`,\n}\nconst plain = {\n  red: (text: string) => text,\n  dim: (text: string) => text,\n  bold: (text: string) => text,\n  cyan: (text: string) => text,\n}\n\nfunction lineStarts(source: string): number[] {\n  const starts = [0]\n  for (let index = 0; index < source.length; index++) {\n    if (source.charCodeAt(index) === 10) starts.push(index + 1)\n  }\n  return starts\n}\n\nfunction positionOf(starts: number[], offset: number): { line: number; column: number } {\n  let low = 0\n  let high = starts.length - 1\n  while (low < high) {\n    const mid = (low + high + 1) >> 1\n    if (starts[mid] <= offset) low = mid\n    else high = mid - 1\n  }\n  return { line: low, column: offset - starts[low] }\n}\n\n/** human-readable report: one code frame per diagnostic, caret-underlined */\nexport function formatCheckResults(\n  result: CheckStyleFilesResult,\n  options: { color?: boolean } = {}\n): string {\n  const paint = options.color === false ? plain : ansi\n  const output: string[] = []\n\n  for (const checked of result.files) {\n    const starts = lineStarts(checked.source)\n    const lines = checked.source.split('\\n')\n    for (const diagnostic of checked.diagnostics) {\n      const start = positionOf(starts, diagnostic.start)\n      const end = positionOf(starts, diagnostic.end)\n      output.push(\n        `${paint.bold(checked.file)}${paint.dim(`:${start.line + 1}:${start.column + 1}`)} ${paint.red('error')} ${diagnostic.message}`\n      )\n      const line = lines[start.line] ?? ''\n      const gutter = String(start.line + 1)\n      output.push(`  ${paint.dim(`${gutter} │`)} ${line}`)\n      const underlineLength =\n        end.line === start.line\n          ? Math.max(1, end.column - start.column)\n          : Math.max(1, line.length - start.column)\n      output.push(\n        `  ${paint.dim(`${' '.repeat(gutter.length)} │`)} ${' '.repeat(start.column)}${paint.red('^'.repeat(underlineLength))}`\n      )\n      output.push('')\n    }\n  }\n\n  const summary =\n    result.diagnosticCount === 0\n      ? `${paint.bold('✓')} ${result.checkedFileCount} files, no flat value problems`\n      : `${paint.red(paint.bold(`✗ ${result.diagnosticCount} problem${result.diagnosticCount === 1 ? '' : 's'}`))} in ${result.files.length} file${result.files.length === 1 ? '' : 's'} ${paint.dim(`(${result.checkedFileCount} checked)`)}`\n  output.push(summary)\n  return output.join('\\n')\n}\n"
+    "// The project checker behind `tamagui check`.\n//\n// Node-only entry: walks a project's source files, extracts every static flat\n// value site with the sucrase tokenizer, and reports the same diagnostics the\n// editor plugin and eslint rule produce, formatted as readable code frames.\n\nimport { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join, relative, resolve } from 'node:path'\nimport { spawnSync } from 'node:child_process'\n// deep paths, spelled down to the file: sucrase publishes no `exports` map, and\n// a bare `sucrase/dist/parser` is a directory import that ESM cannot resolve\nimport { parse } from 'sucrase/dist/parser/index.js'\nimport { TokenType } from 'sucrase/dist/parser/tokenizer/types.js'\n\nimport { createStyleTooling, type SerializedConfigFile } from './core'\nimport {\n  createDocumentStyleTooling,\n  type DocumentDiagnostic,\n  type ExtractStyleSites,\n} from './document'\nimport { createSucraseStyleSiteExtractor } from './extract-sucrase'\n\nconst sourceExtensions = /\\.(tsx|jsx)$/\nconst skippedDirectories = new Set([\n  'node_modules',\n  'dist',\n  'build',\n  'out',\n  'coverage',\n  '.git',\n  '.next',\n  '.expo',\n  '.tamagui',\n])\nconst projectMarkers = [\n  'tamagui.build.ts',\n  'tamagui.build.tsx',\n  'tamagui.build.js',\n  'tamagui.build.mjs',\n  'tamagui.build.cjs',\n]\n\nexport interface CheckStyleFilesOptions {\n  /** project root; file discovery and relative display paths anchor here */\n  root: string\n  /** path to the compiler's config artifact; default `<root>/.tamagui/tamagui.config.json` */\n  configPath?: string\n  /** explicit files to check instead of walking the root */\n  files?: readonly string[]\n  /** validate clause payloads strictly against token and keyword vocabularies */\n  strict?: boolean\n}\n\nexport interface CheckedFile {\n  /** root-relative display path */\n  file: string\n  source: string\n  diagnostics: readonly DocumentDiagnostic[]\n}\n\nexport interface CheckStyleFilesResult {\n  files: readonly CheckedFile[]\n  checkedFileCount: number\n  diagnosticCount: number\n  /** root-relative Tamagui projects omitted because they own another config */\n  skippedProjects: readonly string[]\n}\n\nexport class MissingConfigArtifactError extends Error {\n  constructor(configPath: string) {\n    super(\n      `no Tamagui config artifact at ${configPath} — run your dev server or \\`tamagui generate\\` once so the compiler emits it`\n    )\n    this.name = 'MissingConfigArtifactError'\n  }\n}\n\nfunction walkSourceFiles(\n  directory: string,\n  root: string,\n  results: string[],\n  skippedProjects: string[]\n): void {\n  for (const entry of readdirSync(directory, { withFileTypes: true })) {\n    if (entry.isDirectory()) {\n      if (skippedDirectories.has(entry.name) || entry.name.startsWith('.')) continue\n      const child = join(directory, entry.name)\n      if (\n        projectMarkers.some((marker) => existsSync(join(child, marker))) ||\n        existsSync(join(child, '.tamagui', 'tamagui.config.json'))\n      ) {\n        skippedProjects.push(relative(root, child))\n        continue\n      }\n      walkSourceFiles(child, root, results, skippedProjects)\n      continue\n    }\n    if (sourceExtensions.test(entry.name)) results.push(join(directory, entry.name))\n  }\n}\n\nexport function createProjectExtractor(\n  isStyleProp: (name: string) => boolean\n): ExtractStyleSites {\n  return createSucraseStyleSiteExtractor({ parse, TokenType }, { isStyleProp })\n}\n\nexport function checkStyleFiles(options: CheckStyleFilesOptions): CheckStyleFilesResult {\n  const root = resolve(options.root)\n  const configPath = options.configPath ?? join(root, '.tamagui', 'tamagui.config.json')\n  let contents: string\n  try {\n    contents = readFileSync(configPath, 'utf8')\n  } catch {\n    throw new MissingConfigArtifactError(configPath)\n  }\n  const tooling = createStyleTooling(JSON.parse(contents) as SerializedConfigFile, {\n    strictPayloads: options.strict,\n  })\n  if (!tooling) throw new MissingConfigArtifactError(configPath)\n\n  const document = createDocumentStyleTooling(\n    tooling,\n    createProjectExtractor((name) => tooling.isStyleProp(name)),\n    { strictPayloads: options.strict }\n  )\n\n  let files: string[]\n  const skippedProjects: string[] = []\n  if (options.files) {\n    files = [...options.files]\n  } else {\n    files = []\n    const insideGit = spawnSync('git', ['rev-parse', '--is-inside-work-tree'], {\n      cwd: root,\n      encoding: 'utf8',\n    })\n    if (insideGit.status === 0) {\n      const listed = spawnSync(\n        'git',\n        [\n          'ls-files',\n          '--cached',\n          '--others',\n          '--exclude-standard',\n          '-z',\n          '--',\n          '*.tsx',\n          '*.jsx',\n        ],\n        {\n          cwd: root,\n          encoding: 'utf8',\n          maxBuffer: 64 * 1024 * 1024,\n        }\n      )\n      if (listed.error) throw listed.error\n      if (listed.status !== 0) {\n        throw new Error(listed.stderr.trim() || 'git ls-files failed')\n      }\n      const skipped = new Set<string>()\n      const projectByDirectory = new Map<string, string | null>()\n      for (const relativeFile of listed.stdout.split('\\0')) {\n        if (!relativeFile) continue\n        const file = join(root, relativeFile)\n        if (!existsSync(file)) continue\n        let directory = dirname(file)\n        let nestedProject: string | null = null\n        const visited: string[] = []\n        while (directory !== root) {\n          if (projectByDirectory.has(directory)) {\n            nestedProject = projectByDirectory.get(directory) ?? null\n            break\n          }\n          visited.push(directory)\n          if (\n            projectMarkers.some((marker) => existsSync(join(directory, marker))) ||\n            existsSync(join(directory, '.tamagui', 'tamagui.config.json'))\n          ) {\n            nestedProject = directory\n            break\n          }\n          directory = dirname(directory)\n        }\n        for (const visitedDirectory of visited) {\n          projectByDirectory.set(visitedDirectory, nestedProject)\n        }\n        if (nestedProject) {\n          skipped.add(relative(root, nestedProject))\n        } else {\n          files.push(file)\n        }\n      }\n      skippedProjects.push(...skipped)\n    } else {\n      walkSourceFiles(root, root, files, skippedProjects)\n    }\n    files.sort()\n    skippedProjects.sort()\n  }\n\n  const checked: CheckedFile[] = []\n  let diagnosticCount = 0\n  for (const file of files) {\n    let source: string\n    try {\n      source = readFileSync(file, 'utf8')\n    } catch {\n      continue\n    }\n    let diagnostics: readonly DocumentDiagnostic[]\n    try {\n      diagnostics = document.diagnostics(source, undefined, {\n        strictPayloads: options.strict,\n      })\n    } catch {\n      // a file sucrase cannot parse is a syntax error the real compiler will\n      // report; the style checker stays quiet about it\n      continue\n    }\n    if (diagnostics.length === 0) continue\n    diagnosticCount += diagnostics.length\n    checked.push({ file: relative(root, file), source, diagnostics })\n  }\n\n  return {\n    files: checked,\n    checkedFileCount: files.length,\n    diagnosticCount,\n    skippedProjects,\n  }\n}\n\nconst ansi = {\n  red: (text: string) => `\\x1b[31m${text}\\x1b[39m`,\n  dim: (text: string) => `\\x1b[2m${text}\\x1b[22m`,\n  bold: (text: string) => `\\x1b[1m${text}\\x1b[22m`,\n  cyan: (text: string) => `\\x1b[36m${text}\\x1b[39m`,\n}\nconst plain = {\n  red: (text: string) => text,\n  dim: (text: string) => text,\n  bold: (text: string) => text,\n  cyan: (text: string) => text,\n}\n\nfunction lineStarts(source: string): number[] {\n  const starts = [0]\n  for (let index = 0; index < source.length; index++) {\n    if (source.charCodeAt(index) === 10) starts.push(index + 1)\n  }\n  return starts\n}\n\nfunction positionOf(starts: number[], offset: number): { line: number; column: number } {\n  let low = 0\n  let high = starts.length - 1\n  while (low < high) {\n    const mid = (low + high + 1) >> 1\n    if (starts[mid] <= offset) low = mid\n    else high = mid - 1\n  }\n  return { line: low, column: offset - starts[low] }\n}\n\n/** human-readable report: one code frame per diagnostic, caret-underlined */\nexport function formatCheckResults(\n  result: CheckStyleFilesResult,\n  options: { color?: boolean } = {}\n): string {\n  const paint = options.color === false ? plain : ansi\n  const output: string[] = []\n\n  for (const checked of result.files) {\n    const starts = lineStarts(checked.source)\n    const lines = checked.source.split('\\n')\n    for (const diagnostic of checked.diagnostics) {\n      const start = positionOf(starts, diagnostic.start)\n      const end = positionOf(starts, diagnostic.end)\n      output.push(\n        `${paint.bold(checked.file)}${paint.dim(`:${start.line + 1}:${start.column + 1}`)} ${paint.red('error')} ${diagnostic.message}`\n      )\n      const line = lines[start.line] ?? ''\n      const gutter = String(start.line + 1)\n      output.push(`  ${paint.dim(`${gutter} │`)} ${line}`)\n      const underlineLength =\n        end.line === start.line\n          ? Math.max(1, end.column - start.column)\n          : Math.max(1, line.length - start.column)\n      output.push(\n        `  ${paint.dim(`${' '.repeat(gutter.length)} │`)} ${' '.repeat(start.column)}${paint.red('^'.repeat(underlineLength))}`\n      )\n      output.push('')\n    }\n  }\n\n  if (result.skippedProjects.length > 0) {\n    output.push(\n      paint.dim(`Skipped nested Tamagui projects: ${result.skippedProjects.join(', ')}`)\n    )\n  }\n\n  const summary =\n    result.diagnosticCount === 0\n      ? `${paint.bold('✓')} ${result.checkedFileCount} files, no flat value problems`\n      : `${paint.red(paint.bold(`✗ ${result.diagnosticCount} problem${result.diagnosticCount === 1 ? '' : 's'}`))} in ${result.files.length} file${result.files.length === 1 ? '' : 's'} ${paint.dim(`(${result.checkedFileCount} checked)`)}`\n  output.push(summary)\n  return output.join('\\n')\n}\n"
   ]
 }

package/types/core.d.ts

@@ -51,7 +51,9 @@ export interface StyleTooling {
 	*/
 	completions(property: string, value: string, cursor: number): StyleValueCursorCompletions | null;
 	/** the complete static verdict for one authored value */
-	diagnostics(property: string, value: string): readonly StyleValueDiagnostic[];
+	diagnostics(property: string, value: string, options?: {
+		strictPayloads?: boolean;
+	}): readonly StyleValueDiagnostic[];
 	/** classified spans: modifiers, tokens, keywords, literals */
 	annotations(property: string, value: string): readonly StyleValueAnnotation[];
 	/** hover content for the annotation under `offset`, or null */
@@ -63,6 +65,9 @@ export interface StyleTooling {
 	/** root theme names, preview themes first */
 	previewThemes: readonly string[];
 }
-export declare function createStyleTooling(file: SerializedConfigFile): StyleTooling | null;
+export interface StyleToolingOptions {
+	strictPayloads?: boolean;
+}
+export declare function createStyleTooling(file: SerializedConfigFile, toolingOptions?: StyleToolingOptions): StyleTooling | null;
 
 //# sourceMappingURL=core.d.ts.map