Release v2.0.0-alpha.5

build/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "vega-lite",
+  "author": "Jeffrey Heer, Dominik Moritz, Kanit \"Ham\" Wongsuphasawat",
+  "version": "2.0.0-alpha.5",
+  "collaborators": [
+    "Kanit Wongsuphasawat <[email protected]> (http://kanitw.yellowpigz.com)",
+    "Dominik Moritz <[email protected]> (https://www.domoritz.de)",
+    "Jeffrey Heer <[email protected]> (http://jheer.org)"
+  ],
+  "homepage": "https://vega.github.io/vega-lite/",
+  "description": "Vega-lite provides a higher-level grammar for visual analysis, comparable to ggplot or Tableau, that generates complete Vega specifications.",
+  "main": "build/src/vl.js",
+  "types": "build/src/vl.d.ts",
+  "bin": {
+    "vl2png": "./bin/vl2png",
+    "vl2svg": "./bin/vl2svg",
+    "vl2vg": "./bin/vl2vg"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "scripts": {
+    "prebuild": "mkdir -p build/site build/examples/images build/test-gallery",
+    "build": "tsc && cp package.json build && browserify src/vl.ts -p tsify -g [ babelify ] -d -s vl | exorcist build/vega-lite.js.map > build/vega-lite.js",
+    "postbuild": "uglifyjs build/vega-lite.js -cm --in-source-map build/vega-lite.js.map --source-map build/vega-lite.min.js.map > build/vega-lite.min.js && npm run schema",
+    "build:images": "npm run data && scripts/generate-images.sh",
+    "build:toc": "bundle exec jekyll build -q && scripts/generate-toc",
+    "build:site": "browserify site/static/main.ts -p [tsify -p site] -d > build/site/main.js",
+    "build:versions": "scripts/update-version.sh",
+    "build:test-gallery": "browserify test-gallery/main.ts -p [tsify -p test-gallery] -d > build/test-gallery/main.js",
+    "checkschema": "scripts/check-schema.sh",
+    "clean": "rm -rf build && rm -f vega-lite.* & find -E src test site examples -regex '.*\\.(js|js.map|d.ts)' -delete & rm -rf examples/_diff examples/_original examples/_output examples/images && rm -rf data",
+    "data": "rsync -r node_modules/vega-datasets/data/* data",
+
+    "deploy": "scripts/deploy.sh",
+    "deploy:gh": "scripts/deploy-gh.sh",
+    "deploy:schema": "scripts/deploy-schema.sh",
+
+    "prestart": "npm run data && npm run build && scripts/index-examples",
+    "start": "nodemon -x 'npm run build:test-gallery' & browser-sync start --server --files 'build/test-gallery/main.js' --index 'test-gallery/index.html'",
+    "poststart": "rm examples/all-examples.json",
+
+    "preschema": "npm run prebuild",
+    "schema": "typescript-json-schema --required true --noExtraProps true src/spec.ts ExtendedSpec > build/vega-lite-schema.json",
+
+    "presite": "npm run build && npm run data && npm run build:site && npm run build:toc && npm run build:versions",
+    "site": "bundle exec jekyll serve",
+
+    "lint": "tslint -c tslint.json 'src/**/*.ts' 'test/**/*.ts'",
+
+    "test": "tsc && npm run schema && npm run data && npm run test:nocompile",
+    "test:nocompile": "npm run test:only && npm run lint && npm run mocha:examples",
+    "test:only": "nyc --reporter=html --reporter=text-summary npm run mocha:test",
+    "test:debug": "tsc && npm run schema && npm run data && mocha --recursive --require ./test/babel.ts --debug-brk build/test build/examples",
+    "mocha:test": "mocha --reporter dot --recursive build/test",
+    "mocha:examples": "mocha --require ./test/babel.ts --reporter dot --recursive build/examples",
+
+    "codecov": "nyc report --reporter=json && codecov -f coverage/*.json",
+    "watch:build": "watchify src/vl.ts -p tsify -g [ babelify ] -v -d -s vl -o 'exorcist build/vega-lite.js.map > build/vega-lite.js'",
+    "watch:test": "nodemon -x 'npm test'",
+    "watch": "nodemon -x 'npm run build && npm run test:nocompile' # already ran schema in build",
+    "x-compile": "./scripts/examples-compile.sh",
+    "x-diff": "./scripts/examples-diff.sh"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vega/vega-lite.git"
+  },
+  "license": "BSD-3-Clause",
+  "bugs": {
+    "url": "https://github.com/vega/vega-lite/issues"
+  },
+  "devDependencies": {
+    "@types/chai": "^3.4.35",
+    "@types/highlight.js": "^9.1.9",
+    "@types/d3": "^4.5.0",
+    "@types/json-stable-stringify": "^1.0.30",
+    "@types/mocha": "^2.2.39",
+    "@types/node": "^7.0.5",
+    "ajv": "5.0.1-beta.1",
+    "babel-preset-es2015": "^6.22.0",
+    "babelify": "^7.3.0",
+    "browser-sync": "~2.18.8",
+    "browserify": "~14.1.0",
+    "browserify-shim": "^3.8.13",
+    "chai": "~3.5.0",
+    "cheerio": "~0.22.0",
+    "codecov": "~1.0.1",
+    "d3": "^4.7.0",
+    "exorcist": "~0.4.0",
+    "highlight.js": "^9.9.0",
+    "mocha": "~3.2.0",
+    "nodemon": "~1.11.0",
+    "nyc": "~10.1.2",
+    "source-map-support": "~0.4.11",
+    "tsify": "~3.0.1",
+    "tslint": "~4.5.1",
+    "tslint-eslint-rules": "^3.4.0",
+    "typescript": "^2.2.1",
+    "typescript-json-schema": "^0.10.0",
+    "uglify-js": "~2.8.4",
+    "vega": "3.0.0-beta.25",
+    "vega-datasets": "vega/vega-datasets#gh-pages",
+    "vega-embed": "3.0.0-beta.5",
+    "vega-parser": "^1.0.0-beta.38",
+    "watchify": "~3.9.0",
+    "yaml-front-matter": "~3.4.0"
+  },
+  "dependencies": {
+    "json-stable-stringify": "~1.0.1",
+    "tslib": "^1.6.0",
+    "vega-util": "~1.1.4",
+    "yargs": "~6.6.0"
+  }
+}

