keyframekit 1.1.3 → 1.1.4

package/README.md

@@ -2,6 +2,8 @@
 
 Unlock fine-grained control over your CSS animations with JavaScript.
 
+[![License](https://img.shields.io/github/license/benhatsor/KeyframeKit)](/LICENSE) [![Minified size](https://img.shields.io/bundlejs/size/keyframekit?label=size)](https://www.npmjs.com/package/keyframekit)
+
 ## About
 
 The [Web Animations API][2] opens the browser's animation engine to developers and provides unprecedented control and performance when animating on the web. But confusingly, it provides no easy way to use your existing CSS animations with the API. So I wrote a lightweight, typed, spec-compliant library to convert stylesheet keyframes to Web Animations API-compatible animations, letting you play your CSS-defined animations right in JS. [Read more.][3]
@@ -77,7 +79,7 @@ const rotateSmallAnimKeyframes = KeyframeKit.getStyleSheetKeyframes({
 
 ### Defining animations in JS
 
-The `KeyframeEffectParameters` class provides a more convenient way to define your animations in JS than is offered natively.  
+The [`KeyframeEffectParameters`][6] class provides a more convenient way to define your animations in JS than is offered natively.  
 It's useful for when you want to have all your animation code in one place.
 
 ```js
@@ -110,7 +112,7 @@ attachedAnim.play();
 ```
 
 ### Full reference
-[See here.][6]
+[See here.][7]
 
 ## Typing
 
@@ -126,4 +128,5 @@ This library is fully compatable with native JS, but it also has full spec-compl
 [3]: https://benhatsor.medium.com/99573ef4738b
 [4]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API
 [5]: https://github.com/WICG/construct-stylesheets/issues/119#issuecomment-588352418
-[6]: https://keyframekit.berryscript.com/reference
+[6]: https://keyframekit.berryscript.com/reference/classes/KeyframeEffectParameters
+[7]: https://keyframekit.berryscript.com/reference

package/docs/.vitepress/components/Playground/Playground.vue

@@ -62,7 +62,7 @@ const { tabs, activeTab, isLoaded, setEditorRef } = playground(props, previewFra
   --border-radius: 8px;
   border-radius: var(--border-radius);
   overflow: hidden;
-  margin-bottom: 48px;
+  /* margin-bottom: 48px; */
 }
 
 @media (max-width: 1000px) {
@@ -88,11 +88,13 @@ const { tabs, activeTab, isLoaded, setEditorRef } = playground(props, previewFra
   }
 }
 
+/*
 @media (min-width: 640px) {
   .playground {
     margin-bottom: 64px;
   }
 }
+*/
 
 .editor-pane {
   display: flex;

package/docs/.vitepress/config.ts

@@ -11,6 +11,8 @@ export default defineConfig({
     //'reference/:slug*': ':slug*'
   },
 
+  cleanUrls: true,
+
   head: [
     ['link', { rel: 'icon', href: '/icon.png' }],
     ['meta', { property: 'og:image', content: '/og-image.png' }],
@@ -41,6 +43,7 @@ export default defineConfig({
     // https://vitepress.dev/reference/default-theme-config
     nav: [
       { text: 'Home', link: '/' },
+      { text: 'Get Started', link: '/get-started' },
       { text: 'Reference', link: '/reference' }
     ],
 

package/docs/docs/get-started.md

@@ -0,0 +1,127 @@
+
+# Get Started
+
+## About
+
+The [Web Animations API][1] opens the browser's animation engine to developers and provides unprecedented control and performance when animating on the web. But confusingly, it provides no easy way to use your existing CSS animations with the API. So I wrote a lightweight, typed, spec-compliant library to convert stylesheet keyframes to Web Animations API-compatible animations, letting you play your CSS-defined animations right in JS. [Read more.][2]
+
+## Installation
+
+::: code-group
+```sh [npm]
+npm install keyframekit
+```
+:::
+
+## Usage
+
+### Playing CSS-defined animations with JS
+
+In your CSS:
+```css
+@keyframes rotate-small { ... }
+```
+
+Then, in JS:
+```js
+import KeyframeKit from 'keyframekit';
+
+const documentStyleSheets = await KeyframeKit.getDocumentStyleSheetsOnLoad();
+
+// get animation keyframes from the document's stylesheets
+const rotateSmallAnimKeyframes = KeyframeKit.getStyleSheetKeyframes({
+  of: 'rotate-small',
+  in: documentStyleSheets
+});
+
+// then, define your animation
+const rotateSmallAnim = rotateSmallAnimKeyframes.toKeyframeEffect({
+  duration: 700,
+  easing: 'ease'
+});
+
+// finally, attach it to an element:
+const attachedAnim = rotateSmallAnim.toAnimation({
+  target: document.querySelector('.el')
+});
+
+attachedAnim.play();
+```
+
+The primary reason to play your animation with JS is because you get way more control over its playback:
+```js
+attachedAnim.pause();
+attachedAnim.playbackRate = -1;
+const progress = attachedAnim.overallProgress; // 0 to 1 (Baseline newly available)
+await attachedAnim.finished;
+```
+[...and more.][3]
+
+### Importing animations directly from a CSS file
+
+Instead of getting an animation from the document's stylesheets, you can also import it directly from a CSS file.
+
+```js
+import KeyframeKit from 'keyframekit';
+
+const styleSheet = await KeyframeKit.importStyleSheet('./styles.css');
+
+// get animation keyframes from stylesheet
+const rotateSmallAnimKeyframes = KeyframeKit.getStyleSheetKeyframes({
+  of: 'rotate-small',
+  in: styleSheet
+});
+```
+
+> Note: This won't resolve any `@import` rules in the stylesheet. [See more.][4]
+
+### Defining animations in JS
+
+The [`KeyframeEffectParameters`](reference/classes/KeyframeEffectParameters.md) class provides a more convenient way to define your animations in JS than is offered natively.  
+It's useful for when you want to have all your animation code in one place.
+
+```js
+import { KeyframeEffectParameters } from 'keyframekit';
+
+// define your animation
+const linkTextHoverAnim = new KeyframeEffectParameters({
+
+  keyframes: {
+    // 0 to 1. equivalent to CSS keyframe percentage values:
+    offset: [0, 0.499, 0.5, 1],
+    // respective CSS property keyframes:
+    clipPath: ['inset(0 0 0 0)', 'inset(100% 0 0 0)', 'inset(0 0 100% 0)', 'inset(0 0 0 0)'],
+    top: ['0', '-20px', '20px', '0']
+  },
+
+  options: {
+    duration: 700,
+    easing: 'ease'
+  }
+  
+});
+
+// then, attach it to an element:
+const attachedAnim = linkTextHoverAnim.toAnimation({
+  target: document.querySelector('.link')
+});
+
+attachedAnim.play();
+```
+
+### Full reference
+[See here.](/reference/index.md)
+
+## Typing
+
+This library is fully compatable with native JS, but it also has full spec-compliant type support, including declaration files and source maps.
+
+## License
+
+[MIT](https://github.com/benhatsor/KeyframeKit/blob/main/LICENSE)
+
+
+[1]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API
+[2]: https://benhatsor.medium.com/99573ef4738b
+[3]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API
+[4]: https://github.com/WICG/construct-stylesheets/issues/119#issuecomment-588352418

package/docs/docs/index.md

@@ -8,135 +8,10 @@ hero:
   actions:
     - theme: brand
       text: Get Started
-      link: /#installation
+      link: /get-started
     - theme: alt
       text: Reference
       link: /reference
 ---
 
 <Playground/>
-
-## About
-
-The [Web Animations API][2] opens the browser's animation engine to developers and provides unprecedented control and performance when animating on the web. But confusingly, it provides no easy way to use your existing CSS animations with the API. So I wrote a lightweight, typed, spec-compliant library to convert stylesheet keyframes to Web Animations API-compatible animations, letting you play your CSS-defined animations right in JS. [Read more.][3]
-
-## Installation
-
-::: code-group
-```sh [npm]
-npm install keyframekit
-```
-:::
-
-## Usage
-
-### Playing CSS-defined animations with JS
-
-In your CSS:
-```css
-@keyframes rotate-small { ... }
-```
-
-Then, in JS:
-```js
-import KeyframeKit from 'keyframekit';
-
-const documentStyleSheets = await KeyframeKit.getDocumentStyleSheetsOnLoad();
-
-// get animation keyframes from the document's stylesheets
-const rotateSmallAnimKeyframes = KeyframeKit.getStyleSheetKeyframes({
-  of: 'rotate-small',
-  in: documentStyleSheets
-});
-
-// then, define your animation
-const rotateSmallAnim = rotateSmallAnimKeyframes.toKeyframeEffect({
-  duration: 700,
-  easing: 'ease'
-});
-
-// finally, attach it to an element:
-const attachedAnim = rotateSmallAnim.toAnimation({
-  target: document.querySelector('.el')
-});
-
-attachedAnim.play();
-```
-
-The primary reason to play your animation with JS is because you get way more control over its playback:
-```js
-attachedAnim.pause();
-attachedAnim.playbackRate = -1;
-const progress = attachedAnim.overallProgress; // 0 to 1 (Baseline newly available)
-await attachedAnim.finished;
-```
-[...and more.][3]
-
-### Importing animations directly from a CSS file
-
-Instead of getting an animation from the document's stylesheets, you can also import it directly from a CSS file.
-
-```js
-import KeyframeKit from 'keyframekit';
-
-const styleSheet = await KeyframeKit.importStyleSheet('./styles.css');
-
-// get animation keyframes from stylesheet
-const rotateSmallAnimKeyframes = KeyframeKit.getStyleSheetKeyframes({
-  of: 'rotate-small',
-  in: styleSheet
-});
-```
-
-> Note: This won't resolve any `@import` rules in the stylesheet. [See more.][4]
-
-### Defining animations in JS
-
-The `KeyframeEffectParameters` class provides a more convenient way to define your animations in JS than is offered natively.  
-It's useful for when you want to have all your animation code in one place.
-
-```js
-import { KeyframeEffectParameters } from 'keyframekit';
-
-// define your animation
-const linkTextHoverAnim = new KeyframeEffectParameters({
-
-  keyframes: {
-    // 0 to 1. equivalent to CSS keyframe percentage values:
-    offset: [0, 0.499, 0.5, 1],
-    // respective CSS property keyframes:
-    clipPath: ['inset(0 0 0 0)', 'inset(100% 0 0 0)', 'inset(0 0 100% 0)', 'inset(0 0 0 0)'],
-    top: ['0', '-20px', '20px', '0']
-  },
-
-  options: {
-    duration: 700,
-    easing: 'ease'
-  }
-  
-});
-
-// then, attach it to an element:
-const attachedAnim = linkTextHoverAnim.toAnimation({
-  target: document.querySelector('.link')
-});
-
-attachedAnim.play();
-```
-
-### Full reference
-[See here.](/reference/index.md)
-
-## Typing
-
-This library is fully compatable with native JS, but it also has full spec-compliant type support, including declaration files and source maps.
-
-## License
-
-[MIT](https://github.com/benhatsor/KeyframeKit/blob/main/LICENSE)
-
-
-[1]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API
-[2]: https://benhatsor.medium.com/99573ef4738b
-[3]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API/Using_the_Web_Animations_API
-[4]: https://github.com/WICG/construct-stylesheets/issues/119#issuecomment-588352418

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyframekit",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Unlock fine-grained control over your CSS animations with JavaScript.",
   "main": "./dist/KeyframeKit.js",
   "scripts": {

package/vercel.json

@@ -1,4 +1,5 @@
 {
+  "cleanUrls": true,
   "headers": [
     {
       "source": "/assets/(.*)",