@cube-dev/ui-kit 0.113.1 → 0.115.0

package/dist/provider.js

@@ -0,0 +1,53 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { EventBusProvider } from "./utils/react/useEventBus.js";
+import { defaultNavigationAdapter } from "./providers/navigationAdapter.default.js";
+import { createContext, useContext, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/provider.tsx
+const UIKitContext = createContext({ navigation: defaultNavigationAdapter });
+function Provider(allProps) {
+	let { children, insideForm, isDisabled, isReadOnly, isRequired, validationState, navigation, root, ref } = allProps;
+	const parentContext = useContext(UIKitContext);
+	children = /* @__PURE__ */ jsx(EventBusProvider, { children });
+	const props = useMemo(() => ({
+		ref,
+		insideForm,
+		isDisabled,
+		isReadOnly,
+		isRequired,
+		validationState,
+		navigation: navigation || defaultNavigationAdapter,
+		root
+	}), [
+		ref,
+		insideForm,
+		isDisabled,
+		isReadOnly,
+		isRequired,
+		validationState,
+		navigation,
+		root
+	]);
+	const newValue = useMemo(() => {
+		let newValue = Object.assign({}, parentContext);
+		Object.keys(props).forEach((key) => {
+			if (props[key] != null) newValue[key] = props[key];
+		});
+		return newValue;
+	}, [parentContext, props]);
+	return /* @__PURE__ */ jsx(UIKitContext.Provider, {
+		value: newValue,
+		children
+	});
+}
+function useProviderProps(props) {
+	return {
+		...useContext(UIKitContext),
+		...props
+	};
+}
+
+//#endregion
+export { Provider, UIKitContext, useProviderProps };
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["import {\n  createContext,\n  ForwardedRef,\n  PropsWithChildren,\n  ReactElement,\n  useContext,\n  useMemo,\n} from 'react';\n\nimport { NavigationAdapter } from './providers/navigation.types';\nimport { defaultNavigationAdapter } from './providers/navigationAdapter.default';\nimport { Props } from './tasty';\nimport { EventBusProvider } from './utils/react/useEventBus';\n\nexport interface ProviderProps extends Props {\n  insideForm?: boolean;\n  isDisabled?: boolean;\n  isReadOnly?: boolean;\n  isRequired?: boolean;\n  validationState?: string;\n  navigation?: NavigationAdapter;\n  ref?: ReactElement;\n  root?: ForwardedRef<any>;\n}\n\nexport type ProviderInsideProps = Omit<ProviderProps, 'styles'>;\n\nexport const UIKitContext = createContext<ProviderInsideProps>({\n  navigation: defaultNavigationAdapter,\n});\n\nexport function Provider(allProps: PropsWithChildren<ProviderProps>) {\n  let {\n    children,\n    insideForm,\n    isDisabled,\n    isReadOnly,\n    isRequired,\n    validationState,\n    navigation,\n    root,\n    ref,\n  } = allProps;\n\n  const parentContext = useContext(UIKitContext);\n\n  // Wrap with EventBusProvider for menu synchronization\n  children = <EventBusProvider>{children}</EventBusProvider>;\n\n  const props = useMemo(\n    () => ({\n      ref,\n      insideForm,\n      isDisabled,\n      isReadOnly,\n      isRequired,\n      validationState,\n      navigation: navigation || defaultNavigationAdapter,\n      root,\n    }),\n    [\n      ref,\n      insideForm,\n      isDisabled,\n      isReadOnly,\n      isRequired,\n      validationState,\n      navigation,\n      root,\n    ],\n  );\n\n  const newValue = useMemo(() => {\n    let newValue = Object.assign({}, parentContext);\n\n    Object.keys(props).forEach((key) => {\n      if (props[key] != null) {\n        newValue[key] = props[key];\n      }\n    });\n\n    return newValue;\n  }, [parentContext, props]);\n\n  return (\n    <UIKitContext.Provider value={newValue}>{children}</UIKitContext.Provider>\n  );\n}\n\nexport function useProviderProps<T extends ProviderProps = Props>(props: T): T {\n  const contextProps = useContext(UIKitContext);\n\n  return { ...contextProps, ...props } as T;\n}\n"],"mappings":";;;;;;;AA2BA,MAAa,eAAe,cAAmC,EAC7D,YAAY,0BACb,CAAC;AAEF,SAAgB,SAAS,UAA4C;CACnE,IAAI,EACF,UACA,YACA,YACA,YACA,YACA,iBACA,YACA,MACA,QACE;CAEJ,MAAM,gBAAgB,WAAW,aAAa;AAG9C,YAAW,oBAAC,oBAAkB,WAA4B;CAE1D,MAAM,QAAQ,eACL;EACL;EACA;EACA;EACA;EACA;EACA;EACA,YAAY,cAAc;EAC1B;EACD,GACD;EACE;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CACF;CAED,MAAM,WAAW,cAAc;EAC7B,IAAI,WAAW,OAAO,OAAO,EAAE,EAAE,cAAc;AAE/C,SAAO,KAAK,MAAM,CAAC,SAAS,QAAQ;AAClC,OAAI,MAAM,QAAQ,KAChB,UAAS,OAAO,MAAM;IAExB;AAEF,SAAO;IACN,CAAC,eAAe,MAAM,CAAC;AAE1B,QACE,oBAAC,aAAa;EAAS,OAAO;EAAW;GAAiC;;AAI9E,SAAgB,iBAAkD,OAAa;AAG7E,QAAO;EAAE,GAFY,WAAW,aAAa;EAEnB,GAAG;EAAO"}

package/dist/providers/TrackingProvider.d.ts

@@ -0,0 +1,11 @@
+
+import { ReactNode } from "react";
+import "react/jsx-runtime";
+
+//#region src/providers/TrackingProvider.d.ts
+interface TrackingProps {
+  event?: (name: string, data?: Record<string, any>, element?: HTMLElement) => void;
+}
+//#endregion
+export { TrackingProps };
+//# sourceMappingURL=TrackingProvider.d.ts.map

package/dist/providers/TrackingProvider.js

