@pitlane/theme 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @pitlane/theme
 
+## 0.4.0
+
+Target Remix `3.0.0-rc.1`.
+
+- Raised the `remix` peer dependency to `^3.0.0-rc.1` (from
+  `^3.0.0-beta.10`). No API changes — `createTheme`, `extend`, `select`,
+  `<Theme />`, and the `css`/`tva`/`combine`/`cx` helpers are unchanged, and
+  the package still has no runtime dependency on Remix beyond
+  `createElement` from `remix/ui`.
+- One rc.1 change is worth knowing about when reading generated markup: the
+  marker on server-rendered style elements is now `data-rmx-style`, where
+  beta.10 emitted a bare `data-rmx`. A stylesheet or test that selected
+  `[data-rmx]` needs the new attribute. The class hashes this package emits
+  (`rmxc-…`) and the `@layer rmx` / `@layer rmx-reset` cascade layers are
+  unaffected.
+- Tested against `remix@3.0.0-rc.1`.
+
+## 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/README.md

@@ -10,7 +10,7 @@ npm install @pitlane/theme
 vp add @pitlane/theme
 ```
 
-Requires `remix@^3.0.0-beta.10` as a peer.
+Requires `remix@^3.0.0-rc.1` as a peer.
 
 ## Quick start
 
@@ -120,6 +120,7 @@ A layer's declarations follow the ones they reference, which moves them later in
 - `lightDark(light, dark)` returns CSS `light-dark()` text. `scale(token)` returns a multiplier for an ordinary dimension, duration, or number token.
 - `ThemeError` reports structural failures: a reference whose type does not match its position, a reference to an untyped token, a variable collision, an undeclared token, a mode overriding an unknown token, and a `"{a.b.c}"` string left over from the pre-0.3.0 format. Invalid values raise `ValidationError` from `remix/data-schema`, whose `issues` array contains the detail.
 - `@pitlane/theme/schema` exports `s.color()`, `s.dimension()`, `s.duration()`, `s.number()`, `s.easing()`, `s.shadow()`, `s.border()`, `s.transition()`, `s.gradient()`, `s.stroke()`, `s.font.family()`, `s.font.weight()`, `s.scale()`, `s.any()`, and `s.group()`.
+- `@pitlane/theme/dtcg` is the DTCG interchange: `fromDTCG(document)` reads a W3C DTCG document into a `createTheme` init, and `toDTCG(theme)` exports a theme as a document plus per-mode overrides.
 - Types include `ThemeInit`, `ThemeMode`, `ThemeResult`, `ThemeComponent`, `ThemeProps`, `TokenTree`, `ScaleFn`, `Tokens`, `TokenValue`, `ThemedCSSProps`, `ThemedCSSMixin`, TVA types, and per-type token brands.
 
 ## Links

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,7 +1,7 @@
 {
   "name": "@pitlane/theme",
-  "version": "0.3.0",
-  "description": "Type-safe styling with W3C design tokens for Remix 3.",
+  "version": "0.4.0",
+  "description": "Type-safe styling with design tokens for Remix 3: a schema tree plus the CSS values it describes compile to a typed token accessor and a <Theme /> component.",
   "keywords": [
     "css-variables",
     "design-tokens",
@@ -49,12 +49,12 @@
     "csstype": "^3.2.3"
   },
   "devDependencies": {
-    "remix": "3.0.0-beta.10",
+    "remix": "3.0.0-rc.1",
     "typescript": "^7.0.2",
     "vite-plus": "^0.2.6"
   },
   "peerDependencies": {
-    "remix": "^3.0.0-beta.10"
+    "remix": "^3.0.0-rc.1"
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"