toolfactory 0.1.2 → 0.2.0

package/dist/distribution/system.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Operating-system package managers consume authored native artifacts and packaging metadata.
+ * This is intentionally not a cross-language compiler or a launcher generator.
+ */
+import { z } from "zod";
+import type { Project, Surface } from "../model.js";
+import type { GateStep, Registry } from "../project/gate.js";
+export declare const SYSTEM_PACKAGE_IDS: readonly ["homebrew", "winget", "scoop", "chocolatey", "apt", "rpm"];
+export type SystemPackageId = (typeof SYSTEM_PACKAGE_IDS)[number];
+export declare const systemPackageConfigSchema: z.ZodObject<{
+    id: z.ZodEnum<{
+        homebrew: "homebrew";
+        winget: "winget";
+        scoop: "scoop";
+        chocolatey: "chocolatey";
+        apt: "apt";
+        rpm: "rpm";
+    }>;
+    path: z.ZodString;
+    identity: z.ZodString;
+    name: z.ZodString;
+    versionCommand: z.ZodString;
+    buildCommand: z.ZodOptional<z.ZodString>;
+    buildDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    asset: z.ZodOptional<z.ZodString>;
+    tap: z.ZodOptional<z.ZodString>;
+    bucket: z.ZodOptional<z.ZodString>;
+    bucketName: z.ZodOptional<z.ZodString>;
+    catalogPath: z.ZodOptional<z.ZodString>;
+    ppa: z.ZodOptional<z.ZodString>;
+    coprProject: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type SystemPackageConfig = z.infer<typeof systemPackageConfigSchema>;
+export declare const systemPackageSurfaces: Surface[];
+/** Required CLI preflight for compatible local runs; native CI jobs install their own tooling. */
+export declare function systemToolchainSteps(project: Project, options?: {
+    include?: boolean;
+}): GateStep[];
+/** Build actual package artifacts or stage the authored catalog submission, all at portable paths. */
+export declare function systemPackageSteps(project: Project, options?: {
+    include?: boolean;
+    local?: boolean;
+}): GateStep[];
+export declare function systemRegistryRows(project: Project): Registry[];
+type Job = Record<string, unknown>;
+/**
+ * Native runner jobs. The generic Ubuntu gate/package workflow must not execute OS surface steps;
+ * it waits for these jobs and downloads each `system-<id>` artifact into dist/release/system/<id>.
+ */
+export declare function systemPackageJobs(project: Project, releaseSha: string): Record<string, Job>;
+/**
+ * Publish only after the GitHub release exists. Homebrew taps and Scoop buckets are ordinary
+ * author-controlled Git repositories; WinGet remains a reviewed microsoft/winget-pkgs submission.
+ */
+export declare function systemPublishJobs(project: Project, artifactDir: string, _releaseSha: string): Record<string, Job>;
+export declare function systemInstallLines(project: Project): string[];
+export {};