@ouestfrance/sipa-bms-ui 8.19.0 → 8.21.0

package/src/components/form/UiBmsInputCheckbox.stories.js

@@ -9,6 +9,7 @@ export default {
       page: template,
     },
   },
+  tags: ['code-only'],
   title: 'Composants/form/UiBmsInputCheckbox',
   component: UiBmsInputCheckbox,
 };

package/src/components/form/UiBmsSwitch.stories.js

@@ -8,11 +8,7 @@ export default {
       page: template,
     },
   },
-  parameters: {
-    docs: {
-      page: template,
-    },
-  },
+  tags: ['code-only'],
   title: 'Composants/form/Switch',
   component: UiBmsSwitch,
 };

package/src/components/layout/BmsForm_retrocompat.stories.js

@@ -3,6 +3,7 @@ import BmsForm from '@/components/layout/BmsForm.vue';
 export default {
   title: 'Composants/layout/BmsForm/for_retrocompat',
   component: BmsForm,
+  tags: ['code-only'],
 };
 
 const Template = (args) => ({

package/src/components/layout/BmsModal.stories.js

@@ -1,6 +1,7 @@
 import BmsModal from '@/components/layout/BmsModal.vue';
+import BmsProblem from '@/components/utils/BmsProblem.vue';
+import { isProblem } from '@/helpers/problem.helper.ts';
 import { StatusType } from '@/models/status-type.model';
-import { BmsProblem, isProblem } from '../../index';
 
 const openNotification = {
   details: 'this is a detail',

package/src/components/layout/BmsSplitWindow.vue

@@ -55,7 +55,6 @@ const collapsedLocal = ref(props.collapsed ?? false);
 watch(
   () => props.collapsed,
   (val) => {
-    console.log('watch:collapsed', val);
     collapsedLocal.value = val ?? false;
   },
 );
@@ -218,7 +217,7 @@ function clamp(value: number, minValue: number, maxValue: number) {
       <slot name="first" />
     </div>
     <div
-      class="split-window__separator toto"
+      class="split-window__separator"
       role="separator"
       tabindex="0"
       :aria-label="props.ariaLabel || 'Séparateur de volet'"
@@ -229,7 +228,9 @@ function clamp(value: number, minValue: number, maxValue: number) {
       :aria-controls="primaryId"
       @pointerdown.prevent.stop="onPointerDown"
       @keydown="onKeyDown"
-    />
+    >
+      <slot name="separator" />
+    </div>
     <div
       class="split-window__pane split-window__second-pane"
       :id="primary === 'second' ? primaryId : undefined"

package/src/components/navigation/BmsBreadcrumb.stories.js

@@ -60,21 +60,3 @@ Default.args = {
     },
   ],
 };
-
-export const WithCustomSeparator = Template.bind({});
-WithCustomSeparator.args = {
-  separator: '❤️',
-  breadcrumbs: [
-    {
-      to: { name: 'firstRoute' },
-      label: 'First route',
-    },
-    {
-      to: { name: 'secondRoute' },
-      label: 'Second route',
-    },
-    {
-      label: 'Third and final route',
-    },
-  ],
-};

package/src/components/navigation/BmsMenu.stories.js

@@ -18,8 +18,8 @@ const Template = (args) => ({
   },
   template: `
     <BmsMenu v-bind="args">
-      <template v-if="args.additionalSlot" #additional>Additional</template>
-      <template v-if="args.footerSlot" #footer>Footer</template>
+      <template v-if="args.additional" #additional>{{args.additional}}</template>
+      <template v-if="args.footer" #footer>{{args.footer}}</template>
     </BmsMenu>
   `,
 });
@@ -80,6 +80,6 @@ WithFooterSlot.args = {
     },
   ],
   activeLink: '/tutu',
-  additionalSlot: true,
-  footerSlot: true,
+  additional: 'Additional',
+  footer: 'Footer',
 };

package/src/components/navigation/BmsMenuNav.stories.js

