tungsten 0.6.3 → 0.7.1

package/dist/components/bindable/bindableProps.types.test.js

@@ -0,0 +1,252 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+// checking disables to prevent noise - there are a few errors in here
+// @ts-nocheck
+import { BindableCheckbox } from "./BindableCheckbox.js";
+import { BindableInput } from "./BindableInput.js";
+import { BindableSelect } from "./BindableSelect.js";
+import { BindableTextarea } from "./BindableTextarea.js";
+import { TungstenSimpleComponent } from "../../Components.js";
+import { InputD } from "./bindableCandidates.comparison.js";
+// ---- BindableInput ---------------------------------------------------------
+// concrete objects are handled correctly today; the conditional only misbehaves under a generic
+import { jsx as _jsx, jsxs as _jsxs } from "tungsten/jsx-runtime";
+export const i1 = _jsx(BindableInput, {
+  bind: [wide, 'status']
+});
+// a raw string would be written into a narrow field. Property assignability is covariant, so
+// `('open' | 'closed') & string` is just `('open' | 'closed')` and the object still fits; closing
+// it needs a bind that puts the written type in a contravariant position.
+// @ts-expect-error -- unmet
+export const i2 = _jsx(BindableInput, {
+  bind: [narrow, 'status']
+});
+// @ts-expect-error -- a number field is a different type, not a narrower one, so this is still
+// caught: "bind?: BindWritableBy<{ n: number; }, "n", string>" ... "Type 'number' is not
+// assignable to type 'string'"
+export const i3 = _jsx(BindableInput, {
+  bind: [numeric, 'n']
+});
+export const i4 = _jsx(BindableInput, {
+  bind: [narrow, 'status'],
+  convert: v => v === 'open' ? 'open' : 'closed'
+});
+export const i5 = _jsx(BindableInput, {
+  bind: [numeric, 'n'],
+  convert: v => Number(v)
+});
+// @ts-expect-error -- the converter has to PRODUCE O[K], not pass the string through
+export const i6 = _jsx(BindableInput, {
+  bind: [narrow, 'status'],
+  convert: v => v
+});
+// @ts-expect-error -- not a key of the object
+export const i7 = _jsx(BindableInput, {
+  bind: [narrow, 'nope']
+});
+// Madras
+export const d1 = _jsx(InputD, {
+  bind: [wide, 'status']
+});
+// a raw string would be written into a narrow field. Property assignability is covariant, so
+// `('open' | 'closed') & string` is just `('open' | 'closed')` and the object still fits; closing
+// it needs a bind that puts the written type in a contravariant position.
+// @ts-expect-error -- unmet
+export const d2 = _jsx(InputD, {
+  bind: [narrow, 'status']
+});
+// @ts-expect-error -- a number field is a different type, not a narrower one: `number & string`
+// is never, so this is still caught
+export const d3 = _jsx(InputD, {
+  bind: [numeric, 'n']
+});
+export const d4 = _jsx(InputD, {
+  bind: [narrow, 'status'],
+  convert: v => v === 'open' ? 'open' : 'closed'
+});
+export const d5 = _jsx(InputD, {
+  bind: [numeric, 'n'],
+  convert: v => Number(v)
+});
+// @ts-expect-error -- the converter has to PRODUCE O[K], not pass the string through
+export const d6 = _jsx(InputD, {
+  bind: [narrow, 'status'],
+  convert: v => v
+});
+// @ts-expect-error -- not a key of the object
+export const d7 = _jsx(InputD, {
+  bind: [narrow, 'nope']
+});
+// ---- BindableTextarea ------------------------------------------------------
+export const t1 = _jsx(BindableTextarea, {
+  bind: [wide, 'status']
+});
+// @ts-expect-error -- unmet, as i2
+export const t2 = _jsx(BindableTextarea, {
+  bind: [narrow, 'status']
+});
+// @ts-expect-error -- as i3
+export const t3 = _jsx(BindableTextarea, {
+  bind: [numeric, 'n']
+});
+export const t4 = _jsx(BindableTextarea, {
+  bind: [narrow, 'status'],
+  convert: v => v === 'open' ? 'open' : 'closed'
+});
+export const t5 = _jsx(BindableTextarea, {
+  bind: [numeric, 'n'],
+  convert: v => Number(v)
+});
+// ---- BindableCheckbox ------------------------------------------------------
+export const c1 = _jsx(BindableCheckbox, {
+  bindChecked: [flag, 'done']
+});
+// `false` cannot be written to a key typed `true`. As i2 - `true & boolean` is `true`, so the
+// narrowing does not bite.
+// @ts-expect-error -- unmet
+export const c2 = _jsx(BindableCheckbox, {
+  bindChecked: [always, 'done']
+});
+// @ts-expect-error -- a boolean cannot be written to a string field
+export const c3 = _jsx(BindableCheckbox, {
+  bindChecked: [narrow, 'status']
+});
+export const c4 = _jsx(BindableCheckbox, {
+  bindChecked: [narrow, 'status'],
+  convert: v => v ? 'open' : 'closed'
+});
+// ---- BindableSelect --------------------------------------------------------
+// the unconverted select checks its option values against the field as far as disjointness goes:
+// two arms, one intersecting `${Value}` and one intersecting string, so a wide field passes on
+// the second and an unrelated field fails both. What neither arm reaches is an option the field
+// cannot hold (s5, s6) - `('open'|'closed') & string` is the narrow type, so the string arm waves
+// it through. That needs a real write demand, which stock TypeScript cannot spell.
+const statusOptions = [{
+  value: 'open',
+  text: 'Open'
+}, {
+  value: 'closed',
+  text: 'Closed'
+}];
+const numberOptions = [{
+  value: 1,
+  text: 'One'
+}, {
+  value: 2,
+  text: 'Two'
+}];
+export const s1 = _jsx(BindableSelect, {
+  bind: [wide, 'status'],
+  options: statusOptions
+});
+export const s2 = _jsx(BindableSelect, {
+  bind: [narrow, 'status'],
+  options: statusOptions
+});
+// numeric options into a numeric field need a converter, the DOM handing the value back as the
+// string "1" - this is the one that was writing "1" into a `1 | 2` field in qtc. Closed by the
+// two unconverted arms: a numeric field fails both, `number & ('1'|'2')` and `number & string`
+// @ts-expect-error
+export const s3 = _jsx(BindableSelect, {
+  bind: [numeric, 'n'],
+  options: numberOptions
+});
+// the NoInfer guard: without it Value takes a candidate from `options` (1 | 2) and another,
+// contravariantly, from the converter's `${Value}` parameter, and collapses to never - which made
+// a correctly converted numeric select unusable
+export const s4 = _jsx(BindableSelect, {
+  bind: [numeric, 'n'],
+  options: numberOptions,
+  convert: v => Number(v)
+});
+// an option value the bound field cannot hold
+// @ts-expect-error -- unmet
+export const s5 = _jsx(BindableSelect, {
+  bind: [narrow, 'status'],
+  options: [{
+    value: 'nope',
+    text: 'Nope'
+  }]
+});
+// map() widens the values to string before they reach the prop. Option objects written DIRECTLY
+// in the prop keep their literals and need no `as const`.
+const mapped = ['open', 'closed'].map(v => ({
+  value: v,
+  text: v
+}));
+// @ts-expect-error -- unmet
+export const s6 = _jsx(BindableSelect, {
+  bind: [narrow, 'status'],
+  options: mapped
+});
+// @ts-expect-error -- not a key of the object. The `{}` arm used to swallow this too, so the
+// select checked nothing whatsoever when no converter was given
+export const s7 = _jsx(BindableSelect, {
+  bind: [narrow, 'nope'],
+  options: statusOptions
+});
+// ---- intrinsics ------------------------------------------------------------
+// BO is `any` in TungstenIntrinsicElements, so an intrinsic bind is typed but unchecked. `input`
+// was the one bindable element whose intrinsic form did not typecheck at all - its bind lines
+// were commented out where select and textarea declare theirs.
+export const x1 = _jsx("input", {
+  bind: [wide, 'status']
+});
+export const x2 = _jsx("select", {
+  bind: [wide, 'status']
+});
+export const x3 = _jsx("textarea", {
+  bind: [wide, 'status']
+});
+// ---- the generic cases, which are the point ---------------------------------
+// a conditional on a type parameter stays deferred, and a value satisfies a deferred conditional
+// only by satisfying BOTH branches - so a convert is demanded that nothing but a cast can supply
+// the object generic, passing its own bind straight through - no convert, no cast
+export class FieldO extends TungstenSimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => {
+      const input = _jsx(BindableInput, {
+        bind: this.props.bind
+      });
+      const area = _jsx(BindableTextarea, {
+        bind: this.props.bind
+      });
+      return _jsxs("label", {
+        children: [input, area]
+      });
+    });
+  }
+}
+// both generic. A conditional rewritten as a write test passes FieldO and still fails this one,
+// so this is what catches a half-fix.
+export class FieldOK extends TungstenSimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => {
+      const input = _jsx(BindableInput, {
+        bind: this.props.bind
+      });
+      return _jsx("label", {
+        children: input
+      });
+    });
+  }
+}
+// correct as it stands, and the case most easily deleted while making the two above pass:
+// without it, "the generic case works" can mean we have simply stopped checking
+export class FieldAny extends TungstenSimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => {
+      // @ts-expect-error -- O[K] is unconstrained, so a string write cannot be justified
+      const input = _jsx(BindableInput, {
+        bind: this.props.bind
+      });
+      return _jsx("label", {
+        children: input
+      });
+    });
+  }
+}

