npm - @madojs/mado - Versions diffs - 0.11.1 → 0.12.0 - Mend

@madojs/mado 0.11.1 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (219) hide show

package/AGENTS.md +102 -25
package/CHANGELOG.md +158 -1
package/README.md +135 -172
package/dist/src/component.d.ts +3 -2
package/dist/src/component.js +98 -6
package/dist/src/component.js.map +1 -1
package/dist/src/css.js +34 -5
package/dist/src/css.js.map +1 -1
package/dist/src/head.d.ts +6 -6
package/dist/src/head.js +6 -6
package/dist/src/html/parser.d.ts +1 -1
package/dist/src/html/parser.js +1 -1
package/dist/src/html/template.js +24 -10
package/dist/src/html/template.js.map +1 -1
package/dist/src/index.d.ts +8 -4
package/dist/src/index.js +13 -3
package/dist/src/index.js.map +1 -1
package/dist/src/page.d.ts +62 -28
package/dist/src/page.js +5 -0
package/dist/src/page.js.map +1 -1
package/dist/src/resource.js +2 -1
package/dist/src/resource.js.map +1 -1
package/dist/src/router/base.d.ts +65 -0
package/dist/src/router/base.js +168 -0
package/dist/src/router/base.js.map +1 -0
package/dist/src/router/manifest.js +75 -31
package/dist/src/router/manifest.js.map +1 -1
package/dist/src/router/match.d.ts +16 -2
package/dist/src/router/match.js +41 -1
package/dist/src/router/match.js.map +1 -1
package/dist/src/router/navigation.js +58 -9
package/dist/src/router/navigation.js.map +1 -1
package/dist/src/static-runtime.d.ts +81 -0
package/dist/src/static-runtime.js +209 -0
package/dist/src/static-runtime.js.map +1 -0
package/dist/src/vite/index.d.ts +31 -3
package/dist/src/vite/index.js +49 -18
package/dist/src/vite/index.js.map +1 -1
package/docs/README.md +5 -8
package/docs/architecture/adr/0001-browser-static-snapshots.md +132 -0
package/docs/en/00-the-mado-way.md +1 -1
package/docs/en/01-quickstart.md +183 -0
package/docs/en/10-pages-and-components.md +271 -0
package/docs/en/11-templates-and-signals.md +211 -0
package/docs/en/12-routing.md +229 -0
package/docs/en/13-data.md +225 -0
package/docs/en/14-forms.md +244 -0
package/docs/en/15-static-snapshots.md +181 -0
package/docs/en/{10-app-architecture.md → 16-app-architecture.md} +53 -2
package/docs/en/{13-deployment.md → 20-deployment.md} +59 -10
package/docs/en/{14-testing.md → 22-testing.md} +6 -5
package/docs/en/23-cookbook.md +292 -0
package/docs/en/{18-api-freeze-map.md → 30-api-freeze-map.md} +12 -3
package/docs/en/{20-v1-stability.md → 32-v1-stability.md} +3 -3
package/docs/en/40-llm-guide.md +776 -0
package/docs/en/{06-for-backenders.md → 41-for-backenders.md} +15 -16
package/docs/en/{05-why-mado.md → 42-why-mado.md} +1 -1
package/docs/en/README.md +97 -27
package/docs/recipes/nginx/Containerfile +26 -0
package/docs/recipes/nginx/nginx.conf +42 -0
package/llms.txt +246 -211
package/package.json +17 -10
package/scripts/bake.mjs +4 -569
package/scripts/cli/generate.mjs +55 -5
package/scripts/cli/help.mjs +11 -5
package/scripts/cli/index.mjs +20 -4
package/scripts/cli/init.mjs +7 -2
package/scripts/cli/release.mjs +20 -68
package/scripts/docs-lint.mjs +170 -0
package/scripts/package-smoke.mjs +67 -9
package/scripts/preview.mjs +95 -6
package/scripts/size-budget.mjs +5 -1
package/scripts/static/browser.mjs +654 -0
package/scripts/static/discover.mjs +281 -0
package/scripts/static/output.mjs +141 -0
package/scripts/static/serialize.mjs +212 -0
package/scripts/static/server.mjs +167 -0
package/scripts/static.mjs +191 -0
package/starters/default/README.md +57 -55
package/starters/default/package.json +3 -9
package/starters/default/src/app.routes.ts +20 -33
package/starters/default/src/components/feature-card.component.ts +40 -0
package/starters/default/src/components/live-counter.component.ts +57 -0
package/starters/default/src/content/guides.ts +55 -0
package/starters/default/src/main.ts +9 -13
package/starters/default/src/pages/app.page.ts +41 -0
package/starters/default/src/pages/guide.page.ts +40 -0
package/starters/default/src/pages/home.page.ts +49 -0
package/starters/default/src/pages/not-found.page.ts +18 -0
package/starters/default/src/styles/document.css +39 -0
package/starters/default/src/styles/reset.css +37 -0
package/starters/default/src/styles/tokens.css +30 -0
package/starters/default/src/styles.d.ts +3 -1
package/starters/default/src/vite-env.d.ts +1 -1
package/starters/default/vite.config.ts +14 -1
package/starters/modular/README.md +142 -0
package/starters/modular/index.html +13 -0
package/starters/modular/package.json +30 -0
package/starters/modular/src/app.routes.ts +39 -0
package/starters/{default → modular}/src/layouts/app-shell.layout.ts +8 -5
package/starters/{default → modular}/src/layouts/auth-shell.layout.ts +3 -3
package/starters/modular/src/main.ts +16 -0
package/starters/{default → modular}/src/modules/billing/pages/invoices-list.page.ts +3 -3
package/starters/{default → modular}/src/modules/home/home.page.ts +5 -7
package/starters/modular/src/modules/home/not-found.page.ts +14 -0
package/starters/modular/src/styles.d.ts +1 -0
package/starters/modular/src/vite-env.d.ts +1 -0
package/starters/modular/tsconfig.json +24 -0
package/starters/modular/vite.config.ts +131 -0
package/TODO.md +0 -79
package/docs/en/01-routing.md +0 -152
package/docs/en/02-project-layout.md +0 -124
package/docs/en/03-static-bake.md +0 -249
package/docs/en/04-ide-setup.md +0 -162
package/docs/en/07-llm-pitfalls.md +0 -724
package/docs/en/08-llm-zero-history-test.md +0 -56
package/docs/en/09-shadow-vs-light-dom.md +0 -174
package/docs/en/11-layouts.md +0 -113
package/docs/en/12-auth-and-api.md +0 -124
package/docs/en/16-bake-cookbook.md +0 -100
package/docs/en/17-shadow-dom-forms.md +0 -192
package/docs/fr/00-the-mado-way.md +0 -85
package/docs/fr/01-routing.md +0 -120
package/docs/fr/02-project-layout.md +0 -84
package/docs/fr/03-static-bake.md +0 -289
package/docs/fr/04-ide-setup.md +0 -162
package/docs/fr/05-why-mado.md +0 -193
package/docs/fr/06-for-backenders.md +0 -438
package/docs/fr/07-llm-pitfalls.md +0 -625
package/docs/fr/08-llm-zero-history-test.md +0 -38
package/docs/fr/09-shadow-vs-light-dom.md +0 -65
package/docs/fr/10-app-architecture.md +0 -138
package/docs/fr/11-layouts.md +0 -47
package/docs/fr/12-auth-and-api.md +0 -76
package/docs/fr/13-deployment.md +0 -57
package/docs/fr/14-testing.md +0 -41
package/docs/fr/15-error-handling.md +0 -50
package/docs/fr/16-bake-cookbook.md +0 -88
package/docs/fr/17-shadow-dom-forms.md +0 -196
package/docs/fr/18-api-freeze-map.md +0 -63
package/docs/fr/19-reactivity-ordering.md +0 -97
package/docs/fr/20-v1-stability.md +0 -88
package/docs/fr/README.md +0 -27
package/docs/ru/00-the-mado-way.md +0 -84
package/docs/ru/01-routing.md +0 -119
package/docs/ru/02-project-layout.md +0 -84
package/docs/ru/03-static-bake.md +0 -250
package/docs/ru/04-ide-setup.md +0 -144
package/docs/ru/05-why-mado.md +0 -193
package/docs/ru/06-for-backenders.md +0 -428
package/docs/ru/07-llm-pitfalls.md +0 -624
package/docs/ru/08-llm-zero-history-test.md +0 -57
package/docs/ru/09-shadow-vs-light-dom.md +0 -63
package/docs/ru/10-app-architecture.md +0 -152
package/docs/ru/11-layouts.md +0 -47
package/docs/ru/12-auth-and-api.md +0 -75
package/docs/ru/13-deployment.md +0 -66
package/docs/ru/14-testing.md +0 -50
package/docs/ru/15-error-handling.md +0 -56
package/docs/ru/16-bake-cookbook.md +0 -95
package/docs/ru/17-shadow-dom-forms.md +0 -193
package/docs/ru/18-api-freeze-map.md +0 -64
package/docs/ru/19-reactivity-ordering.md +0 -95
package/docs/ru/20-v1-stability.md +0 -82
package/docs/ru/README.md +0 -25
package/docs/uk/00-the-mado-way.md +0 -82
package/docs/uk/01-routing.md +0 -76
package/docs/uk/02-project-layout.md +0 -73
package/docs/uk/03-static-bake.md +0 -48
package/docs/uk/04-ide-setup.md +0 -26
package/docs/uk/05-why-mado.md +0 -34
package/docs/uk/06-for-backenders.md +0 -55
package/docs/uk/07-llm-pitfalls.md +0 -145
package/docs/uk/08-llm-zero-history-test.md +0 -34
package/docs/uk/09-shadow-vs-light-dom.md +0 -58
package/docs/uk/10-app-architecture.md +0 -97
package/docs/uk/11-layouts.md +0 -47
package/docs/uk/12-auth-and-api.md +0 -70
package/docs/uk/13-deployment.md +0 -40
package/docs/uk/14-testing.md +0 -34
package/docs/uk/15-error-handling.md +0 -32
package/docs/uk/16-bake-cookbook.md +0 -36
package/docs/uk/17-shadow-dom-forms.md +0 -193
package/docs/uk/18-api-freeze-map.md +0 -61
package/docs/uk/19-reactivity-ordering.md +0 -95
package/docs/uk/20-v1-stability.md +0 -83
package/docs/uk/README.md +0 -27
package/starters/default/src/modules/home/not-found.page.ts +0 -11
/package/docs/en/{15-error-handling.md → 21-error-handling.md} +0 -0
/package/docs/en/{19-reactivity-ordering.md → 31-reactivity-ordering.md} +0 -0
/package/starters/{default → modular}/.editorconfig +0 -0
/package/starters/{default → modular}/eslint.config.mjs +0 -0
/package/starters/{default → modular}/public/favicon.svg +0 -0
/package/starters/{default → modular}/src/modules/auth/_contracts/auth-api.types.ts +0 -0
/package/starters/{default → modular}/src/modules/auth/auth.connector.ts +0 -0
/package/starters/{default → modular}/src/modules/auth/auth.guard.ts +0 -0
/package/starters/{default → modular}/src/modules/auth/auth.public.ts +0 -0
/package/starters/{default → modular}/src/modules/auth/auth.routes.ts +0 -0
/package/starters/{default → modular}/src/modules/auth/auth.service.ts +0 -0
/package/starters/{default → modular}/src/modules/auth/auth.types.ts +0 -0
/package/starters/{default → modular}/src/modules/auth/login.page.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/_contracts/stripe.types.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/api/stripe.connector.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/billing.public.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/billing.routes.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/billing.types.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/components/invoice-status-badge.component.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/data/invoices.resource.ts +0 -0
/package/starters/{default → modular}/src/modules/billing/pages/invoice-detail.page.ts +0 -0
/package/starters/{default → modular}/src/shared/http/http-client.ts +0 -0
/package/starters/{default → modular}/src/shared/http/http-error.ts +0 -0
/package/starters/{default → modular}/src/shared/http/interceptors.ts +0 -0
/package/starters/{default → modular}/src/shared/lib/format-date.ts +0 -0
/package/starters/{default → modular}/src/shared/styles/content.css +0 -0
/package/starters/{default → modular}/src/shared/styles/reset.css +0 -0
/package/starters/{default → modular}/src/shared/styles/shell.css +0 -0
/package/starters/{default → modular}/src/shared/styles/tokens.css +0 -0
/package/starters/{default → modular}/src/shared/ui/x-button.component.ts +0 -0
/package/starters/{default → modular}/src/shared/ui/x-spinner.component.ts +0 -0

