@xen-orchestra/web-core 0.19.0 → 0.20.1

package/lib/locales/sv.json

@@ -47,14 +47,17 @@
   "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",
+  "best-effort": "bästa möjliga insats",
   "bios-default": "bios (standardinställt)",
+  "bios-info": "BIOS-info",
   "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-bios": "Den här mallen innehåller redan BIOS-strängar",
   "boot-firmware-uefi": "Boot-programvaran är UEFI",
   "boot-vm": "Starta VM",
+  "build-number": "Versionsnummer",
   "bytes.gi": "GiB",
   "bytes.ki": "KiB",
   "bytes.mi": "MiB",
@@ -76,10 +79,12 @@
   "console-actions": "Konsolverktyg",
   "console-clipboard": "Konsolurklipp",
   "console-unavailable": "Konsolen är inte tillgänglig",
+  "control-domain-memory": "Kontrolldomänens minne",
   "copy": "Kopiera",
   "copy-all": "Kopiera allt",
   "copy-host": "Kopiera värddator",
   "copy-info-json": "Kopiera informationen till JSON",
+  "core-socket": "Kärna (sockel)",
   "core.character-limit": "{count}/{max} tecken | {count}/{max} tecken",
   "core.close": "Stäng",
   "core.copied": "Kopierad",
@@ -110,15 +115,21 @@
   "core.sort.descending": "Sotera fallande",
   "core.textarea.exceeds-max-characters": "Fältet får enbart vara {max} tecken eller färre.",
   "cores-with-sockets": "Kärnor (sockets)",
+  "cpu-cap": "CPU-gräns",
+  "cpu-mask": "CPU-mask",
+  "cpu-model": "CPU-modell",
   "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",
+  "cpu-weight": "CPU-vikt",
+  "cpus": "CPU:er",
   "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",
   "dashboard": "Kontrollpanel",
+  "default-behavior": "Standardbeteende",
   "default-locking-mode": "Standard låsläge",
   "delete": "Radera",
   "delete-vms": "Radera 1 VM | Radera {n} VMar",
@@ -153,6 +164,7 @@
   "error-no-data": "Fel, kan inte samla data.",
   "error-occurred": "Ett fel har uppstått",
   "exit-fullscreen": "Stäng fullskärm",
+  "expiration-date": "Utgångsdatum",
   "export": "Exportera",
   "export-n-vms": "Exportera 1 VM | Exportera {n} VMar",
   "export-n-vms-manually": "Exportera 1 VM manuellt | Exportera {n} VMar manuellt",
@@ -184,10 +196,15 @@
   "fullscreen": "Fullskärm",
   "fullscreen-leave": "Lämna fullskärm",
   "gateway": "Gateway",
+  "general-information": "Generell information",
   "go-back": "Gå tillbaka",
+  "gpus": "GPU:er",
+  "graphics-display": "Grafik & Skärm",
   "gzip": "gzip",
   "hardware": "Hårdvara",
+  "hardware-specifications": "Hårdvaruspecifikationer",
   "here": "Här",
+  "high-availability": "Hög tillgänglighet (HA)",
   "host": "Host",
   "host-description": "Host-beskrivning",
   "host-internal-networks": "Host-interna nätverk",
@@ -203,6 +220,7 @@
   "hosts-status.running": "Igång",
   "hosts-status.unknown": "Okänt",
   "hosts-status.unknown.tooltip": "Host-data är otillgängligt",
+  "hyper-threading": "Multitrådning (SMT)",
   "id": "Id",
   "in-last-three-jobs": "I de senaste tre jobben",
   "install-settings": "Installationsinställningar",
@@ -212,6 +230,7 @@
   "ip-addresses": "IP-adresser",
   "ip-mode": "IP-läge",
   "is-primary-host": "{name} är den primära hosten",
+  "iscsi-iqn": "iSCSI IQN",
   "iso-dvd": "ISO/DVD",
   "job.vm-copy.bad-power-state": "VMen måste vara stoppad",
   "job.vm-copy.in-progress": "Kopiering pågår…",