package/dist/components/library/RichTextEditor/RichTextEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichTextEditor.d.ts","sourceRoot":"","sources":["../../../../src/components/library/RichTextEditor/RichTextEditor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EACR,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAC5G,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AA6BnE,QAAA,MAAM,eAAe,mIAGX,CAAA;AACV,KAAK,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAyCtD,KAAK,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,EAAE,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,IAAI;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IAGpB,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAGzC,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAOzC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC9B,CAAA;AAED,KAAK,KAAK,GAAG;IAUT,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IAGnC,WAAW,EAAE,MAAM,CAAA;IAGnB,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC/C,CAAA;AAED,qBAAa,cAAc,CACvB,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,EAAE,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,CAClG,SAAQ,yBAAyB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IACzE,KAAK,EAAE,KAAK,CAOX;IAED,UAAU,qEAAyC;IACnD,SAAS,0EAA8C;IAUvD,kBAAkB,aAWjB;IAOD,aAAa,QAAO,QAAQ,GAAG,IAAI,CACwD;IAiB3F,aAAa,aAMZ;IAOD,UAAU,EAAE,KAAK,GAAG,IAAI,CAAO;IAE/B,gBAAgB,aAWf;IAED,gBAAgB,aAKf;IAID,gBAAgB,aAGf;IAQD,kBAAkB,aAYjB;IAED,IAAI,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,UAStC;IASD,gBAAgB,GAAI,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,UAE/D;IAED,iBAAiB,GAAI,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,UAOjE;IAED,UAAU,aAMT;IAED,UAAU,aAA4B;IACtC,eAAe,aAAkC;IACjD,IAAI,aAA0B;IAC9B,IAAI,aAA0B;IAQ9B,aAAa,GAAI,OAAO,qBAAqB,CAAC,cAAc,CAAC,UAS5D;IAED,WAAW,GAAI,OAAO,sBAAsB,CAAC,cAAc,CAAC,UAS3D;IAED,YAAY,aAaX;IAED,iBAAiB,GAAI,OAAO,iBAAiB,CAAC,mBAAmB,CAAC,UAEjE;IAED,OAAO,GAAI,kCAAkC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,0DAyElF;IAEV,KAAK,0CA8FJ;CACJ"}
+{"version":3,"file":"RichTextEditor.d.ts","sourceRoot":"","sources":["../../../../src/components/library/RichTextEditor/RichTextEditor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EACR,mBAAmB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,qBAAqB,EACrF,kBAAkB,EACrB,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAA;AA6BnE,QAAA,MAAM,eAAe,mIAGX,CAAA;AACV,KAAK,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAyCtD,KAAK,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,EAAE,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,IAAI;IAC3G,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IAGpB,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAGzC,QAAQ,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAOzC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC9B,CAAA;AAED,KAAK,KAAK,GAAG;IAUT,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IAGnC,WAAW,EAAE,MAAM,CAAA;IAGnB,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAC/C,CAAA;AAED,qBAAa,cAAc,CACvB,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,EAAE,KAAK,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,KAAK,CAClG,SAAQ,yBAAyB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IACzE,KAAK,EAAE,KAAK,CAOX;IAED,UAAU,qEAAyC;IACnD,SAAS,0EAA8C;IAUvD,kBAAkB,aAWjB;IAOD,aAAa,QAAO,QAAQ,GAAG,IAAI,CACwD;IAiB3F,aAAa,aAMZ;IAOD,UAAU,EAAE,KAAK,GAAG,IAAI,CAAO;IAE/B,gBAAgB,aAWf;IAED,gBAAgB,aAKf;IAID,gBAAgB,aAGf;IAQD,kBAAkB,aAYjB;IAED,IAAI,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,UAStC;IASD,gBAAgB,GAAI,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,UAE/D;IAED,iBAAiB,GAAI,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,UAOjE;IAED,UAAU,aAMT;IAED,UAAU,aAA4B;IACtC,eAAe,aAAkC;IACjD,IAAI,aAA0B;IAC9B,IAAI,aAA0B;IAQ9B,aAAa,GAAI,OAAO,qBAAqB,CAAC,cAAc,CAAC,UAS5D;IAED,WAAW,GAAI,OAAO,sBAAsB,CAAC,cAAc,CAAC,UAS3D;IAED,YAAY,aAaX;IAED,iBAAiB,GAAI,OAAO,iBAAiB,CAAC,mBAAmB,CAAC,UAEjE;IAED,OAAO,GAAI,kCAAkC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,0DAyElF;IAEV,KAAK,0CA8FJ;CACJ"}

package/dist/components/library/RichTextEditor/contentTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contentTree.d.ts","sourceRoot":"","sources":["../../../../src/components/library/RichTextEditor/contentTree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,yBAAyB,CAAA;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAS/D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAgBzE;AA6BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,iBAAiB,EAAE,SAAS,GAAE,aAAiC,GACxE,WAAW,CAEb"}
+{"version":3,"file":"contentTree.d.ts","sourceRoot":"","sources":["../../../../src/components/library/RichTextEditor/contentTree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,yBAAyB,CAAA;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAU/D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAgBzE;AA6BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,iBAAiB,EAAE,SAAS,GAAE,aAAiC,GACxE,WAAW,CAEb"}

package/dist/components/makeTypedLink.d.ts

@@ -0,0 +1,9 @@
+import type { RoutePaths } from '../routing/RoutePaths.js';
+import type { Path } from '../routing/RouteTypes.js';
+import { Link } from './Link.jsx';
+type LinkName = `${Uppercase<string>}${string}`;
+export type AppPath<R> = Extract<RoutePaths<R>, Path>;
+type RoutesCheck<R> = [R] extends [never] ? [error: 'give the routes: makeTypedLink(name)<typeof routes>()'] : [AppPath<R>] extends [never] ? [error: 'these routes have no paths - were the paths given, not the routes?'] : [];
+export declare function makeTypedLink<const Name extends LinkName>(name: Name): <R extends object = never>(..._: RoutesCheck<R>) => { [K in Name]: typeof Link<AppPath<R>>; };
+export {};
+//# sourceMappingURL=makeTypedLink.d.ts.map

package/dist/components/makeTypedLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeTypedLink.d.ts","sourceRoot":"","sources":["../../src/components/makeTypedLink.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAIjC,KAAK,QAAQ,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAA;AAG/C,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;AAGrD,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACnC,CAAC,KAAK,EAAE,uDAAuD,CAAC,GAChE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GACxB,CAAC,KAAK,EAAE,oEAAoE,CAAC,GAC7E,EAAE,CAAA;AAIZ,wBAAgB,aAAa,CAAC,KAAK,CAAC,IAAI,SAAS,QAAQ,EAAE,IAAI,EAAE,IAAI,IACzD,CAAC,SAAS,MAAM,GAAG,KAAK,EAAE,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,KAAG,GAAG,CAAC,IAAI,IAAI,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAE,CAMpG"}

package/dist/components/makeTypedLink.js

@@ -0,0 +1,15 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { Link } from "./Link.js";
+// const { Link } = makeTypedLink('Link')<typeof routes>(): curried so the name is inferred and the routes
+// explicit. The name is the only key, so the binding matches the stylesheet selector (docs/dev-notes.md)
+export function makeTypedLink(name) {
+  return (..._) => {
+    class TypedLink extends Link {}
+    _defineProperty(TypedLink, "tagName", name);
+    return {
+      [name]: TypedLink
+    }; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+  };
+}

package/dist/context/registerContext.d.ts

@@ -0,0 +1,22 @@
+import type { AsContext } from '../Brands.js';
+import type { ReqRes } from '../ReqRes.js';
+import type { Fixed } from '../routing/registrationTypes.js';
+export interface Context {
+}
+export type ContextClass = new (reqRes: ReqRes | null) => object;
+export type ContextClasses = {
+    client: new () => object;
+    server: new (reqRes: ReqRes) => object;
+};
+export declare const contextRegistration: {
+    value: ContextClass | ContextClasses | undefined;
+};
+export declare function registerContext<C extends object>(context: (new (reqRes: ReqRes | null) => C) | {
+    client: new () => C;
+    server: new (reqRes: ReqRes) => C;
+}): Fixed<{
+    context: C;
+}>;
+export declare function createContext(side: 'client', reqRes: null): AsContext<Context>;
+export declare function createContext(side: 'server', reqRes: ReqRes): AsContext<Context>;
+//# sourceMappingURL=registerContext.d.ts.map

package/dist/context/registerContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerContext.d.ts","sourceRoot":"","sources":["../../src/context/registerContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAA;AAO5D,MAAM,WAAW,OAAO;CAAG;AAG3B,MAAM,MAAM,YAAY,GAAG,KAAK,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAA;AAEhE,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,UAAU,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,CAAA;AAEjG,eAAO,MAAM,mBAAmB,EAAE;IAAE,KAAK,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAAA;CAAyB,CAAA;AAM7G,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC5C,OAAO,EAAE,CAAC,KAAK,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,CAAC,CAAC,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,KAAK,CAAC,CAAA;CAAE,GACzG,KAAK,CAAC;IAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,CAIvB;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;AAC/E,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA"}

package/dist/context/registerContext.js

@@ -0,0 +1,18 @@
+export const contextRegistration = {
+  value: undefined
+};
+// a context is made per request on the server, and once per page on the client (hydrate). Returns a
+// type-only token the app augments Context from - `ContextType<typeof registration>` - so the
+// augmentation follows the class actually registered. Also set by registerRouting() and the
+// routing builder - the last registration wins
+export function registerContext(context) {
+  contextRegistration.value = context;
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- the token is type-only
+  return undefined;
+}
+export function createContext(side, reqRes) {
+  const registered = contextRegistration.value;
+  if (registered === undefined) return {};
+  const made = typeof registered === 'function' ? new registered(reqRes) : side === 'server' && reqRes !== null ? new registered.server(reqRes) : new registered.client();
+  return made;
+}

package/dist/env/getEnvSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getEnvSchemas.d.ts","sourceRoot":"","sources":["../../src/env/getEnvSchemas.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EAC2C,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAC5F,MAAM,yBAAyB,CAAA;AAQhC,MAAM,MAAM,UAAU,GAAG;IACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC,CAAA;AAKD,wBAAsB,aAAa,CAC/B,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,MAAM,GACzF,OAAO,CAAC,UAAU,CAAC,CAAA;AACtB,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GACjG,OAAO,CAAC,UAAU,CAAC,CAAA;AA6DrB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,uBAG5G"}
+{"version":3,"file":"getEnvSchemas.d.ts","sourceRoot":"","sources":["../../src/env/getEnvSchemas.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EACH,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAE9C,MAAM,yBAAyB,CAAA;AAShC,MAAM,MAAM,UAAU,GAAG;IACrB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC,CAAA;AAKD,wBAAsB,aAAa,CAC/B,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,MAAM,GACzF,OAAO,CAAC,UAAU,CAAC,CAAA;AACtB,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GACjG,OAAO,CAAC,UAAU,CAAC,CAAA;AA6DrB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,uBAG5G"}

package/dist/env/getEnvSchemas.js

@@ -5,6 +5,7 @@ import { devBuildFolder, prodBuildCodeFolder } from '../settings.js';
 import { throwError } from '../throwError.js';
 import { iterationQueryString } from '../iterationQueryString.js';
 import { importDevModuleWithRetry } from '../importDevModuleWithRetry.js';
+import { importModule } from '../importModule.js';
 export async function getEnvSchemas(config, iteration = null, mode = 'prod',
 // a compiled tree other than the mode's own - a test run's `compile --output`
 buildCodeFolderOverride) {
@@ -25,7 +26,7 @@ buildCodeFolderOverride) {
   let module;
   try {
     module = mode === 'dev' ? await importDevModuleWithRetry(iterationQueryString(fullFilePath, iteration)) // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- checked above
-    : await import(fullFilePath);
+    : await importModule(fullFilePath);
   } catch (e) {
     throwError('getEnvSchemas()', `Error loading env schemas file` + `\n${e}` + `\nExpected to find a file with env schemas at ${envSchemasLocation}` + `\nThis location is set with the envSchemasLocations setting in tungsten.config.js`);
   }

package/dist/fileVersions.d.ts

@@ -0,0 +1,9 @@
+import type { Instance } from './Instance/Instance.js';
+export type VersionSource = {
+    config: Pick<Instance['config'], 'siteBasePath'>;
+    fileVersions?: Instance['fileVersions'];
+};
+export declare function versionUrl(url: string, source: VersionSource | undefined): string;
+export declare function fileUrl(path: `/${string}`, source: VersionSource): string;
+export declare function versionAttributes<Attributes extends Record<string, unknown>>(attributes: Attributes, source: VersionSource | undefined): Attributes;
+//# sourceMappingURL=fileVersions.d.ts.map

package/dist/fileVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileVersions.d.ts","sourceRoot":"","sources":["../src/fileVersions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAMtD,MAAM,MAAM,aAAa,GAAG;IACxB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAA;IAChD,YAAY,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAA;CAC1C,CAAA;AAID,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAOjF;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,MAAM,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAEzE;AAUD,wBAAgB,iBAAiB,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,GAC1D,UAAU,CASZ"}

package/dist/fileVersions.js

@@ -0,0 +1,28 @@
+const urlAttributes = new Set(['src', 'href', 'poster']);
+export function versionUrl(url, source) {
+  if (source?.fileVersions === undefined || url.includes('?') || url.includes('#')) return url;
+  const versions = source.fileVersions;
+  const base = source.config.siteBasePath.replace(/\/$/, '');
+  if (!url.startsWith(base + '/')) return url;
+  const path = url.slice(base.length);
+  return Object.hasOwn(versions, path) ? `${url}?v=${versions[path]}` : url;
+}
+export function fileUrl(path, source) {
+  return versionUrl(source.config.siteBasePath.replace(/\/$/, '') + path, source);
+}
+// each candidate is "url [descriptor]"
+function versionSrcset(srcset, source) {
+  return srcset.split(',').map(candidate => {
+    const [url, ...descriptor] = candidate.trim().split(/\s+/);
+    return [versionUrl(url ?? '', source), ...descriptor].join(' ');
+  }).join(', ');
+}
+export function versionAttributes(attributes, source) {
+  if (source?.fileVersions === undefined) return attributes;
+  for (const [name, value] of Object.entries(attributes)) {
+    if (typeof value !== 'string') continue;
+    const lower = name.toLowerCase();
+    if (urlAttributes.has(lower)) attributes[name] = versionUrl(value, source);else if (lower === 'srcset') attributes[name] = versionSrcset(value, source);
+  }
+  return attributes;
+}

package/dist/findUserConfig.d.ts

@@ -1,5 +1,5 @@
 export declare function findUserConfig(projectDir: string, volume?: 'silent' | 'noisy'): Promise<{
-    data: any;
+    data: unknown;
     moduleType: "module" | "commonjs";
     location: string;
 } | null>;

package/dist/findUserConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findUserConfig.d.ts","sourceRoot":"","sources":["../src/findUserConfig.ts"],"names":[],"mappings":"AAcA,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,GAAG,OAAiB;;;;UAsE5F"}
+{"version":3,"file":"findUserConfig.d.ts","sourceRoot":"","sources":["../src/findUserConfig.ts"],"names":[],"mappings":"AAeA,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,GAAG,OAAiB;;;;UAsE5F"}

package/dist/findUserConfig.js

@@ -5,6 +5,7 @@ import { configName } from './packageSettings.js';
 import { cliNote, cliWarn } from './cliOutput.js';
 import { TungstenError } from './TungstenError.js';
 import { packageNameCapitalized } from './settings.js';
+import { importModule } from './importModule.js';
 //import { throwError } from './throwError.js' 
 export async function findUserConfig(projectDir, volume = 'noisy') {
   const packageConfig = await loadPackageDotJsonFromDir(projectDir); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
@@ -15,7 +16,7 @@ export async function findUserConfig(projectDir, volume = 'noisy') {
   async function foundConfig(type, location) {
     //const [configType, configLocation] = configInfo
     if (volume !== 'silent') cliNote(`${packageNameCapitalized} using user config at ${location}`);
-    const config = (await import('file://' + location)).default;
+    const config = (await importModule('file://' + location)).default;
     return {
       data: config,
       moduleType: type,

package/dist/frameworkConfigSchema.d.ts

@@ -17,7 +17,7 @@ export declare const frameworkConfigValidator: v.VariantSchema<"useRootComponent
     readonly siteBasePath: v.ExactOptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"", undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>], undefined>, v.TransformAction<string, SiteBasePath>]>, undefined>;
     readonly clientSideNav: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly staticSite: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly routesLocation: v.ExactOptionalSchema<v.TupleSchema<[v.StringSchema<undefined>, v.StringSchema<undefined>], undefined>, undefined>;
+    readonly routesLocation: v.ExactOptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.TupleSchema<[v.StringSchema<undefined>, v.StringSchema<undefined>], undefined>], undefined>, undefined>;
     readonly envSchemasLocation: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly babelOptions: v.ExactOptionalSchema<v.SchemaWithPipe<readonly [v.LooseObjectSchema<{}, undefined>, v.TransformAction<{} & {
         [key: string]: unknown;
@@ -45,8 +45,16 @@ export declare const frameworkConfigValidator: v.VariantSchema<"useRootComponent
     readonly warnOnFrameworkChange: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly hmr: v.ExactOptionalSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.LiteralSchema<"reload", undefined>], undefined>, undefined>;
     readonly csr: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly serverSideRouting: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly defaultCacheControl: v.ExactOptionalSchema<v.UnionSchema<[v.PicklistSchema<["no-store", "private-check", "public-check"], undefined>, v.ObjectSchema<{
+        readonly privacy: v.PicklistSchema<["private", "public"], undefined>;
+        readonly maxAge: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly staleWhileRevalidate: v.ExactOptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    }, undefined>], undefined>, undefined>;
+    readonly registration: v.ExactOptionalSchema<v.PicklistSchema<["register", "pipeline"], undefined>, undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly useRootComponent: v.LiteralSchema<false, undefined>;
+    readonly serverSideRouting: v.ExactOptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     readonly codeDir: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly copy: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly copyExclude: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -58,7 +66,7 @@ export declare const frameworkConfigValidator: v.VariantSchema<"useRootComponent
     readonly siteBasePath: v.ExactOptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"", undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>]>], undefined>, v.TransformAction<string, SiteBasePath>]>, undefined>;
     readonly clientSideNav: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly staticSite: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
-    readonly routesLocation: v.ExactOptionalSchema<v.TupleSchema<[v.StringSchema<undefined>, v.StringSchema<undefined>], undefined>, undefined>;
+    readonly routesLocation: v.ExactOptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.TupleSchema<[v.StringSchema<undefined>, v.StringSchema<undefined>], undefined>], undefined>, undefined>;
     readonly envSchemasLocation: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly babelOptions: v.ExactOptionalSchema<v.SchemaWithPipe<readonly [v.LooseObjectSchema<{}, undefined>, v.TransformAction<{} & {
         [key: string]: unknown;
@@ -86,6 +94,12 @@ export declare const frameworkConfigValidator: v.VariantSchema<"useRootComponent
     readonly warnOnFrameworkChange: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly hmr: v.ExactOptionalSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.LiteralSchema<"reload", undefined>], undefined>, undefined>;
     readonly csr: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly defaultCacheControl: v.ExactOptionalSchema<v.UnionSchema<[v.PicklistSchema<["no-store", "private-check", "public-check"], undefined>, v.ObjectSchema<{
+        readonly privacy: v.PicklistSchema<["private", "public"], undefined>;
+        readonly maxAge: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+        readonly staleWhileRevalidate: v.ExactOptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
+    }, undefined>], undefined>, undefined>;
+    readonly registration: v.ExactOptionalSchema<v.PicklistSchema<["register", "pipeline"], undefined>, undefined>;
 }, undefined>], undefined>;
 export type FrameworkConfig = v.InferOutput<typeof frameworkConfigValidator>;
 export declare function unknownConfigKeys(config: unknown): string[];

package/dist/frameworkConfigSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frameworkConfigSchema.d.ts","sourceRoot":"","sources":["../src/frameworkConfigSchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGxE,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAKxD,MAAM,WAAW,YAAa,SAAQ,kBAAkB;CAAG;AA8E3D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGnC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAO5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAG3D"}
+{"version":3,"file":"frameworkConfigSchema.d.ts","sourceRoot":"","sources":["../src/frameworkConfigSchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGxE,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAKxD,MAAM,WAAW,YAAa,SAAQ,kBAAkB;CAAG;AA8F3D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGnC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAO5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAG3D"}

package/dist/frameworkConfigSchema.js

@@ -4,6 +4,12 @@ import * as v from 'valibot';
 // shape only - babel validates its own options, and a hand-copied key list just drifts from theirs
 const babelParserOptionsSchema = v.pipe(v.looseObject({}), v.transform(options => options));
 const stringOrStrings = v.union([v.string(), v.array(v.string())]);
+const seconds = v.pipe(v.number(), v.integer(), v.minValue(0));
+const cacheControlSchema = v.union([v.picklist(['no-store', 'private-check', 'public-check']), v.object({
+  privacy: v.picklist(['private', 'public']),
+  maxAge: seconds,
+  staleWhileRevalidate: v.exactOptional(seconds)
+})]);
 const frameworkConfigBaseEntries = {
   codeDir: v.exactOptional(v.string()),
   copy: v.exactOptional(v.string()),
@@ -22,7 +28,8 @@ const frameworkConfigBaseEntries = {
   staticSite: v.exactOptional(v.boolean()),
   // not ready // uniqueComponents?: boolean
   // not ready // bindMode?: BindMode
-  routesLocation: v.exactOptional(v.tuple([v.string(), v.string()])),
+  // the file alone when routes come from registerRouting(), else [file, exportName]
+  routesLocation: v.exactOptional(v.union([v.string(), v.tuple([v.string(), v.string()])])),
   envSchemasLocation: v.exactOptional(v.string()),
   babelOptions: v.exactOptional(babelParserOptionsSchema),
   packageSystem: v.exactOptional(v.picklist(['rewrites', 'aliases'])),
@@ -54,7 +61,10 @@ const frameworkConfigBaseEntries = {
   // accepted but not on the public config type: a framework developer's switch
   warnOnFrameworkChange: v.exactOptional(v.boolean()),
   hmr: v.exactOptional(v.union([v.boolean(), v.literal('reload')])),
-  csr: v.exactOptional(v.boolean())
+  csr: v.exactOptional(v.boolean()),
+  serverSideRouting: v.exactOptional(v.boolean()),
+  defaultCacheControl: v.exactOptional(cacheControlSchema),
+  registration: v.exactOptional(v.picklist(['register', 'pipeline']))
 };
 const frameworkConfigWithRootComponentSchema = v.object({
   ...frameworkConfigBaseEntries,
@@ -63,7 +73,9 @@ const frameworkConfigWithRootComponentSchema = v.object({
 });
 const frameworkConfigWithoutRootComponentSchema = v.object({
   ...frameworkConfigBaseEntries,
-  useRootComponent: v.literal(false)
+  useRootComponent: v.literal(false),
+  // the stub page's html/head/body come from the root component
+  serverSideRouting: v.exactOptional(v.literal(true))
 });
 // variant, not union: a plain union reports one issue at the union itself ("Expected Object but
 // received Object"), where this picks the branch by useRootComponent and reports its actual fields

package/dist/getComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getComponent.d.ts","sourceRoot":"","sources":["../src/getComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAUrC,wBAAsB,YAAY,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAEhB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}
+{"version":3,"file":"getComponent.d.ts","sourceRoot":"","sources":["../src/getComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAWrC,wBAAsB,YAAY,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAEhB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}

package/dist/getComponent.js

@@ -3,6 +3,7 @@ import { TungstenError } from './TungstenError.js';
 import { throwError } from './throwError.js';
 import { iterationQueryString } from './iterationQueryString.js';
 import { importDevModuleWithRetry } from './importDevModuleWithRetry.js';
+import { importModule } from './importModule.js';
 //let load //// !! future improvement
 export async function getComponent(filePath, filename,
 //load: Load | null = null,
@@ -20,19 +21,19 @@ iteration = null, mode = 'prod') {
     module = await importDevModuleWithRetry(iterationQueryString(filePath, iteration));
   } else {
     //console.log('import', filePath)
-    module = await import(filePath); // import the module
+    module = await importModule(filePath);
   }
   // use the default export if it has one 
   if (module.default) {
     // eslint-disable-line @typescript-eslint/strict-boolean-expressions
-    return module.default;
+    return module.default; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
   }
   // else look for an export with the same name as the file
   const fileName = filename.split('/').pop() || ''; // cut out any folders
   const componentName = fileName.slice(0, fileName.indexOf('.'));
   if (module[componentName]) {
     // eslint-disable-line @typescript-eslint/strict-boolean-expressions
-    return module[componentName];
+    return module[componentName]; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
   }
   // else throw an error, because we couldn't find a component
   throw new TungstenError(`Could not find a component in ${filename}.` + ' Use a default export, or a named export that matches the file name.');

package/dist/getRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getRoutes.d.ts","sourceRoot":"","sources":["../src/getRoutes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAejE,wBAAsB,SAAS,CAC3B,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,uBAAuB,EAE/B,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACnB,OAAO,CAAC,SAAS,CAAC,CA0BrB"}
+{"version":3,"file":"getRoutes.d.ts","sourceRoot":"","sources":["../src/getRoutes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAgBjE,wBAAsB,SAAS,CAC3B,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,uBAAuB,EAE/B,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACnB,OAAO,CAAC,SAAS,CAAC,CAoBrB"}

package/dist/getRoutes.js

@@ -1,9 +1,11 @@
 import { join } from 'path';
 import { fixExtension } from './fixExtension.js';
-import { TungstenError } from './TungstenError.js';
 import { iterationQueryString } from './iterationQueryString.js';
 import { throwError } from './throwError.js';
 import { importDevModuleWithRetry } from './importDevModuleWithRetry.js';
+import { importModule } from './importModule.js';
+import { routesLocationParts } from './routesLocationParts.js';
+import { resolveAppRoutes } from './routing/resolveAppRoutes.js';
 // future - add a loose check on the routes object
 function IsAppRoutesShaped(v) {
   return true;
@@ -13,7 +15,9 @@ export async function getRoutes(compilationInfo, config,
 iteration = null, mode = 'prod') {
   //console.log('config.routesLocation', config.routesLocation)
   //console.log('config.routesLocation', config.routesLocation)
-  const [routesFile, routeExport] = config.routesLocation;
+  const {
+    routesFile
+  } = routesLocationParts(config.routesLocation);
   const filePath = 'file://' + fixExtension(join(compilationInfo.buildCodeLocation, routesFile));
   let module;
   if (mode === 'dev') {
@@ -21,11 +25,8 @@ iteration = null, mode = 'prod') {
     // can we share load across the render?
     module = await importDevModuleWithRetry(iterationQueryString(filePath, iteration));
   } else {
-    module = await import(filePath); // import the module
+    module = await importModule(filePath);
   }
-  // use the config to determine the export name
-  if (!(routeExport in module)) {
-    throw new TungstenError(`Could not find an export named ${routeExport} in routes file ${routesFile}.` + ` These settings are set in config.routesLocation.`);
-  }
-  return module[routeExport];
+  // importing the module is what runs the app's registerRouting() call
+  return resolveAppRoutes(module, config.routesLocation, mode);
 }