@streamscloud/kit 0.9.2 → 0.9.3

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

@@ -2,6 +2,11 @@ export declare class ArrayHelper {
     static distinct<T>(items: T[]): T[];
     static distinctBy<T>(items: T[], keyFn: (elem: T) => unknown): T[];
     static intersect<T>(arrays: T[][]): T[];
+    /**
+     * Splits `items` into sequential chunks of at most `size` elements.
+     * If `size < 1`, returns a single chunk containing all items.
+     */
+    static chunk<T>(items: T[], size: number): T[][];
     static assertHasValue<T>(value: T | null | undefined): value is T;
     /**
      * Find position ("from" and "to" indexes) of the element that was moved inside array (only one element should be moved)

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

@@ -11,6 +11,20 @@ export class ArrayHelper {
         }
         return arrays.reduce((result, current) => result.filter((item) => current.includes(item)));
     }
+    /**
+     * Splits `items` into sequential chunks of at most `size` elements.
+     * If `size < 1`, returns a single chunk containing all items.
+     */
+    static chunk(items, size) {
+        if (size < 1) {
+            return [[...items]];
+        }
+        const result = [];
+        for (let i = 0; i < items.length; i += size) {
+            result.push(items.slice(i, i + size));
+        }
+        return result;
+    }
     static assertHasValue(value) {
         return value !== null && value !== undefined;
     }

package/dist/ui/announcement-banner/announcement-banner-localization.d.ts

@@ -0,0 +1,3 @@
+export declare class AnnouncementBannerLocalization {
+    get dismiss(): string;
+}

package/dist/ui/announcement-banner/announcement-banner-localization.js

@@ -0,0 +1,12 @@
+import { AppLocale } from '../../core/locale';
+const loc = {
+    dismiss: {
+        en: 'Dismiss',
+        no: 'Lukk'
+    }
+};
+export class AnnouncementBannerLocalization {
+    get dismiss() {
+        return loc.dismiss[AppLocale.current];
+    }
+}

package/dist/ui/announcement-banner/cmp.announcement-banner.svelte

@@ -0,0 +1,153 @@
+<script lang="ts">import { Icon, IconSlot } from '../icon';
+import { AnnouncementBannerLocalization } from './announcement-banner-localization';
+import IconDismiss from '@fluentui/svg-icons/icons/dismiss_12_regular.svg?raw';
+let { variant = 'info', title, dismissible = false, icon, action, children, on } = $props();
+const localization = new AnnouncementBannerLocalization();
+let visible = $state(true);
+const role = $derived(variant === 'maintenance' ? 'alert' : 'status');
+const dismiss = () => {
+    visible = false;
+    on?.dismiss?.();
+};
+</script>
+
+{#if visible}
+  <div class="announcement-banner announcement-banner--{variant}" class:announcement-banner--dismissible={dismissible} role={role}>
+    <div class="announcement-banner__content">
+      {#if icon}
+        <span class="announcement-banner__icon" aria-hidden="true"><IconSlot icon={icon} /></span>
+      {/if}
+      <div class="announcement-banner__body">
+        {#if title}<strong class="announcement-banner__title">{title}</strong>{/if}
+        {#if children}<span class="announcement-banner__description">{@render children()}</span>{/if}
+      </div>
+      {#if action}<div class="announcement-banner__action">{@render action()}</div>{/if}
+    </div>
+    {#if dismissible}
+      <button class="announcement-banner__close" type="button" aria-label={localization.dismiss} onclick={dismiss}>
+        <Icon src={IconDismiss} />
+      </button>
+    {/if}
+  </div>
+{/if}
+
+<!--
+@component
+Full-width ribbon notification for site-wide announcements placed at the top of a page or layout.
+Supports four visual variants; `variant='maintenance'` uses `role="alert"` (assertive); all others use `role="status"` (polite).
+
+### CSS Custom Properties
+| Property | Description | Default |
+|---|---|---|
+| `--sc-kit--announcement-banner--padding-block` | Vertical padding | `--sc-kit--space--3` |
+| `--sc-kit--announcement-banner--padding-inline` | Horizontal padding | `--sc-kit--space--5` |
+| `--sc-kit--announcement-banner--gap` | Gap between icon / body / action | `--sc-kit--space--3` |
+| `--sc-kit--announcement-banner--background` | Background color | per `variant` |
+| `--sc-kit--announcement-banner--border-color` | Bottom border color | per `variant` |
+| `--sc-kit--announcement-banner--accent-color` | Icon + dismiss glyph color | per `variant` |
+| `--sc-kit--announcement-banner--title--color` | Title text color | `--sc-kit--color--text--primary` |
+| `--sc-kit--announcement-banner--description--color` | Body text color | `--sc-kit--color--text--secondary` |
+-->
+
+<style>.announcement-banner {
+  --_ab--padding-block: var(--sc-kit--announcement-banner--padding-block, var(--sc-kit--space--3));
+  --_ab--padding-inline: var(--sc-kit--announcement-banner--padding-inline, var(--sc-kit--space--5));
+  --_ab--gap: var(--sc-kit--announcement-banner--gap, var(--sc-kit--space--3));
+  --_ab--title-color: var(--sc-kit--announcement-banner--title--color, var(--sc-kit--color--text--primary));
+  --_ab--description-color: var(--sc-kit--announcement-banner--description--color, var(--sc-kit--color--text--secondary));
+  --_ab--background-default: var(--sc-kit--color--accent--softer);
+  --_ab--border-default: var(--sc-kit--color--accent--soft);
+  --_ab--accent-default: var(--sc-kit--color--accent);
+  --_ab--background: var(--sc-kit--announcement-banner--background, var(--_ab--background-default));
+  --_ab--border-color: var(--sc-kit--announcement-banner--border-color, var(--_ab--border-default));
+  --_ab--accent-color: var(--sc-kit--announcement-banner--accent-color, var(--_ab--accent-default));
+  display: flex;
+  width: 100%;
+  align-items: center;
+  justify-content: center;
+  padding: var(--_ab--padding-block) var(--_ab--padding-inline);
+  background: var(--_ab--background);
+  border-bottom: 1px solid var(--_ab--border-color);
+  color: var(--_ab--accent-color);
+  position: relative;
+}
+.announcement-banner--dismissible {
+  padding-inline-end: calc(var(--_ab--padding-inline) + 2rem);
+}
+.announcement-banner--info {
+  --_ab--background-default: var(--sc-kit--color--accent--softer);
+  --_ab--border-default: var(--sc-kit--color--accent--soft);
+  --_ab--accent-default: var(--sc-kit--color--accent);
+}
+.announcement-banner--announcement {
+  --_ab--background-default: var(--sc-kit--color--accent--soft);
+  --_ab--border-default: var(--sc-kit--color--accent);
+  --_ab--accent-default: var(--sc-kit--color--accent);
+}
+.announcement-banner--warning {
+  --_ab--background-default: var(--sc-kit--color--warning--soft);
+  --_ab--border-default: var(--sc-kit--color--warning);
+  --_ab--accent-default: var(--sc-kit--color--warning);
+}
+.announcement-banner--maintenance {
+  --_ab--background-default: var(--sc-kit--color--danger--soft);
+  --_ab--border-default: var(--sc-kit--color--danger);
+  --_ab--accent-default: var(--sc-kit--color--danger);
+}
+.announcement-banner__content {
+  display: flex;
+  align-items: center;
+  gap: var(--_ab--gap);
+}
+.announcement-banner__icon {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  line-height: 0;
+}
+.announcement-banner__body {
+  display: flex;
+  align-items: baseline;
+  flex-wrap: wrap;
+  gap: var(--sc-kit--space--2);
+}
+.announcement-banner__title {
+  font-size: var(--sc-kit--font-size--sm);
+  font-weight: var(--sc-kit--font-weight--semibold);
+  line-height: var(--sc-kit--leading--tight);
+  color: var(--_ab--title-color);
+}
+.announcement-banner__description {
+  font-size: var(--sc-kit--font-size--sm);
+  line-height: var(--sc-kit--leading--normal);
+  color: var(--_ab--description-color);
+}
+.announcement-banner__action {
+  flex-shrink: 0;
+}
+.announcement-banner__close {
+  position: absolute;
+  inset-inline-end: var(--_ab--padding-inline);
+  top: 50%;
+  transform: translateY(-50%);
+  appearance: none;
+  width: 1.25rem;
+  height: 1.25rem;
+  border: 0;
+  border-radius: var(--sc-kit--radius--sm);
+  background: transparent;
+  color: currentColor;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  opacity: 0.7;
+  cursor: pointer;
+  --sc-kit--icon--size: 0.75rem;
+}
+.announcement-banner__close:hover {
+  opacity: 1;
+}
+.announcement-banner__close:focus-visible {
+  outline: 2px solid var(--sc-kit--color--border--focus);
+  outline-offset: 2px;
+}</style>

package/dist/ui/announcement-banner/cmp.announcement-banner.svelte.d.ts

@@ -0,0 +1,39 @@
+import { type IconProp } from '../icon';
+import type { AnnouncementBannerVariant } from './types';
+import type { Snippet } from 'svelte';
+type Props = {
+    /** @default 'info' */
+    variant?: AnnouncementBannerVariant;
+    /** Short headline rendered in bold. */
+    title?: string;
+    /** Show a dismiss button. Hides the banner locally when clicked and fires `on.dismiss`. @default false */
+    dismissible?: boolean;
+    /** Leading icon — string SVG source, `{ src, color?, size? }` object, or custom snippet. */
+    icon?: IconProp;
+    /** Optional inline call-to-action area (e.g. "Learn more →", "See status page"). */
+    action?: Snippet;
+    /** Announcement body text. */
+    children?: Snippet;
+    on?: {
+        dismiss?: () => void;
+    };
+};
+/**
+ * Full-width ribbon notification for site-wide announcements placed at the top of a page or layout.
+ * Supports four visual variants; `variant='maintenance'` uses `role="alert"` (assertive); all others use `role="status"` (polite).
+ *
+ * ### CSS Custom Properties
+ * | Property | Description | Default |
+ * |---|---|---|
+ * | `--sc-kit--announcement-banner--padding-block` | Vertical padding | `--sc-kit--space--3` |
+ * | `--sc-kit--announcement-banner--padding-inline` | Horizontal padding | `--sc-kit--space--5` |
+ * | `--sc-kit--announcement-banner--gap` | Gap between icon / body / action | `--sc-kit--space--3` |
+ * | `--sc-kit--announcement-banner--background` | Background color | per `variant` |
+ * | `--sc-kit--announcement-banner--border-color` | Bottom border color | per `variant` |
+ * | `--sc-kit--announcement-banner--accent-color` | Icon + dismiss glyph color | per `variant` |
+ * | `--sc-kit--announcement-banner--title--color` | Title text color | `--sc-kit--color--text--primary` |
+ * | `--sc-kit--announcement-banner--description--color` | Body text color | `--sc-kit--color--text--secondary` |
+ */
+declare const Cmp: import("svelte").Component<Props, {}, "">;
+type Cmp = ReturnType<typeof Cmp>;
+export default Cmp;

package/dist/ui/announcement-banner/index.d.ts

@@ -0,0 +1,2 @@
+export { default as AnnouncementBanner } from './cmp.announcement-banner.svelte';
+export type { AnnouncementBannerVariant } from './types';

package/dist/ui/announcement-banner/index.js

@@ -0,0 +1 @@
+export { default as AnnouncementBanner } from './cmp.announcement-banner.svelte';

package/dist/ui/announcement-banner/types.d.ts

@@ -0,0 +1 @@
+export type AnnouncementBannerVariant = 'info' | 'announcement' | 'warning' | 'maintenance';

package/dist/ui/announcement-banner/types.js

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

package/dist/ui/popover/cmp.popover-item.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">import { popoverIgnore } from './popover-ignore';
-const { disabled = false, keepOpen = false, divider = false, on, children } = $props();
+const { disabled = false, keepOpen = false, divider = false, inset = false, on, children } = $props();
 const handleClick = () => {
     if (disabled) {
         return;
@@ -12,6 +12,7 @@ const handleClick = () => {
   class="popover-item"
   class:popover-item--disabled={disabled}
   class:popover-item--divider={divider}
+  class:popover-item--inset={inset}
   use:popoverIgnore={keepOpen}
   role="menuitem"
   tabindex={disabled ? -1 : 0}
@@ -42,6 +43,8 @@ for toggle items inside menus).
 | `--sc-kit--popover-item--divider-color` | Divider line color | `var(--sc-kit--color--border)` |
 | `--sc-kit--popover-item--divider-spacing` | Vertical gap added by divider | `var(--sc-kit--space--1)` |
 | `--sc-kit--popover-item--text-align` | Text alignment | `left` |
+| `--sc-kit--popover-item--margin-inline` | Inline margin when `inset` | `var(--sc-kit--space--2)` |
+| `--sc-kit--popover-item--border-radius` | Corner radius when `inset` | `var(--sc-kit--radius--sm)` |
 -->
 
 <style>.popover-item {
@@ -56,6 +59,8 @@ for toggle items inside menus).
   --_di--divider-color: var(--sc-kit--popover-item--divider-color, var(--sc-kit--color--border));
   --_di--divider-spacing: var(--sc-kit--popover-item--divider-spacing, var(--sc-kit--space--1));
   --_di--text-align: var(--sc-kit--popover-item--text-align, left);
+  --_di--margin-inline: var(--sc-kit--popover-item--margin-inline, var(--sc-kit--space--2));
+  --_di--border-radius: var(--sc-kit--popover-item--border-radius, var(--sc-kit--radius--sm));
   display: flex;
   align-items: center;
   gap: var(--_di--gap);
@@ -81,6 +86,10 @@ for toggle items inside menus).
   margin-bottom: var(--_di--divider-spacing);
   padding-bottom: calc(var(--_di--padding-block) + 1px);
 }
+.popover-item--inset {
+  margin-inline: var(--_di--margin-inline);
+  border-radius: var(--_di--border-radius);
+}
 .popover-item__content {
   flex: 1;
   min-width: 0;

package/dist/ui/popover/cmp.popover-item.svelte.d.ts

@@ -5,6 +5,8 @@ type Props = {
     keepOpen?: boolean;
     /** Render a separator line below this item — useful for grouping menu sections. */
     divider?: boolean;
+    /** Inset the item from the popover edges: adds an inline margin and rounds the hover background. */
+    inset?: boolean;
     on?: {
         click?: () => void;
     };
@@ -29,6 +31,8 @@ type Props = {
  * | `--sc-kit--popover-item--divider-color` | Divider line color | `var(--sc-kit--color--border)` |
  * | `--sc-kit--popover-item--divider-spacing` | Vertical gap added by divider | `var(--sc-kit--space--1)` |
  * | `--sc-kit--popover-item--text-align` | Text alignment | `left` |
+ * | `--sc-kit--popover-item--margin-inline` | Inline margin when `inset` | `var(--sc-kit--space--2)` |
+ * | `--sc-kit--popover-item--border-radius` | Corner radius when `inset` | `var(--sc-kit--radius--sm)` |
  */
 declare const Cmp: import("svelte").Component<Props, {}, "">;
 type Cmp = ReturnType<typeof Cmp>;

package/package.json

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