textbrowser 0.40.1 → 0.41.1

package/.editorconfig

@@ -17,3 +17,6 @@ trim_trailing_whitespace = true
 
 [*.md]
 indent_size = 4
+
+[*.{json,jsonschema}]
+indent_size = 4

package/.eslintrc.js

@@ -15,6 +15,7 @@ module.exports = {
       'document.dir',
       'document.querySelector',
       'document.querySelectorAll',
+      'document.title',
       'DOMParser',
       'Error',
       'fetch',

package/.ncurc.js

@@ -0,0 +1,8 @@
+'use strict';
+
+module.exports = {
+  reject: [
+    // Wait until making this package ESM and ESM-only
+    'node-fetch'
+  ]
+};

package/CHANGES.md

@@ -1,5 +1,36 @@
 # textbrowser CHANGES
 
+## 0.41.1
+
+- fix: fix dialog polyfill CSS link
+- refactor: make array-of-arrays schema more precise
+- refactor: make table.jsonschema more precise
+- refactor: drop redundant locale file listing in sample service worker
+- chore: update `.editorconfig`, devDeps. and deps. (babel-related,
+    `command-line-args`)
+
+## 0.41.0
+
+- feat: factor out undocumented Bahá'í Writings-specific bookmark generator
+    to new generic `preferencesPlugin` option
+
+## 0.40.3
+
+### User-facing
+
+- fix: clear out extra query string, e.g., from Facebook when querying for
+    metadata file
+- chore: update deps.
+
+### Dev-facing
+
+- chore: lint and add ncurc.js
+- chore: update devDeps.
+
+## 0.40.2
+
+- Fix: Add ESM `dist` versions for `activateCallback` and `WorkInfo`
+
 ## 0.40.1
 
 - npm: Bump `indexeddbshim`

package/README.md

@@ -680,6 +680,11 @@ as a `npm` dependency).
         This section might be changed to a plugin in the future in which case
         you'd just avoid designating it within `files.json`.
 
