@fragments-sdk/cli 0.14.3 → 0.15.0

package/dist/chunk-7DZC4YEV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/service/enhance/scanner.ts","../src/service/babel-config.ts"],"sourcesContent":["/**\n * AST Scanner for Component Usage Analysis\n *\n * Scans TypeScript/TSX files to find:\n * - Component imports (named, default, aliased)\n * - Component usages in JSX with props\n */\n\nimport { parse } from \"@babel/parser\";\nimport { BABEL_PARSER_OPTIONS } from \"../babel-config.js\";\nimport _traverse from \"@babel/traverse\";\nimport * as t from \"@babel/types\";\n\n// Handle CommonJS/ESM interop\nconst traverse = (_traverse as unknown as { default: typeof _traverse }).default || _traverse;\nimport { readFile } from \"node:fs/promises\";\nimport type {\n  ComponentImport,\n  ComponentUsage,\n  UsageProps,\n} from \"./types.js\";\n\n\n/**\n * Scan a file for component imports\n *\n * Handles:\n * - Named imports: import { Button } from './Button'\n * - Default imports: import Button from './Button'\n * - Aliased imports: import { Button as Btn } from './Button'\n * - Namespace imports: import * as Components from './index'\n */\nexport async function scanFileForImports(\n  filePath: string\n): Promise<ComponentImport[]> {\n  const imports: ComponentImport[] = [];\n\n  try {\n    const sourceCode = await readFile(filePath, \"utf-8\");\n    const ast = parse(sourceCode, BABEL_PARSER_OPTIONS);\n\n    traverse(ast, {\n      ImportDeclaration(path) {\n        const source = path.node.source.value;\n        const line = path.node.loc?.start.line ?? 0;\n\n        for (const specifier of path.node.specifiers) {\n          if (t.isImportSpecifier(specifier)) {\n            // Named import: import { Button } from './Button'\n            // or aliased: import { Button as Btn } from './Button'\n            const importedName = t.isIdentifier(specifier.imported)\n              ? specifier.imported.name\n              : specifier.imported.value;\n            const localName = specifier.local.name;\n\n            // Only track PascalCase names (likely components)\n            if (isPascalCase(importedName)) {\n              imports.push({\n                componentName: importedName,\n                localName,\n                source,\n                isDefault: false,\n                filePath,\n                line,\n              });\n            }\n          } else if (t.isImportDefaultSpecifier(specifier)) {\n            // Default import: import Button from './Button'\n            const localName = specifier.local.name;\n\n            // Only track PascalCase names (likely components)\n            if (isPascalCase(localName)) {\n              imports.push({\n                componentName: localName,\n                localName,\n                source,\n                isDefault: true,\n                filePath,\n                line,\n              });\n            }\n          }\n          // Skip namespace imports for now (import * as X)\n        }\n      },\n    });\n  } catch (error) {\n    // Return empty array for files with parse errors\n    // Caller can check if empty means \"no imports\" or \"parse error\"\n    console.warn(`Failed to parse ${filePath}:`, (error as Error).message);\n    return [];\n  }\n\n  return imports;\n}\n\n/**\n * Scan a file for component usages in JSX\n *\n * @param filePath - File to scan\n * @param componentNames - Map of localName -> componentName for components to track\n */\nexport async function scanFileForUsages(\n  filePath: string,\n  componentNames: Map<string, string>\n): Promise<ComponentUsage[]> {\n  const usages: ComponentUsage[] = [];\n\n  try {\n    const sourceCode = await readFile(filePath, \"utf-8\");\n    const lines = sourceCode.split(\"\\n\");\n    const ast = parse(sourceCode, BABEL_PARSER_OPTIONS);\n\n    traverse(ast, {\n      JSXOpeningElement(path) {\n        const elementName = getJSXElementName(path.node.name);\n        if (!elementName) return;\n\n        // Check if this is a tracked component (by local name)\n        const componentName = componentNames.get(elementName);\n        if (!componentName) return;\n\n        const loc = path.node.loc;\n        if (!loc) return;\n\n        // Extract props\n        const props = extractProps(path.node.attributes);\n\n        // Get surrounding context (3 lines before and after)\n        const contextLines = getContextLines(lines, loc.start.line - 1, 3);\n\n        // Check if conditionally rendered\n        const isConditional = checkIfConditional(path);\n\n        // Get parent element name\n        const parentElement = getParentElementName(path);\n\n        usages.push({\n          componentName,\n          filePath,\n          line: loc.start.line,\n          column: loc.start.column,\n          props,\n          context: contextLines,\n          parentElement,\n          hasSpreadProps: props.spreads.length > 0,\n          isConditional,\n        });\n      },\n    });\n  } catch (error) {\n    console.warn(`Failed to parse ${filePath}:`, (error as Error).message);\n    return [];\n  }\n\n  return usages;\n}\n\n/**\n * Scan a file for both imports and usages in a single pass\n * More efficient for scanning many files\n */\nexport async function scanFile(\n  filePath: string,\n  trackedComponents?: Set<string>\n): Promise<{ imports: ComponentImport[]; usages: ComponentUsage[] }> {\n  const imports: ComponentImport[] = [];\n  const usages: ComponentUsage[] = [];\n\n  try {\n    const sourceCode = await readFile(filePath, \"utf-8\");\n    const lines = sourceCode.split(\"\\n\");\n    const ast = parse(sourceCode, BABEL_PARSER_OPTIONS);\n\n    // Track local names to component names mapping within this file\n    const localToComponent = new Map<string, string>();\n\n    traverse(ast, {\n      ImportDeclaration(path) {\n        const source = path.node.source.value;\n        const line = path.node.loc?.start.line ?? 0;\n\n        for (const specifier of path.node.specifiers) {\n          if (t.isImportSpecifier(specifier)) {\n            const importedName = t.isIdentifier(specifier.imported)\n              ? specifier.imported.name\n              : specifier.imported.value;\n            const localName = specifier.local.name;\n\n            if (isPascalCase(importedName)) {\n              // If we're tracking specific components, only add those\n              if (!trackedComponents || trackedComponents.has(importedName)) {\n                imports.push({\n                  componentName: importedName,\n                  localName,\n                  source,\n                  isDefault: false,\n                  filePath,\n                  line,\n                });\n                localToComponent.set(localName, importedName);\n              }\n            }\n          } else if (t.isImportDefaultSpecifier(specifier)) {\n            const localName = specifier.local.name;\n\n            if (isPascalCase(localName)) {\n              if (!trackedComponents || trackedComponents.has(localName)) {\n                imports.push({\n                  componentName: localName,\n                  localName,\n                  source,\n                  isDefault: true,\n                  filePath,\n                  line,\n                });\n                localToComponent.set(localName, localName);\n              }\n            }\n          }\n        }\n      },\n\n      JSXOpeningElement(path) {\n        const elementName = getJSXElementName(path.node.name);\n        if (!elementName) return;\n\n        // Check if this is a tracked component (by local name)\n        const componentName = localToComponent.get(elementName);\n        if (!componentName) return;\n\n        const loc = path.node.loc;\n        if (!loc) return;\n\n        const props = extractProps(path.node.attributes);\n        const contextLines = getContextLines(lines, loc.start.line - 1, 3);\n        const isConditional = checkIfConditional(path);\n        const parentElement = getParentElementName(path);\n\n        usages.push({\n          componentName,\n          filePath,\n          line: loc.start.line,\n          column: loc.start.column,\n          props,\n          context: contextLines,\n          parentElement,\n          hasSpreadProps: props.spreads.length > 0,\n          isConditional,\n        });\n      },\n    });\n  } catch (error) {\n    console.warn(`Failed to parse ${filePath}:`, (error as Error).message);\n    return { imports: [], usages: [] };\n  }\n\n  return { imports, usages };\n}\n\n/**\n * Check if a string is PascalCase (likely a component name)\n */\nfunction isPascalCase(str: string): boolean {\n  return /^[A-Z][a-zA-Z0-9]*$/.test(str);\n}\n\n/**\n * Get the element name from a JSX element name node\n */\nfunction getJSXElementName(\n  name: t.JSXIdentifier | t.JSXMemberExpression | t.JSXNamespacedName\n): string | null {\n  if (t.isJSXIdentifier(name)) {\n    return name.name;\n  }\n  if (t.isJSXMemberExpression(name)) {\n    // Handle Component.SubComponent - return the full path\n    const parts: string[] = [];\n    let current: t.JSXMemberExpression | t.JSXIdentifier = name;\n    while (t.isJSXMemberExpression(current)) {\n      parts.unshift(current.property.name);\n      current = current.object as t.JSXMemberExpression | t.JSXIdentifier;\n    }\n    if (t.isJSXIdentifier(current)) {\n      parts.unshift(current.name);\n    }\n    return parts.join(\".\");\n  }\n  return null;\n}\n\n/**\n * Extract props from JSX attributes\n */\nfunction extractProps(\n  attributes: (t.JSXAttribute | t.JSXSpreadAttribute)[]\n): UsageProps {\n  const result: UsageProps = {\n    static: {},\n    dynamic: [],\n    spreads: [],\n  };\n\n  for (const attr of attributes) {\n    if (t.isJSXSpreadAttribute(attr)) {\n      // {...props} or {...otherProps}\n      if (t.isIdentifier(attr.argument)) {\n        result.spreads.push(attr.argument.name);\n      } else {\n        result.spreads.push(\"(expression)\");\n      }\n    } else if (t.isJSXAttribute(attr)) {\n      const propName = t.isJSXIdentifier(attr.name)\n        ? attr.name.name\n        : `${attr.name.namespace.name}:${attr.name.name.name}`;\n\n      const value = attr.value;\n\n      if (value === null) {\n        // Boolean shorthand: <Button disabled />\n        result.static[propName] = true;\n      } else if (t.isStringLiteral(value)) {\n        // String literal: <Button variant=\"primary\" />\n        result.static[propName] = value.value;\n      } else if (t.isJSXExpressionContainer(value)) {\n        const expr = value.expression;\n\n        if (t.isStringLiteral(expr)) {\n          result.static[propName] = expr.value;\n        } else if (t.isNumericLiteral(expr)) {\n          result.static[propName] = expr.value;\n        } else if (t.isBooleanLiteral(expr)) {\n          result.static[propName] = expr.value;\n        } else if (t.isTemplateLiteral(expr) && expr.expressions.length === 0) {\n          // Static template literal: variant={`primary`}\n          result.static[propName] = expr.quasis.map((q) => q.value.raw).join(\"\");\n        } else {\n          // Dynamic expression\n          result.dynamic.push(propName);\n        }\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Get surrounding context lines\n */\nfunction getContextLines(\n  lines: string[],\n  centerLine: number,\n  radius: number\n): string {\n  const start = Math.max(0, centerLine - radius);\n  const end = Math.min(lines.length, centerLine + radius + 1);\n  return lines.slice(start, end).join(\"\\n\");\n}\n\n/**\n * Check if JSX element is conditionally rendered\n */\nfunction checkIfConditional(path: babel.NodePath<t.JSXOpeningElement>): boolean {\n  let current: babel.NodePath | null = path.parentPath;\n\n  while (current) {\n    // Check for {condition && <Component />}\n    if (\n      current.isLogicalExpression() &&\n      current.node.operator === \"&&\"\n    ) {\n      return true;\n    }\n\n    // Check for {condition ? <Component /> : null}\n    if (current.isConditionalExpression()) {\n      return true;\n    }\n\n    // Check for ternary in JSX expression container\n    if (\n      current.isJSXExpressionContainer() &&\n      current.parentPath?.isJSXElement()\n    ) {\n      const expr = current.node.expression;\n      if (\n        t.isLogicalExpression(expr) ||\n        t.isConditionalExpression(expr)\n      ) {\n        return true;\n      }\n    }\n\n    current = current.parentPath;\n  }\n\n  return false;\n}\n\n/**\n * Get the parent JSX element name\n */\nfunction getParentElementName(\n  path: babel.NodePath<t.JSXOpeningElement>\n): string | undefined {\n  let current: babel.NodePath | null = path.parentPath;\n  const currentElementName = getJSXElementName(path.node.name);\n\n  while (current) {\n    if (current.isJSXElement()) {\n      const opening = current.node.openingElement;\n      const name = getJSXElementName(opening.name);\n      if (name && name !== currentElementName) {\n        return name;\n      }\n    }\n    current = current.parentPath;\n  }\n\n  return undefined;\n}\n\n// Type import for babel NodePath\nimport type * as babel from \"@babel/traverse\";\n","/**\n * Shared Babel parser configuration for React/TypeScript files.\n */\n\nimport type { ParserOptions } from \"@babel/parser\";\n\nexport const BABEL_PARSER_OPTIONS: ParserOptions = {\n  sourceType: \"module\",\n  plugins: [\n    \"jsx\",\n    \"typescript\",\n    [\"decorators\", { decoratorsBeforeExport: true }],\n    \"classProperties\",\n    \"classPrivateProperties\",\n    \"classPrivateMethods\",\n    \"exportDefaultFrom\",\n    \"exportNamespaceFrom\",\n    \"dynamicImport\",\n    \"nullishCoalescingOperator\",\n    \"optionalChaining\",\n    \"objectRestSpread\",\n  ],\n};\n"],"mappings":"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","names":[]}

