feat: 🎸 add CSSOM and VCSSOM TypeScript typings

Author: streamich

addon/cssom.d.ts

@@ -0,0 +1,15 @@
+export interface CSSOMRule extends CSSRule {
+    index: number;
+    style: CSSStyleDeclaration;
+    styleMap: any;
+}
+
+export interface AddonCSSOM {
+    /**
+     * @param selector CSS rule selector string.
+     * @param prelude Media query at-rule prelude string.
+     */
+    createRule(selector: string, prelude: string): CSSOMRule;
+}
+
+export function addon<Nano extends {sh: HTMLStyleElement}>(nano: Nano): Nano & AddonCSSOM;

addon/vcssom.d.ts

@@ -0,0 +1,12 @@
+import {AddonCSSOM} from './cssom';
+import {Css} from './vcssom/cssToTree';
+
+export interface VSheet {
+    diff(css: Css);
+}
+
+export interface AddonVCSSOM {
+    VSheet: new () => VSheet;
+}
+
+export function addon<Nano extends AddonCSSOM>(nano: Nano): Nano & AddonVCSSOM;

addon/vcssom/cssToTree.d.ts

@@ -0,0 +1,15 @@
+import {CssLikeObject} from '../../types/common';
+
+export interface Css {
+    [key: string]: CssLikeObject[keyof CssLikeObject] | Css;
+}
+
+export interface Tree {
+    [atRulePrelude: string]: {
+        [selector: string]: {
+            [property: string]: CssLikeObject;
+        };
+    };
+}
+
+export function cssToTree(css: Css): Tree;

addon/vcssom/removeRule.d.ts

@@ -0,0 +1,3 @@
+import {CSSOMRule} from '../cssom';
+
+export function removeRule(sh: CSSStyleSheet, rule: CSSOMRule);

addon/vcssom/removeRule.js

@@ -1,3 +1,5 @@
+// TODO: `rule` should have a reference to stylesheet it is contained in,
+// maybe we don't need to pass `sh` in here.
 function removeRule (sh, rule) {
     var maxIndex = rule.index;
     var rules = sh.cssRules || sh.rules;