initial version

.gitignore

@@ -1,12 +1,54 @@
-target/
-pom.xml.tag
-pom.xml.releaseBackup
-pom.xml.versionsBackup
-pom.xml.next
-release.properties
-dependency-reduced-pom.xml
-buildNumber.properties
-.mvn/timing.properties
-
-# Avoid ignoring Maven wrapper jar file (.jar files are usually ignored)
-!/.mvn/wrapper/maven-wrapper.jar
+**/target/
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+**/*.ear
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+**/*.class
+
+# Package Files #
+**/src/main/webapp/**/*.jar
+**/*.war
+
+# gwt caches and compiled units #
+src/main/webapp/gwt_bree/
+**/gwt-unitCache/
+
+# boilerplate generated classes #
+**/.apt_generated/
+
+
+# more caches and things from deploy #
+**/src/main/webapp/WEB-INF/deploy/
+**/src/main/webapp/WEB-INF/classes/
+
+#compilation logs
+**/.gwt/
+
+#gwt junit compilation files
+**/www-test/
+
+**/dependency-reduced-pom.xml
+**/buildNumber.properties
+**/.mvn/timing.properties
+
+# Eclipse
+**/.classpath
+**/.project
+**/.settings/
+
+# Intellij
+**/.idea/
+**/*.iml
+**/*.iws
+
+.idea/**/*.*
+**/*.iml
+**/*.iws
+**/*.log
+
+**/bin/

.travis.yml

