create-lupine 1.0.20 → 1.0.22

package/index.js

@@ -94,6 +94,55 @@ const TEMPLATES = [
 ];
 
 async function init() {
+  console.log('Fetching latest versions...');
+  const versions = {
+    'lupine.api': getLatestVersion('lupine.api', '^1.0.1'),
+    'lupine.web': getLatestVersion('lupine.web', '^1.0.1'),
+    'lupine.components': getLatestVersion('lupine.components', '^1.0.1'),
+    'lupine.press': getLatestVersion('lupine.press', '^1.0.1')
+  };
+
+  if (argv['update-version']) {
+    const targetPkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(targetPkgPath)) {
+      console.log(red('✖ No package.json found in current directory.'));
+      return;
+    }
+
+    let pkg;
+    try {
+      pkg = JSON.parse(fs.readFileSync(targetPkgPath, 'utf-8'));
+    } catch (e) {
+      console.log(red('✖ Failed to parse package.json.'));
+      return;
+    }
+
+    let updated = false;
+    ['dependencies', 'devDependencies', 'peerDependencies'].forEach(depType => {
+      if (pkg[depType]) {
+        for (const [name, latestVer] of Object.entries(versions)) {
+          if (pkg[depType][name]) {
+            if (pkg[depType][name] !== latestVer) {
+              console.log(`${green('Upgrading')} ${name}: ${pkg[depType][name]} -> ${latestVer}`);
+              pkg[depType][name] = latestVer;
+              updated = true;
+            } else {
+              console.log(`${name} is already at latest version (${latestVer}).`);
+            }
+          }
+        }
+      }
+    });
+
+    if (updated) {
+      fs.writeFileSync(targetPkgPath, JSON.stringify(pkg, null, 2) + '\n');
+      console.log(green('\n✔ package.json updated successfully. Please run "npm install" to apply changes.'));
+    } else {
+      console.log(green('\n✔ All target packages are already up-to-date.'));
+    }
+    return;
+  }
+
   let targetDir = argv._[0];
   let template = argv.template || argv.t;
 
@@ -257,20 +306,14 @@ async function init() {
     },
   };
 
