@tekki-forge/compiler 0.0.0-stage → 0.1.0

package/dist/notifications.js

@@ -0,0 +1,80 @@
+const ACTIONS = ["created", "updated", "deleted", "restored", "transitioned", "action"];
+/** Placeholders like {number} or {customer} in notification texts. */
+export function placeholders(text) {
+    return [...text.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)].map((m) => m[1]);
+}
+export function compileNotifications(rules, entities, roles, issue) {
+    const out = [];
+    for (const [i, rule] of (rules ?? []).entries()) {
+        const at = `notifications[${i}]`;
+        const m = /^([A-Z][A-Za-z0-9]*)\.([a-z]+)(?::([A-Za-z0-9_]+))?$/.exec(rule.on ?? "");
+        if (!m) {
+            issue(`${at}.on`, `use "<Entity>.<action>" or "<Entity>.<action>:<name>", e.g. "Invoice.transitioned:send"`);
+            continue;
+        }
+        const [, entityName, action, name] = m;
+        const entity = entities.find((e) => e.name === entityName);
+        if (!entity) {
+            issue(`${at}.on`, `unknown entity "${entityName}"`);
+            continue;
+        }
+        if (!ACTIONS.includes(action))
+            issue(`${at}.on`, `unknown action "${action}" (${ACTIONS.join(", ")})`);
+        if (name) {
+            const known = action === "transitioned" ? entity.workflow?.transitions.map((t) => t.name) : action === "action" ? entity.actions.map((a) => a.name) : undefined;
+            if (!known)
+                issue(`${at}.on`, `":${name}" only applies to transitioned or action events`);
+            else if (!known.includes(name))
+                issue(`${at}.on`, `${entity.name} has no ${action === "action" ? "action" : "transition"} "${name}"`);
+        }
+        const to = [];
+        for (const target of typeof rule.to === "string" ? [rule.to] : [...(rule.to ?? [])]) {
+            if (target === "owner") {
+                if (!entity.ownerField)
+                    issue(`${at}.to`, `${entity.name} has no owner relation`);
+                to.push({ kind: "owner" });
+            }
+            else if (target.startsWith("role:")) {
+                const role = target.slice(5);
+                if (!roles.includes(role))
+                    issue(`${at}.to`, `unknown role "${role}"`);
+                to.push({ kind: "role", role });
+            }
+            else {
+                const f = entity.fields.find((x) => x.name === target);
+                if (!f || f.relation?.entity !== "User")
+                    issue(`${at}.to`, `"${target}" must be "owner", "role:<role>" or a User relation of ${entity.name}`);
+                to.push({ kind: "field", field: target });
+            }
+        }
+        if (to.length === 0)
+            issue(`${at}.to`, "name at least one recipient");
+        if (!rule.title?.trim())
+            issue(`${at}.title`, "required");
+        const known = new Set(["actor", "entity", "id", ...entity.fields.map((f) => f.name)]);
+        for (const key of ["title", "body", "link"]) {
+            for (const p of placeholders(rule[key] ?? ""))
+                if (!known.has(p))
+                    issue(`${at}.${key}`, `unknown placeholder {${p}} — use a field of ${entity.name}, {actor} or {entity}`);
+        }
+        if (rule.when?.changed) {
+            if (action !== "updated")
+                issue(`${at}.when`, `"changed" only applies to updated events`);
+            if (!entity.fields.some((f) => f.name === rule.when.changed))
+                issue(`${at}.when.changed`, `unknown field "${rule.when.changed}"`);
+        }
+        out.push({
+            entity: entity.name,
+            action: action,
+            ...(name ? { name } : {}),
+            to,
+            title: rule.title,
+            ...(rule.body ? { body: rule.body } : {}),
+            link: rule.link ?? `/${entity.path}/{id}`,
+            email: !!rule.email,
+            ...(rule.when?.changed ? { changed: rule.when.changed } : {}),
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

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

package/dist/rules.d.ts

@@ -0,0 +1,4 @@
+import type { PermissionRule } from "@tekki-forge/core";
+import type { Operation, PermissionIR } from "./ir.js";
+export declare const allowAll: () => PermissionIR;
+export declare function compileRule(rule: PermissionRule, at: string, op: Operation, roles: string[], hasOwner: boolean, issue: (p: string, m: string) => void, hasTeam?: boolean): PermissionIR;

package/dist/rules.js

@@ -0,0 +1,43 @@
+import { isCamelCase } from "./naming.js";
+export const allowAll = () => ({ roles: [], owner: false, authenticated: false, public: true, policies: [] });
+export function compileRule(rule, at, op, roles, hasOwner, issue, hasTeam = false) {
+    const out = { roles: [], owner: false, authenticated: false, public: false, policies: [] };
+    if (!Array.isArray(rule)) {
+        issue(at, "must be an array of roles or tokens");
+        return out;
+    }
+    for (const token of rule) {
+        if (token === "owner") {
+            if (!hasOwner)
+                issue(at, `"owner" requires a relation to User named "owner" or marked { owner: true }`);
+            if (op === "create")
+                issue(at, `"owner" cannot be used for create — the record does not exist yet`);
+            out.owner = true;
+        }
+        else if (token === "team") {
+            // On create, "team" means: the new record is assigned to one of the caller's teams.
+            if (!hasTeam)
+                issue(at, `"team" requires features: { teams: true } on the entity`);
+            out.team = true;
+        }
+        else if (token === "authenticated")
+            out.authenticated = true;
+        else if (token === "public") {
+            if (op !== "read")
+                issue(at, `"public" is only allowed for read`);
+            out.public = true;
+        }
+        else if (token.startsWith("policy:")) {
+            const name = token.slice("policy:".length);
+            if (!isCamelCase(name))
+                issue(at, `policy name "${name}" must be camelCase`);
+            out.policies.push(name);
+        }
+        else if (roles.includes(token))
+            out.roles.push(token);
+        else
+            issue(at, `unknown role "${token}" — declare it in roles: [...] or use owner, team, authenticated, public, policy:<name>`);
+    }
+    return out;
+}
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAiB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAE5H,MAAM,UAAU,WAAW,CACzB,IAAoB,EACpB,EAAU,EACV,EAAa,EACb,KAAe,EACf,QAAiB,EACjB,KAAqC,EACrC,OAAO,GAAG,KAAK;IAEf,MAAM,GAAG,GAAiB,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACzG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE,EAAE,qCAAqC,CAAC,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,EAAE,EAAE,6EAA6E,CAAC,CAAC;YACxG,IAAI,EAAE,KAAK,QAAQ;gBAAE,KAAK,CAAC,EAAE,EAAE,mEAAmE,CAAC,CAAC;YACpG,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,oFAAoF;YACpF,IAAI,CAAC,OAAO;gBAAE,KAAK,CAAC,EAAE,EAAE,yDAAyD,CAAC,CAAC;YACnF,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,CAAC;aAAM,IAAI,KAAK,KAAK,eAAe;YAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC;aAC1D,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,EAAE,KAAK,MAAM;gBAAE,KAAK,CAAC,EAAE,EAAE,mCAAmC,CAAC,CAAC;YAClE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,EAAE,EAAE,gBAAgB,IAAI,qBAAqB,CAAC,CAAC;YAC7E,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;YACnD,KAAK,CAAC,EAAE,EAAE,iBAAiB,KAAK,yFAAyF,CAAC,CAAC;IAClI,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/theme.d.ts

@@ -0,0 +1,69 @@
+import type { ThemeConfig } from "@tekki-forge/core";
+import type { ThemeFontName, ThemeIR, ThemePresetName, ThemeStyleName } from "./ir.js";
+export declare const UI_STYLES: readonly ["simple", "shadow", "neumorphism", "glassmorphism", "skeuomorphism", "material", "brutalist", "editorial", "aurora", "terminal", "clay"];
+export declare const THEME_MODES: readonly ["light", "dark", "system"];
+export declare const RADII: readonly ["none", "small", "medium", "large", "full"];
+export declare const THEME_LAYOUTS: readonly ["sidebar", "topbar", "compact"];
+export declare const THEME_DENSITIES: readonly ["comfortable", "compact"];
+export declare const THEME_FONT_NAMES: readonly ["inter", "geist", "plex", "grotesk", "serif", "rounded", "mono", "system"];
+export declare const THEME_PRESET_NAMES: readonly ["midnight", "sandstone", "ocean", "forest", "sunset", "graphite", "candy", "paper", "phosphor"];
+export interface ThemeFontDefinition {
+    label: string;
+    hint: string;
+    /** CSS font stacks, each ending with system fallbacks. */
+    display: string;
+    body: string;
+    /** Google Fonts css2 `family=` values (empty: nothing to load). */
+    families: readonly string[];
+}
+/** Typeface pairings: display (headings, metrics) + body. */
+export declare const THEME_FONTS: Record<ThemeFontName, ThemeFontDefinition>;
+/** Google Fonts stylesheet for a font pairing (null when nothing needs loading). */
+export declare function fontStylesheet(font: ThemeFontName): string | null;
+export interface ThemePresetDefinition {
+    label: string;
+    description: string;
+    style: ThemeStyleName;
+    primary: string;
+    accent: string;
+    mode: ThemeIR["mode"];
+    radius: ThemeIR["radius"];
+    font: ThemeFontName;
+    layout: ThemeIR["layout"];
+    density: ThemeIR["density"];
+}
+/** Curated looks. Explicit theme keys override any of these values. */
+export declare const THEME_PRESETS: Record<ThemePresetName, ThemePresetDefinition>;
+/** What a style brings along when the theme doesn't say otherwise. */
+export declare const STYLE_DEFAULTS: Partial<Record<ThemeStyleName, {
+    font?: ThemeFontName;
+    mode?: ThemeIR["mode"];
+}>>;
+export interface ThemeBase {
+    style: ThemeStyleName;
+    primary: string;
+    accent: string;
+    mode: ThemeIR["mode"];
+    radius: ThemeIR["radius"];
+    font: ThemeFontName;
+    layout: ThemeIR["layout"];
+    density: ThemeIR["density"];
+}
+/**
+ * The values a theme gets for every key it doesn't set: Forge defaults, then the preset, then (when the style
+ * isn't the preset's own) the style's companions such as terminal → mono font, dark mode.
+ */
+export declare function themeBase(preset?: ThemePresetName | null, style?: ThemeStyleName): ThemeBase;
+export declare function resolvePreset(input: string): ThemePresetName | undefined;
+/**
+ * A logo reference as served by the web app: absolute http(s) URLs pass through; file paths are taken
+ * relative to apps/web/public ("logo.svg", "public/logo.svg", "apps/web/public/logo.svg" → "/logo.svg").
+ */
+export declare function normalizeLogo(input: string): string | undefined;
+export declare const DEFAULT_THEME: ThemeIR;
+export declare function normalizeHex(input: string): string | undefined;
+export declare function contrast(a: string, b: string): number;
+/** White or near-black, whichever reads better on `hex`. */
+export declare function readableOn(hex: string): string;
+export declare function resolveStyle(input: string): ThemeIR["style"] | undefined;
+export declare function compileTheme(theme: ThemeConfig | undefined, issue: (path: string, message: string) => void): ThemeIR;

package/dist/theme.js

@@ -0,0 +1,257 @@
+export const UI_STYLES = ["simple", "shadow", "neumorphism", "glassmorphism", "skeuomorphism", "material", "brutalist", "editorial", "aurora", "terminal", "clay"];
+export const THEME_MODES = ["light", "dark", "system"];
+export const RADII = ["none", "small", "medium", "large", "full"];
+export const THEME_LAYOUTS = ["sidebar", "topbar", "compact"];
+export const THEME_DENSITIES = ["comfortable", "compact"];
+export const THEME_FONT_NAMES = ["inter", "geist", "plex", "grotesk", "serif", "rounded", "mono", "system"];
+export const THEME_PRESET_NAMES = ["midnight", "sandstone", "ocean", "forest", "sunset", "graphite", "candy", "paper", "phosphor"];
+const SANS = `ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif`;
+const SERIF = `ui-serif, Georgia, Cambria, "Times New Roman", serif`;
+const MONO = `ui-monospace, SFMono-Regular, Menlo, Consolas, monospace`;
+/** Typeface pairings: display (headings, metrics) + body. */
+export const THEME_FONTS = {
+    inter: { label: "Inter", hint: "neutral and very legible", display: `"Inter", ${SANS}`, body: `"Inter", ${SANS}`, families: ["Inter:wght@400;500;600;700"] },
+    geist: { label: "Geist", hint: "crisp, technical sans", display: `"Geist", ${SANS}`, body: `"Geist", ${SANS}`, families: ["Geist:wght@400;500;600;700"] },
+    plex: { label: "IBM Plex", hint: "engineered, friendly corporate", display: `"IBM Plex Sans", ${SANS}`, body: `"IBM Plex Sans", ${SANS}`, families: ["IBM+Plex+Sans:wght@400;500;600;700"] },
+    grotesk: { label: "Space Grotesk + Inter", hint: "quirky geometric headings", display: `"Space Grotesk", ${SANS}`, body: `"Inter", ${SANS}`, families: ["Space+Grotesk:wght@500;600;700", "Inter:wght@400;500;600;700"] },
+    serif: { label: "Fraunces + Inter", hint: "editorial serif headings", display: `"Fraunces", ${SERIF}`, body: `"Inter", ${SANS}`, families: ["Fraunces:opsz,wght@9..144,500..700", "Inter:wght@400;500;600;700"] },
+    rounded: { label: "Nunito", hint: "soft, rounded and warm", display: `"Nunito", ${SANS}`, body: `"Nunito", ${SANS}`, families: ["Nunito:wght@400;500;600;700;800"] },
+    mono: { label: "JetBrains Mono", hint: "monospace everywhere", display: `"JetBrains Mono", ${MONO}`, body: `"JetBrains Mono", ${MONO}`, families: ["JetBrains+Mono:wght@400;500;600;700"] },
+    system: { label: "System", hint: "the device's own font, nothing to load", display: SANS, body: SANS, families: [] },
+};
+/** Google Fonts stylesheet for a font pairing (null when nothing needs loading). */
+export function fontStylesheet(font) {
+    const families = THEME_FONTS[font].families;
+    return families.length ? `https://fonts.googleapis.com/css2?${families.map((f) => `family=${f}`).join("&")}&display=swap` : null;
+}
+/** Curated looks. Explicit theme keys override any of these values. */
+export const THEME_PRESETS = {
+    midnight: { label: "Midnight", description: "deep indigo aurora, glassy cards, Geist", style: "aurora", primary: "#4f46e5", accent: "#22d3ee", mode: "dark", radius: "large", font: "geist", layout: "sidebar", density: "comfortable" },
+    sandstone: { label: "Sandstone", description: "warm terracotta, soft extruded surfaces", style: "neumorphism", primary: "#c2410c", accent: "#0d9488", mode: "light", radius: "large", font: "plex", layout: "sidebar", density: "comfortable" },
+    ocean: { label: "Ocean", description: "frosted glass over sea blues", style: "glassmorphism", primary: "#0369a1", accent: "#14b8a6", mode: "system", radius: "large", font: "inter", layout: "sidebar", density: "comfortable" },
+    forest: { label: "Forest", description: "evergreen and gold, serif headings, top bar", style: "shadow", primary: "#15803d", accent: "#ca8a04", mode: "light", radius: "medium", font: "serif", layout: "topbar", density: "comfortable" },
+    sunset: { label: "Sunset", description: "puffy clay in rose and orange", style: "clay", primary: "#e11d48", accent: "#f97316", mode: "light", radius: "large", font: "rounded", layout: "sidebar", density: "comfortable" },
+    graphite: { label: "Graphite", description: "dense, neutral, icon rail — for power users", style: "simple", primary: "#52525b", accent: "#84cc16", mode: "system", radius: "small", font: "grotesk", layout: "compact", density: "compact" },
+    candy: { label: "Candy", description: "neo-brutalist pink and yellow", style: "brutalist", primary: "#db2777", accent: "#facc15", mode: "light", radius: "none", font: "grotesk", layout: "topbar", density: "comfortable" },
+    paper: { label: "Paper", description: "ink on paper, editorial serif", style: "editorial", primary: "#1c1917", accent: "#b91c1c", mode: "light", radius: "none", font: "serif", layout: "topbar", density: "comfortable" },
+    phosphor: { label: "Phosphor", description: "green-on-black terminal, monospace", style: "terminal", primary: "#16a34a", accent: "#f59e0b", mode: "dark", radius: "small", font: "mono", layout: "compact", density: "compact" },
+};
+/** What a style brings along when the theme doesn't say otherwise. */
+export const STYLE_DEFAULTS = {
+    brutalist: { font: "grotesk" },
+    editorial: { font: "serif" },
+    terminal: { font: "mono", mode: "dark" },
+    clay: { font: "rounded" },
+};
+/**
+ * The values a theme gets for every key it doesn't set: Forge defaults, then the preset, then (when the style
+ * isn't the preset's own) the style's companions such as terminal → mono font, dark mode.
+ */
+export function themeBase(preset, style) {
+    const p = preset ? THEME_PRESETS[preset] : undefined;
+    const base = p
+        ? { style: p.style, primary: p.primary, accent: p.accent, mode: p.mode, radius: p.radius, font: p.font, layout: p.layout, density: p.density }
+        : { style: DEFAULT_THEME.style, primary: DEFAULT_THEME.colors.primary, accent: DEFAULT_THEME.colors.accent, mode: DEFAULT_THEME.mode, radius: DEFAULT_THEME.radius, font: "system", layout: "sidebar", density: "comfortable" };
+    const finalStyle = style ?? base.style;
+    if (!p || finalStyle !== p.style)
+        Object.assign(base, STYLE_DEFAULTS[finalStyle] ?? {});
+    base.style = finalStyle;
+    return base;
+}
+export function resolvePreset(input) {
+    const k = input.trim().toLowerCase();
+    return THEME_PRESET_NAMES.includes(k) ? k : undefined;
+}
+const LOGO_FILE = /^\/[\w@.\/-]+\.(svg|png|jpe?g|webp|gif|ico|avif)$/i;
+/**
+ * A logo reference as served by the web app: absolute http(s) URLs pass through; file paths are taken
+ * relative to apps/web/public ("logo.svg", "public/logo.svg", "apps/web/public/logo.svg" → "/logo.svg").
+ */
+export function normalizeLogo(input) {
+    const v = input.trim();
+    if (/^https?:\/\//i.test(v)) {
+        if (/\s/.test(v))
+            return undefined;
+        try {
+            const url = new URL(v);
+            return url.hostname ? url.toString() : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    let path = v.replace(/^\.\//, "").replace(/^(apps\/web\/)?public\//, "");
+    if (!path.startsWith("/"))
+        path = `/${path}`;
+    if (path.startsWith("//") || path.split("/").includes("..") || !LOGO_FILE.test(path))
+        return undefined;
+    return path;
+}
+/** Common spellings people use for the styles. */
+const STYLE_ALIASES = {
+    flat: "simple",
+    shadowy: "shadow",
+    shadows: "shadow",
+    neomorphism: "neumorphism",
+    neumorphic: "neumorphism",
+    glass: "glassmorphism",
+    glassmorphic: "glassmorphism",
+    skeumorphism: "skeuomorphism",
+    skeuomorphic: "skeuomorphism",
+    skeumorphim: "skeuomorphism",
+    "material-design": "material",
+    md3: "material",
+    brutal: "brutalist",
+    brutalism: "brutalist",
+    neobrutalism: "brutalist",
+    "neo-brutalism": "brutalist",
+    "neo-brutalist": "brutalist",
+    magazine: "editorial",
+    print: "editorial",
+    gradient: "aurora",
+    mesh: "aurora",
+    console: "terminal",
+    hacker: "terminal",
+    cli: "terminal",
+    crt: "terminal",
+    claymorphism: "clay",
+    claymorphic: "clay",
+};
+export const DEFAULT_THEME = {
+    preset: null,
+    style: "simple",
+    mode: "light",
+    radius: "medium",
+    colors: {
+        primary: "#4f46e5",
+        primaryForeground: "#ffffff",
+        accent: "#f59e0b",
+        accentForeground: "#111827",
+        danger: "#dc2626",
+        dangerForeground: "#ffffff",
+    },
+    font: "system",
+    fonts: { body: SANS, display: SANS, stylesheet: null },
+    layout: "sidebar",
+    density: "comfortable",
+    logo: null,
+    tagline: null,
+};
+export function normalizeHex(input) {
+    const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(input.trim());
+    if (!m)
+        return undefined;
+    const h = m[1].length === 3 ? [...m[1]].map((c) => c + c).join("") : m[1];
+    return `#${h.toLowerCase()}`;
+}
+function luminance(hex) {
+    const [r, g, b] = [1, 3, 5].map((i) => {
+        const c = parseInt(hex.slice(i, i + 2), 16) / 255;
+        return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+    });
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+export function contrast(a, b) {
+    const [l1, l2] = [luminance(a), luminance(b)].sort((x, y) => y - x);
+    return (l1 + 0.05) / (l2 + 0.05);
+}
+/** White or near-black, whichever reads better on `hex`. */
+export function readableOn(hex) {
+    return contrast(hex, "#ffffff") >= contrast(hex, "#111827") ? "#ffffff" : "#111827";
+}
+export function resolveStyle(input) {
+    const k = input.trim().toLowerCase();
+    return UI_STYLES.includes(k) ? k : STYLE_ALIASES[k];
+}
+const TAGLINE_MAX = 160;
+export function compileTheme(theme, issue) {
+    const t = theme ?? {};
+    const oneOf = (key, value, allowed, fallback, noun) => {
+        if (value === undefined)
+            return fallback;
+        if (typeof value === "string" && allowed.includes(value))
+            return value;
+        issue(`theme.${key}`, `unknown ${noun} "${String(value)}" (choose ${allowed.join(", ")})`);
+        return fallback;
+    };
+    let preset = null;
+    if (t.preset !== undefined) {
+        const resolved = typeof t.preset === "string" ? resolvePreset(t.preset) : undefined;
+        if (resolved)
+            preset = resolved;
+        else
+            issue("theme.preset", `unknown preset "${String(t.preset)}" (choose ${THEME_PRESET_NAMES.join(", ")})`);
+    }
+    let explicitStyle;
+    if (t.style !== undefined) {
+        const resolved = typeof t.style === "string" ? resolveStyle(t.style) : undefined;
+        if (resolved)
+            explicitStyle = resolved;
+        else
+            issue("theme.style", `unknown style "${String(t.style)}" (choose ${UI_STYLES.join(", ")})`);
+    }
+    const base = themeBase(preset, explicitStyle);
+    const mode = t.mode ?? base.mode;
+    if (!THEME_MODES.includes(mode))
+        issue("theme.mode", `must be one of ${THEME_MODES.join(", ")}`);
+    const radius = t.radius ?? base.radius;
+    if (!RADII.includes(radius))
+        issue("theme.radius", `must be one of ${RADII.join(", ")}`);
+    const font = oneOf("font", t.font, THEME_FONT_NAMES, base.font, "font");
+    const layout = oneOf("layout", t.layout, THEME_LAYOUTS, base.layout, "layout");
+    const density = oneOf("density", t.density, THEME_DENSITIES, base.density, "density");
+    const color = (key) => {
+        const raw = t.colors?.[key];
+        const fallback = key === "danger" ? DEFAULT_THEME.colors.danger : base[key];
+        if (raw === undefined)
+            return fallback;
+        const hex = typeof raw === "string" ? normalizeHex(raw) : undefined;
+        if (!hex) {
+            issue(`theme.colors.${key}`, `"${String(raw)}" is not a hex colour like #4f46e5`);
+            return fallback;
+        }
+        return hex;
+    };
+    const primary = color("primary");
+    const accent = color("accent");
+    const danger = color("danger");
+    let logo = null;
+    if (t.logo !== undefined) {
+        const normalized = typeof t.logo === "string" ? normalizeLogo(t.logo) : undefined;
+        if (normalized)
+            logo = normalized;
+        else
+            issue("theme.logo", `"${String(t.logo)}" is not a logo URL (https://…) or an image in apps/web/public such as "/logo.svg" (svg, png, jpg, webp, gif, ico, avif)`);
+    }
+    let tagline = null;
+    if (t.tagline !== undefined) {
+        if (typeof t.tagline !== "string" || !t.tagline.trim())
+            issue("theme.tagline", "must be a non-empty string");
+        else if (t.tagline.trim().length > TAGLINE_MAX)
+            issue("theme.tagline", `must be at most ${TAGLINE_MAX} characters`);
+        else
+            tagline = t.tagline.trim();
+    }
+    const typeface = THEME_FONTS[font];
+    return {
+        preset,
+        style: base.style,
+        mode,
+        radius,
+        colors: {
+            primary,
+            primaryForeground: readableOn(primary),
+            accent,
+            accentForeground: readableOn(accent),
+            danger,
+            dangerForeground: readableOn(danger),
+        },
+        font,
+        fonts: { body: typeface.body, display: typeface.display, stylesheet: fontStylesheet(font) },
+        layout,
+        density,
+        logo,
+        tagline,
+    };
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAC5K,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAChE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAC3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,SAAS,CAAU,CAAC;AACnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AACrH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAE5I,MAAM,IAAI,GAAG,yEAAyE,CAAC;AACvF,MAAM,KAAK,GAAG,sDAAsD,CAAC;AACrE,MAAM,IAAI,GAAG,0DAA0D,CAAC;AAYxE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAA+C;IACrE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,YAAY,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,4BAA4B,CAAC,EAAE;IAC5J,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,YAAY,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,4BAA4B,CAAC,EAAE;IACzJ,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,gCAAgC,EAAE,OAAO,EAAE,oBAAoB,IAAI,EAAE,EAAE,IAAI,EAAE,oBAAoB,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,oCAAoC,CAAC,EAAE;IAC5L,OAAO,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,2BAA2B,EAAE,OAAO,EAAE,oBAAoB,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,gCAAgC,EAAE,4BAA4B,CAAC,EAAE;IACzN,KAAK,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,eAAe,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,oCAAoC,EAAE,4BAA4B,CAAC,EAAE;IACjN,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,aAAa,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,iCAAiC,CAAC,EAAE;IACpK,IAAI,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,qBAAqB,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAqB,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,qCAAqC,CAAC,EAAE;IAC3L,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,wCAAwC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;CACrH,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC5C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,qCAAqC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC;AACnI,CAAC;AAeD,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAmD;IAC3E,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,yCAAyC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;IACxO,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,yCAAyC,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;IAC/O,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,8BAA8B,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;IAChO,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;IACzO,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE;IAC3N,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,6CAA6C,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE;IAC5O,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,+BAA+B,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;IAC5N,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,+BAA+B,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;IAC1N,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,oCAAoC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE;CACjO,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAsF;IAC/G,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;IAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IACxC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAC1B,CAAC;AAaF;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAA+B,EAAE,KAAsB;IAC/E,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,MAAM,IAAI,GAAc,CAAC;QACvB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QAC9I,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAClO,MAAM,UAAU,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;IACvC,IAAI,CAAC,CAAC,IAAI,UAAU,KAAK,CAAC,CAAC,KAAK;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACxF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;AACpG,CAAC;AAED,MAAM,SAAS,GAAG,oDAAoD,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;YACvB,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACvG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kDAAkD;AAClD,MAAM,aAAa,GAAqC;IACtD,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,aAAa;IACzB,KAAK,EAAE,eAAe;IACtB,YAAY,EAAE,eAAe;IAC7B,YAAY,EAAE,eAAe;IAC7B,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,eAAe;IAC5B,iBAAiB,EAAE,UAAU;IAC7B,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,WAAW;IACzB,eAAe,EAAE,WAAW;IAC5B,eAAe,EAAE,WAAW;IAC5B,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,QAAQ;IAClB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,UAAU;IACnB,MAAM,EAAE,UAAU;IAClB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,UAAU;IACf,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,iBAAiB,EAAE,SAAS;QAC5B,MAAM,EAAE,SAAS;QACjB,gBAAgB,EAAE,SAAS;QAC3B,MAAM,EAAE,SAAS;QACjB,gBAAgB,EAAE,SAAS;KAC5B;IACD,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IACtD,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,CAAC,GAAG,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAC7E,OAAO,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;QAClD,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,GAAG,CAAE,GAAG,MAAM,GAAG,CAAE,GAAG,MAAM,GAAG,CAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,EAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAG,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAQ,SAA+B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAsB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,UAAU,YAAY,CAAC,KAA8B,EAAE,KAA8C;IACzG,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;IACtB,MAAM,KAAK,GAAG,CAAmB,GAAW,EAAE,KAAc,EAAE,OAAqB,EAAE,QAAW,EAAE,IAAY,EAAK,EAAE;QACnH,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAU,CAAC;QACnG,KAAK,CAAC,SAAS,GAAG,EAAE,EAAE,WAAW,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3F,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,IAAI,MAAM,GAA2B,IAAI,CAAC;IAC1C,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,IAAI,QAAQ;YAAE,MAAM,GAAG,QAAQ,CAAC;;YAC3B,KAAK,CAAC,cAAc,EAAE,mBAAmB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/G,CAAC;IACD,IAAI,aAAyC,CAAC;IAC9C,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjF,IAAI,QAAQ;YAAE,aAAa,GAAG,QAAQ,CAAC;;YAClC,KAAK,CAAC,aAAa,EAAE,kBAAkB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;IACjC,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,YAAY,EAAE,kBAAkB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IACvC,IAAI,CAAE,KAA2B,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,cAAc,EAAE,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChH,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAEtF,MAAM,KAAK,GAAG,CAAC,GAAoC,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACvC,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,KAAK,CAAC,gBAAgB,GAAG,EAAE,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAClF,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE/B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,IAAI,UAAU;YAAE,IAAI,GAAG,UAAU,CAAC;;YAC7B,KAAK,CAAC,YAAY,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,0HAA0H,CAAC,CAAC;IACzK,CAAC;IACD,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,KAAK,CAAC,eAAe,EAAE,4BAA4B,CAAC,CAAC;aACxG,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,WAAW;YAAE,KAAK,CAAC,eAAe,EAAE,mBAAmB,WAAW,aAAa,CAAC,CAAC;;YAC/G,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO;QACL,MAAM;QACN,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI;QACJ,MAAM;QACN,MAAM,EAAE;YACN,OAAO;YACP,iBAAiB,EAAE,UAAU,CAAC,OAAO,CAAC;YACtC,MAAM;YACN,gBAAgB,EAAE,UAAU,CAAC,MAAM,CAAC;YACpC,MAAM;YACN,gBAAgB,EAAE,UAAU,CAAC,MAAM,CAAC;SACrC;QACD,IAAI;QACJ,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE;QAC3F,MAAM;QACN,OAAO;QACP,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,83 @@
+import type { AppIR, EntityIR, FieldIR } from "./ir.js";
+/** UI metadata consumed by the generic admin renderer (`<ResourceList>`, `<ResourceForm>`). */
+export interface ResourceMeta {
+    name: string;
+    path: string;
+    label: string;
+    pluralLabel: string;
+    icon: string;
+    nav: boolean;
+    display: string;
+    searchable: boolean;
+    searchPlaceholder: string;
+    list: {
+        columns: ColumnMeta[];
+        filters: FilterMeta[];
+        defaultSort: string;
+        pageSize: number;
+    };
+    form: {
+        fields: FormFieldMeta[];
+    };
+    detail: {
+        fields: string[];
+        related: RelatedMeta[];
+    };
+    features: EntityIR["features"];
+    actions: EntityIR["actions"];
+    workflow?: EntityIR["workflow"];
+    views: EntityIR["views"];
+}
+export interface ColumnMeta {
+    key: string;
+    label: string;
+    kind: FieldIR["kind"] | "system";
+    sortable: boolean;
+    /** Display renderer: text, badge, boolean, money, percentage, date, datetime, relation, color, email, url */
+    cell: string;
+}
+export interface FilterMeta {
+    key: string;
+    label: string;
+    type: "select" | "relation" | "boolean" | "range";
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    relationPath?: string;
+}
+export interface FormFieldMeta {
+    name: string;
+    apiName: string;
+    label: string;
+    component: string;
+    required: boolean;
+    description?: string;
+    placeholder?: string;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    relation?: {
+        entity: string;
+        lookupPath: string;
+        many: boolean;
+    };
+    file?: {
+        image: boolean;
+        accept: string[];
+        maxSize: number;
+    };
+    currency?: string;
+    validation: FieldIR["validation"];
+    defaultValue?: unknown;
+}
+export interface RelatedMeta {
+    name: string;
+    label: string;
+    resourcePath: string;
+    filterKey: string;
+}
+/** Path segment used to look up records of a relation target. */
+export declare function lookupPath(ir: AppIR, entity: string): string;
+export declare function deriveResources(ir: AppIR): ResourceMeta[];