@hypergood/css-core 0.1.0 → 0.1.1

package/src/css-properties.ts

@@ -1,43 +1,18 @@
 import type * as CSS from "csstype";
 
-/**
- * A value allowed inside a {@link CSSProperties} object: a string, a number, an
- * array of strings/numbers (e.g. for fallback values), or a nested
- * {@link CSSProperties} object (e.g. for selectors, media queries, or
- * at-rules).
- */
-export type CSSValue =
-  | string
-  | number
-  | Array<string | number>
-  | CSSProperties;
+export type CSSValue = string | number | Array<string | number> | CSSProperties;
 
-/**
- * The value type for a *known* CSS property.
- *
- * We deliberately do NOT union in a bare `string` here: csstype's own property
- * types already permit any string via the `(string & {})` trick, which keeps
- * the literal value suggestions (e.g. `"center"` for `alignItems`) visible in
- * IntelliSense. Adding a bare `string` would collapse that union and suppress
- * the autocomplete. We still allow numbers, fallback arrays, and nested objects.
- */
 type KnownCSSValue<K extends keyof CSS.Properties> =
   | CSS.Properties[K]
   | number
   | Array<string | number>
   | CSSProperties;
 
-/**
- * The shape of the style objects passed to `css()`, `variants()`, and
- * `styled()`.
- *
- * Known camelCase CSS properties (sourced from `csstype`) offer autocomplete
- * for both the property name and its value, but any other key is accepted
- * without a type error so that selectors, media queries, custom properties, and
- * other arbitrary keys can be used freely.
- */
 export type CSSProperties = {
   [K in keyof CSS.Properties]?: KnownCSSValue<K>;
 } & {
   [key: string]: CSSValue;
 };
+
+export type CSSPropItem = string | boolean | CSSProperties | null | undefined;
+export type CSSProp = CSSPropItem | CSSPropItem[];

package/src/runtime.ts

@@ -1,6 +1,11 @@
 import type { CSSProperties } from "./css-properties.js";
 
-export type { CSSProperties, CSSValue } from "./css-properties.js";
+export type {
+  CSSProp,
+  CSSProperties,
+  CSSPropItem,
+  CSSValue,
+} from "./css-properties.js";
 
 /**
  * The style object accepted by `styled()`: top-level CSS properties plus the