@cdmbase/wiki-browser 12.0.18-alpha.5

package/lib/templates/content/docs/contributing/git-subtree-sharing.md

@@ -0,0 +1,73 @@
+---
+meta:
+    title: Git Subtree Sharing
+    description: Git Subtree Sharing
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: Git Subtree Sharing...
+headers:
+    Cache-Control: no-cache
+---
+
+## Sharing packages to remote with splash option
+
+- In the source create subtree branch using `split` for the directory we wan to share
+
+```
+git clone https://github.com/CDEBase/fullstack-pro.git fullstack-source
+git subtree split --prefix=packages-modules/counter/browser --branch=split-packages-modules/counter/browser --rejoin --squash
+```
+
+- The target
+
+```
+mkdir fullstack-target
+cd fullstack-target
+touch file1.txt file2.txt file3.txt
+git init
+git add .
+git commit -m 'first commit'
+```
+
+- Add subtree
+
+```
+git subtree add --prefix=packages-modules/counter/browser ../fullstack-source split-packages-modules/counter/browser
+```
+
+### To push changes from target to source
+
+- create a file in subtree
+
+```
+touch packages-modules/counter/browser/shared_file.txt
+git add .
+git commit -m 'shared file;
+```
+
+- push the file source
+
+```
+git subtree push --prefix=packages-modules/counter/browser ../fullstack-source split-packages-modules/counter/browser
+```
+
+### To merge the subtree changes to the source project master
+
+```
+cd fullstack-source
+git subtree pull --prefix=packages-modules/counter/browser ../fullstack-source split-packages-modules/counter/browser --squash
+```
+
+### To push the changes from source to target project
+
+```
+cd fullstack-source
+vi packages-modules/counter/browser/shared_file.test
+git subtree split --prefix=packages-modules/counter/browser --branch=split-packages-modules/counter/browser --rejoin --squash
+```
+
+- from target pull those changes
+
+```
+git subtree pull --prefix=packages-modules/counter/browser ../fullstack-source split-packages-modules/counter/browser
+```

package/lib/templates/content/docs/contributing/graphql-subscriptions.md

@@ -0,0 +1,69 @@
+---
+meta:
+    title: Grapgql Subscriptions
+    description: Grapgql Subscriptions
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: Grapgql Subscriptions...
+headers:
+    Cache-Control: no-cache
+---
+
+## How to write graphql subscriptions
+
+1. Write Graphql Service
+
+```
+// services.graqphl
+
+"""
+ Subscription event for timer
+"""
+enum TimeTrackerPubSubEvents {
+    TimeTrackerCreated
+    TimeTrackerUpdated
+    TimeTrackerConfigurationUpdate
+}
+
+// timerecord.graphql
+extend type Subscription {
+  SubscribeToTimeTracker(orgNameFilter: string, userId: String): TimeRecord
+}
+
+
+// resolvers
+
+import {withFilter} from 'graphql-subscriptions';
+
+export const resolver = (options) => ({
+  ....
+  Subscription: {
+    SubscribeToOrganizationContext: {
+      subscribe: withFilter(
+        () =>
+          options.pubsub.asyncIterator([
+            ITimeRecordPubSubEvents.TimeRecordCreated,
+            ITimeRecordPubSubEvents.TimeRecordUpdated,
+          ]),
+        async (payload, variables, context: {}) =>
+          payload.SubscribeToOrganizationContext.orgId === variables.orgNameFilter &&
+          payload.SubscribeToOrganizationContext.userId === variables.userId,
+      ),
+    },
+  },
+
+})
+
+
+
+/// service file
+
+
+  public async createTimeRecord(userId: string, orgId: string, request: ITimeRecordRequest) {
+    const data = await this.timeRecordRepository.createTimeRecord(userId, orgId, request);
+    this.pubsub.publish(ITimeRecordPubSubEvents.TimeRecordCreated, { SubscribeToTimeTracker: data });
+    return data;
+  }
+
+
+```

package/lib/templates/content/docs/contributing/how-to-contribute.md

