@nan0web/release 3.3.0 → 3.5.0

package/src/domain/models/ReleaseModel.js

@@ -0,0 +1,191 @@
+import { Model } from '@nan0web/types'
+import { ReleaseMemberModel } from './ReleaseMemberModel.js'
+import { ReleaseTaskModel } from './ReleaseTaskModel.js'
+import { ReleaseParityModel } from './ReleaseParityModel.js'
+import { ReleaseIssueModel } from './ReleaseIssueModel.js'
+
+export class ReleaseModel extends Model {
+	static version = { type: 'string', required: true }
+	static title = { type: 'string', required: true }
+	static status = { type: 'string', default: 'todo' } // 'todo' | 'work' | 'done' | 'fail'
+	static type = { type: 'string', default: 'minor' } // 'major' | 'minor' | 'patch' | 'hotfix' | 'chore'
+	static summary = { type: 'string' }
+	static epic = { type: 'string' }
+	static sprint = { type: 'string' }
+	static tracker = { type: 'string' }
+
+	// Sub-collections
+	static team = { type: 'array', itemType: ReleaseMemberModel, default: [] }
+	static tasks = { type: 'array', itemType: ReleaseTaskModel, default: [] }
+	static criteria = { type: 'array', itemType: ReleaseTaskModel, default: [] }
+	static parity = { type: 'array', itemType: ReleaseParityModel, default: [] }
+	static issues = { type: 'array', itemType: ReleaseIssueModel, default: [] }
+	static files = { type: 'array', default: [] }
+	static meta = { type: 'object', default: {} }
+
+	/**
+	 * @param {Partial<ReleaseModel>} [data={}]
+	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Release version */
+		this.version
+		/** @type {string} Release title */
+		this.title
+		/** @type {'todo' | 'work' | 'done' | 'fail'} Release status */
+		this.status
+		/** @type {'major' | 'minor' | 'patch' | 'hotfix' | 'chore'} Release type */
+		this.type
+		/** @type {string} Release summary / description */
+		this.summary
+		/** @type {string} Epic identifier */
+		this.epic
+		/** @type {string} Sprint name */
+		this.sprint
+		/** @type {string} External tracker URL template */
+		this.tracker
+		/** @type {ReleaseMemberModel[]} Team members (ролі, імена, логіни) */
+		this.team
+		/** @type {ReleaseTaskModel[]} Tasks in scope */
+		this.tasks
+		/** @type {ReleaseTaskModel[]} Acceptance criteria (DoD) */
+		this.criteria
+		/** @type {ReleaseParityModel[]} Data parity verification items */
+		this.parity
+		/** @type {ReleaseIssueModel[]} Issues and risks */
+		this.issues
+		/** @type {Array<{file: string, size?: string, hash?: string, type?: string}>} Artifact files */
+		this.files
+		/** @type {Record<string, any>} Frontmatter / metadata */
+		this.meta
+	}
+
+	static SECTIONS = {
+		summary: [
+			// EN (English)
+			'summary', 'objective', 'description', 'overview',
+			// UK (Українська)
+			'опис', 'мета', 'ціль', 'огляд',
+			// ES (Español)
+			'resumen', 'objetivo', 'descripcion',
+			// FR (Français)
+			'resume', 'objectif',
+			// DE (Deutsch)
+			'zusammenfassung', 'ziel', 'beschreibung',
+			// ZH (中文 - Chinese)
+			'摘要', '目标', '描述',
+			// RU (Російська - для сумісності з двомовними українцями)
+			'описание', 'цель', 'обзор',
+		],
+		team: [
+			// EN (English)
+			'team', 'members', 'contributors', 'roles',
+			// UK (Українська)
+			'команда', 'учасники', 'ролі',
+			// ES (Español)
+			'equipo', 'miembros',
+			// FR (Français)
+			'equipe', 'membres',
+			// DE (Deutsch)
+			'mitglieder',
+			// ZH (中文 - Chinese)
+			'团队', '成员',
+			// RU (Російська)
+			'участники', 'роли',
+		],
+		tasks: [
+			// EN (English)
+			'tasks', 'scope', 'work plan', 'wbs', 'backlog', 'plan',
+			// UK (Українська)
+			'план', 'задачі', 'робочий план', 'обсяг',
+			// ES (Español)
+			'tareas', 'plan de trabajo',
+			// FR (Français)
+			'taches', 'plan de travail',
+			// DE (Deutsch)
+			'aufgaben', 'arbeitsplan',
+			// ZH (中文 - Chinese)
+			'任务', '工作计划',
+			// RU (Російська)
+			'задачи', 'рабочий план',
+		],
+		criteria: [
+			// EN (English)
+			'acceptance', 'acceptance criteria', 'dod', 'definition of done', 'requirements',
+			// UK (Українська)
+			'критерії', 'критерії прийнятності', 'вимоги',
+			// ES (Español)
+			'criterios', 'criterios de aceptacion', 'requisitos',
+			// FR (Français)
+			'criteres', 'criteres d acceptation', 'exigences',
+			// DE (Deutsch)
+			'akzeptanzkriterien', 'anforderungen',
+			// ZH (中文 - Chinese)
+			'验收标准', '准入条件', '要求',
+			// RU (Російська)
+			'критерии', 'критерии приемки', 'требования',
+		],
+		parity: [
+			// EN (English)
+			'parity', 'data parity', 'audit', 'verification',
+			// UK (Українська)
+			'паритет', 'аудит', 'паритет даних', 'верифікація',
+			// ES (Español)
+			'paridad', 'auditoria',
+			// FR (Français)
+			'parite',
+			// DE (Deutsch)
+			'datenparitaet',
+			// ZH (中文 - Chinese)
+			'数据对齐', '数据一致性', '审计',
+			// RU (Російська)
+			'паритет данных', 'верификация',
+		],
+		issues: [
+			// EN (English)
+			'issues', 'risks', 'blockers', 'problems', 'notes',
+			// UK (Українська)
+			'ризики', 'зауваження', 'блокери', 'проблеми',
+			// ES (Español)
+			'riesgos', 'problemas',
+			// FR (Français)
+			'risques',
+			// DE (Deutsch)
+			'risiken', 'hinweise',
+			// ZH (中文 - Chinese)
+			'风险', '问题', '注意事项',
+			// RU (Російська)
+			'риски', 'замечания', 'блокеры',
+		],
+		artifacts: [
+			// EN (English)
+			'artifacts', 'files', 'provenance', 'deliverables',
+			// UK (Українська)
+			'артефакти', 'файли',
+			// ES (Español)
+			'artefactos', 'archivos',
+			// FR (Français)
+			'artefacts', 'fichiers',
+			// DE (Deutsch)
+			'artefakte', 'dateien',
+			// ZH (中文 - Chinese)
+			'产物', '文件',
+			// RU (Російська)
+			'артефакты',
+		],
+	}
+
+	/**
+	 * Extend section synonyms dictionary with custom locale mappings.
+	 * @param {Record<string, string[]>} localeMap
+	 */
+	static addLocaleSections(localeMap) {
+		for (const [section, words] of Object.entries(localeMap)) {
+			if (this.SECTIONS[section]) {
+				this.SECTIONS[section].push(...words)
+			}
+		}
+	}
+}
+

