@databricks/appkit 0.2.0 → 0.4.0

package/bin/appkit-lint.js

@@ -1,129 +0,0 @@
-#!/usr/bin/env node
-/**
- * AST-based linting using ast-grep.
- * Catches patterns that ESLint/TypeScript miss or handle poorly.
- * Usage: npx appkit-lint
- */
-import { parse, Lang } from "@ast-grep/napi";
-import fs from "node:fs";
-import path from "node:path";
-
-const rules = [
-  {
-    id: "no-double-type-assertion",
-    pattern: "$X as unknown as $Y",
-    message:
-      "Avoid double type assertion (as unknown as). Use proper type guards or fix the source type.",
-  },
-  {
-    id: "no-as-any",
-    pattern: "$X as any",
-    message:
-      'Avoid "as any" type assertion. Use proper typing or unknown with type guards.',
-    includeTests: false, // acceptable in test mocks
-  },
-  {
-    id: "no-array-index-key",
-    pattern: "key={$IDX}",
-    message:
-      "Avoid using array index as React key. Use a stable unique identifier.",
-    filter: (code) => /key=\{(idx|index|i)\}/.test(code),
-  },
-  {
-    id: "no-parse-float-without-validation",
-    pattern: "parseFloat($X).toFixed($Y)",
-    message:
-      "parseFloat can return NaN. Validate input or use toNumber() helper from shared/types.ts.",
-  },
-];
-
-function isTestFile(filePath) {
-  return (
-    /\.(test|spec)\.(ts|tsx)$/.test(filePath) || filePath.includes("/tests/")
-  );
-}
-
-function findTsFiles(dir, files = []) {
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-
-    if (entry.isDirectory()) {
-      if (["node_modules", "dist", "build", ".git"].includes(entry.name))
-        continue;
-      findTsFiles(fullPath, files);
-    } else if (entry.isFile() && /\.(ts|tsx)$/.test(entry.name)) {
-      files.push(fullPath);
-    }
-  }
-
-  return files;
-}
-
-function lintFile(filePath, rules) {
-  const violations = [];
-  const content = fs.readFileSync(filePath, "utf-8");
-  const lang = filePath.endsWith(".tsx") ? Lang.Tsx : Lang.TypeScript;
-  const testFile = isTestFile(filePath);
-
-  const ast = parse(lang, content);
-  const root = ast.root();
-
-  for (const rule of rules) {
-    // skip rules that don't apply to test files
-    if (testFile && rule.includeTests === false) continue;
-
-    const matches = root.findAll(rule.pattern);
-
-    for (const match of matches) {
-      const code = match.text();
-
-      if (rule.filter && !rule.filter(code)) continue;
-
-      const range = match.range();
-      violations.push({
-        file: filePath,
-        line: range.start.line + 1,
-        column: range.start.column + 1,
-        rule: rule.id,
-        message: rule.message,
-        code: code.length > 80 ? `${code.slice(0, 77)}...` : code,
-      });
-    }
-  }
-
-  return violations;
-}
-
-function main() {
-  const rootDir = process.cwd();
-  const files = findTsFiles(rootDir);
-
-  console.log(`Scanning ${files.length} TypeScript files...\n`);
-
-  const allViolations = [];
-
-  for (const file of files) {
-    const violations = lintFile(file, rules);
-    allViolations.push(...violations);
-  }
-
-  if (allViolations.length === 0) {
-    console.log("No ast-grep lint violations found.");
-    process.exit(0);
-  }
-
-  console.log(`Found ${allViolations.length} violation(s):\n`);
-
-  for (const v of allViolations) {
-    const relPath = path.relative(rootDir, v.file);
-    console.log(`${relPath}:${v.line}:${v.column}`);
-    console.log(`  ${v.rule}: ${v.message}`);
-    console.log(`  > ${v.code}\n`);
-  }
-
-  process.exit(1);
-}
-
-main();

package/bin/generate-types.js

@@ -1,27 +0,0 @@
-#!/usr/bin/env node
-import path from "node:path";
-
-import { generateFromEntryPoint } from "../dist/type-generator/index.js";
-
-// Parse arguments
-const args = process.argv.slice(2);
-const noCache = args.includes("--no-cache");
-const positionalArgs = args.filter((arg) => !arg.startsWith("--"));
-
-const rootDir = positionalArgs[0] || process.cwd();
-const outFile =
-  positionalArgs[1] || path.join(process.cwd(), "client/src/appKitTypes.d.ts");
-
-const queryFolder = path.join(rootDir, "config/queries");
-
-const warehouseId = positionalArgs[2] || process.env.DATABRICKS_WAREHOUSE_ID;
-if (!warehouseId) {
-  throw new Error("DATABRICKS_WAREHOUSE_ID is not set");
-}
-
-await generateFromEntryPoint({
-  queryFolder,
-  outFile,
-  warehouseId,
-  noCache,
-});

package/bin/setup-claude.js

