libmodulor 0.1.0 → 0.3.0

package/dist/esm/apps/Helper/src/ucds/GenerateAppsTestsUCD.js

@@ -0,0 +1,106 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'inversify';
+import { AppSrcBrowser } from '../../../../app/index.js';
+import { THostPort, TString, TUIntDuration, } from '../../../../dt/index.js';
+import { EverybodyUCPolicy, } from '../../../../uc/index.js';
+import { AppInputFieldsDef } from '../lib/app.js';
+import { Manifest } from '../manifest.js';
+const DEP_MAPPING_SEP = '::';
+class TDepMapping extends TString {
+}
+let GenerateAppsTestsClientMain = class GenerateAppsTestsClientMain {
+    appSrcBrowser;
+    appTestSuiteEmitter;
+    logger;
+    constructor(appSrcBrowser, appTestSuiteEmitter, logger) {
+        this.appSrcBrowser = appSrcBrowser;
+        this.appTestSuiteEmitter = appTestSuiteEmitter;
+        this.logger = logger;
+    }
+    async exec({ uc, }) {
+        const appsPath = uc.reqVal0('appsPath');
+        const depsMapping = uc.rValArr('depsMapping');
+        const monkeyTestingTimeoutInMs = uc.reqVal0('monkeyTestingTimeoutInMs');
+        const serverPortRangeStart = uc.reqVal0('serverPortRangeStart');
+        const { apps } = await this.appSrcBrowser.exec({
+            appsPath,
+        });
+        const depsMappingParsed = new Map((depsMapping || []).map((dm) => dm.split(DEP_MAPPING_SEP)));
+        let idx = 0;
+        for await (const [appPath] of apps) {
+            this.logger.info('Emitting test suite for app : %s', appPath);
+            await this.appTestSuiteEmitter.exec({
+                appPath,
+                depsMapping: depsMappingParsed,
+                idx,
+                monkeyTestingTimeoutInMs,
+                serverPortRangeStart,
+            });
+            idx++;
+        }
+    }
+};
+GenerateAppsTestsClientMain = __decorate([
+    injectable(),
+    __param(0, inject(AppSrcBrowser)),
+    __param(1, inject('AppTestSuiteEmitter')),
+    __param(2, inject('Logger')),
+    __metadata("design:paramtypes", [AppSrcBrowser, Object, Object])
+], GenerateAppsTestsClientMain);
+export const GenerateAppsTestsUCD = {
+    ext: {
+        cmd: {
+            mountAt: 'GenerateAppsTests',
+        },
+    },
+    io: {
+        i: {
+            fields: {
+                ...AppInputFieldsDef,
+                depsMapping: {
+                    cardinality: {
+                        max: 20,
+                        min: 0,
+                    },
+                    type: new TDepMapping().setExamples([
+                        `Configurator.js${DEP_MAPPING_SEP}Configurator`,
+                    ]),
+                },
+                monkeyTestingTimeoutInMs: {
+                    cardinality: {
+                        min: 0,
+                    },
+                    type: new TUIntDuration({ min: 5_000 })
+                        .setDefaultValue(20_000)
+                        .setExamples([20_000]),
+                },
+                serverPortRangeStart: {
+                    cardinality: {
+                        min: 0,
+                    },
+                    type: new THostPort()
+                        .setDefaultValue(14_000)
+                        .setExamples([14_000]),
+                },
+            },
+        },
+    },
+    lifecycle: {
+        client: {
+            main: GenerateAppsTestsClientMain,
+            policy: EverybodyUCPolicy,
+        },
+    },
+    metadata: Manifest.ucReg.GenerateAppsTests,
+};

package/dist/esm/apps/Helper/src/ucds/TestAppUCD.d.ts

@@ -0,0 +1,9 @@
+import type { AppName } from '../../../../app/index.js';
+import { type UCDef, type UCInputFieldValue } from '../../../../uc/index.js';
+import { type AppInput } from '../lib/app.js';
+export interface TestAppInput extends AppInput {
+    appName: UCInputFieldValue<AppName>;
+    skipCoverage: UCInputFieldValue<boolean>;
+    updateSnapshots: UCInputFieldValue<boolean>;
+}
+export declare const TestAppUCD: UCDef<TestAppInput>;

