Merge pull request #1 from surmon-china/master

Init project

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,37 @@
+Your issue may already be reported!
+Please search on the [issue tracker](../) before creating one.
+
+## Expected Behavior
+
+<!--- If you're describing a bug, tell us what should happen -->
+<!--- If you're suggesting a change/improvement, tell us how it should work -->
+
+## Current Behavior
+
+<!--- If describing a bug, tell us what happens instead of the expected behavior -->
+<!--- If suggesting a change/improvement, explain the difference from current behavior -->
+
+## Possible Solution
+
+<!--- Not obligatory, but suggest a fix/reason for the bug, -->
+<!--- or ideas how to implement the addition or change -->
+
+## Steps to Reproduce (for bugs)
+
+<!--- Provide a link to a live example, or an unambiguous set of steps to -->
+<!--- reproduce this bug. Include code to reproduce, if relevant -->
+
+1. 2. 3. 4.
+
+## Context
+
+<!--- How has this issue affected you? What are you trying to accomplish? -->
+<!--- Providing context helps us come up with a solution that is most useful in the real world -->
+
+## Your Environment
+
+<!--- Include as many relevant details about the environment you experienced the bug in -->
+
+- Version used:
+- Operating System and versions:
+- Link to your project:

.gitignore

@@ -0,0 +1,8 @@
+node_modules
+*.log
+*.rej
+dist
+
+# Test Relative Folders
+__mocks__
+__coverage__

.prettierignore

@@ -0,0 +1,2 @@
+dist
+__coverage__

.travis.yml

@@ -0,0 +1,26 @@
+if: tag IS blank
+
+language: node_js
+node_js:
+  - "10"
+
+jobs:
+  include:
+    - stage: test
+      name: "Unit tests, type checking, linting, etc."
+      script:
+        - yarn check-types
+        - yarn test
+        - yarn codecov
+        - git reset --hard HEAD
+        - yarn check-formatting
+        - yarn build
+        - yarn commitlint-travis
+    - stage: release
+      name: "Release on npm"
+      deploy:
+        provider: script
+        skip_cleanup: true
+        script:
+          # TODO: !!! @nighca
+          # - yarn semantic-release

README.md

