@rogieking/figui3 11.6.11 → 11.6.12

package/.cursor/skills/fig-editor/SKILL.md

@@ -29,6 +29,35 @@ import "@rogieking/figui3/fig-editor.js";
 
 `fig-editor.js` imports `fig.js`. Still import `fig-editor.css`.
 
+### Bundler registration
+
+Editor internals include registration-only modules: importing them defines custom
+elements even when they export no values. Bundlers must preserve those module
+side effects.
+
+If core controls render but palette or gradient editors do not open, check:
+
+```js
+customElements.get("fig-popup-palette");
+```
+
+An `undefined` result after importing `fig-editor.js` means the editor
+registration module was removed, usually by tree-shaking. Upgrade FigUI3 first.
+For affected older releases, use this temporary Vite workaround:
+
+```ts
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  optimizeDeps: { esbuildOptions: { treeShaking: false } },
+  build: { rollupOptions: { treeshake: false } },
+});
+```
+
+Remove the workaround after upgrading to a release whose package metadata marks
+all JavaScript and CSS files as side-effectful. See the shared
+[React guide](../figui3/react.md#bundler-registration) for details.
+
 Registered tags:
 
 | Tag | Role |

package/.cursor/skills/figui3/react.md

@@ -32,6 +32,41 @@ await import("@rogieking/figui3/fig-lab.js");
 
 SSR (Next/Remix/Astro): import the JS only on the client.
 
+## Bundler registration
+
+FigUI3 JavaScript includes registration-only modules. Their imports define
+custom elements even when they export no values, so bundlers must preserve
+their side effects.
+
+When core components work but an editor is missing, diagnose registration after
+importing `fig-editor.js`:
+
+```js
+customElements.get("fig-popup-palette");
+```
+
+An `undefined` result means a registration module was not evaluated, usually
+because an affected FigUI3 package version let the bundler tree-shake it.
+Upgrade FigUI3 first. As a temporary Vite workaround for affected versions,
+disable dependency and production tree-shaking:
+
+```ts
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  optimizeDeps: { esbuildOptions: { treeShaking: false } },
+  build: { rollupOptions: { treeshake: false } },
+});
+```
+
+Remove this workaround after upgrading. Corrected releases declare:
+
+```json
+{
+  "sideEffects": ["**/*.js", "**/*.css"]
+}
+```
+
 ## JSX types
 
 ```ts

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [11.6.12]
+
+### Changed
+
+- Preserved all JavaScript registration modules and CSS files during bundler tree-shaking.
+- Documented editor registration diagnosis and a temporary Vite workaround for older affected releases.
+
 ## [11.6.11]
 
 ### Fixed