@onereach/ui-components 2.74.2 → 2.74.3-beta.2300.0

package/dist/esm/v2/{OrText-b12d0682.js → OrText-91d662a0.js}

@@ -17,16 +17,31 @@ const RestText = [
 // Layout
 'shrink'];
 
+/**
+ * Use `OrText` component to crop un-wrapped single-line text with ellipsis inside narrow containers.
+ * Ellipsis can be placed in the end or in the middle of the text. Convenient for displaying long labels,
+ * that have same beginning and differ in the ending part.
+ */
 var script = defineComponent({
   name: 'OrText',
   props: {
+    /**
+     * Text to crop.
+     */
     text: {
       type: String,
       required: true
     },
+    /**
+     * The index counted from the end of the string where ellipsis will be placed.
+     * Defines how many ending characters will remain visible.
+     * By default, ellipsis is placed in the end of the line.
+     *
+     * Note: Negative values behave same as corresponding positives still counting from the end of the line.
+     */
     sliceIndex: {
       type: Number,
-      default: undefined
+      default: 0
     }
   },
   expose: ['root'],
@@ -37,15 +52,33 @@ var script = defineComponent({
     const rootStyles = computed(() => ['or-text', ...TextRoot]);
     const mainTextStyles = computed(() => [...MainText]);
     const restTextStyles = computed(() => [...RestText]);
+    /**
+     * Preserves whitespace at the last position as <code>&nbsp;</code>
+     * @param str A string to escape
+     */
+    const escapeLast = str => str && str.slice(0, -1) + '\xa0';
+    /**
+     * Preserves whitespace at the first position as <code>&nbsp;</code>
+     * @param str A string to escape
+     */
+    const escapeFirst = str => str && '\xa0' + str.slice(1);
     // State
     const mainText = computed(() => {
       if (props.sliceIndex) {
-        return props.text.slice(0, Math.abs(props.sliceIndex) * -1);
+        let mainPart = props.text.slice(0, -Math.abs(props.sliceIndex));
+        if (mainPart[mainPart.length - 1] === ' ') {
+          mainPart = escapeLast(mainPart);
+        }
+        return mainPart;
       }
       return props.text;
     });
     const restText = computed(() => {
-      return props.text.slice(mainText.value.length);
+      let restPart = props.text.slice(mainText.value.length);
+      if (restPart[0] === ' ') {
+        restPart = escapeFirst(restPart);
+      }
+      return restPart;
     });
     return {
       root,

package/dist/esm/v2/components/index.js

@@ -89,7 +89,7 @@ export { _ as OrTag } from '../OrTag-c1fa6901.js';
 export { _ as OrTagV3, a as TagColor, T as TagVariant } from '../OrTag-920c6371.js';
 export { _ as OrTeleport } from '../OrTeleportVue2-8ef4ceca.js';
 export { _ as OrTeleportV3 } from '../OrTeleport.vue2-fb92f29f.js';
-export { _ as OrTextV3 } from '../OrText-b12d0682.js';
+export { _ as OrTextV3 } from '../OrText-91d662a0.js';
 export { _ as OrTextarea } from '../OrTextarea-91a95068.js';
 export { _ as OrTextareaV3 } from '../OrTextarea-373d0554.js';
 export { _ as OrTextbox, T as TextboxTypes } from '../OrTextbox-2594c980.js';

package/dist/esm/v2/components/or-text-v3/OrText.stories3.d.ts

@@ -1,12 +1,24 @@
 import { Meta, StoryFn } from '@storybook/vue3';
+import OrText from './OrText.vue';
 declare const _default: Meta<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
     [x: string]: ((...args: any[]) => any) | null;
 } | string[], {} & {}, {
     [x: number]: string;
 } | {}, true>)>;
 export default _default;
-export declare const Text: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
+export declare const Default: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
     [x: string]: ((...args: any[]) => any) | null;
 } | string[], {} & {}, {
     [x: number]: string;
 } | {}, true>)>;
+export declare const MiddleCrop: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
+    [x: string]: ((...args: any[]) => any) | null;
+} | string[], {} & {}, {
+    [x: number]: string;
+} | {}, true>)>;
+export declare const TooFarLeft: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
+    [x: string]: ((...args: any[]) => any) | null;
+} | string[], {} & {}, {
+    [x: number]: string;
+} | {}, true>)>;
+export declare const ComplexContainer: StoryFn<typeof OrText>;

package/dist/esm/v2/components/or-text-v3/OrText.vue.d.ts

