@xen-orchestra/web-core 0.18.0 → 0.20.0

package/lib/locales/sv.json

@@ -6,10 +6,11 @@
   "add": "Lägg till",
   "add-filter": "Lägg till filter",
   "add-or": "+ELLER",
-  "add-sort": "Lägg till soterting",
+  "add-sort": "Lägg till sortering",
   "admin-login": "Admin-inloggning",
   "admin-password": "Admin-lösenord",
   "admin-password-confirm": "Bekräfta admin-lösenord",
+  "affinity-host": "Fokus-host",
   "alarm-type.cpu_usage": "CPU-användning överskrider {n}%",
   "alarm-type.disk_usage": "Disk-användning överskrider {n}%",
   "alarm-type.fs_usage": "FS-användning överskrider {n}%",
@@ -17,14 +18,16 @@
   "alarm-type.mem_usage": "Minnes-användning överskrider {n}%",
   "alarm-type.memory_free_kib": "Ledigt minne är under {n}%",
   "alarm-type.network_usage": "Nätverks-användning överskrider {n}%",
-  "alarm-type.physical_utilisation": "Fysisktnyttjande överskrider {n}%",
-  "alarm-type.sr_io_throughput_total_per_host": "SR IO genomförning totalt per host överskrider {n}%",
+  "alarm-type.physical_utilisation": "Fysiskt nyttjande överskrider {n}%",
+  "alarm-type.sr_io_throughput_total_per_host": "SR IO genomströmning totalt per host överskrider {n}%",
   "alarm-type.unknown": "Okänd larm-typ",
   "alarms": "Larm",
   "all-good": "Allt är bra!",
   "allow-self-signed-ssl": "Du kan behöva tillåta själv-signerade SSL-certifikat i din webbläsare",
   "appearance": "Utseende",
   "ascending": "stigande",
+  "auto-generated": "Automatiskt generad",
+  "auto-power": "Automatisk strömpåslagning",
   "available": "Tillgänglig",
   "available-properties-for-advanced-filter": "Tillgängliga egenskaper för avancerade filter:",
   "back-pool-dashboard": "Gå tillbaka till din Pool-översikt",
@@ -44,15 +47,21 @@
   "backups.vms-protection.protected": "I minst ett jobb och skyddad",
   "backups.vms-protection.tooltip": "En VM är skyddad om den är med i ett säkerhetskopieringsjobb, med ett aktivt schema och den senaste körningen lyckades",
   "backups.vms-protection.unprotected": "Med i minst 1 jobb men oskyddad",
+  "bios-default": "bios (standardinställt)",
   "bond": "Bindning",
   "bond-devices": "Bindningsenheter",
   "bond-status": "Bindnings-status",
+  "boot-firmware": "Boot-programvara",
+  "boot-firmware-bios": "Den här mallen innehåller redan Bios-strängar",
+  "boot-firmware-uefi": "Boot-programvaran är UEFI",
+  "boot-vm": "Starta VM",
   "bytes.gi": "GiB",
   "bytes.ki": "KiB",
   "bytes.mi": "MiB",
   "cancel": "Avbryt",
   "change-state": "Ändra",
   "check-errors": "Kontrollera felen:",
+  "check-summing": "TX checksumma",
   "click-to-display-alarms": "Klicka för att visa larm:",
   "click-to-return-default-pool": "Klicka här för att återgå till standardpoolen",
   "close": "Stäng",
@@ -68,6 +77,8 @@
   "console-clipboard": "Konsolurklipp",
   "console-unavailable": "Konsolen är inte tillgänglig",
   "copy": "Kopiera",
+  "copy-all": "Kopiera allt",
+  "copy-host": "Kopiera värddator",
   "copy-info-json": "Kopiera informationen till JSON",
   "core.character-limit": "{count}/{max} tecken | {count}/{max} tecken",
   "core.close": "Stäng",
@@ -78,6 +89,8 @@
   "core.group": "Grupp",
   "core.hide": "Göm",
   "core.open": "Öppna",