-  console.log('Fetching latest versions...');
-  const latestApi = getLatestVersion('lupine.api', '^1.0.1');
-  const latestWeb = getLatestVersion('lupine.web', '^1.0.1');
-  const latestComponents = getLatestVersion('lupine.components', '^1.0.1');
-  const latestPress = getLatestVersion('lupine.press', '^1.0.1');
-
   pkg.dependencies = {
-    'lupine.api': latestApi,
-    'lupine.components': latestComponents,
-    'lupine.web': latestWeb,
+    'lupine.api': versions['lupine.api'],
+    'lupine.components': versions['lupine.components'],
+    'lupine.web': versions['lupine.web'],
   };
 
   if (templateObj && templateObj.needsPress) {
-    pkg.dependencies['lupine.press'] = latestPress;
+    pkg.dependencies['lupine.press'] = versions['lupine.press'];
     pkg.devDependencies['gray-matter'] = '^4.0.3';
     pkg.devDependencies['marked'] = '^17.0.1';
     pkg.scripts['cp-docs'] = `node dev/cp-folder.js dist/server_root/${appName}_web/github-pj-name docs`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-lupine",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "description": "Scaffolding tool for Lupine.js projects",
   "bin": {
     "create-lupine": "index.js"

package/templates/common/AI_CONTEXT.md

@@ -1,5 +1,13 @@
 # AI Context for Lupine.js
 
+**[CRITICAL SAFEGUARDS FOR CODE MODIFICATION]**
+When performing multi-line code refactoring or replacement operations (`replace_file_content` / `multi_replace_file_content`), massive block-level overwrites and arbitrary code restructuring are **STRICTLY PROHIBITED**!
+
+- Before making any modifications, you MUST invoke `view_file` or `grep_search` to verify the exact, up-to-date file structure and line numbers.
+- The `StartLine` and `EndLine` range MUST be restricted strictly to the absolute minimum lines you intend to modify or delete.
+- If you are merely inserting new code (e.g., adding a button or appending logic), target ONLY the immediately preceding line or bracket as your anchor. You are strictly forbidden from wrapping innocent, unmodified surrounding code into the `Replacement` payload. Violating this red line causes severe production accidents!
+
+
 **SYSTEM ROLE**: You are an expert developer in `lupine.js`, a custom TypeScript full-stack framework.
 
 **🛑 CRITICAL WARNINGS 🛑**
@@ -62,6 +70,32 @@ Supports nesting and media queries. **Prefer this over inline styles.** Define y
 
 **NEVER hardcode colors** (e.g., `#000`, `#fff`, `#f0f0f0`). Always use CSS variables to support Dark/Light modes. If you must use a fallback, wrap it: `var(--primary-bg-color, #fff)`.
 
+**Defining Variables for Modes in CSS-in-JS**:
+Since Lupine.js uses a CSS-in-JS styling approach, when you need to define or override CSS variables specifically for light and dark modes within a component, use the `[data-theme="light" i]` and `[data-theme="dark" i]` selectors. **CRITICAL**: Because `CssProps` scopes styles by default, you MUST separate these mode styles into their own object and bind them using `bindGlobalStyle` with `noTopClassName = true` (the 4th argument).
+
+```typescript
+// 1. Separate theme variables into their own CSS object
+const cssTheme: CssProps = {
+  '[data-theme="light" i]': {
+    '--my-comp-bg-color': '#e6e6e6',
+  },
+  '[data-theme="dark" i]': {
+    '--my-comp-bg-color': 'var(--primary-accent-color)',
+  },
+};
+// 2. Bind globally. Param 4 (noTopClassName) MUST be true to prevent injecting a namespace prefix.
+bindGlobalStyle('my-comp-theme', cssTheme, false, true);
+
+// 3. Use the variable in your standard component styles
+const css: CssProps = {
+  '.&-element': {
+    backgroundColor: 'var(--my-comp-bg-color)',
+  }
+};
+// Bind your component styles normally
+bindGlobalStyle('my-comp-main', css);
+```
+
 #### 🎨 Color Variable Semantics (CRITICAL FOR DARK MODE)
 
 1.  **Backgrounds (`--primary-bg-color` vs `--secondary-bg-color`)**:

package/templates/common/apps/server/src/app-loader.ts

@@ -1,41 +1,4 @@
-import { fork, ChildProcess } from 'child_process';
+import { appLoader } from 'lupine.api/app-loader';
 import path from 'path';
 
-let app: ChildProcess | null = null;
-const startApp = () => {
-  console.log('Loader: starting app...');
-  app = fork(path.join(__dirname, './index.js'), [], {
-    env: { ...process.env, FROM_LOADER: '1' },
-  });
-
-  // child->parent
-  app.on('message', async (msg: any) => {
-    if (msg?.id === 'debug' && msg?.message === 'restartApp') {
-      console.log('Loader: app requested restart.');
-      await restartApp();
-    }
-  });
-
-  // child exit
-  app.on('exit', (code) => {
-    console.log('Loader: app exited with code', code);
-  });
-};
-
-const restartApp = async () => {
-  if (!app) return;
-
-  return new Promise<void>((resolve) => {
-    console.log('Loader: sending shutdown to app...');
-    app!.send({ id: 'debug', message: 'shutdown' });
-
-    // wait for app.ts to exit
-    app!.once('exit', () => {
-      console.log('Loader: app fully exited, restarting...');
-      startApp();
-      resolve();
-    });
-  });
-};
-
-startApp();
+appLoader.startApp(path.join(__dirname, './index.js'));

package/templates/common/tsconfig.json

@@ -31,15 +31,15 @@
 
     /* Modules */
     // "module": "commonjs", amd, es2015 /* Specify what module code is generated. */,
-    "module": "amd" /* Specify what module code is generated. */,
+    "module": "esnext" /* Specify what module code is generated. */,
     // "rootDir": "./" /* Specify the root folder within your source files. */,
-    "moduleResolution": "node" /* Specify how TypeScript looks up a file from a given module specifier. */,
+    "moduleResolution": "bundler" /* Specify how TypeScript looks up a file from a given module specifier. */,
     // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
     // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
     // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
     // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
     // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
-    "types": ["node", "lupine.web"],
+    "types": ["node"],
     // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
     // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
     // "resolveJsonModule": true /* Enable importing .json files. */,
@@ -56,7 +56,7 @@
     // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
     "sourceMap": true /* Create source map files for emitted JavaScript files. */,
     // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
-    "outFile": "../dist/build.js",
+    // "outFile": "../dist/build.js",
     "outDir": "../dist" /* Specify an output folder for all emitted files. */,
     // "removeComments": true,                           /* Disable emitting comments. */
     // "noEmit": true,                                   /* Disable emitting files from a compilation. */

package/templates/lupine-template-hello-world/lupine.json

@@ -1,5 +1,5 @@
 {
-  "name": "hello-world",
+  "name": "lupine-template-hello-world",
   "webEntryPoints": [
     {
       "index": "web/src/index.tsx",