@hanzogui/web 8.3.0 → 8.3.2

package/dist/cjs/views/Theme.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Theme = void 0;
+exports.getThemedChildren = getThemedChildren;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const constants_1 = require("@hanzogui/constants");
+const react_1 = tslib_1.__importStar(require("react"));
+const createVariable_ts_1 = require("../createVariable.js");
+const useTheme_tsx_1 = require("../hooks/useTheme.js");
+const useThemeState_ts_1 = require("../hooks/useThemeState.js");
+const ThemeDebug_tsx_1 = require("./ThemeDebug.js");
+exports.Theme = (0, react_1.forwardRef)(function Theme(props, ref) {
+    'use no memo';
+    // @ts-expect-error only for internal views
+    if (props.disable) {
+        return props.children;
+    }
+    const { passThrough } = props;
+    const isRoot = !!props['_isRoot'];
+    // pass forThemeView=true so the descendant-cascade effect is installed —
+    // <Theme> pushes themeState.id into ThemeStateContext, so children subscribe
+    // under this id and need to be notified when our propsKey changes.
+    const [_, themeState] = (0, useTheme_tsx_1.useThemeWithState)(props, isRoot, true);
+    const disableDirectChildTheme = props['disable-child-theme'];
+    let finalChildren = disableDirectChildTheme
+        ? react_1.Children.map(props.children, (child) => passThrough || !(0, react_1.isValidElement)(child)
+            ? child
+            : (0, react_1.cloneElement)(child, { ['data-disable-theme']: true }))
+        : props.children;
+    if (ref) {
+        try {
+            react_1.default.Children.only(finalChildren);
+            // TODO deprecate react 18 and then avoid clone here and just pass prop
+            finalChildren = (0, react_1.cloneElement)(finalChildren, { ref });
+        }
+        catch {
+            //ok
+        }
+    }
+    const stateRef = (0, react_1.useRef)({
+        hasEverThemed: false,
+    });
+    return getThemedChildren(themeState, finalChildren, props, isRoot, stateRef, passThrough);
+});
+exports.Theme['avoidForwardRef'] = true;
+function getThemedChildren(themeState, children, props, isRoot = false, stateRef, passThrough = false) {
+    const { shallow, forceClassName } = props;
+    // always be true if ever themed so we avoid re-parenting
+    const state = stateRef.current;
+    let hasEverThemed = state.hasEverThemed;
+    let shouldRenderChildrenWithTheme = hasEverThemed || themeState.isNew || isRoot || (0, useThemeState_ts_1.hasThemeUpdatingProps)(props);
+    if (process.env.NODE_ENV === 'development' && props.debug === 'visualize') {
+        children = ((0, jsx_runtime_1.jsx)(ThemeDebug_tsx_1.ThemeDebug, { themeState: themeState, themeProps: props, children: children }));
+    }
+    if (!shouldRenderChildrenWithTheme) {
+        return children;
+    }
+    // from here on out we have to be careful not to re-parent
+    children = ((0, jsx_runtime_1.jsx)(useThemeState_ts_1.ThemeStateContext.Provider, { value: themeState.id, children: children }));
+    const { isInverse, name } = themeState;
+    const requiresExtraWrapper = isInverse || forceClassName;
+    // it only ever progresses from false => true => 'wrapped'
+    if (!state.hasEverThemed) {
+        state.hasEverThemed = true;
+    }
+    if (requiresExtraWrapper ||
+        // if the theme is exactly dark or light, its likely to change between dark/light
+        // and that would require wrapping which would re-parent, so to avoid re-parenting do this
+        themeState.name === 'dark' ||
+        themeState.name === 'light') {
+        state.hasEverThemed = 'wrapped';
+    }
+    // each children of these children wont get the theme
+    if (shallow) {
+        if (!themeState.parentId) {
+            // they are doing shallow but didnt change actually change a theme theme?
+        }
+        else {
+            const parentState = (0, useThemeState_ts_1.getThemeState)(themeState.isNew ? themeState.id : themeState.parentId);
+            if (!parentState)
+                throw new Error(`‼️010`);
+            children = react_1.Children.toArray(children).map((child) => {
+                return (0, react_1.isValidElement)(child)
+                    ? passThrough
+                        ? child
+                        : (0, react_1.cloneElement)(child, undefined, (0, jsx_runtime_1.jsx)(exports.Theme, { name: parentState.name, children: child.props.children }))
+                    : child;
+            });
+        }
+    }
+    if (process.env.NODE_ENV === 'development') {
+        if (!passThrough && props.debug) {
+            console.warn(` getThemedChildren`, {
+                requiresExtraWrapper,
+                forceClassName,
+                themeState,
+                state,
+                themeSpanProps: getThemeClassNameAndColor(themeState, props, isRoot),
+            });
+        }
+    }
+    // this has to be after a few of the above items so it properly sets context (even if shallow set)
+    if (forceClassName === false) {
+        return children;
+    }
+    if (constants_1.isWeb) {
+        const baseStyle = props.contain ? inertContainedStyle : inertStyle;
+        const { className = '', color } = passThrough
+            ? {}
+            : getThemeClassNameAndColor(themeState, props, isRoot);
+        children = ((0, jsx_runtime_1.jsx)("span", { className: `${className} is_Theme`, style: passThrough ? baseStyle : { color, ...baseStyle }, children: children }));
+        // to prevent tree structure changes always render this if inverse is true or false
+        if (state.hasEverThemed === 'wrapped') {
+            // but still calculate if we need the classnames
+            const className = requiresExtraWrapper
+                ? `${name.startsWith('light') ? 't_light' : name.startsWith('dark') ? 't_dark' : ''} _dsp_contents`
+                : `_dsp_contents`;
+            children = (0, jsx_runtime_1.jsx)("span", { className: className, children: children });
+        }
+        return children;
+    }
+    return children;
+}
+const inertStyle = {
+    display: 'contents',
+};
+const inertContainedStyle = {
+    display: 'contents',
+    contain: 'strict',
+};
+const empty = { className: '', color: undefined };
+function getThemeClassNameAndColor(themeState, props, isRoot = false) {
+    if (!themeState.isNew && !props.forceClassName) {
+        return empty;
+    }
+    // in order to provide currentColor, set color by default
+    const themeColor = themeState?.theme && themeState.isNew ? (0, createVariable_ts_1.variableToString)(themeState.theme.color) : '';
+    const style = themeColor
+        ? {
+            color: themeColor,
+        }
+        : undefined;
+    const themeClassName = themeState.name.replace(schemePrefix, '');
+    // Build full hierarchy of theme classes for CSS variable inheritance
+    // Examples:
+    // - "red_surface1" → "t_red t_red_surface1"
+    // - "green_active_Button" → "t_green t_green_active t_green_active_Button"
+    const themeNameParts = themeClassName.split('_');
+    let themeClasses = `t_${themeClassName}`;
+    if (themeNameParts.length > 1) {
+        // Build full hierarchy for all multi-part themes (sub-themes, component themes, etc.)
+        // This enables CSS variable inheritance through all levels
+        const hierarchyClasses = [];
+        for (let i = 1; i <= themeNameParts.length; i++) {
+            hierarchyClasses.push(`t_${themeNameParts.slice(0, i).join('_')}`);
+        }
+        themeClasses = hierarchyClasses.join(' ');
+    }
+    const className = `${isRoot ? '' : 't_sub_theme'} ${themeClasses}`;
+    return { color: themeColor, className };
+}
+const schemePrefix = /^(dark|light)_/;
+//# sourceMappingURL=Theme.js.map

