Do not export the whole CSSOM/parser interface

Author: cdoublev

README.md

@@ -6,37 +6,40 @@ JavaScript implementation of CSS.
 ## Usage
 
 ```js
-const { cssom, install, parser } = require('@cdoublev/css')
+const {
+  CSSStyleDeclaration,
+  CSSStyleSheet,
+  install,
+  parseGrammar,
+  parseGrammarList,
+} = require('@cdoublev/css')
 
 /**
  * install() expects a window-like global object (default: globalThis) with
  * document, Array, Object, Number, String, TypeError.
  */
 install(/*myGlobalObject*/)
 
-// Parse a style sheet and get a (non-constructed) CSSStyleSheet
-const stylesheet = parser.parseStyleSheet('style {}')
-
-// Create a (constructed) CSSStyleSheet
-const styleSheet = new /*myGlobalObject.*/CSSStyleSheet()
-
 // Create a CSSStyleSheet or CSSStyleDeclaration wrapper
-const stylesheet = cssom.CSSStyleSheet.create(myGlobalObject, undefined, privateProperties)
-const style = cssom.CSSStyleDeclaration.create(myGlobalObject, undefined, privateProperties)
+const stylesheet = CSSStyleSheet.create(myGlobalObject, undefined, privateProperties)
+const style = CSSStyleDeclaration.create(myGlobalObject, undefined, privateProperties)
+
+// Parse something according to a CSS grammar
+const color = parseGrammar('green', '<color>')
 
-// Parse a value according to a CSS grammar
-const value = parser.parseGrammar('(width < 30rem), (orientation: portrait)', '<media-query-list>')
+// Parse a comma-separated list according to a CSS grammar
+const list = parseGrammarList('(width < 30rem), (orientation: portrait)', '<media-query-list>')
 ```
 
-The `webidl2js` wrappers are intended to implement:
+`CSSStyleSheet` and `CSSStyleDeclaration` are [`webidl2js`](https://github.com/jsdom/webidl2js) wrappers intended to implement:
 
 - *create a CSS style sheet*: when processing or updating the content of [`HTMLStyleElement`](https://html.spec.whatwg.org/multipage/semantics.html#the-style-element), when processing the resource referenced by [`HTMLLinkElement`](https://html.spec.whatwg.org/multipage/links.html#link-type-stylesheet) or an HTTP `Link` header with `rel="stylesheet"`
 - (get) [the `style` attribute of an `HTMLElement`](https://html.spec.whatwg.org/multipage/dom.html#the-style-attribute)
 - *return a live CSS declaration block* from [`Window.getComputedStyle()`](https://drafts.csswg.org/cssom-1/#extensions-to-the-window-interface)
 
-To sum up, they mostly exist to create `CSSStyleSheet` and `CSSStyleDeclaration`. Below are the properties defined in the CSSOM specification and their associated property read in `privateProperties`:
+Below are their accepted `privateProperties`:
 
-**`CSSStyleSheet`**
+[**`CSSStyleSheet`**](https://drafts.csswg.org/cssom-1/#css-style-sheet)
 
   - *CSS rules*: `rules` (`String` or `ReadableStream`)
   - *alternate flag*: `alternate` (`Boolean`, optional, default: `false`)
@@ -49,7 +52,7 @@ To sum up, they mostly exist to create `CSSStyleSheet` and `CSSStyleDeclaration`
   - *parent CSS style sheet*: `parentStyleSheet` (`CSSStyleSheet`, optional, default: `null`)
   - *title*: `title` (`String`, optional, default: `''`)
 
-**`CSSStyleDeclaration`**
+[**`CSSStyleDeclaration`**](https://drafts.csswg.org/cssom-1/#css-declaration-block)
 
   - *computed flag*: `computed` (`Boolean`, optional, default: `false`)
   - *declarations*: `declarations` (`[Declaration]`, optional, default: `[]`)

__tests__/media.js

@@ -1,11 +1,12 @@
 
-import { cssom, install } from '../lib/index.js'
 import { DELETE_UNEXISTENT_MEDIUM_ERROR } from '../lib/error.js'
+import { MediaList } from '../lib/cssom/index.js'
+import { install } from '../lib/index.js'
 
 install()
 
 function createMediaList(text) {
-    const media = cssom.MediaList.create(globalThis)
+    const media = MediaList.create(globalThis)
     if (text) {
         media.mediaText = text
     }

lib/index.js

@@ -1,6 +1,5 @@
 
 import * as cssom from './cssom/index.js'
-import * as parser from './parse/parser.js'
 
 /**
  * @param {DocumentOrShadowRoot} globalObject
@@ -20,4 +19,6 @@ function install(globalObject = globalThis) {
     globalObject.CSS = cssom.CSS.create(globalObject)
 }
 
-export { cssom, install, parser }
+export { CSSStyleDeclaration, CSSStyleSheet } from './cssom/index.js'
+export { parseGrammar, parseGrammarList } from './parse/parser.js'
+export { install }

lib/parse/parser.js

@@ -1,5 +1,6 @@
 
 import * as compatibility from '../compatibility.js'
+import * as cssom from '../cssom/index.js'
 import * as grammar from './grammar.js'
 import * as substitutions from '../values/substitutions.js'
 import {
@@ -42,7 +43,6 @@ import {
 } from '../utils/value.js'
 import { isNode, type as nodeType } from '../utils/node.js'
 import Stream from './stream.js'
-import { cssom } from '../index.js'
 import expandDeclaration from './shorthand.js'
 import root from '../rules/definitions.js'
 import shorthands from '../properties/shorthands.js'