+  "core.pagination.all": "Alla",
+  "core.pagination.show-by": "Sortera efter",
   "core.query-search-bar.label": "Sökmotor",
   "core.query-search-bar.placeholder": "Skriv din fråga…",
   "core.query-search-bar.use-query-builder": "Använd frågebyggaren",
@@ -96,10 +109,12 @@
   "core.sort.ascending": "Sortera stigande",
   "core.sort.descending": "Sotera fallande",
   "core.textarea.exceeds-max-characters": "Fältet får enbart vara {max} tecken eller färre.",
-  "cores-with-sockets": "",
+  "cores-with-sockets": "Kärnor (sockets)",
   "cpu-provisioning": "CPU-provisionering",
   "cpu-provisioning-warning": "Antalet vCPU:er som allokerats överskrider antalet fysiska CPU:er. Systemets prestanda kan påverkas",
   "cpu-usage": "CPU-nyttjande",
+  "create": "Skapa",
+  "custom-config": "Skräddarsydd konfiguration",
   "dark-mode.auto": "Automatiskt mörkt läge",
   "dark-mode.disable": "Inaktivera mörkt läge",
   "dark-mode.enable": "Aktivera mörkt läge",
@@ -124,6 +139,7 @@
   "disabled": "Inaktiverad",
   "disconnected": "Frånkopplad",
   "disconnected-from-physical-device": "Koppla från fysisk enhet",
+  "disk-name": "Disk-namn",
   "display": "Display",
   "dns": "DNS",
   "do-you-have-needs": "Har du behov och/eller förväntningar? Berätta för oss",
@@ -144,6 +160,7 @@
   "export-vm": "Exportera VM",
   "export-vms": "Exportera VMar",
   "export-vms-manually-information": "Vissa VM-exporter kunde inte startas automatiskt, troligen på grund av dina webbläsarinställningar. För att exportera dem, klicka på varje VM. (Alternativt, kopiera länken.)",
+  "fast-clone": "Snabb-kloning",
   "fetching-fresh-data": "Hämtar nya data",
   "filter.comparison.contains": "Innehåller",
   "filter.comparison.ends-with": "Slutar med",
@@ -169,15 +186,18 @@
   "gateway": "Gateway",
   "go-back": "Gå tillbaka",
   "gzip": "gzip",
-  "hardware": "",
+  "hardware": "Hårdvara",
   "here": "Här",
   "host": "Host",
   "host-description": "Host-beskrivning",
-  "host-internal-networks": "Hostinternanätverk",
+  "host-internal-networks": "Host-interna nätverk",
+  "host-status.halted": "Stoppad",
+  "host-status.running": "Kör",
+  "host-status.unknown": "Okänt",
   "host-unknown": "Host okänd",
   "host.active": "Aktiv",
   "host.inactive": "Inaktiv",
-  "hosts": "Hosts",
+  "hosts": "Hostar",
   "hosts-status": "Host-status",
   "hosts-status.halted": "Stoppad",
   "hosts-status.running": "Igång",
@@ -185,14 +205,18 @@
   "hosts-status.unknown.tooltip": "Host-data är otillgängligt",
   "id": "Id",
   "in-last-three-jobs": "I de senaste tre jobben",
+  "install-settings": "Installationsinställningar",
+  "interfaces": "Gränssnitt | Gränssnitt | Gränssnitten",
   "invalid-field": "Felaktigt fält",
+  "ip-address": "IP-adress",
   "ip-addresses": "IP-adresser",
   "ip-mode": "IP-läge",
-  "is-primary-host": "",
+  "is-primary-host": "{name} är den primära hosten",
+  "iso-dvd": "ISO/DVD",
   "job.vm-copy.bad-power-state": "VMen måste vara stoppad",
   "job.vm-copy.in-progress": "Kopiering pågår…",
   "job.vm-copy.missing-vms": "Ingen VM att kopiera",
-  "job.vm-delete.bad-power-state": "Vmen måste vara stoppad",
+  "job.vm-delete.bad-power-state": "VMen måste vara stoppad",
   "job.vm-delete.in-progress": "Radering pågår…",
   "job.vm-delete.missing-vms": "Ingen VM att radera",
   "job.vm-export.in-progress": "Export pågår…",
