kanban-lite 1.0.21 → 1.0.23

package/dist/sdk/index.mjs

@@ -270,6 +270,8 @@ var DEFAULT_CONFIG = {
   compactMode: false,
   markdownEditorMode: false,
   showDeletedColumn: false,
+  boardZoom: 100,
+  cardZoom: 100,
   port: 3e3,
   labels: {}
 };
@@ -320,6 +322,8 @@ function migrateConfigV1ToV2(raw) {
     compactMode: v1.compactMode,
     markdownEditorMode: v1.markdownEditorMode,
     showDeletedColumn: false,
+    boardZoom: 100,
+    cardZoom: 100,
     port: 3e3
   };
 }
@@ -397,7 +401,9 @@ function configToSettings(config) {
     markdownEditorMode: config.markdownEditorMode,
     showDeletedColumn: config.showDeletedColumn,
     defaultPriority: config.defaultPriority,
-    defaultStatus: config.defaultStatus
+    defaultStatus: config.defaultStatus,
+    boardZoom: config.boardZoom ?? 100,
+    cardZoom: config.cardZoom ?? 100
   };
 }
 function settingsToConfig(config, settings) {
@@ -411,7 +417,9 @@ function settingsToConfig(config, settings) {
     compactMode: settings.compactMode,
     showDeletedColumn: settings.showDeletedColumn,
     defaultPriority: settings.defaultPriority,
-    defaultStatus: settings.defaultStatus
+    defaultStatus: settings.defaultStatus,
+    boardZoom: settings.boardZoom,
+    cardZoom: settings.cardZoom
   };
 }
 
@@ -3071,6 +3079,7 @@ function renamed(from, to) {
     throw new Error("Function yaml." + from + " is removed in js-yaml 4. Use yaml." + to + " instead, which is now safe by default.");
   };
 }
+var JSON_SCHEMA = json;
 var load = loader.load;
 var loadAll = loader.loadAll;
 var dump = dumper.dump;
