@open-rap/compiler 0.0.0-stage → 0.1.1

package/dist/gen/docs/markdown.js

@@ -0,0 +1,187 @@
+/**
+ * A small Markdown renderer for the documentation app of `rapt dev` (D49): the subset the
+ * documentation of Open RAP Runtime uses — headings, paragraphs, lists (nested), code blocks and
+ * inline code, tables, block quotes, links, emphasis. Text is escaped; links to other pages
+ * (`FILE.md`, `FILE.md#anchor`) become routes of the app (`#/page/file`). The website renders the
+ * same Markdown with its own links and images (`RenderOptions`, D63).
+ */
+const escape = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+/** The id of a heading, as GitHub writes it. */
+export function headingId(text) {
+    return text
+        .toLowerCase()
+        .replace(/`/g, "")
+        .replace(/[^\p{L}\p{N}\s_-]/gu, "")
+        .trim()
+        .replace(/\s/g, "-");
+}
+/** The page id of a Markdown file name: `docs/DIAGNOSTICS.md` → `diagnostics`. */
+export function pageId(file) {
+    return (file.split("/").pop() ?? file).replace(/\.md$/i, "").toLowerCase();
+}
+function appLink(href) {
+    if (/^[a-z]+:/i.test(href)) {
+        return { href, external: true };
+    }
+    const match = /^(?:\.{0,2}\/)*(?:[\w./-]*\/)?([\w-]+)\.md(#.*)?$/i.exec(href);
+    if (match !== null) {
+        return { href: `#/page/${(match[1] ?? "").toLowerCase()}${match[2] === undefined ? "" : `/${match[2].slice(1)}`}`, external: false };
+    }
+    if (href.startsWith("#")) {
+        return { href: `#anchor-${href.slice(1)}`, external: false };
+    }
+    return { href, external: true };
+}
+/** Inline Markdown: code spans first (their content stays as written), then links and emphasis. */
+export function inline(text, options = {}) {
+    const codes = [];
+    let s = text.replace(/`([^`]+)`/g, (_m, code) => {
+        codes.push(`<code>${escape(code)}</code>`);
+        return `\u0000${codes.length - 1}\u0000`;
+    });
+    s = escape(s);
+    // images: shown from an absolute URL; the images of the repository are left out of the app
+    s = s.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (_m, alt, src) => {
+        const url = /^https?:\/\//i.test(src) ? src : options.image?.(src.replace(/&amp;/g, "&"));
+        return url === undefined ? "" : `<img src="${escape(url)}" alt="${alt}" style="max-width:100%">`;
+    });
+    s = s.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (_m, label, href) => {
+        const raw = href.replace(/&amp;/g, "&");
+        const target = options.link === undefined ? appLink(raw) : options.link(raw);
+        return target === null ? label : `<a href="${escape(target.href)}"${target.external ? ' target="_blank" rel="noopener"' : ""}>${label}</a>`;
+    });
+    s = s.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>").replace(/(^|[^*\w])\*([^*\s][^*]*)\*(?!\w)/g, "$1<em>$2</em>");
+    return s.replace(/\u0000(\d+)\u0000/g, (_m, i) => codes[Number(i)] ?? "");
+}
+function splitRow(line) {
+    const cells = [];
+    let current = "";
+    let code = false;
+    const body = line.trim().replace(/^\|/, "").replace(/\|$/, "");
+    for (let i = 0; i < body.length; i++) {
+        const c = body[i];
+        if (c === "`")
+            code = !code;
+        if (c === "\\" && body[i + 1] === "|") {
+            current += "|";
+            i++;
+            continue;
+        }
+        if (c === "|" && !code) {
+            cells.push(current.trim());
+            current = "";
+            continue;
+        }
+        current += c;
+    }
+    cells.push(current.trim());
+    return cells;
+}
+/** Renders a Markdown document as HTML. */
+export function renderMarkdown(markdown, options = {}) {
+    const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+    const out = [];
+    let i = 0;
+    const isBlockStart = (line) => /^(#{1,6}\s|```|>\s?|\s*[-*]\s|\s*\d+\.\s|\|)/.test(line) || line.trim() === "";
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        if (line.trim() === "") {
+            i++;
+            continue;
+        }
+        const heading = /^(#{1,6})\s+(.*)$/.exec(line);
+        if (heading !== null) {
+            const level = heading[1]?.length ?? 1;
+            const text = heading[2] ?? "";
+            out.push(`<h${level} id="anchor-${escape(headingId(text))}">${inline(text, options)}</h${level}>`);
+            i++;
+            continue;
+        }
+        if (line.startsWith("```")) {
+            const language = line.slice(3).trim();
+            const code = [];
+            i++;
+            while (i < lines.length && !(lines[i] ?? "").startsWith("```")) {
+                code.push(lines[i] ?? "");
+                i++;
+            }
+            i++;
+            out.push(`<pre><code${language === "" ? "" : ` class="language-${escape(language)}"`}>${escape(code.join("\n"))}</code></pre>`);
+            continue;
+        }
+        if (/^>\s?/.test(line)) {
+            const quote = [];
+            while (i < lines.length && /^>\s?/.test(lines[i] ?? "")) {
+                quote.push((lines[i] ?? "").replace(/^>\s?/, ""));
+                i++;
+            }
+            out.push(`<blockquote>${renderMarkdown(quote.join("\n"), options)}</blockquote>`);
+            continue;
+        }
+        if (line.trim().startsWith("|") && /^\s*\|?\s*:?-{3,}/.test(lines[i + 1] ?? "")) {
+            const header = splitRow(line);
+            const align = splitRow(lines[i + 1] ?? "").map((c) => (c.endsWith(":") ? (c.startsWith(":") ? "center" : "right") : ""));
+            i += 2;
+            const rows = [];
+            while (i < lines.length && (lines[i] ?? "").trim().startsWith("|")) {
+                rows.push(splitRow(lines[i] ?? ""));
+                i++;
+            }
+            const cell = (tag, text, index) => `<${tag}${align[index] ? ` style="text-align:${align[index]}"` : ""}>${inline(text, options)}</${tag}>`;
+            out.push(`<table><thead><tr>${header.map((h, k) => cell("th", h, k)).join("")}</tr></thead><tbody>${rows.map((r) => `<tr>${r.map((c, k) => cell("td", c, k)).join("")}</tr>`).join("")}</tbody></table>`);
+            continue;
+        }
+        if (/^\s*([-*]|\d+\.)\s/.test(line)) {
+            const block = [];
+            const ordered = /^\s*\d+\./.test(line);
+            const indent = line.length - line.trimStart().length;
+            while (i < lines.length && ((lines[i] ?? "").trim() === "" ? /^\s+([-*]|\d+\.)?\s*\S/.test(lines[i + 1] ?? "") : /^(\s*([-*]|\d+\.)\s|\s{2,}\S)/.test(lines[i] ?? ""))) {
+                const current = lines[i] ?? "";
+                // a list of the other kind at the same level starts a new list
+                if (block.length > 0 && current.length - current.trimStart().length <= indent && /^\s*([-*]|\d+\.)\s/.test(current) && /^\s*\d+\./.test(current) !== ordered) {
+                    break;
+                }
+                block.push(current);
+                i++;
+            }
+            out.push(renderList(block, options));
+            continue;
+        }
+        const paragraph = [];
+        while (i < lines.length && !isBlockStart(lines[i] ?? "")) {
+            paragraph.push((lines[i] ?? "").trim());
+            i++;
+        }
+        if (paragraph.length === 0) {
+            paragraph.push(line.trim());
+            i++;
+        }
+        out.push(`<p>${inline(paragraph.join(" "), options)}</p>`);
+    }
+    return out.join("\n");
+}
+/** A list and its nested lists (by indentation). */
+function renderList(block, options) {
+    const indentOf = (l) => l.length - l.trimStart().length;
+    const base = indentOf(block.find((l) => l.trim() !== "") ?? "");
+    const ordered = /^\s*\d+\./.test(block[0] ?? "");
+    const items = [];
+    for (const line of block) {
+        if (line.trim() === "")
+            continue;
+        if (indentOf(line) <= base + 1 && /^\s*([-*]|\d+\.)\s/.test(line)) {
+            items.push([line.trim().replace(/^([-*]|\d+\.)\s+/, "")]);
+        }
+        else {
+            items[items.length - 1]?.push(line);
+        }
+    }
+    const html = items.map(([first = "", ...rest]) => {
+        const nested = rest.filter((l) => /^\s*([-*]|\d+\.)\s/.test(l));
+        const text = [first, ...rest.filter((l) => !/^\s*([-*]|\d+\.)\s/.test(l)).map((l) => l.trim())].join(" ");
+        const sub = nested.length === 0 ? "" : renderList(rest.slice(rest.findIndex((l) => /^\s*([-*]|\d+\.)\s/.test(l))), options);
+        return `<li>${inline(text, options)}${sub}</li>`;
+    });
+    return ordered ? `<ol>${html.join("")}</ol>` : `<ul>${html.join("")}</ul>`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/gen/docs/markdown.js.map

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

package/dist/gen/docs/site.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The documentation pages of the website (D63): the same Markdown documents as the documentation
+ * app of `rapt dev` (D49), rendered as static pages `docs/<page>.html` next to the home page of
+ * the website. Links between documents point to the rendered pages; links to files of the
+ * repository that the website does not publish (sources, fixtures, license) become plain text,
+ * so that the website never sends a visitor to the repository.
+ */
+import { type RenderOptions } from "./markdown.js";
+/** The file of a page on the website: the README is the overview (`index.html`). */
+export declare function sitePageFile(id: string): string;
+/** The links and images of the Markdown, for the pages of the website. */
+export declare function siteRenderOptions(ids: ReadonlySet<string>): RenderOptions;
+/** The pages of the documentation for the website: `docs/index.html` (overview), `docs/<page>.html`. */
+export declare function generateSiteDocs(dir?: string | undefined): Array<{
+    path: string;
+    content: string;
+}>;

package/dist/gen/docs/site.js

@@ -0,0 +1,106 @@
+/**
+ * The documentation pages of the website (D63): the same Markdown documents as the documentation
+ * app of `rapt dev` (D49), rendered as static pages `docs/<page>.html` next to the home page of
+ * the website. Links between documents point to the rendered pages; links to files of the
+ * repository that the website does not publish (sources, fixtures, license) become plain text,
+ * so that the website never sends a visitor to the repository.
+ */
+import { documentationDir, documentationPages } from "./index.js";
+import { pageId } from "./markdown.js";
+const escape = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+/** The file of a page on the website: the README is the overview (`index.html`). */
+export function sitePageFile(id) {
+    return id === "readme" ? "index.html" : `${id}.html`;
+}
+/** The links and images of the Markdown, for the pages of the website. */
+export function siteRenderOptions(ids) {
+    return {
+        link: (href) => {
+            if (/^[a-z]+:/i.test(href)) {
+                return { href, external: true };
+            }
+            if (href.startsWith("#")) {
+                return { href: `#anchor-${href.slice(1)}`, external: false };
+            }
+            const match = /^((?:[\w.-]*\/)*)([\w-]+)\.md(?:#(.*))?$/i.exec(href);
+            if (match === null || /(^|\/)(fixtures|packages|site)\//.test(match[1] ?? "")) {
+                return null;
+            }
+            const id = pageId(match[2] ?? "");
+            if (!ids.has(id)) {
+                return null;
+            }
+            return { href: `${sitePageFile(id)}${match[3] === undefined ? "" : `#anchor-${match[3]}`}`, external: false };
+        },
+        image: (src) => {
+            const match = /(?:^|\/)images\/([\w.-]+\.(?:png|jpe?g|svg|gif|webp))$/i.exec(src);
+            return match === null ? undefined : `../images/${match[1]}`;
+        },
+    };
+}
+const ICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%230a6ed1'/%3E%3Cpath d='M9 22V10h7a4 4 0 0 1 0 8h-7m7 0 5 4' stroke='white' stroke-width='3' fill='none' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E";
+function title(page) {
+    return page.id === "readme" ? "Overview" : page.title;
+}
+function pageList(pages, current) {
+    return pages
+        .map((p) => {
+        const active = p.id === current.id;
+        const toc = active && p.headings.some((h) => h.level === 2) ? `<ul>${p.headings.filter((h) => h.level === 2).map((h) => `<li><a href="#${escape(h.id)}">${escape(h.title.replace(/\*\*/g, ""))}</a></li>`).join("")}</ul>` : "";
+        return `<li${active ? ' class="current"' : ""}><a href="${sitePageFile(p.id)}"${active ? ' aria-current="page"' : ""}>${escape(title(p))}</a>${toc}</li>`;
+    })
+        .join("");
+}
+function pageHtml(pages, page) {
+    const list = pageList(pages, page);
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escape(title(page))} — Open RAP Runtime documentation</title>
+  <meta name="description" content="Open RAP Runtime documentation: ${escape(title(page))}.">
+  <link rel="icon" href="${ICON}">
+  <link rel="stylesheet" href="../style.css">
+</head>
+<body class="docs-page">
+  <header class="top">
+    <div class="wrap nav">
+      <a class="brand" href="../index.html"><span class="logo" aria-hidden="true">R</span>Open RAP Runtime</a>
+      <nav aria-label="Main">
+        <a href="../index.html#features">Features</a>
+        <a href="index.html">Documentation</a>
+        <a href="../feedback.html">Feedback</a>
+        <a class="button small" href="../index.html#download">Download</a>
+      </nav>
+    </div>
+  </header>
+  <div class="wrap doc-layout">
+    <aside class="doc-side" aria-label="Documentation pages">
+      <details class="doc-menu">
+        <summary>Documentation pages</summary>
+        <ul>${list}</ul>
+      </details>
+      <ul class="doc-list">${list}</ul>
+    </aside>
+    <main class="doc" id="content">
+${page.html}
+    </main>
+  </div>
+  <footer>
+    <div class="wrap foot">
+      <span>Open RAP Runtime · MIT · not affiliated with SAP SE. SAP, ABAP, Fiori and SAP BTP are trademarks of SAP SE.</span>
+      <span class="foot-links"><a href="../index.html">Home</a> · <a href="../feedback.html">Report a bug or request a feature</a></span>
+    </div>
+  </footer>
+</body>
+</html>
+`;
+}
+/** The pages of the documentation for the website: `docs/index.html` (overview), `docs/<page>.html`. */
+export function generateSiteDocs(dir = documentationDir()) {
+    const ids = new Set(documentationPages(dir).map((p) => p.id));
+    const pages = documentationPages(dir, siteRenderOptions(ids));
+    return pages.map((page) => ({ path: `docs/${sitePageFile(page.id)}`, content: pageHtml(pages, page) }));
+}
+//# sourceMappingURL=site.js.map

package/dist/gen/docs/site.js.map

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

package/dist/gen/keycloak.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The realm of the Keycloak of a generated docker-compose (application D15, launchpad D37): the
+ * OIDC client, the roles (rapt/authorizations.json, D34) given to the user alice, and for each
+ * claim the roles read (`{claim:x}`) a user attribute (declared in the user profile, set by the
+ * administrator) mapped into the tokens.
+ */
+export interface RealmOptions {
+    clientId: string;
+    clientName: string;
+    secret: string;
+    /** Public URL of the client (`http://localhost:8080`): redirect URI, web origin, logout. */
+    url: string;
+    roles: Array<{
+        name: string;
+        description?: string;
+    }>;
+    claims: string[];
+}
+/** The user attribute holding a claim (Keycloak attribute names: letters, digits, `_` and `-`). */
+export declare const claimAttribute: (claim: string) => string;
+export declare function keycloakRealm(options: RealmOptions): Record<string, unknown>;

package/dist/gen/keycloak.js

@@ -0,0 +1,90 @@
+/**
+ * The realm of the Keycloak of a generated docker-compose (application D15, launchpad D37): the
+ * OIDC client, the roles (rapt/authorizations.json, D34) given to the user alice, and for each
+ * claim the roles read (`{claim:x}`) a user attribute (declared in the user profile, set by the
+ * administrator) mapped into the tokens.
+ */
+/** The default attributes of the Keycloak user profile (declarative user profile, Keycloak 24+). */
+const PROFILE_ATTRIBUTES = [
+    { name: "username", displayName: "${username}", validations: { length: { min: 3, max: 255 }, "username-prohibited-characters": {}, "up-username-not-idn-homograph": {} }, permissions: { view: ["admin", "user"], edit: ["admin", "user"] }, multivalued: false },
+    { name: "email", displayName: "${email}", validations: { email: {}, length: { max: 255 } }, required: { roles: ["user"] }, permissions: { view: ["admin", "user"], edit: ["admin", "user"] }, multivalued: false },
+    { name: "firstName", displayName: "${firstName}", validations: { length: { max: 255 }, "person-name-prohibited-characters": {} }, required: { roles: ["user"] }, permissions: { view: ["admin", "user"], edit: ["admin", "user"] }, multivalued: false },
+    { name: "lastName", displayName: "${lastName}", validations: { length: { max: 255 }, "person-name-prohibited-characters": {} }, required: { roles: ["user"] }, permissions: { view: ["admin", "user"], edit: ["admin", "user"] }, multivalued: false },
+];
+/** The user attribute holding a claim (Keycloak attribute names: letters, digits, `_` and `-`). */
+export const claimAttribute = (claim) => claim.replace(/[^A-Za-z0-9_-]/g, "_");
+export function keycloakRealm(options) {
+    const { roles, claims } = options;
+    const result = {
+        realm: "rapt",
+        enabled: true,
+        roles: { realm: [{ name: "rapt_user", description: "User of the generated application" }, ...roles.filter((r) => r.name !== "rapt_user").map((r) => ({ name: r.name, ...(r.description === undefined ? {} : { description: r.description }) }))] },
+        clients: [
+            {
+                clientId: options.clientId,
+                name: options.clientName,
+                enabled: true,
+                protocol: "openid-connect",
+                publicClient: false,
+                secret: options.secret,
+                standardFlowEnabled: true,
+                directAccessGrantsEnabled: false,
+                redirectUris: [`${options.url}/auth/callback`],
+                webOrigins: [options.url],
+                attributes: { "pkce.code.challenge.method": "S256", "post.logout.redirect.uris": `${options.url}/*` },
+                ...(claims.length === 0
+                    ? {}
+                    : {
+                        protocolMappers: claims.map((claim) => ({
+                            name: claim,
+                            protocol: "openid-connect",
+                            protocolMapper: "oidc-usermodel-attribute-mapper",
+                            consentRequired: false,
+                            config: {
+                                "user.attribute": claimAttribute(claim),
+                                "claim.name": claim,
+                                "jsonType.label": "String",
+                                multivalued: "true",
+                                "id.token.claim": "true",
+                                "access.token.claim": "true",
+                                "userinfo.token.claim": "true",
+                                "introspection.token.claim": "true",
+                            },
+                        })),
+                    }),
+            },
+        ],
+        users: [
+            {
+                username: "alice",
+                enabled: true,
+                firstName: "Alice",
+                lastName: "Example",
+                email: "alice@example.org",
+                emailVerified: true,
+                credentials: [{ type: "password", value: "alice", temporary: false }],
+                realmRoles: ["rapt_user", ...roles.filter((r) => r.name !== "rapt_user").map((r) => r.name)],
+            },
+        ],
+    };
+    if (claims.length > 0) {
+        result["components"] = {
+            "org.keycloak.userprofile.UserProfileProvider": [
+                {
+                    providerId: "declarative-user-profile",
+                    subComponents: {},
+                    config: {
+                        "kc.user.profile.config": [
+                            JSON.stringify({
+                                attributes: [...PROFILE_ATTRIBUTES, ...claims.map((claim) => ({ name: claimAttribute(claim), displayName: claim, permissions: { view: ["admin"], edit: ["admin"] }, multivalued: true }))],
+                                groups: [{ name: "user-metadata", displayHeader: "User metadata", displayDescription: "Attributes, which refer to user metadata" }],
+                            }),
+                        ],
+                    },
+                },
+            ],
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=keycloak.js.map

package/dist/gen/keycloak.js.map

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

package/dist/gen/launchpad/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `rapt launchpad`: the folder of a launchpad of applications (decision D37). Its server (the
+ * runtime, embedded in `vendor/`) serves the OpenUI5 launchpad, opens the sessions the
+ * applications read and forwards their requests; docker-compose starts it with the applications
+ * built by `rapt build` (one PostgreSQL each) and, in the `oidc` profile, Keycloak.
+ */
+import { type LaunchpadModel } from "@open-rap/model";
+import { Diagnostics } from "../../diagnostics.js";
+import { type BuiltApp } from "../../launchpad/config.js";
+export interface LaunchpadOptions {
+    /** Folder of the @open-rap/runtime package (default: next to the compiler). */
+    runtimeDir?: string;
+    /** The output folder: docker-compose builds the applications from their folders, relative to it. */
+    outDir?: string;
+    /** The applications built from their sources (D69), by id. */
+    built?: Map<string, BuiltApp>;
+}
+export interface LaunchpadResult {
+    diagnostics: Diagnostics;
+    model?: LaunchpadModel;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+/** The files of the OpenUI5 launchpad (`ui/`), served by the launchpad server. */
+export declare function generateLaunchpadUi(model: LaunchpadModel): Array<{
+    path: string;
+    content: string;
+}>;
+/** Resolves `launchpad.json` and generates the files of the launchpad. */
+export declare function generateLaunchpad(file: string, options?: LaunchpadOptions): LaunchpadResult;
+export interface LaunchpadBuildResult extends LaunchpadResult {
+    /** The applications built from their sources, into apps/<id>/ of the output folder. */
+    apps: Array<{
+        id: string;
+        source: string;
+        out: string;
+        files: number;
+    }>;
+}
+/**
+ * `rapt launchpad`: the launchpad and, built from their sources (`source`, D69) into
+ * `apps/<id>/`, its applications. A single folder to deploy: docker-compose starts them all.
+ */
+export declare function buildLaunchpad(file: string, options: LaunchpadOptions & {
+    outDir: string;
+}): Promise<LaunchpadBuildResult>;