@@ -238,7 +262,7 @@
   "language": "Språk",
   "last-week": "Föregående vecka",
   "learn-more": "Läs mer",
-  "load-average": "",
+  "load-average": "Genomsnittslast",
   "load-now": "Ladda nu",
   "loading-hosts": "Ladda hostar…",
   "loading-in-progress": "Laddning pågår…",
@@ -251,12 +275,14 @@
   "mac-addresses": "MAC-adresser",
   "management": "Hantering",
   "master": "Primärhost",
-  "memory-usage": "",
+  "memory": "Minne",
+  "memory-usage": "Minnesanvändning",
   "migrate": "Migrera",
   "migrate-n-vms": "Migrera 1 VM | Migrera {n} VMar",
   "missing-patches": "Saknar uppdateringar",
   "more-actions": "Fler åtgärder",
   "mtu": "MTU",
+  "multi-creation": "Multi-skapande",
   "n-gb-left": "{n} GB kvar",
   "n-gb-required": "{n} GB behövs",
   "n-hosts": "1 host | {n} hostar",
@@ -266,7 +292,8 @@
   "name": "Namn",
   "netmask": "Nätmaskadress",
   "network": "Nätverk",
-  "network-block-device": "Nätverksblockeringsenhet",
+  "network-block-device": "Nätverksblockenhet",
+  "network-config": "Nätverkskonfiguration",
   "network-download": "Ladda ned",
   "network-information": "Nätverksinformation",
   "network-throughput": "Nätverksflöde",
@@ -274,17 +301,24 @@
   "networks": "Nätverk",
   "new": "Ny",
   "new-features-are-coming": "Nya funktioner kommer snart!",
+  "new-vif": "Ny VIF",
+  "new-vm": "Ny VM",
+  "new-vm.add": "Lägg till ny VM",
+  "new-vm.description": "VM-beskrivning",
+  "new-vm.name": "VM-namn",
   "news": "Nyheter",
   "news-name": "{name} nyheter",
   "no-alarm-triggered": "Inga larm",
+  "no-config": "Ingen konfiguration",
   "no-data": "Ingen data",
   "no-network-detected": "Inga nätverk hittade",
-  "no-pif-detected": "Ingen pif hittad",
+  "no-pif-detected": "Ingen PIF hittad",
   "no-result": "Inget resultat",
   "no-results": "Inga resultat",
   "no-selected-vm-can-be-exported": "Inga markerade VMar kan exporteras",
   "no-selected-vm-can-be-migrated": "Inga markerade VMar kan migreras",
   "no-tasks": "Inga uppgifter",
+  "no-vif-detected": "Ingen VIF hittades",
   "none": "Inga",
   "not-found": "Hittades inte",
   "object": "Objekt",
@@ -303,9 +337,10 @@
   "patches": "Patchar",
   "pause": "Pausa",
   "physical-interface-status": "Status för fysiska gränssnitt",
+  "pick-template": "Välj mall",
   "pif": "PIF",
   "pif-status": "PIF-status",
-  "pifs": "PIFs",
+  "pifs": "PIFar",
   "pifs-status": "PIF status",
   "please-confirm": "Vänligen bekräfta",
   "pool-cpu-usage": "Användning av CPU-pool",
@@ -323,7 +358,9 @@
   "professional-support": "Professionell support",
   "properties": "Egenskaper",
   "property": "Egenskap",
-  "ram": "",
+  "pxe": "PXE",
+  "quick-info": "Snabbinfo",
+  "ram": "RAM",
   "ram-usage": "RAM-användning",
   "reboot": "Starta om",
   "receive": "Ta emot",
@@ -346,6 +383,7 @@
   "see-all": "Se alla",
   "select-compression": "Välj en komprimering",
   "select-destination-host": "Välj en destinationshost",
+  "select-host": "Välj host",
   "select-to-see-details": "Välj ett objekt för att se detaljer",
   "select.network": "Välj ett nätverk",
   "select.storage": "Välj en lagring",
