Update deprecated sizing references

.changeset/soft-pugs-dream.md

@@ -0,0 +1,6 @@
+---
+'@swisspost/design-system-documentation': minor
+'@swisspost/design-system-styles': minor 
+---
+
+Updated the utility classes for sizing.

packages/documentation/cypress/snapshots/utilities/sizing.snapshot.ts

@@ -0,0 +1,7 @@
+describe('Sizing', () => {
+  it('Sizing', () => {
+    cy.visit('/iframe.html?id=snapshots--sizing');
+    cy.get('.snapshot', { timeout: 30000 }).should('be.visible');
+    cy.percySnapshot('Sizing', { widths: [320, 1440] });
+  });
+});

packages/documentation/src/stories/components/logo/logo.snapshot.stories.ts

@@ -23,9 +23,9 @@ export const PostLogo: Story = {
                 ${['white', 'dark'].map(
                   color => html`
                     <div class="col bg-${color}">
-                      ${['big', 'huge', 'giant'].map(
+                      ${[25, 50, 75].map(
                         (height, i) => html`
-                          <div class="h-${height} ${i === 0 ? 'my' : 'mb'}-mini">
+                          <div class="h-${height} ${i === 0 ? 'my' : 'mb'}-8">
                             ${meta.render?.({ ...context.args, url }, context)}
                           </div>
                         `,

packages/documentation/src/stories/utilities/sizing/sizing.docs.mdx

@@ -13,18 +13,20 @@ import * as SizingStories from './sizing.stories';
 
 ## Height & Width
 
-Height and width can be set using `h-*` and `w-*` prefixes, max-height and max-width can be set using prefixes `mh-*` and `mw-*` .
+    Height and width can be set using `h-*` and `w-*` prefixes, max-height and max-width can be set using prefixes `max-h-*` and `max-w-*` and min height and min width can be set using the prefixes `min-h` and `min-w`.
 
 ### Parent Based
 
-Bootstrap offers sizing classes with the suffixes bellow. They allow you to set a height / width as a percentage of the parent element (see [Bootstrap Sizing](https://getbootstrap.com/docs/5.3/utilities/sizing/) for reference).
+The design system offers sizing classes with the suffixes bellow. They allow you to set a height / width as a percentage of the parent element.
 
+> - `*-auto`
+> - `*-0`
 > - `*-25`
 > - `*-50`
 > - `*-75`
 > - `*-100`
 
-#### Example
+### Example
 
 <Canvas sourceState="shown" of={SizingStories.SizesPercent} />
 <div className="hide-col-default">
@@ -37,34 +39,7 @@ For width, we offer additionally `.w-{breakpoint}-{size}` classes (e.g. `w-md-10
 
 See <a href="/?path=/docs/eb78afcb-ce92-4990-94b6-6536d5ec6af4--docs#full-width">Full-width button</a> for a practical example.
 
-### Post-Sizes
-
-Post sizes can be used as suffixes in the same way. To find out which size name to use, see the "Size name in classes" column in the reference table above or use the "Example Post-Sizes" below.
-
-#### Sass variables
-
-{/* prettier-ignore */}
-<div className="alert alert-warning mb-40">
-  <h2 className="alert-heading">Sizing variables are deprecated</h2>
-  <p>The current set of the post-specific sizing variables is deprecated in favour of a new naming system that is consistent with the Design. For further information, please read the <a href="https://github.com/swisspost/design-system/discussions/588">discussion on sizing variables on GitHub</a> and have a look at the <a href="https://www.figma.com/file/ojCcgC5Zd12eUSzq6V5m24/Foundations?node-id=3%3A2&t=l8qimsXlxeMLOzs6-0">implementation in Figma</a>.</p>
-  <p>There is a new solution with updated naming system up coming for spacing sizes.</p>
-</div>
-
-<Source
-  language="scss"
-  dark
-  code={Object.entries(SizingStories.SCSS_VARIABLES)
-    .filter(([key, value]) => key !== 'parameters')
-    .map(([key, value]) => `$${key}: ${formatAsMap(value)};`)
-    .join('\n')}
-></Source>
-
-<Canvas of={SizingStories.Sizes} />
-<div className="hide-col-default">
-  <Controls of={SizingStories.Sizes} />
-</div>
-
-## Viewport Based
+### Viewport Based
 
 There is the possibility to set the width and height relative to the viewport.
 

packages/documentation/src/stories/utilities/sizing/sizing.snapshot.stories.ts

@@ -0,0 +1,62 @@
+import type { StoryObj } from '@storybook/web-components';
+import { html } from 'lit';
+import './sizing.styles.scss';
+import meta from './sizing.stories';
+
+const { id, ...metaWithoutId } = meta;
+
+export default {
+  ...metaWithoutId,
+  title: 'Snapshots',
+  argTypes: {
+    // ... your argTypes here
+  },
+};
+
+type Story = StoryObj;
+
+export const Sizing: Story = {
+  render: () => {
+    const nonViewportSamples = [
+      { w: '0', h: '100', maxW: '0', minW: '100', maxH: '50', minH: '0' },
+      { w: '25', h: '50', maxW: '25', minW: '50', maxH: '100', minH: '25' },
+      { w: '50', h: '25', maxW: '50', minW: '25', maxH: '75', minH: '0' },
+      { w: '75', h: '75', maxW: '75', minW: '75', maxH: '25', minH: '50' },
+      { w: '100', h: '0', maxW: '100', minW: '0', maxH: '100', minH: '0' },
+    ];
+
+    const viewportSamples = [
+      { vw: '0', vh: '100', maxVw: 'none', minVw: '100', maxVh: '50', minVh: '0' },
+      { vw: '25', vh: '50', maxVw: 'none', minVw: '50', maxVh: '100', minVh: '25' },
+      { vw: '50', vh: '25', maxVw: 'none', minVw: '25', maxVh: '75', minVh: '0' },
+      { vw: '75', vh: '75', maxVw: 'none', minVw: '75', maxVh: '25', minVh: '50' },
+      { vw: '100', vh: '100', maxVw: 'none', minVw: '0', maxVh: '100', minVh: '0' },
+    ];
+
+    return html`
+      <div class="sizing-example snapshot">
+        ${nonViewportSamples.map(sample => {
+          return html`
+            <div class="grid-item">
+              <div
+                class="w-${sample.w} h-${sample.h} max-w-${sample.maxW} min-w-${sample.minW} max-h-${sample.maxH} min-h-${sample.minH}"
+              ></div>
+            </div>
+          `;
+        })}
+      </div>
+
+      <div class="sizing-vp-example snapshot">
+        ${viewportSamples.map(sample => {
+          return html`
+            <div class="grid-item">
+              <div
+                class="vw-${sample.vw} vh-${sample.vh} max-vw-${sample.maxVw} min-vw-${sample.minVw} max-vh-${sample.maxVh} min-vh-${sample.minVh}"
+              ></div>
+            </div>
+          `;
+        })}
+      </div>
+    `;
+  },
+};

packages/documentation/src/stories/utilities/sizing/sizing.stories.ts

@@ -1,14 +1,8 @@
-import type { Args, StoryObj } from '@storybook/web-components';
+import type { Args, StoryObj, StoryFn, StoryContext } from '@storybook/web-components';
 import { html } from 'lit';
 import './sizing.styles.scss';
-import scss from './sizing.module.scss';
 import { MetaExtended } from '@root/types';
-
-export const SCSS_VARIABLES = scss;
-
-const sizingOptions = ['auto', ...Object.keys(SCSS_VARIABLES)];
-
-const sizeOptionsPercent = ['auto', '25', '50', '75', '100'];
+export const SizeOptionsPercent = ['auto', '0', '25', '50', '75', '100'];
 
 const meta: MetaExtended = {
   render: renderSizing,
@@ -18,10 +12,12 @@ const meta: MetaExtended = {
     badges: [],
   },
   args: {
-    height: 'bigger-giant',
-    width: 'bigger-giant',
-    maxHeight: 'null',
-    maxWidth: 'null',
+    height: 'none',
+    width: 'none',
+    maxHeight: 'none',
+    maxWidth: 'none',
+    minHeight: 'none',
+    minWidth: 'none',
   },
   argTypes: {
     height: {
@@ -30,67 +26,104 @@ const meta: MetaExtended = {
       control: {
         type: 'select',
       },
-      options: sizingOptions,
+      options: SizeOptionsPercent,
+      table: {
+        category: 'Height',
+      },
     },
     width: {
       name: 'width',
       description: 'Set the width of the rectangle',
       control: {
         type: 'select',
       },
-      options: sizingOptions,
+      options: SizeOptionsPercent,
+      table: {
+        category: 'Width',
+      },
     },
     maxHeight: {
       name: 'max-height',
       description: 'Set the maximum height of the rectangle',
       control: {
         type: 'select',
       },
-      options: ['none', ...sizingOptions],
+      options: ['none', ...SizeOptionsPercent.filter(value => value !== 'auto')],
+      table: {
+        category: 'Height',
+      },
     },
     maxWidth: {
       name: 'max-width',
       description: 'Set the maximum width of the rectangle',
       control: {
         type: 'select',
       },
-      options: ['none', ...sizingOptions],
+      options: ['none', ...SizeOptionsPercent.filter(value => value !== 'auto')],
+      table: {
+        category: 'Width',
+      },
+    },
+    minHeight: {
+      name: 'min-height',
+      description: 'Set the minimum height of the rectangle',
+      control: {
+        type: 'select',
+      },
+      options: ['none', ...SizeOptionsPercent.filter(value => value !== 'auto')],
+      table: {
+        category: 'Height',
+      },
+    },
+    minWidth: {
+      name: 'min-width',
+      description: 'Set the minimum width of the rectangle',
+      control: {
+        type: 'select',
+      },
+      options: ['none', ...SizeOptionsPercent.filter(value => value !== 'auto')],
+      table: {
+        category: 'Width',
+      },
     },
   },
+  decorators: [
+    (story: StoryFn, context: StoryContext) => {
+      const storyTemplate = html`
+        <div class="sizing-example">
+          <div class="d-flex p-16 gap-16" style="height: 150px">
+            <div class="flex-fill">${story(context.args, context)}</div>
+          </div>
+        </div>
+      `;
+      return storyTemplate;
+    },
+  ],
 };
 
 export default meta;
 
 type Story = StoryObj;
 
 function renderSizing(args: Args) {
-  const maximumHeight = args.maxHeight && args.maxHeight !== 'null' ? `mh-${args.maxHeight}` : '';
-  const maximumWidth = args.maxWidth && args.maxWidth !== 'null' ? `mw-${args.maxWidth}` : '';
-  const classes = `content h-${args.height} w-${args.width} ${maximumHeight} ${maximumWidth}`;
+  const classNames = [
+    `content`,
+    `h-${args.height}`,
+    `w-${args.width}`,
+    args.maxHeight && args.maxHeight !== 'none' ? `max-h-${args.maxHeight}` : '',
+    args.maxWidth && args.maxWidth !== 'none' ? `max-w-${args.maxWidth}` : '',
+    args.minHeight && args.minHeight !== 'none' ? `min-h-${args.minHeight}` : '',
+    args.minWidth && args.minWidth !== 'none' ? `min-w-${args.minWidth}` : '',
+  ]
+    .filter(Boolean)
+    .join(' ');
 
-  return html`
-    <div class="sizing-example">
-      <div class="d-flex p-16 gap-16" style="height: 150px">
-        <div class="flex-fill">
-          <div class="${classes}"></div>
-        </div>
-      </div>
-    </div>
-  `;
+  return html`<div class="${classNames}"></div>`;
 }
 
-export const Sizes: Story = {};
 export const SizesPercent: Story = {
   args: {
     width: '25',
     height: '100',
   },
-  argTypes: {
-    height: {
-      options: sizeOptionsPercent,
-    },
-    width: {
-      options: sizeOptionsPercent,
-    },
-  },
 };

packages/documentation/src/stories/utilities/sizing/sizing.styles.scss

@@ -1,8 +1,55 @@
 @use '@swisspost/design-system-styles/core' as post;
 
-.sizing-example {
+.sizing-example,
+.sizing-vp-example,
+.sizing-auto-example {
+  gap: 30px;
+
+  &.snapshot {
+    height: 200vh;
+    width: 100vw;
+    display: flex;
+    flex-direction: column;
+  }
+
   .content {
     background-color: post.$white;
     border: 1px solid post.$gray-40;
   }
+
+  .info {
+    padding: 15px;
+    font-size: 0.8em;
+  }
+
+  .grid-item {
+    width: 300px;
+    height: 300px;
+    border: 1px solid post.$gray-40;
+
+    div {
+      background-color: post.$gray-40;
+    }
+  }
+}
+
+.sizing-vp-example {
+  &.snapshot {
+    display: grid;
+    grid-template-columns: 100vw;
+    grid-template-rows: 100vh;
+  }
+
+  .grid-item {
+    width: 100vw;
+    height: 100vh;
+  }
+}
+
+.sizing-auto-example {
+  .inner-div {
+    width: 50px;
+    height: 50px;
+    background-color: red !important;
+  }
 }

packages/migrations/src/utils/constants.ts

@@ -1,6 +1,8 @@
 export const breakpoints = [ 'xs', 'sm', 'rg', 'md', 'lg', 'xl', 'xxl' ];
 
 const bootstrapSizes = [ '0', '1', '2', '3', '4', '5', 'auto' ];
+
+
 const postSizes = [
   'hair',
   'line',