package/docs/uk/13-deployment.md DELETED Viewed

@@ -1,40 +0,0 @@
-# Deployment
-Одна команда, один artifact:
-```bash
-mado release
-```
-Результат:
-```txt
-out/
-├── index.html
-├── assets/
-├── <route>/index.html
-├── sitemap.xml
-├── _redirects
-└── _headers
-```
-`out/` можна деплоїти на nginx, Cloudflare Pages, Netlify, S3/CloudFront або
-GitHub Pages.
-```bash
-mado release
-mado preview
-```
-`mado preview` показує `out/` як статичний хост: baked HTML має пріоритет,
-потім SPA fallback.
-Для VPS + nginx:
-```bash
-mado release
-rsync -avz --delete out/ user@server:/var/www/myapp/
-```
-Опційний nginx recipe живе в `docs/recipes/nginx/`: immutable cache для
-`/assets/*`, no-cache для HTML та fallback для deep links.

package/docs/uk/14-testing.md DELETED Viewed

@@ -1,34 +0,0 @@
-# Тестування
-Mado — це TypeScript і browser APIs. У репозиторії фреймворка тести йдуть через
-Node test runner та `linkedom`.
-```bash
-npm run typecheck
-npm run build
-npm test
-```
-DOM-тест:
-```js
-import test from "node:test";
-import assert from "node:assert/strict";
-const { parseHTML } = await import("linkedom");
-const { window } = parseHTML("<!doctype html><html><body></body></html>");
-globalThis.window = window;
-globalThis.document = window.document;
-const { html, render } = await import("../dist/src/html/template.js");
-test("renders", () => {
-  const root = document.createElement("div");
-  render(html`<p>${"hello"}</p>`, root);
-  assert.equal(root.querySelector("p").textContent, "hello");
-});
-```
-Покривай signals/computed/effect, HTML bindings, guards/redirects, scroll/focus,
-error boundaries, forms, resources/mutations і CLI-команди `mado release`,
-`mado bake`, `mado preview`.

