jj 2.3.0 → 2.5.0

package/llms.txt

@@ -0,0 +1,214 @@
+# JJ: The DOM Library for AI-Assisted Development
+
+## What is JJ?
+
+JJ is a minimal, imperative DOM manipulation library designed for modern web development. It provides small wrapper classes around DOM interfaces with a fluent API for chaining operations. JJ is zero-dependency, TypeScript-first, and optimized for AI-assisted code generation.
+
+## Core Principles
+
+1. **Imperative by Design**: Direct DOM manipulation without virtual DOM overhead.
+2. **Type-Safe**: Full TypeScript support with precise generic types for one-shot LLM correctness.
+3. **Chainable**: All public methods support fluent chaining.
+4. **Zero Build**: Works directly in browsers via ESM imports or bundled script tags.
+5. **Self-Correcting Errors**: Error messages suggest the correct approach.
+
+## Main Classes
+
+- **JJD**: Wraps `Document`. Entry point for querying and creating elements.
+- **JJN**: Wraps `Node`. Base for other wrappers.
+- **JJE**: Wraps `Element`. Generic element wrapper.
+- **JJHE**: Wraps `HTMLElement`. Extends JJE with HTML-specific methods.
+- **JJT**: Wraps `Text`. Text node operations.
+- **JJSR**: Wraps `ShadowRoot`. Shadow DOM operations.
+- **JJDF**: Wraps `DocumentFragment`. Fragment operations.
+- **JJSE**: Wraps `StyleSheet`. Style operations.
+
+## Quick Start
+
+```typescript
+import { JJD } from 'jj';
+
+// Query an element
+const btn = JJD.from(document).query('button#submit');
+
+// Set attributes and classes
+btn.attr('disabled', 'true').addClass('highlight');
+
+// Listen to events
+btn.on('click', () => console.log('Clicked!'));
+
+// Create and append elements
+const div = JJD.from(document).create('div').setText('Hello, World!');
+btn.parentNode?.appendChild(div.ref);
+```
+
+## Patterns and Examples
+
+### Creating Elements
+
+```typescript
+const el = JJD.from(document).create('div').addClass('container');
+```
+
+### Querying Elements
+
+```typescript
+const btn = JJD.from(document).query('.btn');
+const buttons = JJD.from(document).queryAll('button');
+```
+
+### Manipulating Classes
+
+```typescript
+el.addClass('active').removeClass('disabled').toggleClass('visible');
+```
+
+### Setting Attributes and Properties
+
+```typescript
+el.attr('data-id', '42').prop('disabled', false);
+```
+
+### Listening to Events
+
+```typescript
+el.on('click', (e) => { /* handle click */ });
+el.off('click');
+```
+
+### Styling
+
+```typescript
+el.style('background-color', 'blue').style('padding', '10px');
+```
+
+### Accessing the Underlying Node
+
+Every JJ wrapper exposes `.ref` to access the underlying DOM node:
+
+```typescript
+const nativeElement = el.ref; // HTMLElement
+```
+
+## For LLMs: Translation Patterns
+
+### React to JJ
+
+**React**: State-driven component re-renders on state change.
+```tsx
+const [count, setCount] = useState(0);
+return <button onClick={() => setCount(count + 1)}>{count}</button>;
+```
+
+**JJ**: Direct DOM mutation and event binding.
+```typescript
+let count = 0;
+const btn = JJD.from(document).create('button').setText('0');
+btn.on('click', () => {
+  count++;
+  btn.setText(String(count));
+});
+```
+
+### jQuery to JJ
+
+**jQuery**: Chainable DOM manipulation with `$()` selector.
+```javascript
+$('.box').addClass('active').css('color', 'red');
+```
+
+**JJ**: Similar chainable API with type safety.
+```typescript
+JJD.from(document).query('.box').addClass('active').style('color', 'red');
+```
+
+### Vue to JJ
+
+**Vue**: Template-driven, two-way binding.
+```vue
+<div>
+  <input v-model="message" />
+  <p>{{ message }}</p>
+</div>
+```
+
+**JJ**: Imperative setup with manual event binding.
+```typescript
+const input = JJD.from(document).create('input');
+const p = JJD.from(document).create('p');
+input.on('input', (e) => {
+  p.setText((e.target as HTMLInputElement).value);
+});
+```
+
+### Svelte to JJ
+
+**Svelte**: Reactive variables and automatic re-renders.
+```svelte
+<script>
+  let count = 0;
+</script>
+<button on:click={() => count++}>{count}</button>
+```
+
+**JJ**: Manual DOM updates on events.
+```typescript
+let count = 0;
+const btn = JJD.from(document).create('button').setText('0');
+btn.on('click', () => {
+  count++;
+  btn.setText(String(count));
+});
+```
+
+## TypeScript Type Safety
+
+JJ leverages TypeScript generics to ensure type safety. For example:
+
+```typescript
+const input = JJD.from(document).fromTag('input');
+// input is JJHE<HTMLInputElement>, so input.ref.value is known to exist
+
+const div = JJD.from(document).fromTag('div');
+// div is JJHE<HTMLDivElement>, so input.ref.value would be a type error
+```
+
+This prevents LLM hallucinations about non-existent properties.
+
+## Common Gotchas
+
+1. **Accessing the Native Node**: Always use `.ref` to access the underlying DOM node for operations not exposed by JJ.
+2. **Event Listeners**: Use `.on()` and `.off()` for proper cleanup.
+3. **Fragments**: Use JJDF for batch operations before appending.
+4. **Error Messages**: Read them carefully—they suggest the correct approach.
+
+## Testing
+
+JJ uses Node's built-in test runner with `tsx`:
+
+```bash
+npm test
+```
+
+Tests are colocated with source files as `*.test.ts`.
+
+## Building
+
+```bash
+npm run build
+```
+
+This runs TypeScript compilation, creates an ESM bundle and minified variant, and generates documentation.
+
+## Resources
+
+- **GitHub**: https://github.com/alexewerlof/jj
+- **Documentation**: https://jj.rocks/doc/
+- **Examples**: https://jj.rocks/examples/
+
+## For Best Results with LLMs
+
+1. When asking an LLM to help with JJ code, provide a snippet of the desired DOM structure.
+2. Reference the translation patterns above when converting from React, Vue, Svelte, or jQuery.
+3. Ask the LLM to use `.ref` when accessing native properties not exposed by JJ.
+4. Expect type errors to be self-documenting—they guide toward the correct API.

