@hyperfrontend/versioning 0.1.0

package/flow/models/index.cjs.js

@@ -0,0 +1,285 @@
+'use strict';
+
+/**
+ * Default flow configuration values.
+ */
+const DEFAULT_FLOW_CONFIG = {
+    preset: 'conventional',
+    releaseTypes: ['feat', 'fix', 'perf', 'revert'],
+    minorTypes: ['feat'],
+    patchTypes: ['fix', 'perf', 'revert'],
+    skipGit: false,
+    skipTag: false,
+    skipChangelog: false,
+    dryRun: false,
+    commitMessage: 'chore(${projectName}): release version ${version}',
+    tagFormat: '${projectName}@${version}',
+    trackDeps: false,
+    releaseBranch: 'main',
+    firstReleaseVersion: '0.1.0',
+    allowPrerelease: false,
+    prereleaseId: 'alpha',
+    releaseAs: undefined,
+};
+
+/**
+ * Creates a flow step.
+ *
+ * @param id - Unique step identifier
+ * @param name - Human-readable step name
+ * @param execute - Step executor function
+ * @param options - Optional step configuration
+ * @returns A FlowStep object
+ *
+ * @example
+ * ```typescript
+ * const fetchStep = createStep(
+ *   'fetch-registry',
+ *   'Fetch Registry Version',
+ *   async (ctx) => {
+ *     const version = await ctx.registry.getLatestVersion(ctx.packageName)
+ *     return {
+ *       status: 'success',
+ *       stateUpdates: { publishedVersion: version },
+ *       message: `Found published version: ${version}`
+ *     }
+ *   }
+ * )
+ * ```
+ */
+function createStep(id, name, execute, options = {}) {
+    return {
+        id,
+        name,
+        execute,
+        description: options.description,
+        skipIf: options.skipIf,
+        continueOnError: options.continueOnError,
+        dependsOn: options.dependsOn,
+    };
+}
+/**
+ * Creates a step that succeeds immediately.
+ * Useful for placeholder or conditional steps.
+ *
+ * @param id - Unique identifier within the flow
+ * @param name - Display label shown during execution
+ * @param message - Success message
+ * @returns A FlowStep that always succeeds
+ */
+function createNoopStep(id, name, message = 'Step completed (no-op)') {
+    return createStep(id, name, async () => ({
+        status: 'success',
+        message,
+    }));
+}
+/**
+ * Creates a skipped step result.
+ *
+ * @param message - Explanation for why the step was skipped
+ * @returns A FlowStepResult with 'skipped' status
+ */
+function createSkippedResult(message) {
+    return {
+        status: 'skipped',
+        message,
+    };
+}
+/**
+ * Creates a success step result.
+ *
+ * @param message - Output text describing what the step accomplished
+ * @param stateUpdates - Optional state updates to apply after step completion
+ * @returns A FlowStepResult with 'success' status
+ */
+function createSuccessResult(message, stateUpdates) {
+    return {
+        status: 'success',
+        message,
+        stateUpdates,
+    };
+}
+/**
+ * Creates a failed step result.
+ *
+ * @param error - Error that caused the failure
+ * @param message - Optional message (defaults to error.message)
+ * @returns A FlowStepResult with 'failed' status
+ */
+function createFailedResult(error, message) {
+    return {
+        status: 'failed',
+        error,
+        message: message ?? error.message,
+    };
+}
+
+/**
+ * Creates a version flow.
+ *
+ * @param id - Flow identifier
+ * @param name - Human-readable flow name
+ * @param steps - Ordered steps to execute
+ * @param options - Optional flow configuration
+ * @returns A VersionFlow object
+ *
+ * @example
+ * ```typescript
+ * const myFlow = createFlow(
+ *   'custom',
+ *   'Custom Release Flow',
+ *   [fetchStep, analyzeStep, bumpStep],
+ *   { description: 'My custom versioning workflow' }
+ * )
+ * ```
+ */
+function createFlow(id, name, steps, options = {}) {
+    return {
+        id,
+        name,
+        steps,
+        description: options.description,
+        config: options.config ?? {},
+    };
+}
+/**
+ * Adds a step to a flow.
+ * Returns a new flow with the step appended.
+ *
+ * @param flow - The flow to extend
+ * @param step - The step to add
+ * @returns A new VersionFlow with the step added
+ */
+function addStep(flow, step) {
+    return {
+        ...flow,
+        steps: [...flow.steps, step],
+    };
+}
+/**
+ * Removes a step from a flow by ID.
+ * Returns a new flow without the specified step.
+ *
+ * @param flow - The flow to modify
+ * @param stepId - The ID of the step to remove
+ * @returns A new VersionFlow without the step
+ */
+function removeStep(flow, stepId) {
+    return {
+        ...flow,
+        steps: flow.steps.filter((s) => s.id !== stepId),
+    };
+}
+/**
+ * Inserts a step at a specific position.
+ *
+ * @param flow - The flow to modify
+ * @param step - The step to insert
+ * @param index - Position to insert at (0-based)
+ * @returns A new VersionFlow with the step inserted
+ */
+function insertStep(flow, step, index) {
+    const steps = [...flow.steps];
+    steps.splice(index, 0, step);
+    return {
+        ...flow,
+        steps,
+    };
+}
+/**
+ * Inserts a step after another step.
+ *
+ * @param flow - The flow to modify
+ * @param step - The step to insert
+ * @param afterStepId - ID of the step to insert after
+ * @returns A new VersionFlow with the step inserted
+ */
+function insertStepAfter(flow, step, afterStepId) {
+    const index = flow.steps.findIndex((s) => s.id === afterStepId);
+    if (index === -1) {
+        // If not found, append to end
+        return addStep(flow, step);
+    }
+    return insertStep(flow, step, index + 1);
+}
+/**
+ * Inserts a step before another step.
+ *
+ * @param flow - The flow to modify
+ * @param step - The step to insert
+ * @param beforeStepId - ID of the step to insert before
+ * @returns A new VersionFlow with the step inserted
+ */
+function insertStepBefore(flow, step, beforeStepId) {
+    const index = flow.steps.findIndex((s) => s.id === beforeStepId);
+    if (index === -1) {
+        // If not found, prepend to beginning
+        return insertStep(flow, step, 0);
+    }
+    return insertStep(flow, step, index);
+}
+/**
+ * Replaces a step in the flow.
+ *
+ * @param flow - The flow to modify
+ * @param stepId - ID of the step to replace
+ * @param newStep - The replacement step
+ * @returns A new VersionFlow with the step replaced
+ */
+function replaceStep(flow, stepId, newStep) {
+    return {
+        ...flow,
+        steps: flow.steps.map((s) => (s.id === stepId ? newStep : s)),
+    };
+}
+/**
+ * Updates the flow configuration.
+ *
+ * @param flow - The flow to configure
+ * @param config - Configuration updates to merge
+ * @returns A new VersionFlow with updated config
+ */
+function withConfig(flow, config) {
+    return {
+        ...flow,
+        config: { ...flow.config, ...config },
+    };
+}
+/**
+ * Gets a step from a flow by ID.
+ *
+ * @param flow - The flow to search
+ * @param stepId - The step ID to find
+ * @returns The step if found, undefined otherwise
+ */
+function getStep(flow, stepId) {
+    return flow.steps.find((s) => s.id === stepId);
+}
+/**
+ * Checks if a flow has a specific step.
+ *
+ * @param flow - The flow to check
+ * @param stepId - The step ID to look for
+ * @returns True if the flow contains the step
+ */
+function hasStep(flow, stepId) {
+    return flow.steps.some((s) => s.id === stepId);
+}
+
+exports.DEFAULT_FLOW_CONFIG = DEFAULT_FLOW_CONFIG;
+exports.addStep = addStep;
+exports.createFailedResult = createFailedResult;
+exports.createFlow = createFlow;
+exports.createNoopStep = createNoopStep;
+exports.createSkippedResult = createSkippedResult;
+exports.createStep = createStep;
+exports.createSuccessResult = createSuccessResult;
+exports.getStep = getStep;
+exports.hasStep = hasStep;
+exports.insertStep = insertStep;
+exports.insertStepAfter = insertStepAfter;
+exports.insertStepBefore = insertStepBefore;
+exports.removeStep = removeStep;
+exports.replaceStep = replaceStep;
+exports.withConfig = withConfig;
+//# sourceMappingURL=index.cjs.js.map