package/docs/uk/15-error-handling.md DELETED Viewed

@@ -1,32 +0,0 @@
-# Обробка помилок
-Обробляй помилки там, де користувач може відновитися: маршрути, дані, дії
-користувача.
-```ts
-export default routes(manifest, {
-  errorPage: (err) => html`
-    <main>
-      <h1>Щось пішло не так</h1>
-      <pre>${err.message}</pre>
-      <a data-link href="/">На головну</a>
-    </main>
-  `,
-});
-```
-`page({ errorView })` має пріоритет над глобальною boundary.
-```ts
-const users = resource(() => "/api/users", jsonFetcher<User[]>());
-html`
-  ${() => users.error()
-    ? html`<p role="alert">${users.error()!.message}</p>
-         <button @click=${users.refresh}>Повторити</button>`
-    : null}
-`;
-```
-Валідація належить `useForm()`, помилки запису — поруч із submit-кнопкою.
-Зовнішні browser subscriptions очищай через `ctx.onDispose()`.

package/docs/uk/16-bake-cookbook.md DELETED Viewed

@@ -1,36 +0,0 @@
-# Bake cookbook
-`mado bake` рендерить вибрані маршрути у статичний HTML. Це для SEO та швидкого
-першого рендеру, не SSR з hydration.
-```ts
-export default page({
-  head: () => ({ title: "Products", description: "Catalog" }),
-  view: ({ data }) => html`
-    <main>
-      <h1>Products</h1>
-      ${data.products.map((p) => html`<article><h2>${p.name}</h2></article>`)}
-    </main>
-  `,
-  bake: {
-    paths: () => [{}],
-    data: async () => ({ products: await api.products() }),
-    revalidate: 3600,
-  },
-});
-```
-У baked views краще використовувати звичайні масиви (`items.map(...)`).
-Runtime-директиви на кшталт `each()` потрібні браузеру.
-```ts
-export const manifest = {
-  "/": () => import("./pages/home.js"),
-  "/blog/:slug": () => import("./pages/blog-post.js"),
-};
-export default routes(manifest);
-```
-`mado release` створює deploy artifact у `out/`. Якщо bake повідомляє про
-unsupported value, винеси runtime-only частину в клієнт або заміни її на
-серіалізований HTML.

