@lavalogic/scoria 0.37.2 → 0.37.4

package/dist/Components/Table/ColumnFactory.svelte.js

@@ -29,6 +29,7 @@ import { ExpandDef } from './Types/Columns/Definitions/Expand/ExpandDef.svelte.j
 import { FilterOnlyDef } from './Types/Columns/Definitions/FilterOnly/FilterOnlyDef.svelte.js';
 import { RowSelectionDef } from './Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.js';
 import { FilterValueType } from './Types/Filtering/FilterValueType.js';
+import { ToolbarPosition } from './Types/Toolbar/ToolbarPosition.js';
 import { scoriaStorageKey } from '../../Helpers/Helpers.svelte.js';
 // ─────────────────────────────────────────────────────────────────────────
 // Internal payload carried on every spec
@@ -307,12 +308,13 @@ export function createColumnFactory() {
             const childRowIdFn = typeof opts.childRowId === 'function'
                 ? opts.childRowId
                 : (inner) => inner[opts.childRowId];
+            const userIsEnabled = opts.isEnabled;
             const def = new ExpandDef({
                 id: mintSyntheticId('expand'),
                 header: opts.header ?? '',
-                isEnabled: () => true,
+                isEnabled: userIsEnabled ?? (() => true),
                 accessorFn: opts.childRows,
-                headerIcon: 'chevron-down',
+                headerIcon: opts.headerIcon ?? 'chevron-down',
                 innerTableName: scoriaStorageKey(opts.name),
                 getInnerColumnDefs: () => {
                     const innerFactory = createColumnFactory();
@@ -322,7 +324,14 @@ export function createColumnFactory() {
                 },
                 innerTableOptions: {
                     selectionExtractor: childRowIdFn,
-                    getUserId: () => undefined,
+                    getUserId: opts.inner?.getUserId ?? (() => undefined),
+                    toolbar: translateInnerToolbar(opts.inner?.toolbar),
+                    displayFooter: opts.inner?.showFooter,
+                    allowAdvancedFiltering: opts.inner?.allowAdvancedFilter,
+                    allowQuickFiltering: opts.inner?.allowQuickFilter,
+                    allowColumnReordering: opts.inner?.allowReorder,
+                    enableResize: opts.inner?.allowResize,
+                    allowCopy: opts.inner?.allowCopy,
                 },
             });
             return makeSpec('expand', def);
@@ -344,3 +353,25 @@ export function createColumnFactory() {
     };
     return factory;
 }
+/**
+ * Translate the public string-literal `inner.toolbar` option on
+ * `ExpandColumnOptions` into the internal `ToolbarPosition` enum used by
+ * `TableInitOptions`. Mirrors the outer-table translator in
+ * `createTable.svelte.ts`; kept local to the factory so the public API
+ * stays free of the enum.
+ */
+function translateInnerToolbar(toolbar) {
+    if (!toolbar) {
+        return undefined;
+    }
+    switch (toolbar) {
+        case 'top':
+            return ToolbarPosition.Top;
+        case 'right':
+            return ToolbarPosition.Right;
+        case 'left':
+            return ToolbarPosition.Left;
+        case 'none':
+            return ToolbarPosition.None;
+    }
+}

package/dist/Components/Table/Types/Public/ColumnFactory.d.ts

@@ -31,5 +31,5 @@ export interface ColumnFactory<TRow extends object> {
     rowSelection(options?: RowSelectionColumnOptions<TRow>): ColumnSpec<TRow, 'rowSelection'>;
     actions(options: ActionsColumnOptions<TRow>): ColumnSpec<TRow, 'actions'>;
     expand<TInner extends object, TInnerId extends Primitive = string>(options: ExpandColumnOptions<TRow, TInner, TInnerId>): ColumnSpec<TRow, 'expand'>;
-    filterOnly<K extends keyof TRow & string, TValue = TRow[K]>(options: FilterOnlyColumnOptions<TRow, K, TValue>): ColumnSpec<TRow, 'filterOnly'>;
+    filterOnly<K extends string = string, TValue = K extends keyof TRow & string ? TRow[K] : unknown>(options: FilterOnlyColumnOptions<TRow, K, TValue>): ColumnSpec<TRow, 'filterOnly'>;
 }

package/dist/Components/Table/Types/Public/ColumnOptions.d.ts

@@ -4,6 +4,7 @@ import type { CustomFilter } from '../Filtering/CustomFilter.js';
 import type { FilterValueType } from '../Filtering/FilterValueType.js';
 import type { Primitive } from '../Context/TableInitOptions.js';
 import type { BubbleColour } from '../../../BubbleColour.js';
+import type { IconProps } from '../../../IconProps.js';
 import type { SelectOption } from '../../../../Types/Internal/SelectOption.js';
 import type { ValidationFn } from '../Columns/Definitions/ValidationFn.js';
 import type { ColourSet } from '../../../../scss/colours.js';
@@ -224,6 +225,43 @@ export interface RowAction<TRow extends object> {
      *  this specific action when both are set. Async supported. */
     isEnabled?: (row: TRow) => boolean | Promise<boolean>;
 }
+/**
+ * Layout / behaviour options for the inner Table mounted inside an expanded
+ * row. Each field maps 1:1 onto the matching `CreateTableOptions` field that
+ * configures an outer Table; supply only the ones that should differ from the
+ * scoria defaults.
+ *
+ * Common per-table overrides flowms (and most consumers) need:
+ * - `toolbar: 'none'` to hide the toolbar on inner detail tables
+ * - `showFooter: false` to hide pagination on inner tables backed by an
+ *   already-bounded child collection
+ * - `getUserId` so inner-table preset persistence keys are namespaced per user
+ */
+export interface ExpandInnerTableOptions {
+    /** Inner-table toolbar position. Defaults to scoria's outer-table default
+     *  (`'right'`). Pass `'none'` to hide the toolbar entirely. */
+    toolbar?: 'top' | 'right' | 'left' | 'none';
+    /** Whether the inner table's pagination footer renders. Defaults to true. */
+    showFooter?: boolean;
+    /** Whether the inner table's advanced filter panel renders. Defaults to
+     *  the outer Table's default (`true`). */
+    allowAdvancedFilter?: boolean;
+    /** Whether the inner table's quick-filter input row renders. Defaults to
+     *  the outer Table's default (`true`). */
+    allowQuickFilter?: boolean;
+    /** Whether the inner table allows column reordering. Defaults to scoria's
+     *  outer-table default (`true`). */
+    allowReorder?: boolean;
+    /** Whether the inner table allows column resizing. Defaults to scoria's
+     *  outer-table default (`true`). */
+    allowResize?: boolean;
+    /** Whether the inner table allows clipboard copy. Defaults to scoria's
+     *  outer-table default (`true`). */
+    allowCopy?: boolean;
+    /** Returns the current user id for the inner table's persistence
+     *  namespacing. Defaults to `() => undefined` (no per-user keying). */
+    getUserId?: () => string | undefined;
+}
 /** Options for `col.expand({ name, childRows, childRowId, childColumns })`.
  *  Each row exposes an expand affordance that mounts an inner Table over
  *  the inner row collection. */
@@ -243,11 +281,40 @@ export interface ExpandColumnOptions<TRow extends object, TInner extends object,
     /** Inner column declarations. Builder closure receives a typed
      *  `ColumnFactory<TInner>`. */
     childColumns: (col: ColumnFactory<TInner>) => ReadonlyArray<ColumnSpec<TInner>>;
+    /**
+     * Icon rendered on the per-row expand toggle button. Defaults to
+     * `'chevron-down'`. Useful when the parent context needs a richer
+     * visual cue (e.g. `'list'` for an order-lines drill-down).
+     */
+    headerIcon?: IconProps['name'];
+    /**
+     * Per-row predicate for whether the expand affordance is enabled.
+     * When the predicate resolves to `false`, the toggle is rendered
+     * disabled (or hidden) so users cannot expand rows that have no
+     * inner content. Async supported. Defaults to `() => true`.
+     */
+    isEnabled?: (row: TRow, index: number) => boolean | Promise<boolean>;
+    /**
+     * Inner-table configuration. Each field maps 1:1 onto the equivalent
+     * `CreateTableOptions` field that configures an outer Table; supply
+     * only the ones that should differ from scoria's outer-table defaults.
+     * See {@link ExpandInnerTableOptions}.
+     */
+    inner?: ExpandInnerTableOptions;
 }