@@ -262,6 +281,9 @@
   "language": "Språk",
   "last-week": "Föregående vecka",
   "learn-more": "Läs mer",
+  "license-socket": "Licensiera sockel",
+  "license-type": "Licenstyp",
+  "licensing": "Licensiering",
   "load-average": "Genomsnittslast",
   "load-now": "Ladda nu",
   "loading-hosts": "Ladda hostar…",
@@ -273,16 +295,26 @@
   "login-only-on-master": "Det går endast att logga in mot huvudhosten",
   "mac-address": "MAC-adress",
   "mac-addresses": "MAC-adresser",
+  "manage-citrix-pv-drivers-via-windows-update": "Hantera Citrix PV-drivrutiner genom Windows Update",
   "management": "Hantering",
+  "management-agent-version": "Hantera agentversion",
+  "manufacturer-info": "Tillverkarinfo",
   "master": "Primärhost",
+  "maximum-cpu-limit": "Maximal CPU-begränsning",
+  "maximum-dynamic-memory": "Maximalt dynamiskt minne",
+  "maximum-static-memory": "Maximalt statiskt minne",
   "memory": "Minne",
   "memory-usage": "Minnesanvändning",
   "migrate": "Migrera",
   "migrate-n-vms": "Migrera 1 VM | Migrera {n} VMar",
+  "minimum-cpu-limit": "Minimal CPU-begränsning",
+  "minimum-dynamic-memory": "Minimalt dynamiskt minne",
+  "minimum-static-memory": "Minimalt statiskt minne",
   "missing-patches": "Saknar uppdateringar",
   "more-actions": "Fler åtgärder",
   "mtu": "MTU",
   "multi-creation": "Multi-skapande",
+  "multi-pathing": "Multianslutning",
   "n-gb-left": "{n} GB kvar",
   "n-gb-required": "{n} GB behövs",
   "n-hosts": "1 host | {n} hostar",
@@ -290,6 +322,7 @@
   "n-missing": "{n} saknas",
   "n-vms": "1 VM | {n} VM:ar",
   "name": "Namn",
+  "nested-virtualization": "Nästlad virtualisering",
   "netmask": "Nätmaskadress",
   "network": "Nätverk",
   "network-block-device": "Nätverksblockenhet",
@@ -298,6 +331,7 @@
   "network-information": "Nätverksinformation",
   "network-throughput": "Nätverksflöde",
   "network-upload": "Ladda upp",
+  "networking": "Nätverk",
   "networks": "Nätverk",
   "new": "Ny",
   "new-features-are-coming": "Nya funktioner kommer snart!",
@@ -308,6 +342,7 @@
   "new-vm.name": "VM-namn",
   "news": "Nyheter",
   "news-name": "{name} nyheter",
+  "nic-type": "NIC-typ",
   "no-alarm-triggered": "Inga larm",
   "no-config": "Ingen konfiguration",
   "no-data": "Ingen data",
@@ -321,6 +356,7 @@
   "no-vif-detected": "Ingen VIF hittades",
   "none": "Inga",
   "not-found": "Hittades inte",
+  "not-yet-available": "Informationen är inte tillgänglig än",
   "object": "Objekt",
   "object-not-found": "Objektet {id} kan inte hittas…",
   "off": "Av",
@@ -329,6 +365,8 @@
   "on-object": "på {object}",
   "open-console-in-new-tab": "Öppna konsolen i ny tabb",
   "or": "Eller",
+  "os-kernel": "OS-kärna",
+  "os-name": "OS-namn",
   "other": "Annat",
   "page-not-found": "Den här sidan kan inte hittas…",
   "partially-connected": "Delvis ansluten",
@@ -343,6 +381,7 @@
   "pifs": "PIFar",
   "pifs-status": "PIF status",
   "please-confirm": "Vänligen bekräfta",
+  "pool": "Pool",
   "pool-cpu-usage": "Användning av CPU-pool",
   "pool-ram-usage": "Användning av RAM-pool",
   "pools": "Pooler",
