Skip to main content

sass_api 18.0.0
sass_api: ^18.0.0 copied to clipboard

Published 16 days ago •

sass-lang.com• Latest: 18.4.1

[unknown platforms]

5

→

Metadata

Additional APIs for Dart Sass.

18.0.0 #

Add a SelectorNamespace type, along with subtypes DefaultSelectorNamespace, NoSelectorNamespace, AnySelectorNamespace, and NamedSelectorNamespace.
Breaking change: QualifiedName.namespace now uses the new SelectorNamespace type.
Breaking change: String values that are parsed from identifiers now contain the semantic value of those identifiers, with escapes resolved. These are normalized back to escape codes at serialization time.

Interpolation values parsed from identifiers still contain normalized identifiers for expressions. For statements, they now contain the identifier syntax exactly as written in the document.
Breaking change: Parsed Interpolations no longer normalize CSS escapes, which means that Interpolation.asPlain is also are not normalized. Use Interpolation.asPlainIdentifier instead to retrieve a normalized identifier for use in checking for specific keywords.

17.11.2 #

No user-visible changes.

17.11.1 #

No user-visible changes.

17.11.0 #

No user-visible changes.

17.10.1 #

Omit an extra newline that was being added to the end of StyleRule.selector in the indented syntax.

17.10.0 #

No user-visible changes.

17.9.1 #

No user-visible changes.

17.9.0 #

No user-visible changes.

17.8.0 #

No user-visible changes.

17.7.4 #

No user-visible changes.

17.7.3 #

No user-visible changes.

17.7.2 #

No user-visible changes.

17.7.1 #

No user-visible changes.

17.7.0 #

No user-visible changes.

17.6.0 #

Add a logger parameter to SelectorList.parse(), ComplexSelector.parse(), CompoundSelector.parse(), and SimpleSelcetor.parse(). This is used to report deprecations found when parsing selectors.

17.5.0 #

Add an Expression.isPlainCss() method.

17.4.0 #

No user-visible changes.

17.3.3 #

No user-visible changes.

17.3.2 #

No user-visible changes.

17.3.1 #

No user-visible changes.

17.3.0 #

Add the SassColor.displayP3Linear constructor.

17.2.0 #

No user-visible changes.

17.1.0 #

Add support for passing parseSelectors: true to ImportCache and AsyncImportCache.

17.0.0 #

Rename the old IfExpression class to LegacyIfExpression.
Add a new IfExpression class to represent the CSS if() function.
Add a sealed IfConditionExpression class which represents the possible condition components in an IfExpression.
Add a BinaryOperator enumeration and use it for SupportsOperation.operator.
Add an ExpressionVisitable interface for anything visitable by an ExpressionVisitor (currently Expression and IfConditionExpression).
Add a ArgumentList.namedSpans field.

16.0.3 #

Add several members of RecursiveAstVisitor which were missing in the previous release.

16.0.2 #

No user-visible changes.

16.0.1 #

No user-visible changes.

16.0.0 #

Breaking change: InterpolationMap now takes a list of integer offsets rather than a list of SourceLocation objects.
Breaking change: AttributeSelector's op, value, and modifier fields are now CssValues rather than plain values.
Add Interpolated... versions of all the selector AST nodes that are available via the StyleRule.parsedSelector field if parseSelectors: true is passed to Stylesheet.parse(). This makes it easier for tools to interact with selectors despite the fact that the Sass implementation doesn't parse them until after all interpolation has been resolved.
Add a Declaration.notSassScript() constructor for raw CSS declarations such as custom properties and the result property in plain CSS @function rules.

15.12.3 #

No user-visible changes.

15.12.2 #

No user-visible changes.

15.12.1 #

No user-visible changes.

15.12.0 #

No user-visible changes.

15.11.0 #

No user-visible changes.

15.10.0 #

No user-visible changes.

15.9.0 #

No user-visible changes.

15.8.0 #

No user-visible changes.

15.7.1 #

No user-visible changes.

15.7.0 #

Potentially-breaking bug fix: parenthesized, comma-separated lists are now correctly wrapped in a ParenthesizedExpression.