package/dist/esm/apps/Helper/src/ucds/TestAppUCD.js

@@ -0,0 +1,103 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'inversify';
+import { APP_NAME_PLACEHOLDER } from '../../../../convention.js';
+import { TBoolean, TString } from '../../../../dt/index.js';
+import { IllegalArgumentError } from '../../../../error/index.js';
+import { SimpleHTMLAppTestReportEmitter } from '../../../../testing/impl/SimpleHTMLAppTestReportEmitter.js';
+import { EverybodyUCPolicy, } from '../../../../uc/index.js';
+import { AppInputFieldsDef } from '../lib/app.js';
+import { Manifest } from '../manifest.js';
+let TestAppClientMain = class TestAppClientMain {
+    appTestSuiteRunner;
+    fsManager;
+    i18nManager;
+    logger;
+    simpleHTMLAppTestReportEmitter;
+    constructor(appTestSuiteRunner, fsManager, i18nManager, logger, simpleHTMLAppTestReportEmitter) {
+        this.appTestSuiteRunner = appTestSuiteRunner;
+        this.fsManager = fsManager;
+        this.i18nManager = i18nManager;
+        this.logger = logger;
+        this.simpleHTMLAppTestReportEmitter = simpleHTMLAppTestReportEmitter;
+    }
+    async exec({ uc }) {
+        const appsPath = uc.reqVal0('appsPath');
+        const appName = uc.reqVal0('appName');
+        const skipCoverage = uc.reqVal0('skipCoverage');
+        const updateSnapshots = uc.reqVal0('updateSnapshots');
+        const appPath = this.fsManager.path(appsPath, appName);
+        if (!(await this.fsManager.exists(appPath))) {
+            throw new IllegalArgumentError(this.i18nManager.t('err_unknown_app', { vars: { appPath } }));
+        }
+        await this.appTestSuiteRunner.exec({
+            appPath,
+            skipCoverage,
+            updateSnapshots,
+        });
+        const reports = [
+            [
+                'Coverage Report',
+                await this.appTestSuiteRunner.coverageReportEntrypointPath(appPath),
+            ],
+            [
+                'Simple HTML Report',
+                await this.simpleHTMLAppTestReportEmitter.entrypointPath(appPath),
+            ],
+        ];
+        for await (const [name, path] of reports) {
+            if (await this.fsManager.exists(path)) {
+                this.logger.info(`${name} => open ${path}`);
+            }
+        }
+    }
+};
+TestAppClientMain = __decorate([
+    injectable(),
+    __param(0, inject('AppTestSuiteRunner')),
+    __param(1, inject('FSManager')),
+    __param(2, inject('I18nManager')),
+    __param(3, inject('Logger')),
+    __param(4, inject(SimpleHTMLAppTestReportEmitter)),
+    __metadata("design:paramtypes", [Object, Object, Object, Object, SimpleHTMLAppTestReportEmitter])
+], TestAppClientMain);
+export const TestAppUCD = {
+    ext: {
+        cmd: {
+            mountAt: 'TestApp',
+        },
+    },
+    io: {
+        i: {
+            fields: {
+                ...AppInputFieldsDef,
+                appName: {
+                    type: new TString().setExamples([APP_NAME_PLACEHOLDER]),
+                },
+                skipCoverage: {
+                    type: new TBoolean().setDefaultValue(false),
+                },
+                updateSnapshots: {
+                    type: new TBoolean().setDefaultValue(false),
+                },
+            },
+        },
+    },
+    lifecycle: {
+        client: {
+            main: TestAppClientMain,
+            policy: EverybodyUCPolicy,
+        },
+    },
+    metadata: Manifest.ucReg.TestApp,
+};

package/dist/esm/bundlers/vite/StripUCDLifecycleServerPlugin.d.ts

@@ -0,0 +1,2 @@
+import type { PluginOption } from 'vite';
+export declare const StripUCDLifecycleServerPlugin: PluginOption;

package/dist/esm/bundlers/vite/StripUCDLifecycleServerPlugin.js

