@jahia/jahia-cli 0.1.3 → 0.2.0

package/dist/lib/state/delete-state.js

@@ -0,0 +1,16 @@
+import { rm } from 'node:fs/promises';
+import { stateFilePath } from './state-file-path.js';
+/**
+ * Deletes the state file from disk.
+ * No-op if the file does not exist.
+ */
+export const deleteState = async (statePath) => {
+    const path = stateFilePath(statePath);
+    try {
+        await rm(path);
+    }
+    catch {
+        // File may not exist — that's fine
+    }
+};
+//# sourceMappingURL=delete-state.js.map

package/dist/lib/state/delete-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-state.js","sourceRoot":"","sources":["../../../src/lib/state/delete-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,SAAkB,EAAiB,EAAE;IACrE,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;AACH,CAAC,CAAC"}

package/dist/lib/state/get-active-environment.d.ts

@@ -0,0 +1,6 @@
+import type { PersistedEnvironment } from './types.js';
+/**
+ * Returns the currently active environment from state, or undefined if none exists.
+ */
+export declare const getActiveEnvironment: (statePath?: string) => Promise<PersistedEnvironment | undefined>;
+//# sourceMappingURL=get-active-environment.d.ts.map

package/dist/lib/state/get-active-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-environment.d.ts","sourceRoot":"","sources":["../../../src/lib/state/get-active-environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,MAAM,KACjB,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAG1C,CAAC"}

package/dist/lib/state/get-active-environment.js

@@ -0,0 +1,9 @@
+import { loadState } from './load-state.js';
+/**
+ * Returns the currently active environment from state, or undefined if none exists.
+ */
+export const getActiveEnvironment = async (statePath) => {
+    const state = await loadState(statePath);
+    return state?.environment;
+};
+//# sourceMappingURL=get-active-environment.js.map

package/dist/lib/state/get-active-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-active-environment.js","sourceRoot":"","sources":["../../../src/lib/state/get-active-environment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,SAAkB,EACyB,EAAE;IAC7C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,KAAK,EAAE,WAAW,CAAC;AAC5B,CAAC,CAAC"}

package/dist/lib/state/get-jahia-connection-defaults.d.ts

@@ -0,0 +1,16 @@
+import type { PersistedEnvironment } from './types.js';
+/**
+ * Connection details for a Jahia instance, derived from environment state.
+ */
+export interface JahiaConnectionDefaults {
+    readonly url: string;
+    readonly username: string;
+    readonly password: string;
+}
+/**
+ * Extracts Jahia connection defaults from the persisted environment state.
+ * Looks for a 'jahia' component to determine the host port and password.
+ * Falls back to hardcoded defaults when state is unavailable or incomplete.
+ */
+export declare const getJahiaConnectionDefaults: (env: PersistedEnvironment | undefined) => JahiaConnectionDefaults;
+//# sourceMappingURL=get-jahia-connection-defaults.d.ts.map

package/dist/lib/state/get-jahia-connection-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-jahia-connection-defaults.d.ts","sourceRoot":"","sources":["../../../src/lib/state/get-jahia-connection-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,KAAK,oBAAoB,GAAG,SAAS,KACpC,uBAqBF,CAAC"}

package/dist/lib/state/get-jahia-connection-defaults.js

