@ketvietlab/ketsuite 0.1.2 → 0.1.3

package/dist/modules/backend/paging.js

@@ -4,7 +4,7 @@
 // told what page it is on — a query string the server reads and the browser
 // remembers. That is what makes the back button, a bookmark and a link somebody
 // pastes into chat all work with no code written for any of them.
-/** Odoo's default, and about as many rows as fit a laptop screen. */
+/** the domain contract's default, and about as many rows as fit a laptop screen. */
 export const PAGE_SIZE = 30;
 export const pageOf = (url) => {
     const n = Number(url.searchParams.get('page') ?? '1');

package/dist/modules/backend/paging.js.map

@@ -1 +1 @@
-{"version":3,"file":"paging.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/backend/paging.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paging.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/backend/paging.ts"],"names":[],"mappings":"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"}

package/dist/modules/backend/relation-select.d.ts

@@ -1,63 +1,8 @@
 import type { Route, ServeContext, Translator } from '@ketvietlab/ketjs';
 import type { JSXChild } from '@ketvietlab/ketjs-view';
-export type RelationOption = {
-    value: string;
-    label: string;
-    description?: string | null;
-};
-export type RelationEditorField = {
-    name: string;
-    label: string;
-    type?: 'text' | 'email' | 'tel' | 'select';
-    required?: boolean;
-    options?: RelationOption[];
-};
-export type RelationManager = {
-    listFunction: string;
-    listInput?: Record<string, unknown>;
-    searchParam?: string;
-    limitParam?: string;
-    limit?: number;
-    idField?: string;
-    labelField?: string;
-    descriptionField?: string;
-    saveFunction?: string;
-    saveDefaults?: Record<string, unknown>;
-    removeFunction?: string;
-    removeDefaults?: Record<string, unknown>;
-    fields?: RelationEditorField[];
-    excludeIds?: string[];
-};
-export type RelationSelectLabels = {
-    choose: string;
-    search: string;
-    more: string;
-    noRecords: string;
-    loading: string;
-    loadError: string;
-    dialogTitle: string;
-    close: string;
-    select: string;
-    create: string;
-    edit: string;
-    save: string;
-    cancel: string;
-    remove: string;
-    confirmRemove: string;
-    retry: string;
-};
-export type RelationSelectConfig = {
-    name: string;
-    ariaLabel: string;
-    value?: string | null;
-    options: RelationOption[];
-    required?: boolean;
-    disabled?: boolean;
-    labels: RelationSelectLabels;
-    manager?: RelationManager;
-};
+import type { RelationSelectConfig, RelationSelectLabels } from '../../ui/client/relation-select-view.tsx';
+export type { RelationEditorField, RelationManager, RelationOption, RelationSelectConfig, RelationSelectLabels, } from '../../ui/client/relation-select-view.tsx';
 type Req = Parameters<Route>[1];
 export declare const relationControl: (ctx: ServeContext, url: URL, req: Req, id: string, config: RelationSelectConfig) => Promise<JSXChild>;
 export declare const relationLabels: (_: Translator, dialogTitle: string) => RelationSelectLabels;
-export {};
 //# sourceMappingURL=relation-select.d.ts.map

package/dist/modules/backend/relation-select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relation-select.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/backend/relation-select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEtD,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAE1F,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B,CAAA;AAED,KAAK,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAE/B,eAAO,MAAM,eAAe,QACrB,YAAY,OACZ,GAAG,OACH,GAAG,MACJ,MAAM,UACF,oBAAoB,KAC3B,OAAO,CAAC,QAAQ,CAAmE,CAAA;AAEtF,eAAO,MAAM,cAAc,MAAO,UAAU,eAAe,MAAM,KAAG,oBAiBlE,CAAA"}
+{"version":3,"file":"relation-select.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/backend/relation-select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAE1G,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,0CAA0C,CAAA;AAEjD,KAAK,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAE/B,eAAO,MAAM,eAAe,QACrB,YAAY,OACZ,GAAG,OACH,GAAG,MACJ,MAAM,UACF,oBAAoB,KAC3B,OAAO,CAAC,QAAQ,CAAmE,CAAA;AAEtF,eAAO,MAAM,cAAc,MAAO,UAAU,eAAe,MAAM,KAAG,oBAmBlE,CAAA"}

