@svgrid/enterprise 2.0.4 → 2.2.0

package/src/studio/emit-schema.ts

@@ -12,7 +12,31 @@
  */
 import { resolveIdField, titleCase, type EntityField, type EntityFieldType, type EntitySchema, type ValidationRuleSpec } from '../schema.js'
 import type { GeneratedFile } from './scaffold.js'
-import type { EntityDataSource, RestSource, ShellConfig, SqlDialectKind } from './project.js'
+import type { EntityDataSource, RestSource, ShellConfig, ShellStyle, SqlDialectKind, EntityTriggers, TriggerEvent } from './project.js'
+import { sanitizeClassName, compileTriggerSteps, TRIGGER_EVENTS } from './project.js'
+
+/** Build the createKitHandlers `hooks: {...}` option from an entity's triggers.
+ *  before-hooks alias the mutable payload as `v`; after-hooks alias the saved row. */
+function triggerHooksOpt(triggers: EntityTriggers | undefined): string | null {
+  if (!triggers) return null
+  const SHAPE: Record<TriggerEvent, { param: string; alias: string }> = {
+    beforeCreate: { param: '{ values }', alias: 'const v = values as Record<string, unknown>' },
+    beforeUpdate: { param: '{ patch }', alias: 'const v = patch as Record<string, unknown>' },
+    beforeDelete: { param: '{ id }', alias: 'const v = { id } as Record<string, unknown>' },
+    afterCreate: { param: '{ row }', alias: 'const v = row as Record<string, unknown>' },
+    afterUpdate: { param: '{ row }', alias: 'const v = row as Record<string, unknown>' },
+    afterDelete: { param: '{ id }', alias: 'const v = { id } as Record<string, unknown>' },
+  }
+  const entries: string[] = []
+  for (const ev of TRIGGER_EVENTS) {
+    const steps = triggers[ev]
+    if (!steps?.length) continue
+    const { param, alias } = SHAPE[ev]
+    const body = compileTriggerSteps(steps).split('\n').map((l) => (l ? '      ' + l : l)).join('\n')
+    entries.push(`    ${ev}: async (${param}) => {\n      ${alias}\n${body}\n    }`)
+  }
+  return entries.length ? `hooks: {\n${entries.join(',\n')},\n  }` : null
+}
 import { generateValue } from './sample-data.js'
 
 const pascal = (name: string): string =>