package/docs/uk/17-shadow-dom-forms.md DELETED Viewed

@@ -1,193 +0,0 @@
-# Shadow DOM + форми
-Використання `useForm()` з кастомними input-компонентами у Shadow DOM потребує
-знання двох поведінок на рівні браузера:
-1. **Ретаргетинг подій** — події, що спливають із Shadow DOM, мають
-   `e.target`, перенаправлений на host-елемент. `useForm().onInput` читає
-   `e.target.name` та `e.target.value`, але host-елемент `<x-input>`
-   не має цих властивостей нативно.
-2. **Асоціація з формою** — `<button type="submit">` всередині Shadow Root
-   НЕ бере участі в алгоритмі form-owner для `<form>` у Light DOM. Клік по ній
-   не тригерить submit форми.
-Обидва обмеження — на рівні специфікації, не баги Mado. Але фреймворк надає
-патерни, що роблять їх безболісними.
-## Патерн: Proxy-властивості на input-компонентах
-Обгортаючи `<input>` у Shadow DOM компонент, експонуйте `name` та `value`
-як DOM-властивості на host, щоб `useForm().onInput` працював після ретаргетингу:
-```ts
-import { component, css, html } from "@madojs/mado";
-component("x-input", ({ host, attr }) => {
-  const name = attr("name", "");
-  const type = attr("type", "text");
-  const value = attr("value", "");
-  // Proxy-властивості для сумісності з useForm().
-  // Після ретаргетингу Shadow DOM e.target з <input> → <x-input>,
-  // useForm читає e.target.name / e.target.value — ці геттери будують міст.
-  Object.defineProperty(host, "name", {
-    get: () => host.getAttribute("name") ?? "",
-    configurable: true,
-  });
-  Object.defineProperty(host, "value", {
-    get: () => host.shadowRoot?.querySelector("input")?.value ?? "",
-    set: (v: string) => {
-      const input = host.shadowRoot?.querySelector("input");
-      if (input) input.value = v;
-    },
-    configurable: true,
-  });
-  return () => html`<input name=${name} type=${type} .value=${value} />`;
-});
-```
-Подія `input` від внутрішнього `<input>` має `composed: true` за замовчуванням,
-тому вона спливає через межу shadow. Після ретаргетингу `e.target` —
-це `<x-input>`, але тепер у нього є геттери `.name` та `.value` → `useForm`
-працює.
-## Патерн: Submit форми з Shadow DOM кнопок
-`<button type="submit">` всередині Shadow DOM не може тригерити submit `<form>`
-у Light DOM. Міст через `requestSubmit()`:
-```ts
-import { component, css, html } from "@madojs/mado";
-component("x-button", ({ host, attr }) => {
-  const disabled = attr("disabled");
-  const handleClick = () => {
-    const typeAttr = host.getAttribute("type");
-    if (typeAttr === "button" || typeAttr === "reset") return;
-    const form = host.closest("form");
-    if (form && !host.hasAttribute("disabled")) form.requestSubmit();
-  };
-  return () => html`
-    <button ?disabled=${() => disabled() !== ""} @click=${handleClick}>
-      <slot></slot>
-    </button>
-  `;
-});
-```
-`host.closest("form")` працює, бо сам host-елемент живе в Light DOM
-(тільки його внутрішні елементи у тіні). `requestSubmit()` тригерить валідацію
-та подію `submit` точно так, ніби користувач клікнув нативну submit-кнопку
-всередині форми.
-## Патерн: Реактивні атрибути через ctx.attr()
-З версії 0.7 `ctx.attr(name, defaultValue?)` повертає `Signal<string>`,
-який автоматично оновлюється при зміні атрибута на host. Ніякого
-`MutationObserver` бойлерплейту:
-```ts
-component("x-badge", ({ attr }) => {
-  const variant = attr("variant", "default"); // Signal<string>
-  return () =>
-    html`<span class=${() => `badge badge-${variant()}`}>
-      <slot></slot>
-    </span>`;
-});
-```
-Батько може використовувати `?disabled=${() => !form.isValid()}` (boolean атрибут)
-або `.variant=${"danger"}` — компонент перерендерюється реактивно в обох випадках.
-## Повний приклад форми
-```ts
-import { page, html, useForm, navigate } from "@madojs/mado";
-import "../components/x-input.js";
-import "../components/x-button.js";
-export default page({
-  title: "Вхід",
-  view: () => {
-    const form = useForm({
-      email: { required: true, type: "email" },
-      password: { required: true, minLength: 6 },
-    });
-    const handleLogin = async (values) => {
-      await api("/auth/login", { method: "POST", json: values });
-      navigate("/admin");
-    };
-    return html`
-      <form @submit=${form.onSubmit(handleLogin)}>
-        <x-input
-          name="email"
-          type="email"
-          label="Email"
-          required
-          @input=${form.onInput}
-          @blur=${form.onBlur}
-        ></x-input>
-        ${() =>
-          form.errors().email
-            ? html`<small class="err">${form.errors().email}</small>`
-            : null}
-        <x-input
-          name="password"
-          type="password"
-          label="Пароль"
-          required
-          @input=${form.onInput}
-          @blur=${form.onBlur}
-        ></x-input>
-        <x-button type="submit" ?disabled=${() => !form.isValid()}>
-          Увійти
-        </x-button>
-      </form>
-    `;
-  },
-});
-```
-## Коли використовувати Light DOM
-Якщо ваш input-компонент — це просто стилізована обгортка без потреби в
-інкапсуляції, `shadow: false` уникає обох проблем (ретаргетинг та
-form-association):
-```ts
-component(
-  "x-field",
-  ({ attr }) => {
-    const label = attr("label", "");
-    return () => html`
-      <label>
-        <span>${label}</span>
-        <slot></slot>
-      </label>
-    `;
-  },
-  { shadow: false },
-);
-```
-З Light DOM нативний `<input>` — частина дерева документа, події не
-ретаргетуються, і submit форми працює нативно. Компроміс: стилі не
-інкапсульовані (треба скоупити самостійно).
-## Підсумок
-| Задача                      | Рішення Shadow DOM                     | Альтернатива Light DOM     |
-| --------------------------- | -------------------------------------- | -------------------------- |
-| `useForm` + кастомний input | Proxy `name`/`value` на host           | Нативний `<input>` у slot  |
-| Submit форми                | `form.requestSubmit()` у click handler | Нативна кнопка працює      |
-| Реактивні атрибути          | `ctx.attr()` → авто-сигнал             | `ctx.attr()` працює скрізь |
-| Інкапсуляція стилів         | Так (автоматично)                      | Ручний `@scope` або BEM    |

