@gisce/ooui 2.40.0-alpha.5 → 2.40.0-alpha.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gisce/ooui",
-  "version": "2.40.0-alpha.5",
+  "version": "2.40.0-alpha.7",
   "engines": {
     "node": "20.5.0"
   },

package/src/Kanban.ts

@@ -65,6 +65,15 @@ class Kanban {
     return this._column_field;
   }
 
+  /**
+   * Domain for filtering columns (for many2one fields)
+   * Example: "[('fold', '!=', True)]"
+   */
+  _column_domain: string | null = null;
+  get column_domain(): string | null {
+    return this._column_domain;
+  }
+
   /**
    * Enable dragging cards between columns
    */
@@ -74,10 +83,10 @@ class Kanban {
   }
 
   /**
-   * Enable sorting cards within columns
+   * Field name to use for sorting cards within columns
    */
-  _sort: boolean = true;
-  get sort(): boolean {
+  _sort: string | undefined = undefined;
+  get sort(): string | undefined {
     return this._sort;
   }
 
@@ -134,15 +143,13 @@ class Kanban {
     }
 
     this._column_field = view.attributes.column_field || "state";
+    this._column_domain = view.attributes.column_domain || null;
 
     this._drag =
       view.attributes.drag !== undefined
         ? parseBoolAttribute(view.attributes.drag)
         : true;
-    this._sort =
-      view.attributes.sort !== undefined
-        ? parseBoolAttribute(view.attributes.sort)
-        : true;
+    this._sort = view.attributes.sort || undefined;
     this._set_max_cards =
       view.attributes.set_max_cards !== undefined
         ? parseBoolAttribute(view.attributes.set_max_cards)

package/src/KanbanCard.ts

@@ -0,0 +1,84 @@
+import WidgetFactory from "./WidgetFactory";
+import Container from "./Container";
+import Kanban from "./Kanban";
+import { evaluateButtonStates } from "./helpers/stateParser";
+import { evaluateAttributes } from "./helpers/attributeParser";
+import Button from "./Button";
+
+export type KanbanCardParseOptions = {
+  readOnly?: boolean;
+};
+
+class KanbanCard {
+  _kanbanDef: Kanban;
+  get kanbanDef(): Kanban {
+    return this._kanbanDef;
+  }
+
+  constructor(kanbanDef: Kanban) {
+    this._kanbanDef = kanbanDef;
+  }
+
+  parse(record: any, options?: KanbanCardParseOptions): Container {
+    const readOnly = options?.readOnly ?? false;
+    const container = new Container(1, 12, readOnly);
+    const widgetFactory = new WidgetFactory();
+    let keyIdx = 0;
+
+    this._kanbanDef.card_fields.forEach((field: any) => {
+      keyIdx++;
+
+      const evaluatedAttrs = evaluateAttributes({
+        tagAttributes: field.raw_props || {},
+        values: record,
+        fields: this._kanbanDef.fields,
+        widgetType: field.type || "field",
+      });
+
+      // Extract properties from the existing field widget
+      const widgetProps = {
+        ...(field.raw_props || {}),
+        ...evaluatedAttrs,
+        key: `field_${keyIdx}`,
+      };
+
+      if (readOnly) {
+        widgetProps.readonly = true;
+      }
+
+      // Determine widget type from the field
+      const widgetType = field.type || "field";
+      const widget = widgetFactory.createWidget(widgetType, widgetProps);
+      container.addWidget(widget, { addLabel: !field.nolabel });
+    });
+
+    // Add buttons to container
+    this._kanbanDef.buttons.forEach((button: any) => {
+      keyIdx++;
+
+      const evaluatedStates = button.states
+        ? evaluateButtonStates({
+            states: button.states,
+            values: record,
+          })
+        : {};
+
+      const buttonProps = {
+        ...(button.raw_props || {}),
+        ...evaluatedStates,
+        key: `button_${keyIdx}`,
+      };
+
+      if (readOnly) {
+        buttonProps.readonly = true;
+      }
+
+      const buttonWidget = new Button(buttonProps);
+      container.addWidget(buttonWidget, { addLabel: false });
+    });
+
+    return container;
+  }
+}
+
+export default KanbanCard;

package/src/index.ts

@@ -2,6 +2,7 @@ import Avatar from "./Avatar";
 import Form from "./Form";
 import Tree from "./Tree";
 import Kanban from "./Kanban";
+import KanbanCard from "./KanbanCard";
 import Char from "./Char";
 import Container from "./Container";
 import ContainerWidget from "./ContainerWidget";
@@ -89,6 +90,7 @@ export {
   Form,
   Tree,
   Kanban,
+  KanbanCard,
   NewLine,
   Boolean,
   One2many,

package/src/spec/Kanban.spec.ts

@@ -4,7 +4,7 @@ import Field from "../Field";
 import Button from "../Button";
 
 const XML_VIEW_KANBAN = `<?xml version="1.0"?>
-<kanban string="Tasks" column_field="state" drag="1" sort="1" set_max_cards="1" colors="blue:state=='draft';green:state=='done'">
+<kanban string="Tasks" column_field="state" drag="1" sort="sequence" set_max_cards="1" colors="blue:state=='draft';green:state=='done'">
   <field name="name"/>
   <field name="user_id" widget="avatar"/>
   <field name="planned_hours" sum="Total hours" widget="float_time"/>
@@ -20,8 +20,8 @@ const XML_VIEW_KANBAN_MINIMAL = `<?xml version="1.0"?>
 </kanban>
 `;
 
-const XML_VIEW_KANBAN_NO_DRAG_SORT = `<?xml version="1.0"?>
-<kanban column_field="state" drag="0" sort="0">
+const XML_VIEW_KANBAN_NO_DRAG = `<?xml version="1.0"?>
+<kanban column_field="state" drag="0">
   <field name="name"/>
   <field name="priority"/>
 </kanban>
@@ -97,7 +97,7 @@ describe("A Kanban", () => {
     expect(tree.string).toBe("Tasks");
     expect(tree.column_field).toBe("state");
     expect(tree.drag).toBe(true);
-    expect(tree.sort).toBe(true);
+    expect(tree.sort).toBe("sequence");
     expect(tree.set_max_cards).toBe(true);
     expect(tree.colors).toBe("blue:state=='draft';green:state=='done'");
   });
@@ -110,16 +110,16 @@ describe("A Kanban", () => {
     expect(tree.string).toBe(null);
     expect(tree.column_field).toBe("status");
     expect(tree.drag).toBe(true); // Default value
-    expect(tree.sort).toBe(true); // Default value
+    expect(tree.sort).toBeUndefined(); // No sort field specified
     expect(tree.set_max_cards).toBe(false); // Default value
   });
 
-  it("should parse drag and sort as false", () => {
+  it("should parse drag as false", () => {
     const tree = new Kanban(FIELDS);
-    tree.parse(XML_VIEW_KANBAN_NO_DRAG_SORT);
+    tree.parse(XML_VIEW_KANBAN_NO_DRAG);
 
     expect(tree.drag).toBe(false);
-    expect(tree.sort).toBe(false);
+    expect(tree.sort).toBeUndefined();
   });
 
   it("should fallback to 'state' when column_field is missing", () => {

package/src/spec/kanbanCard.spec.ts

@@ -0,0 +1,217 @@
+import { it, expect, describe } from "vitest";
+import Kanban from "../Kanban";
+import KanbanCard from "../KanbanCard";
+import Button from "../Button";
+import Field from "../Field";
+
+const XML_VIEW_KANBAN = `<?xml version="1.0"?>
+<kanban string="Tasks" column_field="state" drag="1">
+  <field name="name"/>
+  <field name="user_id" widget="avatar"/>
+  <field name="state"/>
+  <button name="do_open" type="object" string="Start" states="draft"/>
+  <button name="do_done" type="object" string="Complete" states="open,pending"/>
+  <button name="action_always" type="object" string="Always Visible"/>
+</kanban>
+`;
+
+const FIELDS = {
+  name: {
+    required: true,
+    size: 128,
+    string: "Task Summary",
+    type: "char",
+    views: {},
+  },
+  user_id: {
+    context: "",
+    domain: [],
+    relation: "res.users",
+    size: 64,
+    string: "Assigned to",
+    type: "many2one",
+    views: {},
+    widget: "avatar",
+  },
+  state: {
+    required: true,
+    readonly: true,
+    selection: [
+      ["draft", "Draft"],
+      ["open", "In Progress"],
+      ["pending", "Pending"],
+      ["cancelled", "Cancelled"],
+      ["done", "Done"],
+    ],
+    string: "State",
+    type: "selection",
+    views: {},
+  },
+};
+
+describe("A KanbanCard", () => {
+  it("should parse and create a Container", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      user_id: [1, "John Doe"],
+      state: "draft",
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record);
+
+    expect(container).toBeDefined();
+    expect(container.rows).toBeDefined();
+    expect(container.rows.length).toBeGreaterThan(0);
+  });
+
+  it("should show button when record state matches button states", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      state: "draft", // Matches states="draft" in do_open button
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record);
+
+    // Find all buttons in the container
+    const buttons = container.rows.flat().filter((w) => w instanceof Button);
+
+    // Find the "do_open" button
+    const doOpenButton = buttons.find((b) => b.id === "do_open");
+    expect(doOpenButton).toBeDefined();
+    expect(doOpenButton!.invisible).toBe(false);
+  });
+
+  it("should hide button when record state doesn't match button states", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      state: "open", // Does NOT match states="draft" in do_open button
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record);
+
+    // Find all buttons in the container
+    const buttons = container.rows.flat().filter((w) => w instanceof Button);
+
+    // Find the "do_open" button
+    const doOpenButton = buttons.find((b) => b.id === "do_open");
+    expect(doOpenButton).toBeDefined();
+    expect(doOpenButton!.invisible).toBe(true);
+  });
+
+  it("should always show button without states attribute", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      state: "done", // Any state
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record);
+
+    // Find all buttons in the container
+    const buttons = container.rows.flat().filter((w) => w instanceof Button);
+
+    // Find the "action_always" button (has no states attribute)
+    const alwaysButton = buttons.find((b) => b.id === "action_always");
+    expect(alwaysButton).toBeDefined();
+    expect(alwaysButton!.invisible).toBe(false);
+  });
+
+  it("should show button when state matches one of multiple comma-separated states", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      state: "pending", // Matches one of states="open,pending" in do_done button
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record);
+
+    const buttons = container.rows.flat().filter((w) => w instanceof Button);
+    const doDoneButton = buttons.find((b) => b.id === "do_done");
+    expect(doDoneButton).toBeDefined();
+    expect(doDoneButton!.invisible).toBe(false);
+  });
+
+  it("should add fields to container", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      user_id: [1, "John Doe"],
+      state: "draft",
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record);
+
+    // Find all fields in the container
+    const fields = container.rows.flat().filter((w) => w instanceof Field);
+
+    expect(fields.length).toBeGreaterThan(0);
+
+    // Check that the name field exists
+    const nameField = fields.find((f) => f.id === "name");
+    expect(nameField).toBeDefined();
+  });
+
+  it("should respect readOnly option", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      state: "draft",
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record, {
+      readOnly: true,
+    });
+
+    expect(container.readOnly).toBe(true);
+
+    // Check that buttons inherit readOnly
+    const buttons = container.rows.flat().filter((w) => w instanceof Button);
+    buttons.forEach((button) => {
+      expect(button.readOnly).toBe(true);
+    });
+  });
+
+  it("should handle record without state field gracefully", () => {
+    const kanbanDef = new Kanban(FIELDS);
+    kanbanDef.parse(XML_VIEW_KANBAN);
+
+    const record = {
+      id: 1,
+      name: "Test Task",
+      // state field is missing
+    };
+
+    const container = new KanbanCard(kanbanDef).parse(record);
+
+    // Should not throw error and should create container
+    expect(container).toBeDefined();
+
+    // Buttons should handle undefined state gracefully
+    const buttons = container.rows.flat().filter((w) => w instanceof Button);
+    expect(buttons.length).toBeGreaterThan(0);
+  });
+});