jj 2.4.0 → 2.6.0

package/lib/helpers.js

@@ -1,231 +0,0 @@
-import { isA, isStr } from 'jty';
-import { JJHE } from './JJHE.js';
-import { cssToStyle, fileExt } from './util.js';
-/**
- * Hyperscript helper to create JJHE instances.
- * The `h` function provides a concise way to create DOM wrappers with attributes and children,
- * similar to hyperscript helpers found in other libraries.
- *
- *
- * @remarks
- * It returns a `JJHE` instance which wraps the native HTMLElement.
- *
- * You may recognize it from other libraries:
- * - [React](https://react.dev/reference/react/createElement)
- * - [Vue](https://vuejs.org/guide/extras/render-function)
- * - [Hyperscript](https://github.com/hyperhype/hyperscript)
- * - [Angular](https://angular.dev/guide/components/programmatic-rendering)
- * - [Lit](https://lit.dev/docs/components/rendering/)
- *
- * This is not exactly a replacement, but it roughly follows the same idea.
- *
- * @example
- * ```ts
- * // Create a simple div
- * h('div', { id: 'app' }, 'Hello World')
- *
- * // Create a nested structure
- * h('ul', { class: 'list' },
- *   h('li', null, 'Item 1'),
- *   h('li', null, 'Item 2')
- * )
- * ```
- *
- * @param tagName - The HTML tag name.
- * @param attributes - Attributes to set on the element. Can be null or undefined.
- * @param children - Children to append (strings, nodes, or other JJHE instances).
- * @returns The created JJHE instance.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement | document.createElement}
- */
-export function h(tagName, attributes, ...children) {
-    const ret = JJHE.fromTag(tagName).append(...children);
-    if (attributes) {
-        ret.setAttrs(attributes);
-    }
-    return ret;
-}
-/**
- * Tries to find the best match for the link.as attribute when it's omitted
- * @param href a relative, absolute, or URL resource
- * @returns a valid value for the link.as attribute
- * @throws {TypeError} if it cannot guess a valid value for the 'link.as' attribute
- */
-function linkAs(href) {
-    switch (fileExt(href)) {
-        case 'html':
-        case 'htm':
-        case 'md':
-            return 'fetch';
-        case 'css':
-            return 'style';
-        case 'js':
-        case 'mjs':
-        case 'cjs':
-            return 'script';
-        default:
-            throw new Error(`No 'as' attribute was specified and we failed to guess it from the URL: ${href}`);
-    }
-}
-/**
- * Creates a `<link>` element for prefetching or preloading resources.
- *
- * @remarks
- * This function validates the input arguments and returns a wrapped `JJHE` instance.
- * It does not append the element to the document.
- *
- * @param rel - The relationship of the linked resource ('prefetch' or 'preload').
- * @param href - The URL of the resource.
- * @param as - The type of content being loaded ('fetch' for HTML, 'style' for CSS, or 'script' for JavaScript files).
- * If it's not provided or set to a falsy value, it runs heuristics to find the best match from the href parameter.
- *
- * @returns The JJHE instance representing the link element. The `<link>` is accessible via `.ref`
- * @throws {TypeError} If `href` is not a string or URL.
- * @throws {RangeError} If `rel` or `as` are not valid values.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/preload | Link types: preload}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/prefetch | Link types: prefetch}
- */
-export function createLinkPre(rel, href, as) {
-    if (!isStr(href)) {
-        if (!isA(href, URL)) {
-            throw new TypeError(`Expected a string or URL. Got ${href} (${typeof href})`);
-        }
-        href = href.toString();
-    }
-    if (!['prefetch', 'preload'].includes(rel)) {
-        throw new RangeError(`rel should be one of 'prefetch' or 'preload'. Got ${rel} (${typeof rel})`);
-    }
-    if (!as) {
-        as = linkAs(href);
-        if (!as) {
-            throw new Error(`No 'as' attribute was specified and we failed to guess it from the URL: ${href}`);
-        }
-    }
-    if (!['fetch', 'style', 'script'].includes(as)) {
-        throw new RangeError(`as should be one of 'fetch' or 'style'. Got ${as} (${typeof as})`);
-    }
-    return JJHE.fromTag('link').setAttrs({
-        rel,
-        href,
-        as,
-    });
-}
-/**
- * Adds a `<link>` tag to the document head for prefetching or preloading resources.
- *
- * @remarks
- * This function helps in optimizing performance by telling the browser to fetch resources
- * that might be needed later (prefetch) or are needed immediately (preload).
- *
- * Please refer to {@link createLinkPre} for more details.
- *
- * @example
- * ```ts
- * // Preload a script
- * addLinkPre('https://example.com/script.js', 'preload', 'script')
- *
- * // Prefetch a future page's CSS
- * addLinkPre('/next-page.css', 'prefetch', 'style')
- * ```
- *
- * @returns The JJHE instance representing the link element.
- * @throws {TypeError} If `href` is not a string or URL.
- * @throws {RangeError} If `rel` or `as` are not valid values.
- * @see {@link createLinkPre}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/preload | Link types: preload}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/prefetch | Link types: prefetch}
- */
-export function addLinkPre(...args) {
-    const link = createLinkPre(...args);
-    document.head.append(link.ref);
-    return link;
-}
-/**
- * Fetches a file and returns its contents as string.
- *
- * @remarks
- * This is a wrapper around the native `fetch` API that handles the response status check
- * and text extraction. It sets the `Accept` header based on the provided mime type.
- *
- * @example
- * ```ts
- * const text = await fetchText('https://example.com/data.txt')
- * ```
- *
- * @param url - The file location.
- * @param mime - The HTTP Request Accept header. Defaults to 'text/*'.
- * @returns The file contents as a string.
- * @throws {TypeError} If `mime` is not a string.
- * @throws {Error} If the fetch fails or the response status is not OK (200-299).
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API | Fetch API}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Response/text | Response.text()}
- */
-export async function fetchText(url, mime = 'text/*') {
-    if (!isStr(mime)) {
-        throw new TypeError(`Expected a string mime like 'text/html' or 'text/css'. Got ${mime} (${typeof mime})`);
-    }
-    const response = await fetch(url, { headers: { Accept: mime } });
-    if (!response.ok) {
-        throw new Error(`GET ${url} failed: ${response.status} ${response.statusText}`);
-    }
-    return response.text();
-}
-/**
- * Fetches the contents of a HTML file as string.
- *
- * @remarks
- * Useful for loading HTML templates dynamically.
- * You can use `import.meta.resolve('./relative-path-to.html')` to resolve paths relative to the current module.
- *
- * @example
- * ```ts
- * const template = await fetchHtml('./template.html')
- * ```
- *
- * @param url - The HTML file location.
- * @returns The file content as a string.
- * @throws {Error} If the response is not ok.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types | MIME types}
- */
-export async function fetchHtml(url) {
-    return await fetchText(url, 'text/html');
-}
-/**
- * Fetches the contents of a CSS file as string.
- *
- * @remarks
- * You can use `import.meta.resolve('./relative-path-to.css')` inside components to resolve relative paths.
- *
- * @example
- * ```ts
- * const css = await fetchCss('./style.css')
- * ```
- *
- * @param url - The CSS file location.
- * @returns The file content as a string.
- * @throws {Error} If the response is not ok.
- */
-export async function fetchCss(url) {
-    return await fetchText(url, 'text/css');
-}
-/**
- * Fetches a CSS file and constructs a CSSStyleSheet.
- *
- * @remarks
- * This is particularly useful for Constructable Stylesheets, which can be shared across Shadow DOM boundaries.
- *
- * @example
- * ```ts
- * const sheet = await fetchStyle('./component.css')
- * shadowRoot.adoptedStyleSheets = [sheet]
- * ```
- *
- * @param url - The CSS file location.
- * @returns The CSSStyleSheet object constructed from the CSS contents.
- * @throws {Error} If the fetch fails.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/CSSStyleSheet | CSSStyleSheet}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/ShadowRoot/adoptedStyleSheets | adoptedStyleSheets}
- */
-export async function fetchStyle(url) {
-    return await cssToStyle(await fetchCss(url));
-}
-//# sourceMappingURL=helpers.js.map

