sassc4 2.4.0

data/lib/sassc/functions_handler.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module SassC
+  class FunctionsHandler
+    def initialize(options)
+      @options = options
+    end
+
+    def setup(native_options, functions: Script::Functions)
+      @callbacks = {}
+      @function_names = {}
+
+      list = Native.make_function_list(Script.custom_functions(functions: functions).count)
+
+      # use an anonymous class wrapper to avoid mutations in a threaded environment
+      functions_wrapper = Class.new do
+        attr_accessor :options
+        include functions
+      end.new
+      functions_wrapper.options = @options
+
+      Script.custom_functions(functions: functions).each_with_index do |custom_function, i|
+        @callbacks[custom_function] = FFI::Function.new(:pointer, [:pointer, :pointer]) do |native_argument_list, cookie|
+          begin
+            function_arguments = arguments_from_native_list(native_argument_list)
+            result = functions_wrapper.send(custom_function, *function_arguments)
+            to_native_value(result)
+          rescue StandardError => exception
+            # This rescues any exceptions that occur either in value conversion
+            # or during the execution of a custom function.
+            error(exception.message)
+          end
+        end
+
+        @function_names[custom_function] = Script.formatted_function_name(custom_function, functions: functions)
+
+        callback = Native.make_function(
+          @function_names[custom_function],
+          @callbacks[custom_function],
+          nil
+        )
+
+        Native::function_set_list_entry(list, i, callback)
+      end
+
+      Native::option_set_c_functions(native_options, list)
+    end
+
+    private
+
+    def arguments_from_native_list(native_argument_list)
+      native_argument_list_length = Native.list_get_length(native_argument_list)
+
+      (0...native_argument_list_length).map do |i|
+        native_value = Native.list_get_value(native_argument_list, i)
+        Script::ValueConversion.from_native(native_value, @options)
+      end.compact
+    end
+
+    def to_native_value(sass_value)
+      # if the custom function returns nil, we provide a "default" return
+      # value of an empty string
+      sass_value ||= SassC::Script::Value::String.new("")
+      sass_value.options = @options
+      Script::ValueConversion.to_native(sass_value)
+    end
+
+    def error(message)
+      $stderr.puts "[SassC::FunctionsHandler] #{message}"
+      Native.make_error(message)
+    end
+  end
+end

data/lib/sassc/import_handler.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module SassC
+  class ImportHandler
+    def initialize(options)
+      @importer = if options[:importer]
+        options[:importer].new(options)
+      else
+        nil
+      end
+    end
+
+    def setup(native_options)
+      return unless @importer
+
+      importer_callback = Native.make_importer(import_function, nil)
+
+      list = Native.make_function_list(1)
+      Native::function_set_list_entry(list, 0, importer_callback)
+
+      Native.option_set_c_importers(native_options, list)
+    end
+
+    private
+
+    def import_function
+      @import_function ||= FFI::Function.new(:pointer, [:string, :pointer, :pointer]) do |path, importer_entry, compiler|
+        last_import = Native::compiler_get_last_import(compiler)
+        parent_path = Native::import_get_abs_path(last_import)
+
+        imports = [*@importer.imports(path, parent_path)]
+        imports_to_native(imports)
+      end
+    end
+
+    def imports_to_native(imports)
+      import_list = Native.make_import_list(imports.size)
+
+      imports.each_with_index do |import, i|
+        source = import.source ? Native.native_string(import.source) : nil
+        source_map_path = nil
+
+        entry = Native.make_import_entry(import.path, source, source_map_path)
+        Native.import_set_list_entry(import_list, i, entry)
+      end
+
+      import_list
+    end
+  end
+end

data/lib/sassc/importer.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module SassC
+  class Importer
+    attr_reader :options
+
+    def initialize(options)
+      @options = options
+    end
+
+    def imports(path, parent_path)
+      # A custom importer must override this method.
+      # Custom importer may return an Import, or an array of Imports.
+      raise NotImplementedError
+    end
+
+    class Import
+      attr_accessor :path, :source, :source_map_path
+
+      def initialize(path, source: nil, source_map_path: nil)
+        @path = path
+        @source = source
+        @source_map_path = source_map_path
+      end
+
+      def to_s
+        "Import: #{path} #{source} #{source_map_path}"
+      end
+    end
+  end
+end

