@betterportal/theme-embedded 10.1.46 → 10.1.47

package/bp-resources/SKILL.md

@@ -8,7 +8,7 @@ description: Build compact BetterPortal service UI for the Embedded theme.
 1. Read `/llms-api.txt` and the Embedded UI guide.
 2. Keep the view single-column and self-contained.
 3. Use semantic HTML and server-rendered HTMX fragments.
-4. Use `ctx.routeUrl()` for service calls and `ctx.uiRouteUrl()` only for GET navigation.
+4. In renderers, use `ctx.url.route()` for service calls and `ctx.url.uiRoute()` only for GET navigation. Pass a declared dependency alias as `serviceId` for another service.
 5. Include loading, empty, validation and failure states.
 6. Verify keyboard use, labels, responsive wrapping and the published schemas.
 

package/bp-resources/ui-guide.md

@@ -7,7 +7,7 @@ The Embedded theme renders BetterPortal service content inside a lightweight hos
 - Return service content only; the theme owns the host document and main outlet.
 - Use semantic HTML, visible labels, keyboard-operable controls and responsive wrapping.
 - Prefer one column. Avoid persistent navigation, wide tables, fixed positioning and viewport-sized panels.
-- Use `ctx.routeUrl()` for service requests. Use `ctx.uiRouteUrl()` only for GET page navigation.
+- In renderers, use `ctx.url.route()` for service requests. Use `ctx.url.uiRoute()` only for GET page navigation. Pass a declared dependency alias as `serviceId` when resolving another app-mounted service. Handler equivalents are `ctx.routeUrl()` and `ctx.uiRouteUrl()`.
 - Use normal forms and HTMX swaps. Provide loading, empty, validation and error states.
 - Use `hx-download` for authenticated files and `HX-Trigger` events for passive refresh.
 - Do not add a SPA framework, iframe, client router, state library or hardcoded service URL.

package/lib/bp-contracts/org.betterportal.theme.embedded.json

@@ -4,7 +4,7 @@
     "pluginId": "org.betterportal.theme.embedded",
     "title": "Embedded Theme",
     "description": "Minimal htmx theme for embedding BetterPortal content without iframes.",
