@maxgraph/core/lib/cjs/i18n/config.js

maxGraph is a fully client side JavaScript diagramming library that uses SVG and HTML for rendering.

"use strict";
/*
Copyright 2025-present The maxGraph project Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.TranslationsConfig = exports.resetTranslationsConfig = void 0;
const utils_js_1 = require("../internal/utils.js");
const clone_utils_js_1 = require("../internal/clone-utils.js");
function getNavigatorLanguage() {
    return typeof window !== 'undefined' ? navigator.language : 'en';
}
const values = {
    defaultLanguage: 'en',
    language: getNavigatorLanguage(),
    languages: [],
};
// @ts-ignore the properties will be added dynamically when calling shallowCopy
const originalValues = {};
(0, clone_utils_js_1.shallowCopy)(values, originalValues);
/**
 * Resets {@link TranslationsConfig} to default values.
 *
 * @experimental Subject to change or removal. maxGraph's global configuration may be modified in the future without prior notice.
 * @since 0.16.0
 * @category Configuration
 * @category I18n
 */
const resetTranslationsConfig = () => {
    (0, clone_utils_js_1.shallowCopy)(originalValues, values);
};
exports.resetTranslationsConfig = resetTranslationsConfig;
/**
 * Global configuration for {@link Translations}.
 *
 * @experimental subject to change or removal. maxGraph's global configuration may be modified in the future without prior notice.
 * @since 0.16.0
 * @category Configuration
 * @category I18n
 */
exports.TranslationsConfig = {
    /**
     * Returns whether internationalization is enabled.
     */
    isEnabled() {
        return this.getLanguage() !== 'none';
    },
    /**
     * @see setLanguage
     */
    getLanguage() {
        return values.language;
    },
    /**
     * Defines the language of the client, e.g. `en` for english, `de` for german etc.
     *
     * The special value `none` will disable all built-in internationalization and resource loading.
     * See {@link Translations.getSpecialBundle} for handling identifiers with and without a dash.
     *
     * If internationalization is disabled, then the following variables should be overridden to reflect the current language of the system.
     * These variables are cleared when i18n is disabled (the list may not be exhaustive):
     * - {@link Editor.askZoomResource}
     * - {@link Editor.currentFileResource}
     * - {@link Editor.helpResource}
     * - {@link Editor.lastSavedResource}
     * - {@link Editor.outlineResource}
     * - {@link Editor.propertiesResource}
     * - {@link Editor.tasksResource}
     * - {@link ElbowEdgeHandler.doubleClickOrientationResource}
     * - {@link AbstractGraph.alreadyConnectedResource}.
     * - {@link AbstractGraph.collapseExpandResource}
     * - {@link AbstractGraph.containsValidationErrorsResource} and
     * - {@link GraphSelectionModel.doneResource}
     * - {@link GraphSelectionModel.updatingSelectionResource}
     * - {@link GraphView.doneResource}
     * - {@link GraphView.updatingDocumentResource}
     * - {@link GuiConfig.closeResource}
     * - {@link GuiConfig.errorResource}
     *
     * @param value The language to set. If `null` or `undefined`, use the preferred language of the navigator or 'en' as default.
     */
    setLanguage(value) {
        values.language = !(0, utils_js_1.isNullish)(value) ? value : getNavigatorLanguage();
    },
    /**
     * @see setLanguages
     */
    getLanguages() {
        return values.languages;
    },
    /**
     * Defines the optional array of all supported language extensions.
     * The default language does not have to be part of this list. See {@link Translations.isLanguageSupported}.
     *
     * This is used to avoid unnecessary requests to language files, i.e. if a 404 will be returned.
     * @default empty array
     */
    setLanguages(value) {
        if (!(0, utils_js_1.isNullish)(value)) {
            values.languages = value;
        }
    },
    /**
     * @see setDefaultLanguage
     */
    getDefaultLanguage() {
        return values.defaultLanguage;
    },
    /**
     * Defines the default language which is used in the common resource files.
     * Any resources for this language will only load the common resource file, but not the language-specific resource file.
     * @default 'en'
     */
    setDefaultLanguage(value) {
        values.defaultLanguage = !(0, utils_js_1.isNullish)(value) ? value : 'en';
    },
};