@edsis/angular 22.0.72 → 22.0.74

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
@@ -45,12 +45,33 @@ Tauri restart or update.
45
45
  ## `services/runtime`: desktop, tablet, and browser context
46
46
 
47
47
  Register `provideEdsisRuntime()` before rendering the structural shell. It
48
- validates `window.EDSIS_RUNTIME`, falls back to the `runtime_context` Tauri
49
- command and `edsis:runtime-ready` event, then safely resolves a responsive web
50
- context in an ordinary browser. `RuntimeContextService` exposes signals for
51
- desktop, iPadOS, Android tablet, and the shell capability list without using
52
- the User-Agent. It also writes the resolved host/platform/device/profile to
53
- `data-edsis-*` attributes on the document root.
48
+ validates a schema V2 `window.EDSIS_RUNTIME`, falls back to the `runtime_context`
49
+ Tauri command and `edsis:runtime-ready` event, then safely resolves a responsive
50
+ web context in an ordinary browser. Trusted schema V1 payloads are accepted and
51
+ normalized to V2 during migration. V2 adds the canonical `deviceType` value:
52
+ `browser`, `windows`, `macos`, `android`, or `ipados`.
53
+
54
+ `RuntimeContextService` exposes `deviceType` plus signals for desktop, iPadOS,
55
+ Android tablet, and the shell capability list without using the User-Agent. It
56
+ also writes the resolved host/platform/device/device-type/profile to
57
+ `data-edsis-*` attributes on the document root. `browser` is reserved for a
58
+ non-Tauri host; an invalid native response fails initialization instead of being
59
+ silently mislabeled as a browser.
60
+
61
+ When the consumer also uses `provideUiTheme()`, register the opt-in bridge so UI
62
+ components and CSS receive the same resolved device:
63
+
64
+ ```ts
65
+ import { provideRuntimeThemeDevice } from '@edsis/angular/block/themes';
66
+ import { provideEdsisRuntime } from '@edsis/angular/services/runtime';
67
+ import { provideUiTheme } from '@edsis/theme/styles';
68
+
69
+ providers: [provideUiTheme(), provideEdsisRuntime(), provideRuntimeThemeDevice()];
70
+ ```
71
+
72
+ The bridge waits for runtime initialization and then updates
73
+ `ThemeDeviceService` once. This keeps the base runtime entry point independent
74
+ from the optional theme package.
54
75
 
55
76
  `TabletViewportService` reports landscape and the 600 CSS pixel minimum. The
56
77
  consumer decides where to render its blocking view and must gate it with