@@ -6,22 +6,42 @@ declare const _default: import("vue").ComponentOptions<import("vue").default, im
     mainText: import("@vue/composition-api").ComputedRef<string>;
     restText: import("@vue/composition-api").ComputedRef<string>;
 }> & import("@vue/composition-api").Data, {}, {}, {
+    /**
+     * Text to crop.
+     */
     text: {
         type: StringConstructor;
         required: true;
     };
+    /**
+     * The index counted from the end of the string where ellipsis will be placed.
+     * Defines how many ending characters will remain visible.
+     * By default, ellipsis is placed in the end of the line.
+     *
+     * Note: Negative values behave same as corresponding positives still counting from the end of the line.
+     */
     sliceIndex: {
         type: NumberConstructor;
-        default: undefined;
+        default: number;
     };
 }, import("@vue/composition-api").ExtractPropTypes<{
+    /**
+     * Text to crop.
+     */
     text: {
         type: StringConstructor;
         required: true;
     };
+    /**
+     * The index counted from the end of the string where ellipsis will be placed.
+     * Defines how many ending characters will remain visible.
+     * By default, ellipsis is placed in the end of the line.
+     *
+     * Note: Negative values behave same as corresponding positives still counting from the end of the line.
+     */
     sliceIndex: {
         type: NumberConstructor;
-        default: undefined;
+        default: number;
     };
 }>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{
     text: string;
@@ -39,4 +59,9 @@ declare const _default: import("vue").ComponentOptions<import("vue").default, im
 } & {}, {
     sliceIndex: number;
 }, true>);
+/**
+ * Use `OrText` component to crop un-wrapped single-line text with ellipsis inside narrow containers.
+ * Ellipsis can be placed in the end or in the middle of the text. Convenient for displaying long labels,
+ * that have same beginning and differ in the ending part.
+ */
 export default _default;

package/dist/esm/v2/components/or-text-v3/index.js

@@ -1,3 +1,3 @@
-export { _ as OrTextV3 } from '../../OrText-b12d0682.js';
+export { _ as OrTextV3 } from '../../OrText-91d662a0.js';
 import 'vue-demi';
 import '../../normalize-component-6e8e3d80.js';

package/dist/esm/v2/index.js

@@ -89,7 +89,7 @@ export { _ as OrTag } from './OrTag-c1fa6901.js';
 export { _ as OrTagV3, a as TagColor, T as TagVariant } from './OrTag-920c6371.js';
 export { _ as OrTeleport } from './OrTeleportVue2-8ef4ceca.js';
 export { _ as OrTeleportV3 } from './OrTeleport.vue2-fb92f29f.js';
-export { _ as OrTextV3 } from './OrText-b12d0682.js';
+export { _ as OrTextV3 } from './OrText-91d662a0.js';
 export { _ as OrTextarea } from './OrTextarea-91a95068.js';
 export { _ as OrTextareaV3 } from './OrTextarea-373d0554.js';
 export { _ as OrTextbox, T as TextboxTypes } from './OrTextbox-2594c980.js';

package/dist/esm/v3/{OrText-6b4f7cd1.js → OrText-a3b00048.js}

@@ -17,16 +17,31 @@ const RestText = [
 // Layout
 'shrink'];
 