-    "version": "10.1.46",
+    "version": "10.1.47",
     "category": "theme",
     "deploymentModes": [
       "self-hosted"
@@ -33,7 +33,7 @@
         "title": "Embedded UI guide",
         "description": "Compact layout, HTMX and accessibility rules for embedded views.",
         "mediaType": "text/markdown; charset=utf-8",
-        "content": "# Embedded theme UI guide\n\nThe Embedded theme renders BetterPortal service content inside a lightweight host without an iframe. Keep UI narrow, self-contained and dependent only on native HTML, HTMX and the theme's existing variables.\n\n## Rules\n\n- Return service content only; the theme owns the host document and main outlet.\n- Use semantic HTML, visible labels, keyboard-operable controls and responsive wrapping.\n- Prefer one column. Avoid persistent navigation, wide tables, fixed positioning and viewport-sized panels.\n- Use `ctx.routeUrl()` for service requests. Use `ctx.uiRouteUrl()` only for GET page navigation.\n- Use normal forms and HTMX swaps. Provide loading, empty, validation and error states.\n- Use `hx-download` for authenticated files and `HX-Trigger` events for passive refresh.\n- Do not add a SPA framework, iframe, client router, state library or hardcoded service URL.\n\nThe Embedded theme deliberately offers fewer visual primitives than Bootstrap1. If a workflow needs a complex application shell, use Bootstrap1 instead of recreating a shell inside service content.\n"
+        "content": "# Embedded theme UI guide\n\nThe Embedded theme renders BetterPortal service content inside a lightweight host without an iframe. Keep UI narrow, self-contained and dependent only on native HTML, HTMX and the theme's existing variables.\n\n## Rules\n\n- Return service content only; the theme owns the host document and main outlet.\n- Use semantic HTML, visible labels, keyboard-operable controls and responsive wrapping.\n- Prefer one column. Avoid persistent navigation, wide tables, fixed positioning and viewport-sized panels.\n- In renderers, use `ctx.url.route()` for service requests. Use `ctx.url.uiRoute()` only for GET page navigation. Pass a declared dependency alias as `serviceId` when resolving another app-mounted service. Handler equivalents are `ctx.routeUrl()` and `ctx.uiRouteUrl()`.\n- Use normal forms and HTMX swaps. Provide loading, empty, validation and error states.\n- Use `hx-download` for authenticated files and `HX-Trigger` events for passive refresh.\n- Do not add a SPA framework, iframe, client router, state library or hardcoded service URL.\n\nThe Embedded theme deliberately offers fewer visual primitives than Bootstrap1. If a workflow needs a complex application shell, use Bootstrap1 instead of recreating a shell inside service content.\n"
       },
       {
         "id": "embedded.skill",
@@ -41,7 +41,7 @@
         "title": "Embedded UI skill",
         "description": "Agent workflow for producing Embedded-compatible service UI.",
         "mediaType": "text/markdown; charset=utf-8",
-        "content": "---\nname: betterportal-embedded-ui\ndescription: Build compact BetterPortal service UI for the Embedded theme.\n---\n\n# BetterPortal Embedded UI\n\n1. Read `/llms-api.txt` and the Embedded UI guide.\n2. Keep the view single-column and self-contained.\n3. Use semantic HTML and server-rendered HTMX fragments.\n4. Use `ctx.routeUrl()` for service calls and `ctx.uiRouteUrl()` only for GET navigation.\n5. Include loading, empty, validation and failure states.\n6. Verify keyboard use, labels, responsive wrapping and the published schemas.\n\nDo not recreate Bootstrap components or a second app shell. Recommend Bootstrap1 when the requested interface genuinely needs those primitives.\n"
+        "content": "---\nname: betterportal-embedded-ui\ndescription: Build compact BetterPortal service UI for the Embedded theme.\n---\n\n# BetterPortal Embedded UI\n\n1. Read `/llms-api.txt` and the Embedded UI guide.\n2. Keep the view single-column and self-contained.\n3. Use semantic HTML and server-rendered HTMX fragments.\n4. In renderers, use `ctx.url.route()` for service calls and `ctx.url.uiRoute()` only for GET navigation. Pass a declared dependency alias as `serviceId` for another service.\n5. Include loading, empty, validation and failure states.\n6. Verify keyboard use, labels, responsive wrapping and the published schemas.\n\nDo not recreate Bootstrap components or a second app shell. Recommend Bootstrap1 when the requested interface genuinely needs those primitives.\n"
       },
       {
         "id": "embedded.page-template",

package/lib/schemas/service-betterportal-theme-embedded.json

@@ -1,7 +1,7 @@
 {
   "pluginName": "service-betterportal-theme-embedded",
   "events": {},
-  "version": "10.1.46",
+  "version": "10.1.47",
   "configSchema": {
     "anyvaliVersion": "1.0",
     "schemaVersion": "1.1",

package/lib/schemas/service-betterportal-theme-embedded.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "service-betterportal-theme-embedded",
   "name": "service-betterportal-theme-embedded",
-  "version": "10.1.46",
+  "version": "10.1.47",
   "description": "Embedded BetterPortal theme",
   "category": "service",
   "tags": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@betterportal/theme-embedded",
-  "version": "10.1.46",
+  "version": "10.1.47",
   "description": "BetterPortal v10 embedded theme plugin for Node.js",
   "main": "lib/index.js",
   "types": "src/index.ts",
@@ -32,9 +32,9 @@
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@betterportal/framework": "10.1.46",
-    "@betterportal/plugin-bsb": "10.1.46",
-    "@betterportal/theme-runtime": "10.1.46",
+    "@betterportal/framework": "10.1.47",
+    "@betterportal/plugin-bsb": "10.1.47",
+    "@betterportal/theme-runtime": "10.1.47",
     "@bsb/base": "^9.6.60",
     "anyvali": "^1.0.6",
     "jsx-htmx": "4.0.0-beta6"