@atlaskit/tokens 0.3.0 → 0.5.0

package/dist/types/types.d.ts

@@ -1,24 +1,57 @@
-export interface Token<TValue, Group extends string> {
+import { ActiveTokens } from './artifacts/types';
+export declare type Groups = 'raw' | 'paint' | 'shadow' | 'palette';
+export declare type ActiveTokenStates = 'active';
+export declare type ReplacedTokenStates = 'deprecated' | 'deleted';
+export declare type TokenState = ActiveTokenStates | ReplacedTokenStates;
+export declare type Replacement = ActiveTokens[];
+export interface Token<TValue, Group extends Groups> {
     value: TValue;
     attributes: {
-        group?: Group;
+        group: Group;
         description?: string;
+        state?: TokenState;
+        replacement?: Replacement;
     };
 }
-export declare type ColorPalette = keyof PaletteColorTokenSchema['color']['palette'];
-export declare type PaintToken<Value extends string = ColorPalette> = Token<Value, 'paint'>;
-export declare type PaletteToken = Token<string, 'paint'> & {
+/**
+ * Base tokens define the raw values consumed by Design Tokens. They are a context-agnostic
+ * name:value pairing (for example, the base token N0 represents the value #FFFFFF ).
+ */
+export interface BaseToken<TValue, Group extends Groups> extends Token<TValue, Group> {
     attributes: {
-        isPalette: true;
+        group: Group;
     };
+}
+/**
+ * Design tokens represent single sources of truth to name and store semantic design decisions.
+ * They map a semantic name (color.background.default) to a base token (N0).
+ */
+export interface DesignToken<TValue, Group extends Groups> extends Token<TValue, Group> {
+    attributes: {
+        group: Group;
+        description: string;
+        state: ActiveTokenStates;
+        replacement?: undefined;
+    } | {
+        group: Group;
+        description: string;
+        state: ReplacedTokenStates;
+        replacement?: Replacement;
+    };
+}
+declare type OmitDistributive<T, K extends PropertyKey> = T extends any ? T extends object ? Id<DeepOmit<T, K>> : T : never;
+declare type Id<T> = {} & {
+    [P in keyof T]: T[P];
 };
-export declare type ValueSchema<Schema extends object> = {
-    [Key in keyof Schema]: ValueSchema<Omit<Schema[Key], 'attributes'>>;
-};
-export declare type AttributeSchema<Schema extends object> = {
-    [Key in keyof Schema]: AttributeSchema<Omit<Schema[Key], 'value'>>;
-};
-export declare type ShadowToken<Value extends string = ColorPalette> = Token<Array<{
+declare type DeepOmit<T extends any, K extends PropertyKey> = Omit<{
+    [P in keyof T]: OmitDistributive<T[P], K>;
+}, K>;
+export declare type ValueSchema<Schema extends object> = DeepOmit<Schema, 'attributes'>;
+export declare type AttributeSchema<Schema extends object> = DeepOmit<Schema, 'value'>;
+export declare type PaletteToken = BaseToken<string, 'palette'>;
+export declare type ColorPalette = keyof PaletteColorTokenSchema['color']['palette'];
+export declare type PaintToken<Value extends string = ColorPalette> = DesignToken<Value, 'paint'>;
+export declare type ShadowToken<Value extends string = ColorPalette> = DesignToken<Array<{
     color: Value;
     opacity: number;
     offset: {
@@ -29,7 +62,7 @@ export declare type ShadowToken<Value extends string = ColorPalette> = Token<Arr
     spread?: number;
     inset?: boolean;
 }>, 'shadow'>;
-export declare type RawToken = Token<string, 'raw'>;
+export declare type RawToken = DesignToken<string, 'raw'>;
 export interface PaletteColorTokenSchema {
     color: {
         palette: {
@@ -313,7 +346,9 @@ export interface ShadowTokenSchema {
 export interface UtilTokenSchema {
     UNSAFE_util: {
         transparent: RawToken;
+        MISSING_TOKEN: RawToken;
     };
 }
 export declare type ColorTokenSchema = BackgroundColorTokenSchema & BorderColorTokenSchema & IconBorderColorTokenSchema & TextColorTokenSchema & AccentColorTokenSchema & UtilTokenSchema;
 export declare type TokenSchema = PaletteColorTokenSchema & ColorTokenSchema & ShadowTokenSchema;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/tokens",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "author": "Atlassian Pty Ltd",
   "description": "Tokens are a single source of truth to name and store Atlassian design decisions.",
   "license": "Apache-2.0",
@@ -21,8 +21,9 @@
   "af:exports": {
     ".": "./src/index.tsx",
     "./token-names": "./src/entry-points/token-names.tsx",
-    "./token-default-values": "./src/entry-points/token-default-values.tsx",
-    "./rename-mapping": "./src/entry-points/rename-mapping.tsx"
+    "./rename-mapping": "./src/entry-points/rename-mapping.tsx",
+    "./babel-plugin": "./src/entry-points/babel-plugin.tsx",
+    "./css": "./css"
   },
   "scripts": {
     "ak-postbuild": "yarn codegen-tokens && yarn check-clean-git",
@@ -30,12 +31,20 @@
     "codegen-tokens": "ts-node --project ../../../tsconfig.node.json ./scripts/style-dictionary/build"
   },
   "dependencies": {
-    "@babel/runtime": "^7.0.0"
+    "@babel/runtime": "^7.0.0",
+    "@babel/traverse": "^7.15.0",
+    "@babel/types": "^7.15.0"
   },
   "devDependencies": {
+    "@atlaskit/code": "*",
+    "@atlaskit/lozenge": "*",
+    "@atlaskit/tabs": "*",
     "@atlassian/atlassian-frontend-prettier-config-1.0.1": "npm:@atlassian/atlassian-frontend-prettier-config@1.0.1",
-    "lodash": "^4.17.15",
+    "@babel/core": "^7.12.3",
+    "@emotion/core": "^10.0.9",
+    "lodash": "^4.17.21",
     "prettier": "^2.1.1",
+    "react": "^16.8.0",
     "style-dictionary": "^3.0.0",
     "ts-node": "^10.0.0",
     "typescript": "3.9.6"
@@ -48,7 +57,10 @@
     "@repo/internal": {
       "design-system": "v1",
       "ui-components": "lite-mode",
-      "deprecation": "no-deprecated-imports"
+      "deprecation": "no-deprecated-imports",
+      "styling": [
+        "emotion"
+      ]
     }
   },
   "prettier": "@atlassian/atlassian-frontend-prettier-config-1.0.1"