+/**
+ * Use `OrText` component to crop un-wrapped single-line text with ellipsis inside narrow containers.
+ * Ellipsis can be placed in the end or in the middle of the text. Convenient for displaying long labels,
+ * that have same beginning and differ in the ending part.
+ */
 var script = defineComponent({
   name: 'OrText',
   props: {
+    /**
+     * Text to crop.
+     */
     text: {
       type: String,
       required: true
     },
+    /**
+     * The index counted from the end of the string where ellipsis will be placed.
+     * Defines how many ending characters will remain visible.
+     * By default, ellipsis is placed in the end of the line.
+     *
+     * Note: Negative values behave same as corresponding positives still counting from the end of the line.
+     */
     sliceIndex: {
       type: Number,
-      default: undefined
+      default: 0
     }
   },
   expose: ['root'],
@@ -37,15 +52,33 @@ var script = defineComponent({
     const rootStyles = computed(() => ['or-text', ...TextRoot]);
     const mainTextStyles = computed(() => [...MainText]);
     const restTextStyles = computed(() => [...RestText]);
+    /**
+     * Preserves whitespace at the last position as <code>&nbsp;</code>
+     * @param str A string to escape
+     */
+    const escapeLast = str => str && str.slice(0, -1) + '\xa0';
+    /**
+     * Preserves whitespace at the first position as <code>&nbsp;</code>
+     * @param str A string to escape
+     */
+    const escapeFirst = str => str && '\xa0' + str.slice(1);
     // State
     const mainText = computed(() => {
       if (props.sliceIndex) {
-        return props.text.slice(0, Math.abs(props.sliceIndex) * -1);
+        let mainPart = props.text.slice(0, -Math.abs(props.sliceIndex));
+        if (mainPart[mainPart.length - 1] === ' ') {
+          mainPart = escapeLast(mainPart);
+        }
+        return mainPart;
       }
       return props.text;
     });
     const restText = computed(() => {
-      return props.text.slice(mainText.value.length);
+      let restPart = props.text.slice(mainText.value.length);
+      if (restPart[0] === ' ') {
+        restPart = escapeFirst(restPart);
+      }
+      return restPart;
     });
     return {
       root,

package/dist/esm/v3/components/index.js

@@ -86,7 +86,7 @@ export { s as OrTag } from '../OrTag-1b5e43fa.js';
 export { s as OrTagV3, a as TagColor, T as TagVariant } from '../OrTag-1d3fa09e.js';
 export { s as OrTeleport } from '../OrTeleportVue3-ad639f12.js';
 export { s as OrTeleportV3 } from '../OrTeleport.vue3-8099178c.js';
-export { s as OrTextV3 } from '../OrText-6b4f7cd1.js';
+export { s as OrTextV3 } from '../OrText-a3b00048.js';
 export { s as OrTextarea } from '../OrTextarea-1f5c3be1.js';
 export { s as OrTextareaV3 } from '../OrTextarea-42d21f77.js';
 export { s as OrTextbox, T as TextboxTypes } from '../OrTextbox-2f33e9c3.js';

package/dist/esm/v3/components/or-text-v3/OrText.stories3.d.ts

@@ -1,12 +1,24 @@
 import { Meta, StoryFn } from '@storybook/vue3';
+import OrText from './OrText.vue';
 declare const _default: Meta<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
     [x: string]: ((...args: any[]) => any) | null;
 } | string[], {} & {}, {
     [x: number]: string;
 } | {}, true>)>;
 export default _default;
-export declare const Text: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
+export declare const Default: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
     [x: string]: ((...args: any[]) => any) | null;
 } | string[], {} & {}, {
     [x: number]: string;
 } | {}, true>)>;
+export declare const MiddleCrop: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
+    [x: string]: ((...args: any[]) => any) | null;
+} | string[], {} & {}, {
+    [x: number]: string;
+} | {}, true>)>;
+export declare const TooFarLeft: StoryFn<import("vue").ComponentOptions<import("vue").default, import("@vue/composition-api").ShallowUnwrapRef<unknown>, import("@vue/composition-api").MethodOptions, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>, import("@vue/composition-api").ExtractPropTypes<import("@vue/composition-api").ComponentPropsOptions<import("@vue/composition-api").Data>>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{} & {}, import("@vue/composition-api").ShallowUnwrapRef<unknown>, unknown, import("@vue/composition-api").ComputedOptions, import("@vue/composition-api").MethodOptions, unknown, unknown, {
+    [x: string]: ((...args: any[]) => any) | null;
+} | string[], {} & {}, {
+    [x: number]: string;
+} | {}, true>)>;
+export declare const ComplexContainer: StoryFn<typeof OrText>;

package/dist/esm/v3/components/or-text-v3/OrText.vue.d.ts

@@ -6,22 +6,42 @@ declare const _default: import("vue").ComponentOptions<import("vue").default, im
     mainText: import("@vue/composition-api").ComputedRef<string>;
     restText: import("@vue/composition-api").ComputedRef<string>;
 }> & import("@vue/composition-api").Data, {}, {}, {
+    /**
+     * Text to crop.
+     */
     text: {
         type: StringConstructor;
         required: true;
     };
+    /**
+     * The index counted from the end of the string where ellipsis will be placed.
+     * Defines how many ending characters will remain visible.
+     * By default, ellipsis is placed in the end of the line.
+     *
+     * Note: Negative values behave same as corresponding positives still counting from the end of the line.
+     */
     sliceIndex: {
         type: NumberConstructor;
-        default: undefined;
+        default: number;
     };
 }, import("@vue/composition-api").ExtractPropTypes<{
+    /**
+     * Text to crop.
+     */
     text: {
         type: StringConstructor;
         required: true;
     };
+    /**
+     * The index counted from the end of the string where ellipsis will be placed.
+     * Defines how many ending characters will remain visible.
+     * By default, ellipsis is placed in the end of the line.
+     *
+     * Note: Negative values behave same as corresponding positives still counting from the end of the line.
+     */
     sliceIndex: {
         type: NumberConstructor;
-        default: undefined;
+        default: number;
     };
 }>> & Omit<import("vue").VueConstructor<import("vue").default>, never> & (new (...args: any[]) => import("@vue/composition-api").ComponentRenderProxy<{
     text: string;
@@ -39,4 +59,9 @@ declare const _default: import("vue").ComponentOptions<import("vue").default, im
 } & {}, {
     sliceIndex: number;
 }, true>);
