@guiexpert/demo-table-models 1.1.94 → 1.1.97

package/lib/createFormulaModel.d.ts

@@ -0,0 +1,32 @@
+import { ColumnDefIf, TableModelAndOptionsIf } from '@guiexpert/table';
+
+/** One line of an invoice – the data has no net, VAT or gross: formulas compute them. */
+export interface InvoiceLineIf {
+    id: number;
+    country: string;
+    product: string;
+    quantity: number;
+    price: number;
+    /** discount in percent (0, 5, 10, 15) */
+    discount: number;
+}
+/** Invoice lines with a fixed seed: the sales orders of the row grouping demo plus a discount. */
+export declare function generateInvoiceLines(count: number, seed?: number): InvoiceLineIf[];
+/** The formulas of the demo (also shown on the website). */
+export declare const INVOICE_FORMULAS: {
+    readonly net: "ROUND([quantity] * [price] * (1 - [discount] / 100), 2)";
+    readonly vat: "ROUND([net] * 0.19, 2)";
+    readonly gross: "[net] + [vat]";
+    readonly custom: "IF([discount] > 0, ROUND([gross] / [quantity], 2), \"–\")";
+};
+/** The columns: data (price and discount editable), formulas for net, VAT, gross, a share, a rank and a custom formula. */
+export declare function createInvoiceColumnDefs(customFormula?: string): ColumnDefIf[];
+/**
+ * Formula demo (since 1.1.95): invoice lines whose net, VAT and gross are formula columns (`ColumnDef.create({ formula })`),
+ * a share of the net total and a rank („Show values as“), a custom formula (change it with
+ * `tableApi.setColumnFormula("custom", text)`) and a total row (`footerAggregates` over the calculated columns).
+ * Price, quantity and discount are editable – the formulas follow.
+ *
+ * @param count - number of invoice lines (default 2,000)
+ */
+export declare function createFormulaModelAndOptions(count?: number): TableModelAndOptionsIf;

package/lib/createMasterDetailModel.d.ts

@@ -0,0 +1,24 @@
+import { TableModelAndOptionsIf, TableModelIf, MasterDetailOptionsIf } from '@guiexpert/table';
+import { MasterOrderIf } from '../model/master-order.if.js';
+
+/**
+ * `count` orders with 1 … 8 items each for master/detail demos (since 1.1.97). Fixed seed: the same count gives the
+ * same orders.
+ *
+ * @param count - number of orders (default 1000)
+ */
+export declare function generateMasterOrders(count?: number): MasterOrderIf[];
+/**
+ * The table model of the items of one order – the nested table of a detail row.
+ *
+ * @param order - the master row
+ */
+export declare function createOrderItemsModel(order: MasterOrderIf): TableModelIf;
+/**
+ * Master/detail demo (since 1.1.97): orders (the order number fixed on the left) – expand an order with the arrow
+ * (or Enter) and its items appear below as a second GuiExpert table over the full width.
+ *
+ * @param orders - the rows (default: 100.000 orders of {@link generateMasterOrders})
+ * @param masterDetail - overrides of the master/detail options (default: nested item table, 6 rows high)
+ */
+export declare function createMasterDetailModelAndOptions(orders?: MasterOrderIf[], masterDetail?: Partial<MasterDetailOptionsIf<MasterOrderIf>>): TableModelAndOptionsIf;

package/lib/createPriceListModel.d.ts

@@ -0,0 +1,20 @@
+import { TableModelAndOptionsIf, BatchEditOptionsIf, FillHandleOptionsIf } from '@guiexpert/table';
+import { PriceItemIf } from '../model/price-item.if.js';
+
+/**
+ * A fixed price list for fill handle and batch edit demos (since 1.1.96): `count` articles with SKU, product, category,
+ * valid-from date, price, discount and stock. The same count gives the same articles.
+ *
+ * @param count - number of articles (default 16)
+ */
+export declare function generatePriceItems(count?: number): PriceItemIf[];
+/**
+ * Fill handle and batch edit demo (since 1.1.96): a price list with range selection and the fill handle; price, discount,
+ * valid-from and stock are editable (and checked), "Net" is calculated (not filled). With `batchEdit` changes are
+ * collected until `tableApi.commitBatchEdit()` ("Save") or `cancelBatchEdit()` ("Discard").
+ *
+ * @param items - the rows (default: {@link generatePriceItems})
+ * @param batchEdit - collect changes (`tableOptions.batchEdit`), default `true`
+ * @param fillHandle - fill handle options, default `true`
+ */
+export declare function createPriceListModelAndOptions(items?: PriceItemIf[], batchEdit?: boolean | Partial<BatchEditOptionsIf>, fillHandle?: boolean | Partial<FillHandleOptionsIf>): TableModelAndOptionsIf;

package/lib/createRowDragModel.d.ts

