[zero] Add README with installation and basic usage

[brijeshb42]

• I have followed (at least) the PR section of the contributing guide.

[mui-bot]

Netlify deploy preview

https://deploy-preview-40761--material-ui.netlify.app/

Bundle size report

No bundle size changes (Toolpad)
No bundle size changes

Generated by 🚫 dangerJS against c2ce6bd

[mapache-salvaje]

Very exciting stuff!

[mapache-salvaje]

Suggested change

	A zero-runtime CSS-in-JS library that extracts the colocated css to it's own css files at build-time.
	A zero-runtime CSS-in-JS library that extracts colocated CSS to separate CSS files at build time.

[brijeshb42]

Does this sound like that each css definition will have its own css file?

[mapache-salvaje]

It wasn't very clear to me exactly what was intended by the original sentence. Is there another way to phrase this? Maybe it requires more details?

[brijeshb42]

Basically, it depends on the route. So for ex, for next.js, each route might have its own css file. So all styled calls' CSS will be part of that route's css file.
Maybe just - that extracts the colocated CSS to the output CSS files

[siriwatknp]

What if we don't mention @mui/material/styles and use a plain theme object?

Suggested change

	const { experimental_extendTheme: extendTheme } = require('@mui/material/styles');
	const theme = extendTheme();
	const theme = {
	colorSchemes: {
	light: {
	palette: {
	brand: '...',
	}
	},
	dark: {
	palette: {
	brand: '...',
	}
	}
	}
	}

[brijeshb42]

We right now depend on the extendTheme implementation to then call generateCssVars in the zero-runtime util's generateCss. If we have to support plain objects, we can either implement the same in zero-runtime directly or we can move the theme implementation to @mui/theming package that will only have all theme specific logic.

[siriwatknp]

Got it. I think we need to revisit the theming for zero-runtime. In my opinion, zero-runtime should work without theme config.

If developer tries to use theme, we throw the error/warning and show them where to add the theme.

Next, the theme object can be a plain object that they can control. Meaning, if I provide:

const theme = {
  typography: {
    h1: { … }, …
  }
}

I should be able to use it from the theme callback

Then the CSS variables, we should consider as an opt-in feature. Meaning, developers have to follow our structure and pass in generateCssVars to the theme.

I can take care of this task if you agree with the above model.

[brijeshb42]

Ideally, yes. It should work even with plain js objects. This was the case actually previously before we agreed on relying on making extendTheme the default. We can still provide css variable token object even if they are not using extendTheme. It would be possible if we extract out the css vars related utilities to either @mui/system or independent package.

[siriwatknp]

👍