@powerhousedao/shared 6.2.2-dev.7 → 6.2.2-dev.71

package/dist/clis/index.d.mts

@@ -134,6 +134,9 @@ declare const connectBasePath: Partial<cmd_ts_dist_cjs_argparser_js0.Register> &
 declare const renownNamespace: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
   parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
 } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
+declare const renownSwitchboardUrl: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
+  parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
+} & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
 declare const drivesPreserveStrategy: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
   parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<"preserve-all" | "preserve-by-url-and-detach">>;
 } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
@@ -305,6 +308,9 @@ declare const connectBuildArgs: {
   renownNamespace: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
     parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
   } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
+  renownSwitchboardUrl: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
+  } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
   allowAddDrive: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
     parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<boolean | undefined>>;
   } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
@@ -441,6 +447,9 @@ declare const connectConfigArgs: {
   renownNamespace: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
     parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
   } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
+  renownSwitchboardUrl: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
+  } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
   allowAddDrive: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
     parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<boolean | undefined>>;
   } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
@@ -524,6 +533,9 @@ declare const connectArgs: {
   renownNamespace: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
     parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
   } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
+  renownSwitchboardUrl: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<string | undefined>>;
+  } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
   allowAddDrive: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
     parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<boolean | undefined>>;
   } & cmd_ts_dist_cjs_helpdoc_js0.ProvidesHelp & Partial<cmd_ts_dist_cjs_helpdoc_js0.Descriptive>;
@@ -1098,6 +1110,7 @@ declare const ManifestSchema: z.ZodObject<{
     required: z.ZodOptional<z.ZodBoolean>;
     default: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>>;
+  pwa: z.ZodOptional<z.ZodType<PHConnectPwa, unknown, z.core.$ZodTypeInternals<PHConnectPwa, unknown>>>;
 }, z.core.$strip>;
 //#endregion
 //#region document-model/types.d.ts
@@ -1116,8 +1129,12 @@ declare const DEFAULT_VETRA_CONNECT_PORT: 3001;
 declare const DEFAULT_CONNECT_PREVIEW_PORT: 4173;
 declare const DEFAULT_CONNECT_OUTDIR: ".ph/connect-build/dist/";
 declare const DEFAULT_RENOWN_URL: "https://www.renown.id";
-declare const DEFAULT_REGISTRY_URL: "https://registry.dev.vetra.io";
+declare const DEFAULT_REGISTRY_URL: "https://registry.vetra.io";
 declare const DEFAULT_SWITCHBOARD_PORT: 4001;
+declare const PROJECT_PORT_BAND_SIZE: 1000;
+declare const PROJECT_PORT_BAND_SWITCHBOARD: 7000;
+declare const PROJECT_PORT_BAND_STUDIO: 6000;
+declare const PROJECT_PORT_BAND_VETRA_CONNECT: 2000;
 declare const DEFAULT_VETRA_DRIVE_ID: "vetra";
 declare const MINIMUM_NODE_VERSION: "24.0.0";
 declare const PH_BIN: "ph-cli-legacy";
@@ -1160,7 +1177,7 @@ declare const FEATURE_DEPENDENCIES: {
   };
 };
 declare const VERSIONED_DEPENDENCIES: string[];
