@ca-plant-list/ca-plant-list 0.1.2 → 0.1.3

package/jekyll/_layouts/html.html

@@ -29,7 +29,7 @@
                         <a class="nav-link" href="{{site.baseurl}}/rare_plants.html">Rare Plants</a>
                     </li>
                     <li class="nav-item">
-                        <a class="nav-link" href="{{site.baseurl}}/common_name_search.html">Common Name Search</a>
+                        <a class="nav-link" href="{{site.baseurl}}/name_search.html">Name Search</a>
                     </li>
                     {%include menu_extra.html %}
                 </ul>

package/jekyll/assets/css/main.css

@@ -28,6 +28,7 @@ span.label {
 
 td {
     border: solid 1px;
+    padding: 0 .5rem;
     vertical-align: top;
 }
 
@@ -85,4 +86,9 @@ div.section li {
 
 div.section ul.indent {
     padding-left: 1rem;
+}
+
+/* Forms */
+input {
+    margin-right: .5em;
 }

package/jekyll/assets/js/name_search.js

@@ -0,0 +1,156 @@
+const MIN_LEN = 2;
+const MAX_RESULTS = 50;
+
+class Search {
+
+    static #debounceTimer;
+    static #searchData;
+
+    static #debounce( func ) {
+        clearTimeout( this.#debounceTimer );
+        this.#debounceTimer = setTimeout( func, 500 );
+    }
+
+    static #doSearch() {
+
+        function matchTaxon( taxon, value ) {
+
+            function matchSynonyms( syns, value ) {
+                const matchedIndexes = [];
+                if ( syns ) {
+                    for ( let index = 0; index < syns.length; index++ ) {
+                        if ( syns[ index ].includes( value ) ) {
+                            matchedIndexes.push( index );
+                        }
+                    }
+                }
+                return matchedIndexes;
+            }
+
+            const rawData = taxon[ 0 ];
+            const name = taxon[ 1 ];
+            const cn = taxon[ 2 ];
+            const syns = matchSynonyms( taxon[ 3 ], value );
+            if ( syns.length > 0 ) {
+                // Include any matching synonyms.
+                for ( const index of syns ) {
+                    matches.push( [ rawData[ 0 ], rawData[ 1 ], rawData[ 2 ][ index ] ] );
+                }
+            } else {
+                // No synonyms match; see if the scientific or common names match.
+                const namesMatch = name.includes( value ) || ( cn && cn.includes( value ) );
+                if ( namesMatch ) {
+                    matches.push( [ rawData[ 0 ], rawData[ 1 ] ] );
+                }
+            }
+
+        }
+
+        Search.#debounceTimer = undefined;
+
+        const value = document.getElementById( "name" ).value.toLowerCase();
+
+        const matches = [];
+        const shouldSearch = ( value.length >= MIN_LEN );
+
+        if ( shouldSearch ) {
+
+            // If the search data is not done generating, try again later.
+            if ( !Search.#searchData ) {
+                this.#debounce( Search.#doSearch );
+            }
+
+            for ( const taxon of Search.#searchData ) {
+                matchTaxon( taxon, value );
+            }
+        }
+
+        const eBody = document.createElement( "tbody" );
+        if ( matches.length <= MAX_RESULTS ) {
+            for ( const match of matches ) {
+
+                const tr = document.createElement( "tr" );
+
+                // Scientific name.
+                const name = match[ 0 ];
+                const syn = match[ 2 ];
+                const td1 = document.createElement( "td" );
+                const link = document.createElement( "a" );
+                link.setAttribute( "href", "./" + name.replaceAll( ".", "" ).replaceAll( " ", "-" ) + ".html" );
+                link.textContent = name;
+                td1.appendChild( link );
+                if ( syn ) {
+                    td1.appendChild( document.createTextNode( " (" + syn + ")" ) );
+                }
+                tr.appendChild( td1 );
+
+                const cn = match[ 1 ];
+                const td2 = document.createElement( "td" );
+                if ( cn ) {
+                    td2.textContent = cn;
+                }
+                tr.appendChild( td2 );
+
+                eBody.appendChild( tr );
+
+            }
+        }
+
+        // Delete current message
+        const eMessage = document.getElementById( "message" );
+        if ( eMessage.firstChild ) {
+            eMessage.removeChild( eMessage.firstChild );
+        }
+        if ( shouldSearch ) {
+            if ( matches.length === 0 ) {
+                eMessage.textContent = "Nothing found.";
+            }
+            if ( matches.length > MAX_RESULTS ) {
+                eMessage.textContent = "Too many results.";
+            }
+        }
+
+        // Delete current results
+        const eTable = document.getElementById( "results" );
+        if ( eTable.firstChild ) {
+            eTable.removeChild( eTable.firstChild );
+        }
+
+        eTable.appendChild( eBody );
+    }
+
+    static async generateSearchData() {
+        const searchData = [];
+        // eslint-disable-next-line no-undef
+        for ( const taxon of NAMES ) {
+            const taxonData = [ taxon ];
+            taxonData.push( taxon[ 0 ].toLowerCase().replace( / (subsp|var)\./, "" ) );
+            if ( taxon[ 1 ] ) {
+                taxonData.push( taxon[ 1 ].toLowerCase() );
+            }
+            if ( taxon[ 2 ] ) {
+                const syns = [];
+                for ( const syn of taxon[ 2 ] ) {
+                    syns.push( syn.toLowerCase().replace( / (subsp|var)\./, "" ) );
+                }
+                taxonData[ 3 ] = syns;
+            }
+            searchData.push( taxonData );
+        }
+        this.#searchData = searchData;
+    }
+
+    static #handleChange() {
+        this.#debounce( Search.#doSearch );
+    }
+
+    static init() {
+        this.generateSearchData();
+        const eName = document.getElementById( "name" );
+        eName.focus();
+        eName.oninput = ( ev ) => { return this.#handleChange( ev ); };
+    }
+
+}
+
+Search.init();

package/jekyll/name_search.html

@@ -0,0 +1,18 @@
+---
+title: Name Search
+js: name_search.js
+---
+<h1>Search</h1>
+
+<script>
+    const NAMES = {% include names.json%};
+</script>
+
+<form>
+    <input type="text" id="name"><label for="name">Search for scientific name, common name, or synonym</label>
+</form>
+
+<div class="section" id="message"></div>
+
+<table id="results">
+</table>

package/lib/basepagerenderer.js

@@ -0,0 +1,46 @@
+import * as fs from "node:fs";
+import { Config } from "./config.js";
+
+class BasePageRenderer {
+
+    static render( outputDir, Taxa ) {
+
+        // Copy static files
+        fs.rmSync( outputDir, { force: true, recursive: true, maxRetries: 2, retryDelay: 200 } );
+        // First copy default Jekyll files from package.
+        fs.cpSync( Config.getPackageDir() + "/jekyll", outputDir, { recursive: true } );
+        // Then copy Jekyll files from current dir (which may override default files).
+        fs.cpSync( "jekyll", outputDir, { recursive: true } );
+
+        this.renderTools( outputDir, Taxa );
+
+    }
+
+    static renderTools( outputDir, Taxa ) {
+
+        const names = [];
+        for ( const taxon of Taxa.getTaxa() ) {
+            const row = [];
+            row.push( taxon.getName() );
+            const cn = taxon.getCommonNames().join( "," );
+            if ( cn ) {
+                row.push( cn );
+            }
+            const synonyms = [];
+            for ( const syn of taxon.getSynonyms() ) {
+                synonyms.push( syn );
+            }
+            if ( synonyms.length > 0 ) {
+                row[ 2 ] = synonyms;
+            }
+            names.push( row );
+        }
+
+        fs.writeFileSync( outputDir + "/_includes/names.json", JSON.stringify( names ) );
+
+    }
+
+
+}
+
+export { BasePageRenderer };

package/lib/exceptions.js

@@ -15,14 +15,16 @@ class Exceptions {
         return false;
     }
 
-    static getValue( name, cat, subcat ) {
+    static getValue( name, cat, subcat, defaultValue ) {
         const taxonData = this.#exceptions[ name ];
         if ( taxonData ) {
             const catData = taxonData[ cat ];
             if ( catData ) {
-                return catData[ subcat ];
+                const val = catData[ subcat ];
+                return ( val === undefined ) ? defaultValue : val;
             }
         }
+        return defaultValue;
     }
 
     static init( dir ) {

package/lib/files.js

@@ -0,0 +1,17 @@
+import * as fs from "node:fs";
+
+class Files {
+
+    static async fetch( url, targetFileName ) {
+        const response = await fetch( url );
+        const data = await response.text();
+        fs.writeFileSync( targetFileName, data );
+    }
+
+    static read( path ) {
+        return fs.readFileSync( path, "utf8" );
+    }
+
+}
+
+export { Files };

package/lib/index.js

@@ -0,0 +1,5 @@
+import { BasePageRenderer } from "./basepagerenderer.js";
+import { Config } from "./config.js";
+import { HTML, HTML_OPTIONS } from "./html.js";
+
+export { BasePageRenderer, Config, HTML, HTML_OPTIONS };

package/lib/pagerenderer.js

@@ -6,20 +6,15 @@ import { HTMLPage } from "./htmlpage.js";
 import { PageTaxon } from "./pagetaxon.js";
 import { Config } from "./config.js";
 import { RarePlants } from "./rareplants.js";
+import { BasePageRenderer } from "./basepagerenderer.js";
 
-class PageRenderer {
+class PageRenderer extends BasePageRenderer {
 
     static render( outputDir ) {
 
-        // Copy static files
-        fs.rmSync( outputDir, { force: true, recursive: true } );
-        // First copy default Jekyll files from package.
-        fs.cpSync( Config.getPackageDir() + "/jekyll", outputDir, { recursive: true } );
-        // Then copy Jekyll files from current dir (which may override default files).
-        fs.cpSync( "jekyll", outputDir, { recursive: true } );
+        super.render( outputDir, Taxa );
 
         this.renderLists( outputDir );
-        this.renderTools( outputDir );
 
         Families.renderPages( outputDir );
 
@@ -174,30 +169,6 @@ class PageRenderer {
 
     }
 
-    static renderTools( outputDir ) {
-
-        const commonNames = [];
-        for ( const taxon of Taxa.getTaxa() ) {
-            for ( const commonName of taxon.getCommonNames() ) {
-                commonNames.push( [ commonName, taxon.getName() ] );
-            }
-        }
-
-        const cnObj = {};
-        for ( const commonName of commonNames.sort( ( a, b ) => a[ 0 ].localeCompare( b[ 0 ] ) ) ) {
-            const normalizedName = commonName[ 0 ].toLowerCase().replaceAll( "-", " " ).replaceAll( "'", "" );
-            let data = cnObj[ normalizedName ];
-            if ( !data ) {
-                data = { cn: commonName[ 0 ], names: [] };
-                cnObj[ normalizedName ] = data;
-            }
-            data.names.push( commonName[ 1 ] );
-        }
-        fs.writeFileSync( outputDir + "/_includes/common_names.json", JSON.stringify( cnObj ) );
-
-
-    }
-
 }
 
 class PageTaxonList extends HTMLPage {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ca-plant-list/ca-plant-list",
-    "version": "0.1.2",
+    "version": "0.1.3",
     "description": "Tools to create Jekyll files for a website listing plants in an area of California.",
     "license": "MIT",
     "repository": {
@@ -10,9 +10,7 @@
     "homepage": "https://github.com/ca-plants/ca-plant-list",
     "type": "module",
     "exports": {
-        "./Config": {
-            "import": "./lib/config.js"
-        },
+        ".": "./lib/index.js",
         "./CSV": {
             "import": "./lib/csv.js"
         },
@@ -22,6 +20,9 @@
         "./Exceptions": {
             "import": "./lib/exceptions.js"
         },
+        "./Files": {
+            "import": "./lib/files.js"
+        },
         "./Taxa": {
             "import": "./lib/taxa.js"
         }

package/jekyll/assets/js/common_name_search.js

@@ -1,87 +0,0 @@
-const MIN_LEN = 2;
-const MAX_RESULTS = 50;
-
-class Search {
-
-    static #debounceTimer;
-
-    static #debounce( func ) {
-        clearTimeout( this.#debounceTimer );
-        this.#debounceTimer = setTimeout( func, 500 );
-    }
-
-    static #doSearch() {
-
-        Search.#debounceTimer = undefined;
-
-        const value = document.getElementById( "common-name" ).value.toLowerCase();
-
-        const matches = [];
-        const shouldSearch = ( value.length >= MIN_LEN );
-
-        if ( shouldSearch ) {
-            // eslint-disable-next-line no-undef
-            for ( const key of Object.keys( COMMON_NAMES ) ) {
-                if ( key.includes( value ) ) {
-                    matches.push( key );
-                }
-            }
-        }
-
-        const eBody = document.createElement( "tbody" );
-        if ( matches.length <= MAX_RESULTS ) {
-            for ( const match of matches ) {
-                // eslint-disable-next-line no-undef
-                const data = COMMON_NAMES[ match ];
-                for ( const name of data.names ) {
-                    const tr = document.createElement( "tr" );
-                    const td1 = document.createElement( "td" );
-                    const td2 = document.createElement( "td" );
-                    const link = document.createElement( "a" );
-                    td1.textContent = data.cn;
-                    link.setAttribute( "href", "./" + name.replaceAll( ".", "" ).replaceAll( " ", "-" ) + ".html" );
-                    link.textContent = name;
-                    td2.appendChild( link );
-                    tr.appendChild( td1 );
-                    tr.appendChild( td2 );
-                    eBody.appendChild( tr );
-                }
-            }
-        }
-
-        // Delete current message
-        const eMessage = document.getElementById( "message" );
-        if ( eMessage.firstChild ) {
-            eMessage.removeChild( eMessage.firstChild );
-        }
-        if ( shouldSearch ) {
-            if ( matches.length === 0 ) {
-                eMessage.textContent = "Nothing found.";
-            }
-            if ( matches.length > MAX_RESULTS ) {
-                eMessage.textContent = "Too many results.";
-            }
-        }
-
-        // Delete current results
-        const eTable = document.getElementById( "results" );
-        if ( eTable.firstChild ) {
-            eTable.removeChild( eTable.firstChild );
-        }
-
-        eTable.appendChild( eBody );
-    }
-
-    static #handleChange() {
-        this.#debounce( Search.#doSearch );
-    }
-
-    static init() {
-        const eName = document.getElementById( "common-name" );
-        eName.focus();
-        eName.oninput = ( ev ) => { return this.#handleChange( ev ); };
-    }
-
-}
-
-Search.init();

package/jekyll/common_name_search.html

@@ -1,18 +0,0 @@
----
-title: Common Name Search
-js: common_name_search.js
----
-<h1>Search for Common Name</h1>
-
-<script>
-    const COMMON_NAMES = {% include common_names.json%};
-</script>
-
-<form>
-    <input type="text" id="common-name">
-</form>
-
-<div class="section" id="message"></div>
-
-<table id="results">
-</table>