@ketvietlab/ketjs 0.1.1

package/dist/kernel/i18n.js

@@ -0,0 +1,79 @@
+// Translations, declared by the module that owns the strings.
+//
+// Same rule as everything else: a module declares what it contributes and the
+// composer merges it. Keys are prefixed with the module name, so two modules can
+// both have a "title" without either knowing about the other — the collision that
+// makes a flat global catalogue rot.
+//
+// Missing translations are never an error. A build that breaks because a Danish
+// string is absent is a build nobody will translate into Danish. They fall back,
+// and `missingMessages()` reports the gaps for whoever is filling them in.
+const PLACEHOLDER = /\{(\w+)\}/g;
+/**
+ * Pseudo-locale: every string comes back longer and bracketed. It exists so a
+ * layout can be tested against text expansion before a real translation arrives —
+ * Vietnamese is short and English is not, and a design tuned to the shorter one
+ * breaks on the longer.
+ */
+export const PSEUDO_LOCALE = 'qps';
+const pseudo = (s) => `⟦${s.replace(/[aeiouAEIOU]/g, (c) => c + c.toLowerCase())}⟧`;
+export function translator(manifest, locale, o = {}) {
+    const fallback = o.fallback ?? 'vi';
+    const catalogs = manifest.messages ?? {};
+    const primary = catalogs[locale] ?? {};
+    const secondary = catalogs[fallback] ?? {};
+    const plural = new Intl.PluralRules(locale === PSEUDO_LOCALE ? 'en' : locale);
+    const resolve = (key) => {
+        if (key in primary)
+            return { message: primary[key], exact: true };
+        if (key in secondary)
+            return { message: secondary[key], exact: false };
+        return { message: undefined, exact: false };
+    };
+    const t = ((key, params = {}) => {
+        const { message, exact } = resolve(key);
+        if (!exact)
+            o.onMissing?.(key, locale);
+        let text;
+        if (message === undefined)
+            text = key; // visible, not blank
+        else if (typeof message === 'string')
+            text = message;
+        else {
+            const count = Number(params.count ?? 0);
+            text = message[plural.select(count)] ?? message.other ?? key;
+        }
+        text = text.replace(PLACEHOLDER, (_, name) => String(params[name] ?? `{${name}}`));
+        return locale === PSEUDO_LOCALE ? pseudo(text) : text;
+    });
+    t.locale = locale;
+    t.has = (key) => key in primary;
+    t.resolves = (key) => key in primary || key in secondary;
+    return t;
+}
+/** Which keys each locale is missing, measured against the union of all of them. */
+export function missingMessages(manifest, locales) {
+    const catalogs = manifest.messages ?? {};
+    const wanted = locales ?? Object.keys(catalogs);
+    const every = new Set();
+    for (const c of Object.values(catalogs))
+        for (const k of Object.keys(c))
+            every.add(k);
+    const out = {};
+    for (const locale of wanted) {
+        const have = catalogs[locale] ?? {};
+        const gaps = [...every].filter((k) => !(k in have)).sort();
+        if (gaps.length)
+            out[locale] = gaps;
+    }
+    return out;
+}
+export function formatMissing(missing) {
+    const entries = Object.entries(missing);
+    if (!entries.length)
+        return 'every locale has every key';
+    return entries
+        .map(([locale, keys]) => `${locale}: ${keys.length} missing\n${keys.map((k) => `  ${k}`).join('\n')}`)
+        .join('\n');
+}
+//# sourceMappingURL=i18n.js.map

package/dist/kernel/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/kernel/i18n.ts"],"names":[],"mappings":"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"}

package/dist/kernel/index.d.ts

@@ -0,0 +1,7 @@
+export { defineModule, defineTheme } from './define.ts';
+export { compose } from './compose.ts';
+export { topoSort } from './graph.ts';
+export { diffManifests, formatDiff } from './diff.ts';
+export { KetError, Diagnostics } from './errors.ts';
+export { isDateText, parseType, tsTypeOf, sqlTypeOf, SCALARS } from './types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/kernel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/dist/kernel/index.js