@@ -1 +1,294 @@
-# typed-less-modules
+# 🎁 typed-less-modules
+
+[![Travis Build Status](https://img.shields.io/travis/qiniu/typed-less-modules/master?style=for-the-badge)](https://travis-ci.com/qiniu/typed-less-modules)
+[![Codecov](https://img.shields.io/codecov/c/github/qiniu/typed-less-modules?style=for-the-badge)](https://codecov.io/gh/qiniu/typed-less-modules)
+[![npm](https://img.shields.io/npm/v/@qiniu/typed-less-modules?color=%23c7343a&label=npm&style=for-the-badge)](https://www.npmjs.com/package/@qiniu/typed-less-modules)
+[![GitHub stars](https://img.shields.io/github/stars/qiniu/typed-less-modules.svg?style=for-the-badge)](https://github.com/qiniu/typed-less-modules/stargazers)
+[![license](https://img.shields.io/github/license/qiniu/typed-less-modules?style=for-the-badge)](https://github.com/qiniu/typed-less-modules/blob/master/LICENSE)
+
+Generate TypeScript definitions (`.d.ts`) files for CSS Modules that are written in LESS (`.less`).
+
+**typed-less-modules** 用于将 `.less` 转换为对应的 `.d.ts` TypeScript 类型声明文件。
+
+![Example](/docs/typed-less-modules-example.gif)
+
+For example, given the following LESS:
+
+```less
+@import "variables";
+
+.text {
+  color: @blue;
+
+  &-highlighted {
+    color: @yellow;
+  }
+}
+```
+
+The following type definitions will be generated:
+
+```typescript
+export const text: string;
+export const textHighlighted: string;
+```
+
+## Basic Usage
+
+Run with npm package runner:
+
+```bash
+npx tlm src
+```
+
+Or, install globally:
+
+```bash
+yarn global add typed-less-modules
+tlm src
+```
+
+Or, install and run as a `devDependency`:
+
+```bash
+yarn add -D typed-less-modules
+yarn tlm src
+```
+
+## Advanced Usage
+
+For all possible commands, run `tlm --help`.
+
+The only required argument is the directory where all LESS files are located (`config.pattern`). Running `tlm src` will search for all files matching `src/**/*.less`. This can be overridden by providing a [glob](https://github.com/isaacs/node-glob#glob-primer) pattern instead of a directory. For example, `tlm src/*.less`
+
+### `--watch` (`-w`)
+
+- **Type**: `boolean`
+- **Default**: `false`
+- **Example**: `tlm src --watch`
+
+Watch for files that get added or are changed and generate the corresponding type definitions.
+
+### `--ignoreInitial`
+
+- **Type**: `boolean`
+- **Default**: `false`
+- **Example**: `tlm src --watch --ignoreInitial`
+
+Skips the initial build when passing the watch flag. Use this when running concurrently with another watch, but the initial build should happen first. You would run without watch first, then start off the concurrent runs after.
+
+### `--ignore`
+
+- **Type**: `string[]`
+- **Default**: `[]`
+- **Example**: `tlm src --watch --ignore "**/secret.less"`
+
+A pattern or an array of glob patterns to exclude files that match and avoid generating type definitions.
+
+### `--includePaths` (`-i`)
+
+- **Type**: `string[]`
+- **Default**: `[]`
+- **Example**: `tlm src --includePaths src/core`
+
+An array of paths to look in to attempt to resolve your `@import` declarations. This example will search the `src/core` directory when resolving imports.
+
+### `--aliases` (`-a`)
+
+- **Type**: `object`
+- **Default**: `{}`
+- **Example**: `tlm src --aliases.~some-alias src/core/variables`
+
+An object of aliases to map to their corresponding paths. This example will replace any `@import '~alias'` with `@import 'src/core/variables'`.
+
+### `--nameFormat` (`-n`)
+
+- **Type**: `"camel" | "kebab" | "param" | "dashes" | "none"`
+- **Default**: `"camel"`
+- **Example**: `tlm src --nameFormat camel`
+
+The class naming format to use when converting the classes to type definitions.
+
+- **camel**: convert all class names to camel-case, e.g. `App-Logo` => `appLogo`.
+- **kebab**/**param**: convert all class names to kebab/param case, e.g. `App-Logo` => `app-logo` (all lower case with '-' separators).
+- **dashes**: only convert class names containing dashes to camel-case, leave others alone, e.g. `App` => `App`, `App-Logo` => `appLogo`. Matches the webpack [css-loader camelCase 'dashesOnly'](https://github.com/webpack-contrib/css-loader#camelcase) option.
+- **none**: do not modify the given class names (you should use `--exportType default` when using `--nameFormat none` as any classes with a `-` in them are invalid as normal variable names).
+  Note: If you are using create-react-app v2.x and have NOT ejected, `--nameFormat none --exportType default` matches the class names that are generated in CRA's webpack's config.
+
+### `--listDifferent` (`-l`)
+
+- **Type**: `boolean`
+- **Default**: `false`
+- **Example**: `tlm src --listDifferent`
+
+List any type definition files that are different than those that would be generated. If any are different, exit with a status code `1`.
+
+### `--exportType` (`-e`)
+
+- **Type**: `"named" | "default"`
+- **Default**: `"named"`
+- **Example**: `tlm src --exportType default`
+
+The export type to use when generating type definitions.
+
+#### `named`
+
+Given the following LESS:
+
+```less
+.text {
+  color: blue;
+
+  &-highlighted {
+    color: yellow;
+  }
+}
+```
+
+The following type definitions will be generated:
+
+```typescript
+export const text: string;
+export const textHighlighted: string;
+```
+
+#### `default`
+
+Given the following LESS:
+
+```less
+.text {
+  color: blue;
+
+  &-highlighted {
+    color: yellow;
+  }
+}
+```
+
+The following type definitions will be generated:
+
+```typescript
+export type Styles = {
+  text: string;
+  textHighlighted: string;
+};
+
+export type ClassNames = keyof Styles;
+
+declare const styles: Styles;
+
+export default styles;
+```
+
+This export type is useful when using kebab (param) cased class names since variables with a `-` are not valid variables and will produce invalid types or when a class name is a TypeScript keyword (eg: `while` or `delete`). Additionally, the `Styles` and `ClassNames` types are exported which can be useful for properly typing variables, functions, etc. when working with dynamic class names.
+
+### `--exportTypeName`
+
+- **Type**: `string`
+- **Default**: `"ClassNames"`
+- **Example**: `tlm src --exportType default --exportTypeName ClassesType`
+
+Customize the type name exported in the generated file when `--exportType` is set to `"default"`.
+Only default exports are affected by this command. This example will change the export type line to:
+
+```typescript
+export type ClassesType = keyof Styles;
+```
+
+### `--exportTypeInterface`
+
+- **Type**: `string`
+- **Default**: `"Styles"`
+- **Example**: `tlm src --exportType default --exportTypeInterface IStyles`
+
+Customize the interface name exported in the generated file when `--exportType` is set to `"default"`.
+Only default exports are affected by this command. This example will change the export interface line to:
+
+```typescript
+export type IStyles = {
+  // ...
+};
+```
+
+### `--quoteType` (`-q`)
+
+- **Type**: `"single" | "double"`
+- **Default**: `"single"`
+- **Example**: `tlm src --exportType default --quoteType double`
+
+Specify a quote type to match your TypeScript configuration. Only default exports are affected by this command. This example will wrap class names with double quotes (").
+
+### `--logLevel` (`-l`)
+
+- **Type**: `"verbose" | "error" | "info" | "silent"`
+- **Default**: `"verbose"`
+- **Example**: `tlm src --logLevel error`
+
+Sets verbosity level of console output.
+
+### `--config` (`-c`)
+
+- **Type**: `string`
+- **Default**: `tlm.config.js`
+- **Example**: `tlm --config ./path/to/tlm.config.js`
+
+指定配置文件的路径，配置文件可代替所有的命令行参数，默认读取 `process.cwd() + tlm.config.js` 文件。
+
+```js
+// tlm.config.js
+const path = require("path");
+
+module.exports = {
+  pattern: "./src/**/*.m.less",
+  watch: true,
+  // ...
+  // 上述所有配置均可用
+  aliases: {
+    // 映射至多路径
+    "~": [
+      path.resolve(__dirname, "node_modules"),
+      path.resolve(__dirname, "src")
+    ],
+    // 映射至单路径
+    "@": path.resolve(__dirname, "some-dir"),
+    // 自定义映射规则
+    "abc-module"(filePath) {
+      return filePath.replace("abc-module", "xxx-path");
+    }
+  },
+  // less.render options 参数
+  lessRenderOptions: {
+    javascriptEnabled: true
+  }
+};
+```
+
+#### `verbose`
+
+Print all messages
+
+#### `error`
+
+Print only errors
+
+#### `info`
+
+Print only some messages
+
+#### `silent`
+
+Print nothing
+
+## Examples
+
+For examples, see the `examples` directory:
+
+- [Basic Example](/examples/basic)
+- [Default Export Example](/examples/default-export)
+
+## Alternatives
+
+This package was forked from [typed-scss-modules](https://github.com/skovy/typed-scss-modules).
+
+This package is currently used as a CLI. There are also [packages that generate types as a webpack loader](https://github.com/Jimdo/typings-for-css-modules-loader).

__tests__/aliases.less

@@ -0,0 +1,6 @@
+@import "~fancy-import";
+@import "~another";
+
+.my-custom-class {
+  color: green;
+}

__tests__/aliases.less.d.ts

@@ -0,0 +1,5 @@
+export const someStyles: string;
+export const nestedClass: string;
+export const nestedAnother: string;
+export const someClass: string;
+export const myCustomClass: string;