@betterportal/theme-embedded 10.1.66 → 10.1.68

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.
Files changed (5) hide show
  1. package/bp-resources/ui-guide.md +1 -0
  2. package/lib/bp-contracts/org.betterportal.theme.embedded.json +2 -2
  3. package/lib/schemas/service-betterportal-theme-embedded.json +1 -1
  4. package/lib/schemas/service-betterportal-theme-embedded.plugin.json +1 -1
  5. package/package.json +6 -6
package/bp-resources/ui-guide.md CHANGED
@@ -8,6 +8,7 @@ The Embedded theme renders BetterPortal service content inside a lightweight hos
8
8
  - Use semantic HTML, visible labels, keyboard-operable controls and responsive wrapping.
9
9
  - Prefer one column. Avoid persistent navigation, wide tables, fixed positioning and viewport-sized panels.
10
10
  - 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()`.
11
+ - Plain internal `<a href="/route">` links and GET/POST forms are automatically upgraded to HTMX and routed through the owning service. A bare `<form>` posts to the current service view. Use `bp-no-override` or `data-bp-no-override` on an element or ancestor only when native browser behavior is intentional.
11
12
  - Use normal forms and HTMX swaps. Provide loading, empty, validation and error states.
12
13
  - Use `hx-download` for authenticated files and `HX-Trigger` events for passive refresh.
13
14
  - Do not add a SPA framework, iframe, client router, state library or hardcoded service URL.
package/lib/bp-contracts/org.betterportal.theme.embedded.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "pluginId": "org.betterportal.theme.embedded",
5
5
  "title": "Embedded Theme",
6
6
  "description": "Minimal htmx theme for embedding BetterPortal content without iframes.",
7
- "version": "10.1.66",
7
+ "version": "10.1.68",
8
8
  "category": "theme",
9
9
  "deploymentModes": [
10
10
  "self-hosted"
@@ -33,7 +33,7 @@
33
33
  "title": "Embedded UI guide",
34
34
  "description": "Compact layout, HTMX and accessibility rules for embedded views.",
35
35
  "mediaType": "text/markdown; charset=utf-8",
36
- "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"
36
+ "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- Plain internal `<a href=\"/route\">` links and GET/POST forms are automatically upgraded to HTMX and routed through the owning service. A bare `<form>` posts to the current service view. Use `bp-no-override` or `data-bp-no-override` on an element or ancestor only when native browser behavior is intentional.\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"
37
37
  },
38
38
  {
39
39
  "id": "embedded.skill",
package/lib/schemas/service-betterportal-theme-embedded.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "pluginName": "service-betterportal-theme-embedded",
3
3
  "events": {},
4
- "version": "10.1.66",
4
+ "version": "10.1.68",
5
5
  "configSchema": {
6
6
  "anyvaliVersion": "1.0",
7
7
  "schemaVersion": "1.1",
package/lib/schemas/service-betterportal-theme-embedded.plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "service-betterportal-theme-embedded",
3
3
  "name": "service-betterportal-theme-embedded",
4
- "version": "10.1.66",
4
+ "version": "10.1.68",
5
5
  "description": "Embedded BetterPortal theme",
6
6
  "category": "service",
7
7
  "tags": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@betterportal/theme-embedded",
3
- "version": "10.1.66",
3
+ "version": "10.1.68",
4
4
  "description": "BetterPortal v10 embedded theme plugin for Node.js",
5
5
  "main": "lib/index.js",
6
6
  "types": "src/index.ts",
@@ -26,16 +26,16 @@
26
26
  "license": "(AGPL-3.0-only OR Commercial)",
27
27
  "type": "module",
28
28
  "devDependencies": {
29
- "@bsb/tests": "^9.6.69",
29
+ "@bsb/tests": "^9.6.70",
30
30
  "@types/node": "^26.0.0",
31
31
  "tsx": "^4.21.0",
32
32
  "typescript": "^6.0.3"
33
33
  },
34
34
  "dependencies": {
35
- "@betterportal/framework": "10.1.66",
36
- "@betterportal/plugin-bsb": "10.1.66",
37
- "@betterportal/theme-runtime": "10.1.66",
38
- "@bsb/base": "^9.6.69",
35
+ "@betterportal/framework": "10.1.68",
36
+ "@betterportal/plugin-bsb": "10.1.68",
37
+ "@betterportal/theme-runtime": "10.1.68",
38
+ "@bsb/base": "^9.6.70",
39
39
  "anyvali": "^1.0.6",
40
40
  "jsx-htmx": "4.0.0-beta6"
41
41
  },