@@ -0,0 +1,28 @@
+import { COMPONENT_REGISTRY } from '../components/index.js';
+import { resolveEnvVars } from '../config/resolve-env-vars.js';
+const DEFAULT_URL = 'http://localhost:8080';
+const DEFAULT_USERNAME = 'root';
+const DEFAULT_PASSWORD = 'root1234';
+/**
+ * Extracts Jahia connection defaults from the persisted environment state.
+ * Looks for a 'jahia' component to determine the host port and password.
+ * Falls back to hardcoded defaults when state is unavailable or incomplete.
+ */
+export const getJahiaConnectionDefaults = (env) => {
+    if (env === undefined) {
+        return { url: DEFAULT_URL, username: DEFAULT_USERNAME, password: DEFAULT_PASSWORD };
+    }
+    const jahiaConfig = env.config.components.find((c) => c.name === 'jahia');
+    const jahiaDef = COMPONENT_REGISTRY['jahia'];
+    // Resolve the host port: override → definition default → 8080
+    const portMapping = jahiaConfig?.overrides?.ports?.[0] ?? jahiaDef?.ports[0];
+    const port = portMapping?.host ?? 8080;
+    const url = `http://localhost:${String(port)}`;
+    // Resolve password: override env → definition env (with env var resolution) → default
+    const rawPassword = jahiaConfig?.overrides?.env?.['SUPER_USER_PASSWORD'] ??
+        jahiaDef?.env['SUPER_USER_PASSWORD'] ??
+        DEFAULT_PASSWORD;
+    const password = resolveEnvVars(rawPassword);
+    return { url, username: DEFAULT_USERNAME, password };
+};
+//# sourceMappingURL=get-jahia-connection-defaults.js.map

package/dist/lib/state/get-jahia-connection-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-jahia-connection-defaults.js","sourceRoot":"","sources":["../../../src/lib/state/get-jahia-connection-defaults.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAW/D,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAC5C,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,GAAqC,EACZ,EAAE;IAC3B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IACtF,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE7C,8DAA8D;IAC9D,MAAM,WAAW,GAAG,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,WAAW,EAAE,IAAI,IAAI,IAAI,CAAC;IACvC,MAAM,GAAG,GAAG,oBAAoB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAE/C,sFAAsF;IACtF,MAAM,WAAW,GACf,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC;QACpD,QAAQ,EAAE,GAAG,CAAC,qBAAqB,CAAC;QACpC,gBAAgB,CAAC;IACnB,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAE7C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC;AACvD,CAAC,CAAC"}

package/dist/lib/state/has-active-environment.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns true if there is an active environment in the state file.
+ */
+export declare const hasActiveEnvironment: (statePath?: string) => Promise<boolean>;
+//# sourceMappingURL=has-active-environment.d.ts.map

package/dist/lib/state/has-active-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-active-environment.d.ts","sourceRoot":"","sources":["../../../src/lib/state/has-active-environment.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,OAAO,CAG9E,CAAC"}

package/dist/lib/state/has-active-environment.js

@@ -0,0 +1,9 @@
+import { loadState } from './load-state.js';
+/**
+ * Returns true if there is an active environment in the state file.
+ */
+export const hasActiveEnvironment = async (statePath) => {
+    const state = await loadState(statePath);
+    return state?.environment !== undefined;
+};
+//# sourceMappingURL=has-active-environment.js.map

package/dist/lib/state/has-active-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-active-environment.js","sourceRoot":"","sources":["../../../src/lib/state/has-active-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,SAAkB,EAAoB,EAAE;IACjF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,KAAK,EAAE,WAAW,KAAK,SAAS,CAAC;AAC1C,CAAC,CAAC"}

package/dist/lib/state/index.d.ts

@@ -0,0 +1,11 @@
+export type { PersistedComponent, PersistedEnvironment, StateFile } from './types.js';
+export { stateFilePath } from './state-file-path.js';
+export { loadState } from './load-state.js';
+export { saveState } from './save-state.js';
+export { deleteState } from './delete-state.js';
+export { getActiveEnvironment } from './get-active-environment.js';
+export { hasActiveEnvironment } from './has-active-environment.js';
+export { reconcileWithDocker } from './reconcile-with-docker.js';
+export type { ReconciledComponent, ReconciledEnvironment } from './reconcile-with-docker.js';
+export { stateFlag } from './state-flag.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/state/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/lib/state/index.js

@@ -0,0 +1,9 @@
+export { stateFilePath } from './state-file-path.js';
+export { loadState } from './load-state.js';
+export { saveState } from './save-state.js';
+export { deleteState } from './delete-state.js';
+export { getActiveEnvironment } from './get-active-environment.js';
+export { hasActiveEnvironment } from './has-active-environment.js';
+export { reconcileWithDocker } from './reconcile-with-docker.js';
+export { stateFlag } from './state-flag.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/state/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/lib/state/load-state.d.ts

