@atlaskit/tokens 13.0.3 → 13.1.0

package/dist/types-ts4.5/utils/hct-color-utils/sanitize-degrees-double.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sanitizes a degree measure as a floating-point number.
+ *
+ * @return a degree measure between 0.0 (inclusive) and 360.0
+ * (exclusive).
+ */
+export declare function sanitizeDegreesDouble(degrees: number): number;

package/dist/types-ts4.5/utils/hct-color-utils/signum.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The signum function.
+ *
+ * @return 1 if num > 0, -1 if num < 0, and 0 if num = 0
+ */
+export declare function signum(num: number): number;

package/dist/types-ts4.5/utils/hct-color-utils/viewing-conditions.d.ts

@@ -0,0 +1,47 @@
+export declare class ViewingConditions {
+    /**
+     * sRGB-like viewing conditions.
+     */
+    static DEFAULT: ViewingConditions;
+    /**
+     * Create ViewingConditions from a simple, physically relevant, set of
+     * parameters.
+     *
+     * @param whitePoint White point, measured in the XYZ color space.
+     *     default = D65, or sunny day afternoon
+     * @param adaptingLuminance The luminance of the adapting field. Informally,
+     *     how bright it is in the room where the color is viewed. Can be
+     *     calculated from lux by multiplying lux by 0.0586. default = 11.72,
+     *     or 200 lux.
+     * @param backgroundLstar The lightness of the area surrounding the color.
+     *     measured by L* in L*a*b*. default = 50.0
+     * @param surround A general description of the lighting surrounding the
+     *     color. 0 is pitch dark, like watching a movie in a theater. 1.0 is a
+     *     dimly light room, like watching TV at home at night. 2.0 means there
+     *     is no difference between the lighting on the color and around it.
+     *     default = 2.0
+     * @param discountingIlluminant Whether the eye accounts for the tint of the
+     *     ambient lighting, such as knowing an apple is still red in green light.
+     *     default = false, the eye does not perform this process on
+     *       self-luminous objects like displays.
+     */
+    static make(whitePoint?: number[], adaptingLuminance?: number, backgroundLstar?: number, surround?: number, discountingIlluminant?: boolean): ViewingConditions;
+    /**
+     * Parameters are intermediate values of the CAM16 conversion process. Their
+     * names are shorthand for technical color science terminology, this class
+     * would not benefit from documenting them individually. A brief overview
+     * is available in the CAM16 specification, and a complete overview requires
+     * a color science textbook, such as Fairchild's Color Appearance Models.
+     */
+    n: number;
+    aw: number;
+    nbb: number;
+    ncb: number;
+    c: number;
+    nc: number;
+    rgbD: number[];
+    fl: number;
+    fLRoot: number;
+    z: number;
+    private constructor();
+}

package/dist/types-ts4.5/utils/hex-to-rgba-values.d.ts

@@ -0,0 +1,6 @@
+export declare const hexToRGBAValues: (hex: string) => {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+};

package/dist/types-ts4.5/utils/hsl-to-rgb.d.ts

@@ -0,0 +1,5 @@
+export declare function HSLToRGB(h: number, s: number, l: number): [
+    number,
+    number,
+    number
+];

package/dist/types-ts4.5/utils/is-valid-brand-hex.d.ts

@@ -0,0 +1 @@
+export declare const isValidBrandHex: (hex: string) => boolean;

package/dist/types-ts4.5/utils/limit-size-of-custom-style-elements.d.ts

@@ -0,0 +1 @@
+export declare function limitSizeOfCustomStyleElements(sizeThreshold: number): void;

package/dist/types-ts4.5/utils/load-theme-css.d.ts

@@ -0,0 +1,2 @@
+import { type ThemeIdsWithOverrides } from '../theme-config';
+export declare const loadThemeCss: (themeId: ThemeIdsWithOverrides) => Promise<string>;

package/dist/types-ts4.5/utils/relative-luminance-w3-c.d.ts

@@ -0,0 +1 @@
+export declare function relativeLuminanceW3C(r: number, g: number, b: number): number;

package/dist/types-ts4.5/utils/rgb-to-hex.d.ts

@@ -0,0 +1 @@
+export declare function rgbToHex(r: number, g: number, b: number): string;

package/dist/types-ts4.5/utils/theme-loading.d.ts

@@ -1,5 +1,5 @@
 import { type ThemeIdsWithOverrides } from '../theme-config';
 export declare const loadAndAppendThemeCss: (themeId: ThemeIdsWithOverrides) => Promise<void>;
-export declare const loadThemeCss: (themeId: ThemeIdsWithOverrides) => Promise<string>;
 export declare const darkModeMediaQuery = "(prefers-color-scheme: dark)";
 export declare const moreContrastMediaQuery = "(prefers-contrast: more)";