15.6.0 #

No user-visible changes.

15.5.0 #

No user-visible changes.

15.4.0 #

No user-visible changes.

15.3.2 #

No user-visible changes.

15.3.1 #

No user-visible changes.

15.3.0 #

No user-visible changes.

15.2.1 #

No user-visible changes.

15.2.0 #

No user-visible changes.

15.1.0 #

No user-visible changes.

15.0.5-dev #

No user-visible changes.

15.0.4 #

No user-visible changes.

15.0.3 #

No user-visible changes.

15.0.2 #

No user-visible changes.

15.0.1 #

No user-visible changes.

15.0.0 #

Rename ArgumentInvocation to ArgumentList, ArgumentDeclaration to ParameterList, and Argument to Parameter to better match the conventional distinction between "arguments" and "parameters".
Rename ArgumentDeclaration.arguments to ParameterList.parameters, ArgumentDeclaration.restArgument to ParameterList.restParameter, CallableDeclaration.arguments to .parameters.

14.4.1-dev #

No user-visible changes.

14.4.0 #

No user-visible changes.

14.3.0 #

Add NodePackageImporter, which loads pkg: URLs from node_modules within the provided entryPointDirectory.

14.2.0 #

No user-visible changes.

14.1.3 #

No user-visible changes.

14.1.2 #

No user-visible changes.

14.1.1 #

No user-visible changes.

14.1.0 #

Add Expression.isCalculationSafe, which returns true when this expression can safely be used in a calculation.

14.0.0 #

Breaking change: Warnings are no longer emitted during parsing, so the logger parameter has been removed from the following:
- ArgumentDeclaration.parse(), ComplexSelector.parse(), CompoundSelector.parse(), Expression.parse(), SelectorList.parse(), and SimpleSelector.parse().
- Stylesheet.parse(), Stylesheet.parseCss(), Stylesheet.parseSass(), and Stylesheet.parseScss().
- The AsyncImportCache and ImportCache constructors.
Additionally, the quiet parameter has been removed from AsyncImportCache.importCanonical() and ImportCache.importCanonical(), and AsyncImportCache.wrapLogger() and ImportCache.wrapLogger() have been removed entirely.

13.1.2 #

No user-visible changes.

13.1.1 #

Make AsyncImportCache.wrapLogger() and ImportCache.wrapLogger() always limit the repetition of deprecations. this is unlikely to be the long-term behavior, but it's necessary to avoid flooding users with deprecations in the short term.

13.1.0 #

Add AsyncImportCache.wrapLogger() and ImportCache.wrapLogger() methods, which wrap a given logger to apply deprecation options to it.

13.0.1 #

Fix a bug where LoudComments parsed from the indented syntax would include whitespace after the closing */.

13.0.0 #

The Interpolation() constructor now takes an additional List<FileSpan?> spans argument which cover the #{} for expression elements.
Added a new Interpolation.plain() constructor for interpolations that only contain a single plain-text string.
Added Interpolation.spanForElement() which returns the span that covers a single element of contents.
InterpolationBuffer.add() now takes a FileSpan that covers the #{} around the expression.

12.0.5 #

No user-visible changes.

12.0.4 #

No user-visible changes.

12.0.3 #

No user-visible changes.

12.0.2 #

No user-visible changes.

12.0.1 #

No user-visible changes.

12.0.0 #

