mirror of
https://github.com/google/blockly.git
synced 2026-01-10 18:37:09 +01:00
a677355f73
* fix: Restore HSV_SATURATION and HSV_VALUE accessors Contrary to the notice at the top of the `Object.defineProperties` call, these were not actually marked as deprecated, and their removal in Blockly 10.0.0 constituted an avoidable zero-notice breaking change. * deprecate: Add deprecation notices for HSV_SATURATION and HSV_VALUE DEPRECATION: Blockly.HSV_SATURATION and Blockly.HSV_VALUE are deprecated and will be removed in a future version of Blockly. Use Blockly.colour.getHsvSaturation / Blockly.colour.setHsvSaturation and Blockly.colour.getHsvValue / Blockly.colour.setHsvValue instead.
105 lines
3.1 KiB
JavaScript
105 lines
3.1 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2022 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview The entrypoint for blockly_compressed.js. Provides
|
|
* various backwards-compatibility hacks. Not used when loading
|
|
* in uncompiled (uncompressed) mode via bootstrap.js.
|
|
*/
|
|
'use strict';
|
|
|
|
goog.module('Blockly.main');
|
|
|
|
const Blockly = goog.require('Blockly');
|
|
const Msg = goog.require('Blockly.Msg');
|
|
const colour = goog.require('Blockly.utils.colour');
|
|
const deprecation = goog.require('Blockly.utils.deprecation');
|
|
|
|
/*
|
|
* Aliased functions and properties that used to be on the Blockly namespace.
|
|
* Everything in this section is deprecated. Both external and internal code
|
|
* should avoid using these functions and use the designated replacements.
|
|
* Everything in this section will be removed in a future version of Blockly.
|
|
*/
|
|
|
|
// Add accessors for properties on Blockly that have now been deprecated.
|
|
Object.defineProperties(Blockly, {
|
|
/**
|
|
* The richness of block colours, regardless of the hue.
|
|
* Must be in the range of 0 (inclusive) to 1 (exclusive).
|
|
* @name Blockly.HSV_SATURATION
|
|
* @type {number}
|
|
* @deprecated Use Blockly.colour.getHsvSaturation() / .setHsvSaturation(
|
|
* instead. (July 2023)
|
|
* @suppress {checkTypes}
|
|
*/
|
|
HSV_SATURATION: {
|
|
get: function () {
|
|
deprecation.warn(
|
|
'Blockly.HSV_SATURATION',
|
|
'version 10',
|
|
'version 11',
|
|
'Blockly.colour.getHsvSaturation()'
|
|
);
|
|
return colour.getHsvSaturation();
|
|
},
|
|
set: function (newValue) {
|
|
deprecation.warn(
|
|
'Blockly.HSV_SATURATION',
|
|
'version 10',
|
|
'version 11',
|
|
'Blockly.colour.setHsvSaturation()'
|
|
);
|
|
colour.setHsvSaturation(newValue);
|
|
},
|
|
},
|
|
/**
|
|
* The intensity of block colours, regardless of the hue.
|
|
* Must be in the range of 0 (inclusive) to 1 (exclusive).
|
|
* @name Blockly.HSV_VALUE
|
|
* @type {number}
|
|
* @deprecated Use Blockly.colour.getHsvValue() / .setHsvValue instead.
|
|
* (July 2023)
|
|
* @suppress {checkTypes}
|
|
*/
|
|
HSV_VALUE: {
|
|
get: function () {
|
|
deprecation.warn(
|
|
'Blockly.HSV_VALUE',
|
|
'version 10',
|
|
'version 11',
|
|
'Blockly.colour.getHsvValue()'
|
|
);
|
|
return colour.getHsvValue();
|
|
},
|
|
set: function (newValue) {
|
|
deprecation.warn(
|
|
'Blockly.HSV_VALUE',
|
|
'version 10',
|
|
'version 11',
|
|
'Blockly.colour.setHsvValue()'
|
|
);
|
|
colour.setHsvValue(newValue);
|
|
},
|
|
},
|
|
});
|
|
|
|
// If Blockly is compiled with ADVANCED_COMPILATION and/or loaded as a
|
|
// CJS or ES module there will not be a Blockly global variable
|
|
// created. This can cause problems because a very common way of
|
|
// loading translations is to use a <script> tag to load one of
|
|
// the generated msg/*.js files, which consists of lines like:
|
|
//
|
|
// Blockly.Msg["ADD_COMMENT"] = "Add Comment";
|
|
// Blockly.Msg["CLEAN_UP"] = "Clean up Blocks";
|
|
//
|
|
// This obviously only works if Blockly.Msg is the Msg export from the
|
|
// Blockly.Msg module - so make sure it is, but only if there is not
|
|
// yet a Blockly global variable.
|
|
if (!('Blockly' in globalThis)) {
|
|
globalThis['Blockly'] = {'Msg': Msg};
|
|
}
|