@danxbot/plugin-sdk 0.1.6 → 0.2.2

package/dist/card-kit.d.ts

@@ -8,7 +8,7 @@ declare module "@danxbot/card-kit@1" {
 
   type IssueStatus$1 = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
   type EffortLevelName = "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
-  type IssueProblemType = "question" | "action";
+  type IssueAuthoredProblemType = "question" | "action";
   type DecisionOutcome = "answered" | "rejected";
   type IssueDependencyKind = "depends_on" | "conflict_on";
   type IssueDispatchKind = "work" | "triage" | "recovery" | "flesh-out" | "chat" | "main-sync-repair" | "worktree-maintenance" | "manual" | `gate-${string}`;
@@ -381,7 +381,7 @@ declare module "@danxbot/card-kit@1" {
   interface V2CopyProblem {
       statement: string;
       context: string | null;
-      type: IssueProblemType;
+      type: IssueAuthoredProblemType;
       summary: string | null;
       removed: boolean;
       solutions: V2CopySolution[];
@@ -799,42 +799,14 @@ declare module "@danxbot/card-kit@1" {
     phase: "plan" | "code";
   };
   type ProblemViewV2 = {
-    id: number;
-    issue_id: string;
+    type: "question" | "action" | "design";
+    open: boolean;
     ordinal: number;
-    statement: string;
-    context: null | string;
-    type: "question" | "action";
-    summary: null | string;
-    content_hash: string;
+    id: number;
     created_at: string;
     updated_at: string;
-    feedback_consent: boolean;
-    open: boolean;
-    solutions: Array<{
-    id: number;
-    problem_id: number;
-    removed: boolean;
-    title: string;
-    body: string;
-    pro: string;
-    con: string;
-    recommended: boolean;
     content_hash: string;
-    steps_hash: string;
-    steps: Array<{
-    id: number;
-    solution_id: number;
-    parent_step_id: null | number;
-    label: string;
-    title: string;
-    description: null | string;
-    content_hash: string;
-    checked_at: null | string;
-    checked_by: null | string;
-    steps: Array<SolutionStepViewV2>;
-  }>;
-  }>;
+    summary: null | string;
     decisions: Array<{
     id: number;
     problem_id: number;
@@ -849,17 +821,19 @@ declare module "@danxbot/card-kit@1" {
     relayed_by_session: null | string;
     content_hash: string;
   }>;
+    feedback_consent: boolean;
+    choice_locked: boolean;
+    issue_id: string;
+    statement: string;
+    context: null | string;
+    solutions: Array<SolutionViewV2>;
   };
   type SolutionViewV2 = {
+    title: string;
     id: number;
+    content_hash: string;
     problem_id: number;
-    removed: boolean;
-    title: string;
     body: string;
-    pro: string;
-    con: string;
-    recommended: boolean;
-    content_hash: string;
     steps_hash: string;
     steps: Array<{
     id: number;
@@ -873,6 +847,40 @@ declare module "@danxbot/card-kit@1" {
     checked_by: null | string;
     steps: Array<SolutionStepViewV2>;
   }>;
+    removed: boolean;
+    pro: string;
+    con: string;
+    recommended: boolean;
+    design?: undefined | (Array<{
+    design_no: number;
+    title: string;
+    created_by: string;
+    created_at: string;
+    review_state: "rejected" | "awaiting_review" | "changes_requested" | "approved";
+    revision_count: number;
+    latest_revision_no: number;
+    revisions?: undefined | (Array<{
+    revision_no: number;
+    target: string;
+    entry: string;
+    built_from_commit: string;
+    note: string;
+    created_by: string;
+    created_at: string;
+    bundle_bytes: null | number;
+    bundle_available: boolean;
+    screenshot_available: boolean;
+    source_files?: undefined | Array<DesignSourceFile>;
+  }>);
+    decisions?: undefined | (Array<{
+    decision_id: number;
+    revision_no: number;
+    outcome: "rejected" | "changes_requested" | "approved";
+    note: null | string;
+    decided_by: string;
+    created_at: string;
+  }>);
+  }>);
   };
   interface SolutionStepViewV2 {
       id: number;
@@ -1040,6 +1048,7 @@ declare module "@danxbot/card-kit@1" {
       solutions: SolutionViewV2[];
       removedSolutionIds: ReadonlySet<number>;
       decisions: DecisionViewV2[];
+      choiceLocked: boolean;
   }
 
   function ProblemsSection({ cardId, problems, comments, canAnswer, mutation, }: {

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.2",
   "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",