package/flow/models/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../../../../../../../../../../libs/versioning/src/flow/models/types.ts","../../../../../../../../../../libs/versioning/src/flow/models/step.ts","../../../../../../../../../../libs/versioning/src/flow/models/flow.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":"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"}

package/flow/models/index.d.ts

@@ -0,0 +1,7 @@
+export type { FlowConfig, FlowContext, FlowResult, FlowState, FlowStatus, FlowStepResult, FlowStepResultWithId, Logger } from './types';
+export type { FlowStep, StepCondition, StepExecutor, CreateStepOptions } from './step';
+export { DEFAULT_FLOW_CONFIG } from './types';
+export type { VersionFlow, CreateFlowOptions } from './flow';
+export { createStep, createNoopStep, createSkippedResult, createSuccessResult, createFailedResult } from './step';
+export { createFlow, addStep, removeStep, insertStep, insertStepAfter, insertStepBefore, replaceStep, withConfig, getStep, hasStep, } from './flow';
+//# sourceMappingURL=index.d.ts.map

package/flow/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/flow/models/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACvI,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AACjH,OAAO,EACL,UAAU,EACV,OAAO,EACP,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,OAAO,EACP,OAAO,GACR,MAAM,QAAQ,CAAA"}

package/flow/models/index.esm.js

