@ikas/component-cli 1.4.0-beta.185 → 1.4.0-beta.187

package/dist/commands/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuVpC,eAAO,MAAM,qBAAqB,SAAU;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,OAA2D,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,GACf;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAqBlE;AA2uBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA0B1E;AAMD,eAAO,MAAM,kBAAkB,UAkB9B,CAAC;AAOF,eAAO,MAAM,oBAAoB,aACrB,MAAM,YACN,MAAM,gBACF,OAAO,KACpB,IAUF,CAAC;AAuEF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAwBf;AAOD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAC/B,oBAAoB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACjC,MAAM,GAAG,IAAI,CA4Cf;AAoDD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAoBf;AAUD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,eAAe,EACX;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,SAAS,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAsCf;AASD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAgBf;AA+FD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,GAAG,IAAI,CAwBf;AA85BD,wBAAgB,mBAAmB,IAAI,OAAO,CA+U7C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiXpC,eAAO,MAAM,qBAAqB,SAAU;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,OAA2D,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,GACf;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAqBlE;AAmyBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CA0B1E;AAMD,eAAO,MAAM,kBAAkB,UAkB9B,CAAC;AAOF,eAAO,MAAM,oBAAoB,aACrB,MAAM,YACN,MAAM,gBACF,OAAO,KACpB,IAUF,CAAC;AAuEF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAwBf;AAOD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,oBAAoB,CAAC,EAAE,MAAM,EAAE,EAC/B,oBAAoB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACjC,MAAM,GAAG,IAAI,CAuDf;AAoDD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAoBf;AAUD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,eAAe,EACX;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,SAAS,EACb,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAsCf;AASD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAgBf;AA+FD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,MAAM,GAAG,IAAI,CAwBf;AAuiCD,wBAAgB,mBAAmB,IAAI,OAAO,CA+X7C"}

package/dist/commands/config.js

@@ -1,7 +1,7 @@
 import { Command } from "commander";
 import * as fs from "fs";
 import * as path from "path";
