@contember/react-utils 1.2.0-beta.3 → 1.2.0-rc.1

package/dist/production/index.js

@@ -1,4 +1,5 @@
 import { createNonNullableContextFactory } from "./context/createNonNullableContextFactory.js";
+import { createOptionalContextFactory } from "./context/createOptionalContextFactory.js";
 import { isNoopScopedConsole, noopLog, noopLogged, noopScopedConsole } from "./debug-context/Constants.js";
 import { DebugChildren, ScopedConsoleContext, useScopedConsoleRef } from "./debug-context/Context.js";
 import { unwrapRefValue } from "./hooks/unwrapRefValue.js";
@@ -8,8 +9,10 @@ import { useArrayMapMemo } from "./hooks/useArrayMapMemo.js";
 import { useComposeRef } from "./hooks/useComposeRef.js";
 import { useConstantLengthInvariant } from "./hooks/useConstantLengthInvariant.js";
 import { useConstantValueInvariant } from "./hooks/useConstantValueInvariant.js";
+import { ContainerWidthContext, useContainerWidth } from "./hooks/useContainerWidth.js";
 import { useDebounce } from "./hooks/useDebounce.js";
 import { useDebounceCallback } from "./hooks/useDebounceCallback.js";
+import { useDocumentTitle } from "./hooks/useDocumentTitle.js";
 import { useElementSize } from "./hooks/useElementSize.js";
 import { useEventHandler } from "./hooks/useEventHandler.js";
 import { useExpectSameValueReference } from "./hooks/useExpectSameValueReference.js";
@@ -31,10 +34,23 @@ import { noop } from "./referentiallyStable/noop.js";
 import { returnFalse } from "./referentiallyStable/returnFalse.js";
 import { returnTrue } from "./referentiallyStable/returnTrue.js";
 import { useReferentiallyStableCallback } from "./referentiallyStable/useReferentiallyStableCallback.js";
