@praxisui/core 10.0.0-rc.0 → 10.0.0-rc.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -211,7 +211,37 @@ Peer dependencies:
211
211
 
212
212
  ## Theme And Icons
213
213
 
214
- Import the theme bridge after Angular Material and CDK overlay styles.
214
+ ### Canonical SCSS Theming (Recommended)
215
+
216
+ Import the canonical theming mixins to bridge host design tokens (OKLCH, Material 3, Tailwind, etc.) to Praxis components:
217
+
218
+ ```scss
219
+ @use "@angular/cdk/overlay-prebuilt.css";
220
+ @use "@praxisui/core/theming" as praxis;
221
+
222
+ // Option A: Bundle light theme, dark mode overrides, widget shell, and tooltip enhancements
223
+ @include praxis.praxis-theme-bundle();
224
+
225
+ // Option B: Granular configuration with custom design tokens
226
+ :root {
227
+ @include praxis.define-praxis-theme((
228
+ 'primary': var(--primary),
229
+ 'surface': var(--card),
230
+ 'border': var(--border)
231
+ ));
232
+ }
233
+
234
+ .dark {
235
+ @include praxis.praxis-dark-theme-overrides();
236
+ }
237
+
238
+ @include praxis.praxis-shell-styles();
239
+ @include praxis.praxis-tooltip-styles();
240
+ ```
241
+
242
+ ### Static Theme Bridge (Legacy)
243
+
244
+ For simple or static setups, you can still import the prebuilt CSS bridge directly:
215
245
 
216
246
  ```scss
217
247
  @import "@angular/cdk/overlay-prebuilt.css";
@@ -1034,3 +1064,10 @@ Nested shells isolate their material CSS properties: an outer thick/dashed borde
1034
1064
  blur does not become an inner widget's default. Intentional inheritance through
1035
1065
  `context.ui.shell.preset/presets` remains supported. This isolation does not remove
1036
1066
  the host's shared theme tokens.
1067
+
1068
+ <!-- praxis-npm-catalog-links:start -->
1069
+ ## Official documentation and examples
1070
+
1071
+ - [Canonical technical overview: Overview](https://praxisui.dev/docs/components/praxis-core)
1072
+ - [Praxis Angular public catalog](https://praxisui.dev/angular)
1073
+ <!-- praxis-npm-catalog-links:end -->
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": "1.0.0",
3
- "generatedAt": "2026-09-10T12:25:16.581Z",
3
+ "generatedAt": "2026-10-07T11:07:08.250Z",
4
4
  "packageName": "@praxisui/core",
5
- "packageVersion": "10.0.0-rc.0",
5
+ "packageVersion": "10.0.0-rc.4",
6
6
  "sourceRegistry": "praxis-component-registry-ingestion",
7
7
  "sourceRegistryVersion": "1.0.0",
8
8
  "componentCount": 4,