@@ -3109,48 +3118,26 @@ function parseFeatureFile(content, filePath) {
     return null;
   const frontmatter = frontmatterMatch[1];
   const rest = frontmatterMatch[2] || "";
-  const getValue = (key) => {
-    const match = frontmatter.match(new RegExp(`^${key}:\\s*(.*)$`, "m"));
-    if (!match)
+  let parsed;
+  try {
+    const loaded = load(frontmatter, { schema: JSON_SCHEMA });
+    if (!loaded || typeof loaded !== "object" || Array.isArray(loaded))
+      return null;
+    parsed = loaded;
+  } catch {
+    return null;
+  }
+  const str2 = (key) => {
+    const val = parsed[key];
+    if (val == null)
       return "";
-    const value = match[1].trim().replace(/^["']|["']$/g, "");
-    return value === "null" ? "" : value;
+    return String(val);
   };
-  const getArrayValue = (key) => {
-    const match = frontmatter.match(new RegExp(`^${key}:\\s*\\[([^\\]]*)\\]`, "m"));
-    if (!match)
+  const arr = (key) => {
+    const val = parsed[key];
+    if (!Array.isArray(val))
       return [];
-    return match[1].split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
-  };
-  const getMetadata = () => {
-    const lines = frontmatter.split("\n");
-    let metaStart = -1;
-    for (let j = 0; j < lines.length; j++) {
-      if (/^metadata:\s*$/.test(lines[j])) {
-        metaStart = j + 1;
-        break;
-      }
-    }
-    if (metaStart === -1)
-      return void 0;
-    const indentedLines = [];
-    for (let j = metaStart; j < lines.length; j++) {
-      if (/^\s/.test(lines[j]) || lines[j].trim() === "") {
-        indentedLines.push(lines[j]);
-      } else {
-        break;
-      }
-    }
-    if (indentedLines.length === 0)
-      return void 0;
-    try {
-      const parsed = load(indentedLines.join("\n"));
-      if (parsed && typeof parsed === "object")
-        return parsed;
-      return void 0;
-    } catch {
-      return void 0;
-    }
+    return val.filter((v) => v != null).map(String);
   };
   const sections = rest.split(/\n---\n/);
   let body = sections[0] || "";
@@ -3171,22 +3158,23 @@ ${section}`;
       i += 1;
     }
   }
-  const meta = getMetadata();
-  const actions = getArrayValue("actions");
+  const actions = arr("actions");
+  const rawMeta = parsed.metadata;
+  const meta = rawMeta != null && typeof rawMeta === "object" && !Array.isArray(rawMeta) ? rawMeta : void 0;
   return {
-    version: parseInt(getValue("version"), 10) || 0,
-    id: getValue("id") || extractIdFromFilename(filePath),
-    status: getValue("status") || "backlog",
-    priority: getValue("priority") || "medium",
-    assignee: getValue("assignee") || null,
-    dueDate: getValue("dueDate") || null,
-    created: getValue("created") || (/* @__PURE__ */ new Date()).toISOString(),
-    modified: getValue("modified") || (/* @__PURE__ */ new Date()).toISOString(),
-    completedAt: getValue("completedAt") || null,
-    labels: getArrayValue("labels"),
-    attachments: getArrayValue("attachments"),
+    version: typeof parsed.version === "number" ? parsed.version : parseInt(str2("version"), 10) || 0,
+    id: str2("id") || extractIdFromFilename(filePath),
+    status: str2("status") || "backlog",
+    priority: str2("priority") || "medium",
+    assignee: parsed.assignee != null ? String(parsed.assignee) : null,
+    dueDate: parsed.dueDate != null ? String(parsed.dueDate) : null,
+    created: str2("created") || (/* @__PURE__ */ new Date()).toISOString(),
+    modified: str2("modified") || (/* @__PURE__ */ new Date()).toISOString(),
+    completedAt: parsed.completedAt != null ? String(parsed.completedAt) : null,
+    labels: arr("labels"),
+    attachments: arr("attachments"),
     comments,
-    order: getValue("order") || "a0",
+    order: str2("order") || "a0",
     content: body.trim(),
     ...meta ? { metadata: meta } : {},
     ...actions.length > 0 ? { actions } : {},
@@ -3194,37 +3182,28 @@ ${section}`;
   };
 }
 function serializeFeature(feature) {
-  const lines = [
-    "---",
-    `version: ${feature.version ?? CARD_FORMAT_VERSION}`,
-    `id: "${feature.id}"`,
-    `status: "${feature.status}"`,
-    `priority: "${feature.priority}"`,
-    `assignee: ${feature.assignee ? `"${feature.assignee}"` : "null"}`,
-    `dueDate: ${feature.dueDate ? `"${feature.dueDate}"` : "null"}`,
-    `created: "${feature.created}"`,
-    `modified: "${feature.modified}"`,
-    `completedAt: ${feature.completedAt ? `"${feature.completedAt}"` : "null"}`,
-    `labels: [${feature.labels.map((l) => `"${l}"`).join(", ")}]`,
-    `attachments: [${(feature.attachments || []).map((a) => `"${a}"`).join(", ")}]`,
-    `order: "${feature.order}"`
-  ];
-  if (feature.actions && feature.actions.length > 0) {
-    lines.push(`actions: [${feature.actions.map((a) => `"${a}"`).join(", ")}]`);
-  }
-  if (feature.metadata && Object.keys(feature.metadata).length > 0) {
-    const metaYaml = dump(feature.metadata, { indent: 2, lineWidth: -1 });
-    lines.push("metadata:");
-    for (const line of metaYaml.trimEnd().split("\n")) {
-      lines.push("  " + line);
-    }
-  }
-  lines.push("---");
-  lines.push("");
-  const frontmatter = lines.join("\n");
-  let result = frontmatter + feature.content;
-  const comments = feature.comments || [];
-  for (const comment of comments) {
+  const frontmatterObj = {
+    version: feature.version ?? CARD_FORMAT_VERSION,
+    id: feature.id,
+    status: feature.status,
+    priority: feature.priority,
+    assignee: feature.assignee ?? null,
+    dueDate: feature.dueDate ?? null,
+    created: feature.created,
+    modified: feature.modified,
+    completedAt: feature.completedAt ?? null,
+    labels: feature.labels,
+    attachments: feature.attachments || [],
+    order: feature.order,
+    ...feature.actions?.length ? { actions: feature.actions } : {},
+    ...feature.metadata && Object.keys(feature.metadata).length > 0 ? { metadata: feature.metadata } : {}
+  };
+  const yamlStr = dump(frontmatterObj, { lineWidth: -1, quotingType: '"', forceQuotes: true });
+  let result = `---
+${yamlStr}---
+
+${feature.content}`;
+  for (const comment of feature.comments || []) {
     result += "\n\n---\n";
     result += `comment: true
 `;
@@ -4217,25 +4196,28 @@ var KanbanSDK = class {
     writeConfig(this.workspaceRoot, config);
   }
   /**
-   * Removes a label definition from the workspace configuration.
-   *
-   * This only removes the color/group definition — cards that use this
-   * label keep their label strings. Those labels will render with default
-   * gray styling in the UI.
+   * Removes a label definition from the workspace configuration and cascades
+   * the deletion to all cards by removing the label from their `labels` array.
    *
    * @param name - The label name to remove.
    *
    * @example
    * ```ts
-   * sdk.deleteLabel('bug')
+   * await sdk.deleteLabel('bug')
    * ```
    */
-  deleteLabel(name) {
+  async deleteLabel(name) {
     const config = readConfig(this.workspaceRoot);
     if (config.labels) {
       delete config.labels[name];
       writeConfig(this.workspaceRoot, config);
     }
+    const cards = await this.listCards();
+    for (const card of cards) {
+      if (card.labels.includes(name)) {
+        await this.updateCard(card.id, { labels: card.labels.filter((l) => l !== name) });
+      }
+    }
   }
   /**
    * Renames a label in the configuration and cascades the change to all cards.
@@ -4660,6 +4642,57 @@ var KanbanSDK = class {
     this.emitEvent("column.deleted", removed);
     return board.columns;
   }
+  /**
+   * Moves all cards in the specified column to the `deleted` (soft-delete) column.
+   *
+   * This is a non-destructive operation — cards are moved to the reserved
+   * `deleted` status and can be restored or permanently deleted later.
+   * The column itself is not removed.
+   *
+   * @param columnId - The ID of the column whose cards should be moved to `deleted`.
+   * @param boardId - Optional board ID. Defaults to the workspace's default board.
+   * @returns A promise resolving to the number of cards that were moved.
+   * @throws {Error} If the column is `'deleted'` (no-op protection).
+   *
+   * @example
+   * ```ts
+   * const moved = await sdk.cleanupColumn('blocked')
+   * console.log(`Moved ${moved} cards to deleted`)
+   * ```
+   */
+  async cleanupColumn(columnId, boardId) {
+    if (columnId === DELETED_STATUS_ID)
+      return 0;
+    const cards = await this.listCards(void 0, boardId);
+    const cardsToMove = cards.filter((c) => c.status === columnId);
+    for (const card of cardsToMove) {
+      await this.moveCard(card.id, DELETED_STATUS_ID, 0, boardId);
+    }
+    return cardsToMove.length;
+  }
+  /**
+   * Permanently deletes all cards currently in the `deleted` column.
+   *
+   * This is equivalent to "empty trash". All soft-deleted cards are
+   * removed from disk. This operation cannot be undone.
+   *
+   * @param boardId - Optional board ID. Defaults to the workspace's default board.
+   * @returns A promise resolving to the number of cards that were permanently deleted.
+   *
+   * @example
+   * ```ts
+   * const count = await sdk.purgeDeletedCards()
+   * console.log(`Permanently deleted ${count} cards`)
+   * ```
+   */
+  async purgeDeletedCards(boardId) {
+    const cards = await this.listCards(void 0, boardId);
+    const deleted = cards.filter((c) => c.status === DELETED_STATUS_ID);
+    for (const card of deleted) {
+      await this.permanentlyDeleteCard(card.id, boardId);
+    }
+    return deleted.length;
+  }
   /**
    * Reorders the columns of a board.
    *

package/dist/sdk/sdk/KanbanSDK.d.ts

@@ -484,20 +484,17 @@ export declare class KanbanSDK {
      */
     setLabel(name: string, definition: LabelDefinition): void;
     /**
-     * Removes a label definition from the workspace configuration.
-     *
-     * This only removes the color/group definition — cards that use this
-     * label keep their label strings. Those labels will render with default
-     * gray styling in the UI.
+     * Removes a label definition from the workspace configuration and cascades
+     * the deletion to all cards by removing the label from their `labels` array.
      *
      * @param name - The label name to remove.
      *
      * @example
      * ```ts
-     * sdk.deleteLabel('bug')
+     * await sdk.deleteLabel('bug')
      * ```
      */
-    deleteLabel(name: string): void;
+    deleteLabel(name: string): Promise<void>;
     /**
      * Renames a label in the configuration and cascades the change to all cards.
      *
@@ -754,6 +751,41 @@ export declare class KanbanSDK {
      * ```
      */
     removeColumn(columnId: string, boardId?: string): Promise<KanbanColumn[]>;
+    /**
+     * Moves all cards in the specified column to the `deleted` (soft-delete) column.
+     *
+     * This is a non-destructive operation — cards are moved to the reserved
+     * `deleted` status and can be restored or permanently deleted later.
+     * The column itself is not removed.
+     *
+     * @param columnId - The ID of the column whose cards should be moved to `deleted`.
+     * @param boardId - Optional board ID. Defaults to the workspace's default board.
+     * @returns A promise resolving to the number of cards that were moved.
+     * @throws {Error} If the column is `'deleted'` (no-op protection).
+     *
+     * @example
+     * ```ts
+     * const moved = await sdk.cleanupColumn('blocked')
+     * console.log(`Moved ${moved} cards to deleted`)
+     * ```
+     */
+    cleanupColumn(columnId: string, boardId?: string): Promise<number>;
+    /**
+     * Permanently deletes all cards currently in the `deleted` column.
+     *
+     * This is equivalent to "empty trash". All soft-deleted cards are
+     * removed from disk. This operation cannot be undone.
+     *
+     * @param boardId - Optional board ID. Defaults to the workspace's default board.
+     * @returns A promise resolving to the number of cards that were permanently deleted.
+     *
+     * @example
+     * ```ts
+     * const count = await sdk.purgeDeletedCards()
+     * console.log(`Permanently deleted ${count} cards`)
+     * ```
+     */
+    purgeDeletedCards(boardId?: string): Promise<number>;
     /**
      * Reorders the columns of a board.
      *

package/dist/sdk/shared/config.d.ts

@@ -78,6 +78,10 @@ export interface KanbanConfig {
     markdownEditorMode: boolean;
     /** Whether to show the deleted column in the UI. */
     showDeletedColumn: boolean;
+    /** Zoom level for the board view (75–150). */
+    boardZoom: number;
+    /** Zoom level for the card detail panel (75–150). */
+    cardZoom: number;
     /** Port number for the standalone HTTP server. */
     port: number;
     /** Registered webhook endpoints for event notifications. */

package/dist/sdk/shared/types.d.ts

@@ -209,6 +209,10 @@ export interface CardDisplaySettings {
     defaultPriority: Priority;
     /** The default column/status assigned to newly created cards. */
     defaultStatus: string;
+    /** Zoom level for the board view as a percentage (75–150). Default 100. */
+    boardZoom: number;
+    /** Zoom level for the card detail panel as a percentage (75–150). Default 100. */
+    cardZoom: number;
 }
 export interface LabelDefinition {
     color: string;