@praxisui/core 9.0.68-rc.0 → 9.0.68-rc.2

package/README.md

@@ -21,7 +21,18 @@ Use this package directly when a host application or library needs Praxis UI typ
   `appearance.body.padding: "0"` (and hide the header if the content owns its title).
   Persist the preset `id` in `WidgetShellConfig.preset` and
   use the descriptor for authoring labels and previews. Do not maintain a
-  second preset list in consumers.
+  second preset list in consumers. The builtin Portuguese and English shell labels
+  and descriptions are Core fallbacks in `PraxisI18nService`; consumers do not need a
+  Page Builder i18n provider. Host/ancestor dictionaries and translators take precedence.
+  Published IDs `dark-glass`, `light-neutral`, `graphite`, `data-panel`,
+  `chart-panel`, `metric-panel`, `executive-card` and `filter-bar` remain resolvable in the same catalog. Their finishes were recalibrated after visual review;
+  ID compatibility does not promise pixel-for-pixel historical appearance. `BUILTIN_SHELL_PRESETS` provides the
+  public ID-to-appearance record derived from that catalog. Configure host overrides
+  through `context.ui.shell.presets`, then widget-specific `appearance`; use CSS
+  variables there for corporate theming. The `dark-glass` and `graphite` material palettes remain dark by default;
+  adaptive finishes follow the host Material tokens. Do not mutate either exported catalog to configure an application.
+  The deliberate `frameless` inset improvement differs from 9.0.67: persist
+  `appearance.body.padding: "0"` when the original edge-to-edge layout is required.
 - `WidgetShellConfig.stickyHeader: true` retains the existing composition-derived
   header within its widget during page scrolling. Omission/false keeps normal flow.
   This differs from `bodyLayout: 'scroll'`, which governs body scrolling. No second
@@ -938,3 +949,88 @@ selected section without remounting the provider or moving focus out of the navi
 On editable canvases, content-only widgets expose contextual actions above the north resize
 handle, with reserved space at the top of the canvas. Both controls remain pointer-accessible
 when the widget is narrow.
+
+The `dark-glass` preset uses a fixed dark material palette with explicit header/body
+foreground pairs, including in light application themes. Projected content inherits
+the shell foreground when it does not define its own surface.
+
+### Shared page preset resolution
+
+`resolveWidgetPageLayoutPreset(page)` exposes the same organization resolution used by
+`DynamicWidgetPageComponent`: a recognized, trimmed `layoutPreset` wins; otherwise the
+runtime uses the existing `layoutPresetOptions.presetFamily`. It reads the existing
+`WidgetPageDefinition` fields and returns the builtin catalog definition without modifying
+the page. Page editors use it to explain inherited organization and its suggested theme.
+An explicit `themePreset` still takes precedence over `defaultThemePreset`. This extraction
+adds no page field, domain semantics, dependency on another library, or persistence behavior.
+
+### Selection-bound workflow forms
+
+`ResourceActionOpenAdapterService` projects the existing collection action's
+`selection.idsField` and, for `SELECTION_MAP`, `selection.versionsField` into
+`groupedCommand.contextFields`. The form layout retains these schema fields in
+runtime metadata and submit data even when hidden, while excluding them from the
+interactive layout. Primitive arrays such as selected IDs remain FormControl
+values; object collections declared by `arrayInput` or `array` use FormArray.
+A `PER_ITEM` action suppresses generic HTTP-success notifications: its opening
+consumer must present the per-item outcome rather than claim all items succeeded.
+
+### Shell materials and faithful editor preview
+
+`WidgetShellConfig.appearance.card.backdropFilter` accepts a CSS backdrop effect such as
+`blur(16px) saturate(125%)`. Pair translucent backgrounds with an opaque
+`appearance.card.fallbackBackground`. The shell uses that fallback when backdrop filters
+are unsupported, the user requests reduced transparency, or the card is expanded/fullscreen.
+A sticky glass header uses the same opaque fallback for legibility over scrolling content.
+`none` disables a backdrop effect; `kind: 'none'` still disables the entire external surface.
+
+The runtime resolves a widget preset, the inherited page/theme preset, custom context presets,
+and explicit appearance overrides in that order of responsibility. Widget appearance fields
+win over the chosen preset. The editor receives the resolved inherited context; it never
+persists the theme-derived preset as an explicit widget or page choice just to render its preview.
+The original ID `light-neutral` now has the honest adaptive-neutral label. Presets style the shell;
+charts, tables and rich content retain ownership of their internal appearance and behavior.
+
+Token ownership: host Material tokens → canonical `widget-shell-presets.ts` → shell appearance
+bindings → `WidgetShellComponent`; Page Builder thumbnails and live previews consume the same
+catalog. Fixed glass/graphite palettes are material defaults in that catalog, overridable through
+existing context presets or explicit appearance. No host CSS patch is required.
+
+
+### Shell border widths, strokes and layered backgrounds
+
+`appearance.card.borderWidth` and `borderStyle` accept CSS border values, including
+per-side shorthands such as `1px 1px 1px 6px` and `solid dashed dotted double`.
+`appearance.header.borderWidth` and `borderStyle` control the bottom divider only
+(single values). Omitted values retain the existing `1px solid` geometry. `none`
+removes the corresponding stroke; `kind: 'none'` disables the complete shell.
+The same fields participate in preset/context inheritance and explicit override precedence.
+
+Backgrounds already accept solid colors, gradients and CSS background layers. For a
+rounded gradient border, use a transparent solid border and two background layers:
+
+```json
+{
+  "card": {
+    "background": "linear-gradient(#102c46,#102c46) padding-box,linear-gradient(125deg,#b9d9ec,#ffd38a) border-box",
+    "borderColor": "transparent",
+    "borderWidth": "3px",
+    "borderStyle": "solid",
+    "borderRadius": "16px"
+  },
+  "header": { "background": "transparent", "titleColor": "#ffffff", "subtitleColor": "#ffffff", "iconColor": "#ffffff" },
+  "body": { "background": "transparent", "textColor": "#ffffff" }
+}
+```
+
+The background layer is continuous: a transparent dashed/dotted/double border does
+not cut gaps into that gradient. Use a colored stroke and another fill for visibly
+dashed/dotted/double outlines. `borderStyle: 'none'` hides the gradient border area.
+Authoring valid CSS does not certify contrast: consumers must pair foregrounds,
+backgrounds and opaque alternatives appropriately. Inner component surfaces keep
+ownership of their own colors and interaction states.
+
+Nested shells isolate their material CSS properties: an outer thick/dashed border or
+blur does not become an inner widget's default. Intentional inheritance through
+`context.ui.shell.preset/presets` remains supported. This isolation does not remove
+the host's shared theme tokens.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-09-09T10:03:24.330Z",
+  "generatedAt": "2026-09-10T01:25:13.157Z",
   "packageName": "@praxisui/core",