@@ -357,10 +395,14 @@
   "shutdown": "Stäng av",
   "sidebar.search-tree-view": "Sök i trädvyn",
   "sidebar.vms-treeview": "VM-trädvy",
+  "size": "Storlek",
   "snapshot": "Snapshot",
+  "sockets-with-cores-per-socket": "{nSockets} socklar × {nCores} kärnor/sockel",
   "sort-by": "Sortera efter",
   "speed": "Hastighet",
+  "sr": "SR",
   "ssh-account": "SSH-konto",
+  "ssh-key": "SSH-nyckel",
   "ssh-login": "SSH-inloggning",
   "ssh-password": "SSH-lösenord",
   "ssh-password-confirm": "Verifiera SSH-lösenord",
@@ -368,14 +410,17 @@
   "stacked-ram-usage": "Staplad RAM-användning",
   "start": "Starta",
   "start-on-host": "Starta på specifik host",
-  "started": "",
+  "started": "Startad",
+  "state": "Status",
   "static": "Statisk",
   "static-ip": "Statisk IP",
   "stats": "Statistik",
   "status": "Status",
   "storage": "Lagring",
+  "storage-repositories": "Lagringsförvar",
   "storage-repository": "Lagringsförvar",
   "storage-usage": "Lagringsanvändande",
+  "summary": "Summering",
   "support": "Support",
   "suspend": "Suspendera",
   "switch-theme": "Byt tema",
@@ -383,7 +428,7 @@
   "table-actions": "Tabellåtgärder",
   "tags": "Taggar",
   "task.estimated-end": "Estimerad sluttid",
-  "task.progress": "Status",
+  "task.progress": "Framsteg",
   "task.started": "Startad",
   "tasks": "Uppgifter",
   "tasks.n-subtasks": "{n} underuppgift | {n} underuppgifter",
@@ -393,18 +438,20 @@
   "tasks.quick-view.done": "Klar",
   "tasks.quick-view.failed": "Misslyckades",
   "tasks.quick-view.in-progress": "Pågår",
+  "template": "Mall",
   "theme-auto": "Auto",
   "theme-dark": "Mörkt",
   "theme-light": "Ljust",
   "this-vm-cant-be-migrated": "Denna VM kan inte migreras",
   "top-#": "Topp {n}",
+  "topology": "Topologi",
   "total": "Totalt",
   "total-cpus": "Totalt antal CPUer",
-  "total-free": "",
+  "total-free": "Totalt ledigt",
   "total-free:": "Totalt ledigt:",
   "total-memory": "Totalt minne",
   "total-storage-repository": "Totalt lagringsutrymme",
-  "total-used": "",
+  "total-used": "Totalt använt",
   "total-used:": "Totalt använt:",
   "unknown": "Okänt",
   "unlocked": "Upplåst",
@@ -412,10 +459,16 @@
   "unreachable-hosts-reload-page": "Färdigt, ladda om sidan",
   "up-to-date": "Uppdaterad",
   "used": "Använt",
+  "user-config": "Användarkonfiguration",
   "uuid": "UUID",
   "vcpus": "vCPUer",
   "vcpus-used": "vCPUer använt",
+  "vdis": "VDI | VDI | VDIer",
   "version": "Version",
+  "vif": "VIF",
+  "vif-device": "VIF #{device}",
+  "vif-status": "VIF-status",
+  "vifs": "VIFar",
   "vlan": "VLAN",
   "vm": "VM",
   "vm-description": "VM beskrivning",
@@ -424,9 +477,12 @@
   "vm.inactive": "Inaktiv",
   "vms": "VMar",
   "vms-status": "VM status",
+  "vms-status.halted": "Stannad",
   "vms-status.inactive": "Inaktiv",
   "vms-status.inactive.tooltip": "Avstängd eller suspenderad",
+  "vms-status.paused": "Pausad",
   "vms-status.running": "Igång",
+  "vms-status.suspended": "Suspenderad",
   "vms-status.unknown": "Okänt",
   "vms-status.unknown.tooltip": "För vilken XO har förlorat kontakten med poolen",
   "xo-backups": "XO-backuper",

