@svgrid/enterprise 3.1.7 → 3.1.9

package/dist/node/studio.js

@@ -2054,7 +2054,7 @@ var SOURCE = /\.(ts|js|svelte)$/;
 function toSvelteKit3(files) {
 	const paths = new Set(files.map((f) => f.path));
 	const adapter = adapterOf(files);
-	const envNames = /* @__PURE__ */ new Set();
+	const envNames = /* @__PURE__ */ new Map();
 	const out = [];
 	for (const file of files) {
 		if (file.path === "svelte.config.js") continue;
@@ -2090,7 +2090,7 @@ function toSvelteKit3(files) {
 		}
 		out.push(file);
 	}
-	if (envNames.size) out.push(envModule([...envNames].sort()));
+	if (envNames.size) out.push(envModule([...envNames].sort(([a], [b]) => a.localeCompare(b))));
 	return out;
 }
 function adapterOf(files) {
@@ -2159,18 +2159,22 @@ function rewriteLibImports(src, paths) {
 /**
 * `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.
+* and the same for `$env/dynamic/public` -> `$app/env/public` (the Supabase
+* client reads PUBLIC_SUPABASE_* this way). Every name read is collected so
+* src/env.ts can declare it, which v3 requires; public ones are declared
+* `public: true`, or `$app/env/public` would not export them.
 */
 function rewriteEnv(src, envNames) {
-	if (!/from\s+['"]\$env\/dynamic\/private['"]/.test(src)) return src;
+	const kind = /from\s+['"]\$env\/dynamic\/private['"]/.test(src) ? "private" : /from\s+['"]\$env\/dynamic\/public['"]/.test(src) ? "public" : null;
+	if (!kind) return src;
 	const used = /* @__PURE__ */ new Set();
 	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);
+	for (const n of used) envNames.set(n, kind === "public" || envNames.get(n) === true);
 	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'` : "");
+	return body.replace(new RegExp(`import\\s*\\{\\s*env\\s*\\}\\s*from\\s*(['"])\\$env\\/dynamic\\/${kind}\\1`), names.length ? `import { ${names.join(", ")} } from '$app/env/${kind}'` : "");
 }
 /**
 * Types that moved out of `@sveltejs/kit`, and the deprecated `json` helper.
@@ -2198,10 +2202,16 @@ function envModule(names) {
 // SvelteKit 3 reads only the variables declared here. A missing one comes
 // through as '' - every read in this app already falls back on that
 // (a dev default, '?? ""', or an if), so that is the intended behaviour.
-export const variables = defineEnvVars({\n${names.map((n) => `  ${n}: { schema: (input) => input ?? '' },`).join("\n")}\n})\n`
+export const variables = defineEnvVars({\n${names.map(([n, pub]) => `  ${n}: { ${pub ? "public: true, " : ""}schema: (input) => input ?? '' },`).join("\n")}\n})\n`
 	};
 }
 //#endregion
+//#region src/expressions/kinds.ts
+var kinds = /* @__PURE__ */ new Map();
+function getPredicateKind(type) {
+	return kinds.get(type);
+}
+//#endregion
 //#region src/expressions/parse.ts
 /** Every column id referenced anywhere in a predicate (deduped, in order). */
 function collectColumnRefs(expr) {
@@ -2225,6 +2235,9 @@ function walkPredicate(expr, out) {
 			walkScalar(expr.left, out);
 			walkScalar(expr.right, out);
 			return;
+		case "ext":
+			for (const c of getPredicateKind(expr.type)?.columns?.(expr.payload) ?? []) out.add(c);
+			return;
 		case "const": return;
 	}
 }
@@ -8719,6 +8732,13 @@ var GENERATED_UI_SURFACE = {
 				"description": "Kanban board mode. When set, the grid renders its rows as cards in horizontal lanes (bucketed by `board.groupBy`) instead of a table. See .",
 				"group": "common"
 			},
+			{
+				"key": "gallery",
+				"label": "Gallery",
+				"type": "json",
+				"description": "Gallery mode. When set, the grid renders its rows as cards (a cover image, a title, a few fields) instead of a table. See .",
+				"group": "common"
+			},
 			{
 				"key": "scheduler",
 				"label": "Scheduler",
@@ -8768,6 +8788,55 @@ var GENERATED_UI_SURFACE = {
 				"description": "Floating bar that appears over the grid while rows are selected, showing the count and the actions that apply to the whole selection - the pattern an issue tracker uses for bulk edit. `true` gives the count and a Clear button. An array is the shorthand for `{ actions }`. Pass to also set `position` (`'bottom'` default, or `'top'`), `maxVisible` and `hideClear`. Omitted / `false` is off. Default **off**. This is chrome that floats over your content, not a gesture: it overlaps a row, and what belongs on it is specific to the app. **The prop and its types are free; the bar itself is an Enterprise feature.** Install `@svgrid/enterprise` and call `enableSelectionBar()` (or `installEnterprise`, which does it for you) to render it - without that the grid shows a short upsell note in its place, the same way the scheduler and board views do.",
 				"group": "common"
 			},
+			{
+				"key": "rowAdder",
+				"label": "Row Adder",
+				"type": "boolean",
+				"description": "A \"+ Add row\" line under the last row. Clicking it (or Enter on it) appends a row, scrolls to it and starts editing its first editable cell. `true` uses the defaults; pass for the label and the new row's values. **The prop and its types are free; the row adder is drawn by the Enterprise `@svgrid/enterprise/fields` module** (`enableFields()`). Without it the prop does nothing.",
+				"group": "common"
+			},
+			{
+				"key": "rowColor",
+				"label": "Row Color",
+				"type": "json",
+				"description": "Color rows by a status: by a select field (each row takes its option's `color`) or by rules (first match wins). The color shows on the row header by default (a 3px stripe at the start of the row-number cell); `target` moves it to a stripe in the first cell or a tint across the row. The row header also gets the status as its title, so the color is never the only signal. Computed for rendered rows only. **The prop and its types are free; the colors are drawn by the Enterprise `@svgrid/enterprise/fields` module** (`enableFields()`).",
+				"group": "common"
+			},
+			{
+				"key": "columnAdder",
+				"label": "Column Adder",
+				"type": "boolean",
+				"description": "A \"+\" header cell after the last column that opens the field editor: a name, a field type and that type's properties. Creating adds the column and fires `onColumnAdd`; the grid never stores a schema, the app does. `{ types }` limits the types offered. **Drawn by the Enterprise `@svgrid/enterprise/fields` module.**",
+				"group": "common"
+			},
+			{
+				"key": "fieldMenu",
+				"label": "Field Menu",
+				"type": "boolean",
+				"description": "Field actions in each column's menu: Edit field, Insert left / right, Duplicate, Delete, Hide. Edit can change the type; values are converted where they can be and the editor says how many cells would be cleared. **Drawn by the Enterprise `@svgrid/enterprise/fields` module.**",
+				"group": "common"
+			},
+			{
+				"key": "expandRows",
+				"label": "Expand Rows",
+				"type": "boolean",
+				"description": "The row-number cell becomes the row's handle: on hover it shows a checkbox that selects the row and an expand button that opens the row as a record, every field with its label and its editor. With `showRowNumbers`. **Drawn by the Enterprise `@svgrid/enterprise/fields` module.**",
+				"group": "common"
+			},
+			{
+				"key": "pinSplitter",
+				"label": "Pin Splitter",
+				"type": "boolean",
+				"description": "A divider at the edge of the left-pinned columns: drag it right to pin the columns it passes, left to unpin them. It snaps to column edges and keeps the columns where they are on screen; with the keyboard, focus it and use the arrow keys. Its words come from `localization.text` (`pinSplitterLabel`, `pinSplitterHint`, `pinSplitterNone`, `pinSplitterOne`, `pinSplitterMany`). Loaded only when set.",
+				"group": "common"
+			},
+			{
+				"key": "primaryField",
+				"label": "Primary Field",
+				"type": "string",
+				"description": "The table's primary field (a column id or field): always the first column and pinned, never hidden or deleted, and the name of a record (the expanded record's title, a gallery card's title). **Kept by the Enterprise `@svgrid/enterprise/fields` module.**",
+				"group": "common"
+			},
 			{
 				"key": "features",
 				"label": "Features",
@@ -9297,7 +9366,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "rowNumberWidth",
 				"label": "Row Number Width",
 				"type": "number",
-				"description": "Width (px) of the row-number column. Defaults to 56, which fits up to \"99,999\"; bump this when the dataset crosses six digits so the largest row number stays fully visible at the bottom of a scroll.",
+				"description": "Width (px) of the row-number column. By default it fits the largest row number: 56px up to four digits, then 9px wider per digit (from `data.length`, or `rowCount` on a server-paged grid). Set it to pin a width, for example when a theme uses a much larger font.",
 				"group": "common"
 			},
 			{
@@ -9526,7 +9595,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "rowDragManaged",
 				"label": "Row Drag Managed",
 				"type": "boolean",
-				"description": "Enables managed row dragging. When `true`, every row becomes a drag source (grab cursor + a grip in the row-number cell) and a drop indicator paints between rows during a drag. On drop the grid mutates its own internal data - reordering within the grid, or moving the row across grids that share the same . Defaults to `false`.",
+				"description": "Enables managed row dragging. When `true`, a row is dragged by its row-number cell (a grip shows while it is hovered), or by any cell when row numbers are off, and a drop indicator paints between rows during a drag. On drop the grid mutates its own internal data - reordering within the grid, or moving the row across grids that share the same . Defaults to `false`.",
 				"group": "common"
 			},
 			{
@@ -9558,6 +9627,42 @@ var GENERATED_UI_SURFACE = {
 				"prop": "onPivotModeChange",
 				"description": "Fired when the in-grid Pivot toggle flips `pivotMode`."
 			},
+			{
+				"key": "rowAdd",
+				"label": "Row Add",
+				"prop": "onRowAdd",
+				"description": "Fires after the row adder appended a row, with that row. Persist it here."
+			},
+			{
+				"key": "columnAdd",
+				"label": "Column Add",
+				"prop": "onColumnAdd",
+				"description": "A field was added (column adder, Insert, Duplicate). `columns` is the whole column list after the change, as declared (store it as your `columns`); `data` is set when values were written too."
+			},
+			{
+				"key": "columnChange",
+				"label": "Column Change",
+				"prop": "onColumnChange",
+				"description": "A field was edited. `columns` as in `onColumnAdd`; `data` is set when a type change converted its values."
+			},
+			{
+				"key": "columnRemove",
+				"label": "Column Remove",
+				"prop": "onColumnRemove",
+				"description": "A field was deleted from the column menu (its values stay in the rows). `columns` as in `onColumnAdd`."
+			},
+			{
+				"key": "rowsDelete",
+				"label": "Rows Delete",
+				"prop": "onRowsDelete",
+				"description": "Rows were deleted from the selection bar's Delete (`deleteRows`): the rows and their ids, and the data without them, to store."
+			},
+			{
+				"key": "rowColorChange",
+				"label": "Row Color Change",
+				"prop": "onRowColorChange",
+				"description": "The rows were set to be colored by another field, or no longer colored, from a single select's column menu (\"Color rows by this field\" with `fieldMenu`). Store it and pass it back as `rowColor`."
+			},
 			{
 				"key": "expandedChange",
 				"label": "Expanded Change",
@@ -16341,7 +16446,7 @@ function hasFieldConditions(schema) {
 *
 * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
 */
-var SVGRID_VERSION = "3.1.7";
+var SVGRID_VERSION = "3.1.9";
 /**
 * 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.
@@ -16354,7 +16459,7 @@ var SVGRID_VERSION = "3.1.7";
 *
 * `version.test.ts` asserts this matches packages/grid/package.json.
 */
-var GRID_VERSION = "3.0.10";
+var GRID_VERSION = "3.0.12";
 //#endregion
 //#region src/studio/emit-project.ts
 var has = (blocks, kind) => blocks.some((b) => b.config.kind === kind);
@@ -18441,6 +18546,7 @@ function emitSsrGridScreen(schema, screen, routed, accessEnabled, screenIds, byN
 	const facetPanel = screen.blocks.find((b) => b.config.kind === "filter")?.config;
 	const pageSize = grid.pageSize && grid.pageSize > 0 ? grid.pageSize : 25;
 	const wantsFilter = grid.filterable !== false;
+	const wantsSort = grid.sortable !== false;
 	const idField = schema.idField ?? schema.fields.find((f) => f.primaryKey)?.field ?? "id";
 	const isFormHidden = (f) => f.hidden === true || typeof f.hidden === "object" && !!f.hidden.form;
 	const editable = schema.fields.filter((f) => f.field !== idField && !f.primaryKey && !f.readonly && !f.computed && !f.formula && !isFormHidden(f));
@@ -18738,7 +18844,7 @@ ${wantsFilter ? `
 ${facetForm}
 <SvGrid
   data={data.rows}
-  {columns}
+  {columns}${wantsSort ? "\n  sortable" : ""}
   externalSort
   initialSorting={data.sort}
   showPagination
@@ -21156,13 +21262,28 @@ function randomSecret(bytes = 32) {
 	globalThis.crypto.getRandomValues(buf);
 	return Array.from(buf, (b) => b.toString(16).padStart(2, "0")).join("");
 }
+/** The Supabase project the app connects to, when the model holds one: the
+*  project-wide connection, else the first Supabase-bound entity's. */
+function supabaseConnOf(project) {
+	const hit = [project.supabase, ...Object.values(project.dataSources ?? {}).filter((s) => s.kind === "supabase")].find((c) => c?.url && c?.key);
+	return hit ? {
+		url: hit.url,
+		key: hit.key
+	} : null;
+}
 /** A ready-to-run, git-ignored `.env`: the `.env.example` template with a real
 *  random `SESSION_SECRET` filled in, so the app is secure out of the box (no
-*  hardcoded dev secret). Only emitted when the app actually signs sessions. */
-function envDotFile(allSource) {
+*  hardcoded dev secret), and the Supabase URL + anon key the model already
+*  holds, so a Supabase app runs as generated instead of failing on an empty
+*  URL. Only emitted when there is something to fill in. */
+function envDotFile(allSource, project) {
 	const example = envExample(allSource);
-	if (!example || !allSource.includes("SESSION_SECRET")) return null;
-	return example.replace("SESSION_SECRET=change-me-to-a-long-random-string", `SESSION_SECRET=${randomSecret()}`);
+	if (!example) return null;
+	const supa = allSource.includes("PUBLIC_SUPABASE_URL") ? supabaseConnOf(project) : null;
+	if (!allSource.includes("SESSION_SECRET") && !supa) return null;
+	let env = example.replace("SESSION_SECRET=change-me-to-a-long-random-string", `SESSION_SECRET=${randomSecret()}`);
+	if (supa) env = env.replace(/^PUBLIC_SUPABASE_URL=$/m, `PUBLIC_SUPABASE_URL=${supa.url}`).replace(/^PUBLIC_SUPABASE_ANON_KEY=$/m, `PUBLIC_SUPABASE_ANON_KEY=${supa.key}`);
+	return env;
 }
 /** A `.env.example` listing the env vars the generated code reads, when any. */
 function envExample(allSource) {
@@ -21448,10 +21569,10 @@ function emitStudioAppBundle(project) {
 			description: "Environment variables the app reads (copy to .env and fill in).",
 			contents: envExample(allSource)
 		}] : [],
-		...envDotFile(allSource) ? [{
+		...envDotFile(allSource, project) ? [{
 			path: ".env",
-			description: "Local env (git-ignored): a real random SESSION_SECRET is pre-filled so sessions are secure out of the box; fill in the rest.",
-			contents: envDotFile(allSource)
+			description: "Local env (git-ignored): a real random SESSION_SECRET and the Supabase connection the design holds are pre-filled, so the app runs as generated; fill in the rest.",
+			contents: envDotFile(allSource, project)
 		}] : [],
 		{
 			path: "src/app.css",
@@ -41317,7 +41438,7 @@ async function listSupabaseTables(url, key, fetchFn = globalThis.fetch) {
 /** Introspect a Supabase/PostgREST table into an EntitySchema, or null. */
 async function introspectSupabaseTable(options) {
 	const o = {
-		fetch: globalThis.fetch,
+		fetch: (...args) => globalThis.fetch(...args),
 		...options
 	};
 	const base = o.url.replace(/\/+$/, "");

package/dist/scheduler-config.d.ts

@@ -108,6 +108,17 @@ export type SchedulerProConfig<TFeatures extends TableFeatures = TableFeatures,
         hidden?: boolean;
     }>;
     calendarField?: keyof TData & string;
+    /**
+     * Open an event where the app keeps it (a record view) instead of the
+     * built-in drawer: a click on the event calls it.
+     */
+    onEventOpen?: (row: TData) => void;
+    /**
+     * `false`: events move but keep their length - no edge grips. For records
+     * with one date (a start or a due date) there is no end to change.
+     * Default `true`.
+     */
+    resizable?: boolean;
     /**
      * External busy intervals to shade on a resource's timeline row - times it is
      * unavailable that aren't events in this scheduler (its own calendar). Combine

package/dist/sources/introspect-supabase.js

@@ -125,7 +125,10 @@ export async function listSupabaseTables(url, key, fetchFn = globalThis.fetch) {
 }
 /** Introspect a Supabase/PostgREST table into an EntitySchema, or null. */
 export async function introspectSupabaseTable(options) {
-    const o = { fetch: globalThis.fetch, ...options };
+    // A wrapper, not `globalThis.fetch` itself: called as `o.fetch(...)` the
+    // browser's fetch gets `o` as its receiver and throws "Illegal invocation",
+    // which the paths below catch as "no answer", so no table was ever found.
+    const o = { fetch: (...args) => globalThis.fetch(...args), ...options };
     const base = o.url.replace(/\/+$/, '');
     const columns = (await viaOpenApi(o, base)) ?? (await viaSample(o, base)) ?? (await viaCsv(o, base));
     if (!columns || !columns.length)

package/dist/sources/rest.js

@@ -110,8 +110,12 @@ export function createRestDataSource(config) {
     };
     const send = async (url, init) => {
         const res = await doFetch(url, init);
-        if (!res.ok)
-            throw new Error(`REST ${init?.method ?? 'GET'} ${url} -> ${res.status} ${res.statusText}`);
+        if (!res.ok) {
+            // The endpoint's own words, when it sent any (`{ error }` or `{ message }`): a
+            // validation message reads better to the user than the status line.
+            const said = await res.json().then((b) => b?.error ?? b?.message, () => undefined);
+            throw new Error(`REST ${init?.method ?? 'GET'} ${url} -> ${res.status} ${res.statusText}${typeof said === 'string' && said ? `: ${said}` : ''}`);
+        }
         const parsed = res.status === 204 ? undefined : await res.json().catch(() => undefined);
         return { body: parsed, res };
     };

package/dist/studio/emit-project.js

@@ -2540,6 +2540,9 @@ function emitSsrGridScreen(schema, screen, routed, accessEnabled, screenIds, byN
     const facetPanel = screen.blocks.find((b) => b.config.kind === 'filter')?.config;
     const pageSize = grid.pageSize && grid.pageSize > 0 ? grid.pageSize : 25;
     const wantsFilter = grid.filterable !== false;
+    // externalSort alone only renders the indicator; without `sortable` a header
+    // click never reaches onSortingChange, so the URL (and the load) never sorts.
+    const wantsSort = grid.sortable !== false;
     const idField = schema.idField ?? schema.fields.find((f) => f.primaryKey)?.field ?? 'id';
     const isFormHidden = (f) => f.hidden === true || (typeof f.hidden === 'object' && !!f.hidden.form);
     const editable = schema.fields.filter((f) => f.field !== idField && !f.primaryKey && !f.readonly && !f.computed && !f.formula && !isFormHidden(f));
@@ -2901,7 +2904,7 @@ ${wantsFilter ? `
 ${facetForm}
 <SvGrid
   data={data.rows}
-  {columns}
+  {columns}${wantsSort ? '\n  sortable' : ''}
   externalSort
   initialSorting={data.sort}
   showPagination
@@ -5171,14 +5174,30 @@ function randomSecret(bytes = 32) {
     globalThis.crypto.getRandomValues(buf);
     return Array.from(buf, (b) => b.toString(16).padStart(2, '0')).join('');
 }
+/** The Supabase project the app connects to, when the model holds one: the
+ *  project-wide connection, else the first Supabase-bound entity's. */
+function supabaseConnOf(project) {
+    const candidates = [project.supabase, ...Object.values(project.dataSources ?? {}).filter((s) => s.kind === 'supabase')];
+    const hit = candidates.find((c) => c?.url && c?.key);
+    return hit ? { url: hit.url, key: hit.key } : null;
+}
 /** A ready-to-run, git-ignored `.env`: the `.env.example` template with a real
  *  random `SESSION_SECRET` filled in, so the app is secure out of the box (no
- *  hardcoded dev secret). Only emitted when the app actually signs sessions. */
-function envDotFile(allSource) {
+ *  hardcoded dev secret), and the Supabase URL + anon key the model already
+ *  holds, so a Supabase app runs as generated instead of failing on an empty
+ *  URL. Only emitted when there is something to fill in. */
+function envDotFile(allSource, project) {
     const example = envExample(allSource);
-    if (!example || !allSource.includes('SESSION_SECRET'))
+    if (!example)
+        return null;
+    const supa = allSource.includes('PUBLIC_SUPABASE_URL') ? supabaseConnOf(project) : null;
+    if (!allSource.includes('SESSION_SECRET') && !supa)
         return null;
-    return example.replace('SESSION_SECRET=change-me-to-a-long-random-string', `SESSION_SECRET=${randomSecret()}`);
+    let env = example.replace('SESSION_SECRET=change-me-to-a-long-random-string', `SESSION_SECRET=${randomSecret()}`);
+    // The anon key is public / browser-safe; access is governed by RLS.
+    if (supa)
+        env = env.replace(/^PUBLIC_SUPABASE_URL=$/m, `PUBLIC_SUPABASE_URL=${supa.url}`).replace(/^PUBLIC_SUPABASE_ANON_KEY=$/m, `PUBLIC_SUPABASE_ANON_KEY=${supa.key}`);
+    return env;
 }
 /** A `.env.example` listing the env vars the generated code reads, when any. */
 function envExample(allSource) {
@@ -5480,7 +5499,7 @@ export function emitStudioAppBundle(project) {
         rootLayoutModule(project),
         ...SCAFFOLD_STATIC,
         ...(envExample(allSource) ? [{ path: '.env.example', description: 'Environment variables the app reads (copy to .env and fill in).', contents: envExample(allSource) }] : []),
-        ...(envDotFile(allSource) ? [{ path: '.env', description: 'Local env (git-ignored): a real random SESSION_SECRET is pre-filled so sessions are secure out of the box; fill in the rest.', contents: envDotFile(allSource) }] : []),
+        ...(envDotFile(allSource, project) ? [{ path: '.env', description: 'Local env (git-ignored): a real random SESSION_SECRET and the Supabase connection the design holds are pre-filled, so the app runs as generated; fill in the rest.', contents: envDotFile(allSource, project) }] : []),
         { path: 'src/app.css', description: 'App theme tokens + page styles.', contents: appCss(project) },
         // Your styles: a dedicated CSS file the layout imports AFTER app.css, so its rules
         // win. Edited in the designer's Styles panel; regenerated from the model.

package/dist/studio/sveltekit3.js

@@ -24,7 +24,8 @@ 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();
+    // Every env var a source reads, and whether it is public (client-side).
+    const envNames = new Map();
     const out = [];
     for (const file of files) {
         // svelte.config.js is gone: its adapter and preprocess move into vite.config.ts.
@@ -50,7 +51,7 @@ export function toSvelteKit3(files) {
         out.push(file);
     }
     if (envNames.size)
-        out.push(envModule([...envNames].sort()));
+        out.push(envModule([...envNames].sort(([a], [b]) => a.localeCompare(b))));
     return out;
 }
 /* ---------------------------------------------------------------- config */
@@ -143,10 +144,15 @@ function rewriteLibImports(src, paths) {
 /**
  * `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.
+ * and the same for `$env/dynamic/public` -> `$app/env/public` (the Supabase
+ * client reads PUBLIC_SUPABASE_* this way). Every name read is collected so
+ * src/env.ts can declare it, which v3 requires; public ones are declared
+ * `public: true`, or `$app/env/public` would not export them.
  */
 function rewriteEnv(src, envNames) {
-    if (!/from\s+['"]\$env\/dynamic\/private['"]/.test(src))
+    const kind = /from\s+['"]\$env\/dynamic\/private['"]/.test(src) ? 'private'
+        : /from\s+['"]\$env\/dynamic\/public['"]/.test(src) ? 'public' : null;
+    if (!kind)
         return src;
     const used = new Set();
     // `(?<![.\w])` keeps `process.env.X` untouched; only the imported `env` changes.
@@ -155,9 +161,9 @@ function rewriteEnv(src, envNames) {
         return name;
     });
     for (const n of used)
-        envNames.add(n);
+        envNames.set(n, kind === 'public' || envNames.get(n) === true);
     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'` : '');
+    return body.replace(new RegExp(`import\\s*\\{\\s*env\\s*\\}\\s*from\\s*(['"])\\$env\\/dynamic\\/${kind}\\1`), names.length ? `import { ${names.join(', ')} } from '$app/env/${kind}'` : '');
 }
 /**
  * Types that moved out of `@sveltejs/kit`, and the deprecated `json` helper.
@@ -181,7 +187,7 @@ function rewriteKitImports(src) {
 }
 /* ------------------------------------------------------------------- env */
 function envModule(names) {
-    const decls = names.map((n) => `  ${n}: { schema: (input) => input ?? '' },`).join('\n');
+    const decls = names.map(([n, pub]) => `  ${n}: { ${pub ? 'public: true, ' : ''}schema: (input) => input ?? '' },`).join('\n');
     return {
         path: 'src/env.ts',
         description: 'Environment variables the app reads (SvelteKit 3 requires declaring them).',

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

@@ -6599,6 +6599,13 @@ export const GENERATED_UI_SURFACE = {
                 "description": "Kanban board mode. When set, the grid renders its rows as cards in horizontal lanes (bucketed by `board.groupBy`) instead of a table. See .",
                 "group": "common"
             },
+            {
+                "key": "gallery",
+                "label": "Gallery",
+                "type": "json",
+                "description": "Gallery mode. When set, the grid renders its rows as cards (a cover image, a title, a few fields) instead of a table. See .",
+                "group": "common"
+            },
             {
                 "key": "scheduler",
                 "label": "Scheduler",
@@ -6648,6 +6655,55 @@ export const GENERATED_UI_SURFACE = {
                 "description": "Floating bar that appears over the grid while rows are selected, showing the count and the actions that apply to the whole selection - the pattern an issue tracker uses for bulk edit. `true` gives the count and a Clear button. An array is the shorthand for `{ actions }`. Pass to also set `position` (`'bottom'` default, or `'top'`), `maxVisible` and `hideClear`. Omitted / `false` is off. Default **off**. This is chrome that floats over your content, not a gesture: it overlaps a row, and what belongs on it is specific to the app. **The prop and its types are free; the bar itself is an Enterprise feature.** Install `@svgrid/enterprise` and call `enableSelectionBar()` (or `installEnterprise`, which does it for you) to render it - without that the grid shows a short upsell note in its place, the same way the scheduler and board views do.",
                 "group": "common"
             },
+            {
+                "key": "rowAdder",
+                "label": "Row Adder",
+                "type": "boolean",
+                "description": "A \"+ Add row\" line under the last row. Clicking it (or Enter on it) appends a row, scrolls to it and starts editing its first editable cell. `true` uses the defaults; pass for the label and the new row's values. **The prop and its types are free; the row adder is drawn by the Enterprise `@svgrid/enterprise/fields` module** (`enableFields()`). Without it the prop does nothing.",
+                "group": "common"
+            },
+            {
+                "key": "rowColor",
+                "label": "Row Color",
+                "type": "json",
+                "description": "Color rows by a status: by a select field (each row takes its option's `color`) or by rules (first match wins). The color shows on the row header by default (a 3px stripe at the start of the row-number cell); `target` moves it to a stripe in the first cell or a tint across the row. The row header also gets the status as its title, so the color is never the only signal. Computed for rendered rows only. **The prop and its types are free; the colors are drawn by the Enterprise `@svgrid/enterprise/fields` module** (`enableFields()`).",
+                "group": "common"
+            },
+            {
+                "key": "columnAdder",
+                "label": "Column Adder",
+                "type": "boolean",
+                "description": "A \"+\" header cell after the last column that opens the field editor: a name, a field type and that type's properties. Creating adds the column and fires `onColumnAdd`; the grid never stores a schema, the app does. `{ types }` limits the types offered. **Drawn by the Enterprise `@svgrid/enterprise/fields` module.**",
+                "group": "common"
+            },
+            {
+                "key": "fieldMenu",
+                "label": "Field Menu",
+                "type": "boolean",
+                "description": "Field actions in each column's menu: Edit field, Insert left / right, Duplicate, Delete, Hide. Edit can change the type; values are converted where they can be and the editor says how many cells would be cleared. **Drawn by the Enterprise `@svgrid/enterprise/fields` module.**",
+                "group": "common"
+            },
+            {
+                "key": "expandRows",
+                "label": "Expand Rows",
+                "type": "boolean",
+                "description": "The row-number cell becomes the row's handle: on hover it shows a checkbox that selects the row and an expand button that opens the row as a record, every field with its label and its editor. With `showRowNumbers`. **Drawn by the Enterprise `@svgrid/enterprise/fields` module.**",
+                "group": "common"
+            },
+            {
+                "key": "pinSplitter",
+                "label": "Pin Splitter",
+                "type": "boolean",
+                "description": "A divider at the edge of the left-pinned columns: drag it right to pin the columns it passes, left to unpin them. It snaps to column edges and keeps the columns where they are on screen; with the keyboard, focus it and use the arrow keys. Its words come from `localization.text` (`pinSplitterLabel`, `pinSplitterHint`, `pinSplitterNone`, `pinSplitterOne`, `pinSplitterMany`). Loaded only when set.",
+                "group": "common"
+            },
+            {
+                "key": "primaryField",
+                "label": "Primary Field",
+                "type": "string",
+                "description": "The table's primary field (a column id or field): always the first column and pinned, never hidden or deleted, and the name of a record (the expanded record's title, a gallery card's title). **Kept by the Enterprise `@svgrid/enterprise/fields` module.**",
+                "group": "common"
+            },
             {
                 "key": "features",
                 "label": "Features",
@@ -7180,7 +7236,7 @@ export const GENERATED_UI_SURFACE = {
                 "key": "rowNumberWidth",
                 "label": "Row Number Width",
                 "type": "number",
-                "description": "Width (px) of the row-number column. Defaults to 56, which fits up to \"99,999\"; bump this when the dataset crosses six digits so the largest row number stays fully visible at the bottom of a scroll.",
+                "description": "Width (px) of the row-number column. By default it fits the largest row number: 56px up to four digits, then 9px wider per digit (from `data.length`, or `rowCount` on a server-paged grid). Set it to pin a width, for example when a theme uses a much larger font.",
                 "group": "common"
             },
             {
@@ -7412,7 +7468,7 @@ export const GENERATED_UI_SURFACE = {
                 "key": "rowDragManaged",
                 "label": "Row Drag Managed",
                 "type": "boolean",
-                "description": "Enables managed row dragging. When `true`, every row becomes a drag source (grab cursor + a grip in the row-number cell) and a drop indicator paints between rows during a drag. On drop the grid mutates its own internal data - reordering within the grid, or moving the row across grids that share the same . Defaults to `false`.",
+                "description": "Enables managed row dragging. When `true`, a row is dragged by its row-number cell (a grip shows while it is hovered), or by any cell when row numbers are off, and a drop indicator paints between rows during a drag. On drop the grid mutates its own internal data - reordering within the grid, or moving the row across grids that share the same . Defaults to `false`.",
                 "group": "common"
             },
             {
@@ -7444,6 +7500,42 @@ export const GENERATED_UI_SURFACE = {
                 "prop": "onPivotModeChange",
                 "description": "Fired when the in-grid Pivot toggle flips `pivotMode`."
             },
+            {
+                "key": "rowAdd",
+                "label": "Row Add",
+                "prop": "onRowAdd",
+                "description": "Fires after the row adder appended a row, with that row. Persist it here."
+            },
+            {
+                "key": "columnAdd",
+                "label": "Column Add",
+                "prop": "onColumnAdd",
+                "description": "A field was added (column adder, Insert, Duplicate). `columns` is the whole column list after the change, as declared (store it as your `columns`); `data` is set when values were written too."
+            },
+            {
+                "key": "columnChange",
+                "label": "Column Change",
+                "prop": "onColumnChange",
+                "description": "A field was edited. `columns` as in `onColumnAdd`; `data` is set when a type change converted its values."
+            },
+            {
+                "key": "columnRemove",
+                "label": "Column Remove",
+                "prop": "onColumnRemove",
+                "description": "A field was deleted from the column menu (its values stay in the rows). `columns` as in `onColumnAdd`."
+            },
+            {
+                "key": "rowsDelete",
+                "label": "Rows Delete",
+                "prop": "onRowsDelete",
+                "description": "Rows were deleted from the selection bar's Delete (`deleteRows`): the rows and their ids, and the data without them, to store."
+            },
+            {
+                "key": "rowColorChange",
+                "label": "Row Color Change",
+                "prop": "onRowColorChange",
+                "description": "The rows were set to be colored by another field, or no longer colored, from a single select's column menu (\"Color rows by this field\" with `fieldMenu`). Store it and pass it back as `rowColor`."
+            },
             {
                 "key": "expandedChange",
                 "label": "Expanded Change",

package/dist/upgrade-prompt.d.ts

@@ -1,5 +1,5 @@
 /** Human-readable labels for the Enterprise surfaces that gate behind a license. */
-export type EnterpriseFeatureLabel = 'Export' | 'Import' | 'Print' | 'AI assistant' | 'Pivot' | 'Server-side row model' | 'Spreadsheet' | 'Studio';
+export type EnterpriseFeatureLabel = 'Export' | 'Import' | 'Print' | 'AI assistant' | 'Pivot' | 'Server-side row model' | 'Spreadsheet' | 'SvGrid Base' | 'Studio';
 /**
  * Show the contextual upgrade prompt for `feature`. No-ops if one has already
  * been shown this session, a card is already up, or we're on the server. Safe

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.7";
+export declare const SVGRID_VERSION = "3.1.9";
 /**
  * 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.7";
  *
  * `version.test.ts` asserts this matches packages/grid/package.json.
  */
-export declare const GRID_VERSION = "3.0.10";
+export declare const GRID_VERSION = "3.0.12";