cabloy 5.1.247 → 5.1.249

package/.cabloy-version

@@ -1 +1 @@
-5.1.247
+5.1.249

package/.vscode/settings.json

@@ -39,6 +39,5 @@
   // watcher
   "files.watcherExclude": {
     "node_modules": true
-  },
-  "textlint.autoFixOnSave": true
+  }
 }

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 5.1.249
+
+### Features
+
+- Update existing functionality.
+
+### Improvements
+
+- Remove textlint.
+
+## 5.1.248
+
+### Features
+
+- Add tab closing.
+- Add mobile navbar support.
+- Add update functionality.
+
+### Bug Fixes
+
+- Fix teleport behavior.
+
+### Improvements
+
+- Support two-level tabs on mobile.
+- Improve compact hints.
+
 ## 5.1.247
 
 ### Improvements

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cabloy",
-  "version": "5.1.247",
+  "version": "5.1.249",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A Node.js fullstack framework",
   "keywords": [
@@ -69,7 +69,6 @@
     "docs:dev": "pnpm --dir repo-docs docs:dev",
     "docs:build": "pnpm --dir repo-docs docs:build",
     "docs:preview": "pnpm --dir repo-docs docs:preview",
-    "docs:fix": "textlint --fix ./repo-docs/**/*.md",
     "release-patch": "node scripts/release.ts patch",
     "release-minor": "node scripts/release.ts minor",
     "release-major": "node scripts/release.ts major",
@@ -101,11 +100,6 @@
     "oxfmt": "^0.74.0",
     "oxlint": "^1.89.0",
     "tar": "^7.5.22",
-    "textlint": "^15.7.0",
-    "textlint-rule-en-no-mixed-period": "^3.0.2",
-    "textlint-rule-ja-no-mixed-period": "^3.0.2",
-    "textlint-rule-ja-space-between-half-and-full-width": "^2.4.2",
-    "textlint-rule-period-in-list-item": "^1.0.1",
     "typescript": "^5.9.3"
   },
   "engines": {

package/repo-docs/frontend/column-configuration-guide.md

@@ -29,7 +29,9 @@ A schema can pin a column to the `left`, `center`, or `right` region. The Move U
 
 A user cannot change a column's fixed region through Column Configuration. The row-selection column is also a runtime-generated column and is never saved in a personal layout.
 
-In Cabloy Basic, a table container narrower than `768px` temporarily disables actual column pinning and presents row operations through a compact popover. This does **not** change a column's schema-defined region or the reorder boundaries in Column Configuration. Saved widths, visibility, and order remain canonical; widening the container restores them. Responsive transitions do not save or reset the profile. Direct Basic `ZTable` consumers can set `compactBreakpoint` to another numeric threshold or `false` to disable this automatic presentation. See [Narrow-container behavior in Cabloy Basic](/frontend/table-guide#narrow-container-behavior-in-cabloy-basic).
+In Cabloy Basic and Cabloy Start, the default UI adapters temporarily disable actual column pinning and present row operations through a compact popover when the available container is narrower than `768px`. This does **not** change a column's schema-defined region or the reorder boundaries in Column Configuration. Saved widths, visibility, and order remain canonical; widening the container restores them. Responsive transitions do not save or reset the profile. Set `compactBreakpoint` to another numeric threshold or `false` to disable automatic presentation: on Basic's `ZTable`, or on Start's `start-page:blockTable` / `start-details:blockTable`. See [Basic narrow-container behavior](/frontend/table-guide#narrow-container-behavior-in-cabloy-basic) and [Start narrow-container behavior](/frontend/table-guide#narrow-container-behavior-in-cabloy-start).
+
+When the resolved SSR cache policy emits `public, max-age=${expires}`, SSR omits `compactHint` entirely, and server HTML and initial hydration default to neutral desktop presentation for every User-Agent. The cache policy stays unchanged, with no `Vary: User-Agent` or CDN variation requirement. Outside that public-cache branch—including session/no-store responses, development, and `responseCache: false`—SSR provisionally selects compact presentation from a request User-Agent mobile hint and transfers the same value for initial hydration. In both branches, measured container width takes over afterward; this never updates the personal layout. The hint does not measure the container or apply a custom numeric breakpoint on the server. `compactBreakpoint: false` disables both provisional and measured compact presentation. See the table-guide sections above for closed-menu and browser-capability behavior.
 
 ## User workflow
 

package/repo-docs/frontend/table-guide.md

@@ -182,9 +182,34 @@ import { ZTable } from 'zova-module-basic-table';
 <ZTable data={this.students} schema={this.schemaRow} compactBreakpoint={false} />;
 ```
 
-The default resource-page and details-table blocks inherit this behavior. DOM measurement starts after mounting and initial SSR hydration, so server HTML and the hydration-time initial render use the same presentation. The popover uses the browser's native Popover API to escape table overflow clipping; browsers without that API retain the existing inline actions rather than showing an unusable trigger.
+The default resource-page and details-table blocks inherit this behavior. When the resolved SSR cache policy emits `public, max-age=${expires}`, SSR omits `compactHint` entirely for every User-Agent. Server HTML and the hydration-time initial render both default to neutral desktop presentation. This keeps the compact presentation independent of User-Agent for public cached HTML, preserves the cache policy, and adds no `Vary: User-Agent` or CDN variation requirement.
 
-This automatic container policy belongs to the **Cabloy Basic UI adapter**. Do not assume Cabloy Start has the same presentation or breakpoint merely because the editions share the table engine.
+For responses outside that public-cache branch—including session/no-store responses, development, and `responseCache: false`—SSR uses a request User-Agent mobile hint for provisional compact presentation and transfers the same value for initial hydration. The hint reduces typical mobile first-paint layout changes; it cannot measure the container or predict tablet mode or every browser accurately.
+
+In both branches, measured container width becomes authoritative after mounting and initial hydration: a mobile request in a wide container uses desktop presentation, while any request in a narrow container becomes compact. `compactBreakpoint: false` disables both provisional and measured compact presentation; a custom numeric threshold applies to actual measurements, not to the provisional mobile classification. SPA startup uses the existing mounted measurement without a server hint.
+
+The popover uses the browser's native Popover API to escape table overflow clipping. Compact action panels stay hidden before hydration, including in unsupported browsers; post-hydration capability detection restores the existing inline actions when the API is unavailable rather than leaving an unusable trigger.
+
+## Narrow-container behavior in Cabloy Start
+
+Cabloy Start's `start-page:blockTable` and `start-details:blockTable` provide the same temporary compact policy through their Vuetify adapters. Each block observes its available container width after mounting and initial SSR hydration. The Vuetify table wrapper continues to own horizontal scrolling; the observer does not measure the table's intrinsic content width.
+
+Below the default `768px` threshold:
+
+- columns, including row selection, temporarily stop being pinned;
+- columns rendered by `start-table:actionOperationsRow` or `start-details:actionOperationsRow` use an approximately `80px` Operations column and a **More actions** popover;
+- widening the container restores schema-defined pinning and schema or personal-layout widths, without saving or resetting the layout.
+
+Configure the threshold on the owning Start block, rather than on the shared `a-table` engine:
+
+```ts
+ZovaRender.block('start-page:blockTable', { compactBreakpoint: 640 });
+ZovaRender.block('start-details:blockTable', { compactBreakpoint: false });
+```
+
+The popover retains the original Start action renderers and their permission checks, confirmations, loading, duplicate-click protection, errors, and retries. Clicking an enabled action closes the popover **before** the original action runs; keyboard activation follows the same path. Closing does not unmount a pending action. Escape closes the popover and restores trigger focus; scrolling outside it or resizing closes it as well.
+
+Start uses Vuetify `VMenu` for connected positioning, outside-click dismissal, keyboard handling, and scroll dismissal, not Basic's native Popover API or DaisyUI presentation. Its eager menu host retains the same action subtree through closure and desktop/compact transitions. SSR and initial hydration use the same cache-policy-dependent provisional presentation described above. In compact presentation, the retained actions are staged hidden until the menu host exists, then move into that host without a visible inline-action flash or remount; desktop actions stay inline. Post-hydration container measurement takes over, and native Popover API support is not required. The shared table engine consumes `compact` and `columnSizing`; it does not itself supply automatic measurement or an edition's row-action UI.
 
 ## Step 3: Let schema metadata drive the default columns
 

package/repo-e2e/specs/a-commerce.spec.ts

@@ -1740,6 +1740,38 @@ test(
         'data-zova-hydrated',
         'commerceAdmin',
       );
+      // Commerce Admin consumes the same task shell: its current create task
+      // remains reachable through the bounded, keyboard-operable compact list.
+      const tabItems = adminPage.getByTestId('tab-items');
+      const allTabs = adminPage.getByTestId('tab-items-more');
+      const tabList = adminPage.getByTestId('tab-items-list');
+      await expect(tabItems).toHaveAttribute('data-compact', 'false');
+      await expect(tabItems.getByRole('tab')).toHaveCount(1);
+      await expect(tabItems.getByRole('tab')).toHaveAttribute('aria-selected', 'true');
+      await adminPage.setViewportSize({ width: 320, height: 900 });
+      await expect(tabItems).toHaveAttribute('data-compact', 'true');
+      await expect(tabItems.getByRole('tab')).toHaveCount(1);
+      await expect(tabItems.getByRole('tab')).toHaveAttribute('aria-selected', 'true');
+      await expect(allTabs).toHaveAccessibleName('All tabs');
+      await allTabs.focus();
+      await allTabs.press('Enter');
+      await expect(tabList).toBeVisible();
+      await expect(tabList).toHaveAttribute('role', 'group');
+      await expect(tabList).toHaveAccessibleName('All tabs');
+      await expect(tabList.locator('.tab-items-select')).toHaveCount(1);
+      await expect(tabList.locator('.tab-items-select')).toHaveAttribute('aria-current', 'page');
+      await expect(tabList.locator('.tab-items-select')).toBeFocused();
+      const popupBox = (await tabList.boundingBox())!;
+      expect(popupBox.x).toBeGreaterThanOrEqual(-1);
+      expect(popupBox.x + popupBox.width).toBeLessThanOrEqual(321);
+      expect(popupBox.y).toBeGreaterThanOrEqual(-1);
+      expect(popupBox.y + popupBox.height).toBeLessThanOrEqual(901);
+      await adminPage.keyboard.press('Escape');
+      await expect(tabList).toBeHidden();
+      await expect(allTabs).toBeFocused();
+      await adminPage.setViewportSize({ width: 1440, height: 900 });
+      await expect(tabItems).toHaveAttribute('data-compact', 'false');
+
       for (const groupName of [
         'Basic Information',
         'Discount Policy',