Using any `autofill` options in `.sassdocrc` won't document items

Using

autofill: []

or any combination of

autofill:
  - throw
  - content
  - require

will produce an "empty" output file, as if there was no items to document, and fails silently.

[valeriangalliat]

Hey! Sorry for the late reply. You need to autofill access, otherwise all items are marked @access auto, and the theme don't know how to display this.

[pascalduez]

You need to autofill access, otherwise all items are marked @access auto, and the theme don't know how to display this.

Really ? Is that the intended behavior ? ¯\_(ツ)_/¯

[valeriangalliat]

Well, @access was never thought to not be autofilled I guess. This is why I didn't close the issue, there's maybe stuff to change at this level.

[KittyGiraudel]

Ran through this issue today. We need to fix it, it's definitely correct. :x

[valeriangalliat]

@access could be public by default so it still works when not autofilled, but if we do this we won't be able to distinguish between an explicitely public item and an item with the default value.

So when autofilled, the following code:

/// @access public
@function _test() {}

would and end up to be private.

Or the theme should handle auto access value, but I don't like this.

Or we can return something like Object.assign('public', { auto: true }) from the default function, and this way we'll be able to test from the autofill function if it's the default value or an explicit public annotation, but it's a hack.

[pascalduez]

What a clusterfuck.

How about to force autofill to contains access ?
Not particularly nice but at least there shouldn't be side effects, nor breakages ?

[valeriangalliat]

Well for sure that's better than what I was proposing!

We could hook something like this in ensureEnvironment:

if (env.autofill && env.autofill.indexOf('access') === -1) {
  env.autofill.push('access');
}

[FWeinb]

I like this 👍

[valeriangalliat]

In fact it should more be in Environment.postProcess. Anyway, I'm not sure about this. I recall that we have a resolve function at annotation level, that could convert any auto to public when not autofilled. It's the cleanest solution I have in mind. I'm implementing this.

[valeriangalliat]

Fixed in 2.1.14.