ansimax 1.0.0 → 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,274 @@
+# Changelog
+
+All notable changes to **ansimax** are documented in this file.
+This project follows [Semantic Versioning](https://semver.org/).
+
+## [1.1.1] — bug fixes + improved examples
+
+Patch release with two bug fixes from real-world testing of v1.1.0, plus
+a cleaner set of examples covering every public API.
+
+### Fixed
+
+- **`box()` no longer crashes with object padding.** Previously, calling
+  `box(text, { padding: { x: 2, y: 1 } })` threw `RangeError: Invalid
+  array length` because the code assumed `padding` was always a number.
+  Now non-numeric padding falls back to the default (`1`) gracefully.
+  The fix also covers `NaN`, `Infinity`, strings, and other malformed
+  input.
+- **`components.menu()` cursor restoration on abrupt exit.** Previously,
+  killing the process while a menu was active (Ctrl+C, kill signal)
+  left the terminal cursor hidden because the cleanup handler only ran
+  through the normal menu lifecycle. Now `SIGINT`, `SIGTERM`, and
+  `exit` events trigger an emergency cursor restoration, so the terminal
+  is always left in a sane state.
+
+### Changed — Examples
+
+- Replaced all examples in `/examples` with a clean set covering every
+  public API:
+  - `01-quick-smoke.ts` — verifies major imports
+  - `02-colors-gradients.ts` — color fns, gradients, `colorPresets`
+  - `03-ascii-banners.ts` — banners + 6 box styles + dividers
+  - `04-trees.ts` — builder + plain-data + 4 styles + algorithms
+  - `05-components.ts` — tables, badges, status, timeline, etc.
+  - `06-pixel-art.ts` — sprites + canvas + transforms
+  - `07-animations.ts` — typewriter, fade, slide, pulse, wave, glitch
+  - `08-loaders.ts` — spinners + tasks + countdown
+  - `09-themes.ts` — 8 themes + listeners + isolation
+  - `10-everything.ts` — comprehensive showcase
+  - `all-in-one.mjs` — ESM (`import`) version, no TypeScript
+  - `all-in-one.cjs` — CommonJS (`require`) version, no TypeScript
+- All examples now import from `'ansimax'` (npm registry) instead of
+  `'../src/index.js'`, making them copy-pasteable into user projects.
+- READMEs updated with animations + loaders preview GIFs in the
+  header, and an `all-ansimax.gif` showcase near the footer.
+
+### Notes
+
+- No API changes — `1.1.1` is a drop-in replacement for `1.1.0`.
+- No new dependencies — still zero runtime deps.
+- All 1848 tests still pass.
+
+---
+
+## [1.1.0] — comprehensive hardening + new features
+
+A massive robustness pass across every module, plus a new `trees` module,
+new API surfaces, and broader test coverage (~1700+ tests across 16 suites).
+
+**Backwards compatibility:** 100% preserved. All existing APIs work
+identically — only defensive validation, new features, and bug fixes.
+
+---
+
+### Added — Trees (`trees/index.ts`) — NEW MODULE
+
+Hierarchical text renderer inspired by Rich's `Tree`.
+
+- **Builder API** — `tree('root').add('child').add('grandchild')`. `addLeaf()` returns the parent for fluent sibling-adds.
+- **Plain-data API** — `renderTree({ label, children: [...] })` accepts any plain JS object.
+- **4 visual styles** — `'normal'`, `'rounded'` (╰─), `'heavy'` (┣━), `'ascii'` (`+--`). Per-node `style` override mixes styles in one tree.
+- **Per-node colors** — `color: ColorFn` colorizes the label.
+- **Depth-based palette** — `palette: [color1, color2, ...]` cycles colors per depth level. Per-node `color` overrides.
+- **Guide-line colors** — `guideColor` colorizes the `├──`/`│`/`└──` chars separately from labels.
+- **Per-node icons** — `icon: '📁'` renders before the label.
+- **Multi-line labels** — extra lines align with proper continuation glyph. CRLF normalized to LF.
+- **Collapsed subtrees** — `collapse: N` hides the first N children, shows `[+N hidden]`.
+- **Max depth truncation** — `maxDepth` truncates deep trees, shows `[+N more]` markers.
+- **Indent option** — pad the entire tree with N leading spaces.
+- **`renderTreeStream(root, opts)`** — generator that yields one rendered line at a time.
+- **`measureTree(root, opts)`** — `{ width, height }` for layout decisions.
+- **`walkTree(root, visitor)`** — depth-first traversal with cycle detection.
+- **`findInTree(root, predicate)`** — locate first matching node.
+- **`countNodes(root)`** — total node count.
+- **`mapTree(root, fn)`** — transform every node, returns new tree (input untouched).
+- **`filterTree(root, predicate, opts?)`** — keep matching nodes with optional `prune` mode.
+- **Cycle detection** — `walkTree` / `mapTree` throw a clear error on circular references instead of stack overflow.
+- **Strict validation** — non-string labels coerced, null/array root rejected.
+
+### Added — Configuration (`configure.ts`)
+
+- **`onConfigKeyChange(key, listener)`** — subscribe to changes of a specific config key only. Listener fires with `(newValue, oldValue)`.
+- **`pauseListeners()`/`resumeListeners()`** — batch multiple updates without flooding subscribers; resume flushes a single notification.
+- **`withConfig(overrides, fn)`** — temporarily override config for a sync or async block, restoring previous state automatically (even on throw).
+- **`strict` mode** — `configure(opts, { strict: true })` rejects unknown keys with `RangeError`; useful for catching typos in config files.
+- **`DEFAULTS` exported** — `Object.freeze`d, accessible to consumers as `CONFIG_DEFAULTS`.
+- **No-op detection** — `configure({})` or setting unchanged values no longer fires listeners.
+- **Soft theme fallback** — uses `themes.tryUse` instead of `themes.use` so configure() doesn't throw on themes registered later.
+- **Validation hardening** — `null`/array opts rejected, empty-string `theme`/`locale`/`asciiFont` rejected.
+
+### Added — Colors (`colors/index.ts`)
+
+- **Adaptive escape cache** — `_fgEscCache` / `_bgEscCache` packed-RGB keyed, bounded LRU (512 entries). Gradient animations now 10–50× faster on repeated colors.
+- **`clearColorCache()`** exported for tests and post-level-change cleanup.
+- **`registerPreset(name, stops)`** — register custom gradient presets accessible via `color.<name>`.
+- **`listPresets()`** — runtime list of available presets.
+- **Reserved-preset guard** — registering presets with names like `bold`, `red`, `gradient` throws with a clear conflict message.
+- **Text coercion** — `color.red(42)` now returns `"\x1b[31m42\x1b[0m"` (chalk/kleur compatibility).
+- **NaN/Infinity-safe RGB** — `Infinity → 255`, `-Infinity → 0`, `NaN → 0` in `clampRgb`/`clamp256`.
+- **`compose` filters non-functions** — `compose(red, null, bold)` works (null silently ignored).
+- **`compose` swallows extractor errors** — user fns that throw on `extractOpen` skipped.
+- **`gradient` single-stop colors statically** — consistent with CSS `linear-gradient` UX.
+- **`gradient` defensive** — null/undefined/empty stops return text unchanged. Non-string text coerced. Grapheme iteration preserves emoji.
+- **Bare `\x1b` literal in gradient** — malformed ANSI doesn't corrupt output.
+
+### Added — Themes (`themes/index.ts`)
+
+- **Per-instance isolation** — `createTheme()` instances have their own registry. Registering a theme on one no longer leaks into others. Critical for multi-tenant SSR.
+- **`tryUse(name)`** — tolerant theme switch returning `boolean` instead of throwing.
+- **`onChange(listener)`** — subscribe to theme changes, returns unsubscribe. Errors swallowed.
+- **`unregister(name)`** — remove themes, throws if removing the active one.
+- **Background color helpers** — `bgPrimary`, `bgSecondary`, `bgAccent`, `bgSuccess`, `bgWarning`, `bgError`, `bgInfo`, `bgMuted`, `bgSurface`.
+- **`success` color with fallback** — built-ins define it; user themes without `success` fall back to `accent`.
+- **`style(name)` dynamic accessor** — `theme.style('primary')(text)` for config-driven styling. Identity fn for unknown names (no throw).
+- **HEX_RE consistent** — `#` optional, matches colors module.
+- **Strict validation** — `register()` rejects non-string/empty names, null/array defs, non-array gradient, short gradient (< 2 stops).
+- **`BannerOpts` interface** — explicit type instead of fragile `Omit<Parameters<...>>` derivation.
+
+### Added — Animations (`animations/index.ts`)
+
+- **Crash-safe cursor restore** — `exit/SIGINT/SIGTERM` handlers force-restore cursor even on uncaught exceptions.
+- **Reference-counted `hideCursor`/`showCursor`** — concurrent animations don't reveal the cursor early.
+- **`animate.delay(ms)` helper** — compatible with `sequence`/`chain`. Pause respecting signal.
+- **`animate.parallel({ timeout })`** — race steps against a timeout to prevent hangs.
+- **`animate.parallel` swallows per-step errors** — one failing step doesn't reject the whole Promise.all.
+- **Signal propagation** — parallel steps receive the parent signal.
+- **`wave` with single color** — renders statically with that color (better UX than skip).
+- **`wave` with empty palette** — renders plain.
+- **`reveal` with `steps` option** — scales with text length by default (`Math.min(60, Math.max(10, len*2))`).
+- **`pulse`/`glitch` final write use `safeWriteAsync`** — backpressure-aware.
+- **`safeWriteAsync`/`safeWrite`** wrappers swallow stream errors.
+- **Hooks errors swallowed** — `onFrame`/`onDone`/`onAbort` errors don't break the loop.
+
+### Added — ASCII (`ascii/index.ts`)
+
+- **Strict input validation** — `ensureString()` throws `TypeError` with clear messages for non-string text.
+- **`ensureFontMap` validates type** — rejects null/array/non-object font maps.
+- **`hasFont(name)`** — check if a font is registered without throwing.
+- **`measure(text, font?, letterSpacing?)`** — get `{ width, height }` without paying full render cost.
+- **`stream(text, { signal })`** — pre-aborted yields nothing; aborted mid-stream stops at next poll.
+- **Cache key uses `\u0001` separator** — eliminates collision risk from font names containing `|`.
+- **Grapheme iteration** in `renderFont` — preserves surrogate pairs and emoji.
+- **`box`/`divider`/`logo` defensive** against -Infinity from `Math.max([])`, width 0, empty text.
+- **`colorEachVisibleChar` bare `\x1b` literal** — non-CSI escapes emitted instead of consumed.
+
+### Added — Loaders (`loaders/index.ts`)
+
+- **`spin` coerces non-string text/prefix/suffix**.
+- **`spin` clamps NaN interval** to default 80.
+- **`progress` clamps NaN/Infinity percent** to 0.
+- **`progress` empty-char fallback**.
+- **`countdown(NaN)` → 0**, negative → 0.
+- **`tasks(non-array)` → `[]`** instead of crash.
+
+### Added — Frames (`frames/index.ts`)
+
+- **Reference-counted cursor** — concurrent `play()` + `live()` + animations safe.
+- **`registerCrashHandlers()`** — restore cursor on exit/SIGINT/SIGTERM.
+- **`resetFramesCursorCount()`** exported for tests.
+- **`play(non-array)`** — no-op controller instead of crash.
+- **`play({ repeat: 0 })`** — explicit infinite loop.
+- **`play({ repeat: -N })`** — negative now falls back to 1 (was infinite — dangerous on bad input).
+- **`fps` capped at 60** — prevents CPU saturation with `fps: 9999`.
+- **`generate` swallows per-frame errors** — one bad frame doesn't poison the sequence.
+- **`generate` coerces non-string returns**.
+- **`morph(steps=1)` clamps to 2** — avoids division by zero.
+- **All presets defensive** — width=0 OK, NaN fallback, empty char fallback.
+- **`live` with stop() idempotent** — multiple stops safe via `wasRunning` flag.
+
+### Added — Components (`components/index.ts`)
+
+- **`progressBar(NaN/Infinity)` → 0%** — defensive numeric inputs.
+- **`progressBar` with single-stop gradient** — colors statically (consistent with `gradient()` UX).
+- **`badge` SGR codes validated** — NaN fg/bg falls back to defaults.
+- **`table(non-array)` → `''`**, filters non-array rows, coerces non-string cells.
+- **`columns(cols<1)` clamps to default** — no longer throws.
+- **`columns(non-array)` → `''`**.
+- **`timeline(non-array)` → `''`**, coerces event labels.
+- **`section(NaN width)` falls back to terminal cols**.
+- **`status({ icon: '' })` omits icon** — coherent with `icon: null`.
+- **`menu([])` returns `MENU_CANCELLED`** instead of throwing (safer for runtime data).
+- **`menu(non-array)` → `MENU_CANCELLED`**.
+- **`menu` cleanup symmetric** — every path that hides cursor also restores it.
+- **`menu` `safeResolve` prevents double-resolve** races.
+
+### Added — Images (`images/index.ts`)
+
+- **All numeric inputs clamped** — `MAX_DIMENSION = 10000` prevents OOM on `Infinity`.
+- **`renderPixelArt(non-array)` → `''`** instead of crash.
+- **`ensurePixelGrid`** filters malformed rows.
+- **`flipHorizontal`/`flipVertical`/`rotate90` defensive** — non-array input returns `[]`.
+- **`gradientRect` validates colors array** — clear errors for empty/all-invalid.
+- **`gradientRect` single-stop renders solid fill** — better UX.
+- **`gradientRect(Infinity width)` clamps** to MAX_DIMENSION.
+- **`createCanvas(NaN/0)` → 1×1**.
+- **`createCanvas(Infinity)`** clamps to MAX_DIMENSION.
+- **`canvas.set/get` reject non-finite coords** as no-op.
+- **`canvas.drawRect/Circle/Sprite` defensive** against NaN, negative dims, non-array sprites.
+- **`canvas.pixels` getter returns deep clone** — callers can't mutate canvas state.
+- **`canvas.print` with try/catch** — stream torn down doesn't crash.
+- **ANSI cache LRU bounded** at 1024 entries — survives massive color counts.
+- **`Pixel` and `PixelGrid` exported** for typed consumers.
+
+### Added — Utils (`utils/ansi.ts`)
+
+- **`OSC`, `ST`, `BEL` constants** exported.
+- **`setTitle(text)`** — set terminal window title (OSC 2). Control chars stripped.
+- **`link(text, url)`** — clickable hyperlink (OSC 8). Supported in iTerm2, Terminal.app, WezTerm, Kitty, modern xterm.
+- **`bell()`** — terminal bell.
+- **`cursor.position()`** — query position (CSI 6n).
+- **`cursor.nextLine()`/`prevLine()`** — line-aware navigation.
+- **`screen.clearAll()`** — alias for `clear()`.
+- **`DEFAULT_TERM_COLS = 80`, `DEFAULT_TERM_ROWS = 24`** exported.
+- **`writeAsync({ timeout })`** option — prevents infinite hangs on broken streams.
+- **`OutputBuffer.pushIf(cond, str)`** — conditional append.
+- **`detectColorSupport`** improved — TERM truecolor/24bit detection, 256 substring match, rxvt support, try/catch around `os.release()`.
+- **All numeric inputs clamped** — `cursor.up(NaN)` → min=1, `fgRgb(Infinity, ...)` → 0.
+- **`ensureString` coercion** — all writes accept any input.
+- **`sleep(NaN/negative)` clamped** to 0.
+
+### Added — Utils (`utils/helpers.ts`)
+
+- **`once(fn)`** — invoke a function exactly once.
+- **`escapeRegex(str)`** — escape regex metacharacters.
+- **`safeJson(value, indent?)`** — JSON.stringify handling BigInt and circular references.
+- **`padBoth(str, width, ch?)`** — pad both sides equally, Unicode-aware.
+- **`nextTick(cb)`** — `setImmediate` fallback to `setTimeout(0)`.
+- **`memoize` with `{ keyFn }` option** — multi-argument memoization.
+- **`onResize` with implicit throttle (50ms default)** — coalesces rapid resize events.
+- **`debounce` with `maxWait` option** — guarantees invocation within window.
+- **`diffLines` with `type: 'added' | 'removed' | 'changed'`** — richer damage tracking.
+- **`gradientColor` auto-clamps `t`** — values outside [0,1] clamped automatically. NaN → 0.
+- **`stripAnsi`/`visibleLen` defensive** against non-string inputs.
+- **`termSize` validates** cols/rows > 0.
+
+---
+
+### Test infrastructure
+
+- **~1700+ tests across 16 suites**, all green.
+- Coverage: ~98% statements, ~95% branches, ~99% functions, ~99% lines.
+- All test files use `FORCE_COLOR=3` + `resetColorSupportCache()` in `beforeEach` for isolation.
+- New test isolation helpers exported: `resetCursorRefCount`, `resetFramesCursorCount`, `resetLoaderCursorCount`, `clearAnsiCache`, `clearThemeColorCache`, `clearColorCache`, `clearRenderCache`, `resetConfig`.
+
+### Examples
+
+6 production-grade examples in `/examples`:
+
+- `01-cli-installer.ts` — npm-create style installer (banner + hierarchical tasks + status icons + summary box).
+- `02-live-dashboard.ts` — real-time dashboard (frames.live + service table + gradient bars + onResize + SIGINT cleanup).
+- `03-pixel-art-game.ts` — bouncing rocket sprite (canvas + alpha blending + sunset gradient + FPS counter + drift-corrected loop).
+- `04-interactive-deploy.ts` — interactive menu + multi-select + loader.multi + createTheme + onConfigChange.
+- `05-tree-visualizations.ts` — filesystem + dependency + JSON + decision trees (4 scenarios, walk + measure bonus).
+- `06-everything-together.ts` — comprehensive showcase touching every module (NEW).
+
+---
+
+## [1.0.0] — initial release
+
+- Core modules: `color`, `animate`, `ascii`, `loader`, `frames`, `components`, `themes`, `images`, `configure`.
+- TypeScript types exported.
+- Adaptive color rendering (NO_COLOR / FORCE_COLOR / TTY detection).
+- AbortSignal support across all blocking APIs.
+- 750+ tests, 85%+ coverage.

package/LICENSE

@@ -1,21 +1,201 @@
-MIT License
-
-Copyright (c) 2025 Brashkie
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.