@@ -0,0 +1,31 @@
+sudo: false
+language: java
+jdk: openjdk8
+branches:
+  only:
+  - master
+cache:
+  directories:
+  - "$HOME/.m2"
+install: true
+notifications:
+  webhooks:
+    urls:
+    - https://webhooks.gitter.im/e/a434c0997c2c1629fef2
+    on_success: change
+    on_failure: always
+    on_start: never
+after_success:
+- openssl aes-256-cbc -pass pass:$ENCRYPTION_PASSWORD -in $GPG_DIR/pubring.gpg.enc
+  -out $GPG_DIR/pubring.gpg -d
+- openssl aes-256-cbc -pass pass:$ENCRYPTION_PASSWORD -in $GPG_DIR/secring.gpg.enc
+  -out $GPG_DIR/secring.gpg -d
+- "$GPG_DIR/publish.sh"
+env:
+  global:
+  - GPG_DIR="`pwd`/deploy"
+  - secure: d4BCslC/P4RXetE//5n/9J3o3jOV0qNmCGN4n4FOKQmqFPigtDKiDLKFHHGBzOvCN+5KwomJYszBGd5wIfmEx4gMTq+csf159w4GOW+2EoVTEBdj5c/HD6amrrxt+t5Lcc7anQ27yZ8FINua1mnx7+WZ+QUn/RQwskH7aXOc3WOjRvWp5ynt4aYLZoHWYYamOD+mkOdYw4TPQjvXgJl0shqGeOiWJ9pnz98OP0cOXWprG1+kvfOoLxgJBlJi5GsTEzSDbG5NVeTHVRjPEzDnFgdZMIjJ8fGqi9vUIP5JAvmzaLnav4ZtuM7J+RcJFtOA8+8JPN5QF3X2JiXdGy1TEEOTB8Pj+Q6pEA+LOFOLZZHIU9OeTdhTMXg7yftwsOyyZl6fht1AKyLq0s2m/b3KWs57jtDQJcQ1TOf7QOgMjSxRTRdnBcpcVrIaZX4YcCGG0LQgdNRUtafH0O7TY59B5fPWD2mkf99p3sKvRK7tpBJxaR97xCklRcfIBFFc1edag+uw6rd3yRcwFQV/q0S09xPXbT+sdZ2UnTTQ9yg5c0neHVVsAcY963LGYm+KAl8bE7DQuFS35ZQ28ky/E8EsNC+ingf8Ax6FpVz79CljNnSdITopmxfxQxYfpSzXBOrMmLOvIRq6JH7bPGsRS7bWJ5VLnBiVJ+3zTFjtTsTlj7M=
+  - secure: W2bsudmKkJ7u5KkSGJS55+ui2HZPAeIM23xp5XJfRFFtBmtLz2a9LJewDhDIusn5qfwLo585DvUhvmzULgYn+ENPo3/QIOKnKiv4efMCVXvi/6fnwc0ROXfgKCRptyVU3VDWR5bFiEYOmqKyn/MztPxWkL6uVI4sBkIF4M9rHNbdaUFfWzeyx8EXLEanBsjkzXr4UbXscx2QvtAyU52/S5+VBRBlHQzbFZ7jWz+kwsezzWZgvVI7mls4zi1POhFR7z2xh8uPTr6Jq7TTgzgUchGJM7TnVblkfY8nLh/dJqAf7TT5FJVArjBShTRxL9xVm7G1U/x4USUHihOv6iz2iNpKSaaEp4N+Ju0z5E1suku6FOJU7JpoIx5nRIdRWL90rJ09DhtqRkp+pAcsjGViPC7lU4e0Em5TPdJUDAiNasSw518sOlAuiV4ai5kbwCePve6EDOxvgnfSP+7NG2QS24FJ+oqQ0Btc9wC4O/7GDmrZ1I25gNs51wi7z3d1mn6Q4MEt3boyUWdWmaIiRg7mf9emk7HMD2xXbdzDzZm2hBdveewaiKgxfKRC/SN2QLli/wKQxLrVAFVMlrVm3ZSfer+qqgbSXzWyB0CM6cgTshLrV4AEU4kIz7GXDcxz0nza5zSWfuCUhcPK6LGwylEgmFhWt3Ondr7tXOimMh90eP4=
+  - secure: ePEojAoypza4k7xaFzNp8IKRXpxyoPUxRkHPnCMCn21CX2+LLLrCTJnpVmPQm+l/tjVm3Xi7HpbaIqyz+daiAByZ9Y5G34H75g1qiuT+stdCZOoQZygB+bTyDpkaOZLPS+N0bjIHFmhVdK8MnZSwuFMmPVybPfDZatcTo2oSKeZ2mUrLDWjKmQW2c9tQrYkTasf/NvHu01LjePBKxmJJSrcs2m01fq5v3b5BghGqtpDOviSgVURHdgzxiggN2huoSxkdbt6fC0gywAEthOUM7Vdg7OE32BctSLxu3oVtya9/+rjcQx1BHdGguy6OaMY93QXSFDvvL5E80bqU7Vn2JzmoWBh2cUwajYsEOGwB7sQFqkaoMcij08fLGP5Jlp3NgmcXR0RUraQ0xPXWenXk/jLGIxgqUMJGBHCKpJsjYrjCYAdvCXlnA5Vtoaae+O/kdG9mX7EAAsBuugiOO4pjb+P6BjCibc+p8pF0CLV7Wav0/BYPwVVWVt8x7qErFGo/0E/kriOnUq6RFQft1ARcx15BqHqQAlZgqu0kXT+gvVoy4nV1FV1ATBnEz3kpPfil9Rf3Ecfmyc4yGl41LLz7kmEpOeRfK8cGDcbcIjVzRDIspSSMW6+vEBid+jkAzQrdHtgghCPI7e8JLBA4HPsvxx042dhOMk3fbjfcWzGacwU=
+  - secure: aXA8Y54mS3jKlWpIQCjsmJ7X8KYlwQVgWgwZZfU2lrYyxdqGFNaMAUPGiXMcTdauI07Wg7DnBodNahSSP5/DihDCCTyufJ9nuQboCIiso06olvHPnk+PblSONNzAePM/tN2UlNwgGOn46pt8zdl8wYrsoTgvl161ILCnXV65xRHmbJ6vnO2cWw2ripG10GT8uvpRWeLgnlRFK7N1Z7GBFWIjxNkeV3Xbv4ac6s7bBuRQDpxewAT429cTg805pfDM1YUy1AxD5aphr6PjqUTdyQoI6yAjIVET9vNY5S3kP6+HXUGJB1D+hzSx+wHuk6Dwii6Kqpe0KThO9zteIYvQ8z/5CjHk5cGamHd/OYsWK2bCKBi4nsPTCKx+oTSUuN89u/6KQB4/JAzJkAvxVI78Xfe5y8r74d2m0HvGmdxp3DonWsyk/tNxgf6IvLSvkpIuHXkyC2LMAOJ8sBEs7ifD1GlzY6tShNxtzMPZ7Ut3i5+IMFxUndwZQDWhLLbDl2zTQObZVRZckvsANdtvSC1xeGEbZAeOaXTU7kn3207VK85V1AilWmJ6m43bUpZ+kFCv/4Z8Hyur4XCOF3aAQFqMbuGr6NOu/bo4MDZ+hEMtftljPiBa570NK3Yjh6IALuUV3W8najB1S+I6TjtAqBq2kRp0w/YLs/XyFpCE8RDiVWw=
+  - secure: c5L0dawd/gf60UKBD8Lr4vKDPWNt3FnWqSKAxnqk5/kSC3I+rfsJ3rBOJyWhB9at/f8cPQNvOpOkklQNwL4NXUAItJGLxPilf+R+Y21D62J/53O0gi/Cz2o/Q5Qtgc9mErJUfPMFwb3FGtkLvHK9CY/eokLhVYk+BBjLkYXiIVue66Rb4JHl3a3lCH57Z4fMQq570yj4vD+ENH4KeTXDDYU+gqNApleR/EytEGCh1ylGiy5OU5hzDe8EzyKfUkUbBkMIfFT9GQ6sNMhBew47n5pciFU4Xa/xfeHlv+T60BQ4NM+4TsVlWIOsUM+CsfIj79CKCKAWCheIJfyH7zPnL1d9rLyczzTa0UH69JyUSafMnKaDC3+ShVSMgNNPcIFay8JUlaXb9IxlZ80L16JqHYXaOAzDsGED041EJOHBPKCrEtrufPNolmtiIHJmc87xu+MXsFW2ki7/nqb7o1NIt8o4XIE3UG8MOL6WJxggiMRf0lge2Gmz8YceCyJpAWm8S9RwOcecki0WUuY5F60vW2CttTlARU4tgjzVIp8Heh58ujOCk93MJV+axGmwvBuqrLCCbkLA/qFEqEhBhaeMAnlDMi1zpOuwnvjYu/yv2t6N5lMp6LJKVEmScf38EZr5VSC5QTKYgu9CEPVnZldkOrGCv78OG8qJmcraeAObrOE=