@@ -0,0 +1,15 @@
+import { UC_DEF_FILE_NAME_SUFFIX } from '../../convention.js';
+import { stripUCDLifecycleServer } from '../../uc/index.js';
+export const StripUCDLifecycleServerPlugin = {
+    enforce: 'pre',
+    name: 'strip-ucd-lifecycle-server',
+    transform: (src, id) => {
+        if (id.match(new RegExp(`${UC_DEF_FILE_NAME_SUFFIX}$`)) === null) {
+            return;
+        }
+        const code = stripUCDLifecycleServer(src);
+        return {
+            code,
+        };
+    },
+};

package/dist/esm/convention.d.ts

@@ -0,0 +1,42 @@
+import type { AppName } from './app/index.js';
+import type { ProductName } from './product/index.js';
+export declare const SRC_DIR_NAME: string;
+export declare const APPS_ROOT_DIR_NAME: string;
+export declare const APPS_ROOT_ALIAS: string;
+export declare const APPS_ROOT_PATH: string[];
+export declare const APP_DOCS_FILE_NAME: string;
+export declare const APP_I18N_NAME: string;
+export declare const APP_I18N_FILE_NAME: string;
+export declare const APP_INDEX_NAME: string;
+export declare const APP_INDEX_FILE_NAME: string;
+export declare const APP_INDEX_FILE_NAME_FOR_IMPORT: string;
+export declare const APP_MANIFEST_NAME: string;
+export declare const APP_MANIFEST_FILE_EXT: string;
+export declare const APP_MANIFEST_FILE_NAME: string;
+export declare const APP_NAME_PLACEHOLDER: AppName;
+export declare const APP_ROOT_FROM_UCD: string[];
+export declare const APP_SRC_DIR_NAME: string;
+export declare const APP_SRC_UCDS_DIR_NAME: string;
+export declare const APP_TEST_DIR_NAME: string;
+export declare const APP_TEST_MAIN_FILE_NAME: string;
+export declare const APP_TEST_REPORTS_DIR_NAME: string;
+export declare const PRODUCTS_ROOT_ALIAS: string;
+export declare const PRODUCTS_ROOT_PATH: string[];
+export declare const PRODUCT_MANIFEST_NAME: string;
+export declare const PRODUCT_MANIFEST_FILE_NAME: string;
+export declare const PRODUCT_NAME_PLACEHOLDER: ProductName;
+export declare const UC_DEF_SUFFIX: string;
+export declare const UC_DEF_FILE_NAME_EXT: string;
+export declare const UC_DEF_FILE_NAME_SUFFIX: string;
+export declare const UC_DEF_TYPE: string;
+export declare const UC_INPUT_BASE: string;
+export declare const UC_INPUT_FIELD_PATTERN: string;
+export declare const UC_INPUT_SUFFIX: string;
+export declare const UC_MAIN_SUFFIX: string;
+export declare const UC_MAIN_CLIENT_SUFFIX: string;
+export declare const UC_MAIN_SERVER_SUFFIX: string;
+export declare const UC_MAIN_STEP_PREFIX_REGULAR = "// >=>";
+export declare const UC_OPI_BASE: string;
+export declare const UC_OPI_SUFFIX: string;
+export declare const UC_POLICY_SUFFIX: string;
+export declare const UC_POLICY_SUFFIX_FULL: string;

package/dist/esm/convention.js