@@ -21,8 +21,8 @@ const Template = (args) => ({
   },
   template: `
     <BmsMenuNav v-bind="args">
-      <template v-if="args.additionalSlot" #additional>Additional</template>
-      <template v-if="args.additionalSlot" #icon-end="{ item }" >
+      <template v-if="args.additional" #additional>{{args.additional}}</template>
+      <template v-if="args.iconEndCustomSlot" #icon-end="{ item }" >
         <BmsBadge :pending="item.badgeCount"></BmsBadge>
       </template>
     </BmsMenuNav>
@@ -189,5 +189,6 @@ WithAdditionalSlot.args = {
     },
   ],
   activeLink: { path: '/tutu' },
-  additionalSlot: true,
+  additional: 'Additional',
+  iconEndCustomSlot: true,
 };

package/src/components/navigation/UiMenuItem.stories.js

@@ -1,7 +1,8 @@
 import UiMenuItem from '@/components/navigation/UiMenuItem.vue';
-import { Activity } from 'lucide-vue-next';
+import { Activity, ShieldAlert, ShieldCheck, ShieldOff } from 'lucide-vue-next';
 import { vueRouter } from 'storybook-vue3-router';
 import template from '@/documentation/template_internal_component.mdx';
+import { StatusType } from '@/models';
 
 export default {
   parameters: {
@@ -9,7 +10,8 @@ export default {
       page: template,
     },
   },
-  title: 'Composants/navigation/MenuItem',
+  tags: ['code-only'],
+  title: 'Composants/navigation/UiMenuItem',
   component: UiMenuItem,
   decorators: [
     vueRouter([
@@ -77,3 +79,52 @@ Active.args = {
   },
   active: true,
 };
+
+const TemplateStatus = (args) => ({
+  components: {
+    UiMenuItem,
+  },
+  setup() {
+    return { args };
+  },
+  template: `
+      <UiMenuItem :item="args.items[0]"/>
+      <UiMenuItem :item="args.items[0]" :active="true"/>
+      <UiMenuItem :item="args.items[1]"/>
+      <UiMenuItem :item="args.items[1]" :active="true"/>
+      <UiMenuItem :item="args.items[2]"/>
+      <UiMenuItem :item="args.items[2]" :active="true"/>
+      <UiMenuItem :item="args.items[3]"/>
+      <UiMenuItem :item="args.items[3]" :active="true"/>
+    `,
+});
+
+export const WithStatusType = TemplateStatus.bind({});
+WithStatusType.args = {
+  items: [
+    {
+      label: 'Item label',
+      link: 'http://google.fr',
+      icon: ShieldAlert,
+      status: StatusType.Danger,
+    },
+    {
+      label: 'Item label',
+      link: 'http://google.fr',
+      icon: ShieldAlert,
+      status: StatusType.Warning,
+    },
+    {
+      label: 'Item label',
+      link: 'http://google.fr',
+      icon: ShieldCheck,
+      status: StatusType.Success,
+    },
+    {
+      label: 'Item label',
+      link: 'http://google.fr',
+      icon: ShieldOff,
+      status: StatusType.Information,
+    },
+  ],
+};

package/src/components/navigation/UiTab.stories.js

@@ -9,6 +9,7 @@ export default {
       page: template,
     },
   },
+  tags: ['code-only'],
   title: 'Composants/navigation/UiTab',
   component: UiTab,
   argTypes: {

package/src/components/navigation/UiTenantSwitcher.stories.js

@@ -7,6 +7,7 @@ export default {
       page: template,
     },
   },
+  tags: ['code-only'],
   title: 'Composants/navigation/UiTenantSwitcher',
   component: UiTenantSwitcher,
 };

package/src/components/table/BmsEmptyScreen.stories.js

@@ -1,31 +1,24 @@
 import BmsEmptyScreen from '@/components/table/BmsEmptyScreen.vue';
 
-// More on default export: https://storybook.js.org/docs/vue/writing-stories/introduction#default-export
 export default {
   title: 'Composants/table/EmptyScreen',
   component: BmsEmptyScreen,
-  // More on argTypes: https://storybook.js.org/docs/vue/api/argtypes
   argTypes: {},
 };
 
-// More on component templates: https://storybook.js.org/docs/vue/writing-stories/introduction#using-args
 const Template = (args) => ({
-  // Components used in your story `template` are defined in the `components` object
   components: {
     BmsEmptyScreen,
   },
-  // The story's `args` need to be mapped into the template through the `setup()` method
   setup() {
     return { args };
   },
-  // And then the `args` are bound to your component with `v-bind="args"`
   template: `
     <BmsEmptyScreen v-bind="args" />
   `,
 });
 
 export const Default = Template.bind({});
-// More on args: https://storybook.js.org/docs/vue/writing-stories/args
 Default.args = {
   title: 'Not found',
   description: "The requested data haven't been found",

package/src/components/table/BmsTableFilters.vue

@@ -53,7 +53,7 @@
           :autocompleteRequest="filter?.autocompleteRequest"
           :options="getFilterOptions(filter) as any"
           @input="
-            (e: InputEvent) =>
+            (e: any) =>
               $emits('filterInput', {
                 filterKey: filter.key,
                 value: (e.target as HTMLInputElement).value,

package/src/components/table/UiBmsTable.stories.js

@@ -11,6 +11,7 @@ export default {
       page: template,
     },
   },
+  tags: ['code-only'],
   title: 'Composants/table/UiBmsTable',
   component: UiBmsTable,
 };

package/src/components/table/UiFilterButton.stories.js

@@ -7,7 +7,8 @@ export default {
       page: template,
     },
   },
-  title: 'Composants/table/FilterButton',
+  tags: ['code-only'],
+  title: 'Composants/table/UiFilterButton',
   component: UiFilterButton,
   argTypes: {},
 };
@@ -19,16 +20,10 @@ const Template = (args) => ({
   setup() {
     return { args };
   },
-  // And then the `args` are bound to your component with `v-bind="args"`
-  template: `
-  <div style="display:flex">
-  <UiFilterButton v-bind="args" />
-  </div>
-  `,
+  template: `<UiFilterButton v-bind="args" />`,
 });
 
 export const Default = Template.bind({});
-// More on args: https://storybook.js.org/docs/vue/writing-stories/args
 Default.args = {};
 
 export const activeFilters = Template.bind({});

package/src/components/utils/BmsRelativeTime.stories.js

@@ -1,6 +1,5 @@
 import BmsRelativeTime from '@/components/utils/BmsRelativeTime.vue';
 
-// More on default export: https://storybook.js.org/docs/vue/writing-stories/introduction#default-export
 export default {
   title: 'Composants/utils/RelativeTime',
   component: BmsRelativeTime,
@@ -11,17 +10,13 @@ export default {
   },
 };
 
-// More on component templates: https://storybook.js.org/docs/vue/writing-stories/introduction#using-args
 const Template = (args) => ({
-  // Components used in your story `template` are defined in the `components` object
   components: {
     BmsRelativeTime,
   },
-  // The story's `args` need to be mapped into the template through the `setup()` method
   setup() {
     return { args };
   },
-  // And then the `args` are bound to your component with `v-bind="args"`
   template: `
     <div style="width: 400px; text-align: center;">
       <p>
@@ -44,5 +39,4 @@ const Template = (args) => ({
 });
 
 export const Primary = Template.bind({});
-// More on args: https://storybook.js.org/docs/vue/writing-stories/args
 Primary.args = {};

package/src/documentation/button/primaryButton.mdx

@@ -0,0 +1,142 @@
+import { Canvas, Meta, Controls } from '@storybook/addon-docs/blocks';
+import {
+  Playground,
+  DoSimple,
+  DoDanger,
+  DoSmall,
+  DoIconStart,
+  DoIconEnd,
+  DoSubmit,
+  DontLongLabel,
+  DoShortLabel,
+  DontMultiplePrimary,
+  DoOnePrimary,
+  DontTooManyIcons,
+  DoOneIcon,
+  DontGenericLabel,
+  DoSpecificLabel,
+  DontPrimaryForCancel,
+  DoPrimaryForSave,
+} from '../../components/button/BmsButton.stories.js';
+
+<Meta title="Documentation/Buttons/Primary" />
+
+# <img src="./BmsIcon.png" /> Primary Button
+
+The primary button should represent the main action on a screen. There should only be one primary button on an interface. If multiple actions are possible, it is essential to create a hierarchy of actions and use a primary and several secondary or tertiary buttons.
+
+## Anatomy
+
+Buttons allow users to perform an action or to navigate to another page. They have multiple styles for various needs, and are ideal for calling attention to where a user needs to do something in order to move forward in a flow.
+
+![](./button/PrimaryButtonRepresentation.png)
+
+## Component
+
+Use the controls below to interact with the component and see how it behaves with different configurations.
+
+<Canvas of={Playground} />
+
+### Props
+
+<Controls of={Playground} />
+
+## Usage Examples
+
+### ✅ Do: Simple action button
+
+Use a clear, concise label (maximum 3 words) for the primary action.
+
+<Canvas of={DoSimple} />
+
+### ✅ Do: Button with icon at start
+
+Icons can help clarify the action. Place them at the start of the button.
+
+<Canvas of={DoIconStart} />
+
+### ✅ Do: Button with icon at end
+
+Place icons at the end for navigation or forward actions.
+
+<Canvas of={DoIconEnd} />
+
+### ✅ Do: Submit button
+
+Use `submit` prop for form submissions.
+
+<Canvas of={DoSubmit} />
+
+### ✅ Do: Danger mode
+
+Use danger mode for destructive actions that require caution.
+
+<Canvas of={DoDanger} />
+
+### ✅ Do: Small variant
+
+Use the small variant when space is limited.
+
+<Canvas of={DoSmall} />
+
+## Rules
+
+### ⛔ Don't: Long labels
+
+Avoid long labels that exceed 3 words. Keep button text concise and action-oriented.
+
+**❌ Don't:**
+
+<Canvas of={DontLongLabel} />
+
+**✅ Do:**
+
+<Canvas of={DoShortLabel} />
+
+### ⛔ Don't: Multiple primary buttons
+
+Never use multiple primary buttons on the same screen. Use only one primary button per interface.
+
+**❌ Don't:**
+
+<Canvas of={DontMultiplePrimary} />
+
+**✅ Do:**
+
+<Canvas of={DoOnePrimary} />
+
+### ⛔ Don't: Overuse of icons
+
+Don't overload buttons with multiple icons or decorative elements that don't add value.
+
+**❌ Don't:**
+
+<Canvas of={DontTooManyIcons} />
+
+**✅ Do:**
+
+<Canvas of={DoOneIcon} />
+
+### ⛔ Don't: Generic labels
+
+Avoid generic labels like "Click here" or "Submit". Use specific action verbs.
+
+**❌ Don't:**
+
+<Canvas of={DontGenericLabel} />
+
+**✅ Do:**
+
+<Canvas of={DoSpecificLabel} />
+
+### ⛔ Don't: Primary for secondary actions
+
+Don't use primary buttons for secondary or cancel actions. Reserve primary buttons for the main action.
+
+**❌ Don't:**
+
+<Canvas of={DontPrimaryForCancel} />
+
+**✅ Do:**
+
+<Canvas of={DoPrimaryForSave} />

package/src/documentation/{secondaryButton.mdx → button/secondaryButton.mdx}

@@ -1,7 +1,7 @@
 import { Canvas, Meta, Story } from '@storybook/addon-docs/blocks';
-import Button from '../components/button/BmsButton.vue';
+import Button from '../../components/button/BmsButton.vue';
 
-<Meta title="Documentation/Buttons/Secondary Button" />
+<Meta title="Documentation/Buttons/Secondary" />
 
 # <img src="./BmsIcon.png" /> Secondary Button
 

package/src/documentation/foundation/contributing.mdx

@@ -0,0 +1,72 @@
+import { Meta } from '@storybook/addon-docs/blocks';
+
+<Meta title="Foundation/Contributing" />
+
+# <img src="./BmsIcon.png" /> Contributing
+
+We welcome contributions from the community! To keep the codebase healthy and consistent, please follow the process outlined below before submitting a Merge Request (MR).
+
+## Contribution – Challenging the Need for Evolution
+
+> **Before adding or modifying a component, question the underlying need.**  
+> In a design system every change propagates across many products, so it’s crucial to ensure that new work truly adds value.
+
+1. **Define the problem** – Who experiences the pain point? What user goal does it affect?
+2. **Consider existing solutions** – Can the issue be solved with a variant, a token adjustment, or a composition of existing components?
+3. **Evaluate impact** – Think about bundle size, visual consistency, accessibility, and maintenance overhead.
+
+Applying this disciplined approach helps the design system stay lean, cohesive, and future‑proof while preventing unnecessary churn.
+
+## 1️ Discuss the Change First
+
+Before you start coding, **open a thread** on Teams describing the problem you want to solve or the feature you’d like to add. Include:
+
+- A clear description of the motivation.
+- Any relevant design sketches or screenshot.
+- Links to related tickets or upstream discussions.
+
+This early conversation helps us:
+
+- Validate that the change aligns with the project roadmap.
+- Identify potential design conflicts early.
+- Agree on an implementation approach.
+
+Only after we give a **“Go‑ahead”** comment should you begin work on the MR.
+
+## 2️ Follow Our Development Standards
+
+Your contribution must meet the project's quality expectations:
+
+(WIP)
+
+If any of these checks fail, the MR will be returned for revision.
+
+## 3️ Submit Your Merge Request
+
+When the feature is complete:
+
+1. (WIP)
+
+## 4️ Review Process
+
+- **Automated checks**: CI will automatically reject the MR if linting, tests, or build steps fail.
+- **Human review**: At least one core maintainer will review the code. They may request changes, ask clarifying questions, or suggest improvements.
+- **Approval**: Once all reviewers approve and CI passes, the MR will be merged.
+
+> **We reserve the right to reject any MR** that does not meet our development standards, conflicts with the project direction, or introduces regressions. Rejections will be accompanied by constructive feedback so you can adjust and resubmit.
+
+## 5️ Post‑Merge Checklist
+
+- Verify that the change appears in the next release notes.
+- Close the associated issue (or move it to _Done_).
+- Celebrate 🎉 – you’ve contributed to the project!
+
+---
+
+### Additional Tips (Optional)
+
+- **Keep PRs small** – aim for a single logical change per MR.
+- **Write clear commit messages** – follow the Conventional Commits format (`feat: add …`, `fix: resolve …`).
+- **Respect the Code of Conduct** – treat all contributors with respect and professionalism.
+
+Thank you for helping make this project better! 🙏

package/src/documentation/foundation/gettingstarted.mdx

@@ -0,0 +1,7 @@
+import { Meta } from '@storybook/addon-docs/blocks';
+
+<Meta title="Foundation/Getting started" />
+
+# <img src="./BmsIcon.png" /> Getting started
+
+All the information are located in the Read Me on [Gitlab](https://gitlab.ouest-france.fr/sipa-ouest-france/platform/platform-library-vuejs-bms)

package/src/documentation/{principles.mdx → foundation/principles.mdx}

@@ -2,7 +2,7 @@ import { Meta } from '@storybook/addon-docs/blocks';
 
 ![](./CoverBmsUI.png)
 
-<Meta title="Documentation/Principles" />
+<Meta title="Foundation/Principles" />
 
 # <img src="./BmsIcon.png" /> Principles
 
@@ -16,13 +16,13 @@ bms UI focuses on the essentials, we concentrate on what is useful for interface
 
 A constraint-based design system is designed to offer a consistent user experience across all products that use it. By limiting possible interpretations, this type of design system provides a clear and consistent logic that facilitates understanding and use of the products. Constraints can be applied to visual elements such as colors, typography, and font sizes, as well as interactive elements such as buttons and menus. By using a constraint-based design system, users can interact with products with confidence, knowing that the design elements will be consistent and predictable.
 
-## 📖 Documentation of the **bms UI** Design System
+## Documentation of the **bms UI** Design System
 
 > **Mission** – Provide a **single Design System** dedicated to the Sipa group’s Back‑Office tools, limiting the use of the Vue framework and offering a constraint‑driven approach to interface design and construction. Goal: reduce costs, ensure visual and functional consistency, and simplify maintenance.
 
 ---
 
-### 1️⃣ Context & Objectives
+### 1️ Context & Objectives
 
 - **Who?**  
   The bms UI Design System is actually maintained by the frontend team of **bms**.
@@ -35,7 +35,7 @@ A constraint-based design system is designed to offer a consistent user experien
 - **Target audience**  
   Front‑end developers, designers, QA engineers, project managers, and anyone involved in creating or maintaining Back‑Office interfaces.
 
-### 2️⃣ Core Principles
+### 2️ Core Principles
 
 #### 2.1 Focused – Essentials First
 
@@ -59,19 +59,19 @@ A constraint-based design system is designed to offer a consistent user experien
 
 These constraints are **declarative** – they’re baked directly into components (e.g., `mode="danger"` to have a red button), preventing stylistic drift.
 
-### 3️⃣ Project Architecture
+### 3️ Project Architecture
 
 - **Single export** – `import BmsButton from '../components/button/BmsButton.vue';`
 - **Integrated Storybook** – Each component has a `*.stories.js` file showcasing the UI and the props & slots for each component.```
 - **Typescript components** - Each component as typed props & events, and the relevant types are exported by the library (e.g. TableHeader, Caption, etc.)
 
-### 4️⃣ Usage Guide
+### 4️ Usage Guide
 
-#### 4.1 Installation
+Installation
 
 Gitlab documentation https://gitlab.ouest-france.fr/sipa-ouest-france/platform/platform-library-vuejs-bms#installation
 
-### 5️⃣ Quick FAQ
+### 5️ Quick FAQ
 
 - **Can I add a custom color?**  
   **Answer:** No – all colors must come from the defined palette. If a legitimate need arises, open a **Jira** ticket.
@@ -82,7 +82,7 @@ Gitlab documentation https://gitlab.ouest-france.fr/sipa-ouest-france/platform/p
 - **Does the design system support dark mode?**  
   **Answer:** No – theming is not available at this time.
 
-### 6️⃣ Contact & Support
+### 6️ Contact & Support
 
 - **Teams**: [#🎨bmsUI](https://teams.microsoft.com/l/channel/19%3Au9dPXr-JjoRoaLat-EyS-QEKit1ZzUwQ7G0VrzvDkTE1%40thread.tacv2/%F0%9F%8E%A8bmsUI?groupId=677fd2f9-de86-4bf9-a00c-71817f033ad3&tenantId=a59e9cc9-4ed4-43c4-9f1e-ca78d44b0072&ngc=true&allowXTenantAccess=)
 - **Issues**: [#Jira] (⚠️ WIP)