@paneljs/paneljs 0.2.0 → 0.2.1

package/dist/cli/init.js

@@ -0,0 +1,137 @@
+import { spawn } from "node:child_process";
+import { argument, hasFlag } from "./args.js";
+import { detectPackageManager, installArgs, peersFor, planInstall, readManifest, } from "./project.js";
+import { docsUrl, FRAMEWORKS, ORMS, paneljsPackages, parseFramework, parseOrm, resolveFramework, resolveOrm, setupSnippet, } from "./stack.js";
+export function parseInitArgs(argv) {
+    const unknown = argv.filter((item) => item.startsWith("-") &&
+        item !== "--framework" &&
+        item !== "--orm" &&
+        item !== "--pm" &&
+        item !== "--yes" &&
+        item !== "-y" &&
+        item !== "--dry-run" &&
+        item !== "--help" &&
+        item !== "-h" &&
+        !item.startsWith("--framework=") &&
+        !item.startsWith("--orm=") &&
+        !item.startsWith("--pm="));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown init flag: ${unknown[0]}`);
+    }
+    return {
+        framework: argument(argv, "--framework"),
+        orm: argument(argv, "--orm"),
+        pm: argument(argv, "--pm"),
+        yes: hasFlag(argv, "--yes") || hasFlag(argv, "-y"),
+        dryRun: hasFlag(argv, "--dry-run"),
+        help: hasFlag(argv, "--help") || hasFlag(argv, "-h"),
+    };
+}
+export const INIT_USAGE = `Usage:
+  paneljs init [--framework express] [--orm prisma|typeorm] [--pm npm|pnpm|yarn|bun] [--yes] [--dry-run]
+
+Adds PanelJS packages to the app in this directory. Does not rewrite source files.
+Fastify, Nest.js, and Drizzle are listed in the prompt but are not selectable yet.`;
+export function resolveInitPlan(cwd, flags, manifest, env, framework, orm) {
+    const frameworkChoice = resolveFramework(framework);
+    const ormChoice = resolveOrm(orm);
+    const packages = paneljsPackages(frameworkChoice.id, ormChoice.id);
+    const plan = planInstall(manifest, packages, peersFor(ormChoice.id));
+    if (plan.incompatible.length > 0) {
+        throw new Error(plan.incompatible.join("\n"));
+    }
+    const pm = detectPackageManager(cwd, manifest, env, flags.pm);
+    return { framework: frameworkChoice.id, orm: ormChoice.id, pm, plan, packages };
+}
+export async function runInit(input) {
+    const flags = parseInitArgs(input.argv);
+    if (flags.help === true) {
+        input.io.stdout.write(`${INIT_USAGE}\n`);
+        return;
+    }
+    const manifest = readManifest(input.cwd);
+    const framework = await pick("Which Node framework are you using?", flags.framework, FRAMEWORKS.map((item) => ({
+        value: item.id,
+        label: item.label,
+        disabled: !item.available,
+    })), flags, input.io, (value) => parseFramework(value));
+    const orm = await pick("Which ORM are you using?", flags.orm, ORMS.map((item) => ({
+        value: item.id,
+        label: item.label,
+        disabled: !item.available,
+    })), flags, input.io, (value) => parseOrm(value));
+    const resolved = resolveInitPlan(input.cwd, flags, manifest, input.io.env, framework, orm);
+    const { plan } = resolved;
+    const adding = [...plan.dependencies, ...plan.devDependencies];
+    input.io.stdout.write("\n");
+    if (adding.length === 0) {
+        input.io.stdout.write("PanelJS packages for this stack are already listed.\n");
+    }
+    else {
+        input.io.stdout.write(`Using ${resolved.pm}. Will add:\n`);
+        for (const name of plan.dependencies)
+            input.io.stdout.write(`  ${name}\n`);
+        for (const name of plan.devDependencies)
+            input.io.stdout.write(`  ${name} (dev)\n`);
+    }
+    if (plan.alreadyPresent.length > 0) {
+        input.io.stdout.write(`Already present: ${plan.alreadyPresent.join(", ")}\n`);
+    }
+    input.io.stdout.write("No source files will be changed.\n");
+    if (flags.dryRun === true) {
+        input.io.stdout.write("\nDry run. Nothing was installed.\n");
+        writeSnippet(input.io, resolved.framework, resolved.orm);
+        return;
+    }
+    if (adding.length > 0 && flags.yes !== true) {
+        if (!input.io.isTTY) {
+            throw new Error("Non-interactive install requires --yes.");
+        }
+        const ok = await input.io.confirm("Install these packages?");
+        if (!ok)
+            throw new Error("Init cancelled.");
+    }
+    if (adding.length > 0) {
+        await input.io.install(resolved.pm, input.cwd, plan.dependencies, plan.devDependencies);
+    }
+    input.io.stdout.write("\nInstalled. Wire this into your existing server:\n\n");
+    writeSnippet(input.io, resolved.framework, resolved.orm);
+}
+function writeSnippet(io, framework, orm) {
+    io.stdout.write(`${setupSnippet(framework, orm)}\n\n`);
+    io.stdout.write(`Docs: ${docsUrl(framework, orm)}\n`);
+    io.stdout.write("Auth: https://www.paneljs.com/docs/guide/auth\n");
+}
+async function pick(label, flagged, items, flags, io, parse) {
+    if (flagged)
+        return parse(flagged);
+    if (flags.yes === true || !io.isTTY) {
+        throw new Error(`${label} Pass the matching flag with --yes, or run in a terminal.`);
+    }
+    return parse(await io.select(label, items));
+}
+export function createDefaultInstall() {
+    return async (pm, cwd, dependencies, devDependencies) => {
+        if (dependencies.length > 0)
+            await runCommand(pm, installArgs(pm, dependencies, false), cwd);
+        if (devDependencies.length > 0)
+            await runCommand(pm, installArgs(pm, devDependencies, true), cwd);
+    };
+}
+function runCommand(command, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd,
+            stdio: "inherit",
+            shell: process.platform === "win32",
+        });
+        child.on("error", reject);
+        child.on("exit", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${command} ${args.join(" ")} exited with code ${code}.`));
+        });
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/project.d.ts