-/** Options for `col.filterOnly({ id, header, ... })`. Renders in the filter
- *  panel only; does not produce a body cell. Useful for surfacing a
- *  filterable field that should not occupy a column. */
-export interface FilterOnlyColumnOptions<TRow extends object, K extends keyof TRow & string, TValue = TRow[K]> extends Omit<BaseColumnOptions, 'allowSorting' | 'resizable' | 'minWidth' | 'width'> {
+/**
+ * Options for `col.filterOnly({ id, header, ... })`. Renders in the filter
+ * panel only; does not produce a body cell. Useful for surfacing a
+ * filterable field that should not occupy a column.
+ *
+ * `K` defaults to `string` so consumers can pass nested-path / server-only
+ * filter ids (e.g. `'orderLines.products.productTags.value'`) that are not
+ * direct keys of `TRow`. When `K` does narrow to a `keyof TRow & string`,
+ * `TValue` infers the corresponding row value type for the `customFilter`
+ * predicate; otherwise `TValue` defaults to `unknown`, which is the right
+ * shape for remote-only filters where the server resolves the field.
+ */
+export interface FilterOnlyColumnOptions<TRow extends object, K extends string = string, TValue = K extends keyof TRow & string ? TRow[K] : unknown> extends Omit<BaseColumnOptions, 'allowSorting' | 'resizable' | 'minWidth' | 'width'> {
     id: K;
     /** Filter value kind; drives which filter input is rendered. */
     filterValueType: FilterValueType;

package/dist/Components/Table/Types/Public/index.d.ts

@@ -8,7 +8,7 @@
 export type { AnyEditEvent } from './AnyEditEvent.js';
 export type { BaseColumnOptions } from './BaseColumnOptions.js';
 export type { ColumnFactory } from './ColumnFactory.js';
-export type { ActionsColumnOptions, BubbleColumnOptions, CheckboxColumnOptions, DateColumnOptions, DisplayColumnOptions, DisplayModalProps, ExpandColumnOptions, FilterOnlyColumnOptions, NumberColumnOptions, ProgressColumnOptions, QueryColumnOptions, RowAction, RowSelectionColumnOptions, SelectColumnOptions, TextColumnOptions, ValidityColumnOptions, } from './ColumnOptions.js';
+export type { ActionsColumnOptions, BubbleColumnOptions, CheckboxColumnOptions, DateColumnOptions, DisplayColumnOptions, DisplayModalProps, ExpandColumnOptions, ExpandInnerTableOptions, FilterOnlyColumnOptions, NumberColumnOptions, ProgressColumnOptions, QueryColumnOptions, RowAction, RowSelectionColumnOptions, SelectColumnOptions, TextColumnOptions, ValidityColumnOptions, } from './ColumnOptions.js';
 export type { ColumnKind, ColumnSpec } from './ColumnSpec.js';
 export type { CreateTableOptions } from './CreateTableOptions.js';
 export type { BooleanKeyOf, DateKeyOf, LiteralRowIdKey, NumberKeyOf, StringKeyOf, } from './KeyConstraints.js';

package/dist/index.d.ts

@@ -104,7 +104,7 @@ export type { TabGroupButtonProps } from './Components/TabGroupButtonProps.js';
 export { default as Table, type TableProps } from './Components/Table/Table.svelte';
 export { createTable, customRows, localRows, remoteRows, } from './Components/Table/createTable.svelte.js';
 export type { ColumnSpecInternals } from './Components/Table/ColumnFactory.svelte.js';
-export type { ActionsColumnOptions, AnyEditEvent, BaseColumnOptions, BooleanKeyOf, BubbleColumnOptions, CheckboxColumnOptions, ClipboardApi, ColumnFactory as TableColumnFactory, ColumnKind, ColumnSpec, ColumnsApi, CreateTableOptions, CustomRowSource, DateColumnOptions, DateKeyOf, DisplayColumnOptions, DisplayModalProps, ExpandColumnOptions, FilterOnlyColumnOptions, FilteringApi, FocusApi, LiteralRowIdKey, LocalRowSource, ModalApi, NumberColumnOptions, NumberKeyOf, PaginationApi, PreferencesApi, ProgressColumnOptions, QueryColumnOptions, RemoteRowSource, RowAction, RowFetchRequest, RowFetchResponse, RowSelectionColumnOptions, RowSource, SavedPreset, SelectColumnOptions, SelectionApi, SelectionOptions, SortingApi, StringKeyOf, Table as TableInstance, TableInitialState, TablePersistence, TablePersistenceObject, TableStorageAdapter, TextColumnOptions, ValidityColumnOptions, } from './Components/Table/Types/Public/index.js';
+export type { ActionsColumnOptions, AnyEditEvent, BaseColumnOptions, BooleanKeyOf, BubbleColumnOptions, CheckboxColumnOptions, ClipboardApi, ColumnFactory as TableColumnFactory, ColumnKind, ColumnSpec, ColumnsApi, CreateTableOptions, CustomRowSource, DateColumnOptions, DateKeyOf, DisplayColumnOptions, DisplayModalProps, ExpandColumnOptions, ExpandInnerTableOptions, FilterOnlyColumnOptions, FilteringApi, FocusApi, LiteralRowIdKey, LocalRowSource, ModalApi, NumberColumnOptions, NumberKeyOf, PaginationApi, PreferencesApi, ProgressColumnOptions, QueryColumnOptions, RemoteRowSource, RowAction, RowFetchRequest, RowFetchResponse, RowSelectionColumnOptions, RowSource, SavedPreset, SelectColumnOptions, SelectionApi, SelectionOptions, SortingApi, StringKeyOf, Table as TableInstance, TableInitialState, TablePersistence, TablePersistenceObject, TableStorageAdapter, TextColumnOptions, ValidityColumnOptions, } from './Components/Table/Types/Public/index.js';
 export { type CellCoordinates } from './Components/Table/Types/Coordinates/CellCoordinates.js';
 export { type ColumnPinningState } from './Components/Table/Types/Columns/ColumnPinningState.js';
 export { type ColumnSizingState } from './Components/Table/Types/Columns/ColumnSizingState.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lavalogic/scoria",
   "description": "Svelte components used for the FloWMS Web Frontend",
-  "version": "0.37.2",
+  "version": "0.37.4",
   "publishConfig": {
     "access": "restricted"
   },