build/src/aggregate.d.ts

@@ -0,0 +1,8 @@
+export declare type AggregateOp = 'argmax' | 'argmin' | 'average' | 'count' | 'distinct' | 'max' | 'mean' | 'median' | 'min' | 'missing' | 'modeskew' | 'q1' | 'q3' | 'stdev' | 'stdevp' | 'sum' | 'valid' | 'values' | 'variance' | 'variancep';
+export declare const AGGREGATE_OPS: AggregateOp[];
+/** Additive-based aggregation operations.  These can be applied to stack. */
+export declare const SUM_OPS: AggregateOp[];
+/**
+ * Aggregation operators that always produce values within the range [domainMin, domainMax].
+ */
+export declare const SHARED_DOMAIN_OPS: AggregateOp[];

build/src/axis.d.ts

@@ -0,0 +1,71 @@
+import { DateTime } from './datetime';
+import { VgAxisEncode, VgAxisBase, VgAxisConfig } from './vega.schema';
+export declare type AxisOrient = 'top' | 'right' | 'left' | 'bottom';
+export interface AxisConfig extends VgAxisConfig, VlOnlyAxisBase {
+    /**
+     * Whether month names and weekday names should be abbreviated.
+     */
+    shortTimeLabels?: boolean;
+}
+export declare const defaultAxisConfig: AxisConfig;
+export interface Axis extends VgAxisBase, VlOnlyAxisBase {
+    /**
+     * The padding, in pixels, between axis and text labels.
+     */
+    labelPadding?: number;
+    /**
+     * The formatting pattern for axis labels.
+     */
+    format?: string;
+    /**
+     * The orientation of the axis. One of top, bottom, left or right. The orientation can be used to further specialize the axis type (e.g., a y axis oriented for the right edge of the chart).
+     */
+    orient?: AxisOrient;
+    /**
+     * The offset, in pixels, by which to displace the axis from the edge of the enclosing group or data rectangle.
+     */
+    offset?: number;
+    /**
+     * The anchor position of the axis in pixels. For x-axis with top or bottom orientation, this sets the axis group x coordinate. For y-axis with left or right orientation, this sets the axis group y coordinate.
+     *
+     * __Default value__: `0`
+     */
+    position?: number;
+    /**
+     * A desired number of ticks, for axes visualizing quantitative scales. The resulting number may be different so that values are "nice" (multiples of 2, 5, 10) and lie within the underlying scale's range.
+     * @minimum 0
+     * @TJS-type integer
+     */
+    tickCount?: number;
+    /**
+     * A title for the axis. Shows field name and its function by default.
+     */
+    title?: string;
+    values?: number[] | DateTime[];
+    /**
+     * A non-positive integer indicating z-index of the axis.
+     * If zindex is 0, axes should be drawn behind all chart elements.
+     * To put them in front, use zindex = 1.
+     * @TJS-type integer
+     * @minimum 0
+     */
+    zindex?: number;
+    /**
+     * Optional mark definitions for custom axis encoding.
+     */
+    encode?: VgAxisEncode;
+}
+/**
+ * Base object for properties that are shared between Axis and Axis Config.
+ * These properties are not in Vega Axis and Axis Config.
+ */
+export interface VlOnlyAxisBase {
+    /**
+     * Truncate labels that are too long.
+     * @minimum 1
+     * @TJS-type integer
+     */
+    labelMaxLength?: number;
+}
+export declare const AXIS_PROPERTIES: (keyof Axis)[];
+export declare const VL_ONLY_AXIS_PROPERTIES: (keyof VlOnlyAxisBase)[];

build/src/bin.d.ts

@@ -0,0 +1,40 @@
+import { Channel } from './channel';
+/**
+ * Binning properties or boolean flag for determining whether to bin data or not.
+ */
+export interface Bin {
+    /**
+     * A two-element (`[min, max]`) array indicating the range of desired bin values.
+     * @minItems 2
+     * @maxItems 2
+     */
+    extent?: number[];
+    /**
+     * The number base to use for automatic bin determination (default is base 10).
+     */
+    base?: number;
+    /**
+     * An exact step size to use between bins. If provided, options such as maxbins will be ignored.
+     */
+    step?: number;
+    /**
+     * An array of allowable step sizes to choose from.
+     * @minItems 1
+     */
+    steps?: number[];
+    /**
+     * A minimum allowable step size (particularly useful for integer values).
+     */
+    minstep?: number;
+    /**
+     * Scale factors indicating allowable subdivisions. The default value is [5, 2], which indicates that for base 10 numbers (the default base), the method may consider dividing bin sizes by 5 and/or 2. For example, for an initial step size of 10, the method can check if bin sizes of 2 (= 10/5), 5 (= 10/2), or 1 (= 10/(5*2)) might also satisfy the given constraints.
+     * @minItems 1
+     */
+    divide?: number[];
+    /**
+     * Maximum number of bins.
+     * @minimum 2
+     */
+    maxbins?: number;
+}
+export declare function autoMaxBins(channel: Channel): number;