-  "packageVersion": "9.0.68-rc.0",
+  "packageVersion": "9.0.68-rc.2",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 4,
@@ -4295,9 +4295,9 @@
         {
           "chunkIndex": 121,
           "chunkKind": "recipe",
-          "content": "{\"componentId\":\"praxis-dynamic-page\",\"chunkSection\":\"authoringPlan.widgets[2]\",\"fragmentPath\":\"authoringPlan.widgets[2]\",\"fragmentIdentity\":{\"key\":\"workspace\",\"componentId\":\"praxis-tabs\"},\"fragment\":{\"key\":\"workspace\",\"componentId\":\"praxis-tabs\",\"shell\":{\"kind\":\"dashboard-card\",\"icon\":\"folder_shared\",\"title\":\"${state.detailTitle}\",\"subtitle\":\"${state.detailSubtitle}\",\"stickyHeader\":true,\"bodyLayout\":\"fill\",\"windowActions\":{\"fullscreen\":true,\"collapsible\":true}},\"bindingOrder\":[\"tabsId\",\"componentInstanceId\",\"configPersistenceStrategy\",\"config\",\"selectedIndex\"]}}",
+          "content": "{\"componentId\":\"praxis-dynamic-page\",\"chunkSection\":\"authoringPlan.widgets[2]\",\"fragmentPath\":\"authoringPlan.widgets[2]\",\"fragmentIdentity\":{\"key\":\"workspace\",\"componentId\":\"praxis-tabs\"},\"fragment\":{\"key\":\"workspace\",\"componentId\":\"praxis-tabs\",\"shell\":{\"kind\":\"dashboard-card\",\"icon\":\"folder_shared\",\"title\":\"${state.detailTitle}\",\"subtitle\":\"${state.detailSubtitle}\",\"stickyHeader\":true,\"windowActions\":{\"fullscreen\":true,\"collapsible\":true}},\"bindingOrder\":[\"tabsId\",\"componentInstanceId\",\"configPersistenceStrategy\",\"config\",\"selectedIndex\"]}}",
           "sourcePointer": "examples/ai-recipes/praxis-dynamic-page.ergon-archetype-master-detail-tabs.json",
-          "contentHash": "2d5640538744ae254de35cbc8e8e084db8ae3a82be7cb9457626923452248edf",
+          "contentHash": "ed933eab963f703ec2ad55930d7d890566285c420076b267c6161e97ebfb759c",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-page",
           "corpusVersion": "1.0.0"