@svgrid/enterprise 3.1.0 → 3.1.1

package/dist/node/studio.js

@@ -1721,7 +1721,8 @@ ${managed$1(serverBody)}
 	const pageBody = `  const source = createKitDataSource<${rowType}>({ endpoint: '${apiRoute}' })
   const columns = schemaToColumns(${constName})${hasLookups ? `\n\n${lookupDecls}\n${lookupsMap}` : ""}
 
-  let state = $state<ServerState<${rowType}>>({
+  // Not "state": a local of that name makes svelte-check read $state as a store of it.
+  let view = $state<ServerState<${rowType}>>({
     rows: [], total: 0, loading: false, saving: false, error: null,
     pageIndex: 0, pageSize: 25, pageCount: 1, sortModel: [], filterModel: {},
   })
@@ -1729,7 +1730,7 @@ ${managed$1(serverBody)}
     pageSize: 25,
     optimistic: true,
     getRowId: (r) => String(r.${idField}),
-    onChange: (s) => (state = s),
+    onChange: (s) => (view = s),
   })
   controller.refresh()
 
@@ -1739,7 +1740,7 @@ ${managed$1(serverBody)}
   async function save({ mode, id, values }: { mode: 'create' | 'edit'; id: string | null; values: Partial<${rowType}> }) {
     if (mode === 'create') {
       await controller.createRow(values)
-      controller.setPage(state.pageCount - 1) // jump to the new row (appended at the end)
+      controller.setPage(view.pageCount - 1) // jump to the new row (appended at the end)
     } else if (id) {
       await controller.updateRow(id, values)
     }
@@ -1757,12 +1758,11 @@ ${managed$1(serverBody)}
 			path: `src/routes/${route}/+page.svelte`,
 			description: "The data screen: sort, filter, search, paging, multi-select delete, and create/edit - wired to the API route.",
 			contents: `<script lang="ts">
-  import { SvGrid, createServerDataSource } from '@svgrid/grid'
+  import { SvGrid, createServerDataSource, type ServerState } from '@svgrid/grid'
   import {
     SvGridEditPanel,
     createKitDataSource,${hasLookups ? "\n    createRelationLookup," : ""}
     schemaToColumns,
-    type ServerState,
   } from '@svgrid/enterprise'
   import { ${constName}, type ${rowType} } from '${schemaImport}'
 
