accept files as parameters #28

.github/workflows/npm.yml

@@ -0,0 +1,19 @@
+name: npm-publish
+on:
+  workflow_dispatch:
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

README.md

@@ -12,8 +12,8 @@ Using modules
 ```html
 <script type="module">
 
-  import {parse, render} from 'https://esm.sh/@tbela99/css-parser@0.6.0/web';
-  import {extract} from 'https://esm.sh/@tbela99/critical@1.1.1/browser';
+  import {parse, render} from 'https://esm.sh/@tbela99/css-parser@0.7.1/web';
+  import {extract} from 'https://esm.sh/@tbela99/critical@1.2.0/browser';
 
   const results = await extract({fonts: true});
   // css is optimized using https://www.npmjs.com/package/@tbela99/css-parser
@@ -26,8 +26,8 @@ Using modules
 
 Without using modules
 ```html
-<script src="https://cdn.jsdelivr.net/gh/tbela99/critical@1.1.1/dist/browser-umd.js"></script>
-<script src="https://cdn.jsdelivr.net/gh/tbela99/css-parser@0.6.0/dist/index-umd-web.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/tbela99/critical@1.2.0/dist/browser-umd.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/tbela99/css-parser@0.7.1/dist/index-umd-web.js"></script>
 <script>
 
   (async () => {
@@ -175,6 +175,7 @@ Options:
   -k, --browser-type    use a mobile browser
                                          [string] [choices: "mobile", "desktop"]
   -r, --random-browser  use a random browser          [boolean] [default: false]
+  -u, --random-user-agent  use a random user agent    [boolean] [default: false]
   -i, --screenshot      Generate screenshots                           [boolean]
   -s, --secure          enable or disable security settings such as CSP and same
                          origin policy                                 [boolean]
@@ -203,12 +204,21 @@ Options:
 
 ### Example
 
+### Read data from URL
+
 ```shell
 
 $ critical-cli https://github.com/ https://nodejs.org --secure=no -i -d '1440x900' -d '1366x768' --json
 ```
 
-### Read data from cli
+### Read data from file(s)
+
+```shell
+
+$ critical-cli pages/dashboard.html pages/404.html --secure=no -i -d '1440x900' -d '1366x768' --json
+```
+
+### Read data from STDIN
 
 ```shell
 
@@ -217,6 +227,11 @@ $ cat pages/dashboard.html | critical-cli --base=pages/ --secure=no -i -d '1440x
 
 ## CHANGELOG
 
+### V1.2.0
+
+- accept files parameters in addition to urls
+- add missing cli argument 'random-user-agent'
+
 ### V1.1.1
 
 - fix node 22 compatibility issues 

bin/args.json

@@ -45,6 +45,13 @@
       "type": "boolean",
       "default": false
     },
+    "random-user-agent": {
+      "alias": "u",
+      "demandOption": false,
+      "description": "use a random user agent",
+      "type": "boolean",
+      "default": false
+    },
     "screenshot": {
       "alias": "i",
       "demandOption": false,

dist/index.d.ts

@@ -65,9 +65,13 @@ interface CriticalCliResult {
     html: string
 }
 
+/**
+ * execute critical css generation
+ */
 declare function critical(options: CriticalOptions): Promise<CriticalCliResult>;
+/**
+ * execute critical css generation
+ */
 declare function critical(url: string, options: CriticalOptions): Promise<CriticalCliResult>;
-declare function isWhiteSpace(codepoint: number): boolean;
-declare function splitRule(buffer: string): string[][];
 
-export { critical, isWhiteSpace, splitRule };
+export { critical };

jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbela99/critical",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "publish": {
     "include": [
       "src",

package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1.1",
+  "version": "1.2.0",
   "name": "@tbela99/critical",
   "description": "Generate critical CSS path from HTML pages to enable instantaneous rendering",
   "type": "module",
@@ -43,7 +43,8 @@
     "critical",
     "critical-css-path",
     "critical-path",
-    "critical-css"
+    "critical-css",
+    "above-the-fold"
   ],
   "devDependencies": {
     "@esm-bundle/chai": "^4.3.4-fix.0",