@checkstack/ui 1.1.5 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @checkstack/ui
 
+## 1.2.0
+
+### Minor Changes
+
+- 23c80bc: ### Jira Data Center Support
+
+  Added support for on-premise Jira Data Center installations alongside existing Jira Cloud support:
+
+  - **Authentication mode switching**: New `authMode` field (`cloud` | `datacenter`) on connection configuration. Cloud uses Basic Auth (email + API token), Data Center uses Bearer Auth (Personal Access Token).
+  - **API version routing**: Automatically selects REST API v3 for Cloud and v2 for Data Center.
+  - **Description format**: Cloud uses Atlassian Document Format (ADF), Data Center uses plain text.
+  - **Connection schema v2**: Backward-compatible — defaults to `cloud` mode for existing connections.
+
+  ### DynamicForm `x-hidden-when` Conditional Visibility
+
+  New generic platform feature for conditionally hiding form fields based on sibling field values:
+
+  - Added `x-hidden-when` metadata extension to `ConfigMeta` and `JsonSchemaProperty`.
+  - DynamicForm automatically hides fields and skips their validation when conditions match.
+  - Used by Jira integration to hide the email field when `authMode` is `datacenter`.
+
 ## 1.1.5
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/ui",
-  "version": "1.1.5",
+  "version": "1.2.0",
   "type": "module",
   "main": "src/index.ts",
   "dependencies": {

package/src/components/DynamicForm/DynamicForm.tsx

@@ -3,7 +3,7 @@ import React from "react";
 import { EmptyState } from "../../index";
 
 import type { DynamicFormProps } from "./types";
-import { extractDefaults, isValueEmpty } from "./utils";
+import { extractDefaults, isValueEmpty, isFieldHiddenByCondition } from "./utils";
 import { FormField } from "./FormField";
 
 /**
@@ -50,6 +50,13 @@ export const DynamicForm: React.FC<DynamicFormProps> = ({
       // Skip hidden fields - they are auto-populated
       if (propSchema["x-hidden"]) continue;
 
+      // Skip conditionally hidden fields - they are not visible
+      if (
+        propSchema["x-hidden-when"] &&
+        isFieldHiddenByCondition(propSchema["x-hidden-when"], value)
+      )
+        continue;
+
       if (isValueEmpty(value[key], propSchema)) {
         isValid = false;
         break;
@@ -79,7 +86,15 @@ export const DynamicForm: React.FC<DynamicFormProps> = ({
   return (
     <div className="space-y-6">
       {Object.entries(schema.properties)
-        .filter(([, propSchema]) => !propSchema["x-hidden"])
+        .filter(([, propSchema]) => {
+          if (propSchema["x-hidden"]) return false;
+          if (
+            propSchema["x-hidden-when"] &&
+            isFieldHiddenByCondition(propSchema["x-hidden-when"], value)
+          )
+            return false;
+          return true;
+        })
         .map(([key, propSchema]) => {
           const isRequired = schema.required?.includes(key);
           const label = key.charAt(0).toUpperCase() + key.slice(1);

package/src/components/DynamicForm/types.ts

@@ -21,6 +21,7 @@ export interface JsonSchemaProperty extends JsonSchemaPropertyCore<JsonSchemaPro
   "x-hidden"?: boolean; // Field should be hidden in form (auto-populated)
   "x-searchable"?: boolean; // Shows search input for filtering dropdown options
   "x-editor-types"?: EditorType[]; // Available editor types for multi-type input
+  "x-hidden-when"?: Record<string, string[]>; // Conditionally hide based on sibling field values
 }
 
 /** Option returned by an options resolver */

package/src/components/DynamicForm/utils.test.ts

@@ -5,6 +5,7 @@ import {
   extractDefaults,
   getCleanDescription,
   isValueEmpty,
+  isFieldHiddenByCondition,
   NONE_SENTINEL,
   parseSelectValue,
   serializeFormData,
@@ -398,3 +399,71 @@ describe("detectEditorType", () => {
     });
   });
 });
+
+// =============================================================================
+// Conditional Visibility Tests
+// =============================================================================
+
+describe("isFieldHiddenByCondition", () => {
+  it("returns true when sibling value matches a value in the array", () => {
+    const conditions = { authMode: ["datacenter"] };
+    const formValues = { authMode: "datacenter" };
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(true);
+  });
+
+  it("returns true when sibling value matches any value in the array", () => {
+    const conditions = { authMode: ["datacenter", "server"] };
+    const formValues = { authMode: "server" };
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(true);
+  });
+
+  it("returns false when sibling value does not match", () => {
+    const conditions = { authMode: ["datacenter"] };
+    const formValues = { authMode: "cloud" };
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(false);
+  });
+
+  it("returns false when sibling field is missing (coerces to empty string)", () => {
+    const conditions = { authMode: ["datacenter"] };
+    const formValues = {};
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(false);
+  });
+
+  it("returns true when sibling field is missing and empty string is in the value list", () => {
+    const conditions = { authMode: [""] };
+    const formValues = {};
+    expect(isFieldHiddenByCondition(conditions, formValues)).toBe(true);
+  });
+
+  it("handles multiple conditions with OR semantics (any match hides)", () => {
+    const conditions = {
+      authMode: ["datacenter"],
+      environment: ["staging"],
+    };
+    // Only authMode matches
+    expect(
+      isFieldHiddenByCondition(conditions, {
+        authMode: "datacenter",
+        environment: "production",
+      }),
+    ).toBe(true);
+    // Only environment matches
+    expect(
+      isFieldHiddenByCondition(conditions, {
+        authMode: "cloud",
+        environment: "staging",
+      }),
+    ).toBe(true);
+    // Neither matches
+    expect(
+      isFieldHiddenByCondition(conditions, {
+        authMode: "cloud",
+        environment: "production",
+      }),
+    ).toBe(false);
+  });
+
+  it("returns false for empty conditions object", () => {
+    expect(isFieldHiddenByCondition({}, { authMode: "cloud" })).toBe(false);
+  });
+});

package/src/components/DynamicForm/utils.ts

@@ -72,6 +72,22 @@ export function isValueEmpty(
 /** Sentinel value used to represent "None" selection in Select components */
 export const NONE_SENTINEL = "__none__";
 
+/**
+ * Evaluate x-hidden-when conditions against current form values.
+ * Returns true if the field should be hidden.
+ *
+ * Each condition maps a sibling field name to values that trigger hiding.
+ * The field is hidden if ANY condition matches (OR semantics).
+ */
+export function isFieldHiddenByCondition(
+  conditions: Record<string, string[]>,
+  formValues: Record<string, unknown>,
+): boolean {
+  return Object.entries(conditions).some(([field, values]) =>
+    values.includes(String(formValues[field] ?? "")),
+  );
+}
+
 /**
  * Converts a select value to the actual form value.
  * Handles the "None" sentinel value by returning undefined.