@streamscloud/kit 0.59.0 → 0.61.0

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

@@ -1 +1 @@
-export { plural } from './plural';
+export { resolvePluralForm } from './resolve-plural-form';

package/dist/core/i18n/index.js

@@ -1 +1 @@
-export { plural } from './plural';
+export { resolvePluralForm } from './resolve-plural-form';

package/dist/core/i18n/resolve-plural-form.d.ts

@@ -0,0 +1,23 @@
+export type ResolvePluralFormOptions = {
+    count: number;
+    candidates: [string, ...string[]];
+    locale: string;
+};
+/**
+ * Picks the plural form matching `count` for `locale`.
+ *
+ * @param count - The number to pluralize
+ * @param candidates - One string per plural category `locale` distinguishes, in canonical CLDR order
+ *   (zero, one, two, few, many, other) filtered to that locale's categories — e.g. 2 entries for 'en'
+ *   (one, other), 4 for 'ru' (one, few, many, other). The caller (or its translation catalog) owns
+ *   supplying the right length and order for the given locale. In dev, a length mismatch against
+ *   `locale`'s actual category count throws instead of silently resolving the wrong form.
+ * @param locale - BCP 47 locale used to resolve the matching category via `Intl.PluralRules`.
+ *   Invalid locale tags silently fall back to the runtime default — validate the locale upstream.
+ * @returns The matching candidate with # replaced by count
+ *
+ * @example
+ * resolvePluralForm({ count: 1, candidates: ['# item', '# items'], locale: 'en' }) // "1 item"
+ * resolvePluralForm({ count: 5, candidates: ['# item', '# items'], locale: 'en' }) // "5 items"
+ */
+export declare const resolvePluralForm: ({ count, candidates, locale }: ResolvePluralFormOptions) => string;

package/dist/core/i18n/resolve-plural-form.js

