@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.
- 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/dist/src/css.js
CHANGED
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
* - if the browser has @scope (Chrome 118+, Safari 17.4+), we wrap styles.
|
|
17
17
|
* - fallback: prefix selectors with the tag — a simple regex at string level.
|
|
18
18
|
*/
|
|
19
|
+
const stylesheetText = new WeakMap();
|
|
19
20
|
/**
|
|
20
21
|
* Tagged literal for CSS. Returns a CSSStyleSheet ready for
|
|
21
22
|
* adoptedStyleSheets. Value interpolation — only primitives or
|
|
@@ -34,8 +35,7 @@ export function css(strings, ...values) {
|
|
|
34
35
|
continue;
|
|
35
36
|
if (v instanceof CSSStyleSheet) {
|
|
36
37
|
// composition — insert all rules
|
|
37
|
-
|
|
38
|
-
text += rule.cssText;
|
|
38
|
+
text += getStylesheetText(v) ?? rulesText(v);
|
|
39
39
|
continue;
|
|
40
40
|
}
|
|
41
41
|
const s = String(v);
|
|
@@ -47,8 +47,24 @@ export function css(strings, ...values) {
|
|
|
47
47
|
}
|
|
48
48
|
const sheet = new CSSStyleSheet();
|
|
49
49
|
sheet.replaceSync(text);
|
|
50
|
+
stylesheetText.set(sheet, text);
|
|
50
51
|
return sheet;
|
|
51
52
|
}
|
|
53
|
+
/** @internal */
|
|
54
|
+
export function createStylesheet(text) {
|
|
55
|
+
const sheet = new CSSStyleSheet();
|
|
56
|
+
sheet.replaceSync(text);
|
|
57
|
+
stylesheetText.set(sheet, text);
|
|
58
|
+
return sheet;
|
|
59
|
+
}
|
|
60
|
+
/** @internal */
|
|
61
|
+
export function getStylesheetText(sheet) {
|
|
62
|
+
return stylesheetText.get(sheet);
|
|
63
|
+
}
|
|
64
|
+
/** @internal */
|
|
65
|
+
export function getStylesheetHash(sheet) {
|
|
66
|
+
return stableHash(getStylesheetText(sheet) ?? rulesText(sheet));
|
|
67
|
+
}
|
|
52
68
|
/**
|
|
53
69
|
* Build an inline-style string from a CSS variables object.
|
|
54
70
|
*
|
|
@@ -104,9 +120,7 @@ const hasScope = (() => {
|
|
|
104
120
|
* → 'x-button button { color: red }'
|
|
105
121
|
*/
|
|
106
122
|
export function scopeStyles(tagName, sheet) {
|
|
107
|
-
|
|
108
|
-
for (const rule of sheet.cssRules)
|
|
109
|
-
text += rule.cssText;
|
|
123
|
+
const text = getStylesheetText(sheet) ?? rulesText(sheet);
|
|
110
124
|
let scoped;
|
|
111
125
|
if (hasScope) {
|
|
112
126
|
scoped = `@scope (${tagName}) { ${text} }`;
|
|
@@ -132,6 +146,21 @@ export function scopeStyles(tagName, sheet) {
|
|
|
132
146
|
}
|
|
133
147
|
const out = new CSSStyleSheet();
|
|
134
148
|
out.replaceSync(scoped);
|
|
149
|
+
stylesheetText.set(out, scoped);
|
|
135
150
|
return out;
|
|
136
151
|
}
|
|
152
|
+
function rulesText(sheet) {
|
|
153
|
+
let text = "";
|
|
154
|
+
for (const rule of sheet.cssRules)
|
|
155
|
+
text += rule.cssText;
|
|
156
|
+
return text;
|
|
157
|
+
}
|
|
158
|
+
function stableHash(text) {
|
|
159
|
+
let hash = 0x811c9dc5;
|
|
160
|
+
for (let i = 0; i < text.length; i++) {
|
|
161
|
+
hash ^= text.charCodeAt(i);
|
|
162
|
+
hash = Math.imul(hash, 0x01000193);
|
|
163
|
+
}
|
|
164
|
+
return (hash >>> 0).toString(36);
|
|
165
|
+
}
|
|
137
166
|
//# sourceMappingURL=css.js.map
|
package/dist/src/css.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,CACjB,OAA6B,EAC7B,GAAG,MAAiB;IAEpB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,IAAI;gBAAE,SAAS;YACxB,IAAI,CAAC,YAAY,aAAa,EAAE,CAAC;gBAC/B,iCAAiC;gBACjC,
|
|
1
|
+
{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,cAAc,GAAG,IAAI,OAAO,EAAyB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,CACjB,OAA6B,EAC7B,GAAG,MAAiB;IAEpB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,IAAI,IAAI;gBAAE,SAAS;YACxB,IAAI,CAAC,YAAY,aAAa,EAAE,CAAC;gBAC/B,iCAAiC;gBACjC,IAAI,IAAI,iBAAiB,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC7C,SAAS;YACX,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACxB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACxB,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,OAAO,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,OAAO,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,IAAqC;IAC3D,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,IAAI;YAAE,SAAS;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,GAAG,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAgB,EAAE,GAAG,MAAmB;IAC5D,yEAAyE;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,IAAI,CAAC,kBAAkB,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,iEAAiE;AAGjE,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACrC,+BAA+B;YAC/B,OAAQ,OAA8C,CAAC,UAAU;gBAC/D,WAAW,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAgB;IAC3D,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;IAE1D,IAAI,MAAc,CAAC;IACnB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,WAAW,OAAO,OAAO,IAAI,IAAI,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,0DAA0D;QAC1D,0DAA0D;QAC1D,0BAA0B;QAC1B,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACrE,MAAM,QAAQ,GAAG,GAAG;iBACjB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE;gBACjB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO;oBAAE,OAAO,OAAO,CAAC;gBAC7B,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;oBAAE,OAAO,OAAO,CAAC;gBAChD,OAAO,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;YACjC,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,GAAG,KAAK,IAAI,QAAQ,IAAI,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,aAAa,EAAE,CAAC;IAChC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACxB,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,KAAoB;IACrC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ;QAAE,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC"}
|
package/dist/src/head.d.ts
CHANGED
|
@@ -3,17 +3,17 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Approach: we mark all tags we create with the `data-mado-head` attribute.
|
|
5
5
|
* On the next `applyHead` we first remove all ours, then insert the new ones.
|
|
6
|
-
* Existing meta from
|
|
6
|
+
* Existing meta from static HTML (without `data-mado-head`) — we don't touch,
|
|
7
7
|
* but they won't interfere: duplicates in <head> are valid.
|
|
8
8
|
*
|
|
9
|
-
* If HTML was
|
|
10
|
-
* On first
|
|
11
|
-
*
|
|
9
|
+
* If HTML was snapshotted, meta+ld from page.head() are already there.
|
|
10
|
+
* On first takeover we either skip applyHead, or mark static tags as not ours.
|
|
11
|
+
* Client-side apply will add its own data-mado-head copies, and the old static
|
|
12
12
|
* ones remain for SEO caching without any negative effect
|
|
13
13
|
* (canonical, jsonLd — don't depend on count).
|
|
14
14
|
*
|
|
15
|
-
* For strict
|
|
16
|
-
* `data-mado-head="
|
|
15
|
+
* For strict static HTML + SPA navigation: also mark static head tags with
|
|
16
|
+
* `data-mado-head="static"`, then the first applyHead removes and replaces them.
|
|
17
17
|
*/
|
|
18
18
|
import type { HeadMeta } from "./page.js";
|
|
19
19
|
export declare function applyHead(meta: HeadMeta): void;
|
package/dist/src/head.js
CHANGED
|
@@ -3,17 +3,17 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Approach: we mark all tags we create with the `data-mado-head` attribute.
|
|
5
5
|
* On the next `applyHead` we first remove all ours, then insert the new ones.
|
|
6
|
-
* Existing meta from
|
|
6
|
+
* Existing meta from static HTML (without `data-mado-head`) — we don't touch,
|
|
7
7
|
* but they won't interfere: duplicates in <head> are valid.
|
|
8
8
|
*
|
|
9
|
-
* If HTML was
|
|
10
|
-
* On first
|
|
11
|
-
*
|
|
9
|
+
* If HTML was snapshotted, meta+ld from page.head() are already there.
|
|
10
|
+
* On first takeover we either skip applyHead, or mark static tags as not ours.
|
|
11
|
+
* Client-side apply will add its own data-mado-head copies, and the old static
|
|
12
12
|
* ones remain for SEO caching without any negative effect
|
|
13
13
|
* (canonical, jsonLd — don't depend on count).
|
|
14
14
|
*
|
|
15
|
-
* For strict
|
|
16
|
-
* `data-mado-head="
|
|
15
|
+
* For strict static HTML + SPA navigation: also mark static head tags with
|
|
16
|
+
* `data-mado-head="static"`, then the first applyHead removes and replaces them.
|
|
17
17
|
*/
|
|
18
18
|
const MARK = "data-mado-head";
|
|
19
19
|
export function applyHead(meta) {
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
*
|
|
5
5
|
* It does not depend on the reactive runtime (signal/each/effect), only on DOM
|
|
6
6
|
* APIs (document.createElement and walking Node trees). That makes it possible
|
|
7
|
-
* to test the parser in isolation and reuse it for
|
|
7
|
+
* to test the parser in isolation and reuse it for future static tooling.
|
|
8
8
|
*
|
|
9
9
|
* Algorithm:
|
|
10
10
|
* 1. Walk strings[] char-by-char through an explicit finite state machine.
|
package/dist/src/html/parser.js
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
*
|
|
5
5
|
* It does not depend on the reactive runtime (signal/each/effect), only on DOM
|
|
6
6
|
* APIs (document.createElement and walking Node trees). That makes it possible
|
|
7
|
-
* to test the parser in isolation and reuse it for
|
|
7
|
+
* to test the parser in isolation and reuse it for future static tooling.
|
|
8
8
|
*
|
|
9
9
|
* Algorithm:
|
|
10
10
|
* 1. Walk strings[] char-by-char through an explicit finite state machine.
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
import { warnOnce } from "../diagnostics.js";
|
|
13
13
|
import { parseTemplate, resolvePath, } from "./parser.js";
|
|
14
14
|
import { bindAttr, bindChild, createChildState, disposeChildState, } from "./bindings.js";
|
|
15
|
+
import { _flushDeferredStaticElements } from "../component.js";
|
|
15
16
|
/**
|
|
16
17
|
* `html\`<div>${value}</div>\`` → template descriptor.
|
|
17
18
|
*
|
|
@@ -109,21 +110,34 @@ export function render(result, container) {
|
|
|
109
110
|
}
|
|
110
111
|
existing.dispose();
|
|
111
112
|
}
|
|
112
|
-
//
|
|
113
|
+
// Static snapshots write first-paint markup into #app and mark the
|
|
113
114
|
// container. That markup is not hydrated: once the client app starts, Mado
|
|
114
|
-
// owns the container again and replaces
|
|
115
|
-
const
|
|
115
|
+
// owns the container again and atomically replaces it with live bindings.
|
|
116
|
+
const isStaticContainer = !existing &&
|
|
116
117
|
"hasAttribute" in container &&
|
|
117
|
-
container.hasAttribute("data-mado-
|
|
118
|
-
if (
|
|
119
|
-
container.replaceChildren();
|
|
120
|
-
container.removeAttribute("data-mado-baked");
|
|
121
|
-
}
|
|
122
|
-
if (!existing && container.childNodes.length > 0) {
|
|
118
|
+
container.hasAttribute("data-mado-static");
|
|
119
|
+
if (!isStaticContainer && !existing && container.childNodes.length > 0) {
|
|
123
120
|
warnOnce("render-unmanaged-dom", "render() called on a container with existing DOM that was not created by Mado. It will remain alongside the new render output.");
|
|
124
121
|
}
|
|
122
|
+
// Build the live fragment OFF-DOM first. This guarantees that:
|
|
123
|
+
// - any new Custom Element inside the fragment is parsed and constructed
|
|
124
|
+
// but its connectedCallback() does not fire until insertion,
|
|
125
|
+
// - the old static tree (whose deferred children skipped setup()) is
|
|
126
|
+
// still in the DOM as inert first-paint markup,
|
|
127
|
+
// - we then swap children atomically with replaceChildren(), avoiding
|
|
128
|
+
// any frame where the container is visibly empty.
|
|
125
129
|
const inst = instantiate(result);
|
|
126
|
-
|
|
130
|
+
if (isStaticContainer) {
|
|
131
|
+
// Order matters: remove the marker BEFORE inserting the live fragment so
|
|
132
|
+
// newly-connecting Custom Elements no longer see a static ancestor and
|
|
133
|
+
// run setup() exactly once.
|
|
134
|
+
container.removeAttribute("data-mado-static");
|
|
135
|
+
container.replaceChildren(inst.fragment);
|
|
136
|
+
_flushDeferredStaticElements();
|
|
137
|
+
}
|
|
138
|
+
else {
|
|
139
|
+
container.appendChild(inst.fragment);
|
|
140
|
+
}
|
|
127
141
|
rendered.set(container, inst);
|
|
128
142
|
}
|
|
129
143
|
//# sourceMappingURL=template.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/html/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,WAAW,GAEZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/html/template.ts"],"names":[],"mappings":"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"}
|
package/dist/src/index.d.ts
CHANGED
|
@@ -2,10 +2,13 @@
|
|
|
2
2
|
* Mado — public API.
|
|
3
3
|
*
|
|
4
4
|
* Import everything from one place:
|
|
5
|
-
* import { signal, computed, effect, component, html, router } from
|
|
5
|
+
* import { signal, computed, effect, component, html, router } from "@madojs/mado";
|
|
6
6
|
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
7
|
+
* Vite is the canonical transport: every official starter, generator
|
|
8
|
+
* and CLI command resolves `@madojs/mado` from `node_modules` through
|
|
9
|
+
* the Vite plugin (`@madojs/mado/vite`). Native ESM consumers (tests,
|
|
10
|
+
* partial-SSR probes) get the same surface area; anything that touches
|
|
11
|
+
* `import.meta.env.BASE_URL` falls back to "/" outside Vite.
|
|
9
12
|
*/
|
|
10
13
|
export { signal, computed, effect, untracked, batch, flushSync, } from "./signal.js";
|
|
11
14
|
export type { Signal, Computed, ComputedOptions, Disposer } from "./signal.js";
|
|
@@ -20,11 +23,12 @@ export { css, cssVars, adopt, scopeStyles } from "./css.js";
|
|
|
20
23
|
export type { CSSResult } from "./css.js";
|
|
21
24
|
export { router, queryParam, navigate, } from "./router/navigation.js";
|
|
22
25
|
export { routes, prefetchPath } from "./router/manifest.js";
|
|
26
|
+
export { appBase, routeUrl } from "./router/base.js";
|
|
23
27
|
export type { RouterApi, QueryParam, QuerySignal, } from "./router/navigation.js";
|
|
24
28
|
export type { RouteHandler, RouteParams, Routes, RoutesMap, } from "./router/match.js";
|
|
25
29
|
export type { RoutesOptions } from "./router/manifest.js";
|
|
26
30
|
export { page, layout, isPage, isLayoutGroup } from "./page.js";
|
|
27
|
-
export type { Page, PageContext, PageData, RouteEntry, LayoutRoutes, HeadMeta,
|
|
31
|
+
export type { Page, PageContext, PageData, RouteEntry, LayoutRoutes, HeadMeta, StaticPageConfig, Guard, GuardResult, JsonPrimitive, JsonValue, } from "./page.js";
|
|
28
32
|
export { applyHead } from "./head.js";
|
|
29
33
|
export { resource, mutation, invalidate, jsonFetcher, HttpError, } from "./resource.js";
|
|
30
34
|
export type { Resource, ResourceOptions, Mutation, MutationOptions, } from "./resource.js";
|
package/dist/src/index.js
CHANGED
|
@@ -2,10 +2,13 @@
|
|
|
2
2
|
* Mado — public API.
|
|
3
3
|
*
|
|
4
4
|
* Import everything from one place:
|
|
5
|
-
* import { signal, computed, effect, component, html, router } from
|
|
5
|
+
* import { signal, computed, effect, component, html, router } from "@madojs/mado";
|
|
6
6
|
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
7
|
+
* Vite is the canonical transport: every official starter, generator
|
|
8
|
+
* and CLI command resolves `@madojs/mado` from `node_modules` through
|
|
9
|
+
* the Vite plugin (`@madojs/mado/vite`). Native ESM consumers (tests,
|
|
10
|
+
* partial-SSR probes) get the same surface area; anything that touches
|
|
11
|
+
* `import.meta.env.BASE_URL` falls back to "/" outside Vite.
|
|
9
12
|
*/
|
|
10
13
|
// --- core ---
|
|
11
14
|
export { signal, computed, effect, untracked, batch, flushSync, } from "./signal.js";
|
|
@@ -20,6 +23,13 @@ export { css, cssVars, adopt, scopeStyles } from "./css.js";
|
|
|
20
23
|
// --- routing ---
|
|
21
24
|
export { router, queryParam, navigate, } from "./router/navigation.js";
|
|
22
25
|
export { routes, prefetchPath } from "./router/manifest.js";
|
|
26
|
+
// Application code should use `routeUrl()` exclusively for building
|
|
27
|
+
// internal links. `appBase` is exposed for integrations that need to
|
|
28
|
+
// read the active prefix (e.g. building absolute canonical URLs from a
|
|
29
|
+
// component). `normalizeBase`, `stripBase` and `withBase` are
|
|
30
|
+
// implementation details: they remain unexported until a concrete
|
|
31
|
+
// downstream use case appears.
|
|
32
|
+
export { appBase, routeUrl } from "./router/base.js";
|
|
23
33
|
export { page, layout, isPage, isLayoutGroup } from "./page.js";
|
|
24
34
|
export { applyHead } from "./head.js";
|
|
25
35
|
// --- data ---
|
package/dist/src/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAe;AACf,OAAO,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EACL,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,oBAAoB;AACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EACL,UAAU,EACV,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAa5B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEvC,qBAAqB;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAQ3C,iBAAiB;AACjB,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5D,kBAAkB;AAClB,OAAO,EACL,MAAM,EACN,UAAU,EACV,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5D,oEAAoE;AACpE,qEAAqE;AACrE,uEAAuE;AACvE,8DAA8D;AAC9D,kEAAkE;AAClE,+BAA+B;AAC/B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAcrD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAehE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,eAAe;AACf,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,eAAe,CAAC;AAQvB,gBAAgB;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAcrC,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG9D,sBAAsB;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,mCAAmC;AACnC,EAAE;AACF,4EAA4E;AAC5E,8DAA8D;AAC9D,2DAA2D;AAC3D,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC"}
|
package/dist/src/page.d.ts
CHANGED
|
@@ -26,6 +26,17 @@
|
|
|
26
26
|
import type { TemplateResult } from "./html/template-types.js";
|
|
27
27
|
/** Route params (values from :placeholders). */
|
|
28
28
|
export type RouteParams = Record<string, string>;
|
|
29
|
+
/**
|
|
30
|
+
* JSON-compatible value. Static seeds and any data crossing the build-time →
|
|
31
|
+
* snapshot → client boundary must satisfy this contract: only primitives,
|
|
32
|
+
* plain arrays and plain object trees. Date, Map, Set, class instances,
|
|
33
|
+
* functions, undefined values and circular references are not allowed and
|
|
34
|
+
* fail at serialization time with a route-tagged error.
|
|
35
|
+
*/
|
|
36
|
+
export type JsonPrimitive = string | number | boolean | null;
|
|
37
|
+
export type JsonValue = JsonPrimitive | JsonValue[] | {
|
|
38
|
+
[key: string]: JsonValue;
|
|
39
|
+
};
|
|
29
40
|
/**
|
|
30
41
|
* Loaded data. If load returned a Resource — this is `Resource<T>`,
|
|
31
42
|
* otherwise — a plain value. The view decides what to do with it.
|
|
@@ -57,8 +68,8 @@ export interface PageContext<P extends RouteParams, D> {
|
|
|
57
68
|
onDispose?: (fn: () => void) => void;
|
|
58
69
|
}
|
|
59
70
|
/**
|
|
60
|
-
* Metadata for <head>.
|
|
61
|
-
*
|
|
71
|
+
* Metadata for <head>. Static snapshots write it into HTML, and the SPA
|
|
72
|
+
* runtime updates it on route changes.
|
|
62
73
|
*/
|
|
63
74
|
export interface HeadMeta {
|
|
64
75
|
/** If set — overrides page.title. */
|
|
@@ -97,27 +108,36 @@ export interface HeadMeta {
|
|
|
97
108
|
jsonLd?: unknown;
|
|
98
109
|
}
|
|
99
110
|
/**
|
|
100
|
-
*
|
|
101
|
-
* to
|
|
111
|
+
* Static snapshot configuration: gives the build script enough information
|
|
112
|
+
* to enumerate public routes and seed browser-rendered snapshots.
|
|
113
|
+
*
|
|
114
|
+
* `S` is the JSON-safe seed type (build-time → snapshot → client boundary).
|
|
115
|
+
* It is intentionally decoupled from the runtime `D` data type: a seed of
|
|
116
|
+
* type `Product` is fine even when `page.load()` returns `Resource<Product>`.
|
|
117
|
+
*
|
|
118
|
+
* `static.paths` and `static.initialData` MUST be browser-bundle-safe,
|
|
119
|
+
* build-executable, and secret-free. They are executed during build
|
|
120
|
+
* discovery, but their module also remains in the client bundle: do not
|
|
121
|
+
* import Node-only APIs, do not embed credentials, do not perform side
|
|
122
|
+
* effects at module top level.
|
|
102
123
|
*/
|
|
103
|
-
export interface
|
|
104
|
-
/**
|
|
105
|
-
* List of all params for which to bake a page.
|
|
106
|
-
* Return a ready array (may fetch from API).
|
|
107
|
-
*/
|
|
108
|
-
paths: () => Promise<P[]> | P[];
|
|
124
|
+
export interface StaticPageConfig<P extends RouteParams, S extends JsonValue> {
|
|
109
125
|
/**
|
|
110
|
-
*
|
|
111
|
-
*
|
|
112
|
-
*
|
|
113
|
-
*
|
|
126
|
+
* Route parameter sets to materialize.
|
|
127
|
+
*
|
|
128
|
+
* Optional for literal routes such as "/".
|
|
129
|
+
* Required for dynamic routes such as "/products/:slug".
|
|
114
130
|
*/
|
|
115
|
-
|
|
131
|
+
paths?: () => Promise<P[]> | P[];
|
|
116
132
|
/**
|
|
117
|
-
*
|
|
118
|
-
*
|
|
133
|
+
* Optional build-time seed. Passed to page.head(params, seed)
|
|
134
|
+
* and page.load(params, seed).
|
|
135
|
+
*
|
|
136
|
+
* Used both at build time (to render the snapshot) and at client boot
|
|
137
|
+
* (so the runtime does not re-fetch what the snapshot already knows).
|
|
138
|
+
* The seed is consumed exactly once per route commit.
|
|
119
139
|
*/
|
|
120
|
-
|
|
140
|
+
initialData?: (params: P) => Promise<S> | S;
|
|
121
141
|
}
|
|
122
142
|
/**
|
|
123
143
|
* Guard verdict.
|
|
@@ -149,21 +169,30 @@ export type Guard = (ctx: {
|
|
|
149
169
|
params: RouteParams;
|
|
150
170
|
path: string;
|
|
151
171
|
}) => GuardResult | Promise<GuardResult>;
|
|
152
|
-
export interface Page<P extends RouteParams = RouteParams, D = unknown> {
|
|
172
|
+
export interface Page<P extends RouteParams = RouteParams, D = unknown, S extends JsonValue = JsonValue> {
|
|
153
173
|
readonly _page: true;
|
|
154
174
|
title?: string | ((params: P) => string);
|
|
155
|
-
|
|
175
|
+
/**
|
|
176
|
+
* Runtime data loader. Receives params and the optional static seed
|
|
177
|
+
* (only present on the first client boot of a static route, never
|
|
178
|
+
* during SPA navigation).
|
|
179
|
+
*/
|
|
180
|
+
load?: (params: P, seed?: S) => D;
|
|
156
181
|
view: (ctx: PageContext<P, D>) => TemplateResult;
|
|
157
182
|
/**
|
|
158
|
-
* <head> metadata. Receives params and
|
|
159
|
-
*
|
|
183
|
+
* <head> metadata. Receives params and the optional static seed.
|
|
184
|
+
*
|
|
185
|
+
* `head` is intentionally built from `(params, seed)` and not from the
|
|
186
|
+
* runtime `load()` result: head must be deterministic and JSON-derivable
|
|
187
|
+
* so that it appears in the raw snapshot HTML for SEO and social
|
|
188
|
+
* crawlers.
|
|
160
189
|
*/
|
|
161
|
-
head?: (params: P,
|
|
190
|
+
head?: (params: P, seed?: S) => HeadMeta;
|
|
162
191
|
/**
|
|
163
|
-
* Static HTML
|
|
164
|
-
*
|
|
192
|
+
* Static HTML snapshot declaration. Used only by build-time discovery.
|
|
193
|
+
* Non-static routes remain ordinary SPA routes.
|
|
165
194
|
*/
|
|
166
|
-
|
|
195
|
+
static?: true | StaticPageConfig<P, S>;
|
|
167
196
|
/**
|
|
168
197
|
* Local error boundary. Catches errors from view() and load() of this page.
|
|
169
198
|
* If not set — the global `error` from routes() is used.
|
|
@@ -178,8 +207,13 @@ export interface Page<P extends RouteParams = RouteParams, D = unknown> {
|
|
|
178
207
|
/**
|
|
179
208
|
* Page factory. A typed wrapper over a plain object —
|
|
180
209
|
* needed only for type inference and the single "_page" stamp.
|
|
210
|
+
*
|
|
211
|
+
* The three generic parameters are inferred from `spec` in the common case:
|
|
212
|
+
* page({ static: true, view: () => html`...` })
|
|
213
|
+
* Provide them explicitly only for non-trivial shapes:
|
|
214
|
+
* page<{ slug: string }, Resource<Product>, Product>({ ... })
|
|
181
215
|
*/
|
|
182
|
-
export declare function page<P extends RouteParams = RouteParams, D = unknown>(spec: Omit<Page<P, D>, "_page">): Page<P, D>;
|
|
216
|
+
export declare function page<P extends RouteParams = RouteParams, D = unknown, S extends JsonValue = JsonValue>(spec: Omit<Page<P, D, S>, "_page">): Page<P, D, S>;
|
|
183
217
|
export declare const isPage: (v: unknown) => v is Page;
|
|
184
218
|
/**
|
|
185
219
|
* Manifest entry — what should respond to a path.
|
|
@@ -191,7 +225,7 @@ export declare const isPage: (v: unknown) => v is Page;
|
|
|
191
225
|
* can be assigned here (TS disallows Page<{slug:string}> → Page<RouteParams>
|
|
192
226
|
* due to parameter contravariance).
|
|
193
227
|
*/
|
|
194
|
-
export type AnyPage = Page<any, any>;
|
|
228
|
+
export type AnyPage = Page<any, any, any>;
|
|
195
229
|
export type RouteEntry = AnyPage | (() => Promise<{
|
|
196
230
|
default: AnyPage;
|
|
197
231
|
}>) | LayoutRoutes;
|
package/dist/src/page.js
CHANGED
|
@@ -26,6 +26,11 @@
|
|
|
26
26
|
/**
|
|
27
27
|
* Page factory. A typed wrapper over a plain object —
|
|
28
28
|
* needed only for type inference and the single "_page" stamp.
|
|
29
|
+
*
|
|
30
|
+
* The three generic parameters are inferred from `spec` in the common case:
|
|
31
|
+
* page({ static: true, view: () => html`...` })
|
|
32
|
+
* Provide them explicitly only for non-trivial shapes:
|
|
33
|
+
* page<{ slug: string }, Resource<Product>, Product>({ ... })
|
|
29
34
|
*/
|
|
30
35
|
export function page(spec) {
|
|
31
36
|
return { _page: true, ...spec };
|
package/dist/src/page.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;
|
|
1
|
+
{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAkMH;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAIlB,IAAkC;IAClC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAU,EAAa,EAAE,CAC9C,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAAU,CAAC,KAAK,KAAK,IAAI,CAAC;AAmCpE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CAAC,IAAmC;IACxD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAU,EAAqB,EAAE,CAC7D,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAAkB,CAAC,OAAO,KAAK,IAAI,CAAC"}
|
package/dist/src/resource.js
CHANGED
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
import { signal, effect, untracked } from "./signal.js";
|
|
19
19
|
import { getCurrentLifecycle } from "./lifecycle.js";
|
|
20
20
|
import { warnOnce } from "./diagnostics.js";
|
|
21
|
+
import { trackStatic } from "./static-runtime.js";
|
|
21
22
|
const cache = new Map();
|
|
22
23
|
const inFlight = new Map();
|
|
23
24
|
const invalidators = new Set();
|
|
@@ -175,7 +176,7 @@ function retainInFlight(key, fetcher, force) {
|
|
|
175
176
|
controller,
|
|
176
177
|
fetcher,
|
|
177
178
|
consumers: 0,
|
|
178
|
-
promise: fetcher(key, controller.signal),
|
|
179
|
+
promise: trackStatic(fetcher(key, controller.signal), `resource ${key}`),
|
|
179
180
|
};
|
|
180
181
|
entry.promise.then(() => {
|
|
181
182
|
if (inFlight.get(key) === entry)
|
package/dist/src/resource.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;
|
|
1
|
+
{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/resource.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Normalise an arbitrary base value into the canonical Mado form:
|
|
3
|
+
* starts with "/", ends with "/", collapses repeated slashes. The root
|
|
4
|
+
* base is the literal "/".
|
|
5
|
+
*
|
|
6
|
+
* normalizeBase("") === "/"
|
|
7
|
+
* normalizeBase("/") === "/"
|
|
8
|
+
* normalizeBase("mado") === "/mado/"
|
|
9
|
+
* normalizeBase("/mado") === "/mado/"
|
|
10
|
+
* normalizeBase("/mado/") === "/mado/"
|
|
11
|
+
* normalizeBase("//x//y/") === "/x/y/"
|
|
12
|
+
*/
|
|
13
|
+
export declare function normalizeBase(raw: string | null | undefined): string;
|
|
14
|
+
/**
|
|
15
|
+
* The active base prefix for the running app. Computed once from
|
|
16
|
+
* `import.meta.env.BASE_URL` and normalised. Use it inside Mado runtime;
|
|
17
|
+
* application code should call `routeUrl()` instead.
|
|
18
|
+
*/
|
|
19
|
+
export declare const appBase: string;
|
|
20
|
+
/**
|
|
21
|
+
* Strip the base prefix off a browser pathname so it becomes a route
|
|
22
|
+
* pathname the matcher understands.
|
|
23
|
+
*
|
|
24
|
+
* base = "/mado/"
|
|
25
|
+
* stripBase("/mado/") === "/"
|
|
26
|
+
* stripBase("/mado/docs") === "/docs"
|
|
27
|
+
* stripBase("/mado/docs/") === "/docs"
|
|
28
|
+
* stripBase("/other") === "/other" (no base → unchanged)
|
|
29
|
+
* stripBase("") === "/"
|
|
30
|
+
*
|
|
31
|
+
* base = "/"
|
|
32
|
+
* stripBase("/docs") === "/docs"
|
|
33
|
+
*/
|
|
34
|
+
export declare function stripBase(pathname: string, base?: string): string;
|
|
35
|
+
/**
|
|
36
|
+
* Prefix a route pathname with the active base so it becomes a real
|
|
37
|
+
* browser URL suitable for `history.pushState` and `<a href>`.
|
|
38
|
+
*
|
|
39
|
+
* base = "/mado/"
|
|
40
|
+
* withBase("/") === "/mado/"
|
|
41
|
+
* withBase("/docs") === "/mado/docs"
|
|
42
|
+
* withBase("/docs/", b) === "/mado/docs/"
|
|
43
|
+
* withBase("docs") === "/mado/docs"
|
|
44
|
+
*
|
|
45
|
+
* base = "/"
|
|
46
|
+
* withBase("/docs") === "/docs"
|
|
47
|
+
*/
|
|
48
|
+
export declare function withBase(pathname: string, base?: string): string;
|
|
49
|
+
/**
|
|
50
|
+
* Build an internal link URL: prefix the given route pathname with the
|
|
51
|
+
* active Vite base, preserving query and hash. This is the canonical way
|
|
52
|
+
* to emit `<a href>` values in Mado views.
|
|
53
|
+
*
|
|
54
|
+
* import { routeUrl } from "@madojs/mado";
|
|
55
|
+
* html`<a data-link href=${routeUrl("/docs")}>Docs</a>`
|
|
56
|
+
*
|
|
57
|
+
* base = "/mado/"
|
|
58
|
+
* routeUrl("/docs") === "/mado/docs"
|
|
59
|
+
* routeUrl("/docs?q=1#h") === "/mado/docs?q=1#h"
|
|
60
|
+
* routeUrl("/") === "/mado/"
|
|
61
|
+
*
|
|
62
|
+
* base = "/"
|
|
63
|
+
* routeUrl("/docs") === "/docs"
|
|
64
|
+
*/
|
|
65
|
+
export declare function routeUrl(pathname: string, base?: string): string;
|