package/dist/{chunk-LOYS64QS.js → chunk-7WHVW72L.js}

@@ -1,20 +1,18 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   createComponentExtractor
-} from "./chunk-EYXVAMEX.js";
-import {
-  generateContextMd,
-  generateRegistry,
-  loadFragmentFile,
-  parseFragmentFile
-} from "./chunk-55KERLWL.js";
+} from "./chunk-MN3TJ3D5.js";
 import {
   discoverBlockFiles,
   discoverComponentFiles,
   discoverFragmentFiles,
   discoverTokenFiles,
-  extractComponentName
-} from "./chunk-ZKTFKHWN.js";
+  extractComponentName,
+  generateContextMd,
+  generateRegistry,
+  loadFragmentFile,
+  parseFragmentFile
+} from "./chunk-65WSVDV5.js";
 import {
   BrowserPool,
   CaptureEngine,
@@ -24,16 +22,20 @@ import {
   formatMs,
   generateHtmlReport,
   getGrade
-} from "./chunk-APTQIBS5.js";
+} from "./chunk-XJQ5BIWI.js";
 import {
   BRAND,
   DEFAULTS,
   classifyComplexity,
   compileBlock,
   fragmentDefinitionSchema,
+  isContractFile,
+  isDTCGFile,
+  parseComponentContract,
+  parseDTCGFile,
   parseTokenFile,
   resolvePerformanceConfig
-} from "./chunk-I34BC3CU.js";
+} from "./chunk-32LIWN2P.js";
 
 // src/service/snippet-validation.ts
 import ts from "typescript";
