@pure-ds/core 0.6.10 → 0.7.1

package/packages/pds-cli/bin/pds-import.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+
+import { mkdir, readFile, writeFile } from 'fs/promises';
+import path from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { runLiveImport, listLiveTemplates, getLiveImportSources } from '../../../src/js/pds-live-manager/import-service.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+function help() {
+  console.log(`pds-import — Import and convert external design inputs for PDS
+
+Usage:
+  pds-import --type tailwind-html --mode convert-only --source ./input.html --out ./pds-import.json
+  pds-import --type tailwind-html --mode adopt-design-and-convert --source ./input.html --out ./pds-import.json
+  pds-import --type brand-guidelines --mode adopt-design-and-convert --source ./brand.txt --out ./brand-import.json
+  pds-import --type template --template marketing-hero --out ./template-import.json
+
+Options:
+  --type <value>       Import type: tailwind-html | brand-guidelines | template
+  --mode <value>       Import mode: convert-only | adopt-design-and-convert
+  --source <path>      Source file path for tailwind-html or brand-guidelines
+  --text <value>       Inline input text instead of source file
+  --template <id>      Template id when --type=template
+  --config <path>      Optional PDS config file (.json/.js/.mjs) to govern conversion rules
+  --describe-rules     Print Tailwind→PDS conversion rulebook and exit
+  --out <path>         Output JSON file path (required)
+  --html-out <path>    Optional output path for converted template HTML (if present)
+  --design-out <path>  Optional output path for design patch JSON (if present)
+  --list               List available sources and templates
+  --help               Show this help message
+`);
+}
+
+function normalizeImportMode(value) {
+  const raw = String(value || '').trim().toLowerCase();
+  if (raw === 'adopt-design-and-convert') return raw;
+  return 'convert-only';
+}
+
+async function writeTextOutput(absPath, contents) {
+  await mkdir(path.dirname(absPath), { recursive: true });
+  await writeFile(absPath, contents, 'utf8');
+}
+
+function parseArgs(argv) {
+  const args = { _: [] };
+  for (let i = 2; i < argv.length; i += 1) {
+    const current = argv[i];
+    if (current.startsWith('--')) {
+      const key = current.slice(2);
+      const next = argv[i + 1];
+      if (!next || next.startsWith('--')) {
+        args[key] = true;
+      } else {
+        args[key] = next;
+        i += 1;
+      }
+    } else {
+      args._.push(current);
+    }
+  }
+  return args;
+}
+
+async function loadInput(args) {
+  if (typeof args.text === 'string') return args.text;
+  if (typeof args.source === 'string') {
+    const sourcePath = path.resolve(process.cwd(), args.source);
+    return readFile(sourcePath, 'utf8');
+  }
+  return '';
+}
+
+async function loadConfig(args) {
+  if (typeof args.config !== 'string' || !args.config.trim()) return null;
+
+  const configPath = path.resolve(process.cwd(), args.config);
+  const ext = path.extname(configPath).toLowerCase();
+
+  if (ext === '.json') {
+    const raw = await readFile(configPath, 'utf8');
+    return JSON.parse(raw);
+  }
+
+  if (ext === '.js' || ext === '.mjs' || ext === '.cjs') {
+    const mod = await import(pathToFileURL(configPath).href);
+    return mod?.config || mod?.default || null;
+  }
+
+  throw new Error('Unsupported --config format. Use .json, .js, .mjs, or .cjs');
+}
+
+async function main() {
+  const args = parseArgs(process.argv);
+
+  if (args.help) {
+    help();
+    return;
+  }
+
+  if (args.list) {
+    console.log('Sources:');
+    getLiveImportSources().forEach((source) => {
+      console.log(`- ${source.id}: ${source.name}`);
+    });
+    console.log('Templates:');
+    (await listLiveTemplates()).forEach((template) => {
+      console.log(`- ${template.id}: ${template.name} [${template.icon || 'layout'}]`);
+      if (template.description) {
+        console.log(`  ${template.description}`);
+      }
+    });
+    return;
+  }
+
+  if (args['describe-rules']) {
+    const rulesPath = path.resolve(__dirname, '../../../src/js/pds-live-manager/tailwind-conversion-rules.json');
+    const rulesJson = await readFile(rulesPath, 'utf8');
+    console.log(rulesJson);
+    return;
+  }
+
+  const type = String(args.type || '').trim();
+  const outPath = String(args.out || '').trim();
+  const mode = normalizeImportMode(args.mode);
+
+  if (!type || !outPath) {
+    console.error('❌ Missing required arguments --type and --out');
+    help();
+    process.exitCode = 2;
+    return;
+  }
+
+  const request = {
+    sourceType: type,
+    importMode: mode,
+    templateId: args.template,
+    input: await loadInput(args),
+    config: await loadConfig(args),
+    cwd: process.cwd(),
+    caller: path.relative(process.cwd(), __dirname),
+  };
+
+  const result = await runLiveImport(request);
+  const absOutPath = path.resolve(process.cwd(), outPath);
+
+  await writeTextOutput(absOutPath, JSON.stringify(result, null, 2) + '\n');
+  console.log(`✅ Wrote import result to ${absOutPath}`);
+
+  if (typeof args['html-out'] === 'string' && String(args['html-out']).trim()) {
+    const html = String(result?.template?.html || '');
+    const absHtmlOutPath = path.resolve(process.cwd(), String(args['html-out']).trim());
+    await writeTextOutput(absHtmlOutPath, html);
+    console.log(`✅ Wrote converted HTML to ${absHtmlOutPath}`);
+  }
+
+  if (typeof args['design-out'] === 'string' && String(args['design-out']).trim()) {
+    const designPatch = result?.designPatch && typeof result.designPatch === 'object'
+      ? result.designPatch
+      : {};
+    const absDesignOutPath = path.resolve(process.cwd(), String(args['design-out']).trim());
+    await writeTextOutput(absDesignOutPath, JSON.stringify(designPatch, null, 2) + '\n');
+    console.log(`✅ Wrote design patch to ${absDesignOutPath}`);
+  }
+
+  const issueCount = Array.isArray(result?.issues) ? result.issues.length : 0;
+  const validationBlocked = Boolean(result?.meta?.validationBlocked || result?.meta?.validation?.ok === false);
+  console.log(`ℹ️ mode=${mode} confidence=${Math.round((result?.confidence || 0) * 100)}% issues=${issueCount} blocked=${validationBlocked}`);
+}
+
+main().catch((error) => {
+  console.error('❌ pds-import failed:', error?.message || error);
+  process.exit(1);
+});