@@ -353,14 +392,19 @@
   "pools-status.unreachable": "Onåbar",
   "pools-status.unreachable.tooltip": "Konfigurerade servrar som inte kan nås",
   "power-on-host-for-console": "Starta din host för att ansluta till konsolen",
+  "power-on-mode": "Strömpåslagningsläge",
   "power-on-vm-for-console": "Starta din VM för att ansluta till konsolen",
   "power-state": "Strömläge",
+  "primary-host": "Primär host",
   "professional-support": "Professionell support",
   "properties": "Egenskaper",
   "property": "Egenskap",
+  "protect-from-accidental-deletion": "Skydda från oönskad borttagning",
+  "protect-from-accidental-shutdown": "Skydda från oönskad nedstängning",
   "pxe": "PXE",
   "quick-info": "Snabbinfo",
   "ram": "RAM",
+  "ram-provisioning": "RAM provisionering",
   "ram-usage": "RAM-användning",
   "reboot": "Starta om",
   "receive": "Ta emot",
@@ -374,19 +418,23 @@
   "relative-time.past": "{str} sedan",
   "relative-time.second": "1 sekund | {n} sekunder",
   "relative-time.year": "1 år | {n} år",
+  "remote-syslog": "Fjärr-syslog",
+  "resource-management": "Resurshantering",
   "resources-overview": "Resursöversikt",
   "resume": "Återuppta",
   "running-vm": "Startad VM | Startade VMar",
   "s3-backup-repository": "S3 säkerhetskopieringsförvar",
   "save": "Spara",
   "scan-pifs": "Skanna PIF",
+  "scheduler-granularity": "Schemaläggningsgrad",
+  "secure-boot": "Säker boot",
   "see-all": "Se alla",
-  "select-compression": "Välj en komprimering",
-  "select-destination-host": "Välj en destinationshost",
+  "select-compression": "Välj komprimering",
+  "select-destination-host": "Välj en destinations-host",
   "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",
+  "select.storage": "Välj lagring",
   "selected-vms-in-execution": "Vissa av de markerade VMarna är igång",
   "send": "Skicka",
   "send-ctrl-alt-del": "Skicka Ctrl+Alt+Del",
@@ -398,6 +446,7 @@
   "size": "Storlek",
   "snapshot": "Snapshot",
   "sockets-with-cores-per-socket": "{nSockets} socklar × {nCores} kärnor/sockel",
+  "software-tooling": "Mjukvara & verktyg",
   "sort-by": "Sortera efter",
   "speed": "Hastighet",
   "sr": "SR",
@@ -409,6 +458,7 @@
   "stacked-cpu-usage": "Staplad CPU-användning",
   "stacked-ram-usage": "Staplad RAM-användning",
   "start": "Starta",
+  "start-delay": "Startfördröjning",
   "start-on-host": "Starta på specifik host",
   "started": "Startad",
   "state": "Status",
@@ -417,14 +467,17 @@
   "stats": "Statistik",
   "status": "Status",
   "storage": "Lagring",
+  "storage-configuration": "Lagringskonfiguration",
   "storage-repositories": "Lagringsförvar",
   "storage-repository": "Lagringsförvar",
-  "storage-usage": "Lagringsanvändande",
+  "storage-usage": "Lagringsanvändning",
   "summary": "Summering",
   "support": "Support",
   "suspend": "Suspendera",
+  "suspend-storage-repository": "Suspendera lagringsförvar",
   "switch-theme": "Byt tema",
   "system": "System",
+  "system-disks-health": "Systemdiskhälsa",
   "table-actions": "Tabellåtgärder",
   "tags": "Taggar",
   "task.estimated-end": "Estimerad sluttid",
@@ -432,7 +485,7 @@
   "task.started": "Startad",
   "tasks": "Uppgifter",
   "tasks.n-subtasks": "{n} underuppgift | {n} underuppgifter",
-  "tasks.no-tasks": "In uppgifter",
+  "tasks.no-tasks": "Inga uppgifter",
   "tasks.quick-view": "Uppgifter snabbvy",
   "tasks.quick-view.all": "Alla",
   "tasks.quick-view.done": "Klar",
