@tekki-forge/compiler 0.0.0-stage → 0.1.0

package/dist/ir.d.ts

@@ -0,0 +1,413 @@
+import type { FieldKind, SdkLanguage, SocialProvider } from "@tekki-forge/core";
+/**
+ * The Forge intermediate representation. Every generator and runtime consumes this
+ * normalized, JSON-serializable structure — never the raw user config.
+ */
+export interface AppIR {
+    irVersion: 1;
+    name: string;
+    slug: string;
+    description?: string;
+    database: DatabaseIR;
+    auth: AuthIR;
+    tenancy: TenancyIR;
+    /** All roles known to the authorization layer, "admin" first. */
+    roles: string[];
+    api: {
+        prefix: string;
+        docs: boolean;
+    };
+    /** Client SDKs `forge generate` emits. */
+    sdk: {
+        languages: SdkLanguage[];
+    };
+    admin: {
+        enabled: boolean;
+    };
+    theme: ThemeIR;
+    plugins: PluginIR[];
+    notifications: NotificationRuleIR[];
+    dashboard: {
+        widgets: WidgetIR[];
+    } | null;
+    i18n: {
+        defaultLocale: string;
+        locales: string[];
+    };
+    entities: EntityIR[];
+    /** Teams inside organizations (built-in Team/TeamMember models); on when an entity uses features.teams. */
+    teams?: {
+        enabled: boolean;
+    };
+    /** Scheduled backups (`backups` in forge.config.ts); absent when not configured. */
+    backups?: {
+        schedule: string | null;
+        keep: number;
+    };
+    /** Public landing page at `/` for signed-out visitors (absent when disabled). Unset texts are filled in, translated, at render time. */
+    landing?: LandingIR;
+}
+export interface LandingIR {
+    headline?: string;
+    subheadline?: string;
+    features?: {
+        title: string;
+        description: string;
+        icon: string;
+    }[];
+    cta?: {
+        label: string;
+        href: string;
+    };
+}
+export interface WidgetIR {
+    id: string;
+    type: "metric" | "chart" | "list";
+    title: string;
+    entity: string;
+    where: Record<string, string>;
+    span: 1 | 2 | 3;
+    aggregate: "count" | "sum" | "avg" | "min" | "max";
+    field?: string;
+    chart?: "bar" | "line" | "donut";
+    groupBy?: {
+        field: string;
+        by?: "day" | "week" | "month" | "year";
+    };
+    limit: number;
+    sort?: string;
+    columns?: string[];
+    /** Metrics: period-over-period comparison (absent when disabled). */
+    compare?: {
+        period: "week" | "month" | "quarter" | "year";
+        dateField: string;
+        trend: "up-is-good" | "down-is-good";
+    };
+}
+export interface NotificationRuleIR {
+    entity: string;
+    action: "created" | "updated" | "deleted" | "restored" | "transitioned" | "action";
+    name?: string;
+    to: ({
+        kind: "owner";
+    } | {
+        kind: "field";
+        field: string;
+    } | {
+        kind: "role";
+        role: string;
+    })[];
+    title: string;
+    body?: string;
+    link: string;
+    email: boolean;
+    changed?: string;
+}
+export interface PluginIR {
+    name: string;
+    package: string;
+    version: string;
+    options: Record<string, unknown>;
+    runtime: {
+        api: boolean;
+        worker: boolean;
+        web: boolean;
+    };
+    env: {
+        name: string;
+        description: string;
+        default?: string;
+        docker?: string;
+        required: boolean;
+        secret: boolean;
+    }[];
+    docker: {
+        services: Record<string, unknown>;
+        volumes: string[];
+    };
+    nav: {
+        label: string;
+        path: string;
+        icon: string;
+        admin: boolean;
+    }[];
+    reservedPaths: string[];
+    /** Entities this plugin added to the schema. */
+    entities: string[];
+}
+export type ThemeStyleName = "simple" | "shadow" | "neumorphism" | "glassmorphism" | "skeuomorphism" | "material" | "brutalist" | "editorial" | "aurora" | "terminal" | "clay";
+export type ThemePresetName = "midnight" | "sandstone" | "ocean" | "forest" | "sunset" | "graphite" | "candy" | "paper" | "phosphor";
+export type ThemeFontName = "inter" | "geist" | "plex" | "grotesk" | "serif" | "rounded" | "mono" | "system";
+export interface ThemeIR {
+    /** The preset the theme started from (explicit keys already applied on top). */
+    preset: ThemePresetName | null;
+    style: ThemeStyleName;
+    mode: "light" | "dark" | "system";
+    radius: "none" | "small" | "medium" | "large" | "full";
+    colors: {
+        primary: string;
+        /** Readable text colour on top of `primary` (WCAG contrast). */
+        primaryForeground: string;
+        accent: string;
+        accentForeground: string;
+        danger: string;
+        dangerForeground: string;
+    };
+    font: ThemeFontName;
+    /** Resolved font stacks and the Google Fonts stylesheet to load (null for "system"). */
+    fonts: {
+        body: string;
+        display: string;
+        stylesheet: string | null;
+    };
+    layout: "sidebar" | "topbar" | "compact";
+    density: "comfortable" | "compact";
+    /** Absolute URL or a path served from apps/web/public ("/logo.svg"). */
+    logo: string | null;
+    tagline: string | null;
+}
+export interface DatabaseIR {
+    provider: "postgresql";
+}
+export interface AuthIR {
+    emailPassword: boolean;
+    registration: boolean;
+    social: SocialProvider[];
+    emailVerification: boolean;
+    passwordReset: boolean;
+    twoFactor: boolean;
+    passkeys: boolean;
+}
+export interface TenancyIR {
+    enabled: boolean;
+    model: "organization";
+}
+export type Operation = "create" | "read" | "update" | "delete";
+export interface PermissionIR {
+    roles: string[];
+    owner: boolean;
+    /** Members of the record's team (entities with features.teams). */
+    team?: boolean;
+    authenticated: boolean;
+    public: boolean;
+    policies: string[];
+}
+export interface EntityIR {
+    name: string;
+    label: string;
+    pluralLabel: string;
+    description?: string;
+    /** Prisma model name: the storage name. */
+    model: string;
+    /** What stored data is keyed on (Prisma model, enum types, link tables, rows naming the entity). Default: the name. */
+    storageName: string;
+    /** Prisma client delegate, e.g. `prisma.project`. */
+    delegate: string;
+    tableName: string;
+    /** URL segment, e.g. "projects". */
+    path: string;
+    /** Scalar field used as a record's label. */
+    display: string;
+    icon: string;
+    nav: boolean;
+    fields: FieldIR[];
+    inverseRelations: InverseRelationIR[];
+    /** Name of the relation field that designates the record owner. */
+    ownerField?: string;
+    /** Name of the relation field to the built-in Team model (features.teams), used by "team" rules. */
+    teamField?: string;
+    permissions: Record<Operation, PermissionIR>;
+    features: {
+        timestamps: boolean;
+        softDelete: boolean;
+        audit: boolean;
+        tenant: boolean;
+        export: boolean;
+        bulkDelete: boolean;
+        teams?: boolean;
+        /** Record comments with @mentions (built-in Comment model) and the Activity timeline. */
+        comments: boolean;
+    };
+    actions: ActionIR[];
+    list: {
+        columns: string[];
+        defaultSort: SortIR;
+        pageSize: number;
+    };
+    workflow?: WorkflowIR;
+    views: ViewsIR;
+    /** Computed fields in evaluation order (dependencies first). */
+    computedOrder: string[];
+    /**
+     * Parents whose aggregate computed fields depend on this entity's rows; recomputed after writes here.
+     * e.g. Invoice.total = sum(lines.amount) puts { entity: "Invoice", foreignKey: "invoiceId" } on InvoiceLine.
+     */
+    aggregateParents: {
+        entity: string;
+        relation: string;
+        foreignKey: string;
+    }[];
+}
+export interface WorkflowIR {
+    field: string;
+    initial: string;
+    states: string[];
+    transitions: {
+        name: string;
+        label: string;
+        /** Empty means "from any state". */
+        from: string[];
+        to: string;
+        permission: PermissionIR;
+        confirm?: string;
+        variant: "default" | "danger";
+    }[];
+}
+export interface ViewsIR {
+    board?: {
+        groupBy: string;
+        title: string;
+        fields: string[];
+    };
+    calendar?: {
+        date: string;
+        end?: string;
+        title: string;
+    };
+    map?: {
+        location: string;
+        title: string;
+    };
+}
+export interface SortIR {
+    field: string;
+    direction: "asc" | "desc";
+}
+export type DefaultIR = {
+    kind: "value";
+    value: string | number | boolean | null | object;
+} | {
+    kind: "now";
+};
+export interface FieldIR {
+    name: string;
+    kind: Exclude<FieldKind, never>;
+    label: string;
+    description?: string;
+    required: boolean;
+    unique: boolean;
+    index: boolean;
+    default?: DefaultIR;
+    searchable: boolean;
+    filterable: boolean;
+    sortable: boolean;
+    list: boolean;
+    hidden: boolean;
+    readonly: boolean;
+    widget: string;
+    placeholder?: string;
+    column: string;
+    /** Key used in API payloads and query strings (`ownerId` for a relation named `owner`). */
+    apiName: string;
+    validation: {
+        min?: number;
+        max?: number;
+        minLength?: number;
+        maxLength?: number;
+        pattern?: string;
+    };
+    enumValues?: {
+        value: string;
+        label: string;
+    }[];
+    currency?: string;
+    precision?: number;
+    scale?: number;
+    relation?: RelationIR;
+    /** Field-level access (in addition to the entity's permissions). */
+    access?: {
+        read?: PermissionIR;
+        write?: PermissionIR;
+    };
+    /** Present on computed fields; `kind` is then the result type and the field is readonly. */
+    computed?: {
+        expression: string;
+        /** Parsed AST from @tekki-forge/expression. */
+        ast: unknown;
+        fields: string[];
+        aggregates: {
+            fn: string;
+            relation: string;
+            field: string | null;
+        }[];
+    };
+    /** Present on file and image fields. */
+    file?: {
+        image: boolean;
+        accept: string[];
+        maxSize: number;
+    };
+}
+export interface RelationIR {
+    type: "many-to-one" | "many-to-many";
+    entity: string;
+    model: string;
+    delegate: string;
+    /** API path of the target when it is a user-defined entity. */
+    path?: string;
+    builtin: boolean;
+    /** Scalar FK for many-to-one; empty for many-to-many (implicit join table). */
+    foreignKey: string;
+    foreignKeyColumn: string;
+    onDelete: "cascade" | "restrict" | "setNull";
+    owner: boolean;
+    /** Collection name on the target entity. */
+    inverse: string;
+    /** Field of the target used as its label. */
+    targetDisplay: string;
+}
+export interface InverseRelationIR {
+    type: "one-to-many" | "many-to-many";
+    name: string;
+    label: string;
+    /** Source entity holding the foreign key. */
+    entity: string;
+    field: string;
+    foreignKey: string;
+}
+export interface ActionIR {
+    name: string;
+    label: string;
+    confirm?: string;
+    variant: "default" | "danger";
+    permission: PermissionIR;
+}
+/** Built-in models provided by the auth layer that user entities may relate to. */
+export declare const BUILTIN_ENTITIES: {
+    readonly User: {
+        readonly model: "User";
+        readonly delegate: "user";
+        readonly display: "name";
+    };
+    readonly Organization: {
+        readonly model: "Organization";
+        readonly delegate: "organization";
+        readonly display: "name";
+    };
+    readonly Team: {
+        readonly model: "Team";
+        readonly delegate: "team";
+        readonly display: "name";
+    };
+};
+export declare const RESERVED_ENTITY_NAMES: readonly ["User", "Session", "Account", "Verification", "Organization", "Member", "Invitation", "TwoFactor", "Passkey", "AuditLog", "Team", "TeamMember", "ApiKey", "RecordComment"];
+export declare const RESERVED_FIELD_NAMES: readonly ["id", "createdAt", "updatedAt", "deletedAt", "organizationId", "organization"];
+export declare const SPECIAL_PERMISSION_TOKENS: readonly ["owner", "authenticated", "public", "team"];
+export declare const isManyToMany: (f: {
+    relation?: {
+        type: string;
+    };
+}) => boolean;
+export declare const isFileField: (f: {
+    kind: string;
+}) => boolean;

