refactor: Integrate @ui5/fs into the monorepo

packages/fs/.chglog/CHANGELOG.tpl.md

@@ -0,0 +1,239 @@
+# Changelog
+All notable changes to this project will be documented in this file.  
+This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+{{ if .Versions -}}
+A list of unreleased changes can be found [here]({{ .Info.RepositoryURL }}/compare/{{ $latest := index .Versions 0 }}{{ $latest.Tag.Name }}...HEAD).
+{{ end -}}
+
+{{ range .Versions }}
+<a name="{{ .Tag.Name }}"></a>
+## {{ if .Tag.Previous }}[{{ .Tag.Name }}]{{ else }}{{ .Tag.Name }}{{ end }} - {{ datetime "2006-01-02" .Tag.Date }}
+{{ range .CommitGroups -}}
+### {{ .Title }}
+{{ range .Commits -}}
+- {{ if .Scope }}**{{ .Scope }}:** {{ end }}{{ .Subject }} [`{{ .Hash.Short }}`]({{ $.Info.RepositoryURL }}/commit/{{ .Hash.Long }})
+{{ end }}
+{{ end -}}
+
+{{- if .RevertCommits -}}
+### Reverts
+{{ range .RevertCommits -}}
+- {{ .Revert.Header }}
+{{ end }}
+{{ end -}}
+
+{{- if .NoteGroups -}}
+{{ range .NoteGroups -}}
+### {{ .Title }}
+{{ range .Notes }}
+{{ .Body }}
+{{ end }}
+{{ end -}}
+{{ end -}}
+{{ end -}}
+
+<a name="v3.0.5"></a>
+## [v3.0.5] - 2023-10-09
+
+<a name="v3.0.4"></a>
+## [v3.0.4] - 2023-05-23
+### Bug Fixes
+- Do not prefix excludes when creating a reader ([#504](https://github.com/SAP/ui5-fs/issues/504)) [`f765894`](https://github.com/SAP/ui5-fs/commit/f765894df3854242dc308b32581e3d234bbcf27e)
+
+
+<a name="v3.0.3"></a>
+## [v3.0.3] - 2023-04-21
+### Dependency Updates
+- Bump minimatch from 8.0.4 to 9.0.0 ([#497](https://github.com/SAP/ui5-fs/issues/497)) [`56d4542`](https://github.com/SAP/ui5-fs/commit/56d45423458564db7c2bdf7d1cdbd174c2057232)
+- Bump minimatch from 7.4.4 to 8.0.2 [`a53a4e3`](https://github.com/SAP/ui5-fs/commit/a53a4e3e531cc880de29a4e8176844dd2c743196)
+
+
+<a name="v3.0.2"></a>
+## [v3.0.2] - 2023-03-01
+### Dependency Updates
+- Bump minimatch from 6.2.0 to 7.2.0 [`d2c37d4`](https://github.com/SAP/ui5-fs/commit/d2c37d4be518b4cc812cb55b9a431796010725dc)
+
+
+<a name="v3.0.1"></a>
+## [v3.0.1] - 2023-02-16
+### Dependency Updates
+- Bump minimatch from 6.1.8 to 6.2.0 [`20e9311`](https://github.com/SAP/ui5-fs/commit/20e931149ce87d374e607f0f4e4357ae0abe3f97)
+
+
+<a name="v3.0.0"></a>
+## [v3.0.0] - 2023-02-09
+### Breaking Changes
+- Transform to ES Modules ([#398](https://github.com/SAP/ui5-fs/issues/398)) [`2b61580`](https://github.com/SAP/ui5-fs/commit/2b615807a610dd7dfeb5423496ec7aebc9169011)
+- Throw an error on write of a resource when path does not starts with virBasePath of the respective adapter ([#453](https://github.com/SAP/ui5-fs/issues/453)) [`d76575f`](https://github.com/SAP/ui5-fs/commit/d76575f8f05a0b6695285200ba595e532620daed)
+- Clone resources when writing in and reading from the Memory ([#448](https://github.com/SAP/ui5-fs/issues/448)) [`3454bc1`](https://github.com/SAP/ui5-fs/commit/3454bc15be8a6ecd455b49607cb289e69b41d0f0)
+- **AbstractAdapter:** Virtual base path must end with slash [`6d1f411`](https://github.com/SAP/ui5-fs/commit/6d1f4117a2b8bb1226540fafeec8341e4966177d)
+- **resourceFactory:** Remove #createCollectionsForTree [`a4d15f6`](https://github.com/SAP/ui5-fs/commit/a4d15f61ae0416051658280bfd2f8635c7ddf44e)
+- Require Node.js >= 16.18.0 / npm >= 8 [`94029de`](https://github.com/SAP/ui5-fs/commit/94029deea4e85211fb8d84f7b213f1fd0c418240)
+
+### BREAKING CHANGE
+An error is thrown when a resource shall be written to an adapter where the path of the resource does not starts with the virtual base path defined in the adapter.
+
+Resources stored in the adapters can not be modified by reference anymore. All modifications need to be persisted by using the #write method in order to be reflected in the adapter.
+
+This package has been transformed to ES Modules. Therefore it no longer provides a CommonJS export.
+If your project uses CommonJS, it needs to be converted to ES Modules or use a dynamic import.
+
+For more information see also:
+
+- https://sap.github.io/ui5-tooling/updates/migrate-v3/
+- https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+Support for older Node.js and npm releases has been dropped.
+Only Node.js v16.18.0 and npm v8 or higher are supported.
+
+### Features
+- Add Link-reader and WriterCollection [`a0e5cf3`](https://github.com/SAP/ui5-fs/commit/a0e5cf3ef86a4b0cdc817d08963ed6574740f1bc)
+- Introduce Readers "Filter" and "Transformer" ([#331](https://github.com/SAP/ui5-fs/issues/331)) [`f46e6d1`](https://github.com/SAP/ui5-fs/commit/f46e6d1b9aed5858f2d72b10b18635de6ed1f1e0)
+- **Resource:** Add isModified method [`f6a590a`](https://github.com/SAP/ui5-fs/commit/f6a590a284a5ef2879d4d755b5b37be164cf3a45)
+
+### Bug Fixes
+- Allow resource migration ([#407](https://github.com/SAP/ui5-fs/issues/407)) [`1722d71`](https://github.com/SAP/ui5-fs/commit/1722d71b78184cae0dfb092fd3d4c4156924dc28)
+- **FileSystem Adapter:** Use fs.copy / Skip writing when resource is unchanged ([#370](https://github.com/SAP/ui5-fs/issues/370)) [`9ac6a39`](https://github.com/SAP/ui5-fs/commit/9ac6a39f3cb72e02c2a1298b07c4676a0ee92377)
+
+### Dependency Updates
+- Bump minimatch from 5.1.4 to 6.1.5 [`e6b8d14`](https://github.com/SAP/ui5-fs/commit/e6b8d142517a19b138dab5fc19390ed98db425e1)
+
+<a name="v2.0.6"></a>
+## [v2.0.6] - 2020-12-18
+### Bug Fixes
+- **fsInterface on Windows:** Correctly handle project paths containing non-ASCII characters [`6bb44be`](https://github.com/SAP/ui5-fs/commit/6bb44be7c13f6b5c66855d3343694f42f9bdfe0e)
+
+<a name="v2.0.5"></a>
+## [v2.0.5] - 2020-11-06
+### Performance Improvements
+- Reduce install size by moving 'mock-require' to devDependencies [`173f4ff`](https://github.com/SAP/ui5-fs/commit/173f4ffc55f0e264025c6e2bce12721a6673790a)
+
+<a name="v2.0.4"></a>
+## [v2.0.4] - 2020-10-22
+### Bug Fixes
+- **fsInterface:** Improve error messages [`8b998f8`](https://github.com/SAP/ui5-fs/commit/8b998f8a47e89bce0c27f5a4b211bb5471ea2381)
+
+<a name="v2.0.3"></a>
+## [v2.0.3] - 2020-08-12
+### Bug Fixes
+- **ResourceTagCollection:** Do not validate class of resource [`c52c9f7`](https://github.com/SAP/ui5-fs/commit/c52c9f71e4f868cfa8ae5daf5eede9272654b187)
+
+<a name="v2.0.2"></a>
+## [v2.0.2] - 2020-07-30
+### Bug Fixes
+- TypeScript type definition support ([#252](https://github.com/SAP/ui5-fs/issues/252)) [`f379094`](https://github.com/SAP/ui5-fs/commit/f37909483b2740219da36c7e0931f7824d51e1a3)
+- **Resource:** Keep stats size up to date ([#253](https://github.com/SAP/ui5-fs/issues/253)) [`0ef976f`](https://github.com/SAP/ui5-fs/commit/0ef976fe658765ae46afd1b4aa5b9100aa9829f8)
+- **Resource:** getStream for empty string ([#249](https://github.com/SAP/ui5-fs/issues/249)) [`bc5eafb`](https://github.com/SAP/ui5-fs/commit/bc5eafb19bf71141b88dff749240354898849a66)
+- **Resource#getSize:** Retrieve Resource's size ([#256](https://github.com/SAP/ui5-fs/issues/256)) [`9d2cc6c`](https://github.com/SAP/ui5-fs/commit/9d2cc6cf92b4a3f29e5c42db2f14afeeac9a0c98)
+- **adapters/Memory:** Return cloned resources ([#235](https://github.com/SAP/ui5-fs/issues/235)) [`7bf3c6a`](https://github.com/SAP/ui5-fs/commit/7bf3c6a2ce55cd1c48b8aaaed83591bd85c228fa)
+
+### Reverts
+- [FIX] adapters/Memory: Return cloned resources ([#235](https://github.com/SAP/ui5-fs/issues/235))
+
+<a name="v2.0.1"></a>
+## [v2.0.1] - 2020-04-30
+### Bug Fixes
+- Namespaces in API Reference (JSDoc) [`b9d7b3c`](https://github.com/SAP/ui5-fs/commit/b9d7b3c70679436e6cbea07a789ac5e83bab337a)
+
+<a name="v2.0.0"></a>
+## [v2.0.0] - 2020-03-31
+### Breaking Changes
+- Remove deprecated parameter useNamespaces ([#223](https://github.com/SAP/ui5-fs/issues/223)) [`231b319`](https://github.com/SAP/ui5-fs/commit/231b319ea1899d6297e70e7b7746340cd5824217)
+- Require Node.js >= 10 [`46651f1`](https://github.com/SAP/ui5-fs/commit/46651f13bcfe391ef985fabab96f99b6ecafe13e)
+
+### Dependency Updates
+- Bump globby from 10.0.2 to 11.0.0 ([#207](https://github.com/SAP/ui5-fs/issues/207)) [`c81eb9d`](https://github.com/SAP/ui5-fs/commit/c81eb9dffc0d1281640efb2ad7e5419fe5451442)
+
+### BREAKING CHANGE
+
+Remove deprecated parameter "useNamespaces" from
+method "resourceFactory.createCollectionsForTree".
+Use parameter "getVirtualBasePathPrefix" instead.
+
+Support for older Node.js releases has been dropped.
+Only Node.js v10 or higher is supported.
+
+<a name="v1.1.2"></a>
+## [v1.1.2] - 2019-07-01
+### Dependency Updates
+- Bump globby from 9.2.0 to 10.0.0 [`573e853`](https://github.com/SAP/ui5-fs/commit/573e8531827bf1c0320177d3870e37a183db7959)
+
+<a name="v1.1.1"></a>
+## [v1.1.1] - 2019-06-18
+### Bug Fixes
+- **fsInterface:** Handle non-POSIX paths correctly ([#147](https://github.com/SAP/ui5-fs/issues/147)) [`1ad0cc8`](https://github.com/SAP/ui5-fs/commit/1ad0cc8fdbcf74452ebfcebb23bd659faa956e54)
+
+<a name="v1.1.0"></a>
+## [v1.1.0] - 2019-06-03
+### Features
+- **AbstractAdapter:** Add excludes option ([#140](https://github.com/SAP/ui5-fs/issues/140)) [`daef31f`](https://github.com/SAP/ui5-fs/commit/daef31f4fb22405e8fa889615b1f3545099eb186)
+
+<a name="v1.0.2"></a>
+## [v1.0.2] - 2019-03-21
+### Dependency Updates
+- Bump [@ui5](https://github.com/ui5)/logger from 1.0.0 to 1.0.1 ([#122](https://github.com/SAP/ui5-fs/issues/122)) [`e2e2791`](https://github.com/SAP/ui5-fs/commit/e2e27917d936ad5a316c56a0bc0a17d91977d15e)
+
+### Features
+- **fsInterface:** Add mkdir function [`5bd91ac`](https://github.com/SAP/ui5-fs/commit/5bd91acb86d64f03d16abdb186fe66ffa8a9f53a)
+
+<a name="v1.0.1"></a>
+## [v1.0.1] - 2019-02-01
+### Bug Fixes
+- Prevent FS write from draining Resources content [`370f121`](https://github.com/SAP/ui5-fs/commit/370f121ca4d571397c979e2dce72b6a1cf0d0005)
+
+### Dependency Updates
+- **Yarn:** Pin dir-glob dependency to v2.0.0 [`e14457c`](https://github.com/SAP/ui5-fs/commit/e14457c5b3eda1fab3d3444bca3b8406be63db2f)
+
+<a name="v1.0.0"></a>
+## [v1.0.0] - 2019-01-10
+### Breaking Changes
+- **index.js export:** Remove top-level access to adapters [`f1f7831`](https://github.com/SAP/ui5-fs/commit/f1f7831ae9e908731a57f9d67952a61431c69d21)
+
+### Dependency Updates
+- Pin dir-glob to v2.0.0 [`b921fbc`](https://github.com/SAP/ui5-fs/commit/b921fbceaa4f200737b8c6cf45eaf2d9bc3e1df2)
+- Bump [@ui5](https://github.com/ui5)/logger from 0.2.2 to 1.0.0 ([#72](https://github.com/SAP/ui5-fs/issues/72)) [`4077f19`](https://github.com/SAP/ui5-fs/commit/4077f19251dee72933de0747de09a6eec5cb75cc)
+
+### BREAKING CHANGE
+
+Adapters "AbstractAdapter", "FileSystem" and "Memory" used to be accessible via the top-level export of index.js (example: require("[@ui5](https://github.com/ui5)/project").FileSystem). This is no longer possible. Adapters are now grouped in the top-level object "adapters" and can be accessed from there (example: require("[@ui5](https://github.com/ui5)/project").adapters.FileSystem).
+
+<a name="v0.2.0"></a>
+## [v0.2.0] - 2018-07-11
+
+<a name="v0.1.0"></a>
+## [v0.1.0] - 2018-06-26
+
+<a name="v0.0.1"></a>
+## v0.0.1 - 2018-06-06
+### Bug Fixes
+- **AbstractAdapter:** Fix normalization of globstar [`6d484e8`](https://github.com/SAP/ui5-fs/commit/6d484e847b62aa0829641f25a76dcc89b0840d44)
+
+{{- if .Versions }}
+{{ range .Versions -}}
+{{ if and .Tag.Previous (ne .Tag.Name "v3.0.0") -}}
+[{{ .Tag.Name }}]: {{ $.Info.RepositoryURL }}/compare/{{ .Tag.Previous.Name }}...{{ .Tag.Name }}
+{{ end -}}
+{{ end -}}
+{{ end -}}
+[v3.0.5]: https://github.com/SAP/ui5-fs/compare/v3.0.4...v3.0.5
+[v3.0.4]: https://github.com/SAP/ui5-fs/compare/v3.0.3...v3.0.4
+[v3.0.3]: https://github.com/SAP/ui5-fs/compare/v3.0.2...v3.0.3
+[v3.0.2]: https://github.com/SAP/ui5-fs/compare/v3.0.1...v3.0.2
+[v3.0.1]: https://github.com/SAP/ui5-fs/compare/v3.0.0...v3.0.1
+[v3.0.0]: https://github.com/SAP/ui5-fs/compare/v2.0.6...v3.0.0
+[v2.0.6]: https://github.com/SAP/ui5-fs/compare/v2.0.5...v2.0.6
+[v2.0.5]: https://github.com/SAP/ui5-fs/compare/v2.0.4...v2.0.5
+[v2.0.4]: https://github.com/SAP/ui5-fs/compare/v2.0.3...v2.0.4
+[v2.0.3]: https://github.com/SAP/ui5-fs/compare/v2.0.2...v2.0.3
+[v2.0.2]: https://github.com/SAP/ui5-fs/compare/v2.0.1...v2.0.2
+[v2.0.1]: https://github.com/SAP/ui5-fs/compare/v2.0.0...v2.0.1
+[v2.0.0]: https://github.com/SAP/ui5-fs/compare/v1.1.2...v2.0.0
+[v1.1.2]: https://github.com/SAP/ui5-fs/compare/v1.1.1...v1.1.2
+[v1.1.1]: https://github.com/SAP/ui5-fs/compare/v1.1.0...v1.1.1
+[v1.1.0]: https://github.com/SAP/ui5-fs/compare/v1.0.2...v1.1.0
+[v1.0.2]: https://github.com/SAP/ui5-fs/compare/v1.0.1...v1.0.2
+[v1.0.1]: https://github.com/SAP/ui5-fs/compare/v1.0.0...v1.0.1
+[v1.0.0]: https://github.com/SAP/ui5-fs/compare/v0.2.0...v1.0.0
+[v0.2.0]: https://github.com/SAP/ui5-fs/compare/v0.1.0...v0.2.0
+[v0.1.0]: https://github.com/SAP/ui5-fs/compare/v0.0.1...v0.1.0

packages/fs/.chglog/RELEASE.tpl.md

@@ -0,0 +1,33 @@
+{{ range .Versions }}
+{{ range .CommitGroups -}}
+### {{ .Title }}
+{{ range .Commits -}}
+- {{ if .Scope }}**{{ .Scope }}:** {{ end }}{{ .Subject }} [`{{ .Hash.Short }}`]({{ $.Info.RepositoryURL }}/commit/{{ .Hash.Long }})
+{{ end }}
+{{ end -}}
+
+{{- if .RevertCommits -}}
+### Reverts
+{{ range .RevertCommits -}}
+- {{ .Revert.Header }}
+{{ end }}
+{{ end -}}
+
+{{- if .NoteGroups -}}
+{{ range .NoteGroups -}}
+### {{ .Title }}
+{{ range .Notes }}
+{{ .Body }}
+{{ end }}
+{{ end -}}
+{{ end -}}
+
+{{ if .Tag.Previous }}
+### All changes
+[`{{ .Tag.Previous.Name }}...{{ .Tag.Name }}`]
+{{ end }}
+
+{{ if .Tag.Previous -}}
+[`{{ .Tag.Previous.Name }}...{{ .Tag.Name }}`]: {{ $.Info.RepositoryURL }}/compare/{{ .Tag.Previous.Name }}...{{ .Tag.Name }}
+{{ end -}}
+{{ end -}}

packages/fs/.chglog/config.yml

@@ -0,0 +1,33 @@
+style: github
+template: CHANGELOG.tpl.md
+info:
+  title: CHANGELOG
+  repository_url: https://github.com/SAP/ui5-fs
+options:
+  commits:
+    filters:
+      Type:
+        - FEATURE
+        - FIX
+        - PERF
+        - DEPENDENCY
+        - BREAKING
+  commit_groups:
+    title_maps:
+       FEATURE: Features
+       FIX: Bug Fixes
+       PERF: Performance Improvements
+       DEPENDENCY: Dependency Updates
+       BREAKING: Breaking Changes
+  header:
+    pattern: "^\\[(\\w*)\\]\\s(?:([^\\:]*)\\:\\s)?(.*)$"
+    pattern_maps:
+      - Type
+      - Scope
+      - Subject
+  issues:
+    prefix:
+      - "#"
+  notes:
+    keywords:
+      - BREAKING CHANGE

packages/fs/.chglog/release-config.yml

@@ -0,0 +1,33 @@
+style: github
+template: RELEASE.tpl.md
+info:
+  repository_url: https://github.com/SAP/ui5-fs
+options:
+  tag_filter_pattern: '^v[^0123]' # For release notes ignore versions below v4 to that we always compare the _last v4+_ tag with the current release
+  commits:
+    filters:
+      Type:
+        - FEATURE
+        - FIX
+        - PERF
+        - DEPENDENCY
+        - BREAKING
+  commit_groups:
+    title_maps:
+       FEATURE: Features
+       FIX: Bug Fixes
+       PERF: Performance Improvements
+       DEPENDENCY: Dependency Updates
+       BREAKING: Breaking Changes
+  header:
+    pattern: "^\\[(\\w*)\\]\\s(?:([^\\:]*)\\:\\s)?(.*)$"
+    pattern_maps:
+      - Type
+      - Scope
+      - Subject
+  issues:
+    prefix:
+      - "#"
+  notes:
+    keywords:
+      - BREAKING CHANGE

packages/fs/.editorconfig

@@ -0,0 +1,20 @@
+# see http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+indent_style = tab
+
+[*.{css,html,js,cjs,mjs,jsx,ts,tsx,less,txt,json,yml,md}]
+trim_trailing_whitespace = true
+end_of_line = lf
+indent_size = 4
+insert_final_newline = true
+
+[*.{yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

packages/fs/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

packages/fs/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,3 @@
+## 🚨 Issues Have Been Transferred to UI5 CLI Repository
+
+Please create new issues in the UI5 CLI repository: https://github.com/UI5/cli/issues/new/choose

packages/fs/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Report UI5 CLI Issues or Request a Feature
+    url: https://github.com/UI5/cli/issues/new/choose
+    about: Please create new issues in the UI5 CLI repository

packages/fs/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+**Thank you for your contribution!** 🙌
+
+To get it merged faster, kindly review the checklist below:
+
+## Pull Request Checklist
+- [ ] Reviewed the [Contributing Guidelines](https://github.com/UI5/cli/blob/main/CONTRIBUTING.md#-contributing-code)
+    + Especially the [How to Contribute](https://github.com/UI5/cli/blob/main/CONTRIBUTING.md#how-to-contribute) section 
+- [ ] [No merge commits](https://github.com/UI5/cli/blob/main/docs/Guidelines.md#no-merge-commits)
+- [ ] [Correct commit message style](https://github.com/UI5/cli/blob/main/docs/Guidelines.md#commit-message-style)