@@ -0,0 +1,31 @@
+import type { OrmId, PackageManager } from "./stack.js";
+export interface PackageManifest {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    packageManager?: string;
+}
+export interface PeerNeed {
+    name: string;
+    installAs: "dep" | "dev";
+    spec?: string;
+}
+export declare function readManifest(cwd: string): PackageManifest;
+export declare function declaredSpec(manifest: PackageManifest, name: string): string | undefined;
+export declare function detectPackageManager(cwd: string, manifest: PackageManifest, env: NodeJS.ProcessEnv, override?: string): PackageManager;
+export declare function packageManagerFromUserAgent(userAgent: string | undefined): PackageManager | undefined;
+export declare function peersFor(orm: OrmId): PeerNeed[];
+export declare function incompatiblePeer(name: string, spec: string): string | undefined;
+export declare function parseLeadingVersion(spec: string): {
+    major: number;
+    minor: number;
+    patch: number;
+} | undefined;
+export interface InstallPlan {
+    dependencies: string[];
+    devDependencies: string[];
+    alreadyPresent: string[];
+    incompatible: string[];
+}
+export declare function planInstall(manifest: PackageManifest, panelPackages: string[], peers: PeerNeed[]): InstallPlan;
+export declare function installArgs(pm: PackageManager, packages: string[], dev: boolean): string[];

package/dist/cli/project.js

