docs(public-api/lite): minor refinements

Author: azinit

README.md

@@ -63,48 +63,56 @@ Uncomment if will be needed
 
 ## Customization
 
-1. You can partially use the rules
+1. You can *partially use* the rules
 
    > **WARN:** Don't use main config (`"@feature-sliced"`) in customization to avoid rules conflicts.
 
-   ```json
-   {
-     "extends": [
-       "@feature-sliced/eslint-config/rules/import-order",
-       "@feature-sliced/eslint-config/rules/public-api",
-       "@feature-sliced/eslint-config/rules/layers-slices"
-     ]
-   }
-   ```
-
-2. You can use [advanced FeatureSliced-specific messages processing](https://www.npmjs.com/package/@feature-sliced/eslint-plugin-messages)
-
-   ```diff
-   # (feature-sliced/public-api)
-   - 'Reaching to "features/search/ui" is not allowed.'
-   + 'Violated usage of modules Public API | https://git.io/Jymjf'
-    ```
-
-3. You can use *warnings* instead of *errors* for specific rules
-
    ```js
-   // feature-sliced/import-order
-   "import/order": "warn" // ~ 1,
-   // feature-sliced/public-api
-   "import/no-internal-modules": "warn" // ~ 1,
-   // feature-sliced/layers-slices
-   "boundaries/element-types": "warn" // ~ 1,
+   "extends": [
+     "@feature-sliced/eslint-config/rules/import-order",
+     "@feature-sliced/eslint-config/rules/public-api",
+     "@feature-sliced/eslint-config/rules/layers-slices"
+   ]
    ```
 
-4. [`EXPERIMENTAL:`](https://github.com/feature-sliced/eslint-config/issues/85) You can use [`import-order/experimental`](./rules/import-order#Experimental) for formatting with spaces between groups and reversed order of layers
+1. You can use *alternative experimental rules*
+    - Use [`import-order/experimental`](./rules/import-order#Experimental) for formatting with spaces between groups and reversed order of layers [(why?)](https://github.com/feature-sliced/eslint-config/issues/85)
 
-    ```js
-    {
+      ```js
       "extends": [
         // ... Other rules or config
         "@feature-sliced/eslint-config/rules/import-order/experimental",
       ]
-    }
+      ```
+
+    - Use [`public-api/lite`](./rules/public-api#Lite) for less strict PublicAPI boundaries [(why?)](https://github.com/feature-sliced/eslint-config/issues/90)
+
+        ```js
+        "extends": [
+          // ... Other rules or config
+          "@feature-sliced/eslint-config/rules/public-api/lite",
+        ]
+        ```
+
+1. You can use *warnings* instead of *errors* for specific rules
+
+   ```js
+   "rules": {
+      // feature-sliced/import-order
+      "import/order": "warn" // ~ 1,
+      // feature-sliced/public-api
+      "import/no-internal-modules": "warn" // ~ 1,
+      // feature-sliced/layers-slices
+      "boundaries/element-types": "warn" // ~ 1,
+   }
+   ```
+  
+1. You can use *[advanced FSD-specific messages processing](https://www.npmjs.com/package/@feature-sliced/eslint-plugin-messages)*
+
+   ```diff
+   # (feature-sliced/public-api)
+   - 'Reaching to "features/search/ui" is not allowed.'
+   + 'Violated usage of modules Public API | https://git.io/Jymjf'
     ```
 
 ## TypeScript
@@ -140,4 +148,4 @@ This plugin can be used also in TypeScript projects using `@typescript-eslint/es
 - [Releases & Changelog](https://github.com/feature-sliced/eslint-config/releases)
 - [**How can I help?**](./CONTRIBUTING.md)
   - ⭐ Rate us on GitHub
-  - 💫 Any assistance is important - from feedback to participation in the development of the methodology!
+  - 💫 **Any assistance is important** - from *feedback to participation in the development of the methodology*!

rules/public-api/README.md

@@ -6,6 +6,8 @@
 
 Add `"@feature-sliced/eslint-config/rules/public-api"` to your `extends` section in ESLint config.
 
+#### Slices PublicAPI
+
 ```js
 // 👎 Fail
 import { Issues } from "pages/issues/ui";
@@ -27,20 +29,57 @@ import { AuthForm } from "features/auth/form"
 import { Button } from "shared/ui";
 ```
 
-## Segments PublicAPI
+#### Segments PublicAPI
 
 ```js
+// 👍 Pass
+/** @path features/smth/index.ts */
+export { SubmitButton, SmthForm } from "./ui";
+export * from "./model";
+export * as smthModel from "./model";
+export { selectSmthById, ... } from "./model";
+
 // 👎 Fail
 /** @path features/smth/index.ts */
 export { SubmitButton } from "./ui/button";
 export { SmthForm } from "./ui/form";
 export * from "./model/actions";
 export { selectSmthById } from "./model/selectors";
+```
+
+## Lite
+
+**Without SegmentsAPI / InnerAPI restrictions** [(why experimental?)](https://github.com/feature-sliced/eslint-config/issues/90)
+
+Add `"@feature-sliced/eslint-config/rules/public-api/lite"` to your `extends` section in ESLint config. (for `^0.1.0-beta.5` versions)
+
+#### Slices PublicAPI
+
+Without changes
+
+```js
+// 👍 Pass
+import { orderModel } from "entities/order";
+// 👎 Fail
+import { orderModel } from "entities/order/model";
+```
+
+#### Segments PublicAPI
+
+Less restricted with segments
 
+```js
 // 👍 Pass
 /** @path features/smth/index.ts */
 export { SubmitButton, SmthForm } from "./ui";
 export * from "./model";
 export * as smthModel from "./model";
 export { selectSmthById, ... } from "./model";
+
+// 👍 Also Pass
+/** @path features/smth/index.ts */
+export { SubmitButton } from "./ui/button";
+export { SmthForm } from "./ui/form";
+export * from "./model/actions";
+export { selectSmthById } from "./model/selectors";
 ```