@cck-ui/core 0.27.0 → 0.29.0

package/lib/components/affix/affix.types.d.ts

@@ -0,0 +1,40 @@
+import { Properties } from 'csstype';
+import { BoxComponentProps, CSize, ElementProps, Factory, StylesApiProps } from '../../core';
+import { PortalProps } from '../portal';
+export type AffixStylesNames = 'root';
+export type AffixCssVariables = {
+    root: '--affix-z-index' | '--affix-top' | '--affix-left' | '--affix-bottom' | '--affix-right';
+};
+export interface AffixPosition {
+    top?: CSize | (string & {}) | number;
+    left?: CSize | (string & {}) | number;
+    bottom?: CSize | (string & {}) | number;
+    right?: CSize | (string & {}) | number;
+}
+export interface AffixBaseProps {
+    /**
+     * Root element `z-index` property
+     * @default 200
+     */
+    zIndex?: Properties['zIndex'];
+    /**
+     * Determines whether the component is rendered within `Portal`
+     * @default true
+     */
+    withinPortal?: boolean;
+    /** Props passed down to the `Portal` component. Ignored when `withinPortal` is `false` */
+    portalProps?: PortalProps;
+    /**
+     * Affix position on screen
+     * @default { bottom: 0, right: 0 }
+     */
+    position?: AffixPosition;
+}
+export interface AffixProps extends BoxComponentProps, AffixBaseProps, StylesApiProps<AffixFactory>, ElementProps<'div'> {
+}
+export type AffixFactory = Factory<{
+    props: AffixProps;
+    ref: HTMLDivElement;
+    stylesNames: AffixStylesNames;
+    vars: AffixCssVariables;
+}>;

package/lib/components/affix/affix.utils.d.ts

@@ -0,0 +1,6 @@
+export declare const varsResolver: import("../..").VarsResolver<{
+    props: import("./affix.types").AffixProps;
+    ref: HTMLDivElement;
+    stylesNames: import("./affix.types").AffixStylesNames;
+    vars: import("./affix.types").AffixCssVariables;
+}>;

package/lib/components/affix/index.d.ts

@@ -0,0 +1,6 @@
+import { SFCWithInstallAndClasses } from '../../core';
+import Affix from './affix.vue';
+import classes from './affix.module.css';
+export declare const CAffix: SFCWithInstallAndClasses<typeof Affix, typeof classes>;
+export default CAffix;
+export * from './affix.types';

package/lib/components/burger/burger.types.d.ts

@@ -0,0 +1,40 @@
+import { BoxProps, CColor, CSize, ElementProps, Factory, StylesApiProps } from '../../core';
+export type BurgerStylesNames = 'root' | 'burger';
+export type BurgerCssVariables = {
+    root: '--burger-color' | '--burger-size' | '--burger-line-size' | '--burger-transition-duration' | '--burger-transition-timing-function';
+};
+export interface BurgerProps extends BoxProps, StylesApiProps<BurgerFactory>, /* @vue-ignore */ ElementProps<'button'> {
+    /**
+     * Controls burger `width` and `height`, numbers are converted to rem
+     * @default 'md'
+     */
+    size?: CSize | (string & {}) | number;
+    /**
+     * Controls height of lines, by default calculated based on `size` prop
+     */
+    lineSize?: string | number;
+    /**
+     * Key of `theme.colors` of any valid CSS value, by default `theme.white` in dark color scheme and `theme.black` in light
+     */
+    color?: CColor;
+    /**
+     * State of the burger, when `true` burger is transformed into x
+     * @default false
+     */
+    opened?: boolean;
+    /**
+     * `transition-duration` property value in ms
+     * @default 300
+     */
+    transitionDuration?: number;
+    /** `transition-timing-function` property value
+     * @default 'ease'
+     */
+    transitionTimingFunction?: string;
+}
+export type BurgerFactory = Factory<{
+    props: BurgerProps;
+    ref: HTMLButtonElement;
+    stylesNames: BurgerStylesNames;
+    vars: BurgerCssVariables;
+}>;

package/lib/components/burger/burger.utils.d.ts

@@ -0,0 +1,6 @@
+export declare const varsResolver: import("../..").VarsResolver<{
+    props: import("./burger.types").BurgerProps;
+    ref: HTMLButtonElement;
+    stylesNames: import("./burger.types").BurgerStylesNames;
+    vars: import("./burger.types").BurgerCssVariables;
+}>;

package/lib/components/burger/index.d.ts

@@ -0,0 +1,6 @@
+import { SFCWithInstallAndClasses } from '../../core';
+import classes from './burger.module.css';
+import Burger from './burger.vue';
+export declare const CBurger: SFCWithInstallAndClasses<typeof Burger, typeof classes>;
+export default CBurger;
+export * from './burger.types';