README.md

@@ -1,2 +1,139 @@
 # domino-history
 A wrapper for browser history state API
+
+### Maven dependencies 
+
+```xml
+<dependency>
+  <groupId>org.dominokit</groupId>
+  <artifactId>domino-history-gwt</artifactId>
+  <version>1.0-rc.4-SNAPSHOT</version>
+</dependency>
+```
+
+### GWT inherits
+
+`<inherits name="org.dominokit.domino.gwt.history.History"/>`
+
+### Usage
+
+1- Create a `StateHistory` instance.
+
+`StateHistory history = new StateHistory()`
+
+2- Use `pushState(String token)` to change the window url without firing the events.
+3- Use `fireState(String token)` to change the window url and fire the events.
+4- Use `listen` with all it variants to start listing for url changes.
+5- Use `currentToken` to get the current active token in the browser window url.
+
+#### Sample
+
+```java
+public class App implements EntryPoint {
+
+    private StateHistory history = new StateHistory();
+
+    public void onModuleLoad() {
+
+        history.listen(TokenFilter.any(), state -> {
+            console.info(state.token().value());
+        });
+        history.listen(TokenFilter.startsWithPathFilter("path1"), state -> {
+            console.info(state.token().value());
+        });
+
+        HTMLButtonElement button1 = Js.uncheckedCast(document.createElement("button"));
+        button1.textContent ="button1";
+        button1.addEventListener("click", evt -> history.pushState("path1/path2"));
+
+        HTMLButtonElement button2 = Js.uncheckedCast(document.createElement("button"));
+        button2.textContent ="button2";
+        button2.addEventListener("click", evt -> history.fireState("path3/path4"));
+
+        HTMLButtonElement button3 = Js.uncheckedCast(document.createElement("button"));
+        button3.textContent ="button3";
+        button3.addEventListener("click", evt -> console.info("current token : "+history.currentToken().value()));
+
+        document.body.appendChild(button1);
+        document.body.appendChild(button2);
+        document.body.appendChild(button3);
+
+    }
+}
+```
+
+### The HistoryToken
+
+to get the current url token use `history().currentToken()`, every time this method is called it will return a new `HistoryToken` instance. once a token is obtained we can use it to manipulate the token instance, use one of the following methods to make changes to the token or ask for information from the token : 
+
+* `boolean startsWithPath(String path)` : returns true if the token starts with the path.
+* `boolean endsWithPath(String path)` : returns true if the paths part ends with the path.
+* `boolean containsPath(String path)` : returns true if the paths contains the path.
+* `List<String> paths()` : returns a list of all paths in the token.
+* `String path()` : returns the paths part of the token as a String.
+* `HistoryToken appendPath(String path)` : add a new path at the end the token path.
+* `HistoryToken replacePath(String path, String replacement)` : replace a specific path with a new one.
+* `HistoryToken replaceAllPaths(String newPath)` : replace all paths with a new path.
+* `HistoryToken removePath(String path)` : removes a specific path from the token.
+* `HistoryToken removeLastPath(String path)` : removes the last path part from the token.
+* `HistoryToken replaceLastPath(String replacement)` : replace the last path in token with a new path.
+* `HistoryToken clearPaths()` : remove all paths from the token.
+* `boolean fragmentsStartsWith(String fragment)` : return true if the part after the `#` starts with the fragment.
+* `boolean endsWithFragment(String fragment)` : return true if the part after the `#` ends with the fragment.
+* `boolean containsFragment(String fragment)` : return true if the part after the `#` contains the fragment.
+* `List<String> fragments()` : return a list of fragments.
+* `HistoryToken replaceLastFragment(String replacement)` : replace the last fragment with a new one.
+* `HistoryToken removeFragment(String fragment)` : remove a specific fragment.
+* `HistoryToken appendFragment(String fragment)` : append a fragment at the end of the fragments
+* `HistoryToken clearFragments()` : clear all fragments.
+* `HistoryToken replaceFragment(String fragment, String replacement)` : replace a fragment with a new one.
+* `HistoryToken replaceAllFragments(String newFragment)` : replace all fragments with a new one.
+* `String fragment()` : return the fragments as a String.
+* `Map<String, String> queryParameters()` : returns a map of all query parameters.
+* `boolean hasQueryParameter(String name)` : returns true if there is a query name with the specified name.
+* `String getQueryParameter(String name)` : return the value of the specified query parametr.
+* `HistoryToken appendParameter(String name, String value)` : add a new query parameter.
+* `HistoryToken replaceParameter(String name, String replacementName, String replacementValue)` : replace a query parameter with a new one.
+* `HistoryToken removeParameter(String name)` : removes a query parameter.
+* `HistoryToken replaceQuery(String newQuery)` : replace all query part with a new one.
+* `HistoryToken clearQuery()` : remove all query parameters.
+* `String query()` : return the query parameters as a String.
+* `boolean isEmpty()` : returns true if the token is empty.
+* `HistoryToken clear()` : remove all paths, query parameters and fragments and makes the token empty.
+* `String value()` : return the token as a String.
+
+### Token Filters
+
+Use one of the filters from `TokenFilter` to narrow the tokens you want to listen to from history, the TokenFilter class has factory method for lots of useful filters.
+
+- Sample
+
+```java
+history.listen(TokenFilter.any(), state -> {
+    console.info(state.token().value());
+});
+history.listen(TokenFilter.startsWithPathFilter("path1"), state -> {
+    console.info(state.token().value());
+});
+```
+
+### Wildcards
+
+Sometimes we want to listen to token where a specific part of it is a variable, in this case we can simply define that part as a variable using `:` in the token filter when we define a listener.
+
+- Sample
+
+```java
+HTMLButtonElement button4 = Js.uncheckedCast(document.createElement("button"));
+button4.textContent ="button4";
+button4.addEventListener("click", evt -> history.fireState("fixedPath/somePath"));
+
+history.listen(TokenFilter.endsWith("fixedPath/:variablePath"), state -> {
+    String variablePathValue = state.normalizedToken().getPathParameter("variablePath");
+    console.info(variablePathValue);
+    //when the button clicked should print somePath
+});
+``` 
+
+
+