data/lib/sassc/native/native_context_api.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    attach_function :version, :libsass_version, [], :string
+
+    # Create and initialize an option struct
+    # ADDAPI struct Sass_Options* ADDCALL sass_make_options (void);
+    attach_function :sass_make_options, [], :sass_options_ptr
+
+    # Create and initialize a specific context
+    # ADDAPI struct Sass_File_Context* ADDCALL sass_make_file_context (const char* input_path);
+    # ADDAPI struct Sass_Data_Context* ADDCALL sass_make_data_context (char* source_string);
+    attach_function :sass_make_file_context, [:string], :sass_file_context_ptr
+    attach_function :_make_data_context, :sass_make_data_context, [:pointer], :sass_data_context_ptr
+
+    def self.make_data_context(data)
+      _make_data_context(Native.native_string(data))
+    end
+
+    # Call the compilation step for the specific context
+    # ADDAPI int ADDCALL sass_compile_file_context (struct Sass_File_Context* ctx);
+    # ADDAPI int ADDCALL sass_compile_data_context (struct Sass_Data_Context* ctx);
+    attach_function :sass_compile_file_context, [:sass_file_context_ptr], :int
+    attach_function :sass_compile_data_context, [:sass_data_context_ptr], :int
+
+    # Create a sass compiler instance for more control
+    # ADDAPI struct Sass_Compiler* ADDCALL sass_make_file_compiler (struct Sass_File_Context* file_ctx);
+    # ADDAPI struct Sass_Compiler* ADDCALL sass_make_data_compiler (struct Sass_Data_Context* data_ctx);
+
+    # Execute the different compilation steps individually
+    # Usefull if you only want to query the included files
+    # ADDAPI int ADDCALL sass_compiler_parse(struct Sass_Compiler* compiler);
+    # ADDAPI int ADDCALL sass_compiler_execute(struct Sass_Compiler* compiler);
+
+    # Release all memory allocated with the compiler
+    # This does _not_ include any contexts or options
+    # ADDAPI void ADDCALL sass_delete_compiler(struct Sass_Compiler* compiler);
+
+    # Release all memory allocated and also ourself
+    # ADDAPI void ADDCALL sass_delete_file_context (struct Sass_File_Context* ctx);
+    # ADDAPI void ADDCALL sass_delete_data_context (struct Sass_Data_Context* ctx);
+    attach_function :sass_delete_file_context, [:sass_file_context_ptr], :void
+    attach_function :sass_delete_data_context, [:sass_data_context_ptr], :void
+
+    # Getters for context from specific implementation
+    # ADDAPI struct Sass_Context* ADDCALL sass_file_context_get_context (struct Sass_File_Context* file_ctx);
+    # ADDAPI struct Sass_Context* ADDCALL sass_data_context_get_context (struct Sass_Data_Context* data_ctx);
+    attach_function :sass_file_context_get_context, [:sass_file_context_ptr], :sass_context_ptr
+    attach_function :sass_data_context_get_context, [:sass_data_context_ptr], :sass_context_ptr
+
+    # Getters for context options from Sass_Context
+    # ADDAPI struct Sass_Options* ADDCALL sass_context_get_options (struct Sass_Context* ctx);
+    # ADDAPI struct Sass_Options* ADDCALL sass_file_context_get_options (struct Sass_File_Context* file_ctx);
+    # ADDAPI struct Sass_Options* ADDCALL sass_data_context_get_options (struct Sass_Data_Context* data_ctx);
+    # ADDAPI void ADDCALL sass_file_context_set_options (struct Sass_File_Context* file_ctx, struct Sass_Options* opt);
+    # ADDAPI void ADDCALL sass_data_context_set_options (struct Sass_Data_Context* data_ctx, struct Sass_Options* opt);
+    attach_function :sass_context_get_options, [:sass_context_ptr], :sass_options_ptr
+    attach_function :sass_file_context_get_options, [:sass_file_context_ptr], :sass_options_ptr
+    attach_function :sass_data_context_get_options, [:sass_data_context_ptr], :sass_options_ptr
+    attach_function :sass_file_context_set_options, [:sass_file_context_ptr, :sass_options_ptr], :void
+    attach_function :sass_data_context_set_options, [:sass_data_context_ptr, :sass_options_ptr], :void
+
+    # Getters for options
+    # ADDAPI int ADDCALL sass_option_get_precision (struct Sass_Options* options);
+    # ADDAPI enum Sass_Output_Style ADDCALL sass_option_get_output_style (struct Sass_Options* options);
+    # ADDAPI bool ADDCALL sass_option_get_source_comments (struct Sass_Options* options);
+    # ADDAPI bool ADDCALL sass_option_get_source_map_embed (struct Sass_Options* options);
+    # ADDAPI bool ADDCALL sass_option_get_source_map_contents (struct Sass_Options* options);
+    # ADDAPI bool ADDCALL sass_option_get_omit_source_map_url (struct Sass_Options* options);
+    # ADDAPI bool ADDCALL sass_option_get_is_indented_syntax_src (struct Sass_Options* options);
+    # ADDAPI const char* ADDCALL sass_option_get_input_path (struct Sass_Options* options);
+    # ADDAPI const char* ADDCALL sass_option_get_output_path (struct Sass_Options* options);
+    # ADDAPI const char* ADDCALL sass_option_get_include_path (struct Sass_Options* options);
+    # ADDAPI const char* ADDCALL sass_option_get_source_map_file (struct Sass_Options* options);
+    # ADDAPI Sass_C_Function_List ADDCALL sass_option_get_c_functions (struct Sass_Options* options);
+    attach_function :sass_option_get_precision, [:sass_options_ptr], :int
+    attach_function :sass_option_get_output_style, [:sass_options_ptr], SassOutputStyle
+    attach_function :sass_option_get_source_comments, [:sass_options_ptr], :bool
+    attach_function :sass_option_get_source_map_embed, [:sass_options_ptr], :bool
+    attach_function :sass_option_get_source_map_contents, [:sass_options_ptr], :bool
+    attach_function :sass_option_get_omit_source_map_url, [:sass_options_ptr], :bool
+    attach_function :sass_option_get_is_indented_syntax_src, [:sass_options_ptr], :bool
+    attach_function :sass_option_get_input_path, [:sass_options_ptr], :string
+    attach_function :sass_option_get_output_path, [:sass_options_ptr], :string
+    attach_function :sass_option_get_include_path, [:sass_options_ptr], :string
+    attach_function :sass_option_get_source_map_file, [:sass_options_ptr], :string
+    attach_function :sass_option_get_c_functions, [:sass_options_ptr], :sass_c_function_list_ptr
+    # ADDAPI Sass_C_Import_Callback ADDCALL sass_option_get_importer (struct Sass_Options* options);
+
+    # Setters for options
+    # ADDAPI void ADDCALL sass_option_set_precision (struct Sass_Options* options, int precision);
+    # ADDAPI void ADDCALL sass_option_set_output_style (struct Sass_Options* options, enum Sass_Output_Style output_style);
+    # ADDAPI void ADDCALL sass_option_set_source_comments (struct Sass_Options* options, bool source_comments);
+    # ADDAPI void ADDCALL sass_option_set_source_map_embed (struct Sass_Options* options, bool source_map_embed);
+    # ADDAPI void ADDCALL sass_option_set_source_map_contents (struct Sass_Options* options, bool source_map_contents);
+    # ADDAPI void ADDCALL sass_option_set_omit_source_map_url (struct Sass_Options* options, bool omit_source_map_url);
+    # ADDAPI void ADDCALL sass_option_set_is_indented_syntax_src (struct Sass_Options* options, bool is_indented_syntax_src);
+    # ADDAPI void ADDCALL sass_option_set_input_path (struct Sass_Options* options, const char* input_path);
+    # ADDAPI void ADDCALL sass_option_set_output_path (struct Sass_Options* options, const char* output_path);
+    # ADDAPI void ADDCALL sass_option_set_include_path (struct Sass_Options* options, const char* include_path);
+    # ADDAPI void ADDCALL sass_option_set_source_map_file (struct Sass_Options* options, const char* source_map_file);
+    # ADDAPI void ADDCALL sass_option_set_c_functions (struct Sass_Options* options, Sass_C_Function_List c_functions);
+    # ADDAPI void ADDCALL sass_option_set_c_importers (struct Sass_Options* options, Sass_Importer_List c_importers);
+    attach_function :sass_option_set_precision, [:sass_options_ptr, :int], :void
+    attach_function :sass_option_set_output_style, [:sass_options_ptr, SassOutputStyle], :void
+    attach_function :sass_option_set_source_comments, [:sass_options_ptr, :bool], :void
+    attach_function :sass_option_set_source_map_embed, [:sass_options_ptr, :bool], :void
+    attach_function :sass_option_set_source_map_contents, [:sass_options_ptr, :bool], :void
+    attach_function :sass_option_set_omit_source_map_url, [:sass_options_ptr, :bool], :void
+    attach_function :sass_option_set_is_indented_syntax_src, [:sass_options_ptr, :bool], :void
+    attach_function :sass_option_set_input_path, [:sass_options_ptr, :string], :void
+    attach_function :sass_option_set_output_path, [:sass_options_ptr, :string], :void
+    attach_function :sass_option_set_include_path, [:sass_options_ptr, :string], :void
+    attach_function :sass_option_set_source_map_file, [:sass_options_ptr, :string], :void
+    attach_function :sass_option_set_c_functions, [:sass_options_ptr, :pointer], :void
+    attach_function :sass_option_set_c_importers, [:sass_options_ptr, :pointer], :void
+    #attach_function :sass_option_set_c_importers, [:sass_options_ptr, :sass_importer], :void
+
+    # Getter for context
+    # ADDAPI const char* ADDCALL sass_context_get_output_string (struct Sass_Context* ctx);
+    # ADDAPI int ADDCALL sass_context_get_error_status (struct Sass_Context* ctx);
+    # ADDAPI const char* ADDCALL sass_context_get_error_json (struct Sass_Context* ctx);
+    # ADDAPI const char* ADDCALL sass_context_get_error_message (struct Sass_Context* ctx);
+    # ADDAPI const char* ADDCALL sass_context_get_error_file (struct Sass_Context* ctx);
+    # ADDAPI size_t ADDCALL sass_context_get_error_line (struct Sass_Context* ctx);
+    # ADDAPI size_t ADDCALL sass_context_get_error_column (struct Sass_Context* ctx);
+    # ADDAPI const char* ADDCALL sass_context_get_source_map_string (struct Sass_Context* ctx);
+    # ADDAPI char** ADDCALL sass_context_get_included_files (struct Sass_Context* ctx);
+    attach_function :sass_context_get_output_string, [:sass_context_ptr], :string
+    attach_function :sass_context_get_error_status, [:sass_context_ptr], :int
+    attach_function :sass_context_get_error_json, [:sass_context_ptr], :string
+    attach_function :sass_context_get_error_message, [:sass_context_ptr], :string
+    attach_function :sass_context_get_error_file, [:sass_context_ptr], :string
+    attach_function :sass_context_get_error_line, [:sass_context_ptr], :size_t
+    attach_function :sass_context_get_error_column, [:sass_context_ptr], :size_t
+    attach_function :sass_context_get_source_map_string, [:sass_context_ptr], :string
+    attach_function :_context_get_included_files, :sass_context_get_included_files, [:sass_context_ptr], :pointer
+
+    def self.context_get_included_files(*args)
+      return_string_array _context_get_included_files(*args)
+    end
+
+    # ADDAPI Sass_Import_Entry ADDCALL sass_compiler_get_last_import(struct Sass_Compiler* compiler);
+    attach_function :sass_compiler_get_last_import, [:pointer], :pointer
+  end
+end

