@localnerve/sass-asset-functions/lib/modernAPISync.js

compass-style asset functions for dart-sass or other sass compilers

/**
 * Custom Functions for synchronous, sass modern JS API (compile).
 * 
 * Copyright (c) 2023-2025 Alex Grant (@localnerve), LocalNerve LLC
 * Licensed under the MIT license.
 */

import { convertToSassTypesModern } from './types.js';

export default function modernAPISync (sass, processor) {
  return {
    'image-url($filename, $only_path: false)': args => {
      const filename = args[0].assertString('filename').text;
      const only_path = args[1].assertBoolean('only_path').isTruthy;
      let result = sass.sassNull;
      processor.image_url(filename, url => {
        if (!only_path) url = `url('${url}')`;
        result = new sass.SassString(url, { quotes: false });
      });
      return result;
    },
    'inline-image($filename, $mime_type: null)': args => {
      const filename = args[0].assertString('filename').text;
      const mime_type = args[1].realNull === null ? null : args[1].assertString('mime_type').text;
      let result = sass.sassNull;
      processor.inline_image(filename, mime_type, dataUrl => {
        result = new sass.SassString(`url('${dataUrl}')`, { quotes: false });
      });
      return result;
    },
    'image-width($filename)': args => {
      const filename = args[0].assertString('filename').text;
      let result = sass.sassNull;
      processor.image_width(filename, image_width => {
        result = new sass.SassNumber(image_width, 'px');
      });
      return result;
    },
    'image-height($filename)': args => {
      const filename = args[0].assertString('filename').text;
      let result = sass.sassNull;
      processor.image_height(filename, image_height => {
        result = new sass.SassNumber(image_height, 'px');
      });
      return result;
    },
    'font-url($filename, $only-path: false)': args => {
      const filename = args[0].assertString('filename').text;
      const only_path = args[1].assertBoolean('only_path').isTruthy;
      let result = sass.sassNull;
      processor.font_url(filename, url => {
        if (!only_path) url = `url('${url}')`;
        result = new sass.SassString(url, { quotes: false });
      });
      return result;
    },
    'font-files($filenames...)': args => {
      const input = args[0].asList;
      const filenames = [];
      const result = [];
      for(let i = 0; i < input.size; ++i) {
        filenames[i] = input.get(i).assertString().text;
      }
      processor.font_files(filenames, files => {
        for (let i = 0; i < files.length; ++i) {
          result[i] = new sass.SassString(`url('${files[i].url}') format('${files[i].type}')`, { quotes: false });
        }
      });
      return new sass.SassList(result);
    },
    'lookup($keys...)': args => {
      const input = args[0].asList;
      const keys = [];
      for (let i = 0; i < input.size; ++i) {
        keys[i] = input.get(i).assertString().text;
      }
      let result = sass.sassNull;
      processor.lookup(keys, value => {
        result = convertToSassTypesModern(sass, value);
      });
      return result;
    }
  };
}