@@ -0,0 +1,30 @@
+---
+meta:
+    title: How To Contribute
+    description: How To Contribute
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: How To Contribute ...
+headers:
+    Cache-Control: no-cache
+---
+
+## How to contribute ?
+
+Follow the [Coding Guidles](./coding-guidelines.md) and [Source Code Organisation](./source-code-organization.md)
+
+You need to be familiar with `lerna` tool and know about various command to run the project. More details about lerna is [here](./lerna-build-tools.md)
+
+## Project setup
+
+Follow the project setup steps [here](./project-setup.md)
+
+## Branch to use
+
+1. Once you setup the project, switch to `develop` branch.
+2. Create a new branch using `develop` branch as source based on the issue you working.
+3. Update changes to that branch and create a PR against `develop` branch.
+4. As soon as PR is created, we have a build process that runs in the background to check whether it is successful or failed.
+5. If it successfull you will see a green check otherwise a red cross. When you notice it has red cross then run `yarn build` locally and fix any issues and submit the commit again to check it's updated status.
+
+Note: `master` branch is read-only branch and we don't want to merge anything to it other than that from `develop` branch. So please avoid creating PRs against `master` branch.

package/lib/templates/content/docs/contributing/how_to_check_pure_esm.md

@@ -0,0 +1,29 @@
+---
+meta:
+    title: Check the notes for pure esm
+    description: Check the notes for pure esm
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: Check the notes for pure esm ...
+headers:
+    Cache-Control: no-cache
+---
+
+### Check the notes for pure esm
+
+https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+### Check remix notes on esm/cjs problems
+
+https://remix.run/docs/en/main/guides/vite#esm--cjs
+
+### Applying the Solution Generally
+
+This pattern can be applied to any module that might export differently based on ESM or CJS.
+
+```javascript
+import someModuleSource from 'some-module';
+
+const someModule = (someModuleSource as any).default ?? someModuleSource;
+
+```

package/lib/templates/content/docs/contributing/index.md

