@pitlane/theme 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @pitlane/theme
 
+## 0.3.1
+
+- `createTheme`, `extend`, `select`, and a mode all take their token tree under
+  a `tokens` key, and leaving that wrapper off now raises `ThemeError` naming
+  the key. A bare tree used to reach the compiler and fail as
+  `Object.entries(undefined)`, and a mode missing the key reported
+  `override at ""`, which named neither the key nor the mistake.
+
 ## 0.3.0
 
 Authoring moves off W3C DTCG. `createTheme` now takes a schema tree and the

package/dist/default.d.mts

@@ -1,5 +1,5 @@
 import { o as TokenSchema, t as SELF } from "./schema-CRP607Pg.mjs";
-import { t as ThemeComponent } from "./theme-Ck-4suI4.mjs";
+import { t as ThemeComponent } from "./theme-CaHfWYnM.mjs";
 //#region src/default.d.ts
 declare let schema: {
   font: TokenSchema<"fontFamily">;

package/dist/default.mjs

@@ -1,5 +1,5 @@
 import { c as duration, f as group, g as scale, l as easing, m as number, o as color, r as any, s as dimension, u as font, v as shadow } from "./schema-JmfNnMzr.mjs";
-import { t as createTheme } from "./theme-CMaWrQJ5.mjs";
+import { t as createTheme } from "./theme-iDUjQhE0.mjs";
 /**
 * Tailwind CSS v4.3.2's default primitive theme.
 *

package/dist/dtcg.d.mts

@@ -1,5 +1,5 @@
 import { i as SchemaTag } from "./schema-CRP607Pg.mjs";
-import { l as ThemeInit, r as ThemeResult, t as ThemeComponent } from "./theme-Ck-4suI4.mjs";
+import { l as ThemeInit, r as ThemeResult, t as ThemeComponent } from "./theme-CaHfWYnM.mjs";
 //#region src/dtcg.d.ts
 /**
  * A JSON-compatible W3C Design Tokens Community Group document.

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { A as DimensionToken, B as UntypedToken, E as BorderToken, F as NumberToken, I as ShadowToken, L as StrokeStyleToken, M as FontFamilyToken, N as FontWeightToken, O as ColorToken, P as GradientToken, R as TokenType, T as AnyToken, j as DurationToken, k as CubicBezierToken, z as TransitionToken } from "./schema-CRP607Pg.mjs";
-import { a as DeepPartialTokens, c as ScaleFn, d as ThemePatch, f as TokenTree, i as createTheme, l as ThemeInit, m as Tokens, n as ThemeProps, o as Merged, p as TokenValue, r as ThemeResult, s as ScalableToken, t as ThemeComponent, u as ThemeMode } from "./theme-Ck-4suI4.mjs";
+import { a as DeepPartialTokens, c as ScaleFn, d as ThemePatch, f as TokenTree, i as createTheme, l as ThemeInit, m as Tokens, n as ThemeProps, o as Merged, p as TokenValue, r as ThemeResult, s as ScalableToken, t as ThemeComponent, u as ThemeMode } from "./theme-CaHfWYnM.mjs";
 import { ElementProps, MixinDescriptor, css as css$1 } from "remix/ui";
 import * as CSS from "csstype";
 //#region src/props.d.ts

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { S as ThemeError } from "./schema-JmfNnMzr.mjs";
-import { t as createTheme } from "./theme-CMaWrQJ5.mjs";
+import { t as createTheme } from "./theme-iDUjQhE0.mjs";
 import { css as css$1 } from "remix/ui";
 //#region src/css.ts
 /**

package/dist/{theme-Ck-4suI4.d.mts → theme-CaHfWYnM.d.mts}

@@ -192,6 +192,7 @@ interface ThemeResult<T> {
    *
    * @param patch - The tokens and schema to merge, or a callback returning them
    * @returns A new theme
+   * @throws ThemeError when the patch holds no `tokens` group
    */
   extend<const schema extends object, const tokens extends object>(patch: ExtendPatch<T, schema, tokens> | ((base: TokenTree<T>) => ExtendPatch<T, schema, tokens>)): ThemeResult<Merged<T, {
     schema: schema;
@@ -205,6 +206,7 @@ interface ThemeResult<T> {
    *
    * @param projection - A callback returning the schema and tokens to keep
    * @returns A new theme
+   * @throws ThemeError when the projection holds no `tokens` group
    */
   select<const P extends ThemeInit>(projection: (base: TokenTree<T>) => P): ThemeResult<P>;
 }

package/dist/{theme-CMaWrQJ5.mjs → theme-iDUjQhE0.mjs}

@@ -31,7 +31,9 @@ function compose(tokens, schema, inherited) {
 //#region src/theme.ts
 const REF_RE = /^var\((--[a-z0-9-]+)\)$/;
 function createTheme(input) {
-	return compile(typeof input === "function" ? input.$theme : input);
+	let init = typeof input === "function" ? input.$theme : input;
+	assertTokensGroup(init, "createTheme()", "createTheme({ schema: { … }, tokens: { … } })");
+	return compile(init);
 }
 function compile(init) {
 	parse(composeSchema(init.tokens, init.schema), init.tokens, { abortEarly: false });
@@ -50,6 +52,7 @@ function compile(init) {
 		extend(patch) {
 			let accessor = buildAccessor(entries);
 			let next = typeof patch === "function" ? patch(accessor) : patch;
+			assertTokensGroup(next, "extend()", ".extend(base => ({ schema: { … }, tokens: { … } }))");
 			return compile({
 				schema: mergeDeep(init.schema, next.schema ?? {}),
 				tokens: mergeDeep(init.tokens, next.tokens),
@@ -61,6 +64,7 @@ function compile(init) {
 		},
 		select(projection) {
 			let next = projection(buildAccessor(entries));
+			assertTokensGroup(next, "select()", ".select(base => ({ schema: { … }, tokens: { … } }))");
 			let projected = reroot(next.tokens, byVarName);
 			assertNoDroppedReferences(projected, byVarName);
 			return compile({
@@ -87,11 +91,23 @@ function declare(entry, ctx) {
 	if (entry.aliasOf !== void 0) return ctx.varRefFor(entry.aliasOf, entry.key, entry.type);
 	return serializeValue(entry.type, entry.value, ctx, entry.key);
 }
+/**
+* A schema tree, a patch, a projection, and a mode all carry their token tree
+* under a `tokens` key, and leaving the wrapper off is a plausible mistake:
+* 0.2.0 took a bare document, and the wrapper is what the 0.3.0 migration
+* teaches for modes. Without this the bare tree reaches the compiler, where it
+* fails as `Object.entries(undefined)` from inside a bundled chunk.
+*/
+function assertTokensGroup(node, label, example) {
+	if (!isPlainRecord(node) || !("tokens" in node)) throw new ThemeError(`${label} is missing its "tokens" group: ${example}`);
+	if (!isPlainRecord(node.tokens)) throw new ThemeError(`${label} has a "tokens" that is not a group`);
+}
 function modeBlocks(modes, byKey, ctx) {
 	if (modes === void 0) return [];
 	let selectorBlocks = [];
 	let mediaBlocks = [];
 	for (let [name, mode] of Object.entries(modes)) {
+		assertTokensGroup(mode, `Mode "${name}"`, `modes: { ${name}: { tokens: { … } } }`);
 		let overrides = [];
 		walkMode(mode.tokens, [], name, byKey, ctx, overrides);
 		if (overrides.length === 0) continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitlane/theme",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Type-safe styling with W3C design tokens for Remix 3.",
   "keywords": [
     "css-variables",