package/dist/ir.js

@@ -0,0 +1,27 @@
+/** Built-in models provided by the auth layer that user entities may relate to. */
+export const BUILTIN_ENTITIES = {
+    User: { model: "User", delegate: "user", display: "name" },
+    Organization: { model: "Organization", delegate: "organization", display: "name" },
+    Team: { model: "Team", delegate: "team", display: "name" },
+};
+export const RESERVED_ENTITY_NAMES = [
+    "User",
+    "Session",
+    "Account",
+    "Verification",
+    "Organization",
+    "Member",
+    "Invitation",
+    "TwoFactor",
+    "Passkey",
+    "AuditLog",
+    "Team",
+    "TeamMember",
+    "ApiKey",
+    "RecordComment",
+];
+export const RESERVED_FIELD_NAMES = ["id", "createdAt", "updatedAt", "deletedAt", "organizationId", "organization"];
+export const SPECIAL_PERMISSION_TOKENS = ["owner", "authenticated", "public", "team"];
+export const isManyToMany = (f) => f.relation?.type === "many-to-many";
+export const isFileField = (f) => f.kind === "file" || f.kind === "image";
+//# sourceMappingURL=ir.js.map

package/dist/ir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AA6TA,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC1D,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE;IAClF,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;CAClD,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,MAAM;IACN,SAAS;IACT,SAAS;IACT,cAAc;IACd,cAAc;IACd,QAAQ;IACR,YAAY;IACZ,WAAW;IACX,SAAS;IACT,UAAU;IACV,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,eAAe;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,CAAU,CAAC;AAE7H,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAE/F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAkC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,KAAK,cAAc,CAAC;AACxG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC"}

