@gtkx/cli 1.0.0-rc.4 → 1.1.0

package/dist/commands/deploy.d.ts

@@ -0,0 +1,22 @@
+declare const deploy: import("citty").CommandDef<{
+    readonly target: {
+        readonly type: "string";
+        readonly description: `Comma-separated package formats to build (${string})`;
+    };
+    readonly out: {
+        readonly type: "string";
+        readonly description: "Output directory relative to the project root (default: build)";
+    };
+    readonly "print-manifests": {
+        readonly type: "boolean";
+        readonly description: "Write the generated manifests and metadata, then stop without packaging";
+    };
+    readonly "skip-build": {
+        readonly type: "boolean";
+        readonly description: "Package what is already in dist/ instead of rebuilding";
+    };
+    readonly entry: import("citty").PositionalArgDef;
+    readonly cwd: import("citty").StringArgDef;
+}>;
+export { deploy };
+//# sourceMappingURL=deploy.d.ts.map

package/dist/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;EAoCV,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/commands/deploy.js

@@ -0,0 +1,44 @@
+import { defineCommand } from "citty";
+import { KNOWN_NAMES } from "../deploy/registry.js";
+import { runDeploy } from "../deploy/run-deploy.js";
+import { entryArg } from "../internal/entry-arg.js";
+import { resolveProject } from "../internal/prepare-project.js";
+const DEPLOY_MODE = "production";
+const deploy = defineCommand({
+    meta: {
+        name: "deploy",
+        description: "Package the application for distribution",
+    },
+    args: {
+        ...entryArg,
+        target: {
+            type: "string",
+            description: `Comma-separated package formats to build (${KNOWN_NAMES})`,
+        },
+        out: {
+            type: "string",
+            description: "Output directory relative to the project root (default: build)",
+        },
+        "print-manifests": {
+            type: "boolean",
+            description: "Write the generated manifests and metadata, then stop without packaging",
+        },
+        "skip-build": {
+            type: "boolean",
+            description: "Package what is already in dist/ instead of rebuilding",
+        },
+    },
+    async run({ args }) {
+        const { cwd, entry } = await resolveProject(args, DEPLOY_MODE);
+        await runDeploy({
+            entry,
+            cwd,
+            targets: args.target,
+            outDir: args.out,
+            shouldPrintManifests: args["print-manifests"] === true,
+            shouldSkipBuild: args["skip-build"] === true,
+        });
+    },
+});
+export { deploy };
+//# sourceMappingURL=deploy.js.map

package/dist/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,WAAW,GAAG,YAAY,CAAC;AAEjC,MAAM,MAAM,GAAG,aAAa,CAAC;IACzB,IAAI,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0CAA0C;KAC1D;IACD,IAAI,EAAE;QACF,GAAG,QAAQ;QACX,MAAM,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6CAA6C,WAAW,GAAG;SAC3E;QACD,GAAG,EAAE;YACD,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gEAAgE;SAChF;QACD,iBAAiB,EAAE;YACf,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yEAAyE;SACzF;QACD,YAAY,EAAE;YACV,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,wDAAwD;SACxE;KACJ;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QACd,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAE/D,MAAM,SAAS,CAAC;YACZ,KAAK;YACL,GAAG;YACH,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,MAAM,EAAE,IAAI,CAAC,GAAG;YAChB,oBAAoB,EAAE,IAAI,CAAC,iBAAiB,CAAC,KAAK,IAAI;YACtD,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI;SAC/C,CAAC,CAAC;IACP,CAAC;CACJ,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC","sourcesContent":["import { defineCommand } from \"citty\";\nimport { KNOWN_NAMES } from \"../deploy/registry.js\";\nimport { runDeploy } from \"../deploy/run-deploy.js\";\nimport { entryArg } from \"../internal/entry-arg.js\";\nimport { resolveProject } from \"../internal/prepare-project.js\";\n\nconst DEPLOY_MODE = \"production\";\n\nconst deploy = defineCommand({\n    meta: {\n        name: \"deploy\",\n        description: \"Package the application for distribution\",\n    },\n    args: {\n        ...entryArg,\n        target: {\n            type: \"string\",\n            description: `Comma-separated package formats to build (${KNOWN_NAMES})`,\n        },\n        out: {\n            type: \"string\",\n            description: \"Output directory relative to the project root (default: build)\",\n        },\n        \"print-manifests\": {\n            type: \"boolean\",\n            description: \"Write the generated manifests and metadata, then stop without packaging\",\n        },\n        \"skip-build\": {\n            type: \"boolean\",\n            description: \"Package what is already in dist/ instead of rebuilding\",\n        },\n    },\n    async run({ args }) {\n        const { cwd, entry } = await resolveProject(args, DEPLOY_MODE);\n\n        await runDeploy({\n            entry,\n            cwd,\n            targets: args.target,\n            outDir: args.out,\n            shouldPrintManifests: args[\"print-manifests\"] === true,\n            shouldSkipBuild: args[\"skip-build\"] === true,\n        });\n    },\n});\n\nexport { deploy };\n"]}

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,GAAG;;;EAcP,CAAC;AAEH,OAAO,EAAE,GAAG,EAAE,CAAC"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AASA,QAAA,MAAM,GAAG;;;EAcP,CAAC;AAEH,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/commands/dev.js

@@ -1,7 +1,9 @@
 import { defineCommand } from "citty";
-import { ensureGenerated, resolveConfigWatch } from "../codegen/run-codegen.js";
+import { resolveConfigWatch } from "../codegen/run-codegen.js";
 import { runDevSupervisor } from "../dev/supervisor.js";
