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

CHANGELOG.md

@@ -1,22 +1,25 @@
 {
 	"folders": [
 		{
-			"path": "packages/css-blocks"
+			"path": "packages/@css-blocks/broccoli"
 		},
 		{
-			"path": "packages/glimmer-templates"
+			"path": "packages/@css-blocks/code-style"
 		},
 		{
-			"path": "packages/jsx"
+			"path": "packages/@css-blocks/core"
 		},
 		{
-			"path": "packages/runtime"
+			"path": "packages/@css-blocks/glimmer"
 		},
 		{
-			"path": "packages/webpack-plugin"
+			"path": "packages/@css-blocks/jsx"
 		},
 		{
-			"path": "packages/code-style"
+			"path": "packages/@css-blocks/runtime"
+		},
+		{
+			"path": "packages/@css-blocks/webpack"
 		},
 		{
 			"path": ".",

css-blocks.code-workspace

@@ -2,7 +2,8 @@
   "private": true,
   "scripts": {
     "commitmsg": "commitlint --edit $GIT_PARAMS",
-    "ci": "lerna run test"
+    "ci": "lerna run test",
+    "docs": "typedoc"
   },
   "devDependencies": {
     "@commitlint/cli": "^6.1.0",
@@ -16,10 +17,12 @@
     "@types/babylon": "^6.16.1",
     "@types/chai": "^3.5.2",
     "@types/debug": "0.0.29",
+    "@types/loader-utils": "^1.1.3",
     "@types/minimatch": "^2.0.29",
     "@types/mocha": "^2.2.41",
     "@types/node": "^8.0.0",
     "@types/prettier": "^1.8.0",
+    "@types/tapable": "0.2.4",
     "chai": "^3.5.0",
     "husky": "^0.14.3",
     "istanbul": "^0.4.5",
@@ -38,11 +41,12 @@
     "test-console": "^1.1.0",
     "ts-node": "^3.0.4",
     "tslint": "^5.9.1",
-    "typedoc": "^0.7.1",
+    "typedoc": "^0.11.0",
     "typescript": "^2.8.1",
+    "typedoc-plugin-external-module-map": "amiller-gh/typedoc-plugin-external-module-map#prebuilt",
     "watch": "^1.0.2"
   },
   "workspaces": [
-    "packages/*"
+    "packages/@css-blocks/*"
   ]
 }

package.json

@@ -5,7 +5,11 @@
   "main": "dist/src/index.js",
   "author": "Adam Miller <ammiller@linkedin.com>",
   "license": "MIT",
-  "keywords": ["css-blocks", "css blocks", "broccoli-plugin"],
+  "keywords": [
+    "css-blocks",
+    "css blocks",
+    "broccoli-plugin"
+  ],
   "scripts": {
     "test": "mocha --opts test/mocha.opts dist/test",
     "compile": "rm -rf dist && tsc -p tsconfig.json",
@@ -15,32 +19,31 @@
     "lint": "tslint -t msbuild --project . -c tslint.cli.json",
     "lintall": "tslint -t msbuild --project . -c tslint.release.json",
     "lintfix": "tslint -t msbuild --project . -c tslint.cli.json --fix",
-    "coverage":
-      "istanbul cover -i dist/src/**/*.js --dir ./build/coverage node_modules/mocha/bin/_mocha -- dist/test --opts test/mocha.opts",
-    "remap":
-      "remap-istanbul -i build/coverage/coverage.json -o coverage -t html",
+    "coverage": "istanbul cover -i dist/src/**/*.js --dir ./build/coverage node_modules/mocha/bin/_mocha -- dist/test --opts test/mocha.opts",
+    "remap": "remap-istanbul -i build/coverage/coverage.json -o coverage -t html",
     "docs": "typedoc --out ./docs .",
     "watch": "watch 'yarn run test' src test types-local --wait=1"
   },
   "devDependencies": {
     "@css-blocks/code-style": "^0.17.0",
-    "@css-blocks/glimmer-templates": "^0.17.0"
+    "@css-blocks/glimmer": "^0.17.0"
   },
   "dependencies": {
+    "@css-blocks/core": "^0.17.0",
     "@glimmer/compiler": "^0.33.0",
     "@glimmer/syntax": "^0.33.0",
+    "@opticss/template-api": "file:../../../../opticss/packages/template-api",
     "@types/recursive-readdir": "^2.2.0",
     "broccoli-funnel": "^2.0.1",
     "broccoli-merge-trees": "^3.0.0",
     "broccoli-plugin": "^1.3.0",
     "broccoli-test-helper": "^1.2.0",
     "colors": "^1.2.1",
-    "css-blocks": "^0.17.0",
     "debug": "^3.1.0",
     "fs-extra": "^5.0.0",
-    "opticss": "file:../../../opticss/packages/opticss",
+    "opticss": "file:../../../../opticss/packages/opticss",
     "postcss": "^6.0.21",
     "recursive-readdir": "^2.2.2",
     "walk-sync": "^0.3.2"
   }
-}
+}

packages/broccoli-css-blocks/package.json …ckages/@css-blocks/broccoli/package.jsonpackages/broccoli-css-blocks/package.json renamed to packages/@css-blocks/broccoli/package.json packages/broccoli-css-blocks/package.json renamed to packages/@css-blocks/broccoli/package.json

@@ -1,13 +1,12 @@
 import * as fs from "fs-extra";
 import * as path from "path";
 
-import { Analyzer, BlockCompiler, StyleMapping } from "css-blocks";
+import { Analyzer, BlockCompiler, StyleMapping } from "@css-blocks/core";
+import { TemplateTypes } from "@opticss/template-api";
 import { Optimizer } from "opticss";
 import * as postcss from "postcss";
 import * as readdir from "recursive-readdir";
 
-import { TemplateTypes } from "@opticss/template-api";
-
 import { BroccoliPlugin } from "./utils";
 
 export interface BroccoliOptions {

packages/broccoli-css-blocks/src/index.ts …ckages/@css-blocks/broccoli/src/index.tspackages/broccoli-css-blocks/src/index.ts renamed to packages/@css-blocks/broccoli/src/index.ts packages/broccoli-css-blocks/src/index.ts renamed to packages/@css-blocks/broccoli/src/index.ts

@@ -1,10 +1,10 @@
-import { GlimmerAnalyzer } from "@css-blocks/glimmer-templates";
+import { GlimmerAnalyzer } from "@css-blocks/glimmer";
 import * as assert from "assert";
 import { TempDir, buildOutput, createTempDir } from "broccoli-test-helper";
 
 import { BroccoliCSSBlocks } from "../src/index";
 
-describe("Broccoli Plugin Test", function() {
+describe("Broccoli Plugin Test", function () {
   let input: TempDir;
 
   beforeEach(async () => {

packages/broccoli-css-blocks/src/utils.ts …ckages/@css-blocks/broccoli/src/utils.tspackages/broccoli-css-blocks/src/utils.ts renamed to packages/@css-blocks/broccoli/src/utils.ts packages/broccoli-css-blocks/src/utils.ts renamed to packages/@css-blocks/broccoli/src/utils.ts

@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.json",
+  "extends": "../../../tsconfig.json",
   "compilerOptions": {
     "outDir": "dist",
     "baseUrl": "dist"