package/src/domain/models/ReleaseParityModel.js

@@ -0,0 +1,27 @@
+import { Model } from '@nan0web/types'
+
+export class ReleaseParityModel extends Model {
+	static collection = { type: 'string', required: true }
+	static expected = { type: 'number', required: true }
+	static actual = { type: 'number', required: true }
+	static synced = { type: 'boolean', default: true }
+	static comment = { type: 'string' }
+
+	/**
+	 * @param {Partial<ReleaseParityModel>} [data={}]
+	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Collection name */
+		this.collection
+		/** @type {number} Expected count */
+		this.expected
+		/** @type {number} Actual count */
+		this.actual
+		/** @type {boolean} Synced flag */
+		this.synced
+		/** @type {string} Audit comment */
+		this.comment
+	}
+}

package/src/domain/models/ReleaseTaskModel.js

@@ -0,0 +1,33 @@
+import { Model } from '@nan0web/types'
+
+export class ReleaseTaskModel extends Model {
+	static id = { type: 'string', required: true }
+	static title = { type: 'string', required: true }
+	static status = { type: 'string', default: 'todo' } // 'todo' | 'work' | 'done' | 'fail'
+	static assignee = { type: 'string' }
+	static estimateHours = { type: 'number' }
+	static spentHours = { type: 'number' }
+	static notes = { type: 'string' }
+
+	/**
+	 * @param {Partial<ReleaseTaskModel>} [data={}]
+	 * @param {Partial<import('@nan0web/types').ModelOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Task ID */
+		this.id
+		/** @type {string} Task Title */
+		this.title
+		/** @type {'todo' | 'work' | 'done' | 'fail'} Task Status */
+		this.status
+		/** @type {string} Assignee */
+		this.assignee
+		/** @type {number} Estimated Hours */
+		this.estimateHours
+		/** @type {number} Spent Hours */
+		this.spentHours
+		/** @type {string} Notes */
+		this.notes
+	}
+}

