@praxisui/core 8.0.0-beta.98 → 9.0.0-beta.0
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 +29 -1
- package/fesm2022/praxisui-core.mjs +1530 -111
- package/package.json +1 -1
- package/types/praxisui-core.d.ts +301 -8
package/README.md
CHANGED
|
@@ -29,6 +29,34 @@ or read back safe summaries. Runtime surfaces must continue to treat the
|
|
|
29
29
|
resulting materializations as derived projections of the canonical semantic
|
|
30
30
|
decision.
|
|
31
31
|
|
|
32
|
+
## Runtime Component Observations
|
|
33
|
+
|
|
34
|
+
`PraxisRuntimeComponentObservationEnvelope` is the shared contract for active
|
|
35
|
+
runtime component observations. It lets hosts and component libraries publish a
|
|
36
|
+
small, serializable and redacted snapshot of the active instance, such as
|
|
37
|
+
identity, lifecycle, canonical refs, digests and affordance refs.
|
|
38
|
+
|
|
39
|
+
The envelope is intentionally not a capability source of truth. It must be
|
|
40
|
+
treated as an untrusted runtime observation that backend authoring services
|
|
41
|
+
reconcile against governed manifests, schemas, resource capabilities, actions,
|
|
42
|
+
surfaces and tenant/environment policy before any answer, preview or
|
|
43
|
+
materialization can use it.
|
|
44
|
+
|
|
45
|
+
Use `PraxisRuntimeComponentObservationRegistryService` or
|
|
46
|
+
`registerPraxisRuntimeComponentObservation` to register providers with Angular
|
|
47
|
+
lifecycle cleanup. Providers should produce snapshots lazily and must not expose
|
|
48
|
+
raw rows, full form values, secrets or complete schemas.
|
|
49
|
+
|
|
50
|
+
`praxis-dynamic-page` registers a runtime observation for the active page
|
|
51
|
+
composition. The page observation publishes page identity, active widget keys,
|
|
52
|
+
the selected widget when it still belongs to the rendered composition,
|
|
53
|
+
composition link refs and declared related surface refs. Related surface refs
|
|
54
|
+
include `runtimeSurfaceInstanceRef` when the page can derive a canonical runtime
|
|
55
|
+
surface identity from widget, component, surface and resource refs, so backend
|
|
56
|
+
grounding can disambiguate multiple widgets backed by the same resource path. It
|
|
57
|
+
does not publish widget input values, state values, raw events, rendered DOM or
|
|
58
|
+
intent decisions.
|
|
59
|
+
|
|
32
60
|
## Form Layout Contract
|
|
33
61
|
|
|
34
62
|
`FormColumn.items` and the exported `FormLayoutItem` contract define the
|
|
@@ -71,7 +99,7 @@ A biblioteca `@praxisui/core` é o núcleo do Praxis UI Workspace, fornecendo in
|
|
|
71
99
|
## 🚀 Instalação
|
|
72
100
|
|
|
73
101
|
```bash
|
|
74
|
-
npm install @praxisui/core
|
|
102
|
+
npm install @praxisui/core@beta
|
|
75
103
|
```
|
|
76
104
|
|
|
77
105
|
Exemplo completo (app de referência)
|