package/lib/packages/collection/README.md

@@ -0,0 +1,172 @@
+# `useCollection` composable
+
+The `useCollection` composable helps you manage a collection of items with flags (boolean states) and computed properties. It provides a type-safe way to filter, flag, and manipulate items in a collection.
+
+## Usage
+
+```typescript
+const { items, useSubset, useFlag } = useCollection(sources, {
+  flags: ['selected', 'active', { highlighted: { multiple: false } }],
+  properties: source => ({
+    id: source.theId, // Required if TSource doesn't have an `id` property
+    isAvailable: source.status === 'available',
+    fullName: `${source.firstName} ${source.lastName}`,
+  }),
+})
+```
+
+## Core Concepts
+
+- **Collection Item**: An object with a unique identifier, a reference to its source object, flags, computed properties, and methods to manipulate flags
+- **Flags**: Boolean states attached to items (like 'selected', 'active', 'highlighted')
+- **Properties**: Additional custom values
+
+## `useCollection` parameters
+
+| Name      | Type                                             | Required | Description                                          |
+| --------- | ------------------------------------------------ | :------: | ---------------------------------------------------- |
+| `sources` | `MaybeRefOrGetter<TSource[]>`                    |    ✓     | Array of source objects for the collection           |
+| `options` | `CollectionOptions<TSource, TFlag, TProperties>` |    ~     | Configuration options for the collection (see below) |
+
+### `options` object
+
+| Name         | Type                                           | Required | Description                                                           |
+| ------------ | ---------------------------------------------- | :------: | --------------------------------------------------------------------- |
+| `flags`      | `FlagsConfig<TFlag>`                           |          | Flags that can be applied to items in the collection                  |
+| `properties` | `(source: TSource) => Record<string, unknown>` |    ~     | Function that returns additional properties for each item (see below) |
+
+### Item ID
+
+The item ID will be retrieved automatically from `TSource.id`
+
+If `TSource` doesn't provide an `id`, then `options.properties` will be required and must return at least an `id`
+
+### `FlagsConfig` type
+
+```typescript
+type FlagsConfig<TFlag extends string> = TFlag[] | { [K in TFlag]: { multiple?: boolean } }
+```
+
+Values for `multiple`:
+
+- `true` (default): multiple items can share the same flag.
+- `false`: only one item can have the flag at a time (exclusive selection). Setting the flag on one item will automatically unset it on all other items.
+
+## Return Value
+
+| Name        | Type                                        | Description                                         |
+| ----------- | ------------------------------------------- | --------------------------------------------------- |
+| `items`     | `ComputedRef<CollectionItem[]>`             | Array of collection items with flags and properties |
+| `useSubset` | `(filter: (item) => boolean) => Collection` | Creates a sub collection matching the filter        |
+| `useFlag`   | `(flag: TFlag) => UseFlagReturn`            | Utilities for working with a specific flag          |
+| `count`     | `ComputedRef<number>`                       | Number of items in the collection                   |
+
+### `CollectionItem` object
+
+| Name         | Type                           | Description                                               |
+| ------------ | ------------------------------ | --------------------------------------------------------- |
+| `id`         | `TId`                          | Unique identifier for the item (string, number or symbol) |
+| `source`     | `TSource`                      | The original source object                                |
+| `flags`      | `Record<TFlag, boolean>`       | Object containing the state of all flags for this item    |
+| `properties` | `TProperties`                  | Object containing all computed properties for this item   |
+| `toggleFlag` | `(flag, forcedValue?) => void` | Method to toggle a flag on this item                      |
+
+### UseFlagReturn object
+
+| Name        | Type                                        | Description                                            |
+| ----------- | ------------------------------------------- | ------------------------------------------------------ |
+| `items`     | `ComputedRef<CollectionItem[]>`             | Array of items that have this flag set                 |
+| `ids`       | `ComputedRef<TId[]>`                        | Array of IDs of items that have this flag set          |
+| `count`     | `ComputedRef<number>`                       | Number of items that have this flag set                |
+| `areAllOn`  | `ComputedRef<boolean>`                      | Whether all items in the collection have this flag set |
+| `areSomeOn` | `ComputedRef<boolean>`                      | Whether at least one item has this flag set            |
+| `areNoneOn` | `ComputedRef<boolean>`                      | Whether no items have this flag set                    |
+| `toggle`    | `(id, forcedValue?) => void`                | Toggle this flag on a specific item                    |
+| `toggleAll` | `(forcedValue?) => void`                    | Toggle this flag on all items in the collection        |
+| `useSubset` | `(filter: (item) => boolean) => Collection` | Creates a sub collection matching the filter           |
+
+## Flag Operations
+
+The composable provides several ways to work with flags:
+
+### Setting and Toggling Flags
+
+You can work with flags directly on collection items:
+
+```typescript
+// Set flag for a single item
+item.flags.selected = true
+
+// Toggle the 'selected' flag on an item
+// Same as item.flags.selected = !item.flags.selected
+item.toggleFlag('selected')
+
+// Force the 'selected' flag to a specific value
+// Same as item.flags.selected = true
+item.toggleFlag('selected', true)
+```
+
+You can also use the utilities provided by `useFlag`:
+
+```typescript
+// Get utilities for the 'selected' flag
+const { toggle: toggleSelected, toggleAll: toggleAllSelected } = useFlag('selected')
+
+// Toggle flag for a specific item
+toggleSelected(itemId)
+
+// Force flag to true for a specific item
+toggleSelected(itemId, true)
+
+// Toggle flag on all items
+toggleAllSelected()
+
+// Force all items to have the flag
+toggleAllSelected(true)
+```
+
+### Checking Flags
+
+You can check if an item has a flag:
+
+```typescript
+// Check if an item has a specific flag
+const isSelected = item.flags.selected
+```
+
+## Example
+
+```typescript
+const {
+  items: users,
+  useSubset,
+  count,
+} = useCollection(rawUsers, {
+  flags: ['selected'],
+  properties: user => ({
+    fullName: `${user.firstName} ${user.lastName} (${user.group})`,
+  }),
+})
+
+const { items: admins, useFlag: useAdminFlag, count: adminCount } = useSubset(item => item.source.group === 'admin')
+
+const {
+  items: selectedAdmins,
+  areAllOn: areAllAdminSelected,
+  toggleAll: toggleAllAdminSelection,
+  count: selectedAdminCount,
+  toggle: toggleAdminSelection,
+} = useAdminFlag('selected')
+```
+
+It's also possible to create a subset of subset:
+
+```typescript
+const { items: users, useSubset } = useCollection(rawUsers, {
+  /* ... */
+})
+
+const { items: admins, useSubset: useAdminSubset } = useSubset(item => item.source.group === 'admin')
+
+const { items: activeAdmins } = useAdminSubset(item => item.source.status === 'active')
+```

