@madojs/mado 0.5.0

package/dist/src/diagnostics.js

@@ -0,0 +1,28 @@
+/**
+ * Internal dev diagnostics.
+ *
+ * Warnings are intentionally best-effort: they never throw and they are printed
+ * once per code so noisy app renders do not flood the console.
+ */
+const seen = new Set();
+export function warnOnce(code, message) {
+    if (seen.has(code))
+        return;
+    seen.add(code);
+    try {
+        // eslint-disable-next-line no-console
+        console.warn(`[mado:${code}] ${message}`);
+    }
+    catch {
+        /* noop */
+    }
+}
+export const _testHooks = {
+    resetWarnings() {
+        seen.clear();
+    },
+    seenWarnings() {
+        return [...seen];
+    },
+};
+//# sourceMappingURL=diagnostics.js.map

package/dist/src/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/B,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe;IACpD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACf,IAAI,CAAC;QACH,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,UAAU;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,aAAa;QACX,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IACD,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACnB,CAAC;CACF,CAAC"}

package/dist/src/each.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Keyed list rendering.
+ *
+ * each() returns a special EachResult descriptor. The html binder recognizes
+ * it by the `_madoEach` flag and applies keyed reconciliation: on every
+ * update it reuses DOM nodes for the same keys and moves them with
+ * insertBefore instead of recreating everything.
+ *
+ * Key differences from a naive implementation:
+ *   - state lives in the parent's ChildState, not globally by renderFn, so two
+ *     each() calls with the same render function do not interfere;
+ *   - DOM nodes are actually reused, so input focus, animations,
+ *     IntersectionObserver state and .scrollTop survive reorder.
+ *
+ * API:
+ *   each(items, item => item.id, item => html`<li>${item.name}</li>`)
+ *
+ * Template usage:
+ *   html`<ul>${() => each(items(), t => t.id, t => html`<li>${t.text}</li>`)}</ul>`
+ */
+import { type TemplateResult } from "./html.js";
+export type EachKey = string | number;
+/**
+ * Marker recognised by the html binder.
+ * Do not set `_madoEach` yourself — use each().
+ */
+export interface EachResult<T = unknown> {
+    readonly _madoEach: true;
+    readonly items: readonly T[];
+    readonly keyOf: (item: T, index: number) => EachKey;
+    readonly render: (item: T, index: number) => TemplateResult;
+}
+export declare const isEachResult: (v: unknown) => v is EachResult;
+export declare function each<T>(items: readonly T[], keyOf: (item: T, index: number) => EachKey, render: (item: T, index: number) => TemplateResult): EachResult<T>;
+/**
+ * Sugar: returns a ready TemplateResult with the given list as children.
+ * Convenient when you need a list without a wrapping parent.
+ */
+export declare function list<T>(items: readonly T[], keyOf: (item: T, index: number) => EachKey, render: (item: T, index: number) => TemplateResult): TemplateResult;

package/dist/src/each.js

@@ -0,0 +1,35 @@
+/**
+ * Keyed list rendering.
+ *
+ * each() returns a special EachResult descriptor. The html binder recognizes
+ * it by the `_madoEach` flag and applies keyed reconciliation: on every
+ * update it reuses DOM nodes for the same keys and moves them with
+ * insertBefore instead of recreating everything.
+ *
+ * Key differences from a naive implementation:
+ *   - state lives in the parent's ChildState, not globally by renderFn, so two
+ *     each() calls with the same render function do not interfere;
+ *   - DOM nodes are actually reused, so input focus, animations,
+ *     IntersectionObserver state and .scrollTop survive reorder.
+ *
+ * API:
+ *   each(items, item => item.id, item => html`<li>${item.name}</li>`)
+ *
+ * Template usage:
+ *   html`<ul>${() => each(items(), t => t.id, t => html`<li>${t.text}</li>`)}</ul>`
+ */
+import { html } from "./html.js";
+export const isEachResult = (v) => typeof v === "object" &&
+    v !== null &&
+    v._madoEach === true;
+export function each(items, keyOf, render) {
+    return { _madoEach: true, items, keyOf, render };
+}
+/**
+ * Sugar: returns a ready TemplateResult with the given list as children.
+ * Convenient when you need a list without a wrapping parent.
+ */
+export function list(items, keyOf, render) {
+    return html `${each(items, keyOf, render)}`;
+}
+//# sourceMappingURL=each.js.map

