@synopackageland/ui 0.23.6 → 0.23.8

package/docs/color-system.md

@@ -3,7 +3,7 @@
 The theme draws every colour from five 12-step scales built from DSM 7's own
 colours (`src/theme/palette.css`). Components use the semantic tokens
 (`--ui-primary`, `--ui-text-secondary`, …) in `src/theme/dsm7.css`, and each
-of those is one step of a scale. The theme is light only, like DSM 7.
+of those is one step of a scale. The default theme is light, like DSM 7.
 
 ## Scales
 
@@ -110,14 +110,21 @@ step 3, so links and selected labels stay readable on a dark page.
 
 ## Dark theme
 
+In a DSM window, leave AppRoot's `color-scheme` unset and do not set
+`data-ui-color-scheme`. DSM draws the window light, even when the operating
+system prefers dark mode. Do not follow `prefers-color-scheme` in a DSM window.
+Only a full page of the app's own (a portal or its own browser tab) may follow
+that preference.
+
 The dark theme (`src/theme/dark.css`) ships inside `theme.css` and the embedded stylesheets. It applies wherever
 `data-ui-color-scheme="dark"` is set: on the app root (`[data-ui-app]`)
 through `<AppRoot color-scheme="dark">`. With `theme.css` on a page of your own,
 `<html data-ui-color-scheme="dark">` works too; the embedded stylesheets (a DSM
 window) are scoped to the app root and read the attribute only there, never on
 the host's `<html>` (an app with an accent passes `color-scheme="dark"` to
-AppRoot in any case, which derives the accent for it). The library does not follow `prefers-color-scheme` by itself;
-the host decides and sets the attribute.
+AppRoot in any case, which derives the accent for it). The library does not
+follow `prefers-color-scheme` by itself; an app that owns its full page decides
+and sets the attribute.
 
 The same roles, with the light page's sage carried into the greys:
 

package/docs/mobile-native.md

@@ -14,7 +14,8 @@ App. Each line links to its details below.
 | One compact top bar | One 44px row: Back, the menu button or the App icon, the title, at most two icons and one "…". No brand row, no second header row. |
 | No tab heading on tab pages | A page of the tab bar draws no title, icon or brand in the bar (`phone-bar-title="none"`) and no heading of its own: the tab bar says where the user is. A sub-page keeps Back and its title. |
 | Title on a tab page is opt-in | Showing a title on a tab page is the App's explicit choice: `phone-bar-title="auto"` on `AppLayout`, and the SDK AppShell's own opt-in (`phoneTitle`). |
