@uwdata/mosaic-spec 0.7.1 → 0.9.0

package/src/spec/marks/Tick.ts

@@ -0,0 +1,69 @@
+import {
+  ChannelValueSpec, InsetOptions, MarkData, MarkOptions, MarkerOptions
+} from './Marks.js';
+
+/** Options for the tickX mark. */
+export interface TickXOptions extends MarkOptions, MarkerOptions, Omit<InsetOptions, 'insetLeft' | 'insetRight'> {
+  /**
+   * The required horizontal position of the tick; a channel typically bound to
+   * the *x* scale.
+   */
+  x?: ChannelValueSpec;
+
+  /**
+   * The optional vertical position of the tick; an ordinal channel typically
+   * bound to the *y* scale. If not specified, the tick spans the vertical
+   * extent of the frame; otherwise the *y* scale must be a *band* scale.
+   *
+   * If *y* represents quantitative or temporal values, use a ruleX mark
+   * instead.
+   */
+  y?: ChannelValueSpec;
+}
+
+/** Options for the tickY mark. */
+export interface TickYOptions extends MarkOptions, MarkerOptions, Omit<InsetOptions, 'insetTop' | 'insetBottom'> {
+  /**
+   * The required vertical position of the tick; a channel typically bound to
+   * the *y* scale.
+   */
+  y?: ChannelValueSpec;
+
+  /**
+   * The optional horizontal position of the tick; an ordinal channel typically
+   * bound to the *x* scale. If not specified, the tick spans the horizontal
+   * extent of the frame; otherwise the *x* scale must be a *band* scale.
+   *
+   * If *x* represents quantitative or temporal values, use a ruleY mark
+   * instead.
+   */
+  x?: ChannelValueSpec;
+}
+
+/** The tickX mark. */
+export interface TickX extends MarkData, TickXOptions {
+  /**
+   * A horizontally-positioned tickX mark (a vertical line, |). The **x**
+   * channel specifies the tick’s horizontal position and defaults to identity,
+   * assuming that *data* = [*x₀*, *x₁*, *x₂*, …]; the optional **y** ordinal
+   * channel specifies its vertical position.
+   *
+   * If *y* represents quantitative or temporal values, use a ruleX mark
+   * instead.
+   */
+  mark: 'tickX';
+}
+
+/** The tickY mark. */
+export interface TickY extends MarkData, TickYOptions {
+  /**
+   * A vertically-positioned tickY mark (a horizontal line, —). The **y**
+   * channel specifies the tick's vertical position and defaults to identity,
+   * assuming that *data* = [*y₀*, *y₁*, *y₂*, …]; the optional **x** ordinal
+   * channel specifies its horizontal position.
+   *
+   * If *x* represents quantitative or temporal values, use a ruleY mark
+   * instead.
+   */
+  mark: 'tickY';
+}

package/src/spec/marks/Vector.ts

