@exsto/ds 0.0.1-rc.3 → 0.0.1-rc.5

package/README.md

@@ -1,7 +1,6 @@
 # @exsto/ds
 
-The eDynamix design system: React components, design tokens, and optional web
-components.
+The eDynamix design system: React components and design tokens.
 
 ## Install
 
@@ -49,6 +48,13 @@ equal specificity the later rule wins. Import it after your Tailwind entry and
 its unconditional `.hidden` beats your `.md:table-cell`: responsive columns
 vanish, widths collapse. Library CSS before app CSS, as with any CSS dependency.
 
+Nothing else is needed. `theme.css` also points your build at the components'
+shipped code, so your build emits their classes too, each responsive variant
+after its own base. That is what keeps a design system class such as the
+sidebar's `hidden md:block` working when your own markup uses `hidden` as well:
+one build decides the order for both sides. Earlier releases needed a
+`@source` line in the app to get this, and that line can be removed.
+
 `theme.css` is uncompiled on purpose. It carries the tokens, the `.dark` scope,
 the brand layer (Inter, `text-2xs`) and the `@theme` mapping Tailwind needs to
 turn them into utilities. Do not copy that block into your app, or it will drift
@@ -69,40 +75,22 @@ query, so a subtree can be dark inside a light page.
 </div>
 ```
 
-## Web components
-
-React is the default. If you are not on React, the same components ship as
-`<edx-*>` custom elements behind a subpath, so a React consumer never pays for a
-runtime it does not use.
-
-```ts
-import { registerElements } from '@exsto/ds/elements';
-
-registerElements();
-```
-
-```html
-<edx-button>Save</edx-button>
-```
-
-`registerElements()` defaults to shadow DOM and carries its own copy of the
-compiled stylesheet, because a shadow root does not inherit the page's styles.
-Pass `{ mode: 'light' }` to render into the light DOM instead, or `{ styles }` to
-supply your own sheet. Calling it more than once is harmless.
-
 ## Entry points
 
 | Import | What it is |
 |---|---|
-| `@exsto/ds` | React components (the default) |
+| `@exsto/ds` | React components |
 | `@exsto/ds/styles.css` | Precompiled tokens and component styles |
 | `@exsto/ds/theme.css` | Uncompiled tokens, brand layer, and the Tailwind `@theme` mapping |
-| `@exsto/ds/elements` | `<edx-*>` custom elements and `registerElements()` |
 
 ## Status
 
-`0.0.1-rc.1`. The API is not stable yet; treat minor versions as breaking until
-`0.1.0`.
+Release candidates (`0.0.1-rc.N`). The API is not stable yet; treat minor versions
+as breaking until `0.1.0`.
+
+`0.0.1-rc.5` removed the `@exsto/ds/elements` entry point (the `<edx-*>` web
+components) and with it Angular support. The design system is React only. Stay on
+`0.0.1-rc.4` if you depend on the elements.
 
 ## Licence
 

package/dist/ds/src/index.d.ts

@@ -1,8 +1,7 @@
 /**
  * `@exsto/ds` - the React entry, and the default way to use the design system.
  *
- * Re-exports the component tier verbatim. The web components live behind
- * `@exsto/ds/elements` so a React consumer never pays for a runtime it does not
- * use, and styles ship precompiled at `@exsto/ds/styles.css`.
+ * Re-exports the component tier verbatim. Styles ship precompiled at
+ * `@exsto/ds/styles.css`, and the token layer uncompiled at `@exsto/ds/theme.css`.
  */
 export * from '../../ui/src';