@@ -0,0 +1,268 @@
+/**
+ * Default flow configuration values.
+ */
+const DEFAULT_FLOW_CONFIG = {
+    preset: 'conventional',
+    releaseTypes: ['feat', 'fix', 'perf', 'revert'],
+    minorTypes: ['feat'],
+    patchTypes: ['fix', 'perf', 'revert'],
+    skipGit: false,
+    skipTag: false,
+    skipChangelog: false,
+    dryRun: false,
+    commitMessage: 'chore(${projectName}): release version ${version}',
+    tagFormat: '${projectName}@${version}',
+    trackDeps: false,
+    releaseBranch: 'main',
+    firstReleaseVersion: '0.1.0',
+    allowPrerelease: false,
+    prereleaseId: 'alpha',
+    releaseAs: undefined,
+};
+
+/**
+ * Creates a flow step.
+ *
+ * @param id - Unique step identifier
+ * @param name - Human-readable step name
+ * @param execute - Step executor function
+ * @param options - Optional step configuration
+ * @returns A FlowStep object
+ *
+ * @example
+ * ```typescript
+ * const fetchStep = createStep(
+ *   'fetch-registry',
+ *   'Fetch Registry Version',
+ *   async (ctx) => {
+ *     const version = await ctx.registry.getLatestVersion(ctx.packageName)
+ *     return {
+ *       status: 'success',
+ *       stateUpdates: { publishedVersion: version },
+ *       message: `Found published version: ${version}`
+ *     }
+ *   }
+ * )
+ * ```
+ */
+function createStep(id, name, execute, options = {}) {
+    return {
+        id,
+        name,
+        execute,
+        description: options.description,
+        skipIf: options.skipIf,
+        continueOnError: options.continueOnError,
+        dependsOn: options.dependsOn,
+    };
+}
+/**
+ * Creates a step that succeeds immediately.
+ * Useful for placeholder or conditional steps.
+ *
+ * @param id - Unique identifier within the flow
+ * @param name - Display label shown during execution
+ * @param message - Success message
+ * @returns A FlowStep that always succeeds
+ */
+function createNoopStep(id, name, message = 'Step completed (no-op)') {
+    return createStep(id, name, async () => ({
+        status: 'success',
+        message,
+    }));
+}
+/**
+ * Creates a skipped step result.
+ *
+ * @param message - Explanation for why the step was skipped
+ * @returns A FlowStepResult with 'skipped' status
+ */
+function createSkippedResult(message) {
+    return {
+        status: 'skipped',
+        message,
+    };
+}
+/**
+ * Creates a success step result.
+ *
+ * @param message - Output text describing what the step accomplished
+ * @param stateUpdates - Optional state updates to apply after step completion
+ * @returns A FlowStepResult with 'success' status
+ */
+function createSuccessResult(message, stateUpdates) {
+    return {
+        status: 'success',
+        message,
+        stateUpdates,
+    };
+}
+/**
+ * Creates a failed step result.
+ *
+ * @param error - Error that caused the failure
+ * @param message - Optional message (defaults to error.message)
+ * @returns A FlowStepResult with 'failed' status
+ */
+function createFailedResult(error, message) {
+    return {
+        status: 'failed',
+        error,
+        message: message ?? error.message,
+    };
+}
+
+/**
+ * Creates a version flow.
+ *
+ * @param id - Flow identifier
+ * @param name - Human-readable flow name
+ * @param steps - Ordered steps to execute
+ * @param options - Optional flow configuration
+ * @returns A VersionFlow object
+ *
+ * @example
+ * ```typescript
+ * const myFlow = createFlow(
+ *   'custom',
+ *   'Custom Release Flow',
+ *   [fetchStep, analyzeStep, bumpStep],
+ *   { description: 'My custom versioning workflow' }
+ * )
+ * ```
+ */
+function createFlow(id, name, steps, options = {}) {
+    return {
+        id,
+        name,
+        steps,
+        description: options.description,
+        config: options.config ?? {},
+    };
+}
+/**
+ * Adds a step to a flow.
+ * Returns a new flow with the step appended.
+ *
+ * @param flow - The flow to extend
+ * @param step - The step to add
+ * @returns A new VersionFlow with the step added
+ */
+function addStep(flow, step) {
+    return {
+        ...flow,
+        steps: [...flow.steps, step],
+    };
+}
+/**
+ * Removes a step from a flow by ID.
+ * Returns a new flow without the specified step.
+ *
+ * @param flow - The flow to modify
+ * @param stepId - The ID of the step to remove
+ * @returns A new VersionFlow without the step
+ */
+function removeStep(flow, stepId) {
+    return {
+        ...flow,
+        steps: flow.steps.filter((s) => s.id !== stepId),
+    };
+}
+/**
+ * Inserts a step at a specific position.
+ *
+ * @param flow - The flow to modify
+ * @param step - The step to insert
+ * @param index - Position to insert at (0-based)
+ * @returns A new VersionFlow with the step inserted
+ */
+function insertStep(flow, step, index) {
+    const steps = [...flow.steps];
+    steps.splice(index, 0, step);
+    return {
+        ...flow,
+        steps,
+    };
+}
+/**
+ * Inserts a step after another step.
+ *
+ * @param flow - The flow to modify
+ * @param step - The step to insert
+ * @param afterStepId - ID of the step to insert after
+ * @returns A new VersionFlow with the step inserted
+ */
+function insertStepAfter(flow, step, afterStepId) {
+    const index = flow.steps.findIndex((s) => s.id === afterStepId);
+    if (index === -1) {
+        // If not found, append to end
+        return addStep(flow, step);
+    }
+    return insertStep(flow, step, index + 1);
+}
+/**
+ * Inserts a step before another step.
+ *
+ * @param flow - The flow to modify
+ * @param step - The step to insert
+ * @param beforeStepId - ID of the step to insert before
+ * @returns A new VersionFlow with the step inserted
+ */
+function insertStepBefore(flow, step, beforeStepId) {
+    const index = flow.steps.findIndex((s) => s.id === beforeStepId);
+    if (index === -1) {
+        // If not found, prepend to beginning
+        return insertStep(flow, step, 0);
+    }
+    return insertStep(flow, step, index);
+}
+/**
+ * Replaces a step in the flow.
+ *
+ * @param flow - The flow to modify
+ * @param stepId - ID of the step to replace
+ * @param newStep - The replacement step
+ * @returns A new VersionFlow with the step replaced
+ */
+function replaceStep(flow, stepId, newStep) {
+    return {
+        ...flow,
+        steps: flow.steps.map((s) => (s.id === stepId ? newStep : s)),
+    };
+}
+/**
+ * Updates the flow configuration.
+ *
+ * @param flow - The flow to configure
+ * @param config - Configuration updates to merge
+ * @returns A new VersionFlow with updated config
+ */
+function withConfig(flow, config) {
+    return {
+        ...flow,
+        config: { ...flow.config, ...config },
+    };
+}
+/**
+ * Gets a step from a flow by ID.
+ *
+ * @param flow - The flow to search
+ * @param stepId - The step ID to find
+ * @returns The step if found, undefined otherwise
+ */
+function getStep(flow, stepId) {
+    return flow.steps.find((s) => s.id === stepId);
+}
+/**
+ * Checks if a flow has a specific step.
+ *
+ * @param flow - The flow to check
+ * @param stepId - The step ID to look for
+ * @returns True if the flow contains the step
+ */
+function hasStep(flow, stepId) {
+    return flow.steps.some((s) => s.id === stepId);
+}
+
+export { DEFAULT_FLOW_CONFIG, addStep, createFailedResult, createFlow, createNoopStep, createSkippedResult, createStep, createSuccessResult, getStep, hasStep, insertStep, insertStepAfter, insertStepBefore, removeStep, replaceStep, withConfig };
+//# sourceMappingURL=index.esm.js.map

