Export v8.json file as latest.json in dist folder

CHANGELOG.md

@@ -2,9 +2,11 @@
 
 ### ✨ Features and improvements
 
+- Add `latest.json` to dist folder to allow using the full version of the spec [#490](https://github.com/maplibre/maplibre-style-spec/pull/490)
 - _...Add new stuff here..._
 
 ### 🐞 Bug fixes
+
 - _...Add new stuff here..._
 
 ## 20.0.0

package.json

@@ -17,7 +17,7 @@
   "types": "./dist/index.d.ts",
   "type": "module",
   "scripts": {
-    "build": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.ts",
+    "build": "rollup --configPlugin @rollup/plugin-typescript -c rollup.config.ts && cp ./src/reference/v8.json ./dist/latest.json",
     "generate-style-spec": "node --no-warnings --loader ts-node/esm build/generate-style-spec.ts",
     "generate-typings": "node --no-warnings --loader ts-node/esm build/generate-typings.ts",
     "test-build": "jest --selectProjects=build",

src/validate/validate.ts

@@ -52,17 +52,28 @@
     'sprite': validateSprite,
 };
 
-// Main recursive validation function. Tracks:
-//
-// - key: string representing location of validation in style tree. Used only
-//   for more informative error reporting.
-// - value: current value from style being evaluated. May be anything from a
-//   high level object that needs to be descended into deeper or a simple
-//   scalar value.
-// - valueSpec: current spec being evaluated. Tracks value.
-// - styleSpec: current full spec being evaluated.
-
-export default function validate(options) {
+/**
+ * Main recursive validation function used internally.
+ * You should use `validateStyleMin` in the browser or `validateStyle` in node env.
+ * Tracks:
+ * - key: string representing location of validation in style tree. Used only
+ *   for more informative error reporting.
+ * - value: current value from style being evaluated. May be anything from a
+ *   high level object that needs to be descended into deeper or a simple
+ *   scalar value.
+ * - valueSpec: current spec being evaluated. Tracks value.
+ * - styleSpec: current full spec being evaluated.
+ * @param options 
+ * @returns 
+ */
+export default function validate(options: {
+        key: any, 
+        value: any; 
+        valueSpec: any; 
+        styleSpec: any, 
+        validateSpec?: any, 
+        style: any,
+        objectElementValidators?: any}) {
     const value = options.value;
     const valueSpec = options.valueSpec;
     const styleSpec = options.styleSpec;

src/validate/validate_object.ts

@@ -10,7 +10,7 @@ export default function validateObject(options): Array<ValidationError> {
     const style = options.style;
     const styleSpec = options.styleSpec;
     const validateSpec = options.validateSpec;
-    let errors = [] as Array<ValidationError>;
+    let errors: ValidationError[] = [];
 
     const type = getType(object);
     if (type !== 'object') {

src/validate_style.min.ts

@@ -11,28 +11,26 @@ import validateLayer from './validate/validate_layer';
 import validateFilter from './validate/validate_filter';
 import validatePaintProperty from './validate/validate_paint_property';
 import validateLayoutProperty from './validate/validate_layout_property';
-import type {StyleSpecification} from './types.g';
 import validateSprite from './validate/validate_sprite';
 import validateGlyphsUrl from './validate/validate_glyphs_url';
+import ValidationError from './error/validation_error';
+import type {StyleSpecification} from './types.g';
 
 /**
- * Validate a MapLibre style against the style specification. This entrypoint,
- * `maplibre-gl-style-spec/lib/validate_style.min`, is designed to produce as
- * small a browserify bundle as possible by omitting unnecessary functionality
- * and legacy style specifications.
- *
- * @private
- * @param {Object} style The style to be validated.
- * @param {Object} [styleSpec] The style specification to validate against.
+ * Validate a MapLibre style against the style specification.
+ * Use this when running in the browser.
+ * 
+ * @param style - The style to be validated.
+ * @param styleSpec - The style specification to validate against.
  *     If omitted, the latest style spec is used.
- * @returns {Array<ValidationError>}
+ * @returns an array of errors, or an empty array if no errors are found.
  * @example
- *   var validate = require('maplibre-gl-style-spec/lib/validate_style.min');
- *   var errors = validate(style);
+ *   const validate = require('@maplibre/maplibre-gl-style-spec/').validateStyleMin;
+ *   const errors = validate(style);
  */
-function validateStyleMin(style: StyleSpecification, styleSpec = latestStyleSpec) {
+function validateStyleMin(style: StyleSpecification, styleSpec = latestStyleSpec): Array<ValidationError> {
 
-    let errors = [];
+    let errors: ValidationError[] = [];
 
     errors = errors.concat(validate({
         key: '',

src/validate_style.ts

@@ -5,19 +5,17 @@ import readStyle from './read_style';
 import type {StyleSpecification} from './types.g';
 
 /**
- * Validate a Mapbox GL style against the style specification.
+ * Validate a Maplibre GL style against the style specification.
  *
- * @private
- * @alias validate
- * @param {StyleSpecification|string|Buffer} style The style to be validated. If a `String`
- *     or `Buffer` is provided, the returned errors will contain line numbers.
- * @param {Object} [styleSpec] The style specification to validate against.
- *     If omitted, the spec version is inferred from the stylesheet.
- * @returns {Array<ValidationError|ParsingError>}
+ * @param style - The style to be validated. If a `String` or `Buffer` is provided, 
+ * the returned errors will contain line numbers.
+ * @param styleSpec - The style specification to validate against.
+ * If omitted, the spec version is inferred from the stylesheet.
+ * @returns an array of errors, or an empty array if no errors are found.
  * @example
- *   var validate = require('maplibre-gl-style-spec').validate;
- *   var style = fs.readFileSync('./style.json', 'utf8');
- *   var errors = validate(style);
+ *   const validate = require('maplibre-gl-style-spec').validate;
+ *   const style = fs.readFileSync('./style.json', 'utf8');
+ *   const errors = validate(style);
  */
 
 export default function validateStyle(style: StyleSpecification | string | Buffer, styleSpec = v8): Array<ValidationError> {