@vitus-labs/core 2.0.0 → 2.2.0

package/lib/index.d.ts

@@ -135,6 +135,22 @@ type HTMLTextTags = (typeof HTML_TEXT_TAGS)[number];
 type HTMLTagAttrsByTag<T extends HTMLTags> = T extends HTMLTags ? HTMLElementAttrs[T] : {};
 //#endregion
 //#region src/config.d.ts
+/**
+ * Augmentable interface representing the result of the engine's `css`
+ * tagged template. Empty by default — each connector package narrows it
+ * via module declaration merging:
+ *
+ * ```ts
+ * // @vitus-labs/connector-styler
+ * declare module '@vitus-labs/core' {
+ *   interface CSSEngineResult extends StylerCSSResult {}
+ * }
+ * ```
+ *
+ * Consumers' types automatically resolve to the engine they `init()`'d with,
+ * without core depending on any specific engine package.
+ */
+interface CSSEngineResult {}
 /**
  * Describes the shape of a CSS-in-JS engine connector.
  * Packages like `@vitus-labs/connector-styler`, `@vitus-labs/connector-emotion`,
@@ -146,7 +162,7 @@ type HTMLTagAttrsByTag<T extends HTMLTags> = T extends HTMLTags ? HTMLElementAtt
  */
 interface CSSEngineConnector {
   /** Tagged template for composable CSS fragments. */
-  css: (strings: TemplateStringsArray, ...values: any[]) => any;
+  css: (strings: TemplateStringsArray, ...values: any[]) => CSSEngineResult;
   /** Component factory: `styled(tag)`\`...\`` → React component. */
   styled: ((tag: any, options?: any) => (strings: TemplateStringsArray, ...values: any[]) => any) & Record<string, any>;
   /** ThemeProvider component wrapping children with a theme context. */
@@ -199,7 +215,7 @@ declare class Configuration {
    * When not (module load time before init), returns a thunk that resolves
    * at render time — all CSS-in-JS engines treat functions as interpolations.
    */
-  css: (strings: TemplateStringsArray, ...values: any[]) => any;
+  css: (strings: TemplateStringsArray, ...values: any[]) => CSSEngineResult;
   /**
    * Stable styled delegate (Proxy). Supports `styled(tag)` and `styled.div`.
    * When the engine is not yet available, returns a lazy component
@@ -318,5 +334,5 @@ declare const throttle: <T extends (...args: any[]) => any>(fn: T, wait?: number
 };
 declare const merge: <T extends Record<string, any>>(target: T, ...sources: Record<string, any>[]) => T;
 //#endregion
-export { type BreakpointKeys, type Breakpoints, type CSSEngineConnector, type HTMLElementAttrs, type HTMLTagAttrsByTag, type HTMLTags, type HTMLTextTags, HTML_TAGS, HTML_TEXT_TAGS, type IsEmpty, Provider, type Render, compose, config, context, get, hoistNonReactStatics, init, isEmpty, isEqual, merge, omit, pick, render, set, throttle, useStableValue };
+export { type BreakpointKeys, type Breakpoints, type CSSEngineConnector, type CSSEngineResult, type HTMLElementAttrs, type HTMLTagAttrsByTag, type HTMLTags, type HTMLTextTags, HTML_TAGS, HTML_TEXT_TAGS, type IsEmpty, Provider, type Render, compose, config, context, get, hoistNonReactStatics, init, isEmpty, isEqual, merge, omit, pick, render, set, throttle, useStableValue };
 //# sourceMappingURL=index2.d.ts.map

package/lib/index.js

@@ -75,11 +75,11 @@ var Configuration = class {
 	*/
 	css = (strings, ...values) => {
 		if (this._css) return this._css(strings, ...values);
-		return () => {
+		return (() => {
 			const engine = this._css;
 			if (!engine) return notConfigured("css");
 			return engine(strings, ...values);
-		};
+		});
 	};
 	/**
 	* Stable styled delegate (Proxy). Supports `styled(tag)` and `styled.div`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitus-labs/core",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "license": "MIT",
   "author": "Vit Bokisch <vit@bokisch.cz>",
   "maintainers": [
@@ -59,7 +59,7 @@
     "react-is": "^19.2.4"
   },
   "devDependencies": {
-    "@vitus-labs/tools-rolldown": "2.2.0",
-    "@vitus-labs/tools-typescript": "2.1.0"
+    "@vitus-labs/tools-rolldown": "2.3.0",
+    "@vitus-labs/tools-typescript": "2.3.0"
   }
 }