package/lib/helpers.js.map

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

package/lib/index.d.ts

@@ -1,15 +0,0 @@
-export * from './types.js';
-export * from './util.js';
-export * from './case.js';
-export * from './JJN.js';
-export * from './JJT.js';
-export * from './JJE.js';
-export * from './JJHE.js';
-export * from './JJSE.js';
-export * from './JJD.js';
-export * from './JJDF.js';
-export * from './JJSR.js';
-import './mixins.js';
-export * from './helpers.js';
-export * from './mixins.js';
-export * from './components.js';

package/lib/index.js

@@ -1,16 +0,0 @@
-export * from './types.js';
-export * from './util.js';
-export * from './case.js';
-export * from './JJN.js';
-export * from './JJT.js';
-export * from './JJE.js';
-export * from './JJHE.js';
-export * from './JJSE.js';
-export * from './JJD.js';
-export * from './JJDF.js';
-export * from './JJSR.js';
-import './mixins.js';
-export * from './helpers.js';
-export * from './mixins.js';
-export * from './components.js';
-//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,OAAO,aAAa,CAAA;AACpB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA"}

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}
-     */
-    setChildren(...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,77 +0,0 @@
-import { JJN } from './JJN.js';
-import { Wrappable, Wrapped } from './types.js';
-export declare const wrapAll: typeof JJN.wrapAll, unwrap: typeof JJN.unwrap, unwrapAll: typeof JJN.unwrapAll, isWrapable: typeof JJN.isWrapable;
-/**
- * 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;
-/**
- * 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[];