Renamed! This package has been renamed to @sass-fairy/meta and organised in a mono-repo for better maintainablity, an improved user experience, and full documentation. Explore more about the change at sass-fairy.com.

This Sass module provides more advanced meta functions.

Install the package:

npm install sass-meta

Use the package like any other Sass module:

@use 'sass-meta';

Depending on your setup, you may need to configure node_modules as include path:

const sass = require('sass');

sass.render({
  file: scss_filename,
  includePaths: ['node_modules']
});

call-or-reference ( $function, $args... )

Allows a function to return its reference when no parameters are provided, otherwise maintaining its regular behavior.

get-keyword ( $args, $name [, $default] )

Gets the value of the named parameter from the given argument list, otherwise providing a default value.

Don't see the function you're looking for? Request a new feature describing a use case.

In order to avoid constantly declaring both the native 'sass:meta' module and this library, the combined API has been added which merges the two.

// Rather than using both modules separately...
@use 'sass-meta';
@use 'sass:meta';

// ...this statement will accomplish the same thing.
@use 'sass-meta/meta';