package/packages/pds-cli/bin/pds-static.js

@@ -349,7 +349,7 @@ async function loadConsumerConfig() {
         if (/PDS is not defined/i.test(msg)) {
           log('❌ Failed to evaluate pds.config.js: PDS is not defined', 'red');
           log('   This usually means your config references the browser global "PDS".', 'yellow');
-          log('   The static exporter runs in Node, so please import presets instead of using window.PDS.', 'yellow');
+          log('   The static exporter runs in Node, so please import presets instead of using a browser global PDS object.', 'yellow');
           log('   Example fix for pds.config.js:', 'yellow');
           log("     import { presets } from 'pure-ds/src/js/pds-core/pds-config.js'", 'blue');
           log('     export const config = { ...presets.default, static: { root: "public/assets/pds/" } }', 'blue');
@@ -433,6 +433,17 @@ async function main(options = {}) {
 
   // 4b) Copy live manager bundle into target/core for dynamic import fallback
   try {
+    const coreEntrySourceNew = path.join(repoRoot, 'public/assets/pds/core.js');
+    const coreEntrySourceLegacy = path.join(repoRoot, 'public/assets/js/pds.js');
+    const coreEntrySource = existsSync(coreEntrySourceNew) ? coreEntrySourceNew : coreEntrySourceLegacy;
+    if (!existsSync(coreEntrySource)) {
+      log('⚠️  core.js not found in package assets; skipping copy', 'yellow');
+    } else {
+      const coreEntryTarget = path.join(targetDir, 'core.js');
+      await copyFile(coreEntrySource, coreEntryTarget);
+      log(`✅ Copied core runtime entry → ${path.relative(process.cwd(), coreEntryTarget)}`, 'green');
+    }
+
     const managerSource = path.join(repoRoot, 'public/assets/js/pds-manager.js');
     if (!existsSync(managerSource)) {
       log('⚠️  pds-manager.js not found in package assets; skipping copy', 'yellow');
@@ -466,6 +477,21 @@ async function main(options = {}) {
     log(`⚠️  Failed to copy lit.js: ${e?.message || e}`, 'yellow');
   }
 
+  // 4d) Copy template catalog and HTML files into target/templates
+  try {
+    const templateSource = path.join(repoRoot, 'public', 'assets', 'pds', 'templates');
+    if (!existsSync(templateSource)) {
+      log('⚠️  No templates source found; skipping templates copy', 'yellow');
+    } else {
+      const templatesDir = path.join(targetDir, 'templates');
+      await mkdir(templatesDir, { recursive: true });
+      await copyDirectory(templateSource, templatesDir);
+      log(`✅ Copied templates → ${path.relative(process.cwd(), templatesDir)}`, 'green');
+    }
+  } catch (e) {
+    log(`⚠️  Failed to copy templates: ${e?.message || e}`, 'yellow');
+  }
+
   // 5) Generate CSS layers into target/styles
   log('🧬 Generating styles...', 'bold');
   const { Generator } = await loadGenerator();

package/packages/pds-cli/bin/postinstall.mjs

@@ -121,18 +121,27 @@ async function ensureBuildScript(consumerRoot) {
 
     consumerPkg.scripts = consumerPkg.scripts || {};
 
-  const desiredScriptName = 'pds:build';
-  const desiredScriptCmd = 'pds-build';
+    const requiredScripts = {
+      'pds:build': 'pds-build',
+      'pds:import': 'pds-import',
+    };
+
+    let changed = false;
+    for (const [scriptName, scriptCommand] of Object.entries(requiredScripts)) {
+      if (!consumerPkg.scripts[scriptName]) {
+        consumerPkg.scripts[scriptName] = scriptCommand;
+        console.log(`🧩 Added "${scriptName}" script to consumer package.json`);
+        changed = true;
+      } else {
+        console.log(`🔧 Script "${scriptName}" already present in consumer package.json`);
+      }
+    }
 
-    if (!consumerPkg.scripts[desiredScriptName]) {
-      consumerPkg.scripts[desiredScriptName] = desiredScriptCmd;
+    if (changed) {
       await writeFile(consumerPkgPath, JSON.stringify(consumerPkg, null, 2) + '\n');
-      console.log(`🧩 Added "${desiredScriptName}" script to consumer package.json`);
-    } else {
-      console.log(`🔧 Script "${desiredScriptName}" already present in consumer package.json`);
     }
   } catch (e) {
-    console.warn('⚠️  Could not ensure pds:build script in consumer package.json:', e.message);
+    console.warn('⚠️  Could not ensure PDS scripts in consumer package.json:', e.message);
   }
 }
 

package/packages/pds-cli/bin/templates/bootstrap/pds.config.js

@@ -2,11 +2,7 @@
 
 /** @typedef {import("@pure-ds/core").PDSInitConfig} PDSInitConfig */
 
-const pdsGlobal = globalThis.PDS;
-
-const standardPDSEnhancers = Array.isArray(pdsGlobal?.defaultEnhancers)
-  ? pdsGlobal.defaultEnhancers
-  : [];
+const standardPDSEnhancers = [];
 
 /** @type {PDSInitConfig} */
 export const config = {

package/packages/pds-cli/bin/templates/bootstrap/public/index.html

@@ -8,10 +8,11 @@
     <!-- PDS Styles -->
     <link rel="stylesheet" href="/assets/css/app.css" />
 
-    <!-- Import Map for Lit components -->
+    <!-- Import map for PDS runtime (#pds) and Lit bridge (#pds/lit) -->
     <script type="importmap">
       {
         "imports": {
+          "#pds": "/assets/pds/core.js",
           "#pds/lit": "/assets/pds/external/lit.js"
         }
       }

package/packages/pds-cli/bin/templates/starter-templates.js

@@ -1,7 +1,5 @@
 export function buildStarterPdsConfig() {
-  return `const defaultEnhancers = Array.isArray(globalThis.PDS?.defaultEnhancers)
-  ? globalThis.PDS.defaultEnhancers
-  : [];
+  return `const defaultEnhancers = [];
 
 export const config = {
   mode: "static",