origam 2.32.2 → 2.34.0

package/CHANGELOG.md

@@ -18,6 +18,22 @@ 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)
+
+- Nouvelles props `searchIcon` et `loadingIcon`, typées `TIcon` (id mdi, chemin SVG ou composant). Défauts inchangés : `mdi:mdi-magnify` et `mdi:mdi-loading`.
+- Nouveaux slots `search-icon` et `loading`, prioritaires sur les props.
+- Une application qui fournit un SVG n'a plus besoin de la police `@mdi/font` pour ces deux glyphes : aucun élément `.mdi-magnify` / `.mdi-loading` n'est rendu (prouvé par `packages/tests/e2e/command-palette.spec.ts`).
+
 ## [2.32.2] - 2026-10-17
 
 ### Fixed — `OrigamBtn` : libellé collé en haut au lieu d'être centré (#1168)

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

@@ -25,12 +25,14 @@
 						tabindex="-1"
 				>
 					<div class="origam-command-palette__search">
-						<origam-icon
-								:icon="MDI_ICONS.MAGNIFY"
-								:size="20"
-								aria-hidden="true"
-								class="origam-command-palette__search-icon"
-						/>
+						<slot name="search-icon">
+							<origam-icon
+									:icon="searchIcon"
+									:size="20"
+									aria-hidden="true"
+									class="origam-command-palette__search-icon"
+							/>
+						</slot>
 						<input
 								:id="inputId"
 								ref="inputRef"
@@ -65,11 +67,13 @@
 								v-if="loading"
 								class="origam-command-palette__loading"
 						>
-							<origam-icon
-									:icon="MDI_ICONS.LOADING"
-									:size="20"
-									class="origam-command-palette__loading-icon"
-							/>
+							<slot name="loading">
+								<origam-icon
+										:icon="loadingIcon"
+										:size="20"
+										class="origam-command-palette__loading-icon"
+								/>
+							</slot>
 						</div>
 
 						<template
@@ -180,7 +184,6 @@ import { useTypography } from "../../composables/Commons/typography.composable";
 import { useVModel } from "../../composables/Commons/vModel.composable";
 import { COMMAND_PALETTE_DEFAULT_HOTKEY, COMMAND_PALETTE_DEFAULT_MAX_HEIGHT, COMMAND_PALETTE_DEFAULT_WIDTH } from "../../consts/CommandPalette/command-palette.const";
 import { IN_BROWSER } from "../../consts/Commons/commons.const";
-import { MDI_ICONS } from "../../enums/Commons/mdi.enum";
 import { getUid } from "../../utils/Commons/getCurrentInstance.util";
 import { fuzzyMatch } from "../../utils/CommandPalette/fuzzy-match.util";
 defineOptions({ inheritAttrs: false });
@@ -188,11 +191,14 @@ 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 },
   width: { type: [Number, String], required: false, default: COMMAND_PALETTE_DEFAULT_WIDTH },
   loading: { type: Boolean, required: false, default: false },
+  searchIcon: { type: null, required: false, default: "mdi:mdi-magnify" },
+  loadingIcon: { type: null, required: false, default: "mdi:mdi-loading" },
   closeOnSelect: { type: Boolean, required: false, default: true },
   closeOnEscape: { type: Boolean, required: false, default: true },
   closeOnBackdrop: { type: Boolean, required: false, default: true },
@@ -255,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,7 +1,9 @@
 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';
+import type { TIcon } from '../../types/Icon/icon.type';
 /**
  * A hotkey is either a single combination (`['meta', 'k']`) or an
  * array of alternatives — every entry being a list of normalised key
@@ -26,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. */
@@ -36,6 +49,8 @@ export interface ICommandPaletteProps extends ICommonsComponentProps, Pick<ITypo
     width?: number | string;
     /** Display a loader inside the result list (use during async fetches). */
     loading?: boolean;
+    searchIcon?: TIcon;
+    loadingIcon?: TIcon;
     /** Close the palette automatically when a command is selected. */
     closeOnSelect?: boolean;
     /** Close when the user presses Escape. */
@@ -55,5 +70,7 @@ export interface ICommandPaletteSlotProps {
 export interface ICommandPaletteSlots {
     item?: (props: ICommandPaletteSlotProps) => any;
     empty?: () => any;
+    'search-icon'?: () => any;
+    loading?: () => any;
     footer?: () => any;
 }

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.32.2",
+  "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": [