refactor: manifest imports

Author: MarioCadenas

apps/dev-playground/package.json

@@ -37,7 +37,7 @@
     "@types/react-syntax-highlighter": "^15.5.13",
     "@vitejs/plugin-react": "^5.0.4",
     "dotenv": "^16.0.0",
-    "tsdown": "^0.15.7",
+    "tsdown": "^0.20.3",
     "tsx": "^4.20.6",
     "vite": "npm:rolldown-vite@7.1.14"
   },

docs/docs/development/project-setup.md

@@ -63,7 +63,7 @@ The AppKit `server()` plugin automatically serves:
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^5.1.1",
-    "tsdown": "^0.15.7",
+    "tsdown": "^0.20.3",
     "tsx": "^4.19.0",
     "typescript": "~5.6.0",
     "vite": "^7.2.4"

docs/docs/plugins/plugin-management.md

@@ -6,6 +6,8 @@ sidebar_position: 6
 
 AppKit includes a CLI for managing plugins. All commands are available under `npx @databricks/appkit plugin`.
 
+**Manifest convention:** A plugin directory may contain either `manifest.json` or a compiled `manifest.js` (or `manifest.cjs`). The CLI discovers both; sync, list, and validate accept either. The **add-resource** command only edits `manifest.json` in place (if your plugin uses only `manifest.js`, add resources by editing the source that produces it).
+
 ## Create a plugin
 
 Scaffold a new plugin interactively:
@@ -20,7 +22,7 @@ The wizard walks you through:
 - **Resources**: Which Databricks resources the plugin needs (SQL Warehouse, Secret, etc.) and whether each is required or optional
 - **Optional fields**: Author, version, license
 
-The command generates a complete plugin scaffold with `manifest.json`, TypeScript class, and barrel exports — ready to register in your app.
+The command generates a complete plugin scaffold with `manifest.json` and a TypeScript plugin class that imports the manifest directly — ready to register in your app.
 
 ## Sync plugin manifests
 
@@ -75,7 +77,7 @@ npx @databricks/appkit plugin list --json
 
 ## Add a resource to a plugin
 
-Interactively add a new resource requirement to an existing plugin manifest:
+Interactively add a new resource requirement to an existing plugin manifest. **Requires `manifest.json`** in the plugin directory (the command edits it in place; it does not modify `manifest.js`):
 
 ```bash
 npx @databricks/appkit plugin add-resource

package.json

@@ -62,7 +62,7 @@
     "plop": "^4.0.4",
     "publint": "^0.3.15",
     "release-it": "^19.1.0",
-    "tsdown": "^0.15.7",
+    "tsdown": "^0.20.3",
     "tsx": "^4.20.6",
     "turbo": "^2.6.1",
     "typescript": "^5.6.0",

packages/appkit-ui/tsdown.config.ts

@@ -9,12 +9,13 @@ export default defineConfig([
     platform: "browser",
     minify: false,
     dts: {
-      resolve: true,
+      resolver: "oxc",
     },
     copy: [
       {
         from: "src/react/styles/globals.css",
-        to: "dist/styles.css",
+        to: "dist",
+        rename: "styles.css",
       },
     ],
     clean: false,

packages/appkit/src/connectors/lakebase/index.ts

@@ -2,7 +2,7 @@ import {
   createLakebasePool as createLakebasePoolBase,
   type LakebasePoolConfig,
 } from "@databricks/lakebase";
-import type pg from "pg";
+import type { Pool } from "pg";
 import { createLogger } from "@/logging/logger";
 
 /**
@@ -12,9 +12,7 @@ import { createLogger } from "@/logging/logger";
  * @param config - Lakebase pool configuration
  * @returns PostgreSQL pool with appkit integration
  */
-export function createLakebasePool(
-  config?: Partial<LakebasePoolConfig>,
-): pg.Pool {
+export function createLakebasePool(config?: Partial<LakebasePoolConfig>): Pool {
   const logger = createLogger("connectors:lakebase");
 
   return createLakebasePoolBase({

packages/appkit/src/plugins/analytics/analytics.ts

@@ -14,8 +14,9 @@ import {
 } from "../../context";
 import { createLogger } from "../../logging/logger";
 import { Plugin, toPlugin } from "../../plugin";
+import type { PluginManifest } from "../../registry";
 import { queryDefaults } from "./defaults";
-import { analyticsManifest } from "./manifest";
+import manifest from "./manifest.json";
 import { QueryProcessor } from "./query";
 import type {
   AnalyticsQueryResponse,
@@ -29,7 +30,7 @@ export class AnalyticsPlugin extends Plugin {
   name = "analytics";
 
   /** Plugin manifest declaring metadata and resource requirements */
-  static manifest = analyticsManifest;
+  static manifest = manifest as PluginManifest;
 
   protected static description = "Analytics plugin for data analysis";
   protected declare config: IAnalyticsConfig;

packages/appkit/src/plugins/analytics/index.ts

@@ -1,3 +1,2 @@
 export * from "./analytics";
-export * from "./manifest";
 export * from "./types";

packages/appkit/src/plugins/analytics/manifest.ts

@@ -1,3 +1,2 @@
 export * from "./lakebase";
-export * from "./manifest";
 export * from "./types";