Breaking change: Remove the SassApiColor.hasCalculatedRgb and .hasCalculatedHsl extension methods. These can now be determined by checking if SassColor.space is KnownColorSpace.rgb or KnownColorSpace.hsl, respectively.
Added a ColorSpace class which represents the various color spaces defined in the CSS spec.
Added SassColor.space which returns a color's color space.
Added SassColor.channels and .channelsOrNull which returns a list of channel values, with missing channels converted to 0 or exposed as null, respectively.
Added SassColor.isLegacy, .isInGamut, .channel(), .isChannelMissing(), .isChannelPowerless(), .toSpace(), .toGamut(), .changeChannels(), and .interpolate() which do the same thing as the Sass functions of the corresponding names.
SassColor.rgb() now allows out-of-bounds and non-integer arguments.
SassColor.hsl() and .hwb() now allow out-of-bounds arguments.
Added SassColor.hwb(), .srgb(), .srgbLinear(), .displayP3(), .a98Rgb(), .prophotoRgb(), .rec2020(), .xyzD50(), .xyzD65(), .lab(), .lch(), .oklab(), .oklch(), and .forSpace() constructors.
Deprecated SassColor.red, .green, .blue, .hue, .saturation, .lightness, .whiteness, and .blackness in favor of SassColor.channel().
Deprecated SassColor.changeRgb(), .changeHsl(), and .changeHwb() in favor of SassColor.changeChannels().
Added SassNumber.convertValueToUnit() as a shorthand for SassNumber.convertValue() with a single numerator.
Added InterpolationMethod and HueInterpolationMethod which collectively represent the method to use to interpolate two colors.
Added the SassApiColorSpace extension to expose additional members of ColorSpace.
Added the ColorChannel class to represent information about a single channel of a color space.
Added SassNumber.convertValueToUnit() as a shorthand for SassNumber.convertValue() with a single numerator.

11.1.0 #

Loud comments in the Sass syntax no longer automatically inject */ to the end when parsed.

11.0.0 #

Remove the CallableDeclaration() constructor.

10.4.8 #

No user-visible changes.

10.4.7 #

No user-visible changes.

10.4.6 #

No user-visible changes.

10.4.5 #

No user-visible changes.

10.4.4 #

No user-visible changes.

10.4.3 #

No user-visible changes.

10.4.2 #

No user-visible changes.

10.4.1 #

No user-visible changes.

10.4.0 #

No user-visible changes.

10.3.0 #

No user-visible changes.

10.2.1 #

No user-visible changes.

10.2.0 #

No user-visible changes.

10.1.1 #

No user-visible changes.

10.1.0 #

No user-visible changes.

10.0.0 #

Remove the allowPlaceholders argument from SelectorList.parse(). Instead, it now has a more generic plainCss argument which tells it to parse the selector in plain CSS mode.
Rename SelectorList.resolveParentSelectors to SelectorList.nestWithin.

9.5.0 #

No user-visible changes.

9.4.2 #

No user-visible changes.

9.4.1 #

No user-visible changes.

9.4.0 #

No user-visible changes.

9.3.0 #

No user-visible changes.

9.2.7 #

No user-visible changes.

9.2.6 #

No user-visible changes.

9.2.5 #

No user-visible changes.

9.2.4 #

No user-visible changes.

9.2.3 #

No user-visible changes.

9.2.2 #

No user-visible changes.

9.2.1 #

No user-visible changes.

9.2.0 #

No user-visible changes.

9.1.0 #

No user-visible changes.

9.0.0 #

Remove the CalculationExpression class and the associated visitor methods.
Add an AstSearchVisitor helper class.
Add an Interpolation.isPlain getter.

8.2.1 #

No user-visible changes.

8.2.0 #

No user-visible changes.

8.1.1 #

No user-visible changes.

8.1.0 #

No user-visible changes.

8.0.0 #

Various classes now use Dart 3 class modifiers to more specifically restrict their usage to the intended patterns.
All uses of classes from the tuple package have been replaced by record types.

7.2.2 #

No user-visible changes.

7.2.1 #

No user-visible changes.

7.2.0 #

No user-visible changes.

7.1.6 #

No user-visible changes.

7.1.5 #

No user-visible changes.

7.1.4 #

No user-visible changes.

7.1.3 #

No user-visible changes.

7.1.2 #

No user-visible changes.

7.1.1 #

No user-visible changes.

7.1.0 #

No user-visible changes.

7.0.0 #

Silent comments in SCSS that are separated by blank lines are now parsed as separate SilentComment nodes rather than a single conjoined node.

6.3.0 #

No user-visible changes.

6.2.0 #

No user-visible changes.

6.1.0 #

No user-visible changes.

6.0.3 #

No user-visible changes.