@@ -0,0 +1,60 @@
+---
+meta:
+    title: Contribute
+    description: Contribute
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: Contribute...
+headers:
+    Cache-Control: no-cache
+---
+
+## Contribute
+
+**[How to contribute ?](/docs/contributing/how-to-contribute)**
+
+**[Adding package to sub packages or to servers or to devices](/docs/contributing/adding-package)**
+
+**[Adding New Module](/docs/contributing/adding_new_modules)**
+
+**[Avoid using promises in UI](/docs/contributing/avoid-using-promises-ui)**
+
+**[Coding Guidelines](/docs/contributing/coding-guidelines)**
+
+**[Do and Don't](/docs/contributing/do-and-dont)**
+
+**[Babel, JSX, and Build Steps](/docs/contributing/faq-build)**
+
+**[Folder Setup](/docs/contributing/folder-setup)**
+
+**[Frontend Coding](/cdebase-wiki/docs/contributing/frontend-coding)**
+
+**[Git Subtree Sharing](/docs/contributing/git-subtree-sharing)**
+
+**[How to write graphql subscriptions](/docs/contributing/graphql-subscriptions)**
+
+**[Installation Issues](/docs/contributing/installation-issues)**
+
+**[Keyboard Shortcut](/docs/contributing/keyboard-shortcut)**
+
+**[Build tools](/docs/contributing/lerna-build-tools)**
+
+**[Lerna Yarn Workspaces](/docs/contributing/lerna-yarn-workspaces)**
+
+**[Lint and Formatter](/docs/contributing/lint-and-formatter)**
+
+**[Debugging](/docs/contributing/mobile-setup)**
+
+**[Project Setup](/docs/contributing/project-setup)**
+
+**[React](/docs/contributing/react)**
+
+**[Run Various Options](/docs/contributing/run-various-options)**
+
+**[Schema First Graphql Types](/docs/contributing/schema-first-graphql-types)**
+
+**[Source Code Organization](/docs/contributing/source-code-organization)**
+
+**[Third Party](/docs/contributing/third-party)**
+
+**[Typescript Contribution](/docs/contributing/typescript-contribution)**

package/lib/templates/content/docs/contributing/installation-issues.md

@@ -0,0 +1,23 @@
+---
+meta:
+    title: Installation Issues
+    description: Installation Issues
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: Installation Issues...
+headers:
+    Cache-Control: no-cache
+---
+
+## Installation Issues
+
+1. Error when `node-gyp rebuild`.
+   Could be missing `python`. Install it and rerun the install again.
+   For more docs, check https://github.com/nodejs/node-gyp#installation
+
+2. For Mac User to develop Desktop app need
+   `xcode-select --install`
+
+3. Increase Mac default ulimit
+
+https://gist.github.com/skylock/0117ec637d468f91260927b43b816eda

package/lib/templates/content/docs/contributing/keyboard-shortcut.md

@@ -0,0 +1,131 @@
+---
+meta:
+    title: Keyboard Shortcuts
+    description: Keyboard Shortcuts
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: Keyboard Shortcuts...
+headers:
+    Cache-Control: no-cache
+---
+
+## Keyboard Shortcuts
+
+# VSCODE Editor
+
+Ctl + n -> Next line
+
+Ctl + p -> Prev line
+
+Ctl + o -> insert above
+
+Ctl + b -> move cursor right
+
+Ctl + f -> move cursor left
+
+Ctl + d -> Delete letter
+
+Ctl + a -> Begin of line
+
+Ctl + e -> End of line
+
+CMD + { 1, 2, 3} -> to move between editors
+
+CMD + Tab -> To navigate between editors
+
+CMD + K, N -> To view probelems highlighted
+
+CMD + . -> To get quick suggestion
+
+Custome Key Binding, To switch between terminal and editor
+
+```
+// Place your key bindings in this file to override the defaultsauto[]
+[
+    {
+        "key": "ctrl+shift+t",
+        "command": "workbench.action.terminal.focus"
+    },
+    {
+        "key": "ctrl+shift+t",
+        "command": "workbench.action.focusActiveEditorGroup",
+        "when": "terminalFocus"
+    }
+]
+```
+
+# VIM
+
+hjkl -> left, down, up, right
+
+w -> next word start
+
+e -> next word end
+
+ge -> previous word end
+
+yw -> copy the word
+
+p -> paste after cursor
+
+P -> paste before cursor
+
+Movement by word
+
+b, B, e, E
+
+Movement by sentance
+
+( -> previous sentance begining
+
+) -> moves to the next end
+
+d) -> delete everything to end of sentance.
+
+2d) -> delete two sentance
+
+Movement by paragraph
+
+{ -> moves to the above paragraph
+
+} -> moves to below paragraph
+
+Intra-Line movement
+
+t -> before the search letter in the word
+
+f -> begining of search letter in the word
+
+Start and End of line jumps
+
+0 -> begining of line
+
+$ -> end of line
+
+I -> jumps to begining of the line with insert mode
+
+A -> jumps to end of the line with insert mode.
+
+vi{ or va{ or f{% -> to select the content between brackets.
+
+- Indent a block of code in vi by three spaces with Visual Line mode:
+
+    Open your file in VI.
+    Put your cursor over some code
+    Be in normal mode press the following keys:
+
+    `Vjjjj:le 3`
+
+    ** Interpretation of what you did: **
+
+    `V` means start selecting text.
+
+    `jjjj` arrows down 4 lines, highlighting 4 lines.
+
+    `:` tells vi you will enter an instruction for the highlighted text.
+
+    `le 3` means indent highlighted text 3 lines.
+
+# IO Simulator
+
+Ctl + Cmd + z

package/lib/templates/content/docs/contributing/language/locale-support.md

@@ -0,0 +1,12 @@
+---
+meta:
+    title: Locale Support
+    description: Locale Support
+date: '2023-06-02T00:00:00'
+updated: '2024-06-02T00:00:00'
+excerpt: Locale Support...
+headers:
+    Cache-Control: no-cache
+---
+
+## Locale Support