@@ -369,8 +371,10 @@ function sortAndFilterBatch(files, componentStart, componentLimit) {
   const getComponentName = (relativePath) => {
     const normalized = relativePath.replace(/\\/g, "/");
     const fileName = normalized.split("/").pop() ?? normalized;
-    if (fileName.endsWith(BRAND.fileExtension)) {
-      return fileName.slice(0, -BRAND.fileExtension.length);
+    for (const ext of [BRAND.fileExtension, ".fragment.tsx", ".fragment.ts"]) {
+      if (fileName.endsWith(ext)) {
+        return fileName.slice(0, -ext.length);
+      }
     }
     return extractComponentName(relativePath);
   };
@@ -428,7 +432,9 @@ async function validateSnippetPolicy(config, configDir, options = {}) {
   const policy = normalizePolicy(config.snippets, options);
   const issues = [];
   const discovered = await discoverFragmentFiles(config, configDir);
-  const fragmentFiles = discovered.filter((file) => file.relativePath.endsWith(BRAND.fileExtension));
+  const fragmentFiles = discovered.filter(
+    (file) => file.relativePath.endsWith(".fragment.tsx") || file.relativePath.endsWith(".fragment.ts")
+  );
   const batchResult = sortAndFilterBatch(fragmentFiles, policy.componentStart, policy.componentLimit);
   if (batchResult.warning) {
     issues.push({ file: "snippets", message: batchResult.warning });
@@ -886,6 +892,111 @@ function findVariablesFile(tokensDir) {
   return null;
 }
 
+// src/core/extractor-adapter.ts
+var ReactExtractorAdapter = class {
+  extractor;
+  verificationLevel = "full";
+  constructor(tsconfigPath) {
+    this.extractor = createComponentExtractor(tsconfigPath);
+  }
+  canHandle(framework) {
+    return framework === "react";
+  }
+  extract(sourcePath, exportName) {
+    return this.extractor.extract(sourcePath, exportName);
+  }
+  dispose() {
+    this.extractor.dispose();
+  }
+};
+var NoopExtractorAdapter = class {
+  verificationLevel = "none";
+  canHandle() {
+    return true;
+  }
+  extract() {
+    return null;
+  }
+  dispose() {
+  }
+};
+function createExtractorAdapter(framework, tsconfigPath) {
+  if (framework === "react") {
+    return new ReactExtractorAdapter(tsconfigPath);
+  }
+  return new NoopExtractorAdapter();
+}
+
+// src/core/drift-verifier.ts
+function verifyContractDrift(contract, extracted) {
+  const contractPropNames = new Set(Object.keys(contract.props));
+  const sourcePropNames = new Set(
+    Object.entries(extracted.props).filter(([, p]) => p.source === "local").map(([name]) => name)
+  );
+  const removedProps = [];
+  const undocumentedProps = [];
+  const typeMismatches = [];
+  const defaultMismatches = [];
+  for (const name of contractPropNames) {
+    if (!sourcePropNames.has(name)) {
+      removedProps.push(name);
+    }
+  }
+  for (const name of sourcePropNames) {
+    if (!contractPropNames.has(name)) {
+      undocumentedProps.push(name);
+    }
+  }
+  for (const name of contractPropNames) {
+    const contractProp = contract.props[name];
+    const sourceProp = extracted.props[name];
+    if (!sourceProp || sourceProp.source !== "local") continue;
+    if (contractProp.type !== sourceProp.typeKind) {
+      typeMismatches.push({
+        prop: name,
+        contract: contractProp.type,
+        source: sourceProp.typeKind
+      });
+    }
+    const contractDefault = contractProp.default;
+    const sourceDefault = sourceProp.default;
+    if (contractDefault !== void 0 && sourceDefault !== void 0) {
+      if (String(contractDefault) !== String(sourceDefault)) {
+        defaultMismatches.push({
+          prop: name,
+          contract: contractDefault,
+          source: sourceDefault
+        });
+      }
+    }
+  }
+  const isClean = removedProps.length === 0 && undocumentedProps.length === 0 && typeMismatches.length === 0 && defaultMismatches.length === 0;
+  return {
+    componentName: contract.meta.name,
+    removedProps,
+    undocumentedProps,
+    typeMismatches,
+    defaultMismatches,
+    isClean
+  };
+}
+function formatDriftReport(report2) {
+  const lines = [`Drift detected for ${report2.componentName}:`];
+  if (report2.removedProps.length > 0) {
+    lines.push(`  Removed from source: ${report2.removedProps.join(", ")}`);
+  }
+  if (report2.undocumentedProps.length > 0) {
+    lines.push(`  Missing from contract: ${report2.undocumentedProps.join(", ")}`);
+  }
+  for (const m of report2.typeMismatches) {
+    lines.push(`  Type mismatch: ${m.prop} (contract: ${m.contract}, source: ${m.source})`);
+  }
+  for (const m of report2.defaultMismatches) {
+    lines.push(`  Default mismatch: ${m.prop} (contract: ${String(m.contract)}, source: ${String(m.source)})`);
+  }
+  return lines.join("\n");
+}
+
 // src/core/graph-extractor.ts
 import ts3 from "typescript";
 import { readFileSync, existsSync as existsSync4 } from "fs";
@@ -1573,6 +1684,7 @@ async function buildFragments(config, configDir) {
   const errors = [];
   const warnings = [];
   const fragments = {};
+  const contractSourcedNames = /* @__PURE__ */ new Set();
   const tsconfigCandidates = [
     resolve5(configDir, "tsconfig.json"),
     resolve5(configDir, "..", "tsconfig.json")
@@ -1582,6 +1694,86 @@ async function buildFragments(config, configDir) {
   for (const file of files) {
     try {
       const content = await readFile3(file.absolutePath, "utf-8");
+      if (isContractFile(file.absolutePath)) {
+        try {
+          const parsed2 = parseComponentContract(content, file.relativePath);
+          const framework = parsed2.framework ?? config.framework ?? "react";
+          const contractAdapter = createExtractorAdapter(framework, tsconfigPath);
+          let extractedMeta2 = null;
+          if (parsed2.sourcePath && parsed2.exportName && contractAdapter.canHandle(framework)) {
+            try {
+              const absSourcePath = resolve5(configDir, parsed2.sourcePath);
+              extractedMeta2 = contractAdapter.extract(absSourcePath, parsed2.exportName);
+            } catch {
+            }
+          }
+          let mergedProps2 = parsed2.props;
+          if (extractedMeta2 && Object.keys(extractedMeta2.props).length > 0) {
+            mergedProps2 = mergeDocumentedAndAutoProps(mergedProps2, extractedMeta2.props);
+          }
+          let contractPropsSummary = parsed2.propsSummary;
+          if ((!contractPropsSummary || contractPropsSummary.length === 0) && extractedMeta2) {
+            contractPropsSummary = compilePropsSummary(extractedMeta2.props);
+          }
+          let ai2 = parsed2.ai;
+          if (extractedMeta2?.composition) {
+            const comp = extractedMeta2.composition;
+            ai2 = {
+              compositionPattern: comp.pattern,
+              subComponents: comp.parts.map((p) => p.name),
+              ...ai2
+            };
+          }
+          if (parsed2.provenance?.verified && extractedMeta2) {
+            const drift = verifyContractDrift(parsed2, extractedMeta2);
+            if (!drift.isClean) {
+              errors.push({
+                file: file.relativePath,
+                error: formatDriftReport(drift)
+              });
+              contractAdapter.dispose();
+              continue;
+            }
+          }
+          const compiled2 = {
+            filePath: file.relativePath,
+            meta: {
+              name: parsed2.meta.name,
+              description: parsed2.meta.description,
+              category: parsed2.meta.category,
+              tags: parsed2.meta.tags,
+              status: parsed2.meta.status,
+              figma: parsed2.meta.figma
+            },
+            usage: parsed2.usage,
+            props: mergedProps2,
+            relations: parsed2.relations,
+            variants: parsed2.variants,
+            ...parsed2.contract && { contract: parsed2.contract },
+            ...ai2 && { ai: ai2 },
+            framework: parsed2.framework,
+            propsSummary: contractPropsSummary,
+            sourcePath: parsed2.sourcePath,
+            exportName: parsed2.exportName,
+            provenance: parsed2.provenance
+          };
+          fragments[compiled2.meta.name] = compiled2;
+          contractSourcedNames.add(compiled2.meta.name);
+          contractAdapter.dispose();
+        } catch (error) {
+          errors.push({
+            file: file.relativePath,
+            error: `Contract parse error: ${error instanceof Error ? error.message : String(error)}`
+          });
+        }
+        continue;
+      }
+      if (file.absolutePath.endsWith(".fragment.tsx") || file.absolutePath.endsWith(".fragment.ts")) {
+        warnings.push({
+          file: file.relativePath,
+          warning: "Deprecated format: .fragment.tsx \u2014 run `fragments migrate-contract` to generate .contract.json"
+        });
+      }
       if (!content.includes("defineFragment")) {
         warnings.push({
           file: file.relativePath,
@@ -1696,9 +1888,21 @@ async function buildFragments(config, configDir) {
         // Include AI metadata (auto-enriched or manual)
         ...ai && { ai },
         // Include contract metadata (auto-compiled or manual)
-        ...contract && { contract }
+        ...contract && { contract },
+        // Provenance from TSX path
+        provenance: {
+          source: extractedMeta ? "extracted" : "manual",
+          verified: !!extractedMeta
+        }
       };
-      fragments[parsed.meta.name] = compiled;
+      if (contractSourcedNames.has(parsed.meta.name)) {
+        warnings.push({
+          file: file.relativePath,
+          warning: `Duplicate: "${parsed.meta.name}" already loaded from .contract.json \u2014 skipping .fragment.tsx`
+        });
+      } else {
+        fragments[parsed.meta.name] = compiled;
+      }
     } catch (error) {
       errors.push({
         file: file.relativePath,
@@ -1745,8 +1949,15 @@ async function buildFragments(config, configDir) {
       }
       const allContent = fileContents.map((f) => f.content).join("\n");
       for (const { content, path } of fileContents) {
-        const parsed = parseTokenFile(allContent, path);
-        const fileParsed = parseTokenFile(content, path);
+        let fileParsed;
+        let parsed;
+        if (isDTCGFile(path)) {
+          fileParsed = parseDTCGFile(content, path);
+          parsed = fileParsed;
+        } else {
+          parsed = parseTokenFile(allContent, path);
+          fileParsed = parseTokenFile(content, path);
+        }
         prefix = fileParsed.prefix;
         total += fileParsed.total;
         for (const [cat, catTokens] of Object.entries(fileParsed.categories)) {
@@ -2450,4 +2661,4 @@ export {
   runDiffCommand,
   runAnalyzeCommand
 };
-//# sourceMappingURL=chunk-LOYS64QS.js.map
+//# sourceMappingURL=chunk-7WHVW72L.js.map