@mapbox/mapbox-gl-style-spec 14.14.0-beta.2 → 14.15.0-alpha.ffa987fef46

package/expression/compound_expression.ts

@@ -85,7 +85,7 @@ class CompoundExpression implements Expression {
 
             // Use a fresh context for each attempted signature so that, if
             // we eventually succeed, we haven't polluted `context.errors`.
-            signatureContext = new ParsingContext(context.registry, context.path, null, context.scope, undefined, context._scope, context.options);
+            signatureContext = new ParsingContext(context.registry, context.path, null, context.scope, undefined, context._scope, context.options, context.iconImageUseTheme);
 
             // First parse all the args, potentially coercing to the
             // types expected by this overload.

package/expression/definitions/config.ts

@@ -12,7 +12,7 @@ import type EvaluationContext from '../evaluation_context';
 
 const FQIDSeparator = '\u001F';
 
-function makeConfigFQID(id: string, ownScope?: string | null, contextScope?: string | null): string {
+export function makeConfigFQID(id: string, ownScope?: string | null, contextScope?: string | null): string {
     return [id, ownScope, contextScope].filter(Boolean).join(FQIDSeparator);
 }
 

package/expression/definitions/distance.ts

@@ -142,12 +142,11 @@ function getLngLatPoint(coord: Point, canonical: CanonicalTileID) {
     return [lngFromMercatorX(x), latFromMercatorY(y)];
 }
 
-function getLngLatPoints(coordinates: Array<Point>, canonical: CanonicalTileID) {
-    const coords = [];
+function getLngLatPoints(coordinates: Array<Point>, canonical: CanonicalTileID): number[][] {
+    const coords: number[][] = [];
     for (let i = 0; i < coordinates.length; ++i) {
         coords.push(getLngLatPoint(coordinates[i], canonical));
     }
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
     return coords;
 }
 

package/expression/definitions/image.ts

@@ -2,9 +2,9 @@ import ResolvedImage from '../types/resolved_image';
 import {ImageId} from '../types/image_id';
 import {ColorType, ResolvedImageType, StringType} from '../types';
 
+import type EvaluationContext from '../evaluation_context';
 import type Color from '../../util/color';
 import type ParsingContext from '../parsing_context';
-import type EvaluationContext from '../evaluation_context';
 import type {Type} from '../types';
 import type {Expression, SerializedExpression} from '../expression';
 

package/expression/definitions/index.ts

@@ -120,30 +120,16 @@ function hsla(ctx: EvaluationContext, [h, s, l, a]: Expression[]) {
     return color;
 }
 
-function has(
-    key: string,
-    obj: {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        [key: string]: any;
-    },
-): boolean {
+function has<T extends object>(key: keyof T, obj: T): boolean {
     return key in obj;
 }
 
-function get(key: string, obj: {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    [key: string]: any;
-}) {
+function get<T extends object>(key: keyof T, obj: T): T[keyof T] | null {
     const v = obj[key];
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
     return typeof v === 'undefined' ? null : v;
 }
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function binarySearch(v: any, a: {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    [key: number]: any;
-}, i: number, j: number) {
+function binarySearch(v: unknown, a: Record<number, unknown>, i: number, j: number): boolean {
     while (i <= j) {
         const m = (i + j) >> 1;
         if (a[m] === v)
@@ -237,7 +223,6 @@ CompoundExpression.register(expressions, {
         overloads: [
             [
                 [StringType],
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
                 (ctx, [key]) => get(key.evaluate(ctx), ctx.properties())
             ], [
                 [StringType, ObjectType],
@@ -249,8 +234,7 @@ CompoundExpression.register(expressions, {
     'feature-state': [
         ValueType,
         [StringType],
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-        (ctx, [key]) => get(key.evaluate(ctx), ctx.featureState || {})
+        (ctx, [key]) => get(key.evaluate(ctx), ctx.featureState || {}) as Value
     ],
     'properties': [
         ObjectType,

package/expression/definitions/interpolate.ts

@@ -157,20 +157,17 @@ class Interpolate implements Expression {
         const outputs = this.outputs;
 
         if (labels.length === 1) {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-            return outputs[0].evaluate(ctx);
+            return outputs[0].evaluate(ctx) as Color;
         }
 
-        const value = (this.input.evaluate(ctx) as number);
+        const value: number = this.input.evaluate(ctx);
         if (value <= labels[0]) {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-            return outputs[0].evaluate(ctx);
+            return outputs[0].evaluate(ctx) as Color;
         }
 
         const stopCount = labels.length;
         if (value >= labels[stopCount - 1]) {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-            return outputs[stopCount - 1].evaluate(ctx);
+            return outputs[stopCount - 1].evaluate(ctx) as Color;
         }
 
         const index = findStopLessThanOrEqualTo(labels, value);
@@ -178,8 +175,8 @@ class Interpolate implements Expression {
         const upper = labels[index + 1];
         const t = Interpolate.interpolationFactor(this.interpolation, value, lower, upper);
 
-        const outputLower = outputs[index].evaluate(ctx);
-        const outputUpper = outputs[index + 1].evaluate(ctx);
+        const outputLower: Color = outputs[index].evaluate(ctx);
+        const outputUpper: Color = outputs[index + 1].evaluate(ctx);
 
         if (this.operator === 'interpolate') {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-return

package/expression/definitions/within.ts

@@ -2,11 +2,11 @@ import {isValue} from '../values';
 import {BooleanType} from '../types';
 import {updateBBox, boxWithinBox, pointWithinPolygon, segmentIntersectSegment} from '../../util/geometry_util';
 
+import type Point from '@mapbox/point-geometry';
 import type {Type} from '../types';
 import type {Expression, SerializedExpression} from '../expression';
 import type ParsingContext from '../parsing_context';
 import type EvaluationContext from '../evaluation_context';
-import type Point from '@mapbox/point-geometry';
 import type {CanonicalTileID} from '../../types/tile_id';
 import type {BBox} from '../../util/geometry_util';
 
@@ -74,10 +74,10 @@ function lineStringWithinPolygons(line: Array<GeoJSON.Position>, polygons: Array
     return false;
 }
 
-function getTilePolygon(coordinates: Array<Array<GeoJSON.Position>>, bbox: BBox, canonical: CanonicalTileID) {
-    const polygon = [];
+function getTilePolygon(coordinates: Array<Array<GeoJSON.Position>>, bbox: BBox, canonical: CanonicalTileID): Array<Array<number[]>> {
+    const polygon: Array<Array<number[]>> = [];
     for (let i = 0; i < coordinates.length; i++) {
-        const ring = [];
+        const ring: number[][] = [];
         for (let j = 0; j < coordinates[i].length; j++) {
             const coord = getTileCoordinates(coordinates[i][j], canonical);
             updateBBox(bbox, coord);
@@ -85,17 +85,17 @@ function getTilePolygon(coordinates: Array<Array<GeoJSON.Position>>, bbox: BBox,
         }
         polygon.push(ring);
     }
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+
     return polygon;
 }
 
-function getTilePolygons(coordinates: Array<Array<Array<GeoJSON.Position>>>, bbox: BBox, canonical: CanonicalTileID) {
-    const polygons = [];
+function getTilePolygons(coordinates: Array<Array<Array<GeoJSON.Position>>>, bbox: BBox, canonical: CanonicalTileID): Array<Array<Array<number[]>>> {
+    const polygons: Array<Array<Array<number[]>>> = [];
     for (let i = 0; i < coordinates.length; i++) {
         const polygon = getTilePolygon(coordinates[i], bbox, canonical);
         polygons.push(polygon);
     }
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+
     return polygons;
 }
 
@@ -116,11 +116,10 @@ function resetBBox(bbox: BBox) {
     bbox[2] = bbox[3] = -Infinity;
 }
 
-function getTilePoints(geometry: Array<Array<Point>> | null | undefined, pointBBox: BBox, polyBBox: Array<number>, canonical: CanonicalTileID) {
+function getTilePoints(geometry: Array<Array<Point>> | null | undefined, pointBBox: BBox, polyBBox: Array<number>, canonical: CanonicalTileID): Array<number[]> {
     const worldSize = Math.pow(2, canonical.z) * EXTENT;
     const shifts = [canonical.x * EXTENT, canonical.y * EXTENT];
-    const tilePoints = [];
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    const tilePoints: Array<number[]> = [];
     if (!geometry) return tilePoints;
     for (const points of geometry) {
         for (const point of points) {
@@ -129,11 +128,11 @@ function getTilePoints(geometry: Array<Array<Point>> | null | undefined, pointBB
             tilePoints.push(p);
         }
     }
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+
     return tilePoints;
 }
 
-function getTileLines(geometry: Array<Array<Point>> | null | undefined, lineBBox: BBox, polyBBox: Array<number>, canonical: CanonicalTileID) {
+function getTileLines(geometry: Array<Array<Point>> | null | undefined, lineBBox: BBox, polyBBox: Array<number>, canonical: CanonicalTileID): Array<Array<GeoJSON.Position>> {
     const worldSize = Math.pow(2, canonical.z) * EXTENT;
     const shifts = [canonical.x * EXTENT, canonical.y * EXTENT];
     const tileLines: Array<Array<GeoJSON.Position>> = [];
@@ -158,7 +157,7 @@ function getTileLines(geometry: Array<Array<Point>> | null | undefined, lineBBox
     return tileLines;
 }
 
-function pointsWithinPolygons(ctx: EvaluationContext, polygonGeometry: GeoJSONPolygons) {
+function pointsWithinPolygons(ctx: EvaluationContext, polygonGeometry: GeoJSONPolygons): boolean {
     const pointBBox: BBox = [Infinity, Infinity, -Infinity, -Infinity];
     const polyBBox: BBox = [Infinity, Infinity, -Infinity, -Infinity];
 
@@ -189,7 +188,7 @@ function pointsWithinPolygons(ctx: EvaluationContext, polygonGeometry: GeoJSONPo
     return true;
 }
 
-function linesWithinPolygons(ctx: EvaluationContext, polygonGeometry: GeoJSONPolygons) {
+function linesWithinPolygons(ctx: EvaluationContext, polygonGeometry: GeoJSONPolygons): boolean {
     const lineBBox: BBox = [Infinity, Infinity, -Infinity, -Infinity];
     const polyBBox: BBox = [Infinity, Infinity, -Infinity, -Infinity];
 

package/expression/evaluation_context.ts

@@ -21,12 +21,13 @@ class EvaluationContext {
     featureDistanceData: FeatureDistanceData | null | undefined;
     scope: string | null | undefined;
     options: ConfigOptions | null | undefined;
+    iconImageUseTheme: string | null | undefined;
 
     _parseColorCache: {
         [_: string]: Color | null | undefined;
     };
 
-    constructor(scope?: string | null, options?: ConfigOptions | null) {
+    constructor(scope?: string | null, options?: ConfigOptions | null, iconImageUseTheme?: string) {
         this.globals = null;
         this.feature = null;
         this.featureState = null;
@@ -38,6 +39,7 @@ class EvaluationContext {
         this.featureDistanceData = null;
         this.scope = scope;
         this.options = options;
+        this.iconImageUseTheme = iconImageUseTheme;
     }
 
     id(): string | number | null {

package/expression/index.ts

@@ -72,10 +72,10 @@ export class StyleExpression {
     _enumValues?: {[_: string]: unknown};
     configDependencies: Set<string>;
 
-    constructor(expression: Expression, propertySpec?: StylePropertySpecification, scope?: string, options?: ConfigOptions) {
+    constructor(expression: Expression, propertySpec?: StylePropertySpecification, scope?: string, options?: ConfigOptions, iconImageUseTheme?: string) {
         this.expression = expression;
         this._warningHistory = {};
-        this._evaluator = new EvaluationContext(scope, options);
+        this._evaluator = new EvaluationContext(scope, options, iconImageUseTheme);
         this._defaultValue = propertySpec ? getDefaultValue(propertySpec) : null;
         this._enumValues = propertySpec && propertySpec.type === 'enum' ? propertySpec.values : null;
         this.configDependencies = isConstant.getConfigDependencies(expression);
@@ -113,6 +113,7 @@ export class StyleExpression {
         formattedSection?: FormattedSection,
         featureTileCoord?: Point,
         featureDistanceData?: FeatureDistanceData,
+        iconImageUseTheme?: string
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ): any {
         this._evaluator.globals = globals;
@@ -123,6 +124,7 @@ export class StyleExpression {
         this._evaluator.formattedSection = formattedSection || null;
         this._evaluator.featureTileCoord = featureTileCoord || null;
         this._evaluator.featureDistanceData = featureDistanceData || null;
+        this._evaluator.iconImageUseTheme = iconImageUseTheme || null;
 
         try {
             const val = this.expression.evaluate(this._evaluator);
@@ -165,8 +167,9 @@ export function createExpression(
     propertySpec?: StylePropertySpecification | null,
     scope?: string | null,
     options?: ConfigOptions | null,
+    iconImageUseTheme?: string | null
 ): Result<StyleExpression, Array<ParsingError>> {
-    const parser = new ParsingContext(definitions, [], propertySpec ? getExpectedType(propertySpec) : undefined, undefined, undefined, scope, options);
+    const parser = new ParsingContext(definitions, [], propertySpec ? getExpectedType(propertySpec) : undefined, undefined, undefined, scope, options, iconImageUseTheme);
 
     // For string-valued properties, coerce to string at the top level rather than asserting.
     const parsed = parser.parse(expression, undefined, undefined, undefined,
@@ -177,7 +180,7 @@ export function createExpression(
         return error(parser.errors);
     }
 
-    return success(new StyleExpression(parsed, propertySpec, scope, options));
+    return success(new StyleExpression(parsed, propertySpec, scope, options, iconImageUseTheme));
 }
 
 export class ZoomConstantExpression<Kind extends EvaluationKind> {
@@ -216,9 +219,10 @@ export class ZoomConstantExpression<Kind extends EvaluationKind> {
         canonical?: CanonicalTileID,
         availableImages?: ImageId[],
         formattedSection?: FormattedSection,
+        iconImageUseTheme?: string
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ): any {
-        return this._styleExpression.evaluate(globals, feature, featureState, canonical, availableImages, formattedSection);
+        return this._styleExpression.evaluate(globals, feature, featureState, canonical, availableImages, formattedSection, undefined, undefined, iconImageUseTheme);
     }
 }
 
@@ -286,6 +290,8 @@ export type ConstantExpression = {
         featureState?: FeatureState,
         canonical?: CanonicalTileID,
         availableImages?: ImageId[],
+        formattedSection?: FormattedSection,
+        iconImageUseTheme?: string
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ) => any;
 };
@@ -337,6 +343,7 @@ export interface CompositeExpression {
         canonical?: CanonicalTileID,
         availableImages?: ImageId[],
         formattedSection?: FormattedSection,
+        iconImageUseTheme?: string
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ) => any;
     readonly interpolationFactor: (input: number, lower: number, upper: number) => number;
@@ -352,11 +359,11 @@ export function createPropertyExpression(
     propertySpec: StylePropertySpecification,
     scope?: string | null,
     options?: ConfigOptions | null,
+    iconImageUseTheme?: string | null
 ): Result<StylePropertyExpression, Array<ParsingError>> {
-    expression = createExpression(expression, propertySpec, scope, options);
+    expression = createExpression(expression, propertySpec, scope, options, iconImageUseTheme);
     if (expression.result === 'error') {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-        return expression;
+        return expression as Result<StylePropertyExpression, Array<ParsingError>>;
     }
 
     const parsed = expression.value.expression;
@@ -447,12 +454,13 @@ export function normalizePropertyExpression<T>(
     specification: StylePropertySpecification,
     scope?: string | null,
     options?: ConfigOptions | null,
+    iconImageUseTheme?: string | null
 ): StylePropertyExpression {
     if (isFunction(value)) {
         return new StylePropertyFunction(value, specification) as unknown as StylePropertyExpression;
 
     } else if (isExpression(value) || (Array.isArray(value) && value.length > 0)) {
-        const expression = createPropertyExpression(value, specification, scope, options);
+        const expression = createPropertyExpression(value, specification, scope, options, iconImageUseTheme);
         if (expression.result === 'error') {
             // this should have been caught in validation
             throw new Error(expression.value.map(err => `${err.key}: ${err.message}`).join(', '));
@@ -476,7 +484,7 @@ export function normalizePropertyExpression<T>(
 // expression (collectively referred to as a "curve"). The curve may be wrapped in one or more "let" or
 // "coalesce" expressions.
 function findZoomCurve(expression: Expression): Step | Interpolate | ParsingError | null {
-    let result = null;
+    let result: Step | Interpolate | ParsingError | null = null;
     if (expression instanceof Let) {
         result = findZoomCurve(expression.result);
 
@@ -508,7 +516,6 @@ function findZoomCurve(expression: Expression): Step | Interpolate | ParsingErro
         }
     });
 
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
     return result;
 }
 

package/expression/parsing_context.ts

@@ -29,6 +29,7 @@ class ParsingContext {
     errors: Array<ParsingError>;
     _scope: string | null | undefined;
     options: ConfigOptions | null | undefined;
+    iconImageUseTheme: string;
 
     // The expected type of this expression. Provided only to allow Expression
     // implementations to infer argument types: Expression#parse() need not
@@ -43,7 +44,8 @@ class ParsingContext {
         scope: Scope = new Scope(),
         errors: Array<ParsingError> = [],
         _scope?: string | null,
-        options?: ConfigOptions | null
+        options?: ConfigOptions | null,
+        iconImageUseTheme?: string
     ) {
         this.registry = registry;
         this.path = path;
@@ -53,6 +55,7 @@ class ParsingContext {
         this.expectedType = expectedType;
         this._scope = _scope;
         this.options = options;
+        this.iconImageUseTheme = iconImageUseTheme;
     }
 
     /**
@@ -154,7 +157,7 @@ class ParsingContext {
                 // parsed/compiled result. Expressions that expect an image should
                 // not be resolved here so we can later get the available images.
                 if (!(parsed instanceof Literal) && (parsed.type.kind !== 'resolvedImage') && isConstant(parsed)) {
-                    const ec = new EvaluationContext(this._scope, this.options);
+                    const ec = new EvaluationContext(this._scope, this.options, this.iconImageUseTheme);
                     try {
                         parsed = new Literal(parsed.type, parsed.evaluate(ec));
                     } catch (e) {
@@ -201,7 +204,8 @@ class ParsingContext {
             scope,
             this.errors,
             this._scope,
-            this.options
+            this.options,
+            this.iconImageUseTheme
         );
     }
 

package/group_by_layout.ts

@@ -2,8 +2,7 @@ import refProperties from './util/ref_properties';
 
 import type {LayerSpecification} from './types';
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function stringify(obj: any) {
+function stringify(obj: unknown) {
     if (typeof obj === 'number' || typeof obj === 'boolean' || typeof obj === 'string' || obj === undefined || obj === null)
         return JSON.stringify(obj);
 
@@ -30,8 +29,7 @@ function getKey(layer: LayerSpecification) {
     return key;
 }
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function containsKey(obj: any, key: string) {
+function containsKey(obj: unknown, key: string) {
     function recursiveSearch(item) {
         if (typeof item === 'string' && item === key) {
             return true;
@@ -106,12 +104,11 @@ export default function groupByLayout(
         group.push(layer);
     }
 
-    const result = [];
+    const result: LayerSpecification[][] = [];
 
     for (const k in groups) {
         result.push(groups[k]);
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
     return result;
 }

package/migrate.ts

@@ -1,9 +1,8 @@
-/* eslint-disable @typescript-eslint/ban-ts-comment */
-// @ts-nocheck
-
 import migrateToV8 from './migrate/v8';
 import migrateToExpressions from './migrate/expressions';
 
+import type {StyleSpecification} from './types';
+
 /**
  * Migrate a Mapbox GL Style to the latest version.
  *
@@ -17,7 +16,7 @@ import migrateToExpressions from './migrate/expressions';
  * var style = fs.readFileSync('./style.json', 'utf8');
  * fs.writeFileSync('./style.json', JSON.stringify(migrate(style)));
  */
-export default function (style) {
+export default function (style: {version: 7} | StyleSpecification): StyleSpecification {
     let migrated = false;
 
     if (style.version === 7) {
@@ -26,14 +25,13 @@ export default function (style) {
     }
 
     if (style.version === 8) {
-        migrated = migrateToExpressions(style);
+        style = migrateToExpressions(style);
         migrated = true;
     }
 
     if (!migrated) {
-        throw new Error('cannot migrate from', style.version);
+        throw new Error(`Cannot migrate from ${style.version}`);
     }
 
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-    return style;
+    return style as StyleSpecification;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapbox/mapbox-gl-style-spec",
-  "version": "14.14.0-beta.2",
+  "version": "14.15.0-alpha.ffa987fef46",
   "description": "a specification for mapbox gl styles",
   "author": "Mapbox",
   "license": "SEE LICENSE IN LICENSE.txt",

package/read_style.ts

@@ -6,8 +6,7 @@ import type {StyleSpecification} from './types';
 export default function readStyle(style: string | Buffer | StyleSpecification): StyleSpecification {
     if (style instanceof String || typeof style === 'string' || ArrayBuffer.isView(style)) {
         try {
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-            return jsonlint.parse(style.toString());
+            return jsonlint.parse(style.toString()) as StyleSpecification;
         } catch (e) {
             throw new ParsingError(e);
         }

package/reference/v8.json

@@ -1553,6 +1553,27 @@
     "paint": {
       "type": "paint",
       "doc": "Default paint properties for this layer."
+    },
+    "appearances": {
+      "type": "array",
+      "value": "appearance",
+      "supported-layer-types": ["symbol"],
+      "private": true,
+      "doc": "Conditional styling applied to layer features based on dynamic conditions. If multiple conditions are true, only the first matching appearance will be applied. Only properties marked with 'Can be used in appearances' are supported."
+    }
+  },
+  "appearance": {
+    "condition": {
+      "type": "expression",
+      "doc": "A boolean expression that determines when this appearance should be applied."
+    },
+    "name": {
+      "type": "string",
+      "doc": "Optional name for this appearance. Non-empty names should be unique within a layer."
+    },
+    "properties": {
+      "type": "*",
+      "doc": "Style properties to apply when the condition is met."
     }
   },
   "layout": [
@@ -2789,6 +2810,7 @@
       "minimum": 0,
       "units": "factor of the original icon size",
       "doc": "Scales the original size of the icon by the provided factor. The new pixel size of the image will be the original pixel size multiplied by `icon-size`. 1 is the original size; 3 triples the size of the image.",
+      "appearance": true,
       "requires": [
         "icon-image"
       ],
@@ -2932,6 +2954,8 @@
       "type": "resolvedImage",
       "doc": "Name of image in sprite to use for drawing an image background.",
       "tokens": true,
+      "appearance": true,
+      "use-theme": true,
       "sdk-support": {
         "basic functionality": {
           "js": "0.10.0",
@@ -2959,6 +2983,7 @@
       "period": 360,
       "units": "degrees",
       "doc": "Rotates the icon clockwise.",
+      "appearance": true,
       "requires": [
         "icon-image"
       ],
@@ -3047,6 +3072,7 @@
         0
       ],
       "doc": "Offset distance of icon from its anchor. Positive values indicate right and down, while negative values indicate left and up. Each component is multiplied by the value of `icon-size` to obtain the final offset in pixels. When combined with `icon-rotate` the offset will be as if the rotated direction was up.",
+      "appearance": true,
       "requires": [
         "icon-image"
       ],