-import { entryArg, resolveEntry } from "../internal/entry-arg.js";
+import { splitApplicationArgs } from "../internal/application-args.js";
+import { entryArg } from "../internal/entry-arg.js";
+import { prepareProject } from "../internal/prepare-project.js";
 const DEV_MODE = "development";
 const dev = defineCommand({
     meta: {
@@ -12,10 +14,10 @@ const dev = defineCommand({
         ...entryArg,
     },
     async run({ args }) {
-        const { cwd, entry: entryPath } = resolveEntry(args);
-        await ensureGenerated(cwd, { shouldAnnounce: true, mode: DEV_MODE });
+        const { cwd, entry: entryPath } = await prepareProject(args, DEV_MODE);
         const watch = await resolveConfigWatch(cwd, DEV_MODE);
-        await runDevSupervisor(entryPath, cwd, watch);
+        const { applicationArgs } = splitApplicationArgs(process.argv.slice(2));
+        await runDevSupervisor({ entryPath, cwd, args: applicationArgs, watch });
     },
 });
 export { dev };

package/dist/commands/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAiB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,QAAQ,GAAG,aAAa,CAAC;AAE/B,MAAM,GAAG,GAAG,aAAa,CAAC;IACtB,IAAI,EAAE;QACF,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,mCAAmC;KACnD;IACD,IAAI,EAAE;QACF,GAAG,QAAQ;KACd;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QACd,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,eAAe,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,MAAM,KAAK,GAAyB,MAAM,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5E,MAAM,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;CACJ,CAAC,CAAC;AAEH,OAAO,EAAE,GAAG,EAAE,CAAC","sourcesContent":["import { defineCommand } from \"citty\";\nimport { ensureGenerated, resolveConfigWatch } from \"../codegen/run-codegen.js\";\nimport { type DevWatch, runDevSupervisor } from \"../dev/supervisor.js\";\nimport { entryArg, resolveEntry } from \"../internal/entry-arg.js\";\n\nconst DEV_MODE = \"development\";\n\nconst dev = defineCommand({\n    meta: {\n        name: \"dev\",\n        description: \"Start development server with HMR\",\n    },\n    args: {\n        ...entryArg,\n    },\n    async run({ args }) {\n        const { cwd, entry: entryPath } = resolveEntry(args);\n        await ensureGenerated(cwd, { shouldAnnounce: true, mode: DEV_MODE });\n        const watch: DevWatch | undefined = await resolveConfigWatch(cwd, DEV_MODE);\n        await runDevSupervisor(entryPath, cwd, watch);\n    },\n});\n\nexport { dev };\n"]}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAiB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,QAAQ,GAAG,aAAa,CAAC;AAE/B,MAAM,GAAG,GAAG,aAAa,CAAC;IACtB,IAAI,EAAE;QACF,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,mCAAmC;KACnD;IACD,IAAI,EAAE;QACF,GAAG,QAAQ;KACd;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QACd,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACvE,MAAM,KAAK,GAAyB,MAAM,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5E,MAAM,EAAE,eAAe,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;CACJ,CAAC,CAAC;AAEH,OAAO,EAAE,GAAG,EAAE,CAAC","sourcesContent":["import { defineCommand } from \"citty\";\nimport { resolveConfigWatch } from \"../codegen/run-codegen.js\";\nimport { type DevWatch, runDevSupervisor } from \"../dev/supervisor.js\";\nimport { splitApplicationArgs } from \"../internal/application-args.js\";\nimport { entryArg } from \"../internal/entry-arg.js\";\nimport { prepareProject } from \"../internal/prepare-project.js\";\n\nconst DEV_MODE = \"development\";\n\nconst dev = defineCommand({\n    meta: {\n        name: \"dev\",\n        description: \"Start development server with HMR\",\n    },\n    args: {\n        ...entryArg,\n    },\n    async run({ args }) {\n        const { cwd, entry: entryPath } = await prepareProject(args, DEV_MODE);\n        const watch: DevWatch | undefined = await resolveConfigWatch(cwd, DEV_MODE);\n        const { applicationArgs } = splitApplicationArgs(process.argv.slice(2));\n        await runDevSupervisor({ entryPath, cwd, args: applicationArgs, watch });\n    },\n});\n\nexport { dev };\n"]}

package/dist/commands/docs.d.ts

