feat: Enable root-level typedoc generation for the project.

 - All local types have been pulled out to the project directory.
 - Packages moved to /packages/@css-blocks for module name generation.
 - typedoc.js configuration file added.
 - packages/css-blocks => packages/@css-blocks/core
 - packages/webpack-plugin => packages/@css-blocks/webpack.
 - packages/glimmer-templates => packages/@css-blocks/glimmer.
 - packages/runtime/src/runtime.ts => packages/@css-blocks/runtime/src/index.ts.
 - yarn run docs will generate a typedoc site at /docs.
 - TODO: Uses pre-built forked version of typedoc-plugin-external-module-map. Remove when merged.

Author: amiller-gh

packages/@css-blocks/broccoli/package.json

@@ -6,7 +6,7 @@
   "author": "Adam Miller <ammiller@linkedin.com>",
   "license": "MIT",
   "keywords": [
-    "css-blocks",
+    "@css-blocks/core",
     "css blocks",
     "broccoli-plugin"
   ],
@@ -46,4 +46,4 @@
     "recursive-readdir": "^2.2.2",
     "walk-sync": "^0.3.2"
   }
-}
+}

packages/@css-blocks/broccoli/src/index.ts

@@ -92,7 +92,7 @@ class BroccoliCSSBlocks extends BroccoliPlugin {
 
     // Run optimization and compute StyleMapping.
     let optimized = await optimizer.optimize(this.output);
-    let styleMapping = new StyleMapping(optimized.styleMapping, blocks, options, this.analyzer.analyses());
+    let styleMapping = new StyleMapping<keyof TemplateTypes>(optimized.styleMapping, blocks, options, this.analyzer.analyses());
 
     // Attach all computed data to our magic shared memory transport object...
     this.transport.mapping = styleMapping;

packages/@css-blocks/core/src/Analyzer/Analysis.ts

@@ -1,9 +1,9 @@
 // tslint:disable-next-line:no-unused-variable Imported for Documentation link
 import {
+  isSourcePosition,
   POSITION_UNKNOWN,
   SourceLocation,
   SourcePosition,
-  isSourcePosition,
 } from "@opticss/element-analysis";
 import {
   SerializedTemplateInfo,

packages/@css-blocks/core/src/Analyzer/Analyzer.ts

@@ -10,8 +10,8 @@ import { BlockFactory } from "../BlockParser";
 import { Block, Style } from "../BlockTree";
 import {
   Options,
-  ResolvedConfiguration,
   resolveConfiguration,
+  ResolvedConfiguration,
 } from "../configuration";
 
 import { Analysis, SerializedAnalysis } from "./Analysis";

packages/@css-blocks/core/src/Analyzer/ElementAnalysis.ts

@@ -4,14 +4,14 @@ import {
   AttributeValueChoiceOption,
   AttributeValueSet,
   AttributeValueSetItem,
+  attrValues,
   Element,
+  isConstant,
   POSITION_UNKNOWN,
   SourceLocation,
   Tagname,
   ValueAbsent,
   ValueConstant,
-  attrValues,
-  isConstant,
 } from "@opticss/element-analysis";
 import {
   MultiMap,
@@ -21,13 +21,13 @@ import {
 } from "@opticss/util";
 
 import {
-  AttrValue,
   Attribute,
+  AttrValue,
   Block,
   BlockClass,
-  Style,
   isAttrValue,
   isBlockClass,
+  Style,
 } from "../BlockTree";
 import {
   ResolvedConfiguration,

packages/@css-blocks/core/src/Analyzer/validations/index.ts

@@ -5,12 +5,12 @@ import * as errors from "../../errors";
 import { Analysis } from "../Analysis";
 import { ElementAnalysis } from "../ElementAnalysis";
 
+import { Validator } from "./Validator";
 import { attributeGroupValidator } from "./attribute-group-validator";
 import { attributeParentValidator } from "./attribute-parent-validator";
 import { classPairsValidator } from "./class-pairs-validator";
 import { propertyConflictValidator } from "./property-conflict-validator";
 import { rootClassValidator } from "./root-class-validator";
-import { Validator } from "./Validator";
 
 export * from "./class-pairs-validator";
 export * from "./root-class-validator";

packages/@css-blocks/core/src/Analyzer/validations/property-conflict-validator.ts

@@ -1,4 +1,4 @@
-import { MultiMap, TwoKeyMultiMap, objectValues } from "@opticss/util";
+import { MultiMap, objectValues, TwoKeyMultiMap } from "@opticss/util";
 import * as propParser from "css-property-parser";
 import { postcss } from "opticss";
 

packages/@css-blocks/core/src/BlockCompiler/ConflictResolver.ts

@@ -4,10 +4,10 @@ import { CompoundSelector, ParsedSelector, parseSelector, postcss, postcssSelect
 import { getBlockNode } from "../BlockParser";
 import { RESOLVE_RE } from "../BlockSyntax";
 import { Block, Style } from "../BlockTree";
+import { SourceLocation, sourceLocation } from "../SourceLocation";
 import { ResolvedConfiguration } from "../configuration";
 import * as errors from "../errors";
 import { QueryKeySelector } from "../query";
-import { SourceLocation, sourceLocation } from "../SourceLocation";
 
 import { Conflicts, detectConflicts } from "./conflictDetection";
 

packages/@css-blocks/core/src/BlockCompiler/index.ts

@@ -6,14 +6,14 @@ import {
   BLOCK_DEBUG,
   BLOCK_PROP_NAMES_RE,
   BLOCK_REFERENCE,
-  ROOT_CLASS,
   parseBlockDebug,
+  ROOT_CLASS,
 } from "../BlockSyntax";
 import { Block } from "../BlockTree";
 import {
   Options,
-  ResolvedConfiguration,
   resolveConfiguration,
+  ResolvedConfiguration,
 } from "../configuration";
 
 import { ConflictResolver } from "./ConflictResolver";

packages/@css-blocks/core/src/BlockParser/BlockFactory.ts

@@ -5,12 +5,12 @@ import * as path from "path";
 import { RawSourceMap } from "source-map";
 
 import { Block } from "../BlockTree";
-import { Options, ResolvedConfiguration, resolveConfiguration } from "../configuration";
+import { Options, resolveConfiguration, ResolvedConfiguration } from "../configuration";
 import { FileIdentifier, ImportedFile, Importer } from "../importing";
 import { PromiseQueue } from "../util/PromiseQueue";
 
 import { BlockParser, ParsedSource } from "./BlockParser";
-import { Preprocessor, Preprocessors, ProcessedFile, Syntax, annotateCssContentWithSourceMap, syntaxName } from "./preprocessing";
+import { annotateCssContentWithSourceMap, Preprocessor, Preprocessors, ProcessedFile, Syntax, syntaxName } from "./preprocessing";
 
 const debug = debugGenerator("css-blocks:BlockFactory");