package/docs/uk/18-api-freeze-map.md DELETED Viewed

@@ -1,61 +0,0 @@
-# Карта замороження API
-> Що є публічним, що внутрішнім, і що SemVer захищатиме у v1.
-Контракт Mado v1 навмисно невеликий. Код застосунку імпортує API з кореня
-пакета:
-```ts
-import { component, html, resource, routes, signal } from "@madojs/mado";
-```
-Єдиний публічний subpath — side-effect модуль devtools:
-```ts
-import "@madojs/mado/devtools.js";
-```
-Усе інше під `dist/src/` — деталь реалізації, навіть якщо файл видно в
-репозиторії.
-## Стабільний публічний API
-Ці імена публічні й захищаються SemVer після v1:
-- Reactivity: `signal`, `computed`, `effect`, `untracked`, `batch`,
-  `flushSync`.
-- Templates і directives: `html`, `render`, `each`, `list`, `unsafeHTML`,
-  `ref`, `classMap`, `styleMap`.
-- Components і CSS: `component`, `css`, `cssVars`.
-- Routing і pages: `routes`, `router`, `page`, `layout`,
-  `navigate`, `queryParam`, `prefetchPath`.
-- Data: `resource`, `mutation`, `invalidate`, `jsonFetcher`, `HttpError`.
-- Forms: `useForm`.
-- Head і persistence: `applyHead`, `persisted`.
-- Context: `createContext`, `provide`, `inject`.
-- Advanced lifecycle helpers: `createLifecycle`, `runInLifecycle`,
-  `getCurrentLifecycle`.
-- Публічні TypeScript-типи, експортовані з `@madojs/mado`.
-## Внутрішнє або нестабільне
-Це не публічний API:
-- Package subpaths крім `@madojs/mado` і `@madojs/mado/devtools.js`.
-- Internals parser/binding: `html/parser.js`, `html/bindings.js`,
-  `ChildState`, `EachEntry`.
-- Internals router: `router/match.js`, `router/navigation.js`,
-  `router/manifest.js`.
-- Diagnostics internals і всі `_testHooks`.
-- Точний текст bundle, назви chunks і внутрішня структура файлів.
-Тести репозиторію можуть імпортувати internal files через відносні шляхи
-`dist/`. Код застосунків не повинен цього робити.
-## Що може змінюватися
-Patch і minor releases можуть додавати root exports, options, diagnostics, docs
-або starter files. Вони також можуть змінювати internals, форму bundle і деталі
-реалізації, якщо stable API та задокументована поведінка лишаються сумісними.
-Breaking changes стабільного API потребують major version.