+/**
+ * Use `OrText` component to crop un-wrapped single-line text with ellipsis inside narrow containers.
+ * Ellipsis can be placed in the end or in the middle of the text. Convenient for displaying long labels,
+ * that have same beginning and differ in the ending part.
+ */
 export default _default;

package/dist/esm/v3/components/or-text-v3/index.js

@@ -1,3 +1,3 @@
-export { s as OrTextV3 } from '../../OrText-6b4f7cd1.js';
+export { s as OrTextV3 } from '../../OrText-a3b00048.js';
 import 'vue-demi';
 import 'vue';

package/dist/esm/v3/index.js

@@ -86,7 +86,7 @@ export { s as OrTag } from './OrTag-1b5e43fa.js';
 export { s as OrTagV3, a as TagColor, T as TagVariant } from './OrTag-1d3fa09e.js';
 export { s as OrTeleport } from './OrTeleportVue3-ad639f12.js';
 export { s as OrTeleportV3 } from './OrTeleport.vue3-8099178c.js';
-export { s as OrTextV3 } from './OrText-6b4f7cd1.js';
+export { s as OrTextV3 } from './OrText-a3b00048.js';
 export { s as OrTextarea } from './OrTextarea-1f5c3be1.js';
 export { s as OrTextareaV3 } from './OrTextarea-42d21f77.js';
 export { s as OrTextbox, T as TextboxTypes } from './OrTextbox-2f33e9c3.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onereach/ui-components",
-  "version": "2.74.2",
+  "version": "2.74.3-beta.2300.0",
   "description": "Vue components library for v2/3",
   "sideEffects": false,
   "main": "./dist/auto/index.js",
@@ -124,6 +124,5 @@
       "default": "./dist/bundled/v3/components/*/index.js"
     },
     "./package.json": "./package.json"
-  },
-  "gitHead": "0210ab5e65f8f3a902ce53fb27c731832b042eef"
+  }
 }

package/src/components/or-text-v3/OrText.stories3.ts

@@ -34,13 +34,89 @@ const Template: StoryFn<typeof OrText> = (args) => ({
   },
 
   template: `
-    <OrText v-bind="args" />
+    <div class="w-2/5 mx-auto px-md bg-surface-2 dark:bg-surface-2-dark">
+      <OrText v-bind="args" />
+    </div>
   `,
 });
 