package/dist/cjs/views/Theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Theme.js","sourceRoot":"","sources":["../../../src/views/Theme.tsx"],"names":[],"mappings":"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"}

package/dist/cjs/views/ThemeDebug.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeDebug = ThemeDebug;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const use_did_finish_ssr_1 = require("@hanzogui/use-did-finish-ssr");
+const react_1 = require("react");
+const react_dom_1 = require("react-dom");
+const useThemeState_ts_1 = require("../hooks/useThemeState.js");
+let node;
+function ThemeDebug({ themeState, themeProps, children, }) {
+    if (process.env.NODE_ENV === 'development') {
+        const isHydrated = (0, use_did_finish_ssr_1.useDidFinishSSR)();
+        if (process.env.NODE_ENV === 'development' && typeof document !== 'undefined') {
+            if (!node) {
+                node = document.createElement('div');
+                node.style.height = '200px';
+                node.style.overflowY = 'scroll';
+                node.style.position = 'fixed';
+                node.style.zIndex = 10000000;
+                node.style.bottom = '30px';
+                node.style.left = '30px';
+                node.style.right = '30px';
+                node.style.display = 'flex';
+                node.style.border = '1px solid #888';
+                node.style.flexDirection = 'row';
+                node.style.background = 'var(--background)';
+            }
+        }
+        (0, react_1.useEffect)(() => {
+            document.body.appendChild(node);
+        }, []);
+        if (themeProps['disable-child-theme'] || !isHydrated) {
+            return children;
+        }
+        const parentState = themeState.parentId ? (0, useThemeState_ts_1.getThemeState)(themeState.parentId) : null;
+        // hsla(0, 0%, 9%, 1)
+        return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, react_dom_1.createPortal)((0, jsx_runtime_1.jsxs)("code", { style: {
+                        whiteSpace: 'pre',
+                        maxWidth: 250,
+                        overflow: 'auto',
+                        padding: 5,
+                    }, children: ["<Theme ", themeState.id, " />\u00A0", JSON.stringify({
+                            name: themeState.name,
+                            color1: themeState.theme.color1.val,
+                            parentId: themeState.parentId,
+                            // inverses: themeState.inverses,
+                            isNew: themeState.isNew,
+                            themeProps: {
+                                name: themeProps.name,
+                                componentName: themeProps.componentName,
+                                reset: themeProps.reset,
+                            },
+                            parentState: {
+                                name: parentState?.name,
+                                isNew: parentState?.isNew,
+                            },
+                        }, null, 2)] }), node), (0, jsx_runtime_1.jsx)("div", { style: { color: 'red' }, children: themeState.id }), children] }));
+    }
+    return children;
+}
+ThemeDebug['displayName'] = 'ThemeDebug';
+//# sourceMappingURL=ThemeDebug.js.map

