@cck-ui/core 0.28.0 → 0.30.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/index.d.ts

@@ -1,4 +1,5 @@
 export * from './action-icon';
+export * from './affix';
 export * from './alert';
 export * from './anchor';
 export * from './aspect-ratio';

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.28.0",
+  "version": "0.30.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.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);

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);