@xen-orchestra/web-core 0.20.1 → 0.21.0

package/lib/locales/en.json

@@ -1,4 +1,6 @@
 {
+  "2nd-last": "2nd last",
+  "3rd-last": "3rd last",
   "about": "About",
   "access-forum": "Access forum",
   "access-xoa": "Access XOA",
@@ -22,8 +24,8 @@
   "alarm-type.sr_io_throughput_total_per_host": "SR IO throughput total per host exceeds {n}%",
   "alarm-type.unknown": "Unknown alarm type",
   "alarms": "Alarms",
-  "all-good": "All good!",
   "all-done": "All done!",
+  "all-good": "All good!",
   "allow-self-signed-ssl": "You may need to allow self-signed SSL certificates in your browser",
   "appearance": "Appearance",
   "ascending": "ascending",
@@ -35,6 +37,7 @@
   "back-site-dashboard": "Go back to your site dashboard",
   "backup": "Backup",
   "backup-issues": "Backup issues",
+  "backup-network": "Backup network",
   "backup-repository": "Backup repository (local, NFS, SMB)",
   "backups": "Backups",
   "backups.jobs": "Jobs",
@@ -76,6 +79,7 @@
   "confirm-cancel": "Are you sure you want to cancel?",
   "confirm-delete": "You're about to delete {0}",
   "connected": "Connected",
+  "connections": "Connections",
   "console": "Console",
   "console-actions": "Console actions",
   "console-clipboard": "Console clipboard",
@@ -124,7 +128,9 @@
   "cpu-usage": "CPU usage",
   "cpu-weight": "CPU weight",
   "cpus": "CPUs",
+  "crash-dump-storage-repository": "Crash dump storage repository",
   "create": "Create",
+  "created-on": "Created on",
   "custom-config": "Custom config",
   "dark-mode.auto": "Auto dark mode",
   "dark-mode.disable": "Disable dark mode",
@@ -132,6 +138,7 @@
   "dashboard": "Dashboard",
   "default-behavior": "Default behavior",
   "default-locking-mode": "Default locking mode",
+  "default-storage-repository": "Default storage repository",
   "delete": "Delete",
   "delete-vms": "Delete 1 VM | Delete {n} VMs",
   "deploy": "Deploy",
@@ -173,6 +180,7 @@
   "export-vm": "Export VM",
   "export-vms": "Export VMs",
   "export-vms-manually-information": "Some VM exports were not able to start automatically, probably due to your browser settings. To export them, you should click on each one. (Alternatively, copy the link as well.)",
+  "failure": "Failure",
   "fast-clone": "Fast clone",
   "fetching-fresh-data": "Fetching fresh data",
   "filter.comparison.contains": "Contains",
@@ -204,6 +212,7 @@
   "gzip": "gzip",
   "hardware": "Hardware",
   "hardware-specifications": "Hardware specifications",
+  "heartbeat-storage-repository": "Heartbeat storage repository",
   "here": "Here",
   "high-availability": "High availability (HA)",
   "host": "Host",
@@ -222,10 +231,11 @@
   "hosts-status.unknown": "Unknown",
   "hosts-status.unknown.tooltip": "Hosts metrics are unavailable",
   "hyper-threading": "Hyper threading (SMT)",
-  "id": "Id",
+  "id": "ID",
   "in-last-three-jobs": "In their last three jobs",
   "install-settings": "Install settings",
   "interfaces": "Interface | Interface | Interfaces",
+  "interrupted": "Interrupted",
   "invalid-field": "Invalid field",
   "ip-address": "IP address",
   "ip-addresses": "IP addresses",
@@ -233,6 +243,7 @@
   "is-primary-host": "{name} is primary host",
   "iscsi-iqn": "iSCSI IQN",
   "iso-dvd": "ISO/DVD",
+  "job-name": "Job name",
   "job.vm-copy.bad-power-state": "VM must be halted",
   "job.vm-copy.in-progress": "Copy in progress…",
   "job.vm-copy.missing-vms": "No VM to copy",
@@ -280,6 +291,7 @@
   "keep-me-logged": "Keep me logged in",
   "keep-page-open": "Do not refresh or quit tab before end of deployment.",
   "language": "Language",
+  "last": "Last",
   "last-week": "Last week",
   "learn-more": "Learn more",
   "license-socket": "License socket",
@@ -308,6 +320,7 @@
   "memory-usage": "Memory usage",
   "migrate": "Migrate",
   "migrate-n-vms": "Migrate 1 VM | Migrate {n} VMs",
+  "migration-compression": "Migration compression",
   "minimum-cpu-limit": "Minimum CPU limit",
   "minimum-dynamic-memory": "Minimum dynamic memory",
   "minimum-static-memory": "Minimum static memory",
@@ -357,6 +370,7 @@
   "no-vif-detected": "No VIF detected",
   "none": "None",
   "not-found": "Not found",
+  "not-running": "Not running",
   "not-yet-available": "Information is not yet available",
   "object": "Object",
   "object-not-found": "Object {id} can't be found…",
@@ -385,6 +399,7 @@
   "please-confirm": "Please confirm",
   "pool": "Pool",
   "pool-cpu-usage": "Pool CPU Usage",
+  "pool-management": "Pool management",
   "pool-ram-usage": "Pool RAM Usage",
   "pools": "Pools",
   "pools-status": "Pools status",
@@ -392,22 +407,24 @@
   "pools-status.unknown": "Unknown",
   "pools-status.unknown.tooltip": "Servers currently connecting or in an unknown state",
   "pools-status.unreachable": "Unreachable",
-  "pools-status.unreachable.tooltip": "Configured servers that can not be reached",
+  "pools-status.unreachable.tooltip": "Configured servers that cannot be reached",
   "power-on-host-for-console": "Power on your host to access its console",
   "power-on-mode": "Power on mode",
   "power-on-vm-for-console": "Power on your VM to access its console",
   "power-state": "Power state",
-  "primary-host": "Primary host",
   "professional-support": "Professional support",
   "properties": "Properties",
   "property": "Property",
   "protect-from-accidental-deletion": "Protect from accidental deletion",
   "protect-from-accidental-shutdown": "Protect from accidental shutdown",
+  "proxy-url": "Proxy URL",
   "pxe": "PXE",
   "quick-info": "Quick info",
   "ram": "RAM",
   "ram-provisioning": "RAM provisioning",
   "ram-usage": "RAM usage",
+  "read": "Read",
+  "read-only": "Read-only",
   "reboot": "Reboot",
   "receive": "Receive",
   "reformat": "Reformat",
@@ -438,6 +455,7 @@
   "select.network": "Select a network",
   "select.storage": "Select a storage",
   "selected-vms-in-execution": "Some selected VMs are running",
+  "self-signed-certificates": "Self-signed certificates",
   "send": "Send",
   "send-ctrl-alt-del": "Send Ctrl+Alt+Del",
   "send-us-feedback": "Send us feedback",
@@ -446,6 +464,7 @@
   "sidebar.search-tree-view": "Search in treeview",
   "sidebar.vms-treeview": "VMs treeview",
   "size": "Size",
+  "skipped": "Skipped",
   "snapshot": "Snapshot",
   "sockets-with-cores-per-socket": "{nSockets} sockets × {nCores} cores/socket",
   "software-tooling": "Software & tooling",
@@ -473,6 +492,7 @@
   "storage-repositories": "Storage repositories",
   "storage-repository": "Storage repository",
   "storage-usage": "Storage usage",
+  "success": "Success",
   "summary": "Summary",
   "support": "Support",
   "suspend": "Suspend",
@@ -518,10 +538,12 @@
   "up-to-date": "Up-to-date",
   "used": "Used",
   "user-config": "User config",
+  "username": "Username",
   "uuid": "UUID",
   "vcpus": "vCPU | vCPU | vCPUs",
   "vcpus-assigned": "vCPUs assigned",
   "vcpus-used": "vCPUs used",
+  "vdi-throughput": "VDI throughput",
   "vdis": "VDI | VDI | VDIs",
   "version": "Version",
   "vga": "VGA",
@@ -534,12 +556,17 @@
   "virtual-tpm": "Virtual TPM (VTPM)",
   "virtualization-boot-settings": "Virtualization & boot settings",
   "virtualization-mode": "Virtualization mode",
+  "virtualization-type": "Virtualization type",
   "vlan": "VLAN",
   "vm": "VM",
   "vm-description": "VM description",
   "vm-is-running": "The VM is running",
   "vm-limit-topology": "VM limit topology",
   "vm-management": "VM management",
+  "vm-status.halted": "Halted",
+  "vm-status.paused": "Paused",
+  "vm-status.running": "Running",
+  "vm-status.suspended": "Suspended",
   "vm.active": "Active",
   "vm.inactive": "Inactive",
   "vms": "VM | VMs",
@@ -552,6 +579,7 @@
   "vms-status.suspended": "Suspended",
   "vms-status.unknown": "Unknown",
   "vms-status.unknown.tooltip": "For which XO has lost connection to the pool",
+  "write": "Write",
   "xo-backups": "XO backups",
   "xo-lite-under-construction": "XOLite is under construction",
   "xo-replications": "XO replications",

package/lib/locales/es.json

@@ -203,7 +203,7 @@
   "hosts-status.running": "En marcha",
   "hosts-status.unknown": "Desconocido",
   "hosts-status.unknown.tooltip": "Métricas de servidores no son disponibles",
-  "id": "Id",
+  "id": "ID",
   "in-last-three-jobs": "En las últimas tres tareas",
   "install-settings": "Parámetros de instalación",
   "interfaces": "Interfaz | Interfaz | Interfaces",

package/lib/locales/fr.json

@@ -1,4 +1,6 @@
 {
+  "2nd-last": "Avant-dernier",
+  "3rd-last": "Avant-avant-dernier",
   "about": "À propos",
   "access-forum": "Accès au forum",
   "access-xoa": "Accéder à la XOA",
@@ -22,8 +24,8 @@
   "alarm-type.sr_io_throughput_total_per_host": "Le débit total de l'IO SR par hôte dépasse {n}%",
   "alarm-type.unknown": "Type d'alarme inconnu",
   "alarms": "Alarmes",
-  "all-good": "Tout va bien !",
   "all-done": "Tout est terminé !",
+  "all-good": "Tout va bien !",
   "allow-self-signed-ssl": "Vous devrez peut-être autoriser les certificats SSL auto-signés depuis votre navigateur",
   "appearance": "Apparence",
   "ascending": "ascendant",
@@ -35,6 +37,7 @@
   "back-site-dashboard": "Revenir au tableau de bord du site",
   "backup": "Sauvegarde",
   "backup-issues": "Problèmes de sauvegarde",
+  "backup-network": "Réseau de sauvegarde",
   "backup-repository": "Dépôt de sauvegarde (local, NFS, SMB)",
   "backups": "Sauvegardes",
   "backups.jobs": "Jobs",
@@ -76,6 +79,7 @@
   "confirm-cancel": "Êtes-vous sûr de vouloir annuler ?",
   "confirm-delete": "Vous êtes sur le point de supprimer {0}",
   "connected": "Connecté",
+  "connections": "Connexions",
   "console": "Console",
   "console-actions": "Actions de la console",
   "console-clipboard": "Presse-papiers de la console",
@@ -124,7 +128,9 @@
   "cpu-usage": "Utilisation CPU",
   "cpu-weight": "Pondération CPU",
   "cpus": "CPUs",
+  "crash-dump-storage-repository": "Dépôt de stockage des log de crash",
   "create": "Créer",
+  "created-on": "Créé le",
   "custom-config": "Configuration personnalisée",
   "dark-mode.auto": "Mode sombre automatique",
   "dark-mode.disable": "Désactiver le mode sombre",
@@ -132,6 +138,7 @@
   "dashboard": "Tableau de bord",
   "default-behavior": "Comportement par défaut",
   "default-locking-mode": "Mode de verrouillage par défaut",
+  "default-storage-repository": "Dépôt de stockage par défaut",
   "delete": "Supprimer",
   "delete-vms": "Supprimer 1 VM | Supprimer {n} VMs",
   "deploy": "Déployer",
@@ -173,6 +180,7 @@
   "export-vm": "Exporter la VM",
   "export-vms": "Exporter les VMs",
   "export-vms-manually-information": "Certaines exportations de VMs n'ont pas pu démarrer automatiquement, peut-être en raison des paramètres du navigateur. Pour les exporter, vous devrez cliquer sur chacune d'entre elles. (Ou copier le lien.)",
+  "failure": "Echec",
   "fast-clone": "Clonage rapide",
   "fetching-fresh-data": "Récupération de données à jour",
   "filter.comparison.contains": "Contient",
@@ -204,6 +212,7 @@
   "gzip": "gzip",
   "hardware": "Matériel",
   "hardware-specifications": "Spécifications matérielles",
+  "heartbeat-storage-repository": "Dépôt de stockage pour le heartbeat de la haute disponibilité",
   "here": "Ici",
   "high-availability": "Haute Disponibilité (HA)",
   "host": "Hôte",
@@ -222,10 +231,11 @@
   "hosts-status.unknown": "Inconnu",
   "hosts-status.unknown.tooltip": "Les métriques de l'hôte sont inaccessibles",
   "hyper-threading": "Hyper-threading (SMT)",
-  "id": "Id",
+  "id": "ID",
   "in-last-three-jobs": "Dans leurs trois derniers jobs",
   "install-settings": "Paramètres d'installation",
   "interfaces": "Interface | Interface | Interfaces",
+  "interrupted": "Interrompu",
   "invalid-field": "Champ invalide",
   "ip-address": "Adresse IP",
   "ip-addresses": "Adresses IP",
@@ -233,6 +243,7 @@
   "is-primary-host": "{name} est l'hôte primaire",
   "iscsi-iqn": "iSCSI IQN",
   "iso-dvd": "ISO/DVD",
+  "job-name": "Nom du job",
   "job.vm-copy.bad-power-state": "La VM doit être arrêtée",
   "job.vm-copy.in-progress": "Copie en cours…",
   "job.vm-copy.missing-vms": "Aucune VM à copier",
@@ -280,6 +291,7 @@
   "keep-me-logged": "Rester connecté",
   "keep-page-open": "Ne pas rafraichir ou quitter cette page avant la fin du déploiement.",
   "language": "Langue",
+  "last": "Dernier",
   "last-week": "Semaine dernière",
   "learn-more": "En savoir plus",
   "license-socket": "Licence socket",
@@ -308,6 +320,7 @@
   "memory-usage": "Utilisation de la mémoire",
   "migrate": "Migrer",
   "migrate-n-vms": "Migrer 1 VM | Migrer {n} VMs",
+  "migration-compression": "Compression des migrations",
   "minimum-cpu-limit": "Nombre minimal de CPU",
   "minimum-dynamic-memory": "Mémoire dynamique minimale",
   "minimum-static-memory": "Mémoire statique minimale",
@@ -357,6 +370,7 @@
   "no-vif-detected": "Aucun VIF détecté",
   "none": "Aucun",
   "not-found": "Non trouvé",
+  "not-running": "Pas en cours d'exécution",
   "not-yet-available": "Information pas encore disponible",
   "object": "Objet",
   "object-not-found": "L'objet {id} est introuvable…",
@@ -385,6 +399,7 @@
   "please-confirm": "Veuillez confirmer",
   "pool": "Pool",
   "pool-cpu-usage": "Utilisation CPU du Pool",
+  "pool-management": "Gestion du Pool",
   "pool-ram-usage": "Utilisation RAM du Pool",
   "pools": "Pools",
   "pools-status": "Statut des pools",
@@ -397,17 +412,19 @@
   "power-on-mode": "Mode d'alimentation",
   "power-on-vm-for-console": "Allumez votre VM pour accéder à sa console",
   "power-state": "État d'alimentation",
-  "primary-host": "Hôte primaire",
   "professional-support": "Support professionnel",
   "properties": "Propriétés",
   "property": "Propriété",
   "protect-from-accidental-deletion": "Protection contre les suppressions accidentelles",
   "protect-from-accidental-shutdown": "Protection contre les extinctions accidentelles",
+  "proxy-url": "URL du proxy",
   "pxe": "PXE",
   "quick-info": "Informations rapides",
   "ram": "RAM",
   "ram-provisioning": "Provisionnement RAM",
   "ram-usage": "Utilisation de la RAM",
+  "read": "Lecture",
+  "read-only": "Lecture seule",
   "reboot": "Redémarrer",
   "receive": "Recevoir",
   "reformat": "Reformater",
@@ -438,6 +455,7 @@
   "select.network": "Sélectionner un réseau",
   "select.storage": "Sélectionner un SR",
   "selected-vms-in-execution": "Certaines VMs sélectionnées sont en cours d'exécution",
+  "self-signed-certificates": "Certificats auto-signés",
   "send": "Envoyer",
   "send-ctrl-alt-del": "Envoyer Ctrl+Alt+Suppr",
   "send-us-feedback": "Envoyez-nous vos commentaires",
@@ -446,6 +464,7 @@
   "sidebar.search-tree-view": "Rechercher dans l'arborescence",
   "sidebar.vms-treeview": "Arborescence des VMs",
   "size": "Taille",
+  "skipped": "Ignoré",
   "snapshot": "Instantané",
   "sockets-with-cores-per-socket": "{nSockets} sockets × {nCores} cœurs/socket",
   "software-tooling": "Logiciels et outils",
@@ -473,6 +492,7 @@
   "storage-repositories": "Dépôts de stockage",
   "storage-repository": "Dépot de stockage",
   "storage-usage": "Utilisation du stockage",
+  "success": "Succès",
   "summary": "Résumé",
   "support": "Support",
   "suspend": "Suspendre",
@@ -518,10 +538,12 @@
   "up-to-date": "À jour",
   "used": "Utilisé",
   "user-config": "Configuration utilisateur",
+  "username": "Nom d'utilisateur",
   "uuid": "UUID",
   "vcpus": "vCPU | vCPU | vCPUs",
   "vcpus-assigned": "vCPUs assignés",
   "vcpus-used": "vCPUs utilisés",
+  "vdi-throughput": "Débit du VDI",
   "vdis": "VDI | VDI | VDIs",
   "version": "Version",
   "vga": "VGA",
@@ -534,12 +556,17 @@
   "virtual-tpm": "TPM virtuel (VTPM)",
   "virtualization-boot-settings": "Virtualisation & paramètres de démarrage",
   "virtualization-mode": "Mode de virtualisation",
+  "virtualization-type": "Type de virtualisation",
   "vlan": "VLAN",
   "vm": "VM",
   "vm-description": "Description de la VM",
   "vm-is-running": "La VM est en cours d'exécution",
   "vm-limit-topology": "Limite de topologie physique des VMs",
   "vm-management": "Gestion de la VM",
+  "vm-status.halted": "Éteinte",
+  "vm-status.paused": "En pause",
+  "vm-status.running": "Démarrée",
+  "vm-status.suspended": "Suspendue",
   "vm.active": "Active | Active | Actives",
   "vm.inactive": "Inactive | Inactive | Inactives",
   "vms": "VM | VMs",
@@ -552,6 +579,7 @@
   "vms-status.suspended": "Suspendues",
   "vms-status.unknown": "Inconnu",
   "vms-status.unknown.tooltip": "Dont XO a perdu la connexion avec le pool",
+  "write": "Écriture",
   "xo-backups": "Sauvegardes XO",
   "xo-lite-under-construction": "XOLite est en construction",
   "xo-replications": "Réplications XO",

package/lib/locales/it.json

@@ -197,7 +197,7 @@
   "hosts-status.running": "Acceso",
   "hosts-status.unknown": "Sconosciuto",
   "hosts-status.unknown.tooltip": "Misurazioni dall'host non disponibili",
-  "id": "Id",
+  "id": "ID",
   "in-last-three-jobs": "Nei loro ultimi tre lavori",
   "install-settings": "Impostazioni di installazione",
   "interfaces": "Interfaccia | Interfaccia | Interfacce",

package/lib/locales/nl.json

@@ -213,7 +213,7 @@
   "hosts-status.running": "Draait",
   "hosts-status.unknown": "Onbekend",
   "hosts-status.unknown.tooltip": "Hosts statistieken zijn niet beschikbaar",
-  "id": "Id",
+  "id": "ID",
   "in-last-three-jobs": "Tijdens hun laatste drie opdrachten",
   "install-settings": "Installatie instellingen",
   "interfaces": "Interface | Interface | Interfaces",

package/lib/locales/ru.json

@@ -143,7 +143,7 @@
   "gateway": "Шлюз",
   "go-back": "Назад",
   "gzip": "gzip",
-  "id": "Id",
+  "id": "ID",
   "ip-address": "IP адрес",
   "ip-addresses": "IP адреса",
   "ip-mode": "Режим IP",

package/lib/locales/sv.json

@@ -221,7 +221,7 @@
   "hosts-status.unknown": "Okänt",
   "hosts-status.unknown.tooltip": "Host-data är otillgängligt",
   "hyper-threading": "Multitrådning (SMT)",
-  "id": "Id",
+  "id": "ID",
   "in-last-three-jobs": "I de senaste tre jobben",
   "install-settings": "Installationsinställningar",
   "interfaces": "Gränssnitt | Gränssnitt | Gränssnitten",
@@ -395,7 +395,6 @@
   "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",

package/lib/packages/collection/README.md

@@ -6,9 +6,9 @@ The `useCollection` composable helps you manage a collection of items with flags
 
 ```typescript
 const { items, useSubset, useFlag } = useCollection(sources, {
+  itemId: source => source.theId, // Required only if TSource doesn't have an `id` property
   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}`,
   }),