package/dist/cjs/views/ThemeDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeDebug.js","sourceRoot":"","sources":["../../../src/views/ThemeDebug.tsx"],"names":[],"mappings":"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"}

package/dist/cjs/views/ThemeProvider.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const constants_1 = require("@hanzogui/constants");
+const react_1 = require("react");
+const config_ts_1 = require("../config.js");
+const constants_ts_1 = require("../constants/constants.js");
+const Theme_tsx_1 = require("./Theme.js");
+const ThemeProvider = (props) => {
+    'use no memo';
+    const addThemeClassName = (0, config_ts_1.getSetting)('addThemeClassName');
+    // ensure theme is attached to root body node as well to work with modals by default
+    if ("web" === 'web') {
+        (0, constants_1.useIsomorphicLayoutEffect)(() => {
+            if (addThemeClassName === false)
+                return;
+            const cn = `${constants_ts_1.THEME_CLASSNAME_PREFIX}${props.defaultTheme}`;
+            const target = (0, config_ts_1.getSetting)('addThemeClassName') === 'html'
+                ? document.documentElement
+                : document.body;
+            target.classList.add(cn);
+            return () => {
+                target.classList.remove(cn);
+            };
+        }, [props.defaultTheme, addThemeClassName]);
+    }
+    // we completely disable the className here if its set to any value, 'root', 'body', or false
+    // because in all cases we are putting the classname elsewhere
+    // if its undefined, then the default behavior applies and we use the className here
+    const forceClassName = addThemeClassName === undefined;
+    return ((0, jsx_runtime_1.jsx)(Theme_tsx_1.Theme, { className: props.className, name: props.defaultTheme, forceClassName: forceClassName, 
+        // @ts-expect-error
+        _isRoot: react_1.useId, children: props.children }));
+};
+exports.ThemeProvider = ThemeProvider;
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/cjs/views/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.js","sourceRoot":"","sources":["../../../src/views/ThemeProvider.tsx"],"names":[],"mappings":";;;;AAAA,mDAA+D;AAC/D,iCAA6B;AAC7B,4CAAyC;AACzC,4DAAkE;AAElE,0CAAmC;AAE5B,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAE,EAAE;IACzD,aAAa,CAAA;IAEb,MAAM,iBAAiB,GAAG,IAAA,sBAAU,EAAC,mBAAmB,CAAC,CAAA;IAEzD,oFAAoF;IACpF,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;QACrC,IAAA,qCAAyB,EAAC,GAAG,EAAE;YAC7B,IAAI,iBAAiB,KAAK,KAAK;gBAAE,OAAM;YACvC,MAAM,EAAE,GAAG,GAAG,qCAAsB,GAAG,KAAK,CAAC,YAAY,EAAE,CAAA;YAC3D,MAAM,MAAM,GACV,IAAA,sBAAU,EAAC,mBAAmB,CAAC,KAAK,MAAM;gBACxC,CAAC,CAAC,QAAQ,CAAC,eAAe;gBAC1B,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAA;YACnB,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACxB,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC7B,CAAC,CAAA;QACH,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,6FAA6F;IAC7F,8DAA8D;IAC9D,oFAAoF;IACpF,MAAM,cAAc,GAAG,iBAAiB,KAAK,SAAS,CAAA;IAEtD,OAAO,CACL,uBAAC,iBAAK,IACJ,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,IAAI,EAAE,KAAK,CAAC,YAAY,EACxB,cAAc,EAAE,cAAc;QAC9B,mBAAmB;QACnB,OAAO,EAAE,aAAK,YAEb,KAAK,CAAC,QAAQ,GACT,CACT,CAAA;AACH,CAAC,CAAA;AArCY,QAAA,aAAa,GAAb,aAAa,CAqCzB"}