@@ -2,7 +2,7 @@ declare const docs: import("citty").CommandDef<{
     readonly cwd: import("citty").StringArgDef;
     readonly out: {
         readonly type: "string";
-        readonly description: "Output directory for the generated markdown pages, relative to the project root";
+        readonly description: string;
         readonly default: "docs/reference";
     };
     readonly "base-path": {
@@ -12,7 +12,7 @@ declare const docs: import("citty").CommandDef<{
     };
     readonly force: {
         readonly type: "boolean";
-        readonly description: "Regenerate even when the pages are up to date with the GIR libraries";
+        readonly description: string;
         readonly default: false;
     };
 }>;

package/dist/commands/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAkBA,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;EAyER,CAAC;AAcH,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAkBA,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;EA6ER,CAAC;AA6CH,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/commands/docs.js

@@ -5,7 +5,7 @@ import { resolveOmittedProps } from "@gtkx/config/internal";
 import { info } from "@gtkx/utils";
 import { defineCommand } from "citty";
 import { existsSync } from "node:fs";
-import { resolve } from "node:path";
+import { isAbsolute, relative, resolve, sep } from "node:path";
 import { cwdArg, resolveCwd } from "../internal/entry-arg.js";
 const docs = defineCommand({
     meta: {
@@ -15,7 +15,8 @@ const docs = defineCommand({
     args: {
         out: {
             type: "string",
-            description: "Output directory for the generated markdown pages, relative to the project root",
+            description: "Output directory for the generated markdown pages, below the project root. It must be empty " +
+                "or hold an earlier `gtkx docs` run, whose pages are replaced",
             default: "docs/reference",
         },
         "base-path": {
@@ -25,7 +26,8 @@ const docs = defineCommand({
         },
         force: {
             type: "boolean",
-            description: "Regenerate even when the pages are up to date with the GIR libraries",
+            description: "Regenerate even when the pages are up to date with the GIR libraries, the base path, " +
+                "and the element props the project configures",
             default: false,
         },
         ...cwdArg,
@@ -45,7 +47,7 @@ const docs = defineCommand({
         }
         const libraries = resolveLibraries(config.libraries, girPath);
         const startedAt = Date.now();
-        const outDir = resolve(cwd, args.out);
+        const outDir = resolveOutDir(cwd, args.out);
         const builtin = await resolveDocsElements(cwd);
         const { isRegenerated, namespaces } = writeDocs({
             libraries,
@@ -65,6 +67,27 @@ const docs = defineCommand({
             `to ${outDir} in ${String(Date.now() - startedAt)}ms`);
     },
 });
+const isBelow = (parent, child) => {
+    const path = relative(parent, child);
+    return path !== "" && path !== ".." && !path.startsWith(`..${sep}`) && !isAbsolute(path);
+};
+const outDirReason = (cwd, out, outDir) => {
+    if (out.trim() === "") {
+        return "it was empty, which names the project root itself";
+    }
+    if (outDir === cwd) {
+        return "it names the project root itself";
+    }
+    return `${outDir} is outside it`;
+};
+const resolveOutDir = (cwd, out) => {
+    const outDir = out.trim() === "" ? cwd : resolve(cwd, out);
+    if (isBelow(cwd, outDir)) {
+        return outDir;
+    }
+    throw new Error(`--out must name a directory below the project root ${cwd}, and ${outDirReason(cwd, out, outDir)}. ` +
+        "Pass a path such as --out=docs/reference.");
+};
 const resolveDocsElements = async (cwd) => {
     const { gi, reactSubexports } = resolveStore(cwd);
     if (!existsSync(gi.storeDir)) {

package/dist/commands/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    type ElementProps,\n    mergeOmittedProps,\n    type OmittedProps,\n    readBuiltinElements,\n    resolveGirPath,\n    resolveLibraries,\n    resolveStore,\n} from \"@gtkx/codegen\";\nimport { writeDocs } from \"@gtkx/codegen/internal\";\nimport { loadConfig } from \"@gtkx/config\";\nimport { resolveOmittedProps } from \"@gtkx/config/internal\";\nimport { info } from \"@gtkx/utils\";\nimport { defineCommand } from \"citty\";\nimport { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { cwdArg, resolveCwd } from \"../internal/entry-arg.js\";\n\nconst docs = defineCommand({\n    meta: {\n        name: \"docs\",\n        description:\n            \"Generate markdown reference pages for the JSX elements of the GIR libraries declared in gtkx.config.ts\",\n    },\n    args: {\n        out: {\n            type: \"string\",\n            description: \"Output directory for the generated markdown pages, relative to the project root\",\n            default: \"docs/reference\",\n        },\n        \"base-path\": {\n            type: \"string\",\n            description: \"URL base path used for links between generated pages\",\n            default: \"/reference\",\n        },\n        force: {\n            type: \"boolean\",\n            description: \"Regenerate even when the pages are up to date with the GIR libraries\",\n            default: false,\n        },\n        ...cwdArg,\n    },\n    async run({ args }) {\n        const cwd = resolveCwd(args);\n        const { config } = await loadConfig(cwd);\n\n        if (config.codegen === false) {\n            throw new Error(\n                \"codegen is disabled for this project, so there are no GIR libraries to document. \" +\n                \"Remove `codegen: false` from gtkx.config.ts to use `gtkx docs`.\",\n            );\n        }\n\n        const girPath = resolveGirPath(config.girPath);\n\n        if (girPath.length === 0) {\n            throw new Error(\n                \"No GIR search paths available. Install gobject-introspection \" +\n                \"(Linux: `sudo dnf install gobject-introspection-devel` or \" +\n                \"`sudo apt install libgirepository1.0-dev`), or set `girPath` in gtkx.config.ts.\",\n            );\n        }\n\n        const libraries = resolveLibraries(config.libraries, girPath);\n        const startedAt = Date.now();\n        const outDir = resolve(cwd, args.out);\n        const builtin = await resolveDocsElements(cwd);\n\n        const { isRegenerated, namespaces } = writeDocs({\n            libraries,\n            girPath,\n            outDir,\n            basePath: args[\"base-path\"],\n            props: builtin.props,\n            omittedProps: mergeOmittedProps(builtin.omittedProps, resolveOmittedProps(config.elements)),\n            isForced: args.force,\n        });\n\n        if (!isRegenerated) {\n            info(`docs: pages in ${outDir} are up to date`);\n\n            return;\n        }\n\n        const count = namespaces.reduce((total, namespace) => total + namespace.elements.length, 0);\n\n        info(\n            `docs: wrote ${String(count)} element pages across ${String(namespaces.length)} namespaces ` +\n            `to ${outDir} in ${String(Date.now() - startedAt)}ms`,\n        );\n    },\n});\n\nconst resolveDocsElements = async (cwd: string): Promise<{ props: ElementProps; omittedProps: OmittedProps }> => {\n    const { gi, reactSubexports } = resolveStore(cwd);\n\n    if (!existsSync(gi.storeDir)) {\n        return { props: {}, omittedProps: {} };\n    }\n\n    const { props, omittedProps } = await readBuiltinElements(reactSubexports, gi.storeDir);\n\n    return { props, omittedProps };\n};\n\nexport { docs };\n"]}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    type ElementProps,\n    mergeOmittedProps,\n    type OmittedProps,\n    readBuiltinElements,\n    resolveGirPath,\n    resolveLibraries,\n    resolveStore,\n} from \"@gtkx/codegen\";\nimport { writeDocs } from \"@gtkx/codegen/internal\";\nimport { loadConfig } from \"@gtkx/config\";\nimport { resolveOmittedProps } from \"@gtkx/config/internal\";\nimport { info } from \"@gtkx/utils\";\nimport { defineCommand } from \"citty\";\nimport { existsSync } from \"node:fs\";\nimport { isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { cwdArg, resolveCwd } from \"../internal/entry-arg.js\";\n\nconst docs = defineCommand({\n    meta: {\n        name: \"docs\",\n        description:\n            \"Generate markdown reference pages for the JSX elements of the GIR libraries declared in gtkx.config.ts\",\n    },\n    args: {\n        out: {\n            type: \"string\",\n            description:\n                \"Output directory for the generated markdown pages, below the project root. It must be empty \" +\n                \"or hold an earlier `gtkx docs` run, whose pages are replaced\",\n            default: \"docs/reference\",\n        },\n        \"base-path\": {\n            type: \"string\",\n            description: \"URL base path used for links between generated pages\",\n            default: \"/reference\",\n        },\n        force: {\n            type: \"boolean\",\n            description:\n                \"Regenerate even when the pages are up to date with the GIR libraries, the base path, \" +\n                \"and the element props the project configures\",\n            default: false,\n        },\n        ...cwdArg,\n    },\n    async run({ args }) {\n        const cwd = resolveCwd(args);\n        const { config } = await loadConfig(cwd);\n\n        if (config.codegen === false) {\n            throw new Error(\n                \"codegen is disabled for this project, so there are no GIR libraries to document. \" +\n                \"Remove `codegen: false` from gtkx.config.ts to use `gtkx docs`.\",\n            );\n        }\n\n        const girPath = resolveGirPath(config.girPath);\n\n        if (girPath.length === 0) {\n            throw new Error(\n                \"No GIR search paths available. Install gobject-introspection \" +\n                \"(Linux: `sudo dnf install gobject-introspection-devel` or \" +\n                \"`sudo apt install libgirepository1.0-dev`), or set `girPath` in gtkx.config.ts.\",\n            );\n        }\n\n        const libraries = resolveLibraries(config.libraries, girPath);\n        const startedAt = Date.now();\n        const outDir = resolveOutDir(cwd, args.out);\n        const builtin = await resolveDocsElements(cwd);\n\n        const { isRegenerated, namespaces } = writeDocs({\n            libraries,\n            girPath,\n            outDir,\n            basePath: args[\"base-path\"],\n            props: builtin.props,\n            omittedProps: mergeOmittedProps(builtin.omittedProps, resolveOmittedProps(config.elements)),\n            isForced: args.force,\n        });\n\n        if (!isRegenerated) {\n            info(`docs: pages in ${outDir} are up to date`);\n\n            return;\n        }\n\n        const count = namespaces.reduce((total, namespace) => total + namespace.elements.length, 0);\n\n        info(\n            `docs: wrote ${String(count)} element pages across ${String(namespaces.length)} namespaces ` +\n            `to ${outDir} in ${String(Date.now() - startedAt)}ms`,\n        );\n    },\n});\n\nconst isBelow = (parent: string, child: string): boolean => {\n    const path = relative(parent, child);\n\n    return path !== \"\" && path !== \"..\" && !path.startsWith(`..${sep}`) && !isAbsolute(path);\n};\n\nconst outDirReason = (cwd: string, out: string, outDir: string): string => {\n    if (out.trim() === \"\") {\n        return \"it was empty, which names the project root itself\";\n    }\n\n    if (outDir === cwd) {\n        return \"it names the project root itself\";\n    }\n\n    return `${outDir} is outside it`;\n};\n\nconst resolveOutDir = (cwd: string, out: string): string => {\n    const outDir = out.trim() === \"\" ? cwd : resolve(cwd, out);\n\n    if (isBelow(cwd, outDir)) {\n        return outDir;\n    }\n\n    throw new Error(\n        `--out must name a directory below the project root ${cwd}, and ${outDirReason(cwd, out, outDir)}. ` +\n        \"Pass a path such as --out=docs/reference.\",\n    );\n};\n\nconst resolveDocsElements = async (cwd: string): Promise<{ props: ElementProps; omittedProps: OmittedProps }> => {\n    const { gi, reactSubexports } = resolveStore(cwd);\n\n    if (!existsSync(gi.storeDir)) {\n        return { props: {}, omittedProps: {} };\n    }\n\n    const { props, omittedProps } = await readBuiltinElements(reactSubexports, gi.storeDir);\n\n    return { props, omittedProps };\n};\n\nexport { docs };\n"]}

package/dist/deploy/depends.d.ts

@@ -0,0 +1,8 @@
+import type { DeployConfig } from "./types.js";
+type Relations = {
+    deb: string[];
+    rpm: string[];
+};
+declare const resolveDepends: (deploy: DeployConfig, libraries: string[], glibcFloor: string | null) => Relations;
+export { resolveDepends };
+//# sourceMappingURL=depends.d.ts.map

package/dist/deploy/depends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depends.d.ts","sourceRoot":"","sources":["../../src/deploy/depends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,SAAS,GAAG;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,GAAG,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AA0BF,QAAA,MAAM,cAAc,GAAI,QAAQ,YAAY,EAAE,WAAW,MAAM,EAAE,EAAE,YAAY,MAAM,GAAG,IAAI,KAAG,SAQ9F,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/deploy/depends.js

@@ -0,0 +1,27 @@
+const GLES_SONAME = "libGLESv2.so.2()(64bit)";
+const BASE_DEPENDS = {
+    deb: ["hicolor-icon-theme", "adwaita-icon-theme", "gsettings-desktop-schemas"],
+    rpm: ["hicolor-icon-theme", "adwaita-icon-theme", "gsettings-desktop-schemas"],
+};
+const DEPENDS_BY_LIBRARY = {
+    "Adw-1": { deb: ["libadwaita-1-0"], rpm: ["libadwaita"] },
+    "Gtk-4.0": { deb: ["libgtk-4-1"], rpm: ["gtk4", GLES_SONAME] },
+    "GtkSource-5": { deb: ["libgtksourceview-5-0"], rpm: ["gtksourceview5"] },
+    "WebKit-6.0": { deb: ["libwebkitgtk-6.0-4"], rpm: ["webkitgtk6.0"] },
+};
+const libraryDepends = (libraries) => ({
+    deb: libraries.flatMap((library) => DEPENDS_BY_LIBRARY[library]?.deb ?? []),
+    rpm: libraries.flatMap((library) => DEPENDS_BY_LIBRARY[library]?.rpm ?? []),
+});
+const glibcDepends = (glibcFloor) => glibcFloor === null ? { deb: [], rpm: [] } : { deb: [`libc6 (>= ${glibcFloor})`], rpm: [`glibc >= ${glibcFloor}`] };
+const dedupe = (entries) => [...new Set(entries)];
+const resolveDepends = (deploy, libraries, glibcFloor) => {
+    const fromLibraries = libraryDepends(libraries);
+    const fromGlibc = glibcDepends(glibcFloor);
+    return {
+        deb: dedupe([...fromLibraries.deb, ...BASE_DEPENDS.deb, ...fromGlibc.deb, ...(deploy.depends?.deb ?? [])]),
+        rpm: dedupe([...fromLibraries.rpm, ...BASE_DEPENDS.rpm, ...fromGlibc.rpm, ...(deploy.depends?.rpm ?? [])]),
+    };
+};
+export { resolveDepends };
+//# sourceMappingURL=depends.js.map

package/dist/deploy/depends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"depends.js","sourceRoot":"","sources":["../../src/deploy/depends.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAE9C,MAAM,YAAY,GAAc;IAC5B,GAAG,EAAE,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,2BAA2B,CAAC;IAC9E,GAAG,EAAE,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,2BAA2B,CAAC;CACjF,CAAC;AAEF,MAAM,kBAAkB,GAA8B;IAClD,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE;IACzD,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE;IAC9D,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE;IACzE,YAAY,EAAE,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE;CACvE,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,SAAmB,EAAa,EAAE,CAAC,CAAC;IACxD,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;IAC3E,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,UAAyB,EAAa,EAAE,CAC1D,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,aAAa,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,YAAY,UAAU,EAAE,CAAC,EAAE,CAAC;AAExH,MAAM,MAAM,GAAG,CAAC,OAAiB,EAAY,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAEtE,MAAM,cAAc,GAAG,CAAC,MAAoB,EAAE,SAAmB,EAAE,UAAyB,EAAa,EAAE;IACvG,MAAM,aAAa,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAE3C,OAAO;QACH,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1G,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;KAC7G,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type { DeployConfig } from \"./types.js\";\n\ntype Relations = {\n    deb: string[];\n    rpm: string[];\n};\n\nconst GLES_SONAME = \"libGLESv2.so.2()(64bit)\";\n\nconst BASE_DEPENDS: Relations = {\n    deb: [\"hicolor-icon-theme\", \"adwaita-icon-theme\", \"gsettings-desktop-schemas\"],\n    rpm: [\"hicolor-icon-theme\", \"adwaita-icon-theme\", \"gsettings-desktop-schemas\"],\n};\n\nconst DEPENDS_BY_LIBRARY: Record<string, Relations> = {\n    \"Adw-1\": { deb: [\"libadwaita-1-0\"], rpm: [\"libadwaita\"] },\n    \"Gtk-4.0\": { deb: [\"libgtk-4-1\"], rpm: [\"gtk4\", GLES_SONAME] },\n    \"GtkSource-5\": { deb: [\"libgtksourceview-5-0\"], rpm: [\"gtksourceview5\"] },\n    \"WebKit-6.0\": { deb: [\"libwebkitgtk-6.0-4\"], rpm: [\"webkitgtk6.0\"] },\n};\n\nconst libraryDepends = (libraries: string[]): Relations => ({\n    deb: libraries.flatMap((library) => DEPENDS_BY_LIBRARY[library]?.deb ?? []),\n    rpm: libraries.flatMap((library) => DEPENDS_BY_LIBRARY[library]?.rpm ?? []),\n});\n\nconst glibcDepends = (glibcFloor: string | null): Relations =>\n    glibcFloor === null ? { deb: [], rpm: [] } : { deb: [`libc6 (>= ${glibcFloor})`], rpm: [`glibc >= ${glibcFloor}`] };\n\nconst dedupe = (entries: string[]): string[] => [...new Set(entries)];\n\nconst resolveDepends = (deploy: DeployConfig, libraries: string[], glibcFloor: string | null): Relations => {\n    const fromLibraries = libraryDepends(libraries);\n    const fromGlibc = glibcDepends(glibcFloor);\n\n    return {\n        deb: dedupe([...fromLibraries.deb, ...BASE_DEPENDS.deb, ...fromGlibc.deb, ...(deploy.depends?.deb ?? [])]),\n        rpm: dedupe([...fromLibraries.rpm, ...BASE_DEPENDS.rpm, ...fromGlibc.rpm, ...(deploy.depends?.rpm ?? [])]),\n    };\n};\n\nexport { resolveDepends };\n"]}

package/dist/deploy/download.d.ts

@@ -0,0 +1,20 @@
+type DigestRequest = {
+    url: string;
+    dest: string;
+    assetName: string;
+    subject: string;
+};
+type DownloadRequest = {
+    url: string;
+    dest: string;
+    label: string;
+    sha256: string;
+    freshSha256?: (() => Promise<string>) | undefined;
+    mode?: number | undefined;
+};
+declare const cacheDir: (segments: string[]) => string;
+declare const publishedDigest: (request: DigestRequest) => Promise<string>;
+declare const cachedDigest: (request: DigestRequest) => Promise<string>;
+declare const downloadFile: (request: DownloadRequest) => Promise<string>;
+export { cacheDir, cachedDigest, type DigestRequest, downloadFile, publishedDigest };
+//# sourceMappingURL=download.d.ts.map

package/dist/deploy/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/deploy/download.ts"],"names":[],"mappings":"AAMA,KAAK,aAAa,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAAC;AAWF,QAAA,MAAM,QAAQ,GAAI,UAAU,MAAM,EAAE,KAAG,MAKtC,CAAC;AA4CF,QAAA,MAAM,eAAe,GAAU,SAAS,aAAa,KAAG,OAAO,CAAC,MAAM,CAWrE,CAAC;AAEF,QAAA,MAAM,YAAY,GAAU,SAAS,aAAa,KAAG,OAAO,CAAC,MAAM,CAIlE,CAAC;AAgBF,QAAA,MAAM,YAAY,GAAU,SAAS,eAAe,KAAG,OAAO,CAAC,MAAM,CAqBpE,CAAC;AAaF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/deploy/download.js

@@ -0,0 +1,98 @@
+import { info, warn } from "@gtkx/utils";
+import { createHash } from "node:crypto";
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const CACHE_NAMESPACE = "gtkx";
+const DIGEST_PATTERN = /^[\da-f]{64}$/;
+const cacheRoot = () => {
+    const base = process.env.XDG_CACHE_HOME;
+    return join(base !== undefined && base.length > 0 ? base : join(homedir(), ".cache"), CACHE_NAMESPACE);
+};
+const cacheDir = (segments) => {
+    const dir = join(cacheRoot(), ...segments);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+};
+const getDigest = (contents) => createHash("sha256").update(contents).digest("hex");
+const assertDigest = (url, contents, expected) => {
+    const actual = getDigest(contents);
+    if (actual !== expected) {
+        throw new Error(`Checksum mismatch for ${url}\n  expected ${expected}\n  received ${actual}`);
+    }
+};
+const fetchBytes = async (url) => {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Cannot download ${url}: HTTP ${String(response.status)} ${response.statusText}`);
+    }
+    return Buffer.from(await response.arrayBuffer());
+};
+const fetchText = async (url) => {
+    const bytes = await fetchBytes(url);
+    return bytes.toString("utf8");
+};
+const readCachedDigest = (dest) => {
+    try {
+        const cached = readFileSync(dest, "utf8").trim();
+        return DIGEST_PATTERN.test(cached) ? cached : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+const writeAtomically = (dest, contents) => {
+    const staging = `${dest}.partial`;
+    writeFileSync(staging, contents);
+    renameSync(staging, dest);
+};
+const publishedDigest = async (request) => {
+    const checksums = await fetchText(request.url);
+    const digest = digestFromChecksums(checksums, request.assetName, request.subject);
+    if (!DIGEST_PATTERN.test(digest)) {
+        throw new Error(`${request.subject} published a malformed checksum for ${request.assetName}: "${digest}"`);
+    }
+    writeAtomically(request.dest, digest);
+    return digest;
+};
+const cachedDigest = async (request) => {
+    const cached = readCachedDigest(request.dest);
+    return cached ?? publishedDigest(request);
+};
+const isCacheUsable = (dest, sha256) => {
+    if (!existsSync(dest)) {
+        return false;
+    }
+    if (getDigest(readFileSync(dest)) === sha256) {
+        return true;
+    }
+    warn(`Discarding the cached ${dest}: its checksum no longer matches`);
+    return false;
+};
+const downloadFile = async (request) => {
+    const { url, dest, label, sha256, mode } = request;
+    if (isCacheUsable(dest, sha256)) {
+        return dest;
+    }
+    info(`Downloading ${label}`);
+    const expected = request.freshSha256 === undefined ? sha256 : await request.freshSha256();
+    const contents = await fetchBytes(url);
+    assertDigest(url, contents, expected);
+    const staging = `${dest}.partial`;
+    writeFileSync(staging, contents);
+    if (mode !== undefined) {
+        chmodSync(staging, mode);
+    }
+    renameSync(staging, dest);
+    return dest;
+};
+const digestFromChecksums = (checksums, assetName, subject) => {
+    const line = checksums.split("\n").find((entry) => entry.trim().endsWith(` ${assetName}`));
+    const digest = line?.trim().split(/\s+/, 1)[0];
+    if (digest === undefined) {
+        throw new Error(`${subject} publishes no checksum for ${assetName}`);
+    }
+    return digest;
+};
+export { cacheDir, cachedDigest, downloadFile, publishedDigest };
+//# sourceMappingURL=download.js.map

package/dist/deploy/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/deploy/download.ts"],"names":[],"mappings":"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","sourcesContent":["import { info, warn } from \"@gtkx/utils\";\nimport { createHash } from \"node:crypto\";\nimport { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\ntype DigestRequest = {\n    url: string;\n    dest: string;\n    assetName: string;\n    subject: string;\n};\n\ntype DownloadRequest = {\n    url: string;\n    dest: string;\n    label: string;\n    sha256: string;\n    freshSha256?: (() => Promise<string>) | undefined;\n    mode?: number | undefined;\n};\n\nconst CACHE_NAMESPACE = \"gtkx\";\nconst DIGEST_PATTERN = /^[\\da-f]{64}$/;\n\nconst cacheRoot = (): string => {\n    const base = process.env.XDG_CACHE_HOME;\n\n    return join(base !== undefined && base.length > 0 ? base : join(homedir(), \".cache\"), CACHE_NAMESPACE);\n};\n\nconst cacheDir = (segments: string[]): string => {\n    const dir = join(cacheRoot(), ...segments);\n    mkdirSync(dir, { recursive: true });\n\n    return dir;\n};\n\nconst getDigest = (contents: Buffer): string => createHash(\"sha256\").update(contents).digest(\"hex\");\n\nconst assertDigest = (url: string, contents: Buffer, expected: string): void => {\n    const actual = getDigest(contents);\n\n    if (actual !== expected) {\n        throw new Error(`Checksum mismatch for ${url}\\n  expected ${expected}\\n  received ${actual}`);\n    }\n};\n\nconst fetchBytes = async (url: string): Promise<Buffer> => {\n    const response = await fetch(url);\n\n    if (!response.ok) {\n        throw new Error(`Cannot download ${url}: HTTP ${String(response.status)} ${response.statusText}`);\n    }\n\n    return Buffer.from(await response.arrayBuffer());\n};\n\nconst fetchText = async (url: string): Promise<string> => {\n    const bytes = await fetchBytes(url);\n\n    return bytes.toString(\"utf8\");\n};\n\nconst readCachedDigest = (dest: string): string | undefined => {\n    try {\n        const cached = readFileSync(dest, \"utf8\").trim();\n\n        return DIGEST_PATTERN.test(cached) ? cached : undefined;\n    } catch {\n        return undefined;\n    }\n};\n\nconst writeAtomically = (dest: string, contents: string): void => {\n    const staging = `${dest}.partial`;\n    writeFileSync(staging, contents);\n    renameSync(staging, dest);\n};\n\nconst publishedDigest = async (request: DigestRequest): Promise<string> => {\n    const checksums = await fetchText(request.url);\n    const digest = digestFromChecksums(checksums, request.assetName, request.subject);\n\n    if (!DIGEST_PATTERN.test(digest)) {\n        throw new Error(`${request.subject} published a malformed checksum for ${request.assetName}: \"${digest}\"`);\n    }\n\n    writeAtomically(request.dest, digest);\n\n    return digest;\n};\n\nconst cachedDigest = async (request: DigestRequest): Promise<string> => {\n    const cached = readCachedDigest(request.dest);\n\n    return cached ?? publishedDigest(request);\n};\n\nconst isCacheUsable = (dest: string, sha256: string): boolean => {\n    if (!existsSync(dest)) {\n        return false;\n    }\n\n    if (getDigest(readFileSync(dest)) === sha256) {\n        return true;\n    }\n\n    warn(`Discarding the cached ${dest}: its checksum no longer matches`);\n\n    return false;\n};\n\nconst downloadFile = async (request: DownloadRequest): Promise<string> => {\n    const { url, dest, label, sha256, mode } = request;\n\n    if (isCacheUsable(dest, sha256)) {\n        return dest;\n    }\n\n    info(`Downloading ${label}`);\n    const expected = request.freshSha256 === undefined ? sha256 : await request.freshSha256();\n    const contents = await fetchBytes(url);\n    assertDigest(url, contents, expected);\n    const staging = `${dest}.partial`;\n    writeFileSync(staging, contents);\n\n    if (mode !== undefined) {\n        chmodSync(staging, mode);\n    }\n\n    renameSync(staging, dest);\n\n    return dest;\n};\n\nconst digestFromChecksums = (checksums: string, assetName: string, subject: string): string => {\n    const line = checksums.split(\"\\n\").find((entry) => entry.trim().endsWith(` ${assetName}`));\n    const digest = line?.trim().split(/\\s+/, 1)[0];\n\n    if (digest === undefined) {\n        throw new Error(`${subject} publishes no checksum for ${assetName}`);\n    }\n\n    return digest;\n};\n\nexport { cacheDir, cachedDigest, type DigestRequest, downloadFile, publishedDigest };\n"]}

package/dist/deploy/freedesktop/copyright.d.ts

@@ -0,0 +1,4 @@
+import type { DeploySettings } from "../types.js";
+declare const renderCopyright: (settings: DeploySettings) => string;
+export { renderCopyright };
+//# sourceMappingURL=copyright.d.ts.map

package/dist/deploy/freedesktop/copyright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyright.d.ts","sourceRoot":"","sources":["../../../src/deploy/freedesktop/copyright.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4BlD,QAAA,MAAM,eAAe,GAAI,UAAU,cAAc,KAAG,MASpC,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/deploy/freedesktop/copyright.js

@@ -0,0 +1,33 @@
+import { readFileSync } from "node:fs";
+const FORMAT_URL = "https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/";
+const CONTINUATION_BLANK = " .";
+const indentLicenseBody = (body) => body
+    .split("\n")
+    .map((line) => (line.trim().length === 0 ? CONTINUATION_BLANK : ` ${line}`));
+const licenseBody = (licenseFile) => {
+    if (licenseFile === null) {
+        return [];
+    }
+    try {
+        return indentLicenseBody(readFileSync(licenseFile, "utf8").trimEnd());
+    }
+    catch {
+        return [];
+    }
+};
+const headerLines = (settings) => [
+    `Format: ${FORMAT_URL}`,
+    `Upstream-Name: ${settings.name}`,
+    ...(settings.homepage === null ? [] : [`Source: ${settings.homepage}`]),
+];
+const renderCopyright = (settings) => [
+    ...headerLines(settings),
+    "",
+    "Files: *",
+    `Copyright: ${settings.copyright}`,
+    `License: ${settings.license}`,
+    ...licenseBody(settings.paths.licenseFile),
+    "",
+].join("\n");
+export { renderCopyright };
+//# sourceMappingURL=copyright.js.map

package/dist/deploy/freedesktop/copyright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyright.js","sourceRoot":"","sources":["../../../src/deploy/freedesktop/copyright.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,UAAU,GAAG,oEAAoE,CAAC;AACxF,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAY,EAAE,CACjD,IAAI;KACC,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;AAErF,MAAM,WAAW,GAAG,CAAC,WAA0B,EAAY,EAAE;IACzD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACD,OAAO,iBAAiB,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,QAAwB,EAAY,EAAE,CAAC;IACxD,WAAW,UAAU,EAAE;IACvB,kBAAkB,QAAQ,CAAC,IAAI,EAAE;IACjC,GAAG,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,QAAwB,EAAU,EAAE,CACzD;IACI,GAAG,WAAW,CAAC,QAAQ,CAAC;IACxB,EAAE;IACF,UAAU;IACV,cAAc,QAAQ,CAAC,SAAS,EAAE;IAClC,YAAY,QAAQ,CAAC,OAAO,EAAE;IAC9B,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;IAC1C,EAAE;CACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,CAAC","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type { DeploySettings } from \"../types.js\";\n\nconst FORMAT_URL = \"https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/\";\nconst CONTINUATION_BLANK = \" .\";\n\nconst indentLicenseBody = (body: string): string[] =>\n    body\n        .split(\"\\n\")\n        .map((line) => (line.trim().length === 0 ? CONTINUATION_BLANK : ` ${line}`));\n\nconst licenseBody = (licenseFile: string | null): string[] => {\n    if (licenseFile === null) {\n        return [];\n    }\n\n    try {\n        return indentLicenseBody(readFileSync(licenseFile, \"utf8\").trimEnd());\n    } catch {\n        return [];\n    }\n};\n\nconst headerLines = (settings: DeploySettings): string[] => [\n    `Format: ${FORMAT_URL}`,\n    `Upstream-Name: ${settings.name}`,\n    ...(settings.homepage === null ? [] : [`Source: ${settings.homepage}`]),\n];\n\nconst renderCopyright = (settings: DeploySettings): string =>\n    [\n        ...headerLines(settings),\n        \"\",\n        \"Files: *\",\n        `Copyright: ${settings.copyright}`,\n        `License: ${settings.license}`,\n        ...licenseBody(settings.paths.licenseFile),\n        \"\",\n    ].join(\"\\n\");\n\nexport { renderCopyright };\n"]}

package/dist/deploy/freedesktop/dbus-service.d.ts

@@ -0,0 +1,4 @@
+import type { DeploySettings } from "../types.js";
+declare const renderDbusService: (settings: DeploySettings, prefix: string) => string;
+export { renderDbusService };
+//# sourceMappingURL=dbus-service.d.ts.map

package/dist/deploy/freedesktop/dbus-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbus-service.d.ts","sourceRoot":"","sources":["../../../src/deploy/freedesktop/dbus-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,QAAA,MAAM,iBAAiB,GAAI,UAAU,cAAc,EAAE,QAAQ,MAAM,KAAG,MAShE,CAAC;AAEP,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/deploy/freedesktop/dbus-service.js

@@ -0,0 +1,15 @@
+import { posix } from "node:path";
+import { renderIni } from "./ini.js";
+const SERVICE_GROUP = "D-BUS Service";
+const SERVICE_FLAG = "--gapplication-service";
+const renderDbusService = (settings, prefix) => renderIni([
+    {
+        name: SERVICE_GROUP,
+        entries: [
+            ["Name", settings.applicationId],
+            ["Exec", `${posix.join(prefix, "bin", settings.binaryName)} ${SERVICE_FLAG}`],
+        ],
+    },
+]);
+export { renderDbusService };
+//# sourceMappingURL=dbus-service.js.map

package/dist/deploy/freedesktop/dbus-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbus-service.js","sourceRoot":"","sources":["../../../src/deploy/freedesktop/dbus-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,aAAa,GAAG,eAAe,CAAC;AACtC,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,MAAM,iBAAiB,GAAG,CAAC,QAAwB,EAAE,MAAc,EAAU,EAAE,CAC3E,SAAS,CAAC;IACN;QACI,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE;YACL,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC;YAChC,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,YAAY,EAAE,CAAC;SAChF;KACJ;CACJ,CAAC,CAAC;AAEP,OAAO,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import { posix } from \"node:path\";\nimport type { DeploySettings } from \"../types.js\";\nimport { renderIni } from \"./ini.js\";\n\nconst SERVICE_GROUP = \"D-BUS Service\";\nconst SERVICE_FLAG = \"--gapplication-service\";\n\nconst renderDbusService = (settings: DeploySettings, prefix: string): string =>\n    renderIni([\n        {\n            name: SERVICE_GROUP,\n            entries: [\n                [\"Name\", settings.applicationId],\n                [\"Exec\", `${posix.join(prefix, \"bin\", settings.binaryName)} ${SERVICE_FLAG}`],\n            ],\n        },\n    ]);\n\nexport { renderDbusService };\n"]}