data/lib/sassc/native/native_functions_api.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    # Creators for sass function list and function descriptors
+    # ADDAPI Sass_C_Function_List ADDCALL sass_make_function_list (size_t length);
+    # ADDAPI Sass_C_Function_Callback ADDCALL sass_make_function (const char* signature, Sass_C_Function fn, void* cookie);
+    attach_function :sass_make_function_list, [:size_t], :sass_c_function_list_ptr
+    attach_function :sass_make_function, [:string, :sass_c_function, :pointer], :sass_c_function_callback_ptr
+
+    # Setters and getters for callbacks on function lists
+    # ADDAPI Sass_C_Function_Callback ADDCALL sass_function_get_list_entry(Sass_C_Function_List list, size_t pos);
+    # ADDAPI void ADDCALL sass_function_set_list_entry(Sass_C_Function_List list, size_t pos, Sass_C_Function_Callback cb);
+    attach_function :sass_function_get_list_entry, [:sass_c_function_list_ptr, :size_t], :sass_c_function_callback_ptr
+    attach_function :sass_function_set_list_entry, [:sass_c_function_list_ptr, :size_t, :sass_c_function_callback_ptr], :void
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_number  (double val, const char* unit);
+    attach_function :sass_make_number, [:double, :string], :sass_value_ptr
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_string  (const char* val);
+    attach_function :sass_make_string, [:string], :sass_value_ptr
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_qstring (const char* val);
+    attach_function :sass_make_qstring, [:string], :sass_value_ptr
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_color   (double r, double g, double b, double a);
+    attach_function :sass_make_color, [:double, :double, :double, :double], :sass_value_ptr
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_map     (size_t len);
+    attach_function :sass_make_map, [:size_t], :sass_value_ptr
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_list     (size_t len, enum Sass_Separator sep)
+    attach_function :sass_make_list, [:size_t, SassSeparator], :sass_value_ptr
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_boolean (boolean val);
+    attach_function :sass_make_boolean, [:bool], :sass_value_ptr
+
+    # ADDAPI void ADDCALL sass_map_set_key (union Sass_Value* v, size_t i, union Sass_Value*);
+    attach_function :sass_map_set_key, [:sass_value_ptr, :size_t, :sass_value_ptr], :void
+
+    # ADDAPI union Sass_Value* ADDCALL sass_map_get_key (const union Sass_Value* v, size_t i);
+    attach_function :sass_map_get_key, [:sass_value_ptr, :size_t], :sass_value_ptr
+
+    # ADDAPI void ADDCALL sass_map_set_value (union Sass_Value* v, size_t i, union Sass_Value*);
+    attach_function :sass_map_set_value, [:sass_value_ptr, :size_t, :sass_value_ptr], :void
+
+    # ADDAPI union Sass_Value* ADDCALL sass_map_get_value (const union Sass_Value* v, size_t i);
+    attach_function :sass_map_get_value, [:sass_value_ptr, :size_t], :sass_value_ptr
+
+    # ADDAPI size_t ADDCALL sass_map_get_length (const union Sass_Value* v);
+    attach_function :sass_map_get_length, [:sass_value_ptr], :size_t
+
+    # ADDAPI union Sass_Value* ADDCALL sass_list_get_value (const union Sass_Value* v, size_t i);
+    attach_function :sass_list_get_value, [:sass_value_ptr, :size_t], :sass_value_ptr
+
+    # ADDAPI void ADDCALL sass_list_set_value (union Sass_Value* v, size_t i, union Sass_Value* value);
+    attach_function :sass_list_set_value, [:sass_value_ptr, :size_t, :sass_value_ptr], :void
+
+    # ADDAPI size_t ADDCALL sass_list_get_length (const union Sass_Value* v);
+    attach_function :sass_list_get_length, [:sass_value_ptr], :size_t
+
+    # ADDAPI union Sass_Value* ADDCALL sass_make_error   (const char* msg);
+    attach_function :sass_make_error, [:string], :sass_value_ptr
+
+    # ADDAPI enum Sass_Tag ADDCALL sass_value_get_tag (const union Sass_Value* v);
+    attach_function :sass_value_get_tag, [:sass_value_ptr], SassTag
+    attach_function :sass_value_is_null, [:sass_value_ptr], :bool
+
+    # ADDAPI const char* ADDCALL sass_string_get_value (const union Sass_Value* v);
+    attach_function :sass_string_get_value, [:sass_value_ptr], :string
+
+    # ADDAPI bool ADDCALL sass_string_is_quoted(const union Sass_Value* v);
+    attach_function :sass_string_is_quoted, [:sass_value_ptr], :bool
+
+    # ADDAPI const char* ADDCALL sass_number_get_value (const union Sass_Value* v);
+    attach_function :sass_number_get_value, [:sass_value_ptr], :double
+
+    # ADDAPI const char* ADDCALL sass_number_get_unit (const union Sass_Value* v);
+    attach_function :sass_number_get_unit, [:sass_value_ptr], :string
+    
+    # ADDAPI const char* ADDCALL sass_boolean_get_value (const union Sass_Value* v);
+    attach_function :sass_boolean_get_value, [:sass_value_ptr], :bool
+
+    def self.string_get_type(native_value)
+      string_is_quoted(native_value) ? :string : :identifier
+    end
+
+    # ADDAPI double ADDCALL sass_color_get_r (const union Sass_Value* v);
+    # ADDAPI void ADDCALL sass_color_set_r (union Sass_Value* v, double r);
+    # ADDAPI double ADDCALL sass_color_get_g (const union Sass_Value* v);
+    # ADDAPI void ADDCALL sass_color_set_g (union Sass_Value* v, double g);
+    # ADDAPI double ADDCALL sass_color_get_b (const union Sass_Value* v);
+    # ADDAPI void ADDCALL sass_color_set_b (union Sass_Value* v, double b);
+    # ADDAPI double ADDCALL sass_color_get_a (const union Sass_Value* v);
+    # ADDAPI void ADDCALL sass_color_set_a (union Sass_Value* v, double a);
+    ['r', 'g', 'b', 'a'].each do |color_channel|
+      attach_function "sass_color_get_#{color_channel}".to_sym, [:sass_value_ptr], :double
+      attach_function "sass_color_set_#{color_channel}".to_sym, [:sass_value_ptr, :double], :void
+    end
+
+    # ADDAPI char* ADDCALL sass_error_get_message (const union Sass_Value* v);
+    # ADDAPI void ADDCALL sass_error_set_message (union Sass_Value* v, char* msg);
+    attach_function :sass_error_get_message, [:sass_value_ptr], :string
+    attach_function :sass_error_set_message, [:sass_value_ptr, :pointer], :void
+
+    # Getters for custom function descriptors
+    # ADDAPI const char* ADDCALL sass_function_get_signature (Sass_C_Function_Callback fn);
+    # ADDAPI Sass_C_Function ADDCALL sass_function_get_function (Sass_C_Function_Callback fn);
+    # ADDAPI void* ADDCALL sass_function_get_cookie (Sass_C_Function_Callback fn);
+    attach_function :sass_function_get_signature, [:sass_c_function_callback_ptr], :string
+    attach_function :sass_function_get_function, [:sass_c_function_callback_ptr], :sass_c_function
+    attach_function :sass_function_get_cookie, [:sass_c_function_callback_ptr], :pointer
+
+    # Creators for custom importer callback (with some additional pointer)
+    # The pointer is mostly used to store the callback into the actual binding
+    # ADDAPI Sass_C_Import_Callback ADDCALL sass_make_importer (Sass_C_Import_Fn, void* cookie);
+    attach_function :sass_make_importer, [:sass_c_import_function, :pointer], :sass_importer
+
+    # Getters for import function descriptors
+    # ADDAPI Sass_C_Import_Fn ADDCALL sass_import_get_function (Sass_C_Import_Callback fn);
+    # ADDAPI void* ADDCALL sass_import_get_cookie (Sass_C_Import_Callback fn);
+
+    # Deallocator for associated memory
+    # ADDAPI void ADDCALL sass_delete_importer (Sass_C_Import_Callback fn);
+
+    # Creator for sass custom importer return argument list
+    # ADDAPI struct Sass_Import** ADDCALL sass_make_import_list (size_t length);
+    attach_function :sass_make_import_list, [:size_t], :sass_import_list_ptr
+
+    # Creator for a single import entry returned by the custom importer inside the list
+    # ADDAPI struct Sass_Import* ADDCALL sass_make_import_entry (const char* path, char* source, char* srcmap);
+    # ADDAPI struct Sass_Import* ADDCALL sass_make_import (const char* path, const char* base, char* source, char* srcmap);
+    attach_function :sass_make_import_entry, [:string, :pointer, :pointer], :sass_import_ptr
+
+    # Setters to insert an entry into the import list (you may also use [] access directly)
+    # Since we are dealing with pointers they should have a guaranteed and fixed size
+    # ADDAPI void ADDCALL sass_import_set_list_entry (struct Sass_Import** list, size_t idx, struct Sass_Import* entry);
+    attach_function :sass_import_set_list_entry, [:sass_import_list_ptr, :size_t, :sass_import_ptr], :void
+    # ADDAPI struct Sass_Import* ADDCALL sass_import_get_list_entry (struct Sass_Import** list, size_t idx);
+
+    # Getters for import entry
+    # ADDAPI const char* ADDCALL sass_import_get_imp_path (struct Sass_Import*);
+    attach_function :sass_import_get_imp_path, [:sass_import_ptr], :string
+    # ADDAPI const char* ADDCALL sass_import_get_abs_path (struct Sass_Import*);
+    attach_function :sass_import_get_abs_path, [:sass_import_ptr], :string
+    # ADDAPI const char* ADDCALL sass_import_get_source (struct Sass_Import*);
+    attach_function :sass_import_get_source, [:sass_import_ptr], :string
+    # ADDAPI const char* ADDCALL sass_import_get_srcmap (struct Sass_Import*);
+    # Explicit functions to take ownership of these items
+    # The property on our struct will be reset to NULL
+    # ADDAPI char* ADDCALL sass_import_take_source (struct Sass_Import*);
+    # ADDAPI char* ADDCALL sass_import_take_srcmap (struct Sass_Import*);
+
+    # Deallocator for associated memory (incl. entries)
+    # ADDAPI void ADDCALL sass_delete_import_list (struct Sass_Import**);
+    # Just in case we have some stray import structs
+    # ADDAPI void ADDCALL sass_delete_import (struct Sass_Import*);
+  end
+end