@@ -0,0 +1,7 @@
+export { defineModule, defineTheme } from './define.js';
+export { compose } from './compose.js';
+export { topoSort } from './graph.js';
+export { diffManifests, formatDiff } from './diff.js';
+export { KetError, Diagnostics } from './errors.js';
+export { isDateText, parseType, tsTypeOf, sqlTypeOf, SCALARS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/kernel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/kernel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/dist/kernel/layout.d.ts

@@ -0,0 +1,17 @@
+import type { Manifest } from '../types.ts';
+export type Placement = {
+    type: string;
+    settings?: Record<string, unknown>;
+};
+export type LayoutError = {
+    at: number;
+    type: string;
+    field?: string;
+    message: string;
+};
+export declare function validateLayout(manifest: Manifest, layout: unknown): {
+    ok: boolean;
+    errors: LayoutError[];
+};
+export declare const formatLayoutErrors: (errors: LayoutError[]) => string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/kernel/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/layout.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAC5E,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAcvF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAwD1G;AAED,eAAO,MAAM,kBAAkB,WAAY,WAAW,EAAE,KAAG,MACwC,CAAA"}

package/dist/kernel/layout.js

@@ -0,0 +1,77 @@
+// Validating a page layout against the sections that exist.
+//
+// This is the payoff for making sections data rather than code: what an agent
+// writes can be checked before it is stored, against the same declaration the
+// theme renders from. A bad section type, a missing required setting, or a setting
+// of the wrong shape are all caught here — as a list, not as an exception, because
+// a list is what an agent can act on.
+import { isDateText, parseType } from './types.js';
+const JS_OF = {
+    id: 'string',
+    text: 'string',
+    ref: 'string',
+    int: 'number',
+    float: 'number',
+    bool: 'boolean',
+    date: 'string',
+    datetime: 'string',
+    json: 'object',
+};
+export function validateLayout(manifest, layout) {
+    const errors = [];
+    if (!Array.isArray(layout)) {
+        return {
+            ok: false,
+            errors: [{ at: -1, type: '(layout)', message: 'a layout must be an array of section placements' }],
+        };
+    }
+    layout.forEach((raw, at) => {
+        const placement = raw;
+        if (!placement || typeof placement.type !== 'string') {
+            errors.push({ at, type: '(unknown)', message: 'each placement needs a "type"' });
+            return;
+        }
+        const section = manifest.sections[placement.type];
+        if (!section) {
+            errors.push({
+                at,
+                type: placement.type,
+                message: `no installed module provides this section (available: ${Object.keys(manifest.sections).join(', ') || 'none'})`,
+            });
+            return;
+        }
+        const schema = section.settings ?? {};
+        const settings = placement.settings ?? {};
+        for (const [field, spec] of Object.entries(schema)) {
+            const t = parseType(spec);
+            const value = settings[field];
+            if (value == null) {
+                if (t.ok && !t.optional)
+                    errors.push({ at, type: placement.type, field, message: `is required (${spec})` });
+                continue;
+            }
+            if (!t.ok)
+                continue;
+            const want = JS_OF[t.base];
+            if (want && typeof value !== want) {
+                errors.push({ at, type: placement.type, field, message: `expects ${t.base}, got ${typeof value}` });
+            }
+            else if (t.base === 'date' && !isDateText(value)) {
+                errors.push({ at, type: placement.type, field, message: 'expects date in YYYY-MM-DD format' });
+            }
+        }
+        for (const field of Object.keys(settings)) {
+            if (!(field in schema)) {
+                errors.push({
+                    at,
+                    type: placement.type,
+                    field,
+                    message: `is not a setting of this section (accepted: ${Object.keys(schema).join(', ') || 'none'})`,
+                });
+            }
+        }
+    });
+    return { ok: errors.length === 0, errors };
+}
+export const formatLayoutErrors = (errors) => errors.map((e) => `  [${e.at}] ${e.type}${e.field ? '.' + e.field : ''} ${e.message}`).join('\n');
+//# sourceMappingURL=layout.js.map

package/dist/kernel/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/kernel/layout.ts"],"names":[],"mappings":"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"}

package/dist/kernel/menu.d.ts

@@ -0,0 +1,27 @@
+import type { Manifest } from '../types.ts';
+export type MenuNode = {
+    id: string;
+    label: string;
+    path: string | null;
+    icon: string | null;
+    /** True for the node whose path is showing, and for every heading above it. */
+    active: boolean;
+    children: MenuNode[];
+};
+export type MenuOptions = {
+    /** Function keys this viewer may call. Null means unrestricted. */
+    allow?: readonly string[] | null;
+    /** Resolves a label. Given a key it does not know, it should return it unchanged. */
+    translate?: (key: string) => string;
+    /** The path currently showing, used to mark the branch leading to it. */
+    active?: string;
+    /**
+     * Narrow the tree to what matches. A heading survives if anything under it
+     * does, so filtering never orphans a leaf from the words above it.
+     */
+    q?: string;
+};
+export declare function buildMenu(manifest: Manifest, o?: MenuOptions): MenuNode[];
+/** The app a path belongs to: the root whose branch contains it. */
+export declare function activeApp(tree: MenuNode[]): MenuNode | null;
+//# sourceMappingURL=menu.d.ts.map

package/dist/kernel/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/menu.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,aAAa,CAAA;AAEpD,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,QAAQ,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC,qFAAqF;IACrF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAA;CACX,CAAA;AAKD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAE,WAAgB,GAAG,QAAQ,EAAE,CAoD7E;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI,CAE3D"}

package/dist/kernel/menu.js

@@ -0,0 +1,65 @@
+// The navigation tree, as one viewer sees it.
+//
+// Three filters, applied in this order, because each depends on the one before:
+// what the deployment ships, what this database has switched on, and what this
+// viewer may call. The last is the one that matters most — a menu offering what it
+// cannot deliver is a menu that lies, and the 401 arrives after the click rather
+// than instead of it.
+//
+// A heading with nothing left under it disappears with its children. An empty
+// section is worse than a missing one: it reads as "this is broken" rather than
+// "this is not for you".
+const order = (a, b) => (a[1].sequence ?? 100) - (b[1].sequence ?? 100) || a[1].label.localeCompare(b[1].label);
+export function buildMenu(manifest, o = {}) {
+    const entries = Object.entries(manifest.menus);
+    const byParent = new Map();
+    for (const e of entries) {
+        const list = byParent.get(e[1].parent) ?? [];
+        list.push(e);
+        byParent.set(e[1].parent, list);
+    }
+    // Two reasons an entry does not appear: the function it leads to is not in this
+    // build at all, or it is and this viewer may not call it.
+    const permitted = (def) => !def.needs || (!!manifest.functions[def.needs] && (!o.allow || o.allow.includes(def.needs)));
+    const label = (def) => {
+        const key = `${def.by}.${def.label}`;
+        const out = o.translate?.(key);
+        // A translator that does not know the key hands it back; a module that wrote a
+        // literal rather than a key gets the literal.
+        return out && out !== key ? out : (o.translate?.(def.label) ?? def.label);
+    };
+    const needle = o.q?.trim().toLocaleLowerCase('vi') ?? '';
+    const matches = (text) => !needle || text.toLocaleLowerCase('vi').includes(needle);
+    const activePath = o.active
+        ? entries
+            .map(([, def]) => def.path)
+            .filter((path) => !!path && (o.active === path || o.active.startsWith(`${path.replace(/\/$/, '')}/`)))
+            .sort((a, b) => b.length - a.length)[0]
+        : undefined;
+    const build = (parent, depth) => {
+        if (depth > 8)
+            return []; // a cycle would otherwise recurse forever
+        const out = [];
+        for (const [id, def] of (byParent.get(parent) ?? []).sort(order)) {
+            if (!permitted(def))
+                continue;
+            const children = build(id, depth + 1);
+            // A heading is only worth showing if something is under it.
+            if (!def.path && !children.length)
+                continue;
+            // A search keeps a branch that matches anywhere along it, so a leaf never
+            // arrives without the words that explain where it lives.
+            if (needle && !children.length && !matches(label(def)))
+                continue;
+            const active = (def.path !== undefined && def.path === activePath) || children.some((c) => c.active);
+            out.push({ id, label: label(def), path: def.path ?? null, icon: def.icon ?? null, active, children });
+        }
+        return out;
+    };
+    return build(undefined, 0);
+}
+/** The app a path belongs to: the root whose branch contains it. */
+export function activeApp(tree) {
+    return tree.find((n) => n.active) ?? null;
+}
+//# sourceMappingURL=menu.js.map

package/dist/kernel/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/kernel/menu.ts"],"names":[],"mappings":"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"}

package/dist/kernel/modules.d.ts

@@ -0,0 +1,31 @@
+import type { KetModule } from '../types.ts';
+import type { AppSpec, ModulePath, WorkspaceDeclaration } from './workspace.ts';
+export type ModuleSource = {
+    name: string;
+    descriptor: string;
+    entry: string;
+    root: string;
+};
+export type ResolvedModuleInfo = {
+    name: string;
+    version: string;
+    kind: KetModule['kind'];
+    source: 'workspace' | string;
+    apps: string[];
+};
+export type ResolvedWorkspace = {
+    apps: AppSpec[];
+    modulePaths: string[];
+    modules: ResolvedModuleInfo[];
+};
+export type ResolveWorkspaceOptions = {
+    /** URL of the workspace file; relative string roots are resolved beside it. */
+    baseUrl: URL;
+    /** CLI/environment roots appended to the declaration's roots. */
+    extraModulePaths?: ModulePath[];
+    /** Development's tsx loader may execute source. Production Node may not. */
+    allowSource?: boolean;
+};
+/** Resolve an authored workspace into the object-only shape the runtime accepts. */
+export declare function resolveWorkspace(declaration: WorkspaceDeclaration, options: ResolveWorkspaceOptions): Promise<ResolvedWorkspace>;
+//# sourceMappingURL=modules.d.ts.map

package/dist/kernel/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/modules.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAkB,OAAO,EAAE,UAAU,EAAa,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAa1G,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IACvB,MAAM,EAAE,WAAW,GAAG,MAAM,CAAA;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,+EAA+E;IAC/E,OAAO,EAAE,GAAG,CAAA;IACZ,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAA;IAC/B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAyTD,oFAAoF;AACpF,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAyC5B"}