package/dist/src/each.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"each.js","sourceRoot":"","sources":["../../src/each.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,IAAI,EAAuB,MAAM,WAAW,CAAC;AAetD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAU,EAAmB,EAAE,CAC1D,OAAO,CAAC,KAAK,QAAQ;IACrB,CAAC,KAAK,IAAI;IACT,CAAgB,CAAC,SAAS,KAAK,IAAI,CAAC;AAEvC,MAAM,UAAU,IAAI,CAClB,KAAmB,EACnB,KAA0C,EAC1C,MAAkD;IAElD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAClB,KAAmB,EACnB,KAA0C,EAC1C,MAAkD;IAElD,OAAO,IAAI,CAAA,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/src/forms.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Forms without pain. Built on top of native `<form>` + Constraint Validation API.
+ *
+ *   const f = useForm({
+ *     email: { required: true, type: 'email' },
+ *     age:   { min: 18 },
+ *   });
+ *
+ *   html`
+ *     <form @submit=${f.onSubmit(async values => { await save(values) })}>
+ *       <input name="email" .value=${() => f.values().email ?? ''}
+ *              @input=${f.onInput} />
+ *       ${() => f.errors().email ? html`<err>${f.errors().email}</err>` : null}
+ *
+ *       <input name="age" type="number" .value=${() => f.values().age ?? ''}
+ *              @input=${f.onInput} />
+ *
+ *       <button ?disabled=${() => !f.isValid() || f.submitting()}>Save</button>
+ *     </form>
+ *   `;
+ *
+ * What's inside:
+ *   - validation is performed via standard browser attributes
+ *     (required, min, max, pattern, type=email/url/number, etc.);
+ *   - custom rules via a validate(values) function returning
+ *     { field: 'msg' } or null;
+ *   - all fields are automatically "touched" on blur — errors
+ *     are shown only after user interaction;
+ *   - submit() is aborted if the form is invalid.
+ *
+ * No Yup/Zod/Formik dependencies. If you really want them —
+ * pass your own validate(values) and wire it to anything.
+ */
+import { type Signal } from "./signal.js";
+export type FormValues = Record<string, string | number | boolean | undefined>;
+export type FormErrors = Record<string, string | undefined>;
+/** Field declaration. Attributes match HTML5. */
+export interface FieldSchema {
+    required?: boolean;
+    type?: "text" | "email" | "url" | "number" | "tel" | "password";
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    /** Default value */
+    default?: string | number | boolean;
+}
+export type Schema = Record<string, FieldSchema>;
+export interface UseFormOptions<V extends FormValues> {
+    /** Custom validator: returns errors or null. */
+    validate?: (values: V) => FormErrors | null;
+}
+export interface FormApi<V extends FormValues> {
+    values: Signal<V>;
+    errors: () => FormErrors;
+    touched: Signal<Record<string, boolean>>;
+    submitting: Signal<boolean>;
+    isValid: () => boolean;
+    /** Binding for @input/@change: automatically picks up name+value+type. */
+    onInput: (e: Event) => void;
+    /** Binding for @blur: marks the field as touched. */
+    onBlur: (e: Event) => void;
+    /** Submit wrapper: calls handler only if the form is valid. */
+    onSubmit: (handler: (values: V) => void | Promise<void>) => (e: Event) => void;
+    /** Set a field value programmatically. */
+    setField<K extends keyof V>(name: K, value: V[K]): void;
+    /** Reset to defaults. */
+    reset(): void;
+}
+export declare function useForm<V extends FormValues>(schema: Schema, options?: UseFormOptions<V>): FormApi<V>;

package/dist/src/forms.js

@@ -0,0 +1,161 @@
+/**
+ * Forms without pain. Built on top of native `<form>` + Constraint Validation API.
+ *
+ *   const f = useForm({
+ *     email: { required: true, type: 'email' },
+ *     age:   { min: 18 },
+ *   });
+ *
+ *   html`
+ *     <form @submit=${f.onSubmit(async values => { await save(values) })}>
+ *       <input name="email" .value=${() => f.values().email ?? ''}
+ *              @input=${f.onInput} />
+ *       ${() => f.errors().email ? html`<err>${f.errors().email}</err>` : null}
+ *
+ *       <input name="age" type="number" .value=${() => f.values().age ?? ''}
+ *              @input=${f.onInput} />
+ *
+ *       <button ?disabled=${() => !f.isValid() || f.submitting()}>Save</button>
+ *     </form>
+ *   `;
+ *
+ * What's inside:
+ *   - validation is performed via standard browser attributes
+ *     (required, min, max, pattern, type=email/url/number, etc.);
+ *   - custom rules via a validate(values) function returning
+ *     { field: 'msg' } or null;
+ *   - all fields are automatically "touched" on blur — errors
+ *     are shown only after user interaction;
+ *   - submit() is aborted if the form is invalid.
+ *
+ * No Yup/Zod/Formik dependencies. If you really want them —
+ * pass your own validate(values) and wire it to anything.
+ */
+import { signal, computed } from "./signal.js";
+export function useForm(schema, options = {}) {
+    const defaults = () => {
+        const out = {};
+        for (const k in schema) {
+            const s = schema[k];
+            if (s.default !== undefined)
+                out[k] = s.default;
+        }
+        return out;
+    };
+    const values = signal(defaults());
+    const touched = signal({});
+    const submitting = signal(false);
+    const errors = computed(() => {
+        const v = values();
+        const out = {};
+        for (const name in schema) {
+            const s = schema[name];
+            const raw = v[name];
+            const isEmpty = raw === undefined || raw === "" || raw === null;
+            if (s.required && isEmpty) {
+                out[name] = "required field";
+                continue;
+            }
+            if (isEmpty)
+                continue;
+            if (s.type === "email" && typeof raw === "string") {
+                if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(raw))
+                    out[name] = "invalid email";
+            }
+            else if (s.type === "url" && typeof raw === "string") {
+                try {
+                    new URL(raw);
+                }
+                catch {
+                    out[name] = "invalid URL";
+                }
+            }
+            else if (s.type === "number") {
+                const n = Number(raw);
+                if (Number.isNaN(n))
+                    out[name] = "must be a number";
+                else {
+                    if (s.min !== undefined && n < s.min)
+                        out[name] = `minimum ${s.min}`;
+                    if (s.max !== undefined && n > s.max)
+                        out[name] = `maximum ${s.max}`;
+                }
+            }
+            if (typeof raw === "string") {
+                if (s.minLength !== undefined && raw.length < s.minLength) {
+                    out[name] = `minimum ${s.minLength} characters`;
+                }
+                if (s.maxLength !== undefined && raw.length > s.maxLength) {
+                    out[name] = `maximum ${s.maxLength} characters`;
+                }
+                if (s.pattern && !new RegExp(s.pattern).test(raw)) {
+                    out[name] = "invalid format";
+                }
+            }
+        }
+        if (options.validate) {
+            const custom = options.validate(v);
+            if (custom)
+                Object.assign(out, custom);
+        }
+        return out;
+    });
+    const isValid = computed(() => Object.keys(errors()).length === 0);
+    const readField = (el) => {
+        if (el instanceof HTMLInputElement) {
+            if (el.type === "checkbox")
+                return el.checked;
+            if (el.type === "number")
+                return el.value === "" ? "" : Number(el.value);
+        }
+        return el.value;
+    };
+    const api = {
+        values,
+        errors,
+        touched,
+        submitting,
+        isValid,
+        onInput(e) {
+            const t = e.target;
+            if (!t.name)
+                return;
+            values.update((v) => ({ ...v, [t.name]: readField(t) }));
+        },
+        onBlur(e) {
+            const t = e.target;
+            if (!t.name)
+                return;
+            touched.update((m) => ({ ...m, [t.name]: true }));
+        },
+        onSubmit(handler) {
+            return (e) => {
+                e.preventDefault();
+                // mark all fields as touched to show all errors
+                const all = {};
+                for (const k in schema)
+                    all[k] = true;
+                touched.set(all);
+                if (!isValid())
+                    return;
+                submitting.set(true);
+                Promise.resolve(handler(values.peek()))
+                    .catch((err) => {
+                    // eslint-disable-next-line no-console
+                    console.error("[mado] form submit threw:", err);
+                })
+                    .finally(() => submitting.set(false));
+            };
+        },
+        setField(name, value) {
+            values.update((v) => ({ ...v, [name]: value }));
+        },
+        reset() {
+            values.set(defaults());
+            touched.set({});
+            submitting.set(false);
+        },
+    };
+    return api;
+}
+//# sourceMappingURL=forms.js.map