data/lib/sassc/native/sass2scss_api.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    # ADDAPI char* ADDCALL sass2scss (const char* sass, const int options);
+    attach_function :sass2scss, [:string, :int], :string
+
+    # ADDAPI const char* ADDCALL sass2scss_version(void);
+  end
+end

data/lib/sassc/native/sass_input_style.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    SassInputStyle = enum(
+      :sass_context_null,
+      :sass_context_file,
+      :sass_context_data,
+      :sass_context_folder
+    )
+  end
+end
+

data/lib/sassc/native/sass_output_style.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    SassOutputStyle = enum(
+      :sass_style_nested,
+      :sass_style_expanded,
+      :sass_style_compact,
+      :sass_style_compressed
+    )
+  end
+end

data/lib/sassc/native/sass_value.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    class SassValue < FFI::Union; end
+
+    SassTag = enum(
+      :sass_boolean,
+      :sass_number,
+      :sass_color,
+      :sass_string,
+      :sass_list,
+      :sass_map,
+      :sass_null,
+      :sass_error,
+      :sass_warning
+    )
+
+    SassSeparator = enum(
+      :sass_comma,
+      :sass_space
+    )
+
+    class SassUnknown < FFI::Struct
+      layout :tag, SassTag
+    end
+
+    class SassBoolean < FFI::Struct
+      layout :tag, SassTag,
+             :value, :bool
+    end
+
+    class SassNumber < FFI::Struct
+      layout :tag, SassTag,
+             :value, :double,
+             :unit, :string
+    end
+
+    class SassColor < FFI::Struct
+      layout :tag, SassTag,
+             :r, :double,
+             :g, :double,
+             :b, :double,
+             :a, :double
+    end
+
+    class SassString < FFI::Struct
+      layout :tag, SassTag,
+             :value, :string
+    end
+
+    class SassList < FFI::Struct
+      layout :tag, SassTag,
+             :separator, SassSeparator,
+             :length, :size_t,
+             :values, :pointer
+    end
+
+    class SassMapPair < FFI::Struct
+      layout :key, SassValue.ptr,
+             :value, SassValue.ptr
+    end
+
+    class SassMap < FFI::Struct
+      layout :tag, SassTag,
+             :length, :size_t,
+             :pairs, SassMapPair.ptr
+    end
+
+    class SassNull < FFI::Struct
+      layout :tag, SassTag
+    end
+
+    class SassError < FFI::Struct
+      layout :tag, SassTag,
+             :message, :string
+    end
+
+    class SassWarning < FFI::Struct
+      layout :tag, SassTag,
+             :message, :string
+    end
+
+    class SassValue # < FFI::Union
+      layout :unknown, SassUnknown,
+             :boolean, SassBoolean,
+             :number, SassNumber,
+             :color, SassColor,
+             :string, SassString,
+             :list, SassList,
+             :map, SassMap,
+             :null, SassNull,
+             :error, SassError,
+             :warning, SassWarning
+    end
+  end
+end

