@pure-ds/core 0.5.39 → 0.5.41

package/.cursorrules

@@ -359,12 +359,14 @@ This component uses `import { ... } from "#pds/lit"` and **requires** an import
 <script type="importmap">
 {
   "imports": {
-    "#pds/lit": "/assets/js/lit.js"
+    "#pds/lit": "/assets/pds/external/lit.js"
   }
 }
 </script>
 ```
 
+**Note:** `#pds/lit` is a convenience bundle that re-exports Lit and adds PDS helpers (`lazyProps`, `msg()`, `loadLocale()`). If a project prefers its own Lit bundle, it must provide equivalents and map `#pds/lit` accordingly.
+
 **When generating code with lazy-loaded components, ALWAYS wait for definition:**
 
 ```javascript

package/.github/copilot-instructions.md

@@ -359,12 +359,14 @@ This component uses `import { ... } from "#pds/lit"` and **requires** an import
 <script type="importmap">
 {
   "imports": {
-    "#pds/lit": "/assets/js/lit.js"
+    "#pds/lit": "/assets/pds/external/lit.js"
   }
 }
 </script>
 ```
 
+**Note:** `#pds/lit` is a convenience bundle that re-exports Lit and adds PDS helpers (`lazyProps`, `msg()`, `loadLocale()`). If a project prefers its own Lit bundle, it must provide equivalents and map `#pds/lit` accordingly.
+
 **When generating code with lazy-loaded components, ALWAYS wait for definition:**
 
 ```javascript

package/dist/types/public/assets/pds/components/pds-fab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pds-fab.d.ts","sourceRoot":"","sources":["../../../../../../public/assets/pds/components/pds-fab.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IAkBE,0CAEC;IAUD,cANU,OAAO,EAsBhB;IAxBD;;;;OAIG;IACH,YAHU,OAAO,CAKhB;IA4BD,gBAPU,MAAM,EAef;IAjBD;;;;;OAKG;IACH,cAJU,MAAM,CAMf;IAoBD,gBAPU,MAAM,EAef;IAjBD;;;;;OAKG;IACH,cAJU,MAAM,CAMf;IAyBD,oBAPU,MAAM,EAef;IAtBD;;;;;;;;;;OAUG;IACH,kBAJU,MAAM,CAMf;IAkBD,oBALU,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,EAa7E;IAfD;;;OAGG;IACH,kBAFU,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAI7E;IAWD,oEAsCC;IAED,0BAKC;IAED,6BAEC;;CA6YF"}
+{"version":3,"file":"pds-fab.d.ts","sourceRoot":"","sources":["../../../../../../public/assets/pds/components/pds-fab.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH;IAkBE,0CAEC;IAUD,cANU,OAAO,EAsBhB;IAxBD;;;;OAIG;IACH,YAHU,OAAO,CAKhB;IA4BD,gBAPU,MAAM,EAef;IAjBD;;;;;OAKG;IACH,cAJU,MAAM,CAMf;IAoBD,gBAPU,MAAM,EAef;IAjBD;;;;;OAKG;IACH,cAJU,MAAM,CAMf;IAyBD,oBAPU,MAAM,EAef;IAtBD;;;;;;;;;;OAUG;IACH,kBAJU,MAAM,CAMf;IAkBD,oBALU,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,EAa7E;IAfD;;;OAGG;IACH,kBAFU,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAI7E;IAWD,oEAsCC;IAED,0BAKC;IAED,6BAEC;;CA2YF"}

package/dist/types/src/js/lit.d.ts

@@ -15,10 +15,29 @@ export { until } from "lit/directives/until.js";
 export { unsafeHTML } from "lit/directives/unsafe-html.js";
 export { unsafeSVG } from "lit/directives/unsafe-svg.js";
 export { msg } from "./common/msg.js";
+/**
+ * Applies properties to an element after it's defined (for lazy-loaded components)
+ * @param {Object} props - Properties to set on the element
+ * @returns {import('lit/directive.js').DirectiveResult}
+ */
+export const lazyProps: (_props?: any) => import("lit-html/directive.js").DirectiveResult<typeof LazyPropsDirective>;
 import { LitElement } from "lit";
 import { nothing } from "lit";
 import { svg } from "lit";
 import { render } from "lit";
+/**
+ * Directive that waits for a custom element to be defined before setting properties
+ * Useful for lazy-loaded web components
+ *
+ * @example
+ * html`<pds-fab ${lazyProps({ satellites: [...], open: true })}></pds-fab>`
+ */
+declare class LazyPropsDirective extends Directive {
+    render(_props: any): symbol;
+    update(part: any, [props]: [any]): symbol;
+    #private;
+}
+import { Directive } from "lit/directive.js";
 export { LitElement, nothing, svg, render };
 export { ref, createRef } from "lit/directives/ref.js";
 export { html as staticHtml, unsafeStatic } from "lit/static-html.js";

package/dist/types/src/js/lit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lit.d.ts","sourceRoot":"","sources":["../../../../src/js/lit.js"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,0DAMC;AAhCD,0CAA0C;AAC1C,mBADW,cAAc,OAAO,EAAE,IAAI,CACV;AAE5B,yCAAyC;AACzC,kBADW,cAAc,OAAO,EAAE,GAAG,CACX;;;;;;;;;2BARuD,KAAK;wBAAL,KAAK;oBAAL,KAAK;uBAAL,KAAK"}
+{"version":3,"file":"lit.d.ts","sourceRoot":"","sources":["../../../../src/js/lit.js"],"names":[],"mappings":"AAiFA;;;GAGG;AACH,0DAMC;AAtFD,0CAA0C;AAC1C,mBADW,cAAc,OAAO,EAAE,IAAI,CACV;AAE5B,yCAAyC;AACzC,kBADW,cAAc,OAAO,EAAE,GAAG,CACX;;;;;;;;;AAiE1B;;;;GAIG;AACH,qHAAuD;2BA9E0B,KAAK;wBAAL,KAAK;oBAAL,KAAK;uBAAL,KAAK;AA4BtF;;;;;;GAMG;AACH;IAIE,4BAEC;IAED,0CAaC;;CAeF;0BA7CoC,kBAAkB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pure-ds/core",
   "shortname": "pds",
-  "version": "0.5.39",
+  "version": "0.5.41",
   "description": "Pure Design System - Why develop a Design System when you can generate one?",
   "repository": {
     "type": "git",
@@ -48,6 +48,7 @@
     "dist/types/",
     "public/assets/js/",
     "public/assets/pds/components/",
+    "public/assets/pds/external/",
     "public/assets/pds/vscode-custom-data.json",
     "public/assets/pds/pds.css-data.json",
     "public/assets/pds/pds-css-complete.json",

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

@@ -447,6 +447,22 @@ async function main(options = {}) {
     log(`⚠️  Failed to copy pds-manager.js: ${e?.message || e}`, 'yellow');
   }
 
+  // 4c) Copy Lit bundle into target/external for #pds/lit import map
+  try {
+    const litSource = path.join(repoRoot, 'public/assets/js/lit.js');
+    if (!existsSync(litSource)) {
+      log('⚠️  lit.js not found in package assets; skipping copy', 'yellow');
+    } else {
+      const externalDir = path.join(targetDir, 'external');
+      await mkdir(externalDir, { recursive: true });
+      const litTarget = path.join(externalDir, 'lit.js');
+      await copyFile(litSource, litTarget);
+      log(`✅ Copied Lit bundle → ${path.relative(process.cwd(), litTarget)}`, 'green');
+    }
+  } catch (e) {
+    log(`⚠️  Failed to copy lit.js: ${e?.message || e}`, 'yellow');
+  }
+
   // 5) Generate CSS layers into target/styles
   log('🧬 Generating styles...', 'bold');
   const { Generator } = await loadGenerator();
@@ -588,6 +604,7 @@ async function main(options = {}) {
   log('✅ PDS static assets ready', 'green');
   log(`📍 Location: ${path.relative(process.cwd(), targetDir)}`);
   log('• components → components/*.js');
+  log('• external → external/lit.js');
   log('• styles → styles/pds-*.css (+ .css.js modules)');
   log('• intellisense → custom-elements.json, vscode-custom-data.json');
   log('• intellisense → pds.css-data.json, pds-css-complete.json');

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

@@ -12,7 +12,7 @@
     <script type="importmap">
       {
         "imports": {
-          "#pds/lit": "/assets/js/lit.js"
+          "#pds/lit": "/assets/pds/external/lit.js"
         }
       }
     </script>