Add README and bower.json

Author: rnons

README.md

@@ -0,0 +1,41 @@
+# purescript-halogen-custom-element
+
+A library to convert Halogen components to [custom elements](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements).
+
+## Usage
+
+```
+import Halogen.CustomElement as CustomElement
+
+main :: Effect Unit
+main = do
+  CustomElement.define "halogen-hello" component
+```
+
+Now include `main.js` in your HTML file, then put `<halogen-hello></halogen-hello>` anywhere in your HTML, and the Halogen component will be rendered there.
+
+The original purpose of this library is to support putting Halogen component inside Markdown, so that write documentation together with demos becomes easy. See the [documentation of halogen-nselect](https://nonbili.github.io/purescript-halogen-nselect/) as an example.
+
+## Limitation
+
+Currently, the component passed to `CustomElement.define` is required to have `Unit` as input type.
+
+```purescript
+module Halogen.CustomElement (define) where
+
+define
+  :: forall query output
+   . String
+  -> H.Component HH.HTML query Unit output Aff
+  -> Effect Unit
+```
+
+However, I think it's possible to collect all attributes of the defined custome element, and pass a `Foreign` or `Json` back to the underlying Halogen component.
+
+
+## Development
+
+```
+cd example
+yarn start
+```

bower.json

@@ -0,0 +1,21 @@
+{
+  "name": "purescript-halogen-custom-element",
+  "description": "Convert Halogen components to custom elements",
+  "authors": [
+    "Ping Chen <remotenonsense@gmail.com>"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/nonbili/purescript-halogen-custom-element.git"
+  },
+  "license": "BSD-3-Clause",
+  "ignore": [
+    "**/.*",
+    "node_modules",
+    "bower_components",
+    "output"
+  ],
+  "dependencies": {
+    "purescript-halogen": "^5.0.0-rc.7"
+  }
+}

example/README.md

@@ -0,0 +1,7 @@
+# Use Halogen component as a custom element
+
+The following text is rendered by a Halogen component, run `yarn start` to see it rendered.
+
+<halogen-hello></halogen-hello>
+
+<script src="main.js"></script>

example/package.json

@@ -0,0 +1,8 @@
+{
+  "scripts": {
+    "start": "parcel README.md"
+  },
+  "devDependencies": {
+    "marked": "^0.8.0"
+  }
+}

example/yarn.lock

@@ -0,0 +1,8 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+
+
+marked@^0.8.0:
+  version "0.8.0"
+  resolved "https://registry.yarnpkg.com/marked/-/marked-0.8.0.tgz#ec5c0c9b93878dc52dd54be8d0e524097bd81a99"
+  integrity sha512-MyUe+T/Pw4TZufHkzAfDj6HarCBWia2y27/bhuYkTaiUnfDYFnCP3KUN+9oM7Wi6JA2rymtVYbQu3spE0GCmxQ==