@meltemi/diagrams-cli 0.0.0-stage → 1.9.0

package/dist/messages/push-pull-en.js

@@ -0,0 +1,146 @@
+/**
+ * The words of `push` and `pull` in English (`cli-cloud`), kept beside `en.ts` so that the two
+ * commands own their sentences: their help, their output, and the failures they name by stable code
+ * (`push.*`, `pull.*`, and the service's own codes as these commands meet them). `en.ts` hangs them
+ * under `help` and `cloud`; `push-pull-es.ts` has the Spanish with the same shape.
+ */
+const count = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+export const pushPullEn = {
+    help: {
+        push: `Usage: push [folder] [options]
+
+Makes the cloud project match the folder (the working folder by default): project.json, the
+sheets, themes and other text files travel by content, images and fonts by hash, and what the
+folder lacks is deleted in the cloud, all in one transaction. Dotfiles, node_modules, what
+project.json excludes and the catalog's output folder are never sent. The cloud project is the
+one --project names, else project.json's "cloud".
+
+Before changing anything it compares every path with the cloud's and lists those that differ,
+beside the review by id of the diagrams. Only a cloud that already matches the folder is pushed
+without asking; otherwise a terminal is asked "Overwrite these changes in the cloud?", and without
+one the push is refused unless --force. A change made in the cloud while pushing is never
+overwritten without that question (or --force).
+
+Options:
+  --create          Make a new cloud project from the folder and record it in project.json
+  --name <name>     With --create, the project's name; project.json's name by default
+  --project <id>    The cloud project, instead of project.json's "cloud"
+  --force           Overwrite what differs in the cloud without asking
+  --check           Write nothing; list what differs (exit 1 if anything does)
+  --strict          Do not push when validation finds errors
+  --host <url>      The service: MELTEMI_HOST, else https://diagrams.meltemi.dev
+
+Exit codes: 0 pushed, or nothing to push, 1 refused or failed (or --check found differences),
+2 usage error, 3 not signed in or the service refused the token.
+`,
+        pull: `Usage: pull [<id>] [folder] [options]
+
+Writes the files of a cloud project into the folder (the working folder by default). The project
+is <id> (20 letters and digits), else the one project.json's "cloud" names. Files that already
+match are left alone; a file that exists and differs is listed and kept unless --force; files
+that are only in the folder stay. Images and fonts are fetched by hash and checked. project.json
+gains "cloud" when it has none, and nothing else of it changes.
+
+Every cloud path is checked before anything is written: one that is not a plain relative path
+inside the folder (or that Windows could not keep) refuses the whole pull with pull.unsafe-path.
+
+Options:
+  --version <n>  Pull this version of the project instead of its latest files
+  --force        Overwrite files that differ
+  --host <url>   The service: MELTEMI_HOST, else https://diagrams.meltemi.dev
+
+Exit codes: 0 pulled, 1 refused, failed or some files kept, 2 usage error, 3 not signed in or the
+service refused the token.
+`,
+    },
+    push: {
+        nameNeedsCreate: "--name goes with --create.",
+        nameEmpty: "--name needs a name.",
+        createWithProject: "--create makes a new project, so it cannot be combined with --project.",
+        checkWithCreate: "--check only reports, so it cannot be combined with --create.",
+        oneFolder: "push takes one folder.",
+        notAFolder: (path) => `${path} is not a folder.`,
+        /** The heading of the paths that differ. */
+        differs: (n) => `The cloud project differs from the folder in ${count(n, "path")}:`,
+        pathAdded: (path) => `  ${path} is not in the cloud yet`,
+        pathChanged: (path) => `  ${path} differs`,
+        pathDeleted: (path) => `  ${path} is only in the cloud (pushing deletes it)`,
+        /** The heading of the review by id. */
+        review: "By id, what pushing changes in the diagrams:",
+        identical: (id) => `The cloud project ${id} already matches the folder; nothing to push.`,
+        /** The question on a terminal; the answers it accepts are yes and no. */
+        overwrite: "Overwrite these changes in the cloud? [y/N] ",
+        retrying: "The cloud project changed while pushing; comparing again.",
+        checkDiffers: (n) => `${count(n, "path")} differ${n === 1 ? "s" : ""}; pushing would change the cloud project.`,
+        created: (id, name) => `Created the cloud project ${id} (${name}).`,
+        recorded: (path) => `Recorded the cloud project in ${path}.`,
+        pushed: (id, written, deleted, uploaded) => {
+            const parts = [`${count(written, "file")} written`];
+            if (deleted > 0)
+                parts.push(`${count(deleted, "file")} deleted`);
+            if (uploaded > 0)
+                parts.push(`${count(uploaded, "image or font", "images or fonts")} uploaded`);
+            return `Pushed to the cloud project ${id}: ${parts.join(", ")}.`;
+        },
+        /** Where to see the project. */
+        open: (url) => `Open it at ${url}`,
+        /** A file or folder that is not sent. */
+        notSent: (path, reason) => `warning: ${path} is not sent: ${reason}`,
+        reasons: {
+            path: "its name is not one the cloud keeps (ASCII letters, digits, spaces and . _ ( ) + @ -, no name starting with a dot, at most 12 names of 100 characters).",
+            encoding: "it is not UTF-8 text.",
+            unreadable: (why) => `it cannot be read (${why}).`,
+        },
+        /** Files the cloud does not keep, such as a PDF. */
+        ignored: (n, examples) => `${count(n, "file")} not kept in the cloud (it keeps diagrams, text, images and fonts): ${examples}`,
+        /** A copy two people made at once in the cloud, which a push never touches. */
+        collision: (path) => `${path} is a copy that two people made at once in the cloud; the push leaves it alone. Settle it in the page.`,
+    },
+    pull: {
+        tooMany: "pull takes an id and a folder at most.",
+        version: (text) => `--version takes a version number, such as 3, not "${text}".`,
+        wrote: (path) => `  wrote ${path}`,
+        kept: (path) => `  kept ${path} (it differs from the cloud)`,
+        inTheWay: (path) => `  kept ${path} (a folder is in its place)`,
+        keptHint: "Pass --force to overwrite the files that differ.",
+        loser: (path) => `  skipped ${path}: a copy two people made at once in the cloud; settle it in the page`,
+        recorded: (path) => `Recorded the cloud project in ${path}.`,
+        noManifest: "The project has no project.json, so nothing in the folder records which cloud project it mirrors; give the id next time.",
+        pulled: (id, version, folder, written, identical, kept) => `Pulled ${version === null ? "the latest files" : `version ${version}`} of the cloud project ${id} into ${folder}: ${written} written, ${identical} already identical, ${kept} kept.`,
+    },
+    /** Why a failure of these commands (or of the service, as they meet it) happened, by stable code. */
+    errors: {
+        revisionMismatch: "the cloud project changed again while pushing, so nothing was overwritten. Run push again.",
+        quotaFiles: "a project holds at most 2000 files.",
+        quotaBinary: (path) => path === ""
+            ? "an image or font may be at most 10 MiB."
+            : `${path} is larger than the 10 MiB an image or font may be.`,
+        quotaStorage: "this account would go over its 200 MiB of storage.",
+        quotaProjects: "this account already holds 100 projects.",
+        docTooLarge: (path) => path === ""
+            ? "the texts of the folder are larger than the 16 MiB a project's document holds."
+            : `${path} is larger than the 2 Mi characters a text file may have.`,
+        pathInvalid: (path) => path === "" ? "a path is not one the cloud keeps." : `${path} is not a path the cloud keeps.`,
+        binaryInvalid: (path) => `${path === "" ? "an upload" : path} is not a PNG, JPEG, GIF, WebP, woff2, ttf or otf by its bytes.`,
+        pushDiffers: (n) => `the cloud project differs from the folder in ${count(n, "path")}, so nothing was pushed. Run push on a terminal to be asked, or pass --force.`,
+        pushDeclined: "nothing was pushed.",
+        pushLinked: (project) => `project.json already names the cloud project ${project}: push without --create, or remove its "cloud" setting to make another.`,
+        pushStrict: (errors, unsent) => {
+            const parts = [];
+            if (errors > 0)
+                parts.push(count(errors, "validation error"));
+            if (unsent > 0)
+                parts.push(`${count(unsent, "file")} that cannot be sent`);
+            return `${parts.join(" and ")}, and --strict is given, so nothing was pushed.`;
+        },
+        pushManifestInvalid: (reason) => `project.json is not a JSON object that can be edited (${reason}); fix it before --create. Nothing was created.`,
+        pushManifestNotWritten: (project, host, reason) => `the cloud project ${project} was created with the folder's text files, but project.json could not be updated (${reason}). Add "cloud": { "host": "${host}", "project": "${project}" } to it yourself, then run push.`,
+        pushFileChanged: (path) => `${path} changed while it was being pushed; nothing of it was kept. Run push again.`,
+        pullNoProject: "no cloud project is named: give its id, or run pull in a folder whose project.json has a cloud setting.",
+        pullOtherProject: (project, linked) => `project.json already names the cloud project ${linked}; pulling ${project} here would mix the two. Pull into another folder.`,
+        pullNotAFolder: (path) => `${path} exists and is not a folder.`,
+        pullManifestNotUpdated: (reason) => `project.json could not be updated with the cloud project (${reason}); the other files were written.`,
+        pullWrite: (path, reason) => `cannot write ${path}: ${reason}`,
+    },
+};
+//# sourceMappingURL=push-pull-en.js.map