package/flow/models/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../../../../../../../../../libs/versioning/src/flow/models/types.ts","../../../../../../../../../../libs/versioning/src/flow/models/step.ts","../../../../../../../../../../libs/versioning/src/flow/models/flow.ts"],"sourcesContent":[null,null,null],"names":[],"mappings":"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"}

package/flow/models/step.d.ts

@@ -0,0 +1,108 @@
+import type { FlowContext, FlowStepResult } from './types';
+/**
+ * Step executor function type.
+ * Takes flow context and returns a step result promise.
+ */
+export type StepExecutor = (context: FlowContext) => Promise<FlowStepResult>;
+/**
+ * Step skip condition function type.
+ * Returns true if the step should be skipped.
+ */
+export type StepCondition = (context: FlowContext) => boolean;
+/**
+ * A single step in a version flow.
+ *
+ * Steps are pure functions that:
+ * 1. Read from context (state, config, services)
+ * 2. Perform work (possibly with side effects via services)
+ * 3. Return state updates
+ */
+export interface FlowStep {
+    /** Step identifier (unique within flow) */
+    readonly id: string;
+    /** Human-readable step name */
+    readonly name: string;
+    /** Optional step description */
+    readonly description?: string;
+    /** Step function to execute */
+    readonly execute: StepExecutor;
+    /** Condition for skipping step */
+    readonly skipIf?: StepCondition;
+    /** Whether step failure should fail the flow */
+    readonly continueOnError?: boolean;
+    /** Steps that must complete before this one */
+    readonly dependsOn?: readonly string[];
+}
+/**
+ * Options for creating a flow step.
+ */
+export interface CreateStepOptions {
+    /** Step description */
+    description?: string;
+    /** Condition for skipping step */
+    skipIf?: StepCondition;
+    /** Whether step failure should fail the flow */
+    continueOnError?: boolean;
+    /** Steps that must complete before this one */
+    dependsOn?: readonly string[];
+}
+/**
+ * Creates a flow step.
+ *
+ * @param id - Unique step identifier
+ * @param name - Human-readable step name
+ * @param execute - Step executor function
+ * @param options - Optional step configuration
+ * @returns A FlowStep object
+ *
+ * @example
+ * ```typescript
+ * const fetchStep = createStep(
+ *   'fetch-registry',
+ *   'Fetch Registry Version',
+ *   async (ctx) => {
+ *     const version = await ctx.registry.getLatestVersion(ctx.packageName)
+ *     return {
+ *       status: 'success',
+ *       stateUpdates: { publishedVersion: version },
+ *       message: `Found published version: ${version}`
+ *     }
+ *   }
+ * )
+ * ```
+ */
+export declare function createStep(id: string, name: string, execute: StepExecutor, options?: CreateStepOptions): FlowStep;
+/**
+ * Creates a step that succeeds immediately.
+ * Useful for placeholder or conditional steps.
+ *
+ * @param id - Unique identifier within the flow
+ * @param name - Display label shown during execution
+ * @param message - Success message
+ * @returns A FlowStep that always succeeds
+ */
+export declare function createNoopStep(id: string, name: string, message?: string): FlowStep;
+/**
+ * Creates a skipped step result.
+ *
+ * @param message - Explanation for why the step was skipped
+ * @returns A FlowStepResult with 'skipped' status
+ */
+export declare function createSkippedResult(message: string): FlowStepResult;
+/**
+ * Creates a success step result.
+ *
+ * @param message - Output text describing what the step accomplished
+ * @param stateUpdates - Optional state updates to apply after step completion
+ * @returns A FlowStepResult with 'success' status
+ */
+export declare function createSuccessResult(message: string, stateUpdates?: FlowStepResult['stateUpdates']): FlowStepResult;
+/**
+ * Creates a failed step result.
+ *
+ * @param error - Error that caused the failure
+ * @param message - Optional message (defaults to error.message)
+ * @returns A FlowStepResult with 'failed' status
+ */
+export declare function createFailedResult(error: Error, message?: string): FlowStepResult;
+//# sourceMappingURL=step.d.ts.map

package/flow/models/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/flow/models/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE1D;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAE5E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAA;AAE7D;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,gCAAgC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAE7B,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAE9B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAE/B,gDAAgD;IAChD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAElC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,aAAa,CAAA;IAEtB,gDAAgD;IAChD,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,iBAAsB,GAAG,QAAQ,CAUrH;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAA2B,GAAG,QAAQ,CAKrG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,GAAG,cAAc,CAMlH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAMjF"}