sass-embedded 1.0.0-beta.4 → 1.0.0-rc.1

package/dist/lib/src/value/number.d.ts

@@ -1,189 +0,0 @@
-import { List } from 'immutable';
-import { Value } from './value';
-/** A SassScript number. */
-export declare class SassNumber extends Value {
-    private valueInternal;
-    private numeratorUnitsInternal;
-    private denominatorUnitsInternal;
-    /** Creates a number, optionally with a single numerator unit. */
-    constructor(value: number, unit?: string);
-    /**
-     * Creates a number with `numeratorUnits` and `denominatorUnits`.
-     *
-     * Upon construction, any compatible numerator and denominator units are
-     * simplified away according to the conversion factor between them.
-     */
-    static withUnits(value: number, options?: {
-        numeratorUnits?: string[] | List<string>;
-        denominatorUnits?: string[] | List<string>;
-    }): SassNumber;
-    /** `this`'s value. */
-    get value(): number;
-    /** Whether `value` is an integer. */
-    get isInt(): boolean;
-    /**
-     * If `value` is an integer according to `isInt`, returns `value` rounded to
-     * that integer.
-     *
-     * Otherwise, returns null.
-     */
-    get asInt(): number | null;
-    /** `this`'s numerator units. */
-    get numeratorUnits(): List<string>;
-    /** `this`'s denominator units. */
-    get denominatorUnits(): List<string>;
-    /** Whether `this` has any units. */
-    get hasUnits(): boolean;
-    assertNumber(): SassNumber;
-    /**
-     * If `value` is an integer according to `isInt`, returns it as an integer.
-     *
-     * Otherwise, throws an error.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertInt(name?: string): number;
-    /**
-     * If `value` is within `min` and `max`, returns `value`, or if it
-     * `fuzzyEquals` `min` or `max`, returns `value` clamped to that value.
-     *
-     * Otherwise, throws an error.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertInRange(min: number, max: number, name?: string): number;
-    /**
-     * If `this` has no units, returns `this`.
-     *
-     * Otherwise, throws an error.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertNoUnits(name?: string): SassNumber;
-    /**
-     * If `this` has `unit` as its only unit (and as a numerator), returns `this`.
-     *
-     * Otherwise, throws an error.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertUnit(unit: string, name?: string): SassNumber;
-    /** Whether `this` has `unit` as its only unit (and as a numerator). */
-    hasUnit(unit: string): boolean;
-    /** Whether `this` is compatible with `unit`. */
-    compatibleWithUnit(unit: string): boolean;
-    /**
-     * Returns a copy of `this`, converted to the units represented by
-     * `newNumerators` and `newDenominators`.
-     *
-     * Throws an error if `this`'s units are incompatible with `newNumerators` and
-     * `newDenominators`. Also throws an error if `this` is unitless and either
-     * `newNumerators` or `newDenominators` are not empty, or vice-versa.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    convert(newNumerators: string[] | List<string>, newDenominators: string[] | List<string>, name?: string): SassNumber;
-    /**
-     * Returns `value`, converted to the units represented by `newNumerators` and
-     * `newDenominators`.
-     *
-     * Throws an error if `this`'s units are incompatible with `newNumerators` and
-     * `newDenominators`. Also throws an error if `this` is unitless and either
-     * `newNumerators` or `newDenominators` are not empty, or vice-versa.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    convertValue(newNumerators: string[] | List<string>, newDenominators: string[] | List<string>, name?: string): number;
-    /**
-     * Returns a copy of `this`, converted to the same units as `other`.
-     *
-     * Throws an error if `this`'s units are incompatible with `other`'s units, or
-     * if either number is unitless but the other is not.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * and `otherName` is the argument name for `other` (both without the `$`).
-     * They are used for error reporting.
-     */
-    convertToMatch(other: SassNumber, name?: string, otherName?: string): SassNumber;
-    /**
-     * Returns `value`, converted to the same units as `other`.
-     *
-     * Throws an error if `this`'s units are incompatible with `other`'s units, or
-     * if either number is unitless but the other is not.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * and `otherName` is the argument name for `other` (both without the `$`).
-     * They are used for error reporting.
-     */
-    convertValueToMatch(other: SassNumber, name?: string, otherName?: string): number;
-    /**
-     * Returns a copy of `this`, converted to the units represented by
-     * `newNumerators` and `newDenominators`.
-     *
-     * Does *not* throw an error if this number is unitless and either
-     * `newNumerators` or `newDenominators` are not empty, or vice-versa. Instead,
-     * it treats all unitless numbers as convertible to and from all units
-     * without changing the value.
-     *
-     * Throws an error if `this`'s units are incompatible with `newNumerators` and
-     * `newDenominators`.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    coerce(newNumerators: string[] | List<string>, newDenominators: string[] | List<string>, name?: string): SassNumber;
-    /**
-     * Returns `value`, converted to the units represented by `newNumerators` and
-     * `newDenominators`.
-     *
-     * Does *not* throw an error if this number is unitless and either
-     * `newNumerators` or `newDenominators` are not empty, or vice-versa. Instead,
-     * it treats all unitless numbers as convertible to and from all units
-     * without changing the value.
-     *
-     * Throws an error if `this`'s units are incompatible with `newNumerators` and
-     * `newDenominators`.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    coerceValue(newNumerators: string[] | List<string>, newDenominators: string[] | List<string>, name?: string): number;
-    /**
-     * Returns a copy of `this`, converted to the same units as `other`.
-     *
-     * Does *not* throw an error if `this` is unitless and `other` is not, or
-     * vice-versa. Instead, it treats all unitless numbers as convertible to and
-     * from all units without changing the value.
-     *
-     * Throws an error if `this`'s units are incompatible with `other`'s units.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * and `otherName` is the argument name for `other` (both without the `$`).
-     * They are used for error reporting.
-     */
-    coerceToMatch(other: SassNumber, name?: string, otherName?: string): SassNumber;
-    /**
-     * Returns `value`, converted to the same units as `other`.
-     *
-     * Does *not* throw an error if `this` is unitless and `other` is not, or
-     * vice-versa. Instead, it treats all unitless numbers as convertible to and
-     * from all units without changing the value.
-     *
-     * Throws an error if `this`'s units are incompatible with `other`'s units.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * and `otherName` is the argument name for `other` (both without the `$`).
-     * They are used for error reporting.
-     */
-    coerceValueToMatch(other: SassNumber, name?: string, otherName?: string): number;
-    equals(other: Value): boolean;
-    hashCode(): number;
-    toString(): string;
-    private convertOrCoerce;
-}

