├── .gitignore ├── LICENSE ├── Makefile ├── README.md ├── boreDOMCLI ├── README.md ├── cli.js ├── package.json └── pnpm-lock.yaml ├── dist ├── boreDOM.d.ts └── boreDOM.min.js ├── examples ├── counter │ ├── boreDOM.min.js │ ├── index.html │ ├── main.js │ └── simple-counter.js ├── tic-tac-toe │ ├── README.md │ ├── boreDOM.d.ts │ ├── boreDOM.min.js │ ├── game-board.css │ ├── game-board.js │ ├── game-button.css │ ├── game-turn.js │ ├── index.html │ ├── main.js │ ├── pnpm-lock.yaml │ └── style.css └── todo-list │ ├── boreDOM.min.js │ └── todo.html ├── jsr.json ├── package.json ├── pnpm-lock.yaml ├── src ├── bore.ts ├── dom.ts ├── index.ts ├── types.ts └── utils │ ├── access.ts │ ├── flatten.ts │ └── isPojo.ts ├── tests ├── dom.test.ts ├── index.html ├── js │ └── README.md ├── list-component1.js ├── list-item1.js ├── on-event-component1.js ├── on-event-component2.js ├── runner.ts ├── stateful-component1.js ├── stateful-component2.js ├── stateful-component3.js ├── stateful-component4.js ├── stateful-component5.js ├── stateful-component6.js ├── stateful-component7.js └── stateful-component8.js └── tsconfig.json /.gitignore: -------------------------------------------------------------------------------- 1 | node_modules 2 | tests/dist 3 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Creative Commons Legal Code 2 | 3 | CC0 1.0 Universal 4 | 5 | CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE 6 | LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN 7 | ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS 8 | INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES 9 | REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS 10 | PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM 11 | THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED 12 | HEREUNDER. 13 | 14 | Statement of Purpose 15 | 16 | The laws of most jurisdictions throughout the world automatically confer 17 | exclusive Copyright and Related Rights (defined below) upon the creator 18 | and subsequent owner(s) (each and all, an "owner") of an original work of 19 | authorship and/or a database (each, a "Work"). 20 | 21 | Certain owners wish to permanently relinquish those rights to a Work for 22 | the purpose of contributing to a commons of creative, cultural and 23 | scientific works ("Commons") that the public can reliably and without fear 24 | of later claims of infringement build upon, modify, incorporate in other 25 | works, reuse and redistribute as freely as possible in any form whatsoever 26 | and for any purposes, including without limitation commercial purposes. 27 | These owners may contribute to the Commons to promote the ideal of a free 28 | culture and the further production of creative, cultural and scientific 29 | works, or to gain reputation or greater distribution for their Work in 30 | part through the use and efforts of others. 31 | 32 | For these and/or other purposes and motivations, and without any 33 | expectation of additional consideration or compensation, the person 34 | associating CC0 with a Work (the "Affirmer"), to the extent that he or she 35 | is an owner of Copyright and Related Rights in the Work, voluntarily 36 | elects to apply CC0 to the Work and publicly distribute the Work under its 37 | terms, with knowledge of his or her Copyright and Related Rights in the 38 | Work and the meaning and intended legal effect of CC0 on those rights. 39 | 40 | 1. Copyright and Related Rights. A Work made available under CC0 may be 41 | protected by copyright and related or neighboring rights ("Copyright and 42 | Related Rights"). Copyright and Related Rights include, but are not 43 | limited to, the following: 44 | 45 | i. the right to reproduce, adapt, distribute, perform, display, 46 | communicate, and translate a Work; 47 | ii. moral rights retained by the original author(s) and/or performer(s); 48 | iii. publicity and privacy rights pertaining to a person's image or 49 | likeness depicted in a Work; 50 | iv. rights protecting against unfair competition in regards to a Work, 51 | subject to the limitations in paragraph 4(a), below; 52 | v. rights protecting the extraction, dissemination, use and reuse of data 53 | in a Work; 54 | vi. database rights (such as those arising under Directive 96/9/EC of the 55 | European Parliament and of the Council of 11 March 1996 on the legal 56 | protection of databases, and under any national implementation 57 | thereof, including any amended or successor version of such 58 | directive); and 59 | vii. other similar, equivalent or corresponding rights throughout the 60 | world based on applicable law or treaty, and any national 61 | implementations thereof. 62 | 63 | 2. Waiver. To the greatest extent permitted by, but not in contravention 64 | of, applicable law, Affirmer hereby overtly, fully, permanently, 65 | irrevocably and unconditionally waives, abandons, and surrenders all of 66 | Affirmer's Copyright and Related Rights and associated claims and causes 67 | of action, whether now known or unknown (including existing as well as 68 | future claims and causes of action), in the Work (i) in all territories 69 | worldwide, (ii) for the maximum duration provided by applicable law or 70 | treaty (including future time extensions), (iii) in any current or future 71 | medium and for any number of copies, and (iv) for any purpose whatsoever, 72 | including without limitation commercial, advertising or promotional 73 | purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each 74 | member of the public at large and to the detriment of Affirmer's heirs and 75 | successors, fully intending that such Waiver shall not be subject to 76 | revocation, rescission, cancellation, termination, or any other legal or 77 | equitable action to disrupt the quiet enjoyment of the Work by the public 78 | as contemplated by Affirmer's express Statement of Purpose. 79 | 80 | 3. Public License Fallback. Should any part of the Waiver for any reason 81 | be judged legally invalid or ineffective under applicable law, then the 82 | Waiver shall be preserved to the maximum extent permitted taking into 83 | account Affirmer's express Statement of Purpose. In addition, to the 84 | extent the Waiver is so judged Affirmer hereby grants to each affected 85 | person a royalty-free, non transferable, non sublicensable, non exclusive, 86 | irrevocable and unconditional license to exercise Affirmer's Copyright and 87 | Related Rights in the Work (i) in all territories worldwide, (ii) for the 88 | maximum duration provided by applicable law or treaty (including future 89 | time extensions), (iii) in any current or future medium and for any number 90 | of copies, and (iv) for any purpose whatsoever, including without 91 | limitation commercial, advertising or promotional purposes (the 92 | "License"). The License shall be deemed effective as of the date CC0 was 93 | applied by Affirmer to the Work. Should any part of the License for any 94 | reason be judged legally invalid or ineffective under applicable law, such 95 | partial invalidity or ineffectiveness shall not invalidate the remainder 96 | of the License, and in such case Affirmer hereby affirms that he or she 97 | will not (i) exercise any of his or her remaining Copyright and Related 98 | Rights in the Work or (ii) assert any associated claims and causes of 99 | action with respect to the Work, in either case contrary to Affirmer's 100 | express Statement of Purpose. 101 | 102 | 4. Limitations and Disclaimers. 103 | 104 | a. No trademark or patent rights held by Affirmer are waived, abandoned, 105 | surrendered, licensed or otherwise affected by this document. 106 | b. Affirmer offers the Work as-is and makes no representations or 107 | warranties of any kind concerning the Work, express, implied, 108 | statutory or otherwise, including without limitation warranties of 109 | title, merchantability, fitness for a particular purpose, non 110 | infringement, or the absence of latent or other defects, accuracy, or 111 | the present or absence of errors, whether or not discoverable, all to 112 | the greatest extent permissible under applicable law. 113 | c. Affirmer disclaims responsibility for clearing rights of other persons 114 | that may apply to the Work or any use thereof, including without 115 | limitation any person's Copyright and Related Rights in the Work. 116 | Further, Affirmer disclaims responsibility for obtaining any necessary 117 | consents, permissions or other rights required for any use of the 118 | Work. 119 | d. Affirmer understands and acknowledges that Creative Commons is not a 120 | party to this document and has no duty or obligation with respect to 121 | this CC0 or use of the Work. 122 | -------------------------------------------------------------------------------- /Makefile: -------------------------------------------------------------------------------- 1 | # Install dependencies 2 | node_modules: 3 | pnpm install 4 | 5 | dist/boreDOM.min.js: 6 | pnpm run build_module 7 | 8 | dist/boreDOM.d.ts: 9 | pnpm run build_decls 10 | 11 | tests/dist/boreDOM.min.js: dist/boreDOM.min.js 12 | cd tests && ln -fs ../dist . 13 | 14 | build: node_modules dist/boreDOM.min.js dist/boreDOM.d.ts 15 | 16 | place: dist/boreDOM.min.js dist/boreDOM.d.ts 17 | cp dist/boreDOM.min.js ../fun/drawshader/static/js/external/boreDOM.js 18 | cp dist/boreDOM.d.ts ../fun/drawshader/static/js/external 19 | 20 | # Run the development server 21 | dev: node_modules 22 | pnpm run dev 23 | 24 | # Run the development server 25 | test: node_modules tests/dist/boreDOM.min.js 26 | find src/ | entr -s 'make clean && make build && pnpm run test' 27 | 28 | clean: 29 | rm dist/* 30 | 31 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # boreDOM 2 | 3 | ## Install 4 | 5 | `pnpm install @mr_hugo/boredom` 6 | 7 | ## Description 8 | 9 | Check out the official page: 10 | [https://hugodaniel.com/pages/boredom/](https://hugodaniel.com/pages/boredom/). 11 | 12 | # License 13 | 14 |