-import { PROP_TYPES, toPascalCase, generateTypesFile, isBuiltInEnumTypeId, generateGlobalTypesFile, collectUsedEnumIds, generateComponentFile, generateStylesFile, generateProjectId, isValidProjectId, generateComponentId, generateUniqueId, updateBarrelExport, findPropGroup, collectPropGroupIds, movePropGroupInTree, validateFilteredComponentIds, } from "../utils/component-helpers.js";
+import { PROP_TYPES, toPascalCase, generateTypesFile, isBuiltInEnumTypeId, generateGlobalTypesFile, collectUsedEnumIds, generateComponentFile, generateStylesFile, generateProjectId, isValidProjectId, generateComponentId, generateUniqueId, updateBarrelExport, findPropGroup, collectPropGroupIds, movePropGroupInTree, validateFilteredComponentIds, visibilityGateError, } from "../utils/component-helpers.js";
 function loadConfig() {
     const configPath = path.resolve(process.cwd(), "ikas.config.json");
     if (!fs.existsSync(configPath)) {
@@ -168,6 +168,10 @@ const ALLOWED_PROP_FIELDS = new Set([
     "filteredComponentIds",
     "privateVarMap",
     "numberRangeData",
+    "requiredProp",
+    "requiredPropValue",
+    "requiredEnumOptionId",
+    "requiredEnumOptionValue",
 ]);
 // Emit the standard CLI error envelope and exit(1) when a validator returned a message; a no-op
 // when the message is null. Collapses the repeated `if (err) { console.log(...); process.exit(1) }`
@@ -178,6 +182,24 @@ function failIf(error) {
         process.exit(1);
     }
 }
+/**
+ * A `--requiredPropValue` flag as a boolean. Commander hands every flag over as a string, and this is
+ * the one place that turns it back; anything other than true/false is refused rather than coerced,
+ * since "0" or "off" silently becoming `true` is exactly the kind of gate nobody would think to
+ * check.
+ */
+function parseRequiredPropValue(raw, where) {
+    if (raw === undefined)
+        return undefined;
+    if (typeof raw === "boolean")
+        return raw;
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    failIf(`--requiredPropValue for ${where} must be "true" or "false" (got "${raw}").`);
+    return undefined;
+}
 /**
  * Validate/sanitize a numberRangeData object for a NUMBER_RANGE prop. Accepts an object
  * or a JSON string. min/max/interval are truncated to integers; only a positive interval
@@ -434,9 +456,30 @@ async function parsePropsFlag(propsJson, config, configPath) {
             ...(propType === "NUMBER_RANGE"
                 ? { numberRangeData: requireNumberRangeData(r.numberRangeData, r.name) }
                 : {}),
+            ...(r.requiredProp !== undefined
+                ? { requiredProp: r.requiredProp }
+                : {}),
+            ...(r.requiredPropValue !== undefined
+                ? { requiredPropValue: r.requiredPropValue }
+                : {}),
+            ...(r.requiredEnumOptionId !== undefined
+                ? { requiredEnumOptionId: r.requiredEnumOptionId }
+                : {}),
+            ...(r.requiredEnumOptionValue !== undefined
+                ? { requiredEnumOptionValue: r.requiredEnumOptionValue }
+                : {}),
         };
         props.push(prop);
     }
+    // Gates are checked once the whole batch is parsed: a prop may name one declared after it, and
+    // cycle detection needs every prop in hand. The batch IS the component's prop list here — the
+    // component itself does not exist yet — so it stands in as one.
+    const batch = { name: "the new component", props };
+    for (const prop of props) {
+        failIf(visibilityGateError(batch, prop, `prop "${prop.name}"`, {
+            selfPropName: prop.name,
+        }));
+    }
     return props;
 }
 // --- Subcommands ---
@@ -690,6 +733,7 @@ async function addProp(ref, options) {
         const numError = validateNumberDefaultValue(options.defaultValue, options.name);
         failIf(numError);
     }
+    const parsedVisibilityValue = parseRequiredPropValue(options.requiredPropValue, `prop "${options.name}"`);
     const parsedNumberRangeData = propType === "NUMBER_RANGE"
         ? requireNumberRangeData(options.numberRangeData, options.name)
         : undefined;
@@ -714,7 +758,21 @@ async function addProp(ref, options) {
         ...(parsedNumberRangeData
             ? { numberRangeData: parsedNumberRangeData }
             : {}),
+        ...(options.requiredProp ? { requiredProp: options.requiredProp } : {}),
+        ...(parsedVisibilityValue !== undefined
+            ? { requiredPropValue: parsedVisibilityValue }
+            : {}),
+        ...(options.requiredProp && options.requiredEnumOptionValue !== undefined
+            ? {
+                // The editor has no separate option id; the value doubles as one.
+                requiredEnumOptionId: options.requiredEnumOptionValue,
+                requiredEnumOptionValue: options.requiredEnumOptionValue,
+            }
+            : {}),
     };
+    failIf(visibilityGateError(component, newProp, `prop "${newProp.name}"`, {
+        selfPropName: newProp.name,
+    }));
     component.props.push(newProp);
     saveConfig(configPath, config);
     // Regenerate types.ts and global types
@@ -727,7 +785,6 @@ async function addProp(ref, options) {
             name: newProp.name,
             displayName: newProp.displayName,
             type: newProp.type,
-            required: newProp.required,
             ...(newProp.groupId ? { groupId: newProp.groupId } : {}),
             ...(newProp.enumTypeId ? { enumTypeId: newProp.enumTypeId } : {}),
             ...(newProp.filteredComponentIds
@@ -739,6 +796,14 @@ async function addProp(ref, options) {
             ...(newProp.numberRangeData
                 ? { numberRangeData: newProp.numberRangeData }
                 : {}),
+            ...(newProp.requiredProp
+                ? {
+                    requiredProp: newProp.requiredProp,
+                    ...(newProp.requiredEnumOptionValue !== undefined
+                        ? { requiredEnumOptionValue: newProp.requiredEnumOptionValue }
+                        : { requiredPropValue: newProp.requiredPropValue ?? true }),
+                }
+                : {}),
         },
     }));
 }
@@ -871,9 +936,9 @@ export function validateLinkDefaultValue(propType, value, propName) {
     const links = value.links;
     return firstError(links, (link, i) => validateSingleLink(link, propName, `.links[${i}]`));
 }
-const COMPONENT_SHAPE_HELP = 'A COMPONENT / COMPONENT_LIST default must be an object listing child code components: ' +
+const COMPONENT_SHAPE_HELP = "A COMPONENT / COMPONENT_LIST default must be an object listing child code components: " +
     '{ "components": [ { "codeComponentId": "<id>" } ] }. Only code components are allowed; each entry ' +
-    "needs a string \"codeComponentId\" (no componentId, no inline propValues).";
+    'needs a string "codeComponentId" (no componentId, no inline propValues).';
 /**
  * Validate a COMPONENT / COMPONENT_LIST defaultValue. Reference-only: each entry must name a code
  * component via `codeComponentId`. Rejects non-CC (`componentId`) children, missing ids, more than
@@ -887,14 +952,19 @@ export function validateComponentDefaultValue(propType, value, propName, filtere
     if (typeof value === "string") {
         return `${where} is a JSON string but must be an object. ${COMPONENT_SHAPE_HELP}`;
     }
-    if (!value || typeof value !== "object" || Array.isArray(value) || !Array.isArray(value.components)) {
+    if (!value ||
+        typeof value !== "object" ||
+        Array.isArray(value) ||
+        !Array.isArray(value.components)) {
         return `${where} must be an object with a "components" array. ${COMPONENT_SHAPE_HELP}`;
     }
     const components = value.components;
     if (propType === "COMPONENT" && components.length > 1) {
         return `${where}: a COMPONENT prop holds a single child — provide at most one entry (use COMPONENT_LIST for many).`;
     }
-    const allow = filteredComponentIds && filteredComponentIds.length ? new Set(filteredComponentIds) : null;
+    const allow = filteredComponentIds && filteredComponentIds.length
+        ? new Set(filteredComponentIds)
+        : null;
     return firstError(components, (entry, i) => {
         const at = `${where}.components[${i}]`;
         if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
@@ -904,7 +974,8 @@ export function validateComponentDefaultValue(propType, value, propName, filtere
         if ("componentId" in e && !("codeComponentId" in e)) {
             return `${at} references a non-code component (componentId). Only code components are allowed as defaults. ${COMPONENT_SHAPE_HELP}`;
         }
-        if (typeof e.codeComponentId !== "string" || e.codeComponentId.trim().length === 0) {
+        if (typeof e.codeComponentId !== "string" ||
+            e.codeComponentId.trim().length === 0) {
             return `${at} must have a non-empty string "codeComponentId". ${COMPONENT_SHAPE_HELP}`;
         }
         if (allow && !allow.has(e.codeComponentId)) {
@@ -1338,6 +1409,33 @@ async function updateProp(ref, options) {
             }
         }
     }
+    if (options.requiredProp !== undefined) {
+        if (options.requiredProp === "" || options.requiredProp === "none") {
+            // Every field goes together — see `IProp.requiredPropId`.
+            delete prop.requiredProp;
+            delete prop.requiredPropValue;
+            delete prop.requiredEnumOptionId;
+            delete prop.requiredEnumOptionValue;
+        }
+        else {
+            prop.requiredProp = options.requiredProp;
+        }
+    }
+    if (options.requiredEnumOptionValue !== undefined && prop.requiredProp) {
+        prop.requiredEnumOptionId = options.requiredEnumOptionValue;
+        prop.requiredEnumOptionValue = options.requiredEnumOptionValue;
+        delete prop.requiredPropValue;
+    }
+    if (options.requiredPropValue !== undefined && prop.requiredProp) {
+        delete prop.requiredEnumOptionId;
+        delete prop.requiredEnumOptionValue;
+        prop.requiredPropValue = parseRequiredPropValue(options.requiredPropValue, `prop "${prop.name}"`);
+    }
+    // Re-checked on every update, not only when a visibility flag is passed: flipping `required`, or
+    // renaming the prop this one hangs on, can invalidate a gate that was sound when it was written.
+    failIf(visibilityGateError(component, prop, `prop "${prop.name}"`, {
+        selfPropName: prop.name,
+    }));
     saveConfig(configPath, config);
     // Regenerate types.ts and global types
     regenerateTypes(component, undefined, config);
@@ -1349,7 +1447,6 @@ async function updateProp(ref, options) {
             name: prop.name,
             displayName: prop.displayName,
             type: prop.type,
-            required: prop.required,
             ...(prop.groupId ? { groupId: prop.groupId } : {}),
             ...(prop.typeId ? { typeId: prop.typeId } : {}),
             ...(prop.enumTypeId ? { enumTypeId: prop.enumTypeId } : {}),
@@ -1360,6 +1457,14 @@ async function updateProp(ref, options) {
             ...(prop.numberRangeData
                 ? { numberRangeData: prop.numberRangeData }
                 : {}),
+            ...(prop.requiredProp
+                ? {
+                    requiredProp: prop.requiredProp,
+                    ...(prop.requiredEnumOptionValue !== undefined
+                        ? { requiredEnumOptionValue: prop.requiredEnumOptionValue }
+                        : { requiredPropValue: prop.requiredPropValue ?? true }),
+                }
+                : {}),
         },
     }));
 }
@@ -1446,7 +1551,24 @@ function addPropGroup(ref, options) {
         id: options.id,
         name: options.name,
         ...(options.description ? { description: options.description } : {}),
+        ...(options.requiredProp ? { requiredProp: options.requiredProp } : {}),
+        ...(options.requiredProp && options.requiredEnumOptionValue !== undefined
+            ? {
+                requiredEnumOptionId: options.requiredEnumOptionValue,
+                requiredEnumOptionValue: options.requiredEnumOptionValue,
+            }
+            : {}),
+        ...(options.requiredProp &&
+            options.requiredEnumOptionValue === undefined &&
+            options.requiredPropValue !== undefined
+            ? {
+                requiredPropValue: parseRequiredPropValue(options.requiredPropValue, `group "${options.id}"`),
+            }
+            : {}),
     };
+    failIf(visibilityGateError(component, newGroup, `group "${newGroup.id}"`, {
+        group: newGroup,
+    }));
     if (options.parent) {
         const found = findPropGroup(component.propGroups, options.parent);
         if (!found) {
@@ -1478,6 +1600,14 @@ function addPropGroup(ref, options) {
             id: newGroup.id,
             name: newGroup.name,
             ...(options.parent ? { parentId: options.parent } : {}),
+            ...(newGroup.requiredProp
+                ? {
+                    requiredProp: newGroup.requiredProp,
+                    ...(newGroup.requiredEnumOptionValue !== undefined
+                        ? { requiredEnumOptionValue: newGroup.requiredEnumOptionValue }
+                        : { requiredPropValue: newGroup.requiredPropValue ?? true }),
+                }
+                : {}),
         },
     }));
 }
@@ -1503,6 +1633,34 @@ function updatePropGroup(ref, options) {
         found.group.name = options.name;
     if (options.description !== undefined)
         found.group.description = options.description || undefined;
+    if (options.requiredProp !== undefined) {
+        if (options.requiredProp === "" || options.requiredProp === "none") {
+            // Every field goes together — see `IThemePropGroup.requiredPropId`.
+            delete found.group.requiredProp;
+            delete found.group.requiredPropValue;
+            delete found.group.requiredEnumOptionId;
+            delete found.group.requiredEnumOptionValue;
+        }
+        else {
+            found.group.requiredProp = options.requiredProp;
+        }
+    }
+    if (options.requiredEnumOptionValue !== undefined &&
+        found.group.requiredProp) {
+        found.group.requiredEnumOptionId = options.requiredEnumOptionValue;
+        found.group.requiredEnumOptionValue = options.requiredEnumOptionValue;
+        delete found.group.requiredPropValue;
+    }
+    if (options.requiredPropValue !== undefined && found.group.requiredProp) {
+        delete found.group.requiredEnumOptionId;
+        delete found.group.requiredEnumOptionValue;
+        found.group.requiredPropValue = parseRequiredPropValue(options.requiredPropValue, `group "${found.group.id}"`);
+    }
+    // Re-checked on every update: moving a prop into this group can invalidate a gate that was sound
+    // when it was written.
+    failIf(visibilityGateError(component, found.group, `group "${found.group.id}"`, {
+        group: found.group,
+    }));
     saveConfig(configPath, config);
     console.log(JSON.stringify({
         success: true,
@@ -1510,6 +1668,16 @@ function updatePropGroup(ref, options) {
         updatedPropGroup: {
             id: found.group.id,
             name: found.group.name,
+            ...(found.group.requiredProp
+                ? {
+                    requiredProp: found.group.requiredProp,
+                    ...(found.group.requiredEnumOptionValue !== undefined
+                        ? {
+                            requiredEnumOptionValue: found.group.requiredEnumOptionValue,
+                        }
+                        : { requiredPropValue: found.group.requiredPropValue ?? true }),
+                }
+                : {}),
         },
     }));
 }
@@ -1762,6 +1930,9 @@ function updateEnum(options) {
         }
         enumType.enumOptions = enumOptions;
     }
+    // Stamp so the editor accepts this as newer than its own copy (it otherwise
+    // only adds unknown ids and would revert this edit on its next sync-types).
+    enumType.updatedAt = Date.now();
     saveConfig(configPath, config);
     // Regenerate global types and all component types
     regenerateGlobalTypes(config);
@@ -1859,6 +2030,9 @@ export function createConfigCommand() {
         .option("--filteredComponentIds <json>", "JSON array of component IDs to restrict selection (for COMPONENT/COMPONENT_LIST)")
         .option("--privateVarMap <json>", "JSON object mapping variable keys to {id, typeId} (for COMPONENT/COMPONENT_LIST)")
         .option("--numberRangeData <json>", 'JSON slider config for NUMBER_RANGE props, e.g. \'{"min":0,"max":100,"interval":5,"unit":"px"}\'')
+        .option("--requiredProp <propName>", 'Show this only while the named BOOLEAN or ENUM prop satisfies the condition ("Koşullu Prop")')
+        .option("--requiredPropValue <boolean>", "For a BOOLEAN --requiredProp: which state shows it, true (default) or false")
+        .option("--requiredEnumOptionValue <value>", "For an ENUM --requiredProp: the option value that shows it")
         .action((options) => {
         addProp({ id: options.componentId, name: options.component }, options);
     });
@@ -1879,6 +2053,9 @@ export function createConfigCommand() {
         .option("--filteredComponentIds <json>", "JSON array of component IDs (use 'none' to clear)")
         .option("--privateVarMap <json>", "JSON object mapping variable keys to {id, typeId} (use 'none' to clear)")
         .option("--numberRangeData <json>", "JSON slider config for NUMBER_RANGE props (use 'none' to clear)")
+        .option("--requiredProp <propName>", "BOOLEAN or ENUM prop that gates this prop in the editor panel (use 'none' to clear)")
+        .option("--requiredPropValue <boolean>", "For a BOOLEAN --requiredProp: which state shows it, true (default) or false")
+        .option("--requiredEnumOptionValue <value>", "For an ENUM --requiredProp: the option value that shows it")
         .action((options) => {
         updateProp({ id: options.componentId, name: options.component }, options);
     });
@@ -1920,6 +2097,9 @@ export function createConfigCommand() {
         .requiredOption("--name <name>", "Display name in editor")
         .option("--description <description>", "Group description")
         .option("--parent <parentId>", "Parent group ID (for nesting, max 1 level)")
+        .option("--requiredProp <propName>", 'Show this only while the named BOOLEAN or ENUM prop satisfies the condition ("Koşullu Prop")')
+        .option("--requiredPropValue <boolean>", "For a BOOLEAN --requiredProp: which state shows it, true (default) or false")
+        .option("--requiredEnumOptionValue <value>", "For an ENUM --requiredProp: the option value that shows it")
         .action((options) => {
         addPropGroup({ id: options.componentId, name: options.component }, options);
     });
@@ -1931,6 +2111,9 @@ export function createConfigCommand() {
         .requiredOption("--id <id>", "Group ID to update")
         .option("--name <name>", "New display name")
         .option("--description <description>", "New description")
+        .option("--requiredProp <propName>", "BOOLEAN or ENUM prop that gates this group in the editor panel (use 'none' to clear)")
+        .option("--requiredPropValue <boolean>", "For a BOOLEAN --requiredProp: which state shows it, true (default) or false")
+        .option("--requiredEnumOptionValue <value>", "For an ENUM --requiredProp: the option value that shows it")
         .action((options) => {
         updatePropGroup({ id: options.componentId, name: options.component }, options);
     });