@@ -0,0 +1,40 @@
+export const SRC_DIR_NAME = 'src';
+export const APPS_ROOT_DIR_NAME = 'apps';
+export const APPS_ROOT_ALIAS = `@${APPS_ROOT_DIR_NAME}`;
+export const APPS_ROOT_PATH = [SRC_DIR_NAME, APPS_ROOT_DIR_NAME];
+export const APP_DOCS_FILE_NAME = 'README.md';
+export const APP_I18N_NAME = 'I18n';
+export const APP_I18N_FILE_NAME = `${APP_I18N_NAME.toLowerCase()}.ts`;
+export const APP_INDEX_NAME = 'index';
+export const APP_INDEX_FILE_NAME = `${APP_INDEX_NAME}.ts`;
+export const APP_INDEX_FILE_NAME_FOR_IMPORT = 'index.js';
+export const APP_MANIFEST_NAME = 'Manifest';
+export const APP_MANIFEST_FILE_EXT = '.ts';
+export const APP_MANIFEST_FILE_NAME = `${APP_MANIFEST_NAME.toLowerCase()}.ts`;
+export const APP_NAME_PLACEHOLDER = 'AppX';
+export const APP_ROOT_FROM_UCD = ['..', '..', '..'];
+export const APP_SRC_DIR_NAME = SRC_DIR_NAME;
+export const APP_SRC_UCDS_DIR_NAME = 'ucds';
+export const APP_TEST_DIR_NAME = 'test';
+export const APP_TEST_MAIN_FILE_NAME = 'App.test.ts';
+export const APP_TEST_REPORTS_DIR_NAME = 'reports';
+export const PRODUCTS_ROOT_ALIAS = '@p';
+export const PRODUCTS_ROOT_PATH = [SRC_DIR_NAME, 'products'];
+export const PRODUCT_MANIFEST_NAME = 'Manifest';
+export const PRODUCT_MANIFEST_FILE_NAME = `${PRODUCT_MANIFEST_NAME.toLowerCase()}.js`;
+export const PRODUCT_NAME_PLACEHOLDER = 'ProductX';
+export const UC_DEF_SUFFIX = 'UCD';
+export const UC_DEF_FILE_NAME_EXT = '.ts';
+export const UC_DEF_FILE_NAME_SUFFIX = `${UC_DEF_SUFFIX}${UC_DEF_FILE_NAME_EXT}`;
+export const UC_DEF_TYPE = 'UCDef';
+export const UC_INPUT_BASE = 'UCInput';
+export const UC_INPUT_FIELD_PATTERN = '^UCInputFieldValue<(.*)>$';
+export const UC_INPUT_SUFFIX = 'Input';
+export const UC_MAIN_SUFFIX = 'Main';
+export const UC_MAIN_CLIENT_SUFFIX = `Client${UC_MAIN_SUFFIX}`;
+export const UC_MAIN_SERVER_SUFFIX = `Server${UC_MAIN_SUFFIX}`;
+export const UC_MAIN_STEP_PREFIX_REGULAR = '// >=>';
+export const UC_OPI_BASE = 'UCOPIBase';
+export const UC_OPI_SUFFIX = 'OPI';
+export const UC_POLICY_SUFFIX = 'Policy';
+export const UC_POLICY_SUFFIX_FULL = `UC${UC_POLICY_SUFFIX}`;

package/dist/esm/dt/DataType.d.ts