package/lib/packages/collection/create-collection.ts

@@ -0,0 +1,74 @@
+import type {
+  Collection,
+  CollectionConfigProperties,
+  CollectionItem,
+  FlagRegistry,
+  GuessItemId,
+  UseFlagReturn,
+} from '@core/packages/collection/types.ts'
+import { useArrayFilter, useArrayMap } from '@vueuse/core'
+import { computed, type ComputedRef } from 'vue'
+
+export function createCollection<TSource, TFlag extends string, TProperties extends CollectionConfigProperties>(
+  items: ComputedRef<CollectionItem<TSource, TFlag, TProperties>[]>,
+  flagRegistry: FlagRegistry<TFlag>
+): Collection<TSource, TFlag, TProperties> {
+  function useFlag(flag: TFlag): UseFlagReturn<TSource, TFlag, TProperties> {
+    flagRegistry.assertFlag(flag)
+
+    const flaggedItems = useArrayFilter(items, item => item.flags[flag])
+
+    const ids = useArrayMap(flaggedItems, item => item.id)
+
+    const count = computed(() => flaggedItems.value.length)
+
+    const areAllOn = computed(() => items.value.length === count.value)
+
+    const areSomeOn = computed(() => count.value > 0)
+
+    const areNoneOn = computed(() => count.value === 0)
+
+    function toggle(id: GuessItemId<TSource, TProperties>, forcedValue?: boolean) {
+      flagRegistry.toggleFlag(id, flag, forcedValue)
+    }
+
+    function toggleAll(forcedValue = !areAllOn.value) {
+      for (const item of items.value) {
+        flagRegistry.toggleFlag(item.id, flag, forcedValue)
+      }
+    }
+
+    function useSubset(
+      filter: (item: CollectionItem<TSource, TFlag, TProperties>) => boolean
+    ): Collection<TSource, TFlag, TProperties> {
+      return createCollection(useArrayFilter(flaggedItems, filter), flagRegistry)
+    }
+
+    return {
+      items: flaggedItems,
+      ids,
+      count,
+      areAllOn,
+      areSomeOn,
+      areNoneOn,
+      toggle,
+      toggleAll,
+      useSubset,
+    }
+  }
+
+  function useSubset(
+    filter: (item: CollectionItem<TSource, TFlag, TProperties>) => boolean
+  ): Collection<TSource, TFlag, TProperties> {
+    return createCollection(useArrayFilter(items, filter), flagRegistry)
+  }
+
+  const count = computed(() => items.value.length)
+
+  return {
+    items,
+    count,
+    useFlag,
+    useSubset,
+  }
+}

