@ketvietlab/ketjs 0.1.1

package/dist/kernel/modules.js

@@ -0,0 +1,322 @@
+// Filesystem module discovery, kept entirely at the workspace boundary.
+//
+// Odoo's addons_path gets one thing exactly right: a deployment may draw modules
+// from several roots without teaching the application where every package lives.
+// Ket keeps the useful half and rejects the dangerous half. Discovery builds a
+// catalogue, explicitly selected modules and their dependency closure are loaded,
+// and everything below this file still receives ordinary KetModule objects.
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { realpath, readdir, readFile, stat } from 'node:fs/promises';
+import { dirname, extname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { KetError } from './errors.js';
+import { topoSort } from './graph.js';
+const DESCRIPTOR = 'ket.module.json';
+const NAME = /^[a-z][a-z0-9_]*$/;
+const ARTIFACT_EXTENSIONS = new Set(['.js', '.mjs', '.cjs']);
+const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.cts']);
+const DISCOVERY_CONCURRENCY = 64;
+const fail = (code, message, hint) => {
+    throw new KetError({ code, message, ...(hint ? { hint } : {}) });
+};
+const inside = (parent, child) => {
+    const rel = relative(parent, child);
+    return rel === '' || (!rel.startsWith(`..${sep}`) && rel !== '..' && !isAbsolute(rel));
+};
+const rootPath = (value, baseUrl) => {
+    if (value instanceof URL) {
+        if (value.protocol !== 'file:')
+            return fail('E_MODULE_PATH_PROTOCOL', `module path must be a file URL, got "${value.protocol}"`);
+        return fileURLToPath(value);
+    }
+    if (typeof value !== 'string' || !value.trim())
+        return fail('E_MODULE_PATH', 'module path must be a non-empty path or file URL');
+    if (isAbsolute(value))
+        return value;
+    if (baseUrl.protocol !== 'file:')
+        return fail('E_MODULE_PATH_PROTOCOL', `workspace base URL must be file:, got "${baseUrl.protocol}"`);
+    return resolve(dirname(fileURLToPath(baseUrl)), value);
+};
+const readDescriptor = async (path) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch (error) {
+        return fail('E_MODULE_DESCRIPTOR', `cannot read module descriptor at ${path}: ${error.message}`, `${DESCRIPTOR} must be valid JSON`);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return fail('E_MODULE_DESCRIPTOR', `${path} must contain a JSON object`);
+    const value = parsed;
+    const unknown = Object.keys(value).filter((key) => !['$schema', 'name', 'entry'].includes(key));
+    if (unknown.length)
+        return fail('E_MODULE_DESCRIPTOR_KEY', `${path} declares unknown ${unknown.length === 1 ? 'key' : 'keys'}: ${unknown.join(', ')}`, 'known keys: $schema, name, entry');
+    if (typeof value.name !== 'string' || !NAME.test(value.name))
+        return fail('E_MODULE_DESCRIPTOR_NAME', `${path} has invalid module name ${JSON.stringify(value.name)}`, 'use lowercase letters, digits and underscore, starting with a letter');
+    if (typeof value.entry !== 'string' || !value.entry.trim())
+        return fail('E_MODULE_DESCRIPTOR_ENTRY', `${path} needs a non-empty "entry"`);
+    return { name: value.name, entry: value.entry };
+};
+async function scanModulePaths(paths, options) {
+    const roots = [];
+    const catalog = new Map();
+    for (const configured of paths) {
+        const raw = rootPath(configured, options.baseUrl);
+        let root = raw;
+        try {
+            root = await realpath(raw);
+            if (!(await stat(root)).isDirectory())
+                fail('E_MODULE_PATH_NOT_DIRECTORY', `module path is not a directory: ${raw}`);
+        }
+        catch (error) {
+            if (error instanceof KetError)
+                throw error;
+            fail('E_MODULE_PATH_MISSING', `module path does not exist: ${raw}`);
+        }
+        if (roots.includes(root))
+            continue;
+        roots.push(root);
+        const children = (await readdir(root, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
+        // Filesystem latency, not graph work, dominates a broad catalogue. Probe the
+        // sorted children concurrently, then consume settled results in that same
+        // order so an invalid catalogue still reports deterministically.
+        const probe = async (child) => {
+            if (!child.isDirectory() && !child.isSymbolicLink())
+                return null;
+            const moduleDir = resolve(root, child.name);
+            let moduleRoot;
+            try {
+                moduleRoot = await realpath(moduleDir);
+                if (!(await stat(moduleRoot)).isDirectory())
+                    return null;
+            }
+            catch {
+                return null;
+            }
+            const descriptorPath = resolve(moduleRoot, DESCRIPTOR);
+            try {
+                if (!(await stat(descriptorPath)).isFile())
+                    return null;
+            }
+            catch {
+                return null;
+            }
+            const descriptor = await readDescriptor(descriptorPath);
+            const unresolvedEntry = resolve(moduleRoot, descriptor.entry);
+            let entry = unresolvedEntry;
+            try {
+                entry = await realpath(unresolvedEntry);
+                if (!(await stat(entry)).isFile())
+                    fail('E_MODULE_ENTRY_NOT_FILE', `module "${descriptor.name}" entry is not a file: ${unresolvedEntry}`);
+            }
+            catch (error) {
+                if (error instanceof KetError)
+                    throw error;
+                fail('E_MODULE_ENTRY_MISSING', `module "${descriptor.name}" entry does not exist: ${unresolvedEntry}`);
+            }
+            if (!inside(moduleRoot, entry))
+                fail('E_MODULE_ENTRY_ESCAPE', `module "${descriptor.name}" entry escapes its module directory: ${descriptor.entry}`);
+            const extension = extname(entry).toLowerCase();
+            if (!ARTIFACT_EXTENSIONS.has(extension) && !(options.allowSource && SOURCE_EXTENSIONS.has(extension)))
+                fail('E_MODULE_ENTRY_EXTENSION', `module "${descriptor.name}" entry ${descriptor.entry} is not an executable JavaScript artifact`, options.allowSource
+                    ? 'use .js/.mjs/.cjs, or .ts/.tsx/.mts/.cts through the development loader'
+                    : 'build the module first and point entry at .js, .mjs or .cjs');
+            return { name: descriptor.name, descriptor: descriptorPath, entry, root: moduleRoot };
+        };
+        for (let offset = 0; offset < children.length; offset += DISCOVERY_CONCURRENCY) {
+            const discovered = await Promise.allSettled(children.slice(offset, offset + DISCOVERY_CONCURRENCY).map(probe));
+            for (const result of discovered) {
+                if (result.status === 'rejected')
+                    throw result.reason;
+                const source = result.value;
+                if (!source)
+                    continue;
+                const existing = catalog.get(source.name);
+                if (existing)
+                    fail('E_MODULE_NAME_CLASH', `module "${source.name}" is provided by both ${existing.root} and ${source.root}`, 'module roots never shadow each other; rename one module or remove one root');
+                catalog.set(source.name, source);
+            }
+        }
+    }
+    return { roots, catalog };
+}
+const assertModule = (value, source) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return fail('E_MODULE_EXPORT', `${source.entry} must default-export a module created by defineModule()`);
+    const module = value;
+    if (module.name !== source.name)
+        return fail('E_MODULE_IDENTITY_MISMATCH', `${source.descriptor} names module "${source.name}" but ${source.entry} exports ${JSON.stringify(module.name)}`);
+    if (module.kind !== 'module' && module.kind !== 'theme')
+        return fail('E_MODULE_EXPORT', `module "${source.name}" has invalid kind ${JSON.stringify(module.kind)}`);
+    if (typeof module.version !== 'string')
+        return fail('E_MODULE_EXPORT', `module "${source.name}" must declare a string version`);
+    if (!Array.isArray(module.depends) || module.depends.some((name) => typeof name !== 'string'))
+        return fail('E_MODULE_EXPORT', `module "${source.name}" must declare a string dependency list`);
+    for (const key of ['requires', 'provides', 'styles', 'omits']) {
+        const field = module[key];
+        if (!Array.isArray(field) || field.some((value) => typeof value !== 'string'))
+            return fail('E_MODULE_EXPORT', `module "${source.name}" has invalid "${key}"; export defineModule(...)`);
+    }
+    for (const key of [
+        'models',
+        'extend',
+        'joints',
+        'fills',
+        'functions',
+        'jobs',
+        'views',
+        'tokens',
+        'templates',
+        'routes',
+        'menus',
+        'islands',
+        'sections',
+        'relations',
+        'messages',
+    ]) {
+        const field = module[key];
+        if (!field || typeof field !== 'object' || Array.isArray(field))
+            return fail('E_MODULE_EXPORT', `module "${source.name}" has invalid "${key}"; export defineModule(...)`);
+    }
+    return value;
+};
+const moduleName = (ref) => (typeof ref === 'string' ? ref : ref.name);
+async function resolveApp(declaration, catalog, imports) {
+    const inline = new Map();
+    const stringRefs = new Set();
+    const refs = [
+        ...declaration.modules,
+        ...(declaration.theme ? [declaration.theme] : []),
+        ...(declaration.themes ?? []),
+    ];
+    for (const ref of refs) {
+        if (typeof ref === 'string') {
+            if (!NAME.test(ref))
+                fail('E_MODULE_REF', `app "${declaration.name}" has invalid module reference ${JSON.stringify(ref)}`, 'use the snake_case name from ket.module.json');
+            if (stringRefs.has(ref))
+                fail('E_MODULE_DUPLICATE_REF', `app "${declaration.name}" references module "${ref}" more than once`);
+            stringRefs.add(ref);
+            continue;
+        }
+        const existing = inline.get(ref.name);
+        if (existing)
+            fail('E_MODULE_NAME_CLASH', `app "${declaration.name}" contains two inline modules named "${ref.name}"`, 'each app must ship exactly one implementation of a module name');
+        inline.set(ref.name, ref);
+    }
+    for (const name of stringRefs) {
+        if (inline.has(name))
+            fail('E_MODULE_NAME_CLASH', `app "${declaration.name}" provides "${name}" inline and by module path`, 'choose the imported module object or its string reference, not both');
+    }
+    const resolved = new Map();
+    const sources = new Map();
+    const visiting = new Set();
+    const load = async (name) => {
+        if (resolved.has(name))
+            return;
+        let module = inline.get(name);
+        let source = null;
+        if (!module) {
+            const found = catalog.get(name);
+            if (!found) {
+                throw new KetError({
+                    code: 'E_MISSING_DEPENDENCY',
+                    message: `app "${declaration.name}" needs module "${name}", which no module path provides`,
+                    hint: `add a root containing "${name}" to modulePaths, or import it into the app`,
+                });
+            }
+            source = found;
+            let pending = imports.get(found.entry);
+            if (!pending) {
+                pending = import(__rewriteRelativeImportExtension(pathToFileURL(found.entry).href)).then((namespace) => assertModule(namespace.default, found));
+                imports.set(found.entry, pending);
+            }
+            module = await pending;
+        }
+        resolved.set(name, module);
+        sources.set(name, source);
+        if (visiting.has(name))
+            return;
+        visiting.add(name);
+        for (const dependency of module.depends)
+            await load(dependency);
+        visiting.delete(name);
+    };
+    for (const ref of declaration.modules)
+        await load(moduleName(ref));
+    if (declaration.theme)
+        await load(moduleName(declaration.theme));
+    for (const theme of declaration.themes ?? [])
+        await load(moduleName(theme));
+    // topoSort remains the one authority for missing dependencies and cycles. It
+    // also makes registration order independent of filesystem/readdir order.
+    const ordered = topoSort([...resolved.values()]);
+    const themeName = declaration.theme ? moduleName(declaration.theme) : null;
+    const theme = themeName ? resolved.get(themeName) : undefined;
+    const selectedThemes = [
+        ...(theme ? [theme] : []),
+        ...(declaration.themes ?? []).map((ref) => resolved.get(moduleName(ref))),
+    ];
+    for (const selected of selectedThemes)
+        if (selected.kind !== 'theme')
+            fail('E_APP_THEME_KIND', `app "${declaration.name}" selects "${selected.name}" as a theme, but it is a ${selected.kind}`, 'export it with defineTheme(), or move it into modules');
+    const selectedNames = new Set(selectedThemes.map((selected) => selected.name));
+    const modules = ordered.filter((module) => !selectedNames.has(module.name));
+    const { modules: _moduleRefs, theme: _themeRef, themes: _themeRefs, ...app } = declaration;
+    return {
+        spec: {
+            ...app,
+            modules,
+            ...(theme ? { theme } : {}),
+            ...(selectedThemes.length ? { themes: selectedThemes.filter((item) => item !== theme) } : {}),
+        },
+        sources,
+    };
+}
+/** Resolve an authored workspace into the object-only shape the runtime accepts. */
+export async function resolveWorkspace(declaration, options) {
+    if (!declaration || !Array.isArray(declaration.apps))
+        fail('E_WORKSPACE_SHAPE', 'workspace must contain an apps array');
+    const configured = [...(declaration.modulePaths ?? []), ...(options.extraModulePaths ?? [])];
+    const { roots, catalog } = await scanModulePaths(configured, options);
+    const imports = new Map();
+    const apps = [];
+    const inventory = new Map();
+    for (const app of declaration.apps) {
+        const { spec, sources } = await resolveApp(app, catalog, imports);
+        apps.push(spec);
+        for (const module of [...spec.modules, ...(spec.theme ? [spec.theme] : []), ...(spec.themes ?? [])]) {
+            const source = sources.get(module.name);
+            const label = source?.entry ?? 'workspace';
+            const key = `${module.name}\0${module.version}\0${label}`;
+            const existing = inventory.get(key);
+            if (existing) {
+                if (!existing.apps.includes(spec.name))
+                    existing.apps.push(spec.name);
+            }
+            else {
+                inventory.set(key, {
+                    name: module.name,
+                    version: module.version,
+                    kind: module.kind,
+                    source: label,
+                    apps: [spec.name],
+                });
+            }
+        }
+    }
+    return {
+        apps,
+        modulePaths: roots,
+        modules: [...inventory.values()].sort((a, b) => a.name.localeCompare(b.name) ||
+            a.version.localeCompare(b.version) ||
+            a.source.localeCompare(b.source)),
+    };
+}
+//# sourceMappingURL=modules.js.map

package/dist/kernel/modules.js.map

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

package/dist/kernel/routes.d.ts

@@ -0,0 +1,24 @@
+export type RouteParams = Readonly<Record<string, string>>;
+type Segment = {
+    kind: 'static';
+    value: string;
+} | {
+    kind: 'param';
+    name: string;
+};
+export type RoutePattern = {
+    path: string;
+    segments: readonly Segment[];
+    staticCount: number;
+};
+export declare function parseRoutePattern(path: string): RoutePattern;
+/** True when both patterns can match one pathname and neither is more specific. */
+export declare function ambiguousRoutes(a: RoutePattern, b: RoutePattern): boolean;
+export declare function matchRoutePattern(pattern: RoutePattern, pathname: string): RouteParams | null;
+export declare function compileRoutes<T>(routes: Record<string, T>): (pathname: string) => {
+    path: string;
+    value: T;
+    params: RouteParams;
+} | null;
+export {};
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/routes.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAE1D,KAAK,OAAO,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAElF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA6B5D;AAaD,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAMzE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAc7F;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK;IACjF,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,CAAA;IACR,MAAM,EAAE,WAAW,CAAA;CACpB,GAAG,IAAI,CA4BP"}

package/dist/kernel/routes.js

@@ -0,0 +1,98 @@
+import { KetError } from './errors.js';
+const PARAM = /^\{([A-Za-z_][A-Za-z0-9_]*)\}$/;
+export function parseRoutePattern(path) {
+    if (!path.startsWith('/')) {
+        throw new KetError({ code: 'E_ROUTE_PATH', message: `route "${path}" must start with "/"` });
+    }
+    const names = new Set();
+    const parts = path === '/' ? [] : path.slice(1).split('/');
+    const segments = parts.map((part) => {
+        const param = PARAM.exec(part);
+        if (param) {
+            const name = param[1];
+            if (names.has(name)) {
+                throw new KetError({
+                    code: 'E_ROUTE_PARAM_DUPLICATE',
+                    message: `route "${path}" declares parameter "${name}" more than once`,
+                });
+            }
+            names.add(name);
+            return { kind: 'param', name };
+        }
+        if (part.includes('{') || part.includes('}')) {
+            throw new KetError({
+                code: 'E_ROUTE_PATTERN',
+                message: `route "${path}" has an invalid dynamic segment "${part}"`,
+                hint: 'a dynamic segment occupies the whole segment, for example /products/{slug}',
+            });
+        }
+        return { kind: 'static', value: decode(part, path) };
+    });
+    return { path, segments, staticCount: segments.filter((s) => s.kind === 'static').length };
+}
+const decode = (part, path) => {
+    try {
+        return decodeURIComponent(part);
+    }
+    catch {
+        throw new KetError({
+            code: 'E_ROUTE_ENCODING',
+            message: `route path "${path}" contains invalid percent encoding`,
+        });
+    }
+};
+/** True when both patterns can match one pathname and neither is more specific. */
+export function ambiguousRoutes(a, b) {
+    if (a.segments.length !== b.segments.length || a.staticCount !== b.staticCount)
+        return false;
+    return a.segments.every((segment, i) => {
+        const other = b.segments[i];
+        return segment.kind === 'param' || other.kind === 'param' || segment.value === other.value;
+    });
+}
+export function matchRoutePattern(pattern, pathname) {
+    const raw = pathname === '/' ? [] : pathname.slice(1).split('/');
+    if (raw.length !== pattern.segments.length)
+        return null;
+    const params = {};
+    for (let i = 0; i < pattern.segments.length; i += 1) {
+        const segment = pattern.segments[i];
+        const value = decode(raw[i], pathname);
+        if (segment.kind === 'static') {
+            if (segment.value !== value)
+                return null;
+        }
+        else {
+            params[segment.name] = value;
+        }
+    }
+    return params;
+}
+export function compileRoutes(routes) {
+    const entries = Object.entries(routes).map(([path, value]) => ({ pattern: parseRoutePattern(path), value }));
+    for (let i = 0; i < entries.length; i += 1) {
+        for (let j = i + 1; j < entries.length; j += 1) {
+            const a = entries[i].pattern;
+            const b = entries[j].pattern;
+            if (ambiguousRoutes(a, b)) {
+                throw new KetError({
+                    code: 'E_ROUTE_AMBIGUOUS',
+                    message: `routes "${a.path}" and "${b.path}" can match the same path with equal priority`,
+                    hint: 'make one route more specific, or let one handler own both paths',
+                });
+            }
+        }
+    }
+    entries.sort((a, b) => b.pattern.staticCount - a.pattern.staticCount ||
+        b.pattern.segments.length - a.pattern.segments.length ||
+        a.pattern.path.localeCompare(b.pattern.path));
+    return (pathname) => {
+        for (const entry of entries) {
+            const params = matchRoutePattern(entry.pattern, pathname);
+            if (params)
+                return { path: entry.pattern.path, value: entry.value, params };
+        }
+        return null;
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/kernel/routes.js.map

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

package/dist/kernel/types.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedType, TypeParse } from '../types.ts';
+export declare const SCALARS: Set<string>;
+/** A calendar date with no time or timezone, encoded canonically as YYYY-MM-DD. */
+export declare function isDateText(value: unknown): value is string;
+export declare function parseType(spec: string): TypeParse;
+export declare const tsTypeOf: (t: ParsedType) => string;
+export declare const sqlTypeOf: (t: ParsedType) => string;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEnE,eAAO,MAAM,OAAO,aAAyF,CAAA;AAE7G,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAW1D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAgBjD;AAgBD,eAAO,MAAM,QAAQ,MAAO,UAAU,KAAG,MAAoD,CAAA;AAgB7F,eAAO,MAAM,SAAS,MAAO,UAAU,KAAG,MAAqB,CAAA"}

package/dist/kernel/types.js

@@ -0,0 +1,67 @@
+export const SCALARS = new Set(['id', 'text', 'int', 'float', 'decimal', 'bool', 'json', 'date', 'datetime']);
+/** A calendar date with no time or timezone, encoded canonically as YYYY-MM-DD. */
+export function isDateText(value) {
+    if (typeof value !== 'string')
+        return false;
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    if (!match)
+        return false;
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    const day = Number(match[3]);
+    if (year === 0 || month < 1 || month > 12 || day < 1)
+        return false;
+    const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+    const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+    return day <= days[month - 1];
+}
+export function parseType(spec) {
+    if (typeof spec !== 'string')
+        return { ok: false, reason: 'type must be a string' };
+    let s = spec;
+    let optional = false;
+    if (s.endsWith('?')) {
+        optional = true;
+        s = s.slice(0, -1);
+    }
+    if (s.startsWith('ref:')) {
+        const target = s.slice(4);
+        if (!/^[a-z][a-z0-9_]*\.[A-Z][A-Za-z0-9]*$/.test(target))
+            return { ok: false, reason: `ref target must be "module.Model", got "${target}"` };
+        return { ok: true, base: 'ref', target, optional };
+    }
+    if (!SCALARS.has(s))
+        return { ok: false, reason: `unknown type "${spec}"` };
+    return { ok: true, base: s, optional };
+}
+// decimal is a number in TypeScript because it is a number in arithmetic; only
+// its storage is exact.
+const TS = {
+    id: 'string',
+    text: 'string',
+    int: 'number',
+    float: 'number',
+    decimal: 'number',
+    bool: 'boolean',
+    json: 'unknown',
+    date: 'string',
+    datetime: 'Date',
+    ref: 'string',
+};
+export const tsTypeOf = (t) => TS[t.base] + (t.optional ? ' | null' : '');
+// SQLite has no exact decimal at all: NUMERIC affinity silently becomes REAL.
+// TEXT is the only storage that gives it back unchanged.
+const SQL = {
+    id: 'TEXT PRIMARY KEY',
+    text: 'TEXT',
+    int: 'INTEGER',
+    float: 'REAL',
+    decimal: 'TEXT',
+    bool: 'INTEGER',
+    json: 'TEXT',
+    date: 'TEXT',
+    datetime: 'TEXT',
+    ref: 'TEXT',
+};
+export const sqlTypeOf = (t) => SQL[t.base];
+//# sourceMappingURL=types.js.map

package/dist/kernel/types.js.map

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

package/dist/kernel/workspace.d.ts

@@ -0,0 +1,62 @@
+import type { Schema } from '../data/migrate.ts';
+import type { KetModule, Manifest } from '../types.ts';
+import type { ServeSpec } from '../server/boot.ts';
+export type WorkerSpec = {
+    /** Local concurrency per queue. Several worker processes multiply it. */
+    queues: Record<string, number>;
+    pollMinMs?: number;
+    pollMaxMs?: number;
+    tenantRefreshMs?: number;
+    leaseMs?: number;
+    shutdownGraceMs?: number;
+};
+export type AppSpec = {
+    name: string;
+    modules: KetModule[];
+    theme?: KetModule;
+    /** Themes this deployment allows sites to select. `theme` remains the fallback. */
+    themes?: KetModule[];
+    datastore?: string;
+    requires?: string[];
+    /** An app that exposes functions but renders no pages: no theme, no region contract. */
+    headless?: boolean;
+    /** How the app runs: pages, routes, assets, datastore. Absent means it is never served. */
+    serve?: ServeSpec;
+    /** Same app and manifest, a separate production process role. */
+    worker?: WorkerSpec;
+};
+/**
+ * What an authored workspace may name before module paths have been resolved.
+ *
+ * Keeping this separate from AppSpec is deliberate: composition, HTTP and workers
+ * continue to receive executable KetModule objects only. A string is allowed at
+ * the workspace boundary and nowhere deeper in the framework.
+ */
+export type ModuleRef = KetModule | string;
+export type AppDeclaration = Omit<AppSpec, 'modules' | 'theme' | 'themes'> & {
+    modules: ModuleRef[];
+    theme?: ModuleRef;
+    themes?: ModuleRef[];
+};
+export type ModulePath = string | URL;
+export type WorkspaceDeclaration = {
+    apps: AppDeclaration[];
+    /** Odoo-like roots whose direct children may contain ket.module.json. */
+    modulePaths?: ModulePath[];
+};
+export type Workspace = {
+    apps: Record<string, Manifest>;
+    datastores: Record<string, {
+        schema: Schema;
+        apps: string[];
+        modules: string[];
+    }>;
+    shared: string[];
+    soloed: Record<string, string[]>;
+};
+export declare function defineApp(spec: AppSpec): AppSpec;
+export declare function defineApp(spec: AppDeclaration): AppDeclaration;
+export declare function defineWorkspace<T extends WorkspaceDeclaration>(spec: T): T;
+export declare function composeWorkspace(apps: AppSpec[]): Workspace;
+export declare function explainWorkspace(ws: Workspace): string;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/workspace.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,MAAM,MAAM,UAAU,GAAG;IACvB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;AAC1C,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG;IAC3E,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,GAAG,CAAA;AACrC,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,yEAAyE;IACzE,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACjF,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACjC,CAAA;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;AACjD,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAAA;AAwB/D,wBAAgB,eAAe,CAAC,CAAC,SAAS,oBAAoB,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAM1E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,CA0F3D;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAiBtD"}