package/dist/deploy/freedesktop/desktop-entry.d.ts

@@ -0,0 +1,4 @@
+import type { DeploySettings } from "../types.js";
+declare const renderDesktopEntry: (settings: DeploySettings) => string;
+export { renderDesktopEntry };
+//# sourceMappingURL=desktop-entry.d.ts.map

package/dist/deploy/freedesktop/desktop-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-entry.d.ts","sourceRoot":"","sources":["../../../src/deploy/freedesktop/desktop-entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,cAAc,EAAE,MAAM,aAAa,CAAC;AAuFvE,QAAA,MAAM,kBAAkB,GAAI,UAAU,cAAc,KAAG,MAYtD,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/deploy/freedesktop/desktop-entry.js

@@ -0,0 +1,73 @@
+import { renderIni } from "./ini.js";
+const DESKTOP_ENTRY_GROUP = "Desktop Entry";
+const EXEC_QUOTED_CHARACTERS = /["`$\\]/g;
+const EXEC_RESERVED_CHARACTERS = /[\s"'\\><~|&;$*?#()`]/;
+const RESERVED_KEYS = new Map([
+    ["DBusActivatable", "use `deploy.isDbusActivatable` instead"],
+    ["Version", "it names the desktop entry spec version, not the application's"],
+]);
+const quoteExecToken = (token) => {
+    const escaped = token.replaceAll("%", "%%");
+    if (!EXEC_RESERVED_CHARACTERS.test(escaped)) {
+        return escaped;
+    }
+    const quoted = escaped.replaceAll(EXEC_QUOTED_CHARACTERS, (character) => `\\${character}`);
+    return `"${quoted}"`;
+};
+const execLine = (settings) => [
+    ...[settings.binaryName, ...settings.execArgs].map((part) => quoteExecToken(part)),
+    settings.execToken ?? "",
+]
+    .filter((part) => part.length > 0)
+    .join(" ");
+const optionalEntry = (key, value) => (value === null ? [] : [[key, value]]);
+const listEntry = (key, values) => (values.length === 0 ? [] : [[key, values]]);
+const assertNoReservedOverrides = (settings) => {
+    for (const key of Object.keys(settings.desktopEntry)) {
+        const remedy = RESERVED_KEYS.get(key);
+        if (remedy !== undefined) {
+            throw new Error(`Cannot set "${key}" through \`deploy.desktopEntry\`: gtkx deploy writes it, ${remedy}`);
+        }
+    }
+};
+const baseEntries = (settings) => [
+    ["Type", "Application"],
+    ["Name", settings.name],
+    ...optionalEntry("GenericName", settings.genericName),
+    ["Comment", settings.summary],
+    ["Exec", execLine(settings)],
+    ["Icon", settings.applicationId],
+    ["Terminal", "false"],
+    ...listEntry("Categories", settings.categories),
+    ...listEntry("Keywords", settings.keywords),
+    ...listEntry("MimeType", settings.mimeTypes),
+    ["StartupNotify", "true"],
+    ["StartupWMClass", settings.applicationId],
+];
+const actionEntries = (settings) => settings.desktopActions.length === 0 ? [] : [["Actions", settings.desktopActions.map((action) => action.id)]];
+const activationEntries = (settings) => settings.isDbusActivatable ? [["DBusActivatable", "true"]] : [];
+const actionGroup = (settings, action) => ({
+    name: `Desktop Action ${action.id}`,
+    entries: [
+        ["Name", action.name],
+        ["Exec", [settings.binaryName, ...action.args].map((part) => quoteExecToken(part)).join(" ")],
+        ...optionalEntry("Icon", action.icon),
+    ],
+});
+const mergeEntries = (entries, overrides) => {
+    const merged = new Map(entries);
+    for (const [key, value] of overrides) {
+        merged.set(key, value);
+    }
+    return merged.entries().toArray();
+};
+const renderDesktopEntry = (settings) => {
+    assertNoReservedOverrides(settings);
+    const main = {
+        name: DESKTOP_ENTRY_GROUP,
+        entries: mergeEntries([...baseEntries(settings), ...actionEntries(settings), ...activationEntries(settings)], Object.entries(settings.desktopEntry)),
+    };
+    return renderIni([main, ...settings.desktopActions.map((action) => actionGroup(settings, action))]);
+};
+export { renderDesktopEntry };
+//# sourceMappingURL=desktop-entry.js.map