@@ -0,0 +1,19 @@
+import { TableModelAndOptionsIf, RowDragOptionsIf } from '@guiexpert/table';
+import { TaskIf } from '../model/task.if.js';
+
+/**
+ * A fixed priority list for row drag demos (since 1.1.95): `count` tasks (title, owner, status, estimate in hours).
+ * The same count gives the same tasks; the first task is `locked` (no drag handle) when `withLocked` is true.
+ *
+ * @param count - number of tasks (default 20; titles repeat with a number above 20)
+ * @param withLocked - mark the first task as locked
+ */
+export declare function generateTasks(count?: number, withLocked?: boolean): TaskIf[];
+/**
+ * Row drag demo (since 1.1.95): a priority list with row numbers ("#" = the position), a drag handle in the title column
+ * (not for locked tasks), multi-row selection and focus. Drag a grip – or press Ctrl+Alt+↑/↓.
+ *
+ * @param tasks - the rows (default: {@link generateTasks}) – reordered in place by the table (managed)
+ * @param rowDragOptions - e.g. `{ managed: false }` for events only
+ */
+export declare function createRowDragModelAndOptions(tasks?: TaskIf[], rowDragOptions?: Partial<RowDragOptionsIf>): TableModelAndOptionsIf;

package/lib/createTimeTableModel.d.ts

@@ -55,5 +55,9 @@ export declare const tableOptions: {
     ariaDescribedBy?: string | undefined;
     ariaTexts?: Partial<import('@guiexpert/table').AriaTextsIf> | undefined;
     overlayOptions?: Partial<import('@guiexpert/table').OverlayOptionsIf> | undefined;
+    rowDragOptions?: Partial<import('@guiexpert/table').RowDragOptionsIf> | undefined;
+    fillHandle?: boolean | Partial<import('@guiexpert/table').FillHandleOptionsIf> | undefined;
+    masterDetail?: Partial<import('@guiexpert/table').MasterDetailOptionsIf<any>> | undefined;
+    batchEdit?: boolean | Partial<import('@guiexpert/table').BatchEditOptionsIf> | undefined;
 };
 export declare function createTimeTableModel(): TableModelIf;

package/lib/treepeople/generateTreePeopleModel.d.ts

@@ -18,6 +18,7 @@ export declare function createTreePeopleTableOptions(addDemoSelection?: boolean)
         autoRestoreColumnLayout: boolean;
         autoRestoreHeaderGroupState: boolean;
         autoRestoreCustomState: boolean;
+        autoRestoreDetailState: boolean;
         isSame: (r1: PersonIf, r2: PersonIf, options: import('@guiexpert/table').AutoRestoreOptionsIf<PersonIf>) => boolean;
         getRowId: (row: PersonIf) => string | number;
     };
@@ -55,6 +56,10 @@ export declare function createTreePeopleTableOptions(addDemoSelection?: boolean)
     ariaDescribedBy?: string | undefined;
     ariaTexts?: Partial<import('@guiexpert/table').AriaTextsIf> | undefined;
     overlayOptions?: Partial<import('@guiexpert/table').OverlayOptionsIf> | undefined;
+    rowDragOptions?: Partial<import('@guiexpert/table').RowDragOptionsIf> | undefined;
+    fillHandle?: boolean | Partial<import('@guiexpert/table').FillHandleOptionsIf> | undefined;
+    masterDetail?: Partial<import('@guiexpert/table').MasterDetailOptionsIf<any>> | undefined;
+    batchEdit?: boolean | Partial<import('@guiexpert/table').BatchEditOptionsIf> | undefined;
 };
 export declare function createTreePeopleColumnDefs(): ColumnDefIf[];
 export declare function createTreePeopleModelAndOptions(addDemoSelection?: boolean): TableModelAndOptionsIf;

package/model/master-order.if.d.ts

@@ -0,0 +1,19 @@
+/** One item of an order of the master/detail demo (since 1.1.97). */
+export interface MasterOrderItemIf {
+    sku: string;
+    product: string;
+    quantity: number;
+    unitPrice: number;
+}
+/** An order of the master/detail demo (since 1.1.97): the master row; its items are the detail. */
+export interface MasterOrderIf {
+    id: number;
+    orderNo: string;
+    customer: string;
+    city: string;
+    /** ISO date `YYYY-MM-DD` */
+    date: string;
+    status: string;
+    total: number;
+    items: MasterOrderItemIf[];
+}

package/model/price-item.if.d.ts

@@ -0,0 +1,13 @@
+/** An article of the price list demo (fill handle and batch edit, since 1.1.96). */
+export interface PriceItemIf {
+    id: number;
+    sku: string;
+    product: string;
+    category: string;
+    /** ISO date `YYYY-MM-DD` */
+    validFrom: string;
+    price: number;
+    /** percent, 0 … 50 */
+    discount: number;
+    stock: number;
+}

package/model/task.if.d.ts

@@ -0,0 +1,9 @@
+/** A task of the priority list demo (row drag, since 1.1.95). */
+export interface TaskIf {
+    id: number;
+    title: string;
+    owner: string;
+    status: "todo" | "doing" | "done";
+    estimate: number;
+    locked?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiexpert/demo-table-models",
-  "version": "1.1.94",
+  "version": "1.1.97",
   "license": "MIT",
   "author": "Dr. Marc Kronberg <info@gui.expert> (https://gui.expert)",
   "repository": {
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "tslib": "^2.3.0",
-    "@guiexpert/table": "^1.1.94"
+    "@guiexpert/table": "^1.1.97"
   },
   "devDependencies": {
     "@types/node": "^20.11.17",