zero-query 0.9.7 → 0.9.9

package/tests/cli.test.js

@@ -454,3 +454,307 @@ describe('CLI — flag/option extra', () => {
     expect(flag('watch', 'w')).toBe(true);
   });
 });
+
+
+// ===========================================================================
+// createProject — scaffold command
+// ===========================================================================
+
+describe('CLI — createProject', () => {
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+
+  let createProject;
+
+  beforeEach(async () => {
+    vi.resetModules();
+    const mod = await import('../cli/commands/create.js');
+    createProject = mod.default || mod;
+  });
+
+  function tmpDir() {
+    const dir = path.join(os.tmpdir(), 'zq-create-' + Date.now() + '-' + Math.random().toString(36).slice(2, 8));
+    fs.mkdirSync(dir, { recursive: true });
+    return dir;
+  }
+
+  function cleanup(dir) {
+    if (fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
+  }
+
+  // -- scaffold variant directories exist --
+
+  it('default scaffold directory exists', () => {
+    const dir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'default');
+    expect(fs.existsSync(dir)).toBe(true);
+  });
+
+  it('minimal scaffold directory exists', () => {
+    const dir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal');
+    expect(fs.existsSync(dir)).toBe(true);
+  });
+
+  // -- default scaffold contains expected files --
+
+  it('default scaffold has index.html', () => {
+    const f = path.resolve(__dirname, '..', 'cli', 'scaffold', 'default', 'index.html');
+    expect(fs.existsSync(f)).toBe(true);
+  });
+
+  it('default scaffold has app/app.js', () => {
+    const f = path.resolve(__dirname, '..', 'cli', 'scaffold', 'default', 'app', 'app.js');
+    expect(fs.existsSync(f)).toBe(true);
+  });
+
+  it('default scaffold has app/routes.js', () => {
+    const f = path.resolve(__dirname, '..', 'cli', 'scaffold', 'default', 'app', 'routes.js');
+    expect(fs.existsSync(f)).toBe(true);
+  });
+
+  it('default scaffold has app/store.js', () => {
+    const f = path.resolve(__dirname, '..', 'cli', 'scaffold', 'default', 'app', 'store.js');
+    expect(fs.existsSync(f)).toBe(true);
+  });
+
+  // -- minimal scaffold contains expected files --
+
+  it('minimal scaffold has index.html', () => {
+    const f = path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal', 'index.html');
+    expect(fs.existsSync(f)).toBe(true);
+  });
+
+  it('minimal scaffold has app/app.js', () => {
+    const f = path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal', 'app', 'app.js');
+    expect(fs.existsSync(f)).toBe(true);
+  });
+
+  it('minimal scaffold has 4 components', () => {
+    const dir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal', 'app', 'components');
+    const files = fs.readdirSync(dir).sort();
+    expect(files).toEqual(['about.js', 'counter.js', 'home.js', 'not-found.js']);
+  });
+
+  // -- minimal scaffold is a subset of default --
+
+  it('minimal scaffold has fewer files than default', () => {
+    function countFiles(dir) {
+      let count = 0;
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) count += countFiles(path.join(dir, entry.name));
+        else count++;
+      }
+      return count;
+    }
+    const defDir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'default');
+    const minDir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal');
+    expect(countFiles(minDir)).toBeLessThan(countFiles(defDir));
+  });
+
+  // -- {{NAME}} replacement --
+
+  it('scaffold templates contain {{NAME}} placeholder', () => {
+    const html = fs.readFileSync(
+      path.resolve(__dirname, '..', 'cli', 'scaffold', 'default', 'index.html'), 'utf-8'
+    );
+    expect(html).toContain('{{NAME}}');
+  });
+
+  it('minimal scaffold templates contain {{NAME}} placeholder', () => {
+    const html = fs.readFileSync(
+      path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal', 'index.html'), 'utf-8'
+    );
+    expect(html).toContain('{{NAME}}');
+  });
+
+  // -- walkDir functionality (tested via module internals) --
+
+  it('scaffolds default project into a target directory', () => {
+    const target = tmpDir();
+    const projDir = path.join(target, 'test-app');
+
+    // Simulate: process.argv for default (no --minimal)
+    process.argv = ['node', 'zquery', 'create', 'test-app'];
+    vi.resetModules();
+
+    // We can't easily call createProject because it uses process.exit.
+    // Instead, test the walkDir + copy logic directly.
+    const scaffoldDir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'default');
+
+    function walkDir(dir, prefix = '') {
+      const entries = [];
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) entries.push(...walkDir(path.join(dir, entry.name), rel));
+        else entries.push(rel);
+      }
+      return entries;
+    }
+
+    const files = walkDir(scaffoldDir);
+    expect(files.length).toBeGreaterThan(5);
+    expect(files).toContain('index.html');
+    expect(files).toContain('global.css');
+    expect(files).toContain('app/app.js');
+    expect(files).toContain('app/routes.js');
+    expect(files).toContain('app/store.js');
+
+    cleanup(target);
+  });
+
+  it('walkDir lists minimal scaffold files correctly', () => {
+    const scaffoldDir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal');
+
+    function walkDir(dir, prefix = '') {
+      const entries = [];
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) entries.push(...walkDir(path.join(dir, entry.name), rel));
+        else entries.push(rel);
+      }
+      return entries;
+    }
+
+    const files = walkDir(scaffoldDir);
+    expect(files).toContain('index.html');
+    expect(files).toContain('global.css');
+    expect(files).toContain('app/app.js');
+    expect(files).toContain('app/routes.js');
+    expect(files).toContain('app/store.js');
+    expect(files).toContain('app/components/home.js');
+    expect(files).toContain('app/components/counter.js');
+    expect(files).toContain('app/components/about.js');
+    expect(files).toContain('app/components/not-found.js');
+    expect(files).toContain('assets/.gitkeep');
+  });
+
+  // -- {{NAME}} replacement in copied files --
+
+  it('replaces {{NAME}} in copied scaffold files', () => {
+    const target = tmpDir();
+    const scaffoldDir = path.resolve(__dirname, '..', 'cli', 'scaffold', 'minimal');
+    const projectName = 'my-cool-app';
+
+    function walkDir(dir, prefix = '') {
+      const entries = [];
+      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) entries.push(...walkDir(path.join(dir, entry.name), rel));
+        else entries.push(rel);
+      }
+      return entries;
+    }
+
+    const files = walkDir(scaffoldDir);
+
+    for (const rel of files) {
+      let content = fs.readFileSync(path.join(scaffoldDir, rel), 'utf-8');
+      content = content.replace(/\{\{NAME\}\}/g, projectName);
+      const dest = path.join(target, rel);
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.writeFileSync(dest, content, 'utf-8');
+    }
+
+    const html = fs.readFileSync(path.join(target, 'index.html'), 'utf-8');
+    expect(html).toContain(projectName);
+    expect(html).not.toContain('{{NAME}}');
+
+    const appJs = fs.readFileSync(path.join(target, 'app', 'app.js'), 'utf-8');
+    expect(appJs).toContain(projectName);
+    expect(appJs).not.toContain('{{NAME}}');
+
+    cleanup(target);
+  });
+
+  // -- conflict detection --
+
+  it('conflicts array detects existing files', () => {
+    const target = tmpDir();
+    fs.writeFileSync(path.join(target, 'index.html'), 'existing');
+    fs.mkdirSync(path.join(target, 'app'), { recursive: true });
+
+    const conflicts = ['index.html', 'global.css', 'app', 'assets'].filter(f =>
+      fs.existsSync(path.join(target, f))
+    );
+
+    expect(conflicts).toContain('index.html');
+    expect(conflicts).toContain('app');
+    expect(conflicts).not.toContain('global.css');
+    expect(conflicts).not.toContain('assets');
+
+    cleanup(target);
+  });
+
+  it('no conflicts in empty directory', () => {
+    const target = tmpDir();
+
+    const conflicts = ['index.html', 'global.css', 'app', 'assets'].filter(f =>
+      fs.existsSync(path.join(target, f))
+    );
+
+    expect(conflicts).toHaveLength(0);
+
+    cleanup(target);
+  });
+
+  // -- flag parsing for --minimal --
+
+  it('--minimal flag resolves to minimal variant', async () => {
+    process.argv = ['node', 'zquery', 'create', '--minimal', 'my-app'];
+    vi.resetModules();
+    const { flag } = await import('../cli/args.js');
+    expect(flag('minimal', 'm')).toBe(true);
+  });
+
+  it('-m short flag resolves to minimal variant', async () => {
+    process.argv = ['node', 'zquery', 'create', '-m', 'my-app'];
+    vi.resetModules();
+    const { flag } = await import('../cli/args.js');
+    expect(flag('minimal', 'm')).toBe(true);
+  });
+
+  it('no flag defaults to default variant', async () => {
+    process.argv = ['node', 'zquery', 'create', 'my-app'];
+    vi.resetModules();
+    const { flag } = await import('../cli/args.js');
+    expect(flag('minimal', 'm')).toBe(false);
+  });
+
+  // -- dirArg parsing skips flags --
+
+  it('dirArg parsing skips flag args', () => {
+    const args = ['create', '--minimal', 'my-app'];
+    const dirArg = args.slice(1).find(a => !a.startsWith('-'));
+    expect(dirArg).toBe('my-app');
+  });
+
+  it('dirArg parsing returns first positional', () => {
+    const args = ['create', 'my-app'];
+    const dirArg = args.slice(1).find(a => !a.startsWith('-'));
+    expect(dirArg).toBe('my-app');
+  });
+
+  it('dirArg is undefined when no positional given', () => {
+    const args = ['create', '--minimal'];
+    const dirArg = args.slice(1).find(a => !a.startsWith('-'));
+    expect(dirArg).toBeUndefined();
+  });
+
+  it('dirArg with flag after dir name', () => {
+    const args = ['create', 'my-app', '--minimal'];
+    const dirArg = args.slice(1).find(a => !a.startsWith('-'));
+    expect(dirArg).toBe('my-app');
+  });
+
+  // -- help text mentions --minimal --
+
+  it('help text includes --minimal flag', async () => {
+    vi.resetModules();
+    const spy = vi.spyOn(console, 'log').mockImplementation(() => {});
+    const showHelp = (await import('../cli/help.js')).default;
+    showHelp();
+    const text = spy.mock.calls.map(c => c.join(' ')).join('\n');
+    expect(text).toContain('--minimal');
+    spy.mockRestore();
+  });
+});