@masterteam/form-builder 0.0.2 → 0.0.3

package/BACKEND_API_SPEC.md

@@ -1,338 +0,0 @@
-# Form Builder - Backend API Specification
-
-## Data Models
-
-### FormConfiguration
-
-```typescript
-interface FormConfiguration {
-  isActive: boolean;
-  sections: FormSection[];
-}
-```
-
-### FormSection
-
-```typescript
-interface FormSection {
-  id: string;
-  name: {
-    en: string;
-    ar: string;
-  };
-  order: number;
-  fields: FormField[];
-}
-```
-
-### FormField
-
-```typescript
-interface FormField {
-  id: string;
-  sectionId: string;             // Parent section reference
-  propertyId: number;            // Reference to PropertyItem.id
-  width: "25" | "50" | "100";
-  order: number;
-  hiddenInCreation?: boolean;
-}
-```
-
-> **Note:** `PropertyItem` is already defined in `@masterteam/properties` module.
-
-### Response Structure
-
-```typescript
-interface Response<T> {
-  endpoint: string;
-  status: number;
-  code: number;
-  locale: string;
-  message?: string | null;
-  errors?: any | null;
-  data: T;
-  cacheSession?: string;
-}
-```
-
----
-
-## API Endpoints
-
-### Base URL
-```
-/api/v1/form-configurations
-```
-
-### URL Pattern
-```
-/api/v1/form-configurations/{moduleType}/{moduleId}
-/api/v1/form-configurations/{levelType}/{levelId}/{moduleType}/{moduleId}
-```
-
-**Examples:**
-- `/api/v1/form-configurations/level/1` - Level form configuration
-- `/api/v1/form-configurations/module/123` - Direct module
-- `/api/v1/form-configurations/level/1/module/123` - Module nested under level
-
----
-
-## Form Configuration
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| GET | `/{moduleType}/{moduleId}` | Get form configuration |
-| GET | `/{levelType}/{levelId}/{moduleType}/{moduleId}` | Get nested form configuration |
-
----
-
-## Section Operations
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| POST | `.../sections` | Add section |
-| PUT | `.../sections/{sectionId}` | Update section |
-| DELETE | `.../sections/{sectionId}` | Delete section |
-
----
-
-## Field Operations
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| POST | `.../sections/{sectionId}/fields` | Add field to section |
-| PUT | `.../sections/{sectionId}/fields/{fieldId}` | Update field |
-| PUT | `.../sections/{sectionId}/fields/{fieldId}/move` | Move field to another section |
-| DELETE | `.../sections/{sectionId}/fields/{fieldId}` | Delete field |
-
----
-
-## Sample Requests & Responses
-
-### Get Form Configuration
-
-**GET /api/v1/form-configurations/level/1/module/123**
-
-```json
-{
-  "endpoint": "/api/v1/form-configurations/level/1/module/123",
-  "status": 200,
-  "code": 0,
-  "locale": "en",
-  "message": null,
-  "data": {
-    "isActive": false,
-    "sections": [
-      {
-        "id": "section-1",
-        "name": { "en": "Basic Info", "ar": "معلومات أساسية" },
-        "order": 0,
-        "fields": [
-          { "id": "field-1", "sectionId": "section-1", "propertyId": 101, "width": "100", "order": 0, "hiddenInCreation": false },
-          { "id": "field-2", "sectionId": "section-1", "propertyId": 102, "width": "50", "order": 1, "hiddenInCreation": true }
-        ]
-      },
-      {
-        "id": "section-2",
-        "name": { "en": "Details", "ar": "تفاصيل" },
-        "order": 1,
-        "fields": []
-      }
-    ]
-  }
-}
-```
-
----
-
-### Section CRUD
-
-**POST .../sections** - Add Section
-
-Request:
-```json
-{
-  "name": { "en": "New Section", "ar": "قسم جديد" },
-  "order": 2
-}
-```
-
-Response:
-```json
-{
-  "status": 201,
-  "code": 0,
-  "locale": "en",
-  "data": {
-    "id": "section-3",
-    "name": { "en": "New Section", "ar": "قسم جديد" },
-    "order": 2,
-    "fields": []
-  }
-}
-```
-
-**PUT .../sections/section-3** - Update Section
-
-Request:
-```json
-{
-  "name": { "en": "Updated Section", "ar": "قسم محدث" },
-  "order": 0
-}
-```
-
-Response:
-```json
-{
-  "status": 200,
-  "code": 0,
-  "locale": "en",
-  "data": {
-    "id": "section-3",
-    "name": { "en": "Updated Section", "ar": "قسم محدث" },
-    "order": 0,
-    "fields": []
-  }
-}
-```
-
-**DELETE .../sections/section-3** - Delete Section
-
-Response:
-```json
-{
-  "status": 200,
-  "code": 0,
-  "locale": "en",
-  "data": {
-    "id": "section-3"
-  }
-}
-```
-
----
-
-### Field CRUD
-
-**POST .../sections/section-1/fields** - Add Field
-
-Request:
-```json
-{
-  "propertyId": 103,
-  "width": "50",
-  "order": 2,
-  "hiddenInCreation": false
-}
-```
-
-Response:
-```json
-{
-  "status": 201,
-  "code": 0,
-  "locale": "en",
-  "data": {
-    "id": "field-3",
-    "sectionId": "section-1",
-    "propertyId": 103,
-    "width": "50",
-    "order": 2,
-    "hiddenInCreation": false
-  }
-}
-```
-
-**PUT .../sections/section-1/fields/field-3** - Update Field
-
-Request:
-```json
-{
-  "width": "100",
-  "order": 0,
-  "hiddenInCreation": true
-}
-```
-
-Response:
-```json
-{
-  "status": 200,
-  "code": 0,
-  "locale": "en",
-  "data": {
-    "id": "field-3",
-    "sectionId": "section-1",
-    "propertyId": 103,
-    "width": "100",
-    "order": 0,
-    "hiddenInCreation": true
-  }
-}
-```
-
-**DELETE .../sections/section-1/fields/field-3** - Delete Field
-
-Response:
-```json
-{
-  "status": 200,
-  "code": 0,
-  "locale": "en",
-  "data": {
-    "id": "field-3",
-    "sectionId": "section-1"
-  }
-}
-```
-
----
-
-### Move Field Between Sections
-
-**PUT .../sections/section-1/fields/field-2/move** - Move Field
-
-Request:
-```json
-{
-  "targetSectionId": "section-2",
-  "order": 0
-}
-```
-
-Response:
-```json
-{
-  "status": 200,
-  "code": 0,
-  "locale": "en",
-  "data": {
-    "id": "field-2",
-    "sectionId": "section-2",
-    "propertyId": 102,
-    "width": "50",
-    "order": 0,
-    "hiddenInCreation": true
-  }
-}
-```
-
----
-
-## Error Codes
-
-| HTTP Status | Code | Description |
-|-------------|------|-------------|
-| 400 | VALIDATION_ERROR | Request validation failed |
-| 404 | NOT_FOUND | Resource not found |
-| 409 | VERSION_CONFLICT | Optimistic locking conflict |
-
----
-
-## Notes
-
-1. `propertyId` must reference a valid `PropertyItem.id`
-2. `order` is auto-calculated from array index if not provided
-3. All mutation responses return the affected record for auto-reflect in UI
-4. Deleting a section will also delete all fields within it

