@streamscloud/kit 0.39.0 → 0.40.1

package/dist/core/utils/filter-helper.d.ts

@@ -0,0 +1,8 @@
+export declare class FilterHelper {
+    /**
+     * Checks whether `filters` differs from its empty/default state.
+     * Strings are compared trimmed; arrays and any key present in `empty` via {@link Utils.areEqual} (deep);
+     * a key absent from `empty` is considered applied when its value isn't `null`/`undefined`.
+     */
+    static isApplied<T extends Record<string, unknown>>(filters: T, empty?: Partial<T>): boolean;
+}

package/dist/core/utils/filter-helper.js

@@ -0,0 +1,25 @@
+import { Utils } from './utils';
+export class FilterHelper {
+    /**
+     * Checks whether `filters` differs from its empty/default state.
+     * Strings are compared trimmed; arrays and any key present in `empty` via {@link Utils.areEqual} (deep);
+     * a key absent from `empty` is considered applied when its value isn't `null`/`undefined`.
+     */
+    static isApplied(filters, empty = {}) {
+        const keys = new Set([...Object.keys(filters), ...Object.keys(empty)]);
+        return [...keys].some((key) => {
+            const value = filters[key];
+            const probe = value ?? empty[key];
+            if (typeof probe === 'string') {
+                return (value ?? '').trim() !== (empty[key] ?? '').trim();
+            }
+            if (Array.isArray(probe)) {
+                return !Utils.areEqual(value ?? [], empty[key] ?? []);
+            }
+            if (key in empty) {
+                return !Utils.areEqual(value, empty[key]);
+            }
+            return value !== null && value !== undefined;
+        });
+    }
+}

package/dist/core/utils/index.d.ts

@@ -5,6 +5,7 @@ export * from './base64-serializer';
 export * from './browser';
 export * from './date-helper';
 export * from './dom-helper';
+export * from './filter-helper';
 export * from './href-validator';
 export * from './html-helper';
 export * from './image-preloader';

package/dist/core/utils/index.js

@@ -5,6 +5,7 @@ export * from './base64-serializer';
 export * from './browser';
 export * from './date-helper';
 export * from './dom-helper';
+export * from './filter-helper';
 export * from './href-validator';
 export * from './html-helper';
 export * from './image-preloader';

package/dist/styles/_semantic.scss

@@ -16,6 +16,7 @@
   --sc-kit--color--bg--active: light-dark(#eef2f8, #{$color-dark-600});
   --sc-kit--color--bg--menu-active: light-dark(#{$color-blue-50}, #{$color-dark-500});
   --sc-kit--color--bg--images: light-dark(#{$color-neutral-300}, #{$color-dark-50});
+  --sc-kit--color--bg--images-subtle: light-dark(#{$color-neutral-100}, #{$color-dark-50});
 
   // ============================================================
   // COLOR — TEXT

package/dist/ui/table/table-cells/table-image-cell.svelte

@@ -32,7 +32,18 @@ const getValueForColumn = (column, item) => (column.valueFactory ? column.valueF
   {/if}
 </div>
 
+<!--
+@component
+Image cell for table rows. Renders one of several image layouts depending on `column.format`.
+
+### CSS Custom Properties
+| Property | Description | Default |
+|---|---|---|
+| `--sc-kit--table-image-cell--image--background` | Background behind a `square-contain` image (letterboxing) | `var(--sc-kit--color--bg--images-subtle)` |
+-->
+
 <style>.table-image-cell {
+  --_table-image-cell--image--background: var(--sc-kit--table-image-cell--image--background, var(--sc-kit--color--bg--images-subtle));
   display: flex;
   height: 3.125em;
   min-height: 3.125em;
@@ -60,6 +71,7 @@ const getValueForColumn = (column, item) => (column.valueFactory ? column.valueF
 }
 .table-image-cell__image--contain {
   --sc-kit--image--object-fit: contain;
+  --sc-kit--image--background: var(--_table-image-cell--image--background);
   height: var(--_table-image-cell--cover-height);
 }
 .table-image-cell__image--cover {

package/dist/ui/table/table-cells/table-image-cell.svelte.d.ts

@@ -32,6 +32,14 @@ interface $$IsomorphicComponent {
     }>(internal: unknown, props: ReturnType<__sveltets_Render<T>['props']> & {}): ReturnType<__sveltets_Render<T>['exports']>;
     z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
 }
+/**
+ * Image cell for table rows. Renders one of several image layouts depending on `column.format`.
+ *
+ * ### CSS Custom Properties
+ * | Property | Description | Default |
+ * |---|---|---|
+ * | `--sc-kit--table-image-cell--image--background` | Background behind a `square-contain` image (letterboxing) | `var(--sc-kit--color--bg--images-subtle)` |
+ */
 declare const TableImageCell: $$IsomorphicComponent;
 type TableImageCell<T extends {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamscloud/kit",
-  "version": "0.39.0",
+  "version": "0.40.1",
   "author": "StreamsCloud",
   "repository": {
     "type": "git",