@@ -1787,12 +1787,12 @@ ${themeTokenCss({
     </div>
   </header>
 
-  {#if state.error}<p class="page__error" role="alert">{state.error}</p>{/if}
+  {#if view.error}<p class="page__error" role="alert">{view.error}</p>{/if}
 
   <SvGrid
-    data={state.rows}
+    data={view.rows}
     {columns}
-    loading={state.loading}
+    loading={view.loading}
     loadingOverlay
     fitColumns
     enableRowSummaries={false}
@@ -1815,11 +1815,11 @@ ${themeTokenCss({
     onRowSelectionChange={(_sel, rows) => (selected = rows)}
     showPagination
     externalPagination
-    rowCount={state.total}
-    pageIndex={state.pageIndex}
-    pageSize={state.pageSize}
+    rowCount={view.total}
+    pageIndex={view.pageIndex}
+    pageSize={view.pageSize}
     onPaginationChange={({ pageIndex, pageSize }) => {
-      if (pageSize !== state.pageSize) controller.setPageSize(pageSize)
+      if (pageSize !== view.pageSize) controller.setPageSize(pageSize)
       else controller.setPage(pageIndex)
     }}
     emptyMessage="No ${label} yet"
@@ -1851,6 +1851,7 @@ ${themeTokenCss({
 */
 function mergeManaged(existing, generated) {
 	if (!existing) return generated;
+	existing = migrateStateLocal(existing);
 	const startIdx = existing.indexOf(MANAGED_START);
 	const endIdx = existing.indexOf(MANAGED_END);
 	if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) return generated;
@@ -1860,6 +1861,21 @@ function mergeManaged(existing, generated) {
 	const newRegion = generated.slice(genStart, genEnd + 21);
 	return existing.slice(0, startIdx) + newRegion + existing.slice(endIdx + 21);
 }
+/** The managed line pages scaffolded before the rename carried. */
+var OLD_STATE_LOCAL = /\blet state = \$state<ServerState</;
+/**
+* Pages scaffolded before the rename kept their server state in a local named
+* `state`, which svelte-check reads as a store subscription whenever `$state`
+* appears. The managed region now calls it `view`, but the markup below the
+* region is the user's and still says `state.rows`; a plain merge would leave it
+* pointing at nothing. Rename the references too. Nothing else in such a page
+* could be called `state` (the old local would have clashed), and member reads
+* like `page.state` are skipped.
+*/
+function migrateStateLocal(existing) {
+	if (!OLD_STATE_LOCAL.test(existing)) return existing;
+	return existing.replace(/(?<![.\w$])state(?=\s*[.?[]|\s*=[^=>])/g, "view");
+}
 //#endregion
 //#region src/studio/scaffold-app.ts
 /**
@@ -1875,12 +1891,12 @@ function mergeManaged(existing, generated) {
 */
 var MANAGED_NOTE = "// Regenerated by SvGrid Studio. Edits inside these markers are overwritten.";
 var managed = (body) => `${MANAGED_START}\n${MANAGED_NOTE}\n${body}\n${MANAGED_END}`;
-function layoutFile$1(nav, appTitle, theme) {
+function layoutFile$1(nav, appTitle, theme, stylesheets) {
 	return {
 		path: "src/routes/+layout.svelte",
 		description: "App shell: a collapsible nav sidebar linking every entity screen (an off-canvas drawer on tablet/phone), with the routed page in the main area.",
 		contents: `<script lang="ts">
-${managed(`  let { children } = $props()
+${managed(`${stylesheets.map((css) => `  import '../${css}'\n`).join("")}  let { children } = $props()
   const appTitle = ${JSON.stringify(appTitle)}
   const nav = ${JSON.stringify(nav)}
 
@@ -2003,10 +2019,11 @@ function scaffoldApp(schemas, options = {}) {
 		href: `/${s.name}`,
 		label: s.label ?? titleCase$2(s.name)
 	}));
-	files.push(layoutFile$1(nav, appTitle, {
+	const theme = {
 		preset: options.theme,
 		mode: options.dark ? "dark" : "light"
-	}), homeFile$1(nav, appTitle));
+	};
+	files.push(layoutFile$1(nav, appTitle, theme, options.stylesheets ?? []), homeFile$1(nav, appTitle));
 	return { files };
 }
 //#endregion
@@ -16028,7 +16045,7 @@ function hasFieldConditions(schema) {
 *
 * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
 */
-var SVGRID_VERSION = "3.1.0";
+var SVGRID_VERSION = "3.1.1";
 //#endregion
 //#region src/studio/emit-project.ts
 var has = (blocks, kind) => blocks.some((b) => b.config.kind === kind);
@@ -40702,6 +40719,153 @@ function getStarterDataset(id) {
 	return starterDatasets.find((d) => d.id === id);
 }
 //#endregion
+//#region src/studio/verify.ts
+async function verifyScaffold(files) {
+	const issues = [];
+	let checked = 0;
+	let skipped = 0;
+	let compile;
+	try {
+		compile = (await import("svelte/compiler")).compile;
+	} catch {
+		compile = void 0;
+	}
+	for (const file of files) {
+		if (!file.path.endsWith(".svelte") || !compile) {
+			skipped++;
+			continue;
+		}
+		try {
+			const { warnings } = compile(file.contents, {
+				filename: file.path,
+				generate: "client"
+			});
+			checked++;
+			for (const w of warnings) issues.push({
+				path: file.path,
+				severity: "warning",
+				message: w.message ?? "warning"
+			});
+		} catch (err) {
+			checked++;
+			issues.push({
+				path: file.path,
+				severity: "error",
+				message: err instanceof Error ? err.message : String(err)
+			});
+		}
+	}
+	return {
+		ok: !issues.some((i) => i.severity === "error"),
+		issues,
+		checked,
+		skipped
+	};
+}
+/** One-line human summary of a verify result, for tool output / logs. */
+function summarizeVerify(result) {
+	if (result.checked === 0) return "verification skipped (Svelte compiler unavailable) - run svelte-check in your project.";
+	const errors = result.issues.filter((i) => i.severity === "error");
+	if (errors.length === 0) return `verified: ${result.checked} file(s) compile.`;
+	return `VERIFICATION FAILED (${errors.length} error(s)):\n` + errors.map((e) => `  ${e.path}: ${e.message}`).join("\n");
+}
+//#endregion
+//#region src/studio/cli.ts
+/** A `.prisma` file (by extension or a `model X {` block) parses as Prisma; otherwise Drizzle. */
+function isPrismaSource(path, source) {
+	return /\.prisma$/i.test(path) || /\bmodel\s+\w+\s*\{/.test(source);
+}
+/** Resolve an EntitySchema from whichever input was provided. */
+async function resolveSchema(options, io) {
+	if (options.schema) return options.schema;
+	if (options.from) {
+		const src = await io.readFile(options.from);
+		if (src == null) throw new Error(`runStudioAdd: schema file not found: ${options.from}`);
+		return isPrismaSource(options.from, src) ? introspectPrisma(src, options.table) : introspectDrizzle(src, options.table);
+	}
+	if (options.rows) return introspectJson(options.name ?? options.route ?? "entity", options.rows);
+	throw new Error("runStudioAdd: provide `from` (a Drizzle or Prisma schema file), `rows`, or `schema`");
+}
+/**
+* Resolve **every** entity from a Drizzle or Prisma schema file (the `--all
+* --from` path), linked so foreign keys become working relation lookups.
+*/
+async function resolveSchemas(from, io) {
+	const src = await io.readFile(from);
+	if (src == null) throw new Error(`runStudioAddApp: schema file not found: ${from}`);
+	return isPrismaSource(from, src) ? introspectPrismaAll(src) : introspectDrizzleAll(src);
+}
+/** Merge-write a set of generated files, preserving user edits outside managed regions. */
+async function writeAll$1(files, io) {
+	const written = [];
+	for (const file of files) {
+		const existing = await io.readFile(file.path);
+		if (skipUserOwned(file, existing != null)) continue;
+		await io.writeFile(file.path, mergeManaged(existing, file.contents));
+		written.push(file.path);
+	}
+	return written;
+}
+async function runStudioAdd(options, io) {
+	const schema = await resolveSchema(options, io);
+	const { files } = scaffold(schema, options);
+	return {
+		schema,
+		written: await writeAll$1(files, io),
+		verify: await verifyScaffold(files)
+	};
+}
+/** The stylesheets an `init`-generated layout imports, in cascade order. */
+var APP_STYLESHEETS = ["app.css", "custom.css"];
+/**
+* Fill the app-shell options the caller left out from the app already on disk,
+* so `add --all` in a folder `init` generated keeps its stylesheets, title and
+* theme. The shell layout from `init` carries no managed markers, so the merge
+* write replaces it whole; anything it imported or named has to be carried
+* over here or it is lost.
+*
+* Title: studio.config.json (shell brand, then title), else the `appTitle`
+* constant of a layout an earlier `add --all` wrote.
+*/
+async function appShellDefaults(options, io) {
+	const stylesheets = options.stylesheets ?? [];
+	if (!options.stylesheets) {
+		for (const css of APP_STYLESHEETS) if (await io.readFile(`src/${css}`) != null) stylesheets.push(css);
+	}
+	let title;
+	let theme;
+	const config = await io.readFile("studio.config.json");
+	if (config != null) try {
+		const parsed = JSON.parse(config);
+		theme = parsed.theme;
+		title = (typeof theme?.shell?.brand === "string" ? theme.shell.brand.trim() : "") || (typeof parsed.title === "string" ? parsed.title : void 0);
+	} catch {}
+	if (!title) {
+		const m = (await io.readFile("src/routes/+layout.svelte"))?.match(/const appTitle = ("(?:[^"\\]|\\.)*")/);
+		if (m) try {
+			title = JSON.parse(m[1]);
+		} catch {}
+	}
+	return {
+		...options,
+		stylesheets,
+		...options.appTitle == null && title ? { appTitle: title } : {},
+		...options.theme == null && typeof theme?.preset === "string" ? { theme: theme.preset } : {},
+		...options.dark == null && theme?.mode === "dark" ? { dark: true } : {}
+	};
+}
+/**
+* Scaffold a whole multi-entity app - every entity's screen plus a nav layout
+* and home page - and merge-write it. The `--all` path behind `svgrid-studio`.
+*/
+async function runStudioAddApp(schemas, options, io) {
+	const { files } = scaffoldApp(schemas, await appShellDefaults(options, io));
+	return {
+		written: await writeAll$1(files, io),
+		verify: await verifyScaffold(files)
+	};
+}
+//#endregion
 //#region src/sources/introspect-supabase.ts
 var mapOpenApiType = (prop) => {
 	if (Array.isArray(prop.enum)) return "enum";
@@ -40966,7 +41130,8 @@ function unwrapRows(body) {
 	return [];
 }
 /** Step 1-2: where does the data come from, and what tables does it have? */
-async function gatherData(flags, prompts, db, fetchText) {
+async function gatherData(flags, prompts, db, fetchText, io) {
+	if (flags.from) return gatherFromSchemaFile(flags, flags.from, prompts, io);
 	let source = "sample";
 	if (flags.db) source = "db";
 	else if (flags.supabaseUrl) source = "supabase";
@@ -40998,6 +41163,41 @@ async function gatherData(flags, prompts, db, fetchText) {
 		title: dataset.name
 	};
 }
+/**
+* A schema file names the tables and columns but holds no rows and no
+* connection, so the app runs on the in-memory source and the emitter seeds it
+* with sample rows. `--db` + `--url` is the path to a live database.
+*/
+async function gatherFromSchemaFile(flags, from, prompts, io) {
+	const clash = flags.db ? "--db" : flags.supabaseUrl ? "--supabase-url" : flags.dataset ? "--dataset" : null;
+	if (clash) throw new UserError(`--from and ${clash} both name the data source.`, "Pass one of them.");
+	if (await io.readFile(from) == null) throw new UserError(`Schema file not found: ${from}`, "Pass the path to a Drizzle schema (.ts) or a Prisma schema (.prisma).");
+	let all;
+	try {
+		all = await resolveSchemas(from, io);
+	} catch (e) {
+		throw new UserError(`Could not read ${from}: ${e instanceof Error ? e.message : String(e)}`, "Pass a Drizzle schema (.ts) or a Prisma schema (.prisma).");
+	}
+	if (all.length === 0) throw new UserError(`No tables or models found in ${from}.`, "Drizzle tables are read from pgTable / mysqlTable / sqliteTable calls, Prisma models from `model X {` blocks.");
+	let picked = all.map((s) => s.name);
+	if (!flags.yes) {
+		prompts.say("");
+		prompts.say(`Found ${all.length} ${all.length === 1 ? "table" : "tables"} in ${from}:`);
+		all.forEach((s, i) => prompts.say(`  ${i + 1}. ${s.name}`));
+		picked = parseSelection(await prompts.ask("Which tables? (all, or a comma list of names/numbers)", "all"), picked);
+	}
+	const schemas = all.filter((s) => picked.includes(s.name));
+	if (schemas.length === 0) throw new UserError("No tables picked - nothing to build.");
+	const sources = {};
+	for (const s of schemas) sources[s.name] = { kind: "memory" };
+	prompts.say(`  Read ${schemas.length} ${schemas.length === 1 ? "table" : "tables"} from ${from} (in-memory data with sample rows).`);
+	return {
+		schemas,
+		sources,
+		seed: {},
+		kind: "memory"
+	};
+}
 async function gatherFromDatabase(flags, prompts, db) {
 	if (!db) throw new UserError("Connecting to a database is not available here.");
 	let dialect = flags.db;
@@ -41263,7 +41463,7 @@ async function confirmTargetFolder(outDir, flags, prompts, io, before) {
 	if (!isYes(await prompts.ask("Overwrite? (y/N)", "n"), false)) throw new UserError("Stopped without writing anything.", "Re-run with --out <dir> to build somewhere else.");
 }
 /** Merge-write the generated files, preserving edits outside managed regions. */
-async function writeAll$1(files, outDir, io) {
+async function writeAll(files, outDir, io) {
 	const written = [];
 	for (const file of files) {
 		const path = inDir(outDir, file.path);
@@ -41282,7 +41482,7 @@ async function runStudioInit(flags, prompts, db, io, fetchText = null) {
 	prompts.say("SvGrid Studio - let's build your app.");
 	const candidateDir = flags.out ?? ".";
 	const markersBefore = await markersIn(candidateDir, io);
-	const data = await gatherData(flags, prompts, db, fetchText);
+	const data = await gatherData(flags, prompts, db, fetchText, io);
 	const perEntity = await askScreens(data.schemas, flags, prompts);
 	const theme = await askTheme(flags, prompts);
 	const defaultTitle = flags.title ?? data.title ?? "My app";
@@ -41298,7 +41498,7 @@ async function runStudioInit(flags, prompts, db, io, fetchText = null) {
 		overviewDashboard: true,
 		...theme ? { theme } : {}
 	});
-	const written = await writeAll$1(emitStudioAppBundle(project), outDir, io);
+	const written = await writeAll(emitStudioAppBundle(project), outDir, io);
 	const configPath = inDir(outDir, "studio.config.json");
 	await io.writeFile(configPath, serializeProject(project));
 	written.push(configPath);
@@ -41466,57 +41666,6 @@ function buildStudioBugReport(input) {
 	};
 }
 //#endregion
-//#region src/studio/verify.ts
-async function verifyScaffold(files) {
-	const issues = [];
-	let checked = 0;
-	let skipped = 0;
-	let compile;
-	try {
-		compile = (await import("svelte/compiler")).compile;
-	} catch {
-		compile = void 0;
-	}
-	for (const file of files) {
-		if (!file.path.endsWith(".svelte") || !compile) {
-			skipped++;
-			continue;
-		}
-		try {
-			const { warnings } = compile(file.contents, {
-				filename: file.path,
-				generate: "client"
-			});
-			checked++;
-			for (const w of warnings) issues.push({
-				path: file.path,
-				severity: "warning",
-				message: w.message ?? "warning"
-			});
-		} catch (err) {
-			checked++;
-			issues.push({
-				path: file.path,
-				severity: "error",
-				message: err instanceof Error ? err.message : String(err)
-			});
-		}
-	}
-	return {
-		ok: !issues.some((i) => i.severity === "error"),
-		issues,
-		checked,
-		skipped
-	};
-}
-/** One-line human summary of a verify result, for tool output / logs. */
-function summarizeVerify(result) {
-	if (result.checked === 0) return "verification skipped (Svelte compiler unavailable) - run svelte-check in your project.";
-	const errors = result.issues.filter((i) => i.severity === "error");
-	if (errors.length === 0) return `verified: ${result.checked} file(s) compile.`;
-	return `VERIFICATION FAILED (${errors.length} error(s)):\n` + errors.map((e) => `  ${e.path}: ${e.message}`).join("\n");
-}
-//#endregion
 //#region src/studio/copilot-core.ts
 /**
 * Studio Copilot - the pure, testable core. Builds the model request for "edit
@@ -41660,63 +41809,6 @@ function missingEnvKeys(envExample, envLocal) {
 	return declared.filter((k) => !present.has(k));
 }
 //#endregion
-//#region src/studio/cli.ts
-/** A `.prisma` file (by extension or a `model X {` block) parses as Prisma; otherwise Drizzle. */
-function isPrismaSource(path, source) {
-	return /\.prisma$/i.test(path) || /\bmodel\s+\w+\s*\{/.test(source);
-}
-/** Resolve an EntitySchema from whichever input was provided. */
-async function resolveSchema(options, io) {
-	if (options.schema) return options.schema;
-	if (options.from) {
-		const src = await io.readFile(options.from);
-		if (src == null) throw new Error(`runStudioAdd: schema file not found: ${options.from}`);
-		return isPrismaSource(options.from, src) ? introspectPrisma(src, options.table) : introspectDrizzle(src, options.table);
-	}
-	if (options.rows) return introspectJson(options.name ?? options.route ?? "entity", options.rows);
-	throw new Error("runStudioAdd: provide `from` (a Drizzle or Prisma schema file), `rows`, or `schema`");
-}
-/**
-* Resolve **every** entity from a Drizzle or Prisma schema file (the `--all
-* --from` path), linked so foreign keys become working relation lookups.
-*/
-async function resolveSchemas(from, io) {
-	const src = await io.readFile(from);
-	if (src == null) throw new Error(`runStudioAddApp: schema file not found: ${from}`);
-	return isPrismaSource(from, src) ? introspectPrismaAll(src) : introspectDrizzleAll(src);
-}
-/** Merge-write a set of generated files, preserving user edits outside managed regions. */
-async function writeAll(files, io) {
-	const written = [];
-	for (const file of files) {
-		const existing = await io.readFile(file.path);
-		if (skipUserOwned(file, existing != null)) continue;
-		await io.writeFile(file.path, mergeManaged(existing, file.contents));
-		written.push(file.path);
-	}
-	return written;
-}
-async function runStudioAdd(options, io) {
-	const schema = await resolveSchema(options, io);
-	const { files } = scaffold(schema, options);
-	return {
-		schema,
-		written: await writeAll(files, io),
-		verify: await verifyScaffold(files)
-	};
-}
-/**
-* Scaffold a whole multi-entity app - every entity's screen plus a nav layout
-* and home page - and merge-write it. The `--all` path behind `svgrid-studio`.
-*/
-async function runStudioAddApp(schemas, options, io) {
-	const { files } = scaffoldApp(schemas, options);
-	return {
-		written: await writeAll(files, io),
-		verify: await verifyScaffold(files)
-	};
-}
-//#endregion
 //#region src/revoked.ts
 var REVOKED_KEYS = /* @__PURE__ */ new Set([]);
 /**

package/dist/sheet/objects.d.ts

@@ -92,6 +92,53 @@ export declare function objectAt(objects: ReadonlyArray<SheetObject>, point: {
     width: number;
     height: number;
 } | null): SheetObject | null;
+/**
+ * The four panes Freeze Panes splits a sheet into: the frozen corner, the
+ * frozen rows (which scroll across), the frozen columns (which scroll
+ * down), and the body (which scrolls both ways).
+ */
+export type SheetPane = 'corner' | 'rows' | 'cols' | 'body';
+/**
+ * The pane an object belongs to: the one its anchor cell is in. Excel keeps
+ * an object with that pane, so one hung from a frozen cell is drawn over
+ * the frozen cells and stays put while the sheet scrolls under it.
+ */
+export declare function paneOf(anchor: {
+    row: number;
+    col: number;
+}, freeze: {
+    rows: number;
+    cols: number;
+}): SheetPane;
+/**
+ * How much of an object its pane cuts off, in pixels from each edge of its
+ * box. `box` and `edges` are in the same frame: `left` measured from the
+ * inline start, `top` from the top.
+ *
+ * `edges.start` and `edges.top` are where the scrolling cells begin (past
+ * the frozen columns, or the row numbers when none are frozen; under the
+ * frozen rows, or the header), and `edges.end` and `edges.bottom` where the
+ * sheet's window ends. An object is cut on the sides its pane scrolls from,
+ * so it slides under the frozen cells, and always at the window's far
+ * edges. A frozen pane never scrolls past its start, so nothing is cut
+ * there and the object is drawn whole over its frozen cells.
+ */
+export declare function paneClip(pane: SheetPane, box: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, edges: {
+    start: number;
+    top: number;
+    end: number;
+    bottom: number;
+}): {
+    start: number;
+    top: number;
+    end: number;
+    bottom: number;
+};
 /**
  * The chart's spec, read from its range through `valueAt` (the computed
  * value) and `textAt` (what the cell shows, for the labels). A chart of a

package/dist/sheet/objects.js

@@ -49,6 +49,39 @@ export function objectAt(objects, point, boxOf) {
     }
     return null;
 }
+/**
+ * The pane an object belongs to: the one its anchor cell is in. Excel keeps
+ * an object with that pane, so one hung from a frozen cell is drawn over
+ * the frozen cells and stays put while the sheet scrolls under it.
+ */
+export function paneOf(anchor, freeze) {
+    const row = anchor.row < freeze.rows;
+    const col = anchor.col < freeze.cols;
+    return row && col ? 'corner' : row ? 'rows' : col ? 'cols' : 'body';
+}
+/**
+ * How much of an object its pane cuts off, in pixels from each edge of its
+ * box. `box` and `edges` are in the same frame: `left` measured from the
+ * inline start, `top` from the top.
+ *
+ * `edges.start` and `edges.top` are where the scrolling cells begin (past
+ * the frozen columns, or the row numbers when none are frozen; under the
+ * frozen rows, or the header), and `edges.end` and `edges.bottom` where the
+ * sheet's window ends. An object is cut on the sides its pane scrolls from,
+ * so it slides under the frozen cells, and always at the window's far
+ * edges. A frozen pane never scrolls past its start, so nothing is cut
+ * there and the object is drawn whole over its frozen cells.
+ */
+export function paneClip(pane, box, edges) {
+    const across = pane === 'rows' || pane === 'body';
+    const down = pane === 'cols' || pane === 'body';
+    return {
+        start: across ? Math.max(0, edges.start - box.left) : 0,
+        top: down ? Math.max(0, edges.top - box.top) : 0,
+        end: Math.max(0, box.left + box.width - edges.end),
+        bottom: Math.max(0, box.top + box.height - edges.bottom),
+    };
+}
 /** A cell's value as a number, or null when it is not one. */
 function numberOf(value) {
     if (typeof value === 'number')

package/dist/studio/cli.js

@@ -58,12 +58,66 @@ export async function runStudioAdd(options, io) {
     const verify = await verifyScaffold(files);
     return { schema, written, verify };
 }
+/** The stylesheets an `init`-generated layout imports, in cascade order. */
+const APP_STYLESHEETS = ['app.css', 'custom.css'];
+/**
+ * Fill the app-shell options the caller left out from the app already on disk,
+ * so `add --all` in a folder `init` generated keeps its stylesheets, title and
+ * theme. The shell layout from `init` carries no managed markers, so the merge
+ * write replaces it whole; anything it imported or named has to be carried
+ * over here or it is lost.
+ *
+ * Title: studio.config.json (shell brand, then title), else the `appTitle`
+ * constant of a layout an earlier `add --all` wrote.
+ */
+async function appShellDefaults(options, io) {
+    const stylesheets = options.stylesheets ?? [];
+    if (!options.stylesheets) {
+        for (const css of APP_STYLESHEETS) {
+            if ((await io.readFile(`src/${css}`)) != null)
+                stylesheets.push(css);
+        }
+    }
+    let title;
+    let theme;
+    const config = await io.readFile('studio.config.json');
+    if (config != null) {
+        try {
+            const parsed = JSON.parse(config);
+            theme = parsed.theme;
+            const brand = typeof theme?.shell?.brand === 'string' ? theme.shell.brand.trim() : '';
+            title = brand || (typeof parsed.title === 'string' ? parsed.title : undefined);
+        }
+        catch {
+            /* unreadable config: fall back to the layout below */
+        }
+    }
+    if (!title) {
+        const layout = await io.readFile('src/routes/+layout.svelte');
+        const m = layout?.match(/const appTitle = ("(?:[^"\\]|\\.)*")/);
+        if (m) {
+            try {
+                title = JSON.parse(m[1]);
+            }
+            catch {
+                /* not a JSON string literal: keep the default */
+            }
+        }
+    }
+    return {
+        ...options,
+        stylesheets,
+        ...(options.appTitle == null && title ? { appTitle: title } : {}),
+        ...(options.theme == null && typeof theme?.preset === 'string' ? { theme: theme.preset } : {}),
+        ...(options.dark == null && theme?.mode === 'dark' ? { dark: true } : {}),
+    };
+}
 /**
  * Scaffold a whole multi-entity app - every entity's screen plus a nav layout
  * and home page - and merge-write it. The `--all` path behind `svgrid-studio`.
  */
 export async function runStudioAddApp(schemas, options, io) {
-    const { files } = scaffoldApp(schemas, options);
+    const { files } = scaffoldApp(schemas, await appShellDefaults(options, io));
     const written = await writeAll(files, io);
     const verify = await verifyScaffold(files);
     return { written, verify };

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

@@ -1,4 +1,4 @@
-import type { StudioIO } from './cli.js';
+import { type StudioIO } from './cli.js';
 import { type DbExecute, type SqlDialectName } from './introspect-db.js';
 import { type StudioProject } from './project.js';
 /** Terminal I/O, injected so the flow can be scripted in tests. */
@@ -30,6 +30,11 @@ export type InitFlags = {
     supabaseUrl?: string;
     /** Supabase anon key. */
     supabaseKey?: string;
+    /**
+     * A Drizzle (.ts) or Prisma (.prisma) schema file. Skips the source question
+     * and builds the app from its tables, served from memory with sample rows.
+     */
+    from?: string;
     /** Pick a starter dataset by id, skipping the source question. */
     dataset?: string;
     /** Theme preset id. */