origam 2.33.0 → 2.34.0

package/CHANGELOG.md

@@ -18,6 +18,14 @@ This project follows [Semantic Versioning](https://semver.org).
 
 ## [Unreleased]
 
+## [2.34.0] - 2026-10-19
+
+### Added — `OrigamCommandPalette` : prop `filter` pour afficher des résultats classés en externe (#1184)
+
+- Nouvelle prop `filter` : `true` (défaut, comportement inchangé : correspondance floue intégrée et tri par score), `false` (les `commands` sont affichées telles quelles, dans l'ordre fourni) ou une fonction `(commands, query) => commands` dont le résultat est affiché dans son ordre.
+- Destinée à la recherche serveur ou plein texte alimentée par l'événement `query` : un résultat trouvé dans le corps d'un document n'est plus masqué parce que la requête n'est pas une sous-séquence de son libellé, et le classement du moteur est conservé.
+- Avec `filter=false` ou une fonction, une liste `commands` vide reste vide : elle ne retombe plus sur le registre `useCommand()` (le repli est conservé avec `filter=true`).
+
 ## [2.33.0] - 2026-10-18
 
 ### Added — `OrigamCommandPalette` : icônes de recherche et de chargement personnalisables (#1183)

package/dist/src/components/CommandPalette/OrigamCommandPalette.vue

@@ -191,6 +191,7 @@ const props = defineProps({
   modelValue: { type: Boolean, required: false, default: false },
   hotkey: { type: [Array, null], required: false, default: () => COMMAND_PALETTE_DEFAULT_HOTKEY },
   commands: { type: Array, required: false },
+  filter: { type: [Boolean, Function], required: false, default: true },
   placeholder: { type: String, required: false, default: "origam.command_palette.placeholder" },
   emptyText: { type: String, required: false, default: "origam.command_palette.empty_text" },
   maxHeight: { type: [Number, String], required: false, default: COMMAND_PALETTE_DEFAULT_MAX_HEIGHT },
@@ -260,11 +261,17 @@ if (IN_BROWSER) {
   }, { immediate: true });
 }
 const sourceCommands = computed(() => {
-  if (props.commands && props.commands.length > 0) return props.commands;
+  if (props.commands && (props.commands.length > 0 || props.filter !== true)) return props.commands;
   return registryCommands.value;
 });
 const query = ref("");
 const filtered = computed(() => {
+  if (typeof props.filter === "function") {
+    return props.filter(sourceCommands.value, query.value).map((item) => ({ item, score: 0 }));
+  }
+  if (props.filter === false) {
+    return sourceCommands.value.map((item) => ({ item, score: 0 }));
+  }
   return fuzzyMatch(sourceCommands.value, query.value, (cmd) => ({
     label: cmd.label,
     haystack: [

package/dist/src/interfaces/CommandPalette/command-palette.interface.d.ts

@@ -1,4 +1,5 @@
 import type { ICommand } from './command.interface';
+import type { TCommandPaletteFilter } from '../../types/CommandPalette/command-palette.type';
 import type { IAttachProps } from '../Commons/attach.interface';
 import type { ICommonsComponentProps } from '../Commons/commons.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
@@ -27,6 +28,17 @@ export interface ICommandPaletteProps extends ICommonsComponentProps, Pick<ITypo
      * registered via the `useCommand()` global registry instead.
      */
     commands?: ReadonlyArray<ICommand>;
+    /*********************************************************
+     * filter (#1184)
+     *
+     * @description
+     * Comment `commands` est filtré selon la requête. `true` (défaut) : fuzzy match intégré, qui garde les sous-séquences et re-trie par score.
+     * @description
+     * `false` : `commands` affichées telles quelles, dans l'ordre fourni (liste déjà filtrée/classée par un serveur ou un moteur plein-texte, alimentée via l'event `query`).
+     * @description
+     * Fonction `(commands, query) => commands` : affiche ce qu'elle renvoie, dans son ordre. Dans les deux modes non défaut, la liste est plate (sans en-tête de groupe) tant que la requête est non vide, aucun match n'est surligné, et `commands` est honorée même vide (pas de repli sur le registre `useCommand()`).
+     ********************************************************/
+    filter?: TCommandPaletteFilter;
     /** Placeholder of the search input (already-translated string). */
     placeholder?: string;
     /** Empty-state message when no command matches the query. */

package/dist/src/types/CommandPalette/command-palette.type.d.ts

@@ -1,3 +1,4 @@
+import type { ICommand } from '../../interfaces/CommandPalette/command.interface';
 import OrigamCommandPalette from '../../components/CommandPalette/OrigamCommandPalette.vue';
 export type TOrigamCommandPalette = InstanceType<typeof OrigamCommandPalette>;
 /**
@@ -5,3 +6,13 @@ export type TOrigamCommandPalette = InstanceType<typeof OrigamCommandPalette>;
  * accepted by `useHotkey` (e.g. `['meta', 'k']`).
  */
 export type TCommandPaletteHotkeyCombination = ReadonlyArray<string>;
+/*********************************************************
+ * Filter de OrigamCommandPalette (#1184)
+ *
+ * @description
+ * `TCommandPaletteFilterFn` : reçoit les commandes et la requête brute (non trimée), renvoie les commandes à afficher, dans l'ordre d'affichage.
+ * @description
+ * `TCommandPaletteFilter` (prop `filter`) : `true` = fuzzy match intégré (filtre par sous-séquence + tri par score), `false` = `commands` affichées telles quelles et dans l'ordre fourni, fonction = son résultat est affiché dans son ordre.
+ ********************************************************/
+export type TCommandPaletteFilterFn = (commands: ReadonlyArray<ICommand>, query: string) => ReadonlyArray<ICommand>;
+export type TCommandPaletteFilter = boolean | TCommandPaletteFilterFn;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "origam",
-  "version": "2.33.0",
+  "version": "2.34.0",
   "type": "module",
   "description": "origam — a Vue 3 design system with multi-theme design tokens, CSS-first components and TypeScript types.",
   "keywords": [