Definition

Generate typescript type definitions and enumerations from business definition json records.

Install

npm i definition

Usage

Create config file.

definition.config.mjs

/**
 * @return {import('definition').ConfigOptions}
 */
export default () => {
  return {
    dir: "./jsons",
    output: "./definitions",
  };
};

See ConfigOptions Options for details.

Create json records in target directory.

./jsons/hello.json

[
  { "key": "hello-1", "value": "hello", "label": "cba" },
  { "key": "hello-2", "value": "hello2", "label": "cba2" }
]

Records is extendable, for example { "key": "hello-1", "value": "hello", "label": "cba", "createBy": "god" }, is okay.

value should be string or number.

key and value are required, and key can be customized via the configuration file.

Run command

npx def generate # or npx def g

or add command to scripts with npm run

{
  "scripts": {
    "definition": "def generate" // or def g
  }
}

Result

definitions
├── hello.ts
└── utils
    ├── index.ts
    ├── kr-map.ts
    ├── kv-map.ts
    ├── types.ts
    └── vr-map.ts

./definitions/hello.ts

import { krMap, vrMap, kvMap } from "../utils";
export const HELLO_records_readonly = [{ "key": "hello-1", "value": "hello", "label": "cba" }, { "key": "hello-2", "value": "hello2", "label": "cba2" }] as const;
export const HELLO_records = HELLO_records_readonly.concat(); // mutable records
export type HELLO_Records = typeof HELLO_records_readonly; // record type
export type HELLO_Values = HELLO_Records[number]["value"]; // values's type
export enum HELLO_Keys {
    HelloHello = "HelloHello",
    WorldWorld = "WorldWorld"
}
export const HELLO_key_list = [HELLO_Keys.HelloHello, HELLO_Keys.WorldWorld] as const; // key list
export const HELLO_kr = krMap(HELLO_records_readonly, HELLO_key_list); // key -> record map
export const HELLO_vr = vrMap(HELLO_records_readonly, HELLO_key_list, "value"); // value -> record map
export const HELLO_kv = kvMap(HELLO_records_readonly, HELLO_key_list, "value"); // key -> value map

CLI

Usage: cli [options] [command]

Options:
  -h, --help            display help for command

Commands:
  generate|g [options]
  help [command]        display help for command

command generate

sage: cli generate|g [options]

Options:
  -c, --config [path]  Config file path
  -h, --help           display help for command

ConfigOptions

interface ConfigOptions {
  dir: string; // Json records directory
  output: string; // Definitions output directory
  valueField?: string; // The value field key
  keyField?: string; // The key field key
  keyFormat?: "camelback" | "camelcase" | "underscore"; // The format of the generated key
  keyGen?: (record: Record<string, any>) => string; // Custom key generate function
}

Note: when keyGen is configured, keyFormat will be ignored.

License

MIT