@@ -442,10 +495,13 @@
   "theme-auto": "Auto",
   "theme-dark": "Mörkt",
   "theme-light": "Ljust",
+  "this-host": "Den här hosten",
   "this-vm-cant-be-migrated": "Denna VM kan inte migreras",
+  "toolstack-uptime": "Verktygslagrets upptid",
   "top-#": "Topp {n}",
   "topology": "Topologi",
   "total": "Totalt",
+  "total-assigned": "Totalt tilldelat",
   "total-cpus": "Totalt antal CPUer",
   "total-free": "Totalt ledigt",
   "total-free:": "Totalt ledigt:",
@@ -462,22 +518,30 @@
   "user-config": "Användarkonfiguration",
   "uuid": "UUID",
   "vcpus": "vCPUer",
+  "vcpus-assigned": "vCPUs tilldelade",
   "vcpus-used": "vCPUer använt",
   "vdis": "VDI | VDI | VDIer",
   "version": "Version",
+  "vga": "VGA",
+  "video-ram": "Video RAM",
   "vif": "VIF",
   "vif-device": "VIF #{device}",
   "vif-status": "VIF-status",
   "vifs": "VIFar",
+  "viridian": "Viridian",
+  "virtual-tpm": "Virtuell TPM (VTPM)",
+  "virtualization-boot-settings": "Virtualisering & boot-inställningar",
+  "virtualization-mode": "Virtualiseringsläge",
   "vlan": "VLAN",
   "vm": "VM",
-  "vm-description": "VM beskrivning",
-  "vm-is-running": "Vmen är startad",
+  "vm-description": "VM-beskrivning",
+  "vm-is-running": "VMen är startad",
+  "vm-limit-topology": "VM-begränsningstopologi",
+  "vm-management": "VM-hantering",
   "vm.active": "Aktiv",
   "vm.inactive": "Inaktiv",
-  "vmSocketsWithCoresPerSocket": "{nSockets} socklar × {nCores} kärnor/sockel",
   "vms": "VMar",
-  "vms-status": "VM status",
+  "vms-status": "VM-status",
   "vms-status.halted": "Stannad",
   "vms-status.inactive": "Inaktiv",
   "vms-status.inactive.tooltip": "Avstängd eller suspenderad",
@@ -485,15 +549,15 @@
   "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",
+  "vms-status.unknown.tooltip": "Där XO har förlorat kontakten med poolen",
   "xo-backups": "XO-backuper",
   "xo-lite-under-construction": "XOLite är under uppbyggnad",
   "xo-replications": "XO-replikeringar",
   "xoa-admin-account": "XOA admin-konto",
-  "xoa-deploy": "XOA driftsättning",
+  "xoa-deploy": "XOA-driftsättning",
   "xoa-deploy-failed": "Ledsen, driftsättning misslyckades!",
   "xoa-deploy-retry": "Försök att driftsätta XOA igen",
-  "xoa-deploy-successful": "Driftsättning a XOA lyckades!",
+  "xoa-deploy-successful": "Driftsättning av XOA lyckades!",
   "xoa-ip": "XOA IP-adress",
   "xoa-password-confirm-different": "Bekräftelse av XOA-lösenord stämmer inte överens",
   "xoa-ssh-account": "XOA SSH-konto",

package/lib/packages/collection/README.md

@@ -6,11 +6,11 @@ The `useCollection` composable helps you manage a collection of items with flags
 
 ```typescript
 const { items, useSubset, useFlag } = useCollection(sources, {
-  identifier: source => source.id,
   flags: ['selected', 'active', { highlighted: { multiple: false } }],
   properties: source => ({
-    isAvailable: computed(() => source.status === 'available'),
-    fullName: computed(() => `${source.firstName} ${source.lastName}`),
+    id: source.theId, // Required if TSource doesn't have an `id` property
+    isAvailable: source.status === 'available',
+    fullName: `${source.firstName} ${source.lastName}`,
   }),
 })
 ```
