@pure-ds/core 0.4.11 → 0.4.13

package/dist/types/src/js/pds-core/pds-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pds-generator.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-generator.js"],"names":[],"mappings":"AAurKA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAjBW,UAAU,qBACV,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAqCzB;AAED;;;;;;;;GAQG;AACH,wCALW,UAAU,WACV,MAAM,EAAE,qBACR,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAmDzB;AAED;;;;;;GAMG;AACH,sCAHW,MAAM,GACJ,aAAa,CAMzB;AAzyKD;;;GAGG;AACH;IAEE,mCAAiB;IAEjB,2BAEC;IA6kKD;;;;OAIG;IACH,+BAFW,SAAS,QAgCnB;IAED;;;;OAIG;IACH,gDA6CC;IA7pKD,0BA6CC;IA5CC;;MAIC;IAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAmC;IA6BrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgBC;IAycD;;;;OAIG;IACH,kDAyBC;IA0ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6DC;IAg8GD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEC;IAGD,oBAEC;IA8sBD,qBAEC;IACD,yBAEC;IACD,yBAEC;IACD,wBAEC;IACD,yBAMC;IAED;;;;;;OAMG;IACH,oBA6JC;IAGD,4BAEC;IACD,gCAEC;IACD,gCAEC;IACD,+BAEC;IAmBD;;;OAGG;IACH;;;;;;MAoBC;;CA2GF"}
+{"version":3,"file":"pds-generator.d.ts","sourceRoot":"","sources":["../../../../../src/js/pds-core/pds-generator.js"],"names":[],"mappings":"AAs2JA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4CAjBW,UAAU,qBACV,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAqCzB;AAED;;;;;;;;GAQG;AACH,wCALW,UAAU,WACV,MAAM,EAAE,qBACR,aAAa,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAmDzB;AAED;;;;;;GAMG;AACH,sCAHW,MAAM,GACJ,aAAa,CAMzB;AAx9JD;;;GAGG;AACH;IAEE,mCAAiB;IAEjB,2BAEC;IA4vJD;;;;OAIG;IACH,+BAFW,SAAS,QAgCnB;IAED;;;;OAIG;IACH,gDA6CC;IA50JD,0BA6CC;IA5CC;;MAIC;IAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAmC;IA6BrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgBC;IAycD;;;;OAIG;IACH,kDAyBC;IA0ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6DC;IA+mGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEC;IAGD,oBAEC;IA8sBD,qBAEC;IACD,yBAEC;IACD,yBAEC;IACD,wBAEC;IACD,yBAMC;IAED;;;;;;OAMG;IACH,oBA6JC;IAGD,4BAEC;IACD,gCAEC;IACD,gCAEC;IACD,+BAEC;IAmBD;;;OAGG;IACH;;;;;;MAoBC;;CA2GF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pure-ds/core",
   "shortname": "pds",
-  "version": "0.4.11",
+  "version": "0.4.13",
   "description": "Pure Design System - Why develop a Design System when you can generate one?",
   "repository": {
     "type": "git",
@@ -28,7 +28,8 @@
   "bin": {
     "pds-export": "packages/pds-cli/bin/pds-static.js",
     "pds-sync-assets": "packages/pds-cli/bin/sync-assets.js",
-    "pds-build-icons": "packages/pds-cli/bin/pds-build-icons.js"
+    "pds-build-icons": "packages/pds-cli/bin/pds-build-icons.js",
+    "pds-setup-copilot": "packages/pds-cli/bin/pds-setup-copilot.js"
   },
   "exports": {
     ".": {
@@ -40,6 +41,8 @@
     "./auto-define/*": "./public/auto-define/*"
   },
   "files": [
+    ".github/copilot-instructions.md",
+    ".cursorrules",
     "dist/types/",
     "public/assets/js/",
     "public/assets/pds/components/",

package/packages/pds-cli/bin/pds-setup-copilot.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+
+/**
+ * PDS Setup Copilot Instructions
+ * 
+ * Copies PDS Copilot instructions to the consuming project's .github folder.
+ * Run: npx pds-setup-copilot
+ * 
+ * Options:
+ *   --force    Overwrite existing copilot-instructions.md even if it's not a PDS file
+ */
+
+import { copyFile, mkdir, readFile, access } from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(__dirname, '../../../');
+
+async function main() {
+  const args = process.argv.slice(2);
+  const force = args.includes('--force') || args.includes('-f');
+  const projectRoot = process.cwd();
+  
+  console.log('📋 PDS Copilot Instructions Setup\n');
+  
+  const sourceFile = path.join(repoRoot, '.github', 'copilot-instructions.md');
+  const targetDir = path.join(projectRoot, '.github');
+  const targetFile = path.join(targetDir, 'copilot-instructions.md');
+  
+  // Verify source exists
+  try {
+    await access(sourceFile);
+  } catch {
+    console.error('❌ Could not find PDS copilot-instructions.md');
+    console.log('   Make sure @pure-ds/core is properly installed.');
+    process.exit(1);
+  }
+  
+  // Create .github directory if it doesn't exist
+  await mkdir(targetDir, { recursive: true });
+  
+  // Check if file already exists
+  try {
+    await access(targetFile);
+    const existingContent = await readFile(targetFile, 'utf8');
+    
+    if (!force && !existingContent.includes('Pure Design System (PDS)')) {
+      console.log('⚠️  Existing .github/copilot-instructions.md found (not PDS)');
+      console.log('   Use --force to overwrite: npx pds-setup-copilot --force');
+      process.exit(0);
+    }
+    
+    if (!force) {
+      console.log('📝 Updating existing PDS Copilot instructions...');
+    } else {
+      console.log('📝 Overwriting existing Copilot instructions (--force)...');
+    }
+  } catch {
+    console.log('📝 Creating new Copilot instructions...');
+  }
+  
+  await copyFile(sourceFile, targetFile);
+  
+  console.log('\n✅ PDS Copilot instructions installed at .github/copilot-instructions.md');
+  
+  // Also copy .cursorrules for Cursor IDE
+  try {
+    const cursorSource = path.join(repoRoot, '.cursorrules');
+    const cursorTarget = path.join(projectRoot, '.cursorrules');
+    
+    try {
+      await access(cursorSource);
+      
+      // Check existing .cursorrules
+      try {
+        await access(cursorTarget);
+        const existingCursor = await readFile(cursorTarget, 'utf8');
+        if (!force && !existingCursor.includes('Pure Design System (PDS)')) {
+          console.log('⚠️  Existing .cursorrules found (not PDS), skipping...');
+        } else {
+          await copyFile(cursorSource, cursorTarget);
+          console.log('✅ PDS instructions also installed at .cursorrules (for Cursor IDE)');
+        }
+      } catch {
+        await copyFile(cursorSource, cursorTarget);
+        console.log('✅ PDS instructions also installed at .cursorrules (for Cursor IDE)');
+      }
+    } catch {
+      // .cursorrules source doesn't exist, skip
+    }
+  } catch {
+    // Optional, don't fail
+  }
+  
+  console.log('\n📚 SSoT files available at node_modules/@pure-ds/core/:');
+  console.log('   • custom-elements.json         (Web Component APIs)');
+  console.log('   • public/assets/pds/pds.css-data.json  (CSS tokens)');
+  console.log('   • src/js/pds-core/pds-ontology.js      (Primitives & utilities)');
+  console.log('   • src/js/pds-core/pds-enhancer-metadata.js (Enhancements)');
+}
+
+main().catch(err => {
+  console.error('❌ Error:', err.message);
+  process.exit(1);
+});

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

@@ -135,6 +135,62 @@ async function ensureExportScript(consumerRoot) {
   }
 }
 
+/**
+ * Copy PDS Copilot instructions to consumer's .github folder
+ */
+async function copyCopilotInstructions(consumerRoot) {
+  try {
+    const sourceFile = path.join(repoRoot, '.github', 'copilot-instructions.md');
+    const targetDir = path.join(consumerRoot, '.github');
+    const targetFile = path.join(targetDir, 'copilot-instructions.md');
+    
+    // Create .github directory if it doesn't exist
+    await mkdir(targetDir, { recursive: true });
+    
+    // Check if file already exists
+    try {
+      await access(targetFile);
+      // File exists - check if it's a PDS file by looking for our marker
+      const existingContent = await readFile(targetFile, 'utf8');
+      if (!existingContent.includes('Pure Design System (PDS)')) {
+        // Not a PDS file, don't overwrite
+        console.log('📋 Existing .github/copilot-instructions.md found (not PDS), skipping...');
+        console.log('   💡 To use PDS instructions, run: npx pds-setup-copilot --force');
+        return;
+      }
+    } catch {
+      // File doesn't exist, we'll create it
+    }
+    
+    await copyFile(sourceFile, targetFile);
+    console.log('📋 Copied PDS Copilot instructions to .github/copilot-instructions.md');
+    
+    // Also copy .cursorrules for Cursor IDE users
+    try {
+      const cursorSource = path.join(repoRoot, '.cursorrules');
+      const cursorTarget = path.join(consumerRoot, '.cursorrules');
+      
+      try {
+        await access(cursorTarget);
+        const existingCursor = await readFile(cursorTarget, 'utf8');
+        if (!existingCursor.includes('Pure Design System (PDS)')) {
+          console.log('📋 Existing .cursorrules found (not PDS), skipping...');
+          return;
+        }
+      } catch {
+        // File doesn't exist
+      }
+      
+      await copyFile(cursorSource, cursorTarget);
+      console.log('📋 Copied PDS instructions to .cursorrules (for Cursor IDE)');
+    } catch (e) {
+      // .cursorrules copy is optional
+    }
+  } catch (e) {
+    console.warn('⚠️  Could not copy Copilot instructions:', e.message);
+  }
+}
+
 /**
  * Discover the web root directory using common patterns
  */
@@ -275,6 +331,9 @@ async function copyPdsAssets() {
     
   console.log('📦 Proceeding with asset copying...');
 
+    // Copy Copilot instructions to consumer project
+    await copyCopilotInstructions(consumerRoot);
+
     // Proactively add export & build-icons scripts to consumer package.json (still helpful)
     await ensureExportScript(consumerRoot);
     try {