@@ -0,0 +1,68 @@
+import type { Address } from './final/TAddress.js';
+import type { Amount } from './final/TAmount.js';
+import type { ApiKey } from './final/TApiKey.js';
+import type { BarCode } from './final/TBarCode.js';
+import type { CSS } from './final/TCSS.js';
+import type { Color } from './final/TColor.js';
+import type { ColorRGBA } from './final/TColorRGBA.js';
+import type { CompanyName } from './final/TCompanyName.js';
+import type { CountryISO3166Alpha2 } from './final/TCountryISO3166Alpha2.js';
+import type { CurrencyISO4217 } from './final/TCurrencyISO4217.js';
+import type { DateISO8601 } from './final/TDateISO8601.js';
+import type { DateTimeFormat } from './final/TDateTimeFormat.js';
+import type { DirPath } from './final/TDirPath.js';
+import type { DomainName } from './final/TDomainName.js';
+import type { Email } from './final/TEmail.js';
+import type { EmbeddedObject } from './final/TEmbeddedObject.js';
+import type { Emoji } from './final/TEmoji.js';
+import type { EncryptionKey } from './final/TEncryptionKey.js';
+import type { ErrorMessage } from './final/TErrorMessage.js';
+import type { ExternalServiceId } from './final/TExternalServiceId.js';
+import type { File } from './final/TFile.js';
+import type { FileExtension } from './final/TFileExtension.js';
+import type { FileMimeType } from './final/TFileMimeType.js';
+import type { FileName } from './final/TFileName.js';
+import type { FilePath } from './final/TFilePath.js';
+import type { FreeTextLong } from './final/TFreeTextLong.js';
+import type { FreeTextShort } from './final/TFreeTextShort.js';
+import type { Geolocation } from './final/TGeolocation.js';
+import type { GitSSHURL } from './final/TGitSSHURL.js';
+import type { HTML } from './final/THTML.js';
+import type { HTTPContentType } from './final/THTTPContentType.js';
+import type { HTTPMethod } from './final/THTTPMethod.js';
+import type { HTTPStatusNumber } from './final/THTTPStatusNumber.js';
+import type { HostAddress } from './final/THostAddress.js';
+import type { HostPort } from './final/THostPort.js';
+import type { IPv4 } from './final/TIPv4.js';
+import type { IPv6 } from './final/TIPv6.js';
+import type { JSONString } from './final/TJSONString.js';
+import type { JWT } from './final/TJWT.js';
+import type { JavaScript } from './final/TJavaScript.js';
+import type { JobTitle } from './final/TJobTitle.js';
+import type { Markdown } from './final/TMarkdown.js';
+import type { NumIndex } from './final/TNumIndex.js';
+import type { Password } from './final/TPassword.js';
+import type { Percentage } from './final/TPercentage.js';
+import type { PersonFirstname } from './final/TPersonFirstname.js';
+import type { PersonFullname } from './final/TPersonFullname.js';
+import type { PersonInitials } from './final/TPersonInitials.js';
+import type { PersonLastname } from './final/TPersonLastname.js';
+import type { QRCode } from './final/TQRCode.js';
+import type { SQLQuery } from './final/TSQLQuery.js';
+import type { SSHPrivateKey } from './final/TSSHPrivateKey.js';
+import type { SSHPublicKey } from './final/TSSHPublicKey.js';
+import type { SearchQuery } from './final/TSearchQuery.js';
+import type { SemVerVersion } from './final/TSemVerVersion.js';
+import type { ShellCommand } from './final/TShellCommand.js';
+import type { Slug } from './final/TSlug.js';
+import type { Time } from './final/TTime.js';
+import type { Timestamp } from './final/TTimestamp.js';
+import type { UIntDuration } from './final/TUIntDuration.js';
+import type { UIntQuantity } from './final/TUIntQuantity.js';
+import type { URL } from './final/TURL.js';
+import type { URLPath } from './final/TURLPath.js';
+import type { UUID } from './final/TUUID.js';
+import type { Username } from './final/TUsername.js';
+type Primitive = string | number | boolean;
+export type DataType = Primitive | Address | Amount | ApiKey | BarCode | CSS | Color | ColorRGBA | CompanyName | CountryISO3166Alpha2 | CurrencyISO4217 | DateISO8601 | DateTimeFormat | DirPath | DomainName | Email | EmbeddedObject | Emoji | EncryptionKey | ErrorMessage | ExternalServiceId | File | FileExtension | FileMimeType | FileName | FilePath | FreeTextLong | FreeTextShort | Geolocation | GitSSHURL | HTML | HTTPContentType | HTTPMethod | HTTPStatusNumber | HostAddress | HostPort | IPv4 | IPv6 | JSONString | JWT | JavaScript | JobTitle | Markdown | NumIndex | Password | Percentage | PersonFirstname | PersonFullname | PersonInitials | PersonLastname | QRCode | SQLQuery | SSHPrivateKey | SSHPublicKey | SearchQuery | SemVerVersion | ShellCommand | Slug | Time | Timestamp | UIntDuration | UIntQuantity | URL | URLPath | UUID | Username;
+export {};

package/dist/esm/dt/DataType.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/dt/DataTypes.d.ts

@@ -0,0 +1,2 @@
+import type { DataType } from './DataType.js';
+export declare const DataTypes: DataType[];

package/dist/esm/dt/DataTypes.js