package/dist/modules/backend/relation-select.js

@@ -16,5 +16,7 @@ export const relationLabels = (_, dialogTitle) => ({
     remove: _('backend.relation.remove'),
     confirmRemove: _('backend.relation.confirmRemove'),
     retry: _('backend.relation.retry'),
+    clear: _('backend.relation.clear'),
+    chosen: _('backend.relation.chosen'),
 });
 //# sourceMappingURL=relation-select.js.map

package/dist/modules/backend/relation-select.js.map

@@ -1 +1 @@
-{"version":3,"file":"relation-select.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/backend/relation-select.ts"],"names":[],"mappings":"AA8DA,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAiB,EACjB,GAAQ,EACR,GAAQ,EACR,EAAU,EACV,MAA4B,EACT,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,yBAAyB,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;AAEtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAa,EAAE,WAAmB,EAAwB,EAAE,CAAC,CAAC;IAC3F,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,4BAA4B,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,0BAA0B,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,4BAA4B,CAAC;IAC1C,WAAW;IACX,KAAK,EAAE,CAAC,CAAC,wBAAwB,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,gCAAgC,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,wBAAwB,CAAC;CACnC,CAAC,CAAA"}
+{"version":3,"file":"relation-select.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/backend/relation-select.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAiB,EACjB,GAAQ,EACR,GAAQ,EACR,EAAU,EACV,MAA4B,EACT,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,yBAAyB,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;AAEtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAa,EAAE,WAAmB,EAAwB,EAAE,CAAC,CAAC;IAC3F,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,4BAA4B,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,0BAA0B,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,4BAA4B,CAAC;IAC1C,WAAW;IACX,KAAK,EAAE,CAAC,CAAC,wBAAwB,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,uBAAuB,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,gCAAgC,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,wBAAwB,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,wBAAwB,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAAC;CACrC,CAAC,CAAA"}

package/dist/modules/backend/routes.d.ts

@@ -1,10 +1,3 @@
-import type { ServeContext, Route } from '@ketvietlab/ketjs';
-import type { Viewer } from '../../ui/index.ts';
-/**
- * Who is looking. The screens show it in the topbar, which is the difference
- * between a page that happens to be behind a login and one that says so.
- */
-export declare const viewerOf: (ctx: ServeContext, url: URL, req: Parameters<Route>[1]) => Promise<Viewer | null>;
-export declare const timezoneOf: (ctx: ServeContext, url: URL, req: Parameters<Route>[1]) => Promise<string>;
+import type { Route, ServeContext } from '@ketvietlab/ketjs';
 export declare const routes: Record<string, (ctx: ServeContext) => Route>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/modules/backend/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/backend/routes.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAG5D,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAS9D;;;GAGG;AACH,eAAO,MAAM,QAAQ,QACd,YAAY,OACZ,GAAG,OACH,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAyCvB,CAAA;AAED,eAAO,MAAM,UAAU,QAAe,YAAY,OAAO,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,MAAM,CAC/B,CAAA;AAgEzE,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,KAAK,CAuC/D,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/backend/routes.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAY,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAwCtE,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,KAAK,CAE/D,CAAA"}

package/dist/modules/backend/routes.js

@@ -2,122 +2,47 @@
 //
 // One factory per path: the path is data, so composition can settle ownership and
 // refuse two modules claiming the same one, while the handler is built at boot