package/dist/landing.d.ts

@@ -0,0 +1,5 @@
+import type { LandingConfig } from "@tekki-forge/core";
+import type { LandingIR } from "./ir.js";
+/** Icons a landing feature can use (the entity icons plus a few marketing ones); @tekki-forge/runtime-admin renders each. */
+export declare const LANDING_ICONS: readonly ["folder", "users", "user", "briefcase", "building", "file-text", "box", "tag", "layers", "star", "calendar", "credit-card", "mail", "map-pin", "package", "shopping-cart", "ticket", "check-square", "zap", "shield", "chart", "sparkles", "lock", "globe", "clock", "bell", "search", "heart", "rocket", "message-square", "workflow", "database"];
+export declare function compileLanding(landing: boolean | LandingConfig | undefined, issue: (path: string, message: string) => void): LandingIR | undefined;

package/dist/landing.js

@@ -0,0 +1,73 @@
+/** Icons a landing feature can use (the entity icons plus a few marketing ones); @tekki-forge/runtime-admin renders each. */
+export const LANDING_ICONS = [
+    "folder", "users", "user", "briefcase", "building", "file-text", "box", "tag", "layers", "star", "calendar", "credit-card", "mail", "map-pin", "package", "shopping-cart", "ticket", "check-square",
+    "zap", "shield", "chart", "sparkles", "lock", "globe", "clock", "bell", "search", "heart", "rocket", "message-square", "workflow", "database",
+];
+const MAX_FEATURES = 12;
+const MAX_TEXT = 300;
+/** A same-site path ("/sign-up", "/pricing#plans") or an absolute http(s) URL. */
+function validHref(href) {
+    if (href.startsWith("/"))
+        return !href.startsWith("//") && !/\s/.test(href);
+    try {
+        return ["http:", "https:"].includes(new URL(href).protocol);
+    }
+    catch {
+        return false;
+    }
+}
+export function compileLanding(landing, issue) {
+    if (!landing)
+        return undefined;
+    if (landing === true)
+        return {};
+    if (typeof landing !== "object") {
+        issue("landing", "must be true, false or { headline, subheadline, features, cta }");
+        return undefined;
+    }
+    if (landing.enabled === false)
+        return undefined;
+    const out = {};
+    const text = (key, value) => {
+        if (value === undefined)
+            return;
+        if (typeof value !== "string" || !value.trim())
+            issue(`landing.${key}`, "must be a non-empty string");
+        else if (value.length > MAX_TEXT)
+            issue(`landing.${key}`, `must be at most ${MAX_TEXT} characters`);
+        else
+            out[key] = value.trim();
+    };
+    text("headline", landing.headline);
+    text("subheadline", landing.subheadline);
+    if (landing.features !== undefined) {
+        if (!Array.isArray(landing.features))
+            issue("landing.features", "must be a list of { title, description, icon }");
+        else {
+            if (landing.features.length > MAX_FEATURES)
+                issue("landing.features", `at most ${MAX_FEATURES} features`);
+            out.features = landing.features.slice(0, MAX_FEATURES).map((f, i) => {
+                const at = `landing.features[${i}]`;
+                if (typeof f?.title !== "string" || !f.title.trim())
+                    issue(`${at}.title`, "is required");
+                if (typeof f?.description !== "string" || !f.description.trim())
+                    issue(`${at}.description`, "is required");
+                const icon = f?.icon ?? "sparkles";
+                if (!LANDING_ICONS.includes(icon))
+                    issue(`${at}.icon`, `unknown icon "${String(icon)}" (choose ${LANDING_ICONS.join(", ")})`);
+                return { title: String(f?.title ?? "").trim(), description: String(f?.description ?? "").trim(), icon };
+            });
+        }
+    }
+    if (landing.cta !== undefined) {
+        const { label, href } = landing.cta ?? {};
+        if (typeof label !== "string" || !label.trim())
+            issue("landing.cta.label", "is required");
+        if (typeof href !== "string" || !validHref(href))
+            issue("landing.cta.href", 'must be a path such as "/sign-up" or an http(s) URL');
+        if (typeof label === "string" && typeof href === "string")
+            out.cta = { label: label.trim(), href };
+    }
+    return out;
+}
+//# sourceMappingURL=landing.js.map