-export const Text = Template.bind({});
-
-Text.args = {
+export const Default = Template.bind({});
+Default.args = {
   // Props
-  text: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.',
+  text: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt \
+    ut labore et dolore magna aliqua.',
+};
+
+export const MiddleCrop = Template.bind({});
+MiddleCrop.args = {
+  ...Default.args,
+  sliceIndex: 12,
+};
+
+export const TooFarLeft = Template.bind({});
+TooFarLeft.args = {
+  ...Default.args,
+  sliceIndex: 120,
+};
+TooFarLeft.parameters = {
+  docs: {
+    description: {
+      story: 'Caution. If `sliceIndex` is greater than the visible part length, \
+        then beginning part with ellipsis is not displayed and ending part overflows the container.',
+    },
+  },
+};
+
+export const ComplexContainer: StoryFn<typeof OrText> = (args) => ({
+  components: {
+    OrText,
+  },
+
+  setup() {
+    return { args };
+  },
+
+  template: `
+    <h3 class="typography-headline-3 mb-md">Flex container side effect</h3>
+    <div class="w-[300px] flex bg-surface-2 dark:bg-surface-2-dark">
+      <!-- fixed part -->
+      <div class="w-[20px]" />
+      <!-- growing part -->
+      <div class="grow px-md">
+        <OrText v-bind="args" />
+      </div>
+    </div>
+    <h3 class="typography-headline-3 my-md">Solution with a wrapper</h3>
+    <div class="w-[300px] flex bg-surface-2 dark:bg-surface-2-dark">
+      <!-- fixed part -->
+      <div class="w-[20px]" />
+      <!-- growing part -->
+      <div class="grow px-md min-w-0">
+        <OrText v-bind="args" />
+      </div>
+    </div>
+    <h3 class="typography-headline-3 my-md">Solution without a wrapper</h3>
+    <div class="w-[300px] flex bg-surface-2 dark:bg-surface-2-dark">
+      <!-- fixed part -->
+      <div class="w-[20px]" />
+      <!-- growing part -->
+      <OrText v-bind="args" class="grow px-md min-w-0"/>
+    </div>
+  `,
+});
+ComplexContainer.storyName = 'Growing Flex Container';
+ComplexContainer.args = {
+  ...Default.args,
+  sliceIndex: 12,
+};
+ComplexContainer.parameters = {
+  docs: {
+    description: {
+      story: 'In a special case when OrText is placed inside a variable width container,\
+        such as a flexbox growing block, or when it is itself a growing flexbox item,\
+        there is a problem for a browser to proper calculate the cropping position.\
+        As a solution place a `min-width: 0;` style (tailwind class `min-w-0`)\
+        to the growing item - container or the OrText itself.',
+    },
+  },
 };

package/src/components/or-text-v3/OrText.vue

@@ -17,18 +17,33 @@
 import { computed, defineComponent, ref } from 'vue-demi';
 import { MainText, RestText, TextRoot } from './styles';
 
+/**
+ * Use `OrText` component to crop un-wrapped single-line text with ellipsis inside narrow containers.
+ * Ellipsis can be placed in the end or in the middle of the text. Convenient for displaying long labels,
+ * that have same beginning and differ in the ending part.
+ */
 export default defineComponent({
   name: 'OrText',
 
   props: {
+    /**
+     * Text to crop.
+     */
     text: {
       type: String,
       required: true,
     },
 
+    /**
+     * The index counted from the end of the string where ellipsis will be placed.
+     * Defines how many ending characters will remain visible.
+     * By default, ellipsis is placed in the end of the line.
+     *
+     * Note: Negative values behave same as corresponding positives still counting from the end of the line.
+     */
     sliceIndex: {
       type: Number,
-      default: undefined,
+      default: 0,
     },
   },
 
@@ -54,17 +69,36 @@ export default defineComponent({
       ...RestText,
     ]);
 
+    /**
+     * Preserves whitespace at the last position as <code>&nbsp;</code>
+     * @param str A string to escape
+     */
+    const escapeLast = (str: string): string => str && (str.slice(0, -1) + '\xa0');
+    /**
+     * Preserves whitespace at the first position as <code>&nbsp;</code>
+     * @param str A string to escape
+     */
+    const escapeFirst = (str: string): string => str && ('\xa0' + str.slice(1));
+
     // State
     const mainText = computed(() => {
       if (props.sliceIndex) {
-        return props.text.slice(0, Math.abs(props.sliceIndex) * -1);
+        let mainPart = props.text.slice(0, -Math.abs(props.sliceIndex));
+        if (mainPart[mainPart.length - 1] === ' ') {
+          mainPart = escapeLast(mainPart);
+        }
+        return mainPart;
       }
 
       return props.text;
     });
 
     const restText = computed(() => {
-      return props.text.slice(mainText.value.length);
+      let restPart = props.text.slice(mainText.value.length);
+      if (restPart[0] === ' ') {
+        restPart = escapeFirst(restPart);
+      }
+      return restPart;
     });
 
     return {

package/dist/bundled/v3/OrText.vue_vue_type_script_lang-271fb345.js

@@ -1,60 +0,0 @@
-import { defineComponent, ref, computed } from 'vue';
-
-const TextRoot = [
-// Layout
-'inline-flex',
-// Box
-'max-w-full',
-// Typography
-'whitespace-nowrap'];
-const MainText = [
-// Layout
-'overflow-hidden',
-// Typography
-'text-ellipsis'];
-const RestText = [
-// Layout
-'shrink'];
-
-var script = defineComponent({
-  name: 'OrText',
-  props: {
-    text: {
-      type: String,
-      required: true
-    },
-    sliceIndex: {
-      type: Number,
-      default: undefined
-    }
-  },
-  expose: ['root'],
-  setup(props) {
-    // Refs
-    const root = ref();
-    // Styles
-    const rootStyles = computed(() => ['or-text', ...TextRoot]);
-    const mainTextStyles = computed(() => [...MainText]);
-    const restTextStyles = computed(() => [...RestText]);
-    // State
-    const mainText = computed(() => {
-      if (props.sliceIndex) {
-        return props.text.slice(0, Math.abs(props.sliceIndex) * -1);
-      }
-      return props.text;
-    });
-    const restText = computed(() => {
-      return props.text.slice(mainText.value.length);
-    });
-    return {
-      root,
-      rootStyles,
-      mainTextStyles,
-      restTextStyles,
-      mainText,
-      restText
-    };
-  }
-});
-
-export { script as s };