@@ -0,0 +1,150 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const PRISMA_PEERS = [
+    { name: "express", installAs: "dep" },
+    { name: "@prisma/client", installAs: "dep", spec: "~7.5.0" },
+    { name: "prisma", installAs: "dev", spec: "~7.5.0" },
+];
+const TYPEORM_PEERS = [
+    { name: "express", installAs: "dep" },
+    { name: "typeorm", installAs: "dep", spec: "^0.3.20" },
+];
+export function readManifest(cwd) {
+    const path = join(cwd, "package.json");
+    if (!existsSync(path)) {
+        throw new Error("No package.json in this directory. Run paneljs init inside your app.");
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        throw new Error(`Could not parse ${path}.`);
+    }
+}
+export function declaredSpec(manifest, name) {
+    return (manifest.dependencies?.[name] ??
+        manifest.devDependencies?.[name] ??
+        manifest.optionalDependencies?.[name]);
+}
+export function detectPackageManager(cwd, manifest, env, override) {
+    if (override) {
+        const allowed = ["npm", "pnpm", "yarn", "bun"];
+        if (!allowed.includes(override)) {
+            throw new Error(`Unknown package manager "${override}". Use npm, pnpm, yarn, or bun.`);
+        }
+        return override;
+    }
+    const fromAgent = packageManagerFromUserAgent(env.npm_config_user_agent);
+    if (fromAgent)
+        return fromAgent;
+    const field = manifest.packageManager?.split("@")[0];
+    if (field === "npm" || field === "pnpm" || field === "yarn" || field === "bun") {
+        return field;
+    }
+    if (existsSync(join(cwd, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(cwd, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(cwd, "bun.lock")) || existsSync(join(cwd, "bun.lockb")))
+        return "bun";
+    if (existsSync(join(cwd, "package-lock.json")))
+        return "npm";
+    return "npm";
+}
+export function packageManagerFromUserAgent(userAgent) {
+    if (!userAgent)
+        return undefined;
+    const name = userAgent.split("/")[0];
+    if (name === "npm" || name === "pnpm" || name === "yarn" || name === "bun") {
+        return name;
+    }
+    return undefined;
+}
+export function peersFor(orm) {
+    if (orm === "prisma")
+        return PRISMA_PEERS;
+    if (orm === "typeorm")
+        return TYPEORM_PEERS;
+    return [{ name: "express", installAs: "dep" }];
+}
+export function incompatiblePeer(name, spec) {
+    if (spec.startsWith("workspace:") ||
+        spec.startsWith("catalog:") ||
+        spec === "*" ||
+        spec === "latest") {
+        return undefined;
+    }
+    const version = parseLeadingVersion(spec);
+    if (!version)
+        return undefined;
+    if (name === "prisma" || name === "@prisma/client") {
+        if (version.major !== 7 || version.minor !== 5) {
+            return `${name}@${spec} is not Prisma 7.5.x. @paneljs/prisma requires ~7.5.0.`;
+        }
+        return undefined;
+    }
+    if (name === "typeorm") {
+        if (version.major !== 0 ||
+            version.minor < 3 ||
+            (version.minor === 3 && version.patch < 20)) {
+            return `${name}@${spec} is below ^0.3.20.`;
+        }
+        return undefined;
+    }
+    if (name === "express") {
+        if (version.major < 4 || (version.major === 4 && version.minor < 18)) {
+            return `${name}@${spec} is below ^4.18 or ^5.`;
+        }
+        return undefined;
+    }
+    return undefined;
+}
+export function parseLeadingVersion(spec) {
+    const match = spec
+        .replace(/^[~^>=<\s]+/, "")
+        .match(/^(\d+)\.(\d+)(?:\.(\d+))?/);
+    if (!match)
+        return undefined;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3] ?? 0),
+    };
+}
+export function planInstall(manifest, panelPackages, peers) {
+    const incompatible = [];
+    const alreadyPresent = [];
+    const dependencies = [];
+    const devDependencies = [];
+    const consider = (name, installAs, spec) => {
+        const declared = declaredSpec(manifest, name);
+        if (declared) {
+            const problem = incompatiblePeer(name, declared);
+            if (problem)
+                incompatible.push(problem);
+            else
+                alreadyPresent.push(name);
+            return;
+        }
+        const token = spec ? `${name}@${spec}` : name;
+        if (installAs === "dev")
+            devDependencies.push(token);
+        else
+            dependencies.push(token);
+    };
+    for (const name of panelPackages)
+        consider(name, "dep");
+    for (const peer of peers)
+        consider(peer.name, peer.installAs, peer.spec);
+    return { dependencies, devDependencies, alreadyPresent, incompatible };
+}
+export function installArgs(pm, packages, dev) {
+    if (packages.length === 0)
+        return [];
+    if (pm === "npm")
+        return ["install", ...(dev ? ["-D"] : []), ...packages];
+    if (pm === "bun")
+        return ["add", ...(dev ? ["-d"] : []), ...packages];
+    return ["add", ...(dev ? ["-D"] : []), ...packages];
+}
+//# sourceMappingURL=project.js.map

