Initial Commit.

Author: an0nusr

.gitignore

@@ -0,0 +1,147 @@
+# Created by https://www.toptal.com/developers/gitignore/api/node
+# Edit at https://www.toptal.com/developers/gitignore?templates=node
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+### Node Patch ###
+# Serverless Webpack directories
+.webpack/
+
+# Optional stylelint cache
+
+# SvelteKit build / generate output
+.svelte-kit
+
+# End of https://www.toptal.com/developers/gitignore/api/node
+
+# Do not commit the compiled parser.
+bbcode-parser.js

README.md

@@ -0,0 +1,48 @@
+# bbcode-parser-sax - a bbcode parser with no dependencies and a simple API.
+
+bbcode-parser-sax is a bbcode parser, writen with PEGjs. The PEGjs grammar is
+compiled into a parser library and does not have any dependencies.
+
+The parser outputs a list of events in json, each with a specified type,
+similar to a SAX parser.
+
+For example, given the string: `The quick brown fox [i]jumped[/i]
+ [b]over[/b] the [u]stream[/u]`, the tool would emit:
+
+ ```js
+ [
+  { type: 'text', text: 'The quick brown ' },
+  { type: 'startTag', tag: { name: 'i', value: null } },
+  { type: 'text', text: 'fox' },
+  { type: 'endTag', tag: { name: 'i', value: null } },
+  { type: 'text', text: ' ' },
+  { type: 'startTag', tag: { name: 'b', value: null } },
+  { type: 'text', text: 'jumped' },
+  { type: 'endTag', tag: { name: 'b', value: null } }
+]
+```
+
+Tags that have values, like `[url=https://site.com]` will be parsed
+as `tag: { name: 'url', value: 'https://site.com' }`.
+
+This style allows the parser to be simple, and makes it easy to adapt
+the output to whatever you'd like!
+
+## Building
+Run `yarn build` from the project directory to both generate the parser
+from the grammar, and to build cjs and esm outputs. 
+
+## Usage
+Usage will depend if you're using this with CommonJS or ESM
+
+For CommonJS:
+```js
+const {parse} = require("bbcode-parser-sax")
+return parse(BBCODE_STRING)
+```
+
+For ESM:
+```js
+import parser from 'bbcode-parser-sax'
+return parser.parse(BBCODE_STRING)
+```

grammar.pegjs

@@ -0,0 +1,32 @@
+// Simple BBCode Parser in PEG
+// ==========================
+//
+// Produces SAX-style events based on what is parsed.
+// Can be reviewed and tested at https://pegjs.org/online
+
+Expression
+  = (EndTag / StartTag / String)*
+  
+TagChars
+  = !("]" / " ") name:(. TagChars*) { return name.join("") }
+  
+TagCharsWithoutEquals
+  = !("]" / " " / "=") name:(. TagCharsWithoutEquals*) { return name.join("") }
+  
+Tag
+  = name:(TagChars) { return  {"name": name, value: null } }
+  
+TagWithValue
+  = name:(TagCharsWithoutEquals) "=" value:(TagChars) { return { name: name, value: value } }
+ 
+StartTag
+  = "[" tagName:(TagWithValue / Tag) "]" {return {type: "startTag", tag: tagName} }
+ 
+EndTag
+  = "[/" tagName:(TagWithValue / Tag) "]" {return {type: "endTag", tag: tagName} }
+ 
+NotTag
+  = !(EndTag / StartTag) s:(. NotTag*) { return s.join("") }
+  
+String
+  = s:NotTag { return {type: "text", text: s} }

package.json

@@ -0,0 +1,17 @@
+{
+  "name": "bbcode-parser-sax",
+  "description": "A simple, dependency-free parser for BBCode, based on SAX.",
+  "version": "1.0.0",
+  "source": "bbcode-parser.js",
+  "main": "dist/bbcode-parser.js",
+  "module": "dist/bbcode-parser.esm.js",
+  "license": "MIT",
+  "scripts": {
+    "build-parser": "pegjs -o bbcode-parser.js grammar.pegjs",
+    "build": "yarn build-parser && parcel build"
+  },
+  "devDependencies": {
+    "parcel": "^2.2.1",
+    "pegjs": "^0.10.0"
+  }
+}