@timber-js/app 0.2.0-alpha.243 → 0.2.0-alpha.244
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/dist/_chunks/{actions-DoTj0Jd3.js → actions-D_LiN5xG.js} +4 -4
- package/dist/_chunks/actions-D_LiN5xG.js.map +1 -0
- package/dist/_chunks/{cli-check-DlQBSKIN.js → cli-check-BE9BnXwi.js} +5 -5
- package/dist/_chunks/cli-check-BE9BnXwi.js.map +1 -0
- package/dist/_chunks/{convention-lint-CGGcseNn.js → convention-lint-DkSDlsPH.js} +36 -8
- package/dist/_chunks/convention-lint-DkSDlsPH.js.map +1 -0
- package/dist/_chunks/{dev-server-LO4McfQi.js → dev-server-BZxFJNih.js} +66 -9
- package/dist/_chunks/{dev-server-LO4McfQi.js.map → dev-server-BZxFJNih.js.map} +1 -1
- package/dist/_chunks/dev-server-C72bB9Kg.js +1 -0
- package/dist/_chunks/{key-headers-uIig1_mU.js → key-headers-CVpa6fpW.js} +6 -2
- package/dist/_chunks/key-headers-CVpa6fpW.js.map +1 -0
- package/dist/cli-check.d.ts +3 -3
- package/dist/cli-check.d.ts.map +1 -1
- package/dist/cli.js +2 -2
- package/dist/config-types.d.ts +43 -22
- package/dist/config-types.d.ts.map +1 -1
- package/dist/config-validation.d.ts.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -4
- package/dist/index.js.map +1 -1
- package/dist/native/rsc/manifest.json +1 -0
- package/dist/native/rsc/server/route-element-builder.js +1 -1
- package/dist/native/rsc/server/route-element-builder.js.map +1 -1
- package/dist/native/rsc/server/route-module-loader.js +5 -4
- package/dist/native/rsc/server/route-module-loader.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/render-route.js +1 -1
- package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +1 -1
- package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/outlet-gate.js +2 -1
- package/dist/native/rsc/server/segment-lifetime/outlet-gate.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/read-rule.js +2 -2
- package/dist/native/rsc/server/segment-lifetime/read-rule.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/segment-key.js +13 -8
- package/dist/native/rsc/server/segment-lifetime/segment-key.js.map +1 -1
- package/dist/native/rsc/server/segment-lifetime/slot-outlets.js +5 -4
- package/dist/native/rsc/server/segment-lifetime/slot-outlets.js.map +1 -1
- package/dist/native/rsc/shared/key-headers.js +4 -1
- package/dist/native/rsc/shared/key-headers.js.map +1 -1
- package/dist/native/rsc/shared/layout-defaults.js +19 -0
- package/dist/native/rsc/shared/layout-defaults.js.map +1 -0
- package/dist/native/ssr/manifest.json +1 -0
- package/dist/native/ssr/server/segment-lifetime/outlet-gate.js +1 -0
- package/dist/native/ssr/server/segment-lifetime/outlet-gate.js.map +1 -1
- package/dist/native/ssr/server/segment-lifetime/read-rule.js +2 -2
- package/dist/native/ssr/server/segment-lifetime/read-rule.js.map +1 -1
- package/dist/native/ssr/shared/key-headers.js +4 -1
- package/dist/native/ssr/shared/key-headers.js.map +1 -1
- package/dist/native/ssr/shared/layout-defaults.js +9 -0
- package/dist/native/ssr/shared/layout-defaults.js.map +1 -0
- package/dist/plugins/entries.d.ts.map +1 -1
- package/dist/routing/convention-lint.d.ts +2 -2
- package/dist/routing/convention-lint.d.ts.map +1 -1
- package/dist/routing/route-options-lint.d.ts +2 -2
- package/dist/routing/route-options-lint.d.ts.map +1 -1
- package/dist/server/index.js +1 -1
- package/dist/server/internal.js +1 -1
- package/dist/server/route-module-loader.d.ts +4 -3
- package/dist/server/route-module-loader.d.ts.map +1 -1
- package/dist/server/rsc-entry/index.d.ts.map +1 -1
- package/dist/server/rsc-entry/render-route.d.ts +3 -3
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
- package/dist/server/rsc-entry/revalidate-renderer.d.ts +3 -3
- package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -1
- package/dist/server/segment-lifetime/outlet-gate.d.ts +5 -5
- package/dist/server/segment-lifetime/outlet-gate.d.ts.map +1 -1
- package/dist/server/segment-lifetime/read-rule.d.ts.map +1 -1
- package/dist/server/segment-lifetime/segment-key.d.ts +21 -18
- package/dist/server/segment-lifetime/segment-key.d.ts.map +1 -1
- package/dist/server/segment-lifetime/slot-outlets.d.ts +2 -3
- package/dist/server/segment-lifetime/slot-outlets.d.ts.map +1 -1
- package/dist/server/types.d.ts +4 -3
- package/dist/server/types.d.ts.map +1 -1
- package/dist/shared/key-headers.d.ts +2 -0
- package/dist/shared/key-headers.d.ts.map +1 -1
- package/dist/shared/layout-defaults.d.ts +30 -0
- package/dist/shared/layout-defaults.d.ts.map +1 -0
- package/docs/api/30-api-server.mdx +1 -1
- package/docs/api/34-api-config.mdx +20 -3
- package/package.json +1 -1
- package/src/cli-check.ts +6 -6
- package/src/config-types.ts +44 -22
- package/src/config-validation.ts +96 -20
- package/src/index.ts +1 -1
- package/src/plugins/entries.ts +6 -3
- package/src/plugins/routing.ts +1 -1
- package/src/routing/convention-lint.ts +5 -3
- package/src/routing/route-options-lint.ts +6 -6
- package/src/server/route-element-builder.ts +1 -1
- package/src/server/route-module-loader.ts +7 -6
- package/src/server/rsc-entry/index.ts +7 -8
- package/src/server/rsc-entry/render-route.ts +4 -4
- package/src/server/rsc-entry/revalidate-renderer.ts +4 -4
- package/src/server/segment-lifetime/outlet-gate.ts +6 -6
- package/src/server/segment-lifetime/read-rule.ts +5 -2
- package/src/server/segment-lifetime/segment-key.ts +32 -24
- package/src/server/segment-lifetime/slot-outlets.ts +7 -11
- package/src/server/types.ts +4 -3
- package/src/shared/key-headers.ts +5 -0
- package/src/shared/layout-defaults.ts +43 -0
- package/dist/_chunks/actions-DoTj0Jd3.js.map +0 -1
- package/dist/_chunks/cli-check-DlQBSKIN.js.map +0 -1
- package/dist/_chunks/convention-lint-CGGcseNn.js.map +0 -1
- package/dist/_chunks/dev-server-DrjLscqT.js +0 -1
- package/dist/_chunks/key-headers-uIig1_mU.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"revalidate-renderer.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/revalidate-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM/D,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"revalidate-renderer.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/revalidate-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM/D,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAG9E,0DAA0D;AAC1D,KAAK,cAAc,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAiCpE;AAwBD,kFAAkF;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAElF,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,YAAY,CAAC;IACzB,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,aAAa,EAAE,aAAa,CAAC;IAC7B;;;;;;OAMG;IACH,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,mEAAmE;IACnE,cAAc,EAAE,sBAAsB,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,sBAAsB,GAC3B,CAAC,GAAG,EAAE,OAAO,KAAK,kBAAkB,CAoLtC"}
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
*/
|
|
15
15
|
import { type ReactElement, type ReactNode } from 'react';
|
|
16
16
|
import type { DocumentKeys, DocumentOutlet } from './document-outlet.ts';
|
|
17
|
-
import type
|
|
17
|
+
import { type ResolvedLayoutDefaults } from '../../shared/layout-defaults.ts';
|
|
18
18
|
/** One outlet in the element tree, and the outlets directly inside it. */
|
|
19
19
|
export interface OutletSpec {
|
|
20
20
|
segmentPath: string;
|
|
@@ -31,11 +31,11 @@ export interface SegmentRender {
|
|
|
31
31
|
*/
|
|
32
32
|
documents: DocumentKeys | null;
|
|
33
33
|
/**
|
|
34
|
-
*
|
|
35
|
-
* `
|
|
36
|
-
*
|
|
34
|
+
* What a layout that declares no lifetime, or a key without `headers`,
|
|
35
|
+
* takes: the app's `layoutDefaults` (design/53 §"App-wide defaults").
|
|
36
|
+
* Pages take none.
|
|
37
37
|
*/
|
|
38
|
-
|
|
38
|
+
layoutDefaults: ResolvedLayoutDefaults;
|
|
39
39
|
}
|
|
40
40
|
/** A render with no client router to hold segments: every outlet live. */
|
|
41
41
|
export declare const LIVE_ONLY_RENDER: SegmentRender;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"outlet-gate.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/outlet-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"outlet-gate.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/outlet-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAElG,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,cAAc,EAAE,sBAAsB,CAAC;CACxC;AAED,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAE,aAG9B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAOzD;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAI1D"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"read-rule.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/read-rule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,oFAAoF;AACpF,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,SAAS,CAEhE;
|
|
1
|
+
{"version":3,"file":"read-rule.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/read-rule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,oFAAoF;AACpF,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,SAAS,CAEhE;AAwDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,GAAG,eAAe,CAyChG;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGpD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CActE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAYnE;AAiBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CA6BlE"}
|
|
@@ -23,35 +23,38 @@
|
|
|
23
23
|
*/
|
|
24
24
|
import type { CoercedParams } from '../../shared/param-value.ts';
|
|
25
25
|
import { type RouteOptionsKind } from '../../shared/route-options-export.ts';
|
|
26
|
-
import
|
|
26
|
+
import { type ResolvedLayoutDefaults } from '../../shared/layout-defaults.ts';
|
|
27
|
+
import type { SegmentKey } from '../types.ts';
|
|
27
28
|
/** A segment declared `lifetime: 'document'`, with the key it declared (if any). */
|
|
28
29
|
export interface DocumentLifetime {
|
|
29
30
|
key: SegmentKey;
|
|
30
31
|
}
|
|
31
32
|
/**
|
|
32
|
-
* The
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
* A page always defaults to `'request'`.
|
|
33
|
+
* The defaults of the layout at the end of `chain` (the segments from the
|
|
34
|
+
* root down to it, slot chains included): the app's `layoutDefaults`, except
|
|
35
|
+
* at or below an intercepting segment. Options there are a build error
|
|
36
|
+
* (`routing/route-options-lint.ts`), so a defaulted layout under an
|
|
37
|
+
* intercepting directory could never opt out — it takes no defaults instead
|
|
38
|
+
* (design/53 §"App-wide defaults"). A page always takes `NO_LAYOUT_DEFAULTS`.
|
|
39
39
|
*/
|
|
40
|
-
export declare function
|
|
40
|
+
export declare function layoutDefaultsAt(chain: readonly {
|
|
41
41
|
segmentType?: string;
|
|
42
|
-
}[],
|
|
42
|
+
}[], appDefaults: ResolvedLayoutDefaults): ResolvedLayoutDefaults;
|
|
43
43
|
/**
|
|
44
44
|
* The module's lifetime: a `DocumentLifetime` when its options object
|
|
45
|
-
* declares `lifetime: 'document'`, or declares no lifetime and
|
|
46
|
-
* `
|
|
47
|
-
*
|
|
48
|
-
* what takes effect.
|
|
45
|
+
* declares `lifetime: 'document'`, or declares no lifetime and the default is
|
|
46
|
+
* `'document'`; undefined otherwise. The build validated the object from
|
|
47
|
+
* source (`routing/route-options.ts`); this runtime read is what takes effect.
|
|
49
48
|
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
49
|
+
* Each key part defaults on its own, as `segmentParams` already does: a
|
|
50
|
+
* `'document'` segment whose key omits `headers` takes the default headers,
|
|
51
|
+
* and one that declares `headers` replaces them.
|
|
52
|
+
*
|
|
53
|
+
* @param defaults What a module that declares none takes: the app's
|
|
54
|
+
* `layoutDefaults` for a layout (`layoutDefaultsAt`), `NO_LAYOUT_DEFAULTS`
|
|
55
|
+
* for a page (design/53 §"App-wide defaults").
|
|
53
56
|
*/
|
|
54
|
-
export declare function readDocumentLifetime(mod: Record<string, unknown>, kind: RouteOptionsKind,
|
|
57
|
+
export declare function readDocumentLifetime(mod: Record<string, unknown>, kind: RouteOptionsKind, defaults: ResolvedLayoutDefaults): DocumentLifetime | undefined;
|
|
55
58
|
/**
|
|
56
59
|
* The canonical key values of one segment in the current request.
|
|
57
60
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"segment-key.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/segment-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAInG,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"segment-key.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/segment-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAInG,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,UAAU,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC1C,WAAW,EAAE,sBAAsB,GAClC,sBAAsB,CAGxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,sBAAsB,GAC/B,gBAAgB,GAAG,SAAS,CAe9B;AAkBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,gBAAgB,EAC1B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,EAAE,aAAa,GACpB,MAAM,CAuBR"}
|
|
@@ -54,9 +54,8 @@ export declare class SlotDocumentOutlets {
|
|
|
54
54
|
/** The outlets built so far that no outlet built so far contains. */
|
|
55
55
|
outermost(): OutletSpec[];
|
|
56
56
|
/**
|
|
57
|
-
* A slot segment's lifetime: its own declaration,
|
|
58
|
-
* `
|
|
59
|
-
* `'request'` for a page.
|
|
57
|
+
* A slot segment's lifetime: its own declaration, over the app's
|
|
58
|
+
* `layoutDefaults` for a layout (`layoutDefaultsAt`) and none for a page.
|
|
60
59
|
*/
|
|
61
60
|
lifetimeOf(node: ManifestSegmentNode, mod: Record<string, unknown>, kind: 'page' | 'layout'): DocumentLifetime | undefined;
|
|
62
61
|
/** Wrap a `'document'` slot page in its own outlet. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"slot-outlets.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/slot-outlets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,
|
|
1
|
+
{"version":3,"file":"slot-outlets.d.ts","sourceRoot":"","sources":["../../../src/server/segment-lifetime/slot-outlets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAA0C,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,iDAAiD;IACjD,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,sEAAsE;IACtE,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC3C;;;OAGG;IACH,MAAM,EAAE,MAAM,aAAa,CAAC;CAC7B;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,SAAS,CAAoB;IAErC,YAA6B,GAAG,EAAE,mBAAmB,EAAI;IAEzD,qEAAqE;IACrE,SAAS,IAAI,UAAU,EAAE,CAExB;IAED;;;OAGG;IACH,UAAU,CACR,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,GAAG,QAAQ,GACtB,gBAAgB,GAAG,SAAS,CAK9B;IAED,uDAAuD;IACjD,IAAI,CACR,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,YAAY,CAAC,CAUvB;IAED;;;OAGG;IACG,MAAM,CACV,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,YAAY,GACpD,OAAO,CAAC,YAAY,CAAC,CAevB;IAED;;;OAGG;IACH,MAAM,CACJ,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,MAAM,GAAG,QAAQ,EACvB,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,eAAe,GACzB,eAAe,CAIjB;IAED,OAAO,CAAC,QAAQ;IAUhB,qFAAqF;IACrF,OAAO,CAAC,UAAU;IAOlB,oFAAoF;IACpF,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,KAAK;CAKd"}
|
package/dist/server/types.d.ts
CHANGED
|
@@ -76,7 +76,7 @@ export type RoutePrerender = boolean | {
|
|
|
76
76
|
};
|
|
77
77
|
/**
|
|
78
78
|
* How long a segment's output lives. `'request'` (the default, unless the app
|
|
79
|
-
* sets `
|
|
79
|
+
* sets `layoutDefaults.lifetime` for its layouts) renders on every request. `'document'` renders on the document request and whenever its key
|
|
80
80
|
* changes or `router.refresh()` runs, and is skipped without rendering on
|
|
81
81
|
* every other client navigation. See design/53-segment-lifetime.md.
|
|
82
82
|
*/
|
|
@@ -120,12 +120,13 @@ export interface PageOptions {
|
|
|
120
120
|
}
|
|
121
121
|
/** Options for a `layout.tsx`: `export const layoutOptions = { … } satisfies LayoutOptions`. */
|
|
122
122
|
export interface LayoutOptions {
|
|
123
|
-
/** See `SegmentLifetime`. Default: the app's `
|
|
123
|
+
/** See `SegmentLifetime`. Default: the app's `layoutDefaults.lifetime` (`'request'` unless set). */
|
|
124
124
|
lifetime?: SegmentLifetime;
|
|
125
125
|
/**
|
|
126
126
|
* What a `'document'` layout depends on. Only on a `'document'` layout: one
|
|
127
127
|
* that declares `lifetime: 'document'`, or declares no lifetime under a
|
|
128
|
-
* `'document'` `
|
|
128
|
+
* `'document'` `layoutDefaults.lifetime`. A key that omits `headers` takes
|
|
129
|
+
* `layoutDefaults.key.headers`.
|
|
129
130
|
*/
|
|
130
131
|
key?: SegmentKey;
|
|
131
132
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,gBAAgB,EAAE,GAClB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,wEAAwE;IACxE,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IACzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,aAAa;CAAG;AAgBjC;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAElF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,oEAAoE;IACpE,YAAY,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/D,0DAA0D;IAC1D,OAAO,CAAC,EAAE,SAAS,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;IACzD;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,0FAA0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,qEAAqE;IACrE,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -6,6 +6,8 @@
|
|
|
6
6
|
* the build cannot read every file kind (MDX pages are not linted), and a
|
|
7
7
|
* credential must not become keyable by skipping the lint.
|
|
8
8
|
*/
|
|
9
|
+
/** Whether `value` has the shape of `key.headers`: an array of strings. */
|
|
10
|
+
export declare function isHeaderList(value: unknown): value is readonly string[];
|
|
9
11
|
/** Why a key may not name `name`, or undefined when it may. */
|
|
10
12
|
export declare function headerKeyProblem(name: string): string | undefined;
|
|
11
13
|
/** Whether a key may never name `name` (case-insensitive): a cookie or credential header. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"key-headers.d.ts","sourceRoot":"","sources":["../../src/shared/key-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}
|
|
1
|
+
{"version":3,"file":"key-headers.d.ts","sourceRoot":"","sources":["../../src/shared/key-headers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,MAAM,EAAE,CAEvE;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The app's layout defaults (`layoutDefaults` in `timber.config.ts`), as every
|
|
3
|
+
* reader takes them: the build lint (`routing/route-options-lint.ts`), the
|
|
4
|
+
* runtime config the RSC entry reads (`plugins/entries.ts`), and through it
|
|
5
|
+
* the main chain and slot layouts (`server/segment-lifetime/segment-key.ts`).
|
|
6
|
+
*
|
|
7
|
+
* See design/53-segment-lifetime.md §"App-wide defaults".
|
|
8
|
+
*/
|
|
9
|
+
import type { SegmentLifetime } from '../server/types.ts';
|
|
10
|
+
/** What a layout takes when it declares no lifetime, or a key without `headers`. */
|
|
11
|
+
export interface ResolvedLayoutDefaults {
|
|
12
|
+
lifetime: SegmentLifetime;
|
|
13
|
+
/** The `key.headers` of a `'document'` layout whose key omits `headers`. */
|
|
14
|
+
headers: readonly string[] | undefined;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* No defaults: what a page takes, and a layout at or below an intercepting
|
|
18
|
+
* directory, which could not opt out of one.
|
|
19
|
+
*/
|
|
20
|
+
export declare const NO_LAYOUT_DEFAULTS: ResolvedLayoutDefaults;
|
|
21
|
+
/**
|
|
22
|
+
* Resolve the configured value. Anything config validation reports as
|
|
23
|
+
* malformed reads as no default: a lifetime other than `'document'` is
|
|
24
|
+
* `'request'`, and headers that are not an array of strings are none —
|
|
25
|
+
* slower, never wrong. A header the key may not name is a fatal config error
|
|
26
|
+
* (`config-validation.ts`), and the runtime refuses it again when it reads a
|
|
27
|
+
* layout's key.
|
|
28
|
+
*/
|
|
29
|
+
export declare function resolveLayoutDefaults(value: unknown): ResolvedLayoutDefaults;
|
|
30
|
+
//# sourceMappingURL=layout-defaults.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"layout-defaults.d.ts","sourceRoot":"","sources":["../../src/shared/layout-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,4EAA4E;IAC5E,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,sBAGhC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAM5E"}
|
|
@@ -221,7 +221,7 @@ export const pageOptions = {
|
|
|
221
221
|
| `prerender` | layout, page | Render at build time ([route-level sugar](/docs/api-cache#route-level-sugar)). Layouts cascade it to pages, slot pages included. |
|
|
222
222
|
| `deferSuspenseFor` | layout, page | Hold the SSR stream up to N ms ([`deferSuspenseFor`](/docs/streaming#defersuspensefor)). Main route only, not parallel slots. |
|
|
223
223
|
|
|
224
|
-
The build reads these objects from source, so write them as one object literal with literal values. The exception is `key.searchParams` and `key.cookies`, which name the definitions you import. A `key.segmentParams` name that is not on the segment's path, or a `key` on a segment that is not `'document'`, fails the build. A layout that declares no `lifetime` takes the app's [`
|
|
224
|
+
The build reads these objects from source, so write them as one object literal with literal values. The exception is `key.searchParams` and `key.cookies`, which name the definitions you import. A `key.segmentParams` name that is not on the segment's path, or a `key` on a segment that is not `'document'`, fails the build. A layout that declares no `lifetime` takes the app's [`layoutDefaults.lifetime`](/docs/client-navigation#making-layouts-document-by-default), so under a `'document'` default it may declare `key` alone. A spread, a computed key, a value from a variable, an unknown key, or `layoutOptions` in a page (or the reverse) fails the build with a message naming the fix. An option where it would do nothing also fails the build: in a `'use client'` file, in `default.tsx`, on an intercepting route, or `deferSuspenseFor` in a parallel slot. `satisfies` adds editor completion and type errors; the build checks the object either way. MDX pages are not checked, and `prerender` has no effect in them. `metadata`, `searchParams` and `segmentParams` stay separate exports.
|
|
225
225
|
|
|
226
226
|
## Tracing
|
|
227
227
|
|
|
@@ -32,7 +32,10 @@ interface TimberUserConfig {
|
|
|
32
32
|
optimizePackageImports?: string[];
|
|
33
33
|
slowRequestMs?: number;
|
|
34
34
|
renderTimeoutMs?: number;
|
|
35
|
-
|
|
35
|
+
layoutDefaults?: {
|
|
36
|
+
lifetime?: 'request' | 'document';
|
|
37
|
+
key?: { headers?: readonly string[] };
|
|
38
|
+
};
|
|
36
39
|
devBrowserLogs?: 'error' | 'warn' | 'info' | 'none';
|
|
37
40
|
dev?: {
|
|
38
41
|
slowPhaseMs?: number;
|
|
@@ -211,9 +214,23 @@ Slow request threshold in milliseconds. Requests exceeding this emit a warning v
|
|
|
211
214
|
|
|
212
215
|
Render timeout in milliseconds. If an SSR render or RSC stream read does not complete within this duration, the render is aborted and the connection is closed. Protects against hung fetches and Suspense components that never resolve. Setting `0` uses a 120-second safety ceiling rather than disabling the timeout entirely. The same value bounds how long concurrent `timber.cache` callers wait on a shared fill, and how long static generation waits for each page.
|
|
213
216
|
|
|
214
|
-
### `
|
|
217
|
+
### `layoutDefaults`
|
|
218
|
+
|
|
219
|
+
Defaults for every layout, slot layouts included. Pages are unaffected. Layouts in and below an intercepting directory take neither default and stay `'request'`. See [Making layouts `'document'` by default](/docs/client-navigation#making-layouts-document-by-default).
|
|
220
|
+
|
|
221
|
+
#### `layoutDefaults.lifetime`
|
|
222
|
+
|
|
223
|
+
- **Type:** `'request' | 'document'`
|
|
224
|
+
- **Default:** `'request'`
|
|
225
|
+
|
|
226
|
+
The lifetime of every layout that does not declare one. A layout's own `layoutOptions.lifetime` wins. Under `'document'`, a layout that reads a request input outside its key is reported (the dev overlay, or a warning in production) and renders as `'request'`, one that shows data that changes during a visit keeps its load-time value, and one that hides its children in its body no longer keeps them out of the payload.
|
|
227
|
+
|
|
228
|
+
#### `layoutDefaults.key.headers`
|
|
229
|
+
|
|
230
|
+
- **Type:** `readonly string[]`
|
|
231
|
+
- **Default:** none
|
|
215
232
|
|
|
216
|
-
The
|
|
233
|
+
The `key.headers` of every `'document'` layout whose key does not list `headers`, whether the layout declares `'document'` or takes it from `layoutDefaults.lifetime`. Those layouts may read these headers, and render again when one changes. A layout that declares `key.headers` replaces this list. `cookie`, credential headers (`authorization`, `proxy-authorization`, `x-api-key`) and invalid header names stop the server from starting.
|
|
217
234
|
|
|
218
235
|
### `devBrowserLogs`
|
|
219
236
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@timber-js/app",
|
|
3
|
-
"version": "0.2.0-alpha.
|
|
3
|
+
"version": "0.2.0-alpha.244",
|
|
4
4
|
"description": "Vite-native React framework built for Servers and Serverless Platforms — correct HTTP semantics, real status codes, pages that work without JavaScript",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cloudflare-workers",
|
package/src/cli-check.ts
CHANGED
|
@@ -37,7 +37,7 @@ import { scanRoutes } from './routing/scanner.ts';
|
|
|
37
37
|
import { lintConventions, formatConventionWarnings } from './routing/convention-lint.ts';
|
|
38
38
|
import { writeRouteCodegen, CODEGEN_OUTPUT, ENV_DTS_FILENAME } from './routing/codegen-write.ts';
|
|
39
39
|
import { resolveTimberContext, type ResolveViteConfig } from './cli-context.ts';
|
|
40
|
-
import type {
|
|
40
|
+
import type { LayoutDefaults } from './config-types.ts';
|
|
41
41
|
|
|
42
42
|
/** The npm package that provides tsgo. Named in the missing-tool message. */
|
|
43
43
|
const TSGO_PACKAGE = '@typescript/native-preview';
|
|
@@ -143,8 +143,8 @@ export interface RouteInputs {
|
|
|
143
143
|
root: string;
|
|
144
144
|
appDir: string;
|
|
145
145
|
pageExtensions: string[] | undefined;
|
|
146
|
-
/** Read by the route-options lint (design/53 §"App-wide
|
|
147
|
-
|
|
146
|
+
/** Read by the route-options lint (design/53 §"App-wide defaults"). */
|
|
147
|
+
layoutDefaults: LayoutDefaults | undefined;
|
|
148
148
|
}
|
|
149
149
|
|
|
150
150
|
/**
|
|
@@ -164,7 +164,7 @@ export async function resolveRouteInputs(
|
|
|
164
164
|
root: ctx.root,
|
|
165
165
|
appDir: ctx.appDir,
|
|
166
166
|
pageExtensions: ctx.config.pageExtensions,
|
|
167
|
-
|
|
167
|
+
layoutDefaults: ctx.config.layoutDefaults,
|
|
168
168
|
};
|
|
169
169
|
}
|
|
170
170
|
|
|
@@ -184,11 +184,11 @@ export async function checkRoutes(
|
|
|
184
184
|
deps: CheckDeps = {}
|
|
185
185
|
): Promise<RouteInputs> {
|
|
186
186
|
const inputs = await resolveRouteInputs(options, deps);
|
|
187
|
-
const { root, appDir, pageExtensions,
|
|
187
|
+
const { root, appDir, pageExtensions, layoutDefaults } = inputs;
|
|
188
188
|
|
|
189
189
|
const tree = scanRoutes(appDir, { pageExtensions });
|
|
190
190
|
|
|
191
|
-
const warnings = lintConventions(tree, appDir, {
|
|
191
|
+
const warnings = lintConventions(tree, appDir, { layoutDefaults });
|
|
192
192
|
const fatal = warnings.filter((w) => w.level === 'error');
|
|
193
193
|
if (fatal.length > 0) {
|
|
194
194
|
throw new Error(formatConventionWarnings(fatal, { color: false }));
|
package/src/config-types.ts
CHANGED
|
@@ -18,6 +18,47 @@ export interface ClientJavascriptConfig {
|
|
|
18
18
|
enableHMRInDev?: boolean;
|
|
19
19
|
}
|
|
20
20
|
|
|
21
|
+
/**
|
|
22
|
+
* What every layout takes when it does not declare its own (`layoutDefaults`).
|
|
23
|
+
* An explicit subset of `LayoutOptions`: options that already apply app-wide
|
|
24
|
+
* from a root layout (`prerender`, `deferSuspenseFor`) are not here.
|
|
25
|
+
*/
|
|
26
|
+
export interface LayoutDefaults {
|
|
27
|
+
/**
|
|
28
|
+
* The lifetime of every layout that does not declare one. A layout's own
|
|
29
|
+
* `layoutOptions.lifetime` wins.
|
|
30
|
+
*
|
|
31
|
+
* `'document'` renders each layout on the document request and skips it on
|
|
32
|
+
* client navigations until its key changes. Every `'document'` rule
|
|
33
|
+
* applies: the default key is every param on the layout's path (plus
|
|
34
|
+
* `key.headers` below), and the layout may read only the request inputs in
|
|
35
|
+
* its key. Check three things before turning it on: a layout that reads
|
|
36
|
+
* anything else (a header, a cookie outside its key) is reported (the dev
|
|
37
|
+
* overlay, or a warning) and renders as `'request'` for that visitor; a
|
|
38
|
+
* layout that shows data that changes during a visit (a cart badge) keeps
|
|
39
|
+
* the value it had at load; and a layout that hides its children in its
|
|
40
|
+
* body no longer keeps them out of the payload, since a skip never runs it.
|
|
41
|
+
* Declare `layoutOptions = { lifetime: 'request' }` on those, and gate in
|
|
42
|
+
* `access.ts`. Layouts in and below an intercepting directory take no
|
|
43
|
+
* options and no defaults, and stay `'request'`.
|
|
44
|
+
*
|
|
45
|
+
* Default: `'request'`.
|
|
46
|
+
*/
|
|
47
|
+
lifetime?: SegmentLifetime;
|
|
48
|
+
key?: {
|
|
49
|
+
/**
|
|
50
|
+
* The `key.headers` of every `'document'` layout whose key does not
|
|
51
|
+
* declare `headers` — declared `'document'` or defaulted. A layout that
|
|
52
|
+
* declares `key.headers` replaces this list rather than adding to it.
|
|
53
|
+
* Each header in it makes those layouts re-render when its value changes,
|
|
54
|
+
* so name headers that are stable across a visit (`user-agent`). The
|
|
55
|
+
* same names are refused as in a layout's own key: `cookie`, credential
|
|
56
|
+
* headers and invalid names stop startup.
|
|
57
|
+
*/
|
|
58
|
+
headers?: readonly string[];
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
21
62
|
export interface TimberUserConfig {
|
|
22
63
|
output?: 'server' | 'static';
|
|
23
64
|
/**
|
|
@@ -329,29 +370,10 @@ export interface TimberUserConfig {
|
|
|
329
370
|
*/
|
|
330
371
|
buildDir?: string;
|
|
331
372
|
/**
|
|
332
|
-
*
|
|
333
|
-
*
|
|
334
|
-
* `layoutOptions.lifetime` wins.
|
|
335
|
-
*
|
|
336
|
-
* `'document'` renders each layout on the document request and skips it on
|
|
337
|
-
* client navigations until its key changes. Every `'document'` rule
|
|
338
|
-
* applies: the default key is every param on the layout's path, and the
|
|
339
|
-
* layout may read only the request inputs in its key. Check three things
|
|
340
|
-
* before turning it on: a layout that reads anything else (a header, a
|
|
341
|
-
* cookie outside its key) is reported (the dev overlay, or a warning) and
|
|
342
|
-
* renders as `'request'` for that visitor; a layout that shows data that changes
|
|
343
|
-
* during a visit (a cart badge) keeps the value it had at load; and a layout
|
|
344
|
-
* that hides its children in its body no longer keeps them out of the
|
|
345
|
-
* payload, since a skip never runs it. Declare
|
|
346
|
-
* `layoutOptions = { lifetime: 'request' }` on those, and gate in
|
|
347
|
-
* `access.ts`. Layouts in and below an intercepting directory take no
|
|
348
|
-
* options and stay `'request'`.
|
|
349
|
-
*
|
|
350
|
-
* Default: `'request'`.
|
|
351
|
-
*
|
|
352
|
-
* See design/53-segment-lifetime.md §"App-wide default".
|
|
373
|
+
* Defaults for every layout, slot layouts included. Pages are unaffected.
|
|
374
|
+
* See `LayoutDefaults` and design/53-segment-lifetime.md §"App-wide defaults".
|
|
353
375
|
*/
|
|
354
|
-
|
|
376
|
+
layoutDefaults?: LayoutDefaults;
|
|
355
377
|
/**
|
|
356
378
|
* Cache behavior configuration.
|
|
357
379
|
*/
|
package/src/config-validation.ts
CHANGED
|
@@ -9,8 +9,9 @@
|
|
|
9
9
|
*/
|
|
10
10
|
|
|
11
11
|
import { createRequire } from 'node:module';
|
|
12
|
-
import type { TimberUserConfig } from './config-types.ts';
|
|
12
|
+
import type { LayoutDefaults, TimberUserConfig } from './config-types.ts';
|
|
13
13
|
import { devHostnameError } from './plugins/dev-hostname.ts';
|
|
14
|
+
import { headerKeyProblem, isHeaderList } from './shared/key-headers.ts';
|
|
14
15
|
import { DEFAULT_RENDER_TIMEOUT_MS, RENDER_TIMEOUT_CEILING_MS } from './server/render-timeout.ts';
|
|
15
16
|
|
|
16
17
|
// ─── Types ──────────────────────────────────────────────────────────────────
|
|
@@ -56,7 +57,7 @@ const KNOWN_CONFIG_KEYS = {
|
|
|
56
57
|
sitemap: true,
|
|
57
58
|
buildDir: true,
|
|
58
59
|
cache: true,
|
|
59
|
-
|
|
60
|
+
layoutDefaults: true,
|
|
60
61
|
topLoader: true,
|
|
61
62
|
budget: true,
|
|
62
63
|
} satisfies Record<keyof TimberUserConfig, true>;
|
|
@@ -193,21 +194,8 @@ export function validateConfig(config: TimberUserConfig): ConfigError[] {
|
|
|
193
194
|
}
|
|
194
195
|
}
|
|
195
196
|
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
// (design/53 §"App-wide default").
|
|
199
|
-
if (
|
|
200
|
-
config.defaultLayoutLifetime !== undefined &&
|
|
201
|
-
config.defaultLayoutLifetime !== 'request' &&
|
|
202
|
-
config.defaultLayoutLifetime !== 'document'
|
|
203
|
-
) {
|
|
204
|
-
errors.push({
|
|
205
|
-
field: 'defaultLayoutLifetime',
|
|
206
|
-
message: `Invalid defaultLayoutLifetime value: ${JSON.stringify(config.defaultLayoutLifetime)}.`,
|
|
207
|
-
value: config.defaultLayoutLifetime,
|
|
208
|
-
suggestion: "Use 'request' (the default) or 'document'.",
|
|
209
|
-
});
|
|
210
|
-
}
|
|
197
|
+
if (config.layoutDefaults !== undefined)
|
|
198
|
+
errors.push(...layoutDefaultsErrors(config.layoutDefaults));
|
|
211
199
|
|
|
212
200
|
// devBrowserLogs
|
|
213
201
|
if (config.devBrowserLogs !== undefined) {
|
|
@@ -308,15 +296,23 @@ export function validateConfig(config: TimberUserConfig): ConfigError[] {
|
|
|
308
296
|
}
|
|
309
297
|
|
|
310
298
|
const MOVED_TO_CACHE_FILE = new Set(['cacheHandler', 'cdnPurge']);
|
|
299
|
+
// Removed, not aliased (design/53 §"App-wide defaults"); without this hint
|
|
300
|
+
// every layout would silently fall back to 'request'.
|
|
301
|
+
const REPLACED: Record<string, string> = {
|
|
302
|
+
defaultLayoutLifetime:
|
|
303
|
+
'"defaultLayoutLifetime" was replaced by layoutDefaults: use layoutDefaults: { lifetime: \'document\' }.',
|
|
304
|
+
};
|
|
311
305
|
|
|
312
306
|
for (const key of Object.keys(config)) {
|
|
313
307
|
if (!knownKeys.has(key)) {
|
|
314
308
|
errors.push({
|
|
315
309
|
field: key,
|
|
316
310
|
message: `Unknown config option: "${key}".`,
|
|
317
|
-
suggestion:
|
|
318
|
-
?
|
|
319
|
-
:
|
|
311
|
+
suggestion: Object.hasOwn(REPLACED, key)
|
|
312
|
+
? REPLACED[key]
|
|
313
|
+
: MOVED_TO_CACHE_FILE.has(key)
|
|
314
|
+
? `"${key}" has moved to timber.cache.ts. Export cacheHandler as default, cdnPurge as a named export.`
|
|
315
|
+
: `Check for typos. Known options: ${[...knownKeys].sort().join(', ')}.`,
|
|
320
316
|
});
|
|
321
317
|
}
|
|
322
318
|
}
|
|
@@ -532,3 +528,83 @@ export function formatMissingPeers(results: PeerDepResult[]): string {
|
|
|
532
528
|
|
|
533
529
|
return lines.join('\n');
|
|
534
530
|
}
|
|
531
|
+
|
|
532
|
+
// Drift-proof, like KNOWN_CONFIG_KEYS: a field added to `LayoutDefaults`
|
|
533
|
+
// without listing it here is a compile error, not an "unknown option" warning.
|
|
534
|
+
const LAYOUT_DEFAULTS_KEYS = { lifetime: true, key: true } satisfies Record<
|
|
535
|
+
keyof LayoutDefaults,
|
|
536
|
+
true
|
|
537
|
+
>;
|
|
538
|
+
const LAYOUT_DEFAULTS_KEY_PARTS = { headers: true } satisfies Record<
|
|
539
|
+
keyof NonNullable<LayoutDefaults['key']>,
|
|
540
|
+
true
|
|
541
|
+
>;
|
|
542
|
+
|
|
543
|
+
/**
|
|
544
|
+
* `layoutDefaults` (design/53 §"App-wide defaults"). A malformed shape is not
|
|
545
|
+
* fatal: `resolveLayoutDefaults` reads it as no default, which is slower but
|
|
546
|
+
* never wrong. A header the key may not name is: it would make a credential
|
|
547
|
+
* keyable, and readable, in every defaulted layout.
|
|
548
|
+
*/
|
|
549
|
+
function layoutDefaultsErrors(defaults: unknown): ConfigError[] {
|
|
550
|
+
const field = 'layoutDefaults';
|
|
551
|
+
if (typeof defaults !== 'object' || defaults === null || Array.isArray(defaults)) {
|
|
552
|
+
return [{ field, message: 'layoutDefaults must be an object.', value: defaults }];
|
|
553
|
+
}
|
|
554
|
+
const errors: ConfigError[] = [];
|
|
555
|
+
for (const name of Object.keys(defaults)) {
|
|
556
|
+
if (!Object.hasOwn(LAYOUT_DEFAULTS_KEYS, name)) {
|
|
557
|
+
errors.push({
|
|
558
|
+
field: `${field}.${name}`,
|
|
559
|
+
message: `Unknown layoutDefaults option: ${name}.`,
|
|
560
|
+
suggestion:
|
|
561
|
+
'layoutDefaults takes lifetime and key.headers. prerender and deferSuspenseFor ' +
|
|
562
|
+
'already apply app-wide from the root layout.',
|
|
563
|
+
});
|
|
564
|
+
}
|
|
565
|
+
}
|
|
566
|
+
const lifetime = 'lifetime' in defaults ? defaults.lifetime : undefined;
|
|
567
|
+
if (lifetime !== undefined && lifetime !== 'request' && lifetime !== 'document') {
|
|
568
|
+
errors.push({
|
|
569
|
+
field: `${field}.lifetime`,
|
|
570
|
+
message: `Invalid layoutDefaults.lifetime value: ${JSON.stringify(lifetime)}.`,
|
|
571
|
+
value: lifetime,
|
|
572
|
+
suggestion: "Use 'request' (the default) or 'document'.",
|
|
573
|
+
});
|
|
574
|
+
}
|
|
575
|
+
const key = 'key' in defaults ? defaults.key : undefined;
|
|
576
|
+
if (key === undefined) return errors;
|
|
577
|
+
if (typeof key !== 'object' || key === null || Array.isArray(key)) {
|
|
578
|
+
return [...errors, { field: `${field}.key`, message: 'layoutDefaults.key must be an object.' }];
|
|
579
|
+
}
|
|
580
|
+
for (const name of Object.keys(key)) {
|
|
581
|
+
if (!Object.hasOwn(LAYOUT_DEFAULTS_KEY_PARTS, name)) {
|
|
582
|
+
errors.push({
|
|
583
|
+
field: `${field}.key.${name}`,
|
|
584
|
+
message: `layoutDefaults.key takes only headers, not ${name}.`,
|
|
585
|
+
suggestion:
|
|
586
|
+
'Params default per path, and cookie or search-param keys belong on the layout ' +
|
|
587
|
+
'that reads them.',
|
|
588
|
+
});
|
|
589
|
+
}
|
|
590
|
+
}
|
|
591
|
+
const headers = 'headers' in key ? key.headers : undefined;
|
|
592
|
+
if (headers === undefined) return errors;
|
|
593
|
+
if (!isHeaderList(headers)) {
|
|
594
|
+
return [
|
|
595
|
+
...errors,
|
|
596
|
+
{
|
|
597
|
+
field: `${field}.key.headers`,
|
|
598
|
+
message: 'layoutDefaults.key.headers must be an array of header names.',
|
|
599
|
+
value: headers,
|
|
600
|
+
},
|
|
601
|
+
];
|
|
602
|
+
}
|
|
603
|
+
for (const name of headers) {
|
|
604
|
+
const problem = headerKeyProblem(name);
|
|
605
|
+
if (problem) {
|
|
606
|
+
errors.push({ field: `${field}.key.headers`, message: problem, value: name, fatal: true });
|
|
607
|
+
}
|
|
608
|
+
}
|
|
609
|
+
return errors;
|
|
610
|
+
}
|
package/src/index.ts
CHANGED
|
@@ -70,7 +70,7 @@ import {
|
|
|
70
70
|
|
|
71
71
|
// ── Public API ────────────────────────────────────────────────────────────
|
|
72
72
|
|
|
73
|
-
export type { TimberUserConfig } from './config-types.ts';
|
|
73
|
+
export type { LayoutDefaults, TimberUserConfig } from './config-types.ts';
|
|
74
74
|
|
|
75
75
|
// Metadata route handler types — re-exported so user-authored metadata
|
|
76
76
|
// route files (sitemap.ts, robots.ts, manifest.ts, icon.tsx, etc.) can
|
package/src/plugins/entries.ts
CHANGED
|
@@ -164,9 +164,12 @@ function generateConfigModule(ctx: PluginContext): string {
|
|
|
164
164
|
// Per-build deployment ID for version skew detection (TIM-446).
|
|
165
165
|
// Null in dev mode — HMR handles code updates without full reloads.
|
|
166
166
|
deploymentId: ctx.deploymentId ?? null,
|
|
167
|
-
//
|
|
168
|
-
// (design/53 §"App-wide
|
|
169
|
-
|
|
167
|
+
// What a layout takes when it declares no lifetime, or a key without
|
|
168
|
+
// headers (design/53 §"App-wide defaults"). Written in its config shape:
|
|
169
|
+
// the RSC entry resolves it with `resolveLayoutDefaults`, the one reader
|
|
170
|
+
// of that shape. It reaches the browser bundle too (the browser entry
|
|
171
|
+
// imports this module whole); header names are not secret.
|
|
172
|
+
layoutDefaults: ctx.config.layoutDefaults ?? null,
|
|
170
173
|
cache: {
|
|
171
174
|
strictKeyDiscipline: ctx.config.cache?.strictKeyDiscipline ?? false,
|
|
172
175
|
},
|