@ti-engine/web-framework 1.20.0 → 1.21.0

package/components/application-info.js

@@ -0,0 +1,190 @@
+/*
+ * The ti-engine is an open source, free to use—both for personal and commercial projects—framework for the creation of microservice-based solutions using node.js.
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+"use strict";
+
+const path = require( "node:path" );
+const fs = require( "node:fs" );
+
+/** @import { TiApplicationInfo } from "#definitions" */
+
+/**
+ * Matches the leading npm scope of a package name (`@ti-engine/competence` → `competence`).
+ *
+ * @type {RegExp}
+ */
+const RE_PACKAGE_SCOPE = /^@[^/]+\//;
+
+/**
+ * Matches the first character that can open the contact suffix of a `package.json` author string — the `<` of the
+ * e-mail or the `(` of the homepage.
+ *
+ * @type {RegExp}
+ */
+const RE_AUTHOR_CONTACT_START = /[<(]/;
+
+/**
+ * Turns an npm package name into a human-readable display name — the scope is dropped and each dash/underscore
+ * separated word is capitalized (`@ti-engine/web-framework` → `Web Framework`). Used only when neither the manifest
+ * nor the environment supplies an explicit display name.
+ *
+ * @method
+ * @param {string} packageName
+ * @returns {string}
+ * @private
+ */
+function toDisplayName( packageName ) {
+    const bare = String( packageName || "" ).replace( RE_PACKAGE_SCOPE, "" ).trim();
+    if ( !bare ) {
+        return "";
+    }
+    return bare
+        .split( /[-_.\s]+/ )
+        .filter( ( word ) => word.length > 0 )
+        .map( ( word ) => word.charAt( 0 ).toUpperCase() + word.slice( 1 ) )
+        .join( " " );
+}
+
+/**
+ * Reduces a `package.json` author entry — either the string form or the object form — to a bare display name,
+ * dropping the e-mail address and homepage that npm allows to be inlined in the string form.
+ * <br/>
+ * NOTE: npm's string form is `Name <email> (url)`, where both bracketed parts are optional **suffixes** — they are
+ * never embedded inside the name. So the name is simply everything before the first `<` or `(`. This deliberately
+ * does NOT globally remove `<…>` spans: a replace of that shape reads as an attempt to strip HTML tags, which
+ * CodeQL flags as an incomplete multi-character sanitizer (`js/incomplete-multi-character-sanitization`, high) —
+ * correctly, since one pass over `<<a>b>` leaves a stray `<`. Truncating at the delimiter matches the actual
+ * grammar and cannot leave a partial span behind.
+ *
+ * @method
+ * @param {string|Object} author
+ * @returns {string}
+ * @private
+ */
+function toAuthorName( author ) {
+    if ( author && typeof author === "object" ) {
+        return String( author.name || "" ).trim();
+    }
+    const declared = String( author || "" );
+    const contactStart = declared.search( RE_AUTHOR_CONTACT_START );
+    return ( contactStart === -1 ? declared : declared.slice( 0, contactStart ) ).trim();
+}
+
+/**
+ * Reduces a `package.json` repository entry — either the string shorthand or the object form — to a plain URL,
+ * stripping the `git+` prefix and `.git` suffix npm accepts so the result is browser-openable.
+ *
+ * @method
+ * @param {string|Object} repository
+ * @returns {string}
+ * @private
+ */
+function toRepositoryUrl( repository ) {
+    const raw = ( repository && typeof repository === "object" ) ? repository.url : repository;
+    const url = String( raw || "" ).trim();
+    if ( !url ) {
+        return "";
+    }
+    return url.replace( /^git\+/, "" ).replace( /\.git$/, "" );
+}
+
+/**
+ * Returns the trimmed string value of `value`, or `fallback` when it is absent or blank. Keeps the builder below
+ * free of repeated `String( … ).trim() || …` noise while treating a whitespace-only manifest field as absent.
+ *
+ * @method
+ * @param {*} value
+ * @param {string} [fallback=""]
+ * @returns {string}
+ * @private
+ */
+function text( value, fallback = "" ) {
+    const resolved = String( value === undefined || value === null ? "" : value ).trim();
+    return resolved || fallback;
+}
+
+/**
+ * Builds the normalized application-information descriptor that backs the framework "About" screen.
+ * <br/>
+ * The function is PURE — everything it needs is injected — so the whole resolution order (manifest → environment
+ * override) is unit-testable without touching the filesystem or `process.env`. The impure half, reading the
+ * consuming application's manifest, is {@link readApplicationManifest}.
+ * <br/>
+ * Resolution order for the three overridable fields is manifest first, environment last:
+ * - `TI_WEB_APP_NAME` overrides `manifest.displayName` / a display name derived from `manifest.name`;
+ * - `TI_WEB_APP_VERSION` overrides `manifest.version`;
+ * - `TI_WEB_APP_RELEASE_DATE` overrides `manifest.releaseDate`.
+ * <br/>
+ * The environment wins because it is how a container image stamps facts that its baked-in manifest cannot know —
+ * most importantly the build/release date, for which `package.json` has no standard field at all.
+ *
+ * @method
+ * @param {Object} [options]
+ * @param {Object} [options.manifest] A `package.json`-shaped object for the consuming application.
+ * @param {Object} [options.env] The environment source (injectable for testing).
+ * @param {Array<{name: string, version: string}>} [options.components] Framework component versions to list.
+ * @param {Object} [options.runtime] Runtime facts (node/platform/instance). Included verbatim when present; the
+ * caller decides whether the current session is allowed to see them.
+ * @returns {TiApplicationInfo}
+ * @public
+ */
+function buildApplicationInfo( options = {} ) {
+    const manifest = ( options.manifest && typeof options.manifest === "object" ) ? options.manifest : {};
+    const env = ( options.env && typeof options.env === "object" ) ? options.env : {};
+
+    const packageName = text( manifest.name );
+    const name = text( env.TI_WEB_APP_NAME, text( manifest.displayName, toDisplayName( packageName ) ) );
+    const author = toAuthorName( manifest.author );
+    const homepage = text( manifest.homepage, toRepositoryUrl( manifest.repository ) );
+
+    const components = ( Array.isArray( options.components ) ? options.components : [] )
+        .map( ( component ) => ( {
+            name: text( component && component.name ),
+            version: text( component && component.version )
+        } ) )
+        .filter( ( component ) => component.name.length > 0 );
+
+    return {
+        name: name,
+        packageName: packageName,
+        version: text( env.TI_WEB_APP_VERSION, text( manifest.version ) ),
+        releaseDate: text( env.TI_WEB_APP_RELEASE_DATE, text( manifest.releaseDate ) ),
+        description: text( manifest.description ),
+        license: text( manifest.license ),
+        homepage: homepage,
+        author: author,
+        components: components,
+        runtime: ( options.runtime && typeof options.runtime === "object" ) ? { ...options.runtime } : null,
+        sections: []
+    };
+}
+
+/**
+ * Reads the consuming application's `package.json`. This is the one impure function in this module.
+ * <br/>
+ * NOTE: A missing or malformed manifest resolves to an empty object rather than throwing — an informational screen
+ * must never be the reason a request fails, and {@link buildApplicationInfo} produces a usable (if sparse)
+ * descriptor from `{}`.
+ *
+ * @method
+ * @param {string} [directory=process.cwd()] The directory holding the manifest.
+ * @returns {Object}
+ * @public
+ */
+function readApplicationManifest( directory = process.cwd() ) {
+    try {
+        const manifestPath = path.join( directory, "package.json" );
+        const contents = fs.readFileSync( manifestPath, "utf8" );
+        const parsed = JSON.parse( contents );
+        return ( parsed && typeof parsed === "object" ) ? parsed : {};
+    } catch {
+        return {};
+    }
+}
+
+module.exports = { buildApplicationInfo, readApplicationManifest };

package/components/definitions.types.js

@@ -26,3 +26,68 @@
  * @property {(callback: TiSessionCallback) => TiSession} destroy
  * @property {(callback?: TiSessionCallback) => TiSession} save
  */
+
+/**
+ * One label/value pair inside a {@link TiInfoSection}. Both strings are display-ready — already localized and
+ * already formatted by the server, since that is where the session language and the label catalogue live. The
+ * three flags are purely presentational; an empty `value` renders the screen's placeholder.
+ *
+ * @typedef {Object} TiInfoItem
+ * @property {string} label
+ * @property {string} [value]
+ * @property {string} [href] Renders the value as a link to this target. Only `http:`, `https:` and `mailto:` are
+ * honoured — any other scheme is dropped client-side and the item degrades to plain text.
+ * @property {boolean} [wide] Span the full width of the section grid instead of one column.
+ * @property {boolean} [mono] Render the value in the monospaced face (IDs, versions, hashes).
+ * @property {boolean} [muted] Render the value as a dimmed hint rather than primary text.
+ */
+
+/**
+ * A titled group of label/value pairs. The framework's Profile and About screens render an array of these
+ * generically, so an application contributes content without contributing layout.
+ *
+ * @typedef {Object} TiInfoSection
+ * @property {string} title
+ * @property {string} [description] Optional intro line under the section title.
+ * @property {string} [icon] Optional `ti-icon` variant name for the section head.
+ * @property {boolean} [wide] Claim the full row of the two-up section grid instead of one column.
+ * @property {TiInfoItem[]} items A section with no items is dropped rather than rendered empty.
+ */
+
+/**
+ * The identity header of the Profile screen — the avatar/name block and the pills beside it.
+ *
+ * @typedef {Object} TiProfileIdentity
+ * @property {string} name
+ * @property {string} [subtitle] Meta line under the name (e.g. `role family · specialization · unit`).
+ * @property {string} [caption] Secondary line under the subtitle (e.g. the corporate e-mail).
+ * @property {string} [avatarSeed] Stable seed for the deterministic avatar colour; defaults to the name.
+ * @property {{text: string, tone?: string}} [badge] Small qualifier rendered inside the meta line.
+ * @property {Array<{text: string, tone?: string, dot?: boolean, mono?: boolean}>} [tags] Pills beside the name.
+ */
+
+/**
+ * The descriptor backing the framework Profile screen.
+ *
+ * @typedef {Object} TiProfileInfo
+ * @property {TiProfileIdentity} identity
+ * @property {TiInfoSection[]} sections
+ */
+
+/**
+ * The descriptor backing the framework About screen. Produced by `buildApplicationInfo` and optionally extended by
+ * the application through {@link TiWebAppManager#getApplicationInfo}.
+ *
+ * @typedef {Object} TiApplicationInfo
+ * @property {string} name Display name of the application.
+ * @property {string} packageName The npm package name it was resolved from.
+ * @property {string} version
+ * @property {string} releaseDate
+ * @property {string} description
+ * @property {string} license
+ * @property {string} homepage
+ * @property {string} author
+ * @property {Array<{name: string, version: string}>} components Framework component versions.
+ * @property {Object|null} runtime Runtime facts (node/platform/instance), or `null` when withheld.
+ * @property {TiInfoSection[]} sections Application-contributed extra sections.
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ti-engine/web-framework",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "A web-framework based on the ti-engine. It provides a customizable ready-to-use web-server microservice and a set of tools for creating web applications. NOTICE: This is still a work in progress and the full architecture, design, and functionality are not available!",
   "keywords": [
     "ti-engine",
@@ -37,6 +37,10 @@
       "types": "./types/components/admin-config-handlers.d.ts",
       "default": "./components/admin-config-handlers.js"
     },
+    "#application-info": {
+      "types": "./types/components/application-info.d.ts",
+      "default": "./components/application-info.js"
+    },
     "#auth-manager": {
       "types": "./types/components/auth-manager.d.ts",
       "default": "./components/auth-manager.js"

package/types/bin/web-app-manager.d.ts

@@ -1,5 +1,5 @@
 export = TiWebAppManager;
-import type { TiSession } from "#definitions";
+import type { TiApplicationInfo, TiInfoSection, TiProfileInfo, TiSession } from "#definitions";
 /**
  * Gates the login-page authentication markup to the effective enabled methods. The login fragment delimits blocks
  * with HTML-comment markers: `<!--ti-auth-method:METHOD-->…<!--/ti-auth-method-->` around each method's control
@@ -160,6 +160,100 @@ declare class TiWebAppManager {
      * @public
      */
     processDataRequest(session: TiSession, view: string, options?: Object): Promise<Object>;
+    /**
+     * Returns the configuration for the shared UI components the application shell renders — currently the sidebar
+     * user flyout menu. Shipped as part of the `config` data payload and merged into the `tiComponentsConfig`
+     * Alpine store on the client.
+     * <br/>
+     * The default menu links the two screens the framework itself provides (Profile and About) plus sign-out, so a
+     * consuming application gets a working user menu without configuring one. Override to replace it; a subclass
+     * that supplies its own `componentsConfig` naturally supersedes this.
+     *
+     * @method
+     * @param {TiSession} session
+     * @returns {Object}
+     * @virtual
+     * @public
+     */
+    buildComponentsConfig(session: TiSession): Object;
+    /**
+     * Returns the descriptor rendered by the "Profile" screen — the identity header plus an ordered list of titled
+     * label/value sections. Every string in it is display-ready: the server resolves labels and formats values,
+     * because this is where the session language and the label catalogue are (see {@link resolveLabel}).
+     * <br/>
+     * The default implementation reports what the framework itself knows about the session user — name, username,
+     * e-mail, language and roles. Override in subclasses to show application-owned data instead; the screen, its
+     * Alpine component and its styling are inherited unchanged, so an override only decides the content.
+     * <br/>
+     * NOTE: The descriptor is always about the SESSION user. There is deliberately no "whose profile" parameter —
+     * viewing another person's record belongs to an application screen that carries its own scoping rules.
+     *
+     * @method
+     * @param {TiSession} session
+     * @returns {Promise<TiProfileInfo>}
+     * @exception {TiException.E_SEC_UNAUTHORIZED_ACCESS} (401) When the session carries no user.
+     * @virtual
+     * @public
+     */
+    getProfileInfo(session: TiSession): Promise<TiProfileInfo>;
+    /**
+     * Returns the descriptor rendered by the "About" screen — the application's own identity (name, version,
+     * release date, description, license, homepage) plus the ti-engine component versions it runs on, and any
+     * extra sections the application contributes.
+     * <br/>
+     * The baseline is resolved once from the consuming application's `package.json`, overridable through
+     * `TI_WEB_APP_NAME` / `TI_WEB_APP_VERSION` / `TI_WEB_APP_RELEASE_DATE` (see `#application-info`), and cached —
+     * the manifest cannot change while the process runs.
+     * <br/>
+     * NOTE: Runtime facts (node version, platform, instance identity) are attached only for an `admin` session.
+     * They are operational detail that helps support and means nothing to an ordinary user, so they are not handed
+     * to every signed-in visitor. Override in subclasses to append application-specific sections; call `super` and
+     * extend the result rather than rebuilding it.
+     *
+     * @method
+     * @param {TiSession} session
+     * @returns {Promise<TiApplicationInfo>}
+     * @virtual
+     * @public
+     */
+    getApplicationInfo(session: TiSession): Promise<TiApplicationInfo>;
+    /**
+     * Builds the identity header of the Profile screen from the session user. Kept separate from
+     * {@link TiWebAppManager#getProfileInfo} so a subclass that replaces the sections can still reuse — or fall
+     * back to — the framework's identity block when the application has no richer identity to show.
+     *
+     * @method
+     * @param {TiSession} session
+     * @returns {Object}
+     * @public
+     */
+    buildSessionIdentity(session: TiSession): Object;
+    /**
+     * Builds the framework's account-level Profile sections from the session user. A subclass showing richer
+     * application data can append these so the account facts remain visible alongside it.
+     *
+     * @method
+     * @param {TiSession} session
+     * @returns {TiInfoSection[]}
+     * @public
+     */
+    buildAccountSections(session: TiSession): TiInfoSection[];
+    /**
+     * Resolves the versions of the ti-engine packages the running application is built on, for the About screen.
+     * <br/>
+     * NOTE: `@ti-engine/core` does not expose `./package.json` through its exports map, so its manifest is located
+     * by walking up from a module it *does* export. A package that cannot be resolved is simply omitted — an
+     * informational screen must never be the reason a request fails.
+     *
+     * @method
+     * @static
+     * @returns {Array<{name: string, version: string}>}
+     * @public
+     */
+    static resolveFrameworkComponents(): Array<{
+        name: string;
+        version: string;
+    }>;
     /**
      * Used to process an application service request.
      *

package/types/bin/web-server.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 export = TiWebServer;
 import ServiceConsumer = require("@ti-engine/core/service-consumer");
 export type NodeServer = import("node:http").Server;

package/types/components/application-info.d.ts

@@ -0,0 +1,53 @@
+declare const _exports: {
+    buildApplicationInfo: typeof buildApplicationInfo;
+    readApplicationManifest: typeof readApplicationManifest;
+};
+export = _exports;
+import type { TiApplicationInfo } from "#definitions";
+/**
+ * Builds the normalized application-information descriptor that backs the framework "About" screen.
+ * <br/>
+ * The function is PURE — everything it needs is injected — so the whole resolution order (manifest → environment
+ * override) is unit-testable without touching the filesystem or `process.env`. The impure half, reading the
+ * consuming application's manifest, is {@link readApplicationManifest}.
+ * <br/>
+ * Resolution order for the three overridable fields is manifest first, environment last:
+ * - `TI_WEB_APP_NAME` overrides `manifest.displayName` / a display name derived from `manifest.name`;
+ * - `TI_WEB_APP_VERSION` overrides `manifest.version`;
+ * - `TI_WEB_APP_RELEASE_DATE` overrides `manifest.releaseDate`.
+ * <br/>
+ * The environment wins because it is how a container image stamps facts that its baked-in manifest cannot know —
+ * most importantly the build/release date, for which `package.json` has no standard field at all.
+ *
+ * @method
+ * @param {Object} [options]
+ * @param {Object} [options.manifest] A `package.json`-shaped object for the consuming application.
+ * @param {Object} [options.env] The environment source (injectable for testing).
+ * @param {Array<{name: string, version: string}>} [options.components] Framework component versions to list.
+ * @param {Object} [options.runtime] Runtime facts (node/platform/instance). Included verbatim when present; the
+ * caller decides whether the current session is allowed to see them.
+ * @returns {TiApplicationInfo}
+ * @public
+ */
+declare function buildApplicationInfo(options?: {
+    manifest?: Object;
+    env?: Object;
+    components?: Array<{
+        name: string;
+        version: string;
+    }>;
+    runtime?: Object;
+}): TiApplicationInfo;
+/**
+ * Reads the consuming application's `package.json`. This is the one impure function in this module.
+ * <br/>
+ * NOTE: A missing or malformed manifest resolves to an empty object rather than throwing — an informational screen
+ * must never be the reason a request fails, and {@link buildApplicationInfo} produces a usable (if sparse)
+ * descriptor from `{}`.
+ *
+ * @method
+ * @param {string} [directory=process.cwd()] The directory holding the manifest.
+ * @returns {Object}
+ * @public
+ */
+declare function readApplicationManifest(directory?: string): Object;

package/types/components/definitions.types.d.ts

@@ -11,6 +11,112 @@ export type TiSession = {
     destroy: (callback: TiSessionCallback) => TiSession;
     save: (callback?: TiSessionCallback) => TiSession;
 };
+export type TiInfoItem = {
+    label: string;
+    value?: string;
+    /**
+     * Renders the value as a link to this target. Only `http:`, `https:` and `mailto:` are
+     * honoured — any other scheme is dropped client-side and the item degrades to plain text.
+     */
+    href?: string;
+    /**
+     * Span the full width of the section grid instead of one column.
+     */
+    wide?: boolean;
+    /**
+     * Render the value in the monospaced face (IDs, versions, hashes).
+     */
+    mono?: boolean;
+    /**
+     * Render the value as a dimmed hint rather than primary text.
+     */
+    muted?: boolean;
+};
+export type TiInfoSection = {
+    title: string;
+    /**
+     * Optional intro line under the section title.
+     */
+    description?: string;
+    /**
+     * Optional `ti-icon` variant name for the section head.
+     */
+    icon?: string;
+    /**
+     * Claim the full row of the two-up section grid instead of one column.
+     */
+    wide?: boolean;
+    /**
+     * A section with no items is dropped rather than rendered empty.
+     */
+    items: TiInfoItem[];
+};
+export type TiProfileIdentity = {
+    name: string;
+    /**
+     * Meta line under the name (e.g. `role family · specialization · unit`).
+     */
+    subtitle?: string;
+    /**
+     * Secondary line under the subtitle (e.g. the corporate e-mail).
+     */
+    caption?: string;
+    /**
+     * Stable seed for the deterministic avatar colour; defaults to the name.
+     */
+    avatarSeed?: string;
+    /**
+     * Small qualifier rendered inside the meta line.
+     */
+    badge?: {
+        text: string;
+        tone?: string;
+    };
+    /**
+     * Pills beside the name.
+     */
+    tags?: Array<{
+        text: string;
+        tone?: string;
+        dot?: boolean;
+        mono?: boolean;
+    }>;
+};
+export type TiProfileInfo = {
+    identity: TiProfileIdentity;
+    sections: TiInfoSection[];
+};
+export type TiApplicationInfo = {
+    /**
+     * Display name of the application.
+     */
+    name: string;
+    /**
+     * The npm package name it was resolved from.
+     */
+    packageName: string;
+    version: string;
+    releaseDate: string;
+    description: string;
+    license: string;
+    homepage: string;
+    author: string;
+    /**
+     * Framework component versions.
+     */
+    components: Array<{
+        name: string;
+        version: string;
+    }>;
+    /**
+     * Runtime facts (node/platform/instance), or `null` when withheld.
+     */
+    runtime: Object | null;
+    /**
+     * Application-contributed extra sections.
+     */
+    sections: TiInfoSection[];
+};
 /** @import { TiLocalizationLanguage } from "@ti-engine/core/localization" */
 /**
  * @callback TiSessionCallback
@@ -29,3 +135,63 @@ export type TiSession = {
  * @property {(callback: TiSessionCallback) => TiSession} destroy
  * @property {(callback?: TiSessionCallback) => TiSession} save
  */
+/**
+ * One label/value pair inside a {@link TiInfoSection}. Both strings are display-ready — already localized and
+ * already formatted by the server, since that is where the session language and the label catalogue live. The
+ * three flags are purely presentational; an empty `value` renders the screen's placeholder.
+ *
+ * @typedef {Object} TiInfoItem
+ * @property {string} label
+ * @property {string} [value]
+ * @property {string} [href] Renders the value as a link to this target. Only `http:`, `https:` and `mailto:` are
+ * honoured — any other scheme is dropped client-side and the item degrades to plain text.
+ * @property {boolean} [wide] Span the full width of the section grid instead of one column.
+ * @property {boolean} [mono] Render the value in the monospaced face (IDs, versions, hashes).
+ * @property {boolean} [muted] Render the value as a dimmed hint rather than primary text.
+ */
+/**
+ * A titled group of label/value pairs. The framework's Profile and About screens render an array of these
+ * generically, so an application contributes content without contributing layout.
+ *
+ * @typedef {Object} TiInfoSection
+ * @property {string} title
+ * @property {string} [description] Optional intro line under the section title.
+ * @property {string} [icon] Optional `ti-icon` variant name for the section head.
+ * @property {boolean} [wide] Claim the full row of the two-up section grid instead of one column.
+ * @property {TiInfoItem[]} items A section with no items is dropped rather than rendered empty.
+ */
+/**
+ * The identity header of the Profile screen — the avatar/name block and the pills beside it.
+ *
+ * @typedef {Object} TiProfileIdentity
+ * @property {string} name
+ * @property {string} [subtitle] Meta line under the name (e.g. `role family · specialization · unit`).
+ * @property {string} [caption] Secondary line under the subtitle (e.g. the corporate e-mail).
+ * @property {string} [avatarSeed] Stable seed for the deterministic avatar colour; defaults to the name.
+ * @property {{text: string, tone?: string}} [badge] Small qualifier rendered inside the meta line.
+ * @property {Array<{text: string, tone?: string, dot?: boolean, mono?: boolean}>} [tags] Pills beside the name.
+ */
+/**
+ * The descriptor backing the framework Profile screen.
+ *
+ * @typedef {Object} TiProfileInfo
+ * @property {TiProfileIdentity} identity
+ * @property {TiInfoSection[]} sections
+ */
+/**
+ * The descriptor backing the framework About screen. Produced by `buildApplicationInfo` and optionally extended by
+ * the application through {@link TiWebAppManager#getApplicationInfo}.
+ *
+ * @typedef {Object} TiApplicationInfo
+ * @property {string} name Display name of the application.
+ * @property {string} packageName The npm package name it was resolved from.
+ * @property {string} version
+ * @property {string} releaseDate
+ * @property {string} description
+ * @property {string} license
+ * @property {string} homepage
+ * @property {string} author
+ * @property {Array<{name: string, version: string}>} components Framework component versions.
+ * @property {Object|null} runtime Runtime facts (node/platform/instance), or `null` when withheld.
+ * @property {TiInfoSection[]} sections Application-contributed extra sections.
+ */