@uniformdev/transformer 1.1.29 → 1.1.31

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli/index.ts
-import { Command as Command13 } from "commander";
+import { Command as Command16 } from "commander";
 
 // src/cli/commands/propagate-root-component-property.ts
 import { Command } from "commander";
@@ -5019,10 +5019,737 @@ function createRemoveFieldCommand() {
   return command;
 }
 
+// src/cli/commands/add-component-parameter.ts
+import { Command as Command13 } from "commander";
+
+// src/core/services/component-parameter-adder.service.ts
+var ComponentParameterAdderService = class {
+  constructor(fileSystem, componentService, logger) {
+    this.fileSystem = fileSystem;
+    this.componentService = componentService;
+    this.logger = logger;
+  }
+  async add(options) {
+    const {
+      rootDir,
+      componentsDir,
+      componentId,
+      parameterId,
+      parameterType,
+      parameterConfig,
+      groupId,
+      whatIf,
+      strict
+    } = options;
+    const findOptions = { strict };
+    const fullComponentsDir = this.fileSystem.resolvePath(rootDir, componentsDir);
+    this.logger.info(`Loading component: ${componentId}`);
+    const { component, filePath: componentFilePath } = await this.componentService.loadComponent(fullComponentsDir, componentId, findOptions);
+    let parsedConfig = {};
+    if (parameterConfig) {
+      try {
+        parsedConfig = JSON.parse(parameterConfig);
+      } catch (e) {
+        throw new TransformError(
+          `Invalid JSON in --parameterConfig: ${e instanceof Error ? e.message : String(e)}`
+        );
+      }
+    }
+    const { id: _ignoreId, type: _ignoreType, ...restConfig } = parsedConfig;
+    const parameter = {
+      id: parameterId,
+      name: parsedConfig.name ?? parameterId,
+      type: parameterType,
+      ...restConfig
+    };
+    const existing = this.componentService.findParameter(component, parameterId, findOptions);
+    const parameterReplaced = existing !== void 0;
+    if (parameterReplaced) {
+      this.logger.warn(
+        `Parameter "${parameterId}" already exists on component "${component.id}" \u2014 replacing`
+      );
+    }
+    this.logger.action(
+      whatIf,
+      parameterReplaced ? "UPDATE" : "ADD",
+      `parameter "${parameterId}" to component/${this.fileSystem.getBasename(componentFilePath)}`
+    );
+    let updatedComponent = this.componentService.addParameterToComponent(
+      component,
+      parameter,
+      findOptions
+    );
+    if (groupId) {
+      const group = this.componentService.findParameter(updatedComponent, groupId, findOptions);
+      if (!group || !this.componentService.isGroupParameter(group)) {
+        throw new TransformError(
+          `Group "${groupId}" not found on component "${component.id}"`
+        );
+      }
+      updatedComponent = this.componentService.addParameterToGroup(
+        updatedComponent,
+        groupId,
+        parameterId,
+        findOptions
+      );
+    }
+    if (!whatIf) {
+      await this.componentService.saveComponent(componentFilePath, updatedComponent);
+    }
+    this.logger.info("");
+    this.logger.info(`Summary: 1 component definition updated.`);
+    return {
+      componentDefinitionUpdated: true,
+      parameterReplaced
+    };
+  }
+};
+
+// src/cli/commands/add-component-parameter.ts
+function createAddComponentParameterCommand() {
+  const command = new Command13("add-component-parameter");
+  command.description(
+    "Adds a new parameter definition to a component. If the parameter already exists it is replaced."
+  ).option("--componentId <id>", "The ID of the component to add the parameter to").option("--parameterId <id>", "The ID of the new parameter").option("--parameterType <type>", "The type of the new parameter (e.g. text, checkbox, select)").option(
+    "--parameterConfig <json>",
+    "Optional JSON string with additional parameter properties (e.g. name, typeConfig, localizable)"
+  ).option(
+    "--groupId <id>",
+    "Optional ID of an existing group parameter to register the new parameter under"
+  ).hook("preAction", (thisCommand) => {
+    const opts = thisCommand.opts();
+    const requiredOptions = [
+      { name: "componentId", flag: "--componentId" },
+      { name: "parameterId", flag: "--parameterId" },
+      { name: "parameterType", flag: "--parameterType" }
+    ];
+    const missing = requiredOptions.filter((opt) => !opts[opt.name]).map((opt) => opt.flag);
+    if (missing.length > 0) {
+      console.error(`error: missing required options: ${missing.join(", ")}`);
+      process.exit(1);
+    }
+  }).action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const options = {
+      ...globalOpts,
+      componentId: opts.componentId,
+      parameterId: opts.parameterId,
+      parameterType: opts.parameterType,
+      parameterConfig: opts.parameterConfig,
+      groupId: opts.groupId
+    };
+    const logger = new Logger();
+    const fileSystem = new FileSystemService();
+    const componentService = new ComponentService(fileSystem);
+    const adder = new ComponentParameterAdderService(fileSystem, componentService, logger);
+    try {
+      const result = await adder.add({
+        rootDir: options.rootDir,
+        componentsDir: options.componentsDir,
+        componentId: options.componentId,
+        parameterId: options.parameterId,
+        parameterType: options.parameterType,
+        parameterConfig: options.parameterConfig,
+        groupId: options.groupId,
+        whatIf: options.whatIf ?? false,
+        strict: options.strict ?? false
+      });
+      logger.success(
+        `${result.parameterReplaced ? "Replaced" : "Added"} parameter "${options.parameterId}" on component "${options.componentId}"`
+      );
+    } catch (error) {
+      if (error instanceof TransformError) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      throw error;
+    }
+  });
+  return command;
+}
+
+// src/cli/commands/add-contenttype-field.ts
+import { Command as Command14 } from "commander";
+
+// src/core/services/contenttype-field-adder.service.ts
+var ContentTypeFieldAdderService = class {
+  constructor(fileSystem, logger) {
+    this.fileSystem = fileSystem;
+    this.logger = logger;
+  }
+  compareIds(id1, id2, strict) {
+    if (strict) {
+      return id1 === id2;
+    }
+    return id1.toLowerCase() === id2.toLowerCase();
+  }
+  async loadContentType(contentTypesDir, contentTypeId, strict) {
+    const jsonPath = this.fileSystem.joinPath(contentTypesDir, `${contentTypeId}.json`);
+    const yamlPath = this.fileSystem.joinPath(contentTypesDir, `${contentTypeId}.yaml`);
+    const ymlPath = this.fileSystem.joinPath(contentTypesDir, `${contentTypeId}.yml`);
+    if (await this.fileSystem.fileExists(jsonPath)) {
+      const contentType = await this.fileSystem.readFile(jsonPath);
+      return { contentType, filePath: jsonPath };
+    }
+    if (await this.fileSystem.fileExists(yamlPath)) {
+      const contentType = await this.fileSystem.readFile(yamlPath);
+      return { contentType, filePath: yamlPath };
+    }
+    if (await this.fileSystem.fileExists(ymlPath)) {
+      const contentType = await this.fileSystem.readFile(ymlPath);
+      return { contentType, filePath: ymlPath };
+    }
+    if (!strict) {
+      const files = await this.fileSystem.findFiles(contentTypesDir, "*.{json,yaml,yml}");
+      for (const filePath of files) {
+        const basename2 = this.fileSystem.getBasename(filePath);
+        const nameWithoutExt = basename2.replace(/\.(json|yaml|yml)$/i, "");
+        if (nameWithoutExt.toLowerCase() === contentTypeId.toLowerCase()) {
+          const contentType = await this.fileSystem.readFile(filePath);
+          return { contentType, filePath };
+        }
+      }
+    }
+    throw new TransformError(`Content type not found: ${contentTypeId} (searched: ${contentTypesDir})`);
+  }
+  async add(options) {
+    const {
+      rootDir,
+      contentTypesDir,
+      contentTypeId,
+      fieldId,
+      fieldType,
+      fieldConfig,
+      whatIf,
+      strict
+    } = options;
+    const fullContentTypesDir = this.fileSystem.resolvePath(rootDir, contentTypesDir);
+    this.logger.info(`Loading content type: ${contentTypeId}`);
+    const { contentType, filePath: contentTypeFilePath } = await this.loadContentType(fullContentTypesDir, contentTypeId, strict);
+    let parsedConfig = {};
+    if (fieldConfig) {
+      try {
+        parsedConfig = JSON.parse(fieldConfig);
+      } catch (e) {
+        throw new TransformError(
+          `Invalid JSON in --fieldConfig: ${e instanceof Error ? e.message : String(e)}`
+        );
+      }
+    }
+    const { id: _ignoreId, type: _ignoreType, ...restConfig } = parsedConfig;
+    const field = {
+      id: fieldId,
+      name: parsedConfig.name ?? fieldId,
+      type: fieldType,
+      ...restConfig
+    };
+    if (!contentType.fields) {
+      contentType.fields = [];
+    }
+    const existingIndex = contentType.fields.findIndex(
+      (f) => this.compareIds(f.id, fieldId, strict)
+    );
+    const fieldReplaced = existingIndex >= 0;
+    if (fieldReplaced) {
+      this.logger.warn(
+        `Field "${fieldId}" already exists on content type "${contentType.id}" \u2014 replacing`
+      );
+    }
+    this.logger.action(
+      whatIf,
+      fieldReplaced ? "UPDATE" : "ADD",
+      `field "${fieldId}" to contentType/${this.fileSystem.getBasename(contentTypeFilePath)}`
+    );
+    if (fieldReplaced) {
+      contentType.fields[existingIndex] = field;
+    } else {
+      contentType.fields.push(field);
+    }
+    if (!whatIf) {
+      await this.fileSystem.writeFile(contentTypeFilePath, contentType);
+    }
+    this.logger.info("");
+    this.logger.info(`Summary: 1 content type definition updated.`);
+    return {
+      contentTypeDefinitionUpdated: true,
+      fieldReplaced
+    };
+  }
+};
+
+// src/cli/commands/add-contenttype-field.ts
+function createAddContentTypeFieldCommand() {
+  const command = new Command14("add-contenttype-field");
+  command.description(
+    "Adds a new field definition to a content type. If the field already exists it is replaced."
+  ).option("--contentTypeId <id>", "The ID of the content type to add the field to").option("--fieldId <id>", "The ID of the new field").option("--fieldType <type>", "The type of the new field (e.g. text, richText, reference)").option(
+    "--fieldConfig <json>",
+    "Optional JSON string with additional field properties (e.g. name, typeConfig, localizable)"
+  ).hook("preAction", (thisCommand) => {
+    const opts = thisCommand.opts();
+    const requiredOptions = [
+      { name: "contentTypeId", flag: "--contentTypeId" },
+      { name: "fieldId", flag: "--fieldId" },
+      { name: "fieldType", flag: "--fieldType" }
+    ];
+    const missing = requiredOptions.filter((opt) => !opts[opt.name]).map((opt) => opt.flag);
+    if (missing.length > 0) {
+      console.error(`error: missing required options: ${missing.join(", ")}`);
+      process.exit(1);
+    }
+  }).action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const options = {
+      ...globalOpts,
+      contentTypeId: opts.contentTypeId,
+      fieldId: opts.fieldId,
+      fieldType: opts.fieldType,
+      fieldConfig: opts.fieldConfig
+    };
+    const logger = new Logger();
+    const fileSystem = new FileSystemService();
+    const adder = new ContentTypeFieldAdderService(fileSystem, logger);
+    try {
+      const result = await adder.add({
+        rootDir: options.rootDir,
+        contentTypesDir: options.contentTypesDir,
+        contentTypeId: options.contentTypeId,
+        fieldId: options.fieldId,
+        fieldType: options.fieldType,
+        fieldConfig: options.fieldConfig,
+        whatIf: options.whatIf ?? false,
+        strict: options.strict ?? false
+      });
+      logger.success(
+        `${result.fieldReplaced ? "Replaced" : "Added"} field "${options.fieldId}" on content type "${options.contentTypeId}"`
+      );
+    } catch (error) {
+      if (error instanceof TransformError) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      throw error;
+    }
+  });
+  return command;
+}
+
+// src/cli/commands/flatten-block-field.ts
+import { Command as Command15 } from "commander";
+
+// src/core/services/block-field-flattener.service.ts
+var BlockFieldFlattenerService = class {
+  constructor(fileSystem, componentService, logger) {
+    this.fileSystem = fileSystem;
+    this.componentService = componentService;
+    this.logger = logger;
+  }
+  compareIds(id1, id2, strict) {
+    if (strict) return id1 === id2;
+    return id1.toLowerCase() === id2.toLowerCase();
+  }
+  async loadContentType(contentTypesDir, contentTypeId, strict) {
+    const jsonPath = this.fileSystem.joinPath(contentTypesDir, `${contentTypeId}.json`);
+    const yamlPath = this.fileSystem.joinPath(contentTypesDir, `${contentTypeId}.yaml`);
+    const ymlPath = this.fileSystem.joinPath(contentTypesDir, `${contentTypeId}.yml`);
+    if (await this.fileSystem.fileExists(jsonPath)) {
+      return { contentType: await this.fileSystem.readFile(jsonPath), filePath: jsonPath };
+    }
+    if (await this.fileSystem.fileExists(yamlPath)) {
+      return { contentType: await this.fileSystem.readFile(yamlPath), filePath: yamlPath };
+    }
+    if (await this.fileSystem.fileExists(ymlPath)) {
+      return { contentType: await this.fileSystem.readFile(ymlPath), filePath: ymlPath };
+    }
+    if (!strict) {
+      const files = await this.fileSystem.findFiles(contentTypesDir, "*.{json,yaml,yml}");
+      for (const filePath of files) {
+        const basename2 = this.fileSystem.getBasename(filePath);
+        const nameWithoutExt = basename2.replace(/\.(json|yaml|yml)$/i, "");
+        if (nameWithoutExt.toLowerCase() === contentTypeId.toLowerCase()) {
+          return { contentType: await this.fileSystem.readFile(filePath), filePath };
+        }
+      }
+    }
+    throw new TransformError(`Content type not found: ${contentTypeId} (searched: ${contentTypesDir})`);
+  }
+  async flatten(options) {
+    const {
+      rootDir,
+      componentsDir,
+      compositionsDir,
+      compositionPatternsDir,
+      componentPatternsDir,
+      contentTypesDir,
+      componentId,
+      parameterId,
+      whatIf,
+      strict,
+      excludeFields = []
+    } = options;
+    const findOptions = { strict };
+    const fullComponentsDir = this.fileSystem.resolvePath(rootDir, componentsDir);
+    const fullCompositionsDir = this.fileSystem.resolvePath(rootDir, compositionsDir);
+    const fullCompositionPatternsDir = this.fileSystem.resolvePath(rootDir, compositionPatternsDir);
+    const fullComponentPatternsDir = this.fileSystem.resolvePath(rootDir, componentPatternsDir);
+    const fullContentTypesDir = this.fileSystem.resolvePath(rootDir, contentTypesDir);
+    this.logger.info(`Loading component: ${componentId}`);
+    const { component, filePath: componentFilePath } = await this.componentService.loadComponent(fullComponentsDir, componentId, findOptions);
+    const blockParam = this.componentService.findParameter(component, parameterId, findOptions);
+    if (!blockParam) {
+      throw new PropertyNotFoundError(parameterId, componentId);
+    }
+    const allowedTypes = blockParam.typeConfig?.allowedTypes;
+    if (!allowedTypes || allowedTypes.length === 0) {
+      throw new TransformError(
+        `Parameter "${parameterId}" on component "${componentId}" has no allowedTypes in typeConfig`
+      );
+    }
+    if (allowedTypes.length > 1) {
+      throw new TransformError(
+        `Cannot flatten: parameter "${parameterId}" allows multiple block types: ${allowedTypes.join(", ")}`
+      );
+    }
+    const blockContentTypeId = allowedTypes[0];
+    this.logger.info(`Block content type: ${blockContentTypeId}`);
+    const { contentType: blockContentType } = await this.loadContentType(fullContentTypesDir, blockContentTypeId, strict);
+    const excludeSet = new Set(excludeFields.map((id) => id.toLowerCase()));
+    const blockFields = (blockContentType.fields ?? []).filter(
+      (f) => !excludeSet.has(f.id.toLowerCase())
+    );
+    const blockFieldIds = blockFields.map((f) => f.id);
+    this.logger.info(
+      `Block content type: ${blockContentTypeId} (${blockFields.length} field(s): ${blockFieldIds.join(", ")})`
+    );
+    for (const field of blockFields) {
+      const existingParam = this.componentService.findParameter(component, field.id, findOptions);
+      if (existingParam && !this.compareIds(existingParam.id, parameterId, strict)) {
+        throw new TransformError(
+          `Cannot flatten: field "${field.id}" from block type "${blockContentTypeId}" conflicts with existing parameter "${existingParam.id}" on component "${componentId}"`
+        );
+      }
+    }
+    this.logger.info("Validation pass: scanning compositions...");
+    await this.validateDirectory(fullCompositionsDir, componentId, parameterId, strict, "composition");
+    await this.validateDirectory(fullCompositionPatternsDir, componentId, parameterId, strict, "compositionPattern");
+    await this.validateDirectory(fullComponentPatternsDir, componentId, parameterId, strict, "componentPattern");
+    this.logger.action(
+      whatIf,
+      "REMOVE",
+      `parameter "${parameterId}" from component/${this.fileSystem.getBasename(componentFilePath)}`
+    );
+    this.logger.action(
+      whatIf,
+      "ADD",
+      `parameters "${blockFieldIds.join(", ")}" to component/${this.fileSystem.getBasename(componentFilePath)}`
+    );
+    let updatedComponent = this.componentService.removeParameter(component, parameterId, findOptions);
+    updatedComponent = this.componentService.removeEmptyGroups(updatedComponent);
+    for (const field of blockFields) {
+      updatedComponent = this.componentService.addParameterToComponent(
+        updatedComponent,
+        { id: field.id, name: field.name, type: field.type, ...field.typeConfig ? { typeConfig: field.typeConfig } : {}, ...this.extraFieldProps(field) },
+        findOptions
+      );
+    }
+    if (!whatIf) {
+      await this.componentService.saveComponent(componentFilePath, updatedComponent);
+    }
+    const compositionsResult = await this.flattenInDirectory(
+      fullCompositionsDir,
+      componentId,
+      parameterId,
+      whatIf,
+      strict,
+      "composition"
+    );
+    const compositionPatternsResult = await this.flattenInDirectory(
+      fullCompositionPatternsDir,
+      componentId,
+      parameterId,
+      whatIf,
+      strict,
+      "compositionPattern"
+    );
+    const componentPatternsResult = await this.flattenInDirectory(
+      fullComponentPatternsDir,
+      componentId,
+      parameterId,
+      whatIf,
+      strict,
+      "componentPattern"
+    );
+    const totalFiles = compositionsResult.filesModified + compositionPatternsResult.filesModified + componentPatternsResult.filesModified;
+    const totalInstances = compositionsResult.instancesUpdated + compositionPatternsResult.instancesUpdated + componentPatternsResult.instancesUpdated;
+    this.logger.info("");
+    this.logger.info(
+      `Summary: 1 component definition updated, ${totalFiles} file(s) (${totalInstances} instance(s)) updated.`
+    );
+    return {
+      componentDefinitionUpdated: true,
+      compositionsModified: compositionsResult.filesModified,
+      compositionPatternsModified: compositionPatternsResult.filesModified,
+      componentPatternsModified: componentPatternsResult.filesModified,
+      instancesUpdated: totalInstances
+    };
+  }
+  // Extract extra field props beyond id, name, type, typeConfig
+  extraFieldProps(field) {
+    const { id: _id, name: _name, type: _type, typeConfig: _tc, ...rest } = field;
+    return rest;
+  }
+  async validateDirectory(directory, componentId, parameterId, strict, label) {
+    let files;
+    try {
+      files = await this.fileSystem.findFiles(directory, "**/*.{json,yaml,yml}");
+    } catch {
+      return;
+    }
+    for (const filePath of files) {
+      let composition;
+      try {
+        composition = await this.fileSystem.readFile(filePath);
+      } catch {
+        continue;
+      }
+      if (!composition?.composition) continue;
+      this.validateBlocksInTree(composition.composition, componentId, parameterId, strict, filePath, label);
+      this.validateBlocksInOverrides(composition, componentId, parameterId, strict, filePath, label);
+    }
+  }
+  validateBlocksInTree(node, componentId, parameterId, strict, filePath, label) {
+    if (this.compareIds(node.type, componentId, strict) && node.parameters) {
+      const blockParamValue = this.findKeyInMap(node.parameters, parameterId, strict);
+      if (blockParamValue) {
+        const items = blockParamValue.value;
+        if (Array.isArray(items) && items.length > 1) {
+          throw new TransformError(
+            `Cannot flatten: more than one block item in parameter "${parameterId}" of "${componentId}" instance "${node._id ?? "(root)"}" in file "${label}/${this.fileSystem.getBasename(filePath)}"`
+          );
+        }
+      }
+    }
+    if (node.slots) {
+      for (const slotInstances of Object.values(node.slots)) {
+        if (!Array.isArray(slotInstances)) continue;
+        for (const instance of slotInstances) {
+          this.validateBlocksInTree(instance, componentId, parameterId, strict, filePath, label);
+        }
+      }
+    }
+  }
+  validateBlocksInOverrides(composition, componentId, parameterId, strict, filePath, label) {
+    if (!composition.composition._overrides) return;
+    for (const [overrideId, override] of Object.entries(composition.composition._overrides)) {
+      if (!override.parameters) continue;
+      const blockParamValue = this.findKeyInMap(override.parameters, parameterId, strict);
+      if (blockParamValue) {
+        const items = blockParamValue.value;
+        if (Array.isArray(items) && items.length > 1) {
+          throw new TransformError(
+            `Cannot flatten: more than one block item in _overrides["${overrideId}"] parameter "${parameterId}" in file "${label}/${this.fileSystem.getBasename(filePath)}"`
+          );
+        }
+      }
+    }
+  }
+  async flattenInDirectory(directory, componentId, parameterId, whatIf, strict, label) {
+    let files;
+    try {
+      files = await this.fileSystem.findFiles(directory, "**/*.{json,yaml,yml}");
+    } catch {
+      return { filesModified: 0, instancesUpdated: 0 };
+    }
+    if (files.length === 0) return { filesModified: 0, instancesUpdated: 0 };
+    let filesModified = 0;
+    let instancesUpdated = 0;
+    for (const filePath of files) {
+      let composition;
+      try {
+        composition = await this.fileSystem.readFile(filePath);
+      } catch {
+        continue;
+      }
+      if (!composition?.composition) continue;
+      const treeCount = this.flattenBlocksInTree(composition.composition, componentId, parameterId, strict);
+      const overridesCount = this.flattenBlocksInOverrides(composition, componentId, parameterId, strict);
+      const totalCount = treeCount + overridesCount;
+      if (totalCount > 0) {
+        const relativePath = filePath.replace(directory, "").replace(/^[/\\]/, "");
+        this.logger.action(
+          whatIf,
+          "UPDATE",
+          `${label}/${relativePath} (${totalCount} instance(s) of ${componentId})`
+        );
+        if (!whatIf) {
+          await this.fileSystem.writeFile(filePath, composition);
+        }
+        filesModified++;
+        instancesUpdated += totalCount;
+      }
+    }
+    return { filesModified, instancesUpdated };
+  }
+  flattenBlocksInTree(node, componentId, parameterId, strict) {
+    let count = 0;
+    if (this.compareIds(node.type, componentId, strict) && node.parameters) {
+      const matchingKey = this.findKeyName(node.parameters, parameterId, strict);
+      if (matchingKey !== void 0) {
+        const blockParamValue = node.parameters[matchingKey];
+        const items = blockParamValue.value;
+        if (Array.isArray(items) && items.length === 1) {
+          const blockItem = items[0];
+          for (const [fieldId, fieldValue] of Object.entries(blockItem.fields ?? {})) {
+            node.parameters[fieldId] = fieldValue;
+          }
+        }
+        delete node.parameters[matchingKey];
+        count++;
+      }
+    }
+    if (node.slots) {
+      for (const slotInstances of Object.values(node.slots)) {
+        if (!Array.isArray(slotInstances)) continue;
+        for (const instance of slotInstances) {
+          count += this.flattenBlocksInTree(instance, componentId, parameterId, strict);
+        }
+      }
+    }
+    return count;
+  }
+  flattenBlocksInOverrides(composition, componentId, parameterId, strict) {
+    if (!composition.composition._overrides) return 0;
+    let count = 0;
+    if (this.compareIds(composition.composition.type, componentId, strict)) {
+      count += this.flattenOverrideMap(composition.composition._overrides, parameterId, strict);
+    }
+    count += this.flattenOverridesForMatchingInstances(
+      composition.composition,
+      composition.composition._overrides,
+      componentId,
+      parameterId,
+      strict
+    );
+    return count;
+  }
+  flattenOverrideMap(overrides, parameterId, strict) {
+    let count = 0;
+    for (const override of Object.values(overrides)) {
+      if (!override.parameters) continue;
+      const matchingKey = this.findKeyName(override.parameters, parameterId, strict);
+      if (matchingKey === void 0) continue;
+      const blockParamValue = override.parameters[matchingKey];
+      const items = blockParamValue.value;
+      if (Array.isArray(items) && items.length === 1) {
+        const blockItem = items[0];
+        for (const [fieldId, fieldValue] of Object.entries(blockItem.fields ?? {})) {
+          override.parameters[fieldId] = fieldValue;
+        }
+      }
+      delete override.parameters[matchingKey];
+      count++;
+    }
+    return count;
+  }
+  flattenOverridesForMatchingInstances(node, overrides, componentId, parameterId, strict) {
+    let count = 0;
+    if (node.slots) {
+      for (const slotInstances of Object.values(node.slots)) {
+        if (!Array.isArray(slotInstances)) continue;
+        for (const instance of slotInstances) {
+          if (this.compareIds(instance.type, componentId, strict) && instance._id) {
+            const override = overrides[instance._id];
+            if (override?.parameters) {
+              const matchingKey = this.findKeyName(override.parameters, parameterId, strict);
+              if (matchingKey !== void 0) {
+                const blockParamValue = override.parameters[matchingKey];
+                const items = blockParamValue.value;
+                if (Array.isArray(items) && items.length === 1) {
+                  const blockItem = items[0];
+                  for (const [fieldId, fieldValue] of Object.entries(blockItem.fields ?? {})) {
+                    override.parameters[fieldId] = fieldValue;
+                  }
+                }
+                delete override.parameters[matchingKey];
+                count++;
+              }
+            }
+          }
+          count += this.flattenOverridesForMatchingInstances(instance, overrides, componentId, parameterId, strict);
+        }
+      }
+    }
+    return count;
+  }
+  findKeyName(map, key, strict) {
+    return Object.keys(map).find((k) => this.compareIds(k, key, strict));
+  }
+  findKeyInMap(map, key, strict) {
+    const k = this.findKeyName(map, key, strict);
+    return k !== void 0 ? map[k] : void 0;
+  }
+};
+
+// src/cli/commands/flatten-block-field.ts
+function createFlattenBlockFieldCommand() {
+  const command = new Command15("flatten-block-field");
+  command.description(
+    "Dissolves a $block parameter by lifting the block content type fields onto the component and extracting block item values into composition instances directly."
+  ).option("--componentId <id>", "The ID of the component that owns the block parameter").option("--parameterId <id>", "The ID of the $block parameter to flatten").option("--excludeFields <ids>", "Comma-separated list of block content type field IDs to skip when flattening").hook("preAction", (thisCommand) => {
+    const opts = thisCommand.opts();
+    const requiredOptions = [
+      { name: "componentId", flag: "--componentId" },
+      { name: "parameterId", flag: "--parameterId" }
+    ];
+    const missing = requiredOptions.filter((opt) => !opts[opt.name]).map((opt) => opt.flag);
+    if (missing.length > 0) {
+      console.error(`error: missing required options: ${missing.join(", ")}`);
+      process.exit(1);
+    }
+  }).action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const options = {
+      ...globalOpts,
+      componentId: opts.componentId,
+      parameterId: opts.parameterId,
+      excludeFields: opts.excludeFields
+    };
+    const logger = new Logger();
+    const fileSystem = new FileSystemService();
+    const componentService = new ComponentService(fileSystem);
+    const flattener = new BlockFieldFlattenerService(fileSystem, componentService, logger);
+    try {
+      const result = await flattener.flatten({
+        rootDir: options.rootDir,
+        componentsDir: options.componentsDir,
+        compositionsDir: options.compositionsDir,
+        compositionPatternsDir: options.compositionPatternsDir,
+        componentPatternsDir: options.componentPatternsDir,
+        contentTypesDir: options.contentTypesDir,
+        componentId: options.componentId,
+        parameterId: options.parameterId,
+        whatIf: options.whatIf ?? false,
+        strict: options.strict ?? false,
+        excludeFields: options.excludeFields ? options.excludeFields.split(",").map((s) => s.trim()) : []
+      });
+      logger.success(
+        `Flattened parameter "${options.parameterId}" on component "${options.componentId}": ${result.compositionsModified} composition(s), ${result.compositionPatternsModified} composition pattern(s), ${result.componentPatternsModified} component pattern(s) updated`
+      );
+    } catch (error) {
+      if (error instanceof TransformError) {
+        logger.error(error.message);
+        process.exit(1);
+      }
+      throw error;
+    }
+  });
+  return command;
+}
+
 // package.json
 var package_default = {
   name: "@uniformdev/transformer",
-  version: "1.1.29",
+  version: "1.1.31",
   description: "CLI tool for transforming Uniform.dev serialization files offline",
   type: "module",
   bin: {
@@ -5091,7 +5818,7 @@ var package_default = {
 };
 
 // src/cli/index.ts
-var program = new Command13();
+var program = new Command16();
 var appVersion = package_default.version;
 console.error(`uniform-transform v${appVersion}`);
 program.name("uniform-transform").description("CLI tool for transforming Uniform.dev serialization files offline").version(appVersion);
@@ -5116,5 +5843,8 @@ program.addCommand(createPropagateRootComponentSlotCommand());
 program.addCommand(createConvertCompositionsToEntriesCommand());
 program.addCommand(createRemoveParameterCommand());
 program.addCommand(createRemoveFieldCommand());
+program.addCommand(createAddComponentParameterCommand());
+program.addCommand(createAddContentTypeFieldCommand());
+program.addCommand(createFlattenBlockFieldCommand());
 program.parse();
 //# sourceMappingURL=index.js.map