package/src/domain/models/index.js

@@ -0,0 +1,6 @@
+export { ReleaseMemberModel } from './ReleaseMemberModel.js'
+export { ReleaseTaskModel } from './ReleaseTaskModel.js'
+export { ReleaseParityModel } from './ReleaseParityModel.js'
+export { ReleaseIssueModel } from './ReleaseIssueModel.js'
+export { ReleaseModel } from './ReleaseModel.js'
+

package/src/domain/templates/release.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html lang="uk" data-bs-theme="dark">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Releases Catalog — NaN•Web</title>
+  <style>
+    :root {
+      --bg: #0f172a;
+      --surface: #1e293b;
+      --accent: #38bdf8;
+      --text: #f8fafc;
+      --text-dim: #94a3b8;
+      --border: #334155;
+    }
+    body { font-family: system-ui, -apple-system, sans-serif; background: var(--bg); color: var(--text); margin: 0; padding: 2.5rem 1.5rem; display: flex; justify-content: center; line-height: 1.6; }
+    .container { max-width: 880px; width: 100%; }
+    h1, h2, h3 { color: #fff; font-weight: 700; margin-top: 1.5rem; }
+    h1 { font-size: 2rem; border-bottom: 1px solid var(--border); padding-bottom: 0.8rem; }
+    a { color: var(--accent); text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    table { width: 100%; border-collapse: collapse; margin: 1.5rem 0; background: var(--surface); border-radius: 8px; overflow: hidden; }
+    th, td { padding: 0.85rem 1rem; text-align: left; border-bottom: 1px solid var(--border); }
+    th { background: rgba(0,0,0,0.2); font-weight: 600; color: var(--accent); }
+    pre { background: var(--surface); padding: 1rem; border-radius: 8px; border: 1px solid var(--border); overflow-x: auto; color: #a5b4fc; font-family: monospace; }
+    blockquote { border-left: 4px solid var(--accent); margin: 1rem 0; padding: 0.5rem 1rem; background: var(--surface); border-radius: 0 8px 8px 0; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    {{CONTENT}}
+  </div>
+</body>
+</html>

package/src/domain/templates/release.html.template.js

@@ -0,0 +1,34 @@
+export default `<!DOCTYPE html>
+<html lang="uk" data-bs-theme="dark">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Releases Catalog — NaN•Web</title>
+  <style>
+    :root {
+      --bg: #0f172a;
+      --surface: #1e293b;
+      --accent: #38bdf8;
+      --text: #f8fafc;
+      --text-dim: #94a3b8;
+      --border: #334155;
+    }
+    body { font-family: system-ui, -apple-system, sans-serif; background: var(--bg); color: var(--text); margin: 0; padding: 2.5rem 1.5rem; display: flex; justify-content: center; line-height: 1.6; }
+    .container { max-width: 880px; width: 100%; }
+    h1, h2, h3 { color: #fff; font-weight: 700; margin-top: 1.5rem; }
+    h1 { font-size: 2rem; border-bottom: 1px solid var(--border); padding-bottom: 0.8rem; }
+    a { color: var(--accent); text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    table { width: 100%; border-collapse: collapse; margin: 1.5rem 0; background: var(--surface); border-radius: 8px; overflow: hidden; }
+    th, td { padding: 0.85rem 1rem; text-align: left; border-bottom: 1px solid var(--border); }
+    th { background: rgba(0,0,0,0.2); font-weight: 600; color: var(--accent); }
+    pre { background: var(--surface); padding: 1rem; border-radius: 8px; border: 1px solid var(--border); overflow-x: auto; color: #a5b4fc; font-family: monospace; }
+    blockquote { border-left: 4px solid var(--accent); margin: 1rem 0; padding: 0.5rem 1rem; background: var(--surface); border-radius: 0 8px 8px 0; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    {{CONTENT}}
+  </div>
+</body>
+</html>`

package/src/index.js

@@ -30,3 +30,18 @@ export { default as DepsCommand } from './domain/DepsCommand.js'
 export { default as PublishCommand } from './domain/PublishCommand.js'
 export { default as SpecCommand } from './domain/SpecCommand.js'
 export { default as StatusCommand } from './domain/StatusCommand.js'
+export { default as WebCommand } from './domain/WebCommand.js'
+export { default as PreviewCommand } from './domain/PreviewCommand.js'
+export { RegistryModel } from './domain/Registry/RegistryModel.js'
+export { DashboardModel } from './domain/Dashboard/DashboardModel.js'
+export { ReleaseAuditor } from './domain/inspect/ReleaseAuditor.js'
+export {
+	ReleaseModel,
+	ReleaseMemberModel,
+	ReleaseTaskModel,
+	ReleaseParityModel,
+	ReleaseIssueModel,
+} from './domain/models/index.js'
+export { PMaCParser, resolveTrackerUrl } from './domain/PMaCParser.js'
+export { ValidateCommand } from './domain/ValidateCommand.js'
+

package/src/inspectors/inspect-js.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+// Inspector: checks JavaScript/TypeScript files for syntax errors using `node --check`.
+// Uses git to obtain list of changed files in the current HEAD.
+const { execSync } = require('child_process');
+
+function getChangedFiles() {
+  try {
+    const output = execSync('git diff --name-only --diff-filter=ACM HEAD', { encoding: 'utf8' });
+    return output.split(/\n/).filter(f => f.match(/\.(js|ts)$/));
+  } catch (e) {
+    console.error('Failed to obtain changed files:', e.message);
+    process.exit(1);
+  }
+}
+
+function checkFile(file) {
+  console.log(`🔎 Checking ${file}`);
+  try {
+    execSync(`node --check ${file}`, { stdio: 'inherit' });
+  } catch (e) {
+    console.error(`❌ Syntax error in ${file}`);
+    process.exit(1);
+  }
+}
+
+const files = getChangedFiles();
+if (files.length === 0) {
+  console.log('✅ No JavaScript/TypeScript files changed.');
+  process.exit(0);
+}
+files.forEach(checkFile);
+process.exit(0);

package/src/releases/1/0/v1.0.3/task.test.js

@@ -9,7 +9,7 @@ describe('Release v3.0.0 - Dependency Alignment', () => {
 		const pkgPath = join(process.cwd(), 'package.json')
 		const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
 
-		assert.ok(/^3\.1\.\d+$/.test(pkg.version), 'Version should start with 3.1')
+		assert.ok(/^3\.\d+\.\d+$/.test(pkg.version), 'Version should start with 3.x')
 		assert.ok(/^(\^1\.8\.0|workspace:\*)$/.test(pkg.dependencies['@nan0web/ui']), '@nan0web/ui should be ^1.8.0 or workspace:*')
 		assert.ok(/^(\^2\.9\.0|workspace:\*)$/.test(pkg.dependencies['@nan0web/ui-cli']), '@nan0web/ui-cli should be ^2.9.0 or workspace:*')
 	})

package/src/utils/nodejs/GitTelemetry.js

@@ -0,0 +1,154 @@
+import fs from 'node:fs'
+import { execSync } from 'node:child_process'
+
+let rootGitStatusCache = null
+let rootGitBranchCache = null
+const gitInfoCache = new Map()
+const gitTelemetryCache = new Map()
+
+/**
+ * Reset internal Git caches (useful for testing or cache invalidation)
+ */
+export function resetGitCache() {
+	rootGitStatusCache = null
+	rootGitBranchCache = null
+	gitInfoCache.clear()
+	gitTelemetryCache.clear()
+}
+
+/**
+ * Retrieve git branch and workspace status (clean / dirty)
+ * @param {string} [projectDir]
+ * @returns {{ branch: string, gitStatus: 'clean' | 'dirty' }}
+ */
+export function getGitInfo(projectDir) {
+	const key = projectDir || process.cwd()
+	const isMonorepoInternal =
+		!projectDir ||
+		projectDir === '.' ||
+		(!projectDir.startsWith('../') && !projectDir.startsWith('/'))
+
+	if (isMonorepoInternal) {
+		if (rootGitStatusCache === null) {
+			try {
+				rootGitBranchCache =
+					execSync('git rev-parse --abbrev-ref HEAD', {
+						cwd: process.cwd(),
+						stdio: ['ignore', 'pipe', 'ignore'],
+						encoding: 'utf8',
+					}).trim() || 'main'
+				rootGitStatusCache = execSync('git status --porcelain', {
+					cwd: process.cwd(),
+					stdio: ['ignore', 'pipe', 'ignore'],
+					encoding: 'utf8',
+				}).trim()
+			} catch {
+				rootGitBranchCache = 'main'
+				rootGitStatusCache = ''
+			}
+		}
+		const normPrefix =
+			projectDir && projectDir !== '.'
+				? `${projectDir.replace(/\/+$/, '')}/`
+				: ''
+		const isDirty = normPrefix
+			? rootGitStatusCache
+					.split('\n')
+					.some((line) => line.slice(3).trim().startsWith(normPrefix))
+			: rootGitStatusCache.length > 0
+
+		return {
+			branch: rootGitBranchCache,
+			gitStatus: isDirty ? 'dirty' : 'clean',
+		}
+	}
+
+	if (gitInfoCache.has(key)) return gitInfoCache.get(key)
+	if (fs.existsSync && !fs.existsSync(key)) {
+		const res = { branch: 'main', gitStatus: 'clean' }
+		gitInfoCache.set(key, res)
+		return res
+	}
+
+	try {
+		const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+			cwd: key,
+			stdio: ['ignore', 'pipe', 'ignore'],
+			encoding: 'utf8',
+		}).trim()
+		const statusOutput = execSync('git status --porcelain', {
+			cwd: key,
+			stdio: ['ignore', 'pipe', 'ignore'],
+			encoding: 'utf8',
+		}).trim()
+		const res = {
+			branch: branch || 'main',
+			gitStatus: statusOutput.length > 0 ? 'dirty' : 'clean',
+		}
+		gitInfoCache.set(key, res)
+		return res
+	} catch {
+		const res = { branch: 'main', gitStatus: 'clean' }
+		gitInfoCache.set(key, res)
+		return res
+	}
+}
+
+/**
+ * Retrieve development hours and iterations from git commit log
+ * @param {string} [projectDir]
+ * @param {string} [releasePath]
+ * @returns {{ hours: number, iterations: number }}
+ */
+export function getGitCommitTelemetry(projectDir, releasePath) {
+	const targetDir = releasePath || projectDir
+	if (!targetDir) return { hours: 0, iterations: 0 }
+	if (gitTelemetryCache.has(targetDir)) return gitTelemetryCache.get(targetDir)
+	if (fs.existsSync && !fs.existsSync(targetDir)) {
+		const res = { hours: 0, iterations: 0 }
+		gitTelemetryCache.set(targetDir, res)
+		return res
+	}
+
+	try {
+		const logOutput = execSync(
+			`git log --format="%at" -n 50 -- "${targetDir}"`,
+			{
+				cwd: process.cwd(),
+				stdio: ['ignore', 'pipe', 'ignore'],
+				encoding: 'utf8',
+			}
+		).trim()
+
+		if (!logOutput) {
+			const res = { hours: 0, iterations: 0 }
+			gitTelemetryCache.set(targetDir, res)
+			return res
+		}
+
+		const timestamps = logOutput
+			.split('\n')
+			.map((t) => parseInt(t.trim(), 10))
+			.filter((t) => !isNaN(t))
+
+		if (timestamps.length < 2) {
+			const res = { hours: 0.5, iterations: timestamps.length }
+			gitTelemetryCache.set(targetDir, res)
+			return res
+		}
+
+		const minT = Math.min(...timestamps)
+		const maxT = Math.max(...timestamps)
+		const diffHours = Math.round(((maxT - minT) / 3600) * 10) / 10
+		const hours = diffHours > 0 ? diffHours : 0.5
+		const iterations = timestamps.length
+
+		const res = { hours, iterations }
+		gitTelemetryCache.set(targetDir, res)
+		return res
+	} catch {
+		const res = { hours: 0, iterations: 0 }
+		gitTelemetryCache.set(targetDir, res)
+		return res
+	}
+}

package/types/Release/Document.d.ts

@@ -1,14 +1,10 @@
-import Markdown, { MDElement } from '@nan0web/markdown';
-import Person from './Person.js';
+export default ReleaseDocument;
 declare class ReleaseDocument extends Markdown {
-    /** @type {Person[]} */
-    team: Person[];
-    /** @type {Map<string, Person[]>} */
-    roles: Map<string, Person[]>;
-    /** @type {string} */
-    version: string;
-    /** @type {Date | undefined} */
-    date: Date | undefined;
+    /**
+     * @param {*} input
+     * @returns {ReleaseDocument}
+     */
+    static from(input: any): ReleaseDocument;
     /**
      * @param {Object} options
      * @param {Array} [options.team] - Release team members
@@ -17,22 +13,23 @@ declare class ReleaseDocument extends Markdown {
      * @param {string} [options.date] - Release date
      */
     constructor(options?: {
-        team?: any[];
-        roles?: Map<any, any> | any[];
-        version?: string;
-        date?: string;
+        team?: any[] | undefined;
+        roles?: any[] | Map<any, any> | undefined;
+        version?: string | undefined;
+        date?: string | undefined;
     });
-    /**
-     * Parse release document content
-     * Extracts version and date from H1 heading
-     * @param {string} input - Markdown content
-     * @returns {MDElement[]}
-     */
-    parse(input: string): MDElement[];
-    /**
-     * @param {*} input
-     * @returns {ReleaseDocument}
-     */
-    static from(input: any): ReleaseDocument;
+    /** @type {Person[]} */
+    team: Person[];
+    /** @type {Map<string, Person[]>} */
+    roles: Map<string, Person[]>;
+    /** @type {string} */
+    version: string;
+    /** @type {Date | undefined} */
+    date: Date | undefined;
+    sections: {
+        title: string;
+        tasks: any[];
+    }[] | undefined;
 }
-export default ReleaseDocument;
+import Markdown from '@nan0web/markdown';
+import Person from './Person.js';

package/types/Release/MarkdownToTest.d.ts

@@ -1,3 +1,4 @@
+export default MarkdownToTest;
 /**
  * MarkdownToTest - generates node:test code from markdown release notes
  * Enables writing release notes first, then generating executable tests
@@ -44,4 +45,3 @@ declare class MarkdownToTest {
         tasks: any[];
     }>): string;
 }
-export default MarkdownToTest;

package/types/Release/Person.d.ts

@@ -1,15 +1,17 @@
-import { HumanName, HumanContact, HumanGender } from '@nan0web/logos';
 export default class Person {
+    /**
+     * @param {*} input
+     * @returns {Person}
+     */
+    static from(input: any): Person;
+    constructor(input?: {});
     /** @type {HumanName} */
     name: HumanName;
     /** @type {HumanGender} */
     gender: HumanGender;
     /** @type {HumanContact[]} */
     contacts: HumanContact[];
-    constructor(input?: {});
-    /**
-     * @param {*} input
-     * @returns {Person}
-     */
-    static from(input: any): Person;
 }
+import { HumanName } from '@nan0web/logos';
+import { HumanGender } from '@nan0web/logos';
+import { HumanContact } from '@nan0web/logos';