domma-js 0.10.0 → 0.10.1

package/bin/domma-cli.js

@@ -33,6 +33,9 @@ switch (command) {
   case 'add':
     handleAdd();
     break;
+  case 'setup-ai':
+    handleSetupAI();
+    break;
   case 'version':
   case '--version':
   case '-v':
@@ -367,6 +370,97 @@ function showVersion() {
 /**
  * Show help information
  */
+/**
+ * Handle AI assistance setup
+ */
+async function handleSetupAI() {
+  const templatesDir = join(__dirname, '..', 'templates', 'kickstart');
+  const projectRoot = process.cwd();
+
+  console.log(`
+╔═══════════════════════════════════════╗
+║   Domma AI Assistance Setup           ║
+╚═══════════════════════════════════════╝
+
+This will copy AI assistance files to your project:
+  • CLAUDE.md - Framework reference guide
+  • .claude/ - Settings & code snippets
+  • blueprints/ - Reusable schemas (8 files)
+  • types/ - TypeScript definitions
+`);
+
+  const rl = readline.createInterface({input, output});
+  const answer = await rl.question('Continue? (Y/n): ');
+  rl.close();
+
+  if (answer.toLowerCase() === 'n' || answer.toLowerCase() === 'no') {
+    console.log('\nSetup cancelled.');
+    return;
+  }
+
+  console.log('\nCopying files...\n');
+
+  try {
+    let copied = 0;
+
+    // Copy CLAUDE.md
+    const claudeMd = join(templatesDir, 'CLAUDE.md');
+    const destClaudeMd = join(projectRoot, 'CLAUDE.md');
+    if (existsSync(claudeMd) && !existsSync(destClaudeMd)) {
+      cpSync(claudeMd, destClaudeMd);
+      console.log('  ✓ Created CLAUDE.md');
+      copied++;
+    } else if (existsSync(destClaudeMd)) {
+      console.log('  ⊘ CLAUDE.md already exists');
+    }
+
+    // Copy .claude/ directory
+    const claudeDir = join(templatesDir, '.claude');
+    const destClaudeDir = join(projectRoot, '.claude');
+    if (existsSync(claudeDir) && !existsSync(destClaudeDir)) {
+      cpSync(claudeDir, destClaudeDir, { recursive: true });
+      console.log('  ✓ Created .claude/ directory');
+      copied++;
+    } else if (existsSync(destClaudeDir)) {
+      console.log('  ⊘ .claude/ already exists');
+    }
+
+    // Copy blueprints/ directory
+    const blueprintsDir = join(templatesDir, 'blueprints');
+    const destBlueprintsDir = join(projectRoot, 'blueprints');
+    if (existsSync(blueprintsDir) && !existsSync(destBlueprintsDir)) {
+      cpSync(blueprintsDir, destBlueprintsDir, { recursive: true });
+      console.log('  ✓ Created blueprints/ directory');
+      copied++;
+    } else if (existsSync(destBlueprintsDir)) {
+      console.log('  ⊘ blueprints/ already exists');
+    }
+
+    // Copy types/ directory
+    const typesDir = join(templatesDir, 'frontend', 'types');
+    const destTypesDir = join(projectRoot, 'types');
+    if (existsSync(typesDir) && !existsSync(destTypesDir)) {
+      cpSync(typesDir, destTypesDir, { recursive: true });
+      console.log('  ✓ Created types/ directory');
+      copied++;
+    } else if (existsSync(destTypesDir)) {
+      console.log('  ⊘ types/ already exists');
+    }
+
+    if (copied > 0) {
+      console.log(`\n✓ Successfully added ${copied} AI assistance ${copied === 1 ? 'file' : 'files'}!`);
+      console.log('Claude Code will now have full context for your Domma project.\n');
+    } else {
+      console.log('\nAll AI assistance files already exist. Nothing to copy.\n');
+    }
+
+  } catch (error) {
+    console.error('\n✗ Error copying AI assistance files:', error.message);
+    console.error('You can manually copy them from node_modules/domma-js/templates/kickstart/\n');
+    process.exit(1);
+  }
+}
+
 function showHelp() {
   console.log(`
 Domma CLI v${VERSION} - Project scaffolding and management
@@ -375,6 +469,7 @@ Commands:
   npx domma-js              Initialize a new Domma project
   npx domma-js init         Initialize a new Domma project
   npx domma-js add page <path>  Add a new page at specified path
+  npx domma-js setup-ai     Add AI assistance files to existing project
     --quick                 Skip interactive prompts
 
 Options:
@@ -384,6 +479,7 @@ Options:
 Examples:
   npx domma-js                     # Interactive project setup
   npx domma-js --quick             # Quick project setup with defaults
+  npx domma-js setup-ai            # Add AI assistance to existing project
 
   # Add pages at different paths:
   npx domma-js add page admin                      # Root level (admin/)

package/bin/postinstall.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+
+/**
+ * Domma Postinstall Script
+ * Offers to copy AI assistance files to the project root
+ */
+
+import { existsSync, mkdirSync, copyFileSync, readdirSync, statSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Color codes for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  gray: '\x1b[90m'
+};
+
+/**
+ * Check if we're in a valid installation context
+ * - Should be installed as dependency (in node_modules)
+ * - Should not be in development mode (inside domma repo itself)
+ */
+function shouldRunPostinstall() {
+  const cwd = process.cwd();
+
+  // Don't run during development in domma repo
+  if (existsSync(join(cwd, 'templates', 'kickstart'))) {
+    return false;
+  }
+
+  // Don't run in CI environments
+  if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) {
+    return false;
+  }
+
+  // Check if we're in node_modules (normal install)
+  const isInNodeModules = cwd.includes('node_modules');
+
+  return isInNodeModules;
+}
+
+/**
+ * Find project root (directory with package.json, above node_modules)
+ */
+function findProjectRoot() {
+  let currentDir = process.cwd();
+
+  // Navigate up to find the project root (outside node_modules)
+  while (currentDir.includes('node_modules')) {
+    currentDir = dirname(currentDir);
+  }
+
+  // Go up one more level to get to the actual project root
+  const projectRoot = dirname(currentDir);
+
+  // Verify it has package.json
+  if (existsSync(join(projectRoot, 'package.json'))) {
+    return projectRoot;
+  }
+
+  return null;
+}
+
+/**
+ * Get path to kickstart template in installed package
+ */
+function getTemplatePath() {
+  // When installed via npm, templates are in node_modules/domma-js/templates/
+  const cwd = process.cwd();
+  return join(cwd, 'templates', 'kickstart');
+}
+
+/**
+ * Copy file recursively
+ */
+function copyRecursive(src, dest) {
+  const stat = statSync(src);
+
+  if (stat.isDirectory()) {
+    if (!existsSync(dest)) {
+      mkdirSync(dest, { recursive: true });
+    }
+
+    const items = readdirSync(src);
+    for (const item of items) {
+      copyRecursive(join(src, item), join(dest, item));
+    }
+  } else {
+    copyFileSync(src, dest);
+  }
+}
+
+/**
+ * Prompt user for input
+ */
+function prompt(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+/**
+ * Main postinstall function
+ */
+async function main() {
+  // Check if we should run
+  if (!shouldRunPostinstall()) {
+    return;
+  }
+
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    return;
+  }
+
+  const templatePath = getTemplatePath();
+  if (!existsSync(templatePath)) {
+    return;
+  }
+
+  console.log(`\n${colors.cyan}${colors.bright}╭───────────────────────────────────────────╮${colors.reset}`);
+  console.log(`${colors.cyan}${colors.bright}│${colors.reset}  ${colors.bright}Domma AI Assistance Available${colors.reset}         ${colors.cyan}${colors.bright}│${colors.reset}`);
+  console.log(`${colors.cyan}${colors.bright}╰───────────────────────────────────────────╯${colors.reset}\n`);
+
+  console.log(`${colors.gray}Domma includes AI assistance files for Claude Code:${colors.reset}`);
+  console.log(`${colors.gray}  • CLAUDE.md - Framework reference guide${colors.reset}`);
+  console.log(`${colors.gray}  • .claude/ - Settings & code snippets${colors.reset}`);
+  console.log(`${colors.gray}  • blueprints/ - Reusable schemas (8 files)${colors.reset}`);
+  console.log(`${colors.gray}  • types/ - TypeScript definitions${colors.reset}\n`);
+
+  const answer = await prompt(`${colors.bright}Copy AI assistance files to your project? (Y/n): ${colors.reset}`);
+
+  if (answer === 'n' || answer === 'no') {
+    console.log(`${colors.gray}Skipped. Run ${colors.bright}npx domma setup-ai${colors.gray} later to add these files.${colors.reset}\n`);
+    return;
+  }
+
+  console.log(`\n${colors.cyan}Copying AI assistance files...${colors.reset}\n`);
+
+  try {
+    let copied = 0;
+
+    // Copy CLAUDE.md
+    const claudeMd = join(templatePath, 'CLAUDE.md');
+    const destClaudeMd = join(projectRoot, 'CLAUDE.md');
+    if (existsSync(claudeMd) && !existsSync(destClaudeMd)) {
+      copyFileSync(claudeMd, destClaudeMd);
+      console.log(`  ${colors.green}✓${colors.reset} Created CLAUDE.md`);
+      copied++;
+    }
+
+    // Copy .claude/ directory
+    const claudeDir = join(templatePath, '.claude');
+    const destClaudeDir = join(projectRoot, '.claude');
+    if (existsSync(claudeDir) && !existsSync(destClaudeDir)) {
+      copyRecursive(claudeDir, destClaudeDir);
+      console.log(`  ${colors.green}✓${colors.reset} Created .claude/ directory`);
+      copied++;
+    }
+
+    // Copy blueprints/ directory
+    const blueprintsDir = join(templatePath, 'blueprints');
+    const destBlueprintsDir = join(projectRoot, 'blueprints');
+    if (existsSync(blueprintsDir) && !existsSync(destBlueprintsDir)) {
+      copyRecursive(blueprintsDir, destBlueprintsDir);
+      console.log(`  ${colors.green}✓${colors.reset} Created blueprints/ directory`);
+      copied++;
+    }
+
+    // Copy types/ directory
+    const typesDir = join(templatePath, 'frontend', 'types');
+    const destTypesDir = join(projectRoot, 'types');
+    if (existsSync(typesDir) && !existsSync(destTypesDir)) {
+      copyRecursive(typesDir, destTypesDir);
+      console.log(`  ${colors.green}✓${colors.reset} Created types/ directory`);
+      copied++;
+    }
+
+    if (copied > 0) {
+      console.log(`\n${colors.green}${colors.bright}✓ Successfully added AI assistance files!${colors.reset}`);
+      console.log(`${colors.gray}Claude Code will now have full context for your Domma project.${colors.reset}\n`);
+    } else {
+      console.log(`\n${colors.yellow}AI assistance files already exist. Skipped copying.${colors.reset}\n`);
+    }
+
+  } catch (error) {
+    console.error(`\n${colors.yellow}Warning: Could not copy AI assistance files${colors.reset}`);
+    console.error(`${colors.gray}You can manually copy them from node_modules/domma-js/templates/kickstart/${colors.reset}\n`);
+  }
+}
+
+// Run postinstall
+main().catch(() => {
+  // Silent failure - don't break installation
+  process.exit(0);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domma-js",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Dynamic Object Manipulation & Modeling API - A complete front-end toolkit.",
   "main": "public/dist/domma.min.js",
   "module": "public/dist/domma.esm.js",
@@ -30,6 +30,7 @@
   },
   "type": "module",
   "scripts": {
+    "postinstall": "node bin/postinstall.js",
     "dev": "NODE_ENV=development npm run generate:bundles && rollup -c && node scripts/build-info.js && npm run build:metadata && npm run copy:themes && npm run build:css && npm run build:miniapps && live-server public --port=3001 --open=/index.html",
     "build": "npm run generate:bundles && rollup -c && node scripts/build-info.js && npm run build:metadata && npm run copy:themes && npm run build:css && npm run build:css-bundles && npm run build:archives && npm run build:kickstart && npm run build:miniapps",
     "build:js": "rollup -c",

package/public/dist/bundles/domma-complete.css

@@ -1,8 +1,8 @@
 /*!
- * Domma Complete CSS Bundle v0.10.0
+ * Domma Complete CSS Bundle v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.810Z
+ * Built: 2026-01-23T17:27:40.953Z
  */
 
 /* ============================================
@@ -11,11 +11,11 @@
    ============================================ */
 
 /*!
- * Domma Core CSS v0.10.0
+ * Domma Core CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.402Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.633Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4016,11 +4016,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Grid CSS v0.10.0
+ * Domma Grid CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.410Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.639Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4617,11 +4617,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Elements CSS v0.10.0
+ * Domma Elements CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.420Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.647Z
+ * Commit: bab2e88
  */
 
 /**
@@ -11187,11 +11187,11 @@ code {
    ============================================ */
 
 /*!
- * Domma Themes v0.10.0
+ * Domma Themes v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.375Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.609Z
+ * Commit: bab2e88
  */
 
 /**

package/public/dist/bundles/domma-data-focused.css

@@ -1,8 +1,8 @@
 /*!
- * Domma Data-Focused CSS Bundle v0.10.0
+ * Domma Data-Focused CSS Bundle v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.796Z
+ * Built: 2026-01-23T17:27:40.944Z
  */
 
 /* ============================================
@@ -230,11 +230,11 @@
    ============================================ */
 
 /*!
- * Domma Core CSS v0.10.0
+ * Domma Core CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.402Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.633Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4235,11 +4235,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Grid CSS v0.10.0
+ * Domma Grid CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.410Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.639Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4836,11 +4836,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Elements CSS v0.10.0
+ * Domma Elements CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.420Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.647Z
+ * Commit: bab2e88
  */
 
 /**
@@ -11406,11 +11406,11 @@ code {
    ============================================ */
 
 /*!
- * Domma Themes v0.10.0
+ * Domma Themes v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.375Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.609Z
+ * Commit: bab2e88
  */
 
 /**

package/public/dist/bundles/domma-essentials.css

@@ -1,8 +1,8 @@
 /*!
- * Domma Essentials CSS Bundle v0.10.0
+ * Domma Essentials CSS Bundle v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.771Z
+ * Built: 2026-01-23T17:27:40.933Z
  */
 
 /* ============================================
@@ -230,11 +230,11 @@
    ============================================ */
 
 /*!
- * Domma Core CSS v0.10.0
+ * Domma Core CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.402Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.633Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4235,11 +4235,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Grid CSS v0.10.0
+ * Domma Grid CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.410Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.639Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4836,11 +4836,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Elements CSS v0.10.0
+ * Domma Elements CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.420Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.647Z
+ * Commit: bab2e88
  */
 
 /**
@@ -11406,11 +11406,11 @@ code {
    ============================================ */
 
 /*!
- * Domma Themes v0.10.0
+ * Domma Themes v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.375Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.609Z
+ * Commit: bab2e88
  */
 
 /**

package/public/dist/bundles/domma-full.css

@@ -1,8 +1,8 @@
 /*!
- * Domma Full CSS Bundle v0.10.0
+ * Domma Full CSS Bundle v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.781Z
+ * Built: 2026-01-23T17:27:40.939Z
  */
 
 /* ============================================
@@ -230,11 +230,11 @@
    ============================================ */
 
 /*!
- * Domma Core CSS v0.10.0
+ * Domma Core CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.402Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.633Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4235,11 +4235,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Grid CSS v0.10.0
+ * Domma Grid CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.410Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.639Z
+ * Commit: bab2e88
  */
 
 /**
@@ -4836,11 +4836,11 @@ body.dm-cloaked.dm-ready {
    ============================================ */
 
 /*!
- * Domma Elements CSS v0.10.0
+ * Domma Elements CSS v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.420Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.647Z
+ * Commit: bab2e88
  */
 
 /**
@@ -11406,11 +11406,11 @@ code {
    ============================================ */
 
 /*!
- * Domma Themes v0.10.0
+ * Domma Themes v0.10.1
  * Dynamic Object Manipulation & Modeling API
  * (c) 2026 Darryl Waterhouse & DCBW-IT
- * Built: 2026-01-23T16:46:59.375Z
- * Commit: e2a2ded
+ * Built: 2026-01-23T17:27:40.609Z
+ * Commit: bab2e88
  */
 
 /**