feat: add support for import tags

[Didericis]

Implemented the feature requested here

Features

• Merges all import tags which share the same source (within the same comment block)
• Normalizes quotes and whitespace for sources and type aliases
• Splits any imports for more than one type so each type is its own line
• Orders imports alphabetically (with respect to aliases if given, or type if not)
• Sorts imports before all other tags by default
• Handles default imports (uses default name in last encountered import tag)

Example

Before

/**
 * @typedef {Object} Foo
 * @import {A} from 'a'
 * @import BM, { B as B1,
 * B2   , B4 } from 'b'
 * @import BMain, {B3  } from 'b'
 */
/**
 * @import BDefault, {       B5 } from   'b'
 * @import C    from    'c'
 */

After

/**
 * @import {A} from "a"
 * @import BMain, {
 *   B as B1,
 *   B2,
 *   B3,
 *   B4
 * } from "b"
 * @typedef {Object} Foo
 */
/**
 * @import BDefault, {B5} from "b"
 * @import C from "c"
 */

Limitations

• Does not consolidate imports across comment blocks

[Didericis]

Realized I should also add the following:

1. Ability to sort import tags by source
2. Option to toggle this feature on/off
3. Option for line splitting
4. Option for whitespace settings

[fardad-dev]

is this spaces need to be changed?

[Didericis]

No, just an auto formatting thing from my editor. Tests are passing with the change, so figured it was ok to keep

[Didericis]

Added them back just in case there was any deliberate whitespace cleaning being tested 👍

[fardad-dev]

LGTM

[fardad-dev]

Release v1.5.0

Thank you

[caseywebdev]

I noticed with this release I’ve lost my single quoted import paths and I think this could be the source. Does the prettier singleQuote option need to be checked here and the quotes modified accordingly?

[fardad-dev]

Thank you for reporting this.
Yes it is related to this pr
I think we should use prettier to format import, it can handle all other configs like space, import sort and others.

[Didericis]

@hosseinmd If you want to fix lmk, otherwise I'll plan to refactor to use prettier some time tonight when I'm free