pwf

Punkweb client-side JavaScript framework for building Single Page Applications

Capabilities

• SPA router
• JSON XMLHttpRequests
• JSX rendering

TODO

• DOM Abstraction
• Auto redraw on DOM events, http requests, and navigation
• Components w/ life cycle

Get Started

There's an example project using parcel-bundler at example/. The example app could be using a more updated version than what is currently published.

Installation

npm install pwf

Setup

In your HTML document, include an element to use as your app-root such as:

<app-root>Loading...</app-root>

Note <app-root></app-root> could be whatever you want as long as you can query for it in your JavaScript.

Note Loading... is optional, this could be whatever you want (i.e: a loading indicator).

JSX

JavaScript

To use JSX in a JavaScript app you'll need to install @babel/plugin-transform-react-jsx and add it to your plugins in .babelrc:

npm install --save-dev @babel/plugin-transform-react-jsx

{
  "plugins": [
    [
      "@babel/plugin-transform-react-jsx",
      {
        "pragma": "pwf.jsx.element",
        "pragmaFrag": "pwf.jsx.fragment"
      }
    ],
    ...
  ],
  ...
}

Files using jsx must have .jsx extension and import { pwf } from 'pwf';

TypeScript

To use JSX in a TypeScript app you'll need to set the following compilerOptions in tsconfig.json

"compilerOptions": {
  ...
  "jsx": "react",
  "jsxFactory": "pwf.jsx.element",
  "jsxFragmentFactory": "pwf.jsx.fragment"
  ...
},

Files using jsx must have .tsx extension and import { pwf } from 'pwf';

Simple router example

import { pwf } from 'pwf';

let root = document.querySelector('app-root');

function Home() {
  return (
    <h3>Home</h3>
  );
}

function Error404 {
  return (
    <h3>Page Not Found</h3>
  );
}

pwf.router.init(root, [
  routes: [
    { path: '/' component: <Home /> },
    { path: '/:404' component: <Error404 /> },
  ]
]);

Router

Navigation from JavaScript:

import { pwf } from 'pwf';

pwf.router.navigate('/login/');

Navigation from JSX:

<a router-link="/login/">Login</a>

Http

import { pwf } from 'pwf';

pwf.request({
  method: 'GET',
  url: '/users/',
  headers: {
    'Authorization': 'token',
    ...
  },
  params: {
    type: 'active',
    ...
  },
}).then((users) => {
  console.log(users);
}).catch((err) => {
  console.log(err.error);
});

pwf.request({
  method: 'POST',
  url: '/login/',
  data: {
    username: 'username',
    password: 'password',
    ...
  },
});

Http Interfaces

interface IHttpRequest {
  method: string;
  url: string | URL;
  headers?: any;
  params?: any;
  data?: any;
}

interface IHttpResponse {
  response: ArrayBuffer;
  data: any;
  status: number;
}

interface IHttpError {
  response: ArrayBuffer;
  error: any;
  status: number;
}

Development

Install deps

npm install

Start example project

npm start

Build

npm run build

Format

npm run format

Test

npm test