6.0.2 #

No user-visible changes.

6.0.1 #

No user-visible changes.

6.0.0 #

Breaking change: All selector AST node constructors now require a FileSpan and expose a span field.
Breaking change: The CssStyleRule.selector field is now a plain SelectorList rather than a CssValue<SelectorList>.
Breaking change: The ModifiableCssValue class has been removed.
Add an InterpolationMap class which represents a mapping from an interpolation's source to the string it generated.
Add an interpolationMap parameter to CssMediaQuery.parseList(), AtRootQuery.parse(), ComplexSelector.parse, CompoundSelector.parse, ListSelector.parse, and SimpleSelector.parse.
Add a SelectorSearchVisitor mixin, which can be used to return the first instance of a selector in an AST matching a certain criterion.

5.1.1 #

No user-visible changes.

5.1.0 #

Add BinaryOperation.isAssociative.
Add a ReplaceExpressionVisitor, which recursively visits all expressions in an AST and rebuilds them with replacement components.

5.0.1 #

No user-visible changes.

5.0.0 #

Breaking change: Instead of a Tuple, findDependencies() now returns a DependencyReport object with named fields. This provides finer-grained access to import URLs, as well as information about meta.load-css() calls with non-interpolated string literal arguments.

4.2.2 #

No user-visible changes.

4.2.1 #

No user-visible changes.

4.2.0 #

No user-visible changes.

4.1.2 #

No user-visible changes.

4.1.1 #

No user-visible changes.

4.1.0 #

No user-visible changes.

4.0.0 #

Breaking change: The first argument to NumberExpression() is now a double rather than a num.
Add an optional argumentName parameter to SassScriptException() to make it easier to throw exceptions associated with particular argument names.
Most APIs that previously returned num now return double. All APIs continue to accept num, although in Dart 2.0.0 most of these APIs will be changed to accept only double.

3.0.4 #

UnaryOperationExpressions with operator not now include a correct span, covering the expression itself instead of just the operator.

3.0.3 #

No user-visible changes.

3.0.2 #

No user-visible changes.

3.0.1 #

No user-visible chances.

3.0.0 #

Breaking change: Convert all visitor superclasses into mixins. This includes RecursiveAstVisitor, RecursiveSelectorVisitor, RecursiveStatementVisitor, and StatementSearchVisitor. This has several effects;
- You must use with to mix in visitors rather than extends.
- It's now possible to mix multiple visitors into the same class, which wasn't possible with extends.
- Because mixins can't be composed, when mixing in RecursiveAstVisitor you must explicitly mix in RecursiveStatementVisitor as well.
Breaking change: Replace the minSpecificity and maxSpecificity fields on ComplexSelector, CompoundSelector, and SimpleSelector with a single specificity field.

2.0.4 #

No user-visible changes.

2.0.3 #

No user-visible changes.

2.0.2 #

No user-visible changes.

2.0.1 #

No user-visible changes.

2.0.0 #

Refactor the CssMediaQuery API to support new logical operators:
- Rename the features field to conditions, to reflect the fact that it can contain more than just the <media-feature> production.
- Add a conjunction field to track whether conditions are matched conjunctively or disjunctively.
- Rename the default constructor to CssMediaQuery.type() to reflect the fact that it's no longer by far the most commonly used form of media query.
- Add a required conjunction argument to CssMediaQuery.condition().
- Delete the isCondition getter.
Provide access to Sass's selector AST, including the following classes: Selector, ListSelector, ComplexSelector, ComplexSelectorComponent, Combinator, CompoundSelector, SimpleSelector, AttributeSelector, AttributeOperator, ClassSelector, IdSelector, ParentSelector, PlaceholderSelector, PseudoSelector, TypeSelector, UniversalSelector, and QualifiedName.
Provide access to the SelectorVisitor and RecursiveSelectorVisitor classes.
Provide access to the Value.assertSelector(), Value.assertComplexSelector(), Value.assertCompoundSelector(), and Value.assertSimpleSelector() methods.

1.0.0 #

First stable release.
No user-visible changes since 1.0.0-beta.48.