-declare const BOILERPLATE_ALLOWED_BUILDS: readonly ["@apollo/protobufjs", "@datadog/pprof", "@parcel/watcher", "esbuild", "protobufjs"];
+declare const BOILERPLATE_ALLOWED_BUILDS: readonly ["@apollo/protobufjs", "@datadog/pprof", "@parcel/watcher", "@reown/appkit", "bufferutil", "esbuild", "keccak", "protobufjs", "utf-8-validate"];
 declare const BOILERPLATE_PNPM_OVERRIDES: {
   readonly "date-fns": "4.3.0";
   readonly vite: "8.0.14";
@@ -1304,11 +1321,26 @@ type PHConnectPackages = {
   externalEnabled?: boolean; /** Subscribe to the static-mode `/__packages` SSE channel for live reload. */
   liveReload?: boolean;
 };
+type PHRenownRainbowAdapterConfig = {
+  /** WalletConnect project id; required for the rainbow adapter to function. */walletConnectProjectId?: string; /** Optional Infura project id used to build RPC transports. */
+  infuraProjectId?: string;
+};
+type PHRenownPrivyAdapterConfig = {
+  /** Privy application id; required for the privy adapter to function. */appId?: string; /** Optional Privy client id. */
+  clientId?: string; /** Login methods this adapter offers; defaults per adapter when omitted. */
+  methods?: string[];
+};
+type PHConnectRenownAdapters = {
+  rainbow?: PHRenownRainbowAdapterConfig;
+  privy?: PHRenownPrivyAdapterConfig;
+};
 type PHConnectRenown = {
   url?: string;
   networkId?: string;
   chainId?: number; /** Renown localStorage namespace; share it across Connects to share login. */
-  namespace?: string;
+  namespace?: string; /** Switchboard GraphQL URL; when set, enables in-page (no-redirect) auth. */
+  switchboardUrl?: string; /** Per-adapter wallet config; presence of a key enables that adapter. */
+  adapters?: PHConnectRenownAdapters;
 };
 type PHConnectSentry = {
   /** Sentry DSN URL. `null` disables Sentry entirely. */dsn?: string | null; /** Sentry environment label. */
@@ -1319,6 +1351,106 @@ type PHConnectInstance = {
   namespace: string | null;
   reactorWorker: boolean;
 };
+/** Each flag implies its predecessors, and must match the fleet Connect syncs
+ * with or the two compute different replay outcomes. */
+type PHConnectReactorFeatureFlags = {
+  /** Decide writes from the document stream instead of the meta cache. */documentDecisions?: boolean; /** Enforce the auth scope's policy at admission, replay, and read. */
+  authEnforcement?: boolean; /** Let `{ group }` principals match, via the group documents' rosters. */
+  authGroups?: boolean; /** Evaluate `where` / `match` conditions on grants. */
+  authConditions?: boolean;
+};
+type PHConnectReactor = {
+  featureFlags?: PHConnectReactorFeatureFlags;
+};
+/**
+ * A URL-matching pattern for a service-worker runtime-caching rule, in
+ * JSON-serialisable form. A plain string is handed to Workbox verbatim (exact
+ * URL or same-origin path match). `{ source, flags }` is reconstructed into a
+ * `RegExp` at build time — use it for prefix/suffix/origin matches (e.g.
+ * `{ source: "^https://api\\.acme\\.io/" }`). Function-valued patterns aren't
+ * expressible here; regex covers the realistic package cases.
+ */
+type PHConnectPwaUrlPattern = string | {
+  source: string;
+  flags?: string;
+};
+type PHConnectPwaCacheStrategy = "CacheFirst" | "CacheOnly" | "NetworkFirst" | "NetworkOnly" | "StaleWhileRevalidate";
+/** Serialisable subset of a Workbox `RuntimeCaching` rule. */
+type PHConnectPwaRuntimeCaching = {
+  urlPattern: PHConnectPwaUrlPattern;
+  handler: PHConnectPwaCacheStrategy;
+  method?: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "PATCH";
+  options?: {
+    cacheName?: string;
+    /** Seconds a NetworkFirst rule waits for the network before falling back
+     * to the cache. */
+    networkTimeoutSeconds?: number;
+    expiration?: {
+      maxEntries?: number;
+      maxAgeSeconds?: number;
+    };
+    cacheableResponse?: {
+      statuses?: number[];
+      headers?: Record<string, string>;
+    };
+  };
+};
+type PHConnectPwaIcon = {
+  src: string;
+  sizes?: string;
+  type?: string;
+  purpose?: string;
+};
+/**
+ * A File Handling API entry a package or project contributes: the OS-level
+ * file types the installed Connect PWA offers to open. There is deliberately
+ * no `action` field — consuming launched files requires runtime code that
+ * lives in Connect itself, so every handler (built-in or contributed) opens
+ * at Connect's app root, injected at build time.
+ */
+type PHConnectPwaFileHandler = {
+  /** MIME type → file extensions (each must start with "."). */accept: Record<string, string[]>; /** OS-level file-type icons. */
+  icons?: PHConnectPwaIcon[];
+  launch_type?: "single-client" | "multiple-clients";
+};
+/** Web-app-manifest fields a package or project may override. */
+type PHConnectPwaManifest = {
+  name?: string;
+  short_name?: string;
+  description?: string;
+  theme_color?: string;
+  background_color?: string;
+  display?: "fullscreen" | "standalone" | "minimal-ui" | "browser";
+  start_url?: string;
+  scope?: string;
+  icons?: PHConnectPwaIcon[]; /** Extra file associations, appended after Connect's built-in `.phd`/`.phdm` handler. */
+  file_handlers?: PHConnectPwaFileHandler[]; /** How the OS launches the app for handled files/links. */
+  launch_handler?: {
+    client_mode: "auto" | "focus-existing" | "navigate-existing" | "navigate-new";
+  };
+  /** App-store-style categories. NOT authored under `connect.pwa` — derived at
+   * build/runtime from the `category` field of every contributing
+   * `powerhouse.manifest.json` (project + packages), unioned across them. */
+  categories?: string[];
+};
+/**
+ * PWA / service-worker overrides contributed by a package or the project.
+ * Layered on top of Connect's hardcoded PWA defaults at build time. Scalar
+ * fields deep-merge (later layer wins); every array member — the manifest
+ * arrays (`icons`, `file_handlers`, and the derived `categories`) plus the
+ * top-level `globPatterns`, `globIgnores`, `runtimeCaching` and
+ * `navigateFallbackDenylist` — is additive (concatenated/unioned);
+ * `maximumFileSizeToCacheInBytes` takes the max across contributors.
+ * Precedence: defaults < package fragments < project config.
+ */
+type PHConnectPwa = {
+  manifest?: PHConnectPwaManifest; /** Extra Workbox precache globs, unioned with the built-in patterns. */
+  globPatterns?: string[]; /** Extra Workbox precache ignore globs, unioned with the built-in list. */
+  globIgnores?: string[]; /** Raise the precache file-size ceiling; the max across contributors wins. */
+  maximumFileSizeToCacheInBytes?: number; /** Additional runtime-caching rules, appended after the built-in rules. */
+  runtimeCaching?: PHConnectPwaRuntimeCaching[]; /** Extra SPA-fallback denylist patterns, unioned with the built-in list. */
+  navigateFallbackDenylist?: PHConnectPwaUrlPattern[];
+};
 type PHConnectRuntimeConfig = {
   branding?: PHConnectBranding;
   app?: PHConnectApp;
@@ -1327,6 +1459,16 @@ type PHConnectRuntimeConfig = {
   renown?: PHConnectRenown;
   sentry?: PHConnectSentry;
   instance?: PHConnectInstance;
+  reactor?: PHConnectReactor;
+  pwa?: PHConnectPwa;
+};
+/** Which Renown instance a reactor authenticates against, server-side. */
+type PHReactorRenown = {
+  /** "self" reads this reactor's own renown read model; "remote" (default)
+   * queries a Renown or Switchboard instance. */
+  source?: "remote" | "self"; /** Renown base URL; also the instance this reactor's own identity uses. */
+  url?: string; /** Switchboard GraphQL endpoint to read credentials from directly. */
+  switchboardUrl?: string;
 };
 type PowerhouseConfig = {
   logLevel: LogLevel;
@@ -1353,6 +1495,7 @@ type PowerhouseConfig = {
   auth?: {
     enabled?: boolean;
     admins: string[];
+    renown?: PHReactorRenown;
   };
   switchboard?: {
     database?: {
@@ -1368,8 +1511,9 @@ type PowerhouseConfig = {
   };
   packages?: PowerhousePackage[];
   vetra?: {
-    driveId: string;
-    driveUrl: string;
+    driveId?: string;
+    driveUrl?: string;
+    connectPort?: number;
   };
   packageRegistryUrl?: string;
   connect?: PHConnectRuntimeConfig;
@@ -1497,6 +1641,17 @@ declare const unpublishArgs: {
 };
 //#endregion
 //#region clis/args/vetra.d.ts
+/**
+ * Resolve the Vetra Switchboard port.
+ *
+ * Precedence: CLI flag (cmd-ts applies that above this function) →
+ * `process.env` → `.env.local` → `.env` → `powerhouse.config.json` →
+ * constant. `loadProjectEnv` folds the two files into `process.env` without
+ * clobbering anything already set, so a single lookup covers the middle three.
+ */
+declare function resolveSwitchboardPortDefault(): number;
+/** Resolve the Vetra Connect port through the same chain. */
+declare function resolveConnectPortDefault(): number;
 declare const vetraArgs: {
   debug: Partial<cmd_ts_dist_cjs_argparser_js0.Register> & {
     parse(context: cmd_ts_dist_cjs_argparser_js0.ParseContext): Promise<cmd_ts_dist_cjs_argparser_js0.ParsingResult<boolean | undefined>>;
@@ -1865,6 +2020,26 @@ declare const sourceConfigSchema: {
           };
           readonly description: "DIDs granted admin role.";
         };
+        readonly renown: {
+          readonly type: "object";
+          readonly additionalProperties: false;
+          readonly description: "Which Renown instance this reactor authenticates against, server-side.";
+          readonly properties: {
+            readonly source: {
+              readonly type: "string";
+              readonly enum: readonly ["remote", "self"];
+              readonly description: "Source of truth for credential checks. \"self\" reads this reactor's own renown read model; \"remote\" (default) queries a Renown or Switchboard instance. Overridden by RENOWN_SOURCE.";
+            };
+            readonly url: {
+              readonly type: "string";
+              readonly description: "Renown base URL, also used by this reactor's own identity. Defaults to https://www.renown.id. Overridden by RENOWN_URL.";
+            };
+            readonly switchboardUrl: {
+              readonly type: "string";
+              readonly description: "Switchboard GraphQL endpoint to read credentials from directly, skipping Renown discovery. Overridden by SWITCHBOARD_URL.";
+            };
+          };
+        };
       };
     };
     readonly switchboard: {
@@ -1943,7 +2118,6 @@ declare const sourceConfigSchema: {
     readonly vetra: {
       readonly type: "object";
       readonly additionalProperties: false;
-      readonly required: readonly ["driveId", "driveUrl"];
       readonly description: "Vetra integration coordinates.";
       readonly properties: {
         readonly driveId: {
@@ -1952,6 +2126,10 @@ declare const sourceConfigSchema: {
         readonly driveUrl: {
           readonly type: "string";
         };
+        readonly connectPort: {
+          readonly type: "integer";
+          readonly description: "Port `ph vetra`'s Connect dev server listens on. Assigned per project by `ph init`. Overridden by PH_VETRA_CONNECT_PORT or --connect-port.";
+        };
       };
     };
     readonly packageRegistryUrl: {
@@ -2132,6 +2310,58 @@ declare const sourceConfigSchema: {
               readonly description: "CAIP-2 chain reference within the network namespace.";
               readonly default: 1;
             };
+            readonly namespace: {
+              readonly type: "string";
+              readonly description: "Renown localStorage namespace; share it across Connects to share login.";
+            };
+            readonly switchboardUrl: {
+              readonly type: "string";
+              readonly description: "Switchboard GraphQL URL. When set, Connect enables in-page (no-redirect) Renown sign-in; otherwise it falls back to the redirect flow via `url`.";
+            };
+            readonly adapters: {
+              readonly type: "object";
+              readonly additionalProperties: false;
+              readonly description: "Per-adapter wallet config for in-page auth. Presence of an adapter key enables it; omit or leave empty for redirect-only behaviour.";
+              readonly properties: {
+                readonly rainbow: {
+                  readonly type: "object";
+                  readonly additionalProperties: false;
+                  readonly description: "wagmi + RainbowKit external-wallet adapter config.";
+                  readonly properties: {
+                    readonly walletConnectProjectId: {
+                      readonly type: "string";
+                      readonly description: "WalletConnect project id; required for this adapter to function.";
+                    };
+                    readonly infuraProjectId: {
+                      readonly type: "string";
+                      readonly description: "Optional Infura project id used to build RPC transports.";
+                    };
+                  };
+                };
+                readonly privy: {
+                  readonly type: "object";
+                  readonly additionalProperties: false;
+                  readonly description: "Privy embedded/social adapter config.";
+                  readonly properties: {
+                    readonly appId: {
+                      readonly type: "string";
+                      readonly description: "Privy application id; required for this adapter to function.";
+                    };
+                    readonly clientId: {
+                      readonly type: "string";
+                      readonly description: "Optional Privy client id.";
+                    };
+                    readonly methods: {
+                      readonly type: "array";
+                      readonly description: "Login methods this adapter offers; default per adapter when omitted.";
+                      readonly items: {
+                        readonly type: "string";
+                      };
+                    };
+                  };
+                };
+              };
+            };
           };
         };
         readonly sentry: {
@@ -2174,6 +2404,287 @@ declare const sourceConfigSchema: {
             };
           };
         };
+        readonly reactor: {
+          readonly type: "object";
+          readonly additionalProperties: false;
+          readonly description: "Settings for the reactor Connect runs in the browser, on the main thread or in the shared worker alike.";
+          readonly properties: {
+            readonly featureFlags: {
+              readonly type: "object";
+              readonly additionalProperties: false;
+              readonly description: "Enforcement flags. Each implies its predecessors, and the reactor refuses to boot on a set that names a later flag without an earlier one. These are consensus settings: a Connect syncing with a fleet must carry the same flags the fleet does, or the two reach different replay outcomes for the same history and diverge.";
+              readonly properties: {
+                readonly documentDecisions: {
+                  readonly type: "boolean";
+                  readonly description: "Decide writes from the document stream rather than the document meta cache, so a backdated deletion denies the operations that sort after it.";
+                  readonly default: false;
+                };
+                readonly authEnforcement: {
+                  readonly type: "boolean";
+                  readonly description: "Enforce the auth scope's policy at admission, replay, and read. Requires documentDecisions.";
+                  readonly default: false;
+                };
+                readonly authGroups: {
+                  readonly type: "boolean";
+                  readonly description: "Let `{ group }` principals match against the rosters of the group documents a policy names. Requires authEnforcement.";
+                  readonly default: false;
+                };
+                readonly authConditions: {
+                  readonly type: "boolean";
+                  readonly description: "Evaluate `where` and `match` conditions on grants. Requires authGroups. Do not enable on a fleet `preflight:auth` reports as crossing a reducer version.";
+                  readonly default: false;
+                };
+              };
+            };
+          };
+        };
+        readonly pwa: {
+          readonly type: "object";
+          readonly additionalProperties: false;
+          readonly description: "Progressive-web-app / service-worker overrides, layered on Connect's built-in PWA defaults at build time. Scalar fields deep-merge (this layer wins); the array members (icons, file_handlers, globs, runtimeCaching and denylist patterns) are additive; maximumFileSizeToCacheInBytes takes the max across contributors. (categories is not set here — it is derived from the manifest's category field.) Only applied when connect.app.offline is true.";
+          readonly properties: {
+            readonly manifest: {
+              readonly type: "object";
+              readonly additionalProperties: false;
+              readonly description: "Web-app-manifest field overrides.";
+              readonly properties: {
+                readonly name: {
+                  readonly type: "string";
+                };
+                readonly short_name: {
+                  readonly type: "string";
+                };
+                readonly description: {
+                  readonly type: "string";
+                };
+                readonly theme_color: {
+                  readonly type: "string";
+                };
+                readonly background_color: {
+                  readonly type: "string";
+                };
+                readonly display: {
+                  readonly type: "string";
+                  readonly enum: readonly ["fullscreen", "standalone", "minimal-ui", "browser"];
+                };
+                readonly start_url: {
+                  readonly type: "string";
+                };
+                readonly scope: {
+                  readonly type: "string";
+                };
+                readonly icons: {
+                  readonly type: "array";
+                  readonly description: "Icons appended to the built-in set and de-duplicated by (src, sizes, purpose).";
+                  readonly items: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["src"];
+                    readonly properties: {
+                      readonly src: {
+                        readonly type: "string";
+                      };
+                      readonly sizes: {
+                        readonly type: "string";
+                      };
+                      readonly type: {
+                        readonly type: "string";
+                      };
+                      readonly purpose: {
+                        readonly type: "string";
+                      };
+                    };
+                  };
+                };
+                readonly file_handlers: {
+                  readonly type: "array";
+                  readonly description: "File associations appended after Connect's built-in .phd/.phdm handler and de-duplicated on the whole entry. Entries only declare accepted types; there is no action field, because opening the files requires Connect's own runtime handling, so every handler opens at the app root.";
+                  readonly items: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["accept"];
+                    readonly properties: {
+                      readonly accept: {
+                        readonly type: "object";
+                        readonly description: "MIME type → file extensions. Each extension must start with '.'; browsers ignore entries without it.";
+                        readonly additionalProperties: {
+                          readonly type: "array";
+                          readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^\\.";
+                          };
+                        };
+                      };
+                      readonly icons: {
+                        readonly type: "array";
+                        readonly description: "OS-level file-type icons.";
+                        readonly items: {
+                          readonly type: "object";
+                          readonly additionalProperties: false;
+                          readonly required: readonly ["src"];
+                          readonly properties: {
+                            readonly src: {
+                              readonly type: "string";
+                            };
+                            readonly sizes: {
+                              readonly type: "string";
+                            };
+                            readonly type: {
+                              readonly type: "string";
+                            };
+                            readonly purpose: {
+                              readonly type: "string";
+                            };
+                          };
+                        };
+                      };
+                      readonly launch_type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["single-client", "multiple-clients"];
+                      };
+                    };
+                  };
+                };
+                readonly launch_handler: {
+                  readonly type: "object";
+                  readonly additionalProperties: false;
+                  readonly required: readonly ["client_mode"];
+                  readonly description: "How the OS launches the app for handled files/links. Connect defaults to focus-existing.";
+                  readonly properties: {
+                    readonly client_mode: {
+                      readonly type: "string";
+                      readonly enum: readonly ["auto", "focus-existing", "navigate-existing", "navigate-new"];
+                    };
+                  };
+                };
+              };
+            };
+            readonly globPatterns: {
+              readonly type: "array";
+              readonly items: {
+                readonly type: "string";
+              };
+              readonly description: "Extra Workbox precache globs, unioned with the built-ins.";
+            };
+            readonly globIgnores: {
+              readonly type: "array";
+              readonly items: {
+                readonly type: "string";
+              };
+              readonly description: "Extra precache ignore globs, unioned with the built-ins.";
+            };
+            readonly maximumFileSizeToCacheInBytes: {
+              readonly type: "number";
+              readonly description: "Raise the precache file-size ceiling. The max across all contributors wins, so no contributor can shrink another's limit.";
+            };
+            readonly runtimeCaching: {
+              readonly type: "array";
+              readonly description: "Runtime-caching rules appended after the built-in rules. Workbox is first-match-wins, so these cannot override a built-in rule matching the same URL.";
+              readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["urlPattern", "handler"];
+                readonly properties: {
+                  readonly urlPattern: {
+                    readonly description: "URL match. A string is matched verbatim by Workbox; { source, flags } is rebuilt into a RegExp at build time.";
+                    readonly oneOf: readonly [{
+                      readonly type: "string";
+                    }, {
+                      readonly type: "object";
+                      readonly additionalProperties: false;
+                      readonly required: readonly ["source"];
+                      readonly properties: {
+                        readonly source: {
+                          readonly type: "string";
+                          readonly description: "RegExp source.";
+                        };
+                        readonly flags: {
+                          readonly type: "string";
+                          readonly description: "RegExp flags (e.g. 'i').";
+                        };
+                      };
+                    }];
+                  };
+                  readonly handler: {
+                    readonly type: "string";
+                    readonly enum: readonly ["CacheFirst", "CacheOnly", "NetworkFirst", "NetworkOnly", "StaleWhileRevalidate"];
+                  };
+                  readonly method: {
+                    readonly type: "string";
+                    readonly enum: readonly ["GET", "POST", "PUT", "DELETE", "HEAD", "PATCH"];
+                  };
+                  readonly options: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                      readonly cacheName: {
+                        readonly type: "string";
+                      };
+                      readonly networkTimeoutSeconds: {
+                        readonly type: "number";
+                        readonly description: "Seconds a NetworkFirst rule waits for the network before falling back to the cache.";
+                      };
+                      readonly expiration: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                          readonly maxEntries: {
+                            readonly type: "number";
+                          };
+                          readonly maxAgeSeconds: {
+                            readonly type: "number";
+                          };
+                        };
+                      };
+                      readonly cacheableResponse: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                          readonly statuses: {
+                            readonly type: "array";
+                            readonly items: {
+                              readonly type: "number";
+                            };
+                          };
+                          readonly headers: {
+                            readonly type: "object";
+                            readonly additionalProperties: {
+                              readonly type: "string";
+                            };
+                          };
+                        };
+                      };
+                    };
+                  };
+                };
+              };
+            };
+            readonly navigateFallbackDenylist: {
+              readonly type: "array";
+              readonly description: "Extra SPA navigate-fallback denylist patterns, unioned with the built-ins.";
+              readonly items: {
+                readonly description: "URL match. A string is matched verbatim by Workbox; { source, flags } is rebuilt into a RegExp at build time.";
+                readonly oneOf: readonly [{
+                  readonly type: "string";
+                }, {
+                  readonly type: "object";
+                  readonly additionalProperties: false;
+                  readonly required: readonly ["source"];
+                  readonly properties: {
+                    readonly source: {
+                      readonly type: "string";
+                      readonly description: "RegExp source.";
+                    };
+                    readonly flags: {
+                      readonly type: "string";
+                      readonly description: "RegExp flags (e.g. 'i').";
+                    };
+                  };
+                }];
+              };
+            };
+          };
+        };
       };
     };
   };