@@ -0,0 +1,41 @@
+/**
+ * Picks the plural form matching `count` for `locale`.
+ *
+ * @param count - The number to pluralize
+ * @param candidates - One string per plural category `locale` distinguishes, in canonical CLDR order
+ *   (zero, one, two, few, many, other) filtered to that locale's categories — e.g. 2 entries for 'en'
+ *   (one, other), 4 for 'ru' (one, few, many, other). The caller (or its translation catalog) owns
+ *   supplying the right length and order for the given locale. In dev, a length mismatch against
+ *   `locale`'s actual category count throws instead of silently resolving the wrong form.
+ * @param locale - BCP 47 locale used to resolve the matching category via `Intl.PluralRules`.
+ *   Invalid locale tags silently fall back to the runtime default — validate the locale upstream.
+ * @returns The matching candidate with # replaced by count
+ *
+ * @example
+ * resolvePluralForm({ count: 1, candidates: ['# item', '# items'], locale: 'en' }) // "1 item"
+ * resolvePluralForm({ count: 5, candidates: ['# item', '# items'], locale: 'en' }) // "5 items"
+ */
+export const resolvePluralForm = ({ count, candidates, locale }) => {
+    const { index, categoriesLength } = indexerFor(locale);
+    if (import.meta.env?.DEV && candidates.length !== categoriesLength) {
+        throw new Error(`resolvePluralForm(): locale "${locale}" needs ${categoriesLength} candidate(s), got ${JSON.stringify(candidates)}.`);
+    }
+    const template = candidates[index(count)] ?? candidates[candidates.length - 1];
+    return template.replace(/#/g, String(count));
+};
+const PLURAL_CATEGORY_ORDER = ['zero', 'one', 'two', 'few', 'many', 'other'];
+const indexers = new Map();
+const indexerFor = (locale) => {
+    const cached = indexers.get(locale);
+    if (cached) {
+        return cached;
+    }
+    const rules = new Intl.PluralRules(locale);
+    const categories = rules
+        .resolvedOptions()
+        .pluralCategories.slice()
+        .sort((a, b) => PLURAL_CATEGORY_ORDER.indexOf(a) - PLURAL_CATEGORY_ORDER.indexOf(b));
+    const indexer = { index: (count) => categories.indexOf(rules.select(count)), categoriesLength: categories.length };
+    indexers.set(locale, indexer);
+    return indexer;
+};

package/dist/ui/cropper/img-cropper/cropperjs-elements.d.ts

@@ -9,15 +9,17 @@ type CamelToKebab<S extends string> = S extends `${infer F}${infer R}`
   : S;
 
 type CropperElementProps<T extends HTMLElement> = {
-  [K in keyof T as K extends keyof HTMLElement
-    ? never
-    : K extends `$${string}`
+  [
+    K in keyof T as K extends keyof HTMLElement
       ? never
-      : T[K] extends (...args: never[]) => unknown
+      : K extends `$${string}`
         ? never
-        : K extends string
-          ? CamelToKebab<K>
-          : never]?: (T[K] extends boolean ? boolean : T[K] extends number ? number | string : string) | null;
+        : T[K] extends (...args: never[]) => unknown
+          ? never
+          : K extends string
+            ? CamelToKebab<K>
+            : never
+  ]?: (T[K] extends boolean ? boolean : T[K] extends number ? number | string : string) | null;
 } & import('svelte/elements').HTMLAttributes<HTMLElement>;
 
 declare namespace svelteHTML {

package/dist/ui/dynamic-component/cmp.dynamic-component.svelte

@@ -12,19 +12,5 @@ Use when the component to render is decided at runtime (e.g. dispatched by id, f
 renders many heterogeneous nodes). `DynamicComponentModel` keeps `props` reactive — calling
 `model.updateProps(...)` updates the rendered component without re-mounting.
 
-```svelte
-<script lang="ts">
-  import { DynamicComponent, DynamicComponentModel } from '@streamscloud/kit/dynamic-component';
-  import { Button } from '@streamscloud/kit/button';
-
-  const model = new DynamicComponentModel({
-    component: Button,
-    props: { type: 'button', children: () => 'Click' }
-  });
-</script>
-
-<DynamicComponent {model} />
-```
-
 This component has no styles or visual surface of its own.
 -->

package/dist/ui/dynamic-component/cmp.dynamic-component.svelte.d.ts

@@ -10,20 +10,6 @@ type Props = {
  * renders many heterogeneous nodes). `DynamicComponentModel` keeps `props` reactive — calling
  * `model.updateProps(...)` updates the rendered component without re-mounting.
  *
- * ```svelte
- * <script lang="ts">
- * import { DynamicComponent, DynamicComponentModel } from '@streamscloud/kit/dynamic-component';
- * import { Button } from '@streamscloud/kit/button';
- *
- * const model = new DynamicComponentModel({
- *   component: Button,
- *   props: { type: 'button', children: () => 'Click' }
- * });
- * </script>
- *
- * <DynamicComponent {model} />
- * ```
- *
  * This component has no styles or visual surface of its own.
  */
 declare const Cmp: import("svelte").Component<Props, {}, "">;

package/dist/ui/grid-card/fields/cmp.grid-card-progress-field.svelte

@@ -9,6 +9,5 @@ const { label, stage, stages } = $props();
 
 <!--
 @component
-Grid-card field pairing a field label with a multi-stage `ProgressBar`. See `ProgressBar`
-(`@streamscloud/kit/ui/progress-bar`) for the bar's own CSS Custom Properties.
+Grid-card field pairing a field label with a multi-stage `ProgressBar`. See `ProgressBar` for the bar's own CSS Custom Properties.
 -->

package/dist/ui/grid-card/fields/cmp.grid-card-progress-field.svelte.d.ts

@@ -9,10 +9,7 @@ type Props = {
      */
     stages: ProgressBarStage[];
 };
-/**
- * Grid-card field pairing a field label with a multi-stage `ProgressBar`. See `ProgressBar`
- * (`@streamscloud/kit/ui/progress-bar`) for the bar's own CSS Custom Properties.
- */
+/** Grid-card field pairing a field label with a multi-stage `ProgressBar`. See `ProgressBar` for the bar's own CSS Custom Properties. */
 declare const Cmp: import("svelte").Component<Props, {}, "">;
 type Cmp = ReturnType<typeof Cmp>;
 export default Cmp;

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

@@ -48,15 +48,6 @@ to content stays "inside" the hover zone (no close fires). The `closeDelay` cove
 small visual gap between trigger and content.
 
 `bind:this` on HoverPopover forwards `open() / close() / toggle()` from the inner Popover.
-
-```svelte
-import { HoverPopover, PopoverItem } from '@streamscloud/kit/ui/popover';
-
-<HoverPopover>
-  {#snippet trigger()}<Button type="presentational">Hover me</Button>{/snippet}
-  <PopoverItem>Action</PopoverItem>
-</HoverPopover>
-```
 -->
 
 <style>.hover-popover {

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

@@ -33,15 +33,6 @@ type Props = {
  * small visual gap between trigger and content.
  *
  * `bind:this` on HoverPopover forwards `open() / close() / toggle()` from the inner Popover.
- *
- * ```svelte
- * import { HoverPopover, PopoverItem } from '@streamscloud/kit/ui/popover';
- *
- * <HoverPopover>
- * {#snippet trigger()}<Button type="presentational">Hover me</Button>{/snippet}
- * <PopoverItem>Action</PopoverItem>
- * </HoverPopover>
- * ```
  */
 declare const Cmp: import("svelte").Component<Props, {
     /** Imperative API — bind:this on HoverPopover to access. */ open: () => void;

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

@@ -226,15 +226,7 @@ the same state can be reached by keyboard through another control (as in `UrlInp
 protocol into the field does what the picker does). Never reach for it just to shorten a tab sequence.
 
 Imperative control via `bind:this` — the component exports `open()`, `close()`, `toggle()`
-methods. Import `PopoverInstance` type from the barrel for typing the ref.
-
-```svelte
-import { Popover, type PopoverInstance } from '@streamscloud/kit/ui/popover';
-let dd: PopoverInstance | undefined = $state.raw(undefined);
-
-<Popover bind:this={dd}>...</Popover>
-<button onclick={() => dd?.open()}>Open externally</button>
-```
+methods; type the ref with the exported `PopoverInstance` type.
 
 With `panel` on, content sizes to `max-content` and, above the `min-width` floor, never exceeds the room Floating UI measures around the trigger: the `size()` middleware feeds the space left after
 `flip` / `shift` into the max-width / max-height defaults. So the panel always has a definite width — which is what makes a consumer's own

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

@@ -51,15 +51,7 @@ type Props = {
  * protocol into the field does what the picker does). Never reach for it just to shorten a tab sequence.
  *
  * Imperative control via `bind:this` — the component exports `open()`, `close()`, `toggle()`
- * methods. Import `PopoverInstance` type from the barrel for typing the ref.
- *
- * ```svelte
- * import { Popover, type PopoverInstance } from '@streamscloud/kit/ui/popover';
- * let dd: PopoverInstance | undefined = $state.raw(undefined);
- *
- * <Popover bind:this={dd}>...</Popover>
- * <button onclick={() => dd?.open()}>Open externally</button>
- * ```
+ * methods; type the ref with the exported `PopoverInstance` type.
  *
  * With `panel` on, content sizes to `max-content` and, above the `min-width` floor, never exceeds the room Floating UI measures around the trigger: the `size()` middleware feeds the space left after
  * `flip` / `shift` into the max-width / max-height defaults. So the panel always has a definite width — which is what makes a consumer's own

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamscloud/kit",
-  "version": "0.59.0",
+  "version": "0.61.0",
   "author": "StreamsCloud",
   "repository": {
     "type": "git",
@@ -482,11 +482,11 @@
   },
   "peerDependencies": {
     "@floating-ui/dom": "^1.7.6",
-    "@fluentui/svg-icons": "^1.1.326",
+    "@fluentui/svg-icons": "^1.1.341",
     "@fontsource/inter": "^5.2.8",
     "@fontsource/jetbrains-mono": "^5.2.8",
     "@fontsource/source-sans-pro": "^5.2.5",
-    "@urql/core": "^5.2.0 || ^6.0.0",
+    "@urql/core": "^6.0.1",
     "cleave-zen": "^0.0.17",
     "colord": "^2.9.3",
     "cropperjs": "^2.1.1",
@@ -498,7 +498,7 @@
     "nanoid": "^5.1.11",
     "p-limit": "^7.3.0",
     "rfdc": "^1.4.1",
-    "svelte": "^5.55.7",
+    "svelte": "^5.57.0",
     "svelte-awesome-color-picker": "^4.1.2",
     "svelte-dnd-action": "^0.9.69",
     "wheel-gestures": "^2.2.48",
@@ -507,50 +507,50 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@floating-ui/dom": "^1.7.6",
-    "@fluentui/svg-icons": "^1.1.326",
+    "@fluentui/svg-icons": "^1.1.341",
     "@fontsource/inter": "^5.2.8",
     "@fontsource/jetbrains-mono": "^5.2.8",
     "@fontsource/source-sans-pro": "^5.2.5",
-    "@sveltejs/package": "^2.5.7",
-    "@sveltejs/vite-plugin-svelte": "^7.1.2",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@tsconfig/svelte": "^5.0.8",
-    "@types/node": "^25.8.0",
+    "@types/node": "^26.6.1",
     "@urql/core": "^6.0.1",
-    "autoprefixer": "^10.5.0",
+    "autoprefixer": "^10.6.1",
     "cleave-zen": "^0.0.17",
     "colord": "^2.9.3",
     "cropperjs": "^2.1.1",
     "dequal": "^2.0.3",
     "dompurify": "^3.4.5",
-    "eslint": "^10.4.0",
+    "eslint": "^10.10.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-formatter-codeframe": "^7.32.2",
     "eslint-formatter-visualstudio": "^9.0.1",
-    "eslint-plugin-import-x": "^4.16.2",
-    "eslint-plugin-jsonc": "^3.1.2",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-jsonc": "^3.4.2",
     "eslint-plugin-only-warn": "^1.2.1",
     "eslint-plugin-promise": "^7.3.0",
-    "eslint-plugin-svelte": "^3.17.1",
+    "eslint-plugin-svelte": "^3.23.0",
     "eslint-plugin-unused-imports": "^4.4.1",
     "fuse.js": "^7.3.0",
-    "globals": "^17.6.0",
+    "globals": "^17.12.0",
     "hugerte": "^1.0.10",
     "mime": "^4.1.0",
     "nanoid": "^5.1.11",
     "p-limit": "^7.3.0",
-    "prettier": "^3.8.3",
-    "prettier-plugin-svelte": "^4.1.0",
-    "publint": "^0.3.21",
+    "prettier": "^3.9.7",
+    "prettier-plugin-svelte": "^4.1.1",
+    "publint": "^0.3.24",
     "rfdc": "^1.4.1",
-    "sass": "^1.99.0",
-    "svelte": "^5.55.7",
+    "sass": "^1.104.1",
+    "svelte": "^5.57.0",
     "svelte-awesome-color-picker": "^4.1.2",
-    "svelte-check": "^4.4.8",
+    "svelte-check": "^4.7.6",
     "svelte-dnd-action": "^0.9.69",
-    "svelte-preprocess": "^6.0.3",
+    "svelte-preprocess": "^6.0.5",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.3",
-    "vite": "^8.0.13",
+    "typescript-eslint": "^8.70.0",
+    "vite": "^8.3.0",
     "vite-tsconfig-paths": "^6.1.1",
     "wheel-gestures": "^2.2.48",
     "yup": "^1.7.1"

package/dist/core/i18n/plural.d.ts

@@ -1,14 +0,0 @@
-/**
- * Plural function for wuchale i18n.
- * Wuchale extracts the candidates array and compiles locale-specific plural rules.
- *
- * @param count - The number to pluralize
- * @param candidates - Array of plural forms, e.g., ['One item', '# items']
- * @param rule - Optional plural rule function (injected by wuchale at compile time)
- * @returns The appropriate plural form with # replaced by count
- *
- * @example
- * plural(1, ['# item', '# items']) // "1 item"
- * plural(5, ['# item', '# items']) // "5 items"
- */
-export declare const plural: (count: number, candidates: string[], rule?: (n: number) => number) => string;

package/dist/core/i18n/plural.js

@@ -1,18 +0,0 @@
-/**
- * Plural function for wuchale i18n.
- * Wuchale extracts the candidates array and compiles locale-specific plural rules.
- *
- * @param count - The number to pluralize
- * @param candidates - Array of plural forms, e.g., ['One item', '# items']
- * @param rule - Optional plural rule function (injected by wuchale at compile time)
- * @returns The appropriate plural form with # replaced by count
- *
- * @example
- * plural(1, ['# item', '# items']) // "1 item"
- * plural(5, ['# item', '# items']) // "5 items"
- */
-export const plural = (count, candidates, rule = (n) => (n === 1 ? 0 : 1)) => {
-    const index = rule(count);
-    const template = candidates[index] ?? candidates[candidates.length - 1];
-    return template.replace(/#/g, String(count));
-};