feat: 🎸 add keyframes() addon typings

index.d.ts

@@ -5,6 +5,7 @@ import {DruleAddon} from './types/addon/drule';
 import {SheetAddon} from './types/addon/sheet';
 import {AtomsAddon} from './types/addon/atoms';
 import {SheetPreset} from './types/preset/sheet';
+import {KeyframesAddon} from './types/addon/keyframes';
 
 export * from './types/nano';
 
@@ -34,6 +35,10 @@ declare module 'nano-css/addon/atoms' {
     export const addon: AtomsAddon;
 }
 
+declare module 'nano-css/addon/keyframes' {
+    export const addon: KeyframesAddon;
+}
+
 // Presets
 
 declare module 'nano-css/preset/sheet' {

types/addon/keyframes.d.ts

@@ -0,0 +1,35 @@
+import {CssLikeObject} from '../common';
+import {NanoRenderer} from '../nano';
+
+export interface KeyframesPatch {
+    /**
+     * @param frames Map of keyframes.
+     * @param block Optional semantic name.
+     *
+     * Returns a generated animation name.
+     *
+     * ```js
+     * const animationName = nano.keyframes({
+     *     from: {
+     *         left: '0%',
+     *     },
+     *     to: {
+     *         left: '100%',
+     *     },
+     * });
+     * ```
+     *
+     * You need to install [`keyframes()` addon]()https://github.com/streamich/nano-css/blob/master/docs/keyframes.md) to use this method.
+     *
+     * ```js
+     * import {create} from 'nano-css';
+     * import {addon as addonKeyframes} from 'nano-css/addon/keyframes';
+     *
+     * const nano = create();
+     * addonKeyframes(nano);
+     * ```
+     */
+    keyframes: (frames: object, block?: string) => string;
+}
+
+export type KeyframesAddon = <T extends NanoRenderer>(nano: T) => T & KeyframesPatch;

types/addon/rule.d.ts

@@ -10,7 +10,7 @@ export interface RulePatch {
      *
      * ```js
      * import {create} from 'nano-css';
-     * import {addon as addonRule} from 'nano-css';
+     * import {addon as addonRule} from 'nano-css/addon/rule';
      *
      * const nano = create();
      * addonRule(nano);

types/nano.d.ts

@@ -3,6 +3,7 @@ import {RulePatch} from './addon/rule';
 import {DrulePatch} from './addon/drule';
 import {UnitsPatch} from './addon/units';
 import {SheetPatch} from './addon/sheet';
+import {KeyframesPatch} from './addon/keyframes';
 
 /*
 interface NanoRenderer extends Partial<IUnits> {
@@ -49,7 +50,8 @@ export interface NanoRenderer
     extends Partial<RulePatch>,
         Partial<UnitsPatch>,
         Partial<DrulePatch>,
-        Partial<SheetPatch> {
+        Partial<SheetPatch>,
+        Partial<KeyframesPatch> {
     /**
      * Equals to `true` if in browser environment.
      */