package/dist/cjs/views/View.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.View = void 0;
+const helpers_1 = require("@hanzogui/helpers");
+const createComponent_tsx_1 = require("../createComponent.js");
+exports.View = (0, createComponent_tsx_1.createComponent)({
+    acceptsClassName: true,
+    validStyles: helpers_1.validStyles,
+});
+//# sourceMappingURL=View.js.map

package/dist/cjs/views/View.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"View.js","sourceRoot":"","sources":["../../../src/views/View.tsx"],"names":[],"mappings":";;;AAAA,+CAA+C;AAE/C,+DAAwD;AAc3C,QAAA,IAAI,GAAG,IAAA,qCAAe,EAKjC;IACA,gBAAgB,EAAE,IAAI;IACtB,WAAW,EAAX,qBAAW;CACZ,CAAC,CAAA"}

package/dist/esm/Gui.js

@@ -0,0 +1,39 @@
+import * as Helpers from '@hanzogui/helpers';
+import { getConfig } from './config.js';
+import { getAllRules, getAllSelectors } from './helpers/insertStyleRule.js';
+import { mediaState } from './helpers/mediaState.js';
+// easy introspection
+// only included in dev mode
+export const Gui = (() => {
+    if (process.env.NODE_ENV === 'development') {
+        class GuiManager {
+            constructor() {
+                this.Helpers = Helpers;
+            }
+            get mediaState() {
+                return { ...mediaState };
+            }
+            get config() {
+                return getConfig();
+            }
+            get insertedRules() {
+                return getAllRules();
+            }
+            get allSelectors() {
+                return getAllSelectors();
+            }
+            get identifierToValue() {
+                return identifierToValue;
+            }
+        }
+        return new GuiManager();
+    }
+})();
+const identifierToValue = new Map();
+export const getValueFromIdentifier = (identifier) => {
+    return identifierToValue.get(identifier);
+};
+export const setIdentifierValue = (identifier, value) => {
+    identifierToValue.set(identifier, value);
+};
+//# sourceMappingURL=Gui.js.map

