clava 0.1.19 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # clava
 
+## 0.2.1
+
+### Improved runtime performance of `cv` and `splitProps`
+
+Variant tables, disabled-variant sets, and extended-component metadata are now pre-built once when [`cv`](https://clava.style/docs/reference/cv) is called, so prop resolution no longer walks `Object.entries` and variant-related styles are pre-normalized at creation time instead of on each render. [`splitProps`](https://clava.style/docs/reference/split-props) reuses component key arrays directly instead of copying them per call.
+
+Per-render benchmarks improve roughly 2× to 7×, with no public API or behavior changes; component-creation cost is unchanged.
+
+## 0.2.0
+
+### Minor Changes
+
+- 2d99317: Removed the `defaultMode` option from `create()` and changed the default callable Clava component result to return normalized `{ class, style }` props.
+
+  Calling a component directly now always returns Clava's definition-compatible shape, with camelCase style keys. Use `.jsx`, `.html`, or `.htmlObj` when a framework- or renderer-specific prop shape is needed.
+
+  Before:
+
+  ```ts
+  const { cv } = create({ defaultMode: "htmlObj" });
+  const button = cv({ style: { fontSize: "16px" } });
+
+  button();
+  // { class: "", style: { "font-size": "16px" } }
+  ```
+
+  After:
+
+  ```ts
+  const { cv } = create();
+  const button = cv({ style: { fontSize: "16px" } });
+
+  button();
+  // { class: "", style: { fontSize: "16px" } }
+
+  button.htmlObj();
+  // { class: "", style: { "font-size": "16px" } }
+  ```
+
 ## 0.1.19
 
 ### Patch Changes

package/dist/index.d.ts

@@ -18,12 +18,11 @@ interface HTMLObjProps {
   class: string;
   style: HTMLCSSProperties;
 }
-interface StyleProps {
-  jsx: JSXProps;
-  html: HTMLProps;
-  htmlObj: HTMLObjProps;
+interface StyleClassProps {
+  class: string;
+  style: StyleValue;
 }
-type ComponentResult = JSXProps | HTMLProps | HTMLObjProps;
+type ComponentResult = JSXProps | HTMLProps | HTMLObjProps | StyleClassProps;
 type AllComponentResultKeys = keyof JSXProps | keyof HTMLProps | keyof HTMLObjProps;
 type ComponentResultValue<K extends AllComponentResultKeys> = K extends "style" ? StyleProperty : K extends "className" ? string : K extends "class" ? string : never;
 type NullableComponentResult = { [K in AllComponentResultKeys]?: ComponentResultValue<K> | null };
@@ -58,11 +57,11 @@ interface ModalComponent<V, R extends ComponentResult> {
   class: (props?: ComponentProps<V>) => string;
   style: (props?: ComponentProps<V>) => R["style"];
   getVariants: GetVariants<V>;
-  keys: (keyof V | keyof R)[];
+  keys: (keyof V | keyof NullableComponentResult)[];
   variantKeys: (keyof V)[];
-  propKeys: (keyof V | keyof R)[];
+  propKeys: (keyof V | keyof NullableComponentResult)[];
 }
-interface CVComponent<V extends Variants = {}, CV extends ComputedVariants = {}, E extends AnyComponent[] = [], R extends ComponentResult = ComponentResult> extends ModalComponent<MergeVariants<V, CV, E>, R> {
+interface CVComponent<V extends Variants = {}, CV extends ComputedVariants = {}, E extends AnyComponent[] = [], R extends ComponentResult = StyleClassProps> extends ModalComponent<MergeVariants<V, CV, E>, R> {
   jsx: ModalComponent<MergeVariants<V, CV, E>, JSXProps>;
   html: ModalComponent<MergeVariants<V, CV, E>, HTMLProps>;
   htmlObj: ModalComponent<MergeVariants<V, CV, E>, HTMLObjProps>;
@@ -105,10 +104,6 @@ type ExtendedVariants<E extends AnyComponent[]> = MergeExtendedVariants<E> & Mer
 type NullablePartial<T> = T extends Record<string, any> ? { [K in keyof T]?: T[K] | null } : T | null;
 type ExtendableVariants<V extends Variants, E extends AnyComponent[]> = V & { [K in keyof ExtendedVariants<E>]?: NullablePartial<ExtendedVariants<E>[K]> | Variant$1 };
 //#endregion
-//#region src/utils.d.ts
-declare const MODES: readonly ["jsx", "html", "htmlObj"];
-type Mode = (typeof MODES)[number];
-//#endregion
 //#region src/index.d.ts
 type VariantProps<T extends Pick<AnyComponent, "getVariants">> = ReturnType<T["getVariants"]>;
 type VariantKey<T> = T extends boolean ? "true" | "false" : Extract<T, string>;
@@ -122,8 +117,7 @@ interface CVConfig<V extends Variants = {}, CV extends ComputedVariants = {}, E
   defaultVariants?: VariantValues<MergeVariants<V, CV, E>>;
   computed?: Computed<MergeVariants<V, CV, E>>;
 }
-interface CreateParams<M extends Mode> {
-  defaultMode?: M;
+interface CreateParams {
   transformClass?: (className: string) => string;
 }
 /**
@@ -133,29 +127,18 @@ interface CreateParams<M extends Mode> {
  * only receive variant props. Arrays receive their listed keys but don't claim
  * styling props. The last element is always the "rest" containing keys not
  * claimed by any source.
- * @example
- * ```ts
- * const [buttonProps, inputProps, rest] = splitProps(
- *   props,
- *   buttonComponent,
- *   inputComponent,
- * );
- * // buttonProps has class/style + button variants
- * // inputProps has only input variants (no class/style)
- * ```
  */
 declare const splitProps: SplitPropsFunction;
 /**
  * Creates the cv and cx functions.
  */
-declare function create<M extends Mode = "jsx">({
-  defaultMode,
+declare function create({
   transformClass
-}?: CreateParams<M>): {
-  cv: <V extends Variants = {}, CV extends ComputedVariants = {}, const E extends AnyComponent[] = []>(config?: CVConfig<V, CV, E>) => CVComponent<V, CV, E, StyleProps[M]>;
+}?: CreateParams): {
+  cv: <V extends Variants = {}, CV extends ComputedVariants = {}, const E extends AnyComponent[] = []>(config?: CVConfig<V, CV, E>) => CVComponent<V, CV, E>;
   cx: (...classes: ClassValue$1[]) => string;
 };
-declare const cv: <V extends Variants = {}, CV extends ComputedVariants = {}, const E extends AnyComponent[] = []>(config?: CVConfig<V, CV, E>) => CVComponent<V, CV, E, JSXProps>, cx: (...classes: ClassValue$1[]) => string;
+declare const cv: <V extends Variants = {}, CV extends ComputedVariants = {}, const E extends AnyComponent[] = []>(config?: CVConfig<V, CV, E>) => CVComponent<V, CV, E>, cx: (...classes: ClassValue$1[]) => string;
 //#endregion
-export { type CVComponent, CVConfig, type ClassValue, type HTMLObjProps, type HTMLProps, type JSXProps, type StyleClassValue, type StyleValue, Variant, VariantProps, create, cv, cx, splitProps };
+export { type CVComponent, CVConfig, type ClassValue, type HTMLObjProps, type HTMLProps, type JSXProps, type StyleClassProps, type StyleClassValue, type StyleValue, Variant, VariantProps, create, cv, cx, splitProps };
 //# sourceMappingURL=index.d.ts.map