@@ -1,190 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * CLI tool to setup CLAUDE.md for Databricks AppKit packages.
- *
- * This bin is included in both @databricks/appkit and @databricks/appkit-ui
- * so it's available regardless of which package the user installs.
- *
- * Usage:
- *   npx appkit-setup          # Show detected packages and content
- *   npx appkit-setup --write  # Create or update CLAUDE.md file
- */
-
-import fs from "node:fs";
-import path from "node:path";
-
-const PACKAGES = [
-  { name: "@databricks/appkit", description: "Backend SDK" },
-  {
-    name: "@databricks/appkit-ui",
-    description: "UI Integration, Charts, Tables, SSE, and more.",
-  },
-];
-
-const SECTION_START = "<!-- appkit-instructions-start -->";
-const SECTION_END = "<!-- appkit-instructions-end -->";
-
-/**
- * Find which AppKit packages are installed by checking for CLAUDE.md
- */
-function findInstalledPackages() {
-  const cwd = process.cwd();
-  const installed = [];
-
-  for (const pkg of PACKAGES) {
-    const claudePath = path.join(cwd, "node_modules", pkg.name, "package.json");
-    if (fs.existsSync(claudePath)) {
-      installed.push(pkg);
-    }
-  }
-
-  return installed;
-}
-
-/**
- * Generate the AppKit section content
- */
-function generateSection(packages) {
-  const links = packages
-    .map((pkg) => {
-      const docPath = `./node_modules/${pkg.name}/CLAUDE.md`;
-      return `- **${pkg.name}** (${pkg.description}): [${docPath}](${docPath})`;
-    })
-    .join("\n");
-
-  return `${SECTION_START}
-## Databricks AppKit
-
-This project uses Databricks AppKit packages. For AI assistant guidance on using these packages, refer to:
-
-${links}
-${SECTION_END}`;
-}
-
-/**
- * Generate standalone CLAUDE.md content (when no existing file)
- */
-function generateStandalone(packages) {
-  const links = packages
-    .map((pkg) => {
-      const docPath = `./node_modules/${pkg.name}/CLAUDE.md`;
-      return `- **${pkg.name}** (${pkg.description}): [${docPath}](${docPath})`;
-    })
-    .join("\n");
-
-  return `# AI Assistant Instructions
-
-${SECTION_START}
-## Databricks AppKit
-
-This project uses Databricks AppKit packages. For AI assistant guidance on using these packages, refer to:
-
-${links}
-${SECTION_END}
-`;
-}
-
-/**
- * Update existing content with AppKit section
- */
-function updateContent(existingContent, packages) {
-  const newSection = generateSection(packages);
-
-  // Check if AppKit section already exists
-  const startIndex = existingContent.indexOf(SECTION_START);
-  const endIndex = existingContent.indexOf(SECTION_END);
-
-  if (startIndex !== -1 && endIndex !== -1) {
-    // Replace existing section
-    const before = existingContent.substring(0, startIndex);
-    const after = existingContent.substring(endIndex + SECTION_END.length);
-    return before + newSection + after;
-  }
-
-  // Append section to end
-  return `${existingContent.trimEnd()}\n\n${newSection}\n`;
-}
-
-/**
- * Main CLI logic
- */
-function main() {
-  const args = process.argv.slice(2);
-  const shouldWrite = args.includes("--write") || args.includes("-w");
-  const help = args.includes("--help") || args.includes("-h");
-
-  if (help) {
-    console.log(`
-Usage: npx appkit-setup [options]
-
-Options:
-  --write, -w   Create or update CLAUDE.md file in current directory
-  --help, -h    Show this help message
-
-Examples:
-  npx appkit-setup              # Show detected packages and preview content
-  npx appkit-setup --write      # Create or update CLAUDE.md
-`);
-    return;
-  }
-
-  // Find installed packages
-  const installed = findInstalledPackages();
-
-  if (installed.length === 0) {
-    console.log("No @databricks/appkit packages found in node_modules.");
-    console.log("\nMake sure you've installed at least one of:");
-    PACKAGES.forEach((pkg) => {
-      console.log(`  - ${pkg.name}`);
-    });
-    process.exit(1);
-  }
-
-  console.log("Detected packages:");
-  installed.forEach((pkg) => {
-    console.log(`  ✓ ${pkg.name}`);
-  });
-
-  const claudePath = path.join(process.cwd(), "CLAUDE.md");
-  const existingContent = fs.existsSync(claudePath)
-    ? fs.readFileSync(claudePath, "utf-8")
-    : null;
-
-  let finalContent;
-  let action;
-
-  if (existingContent) {
-    finalContent = updateContent(existingContent, installed);
-    action = existingContent.includes(SECTION_START) ? "Updated" : "Added to";
-  } else {
-    finalContent = generateStandalone(installed);
-    action = "Created";
-  }
-
-  if (shouldWrite) {
-    fs.writeFileSync(claudePath, finalContent);
-    console.log(`\n✓ ${action} CLAUDE.md`);
-    console.log(`  Path: ${claudePath}`);
-  } else {
-    console.log("\nTo create/update CLAUDE.md, run:");
-    console.log("  npx appkit-setup --write\n");
-
-    if (existingContent) {
-      console.log(
-        `This will ${
-          existingContent.includes(SECTION_START)
-            ? "update the existing"
-            : "add a new"
-        } AppKit section.\n`,
-      );
-    }
-
-    console.log("Preview of AppKit section:\n");
-    console.log("─".repeat(50));
-    console.log(generateSection(installed));
-    console.log("─".repeat(50));
-  }
-}
-
-main();