package/dist/messages/push-pull-en.js.map

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

package/dist/messages/push-pull-es.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Las palabras de `push` y `pull` en español (`cli-cloud`), con la misma forma que
+ * `push-pull-en.ts`; `es.ts` las cuelga de `help` y `cloud`.
+ */
+import type { pushPullEn } from "./push-pull-en.js";
+export declare const pushPullEs: typeof pushPullEn;
+//# sourceMappingURL=push-pull-es.d.ts.map

package/dist/messages/push-pull-es.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-pull-es.d.ts","sourceRoot":"","sources":["../../src/messages/push-pull-es.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,eAAO,MAAM,UAAU,EAAE,OAAO,UA2J/B,CAAC"}

package/dist/messages/push-pull-es.js

@@ -0,0 +1,144 @@
+/**
+ * Las palabras de `push` y `pull` en español (`cli-cloud`), con la misma forma que
+ * `push-pull-en.ts`; `es.ts` las cuelga de `help` y `cloud`.
+ */
+import { plural } from "@meltemi/diagrams-i18n";
+/** A count with its word: "1 archivo", "3 archivos". */
+const count = (n, one, other) => `${n} ${plural("es", n, { one, other })}`;
+export const pushPullEs = {
+    help: {
+        push: `Uso: push [carpeta] [opciones]
+
+Hace que el proyecto de la nube coincida con la carpeta (por defecto, la carpeta de trabajo):
+project.json, las hojas, los temas y los demás archivos de texto viajan por su contenido, las
+imágenes y las fuentes por su hash, y lo que le falta a la carpeta se borra en la nube, todo en
+una sola transacción. Los archivos con punto, node_modules, lo que project.json excluye y la
+carpeta de salida del catálogo nunca se envían. El proyecto de la nube es el que nombra
+--project, si no el "cloud" de project.json.
+
+Antes de cambiar nada compara cada ruta con la de la nube y lista las que difieren, junto a la
+revisión por id de los diagramas. Solo una nube que ya coincide con la carpeta se actualiza sin
+preguntar; si no, a una terminal se le pregunta "¿Sobrescribir estos cambios en la nube?", y sin
+terminal el push se rechaza salvo con --force. Un cambio hecho en la nube mientras se envía nunca
+se sobrescribe sin esa pregunta (o --force).
+
+Opciones:
+  --create          Crear un proyecto nuevo en la nube con la carpeta y anotarlo en project.json
+  --name <nombre>   Con --create, el nombre del proyecto; el de project.json por defecto
+  --project <id>    El proyecto de la nube, en vez del "cloud" de project.json
+  --force           Sobrescribir sin preguntar lo que difiere en la nube
+  --check           No escribir nada; listar lo que difiere (sale con 1 si algo difiere)
+  --strict          No enviar si la validación encuentra errores
+  --host <url>      El servicio: MELTEMI_HOST, si no https://diagrams.meltemi.dev
+
+Códigos de salida: 0 enviado, o nada que enviar, 1 rechazado o fallido (o --check encontró
+diferencias), 2 error de uso, 3 sin sesión iniciada o el servicio rechazó el token.
+`,
+        pull: `Uso: pull [<id>] [carpeta] [opciones]
+
+Escribe los archivos de un proyecto de la nube en la carpeta (por defecto, la carpeta de trabajo).
+El proyecto es <id> (20 letras y dígitos), si no el que nombra el "cloud" de project.json. Los
+archivos que ya coinciden se dejan; un archivo que existe y difiere se lista y se conserva salvo
+con --force; los archivos que solo están en la carpeta se quedan. Las imágenes y las fuentes se
+traen por su hash y se comprueban. project.json recibe "cloud" si no lo tiene, y nada más de él
+cambia.
+
+Cada ruta de la nube se comprueba antes de escribir nada: una que no sea una ruta relativa simple
+dentro de la carpeta (o que Windows no pudiera guardar) rechaza todo el pull con
+pull.unsafe-path.
+
+Opciones:
+  --version <n>  Traer esta versión del proyecto en vez de sus últimos archivos
+  --force        Sobrescribir los archivos que difieren
+  --host <url>   El servicio: MELTEMI_HOST, si no https://diagrams.meltemi.dev
+
+Códigos de salida: 0 hecho, 1 rechazado, fallido o con archivos conservados, 2 error de uso,
+3 sin sesión iniciada o el servicio rechazó el token.
+`,
+    },
+    push: {
+        nameNeedsCreate: "--name va con --create.",
+        nameEmpty: "--name necesita un nombre.",
+        createWithProject: "--create crea un proyecto nuevo, así que no se combina con --project.",
+        checkWithCreate: "--check solo informa, así que no se combina con --create.",
+        oneFolder: "push lleva una sola carpeta.",
+        notAFolder: (path) => `${path} no es una carpeta.`,
+        differs: (n) => `El proyecto de la nube difiere de la carpeta en ${count(n, "ruta", "rutas")}:`,
+        pathAdded: (path) => `  ${path} todavía no está en la nube`,
+        pathChanged: (path) => `  ${path} difiere`,
+        pathDeleted: (path) => `  ${path} solo está en la nube (el push la borra)`,
+        review: "Por id, lo que el push cambia en los diagramas:",
+        identical: (id) => `El proyecto ${id} de la nube ya coincide con la carpeta; no hay nada que enviar.`,
+        overwrite: "¿Sobrescribir estos cambios en la nube? [s/N] ",
+        retrying: "El proyecto de la nube cambió mientras se enviaba; se compara de nuevo.",
+        checkDiffers: (n) => `${n === 1 ? "difiere 1 ruta" : `difieren ${n} rutas`}; el push cambiaría el proyecto de la nube.`,
+        created: (id, name) => `Se creó el proyecto ${id} en la nube (${name}).`,
+        recorded: (path) => `Se anotó el proyecto de la nube en ${path}.`,
+        pushed: (id, written, deleted, uploaded) => {
+            const parts = [`${count(written, "archivo escrito", "archivos escritos")}`];
+            if (deleted > 0)
+                parts.push(count(deleted, "archivo borrado", "archivos borrados"));
+            if (uploaded > 0)
+                parts.push(count(uploaded, "imagen o fuente subida", "imágenes o fuentes subidas"));
+            return `Enviado al proyecto ${id} de la nube: ${parts.join(", ")}.`;
+        },
+        open: (url) => `Ábrelo en ${url}`,
+        notSent: (path, reason) => `advertencia: ${path} no se envía: ${reason}`,
+        reasons: {
+            path: "su nombre no es de los que guarda la nube (letras ASCII, dígitos, espacios y . _ ( ) + @ -, ningún nombre que empiece por punto, a lo sumo 12 nombres de 100 caracteres).",
+            encoding: "no es texto UTF-8.",
+            unreadable: (why) => `no se puede leer (${why}).`,
+        },
+        ignored: (n, examples) => `${count(n, "archivo no se guarda", "archivos no se guardan")} en la nube (guarda diagramas, texto, imágenes y fuentes): ${examples}`,
+        collision: (path) => `${path} es una copia que dos personas hicieron a la vez en la nube; el push la deja como está. Resuélvelo en la página.`,
+    },
+    pull: {
+        tooMany: "pull lleva como máximo un id y una carpeta.",
+        version: (text) => `--version lleva un número de versión, como 3, no "${text}".`,
+        wrote: (path) => `  se escribió ${path}`,
+        kept: (path) => `  se conservó ${path} (difiere de la nube)`,
+        inTheWay: (path) => `  se conservó ${path} (hay una carpeta en su lugar)`,
+        keptHint: "Pasa --force para sobrescribir los archivos que difieren.",
+        loser: (path) => `  se omitió ${path}: una copia que dos personas hicieron a la vez en la nube; resuélvelo en la página`,
+        recorded: (path) => `Se anotó el proyecto de la nube en ${path}.`,
+        noManifest: "El proyecto no tiene project.json, así que nada en la carpeta anota qué proyecto de la nube refleja; da el id la próxima vez.",
+        pulled: (id, version, folder, written, identical, kept) => `${version === null ? "Se trajeron los últimos archivos" : `Se trajo la versión ${version}`} del proyecto ${id} de la nube a ${folder}: ${written} escritos, ${identical} ya idénticos, ${kept} conservados.`,
+    },
+    errors: {
+        revisionMismatch: "el proyecto de la nube volvió a cambiar mientras se enviaba, así que no se sobrescribió nada. Ejecuta push otra vez.",
+        quotaFiles: "un proyecto guarda como máximo 2000 archivos.",
+        quotaBinary: (path) => path === ""
+            ? "una imagen o fuente puede pesar como máximo 10 MiB."
+            : `${path} pesa más de los 10 MiB que puede tener una imagen o fuente.`,
+        quotaStorage: "esta cuenta superaría sus 200 MiB de almacenamiento.",
+        quotaProjects: "esta cuenta ya tiene 100 proyectos.",
+        docTooLarge: (path) => path === ""
+            ? "los textos de la carpeta superan los 16 MiB que guarda el documento de un proyecto."
+            : `${path} supera los 2 Mi caracteres que puede tener un archivo de texto.`,
+        pathInvalid: (path) => path === ""
+            ? "una ruta no es de las que guarda la nube."
+            : `${path} no es una ruta de las que guarda la nube.`,
+        binaryInvalid: (path) => `${path === "" ? "una subida" : path} no es un PNG, JPEG, GIF, WebP, woff2, ttf u otf según sus bytes.`,
+        pushDiffers: (n) => `el proyecto de la nube difiere de la carpeta en ${count(n, "ruta", "rutas")}, así que no se envió nada. Ejecuta push en una terminal para que te pregunte, o pasa --force.`,
+        pushDeclined: "no se envió nada.",
+        pushLinked: (project) => `project.json ya nombra el proyecto ${project} de la nube: haz push sin --create, o quita su ajuste "cloud" para crear otro.`,
+        pushStrict: (errors, unsent) => {
+            const parts = [];
+            if (errors > 0)
+                parts.push(count(errors, "error de validación", "errores de validación"));
+            if (unsent > 0) {
+                parts.push(count(unsent, "archivo que no se puede enviar", "archivos que no se pueden enviar"));
+            }
+            return `${parts.join(" y ")}, y se pasó --strict, así que no se envió nada.`;
+        },
+        pushManifestInvalid: (reason) => `project.json no es un objeto JSON que se pueda editar (${reason}); corrígelo antes de --create. No se creó nada.`,
+        pushManifestNotWritten: (project, host, reason) => `el proyecto ${project} de la nube se creó con los archivos de texto de la carpeta, pero no se pudo actualizar project.json (${reason}). Añádele tú "cloud": { "host": "${host}", "project": "${project}" } y ejecuta push.`,
+        pushFileChanged: (path) => `${path} cambió mientras se enviaba; no se guardó nada de él. Ejecuta push otra vez.`,
+        pullNoProject: "no se nombra ningún proyecto de la nube: da su id, o ejecuta pull en una carpeta cuyo project.json tenga un ajuste cloud.",
+        pullOtherProject: (project, linked) => `project.json ya nombra el proyecto ${linked} de la nube; traer ${project} aquí mezclaría los dos. Trae el proyecto a otra carpeta.`,
+        pullNotAFolder: (path) => `${path} existe y no es una carpeta.`,
+        pullManifestNotUpdated: (reason) => `no se pudo actualizar project.json con el proyecto de la nube (${reason}); los demás archivos se escribieron.`,
+        pullWrite: (path, reason) => `no se puede escribir ${path}: ${reason}`,
+    },
+};
+//# sourceMappingURL=push-pull-es.js.map