package/docs/uk/19-reactivity-ordering.md DELETED Viewed

@@ -1,95 +0,0 @@
-# Порядок reactivity
-> Малий набір ordering-гарантій, які Mado вважає публічною поведінкою.
-Reactivity у Mado синхронна для читання і планована для side effects. Мета —
-передбачувані UI updates без великої scheduling-моделі.
-## Signals
-`signal(value)` повертає getter-функцію. `set(next)` змінює значення одразу,
-якщо `Object.is(previous, next)` не дорівнює `true`.
-```ts
-const count = signal(0);
-count.set(1);
-count(); // 1, одразу
-```
-Computed values позначаються до запуску effects, тому effect, який читає
-computed, бачить актуальні dependencies, а не застарілий cache.
-## Effects
-`effect(fn)` запускається один раз одразу. Подальші зміни dependencies планують
-один запуск effect у microtask. Тести можуть викликати `flushSync()`, щоб
-синхронно очистити чергу.
-Якщо effect повертає cleanup-функцію, Mado запускає її перед наступним запуском
-effect і ще раз при виклику disposer.
-```ts
-const stop = effect(() => {
-  const id = setInterval(tick, 1000);
-  return () => clearInterval(id);
-});
-stop();
-```
-У компонентах і pages для unmount cleanup надавайте перевагу
-`ctx.onDispose()` / page `onDispose()`. Cleanup effect — це cleanup між runs.
-## Batch
-`batch(fn)` групує записи signals в один subscriber pass. Effects не
-запускаються до виходу з найзовнішнього batch, включно з вкладеними batches.
-```ts
-batch(() => {
-  first.set("Ada");
-  batch(() => last.set("Lovelace"));
-});
-// effects бачать тільки фінальну пару
-```
-Спостережувані `computed({ equals })` також зберігають batch atomicity: вони
-перераховуються один раз після зовнішнього batch на повністю застосованому
-state. Вони не повинні бачити напівзастосований batch на кшталт
-`(new x, old y)`.
-## DOM updates
-`render(result, container)` перевикористовує наявний template instance, коли
-наступний render має ті самі template strings. Для child bindings, що
-повертають вкладений `html```, діє те саме правило: ті самі strings оновлюються
-на місці, інші strings перебудовують гілку.
-Це означає, що непов'язані зміни signals не пересоздають `<input>` у
-стабільному вкладеному template, тому focus, DOM state і listeners
-зберігаються.
-Списки повинні використовувати `each(items, key, renderItem)`. Keys задають DOM
-identity. Duplicate keys попереджають у development і отримують positional
-suffix, щоб кожен item все одно рендерився, але duplicate keys — це data bug.
-## Teardown компонентів
-Custom elements можуть отримати `disconnectedCallback()`, а потім
-`connectedCallback()` під час same-tick move. Mado відкладає teardown компонента
-до microtask і скасовує його при reconnect, тому keyed reorders зберігають
-state компонента. Справжнє видалення все одно запускає lifecycle cleanup на
-наступній microtask.
-## Не гарантується
-Mado не гарантує точну кількість internal scheduler microtasks, порядок
-незалежних effects без спільних dependencies, форму generated bundle або
-внутрішній module layout. Це implementation details.
-Invariant tests для цього контракту:
-- `test/reactivity-ordering.test.mjs`
-- `test/signal-batch-equals.test.mjs`
-- `test/update-nested-reuse.test.mjs`
-- `test/each-component-state.test.mjs`