boreDOM by Hugo Daniel is marked with CC0 1.0

15 | -------------------------------------------------------------------------------- /boreDOMCLI/README.md: -------------------------------------------------------------------------------- 1 | ## boreDOM CLI 2 | 3 | To build this, first run `pnpm run build_cli` in the parent folder. 4 | 5 | This command will create the binary .js for boreDOM CLI that contains the 6 | boredom .js code bundled in it. 7 | 8 | After that, you can install boredom locally by running `npm link` in this folder. 9 | -------------------------------------------------------------------------------- /boreDOMCLI/cli.js: -------------------------------------------------------------------------------- 1 | const fs = require("fs-extra"); 2 | const path = require("path"); 3 | const glob = require("glob"); 4 | const cheerio = require("cheerio"); 5 | const { program } = require("commander"); 6 | const http = require("http"); 7 | const finalhandler = require("finalhandler"); 8 | const beautify = require("js-beautify").html; 9 | const chokidar = require("chokidar"); 10 | const handler = require("serve-handler"); 11 | 12 | const BUILD_DIR = "build"; 13 | let serverStarted = false; 14 | let numberOfRefreshes = 0; 15 | 16 | console.log("## boreDOM CLI options"); 17 | console.log( 18 | "## ", 19 | "--index ", 20 | "Index file to serve", 21 | "defaults to index.html", 22 | ); 23 | console.log( 24 | "## ", 25 | "--html ", 26 | "Folder containing HTML component files", 27 | 'defaults to "components"', 28 | ); 29 | 30 | program 31 | .option("--index ", "Index file to serve", "index.html") 32 | .option( 33 | "--html ", 34 | "Folder containing HTML component files", 35 | "components", 36 | ) 37 | .parse(process.argv); 38 | 39 | const options = program.opts(); 40 | 41 | async function copyStatic() { 42 | const staticDir = path.join(process.cwd(), "static"); 43 | if (await fs.pathExists(staticDir)) { 44 | await fs.copy(staticDir, path.join(BUILD_DIR, "static")); 45 | console.log("Static folder copied."); 46 | } 47 | } 48 | 49 | async function copyBoreDOM() { 50 | return fs.writeFile(path.join(BUILD_DIR, "boreDOM.js"), atob(boredom)); 51 | } 52 | 53 | async function processComponents() { 54 | let components = {}; 55 | 56 | if (options.html) { 57 | const htmlFolder = path.resolve(options.html); 58 | const htmlFiles = glob.sync("**/*.html", { cwd: htmlFolder }); 59 | for (const file of htmlFiles) { 60 | const filePath = path.join(htmlFolder, file); 61 | const content = await fs.readFile(filePath, "utf-8"); 62 | const $ = cheerio.load(content, { decodeEntities: false }); 63 | const template = $("template[data-component]"); 64 | if (template.length) { 65 | const componentName = template.attr("data-component"); 66 | const fullTemplate = $.html(template); 67 | 68 | // Create a dedicated folder for this component 69 | const componentBuildDir = path.join( 70 | BUILD_DIR, 71 | "components", 72 | componentName, 73 | ); 74 | await fs.ensureDir(componentBuildDir); 75 | 76 | // Copy the HTML file into the component folder 77 | const destHtmlPath = path.join( 78 | componentBuildDir, 79 | `${componentName}.html`, 80 | ); 81 | await fs.copy(filePath, destHtmlPath); 82 | console.log(`Copied ${componentName}.html to ${componentBuildDir}`); 83 | 84 | // Look for corresponding JS and CSS files (even in subfolders) 85 | const componentDir = path.dirname(filePath); 86 | const jsMatch = glob.sync(`**/${componentName}.js`, { 87 | cwd: componentDir, 88 | }); 89 | const cssMatch = glob.sync(`**/${componentName}.css`, { 90 | cwd: componentDir, 91 | }); 92 | 93 | const hasJS = jsMatch.length > 0; 94 | if (jsMatch.length > 0) { 95 | const jsSrc = path.join(componentDir, jsMatch[0]); 96 | const destJsPath = path.join( 97 | componentBuildDir, 98 | `${componentName}.js`, 99 | ); 100 | await fs.copy(jsSrc, destJsPath); 101 | console.log(`Copied ${componentName}.js to ${componentBuildDir}`); 102 | } 103 | const hasCSS = cssMatch.length > 0; 104 | if (cssMatch.length > 0) { 105 | const cssSrc = path.join(componentDir, cssMatch[0]); 106 | const destCssPath = path.join( 107 | componentBuildDir, 108 | `${componentName}.css`, 109 | ); 110 | await fs.copy(cssSrc, destCssPath); 111 | console.log(`Copied ${componentName}.css to ${componentBuildDir}`); 112 | } 113 | 114 | components[componentName] = { 115 | templateTag: fullTemplate, 116 | hasJS, 117 | hasCSS, 118 | }; 119 | } 120 | } 121 | } 122 | return components; 123 | } 124 | 125 | async function updateIndex(components) { 126 | console.log( 127 | "UPDATING WITH COMPONENTS:\n\n", 128 | JSON.stringify(components, null, 2), 129 | ); 130 | const indexPath = path.resolve(options.index); 131 | let indexContent = await fs.readFile(indexPath, "utf-8"); 132 | const $ = cheerio.load(indexContent, { decodeEntities: false }); 133 | $("body").append(`\n `); 134 | 135 | // For each component, add references to its JS/CSS files and inject its full