@lavalogic/scoria 0.35.0 → 0.37.0

package/dist/Components/Table/Body/Rows/Columns/TableColumn.svelte

@@ -1,144 +1,159 @@
-<svelte:options runes />
-
-<script
-	lang="ts"
-	module
->
-	import { ExpandDef } from '../../../Types/Columns/Definitions/Expand/ExpandDef.svelte.js';
-	import { DisplayType } from '../../../Types/Columns/DisplayType.js';
-	import type { TableCell } from '../../../Types/Columns/TableCell.js';
-	import type { Component, Snippet } from 'svelte';
-	import ActionsCell from './ActionsCell.svelte';
-	import BubbleCell from './BubbleCell.svelte';
-	import ExpandCell from './ExpandCell.svelte';
-	import FocusableImmutableCell from './FocusableImmutableCell.svelte';
-
-	import { ColumnType } from '../../../Types/Columns/ColumnType.js';
-	import { ActionsDef } from '../../../Types/Columns/Definitions/Actions/ActionsDef.svelte.js';
-	import { AbstractDisplayDef } from '../../../Types/Columns/Definitions/Display/AbstractDisplayDef.svelte.js';
-	import { ProgressBarDef } from '../../../Types/Columns/Definitions/Display/ProgressBarDef.svelte.js';
-	import type { ExpandTableCell } from '../../../Types/Columns/ExpandTableCell.js';
-	import type { ProgressBarTableCell } from '../../../Types/Columns/ProgressBarTableCell.js';
-	import { getErrorMessage } from '../../../../../Helpers/Helpers.svelte.js';
-	import AccessorComponent from './AccessorComponent.svelte';
-	import type { ActionsTableCell } from './ActionsTableCell.js';
-	import ProgressCell from './ProgressCell.svelte';
-	import TableRowSelectionCheckbox from './TableRowSelectionCheckbox.svelte';
-	import ValidityCell from './ValidityCell.svelte';
-
-	export interface TableColumnProps<T extends object> {
-		cell: TableCell<T>;
-		expandedColumnDef: ExpandDef<T, object> | undefined;
-		onExpandChange: (columnDef: ExpandDef<T, object>) => void;
-	}
-
-	function isProgressBarTableCell<T extends object>(
-		cell: TableCell<T>
-	): cell is ProgressBarTableCell<T, unknown> {
-		return cell.column.columnDef instanceof ProgressBarDef;
-	}
-</script>
-
-<script
-	lang="ts"
-	generics="T extends object"
->
-	import { dev } from '$app/environment';
-	import { RowSelectionDef } from '../../../Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.js';
-	import type { Primitive } from '../../../Types/Context/TableInitOptions.js';
-	import type { RowSelectionTableCell } from './RowSelectionTableCell.js';
-
-	let { cell, expandedColumnDef, onExpandChange }: TableColumnProps<T> = $props();
-
-	function isRowSelectionCell<T extends object>(
-		cell: TableCell<T>
-	): cell is RowSelectionTableCell<T> {
-		return cell.column.columnDef instanceof RowSelectionDef;
-	}
-	function valueOrComponentIsConstructor(
-		valueOrComponent: unknown
-		// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	): valueOrComponent is Component<any> {
-		return typeof valueOrComponent === 'function';
-	}
-
-	function isActionsDef(cell: TableCell<T>): cell is ActionsTableCell<T, unknown> {
-		return cell.column.columnDef instanceof ActionsDef;
-	}
-	function isExpandTableCell(
-		cell: TableCell<T>
-	): cell is ExpandTableCell<T, object, Primitive, unknown> {
-		return cell.column.columnDef instanceof ExpandDef;
-	}
-
-	function isSnippet(value: unknown): value is Snippet<[TableCell<T>]> {
-		return !!value && typeof value == 'function';
-	}
-</script>
-
-{#if cell.column.getIsVisible()}
-	{@const columnDef = cell.column.columnDef}
-
-	{#if isRowSelectionCell(cell)}
-		<TableRowSelectionCheckbox {cell} />
-	{:else if isActionsDef(cell)}
-		<ActionsCell {cell} />
-	{:else if isExpandTableCell(cell)}
-		<ExpandCell
-			{cell}
-			{expandedColumnDef}
-			{onExpandChange}
-		/>
-	{:else if columnDef.columnType !== ColumnType.Display}
-		<AccessorComponent {cell} />
-	{:else if cell.column.columnDef instanceof AbstractDisplayDef}
-		{#if cell.column.columnDef.displayType === DisplayType.Bubbles}
-			<BubbleCell {cell} />
-		{:else if cell.column.columnDef.displayType === DisplayType.Validity}
-			<ValidityCell {cell} />
-		{:else if isProgressBarTableCell(cell)}
-			<ProgressCell {cell} />
-		{:else if cell.column.columnDef.displayType === DisplayType.Normal}
-			<FocusableImmutableCell {cell} />
-		{:else}
-			{#if dev}
-				<!-- eslint-disable-next-line svelte/no-at-debug-tags -->
-				{@debug cell}
-			{/if}
-			Unknown Cell Type
-		{/if}
-	{:else}
-		{@const valueOrComponentPromise =
-			cell.column.columnDef.accessorFn?.(cell.row.original, cell.row.originalIndex) ??
-			cell.row.original[cell.column.id as keyof typeof cell.row.original]}
-
-		{#await valueOrComponentPromise}
-			<FocusableImmutableCell {cell} />
-		{:then Value}
-			{#if typeof Value === 'string' || typeof Value == 'number'}
-				<FocusableImmutableCell {cell} />
-			{:else if valueOrComponentIsConstructor(Value)}
-				<FocusableImmutableCell {cell}>
-					<Value {cell} />
-				</FocusableImmutableCell>
-			{:else if isSnippet(Value)}
-				<FocusableImmutableCell {cell}>
-					<!-- eslint-disable-next-line @typescript-eslint/no-unsafe-call -->
-					{@render Value(cell)}
-				</FocusableImmutableCell>
-			{:else}
-				{#if dev}
-					<!-- eslint-disable-next-line svelte/no-at-debug-tags -->
-					{@debug cell}
-					<!-- eslint-disable-next-line svelte/no-at-debug-tags -->
-					{@debug Value}
-				{/if}
-				Unknown Cell or value Type
-			{/if}
-		{:catch e}
-			<FocusableImmutableCell {cell}>
-				{getErrorMessage(e)}
-			</FocusableImmutableCell>
-		{/await}
-	{/if}
-{/if}
+<svelte:options runes />
+
+<script
+	lang="ts"
+	module
+>
+	import { ExpandDef } from '../../../Types/Columns/Definitions/Expand/ExpandDef.svelte.js';
+	import { DisplayType } from '../../../Types/Columns/DisplayType.js';
+	import type { TableCell } from '../../../Types/Columns/TableCell.js';
+	import type { Component, Snippet } from 'svelte';
+	import ActionsCell from './ActionsCell.svelte';
+	import BubbleCell from './BubbleCell.svelte';
+	import ExpandCell from './ExpandCell.svelte';
+	import FocusableImmutableCell from './FocusableImmutableCell.svelte';
+
+	import { ColumnType } from '../../../Types/Columns/ColumnType.js';
+	import { ActionsDef } from '../../../Types/Columns/Definitions/Actions/ActionsDef.svelte.js';
+	import { AbstractDisplayDef } from '../../../Types/Columns/Definitions/Display/AbstractDisplayDef.svelte.js';
+	import { ProgressBarDef } from '../../../Types/Columns/Definitions/Display/ProgressBarDef.svelte.js';
+	import type { ExpandTableCell } from '../../../Types/Columns/ExpandTableCell.js';
+	import type { ProgressBarTableCell } from '../../../Types/Columns/ProgressBarTableCell.js';
+	import { getErrorMessage } from '../../../../../Helpers/Helpers.svelte.js';
+	import AccessorComponent from './AccessorComponent.svelte';
+	import type { ActionsTableCell } from './ActionsTableCell.js';
+	import ProgressCell from './ProgressCell.svelte';
+	import TableRowSelectionCheckbox from './TableRowSelectionCheckbox.svelte';
+	import type { TableColumnProps } from './TableColumnProps.js';
+	import ValidityCell from './ValidityCell.svelte';
+
+	/** Narrowing type-guard distinguishing a progress-bar cell by its `columnDef` instance. */
+	function isProgressBarTableCell<T extends object>(
+		cell: TableCell<T>
+	): cell is ProgressBarTableCell<T, unknown> {
+		return cell.column.columnDef instanceof ProgressBarDef;
+	}
+</script>
+
+<script
+	lang="ts"
+	generics="T extends object"
+>
+	import { dev } from '$app/environment';
+	import { RowSelectionDef } from '../../../Types/Columns/Definitions/RowSelection/RowSelectionDef.svelte.js';
+	import type { Primitive } from '../../../Types/Context/TableInitOptions.js';
+	import type { RowSelectionTableCell } from './RowSelectionTableCell.js';
+
+	let { cell, expandedColumnDef, onExpandChange }: TableColumnProps<T> = $props();
+
+	/** Narrowing type-guard distinguishing the row-selection cell. */
+	function isRowSelectionCell<T extends object>(
+		cell: TableCell<T>
+	): cell is RowSelectionTableCell<T> {
+		return cell.column.columnDef instanceof RowSelectionDef;
+	}
+
+	/**
+	 * Returns true when the accessor output is a Svelte component constructor.
+	 * Distinguishing a Svelte 5 component (a function) from a snippet is a
+	 * runtime-only heuristic (both are typeof 'function'); the
+	 * constructor-only branch is reached first because TableColumn checks
+	 * `valueOrComponentIsConstructor` before `isSnippet`. Tightening this to
+	 * a real type-level discriminator is tracked under the
+	 * RowGenericThreading follow-up.
+	 */
+	function valueOrComponentIsConstructor(
+		valueOrComponent: unknown
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	): valueOrComponent is Component<any> {
+		return typeof valueOrComponent === 'function';
+	}
+
+	/** Narrowing type-guard distinguishing an actions cell. */
+	function isActionsDef(cell: TableCell<T>): cell is ActionsTableCell<T, unknown> {
+		return cell.column.columnDef instanceof ActionsDef;
+	}
+
+	/** Narrowing type-guard distinguishing the expand-row cell. */
+	function isExpandTableCell(
+		cell: TableCell<T>
+	): cell is ExpandTableCell<T, object, Primitive, unknown> {
+		return cell.column.columnDef instanceof ExpandDef;
+	}
+
+	/** Heuristic snippet check; both Snippets and Components are functions at runtime. */
+	function isSnippet(value: unknown): value is Snippet<[TableCell<T>]> {
+		return !!value && typeof value == 'function';
+	}
+</script>
+
+{#if cell.column.getIsVisible()}
+	{@const columnDef = cell.column.columnDef}
+
+	{#if isRowSelectionCell(cell)}
+		<TableRowSelectionCheckbox {cell} />
+	{:else if isActionsDef(cell)}
+		<ActionsCell {cell} />
+	{:else if isExpandTableCell(cell)}
+		<ExpandCell
+			{cell}
+			{expandedColumnDef}
+			{onExpandChange}
+		/>
+	{:else if columnDef.columnType !== ColumnType.Display}
+		<AccessorComponent {cell} />
+	{:else if cell.column.columnDef instanceof AbstractDisplayDef}
+		{#if cell.column.columnDef.displayType === DisplayType.Bubbles}
+			<BubbleCell {cell} />
+		{:else if cell.column.columnDef.displayType === DisplayType.Validity}
+			<ValidityCell {cell} />
+		{:else if isProgressBarTableCell(cell)}
+			<ProgressCell {cell} />
+		{:else if cell.column.columnDef.displayType === DisplayType.Normal}
+			<FocusableImmutableCell {cell} />
+		{:else}
+			{#if dev}
+				<!-- eslint-disable-next-line svelte/no-at-debug-tags -->
+				{@debug cell}
+			{/if}
+			Unknown Cell Type
+		{/if}
+	{:else}
+		{@const valueOrComponentPromise =
+			cell.column.columnDef.accessorFn?.(cell.row.original, cell.row.originalIndex) ??
+			cell.row.original[cell.column.id as keyof typeof cell.row.original]}
+
+		{#await valueOrComponentPromise}
+			<FocusableImmutableCell {cell} />
+		{:then Value}
+			{#if typeof Value === 'string' || typeof Value == 'number'}
+				<FocusableImmutableCell {cell} />
+			{:else if valueOrComponentIsConstructor(Value)}
+				<FocusableImmutableCell {cell}>
+					<Value {cell} />
+				</FocusableImmutableCell>
+			{:else if isSnippet(Value)}
+				<FocusableImmutableCell {cell}>
+					<!-- eslint-disable-next-line @typescript-eslint/no-unsafe-call -->
+					{@render Value(cell)}
+				</FocusableImmutableCell>
+			{:else}
+				{#if dev}
+					<!-- eslint-disable-next-line svelte/no-at-debug-tags -->
+					{@debug cell}
+					<!-- eslint-disable-next-line svelte/no-at-debug-tags -->
+					{@debug Value}
+				{/if}
+				Unknown Cell or value Type
+			{/if}
+		{:catch e}
+			<FocusableImmutableCell {cell}>
+				{#if dev}
+					{getErrorMessage(e)}
+				{:else}
+					Error rendering cell
+				{/if}
+			</FocusableImmutableCell>
+		{/await}
+	{/if}
+{/if}

package/dist/Components/Table/Body/Rows/Columns/TableColumn.svelte.d.ts

@@ -1,10 +1,4 @@
-import { ExpandDef } from '../../../Types/Columns/Definitions/Expand/ExpandDef.svelte.js';
-import type { TableCell } from '../../../Types/Columns/TableCell.js';
-export interface TableColumnProps<T extends object> {
-    cell: TableCell<T>;
-    expandedColumnDef: ExpandDef<T, object> | undefined;
-    onExpandChange: (columnDef: ExpandDef<T, object>) => void;
-}
+import type { TableColumnProps } from './TableColumnProps.js';
 declare function $$render<T extends object>(): {
     props: TableColumnProps<T>;
     exports: {};

package/dist/Components/Table/Body/Rows/Columns/TableColumnProps.d.ts

@@ -0,0 +1,16 @@
+import type { ExpandDef } from '../../../Types/Columns/Definitions/Expand/ExpandDef.svelte.js';
+import type { TableCell } from '../../../Types/Columns/TableCell.js';
+/**
+ * Props for {@link TableColumn}. The component dispatches one of the
+ * specialised cell hosts (RowSelection / Actions / Expand / Accessor / Bubble
+ * / Validity / Progress / FocusableImmutable) based on the column's
+ * `columnDef.columnType` discriminant and the cell's value shape.
+ */
+export interface TableColumnProps<T extends object> {
+    /** The cell to render. */
+    cell: TableCell<T>;
+    /** The currently expanded child-table column def, or `undefined` for none. */
+    expandedColumnDef: ExpandDef<T, object> | undefined;
+    /** Callback to swap the expanded column. */
+    onExpandChange: (columnDef: ExpandDef<T, object>) => void;
+}

package/dist/Components/Table/Body/Rows/Columns/TableColumnProps.js

@@ -0,0 +1 @@
+export {};