@@ -18,8 +18,8 @@ const { items, useSubset, useFlag } = useCollection(sources, {
 ## 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
+- **Flags**: Arbitrary `boolean` states attached to items (like `selected`, `active`, `highlighted`, etc.)
+- **Properties**: Additional custom values attached to items, computed from the source object (like `fullName`, `isAvailable`, etc.)
 
 ## `useCollection` parameters
 
@@ -30,21 +30,22 @@ const { items, useSubset, useFlag } = useCollection(sources, {
 
 ### `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) |
+| Name         | Type                                           | Required | Description                                                                                     |
+| ------------ | ---------------------------------------------- | :------: | ----------------------------------------------------------------------------------------------- |
+| `itemId`     | `keyof TSource \| ((source: TSource) => TId)`  |    ~     | Function to retrieve the item ID or property of TSource (if not provided, `TSource.id` is used) |
+| `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`
+If `TSource` doesn't provide an `id`, then `options.itemId` will be required.
 
 ### `FlagsConfig` type
 
 ```typescript
-type FlagsConfig<TFlag extends string> = TFlag[] | { [K in TFlag]: { multiple?: boolean } }
+type FlagsConfig = string[] | Record<string, { multiple?: MaybeRef<boolean> }>
 ```
 
 Values for `multiple`:
@@ -63,13 +64,13 @@ Values for `multiple`:
 
 ### `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                      |
+| 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, shouldBeFlagged?) => void` | Method to toggle a flag on this item                      |
 
 ### UseFlagReturn object
 
@@ -81,8 +82,8 @@ Values for `multiple`:
 | `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        |
+| `toggle`    | `(id, shouldBeFlagged?) => void`            | Toggle this flag on a specific item                    |
+| `toggleAll` | `(shouldBeFlagged?) => void`                | Toggle this flag on all items in the collection        |
 | `useSubset` | `(filter: (item) => boolean) => Collection` | Creates a sub collection matching the filter           |
 
 ## Flag Operations
@@ -169,4 +170,8 @@ 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')
+
+// This would be equivalent to:
+
+const { items: activeAdmins } = useSubset(item => item.source.group === 'admin' && item.source.status === 'active')
 ```

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

@@ -1,19 +1,23 @@
+import { createUseSubset } from '@core/packages/collection/create-use-subset.ts'
 import type {
   Collection,
-  CollectionConfigProperties,
   CollectionItem,
+  CollectionItemId,
+  CollectionItemProperties,
   FlagRegistry,
-  GuessItemId,
   UseFlagReturn,
-} from '@core/packages/collection/types.ts'
+} from './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> {
+export function createCollection<
+  TSource,
+  TFlag extends string,
+  TProperties extends CollectionItemProperties,
+  TId extends CollectionItemId,
+  $TItem extends CollectionItem<TSource, TFlag, TProperties, TId>,
+>(items: ComputedRef<$TItem[]>, flagRegistry: FlagRegistry<TId, TFlag>): Collection<TSource, TFlag, TProperties, TId> {
+  function useFlag(flag: TFlag): UseFlagReturn<TSource, TFlag, TProperties, TId> {
     flagRegistry.assertFlag(flag)
 
     const flaggedItems = useArrayFilter(items, item => item.flags[flag])
@@ -28,21 +32,17 @@ export function createCollection<TSource, TFlag extends string, TProperties exte
 
     const areNoneOn = computed(() => count.value === 0)
 
-    function toggle(id: GuessItemId<TSource, TProperties>, forcedValue?: boolean) {
-      flagRegistry.toggleFlag(id, flag, forcedValue)
+    function toggle(id: TId, shouldBeFlagged?: boolean) {
+      flagRegistry.toggleFlag(id, flag, shouldBeFlagged)
     }
 
-    function toggleAll(forcedValue = !areAllOn.value) {
+    function toggleAll(shouldBeFlagged = !areAllOn.value) {
       for (const item of items.value) {
-        flagRegistry.toggleFlag(item.id, flag, forcedValue)
+        flagRegistry.toggleFlag(item.id, flag, shouldBeFlagged)
       }
     }
 
-    function useSubset(
-      filter: (item: CollectionItem<TSource, TFlag, TProperties>) => boolean
-    ): Collection<TSource, TFlag, TProperties> {
-      return createCollection(useArrayFilter(flaggedItems, filter), flagRegistry)
-    }
+    const useSubset = createUseSubset<TSource, TFlag, TProperties, TId>(flaggedItems, flagRegistry)
 
     return {
       items: flaggedItems,
@@ -57,18 +57,19 @@ export function createCollection<TSource, TFlag extends string, TProperties exte
     }
   }
 
-  function useSubset(
-    filter: (item: CollectionItem<TSource, TFlag, TProperties>) => boolean
-  ): Collection<TSource, TFlag, TProperties> {
-    return createCollection(useArrayFilter(items, filter), flagRegistry)
+  function toggleFlag(id: TId, flag: TFlag, shouldBeFlagged?: boolean) {
+    flagRegistry.toggleFlag(id, flag, shouldBeFlagged)
   }
 
+  const useSubset = createUseSubset<TSource, TFlag, TProperties, TId>(items, flagRegistry)
+
   const count = computed(() => items.value.length)
 
   return {
     items,
     count,
     useFlag,
+    toggleFlag,
     useSubset,
   }
 }