data/lib/sassc/native/string_list.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module SassC
+  module Native
+    class StringList < FFI::Struct
+      layout :string_list, StringList.ptr,
+             :string, :string
+    end
+  end
+end

data/lib/sassc/native.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "ffi"
+
+module SassC
+  module Native
+    extend FFI::Library
+
+    dl_ext = RbConfig::MAKEFILE_CONFIG['DLEXT']
+    begin
+      ffi_lib File.expand_path("libsass.#{dl_ext}", __dir__)
+    rescue LoadError # Some non-rvm environments don't copy a shared object over to lib/sassc
+      ffi_lib File.expand_path("libsass.#{dl_ext}", "#{__dir__}/../../ext")
+    end
+
+    require_relative "native/sass_value"
+
+    typedef :pointer, :sass_options_ptr
+    typedef :pointer, :sass_context_ptr
+    typedef :pointer, :sass_file_context_ptr
+    typedef :pointer, :sass_data_context_ptr
+
+    typedef :pointer, :sass_c_function_list_ptr
+    typedef :pointer, :sass_c_function_callback_ptr
+    typedef :pointer, :sass_value_ptr
+
+    typedef :pointer, :sass_import_list_ptr
+    typedef :pointer, :sass_importer
+    typedef :pointer, :sass_import_ptr
+
+    callback :sass_c_function, [:pointer, :pointer], :pointer
+    callback :sass_c_import_function, [:pointer, :pointer, :pointer], :pointer
+
+    require_relative "native/sass_input_style"
+    require_relative "native/sass_output_style"
+    require_relative "native/string_list"
+
+    # Remove the redundant "sass_" from the beginning of every method name
+    def self.attach_function(*args)
+      return super if args.size != 3
+
+      if args[0] =~ /^sass_/
+        args.unshift args[0].to_s.sub(/^sass_/, "")
+      end
+
+      super(*args)
+    end
+
+    # https://github.com/ffi/ffi/wiki/Examples#array-of-strings
+    def self.return_string_array(ptr)
+      ptr.null? ? [] : ptr.get_array_of_string(0).compact
+    end
+
+    def self.native_string(string)
+      m = FFI::MemoryPointer.from_string(string)
+      m.autorelease = false
+      m
+    end
+
+    require_relative "native/native_context_api"
+    require_relative "native/native_functions_api"
+    require_relative "native/sass2scss_api"
+  end
+end