package/lib/components/index.d.ts

@@ -1,8 +1,10 @@
 export * from './action-icon';
+export * from './affix';
 export * from './alert';
 export * from './anchor';
 export * from './aspect-ratio';
 export * from './breadcrumbs';
+export * from './burger';
 export * from './button';
 export * from './center';
 export * from './close-button';

package/lib/components/portal/portal.types.d.ts

@@ -8,6 +8,15 @@ export interface PortalProps {
      * Note: If selector doesn't match any element, portal will not render
      */
     target?: HTMLElement | string;
+    /**
+     * Determines whether children should be rendered inside Portal.
+     * When false, children are rendered as regular Vue children.
+     *
+     * Note: In test environment, Portal is always disabled regardless of this value.
+     *
+     * @default true
+     */
+    disabled?: boolean;
     /**
      * When true and target is not specified, all Portal instances share a single
      * container node appended to document.body. When false, each Portal creates

package/lib/core/utils/get-default-z-index/get-default-z-index.d.ts

@@ -0,0 +1,9 @@
+declare const elevations: {
+    readonly app: 100;
+    readonly modal: 200;
+    readonly popover: 300;
+    readonly overlay: 400;
+    readonly max: 9999;
+};
+export declare function getDefaultZIndex(level: keyof typeof elevations): 100 | 200 | 300 | 400 | 9999;
+export {};

package/lib/core/utils/index.d.ts

@@ -3,6 +3,7 @@ export { camelToKebabCase } from './camel-to-kebab-case/camel-to-kebab-case';
 export { filterProps } from './filter-props/filter-props';
 export { getBaseValue } from './get-base-value/get-base-value';
 export { getBreakpointValue } from './get-breakpoint-value/get-breakpoint-value';
+export { getDefaultZIndex } from './get-default-z-index/get-default-z-index';
 export { getSize, getSpacing, getShadow, getRadius, getFontSize, getLineHeight, } from './get-size/get-size';
 export { getSortedBreakpoints } from './get-sorted-breakpoints/get-sorted-breakpoints';
 export { isNumberLike } from './is-number-like/is-number-like';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cck-ui/core",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Vue component library focused on usability, accessibility and developer experience",
   "homepage": "https://cck-ui.jackatlas.xyz",
   "license": "ISC",

package/styles/affix.css

@@ -0,0 +1,8 @@
+.m_8b372bf {
+  position: fixed;
+  z-index: var(--affix-z-index);
+  inset-inline-start: var(--affix-left);
+  inset-inline-end: var(--affix-right);
+  top: var(--affix-top);
+  bottom: var(--affix-bottom);
+}

package/styles/affix.layer.css

@@ -0,0 +1,9 @@
+@layer cck {.m_8b372bf {
+  position: fixed;
+  z-index: var(--affix-z-index);
+  inset-inline-start: var(--affix-left);
+  inset-inline-end: var(--affix-right);
+  top: var(--affix-top);
+  bottom: var(--affix-bottom);
+}
+}

package/styles/burger.css

@@ -0,0 +1,68 @@
+.m_9b3d173a {
+  --burger-size-xs: calc(0.75rem * var(--c-scale));
+  --burger-size-sm: calc(1.125rem * var(--c-scale));
+  --burger-size-md: calc(1.5rem * var(--c-scale));
+  --burger-size-lg: calc(2.125rem * var(--c-scale));
+  --burger-size-xl: calc(2.625rem * var(--c-scale));
+
+  --burger-size: var(--burger-size-md);
+  --burger-line-size: calc(var(--burger-size) / 12);
+
+  width: calc(var(--burger-size) + var(--c-spacing-xs));
+  height: calc(var(--burger-size) + var(--c-spacing-xs));
+  padding: calc(var(--c-spacing-xs) / 2);
+  cursor: pointer;
+}
+
+  :where([data-c-color-scheme='light']) .m_9b3d173a {
+    --burger-color: var(--c-color-black);
+}
+
+  :where([data-c-color-scheme='dark']) .m_9b3d173a {
+    --burger-color: var(--c-color-white);
+}
+
+.m_a55c6ccd {
+  position: relative;
+  user-select: none;
+}
+
+.m_a55c6ccd,
+  .m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    display: block;
+    width: var(--burger-size);
+    height: var(--burger-line-size);
+    background-color: var(--burger-color);
+    outline: calc(0.0625rem * var(--c-scale)) solid transparent;
+    transition-property: background-color, transform;
+    transition-duration: var(--burger-transition-duration, 300ms);
+    transition-timing-function: var(--burger-transition-timing-function, ease);
+  }
+
+.m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    position: absolute;
+    content: '';
+    inset-inline-start: 0;
+  }
+
+.m_a55c6ccd::before {
+    top: calc(var(--burger-size) / -3);
+  }
+
+.m_a55c6ccd::after {
+    top: calc(var(--burger-size) / 3);
+  }
+
+.m_a55c6ccd[data-opened] {
+    background-color: transparent;
+  }
+
+.m_a55c6ccd[data-opened]::before {
+      transform: translateY(calc(var(--burger-size) / 3)) rotate(45deg);
+    }
+
+.m_a55c6ccd[data-opened]::after {
+      transform: translateY(calc(var(--burger-size) / -3)) rotate(-45deg);
+    }

package/styles/burger.layer.css

@@ -0,0 +1,69 @@
+@layer cck {.m_9b3d173a {
+  --burger-size-xs: calc(0.75rem * var(--c-scale));
+  --burger-size-sm: calc(1.125rem * var(--c-scale));
+  --burger-size-md: calc(1.5rem * var(--c-scale));
+  --burger-size-lg: calc(2.125rem * var(--c-scale));
+  --burger-size-xl: calc(2.625rem * var(--c-scale));
+
+  --burger-size: var(--burger-size-md);
+  --burger-line-size: calc(var(--burger-size) / 12);
+
+  width: calc(var(--burger-size) + var(--c-spacing-xs));
+  height: calc(var(--burger-size) + var(--c-spacing-xs));
+  padding: calc(var(--c-spacing-xs) / 2);
+  cursor: pointer;
+}
+
+  :where([data-c-color-scheme='light']) .m_9b3d173a {
+    --burger-color: var(--c-color-black);
+}
+
+  :where([data-c-color-scheme='dark']) .m_9b3d173a {
+    --burger-color: var(--c-color-white);
+}
+
+.m_a55c6ccd {
+  position: relative;
+  user-select: none;
+}
+
+.m_a55c6ccd,
+  .m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    display: block;
+    width: var(--burger-size);
+    height: var(--burger-line-size);
+    background-color: var(--burger-color);
+    outline: calc(0.0625rem * var(--c-scale)) solid transparent;
+    transition-property: background-color, transform;
+    transition-duration: var(--burger-transition-duration, 300ms);
+    transition-timing-function: var(--burger-transition-timing-function, ease);
+  }
+
+.m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    position: absolute;
+    content: '';
+    inset-inline-start: 0;
+  }
+
+.m_a55c6ccd::before {
+    top: calc(var(--burger-size) / -3);
+  }
+
+.m_a55c6ccd::after {
+    top: calc(var(--burger-size) / 3);
+  }
+
+.m_a55c6ccd[data-opened] {
+    background-color: transparent;
+  }
+
+.m_a55c6ccd[data-opened]::before {
+      transform: translateY(calc(var(--burger-size) / 3)) rotate(45deg);
+    }
+
+.m_a55c6ccd[data-opened]::after {
+      transform: translateY(calc(var(--burger-size) / -3)) rotate(-45deg);
+    }
+}

package/styles.css

@@ -1181,6 +1181,15 @@ fieldset:disabled .c-active:active {
   justify-content: center;
 }
 
+.m_8b372bf {
+  position: fixed;
+  z-index: var(--affix-z-index);
+  inset-inline-start: var(--affix-left);
+  inset-inline-end: var(--affix-right);
+  top: var(--affix-top);
+  bottom: var(--affix-bottom);
+}
+
 .m_efb192b3 {
   --alert-radius: var(--c-radius-default);
   --alert-bg: var(--c-primary-color-light);
@@ -1306,6 +1315,75 @@ fieldset:disabled .c-active:active {
     color: var(--c-color-dark-2);
 }
 
+.m_9b3d173a {
+  --burger-size-xs: calc(0.75rem * var(--c-scale));
+  --burger-size-sm: calc(1.125rem * var(--c-scale));
+  --burger-size-md: calc(1.5rem * var(--c-scale));
+  --burger-size-lg: calc(2.125rem * var(--c-scale));
+  --burger-size-xl: calc(2.625rem * var(--c-scale));
+
+  --burger-size: var(--burger-size-md);
+  --burger-line-size: calc(var(--burger-size) / 12);
+
+  width: calc(var(--burger-size) + var(--c-spacing-xs));
+  height: calc(var(--burger-size) + var(--c-spacing-xs));
+  padding: calc(var(--c-spacing-xs) / 2);
+  cursor: pointer;
+}
+
+  :where([data-c-color-scheme='light']) .m_9b3d173a {
+    --burger-color: var(--c-color-black);
+}
+
+  :where([data-c-color-scheme='dark']) .m_9b3d173a {
+    --burger-color: var(--c-color-white);
+}
+
+.m_a55c6ccd {
+  position: relative;
+  user-select: none;
+}
+
+.m_a55c6ccd,
+  .m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    display: block;
+    width: var(--burger-size);
+    height: var(--burger-line-size);
+    background-color: var(--burger-color);
+    outline: calc(0.0625rem * var(--c-scale)) solid transparent;
+    transition-property: background-color, transform;
+    transition-duration: var(--burger-transition-duration, 300ms);
+    transition-timing-function: var(--burger-transition-timing-function, ease);
+  }
+
+.m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    position: absolute;
+    content: '';
+    inset-inline-start: 0;
+  }
+
+.m_a55c6ccd::before {
+    top: calc(var(--burger-size) / -3);
+  }
+
+.m_a55c6ccd::after {
+    top: calc(var(--burger-size) / 3);
+  }
+
+.m_a55c6ccd[data-opened] {
+    background-color: transparent;
+  }
+
+.m_a55c6ccd[data-opened]::before {
+      transform: translateY(calc(var(--burger-size) / 3)) rotate(45deg);
+    }
+
+.m_a55c6ccd[data-opened]::after {
+      transform: translateY(calc(var(--burger-size) / -3)) rotate(-45deg);
+    }
+
 .m_e0e8435a {
   display: flex;
   align-items: center;

package/styles.layer.css

@@ -1181,6 +1181,15 @@ fieldset:disabled .c-active:active {
   justify-content: center;
 }
 
+.m_8b372bf {
+  position: fixed;
+  z-index: var(--affix-z-index);
+  inset-inline-start: var(--affix-left);
+  inset-inline-end: var(--affix-right);
+  top: var(--affix-top);
+  bottom: var(--affix-bottom);
+}
+
 .m_efb192b3 {
   --alert-radius: var(--c-radius-default);
   --alert-bg: var(--c-primary-color-light);
@@ -1306,6 +1315,75 @@ fieldset:disabled .c-active:active {
     color: var(--c-color-dark-2);
 }
 
+.m_9b3d173a {
+  --burger-size-xs: calc(0.75rem * var(--c-scale));
+  --burger-size-sm: calc(1.125rem * var(--c-scale));
+  --burger-size-md: calc(1.5rem * var(--c-scale));
+  --burger-size-lg: calc(2.125rem * var(--c-scale));
+  --burger-size-xl: calc(2.625rem * var(--c-scale));
+
+  --burger-size: var(--burger-size-md);
+  --burger-line-size: calc(var(--burger-size) / 12);
+
+  width: calc(var(--burger-size) + var(--c-spacing-xs));
+  height: calc(var(--burger-size) + var(--c-spacing-xs));
+  padding: calc(var(--c-spacing-xs) / 2);
+  cursor: pointer;
+}
+
+  :where([data-c-color-scheme='light']) .m_9b3d173a {
+    --burger-color: var(--c-color-black);
+}
+
+  :where([data-c-color-scheme='dark']) .m_9b3d173a {
+    --burger-color: var(--c-color-white);
+}
+
+.m_a55c6ccd {
+  position: relative;
+  user-select: none;
+}
+
+.m_a55c6ccd,
+  .m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    display: block;
+    width: var(--burger-size);
+    height: var(--burger-line-size);
+    background-color: var(--burger-color);
+    outline: calc(0.0625rem * var(--c-scale)) solid transparent;
+    transition-property: background-color, transform;
+    transition-duration: var(--burger-transition-duration, 300ms);
+    transition-timing-function: var(--burger-transition-timing-function, ease);
+  }
+
+.m_a55c6ccd::before,
+  .m_a55c6ccd::after {
+    position: absolute;
+    content: '';
+    inset-inline-start: 0;
+  }
+
+.m_a55c6ccd::before {
+    top: calc(var(--burger-size) / -3);
+  }
+
+.m_a55c6ccd::after {
+    top: calc(var(--burger-size) / 3);
+  }
+
+.m_a55c6ccd[data-opened] {
+    background-color: transparent;
+  }
+
+.m_a55c6ccd[data-opened]::before {
+      transform: translateY(calc(var(--burger-size) / 3)) rotate(45deg);
+    }
+
+.m_a55c6ccd[data-opened]::after {
+      transform: translateY(calc(var(--burger-size) / -3)) rotate(-45deg);
+    }
+
 .m_e0e8435a {
   display: flex;
   align-items: center;