package/dist/cli/project.js.map

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

package/dist/cli/prompt.d.ts

@@ -0,0 +1,10 @@
+export interface SelectItem {
+    value: string;
+    label: string;
+    disabled?: boolean;
+    hint?: string;
+}
+export declare function question(label: string): Promise<string>;
+export declare function confirm(label: string, defaultYes?: boolean): Promise<boolean>;
+export declare function hiddenQuestion(label: string): Promise<string>;
+export declare function select(label: string, items: SelectItem[]): Promise<string>;

package/dist/cli/prompt.js

@@ -0,0 +1,129 @@
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+export async function question(label) {
+    const terminal = createInterface({ input: stdin, output: stdout });
+    try {
+        return (await terminal.question(label)).trim();
+    }
+    finally {
+        terminal.close();
+    }
+}
+export async function confirm(label, defaultYes = true) {
+    const suffix = defaultYes ? " [Y/n]: " : " [y/N]: ";
+    const answer = (await question(`${label}${suffix}`)).toLowerCase();
+    if (!answer)
+        return defaultYes;
+    return answer === "y" || answer === "yes";
+}
+export async function hiddenQuestion(label) {
+    if (!stdin.isTTY)
+        throw new Error("Password input requires a terminal. Pass --password or set EXPRESS_ADMIN_PASSWORD for non-interactive use.");
+    stdout.write(label);
+    return new Promise((resolveQuestion, rejectQuestion) => {
+        let value = "";
+        const restore = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.off("data", onData);
+        };
+        const onData = (chunk) => {
+            for (const character of chunk.toString("utf8")) {
+                if (character === "\r" || character === "\n") {
+                    restore();
+                    stdout.write("\n");
+                    resolveQuestion(value);
+                    return;
+                }
+                if (character === "\u0003") {
+                    restore();
+                    rejectQuestion(new Error("Cancelled."));
+                    return;
+                }
+                if (character === "\b" || character === "\u007f") {
+                    if (value) {
+                        value = value.slice(0, -1);
+                        stdout.write("\b \b");
+                    }
+                    continue;
+                }
+                value += character;
+                stdout.write("•");
+            }
+        };
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.on("data", onData);
+    });
+}
+const dim = (text) => `\x1b[2m${text}\x1b[0m`;
+export async function select(label, items) {
+    const enabled = items
+        .map((item, index) => ({ item, index }))
+        .filter(({ item }) => !item.disabled);
+    if (enabled.length === 0)
+        throw new Error(`No available options for ${label}`);
+    if (!stdin.isTTY || typeof stdin.setRawMode !== "function") {
+        throw new Error(`${label} requires a terminal, or pass the matching flag (--framework / --orm).`);
+    }
+    let current = enabled[0].index;
+    const render = (first) => {
+        if (!first)
+            stdout.write(`\x1b[${items.length}A`);
+        for (const [index, item] of items.entries()) {
+            const cursor = index === current ? "❯ " : "  ";
+            const hint = item.disabled
+                ? dim(" (coming soon)")
+                : item.hint
+                    ? dim(` ${item.hint}`)
+                    : "";
+            const line = `${cursor}${item.label}${hint}`;
+            const painted = item.disabled ? dim(line) : line;
+            stdout.write(`\x1b[2K${painted}\n`);
+        }
+    };
+    stdout.write(`${label}\n`);
+    stdout.write("\x1b[?25l");
+    render(true);
+    return new Promise((resolveSelect, rejectSelect) => {
+        const restore = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.off("data", onData);
+            stdout.write("\x1b[?25h");
+        };
+        const move = (direction) => {
+            const position = enabled.findIndex(({ index }) => index === current);
+            const next = enabled[(position + direction + enabled.length) % enabled.length];
+            current = next.index;
+            render(false);
+        };
+        const onData = (chunk) => {
+            const text = chunk.toString("utf8");
+            if (text === "\u0003") {
+                restore();
+                stdout.write("\n");
+                rejectSelect(new Error("Cancelled."));
+                return;
+            }
+            if (text === "\r" || text === "\n") {
+                restore();
+                stdout.write(`\x1b[${items.length}A`);
+                for (const [index, item] of items.entries()) {
+                    const mark = index === current ? "❯ " : "  ";
+                    stdout.write(`\x1b[2K${mark}${item.label}\n`);
+                }
+                resolveSelect(items[current].value);
+                return;
+            }
+            if (text === "\u001b[A" || text === "k")
+                move(-1);
+            if (text === "\u001b[B" || text === "j")
+                move(1);
+        };
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.on("data", onData);
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/cli/prompt.js.map

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

package/dist/cli/stack.d.ts

@@ -0,0 +1,18 @@
+export type FrameworkId = "express" | "fastify" | "nestjs";
+export type OrmId = "prisma" | "typeorm" | "drizzle";
+export type PackageManager = "npm" | "pnpm" | "yarn" | "bun";
+export interface StackChoice<Id extends string> {
+    id: Id;
+    label: string;
+    available: boolean;
+}
+export declare const FRAMEWORKS: StackChoice<FrameworkId>[];
+export declare const ORMS: StackChoice<OrmId>[];
+export declare function parseFramework(value: string): FrameworkId;
+export declare function parseOrm(value: string): OrmId;
+export declare function assertAvailable(kind: "framework" | "ORM", choice: StackChoice<string>): void;
+export declare function resolveFramework(id: FrameworkId): StackChoice<FrameworkId>;
+export declare function resolveOrm(id: OrmId): StackChoice<OrmId>;
+export declare function paneljsPackages(framework: FrameworkId, orm: OrmId): string[];
+export declare function docsUrl(framework: FrameworkId, orm: OrmId): string;
+export declare function setupSnippet(framework: FrameworkId, orm: OrmId): string;

package/dist/cli/stack.js

@@ -0,0 +1,129 @@
+export const FRAMEWORKS = [
+    { id: "express", label: "Express", available: true },
+    { id: "fastify", label: "Fastify", available: false },
+    { id: "nestjs", label: "Nest.js", available: false },
+];
+export const ORMS = [
+    { id: "prisma", label: "Prisma", available: true },
+    { id: "typeorm", label: "TypeORM", available: true },
+    { id: "drizzle", label: "Drizzle", available: false },
+];
+const FRAMEWORK_ALIASES = {
+    express: "express",
+    fastify: "fastify",
+    nest: "nestjs",
+    nestjs: "nestjs",
+    "nest.js": "nestjs",
+};
+const ORM_ALIASES = {
+    prisma: "prisma",
+    typeorm: "typeorm",
+    drizzle: "drizzle",
+};
+export function parseFramework(value) {
+    const id = FRAMEWORK_ALIASES[value.trim().toLowerCase()];
+    if (!id) {
+        throw new Error(`Unknown framework "${value}". Use express (fastify and nest.js are coming soon).`);
+    }
+    return id;
+}
+export function parseOrm(value) {
+    const id = ORM_ALIASES[value.trim().toLowerCase()];
+    if (!id) {
+        throw new Error(`Unknown ORM "${value}". Use prisma or typeorm (drizzle is coming soon).`);
+    }
+    return id;
+}
+export function assertAvailable(kind, choice) {
+    if (choice.available)
+        return;
+    const instead = kind === "framework"
+        ? "Express is the HTTP adapter that ships today."
+        : "Prisma and TypeORM are the data adapters that ship today.";
+    throw new Error(`${choice.label} is coming soon. ${instead}`);
+}
+export function resolveFramework(id) {
+    const choice = FRAMEWORKS.find((item) => item.id === id);
+    if (!choice)
+        throw new Error(`Unknown framework "${id}".`);
+    assertAvailable("framework", choice);
+    return choice;
+}
+export function resolveOrm(id) {
+    const choice = ORMS.find((item) => item.id === id);
+    if (!choice)
+        throw new Error(`Unknown ORM "${id}".`);
+    assertAvailable("ORM", choice);
+    return choice;
+}
+export function paneljsPackages(framework, orm) {
+    resolveFramework(framework);
+    resolveOrm(orm);
+    const http = framework === "express" ? "@paneljs/express" : `@paneljs/${framework}`;
+    const data = orm === "prisma" ? "@paneljs/prisma" : `@paneljs/${orm}`;
+    return ["paneljs", http, data];
+}
+export function docsUrl(framework, orm) {
+    return `https://www.paneljs.com/docs/guide/installation/${framework}/${orm}`;
+}
+export function setupSnippet(framework, orm) {
+    resolveFramework(framework);
+    resolveOrm(orm);
+    if (orm === "prisma") {
+        return `import express from "express";
+import { createAdmin } from "paneljs";
+import { prismaAdapter } from "@paneljs/prisma";
+import { mount } from "@paneljs/express";
+import { prisma } from "./prisma.js";
+
+const app = express();
+
+const admin = createAdmin({
+  adapter: prismaAdapter({ prisma }),
+  auth: {
+    getCurrentUser: async (req) => {
+      const user = await getOperatorFromYourAuth(req);
+      if (!user) return null;
+      return {
+        id: user.id,
+        email: user.email,
+        role: user.role,
+        isSuperAdmin: user.role === "SUPER_ADMIN",
+      };
+    },
+  },
+});
+
+admin.register("User");
+await mount(app, admin);`;
+    }
+    return `import express from "express";
+import { createAdmin } from "paneljs";
+import { typeormAdapter } from "@paneljs/typeorm";
+import { mount } from "@paneljs/express";
+import { dataSource } from "./data-source.js";
+
+await dataSource.initialize();
+
+const app = express();
+
+const admin = createAdmin({
+  adapter: typeormAdapter({ dataSource }),
+  auth: {
+    getCurrentUser: async (req) => {
+      const user = await getOperatorFromYourAuth(req);
+      if (!user) return null;
+      return {
+        id: user.id,
+        email: user.email,
+        role: user.role,
+        isSuperAdmin: user.role === "SUPER_ADMIN",
+      };
+    },
+  },
+});
+
+admin.register("User");
+await mount(app, admin);`;
+}
+//# sourceMappingURL=stack.js.map

package/dist/cli/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../src/cli/stack.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;IACpD,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE;IACrD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE;CACrD,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAyB;IACxC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;IAClD,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;IACpD,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE;CACtD,CAAC;AAEF,MAAM,iBAAiB,GAAgC;IACrD,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,QAAQ;CACpB,CAAC;AAEF,MAAM,WAAW,GAA0B;IACzC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,EAAE,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,uDAAuD,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,gBAAgB,KAAK,oDAAoD,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAyB,EACzB,MAA2B;IAE3B,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO;IAC7B,MAAM,OAAO,GACX,IAAI,KAAK,WAAW;QAClB,CAAC,CAAC,+CAA+C;QACjD,CAAC,CAAC,2DAA2D,CAAC;IAClE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,oBAAoB,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAe;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC3D,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAS;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;IACrD,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAsB,EAAE,GAAU;IAChE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5B,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,MAAM,IAAI,GACR,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,SAAS,EAAE,CAAC;IACzE,MAAM,IAAI,GAAG,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,GAAG,EAAE,CAAC;IACtE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,SAAsB,EAAE,GAAU;IACxD,OAAO,mDAAmD,SAAS,IAAI,GAAG,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAsB,EAAE,GAAU;IAC7D,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5B,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;yBAyBc,CAAC;IACxB,CAAC;IAED,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA2BgB,CAAC;AAC1B,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};