-| Hide on scroll | By `transform` only; the scroller keeps its size, position and padding and nothing writes `scrollTop`, so a momentum fling keeps going. Slow scrolls use distance hysteresis, flicks decide at once. See [Hide on scroll](#native-phone-shell) and [Gesture velocity](#gesture-velocity). |
+| Hide on scroll | By `transform` only; the scroller keeps its size, position and padding and nothing writes `scrollTop`, so a momentum fling keeps going. Slow scrolls use distance hysteresis, flicks decide at once. While the page has scrolled less than the room above its content (the bar's row, a toolbar row, a host header's room), the bars show, a bounce past the top included; a scroll back into that zone shows them before the room shows empty, so the first content never sits below an empty band. See [Hide on scroll](#native-phone-shell) and [Gesture velocity](#gesture-velocity). |
+| Commit footers never hide on scroll | A `SettingsPage` commit footer (Reset / Apply) is out of sight while the form is clean, slides in when it becomes dirty, invalid or saving, and stays in one place through every scroll and fling; Apply, Reset or the form becoming clean slides it out. On a phone it is a compact bar (8px padding, 32px buttons with 14px text and a 44px hit area: 48px plus its divider and the real safe-area inset), the tab bar stays directly under it, and the page's end space includes it so the last field scrolls fully above it. See [Settings footer](#native-phone-shell). |
 | No horizontal pan | The page never pans sideways: the phone layout's content area and page scroller clip `overflow-x`, a `PageHeader`'s last action keeps its tap box inside the header, and `check:phone-layout` asserts `scrollWidth == clientWidth` for the document and the page's scrollers at 320, 360, 390 and 430px and in landscape (825x360, 753x279), also when the scroller is an App's own element in a fill page. An inner horizontal scroller (a table, a tab strip) still scrolls. |
 | Bottom accessory | `#accessory` docks above the tab bar, lifts the FAB and toasts, and slides into the tab bar's place with the bars. |
 | Sticky offsets | `--ui-sticky-top-offset` counts the covered padding, a sticky `PageHeader`, the tabs strip and every `data-ui-sticky` row, so scrolling to an element lands below them. A row in an App's own nested scroller (a side pane, a record pane) sticks below the sticky `PageHeader` and tabs strip in that scroller and counts only there. |
@@ -716,14 +717,20 @@ scrolls natively; the decision reads the shared velocity estimator (see
 [Gesture velocity](#gesture-velocity)) and the distance travelled one way:
 
 - a slow scroll down of `hideDistance` (48px) slides the bar, the tab bar,
-  the FAB and a clean settings footer out (`data-ui-bars-hidden`); a slow
+  and the FAB out (`data-ui-bars-hidden`); a slow
   scroll up of `showDistance` (24px) brings them back, so a slow or wobbly
   drag never flickers them;
 - a flick at `flick` (1000 px/s) or faster hides them, or shows them, at
   once, and they move in 60% of `--ui-motion-bars` (never under 120ms;
   `--ui-bars-motion` on the layout), else in `--ui-motion-bars` (200ms; at
   once with reduced motion);
-- the top of the page and a scroll that stops at its end bring them back.
+- while the page has scrolled less than the room above its content (the
+  top of the content area measured from the layout's column: the bar's row,
+  a toolbar row, a DSM portal header's room), they show whatever the
+  direction or speed, a bounce past the top included; they hide only once
+  content lies under them, and a scroll back into that zone shows them
+  before the room above the content can show empty;
+- a scroll that stops at the page's end brings them back.
 
 The bars move by `transform` only. When the page scrolls in an area under
 the bar (a fill layout, or an App shell whose `main` does not let the
@@ -746,14 +753,20 @@ page that scrolls less than the bars' room never hides them.
 
 - Opt out for the App: `<AppLayout :hide-on-scroll="false">`; for one page:
   `<PageContent :hide-on-scroll="false">`. Both keep the settings footer too.
-- **Settings footer.** A `SettingsPage` footer hides with the bars only while
-  the form is clean: never while it is dirty, invalid or saving, so Apply is
-  in reach after every edit. Set `dirty`, `invalid` and `saving` on the
+- **Settings footer.** On a phone a `SettingsPage` footer is a commit bar
+  and never takes part in hide on scroll. It is out of sight while the form
+  is clean and slides in when the form is dirty, invalid or saving; it then
+  stays in one place through every scroll and fling, and slides out after
+  Apply, Reset or the form becoming clean. While it shows, the tab bar stays
+  directly under it (one bottom edge), and the page's end space includes it,
+  so the last field scrolls fully above it. It moves by `transform` only;
+  the scroller is never resized. Set `dirty`, `invalid` and `saving` on the
   SettingsPage, or let it read them: clean while the footer's primary button
   (every button, without a primary) is disabled, invalid while a field has
-  `aria-invalid="true"`, saving while a footer button is loading. A clean
-  footer stays at rest: it slides away only with the bars, so Reset / Apply
-  never appear or vanish under the finger while the user edits.
+  `aria-invalid="true"`, saving while a footer button is loading. The phone
+  footer is compact: 8px above and below 32px buttons (14px text, 12px side
+  padding), 48px plus its divider and only the real safe-area inset; each button keeps a 44px
+  hit area inside the footer. A DSM window and a desktop are unchanged.
 
 **Bottom accessory.** `AppLayout`'s `#accessory` slot is a bar across the
 bottom of the page for something the App is running (a recording bar, a mini

package/docs/release-checks.md

@@ -8,7 +8,7 @@ checks through the optional build-isolation wrapper.
 
 | Entry point | Default | Explicit full |
 | --- | --- | --- |
-| `npm run gates`, `scripts/gates.mjs` | Internal-content checks, build, lint, typecheck, unit tests, notices, isolated pack and tarball content audit | Adds Chromium installation, responsive/adaptive/date-picker/JSON/host/switch/layout/InfoTip/motion/short-viewport/phone-layout/focus-restore browser checks, Histoire build, exact-tarball registry consumer smoke |
+| `npm run gates`, `scripts/gates.mjs` | Internal-content checks, build, lint, typecheck, unit tests, notices, isolated pack and tarball content audit | Adds Chromium and WebKit installation, responsive/adaptive/date-picker/JSON/host/switch/layout/InfoTip/motion/short-viewport/phone-layout/phone-bars (Chromium and WebKit)/focus-restore browser checks, Histoire build, exact-tarball registry consumer smoke |
 | `pnpm check`, `check:fast` | Basic, with optional Docker host build isolation | `SPL_FULL_GATE=1` selects the same full plan |
 | `fast-ci.yml`, composite verify action | Basic | No automatic extended checks |
 | Disabled CI/release workflow templates | Basic, version/tag/ancestry checks, stage, pack and actual archive audit | No implicit browser or registry consumer smoke |

package/docs/theme-hooks.md

@@ -27,6 +27,11 @@ here stay implementation details and can change in any release.
 
 ### Application root and layout
 
+In a DSM window, leave AppRoot's `color-scheme` unset and do not set
+`data-ui-color-scheme`: DSM draws the window light, even when the operating
+system prefers dark mode. Only a full page of the app's own (a portal or its
+own browser tab) may follow `prefers-color-scheme` (see [Dark theme](color-system.md#dark-theme)).
+
 | Attribute | On | Values |
 | --- | --- | --- |
 | `data-ui-app` | `AppRoot`'s root and its floating hosts (portals) | present |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synopackageland/ui",
-  "version": "0.23.6",
+  "version": "0.23.8",
   "description": "Shared Vue 3 UI component library with a DSM 7 inspired application theme",
   "license": "MIT",
   "type": "module",
@@ -79,34 +79,6 @@
     "@tiptap/vue-3": "3.32.1",
     "zod": "^4.6.5"
   },
-  "devDependencies": {
-    "@eslint/js": "10.0.1",
-    "@histoire/plugin-vue": "1.0.0-beta.1",
-    "@tailwindcss/vite": "4.3.3",
-    "@tanstack/vue-virtual": "3.13.39",
-    "@vitejs/plugin-vue": "6.0.9",
-    "@vue/test-utils": "2.5.1",
-    "@vueuse/core": "14.4.0",
-    "eslint": "10.11.0",
-    "eslint-plugin-vue": "10.11.1",
-    "flexsearch": "0.8.212",
-    "globals": "17.12.0",
-    "histoire": "1.0.0-beta.1",
-    "jsdom": "30.1.1",
-    "playwright": "1.58.2",
-    "reka-ui": "2.11.0",
-    "tailwindcss": "4.3.3",
-    "typescript": "5.9.3",
-    "typescript-eslint": "8.71.0",
-    "vite": "7.3.6",
-    "vite-plugin-dts": "5.1.1",
-    "vitest": "5.0.2",
-    "vscode-oniguruma": "2.0.1",
-    "vscode-textmate": "9.3.2",
-    "vue": "3.5.43",
-    "vue-eslint-parser": "10.4.1",
-    "vue-tsc": "3.3.11"
-  },
   "engines": {
     "node": ">=20"
   },
@@ -117,62 +89,5 @@
       "reka-ui": "2.11.0"
     }
   },
-  "homepage": "https://www.varvis.me/docs/",
-  "scripts": {
-    "check:docs": "node --test scripts/check-doc-versions.test.mjs && node scripts/check-doc-versions.mjs",
-    "dev": "vite build --watch",
-    "build": "vite build && vite build --mode json && vite build --mode rich-text && vite build --mode grid && vite build --mode cli && vite build --mode preview && vite build --mode embedded && node scripts/postbuild.mjs",
-    "lint": "eslint .",
-    "typecheck": "vue-tsc --noEmit -p tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:changed": "echo \"test:changed skips the tests the changes since ${SYNOPKGLAND_GATE_BASE:-origin/master} do not reach (vitest --changed); pnpm check runs them all\" && vitest run --changed ${SYNOPKGLAND_GATE_BASE:-origin/master}",
-    "story": "histoire dev",
-    "story:build": "histoire build",
-    "check:host": "node scripts/dsm-host-shots.mjs",
-    "check:switch": "node scripts/check-switch.mjs",
-    "check:tabs": "node scripts/check-tabs.mjs",
-    "check:mobile": "node scripts/check-mobile-overflow.mjs",
-    "check:ui-patch": "node scripts/check-ui-patch.mjs",
-    "check:narrow": "node scripts/check-narrow-controls.mjs",
-    "check:drawer-form": "node scripts/check-drawer-form.mjs",
-    "check:responsive": "node scripts/check-responsive.mjs",
-    "check:adaptive": "node scripts/check-adaptive.mjs",
-    "check:sidebar-focus": "node scripts/check-sidebar-focus.mjs",
-    "check:json-render": "node scripts/check-json-render.mjs",
-    "check:motion": "node scripts/check-motion.mjs",
-    "check:topology": "node scripts/check-topology.mjs",
-    "check:wizard": "node scripts/check-wizard.mjs",
-    "check:edges": "node scripts/check-edges.mjs",
-    "check:data-grid": "node scripts/check-data-grid.mjs",
-    "check:truncation": "node scripts/check-truncation.mjs",
-    "check:link": "node scripts/check-link.mjs",
-    "check:text-select": "node scripts/check-text-select.mjs",
-    "check:date-picker": "node scripts/check-date-picker.mjs",
-    "check:full-page": "node scripts/check-full-page.mjs",
-    "check:short-viewport": "node scripts/check-short-viewport.mjs",
-    "check:phone-layout": "node scripts/check-phone-layout.mjs",
-    "check:text-zoom": "node scripts/check-text-zoom.mjs",
-    "check:focus-restore": "node scripts/check-focus-restore.mjs",
-    "check:detail-surface": "node scripts/check-detail-surface.mjs",
-    "check:internal": "node --test scripts/check-internal-content.test.mjs scripts/check-npm-metadata.test.mjs && node scripts/check-internal-content.mjs --repo .",
-    "check:npm-metadata": "node scripts/check-npm-metadata.mjs",
-    "check:package": "node scripts/check-package-content.mjs",
-    "check:public-api-consumer": "node scripts/check-public-api-consumer.mjs",
-    "notices:update": "node scripts/third-party-notices.mjs --write",
-    "notices:check": "node scripts/third-party-notices.mjs --check",
-    "check": "bash scripts/docker-check.sh \"npm run gates\"",
-    "check:fast": "bash scripts/docker-check.sh \"npm run gates\"",
-    "check:local-browser": "node scripts/app-local-browser.mjs",
-    "check:infotip": "node scripts/check-infotip.mjs",
-    "release:stage": "node scripts/stage-release.mjs",
-    "check:polish": "bash scripts/docker-check.sh --build --out .polish-shots 'node scripts/check-polish.mjs'",
-    "check:acceptance": "node scripts/check-acceptance.mjs",
-    "check:palette": "node scripts/check-palette.mjs",
-    "gates": "node scripts/gates.mjs",
-    "gates:full": "node scripts/gates.mjs --full",
-    "check:layout": "node scripts/check-layout.mjs",
-    "release:smoke": "node scripts/release-smoke.mjs",
-    "check:browser-install": "playwright install chromium"
-  }
-}
+  "homepage": "https://www.varvis.me/docs/"
+}