package/dist/esm/Gui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Gui.js","sourceRoot":"","sources":["../../src/Gui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAA;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8BAA+B,CAAA;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD,qBAAqB;AACrB,4BAA4B;AAE5B,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC3C,MAAM,UAAU;YAAhB;gBACE,YAAO,GAAG,OAAO,CAAA;YAqBnB,CAAC;YAnBC,IAAI,UAAU;gBACZ,OAAO,EAAE,GAAG,UAAU,EAAE,CAAA;YAC1B,CAAC;YAED,IAAI,MAAM;gBACR,OAAO,SAAS,EAAE,CAAA;YACpB,CAAC;YAED,IAAI,aAAa;gBACf,OAAO,WAAW,EAAE,CAAA;YACtB,CAAC;YAED,IAAI,YAAY;gBACd,OAAO,eAAe,EAAE,CAAA;YAC1B,CAAC;YAED,IAAI,iBAAiB;gBACnB,OAAO,iBAAiB,CAAA;YAC1B,CAAC;SACF;QACD,OAAO,IAAI,UAAU,EAAE,CAAA;IACzB,CAAC;AACH,CAAC,CAAC,EAAE,CAAA;AAEJ,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAe,CAAA;AAEhD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAkB,EAAE,EAAE;IAC3D,OAAO,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AAC1C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAkB,EAAE,KAAU,EAAE,EAAE;IACnE,iBAAiB,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;AAC1C,CAAC,CAAA"}

package/dist/esm/_withStableStyle.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { useContext } from 'react';
+import { getConfigMaybe } from './config.js';
+import { useMedia } from './hooks/useMedia.js';
+import { useTheme } from './hooks/useTheme.js';
+import { ThemeStateContext } from './hooks/useThemeState.js';
+/** internal: this is for hanzogui babel plugin usage only */
+const EMPTY_EXPRESSIONS = [];
+const EMPTY_THEME = {};
+export const _withStableStyle = (Component, createStyle, hasThemeKeys, hasMediaKeys) => React.memo(React.forwardRef((props, ref) => {
+    const { _expressions = EMPTY_EXPRESSIONS, ...rest } = props;
+    const parentId = useContext(ThemeStateContext);
+    // compile-time constants per wrapper, so conditional hooks are stable
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const theme = hasThemeKeys && parentId ? useTheme() : null;
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const media = hasMediaKeys ? useMedia() : null;
+    const resolvedExpressions = media
+        ? _expressions.map((expr) => Array.isArray(expr)
+            ? !!(media[expr[0]] && expr[1])
+            : typeof expr === 'string'
+                ? media[expr]
+                : expr)
+        : _expressions;
+    let resolvedTheme = theme || EMPTY_THEME;
+    if (hasThemeKeys && !parentId) {
+        // monorepo edge case: ThemeStateContext is from a different instance
+        const config = getConfigMaybe();
+        const themes = config?.themes;
+        if (themes) {
+            for (const k in themes) {
+                resolvedTheme = themes.light || themes.dark || themes[k];
+                break;
+            }
+        }
+        if (process.env.NODE_ENV === 'development') {
+            console.warn('[@hanzogui] _withStableStyle: no ThemeStateContext found. ' +
+                'This usually means duplicate hanzogui instances in a monorepo. ' +
+                'Falling back to default theme from config.');
+        }
+    }
+    return (_jsx(Component, { ref: ref, style: createStyle(resolvedTheme, resolvedExpressions), ...rest }));
+}));
+//# sourceMappingURL=_withStableStyle.js.map

package/dist/esm/_withStableStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_withStableStyle.js","sourceRoot":"","sources":["../../src/_withStableStyle.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAsB,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAsB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAE5D,6DAA6D;AAE7D,MAAM,iBAAiB,GAAU,EAAE,CAAA;AACnC,MAAM,WAAW,GAAG,EAAE,CAAA;AAEtB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,SAAc,EACd,WAAuD,EACvD,YAAsB,EACtB,YAAsB,EACtB,EAAE,CACF,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,UAAU,CAAC,CAAC,KAAU,EAAE,GAAG,EAAE,EAAE;IACnC,MAAM,EAAE,YAAY,GAAG,iBAAiB,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAE3D,MAAM,QAAQ,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAA;IAE9C,sEAAsE;IACtE,sDAAsD;IACtD,MAAM,KAAK,GAAG,YAAY,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC1D,sDAAsD;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAE9C,MAAM,mBAAmB,GAAG,KAAK;QAC/B,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ;gBACxB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBACb,CAAC,CAAC,IAAI,CACX;QACH,CAAC,CAAC,YAAY,CAAA;IAEhB,IAAI,aAAa,GAAQ,KAAK,IAAI,WAAW,CAAA;IAC7C,IAAI,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,qEAAqE;QACrE,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;QAC/B,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAA;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,aAAa,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;gBACxD,MAAK;YACP,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CACV,4DAA4D;gBAC1D,iEAAiE;gBACjE,4CAA4C,CAC/C,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,CACL,KAAC,SAAS,IACR,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,WAAW,CAAC,aAAa,EAAE,mBAAmB,CAAC,KAClD,IAAI,GACR,CACH,CAAA;AACH,CAAC,CAAC,CACH,CAAA"}