@@ -311,7 +335,7 @@ const SQL_DRIVERS: Record<'postgres' | 'mysql' | 'mssql' | 'sqlite' | 'turso', {
  *  the route imports the shared access policy and rejects unauthorized writes -
  *  server-enforced, so a tampered client can't bypass it. When audit is on, every
  *  successful write is recorded. */
-function sqlRouteFile(schema: EntitySchema, table: string, dialect?: SqlDialectKind, feat: { access?: boolean; audit?: boolean } = {}): GeneratedFile {
+function sqlRouteFile(schema: EntitySchema, table: string, dialect?: SqlDialectKind, feat: { access?: boolean; audit?: boolean; screenIds?: string[]; triggers?: EntityTriggers } = {}): GeneratedFile {
   const n = namesFor(schema)
   const key = (dialect === 'supabase' ? 'postgres' : (dialect ?? 'postgres')) as 'postgres' | 'mysql' | 'mssql' | 'sqlite' | 'turso'
   const driver = SQL_DRIVERS[key]
@@ -321,8 +345,11 @@ function sqlRouteFile(schema: EntitySchema, table: string, dialect?: SqlDialectK
   // Every connected route validates writes against the schema server-side, and
   // (when enabled) authorizes them by role + records an audit entry.
   const opts = [`schema: ${n.schemaVar}`, `source`, `validate: true`]
-  if (feat.access) opts.push(`// Server-enforced RBAC: the caller's role comes from the session (event.locals).\n  authorize: ({ action, event }) => authorizeAction(getServerRole(event), action)`)
+  if (feat.access) opts.push(`// Server-enforced RBAC: the caller's role comes from the session (event.locals). Reads\n  // are allowed only if the role can open one of this entity's own screens.\n  authorize: ({ action, event }) => authorizeAction(getServerRole(event), action, ${JSON.stringify(feat.screenIds ?? [])})`)
   if (feat.audit) opts.push(`// Record every successful write to the audit trail.\n  audit: (e) => recordAudit({ entity: ${JSON.stringify(schema.name)}, action: e.action, recordId: e.id, values: e.values as Record<string, unknown> | undefined, actor: String(e.event.locals?.role ?? e.event.locals?.user ?? 'system') })`)
+  // Server-enforced business rules: the entity's triggers compiled to lifecycle hooks.
+  const hooks = triggerHooksOpt(feat.triggers)
+  if (hooks) opts.push(`// Business rules, enforced server-side (a client that skips them still can't write bad data).\n  ${hooks}`)
   const handlers = `export const { POST } = createKitHandlers({\n  ${opts.join(',\n  ')},\n})`
   return {
     path: `src/routes/api/${n.route}/+server.ts`,
@@ -553,20 +580,44 @@ export function entityScreenPage(schema: EntitySchema, route?: string, title?: s
 
 export type NavItem = { href: string; label: string; id?: string }
 
-export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: ShellConfig; title?: string; themeVars?: Record<string, string>; dark?: boolean; access?: boolean; i18n?: boolean } = {}): GeneratedFile {
-  const links = [{ href: '/', label: 'Home' }, ...nav]
+export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: ShellConfig; title?: string; themeVars?: Record<string, string>; lightVars?: Record<string, string>; darkVars?: Record<string, string>; dark?: boolean; access?: boolean; auth?: boolean; authRoutes?: string[]; authAccount?: boolean; i18n?: boolean; appClass?: string } = {}): GeneratedFile {
+  // Nav is the app's own screens; `/` just redirects to the first one, so no separate
+  // "Home" link (it would duplicate the first screen).
+  const links = nav
   const shell = opts.shell ?? {}
-  const style: 'sidebar' | 'top-nav' = shell.style ?? 'sidebar'
+  const style: ShellStyle = shell.style ?? 'sidebar'
+  // App-level styling hook: an extra class on the shell root so custom.css can target the whole app.
+  const appCls = sanitizeClassName(opts.appClass)
+  const appClsAttr = appCls ? ` ${appCls}` : ''
   const brand = (shell.brand ?? '').trim() || opts.title || 'My Studio App'
   const footer = shell.footer === undefined ? 'Built with SvGrid Studio' : shell.footer
   const right = style === 'sidebar' && shell.navPosition === 'right'
-  // Emit the full theme token bundle (+ color-scheme for dark themes) so the
-  // generated app matches the look-and-feel picked in the designer.
-  const vars = { ...(opts.themeVars ?? {}) }
-  if (opts.accent) vars['--sg-accent'] = opts.accent
-  const varLines = Object.entries(vars).map(([k, v]) => `${k}: ${v};`).join(' ')
-  const rootRule = [varLines, opts.dark ? 'color-scheme: dark;' : ''].filter(Boolean).join(' ')
-  const themeHead = rootRule ? `\n<svelte:head><style>:root { ${rootRule} }</style></svelte:head>\n` : ''
+  // Emit the full theme token bundle so the generated app matches the look chosen
+  // in the designer. When both light + dark token sets are supplied we ship a
+  // built-in light/dark switcher: both sets are scoped by [data-theme] on <html>,
+  // and the bare :root falls back to the mode picked in Studio (pre-hydration).
+  const defaultMode: 'light' | 'dark' = opts.dark ? 'dark' : 'light'
+  const withAccent = (m?: Record<string, string>) => {
+    const v = { ...(m ?? {}) }
+    if (opts.accent) v['--sg-accent'] = opts.accent
+    return v
+  }
+  const declLines = (m: Record<string, string>) => Object.entries(m).map(([k, v]) => `${k}: ${v};`).join(' ')
+  const hasSwitch = !!(opts.lightVars && opts.darkVars)
+  let themeHead = ''
+  if (hasSwitch) {
+    const lv = withAccent(opts.lightVars)
+    const dv = withAccent(opts.darkVars)
+    const defRule = [declLines(defaultMode === 'dark' ? dv : lv), `color-scheme: ${defaultMode};`].join(' ')
+    const lightRule = [declLines(lv), 'color-scheme: light;'].join(' ')
+    const darkRule = [declLines(dv), 'color-scheme: dark;'].join(' ')
+    themeHead = `\n<svelte:head><style>:root { ${defRule} }\n:root[data-theme="light"] { ${lightRule} }\n:root[data-theme="dark"] { ${darkRule} }</style></svelte:head>\n`
+  } else {
+    const vars = withAccent(opts.themeVars)
+    const varLines = declLines(vars)
+    const rootRule = [varLines, opts.dark ? 'color-scheme: dark;' : ''].filter(Boolean).join(' ')
+    themeHead = rootRule ? `\n<svelte:head><style>:root { ${rootRule} }</style></svelte:head>\n` : ''
+  }
 
   // i18n: translate nav labels via `nav.<id>` keys (Home has no id -> literal).
   const navLabel = opts.i18n ? `{item.id ? $t('nav.' + item.id, item.label) : item.label}` : '{item.label}'
@@ -580,18 +631,28 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
         {#each locales as loc (loc)}<option value={loc} selected={loc === $currentLocale}>{loc}</option>{/each}
       </select>`
     : ''
+  const toolbarOn = shell.toolbar !== false && nav.length > 0
+  // Built-in light/dark switcher (a sun/moon button). Lives in the toolbar's tools
+  // cluster when the toolbar is on, else trails the nav links. Only rendered when
+  // both token sets are available (i.e. from the full Studio project emitter).
+  const themeToggleBtn = `<button type="button" class="sv-app__tool sv-app__theme" aria-label="Toggle color theme" title="Toggle light / dark" onclick={toggleTheme}>
+          {#if theme === 'dark'}<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="4"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg>{:else}<svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z"/></svg>{/if}
+        </button>`
+  // When there's no toolbar, the toggle trails the nav in its own inline slot.
+  const navToggleSlot = hasSwitch && !toolbarOn ? `\n      <div class="sv-app__navtools">${themeToggleBtn}</div>` : ''
   // Clicking any nav link closes the mobile drawer.
   const linksMarkup = `<nav class="sv-app__links" onclick={() => (navOpen = false)}>
       {#each nav as item (item.href)}
         ${linkGate}
       {/each}
-    </nav>${localeSwitcher}`
+    </nav>${localeSwitcher}${navToggleSlot}`
   const footMarkup = footer ? `\n      <span class="sv-app__foot">{footer}</span>` : ''
   const footConst = footer ? `\n  const footer = ${JSON.stringify(footer)}` : ''
   // Sidebar-only: a collapsible sidebar that docks on wide screens and becomes an
   // off-canvas drawer when collapsed or on tablet/phone (<= 1024px). The collapse
-  // choice persists; tablet/phone start collapsed.
-  const sideState = style === 'top-nav' ? '' : `
+  // choice persists; tablet/phone start collapsed. top-nav and bottom-nav are
+  // always-visible bars with no collapse/drawer state.
+  const sideState = style !== 'sidebar' ? '' : `
   let collapsed = $state(false)
   let narrow = $state(false)
   const drawer = $derived(collapsed || narrow)
@@ -629,7 +690,6 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
   // App-chrome toolbar (docked at the top of the content area for both layouts):
   // a functional quick-search over the app's screens + an account cluster. Reads as
   // a real product header. Opt out with `shell.toolbar === false`.
-  const toolbarOn = shell.toolbar !== false && nav.length > 0
   const initials = ((brand.match(/\b[A-Za-z0-9]/g) ?? []).slice(0, 2).join('') || 'A').toUpperCase()
   const brandSlug = brand.toLowerCase().replace(/[^a-z0-9]+/g, '') || 'app'
   const resultLabel = opts.i18n ? `{r.id ? $t('nav.' + r.id, r.label) : r.label}` : '{r.label}'
@@ -648,6 +708,7 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
         {/if}
       </div>
       <div class="sv-app__tools">
+        ${hasSwitch ? themeToggleBtn : ''}
         <div class="sv-app__pop">
           <button type="button" class="sv-app__tool" aria-label="Notifications" aria-expanded={bellOpen} onclick={() => { bellOpen = !bellOpen; menuOpen = false }}>
             <svg viewBox="0 0 24 24" width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M18 8a6 6 0 0 0-12 0c0 7-3 9-3 9h18s-3-2-3-9"/><path d="M13.7 21a2 2 0 0 1-3.4 0"/></svg>
@@ -667,11 +728,15 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
           <button type="button" class="sv-app__avatar" title={brand} aria-label="Account" aria-expanded={menuOpen} onclick={() => { menuOpen = !menuOpen; bellOpen = false }}>{initials}</button>
           {#if menuOpen}
             <div class="sv-app__menu sv-app__menu--acct" role="menu">
-              <div class="sv-app__acct-head"><span class="sv-app__avatar sv-app__avatar--lg" aria-hidden="true">{initials}</span><div class="sv-app__acct-id"><strong>{brand}</strong><span>{acctEmail}</span></div></div>
+              <div class="sv-app__acct-head"><span class="sv-app__avatar sv-app__avatar--lg" aria-hidden="true">{initials}</span><div class="sv-app__acct-id"><strong>${opts.auth ? '{data?.user?.name ?? brand}' : '{brand}'}</strong><span>${opts.auth ? '{data?.user?.email ?? acctEmail}' : '{acctEmail}'}</span></div></div>
               <a class="sv-app__menu-item" href="/" role="menuitem" onclick={() => (menuOpen = false)}>Dashboard</a>
-              <button type="button" class="sv-app__menu-item" role="menuitem" onclick={() => (menuOpen = false)}>Profile</button>
-              <button type="button" class="sv-app__menu-item" role="menuitem" onclick={() => (menuOpen = false)}>Settings</button>
-              <button type="button" class="sv-app__menu-item sv-app__menu-item--danger" role="menuitem" onclick={() => (menuOpen = false)}>Sign out</button>
+              ${opts.authAccount
+                ? `<a class="sv-app__menu-item" href="/account" role="menuitem" onclick={() => (menuOpen = false)}>Account</a>`
+                : `<button type="button" class="sv-app__menu-item" role="menuitem" onclick={() => (menuOpen = false)}>Profile</button>
+              <button type="button" class="sv-app__menu-item" role="menuitem" onclick={() => (menuOpen = false)}>Settings</button>`}
+              ${opts.auth
+                ? `<form method="POST" action="/logout" class="sv-app__signout"><button type="submit" class="sv-app__menu-item sv-app__menu-item--danger" role="menuitem">Sign out</button></form>`
+                : `<button type="button" class="sv-app__menu-item sv-app__menu-item--danger" role="menuitem" onclick={() => (menuOpen = false)}>Sign out</button>`}
             </div>
           {/if}
         </div>
@@ -686,14 +751,22 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
   </main>`
 
   const body = style === 'top-nav'
-    ? `<div class="sv-app sv-app--top">
+    ? `<div class="sv-app sv-app--top${appClsAttr}">
   <header class="sv-app__bar">
     ${brandLink}
     ${linksMarkup}
   </header>
   ${mainMarkup}${footer ? `\n  <footer class="sv-app__footbar">{footer}</footer>` : ''}
 </div>`
-    : `<div class="sv-app sv-app--side${right ? ' sv-app--right' : ''}" class:is-drawer={drawer} class:is-navopen={navOpen}>
+    : style === 'bottom-nav'
+    ? `<div class="sv-app sv-app--bottom${appClsAttr}">
+  ${mainMarkup}
+  <footer class="sv-app__bar sv-app__bar--bottom">
+    ${brandLink}
+    ${linksMarkup}
+  </footer>
+</div>`
+    : `<div class="sv-app sv-app--side${right ? ' sv-app--right' : ''}${appClsAttr}" class:is-drawer={drawer} class:is-navopen={navOpen}>
   ${mobileBar}
   <aside class="sv-app__side">
     <div class="sv-app__sidehead">
@@ -717,6 +790,24 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
     .sv-app__bar { flex-direction: column; align-items: stretch; gap: 10px; padding: 10px 14px; }
     .sv-app__links { flex-wrap: nowrap; overflow-x: auto; padding-bottom: 2px; -webkit-overflow-scrolling: touch; }
     .sv-app__link { white-space: nowrap; }
+  }`
+    : style === 'bottom-nav'
+    ? `  .sv-app--bottom { display: flex; flex-direction: column; min-height: 100vh; }
+  .sv-app__bar--bottom {
+    position: fixed; left: 0; right: 0; bottom: 0; z-index: 40;
+    display: flex; align-items: center; gap: 20px; padding: 12px 22px calc(12px + env(safe-area-inset-bottom, 0px));
+    border-top: 1px solid color-mix(in srgb, var(--sg-fg, #0f172a) 16%, var(--sg-border, #e6e8ec));
+    background: var(--sg-header-bg, #f8fafc);
+  }
+  .sv-app__bar--bottom .sv-app__links { display: flex; flex-direction: row; gap: 4px; flex-wrap: wrap; }
+  /* Clears the fixed bottom bar so page content never renders underneath it. */
+  .sv-app--bottom .sv-app__main { padding-bottom: 70px; }
+  /* Mobile: brand drops out so the tab strip stays roomy; ties overflow to a horizontal scroll if there are many screens. */
+  @media (max-width: 640px) {
+    .sv-app__bar--bottom { gap: 10px; padding: 6px 12px calc(6px + env(safe-area-inset-bottom, 0px)); }
+    .sv-app__bar--bottom .sv-app__brand { display: none; }
+    .sv-app__bar--bottom .sv-app__links { flex-wrap: nowrap; overflow-x: auto; justify-content: flex-start; -webkit-overflow-scrolling: touch; }
+    .sv-app__bar--bottom .sv-app__link { white-space: nowrap; }
   }`
     : `  .sv-app--side { display: grid; grid-template-columns: 240px minmax(0, 1fr); min-height: 100vh; }
   .sv-app--side.sv-app--right { grid-template-columns: minmax(0, 1fr) 240px; }
@@ -750,14 +841,30 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
     description: `App shell (${style}): nav linking every screen.`,
     contents: `<script lang="ts">
   import '../app.css'
-  import { page } from '$app/stores'${opts.access ? `\n  import { currentRole, canScreen } from '$lib/access'` : ''}${opts.i18n ? `\n  import { t, currentLocale, locales } from '$lib/i18n'` : ''}
+  import '../custom.css'
+  import { page } from '$app/stores'${opts.access ? `\n  import { currentRole, canScreen } from '$lib/access'` : ''}${opts.i18n ? `\n  import { t, currentLocale, locales } from '$lib/i18n'` : ''}${opts.auth ? `\n  import type { LayoutData } from './$types'` : ''}
 
-  let { children } = $props()
+  let { children${opts.auth ? ', data' : ''} }${opts.auth ? ": { children: import('svelte').Snippet; data: LayoutData }" : ''} = $props()
   const nav = ${JSON.stringify(links)}
   const brand = ${JSON.stringify(brand)}${footConst}${logoConst}
-  let navOpen = $state(false)
+  let navOpen = $state(false)${opts.auth && opts.access ? `\n  // Seed the client role store from the signed-in session (server-resolved).\n  $effect(() => { if (data?.role) currentRole.set(data.role as never) })` : ''}
   // Close the mobile drawer whenever the route changes.
-  $effect(() => { void $page.url.pathname; navOpen = false })${sideState}${toolbarOn ? `
+  $effect(() => { void $page.url.pathname; navOpen = false })${hasSwitch ? `
+  // Light/dark switcher: defaults to the mode picked in Studio, then honours the
+  // visitor's saved choice. Applies via [data-theme] on <html> (see the token
+  // sets in <svelte:head>), and persists per browser.
+  let theme = $state<'light' | 'dark'>('${defaultMode}')
+  function applyTheme(t: 'light' | 'dark') {
+    theme = t
+    try { document.documentElement.dataset.theme = t } catch (_) { /* no DOM */ }
+    try { localStorage.setItem('svapp:theme', t) } catch (_) { /* storage blocked */ }
+  }
+  function toggleTheme() { applyTheme(theme === 'dark' ? 'light' : 'dark') }
+  $effect(() => {
+    let t: 'light' | 'dark' = '${defaultMode}'
+    try { const s = localStorage.getItem('svapp:theme'); if (s === 'light' || s === 'dark') t = s } catch (_) { /* storage blocked */ }
+    applyTheme(t)
+  })` : ''}${sideState}${toolbarOn ? `
   // App-chrome quick-search: filter the screens by label as you type.
   const initials = ${JSON.stringify(initials)}
   const acctEmail = ${JSON.stringify(`admin@${brandSlug}.com`)}
@@ -785,7 +892,11 @@ export function layoutFile(nav: NavItem[], opts: { accent?: string; shell?: Shel
 </script>
 ${themeHead}
 
+${opts.auth ? `{#if ${JSON.stringify(opts.authRoutes ?? ['/login'])}.includes($page.url.pathname)}
+{@render children()}
+{:else}
 ${body}
+{/if}` : body}
 
 <style>
 ${styles}
@@ -831,7 +942,13 @@ ${styles}
   .sv-app__menu-item { display: block; width: 100%; text-align: left; padding: 8px 10px; font: inherit; font-size: 13px; color: var(--sg-fg, #334155); background: none; border: none; border-radius: 8px; text-decoration: none; cursor: pointer; }
   .sv-app__menu-item:hover { background: color-mix(in srgb, var(--sg-accent, #6366f1) 10%, transparent); color: var(--sg-accent, #6366f1); }
   .sv-app__menu-item--danger:hover { background: color-mix(in srgb, #ef4444 12%, transparent); color: #ef4444; }
+  .sv-app__signout { margin: 0; display: block; }
+  .sv-app__signout .sv-app__menu-item { width: 100%; }
   .sv-app__locale { margin-top: 10px; padding: 5px 8px; font: inherit; font-size: 12.5px; color: var(--sg-fg, #0f172a); background: var(--sg-bg, #fff); border: 1px solid var(--sg-border, #e6e8ec); border-radius: 8px; }
+  .sv-app__theme { align-items: center; justify-content: center; cursor: pointer; }
+  /* No-toolbar fallback slot: trails the nav, pushed to the far edge in row bars. */
+  .sv-app__navtools { display: flex; align-items: center; }
+  .sv-app--top .sv-app__navtools, .sv-app__bar--bottom .sv-app__navtools { margin-left: auto; }
   /* Mobile bar + drawer chrome (hidden on desktop; media queries above switch it on) */
   .sv-app__mobilebar { display: none; align-items: center; gap: 12px; padding: 10px 14px; border-bottom: 1px solid var(--sg-border, #e6e8ec); background: var(--sg-header-bg, #f8fafc); position: sticky; top: 0; z-index: 50; }
   .sv-app__burger { display: inline-flex; align-items: center; justify-content: center; width: 40px; height: 40px; padding: 0; border: 1px solid var(--sg-border, #e6e8ec); border-radius: 9px; background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a); cursor: pointer; }
@@ -894,13 +1011,13 @@ export function prepareEntities(schemas: EntitySchema[]): { entries: Prepared[];
 /** Emit the shared entity modules: `src/lib/schemas.ts` + `src/lib/data.ts` (+ `connections.ts`). */
 export function emitEntityModules(
   schemas: EntitySchema[],
-  opts: { sources?: Record<string, EntityDataSource>; accessEnabled?: boolean; auditEnabled?: boolean } = {},
+  opts: { sources?: Record<string, EntityDataSource>; accessEnabled?: boolean; auditEnabled?: boolean; screensByEntity?: Map<string, string[]>; triggers?: Record<string, EntityTriggers> } = {},
 ): { files: GeneratedFile[]; prepared: EntitySchema[] } {
   const { entries, seed } = prepareEntities(schemas)
   const { file: data, needs } = dataModule(entries, seed, opts.sources)
   const files: GeneratedFile[] = [schemasModule(entries), data]
   if (needs.supabase) files.push(connectionsModule(needs))
-  for (const r of needs.sqlRoutes) files.push(sqlRouteFile(r.schema, r.table, r.dialect, { access: opts.accessEnabled, audit: opts.auditEnabled }))
+  for (const r of needs.sqlRoutes) files.push(sqlRouteFile(r.schema, r.table, r.dialect, { access: opts.accessEnabled, audit: opts.auditEnabled, screenIds: opts.screensByEntity?.get(r.schema.name) ?? [], triggers: opts.triggers?.[r.schema.name] }))
   return { files, prepared: entries.map((e) => e.schema) }
 }