nuclo 0.3.20 → 0.3.22

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "nuclo",
 	"private": false,
-	"version": "0.3.20",
+	"version": "0.3.22",
 	"description": "Lightweight, type-safe DOM library with plain mutable state and explicit updates — global tag builders, SSR, hydration, and typed CSS, no virtual DOM, no compiler.",
 	"license": "MIT",
 	"author": "Danilo Celestino de Castro (https://github.com/dan2dev)",

package/types/features/style.d.ts

@@ -60,10 +60,14 @@ declare global {
 	 */
 	function createCss<const T extends ThemeConfig>(theme?: T): CssInstance<T>;
 
-	/** Themeless css() — full property/variant typing, no tokens or screens. */
-	function css(style: Style<object>): StyleResult;
 	/** Themeless css() under a readable, stable class name: `css("app-root", { … })` → `.app-root`. */
 	function css(name: string, style: Style<object>): StyleResult;
+	/**
+	 * Themeless css() — full property/variant typing, no tokens or screens.
+	 * Declared last so `Parameters<typeof css>[0]` is the style object:
+	 * `Parameters` resolves against the final overload.
+	 */
+	function css(style: Style<object>): StyleResult;
 	/** Compose class lists with last-wins conflict resolution. */
 	function cx(...inputs: ClassInput[]): StyleResult;
 	/** Themeless variants() recipe helper. */

package/types/index.d.ts

@@ -73,8 +73,10 @@ export function on<K extends string, E extends Event = Event, TTagName extends E
 
 // Styling (themeless default instance + themed factory)
 export function createCss<const T extends ThemeConfig>(theme?: T): CssInstance<T>;
-export function css(style: Style<object>): StyleResult;
+// The single-argument form is declared last so `Parameters<typeof css>[0]` is
+// the style object: `Parameters` resolves against the final overload.
 export function css(name: string, style: Style<object>): StyleResult;
+export function css(style: Style<object>): StyleResult;
 export function cx(...inputs: ClassInput[]): StyleResult;
 export function variants<const V extends VariantDefinitions<object>>(
   config: VariantsConfig<object, V>,

package/types/style.d.ts

@@ -378,12 +378,6 @@ export type ClassInput = StyleResult | string | false | null | undefined | reado
 
 /** A themed styling instance returned by createCss(). */
 export interface CssInstance<T extends ThemeConfig = ThemeConfig> {
-	/**
-	 * Compile a style object into CSS classes — one per selector context
-	 * (base, each pseudo-selector, each media query) it touches.
-	 * Returns `{ className }` — usable directly as a nuclo attributes object.
-	 */
-	css(style: Style<T>): StyleResult;
 	/**
 	 * Compile a style object under a readable, stable class name:
 	 * `css("app-root", { minHeight: "100vh" })` → `.app-root`.
@@ -392,6 +386,16 @@ export interface CssInstance<T extends ThemeConfig = ThemeConfig> {
 	 * as well as content, so they never share a class with an unrelated style.
 	 */
 	css(name: string, style: Style<T>): StyleResult;
+	/**
+	 * Compile a style object into CSS classes — one per selector context
+	 * (base, each pseudo-selector, each media query) it touches.
+	 * Returns `{ className }` — usable directly as a nuclo attributes object.
+	 *
+	 * Declared after the named form so `Parameters<typeof css>[0]` is the style
+	 * object — `Parameters` resolves against the last overload, which makes the
+	 * declaration order part of the public API.
+	 */
+	css(style: Style<T>): StyleResult;
 	/**
 	 * Compose class lists with exact conflict resolution: when two inputs
 	 * style the same (query, selector, property), the last one wins.