@lowdefy/build 5.6.0 → 6.0.0

package/dist/build/buildTypes.js

@@ -70,11 +70,14 @@ function buildTypes({ components, context }) {
             adapters: {},
             callbacks: {},
             events: {},
-            providers: {}
+            providers: {},
+            strategies: {}
         },
         blocks: {},
         connections: {},
+        notifications: {},
         requests: {},
+        websockets: {},
         api: {},
         operators: {
             client: {},
@@ -117,6 +120,12 @@ function buildTypes({ components, context }) {
         store: components.types.auth.providers,
         typeClass: 'Auth provider'
     });
+    buildTypeClass(context, {
+        counter: typeCounters.auth.strategies,
+        definitions: context.typesMap.auth.strategies,
+        store: components.types.auth.strategies,
+        typeClass: 'Auth strategy'
+    });
     buildTypeClass(context, {
         counter: typeCounters.blocks,
         definitions: context.typesMap.blocks,
@@ -129,12 +138,24 @@ function buildTypes({ components, context }) {
         store: components.types.connections,
         typeClass: 'Connection'
     });
+    buildTypeClass(context, {
+        counter: typeCounters.notifications,
+        definitions: context.typesMap.notifications,
+        store: components.types.notifications,
+        typeClass: 'Notification'
+    });
     buildTypeClass(context, {
         counter: typeCounters.requests,
         definitions: context.typesMap.requests,
         store: components.types.requests,
         typeClass: 'Request'
     });
+    buildTypeClass(context, {
+        counter: typeCounters.websockets,
+        definitions: context.typesMap.websockets,
+        store: components.types.websockets,
+        typeClass: 'Websocket'
+    });
     buildTypeClass(context, {
         counter: typeCounters.operators.client,
         definitions: context.typesMap.operators.client,

package/dist/build/buildWebsockets.js

@@ -0,0 +1,99 @@
+/* eslint-disable no-param-reassign */ /*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+import { ConfigError } from '@lowdefy/errors';
+import countOperators from '../utils/countOperators.js';
+import createCheckDuplicateId from '../utils/createCheckDuplicateId.js';
+import validateId from '../utils/validateId.js';
+function buildWebsockets({ components, context }) {
+    if (components.websockets && !type.isArray(components.websockets)) {
+        throw new ConfigError('Websockets is not an array.', {
+            received: components.websockets
+        });
+    }
+    const websockets = type.isArray(components.websockets) ? components.websockets : [];
+    context.websocketIds = new Set();
+    const checkDuplicateWebsocketId = createCheckDuplicateId({
+        message: 'Duplicate websocketId "{{ id }}".'
+    });
+    websockets.forEach((websocket, index)=>{
+        const configKey = websocket['~k'];
+        if (type.isUndefined(websocket.id)) {
+            throw new ConfigError(`Websocket id missing at websocket ${index}.`, {
+                configKey
+            });
+        }
+        if (!type.isString(websocket.id)) {
+            throw new ConfigError(`Websocket id is not a string at websocket ${index}.`, {
+                received: websocket.id,
+                configKey
+            });
+        }
+        validateId({
+            id: websocket.id,
+            field: 'Websocket id',
+            configKey
+        });
+        checkDuplicateWebsocketId({
+            id: websocket.id,
+            configKey
+        });
+        if (!type.isString(websocket.type)) {
+            throw new ConfigError(`Websocket type is not a string at websocket "${websocket.id}".`, {
+                received: websocket.type,
+                configKey
+            });
+        }
+        // Track type usage for buildTypes validation
+        context.typeCounters.websockets.increment(websocket.type, configKey);
+        // connectionId is optional — Channel and other connectionless types don't need one
+        if (!type.isNone(websocket.connectionId)) {
+            if (!type.isString(websocket.connectionId)) {
+                throw new ConfigError(`Websocket connectionId is not a string at websocket "${websocket.id}".`, {
+                    received: websocket.connectionId,
+                    configKey
+                });
+            }
+            // Connections may have been renamed by buildConnections:
+            //   connection.connectionId = original id, connection.id = 'connection:' + original id
+            const connectionExists = (components.connections ?? []).some((c)=>c.id === websocket.connectionId || c.connectionId === websocket.connectionId);
+            if (!connectionExists) {
+                throw new ConfigError(`Websocket "${websocket.id}" references connectionId "${websocket.connectionId}" which does not exist.`, {
+                    configKey,
+                    checkSlug: 'connection-refs'
+                });
+            }
+        }
+        if (type.isNone(websocket.properties)) {
+            websocket.properties = {};
+        }
+        if (!type.isObject(websocket.properties)) {
+            throw new ConfigError(`Websocket properties is not an object at websocket "${websocket.id}".`, {
+                received: websocket.properties,
+                configKey
+            });
+        }
+        // Rename id to internal format
+        websocket.websocketId = websocket.id;
+        context.websocketIds.add(websocket.websocketId);
+        websocket.id = `websocket:${websocket.websocketId}`;
+        // Count server operators in properties
+        countOperators(websocket.properties, {
+            counter: context.typeCounters.operators.server
+        });
+    });
+    return components;
+}
+export default buildWebsockets;

package/dist/build/collectPageContent.js

@@ -24,7 +24,13 @@
         return;
     }
     if (value && typeof value === 'object') {
-        for (const v of Object.values(value)){
+        for (const [key, v] of Object.entries(value)){
+            // Build marker values (~k keys regenerate on every JIT rebuild) are
+            // never tailwind candidates — including them would make the collected
+            // content differ between byte-identical page builds.
+            if (key === '~k' || key === '~r' || key === '~l') {
+                continue;
+            }
             walkValue(v, strings);
         }
     }

package/dist/build/copyAgentFileSystems.js

@@ -25,8 +25,8 @@ async function copyAgentFileSystems({ components, context }) {
         seen.add(basePath);
         basePaths.push(basePath);
     }
-    // Manifest is consumed by next.config.js to populate outputFileTracingIncludes,
-    // so the Next.js tracer bundles these directories on Vercel and standalone builds.
+    // Manifest of agent file system base paths copied into the server directory —
+    // available to deployment tooling that needs to include these directories.
     await context.writeBuildArtifact('agentFileSystems.json', JSON.stringify(basePaths));
     if (context.directories.config === context.directories.server) return;
     for (const basePath of basePaths){

package/dist/build/full/buildPages.js

@@ -17,10 +17,12 @@ import { ConfigError, shouldSuppressBuildCheck } from '@lowdefy/errors';
 import buildPage from '../buildPages/buildPage.js';
 import createCheckDuplicateId from '../../utils/createCheckDuplicateId.js';
 import validateCallApiRefs from '../buildPages/validateCallApiRefs.js';
+import validateDynamicBlockRefs from '../buildPages/validateDynamicBlockRefs.js';
 import validateLinkReferences from '../buildPages/validateLinkReferences.js';
 import validatePayloadReferences from '../buildPages/validatePayloadReferences.js';
 import validateServerStateReferences from '../buildPages/validateServerStateReferences.js';
 import validateStateReferences from '../buildPages/validateStateReferences.js';
+import validateWebsocketRefs from '../buildPages/validateWebsocketRefs.js';
 function buildPages({ components, context }) {
     const pages = type.isArray(components.pages) ? components.pages : [];
     const checkDuplicatePageId = createCheckDuplicateId({
@@ -29,6 +31,8 @@ function buildPages({ components, context }) {
     // Initialize action ref collections across all pages
     context.linkActionRefs = [];
     context.callApiActionRefs = [];
+    context.websocketActionRefs = [];
+    context.dynamicBlockRefs = [];
     // Track which pages failed to build so we skip them in validation
     const failedPageIndices = new Set();
     // Wrap each page build to collect errors instead of stopping on first error
@@ -73,6 +77,18 @@ function buildPages({ components, context }) {
         endpointConfigs,
         context
     });
+    // Validate that Dynamic blocks reference existing endpoints
+    validateDynamicBlockRefs({
+        dynamicBlockRefs: context.dynamicBlockRefs,
+        endpointConfigs,
+        context
+    });
+    // Validate that Subscribe/Unsubscribe/Publish actions reference defined websockets
+    validateWebsocketRefs({
+        websocketActionRefs: context.websocketActionRefs,
+        websocketIds: context.websocketIds ?? new Set(),
+        context
+    });
     // Validate that _state references use defined block IDs
     // and _payload references use defined payload keys
     // Skip pages that failed to build

package/dist/build/full/updateServerPackageJson.js

@@ -21,6 +21,12 @@ async function updateServerPackageJson({ components, context }) {
     const dependencies = packageJson.dependencies;
     function getPackages(types) {
         Object.values(types).forEach((type)=>{
+            // Deployment tooling may have rewritten a workspace plugin to a link:
+            // path — overwriting it with the configured version (e.g. workspace:*)
+            // would break installs outside the monorepo workspace.
+            if (dependencies[type.package]?.startsWith('link:')) {
+                return;
+            }
             dependencies[type.package] = type.version;
         });
     }
@@ -30,11 +36,26 @@ async function updateServerPackageJson({ components, context }) {
     getPackages(components.types.auth.callbacks);
     getPackages(components.types.auth.events);
     getPackages(components.types.auth.providers);
+    getPackages(components.types.auth.strategies);
     getPackages(components.types.blocks);
     getPackages(components.types.connections);
+    getPackages(components.types.notifications);
     getPackages(components.types.requests);
+    getPackages(components.types.websockets);
     getPackages(components.types.operators.client);
     getPackages(components.types.operators.server);
+    if ((components.notifications ?? []).length > 0) {
+        // plugins/notifications.js re-exports renderEmail from @lowdefy/email-templates
+        // for every app with notifications — including apps that only use custom
+        // template types, where no framework template appears in components.types.
+        // The react-email preview CLI is deliberately NOT added here — it is a
+        // dev-only tool the `lowdefy emails` command installs just-in-time, so
+        // production servers never carry it.
+        const emailTemplates = Object.values(context.typesMap.notifications ?? {}).find((t)=>t.package === '@lowdefy/email-templates');
+        if (emailTemplates && !dependencies['@lowdefy/email-templates']?.startsWith('link:')) {
+            dependencies['@lowdefy/email-templates'] = emailTemplates.version;
+        }
+    }
     // Sort dependencies
     packageJson.dependencies = {};
     Object.keys(dependencies).sort().forEach((name)=>{

package/dist/build/jit/buildPageJit.js

@@ -20,19 +20,23 @@ import operators from '@lowdefy/operators-js/operators/build';
 import addKeys from '../addKeys.js';
 import buildPage from '../buildPages/buildPage.js';
 import validateCallApiRefs from '../buildPages/validateCallApiRefs.js';
+import validateDynamicBlockRefs from '../buildPages/validateDynamicBlockRefs.js';
 import validateLinkReferences from '../buildPages/validateLinkReferences.js';
 import validatePayloadReferences from '../buildPages/validatePayloadReferences.js';
 import validateServerStateReferences from '../buildPages/validateServerStateReferences.js';
 import validateStateReferences from '../buildPages/validateStateReferences.js';
+import validateWebsocketRefs from '../buildPages/validateWebsocketRefs.js';
 import collectDynamicIdentifiers from '../collectDynamicIdentifiers.js';
+import collectPageContent from '../collectPageContent.js';
 import createCheckDuplicateId from '../../utils/createCheckDuplicateId.js';
 import createContext from '../../createContext.js';
-import evaluateStaticOperators from '../buildRefs/evaluateStaticOperators.js';
+import precomputeRuntimeOperators from '../buildRefs/precomputeRuntimeOperators.js';
 import getRefContent from '../buildRefs/getRefContent.js';
 import jsMapParser from '../buildJs/jsMapParser.js';
 import makeRefDefinition from '../buildRefs/makeRefDefinition.js';
 import rebaseModuleRefPaths from '../buildRefs/rebaseModuleRefPaths.js';
-import { resolve, WalkContext, cloneForResolve, tagRefDeep } from '../buildRefs/walker.js';
+import { resolve, WalkContext, tagRefDeep } from '../buildRefs/walker.js';
+import cloneWithMarkers from '../buildRefs/cloneWithMarkers.js';
 import validateOperatorsDynamic from '../validateOperatorsDynamic.js';
 import writeMaps from '../writeMaps.js';
 import detectMissingIcons from './detectMissingIcons.js';
@@ -131,10 +135,11 @@ async function buildPageJit({ pageId, pageRegistry, context, directories, logger
                 refChain: new Set(),
                 operators,
                 env: process.env,
+                lowdefyApp: buildContext.appMeta,
                 dynamicIdentifiers,
                 shouldStop: null
             });
-            resolvedVars = await resolve(cloneForResolve(unresolvedVars), varCtx);
+            resolvedVars = await resolve(cloneWithMarkers(unresolvedVars), varCtx);
         }
         let refDef;
         if (pageEntry.resolverOriginal) {
@@ -188,11 +193,12 @@ async function buildPageJit({ pageId, pageRegistry, context, directories, logger
             refChain: new Set(),
             operators,
             env: process.env,
+            lowdefyApp: buildContext.appMeta,
             dynamicIdentifiers,
             shouldStop: null
         });
         let processed = await resolve(pageContent, pageCtx);
-        processed = evaluateStaticOperators({
+        processed = precomputeRuntimeOperators({
             context: buildContext,
             input: processed,
             refDef
@@ -232,6 +238,19 @@ async function buildPageJit({ pageId, pageRegistry, context, directories, logger
         if (!buildContext.callApiActionRefs) {
             buildContext.callApiActionRefs = [];
         }
+        if (!buildContext.websocketActionRefs) {
+            buildContext.websocketActionRefs = [];
+        }
+        if (!buildContext.dynamicBlockRefs) {
+            buildContext.dynamicBlockRefs = [];
+        }
+        // buildSubscriptions validates against websocketIds — the dev server
+        // restores the set from the websocketIds.json skeleton artifact. Rebuild
+        // it from skeleton-built websockets when the context doesn't carry it
+        // (createContext initializes an empty set, so check size, not presence).
+        if (!buildContext.websocketIds?.size) {
+            buildContext.websocketIds = new Set((buildContext.components?.websockets ?? []).map((websocket)=>websocket.websocketId));
+        }
         // Build the page (validation, block processing)
         const checkDuplicatePageId = createCheckDuplicateId({
             message: 'Duplicate pageId "{{ id }}".'
@@ -285,6 +304,16 @@ async function buildPageJit({ pageId, pageRegistry, context, directories, logger
             endpointConfigs,
             context: buildContext
         });
+        validateDynamicBlockRefs({
+            dynamicBlockRefs: buildContext.dynamicBlockRefs,
+            endpointConfigs,
+            context: buildContext
+        });
+        validateWebsocketRefs({
+            websocketActionRefs: buildContext.websocketActionRefs,
+            websocketIds: buildContext.websocketIds,
+            context: buildContext
+        });
         validateStateReferences({
             page: processed,
             context: buildContext
@@ -297,6 +326,12 @@ async function buildPageJit({ pageId, pageRegistry, context, directories, logger
             page: processed,
             context: buildContext
         });
+        // Collect Tailwind class candidates before _js extraction — jsMapParser
+        // replaces _js source with hashes, so classes used only inside _js source
+        // would otherwise never reach the Tailwind scanner.
+        const tailwindContent = collectPageContent([
+            processed
+        ]);
         // Extract JS functions from the page
         const pageRequests = [
             ...processed.requests ?? []
@@ -323,10 +358,15 @@ async function buildPageJit({ pageId, pageRegistry, context, directories, logger
             throw error;
         }
         // Write page artifacts
-        await writePageJit({
+        const { tailwindChanged } = await writePageJit({
             page: finalPage,
-            context: buildContext
+            context: buildContext,
+            tailwindContent
         });
+        // Attached after the disk write (like _warnings) so it never persists in
+        // artifacts — the JIT server uses it to decide whether to trigger a CSS
+        // recompile for newly discovered tailwind class candidates.
+        finalPage._tailwindChanged = tailwindChanged;
         // Attach warnings after disk write so they don't persist in artifacts
         if (buildWarnings.length > 0) {
             finalPage._warnings = buildWarnings.map((w)=>({

package/dist/build/jit/collectSkeletonSourceFiles.js

@@ -47,6 +47,18 @@ function collectSkeletonSourceFiles({ components, context }) {
     for (const moduleEntry of Object.values(context.modules ?? {})){
         walkRefIds(moduleEntry.consumerVars, refIds);
     }
+    // The walker only ~r-tags resolved _ref content, never the root file's own
+    // objects — so a scalar ref parented directly on the root (e.g.
+    // app.html.appendHead: {_ref: head.html}) has no collected ancestor and
+    // would be missed by the descendant scan. Add the root ref id explicitly.
+    if (context.rootRefDef?.id != null) {
+        refIds.add(context.rootRefDef.id);
+    }
+    // Page refs are stop boundaries for the descendant scan: with the root id
+    // collected, a scalar ref'd inside a page file would otherwise reach the
+    // root through its page ref and wrongly become a skeleton source.
+    const pageRefIds = new Set();
+    walkRefIds(components.pages ?? [], pageRefIds);
     const sourceFiles = new Set();
     // Walk parent chains for each collected ref ID
     for (const refId of refIds){
@@ -65,6 +77,7 @@ function collectSkeletonSourceFiles({ components, context }) {
     // their paths if any ancestor in their parent chain is a collected ref ID.
     for (const [id, entry] of Object.entries(context.refMap)){
         if (refIds.has(id)) continue;
+        if (pageRefIds.has(id)) continue;
         let current = entry.parent;
         while(current != null){
             if (refIds.has(current)) {
@@ -73,6 +86,7 @@ function collectSkeletonSourceFiles({ components, context }) {
                 }
                 break;
             }
+            if (pageRefIds.has(current)) break;
             const parentEntry = context.refMap[current];
             if (!parentEntry) break;
             current = parentEntry.parent;

package/dist/build/jit/pageContentKeys.js

@@ -22,6 +22,7 @@ const PAGE_CONTENT_KEYS = [
     'slots',
     'events',
     'requests',
+    'subscriptions',
     'layout'
 ];
 export default PAGE_CONTENT_KEYS;

package/dist/build/jit/shallowBuild.js

@@ -21,17 +21,25 @@ import tryBuildStep from '../../utils/tryBuildStep.js';
 import addDefaultPages from '../addDefaultPages/addDefaultPages.js';
 import addKeys from '../addKeys.js';
 import buildApp from '../buildApp.js';
+import buildAppMeta from '../buildAppMeta.js';
 import buildAuth from '../buildAuth/buildAuth.js';
 import buildConnections from '../buildConnections.js';
 import buildAgents from '../buildAgents.js';
 import buildApi from '../buildApi/buildApi.js';
 import buildLogger from '../buildLogger.js';
 import buildImports from '../buildImports/buildImports.js';
+import buildMcp from '../buildMcp.js';
 import buildMenu from '../buildMenu.js';
 import buildModuleDefs from '../buildModuleDefs.js';
 import buildModules from '../buildModules.js';
+import buildNotifications from '../buildNotifications.js';
 import buildRefs from '../buildRefs/buildRefs.js';
+import precomputeRuntimeOperators from '../buildRefs/precomputeRuntimeOperators.js';
+import { serializeRegistry } from '../buildRefs/deferredRegistry.js';
 import buildTypes from '../buildTypes.js';
+import buildWebsockets from '../buildWebsockets.js';
+import validateCallAgentSteps from '../validateCallAgentSteps.js';
+import validateRenderNotificationSteps from '../validateRenderNotificationSteps.js';
 import cleanBuildDirectory from '../cleanBuildDirectory.js';
 import copyAgentFileSystems from '../copyAgentFileSystems.js';
 import copyPublicFolder from '../copyPublicFolder.js';
@@ -44,8 +52,11 @@ import writeConfig from '../writeConfig.js';
 import writeConnections from '../writeConnections.js';
 import writeAgents from '../writeAgents.js';
 import writeApi from '../writeApi.js';
+import writeMcp from '../writeMcp.js';
+import writeNotifications from '../writeNotifications.js';
 import writeGlobal from '../writeGlobal.js';
 import writeJs from '../buildJs/writeJs.js';
+import writeWebsockets from '../writeWebsockets.js';
 import writeLogger from '../writeLogger.js';
 import codegenI18nLocales from '../codegenI18nLocales.js';
 import writeI18n from '../writeI18n.js';
@@ -53,6 +64,7 @@ import writeTheme from '../writeTheme.js';
 import writeMaps from '../writeMaps.js';
 import updateServerPackageJson from '../full/updateServerPackageJson.js';
 import writeMenus from '../writeMenus.js';
+import writeTypes from '../full/writeTypes.js';
 import writePageRegistry from './writePageRegistry.js';
 import writePluginImports from '../writePluginImports/writePluginImports.js';
 import addInstalledTypes from './addInstalledTypes.js';
@@ -66,6 +78,12 @@ async function shallowBuild(options) {
     let context;
     try {
         context = createContext(options);
+        // Phase 0: Resolve root app metadata before any operator evaluation.
+        await buildAppMeta({
+            context
+        });
+        // Surface bad root metadata before module operators evaluate against it.
+        logCollectedErrors(context);
         // Phase 1: Build module definitions
         await buildModuleDefs({
             context
@@ -98,6 +116,18 @@ async function shallowBuild(options) {
             components,
             context
         });
+        // Phase 3.5: Constant-fold static runtime operators, mirroring the full
+        // build (index.js). Without this, content preserved at skeleton — inline
+        // pages, slot content, module components consumed into them — reaches
+        // testSchema (spurious warnings) and the served dev artifacts (broken
+        // block ids: the client never operator-evaluates id positions) with raw
+        // runtime operators. Ref-backed page content is already stripped here and
+        // folds per page in buildPageJit.
+        components = precomputeRuntimeOperators({
+            context,
+            input: components,
+            refDef: context.rootRefDef
+        });
         // addKeys + testSchema first for error location info
         tryBuildStep(addKeys, 'addKeys', {
             components,
@@ -124,6 +154,9 @@ async function shallowBuild(options) {
             components,
             context
         });
+        // appMeta is computed in Phase 0; attach it here (where buildApp used to
+        // create it) so the following addKeys pass keys it identically.
+        components.appMeta = context.appMeta;
         tryBuildStep(buildLogger, 'buildLogger', {
             components,
             context
@@ -156,6 +189,28 @@ async function shallowBuild(options) {
             components,
             context
         });
+        tryBuildStep(buildMcp, 'buildMcp', {
+            components,
+            context
+        });
+        tryBuildStep(buildWebsockets, 'buildWebsockets', {
+            components,
+            context
+        });
+        tryBuildStep(buildNotifications, 'buildNotifications', {
+            components,
+            context
+        });
+        // Cross-config validations — need buildApi (stepIds) and the buildAgents/
+        // buildNotifications id sets. Match the full build (index.js).
+        tryBuildStep(validateCallAgentSteps, 'validateCallAgentSteps', {
+            components,
+            context
+        });
+        tryBuildStep(validateRenderNotificationSteps, 'validateRenderNotificationSteps', {
+            components,
+            context
+        });
         const { pageRegistry, sourcelessPageArtifacts } = buildShallowPages({
             components,
             context
@@ -175,7 +230,7 @@ async function shallowBuild(options) {
         // Update server package.json before addInstalledTypes so that addInstalledTypes
         // sees the full set of dependencies on every run (not just after the first build).
         // This prevents plugin import files from differing between the initial and
-        // subsequent builds, which would trigger unnecessary Next.js rebuilds.
+        // subsequent builds, which would trigger unnecessary server restarts.
         await updateServerPackageJson({
             components,
             context
@@ -221,10 +276,22 @@ async function shallowBuild(options) {
             components,
             context
         });
+        await writeMcp({
+            components,
+            context
+        });
         await writeAgents({
             components,
             context
         });
+        await writeWebsockets({
+            components,
+            context
+        });
+        await writeNotifications({
+            components,
+            context
+        });
         await writeConfig({
             components,
             context
@@ -255,6 +322,9 @@ async function shallowBuild(options) {
         await context.writeBuildArtifact('connectionIds.json', JSON.stringify([
             ...context.connectionIds
         ].sort()));
+        await context.writeBuildArtifact('websocketIds.json', JSON.stringify([
+            ...context.websocketIds
+        ].sort()));
         await context.writeBuildArtifact('skeletonSourceFiles.json', JSON.stringify([
             ...skeletonSourceFiles
         ].sort()));
@@ -262,6 +332,13 @@ async function shallowBuild(options) {
             components,
             context
         });
+        // The dev client bundle imports every installed type (addInstalledTypes),
+        // so types.json here describes that full bundle — dynamic page content
+        // resolution validates fragment types against it at page get.
+        await writeTypes({
+            components,
+            context
+        });
         await writeJs({
             context
         });
@@ -276,6 +353,9 @@ async function shallowBuild(options) {
             ...context.installedPackages ?? []
         ]));
         await context.writeBuildArtifact('modules.json', serializer.serializeToString(context.modules ?? {}));
+        // Deferred-record bodies referenced by placeholders in modules.json.
+        // JIT hydrates the registry from this artifact (hydrateDeferredRecords).
+        await context.writeBuildArtifact('deferredRecords.json', serializeRegistry(context));
         await writePluginImports({
             components,
             context

package/dist/build/jit/writePageJit.js

@@ -14,10 +14,9 @@
   limitations under the License.
 */ import path from 'path';
 import { serializer, type } from '@lowdefy/helpers';
-import { writeFile } from '@lowdefy/node-utils';
-import collectPageContent from '../collectPageContent.js';
+import { writeFileIfChanged } from '@lowdefy/node-utils';
 import writeJs from '../buildJs/writeJs.js';
-async function writePageJit({ page, context }) {
+async function writePageJit({ page, context, tailwindContent }) {
     // Write page JSON
     await context.writeBuildArtifact(`pages/${page.pageId}.json`, serializer.serializeToString(page ?? {}));
     // Write page request JSONs
@@ -43,10 +42,14 @@ async function writePageJit({ page, context }) {
     await writeJs({
         context
     });
-    // Write per-page content file for Tailwind to scan class and property strings
-    const pageContent = collectPageContent([
-        page
-    ]);
-    await writeFile(path.join(context.directories.server, 'lowdefy-build', 'tailwind', `${encodeURIComponent(page.pageId)}.html`), '<!-- Generated by Lowdefy build -->\n' + (pageContent ?? ''));
+    // Write per-page content file for Tailwind to scan class and property strings.
+    // Content is collected by the caller before _js extraction so class
+    // candidates inside _js source are included. Skipping unchanged content lets
+    // the caller avoid touching the CSS recompilation trigger
+    // (tailwind-candidates.css) for builds that introduced no new class candidates.
+    const tailwindChanged = await writeFileIfChanged(path.join(context.directories.server, 'lowdefy-build', 'tailwind', `${encodeURIComponent(page.pageId)}.html`), '<!-- Generated by Lowdefy build -->\n' + (tailwindContent ?? ''));
+    return {
+        tailwindChanged
+    };
 }
 export default writePageJit;