fix(ci): release scripts fix, docs-publishing script add

akveo · Dec 3, 2019 · ea44bee · ea44bee
1 parent bd17356
commit ea44bee
Show file tree

Hide file tree

Showing 213 changed files with 201,329 additions and 1,828 deletions.
diff --git a/.gitignore b/.gitignore
@@ -13,10 +13,15 @@ npm-debug.log
 docs/docs.json
 docs/src/input.json
 docs/src/playground.json
+docs/src/examples.json
 docs/src/assets/playground-build/
+docs/src/assets/examples-build/
 
 # env
 src/playground/env/index.js
 
+#config
+config/
+
 .expo
 dist
diff --git a/DEV_DOCS.md b/DEV_DOCS.md
@@ -221,19 +221,17 @@ import { AwesomeComponentScreen } from '@pg/scenes/awesomeComponent/awesomeCompo
 To start a new release (publish the framework packages on NPM) you need:
 
 1. Create a new release branch with template `release/vX.X.X`
-3. Run tests: `yarn release:validate`
+2. Run tests: `npm run lint && npm run test`
 3. MANUALLY update a version in main ./package.json to a new one
-4. Generate documentation if needed: `yarn docs:start`
-5. Generate changelog: `yarn release:changelog`
-6. Fix/expand changelog manually
-7. Update documentation (e.g [DEV_DOCS.md](./DEV_DOCS.md)) files if needed
-8. Push the branch, create PR, approve - merge
-9. Pull the upstream (master or another version branch (e.g. 4.0.1, next))   
-10. Run tests: `yarn release:validate`
-11. Assemble build: `yarn release:prepare`
-12. Publish the package to npm: `yarn release`
-13. Create and push [git tag](https://git-scm.com/book/en/v2/Git-Basics-Tagging) with template `(vX.X.X)`
-14. Create release on GitHub for the tag
+4. Generate changelog: `npm run bump-version`
+5. Fix/expand changelog manually
+6. Update documentation (e.g [DEV_DOCS.md](./DEV_DOCS.md)) files if needed
+7. Push the branch, create PR, approve - merge
+8. Pull the upstream (master or another version branch (e.g. 4.0.1, next))   
+9. Publish documentation: `npm run publish-docs`
+10. Publish framework packages: `npm run publish-packages`
+11. Create and push [git tag](https://git-scm.com/book/en/v2/Git-Basics-Tagging) with template `(vX.X.X)`
+12. Create release on GitHub for the tag
 
 # Playground
 
@@ -258,7 +256,7 @@ git clone https://github.com/eva-design/eva
 ```
 - Ensure you have the following structure of repos:
 ```
-- /Users/KittenDeveloper/
+- /Users/UIKittenDeveloper/
   - react-native-ui-kitten
   - eva
 ```
@@ -290,7 +288,7 @@ git clone https://github.com/eva-design/eva
 ```
 - Ensure you have the following structure of repos:
 ```
-- /Users/KittenDeveloper/
+- /Users/UIKittenDeveloper/
   - react-native-ui-kitten
   - eva
   - kittenTricks

diff --git a/docs/3.1.4/3rdpartylicenses.txt b/docs/3.1.4/3rdpartylicenses.txt
diff --git a/docs/3.1.4/Roboto-Black.2a82f89b0a35ee7f9d45.eot b/docs/3.1.4/Roboto-Black.2a82f89b0a35ee7f9d45.eot
diff --git a/docs/3.1.4/Roboto-Black.2b8d6922c2c9957356bc.woff2 b/docs/3.1.4/Roboto-Black.2b8d6922c2c9957356bc.woff2
diff --git a/docs/3.1.4/Roboto-Black.44236ad507eddcbfd986.ttf b/docs/3.1.4/Roboto-Black.44236ad507eddcbfd986.ttf
diff --git a/docs/3.1.4/Roboto-Black.4c3b6229efe63a13dbb4.woff b/docs/3.1.4/Roboto-Black.4c3b6229efe63a13dbb4.woff
diff --git a/docs/3.1.4/Roboto-Black.ab04c7611d94b690aee3.svg b/docs/3.1.4/Roboto-Black.ab04c7611d94b690aee3.svg
diff --git a/docs/3.1.4/Roboto-BlackItalic.1f37c7545ae9f63d2279.svg b/docs/3.1.4/Roboto-BlackItalic.1f37c7545ae9f63d2279.svg
diff --git a/docs/3.1.4/Roboto-BlackItalic.38d14dd4ff163c34e45b.woff2 b/docs/3.1.4/Roboto-BlackItalic.38d14dd4ff163c34e45b.woff2
diff --git a/docs/3.1.4/Roboto-BlackItalic.3a99796b2d8592471fcf.woff b/docs/3.1.4/Roboto-BlackItalic.3a99796b2d8592471fcf.woff
diff --git a/docs/3.1.4/Roboto-BlackItalic.4b7407c6740b8294d97a.eot b/docs/3.1.4/Roboto-BlackItalic.4b7407c6740b8294d97a.eot
diff --git a/docs/3.1.4/Roboto-BlackItalic.ad0f284c7113fd0aaf39.ttf b/docs/3.1.4/Roboto-BlackItalic.ad0f284c7113fd0aaf39.ttf
diff --git a/docs/3.1.4/Roboto-Bold.56a76a220d9c9765946d.ttf b/docs/3.1.4/Roboto-Bold.56a76a220d9c9765946d.ttf
diff --git a/docs/3.1.4/Roboto-Bold.ab96cca26751239828b8.woff2 b/docs/3.1.4/Roboto-Bold.ab96cca26751239828b8.woff2
diff --git a/docs/3.1.4/Roboto-Bold.ad140ff02a7091257e2b.woff b/docs/3.1.4/Roboto-Bold.ad140ff02a7091257e2b.woff
diff --git a/docs/3.1.4/Roboto-Bold.c7f4667b59b9bc95130e.svg b/docs/3.1.4/Roboto-Bold.c7f4667b59b9bc95130e.svg
diff --git a/docs/3.1.4/Roboto-Bold.c8bcb1cb78f9e45e2bcb.eot b/docs/3.1.4/Roboto-Bold.c8bcb1cb78f9e45e2bcb.eot
diff --git a/docs/3.1.4/Roboto-BoldItalic.355e388740673054493c.woff2 b/docs/3.1.4/Roboto-BoldItalic.355e388740673054493c.woff2
diff --git a/docs/3.1.4/Roboto-BoldItalic.4b2cc52b05e2a960c4f1.eot b/docs/3.1.4/Roboto-BoldItalic.4b2cc52b05e2a960c4f1.eot
diff --git a/docs/3.1.4/Roboto-BoldItalic.a7dce23c0dd99a4afa5c.woff b/docs/3.1.4/Roboto-BoldItalic.a7dce23c0dd99a4afa5c.woff
diff --git a/docs/3.1.4/Roboto-BoldItalic.c2e0f75da3677f645034.svg b/docs/3.1.4/Roboto-BoldItalic.c2e0f75da3677f645034.svg
diff --git a/docs/3.1.4/Roboto-BoldItalic.d23d5bdadc495f12ef69.ttf b/docs/3.1.4/Roboto-BoldItalic.d23d5bdadc495f12ef69.ttf
diff --git a/docs/3.1.4/Roboto-Light.054fa50baa6598a7bf0c.svg b/docs/3.1.4/Roboto-Light.054fa50baa6598a7bf0c.svg
diff --git a/docs/3.1.4/Roboto-Light.183079184d96a491f16e.eot b/docs/3.1.4/Roboto-Light.183079184d96a491f16e.eot
diff --git a/docs/3.1.4/Roboto-Light.37fbbbad5577a95bdf05.woff b/docs/3.1.4/Roboto-Light.37fbbbad5577a95bdf05.woff
diff --git a/docs/3.1.4/Roboto-Light.8e0860f3581b197e9fa4.woff2 b/docs/3.1.4/Roboto-Light.8e0860f3581b197e9fa4.woff2
diff --git a/docs/3.1.4/Roboto-Light.a2b8c641546c0e5a95e2.ttf b/docs/3.1.4/Roboto-Light.a2b8c641546c0e5a95e2.ttf
diff --git a/docs/3.1.4/Roboto-LightItalic.056caeabe95749fe2b97.ttf b/docs/3.1.4/Roboto-LightItalic.056caeabe95749fe2b97.ttf
diff --git a/docs/3.1.4/Roboto-LightItalic.1a9e39e536aed26b863b.svg b/docs/3.1.4/Roboto-LightItalic.1a9e39e536aed26b863b.svg
diff --git a/docs/3.1.4/Roboto-LightItalic.879d940bccbb25f6096e.woff2 b/docs/3.1.4/Roboto-LightItalic.879d940bccbb25f6096e.woff2
diff --git a/docs/3.1.4/Roboto-LightItalic.c7b4e746cf8ecbf412fc.woff b/docs/3.1.4/Roboto-LightItalic.c7b4e746cf8ecbf412fc.woff
diff --git a/docs/3.1.4/Roboto-LightItalic.cdd1c486770034a6122e.eot b/docs/3.1.4/Roboto-LightItalic.cdd1c486770034a6122e.eot
diff --git a/docs/3.1.4/Roboto-Medium.2741a14e49524efa6059.woff2 b/docs/3.1.4/Roboto-Medium.2741a14e49524efa6059.woff2
diff --git a/docs/3.1.4/Roboto-Medium.2b4f394ce87ea4e7a68b.svg b/docs/3.1.4/Roboto-Medium.2b4f394ce87ea4e7a68b.svg
diff --git a/docs/3.1.4/Roboto-Medium.303ded6436dcf7ea7515.woff b/docs/3.1.4/Roboto-Medium.303ded6436dcf7ea7515.woff
diff --git a/docs/3.1.4/Roboto-Medium.76cad5ba6b8a38a77fe0.eot b/docs/3.1.4/Roboto-Medium.76cad5ba6b8a38a77fe0.eot
diff --git a/docs/3.1.4/Roboto-Medium.c54f2a3ee42d2a58d82f.ttf b/docs/3.1.4/Roboto-Medium.c54f2a3ee42d2a58d82f.ttf
diff --git a/docs/3.1.4/Roboto-MediumItalic.7a49ce79b6089d4d37bf.eot b/docs/3.1.4/Roboto-MediumItalic.7a49ce79b6089d4d37bf.eot
diff --git a/docs/3.1.4/Roboto-MediumItalic.da059a7386fea889c55c.woff b/docs/3.1.4/Roboto-MediumItalic.da059a7386fea889c55c.woff
diff --git a/docs/3.1.4/Roboto-MediumItalic.eb65fb18d4446e4ac27d.svg b/docs/3.1.4/Roboto-MediumItalic.eb65fb18d4446e4ac27d.svg
diff --git a/docs/3.1.4/Roboto-MediumItalic.f10d1f42838680a70ac2.woff2 b/docs/3.1.4/Roboto-MediumItalic.f10d1f42838680a70ac2.woff2
diff --git a/docs/3.1.4/Roboto-MediumItalic.fa183350bf6b814ae552.ttf b/docs/3.1.4/Roboto-MediumItalic.fa183350bf6b814ae552.ttf
diff --git a/docs/3.1.4/Roboto-Regular.081b11ebaca8ad30fd09.woff b/docs/3.1.4/Roboto-Regular.081b11ebaca8ad30fd09.woff
diff --git a/docs/3.1.4/Roboto-Regular.6a561d68369fd1fb9768.eot b/docs/3.1.4/Roboto-Regular.6a561d68369fd1fb9768.eot
diff --git a/docs/3.1.4/Roboto-Regular.766c8926f6d9061fef24.svg b/docs/3.1.4/Roboto-Regular.766c8926f6d9061fef24.svg
diff --git a/docs/3.1.4/Roboto-Regular.99b14f0da0591e0d7167.ttf b/docs/3.1.4/Roboto-Regular.99b14f0da0591e0d7167.ttf
diff --git a/docs/3.1.4/Roboto-Regular.b2a6341ae7440130ec4b.woff2 b/docs/3.1.4/Roboto-Regular.b2a6341ae7440130ec4b.woff2
diff --git a/docs/3.1.4/Roboto-RegularItalic.527502d7927a41ca0b6a.svg b/docs/3.1.4/Roboto-RegularItalic.527502d7927a41ca0b6a.svg
diff --git a/docs/3.1.4/Roboto-RegularItalic.8add1ba317c27e39b778.woff b/docs/3.1.4/Roboto-RegularItalic.8add1ba317c27e39b778.woff
diff --git a/docs/3.1.4/Roboto-RegularItalic.90dbf902b8d0592e1beb.ttf b/docs/3.1.4/Roboto-RegularItalic.90dbf902b8d0592e1beb.ttf
diff --git a/docs/3.1.4/Roboto-RegularItalic.df8e3a9b9aed94341797.woff2 b/docs/3.1.4/Roboto-RegularItalic.df8e3a9b9aed94341797.woff2
diff --git a/docs/3.1.4/Roboto-RegularItalic.f3660f493ea5e5206484.eot b/docs/3.1.4/Roboto-RegularItalic.f3660f493ea5e5206484.eot
diff --git a/docs/3.1.4/Roboto-Thin.790ebf41d0214f5eda4e.woff2 b/docs/3.1.4/Roboto-Thin.790ebf41d0214f5eda4e.woff2
diff --git a/docs/3.1.4/Roboto-Thin.90d3804f0231704c15cc.woff b/docs/3.1.4/Roboto-Thin.90d3804f0231704c15cc.woff
diff --git a/docs/3.1.4/Roboto-Thin.ba422f71e799f3d29cbf.svg b/docs/3.1.4/Roboto-Thin.ba422f71e799f3d29cbf.svg
diff --git a/docs/3.1.4/Roboto-Thin.c25fd8d00fd9f570545d.eot b/docs/3.1.4/Roboto-Thin.c25fd8d00fd9f570545d.eot
diff --git a/docs/3.1.4/Roboto-Thin.cc85ce37b4256966e6f3.ttf b/docs/3.1.4/Roboto-Thin.cc85ce37b4256966e6f3.ttf
diff --git a/docs/3.1.4/Roboto-ThinItalic.11b5cc9584f2c007a229.ttf b/docs/3.1.4/Roboto-ThinItalic.11b5cc9584f2c007a229.ttf
diff --git a/docs/3.1.4/Roboto-ThinItalic.21e9a2e5ed0b0d8d1bb7.svg b/docs/3.1.4/Roboto-ThinItalic.21e9a2e5ed0b0d8d1bb7.svg
diff --git a/docs/3.1.4/Roboto-ThinItalic.588293290e86dad97fcf.woff b/docs/3.1.4/Roboto-ThinItalic.588293290e86dad97fcf.woff
diff --git a/docs/3.1.4/Roboto-ThinItalic.64ca718f48db91b27e8c.eot b/docs/3.1.4/Roboto-ThinItalic.64ca718f48db91b27e8c.eot
diff --git a/docs/3.1.4/Roboto-ThinItalic.8a2c1a5de09de8bb2c45.woff2 b/docs/3.1.4/Roboto-ThinItalic.8a2c1a5de09de8bb2c45.woff2
diff --git a/docs/3.1.4/androidPhoneImage.72e0a7b4d8201abf5b9b.png b/docs/3.1.4/androidPhoneImage.72e0a7b4d8201abf5b9b.png
diff --git a/docs/3.1.4/assets/articles/customization.md b/docs/3.1.4/assets/articles/customization.md
@@ -0,0 +1,222 @@
+### Overview
+Customization of `react-native-ui-kitten` is really easy and very extensible. 
+It allows you to build beautiful and flexible component styles in a simple and elegant way.
+
+### rkType
+
+Most of the components in this framework contain *rkType* property.
+For those who's familiar with web, you can think of it as an HTML *class* property.
+Fundamentally, the idea is to separate styles definition from jsx templates.
+Our components already have a set of predefined rkTypes. 
+Moreover, you can configure *rkType*s somewhere in your application and then you're able to reuse that style in your components by just passing it as an input property.
+In addition it's always possible to override types for some specific component.
+
+For example, consider this code: 
+
+```
+import {RkButton} from 'react-native-ui-kitten';
+
+//... 
+
+<RkButton rkType='outline small'>
+  Say Hello
+</RkButton>
+
+```
+
+In this case, `RkButton` will have two styles: *outline* (style that 
+draws a rounded border for a button) and *small* (the one that reduces button size).
+
+You're able to create your custom *rkType*s for specific components.
+Here is the example of creating *rkType* for rkButton:
+
+```jsx
+import {RkButton, RkTheme} from 'react-native-ui-kitten';
+
+let accent = '#ed1c4d';
+
+RkTheme.setType('RkButton', 'accent', {
+  container: {
+    backgroundColor: accent
+  }
+  content: {
+    color: 'white'
+  }
+});
+
+//...
+
+<RkButton rkType='accent'>
+  Click me.
+</RkButton>
+```
+
+### Default components, style aliases
+
+All Rk components consist of internal components. For example RkButton it is `TouchableOpacity` with some content. In order to you can control styling of each internal component all Rx components provide special style mapping elements.
+In case of RkButton they are 'container' and 'content'. And you can style them in an explicit way you can see above.
+
+But every Rk component also has a default internal component to which all non-explicit styles will be applied implicitly. Also there are can be defined aliases for some style property.
+In case of RkButton there is 'container' is default and there is exists alias 'color' for 'content'. With this in mind we can re-write code above:
+
+```
+...
+
+RkTheme.setType('RkButton', 'accent', {
+  backgroundColor: accent
+  color: 'white'
+});
+
+...
+```
+
+### Platform-dependent styles
+
+In some cases, it may be necessary to write different styles depending on current platform. It's possible to define a platform dependent value. Let's create `rkType` for `RkButton` which on *iOS* will have a blue background color and green on *Android*.
+
+```jsx
+import {RkTheme} from 'react-native-ui-kitten';
+
+//...
+
+RkTheme.setType('RkButton','different',{
+  backgroundColor: {
+    ios: 'blue',
+    android: 'green'
+  }
+});
+
+//... or using internal control components:
+
+RkTheme.setType('RkButton','different',{
+  container: {
+    backgroundColor: {
+      ios: 'blue',
+      android: 'green'
+    }
+  }
+});
+
+```
+
+### Default values
+Sometimes it is very useful to set default style for all components in a whole application without need to set explicitly `rkType`
+for each component. All *rk-components* have a type which always applied. The name of this type is set in `RkComponent.defaultType` variable.
+All standard *rk-components* has defaultType `basic`. In order to change the style for all components - just override this type.
+
+Let's change color and size for all `RkText` components in the app:
+
+```jsx
+  RkTheme.setType('RkText', 'basic', {
+    fontSize: 12,
+    color: 'midnightblue'
+  });
+```
+
+### Themes
+
+All base *rkTypes* depends on theme of an application. *Theme* contains base values (colors, fontSizes etc) for all *rk-components*.
+You can easily override values in theme or even define your own theme using `RkTheme`.
+But user-defined *rkType*s should also be able to respond theme changes.
+For this purpose property functions can be used instead of values.
+Let's create `rkType` for `RkText` which will depend on some value from the theme.
+
+```jsx
+RkTheme.setType('RkText','primaryBackground',{
+  backgroundColor: theme => theme.colors.primary
+});
+```
+
+Variable `theme` here is an example of the current theme. So, in case the theme has been switched using `RkTheme.setTheme` function, the `rkType`
+ created above will also be changed and all components using this type will be updated as well.
+
+
+Sometimes there is a necessity to use their values for regular components. In this case, you need to use `RkStyleSheet`.
+
+### Inherit rkTypes
+
+You're able to create your custom *rkType*s that based on others *rkType*s.
+Fourth parameter of method *RkTheme.setType()* is array or string with parents *rkType*s.<br/>
+Array format: *['parentType1', 'parentType2']*.<br/>
+String format: *'parentType1 parentType2'*.<br/>
+The properties of *parentType2* override the properties of *parentType1*. Third parameter of method *RkTheme.setType()* using after parents types.
+
+
+Here is the example of creating *rkType* from parents types for rkText:
+
+```
+RkTheme.setType('RkText', 'inherited', {
+    fontSize: 40,
+    text: {
+      fontFamily: robotoLight,
+      lineHeight: {
+        ios: 41,
+        android: 43
+      },
+    }
+  }, "basic danger");
+```
+
+Where *basic* rkType:
+```
+
+basic: {
+    fontSize: theme.fonts.sizes.base,
+    color: theme.colors.text.base,
+    backgroundColor: 'transparent'
+}
+```
+
+And *danger* rkType:
+```
+danger: {
+    color: theme.colors.danger
+}
+```
+
+As result, we have *inherited* rkType:
+```
+inherited: {
+    fontSize: 40,
+    color: theme.colors.danger,
+    backgroundColor: 'transparent'
+    text: {
+      fontFamily: robotoLight,
+      lineHeight: {
+        ios: 45,
+        android: 43
+      },
+    }
+}
+```
+
+### Using extractNonStyleValue() method of RkComponent
+Style before method call:
+
+```
+style: {
+ flex: 1,
+ fontSize: 15,
+ alignSelf: 'center',
+ placeholderTextColor: '#0000008e',
+ marginVertical: 4,
+ marginLeft: 16
+}
+```
+Method call:
+```
+//...
+let placeholderColor = this.extractNonStyleValue(style, 'placeholderTextColor')
+//...
+```
+Style and placeholderColor after method call:
+```
+placeholderColor: '#0000008e'
+style: {
+ flex: 1,
+ fontSize: 15,
+ alignSelf: 'center',
+ marginVertical: 4,
+ marginLeft: 16
+}
+```