1.0.0-beta.48 #

No user-visible changes.

1.0.0-beta.47 #

No user-visible changes.

1.0.0-beta.46 #

No user-visible changes.

1.0.0-beta.45 #

Breaking change: Replace StaticImport.supports and StaticImport.media with a unified StaticImport.modifiers field. Same for CssImport.
Add SupportsExpression.

1.0.0-beta.44 #

No user-visible changes.

1.0.0-beta.43 #

No user-visible changes.

1.0.0-beta.42 #

No user-visible changes.

1.0.0-beta.41 #

No user-visible changes.

1.0.0-beta.40 #

No user-visible changes.

1.0.0-beta.39 #

No user-visible changes.

1.0.0-beta.38 #

No user-visible changes.

1.0.0-beta.37 #

No user-visible changes.

1.0.0-beta.36 #

No user-visible changes.

1.0.0-beta.35 #

No user-visible changes.

1.0.0-beta.34 #

No user-visible changes.

1.0.0-beta.33 #

No user-visible changes.

1.0.0-beta.32 #

No user-visible changes.

1.0.0-beta.31 #

No user-visible changes.

1.0.0-beta.30 #

No user-visible changes.

1.0.0-beta.29 #

No user-visible changes.

1.0.0-beta.28 #

No user-visible changes.

1.0.0-beta.27 #

No user-visible changes.

1.0.0-beta.26 #

No user-visible changes.

1.0.0-beta.25 #

No user-visible changes.

1.0.0-beta.24 #

No user-visible changes.

1.0.0-beta.23 #

No user-visible changes.

1.0.0-beta.22 #

No user-visible changes.

1.0.0-beta.21 #

No user-visible changes.

1.0.0-beta.20 #

No user-visible changes.

1.0.0-beta.19 #

No user-visible changes.

1.0.0-beta.18 #

No user-visible changes.

1.0.0-beta.17 #

No user-visible changes.

1.0.0-beta.16 #

No user-visible changes.

1.0.0-beta.15 #

Fix an issue where RecursiveAstVisitor was not implementing visitCalculationExpression.

1.0.0-beta.14 #

Fix a bug where RecursiveAstVisitor.visitAtRootRule wouldn't visit any nodes interpolated into the @at-root's query.

1.0.0-beta.13 #

No user-visible changes.

1.0.0-beta.12 #

No user-visible changes.

1.0.0-beta.11 #

No user-visible changes.

1.0.0-beta.10 #

No user-visible changes.

1.0.0-beta.9 #

Add the CalculationExpression type to represent calculations in the Sass AST.
Add the ExpressionVisitor.visitCalculationExpression method.

1.0.0-beta.8 #

No user-visible changes.

1.0.0-beta.7 #

No user-visible changes.

1.0.0-beta.6 #

Add the SassApiColor extension to the "Value" DartDoc category.

1.0.0-beta.5 #

Add SassColor.hasCalculatedRgb and .hasCalculatedHsl extension getters.

1.0.0-beta.4 #

UseRule, ForwardRule, and DynamicImport now share a common Dependency interface that exposes a url getter and a urlSpan getter.
VariableDeclaration, MixinRule, FunctionRule, Argument, and ConfiguredVariable now share a common SassDeclaration interface that exposes a name getter (with underscores converted to hyphens) and a nameSpan getter.
Function calls with interpolation have now been split into their own AST node: InterpolatedFunctionExpression. FunctionExpression.name is now always a string (with underscores converted to hyphens). FunctionExpression also now has an originalName getter, which leaves underscores as-is.
VariableExpression, IncludeRule, and FunctionExpression now share a common SassReference interface that exposes a namespace getter and a name getter (with underscores converted to hyphens), as well as corresponding namespaceSpan and nameSpan getters.

1.0.0-beta.3 #

No user-visible changes.

1.0.0-beta.2 #

No user-visible changes.

1.0.0-beta.1 #

Initial beta release.

← Metadata

Publisher

Weekly Downloads

Metadata

Additional APIs for Dart Sass.

Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

More

Packages that depend on sass_api