@gjsify/adwaita-web 0.64.2 → 0.64.3-next.260

package/lib/types/elements/adw-about-dialog.d.ts

@@ -12,6 +12,14 @@ export declare class AdwAboutDialog extends WidgetElement {
     private _designers;
     private _artists;
     private _documenters;
+    /** `license` + `license-type`, one state driven by the core transitions. */
+    private _licenseState;
+    /** Set while an attribute is being written back from `_licenseState`. */
+    private _reflecting;
+    /** `add_credit_section`, `add_acknowledgement_section` and `add_legal_section`, in call order. */
+    private _creditSections;
+    private _acknowledgementSections;
+    private _legalSections;
     /** `add_link` rows, in order; `has_custom_links` latches with the first. */
     private _links;
     /**
@@ -41,8 +49,14 @@ export declare class AdwAboutDialog extends WidgetElement {
     set issueUrl(value: string);
     get copyright(): string;
     set copyright(value: string);
+    /** `license`: the custom licence text, `''` for a stock licence. */
     get license(): string;
     set license(value: string);
+    /** `license-type`: a `Gtk.License` value (see `GTK_LICENSE`). */
+    get licenseType(): number;
+    set licenseType(value: number);
+    get translatorCredits(): string;
+    set translatorCredits(value: string);
     get licenseUrl(): string;
     set licenseUrl(value: string);
     get releaseNotes(): string;
@@ -53,6 +67,15 @@ export declare class AdwAboutDialog extends WidgetElement {
     set debugInfo(value: string);
     /** `adw_about_dialog_add_link`: a Details-page link row; `_` marks a mnemonic. */
     add_link(title: string, url: string): void;
+    /** `adw_about_dialog_add_credit_section`: a Credits group; `name` may be `null`. */
+    add_credit_section(name: string | null, people: string[]): void;
+    /** `adw_about_dialog_add_acknowledgement_section`: an Acknowledgements group. */
+    add_acknowledgement_section(name: string | null, people: string[]): void;
+    /**
+     * `adw_about_dialog_add_legal_section`: a Legal-page section. A `license_type` outside
+     * `Gtk.License` is rejected, like the property setter.
+     */
+    add_legal_section(title: string, copyright: string | null, license_type: number, license: string | null): void;
     get open(): boolean;
     set open(value: boolean);
     get developers(): string[];
@@ -69,17 +92,21 @@ export declare class AdwAboutDialog extends WidgetElement {
     close(): void;
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** Run the core setter an attribute maps to, notify what it notified, and write the pair back. */
+    private _applyLicenseAttribute;
+    /** An integer or a `Gtk.License` nick; anything else is out of range, so the setter refuses it. */
+    private _parseLicenseType;
+    /**
+     * Write `_licenseState` back onto the attributes, which a setter may have moved: a stock
+     * licence clears `license`. A `license-type` the app wrote as a nick is left as it wrote it.
+     */
+    private _reflectLicense;
     /** Reflect the presented state onto the host + reset the navigation stack. */
     private _syncOpen;
     /** The credit groups the Credits page shows, straight from `update_credits`. */
     private _creditsSections;
-    /**
-     * Whether the Legal page has anything on it. This element's licence model is the
-     * simplified one — a name plus an optional URL — so it maps onto `GtkLicense` as
-     * "custom text when a licence is set, unknown otherwise", which is what
-     * `adw_about_dialog_set_license` does to the type anyway.
-     */
-    private _hasLegal;
+    /** What `update_legal` reads: the dialog's own copyright + licence, then the added sections. */
+    private _legalInput;
     private _render;
     /**
      * A navigation page wrapping a header bar (with the close button) + content.
@@ -113,7 +140,17 @@ export declare class AdwAboutDialog extends WidgetElement {
     /** `copy_property_cb`: an empty value copies nothing and shows no toast. */
     private _copyProperty;
     private _buildLinkRow;
+    /**
+     * `AdwLinkRow`: `adw_link_row_init` + `adw_link_row_set_uri`. The `link` class and the
+     * LINK state flag, accessible role LINK, the unescaped URI as tooltip, and a suffix glyph
+     * that says "leaves the app" (an envelope for `mailto:`) instead of a navigation chevron.
+     * Activation is `_activateLink`, which emits `activate-link` and then opens the URI.
+     */
+    private _makeLinkRow;
     private _buildCreditsPage;
+    private _buildAcknowledgementsPage;
+    /** Credits and Acknowledgements are one structure: a group per section, a row per person. */
+    private _buildCreditGroupsPage;
     /**
      * A credit row — a plain title, or a link row when the entry carries a URI. The gate
      * is `link !== null`, not the URI's truthiness: `"Ada <>"` parses to an EMPTY link,
@@ -122,6 +159,15 @@ export declare class AdwAboutDialog extends WidgetElement {
      */
     private _buildCreditRow;
     private _buildLegalPage;
+    /** The custom licence text as a link to `license-url`. Cancelable like every other link. */
+    private _buildLicenseUrlLink;
+    /**
+     * A legal label's markup: Pango markup, with the `<a href>` GtkLabel adds on top — the
+     * stock warranty line is one. Each link raises the cancelable `activate-link`. Only
+     * `http`, `https` and `mailto` targets become links; any other is drawn as its text,
+     * since the default action hands the URI to `window.open`.
+     */
+    private _renderLegalLabel;
     /** Show the header title only once the main page is scrolled (AdwAboutDialog). */
     private _updateHeaderTitle;
 }

package/lib/types/language-host.d.ts

@@ -0,0 +1 @@
+export declare function hostLanguageTags(): string[];

package/lib/types/namespace/glib.d.ts

@@ -1,5 +1,5 @@
-export { GLibBytes as Bytes, GLibError as Error } from '@gjsify/adwaita-core';
-import { buildFilenamev, getCurrentDir, getSystemDataDirs, uriEscapeString } from '@gjsify/adwaita-core';
+export { GLibBytes as Bytes, GLibError as Error, GLibVariant as Variant } from '@gjsify/adwaita-core';
+import { buildFilenamev, getCurrentDir, getSystemDataDirs, unicharIsalpha, uriEscapeString } from '@gjsify/adwaita-core';
 export declare const PRIORITY_HIGH: number;
 export declare const PRIORITY_DEFAULT: number;
 export declare const PRIORITY_HIGH_IDLE: number;
@@ -14,4 +14,6 @@ export declare const MAXUINT32 = 4294967295;
 export declare const build_filenamev: typeof buildFilenamev;
 export declare const get_current_dir: typeof getCurrentDir;
 export declare const get_system_data_dirs: typeof getSystemDataDirs;
+export declare const get_language_names: () => string[];
 export declare const uri_escape_string: typeof uriEscapeString;
+export declare const unichar_isalpha: typeof unicharIsalpha;