@ca-plant-list/ca-plant-list 0.3.6 → 0.4.0

package/lib/rareplants.js

@@ -1,60 +1,74 @@
+/** @type {Object<string,string>} */
 const RANK_DESCRIPS = {
     "1A": "Presumed Extirpated or Extinct",
     "1B": "Rare or Endangered",
     "2A": "Extirpated in California",
     "2B": "Rare or Endangered in California",
-    "3": "Needs Review",
-    "4": "Uncommon in California",
+    3: "Needs Review",
+    4: "Uncommon in California",
 };
 
+/** @type {Object<string,string>} */
 const THREAT_DESCRIPS = {
-    "1": "Seriously threatened in California",
-    "2": "Moderately threatened in California",
-    "3": "Not very threatened in California",
+    1: "Seriously threatened in California",
+    2: "Moderately threatened in California",
+    3: "Not very threatened in California",
 };
 
+/** @type {Object<string,string>} */
 const CESA_DESCRIPS = {
-    "CC": "Candidate",
-    "CE": "Endangered",
-    "CR": "Rare",
-    "CT": "Threatened",
+    CC: "Candidate",
+    CE: "Endangered",
+    CR: "Rare",
+    CT: "Threatened",
 };
 
+/** @type {Object<string,string>} */
 const FESA_DESCRIPS = {
-    "FE": "Endangered",
-    "FT": "Threatened",
-    "PE": "Proposed Endangered",
-    "PT": "Proposed Threatened",
-    "FC": "Candidate",
-    "FD": "Delisted",
+    FE: "Endangered",
+    FT: "Threatened",
+    PE: "Proposed Endangered",
+    PT: "Proposed Threatened",
+    FC: "Candidate",
+    FD: "Delisted",
 };
 
 class RarePlants {
-
-    static getCESADescription( cesa ) {
-        if ( !cesa ) {
+    /**
+     * @param {string|undefined} cesa
+     */
+    static getCESADescription(cesa) {
+        if (!cesa) {
             return "";
         }
-        return CESA_DESCRIPS[ cesa ];
+        return CESA_DESCRIPS[cesa];
     }
 
-    static getFESADescription( fesa ) {
-        if ( !fesa ) {
+    /**
+     * @param {string|undefined} fesa
+     */
+    static getFESADescription(fesa) {
+        if (!fesa) {
             return "";
         }
-        return FESA_DESCRIPS[ fesa ];
+        return FESA_DESCRIPS[fesa];
     }
 
-    static getRPIRankDescription( rank ) {
-        const pieces = rank.split( "." );
-        return RANK_DESCRIPS[ pieces[ 0 ] ];
+    /**
+     * @param {string} rank
+     */
+    static getRPIRankDescription(rank) {
+        const pieces = rank.split(".");
+        return RANK_DESCRIPS[pieces[0]];
     }
 
-    static getRPIRankAndThreatDescriptions( rank ) {
-        const pieces = rank.split( "." );
-        return [ RANK_DESCRIPS[ pieces[ 0 ] ], THREAT_DESCRIPS[ pieces[ 1 ] ] ];
+    /**
+     * @param {string} rank
+     */
+    static getRPIRankAndThreatDescriptions(rank) {
+        const pieces = rank.split(".");
+        return [RANK_DESCRIPS[pieces[0]], THREAT_DESCRIPS[pieces[1]]];
     }
-
 }
 
-export { RarePlants };
+export { RarePlants };

package/lib/sitegenerator.js

@@ -6,32 +6,46 @@ import { Files } from "./files.js";
 class SiteGenerator {
     #baseDir;
 
-    constructor( baseDir ) {
+    /**
+     * @param {string} baseDir
+     */
+    constructor(baseDir) {
         this.#baseDir = baseDir;
     }
 
-    copyIllustrations( flowerColors ) {
-        function createFlowerColorIcons( outputDir, flowerColors ) {
+    /**
+     * @param {FlowerColor[]} flowerColors
+     */
+    copyIllustrations(flowerColors) {
+        /**
+         * @param {string} outputDir
+         * @param {FlowerColor[]} flowerColors
+         */
+        function createFlowerColorIcons(outputDir, flowerColors) {
             // Read generic input.
-            const inputFileName = Files.join( outputDir, "flower.svg" );
-            const srcSVG = Files.read( inputFileName );
-            for ( const color of flowerColors ) {
+            const inputFileName = Files.join(outputDir, "flower.svg");
+            const srcSVG = Files.read(inputFileName);
+            for (const color of flowerColors) {
                 Files.write(
-                    Files.join( outputDir, "f-" + color.name + ".svg" ),
-                    srcSVG.replace( "#ff0", color.color )
+                    Files.join(outputDir, "f-" + color.getColorName() + ".svg"),
+                    srcSVG.replace("#ff0", color.getColorCode())
                 );
             }
             // Delete input file.
-            Files.rmDir( inputFileName );
+            Files.rmDir(inputFileName);
         }
 
-        function optimizeSVG( outputDir ) {
-            const srcDir = Config.getPackageDir() + "/data/illustrations/inkscape";
-            const entries = Files.getDirEntries( srcDir );
-            for ( const entry of entries ) {
-                const srcFile = Files.join( srcDir, entry );
-                const srcSVG = Files.read( srcFile );
-                const result = optimize( srcSVG, {
+        /**
+         * @param {string} outputDir
+         */
+        function optimizeSVG(outputDir) {
+            const srcDir =
+                Config.getPackageDir() + "/data/illustrations/inkscape";
+            const entries = Files.getDirEntries(srcDir);
+            for (const entry of entries) {
+                const srcFile = Files.join(srcDir, entry);
+                const srcSVG = Files.read(srcFile);
+                const result = optimize(srcSVG, {
                     plugins: [
                         {
                             name: "preset-default",
@@ -55,24 +69,27 @@ class SiteGenerator {
                         "minifyStyles",
                     ],
                     multipass: true,
-                } );
-                Files.write( Files.join( outputDir, entry ), result.data );
+                });
+                Files.write(Files.join(outputDir, entry), result.data);
             }
         }
 
-        const outputDir = Files.join( this.#baseDir, "i" );
-        Files.mkdir( outputDir );
+        const outputDir = Files.join(this.#baseDir, "i");
+        Files.mkdir(outputDir);
 
-        optimizeSVG( outputDir );
-        createFlowerColorIcons( outputDir, flowerColors );
+        optimizeSVG(outputDir);
+        createFlowerColorIcons(outputDir, flowerColors);
     }
 
     getBaseDir() {
         return this.#baseDir;
     }
 
-    mkdir( path ) {
-        Files.mkdir( Files.join( this.#baseDir, path ) );
+    /**
+     * @param {string} path
+     */
+    mkdir(path) {
+        Files.mkdir(Files.join(this.#baseDir, path));
     }
 }
 

package/lib/taxa.js

@@ -1,15 +1,14 @@
 import { Config } from "./config.js";
-import { HTML } from "./html.js";
 import { CSV } from "./csv.js";
-import { RarePlants } from "./rareplants.js";
-import { Families, Taxon } from "./index.js";
 import { Genera } from "./genera.js";
-import { TextUtils } from "./textutils.js";
+import { Taxon } from "./taxon.js";
+import { Families } from "./families.js";
+import { FlowerColor } from "./flowercolor.js";
 
 const FLOWER_COLORS = [
     { name: "white", color: "white" },
     { name: "red", color: "red" },
-    { name: "pink", color: "pink" },
+    { name: "pink", color: "#ff69b4" },
     { name: "orange", color: "orange" },
     { name: "yellow", color: "yellow" },
     { name: "blue", color: "blue" },
@@ -18,74 +17,6 @@ const FLOWER_COLORS = [
     { name: "brown", color: "brown" },
 ];
 
-/**
- * @type {Object.<string,import("./index.js").TaxaCol>}
- */
-const TAXA_LIST_COLS = {
-    CESA: {
-        title: "California",
-        data: (t) => RarePlants.getCESADescription(t.getCESA()),
-    },
-    COMMON_NAME: {
-        title: "Common Name",
-        data: (t) => t.getCommonNames().join(", "),
-    },
-    CNPS_RANK: {
-        title: "CNPS Rank",
-        data: (t) =>
-            HTML.getToolTip(
-                HTML.textElement("span", t.getRPIRankAndThreat()),
-                t.getRPIRankAndThreatTooltip()
-            ),
-    },
-    FESA: {
-        title: "Federal",
-        data: (t) => RarePlants.getFESADescription(t.getFESA()),
-    },
-    SPECIES: {
-        title: "Species",
-        data: (t) => t.getHTMLLink(true, true),
-    },
-    SPECIES_BARE: {
-        title: "Species",
-        data: (t) => t.getHTMLLink(true, false),
-    },
-};
-
-const DEFAULT_COLUMNS = [TAXA_LIST_COLS.SPECIES, TAXA_LIST_COLS.COMMON_NAME];
-
-class FlowerColor {
-    #color;
-    /** @type {Taxon[]} */
-    #taxa = [];
-
-    /**
-     * @param {string} color
-     */
-    constructor(color) {
-        this.#color = color;
-    }
-
-    /**
-     * @param {Taxon} taxon
-     */
-    addTaxon(taxon) {
-        this.#taxa.push(taxon);
-    }
-
-    getColorName(uc = false) {
-        return uc ? TextUtils.ucFirst(this.#color) : this.#color;
-    }
-
-    getFileName() {
-        return "list_fc_" + this.#color + ".html";
-    }
-
-    getTaxa() {
-        return this.#taxa;
-    }
-}
-
 class Taxa {
     #families;
     #errorLog;
@@ -98,21 +29,18 @@ class Taxa {
     #isSubset;
 
     /**
-     *
-     * @param {*} inclusionList
+     * @param {Object<string,TaxonData>|true} inclusionList
      * @param {ErrorLog} errorLog
-     * @param {*} showFlowerErrors
-     * @param {*} taxaMeta
-     * @param {*} taxonClass
-     * @param {*} extraTaxa
-     * @param {*} extraSynonyms
+     * @param {boolean} showFlowerErrors
+     * @param {function(TaxonData,Genera):Taxon} taxonFactory
+     * @param {TaxonData[]} [extraTaxa=[]]
+     * @param {SynonymData[]} [extraSynonyms=[]]
      */
     constructor(
         inclusionList,
         errorLog,
         showFlowerErrors,
-        taxaMeta = {},
-        taxonClass = Taxon,
+        taxonFactory = (td, g) => new Taxon(td, g),
         extraTaxa = [],
         extraSynonyms = []
     ) {
@@ -129,18 +57,11 @@ class Taxa {
         this.#families = new Families();
 
         const taxaCSV = CSV.parseFile(dataDir, "taxa.csv");
-        this.#loadTaxa(
-            taxaCSV,
-            inclusionList,
-            taxaMeta,
-            taxonClass,
-            showFlowerErrors
-        );
+        this.#loadTaxa(taxaCSV, inclusionList, taxonFactory, showFlowerErrors);
         this.#loadTaxa(
             extraTaxa,
             inclusionList,
-            taxaMeta,
-            taxonClass,
+            taxonFactory,
             showFlowerErrors
         );
 
@@ -160,54 +81,14 @@ class Taxa {
         this.#loadSyns(extraSynonyms, inclusionList);
     }
 
-    /**
-     * @param {Taxon[]} taxa
-     * @param {import("./index.js").TaxaCol[]} columns
-     */
-    static getHTMLTable(taxa, columns = DEFAULT_COLUMNS) {
-        let html = "<table><thead>";
-        for (const col of columns) {
-            const className = col.class;
-            const atts = className ? { class: className } : {};
-            html += HTML.textElement("th", col.title, atts);
-        }
-        html += "</thead>";
-        html += "<tbody>";
-
-        for (const taxon of taxa) {
-            html += "<tr>";
-            for (const col of columns) {
-                const data = col.data(taxon);
-                const className = col.class;
-                const atts = className ? { class: className } : {};
-                html += HTML.wrap("td", data, atts);
-            }
-            html += "</tr>";
-        }
-
-        html += "</tbody>";
-        html += "</table>";
-
-        return html;
-    }
-
     getFamilies() {
         return this.#families;
     }
 
-    /**
-     * @param {string} name
-     */
-    getFlowerColor(name) {
-        return this.#flower_colors[name];
-    }
-
-    static getFlowerColorNames() {
-        return FLOWER_COLORS.map((o) => o.name);
-    }
-
-    static getFlowerColors() {
-        return FLOWER_COLORS;
+    getFlowerColors() {
+        return Object.values(this.#flower_colors).filter(
+            (fc) => fc.getTaxa().length > 0
+        );
     }
 
     /**
@@ -237,8 +118,8 @@ class Taxa {
     }
 
     /**
-     * @param {*} synCSV
-     * @param {*} inclusionList
+     * @param {SynonymData[]} synCSV
+     * @param {Object<string,TaxonData>|boolean} inclusionList
      */
     #loadSyns(synCSV, inclusionList) {
         for (const syn of synCSV) {
@@ -259,15 +140,17 @@ class Taxa {
     }
 
     /**
-     * @param {import("./index.js").TaxonData[]} taxaCSV
-     * @param {Taxon} taxonClass
+     * @param {TaxonData[]} taxaCSV
+     * @param {Object<string,TaxonData>|true} inclusionList
+     * @param {function(TaxonData,Genera):Taxon} taxonFactory
      * @param {boolean} showFlowerErrors
      */
-    #loadTaxa(taxaCSV, inclusionList, taxaMeta, taxonClass, showFlowerErrors) {
+    #loadTaxa(taxaCSV, inclusionList, taxonFactory, showFlowerErrors) {
         const genera = new Genera(this.#families);
         for (const row of taxaCSV) {
             const name = row["taxon_name"];
 
+            /** @type {TaxonData|{status?:string}} */
             let taxon_overrides = {};
             if (inclusionList !== true) {
                 taxon_overrides = inclusionList[name];
@@ -284,7 +167,7 @@ class Taxa {
             if (status !== undefined) {
                 row["status"] = status;
             }
-            const taxon = new taxonClass(row, genera, taxaMeta[name]);
+            const taxon = taxonFactory(row, genera);
             this.#taxa[name] = taxon;
             const colors = taxon.getFlowerColors();
             if (colors) {
@@ -329,4 +212,4 @@ class Taxa {
     }
 }
 
-export { Taxa, TAXA_LIST_COLS };
+export { Taxa };

package/lib/taxon.js

@@ -1,7 +1,5 @@
-import { HTML } from "./index.js";
+import { HTML } from "./html.js";
 import { RarePlants } from "./rareplants.js";
-// eslint-disable-next-line no-unused-vars
-import { Genera } from "./genera.js";
 
 const TAXA_COLNAMES = {
     BLOOM_START: "bloom_start",
@@ -38,7 +36,7 @@ class Taxon {
     #synonyms = [];
 
     /**
-     * @param {import("./index.js").TaxonData} data
+     * @param {TaxonData} data
      * @param {Genera} genera
      */
     constructor(data, genera) {
@@ -151,7 +149,7 @@ class Taxon {
     }
 
     getFamily() {
-        return this.#genera.getFamily(this.#genus);
+        return this.getGenus().getFamily();
     }
 
     getFESA() {

package/lib/web/glossarypages.js

@@ -1,46 +1,66 @@
-import { Files, HTML } from "@ca-plant-list/ca-plant-list";
 import { Glossary } from "../plants/glossary.js";
 import { Markdown } from "../markdown.js";
+import { HTML } from "../html.js";
+import { Files } from "../files.js";
 
 const ENTRY_DIR = "g";
 
 class GlossaryPages {
-
     #siteGenerator;
     #glossary;
 
-    constructor( siteGenerator ) {
+    /**
+     * @param {SiteGenerator} siteGenerator
+     */
+    constructor(siteGenerator) {
         this.#siteGenerator = siteGenerator;
         this.#glossary = new Glossary();
     }
 
-    #generateEntryPage( entry ) {
+    /**
+     * @param {GlossaryEntry} entry
+     */
+    #generateEntryPage(entry) {
         const title = entry.getTermName();
-        let html = HTML.textElement( "h1", title );
-        html += HTML.wrap( "div", Markdown.strToHTML( entry.getMarkdown() ), { class: "glossary" } );
-        this.#siteGenerator.writeTemplate( html, { title: title }, Files.join( ENTRY_DIR, title + ".html" ) );
+        let html = HTML.textElement("h1", title);
+        html += HTML.wrap("div", Markdown.strToHTML(entry.getMarkdown()), {
+            class: "glossary",
+        });
+        this.#siteGenerator.writeTemplate(
+            html,
+            { title: title },
+            Files.join(ENTRY_DIR, title + ".html")
+        );
     }
 
     #generateEntryPages() {
-
         // Make sure output directory exists.
-        this.#siteGenerator.mkdir( ENTRY_DIR );
+        this.#siteGenerator.mkdir(ENTRY_DIR);
 
         const entries = this.#glossary.getEntries();
-        for ( const entry of entries ) {
-            this.#generateEntryPage( entry );
+        for (const entry of entries) {
+            this.#generateEntryPage(entry);
         }
     }
 
     #generateIndexPage() {
         const links = [];
         const entries = this.#glossary.getEntries();
-        for ( const entry of entries ) {
-            links.push( HTML.getLink( Files.join( ENTRY_DIR, entry.getHTMLFileName() ), entry.getTermName() ) );
+        for (const entry of entries) {
+            links.push(
+                HTML.getLink(
+                    Files.join(ENTRY_DIR, entry.getHTMLFileName()),
+                    entry.getTermName()
+                )
+            );
         }
-        let html = HTML.wrap( "h1", "Glossary" );
-        html += HTML.wrap( "ol", HTML.arrayToLI( links ) );
-        this.#siteGenerator.writeTemplate( html, { title: "Glossary" }, "glossary.html" );
+        let html = HTML.wrap("h1", "Glossary");
+        html += HTML.wrap("ol", HTML.arrayToLI(links));
+        this.#siteGenerator.writeTemplate(
+            html,
+            { title: "Glossary" },
+            "glossary.html"
+        );
     }
 
     getGlossary() {
@@ -51,7 +71,6 @@ class GlossaryPages {
         this.#generateIndexPage();
         this.#generateEntryPages();
     }
-
 }
 
-export { GlossaryPages };
+export { GlossaryPages };

package/lib/web/pagetaxon.js

@@ -3,10 +3,6 @@ import { RarePlants } from "../rareplants.js";
 import { GenericPage } from "../genericpage.js";
 import { ExternalSites } from "../externalsites.js";
 import { HTML } from "../html.js";
-// eslint-disable-next-line no-unused-vars
-import { Config } from "../config.js";
-// eslint-disable-next-line no-unused-vars
-import { Taxon } from "../taxon.js";
 import { HTMLTaxon } from "../htmltaxon.js";
 
 class PageTaxon extends GenericPage {
@@ -178,7 +174,7 @@ class PageTaxon extends GenericPage {
 
         html += "</div>";
 
-        html += HTMLTaxon.getFlowerInfo(this.#taxon);
+        html += HTMLTaxon.getFlowerInfo(this.#taxon, undefined, false);
 
         html += this.getMarkdown();
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ca-plant-list/ca-plant-list",
-    "version": "0.3.6",
+    "version": "0.4.0",
     "description": "Tools to create Jekyll files for a website listing plants in an area of California.",
     "license": "MIT",
     "repository": {
@@ -20,8 +20,7 @@
     "dependencies": {
         "@ca-plant-list/tools": "file:../ca-tools",
         "archiver": "^5.3.1",
-        "command-line-args": "^5.2.1",
-        "command-line-usage": "^6.1.3",
+        "commander": "^12.1.0",
         "csv-parse": "^5.3.1",
         "image-size": "^1.1.1",
         "markdown-it": "^13.0.1",
@@ -30,8 +29,11 @@
         "unzipper": "^0.10.11"
     },
     "devDependencies": {
+        "@types/archiver": "^6.0.2",
+        "@types/markdown-it": "^14.1.2",
         "@types/node": "^18.11.9",
         "@types/unzipper": "^0.10.9",
+        "ajv-cli": "^5.0.0",
         "dts-bundle-generator": "^9.3.1",
         "eslint": "^8.26.0",
         "typescript": "^5.3.3"

package/schemas/exceptions.schema.json

@@ -0,0 +1,57 @@
+{
+    "type": "object",
+    "additionalProperties": {
+        "type": "object",
+        "properties": {
+            "calflora": {
+                "type": "object",
+                "properties": {
+                    "badjepsonid": {
+                        "const": true
+                    },
+                    "notintaxondata": {
+                        "const": true
+                    }
+                },
+                "additionalProperties": false
+            },
+            "comment": {
+                "type": "string"
+            },
+            "inat": {
+                "type": "object",
+                "properties": {
+                    "notintaxondata": {
+                        "const": true
+                    }
+                },
+                "additionalProperties": false
+            },
+            "jepson": {
+                "type": "object",
+                "properties": {
+                    "allowsynonym": {
+                        "const": true
+                    },
+                    "notineflora": {
+                        "const": true
+                    }
+                },
+                "additionalProperties": false
+            },
+            "rpi": {
+                "type": "object",
+                "properties": {
+                    "translation": {
+                        "type": "string"
+                    },
+                    "translation-to-rpi": {
+                        "type": "string"
+                    }
+                },
+                "additionalProperties": false
+            }
+        },
+        "additionalProperties": false
+    }
+}