@@ -2196,5 +2707,5 @@ declare class NodeVersionError extends Error {
 }
 declare function assertNodeVersion(nodeVersion?: string): void;
 //#endregion
-export { AGENTS, ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_PNPM_OVERRIDES, CliInvocationInfo, DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_LOGIN_EXPIRY, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, DrivePreserveStrategies, DrivePreserveStrategy, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, LogLevel, LogLevels, MINIMUM_NODE_VERSION, NodeVersionError, PEER_EXTERNAL_DEPENDENCIES, PHConnectApp, PHConnectBranding, PHConnectDefaultDrive, PHConnectDriveSection, PHConnectDriveSections, PHConnectDrives, PHConnectInstance, PHConnectPackages, PHConnectRenown, PHConnectRuntimeConfig, PHConnectSentry, PHPackageProvider, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, PackageManagerArgs, ParsedCmdResult, PathValidation, PowerhouseConfig, PowerhousePackage, REACTOR_API_PACKAGE, SECONDS_IN_DAY, SERVICE_ACTIONS, SOURCE_CONFIG_SCHEMA_ID, type ServiceAction, ServiceActions, TelemetryClient, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, accessTokenArgs, assertNodeVersion, buildArgs, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectConfigArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, defaultManifest, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, externalDependencies, externalDevDependencies, fetchNpmVersionFromRegistryForTag, fetchPackageVersionFromNpmRegistry, fileExists, fileExistsSync, force, generateArgs, getConfig, getGlobalPowerhouseProjectDirPath, getLocalPowerhouseProjectDirPath, getPackageManagerAtPowerhouseProjectDirPath, getPackageManagerCommand, getPackageNameFromPackageJson, getPackageVersionFromPackageJson, getPhCliVersionInfo, getPhCmdVersionInfo, getPowerhouseProjectInfo, getPowerhouseProjectInstallCommand, getPowerhouseProjectUninstallCommand, getTagFromVersion, getTelemetryStatus, handleMutuallyExclusiveOptions, https, httpsCertFile, httpsKeyFile, initArgs, initCliTelemetry, injectPnpmAllowBuilds, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, makeDependenciesWithVersions, makeVersionedDependencies, makeVersionedDependenciesMap, migrateArgs, packageJsonExports, packageManagerArgs, packageScripts, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, registryLoginArgs, renownNamespace, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, sourceConfigSchema, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
+export { AGENTS, ANALYTICS_ENGINE_CORE_PACKAGE, BOILERPLATE_ALLOWED_BUILDS, BOILERPLATE_PNPM_OVERRIDES, CliInvocationInfo, DEFAULT_CONFIG, DEFAULT_CONNECT_OUTDIR, DEFAULT_CONNECT_PREVIEW_PORT, DEFAULT_CONNECT_STUDIO_PORT, DEFAULT_EXPIRY_DAYS, DEFAULT_EXPIRY_SECONDS, DEFAULT_REGISTRY_LOGIN_EXPIRY, DEFAULT_REGISTRY_URL, DEFAULT_RENOWN_URL, DEFAULT_SWITCHBOARD_PORT, DEFAULT_TIMEOUT, DEFAULT_VETRA_CONNECT_PORT, DEFAULT_VETRA_DRIVE_ID, DRIVES_PRESERVE_STRATEGIES, DrivePreserveStrategies, DrivePreserveStrategy, FEATURE_DEPENDENCIES, GRAPHQL_PACKAGE, GRAPHQL_TAG_PACKAGE, HOME_DIR, LEGACY_LINT_FORMAT_DEPENDENCIES, LEGACY_LINT_FORMAT_FILES, LOG_LEVELS, LogLevel, LogLevels, MINIMUM_NODE_VERSION, NodeVersionError, PEER_EXTERNAL_DEPENDENCIES, PHConnectApp, PHConnectBranding, PHConnectDefaultDrive, PHConnectDriveSection, PHConnectDriveSections, PHConnectDrives, PHConnectInstance, PHConnectPackages, PHConnectPwa, PHConnectPwaCacheStrategy, PHConnectPwaFileHandler, PHConnectPwaIcon, PHConnectPwaManifest, PHConnectPwaRuntimeCaching, PHConnectPwaUrlPattern, PHConnectReactor, PHConnectReactorFeatureFlags, PHConnectRenown, PHConnectRenownAdapters, PHConnectRuntimeConfig, PHConnectSentry, PHPackageProvider, PHReactorRenown, PHRenownPrivyAdapterConfig, PHRenownRainbowAdapterConfig, PH_BIN, PH_GLOBAL_DIR_NAME, PH_GLOBAL_PROJECT_NAME, POWERHOUSE_CONFIG_FILE, POWERHOUSE_GLOBAL_DIR, PROJECT_PORT_BAND_SIZE, PROJECT_PORT_BAND_STUDIO, PROJECT_PORT_BAND_SWITCHBOARD, PROJECT_PORT_BAND_VETRA_CONNECT, PackageManagerArgs, ParsedCmdResult, PathValidation, PowerhouseConfig, PowerhousePackage, REACTOR_API_PACKAGE, SECONDS_IN_DAY, SERVICE_ACTIONS, SOURCE_CONFIG_SCHEMA_ID, type ServiceAction, ServiceActions, TelemetryClient, VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, VERSIONED_PEER_DEPENDENCIES, accessTokenArgs, assertNodeVersion, buildArgs, commonArgs, commonServerArgs, connectArgs, connectBasePath, connectBuildArgs, connectConfigArgs, connectPreviewArgs, connectStudioArgs, debugArgs, defaultDrivesUrl, defaultManifest, directoryExists, directoryExistsSync, disableLocalPackages, drivesPreserveStrategy, externalDependencies, externalDevDependencies, fetchNpmVersionFromRegistryForTag, fetchPackageVersionFromNpmRegistry, fileExists, fileExistsSync, force, generateArgs, getConfig, getGlobalPowerhouseProjectDirPath, getLocalPowerhouseProjectDirPath, getPackageManagerAtPowerhouseProjectDirPath, getPackageManagerCommand, getPackageNameFromPackageJson, getPackageVersionFromPackageJson, getPhCliVersionInfo, getPhCmdVersionInfo, getPowerhouseProjectInfo, getPowerhouseProjectInstallCommand, getPowerhouseProjectUninstallCommand, getTagFromVersion, getTelemetryStatus, handleMutuallyExclusiveOptions, https, httpsCertFile, httpsKeyFile, initArgs, initCliTelemetry, injectPnpmAllowBuilds, inspectArgs, installArgs, isDirectory, isFile, isPowerhouseProject, listArgs, localPackage, logLevel, logVersionUpdate, loginArgs, makeDependenciesWithVersions, makeVersionedDependencies, makeVersionedDependenciesMap, migrateArgs, packageJsonExports, packageManagerArgs, packageScripts, packages, parsePackageManager, parsePackageVersion, parseTag, phCliCommandNames, phCliHelpCommands, publishArgs, registryLoginArgs, renownNamespace, renownSwitchboardUrl, resolveConnectPortDefault, resolveSwitchboardPortDefault, resolveTelemetryConsent, runCmd, runUseLocal, serviceArgs, setTelemetryConsent, sourceConfigSchema, spawnAsync, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs, vetraSwitchboardArgs, writeFileEnsuringDir };
 //# sourceMappingURL=index.d.mts.map