@trustme24/flext 1.8.0 → 1.9.1

package/dist/lib.d.ts

@@ -1,10 +1,11 @@
 import { AST } from '@handlebars/parser';
 import { Theme as Wind4Theme } from '@unocss/preset-wind4';
-import { Obj, Macro, MacroParam, DataModelNode, DataModel, Isset, Inarr } from './types';
+import { Obj, Isset, IsNumber, IsObject, Has, Inarr, Macro, MacroParam, DataModel, DataModelNode, CollectorFilterHandler } from './types';
+import { TemplateDataValidationError } from './errors';
 import striptags from 'striptags';
 import Handlebars, { TemplateDelegate } from 'handlebars';
+import * as types from "./types";
 export declare const uno: Promise<import("unocss").UnoGenerator<Wind4Theme>>;
-export type CollectorFilterHandler<T = any> = (val?: T) => boolean;
 export declare const DEFAULT_MODEL_DEPTH = 10;
 export declare const stripHtml: typeof striptags;
 export declare class HandlebarsCollector<T = any> extends Handlebars.Visitor {
@@ -16,32 +17,44 @@ export declare class HandlebarsCollector<T = any> extends Handlebars.Visitor {
     setAst(ast: AST.Program): this;
     collect(ast: AST.Program): T[];
 }
-export declare function isNumber(val: any): boolean;
-export declare function isObject(val: any): boolean;
-export declare function has(obj: Obj, key: string): boolean;
 export declare function inarr<T extends any, A extends any[]>(val: T, ...arr: A): Inarr<T, A>;
+export declare function has<T extends Obj, K extends keyof T>(obj: T, key: K): Has<T, K>;
 export declare function isset<T extends any>(val: T): Isset<T>;
+export declare function isNumber<T extends any>(val: T): IsNumber<T>;
+export declare function isObject<T extends any>(val: T): IsObject<T>;
 export declare function audit(val: any): string;
-export declare function defineModule(options?: any): any;
-export declare function unique<T = any>(arr: T[]): T[];
 export declare function getAst(val: string): AST.Program;
 export declare function getTemplate(val: string | AST.Program): TemplateDelegate;
 export declare function getHtml(template: TemplateDelegate, data?: Obj, helpers?: Obj): string;
 export declare function getCss(template: TemplateDelegate, data?: Obj, options?: Obj): Promise<string>;
+export declare function unique<T = any>(arr: T[]): T[];
 export declare function getPaths(ast: AST.Program): string[];
 export declare function pathToDataModelNode(path: string, depth?: number): DataModelNode;
 export declare function pathToDataModel(path: string, depth?: number): DataModel;
 export declare function getDataModel(ast: AST.Program): DataModel;
+export declare function dataModelNodeToMetadata(node: types.DataModelNode, fields: types.Field[], _options?: types.Obj, depth?: number): types.MetadataModelNode;
 export declare function getMacroParam(val: string): MacroParam | null;
 export declare function getMacroParams(val: string, doWarn?: boolean): MacroParam[];
 export declare function getMacros(ast: AST.Program, doWarn?: boolean): Macro[];
 export declare function getHtmlH1(ast: AST.Program, doWarn?: boolean): string[];
+export declare function getTemplateValidationErrorsByMetadata(data: types.Obj, model: types.MetadataModelNode[], depth?: number): TemplateDataValidationError[];
 export declare function ensureString(val: any): string;
+export declare function ensureNullableString(val: any): string | null;
 export declare function ensureDate(val: Date | string | number): Date;
 export declare function ensureTitle(val: string | number): string;
 export declare function ensureFieldName(val: string): string;
+export declare function ensureNullableFieldMinMax(val: any): Date | number | null;
+export declare function ensureNullableFieldMinMaxLength(val: any): number | null;
+export declare function ensureNullableFieldOrder(val: any): number | null;
+export declare function ensureFieldValue(val: any): types.FieldValue;
 export declare function filter(regex: RegExp, val: string | number): boolean;
 export declare function compare(a: number | null | undefined, b: number | null | undefined): number;
+export declare function macroToModuleNames(val: types.Macro): string[];
+export declare function macroToField(val: types.Macro): types.Field;
+export declare function macroToFieldValueOption(val: types.Macro): types.FieldValueOption;
+export declare function applyValueOptionsToFields(options: types.FieldValueOption[], fields: types.Field[]): void;
+export declare function applyAbsoluteOrderToFields(fields: types.Field[]): void;
+export declare function defineModule(options?: any): any;
 export declare class RegexHelper {
     static dbDateStr: RegExp;
     static macro: RegExp;

package/dist/modules/date/index.d.ts

@@ -1,5 +1,6 @@
 import { DateTime } from 'luxon';
 import { SafeString } from 'handlebars';
+export declare const DEFAULT_COLOR_OP = "text";
 export declare function op(state: any): DateTime | string | number | null;
 export declare function opWithColor(state: any): SafeString;
 export declare function now(state: any): DateTime;

package/dist/modules/match/index.d.ts

@@ -1,5 +1,5 @@
-export declare function matchHelper(state: any): any;
-export declare function caseHelper(state: any): any;
-export declare function fallbackHelper(state: any): any;
+export declare function _match(state: any): any;
+export declare function _case(state: any): any;
+export declare function _fallback(state: any): any;
 declare const _default: any;
 export default _default;

package/dist/types.d.ts

@@ -1,13 +1,12 @@
+import { AST } from '@handlebars/parser';
 export type Obj<T extends any = any> = Record<string, T>;
-export type Inarr<T extends any, A extends any[]> = T extends A[any] ? true : false;
 export type Isset<T extends any> = T extends null | undefined ? false : true;
-export type DataModelNode = {
-    name: string;
-    $?: DataModelNode[];
-};
-export type DataModel = DataModelNode & {
-    addPath: (path: string, depth?: number) => void;
-};
+export type IsNumber<T extends any> = T extends number ? true : false;
+export type IsObject<T extends any, O extends Obj = Obj> = T extends O ? true : false;
+export type Has<T extends Obj, K extends keyof T> = T[K];
+export type Inarr<T extends any, A extends any[]> = T extends A[any] ? true : false;
+export type FieldType = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'date' | 'mixed';
+export type FieldValue = string | number | boolean | Obj | FieldValue[] | null;
 export type MacroParam = {
     name: string;
     value: string | null;
@@ -16,3 +15,60 @@ export type Macro = {
     name: string;
     params: MacroParam[];
 };
+export type FieldValueOption = {
+    type: string;
+    name: string;
+    fieldName: string;
+    label?: string | null;
+    descr?: string | null;
+    value?: FieldValue | null;
+    isDisabled: boolean;
+};
+export type Field = {
+    type: FieldType;
+    name: string;
+    label?: string | null;
+    descr?: string | null;
+    hint?: string | null;
+    min?: Date | number | null;
+    max?: Date | number | null;
+    minLength?: number | null;
+    maxLength?: number | null;
+    order?: number | null;
+    options?: FieldValueOption[] | null;
+    value?: FieldValue;
+    isRequired: boolean;
+    extra?: {
+        macroName?: string | null;
+        absoluteOrder?: number | null;
+    };
+};
+export type DataModelNode = {
+    name: string;
+    $?: DataModelNode[];
+};
+export type DataModel = DataModelNode & {
+    addPath: (path: string, depth?: number) => void;
+};
+export type MetadataModelNode = DataModelNode & {
+    type: FieldType;
+    label?: string | null;
+    descr?: string | null;
+    hint?: string | null;
+    min?: Date | number | null;
+    max?: Date | number | null;
+    minLength?: number | null;
+    maxLength?: number | null;
+    order?: number | null;
+    options?: FieldValueOption[] | null;
+    value?: string | null;
+    isRequired: boolean;
+    extra?: {
+        fieldName?: string | null;
+    };
+};
+export type CollectorFilterHandler<T = any> = (val?: T) => boolean;
+export type GetProcessedTemplateHandler = (val: string) => string;
+export type GetTemplateAstHandler = (val: string) => AST.Program;
+export type GetTemplateTitleHandler = (ast: AST.Program) => string[];
+export type GetTemplateMacroHandler = (ast: AST.Program) => Macro[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustme24/flext",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "A Powerful Templating Engine",
   "keywords": ["templates", "templating engine", "modular templates", "handlebars"],
   "type": "module",
@@ -35,22 +35,22 @@
     "@babel/core": "^7.28.5",
     "@babel/preset-env": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
-    "@handlebars/parser": "^2.2.1",
-    "@tailwindcss/cli": "^4.1.17",
-    "@types/node": "^24.10.1",
-    "esbuild": "^0.27.0",
+    "@handlebars/parser": "^2.2.2",
+    "@tailwindcss/cli": "^4.1.18",
+    "@types/node": "^25.0.3",
+    "esbuild": "^0.27.2",
     "esbuild-plugin-import-glob": "^0.1.1",
-    "tailwindcss": "^4.1.17",
+    "tailwindcss": "^4.1.18",
     "tsc-alias": "^1.8.16",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.14"
+    "vitest": "^4.0.16"
   },
   "dependencies": {
-    "@unocss/preset-wind4": "^66.5.9",
+    "@unocss/preset-wind4": "^66.5.10",
     "handlebars": "^4.7.8",
     "luxon": "^3.7.2",
     "striptags": "^3.2.0",
-    "unocss": "^66.5.9",
+    "unocss": "^66.5.10",
     "written-number": "^0.11.1"
   }
 }