package/lib/packages/collection/create-item.ts

@@ -0,0 +1,39 @@
+import { guessItemId } from '@core/packages/collection/guess-item-id.ts'
+import type { CollectionConfigProperties, CollectionItem, FlagRegistry } from '@core/packages/collection/types.ts'
+import { reactive } from 'vue'
+
+export function createItem<TSource, TFlag extends string, TProperties extends CollectionConfigProperties>(
+  source: TSource,
+  getProperties: undefined | ((source: TSource) => TProperties),
+  flagRegistry: FlagRegistry<TFlag>
+): CollectionItem<TSource, TFlag, TProperties> {
+  const properties = reactive(getProperties?.(source) ?? ({} as TProperties))
+
+  const id = guessItemId(source, properties)
+
+  return {
+    id,
+    source,
+    toggleFlag(flag: TFlag, forcedValue?: boolean) {
+      flagRegistry.toggleFlag(id, flag, forcedValue)
+    },
+    flags: new Proxy({} as Record<TFlag, boolean>, {
+      has(_, flag: TFlag) {
+        return flagRegistry.isFlagDefined(flag)
+      },
+      get(_, flag: TFlag) {
+        if (!flagRegistry.isFlagDefined(flag)) {
+          return undefined
+        }
+
+        return flagRegistry.isFlagged(id, flag)
+      },
+      set(_, flag: TFlag, value: boolean) {
+        flagRegistry.toggleFlag(id, flag, value)
+
+        return true
+      },
+    }),
+    properties,
+  }
+}

package/lib/packages/collection/guess-item-id.ts

@@ -0,0 +1,26 @@
+import type { CollectionConfigProperties, GuessItemId } from '@core/packages/collection/types.ts'
+
+function assertValidId(id: unknown): asserts id is PropertyKey {
+  const type = typeof id
+
+  if (!['string', 'number', 'symbol'].includes(type)) {
+    throw new TypeError(`Invalid ID type: ${type}. Expected string, number, or bigint.`)
+  }
+}
+
+export function guessItemId<TSource, TProperties extends CollectionConfigProperties>(
+  source: TSource,
+  properties: TProperties | undefined
+) {
+  let id
+
+  if (typeof properties === 'object' && properties !== null && 'id' in properties) {
+    id = properties.id
+  } else if (typeof source === 'object' && source !== null && 'id' in source) {
+    id = source.id
+  }
+
+  assertValidId(id)
+
+  return id as GuessItemId<TSource, TProperties>
+}

package/lib/packages/collection/index.ts

@@ -0,0 +1,2 @@
+export * from './types.ts'
+export * from './use-collection.ts'