+import { ColorSchemeProvider } from "./theming/ColorSchemeProvider.js";
+import { GlobalClassNamePrefixContext } from "./theming/GlobalClassNamePrefixContext.js";
+import { ColorSchemeContext, DEFAULT_COLOR_SCHEME, useColorScheme } from "./theming/contexts.js";
+import { useClassName } from "./theming/useClassName.js";
+import { useClassNameFactory } from "./theming/useClassNameFactory.js";
+import { useThemedClassName } from "./theming/useThemedClassName.js";
+import { useThemedClassNameFactory } from "./theming/useThemedClassNameFactory.js";
 export {
+  ColorSchemeContext,
+  ColorSchemeProvider,
+  ContainerWidthContext,
+  DEFAULT_COLOR_SCHEME,
   DebugChildren,
+  GlobalClassNamePrefixContext,
   ScopedConsoleContext,
   createNonNullableContextFactory,
+  createOptionalContextFactory,
   emptyArray,
   emptyObject,
   identityFunction,
@@ -49,11 +65,16 @@ export {
   useAbortController,
   useAddClassNameDuringResize,
   useArrayMapMemo,
+  useClassName,
+  useClassNameFactory,
+  useColorScheme,
   useComposeRef,
   useConstantLengthInvariant,
   useConstantValueInvariant,
+  useContainerWidth,
   useDebounce,
   useDebounceCallback,
+  useDocumentTitle,
   useElementSize,
   useEventHandler,
   useExpectSameValueReference,
@@ -68,6 +89,8 @@ export {
   useScopedConsoleRef,
   useScrollOffsets,
   useSessionStorageState,
+  useThemedClassName,
+  useThemedClassNameFactory,
   useUpdatedRef,
   useWindowSize
 };

package/dist/production/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/production/theming/ColorSchemeProvider.js

@@ -0,0 +1,14 @@
+import { jsx } from "react/jsx-runtime";
+import { memo } from "react";
+import { useColorScheme, ColorSchemeContext } from "./contexts.js";
+const ColorSchemeProvider = memo(
+  ({ children, scheme }) => {
+    const inheritedColorScheme = useColorScheme();
+    return /* @__PURE__ */ jsx(ColorSchemeContext.Provider, { value: scheme ?? inheritedColorScheme, children });
+  }
+);
+ColorSchemeProvider.displayName = "Interface.ColorSchemeProvider";
+export {
+  ColorSchemeProvider
+};
+//# sourceMappingURL=ColorSchemeProvider.js.map

package/dist/production/theming/ColorSchemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorSchemeProvider.js","sources":["../../../src/theming/ColorSchemeProvider.tsx"],"sourcesContent":["import { KebabCase } from '@contember/utilities'\nimport { memo } from 'react'\nimport { ColorSchemeContext, useColorScheme } from './contexts'\n\nexport type ColorSchemeProviderProps<T extends KebabCase<string>> = {\n\tchildren: React.ReactNode\n\tscheme?: T\n}\n\nexport const ColorSchemeProvider = memo(\n\t<T extends KebabCase<string>>({ children, scheme }: ColorSchemeProviderProps<T>) => {\n\t\tconst inheritedColorScheme = useColorScheme()\n\n\t\treturn (\n\t\t\t<ColorSchemeContext.Provider value={scheme ?? inheritedColorScheme}>{children}</ColorSchemeContext.Provider>\n\t\t)\n\t},\n)\nColorSchemeProvider.displayName = 'Interface.ColorSchemeProvider'\n"],"names":[],"mappings":";;;AASO,MAAM,sBAAsB;AAAA,EAClC,CAA8B,EAAE,UAAU,aAA0C;AACnF,UAAM,uBAAuB;AAE7B,+BACE,mBAAmB,UAAnB,EAA4B,OAAO,UAAU,sBAAuB,SAAS,CAAA;AAAA,EAEhF;AACD;AACA,oBAAoB,cAAc;"}

package/dist/production/theming/GlobalClassNamePrefixContext.js

@@ -0,0 +1,6 @@
+import { createContext } from "react";
+const GlobalClassNamePrefixContext = createContext("cui-");
+export {
+  GlobalClassNamePrefixContext
+};
+//# sourceMappingURL=GlobalClassNamePrefixContext.js.map

package/dist/production/theming/GlobalClassNamePrefixContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalClassNamePrefixContext.js","sources":["../../../src/theming/GlobalClassNamePrefixContext.ts"],"sourcesContent":["import { createContext } from 'react'\n\nexport const GlobalClassNamePrefixContext = createContext<string>('cui-')\n"],"names":[],"mappings":";AAEa,MAAA,+BAA+B,cAAsB,MAAM;"}

package/dist/production/theming/contexts.js

@@ -0,0 +1,12 @@
+import { createOptionalContextFactory } from "../context/createOptionalContextFactory.js";
+const DEFAULT_COLOR_SCHEME = "system";
+const [ColorSchemeContext, useColorScheme] = createOptionalContextFactory(
+  "Interface.ColorScheme",
+  DEFAULT_COLOR_SCHEME
+);
+export {
+  ColorSchemeContext,
+  DEFAULT_COLOR_SCHEME,
+  useColorScheme
+};
+//# sourceMappingURL=contexts.js.map

package/dist/production/theming/contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.js","sources":["../../../src/theming/contexts.ts"],"sourcesContent":["import { createOptionalContextFactory } from '../context'\n\nexport const DEFAULT_COLOR_SCHEME = 'system'\n\n\n/**\n * @group UI\n *\n * @description\n * Provides the current color scheme, possible values are `'light'`, `'dark'` or `'system'`.\n *\n * @see https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme\n *\n */\nexport const [ColorSchemeContext, useColorScheme] = createOptionalContextFactory<string>(\n\t'Interface.ColorScheme',\n\tDEFAULT_COLOR_SCHEME,\n)\n"],"names":[],"mappings":";AAEO,MAAM,uBAAuB;AAYvB,MAAA,CAAC,oBAAoB,cAAc,IAAI;AAAA,EACnD;AAAA,EACA;AACD;"}

package/dist/production/theming/useClassName.js

@@ -0,0 +1,17 @@
+import { flatClassNameList, deduplicateClassName } from "@contember/utilities";
+import { useContext } from "react";
+import { GlobalClassNamePrefixContext } from "./GlobalClassNamePrefixContext.js";
+function useClassName(componentClassName, additionalClassName = null, prefixOverride) {
+  const contextPrefix = useContext(GlobalClassNamePrefixContext);
+  const classNamePrefix = prefixOverride === null || prefixOverride === "" ? "" : prefixOverride || contextPrefix;
+  const componentClassNameList = flatClassNameList(componentClassName).map(
+    (componentClassName2) => `${classNamePrefix}${componentClassName2}`
+  );
+  return deduplicateClassName(componentClassNameList.concat(
+    flatClassNameList(additionalClassName)
+  )).join(" ");
+}
+export {
+  useClassName
+};
+//# sourceMappingURL=useClassName.js.map

package/dist/production/theming/useClassName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClassName.js","sources":["../../../src/theming/useClassName.ts"],"sourcesContent":["import { NestedClassName, deduplicateClassName, flatClassNameList } from '@contember/utilities'\nimport { useContext } from 'react'\nimport { GlobalClassNamePrefixContext } from './GlobalClassNamePrefixContext'\n\n/**\n * Hook for component class name accepting outer class name\n *\n * @param componentClassName - Component class name\n * @param additionalClassName - Additional class name\n * @param prefixOverride - Context component prefix override\n * @returns Prefixed component class name.\n */\nexport function useClassName (\n\tcomponentClassName: NestedClassName,\n\tadditionalClassName: NestedClassName = null,\n\tprefixOverride?: string | null | undefined,\n) {\n\tconst contextPrefix = useContext(GlobalClassNamePrefixContext)\n\tconst classNamePrefix: string = prefixOverride === null || prefixOverride === '' ? '' : prefixOverride || contextPrefix\n\n\tconst componentClassNameList: string[] = flatClassNameList(componentClassName).map(\n\t\tcomponentClassName => `${classNamePrefix}${componentClassName}`,\n\t)\n\n\treturn deduplicateClassName(componentClassNameList.concat(\n\t\tflatClassNameList(additionalClassName),\n\t)).join(' ')\n}\n"],"names":["componentClassName"],"mappings":";;;AAYO,SAAS,aACf,oBACA,sBAAuC,MACvC,gBACC;AACK,QAAA,gBAAgB,WAAW,4BAA4B;AAC7D,QAAM,kBAA0B,mBAAmB,QAAQ,mBAAmB,KAAK,KAAK,kBAAkB;AAEpG,QAAA,yBAAmC,kBAAkB,kBAAkB,EAAE;AAAA,IAC9E,CAAAA,wBAAsB,GAAG,kBAAkBA;AAAAA,EAAA;AAG5C,SAAO,qBAAqB,uBAAuB;AAAA,IAClD,kBAAkB,mBAAmB;AAAA,EAAA,CACrC,EAAE,KAAK,GAAG;AACZ;"}

package/dist/production/theming/useClassNameFactory.js

@@ -0,0 +1,20 @@
+import { flatClassNameList, deduplicateClassName } from "@contember/utilities";
+import { useContext } from "react";
+import { GlobalClassNamePrefixContext } from "./GlobalClassNamePrefixContext.js";
+function useClassNameFactory(componentClassName, glue = "-", prefixOverride) {
+  const contextPrefix = useContext(GlobalClassNamePrefixContext);
+  const classNamePrefix = prefixOverride === null || prefixOverride === "" ? "" : prefixOverride || contextPrefix;
+  const componentClassNameList = flatClassNameList(componentClassName).map(
+    (componentClassName2) => `${classNamePrefix}${componentClassName2}`
+  );
+  return function componentClassNameFor(suffix = null, additionalClassName = null) {
+    const classNameSuffix = suffix ?? "";
+    return deduplicateClassName((classNameSuffix ? classNameSuffix.match(/^[a-zA-Z0-9]/) ? componentClassNameList.map((componentClassName2) => `${componentClassName2}${glue}${classNameSuffix}`) : componentClassNameList.map((componentClassName2) => `${componentClassName2}${classNameSuffix}`) : componentClassNameList).concat(
+      flatClassNameList(additionalClassName)
+    )).join(" ");
+  };
+}
+export {
+  useClassNameFactory
+};
+//# sourceMappingURL=useClassNameFactory.js.map

package/dist/production/theming/useClassNameFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClassNameFactory.js","sources":["../../../src/theming/useClassNameFactory.ts"],"sourcesContent":["import { NestedClassName, deduplicateClassName, flatClassNameList } from '@contember/utilities'\nimport { useContext } from 'react'\nimport { GlobalClassNamePrefixContext } from './GlobalClassNamePrefixContext'\n\n/**\n * Hook for component class name accepting outer class name\n *\n * Returns a reusable function almost that is handy for components\n * with many sub-component parts that should inherit the root component\n * name.\n *\n * Also, product of the factory is a function that can be used outside of rules of hooks.\n *\n * @param componentClassName - Component class name\n * @param glue - String to use to glue component and sub-component suffix\n * @param prefixOverride - Context component prefix override\n * @returns\n */\nexport function useClassNameFactory(\n\tcomponentClassName: NestedClassName,\n\tglue: string | null = '-',\n\tprefixOverride?: string | null | undefined,\n) {\n\tconst contextPrefix = useContext(GlobalClassNamePrefixContext)\n\tconst classNamePrefix: string = prefixOverride === null || prefixOverride === '' ? '' : prefixOverride || contextPrefix\n\n\tconst componentClassNameList: string[] = flatClassNameList(componentClassName).map(\n\t\tcomponentClassName => `${classNamePrefix}${componentClassName}`,\n\t)\n\n\treturn function componentClassNameFor(\n\t\tsuffix: string | null | undefined = null,\n\t\tadditionalClassName: NestedClassName = null,\n\t): string {\n\t\tconst classNameSuffix: string = suffix ?? ''\n\n\t\treturn deduplicateClassName((classNameSuffix\n\t\t\t? (classNameSuffix.match(/^[a-zA-Z0-9]/)\n\t\t\t\t? componentClassNameList.map(componentClassName => `${componentClassName}${glue}${classNameSuffix}`)\n\t\t\t\t: componentClassNameList.map(componentClassName => `${componentClassName}${classNameSuffix}`)\n\t\t\t)\n\t\t\t: componentClassNameList\n\t\t).concat(\n\t\t\tflatClassNameList(additionalClassName),\n\t\t)).join(' ')\n\t}\n}\n"],"names":["componentClassName"],"mappings":";;;AAkBO,SAAS,oBACf,oBACA,OAAsB,KACtB,gBACC;AACK,QAAA,gBAAgB,WAAW,4BAA4B;AAC7D,QAAM,kBAA0B,mBAAmB,QAAQ,mBAAmB,KAAK,KAAK,kBAAkB;AAEpG,QAAA,yBAAmC,kBAAkB,kBAAkB,EAAE;AAAA,IAC9E,CAAAA,wBAAsB,GAAG,kBAAkBA;AAAAA,EAAA;AAG5C,SAAO,SAAS,sBACf,SAAoC,MACpC,sBAAuC,MAC9B;AACT,UAAM,kBAA0B,UAAU;AAEnC,WAAA,sBAAsB,kBACzB,gBAAgB,MAAM,cAAc,IACpC,uBAAuB,IAAI,CAAAA,wBAAsB,GAAGA,sBAAqB,OAAO,iBAAiB,IACjG,uBAAuB,IAAI,CAAAA,wBAAsB,GAAGA,sBAAqB,iBAAiB,IAE3F,wBACD;AAAA,MACD,kBAAkB,mBAAmB;AAAA,IAAA,CACrC,EAAE,KAAK,GAAG;AAAA,EAAA;AAEb;"}

package/dist/production/theming/useThemedClassName.js

@@ -0,0 +1,17 @@
+import { filterThemedClassName, colorSchemeClassName } from "@contember/utilities";
+import { useColorScheme } from "./contexts.js";
+import { useClassName } from "./useClassName.js";
+function useThemedClassName(componentClassName, additionalClassName, prefixOverride) {
+  return useClassName(
+    componentClassName,
+    filterThemedClassName(
+      additionalClassName,
+      colorSchemeClassName(useColorScheme())
+    ),
+    prefixOverride
+  );
+}
+export {
+  useThemedClassName
+};
+//# sourceMappingURL=useThemedClassName.js.map

package/dist/production/theming/useThemedClassName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemedClassName.js","sources":["../../../src/theming/useThemedClassName.ts"],"sourcesContent":["import { NestedClassName, colorSchemeClassName, filterThemedClassName } from '@contember/utilities'\nimport { useColorScheme } from './contexts'\nimport { useClassName } from './useClassName'\n\n/**\n * Hook for component class name accepting outer class name with theme-* and scheme-* class manes\n *\n * It looks for theme CSS classes in the given class name, deduplicates them and returns final theme class name with scheme CSS class set\n * @internal\n *\n * @param componentClassName - Component class name\n * @param additionalClassName - Additional class name\n * @param prefixOverride - Context component prefix override\n * @returns string\n * @see useColorScheme\n *\n * @example\n * ```tsx\n * function Button({ className }: { className?: string | string[] }) {\n * \t const [contentThemeClassName, controlsThemeClassName] = useThemedClassName(className)\n *\n * \t return (\n * \t\t <div className={contentThemeClassName}>\n * \t\t\t <button className={controlsThemeClassName}>Click me</button>\n * \t\t </div>\n * \t )\n * }\n *\n * function App() {\n * \t return (\n * \t\t <Button className=\"theme-default theme-danger:hover\" />\n * \t )\n * }\n *\n * // renders:\n * // <div class=\"scheme-system theme-default-content theme-danger-content:hover\">\n * // \t<button class=\"scheme-system theme-default-controls theme-danger-controls:hover\">Click me</button>\n * // </div>\n * ```\n */\nexport function useThemedClassName(\n\tcomponentClassName: NestedClassName,\n\tadditionalClassName: NestedClassName,\n\tprefixOverride?: string | null | undefined,\n): string {\n\treturn useClassName(\n\t\tcomponentClassName,\n\t\tfilterThemedClassName(\n\t\t\tadditionalClassName,\n\t\t\tcolorSchemeClassName(useColorScheme()),\n\t\t),\n\t\tprefixOverride,\n\t)\n}\n"],"names":[],"mappings":";;;AAwCgB,SAAA,mBACf,oBACA,qBACA,gBACS;AACF,SAAA;AAAA,IACN;AAAA,IACA;AAAA,MACC;AAAA,MACA,qBAAqB,gBAAgB;AAAA,IACtC;AAAA,IACA;AAAA,EAAA;AAEF;"}

package/dist/production/theming/useThemedClassNameFactory.js

@@ -0,0 +1,27 @@
+import { flatClassNameList, colorSchemeClassName, deduplicateClassName, filterThemedClassName } from "@contember/utilities";
+import { useContext } from "react";
+import { GlobalClassNamePrefixContext } from "./GlobalClassNamePrefixContext.js";
+import { useColorScheme } from "./contexts.js";
+function useThemedClassNameFactory(componentClassName, glue = "-", prefixOverride) {
+  const contextPrefix = useContext(GlobalClassNamePrefixContext);
+  const classNamePrefix = prefixOverride === null || prefixOverride === "" ? "" : prefixOverride || contextPrefix;
+  const componentClassNameList = flatClassNameList(componentClassName).map(
+    (componentClassName2) => `${classNamePrefix}${componentClassName2}`
+  );
+  const colorScheme = colorSchemeClassName(useColorScheme());
+  return function componentClassNameFor(suffix = null, additionalClassName = null) {
+    const classNameSuffix = suffix ?? "";
+    return deduplicateClassName((classNameSuffix ? classNameSuffix.match(/^[a-zA-Z0-9]/) ? componentClassNameList.map((componentClassName2) => `${componentClassName2}${glue}${classNameSuffix}`) : componentClassNameList.map((componentClassName2) => `${componentClassName2}${classNameSuffix}`) : componentClassNameList).concat(
+      flatClassNameList(
+        filterThemedClassName(
+          additionalClassName,
+          colorScheme
+        )
+      )
+    )).join(" ");
+  };
+}
+export {
+  useThemedClassNameFactory
+};
+//# sourceMappingURL=useThemedClassNameFactory.js.map

package/dist/production/theming/useThemedClassNameFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemedClassNameFactory.js","sources":["../../../src/theming/useThemedClassNameFactory.ts"],"sourcesContent":["import { NestedClassName, colorSchemeClassName, deduplicateClassName, filterThemedClassName, flatClassNameList } from '@contember/utilities'\nimport { useContext } from 'react'\nimport { GlobalClassNamePrefixContext } from './GlobalClassNamePrefixContext'\nimport { useColorScheme } from './contexts'\n\nexport function useThemedClassNameFactory(\n\tcomponentClassName: NestedClassName,\n\tglue: string | null = '-',\n\tprefixOverride?: string | null | undefined,\n) {\n\tconst contextPrefix = useContext(GlobalClassNamePrefixContext)\n\tconst classNamePrefix: string = prefixOverride === null || prefixOverride === '' ? '' : prefixOverride || contextPrefix\n\n\tconst componentClassNameList: string[] = flatClassNameList(componentClassName).map(\n\t\tcomponentClassName => `${classNamePrefix}${componentClassName}`,\n\t)\n\n\tconst colorScheme = colorSchemeClassName(useColorScheme())\n\n\treturn function componentClassNameFor(\n\t\tsuffix: string | null | undefined = null,\n\t\tadditionalClassName: NestedClassName = null,\n\t): string {\n\t\tconst classNameSuffix: string = suffix ?? ''\n\n\t\treturn deduplicateClassName((classNameSuffix\n\t\t\t? (classNameSuffix.match(/^[a-zA-Z0-9]/)\n\t\t\t\t? componentClassNameList.map(componentClassName => `${componentClassName}${glue}${classNameSuffix}`)\n\t\t\t\t: componentClassNameList.map(componentClassName => `${componentClassName}${classNameSuffix}`)\n\t\t\t)\n\t\t\t: componentClassNameList\n\t\t).concat(\n\t\t\tflatClassNameList(\n\t\t\t\tfilterThemedClassName(\n\t\t\t\t\tadditionalClassName,\n\t\t\t\t\tcolorScheme,\n\t\t\t\t),\n\t\t\t),\n\t\t)).join(' ')\n\t}\n}\n"],"names":["componentClassName"],"mappings":";;;;AAKO,SAAS,0BACf,oBACA,OAAsB,KACtB,gBACC;AACK,QAAA,gBAAgB,WAAW,4BAA4B;AAC7D,QAAM,kBAA0B,mBAAmB,QAAQ,mBAAmB,KAAK,KAAK,kBAAkB;AAEpG,QAAA,yBAAmC,kBAAkB,kBAAkB,EAAE;AAAA,IAC9E,CAAAA,wBAAsB,GAAG,kBAAkBA;AAAAA,EAAA;AAGtC,QAAA,cAAc,qBAAqB,eAAA,CAAgB;AAEzD,SAAO,SAAS,sBACf,SAAoC,MACpC,sBAAuC,MAC9B;AACT,UAAM,kBAA0B,UAAU;AAEnC,WAAA,sBAAsB,kBACzB,gBAAgB,MAAM,cAAc,IACpC,uBAAuB,IAAI,CAAAA,wBAAsB,GAAGA,sBAAqB,OAAO,iBAAiB,IACjG,uBAAuB,IAAI,CAAAA,wBAAsB,GAAGA,sBAAqB,iBAAiB,IAE3F,wBACD;AAAA,MACD;AAAA,QACC;AAAA,UACC;AAAA,UACA;AAAA,QACD;AAAA,MACD;AAAA,IAAA,CACA,EAAE,KAAK,GAAG;AAAA,EAAA;AAEb;"}

package/dist/types/context/createOptionalContextFactory.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from 'react';
+export declare function createOptionalContextFactory<T>(name: string, initialValue: T): [Context<T>, () => T];
+//# sourceMappingURL=createOptionalContextFactory.d.ts.map

package/dist/types/context/createOptionalContextFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOptionalContextFactory.d.ts","sourceRoot":"","sources":["../../../src/context/createOptionalContextFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAGpC,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CASpG"}

package/dist/types/context/index.d.ts

@@ -1,2 +1,3 @@
 export * from './createNonNullableContextFactory';
+export * from './createOptionalContextFactory';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/context/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA"}

package/dist/types/debug-context/Context.d.ts

@@ -1,9 +1,9 @@
 import { ReactNode } from 'react';
 import { ScopedConsoleContextType } from './Types';
 export declare const ScopedConsoleContext: import("react").Context<ScopedConsoleContextType>;
-export declare const useScopedConsoleRef: (prefix: string) => import("react").MutableRefObject<ScopedConsoleContextType>;
+export declare const useScopedConsoleRef: (prefix: string, override?: boolean) => import("react").MutableRefObject<ScopedConsoleContextType>;
 export type DebugChildrenProps = {
-    active: true;
+    active?: true;
     children: ReactNode;
     id: string;
 } | {

package/dist/types/debug-context/Context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/debug-context/Context.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAoD,MAAM,OAAO,CAAA;AAEnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAmClD,eAAO,MAAM,oBAAoB,mDAAiD,CAAA;AAOlF,eAAO,MAAM,mBAAmB,WAAY,MAAM,+DAiBjD,CAAA;AAED,MAAM,MAAM,kBAAkB,GAC3B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;CAAE,GAClD;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CAAE,CAAA;AAExD,eAAO,MAAM,aAAa,0DAYxB,CAAA"}
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/debug-context/Context.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAoD,MAAM,OAAO,CAAA;AAEnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAmClD,eAAO,MAAM,oBAAoB,mDAAiD,CAAA;AAOlF,eAAO,MAAM,mBAAmB,WAAY,MAAM,aAAa,OAAO,+DAiBrE,CAAA;AAED,MAAM,MAAM,kBAAkB,GAC3B;IAAE,MAAM,CAAC,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvD,eAAO,MAAM,aAAa,0DAYxB,CAAA"}

package/dist/types/hooks/index.d.ts

@@ -5,8 +5,10 @@ export * from './useArrayMapMemo';
 export * from './useComposeRef';
 export * from './useConstantLengthInvariant';
 export * from './useConstantValueInvariant';
+export * from './useContainerWidth';
 export * from './useDebounce';
 export * from './useDebounceCallback';
+export * from './useDocumentTitle';
 export * from './useElementSize';
 export * from './useEventHandler';
 export * from './useExpectSameValueReference';

package/dist/types/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,8BAA8B,CAAA;AAC5C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}

package/dist/types/hooks/useAddClassNameDuringResize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAddClassNameDuringResize.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAddClassNameDuringResize.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAC1C,SAAS,EAAE,MAAM,EACjB,gBAAgB,GAAE,MAAY,EAC9B,OAAO,CAAC,EAAE,WAAW,QAerB"}
+{"version":3,"file":"useAddClassNameDuringResize.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAddClassNameDuringResize.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAC1C,SAAS,EAAE,MAAM,EACjB,gBAAgB,GAAE,MAAY,EAC9B,OAAO,CAAC,EAAE,WAAW,QAmBrB"}

package/dist/types/hooks/useContainerWidth.d.ts

@@ -0,0 +1,4 @@
+export type ContainerWidthContextType = number;
+export declare const ContainerWidthContext: import("react").Context<number | null>;
+export declare function useContainerWidth(): number;
+//# sourceMappingURL=useContainerWidth.d.ts.map

package/dist/types/hooks/useContainerWidth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useContainerWidth.d.ts","sourceRoot":"","sources":["../../../src/hooks/useContainerWidth.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAA;AAC9C,eAAO,MAAM,qBAAqB,wCAAwD,CAAA;AAG1F,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}

package/dist/types/hooks/useDocumentTitle.d.ts

@@ -0,0 +1,2 @@
+export declare function useDocumentTitle(title: string | null | undefined, formatter?: (title: string, initialTitle: string) => string): void;
+//# sourceMappingURL=useDocumentTitle.d.ts.map

package/dist/types/hooks/useDocumentTitle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDocumentTitle.d.ts","sourceRoot":"","sources":["../../../src/hooks/useDocumentTitle.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,QAkB7H"}

package/dist/types/hooks/useExpectSameValueReference.d.ts

@@ -1,2 +1,24 @@
+/**
+ * Checks whether the next value is the same reference as the previous one
+ *
+ * If not, it checks whether the values are deeply equal. If not, it logs an error.
+ *
+ * @param next - Value to be checked.
+ * @param shouldThrow - If true, it throws an error instead of logging it. Defaults to false.
+ * @returns void
+ * -
+ * @example
+ * ```ts
+ * useExpectSameValueReference(style)
+ * ```
+ * @example
+ * ```ts
+ * useExpectSameValueReference(style, true)
+ * ```
+ * @example
+ * ```ts
+ * useExpectSameValueReference(style, import.meta.env.DEV)
+ * ```
+ */
 export declare function useExpectSameValueReference<T>(next: T, shouldThrow?: boolean): void;
 //# sourceMappingURL=useExpectSameValueReference.d.ts.map

package/dist/types/hooks/useExpectSameValueReference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useExpectSameValueReference.d.ts","sourceRoot":"","sources":["../../../src/hooks/useExpectSameValueReference.ts"],"names":[],"mappings":"AAIA,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,GAAE,OAAe,QAqBnF"}
+{"version":3,"file":"useExpectSameValueReference.d.ts","sourceRoot":"","sources":["../../../src/hooks/useExpectSameValueReference.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,GAAE,OAAe,QAyBnF"}

package/dist/types/index.d.ts

@@ -2,5 +2,6 @@ export * from './context';
 export * from './debug-context';
 export * from './hooks';
 export * from './referentiallyStable';
+export * from './theming';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,uBAAuB,CAAA;AACrC,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,uBAAuB,CAAA;AACrC,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA"}

package/dist/types/theming/ColorSchemeProvider.d.ts

@@ -0,0 +1,7 @@
+import { KebabCase } from '@contember/utilities';
+export type ColorSchemeProviderProps<T extends KebabCase<string>> = {
+    children: React.ReactNode;
+    scheme?: T;
+};
+export declare const ColorSchemeProvider: import("react").MemoExoticComponent<(<T extends string>({ children, scheme }: ColorSchemeProviderProps<T>) => JSX.Element)>;
+//# sourceMappingURL=ColorSchemeProvider.d.ts.map

package/dist/types/theming/ColorSchemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorSchemeProvider.d.ts","sourceRoot":"","sources":["../../../src/theming/ColorSchemeProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAIhD,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,IAAI;IACnE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,MAAM,CAAC,EAAE,CAAC,CAAA;CACV,CAAA;AAED,eAAO,MAAM,mBAAmB,6HAQ/B,CAAA"}

package/dist/types/theming/GlobalClassNamePrefixContext.d.ts

@@ -0,0 +1,2 @@
+export declare const GlobalClassNamePrefixContext: import("react").Context<string>;
+//# sourceMappingURL=GlobalClassNamePrefixContext.d.ts.map

package/dist/types/theming/GlobalClassNamePrefixContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalClassNamePrefixContext.d.ts","sourceRoot":"","sources":["../../../src/theming/GlobalClassNamePrefixContext.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,4BAA4B,iCAAgC,CAAA"}

package/dist/types/theming/contexts.d.ts

@@ -0,0 +1,12 @@
+export declare const DEFAULT_COLOR_SCHEME = "system";
+/**
+ * @group UI
+ *
+ * @description
+ * Provides the current color scheme, possible values are `'light'`, `'dark'` or `'system'`.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme
+ *
+ */
+export declare const ColorSchemeContext: import("react").Context<string>, useColorScheme: () => string;
+//# sourceMappingURL=contexts.d.ts.map

package/dist/types/theming/contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../../src/theming/contexts.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAG5C;;;;;;;;GAQG;AACH,eAAO,MAAO,kBAAkB,mCAAE,cAAc,cAG/C,CAAA"}

package/dist/types/theming/index.d.ts

@@ -0,0 +1,8 @@
+export * from './ColorSchemeProvider';
+export * from './GlobalClassNamePrefixContext';
+export * from './contexts';
+export * from './useClassName';
+export * from './useClassNameFactory';
+export * from './useThemedClassName';
+export * from './useThemedClassNameFactory';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/theming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theming/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,6BAA6B,CAAA"}

package/dist/types/theming/useClassName.d.ts

@@ -0,0 +1,11 @@
+import { NestedClassName } from '@contember/utilities';
+/**
+ * Hook for component class name accepting outer class name
+ *
+ * @param componentClassName - Component class name
+ * @param additionalClassName - Additional class name
+ * @param prefixOverride - Context component prefix override
+ * @returns Prefixed component class name.
+ */
+export declare function useClassName(componentClassName: NestedClassName, additionalClassName?: NestedClassName, prefixOverride?: string | null | undefined): string;
+//# sourceMappingURL=useClassName.d.ts.map

package/dist/types/theming/useClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClassName.d.ts","sourceRoot":"","sources":["../../../src/theming/useClassName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA2C,MAAM,sBAAsB,CAAA;AAI/F;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,kBAAkB,EAAE,eAAe,EACnC,mBAAmB,GAAE,eAAsB,EAC3C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,UAY1C"}

package/dist/types/theming/useClassNameFactory.d.ts

@@ -0,0 +1,17 @@
+import { NestedClassName } from '@contember/utilities';
+/**
+ * Hook for component class name accepting outer class name
+ *
+ * Returns a reusable function almost that is handy for components
+ * with many sub-component parts that should inherit the root component
+ * name.
+ *
+ * Also, product of the factory is a function that can be used outside of rules of hooks.
+ *
+ * @param componentClassName - Component class name
+ * @param glue - String to use to glue component and sub-component suffix
+ * @param prefixOverride - Context component prefix override
+ * @returns
+ */
+export declare function useClassNameFactory(componentClassName: NestedClassName, glue?: string | null, prefixOverride?: string | null | undefined): (suffix?: string | null | undefined, additionalClassName?: NestedClassName) => string;
+//# sourceMappingURL=useClassNameFactory.d.ts.map

package/dist/types/theming/useClassNameFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClassNameFactory.d.ts","sourceRoot":"","sources":["../../../src/theming/useClassNameFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA2C,MAAM,sBAAsB,CAAA;AAI/F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAClC,kBAAkB,EAAE,eAAe,EACnC,IAAI,GAAE,MAAM,GAAG,IAAU,EACzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,aAUjC,MAAM,GAAG,IAAI,GAAG,SAAS,wBACZ,eAAe,KAClC,MAAM,CAaT"}

package/dist/types/theming/useThemedClassName.d.ts

@@ -0,0 +1,39 @@
+import { NestedClassName } from '@contember/utilities';
+/**
+ * Hook for component class name accepting outer class name with theme-* and scheme-* class manes
+ *
+ * It looks for theme CSS classes in the given class name, deduplicates them and returns final theme class name with scheme CSS class set
+ * @internal
+ *
+ * @param componentClassName - Component class name
+ * @param additionalClassName - Additional class name
+ * @param prefixOverride - Context component prefix override
+ * @returns string
+ * @see useColorScheme
+ *
+ * @example
+ * ```tsx
+ * function Button({ className }: { className?: string | string[] }) {
+ * 	 const [contentThemeClassName, controlsThemeClassName] = useThemedClassName(className)
+ *
+ * 	 return (
+ * 		 <div className={contentThemeClassName}>
+ * 			 <button className={controlsThemeClassName}>Click me</button>
+ * 		 </div>
+ * 	 )
+ * }
+ *
+ * function App() {
+ * 	 return (
+ * 		 <Button className="theme-default theme-danger:hover" />
+ * 	 )
+ * }
+ *
+ * // renders:
+ * // <div class="scheme-system theme-default-content theme-danger-content:hover">
+ * // 	<button class="scheme-system theme-default-controls theme-danger-controls:hover">Click me</button>
+ * // </div>
+ * ```
+ */
+export declare function useThemedClassName(componentClassName: NestedClassName, additionalClassName: NestedClassName, prefixOverride?: string | null | undefined): string;
+//# sourceMappingURL=useThemedClassName.d.ts.map

package/dist/types/theming/useThemedClassName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemedClassName.d.ts","sourceRoot":"","sources":["../../../src/theming/useThemedClassName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA+C,MAAM,sBAAsB,CAAA;AAInG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,kBAAkB,CACjC,kBAAkB,EAAE,eAAe,EACnC,mBAAmB,EAAE,eAAe,EACpC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACxC,MAAM,CASR"}

package/dist/types/theming/useThemedClassNameFactory.d.ts

@@ -0,0 +1,3 @@
+import { NestedClassName } from '@contember/utilities';
+export declare function useThemedClassNameFactory(componentClassName: NestedClassName, glue?: string | null, prefixOverride?: string | null | undefined): (suffix?: string | null | undefined, additionalClassName?: NestedClassName) => string;
+//# sourceMappingURL=useThemedClassNameFactory.d.ts.map

package/dist/types/theming/useThemedClassNameFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemedClassNameFactory.d.ts","sourceRoot":"","sources":["../../../src/theming/useThemedClassNameFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwF,MAAM,sBAAsB,CAAA;AAK5I,wBAAgB,yBAAyB,CACxC,kBAAkB,EAAE,eAAe,EACnC,IAAI,GAAE,MAAM,GAAG,IAAU,EACzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,aAYjC,MAAM,GAAG,IAAI,GAAG,SAAS,wBACZ,eAAe,KAClC,MAAM,CAkBT"}