textbrowser 0.45.1 → 0.46.0

package/.eslintrc.cjs

@@ -7,6 +7,9 @@ module.exports = {
     requireConfigFile: false
   },
   settings: {
+    jsdoc: {
+      mode: 'typescript'
+    },
     polyfills: [
       'Array.isArray',
       'Blob',

package/CHANGES.md

@@ -1,5 +1,18 @@
 # CHANGES to `textbrowser`
 
+## 0.46.0
+
+- BREAKING chore: require Node 14.19.1+
+- feat: routine to utilize updated `json-refs`
+- feat: `imf` -> `intl-dom`
+- refactor: linting/TS fixes
+- chore: update babel/core, indexeddbshim, jsdom, babel/core deps.
+- chore: update devDeps.
+
+## 0.45.2
+
+- fix: issue with `next`
+
 ## 0.45.1
 
 - fix: issue with `next`

package/README.md

@@ -6,7 +6,9 @@ potentially intimidating to those unfamiliar with how to work it. There are
 also some bugs to iron out such as with localization.*
 
 See the [web app within an app using TextBrowser](https://bahai-browser.org/)
-or see some videos [introducing the app](https://bahai-library.com/zamir_textbrowser_bahaiwritings_browser).
+or see some videos [introducing the app](https://bahai-library.com/zamir_textbrowser_bahaiwritings_browser). For use with [shortcuts](https://bahai-library.com/zamir_efficient_searches_shortcuts),
+see the [video](https://bahai-library.com/zamir/shortcuts/Efficient-Searches-and-Shortcuts-5-SD-480p.webm)
+at 5:25.
 
 *TextBrowser* supports power-user browsing of arbitrary multi-linear
 texts following the "offline first" motto.
@@ -567,7 +569,7 @@ methods.
     the plug-in (from `files.json`). `applicableFieldLang` is the default
     lang when there is no target language or plugin lang; it is the `lang`
     of the applicable field.
-- `getFieldAliasOrName({locales, lf, targetLanguage, applicableField, applicableFieldI18N, meta, metaApplicableField, targetLanguageI18N})` -
+- `getFieldAliasOrName({locales, workI18n, targetLanguage, applicableField, applicableFieldI18N, meta, metaApplicableField, targetLanguageI18N})` -
     Called for each plug-in (after `getTargetLanguage`). Sets the `fieldInfo`
     `fieldAliasOrName` which is used for labeling the field. Besides
     properties shared with other methods, `getFieldAliasOrName` is passed
@@ -575,8 +577,8 @@ methods.
     - `locales` - The app `lang` array (URL-specified `lang` languages or
         fallback-specified ones from `navigator.languages` that are
         supported by the app)
-    - `lf` - An [imf](https://github.com/brettz9/imf) locale formatter based
-        on `files.json` locale strings.
+    - `workI18n` - An [intl-dom](https://github.com/brettz9/intl-dom) locale
+        formatter based on `files.json` locale strings.
     - `applicableFieldI18N` - The localized metadata `fieldnames` `applicableField`
     - `targetLanguageI18N` - The localized name of `targetLanguage`
     - `targetLanguage` - The result of `getTargetLanguage` (or the
@@ -745,9 +747,6 @@ it supports the following arguments:
 
 ## To-dos (Highest priority)
 
-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).
@@ -758,15 +757,15 @@ it supports the following arguments:
     1. Also have `&checked1=Yes` omitted when generating results display
         (since now defaulting to this)
     1.  Drop unused fields in URL by default
-1.  Switch from IMF i18n to [intl-dom](https://github.com/brettz9/intl-dom) and
-    as needed [i18nizeElement](https://github.com/brettz9/i18nizeElement)
 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
+1.  Waiting: Avoid `rtl-detect` 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
+    gets implemented)
+1.  [`navigator.storage.estimate`](https://developers.google.com/web/updates/2017/08/estimating-available-storage-space)
+1.  Consider using `Intl.DisplayNames` (`type: 'language'`) with plugins so
+    can, e.g., show language visibly into which a targeted content language
+    field was translated? Avoid need for `languages.json` codes and directions?
 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
@@ -1120,8 +1119,13 @@ it supports the following arguments:
 
 ## To-dos (Lower priority)
 
-1.  Waiting: Avoid superagent warning:
-    <https://github.com/whitlockjc/path-loader/issues/17>
+1.  Use or publish [rollup-plugin-postprocess](git+https://github.com/brettz9/rollup-plugin-postprocess.git#update)
+    as stable version?
+1.  Check if still getting superagent warning:
+    <https://github.com/whitlockjc/path-loader/issues/17> (if `json-refs` can
+    be updated to stable version)
+1.  Use [i18nizeElement](https://github.com/brettz9/i18nizeElement)? (probably
+    not as need RTL detection for more than setting on element)
 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