-// because it needs the running server. Dispatch checks the live manifest, so these
-// stop answering the moment the module is switched off.
-import { isTimezone } from '@ketvietlab/ketjs';
-import { appsScreen, pagesScreen, settingsScreen } from './screens.js';
-import { backendPage } from '../../ui/index.js';
-import { colsHref, colsOf, pageOf, PAGE_SIZE, pager, searchOf } from './paging.js';
-/**
- * Who is looking. The screens show it in the topbar, which is the difference
- * between a page that happens to be behind a login and one that says so.
- */
-export const viewerOf = async (ctx, url, req) => {
-    const sessions = await ctx.sessionsOf(url, req);
-    const record = await sessions?.of(req);
-    if (!record)
-        return null;
-    const user = (await ctx.callUnchecked('user.getUser', { id: record.userId }, url, req));
-    const live = await ctx.live(req);
-    const labels = live.functions['company.contextLabels']
-        ? (await ctx.callUnchecked('company.contextLabels', { companyId: record.company, branchId: record.branch }, url, req))
-        : {};
-    const lang = url.searchParams.get('lang');
-    return {
-        name: user?.name ?? record.userId,
-        company: record.company,
-        companies: record.companies,
-        companyName: labels.companyName ?? record.company,
-        branch: record.branch,
-        branches: record.branches,
-        branchName: labels.branchIsRoot
-            ? `${ctx.translate(ctx.localeOf(url, req))('backend.context.rootBranch')} · ${labels.branchCode}`
-            : (labels.branchName ?? record.branch),
-        contextPath: live.routes['/admin/context']
-            ? `/admin/context${lang ? `?lang=${encodeURIComponent(lang)}` : ''}`
-            : null,
-        profilePath: live.routes['/admin/profile']
-            ? `/admin/profile${lang ? `?lang=${encodeURIComponent(lang)}` : ''}`
-            : null,
-        timezone: user?.timezone && isTimezone(user.timezone) ? user.timezone : ctx.config.defaultTimezone,
-    };
+// because it needs the running server.
+//
+// The frame these sit in belongs to `screen.ts`, which every other module uses too.
+import { text, withHeaders } from '@ketvietlab/ketjs';
+const firstPath = (nodes) => {
+    for (const node of nodes) {
+        if (node.path && node.path !== '/admin')
+            return node.path;
+        const child = firstPath(node.children);
+        if (child)
+            return child;
+    }
+    return null;
 };
-export const timezoneOf = async (ctx, url, req) => (await viewerOf(ctx, url, req))?.timezone ?? ctx.config.defaultTimezone;
 /**
- * The shell every backend screen sits in. The stylesheets come from ctx.styles(),
- * which is every installed module's, in dependency order — this module no longer
- * names even its own.
+ * Where `/admin` sends someone.
+ *
+ * The deployment gets asked first: its `navigation.home` entries are tried in
+ * order and the first condition this viewer may call wins. A housekeeper who can
+ * complete a cleaning task lands on the cleaning worklist rather than on whichever
+ * screen happens to sort first.
+ *
+ * Falling back to the first path in menu order is what every deployment does
+ * today, and it stays the answer for anyone no entry matches — but it is a
+ * fallback, not a decision. The entry with the smallest `sequence` is an accident
+ * of declaration order.
  */
-const screen = (ctx, build) => async (url, req) => {
-    const lang = ctx.localeOf(url, req);
-    const viewer = await viewerOf(ctx, url, req);
-    // Installed, and permitted: the sidebar never offers what the click would refuse.
-    const menu = await ctx.menu(url, req);
-    const menuFilter = url.searchParams.get('menu')?.trim() || null;
-    // Rendered once per request, so a screen stays a pure function of its data and
-    // the catalogue can render the same screens with no server at all.
-    const extras = {
-        'nav.items': await ctx.joint(url, req, 'backend:nav.items', { active: url.pathname }),
-        'topbar.end': await ctx.joint(url, req, 'backend:topbar.end'),
-        'sidebar.foot': req.headers['x-ket-navigation'] === 'fragment-v1'
-            ? undefined
-            : await ctx.joint(url, req, 'backend:sidebar.foot', { lang }),
-        'apps.footer': await ctx.joint(url, req, 'backend:apps.footer'),
-    };
-    return backendPage(ctx, req, {
-        lang,
-        title: 'KetSuite',
-        body: await build(ctx.translate(lang), {
-            url,
-            raw: req,
-            frame: {
-                navigation: req.headers['x-ket-navigation'] === 'fragment-v1',
-                viewer,
-                extras,
-                menu,
-                menuFilter,
-            },
-        }),
-    });
+const landing = async (ctx, url, req) => {
+    for (const entry of ctx.navigation?.home ?? []) {
+        if (await ctx.allows(entry.needs, url, req))
+            return entry.path;
+    }
+    return firstPath(await ctx.menu(url, req));
 };
-/**
- * The card joint takes the app as a prop, so it is rendered once per card here
- * rather than by the screen. Handing the screen a function instead would have been
- * shorter and would have made it depend on a runtime — and the catalogue renders
- * these same screens with no server at all.
- */
-const appsWith = (ctx) => async (_, r) => {
-    const apps = await ctx.appsOf(r.raw);
-    const perApp = Object.fromEntries(await Promise.all(apps.map(async (app) => [app.name, await ctx.joint(r.url, r.raw, 'backend:app-card.actions', { app })])));
-    return appsScreen(_, apps, { ...r.frame, extras: { ...r.frame.extras, 'app-card.actions': perApp } });
+const admin = (ctx) => async (url, req) => {
+    const target = await landing(ctx, url, req);
+    return target
+        ? withHeaders(text('', { status: 303 }), { location: target })
+        : text('This deployment has no admin screen available.', { status: 404 });
 };
 export const routes = {
-    '/admin': (ctx) => screen(ctx, appsWith(ctx)),
-    '/admin/apps': (ctx) => screen(ctx, appsWith(ctx)),
-    '/admin/pages': (ctx) => screen(ctx, async (_, { url, raw, frame }) => {
-        // Paging and searching are in the URL, so page four is a link you can send
-        // someone and the back button needs no help from us.
-        const search = searchOf(url);
-        const page = pageOf(url);
-        const filter = { includeDrafts: true, search };
-        // The same call path as the API: this request's live manifest and company.
-        const rows = (await ctx.call('website.listPages', { ...filter, limit: PAGE_SIZE, offset: (page - 1) * PAGE_SIZE }, url, raw));
-        const { count } = (await ctx.call('website.countPages', filter, url, raw));
-        return pagesScreen(_, rows.map((r) => ({ ...r, published: !!r.published })), {
-            ...frame,
-            chrome: {
-                search: {
-                    name: 'q',
-                    value: search ?? '',
-                    placeholder: _('backend.chrome.searchPages'),
-                    facets: search
-                        ? [{ label: `${_('backend.chrome.searchFacet')}: ${search}`, without: url.pathname }]
-                        : [],
-                },
-                pager: pager(url, page, rows.length, count),
-            },
-        }, { shown: colsOf(url), colsHref: colsHref(url) });
-    }),
-    '/admin/settings': (ctx) => screen(ctx, (_, { frame }) => settingsScreen(_, ctx.manifest.tokens, frame)),
+    '/admin': admin,
 };
 //# sourceMappingURL=routes.js.map

package/dist/modules/backend/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/backend/routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../../../../../packages/ketsuite/src/modules/backend/routes.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,uCAAuC;AACvC,EAAE;AACF,oFAAoF;AAEpF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAGrD,MAAM,SAAS,GAAG,CAAC,KAAiB,EAAiB,EAAE;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,IAAI,CAAA;QACzD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,GAAG,KAAK,EAAE,GAAiB,EAAE,GAAQ,EAAE,GAAyB,EAA0B,EAAE;IACvG,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QAC/C,IAAI,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,CAAA;IAChE,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,KAAK,GACT,CAAC,GAAiB,EAAS,EAAE,CAC7B,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACjB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC3C,OAAO,MAAM;QACX,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC9D,CAAC,CAAC,IAAI,CAAC,gDAAgD,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;AAC7E,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,MAAM,GAAiD;IAClE,QAAQ,EAAE,KAAK;CAChB,CAAA"}

package/dist/modules/backend/screen.d.ts

@@ -0,0 +1,130 @@
+import type { Route, ServeContext, Translator } from '@ketvietlab/ketjs';
+import type { TemplateResult } from '@ketvietlab/ketjs-view';
+import { backendPage } from '../../ui/index.ts';
+import type { Extras, Frame, FormField, Viewer } from '../../ui/index.ts';
+/** The raw request a route handler is handed. */
+export type Req = Parameters<Route>[1];
+/** A row as a screen sees it: the domain owns the shape, the screen reads fields. */
+export type AnyRow = Record<string, unknown>;
+/**
+ * Who is looking. The screens show it in the topbar, which is the difference
+ * between a page that happens to be behind a login and one that says so.
+ */
+export declare const viewerOf: (ctx: ServeContext, url: URL, req: Req) => Promise<Viewer | null>;
+export declare const timezoneOf: (ctx: ServeContext, url: URL, req: Req) => Promise<string>;
+export type FrameOptions = {
+    /**
+     * The list a detail page belongs to. A quotation at `/admin/sales/quotations/{id}`
+     * highlights the Quotations entry; without this the sidebar marks nothing, which
+     * reads as "you have left this section".
+     */
+    active?: string;
+    /** Screen-specific joints, merged over the ones every screen gets. */
+    extras?: Extras;
+};
+/**
+ * The shell's half of a screen.
+ *
+ * `sidebar.foot` is skipped for a navigation fragment on purpose: the foot sits
+ * outside `[data-ui="sidebar-main"]`, so it is not one of the slots the client
+ * replaces, and rendering its islands would build markup the browser discards.
+ */
+export declare const frameOf: (ctx: ServeContext, url: URL, req: Req, options?: FrameOptions) => Promise<Frame>;
+export type ScreenOptions = FrameOptions & {
+    /** A message key by default; pass `translate: false` for a literal. */
+    title: string;
+    translate?: boolean;
+    status?: number;
+};
+/**
+ * A whole backend response: frame, translator, and the document-or-fragment
+ * decision. The body is a function rather than a value so nothing is rendered
+ * before the frame it sits in is known.
+ */
+export declare const adminPage: (ctx: ServeContext, url: URL, req: Req, options: ScreenOptions & {
+    body: (_: Translator, frame: Frame) => TemplateResult | Promise<TemplateResult>;
+}) => Promise<ReturnType<typeof backendPage>>;
+/**
+ * A GET-only screen, for the common case where the route does nothing but read.
+ * Anything that also accepts POST dispatches itself and calls `adminPage`.
+ */
+export declare const screen: (ctx: ServeContext, options: ScreenOptions & {
+    body: (_: Translator, frame: Frame, url: URL, req: Req) => TemplateResult | Promise<TemplateResult>;
+}) => Route;
+/**
+ * The same path in the language currently being read.
+ *
+ * `?lang=` is how the backend switches locale, so every link a screen builds has
+ * to carry it or the next click silently reverts. It takes the path apart rather
+ * than appending a suffix: half the modules used to append `?lang=` and the other
+ * half had to write a second helper to repair the ones that already had a query.
+ */
+export declare const inLocale: (url: URL, path: string) => string;
+/**
+ * The `?lang=` a screen has to carry into every link it builds.
+ *
+ * A screen is a pure function of its data, so it cannot read the request; it is
+ * handed this instead. Empty when the reader never asked for a language, which is
+ * the common case and leaves the URLs clean.
+ */
+export declare const localeQuery: (url: URL) => string;
+/**
+ * A path plus that query, whether or not the path already had one.
+ *
+ * Eleven copies of this used to live in eleven screen files, four of them written
+ * differently and one of them producing `…?state=draft?lang=en`. Taking the URL
+ * apart rather than concatenating is what makes the question stop coming up.
+ */
+export declare const localized: (path: string, locale: string) => string;
+/** Rows as `<select>` options; `empty` adds the "not chosen" one at the top. */
+export declare const choices: (rows: readonly AnyRow[], empty?: boolean) => {
+    value: string;
+    label: string;
+}[];
+/**
+ * The print group on a record screen.
+ *
+ * Four backends each built this by hand with `label: 'Print'` written in as an
+ * English literal, so the group read "Print" on a Vietnamese screen while the
+ * document names beside it were translated. One helper, one translated label.
+ */
+export declare const printGroup: (_: Translator, reports: ReadonlyArray<{
+    id: string;
+    title: string;
+}>, recordId: string, search: string) => TemplateResult | undefined;
+/**
+ * A required select with nothing to select is a dead end.
+ *
+ * The browser refuses to submit an empty required dropdown and says only
+ * "please select an item in the list" — it cannot say that the tenant has no
+ * warehouse yet, or no sales journal, or no income account. The form looks
+ * broken and the screen offers no way out. Naming what is missing, and where to
+ * create it, turns a dead end back into a next step.
+ */
+export declare const needs: (field: FormField, hint: string) => FormField;
+/** A field the domain should not see at all when the form left it blank. */
+export declare const optional: (form: Record<string, string>, name: string) => {
+    [x: string]: string;
+};
+/**
+ * A stable domain code shown in the reader's language.
+ *
+ * The code stays in the DOM as `data-value` so a stylesheet and a test can both
+ * name it; only the words change. A code with no message key falls back to itself,
+ * which is how the pseudo-locale shows up an untranslated selection immediately.
+ */
+export declare const selectionLabel: (_: Translator, prefix: string, group: string, value: unknown) => string;
+export declare const selectionOptions: (_: Translator, prefix: string, group: string, values: readonly string[]) => Array<{
+    value: string;
+    label: string;
+}>;
+/**
+ * A failed call's reasons, in the reader's language.
+ *
+ * The domain answers with `{ field, code, params }` — machine-readable, so the
+ * words are chosen here rather than by a function that has no idea who is reading.
+ * `fallback` is the module's own "that value will not do", for the rare error that
+ * arrives with nothing but a shape.
+ */
+export declare const resultErrors: (result: unknown, _: Translator, fallback: string) => string[];
+//# sourceMappingURL=screen.d.ts.map

package/dist/modules/backend/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketsuite/src/modules/backend/screen.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAe,WAAW,EAAc,MAAM,mBAAmB,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAEzE,iDAAiD;AACjD,MAAM,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtC,qFAAqF;AACrF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE5C;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAe,YAAY,OAAO,GAAG,OAAO,GAAG,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAyC3F,CAAA;AAED,eAAO,MAAM,UAAU,QAAe,YAAY,OAAO,GAAG,OAAO,GAAG,KAAG,OAAO,CAAC,MAAM,CACd,CAAA;AAEzE,MAAM,MAAM,YAAY,GAAG;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,QACb,YAAY,OACZ,GAAG,OACH,GAAG,YACC,YAAY,KACpB,OAAO,CAAC,KAAK,CAqBf,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IACzC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,QACf,YAAY,OACZ,GAAG,OACH,GAAG,WACC,aAAa,GAAG;IACvB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CAChF,KACA,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAUxC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,QAEV,YAAY,WACR,aAAa,GAAG;IACvB,IAAI,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACpG,KACA,KAE6F,CAAA;AAElG;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,QAAS,GAAG,QAAQ,MAAM,KAAG,MAKjD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,QAAS,GAAG,KAAG,MAGtC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,SAAU,MAAM,UAAU,MAAM,KAAG,MAMxD,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,OAAO,SAAU,SAAS,MAAM,EAAE;;;GAM9C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,MAClB,UAAU,WACJ,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,YAC3C,MAAM,UACR,MAAM,KACb,cAAc,GAAG,SAWL,CAAA;AAEf;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,UAAW,SAAS,QAAQ,MAAM,KAAG,SAGT,CAAA;AAE9C,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,SAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,MAAM;;CACzB,CAAA;AAE1C;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,MAAO,UAAU,UAAU,MAAM,SAAS,MAAM,SAAS,OAAO,KAAG,MAI7F,CAAA;AAED,eAAO,MAAM,gBAAgB,MACxB,UAAU,UACL,MAAM,SACP,MAAM,UACL,SAAS,MAAM,EAAE,KACxB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAC2C,CAAA;AASpF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,WAAY,OAAO,KAAK,UAAU,YAAY,MAAM,KAAG,MAAM,EAIlF,CAAA"}