Skip to content

Commit a82f1b4

Browse files
committed
chore: doc
1 parent 7a9ab8b commit a82f1b4

File tree

8 files changed

+218
-41
lines changed

8 files changed

+218
-41
lines changed

README.md

Lines changed: 98 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -754,4 +754,101 @@ One easy solution is t modify `~/.gitconfig` and add
754754
## Questions
755755
756756
If you have any questions/issues/comments please feel free to create an issue or start a conversation in the [NativeScript Community Discord](https://nativescript.org/discord).
757-
</details>
757+
</details>
758+
759+
[](#demos-and-development)
760+
761+
## Demos and Development
762+
763+
764+
### Repo Setup
765+
766+
The repo uses submodules. If you did not clone with ` --recursive` then you need to call
767+
```
768+
git submodule update --init
769+
```
770+
771+
The package manager used to install and link dependencies must be `pnpm` or `yarn`. `npm` wont work.
772+
773+
To develop and test:
774+
if you use `yarn` then run `yarn`
775+
if you use `pnpm` then run `pnpm i`
776+
777+
**Interactive Menu:**
778+
779+
To start the interactive menu, run `npm start` (or `yarn start` or `pnpm start`). This will list all of the commonly used scripts.
780+
781+
### Build
782+
783+
```bash
784+
npm run build.all
785+
```
786+
WARNING: it seems `yarn build.all` wont always work (not finding binaries in `node_modules/.bin`) which is why the doc explicitly uses `npm run`
787+
788+
### Demos
789+
790+
```bash
791+
npm run demo.[ng|react|svelte|vue].[ios|android]
792+
793+
npm run demo.svelte.ios # Example
794+
```
795+
796+
Demo setup is a bit special in the sense that if you want to modify/add demos you dont work directly in `demo-[ng|react|svelte|vue]`
797+
Instead you work in `demo-snippets/[ng|react|svelte|vue]`
798+
You can start from the `install.ts` of each flavor to see how to register new demos
799+
800+
801+
[](#contributing)
802+
803+
## Contributing
804+
805+
### Update repo
806+
807+
You can update the repo files quite easily
808+
809+
First update the submodules
810+
811+
```bash
812+
npm run update
813+
```
814+
815+
Then commit the changes
816+
Then update common files
817+
818+
```bash
819+
npm run sync
820+
```
821+
Then you can run `yarn|pnpm`, commit changed files if any
822+
823+
### Update readme
824+
```bash
825+
npm run readme
826+
```
827+
828+
### Update doc
829+
```bash
830+
npm run doc
831+
```
832+
833+
### Publish
834+
835+
The publishing is completely handled by `lerna` (you can add `-- --bump major` to force a major release)
836+
Simply run
837+
```shell
838+
npm run publish
839+
```
840+
841+
### modifying submodules
842+
843+
The repo uses https:// for submodules which means you won't be able to push directly into the submodules.
844+
One easy solution is t modify `~/.gitconfig` and add
845+
```
846+
[url "ssh://[email protected]/"]
847+
pushInsteadOf = https://github.com/
848+
```
849+
850+
[](#questions)
851+
852+
## Questions
853+
854+
If you have any questions/issues/comments please feel free to create an issue or start a conversation in the [NativeScript Community Discord](https://nativescript.org/discord).

docs/assets/search.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/classes/ui_canvas.Canvas.html

Lines changed: 1 addition & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,7 @@ <h4>Hierarchy</h4>
2121
<ul class="tsd-hierarchy">
2222
<li><span class="target">Canvas</span></li></ul></section><aside class="tsd-sources">
2323
<ul>
24-
<li>Defined in packages/ui-canvas/index.d.ts:111</li>
25-
<li>Defined in packages/ui-svg/index.android.d.ts:6</li></ul></aside>
24+
<li>Defined in packages/ui-canvas/index.d.ts:111</li></ul></aside>
2625
<section class="tsd-panel-group tsd-index-group">
2726
<section class="tsd-panel tsd-index-panel">
2827
<details class="tsd-index-content tsd-index-accordion" open><summary class="tsd-accordion-summary tsd-index-summary">
@@ -33,10 +32,6 @@ <h3 class="tsd-index-heading">Constructors</h3>
3332
<div class="tsd-index-list"><a href="ui_canvas.Canvas.html#constructor" class="tsd-index-link tsd-kind-constructor tsd-parent-kind-class"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><rect fill="var(--color-icon-background)" stroke="#4D7FFF" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12" id="icon-512-path"></rect><path d="M11.898 16.1201C11.098 16.1201 10.466 15.8961 10.002 15.4481C9.53803 15.0001 9.30603 14.3841 9.30603 13.6001V9.64012C9.30603 8.85612 9.53803 8.24012 10.002 7.79212C10.466 7.34412 11.098 7.12012 11.898 7.12012C12.682 7.12012 13.306 7.34812 13.77 7.80412C14.234 8.25212 14.466 8.86412 14.466 9.64012H13.386C13.386 9.14412 13.254 8.76412 12.99 8.50012C12.734 8.22812 12.37 8.09212 11.898 8.09212C11.426 8.09212 11.054 8.22412 10.782 8.48812C10.518 8.75212 10.386 9.13212 10.386 9.62812V13.6001C10.386 14.0961 10.518 14.4801 10.782 14.7521C11.054 15.0161 11.426 15.1481 11.898 15.1481C12.37 15.1481 12.734 15.0161 12.99 14.7521C13.254 14.4801 13.386 14.0961 13.386 13.6001H14.466C14.466 14.3761 14.234 14.9921 13.77 15.4481C13.306 15.8961 12.682 16.1201 11.898 16.1201Z" fill="var(--color-text)" id="icon-512-text"></path></svg><span>constructor</span></a>
3433
</div></section>
3534
<section class="tsd-index-section">
36-
<h3 class="tsd-index-heading">Properties</h3>
37-
<div class="tsd-index-list"><a href="ui_canvas.Canvas.html#_native" class="tsd-index-link tsd-kind-property tsd-parent-kind-class"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><rect fill="var(--color-icon-background)" stroke="#FF984D" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12" id="icon-1024-path"></rect><path d="M9.354 16V7.24H12.174C12.99 7.24 13.638 7.476 14.118 7.948C14.606 8.412 14.85 9.036 14.85 9.82C14.85 10.604 14.606 11.232 14.118 11.704C13.638 12.168 12.99 12.4 12.174 12.4H10.434V16H9.354ZM10.434 11.428H12.174C12.646 11.428 13.022 11.284 13.302 10.996C13.59 10.7 13.734 10.308 13.734 9.82C13.734 9.324 13.59 8.932 13.302 8.644C13.022 8.356 12.646 8.212 12.174 8.212H10.434V11.428Z" fill="var(--color-text)" id="icon-1024-text"></path></svg><span>_native</span></a>
38-
</div></section>
39-
<section class="tsd-index-section">
4035
<h3 class="tsd-index-heading">Methods</h3>
4136
<div class="tsd-index-list"><a href="ui_canvas.Canvas.html#clear" class="tsd-index-link tsd-kind-method tsd-parent-kind-class"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><rect fill="var(--color-icon-background)" stroke="#FF4DB8" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="12" id="icon-2048-path"></rect><path d="M9.162 16V7.24H10.578L11.514 10.072C11.602 10.328 11.674 10.584 11.73 10.84C11.794 11.088 11.842 11.28 11.874 11.416C11.906 11.28 11.954 11.088 12.018 10.84C12.082 10.584 12.154 10.324 12.234 10.06L13.122 7.24H14.538V16H13.482V12.82C13.482 12.468 13.49 12.068 13.506 11.62C13.53 11.172 13.558 10.716 13.59 10.252C13.622 9.78 13.654 9.332 13.686 8.908C13.726 8.476 13.762 8.1 13.794 7.78L12.366 12.16H11.334L9.894 7.78C9.934 8.092 9.97 8.456 10.002 8.872C10.042 9.28 10.078 9.716 10.11 10.18C10.142 10.636 10.166 11.092 10.182 11.548C10.206 12.004 10.218 12.428 10.218 12.82V16H9.162Z" fill="var(--color-text)" id="icon-2048-text"></path></svg><span>clear</span></a>
4237
<a href="ui_canvas.Canvas.html#clipOutPath" class="tsd-index-link tsd-kind-method tsd-parent-kind-class"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-2048-path"></use><use href="#icon-2048-text"></use></svg><span>clip<wbr/>Out<wbr/>Path</span></a>
@@ -100,13 +95,6 @@ <h4 class="tsd-returns-title">Returns <a href="ui_canvas.Canvas.html" class="tsd
10095
<ul>
10196
<li>Defined in packages/ui-canvas/index.d.ts:112</li></ul></aside></li></ul></section></section>
10297
<section class="tsd-panel-group tsd-member-group">
103-
<h2>Properties</h2>
104-
<section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-class"><a id="_native" class="tsd-anchor"></a>
105-
<h3 class="tsd-anchor-link"><span>_native</span><a href="#_native" aria-label="Permalink" class="tsd-anchor-icon"><svg class="icon icon-tabler icon-tabler-link" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><use href="#icon-anchor-a"></use><use href="#icon-anchor-b"></use><use href="#icon-anchor-c"></use></svg></a></h3>
106-
<div class="tsd-signature">_native<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">Canvas</span></div><aside class="tsd-sources">
107-
<ul>
108-
<li>Defined in packages/ui-svg/index.android.d.ts:7</li></ul></aside></section></section>
109-
<section class="tsd-panel-group tsd-member-group">
11098
<h2>Methods</h2>
11199
<section class="tsd-panel tsd-member tsd-kind-method tsd-parent-kind-class"><a id="clear" class="tsd-anchor"></a>
112100
<h3 class="tsd-anchor-link"><span>clear</span><a href="#clear" aria-label="Permalink" class="tsd-anchor-icon"><svg class="icon icon-tabler icon-tabler-link" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><use href="#icon-anchor-a"></use><use href="#icon-anchor-b"></use><use href="#icon-anchor-c"></use></svg></a></h3>
@@ -1038,7 +1026,6 @@ <h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><path d="M4.9389
10381026
<li class="current tsd-kind-class tsd-parent-kind-module"><a href="ui_canvas.Canvas.html" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><rect fill="var(--color-icon-background)" stroke="var(--color-ts-class)" stroke-width="1.5" x="1" y="1" width="22" height="22" rx="6" id="icon-128-path"></rect><path d="M11.898 16.1201C11.098 16.1201 10.466 15.8961 10.002 15.4481C9.53803 15.0001 9.30603 14.3841 9.30603 13.6001V9.64012C9.30603 8.85612 9.53803 8.24012 10.002 7.79212C10.466 7.34412 11.098 7.12012 11.898 7.12012C12.682 7.12012 13.306 7.34812 13.77 7.80412C14.234 8.25212 14.466 8.86412 14.466 9.64012H13.386C13.386 9.14412 13.254 8.76412 12.99 8.50012C12.734 8.22812 12.37 8.09212 11.898 8.09212C11.426 8.09212 11.054 8.22412 10.782 8.48812C10.518 8.75212 10.386 9.13212 10.386 9.62812V13.6001C10.386 14.0961 10.518 14.4801 10.782 14.7521C11.054 15.0161 11.426 15.1481 11.898 15.1481C12.37 15.1481 12.734 15.0161 12.99 14.7521C13.254 14.4801 13.386 14.0961 13.386 13.6001H14.466C14.466 14.3761 14.234 14.9921 13.77 15.4481C13.306 15.8961 12.682 16.1201 11.898 16.1201Z" fill="var(--color-text)" id="icon-128-text"></path></svg><span>Canvas</span></a>
10391027
<ul>
10401028
<li class="tsd-kind-constructor tsd-parent-kind-class"><a href="ui_canvas.Canvas.html#constructor" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-512-path"></use><use href="#icon-512-text"></use></svg>constructor</a></li>
1041-
<li class="tsd-kind-property tsd-parent-kind-class"><a href="ui_canvas.Canvas.html#_native" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-1024-path"></use><use href="#icon-1024-text"></use></svg>_native</a></li>
10421029
<li class="tsd-kind-method tsd-parent-kind-class"><a href="ui_canvas.Canvas.html#clear" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-2048-path"></use><use href="#icon-2048-text"></use></svg>clear</a></li>
10431030
<li class="tsd-kind-method tsd-parent-kind-class"><a href="ui_canvas.Canvas.html#clipOutPath" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-2048-path"></use><use href="#icon-2048-text"></use></svg>clip<wbr/>Out<wbr/>Path</a></li>
10441031
<li class="tsd-kind-method tsd-parent-kind-class"><a href="ui_canvas.Canvas.html#clipOutRect" class="tsd-index-link"><svg class="tsd-kind-icon" width="24" height="24" viewBox="0 0 24 24"><use href="#icon-2048-path"></use><use href="#icon-2048-text"></use></svg>clip<wbr/>Out<wbr/>Rect</a></li>

docs/classes/ui_canvas.StaticLayout.html

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ <h2>Constructors</h2>
4343
<section class="tsd-panel tsd-member tsd-kind-constructor tsd-parent-kind-class"><a id="constructor" class="tsd-anchor"></a>
4444
<h3 class="tsd-anchor-link"><span>constructor</span><a href="#constructor" aria-label="Permalink" class="tsd-anchor-icon"><svg class="icon icon-tabler icon-tabler-link" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none" id="icon-anchor-a"></path><path d="M10 14a3.5 3.5 0 0 0 5 0l4 -4a3.5 3.5 0 0 0 -5 -5l-.5 .5" id="icon-anchor-b"></path><path d="M14 10a3.5 3.5 0 0 0 -5 0l-4 4a3.5 3.5 0 0 0 5 5l.5 -.5" id="icon-anchor-c"></path></svg></a></h3>
4545
<ul class="tsd-signatures tsd-kind-constructor tsd-parent-kind-class">
46-
<li class="tsd-signature tsd-anchor-link" id="constructor.new_StaticLayout">new <wbr/>Static<wbr/>Layout<span class="tsd-signature-symbol">(</span>text<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">any</span>, paint<span class="tsd-signature-symbol">: </span><a href="ui_canvas.Paint.html" class="tsd-signature-type" data-tsd-kind="Class">Paint</a>, width<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">number</span>, align<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">any</span>, spacingmult<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">any</span>, spacingadd<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">any</span>, includepad<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><a href="ui_canvas.StaticLayout.html" class="tsd-signature-type" data-tsd-kind="Class">StaticLayout</a><a href="#constructor.new_StaticLayout" aria-label="Permalink" class="tsd-anchor-icon"><svg class="icon icon-tabler icon-tabler-link" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><use href="#icon-anchor-a"></use><use href="#icon-anchor-b"></use><use href="#icon-anchor-c"></use></svg></a></li>
46+
<li class="tsd-signature tsd-anchor-link" id="constructor.new_StaticLayout">new <wbr/>Static<wbr/>Layout<span class="tsd-signature-symbol">(</span>text<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">any</span>, paint<span class="tsd-signature-symbol">: </span><a href="ui_canvas.Paint.html" class="tsd-signature-type" data-tsd-kind="Class">Paint</a>, width<span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">number</span>, align<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">any</span>, spacingmult<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">any</span>, spacingadd<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">any</span>, includepad<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">any</span>, ellipsize<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">any</span>, ellipsizedWidth<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">any</span>, height<span class="tsd-signature-symbol">?: </span><span class="tsd-signature-type">any</span><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><a href="ui_canvas.StaticLayout.html" class="tsd-signature-type" data-tsd-kind="Class">StaticLayout</a><a href="#constructor.new_StaticLayout" aria-label="Permalink" class="tsd-anchor-icon"><svg class="icon icon-tabler icon-tabler-link" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"><use href="#icon-anchor-a"></use><use href="#icon-anchor-b"></use><use href="#icon-anchor-c"></use></svg></a></li>
4747
<li class="tsd-description">
4848
<div class="tsd-parameters">
4949
<h4 class="tsd-parameters-title">Parameters</h4>
@@ -55,13 +55,19 @@ <h5>paint: <a href="ui_canvas.Paint.html" class="tsd-signature-type" data-tsd-ki
5555
<li>
5656
<h5>width: <span class="tsd-signature-type">number</span></h5></li>
5757
<li>
58-
<h5>align: <span class="tsd-signature-type">any</span></h5></li>
58+
<h5><code class="tsd-tag ts-flagOptional">Optional</code> align: <span class="tsd-signature-type">any</span></h5></li>
5959
<li>
60-
<h5>spacingmult: <span class="tsd-signature-type">any</span></h5></li>
60+
<h5><code class="tsd-tag ts-flagOptional">Optional</code> spacingmult: <span class="tsd-signature-type">any</span></h5></li>
6161
<li>
62-
<h5>spacingadd: <span class="tsd-signature-type">any</span></h5></li>
62+
<h5><code class="tsd-tag ts-flagOptional">Optional</code> spacingadd: <span class="tsd-signature-type">any</span></h5></li>
6363
<li>
64-
<h5>includepad: <span class="tsd-signature-type">any</span></h5></li></ul></div>
64+
<h5><code class="tsd-tag ts-flagOptional">Optional</code> includepad: <span class="tsd-signature-type">any</span></h5></li>
65+
<li>
66+
<h5><code class="tsd-tag ts-flagOptional">Optional</code> ellipsize: <span class="tsd-signature-type">any</span></h5></li>
67+
<li>
68+
<h5><code class="tsd-tag ts-flagOptional">Optional</code> ellipsizedWidth: <span class="tsd-signature-type">any</span></h5></li>
69+
<li>
70+
<h5><code class="tsd-tag ts-flagOptional">Optional</code> height: <span class="tsd-signature-type">any</span></h5></li></ul></div>
6571
<h4 class="tsd-returns-title">Returns <a href="ui_canvas.StaticLayout.html" class="tsd-signature-type" data-tsd-kind="Class">StaticLayout</a></h4><aside class="tsd-sources">
6672
<p>Overrides android.text.StaticLayout.constructor</p>
6773
<ul>

0 commit comments

Comments
 (0)