Merge pull request #5 from zeixcom/cause-effect-v0-18

Update to Cause & Effect v0.18

Author: estherbrunner

.ai-context.md

@@ -36,12 +36,12 @@ The selector function provides type-safe DOM queries:
 ({ first, all }) => ({
   button?: first('button'),          // HTMLButtonElement | undefined
   input: first('input', 'required'), // HTMLInputElement (throws if missing)
-  items: all('.item'),               // Collection<HTMLElement>
+  items: all('.item'),               // Memo<HTMLElement[]>
   custom?: first<MyElement>('my-el') // Custom typing
 })
 ```
 
-Collections are reactive arrays that emit `add`/`remove` events and track DOM mutations automatically.
+`all()` returns `Memo<E[]>` backed by a lazy `MutationObserver` that tracks DOM mutations automatically.
 
 ### Effect System
 Effects run reactively when dependencies change:
@@ -77,9 +77,10 @@ Effects run reactively when dependencies change:
 - `setStyle(property, reactive)`     - Update inline styles
 
 ### Advanced
-- `pass(props)`                               - Pass properties to child components
-- `dangerouslySetInnerHTML(reactive)`         - Set innerHTML (use carefully)
-- `insertOrRemoveElement(reactive, inserter)` - Dynamic element creation/removal
+- `pass(props)`                               - Pass reactive values to child Le Truc components via Slot signal replacement
+- `dangerouslySetInnerHTML(reactive, opts?)`  - Set innerHTML (use only for trusted sources)
+- `callMethod(name, reactive, args?)`         - Call a method when reactive is truthy
+- `focus(reactive)`                           - Focus element when truthy
 
 ## Parsers
 
@@ -114,23 +115,23 @@ const countSignal = createState(0)
 setText(() => countSignal.get())
 ```
 
-## Collections
+## Element Memos
 
-Read-only reactive element arrays with array-like interface:
+`all()` returns `Memo<E[]>` — a lazily observed collection of elements:
 
 ```typescript
 // Creation
-({ all }) => ({ items: all('.item') })          // In UI query, will be ui.items
-const items = createCollection(parent, '.item') // Elsewhere with arbitrary parent
+({ all }) => ({ items: all('.item') })              // In UI query, will be ui.items
+const items = createElementsMemo(parent, '.item')   // Elsewhere with arbitrary parent
 
 // Access
-items.get()            // Get current elements
-items.length           // Reactive length
-items[0]               // Index access
-items.on('add', fn)    // Listen for additions
-items.on('remove', fn) // Listen for removals
+items.get()            // Get current elements array
+items.get().length     // Current count
+items.get()[0]         // Index access
 ```
 
+The `MutationObserver` backing the memo activates lazily — only when the memo is read from within a reactive effect. This avoids unnecessary observation overhead for memos that aren't actively consumed.
+
 ## Common Patterns
 
 ### Form Components
@@ -222,7 +223,7 @@ export default defineComponent<MyComponentProps, MyComponentUI>(...)
 
 ### Performance
 - Effects automatically optimize re-runs when dependencies don't change
-- Collections efficiently track only actual DOM changes
+- Element memos efficiently track only actual DOM changes via lazy MutationObserver
 - Use `schedule()` for non-critical updates in passive event handlers
 - Proper cleanup prevents memory leaks
 

.github/copilot-instructions.md

@@ -32,7 +32,8 @@ Files to consult for examples and authoritative patterns
 - Selector helpers & mutation-observer logic: `src/ui.ts`
 - Parser implementations: `src/parsers/*.ts` (e.g. `json.ts`, `number.ts`, `string.ts`)
 - Effect implementations: `src/effects/*.ts` (exported from root `index.ts`)
-- Signal helpers: `src/signals/*.ts` (collection, sensor)
+- Event-driven sensors: `src/events.ts` (createEventsSensor)
+- Element memos: `createElementsMemo` in `src/ui.ts`
 - Examples demonstrating usage: `examples/*` (start from `basic-hello` and `basic-counter`)
 
 Developer workflows (essential commands)
@@ -45,7 +46,7 @@ Developer workflows (essential commands)
 What to change (and what to avoid)
 - Change: small refactors that preserve exported API in `index.ts` and `.d.ts` files.
 - Change: add or update examples in `examples/` to demonstrate new or changed behavior.
-- Avoid: breaking changes to public exports without updating `index.ts` / `index.dev.ts` and re-building (`bun run build:dev`).
+- Avoid: breaking changes to public exports without updating `index.ts` and re-building (`bun run build`).
 - Avoid: changing the custom element registration pattern (i.e., calling `customElements.define`) in a way that prevents `getHelpers` dependency detection.
 
 PR guidance / descriptions

.gitignore

@@ -144,3 +144,6 @@ dist
 # Vite logs files
 vite.config.js.timestamp-*
 vite.config.ts.timestamp-*
+
+# Claude
+.claude

.zed/settings.json

@@ -0,0 +1,3 @@
+{
+	"project_name": "Le Truc",
+}