package/dist/lib/src/value/string.d.ts

@@ -1,56 +0,0 @@
-import { Value } from './value';
-/** A SassScript string. */
-export declare class SassString extends Value {
-    private readonly textInternal;
-    private readonly hasQuotesInternal;
-    /** Creates a string with `text`, optionally with quotes. */
-    constructor(text: string, options?: {
-        quotes?: boolean;
-    });
-    /** Creates an empty string, optionally with quotes. */
-    static empty(options?: {
-        quotes?: boolean;
-    }): SassString;
-    /** `this`'s text. */
-    get text(): string;
-    /** Whether `this` has quotes. */
-    get hasQuotes(): boolean;
-    assertString(): SassString;
-    /**
-     * Sass's notion of `this`'s length.
-     *
-     * Sass treats strings as a series of Unicode code points while JS treats them
-     * as a series of UTF-16 code units. For example, the character U+1F60A,
-     * Smiling Face With Smiling Eyes, is a single Unicode code point but is
-     * represented in UTF-16 as two code units (`0xD83D` and `0xDE0A`). So in
-     * JS, `"n😊b".length` returns `4`, whereas in Sass `string.length("n😊b")`
-     * returns `3`.
-     */
-    sassLength(): number;
-    /**
-     * Converts `sassIndex` to a JS index into `text`.
-     *
-     * Sass indices are one-based, while JS indices are zero-based. Sass
-     * indices may also be negative in order to index from the end of the string.
-     *
-     * In addition, Sass indices refer to Unicode code points while JS string
-     * indices refer to UTF-16 code units. For example, the character U+1F60A,
-     * Smiling Face With Smiling Eyes, is a single Unicode code point but is
-     * represented in UTF-16 as two code units (`0xD83D` and `0xDE0A`). So in
-     * JS, `"n😊b".charAt(1)` returns `0xD83D`, whereas in Sass
-     * `string.slice("n😊b", 1, 1)` returns `"😊"`.
-     *
-     * This function converts Sass's code point indices to JS's code unit
-     * indices. This means it's O(n) in the length of `text`.
-     *
-     * Throws an error `sassIndex` isn't a number, if that number isn't an
-     * integer, or if that integer isn't a valid index for this string.
-     *
-     * If `sassIndex` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    sassIndexToStringIndex(sassIndex: Value, name?: string): number;
-    equals(other: Value): boolean;
-    hashCode(): number;
-    toString(): string;
-}

package/dist/lib/src/value/utils.d.ts

@@ -1,36 +0,0 @@
-/** The precision of Sass numbers. */
-export declare const precision = 10;
-/** Whether `num1` and `num2` are equal within `epsilon`. */
-export declare function fuzzyEquals(num1: number, num2: number): boolean;
-/**
- * Returns a hash code for `num`.
- *
- * Two numbers that `fuzzyEquals` each other must have the same hash code.
- */
-export declare function fuzzyHashCode(num: number): number;
-/** Whether `num1` < `num2`, within `epsilon`. */
-export declare function fuzzyLessThan(num1: number, num2: number): boolean;
-/** Whether `num1` <= `num2`, within `epsilon`. */
-export declare function fuzzyLessThanOrEquals(num1: number, num2: number): boolean;
-/** Whether `num1` > `num2`, within `epsilon`. */
-export declare function fuzzyGreaterThan(num1: number, num2: number): boolean;
-/** Whether `num1` >= `num2`, within `epsilon`. */
-export declare function fuzzyGreaterThanOrEquals(num1: number, num2: number): boolean;
-/** Whether `num` `fuzzyEquals` an integer. */
-export declare function fuzzyIsInt(num: number): boolean;
-/**
- * If `num` `fuzzyIsInt`, returns it as an integer. Otherwise, returns `null`.
- */
-export declare function fuzzyAsInt(num: number): number | null;
-/**
- * Rounds `num` to the nearest integer.
- *
- * If `num` `fuzzyEquals` `x.5`, rounds away from zero.
- */
-export declare function fuzzyRound(num: number): number;
-/**
- * Returns `num` if it's within `min` and `max`, or `null` if it's not.
- *
- * If `num` `fuzzyEquals` `min` or `max`, it gets clamped to that value.
- */
-export declare function fuzzyInRange(num: number, min: number, max: number): number | null;

package/dist/lib/src/value/value.d.ts

@@ -1,103 +0,0 @@
-import { List, OrderedMap, ValueObject } from 'immutable';
-import { SassBoolean } from './boolean';
-import { SassNumber } from './number';
-import { SassString } from './string';
-/**
- * A SassScript value.
- *
- * All SassScript values are immutable.
- *
- * Concrete values (such as `SassColor`) are implemented as subclasses and get
- * instantiated as normal JS classes.
- *
- * Untyped values can be cast to particular types using `assert*()` functions,
- * which throw user-friendly error messages if they fail.
- *
- * All values, except `false` and `null`, count as `true`.
- *
- * All values can be used as lists. Maps count as lists of pairs, while all
- * other values count as single-value lists.
- */
-export declare abstract class Value implements ValueObject {
-    /** Whether `this` counts as `true`. */
-    get isTruthy(): boolean;
-    /** Returns JS null if `this` is `sassNull`. Otherwise, returns `this`. */
-    get realNull(): Value | null;
-    /** `this` as a list. */
-    get asList(): List<Value>;
-    /** The separator for `this` as a list. */
-    get separator(): null;
-    /** Whether `this`, as a list, has brackets. */
-    get hasBrackets(): boolean;
-    /**
-     * Converts `sassIndex` to a JS index into the array returned by `asList`.
-     *
-     * Sass indices start counting at 1, and may be negative in order to index
-     * from the end of the list.
-     *
-     * `sassIndex` must be...
-     * - a number, and
-     * - an integer, and
-     * - a valid index into `asList`.
-     *
-     * Otherwise, this throws an error.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    sassIndexToListIndex(sassIndex: Value, name?: string): number;
-    /**
-     * Casts `this` to `SassBoolean`; throws if `this` isn't a boolean.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertBoolean(name?: string): SassBoolean;
-    /**
-     * Casts `this` to `SassColor`; throws if `this` isn't a color.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertColor(name?: string): Value;
-    /**
-     * Casts `this` to `SassFunction`; throws if `this` isn't a function
-     * reference.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertFunction(name?: string): Value;
-    /**
-     * Casts `this` to `SassMap`; throws if `this` isn't a map.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertMap(name?: string): Value;
-    /**
-     * Returns `this` as a `SassMap` if it counts as one (including empty lists),
-     * or `null` if it does not.
-     */
-    tryMap(): OrderedMap<Value, Value> | null;
-    /**
-     * Casts `this` to `SassString`; throws if `this` isn't a string.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertNumber(name?: string): SassNumber;
-    /**
-     * Casts `this` to `SassString`; throws if `this` isn't a string.
-     *
-     * If `this` came from a function argument, `name` is the argument name
-     * (without the `$`) and is used for error reporting.
-     */
-    assertString(name?: string): SassString;
-    /** Whether `this == other` in SassScript. */
-    abstract equals(other: Value): boolean;
-    /** This is the same for values that are `==` in SassScript. */
-    abstract hashCode(): number;
-    /** A meaningful descriptor for this value. */
-    abstract toString(): string;
-}

package/dist/lib/src/value/value.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"value.js","sourceRoot":"","sources":["../../../../lib/src/value/value.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,gEAAgE;AAChE,uCAAuC;;AAEvC,yCAAwD;AAKxD,oCAAoC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,MAAsB,KAAK;IACzB,uCAAuC;IACvC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0EAA0E;IAC1E,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM;QACR,OAAO,gBAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,0CAA0C;IAC1C,IAAI,SAAS;QACX,OAAO,IAAI,CAAC;QACZ,+DAA+D;IACjE,CAAC;IAED,+CAA+C;IAC/C,IAAI,WAAW;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,oBAAoB,CAAC,SAAgB,EAAE,IAAa;QAClD,cAAc;QACd,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,IAAa;QACzB,MAAM,kBAAU,CAAC,GAAG,IAAI,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAa;QACvB,MAAM,kBAAU,CAAC,GAAG,IAAI,iBAAiB,EAAE,IAAI,CAAC,CAAC;QACjD,oDAAoD;IACtD,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,IAAa;QAC1B,MAAM,kBAAU,CAAC,GAAG,IAAI,8BAA8B,EAAE,IAAI,CAAC,CAAC;QAC9D,uDAAuD;IACzD,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,IAAa;QACrB,MAAM,kBAAU,CAAC,GAAG,IAAI,eAAe,EAAE,IAAI,CAAC,CAAC;QAC/C,kDAAkD;IACpD,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,IAAa;QACxB,MAAM,kBAAU,CAAC,GAAG,IAAI,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,IAAa;QACxB,MAAM,kBAAU,CAAC,GAAG,IAAI,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;CAUF;AAhID,sBAgIC"}

package/dist/lib/src/vendor/embedded-protocol/embedded_sass_pb.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tool/utils.d.ts

@@ -1,32 +0,0 @@
-/**
- * Gets the Embedded Protocol.
- *
- * Can download the release `version`, check out and build the source from a Git
- * `ref`, or build from the source at `path`.
- *
- * By default, downloads the release version specified in package.json. Throws
- * if an error occurs.
- */
-export declare function getEmbeddedProtocol(outPath: string, options?: {
-    version: string;
-} | {
-    ref: string;
-} | {
-    path: string;
-}): Promise<void>;
-/**
- * Gets the Dart Sass wrapper for the Embedded Compiler.
- *
- * Can download the release `version`, check out and build the source from a Git
- * `ref`, or build from the source at `path`.
- *
- * By default, downloads the release version specified in package.json. Throws
- * if an error occurs.
- */
-export declare function getDartSassEmbedded(outPath: string, options?: {
-    version: string;
-} | {
-    ref: string;
-} | {
-    path: string;
-}): Promise<void>;