td-ai-tools 1.2.0 → 1.2.2

package/skills/shopify-lint/theme-check-theory/src/utils/ast.ts

@@ -0,0 +1,126 @@
+import {
+  NodeTypes,
+} from '@shopify/liquid-html-parser';
+import type {
+  LiquidRawTag,
+  LiquidVariableLookup,
+} from '@shopify/liquid-html-parser';
+import {
+  findNodeAtLocation,
+  parseTree,
+} from 'jsonc-parser';
+import type { Node as JsonNode, ParseError } from 'jsonc-parser';
+
+export type SettingScope = 'section' | 'block';
+
+export type SettingDeclaration = {
+  id: string;
+  scope: SettingScope;
+  type: string;
+  startIndex: number;
+  endIndex: number;
+};
+
+export type SettingReference =
+  | { id: string; scope: SettingScope; dynamic: false }
+  | { id?: never; scope: SettingScope; dynamic: true };
+
+/**
+ * Parses the one schema shape these checks care about and retains the source
+ * range of each id so diagnostics point at the declaration, not the full tag.
+ */
+export function getSettingDeclarations(node: LiquidRawTag): SettingDeclaration[] | undefined {
+  if (node.name !== 'schema') return undefined;
+
+  const errors: ParseError[] = [];
+  const root = parseTree(node.body.value, errors, {
+    allowTrailingComma: false,
+    disallowComments: true,
+  });
+
+  if (!root || root.type !== 'object' || errors.length > 0) return undefined;
+
+  const declarations = collectSettings(
+    findNodeAtLocation(root, ['settings']),
+    'section',
+    node.body.position.start,
+  );
+  const blocks = findNodeAtLocation(root, ['blocks']);
+
+  if (blocks?.type === 'array') {
+    for (const block of blocks.children ?? []) {
+      declarations.push(
+        ...collectSettings(
+          findNodeAtLocation(block, ['settings']),
+          'block',
+          node.body.position.start,
+        ),
+      );
+    }
+  }
+
+  return declarations;
+}
+
+/**
+ * Returns only direct setting-object lookups. A non-string second lookup (or
+ * passing the whole settings object elsewhere) means static analysis cannot
+ * identify the selected setting.
+ */
+export function getSettingReference(node: LiquidVariableLookup): SettingReference | undefined {
+  if (node.name !== 'section' && node.name !== 'block') return undefined;
+
+  const settingsLookup = node.lookups[0];
+  if (
+    settingsLookup?.type !== NodeTypes.String ||
+    settingsLookup.value !== 'settings'
+  ) {
+    return undefined;
+  }
+
+  const settingLookup = node.lookups[1];
+  if (!settingLookup) {
+    return { scope: node.name, dynamic: true };
+  }
+
+  if (settingLookup.type !== NodeTypes.String) {
+    return { scope: node.name, dynamic: true };
+  }
+
+  return {
+    id: settingLookup.value,
+    scope: node.name,
+    dynamic: false,
+  };
+}
+
+export function settingKey({ id, scope }: { id: string; scope: SettingScope }): string {
+  return `${scope}:${id}`;
+}
+
+function collectSettings(
+  settings: JsonNode | undefined,
+  scope: SettingScope,
+  schemaOffset: number,
+): SettingDeclaration[] {
+  if (settings?.type !== 'array') return [];
+
+  const declarations: SettingDeclaration[] = [];
+  for (const setting of settings.children ?? []) {
+    if (setting.type !== 'object') continue;
+
+    const id = findNodeAtLocation(setting, ['id']);
+    const type = findNodeAtLocation(setting, ['type']);
+    if (id?.type !== 'string' || type?.type !== 'string') continue;
+
+    declarations.push({
+      id: id.value,
+      scope,
+      type: type.value,
+      startIndex: schemaOffset + id.offset,
+      endIndex: schemaOffset + id.offset + id.length,
+    });
+  }
+
+  return declarations;
+}

package/skills/shopify-lint/theme-check-theory/tsconfig.build.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src",
+    "sourceMap": true
+  },
+  "exclude": ["src/**/*.test.ts", "src/test-utils.ts"]
+}
+

package/skills/shopify-lint/theme-check-theory/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "declaration": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["node", "vitest/globals"]
+  },
+  "include": ["src/**/*.ts"]
+}
+

package/skills/shopify-lint/theme-check-theory/vitest.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    coverage: {
+      include: ['src/**/*.ts'],
+      exclude: ['src/**/*.test.ts', 'src/test-utils.ts'],
+    },
+  },
+});
+