@nqlib/nqui 0.1.1 → 0.1.3

package/scripts/examples.js

@@ -0,0 +1,76 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join, resolve } from 'path';
+import { getPackageRoot } from './getPackageRoot.js';
+import { findMainCssFile } from './framework.js';
+import { askQuestion } from './wizard.js';
+
+/**
+ * Copy Next.js example files to user's project
+ */
+export async function copyNextJsExamples(framework, { force }) {
+  if (framework !== 'nextjs') {
+    return;
+  }
+
+  const root = getPackageRoot();
+  const examplesDir = join(root, 'scripts', 'examples');
+  const cwd = process.cwd();
+
+  // Determine app directory (src/app or app)
+  const appDir = existsSync(join(cwd, 'src', 'app'))
+    ? join(cwd, 'src', 'app')
+    : join(cwd, 'app');
+
+  const examples = [
+    { src: 'nextjs-page.tsx', dest: join(appDir, 'page.tsx'), name: 'page.tsx' },
+    { src: 'nextjs-layout.tsx', dest: join(appDir, 'layout.tsx'), name: 'layout.tsx' },
+  ];
+
+  const copied = [];
+  const existing = [];
+
+  // Check which files exist
+  for (const { dest, name } of examples) {
+    if (existsSync(dest)) {
+      existing.push({ dest, name });
+    }
+  }
+
+  // Ask about overwriting if files exist and force is not set
+  let shouldOverwrite = force;
+  if (existing.length > 0 && !force) {
+    const fileList = existing.map(e => e.name).join(' and ');
+    const answer = await askQuestion(
+      `\n⚠️  ${fileList} already exist(s). Overwrite? (y/n): `
+    );
+    shouldOverwrite = answer === 'y';
+  }
+
+  for (const { src, dest, name } of examples) {
+    const srcPath = join(examplesDir, src);
+
+    if (!existsSync(srcPath)) {
+      console.warn(`⚠️  Example file not found: ${srcPath}`);
+      continue;
+    }
+
+    if (existsSync(dest) && !shouldOverwrite) {
+      console.log(`⏭️  Skipped: ${dest} (already exists)`);
+      continue;
+    }
+
+    const content = readFileSync(srcPath, 'utf8');
+    writeFileSync(dest, content, 'utf8');
+    copied.push(dest);
+    console.log(`✅ ${existsSync(dest) && shouldOverwrite ? 'Overwritten' : 'Created'}: ${dest}`);
+  }
+
+  if (copied.length > 0) {
+    console.log(`\n📝 Required dependencies for example files:`);
+    console.log(`   npm install @nqlib/nqui tw-animate-css next-themes\n`);
+    console.log(`   Make sure your globals.css includes the setup from nqui/nqui-setup.css\n`);
+  }
+
+  return copied;
+}
+

package/scripts/framework.js

@@ -0,0 +1,68 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Detect the framework type of the current project
+ */
+export function detectFramework() {
+  const cwd = process.cwd();
+
+  if (
+    existsSync(join(cwd, 'next.config.js')) ||
+    existsSync(join(cwd, 'next.config.ts')) ||
+    existsSync(join(cwd, 'app')) ||
+    existsSync(join(cwd, 'src', 'app'))
+  ) {
+    return 'nextjs';
+  }
+
+  if (
+    existsSync(join(cwd, 'vite.config.js')) ||
+    existsSync(join(cwd, 'vite.config.ts'))
+  ) {
+    return 'vite';
+  }
+
+  if (existsSync(join(cwd, 'remix.config.js'))) {
+    return 'remix';
+  }
+
+  if (existsSync(join(cwd, 'src', 'index.css'))) {
+    return 'create-react-app';
+  }
+
+  return 'generic';
+}
+
+/**
+ * Find the main CSS file for a framework
+ */
+export function findMainCssFile(framework) {
+  const cwd = process.cwd();
+
+  switch (framework) {
+    case 'nextjs':
+      // Check src/app first, then app
+      if (existsSync(join(cwd, 'src', 'app', 'globals.css'))) {
+        return 'src/app/globals.css';
+      }
+      if (existsSync(join(cwd, 'app', 'globals.css'))) {
+        return 'app/globals.css';
+      }
+      return 'app/globals.css'; // default
+    case 'vite':
+    case 'create-react-app':
+      if (existsSync(join(cwd, 'src', 'index.css'))) {
+        return 'src/index.css';
+      }
+      return 'src/index.css'; // default
+    case 'remix':
+      if (existsSync(join(cwd, 'app', 'root.css'))) {
+        return 'app/root.css';
+      }
+      return 'app/root.css'; // default
+    default:
+      return 'index.css';
+  }
+}
+

package/scripts/getPackageRoot.js

@@ -0,0 +1,26 @@
+import { existsSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+/**
+ * Robust package root detection that works with npx
+ * Uses fileURLToPath for Windows compatibility
+ */
+export function getPackageRoot() {
+  const __filename = fileURLToPath(import.meta.url);
+  let dir = dirname(__filename);
+
+  while (dir !== '/' && dir !== '') {
+    const pkgPath = join(dir, 'package.json');
+    if (existsSync(pkgPath)) {
+      const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+      if (pkg.name === '@nqlib/nqui') return dir;
+    }
+    const parentDir = dirname(dir);
+    if (parentDir === dir) break; // Reached root
+    dir = parentDir;
+  }
+
+  throw new Error('Could not locate @nqlib/nqui package root');
+}
+

package/scripts/help.js

@@ -0,0 +1,34 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { getPackageRoot } from './getPackageRoot.js';
+
+export function printHelp() {
+  const root = getPackageRoot();
+  const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+
+  console.log(`
+${pkg.name} v${pkg.version}
+
+Usage:
+  npx nqui init-css [output.css] [options]
+
+Options:
+  --js            Generate JS token file
+  --tokens-only   Extract only CSS variables
+  --setup         Generate nqui-setup.css helper
+  --local-copy    Generate local CSS copy instead of importing from library
+  --wizard        Interactive installer
+  --force         Overwrite existing files
+  --dry-run       Preview output only
+  --help, -h      Show help
+  --version, -v   Show version
+
+Examples:
+  npx nqui init-css
+  npx nqui init-css nqui/index.css
+  npx nqui init-css --local-copy nqui/nqui.css
+  npx nqui init-css --tokens-only --js
+  npx nqui init-css --wizard
+`);
+}
+