@ossido-labs/ossido 0.1.4 → 0.1.6

package/dist/esm/build/config/normalize-config.js

@@ -63,7 +63,10 @@ const normalizeConfig = (config) => {
 			}
 		},
 		dev: { criticalCss: config.dev?.criticalCss ?? true },
-		ssr: { renderThreads: config.ssr?.renderThreads ?? null },
+		ssr: {
+			renderThreads: config.ssr?.renderThreads ?? null,
+			warmupRenders: config.ssr?.warmupRenders ?? null
+		},
 		output: config.output ?? "server",
 		viewTransitions: config.viewTransitions ?? false,
 		...config.env !== void 0 ? { env: Array.isArray(config.env) ? config.env : [config.env] } : {},

package/dist/esm/build/config/normalize-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-config.js","names":[],"sources":["../../../../src/build/config/normalize-config.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { AliasOptions } from 'vite';\n\nimport type { OssidoConfig } from '../../config';\n\nimport type { InternalOssidoConfig } from '../types';\n\nimport { DOT_OSSIDO_FOLDER_NAME, CONFIG_FOLDER_NAME } from '../constants';\n\n/**\n *  Normalize vite alias option:\n * - If the path starts with `src` folder, transform it to absolute, prepending the ossido root folder\n * - If the path is absolute, remove the \".ossido/config/\" path from it\n * - Otherwise leave the path untouched\n */\nconst normalizeAliasPath = (aliasPath: string): string => {\n  if (aliasPath.startsWith('./src') || aliasPath.startsWith('src')) {\n    return path.join(process.cwd(), aliasPath);\n  }\n\n  if (path.isAbsolute(aliasPath)) {\n    return aliasPath.replace(\n      path.join(DOT_OSSIDO_FOLDER_NAME, CONFIG_FOLDER_NAME),\n      '',\n    );\n  }\n\n  return aliasPath;\n};\n\n/**\n * From a given vite aliasOptions apply {@link normalizeAliasPath} for each alias.\n *\n * The config is bundled by `vite` and emitted inside {@link DOT_OSSIDO_FOLDER_NAME}/{@link CONFIG_FOLDER_NAME}.\n * According to this, we have to ensure that the aliases provided by the user are updated to refer to the right folders.\n *\n * @see https://github.com/Valerioageno/tuono/pull/153#issuecomment-2508142877\n */\nconst normalizeViteAlias = (alias?: AliasOptions): AliasOptions | undefined => {\n  if (!alias) return;\n\n  if (Array.isArray(alias)) {\n    return (alias as Extract<AliasOptions, ReadonlyArray<unknown>>).map(\n      ({ replacement, ...userAliasDefinition }) => ({\n        ...userAliasDefinition,\n        replacement: normalizeAliasPath(replacement),\n      }),\n    );\n  }\n\n  if (typeof alias === 'object') {\n    const normalizedAlias: AliasOptions = {};\n    for (const [key, value] of Object.entries(alias)) {\n      normalizedAlias[key] = normalizeAliasPath(value as string);\n    }\n    return normalizedAlias;\n  }\n\n  return alias;\n};\n\n/**\n * Wrapper function to normalize the ossido.config.ts file\n *\n * @warning Exported for unit test.\n *          There is no easy way to mock the module export and change it in every test\n *          and also testing the error\n */\nexport const normalizeConfig = (config: OssidoConfig): InternalOssidoConfig => {\n  return {\n    server: {\n      host: config.server?.host ?? 'localhost',\n      origin: config.server?.origin ?? null,\n      port: config.server?.port ?? 3000,\n    },\n    vite: {\n      alias: normalizeViteAlias(config.vite?.alias),\n      css: config.vite?.css,\n      optimizeDeps: config.vite?.optimizeDeps,\n      plugins: config.vite?.plugins ?? [],\n    },\n    logging: {\n      format: config.logging?.format ?? 'pretty',\n      routeTree: config.logging?.routeTree ?? false,\n      browser: {\n        enabled: config.logging?.browser?.enabled ?? true,\n        level: config.logging?.browser?.level ?? 'info',\n      },\n    },\n    dev: {\n      criticalCss: config.dev?.criticalCss ?? true,\n    },\n    ssr: {\n      // `null` = auto: the Rust runtime uses the machine's available\n      // parallelism (resolving it here would bake in the build machine's cores).\n      renderThreads: config.ssr?.renderThreads ?? null,\n    },\n    output: config.output ?? 'server',\n    viewTransitions: config.viewTransitions ?? false,\n    // Coerce a single path to a one-element array so the Rust side always sees\n    // `Option<Vec<String>>`. Absent stays absent (default cascade).\n    ...(config.env !== undefined\n      ? { env: Array.isArray(config.env) ? config.env : [config.env] }\n      : {}),\n    // Passed through untouched; interpreted by the Vite config (JS-only).\n    ...(config.lightningcss !== undefined\n      ? { lightningcss: config.lightningcss }\n      : {}),\n    // Carried through as-is (its `prebuild`/`postbuild` are functions, so they\n    // are only reachable via `loadConfig`, never the JSON config). Spread\n    // conditionally so an absent `build` isn't materialised as `undefined`.\n    ...(config.build ? { build: config.build } : {}),\n  };\n};\n"],"mappings":";;;;;;;;;;AAgBA,MAAM,sBAAsB,cAA8B;CACxD,IAAI,UAAU,WAAW,OAAO,KAAK,UAAU,WAAW,KAAK,GAC7D,OAAO,KAAK,KAAK,QAAQ,IAAI,GAAG,SAAS;CAG3C,IAAI,KAAK,WAAW,SAAS,GAC3B,OAAO,UAAU,QACf,KAAK,KAAK,wBAAwB,kBAAkB,GACpD,EACF;CAGF,OAAO;AACT;;;;;;;;;AAUA,MAAM,sBAAsB,UAAmD;CAC7E,IAAI,CAAC,OAAO;CAEZ,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAQ,MAAwD,KAC7D,EAAE,aAAa,GAAG,2BAA2B;EAC5C,GAAG;EACH,aAAa,mBAAmB,WAAW;CAC7C,EACF;CAGF,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,kBAAgC,CAAC;EACvC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,gBAAgB,OAAO,mBAAmB,KAAe;EAE3D,OAAO;CACT;CAEA,OAAO;AACT;;;;;;;;AASA,MAAa,mBAAmB,WAA+C;CAC7E,OAAO;EACL,QAAQ;GACN,MAAM,OAAO,QAAQ,QAAQ;GAC7B,QAAQ,OAAO,QAAQ,UAAU;GACjC,MAAM,OAAO,QAAQ,QAAQ;EAC/B;EACA,MAAM;GACJ,OAAO,mBAAmB,OAAO,MAAM,KAAK;GAC5C,KAAK,OAAO,MAAM;GAClB,cAAc,OAAO,MAAM;GAC3B,SAAS,OAAO,MAAM,WAAW,CAAC;EACpC;EACA,SAAS;GACP,QAAQ,OAAO,SAAS,UAAU;GAClC,WAAW,OAAO,SAAS,aAAa;GACxC,SAAS;IACP,SAAS,OAAO,SAAS,SAAS,WAAW;IAC7C,OAAO,OAAO,SAAS,SAAS,SAAS;GAC3C;EACF;EACA,KAAK,EACH,aAAa,OAAO,KAAK,eAAe,KAC1C;EACA,KAAK,EAGH,eAAe,OAAO,KAAK,iBAAiB,KAC9C;EACA,QAAQ,OAAO,UAAU;EACzB,iBAAiB,OAAO,mBAAmB;EAG3C,GAAI,OAAO,QAAQ,SACf,EAAE,KAAK,MAAM,QAAQ,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,OAAO,GAAG,EAAE,IAC7D,CAAC;EAEL,GAAI,OAAO,iBAAiB,SACxB,EAAE,cAAc,OAAO,aAAa,IACpC,CAAC;EAIL,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;CAChD;AACF"}
+{"version":3,"file":"normalize-config.js","names":[],"sources":["../../../../src/build/config/normalize-config.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { AliasOptions } from 'vite';\n\nimport type { OssidoConfig } from '../../config';\n\nimport type { InternalOssidoConfig } from '../types';\n\nimport { DOT_OSSIDO_FOLDER_NAME, CONFIG_FOLDER_NAME } from '../constants';\n\n/**\n *  Normalize vite alias option:\n * - If the path starts with `src` folder, transform it to absolute, prepending the ossido root folder\n * - If the path is absolute, remove the \".ossido/config/\" path from it\n * - Otherwise leave the path untouched\n */\nconst normalizeAliasPath = (aliasPath: string): string => {\n  if (aliasPath.startsWith('./src') || aliasPath.startsWith('src')) {\n    return path.join(process.cwd(), aliasPath);\n  }\n\n  if (path.isAbsolute(aliasPath)) {\n    return aliasPath.replace(\n      path.join(DOT_OSSIDO_FOLDER_NAME, CONFIG_FOLDER_NAME),\n      '',\n    );\n  }\n\n  return aliasPath;\n};\n\n/**\n * From a given vite aliasOptions apply {@link normalizeAliasPath} for each alias.\n *\n * The config is bundled by `vite` and emitted inside {@link DOT_OSSIDO_FOLDER_NAME}/{@link CONFIG_FOLDER_NAME}.\n * According to this, we have to ensure that the aliases provided by the user are updated to refer to the right folders.\n *\n * @see https://github.com/Valerioageno/tuono/pull/153#issuecomment-2508142877\n */\nconst normalizeViteAlias = (alias?: AliasOptions): AliasOptions | undefined => {\n  if (!alias) return;\n\n  if (Array.isArray(alias)) {\n    return (alias as Extract<AliasOptions, ReadonlyArray<unknown>>).map(\n      ({ replacement, ...userAliasDefinition }) => ({\n        ...userAliasDefinition,\n        replacement: normalizeAliasPath(replacement),\n      }),\n    );\n  }\n\n  if (typeof alias === 'object') {\n    const normalizedAlias: AliasOptions = {};\n    for (const [key, value] of Object.entries(alias)) {\n      normalizedAlias[key] = normalizeAliasPath(value as string);\n    }\n    return normalizedAlias;\n  }\n\n  return alias;\n};\n\n/**\n * Wrapper function to normalize the ossido.config.ts file\n *\n * @warning Exported for unit test.\n *          There is no easy way to mock the module export and change it in every test\n *          and also testing the error\n */\nexport const normalizeConfig = (config: OssidoConfig): InternalOssidoConfig => {\n  return {\n    server: {\n      host: config.server?.host ?? 'localhost',\n      origin: config.server?.origin ?? null,\n      port: config.server?.port ?? 3000,\n    },\n    vite: {\n      alias: normalizeViteAlias(config.vite?.alias),\n      css: config.vite?.css,\n      optimizeDeps: config.vite?.optimizeDeps,\n      plugins: config.vite?.plugins ?? [],\n    },\n    logging: {\n      format: config.logging?.format ?? 'pretty',\n      routeTree: config.logging?.routeTree ?? false,\n      browser: {\n        enabled: config.logging?.browser?.enabled ?? true,\n        level: config.logging?.browser?.level ?? 'info',\n      },\n    },\n    dev: {\n      criticalCss: config.dev?.criticalCss ?? true,\n    },\n    ssr: {\n      // `null` = auto: the Rust runtime uses the machine's available\n      // parallelism (resolving it here would bake in the build machine's cores).\n      renderThreads: config.ssr?.renderThreads ?? null,\n      // `null` = runtime default (3 warm-up renders per pool thread).\n      warmupRenders: config.ssr?.warmupRenders ?? null,\n    },\n    output: config.output ?? 'server',\n    viewTransitions: config.viewTransitions ?? false,\n    // Coerce a single path to a one-element array so the Rust side always sees\n    // `Option<Vec<String>>`. Absent stays absent (default cascade).\n    ...(config.env !== undefined\n      ? { env: Array.isArray(config.env) ? config.env : [config.env] }\n      : {}),\n    // Passed through untouched; interpreted by the Vite config (JS-only).\n    ...(config.lightningcss !== undefined\n      ? { lightningcss: config.lightningcss }\n      : {}),\n    // Carried through as-is (its `prebuild`/`postbuild` are functions, so they\n    // are only reachable via `loadConfig`, never the JSON config). Spread\n    // conditionally so an absent `build` isn't materialised as `undefined`.\n    ...(config.build ? { build: config.build } : {}),\n  };\n};\n"],"mappings":";;;;;;;;;;AAgBA,MAAM,sBAAsB,cAA8B;CACxD,IAAI,UAAU,WAAW,OAAO,KAAK,UAAU,WAAW,KAAK,GAC7D,OAAO,KAAK,KAAK,QAAQ,IAAI,GAAG,SAAS;CAG3C,IAAI,KAAK,WAAW,SAAS,GAC3B,OAAO,UAAU,QACf,KAAK,KAAK,wBAAwB,kBAAkB,GACpD,EACF;CAGF,OAAO;AACT;;;;;;;;;AAUA,MAAM,sBAAsB,UAAmD;CAC7E,IAAI,CAAC,OAAO;CAEZ,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAQ,MAAwD,KAC7D,EAAE,aAAa,GAAG,2BAA2B;EAC5C,GAAG;EACH,aAAa,mBAAmB,WAAW;CAC7C,EACF;CAGF,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,kBAAgC,CAAC;EACvC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,gBAAgB,OAAO,mBAAmB,KAAe;EAE3D,OAAO;CACT;CAEA,OAAO;AACT;;;;;;;;AASA,MAAa,mBAAmB,WAA+C;CAC7E,OAAO;EACL,QAAQ;GACN,MAAM,OAAO,QAAQ,QAAQ;GAC7B,QAAQ,OAAO,QAAQ,UAAU;GACjC,MAAM,OAAO,QAAQ,QAAQ;EAC/B;EACA,MAAM;GACJ,OAAO,mBAAmB,OAAO,MAAM,KAAK;GAC5C,KAAK,OAAO,MAAM;GAClB,cAAc,OAAO,MAAM;GAC3B,SAAS,OAAO,MAAM,WAAW,CAAC;EACpC;EACA,SAAS;GACP,QAAQ,OAAO,SAAS,UAAU;GAClC,WAAW,OAAO,SAAS,aAAa;GACxC,SAAS;IACP,SAAS,OAAO,SAAS,SAAS,WAAW;IAC7C,OAAO,OAAO,SAAS,SAAS,SAAS;GAC3C;EACF;EACA,KAAK,EACH,aAAa,OAAO,KAAK,eAAe,KAC1C;EACA,KAAK;GAGH,eAAe,OAAO,KAAK,iBAAiB;GAE5C,eAAe,OAAO,KAAK,iBAAiB;EAC9C;EACA,QAAQ,OAAO,UAAU;EACzB,iBAAiB,OAAO,mBAAmB;EAG3C,GAAI,OAAO,QAAQ,SACf,EAAE,KAAK,MAAM,QAAQ,OAAO,GAAG,IAAI,OAAO,MAAM,CAAC,OAAO,GAAG,EAAE,IAC7D,CAAC;EAEL,GAAI,OAAO,iBAAiB,SACxB,EAAE,cAAc,OAAO,aAAa,IACpC,CAAC;EAIL,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;CAChD;AACF"}

package/dist/esm/build/index.d.ts

@@ -11,5 +11,5 @@ declare const buildConfig: () => void;
  * deploy `out/static`, server builds `out`. `postbuild` gets the emitted-file
  * manifest; `prebuild` runs before anything is emitted, so its manifest is empty.
  */
-declare const runBuildHook: (name: "prebuild" | "postbuild") => void;
+declare const runBuildHook: (name: 'prebuild' | 'postbuild') => void;
 export { buildProd, buildConfig, developmentCSRWatch, developmentSSRBundle, runBuildHook, };

package/dist/esm/build/types.d.ts

@@ -14,10 +14,12 @@ export interface InternalOssidoConfigDev {
 }
 /**
  * Fully-resolved SSR config. `renderThreads` is `null` when unset — the Rust
- * runtime then defaults it to the machine's available parallelism.
+ * runtime then defaults it to the machine's available parallelism. Likewise
+ * `warmupRenders` is `null` when unset (runtime default: 3).
  */
 export interface InternalOssidoConfigSsr {
     renderThreads: number | null;
+    warmupRenders: number | null;
 }
 export interface InternalOssidoConfig extends Omit<OssidoConfig, 'server' | 'logging' | 'dev' | 'ssr' | 'output' | 'viewTransitions' | 'env'> {
     server: OssidoConfigServer;

package/dist/esm/config/types.d.ts

@@ -149,6 +149,16 @@ export interface OssidoConfigSsr {
      * runtime with the `OSSIDO_SSR_THREADS` environment variable.
      */
     renderThreads?: number;
+    /**
+     * Number of throwaway warm-up renders each render-pool thread performs at
+     * server start, before serving traffic. Repeated renders let V8's tiering
+     * compilers (Sparkplug → Maglev → TurboFan) optimise the hot render path, so
+     * the first real requests hit already-optimised code instead of paying the
+     * interpreter-speed first render. Defaults to `3`; set `0` to disable.
+     * Overridable at runtime with the `OSSIDO_SSR_WARMUP_RENDERS` environment
+     * variable.
+     */
+    warmupRenders?: number;
 }
 /** Development-only tweaks. */
 export interface OssidoConfigDev {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossido-labs/ossido",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -87,9 +87,9 @@
     "browserslist": "^4.28.8",
     "fast-text-encoding": "^1.0.6",
     "lightningcss": "^1.33.0",
-    "@ossido-labs/ossido-react-vite-plugin": "0.1.4",
-    "@ossido-labs/ossido-router": "0.1.4",
-    "@ossido-labs/ossido-ui": "0.1.4",
+    "@ossido-labs/ossido-react-vite-plugin": "0.1.6",
+    "@ossido-labs/ossido-router": "0.1.6",
+    "@ossido-labs/ossido-ui": "0.1.6",
     "url-search-params-polyfill": "^8.2.5",
     "web-streams-polyfill": "^4.0.0"
   },