@cgi-learning-hub/ui 1.6.0-dev.1747921171 → 1.6.0-dev.1749207390

package/dist/components/stories/SwitchView.stories.cjs.js

@@ -0,0 +1,143 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("react/jsx-runtime"),T=require("../../createSvgIcon-r-LuM8rr.cjs"),a=require("react"),u=require("../SwitchView/SwitchView.cjs.js"),d=require("../../Box-xgRKDOV1.cjs"),t=require("../../Typography-CTc5xI5k.cjs"),l=require("../../Grid-D0L0VF_j.cjs"),y=require("../../Button-qSgmSSw2.cjs"),o=require("../../Paper-Dy4nClba.cjs"),S=T.createSvgIcon(e.jsx("path",{d:"M20 4H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2M8 11H4V6h4zm6 0h-4V6h4zm6 0h-4V6h4zM8 18H4v-5h4zm6 0h-4v-5h4zm6 0h-4v-5h4z"}),"CalendarViewMonth"),f=T.createSvgIcon(e.jsx("path",{fillRule:"evenodd",d:"M3 3v8h8V3zm6 6H5V5h4zm-6 4v8h8v-8zm6 6H5v-4h4zm4-16v8h8V3zm6 6h-4V5h4zm-6 4v8h8v-8zm6 6h-4v-4h4z"}),"GridView"),j=T.createSvgIcon(e.jsx("path",{d:"M3 13h2v-2H3zm0 4h2v-2H3zm0-8h2V7H3zm4 4h14v-2H7zm0 4h14v-2H7zM7 7v2h14V7z"}),"List"),b=T.createSvgIcon(e.jsx("path",{d:"M21 8H3V4h18zm0 2H3v4h18zm0 6H3v4h18z"}),"TableRows"),B=T.createSvgIcon(e.jsx("path",{d:"M2 4v7h20V4zm8 16h12v-7H10zm-8 0h6v-7H2z"}),"ViewComfy"),w=T.createSvgIcon(e.jsx("path",{d:"M14.67 5v6.5H9.33V5zm1 6.5H21V5h-5.33zm-1 7.5v-6.5H9.33V19zm1-6.5V19H21v-6.5zm-7.34 0H3V19h5.33zm0-1V5H3v6.5z"}),"ViewModule"),I={title:"Components/SwitchView",component:u,argTypes:{toggleButtonList:{description:"**[Requis]** Liste des boutons à afficher dans le SwitchView.",control:"object",table:{required:!0,type:{summary:"readonly ToggleButtonItem[]"}}},viewMode:{description:"**[Requis]** Valeur actuellement sélectionnée.",control:"text",table:{required:!0,type:{summary:"T[number]['value']"}}},onChange:{description:"**[Requis]** Fonction appelée lorsqu'un bouton est sélectionné.",table:{required:!0,type:{summary:"(value: T[number]['value']) => void"}}},colorVariant:{description:"**[Optionnel]** Variante de couleur des boutons.",control:"select",options:["primary","secondary"],defaultValue:"primary",table:{required:!1,type:{summary:"ColorVariant"},defaultValue:{summary:"primary"}}},size:{description:"**[Optionnel]** Taille des boutons.",control:"select",options:["small","medium","large"],defaultValue:"small",table:{required:!1,type:{summary:"string"},defaultValue:{summary:"small"}}},orientation:{description:"**[Optionnel]** Orientation du groupe de boutons.",control:"select",options:["horizontal","vertical"],defaultValue:"horizontal",table:{required:!1,type:{summary:"string"},defaultValue:{summary:"horizontal"}}}},parameters:{docs:{description:{component:`
+## SwitchView
+
+Un composant générique TypeScript pour permettre à l'utilisateur de basculer entre différents modes d'affichage ou options avec une sécurité de type complète.
+
+### 🔥 Typage générique et sécurité des types
+
+Le SwitchView utilise TypeScript générique avancé pour inférer automatiquement les types des valeurs possibles à partir de la liste des boutons fournie. **Il n'est plus nécessaire de définir un enum**, les types sont déduits automatiquement grâce à la magie de TypeScript !
+
+**Point clé** : Utilisez toujours \`as const\` après votre tableau de boutons pour permettre l'inférence de type littéral.
+
+### 🎯 Utilisation recommandée pour éviter les types 'any'
+
+\`\`\`typescript
+// ✅ CORRECT : Définition avec 'as const' pour l'inférence de type
+const viewButtons = [
+  { value: "cards", icon: <ViewModuleIcon /> },
+  { value: "table", icon: <TableRowsIcon /> },
+  { value: "list", icon: <ListIcon /> }
+] as const; // ← IMPORTANT : ne pas oublier 'as const'
+
+// ✅ CORRECT : Typage explicite pour le state et le handler
+type ViewType = (typeof viewButtons)[number]["value"]; // "cards" | "table" | "list"
+
+const [currentView, setCurrentView] = useState<ViewType>("cards");
+
+const handleViewChange = useCallback((value: ViewType) => {
+  console.log(\`Vue sélectionnée: \${value}\`); // ← value est typé correctement
+  setCurrentView(value);
+}, []);
+
+<SwitchView 
+  toggleButtonList={viewButtons}
+  viewMode={currentView}
+  onChange={handleViewChange} // ← Pas d'erreur 'any' !
+/>
+\`\`\`
+
+### ❌ À éviter : patterns qui causent des types 'any'
+
+\`\`\`typescript
+// ❌ INCORRECT : Sans 'as const'
+const viewButtons = [
+  { value: "cards", icon: <ViewModuleIcon /> },
+  { value: "table", icon: <TableRowsIcon /> }
+]; // ← types inférés comme 'string' au lieu de littéraux
+
+// ❌ INCORRECT : Handler sans typage explicite
+const handleViewChange = (value) => { // ← 'value' aura le type 'any'
+  setCurrentView(value);
+};
+\`\`\`
+
+### 🛠️ Personnalisation
+
+- \`colorVariant\`: Choix entre les palettes "primary" et "secondary"
+- \`size\`: Contrôle la taille des boutons ("small", "medium", "large")
+- \`orientation\`: Affichage horizontal ou vertical du groupe de boutons
+- \`disabled\`: Possibilité de désactiver individuellement certains boutons
+
+### 📋 Structure des données
+
+Le composant attend un tableau d'objets \`ToggleButtonItem\` typé de manière générique :
+
+\`\`\`typescript
+interface ToggleButtonItem<T extends string = string> {
+  value: T;           // Valeur unique pour ce bouton (obligatoire)
+  icon: ReactNode;    // Icône à afficher (obligatoire)
+  disabled?: boolean; // Désactiver ce bouton spécifique (facultatif)
+}
+
+// Le composant infère automatiquement T à partir de votre tableau
+type SwitchViewProps<T extends readonly ToggleButtonItem<string>[]> = {
+  toggleButtonList: T;
+  viewMode: T[number]["value"];           // Type inféré automatiquement
+  onChange: (value: T[number]["value"]) => void; // Type inféré automatiquement
+  // ... autres props
+}
+\`\`\`
+
+### 🎉 Avantages du typage générique
+
+1. **Auto-complétion** : IDE suggère automatiquement les valeurs possibles
+2. **Vérification à la compilation** : Erreurs détectées avant l'exécution
+3. **Refactoring sûr** : Renommer une valeur met à jour toutes les références
+4. **Documentation vivante** : Les types servent de documentation
+
+### 💡 Conseils pour une utilisation optimale
+
+1. **Utilisez des types helper** pour éviter la répétition :
+\`\`\`typescript
+type ViewConfig = typeof viewButtons;
+type ViewType = ViewConfig[number]["value"];
+\`\`\`
+
+2. **Créez des constantes réutilisables** :
+\`\`\`typescript
+export const VIEW_MODES = {
+  CARDS: "cards",
+  TABLE: "table", 
+  LIST: "list"
+} as const;
+
+const viewButtons = [
+  { value: VIEW_MODES.CARDS, icon: <ViewModuleIcon /> },
+  // ...
+] as const;
+\`\`\`
+
+3. **Utilisez des factory functions** pour des configurations complexes :
+\`\`\`typescript
+const createViewButton = <T extends string>(value: T, icon: ReactNode) => 
+  ({ value, icon } as const);
+\`\`\`
+        `}}}},v=[{value:"cards",icon:e.jsx(w,{})},{value:"table",icon:e.jsx(b,{})},{value:"list",icon:e.jsx(j,{})}],C=[{value:"grid",icon:e.jsx(f,{})},{value:"cards",icon:e.jsx(B,{})},{value:"table",icon:e.jsx(b,{})},{value:"list",icon:e.jsx(j,{})},{value:"calendar",icon:e.jsx(S,{})}],q=[{value:"cards",icon:e.jsx(w,{})},{value:"table",icon:e.jsx(b,{}),disabled:!0},{value:"list",icon:e.jsx(j,{})}],P={render:()=>{const[n,i]=a.useState("cards"),c=a.useCallback(s=>{console.log(`Vue sélectionnée: ${s}`),i(s)},[]);return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Sélecteur de vue standard"}),e.jsx(u,{toggleButtonList:v,viewMode:n,onChange:c}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:2},children:["Vue actuelle: ",e.jsx("strong",{children:n})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Sélecteur de vue basique permettant de basculer entre trois modes d'affichage : cartes, tableau et liste."}}}},D={render:()=>{const[n,i]=a.useState("table"),[c,s]=a.useState("primary"),[h,r]=a.useState("small"),[x,m]=a.useState("horizontal");return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Personnalisation en temps réel"}),e.jsxs(l.Grid,{container:!0,spacing:2,sx:{mb:3},children:[e.jsxs(l.Grid,{size:{xs:12,sm:6,md:3},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"Couleur"}),e.jsxs(d.Box,{sx:{display:"flex",gap:1},children:[e.jsx(y.Button,{size:"small",variant:c==="primary"?"contained":"outlined",onClick:()=>s("primary"),children:"Primary"}),e.jsx(y.Button,{size:"small",variant:c==="secondary"?"contained":"outlined",onClick:()=>s("secondary"),children:"Secondary"})]})]}),e.jsxs(l.Grid,{size:{xs:12,sm:6,md:3},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"Taille"}),e.jsx(d.Box,{sx:{display:"flex",gap:1},children:["small","medium","large"].map(g=>e.jsx(y.Button,{size:"small",variant:h===g?"contained":"outlined",onClick:()=>r(g),children:g},g))})]}),e.jsxs(l.Grid,{size:{xs:12,sm:6,md:3},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"Orientation"}),e.jsxs(d.Box,{sx:{display:"flex",gap:1},children:[e.jsx(y.Button,{size:"small",variant:x==="horizontal"?"contained":"outlined",onClick:()=>m("horizontal"),children:"Horizontal"}),e.jsx(y.Button,{size:"small",variant:x==="vertical"?"contained":"outlined",onClick:()=>m("vertical"),children:"Vertical"})]})]}),e.jsxs(l.Grid,{size:{xs:12,sm:6,md:3},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"Vue actuelle"}),e.jsx(t.Typography,{variant:"body2",color:"primary",children:e.jsx("strong",{children:n})})]})]}),e.jsx(o.Paper,{sx:{p:3,display:"inline-block"},children:e.jsx(u,{toggleButtonList:v,viewMode:n,onChange:g=>{console.log(`Vue sélectionnée: ${g}`),i(g)},colorVariant:c,size:h,orientation:x})})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Interface de démonstration permettant de tester toutes les options de personnalisation disponibles : couleur, taille et orientation des boutons."}}}},L={render:()=>{const n=[{value:"on",icon:e.jsx(w,{})},{value:"off",icon:e.jsx(b,{})}],i=[{value:"active",icon:e.jsx(B,{})},{value:"inactive",icon:e.jsx(j,{})},{value:"pending",icon:e.jsx(f,{})}],c=[{value:"edit",icon:e.jsx(w,{})},{value:"view",icon:e.jsx(b,{})},{value:"preview",icon:e.jsx(j,{})}],[s,h]=a.useState("on"),[r,x]=a.useState("active"),[m,g]=a.useState("edit");return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Différents contextes d'utilisation"}),e.jsx(t.Typography,{variant:"body2",color:"text.secondary",paragraph:!0,children:"Le même composant s'adapte automatiquement à différents types de données."}),e.jsxs(l.Grid,{container:!0,spacing:3,children:[e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Mode binaire"}),e.jsx(t.Typography,{variant:"caption",color:"text.secondary",display:"block",sx:{mb:2},children:"Activation/Désactivation simple"}),e.jsx(u,{toggleButtonList:n,viewMode:s,onChange:p=>{console.log("Simple:",p),h(p)}}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:1},children:["État: ",s]})]})}),e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Statut système"}),e.jsx(t.Typography,{variant:"caption",color:"text.secondary",display:"block",sx:{mb:2},children:"Gestion d'états métier"}),e.jsx(u,{toggleButtonList:i,viewMode:r,onChange:p=>{console.log("Status:",p),x(p)},colorVariant:"secondary"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:1},children:["Statut: ",r]})]})}),e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Mode d'édition"}),e.jsx(t.Typography,{variant:"caption",color:"text.secondary",display:"block",sx:{mb:2},children:"Interface utilisateur adaptative"}),e.jsx(u,{toggleButtonList:c,viewMode:m,onChange:p=>{console.log("Mode:",p),g(p)},size:"medium"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:1},children:["Mode: ",m]})]})})]}),e.jsxs(o.Paper,{sx:{p:2,mt:3,backgroundColor:"info.light",color:"info.contrastText"},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"🎯 Flexibilité du composant"}),e.jsx(t.Typography,{variant:"body2",children:"Un seul composant peut gérer n'importe quel ensemble d'options, s'adaptant automatiquement au contexte d'utilisation."})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Démonstration de la polyvalence du composant avec différents ensembles d'options : mode binaire, statuts système et modes d'édition."}}}},k={render:()=>{const n=["primary","secondary"],[i,c]=a.useState({primary:"cards",secondary:"table"});return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Comparaison des variantes de couleurs"}),e.jsx(l.Grid,{container:!0,spacing:3,children:n.map(s=>e.jsx(l.Grid,{size:{xs:12,md:6},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsxs(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:["Variante ",s]}),e.jsx(u,{toggleButtonList:v,viewMode:i[s],onChange:h=>{c(r=>({...r,[s]:h}))},colorVariant:s}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:1},children:["Sélectionné: ",i[s]]})]})},s))})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Démonstration des deux variantes de couleurs disponibles : primary et secondary."}}}},G={render:()=>{const n=["small","medium","large"],[i,c]=a.useState({small:"cards",medium:"table",large:"list"});return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Comparaison des tailles"}),e.jsx(l.Grid,{container:!0,spacing:3,children:n.map(s=>e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsxs(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:["Taille ",s]}),e.jsx(u,{toggleButtonList:v,viewMode:i[s],onChange:h=>{c(r=>({...r,[s]:h}))},size:s}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:1},children:["Sélectionné: ",i[s]]})]})},s))})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Démonstration des trois tailles disponibles : small, medium et large."}}}},R={render:()=>{const[n,i]=a.useState("grid"),c=a.useCallback(s=>{i(s)},[]);return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Orientation verticale"}),e.jsxs(l.Grid,{container:!0,spacing:3,children:[e.jsx(l.Grid,{size:{xs:12,md:6},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Orientation verticale - Taille medium"}),e.jsx(u,{toggleButtonList:C,viewMode:n,onChange:c,orientation:"vertical",size:"medium"})]})}),e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Orientation horizontale (comparaison)"}),e.jsx(u,{toggleButtonList:C,viewMode:n,onChange:c,orientation:"horizontal",size:"medium"})]})})]}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:2},children:["Vue actuelle: ",e.jsx("strong",{children:n})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Démonstration de l'orientation verticale comparée à l'orientation horizontale avec plus d'options."}}}},E={render:()=>{const[n,i]=a.useState("cards"),c=a.useCallback(s=>{i(s)},[]);return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Gestion des boutons désactivés"}),e.jsxs(o.Paper,{sx:{p:3},children:[e.jsx(u,{toggleButtonList:q,viewMode:n,onChange:c,size:"medium"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:2},children:["Vue actuelle: ",e.jsx("strong",{children:n})]}),e.jsx(t.Typography,{variant:"body2",color:"text.secondary",sx:{mt:1},children:'Le bouton "Table" est désactivé dans cet exemple'}),e.jsxs(d.Box,{sx:{mt:2},children:[e.jsx(y.Button,{variant:"outlined",size:"small",onClick:()=>i("list"),sx:{mr:1},children:"Sélectionner Liste"}),e.jsx(y.Button,{variant:"outlined",size:"small",onClick:()=>i("cards"),children:"Sélectionner Cartes"})]})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Exemple montrant comment désactiver individuellement certains boutons en utilisant la propriété `disabled` dans les éléments du tableau."}}}},A={render:()=>{const[n,i]=a.useState("grid"),c=a.useCallback(s=>{i(s)},[]);return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Plus d'options d'affichage"}),e.jsxs(o.Paper,{sx:{p:3},children:[e.jsx(u,{toggleButtonList:C,viewMode:n,onChange:c,colorVariant:"secondary",size:"large"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:2},children:["Vue actuelle: ",e.jsx("strong",{children:n})]}),e.jsx(t.Typography,{variant:"body2",color:"text.secondary",sx:{mt:1},children:"Cet exemple montre un SwitchView avec 5 options différentes en variante secondary et taille large"})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Exemple avec davantage d'options pour montrer la flexibilité du composant avec plusieurs modes d'affichage."}}}},O={render:()=>{const[n,i]=a.useState("cards"),c=a.useCallback(r=>{console.log("Changement de vue:",r),i(r)},[]),s=a.useCallback(r=>{console.log("Changement externe:",r),i(r)},[]),h=()=>{switch(n){case"cards":return"Affichage en cartes - Idéal pour une vue d'ensemble visuelle";case"table":return"Affichage en tableau - Parfait pour comparer des données";case"list":return"Affichage en liste - Optimal pour parcourir rapidement";default:return"Mode d'affichage inconnu"}};return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Synchronisation avec d'autres composants"}),e.jsxs(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:["Vue actuelle: ",e.jsx("strong",{children:n})]}),e.jsx(t.Typography,{variant:"body2",color:"text.secondary",paragraph:!0,children:h()}),e.jsxs(l.Grid,{container:!0,spacing:3,children:[e.jsx(l.Grid,{size:{xs:12,md:6},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"SwitchView Principal"}),e.jsx(u,{toggleButtonList:v,viewMode:n,onChange:c,size:"medium"})]})}),e.jsx(l.Grid,{size:{xs:12,md:6},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Contrôles externes"}),e.jsx(d.Box,{sx:{display:"flex",flexDirection:"column",gap:1},children:v.map(r=>e.jsxs(y.Button,{variant:n===r.value?"contained":"outlined",onClick:()=>s(r.value),size:"small",startIcon:r.icon,children:["Mode ",r.value]},r.value))})]})})]}),e.jsxs(o.Paper,{sx:{p:2,mt:2,backgroundColor:"grey.50"},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"Actions rapides"}),e.jsx(y.Button,{variant:"text",size:"small",onClick:()=>{const r=["cards","table","list"],x=r[Math.floor(Math.random()*r.length)];s(x)},sx:{mr:1},children:"Vue aléatoire"}),e.jsx(y.Button,{variant:"text",size:"small",onClick:()=>{const x=(v.findIndex(m=>m.value===n)+1)%v.length;s(v[x].value)},children:"Vue suivante"})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Démonstration de la synchronisation entre le SwitchView et d'autres composants. Cette story montre comment le SwitchView peut être intégré dans une interface complexe où la sélection peut provenir de différentes sources mais reste synchronisée."}}}},H={render:()=>{const n=[{value:"overview",icon:e.jsx(B,{})},{value:"detailed",icon:e.jsx(b,{})},{value:"analytics",icon:e.jsx(f,{})}],i=[{value:"grid",icon:e.jsx(f,{})},{value:"list",icon:e.jsx(j,{})},{value:"tree",icon:e.jsx(w,{})}],c=[{value:"chart",icon:e.jsx(S,{})},{value:"table",icon:e.jsx(b,{})},{value:"raw",icon:e.jsx(j,{}),disabled:!0}],[s,h]=a.useState("overview"),[r,x]=a.useState("grid"),[m,g]=a.useState("chart");return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"Cas d'utilisation dans une interface complexe"}),e.jsxs(l.Grid,{container:!0,spacing:3,children:[e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2,height:"100%"},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Dashboard"}),e.jsx(u,{toggleButtonList:n,viewMode:s,onChange:p=>h(p),colorVariant:"primary",size:"small",orientation:"vertical"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:2},children:["Mode: ",s]})]})}),e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2,height:"100%"},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Explorateur de fichiers"}),e.jsx(u,{toggleButtonList:i,viewMode:r,onChange:p=>x(p),colorVariant:"secondary",size:"medium"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:2},children:["Affichage: ",r]})]})}),e.jsx(l.Grid,{size:{xs:12,md:4},children:e.jsxs(o.Paper,{sx:{p:2,height:"100%"},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Visualisation de données"}),e.jsx(u,{toggleButtonList:c,viewMode:m,onChange:p=>g(p),colorVariant:"primary",size:"large"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:2},children:["Format: ",m]}),e.jsx(t.Typography,{variant:"caption",color:"text.secondary",children:'(Le mode "raw" est temporairement désactivé)'})]})})]}),e.jsxs(o.Paper,{sx:{p:2,mt:3,backgroundColor:"info.light",color:"info.contrastText"},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"📊 Résumé des sélections (tous typés !)"}),e.jsxs(t.Typography,{variant:"body2",children:["Dashboard: ",e.jsx("strong",{children:s})," | Fichiers:"," ",e.jsx("strong",{children:r})," | Données: ",e.jsx("strong",{children:m})]})]}),e.jsxs(o.Paper,{sx:{p:2,mt:2,backgroundColor:"warning.light",color:"warning.contrastText"},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"🔍 Inspection des types"}),e.jsxs(t.Typography,{variant:"body2",component:"div",children:[e.jsx("code",{children:"DashboardType:"})," ",'"overview" | "detailed" | "analytics"',e.jsx("br",{}),e.jsx("code",{children:"FileType:"})," ",'"grid" | "list" | "tree"',e.jsx("br",{}),e.jsx("code",{children:"DataType:"})," ",'"chart" | "table" | "raw"']}),e.jsx(t.Typography,{variant:"caption",sx:{mt:1,display:"block"},children:"Chaque callback reçoit exactement le bon type, aucune configuration supplémentaire requise !"})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Exemple d'utilisation complexe montrant comment le SwitchView peut être utilisé dans différents contextes au sein d'une même interface, avec différentes configurations (tailles, couleurs, orientations) selon le besoin. Chaque instance a son propre type inféré automatiquement."}}}},U={render:()=>{const n={CARDS:"cards",TABLE:"table",LIST:"list"},i=(V,z,M=!1)=>({value:V,icon:z,disabled:M}),c=[i(n.CARDS,e.jsx(w,{})),i(n.TABLE,e.jsx(b,{})),i(n.LIST,e.jsx(j,{}))],s=[i("dashboard",e.jsx(f,{})),i("users",e.jsx(B,{})),i("settings",e.jsx(S,{})),i("logs",e.jsx(j,{}),!0)],[h,r]=a.useState(n.CARDS),[x,m]=a.useState("dashboard"),g=a.useCallback(V=>{console.log("Vue commune changée:",V),r(V)},[]),p=a.useCallback(V=>{console.log("Vue admin changée:",V),m(V)},[]);return e.jsxs(d.Box,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"🚀 Bonnes pratiques pour le typage"}),e.jsxs(l.Grid,{container:!0,spacing:3,children:[e.jsx(l.Grid,{size:{xs:12,md:6},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Configuration standard"}),e.jsx(t.Typography,{variant:"caption",color:"text.secondary",display:"block",sx:{mb:2},children:"Utilisation de constantes et factory functions"}),e.jsx(u,{toggleButtonList:c,viewMode:h,onChange:g,size:"medium"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:1},children:["Sélection: ",h]})]})}),e.jsx(l.Grid,{size:{xs:12,md:6},children:e.jsxs(o.Paper,{sx:{p:2},children:[e.jsx(t.Typography,{variant:"subtitle1",gutterBottom:!0,children:"Configuration avancée"}),e.jsx(t.Typography,{variant:"caption",color:"text.secondary",display:"block",sx:{mb:2},children:"Types spécialisés avec bouton désactivé"}),e.jsx(u,{toggleButtonList:s,viewMode:x,onChange:p,colorVariant:"secondary",size:"medium"}),e.jsxs(t.Typography,{variant:"body2",sx:{mt:1},children:["Admin: ",x]})]})})]}),e.jsxs(o.Paper,{sx:{p:3,mt:3,backgroundColor:"success.light"},children:[e.jsx(t.Typography,{variant:"h6",gutterBottom:!0,children:"📚 Code examples - Bonnes pratiques"}),e.jsxs(d.Box,{sx:{mb:2},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"1. ✅ Utilisation de constantes réutilisables"}),e.jsx(o.Paper,{sx:{p:2,backgroundColor:"grey.100"},children:e.jsx("pre",{style:{margin:0,fontSize:"0.875rem",overflow:"auto"},children:`const VIEW_MODES = {
+  CARDS: "cards",
+  TABLE: "table", 
+  LIST: "list"
+} as const;
+
+const buttons = [
+  { value: VIEW_MODES.CARDS, icon: <Icon /> }
+] as const;`})})]}),e.jsxs(d.Box,{sx:{mb:2},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"2. ✅ Factory functions pour la réutilisabilité"}),e.jsx(o.Paper,{sx:{p:2,backgroundColor:"grey.100"},children:e.jsx("pre",{style:{margin:0,fontSize:"0.875rem",overflow:"auto"},children:`const createViewButton = <T extends string>(
+  value: T, 
+  icon: ReactNode, 
+  disabled = false
+) => ({ value, icon, disabled } as const);
+
+const buttons = [
+  createViewButton("cards", <CardsIcon />),
+  createViewButton("table", <TableIcon />, true)
+] as const;`})})]}),e.jsxs(d.Box,{sx:{mb:2},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"3. ✅ Types helper pour éviter la répétition"}),e.jsx(o.Paper,{sx:{p:2,backgroundColor:"grey.100"},children:e.jsx("pre",{style:{margin:0,fontSize:"0.875rem",overflow:"auto"},children:`type ViewType = (typeof buttons)[number]["value"];
+
+const [view, setView] = useState<ViewType>("cards");
+
+const handleChange = useCallback((value: ViewType) => {
+  // value est automatiquement typé !
+  setView(value);
+}, []);`})})]}),e.jsxs(d.Box,{children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"4. ✅ Handler avec typage explicite"}),e.jsx(o.Paper,{sx:{p:2,backgroundColor:"grey.100"},children:e.jsx("pre",{style:{margin:0,fontSize:"0.875rem",overflow:"auto"},children:`<SwitchView
+  toggleButtonList={buttons}
+  viewMode={view}
+  onChange={handleChange} // ← Pas de type 'any' !
+/>`})})]})]}),e.jsxs(o.Paper,{sx:{p:2,mt:2,backgroundColor:"error.light",color:"error.contrastText"},children:[e.jsx(t.Typography,{variant:"subtitle2",gutterBottom:!0,children:"❌ À éviter"}),e.jsxs(t.Typography,{variant:"body2",component:"div",children:["• Oublier ",e.jsx("code",{children:"as const"})," après les tableaux",e.jsx("br",{}),"• Utiliser des handlers sans typage explicite",e.jsx("br",{}),"• Définir des valeurs en dur sans constantes",e.jsx("br",{}),"• Ignorer les warnings TypeScript"]})]})]})},parameters:{controls:{disable:!0},actions:{disable:!0},docs:{description:{story:"Cette story présente les meilleures pratiques pour utiliser le SwitchView avec un typage TypeScript optimal. Elle montre comment structurer votre code pour éviter les types 'any' et maximiser la sécurité de type."}}}};exports.AvecBoutonsDesactives=E;exports.BonnesPratiques=U;exports.CasUtilisationComplexe=H;exports.Controlable=D;exports.Default=P;exports.OptionsEtendues=A;exports.OrientationVerticale=R;exports.Synchronisation=O;exports.TaillesDifferentes=G;exports.TypageGenerique=L;exports.VariantesDecouleurs=k;exports.default=I;

package/dist/components/stories/SwitchView.stories.d.ts

@@ -0,0 +1,16 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { SwitchView } from '../SwitchView';
+declare const meta: Meta<typeof SwitchView>;
+export default meta;
+type Story = StoryObj<typeof SwitchView>;
+export declare const Default: Story;
+export declare const Controlable: Story;
+export declare const TypageGenerique: Story;
+export declare const VariantesDecouleurs: Story;
+export declare const TaillesDifferentes: Story;
+export declare const OrientationVerticale: Story;
+export declare const AvecBoutonsDesactives: Story;
+export declare const OptionsEtendues: Story;
+export declare const Synchronisation: Story;
+export declare const CasUtilisationComplexe: Story;
+export declare const BonnesPratiques: Story;