package/docs/uk/20-v1-stability.md DELETED Viewed

@@ -1,83 +0,0 @@
-# Стабільність v1
-> Що Mado обіцяє після v1, і що лишається вільним для розвитку.
-Mado v1 означає, що публічний app-facing contract достатньо стабільний для
-реальних business apps. Це не означає, що кожен internal file, generated byte,
-starter copy або diagnostic string заморожені назавжди.
-Читайте разом із:
-- [Карта замороження API](./18-api-freeze-map.md)
-- [Порядок reactivity](./19-reactivity-ordering.md)
-## Стабільно під SemVer
-Після v1 Mado вважає SemVer-protected:
-- Public exports з `@madojs/mado`.
-- Public TypeScript types з `@madojs/mado`.
-- Side-effect subpath `@madojs/mado/devtools.js`.
-- Template binding syntax: child `${}`, `@event`, `.prop`, `?boolean`,
-  attribute bindings, directives і `each()`.
-- Signal semantics, описані в reactivity ordering guide.
-- Component lifecycle semantics: setup один раз за connection lifetime,
-  deferred teardown для same-tick moves, cleanup через `ctx.onDispose`.
-- Router/page/resource/form contracts, описані в English docs.
-- Імена CLI commands і широкий сенс команд (`build`, `dev`, `release`, `bake`,
-  `preview`, `init`, `new`).
-Ламати це можна тільки в major version.
-## Дозволено в minor releases
-Minor releases можуть додавати:
-- New root exports.
-- New options на наявних API.
-- New diagnostics і warnings.
-- New starters, examples, docs і CLI flags.
-- Performance improvements і internal implementation rewrites.
-Minor release не має вимагати змін у вже коректних apps.
-## Дозволено в patch releases
-Patch releases можуть виправляти bugs, посилювати diagnostics, покращувати docs
-і робити сумісні implementation changes. Patch може змінити timing тільки якщо
-старий timing був незадокументованим bug і зміна зберігає reactivity ordering
-contract.
-## Нестабільно
-Це навмисно не захищено SemVer:
-- Internal package subpaths крім `@madojs/mado/devtools.js`.
-- Файли під `src/`, `dist/src/` і implementation module boundaries.
-- `_testHooks`, diagnostics internals і warning codes.
-- Точний generated JavaScript text, chunk names, sourcemap content і bundle
-  byte layout.
-- Internal parser, binding, router і resource cache data structures.
-- Starter app visual copy і demo data.
-Apps не повинні імпортувати internal files або перевіряти точний bundle output.
-## Bundle і release output
-Mado триматиме size budget і deterministic release tests, але v1 stability не
-заморожує byte-for-byte bundler output. Hashes, chunk boundaries і generated
-asset names можуть змінюватися, якщо задокументований deployment contract
-продовжує працювати.
-## Якщо release вас зламав
-Якщо update ламає код, який використовує тільки public exports і
-задокументовану поведінку, вважайте це bug. Відкрийте issue з:
-- версією Mado до і після;
-- задіяним public API;
-- мінімальною репродукцією;
-- чи це runtime behaviour, TypeScript types, CLI output або docs.
-Якщо поломка залежить від internal subpath або точного generated output, про це
-все одно варто повідомити, але це не вважається SemVer break.

