Initial release (#185)

* Initial release

* Readme update

samples/react-themes/.editorconfig

@@ -0,0 +1,25 @@
+# EditorConfig helps developers define and maintain consistent
+# coding styles between different editors and IDEs
+# editorconfig.org
+
+root = true
+
+
+[*]
+
+# change these settings to your own preference
+indent_style = space
+indent_size = 2
+
+# we recommend you to keep these unchanged
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[{package,bower}.json]
+indent_style = space
+indent_size = 2

samples/react-themes/.gitattributes

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

samples/react-themes/.gitignore

@@ -0,0 +1,32 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+
+# Dependency directories
+node_modules
+
+# Build generated files
+dist
+lib
+solution
+temp
+*.sppkg
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# OSX
+.DS_Store
+
+# Visual Studio files
+.ntvs_analysis.dat
+.vs
+bin
+obj
+
+# Resx Generated Code
+*.resx.ts
+
+# Styles Generated Code
+*.scss.ts

samples/react-themes/.npmignore

@@ -0,0 +1,14 @@
+# Folders
+.vscode
+coverage
+node_modules
+sharepoint
+src
+temp
+
+# Files
+*.csproj
+.git*
+.yo-rc.json
+gulpfile.js
+tsconfig.json

samples/react-themes/.yo-rc.json

@@ -0,0 +1,8 @@
+{
+  "@microsoft/generator-sharepoint": {
+    "libraryName": "react-themes",
+    "framework": "react",
+    "version": "1.0.2",
+    "libraryId": "46489282-ffa9-4f00-939c-6fff916b182f"
+  }
+}

samples/react-themes/README.md

@@ -0,0 +1,46 @@
+# SharePoint Themes Client Side Web Part
+
+## Summary
+This web part illustrates how to use SharePoint Theme variables in custom web parts.
+
+![SharePoint Themes Client Side Web Part](./assets/themes.png)
+
+## Used SharePoint Framework Version 
+![drop](https://img.shields.io/badge/drop-ga-green.svg)
+
+## Applies to
+
+* [SharePoint Framework](http://dev.office.com/sharepoint/docs/spfx/sharepoint-framework-overview)
+
+Solution|Author(s)
+--------|---------
+react-themes | Alex Terentiev ([Sharepointalist Inc.](http://www.sharepointalist.com), [AJIXuMuK](https://github.com/AJIXuMuK)), Artur Kukharevich ([akukharevich](https://github.com/akukharevich))
+
+## Version history
+
+Version|Date|Comments
+-------|----|--------
+1.0|April 27, 2017|Initial release
+
+## Disclaimer
+**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**
+
+## Features
+This project contains Client-Side Web Part built on the SharePoint Framework illustrating how to use SharePoint themes variables to style custom web parts
+
+## Building the code
+
+```bash
+git clone the repo
+npm i
+npm i -g gulp
+gulp
+```
+
+This package produces the following:
+
+* lib/* - intermediate-stage commonjs build artifacts
+* dist/* - the bundled script, along with other resources
+* deploy/* - all resources which should be uploaded to a CDN.
+
+<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-themes" />

samples/react-themes/config/config.json

@@ -0,0 +1,13 @@
+{
+  "entries": [
+    {
+      "entry": "./lib/webparts/themes/ThemesWebPart.js",
+      "manifest": "./src/webparts/themes/ThemesWebPart.manifest.json",
+      "outputPath": "./dist/themes.bundle.js"
+    }
+  ],
+  "externals": {},
+  "localizedResources": {
+    "themesStrings": "webparts/themes/loc/{locale}.js"
+  }
+}

samples/react-themes/config/copy-assets.json

@@ -0,0 +1,3 @@
+{
+  "deployCdnPath": "temp/deploy"
+}

samples/react-themes/config/deploy-azure-storage.json

@@ -0,0 +1,6 @@
+{
+  "workingDir": "./temp/deploy/",
+  "account": "<!-- STORAGE ACCOUNT NAME -->",
+  "container": "react-themes",
+  "accessKey": "<!-- ACCESS KEY -->"
+}

samples/react-themes/config/package-solution.json

@@ -0,0 +1,10 @@
+{
+  "solution": {
+    "name": "react-themes-client-side-solution",
+    "id": "46489282-ffa9-4f00-939c-6fff916b182f",
+    "version": "1.0.0.0"
+  },
+  "paths": {
+    "zippedPackage": "solution/react-themes.sppkg"
+  }
+}

samples/react-themes/config/serve.json

@@ -0,0 +1,9 @@
+{
+  "port": 4321,
+  "initialPage": "https://localhost:5432/workbench",
+  "https": true,
+  "api": {
+    "port": 5432,
+    "entryPath": "node_modules/@microsoft/sp-webpart-workbench/lib/api/"
+  }
+}

samples/react-themes/config/tslint.json

@@ -0,0 +1,45 @@
+{
+  // Display errors as warnings
+  "displayAsWarning": true,
+  // The TSLint task may have been configured with several custom lint rules
+  // before this config file is read (for example lint rules from the tslint-microsoft-contrib
+  // project). If true, this flag will deactivate any of these rules.
+  "removeExistingRules": true,
+  // When true, the TSLint task is configured with some default TSLint "rules.":
+  "useDefaultConfigAsBase": false,
+  // Since removeExistingRules=true and useDefaultConfigAsBase=false, there will be no lint rules
+  // which are active, other than the list of rules below.
+  "lintConfig": {
+    // Opt-in to Lint rules which help to eliminate bugs in JavaScript
+    "rules": {
+      "class-name": false,
+      "export-name": false,
+      "forin": false,
+      "label-position": false,
+      "member-access": true,
+      "no-arg": false,
+      "no-console": false,
+      "no-construct": false,
+      "no-duplicate-case": true,
+      "no-duplicate-variable": true,
+      "no-eval": false,
+      "no-function-expression": true,
+      "no-internal-module": true,
+      "no-shadowed-variable": true,
+      "no-switch-case-fall-through": true,
+      "no-unnecessary-semicolons": true,
+      "no-unused-expression": true,
+      "no-unused-imports": true,
+      "no-use-before-declare": true,
+      "no-with-statement": true,
+      "semicolon": true,
+      "trailing-comma": false,
+      "typedef": false,
+      "typedef-whitespace": false,
+      "use-named-parameter": true,
+      "valid-typeof": true,
+      "variable-name": false,
+      "whitespace": false
+    }
+  }
+}

samples/react-themes/config/write-manifests.json

@@ -0,0 +1,3 @@
+{
+  "cdnBasePath": "<!-- PATH TO CDN -->"
+}

samples/react-themes/gulpfile.js

@@ -0,0 +1,6 @@
+'use strict';
+
+const gulp = require('gulp');
+const build = require('@microsoft/sp-build-web');
+
+build.initialize(gulp);

samples/react-themes/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "react-themes",
+  "version": "0.0.1",
+  "private": true,
+  "engines": {
+    "node": ">=0.10.0"
+  },
+  "dependencies": {
+    "@microsoft/sp-client-base": "~1.0.0",
+    "@microsoft/sp-core-library": "~1.0.0",
+    "@microsoft/sp-webpart-base": "~1.0.0",
+    "@types/react": "0.14.46",
+    "@types/react-addons-shallow-compare": "0.14.17",
+    "@types/react-addons-test-utils": "0.14.15",
+    "@types/react-addons-update": "0.14.14",
+    "@types/react-dom": "0.14.18",
+    "@types/webpack-env": ">=1.12.1 <1.14.0",
+    "react": "15.4.2",
+    "react-dom": "15.4.2"
+  },
+  "devDependencies": {
+    "@microsoft/sp-build-web": "~1.0.1",
+    "@microsoft/sp-module-interfaces": "~1.0.0",
+    "@microsoft/sp-webpart-workbench": "~1.0.0",
+    "gulp": "~3.9.1",
+    "@types/chai": ">=3.4.34 <3.6.0",
+    "@types/mocha": ">=2.2.33 <2.6.0"
+  },
+  "scripts": {
+    "build": "gulp bundle",
+    "clean": "gulp clean",
+    "test": "gulp test"
+  }
+}

samples/react-themes/src/webparts/themes/IThemesWebPartProps.ts

@@ -0,0 +1,3 @@
+export interface IThemesWebPartProps {
+  description: string;
+}

samples/react-themes/src/webparts/themes/ThemesWebPart.manifest.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "../../../node_modules/@microsoft/sp-module-interfaces/lib/manifestSchemas/jsonSchemas/clientSideComponentManifestSchema.json",
+
+  "id": "bb2ff581-2b46-4bfd-bfd0-ac1607c96ddb",
+  "alias": "ThemesWebPart",
+  "componentType": "WebPart",
+  "version": "0.0.1",
+  "manifestVersion": 2,
+
+  "preconfiguredEntries": [{
+    "groupId": "bb2ff581-2b46-4bfd-bfd0-ac1607c96ddb",
+    "group": { "default": "Under Development" },
+    "title": { "default": "Themes" },
+    "description": { "default": "Example of using SharePoint Themes" },
+    "officeFabricIconFontName": "Page",
+    "properties": {
+      "description": "Themes"
+    }
+  }]
+}

samples/react-themes/src/webparts/themes/ThemesWebPart.ts

@@ -0,0 +1,53 @@
+import * as React from 'react';
+import * as ReactDom from 'react-dom';
+import { Version } from '@microsoft/sp-core-library';
+import {
+  BaseClientSideWebPart,
+  IPropertyPaneConfiguration,
+  PropertyPaneTextField
+} from '@microsoft/sp-webpart-base';
+
+import * as strings from 'themesStrings';
+import Themes from './components/Themes';
+import { IThemesProps } from './components/IThemesProps';
+import { IThemesWebPartProps } from './IThemesWebPartProps';
+
+export default class ThemesWebPart extends BaseClientSideWebPart<IThemesWebPartProps> {
+
+  public render(): void {
+    const element: React.ReactElement<IThemesProps > = React.createElement(
+      Themes,
+      {
+        description: this.properties.description
+      }
+    );
+
+    ReactDom.render(element, this.domElement);
+  }
+
+  protected get dataVersion(): Version {
+    return Version.parse('1.0');
+  }
+
+  protected getPropertyPaneConfiguration(): IPropertyPaneConfiguration {
+    return {
+      pages: [
+        {
+          header: {
+            description: strings.PropertyPaneDescription
+          },
+          groups: [
+            {
+              groupName: strings.BasicGroupName,
+              groupFields: [
+                PropertyPaneTextField('description', {
+                  label: strings.DescriptionFieldLabel
+                })
+              ]
+            }
+          ]
+        }
+      ]
+    };
+  }
+}

samples/react-themes/src/webparts/themes/components/IThemesProps.ts

@@ -0,0 +1,3 @@
+export interface IThemesProps {
+  description: string;
+}

samples/react-themes/src/webparts/themes/components/Themes.module.scss

@@ -0,0 +1,8 @@
+$primary: "[theme:primaryBackground, default: #0273eb]";
+$primaryText: "[theme:primaryText, default: #333333]";
+
+.main {
+  background: $primary;
+  color: $primaryText;
+  font-size: 14px;
+}

samples/react-themes/src/webparts/themes/components/Themes.tsx

@@ -0,0 +1,74 @@
+import * as React from 'react';
+import styles from './Themes.module.scss';
+import { IThemesProps } from './IThemesProps';
+import { escape } from '@microsoft/sp-lodash-subset';
+import { DetailsList, DetailsListLayoutMode } from 'office-ui-fabric-react';
+
+interface Window {
+  __themeState__: any;
+}
+
+declare var window: Window;
+
+export default class Themes extends React.Component<IThemesProps, void> {
+
+  public render(): React.ReactElement<IThemesProps> {
+    let _columns = [
+      {
+        key: 'column1',
+        name: 'Name',
+        fieldName: 'name',
+        minWidth: 100,
+        maxWidth: 200,
+        isResizable: true
+      },
+      {
+        key: 'column2',
+        name: 'Value',
+        fieldName: 'value',
+        minWidth: 100,
+        maxWidth: 400,
+        isResizable: true
+      },
+    ];
+
+    const items = this.getThemeVariablesItems();
+
+    return (
+      <div className={styles.main}>
+        <p>{'This web part shows usage of SharePoint Themes.'}</p>
+        <p>{'Background color is set to "primaryBackgroud" and font color is set to "primaryColor"'}</p>
+        <p>{'Full list of available theme variables is available in windows.__themeState__.theme property and listed below'}</p>
+        <p>{'You can use theme variables in your .scss files like $yourVariable:"[theme:primaryBackground, default:#0273eb]"'}</p>
+        <p>{'Change the theme (Site Settings -> Change the look) and see what\'s happenning'}</p>
+        <DetailsList
+          items={items}
+          columns={_columns}
+          layoutMode={DetailsListLayoutMode.justified}
+          viewport={{
+            width: 750,
+            height: 500
+          }}
+        />
+      </div>
+    );
+  }
+
+  private getThemeVariablesItems(): Array<any> {
+    const variables: any = window.__themeState__.theme;
+    const items = [];
+
+    for (let varName in variables) {
+      if (!variables.hasOwnProperty(varName))
+        continue;
+
+      items.push({
+        key: varName,
+        name: varName,
+        value: variables[varName]
+      });
+    }
+
+    return items;
+  }
+}

samples/react-themes/src/webparts/themes/loc/en-us.js

@@ -0,0 +1,7 @@
+define([], function() {
+  return {
+    "PropertyPaneDescription": "Description",
+    "BasicGroupName": "Group Name",
+    "DescriptionFieldLabel": "Description Field"
+  }
+});

samples/react-themes/src/webparts/themes/loc/mystrings.d.ts

@@ -0,0 +1,10 @@
+declare interface IThemesStrings {
+  PropertyPaneDescription: string;
+  BasicGroupName: string;
+  DescriptionFieldLabel: string;
+}
+
+declare module 'themesStrings' {
+  const strings: IThemesStrings;
+  export = strings;
+}

samples/react-themes/src/webparts/themes/tests/Themes.test.ts

@@ -0,0 +1,9 @@
+/// <reference types="mocha" />
+
+import { assert } from 'chai';
+
+describe('ThemesWebPart', () => {
+  it('should do something', () => {
+    assert.ok(true);
+  });
+});

samples/react-themes/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "forceConsistentCasingInFileNames": true,
+    "module": "commonjs",
+    "jsx": "react",
+    "declaration": true,
+    "sourceMap": true,
+    "types": [
+      "es6-promise",
+      "es6-collections",
+      "webpack-env"
+    ]
+  }
+}

samples/react-themes/typings/@ms/odsp.d.ts

@@ -0,0 +1,8 @@
+// Type definitions for Microsoft ODSP projects
+// Project: ODSP
+
+/* Global definition for UNIT_TEST builds
+   Code that is wrapped inside an if(UNIT_TEST) {...}
+   block will not be included in the final bundle when the
+   --ship flag is specified */
+declare const UNIT_TEST: boolean;

samples/react-themes/typings/tsd.d.ts

@@ -0,0 +1 @@
+/// <reference path="@ms/odsp.d.ts" />