# About KalmiaJSF

 :construction: Documentation for this project is still under construction.:construction: 

Kalmia **J**SON **S**chema **F**orm (JSF) is a framework meant to automatically generate an Angular form complete with validation based on JSON instructions. Additionally, the same JSON definition can be used on backend services in order to ensure the correct data model and validity of data.

It uses JavaScript, is built with and fully supports [TypeScript](http://www.typescriptlang.org/) (yet still enables developers to code in pure JavaScript). For rendering UI forms we use JSF APP (`@kalmia/jsf-app`) written as Angular library so it can be easily imported into your Angular project as an Angular library. For backend usage you will find `@kalmia/jsf-common` package.

|                   | Frontend (Angular)   | Backend (NodeJs)     |
| ----------------- | -------------------- | -------------------- |
| Render form       | :white\_check\_mark: | :no\_entry\_sign:    |
| Validate form     | :white\_check\_mark: | :white\_check\_mark: |
| Custom conditions | :white\_check\_mark: | :white\_check\_mark: |
| Data model        | :white\_check\_mark: | :white\_check\_mark: |

#### Terminology

| Term           | Description                                                                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Schema         | Schema defines data model structure, format and validation/requrment rules. Schema is following basic standarts defined in [JSON Schema](https://json-schema.org/) 2019-09 draft. |
| Layout         | Layout defines how data from schema will be displayed in form UI.                                                                                                                 |
| JSF definition | JSON defining schema and layout.                                                                                                                                                  |
| JSF document   | JSON containing JSF definition and values from the form.                                                                                                                          |
| JSF component  | Wrapped JSF form reusable in other forms.                                                                                                                                         |
| JSF page       | Wrapped JSF form intended as entry point.                                                                                                                                         |

### Requirements <a href="#requirements" id="requirements"></a>

If using on **front-end**:

* Angular 9 or above

If using on **back-end**, there are no special requirements.

### License

**KamiaJSF** is licensed under [GPLv3](https://www.gnu.org/licenses/quick-guide-gplv3.html).

### Quick usage overview

#### JSF-APP library component usage

```markup
<jsf-kal-jsf-doc 
      [doc]="{ 'schema': { ... }, 'layout': { ... } }"  
      [enableThemeRender]="true"
></jsf-kal-jsf-doc>
```

#### Usage in code

```typescript
const builder: JsfBuilder = await JsfBuilder.create({
  "schema": { ... },
  "layout": { ... }
});
```

#### Simple structure

JSF definition in a basic form consists of `schema` (data model) and `layout` (UI).

```javascript
{
  "schema": { ... },
  "layout": { ... }
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://jsf.gitbook.io/jsf/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.