package/docs/uk/README.md DELETED Viewed

@@ -1,27 +0,0 @@
-# Документація Mado — Українська
-Український комплект документації.
-| Розділ                  | Файл                                                         |
-| ----------------------- | ------------------------------------------------------------ |
-| Шлях Mado               | [00-the-mado-way.md](./00-the-mado-way.md)                   |
-| Маршрутизація           | [01-routing.md](./01-routing.md)                             |
-| Структура проєкту       | [02-project-layout.md](./02-project-layout.md)               |
-| Статичний bake & SEO    | [03-static-bake.md](./03-static-bake.md)                     |
-| Налаштування IDE        | [04-ide-setup.md](./04-ide-setup.md)                         |
-| Чому Mado               | [05-why-mado.md](./05-why-mado.md)                           |
-| Для бекендерів          | [06-for-backenders.md](./06-for-backenders.md)               |
-| Типові помилки LLM      | [07-llm-pitfalls.md](./07-llm-pitfalls.md)                   |
-| LLM zero-history тест   | [08-llm-zero-history-test.md](./08-llm-zero-history-test.md) |
-| Shadow DOM vs Light DOM | [09-shadow-vs-light-dom.md](./09-shadow-vs-light-dom.md)     |
-| Архітектура застосунку  | [10-app-architecture.md](./10-app-architecture.md)           |
-| Макети (layouts)        | [11-layouts.md](./11-layouts.md)                             |
-| Auth та API             | [12-auth-and-api.md](./12-auth-and-api.md)                   |
-| Розгортання             | [13-deployment.md](./13-deployment.md)                       |
-| Тестування              | [14-testing.md](./14-testing.md)                             |
-| Обробка помилок         | [15-error-handling.md](./15-error-handling.md)               |
-| Рецепти bake            | [16-bake-cookbook.md](./16-bake-cookbook.md)                 |
-| Shadow DOM + форми      | [17-shadow-dom-forms.md](./17-shadow-dom-forms.md)           |
-| Карта замороження API   | [18-api-freeze-map.md](./18-api-freeze-map.md)               |
-| Порядок reactivity      | [19-reactivity-ordering.md](./19-reactivity-ordering.md)     |
-| Стабільність v1         | [20-v1-stability.md](./20-v1-stability.md)                   |

package/starters/default/src/modules/home/not-found.page.ts DELETED Viewed

@@ -1,11 +0,0 @@
-import { html, page } from "@madojs/mado";
-export default page({
-  title: "Not Found",
-  view: () => html`
-    <section>
-      <h1>404</h1>
-      <p>This route does not exist. <a href="/">Go home</a>.</p>
-    </section>
-  `,
-});