+export { loadThemeCss } from './load-theme-css';

package/dist/types-ts4.5/utils/token-ids.d.ts

@@ -1,41 +1,3 @@
-/**
- * Transforms a style dictionary token path to a CSS custom property.
- *
- * A css prefix will be prepended and all [default] key words will be omitted
- * from the path
- *
- * @example <caption>Passing a path as an array</caption>
- * // Returns ds-background-bold
- * getCSSCustomProperty(['color', 'background', 'bold', '[default]'])
- *
- * @example <caption>Passing a path as a string</caption>
- * // Returns ds-background-bold
- * getCSSCustomProperty('color.background.bold.[default]')
- */
-export declare const getCSSCustomProperty: (path: string | string[]) => string;
-/**
- * Transforms a style dictionary token path to a shorthand token id
- * These ids will be typically be how tokens are interacted with via typescript and css
- *
- * All [default] key words will be omitted from the path
- *
- * @example <caption>Passing a path as an array</caption>
- * // Returns color.background.bold
- * getTokenId(['color', 'background', 'bold', '[default]'])
- *
- * @example <caption>Passing a path as a string</caption>
- * // Returns color.background.bold
- * getTokenId('color.background.bold.[default]')
- */
-export declare const getTokenId: (path: string | string[]) => string;
-/**
- * Transforms a style dictionary token path to a fully qualified token id
- * These Ids are intended to be used internal to this package by style-dictionary
- *
- * [default] key words will NOT be omitted from the path
- *
- * @example <caption>Passing a path as a string</caption>
- * // Returns color.background.bold.[default]
- * getFullyQualifiedTokenId(['color', 'background', 'bold', '[default]'])
- */
-export declare const getFullyQualifiedTokenId: (path: string[]) => string;
+export { getCSSCustomProperty } from './get-css-custom-property';
+export { getTokenId } from './get-token-id';
+export { getFullyQualifiedTokenId } from './get-fully-qualified-token-id';

package/figma/atlassian-dark-increased-contrast.json

