@danxbot/plugin-sdk 0.1.6 → 0.2.1

package/dist/cli.js

@@ -5932,7 +5932,7 @@ ${output.trim()}`));
 }
 function isManifest(value) {
   const manifest = value;
-  return typeof manifest === "object" && manifest !== null && typeof manifest.entry === "string" && Array.isArray(manifest.files) && manifest.files.every((file) => typeof file?.path === "string");
+  return typeof manifest === "object" && manifest !== null && typeof manifest.entry === "string" && Array.isArray(manifest.exports) && Array.isArray(manifest.files) && manifest.files.every((file) => typeof file?.path === "string");
 }
 async function readBuiltPlugin(projectDir) {
   const distDir = join3(resolve2(projectDir), PLUGIN_DIST_DIR);
@@ -5942,7 +5942,7 @@ async function readBuiltPlugin(projectDir) {
   } catch (err) {
     throw new Error(`danx-plugin: the build left no readable ${PLUGIN_DIST_DIR}/${PLUGIN_MANIFEST_FILE} in ${projectDir} (is the danxPlugin() preset in vite.config?): ${err.message}`);
   }
-  if (!isManifest(manifest)) throw new Error(`danx-plugin: ${PLUGIN_DIST_DIR}/${PLUGIN_MANIFEST_FILE} in ${projectDir} has no entry or no files list of paths`);
+  if (!isManifest(manifest)) throw new Error(`danx-plugin: ${PLUGIN_DIST_DIR}/${PLUGIN_MANIFEST_FILE} in ${projectDir} has no entry, no exports list or no files list of paths`);
   const files = await Promise.all(manifest.files.map(async (file) => ({ path: file.path, bytes: await readFile2(join3(distDir, file.path)) })));
   return { manifest, files };
 }

package/dist/publish.d.ts

@@ -16,6 +16,8 @@ interface PluginManifestFile {
     /** Lowercase hex. */
     readonly sha256: string;
 }
+declare const PLUGIN_VIEW_EXPORTS: readonly ["CardView", "CardListView"];
+type PluginViewExport = (typeof PLUGIN_VIEW_EXPORTS)[number];
 interface PluginManifest {
     /** The ES module the app `import()`s, a `path` in `files`. */
     readonly entry: string;
@@ -25,6 +27,8 @@ interface PluginManifest {
     readonly screenshot?: string;
     /** Each shared library's major the plugin was built against (`PLUGIN_RUNTIME_LIBRARIES`), compared with what the app serves. */
     readonly runtime: Readonly<Record<string, number>>;
+    /** DX-5282: which view modules the entry exports (`PLUGIN_VIEW_EXPORTS`), recorded at build from the entry chunk's real exports; never empty. */
+    readonly exports: readonly PluginViewExport[];
     readonly files: readonly PluginManifestFile[];
 }
 

package/dist/publish.js

@@ -5927,7 +5927,7 @@ ${output.trim()}`));
 }
 function isManifest(value) {
   const manifest = value;
-  return typeof manifest === "object" && manifest !== null && typeof manifest.entry === "string" && Array.isArray(manifest.files) && manifest.files.every((file) => typeof file?.path === "string");
+  return typeof manifest === "object" && manifest !== null && typeof manifest.entry === "string" && Array.isArray(manifest.exports) && Array.isArray(manifest.files) && manifest.files.every((file) => typeof file?.path === "string");
 }
 async function readBuiltPlugin(projectDir) {
   const distDir = join3(resolve2(projectDir), PLUGIN_DIST_DIR);
@@ -5937,7 +5937,7 @@ async function readBuiltPlugin(projectDir) {
   } catch (err) {
     throw new Error(`danx-plugin: the build left no readable ${PLUGIN_DIST_DIR}/${PLUGIN_MANIFEST_FILE} in ${projectDir} (is the danxPlugin() preset in vite.config?): ${err.message}`);
   }
-  if (!isManifest(manifest)) throw new Error(`danx-plugin: ${PLUGIN_DIST_DIR}/${PLUGIN_MANIFEST_FILE} in ${projectDir} has no entry or no files list of paths`);
+  if (!isManifest(manifest)) throw new Error(`danx-plugin: ${PLUGIN_DIST_DIR}/${PLUGIN_MANIFEST_FILE} in ${projectDir} has no entry, no exports list or no files list of paths`);
   const files = await Promise.all(manifest.files.map(async (file) => ({ path: file.path, bytes: await readFile2(join3(distDir, file.path)) })));
   return { manifest, files };
 }

