@plumeria/core 18.5.3 → 19.0.0

package/lib/class-style.d.ts

@@ -1,6 +1,6 @@
 import type { Style } from '#types';
 
-global {
+declare global {
   namespace React {
     interface HTMLAttributes<T> {
       classStyle?: Style;

package/lib/css.d.ts

@@ -9,13 +9,16 @@
  * type viewTransition = <const T extends ViewTransition>(rule: T) => string;
  * type marker = (id: string, pseudo: string) => Marker;
  * type extended = <I extends string, P extends string>(id: I, pseudo: P) => Extended<I, P>;
- * type use = (...rules: Style) => string;
+ * type use = (...rules: Style[]) => string;
  * ```
  */
 declare module '@plumeria/core' {
   import type {
     AtomicClassNameFor,
     Style,
+    StyleProps,
+    StaticStyles,
+    WithoutProperties,
     CSSProperties,
     CreateStyleValue,
     CreateReturnType,
@@ -29,7 +32,14 @@ declare module '@plumeria/core' {
     Extended,
   } from '#types';
 
-  export type { AtomicClassNameFor, Style, CSSProperties };
+  export type {
+    AtomicClassNameFor,
+    Style,
+    StyleProps,
+    StaticStyles,
+    WithoutProperties,
+    CSSProperties,
+  };
 
   export const create: create;
   export type create = <const T extends Record<string, CreateStyleValue>>(
@@ -63,5 +73,5 @@ declare module '@plumeria/core' {
   ) => Extended<I, P>;
 
   export const use: use;
-  export type use = (...rules: Style) => string;
+  export type use = (...rules: Style[]) => string;
 }

package/lib/types.d.ts

@@ -31,6 +31,9 @@ type AtRule =
   | `@layer ${string}`
   | `@scope ${string}`;
 
+type StyleKey = keyof CSSTypes;
+type NestedKey = ColonString | ArrayString | AtRule;
+
 type AtRuleSelector = {
   [K in AtRule]:
     | CommonProperties
@@ -56,10 +59,9 @@ type AtomicClassNameFor<P extends string, V> = string & {
   readonly _value: V;
 };
 
-type AtString = `@${string}`;
 type MapNamespace<T> = Readonly<{
   [key in keyof T]: T[key] extends Record<string, unknown>
-    ? key extends ColonString | ArrayString | AtString
+    ? key extends NestedKey
       ? MapNamespace<T[key]>
       : AtomicClassNameFor<key & string, T[key]>
     : key extends string
@@ -67,13 +69,46 @@ type MapNamespace<T> = Readonly<{
       : never;
 }>;
 
+declare const DynamicTag: unique symbol;
+
+type DynamicNamespace<T> = MapNamespace<T> & {
+  readonly [DynamicTag]: true;
+};
+
 type CreateReturnType<T> = Readonly<{
   [K in keyof T]: T[K] extends (...args: infer A) => infer R
-    ? (...args: A) => MapNamespace<R>
+    ? (...args: A) => DynamicNamespace<R>
     : MapNamespace<T[K]>;
 }>;
-type Conditional = false | CSSProperties | null | undefined;
-type Style = Conditional | Style[];
+type FlatNamespace<K extends StyleKey> = {
+  readonly [P in StyleKey]?: P extends K
+    ? AtomicClassNameFor<P & string, unknown>
+    : never;
+};
+
+interface NestedNamespace<K extends StyleKey> {
+  readonly [P: NestedKey]: AllowedNamespace<K> | undefined;
+}
+
+type AllowedNamespace<K extends StyleKey> = FlatNamespace<K> &
+  NestedNamespace<K>;
+
+type StyleList<T> = T | false | null | undefined | StyleList<T>[];
+
+type StyleNamespace = AllowedNamespace<StyleKey>;
+type Style = StyleList<StyleNamespace>;
+
+type StyleProps<K extends StyleKey> = StyleList<AllowedNamespace<K>>;
+
+type WithoutProperties<K extends StyleKey> = StyleProps<Exclude<StyleKey, K>>;
+
+type StaticNamespace<K extends StyleKey> = AllowedNamespace<K> & {
+  readonly [DynamicTag]?: never;
+};
+
+type StaticStyles<K extends StyleKey = StyleKey> = StyleList<
+  StaticNamespace<K>
+>;
 
 type CreateStatic = Record<string, string | number>;
 
@@ -99,8 +134,6 @@ type ViewTransition = {
   old?: CSSProperties;
 };
 
-type Marker = Record<string, CSSProperties>;
-
 type StripColon<T extends string> = T extends `:${infer R}` ? StripColon<R> : T;
 
 type Extended<
@@ -108,9 +141,14 @@ type Extended<
   P extends string,
 > = `@container style(--${I}-${StripColon<P>}: 1)`;
 
+type Marker = Record<Extended<string, string>, CSSProperties>;
+
 export type {
   AtomicClassNameFor,
   Style,
+  StyleProps,
+  StaticStyles,
+  WithoutProperties,
   CSSProperties,
   CreateStyleValue,
   CreateReturnType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumeria/core",
-  "version": "18.5.3",
+  "version": "19.0.0",
   "description": "Zero-cost abstraction layer for styling React components.",
   "author": "Refirst 11",
   "license": "MIT",