package/dist/esm/animationDriverTypes.test-d.js

@@ -0,0 +1,209 @@
+/**
+ * Type tests for animatedBy prop and animation driver configuration.
+ *
+ * These tests ensure type-safe inference for:
+ * 1. Single animation driver config
+ * 2. Multiple animation drivers config
+ * 3. TypeOverride for lazy-loaded drivers
+ * 4. Combination scenarios
+ *
+ * Run with: yarn test:types
+ */
+import { expectTypeOf, describe, test } from 'vitest';
+// =============================================================================
+// Test: AnimationsConfig types
+// =============================================================================
+describe('AnimationsConfig types', () => {
+    test('AnimationsConfig accepts single driver', () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+    test('AnimationsConfig accepts multi-driver object', () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+    test('AnimationsConfigObject requires default key', () => {
+        expectTypeOf().toMatchTypeOf();
+        // @ts-expect-error - missing default key
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+// =============================================================================
+// Test: CreateGuiConfig preserves animation shape
+// =============================================================================
+describe('CreateGuiConfig animation types', () => {
+    test('CreateGuiConfig.animations accepts single driver', () => {
+        // Should be a union of AnimationDriver<E> | AnimationsConfigObject
+        // Single driver should be assignable to this union
+        const _driver = {};
+    });
+    test('CreateGuiConfig.animations accepts multi-driver object', () => {
+        const _multi = {};
+    });
+});
+// =============================================================================
+// Test: TransitionKeys inference
+// =============================================================================
+describe('TransitionKeys inference', () => {
+    test('TransitionKeys type exists and is string-based', () => {
+        // TransitionKeys should be a string union of animation names
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+// =============================================================================
+// Test: AnimationDriverKeys inference
+// =============================================================================
+describe('AnimationDriverKeys inference', () => {
+    test('AnimationDriverKeys is string or string union', () => {
+        // Should be at least 'default'
+        expectTypeOf().toMatchTypeOf();
+    });
+    test('TypeOverride.animationDrivers exists in interface', () => {
+        expectTypeOf().toBeFunction();
+    });
+    /**
+     * FIXED: AnimationDriverKeys now combines inferred keys with TypeOverride.
+     *
+     * New implementation:
+     *   'default'
+     *   | InferredAnimationDriverKeys
+     *   | (ReturnType<TypeOverride['animationDrivers']> extends 1 ? never : ReturnType<...>)
+     *
+     * This ensures both config-defined drivers AND lazy-loaded drivers are available.
+     */
+    test('AnimationDriverKeys always includes default', () => {
+        // 'default' is always available regardless of config
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+// =============================================================================
+// Test: animatedBy prop on components
+// =============================================================================
+describe('animatedBy prop', () => {
+    test('animatedBy exists on GuiComponentPropsBaseBase', () => {
+        expectTypeOf().toHaveProperty('animatedBy');
+    });
+    test('animatedBy accepts null', () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+    test('animatedBy accepts "default"', () => {
+        expectTypeOf().toMatchTypeOf();
+    });
+    /**
+     * IMPORTANT: This test verifies the full type inference chain for multi-driver configs.
+     *
+     * When user configures: animations: { default: motionDriver, css: cssDriver }
+     * The animatedBy prop should accept: 'default' | 'css' | null
+     *
+     * The type flow is:
+     * 1. CreateGuiProps.animations accepts multi-driver object
+     * 2. InferGuiConfig extracts driver keys via ExtractAnimationDriverKeys
+     * 3. GuiInternalConfig stores keys in AnimDriverKeys generic param
+     * 4. GuiCustomConfig extends the inferred config type
+     * 5. GuiConfig merges with GuiCustomConfig
+     * 6. InferredAnimationDriverKeys reads from GuiConfig['animationDriverKeys']
+     * 7. AnimationDriverKeys combines inferred + TypeOverride
+     * 8. animatedBy uses AnimationDriverKeys
+     */
+    test('multi-driver config type flow preserves all driver keys', () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+// =============================================================================
+// Test: Type regression scenarios
+// =============================================================================
+describe('Type regression scenarios', () => {
+    /**
+     * Scenario 1: Single driver config
+     * User sets: animations: cssDriver
+     * Expected animatedBy values: 'default' only
+     * Expected transition values: keys from cssDriver's animations
+     */
+    test('single driver config scenario', () => {
+        // animatedBy should only allow 'default' since there's one driver
+        // This is correct behavior
+    });
+    /**
+     * Scenario 2: Multiple drivers config
+     * User sets: animations: { default: css, spring: moti, physics: reanimated }
+     * Expected animatedBy values: 'default' | 'spring' | 'physics'
+     * Expected transition values: keys from default driver's animations
+     *
+     * FIXED: CreateGuiConfig.animations now accepts AnimationsConfigObject
+     * which preserves the multi-driver shape for type inference.
+     */
+    test('multiple drivers config scenario - CreateGuiConfig accepts it', () => {
+        const _config = {};
+    });
+    /**
+     * Scenario 3: TypeOverride for lazy loading
+     * User uses TypeOverride to add 'lazySpring' driver loaded at runtime
+     * Expected animatedBy values: inferred keys + 'lazySpring'
+     *
+     * FIXED: AnimationDriverKeys now always includes:
+     * - 'default' (always)
+     * - InferredAnimationDriverKeys (from config)
+     * - TypeOverride keys (when defined)
+     */
+    test('TypeOverride combines with inferred', () => {
+        // Both inferred and override keys should be included
+        // 'default' is always available
+        expectTypeOf().toMatchTypeOf();
+    });
+    /**
+     * Scenario 4: Both multiple drivers + TypeOverride
+     * Config: { default: css, spring: moti }
+     * Override: 'physics'
+     * Expected: 'default' | 'spring' | 'physics'
+     *
+     * FIXED: The union type combines all sources
+     */
+    test('combined multiple drivers and override', () => {
+        // All keys should be available from both sources
+        // Note: actual inference depends on user's GuiConfig setup
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+// =============================================================================
+// Documentation: Applied fixes
+// =============================================================================
+// =============================================================================
+// Test: ExtractAnimationDriverKeys helper
+// =============================================================================
+describe('ExtractAnimationDriverKeys helper', () => {
+    test('single driver returns "default"', () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    test('multi-driver returns all keys', () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    test('multi-driver with css key returns all keys', () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+/**
+ * SUMMARY OF APPLIED TYPE FIXES:
+ *
+ * 1. CreateGuiConfig (line ~737):
+ *    FIXED: Changed from `animations: AnimationDriver<E>`
+ *    To: `animations: AnimationDriver<E> | AnimationsConfigObject`
+ *    This preserves the multi-driver object shape for type inference.
+ *
+ * 2. AnimationDriverKeys (line ~888-895):
+ *    FIXED: Changed from conditional (inferred OR override)
+ *    To: Union of all sources:
+ *      | 'default'
+ *      | InferredAnimationDriverKeys
+ *      | (TypeOverride extends 1 ? never : TypeOverride)
+ *    This ensures both config-defined AND lazy-loaded drivers are available.
+ *
+ * 3. InferredAnimationDriverKeys (line 879-886):
+ *    No changes needed - works correctly with the above fixes.
+ *    Properly infers 'default' for single driver and keyof for multi-driver.
+ *
+ * 4. TransitionKeys (line 868-876):
+ *    No changes needed - already handles both single and multi-driver cases.
+ *    Uses default driver's config for animation names.
+ */
+//# sourceMappingURL=animationDriverTypes.test-d.js.map

package/dist/esm/animationDriverTypes.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationDriverTypes.test-d.js","sourceRoot":"","sources":["../../src/animationDriverTypes.test-d.ts"],"names":[],"mappings":"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"}