package/dist/vite.d.ts

@@ -14,7 +14,7 @@ interface DanxPluginOptions {
  * - Anything else is bundled. Bundling a copy of a shared package (`react-dom/client` or `react-router` are not in the contract) would run a second copy
  *   beside the app's, so that fails the build instead of shipping.
  * - Code-split chunks load by relative import from the entry's folder; CSS is emitted as one `index.css`.
- * - `danx-plugin.json` is written beside the output: every file's size and sha256, the entry, the stylesheets and the runtime majors.
+ * - `danx-plugin.json` is written beside the output: every file's size and sha256, the entry, the view modules it exports, the stylesheets and the runtime majors.
  */
 declare function danxPlugin(options?: DanxPluginOptions): Plugin;
 

package/dist/vite.js

@@ -33,6 +33,9 @@ import { join, relative, sep } from "node:path";
 
 // ../../src/plugins/plugin-manifest.ts
 var PLUGIN_MANIFEST_FILE = "danx-plugin.json";
+var CARD_VIEW_EXPORT = "CardView";
+var CARD_LIST_VIEW_EXPORT = "CardListView";
+var PLUGIN_VIEW_EXPORTS = [CARD_VIEW_EXPORT, CARD_LIST_VIEW_EXPORT];
 
 // src/manifest.ts
 function filesUnder(root, dir = root) {
@@ -46,18 +49,19 @@ function describeFile(root, file) {
     sha256: createHash("sha256").update(bytes).digest("hex")
   };
 }
-function buildManifest(outDir, entry) {
+function buildManifest(outDir, entry, exports) {
   const files = filesUnder(outDir).map((file) => describeFile(outDir, file)).filter((file) => file.path !== PLUGIN_MANIFEST_FILE);
   if (!files.some((file) => file.path === entry)) throw new Error(`danx-plugin: the build produced no entry module ${entry} in ${outDir}`);
   return {
     entry,
     styles: files.filter((file) => file.path.endsWith(".css")).map((file) => file.path),
     runtime: pluginRuntimeContract().majors,
+    exports: [...exports],
     files
   };
 }
-function writeManifest(outDir, entry) {
-  const manifest = buildManifest(outDir, entry);
+function writeManifest(outDir, entry, exports) {
+  const manifest = buildManifest(outDir, entry, exports);
   writeFileSync(join(outDir, PLUGIN_MANIFEST_FILE), `${JSON.stringify(manifest, null, 2)}
 `);
   return manifest;
@@ -72,6 +76,7 @@ function bundledNeverPackage(moduleId) {
 }
 function danxPlugin(options = {}) {
   const entry = options.entry ?? "src/index.tsx";
+  let viewExports = [];
   return {
     name: "danx-plugin",
     config() {
@@ -96,6 +101,14 @@ function danxPlugin(options = {}) {
       };
     },
     generateBundle(_options, bundle) {
+      const entryChunk = Object.values(bundle).find((output) => output.type === "chunk" && output.isEntry);
+      if (entryChunk?.type !== "chunk") throw new Error(`danx-plugin: the build produced no entry chunk for ${entry}`);
+      viewExports = PLUGIN_VIEW_EXPORTS.filter((name) => entryChunk.exports.includes(name));
+      if (viewExports.length === 0) {
+        throw new Error(
+          `danx-plugin: ${entry} must export ${PLUGIN_VIEW_EXPORTS.join(" and/or ")}, but it exports ${entryChunk.exports.length === 0 ? "nothing" : entryChunk.exports.join(", ")}.`
+        );
+      }
       for (const output of Object.values(bundle)) {
         if (output.type !== "chunk") continue;
         for (const id of output.moduleIds) {
@@ -109,7 +122,7 @@ function danxPlugin(options = {}) {
     },
     writeBundle(options2) {
       if (options2.dir === void 0) throw new Error("danx-plugin: the build has no output directory to write the manifest into");
-      writeManifest(options2.dir, PLUGIN_ENTRY_FILE);
+      writeManifest(options2.dir, PLUGIN_ENTRY_FILE, viewExports);
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/plugin-sdk",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "description": "SDK for building 50 Arms card-type plugins (DX-5170): the card kit's type declarations, a Vite preset that builds a plugin against the app's shared runtime and writes its manifest, and the danx-plugin CLI.",
   "license": "MIT",
   "type": "module",
@@ -46,7 +46,7 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@danxbot/ui": "26.20.0",
+    "@danxbot/ui": "26.23.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.2",
     "esbuild": "^0.25.0",