@f-ewald/components 1.1.1 → 1.2.1

package/dist/kanban-board.d.ts

@@ -0,0 +1,110 @@
+import { LitElement, type PropertyValues } from "lit";
+import "./kanban-column.js";
+import "./kanban-card.js";
+import "./popover-panel.js";
+import "./radio-pills.js";
+import "./relative-time.js";
+/** One card in a column. `id` is stable identity; everything else is display data. */
+export interface KanbanCardData {
+    /** Stable unique identifier used as the drag/move key. */
+    id: string;
+    /** Ticket identifier shown in the overview and detail, e.g. `"PROJ-142"`. */
+    ticket: string;
+    /** Card title shown in the overview and detail. */
+    title: string;
+    /** Longer description shown only in the detail popover. */
+    description?: string;
+    /** ISO 8601 / SQLite `datetime` string shown in the detail popover. */
+    createdAt?: string;
+    /** ISO 8601 / SQLite `datetime` string shown in the detail popover. */
+    updatedAt?: string;
+}
+/** One column: its `id`, header `title`, and ordered `cards`. The column is the card's state. */
+export interface KanbanColumnData {
+    /** Stable unique identifier, also the card's state value. */
+    id: string;
+    /** Column title shown in the header and the detail state selector. */
+    title: string;
+    /** Cards in display order. */
+    cards: KanbanCardData[];
+}
+/** `card-move` detail: which card moved, and where from/to (`toIndex` is its final index in `toColumnId`). */
+export interface KanbanCardMoveDetail {
+    cardId: string;
+    fromColumnId: string;
+    toColumnId: string;
+    toIndex: number;
+}
+/** `card-open` detail: the card whose detail view was opened. */
+export interface KanbanCardOpenDetail {
+    cardId: string;
+}
+/**
+ * A configurable kanban board: a horizontally scrolling row of columns, each
+ * holding cards. **A card's column is its state** — moving a card to another
+ * column (by drag-and-drop, keyboard, or the detail popover's state selector)
+ * changes its state, and the board emits a single `card-move` for all three.
+ *
+ * Data-driven: set the `columns` property to `KanbanColumnData[]`. The board
+ * keeps its own working copy and mutates it optimistically on every move, so it
+ * works standalone; re-assign `columns` at any time to stay controlled from a
+ * store. Cards show only their ticket number and title in the overview; the
+ * full detail (description, state, created/updated timestamps) opens in a
+ * screen-centered `popover-panel`.
+ *
+ * Pointer drag-and-drop supports both cross-column moves and within-column
+ * reordering with a live drop indicator (set `reorderable` false to keep only
+ * cross-column moves when intra-column order isn't persisted). Keyboard parity:
+ * focus a card and press Space to pick it up, arrow keys to move it (left/right
+ * across columns, up/down within a column), Space to drop, or Escape to cancel;
+ * Enter opens the detail. Moves are announced in a polite live region, and the
+ * moved card briefly flashes a warm highlight so you can see where it landed.
+ *
+ * Set `manual` for a server-authoritative board (API + WebSocket/SSE): every
+ * move still emits `card-move`, but the board does NOT apply it locally, so it
+ * reflects only what you assign to `columns` — e.g. the change echoed back over
+ * the socket. The default is optimistic local updates.
+ *
+ * @element kanban-board
+ * @fires card-open - A card's detail view was opened; detail: { cardId }.
+ * @fires card-move - A card changed column/position; detail: { cardId, fromColumnId, toColumnId, toIndex }.
+ */
+export declare class KanbanBoard extends LitElement {
+    #private;
+    /** Columns (with their cards) to render, in display order. */
+    columns: KanbanColumnData[];
+    /** Accessible label for the board's group role. */
+    label: string;
+    /**
+     * Server-authoritative mode. When true, moves emit `card-move` but are not
+     * applied to the board locally; it reflects only what you assign to
+     * `columns` (e.g. echoed back over WebSocket/SSE), keeping the server as the
+     * single source of truth. Defaults to optimistic local updates.
+     */
+    manual: boolean;
+    /**
+     * Whether cards can be reordered within a column. Defaults to true. Set false
+     * when intra-column order isn't persisted (no server `rank`): drag and
+     * keyboard still move cards *between* columns (appended to the target), but
+     * reordering inside a column is disabled, so the UI only offers what sticks.
+     */
+    reorderable: boolean;
+    private _cols;
+    private _openCardId;
+    private _drag;
+    private _pointer;
+    private _grab;
+    private _liveMessage;
+    private _highlighted;
+    static styles: import("lit").CSSResult[];
+    protected willUpdate(changed: PropertyValues): void;
+    protected updated(): void;
+    disconnectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "kanban-board": KanbanBoard;
+    }
+}
+//# sourceMappingURL=kanban-board.d.ts.map

package/dist/kanban-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban-board.d.ts","sourceRoot":"","sources":["../src/kanban-board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1E,OAAO,oBAAoB,CAAC;AAC5B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,kBAAkB,CAAC;AAC1B,OAAO,oBAAoB,CAAC;AAE5B,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iGAAiG;AACjG,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,8GAA8G;AAC9G,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,WAAY,SAAQ,UAAU;;IACzC,8DAA8D;IAC9B,OAAO,EAAE,gBAAgB,EAAE,CAAM;IACjE,mDAAmD;IACvC,KAAK,SAAW;IAC5B;;;;;OAKG;IACyC,MAAM,UAAS;IAC3D;;;;;OAKG;IACyC,WAAW,UAAQ;IAEtD,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,YAAY,CAAqB;IAMlD,OAAgB,MAAM,4BA6FpB;IAEF,UAAmB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAc3D;IAED,UAAmB,OAAO,IAAI,IAAI,CAQjC;IAEQ,oBAAoB,IAAI,IAAI,CAOpC;IA6WQ,MAAM,yCAmBd;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,WAAW,CAAC;KAC7B;CACF"}