deploy/publish.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+
+echo $GPG_DIR
+echo "-----------------------------------"
+if [[ $TRAVIS_PULL_REQUEST == "false" ]]; then
+    mvn clean deploy -Dmaven.test.skip=true --settings $GPG_DIR/settings.xml -Dci=true
+    exit $?
+fi

deploy/settings.xml

@@ -0,0 +1,9 @@
+<settings>
+    <servers>
+        <server>
+            <id>ossrh</id>
+            <username>${env.SONATYPE_USERNAME}</username>
+            <password>${env.SONATYPE_PASSWORD}</password>
+        </server>
+    </servers>
+</settings>

domino-history-gwt/pom.xml

@@ -0,0 +1,65 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>domino-history</artifactId>
+        <groupId>org.dominokit</groupId>
+        <version>1.0-rc.4-SNAPSHOT</version>
+    </parent>
+    <packaging>gwt-lib</packaging>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>domino-history-gwt</artifactId>
+
+    <name>domino-history-gwt</name>
+    <url>https://github.com/DominoKit/domino-history</url>
+
+    <dependencies>
+
+        <dependency>
+            <groupId>com.google.gwt</groupId>
+            <artifactId>gwt-user</artifactId>
+            <version>2.8.2</version>
+            <scope>provided</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>org.dominokit</groupId>
+            <artifactId>domino-history-shared</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.dominokit</groupId>
+            <artifactId>domino-history-shared</artifactId>
+            <version>${project.version}</version>
+            <classifier>sources</classifier>
+        </dependency>
+
+        <dependency>
+            <groupId>com.google.elemental2</groupId>
+            <artifactId>elemental2-core</artifactId>
+            <version>${elemental.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>com.google.elemental2</groupId>
+            <artifactId>elemental2-dom</artifactId>
+            <version>${elemental.version}</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>net.ltgt.gwt.maven</groupId>
+                <artifactId>gwt-maven-plugin</artifactId>
+                <extensions>true</extensions>
+                <configuration>
+                    <moduleName>org.dominokit.domino.gwt.history.History</moduleName>
+                    <moduleShortName>dominogwthistory</moduleShortName>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

domino-history-gwt/src/main/java/org/dominokit/domino/gwt/history/History.java

@@ -0,0 +1,15 @@
+package org.dominokit.domino.gwt.history;
+
+import jsinterop.annotations.JsPackage;
+import jsinterop.annotations.JsType;
+
+@JsType(isNative = true, namespace = JsPackage.GLOBAL)
+public class History {
+    public native void back();
+
+    public native void forward();
+
+    public native void pushState(JsState jsState, String title, String url);
+
+    public native void replaceState(JsState jsState, String title, String url);
+}

domino-history-gwt/src/main/java/org/dominokit/domino/gwt/history/HistoryListener.java

@@ -0,0 +1,38 @@
+package org.dominokit.domino.gwt.history;
+
+import org.dominokit.domino.history.DominoHistory;
+import org.dominokit.domino.history.TokenFilter;
+
+public class HistoryListener {
+    private final DominoHistory.StateListener listener;
+
+    private final TokenFilter tokenFilter;
+
+    private final boolean removeOnComplete;
+
+    private HistoryListener(DominoHistory.StateListener listener,
+                            TokenFilter tokenFilter) {
+        this.listener = listener;
+        this.tokenFilter = tokenFilter;
+        this.removeOnComplete = false;
+    }
+
+    HistoryListener(DominoHistory.StateListener listener,
+                    TokenFilter tokenFilter, boolean removeOnComplete) {
+        this.listener = listener;
+        this.tokenFilter = tokenFilter;
+        this.removeOnComplete = removeOnComplete;
+    }
+
+    public DominoHistory.StateListener getListener() {
+        return listener;
+    }
+
+    public TokenFilter getTokenFilter() {
+        return tokenFilter;
+    }
+
+    public boolean isRemoveOnComplete() {
+        return removeOnComplete;
+    }
+}