package/dist/landing.js.map

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

package/dist/load.d.ts

@@ -0,0 +1,12 @@
+import type { AppDefinition } from "@tekki-forge/core";
+import type { AppIR } from "./ir.js";
+export declare const CONFIG_FILES: string[];
+export declare function findConfig(cwd: string): string | undefined;
+/**
+ * Let configs import packages the toolchain can resolve even when the app's own dependencies are not
+ * installed yet (e.g. first-party plugins during `forge new --config`).
+ */
+export declare function registerConfigAliases(aliases: Record<string, string>): void;
+/** Load a forge.config.* file (TypeScript supported) and return its default export. */
+export declare function loadConfig(configPath: string): Promise<AppDefinition>;
+export declare function loadAndCompile(configPath: string): Promise<AppIR>;

package/dist/load.js

@@ -0,0 +1,38 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createJiti } from "jiti";
+import { compile } from "./compile.js";
+export const CONFIG_FILES = ["forge.config.ts", "forge.config.mts", "forge.config.js", "forge.config.mjs"];
+export function findConfig(cwd) {
+    for (const file of CONFIG_FILES) {
+        const candidate = resolve(cwd, file);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+const extraAliases = {};
+/**
+ * Let configs import packages the toolchain can resolve even when the app's own dependencies are not
+ * installed yet (e.g. first-party plugins during `forge new --config`).
+ */
+export function registerConfigAliases(aliases) {
+    Object.assign(extraAliases, aliases);
+}
+/** Load a forge.config.* file (TypeScript supported) and return its default export. */
+export async function loadConfig(configPath) {
+    // Resolve @tekki-forge/core from the toolchain so configs load even before the app's dependencies are installed.
+    const core = fileURLToPath(import.meta.resolve("@tekki-forge/core"));
+    const jiti = createJiti(import.meta.url, { moduleCache: false, fsCache: false, interopDefault: true, alias: { ...extraAliases, "@tekki-forge/core": core } });
+    const mod = await jiti.import(resolve(configPath));
+    const config = mod.default ?? mod;
+    if (!config || typeof config !== "object" || !("entities" in config)) {
+        throw new Error(`${configPath} must default-export defineApp({ ... })`);
+    }
+    return config;
+}
+export async function loadAndCompile(configPath) {
+    return compile(await loadConfig(configPath));
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAE3G,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,YAAY,GAA2B,EAAE,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,iHAAiH;IACjH,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,YAAY,EAAE,mBAAmB,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9J,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAA8C,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAChG,MAAM,MAAM,GAAI,GAAmC,CAAC,OAAO,IAAK,GAAqB,CAAC;IACtF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,yCAAyC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,OAAO,OAAO,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/naming.d.ts

@@ -0,0 +1,11 @@
+export declare function pluralize(word: string): string;
+export declare function singularize(word: string): string;
+export declare function words(input: string): string[];
+export declare const snakeCase: (s: string) => string;
+export declare const kebabCase: (s: string) => string;
+export declare const camelCase: (s: string) => string;
+export declare const pascalCase: (s: string) => string;
+export declare const titleCase: (s: string) => string;
+export declare const lowerFirst: (s: string) => string;
+export declare const isPascalCase: (s: string) => boolean;
+export declare const isCamelCase: (s: string) => boolean;

package/dist/naming.js

@@ -0,0 +1,58 @@
+const IRREGULAR = {
+    person: "people",
+    child: "children",
+    man: "men",
+    woman: "women",
+    status: "statuses",
+    data: "data",
+};
+export function pluralize(word) {
+    const lower = word.toLowerCase();
+    const irregular = IRREGULAR[lower];
+    if (irregular)
+        return matchCase(word, irregular);
+    if (/[^aeiou]y$/i.test(word))
+        return word.slice(0, -1) + "ies";
+    if (/(s|x|z|ch|sh)$/i.test(word))
+        return word + "es";
+    return word + "s";
+}
+function matchCase(source, target) {
+    return source[0] === source[0].toUpperCase() ? target[0].toUpperCase() + target.slice(1) : target;
+}
+const IRREGULAR_SINGULAR = Object.fromEntries(Object.entries(IRREGULAR).map(([s, p]) => [p, s]));
+export function singularize(word) {
+    const lower = word.toLowerCase();
+    const irregular = IRREGULAR_SINGULAR[lower];
+    if (irregular && irregular !== lower)
+        return matchCase(word, irregular);
+    if (/[^aeiou]ies$/i.test(word))
+        return word.slice(0, -3) + "y";
+    if (/(ss|x|z|ch|sh)es$/i.test(word))
+        return word.slice(0, -2);
+    if (/s$/i.test(word) && !/(ss|us|is)$/i.test(word))
+        return word.slice(0, -1);
+    return word;
+}
+export function words(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean);
+}
+export const snakeCase = (s) => words(s).map((w) => w.toLowerCase()).join("_");
+export const kebabCase = (s) => words(s).map((w) => w.toLowerCase()).join("-");
+export const camelCase = (s) => words(s)
+    .map((w, i) => (i === 0 ? w.toLowerCase() : w[0].toUpperCase() + w.slice(1).toLowerCase()))
+    .join("");
+export const pascalCase = (s) => words(s)
+    .map((w) => w[0].toUpperCase() + w.slice(1))
+    .join("");
+export const titleCase = (s) => words(s)
+    .map((w, i) => (i === 0 ? w[0].toUpperCase() + w.slice(1) : w.toLowerCase()))
+    .join(" ");
+export const lowerFirst = (s) => s[0].toLowerCase() + s.slice(1);
+export const isPascalCase = (s) => /^[A-Z][A-Za-z0-9]*$/.test(s);
+export const isCamelCase = (s) => /^[a-z][A-Za-z0-9]*$/.test(s);
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

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

package/dist/notifications.d.ts

@@ -0,0 +1,5 @@
+import type { NotificationRule } from "@tekki-forge/core";
+import type { EntityIR, NotificationRuleIR } from "./ir.js";
+/** Placeholders like {number} or {customer} in notification texts. */
+export declare function placeholders(text: string): string[];
+export declare function compileNotifications(rules: readonly NotificationRule[] | undefined, entities: EntityIR[], roles: string[], issue: (path: string, message: string) => void): NotificationRuleIR[];