@webstudio-is/react-sdk 0.50.0 → 0.52.0

package/src/css/css.ts

@@ -0,0 +1,57 @@
+import { createCssEngine } from "@webstudio-is/css-engine";
+import type { Asset } from "@webstudio-is/asset-uploader";
+import type { Build } from "@webstudio-is/project-build";
+import { getComponentNames } from "../components/components-utils";
+import { getComponentMeta } from "../components";
+import { componentAttribute, idAttribute } from "../tree";
+import { addGlobalRules } from "./global-rules";
+import { getStyleRules } from "./style-rules";
+
+type Data = {
+  assets: Asset[];
+  breakpoints?: Build["breakpoints"];
+  styles?: Build["styles"];
+  styleSourceSelections?: Build["styleSourceSelections"];
+};
+
+export const generateCssText = (data: Data) => {
+  const assets = new Map<Asset["id"], Asset>(
+    data.assets.map((asset) => [asset.id, asset])
+  );
+  const breakpoints = new Map(data.breakpoints);
+  const styles = new Map(data.styles);
+  const styleSourceSelections = new Map(data.styleSourceSelections);
+
+  const engine = createCssEngine({ name: "ssr" });
+
+  addGlobalRules(engine, { assets });
+
+  for (const breakpoint of breakpoints.values()) {
+    engine.addMediaRule(breakpoint.id, breakpoint);
+  }
+
+  for (const component of getComponentNames()) {
+    const meta = getComponentMeta(component);
+    const presetStyle = meta?.presetStyle;
+    if (presetStyle !== undefined) {
+      for (const [tag, style] of Object.entries(presetStyle)) {
+        engine.addStyleRule(
+          `${tag}:where([${componentAttribute}=${component}])`,
+          {
+            style,
+          }
+        );
+      }
+    }
+  }
+
+  const styleRules = getStyleRules(styles, styleSourceSelections);
+  for (const { breakpointId, instanceId, style } of styleRules) {
+    engine.addStyleRule(`[${idAttribute}="${instanceId}"]`, {
+      breakpoint: breakpointId,
+      style,
+    });
+  }
+
+  return engine.cssText;
+};

package/src/css/get-browser-style.ts

@@ -1,5 +1,10 @@
 import { detectFont } from "detect-font";
-import { keywordValues, Style, StyleValue, Unit } from "@webstudio-is/css-data";
+import {
+  type Style,
+  type StyleValue,
+  type Unit,
+  keywordValues,
+} from "@webstudio-is/css-data";
 import { properties, units } from "@webstudio-is/css-data";
 
 const unitsList = Object.values(units).flat();

package/src/css/global-rules.ts

@@ -0,0 +1,29 @@
+import type { CssEngine } from "@webstudio-is/css-engine";
+import type { Assets, FontAsset } from "@webstudio-is/asset-uploader";
+import {
+  type FontFormat,
+  FONT_FORMATS,
+  getFontFaces,
+} from "@webstudio-is/fonts";
+
+export const addGlobalRules = (
+  engine: CssEngine,
+  { assets }: { assets: Assets }
+) => {
+  // @todo we need to figure out all global resets while keeping
+  // the engine aware of all of them.
+  // Ideally, the user is somehow aware and in control of the reset
+  engine.addPlaintextRule("html {margin: 0; height: 100%}");
+
+  const fontAssets: Array<FontAsset> = [];
+  for (const asset of assets.values()) {
+    if (asset && FONT_FORMATS.has(asset.format as FontFormat)) {
+      fontAssets.push(asset as FontAsset);
+    }
+  }
+
+  const fontFaces = getFontFaces(fontAssets);
+  for (const fontFace of fontFaces) {
+    engine.addFontFaceRule(fontFace);
+  }
+};

package/src/css/index.ts

@@ -1,2 +1,4 @@
 export * from "./get-browser-style";
-export * from "./categories";
+export * from "./global-rules";
+export * from "./style-rules";
+export * from "./css";

