cabloy 5.1.100 → 5.1.102

package/.cabloy-version

@@ -1 +1 @@
-5.1.100
+5.1.102

package/.gitignore

@@ -37,6 +37,7 @@ vona/.zova-rest
 **/.temp-dynamic-*
 **/quasar.config.*.temporary.compiled*
 zova/.zova
+zova/.zova-rest
 zova/.quasar
 
 **/src-cordova/node_modules

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 5.1.102
+
+### Features
+
+- Keep the upgrade dry-run plan for the current version.
+- Extend Cabloy Basic upgrade overwrite suites.
+
+## 5.1.101
+
+### Features
+
+- Add update functionality.
+- Add update enhancements.
+
 ## 5.1.100
 
 ### Improvements

package/cabloy-docs/frontend/use-state-data-best-practices.md

@@ -347,15 +347,16 @@ Representative files in the Cabloy Basic frontend:
 - `getUploadPolicy(...)` stays in the model
 - the query is created as formal state instead of a one-off click helper
 - `disableSuspenseOnInit: true` skips the automatic init-time `query.suspense()` kick while preserving the query as formal state
-- render derives `acceptAttr`, `multiple`, and `pending`
-- interaction reuses that state
+- upload policy still uses normal async freshness semantics here because the model method does not set `staleTime: Infinity`
+- render establishes and derives `acceptAttr`, `multiple`, and `pending` from that query-backed state
+- interaction reuses that same state
 - interaction may still `await query.suspense()` on the already-created query if an edge timing window requires it
 
 Why this is a good fit:
 
 - upload policy is a real query-backed state
-- it is relatively stable within the current frontend process
-- every first consumer does not need to auto-kick one eager init-time refresh semantic
+- it is stable enough that every first consumer does not need to auto-kick one eager init-time refresh semantic
+- it should still keep normal async freshness behavior rather than being frozen through `staleTime: Infinity`
 - the strict-ready moment is the interaction boundary, not every initial render consumer
 
 Taken together, Example A and Example B show the most important design contrast on this page:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cabloy",
-  "version": "5.1.100",
+  "version": "5.1.102",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A Node.js fullstack framework",
   "keywords": [

package/scripts/upgrade.ts

@@ -47,6 +47,14 @@ const OVERWRITE_DIRS: string[] = [
   'zova/scripts',
 ];
 
+const OVERWRITE_DIRS_CABLOY_BASIC: string[] = [
+  'vona/src/suite/cabloy-basic',
+  'vona/src/suite/a-training',
+  'zova/src/suite/cabloy-basic',
+  'zova/src/suite/a-training',
+  'zova/src/suite/a-devui',
+];
+
 const MERGE_DIRS: string[] = [
   // Claude project assets
   '.claude/commands',
@@ -242,8 +250,12 @@ async function downloadAndExtract(tarballUrl: string): Promise<void> {
 // --- Step 3: Selective overwrite ---
 
 function selectiveOverwrite(dryRun?: boolean): void {
+  const overwriteDirs = existsSync(resolve(ROOT_DIR, '__CABLOY_BASIC__'))
+    ? [...OVERWRITE_DIRS, ...OVERWRITE_DIRS_CABLOY_BASIC]
+    : OVERWRITE_DIRS;
+
   // Overwrite directories
-  for (const dir of OVERWRITE_DIRS) {
+  for (const dir of overwriteDirs) {
     const src = resolve(TEMP_DIR, dir);
     const dest = resolve(ROOT_DIR, dir);
     if (!existsSync(src)) continue;
@@ -316,13 +328,12 @@ function runInitTestData(dryRun: boolean): void {
 // --- Step 6: Cleanup ---
 
 function cleanup(dryRun?: boolean): void {
-  if (dryRun) {
-    log('  [dry-run] Remove temp dir: node_modules/.cabloy-upgrade/');
-    return;
-  }
   if (existsSync(TEMP_DIR)) {
     rmSync(TEMP_DIR, { recursive: true, force: true });
   }
+  if (dryRun) {
+    log('  [dry-run] Removed temp dir: node_modules/.cabloy-upgrade/');
+  }
 }
 
 // --- Main ---
@@ -350,15 +361,20 @@ async function main(): Promise<void> {
   if (currentVersion) {
     const comparison = compareVersions(currentVersion, latestPackageInfo.version);
     if (comparison === 0) {
-      log(`Cabloy is already up to date (current: ${currentVersion}). Skipping upgrade.`);
-      return;
-    }
-    if (comparison > 0) {
+      if (!dryRun) {
+        log(`Cabloy is already up to date (current: ${currentVersion}). Skipping upgrade.`);
+        return;
+      }
+      log(
+        `Cabloy is already up to date (current: ${currentVersion}). Continuing dry-run to show overwrite plan.\n`,
+      );
+    } else if (comparison > 0) {
       throw new Error(
         `Project Cabloy version ${currentVersion} is newer than npm latest ${latestPackageInfo.version}. Aborting upgrade.`,
       );
+    } else {
+      log(`Upgrading Cabloy from ${currentVersion} to ${latestPackageInfo.version}...\n`);
     }
-    log(`Upgrading Cabloy from ${currentVersion} to ${latestPackageInfo.version}...\n`);
   } else {
     log(`Upgrading Cabloy to ${latestPackageInfo.version}...\n`);
   }

package/zova/src/suite/cabloy-basic/modules/basic-file/src/bean/tableCell.file.tsx

@@ -101,11 +101,27 @@ export class TableCellFile extends BeanBase implements ITableCellRender {
   ) {
     const fieldTitle = renderContext.$celScope.property?.title ?? renderContext.$celScope.name;
     const placeholder = this.scope.locale.DownloadFile();
+    const selectBackgroundColor = 'var(--color-base-100)';
+    const selectColor = 'var(--color-base-content)';
+    const optionStyle = {
+      backgroundColor: selectBackgroundColor,
+      color: selectColor,
+    };
+    const placeholderOptionStyle = {
+      backgroundColor: selectBackgroundColor,
+      color: `color-mix(in oklch, ${selectColor} 60%, transparent)`,
+    };
+    const selectStyle = {
+      colorScheme: this.$theme.dark ? 'dark' : 'light',
+      backgroundColor: selectBackgroundColor,
+      color: selectColor,
+    };
     return (
       <span class="relative inline-flex min-w-0 max-w-full items-center">
         <span class="inline-flex min-w-0 max-w-full items-center">{contentNode}</span>
         <select
           class="absolute inset-0 h-full w-full cursor-pointer opacity-0"
+          style={selectStyle}
           aria-label={fieldTitle}
           title={placeholder}
           onClick={event => {
@@ -125,9 +141,16 @@ export class TableCellFile extends BeanBase implements ITableCellRender {
             this._openDownloadUrl(selectedItem.downloadUrl);
           }}
         >
-          <option value="">{placeholder}</option>
+          <option value="" style={placeholderOptionStyle}>
+            {placeholder}
+          </option>
           {items.map(item => (
-            <option key={item.key} value={item.key} disabled={!item.downloadUrl}>
+            <option
+              key={item.key}
+              value={item.key}
+              disabled={!item.downloadUrl}
+              style={optionStyle}
+            >
               {item.label}
             </option>
           ))}