+    -   `preferencesPlugin` - A function to be passed the following arguments
+        and to return a Jamilih array: `$`, `l`, `jml`, `paramsSetter`,
+        `getDataForSerializingParamsAsURL`, `work`, `replaceHash`,
+        `getFieldAliasOrNames`
+
     -   `interlinearSeparator` - HTML code to be injected between each
         interlinear entry; this is not exposed to the user for
         security reasons (preventing [cross-site scripting](https://en.wikipedia.org/wiki/Cross-site_scripting)
@@ -736,7 +741,10 @@ it supports the following arguments:
 
 ## To-dos (Highest priority)
 
-0.  Progressive web app? / Electron?
+1.  Document and add **screen-casts** along with one for developers showing
+    JSON format, metadata, and schemas); also use with shortcuts (including
+    Bahá'í Library Online ones)
+1.  Progressive web app? / Electron?
 1.  Adapt approach of <https://suttacentral.net/offline> in providing form for
     choice of items to offline (also add to individual work pages).
 1.  Mention idea that it works offline
@@ -751,12 +759,10 @@ it supports the following arguments:
 1.  Ensure works with `pnpm` in all environments (didn't work when deployed,
     but would need to recall the problem and resolve)
 1.  Simplify `languages.json` by using `Intl.DisplayNames` (`type: 'language'`)
-    to localize language names (and can avoid direction if [intl-locale-info proposal](https://github.com/tc39/proposal-intl-locale-info) is
-    implemented); consider using with plugins so can, e.g., show language
+    to localize language names (and can avoid direction if
+    [intl-locale-info proposal](https://github.com/tc39/proposal-intl-locale-info)
+    is implemented); consider using with plugins so can, e.g., show language
     visibly into which a targeted content language field was translated
-1.  Document and add screen-casts along with one for developers showing
-    JSON format, metadata, and schemas); also use with shortcuts (including
-    Bahá'í Library Online ones)
 1.  For plugins, allow export of `stylesheets` array to add to
     `loadStylesheets`, so they don't have to do the importing and executing.
 1.  **Progress meter** with hidden console to avoid intimidating loading
@@ -777,7 +783,7 @@ it supports the following arguments:
     1. Fix limitation that 0's don't change to 1's if
         not present as a minimum (e.g., if no 0 for Chapter
         number, then won't show anything).
-    1. Avoid need for separate `startEnd` for browse set;
+    1. Avoid need for separate `<work name>-startEnd` for browse set;
         e.g., parse Rodwell or Sale?
     1. Ideally work across even book
     1. Support anchor portion (e.g., `1:2:3-1:2:5#1:2:4`)
@@ -785,6 +791,7 @@ it supports the following arguments:
     `activateCallback.js`
 1.  Have **IndexedDB handle all pages** language select, work select, and
     work display be part of too?
+    1.  `indexedDB` for JSON data
 1.  **Node.js** (or PHP?)
     1.  Delivery of HTML content by same URL so third parties can
         consume without JavaScript and optimized when not offline
@@ -910,7 +917,9 @@ it supports the following arguments:
             and/or syntax (generic to *TextBrowser* and/or canonical, ideally
             human-readable based on JSON-supplied information; e.g., for the
             Bible, `Matt. 5:10-12`); use with `postMessage` to-do to supply
-            syntax back to another site
+            syntax back to another site; see
+            [Scroll To Text fragment](https://wicg.github.io/ScrollToTextFragment/);
+            [Stack answer](https://stackoverflow.com/a/62162093/271577)
         1.  Correct any field easily by links within TB to editing interface
         1.  Add an "overlay" column like interlinear, but which overlays by
             tooltip if any data is present; can also use metadata if the
@@ -966,11 +975,13 @@ it supports the following arguments:
         <https://github.com/json-schema-org/json-schema-spec/issues/587#issuecomment-389726603>
         by using initial `$`?
 1.  Find way to avoid need for `!important` in column CSS
-1.  Offer more border styling tuning controls (including right/left/top/bottom,
+1.  Redirect automatically by accepted language, though have a link or
+    preference to change the default
+1.  Offer more **border styling** tuning controls (including right/left/top/bottom,
     color, etc.); then offer this along with other styles if we replace CSS
     input box with pop-up styling form (like Advanced Formatting, but for columns)
-1.  Refactoring: Try to use `deserialize` of `form-serialization` fork for initial population
-    or hash change?
+1.  Refactoring: Try to use `deserialize` of `form-serialization` fork for
+    initial population or hash change? (if not `FormData`)
 1.  We should try to allow `onByDefault` and `placement` for non-plugin
     fields also
 1.  [ES6 Modules in browser](https://jakearchibald.com/2017/es-modules-in-browsers/):
@@ -1035,6 +1046,8 @@ it supports the following arguments:
 
 ## To-dos (Medium Priority)
 
+1.  Build "Preferred language(s)" to use awareness of content languages rather
+    than locales.
 1.  Remove need for separate metadata
     files per
     <https://github.com/json-schema-org/json-schema-spec/issues/587#issuecomment-389726603>
@@ -1044,8 +1057,8 @@ it supports the following arguments:
     with multiselect
 1.  Preview styling changes (or move all controls to results page for
     immediate real feedback)
-1.  Separate formatting within Jamilih code to CSS; unit test and performance
-    by being able to use a natively stringifying version of Jamilih
+1.  Separate **formatting within Jamilih code** to CSS; unit test and
+    performance by being able to use a natively stringifying version of Jamilih
     (once complete)
 1.  Utilize meta-data properties, `primary_text_field`, `orig_lang_field`,
     `orig_langs`, e.g., to allow for user to display main language and
@@ -1105,7 +1118,7 @@ it supports the following arguments:
 
 1.  Waiting: Avoid superagent warning:
     <https://github.com/whitlockjc/path-loader/issues/17>
-1.  Remember columns enabled, etc. since last visit, and/or saved as
+1.  **Remember columns enabled**, etc. since last visit, and/or saved as
     preferences.
 1.  Allow copy-pasting a search as a custom web protocol (make
     site-configurable), e.g., to support `web+bahaiwritings:` links per
@@ -1124,8 +1137,6 @@ it supports the following arguments:
         1.  Preference to remember enabled checkboxes and formatting
 1.  Change to utilize history.pushState?
     <https://developer.mozilla.org/en-US/docs/Web/API/History_API>
-1.  Use ES6 modules (babel)
-    1.  dynamic or hierarchical loading of CSS too?
 1.  Sort file selection listing per locale?
 1.  Node.js synchronization of locale files?
 1.  Could allow Node to built schemas, optionally allowing or disallowing
@@ -1142,7 +1153,6 @@ it supports the following arguments:
     the i18n of "lang"?).
 1.  `window.postMessage` API (since CORS is only for Ajax and
     `document.domain` is only for subdomains).
-1.  `indexedDB` for JSON data
 1.  Restore `tabindex` usage
 1.  Restore option from work page to have a checkbox on whether to go to
     "Advanced mode", opening the styling options by default or not.