@@ -0,0 +1,68 @@
+export const DataTypes = [
+    'Address',
+    'Amount',
+    'ApiKey',
+    'BarCode',
+    'CSS',
+    'Color',
+    'ColorRGBA',
+    'CompanyName',
+    'CountryISO3166Alpha2',
+    'CurrencyISO4217',
+    'DateISO8601',
+    'DateTimeFormat',
+    'DirPath',
+    'DomainName',
+    'Email',
+    'EmbeddedObject',
+    'Emoji',
+    'EncryptionKey',
+    'ErrorMessage',
+    'ExternalServiceId',
+    'File',
+    'FileExtension',
+    'FileMimeType',
+    'FileName',
+    'FilePath',
+    'FreeTextLong',
+    'FreeTextShort',
+    'Geolocation',
+    'GitSSHURL',
+    'HTML',
+    'HTTPContentType',
+    'HTTPMethod',
+    'HTTPStatusNumber',
+    'HostAddress',
+    'HostPort',
+    'IPv4',
+    'IPv6',
+    'JSONString',
+    'JWT',
+    'JavaScript',
+    'JobTitle',
+    'Markdown',
+    'NumIndex',
+    'Password',
+    'Percentage',
+    'PersonFirstname',
+    'PersonFullname',
+    'PersonInitials',
+    'PersonLastname',
+    'QRCode',
+    'SQLQuery',
+    'SSHPrivateKey',
+    'SSHPublicKey',
+    'SearchQuery',
+    'SemVerVersion',
+    'ShellCommand',
+    'Slug',
+    'Time',
+    'Timestamp',
+    'UIntDuration',
+    'UIntQuantity',
+    'URL',
+    'URLPath',
+    'UUID',
+    'Username',
+    'YesNo',
+];

package/dist/esm/dt/Validation.d.ts

@@ -0,0 +1,25 @@
+import type { I18nTranslation } from '../i18n/index.js';
+import type { NumIndex } from './final/TNumIndex.js';
+type ViolationConstraint = 'fieldsOr' | 'format' | 'mandatory' | 'max' | 'maxCount' | 'maxLength' | 'min' | 'minCount' | 'minLength' | 'oneOf' | 'shape' | 'type';
+type ViolationBase<C extends ViolationConstraint, EV> = {
+    constraint: C;
+    expected: EV;
+};
+export type ViolationFormat = 'ColorRGBA' | 'DateISO8601' | 'DirPath' | 'DomainName' | 'Email' | 'FilePath' | 'GitSSHURL' | 'IPv4' | 'IPv6' | 'JSON' | 'JWT' | 'PersonFirstname' | 'PersonFullname' | 'PersonInitials' | 'PersonLastname' | 'QRCode' | 'SemVerVersion' | 'Slug' | 'SSHPrivateKey' | 'SSHPublicKey' | 'Time' | 'URL' | 'UUID';
+export type ViolationType = 'array' | 'boolean' | 'int' | 'number' | 'object' | 'scalar' | 'string';
+export type Violation<T = unknown> = ViolationBase<'fieldsOr', string> | ViolationBase<'format', ViolationFormat> | ViolationBase<'format', string> | ViolationBase<'mandatory', undefined> | ViolationBase<'max', number> | ViolationBase<'maxCount', number> | ViolationBase<'maxLength', number> | ViolationBase<'min', number> | ViolationBase<'minCount', number> | ViolationBase<'minLength', number> | ViolationBase<'oneOf', T[]> | ViolationBase<'shape', object> | ViolationBase<'type', ViolationType>;
+type ViolationI18nableSimple = Exclude<ViolationConstraint, 'format' | 'type'>;
+export type ViolationI18nable = `validation_${ViolationI18nableSimple}` | `validation_format_${ViolationFormat}` | `validation_type_${ViolationType}`;
+export type ViolationI18n = Record<ViolationI18nable, I18nTranslation>;
+export declare class Validation {
+    private violations;
+    constructor();
+    add(violation: Violation): void;
+    concat(validation: Validation): void;
+    get(idx?: NumIndex): [ViolationI18nable, string] | null;
+    getViolations(): Violation[];
+    getViolationsAsI18nables(): ViolationI18nable[];
+    isOK(): boolean;
+    private violationAsI18nable;
+}
+export {};

package/dist/esm/dt/Validation.js