package/package.json

@@ -1,13 +1,18 @@
 {
     "name": "jj",
-    "version": "2.3.0",
+    "version": "2.5.0",
     "description": "A minimal DOM manipulation library with web components",
     "keywords": [
         "javascript",
         "language",
         "DOM",
         "typescript",
-        "imperative programming"
+        "imperative programming",
+        "no-build",
+        "ai-friendly",
+        "llm-optimized",
+        "cursor-rules",
+        "zero-dependency"
     ],
     "type": "module",
     "main": "./lib/index.js",
@@ -32,7 +37,8 @@
         "test": "test"
     },
     "files": [
-        "lib"
+        "lib",
+        "llms.txt"
     ],
     "scripts": {
         "doc": "typedoc src/index.ts",
@@ -54,8 +60,10 @@
     "author": "Alex Ewerlöf",
     "license": "MIT",
     "devDependencies": {
+        "@types/jsdom": "^27.0.0",
         "@types/node": "^24.7.2",
         "esbuild": "^0.27.2",
+        "jsdom": "^27.4.0",
         "prettier": "^3.6.2",
         "tsx": "^4.20.6",
         "typedoc": "^0.28.14",

package/lib/case.test.js

@@ -1,79 +0,0 @@
-import { describe, it } from 'node:test';
-import assert from 'node:assert';
-import { pas2keb, keb2pas, keb2cam } from './case.js';
-describe('pas2keb()', () => {
-    it('throws for non-string input', () => {
-        assert.throws(() => pas2keb(123), TypeError, 'Should throw for a number');
-        assert.throws(() => pas2keb(true), TypeError, 'Should throw for a boolean');
-        assert.throws(() => pas2keb(null), TypeError, 'Should throw for null');
-        assert.throws(() => pas2keb(undefined), TypeError, 'Should throw for undefined');
-    });
-    it('converts PascalCase or camelCase to kebab-case', () => {
-        assert.strictEqual(pas2keb('PascalCase'), 'pascal-case');
-        assert.strictEqual(pas2keb('camelCase'), 'camel-case');
-        assert.strictEqual(pas2keb('Hello'), 'hello');
-    });
-    it('handles consecutive uppercase letters', () => {
-        assert.strictEqual(pas2keb('MyHTMLElement'), 'my-html-element');
-        assert.strictEqual(pas2keb('isURL'), 'is-url');
-        assert.strictEqual(pas2keb('isURLShortener'), 'is-url-shortener');
-    });
-    it('handles edge cases', () => {
-        assert.strictEqual(pas2keb(''), '', 'Should handle empty string');
-        assert.strictEqual(pas2keb('A'), 'a');
-        assert.strictEqual(pas2keb('I'), 'i');
-    });
-    it('converts snake_case to kebab-case', () => {
-        assert.strictEqual(pas2keb('snake_case'), 'snake-case');
-        assert.strictEqual(pas2keb('Snake_Case'), 'snake-case');
-    });
-});
-describe('keb2pas()', () => {
-    it('throws for non-string input', () => {
-        assert.throws(() => keb2pas(123), TypeError, 'Should throw for a number');
-        assert.throws(() => keb2pas(true), TypeError, 'Should throw for a boolean');
-        assert.throws(() => keb2pas(null), TypeError, 'Should throw for null');
-        assert.throws(() => keb2pas(undefined), TypeError, 'Should throw for undefined');
-    });
-    it('converts kebab-case to PascalCase', () => {
-        assert.strictEqual(keb2pas('kebab-case'), 'KebabCase');
-        assert.strictEqual(keb2pas('a-b-c'), 'ABC');
-        assert.strictEqual(keb2pas('single'), 'Single');
-        assert.strictEqual(keb2pas('a'), 'A');
-    });
-    it('handles edge cases correctly', () => {
-        assert.strictEqual(keb2pas(''), '', 'Should handle empty string');
-        assert.strictEqual(keb2pas('foo--bar'), 'FooBar', 'Should handle multiple hyphens');
-        assert.strictEqual(keb2pas('-foo-bar'), 'FooBar', 'Should handle leading hyphen');
-        assert.strictEqual(keb2pas('foo-bar-'), 'FooBar', 'Should handle trailing hyphen');
-    });
-    it('does not convert other cases', () => {
-        assert.strictEqual(keb2pas('camelCase'), 'CamelCase', 'Should only capitalize first letter for camelCase');
-        assert.strictEqual(keb2pas('snake_case'), 'Snake_case', 'Should not convert snake_case');
-    });
-});
-describe('keb2cam()', () => {
-    it('throws for non-string input', () => {
-        assert.throws(() => keb2cam(123), TypeError, 'Should throw for a number');
-        assert.throws(() => keb2cam(true), TypeError, 'Should throw for a boolean');
-        assert.throws(() => keb2cam(null), TypeError, 'Should throw for null');
-        assert.throws(() => keb2cam(undefined), TypeError, 'Should throw for undefined');
-    });
-    it('converts kebab-case to camelCase', () => {
-        assert.strictEqual(keb2cam('kebab-case'), 'kebabCase');
-        assert.strictEqual(keb2cam('a-b-c'), 'aBC');
-        assert.strictEqual(keb2cam('background-color'), 'backgroundColor');
-    });
-    it('handles edge cases correctly', () => {
-        assert.strictEqual(keb2cam(''), '', 'Should handle empty string');
-        assert.strictEqual(keb2cam('single'), 'single', 'Should handle a single word');
-        assert.strictEqual(keb2cam('-foo-bar'), 'fooBar', 'Should handle leading hyphen');
-        assert.strictEqual(keb2cam('baz-quux-'), 'bazQuux', 'Should handle trailing hyphen');
-        assert.strictEqual(keb2cam('car--tux'), 'carTux', 'Should handle multiple hyphens');
-    });
-    it('does not convert other cases', () => {
-        assert.strictEqual(keb2cam('camelCase'), 'camelCase', 'Should not change camelCase');
-        assert.strictEqual(keb2cam('snake_case'), 'snake_case', 'Should not convert snake_case');
-    });
-});
-//# sourceMappingURL=case.test.js.map

package/lib/case.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"case.test.js","sourceRoot":"","sources":["../src/case.test.ts"],"names":[],"mappings":"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"}

package/lib/mixin-types.d.ts

@@ -1,143 +0,0 @@
-import { Wrappable, Wrapped } from './types.js';
-export interface IById {
-    /**
-     * Finds an element by ID within this context.
-     *
-     * @param id - The ID to search for.
-     * @param throwIfNotFound - Whether to throw an error if not found. Defaults to true.
-     * @returns The wrapped element, or null if not found and throwIfNotFound is false.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelector | Element.querySelector}
-     */
-    byId(id: string, throwIfNotFound?: boolean): Wrapped | null;
-}
-export interface IAppendPrepend {
-    /**
-     * Appends children to this node.
-     *
-     * @param children - The children to append (Nodes, strings, or Wrappers).
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/append | Element.append}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/append | Document.append}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/append | DocumentFragment.append}
-     */
-    append(...children: Wrappable[]): this;
-    /**
-     * Prepends children to this node.
-     *
-     * @param children - The children to prepend.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/prepend | Element.prepend}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/prepend | Document.prepend}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/prepend | DocumentFragment.prepend}
-     */
-    prepend(...children: Wrappable[]): this;
-    /**
-     * Replaces the existing children of a node with a specified new set of children.
-     *
-     * @remarks
-     * If no children are provided, it empties the node.
-     *
-     * @param this - The JJE, JJD or JJDF instance.
-     * @param children - The children to replace with.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceChildren | Element.replaceChildren}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/replaceChildren | Document.replaceChildren}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/replaceChildren | DocumentFragment.replaceChildren}
-     */
-    replaceChildren(...children: Wrappable[]): this;
-    /**
-     * Removes all children.
-     *
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/replaceChildren | Element.replaceChildren}
-     */
-    empty(): this;
-}
-export interface IQuery {
-    /**
-     * Finds the first element matching a selector within this context.
-     *
-     * @param selector - The CSS selector.
-     * @param throwIfNotFound - Whether to throw an error if not found. Defaults to true.
-     * @returns The wrapped element, or null.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelector | Element.querySelector}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector | Document.querySelector}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/querySelector | DocumentFragment.querySelector}
-     */
-    query(selector: string, throwIfNotFound?: boolean): Wrapped | null;
-    /**
-     * Finds all elements matching a selector within this context.
-     *
-     * @param selector - The CSS selector.
-     * @returns An array of wrapped elements.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelectorAll | Element.querySelectorAll}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll | Document.querySelectorAll}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/DocumentFragment/querySelectorAll | DocumentFragment.querySelectorAll}
-     */
-    queryAll(selector: string): Wrapped[];
-}
-export interface IElementData {
-    /**
-     * Gets a data attribute value.
-     *
-     * @remarks
-     * Accesses the `dataset` property. Keys should be in camelCase.
-     *
-     * @example
-     * ```ts
-     * // <div data-user-id="123"></div>
-     * div.getData('userId') // '123'
-     * ```
-     *
-     * @param name - The data attribute name (camelCase).
-     * @returns The value or undefined.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement/dataset | SVGElement.dataset}
-     */
-    getData(name: string): string | undefined;
-    /**
-     * Checks if a data attribute exists.
-     *
-     * @param name - The data attribute name (camelCase).
-     * @returns `true` if it exists.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement/dataset | SVGElement.dataset}
-     */
-    hasData(name: string): boolean;
-    /**
-     * Sets a data attribute.
-     *
-     * @example
-     * ```ts
-     * div.setData('userId', '123') // sets data-user-id="123"
-     * ```
-     *
-     * @param name - The data attribute name (camelCase).
-     * @param value - The value to set.
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement/dataset | SVGElement.dataset}
-     */
-    setData(name: string, value: string): this;
-    /**
-     * Sets multiple data attributes.
-     *
-     * @example
-     * ```ts
-     * div.setDataObj({ userId: '123', role: 'admin' })
-     * ```
-     *
-     * @param obj - An object of data keys and values.
-     * @returns This instance for chaining.
-     */
-    setDataObj(obj: Record<string, string>): this;
-    /**
-     * Removes a data attribute.
-     *
-     * @param name - The data attribute name (camelCase).
-     * @returns This instance for chaining.
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset | HTMLElement.dataset}
-     * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/SVGElement/dataset | SVGElement.dataset}
-     */
-    rmData(name: string): this;
-}

package/lib/mixin-types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=mixin-types.js.map

package/lib/mixin-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mixin-types.js","sourceRoot":"","sources":["../src/mixin-types.ts"],"names":[],"mappings":""}

package/lib/mixins.d.ts

@@ -1,94 +0,0 @@
-import { JJN } from './JJN.js';
-import { Unwrapped, Wrappable, Wrapped } from './types.js';
-export declare const wrapAll: typeof JJN.wrapAll, unwrapAll: typeof JJN.unwrapAll;
-/**
- * Wraps a native DOM node or string into the most specific JJ wrapper available.
- *
- * @remarks
- * This function acts as a factory, inspecting the input type and returning the appropriate
- * subclass of `JJN` (e.g., `JJHE` for `HTMLElement`, `JJT` for `Text`).
- *
- * @example
- * ```ts
- * const bodyWrapper = JJN.wrap(document.body) // Returns JJHE
- * const textWrapper = JJN.wrap('Hello') // Returns JJT wrapping a new Text node
- * ```
- *
- * @param raw - The object to wrap. If it's already Wrapped, it'll be returned without any change. We don't double-wrap or clone it.
- * @returns The most granular Wrapped subclass instance. If the input is already wrapped, it'll be returned as is without cloning.
- * @throws {TypeError} If the input is not a Node, string, or JJ wrapper.
- */
-export declare function wrap(raw: Wrappable): Wrapped;
-/**
- * Extracts the underlying native DOM node from a wrapper.
- *
- * @remarks
- * If the input is already a native Node, it is returned as is.
- * If the input is a string, a new Text node is created and returned.
- *
- * @example
- * ```ts
- * const rawElement = JJN.unwrap(myJJHE) // Returns HTMLElement
- * ```
- *
- * @param obj - The object to unwrap.
- * @returns The underlying DOM node.
- * @throws {TypeError} If the input cannot be unwrapped.
- */
-export declare function unwrap(obj: Wrappable): Unwrapped;
-/**
- * Finds an element by ID in the document.
- *
- * @example
- * ```ts
- * const el = byId('my-id')
- * ```
- *
- * @param id - The ID to search for.
- * @param throwIfNotFound - Whether to throw an error if not found. Defaults to true.
- * @returns The wrapped element, or null if not found and throwIfNotFound is false.
- * @throws {TypeError} If the element is not found and throwIfNotFound is true.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementById | Document.getElementById}
- */
-export declare function byId(id: string, throwIfNotFound?: boolean): Wrapped | null;
-/**
- * Finds elements by class name in the document.
- *
- * @example
- * ```ts
- * const items = byClass('list-item')
- * ```
- *
- * @param className - The class name to search for.
- * @returns An array of wrapped elements.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName | Document.getElementsByClassName}
- */
-export declare function byClass(className: string): Wrapped[];
-/**
- * Finds the first element matching a selector in the document.
- *
- * @example
- * ```ts
- * const btn = query('.submit-btn')
- * ```
- *
- * @param selector - The CSS selector.
- * @param throwIfNotFound - Whether to throw an error if not found. Defaults to true.
- * @returns The wrapped element, or null.
- * @throws {TypeError} If not found and throwIfNotFound is true.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector | Document.querySelector}
- */
-export declare function query(selector: string, throwIfNotFound?: boolean): Wrapped | null;
-/**
- * Finds all elements matching a selector in the document.
- *
- * @example
- * ```ts
- * const inputs = queryAll('input[type="text"]')
- * ```
- *
- * @param selector - The CSS selector.
- * @returns An array of wrapped elements.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll | Document.querySelectorAll}
- */
-export declare function queryAll(selector: string): Wrapped[];