@svgrid/enterprise 3.1.3 → 3.1.5

package/dist/studio/index.js

@@ -13,6 +13,7 @@ export { introspectDatabase, listDatabaseTables, countTableRows, probeConnection
 export { buildConnectionString, parseConnectionString, redactConnectionString, isFileDialect, DRIVER_PACKAGE, DEFAULT_PORT, } from './db-connect-string.js';
 export { scaffold, mergeManaged, skipUserOwned, MANAGED_START, MANAGED_END, } from './scaffold.js';
 export { scaffoldApp } from './scaffold-app.js';
+export { toSvelteKit3, SVELTEKIT_3_DEV_DEPENDENCIES, SVELTEKIT_3_ADAPTERS, } from './sveltekit3.js';
 export { emitStudioApp, emitEntityModules, entityScreenPage, prepareEntities } from './emit-schema.js';
 export { emitStudioProject, emitStudioAppBundle, emitStudioFragment, runtimeDeps, studioDeployInfo, screenHandles, screenDataset, ctxCompletions, componentHandleMembers, ctxAmbientDts, GRID_API_MEMBERS } from './emit-project.js';
 export { sampleApps, getSampleApp } from './samples/index.js';
@@ -28,7 +29,7 @@ export { studioThemes, defaultStudioTheme, getStudioTheme, resolveThemeTokens, r
 export { createProject, defaultScreenFor, defaultBlockConfig, gridColumns, entityOf, blockPalette, addBlock, addBlockAt, addComponentBlock, removeBlock, duplicateBlock, moveBlock, reorderBlock, updateBlock, addEntity, removeEntity, updateEntity, 
 // Form layout: the operations a form builder drives, on the entity's own
 // `form` so a built form travels with the entity rather than with one block.
-formPlan, setEntityForm, setFormColumns, addFormSection, updateFormSection, removeFormSection, moveFormSection, moveFormField, moveFormFields, setFieldConditions, updateEntityField, setFieldInput, setFieldHidden, formControlsFor, formControlSettings, suggestFormSections, addScreen, addFreestandingScreen, addScreenAction, removeScreenAction, enableScreenCode, disableScreenCode, setScreenRenderGrid, screenLayoutOf, buildDockLayout, reconcileDock, syncDockPanes, setScreenLayout, isPaneLayout, PANE_LAYOUTS, buildCanvasLayout, canvasRectOf, setCanvasRect, CANVAS_COLS, CANVAS_ROW_PX, CANVAS_GAP_PX, applyGridPreset, gridPresetLabel, GRID_PRESETS, setScreenDock, reseedScreenDock, setDockPaneTitle, dockPaneTitleOf, dockPaneIds, setLayoutOpts, gridOpts, stackOpts, splitOpts, dockOpts, canvasOpts, setHandlerBody, setScreenHandlersSource, setHandlerSteps, addHandlerStep, updateHandlerStep, moveHandlerStep, stepsToCode, compileStep, compileHandlerSteps, compileValue, compileCondition, compileTriggerStep, compileTriggerSteps, triggersOf, setTrigger, TRIGGER_EVENTS, setJob, setTenancy, tenantField, isTenantScoped, clickSlot, ssrScreenShape, ssrEligible, withSsrDefaults, setScreenRenderMode, eventSlot, rowSelectSlot, changeSlot, FORM_SUBMIT, GRID_EVENTS, addStateVar, updateStateVar, removeStateVar, stateInitExpr, stateTsType, setComponentName, setComponentBinding, componentHasBindings, componentHandleName, ON_LOAD, removeScreen, updateScreen, duplicateScreen, reorderScreen, insertBlock, setDataSource, setDeployTarget, setAuth, setDataLayer, seedUsers, defaultEntitySource, flattenBlocks, TAB_CHILD_KINDS, CONTAINER_CHILD_KINDS, CONTAINER_DISPLAY_KINDS, addTab, removeTab, renameTab, addTabBlock, addTabComponent, removeTabBlock, addAccordionSection, removeAccordionSection, renameAccordionSection, setAccordionMultiple, addAccordionBlock, addAccordionComponent, removeAccordionBlock, setEntityDataSource, entityDataSource, setTheme, setThemePreset, setShell, sanitizeProject, screenFromTemplate, addScreenFromTemplate, serializeProject, parseProject, validateProject, isProjectValid, blockColumns, blockStyleCss, blockClassName, sanitizeClassName, mergeBlockStyle, roleCanScreen, roleCanAction, CRUD_ACTIONS, } from './project.js';
+formPlan, setEntityForm, setFormColumns, addFormSection, updateFormSection, removeFormSection, moveFormSection, moveFormField, moveFormFields, setFieldConditions, updateEntityField, setFieldInput, setFieldHidden, formControlsFor, formControlSettings, suggestFormSections, addScreen, addFreestandingScreen, addScreenAction, removeScreenAction, enableScreenCode, disableScreenCode, setScreenRenderGrid, screenLayoutOf, buildDockLayout, reconcileDock, syncDockPanes, setScreenLayout, isPaneLayout, PANE_LAYOUTS, buildCanvasLayout, canvasRectOf, setCanvasRect, CANVAS_COLS, CANVAS_ROW_PX, CANVAS_GAP_PX, applyGridPreset, gridPresetLabel, GRID_PRESETS, setScreenDock, reseedScreenDock, setDockPaneTitle, dockPaneTitleOf, dockPaneIds, setLayoutOpts, gridOpts, stackOpts, splitOpts, dockOpts, canvasOpts, setHandlerBody, setScreenHandlersSource, setHandlerSteps, addHandlerStep, updateHandlerStep, moveHandlerStep, stepsToCode, compileStep, compileHandlerSteps, compileValue, compileCondition, compileTriggerStep, compileTriggerSteps, triggersOf, setTrigger, TRIGGER_EVENTS, setJob, setTenancy, tenantField, isTenantScoped, clickSlot, ssrScreenShape, ssrEligible, withSsrDefaults, setScreenRenderMode, eventSlot, rowSelectSlot, changeSlot, FORM_SUBMIT, GRID_EVENTS, addStateVar, updateStateVar, removeStateVar, stateInitExpr, stateTsType, setComponentName, setComponentBinding, componentHasBindings, componentHandleName, ON_LOAD, removeScreen, updateScreen, duplicateScreen, reorderScreen, insertBlock, setDataSource, setDeployTarget, setKitVersion, setAuth, setDataLayer, seedUsers, defaultEntitySource, flattenBlocks, TAB_CHILD_KINDS, CONTAINER_CHILD_KINDS, CONTAINER_DISPLAY_KINDS, addTab, removeTab, renameTab, addTabBlock, addTabComponent, removeTabBlock, addAccordionSection, removeAccordionSection, renameAccordionSection, setAccordionMultiple, addAccordionBlock, addAccordionComponent, removeAccordionBlock, setEntityDataSource, entityDataSource, setTheme, setThemePreset, setShell, sanitizeProject, screenFromTemplate, addScreenFromTemplate, serializeProject, parseProject, validateProject, isProjectValid, blockColumns, blockStyleCss, blockClassName, sanitizeClassName, mergeBlockStyle, roleCanScreen, roleCanAction, CRUD_ACTIONS, } from './project.js';
 export { verifyScaffold, summarizeVerify, } from './verify.js';
 export { UI_COMPONENT_REGISTRY, uiComponentSpec, gridPropSurface, gridApiSettableProps, gridIconGroups, GRID_CURATED_PROPS, STANDARD_UI_EVENTS, } from './ui-components.js';
 export { buildCopilotMessages, projectFromModelText } from './copilot-core.js';

package/dist/studio/init-flow.d.ts

@@ -40,6 +40,9 @@ export type InitFlags = {
     /** Theme preset id. */
     theme?: string;
     dark?: boolean;
+    /** SvelteKit major to target. 2 (the default) boots in StackBlitz; 3 needs
+     *  Vite 8, which does not run there yet. Saved into studio.config.json. */
+    kit?: 2 | 3;
     /** App title (skips the question). */
     title?: string;
     /** Take every default; ask nothing that has one. */

package/dist/studio/init-flow.js

@@ -10,7 +10,7 @@ import { emitStudioAppBundle } from './emit-project.js';
 import { mergeManaged, skipUserOwned } from './scaffold.js';
 import { getStudioTheme, studioThemes } from './themes.js';
 import { UserError } from './user-error.js';
-import { serializeProject } from './project.js';
+import { serializeProject, setKitVersion } from './project.js';
 const SOURCES = [
     { key: 'sample', label: 'Sample data', hint: 'a seeded pair of related tables - see a working app immediately' },
     { key: 'db', label: 'An existing database', hint: 'Postgres, MySQL, SQL Server or SQLite - reads your tables' },
@@ -465,7 +465,7 @@ export async function runStudioInit(flags, prompts, db, io, fetchText = null) {
     const title = flags.yes || flags.title ? defaultTitle : (await prompts.ask('\nApp name:', defaultTitle)).trim() || defaultTitle;
     const outDir = flags.out ?? (flags.yes ? '.' : (await prompts.ask('Write it where?', '.')).trim() || '.');
     await confirmTargetFolder(outDir, flags, prompts, io, outDir === candidateDir ? markersBefore : null);
-    const project = crudAppFromSchemas(data.schemas, {
+    const built = crudAppFromSchemas(data.schemas, {
         title,
         dataSource: data.kind,
         sources: data.sources,
@@ -474,6 +474,9 @@ export async function runStudioInit(flags, prompts, db, io, fetchText = null) {
         overviewDashboard: true,
         ...(theme ? { theme } : {}),
     });
+    // On the model, not only on this emit: studio.config.json is written from the
+    // same object below, so the designer reopens it as the same SvelteKit major.
+    const project = flags.kit === 3 ? setKitVersion(built, 3) : built;
     const files = emitStudioAppBundle(project);
     const written = await writeAll(files, outDir, io);
     // The design itself, so `svgrid-studio designer` reopens exactly this app.

package/dist/studio/project.d.ts

@@ -1003,6 +1003,11 @@ export type StudioProject = {
     /** Deploy target: picks the SvelteKit adapter + provider config the bundle emits.
      *  Defaults to `auto` (@sveltejs/adapter-auto, which detects Vercel/Netlify/Cloudflare). */
     deploy?: DeployTarget;
+    /** SvelteKit major the app targets. Absent means 2, the default: SvelteKit 3
+     *  needs Vite 8, whose Rolldown bundler does not run in StackBlitz's
+     *  WebContainer, so opting in trades that for v3. Saved in studio.config.json
+     *  so a v3 project is still v3 when it is reopened and regenerated. */
+    kit?: 3;
     /** Server-side business-rule triggers, keyed by entity name. Enforced on the
      *  SQL route (compiled into createKitHandlers `hooks`). */
     triggers?: Record<string, EntityTriggers>;
@@ -1076,7 +1081,8 @@ export declare function screenRenderMode(_project: StudioProject, screen: Screen
 export declare function ssrScreenShape(project: StudioProject, screen: Screen): 'grid' | 'read' | null;
 /** Whether a screen can be emitted as SSR-native (any supported shape). */
 export declare function ssrEligible(project: StudioProject, screen: Screen): boolean;
-/** Set a screen's render mode ('spa' clears back to the default). */
+/** Set a screen's render mode. Both modes are stored: a screen switched to
+ *  'spa' stays client-rendered even where `withSsrDefaults` would turn it on. */
 export declare function setScreenRenderMode(project: StudioProject, screenId: string, mode: 'ssr' | 'spa'): StudioProject;
 /** True when the screen should actually emit as SSR (mode is 'ssr' AND eligible). */
 export declare function isSsrScreen(project: StudioProject, screen: Screen): boolean;
@@ -1402,6 +1408,9 @@ export declare function duplicateScreen(project: StudioProject, screenId: string
 export declare function reorderScreen(project: StudioProject, screenId: string, toIndex: number): StudioProject;
 export declare function setDataSource(project: StudioProject, dataSource: DataSourceKind): StudioProject;
 /** Set the deploy target (SvelteKit adapter + provider config the bundle emits). */
+/** Target a SvelteKit major. 2 is the default and is stored as the field's
+ *  absence, the same way `deploy: 'auto'` is. */
+export declare function setKitVersion(project: StudioProject, kit: 2 | 3): StudioProject;
 export declare function setDeployTarget(project: StudioProject, deploy: DeployTarget): StudioProject;
 /** Enable / disable the authentication starter (login + session + hooks). */
 export declare function setAuth(project: StudioProject, patch: Partial<AuthConfig> & {

package/dist/studio/project.js

@@ -302,8 +302,8 @@ export function ssrScreenShape(project, screen) {
         return null;
     const source = project.dataSources?.[screen.entity];
     const kind = source?.kind ?? project.dataSource;
-    // memory runs the source in-process; sql reuses the connected /api route via
-    // event.fetch; rest calls the remote API straight from the server, which needs
+    // memory and sql both reuse the entity's /api route via event.fetch (memory's
+    // rows are held on the server behind it); rest calls the remote API straight from the server, which needs
     // an absolute URL to resolve there. (supabase and pglite stay SPA: pglite only
     // exists in the browser, and a Supabase read carries the signed-in user's token,
     // which a server-side call with the anon key would silently drop.)
@@ -334,11 +334,12 @@ export function ssrScreenShape(project, screen) {
 export function ssrEligible(project, screen) {
     return ssrScreenShape(project, screen) !== null;
 }
-/** Set a screen's render mode ('spa' clears back to the default). */
+/** Set a screen's render mode. Both modes are stored: a screen switched to
+ *  'spa' stays client-rendered even where `withSsrDefaults` would turn it on. */
 export function setScreenRenderMode(project, screenId, mode) {
     return {
         ...project,
-        screens: project.screens.map((s) => (s.id === screenId ? { ...s, renderMode: mode === 'ssr' ? 'ssr' : undefined } : s)),
+        screens: project.screens.map((s) => (s.id === screenId ? { ...s, renderMode: mode } : s)),
     };
 }
 /** True when the screen should actually emit as SSR (mode is 'ssr' AND eligible). */
@@ -346,19 +347,19 @@ export function isSsrScreen(project, screen) {
     return screenRenderMode(project, screen) === 'ssr' && ssrEligible(project, screen);
 }
 /**
- * Turn server rendering on for every screen that can support it, for entities
- * backed by a real database. Applied when a project is first generated, so a new
- * app reads as idiomatic SvelteKit (a `load` and form `actions`) rather than a
- * client SPA. Screens that already state a mode are left alone, so this never
- * overrides a choice somebody made.
+ * Turn server rendering on for every screen that can support it. Applied when a
+ * project is first generated, so a new app reads as idiomatic SvelteKit (a
+ * `load` and form `actions`) rather than a client SPA. Screens that already
+ * state a mode are left alone, so this never overrides a choice somebody made.
  *
- * Deliberately limited to sources that hold one copy of the data. In-memory and
- * PGlite sources are module singletons, so an SSR screen would read and write the
- * *server's* copy of the rows while the app's remaining SPA screens read the
- * browser's - create a row on one and the other never sees it. SQL and REST have
- * no such split: every path goes to the same database or the same remote API.
+ * Limited to sources that hold one copy of the data. SQL and REST always did:
+ * every path goes to the same database or the same remote API. In-memory rows
+ * are held once on the server ($lib/server/store) and every screen reaches them
+ * through the entity's /api route, so an SSR screen and an SPA screen see the
+ * same rows. PGlite lives in the browser's IndexedDB, which the server cannot
+ * read, so it stays client-rendered.
  */
-const SSR_DEFAULT_KINDS = new Set(['sql', 'rest']);
+const SSR_DEFAULT_KINDS = new Set(['sql', 'rest', 'memory']);
 export function withSsrDefaults(project) {
     return {
         ...project,
@@ -1805,6 +1806,15 @@ export function setDataSource(project, dataSource) {
     return { ...project, dataSource };
 }
 /** Set the deploy target (SvelteKit adapter + provider config the bundle emits). */
+/** Target a SvelteKit major. 2 is the default and is stored as the field's
+ *  absence, the same way `deploy: 'auto'` is. */
+export function setKitVersion(project, kit) {
+    if (kit === 2) {
+        const { kit: _drop, ...rest } = project;
+        return rest;
+    }
+    return { ...project, kit: 3 };
+}
 export function setDeployTarget(project, deploy) {
     if (deploy === 'auto') {
         const { deploy: _drop, ...rest } = project;
@@ -2034,6 +2044,9 @@ export function parseProject(json) {
         ...(typeof p.audit === 'boolean' ? { audit: p.audit } : {}),
         ...(p.i18n && typeof p.i18n === 'object' ? { i18n: p.i18n } : {}),
         ...(typeof p.deploy === 'string' && p.deploy !== 'auto' ? { deploy: p.deploy } : {}),
+        // Without this a SvelteKit 3 project reopened in the designer would quietly
+        // regenerate as SvelteKit 2: parseProject keeps only the fields it lists.
+        ...(p.kit === 3 ? { kit: 3 } : {}),
         ...(p.triggers && typeof p.triggers === 'object' ? { triggers: p.triggers } : {}),
     });
 }

package/dist/studio/samples/restaurant.js

@@ -166,7 +166,7 @@ export const restaurant = {
                 ]),
                 // Resource scheduler: a column per table, reservations placed by time + tinted by
                 // status, drag-to-reassign a table + a detail drawer (day view). Was a month calendar.
-                schedulerScreen(orders, { id: 'reservations', title: 'Reservations', order: 2 }, { startField: 'reservationTime', titleField: 'name', colorField: 'status', resourceField: 'tableId', initialView: 'day' }),
+                schedulerScreen(orders, { id: 'reservations', title: 'Reservations', order: 2 }, { startField: 'reservationTime', titleField: 'customerPhone', colorField: 'status', resourceField: 'tableId', initialView: 'day' }),
                 detailScreen(tables, { id: 'table-detail', title: 'Table detail', order: 3 }, {
                     titleField: 'name', statusField: 'section', metricFields: ['seats'],
                     related: [{ entity: 'orders', foreignKey: 'tableId', label: 'Orders', titleField: 'customerPhone', subtitleField: 'total', dateField: 'reservationTime', statusField: 'status' }],

package/dist/studio/sveltekit3.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Turn a generated SvelteKit 2 app into a SvelteKit 3 app.
+ *
+ * SvelteKit 3 shipped on 2026-10-01. It requires Vite 8, and Vite 8's Rolldown
+ * bundler crashes inside StackBlitz's WebContainer ("Invalid atomic access
+ * index", webcontainer-core #2105 / #2107), which is why the Studio's default
+ * stays on SvelteKit 2 + Vite 7 (see the pin in packageJson()). A project opts
+ * in with `kit: 3` and gets this conversion on top of the normal emit.
+ *
+ * It is a transform over the finished file set rather than a flag threaded
+ * through every emitter, for two reasons. The SvelteKit 2 output stays byte for
+ * byte what it was, so the default carries no risk from this change. And the
+ * official `npx sv migrate sveltekit-3` is the oracle: it was run on a
+ * Studio-generated app, and every rewrite below reproduces what it did there,
+ * checked against SvelteKit 3's own type definitions where its docs and its
+ * types disagreed (they do on `json`, which is deprecated, not removed).
+ *
+ * What the migrator could not decide for us, and what was decided instead:
+ *  - env vars must be declared in `src/env.ts`. The migrator's default schema
+ *    falls back to '' and flags it for review. Every read in the generated app
+ *    already handles a missing value (`|| 'dev-insecure-...'`, `?? ''`,
+ *    `if (env.X)`), so '' is the right fallback and is stated here, not flagged.
+ *  - `drizzle.config.ts` keeps `process.env`: drizzle-kit runs outside Vite,
+ *    where `$app/env` does not exist. Only `env.X` (no `process.`) is rewritten.
+ */
+import type { GeneratedFile } from './scaffold.js';
+/** Toolchain SvelteKit 3 requires. Minimums are from the v3 migration guide. */
+export declare const SVELTEKIT_3_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
+/**
+ * The first major of each adapter whose peerDependency is `@sveltejs/kit ^3`,
+ * read from npm on 2026-10-08. None of the v3 adapter behaviour changes (node's
+ * ORIGIN, vercel's edge runtime, cloudflare's platform APIs) reach Studio
+ * output, so this is a version bump only.
+ */
+export declare const SVELTEKIT_3_ADAPTERS: Readonly<Record<string, string>>;
+/** Every major version of SvelteKit the Studio can emit. */
+export type KitVersion = 2 | 3;
+export declare function toSvelteKit3(files: readonly GeneratedFile[]): GeneratedFile[];

package/dist/studio/sveltekit3.js

@@ -0,0 +1,194 @@
+/** Toolchain SvelteKit 3 requires. Minimums are from the v3 migration guide. */
+export const SVELTEKIT_3_DEV_DEPENDENCIES = {
+    '@sveltejs/kit': '^3.0.0',
+    '@sveltejs/vite-plugin-svelte': '^7.0.0',
+    svelte: '^5.57.1',
+    'svelte-check': '^4.7.5',
+    typescript: '^6.0.0',
+    vite: '^8.0.12',
+};
+/**
+ * The first major of each adapter whose peerDependency is `@sveltejs/kit ^3`,
+ * read from npm on 2026-10-08. None of the v3 adapter behaviour changes (node's
+ * ORIGIN, vercel's edge runtime, cloudflare's platform APIs) reach Studio
+ * output, so this is a version bump only.
+ */
+export const SVELTEKIT_3_ADAPTERS = {
+    '@sveltejs/adapter-auto': '^8.0.0',
+    '@sveltejs/adapter-node': '^6.0.0',
+    '@sveltejs/adapter-vercel': '^7.0.0',
+    '@sveltejs/adapter-netlify': '^7.0.1',
+    '@sveltejs/adapter-cloudflare': '^8.0.0',
+};
+const SOURCE = /\.(ts|js|svelte)$/;
+export function toSvelteKit3(files) {
+    const paths = new Set(files.map((f) => f.path));
+    const adapter = adapterOf(files);
+    const envNames = new Set();
+    const out = [];
+    for (const file of files) {
+        // svelte.config.js is gone: its adapter and preprocess move into vite.config.ts.
+        if (file.path === 'svelte.config.js')
+            continue;
+        if (file.path === 'package.json') {
+            out.push({ ...file, contents: packageJson3(file.contents) });
+            continue;
+        }
+        if (file.path === 'vite.config.ts') {
+            out.push({ ...file, description: `Vite config, including SvelteKit (${adapter}).`, contents: viteConfig3(file.contents, adapter) });
+            continue;
+        }
+        if (file.path === 'tsconfig.json') {
+            out.push({ ...file, contents: TSCONFIG_3 });
+            continue;
+        }
+        if (SOURCE.test(file.path) && file.path !== 'drizzle.config.ts') {
+            const contents = rewriteSource(file.contents, paths, envNames);
+            out.push(contents === file.contents ? file : { ...file, contents });
+            continue;
+        }
+        out.push(file);
+    }
+    if (envNames.size)
+        out.push(envModule([...envNames].sort()));
+    return out;
+}
+/* ---------------------------------------------------------------- config */
+function adapterOf(files) {
+    const pkg = files.find((f) => f.path === 'package.json');
+    if (!pkg)
+        return '@sveltejs/adapter-auto';
+    const dev = (JSON.parse(pkg.contents).devDependencies ?? {});
+    return Object.keys(dev).find((k) => k.startsWith('@sveltejs/adapter-')) ?? '@sveltejs/adapter-auto';
+}
+function packageJson3(contents) {
+    const pkg = JSON.parse(contents);
+    const dev = { ...(pkg.devDependencies ?? {}) };
+    for (const [name, range] of Object.entries(SVELTEKIT_3_DEV_DEPENDENCIES))
+        dev[name] = range;
+    for (const name of Object.keys(dev))
+        if (SVELTEKIT_3_ADAPTERS[name])
+            dev[name] = SVELTEKIT_3_ADAPTERS[name];
+    pkg.devDependencies = dev;
+    // `#lib` is a standard subpath import now, so Node and every tool resolve it,
+    // not only Vite. `#lib` alone points at an index; `#lib/*` is the common case.
+    pkg.imports = { '#lib': './src/lib/index.js', '#lib/*': './src/lib/*' };
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+/**
+ * The v2 vite.config.ts with SvelteKit's config folded into the plugin call.
+ * Everything else in the file (the dev-server watch exclusions) is kept.
+ */
+function viteConfig3(v2, adapter) {
+    const imports = `import adapter from '${adapter}'\n` +
+        `import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'\n`;
+    const withPlugin = v2.replace('sveltekit()', 'sveltekit({ preprocess: vitePreprocess(), adapter: adapter() })');
+    if (withPlugin === v2)
+        throw new Error('toSvelteKit3: vite.config.ts has no sveltekit() call to configure');
+    return imports + withPlugin;
+}
+// `$app/tsconfig` replaces the generated ./.svelte-kit/tsconfig.json and brings
+// the compiler options that used to be listed here. Matches the migrator.
+const TSCONFIG_3 = `{
+  "extends": "$app/tsconfig",
+  "compilerOptions": {
+    "sourceMap": true,
+    "strict": true
+  },
+  "include": ["src", "vite.config.ts"]
+}
+`;
+/* --------------------------------------------------------------- sources */
+function rewriteSource(src, paths, envNames) {
+    let s = src;
+    s = rewriteLibImports(s, paths);
+    s = rewriteEnv(s, envNames);
+    s = rewriteKitImports(s);
+    // keepFocus + noScroll are removed. `reset: false` is defined in v3's types as
+    // "the current scroll position and focused element are left alone", which is
+    // exactly what the two of them did together.
+    s = s.replace(/\{\s*keepFocus:\s*true,\s*noScroll:\s*true\s*\}/g, '{ reset: false }');
+    // page.url is readonly in v3, so `page.url.searchParams` is a
+    // ReadonlyURLSearchParams, which the URLSearchParams constructor does not
+    // accept. The generated code only copies it, never mutates it, so copying
+    // from the query string is the same thing and type-checks on both majors.
+    // The official migrator lists this as a manual task; the server-sorted list
+    // screen hit it, and only `verify:app --all-paths` reaches that screen.
+    s = s.replace(/new URLSearchParams\(page\.url\.searchParams\)/g, 'new URLSearchParams(page.url.search)');
+    return s;
+}
+/**
+ * `$lib/x` -> `#lib/x.js`. Subpath imports need a real extension, and the right
+ * one depends on what the file actually is, so each specifier is resolved
+ * against the generated paths rather than guessed: `x.ts` and `x.svelte.ts`
+ * are imported as `.js` (TypeScript maps it back), anything already carrying
+ * its extension (`.svelte`, `.js`) is left as it is, and a directory resolves
+ * to its index.
+ */
+function rewriteLibImports(src, paths) {
+    return src.replace(/(['"`])\$lib\/([^'"`]+)\1/g, (whole, q, spec) => {
+        const base = `src/lib/${spec}`;
+        if (paths.has(base))
+            return `${q}#lib/${spec}${q}`;
+        if (paths.has(`${base}.ts`) || paths.has(`${base}.js`))
+            return `${q}#lib/${spec}.js${q}`;
+        if (paths.has(`${base}/index.ts`) || paths.has(`${base}/index.js`))
+            return `${q}#lib/${spec}/index.js${q}`;
+        // Not a file this app generated (a user-added module, or one emitted
+        // conditionally elsewhere). `.js` is what the migrator writes for a TS
+        // source, which is overwhelmingly the case in a Studio app.
+        return `${q}#lib/${spec}.js${q}`;
+    });
+}
+/**
+ * `import { env } from '$env/dynamic/private'` + `env.X`
+ *   -> `import { X } from '$app/env/private'` + `X`
+ * Every name read is collected so src/env.ts can declare it, which v3 requires.
+ */
+function rewriteEnv(src, envNames) {
+    if (!/from\s+['"]\$env\/dynamic\/private['"]/.test(src))
+        return src;
+    const used = new Set();
+    // `(?<![.\w])` keeps `process.env.X` untouched; only the imported `env` changes.
+    const body = src.replace(/(?<![.\w])env\.([A-Z_][A-Z0-9_]*)/g, (_m, name) => {
+        used.add(name);
+        return name;
+    });
+    for (const n of used)
+        envNames.add(n);
+    const names = [...used].sort();
+    return body.replace(/import\s*\{\s*env\s*\}\s*from\s*(['"])\$env\/dynamic\/private\1/, names.length ? `import { ${names.join(', ')} } from '$app/env/private'` : '');
+}
+/**
+ * Types that moved out of `@sveltejs/kit`, and the deprecated `json` helper.
+ * `fail`, `redirect` and `error` stay where they are.
+ */
+function rewriteKitImports(src) {
+    let s = src;
+    s = s.replace(/import\s+type\s*\{\s*Handle\s*\}\s*from\s*(['"])@sveltejs\/kit\1/g, `import type { Handle } from '@sveltejs/kit/hooks'`);
+    s = s.replace(/import\s+type\s*\{\s*SubmitFunction\s*\}\s*from\s*(['"])@sveltejs\/kit\1/g, `import type { SubmitFunction } from '$app/forms'`);
+    // json(...) -> Response.json(...): same (data, init) signature. Only when
+    // `json` really is the kit helper - a file importing it from somewhere else,
+    // or calling res.json(), is not touched.
+    const kitImport = /import\s*\{([^}]*)\}\s*from\s*(['"])@sveltejs\/kit\2/;
+    const names = (s.match(kitImport)?.[1] ?? '').split(',').map((x) => x.trim());
+    if (names.includes('json')) {
+        s = s.replace(/(?<![.\w])json\(/g, 'Response.json(');
+        const rest = names.filter((x) => x && x !== 'json');
+        s = s.replace(kitImport, rest.length ? `import { ${rest.join(', ')} } from '@sveltejs/kit'` : '');
+    }
+    return s;
+}
+/* ------------------------------------------------------------------- env */
+function envModule(names) {
+    const decls = names.map((n) => `  ${n}: { schema: (input) => input ?? '' },`).join('\n');
+    return {
+        path: 'src/env.ts',
+        description: 'Environment variables the app reads (SvelteKit 3 requires declaring them).',
+        contents: `import { defineEnvVars } from '@sveltejs/kit/env'\n\n` +
+            `// SvelteKit 3 reads only the variables declared here. A missing one comes\n` +
+            `// through as '' - every read in this app already falls back on that\n` +
+            `// (a dev default, '?? ""', or an if), so that is the intended behaviour.\n` +
+            `export const variables = defineEnvVars({\n${decls}\n})\n`,
+    };
+}

package/dist/studio/ui-components.generated.js

@@ -6943,14 +6943,14 @@ export const GENERATED_UI_SURFACE = {
                 "key": "columnVirtualization",
                 "label": "Column Virtualization",
                 "type": "boolean",
-                "description": "Render only the columns in view, the horizontal counterpart of `virtualization`. **On by default**, which is what makes a 100-column grid scroll smoothly. It recycles column DOM nodes, so it cannot coexist with sticky pinned columns - turn it off if you need pinning to survive horizontal scrolling.",
+                "description": "Render only the columns in view, the horizontal counterpart of `virtualization`. **On by default**, which is what makes a 100-column grid scroll smoothly. Pinned columns stay rendered while it is on: the pinned-left and pinned-right columns are drawn as their own runs either side of the virtual window, so a wide grid with pinned edges still renders only the columns in view plus the pinned ones.",
                 "group": "common"
             },
             {
                 "key": "columnOverscan",
                 "label": "Column Overscan",
                 "type": "number",
-                "description": "Extra columns rendered either side of the viewport when `columnVirtualization` is on. Defaults to 3.",
+                "description": "Columns kept rendered beyond the viewport when `columnVirtualization` is on: this many ahead of a horizontal scroll at all times, one behind it. The rendered columns move three at a time, so right after a move up to `columnOverscan + 2` are rendered ahead. Defaults to 3.",
                 "group": "common"
             },
             {
@@ -6964,7 +6964,7 @@ export const GENERATED_UI_SURFACE = {
                 "key": "initialColumnPinning",
                 "label": "Initial Column Pinning",
                 "type": "json",
-                "description": "Columns pinned to the left/right edge on mount. Each entry is a column id (matches `ColumnDef.field` when no explicit id is set). The internal pinning state is seeded once at mount; user-driven pinning via the column menu still works and overrides this default. Requires `columnVirtualization={false}` to be visible in the menu UI (sticky positioning can't co-exist with column virtualization since the virtualizer recycles DOM nodes).",
+                "description": "Columns pinned to the left/right edge on mount. Each entry is a column id (matches `ColumnDef.field` when no explicit id is set). The internal pinning state is seeded once at mount; user-driven pinning via the column menu still works and overrides this default. Works with column virtualization on (the default).",
                 "group": "common"
             },
             {
@@ -7245,7 +7245,7 @@ export const GENERATED_UI_SURFACE = {
                 "key": "conditionalFormats",
                 "label": "Conditional Formats",
                 "type": "json",
-                "description": "Excel-style conditional formatting. A list of value-driven rules that color cells: `colorScale` (gradient across the column range), `dataBar` (in-cell proportional bar), `iconSet` (arrows / traffic / triangles by threshold), and `rule` (apply a style when a predicate matches). Scope a format to specific columns with `columns: [...]`, or omit it to apply to every column. Later entries win on conflict.",
+                "description": "Excel-style conditional formatting. A list of value-driven rules that color cells: `colorScale` (gradient across the column range), `dataBar` (in-cell proportional bar), `iconSet` (arrows / traffic / triangles by threshold), and `rule` (apply a style when a predicate matches). Scope a format to specific columns with `columns: [...]`, or omit it to apply to every column. Later entries win on conflict. `colorScale` and `dataBar` apply to data rows only: group, footer and grand-total rows carry subtotals on a different scale, so they keep the `rule` and `iconSet` formats and drop the scaled ones. On a server row model, give scaled formats `minValue` / `maxValue`; the grid does not scan rows it has not loaded for a range.",
                 "group": "common"
             },
             {
@@ -7369,6 +7369,17 @@ export const GENERATED_UI_SURFACE = {
                 "description": "Merged cells: rectangles drawn as one cell, a spreadsheet's Merge & Center. Each entry is the top-left cell (display indices) and how many rows and columns it covers. The origin's td takes the span and shows the origin's value; the covered cells are not drawn, a selection grows to whole merges, the active cell inside a merge is its origin, and the arrow keys step over a merge as one cell. A merge that crosses the frozen boundary or the rendered window is drawn in parts, one per band. The grid does not write into covered cells on its own; a consumer that merges cells keeps them empty or marks them read-only through the column's `editable`.",
                 "group": "common"
             },
+            {
+                "key": "rowLayout",
+                "label": "Row Layout",
+                "type": "select",
+                "options": [
+                    "flex",
+                    "table"
+                ],
+                "description": "How rows are laid out. `'flex'` (the default) draws each row as a line of fixed-width cells, so adding or removing cells in one row - what a horizontal scroll does every frame - lays out that row only. `'table'` uses the HTML table algorithm, which re-lays every row on such a change but can draw a merged cell spanning rows; the grid switches to it on its own when `mergedCells` has one.",
+                "group": "common"
+            },
             {
                 "key": "pinnedBottomRows",
                 "label": "Pinned Bottom Rows",

package/dist/upgrade-prompt.js

@@ -16,6 +16,7 @@
 //   - SSR-safe: every DOM access is guarded. On the server it's a no-op.
 //   - Zero dependencies, inline styles - no CSS file to import, nothing to
 //     bundle, works in any host app regardless of its styling.
+import { isFirstPartySite } from './first-party.js';
 const CARD_ATTR = 'data-svgrid-enterprise-upgrade';
 const PRICING_URL = 'https://svgrid.com/pricing';
 // ?ref=in-app lets us measure how many trials start from this exact prompt
@@ -32,6 +33,8 @@ export function showUpgradePrompt(feature, opts) {
         return;
     if (typeof document === 'undefined' || typeof window === 'undefined')
         return;
+    if (isFirstPartySite())
+        return;
     if (document.querySelector(`[${CARD_ATTR}]`))
         return;
     shownThisSession = true;

package/dist/version.d.ts

@@ -10,7 +10,7 @@
  *
  * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
  */
-export declare const SVGRID_VERSION = "3.1.3";
+export declare const SVGRID_VERSION = "3.1.5";
 /**
  * The version of `@svgrid/grid`, which releases on its own line: enterprise is
  * on 3.1.x while the grid is on 3.0.x.
@@ -23,4 +23,4 @@ export declare const SVGRID_VERSION = "3.1.3";
  *
  * `version.test.ts` asserts this matches packages/grid/package.json.
  */
-export declare const GRID_VERSION = "3.0.8";
+export declare const GRID_VERSION = "3.0.9";

package/dist/version.js

@@ -10,7 +10,7 @@
  *
  * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
  */
-export const SVGRID_VERSION = '3.1.3';
+export const SVGRID_VERSION = '3.1.5';
 /**
  * The version of `@svgrid/grid`, which releases on its own line: enterprise is
  * on 3.1.x while the grid is on 3.0.x.
@@ -23,4 +23,4 @@ export const SVGRID_VERSION = '3.1.3';
  *
  * `version.test.ts` asserts this matches packages/grid/package.json.
  */
-export const GRID_VERSION = '3.0.8';
+export const GRID_VERSION = '3.0.9';

package/dist/watermark.js

@@ -1,9 +1,10 @@
 // Evaluation UX for unlicensed @svgrid/enterprise use. Shows a small clickable
 // "www.svgrid.com" watermark in the bottom-right corner of every SvGrid on
 // the page, which fades out after 5 seconds, and emits a one-time console
-// nudge. Hard errors (revoked / bad-prefix keys) still throw via license.ts -
-// this file is only for the "no key set" case where the feature continues to
-// work but the user gets nudged.
+// nudge. Shown for "no key" and for a key that is not the license key alike;
+// neither throws, the feature keeps working and the user gets nudged. Never
+// shown on svgrid.com itself (first-party.ts).
+import { isFirstPartySite } from './first-party.js';
 const WATERMARK_ATTR = 'data-svgrid-enterprise-watermark';
 // Marks a grid that has already shown (and faded) its watermark, so the
 // MutationObserver doesn't re-add it once it fades out and is removed.
@@ -21,6 +22,8 @@ const FADE_MS = 700;
 let consoleNudgeShown = false;
 let observer = null;
 export function emitUnlicensedNudge() {
+    if (isFirstPartySite())
+        return;
     showConsoleOnce();
     if (typeof document === 'undefined' || typeof window === 'undefined')
         return;
@@ -29,10 +32,40 @@ export function emitUnlicensedNudge() {
     queueMicrotask(() => attachToAllGrids());
     // Watch for grids that mount later (route changes, dynamic loads).
     if (!observer) {
-        observer = new MutationObserver(() => attachToAllGrids());
+        observer = new MutationObserver(onMutations);
         observer.observe(document.body, { childList: true, subtree: true });
     }
 }
+/**
+ * The observer sees every DOM change on the page, and a scrolling grid
+ * changes the DOM every frame (cells in, cells out). Changes inside a grid
+ * that already has its watermark cannot add a grid, so they are skipped, and
+ * the rest wait for one check per frame instead of a document-wide query per
+ * mutation batch - which had made an unlicensed grid scroll measurably slower.
+ */
+let checkScheduled = false;
+function onMutations(records) {
+    for (const record of records) {
+        const target = record.target;
+        if (target.nodeType === 1 && target.closest?.(`.sv-grid-root[${NUDGED_ATTR}]`))
+            continue;
+        scheduleCheck();
+        return;
+    }
+}
+function scheduleCheck() {
+    if (checkScheduled)
+        return;
+    checkScheduled = true;
+    const run = () => {
+        checkScheduled = false;
+        attachToAllGrids();
+    };
+    if (typeof requestAnimationFrame === 'function')
+        requestAnimationFrame(run);
+    else
+        setTimeout(run, 16);
+}
 export function dismissUnlicensedNudge() {
     if (observer) {
         observer.disconnect();