package/dist/messages/push-pull-es.js.map

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

package/dist/open-url.d.ts

@@ -0,0 +1,11 @@
+/** The program that opens an address in the user's browser on a platform, with its arguments. */
+export declare function browserCommand(url: string, platform?: NodeJS.Platform): {
+    readonly command: string;
+    readonly args: readonly string[];
+};
+/**
+ * Opens a web address in the default browser, without a shell. Resolves once the opener started and
+ * rejects when it could not (no `xdg-open`, say), so that the caller can print the address.
+ */
+export declare function openUrl(url: string, platform?: NodeJS.Platform): Promise<void>;
+//# sourceMappingURL=open-url.d.ts.map

package/dist/open-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-url.d.ts","sourceRoot":"","sources":["../src/open-url.ts"],"names":[],"mappings":"AAEA,iGAAiG;AACjG,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAYhE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAehG"}

package/dist/open-url.js

@@ -0,0 +1,36 @@
+import { spawn } from "node:child_process";
+/** The program that opens an address in the user's browser on a platform, with its arguments. */
+export function browserCommand(url, platform = process.platform) {
+    // Only web addresses, which the command line builds itself: never what a server or a file says.
+    const protocol = new URL(url).protocol;
+    if (protocol !== "http:" && protocol !== "https:") {
+        throw new Error(`Refusing to open ${protocol} addresses.`);
+    }
+    // No shell on any platform, so that `&` and quotes in the address mean nothing: `cmd /c start`
+    // would read them as its own syntax.
+    if (platform === "win32") {
+        return { command: "rundll32.exe", args: ["url.dll,FileProtocolHandler", url] };
+    }
+    return { command: platform === "darwin" ? "open" : "xdg-open", args: [url] };
+}
+/**
+ * Opens a web address in the default browser, without a shell. Resolves once the opener started and
+ * rejects when it could not (no `xdg-open`, say), so that the caller can print the address.
+ */
+export function openUrl(url, platform = process.platform) {
+    const { command, args } = browserCommand(url, platform);
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, [...args], {
+            detached: true,
+            stdio: "ignore",
+            windowsHide: true,
+            shell: false,
+        });
+        child.once("error", reject);
+        child.once("spawn", () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=open-url.js.map

package/dist/open-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-url.js","sourceRoot":"","sources":["../src/open-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,iGAAiG;AACjG,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,WAA4B,OAAO,CAAC,QAAQ;IAE5C,gGAAgG;IAChG,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACvC,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,aAAa,CAAC,CAAC;IAC7D,CAAC;IACD,+FAA+F;IAC/F,qCAAqC;IACrC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,6BAA6B,EAAE,GAAG,CAAC,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,WAA4B,OAAO,CAAC,QAAQ;IAC/E,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;YACtC,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/plugins-command.d.ts

@@ -0,0 +1,15 @@
+import type { Diagnostic } from "@meltemi/diagrams-language";
+import { type Workspace } from "@meltemi/diagrams-project";
+/** What the plugins command needs from the CLI. */
+export interface PluginsContext {
+    readonly name: string;
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+    readonly cwd: string;
+    readonly display: (path: string) => string;
+    readonly workspaceFor: (path: string, isDirectory: boolean) => Workspace;
+    readonly printDiagnostics: (path: string, diagnostics: readonly Diagnostic[]) => void;
+}
+/** `meltemi-diagrams plugins`. */
+export declare function pluginsCommand(args: readonly string[], context: PluginsContext): number;
+//# sourceMappingURL=plugins-command.d.ts.map

package/dist/plugins-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-command.d.ts","sourceRoot":"","sources":["../src/plugins-command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGxF,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,SAAS,CAAC;IACzE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,KAAK,IAAI,CAAC;CACvF;AAED,kCAAkC;AAClC,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAuGvF"}

package/dist/plugins-command.js

@@ -0,0 +1,106 @@
+import { statSync } from "node:fs";
+import { resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { relativePath, toProjectPath } from "@meltemi/diagrams-project";
+import { argumentsError, messages } from "./messages/index.js";
+/** `meltemi-diagrams plugins`. */
+export function pluginsCommand(args, context) {
+    let values;
+    let positionals;
+    try {
+        const parsed = parseArgs({
+            args: [...args],
+            options: {
+                json: { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        values = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch (error) {
+        context.stderr(`${context.name} plugins: ${argumentsError(error)}\n`);
+        return 2;
+    }
+    if (values.help) {
+        context.stdout(messages().help.plugins);
+        return 0;
+    }
+    const target = toProjectPath(resolve(context.cwd, positionals[0] ?? "."));
+    let isDirectory;
+    try {
+        isDirectory = statSync(target).isDirectory();
+    }
+    catch {
+        context.stderr(`${context.name} plugins: ${messages().common.pathNotFound(positionals[0] ?? ".")}\n`);
+        return 2;
+    }
+    const workspace = context.workspaceFor(target, isDirectory);
+    const loaded = workspace.plugins();
+    const installed = workspace.manifest().manifest?.plugins ?? [];
+    const errors = [...loaded.diagnostics.values()].flat().some((d) => d.severity === "error");
+    if (values.json) {
+        context.stdout(`${JSON.stringify({
+            plugins: installed.map((setting) => {
+                const plugin = loaded.plugins.find((p) => p.name === setting.name);
+                return {
+                    name: setting.name,
+                    version: setting.version,
+                    path: setting.path,
+                    granted: setting.permissions,
+                    loaded: plugin !== undefined,
+                    ...(plugin
+                        ? {
+                            description: plugin.description,
+                            license: plugin.license,
+                            homepage: plugin.homepage,
+                            permissions: plugin.permissions,
+                            types: plugin.types.map((t) => ({
+                                type: t.type,
+                                title: t.title,
+                                kinds: Object.keys(t.elements),
+                            })),
+                            icons: plugin.icons === null ? null : plugin.name,
+                            integrity: plugin.integrity,
+                        }
+                        : {}),
+                };
+            }),
+            problems: [...loaded.diagnostics].map(([path, list]) => ({
+                path: relativePath(workspace.root, path),
+                diagnostics: list.map((d) => ({
+                    code: d.code,
+                    severity: d.severity,
+                    message: d.message,
+                })),
+            })),
+        }, null, 2)}\n`);
+        return errors ? 1 : 0;
+    }
+    const t = messages().plugins;
+    if (installed.length === 0)
+        context.stdout(`${t.none}\n`);
+    for (const setting of installed) {
+        const plugin = loaded.plugins.find((p) => p.name === setting.name);
+        if (!plugin) {
+            context.stdout(`${t.notLoaded(setting.name, setting.version)}\n`);
+            continue;
+        }
+        context.stdout(`${plugin.name} ${plugin.version}${plugin.license ? ` (${plugin.license})` : ""}${plugin.description ? ` — ${plugin.description}` : ""}\n`);
+        if (plugin.homepage)
+            context.stdout(`${t.from(plugin.homepage)}\n`);
+        context.stdout(`${t.folder(setting.path, setting.permissions)}\n`);
+        for (const type of plugin.types) {
+            context.stdout(`${t.type(type.type, type.title, Object.keys(type.elements))}\n`);
+        }
+        if (plugin.icons)
+            context.stdout(`${t.icons(plugin.name)}\n`);
+    }
+    for (const [path, list] of loaded.diagnostics) {
+        context.printDiagnostics(context.display(path), list);
+    }
+    return errors ? 1 : 0;
+}
+//# sourceMappingURL=plugins-command.js.map

package/dist/plugins-command.js.map

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

package/dist/preview.d.ts

@@ -0,0 +1,54 @@
+import type { Diagnostic } from "@meltemi/diagrams-language";
+import { type CatalogBuild, type ProjectSessions } from "@meltemi/diagrams-editor/node";
+import { type Workspace } from "@meltemi/diagrams-project";
+export interface PreviewOptions {
+    /** The project folder, or a file whose diagrams open first. */
+    readonly target: string;
+    readonly isFolder: boolean;
+    /** 0 picks a free port. */
+    readonly port: number;
+    readonly projects: () => ProjectSessions;
+    readonly generator: string;
+    readonly script: () => string;
+    /** Each build's diagnostics and what was skipped, for the terminal. */
+    readonly report: (build: CatalogBuild, workspace: Workspace) => void;
+}
+export interface PreviewServer {
+    /** The address to open, with the route of the file's first diagram for a file. */
+    readonly url: string;
+    /** How many times the catalog was built. */
+    readonly builds: number;
+    /** Builds again and tells the open pages to reload. */
+    rebuild(changed?: readonly string[]): void;
+    close(): Promise<void>;
+}
+/**
+ * Serves the catalog of a project on the loopback interface and builds it again when its files
+ * change; open pages reload where they were (decision 0028). Only requests addressed to this
+ * machine's names are answered.
+ */
+export declare function startPreview(options: PreviewOptions): Promise<PreviewServer>;
+/**
+ * Opens a URL in the default browser, the way `login` does (`open-url.ts`): the address is one
+ * argument of the opener and no shell reads it, so a `&` or a quote in it means nothing (`cmd /c
+ * start` ended the command at the first `&`). The preview prints its address first, so an opener
+ * that cannot start is not an error here. `open` is replaceable for tests.
+ */
+export declare function openInBrowser(url: string, open?: (url: string) => Promise<void>): void;
+/** Prints the diagnostics of a build as the other commands do. */
+export declare function previewReport(print: (path: string, diagnostics: readonly Diagnostic[]) => void, stdout: (text: string) => void, display: (path: string) => string): (build: CatalogBuild) => void;
+/** What the preview command needs from the CLI. */
+export interface PreviewContext {
+    readonly name: string;
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+    readonly cwd: string;
+    readonly display: (path: string) => string;
+    readonly projects: () => ProjectSessions;
+    readonly generator: string;
+    readonly script: () => string;
+    readonly printDiagnostics: (path: string, diagnostics: readonly Diagnostic[]) => void;
+}
+/** `meltemi-diagrams preview`: runs until stopped; usage errors return 2 at once. */
+export declare function previewCommand(args: readonly string[], context: PreviewContext): number;
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAIpF,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACtE;AAED,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAoBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA2H5E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAW,GAAG,IAAI,CAM/F;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,KAAK,IAAI,EACjE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAc/B;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,KAAK,IAAI,CAAC;CACvF;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAgEvF"}