@@ -0,0 +1,7 @@
+import type { StateFile } from './types.js';
+/**
+ * Loads the state file from disk.
+ * Returns undefined if the file does not exist or is unreadable.
+ */
+export declare const loadState: (statePath?: string) => Promise<StateFile | undefined>;
+//# sourceMappingURL=load-state.d.ts.map

package/dist/lib/state/load-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-state.d.ts","sourceRoot":"","sources":["../../../src/lib/state/load-state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAQjF,CAAC"}

package/dist/lib/state/load-state.js

@@ -0,0 +1,17 @@
+import { readFile } from 'node:fs/promises';
+import { stateFilePath } from './state-file-path.js';
+/**
+ * Loads the state file from disk.
+ * Returns undefined if the file does not exist or is unreadable.
+ */
+export const loadState = async (statePath) => {
+    const path = stateFilePath(statePath);
+    try {
+        const content = await readFile(path, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+};
+//# sourceMappingURL=load-state.js.map

package/dist/lib/state/load-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-state.js","sourceRoot":"","sources":["../../../src/lib/state/load-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,SAAkB,EAAkC,EAAE;IACpF,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC"}

package/dist/lib/state/reconcile-with-docker.d.ts

@@ -0,0 +1,19 @@
+import type { PersistedComponent, PersistedEnvironment } from './types.js';
+/**
+ * Reconciled component with live Docker status.
+ */
+export interface ReconciledComponent extends PersistedComponent {
+    readonly liveStatus: 'running' | 'stopped' | 'missing';
+}
+/**
+ * Reconciled environment with live Docker status on each component.
+ */
+export interface ReconciledEnvironment extends Omit<PersistedEnvironment, 'components'> {
+    readonly components: readonly ReconciledComponent[];
+}
+/**
+ * Reconciles the persisted environment state with live Docker container status.
+ * Checks each container and annotates with its actual status.
+ */
+export declare const reconcileWithDocker: (environment: PersistedEnvironment) => Promise<ReconciledEnvironment>;
+//# sourceMappingURL=reconcile-with-docker.d.ts.map

package/dist/lib/state/reconcile-with-docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-with-docker.d.ts","sourceRoot":"","sources":["../../../src/lib/state/reconcile-with-docker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAwB3E;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC;IACrF,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACrD;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,aAAa,oBAAoB,KAChC,OAAO,CAAC,qBAAqB,CAY/B,CAAC"}

package/dist/lib/state/reconcile-with-docker.js

@@ -0,0 +1,36 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Checks whether a container is still running in Docker.
+ * Returns 'running', 'stopped', or 'missing'.
+ */
+const checkContainerStatus = async (containerId) => {
+    try {
+        const { stdout } = await execFileAsync('docker', [
+            'inspect',
+            '--format',
+            '{{.State.Running}}',
+            containerId,
+        ]);
+        return stdout.trim() === 'true' ? 'running' : 'stopped';
+    }
+    catch {
+        return 'missing';
+    }
+};
+/**
+ * Reconciles the persisted environment state with live Docker container status.
+ * Checks each container and annotates with its actual status.
+ */
+export const reconcileWithDocker = async (environment) => {
+    const reconciledComponents = await Promise.all(environment.components.map(async (comp) => {
+        const liveStatus = await checkContainerStatus(comp.containerId);
+        return { ...comp, liveStatus };
+    }));
+    return {
+        ...environment,
+        components: reconciledComponents,
+    };
+};
+//# sourceMappingURL=reconcile-with-docker.js.map

package/dist/lib/state/reconcile-with-docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-with-docker.js","sourceRoot":"","sources":["../../../src/lib/state/reconcile-with-docker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,oBAAoB,GAAG,KAAK,EAChC,WAAmB,EACyB,EAAE;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE;YAC/C,SAAS;YACT,UAAU;YACV,oBAAoB;YACpB,WAAW;SACZ,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAgBF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,WAAiC,EACD,EAAE;IAClC,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5C,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAgC,EAAE;QACtE,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChE,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC,CAAC,CACH,CAAC;IAEF,OAAO;QACL,GAAG,WAAW;QACd,UAAU,EAAE,oBAAoB;KACjC,CAAC;AACJ,CAAC,CAAC"}

package/dist/lib/state/save-state.d.ts

@@ -0,0 +1,7 @@
+import type { StateFile } from './types.js';
+/**
+ * Saves the state file to disk.
+ * Creates the directory if it does not exist.
+ */
+export declare const saveState: (state: StateFile, statePath?: string) => Promise<void>;
+//# sourceMappingURL=save-state.d.ts.map

package/dist/lib/state/save-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-state.d.ts","sourceRoot":"","sources":["../../../src/lib/state/save-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;GAGG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO,SAAS,EAChB,YAAY,MAAM,KACjB,OAAO,CAAC,IAAI,CAId,CAAC"}

package/dist/lib/state/save-state.js

@@ -0,0 +1,13 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { stateFilePath } from './state-file-path.js';
+/**
+ * Saves the state file to disk.
+ * Creates the directory if it does not exist.
+ */
+export const saveState = async (state, statePath) => {
+    const path = stateFilePath(statePath);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(state, null, 2), 'utf-8');
+};
+//# sourceMappingURL=save-state.js.map

package/dist/lib/state/save-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-state.js","sourceRoot":"","sources":["../../../src/lib/state/save-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,KAAgB,EAChB,SAAkB,EACH,EAAE;IACjB,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC,CAAC"}

package/dist/lib/state/state-file-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolves the state file path.
+ * Priority: explicit statePath param > JAHIA_CLI_STATE env var >
+ * JAHIA_CLI_STATE_DIR env var (legacy, resolved to <dir>/state.json) >
+ * default (~/.jahia-cli/state.json).
+ */
+export declare const stateFilePath: (statePath?: string) => string;
+//# sourceMappingURL=state-file-path.d.ts.map

package/dist/lib/state/state-file-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-file-path.d.ts","sourceRoot":"","sources":["../../../src/lib/state/state-file-path.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,KAAG,MAIlD,CAAC"}

package/dist/lib/state/state-file-path.js

@@ -0,0 +1,14 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Resolves the state file path.
+ * Priority: explicit statePath param > JAHIA_CLI_STATE env var >
+ * JAHIA_CLI_STATE_DIR env var (legacy, resolved to <dir>/state.json) >
+ * default (~/.jahia-cli/state.json).
+ */
+export const stateFilePath = (statePath) => {
+    const legacyStateDir = process.env['JAHIA_CLI_STATE_DIR'];
+    const legacyStatePath = legacyStateDir ? join(legacyStateDir, 'state.json') : undefined;
+    return statePath ?? process.env['JAHIA_CLI_STATE'] ?? legacyStatePath ?? join(homedir(), '.jahia-cli', 'state.json');
+};
+//# sourceMappingURL=state-file-path.js.map

package/dist/lib/state/state-file-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-file-path.js","sourceRoot":"","sources":["../../../src/lib/state/state-file-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAkB,EAAU,EAAE;IAC1D,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,OAAO,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AACvH,CAAC,CAAC"}

package/dist/lib/state/state-flag.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared OCLIF flag definition for --state.
+ * Spread into any command's static flags that reads or writes state.
+ */
+export declare const stateFlag: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+//# sourceMappingURL=state-flag.d.ts.map

package/dist/lib/state/state-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-flag.d.ts","sourceRoot":"","sources":["../../../src/lib/state/state-flag.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,SAAS,iHAMpB,CAAC"}

package/dist/lib/state/state-flag.js

@@ -0,0 +1,12 @@
+import { Flags } from '@oclif/core';
+/**
+ * Shared OCLIF flag definition for --state.
+ * Spread into any command's static flags that reads or writes state.
+ */
+export const stateFlag = Flags.string({
+    description: 'Path to the state JSON file. ' +
+        'Overrides JAHIA_CLI_STATE env var. ' +
+        'Defaults to ~/.jahia-cli/state.json',
+    env: 'JAHIA_CLI_STATE',
+});
+//# sourceMappingURL=state-flag.js.map

package/dist/lib/state/state-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-flag.js","sourceRoot":"","sources":["../../../src/lib/state/state-flag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,WAAW,EACT,+BAA+B;QAC/B,qCAAqC;QACrC,qCAAqC;IACvC,GAAG,EAAE,iBAAiB;CACvB,CAAC,CAAC"}

package/dist/lib/state/types.d.ts

@@ -0,0 +1,30 @@
+import type { EnvironmentConfig } from '../config/types.js';
+/**
+ * A persisted component entry — tracks container identity for lifecycle ops.
+ */
+export interface PersistedComponent {
+    readonly name: string;
+    readonly image: string;
+    readonly tag: string;
+    readonly containerId: string;
+}
+/**
+ * Full persisted environment state — stored in the state file.
+ */
+export interface PersistedEnvironment {
+    readonly name: string;
+    readonly provider: string;
+    readonly network: string;
+    readonly components: readonly PersistedComponent[];
+    readonly config: EnvironmentConfig;
+    readonly createdAt: string;
+    readonly stoppedAt?: string | undefined;
+}
+/**
+ * Top-level state file structure with schema version.
+ */
+export interface StateFile {
+    readonly version: 1;
+    readonly environment?: PersistedEnvironment | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/state/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACzD"}

package/dist/lib/state/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/state/types.ts"],"names":[],"mappings":""}

package/dist/lib/tests/clone-scaffolding.d.ts

@@ -0,0 +1,16 @@
+import type { ScaffoldingCloneResult } from './types.js';
+export declare const DEFAULT_CYPRESS_REPOSITORY = "https://github.com/Jahia/jahia-cypress.git";
+export declare const buildCloneArgs: (params: {
+    readonly version: string;
+    readonly repositoryUrl: string;
+    readonly checkoutDir: string;
+}) => readonly string[];
+export declare const parseLatestTagFromLsRemote: (stdout: string, repositoryUrl: string) => string;
+export declare const resolveLatestTag: (repositoryUrl?: string) => Promise<string>;
+export declare const cloneScaffolding: (params: {
+    readonly version?: string | undefined;
+    readonly workDir: string;
+    readonly repositoryUrl?: string | undefined;
+    readonly scaffoldingPath?: string | undefined;
+}) => Promise<ScaffoldingCloneResult>;
+//# sourceMappingURL=clone-scaffolding.d.ts.map

package/dist/lib/tests/clone-scaffolding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-scaffolding.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/clone-scaffolding.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,eAAO,MAAM,0BAA0B,+CAA+C,CAAC;AAMvF,eAAO,MAAM,cAAc,GAAI,QAAQ;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,KAAG,SAAS,MAAM,EAQlB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,QAAQ,MAAM,EAAE,eAAe,MAAM,KAAG,MAgBlF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,gBAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,CAW7E,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,QAAQ;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C,KAAG,OAAO,CAAC,sBAAsB,CAyBjC,CAAC"}

package/dist/lib/tests/clone-scaffolding.js

@@ -0,0 +1,64 @@
+import { execFile } from 'node:child_process';
+import { access, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+export const DEFAULT_CYPRESS_REPOSITORY = 'https://github.com/Jahia/jahia-cypress.git';
+const DEFAULT_CHECKOUT_DIRNAME = 'jahia-cypress';
+const TAG_PREFIX = 'refs/tags/';
+const execFileAsync = promisify(execFile);
+export const buildCloneArgs = (params) => [
+    'clone',
+    '--depth',
+    '1',
+    '--branch',
+    params.version,
+    params.repositoryUrl,
+    params.checkoutDir,
+];
+export const parseLatestTagFromLsRemote = (stdout, repositoryUrl) => {
+    const firstLine = stdout
+        .split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    if (!firstLine) {
+        throw new Error(`No tags found for ${repositoryUrl}.`);
+    }
+    const ref = firstLine.split(/\s+/)[1];
+    if (!ref?.startsWith(TAG_PREFIX)) {
+        throw new Error(`Unable to resolve latest tag from git output for ${repositoryUrl}.`);
+    }
+    return ref.slice(TAG_PREFIX.length);
+};
+export const resolveLatestTag = async (repositoryUrl) => {
+    const url = repositoryUrl ?? DEFAULT_CYPRESS_REPOSITORY;
+    const { stdout } = await execFileAsync('git', [
+        'ls-remote',
+        '--tags',
+        '--refs',
+        '--sort=-v:refname',
+        url,
+    ]);
+    return parseLatestTagFromLsRemote(stdout, url);
+};
+export const cloneScaffolding = async (params) => {
+    const repositoryUrl = params.repositoryUrl ?? DEFAULT_CYPRESS_REPOSITORY;
+    const version = params.version ?? (await resolveLatestTag(repositoryUrl));
+    const checkoutDir = join(params.workDir, DEFAULT_CHECKOUT_DIRNAME);
+    const subPath = params.scaffoldingPath ?? 'scaffolding';
+    const scaffoldingDir = join(checkoutDir, subPath);
+    await mkdir(params.workDir, { recursive: true });
+    await execFileAsync('git', [...buildCloneArgs({ version, repositoryUrl, checkoutDir })], {
+        cwd: params.workDir,
+    });
+    await access(scaffoldingDir).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Scaffolding directory not found at "${scaffoldingDir}" after cloning ${repositoryUrl}@${version}: ${message}`);
+    });
+    return {
+        version,
+        repositoryUrl,
+        checkoutDir,
+        scaffoldingDir,
+    };
+};
+//# sourceMappingURL=clone-scaffolding.js.map

package/dist/lib/tests/clone-scaffolding.js.map

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

package/dist/lib/tests/exclusion-list.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Files and patterns that should never be synced from the remote scaffolding.
+ * These are files that could alter local git behavior or conflict with local config.
+ */
+export declare const DEFAULT_EXCLUSION_PATTERNS: readonly string[];
+/**
+ * Returns true if the given relative path should be excluded from sync.
+ * Checks if the filename (last segment) matches any exclusion pattern.
+ */
+export declare const isExcluded: (relativePath: string, exclusionPatterns?: readonly string[]) => boolean;
+//# sourceMappingURL=exclusion-list.d.ts.map

package/dist/lib/tests/exclusion-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusion-list.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/exclusion-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAIvD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,cAAc,MAAM,EACpB,oBAAmB,SAAS,MAAM,EAA+B,KAChE,OAKC,CAAC"}

package/dist/lib/tests/exclusion-list.js

@@ -0,0 +1,19 @@
+/**
+ * Files and patterns that should never be synced from the remote scaffolding.
+ * These are files that could alter local git behavior or conflict with local config.
+ */
+export const DEFAULT_EXCLUSION_PATTERNS = [
+    '.gitignore',
+    '.gitattributes',
+    '.gitmodules',
+];
+/**
+ * Returns true if the given relative path should be excluded from sync.
+ * Checks if the filename (last segment) matches any exclusion pattern.
+ */
+export const isExcluded = (relativePath, exclusionPatterns = DEFAULT_EXCLUSION_PATTERNS) => exclusionPatterns.some((pattern) => {
+    const segments = relativePath.split('/');
+    const fileName = segments[segments.length - 1] ?? '';
+    return fileName === pattern;
+});
+//# sourceMappingURL=exclusion-list.js.map

package/dist/lib/tests/exclusion-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusion-list.js","sourceRoot":"","sources":["../../../src/lib/tests/exclusion-list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D,YAAY;IACZ,gBAAgB;IAChB,aAAa;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,YAAoB,EACpB,oBAAuC,0BAA0B,EACxD,EAAE,CACX,iBAAiB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;IACjC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,OAAO,QAAQ,KAAK,OAAO,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/lib/tests/gitignore-manager.d.ts

@@ -0,0 +1,21 @@
+export interface GitignoreUpdateResult {
+    readonly path: string;
+    readonly entriesAdded: number;
+    readonly created: boolean;
+}
+/**
+ * Builds the managed section content from a list of file paths.
+ */
+export declare const buildManagedSection: (entries: readonly string[]) => string;
+/**
+ * Replaces or appends the managed section in existing gitignore content.
+ * Preserves all user-owned content outside the markers.
+ */
+export declare const replaceManagedSection: (existingContent: string, entries: readonly string[]) => string;
+/**
+ * Updates (or creates) the local .gitignore file with a managed section
+ * containing the specified file entries.
+ * Returns the result including how many entries were added.
+ */
+export declare const updateGitignore: (gitignorePath: string, entries: readonly string[]) => Promise<GitignoreUpdateResult>;
+//# sourceMappingURL=gitignore-manager.d.ts.map

package/dist/lib/tests/gitignore-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/tests/gitignore-manager.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAGhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,iBAAiB,MAAM,EACvB,SAAS,SAAS,MAAM,EAAE,KACzB,MAgBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,eAAe,MAAM,EACrB,SAAS,SAAS,MAAM,EAAE,KACzB,OAAO,CAAC,qBAAqB,CAY/B,CAAC"}

package/dist/lib/tests/gitignore-manager.js

@@ -0,0 +1,47 @@
+import { readFile, writeFile } from 'node:fs/promises';
+const MANAGED_START = '# --- jahia-cli:managed-start ---';
+const MANAGED_END = '# --- jahia-cli:managed-end ---';
+const MANAGED_HEADER = '# Files below are managed by jahia-cli tests init.\n' +
+    '# They are sourced from the remote scaffolding repository.\n' +
+    '# Remove a line to "own" that file and stop syncing it from remote.';
+/**
+ * Builds the managed section content from a list of file paths.
+ */
+export const buildManagedSection = (entries) => {
+    const sorted = [...entries].sort((a, b) => a.localeCompare(b));
+    return [MANAGED_START, MANAGED_HEADER, ...sorted, MANAGED_END].join('\n');
+};
+/**
+ * Replaces or appends the managed section in existing gitignore content.
+ * Preserves all user-owned content outside the markers.
+ */
+export const replaceManagedSection = (existingContent, entries) => {
+    const managedBlock = buildManagedSection(entries);
+    const startIdx = existingContent.indexOf(MANAGED_START);
+    const endIdx = existingContent.indexOf(MANAGED_END);
+    if (startIdx === -1 || endIdx === -1) {
+        const separator = existingContent.length > 0 && !existingContent.endsWith('\n') ? '\n\n' : '\n';
+        const prefix = existingContent.length === 0 ? '' : existingContent.trimEnd() + separator;
+        return prefix + managedBlock + '\n';
+    }
+    const before = existingContent.slice(0, startIdx);
+    const after = existingContent.slice(endIdx + MANAGED_END.length);
+    return before + managedBlock + after;
+};
+/**
+ * Updates (or creates) the local .gitignore file with a managed section
+ * containing the specified file entries.
+ * Returns the result including how many entries were added.
+ */
+export const updateGitignore = async (gitignorePath, entries) => {
+    const existing = await readFile(gitignorePath, 'utf-8').catch(() => '');
+    const created = existing === '';
+    const updated = replaceManagedSection(existing, entries);
+    await writeFile(gitignorePath, updated, 'utf-8');
+    return {
+        path: gitignorePath,
+        entriesAdded: entries.length,
+        created,
+    };
+};
+//# sourceMappingURL=gitignore-manager.js.map

package/dist/lib/tests/gitignore-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-manager.js","sourceRoot":"","sources":["../../../src/lib/tests/gitignore-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,aAAa,GAAG,mCAAmC,CAAC;AAC1D,MAAM,WAAW,GAAG,iCAAiC,CAAC;AACtD,MAAM,cAAc,GAClB,sDAAsD;IACtD,8DAA8D;IAC9D,qEAAqE,CAAC;AAQxE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAA0B,EAAU,EAAE;IACxE,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,CAAC,aAAa,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,eAAuB,EACvB,OAA0B,EAClB,EAAE;IACV,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAChG,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC;QACzF,OAAO,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEjE,OAAO,MAAM,GAAG,YAAY,GAAG,KAAK,CAAC;AACvC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,aAAqB,EACrB,OAA0B,EACM,EAAE;IAClC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,QAAQ,KAAK,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzD,MAAM,SAAS,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,OAAO;KACR,CAAC;AACJ,CAAC,CAAC"}