@@ -0,0 +1,113 @@
+import { ParamRef } from '../Param.js';
+import { FrameAnchor } from '../PlotTypes.js';
+import { ChannelValue, ChannelValueSpec, MarkData, MarkOptions } from './Marks.js';
+
+/**
+ * The built-in vector shape implementations; one of:
+ *
+ * - *arrow* - a straight line with an open arrowhead at the end (↑)
+ * - *spike* - an isosceles triangle with a flat base (▲)
+ */
+export type VectorShapeName = 'arrow' | 'spike';
+
+/** How to draw a vector: either a named shape or a custom implementation. */
+export type VectorShape = VectorShapeName;
+
+/** Options for the vector mark. */
+export interface VectorOptions extends MarkOptions {
+  /**
+   * The horizontal position of the vector’s anchor point; an optional channel
+   * bound to the *x* scale. Default depends on the **frameAnchor**.
+   */
+  x?: ChannelValueSpec;
+
+  /**
+   * The vertical position of the vector’s anchor point; an optional channel
+   * bound to the *y* scale. Default depends on the **frameAnchor**.
+   */
+  y?: ChannelValueSpec;
+
+  /**
+   * The vector shape’s radius, such as half the width of the *arrow*’s head or
+   * the *spike*’s base; a constant number in pixels. Defaults to 3.5 pixels.
+   */
+  r?: number | ParamRef;
+
+  /**
+   * The vector’s length; either an optional channel bound to the *length* scale
+   * or a constant number in pixels. Defaults to 12 pixels.
+   */
+  length?: ChannelValueSpec;
+
+  /**
+   * The vector’s orientation (rotation angle); either a constant number in
+   * degrees clockwise, or an optional channel (with no associated scale).
+   * Defaults to 0 degrees with the vector pointing up.
+   */
+  rotate?: ChannelValue;
+
+  /** The shape of the vector; a constant. Defaults to *arrow*. */
+  shape?: VectorShape | ParamRef;
+
+  /**
+   * The vector’s position along its orientation relative to its anchor point; a
+   * constant. Assuming a default **rotate** angle of 0°, one of:
+   *
+   * - *start* - from [*x*, *y*] to [*x*, *y* - *l*]
+   * - *middle* (default) - from [*x*, *y* + *l* / 2] to [*x*, *y* - *l* / 2]
+   * - *end* - from [*x*, *y* + *l*] to [*x*, *y*]
+   *
+   * where [*x*, *y*] is the vector’s anchor point and *l* is the vector’s
+   * (possibly scaled) length in pixels.
+   */
+  anchor?: 'start' | 'middle' | 'end' | ParamRef;
+
+  /**
+   * The vector’s frame anchor, to default **x** and **y** relative to the
+   * frame; a constant representing one of the frame corners (*top-left*,
+   * *top-right*, *bottom-right*, *bottom-left*), sides (*top*, *right*,
+   * *bottom*, *left*), or *middle* (default). Has no effect if both **x**
+   * and **y** are specified.
+   */
+  frameAnchor?: FrameAnchor | ParamRef;
+}
+
+/** The vector mark. */
+export interface Vector extends MarkData, VectorOptions {
+  /**
+   * A vector mark.
+   *
+   * If none of **frameAnchor**, **x**, and **y** are specified, then **x** and
+   * **y** default to accessors assuming that *data* contains tuples [[*x₀*,
+   * *y₀*], [*x₁*, *y₁*], [*x₂*, *y₂*], …]
+   */
+  mark: 'vector';
+}
+
+/** The vectorX mark. */
+export interface VectorX extends MarkData, VectorOptions {
+  /**
+   * Like vector, but **x** instead defaults to the identity function and **y**
+   * defaults to null, assuming that *data* is an array of numbers [*x₀*, *x₁*,
+   * *x₂*, …].
+   */
+  mark: 'vectorX';
+}
+
+/** The vectorY mark. */
+export interface VectorY extends MarkData, VectorOptions {
+  /**
+   * Like vector, but **y** instead defaults to the identity function and **x**
+   * defaults to null, assuming that *data* is an array of numbers [*y₀*, *y₁*,
+   * *y₂*, …].
+   */
+  mark: 'vectorY';
+}
+
+/** The spike mark. */
+export interface Spike extends MarkData, VectorOptions {
+  /**
+   * Like vector, but with default *options* suitable for drawing a spike map.
+   */
+  mark: 'spike';
+}

package/src/util.js

@@ -45,3 +45,11 @@ export function isFunction(value) {
 export function error(message, data) {
   throw Object.assign(Error(message), { data });
 }
+
+const re = /^(?:[-+]\d{2})?\d{4}(?:-\d{2}(?:-\d{2})?)?(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d{3})?)?(?:Z|[-+]\d{2}:?\d{2})?)?$/;
+
+// adapted from https://github.com/mbostock/isoformat/
+export function isoparse(string, fallback) {
+  if (!re.test(string += '')) return fallback;
+  return new Date(string);
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "include": ["src/**/*.js", "src/**/*.ts"],
+  "compilerOptions": {
+    "allowJs": true,
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "outDir": "dist/types",
+    "module": "node16",
+    "skipLibCheck": true
+  }
+}

package/LICENSE

@@ -1,47 +0,0 @@
-BSD 3-Clause License
-
-Copyright (c) 2023, UW Interactive Data Lab
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from
-   this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
----
-
-Portions of this software are derived from Observable Plot, which is released
-under the ISC license.
-
-Copyright 2020-2023 Observable, Inc.
-
-Permission to use, copy, modify, and/or distribute this software for any purpose
-with or without fee is hereby granted, provided that the above copyright notice
-and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
-FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
-OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
-TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
-THIS SOFTWARE.