package/angular.json

@@ -1,26 +0,0 @@
-{
-  "$schema": "../../../node_modules/@angular/cli/lib/config/schema.json",
-  "version": 1,
-  "cli": {
-    "packageManager": "pnpm",
-    "analytics": false
-  },
-  "newProjectRoot": "projects",
-  "projects": {
-    "@masterteam/icons": {
-      "projectType": "library",
-      "root": "./",
-      "sourceRoot": "src",
-      "prefix": "mt",
-      "architect": {
-        "build": {
-          "builder": "@angular-devkit/build-angular:ng-packagr",
-          "options": {
-            "project": "ng-package.json",
-            "tsConfig": "./tsconfig.json"
-          }
-        }
-      }
-    }
-  }
-}

package/ng-package.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json",
-  "dest": "../../../dist/masterteam/form-builder",
-  "assets": ["assets/"],
-  "lib": {
-    "entryFile": "src/public-api.ts"
-  },
-  "allowedNonPeerDependencies": [
-    "@masterteam/components",
-    "@masterteam/icons",
-    "@masterteam/forms"
-  ]
-}

package/src/lib/fb-field-conditions/condition-constants.ts

@@ -1,262 +0,0 @@
-/**
- * Condition Formula Constants
- * Static functions and operators for condition formulas (Show/Hide/Enable/Disable)
- */
-
-import type {
-  FunctionCategoryGroup,
-  OperatorDefinition,
-} from '@masterteam/components/formula';
-
-/**
- * Functions for field conditions
- */
-export const CONDITION_FUNCTION_CATEGORIES: FunctionCategoryGroup[] = [
-  {
-    name: 'Logic',
-    displayName: 'Field Visibility',
-    functions: [
-      {
-        name: 'SHOW_IF',
-        category: 'Logic',
-        description: 'Show this field when condition is true',
-        signature: 'SHOW_IF(condition)',
-        parameters: [
-          {
-            name: 'condition',
-            type: 'boolean',
-            description: 'When true, field is visible',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: [
-          'SHOW_IF(@Status == "Active")',
-          'SHOW_IF(@Type == "Custom")',
-        ],
-      },
-      {
-        name: 'HIDE_IF',
-        category: 'Logic',
-        description: 'Hide this field when condition is true',
-        signature: 'HIDE_IF(condition)',
-        parameters: [
-          {
-            name: 'condition',
-            type: 'boolean',
-            description: 'When true, field is hidden',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: ['HIDE_IF(@Status == "Closed")', 'HIDE_IF(ISNULL(@Parent))'],
-      },
-      {
-        name: 'DISABLE_IF',
-        category: 'Logic',
-        description: 'Disable this field when condition is true',
-        signature: 'DISABLE_IF(condition)',
-        parameters: [
-          {
-            name: 'condition',
-            type: 'boolean',
-            description: 'When true, field is disabled',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: [
-          'DISABLE_IF(@IsLocked == true)',
-          'DISABLE_IF(@Status == "Approved")',
-        ],
-      },
-      {
-        name: 'ENABLE_IF',
-        category: 'Logic',
-        description: 'Enable this field when condition is true',
-        signature: 'ENABLE_IF(condition)',
-        parameters: [
-          {
-            name: 'condition',
-            type: 'boolean',
-            description: 'When true, field is enabled',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: [
-          'ENABLE_IF(@Status == "Draft")',
-          'ENABLE_IF(@CanEdit == true)',
-        ],
-      },
-    ],
-  },
-  {
-    name: 'Aggregation',
-    displayName: 'Logic Helpers',
-    functions: [
-      {
-        name: 'AND',
-        category: 'Aggregation',
-        description: 'Returns true if all conditions are true',
-        signature: 'AND(condition1, condition2)',
-        parameters: [
-          {
-            name: 'condition1',
-            type: 'boolean',
-            description: 'First condition',
-            required: true,
-          },
-          {
-            name: 'condition2',
-            type: 'boolean',
-            description: 'Second condition',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: ['AND(@Status == "Active", @Priority > 0)'],
-      },
-      {
-        name: 'OR',
-        category: 'Aggregation',
-        description: 'Returns true if any condition is true',
-        signature: 'OR(condition1, condition2)',
-        parameters: [
-          {
-            name: 'condition1',
-            type: 'boolean',
-            description: 'First condition',
-            required: true,
-          },
-          {
-            name: 'condition2',
-            type: 'boolean',
-            description: 'Second condition',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: ['OR(@Status == "Active", @Status == "Pending")'],
-      },
-      {
-        name: 'NOT',
-        category: 'Aggregation',
-        description: 'Returns the opposite of the condition',
-        signature: 'NOT(condition)',
-        parameters: [
-          {
-            name: 'condition',
-            type: 'boolean',
-            description: 'The condition to negate',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: ['NOT(@IsCompleted)'],
-      },
-      {
-        name: 'ISNULL',
-        category: 'Aggregation',
-        description: 'Returns true if value is null or empty',
-        signature: 'ISNULL(value)',
-        parameters: [
-          {
-            name: 'value',
-            type: 'any',
-            description: 'The value to check',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: ['ISNULL(@Description)'],
-      },
-      {
-        name: 'CONTAINS',
-        category: 'Aggregation',
-        description: 'Returns true if text contains the search string',
-        signature: 'CONTAINS(text, search)',
-        parameters: [
-          {
-            name: 'text',
-            type: 'string',
-            description: 'The text to search in',
-            required: true,
-          },
-          {
-            name: 'search',
-            type: 'string',
-            description: 'The string to search for',
-            required: true,
-          },
-        ],
-        returnType: 'boolean',
-        examples: ['CONTAINS(@Name, "Project")'],
-      },
-    ],
-  },
-];
-
-/**
- * Operators for conditions
- */
-export const CONDITION_OPERATORS: OperatorDefinition[] = [
-  // Comparison
-  {
-    symbol: '==',
-    name: 'Equal',
-    type: 'comparison',
-    description: 'Equal to',
-    precedence: 3,
-  },
-  {
-    symbol: '!=',
-    name: 'Not Equal',
-    type: 'comparison',
-    description: 'Not equal to',
-    precedence: 3,
-  },
-  {
-    symbol: '>',
-    name: 'Greater Than',
-    type: 'comparison',
-    description: 'Greater than',
-    precedence: 4,
-  },
-  {
-    symbol: '<',
-    name: 'Less Than',
-    type: 'comparison',
-    description: 'Less than',
-    precedence: 4,
-  },
-  {
-    symbol: '>=',
-    name: 'Greater or Equal',
-    type: 'comparison',
-    description: 'Greater than or equal',
-    precedence: 4,
-  },
-  {
-    symbol: '<=',
-    name: 'Less or Equal',
-    type: 'comparison',
-    description: 'Less than or equal',
-    precedence: 4,
-  },
-  // Logical
-  {
-    symbol: '&&',
-    name: 'And',
-    type: 'logical',
-    description: 'Logical AND',
-    precedence: 2,
-  },
-  {
-    symbol: '||',
-    name: 'Or',
-    type: 'logical',
-    description: 'Logical OR',
-    precedence: 1,
-  },
-];

package/src/lib/fb-field-conditions/fb-field-conditions.html

@@ -1,35 +0,0 @@
-<ng-container *transloco="let t; prefix: 'formBuilder'">
-  <div [class]="[modalService.contentClass, 'p-4', 'overflow-y-hidden!']">
-    <div class="mt-4 h-full overflow-y-auto pb-10 flex flex-col gap-3">
-      <!-- Formula Toolbar -->
-      <mt-formula-toolbar
-        [knownProperties]="propertyKeys()"
-        [functionCategories]="functionCategories"
-        [operators]="operators"
-        [labels]="toolbarLabels"
-        (onBlockInsert)="onBlockInsert($event)"
-      />
-      <!-- Formula Editor -->
-      <mt-formula-editor
-        #editor
-        [placeholder]="t('build-condition-formula')"
-        [formControl]="formulaControl"
-      />
-    </div>
-  </div>
-
-  <div [class]="modalService.footerClass">
-    <mt-button
-      [label]="t('cancel')"
-      severity="secondary"
-      [disabled]="submitting()"
-      (onClick)="onCancel()"
-    />
-    <mt-button
-      [label]="t('save')"
-      severity="primary"
-      [loading]="submitting()"
-      (onClick)="onSave()"
-    />
-  </div>
-</ng-container>