@@ -0,0 +1,42 @@
+export class Validation {
+    violations;
+    constructor() {
+        this.violations = [];
+    }
+    add(violation) {
+        this.violations.push(violation);
+    }
+    concat(validation) {
+        this.violations.push(...validation.getViolations());
+    }
+    get(idx = 0) {
+        const violation = this.violations[idx];
+        if (!violation) {
+            return null;
+        }
+        const key = this.violationAsI18nable(violation);
+        const expected = (violation.expected || '').toString();
+        return [key, expected];
+    }
+    getViolations() {
+        return this.violations;
+    }
+    getViolationsAsI18nables() {
+        return this.violations.map((v) => this.violationAsI18nable(v));
+    }
+    isOK() {
+        return this.violations.length === 0;
+    }
+    violationAsI18nable(violation) {
+        const { constraint, expected } = violation;
+        const elements = ['validation', constraint];
+        const constraintsIncludingExpected = [
+            'format',
+            'type',
+        ];
+        if (constraintsIncludingExpected.includes(constraint)) {
+            elements.push(expected);
+        }
+        return elements.join('_');
+    }
+}

package/dist/esm/dt/base/TBase.d.ts

@@ -0,0 +1,66 @@
+import type { IconCode } from '../../icon/index.js';
+import type { DataType } from '../DataType.js';
+import { Validation } from '../Validation.js';
+import type { Color } from '../final/TColor.js';
+import type { RNInputMode } from '../targets/rn.js';
+import type { HTMLInputType } from '../targets/web.js';
+type AutoCapitalizeBehavior = 'characters' | 'sentences' | 'words';
+export type OptionLabel = string;
+type Option<T> = {
+    imgSrc?: number;
+    icon?: IconCode;
+    label: OptionLabel;
+    value: T;
+};
+export type TName = Capitalize<string>;
+export type SemanticsVariant = 'danger' | 'info' | 'primary' | 'secondary' | 'success' | 'warning';
+export interface SemanticsValue {
+    backgroundColor?: Color;
+    color?: Color;
+    variant?: SemanticsVariant;
+}
+export type SemanticsMapping = Record<string, SemanticsValue>;
+export type SemanticsPredicate<T> = (value: T) => SemanticsValue;
+export interface OptionsOpts {
+    shouldTranslateLabels?: boolean;
+    strict?: boolean;
+}
+export declare abstract class TBase<T extends DataType> {
+    static DEFAULT_OPTIONS: Required<OptionsOpts>;
+    protected defaultValue: T | undefined;
+    protected examples: T[] | undefined;
+    protected initialValue: T | undefined;
+    protected options: Option<T>[] | undefined;
+    protected optionsOpts: OptionsOpts | undefined;
+    protected raw: unknown | undefined;
+    protected semanticsMapping: SemanticsMapping | undefined;
+    protected semanticsPredicate: SemanticsPredicate<T> | undefined;
+    abstract tName(): TName;
+    assign(raw: unknown): this;
+    autoCapitalizeBehavior(): AutoCapitalizeBehavior | undefined;
+    clear(): void;
+    example(): T;
+    fmt(ifNullOrUndefined?: string): string;
+    getDefaultValue(): T | undefined;
+    getExamples(): T[] | undefined;
+    getInitialValue(): T | undefined;
+    getOptions(): Option<T>[] | undefined;
+    getSemanticsMapping(): SemanticsMapping | undefined;
+    getSemanticsPredicate(): SemanticsPredicate<T> | undefined;
+    hasOptions(): boolean;
+    hasStrictOptions(): boolean;
+    htmlInputType(): HTMLInputType;
+    isSensitive(): boolean;
+    rnInputMode(): RNInputMode;
+    setDefaultValue(defaultValue: T): this;
+    setExamples(examples: T[]): this;
+    setInitialValue(initialValue: T): this;
+    restrictOptions(v: T[]): this;
+    setOptions(options: Option<T>[], opts?: OptionsOpts): this;
+    setSemanticsMapping(semanticsMapping: SemanticsMapping): this;
+    setSemanticsPredicate(semanticsPredicate: SemanticsPredicate<T>): this;
+    shouldTranslateOptions(): boolean;
+    val(): T | undefined;
+    validate(): Validation;
+}
+export {};