react-mcu 1.0.0 → 1.0.2

package/README.md

@@ -1,39 +1,58 @@
-# react-mcu
+[![npm version](https://img.shields.io/npm/v/react-mcu.svg)](https://www.npmjs.com/package/react-mcu)
+[![](https://img.shields.io/badge/chromatic-171c23.svg?logo=chromatic)](https://www.chromatic.com/library?appId=695eb517cb602e59b4cc045c&branch=main)
 
-A React component library.
-
-## Installation
-
-```bash
-npm install react-mcu
-```
-
-## Usage
+Usage:
 
 ```tsx
-import { Mcu } from 'react-mcu';
-
-function App() {
-  return <Mcu />;
-}
+import { Mcu } from "react-mcu";
+
+<Mcu
+  source="#0e1216"
+  scheme="vibrant"
+  contrast={0.5}
+  customColors=[]
+>
+  <div style={{
+    backgroundColor: "var(--mcu-surface)",
+    color: "var(--mcu-on-surface)",
+  }}>
+    Hello, MCU colors!
+  </div>
+</Mcu>
 ```
 
-## Components
-
-### Mcu
-
-A simple component that renders "Hello World".
-
-```tsx
-<Mcu />
+# Dev
+
+## INSTALL
+
+Pre-requisites:
+
+- Install [nvm](https://github.com/nvm-sh/nvm), then:
+  ```sh
+  $ nvm install
+  $ nvm use
+  $ node -v # make sure your version satisfies package.json#engines.node
+  ```
+  nb: if you want this node version to be your default nvm's one:
+  `nvm alias default node`
+- Install pnpm, with:
+  ```sh
+  $ corepack enable
+  $ corepack prepare --activate # it reads "packageManager"
+  $ pnpm -v # make sure your version satisfies package.json#engines.pnpm
+  ```
+
+```sh
+$ pnpm i
 ```
 
-## Contributing
+## CONTRIBUTING
 
-When submitting a pull request, please include a changeset to document your changes:
+When submitting a pull request, please include a changeset to document your
+changes:
 
 ```bash
-npx changeset
+pnpm exec changeset
 ```
 
 This helps us maintain the changelog and version the package appropriately.

package/dist/index.d.ts

@@ -1,5 +1,28 @@
-interface McuProps {
-}
-declare const Mcu: React.FC<McuProps>;
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { SchemeTonalSpot, SchemeMonochrome, SchemeNeutral, SchemeVibrant, SchemeExpressive, SchemeFidelity, SchemeContent, CustomColor } from '@material/material-color-utilities';
 
-export { Mcu, type McuProps };
+type HexCustomColor = Omit<CustomColor, "value"> & {
+    hex: string;
+};
+type McuConfig = {
+    source: string;
+    scheme: SchemeName;
+    contrast: number;
+    customColors: HexCustomColor[];
+};
+declare const schemesMap: {
+    readonly tonalSpot: typeof SchemeTonalSpot;
+    readonly monochrome: typeof SchemeMonochrome;
+    readonly neutral: typeof SchemeNeutral;
+    readonly vibrant: typeof SchemeVibrant;
+    readonly expressive: typeof SchemeExpressive;
+    readonly fidelity: typeof SchemeFidelity;
+    readonly content: typeof SchemeContent;
+};
+declare const schemeNames: (keyof typeof schemesMap)[];
+type SchemeName = (typeof schemeNames)[number];
+declare function Mcu({ source, scheme, contrast, customColors, children, }: McuConfig & {
+    children: React.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+export { Mcu };

package/dist/index.js

@@ -1,8 +1,248 @@
 // src/Mcu.tsx
+import {
+  argbFromHex,
+  Hct,
+  hexFromArgb as hexFromArgb2,
+  MaterialDynamicColors,
+  SchemeContent,
+  SchemeExpressive,
+  SchemeFidelity,
+  SchemeMonochrome,
+  SchemeNeutral,
+  SchemeTonalSpot,
+  SchemeVibrant
+} from "@material/material-color-utilities";
+import { kebabCase } from "lodash-es";
+import { useMemo as useMemo2 } from "react";
+
+// src/Mcu.context.tsx
+import { hexFromArgb } from "@material/material-color-utilities";
+import {
+  useCallback,
+  useInsertionEffect,
+  useMemo,
+  useState
+} from "react";
+
+// src/lib/createRequiredContext.ts
+import { createContext, useContext } from "react";
+var createRequiredContext = () => {
+  const Ctx = createContext(null);
+  const useCtx = () => {
+    const contextValue = useContext(Ctx);
+    if (contextValue === null) {
+      throw new Error("Context value is null");
+    }
+    return contextValue;
+  };
+  return [useCtx, Ctx.Provider, Ctx];
+};
+
+// src/Mcu.context.tsx
 import { jsx } from "react/jsx-runtime";
-var Mcu = () => {
-  return /* @__PURE__ */ jsx("div", { children: "Hello World" });
+var [useMcu, Provider, McuContext] = createRequiredContext();
+var McuProvider = ({
+  source: initialSource,
+  scheme: initialScheme,
+  contrast: initialContrast,
+  customColors: initialCustomColors,
+  styleId,
+  children
+}) => {
+  const [initials] = useState(() => ({
+    source: initialSource,
+    scheme: initialScheme,
+    contrast: initialContrast,
+    customColors: initialCustomColors
+  }));
+  const [mcuConfig, setMcuConfig] = useState(initials);
+  const { css, mergedColorsLight, mergedColorsDark } = useMemo(
+    () => generateCss(mcuConfig),
+    [mcuConfig]
+  );
+  useInsertionEffect(() => {
+    let tag = document.getElementById(styleId);
+    if (!tag) {
+      tag = document.createElement("style");
+      tag.id = styleId;
+      document.head.appendChild(tag);
+    }
+    tag.textContent = css;
+  }, [css, styleId]);
+  const getMcuColor = useCallback(
+    (colorName, theme) => {
+      return hexFromArgb(
+        (theme === "light" ? mergedColorsLight : mergedColorsDark)[colorName]
+      );
+    },
+    [mergedColorsDark, mergedColorsLight]
+  );
+  const value = useMemo(
+    () => ({
+      initials,
+      setMcuConfig,
+      getMcuColor
+    }),
+    [getMcuColor, initials]
+  );
+  return /* @__PURE__ */ jsx(Provider, { value, children });
+};
+
+// src/Mcu.tsx
+import { Fragment, jsx as jsx2, jsxs } from "react/jsx-runtime";
+var schemesMap = {
+  tonalSpot: SchemeTonalSpot,
+  monochrome: SchemeMonochrome,
+  neutral: SchemeNeutral,
+  vibrant: SchemeVibrant,
+  expressive: SchemeExpressive,
+  fidelity: SchemeFidelity,
+  content: SchemeContent
+};
+var schemeNames = Object.keys(
+  schemesMap
+);
+var mcuStyleId = "mcu-styles";
+function Mcu({
+  source,
+  scheme,
+  contrast,
+  customColors,
+  children
+}) {
+  const config = useMemo2(
+    () => ({
+      source,
+      scheme,
+      contrast,
+      customColors
+    }),
+    [contrast, customColors, scheme, source]
+  );
+  const { css } = useMemo2(() => generateCss(config), [config]);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx2("style", { id: mcuStyleId, children: css }),
+    /* @__PURE__ */ jsx2(McuProvider, { ...config, styleId: mcuStyleId, children })
+  ] });
+}
+var tokenNames = [
+  "background",
+  "onBackground",
+  "surface",
+  "surfaceDim",
+  "surfaceBright",
+  "surfaceContainerLowest",
+  "surfaceContainerLow",
+  "surfaceContainer",
+  "surfaceContainerHigh",
+  "surfaceContainerHighest",
+  "onSurface",
+  "onSurfaceVariant",
+  "outline",
+  "outlineVariant",
+  "inverseSurface",
+  "inverseOnSurface",
+  "primary",
+  // "primaryDim",
+  "onPrimary",
+  "primaryContainer",
+  "onPrimaryContainer",
+  "primaryFixed",
+  "primaryFixedDim",
+  "onPrimaryFixed",
+  "onPrimaryFixedVariant",
+  "inversePrimary",
+  "primaryFixed",
+  "primaryFixedDim",
+  "onPrimaryFixed",
+  "onPrimaryFixedVariant",
+  "secondary",
+  // "secondaryDim",
+  "onSecondary",
+  "secondaryContainer",
+  "onSecondaryContainer",
+  "secondaryFixed",
+  "secondaryFixedDim",
+  "onSecondaryFixed",
+  "onSecondaryFixedVariant",
+  "tertiary",
+  // "tertiaryDim",
+  "onTertiary",
+  "tertiaryContainer",
+  "onTertiaryContainer",
+  "tertiaryFixed",
+  "tertiaryFixedDim",
+  "onTertiaryFixed",
+  "onTertiaryFixedVariant",
+  "error",
+  // "errorDim",
+  "onError",
+  "errorContainer",
+  "onErrorContainer",
+  "scrim",
+  // added manually, was missing
+  "shadow"
+  // added manually, was missing
+];
+function toRecord(arr, getEntry) {
+  return arr.reduce(
+    (acc, item) => {
+      const [key, value] = getEntry(item);
+      acc[key] = value;
+      return acc;
+    },
+    {}
+  );
+}
+function mergeBaseAndCustomColors(scheme, customColors) {
+  const baseVars = toRecord(tokenNames, (tokenName) => {
+    const dynamicColor = MaterialDynamicColors[tokenName];
+    const argb = dynamicColor.getArgb(scheme);
+    return [tokenName, argb];
+  });
+  const customVars = toRecord(customColors, (color) => [
+    color.name,
+    color.value
+  ]);
+  return { ...baseVars, ...customVars };
+}
+var cssVar = (colorName, colorValue) => {
+  const name = `--mcu-${kebabCase(colorName)}`;
+  const value = hexFromArgb2(colorValue);
+  return `${name}:${value};`;
+};
+var toCssVars = (mergedColors) => {
+  return Object.entries(mergedColors).map(([name, value]) => cssVar(name, value)).join(" ");
 };
+function generateCss({
+  source: hexSource,
+  customColors: hexCustomColors,
+  scheme,
+  contrast
+}) {
+  console.log("MCU generateCss");
+  const sourceArgb = argbFromHex(hexSource);
+  const hct = Hct.fromInt(sourceArgb);
+  const SchemeClass = schemesMap[scheme];
+  const lightScheme = new SchemeClass(hct, false, contrast);
+  const darkScheme = new SchemeClass(hct, true, contrast);
+  const customColors = hexCustomColors.map(({ hex, ...rest }) => ({
+    ...rest,
+    value: argbFromHex(hex)
+  }));
+  const mergedColorsLight = mergeBaseAndCustomColors(lightScheme, customColors);
+  const mergedColorsDark = mergeBaseAndCustomColors(darkScheme, customColors);
+  const lightVars = toCssVars(mergedColorsLight);
+  const darkVars = toCssVars(mergedColorsDark);
+  return {
+    css: `
+    :root { ${lightVars} }
+    .dark { ${darkVars} }
+    `,
+    mergedColorsLight,
+    mergedColorsDark
+  };
+}
 export {
   Mcu
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-mcu",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "A React component library",
   "keywords": [
     "react",
@@ -28,34 +28,47 @@
   ],
   "type": "module",
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.15.4",
+    "@arethetypeswrong/cli": "^0.18.2",
     "@changesets/cli": "^2.27.7",
+    "@storybook/react-vite": "^10.1.11",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.1",
+    "@types/lodash-es": "^4.17.12",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.1.2",
+    "chromatic": "^13.3.5",
+    "husky": "^9.1.7",
     "jsdom": "^27.4.0",
+    "lint-staged": "^16.2.7",
     "prettier": "^3.3.3",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
+    "storybook": "^10.1.11",
     "tsup": "^8.2.4",
     "typescript": "^5.5.4",
-    "vitest": "^2.0.5"
+    "vitest": "^4.0.16"
+  },
+  "peerDependencies": {
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3"
+  },
+  "dependencies": {
+    "@material/material-color-utilities": "^0.3.0",
+    "lodash-es": "^4.17.22"
   },
   "scripts": {
     "build": "tsup",
-    "ci": "npm run build && npm run check-format && npm run check-exports && npm run lint && npm run test",
+    "ci": "pnpm run build && pnpm run check-format && pnpm run check-exports && pnpm run lint && pnpm run test",
     "lint": "tsc",
     "test": "vitest run",
     "format": "prettier --write .",
     "check-format": "prettier --check .",
     "check-exports": "attw --pack . --ignore-rules cjs-resolves-to-esm no-resolution",
-    "release": "npm run build && changeset publish",
-    "local-release": "npm run ci && changeset version && changeset publish"
-  },
-  "peerDependencies": {
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3"
+    "release": "pnpm run build && changeset publish",
+    "local-release": "pnpm run ci && changeset version && changeset publish",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "chromatic": "chromatic --project-token $CHROMATIC_PROJECT_TOKEN"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) Matt Pocock 2024
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.