@css19/css v0.1.2

@css19/css

Intall

npm install @css19/css

NOTE! Requires React 19

Configure

tsconfig.json

{
  "compilerOptions": {
    "jsxImportSource": "@css19/css"
  }
}

Usage

CSS Prop

The CSS object follows the nested CSS spec. That means any attributes, pseudos etc. needs to use the & to add it to the actual element consuming the style definition.

function App() {
  return (
    <div>
      <h1
        css={{
          color: "red",
          "&:hover": {
            color: "blue",
          },
        }}
      >
        Hello World
      </h1>
    </div>
  );
}

Any element now has a typed css property where you can use any kind of CSS selector.

Css

You can define style definitions outside components using the css function. This provides typing and you can use the object as an override reference.

import { css } from "@css19/css";

const headerCss = css({
  color: "tomato",
});

function App() {
  return (
    <div
      css={{
        // TypeScript currently does not infer the coercion that happens here. Use
        // toString(), [`${headerCss}`] or [String(headerCss)] to make TypeScript happy
        [headerCss]: {
          fontSize: "48px",
          color: "royalblue",
        },
      }}
    >
      <h1 css={headerCss}>Hello World</h1>
    </div>
  );
}

Global CSS

You can also define global css using globalCss, which returns a style element you need to mount.

import { globalCss } from "@css19/css";

const globalStyle = globalCss({
  "@keyframes fade": {
    from: { color: "red" },
    to: { color: "blue" },
  },
});

function App() {
  return (
    <>
      {globalStyle}
      <div>
        <h1>Hello World</h1>
      </div>
   <>
  )
}

Scoped CSS

You can also define scoped css using scopedCss which gives you the className and related style tag. This is useful when you need to use 3rd party components that does not expose usage of the css prop.

import { scopedCss } from "@css19/css";

const [className, style] = scopedCss({
  color: 'red'
});

function App() {
  return (
    <>
      {style}
      <SomeExternalComponent className={className} />
   <>
  )
}

Variables

When working with CSS it can be good to create some constraints. You can mount variables that you can consume in your components to follow these constraints. If you are looking into multiple themes and/or dealing with light and dark color schemes, check out @css19/themes.

import { createVariables } from "@css19/css";

const [variables, style] = createVariables({
  colors: {
    primary: 'red'
  }
});

function App() {
  return (
    <>
      {style}
      <h1 css={{
        color: variables.colors.primary
      }}>Hello World</h1>
   <>
  )
}

How it works

When the css prop is active on an element @css19/css will create a hash from the object. Order of keys does not matter, if the objects represents the same styling, the hash is the same. By using the new style tag and hoisting feature of React 19, your CSS is will "just work" both client and server side.

Each element gets only a single CSS classname that references the styling generated related to the element. React 19 automatically de-duplicates styles. This ensures no presedence issues and styling for each element will be co located.