@@ -19,22 +19,27 @@ const { items, useSubset, useFlag } = useCollection(sources, {
 
 - **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**: Computed values derived from the source object
+- **Properties**: Additional custom values
 
 ## `useCollection` parameters
 
-| Name      | Type                              | Required | Description                                          |
-| --------- | --------------------------------- | :------: | ---------------------------------------------------- |
-| `sources` | `MaybeRefOrGetter<TSource[]>`     |    ✓     | Array of source objects for the collection           |
-| `options` | `CollectionOptions<TSource, TId>` |    ✓     | Configuration options for the collection (see below) |
+| 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                                              |
-| ------------ | -------------------------------------------------- | :------: | -------------------------------------------------------- |
-| `identifier` | `(source: TSource) => TId`                         |    ✓     | Function to extract a unique identifier from each source |
-| `flags`      | `FlagsConfig<TFlag>`                               |          | Flags that can be applied to items in the collection     |
-| `properties` | `(source: TSource) => Record<string, ComputedRef>` |          | Function that returns computed properties for each item  |
+| 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
 
@@ -44,17 +49,17 @@ type FlagsConfig<TFlag extends string> = TFlag[] | { [K in TFlag]: { multiple?:
 
 Values for `multiple`:
 
-- `true` (default): multiple items can have the same flag.
+- `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 new collection that's a subset of the original |
-| `useFlag`   | `(flag: TFlag) => UseFlag`                  | Utilities for working with a specific flag               |
-| `count`     | `ComputedRef<number>`                       | Number of items in the collection                        |
+| 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
 
@@ -66,18 +71,19 @@ Values for `multiple`:
 | `properties` | `TProperties`                  | Object containing all computed properties for this item   |
 | `toggleFlag` | `(flag, forcedValue?) => void` | Method to toggle a flag on this item                      |
 
-### Return value of `useFlag(flag)`
+### 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        |
+| 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
 
@@ -136,10 +142,9 @@ const {
   useSubset,
   count,
 } = useCollection(rawUsers, {
-  identifier: user => user.id,
   flags: ['selected'],
   properties: user => ({
-    fullName: computed(() => `${user.firstName} ${user.lastName} (${user.group})`),
+    fullName: `${user.firstName} ${user.lastName} (${user.group})`,
   }),
 })
 

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

@@ -1,14 +1,21 @@
-import type { CollectionItem, FlagRegistry } from '@core/packages/collection'
+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,
-  TId extends PropertyKey,
-  TFlag extends string,
-  TProperties extends Record<string, any>,
->(items: ComputedRef<CollectionItem<TSource, TId, TFlag, TProperties>[]>, flagRegistry: FlagRegistry<TFlag>) {
-  function useFlag(flag: TFlag) {
+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)
@@ -21,7 +28,7 @@ export function createCollection<
 
     const areNoneOn = computed(() => count.value === 0)
 
-    function toggle(id: TId, forcedValue?: boolean) {
+    function toggle(id: GuessItemId<TSource, TProperties>, forcedValue?: boolean) {
       flagRegistry.toggleFlag(id, flag, forcedValue)
     }
 
@@ -31,6 +38,12 @@ export function createCollection<
       }
     }
 
+    function useSubset(
+      filter: (item: CollectionItem<TSource, TFlag, TProperties>) => boolean
+    ): Collection<TSource, TFlag, TProperties> {
+      return createCollection(useArrayFilter(flaggedItems, filter), flagRegistry)
+    }
+
     return {
       items: flaggedItems,
       ids,
@@ -40,13 +53,14 @@ export function createCollection<
       areNoneOn,
       toggle,
       toggleAll,
+      useSubset,
     }
   }
 
-  function useSubset(filter: (item: CollectionItem<TSource, TId, TFlag, TProperties>) => boolean) {
-    const filteredItems = useArrayFilter(items, item => filter(item))
-
-    return createCollection(filteredItems, flagRegistry)
+  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)

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

@@ -1,5 +1,2 @@
-export * from './build-item.ts'
-export * from './create-collection.ts'
 export * from './types.ts'
 export * from './use-collection.ts'
-export * from './use-flag-registry.ts'