@tslite/forms 0.1.0

package/dist/index.cjs

@@ -0,0 +1 @@
+'use strict';function y(r,e={}){return r.t!=="object"?{fields:[i("value",r,true,void 0,e)]}:{fields:Object.keys(r.props).map(t=>{let o=r.props[t];return i(t,o.type,!o.optional,e.fields?.[t],e)})}}function m(r){return r.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/[_-]+/g," ").replace(/\s+/g," ").trim().replace(/\b\w/g,e=>e.toUpperCase())}function i(r,e,n,t,o){let f=t?.label??m(r),p=e.t==="apply"?o.widgets?.[e.name]:void 0,a=t?.control??p??F(e),l={key:r,label:f,control:a,type:e,required:n},d=t?.widget;if(e.t==="object"&&a==="group")return {...l,widget:d,fields:Object.keys(e.props).map(c=>{let u=e.props[c];return i(c,u.type,!u.optional,t?.fields?.[c],o)})};if(e.t==="array"&&a==="list")return {...l,widget:d,item:i("item",e.items,true,void 0,o)};if(e.t==="fn"&&a==="action")return {...l,widget:d,payload:g(e.params,o)};let s=b(e);return {...l,widget:d,...s?{options:s}:{}}}function g(r,e){return r.filter(n=>!n.variadic).map(n=>i(n.name,n.type,!n.optional,void 0,e))}function F(r){switch(r.t){case "string":return "text";case "number":return "number";case "boolean":return "switch";case "literal":return typeof r.value=="number"?"number":typeof r.value=="boolean"?"switch":"text";case "object":return "group";case "array":return "list";case "fn":return "action";case "union":return r.of.every(e=>e.t==="literal")?"select":"unknown";case "apply":return r.name==="Element"?"slot":"unknown";default:return "unknown"}}function b(r){if(r.t==="union"&&r.of.every(e=>e.t==="literal"))return r.of.map(e=>{let n=e.value;return {value:n,label:String(n)}})}exports.humanize=m;exports.toFormSchema=y;

package/dist/index.d.cts

@@ -0,0 +1,54 @@
+import { Schema } from '@tslite/checker';
+
+/** Controles conhecidos. Widgets custom podem usar o campo `widget`. */
+type Control = "text" | "textarea" | "number" | "switch" | "select" | "color" | "icon" | "date" | "action" | "slot" | "group" | "list" | "unknown";
+/** Uma opção de `select` (derivada de uma união de literais). */
+interface Option {
+    readonly value: string | number | boolean;
+    readonly label: string;
+}
+/** Um campo do formulário (ou uma seção, se `control: "group"`). */
+interface UiField {
+    readonly key: string;
+    readonly label: string;
+    readonly control: Control;
+    /** O tipo de origem — rastreável de volta ao `Schema`. */
+    readonly type: Schema;
+    readonly required: boolean;
+    /** Widget custom (override), quando `control` não basta. */
+    readonly widget?: string;
+    /** Opções de um `select` (união de literais). */
+    readonly options?: readonly Option[];
+    /** Subcampos de um `group` (`object`) — a seção. */
+    readonly fields?: readonly UiField[];
+    /** O campo-item de uma `list` (`array`). */
+    readonly item?: UiField;
+    /** O payload de uma `action` (`fn`) — os params da função. */
+    readonly payload?: readonly UiField[];
+}
+interface FormSchema {
+    readonly fields: readonly UiField[];
+}
+/** Override de um campo específico (estilo uiSchema do RJSF). */
+interface FieldHint {
+    readonly label?: string;
+    readonly control?: Control;
+    readonly widget?: string;
+    /** Overrides aninhados, por chave, para um campo `object`. */
+    readonly fields?: Readonly<Record<string, FieldHint>>;
+}
+interface FormHints {
+    /** Widget por **tipo nomeado**: `{ Color: "color", Icon: "icon" }`. */
+    readonly widgets?: Readonly<Record<string, Control>>;
+    /** Overrides por chave de campo (no nível atual). */
+    readonly fields?: Readonly<Record<string, FieldHint>>;
+}
+/**
+ * Projeta um `Schema` de `object` (as props de um componente) num `FormSchema`.
+ * Se `schema` não for `object`, devolve um único campo com a key `"value"`.
+ */
+declare function toFormSchema(schema: Schema, hints?: FormHints): FormSchema;
+/** Capitaliza e quebra camelCase/snake/kebab: `submitAction` → "Submit Action". */
+declare function humanize(key: string): string;
+
+export { type Control, type FieldHint, type FormHints, type FormSchema, type Option, type UiField, humanize, toFormSchema };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import { Schema } from '@tslite/checker';
+
+/** Controles conhecidos. Widgets custom podem usar o campo `widget`. */
+type Control = "text" | "textarea" | "number" | "switch" | "select" | "color" | "icon" | "date" | "action" | "slot" | "group" | "list" | "unknown";
+/** Uma opção de `select` (derivada de uma união de literais). */
+interface Option {
+    readonly value: string | number | boolean;
+    readonly label: string;
+}
+/** Um campo do formulário (ou uma seção, se `control: "group"`). */
+interface UiField {
+    readonly key: string;
+    readonly label: string;
+    readonly control: Control;
+    /** O tipo de origem — rastreável de volta ao `Schema`. */
+    readonly type: Schema;
+    readonly required: boolean;
+    /** Widget custom (override), quando `control` não basta. */
+    readonly widget?: string;
+    /** Opções de um `select` (união de literais). */
+    readonly options?: readonly Option[];
+    /** Subcampos de um `group` (`object`) — a seção. */
+    readonly fields?: readonly UiField[];
+    /** O campo-item de uma `list` (`array`). */
+    readonly item?: UiField;
+    /** O payload de uma `action` (`fn`) — os params da função. */
+    readonly payload?: readonly UiField[];
+}
+interface FormSchema {
+    readonly fields: readonly UiField[];
+}
+/** Override de um campo específico (estilo uiSchema do RJSF). */
+interface FieldHint {
+    readonly label?: string;
+    readonly control?: Control;
+    readonly widget?: string;
+    /** Overrides aninhados, por chave, para um campo `object`. */
+    readonly fields?: Readonly<Record<string, FieldHint>>;
+}
+interface FormHints {
+    /** Widget por **tipo nomeado**: `{ Color: "color", Icon: "icon" }`. */
+    readonly widgets?: Readonly<Record<string, Control>>;
+    /** Overrides por chave de campo (no nível atual). */
+    readonly fields?: Readonly<Record<string, FieldHint>>;
+}
+/**
+ * Projeta um `Schema` de `object` (as props de um componente) num `FormSchema`.
+ * Se `schema` não for `object`, devolve um único campo com a key `"value"`.
+ */
+declare function toFormSchema(schema: Schema, hints?: FormHints): FormSchema;
+/** Capitaliza e quebra camelCase/snake/kebab: `submitAction` → "Submit Action". */
+declare function humanize(key: string): string;
+
+export { type Control, type FieldHint, type FormHints, type FormSchema, type Option, type UiField, humanize, toFormSchema };

