textalive-react-api 0.3.1 → 0.4.13

package/dist/textalive-react-api.d.ts

@@ -1,17 +1,24 @@
 import { Context } from 'react';
 import { DetailedHTMLProps } from 'react';
 import { FC } from 'react';
+import { ForwardRefExoticComponent } from 'react';
 import { HTMLAttributes } from 'react';
-import { Interpolation } from '@emotion/serialize';
-import { Option as Option_2 } from 'react-dropdown-now';
 import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
 import { RefObject } from 'react';
+import { SliderProps } from '@mantine/core';
+import { TextProps } from '@mantine/core';
 
 /**
  * TextAlive ログインに使えるサービス / Account service for TextAlive login
+ *
+ * @internal
  */
 declare type AccountService = "twitter" | "github" | "youtube" | "piapro" | "songle";
 
+/**
+ * @internal
+ */
 declare interface Asset {
     originalUrl: string;
     contentType?: number;
@@ -24,6 +31,9 @@ declare interface Asset {
     createdDate?: string;
 }
 
+/**
+ * @internal
+ */
 declare interface AssetLicense {
     code?: number;
     condition?: {
@@ -40,7 +50,7 @@ declare interface AssetLicense {
  * 背景グラフィックに関するイベントのリスナ
  *
  * Event listener for background graphics
- * @public
+ * @internal
  */
 declare interface BackgroundGraphicsListener {
     /**
@@ -53,6 +63,9 @@ declare interface BackgroundGraphicsListener {
     onBackgroundGraphicsUpdate?(backgroundImage: BackgroundImageAsset): void;
 }
 
+/**
+ * @internal
+ */
 declare interface BackgroundImageAsset extends Asset {
     css?: string;
     x?: number;
@@ -68,33 +81,14 @@ declare interface CharData extends UnitData, FontData {
     char?: string;
 }
 
-export declare const Check: FC<CheckProps>;
-
-export declare interface CheckProps {
-    label?: ReactNode;
-    labelTitle?: string;
-    value: boolean;
-    onValueChange?(value: boolean): void;
-    styles?: CheckStyles;
-}
-
-export declare interface CheckStyles {
-    container?: Interpolation;
-    containerDisabled?: Interpolation;
-    track?: Interpolation;
-    trackChecked?: Interpolation;
-    button?: Interpolation;
-    buttonChecked?: Interpolation;
-}
-
 export declare const CheckWidget: FC<CheckWidgetProps>;
 
 export declare interface CheckWidgetProps {
     widget: ParameterWidget;
-    value: any;
+    value: ParameterValue;
     onValueChange?(value: boolean): void;
     withoutName?: boolean;
-    styles?: CheckStyles;
+    description?: string | RegionalText;
 }
 
 /**
@@ -116,21 +110,30 @@ declare interface ColorData {
 export declare const ColorPicker: FC<ColorPickerProps>;
 
 export declare interface ColorPickerProps {
+    position?: WidgetPosition;
     label?: ReactNode;
+    /**
+     * @deprecated use `description` instead
+     */
     labelTitle?: string;
+    description?: string;
     value: IColor;
     colorFactory(hexString: string): IColor;
     onValueChange?(value: IColor): void;
 }
 
+export declare const ColorsContext: Context<string[] | null>;
+
 export declare const ColorWidget: FC<ColorWidgetProps>;
 
 export declare interface ColorWidgetProps {
+    position?: WidgetPosition;
     widget: ParameterWidget;
-    value: any;
+    value: ParameterValue;
     colorFactory(hexString: string): IColor;
     onValueChange?(value: IColor): void;
     withoutName?: boolean;
+    description?: string | RegionalText;
 }
 
 /**
@@ -141,6 +144,9 @@ export declare interface ColorWidgetProps {
  */
 declare type DataLoaderListener = VideoLoaderListener & SongLoaderListener & TextLoaderListener & FontLoaderListener;
 
+/**
+ * @public
+ */
 declare interface DecomposedProps {
     x?: number;
     y?: number;
@@ -151,6 +157,9 @@ declare interface DecomposedProps {
     rotation?: number;
 }
 
+/**
+ * @internal
+ */
 declare interface EndpointData {
     fallback: {
         protocol: string;
@@ -164,6 +173,17 @@ declare interface EndpointData {
         protocol?: string;
         domain: string;
         server?: string;
+        appToken?: string;
+        authUser?: string;
+        authToken?: string;
+    };
+    content: {
+        protocol?: string;
+        domain: string;
+        server?: string;
+    };
+    client: {
+        version?: string;
     };
 }
 
@@ -173,20 +193,21 @@ declare interface EndpointData {
  * Find options for sorted timed objects
  * @public
  */
-declare interface FindTimedObjectOptions {
+declare type FindTimedObjectOptions = {
     /**
      * 指定された場合、探索対象の時刻とこの時刻情報がなす区間と重複する時刻付きオブジェクトを返す
      *
      * When specified, find an object that overlaps with the specified range rather than the timing
      */
     endTime?: number;
+} | {
     /**
      * 指定された場合、時刻付きオブジェクトは必ずしも探索対象の時刻を含んでいなくてもよい（二分探索の結果をそのまま返す）
      *
      * When specified, an object does not need to contain the specified timing (result from the binary tree search is always returned)
      */
     loose?: boolean;
-}
+};
 
 /**
  * @public
@@ -197,13 +218,23 @@ declare interface FontData {
     fontStyle?: string;
 }
 
+export declare const FontFamilyDropdown: FC<FontFamilyDropdownProps>;
+
+export declare interface FontFamilyDropdownProps extends Omit<SelectDropdownProps, "options"> {
+    value: string;
+    onValueChange?(value: string): void;
+    withPrivate?: boolean;
+}
+
 export declare const FontFamilyWidget: FC<FontFamilyWidgetProps>;
 
 export declare interface FontFamilyWidgetProps {
     widget: ParameterWidget;
     value: any;
     onValueChange?(value: ParameterValue): void;
+    withPrivate?: boolean;
     withoutName?: boolean;
+    description?: string | RegionalText;
 }
 
 /**
@@ -237,10 +268,21 @@ declare interface FontInfo {
      * URL of the CSS file
      */
     url?: string;
+    /**
+     * CSSのURL (頻出文字のみを抽出したサブセット)
+     *
+     * URL of the CSS file (Subset fonts for frequently-used chars)
+     */
+    compactUrl?: string;
+    /**
+     * プライベートフォントか否か
+     */
+    isPrivate?: boolean;
     /**
      * モリサワ TypeSquare フォントか否か
      *
      * Whether this font is provided by Morisawa TypeSquare or not
+     * @internal
      */
     typesquare?: boolean;
     /**
@@ -256,6 +298,12 @@ declare interface FontInfo {
      * @internal
      */
     typekit?: boolean;
+    /**
+     * フォントのグループ名
+     *
+     * Optional font group name
+     */
+    group?: string;
 }
 
 /**
@@ -285,12 +333,12 @@ declare interface FontLoadingError extends Error {
 export declare const FontsContext: Context<FontInfo[] | null>;
 
 /**
- * @public
+ * @internal
  */
 declare type GraphicData = UnitData;
 
 /**
- * @public
+ * @internal
  */
 declare interface GraphicsDriver {
     /**
@@ -353,20 +401,32 @@ declare interface GraphicsDriver {
 
 export declare const GraphicsDriverContext: Context<GraphicsDriver | null>;
 
+/**
+ * @internal
+ */
 declare interface IAssetLicenceLoader {
     read(url: string, skipOptoutCheck?: boolean): Promise<Asset>;
 }
 
+/**
+ * @internal
+ */
 declare interface IAssetURLManager {
     isUploaderAsset(asset: Asset): boolean;
     isPiaproAsset(asset: Asset): boolean;
 }
 
+/**
+ * @internal
+ */
 declare interface IBackgroundAssetManager {
     checkBackgroundImageLicense(license: AssetLicense): boolean;
     getQueryParameter(backgroundImage: BackgroundImageAsset): string;
 }
 
+/**
+ * @internal
+ */
 declare interface IBackgroundGraphicsLoader {
     readonly background: BackgroundImageAsset;
     readonly defaultBackgroundCss: string;
@@ -377,12 +437,19 @@ declare interface IBackgroundGraphicsLoader {
     exportPartialVideoEntry(options: VideoExportOptions): Partial<VideoEntry>;
 }
 
+/**
+ * @internal
+ */
 declare type IBackgroundPlayer = IBackgroundURLManager & IAssetURLManager & IBackgroundAssetManager & IAssetLicenceLoader;
 
+/**
+ * @internal
+ */
 declare interface IBackgroundURLManager {
     isBlankBackgroundAsset(background: BackgroundImageAsset): boolean;
     isBackgroundColorAsset(background: BackgroundImageAsset): boolean;
     isBackgroundPiaproImageAsset(background: BackgroundImageAsset): boolean;
+    isBackgroundRawImageAsset(background: BackgroundImageAsset): boolean;
     isBackgroundSpecialImageAsset(background: BackgroundImageAsset): boolean;
 }
 
@@ -391,9 +458,7 @@ declare interface IBackgroundURLManager {
  * @public
  */
 declare interface IBeat extends TimedObject {
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly endTime: number;
     /** ビート間隔 [ms] / Duration [ms] */
     readonly duration: number;
@@ -417,24 +482,15 @@ declare interface IBeat extends TimedObject {
 }
 
 /**
+ * 文字 / Character
  * @public
  */
 declare interface IChar extends ITextUnit {
-    /**
-     * @inheritDoc
-     */
-    animate: RenderingUnitFunction<IChar>;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly parent: IWord;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly previous: IChar;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly next: IChar;
 }
 
@@ -481,8 +537,14 @@ declare interface IColor {
     value: number;
     /** 色情報の16進数表現 (RGB) / Hex string (RGB) */
     readonly rgb: string;
-    /** 色情報の16進数表現 (RGBA) / Hex string (RGBA) */
+    /** 色情報のCSS互換表現 (RGB; e.g., rgba(17,34,51)) / Color info in CSS-compatible format (RGB; e.g., rgba(17,34,51)) */
+    readonly cssRgb: string;
+    /** 色情報の16進数表現 (RGBA; e.g., #11223300) / Hex string (RGBA; e.g., #11223300) */
     readonly rgba: string;
+    /** 色情報の16進数表現 (ARGB; e.g., 0x00112233) / Hex string (ARGB; e.g., 0x00112233) */
+    readonly argb: string;
+    /** 色情報のCSS互換表現 (RGBA; e.g., rgba(17,34,51,0)) / Color info in CSS-compatible format (RGBA; e.g., rgba(17,34,51,0)) */
+    readonly cssRgba: string;
     /**
      * @param color - 色情報 / Color
      * @returns 色情報が一致するか否か / Whether the specified color info matches the current info
@@ -503,9 +565,9 @@ declare interface IColor {
      */
     from(color: string | number | IColor): void;
     /**
-     * 色情報をセットする
+     * 16進数で表された文字情報の色情報をセットする
      *
-     * Set color info
+     * Set color info (Hex string RGB or RGBA e.g., #123 or #11223300)
      * @param color - 色情報の文字列表現 / Information source in string
      */
     fromString(color: string): void;
@@ -513,43 +575,56 @@ declare interface IColor {
      * 色情報をセットする
      *
      * Set color info
-     * @param val - 色情報の数値表現 / Information source in number
+     * @param val - 色情報の数値表現 (32 bit ARGB または 24 bit RGB) / Information source in number (32 bit ARGB or 24 bit RGB)
      * @param withAlpha - 透明度付きか否か / Whether alpha value is included or not
      */
     fromNumber(val: number, withAlpha?: boolean): void;
 }
 
 /**
- * **IDataLoader**
- *
- * 読み込まれている音楽地図などの情報
+ * 読み込まれている音楽地図や歌詞などの情報にアクセスするためのインタフェース
  *
- * Current video materials
+ * This interface provides access to song map and lyrics information.
  * @public
  */
 declare interface IDataLoader extends ISongExplorer {
     /** TextAlive サービスのURL / TextAlive website url */
     readonly permalink: string;
-    /** 動画データ / Video data */
+    /**
+     * 動画データ / Video data
+     * @internal
+     */
     readonly video: VideoEntry;
     /** 楽曲情報 / Song info */
     readonly song: Song;
-    /** 楽曲の解析ステータス / Song analysis status */
+    /**
+     * 楽曲の解析ステータス / Song analysis status
+     * @internal
+     */
     readonly songStatus: SongStatus;
     /** 音楽地図情報 / Song map info */
     readonly songMap: ISongMap;
-    /** 歌詞の発声タイミング推定ID / Lyrics timing estimation ID */
+    /**
+     * 歌詞の発声タイミング推定ID / Lyrics timing estimation ID
+     * @deprecated Use {@link LyricsInfo.id} property instead
+     */
     readonly lyricsId: number;
     /** 歌詞の発声タイミング情報 / Lyrics timing info */
-    readonly lyrics: LyricsDiffInfo;
+    readonly lyrics: LyricsInfo;
     /** 歌詞の情報 / Lyrics info */
     readonly lyricsBody: LyricsBody;
-    /** 歌詞テキスト / Lyrics text */
+    /**
+     * 歌詞テキスト / Lyrics text
+     * @deprecated Use {@link LyricsBody.text} property instead
+     */
     readonly text: string;
     /** フォントの読み込みステータス / Font loading status */
     readonly fonts: IFontLoader;
 }
 
+/**
+ * @internal
+ */
 declare interface IEndpointManager extends EndpointData {
     songle: {
         protocol?: string;
@@ -560,6 +635,13 @@ declare interface IEndpointManager extends EndpointData {
         protocol: string;
         domain: string;
         server: string;
+        appToken?: string;
+        authUser?: string;
+        authToken?: string;
+    };
+    client: {
+        version: string;
+        axios?: any;
     };
 }
 
@@ -615,16 +697,24 @@ declare interface IFont {
     toString(scaleFactor?: number): string;
 }
 
+/**
+ * @internal
+ */
 declare interface IFontInfoManager {
     endpoint: string;
+    clearCache(): void;
     getFrequentChars(): Promise<string>;
-    listAvailableFonts(): Promise<FontInfo[]>;
+    listAvailableFonts(options?: ListAvailableFontsOptions): Promise<FontInfo[]>;
 }
 
 /**
  * @public
  */
 declare interface IFontLoader {
+    /**
+     * プライベートフォントを対象に含めるかどうか / Whether private fonts are included
+     */
+    isPrivateFontEnabled: boolean;
     /**
      * 読み込みに失敗したフォントの一覧 / List of fonts failed to load
      */
@@ -658,6 +748,7 @@ declare interface IFontLoader {
      * Load all required fonts to render the specified video data
      * @param json - 動画データ / Video data
      * @returns 読み込まれたフォントの一覧 / List of loaded fonts
+     * @internal
      */
     loadForVideo(json: VideoData): Promise<FontInfo[]>;
     /**
@@ -666,36 +757,36 @@ declare interface IFontLoader {
      * List up required fonts to render the specified video data
      * @param json - 動画データ / Video data
      * @returns フォント名の一覧 / List of font family names
+     * @internal
      */
     listFontFamiliesInVideo(json: VideoData): string[];
     /**
      * 利用可能なフォントの一覧を取得する
      *
      * List up all available fonts
+     * @param options - オプション / Options
      * @returns フォントの一覧 / List of fonts
+     * @internal
      */
-    listAvailableFonts(): Promise<FontInfo[]>;
+    listAvailableFonts(options?: ListAvailableFontsOptions): Promise<FontInfo[]>;
 }
 
 /**
- * @public
+ * グラフィック / Graphic
+ * @internal
  */
 declare interface IGraphic extends IRenderingUnit {
-    /**
-     * @inheritDoc
-     */
-    animate: RenderingUnitFunction<IGraphic>;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly previous: IGraphic;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly next: IGraphic;
 }
 
+/**
+ * @internal
+ */
 declare interface ILyricsBodyFetcher {
+    clearLyricBodyCache(): void;
     parseLyricBody(text: string, parserUrl: string): Promise<string>;
     fetchLyricBody(lyricUrl: string, options: {
         parserPath: string;
@@ -704,18 +795,31 @@ declare interface ILyricsBodyFetcher {
     fetchLocalLyricBody(lyricIdOrSongCode: number | string): Promise<LyricsBody>;
 }
 
+/**
+ * @internal
+ */
 declare interface ILyricsDiffManager {
     loadDiffs(songCode: string, lyricsId: number): Promise<LyricsDiffs>;
     loadDiff(songCode: string, lyricsId: number, diffId: number): Promise<LyricsDiffInfo>;
 }
 
+/**
+ * @internal
+ */
 declare interface ILyricsLoader {
+    clearCache(): void;
     load(songCode: string): Promise<SongleLyrics>;
     loadDetail(songCode: string, lyricsId: number): Promise<LyricsInfo>;
 }
 
+/**
+ * @internal
+ */
 declare type ILyricsPlayer = ILyricsURLManager & ILyricsDiffManager & ILyricsBodyFetcher & ILyricsLoader;
 
+/**
+ * @internal
+ */
 declare interface ILyricsURLManager {
     isUploaderUrl(url: string): boolean;
     parseUploaderUrl(url: string): {
@@ -775,8 +879,10 @@ declare interface IMatrix2D {
      * Generates matrix properties from the specified display object transform properties, and appends them to this matrix.
      * For example, you can use this to generate a matrix representing the transformations of a display object:
      *
+     * ```
      * 	var mtx = new createjs.Matrix2D();
      * 	mtx.appendTransform(o.x, o.y, o.scaleX, o.scaleY, o.rotation);
+     * ```
      * @param x
      * @param y
      * @param scaleX
@@ -845,12 +951,14 @@ declare interface IMatrix2D {
      * This is the equivalent of multiplying `(specified matrix) * (this matrix)`.
      * For example, you could calculate the combined transformation for a child object using:
      *
+     * ```
      * 	var o = myDisplayObject;
      * 	var mtx = o.getMatrix();
      * 	while (o = o.parent) {
      * 		// prepend each parent's transformation in turn:
      * 		o.prependMatrix(o.getMatrix());
      * 	}
+     * ```
      * @param matrix
      * @returns This matrix. Useful for chaining method calls.
      */
@@ -859,15 +967,14 @@ declare interface IMatrix2D {
      * Generates matrix properties from the specified display object transform properties, and prepends them to this matrix.
      * For example, you could calculate the combined transformation for a child object using:
      *
-     * 	var o = myDisplayObject;
-     * 	var mtx = new createjs.Matrix2D();
-     * 	do  {
-     * 		// prepend each parent's transformation in turn:
-     * 		mtx.prependTransform(o.x, o.y, o.scaleX, o.scaleY, o.rotation, o.skewX, o.skewY, o.regX, o.regY);
-     * 	} while (o = o.parent);
-     *
-     * 	Note that the above example would not account for {@link https://www.createjs.com/docs/easeljs/classes/DisplayObject.html#property_transformMatrix}
-     * 	values. See {@link IMatrix2D.prependMatrix} for an example that does.
+     * ```
+     *  var o = myDisplayObject;
+     *  var mtx = new createjs.Matrix2D();
+     *  do  {
+     *  	// prepend each parent's transformation in turn:
+     *  	mtx.prependTransform(o.x, o.y, o.scaleX, o.scaleY, o.rotation, o.skewX, o.skewY, o.regX, o.regY);
+     *  } while (o = o.parent);
+     * ```
      * @param x
      * @param y
      * @param scaleX
@@ -934,24 +1041,15 @@ declare interface IMatrix2D {
 }
 
 /**
+ * フレーズ / Phrase
  * @public
  */
 declare interface IPhrase extends ITextUnit {
-    /**
-     * @inheritDoc
-     */
-    animate: RenderingUnitFunction<IPhrase>;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly children: IWord[];
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly previous: IPhrase;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly next: IPhrase;
     readonly wordCount: number;
     readonly charCount: number;
@@ -965,9 +1063,9 @@ declare interface IPhrase extends ITextUnit {
 /**
  * **IPlayer**
  *
- * TextAlive のプレイヤーが実装するインタフェースです。
+ * Player の機能を抽象化したインタフェースです。
  *
- * TextAlive Player implements this interface.
+ * This interface provides abstraction of the Player features.
  * @public
  */
 declare interface IPlayer {
@@ -978,15 +1076,15 @@ declare interface IPlayer {
      */
     readonly options: PlayerOptions;
     /**
-     * TextAlive アプリの状態
+     * リリックアプリの状態
      *
-     * TextAlive app status
+     * Lyric app status
      */
     readonly app: IPlayerApp;
     /**
-     * 読み込まれている音楽地図などの情報
+     * 読み込み済みの音楽地図など楽曲に関する情報
      *
-     * Current video materials
+     * Current song map and other information related to the musical piece
      */
     readonly data: IDataLoader;
     /**
@@ -1034,6 +1132,8 @@ declare interface IPlayer {
      * 音源メディアの配置先となるDOM要素
      *
      * Media element
+     *
+     * @see {@link IPlayer.banner}
      */
     mediaElement: HTMLElement;
     /**
@@ -1173,13 +1273,13 @@ declare interface IPlayer {
      */
     readonly isVideoSeeking: boolean;
     /**
-     * TextAlive Player の情報を表示する `IPlayerBanner` インスタンスです。
+     * Player の情報を表示する `IPlayerBanner` インスタンスです。
      *
      * A banner instance that shows the player info.
      */
     readonly banner: IPlayerBanner;
     /**
-     * TextAlive Player の音源の再生状態を管理する `Timer` インスタンスです。
+     * Player の音源の再生状態を管理する `Timer` インスタンスです。
      *
      * A timer instance that controls the player status.
      */
@@ -1298,7 +1398,7 @@ declare interface IPlayer {
      * Get chorus parts in the current song
      *
      * @see {@link IDataLoader.getChoruses}
-     * @returns サビ情報（見つからなければ空の配列）
+     * @returns サビ情報（見つからなければ空の配列） / Chorus parts (empty array if not found)
      */
     getChoruses(): IRepetitiveSegment[];
     /**
@@ -1308,21 +1408,32 @@ declare interface IPlayer {
      *
      * @see {@link IDataLoader.findChorus}
      * @param time - 位置 [ms] / Position [ms]
-     * @param options - optional parameters for finding a chorus part
-     * @returns サビ情報（見つからなければ `null`）
+     * @param options - 取得オプション / Optional parameters for finding a chorus part
+     * @returns サビ情報（見つからなければ `null`） / Chorus part info (`null` if not found)
      */
     findChorus(time: number, options?: PlayerFindOptions): IRepetitiveSegment;
     /**
      * @deprecated Use of {@link IPlayer.findChorusBetween} is deprecated - find a chorus part with {@link IPlayer.findChorus} instead.
      */
     findChorusBetween(startTime: number, endTime: number): IRepetitiveSegment;
+    /**
+     * 指定された時区間のサビ情報の変化を取得する
+     *
+     * Look for chorus part transitions in the specified time range
+     *
+     * @see {@link IDataLoader.findChorusChange}
+     * @param startTime - 時区間の開始位置 [ms] / Start position [ms]
+     * @param endTime - 時区間の終了位置 [ms] / End position [ms]
+     * @returns サビ情報の変化 / Chorus part transitions
+     */
+    findChorusChange(startTime: number, endTime: number): TimedObjectsInRange<IRepetitiveSegment>;
     /**
      * 楽曲中のビートに関する情報を取得する
      *
      * Get beats in the current song
      *
      * @see {@link IDataLoader.getBeats}
-     * @returns ビート情報（見つからなければ空の配列）
+     * @returns ビート情報（見つからなければ空の配列） / Beats (empty array if not found)
      */
     getBeats(): IBeat[];
     /**
@@ -1332,17 +1443,28 @@ declare interface IPlayer {
      *
      * @see {@link IDataLoader.findBeat}
      * @param time - 位置 [ms] / Position [ms]
-     * @param options - 探索オプション / Optional parameters for finding beat
-     * @returns ビート情報（見つからなければ `null`）
+     * @param options - 取得オプション / Optional parameters for finding beat
+     * @returns ビート情報（見つからなければ `null`） / Beat info (`null` if not found)
      */
     findBeat(time: number, options?: PlayerFindOptions): IBeat;
+    /**
+     * 指定された時区間のビート情報の変化を取得する
+     *
+     * Look for beat transitions in the specified time range
+     *
+     * @see {@link IDataLoader.findBeatChange}
+     * @param startTime - 時区間の開始位置 [ms] / Start position [ms]
+     * @param endTime - 時区間の終了位置 [ms] / End position [ms]
+     * @returns ビート情報の変化 / Beat transitions
+     */
+    findBeatChange(startTime: number, endTime: number): TimedObjectsInRange<IBeat>;
     /**
      * 楽曲中のコード進行に関する情報を取得する
      *
      * Get chord info in the current song
      *
      * @see {@link IDataLoader.getChords}
-     * @returns コード進行の情報（見つからなければ空の配列）
+     * @returns コード進行の情報（見つからなければ空の配列） / Chord info (empty array if not found)
      */
     getChords(): IChord[];
     /**
@@ -1353,18 +1475,29 @@ declare interface IPlayer {
      * @see {@link IDataLoader.findChord}
      * @param time - 位置 [ms] / Position [ms]
      * @param options - 探索オプション / Optional parameters for finding chord
-     * @returns コード進行（見つからなければ `null`）
+     * @returns コード進行（見つからなければ `null`） / Chord info (`null` if not found)
      */
     findChord(time: number, options?: PlayerFindOptions): IChord;
+    /**
+     * 指定された時区間のコード進行の変化を取得する
+     *
+     * Look for chord progressions in the specified time range
+     *
+     * @see {@link IDataLoader.findChordChange}
+     * @param startTime - 時区間の開始位置 [ms] / Start position [ms]
+     * @param endTime - 時区間の終了位置 [ms] / End position [ms]
+     * @returns コード進行の変化 / Chord progressions
+     */
+    findChordChange(startTime: number, endTime: number): TimedObjectsInRange<IChord>;
     /**
      * 指定された位置の音高情報を取得する
      *
-     * - {@link PlayerOptions.vocalFrequencyEnabled} を `true` にセットしておく必要があります
+     * - 取得するには、あらかじめプレイヤー初期化オプション {@link PlayerOptions.vocalFrequencyEnabled} を `true` にセットしておく必要があります
      * - 今後、仕様変更の可能性があります
      *
      * Get vocal frequency at the specified timing
      *
-     * - {@link PlayerOptions.vocalFrequencyEnabled} needs to be `true`
+     * - Constructor option {@link PlayerOptions.vocalFrequencyEnabled} needs to be `true`
      * - This API is subject to change in the future
      *
      * @see {@link IDataLoader.getVocalFrequency}
@@ -1376,8 +1509,14 @@ declare interface IPlayer {
     /**
      * 指定された位置の声量を取得する
      *
+     * - 取得するには、あらかじめプレイヤー初期化オプション {@link PlayerOptions.vocalAmplitudeEnabled} を `true` にセットしておく必要があります
+     * - 返値は 0 以上 {@link IPlayer.getMaxVocalAmplitude} で取得できる最大値以下の値
+     *
      * Get vocal amplitude at the specified timing
      *
+     * - Constructor option {@link PlayerOptions.vocalAmplitudeEnabled} needs to be `true`
+     * - Return value ranges from 0 to the maximum value that can be retrieved by {@link IPlayer.getMaxVocalAmplitude}
+     *
      * @see {@link IDataLoader.getVocalAmplitude}
      * @param time - 位置 [ms] / Position [ms]
      * @returns 声量
@@ -1386,8 +1525,12 @@ declare interface IPlayer {
     /**
      * 楽曲中の最大声量を取得する
      *
+     * - 取得するには、あらかじめプレイヤー初期化オプション {@link PlayerOptions.vocalAmplitudeEnabled} を `true` にセットしておく必要があります
+     *
      * Get maximum vocal amplitude
      *
+     * - Constructor option {@link PlayerOptions.vocalAmplitudeEnabled} needs to be `true`
+     *
      * @see {@link IDataLoader.getMaxVocalAmplitude}
      * @returns 最大声量
      */
@@ -1395,8 +1538,12 @@ declare interface IPlayer {
     /**
      * 指定された位置のV/A空間中の座標を取得する
      *
+     * - 取得するには、あらかじめプレイヤー初期化オプション {@link PlayerOptions.valenceArousalEnabled} を `true` にセットしておく必要があります
+     *
      * Get valence arousal value at the specified timing
      *
+     * - Constructor option {@link PlayerOptions.valenceArousalEnabled} needs to be `true`
+     *
      * @see {@link IDataLoader.getValenceArousal}
      * @param time - 位置 [ms] / Position [ms]
      * @returns 座標値
@@ -1405,8 +1552,12 @@ declare interface IPlayer {
     /**
      * V/A空間中の座標遷移の中央値を取得する
      *
+     * - 取得するには、あらかじめプレイヤー初期化オプション {@link PlayerOptions.valenceArousalEnabled} を `true` にセットしておく必要があります
+     *
      * Get median valence arousal value throughout the song
      *
+     * - Constructor option {@link PlayerOptions.valenceArousalEnabled} needs to be `true`
+     *
      * @see {@link IDataLoader.getMedianValenceArousal}
      * @returns 座標値
      */
@@ -1510,18 +1661,42 @@ declare interface IPlayer {
 }
 
 /**
- * TextAlive アプリの情報
+ * リリックアプリの情報
  *
- * TextAlive app information
+ * Lyric app information
  * @public
  */
 declare interface IPlayerApp {
     /**
-     * TextAlive アプリのオプション
+     * リリックアプリのオプション
      *
-     * TextAlive app options
+     * Lyric app options
      */
     readonly options: PlayerAppOptions;
+    /**
+     * アプリの名前
+     *
+     * Name of this application
+     */
+    name: string;
+    /**
+     * アプリ作者の名前
+     *
+     * Name of the author of this application
+     */
+    author: string;
+    /**
+     * アプリの状態
+     *
+     * Status of this application
+     */
+    status: number;
+    /**
+     * TextAlive API サーバの情報
+     *
+     * TextAlive server info
+     */
+    readonly server: PlayerAppServer;
     /**
      * TextAlive のホストに接続されているか否か
      *
@@ -1535,13 +1710,19 @@ declare interface IPlayerApp {
      */
     readonly host: PlayerAppHost;
     /**
-     * クエリパラメタなどによりホストから指定されている再生対象の楽曲URL
+     * クエリパラメタまたはTextAliveホストにより指定されている再生対象の楽曲URL
+     *
+     * - アプリは起動時にクエリパラメタを調べ、楽曲が指定されていれば自動的に {@link IPlayer.createFromSongUrl} で楽曲情報の読み込みを開始します（ホストに接続されていても、クエリパラメタによる指定がなければ空になります）
+     * - アプリがTextAliveホストに接続されると、ホストの指示により楽曲が上書きされることがあります（この後に {@link PlayerAppListener.onAppMediaChange} イベントが呼ばれます）
      *
      * Song url specified by the query parameter or updated by the media message
+     *
+     * - During the initialization of this app, it automatically looks for the song URL in the query parameter. When the song URL is specified, it loads the song by calling {@link IPlayer.createFromSongUrl}.
+     * - When the app is connected to a host, the host might overwrite the song URL, resulting in the {@link PlayerAppListener.onAppMediaChange} event.
      */
     readonly songUrl: string;
     /**
-     * クエリパラメタなどによりホストから指定されている楽曲データの読み込みオプション
+     * クエリパラメタまたはTextAliveホストにより指定されている楽曲データの読み込みオプション
      *
      * Options to load song data specified by the query parameter or updated by the media message
      */
@@ -1555,7 +1736,7 @@ declare interface IPlayerApp {
     /**
      * ホストへの接続中か否か
      *
-     * Whether the player is connecting to a host
+     * Whether the player is trying to connect to a host
      */
     readonly isConnecting: boolean;
     /**
@@ -1574,6 +1755,24 @@ declare interface IPlayerApp {
     connect(): Promise<boolean>;
 }
 
+/**
+ * **IPlayerBanner**
+ *
+ * Player の情報を表示する `IPlayerBanner` インスタンスです。Webブラウザで実行されると以下のようなDOM要素が生成されます。
+ *
+ * - CSSクラス `textalive-banner` を持つ {@link IPlayer.mediaElement} の子要素になります
+ * - TextAliveサービスサイトへのリンクになっているアイコンを子要素に持ちます
+ * - 楽曲配信元へのリンクになっているCSSクラス `song` を持つアンカーを子要素に持ちます
+ * - 歌詞配信元へのリンクになっているCSSクラス `lyrics` を持つアンカーを子要素に持ちます
+ *
+ * A banner instance that shows the player info. When executed in a web browser, the banner is shown as a DOM element with the following conditions.
+ *
+ * - The banner is shown as a child element of {@link IPlayer.mediaElement} with the CSS class `textalive-banner`
+ * - The banner contains an icon link to the TextAlive website
+ * - The banner contains an anchor to the song URL with the CSS class `song`
+ * - The banner also contains an anchor to the lyrics URL with the CSS class `lyrics`
+ * @public
+ */
 declare interface IPlayerBanner {
     readonly domEnabled: boolean;
     position: PlayerBannerPosition;
@@ -1588,7 +1787,7 @@ declare interface IPlayerBanner {
  * TextAlive の各種APIアクセスを司るマネージャのコレクションです。
  *
  * TextAlive manager instances.
- * @public
+ * @internal
  */
 declare interface IPlayerManagers {
     asset?: IBackgroundPlayer;
@@ -1660,12 +1859,6 @@ declare interface IPoint {
  * @public
  */
 declare interface IRenderingUnit extends TimedObject {
-    /**
-     * このプロパティに関数が定義されているとき、 TextAlive の通常動作（割り当て済みテンプレートの `animate` 関数を呼ぶ）はスキップされ、この関数が呼ばれる
-     *
-     * When `animate` function is defined, TextAlive default behavior (call `animate` functions of all assigned template instances) is suppressed and this function is called instead
-     */
-    animate: RenderingUnitFunction<IRenderingUnit>;
     readonly parent: IRenderingUnit;
     readonly children: IRenderingUnit[];
     readonly previous: IRenderingUnit;
@@ -1688,6 +1881,12 @@ declare interface IRenderingUnit extends TimedObject {
      * @internal
      */
     readonly templateCount: number;
+    /**
+     * このプロパティに関数が定義されているとき、 TextAlive の通常動作（割り当て済みテンプレートの `animate` 関数を呼ぶ）はスキップされ、この関数が呼ばれる
+     *
+     * When `animate` function is defined, TextAlive default behavior (call `animate` functions of all assigned template instances) is suppressed and this function is called instead
+     */
+    animate: RenderingUnitFunction;
     /**
      * 指定された楽曲中の位置をこの描画ユニット中の位置 `[0, 1]` にマッピングして返す
      *
@@ -1769,12 +1968,18 @@ export declare function isJa(profile?: {
     language?: string;
 }): boolean;
 
+/**
+ * 読み込まれている音楽地図の情報にアクセスするためのインタフェース
+ *
+ * This interface provides access to song map information etc.
+ * @public
+ */
 declare interface ISongExplorer {
     /**
      * 楽曲中のサビに関する情報を取得する
      *
      * Get chorus parts in the current song
-     * @returns サビ情報（見つからなければ空の配列）
+     * @returns サビ情報（見つからなければ空の配列） / Chorus parts (empty array if not found)
      */
     getChoruses(): IRepetitiveSegment[];
     /**
@@ -1782,19 +1987,29 @@ declare interface ISongExplorer {
      *
      * Find a chorus part that overlaps with the specified timing
      * @param time - 位置 [ms] / Position [ms]
-     * @param options - optional parameters for finding a chorus part
-     * @returns サビ情報（見つからなければ `null`）
+     * @param options - 取得オプション / Optional parameters for finding a chorus part
+     * @returns サビ情報（見つからなければ `null`） / Chorus part info (`null` if not found)
      */
     findChorus(time: number, options?: PlayerFindOptions): IRepetitiveSegment;
     /**
      * @deprecated Use of {@link ISongExplorer.findChorusBetween} is deprecated - find a chorus part with {@link ISongExplorer.findChorus} instead.
      */
     findChorusBetween(startTime: number, endTime: number): IRepetitiveSegment;
+    /**
+     * 指定された時区間のサビ情報の変化を取得する
+     *
+     * Look for chorus part transitions in the specified time range
+     *
+     * @param startTime - 時区間の開始位置 [ms] / Start position [ms]
+     * @param endTime - 時区間の終了位置 [ms] / End position [ms]
+     * @returns サビ情報の変化 / Chorus part transitions
+     */
+    findChorusChange(startTime: number, endTime: number): TimedObjectsInRange<IRepetitiveSegment>;
     /**
      * 楽曲中のビートに関する情報を取得する
      *
      * Get beats in the current song
-     * @returns ビート情報（見つからなければ空の配列）
+     * @returns ビート情報（見つからなければ空の配列） / Beats (empty array if not found)
      */
     getBeats(): IBeat[];
     /**
@@ -1802,15 +2017,25 @@ declare interface ISongExplorer {
      *
      * Find beat that overlaps with the specified timing
      * @param time - 位置 [ms] / Position [ms]
-     * @param options - 探索オプション / Optional parameters for finding beat
-     * @returns ビート情報（見つからなければ `null`）
+     * @param options - 取得オプション / Optional parameters for finding beat
+     * @returns ビート情報（見つからなければ `null`） / Beat info (`null` if not found)
      */
     findBeat(time: number, options?: PlayerFindOptions): IBeat;
+    /**
+     * 指定された時区間のビート情報の変化を取得する
+     *
+     * Look for beat transitions in the specified time range
+     *
+     * @param startTime - 時区間の開始位置 [ms] / Start position [ms]
+     * @param endTime - 時区間の終了位置 [ms] / End position [ms]
+     * @returns ビート情報の変化 / Beat transitions
+     */
+    findBeatChange(startTime: number, endTime: number): TimedObjectsInRange<IBeat>;
     /**
      * 楽曲中のコード進行に関する情報を取得する
      *
      * Get chord info in the current song
-     * @returns コード進行の情報（見つからなければ空の配列）
+     * @returns コード進行の情報（見つからなければ空の配列） / Chord info (empty array if not found)
      */
     getChords(): IChord[];
     /**
@@ -1818,20 +2043,27 @@ declare interface ISongExplorer {
      *
      * Find chord that overlaps with the specified timing
      * @param time - 位置 [ms] / Position [ms]
-     * @param options - 探索オプション / Optional parameters for finding chord
-     * @returns コード進行（見つからなければ `null`）
+     * @param options - 探索オプション / Optional parameters for finding a chord
+     * @returns コード進行（見つからなければ `null`） / Chord info (`null` if not found)
      */
     findChord(time: number, options?: PlayerFindOptions): IChord;
     /**
-     * 指定された位置の音高情報を取得する
+     * 指定された時区間のコード進行の変化を取得する
      *
-     * - {@link PlayerOptions.vocalFrequencyEnabled} を `true` にセットしておく必要があります
-     * - 今後、仕様変更の可能性があります
+     * Look for chord progressions in the specified time range
+     *
+     * @param startTime - 時区間の開始位置 [ms] / Start position [ms]
+     * @param endTime - 時区間の終了位置 [ms] / End position [ms]
+     * @returns コード進行の変化 / Chord progressions
+     */
+    findChordChange(startTime: number, endTime: number): TimedObjectsInRange<IChord>;
+    /**
+     * 指定された位置の音高情報を取得する
      *
      * Get vocal frequency at the specified timing
      *
-     * - {@link PlayerOptions.vocalFrequencyEnabled} needs to be `true`
-     * - This API is subject to change in the future
+     * - このメソッドを使うには {@link Player} の初期化オプション（{@link PlayerOptions#vocalFrequencyEnabled} を `true` にする必要があります（今後、仕様変更の可能性があります）
+     * - To use this method, {@link Player} constructor option {@link PlayerOptions#vocalFrequencyEnabled} needs to be `true` (this API is subject to change in the future)
      *
      * @param time - 位置 [ms] / Position [ms]
      * @returns 音高情報
@@ -1842,39 +2074,65 @@ declare interface ISongExplorer {
      * 指定された位置の声量を取得する
      *
      * Get vocal amplitude at the specified timing
+     *
+     * - このメソッドを使うには {@link Player} の初期化オプション（{@link PlayerOptions#vocalAmplitudeEnabled} を `true` にする必要があります
+     * - To use this method, {@link Player} constructor option {@link PlayerOptions#vocalAmplitudeEnabled} needs to be `true`
+     *
      * @param time - 位置 [ms] / Position [ms]
      * @returns 声量
+     * @see {@link PlayerOptions}
      */
     getVocalAmplitude(time: number): number;
     /**
      * 楽曲中の最大声量を取得する
      *
      * Get maximum vocal amplitude
+     *
+     * - このメソッドを使うには {@link Player} の初期化オプション（{@link PlayerOptions#vocalAmplitudeEnabled} を `true` にする必要があります
+     * - To use this method, {@link Player} constructor option {@link PlayerOptions#vocalAmplitudeEnabled} needs to be `true`
+     *
      * @returns 最大声量
+     * @see {@link PlayerOptions}
      */
     getMaxVocalAmplitude(): number;
     /**
      * 指定された位置のV/A空間中の座標を取得する
      *
      * Get valence arousal value at the specified timing
+     *
+     * - このメソッドを使うには {@link Player} の初期化オプション（{@link PlayerOptions#valenceArousalEnabled} を `true` にする必要があります
+     * - To use this method, {@link Player} constructor option {@link PlayerOptions#valenceArousalEnabled} needs to be `true`
+     *
      * @param time - 位置 [ms] / Position [ms]
      * @returns 座標値
+     * @see {@link PlayerOptions}
      */
     getValenceArousal(time: number): ValenceArousalValue;
     /**
      * V/A空間中の座標遷移の中央値を取得する
      *
      * Get median valence arousal value throughout the song
+     *
+     * - このメソッドを使うには {@link Player} の初期化オプション（{@link PlayerOptions#valenceArousalEnabled} を `true` にする必要があります
+     * - To use this method, {@link Player} constructor option {@link PlayerOptions#valenceArousalEnabled} needs to be `true`
+     *
      * @returns 座標値
+     * @see {@link PlayerOptions}
      */
     getMedianValenceArousal(): ValenceArousalValue;
 }
 
+/**
+ * @internal
+ */
 declare interface ISongInfoLoader {
     loadVocalAmplitude(identifier: number | string): Promise<VocalAmplitude>;
     loadValenceArousal(identifier: number | string): Promise<ValenceArousal>;
 }
 
+/**
+ * @internal
+ */
 declare interface ISongLoader {
     load(q: {
         id?: number;
@@ -1940,14 +2198,21 @@ declare interface ISongMap {
     };
 }
 
+/**
+ * @internal
+ */
 declare type ISongPlayer = ISongURLManager & ISongLoader & ISongInfoLoader;
 
+/**
+ * @internal
+ */
 declare interface ISongURLManager {
     getSongPathFromUrl(url: string): string;
     isUploaderUrl(url: string): boolean;
     isUploaderPath(path: string): boolean;
     getUploaderGuid(path: string): string;
     getSongUrlFromUploaderGuid(guid: string): string;
+    getAltSongUrlFromUploaderGuid(guid: string): string;
     getSongUrlFromPath(path: string): string;
     isYouTubeUrl(url: string): boolean;
     isNicovideoUrl(url: string): boolean;
@@ -1955,6 +2220,9 @@ declare interface ISongURLManager {
     isPiaproUrl(url: string): boolean;
 }
 
+/**
+ * @internal
+ */
 declare interface ITemplate {
     templateClass: ITemplateClass;
     templateInstance: any;
@@ -1963,68 +2231,267 @@ declare interface ITemplate {
     assignedUnit: IRenderingUnit;
 }
 
+/**
+ * @internal
+ */
 declare interface ITemplateClass {
     className: string;
     id: number;
     script: string;
 }
 
+/**
+ * @internal
+ */
 declare interface ITemplateInfoManager {
     create(request: TemplateCreateRequest): Promise<TemplateCreateResponse>;
     listContributors(className: string, templateId: number): Promise<UserEntry[]>;
 }
 
-declare interface ITemplateInterpreter {
+/**
+ * Template interpreter
+ *
+ * @internal
+ */
+declare interface ITemplateInterpreter {
+    /**
+     * Emit verbose output to console
+     * @internal
+     */
     verbose: boolean;
+    /**
+     * Ignore versions when checking dependencies for templates
+     * @internal
+     */
+    ignoreVersion: boolean;
+    /**
+     * Print raw interpreter objects when emitting output to console
+     * @internal
+     */
+    rawConsole: boolean;
+    /**
+     * Whether this interpreter is initialized or not
+     * @internal
+     */
     readonly ready: boolean;
+    /**
+     * Loaded templates
+     * @internal
+     */
     readonly loaded: {
         [s: string]: ITemplateClass;
     };
+    /**
+     * Get template by ID
+     *
+     * @param id Template version ID
+     * @internal
+     */
     getById(id: number): ITemplateClass;
+    /**
+     * Get template by class name
+     *
+     * @param className Template class name (with optional `@` version specifier)
+     * @param ignoreVersion Ignore the version specifier even when specified
+     * @internal
+     */
     getByName(className: string, ignoreVersion?: boolean): ITemplateClass;
+    /**
+     * Load template by version ID
+     *
+     * @param id Template version ID
+     * @internal
+     */
     loadById(id: number): Promise<ITemplateClass>;
+    /**
+     * Load template by class name
+     *
+     * @see {@link ITemplateInterpreter.ignoreVersion}
+     * @param className Template class name (with optional `@` version specifier)
+     * @internal
+     */
     loadByName(className: string): Promise<ITemplateClass>;
+    /**
+     * Load templates by class names
+     *
+     * @see {@link ITemplateInterpreter.ignoreVersion}
+     * @param classNames Template class names (with optional `@` version specifiers)
+     * @internal
+     */
     loadByNames(classNames: string[]): Promise<ITemplateClass[]>;
+    /**
+     * Load templates required to render the specified video
+     *
+     * @see {@link ITemplateInterpreter.ignoreVersion}
+     * @param videoId Video ID
+     * @internal
+     */
     loadForVideo(videoId: number): Promise<ITemplateClass[]>;
-    register(model: TemplateEntry): Promise<ITemplateClass>;
+    /**
+     * Get list of template classes required in specified script
+     *
+     * @param script JavaScript text
+     * @internal
+     */
+    getRequiredTemplates(script: string): string[];
+    /**
+     * Get template class required in specified line of script
+     *
+     * @param script JavaScript text
+     * @param index Line of script (\>= 1)
+     * @internal
+     */
+    getRequiredTemplateAt(script: string, index: number): string;
+    /**
+     * Register template class to the interpreter
+     *
+     * 1. When model data (`TemplateEntry`) is provided, create template class first
+     * 2. Otherwise (`ITemplateClass` is provided), load dependencies and register it
+     *
+     * Use case 1. is intended for use with `TemplateManager` in `textalive-data-web` package
+     *
+     * @param model Template model data
+     * @internal
+     */
+    register(modelOrClass: TemplateEntry | ITemplateClass): Promise<ITemplateClass>;
+    /**
+     * Create template class from text script
+     *
+     * @param script JavaScript text
+     * @internal
+     */
     createClass(script: string): ITemplateClass;
+    /**
+     * Update template class with new text script
+     *
+     * @param oldClass Old template class to be updated
+     * @param script JavaScript text
+     * @internal
+     */
     updateClassScript(oldClass: ITemplateClass, script: string): ITemplateClass;
+    /**
+     * Commit template class with optional log text
+     *
+     * @param templateClass Template class
+     * @param log Log text
+     * @internal
+     */
     commit(templateClass: ITemplateClass, log?: string): Promise<TemplateCreateResponse>;
+    /**
+     * Export template instance (class name and parameters) as JSON data
+     *
+     * @param instance Template instance
+     * @internal
+     */
     exportInstance(instance: ITemplate): TemplateData;
+    /**
+     * Import template data and instantiate template
+     *
+     * @param data Template data
+     * @internal
+     */
     importInstance(data: TemplateData): ITemplate;
+    /**
+     * Import template data in video data, instantiate templates, and assign them to video object
+     *
+     * @param video Video object
+     * @param data Video data
+     * @internal
+     */
     importInstances(video: IVideo, data: VideoData): boolean;
+    /**
+     * Create template instance
+     *
+     * @param templateClass Template class
+     * @internal
+     */
     newInstance(templateClass: ITemplateClass): ITemplate;
+    /**
+     * Dispose template instance
+     *
+     * @param instance Template instance
+     * @internal
+     */
     disposeInstance(instance: ITemplate): void;
+    /**
+     * Dispose template instances
+     *
+     * @param instances Array of template instances or video object containing template instances
+     * @internal
+     */
     disposeInstances(instances: ITemplate[] | IVideo): void;
+    /**
+     * Set template instance of rendering unit
+     *
+     * @param unit Rendering unit
+     * @param template Template instance
+     * @internal
+     */
     setTemplate(unit: IRenderingUnit, template: ITemplate): void;
+    /**
+     * Clear templates assigned to rendering unit
+     *
+     * @param unit Rendering unit
+     * @internal
+     */
     clearTemplate(unit: IRenderingUnit): void;
-    getRequiredTemplates(script: string): string[];
-    getRequiredTemplateAt(script: string, index: number): string;
+    /**
+     * Execute specific method in template instance
+     *
+     * @param template Template instance
+     * @param funcName Method name
+     * @param parameters Parameter values
+     * @returns Return value of method invocation
+     * @internal
+     */
     exec(template: ITemplate, funcName: string, parameters: ParameterValue[]): any;
+    /**
+     * Set property of template instance
+     * @param instance Template instance
+     * @param name Property name
+     * @param value Property value
+     * @internal
+     */
     setProperty(instance: ITemplate, name: string, value: ParameterValue): void;
+    /**
+     * Get property of template instance
+     * @param instance Template instance
+     * @param name Property name
+     * @returns Property value
+     * @internal
+     */
     getProperty(instance: ITemplate, name: string): ParameterValue;
 }
 
+/**
+ * @internal
+ */
 declare interface ITemplateLoader {
     list(options?: TemplateListRequest): Promise<TemplateListResponse>;
     load(templateId: number): Promise<TemplateEntry>;
     loadByName(templateName: string): Promise<TemplateEntry>;
-    loadForVideo(videoId: number, params?: {
-        withoutAuthors: boolean;
-        withScript: boolean;
-    }): Promise<TemplateList>;
+    loadForVideo(videoId: number, options?: TemplateListForVideoRequest): Promise<TemplateListResponse>;
 }
 
+/**
+ * @internal
+ */
 declare type ITemplateManager = ITemplateLoader & ITemplateInfoManager;
 
+/**
+ * @internal
+ */
 declare interface ITextParser {
     parse(text: string): Promise<TextParsingResponse>;
 }
 
+/**
+ * @internal
+ */
 declare type ITextPlayer = ITextParser;
 
 /**
- *
+ * 文字ユニット / Text unit
  * @public
  */
 declare interface ITextUnit extends IRenderingUnit {
@@ -2070,16 +2537,25 @@ declare interface ITextUnit extends IRenderingUnit {
     readonly height: number;
 }
 
+/**
+ * @internal
+ */
 declare interface IUserActionManager {
+    getServerStatus(): Promise<ServerStatus>;
+    doGetServerStatus(): Promise<ServerStatus>;
     getProfile(): Promise<UserProfile>;
     doGetProfile(): Promise<UserProfile>;
     getToken(): Promise<string>;
     doGetToken(): Promise<string>;
     getMergingUsers(): Promise<UserEntry[]>;
     mergeUsers(): Promise<UserEntry>;
+    updateUser(entry: UserUpdateRequest): Promise<UserEntry>;
     authenticate(userId: number, password: string): Promise<UserProfile>;
 }
 
+/**
+ * @internal
+ */
 declare interface IUserBrowserActionManager {
     loginTwitter(ev?: MouseEvent): false;
     loginGitHub(ev?: MouseEvent): false;
@@ -2095,6 +2571,9 @@ declare interface IUserBrowserActionManager {
     logout(ev?: MouseEvent, provider?: AccountService): false;
 }
 
+/**
+ * @internal
+ */
 declare interface IUserEventManager {
     readonly userProfile: UserProfile;
     isLoading(): boolean;
@@ -2102,13 +2581,29 @@ declare interface IUserEventManager {
     removeListener(listener: UserListener): void;
 }
 
+/**
+ * @internal
+ */
 declare type IUserManager = IUserTypeManager & IUserActionManager & IUserBrowserActionManager & IUserSpoofingManager & IUserEventManager;
 
+/**
+ * @deprecated Use {@link EndpointManager.textalive.authUser} and {@link EndpointManager.textalive.authToken} properties instead
+ * @internal
+ */
 declare interface IUserSpoofingManager {
+    /**
+     * @deprecated Use {@link EndpointManager.textalive.authUser} and {@link EndpointManager.textalive.authToken} properties instead
+     */
     spoof(userProfile: UserProfile): void;
+    /**
+     * @deprecated Use {@link EndpointManager.textalive.authUser} and {@link EndpointManager.textalive.authToken} properties instead
+     */
     isSpoofingSongleUser(profile: UserProfile): boolean;
 }
 
+/**
+ * @internal
+ */
 declare interface IUserTypeManager {
     isYouTubeUser(profile: UserProfile): boolean;
     isPiaproUser(profile: UserProfile): boolean;
@@ -2116,32 +2611,44 @@ declare interface IUserTypeManager {
 }
 
 /**
- * 動画（{@link IRenderingUnit} を格納する入れ物）
+ * 動画（描画ユニット {@link IRenderingUnit} を格納する入れ物）
  *
  * Video (A container for {@link IRenderingUnit} objects)
  * @public
  */
 declare interface IVideo extends TimedObject {
+    /** @internal */
+    readonly credits: IPhrase[];
     readonly phrases: IPhrase[];
+    readonly words: IWord[];
+    readonly chars: IChar[];
+    /** @internal */
     readonly graphics: IGraphic[];
-    /**
-     * @internal
-     */
+    /** @internal */
     readonly rendering: RenderingParameter;
     duration: number;
     readonly startTime: number;
     readonly endTime: number;
+    /** @internal */
+    readonly creditCount: number;
     readonly phraseCount: number;
+    /** @internal */
     readonly graphicCount: number;
     readonly wordCount: number;
     readonly charCount: number;
+    /** @internal */
+    readonly firstCredit: IPhrase;
     readonly firstPhrase: IPhrase;
     readonly firstWord: IWord;
     readonly firstChar: IChar;
+    /** @internal */
     readonly firstGraphic: IGraphic;
+    /** @internal */
+    readonly lastCredit: IPhrase;
     readonly lastPhrase: IPhrase;
     readonly lastWord: IWord;
     readonly lastChar: IChar;
+    /** @internal */
     readonly lastGraphic: IGraphic;
     /**
      * 指定された位置を `[0, 1]` にマッピングして返す
@@ -2150,41 +2657,105 @@ declare interface IVideo extends TimedObject {
      * @param time - 位置 / Position in this video
      */
     progress(time: number): number;
+    /**
+     * @internal
+     */
+    getCredit(index: number): IPhrase;
+    /**
+     * 指定したインデックスのフレーズを取得する / Get phrase with the specified index
+     * @param index フレーズのインデックス / Phrase index
+     */
     getPhrase(index: number): IPhrase;
+    /**
+     * 指定したインデックスの単語を取得する / Get word with the specified index
+     * @param index 単語のインデックス / Word index
+     */
     getWord(index: number): IWord;
+    /**
+     * 指定したインデックスの文字を取得する / Get character with the specified index
+     * @param index 文字のインデックス / Phrase index
+     */
     getChar(index: number): IChar;
+    /**
+     * @internal
+     */
     getGraphic(index: number): IGraphic;
+    /**
+     * 指定した描画オブジェクトのインデックスを取得する / Get index of the specified rendering unit
+     * @param unit 描画オブジェクト / Rendering unit
+     * @returns インデックス / Index
+     */
     findIndex(unit: IRenderingUnit): number;
     /**
-     * Get phrase object in the current video
+     * Get phrase object (credits) in the current video
+     * @param time - position [ms]
+     * @param options - optional parameters for finding phrase
+     * @internal
+     */
+    findCredit(time: number, options?: FindTimedObjectOptions): IPhrase;
+    /**
+     * 指定した再生位置のフレーズを取得する / Get phrase object in the current video
      * @param time - position [ms]
      * @param options - optional parameters for finding phrase
      */
     findPhrase(time: number, options?: FindTimedObjectOptions): IPhrase;
     /**
-     * Get word object in the current video
+     * 指定された時区間のフレーズ発声情報を取得する
+     *
+     * Look for phrases in the specified time range
+     */
+    findPhraseChange(startTime: number, endTime: number): TimedObjectsInRange<IPhrase>;
+    /**
+     * 指定した再生位置の単語を取得する / Get word object in the current video
      * @param time - position [ms]
      * @param options - optional parameters for finding word
      */
     findWord(time: number, options?: FindTimedObjectOptions): IWord;
     /**
-     * Get character object in the current video
+     * 指定された時区間の単語発声情報を取得する
+     *
+     * Look for words in the specified time range
+     */
+    findWordChange(startTime: number, endTime: number): TimedObjectsInRange<IWord>;
+    /**
+     * 指定した再生位置の文字を取得する / Get character object in the current video
      * @param time - position [ms]
      * @param options - optional parameters for finding character
      */
     findChar(time: number, options?: FindTimedObjectOptions): IChar;
     /**
-     * Get graphic object in the current video
+     * 指定された時区間の文字発声情報を取得する
+     *
+     * Look for characters in the specified time range
+     */
+    findCharChange(startTime: number, endTime: number): TimedObjectsInRange<IChar>;
+    /**
+     * 指定した再生位置のグラフィックを取得する / Get graphic object in the current video
      * @param time - position [ms]
      * @param options - optional parameters for finding graphic
+     * @internal
      */
     findGraphic(time: number, options?: FindTimedObjectOptions): IGraphic;
+    /**
+     * 指定された時区間のグラフィック情報を取得する
+     *
+     * Look for graphics in the specified time range
+     * @internal
+     */
+    findGraphicChange(startTime: number, endTime: number): TimedObjectsInRange<IGraphic>;
 }
 
+/**
+ * @internal
+ */
 declare interface IVideoLoader {
+    list(options?: VideoListRequest): Promise<VideoListResponse>;
     load(videoId: number): Promise<VideoEntry>;
 }
 
+/**
+ * @internal
+ */
 declare type IVideoPlayer = IVideoLoader;
 
 /**
@@ -2216,28 +2787,17 @@ declare interface IVoice extends TimedObject {
 }
 
 /**
+ * 単語 / Word
  * @public
  */
 declare interface IWord extends ITextUnit {
-    /**
-     * @inheritDoc
-     */
-    animate: RenderingUnitFunction<IWord>;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly parent: IPhrase;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly children: IChar[];
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly previous: IWord;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     readonly next: IWord;
     /**
      * 品詞
@@ -2271,17 +2831,62 @@ declare interface IWord extends ITextUnit {
      * 言語（`en`: 英語、`ja`: 日本語）
      */
     readonly language: string;
+    /**
+     * カウントダウン（カウントダウンの場合は 0 以上の数値）
+     * @internal
+     */
+    readonly countDown: number;
+    /**
+     * カウントアップ（カウントアップの場合は 0 以上の数値）
+     * @internal
+     */
+    readonly countUp: number;
+    /**
+     * カウントダウン、カウントアップの初期値
+     * @internal
+     */
+    readonly initialCount: number;
     readonly charCount: number;
     readonly firstChar: IChar;
     readonly lastChar: IChar;
     findIndex(unit: IChar): number;
 }
 
+/**
+ * @internal
+ */
+declare interface ListAvailableFontsOptions {
+    isPrivateFontEnabled?: boolean;
+}
+
+/**
+ * @internal
+ */
+declare interface ListRequest extends ListSimpleRequest {
+    lastId?: number;
+    startId?: number;
+    maxResults?: number;
+}
+
+/**
+ * @internal
+ */
+declare interface ListResponse<T> extends ListSimpleResponse<T> {
+    nextStartId?: number;
+    nextLastId?: number;
+}
+
+/**
+ * @internal
+ */
 declare interface ListSimpleRequest {
     lastIndex?: number;
     startIndex?: number;
 }
 
+/**
+ * @internal
+ */
 declare interface ListSimpleResponse<T> {
     list: T[];
     nextStartIndex?: number;
@@ -2300,6 +2905,7 @@ declare type LoaderListener = DataLoaderListener & BackgroundGraphicsListener &
  * 歌詞発声タイミングの推定結果
  *
  * Results of lyrics timing estimation
+ * @internal
  */
 declare interface Lyrics {
     /** 歌詞発声タイミングの推定ID / Lyrics timing estimation ID */
@@ -2336,6 +2942,7 @@ declare interface LyricsBody {
  * 歌詞発声タイミングの訂正情報
  *
  * Lyrics diff information
+ * @internal
  */
 declare interface LyricsDiff {
     /** 歌詞発声タイミングの訂正ID / Lyrics diff ID */
@@ -2349,37 +2956,42 @@ declare interface LyricsDiff {
 }
 
 /**
- * 歌詞発声タイミングの詳細情報
+ * 歌詞発声タイミングの差分に関する情報
  *
  * Detailed lyrics diff information
- * @public
+ * @internal
  */
-declare interface LyricsDiffInfo {
+declare interface LyricsDiffInfo extends LyricsTimingInfo {
     /**
-     * 歌詞発声タイミングの訂正ID
-     *
-     * Lyrics diff ID
+     * Null if this points to the original lyrics, and otherwise undefined
      */
-    id: number;
+    diff?: null;
     /**
-     * 歌詞URL
+     * Songle で推定中か否か
      *
-     * Lyrics url
+     * Songle analysis processing status if this points to the original lyrics, and otherwise undefined
      */
-    url: string;
+    processing?: boolean;
     /**
-     * @see e.g. {@link http://songle.jp/songs/1299363/lyrics/48823/diffs/1279/lyrics.json}
-     * @internal
+     * Songle での推定が失敗したか否か
+     *
+     * Songle analysis failure status if this points to the original lyrics, and otherwise undefined
      */
-    data: LyricsTiming[][][];
+    failed?: boolean;
     /**
+     * 作成日時
+     *
+     * Created date if this points to the original lyrics, and otherwise undefined
      * @internal
      */
-    offset: number;
+    created_at?: string;
     /**
+     * 更新日時
+     *
+     * Updated date if this points to the original lyrics, and otherwise undefined
      * @internal
      */
-    parser_path: string;
+    updated_at?: string;
 }
 
 /**
@@ -2394,11 +3006,13 @@ declare type LyricsDiffs = LyricsDiff[];
  * 歌詞発声タイミングの推定結果
  *
  * Results of lyrics timing estimation
- *
- * e.g. https://songle.jp/songs/1247946/lyrics/48789.json
- * @internal
+ * @public
  */
-declare interface LyricsInfo extends LyricsDiffInfo {
+declare interface LyricsInfo extends LyricsTimingInfo {
+    /**
+     * 歌詞発声タイミングのID
+     */
+    id: number;
     /**
      * 歌詞発声タイミングの訂正情報
      *
@@ -2412,32 +3026,73 @@ declare interface LyricsInfo extends LyricsDiffInfo {
      *
      * Songle analysis processing status
      */
-    processing: boolean;
+    processing?: boolean;
     /**
      * Songle での推定が失敗したか否か
      *
      * Songle analysis failure status
      */
-    failed: boolean;
+    failed?: boolean;
     /**
      * 作成日時
      *
      * Created date
+     * @internal
      */
-    created_at: string;
+    created_at?: string;
     /**
      * 更新日時
      *
      * Updated date
+     * @internal
      */
-    updated_at: string;
+    updated_at?: string;
 }
 
+/**
+ * @internal
+ */
 declare interface LyricsTiming {
+    /** Lyrics vocalized timing (start) [s] */
     start_time: number;
+    /** Lyrics vocalized timing (end) [s] */
     end_time: number;
 }
 
+/**
+ * 歌詞発声タイミングの情報
+ *
+ * Lyrics timing information
+ * @public
+ */
+declare interface LyricsTimingInfo {
+    /**
+     * 歌詞発声タイミングのID
+     *
+     * Lyrics ID
+     */
+    id: number;
+    /**
+     * 歌詞URL
+     *
+     * Lyrics url
+     */
+    url: string;
+    /**
+     * @see e.g. {@link http://songle.jp/songs/1299363/lyrics/48823/diffs/1279/lyrics.json}
+     * @internal
+     */
+    data: LyricsTiming[][][];
+    /**
+     * @internal
+     */
+    offset: number;
+    /**
+     * @internal
+     */
+    parser_path: string;
+}
+
 /**
  * **Matrix2D**
  *
@@ -2445,9 +3100,11 @@ declare interface LyricsTiming {
  *
  * This matrix can be visualized as:
  *
+ * ```
  * 	[ a  c  tx
  * 	  b  d  ty
  * 	  0  0  1  ]
+ * ```
  *
  * Note the locations of b and c.
  *
@@ -2480,29 +3137,17 @@ declare interface LyricsTiming {
  * @public
  */
 declare class Matrix2D implements IMatrix2D {
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     a: number;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     b: number;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     c: number;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     d: number;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     tx: number;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     ty: number;
     /**
      * @param a - Specifies the a property for the new matrix.
@@ -2513,85 +3158,45 @@ declare class Matrix2D implements IMatrix2D {
      * @param ty - Specifies the ty property for the new matrix.
      */
     constructor(a?: number, b?: number, c?: number, d?: number, tx?: number, ty?: number);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setValues(a?: number, b?: number, c?: number, d?: number, tx?: number, ty?: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     append(a: number, b: number, c: number, d: number, tx: number, ty: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     prepend(a: number, b: number, c: number, d: number, tx: number, ty: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     appendMatrix(matrix: Matrix2D): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     prependMatrix(matrix: Matrix2D): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     appendTransform(x: number, y: number, scaleX: number, scaleY: number, rotation: number, skewX: number, skewY: number, regX: number, regY: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     prependTransform(x: number, y: number, scaleX: number, scaleY: number, rotation: number, skewX: number, skewY: number, regX: number, regY: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     rotate(angle: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     skew(skewX: number, skewY: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     scale(x: number, y: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     translate(x: number, y: number): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     identity(): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     invert(): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     isIdentity(): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     equals(matrix: Matrix2D): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     transformPoint(x: number, y: number, pt: Point): Point;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     decompose(target?: DecomposedProps): DecomposedProps;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     copy(matrix: Matrix2D): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     clone(): Matrix2D;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     toString(): string;
     /**
      * Multiplier for converting degrees to radians. Used internally by Matrix2D.
@@ -2603,13 +3208,17 @@ declare class Matrix2D implements IMatrix2D {
     static readonly identity: Matrix2D;
 }
 
-export declare const NativeCheckWidget: FC<NativeCheckWidgetProps>;
+export declare function msToString(x: number, ja?: boolean): string;
 
-export declare interface NativeCheckWidgetProps {
-    widget: ParameterWidget;
-    value: any;
-    onValueChange?(value: boolean): void;
-    withoutName?: boolean;
+export declare const NumericSlider: FC<NumericSliderProps>;
+
+export declare interface NumericSliderProps {
+    disabled?: boolean;
+    min: number;
+    max: number;
+    value: number | string;
+    onValueChange?(value: number): void;
+    withTextInput?: boolean;
 }
 
 export declare const Overlay: FC<OverlayProps>;
@@ -2619,9 +3228,9 @@ export declare interface OverlayProps extends DetailedHTMLProps<HTMLAttributes<H
 }
 
 /**
- * TextAlive アプリ、スタイル、テンプレートで調整可能なパラメタ値の型情報
+ * リリックアプリ、スタイル、テンプレートで調整可能なパラメタ値の型情報
  *
- * Type definition for parameter values that can be customized in TextAlive App, styles, and templates
+ * Type definition for parameter values that can be customized in lyric apps, styles, and templates
  * @public
  */
 declare type ParameterValue = IColor | string | number | boolean;
@@ -2634,9 +3243,9 @@ declare interface ParameterValues {
 }
 
 /**
- * TextAlive アプリ、スタイル、テンプレートで調整可能なパラメタ
+ * リリックアプリ、スタイル、テンプレートで調整可能なパラメタ
  *
- * Parameters that can be customized in TextAlive App, styles, and templates
+ * Parameters that can be customized in lyric apps, styles, and templates
  * @public
  */
 declare interface ParameterWidget {
@@ -2664,99 +3273,49 @@ declare interface ParameterWidget {
      *
      * Type of this variable (e.g. `Slider`)
      */
-    className?: string;
-    /**
-     * パラメタのオプション（例: {@link ParameterWidget.className} が `Slider` のとき `[0, 100]` で値域 `0` から `100` のスライダーウィジェットが出現）
-     *
-     * Options for constructing a parameter widget parsed from description e.g. `[0, 100]`
-     */
-    params?: (boolean | number | string | [boolean | number | string, string?] | {
-        [value: string]: string;
-    })[];
-    /**
-     * User-Generated Variable の場合、その説明
-     *
-     * Explanation for user-generated variable
-     * @internal
-     */
-    comment?: string | RegionalText;
-    /**
-     * User-Generated Variable の場合、その提案状況
-     *
-     * Flag for user-generated variable
-     * @internal
-     */
-    proposed?: boolean;
-    /**
-     * パラメタの初期値
-     *
-     * Initial value for this parameter variable
-     */
-    initialValue?: ParameterValue;
-}
-
-export declare interface PartialPlayerOptions {
-    /**
-     * TextAlive App Framework usage option. When this flag is set, the player parses query string to gain initial media information and tries communicating with the app host.
-     */
-    app?: PlayerAppOptions | boolean;
-    /**
-     * Unsafe acceleration. When this flag is set, JavaScript code is executed natively.
-     */
-    unsafeAcceleration?: boolean;
-    /**
-     * A timer instance that controls the player status.
-     */
-    timer?: Timer;
-    /**
-     * A graphics driver that renders the video.
-     */
-    graphics?: GraphicsDriver;
-    /**
-     * A HTML div element to host media elements.
-     */
-    mediaElement?: HTMLElement;
-    /**
-     * TextAlive manager instances.
-     */
-    managers?: IPlayerManagers;
-    /**
-     * An interval for emitting throttled events [ms].
-     */
-    throttleInterval?: number;
-    /**
-     * Timeout for fetching lyrics text [ms].
-     */
-    lyricsFetchTimeout?: number;
+    className?: string;
     /**
-     * A list of font families to load.
-     * When a video is loaded, fonts used in the video override the list.
+     * パラメタのオプション（例: {@link ParameterWidget.className} が `Slider` のとき `[0, 100]` で値域 `0` から `100` のスライダーウィジェットが出現）
+     *
+     * Options for constructing a parameter widget parsed from description e.g. `[0, 100]`
      */
-    fontFamilies?: string[];
+    params?: (boolean | number | string | [boolean | number | string, string?] | {
+        [value: string]: string;
+    })[];
     /**
-     * Default video size
+     * User-Generated Variable の場合、その説明
+     *
+     * Explanation for user-generated variable
+     * @internal
      */
-    defaultVideoSize?: VideoSizeConfig;
+    comment?: string | RegionalText;
     /**
-     * Whether to load vocal amplitude data or not
+     * User-Generated Variable の場合、その提案状況
+     *
+     * Flag for user-generated variable
+     * @internal
      */
-    vocalAmplitudeEnabled?: boolean;
+    proposed?: boolean;
     /**
-     * Whether to load valence arousal data or not
+     * パラメタの初期値
+     *
+     * Initial value for this parameter variable
      */
-    valenceArousalEnabled?: boolean;
+    initialValue?: ParameterValue;
 }
 
+export declare type PartialPlayerOptions = Omit<PlayerOptions, "stageElement">;
+
 /**
  * TextAlive の動画データを上書きする情報
  *
  * Optional data to overwrite TextAlive video data
- * @see {@link VideoEntry}
  * @public
  */
 declare interface PartialVideoEntry {
     /**
      * 楽曲コード(ID) / Songle song code
+     * @internal
      */
     songleCode?: string;
     /**
@@ -2829,29 +3388,35 @@ declare interface PlayerAppHost {
 }
 
 /**
- * TextAlive アプリ関連のイベント
+ * リリックアプリ関連のイベント
  *
- * TextAlive app-related events
+ * Lyric app-related events
  * @public
  */
 declare interface PlayerAppListener {
     /**
-     * TextAlive ホストとの接続時に呼ばれる
+     * TextAlive App API サーバとの接続時に呼ばれる
+     * @param app - TextAlive App API サーバに関する情報 / TextAlive app API server info
+     * @param error - エラーメッセージ / Error message
+     */
+    onAppLoad?(app: IPlayerApp, error?: string): void;
+    /**
+     * リリックアプリ ホストとの接続時に呼ばれる
      *
-     * Called when connection to a TextAlive host is established
-     * @param app - TextAlive アプリのホストに関する情報 / TextAlive app host info
+     * Called when connection to a lyric app host is established
+     * @param app - リリックアプリのホストに関する情報 / Lyric app host info
      */
     onAppReady?(app: IPlayerApp): void;
     /**
-     * TextAlive アプリのパラメタが更新されたときに呼ばれる
+     * リリックアプリのパラメタが更新されたときに呼ばれる
      *
-     * Called when a parameter value of TextAlive app is updated
+     * Called when a parameter value of this lyric app is updated
      * @param name - パラメタ名 / Parameter name
      * @param value - パラメタ値 / Parameter value
      */
     onAppParameterUpdate?(name: string, value: ParameterValue): void;
     /**
-     * TextAlive アプリの再生すべき楽曲URLが変更されたときに呼ばれる
+     * リリックアプリの再生すべき楽曲URLが変更されたときに呼ばれる
      *
      * Called when a media URL to play is updated
      * @param songUrl - 楽曲URL / Song URL
@@ -2861,22 +3426,30 @@ declare interface PlayerAppListener {
 }
 
 /**
- * TextAlive アプリのオプション
+ * リリックアプリのオプション
  *
- * TextAlive app options
+ * Lyric app options
  * @public
  */
 declare interface PlayerAppOptions {
+    /**
+     * アプリの開発者用トークン
+     *
+     * Application token
+     */
+    token: string;
     /**
      * アプリの名前
      *
      * Name of this application
+     * @deprecated This value will be automatically retrieved from TextAlive API server.
      */
     appName?: string;
     /**
      * アプリ作者の名前
      *
      * Name of the author of this application
+     * @deprecated This value will be automatically retrieved from TextAlive API server.
      */
     appAuthor?: string;
     /**
@@ -2888,9 +3461,28 @@ declare interface PlayerAppOptions {
 }
 
 /**
- * TextAlive アプリ向けの楽曲データ読み込みオプション
+ * TextAlive App APIサーバに関する情報
+ * @public
+ */
+declare interface PlayerAppServer {
+    /**
+     * バージョン番号
+     */
+    version?: string;
+    /**
+     * メッセージ
+     */
+    message?: string;
+    /**
+     * エラーメッセージ
+     */
+    error?: string;
+}
+
+/**
+ * リリックアプリ向けの楽曲データ読み込みオプション
  *
- * Options to load song data in TextAlive app
+ * Options to load song data in a lyric app
  * @see {@link PlayerVideoOptions}, {@link PartialVideoEntry}
  * @public
  */
@@ -2946,9 +3538,9 @@ export declare interface PlayerControlProps {
 }
 
 /**
- * TextAlive Player のイベント
+ * Player のイベント
  *
- * TextAlive Player events
+ * Player events
  * @public
  */
 declare interface PlayerEventListener {
@@ -2986,6 +3578,7 @@ declare interface PlayerEventListener {
      *
      * Called when the stage size is updated
      * @param size - ステージのサイズ / Stage size
+     * @internal
      */
     onResize?(size: PlayerSize): void;
     /**
@@ -3060,6 +3653,13 @@ declare interface PlayerEventListener {
      * @param position - 再生位置 [ms]
      */
     onSeek?(position: number): void;
+    /**
+     * 楽曲の再生位置変更が完了したときに呼ばれる
+     *
+     * Called when the media playback position is successfully updated after {@link onSeek}
+     * @param position - 再生位置 [ms]
+     */
+    onSeekComplete?(position: number): void;
     /**
      * プレイヤーが破棄されるときに呼ばれる
      *
@@ -3075,9 +3675,9 @@ declare interface PlayerEventListener {
 declare type PlayerFindOptions = FindTimedObjectOptions;
 
 /**
- * TextAlive Player に関するさまざまなイベントのリスナ
+ * Player に関するさまざまなイベントのリスナ
  *
- * Event listener for TextAlive Player
+ * Event listener for Player
  * @public
  */
 declare type PlayerListener = PlayerEventListener & PlayerAppListener & LoaderListener;
@@ -3098,26 +3698,28 @@ export declare enum PlayerLoaderStatus {
 declare type PlayerMediaPositionUpdateFunction = (position: number) => Promise<number>;
 
 /**
- * TextAlive Player の初期化オプション
+ * Player の初期化オプション
+ *
+ * Player initialization options
  *
  * @see {@link IPlayer}
  * @public
  */
 declare interface PlayerOptions {
     /**
-     * TextAlive アプリの情報; このプロパティがセットされていると、再生メディアをURLのクエリパラメタから取得したり、アプリのホストとの接続を試みたりします。
+     * リリックアプリの情報; このプロパティがセットされていると、再生メディアをURLのクエリパラメタから取得したり、アプリのホストとの接続を試みたりします。
      *
-     * TextAlive app options. When this property is set, the player parses query string to gain initial media information and tries communicating with the app host.
+     * Lyric app options. When this property is set, the player parses query string to gain initial media information and tries communicating with the app host.
      */
-    app?: PlayerAppOptions | boolean;
+    app?: PlayerAppOptions;
     /**
-     * TextAlive Player の音源の再生状態を管理する `Timer` インスタンスです。
+     * Player の音源の再生状態を管理する `Timer` インスタンスです。
      *
      * A timer instance that controls the player status.
      */
     timer?: Timer;
     /**
-     * TextAlive のJavaScriptインタプリタを介さず、直接テンプレートのコードを実行することで描画を高速化するオプションです。
+     * TextAlive の JavaScript インタプリタを介さず、直接テンプレートのコードを実行することで描画を高速化するオプションです。
      *
      * Unsafe acceleration. When this flag is set, JavaScript code is executed natively.
      * @internal
@@ -3137,13 +3739,13 @@ declare interface PlayerOptions {
      * A HTML canvas element to render the video on.
      * @internal
      */
-    stageElement?: HTMLElement;
+    stageElement?: HTMLElement | string;
     /**
      * 音源メディアの配置先となるDOM要素; 音源を埋め込むコンテナとして利用されるDOM要素です。
      *
      * A HTML element to host media elements.
      */
-    mediaElement?: HTMLElement;
+    mediaElement?: HTMLElement | string;
     /**
      * 音源メディアの関連情報を表示する位置; 指定がなければ `embed` と見なされ、メディア直下に表示されます。
      *
@@ -3171,13 +3773,18 @@ declare interface PlayerOptions {
      */
     lyricsFetchTimeout?: number;
     /**
-     * 読み込むフォントの一覧を指定できます。 TextAlive 動画が読み込まれると、このオプションに限らず、動画中で利用されているフォントがすべて読み込まれます。 `null` が指定されると、利用可能なすべてのフォントが読み込まれます。
+     * 読み込むフォントの一覧を指定できます。 `null` が指定されると、利用可能なすべてのフォントが読み込まれます。
      *
-     * A list of font families to load. When a video is loaded, fonts used in the video override the list. When `null` is set, all available fonts are loaded.
+     * A list of font families to load. When `null` is set, all available fonts are loaded.
+     */
+    fontFamilies?: (FontInfo | string)[] | null;
+    /**
+     * プライベートフォントを読み込むか制御できます。
      *
-     * @see {@link IFontLoader.listAvailableFonts}
+     * Whether to load private fonts or not
+     * @internal
      */
-    fontFamilies?: (FontInfo | string)[];
+    isPrivateFontEnabled?: boolean;
     /**
      * 明示的に指定されなかった場合に採用されるデフォルトのステージサイズ
      *
@@ -3211,6 +3818,7 @@ export declare const PlayerOverlay: FC<PlayerOverlayProps>;
 export declare interface PlayerOverlayProps {
     showStatus?: boolean;
     svgLogoImage?: string;
+    onError?: (eventType: string, reason: any) => void;
 }
 
 export declare const PlayerSeekbar: FC<PlayerSeekbarProps>;
@@ -3220,15 +3828,13 @@ export declare interface PlayerSeekbarProps {
     disabled?: boolean;
     /** TextAlive player (this is optional because the value can also be passed with `PlayerContext`) */
     player?: IPlayer;
-    /** CSS style values for the seekbar */
-    styles?: SliderStyles;
 }
 
 /**
- * TextAlive Player のサイズ
+ * Player のサイズ
  *
- * TextAlive Player size
- * @public
+ * Player size
+ * @internal
  */
 declare interface PlayerSize {
     /**
@@ -3241,7 +3847,7 @@ declare interface PlayerSize {
     height: number;
 }
 
-export declare const PlayerStatus: FC;
+export declare const PlayerStatus: FC<PlayerStatusProps>;
 
 export declare const PlayerStatusItem: FC<PlayerStatusItemProps>;
 
@@ -3250,6 +3856,10 @@ export declare interface PlayerStatusItemProps {
     status: PlayerLoaderStatus;
 }
 
+export declare interface PlayerStatusProps {
+    onError?: (eventType: string, reason: any) => void;
+}
+
 /**
  * TextAliveの動画オブジェクトを構築するためのオプション
  *
@@ -3286,6 +3896,7 @@ declare interface PlayerVideoOptions {
      *
      * - URL of lyrics text needs to support CORS access
      * - When failed, the default method is used
+     * @internal
      */
     lyricsDirectAccess?: boolean;
     /**
@@ -3311,6 +3922,7 @@ export declare interface PlayerWrapperProps {
     overlayed?: boolean;
     rounded?: boolean;
     bordered?: boolean;
+    children?: ReactNode;
 }
 
 /**
@@ -3347,34 +3959,22 @@ export declare interface PlayerWrapperProps {
  * @public
  */
 declare class Point implements IPoint {
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     x: number;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     y: number;
     /**
      * @param x - X position.
      * @param y - Y position.
      */
     constructor(x?: number, y?: number);
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setValues(x?: number, y?: number): Point;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     copy(point: Point): Point;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     clone(): Point;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     toString(): string;
 }
 
@@ -3384,6 +3984,7 @@ export declare const ProfileProvider: FC<ProfileProviderProps>;
 
 export declare interface ProfileProviderProps {
     manager: IUserManager;
+    children?: ReactNode;
 }
 
 /**
@@ -3410,6 +4011,10 @@ export declare interface ReactPlayerProps extends PartialPlayerOptions {
      * Player callback
      */
     onInit(player: IPlayer): void;
+    /**
+     * Child component if any (intended to be used by PlayerOverlay component)
+     */
+    children?: ReactNode;
 }
 
 /**
@@ -3427,10 +4032,16 @@ declare type RegionalText = {
 
 export declare function regionalText(text?: string | RegionalText, ja?: boolean): string | undefined;
 
+/**
+ * @internal
+ */
 declare interface RenderingGraphics {
     clear(): void;
 }
 
+/**
+ * @internal
+ */
 declare interface RenderingParameter {
     alpha: number;
     tx: Matrix2D;
@@ -3440,55 +4051,85 @@ declare interface RenderingParameter {
 }
 
 /**
+ * 定期的に呼び出される描画用関数 / Rendering function that runs periodically
  * @public
  */
-declare type RenderingUnitFunction<U extends IRenderingUnit> = (now: number, u: U) => void;
+declare type RenderingUnitFunction = (now: number, u: IRenderingUnit) => void;
 
+/**
+ * @internal
+ */
 declare interface RuntimeVideo {
     rendering: RenderingParameter;
+    addCredit(p: IPhrase): void;
+    removeCredit(p: IPhrase): void;
+    addPhrase(p: IPhrase): void;
+    removePhrase(p: IPhrase): void;
     addGraphic(g: IGraphic): void;
     removeGraphic(g: IGraphic): void;
 }
 
-/**
- * A seekbar allows users to seek for a numerical value in the specified range.
- */
 export declare const Seekbar: FC<SeekbarProps>;
 
-export declare interface SeekbarProps {
-    /** whether this seekbar is disabled or not */
-    disabled?: boolean;
-    /** maximum value of the seekbar slider [ms] */
+export declare interface SeekbarProps extends SliderProps {
     duration: number;
-    /** current value of the seekbar slider [ms] */
     position: number;
-    /** called when the current value is updated */
     onSeek?: (position: number) => void;
-    /** called when seek starts */
     onSeekStart?: () => void;
-    /** called when seek ends */
     onSeekEnd?: () => void;
-    /** CSS style values for the seekbar */
-    styles?: SliderStyles;
 }
 
 export declare const SelectDropdown: FC<SelectDropdownProps>;
 
 export declare interface SelectDropdownProps {
     label?: ReactNode;
-    labelTitle?: string;
-    options: Option_2[];
+    description?: ReactNode;
+    options: SelectOption[] | null;
     value: any;
+    disabled?: boolean;
     onValueChange?(value: any): void;
 }
 
+export declare interface SelectOption {
+    label: ReactNode;
+    value: string | number | boolean | {
+        [value: string]: string;
+    };
+}
+
 export declare const SelectWidget: FC<SelectWidgetProps>;
 
 export declare interface SelectWidgetProps {
     widget: ParameterWidget;
-    value: any;
+    value: ParameterValue;
     onValueChange?(value: ParameterValue): void;
     withoutName?: boolean;
+    description?: string | RegionalText;
+}
+
+/**
+ * @internal
+ */
+declare interface ServerStatus {
+    lang: string;
+    version: string;
+    releaseDate: string;
+    status: {
+        core: "ready" | "maintenance";
+        renderer: "ready" | "maintenance";
+    };
+    app: {
+        success: boolean;
+        data: {
+            name: string;
+            url: string;
+            status?: number;
+            author: string;
+            createdDate: string;
+        };
+        error?: string;
+        message?: string;
+    } | null;
 }
 
 export declare interface Size {
@@ -3496,39 +4137,19 @@ export declare interface Size {
     height: number;
 }
 
-export declare const Slider: FC<SliderProps>;
-
-export declare interface SliderProps {
-    label?: ReactNode;
-    labelTitle?: string;
-    min: number;
-    max: number;
-    value: number;
-    onValueChange?(value: number): void;
-    withTextInput?: boolean;
-    styles?: SliderStyles;
-}
-
-export declare interface SliderStyles {
-    track?: Interpolation;
-    active?: Interpolation;
-    thumb?: Interpolation;
-    disabled?: Interpolation;
-}
-
 export declare const SliderWidget: FC<SliderWidgetProps>;
 
 export declare interface SliderWidgetProps {
     widget: ParameterWidget;
-    value: any;
+    value: ParameterValue;
     onValueChange?(value: number): void;
     withTextInput?: boolean;
     withoutName?: boolean;
-    styles?: SliderStyles;
+    description?: string | RegionalText;
 }
 
 /**
- * Songle 楽曲情報
+ * 楽曲のメタ情報
  * @public
  */
 declare interface Song {
@@ -3569,12 +4190,12 @@ declare interface Song {
      * 楽曲の再生時間長 [s]
      *
      * - この値は低精度です
-     * - 演出に利用する値は必ず TextAlive Player から取得してください
+     * - 演出に利用する値は必ず Player インスタンスから取得してください
      *
      * Song duration [s]
      *
      * - This value is error-prone
-     * - Gain more precise value from TextAlive Player instance
+     * - Gain more precise value from Player instance
      */
     length: number;
     /**
@@ -3691,6 +4312,9 @@ declare interface Song {
     commented_at: string | null;
 }
 
+/**
+ * @internal
+ */
 declare interface SongAnalysis {
     beats: SongBeat[][];
     chords: SongChord[];
@@ -3698,26 +4322,35 @@ declare interface SongAnalysis {
     voice: SongVoice[][];
 }
 
+/**
+ * @internal
+ */
 declare type SongBeat = [
-/** startTime [s] */ number, 
-/** ? */ number, 
-/** length */ number, 
-/** position */ number, 
-/** ? */ number];
+/** startTime [s] */ number,
+/** ? */ number,
+/** length */ number,
+/** position */ number,
+/** ? */ number
+];
 
+/**
+ * @internal
+ */
 declare type SongChord = [
-/** startTime [s] */ number, 
-/** endTime [s] */ number, 
-/** name */ string, 
-/** ? */ any[]];
+/** startTime [s] */ number,
+/** endTime [s] */ number,
+/** name */ string,
+/** ? */ any[]
+];
 
 /**
- * Detailed song information
- * e.g. http://songle.jp/songs/1227536/info?format=json&min=1
+ * 楽曲の詳細な情報 / Detailed song information
  * @internal
  */
 declare interface SongInfo {
+    /** @internal */
     analysis: SongAnalysis;
+    /** @internal */
     info: SongMeta;
 }
 
@@ -3735,12 +4368,12 @@ declare interface SongleLyrics {
 }
 
 /**
- * Song information
- * e.g. http://songle.jp/songs/www.youtube.com%2Fwatch%3Fv%3DKdNHFKTKX2s?format=json
- * @internal
+ * Songle 楽曲情報
+ * @public
  */
 declare interface SongleSong {
     song: Song;
+    /** @internal */
     status: SongStatus;
 }
 
@@ -3770,36 +4403,51 @@ declare interface SongLoaderListener {
      * Called when detailed song info is loaded
      * @param songInfo - 楽曲の詳細情報 / Detailed song info
      * @param reason - 失敗したときの理由 / Reason for failures (if any)
+     * @internal
      * @deprecated Use {@link SongLoaderListener.onSongMapLoad} instead
      */
     onSongInfoLoad?(songInfo: SongInfo, reason?: Error): void;
     /**
      * 声量の情報が読み込まれたときに呼ばれる
      *
+     * - 実際の声量情報は {@link ISongExplorer.getVocalAmplitude} を使って取得してください
+     *
      * Called when vocal amplitude is loaded
-     * @param vocalAmplitude - 声量の情報
+     *
+     * - To retrieve vocal amplitude information, call {@link ISongExplorer.getVocalAmplitude}
+     * @param vocalAmplitude - 声量の情報（未整形のデータ）
      * @param reason - 失敗したときの理由 / Reason for failures (if any)
      */
     onVocalAmplitudeLoad?(vocalAmplitude: VocalAmplitude, reason?: Error): void;
     /**
      * V/A空間の情報が読み込まれたときに呼ばれる
      *
+     * - 実際のV/A空間の座標情報は {@link ISongExplorer.getValenceArousal} を使って取得してください
+     *
      * Called when valence arousal info is loaded
-     * @param valenceArousal - V/A空間の情報
+     *
+     * - To retrieve valence/arousal metrics, call {@link ISongExplorer.getValenceArousal}
+     * @param valenceArousal - V/A空間の情報（未整形のデータ）
      * @param reason - 失敗したときの理由 / Reason for failures (if any)
      */
     onValenceArousalLoad?(valenceArousal: ValenceArousal, reason?: Error): void;
 }
 
+/**
+ * @internal
+ */
 declare interface SongMapRevisions {
     chord?: number;
     beat?: number;
     chorus?: number;
 }
 
+/**
+ * @internal
+ */
 declare interface SongMeta {
     /**
-     * @deprecated
+     * @deprecated Use {@link code} to identify a Songle song
      */
     songId: number;
     offset: number;
@@ -3815,6 +4463,9 @@ declare interface SongMeta {
     code: string;
 }
 
+/**
+ * @internal
+ */
 declare interface SongRepetitiveSegment {
     index: number;
     chorus: boolean;
@@ -3826,7 +4477,7 @@ declare interface SongRepetitiveSegment {
  * Songle での解析状況
  *
  * Songle analysis status
- * @public
+ * @internal
  */
 declare interface SongStatus {
     /**
@@ -3867,17 +4518,38 @@ declare interface SongStatus {
      * Lyrics
      */
     lyrics: boolean;
+    /**
+     * 実データにアクセス権のあるプライベート楽曲
+     *
+     * Private song with owner permission
+     * @internal
+     */
+    owner?: boolean;
 }
 
-declare type SongVoice = [[/** current f0 */ number, /** initially recognized f0 */ number], 
-/** number of frames (10 [ms] per each frame) */ number];
+/**
+ * @internal
+ */
+declare type SongVoice = [
+[ /** current f0 */
+number, /** initially recognized f0 */
+number
+],
+/** number of frames (10 [ms] per each frame) */ number
+];
 
+/**
+ * @internal
+ */
 declare interface TemplateCreateRequest {
     sourceId?: number;
     script: string;
     log?: string;
 }
 
+/**
+ * @internal
+ */
 declare interface TemplateCreateResponse {
     success: boolean;
     /** Template ID (when succeeded) */
@@ -3905,6 +4577,9 @@ declare interface TemplateData {
     };
 }
 
+/**
+ * @internal
+ */
 declare interface TemplateEntry {
     id: number;
     type: number;
@@ -3918,15 +4593,11 @@ declare interface TemplateEntry {
     createdDate: string;
 }
 
-declare interface TemplateList {
-    list: TemplateEntry[];
-}
-
 /**
  * テンプレートプログラミングに関するイベントのリスナ
  *
  * Event listener for template editing
- * @public
+ * @internal
  */
 declare interface TemplateListener {
     /**
@@ -3943,14 +4614,28 @@ declare interface TemplateListener {
     onTemplatesLoad?(templates: string[], reason?: Error): void;
 }
 
-declare interface TemplateListRequest extends ListSimpleRequest {
-    maxResults?: number;
+/**
+ * @internal
+ */
+declare interface TemplateListForVideoRequest extends ListRequest {
+    script?: boolean;
+    withoutAuthors?: boolean;
+}
+
+/**
+ * @internal
+ */
+declare interface TemplateListRequest extends ListRequest {
     className?: string;
     script?: boolean;
     withoutAuthors?: boolean;
     withoutOriginalAuthors?: boolean;
+    templateType?: "text" | "graphic" | "utility";
 }
 
+/**
+ * @internal
+ */
 declare type TemplateListResponse = ListSimpleResponse<TemplateEntry>;
 
 /**
@@ -3964,7 +4649,7 @@ declare interface TextLoaderListener {
      * @param lyrics - 発声タイミングの情報 / Lyrics timing info
      * @param reason - 失敗したときの理由 / Reason for failures (if any)
      */
-    onLyricsLoad?(lyrics: LyricsDiffInfo, reason?: Error): void;
+    onLyricsLoad?(lyrics: LyricsInfo, reason?: Error): void;
     /**
      * 歌詞テキストが読み込まれたときに呼ばれる
      *
@@ -3975,6 +4660,9 @@ declare interface TextLoaderListener {
     onTextLoad?(lyricsBody: LyricsBody, reason?: Error): void;
 }
 
+/**
+ * @internal
+ */
 declare interface TextParsingResponse {
     status: "success" | "error";
     result?: WordParsingResponse[][];
@@ -3985,21 +4673,54 @@ declare interface TextParsingResponse {
  * 時刻付きオブジェクト
  *
  * Timed object
+ *
+ * @see {@link TimedUnit}
  * @public
  */
 declare interface TimedObject {
     startTime: number;
     endTime: number;
+    /**
+     * Returns whether this time range contains the specified time (start and end inclusive).
+     * @param time - 時刻 [ms] / Time [ms]
+     */
     contains(time: number): boolean;
+    /**
+     * Returns whether the specified range overlaps with this time range (start and end inclusive).
+     * @param obj - 時刻付きオブジェクト / Timed object
+     */
+    overlaps(obj: TimedObject): boolean;
+    /**
+     * Returns whether the specified range overlaps with this time range (start and end inclusive).
+     * @param startTime - 開始時刻 [ms] / Start time [ms]
+     * @param endTime - 終了時刻 [ms] / End time [ms]
+     */
     overlaps(startTime: number, endTime: number): boolean;
 }
 
+/**
+ * 時区間駆動型APIの問い合わせ結果 / Query results for time-range-driven API
+ * @public
+ */
+declare interface TimedObjectsInRange<T extends TimedObject> {
+    /** 指定区間の終了時にかぶっているオブジェクト / Timed object overlapping with the end time of the specified time range */
+    current: T | null;
+    /** 指定区間内で開始したオブジェクト / Timed objects that started within the specified time range  */
+    entered: T[];
+    /** 指定区間内で終了したオブジェクト / Timed objects that ended within the specified time range */
+    left: T[];
+    /** 指定区間の直前にあるオブジェクト / The last timed object before the specified time range */
+    previous: T | null;
+    /** 指定区間の直後にあるオブジェクト / The first timed object after the specified time range */
+    next: T | null;
+}
+
 /**
  * **Timer**
  *
- * TextAlive Player の音源の再生状態を管理するクラスが実装するインタフェースです。
+ * Player の音源の再生状態を管理するクラスが実装するインタフェースです。
  *
- * Classes that manage music playback for TextAlive Player should implement this interface.
+ * Classes that manage music playback for Player should implement this interface.
  * @public
  */
 declare interface Timer {
@@ -4013,20 +4734,20 @@ declare interface Timer {
      * **現在の再生位置 [ms]**
      *
      * `Timer` 実装クラスはこの値をリアルタイムに計算して返さなくてはなりません。
-     * TextAlive には他にも再生位置を返すAPIが以下の2種類用意されていますが、実装手法の違いにより、このAPIが常に最も精確な値を返します。
+     * 他にも再生位置を返す API が以下の2種類用意されていますが、実装手法の違いにより、この API が常に最も精確な値を返します。
      *
      * - {@link IPlayer.mediaPosition} は `Timer` 実装クラスによって定期的に更新されます
-     * - {@link IPlayer.videoPosition} は TextAlive Player が定期的に呼び出す {@link IRenderingUnit.animate} が成功してから更新されます
+     * - {@link IPlayer.videoPosition} は Player が定期的に呼び出す {@link IRenderingUnit.animate} が成功してから更新されます
      *
-     * このAPIを利用するアプリでは、動画のシーク操作に対応するために {@link PlayerEventListener.onVideoSeekStart} {@link PlayerEventListener.onVideoSeek} {@link PlayerEventListener.onVideoSeekEnd} イベントを適切にハンドルする必要があります。
+     * この API を利用するアプリでは、動画のシーク操作に対応するために {@link PlayerEventListener.onVideoSeekStart} {@link PlayerEventListener.onVideoSeek} {@link PlayerEventListener.onVideoSeekEnd} イベントを適切にハンドルする必要があります。
      *
      * **Current playback position [ms]**
      *
      * `Timer` implementations need to calculate this property value in real time.
-     * While TextAlive also has the following APIs to retrieve the current playback position, this one returns the most precise value at any time.
+     * While there are two other APIs to retrieve the current playback position as follows, this one returns the most precise value.
      *
      * - {@link IPlayer.mediaPosition} is updated by `Timer` implementations periodically
-     * - {@link IPlayer.videoPosition} is updated by TextAlive Player after the periodic call to {@link IRenderingUnit.animate}
+     * - {@link IPlayer.videoPosition} is updated by Player after the periodic call to {@link IRenderingUnit.animate}
      *
      * Applications utilizing this API need to handle {@link PlayerEventListener.onVideoSeekStart} {@link PlayerEventListener.onVideoSeek} {@link PlayerEventListener.onVideoSeekEnd} events appropriately so that the applications respond to the video seeking operation.
      */
@@ -4086,9 +4807,9 @@ declare interface Timer {
  */
 declare interface TimerInitOptions {
     /**
-     * TextAlive Player インスタンス
+     * Player インスタンス
      *
-     * TextAlive Player instance
+     * Player instance
      */
     player: IPlayer;
     /**
@@ -4121,13 +4842,14 @@ declare interface UnitData {
 
 /**
  * TextAlive user information
+ *
+ * @internal
  */
 declare interface UserEntry {
     id?: number;
     name?: string;
     displayName?: string;
     photoUrl?: string;
-    language?: string;
     twitterId?: number;
     twitterName?: string;
     twitterDisplayName?: string;
@@ -4150,12 +4872,20 @@ declare interface UserEntry {
     songleUserName?: string;
     songleAccessToken?: string;
     songleRefreshToken?: string;
+    language?: string;
+    isDeveloper?: boolean;
     createdDate?: string;
     updatedDate?: string;
 }
 
-export declare function useResize<T extends HTMLElement>(): [Size, RefObject<T>];
+export declare function useResize<T extends HTMLElement>(): [
+Size,
+RefObject<T | null>
+];
 
+/**
+ * @internal
+ */
 declare interface UserListener {
     onUserProfileUpdated?: (user: UserProfile) => void;
     onUserMergeRequired?: (user: UserEntry, mergeWith: UserEntry) => void;
@@ -4166,6 +4896,8 @@ declare interface UserListener {
 
 /**
  * TextAlive user profile
+ *
+ * @internal
  */
 declare interface UserProfile {
     user: UserEntry;
@@ -4177,8 +4909,15 @@ declare interface UserProfile {
 }
 
 /**
- * Valence and arousal model information
- * e.g. https://songle.jp/songs/ad3e5f353/av.json
+ * @internal
+ */
+declare interface UserUpdateRequest {
+    language?: string;
+    isDeveloper?: boolean;
+}
+
+/**
+ * V/A空間の情報 / Valence and arousal model information
  * @internal
  */
 declare interface ValenceArousal {
@@ -4188,6 +4927,9 @@ declare interface ValenceArousal {
     seq: ValenceArousalUnit[];
 }
 
+/**
+ * @internal
+ */
 declare interface ValenceArousalUnit extends ValenceArousalValue {
     /** Time */
     t: [number, number];
@@ -4196,20 +4938,26 @@ declare interface ValenceArousalUnit extends ValenceArousalValue {
 /**
  * V/A空間の座標値
  *
+ * - 感情価、覚醒度とも `[-1, 1]` の範囲に正規化された値
+ * - 曲内の相対的な変化 **ではなく** 曲間で比較可能な絶対値
+ *
  * Valence arousal data
+ *
+ * - Both valence and arousal values range from -1 to 1
+ * - The values do NOT represent relative changes within a song but absolute values comparable with values in other songs
  * @public
  */
 declare interface ValenceArousalValue {
     /**
-     * 感情価
+     * 感情価 [-1, 1]
      *
-     * Valence
+     * Valence [-1, 1]
      */
     v: number;
     /**
-     * 覚醒度
+     * 覚醒度 [-1, 1]
      *
-     * Arousal
+     * Arousal [-1, 1]
      */
     a: number;
 }
@@ -4221,7 +4969,14 @@ declare interface VideoData {
     startTime?: number;
     endTime?: number;
     duration?: number;
+    /**
+     * @internal
+     */
+    credits?: PhraseData[];
     phrases?: PhraseData[];
+    /**
+     * @internal
+     */
     graphics?: GraphicData[];
     /**
      * @internal
@@ -4233,7 +4988,7 @@ declare interface VideoData {
 
 /**
  * TextAlive の動画データ
- * @public
+ * @internal
  */
 declare interface VideoEntry {
     /**
@@ -4249,7 +5004,7 @@ declare interface VideoEntry {
      */
     sourceOriginId: number;
     /**
-     * @deprecated
+     * @deprecated {@link songleCode} で楽曲を特定してください / Use {@link songleCode} to identify a Songle song
      * @internal
      */
     songleId: number;
@@ -4328,7 +5083,7 @@ declare interface VideoEntry {
 }
 
 /**
- * @public
+ * @internal
  */
 declare interface VideoEntryConfig extends VideoSizeConfig {
     /**
@@ -4339,6 +5094,7 @@ declare interface VideoEntryConfig extends VideoSizeConfig {
 
 /**
  * Options for exporting video object
+ * @internal
  */
 declare interface VideoExportOptions {
     /**
@@ -4348,7 +5104,30 @@ declare interface VideoExportOptions {
 }
 
 /**
- * @public
+ * @internal
+ */
+declare interface VideoListRequest extends ListRequest {
+    /**
+     * @deprecated Use {@link VideoListRequest.songCode} instead
+     */
+    songId?: number;
+    songCode?: string;
+    authorId?: number;
+    mine?: boolean;
+    sort?: "latest" | "popularity";
+    uniqueSource?: boolean;
+    uniqueAuthor?: boolean;
+    uniqueSong?: boolean;
+    template?: string;
+}
+
+/**
+ * @internal
+ */
+declare type VideoListResponse = ListResponse<VideoEntry>;
+
+/**
+ * @internal
  */
 declare interface VideoLoaderListener {
     /**
@@ -4362,7 +5141,7 @@ declare interface VideoLoaderListener {
 }
 
 /**
- * @public
+ * @internal
  */
 declare interface VideoSizeConfig {
     /**
@@ -4386,29 +5165,45 @@ declare interface VideoSizeConfig {
 }
 
 /**
- * Vocal amplitude information
- * e.g. https://songle.jp/songs/ad3e5f353/vamplitude.json
+ * 楽曲の声量の情報 / Vocal amplitude information
  * @internal
  */
 declare type VocalAmplitude = Array<number>;
 
 export declare const Widget: FC<WidgetProps>;
 
+export declare const WidgetLabel: FC<WidgetLabelProps>;
+
+declare interface WidgetLabelProps extends TextProps {
+    children?: ReactNode;
+}
+
+export declare type WidgetPosition = "leftAligned" | "rightAligned";
+
 export declare interface WidgetProps {
+    position?: WidgetPosition;
     widget: ParameterWidget;
     value: ParameterValue;
     colorFactory(hexString: string): IColor;
     onValueChange(name: string, value: ParameterValue): void;
+    withPrivate?: boolean;
     withoutName?: boolean;
+    description?: string | RegionalText;
 }
 
-export declare const Widgets: FC<WidgetsProps>;
+export declare const Widgets: ForwardRefExoticComponent<WidgetsProps & RefAttributes<WidgetsIface>>;
+
+export declare interface WidgetsIface {
+    values: ParameterValues;
+    setValues(values: ParameterValues): void;
+}
 
 export declare interface WidgetsProps {
     widgets: ParameterWidget[];
     initialValues?: ParameterValues;
     colorFactory(hexString: string): IColor;
     onValueChange?(name: string, value: ParameterValue): void;
+    withPrivate?: boolean;
     withoutName?: boolean;
 }
 
@@ -4420,8 +5215,17 @@ declare interface WordData extends UnitData {
     pos?: string;
     rawPoS?: string;
     language?: string;
+    /** @internal */
+    countDown?: number;
+    /** @internal */
+    countUp?: number;
+    /** @internal */
+    initialCount?: number;
 }
 
+/**
+ * @internal
+ */
 declare interface WordParsingResponse {
     PoS: string;
     rawPoS: string;
@@ -4431,6 +5235,9 @@ declare interface WordParsingResponse {
     language: "ja" | "en";
 }
 
+/**
+ * @internal
+ */
 declare type WrapperTable = {
     [className: string]: new (...params: any[]) => any;
 };