@@ -1874,7 +1874,7 @@
       }
     },
     "Dark increased-contrast/color.background.disabled": {
-      "value": "#BDBDBD0A",
+      "value": "#E3E4F21F",
       "attributes": {
         "group": "paint",
         "state": "active",

package/figma/atlassian-dark.json

@@ -1880,7 +1880,7 @@
         "introduced": "0.0.15",
         "description": "Use for backgrounds of elements in a disabled state."
       },
-      "value": "#BDBDBD0A"
+      "value": "#E3E4F21F"
     },
     "Dark/color.background.input": {
       "attributes": {

package/figma/atlassian-light-increased-contrast.json

@@ -1874,7 +1874,7 @@
       }
     },
     "Light increased-contrast/color.background.disabled": {
-      "value": "#17171708",
+      "value": "#0515240F",
       "attributes": {
         "group": "paint",
         "state": "active",

package/figma/atlassian-light.json

@@ -1880,7 +1880,7 @@
         "introduced": "0.0.15",
         "description": "Use for backgrounds of elements in a disabled state."
       },
-      "value": "#17171708"
+      "value": "#0515240F"
     },
     "Light/color.background.input": {
       "attributes": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/tokens",
-	"version": "13.0.3",
+	"version": "13.1.0",
 	"description": "Design tokens are the single source of truth to name and store design decisions.",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -50,33 +50,33 @@
 	"devDependencies": {
 		"@af/formatting": "workspace:^",
 		"@af/visual-regression": "workspace:^",
-		"@atlaskit/avatar": "^25.14.0",
+		"@atlaskit/avatar": "^25.15.0",
 		"@atlaskit/button": "^23.11.0",
 		"@atlaskit/calendar": "^17.2.0",
 		"@atlaskit/checkbox": "^17.3.0",
 		"@atlaskit/code": "^17.5.0",
 		"@atlaskit/css": "^0.19.0",
 		"@atlaskit/docs": "^11.8.0",
-		"@atlaskit/dropdown-menu": "^16.8.0",
+		"@atlaskit/dropdown-menu": "^16.9.0",
 		"@atlaskit/dynamic-table": "^18.4.0",
 		"@atlaskit/form": "^15.5.0",
 		"@atlaskit/heading": "^5.4.0",
-		"@atlaskit/icon": "^34.3.0",
+		"@atlaskit/icon": "^35.3.0",
 		"@atlaskit/inline-message": "^15.6.0",
 		"@atlaskit/link": "^3.4.0",
 		"@atlaskit/lozenge": "^13.8.0",
-		"@atlaskit/popup": "^4.17.0",
+		"@atlaskit/popup": "^4.22.0",
 		"@atlaskit/primitives": "^19.0.0",
 		"@atlaskit/radio": "^8.6.0",
-		"@atlaskit/section-message": "^8.12.0",
-		"@atlaskit/select": "^21.10.0",
-		"@atlaskit/tag": "^14.13.0",
+		"@atlaskit/section-message": "^8.13.0",
+		"@atlaskit/select": "^21.12.0",
+		"@atlaskit/tag": "^14.14.0",
 		"@atlaskit/textarea": "^8.3.0",
 		"@atlaskit/textfield": "^8.3.0",
-		"@atlaskit/theme": "^23.2.0",
-		"@atlaskit/tooltip": "^21.2.0",
+		"@atlaskit/theme": "^25.0.0",
+		"@atlaskit/tooltip": "^22.4.0",
 		"@atlassian/codegen": "^0.2.0",
-		"@atlassian/feature-flags-test-utils": "^1.0.0",
+		"@atlassian/feature-flags-test-utils": "^1.1.0",
 		"@atlassian/react-compiler-gating": "workspace:^",
 		"@atlassian/structured-docs-types": "workspace:^",
 		"@atlassian/ts-loader": "^0.1.0",
@@ -92,7 +92,7 @@
 		"lodash": "^4.17.21",
 		"postcss": "^8.4.7",
 		"postcss-less": "^6.0.0",
-		"react": "^18.2.0",
+		"react": "^19.0.0",
 		"react-window": "^1.8.8",
 		"style-dictionary": "^3.8.0"
 	},

package/tokens.docs.tsx

@@ -1,53 +1,55 @@
 import path from 'path';
 
-import type { ComponentStructuredContentSource } from '@atlassian/structured-docs-types';
+import type { StructuredContentSource } from '@atlassian/structured-docs-types/types';
 
-const documentation: ComponentStructuredContentSource[] = [
-	{
-		name: 'token',
-		description:
-			'Design tokens provide consistent, semantic values for colors, spacing, typography, motion, and other design properties across the Atlassian Design System. Use tokens instead of hardcoded values to ensure consistency and proper theming.',
-		status: 'general-availability',
-		import: {
+const documentation: StructuredContentSource = {
+	components: [
+		{
 			name: 'token',
-			package: '@atlaskit/tokens',
-			type: 'named',
-			packagePath: path.resolve(__dirname),
-			packageJson: require('./package.json'),
-		},
-		usageGuidelines: [
-			'AVOID hardcoding any CSS values where a token exists for that type; in many cases you may be forced to use a token',
-			'Use the `token()` function with CSS-in-JS',
-			'Use semantic token names for better maintainability',
-		],
-		accessibilityGuidelines: [
-			'Use color tokens to ensure proper contrast ratios',
-			'Test color combinations for accessibility compliance',
-			'Use semantic color names (success, warning, danger) for better meaning',
-		],
-		examples: [
-			{
-				name: 'Basic',
-				description: 'Basic example',
-				source: path.resolve(__dirname, './examples/ai/basic.tsx'),
+			description:
+				'Design tokens provide consistent, semantic values for colors, spacing, typography, motion, and other design properties across the Atlassian Design System. Use tokens instead of hardcoded values to ensure consistency and proper theming.',
+			status: 'general-availability',
+			import: {
+				name: 'token',
+				package: '@atlaskit/tokens',
+				type: 'named',
+				packagePath: path.resolve(__dirname),
+				packageJson: require('./package.json'),
 			},
-		],
-		keywords: [
-			'token',
-			'design',
-			'system',
-			'color',
-			'motion',
-			'spacing',
-			'typography',
-			'radius',
-			'theme',
-			'css',
-			'style',
-			'variable',
-		],
-		categories: ['tokens'],
-	},
-];
+			usageGuidelines: [
+				'AVOID hardcoding any CSS values where a token exists for that type; in many cases you may be forced to use a token',
+				'Use the `token()` function with CSS-in-JS',
+				'Use semantic token names for better maintainability',
+			],
+			accessibilityGuidelines: [
+				'Use color tokens to ensure proper contrast ratios',
+				'Test color combinations for accessibility compliance',
+				'Use semantic color names (success, warning, danger) for better meaning',
+			],
+			examples: [
+				{
+					name: 'Basic',
+					description: 'Basic example',
+					source: path.resolve(__dirname, './examples/ai/basic.tsx'),
+				},
+			],
+			keywords: [
+				'token',
+				'design',
+				'system',
+				'color',
+				'motion',
+				'spacing',
+				'typography',
+				'radius',
+				'theme',
+				'css',
+				'style',
+				'variable',
+			],
+			categories: ['tokens'],
+		},
+	],
+};
 
 export default documentation;