package/dist/index.js

@@ -0,0 +1 @@
+function y(r,e={}){return r.t!=="object"?{fields:[i("value",r,true,void 0,e)]}:{fields:Object.keys(r.props).map(t=>{let o=r.props[t];return i(t,o.type,!o.optional,e.fields?.[t],e)})}}function m(r){return r.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/[_-]+/g," ").replace(/\s+/g," ").trim().replace(/\b\w/g,e=>e.toUpperCase())}function i(r,e,n,t,o){let f=t?.label??m(r),p=e.t==="apply"?o.widgets?.[e.name]:void 0,a=t?.control??p??F(e),l={key:r,label:f,control:a,type:e,required:n},d=t?.widget;if(e.t==="object"&&a==="group")return {...l,widget:d,fields:Object.keys(e.props).map(c=>{let u=e.props[c];return i(c,u.type,!u.optional,t?.fields?.[c],o)})};if(e.t==="array"&&a==="list")return {...l,widget:d,item:i("item",e.items,true,void 0,o)};if(e.t==="fn"&&a==="action")return {...l,widget:d,payload:g(e.params,o)};let s=b(e);return {...l,widget:d,...s?{options:s}:{}}}function g(r,e){return r.filter(n=>!n.variadic).map(n=>i(n.name,n.type,!n.optional,void 0,e))}function F(r){switch(r.t){case "string":return "text";case "number":return "number";case "boolean":return "switch";case "literal":return typeof r.value=="number"?"number":typeof r.value=="boolean"?"switch":"text";case "object":return "group";case "array":return "list";case "fn":return "action";case "union":return r.of.every(e=>e.t==="literal")?"select":"unknown";case "apply":return r.name==="Element"?"slot":"unknown";default:return "unknown"}}function b(r){if(r.t==="union"&&r.of.every(e=>e.t==="literal"))return r.of.map(e=>{let n=e.value;return {value:n,label:String(n)}})}export{m as humanize,y as toFormSchema};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@tslite/forms",
+  "version": "0.1.0",
+  "description": "TSLite forms — projects a Schema into a headless form descriptor (auto-forms / property panels)",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andersondrosa/tslite.git",
+    "directory": "packages/forms"
+  },
+  "keywords": [
+    "ast",
+    "schema",
+    "json-schema",
+    "auto-form",
+    "form-generation",
+    "property-panel",
+    "typescript"
+  ],
+  "author": "Anderson D. Rosa <andersondrosa@outlook.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tslite/checker": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "clean": "rm -rf dist",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  }
+}