@tamagui/create-theme 2.7.7 → 3.0.0-beta.643.1

package/dist/esm/createThemes.native.js

@@ -0,0 +1,103 @@
+function createThemes(tokens, tree, options) {
+	var rootKeys = Object.keys(tree).filter(function(key) {
+		return key !== "children";
+	});
+	if (rootKeys.length !== 2 || !Object.prototype.hasOwnProperty.call(tree, "light") || !Object.prototype.hasOwnProperty.call(tree, "dark")) {
+		throw new Error("createThemes tree must have exactly the roots \"light\" and \"dark\"");
+	}
+	var themes = {};
+	var deduped = /* @__PURE__ */ new Map();
+	var add = function(name, definition, parent, inheritedChildren) {
+		var _options_getTheme;
+		var resolvedDefinition = typeof definition === "function" ? definition({ parent }) : definition;
+		if (resolvedDefinition === null) return;
+		var { values, children, ...recipeFields } = resolvedDefinition;
+		var recipe = {
+			...parent,
+			...recipeFields
+		};
+		var unresolved = {
+			...options === null || options === void 0 ? void 0 : (_options_getTheme = options.getTheme) === null || _options_getTheme === void 0 ? void 0 : _options_getTheme.call(options, {
+				recipe,
+				name,
+				tokens
+			}),
+			...values
+		};
+		var resolved = {};
+		for (var key in unresolved) {
+			var value = unresolved[key];
+			var token = tokens.color[value];
+			if (token !== void 0) {
+				resolved[key] = token;
+				continue;
+			}
+			var isColor = value === "transparent" || /^#(?:[\da-f]{3,4}|[\da-f]{6}|[\da-f]{8})$/i.test(value) || /^(?:rgb|rgba|hsl|hsla)\(\s*[^)]+\)$/i.test(value);
+			if (isColor) {
+				resolved[key] = value;
+				continue;
+			}
+			var nearest = "";
+			var nearestDistance = Number.POSITIVE_INFINITY;
+			for (var tokenName in tokens.color) {
+				var previous = Array.from({ length: tokenName.length + 1 }, function(_, index) {
+					return index;
+				});
+				for (var valueIndex = 0; valueIndex < value.length; valueIndex++) {
+					var diagonal = previous[0];
+					previous[0] = valueIndex + 1;
+					for (var tokenIndex = 0; tokenIndex < tokenName.length; tokenIndex++) {
+						var above = previous[tokenIndex + 1];
+						previous[tokenIndex + 1] = Math.min(previous[tokenIndex] + 1, above + 1, diagonal + (value[valueIndex] === tokenName[tokenIndex] ? 0 : 1));
+						diagonal = above;
+					}
+				}
+				var distance = previous[tokenName.length];
+				if (distance < nearestDistance) {
+					nearest = tokenName;
+					nearestDistance = distance;
+				}
+			}
+			throw new Error(`Invalid color value "${value}" for theme "${name}" key "${key}".${nearest ? ` Did you mean token "${nearest}"?` : ""}`);
+		}
+		var identity = JSON.stringify(Object.keys(resolved).sort().map(function(key2) {
+			return [key2, resolved[key2]];
+		}));
+		themes[name] = deduped.get(identity) || resolved;
+		deduped.set(identity, themes[name]);
+		var childSets = [inheritedChildren, children];
+		var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = void 0;
+		try {
+			for (var _iterator = childSets[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+				var childSet = _step.value;
+				if (!childSet) continue;
+				for (var childName in childSet) {
+					var fullName = `${name}_${childName}`;
+					if (Object.prototype.hasOwnProperty.call(themes, fullName)) {
+						throw new Error(`Duplicate generated theme name "${fullName}"`);
+					}
+					add(fullName, childSet[childName], recipe);
+				}
+			}
+		} catch (err) {
+			_didIteratorError = true;
+			_iteratorError = err;
+		} finally {
+			try {
+				if (!_iteratorNormalCompletion && _iterator.return != null) {
+					_iterator.return();
+				}
+			} finally {
+				if (_didIteratorError) {
+					throw _iteratorError;
+				}
+			}
+		}
+	};
+	add("light", tree.light, {}, tree.children);
+	add("dark", tree.dark, {}, tree.children);
+	return themes;
+}
+
+export { createThemes };
+//# sourceMappingURL=createThemes.native.js.map

package/dist/esm/createThemes.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createThemes.native.js","names":[],"sources":["esm/createThemes.native.js"],"sourcesContent":["function createThemes(tokens, tree, options) {\n  var rootKeys = Object.keys(tree).filter(function(key) {\n    return key !== \"children\";\n  });\n  if (rootKeys.length !== 2 || !Object.prototype.hasOwnProperty.call(tree, \"light\") || !Object.prototype.hasOwnProperty.call(tree, \"dark\")) {\n    throw new Error('createThemes tree must have exactly the roots \"light\" and \"dark\"');\n  }\n  var themes = {};\n  var deduped = /* @__PURE__ */ new Map();\n  var add = function(name, definition, parent, inheritedChildren) {\n    var _options_getTheme;\n    var resolvedDefinition = typeof definition === \"function\" ? definition({\n      parent\n    }) : definition;\n    if (resolvedDefinition === null) return;\n    var { values, children, ...recipeFields } = resolvedDefinition;\n    var recipe = {\n      ...parent,\n      ...recipeFields\n    };\n    var unresolved = {\n      ...options === null || options === void 0 ? void 0 : (_options_getTheme = options.getTheme) === null || _options_getTheme === void 0 ? void 0 : _options_getTheme.call(options, {\n        recipe,\n        name,\n        tokens\n      }),\n      ...values\n    };\n    var resolved = {};\n    for (var key in unresolved) {\n      var value = unresolved[key];\n      var token = tokens.color[value];\n      if (token !== void 0) {\n        resolved[key] = token;\n        continue;\n      }\n      var isColor = value === \"transparent\" || /^#(?:[\\da-f]{3,4}|[\\da-f]{6}|[\\da-f]{8})$/i.test(value) || /^(?:rgb|rgba|hsl|hsla)\\(\\s*[^)]+\\)$/i.test(value);\n      if (isColor) {\n        resolved[key] = value;\n        continue;\n      }\n      var nearest = \"\";\n      var nearestDistance = Number.POSITIVE_INFINITY;\n      for (var tokenName in tokens.color) {\n        var previous = Array.from({\n          length: tokenName.length + 1\n        }, function(_, index) {\n          return index;\n        });\n        for (var valueIndex = 0; valueIndex < value.length; valueIndex++) {\n          var diagonal = previous[0];\n          previous[0] = valueIndex + 1;\n          for (var tokenIndex = 0; tokenIndex < tokenName.length; tokenIndex++) {\n            var above = previous[tokenIndex + 1];\n            previous[tokenIndex + 1] = Math.min(previous[tokenIndex] + 1, above + 1, diagonal + (value[valueIndex] === tokenName[tokenIndex] ? 0 : 1));\n            diagonal = above;\n          }\n        }\n        var distance = previous[tokenName.length];\n        if (distance < nearestDistance) {\n          nearest = tokenName;\n          nearestDistance = distance;\n        }\n      }\n      throw new Error(`Invalid color value \"${value}\" for theme \"${name}\" key \"${key}\".${nearest ? ` Did you mean token \"${nearest}\"?` : \"\"}`);\n    }\n    var identity = JSON.stringify(Object.keys(resolved).sort().map(function(key2) {\n      return [\n        key2,\n        resolved[key2]\n      ];\n    }));\n    themes[name] = deduped.get(identity) || resolved;\n    deduped.set(identity, themes[name]);\n    var childSets = [\n      inheritedChildren,\n      children\n    ];\n    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = void 0;\n    try {\n      for (var _iterator = childSets[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {\n        var childSet = _step.value;\n        if (!childSet) continue;\n        for (var childName in childSet) {\n          var fullName = `${name}_${childName}`;\n          if (Object.prototype.hasOwnProperty.call(themes, fullName)) {\n            throw new Error(`Duplicate generated theme name \"${fullName}\"`);\n          }\n          add(fullName, childSet[childName], recipe);\n        }\n      }\n    } catch (err) {\n      _didIteratorError = true;\n      _iteratorError = err;\n    } finally {\n      try {\n        if (!_iteratorNormalCompletion && _iterator.return != null) {\n          _iterator.return();\n        }\n      } finally {\n        if (_didIteratorError) {\n          throw _iteratorError;\n        }\n      }\n    }\n  };\n  add(\"light\", tree.light, {}, tree.children);\n  add(\"dark\", tree.dark, {}, tree.children);\n  return themes;\n}\nexport {\n  createThemes\n};\n//# sourceMappingURL=createThemes.js.map\n"],"mappings":"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"}

package/dist/esm/index.js

@@ -1,7 +1 @@
-export * from "./createTheme.mjs";
-export * from "./masks.mjs";
-export * from "./combineMasks.mjs";
-export * from "./applyMask.mjs";
-export * from "./createThemeTypes.mjs";
-export * from "./helpers.mjs";
-//# sourceMappingURL=index.js.map
+export * from "./createThemes.mjs"

package/dist/esm/index.mjs

@@ -1,7 +1 @@
-export * from "./createTheme.mjs";
-export * from "./masks.mjs";
-export * from "./combineMasks.mjs";
-export * from "./applyMask.mjs";
-export * from "./createThemeTypes.mjs";
-export * from "./helpers.mjs";
-//# sourceMappingURL=index.mjs.map
+export * from "./createThemes.mjs"

package/dist/esm/index.native.js

@@ -1,7 +1 @@
-export * from "./createTheme.native.js";
-export * from "./masks.native.js";
-export * from "./combineMasks.native.js";
-export * from "./applyMask.native.js";
-export * from "./createThemeTypes.native.js";
-export * from "./helpers.native.js";
-//# sourceMappingURL=index.native.js.map
+export * from "./createThemes.native.js"

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@tamagui/create-theme",
-  "version": "2.7.7",
+  "version": "3.0.0-beta.643.1",
   "files": [
     "src",
     "types",
-    "dist",
-    "theme-builder"
+    "dist"
   ],
   "type": "module",
   "sideEffects": false,
@@ -29,15 +28,15 @@
   },
   "scripts": {
     "build": "tamagui-build",
+    "test": "bun test tests/createThemes.test.ts",
+    "test:types": "vitest --typecheck --run tests/createThemes.test-d.ts",
     "watch": "tamagui-build --watch",
     "clean": "tamagui-build clean",
     "clean:build": "tamagui-build clean:build"
   },
-  "dependencies": {
-    "@tamagui/web": "2.7.7"
-  },
   "devDependencies": {
-    "@tamagui/build": "2.7.7"
+    "@tamagui/build": "3.0.0-beta.643.1",
+    "vitest": "4.0.4"
   },
   "repository": {
     "type": "git",

package/src/createThemes.tsx

@@ -0,0 +1,328 @@
+export type ThemeValue = string
+
+export type ThemeTokens = {
+  color: Record<string, ThemeValue>
+}
+
+export type ThemeRecipe = Record<string, unknown>
+
+export type ThemeDefinitionContext<Parent extends ThemeRecipe = ThemeRecipe> = {
+  parent: Parent
+}
+
+export type ThemeDefinitionObject = {
+  values?: Record<string, ThemeValue>
+  children?: ThemeChildren
+  [key: string]: unknown
+}
+
+export type ThemeTreeDefinition<Parent extends ThemeRecipe = ThemeRecipe> =
+  | ThemeDefinitionObject
+  | ((context: ThemeDefinitionContext<Parent>) => ThemeDefinitionObject | null)
+
+export type ThemeChildren = Record<string, ThemeTreeDefinition>
+
+export type ThemeTree = {
+  light: ThemeTreeDefinition
+  dark: ThemeTreeDefinition
+  children?: ThemeChildren
+}
+
+type ColorLiteral = `#${string}` | `rgb${string}` | `hsl${string}` | 'transparent'
+
+type ThemeInputValue<Tokens extends ThemeTokens> =
+  | Extract<keyof Tokens['color'], string>
+  | ColorLiteral
+
+type ResolvedDefinition<Definition> = Definition extends (...args: any[]) => infer Result
+  ? Exclude<Result, null>
+  : Definition
+
+type DefinitionChildren<Definition> =
+  ResolvedDefinition<Definition> extends {
+    children?: infer Children
+  }
+    ? Children
+    : never
+
+type ChildThemeNames<Parent extends string, Children> =
+  Children extends Record<string, unknown>
+    ? {
+        [Name in Extract<keyof Children, string>]:
+          | `${Parent}_${Name}`
+          | ChildThemeNames<`${Parent}_${Name}`, DefinitionChildren<Children[Name]>>
+      }[Extract<keyof Children, string>]
+    : never
+
+export type ThemeNames<Tree extends ThemeTree> =
+  | 'light'
+  | 'dark'
+  | ChildThemeNames<'light', Tree['children']>
+  | ChildThemeNames<'dark', Tree['children']>
+  | ChildThemeNames<'light', DefinitionChildren<Tree['light']>>
+  | ChildThemeNames<'dark', DefinitionChildren<Tree['dark']>>
+
+type RecipeFields<Definition> = Omit<
+  ResolvedDefinition<Definition>,
+  'children' | 'values'
+>
+
+type ChildDefinitions<
+  Children,
+  Depth extends readonly unknown[],
+> = Depth extends readonly [unknown, ...infer Rest]
+  ? Children extends Record<string, unknown>
+    ? Children[keyof Children] | DefinitionsWithin<Children[keyof Children], Rest>
+    : never
+  : never
+
+type DefinitionsWithin<Definition, Depth extends readonly unknown[]> =
+  | Definition
+  | ChildDefinitions<DefinitionChildren<Definition>, Depth>
+
+type DefinitionsInTree<Tree extends ThemeTree> =
+  | DefinitionsWithin<Tree['light'], [1, 1, 1, 1, 1, 1]>
+  | DefinitionsWithin<Tree['dark'], [1, 1, 1, 1, 1, 1]>
+  | ChildDefinitions<Tree['children'], [1, 1, 1, 1, 1, 1]>
+
+type KeysOfUnion<Union> = Union extends Union ? keyof Union : never
+
+type ValueOfUnion<Union, Key extends PropertyKey> = Union extends Union
+  ? Key extends keyof Union
+    ? Union[Key]
+    : never
+  : never
+
+type MergeRecipeUnion<Union> = {
+  [Key in KeysOfUnion<Union>]: ValueOfUnion<Union, Key>
+}
+
+type RootRecipe<Tree extends ThemeTree> =
+  | RecipeFields<Tree['light']>
+  | RecipeFields<Tree['dark']>
+
+type RecipeForTree<Tree extends ThemeTree> = {
+  [Key in keyof RootRecipe<Tree>]: ValueOfUnion<RootRecipe<Tree>, Key>
+} & Partial<MergeRecipeUnion<RecipeFields<DefinitionsInTree<Tree>>>>
+
+export type GetThemeContext<
+  Tokens extends ThemeTokens = ThemeTokens,
+  Recipe extends ThemeRecipe = ThemeRecipe,
+> = {
+  recipe: Recipe
+  name: string
+  tokens: Tokens
+}
+
+type InvalidValueKeys<Values, Theme> = Exclude<keyof Values, keyof Theme>
+
+type ValidatedValues<Values, Theme, Tokens extends ThemeTokens> =
+  Values extends Record<string, unknown>
+    ? Values & {
+        [Key in InvalidValueKeys<Values, Theme>]: never
+      } & {
+        [Key in keyof Values]: Values[Key] extends ThemeInputValue<Tokens>
+          ? Values[Key]
+          : never
+      }
+    : never
+
+type ValidatedChildren<Children, Theme, Tokens extends ThemeTokens> =
+  Children extends Record<string, unknown>
+    ? {
+        [Name in keyof Children]: ValidatedDefinition<Children[Name], Theme, Tokens>
+      }
+    : never
+
+type ValidatedDefinition<
+  Definition,
+  Theme,
+  Tokens extends ThemeTokens,
+> = Definition extends (...args: infer Args) => infer Result
+  ? (
+      ...args: Args
+    ) => Result extends null ? null : ValidatedDefinitionObject<Result, Theme, Tokens>
+  : ValidatedDefinitionObject<Definition, Theme, Tokens>
+
+type ValidatedDefinitionObject<Definition, Theme, Tokens extends ThemeTokens> =
+  Definition extends Record<string, unknown>
+    ? Definition &
+        ('values' extends keyof Definition
+          ? {
+              values: ValidatedValues<Definition['values'], Theme, Tokens>
+            }
+          : unknown) &
+        ('children' extends keyof Definition
+          ? {
+              children: ValidatedChildren<Definition['children'], Theme, Tokens>
+            }
+          : unknown)
+    : never
+
+type ValidatedTree<Tree extends ThemeTree, Theme, Tokens extends ThemeTokens> = Tree & {
+  light: ValidatedDefinition<Tree['light'], Theme, Tokens>
+  dark: ValidatedDefinition<Tree['dark'], Theme, Tokens>
+  children?: ValidatedChildren<Tree['children'], Theme, Tokens>
+}
+
+type ValuesInDefinition<Definition> =
+  ResolvedDefinition<Definition> extends {
+    values?: infer Values
+  }
+    ? Values
+    : never
+
+type ValueDefinitionsWithin<Definition, Depth extends readonly unknown[]> =
+  | ValuesInDefinition<Definition>
+  | (Depth extends readonly [unknown, ...infer Rest]
+      ? DefinitionChildren<Definition> extends infer Children
+        ? Children extends Record<string, unknown>
+          ? ValueDefinitionsWithin<Children[keyof Children], Rest>
+          : never
+        : never
+      : never)
+
+type ExplicitTheme<Tree extends ThemeTree> = MergeRecipeUnion<
+  | ValueDefinitionsWithin<Tree['light'], [1, 1, 1, 1, 1, 1]>
+  | ValueDefinitionsWithin<Tree['dark'], [1, 1, 1, 1, 1, 1]>
+  | (Tree['children'] extends infer Children
+      ? Children extends Record<string, unknown>
+        ? ValueDefinitionsWithin<Children[keyof Children], [1, 1, 1, 1, 1, 1]>
+        : never
+      : never)
+>
+
+export type CreatedThemes<Names extends string, Theme extends Record<string, string>> = {
+  [Name in Names]: { [Key in keyof Theme]: string }
+}
+
+export function createThemes<
+  const Tokens extends ThemeTokens,
+  const Tree extends ThemeTree,
+  const Theme extends Record<string, ThemeInputValue<Tokens>>,
+>(
+  tokens: Tokens,
+  tree: ValidatedTree<Tree, Theme, Tokens>,
+  options: {
+    getTheme: (context: GetThemeContext<Tokens, RecipeForTree<Tree>>) => Theme
+  }
+): CreatedThemes<ThemeNames<Tree>, Theme>
+
+export function createThemes<
+  const Tokens extends ThemeTokens,
+  const Tree extends ThemeTree,
+>(
+  tokens: Tokens,
+  tree: ValidatedTree<Tree, Record<string, string>, Tokens>,
+  options?: { getTheme?: undefined }
+): CreatedThemes<ThemeNames<Tree>, ExplicitTheme<Tree>>
+
+export function createThemes(
+  tokens: ThemeTokens,
+  tree: ThemeTree,
+  options?: {
+    getTheme?: (context: GetThemeContext) => Record<string, string>
+  }
+): Record<string, Record<string, string>> {
+  const rootKeys = Object.keys(tree).filter((key) => key !== 'children')
+  if (
+    rootKeys.length !== 2 ||
+    !Object.prototype.hasOwnProperty.call(tree, 'light') ||
+    !Object.prototype.hasOwnProperty.call(tree, 'dark')
+  ) {
+    throw new Error('createThemes tree must have exactly the roots "light" and "dark"')
+  }
+
+  const themes: Record<string, Record<string, string>> = {}
+  const deduped = new Map<string, Record<string, string>>()
+
+  const add = (
+    name: string,
+    definition: ThemeTreeDefinition,
+    parent: ThemeRecipe,
+    inheritedChildren?: ThemeChildren
+  ): void => {
+    const resolvedDefinition =
+      typeof definition === 'function' ? definition({ parent }) : definition
+    if (resolvedDefinition === null) return
+
+    const { values, children, ...recipeFields } = resolvedDefinition
+    const recipe = { ...parent, ...recipeFields }
+    const unresolved = {
+      ...options?.getTheme?.({ recipe, name, tokens }),
+      ...values,
+    }
+    const resolved: Record<string, string> = {}
+
+    for (const key in unresolved) {
+      const value = unresolved[key]
+      const token = tokens.color[value]
+      if (token !== undefined) {
+        resolved[key] = token
+        continue
+      }
+
+      const isColor =
+        value === 'transparent' ||
+        /^#(?:[\da-f]{3,4}|[\da-f]{6}|[\da-f]{8})$/i.test(value) ||
+        /^(?:rgb|rgba|hsl|hsla)\(\s*[^)]+\)$/i.test(value)
+      if (isColor) {
+        resolved[key] = value
+        continue
+      }
+
+      let nearest = ''
+      let nearestDistance = Number.POSITIVE_INFINITY
+      for (const tokenName in tokens.color) {
+        const previous = Array.from({ length: tokenName.length + 1 }, (_, index) => index)
+        for (let valueIndex = 0; valueIndex < value.length; valueIndex++) {
+          let diagonal = previous[0]!
+          previous[0] = valueIndex + 1
+          for (let tokenIndex = 0; tokenIndex < tokenName.length; tokenIndex++) {
+            const above = previous[tokenIndex + 1]!
+            previous[tokenIndex + 1] = Math.min(
+              previous[tokenIndex]! + 1,
+              above + 1,
+              diagonal + (value[valueIndex] === tokenName[tokenIndex] ? 0 : 1)
+            )
+            diagonal = above
+          }
+        }
+        const distance = previous[tokenName.length]!
+        if (distance < nearestDistance) {
+          nearest = tokenName
+          nearestDistance = distance
+        }
+      }
+
+      throw new Error(
+        `Invalid color value "${value}" for theme "${name}" key "${key}".${nearest ? ` Did you mean token "${nearest}"?` : ''}`
+      )
+    }
+
+    const identity = JSON.stringify(
+      Object.keys(resolved)
+        .sort()
+        .map((key) => [key, resolved[key]])
+    )
+    themes[name] = deduped.get(identity) || resolved
+    deduped.set(identity, themes[name]!)
+
+    const childSets = [inheritedChildren, children]
+    for (const childSet of childSets) {
+      if (!childSet) continue
+      for (const childName in childSet) {
+        const fullName = `${name}_${childName}`
+        if (Object.prototype.hasOwnProperty.call(themes, fullName)) {
+          throw new Error(`Duplicate generated theme name "${fullName}"`)
+        }
+        add(fullName, childSet[childName]!, recipe)
+      }
+    }
+  }
+
+  add('light', tree.light, {}, tree.children)
+  add('dark', tree.dark, {}, tree.children)
+
+  return themes
+}

package/src/index.tsx

@@ -1,6 +1 @@
-export * from './createTheme'
-export * from './masks'
-export * from './combineMasks'
-export * from './applyMask'
-export * from './createThemeTypes'
-export * from './helpers'
+export * from './createThemes'

package/types/createThemes.d.ts

@@ -0,0 +1,122 @@
+export type ThemeValue = string;
+export type ThemeTokens = {
+	color: Record<string, ThemeValue>;
+};
+export type ThemeRecipe = Record<string, unknown>;
+export type ThemeDefinitionContext<Parent extends ThemeRecipe = ThemeRecipe> = {
+	parent: Parent;
+};
+export type ThemeDefinitionObject = {
+	values?: Record<string, ThemeValue>;
+	children?: ThemeChildren;
+	[key: string]: unknown;
+};
+export type ThemeTreeDefinition<Parent extends ThemeRecipe = ThemeRecipe> = ThemeDefinitionObject | ((context: ThemeDefinitionContext<Parent>) => ThemeDefinitionObject | null);
+export type ThemeChildren = Record<string, ThemeTreeDefinition>;
+export type ThemeTree = {
+	light: ThemeTreeDefinition;
+	dark: ThemeTreeDefinition;
+	children?: ThemeChildren;
+};
+type ColorLiteral = `#${string}` | `rgb${string}` | `hsl${string}` | "transparent";
+type ThemeInputValue<Tokens extends ThemeTokens> = Extract<keyof Tokens["color"], string> | ColorLiteral;
+type ResolvedDefinition<Definition> = Definition extends (...args: any[]) => infer Result ? Exclude<Result, null> : Definition;
+type DefinitionChildren<Definition> = ResolvedDefinition<Definition> extends {
+	children?: infer Children;
+} ? Children : never;
+type ChildThemeNames<
+	Parent extends string,
+	Children
+> = Children extends Record<string, unknown> ? { [Name in Extract<keyof Children, string>] : `${Parent}_${Name}` | ChildThemeNames<`${Parent}_${Name}`, DefinitionChildren<Children[Name]>> }[Extract<keyof Children, string>] : never;
+export type ThemeNames<Tree extends ThemeTree> = "light" | "dark" | ChildThemeNames<"light", Tree["children"]> | ChildThemeNames<"dark", Tree["children"]> | ChildThemeNames<"light", DefinitionChildren<Tree["light"]>> | ChildThemeNames<"dark", DefinitionChildren<Tree["dark"]>>;
+type RecipeFields<Definition> = Omit<ResolvedDefinition<Definition>, "children" | "values">;
+type ChildDefinitions<
+	Children,
+	Depth extends readonly unknown[]
+> = Depth extends readonly [unknown, ...infer Rest] ? Children extends Record<string, unknown> ? Children[keyof Children] | DefinitionsWithin<Children[keyof Children], Rest> : never : never;
+type DefinitionsWithin<
+	Definition,
+	Depth extends readonly unknown[]
+> = Definition | ChildDefinitions<DefinitionChildren<Definition>, Depth>;
+type DefinitionsInTree<Tree extends ThemeTree> = DefinitionsWithin<Tree["light"], [1, 1, 1, 1, 1, 1]> | DefinitionsWithin<Tree["dark"], [1, 1, 1, 1, 1, 1]> | ChildDefinitions<Tree["children"], [1, 1, 1, 1, 1, 1]>;
+type KeysOfUnion<Union> = Union extends Union ? keyof Union : never;
+type ValueOfUnion<
+	Union,
+	Key extends PropertyKey
+> = Union extends Union ? Key extends keyof Union ? Union[Key] : never : never;
+type MergeRecipeUnion<Union> = { [Key in KeysOfUnion<Union>] : ValueOfUnion<Union, Key> };
+type RootRecipe<Tree extends ThemeTree> = RecipeFields<Tree["light"]> | RecipeFields<Tree["dark"]>;
+type RecipeForTree<Tree extends ThemeTree> = { [Key in keyof RootRecipe<Tree>] : ValueOfUnion<RootRecipe<Tree>, Key> } & Partial<MergeRecipeUnion<RecipeFields<DefinitionsInTree<Tree>>>>;
+export type GetThemeContext<
+	Tokens extends ThemeTokens = ThemeTokens,
+	Recipe extends ThemeRecipe = ThemeRecipe
+> = {
+	recipe: Recipe;
+	name: string;
+	tokens: Tokens;
+};
+type InvalidValueKeys<
+	Values,
+	Theme
+> = Exclude<keyof Values, keyof Theme>;
+type ValidatedValues<
+	Values,
+	Theme,
+	Tokens extends ThemeTokens
+> = Values extends Record<string, unknown> ? Values & { [Key in InvalidValueKeys<Values, Theme>] : never } & { [Key in keyof Values] : Values[Key] extends ThemeInputValue<Tokens> ? Values[Key] : never } : never;
+type ValidatedChildren<
+	Children,
+	Theme,
+	Tokens extends ThemeTokens
+> = Children extends Record<string, unknown> ? { [Name in keyof Children] : ValidatedDefinition<Children[Name], Theme, Tokens> } : never;
+type ValidatedDefinition<
+	Definition,
+	Theme,
+	Tokens extends ThemeTokens
+> = Definition extends (...args: infer Args) => infer Result ? (...args: Args) => Result extends null ? null : ValidatedDefinitionObject<Result, Theme, Tokens> : ValidatedDefinitionObject<Definition, Theme, Tokens>;
+type ValidatedDefinitionObject<
+	Definition,
+	Theme,
+	Tokens extends ThemeTokens
+> = Definition extends Record<string, unknown> ? Definition & ("values" extends keyof Definition ? {
+	values: ValidatedValues<Definition["values"], Theme, Tokens>;
+} : unknown) & ("children" extends keyof Definition ? {
+	children: ValidatedChildren<Definition["children"], Theme, Tokens>;
+} : unknown) : never;
+type ValidatedTree<
+	Tree extends ThemeTree,
+	Theme,
+	Tokens extends ThemeTokens
+> = Tree & {
+	light: ValidatedDefinition<Tree["light"], Theme, Tokens>;
+	dark: ValidatedDefinition<Tree["dark"], Theme, Tokens>;
+	children?: ValidatedChildren<Tree["children"], Theme, Tokens>;
+};
+type ValuesInDefinition<Definition> = ResolvedDefinition<Definition> extends {
+	values?: infer Values;
+} ? Values : never;
+type ValueDefinitionsWithin<
+	Definition,
+	Depth extends readonly unknown[]
+> = ValuesInDefinition<Definition> | (Depth extends readonly [unknown, ...infer Rest] ? DefinitionChildren<Definition> extends infer Children ? Children extends Record<string, unknown> ? ValueDefinitionsWithin<Children[keyof Children], Rest> : never : never : never);
+type ExplicitTheme<Tree extends ThemeTree> = MergeRecipeUnion<ValueDefinitionsWithin<Tree["light"], [1, 1, 1, 1, 1, 1]> | ValueDefinitionsWithin<Tree["dark"], [1, 1, 1, 1, 1, 1]> | (Tree["children"] extends infer Children ? Children extends Record<string, unknown> ? ValueDefinitionsWithin<Children[keyof Children], [1, 1, 1, 1, 1, 1]> : never : never)>;
+export type CreatedThemes<
+	Names extends string,
+	Theme extends Record<string, string>
+> = { [Name in Names] : { [Key in keyof Theme] : string } };
+export declare function createThemes<
+	const Tokens extends ThemeTokens,
+	const Tree extends ThemeTree,
+	const Theme extends Record<string, ThemeInputValue<Tokens>>
+>(tokens: Tokens, tree: ValidatedTree<Tree, Theme, Tokens>, options: {
+	getTheme: (context: GetThemeContext<Tokens, RecipeForTree<Tree>>) => Theme;
+}): CreatedThemes<ThemeNames<Tree>, Theme>;
+export declare function createThemes<
+	const Tokens extends ThemeTokens,
+	const Tree extends ThemeTree
+>(tokens: Tokens, tree: ValidatedTree<Tree, Record<string, string>, Tokens>, options?: {
+	getTheme?: undefined;
+}): CreatedThemes<ThemeNames<Tree>, ExplicitTheme<Tree>>;
+export {};
+
+//# sourceMappingURL=createThemes.d.ts.map