package/src/css/normalize-type-check.ts

@@ -0,0 +1,13 @@
+import * as normalize from "./normalize";
+import type { htmlTags as HtmlTags } from "html-tags";
+import type { Style } from "@webstudio-is/css-data";
+
+// no way I found to check exports https://github.com/microsoft/TypeScript/issues/38511
+// we can check here that all exports represents a valid html tag
+const normalizeWithKeyof = { ...normalize };
+
+type ExportedTags = keyof typeof normalizeWithKeyof;
+
+type ValidTags = ExportedTags extends HtmlTags ? ExportedTags : false;
+
+normalizeWithKeyof satisfies Record<ValidTags, Style>;

package/src/css/normalize.ts

@@ -0,0 +1,519 @@
+/**
+ * Based on https://github.com/sindresorhus/modern-normalize
+ *
+ * Attributions
+ *
+ * The MIT License (MIT)
+ * Copyright (c) Nicolas Gallagher
+ * Copyright (c) Jonathan Neal
+ * Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+ *
+ * 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
+ */
+
+import type { Style } from "@webstudio-is/css-data";
+
+// webstudio custom opinionated presets
+import { borders } from "./presets";
+
+/**
+Use a better box model (opinionated).
+*/
+const boxSizing = {
+  type: "keyword",
+  value: "border-box",
+} as const;
+
+/**
+ *  We dont support rules like this now, implement boxSizing for each used element
+ *  *,
+ * ::before,
+ * ::after {
+ *   box-sizing: border-box;
+  }
+*/
+const baseStyle = {
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+export const div = baseStyle;
+export const address = baseStyle;
+export const article = baseStyle;
+export const aside = baseStyle;
+export const figure = baseStyle;
+export const footer = baseStyle;
+export const header = baseStyle;
+export const main = baseStyle;
+export const nav = baseStyle;
+export const section = baseStyle;
+export const form = baseStyle;
+
+export const h1 = baseStyle;
+export const h2 = baseStyle;
+export const h3 = baseStyle;
+export const h4 = baseStyle;
+export const h5 = baseStyle;
+export const h6 = baseStyle;
+
+export const i = baseStyle;
+
+export const img = baseStyle;
+
+export const a = baseStyle;
+export const li = baseStyle;
+export const ul = baseStyle;
+export const ol = baseStyle;
+
+export const p = baseStyle;
+export const span = baseStyle;
+
+// @todo for now not applied to html, as we don't have html element
+/**
+1. Correct the line height in all browsers.
+2. Prevent adjustments of font size after orientation changes in iOS.
+3. Use a more readable tab size (opinionated).
+*/
+export const html = {
+  /* 1 */
+  lineHeight: {
+    type: "unit",
+    value: 1.15,
+    unit: "number",
+  },
+
+  /* 2 */
+  textSizeAdjust: {
+    type: "unit",
+    value: 100,
+    unit: "%",
+  },
+
+  /* 3 */
+  tabSize: {
+    type: "unit",
+    value: 4,
+    unit: "number",
+  },
+
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+/**
+1. Remove the margin in all browsers.
+2. Improve consistency of default fonts in all browsers. (https://github.com/sindresorhus/modern-normalize/issues/3)
+*/
+export const body = {
+  /* 1 */
+  marginTop: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  marginRight: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  marginBottom: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  marginLeft: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  /* 2 */
+  fontFamily: {
+    type: "keyword",
+    value: `system-ui, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji'`,
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+/**
+1. Add the correct height in Firefox.
+2. Correct the inheritance of border color in Firefox. (https://bugzilla.mozilla.org/show_bug.cgi?id=190655)
+*/
+export const hr = {
+  /* 1 */
+  height: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  /* 2 */
+  color: { type: "keyword", value: "inherit" },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+/**
+Add the correct text decoration in Chrome, Edge, and Safari.
+
+!!!Skipped as we don't support this logic!!!
+
+abbr[title] {
+ text-decoration: underline dotted;
+}
+*/
+
+/**
+Add the correct font weight in Edge and Safari.
+*/
+export const b = {
+  fontWeight: {
+    type: "keyword",
+    value: "bolder",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+export const strong = b;
+
+/**
+1. Improve consistency of default fonts in all browsers. (https://github.com/sindresorhus/modern-normalize/issues/3)
+2. Correct the odd 'em' font sizing in all browsers.
+*/
+export const code = {
+  /* 1 */
+  fontFamily: {
+    type: "keyword",
+    value: `ui-monospace, SFMono-Regular, Consolas, 'Liberation Mono', Menlo, monospace`,
+  },
+  /* 2 */
+  fontSize: {
+    type: "unit",
+    value: 1,
+    unit: "em",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+export const kbd = code;
+export const samp = code;
+export const pre = code;
+
+/**
+Add the correct font size in all browsers.
+*/
+
+export const small = {
+  fontSize: {
+    type: "unit",
+    value: 80,
+    unit: "%",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+/**
+Prevent 'sub' and 'sup' elements from affecting the line height in all browsers.
+*/
+
+const subSupBase = {
+  fontSize: {
+    type: "unit",
+    value: 75,
+    unit: "%",
+  },
+  lineHeight: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  position: {
+    type: "keyword",
+    value: "relative",
+  },
+  verticalAlign: {
+    type: "keyword",
+    value: "baseline",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+export const sub = {
+  ...subSupBase,
+  bottom: {
+    type: "unit",
+    value: -0.25,
+    unit: "em",
+  },
+} as const satisfies Style;
+
+export const sup = {
+  ...subSupBase,
+  top: {
+    type: "unit",
+    value: -0.5,
+    unit: "em",
+  },
+} as const satisfies Style;
+
+/*
+Tabular data
+============
+*/
+
+/**
+1. Remove text indentation from table contents in Chrome and Safari. (https://bugs.chromium.org/p/chromium/issues/detail?id=999088, https://bugs.webkit.org/show_bug.cgi?id=201297)
+2. Correct table border color inheritance in Chrome and Safari. (https://bugs.chromium.org/p/chromium/issues/detail?id=935729, https://bugs.webkit.org/show_bug.cgi?id=195016)
+*/
+
+export const table = {
+  /* 1 */
+  textIndent: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  ...borders,
+  /* 2 */
+  borderTopColor: {
+    type: "keyword",
+    value: "inherit",
+  },
+  borderRightColor: {
+    type: "keyword",
+    value: "inherit",
+  },
+  borderBottomColor: {
+    type: "keyword",
+    value: "inherit",
+  },
+  borderLeftColor: {
+    type: "keyword",
+    value: "inherit",
+  },
+  boxSizing,
+} as const satisfies Style;
+
+/*
+Forms
+=====
+*/
+
+/**
+1. Change the font styles in all browsers.
+2. Remove the margin in Firefox and Safari.
+*/
+
+const buttonBase = {
+  /* 1 */
+  fontFamily: {
+    type: "keyword",
+    value: "inherit",
+  },
+  fontSize: {
+    type: "unit",
+    value: 100,
+    unit: "%",
+  },
+  lineHeight: {
+    type: "unit",
+    value: 1.15,
+    unit: "number",
+  },
+  /* 2 */
+  marginTop: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  marginRight: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  marginBottom: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  marginLeft: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+export const input = buttonBase;
+export const optgroup = buttonBase;
+export const textarea = buttonBase;
+
+/**
+Remove the inheritance of text transform in Edge and Firefox.
+*/
+export const button = {
+  ...buttonBase,
+  textTransform: {
+    type: "keyword",
+    value: "none",
+  },
+} as const satisfies Style;
+
+export const select = button;
+
+/**
+Correct the inability to style clickable types in iOS and Safari.
+
+!!!Skipped as we don't support this logic!!!
+
+buttonBase,
+[type='button'],
+[type='reset'],
+[type='submit'] {
+  -webkit-appearance: buttonBase;
+}
+*/
+
+/**
+Remove the inner border and padding in Firefox.
+
+!!!Skipped as we don't support this logic!!!
+
+::-moz-focus-inner {
+  border-style: none;
+ padding: 0;
+}
+*/
+
+/**
+Restore the focus styles unset by the previous rule.
+
+!!!Skipped as we don't support this logic!!!
+
+:-moz-focusring {
+  outline: 1px dotted ButtonText;
+}
+*/
+
+/**
+Remove the additional ':invalid' styles in Firefox.
+See: https://github.com/mozilla/gecko-dev/blob/2f9eacd9d3d995c937b4251a5557d95d494c9be1/layout/style/res/forms.css#L728-L737
+
+!!!Skipped as we don't support this logic!!!
+
+:-moz-ui-invalid {
+  box-shadow: none;
+}
+*/
+
+/**
+Remove the padding so developers are not caught out when they zero out 'fieldset' elements in all browsers.
+*/
+
+export const legend = {
+  paddingTop: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  paddingRight: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  paddingBottom: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  paddingLeft: {
+    type: "unit",
+    value: 0,
+    unit: "number",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+/**
+Add the correct vertical alignment in Chrome and Firefox.
+*/
+
+export const progress = {
+  verticalAlign: {
+    type: "keyword",
+    value: "baseline",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;
+
+/**
+Correct the cursor style of increment and decrement buttons in Safari.
+
+!!!Skipped as we don't support this logic!!!
+
+::-webkit-inner-spin-buttonBase,
+::-webkit-outer-spin-buttonBase {
+  height: auto;
+}
+*/
+
+/**
+1. Correct the odd appearance in Chrome and Safari.
+2. Correct the outline style in Safari.
+
+!!!Skipped as we don't support this logic!!!
+
+[type='search'] {
+  -webkit-appearance: textfield;
+ outline-offset: -2px;
+}
+*/
+
+/**
+Remove the inner padding in Chrome and Safari on macOS.
+
+!!!Skipped as we don't support this logic!!!
+
+::-webkit-search-decoration {
+  -webkit-appearance: none;
+}
+*/
+
+/**
+1. Correct the inability to style clickable types in iOS and Safari.
+2. Change font properties to 'inherit' in Safari.
+
+!!!Skipped as we don't support this logic!!!
+
+::-webkit-file-upload-buttonBase {
+  -webkit-appearance: buttonBase;
+ font: inherit;
+}
+*/
+
+/*
+Interactive
+===========
+*/
+
+/*
+Add the correct display in Chrome and Safari.
+*/
+
+export const summary = {
+  display: {
+    type: "keyword",
+    value: "list-item",
+  },
+  boxSizing,
+  ...borders,
+} as const satisfies Style;

package/src/css/presets.ts

@@ -0,0 +1,42 @@
+import type { Style } from "@webstudio-is/css-data";
+
+export const borders = {
+  borderTopColor: {
+    type: "keyword",
+    value: "currentColor",
+  },
+  borderRightColor: {
+    type: "keyword",
+    value: "currentColor",
+  },
+  borderBottomColor: {
+    type: "keyword",
+    value: "currentColor",
+  },
+  borderLeftColor: {
+    type: "keyword",
+    value: "currentColor",
+  },
+
+  borderTopWidth: {
+    type: "unit",
+    value: 1,
+    unit: "px",
+  },
+
+  borderRightWidth: {
+    type: "unit",
+    value: 1,
+    unit: "px",
+  },
+  borderBottomWidth: {
+    type: "unit",
+    value: 1,
+    unit: "px",
+  },
+  borderLeftWidth: {
+    type: "unit",
+    value: 1,
+    unit: "px",
+  },
+} as const satisfies Style;