@powerhousedao/shared 6.0.0-dev.104 → 6.0.0-dev.106

package/dist/connect/index.d.ts

@@ -1,2 +1,867 @@
-export * from "./env-config.js";
+import { z } from "zod/v3";
+
+//#region connect/env-config.d.ts
+/**
+ * Build-time configuration schema
+ */
+declare const buildEnvSchema: z.ZodObject<{
+  /**
+   * Path to powerhouse config file
+   * @default "powerhouse.config.json"
+   */
+  PH_CONFIG_PATH: z.ZodOptional<z.ZodString>;
+  /**
+   * Comma-separated list of package names to load
+   * @example "package1,package2"
+   */
+  PH_PACKAGES: z.ZodOptional<z.ZodString>;
+  /**
+   * Path to local package to load during development
+   */
+  PH_LOCAL_PACKAGE: z.ZodOptional<z.ZodString>;
+  /**
+   * Disable loading of local package
+   * @default false
+   */
+  PH_DISABLE_LOCAL_PACKAGE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Amount of time to wait before a file is considered changed
+   * @default 300
+   */
+  PH_WATCH_TIMEOUT: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+  /**
+   * Sentry authentication token for uploading source maps
+   */
+  PH_SENTRY_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry organization slug
+   */
+  PH_SENTRY_ORG: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry project slug
+   */
+  PH_SENTRY_PROJECT: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+  PH_DISABLE_LOCAL_PACKAGE: boolean;
+  PH_WATCH_TIMEOUT: number;
+  PH_CONFIG_PATH?: string | undefined;
+  PH_PACKAGES?: string | undefined;
+  PH_LOCAL_PACKAGE?: string | undefined;
+  PH_SENTRY_AUTH_TOKEN?: string | undefined;
+  PH_SENTRY_ORG?: string | undefined;
+  PH_SENTRY_PROJECT?: string | undefined;
+}, {
+  PH_CONFIG_PATH?: string | undefined;
+  PH_PACKAGES?: string | undefined;
+  PH_LOCAL_PACKAGE?: string | undefined;
+  PH_DISABLE_LOCAL_PACKAGE?: boolean | "true" | "false" | undefined;
+  PH_WATCH_TIMEOUT?: string | number | undefined;
+  PH_SENTRY_AUTH_TOKEN?: string | undefined;
+  PH_SENTRY_ORG?: string | undefined;
+  PH_SENTRY_PROJECT?: string | undefined;
+}>;
+/**
+ * Complete runtime environment schema (all PH_CONNECT_* vars)
+ */
+declare const runtimeEnvSchema: z.ZodObject<{
+  /**
+   * Application version number
+   * @default "unknown"
+   */
+  PH_CONNECT_VERSION: z.ZodDefault<z.ZodString>;
+  /**
+   * Log level for the application
+   * @default "info"
+   */
+  PH_CONNECT_LOG_LEVEL: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+  /**
+   * Whether app requires hard refresh on updates
+   * @default true
+   */
+  PH_CONNECT_REQUIRES_HARD_REFRESH: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Show warning when app version is outdated
+   * @default false
+   */
+  PH_CONNECT_WARN_OUTDATED_APP: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable studio mode features
+   * @default false
+   */
+  PH_CONNECT_STUDIO_MODE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Base path for the Connect router, defaults to import.meta.env.BASE_URL
+   */
+  PH_CONNECT_BASE_PATH: z.ZodOptional<z.ZodString>;
+  /**
+   * Default drives URL to load on startup
+   */
+  PH_CONNECT_DEFAULT_DRIVES_URL: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_PACKAGES: z.ZodOptional<z.ZodString>;
+  /**
+   * URL(s) of the packages registry CDN endpoint.
+   * Supports comma-separated URLs for multiple registries.
+   * @example "http://localhost:8080/-/cdn/"
+   * @example "https://registry.powerhouse.io/-/cdn/,http://localhost:8080/-/cdn/"
+   */
+  PH_CONNECT_PACKAGES_REGISTRY: z.ZodOptional<z.ZodString>;
+  /**
+   * Strategy for preserving drives
+   */
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY: z.ZodOptional<z.ZodString>;
+  /**
+   * Interval in milliseconds to check for version updates
+   * @default 3600000 (1 hour)
+   */
+  PH_CONNECT_VERSION_CHECK_INTERVAL: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+  /**
+   * CLI version number
+   */
+  PH_CONNECT_CLI_VERSION: z.ZodOptional<z.ZodString>;
+  /**
+   * Chunk size for file upload operations
+   * @default 50
+   */
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+} & {
+  /**
+   * Hide the "Add Drive" button completely
+   * @default false
+   */
+  PH_CONNECT_DISABLE_ADD_DRIVE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Show search bar in the UI
+   * @default false
+   */
+  PH_CONNECT_SEARCH_BAR_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Show inspector button in the sidebar
+   * @default false
+   */
+  PH_CONNECT_INSPECTOR_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Hide document model selection in settings
+   * @default true
+   */
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Comma-separated list of enabled editor types
+   * Use "*" to enable all editors
+   * @example "editor1,editor2" or "*"
+   */
+  PH_CONNECT_ENABLED_EDITORS: z.ZodOptional<z.ZodString>;
+  /**
+   * Comma-separated list of disabled editor types
+   * @default "powerhouse/document-drive"
+   */
+  PH_CONNECT_DISABLED_EDITORS: z.ZodDefault<z.ZodString>;
+  /**
+   * Google Analytics tracking ID
+   */
+  PH_CONNECT_GA_TRACKING_ID: z.ZodOptional<z.ZodString>;
+  /**
+   * Disable loading of external packages
+   * @default false
+   */
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable public drives section
+   * @default true
+   */
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow adding public drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow deleting public drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable cloud drives section
+   * @default true
+   */
+  PH_CONNECT_CLOUD_DRIVES_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow adding cloud drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow deleting cloud drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable local drives section
+   * @default true
+   */
+  PH_CONNECT_LOCAL_DRIVES_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow adding local drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow deleting local drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable processors
+   * @default true
+   */
+  PH_CONNECT_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable external processors
+   * @default true
+   */
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable analytics
+   * @default true
+   */
+  PH_CONNECT_ANALYTICS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Name of the analytics database
+   * Defaults to basename + ":analytics"
+   */
+  PH_CONNECT_ANALYTICS_DATABASE_NAME: z.ZodOptional<z.ZodString>;
+  /**
+   * Disable analytics database worker
+   * @default false
+   */
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable diff analytics tracking
+   * @default false
+   */
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable drive analytics tracking
+   * @default true
+   */
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable external analytics processors
+   * @default true
+   */
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable relational processors
+   * @default true
+   */
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable external relational processors
+   * @default true
+   */
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Sentry release identifier
+   * Defaults to app version
+   */
+  PH_CONNECT_SENTRY_RELEASE: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry DSN for error reporting
+   */
+  PH_CONNECT_SENTRY_DSN: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry environment name
+   * @default "prod"
+   */
+  PH_CONNECT_SENTRY_ENV: z.ZodDefault<z.ZodString>;
+  /**
+   * Enable Sentry performance tracing
+   * @default false
+   */
+  PH_CONNECT_SENTRY_TRACING_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Renown authentication service URL
+   * @default "https://www.renown.id"
+   */
+  PH_CONNECT_RENOWN_URL: z.ZodDefault<z.ZodString>;
+  /**
+   * Renown network ID
+   * @default "eip155"
+   */
+  PH_CONNECT_RENOWN_NETWORK_ID: z.ZodDefault<z.ZodString>;
+  /**
+   * Renown chain ID
+   * @default 1
+   */
+  PH_CONNECT_RENOWN_CHAIN_ID: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+}, "strip", z.ZodTypeAny, {
+  PH_CONNECT_VERSION: string;
+  PH_CONNECT_LOG_LEVEL: "debug" | "info" | "warn" | "error";
+  PH_CONNECT_REQUIRES_HARD_REFRESH: boolean;
+  PH_CONNECT_WARN_OUTDATED_APP: boolean;
+  PH_CONNECT_STUDIO_MODE: boolean;
+  PH_CONNECT_VERSION_CHECK_INTERVAL: number;
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: number;
+  PH_CONNECT_DISABLE_ADD_DRIVE: boolean;
+  PH_CONNECT_SEARCH_BAR_ENABLED: boolean;
+  PH_CONNECT_INSPECTOR_ENABLED: boolean;
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS: boolean;
+  PH_CONNECT_DISABLED_EDITORS: string;
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: boolean;
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED: boolean;
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: boolean;
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: boolean;
+  PH_CONNECT_CLOUD_DRIVES_ENABLED: boolean;
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: boolean;
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: boolean;
+  PH_CONNECT_LOCAL_DRIVES_ENABLED: boolean;
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: boolean;
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: boolean;
+  PH_CONNECT_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_ANALYTICS_ENABLED: boolean;
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: boolean;
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED: boolean;
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: boolean;
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_SENTRY_ENV: string;
+  PH_CONNECT_SENTRY_TRACING_ENABLED: boolean;
+  PH_CONNECT_RENOWN_URL: string;
+  PH_CONNECT_RENOWN_NETWORK_ID: string;
+  PH_CONNECT_RENOWN_CHAIN_ID: number;
+  PH_CONNECT_BASE_PATH?: string | undefined;
+  PH_CONNECT_DEFAULT_DRIVES_URL?: string | undefined;
+  PH_CONNECT_PACKAGES?: string | undefined;
+  PH_CONNECT_PACKAGES_REGISTRY?: string | undefined;
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY?: string | undefined;
+  PH_CONNECT_CLI_VERSION?: string | undefined;
+  PH_CONNECT_ENABLED_EDITORS?: string | undefined;
+  PH_CONNECT_GA_TRACKING_ID?: string | undefined;
+  PH_CONNECT_ANALYTICS_DATABASE_NAME?: string | undefined;
+  PH_CONNECT_SENTRY_RELEASE?: string | undefined;
+  PH_CONNECT_SENTRY_DSN?: string | undefined;
+}, {
+  PH_CONNECT_VERSION?: string | undefined;
+  PH_CONNECT_LOG_LEVEL?: "debug" | "info" | "warn" | "error" | undefined;
+  PH_CONNECT_REQUIRES_HARD_REFRESH?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_WARN_OUTDATED_APP?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_STUDIO_MODE?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_BASE_PATH?: string | undefined;
+  PH_CONNECT_DEFAULT_DRIVES_URL?: string | undefined;
+  PH_CONNECT_PACKAGES?: string | undefined;
+  PH_CONNECT_PACKAGES_REGISTRY?: string | undefined;
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY?: string | undefined;
+  PH_CONNECT_VERSION_CHECK_INTERVAL?: string | number | undefined;
+  PH_CONNECT_CLI_VERSION?: string | undefined;
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE?: string | number | undefined;
+  PH_CONNECT_DISABLE_ADD_DRIVE?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_SEARCH_BAR_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_INSPECTOR_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_ENABLED_EDITORS?: string | undefined;
+  PH_CONNECT_DISABLED_EDITORS?: string | undefined;
+  PH_CONNECT_GA_TRACKING_ID?: string | undefined;
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_CLOUD_DRIVES_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_LOCAL_DRIVES_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_ANALYTICS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_ANALYTICS_DATABASE_NAME?: string | undefined;
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_SENTRY_RELEASE?: string | undefined;
+  PH_CONNECT_SENTRY_DSN?: string | undefined;
+  PH_CONNECT_SENTRY_ENV?: string | undefined;
+  PH_CONNECT_SENTRY_TRACING_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_RENOWN_URL?: string | undefined;
+  PH_CONNECT_RENOWN_NETWORK_ID?: string | undefined;
+  PH_CONNECT_RENOWN_CHAIN_ID?: string | number | undefined;
+}>;
+/**
+ * Complete environment schema (build + runtime)
+ */
+declare const connectEnvSchema: z.ZodObject<{
+  /**
+   * Path to powerhouse config file
+   * @default "powerhouse.config.json"
+   */
+  PH_CONFIG_PATH: z.ZodOptional<z.ZodString>;
+  /**
+   * Comma-separated list of package names to load
+   * @example "package1,package2"
+   */
+  PH_PACKAGES: z.ZodOptional<z.ZodString>;
+  /**
+   * Path to local package to load during development
+   */
+  PH_LOCAL_PACKAGE: z.ZodOptional<z.ZodString>;
+  /**
+   * Disable loading of local package
+   * @default false
+   */
+  PH_DISABLE_LOCAL_PACKAGE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Amount of time to wait before a file is considered changed
+   * @default 300
+   */
+  PH_WATCH_TIMEOUT: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+  /**
+   * Sentry authentication token for uploading source maps
+   */
+  PH_SENTRY_AUTH_TOKEN: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry organization slug
+   */
+  PH_SENTRY_ORG: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry project slug
+   */
+  PH_SENTRY_PROJECT: z.ZodOptional<z.ZodString>;
+} & {
+  /**
+   * Application version number
+   * @default "unknown"
+   */
+  PH_CONNECT_VERSION: z.ZodDefault<z.ZodString>;
+  /**
+   * Log level for the application
+   * @default "info"
+   */
+  PH_CONNECT_LOG_LEVEL: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+  /**
+   * Whether app requires hard refresh on updates
+   * @default true
+   */
+  PH_CONNECT_REQUIRES_HARD_REFRESH: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Show warning when app version is outdated
+   * @default false
+   */
+  PH_CONNECT_WARN_OUTDATED_APP: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable studio mode features
+   * @default false
+   */
+  PH_CONNECT_STUDIO_MODE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Base path for the Connect router, defaults to import.meta.env.BASE_URL
+   */
+  PH_CONNECT_BASE_PATH: z.ZodOptional<z.ZodString>;
+  /**
+   * Default drives URL to load on startup
+   */
+  PH_CONNECT_DEFAULT_DRIVES_URL: z.ZodOptional<z.ZodString>;
+  PH_CONNECT_PACKAGES: z.ZodOptional<z.ZodString>;
+  /**
+   * URL(s) of the packages registry CDN endpoint.
+   * Supports comma-separated URLs for multiple registries.
+   * @example "http://localhost:8080/-/cdn/"
+   * @example "https://registry.powerhouse.io/-/cdn/,http://localhost:8080/-/cdn/"
+   */
+  PH_CONNECT_PACKAGES_REGISTRY: z.ZodOptional<z.ZodString>;
+  /**
+   * Strategy for preserving drives
+   */
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY: z.ZodOptional<z.ZodString>;
+  /**
+   * Interval in milliseconds to check for version updates
+   * @default 3600000 (1 hour)
+   */
+  PH_CONNECT_VERSION_CHECK_INTERVAL: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+  /**
+   * CLI version number
+   */
+  PH_CONNECT_CLI_VERSION: z.ZodOptional<z.ZodString>;
+  /**
+   * Chunk size for file upload operations
+   * @default 50
+   */
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+} & {
+  /**
+   * Hide the "Add Drive" button completely
+   * @default false
+   */
+  PH_CONNECT_DISABLE_ADD_DRIVE: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Show search bar in the UI
+   * @default false
+   */
+  PH_CONNECT_SEARCH_BAR_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Show inspector button in the sidebar
+   * @default false
+   */
+  PH_CONNECT_INSPECTOR_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Hide document model selection in settings
+   * @default true
+   */
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Comma-separated list of enabled editor types
+   * Use "*" to enable all editors
+   * @example "editor1,editor2" or "*"
+   */
+  PH_CONNECT_ENABLED_EDITORS: z.ZodOptional<z.ZodString>;
+  /**
+   * Comma-separated list of disabled editor types
+   * @default "powerhouse/document-drive"
+   */
+  PH_CONNECT_DISABLED_EDITORS: z.ZodDefault<z.ZodString>;
+  /**
+   * Google Analytics tracking ID
+   */
+  PH_CONNECT_GA_TRACKING_ID: z.ZodOptional<z.ZodString>;
+  /**
+   * Disable loading of external packages
+   * @default false
+   */
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable public drives section
+   * @default true
+   */
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow adding public drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow deleting public drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable cloud drives section
+   * @default true
+   */
+  PH_CONNECT_CLOUD_DRIVES_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow adding cloud drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow deleting cloud drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable local drives section
+   * @default true
+   */
+  PH_CONNECT_LOCAL_DRIVES_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow adding local drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Allow deleting local drives
+   * @default true
+   */
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable processors
+   * @default true
+   */
+  PH_CONNECT_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable external processors
+   * @default true
+   */
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable analytics
+   * @default true
+   */
+  PH_CONNECT_ANALYTICS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Name of the analytics database
+   * Defaults to basename + ":analytics"
+   */
+  PH_CONNECT_ANALYTICS_DATABASE_NAME: z.ZodOptional<z.ZodString>;
+  /**
+   * Disable analytics database worker
+   * @default false
+   */
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable diff analytics tracking
+   * @default false
+   */
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable drive analytics tracking
+   * @default true
+   */
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable external analytics processors
+   * @default true
+   */
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Enable relational processors
+   * @default true
+   */
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+  /**
+   * Enable external relational processors
+   * @default true
+   */
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Sentry release identifier
+   * Defaults to app version
+   */
+  PH_CONNECT_SENTRY_RELEASE: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry DSN for error reporting
+   */
+  PH_CONNECT_SENTRY_DSN: z.ZodOptional<z.ZodString>;
+  /**
+   * Sentry environment name
+   * @default "prod"
+   */
+  PH_CONNECT_SENTRY_ENV: z.ZodDefault<z.ZodString>;
+  /**
+   * Enable Sentry performance tracing
+   * @default false
+   */
+  PH_CONNECT_SENTRY_TRACING_ENABLED: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>;
+} & {
+  /**
+   * Renown authentication service URL
+   * @default "https://www.renown.id"
+   */
+  PH_CONNECT_RENOWN_URL: z.ZodDefault<z.ZodString>;
+  /**
+   * Renown network ID
+   * @default "eip155"
+   */
+  PH_CONNECT_RENOWN_NETWORK_ID: z.ZodDefault<z.ZodString>;
+  /**
+   * Renown chain ID
+   * @default 1
+   */
+  PH_CONNECT_RENOWN_CHAIN_ID: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodNumber, z.ZodString]>, number, string | number>>;
+}, "strip", z.ZodTypeAny, {
+  PH_CONNECT_VERSION: string;
+  PH_CONNECT_LOG_LEVEL: "debug" | "info" | "warn" | "error";
+  PH_CONNECT_REQUIRES_HARD_REFRESH: boolean;
+  PH_CONNECT_WARN_OUTDATED_APP: boolean;
+  PH_CONNECT_STUDIO_MODE: boolean;
+  PH_CONNECT_VERSION_CHECK_INTERVAL: number;
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE: number;
+  PH_CONNECT_DISABLE_ADD_DRIVE: boolean;
+  PH_CONNECT_SEARCH_BAR_ENABLED: boolean;
+  PH_CONNECT_INSPECTOR_ENABLED: boolean;
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS: boolean;
+  PH_CONNECT_DISABLED_EDITORS: string;
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED: boolean;
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED: boolean;
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES: boolean;
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES: boolean;
+  PH_CONNECT_CLOUD_DRIVES_ENABLED: boolean;
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES: boolean;
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES: boolean;
+  PH_CONNECT_LOCAL_DRIVES_ENABLED: boolean;
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES: boolean;
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES: boolean;
+  PH_CONNECT_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_ANALYTICS_ENABLED: boolean;
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED: boolean;
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED: boolean;
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED: boolean;
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED: boolean;
+  PH_CONNECT_SENTRY_ENV: string;
+  PH_CONNECT_SENTRY_TRACING_ENABLED: boolean;
+  PH_CONNECT_RENOWN_URL: string;
+  PH_CONNECT_RENOWN_NETWORK_ID: string;
+  PH_CONNECT_RENOWN_CHAIN_ID: number;
+  PH_DISABLE_LOCAL_PACKAGE: boolean;
+  PH_WATCH_TIMEOUT: number;
+  PH_CONNECT_BASE_PATH?: string | undefined;
+  PH_CONNECT_DEFAULT_DRIVES_URL?: string | undefined;
+  PH_CONNECT_PACKAGES?: string | undefined;
+  PH_CONNECT_PACKAGES_REGISTRY?: string | undefined;
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY?: string | undefined;
+  PH_CONNECT_CLI_VERSION?: string | undefined;
+  PH_CONNECT_ENABLED_EDITORS?: string | undefined;
+  PH_CONNECT_GA_TRACKING_ID?: string | undefined;
+  PH_CONNECT_ANALYTICS_DATABASE_NAME?: string | undefined;
+  PH_CONNECT_SENTRY_RELEASE?: string | undefined;
+  PH_CONNECT_SENTRY_DSN?: string | undefined;
+  PH_CONFIG_PATH?: string | undefined;
+  PH_PACKAGES?: string | undefined;
+  PH_LOCAL_PACKAGE?: string | undefined;
+  PH_SENTRY_AUTH_TOKEN?: string | undefined;
+  PH_SENTRY_ORG?: string | undefined;
+  PH_SENTRY_PROJECT?: string | undefined;
+}, {
+  PH_CONNECT_VERSION?: string | undefined;
+  PH_CONNECT_LOG_LEVEL?: "debug" | "info" | "warn" | "error" | undefined;
+  PH_CONNECT_REQUIRES_HARD_REFRESH?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_WARN_OUTDATED_APP?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_STUDIO_MODE?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_BASE_PATH?: string | undefined;
+  PH_CONNECT_DEFAULT_DRIVES_URL?: string | undefined;
+  PH_CONNECT_PACKAGES?: string | undefined;
+  PH_CONNECT_PACKAGES_REGISTRY?: string | undefined;
+  PH_CONNECT_DRIVES_PRESERVE_STRATEGY?: string | undefined;
+  PH_CONNECT_VERSION_CHECK_INTERVAL?: string | number | undefined;
+  PH_CONNECT_CLI_VERSION?: string | undefined;
+  PH_CONNECT_FILE_UPLOAD_OPERATIONS_CHUNK_SIZE?: string | number | undefined;
+  PH_CONNECT_DISABLE_ADD_DRIVE?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_SEARCH_BAR_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_INSPECTOR_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_HIDE_DOCUMENT_MODEL_SELECTION_SETTINGS?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_ENABLED_EDITORS?: string | undefined;
+  PH_CONNECT_DISABLED_EDITORS?: string | undefined;
+  PH_CONNECT_GA_TRACKING_ID?: string | undefined;
+  PH_CONNECT_EXTERNAL_PACKAGES_DISABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_PUBLIC_DRIVES_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_ADD_PUBLIC_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_DELETE_PUBLIC_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_CLOUD_DRIVES_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_ADD_CLOUD_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_DELETE_CLOUD_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_LOCAL_DRIVES_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_ADD_LOCAL_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DISABLE_DELETE_LOCAL_DRIVES?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_EXTERNAL_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_ANALYTICS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_ANALYTICS_DATABASE_NAME?: string | undefined;
+  PH_CONNECT_ANALYTICS_DATABASE_WORKER_DISABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DIFF_ANALYTICS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_DRIVE_ANALYTICS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_EXTERNAL_ANALYTICS_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_RELATIONAL_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_EXTERNAL_RELATIONAL_PROCESSORS_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_SENTRY_RELEASE?: string | undefined;
+  PH_CONNECT_SENTRY_DSN?: string | undefined;
+  PH_CONNECT_SENTRY_ENV?: string | undefined;
+  PH_CONNECT_SENTRY_TRACING_ENABLED?: boolean | "true" | "false" | undefined;
+  PH_CONNECT_RENOWN_URL?: string | undefined;
+  PH_CONNECT_RENOWN_NETWORK_ID?: string | undefined;
+  PH_CONNECT_RENOWN_CHAIN_ID?: string | number | undefined;
+  PH_CONFIG_PATH?: string | undefined;
+  PH_PACKAGES?: string | undefined;
+  PH_LOCAL_PACKAGE?: string | undefined;
+  PH_DISABLE_LOCAL_PACKAGE?: boolean | "true" | "false" | undefined;
+  PH_WATCH_TIMEOUT?: string | number | undefined;
+  PH_SENTRY_AUTH_TOKEN?: string | undefined;
+  PH_SENTRY_ORG?: string | undefined;
+  PH_SENTRY_PROJECT?: string | undefined;
+}>;
+/**
+ * Inferred TypeScript types from schemas
+ */
+type ConnectBuildEnv = z.infer<typeof buildEnvSchema>;
+type ConnectRuntimeEnv = z.infer<typeof runtimeEnvSchema>;
+type ConnectEnv = z.infer<typeof connectEnvSchema>;
+/**
+ * Options for loading environment variables
+ */
+interface LoadEnvOptions {
+  /**
+   * Environment variables from process.env (highest priority)
+   */
+  processEnv?: Record<string, string | undefined>;
+  /**
+   * Environment variables from .env file (lowest priority)
+   */
+  fileEnv?: Record<string, string | undefined>;
+}
+/**
+ * Loads and validates environment variables with priority:
+ * 1. process.env (highest)
+ * 2. options
+ * 3. fileEnv
+ * 4. defaults from schema (lowest)
+ *
+ * @param options - Environment sources in priority order
+ * @returns Validated and typed environment configuration
+ */
+declare function loadConnectEnv(options?: LoadEnvOptions): ConnectEnv;
+/**
+ * Loads only runtime environment variables
+ *
+ * @param options - Environment sources in priority order
+ * @returns Validated runtime environment configuration
+ */
+declare function loadRuntimeEnv(options?: LoadEnvOptions): ConnectRuntimeEnv;
+/**
+ * Loads only build-time environment variables
+ *
+ * @param options - Environment sources in priority order
+ * @returns Validated build environment configuration
+ */
+declare function loadBuildEnv(options?: LoadEnvOptions): ConnectBuildEnv;
+/**
+ * Safely sets Connect environment variables with validation.
+ * Invalid values will log a warning and be skipped.
+ *
+ * @param values - Type-safe object with key-value pairs to set
+ *
+ * @example
+ * ```ts
+ * setConnectEnv({
+ *   PH_CONNECT_LOG_LEVEL: "debug",
+ *   PH_CONNECT_VERSION: "1.2.3",
+ *   PH_CONNECT_STUDIO_MODE: true,
+ * });
+ * ```
+ */
+declare function setConnectEnv(values: Partial<ConnectEnv>): void;
+/**
+ * Normalizes a base path to ensure it:
+ * - Starts with a forward slash (/)
+ * - Ends with a forward slash (/)
+ * - Has no relative path prefix (.)
+ *
+ * @param basePath - The base path to normalize
+ * @returns The normalized base path
+ *
+ * @example
+ * normalizeBasePath('/app') // '/app/'
+ * normalizeBasePath('./app/') // '/app/'
+ * normalizeBasePath('app') // '/app/'
+ * normalizeBasePath('/') // '/'
+ * normalizeBasePath('') // '/'
+ */
+declare function normalizeBasePath(basePath: string): string;
+//#endregion
+export { ConnectBuildEnv, ConnectEnv, ConnectRuntimeEnv, LoadEnvOptions, connectEnvSchema, loadBuildEnv, loadConnectEnv, loadRuntimeEnv, normalizeBasePath, runtimeEnvSchema, setConnectEnv };
 //# sourceMappingURL=index.d.ts.map