package/dist/src/forms.js.map

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

package/dist/src/head.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Applying HeadMeta to document.<head> in SPA runtime.
+ *
+ * Approach: we mark all tags we create with the `data-mado-head` attribute.
+ * On the next `applyHead` we first remove all ours, then insert the new ones.
+ * Existing meta from baked HTML (without `data-mado-head`) — we don't touch,
+ * but they won't interfere: duplicates in <head> are valid.
+ *
+ * If HTML was pre-baked, meta+ld from bake.head() are already there.
+ * On first hydration we either skip applyHead, or mark baked tags as not ours—
+ * client-side apply will add its own data-mado-head copies, and the old baked
+ * ones remain for SEO caching without any negative effect
+ * (canonical, jsonLd — don't depend on count).
+ *
+ * For strict baked HTML + SPA navigation: also mark bake-tags
+ * `data-mado-head="baked"`, then the first applyHead will remove and replace them.
+ */
+import type { HeadMeta } from "./page.js";
+export declare function applyHead(meta: HeadMeta): void;

package/dist/src/head.js

@@ -0,0 +1,97 @@
+/**
+ * Applying HeadMeta to document.<head> in SPA runtime.
+ *
+ * Approach: we mark all tags we create with the `data-mado-head` attribute.
+ * On the next `applyHead` we first remove all ours, then insert the new ones.
+ * Existing meta from baked HTML (without `data-mado-head`) — we don't touch,
+ * but they won't interfere: duplicates in <head> are valid.
+ *
+ * If HTML was pre-baked, meta+ld from bake.head() are already there.
+ * On first hydration we either skip applyHead, or mark baked tags as not ours—
+ * client-side apply will add its own data-mado-head copies, and the old baked
+ * ones remain for SEO caching without any negative effect
+ * (canonical, jsonLd — don't depend on count).
+ *
+ * For strict baked HTML + SPA navigation: also mark bake-tags
+ * `data-mado-head="baked"`, then the first applyHead will remove and replace them.
+ */
+const MARK = "data-mado-head";
+export function applyHead(meta) {
+    // 1) remove our previous tags
+    for (const el of document.head.querySelectorAll(`[${MARK}]`)) {
+        el.remove();
+    }
+    // 2) title — separately
+    if (meta.title)
+        document.title = meta.title;
+    // 3) description / canonical
+    if (meta.description) {
+        upsertMeta({ name: "description", content: meta.description });
+    }
+    if (meta.canonical) {
+        upsertLink({ rel: "canonical", href: meta.canonical });
+    }
+    // 4) OG
+    if (meta.og) {
+        const og = meta.og;
+        if (og.title)
+            upsertMeta({ property: "og:title", content: og.title });
+        if (og.description)
+            upsertMeta({ property: "og:description", content: og.description });
+        if (og.image)
+            upsertMeta({ property: "og:image", content: og.image });
+        if (og.type)
+            upsertMeta({ property: "og:type", content: og.type });
+        if (og.url)
+            upsertMeta({ property: "og:url", content: og.url });
+    }
+    // 5) Twitter (inherits og.* if not set)
+    if (meta.twitter || meta.og) {
+        const tw = meta.twitter ?? {};
+        const og = meta.og ?? {};
+        upsertMeta({ name: "twitter:card", content: tw.card ?? "summary" });
+        if (tw.title ?? og.title)
+            upsertMeta({ name: "twitter:title", content: tw.title ?? og.title });
+        if (tw.description ?? og.description)
+            upsertMeta({
+                name: "twitter:description",
+                content: tw.description ?? og.description,
+            });
+        if (tw.image ?? og.image)
+            upsertMeta({ name: "twitter:image", content: tw.image ?? og.image });
+    }
+    // 6) Arbitrary meta
+    for (const m of meta.meta ?? [])
+        upsertMeta(m);
+    // 7) Arbitrary link
+    for (const l of meta.link ?? [])
+        upsertLink(l);
+    // 8) JSON-LD (Schema.org)
+    if (meta.jsonLd != null) {
+        const script = document.createElement("script");
+        script.type = "application/ld+json";
+        script.setAttribute(MARK, "");
+        script.textContent = JSON.stringify(meta.jsonLd);
+        document.head.appendChild(script);
+    }
+}
+function upsertMeta(attrs) {
+    const tag = document.createElement("meta");
+    if (attrs.name)
+        tag.setAttribute("name", attrs.name);
+    if (attrs.property)
+        tag.setAttribute("property", attrs.property);
+    tag.setAttribute("content", attrs.content);
+    tag.setAttribute(MARK, "");
+    document.head.appendChild(tag);
+}
+function upsertLink(attrs) {
+    const tag = document.createElement("link");
+    tag.rel = attrs.rel;
+    tag.href = attrs.href;
+    if (attrs.hreflang)
+        tag.hreflang = attrs.hreflang;
+    tag.setAttribute(MARK, "");
+    document.head.appendChild(tag);
+}
+//# sourceMappingURL=head.js.map

package/dist/src/head.js.map

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

package/dist/src/html/bindings.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Bindings: how values end up in DOM nodes after template cloning.
+ * All binding types are described in one place so that adding
+ * a new one (e.g. `??=` or `style.<prop>`) is intentional and visible.
+ *
+ * Split into two groups:
+ *   - bindChild  — child binding (text / node / array / TemplateResult / each)
+ *   - bindAttr   — attribute / event / DOM property / boolean
+ *
+ * Reactivity: if a value is a function (signal/computed), we wrap it
+ * in effect(); the returned Disposer goes into the instance's disposers list
+ * so that on update()/dispose() everything is properly cleaned up.
+ */
+import { type Disposer } from "../signal.js";
+import { type EachKey } from "../each.js";
+import type { AttrBindingSpec } from "./parser.js";
+import { type TemplateResult, type InstantiatedTemplate } from "./template-types.js";
+/**
+ * Entry for a node in keyed-each: reference to the template instance
+ * and its top-level DOM nodes. Stored in ChildState.eachEntries
+ * between updates so reconciliation can reuse DOM.
+ */
+interface EachEntry {
+    inst: InstantiatedTemplate;
+    /** Top-level nodes that must move during reorder. */
+    nodes: Node[];
+}
+export interface ChildState {
+    anchor: Comment;
+    /**
+     * Current content. Used only by the normal branch (non-each).
+     * each uses eachEntries instead.
+     */
+    current: Node[];
+    /**
+     * Nested TemplateResult instances created by the normal branch.
+     * They must be disposed before replacement/removal because they can own
+     * deeper child bindings that insert additional DOM nodes.
+     */
+    currentInsts: InstantiatedTemplate[];
+    /**
+     * Whether each mode is currently active. Switching between each and normal
+     * mode first clears the previous content.
+     */
+    isEach: boolean;
+    /** Current entries by key. */
+    eachEntries: Map<EachKey, EachEntry>;
+    /** Current key order in the DOM before the anchor. */
+    eachOrder: EachKey[];
+}
+/**
+ * Ownership invariant:
+ * - ChildState owns everything inserted before its anchor for that binding.
+ * - Plain nodes are tracked in current.
+ * - Nested TemplateResult instances are tracked in currentInsts and must be
+ *   dispose()'d before removing current nodes, because they can own deeper
+ *   anchors/effects/nodes not visible to the parent instance.
+ * - each() owns its own InstantiatedTemplate entries through eachEntries.
+ */
+export declare function createChildState(anchor: Comment): ChildState;
+export declare function disposeChildState(st: ChildState): void;
+/**
+ * Bind a value to a child binding. If value is a function (signal),
+ * subscribe via effect(); otherwise render once.
+ *
+ * instantiateFn is passed as a parameter to avoid circular
+ * dependency bindings ↔ template.
+ */
+export declare function bindChild(st: ChildState, value: unknown, disposers: Disposer[], instantiateFn: (r: TemplateResult) => InstantiatedTemplate): void;
+/**
+ * Apply a value to an attr binding. Route by prefix:
+ *   @event     → addEventListener
+ *   .prop      → el[prop] = value
+ *   ?attr      → toggleAttribute by truthy/falsy
+ *   otherwise  → setAttribute / removeAttribute (with multi-part support)
+ */
+export declare function bindAttr(el: Element, spec: AttrBindingSpec, values: readonly unknown[], disposers: Disposer[]): void;
+export {};