@@ -0,0 +1,21 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { createContext, useContext, useMemo } from "react";
+import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
+
+//#region src/providers/TrackingProvider.tsx
+const TrackingContext = createContext({ event() {} });
+function TrackingProvider({ children, event }) {
+	const tracking = useMemo(() => ({ event }), [event]);
+	if (!event) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	return /* @__PURE__ */ jsx(TrackingContext.Provider, {
+		value: tracking,
+		children
+	});
+}
+function useTracking() {
+	return useContext(TrackingContext);
+}
+
+//#endregion
+export { TrackingProvider, useTracking };
+//# sourceMappingURL=TrackingProvider.js.map

package/dist/providers/TrackingProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackingProvider.js","names":[],"sources":["../../src/providers/TrackingProvider.tsx"],"sourcesContent":["import { createContext, ReactNode, useContext, useMemo } from 'react';\n\nexport interface TrackingProps {\n  event?: (\n    name: string,\n    data?: Record<string, any>,\n    element?: HTMLElement,\n  ) => void;\n}\n\nexport const TrackingContext = createContext<TrackingProps>({\n  event() {\n    // noop\n  },\n});\n\nexport interface CubeTrackingProviderProps extends TrackingProps {\n  children?: ReactNode;\n}\n\nexport function TrackingProvider({\n  children,\n  event,\n}: CubeTrackingProviderProps) {\n  const tracking = useMemo(() => ({ event }), [event]);\n\n  if (!event) return <>{children}</>;\n\n  return (\n    <TrackingContext.Provider value={tracking}>\n      {children}\n    </TrackingContext.Provider>\n  );\n}\n\nexport function useTracking() {\n  const tracking = useContext(TrackingContext);\n\n  return tracking;\n}\n"],"mappings":";;;;;AAUA,MAAa,kBAAkB,cAA6B,EAC1D,QAAQ,IAGT,CAAC;AAMF,SAAgB,iBAAiB,EAC/B,UACA,SAC4B;CAC5B,MAAM,WAAW,eAAe,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC;AAEpD,KAAI,CAAC,MAAO,QAAO,kCAAG,WAAY;AAElC,QACE,oBAAC,gBAAgB;EAAS,OAAO;EAC9B;GACwB;;AAI/B,SAAgB,cAAc;AAG5B,QAFiB,WAAW,gBAAgB"}

package/dist/providers/navigation.types.d.ts

@@ -0,0 +1,29 @@
+
+//#region src/providers/navigation.types.d.ts
+interface Path {
+  pathname?: string;
+  search?: string;
+  hash?: string;
+}
+type To = string | Path;
+type NavigateArg = To | number;
+type RelativeRoutingType = 'route' | 'path';
+interface NavigateOptions {
+  replace?: boolean;
+  state?: unknown;
+  relative?: RelativeRoutingType;
+  preventScrollReset?: boolean;
+}
+type NavigateLike = {
+  (to: To, options?: NavigateOptions): void;
+  (delta: number): void;
+};
+interface NavigationAdapter {
+  useHref: (to: To, options?: {
+    relative?: RelativeRoutingType;
+  }) => string;
+  useNavigate: () => NavigateLike;
+}
+//#endregion
+export { NavigateArg, NavigateLike, NavigateOptions, NavigationAdapter, Path, RelativeRoutingType, To };
+//# sourceMappingURL=navigation.types.d.ts.map

package/dist/providers/navigationAdapter.default.d.ts

@@ -0,0 +1,12 @@
+
+import { NavigationAdapter } from "./navigation.types.js";
+
+//#region src/providers/navigationAdapter.default.d.ts
+/**
+ * Default navigation adapter that provides native browser navigation
+ * when no router is available. This ensures hooks are always callable.
+ */
+declare const defaultNavigationAdapter: NavigationAdapter;
+//#endregion
+export { defaultNavigationAdapter };
+//# sourceMappingURL=navigationAdapter.default.d.ts.map

package/dist/providers/navigationAdapter.default.js

@@ -0,0 +1,38 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+//#region src/providers/navigationAdapter.default.ts
+/**
+* Converts a Path object to a string URL
+*/
+function pathToString(path) {
+	let { pathname = "", search = "", hash = "" } = path;
+	if (pathname && !pathname.startsWith("/")) pathname = `/${pathname}`;
+	if (search && !search.startsWith("?")) search = `?${search}`;
+	if (hash && !hash.startsWith("#")) hash = `#${hash}`;
+	return `${pathname}${search}${hash}`;
+}
+/**
+* Default navigation adapter that provides native browser navigation
+* when no router is available. This ensures hooks are always callable.
+*/
+const defaultNavigationAdapter = {
+	useHref: (to) => {
+		if (typeof to === "string") return to;
+		return pathToString(to);
+	},
+	useNavigate: () => {
+		const navigate = (to, options) => {
+			if (typeof to === "number") {
+				if (typeof window !== "undefined") window.history.go(to);
+				return;
+			}
+			const url = typeof to === "string" ? to : pathToString(to);
+			if (typeof window !== "undefined") if (options?.replace) window.location.replace(url);
+			else window.location.assign(url);
+		};
+		return navigate;
+	}
+};
+
+//#endregion
+export { defaultNavigationAdapter };
+//# sourceMappingURL=navigationAdapter.default.js.map

package/dist/providers/navigationAdapter.default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationAdapter.default.js","names":[],"sources":["../../src/providers/navigationAdapter.default.ts"],"sourcesContent":["import {\n  NavigateLike,\n  NavigateOptions,\n  NavigationAdapter,\n  Path,\n  To,\n} from './navigation.types';\n\n/**\n * Converts a Path object to a string URL\n */\nfunction pathToString(path: Path): string {\n  let { pathname = '', search = '', hash = '' } = path;\n  if (pathname && !pathname.startsWith('/')) pathname = `/${pathname}`;\n  if (search && !search.startsWith('?')) search = `?${search}`;\n  if (hash && !hash.startsWith('#')) hash = `#${hash}`;\n  return `${pathname}${search}${hash}`;\n}\n\n/**\n * Default navigation adapter that provides native browser navigation\n * when no router is available. This ensures hooks are always callable.\n */\nexport const defaultNavigationAdapter: NavigationAdapter = {\n  useHref: (to: To) => {\n    // For strings, return as-is (SSR-safe, no window dependency)\n    if (typeof to === 'string') {\n      return to;\n    }\n    // For objects, normalize to string\n    return pathToString(to);\n  },\n\n  useNavigate: () => {\n    const navigate: NavigateLike = (to: any, options?: NavigateOptions) => {\n      // Handle history navigation (numbers)\n      if (typeof to === 'number') {\n        if (typeof window !== 'undefined') {\n          window.history.go(to);\n        }\n        return;\n      }\n\n      // Handle strings and objects - convert to string URL\n      const url = typeof to === 'string' ? to : pathToString(to);\n\n      if (typeof window !== 'undefined') {\n        if (options?.replace) {\n          window.location.replace(url);\n        } else {\n          window.location.assign(url);\n        }\n      }\n    };\n    return navigate;\n  },\n};\n"],"mappings":";;;;;AAWA,SAAS,aAAa,MAAoB;CACxC,IAAI,EAAE,WAAW,IAAI,SAAS,IAAI,OAAO,OAAO;AAChD,KAAI,YAAY,CAAC,SAAS,WAAW,IAAI,CAAE,YAAW,IAAI;AAC1D,KAAI,UAAU,CAAC,OAAO,WAAW,IAAI,CAAE,UAAS,IAAI;AACpD,KAAI,QAAQ,CAAC,KAAK,WAAW,IAAI,CAAE,QAAO,IAAI;AAC9C,QAAO,GAAG,WAAW,SAAS;;;;;;AAOhC,MAAa,2BAA8C;CACzD,UAAU,OAAW;AAEnB,MAAI,OAAO,OAAO,SAChB,QAAO;AAGT,SAAO,aAAa,GAAG;;CAGzB,mBAAmB;EACjB,MAAM,YAA0B,IAAS,YAA8B;AAErE,OAAI,OAAO,OAAO,UAAU;AAC1B,QAAI,OAAO,WAAW,YACpB,QAAO,QAAQ,GAAG,GAAG;AAEvB;;GAIF,MAAM,MAAM,OAAO,OAAO,WAAW,KAAK,aAAa,GAAG;AAE1D,OAAI,OAAO,WAAW,YACpB,KAAI,SAAS,QACX,QAAO,SAAS,QAAQ,IAAI;OAE5B,QAAO,SAAS,OAAO,IAAI;;AAIjC,SAAO;;CAEV"}

package/dist/shared/form.d.ts

@@ -0,0 +1,114 @@
+
+import { Styles } from "../tasty/styles/types.js";
+import { Props } from "../tasty/types.js";
+import "../tasty/index.js";
+import { ReactNode } from "react";
+
+//#region src/shared/form.d.ts
+/** ValidationResult type for error message functions */
+interface ValidationResult {
+  /** Whether the value is invalid */
+  isInvalid: boolean;
+  /** List of validation error messages */
+  validationErrors: string[];
+  /** Native browser validation details */
+  validationDetails: ValidityState;
+}
+/** Where to place label relative to input */
+type LabelPosition = 'side' | 'top' | 'split';
+/** The type of necessity indicator */
+type NecessityIndicator = 'icon' | 'label';
+/** The validation state of the field */
+type ValidationState = 'invalid' | 'valid';
+/** On which event perform the validation for the field */
+type ValidateTrigger = 'onBlur' | 'onChange' | 'onSubmit';
+/** Core field identity and validation props */
+interface FieldCoreProps {
+  /** The unique ID of the field */
+  id?: string;
+  /** The id prefix for the field to avoid collisions between forms */
+  idPrefix?: string;
+  /** The field name */
+  name?: string;
+  /** The form instance */
+  form?: any;
+  /** Function that checks whether to perform update of the form state. */
+  shouldUpdate?: boolean | ((prevValues: any, nextValues: any) => boolean);
+  /** Validation rules */
+  rules?: ValidationRule[];
+  /** Debounce in milliseconds for validation */
+  validationDelay?: number;
+  /**
+   * @deprecated Use `errorMessage` for error messages and `description` for field descriptions instead.
+   * Message for the field. Some additional information or error notice
+   */
+  message?: ReactNode;
+  /** Description for the field. Will be placed below the label */
+  description?: ReactNode;
+  /** Error message for the field. Always displayed in danger state regardless of validation state */
+  errorMessage?: ReactNode;
+  /** Whether the field is required */
+  isRequired?: boolean;
+  /** Custom label props */
+  labelProps?: Props;
+}
+interface FieldBaseProps extends FormBaseProps, FieldCoreProps {
+  /** The label of the field */
+  label?: ReactNode;
+  /** An additional content next to the label */
+  extra?: ReactNode;
+  necessityIndicator?: NecessityIndicator;
+  necessityLabel?: ReactNode;
+  labelSuffix?: ReactNode;
+  /** A tooltip that is shown inside the label */
+  tooltip?: ReactNode;
+  /** Whether the element should receive focus on render */
+  autoFocus?: boolean;
+  /** Whether the field is hidden. */
+  isHidden?: boolean;
+  /** Whether the field is disabled. */
+  isDisabled?: boolean;
+  /** Whether the field is loading. */
+  isLoading?: boolean;
+  labelPosition?: LabelPosition;
+  labelStyles?: Styles;
+  /** Whether the field is inside the form. Private field. */
+  insideForm?: boolean;
+  fieldProps?: Props;
+  fieldStyles?: Styles;
+  messageStyles?: Styles;
+  /** If true, the input component will be wrapped in a field wrapper even if it doesn't have a label. */
+  forceField?: boolean;
+}
+interface FormBaseProps {
+  /** Styles of the label */
+  labelStyles?: Styles;
+  /** Where to place label relative to input */
+  labelPosition?: LabelPosition;
+  /** Whether the field presents required mark */
+  requiredMark?: boolean;
+  /** The type of necessity indicator */
+  necessityIndicator?: NecessityIndicator;
+  /** That can replace the necessity label */
+  necessityLabel?: ReactNode;
+  /** Whether the field is read only */
+  isReadOnly?: boolean;
+  /** The validation state of the field */
+  validationState?: ValidationState;
+  /** On which event perform validation for the field */
+  validateTrigger?: ValidateTrigger;
+  /** Whether to show valid state */
+  showValid?: boolean;
+}
+type ValidationRuleBase = {
+  [key: string]: any;
+} & {
+  required?: boolean;
+  message?: string;
+};
+type ValidationRule = ValidationRuleBase & {
+  validator?: (ValidationRule: any, any: any) => Promise<string | void>;
+};
+//#endregion
+export { FieldBaseProps, FieldCoreProps, FormBaseProps, LabelPosition, NecessityIndicator, ValidateTrigger, ValidationResult, ValidationRule, ValidationRuleBase, ValidationState };
+//# sourceMappingURL=form.d.ts.map

package/dist/shared/index.d.ts

@@ -0,0 +1,10 @@
+
+import { FieldBaseProps, FieldCoreProps, FormBaseProps, LabelPosition, NecessityIndicator, ValidateTrigger, ValidationResult, ValidationRule, ValidationRuleBase, ValidationState } from "./form.js";
+
+//#region src/shared/index.d.ts
+type Axis = 'top' | 'right' | 'bottom' | 'left';
+type PlacementAxis = Axis | 'center';
+type RangeValue<T> = [T, T];
+//#endregion
+export { Axis, PlacementAxis, RangeValue };
+//# sourceMappingURL=index.d.ts.map

package/dist/states/index.js

@@ -0,0 +1,162 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+import { isDevEnv } from "../utils/is-dev-env.js";
+import { hasStylesGenerated } from "../config.js";
+
+//#region src/tasty/states/index.ts
+/**
+* Advanced State Mapping - Predefined States Management
+*
+* This module handles global and local predefined states for the Tasty styling system.
+* See ADVANCED_STATE_MAPPING.md for full specification.
+*/
+const BUILTIN_STATES = new Set([
+	"@starting",
+	"@keyframes",
+	"@properties",
+	"@supports",
+	"@inherit"
+]);
+let globalPredefinedStates = {};
+const emittedWarnings = /* @__PURE__ */ new Set();
+const devMode = isDevEnv();
+/**
+* Emit a warning only once
+*/
+function warnOnce(key, message) {
+	if (devMode && !emittedWarnings.has(key)) {
+		emittedWarnings.add(key);
+		console.warn(message);
+	}
+}
+/**
+* Configure global predefined states
+*/
+function setGlobalPredefinedStates(states) {
+	if (hasStylesGenerated()) {
+		const newStateNames = Object.keys(states).join(", ");
+		warnOnce(`dynamic-states:${newStateNames}`, `[Tasty] Cannot update predefined states after styles have been generated.\nThe new definition(s) for ${newStateNames} will be ignored.`);
+		return;
+	}
+	for (const [name, value] of Object.entries(states)) {
+		if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {
+			warnOnce(`invalid-state-name:${name}`, `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`);
+			continue;
+		}
+		if (BUILTIN_STATES.has(name)) {
+			warnOnce(`reserved-state:${name}`, `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`);
+			continue;
+		}
+		if (name === "@media" || name === "@root" || name === "@own" || name.startsWith("@(")) {
+			warnOnce(`reserved-prefix:${name}`, `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`);
+			continue;
+		}
+		const crossRefs = extractPredefinedStateRefs(value);
+		if (crossRefs.length > 0) {
+			warnOnce(`cross-ref:${name}`, `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\nPredefined states cannot reference each other. Use the full definition instead.`);
+			continue;
+		}
+		if (globalPredefinedStates[name] && globalPredefinedStates[name] !== value) warnOnce(`duplicate-state:${name}`, `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`);
+		globalPredefinedStates[name] = value;
+	}
+}
+/**
+* Get global predefined states
+*/
+function getGlobalPredefinedStates() {
+	return globalPredefinedStates;
+}
+/**
+* Regex to match predefined state references in a string
+* Matches @name that is NOT followed by ( or : and is a complete word
+* Uses word boundary and negative lookahead
+*/
+const PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;
+/**
+* Extract predefined state references from a string
+*/
+function extractPredefinedStateRefs(value) {
+	const matches = value.matchAll(PREDEFINED_STATE_PATTERN);
+	const refs = [];
+	for (const match of matches) {
+		const stateName = "@" + match[1];
+		if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) refs.push(stateName);
+	}
+	return refs;
+}
+/**
+* Extract local predefined states from a styles object
+* Local predefined states are top-level keys starting with @ that have string values
+* and are valid predefined state names (not built-in like @media, @root, etc.)
+*/
+function extractLocalPredefinedStates(styles) {
+	const localStates = {};
+	if (!styles || typeof styles !== "object") return localStates;
+	for (const [key, value] of Object.entries(styles)) if (key.startsWith("@") && typeof value === "string") {
+		if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) continue;
+		if (BUILTIN_STATES.has(key)) continue;
+		if (key === "@media" || key === "@root" || key === "@own" || key.startsWith("@(")) continue;
+		const crossRefs = extractPredefinedStateRefs(value);
+		if (crossRefs.length > 0) {
+			warnOnce(`local-cross-ref:${key}`, `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\nPredefined states cannot reference each other. Use the full definition instead.`);
+			continue;
+		}
+		localStates[key] = value;
+	}
+	return localStates;
+}
+/**
+* Create a state parser context from styles
+*/
+function createStateParserContext(styles, isSubElement) {
+	return {
+		localPredefinedStates: styles ? extractLocalPredefinedStates(styles) : {},
+		globalPredefinedStates: getGlobalPredefinedStates(),
+		isSubElement
+	};
+}
+/**
+* Resolve a predefined state reference to its value
+* Returns the resolved value or null if not found
+*/
+function resolvePredefinedState(stateKey, ctx) {
+	if (ctx.localPredefinedStates[stateKey]) return ctx.localPredefinedStates[stateKey];
+	if (ctx.globalPredefinedStates[stateKey]) return ctx.globalPredefinedStates[stateKey];
+	warnOnce(`undefined-state:${stateKey}`, `[Tasty] Undefined predefined state '${stateKey}'.\nDefine it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`);
+	return null;
+}
+/**
+* Expand dimension shorthands in a condition string
+* w -> width, h -> height, is -> inline-size, bs -> block-size
+*/
+function expandDimensionShorthands(condition) {
+	let result = condition;
+	result = result.replace(/\bw\b/g, "width");
+	result = result.replace(/\bh\b/g, "height");
+	result = result.replace(/\bis\b/g, "inline-size");
+	result = result.replace(/\bbs\b/g, "block-size");
+	return result;
+}
+/**
+* Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))
+*/
+function expandTastyUnits(value) {
+	return value.replace(/(\d+(?:\.\d+)?)\s*x\b/g, (_, num) => {
+		return `calc(var(--gap) * ${num})`;
+	});
+}
+/**
+* Find the index of the first comma at parentheses depth 0.
+* Returns -1 if no top-level comma is found.
+* This prevents splitting on commas inside function calls like scroll-state(a, b).
+*/
+function findTopLevelComma(s) {
+	let depth = 0;
+	for (let i = 0; i < s.length; i++) if (s[i] === "(") depth++;
+	else if (s[i] === ")") depth--;
+	else if (s[i] === "," && depth === 0) return i;
+	return -1;
+}
+
+//#endregion
+export { createStateParserContext, expandDimensionShorthands, expandTastyUnits, extractLocalPredefinedStates, extractPredefinedStateRefs, findTopLevelComma, resolvePredefinedState, setGlobalPredefinedStates };
+//# sourceMappingURL=index.js.map

package/dist/states/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/tasty/states/index.ts"],"sourcesContent":["/**\n * Advanced State Mapping - Predefined States Management\n *\n * This module handles global and local predefined states for the Tasty styling system.\n * See ADVANCED_STATE_MAPPING.md for full specification.\n */\n\nimport { hasStylesGenerated } from '../config';\nimport { Styles } from '../styles/types';\nimport { isDevEnv } from '../utils/is-dev-env';\n\n/**\n * Parsed advanced state information\n */\nexport interface ParsedAdvancedState {\n  type:\n    | 'media'\n    | 'container'\n    | 'root'\n    | 'own'\n    | 'starting'\n    | 'predefined'\n    | 'modifier';\n  condition: string; // e.g., 'width <= 920px' or 'hovered'\n  containerName?: string; // for container queries\n  raw: string; // original state key\n  mediaType?: string; // for @media:screen, @media:print, etc.\n}\n\n/**\n * Context for state parsing operations\n */\nexport interface StateParserContext {\n  localPredefinedStates: Record<string, string>;\n  globalPredefinedStates: Record<string, string>;\n  isSubElement?: boolean; // true when processing sub-element styles (for @own() validation)\n}\n\n/**\n * At-rule context for CSS generation\n */\nexport interface AtRuleContext {\n  media?: string[]; // @media conditions to wrap rule in (merged with 'and')\n  container?: { name?: string; condition: string }[]; // @container conditions (nested)\n  startingStyle?: boolean;\n  rootStates?: string[]; // :root state selectors (e.g., '[data-theme=\"dark\"]')\n  negatedRootStates?: string[]; // Negated :root state selectors for non-overlapping rules (e.g., ':not([data-theme=\"dark\"])')\n}\n\n// Built-in state names that cannot be overridden\nconst BUILTIN_STATES = new Set([\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@supports',\n  // @inherit is a value (not a key), but reserved here to prevent\n  // users from accidentally defining a state named '@inherit'.\n  '@inherit',\n]);\n\n// Reserved prefixes that are built-in\nconst RESERVED_PREFIXES = [\n  '@media',\n  '@root',\n  '@own',\n  '@(',\n  '@starting',\n  '@keyframes',\n  '@properties',\n  '@supports',\n  '@inherit',\n];\n\n// Global predefined states storage\nlet globalPredefinedStates: Record<string, string> = {};\n\n// Warnings tracking to avoid duplicates\nconst emittedWarnings = new Set<string>();\n\nconst devMode = isDevEnv();\n\n/**\n * Emit a warning only once\n */\nfunction warnOnce(key: string, message: string): void {\n  if (devMode && !emittedWarnings.has(key)) {\n    emittedWarnings.add(key);\n    console.warn(message);\n  }\n}\n\n/**\n * Configure global predefined states\n */\nexport function setGlobalPredefinedStates(\n  states: Record<string, string>,\n): void {\n  if (hasStylesGenerated()) {\n    const newStateNames = Object.keys(states).join(', ');\n    warnOnce(\n      `dynamic-states:${newStateNames}`,\n      `[Tasty] Cannot update predefined states after styles have been generated.\\n` +\n        `The new definition(s) for ${newStateNames} will be ignored.`,\n    );\n    return;\n  }\n\n  // Validate state names\n  for (const [name, value] of Object.entries(states)) {\n    // Check for valid name format\n    if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(name)) {\n      warnOnce(\n        `invalid-state-name:${name}`,\n        `[Tasty] Invalid predefined state name '${name}'. Must start with '@' followed by a letter.`,\n      );\n      continue;\n    }\n\n    // Check for reserved names\n    if (BUILTIN_STATES.has(name)) {\n      warnOnce(\n        `reserved-state:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This name is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for reserved prefixes (but only exact matches, not user-defined states like @mobile)\n    // Reserved prefixes are: @media, @root, @own, @(\n    // A user state like @mobile should NOT be blocked\n    const isReservedPrefix =\n      name === '@media' ||\n      name === '@root' ||\n      name === '@own' ||\n      name.startsWith('@(');\n\n    if (isReservedPrefix) {\n      warnOnce(\n        `reserved-prefix:${name}`,\n        `[Tasty] Cannot define predefined state '${name}'. This prefix is reserved for built-in functionality.`,\n      );\n      continue;\n    }\n\n    // Check for cross-references\n    const crossRefs = extractPredefinedStateRefs(value);\n    if (crossRefs.length > 0) {\n      warnOnce(\n        `cross-ref:${name}`,\n        `[Tasty] Predefined state '${name}' references another predefined state '${crossRefs[0]}'.\\n` +\n          `Predefined states cannot reference each other. Use the full definition instead.`,\n      );\n      continue;\n    }\n\n    // Check for duplicates\n    if (\n      globalPredefinedStates[name] &&\n      globalPredefinedStates[name] !== value\n    ) {\n      warnOnce(\n        `duplicate-state:${name}`,\n        `[Tasty] Duplicate predefined state '${name}' in configure(). The last definition will be used.`,\n      );\n    }\n\n    globalPredefinedStates[name] = value;\n  }\n}\n\n/**\n * Get global predefined states\n */\nexport function getGlobalPredefinedStates(): Record<string, string> {\n  return globalPredefinedStates;\n}\n\n/**\n * Clear global predefined states (for testing only)\n */\nexport function clearGlobalPredefinedStates(): void {\n  globalPredefinedStates = {};\n  emittedWarnings.clear();\n}\n\n/**\n * Regex to match predefined state references in a string\n * Matches @name that is NOT followed by ( or : and is a complete word\n * Uses word boundary and negative lookahead\n */\nconst PREDEFINED_STATE_PATTERN = /@([A-Za-z][A-Za-z0-9-]*)(?![A-Za-z0-9-:(])/g;\n\n/**\n * Extract predefined state references from a string\n */\nexport function extractPredefinedStateRefs(value: string): string[] {\n  const matches = value.matchAll(PREDEFINED_STATE_PATTERN);\n  const refs: string[] = [];\n\n  for (const match of matches) {\n    const stateName = '@' + match[1];\n    // Skip built-in states (@starting) and duplicates\n    // Note: @media, @root, @own are always followed by '(' so the regex\n    // negative lookahead (?![A-Za-z0-9-:(]) already excludes them\n    if (!BUILTIN_STATES.has(stateName) && !refs.includes(stateName)) {\n      refs.push(stateName);\n    }\n  }\n\n  return refs;\n}\n\n/**\n * Check if a state key is a predefined state reference\n */\nexport function isPredefinedStateRef(stateKey: string): boolean {\n  if (!stateKey.startsWith('@')) return false;\n  if (BUILTIN_STATES.has(stateKey)) return false;\n\n  // Check if it's NOT a built-in prefix\n  for (const prefix of RESERVED_PREFIXES) {\n    if (stateKey === prefix || stateKey.startsWith(prefix)) {\n      // Check if it's exactly @media, @root, @own, or starts with @( or @media(\n      if (\n        stateKey === '@media' ||\n        stateKey.startsWith('@media(') ||\n        stateKey.startsWith('@media:')\n      ) {\n        return false;\n      }\n      if (stateKey === '@root' || stateKey.startsWith('@root(')) return false;\n      if (stateKey === '@own' || stateKey.startsWith('@own(')) return false;\n      if (stateKey.startsWith('@(')) return false;\n    }\n  }\n\n  // Must match the predefined state pattern\n  return /^@[A-Za-z][A-Za-z0-9-]*$/.test(stateKey);\n}\n\n/**\n * Extract local predefined states from a styles object\n * Local predefined states are top-level keys starting with @ that have string values\n * and are valid predefined state names (not built-in like @media, @root, etc.)\n */\nexport function extractLocalPredefinedStates(\n  styles: Styles,\n): Record<string, string> {\n  const localStates: Record<string, string> = {};\n\n  if (!styles || typeof styles !== 'object') {\n    return localStates;\n  }\n\n  for (const [key, value] of Object.entries(styles)) {\n    // Check if it's a predefined state definition (starts with @, has string value)\n    if (key.startsWith('@') && typeof value === 'string') {\n      // Validate name format - must be @[letter][letters/numbers/dashes]*\n      if (!/^@[A-Za-z][A-Za-z0-9-]*$/.test(key)) {\n        continue; // Skip invalid names silently (might be something else)\n      }\n\n      // Skip built-in states\n      if (BUILTIN_STATES.has(key)) {\n        continue;\n      }\n\n      // Skip reserved prefixes\n      if (\n        key === '@media' ||\n        key === '@root' ||\n        key === '@own' ||\n        key.startsWith('@(')\n      ) {\n        continue;\n      }\n\n      // Check for cross-references (predefined states cannot reference each other)\n      const crossRefs = extractPredefinedStateRefs(value);\n      if (crossRefs.length > 0) {\n        warnOnce(\n          `local-cross-ref:${key}`,\n          `[Tasty] Predefined state '${key}' references another predefined state '${crossRefs[0]}'.\\n` +\n            `Predefined states cannot reference each other. Use the full definition instead.`,\n        );\n        continue;\n      }\n\n      localStates[key] = value;\n    }\n  }\n\n  return localStates;\n}\n\n/**\n * Create a state parser context from styles\n */\nexport function createStateParserContext(\n  styles?: Styles,\n  isSubElement?: boolean,\n): StateParserContext {\n  const localStates = styles ? extractLocalPredefinedStates(styles) : {};\n\n  return {\n    localPredefinedStates: localStates,\n    globalPredefinedStates: getGlobalPredefinedStates(),\n    isSubElement,\n  };\n}\n\n/**\n * Resolve a predefined state reference to its value\n * Returns the resolved value or null if not found\n */\nexport function resolvePredefinedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): string | null {\n  // Check local first (higher priority)\n  if (ctx.localPredefinedStates[stateKey]) {\n    return ctx.localPredefinedStates[stateKey];\n  }\n\n  // Then check global\n  if (ctx.globalPredefinedStates[stateKey]) {\n    return ctx.globalPredefinedStates[stateKey];\n  }\n\n  // Not found - emit warning\n  warnOnce(\n    `undefined-state:${stateKey}`,\n    `[Tasty] Undefined predefined state '${stateKey}'.\\n` +\n      `Define it in configure({ states: { '${stateKey}': '...' } }) or in the component's styles.`,\n  );\n\n  return null;\n}\n\n/**\n * Normalize state key by trimming whitespace and removing trailing/leading operators\n */\nexport function normalizeStateKey(stateKey: string): {\n  key: string;\n  warnings: string[];\n} {\n  const warnings: string[] = [];\n  let key = stateKey;\n\n  // Check for whitespace-only\n  if (key.trim() === '') {\n    if (key !== '') {\n      warnings.push(\n        `[Tasty] Whitespace-only state key normalized to default state ''.`,\n      );\n    }\n    return { key: '', warnings };\n  }\n\n  // Trim whitespace\n  key = key.trim();\n\n  // Remove trailing operators\n  const trailingOpMatch = key.match(/\\s*[&|^]\\s*$/);\n  if (trailingOpMatch) {\n    const originalKey = key;\n    key = key.slice(0, -trailingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has trailing operator. Normalized to '${key}'.`,\n    );\n  }\n\n  // Remove leading operators (except !)\n  const leadingOpMatch = key.match(/^\\s*[&|^]\\s*/);\n  if (leadingOpMatch) {\n    const originalKey = key;\n    key = key.slice(leadingOpMatch[0].length).trim();\n    warnings.push(\n      `[Tasty] State key '${originalKey}' has leading operator. Normalized to '${key}'.`,\n    );\n  }\n\n  return { key, warnings };\n}\n\n/**\n * Expand dimension shorthands in a condition string\n * w -> width, h -> height, is -> inline-size, bs -> block-size\n */\nexport function expandDimensionShorthands(condition: string): string {\n  // Replace dimension shorthands (only when they appear as standalone words)\n  let result = condition;\n\n  // w -> width (but not part of other words)\n  result = result.replace(/\\bw\\b/g, 'width');\n\n  // h -> height\n  result = result.replace(/\\bh\\b/g, 'height');\n\n  // is -> inline-size\n  result = result.replace(/\\bis\\b/g, 'inline-size');\n\n  // bs -> block-size\n  result = result.replace(/\\bbs\\b/g, 'block-size');\n\n  return result;\n}\n\n/**\n * Convert tasty units in a string (e.g., 40x -> calc(var(--gap) * 40))\n */\nexport function expandTastyUnits(value: string): string {\n  // Match number followed by 'x' unit (tasty gap unit)\n  return value.replace(/(\\d+(?:\\.\\d+)?)\\s*x\\b/g, (_, num) => {\n    return `calc(var(--gap) * ${num})`;\n  });\n}\n\n/**\n * Parse an advanced state key and return its type and components\n */\nexport function parseAdvancedState(\n  stateKey: string,\n  ctx: StateParserContext,\n): ParsedAdvancedState {\n  const raw = stateKey;\n\n  // Check for @starting (exact match)\n  if (stateKey === '@starting') {\n    return {\n      type: 'starting',\n      condition: '',\n      raw,\n    };\n  }\n\n  // Check for @media:type (e.g., @media:print)\n  if (stateKey.startsWith('@media:')) {\n    const mediaType = stateKey.slice(7); // Remove '@media:'\n    if (!['all', 'screen', 'print', 'speech'].includes(mediaType)) {\n      warnOnce(\n        `unknown-media-type:${mediaType}`,\n        `[Tasty] Unknown media type '${mediaType}'. Valid types: all, screen, print, speech.`,\n      );\n    }\n    return {\n      type: 'media',\n      condition: '',\n      mediaType,\n      raw,\n    };\n  }\n\n  // Check for @media(...) - media query with condition\n  if (stateKey.startsWith('@media(')) {\n    const endParen = findMatchingParen(stateKey, 6);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-media:${stateKey}`,\n        `[Tasty] Unclosed media query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    let condition = stateKey.slice(7, endParen);\n\n    // Check for empty condition\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-media:${stateKey}`,\n        `[Tasty] Empty media query condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Expand shorthands and units\n    condition = expandDimensionShorthands(condition);\n    condition = expandTastyUnits(condition);\n\n    return {\n      type: 'media',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @root(...) - root state\n  if (stateKey.startsWith('@root(')) {\n    const endParen = findMatchingParen(stateKey, 5);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-root:${stateKey}`,\n        `[Tasty] Unclosed root state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(6, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-root:${stateKey}`,\n        `[Tasty] Empty root state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    return {\n      type: 'root',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @own(...) - sub-element own state\n  if (stateKey.startsWith('@own(')) {\n    const endParen = findMatchingParen(stateKey, 4);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-own:${stateKey}`,\n        `[Tasty] Unclosed own state '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const condition = stateKey.slice(5, endParen);\n\n    if (!condition.trim()) {\n      warnOnce(\n        `empty-own:${stateKey}`,\n        `[Tasty] Empty own state condition '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if used outside sub-element context\n    if (!ctx.isSubElement) {\n      warnOnce(\n        `own-outside-subelement:${stateKey}`,\n        `[Tasty] @own(${condition}) used outside sub-element context.\\n` +\n          `@own() is equivalent to '${condition}' at the root level. ` +\n          `Did you mean to use it inside a sub-element?`,\n      );\n      // Treat as regular modifier\n      return {\n        type: 'modifier',\n        condition,\n        raw,\n      };\n    }\n\n    return {\n      type: 'own',\n      condition,\n      raw,\n    };\n  }\n\n  // Check for @(...) - container query (unnamed or named)\n  if (stateKey.startsWith('@(')) {\n    const endParen = findMatchingParen(stateKey, 1);\n    if (endParen === -1) {\n      warnOnce(\n        `unclosed-container:${stateKey}`,\n        `[Tasty] Unclosed container query '${stateKey}'. Missing closing parenthesis.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    const content = stateKey.slice(2, endParen);\n\n    if (!content.trim()) {\n      warnOnce(\n        `empty-container:${stateKey}`,\n        `[Tasty] Empty container query '${stateKey}'.`,\n      );\n      return { type: 'modifier', condition: stateKey, raw };\n    }\n\n    // Check if named container (first token is name, followed by comma)\n    // Use parentheses-aware comma search so inner commas (e.g., scroll-state(a, b)) are skipped\n    const commaIndex = findTopLevelComma(content);\n    let containerName: string | undefined;\n    let condition: string;\n\n    if (commaIndex !== -1) {\n      // Named container: @(layout, w < 600px)\n      containerName = content.slice(0, commaIndex).trim();\n      condition = content.slice(commaIndex + 1).trim();\n    } else {\n      // Unnamed container: @(w < 600px)\n      condition = content.trim();\n    }\n\n    // Check for style query shorthand (starts with $)\n    if (condition.startsWith('$')) {\n      // Style query: @(layout, $compact) or @(layout, $variant=compact)\n      const styleCondition = parseStyleQuery(condition);\n      if (!styleCondition) {\n        warnOnce(\n          `invalid-style-query:${stateKey}`,\n          `[Tasty] Invalid style query '${condition}' in container query.`,\n        );\n        return { type: 'modifier', condition: stateKey, raw };\n      }\n      condition = styleCondition;\n    } else if (/^[a-zA-Z][\\w-]*\\s*\\(/.test(condition)) {\n      // Function-like syntax: scroll-state(...), style(...), etc.\n      // Pass through verbatim — no dimension expansion needed\n    } else {\n      // Dimension query - expand shorthands and units\n      condition = expandDimensionShorthands(condition);\n      condition = expandTastyUnits(condition);\n    }\n\n    return {\n      type: 'container',\n      condition,\n      containerName,\n      raw,\n    };\n  }\n\n  // Check for predefined state reference\n  if (isPredefinedStateRef(stateKey)) {\n    const resolved = resolvePredefinedState(stateKey, ctx);\n    if (resolved) {\n      // Recursively parse the resolved value to extract the actual state type\n      // (e.g., @mobile -> @media(w < 768px) should become a media state)\n      const parsedResolved = parseAdvancedState(resolved, ctx);\n      return {\n        ...parsedResolved,\n        raw, // Keep original raw for traceability\n      };\n    }\n    // If not resolved, treat as modifier (will likely produce invalid CSS)\n    return {\n      type: 'modifier',\n      condition: stateKey,\n      raw,\n    };\n  }\n\n  // Regular modifier (boolean mod, pseudo-class, class, attribute)\n  return {\n    type: 'modifier',\n    condition: stateKey,\n    raw,\n  };\n}\n\n/**\n * Parse a style query condition (e.g., $compact, $variant=compact, $variant=\"very compact\")\n */\nfunction parseStyleQuery(condition: string): string | null {\n  // Remove $ prefix\n  const query = condition.slice(1);\n\n  // Check for comparison operators (not supported)\n  if (/[<>]/.test(query)) {\n    warnOnce(\n      `style-query-comparison:${condition}`,\n      `[Tasty] Style queries only support equality. '${condition}' is invalid. Use '${condition.split(/[<>]/)[0]}=...' instead.`,\n    );\n    return null;\n  }\n\n  // Check for equality\n  const eqIndex = query.indexOf('=');\n  if (eqIndex === -1) {\n    // Just existence check: style(--compact)\n    return `style(--${query})`;\n  }\n\n  const propName = query.slice(0, eqIndex).trim();\n  let value = query.slice(eqIndex + 1).trim();\n\n  // Handle quoted values\n  if (\n    (value.startsWith('\"') && value.endsWith('\"')) ||\n    (value.startsWith(\"'\") && value.endsWith(\"'\"))\n  ) {\n    // Keep quotes for CSS\n  } else {\n    // Add quotes if needed\n    value = `\"${value}\"`;\n  }\n\n  // Expand tasty units in value\n  value = expandTastyUnits(value);\n\n  return `style(--${propName}: ${value})`;\n}\n\n/**\n * Find the index of the first comma at parentheses depth 0.\n * Returns -1 if no top-level comma is found.\n * This prevents splitting on commas inside function calls like scroll-state(a, b).\n */\nexport function findTopLevelComma(s: string): number {\n  let depth = 0;\n\n  for (let i = 0; i < s.length; i++) {\n    if (s[i] === '(') depth++;\n    else if (s[i] === ')') depth--;\n    else if (s[i] === ',' && depth === 0) return i;\n  }\n\n  return -1;\n}\n\nfunction findMatchingParen(str: string, startIndex: number): number {\n  let depth = 1;\n  let i = startIndex + 1;\n\n  while (i < str.length && depth > 0) {\n    if (str[i] === '(') depth++;\n    else if (str[i] === ')') depth--;\n    i++;\n  }\n\n  return depth === 0 ? i - 1 : -1;\n}\n\n/**\n * Check if a state key is an advanced state (starts with @)\n */\nexport function isAdvancedState(stateKey: string): boolean {\n  return stateKey.startsWith('@') || stateKey.startsWith('!@');\n}\n\n/**\n * Detect the type of advanced state from a raw state key\n */\nexport function detectAdvancedStateType(\n  stateKey: string,\n): ParsedAdvancedState['type'] {\n  // Handle negation prefix\n  const key = stateKey.startsWith('!') ? stateKey.slice(1) : stateKey;\n\n  if (key === '@starting') return 'starting';\n  if (key.startsWith('@media')) return 'media';\n  if (key.startsWith('@root(')) return 'root';\n  if (key.startsWith('@own(')) return 'own';\n  if (key.startsWith('@(')) return 'container';\n  if (isPredefinedStateRef(key)) return 'predefined';\n  return 'modifier';\n}\n"],"mappings":"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"}

package/dist/styles/align.js

@@ -0,0 +1,15 @@
+/** @license MIT | @cube-dev/ui-kit v0.115.0 | Cube Dev Team */
+//#region src/tasty/styles/align.ts
+function alignStyle({ align }) {
+	if (typeof align !== "string") return;
+	if (!align) return;
+	return {
+		"align-items": align,
+		"align-content": align
+	};
+}
+alignStyle.__lookupStyles = ["align"];
+
+//#endregion
+export { alignStyle };
+//# sourceMappingURL=align.js.map

package/dist/styles/align.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.js","names":[],"sources":["../../src/tasty/styles/align.ts"],"sourcesContent":["export function alignStyle({ align }) {\n  if (typeof align !== 'string') return;\n\n  if (!align) return;\n\n  return {\n    'align-items': align,\n    'align-content': align,\n  };\n}\n\nalignStyle.__lookupStyles = ['align'];\n"],"mappings":";;AAAA,SAAgB,WAAW,EAAE,SAAS;AACpC,KAAI,OAAO,UAAU,SAAU;AAE/B,KAAI,CAAC,MAAO;AAEZ,QAAO;EACL,eAAe;EACf,iBAAiB;EAClB;;AAGH,WAAW,iBAAiB,CAAC,QAAQ"}