# @servicenow/ui-types

> Collection of UI Framework on Next Experience data types to provide UIB the ability to auto-wire components and to share common type schemas.

Latest version **24.1.1** (published 2023-08-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install @servicenow/ui-types
pnpm add @servicenow/ui-types
yarn add @servicenow/ui-types
bun add @servicenow/ui-types
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 24.1.1 |
| Published | 2023-08-04 |
| First published | 2020-09-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 35.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | mdwragg, crystal.barnes, now-build, cuong.tran, sdivatia, huichuan |

## Links

- npm: https://www.npmjs.com/package/@servicenow/ui-types
- npm.io page: https://npm.io/package/@servicenow/ui-types

## Recent versions

- 24.1.1 (latest) — 2023-08-04
- 19.4.2 (quebec) — 2021-01-20
- 18.2.5 (paris) — 2020-09-15

## README

# @servicenow/ui-types

Collection of UI Framework on Next Experience data types to provide UIB the ability to auto-wire components and to share common type schemas.

If you are unfamiliar with UI Framework on Next Experience's type schema or JSON Schema, please visit its [documentation](https://developer.servicenow.com/dev.do#!/guide/paris/now-experience/ui-framework/now-experience-ui-framework-101/type-schema).

To contribute to this repo, see [CONTRIBUTING.md](CONTRIBUTING.md).

- [Usage](#usage)
  - [Primitives](#primitives)
  - [Sets](#sets)
- [API](#api)
  - [Primitives](#primitives-api)
  - [Sets](#sets-api)

## Usage

`@servicenow/ui-types` has two categories of exports: primitives and sets.

### Primitives

Primitives are the building blocks for your UI Framework on Next Experience schemas. They are a set of commonly used types for properties and action payloads for you to use. All primitives are JSON Schema objects.

To use primitives, you can import them from `@servicenow/ui-types`:

```js
import {sysId} from '@servicenow/ui-types';
import {createCustomElement} from '@servicenow/ui-core';

createCustomElement('my-component', {
	properties: {
		sysId: {
			schema: sysId
		}
	}
});
```

`sysId` is one of the primitives and has the JSON Schema rules to make sure users pass in a valid sysId to your component.

If you need to augment the type, you can combine the primitive with your own schema. Please see JSON Schema's documentation on [how to combine schemas](https://json-schema.org/understanding-json-schema/reference/combining.html). For example, let's say your property is a `table` primitive type but you want to refine it to only be one of a handful of tables. You can use `allOf` to acheive that:

```js
import {table} from '@servicenow/ui-types';

createCustomElement('my-component', {
	properties: {
		table: {
			schema: {
				allOf: [table, {enum: ['table_one', 'table_two', 'table_three']}]
			}
		}
	}
});
```

### Sets

Sets are a grouping of primitives that are commonly used together. Using sets in your component definitions will help UIB auto-wire your component when it is dropped onto a page: if there is a data broker on the page that already uses the same set as your component, UIB can ask the user if they want to automatically wire that data broker to your properties!

```js
import {record} from '@servicenow/ui-types';
import {createCustomElement} from '@servicenow/ui-core';

createCustomElement('my-component', {
  properties: {
    table: {
      schema: record.table
    }
    sysId: {
      schema: record.sysId
    }
  }
});
```

## API

### Primitives API

- `table`: string
- `sysId`: string
- `query`: string

### Sets API

- `record`
  - `sysId`: required
  - `table`: required
  - `view`: optional
- `list`
  - `table`: required
  - `query`: required
  - `page`: optional
  - `recordsPerPage`: optional

---
_Source: https://npm.io/package/@servicenow/ui-types · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._