pax_global_header00006660000000000000000000000064142544136260014521gustar00rootroot0000000000000052 comment=866d8fcaed86aebb61c01ac979a8d1e047557b11 ionic-cli-cli-scripts-2.1.55/000077500000000000000000000000001425441362600157135ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/.editorconfig000066400000000000000000000002561425441362600203730ustar00rootroot00000000000000# http://editorconfig.org root = true [*] charset = utf-8 indent_style = space indent_size = 2 end_of_line = lf insert_final_newline = true trim_trailing_whitespace = true ionic-cli-cli-scripts-2.1.55/.gitattributes000066400000000000000000000004441425441362600206100ustar00rootroot00000000000000# CRLF * text eol=lf # Force images/fonts to be handled as binaries *.jpg binary *.jpeg binary *.gif binary *.png binary *.t3x binary *.t3d binary *.exe binary *.data binary *.ttf binary *.eof binary *.eot binary *.swf binary *.mov binary *.mp4 binary *.mp3 binary *.ogg binary *.flv binary ionic-cli-cli-scripts-2.1.55/.github/000077500000000000000000000000001425441362600172535ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/.github/ISSUE_TEMPLATE/000077500000000000000000000000001425441362600214365ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/.github/ISSUE_TEMPLATE/Bug_report.md000066400000000000000000000014651425441362600240760ustar00rootroot00000000000000--- name: Bug report about: Create a report to help us improve --- **Description:** **Steps to Reproduce:** **Output:** **My `ionic info`:** ``` ``` **Other Information:** ionic-cli-cli-scripts-2.1.55/.github/ISSUE_TEMPLATE/Feature_request.md000066400000000000000000000001111425441362600251140ustar00rootroot00000000000000--- name: Feature request about: Suggest an idea for this project --- ionic-cli-cli-scripts-2.1.55/.github/dependabot.yml000066400000000000000000000001361425441362600221030ustar00rootroot00000000000000version: 2 updates: - package-ecosystem: npm directory: "/" schedule: interval: daily ionic-cli-cli-scripts-2.1.55/.github/ionic-issue-bot.yml000066400000000000000000000107071425441362600230140ustar00rootroot00000000000000triage: label: triage dryRun: false closeAndLock: labels: - label: "ionitron: support" message: > Thanks for the issue! This issue appears to be a support request. We use this issue tracker exclusively for bug reports and feature requests. For support questions, please see our [Support Page](https://ionicframework.com/support). Thank you for using Ionic! - label: "ionitron: pro" message: > Thanks for the issue! This issue appears to be related to our commercial products. We use this issue tracker exclusively for bug reports and feature requests. Please [open a support ticket](https://ionicframework.com/support/request) and we'll be happy to assist you. Thank you for using Ionic! - label: "ionitron: missing template" message: > Thanks for the issue! It appears that you have not filled out the provided issue template. We use this issue template in order to gather more information and further assist you. Please create a new issue and ensure the template is fully filled out. Thank you for using Ionic! - label: "ionitron: old major version" message: > Thanks for the issue! This issue appears to be associated with an old version of the Ionic CLI. Please update to the latest CLI version, which supports all versions of the Ionic Framework. If the issue is relevant and if it persists after updating to the latest CLI version, please create a new issue. Thank you for using Ionic! - label: "ionitron: cordova" message: > Thanks for the issue! We use this issue tracker exclusively for bug reports and feature requests for the Ionic CLI. It appears that this issue is associated with Cordova. If you need Cordova support, please try asking in the [Ionic Forum](https://forum.ionicframework.com/). You can visit our [Support Page](https://ionicframework.com/support) for all options. If you believe this is an issue with Cordova, please see Cordova's [Reporting Issues](https://cordova.apache.org/contribute/issues.html) page. Thank you for using Ionic! close: true lock: true dryRun: false # stale: # days: 365 # maxIssuesPerRun: 100 # exemptLabels: # - good first issue # - triage # exemptProjects: true # exemptMilestones: true # label: "ionitron: stale issue" # message: > # Thanks for the issue! This issue is being closed due to inactivity. If this # is still an issue with the latest version of Ionic, please create a new # issue and ensure the template is fully filled out. # Thank you for using Ionic! # close: true # lock: true # dryRun: false wrongRepo: repos: - label: "ionitron: framework" repo: ionic message: > Thanks for the issue! We use this issue tracker exclusively for bug reports and feature requests for the Ionic CLI. It appears that this issue is associated with the Ionic Framework. I am moving this issue to the Ionic Framework repository. Please track this issue over there. Thank you for using Ionic! - label: "ionitron: capacitor" repo: capacitor message: > Thanks for the issue! We use this issue tracker exclusively for bug reports and feature requests for the Ionic CLI. It appears that this issue is associated with Capacitor. I am moving this issue to the Capacitor repository. Please track this issue over there. Thank you for using Ionic! - label: "ionitron: ionic-native" repo: ionic-native message: > Thanks for the issue! We use this issue tracker exclusively for bug reports and feature requests for the Ionic CLI. It appears that this issue is associated with Ionic Native. I am moving this issue to the Ionic Native repository. Please track this issue over there. Thank you for using Ionic! - label: "ionitron: ionic-site" repo: ionic-site message: > Thanks for the issue! We use this issue tracker exclusively for bug reports and feature requests for the Ionic CLI. It appears that this issue is associated with the Ionic website. I am moving this issue to the Ionic website repository. Please track this issue over there. Thank you for using Ionic! close: true lock: true dryRun: false ionic-cli-cli-scripts-2.1.55/.github/workflows/000077500000000000000000000000001425441362600213105ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/.github/workflows/cd.yml000066400000000000000000000033311425441362600224210ustar00rootroot00000000000000name: CD on: push: branches: - stable jobs: build: name: Build, Test, and Deploy runs-on: ubuntu-latest timeout-minutes: 30 steps: - run: echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" >> ~/.npmrc - uses: actions/setup-node@v1 with: node-version: 14.x - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Restore Dependency Cache uses: actions/cache@v1 with: path: ~/.npm key: ${{ runner.OS }}-dependency-cache-${{ hashFiles('**/package.json') }} - run: npm install - run: npm run bootstrap - run: npm run publish:ci -- --yes env: GH_TOKEN: ${{ secrets.GH_TOKEN }} GIT_AUTHOR_NAME: Ionitron GIT_AUTHOR_EMAIL: hi@ionicframework.com GIT_COMMITTER_NAME: Ionitron GIT_COMMITTER_EMAIL: hi@ionicframework.com - name: Sleep while npm takes its time run: sleep 20 - name: GitHub Container Registry Login run: echo ${GH_TOKEN} | docker login ghcr.io -u ionitron --password-stdin env: GH_TOKEN: ${{ secrets.GH_TOKEN }} - name: Build Container run: | docker build \ --build-arg IONIC_CLI_VERSION=$(npm info @ionic/cli dist-tags.latest) \ --tag ghcr.io/${{ github.repository }}:latest \ --tag ghcr.io/${{ github.repository}}:$(npm info @ionic/cli dist-tags.latest) \ . - name: Push Container as latest run: docker push ghcr.io/${{ github.repository }}:latest - name: Push Container as version run: docker push ghcr.io/${{ github.repository }}:$(npm info @ionic/cli dist-tags.latest) ionic-cli-cli-scripts-2.1.55/.github/workflows/ci.yml000066400000000000000000000013741425441362600224330ustar00rootroot00000000000000name: CI on: push: branches-ignore: - stable pull_request: branches-ignore: - stable jobs: build-and-test: name: Build and Test (Node ${{ matrix.node }}) runs-on: ubuntu-latest timeout-minutes: 30 strategy: matrix: node: - 14.x - 12.x - 10.x steps: - uses: actions/setup-node@v1 with: node-version: ${{ matrix.node }} - uses: actions/checkout@v2 - name: Restore Dependency Cache uses: actions/cache@v1 with: path: ~/.npm key: ${{ runner.OS }}-dependency-cache-${{ hashFiles('**/package.json') }} - run: npm install - run: npm run bootstrap - run: npm run lint - run: npm test ionic-cli-cli-scripts-2.1.55/.github/workflows/docker-image.yml000066400000000000000000000020761425441362600243670ustar00rootroot00000000000000name: BuildDockerImage on: workflow_dispatch jobs: build-docker-container: name: Build and Deploy Docker Container with latest CLI runs-on: ubuntu-latest steps: - uses: actions/setup-node@v1 with: node-version: 14.x - uses: actions/checkout@v2 with: fetch-depth: 0 - name: GitHub Container Registry Login run: echo ${GH_TOKEN} | docker login ghcr.io -u ionitron --password-stdin env: GH_TOKEN: ${{ secrets.GH_TOKEN }} - name: Build Container run: | docker build \ --build-arg IONIC_CLI_VERSION=$(npm info @ionic/cli dist-tags.latest) \ --tag ghcr.io/${{ github.repository }}:latest \ --tag ghcr.io/${{ github.repository}}:$(npm info @ionic/cli dist-tags.latest) \ . - name: Push Container as latest run: docker push ghcr.io/${{ github.repository }}:latest - name: Push Container as version run: docker push ghcr.io/${{ github.repository }}:$(npm info @ionic/cli dist-tags.latest)ionic-cli-cli-scripts-2.1.55/.gitignore000066400000000000000000000002341425441362600177020ustar00rootroot00000000000000.DS_Store *.sw* *.cookies node_modules/ .idea/ .vscode/ coverage/ .coveralls.yml .changelog/ npm-debug.log* lerna-debug.log /docs dist package-lock.json* ionic-cli-cli-scripts-2.1.55/.npmrc000066400000000000000000000000231425441362600170260ustar00rootroot00000000000000package-lock=false ionic-cli-cli-scripts-2.1.55/CHANGELOG.md000066400000000000000000000040521425441362600175250ustar00rootroot00000000000000# Changelog Please see each package's `CHANGELOG.md` for changes. #### CLIs * **`@ionic/cli`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/cli/CHANGELOG.md) * **`@ionic/lab`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/lab/CHANGELOG.md) * **`@ionic/v1-toolkit`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/v1-toolkit/CHANGELOG.md) #### Libraries * **`@ionic/cli-framework`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/cli-framework/CHANGELOG.md) * **`@ionic/cli-framework-prompts`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/cli-framework-prompts/CHANGELOG.md) * **`@ionic/discover`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/discover/CHANGELOG.md) * **`@ionic/utils-array`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-array/CHANGELOG.md) * **`@ionic/utils-fs`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-fs/CHANGELOG.md) * **`@ionic/utils-network`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-network/CHANGELOG.md) * **`@ionic/utils-object`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-object/CHANGELOG.md) * **`@ionic/utils-process`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-process/CHANGELOG.md) * **`@ionic/utils-stream`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-stream/CHANGELOG.md) * **`@ionic/utils-subprocess`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-subprocess/CHANGELOG.md) * **`@ionic/utils-terminal`**: [`CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/develop/packages/%40ionic/utils-terminal/CHANGELOG.md) ionic-cli-cli-scripts-2.1.55/CODE_OF_CONDUCT.md000066400000000000000000000002441425441362600205120ustar00rootroot00000000000000# Contributor Code of Conduct Please see [CODE_OF_CONDUCT.md](https://github.com/ionic-team/ionic/blob/HEAD/CODE_OF_CONDUCT.md) in the Ionic Framework repository. ionic-cli-cli-scripts-2.1.55/CONTRIBUTING.md000066400000000000000000000162711425441362600201530ustar00rootroot00000000000000# Contributing :mega: **Support/Questions?**: Please see our [Support Page](https://ionicframework.com/support) for general support questions. The issues on GitHub should be reserved for bug reports and feature requests. ### Branches * [`develop`](https://github.com/ionic-team/ionic-cli/tree/develop): **development** branch * [`stable`](https://github.com/ionic-team/ionic-cli/tree/stable): **stable** version ##### Version Branches These are mostly for reference--older major versions are typically not maintained. * [`5.x`](https://github.com/ionic-team/ionic-cli/tree/5.x) * [`4.x`](https://github.com/ionic-team/ionic-cli/tree/4.x) * [`3.x`](https://github.com/ionic-team/ionic-cli/tree/3.x) * [`2.x`](https://github.com/ionic-team/ionic-cli/tree/2.x) (*legacy version*) ### Bug Reports Run the command(s) with `--verbose` to produce debugging output. We may ask for the full command output, including debug statements. Please also copy/paste the output of the `ionic info` command into your issue and be as descriptive as possible. Include any steps that might help us reproduce your issue. ### Feature Requests Post an issue describing your feature to open a dialogue with us. We're happy to hear from you! ### Pull Requests Pull requests are most welcome! But, if you plan to add features or do large refactors, please **open a dialogue** with us first by creating an issue. Small bug fixes are welcome any time. #### Help Wanted Looking for small issues to help with? You can browse the [`help wanted`](https://github.com/ionic-team/ionic-cli/labels/help%20wanted) label. These are issues that have been marked as great opportunities for someone's first PR to the Ionic CLI. :heart_eyes: ### Local Setup #### Structure The Ionic CLI is organized into a monorepo. Here are the packages: ##### CLIs * [`packages/@ionic/cli`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/cli): Ionic CLI executable and library. * [`packages/@ionic/lab`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/lab): Utility CLI for Ionic Lab, used by `ionic serve`. * [`packages/@ionic/v1-toolkit`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/v1-toolkit): Utility CLI for Ionic v1 Apps, used by `ionic serve`. ##### Libraries * [`packages/@ionic/cli-framework`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/cli-framework): Framework for command-line programs. * [`packages/@ionic/cli-framework-prompts`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/cli-framework-prompts): Command-line prompting framework that wraps [Inquirer.js](https://github.com/SBoudrias/Inquirer.js). * [`packages/@ionic/discover`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/discover): Service discovery library used for `ionic serve` with the [Ionic DevApp](https://ionicframework.com/docs/appflow/devapp/) (now retired). * [`packages/@ionic/utils-array`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-array): General purpose array library with asynchronous map/filter/reduce. * [`packages/@ionic/utils-fs`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-fs): Filesystem library that wraps [fs-extra](https://github.com/jprichardson/node-fs-extra) for Node.js. * [`packages/@ionic/utils-network`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-network): Network library for Node.js. * [`packages/@ionic/utils-object`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-object): General purpose object library. * [`packages/@ionic/utils-process`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-process): OS process library for Node.js. * [`packages/@ionic/utils-stream`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-stream): Stream library for Node.js. * [`packages/@ionic/utils-subprocess`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-subprocess): Subprocess library that uses [cross-spawn](https://github.com/moxystudio/node-cross-spawn) for Node.js. * [`packages/@ionic/utils-terminal`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/utils-terminal): Terminal and command-line environment library for Node.js. #### Toolset * npm 6+ is required. * Node 12+ is required. * The codebase is written in [TypeScript](https://www.typescriptlang.org/). If you're unfamiliar with TypeScript, we recommend using [VS Code](https://code.visualstudio.com/) and finding a tutorial to familiarize yourself with basic concepts. * The test suite uses [Jest](https://facebook.github.io/jest/). #### Setup 1. Fork the repo & clone it locally. 1. `npm install` to install the dev tools. 1. `npm run bootstrap` (will install package dependencies and link packages together) 1. Optionally `npm run link` to make `ionic` and other bin files point to your dev CLI. 1. `npm run watch` will spin up TypeScript watch scripts for all packages. 1. TypeScript source files are in `packages/**/src`. 1. Good luck! :muscle: Please open an issue if you have questions or something is unclear. #### Running Dev CLI To switch between dev CLI and stable CLI, you can use a Node version manager such as [nvm](https://github.com/creationix/nvm) and switch between environments, e.g. ```bash nvm install v12 nvm alias cli-local v12 ``` You can even set up an alias in your terminal that sets `IONIC_CONFIG_DIRECTORY` to have seperate configuration environments. ```bash alias cli-local="nvm use cli-local && export IONIC_CONFIG_DIRECTORY=$HOME/.ionic/cli-local" ``` When the Node environment is created, create a symlink to `packages/@ionic/cli/bin/ionic` within `$NVM_BIN`: ```bash ln -s $(pwd)/packages/@ionic/cli/bin/ionic $NVM_BIN ``` ##### Debugging The following workflow is recommended for debugging the Ionic CLI: 1. Place [`debugger;`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/debugger) statements where desired. 1. Run the CLI via `node` to use Node's `--inspect-brk` flag: * Instead of `~/path/to/ionic ` use `node --inspect-brk ~/path/to/ionic `. * Instead of `ionic `, try `node --inspect-brk $(which ionic) ` (works on Mac and Linux). 1. Open `chrome://inspect` in Chrome and select the remote target to use DevTools for debugging. Read more about Node debugging in the [Debugging Guide](https://nodejs.org/en/docs/guides/debugging-getting-started/). ##### Publishing CI automatically publishes the next version semantically from analyzing commits in `stable`. To maintain a shared history between `develop` and `stable`, the branches must be rebased with each other locally. * When it's time to cut a release from `develop`: ``` git checkout stable git rebase develop git push origin stable ``` * Await successful publish in CI. Ionitron will push the updated versions and tags to `stable`. * Sync `develop` with `stable`. ``` git pull origin stable git checkout develop git rebase stable git push origin develop ``` To publish **testing** versions, follow these steps: 1. Cancel any watch scripts. 1. Run `npm run publish:testing` ionic-cli-cli-scripts-2.1.55/Dockerfile000066400000000000000000000005101425441362600177010ustar00rootroot00000000000000FROM node:lts # Set CI to true & LANG ENV CI=1 ENV LANG en_US.UTF-8 # Install the desired version of @ionic/cli ARG IONIC_CLI_VERSION RUN npm i -g @ionic/cli@${IONIC_CLI_VERSION} && \ ionic --no-interactive config set -g daemon.updates false && \ ionic --no-interactive config set -g telemetry false WORKDIR /usr/src/appionic-cli-cli-scripts-2.1.55/LICENSE000066400000000000000000000020641425441362600167220ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2017 Drifty Co 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. ionic-cli-cli-scripts-2.1.55/README.md000066400000000000000000000032741425441362600172000ustar00rootroot00000000000000[![Build Status][ci-badge]][ci-badge-url] [![Dependabot Status](https://api.dependabot.com/badges/status?host=github&repo=ionic-team/ionic-cli)](https://dependabot.com) [![npm][npm-badge]][npm-badge-url] # Ionic CLI The Ionic command line interface (CLI) is your go-to tool for developing [Ionic][ionic-homepage] apps. ### Installation ``` npm install -g @ionic/cli ``` Detailed installation instructions can be found in the [CLI documentation](https://ionicframework.com/docs/installation/cli). ### Usage The Ionic CLI ships with command documentation, accessible in your terminal by using the `--help` flag. These docs are also available [online][ionic-cli-docs]. * For a list of commands: ``` ionic --help ionic cordova --help ionic capacitor --help ``` * For command usage and a list of options: ``` ionic start --help ionic serve --help ionic cordova run --help ``` --- :book: **Documentation**: [https://ionicframework.com/docs/cli][ionic-cli-docs] :mega: **Support/Questions?** Please see our [Support Page][ionic-support] for general support questions. The issues on GitHub should be reserved for bug reports and feature requests. :sparkling_heart: **Want to contribute?** Please see [CONTRIBUTING.md](https://github.com/ionic-team/ionic-cli/blob/develop/CONTRIBUTING.md). [ionic-homepage]: https://ionicframework.com [ionic-cli-docs]: https://ionicframework.com/docs/cli [ionic-support]: https://ionicframework.com/support [ci-badge]: https://github.com/ionic-team/ionic-cli/workflows/CI/badge.svg [ci-badge-url]: https://github.com/ionic-team/ionic-cli/actions?query=workflow%3ACI [npm-badge]: https://img.shields.io/npm/v/@ionic/cli.svg [npm-badge-url]: https://www.npmjs.com/package/@ionic/cli ionic-cli-cli-scripts-2.1.55/jest.config.base.js000066400000000000000000000003511425441362600213720ustar00rootroot00000000000000module.exports = { preset: 'ts-jest', globals: { 'ts-jest': { diagnostics: { // warnOnly: true, }, tsConfig: { types: [ "node", "jest", ], }, }, }, }; ionic-cli-cli-scripts-2.1.55/lerna.json000066400000000000000000000002751425441362600177130ustar00rootroot00000000000000{ "version": "independent", "packages": [ "packages/**" ], "command": { "bootstrap": { "hoist": true }, "version": { "allowBranch": "stable" } } } ionic-cli-cli-scripts-2.1.55/lint-staged.config.base.js000066400000000000000000000002621425441362600226410ustar00rootroot00000000000000const micromatch = require('micromatch'); module.exports = { '*.{ts,tsx}': files => micromatch .not(files, '**/__tests__/*.{ts,tsx}') .map(file => 'npm run lint'), }; ionic-cli-cli-scripts-2.1.55/package.json000066400000000000000000000020131425441362600201750ustar00rootroot00000000000000{ "name": "ionic-cli", "private": true, "scripts": { "bootstrap": "lerna bootstrap && npm run build", "clean": "lerna run clean", "lint": "lerna run lint", "lint:fix": "lerna run lint -- -- --fix", "link": "lerna exec npm link", "unlink": "lerna exec npm unlink", "test": "lerna run test", "build": "lerna run build", "watch": "lerna run watch --parallel", "docs": "node packages/cli-scripts/bin/ionic-cli-scripts docs", "docs:watch": "chokidar 'packages/cli-scripts/dist/docs/**/*.js' -c 'npm run docs'", "publish:testing": "lerna publish prerelease --preid=testing --exact --no-git-tag-version --no-push --dist-tag=testing", "publish:ci": "lerna publish -m 'chore(release): publish [skip ci]' --exact --conventional-commits" }, "devDependencies": { "chokidar-cli": "^2.0.0", "husky": "^4.2.0", "lerna": "^3.13.3", "typescript": "~4.0.2" }, "husky": { "hooks": { "pre-commit": "lerna exec --concurrency 1 --stream -- lint-staged" } } } ionic-cli-cli-scripts-2.1.55/packages/000077500000000000000000000000001425441362600174715ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/000077500000000000000000000000001425441362600206725ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/000077500000000000000000000000001425441362600247725ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/.gitignore000066400000000000000000000000221425441362600267540ustar00rootroot00000000000000dist node_modules ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/.npmrc000066400000000000000000000000231425441362600261050ustar00rootroot00000000000000package-lock=false ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/CHANGELOG.md000066400000000000000000000077071425441362600266160ustar00rootroot00000000000000# Change Log All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. ## [2.2.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.2.4...@ionic/cli-framework-output@2.2.5) (2022-06-16) **Note:** Version bump only for package @ionic/cli-framework-output ## [2.2.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.2.3...@ionic/cli-framework-output@2.2.4) (2022-05-09) **Note:** Version bump only for package @ionic/cli-framework-output ## [2.2.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.2.2...@ionic/cli-framework-output@2.2.3) (2022-03-04) ### Bug Fixes * correct time unit ([#4796](https://github.com/ionic-team/ionic-cli/issues/4796)) ([8f79cf2](https://github.com/ionic-team/ionic-cli/commit/8f79cf2069ff0b59a076ae9112fcef2dd84f8dc2)) ## [2.2.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.2.1...@ionic/cli-framework-output@2.2.2) (2020-09-29) ### Bug Fixes * add signal-exit dependency in correct place ([178e5e5](https://github.com/ionic-team/ionic-cli/commit/178e5e51cdc3593e3d096a5197e1dc0e17292bbd)) ## [2.2.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.2.0...@ionic/cli-framework-output@2.2.1) (2020-09-24) **Note:** Version bump only for package @ionic/cli-framework-output # [2.2.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.1.0...@ionic/cli-framework-output@2.2.0) (2020-09-02) ### Bug Fixes * **formatter:** do not strip newlines when not titleizing ([3e38cd8](https://github.com/ionic-team/ionic-cli/commit/3e38cd891d0b914e03ea06d57cbb6ab067d43ac2)) ### Features * **output:** write method shortcut ([ca89ee9](https://github.com/ionic-team/ionic-cli/commit/ca89ee92a99a52bd4abd8a1cb97ba3087ec8c4e0)) # [2.1.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.0.2...@ionic/cli-framework-output@2.1.0) (2020-08-29) ### Features * **logger:** add createDefaultLogger helper ([6961c33](https://github.com/ionic-team/ionic-cli/commit/6961c3377e88498d86eb0a39e5aef3f776fb3fd3)) * **logger:** add tags option for tagged formatter ([6957104](https://github.com/ionic-team/ionic-cli/commit/695710462178f109d10504e6d9d8b0870eb0541c)) ## [2.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.0.1...@ionic/cli-framework-output@2.0.2) (2020-08-28) **Note:** Version bump only for package @ionic/cli-framework-output ## [2.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@2.0.0...@ionic/cli-framework-output@2.0.1) (2020-08-27) ### Bug Fixes * strip newlines when redrawing ([d13085f](https://github.com/ionic-team/ionic-cli/commit/d13085f8bdf372cd761f30ba97d9551721a26396)) # [2.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@1.1.0...@ionic/cli-framework-output@2.0.0) (2020-08-27) ### Bug Fixes * **output:** newlines in stream output strategy ([4f9a7c9](https://github.com/ionic-team/ionic-cli/commit/4f9a7c988a0a63b21bf2a80eef065155c78545d0)) * **output:** stream is optional ([df3e949](https://github.com/ionic-team/ionic-cli/commit/df3e949ebb092c92b84717a83bd662e283463e37)) ### Code Refactoring * **output:** replace log-update ([a90005c](https://github.com/ionic-team/ionic-cli/commit/a90005cd048a68252456da8409dedacaab54b505)) ### BREAKING CHANGES * **output:** `LogUpdateOutputStrategy` removed in favor of `TTYOutputStrategy` # [1.1.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-output@1.0.1...@ionic/cli-framework-output@1.1.0) (2020-08-26) ### Features * **output:** show elapsed time for tasks ([e4525f7](https://github.com/ionic-team/ionic-cli/commit/e4525f79b549b66e25e6c01297ccc77cc6c85250)) ## 1.0.1 (2020-08-25) **Note:** Version bump only for package @ionic/cli-framework-output ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/LICENSE000066400000000000000000000020641425441362600260010ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2019 Drifty Co 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. ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/README.md000066400000000000000000000000361425441362600262500ustar00rootroot00000000000000# @ionic/cli-framework-output ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/jest.config.js000066400000000000000000000000671425441362600275440ustar00rootroot00000000000000module.exports = require('../../../jest.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/lint-staged.config.js000066400000000000000000000000761425441362600310120ustar00rootroot00000000000000module.exports = require('../../../lint-staged.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/package.json000066400000000000000000000021061425441362600272570ustar00rootroot00000000000000{ "name": "@ionic/cli-framework-output", "version": "2.2.5", "description": "The log/tasks/spinners portion of Ionic CLI Framework", "homepage": "https://ionicframework.com/", "author": "Ionic Team (https://ionicframework.com)", "main": "./dist/index.js", "types": "./dist/index.d.ts", "engines": { "node": ">=10.3.0" }, "files": [ "dist/", "LICENSE", "README.md" ], "scripts": { "clean": "rimraf dist", "lint": "true", "build": "npm run clean && tsc", "watch": "tsc -w --preserveWatchOutput", "test": "jest --maxWorkers=4", "prepublishOnly": "npm run build" }, "license": "MIT", "dependencies": { "@ionic/utils-terminal": "2.3.3", "debug": "^4.0.0", "tslib": "^2.0.1" }, "devDependencies": { "@ionic/utils-stream": "3.1.5", "@types/debug": "^4.1.1", "@types/inquirer": "0.0.43", "@types/jest": "^26.0.10", "@types/node": "~10.17.13", "jest": "^26.4.2", "jest-cli": "^26.0.1", "lint-staged": "^10.0.2", "ts-jest": "~26.3.0", "typescript": "~4.0.2" } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/000077500000000000000000000000001425441362600255615ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/__tests__/000077500000000000000000000000001425441362600275175ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/__tests__/logger.ts000066400000000000000000000335701425441362600313560ustar00rootroot00000000000000import { WritableStreamBuffer } from '@ionic/utils-stream'; import { stripAnsi, wordWrap } from '@ionic/utils-terminal'; import { LOGGER_LEVELS, Logger, LoggerHandler, StreamHandler, createPrefixedFormatter, createTaggedFormatter } from '../logger'; describe('@ionic/cli-framework-output', () => { describe('logger', () => { describe('Logger', () => { describe('clone', () => { it('should clone the base set of options', () => { const logger1 = new Logger(); const logger2 = logger1.clone(); expect(logger1.level).toEqual(logger2.level); expect(logger1.handlers).not.toBe(logger2.handlers); expect(logger2.handlers.size).toEqual(2); for (const handler of logger2.handlers) { expect(handler).toBeInstanceOf(StreamHandler); } }); it('should clone the set of option overrides', () => { const logger1 = new Logger(); const level = 15; const handlers: Set = new Set(); const logger2 = logger1.clone({ level, handlers }); expect(logger2.level).not.toEqual(logger1.level); expect(logger2.level).toEqual(level); expect(logger2.handlers).not.toEqual(logger1.handlers); expect(logger2.handlers).toBe(handlers); }); }); describe('msg', () => { let stream: WritableStreamBuffer; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); logger = new Logger({ handlers: new Set([new StreamHandler({ stream })]) }); }); it('should write the message directly', () => { logger.msg('hi'); expect(stream.consume().toString()).toEqual('hi\n'); }); }); describe('nl', () => { let stream: WritableStreamBuffer; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); logger = new Logger({ handlers: new Set([new StreamHandler({ stream })]) }); }); it('should log for defaults', () => { logger.nl(); expect(stream.consume().toString()).toEqual('\n'); }); it('should log multiple newlines', () => { logger.nl(5); expect(stream.consume().toString()).toEqual('\n'.repeat(5)); }); }); describe('log', () => { let stream: WritableStreamBuffer; let handler: StreamHandler; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); handler = new StreamHandler({ stream }); logger = new Logger({ handlers: new Set([handler]) }); }); it('should log for defaults', () => { logger.log({ logger, msg: 'hi' }); expect(stream.consume().toString()).toEqual('hi\n'); }); it('should log with formatter', () => { logger = new Logger({ handlers: new Set([new StreamHandler({ stream, formatter: record => record.msg.split('').reverse().join('') })]) }); logger.log({ logger, msg: 'hello world!' }); expect(stream.consume().toString()).toEqual('!dlrow olleh\n'); }); it('should log with levels equal', () => { logger.level = 20; logger.log({ logger, msg: 'hi', level: 20 }); expect(stream.consume().toString()).toEqual('hi\n'); }); it('should log with record level not set', () => { logger.level = 10; logger.log({ logger, msg: 'hi' }); expect(stream.consume().toString()).toEqual('hi\n'); }); it('should not log when logger level exceeds record level', () => { logger.level = 20; logger.log({ logger, msg: 'hi', level: 10 }); expect(stream.consume().toString()).toEqual(''); }); }); describe('debug', () => { let stream: WritableStreamBuffer; let handler: StreamHandler; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); handler = new StreamHandler({ stream }); logger = new Logger({ handlers: new Set([handler]) }); }); it('should not log debug messages by default', () => { logger.debug('hi'); expect(stream.consume().toString()).toEqual(''); }); it('should log debug messages with adjusted level', () => { logger.level = 0; logger.debug('hi'); expect(stream.consume().toString()).toEqual('hi\n'); }); }); describe('info', () => { let stream: WritableStreamBuffer; let handler: StreamHandler; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); handler = new StreamHandler({ stream }); logger = new Logger({ handlers: new Set([handler]) }); }); it('should write the message', () => { logger.info('hi'); expect(stream.consume().toString()).toEqual('hi\n'); }); it('should not write the message at a higher level', () => { logger.level = 30; logger.info('hi'); expect(stream.consume().toString()).toEqual(''); }); }); describe('warn', () => { let stream: WritableStreamBuffer; let handler: StreamHandler; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); handler = new StreamHandler({ stream }); logger = new Logger({ handlers: new Set([handler]) }); }); it('should write the message', () => { logger.warn('hi'); expect(stream.consume().toString()).toEqual('hi\n'); }); it('should not write the message at a higher level', () => { logger.level = 40; logger.warn('hi'); expect(stream.consume().toString()).toEqual(''); }); }); describe('error', () => { let stream: WritableStreamBuffer; let handler: StreamHandler; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); handler = new StreamHandler({ stream }); logger = new Logger({ handlers: new Set([handler]) }); }); it('should write the message', () => { logger.error('hi'); expect(stream.consume().toString()).toEqual('hi\n'); }); it('should not write the message at a higher level', () => { logger.level = 50; logger.error('hi'); expect(stream.consume().toString()).toEqual(''); }); }); describe('createWriteStream', () => { it('should create a writable stream', () => { const stream = new WritableStreamBuffer(); const handler = new StreamHandler({ stream }); const logger = new Logger({ handlers: new Set([handler]) }); const ws = logger.createWriteStream(); ws.write('hi'); expect(stream.consume().toString()).toEqual('hi\n'); }); }); }); describe('createTaggedFormatter', () => { let stream: WritableStreamBuffer; let handler: StreamHandler; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); handler = new StreamHandler({ stream }); logger = new Logger({ handlers: new Set([handler]) }); }); it('should not format if requested', () => { const formatter = createTaggedFormatter(); const result = formatter({ msg: 'hi', level: LOGGER_LEVELS.INFO, format: false, logger }); expect(result).toEqual('hi'); }); it('should not tag non-leveled outputs', () => { const formatter = createTaggedFormatter(); const result = formatter({ msg: 'hi', logger }); expect(result).toEqual('hi'); }); it('should log multi-line message properly for non-leveled outputs', () => { const formatter = createTaggedFormatter({ wrap: false }); const result = formatter({ msg: 'hello world!\nThis is a message.', logger }); expect(result).toEqual('hello world!\nThis is a message.'); }); it('should log multi-line message properly for wrapped, non-leveled outputs', () => { const formatter = createTaggedFormatter({ wrap: true }); const result = formatter({ msg: 'hello world!\nThis is a message.', logger }); expect(result).toEqual('hello world!\nThis is a message.'); }); it('should tag leveled outputs', () => { const formatter = createTaggedFormatter(); const result = formatter({ msg: 'hi', level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual('[INFO] hi'); }); it('should not wrap by default', () => { const formatter = createTaggedFormatter(); const msg = 'A '.repeat(1000); const result = formatter({ msg, level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual(`[INFO] ${msg}`); }); it('should wrap words if wanted', () => { const wordWrapOpts = { width: 50 }; const formatter = createTaggedFormatter({ wrap: wordWrapOpts }); const msg = 'A '.repeat(1000); const result = formatter({ msg, level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual(`[INFO] ${wordWrap(msg, { indentation: 7, ...wordWrapOpts })}`); }); it('should not titleize by default', () => { const formatter = createTaggedFormatter(); const result = formatter({ msg: `Hello!\nThis is a message.\nHere's another.`, level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual(`[INFO] Hello!\n This is a message.\n Here's another.`); }); it('should not titleize for single line', () => { const formatter = createTaggedFormatter({ titleize: true }); const result = formatter({ msg: 'Hello!', level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual(`[INFO] Hello!`); }); it('should titleize properly for double newline after first line', () => { const formatter = createTaggedFormatter({ titleize: true }); const result = formatter({ msg: `Hello!\n\nThis is a message.\n\nHere's another.`, level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual(`[INFO] Hello!\n\n This is a message.\n\n Here's another.`); }); it('should titleize if wanted', () => { const formatter = createTaggedFormatter({ titleize: true }); const result = formatter({ msg: `Hello!\nThis is a message.\nHere's another.`, level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual(`[INFO] Hello!\n\n This is a message.\n Here's another.`); }); it('should strip the first newlines with a titleized message', () => { const formatter = createTaggedFormatter({ titleize: true }); const result = formatter({ msg: 'hello world!\n\n\nThis is a message.', logger }); expect(result).toEqual('hello world!\n\nThis is a message.'); }); it('should not strip the first newlines with a non-titleized message', () => { const formatter = createTaggedFormatter({ titleize: false }); const result = formatter({ msg: 'hello world!\n\n\nThis is a message.', logger }); expect(result).toEqual('hello world!\n\n\nThis is a message.'); }); it('should work with wrap and titleize', () => { const wordWrapOpts = { width: 50 }; const formatter = createTaggedFormatter({ titleize: true, wrap: wordWrapOpts }); const msg = 'A '.repeat(1000); const result = formatter({ msg, level: LOGGER_LEVELS.INFO, logger }); expect(stripAnsi(result)).toEqual(`[INFO] ${wordWrap(msg, { indentation: 7, ...wordWrapOpts })}`); }); it('should prefix single line without level', () => { const now = new Date().toISOString(); const formatter = createTaggedFormatter({ prefix: `[${now}]` }); const result = formatter({ msg: 'hello world!', logger }); expect(result).toEqual(`[${now}] hello world!`); }); it('should prefix dynamically with a function', () => { let count = 0; const spy = jest.fn(() => `[${++count}]`); const formatter = createTaggedFormatter({ prefix: spy }); const result1 = formatter({ msg: 'hello world!', logger }); const result2 = formatter({ msg: 'hello world!', logger }); expect(result1).toEqual('[1] hello world!'); expect(result2).toEqual('[2] hello world!'); expect(spy).toHaveBeenCalledTimes(2); }); }); describe('createPrefixedFormatter', () => { let stream: WritableStreamBuffer; let handler: StreamHandler; let logger: Logger; beforeEach(() => { stream = new WritableStreamBuffer(); handler = new StreamHandler({ stream }); logger = new Logger({ handlers: new Set([handler]) }); }); it('should not format if requested', () => { const formatter = createPrefixedFormatter('[prefix]'); const result = formatter({ msg: 'hello world!', format: false, logger }); expect(result).toEqual('hello world!'); }); it('should prefix message', () => { const formatter = createPrefixedFormatter('[prefix]'); const result = formatter({ msg: 'hello world!', logger }); expect(result).toEqual('[prefix] hello world!'); }); it('should prefix dynamically with a function', () => { let count = 0; const spy = jest.fn(() => `[${++count}]`); const formatter = createPrefixedFormatter(spy); const result1 = formatter({ msg: 'hello world!', logger }); const result2 = formatter({ msg: 'hello world!', logger }); expect(result1).toEqual('[1] hello world!'); expect(result2).toEqual('[2] hello world!'); expect(spy).toHaveBeenCalledTimes(2); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/__tests__/tasks.ts000066400000000000000000000235411425441362600312210ustar00rootroot00000000000000import { Task, TaskChain } from '../tasks'; describe('@ionic/cli-framework-output', () => { describe('tasks', () => { describe('Task', () => { let task: Task; let handlers: { success: jest.Mock; failure: jest.Mock; clear: jest.Mock; tick: jest.Mock; end: jest.Mock; }; beforeEach(() => { jest.useFakeTimers(); task = new Task({ msg: '' }); handlers = { success: jest.fn(), failure: jest.fn(), clear: jest.fn(), tick: jest.fn(), end: jest.fn(), }; task.on('success', handlers.success); task.on('failure', handlers.failure); task.on('clear', handlers.clear); task.on('tick', handlers.tick); task.on('end', handlers.end); }); afterEach(() => { jest.clearAllTimers(); }); it('should have an empty msg from construction', () => { expect(task.msg).toEqual(''); }); it('should tick when msg is set', () => { const msg = 'hello world!'; task.msg = msg; expect(handlers.tick).toHaveBeenCalledTimes(1); handlers.tick.mockReset(); expect(task.msg).toEqual(msg); expect(handlers.tick).not.toHaveBeenCalled(); }); it('should allow start to be called more than once', () => { expect(task.running).toEqual(false); task.start(); expect(task.running).toEqual(true); expect(handlers.tick).not.toHaveBeenCalled(); task.start(); expect(task.running).toEqual(true); expect(handlers.tick).not.toHaveBeenCalled(); }); it('should end with proper events', () => { expect(handlers.tick).not.toHaveBeenCalled(); expect(handlers.clear).not.toHaveBeenCalled(); expect(handlers.end).not.toHaveBeenCalled(); task.end(); expect(handlers.tick).toHaveBeenCalledTimes(1); expect(handlers.clear).toHaveBeenCalledTimes(1); expect(handlers.end).toHaveBeenCalledTimes(1); expect(handlers.success).not.toHaveBeenCalled(); expect(handlers.failure).not.toHaveBeenCalled(); }); it('should ignore succeed if not started', () => { expect(task.running).toEqual(false); task.succeed(); expect(task.running).toEqual(false); expect(handlers.tick).not.toHaveBeenCalled(); expect(handlers.clear).not.toHaveBeenCalled(); expect(handlers.end).not.toHaveBeenCalled(); expect(handlers.success).not.toHaveBeenCalled(); expect(handlers.failure).not.toHaveBeenCalled(); }); it('should ignore fail if not started', () => { expect(task.running).toEqual(false); task.fail(); expect(task.running).toEqual(false); expect(handlers.tick).not.toHaveBeenCalled(); expect(handlers.clear).not.toHaveBeenCalled(); expect(handlers.end).not.toHaveBeenCalled(); expect(handlers.success).not.toHaveBeenCalled(); expect(handlers.failure).not.toHaveBeenCalled(); }); it('should succeed with proper events', () => { task.start(); expect(task.running).toEqual(true); task.succeed(); expect(task.running).toEqual(false); expect(handlers.tick).toHaveBeenCalledTimes(1); expect(handlers.clear).toHaveBeenCalledTimes(1); expect(handlers.end).toHaveBeenCalledTimes(1); expect(handlers.success).toHaveBeenCalledTimes(1); expect(handlers.failure).not.toHaveBeenCalled(); }); it('should fail with proper events', () => { task.start(); expect(task.running).toEqual(true); task.fail(); expect(task.running).toEqual(false); expect(handlers.tick).toHaveBeenCalledTimes(1); expect(handlers.clear).toHaveBeenCalledTimes(1); expect(handlers.end).toHaveBeenCalledTimes(1); expect(handlers.success).not.toHaveBeenCalled(); expect(handlers.failure).toHaveBeenCalledTimes(1); }); describe('intervaled', () => { const tickInterval = 50; beforeEach(() => { task.tickInterval = tickInterval; }); it('should not set intervalId twice', () => { expect(task.running).toEqual(false); expect(task.intervalId).toBeUndefined(); task.start(); expect(task.running).toEqual(true); expect(task.intervalId).toBeDefined(); const firstIntervalId = task.intervalId; task.start(); expect(task.running).toEqual(true); expect(task.intervalId).toBeDefined(); expect(task.intervalId).toBe(firstIntervalId); }); it('should clear interval properly', () => { task.start(); const intervalId = task.intervalId; expect(task.intervalId).toBeDefined(); task.clear(); expect(handlers.clear).toHaveBeenCalledTimes(1); expect(task.intervalId).toBeUndefined(); expect(clearInterval).toHaveBeenLastCalledWith(intervalId); }); it('should tick appropriately for success case', () => { const msg = 'hello world!'; task.start(); expect(setInterval).toHaveBeenCalledTimes(1); expect(setInterval).toHaveBeenLastCalledWith(expect.any(Function), tickInterval); expect(handlers.tick).not.toHaveBeenCalled(); task.msg = msg; expect(handlers.tick).toHaveBeenCalledTimes(1); jest.advanceTimersByTime(100); expect(handlers.tick).toHaveBeenCalledTimes(3); task.succeed(); expect(handlers.tick).toHaveBeenCalledTimes(4); }); }); }); describe('TaskChain', () => { let chain: TaskChain; let createTaskSpy: jest.SpyInstance; let handlers: { end: jest.Mock; failure: jest.Mock; next: jest.Mock; }; beforeEach(() => { chain = new TaskChain(); createTaskSpy = jest.spyOn(chain, 'createTask'); handlers = { end: jest.fn(), failure: jest.fn(), next: jest.fn(), }; chain.on('end', handlers.end); chain.on('failure', handlers.failure); chain.on('next', handlers.next); }); it('should set current task upon first next', () => { expect((chain as any).current).toBeUndefined(); const msg = 'hello world!'; const task = chain.next(msg); expect(task.msg).toEqual(msg); expect(task.running).toEqual(true); expect((chain as any).current).toBe(task); }); it('should remove current task when complete', () => { expect((chain as any).current).toBeUndefined(); const task = chain.next('hello world!'); const spy = jest.fn(); task.on('success', spy); expect((chain as any).current).toBe(task); chain.end(); expect((chain as any).current).toBeUndefined(); expect(spy).toHaveBeenCalledTimes(1); }); it('should fail current task', () => { expect((chain as any).current).toBeUndefined(); const task = chain.next('hello world!'); const spy = jest.fn(); task.on('failure', spy); expect((chain as any).current).toBe(task); chain.fail(); expect((chain as any).current).toBe(task); expect(spy).toHaveBeenCalledTimes(1); }); it('should pass msg to create task function', () => { const msg = 'hello world!'; chain.next(msg); expect(createTaskSpy).toHaveBeenCalledTimes(1); expect(createTaskSpy).toHaveBeenLastCalledWith({ msg }); }); it('should cleanup tasks', () => { const task1 = chain.next('hello world!'); const task2 = chain.next('hello world!'); const clearSpy1 = jest.fn(); const failureSpy1 = jest.fn(); const clearSpy2 = jest.fn(); const failureSpy2 = jest.fn(); task1.on('clear', clearSpy1); task1.on('failure', failureSpy1); task2.on('clear', clearSpy2); task2.on('failure', failureSpy2); chain.cleanup(); expect(failureSpy1).not.toHaveBeenCalled(); expect(clearSpy1).toHaveBeenCalledTimes(1); expect(failureSpy2).toHaveBeenCalledTimes(1); expect(clearSpy2).toHaveBeenCalledTimes(1); }); it('should call end event with no task for task-list chain', () => { expect(handlers.end).not.toHaveBeenCalled(); chain.end(); expect(handlers.end).toHaveBeenCalledTimes(1); expect(handlers.end).toHaveBeenCalledWith(undefined); }); it('should call end event with a task', () => { const task = chain.next('hello world!'); expect(handlers.end).not.toHaveBeenCalled(); chain.end(); expect(handlers.end).toHaveBeenCalledTimes(1); expect(handlers.end).toHaveBeenCalledWith(task); }); it('should call failure event with no task for task-list chain', () => { expect(handlers.failure).not.toHaveBeenCalled(); chain.fail(); expect(handlers.failure).toHaveBeenCalledTimes(1); expect(handlers.failure).toHaveBeenCalledWith(undefined); }); it('should call failure event with a task', () => { const task = chain.next('hello world!'); expect(handlers.failure).not.toHaveBeenCalled(); chain.fail(); expect(handlers.failure).toHaveBeenCalledTimes(1); expect(handlers.failure).toHaveBeenCalledWith(task); }); it('should call next event', () => { expect(handlers.next).not.toHaveBeenCalled(); const task1 = chain.next('hello world!'); expect(handlers.next).toHaveBeenCalledTimes(1); expect(handlers.next).toHaveBeenCalledWith(task1); const task2 = chain.next('hello world!'); expect(handlers.next).toHaveBeenCalledTimes(2); expect(handlers.next).toHaveBeenCalledWith(task2); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/__tests__/utils.ts000066400000000000000000000045471425441362600312410ustar00rootroot00000000000000import { dropWhile, enforceLF } from '../utils'; describe('@ionic/cli-framework-output', () => { describe('utils', () => { describe('dropWhile', () => { it('should not return the original array', () => { const input: string[] = []; const result = dropWhile(input); expect(result).not.toBe(input); expect(result).toEqual([]); }); it('should filter truthy with default predicate', () => { const result = dropWhile([1, 2, 3]); expect(result).toEqual([]); }); it('should filter truthy elements with default predicate', () => { const result = dropWhile([2, 1, 0]); expect(result).toEqual([0]); }); it('should only filter truthy elements from the beginning with default predicate', () => { const result = dropWhile([1, 0, 1]); expect(result).toEqual([0, 1]); }); it('should only filter elements from the beginning', () => { const result = dropWhile(['a', 'b', 'c', 'b', 'a'], item => item === 'a'); expect(result).toEqual(['b', 'c', 'b', 'a']); }); it('should filter elements from the beginning by type', () => { const result = dropWhile(['a', 'b', 0, 'c', 'd', 1], item => typeof item === 'string'); expect(result).toEqual([0, 'c', 'd', 1]); }); }); describe('enforceLF', () => { it('should convert empty string to newline', () => { const result = enforceLF(''); expect(result).toBe('\n'); }); it('should keep multiple newlines', () => { const result = enforceLF('\n\n\n'); expect(result).toBe('\n\n\n'); }); it('should do nothing to a single newline', () => { const result = enforceLF('\n'); expect(result).toBe('\n'); }); it('should add newline to text without newline', () => { const result = enforceLF('some text'); expect(result).toBe('some text\n'); }); it('should do nothing to multiline text with newline at end', () => { const result = enforceLF('some text\nsome more\n'); expect(result).toBe('some text\nsome more\n'); }); it('should add newline to multiline text without newline at end', () => { const result = enforceLF('some text\nsome more'); expect(result).toBe('some text\nsome more\n'); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/colors.ts000066400000000000000000000020631425441362600274330ustar00rootroot00000000000000import { LoggerLevel } from './logger'; import { identity } from './utils'; export type ColorFunction = (...text: string[]) => string; export type LoggerColors = { [L in LoggerLevel]: ColorFunction; }; export interface Colors { /** * Used to mark text as important. Comparable to HTML's . */ strong: ColorFunction; /** * Used to mark text as less important. */ weak: ColorFunction; /** * Used to mark text as input such as commands, inputs, options, etc. */ input: ColorFunction; /** * Used to mark text as successful. */ success: ColorFunction; /** * Used to mark text as failed. */ failure: ColorFunction; /** * Used to mark text as ancillary or supportive. */ ancillary: ColorFunction; log: LoggerColors; } export const NO_COLORS: Colors = Object.freeze({ strong: identity, weak: identity, input: identity, success: identity, failure: identity, ancillary: identity, log: Object.freeze({ DEBUG: identity, INFO: identity, WARN: identity, ERROR: identity, }), }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/index.ts000066400000000000000000000027211425441362600272420ustar00rootroot00000000000000import { TTY_WIDTH, indent, sliceAnsi, stringWidth, stripAnsi, wordWrap } from '@ionic/utils-terminal'; import { NO_COLORS } from './colors'; import { Logger, createTaggedFormatter, StreamHandler, CreateTaggedFormatterOptions } from './logger'; import { OutputStrategy, StreamOutputStrategy } from './output'; export { TTY_WIDTH, indent, sliceAnsi, stringWidth, stripAnsi, wordWrap }; export * from './colors'; export * from './logger'; export * from './output'; export * from './tasks'; export interface CreateDefaultLoggerOptions { /** * Specify a custom output strategy to use for the logger. * * By default, the logger uses a output strategy with process.stdout and no colors. */ output?: OutputStrategy; /** * Specify custom logger formatter options. */ formatterOptions?: CreateTaggedFormatterOptions; } /** * Creates a logger instance with good defaults. */ export function createDefaultLogger({ output = new StreamOutputStrategy({ colors: NO_COLORS, stream: process.stdout }), formatterOptions }: CreateDefaultLoggerOptions = {}): Logger { const { weak } = output.colors; const prefix = process.argv.includes('--log-timestamps') ? () => `${weak('[' + new Date().toISOString() + ']')}` : ''; const formatter = createTaggedFormatter({ colors: output.colors, prefix, titleize: true, wrap: true, ...formatterOptions }); const handlers = new Set([new StreamHandler({ stream: output.stream, formatter })]); return new Logger({ handlers }); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/logger.ts000066400000000000000000000173521425441362600274200ustar00rootroot00000000000000import { WordWrapOptions, stringWidth, wordWrap } from '@ionic/utils-terminal'; import { Writable } from 'stream'; import * as util from 'util'; import { ColorFunction, Colors, NO_COLORS } from './colors'; import { dropWhile, enforceLF } from './utils'; export interface LogRecord { msg: string; logger: Logger; level?: LoggerLevelWeight; format?: boolean; } export type LoggerLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR'; export type LoggerLevelWeight = number; export type LoggerFormatter = (record: LogRecord) => string; export const LOGGER_LEVELS: { readonly [L in LoggerLevel]: LoggerLevelWeight; } = Object.freeze({ DEBUG: 10, INFO: 20, WARN: 30, ERROR: 40, }); export const LOGGER_LEVEL_NAMES: ReadonlyMap = new Map([ [LOGGER_LEVELS.DEBUG, 'DEBUG'], [LOGGER_LEVELS.INFO, 'INFO'], [LOGGER_LEVELS.WARN, 'WARN'], [LOGGER_LEVELS.ERROR, 'ERROR'], ]); export function getLoggerLevelName(level?: LoggerLevelWeight): LoggerLevel | undefined { if (level) { const levelName = LOGGER_LEVEL_NAMES.get(level); if (levelName) { return levelName; } } } export function getLoggerLevelColor(colors: Colors, level?: LoggerLevelWeight): ColorFunction | undefined { const levelName = getLoggerLevelName(level); if (levelName) { return colors.log[levelName]; } } export interface LoggerHandler { formatter?: LoggerFormatter; clone(): LoggerHandler; handle(record: LogRecord): void; } export interface StreamHandlerOptions { readonly stream: NodeJS.WritableStream; readonly filter?: (record: LogRecord) => boolean; readonly formatter?: LoggerFormatter; } export class StreamHandler implements LoggerHandler { readonly stream: NodeJS.WritableStream; readonly filter?: (record: LogRecord) => boolean; formatter?: LoggerFormatter; constructor({ stream, filter, formatter }: StreamHandlerOptions) { this.stream = stream; this.filter = filter; this.formatter = formatter; } clone(opts?: Partial): StreamHandler { const { stream, filter, formatter } = this; return new StreamHandler({ stream, filter, formatter, ...opts }); } handle(record: LogRecord): void { if (this.filter && !this.filter(record)) { return; } const msg = this.formatter && record.format !== false ? this.formatter(record) : record.msg; this.stream.write(enforceLF(msg)); } } const stdoutLogRecordFilter = (record: LogRecord) => !record.level || record.level === LOGGER_LEVELS.INFO; const stderrLogRecordFilter = (record: LogRecord) => !!record.level && record.level !== LOGGER_LEVELS.INFO; export const DEFAULT_LOGGER_HANDLERS: ReadonlySet = new Set([ new StreamHandler({ stream: process.stdout, filter: stdoutLogRecordFilter }), new StreamHandler({ stream: process.stderr, filter: stderrLogRecordFilter }), ]); export interface LoggerOptions { readonly handlers?: Set; readonly level?: LoggerLevelWeight; } export class Logger { handlers: Set; level: LoggerLevelWeight; constructor({ level = LOGGER_LEVELS.INFO, handlers }: LoggerOptions = {}) { this.level = level; this.handlers = handlers ? handlers : Logger.cloneHandlers(DEFAULT_LOGGER_HANDLERS); } static cloneHandlers(handlers: ReadonlySet): Set { return new Set([...handlers].map(handler => handler.clone())); } /** * Clone this logger, optionally overriding logger options. * * @param opts Logger options to override from this logger. */ clone(opts: Partial = {}): Logger { const { level, handlers } = this; return new Logger({ level, handlers: Logger.cloneHandlers(handlers), ...opts }); } /** * Log a message as-is. * * @param msg The string to log. */ msg(msg: string): void { this.log(this.createRecord(msg)); } /** * Log a message using the `debug` logger level. * * @param msg The string to log. */ debug(msg: string): void { this.log(this.createRecord(msg, LOGGER_LEVELS.DEBUG)); } /** * Log a message using the `info` logger level. * * @param msg The string to log. */ info(msg: string): void { this.log(this.createRecord(msg, LOGGER_LEVELS.INFO)); } /** * Log a message using the `warn` logger level. * * @param msg The string to log. */ warn(msg: string): void { this.log(this.createRecord(msg, LOGGER_LEVELS.WARN)); } /** * Log a message using the `error` logger level. * * @param msg The string to log. */ error(msg: string): void { this.log(this.createRecord(msg, LOGGER_LEVELS.ERROR)); } createRecord(msg: string, level?: LoggerLevelWeight, format?: boolean): LogRecord { return { // If the logger is used to quickly print something, let's pretty-print // it into a string. msg: util.format(msg), level, logger: this, format, }; } /** * Log newlines using a logger output found via `level`. * * @param num The number of newlines to log. * @param level The logger level. If omitted, the default output is used. */ nl(num = 1, level?: LoggerLevelWeight): void { this.log({ ...this.createRecord('\n'.repeat(num), level), format: false }); } /** * Log a record using a logger output found via `level`. */ log(record: LogRecord): void { if (typeof record.level === 'number' && this.level > record.level) { return; } for (const handler of this.handlers) { handler.handle(record); } } createWriteStream(level?: LoggerLevelWeight, format?: boolean): NodeJS.WritableStream { const self = this; return new class extends Writable { _write(chunk: any, encoding: string, callback: () => void) { self.log(self.createRecord(chunk.toString(), level, format)); callback(); } }(); } } export interface CreateTaggedFormatterOptions { prefix?: string | (() => string); titleize?: boolean; wrap?: boolean | WordWrapOptions; colors?: Colors; tags?: ReadonlyMap; } export function createTaggedFormatter({ colors = NO_COLORS, prefix = '', tags, titleize, wrap }: CreateTaggedFormatterOptions = {}): LoggerFormatter { const { strong, weak } = colors; const getLevelTag = (level?: LoggerLevelWeight): string => { if (!level) { return ''; } if (tags) { const tag = tags.get(level); return tag ? tag : ''; } const levelName = getLoggerLevelName(level); if (!levelName) { return ''; } const levelColor = getLoggerLevelColor(colors, level); return `${weak('[')}\x1b[40m${strong(levelColor ? levelColor(levelName) : levelName)}\x1b[49m${weak(']')}`; }; return ({ msg, level, format }) => { if (format === false) { return msg; } const [ firstLine, ...lines ] = msg.split('\n'); const levelColor = getLoggerLevelColor(colors, level); const tag = (typeof prefix === 'function' ? prefix() : prefix) + getLevelTag(level); const title = titleize && lines.length > 0 ? `${strong(levelColor ? levelColor(firstLine) : firstLine)}\n` : firstLine; const indentation = tag ? stringWidth(tag) + 1 : 0; const pulledLines = titleize ? dropWhile(lines, l => l === '') : lines; return ( (tag ? `${tag} ` : '') + (wrap ? wordWrap([title, ...pulledLines].join('\n'), { indentation, ...(typeof wrap === 'object' ? wrap : {}) }) : [title, ...pulledLines.map(l => l ? ' '.repeat(indentation) + l : '')].join('\n') ) ); }; } export function createPrefixedFormatter(prefix: string | (() => string)): LoggerFormatter { return ({ msg, format }) => { if (format === false) { return msg; } return `${typeof prefix === 'function' ? prefix() : prefix} ${msg}`; }; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/output.ts000066400000000000000000000065631425441362600275030ustar00rootroot00000000000000import { Cursor, EscapeCode } from '@ionic/utils-terminal'; import { Colors, NO_COLORS } from './colors'; import { ICON_FAILURE, ICON_SUCCESS, Spinner, TaskChain } from './tasks'; import { formatHrTime } from './utils'; export interface OutputStrategy { readonly stream: NodeJS.WritableStream; readonly colors: Colors; write(msg: string): boolean; createTaskChain(): TaskChain; } export interface StreamOutputStrategyOptions { readonly stream?: NodeJS.WritableStream; readonly colors?: Colors; } export class StreamOutputStrategy implements OutputStrategy { readonly stream: NodeJS.WritableStream; readonly colors: Colors; constructor({ stream = process.stdout, colors = NO_COLORS }: StreamOutputStrategyOptions) { this.stream = stream; this.colors = colors; } write(msg: string): boolean { return this.stream.write(msg); } createTaskChain(): TaskChain { const { failure, success, weak } = this.colors; const chain = new TaskChain(); chain.on('next', task => { task.on('end', result => { if (result.success) { this.write(`${success(ICON_SUCCESS)} ${task.msg} ${weak(`in ${formatHrTime(result.elapsedTime)}`)}\n`); } else { this.write(`${failure(ICON_FAILURE)} ${task.msg} ${failure(weak('- failed!'))}\n`); } }); }); return chain; } } export interface TTYOutputStrategyOptions extends StreamOutputStrategyOptions { readonly stream?: NodeJS.WriteStream; } export class TTYOutputStrategy extends StreamOutputStrategy implements OutputStrategy { readonly stream: NodeJS.WriteStream; protected readonly redrawer: TTYOutputRedrawer; constructor({ stream = process.stdout, colors = NO_COLORS }: TTYOutputStrategyOptions = {}) { super({ stream, colors }); this.stream = stream; this.redrawer = new TTYOutputRedrawer({ stream }); } createTaskChain(): TaskChain { const { failure, strong, success, weak } = this.colors; const chain = new TaskChain({ taskOptions: { tickInterval: 50 } }); chain.on('next', task => { task.on('end', result => { if (result.success) { this.write(`${success(ICON_SUCCESS)} ${task.msg} ${weak(`in ${formatHrTime(result.elapsedTime)}`)}\n`); } else { this.write(`${failure(ICON_FAILURE)} ${task.msg} ${failure(weak('- failed!'))}\n`); } }); const spinner = new Spinner(); task.on('tick', () => { const progress = task.progressRatio ? (task.progressRatio * 100).toFixed(2) : ''; const frame = spinner.frame(); this.redrawer.redraw(`${strong(frame)} ${task.msg}${progress ? ' (' + strong(String(progress) + '%') + ')' : ''} `); }); task.on('clear', () => { this.redrawer.clear(); }); }); chain.on('end', () => { this.redrawer.end(); }); return chain; } } export interface TTYOutputRedrawerOptions { readonly stream?: NodeJS.WriteStream; } export class TTYOutputRedrawer { readonly stream: NodeJS.WriteStream; constructor({ stream = process.stdout }: TTYOutputRedrawerOptions) { this.stream = stream; } get width(): number { return this.stream.columns || 80; } redraw(msg: string) { Cursor.hide(); this.stream.write(EscapeCode.eraseLines(1) + msg.replace(/[\r\n]+$/, '')); } clear() { this.stream.write(EscapeCode.eraseLines(1)); } end() { Cursor.show(); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/tasks.ts000066400000000000000000000107321425441362600272610ustar00rootroot00000000000000import { EventEmitter } from 'events'; const isWindows = process.platform === 'win32'; export const ICON_SUCCESS = isWindows ? '√' : '✔'; export const ICON_FAILURE = isWindows ? '×' : '✖'; const SPINNER_FRAMES = isWindows ? ['-', '\\', '|', '/'] : ['â ‹', 'â ™', 'â ¹', 'â ¸', 'â ¼', 'â ´', 'â ¦', 'â §', 'â ‡', 'â ']; export class Spinner { i = 0; constructor(public frames: string[] = SPINNER_FRAMES) {} frame(): string { return this.frames[this.i = ++this.i % this.frames.length]; } } export interface TaskOptions { readonly msg?: string; readonly tickInterval?: number; } export interface TaskResult { /** * Elapsed time from process.hrtime() */ elapsedTime: [number, number]; /** * Whether the task succeeded or not */ success: boolean; } export interface Task extends EventEmitter { on(name: 'success', handler: () => void): this; on(name: 'failure', handler: () => void): this; on(name: 'clear', handler: () => void): this; on(name: 'tick', handler: () => void): this; on(name: 'end', handler: (result: TaskResult) => void): this; emit(name: 'success'): boolean; emit(name: 'failure'): boolean; emit(name: 'clear'): boolean; emit(name: 'tick'): boolean; emit(name: 'end', result: TaskResult): boolean; } export class Task extends EventEmitter { tickInterval?: number; intervalId?: NodeJS.Timer; running = false; progressRatio?: number; protected _msg = ''; protected _startTime?: [number, number]; // hrtime protected _success = false; constructor({ msg = '', tickInterval }: TaskOptions = {}) { super(); this.msg = msg; this.tickInterval = tickInterval; } get msg(): string { return this._msg; } set msg(msg: string) { this._msg = msg; this.tick(); } start(): this { if (!this.running && this.tickInterval) { this.intervalId = setInterval(() => { this.tick(); }, this.tickInterval); } this.running = true; this._startTime = process.hrtime(); return this; } tick(): this { this.emit('tick'); return this; } progress(prog: number, total: number): this { this.progressRatio = prog / total; this.tick(); return this; } clear(): this { if (this.intervalId) { clearInterval(this.intervalId); this.intervalId = undefined; } this.emit('clear'); return this; } end(): this { this.running = false; this.tick(); this.clear(); this.emit('end', { elapsedTime: process.hrtime(this._startTime), success: this._success, }); return this; } succeed(): this { if (this.running) { this._success = true; this.end(); this.emit('success'); } return this; } fail(): this { if (this.running) { this._success = false; this.end(); this.emit('failure'); } return this; } } export interface TaskChain extends EventEmitter { on(name: 'end', handler: (lastTask?: Task) => void): this; on(name: 'failure', handler: (failedTask?: Task) => void): this; on(name: 'next', handler: (task: Task) => void): this; emit(name: 'end', lastTask?: Task): boolean; emit(name: 'failure', failedTask?: Task): boolean; emit(name: 'next', task: Task): boolean; } export interface TaskChainOptions { readonly taskOptions?: Partial; } export class TaskChain extends EventEmitter { protected current?: Task; protected readonly tasks: Task[]; protected readonly taskOptions: Partial; constructor({ taskOptions = {} }: TaskChainOptions = {}) { super(); this.tasks = []; this.taskOptions = taskOptions; } next(msg: string): Task { return this.nextTask(this.createTask({ msg, ...this.taskOptions })); } createTask(options: TaskOptions): Task { return new Task(options); } nextTask(task: Task): Task { if (this.current) { this.current.succeed(); } this.tasks.push(task); this.current = task; task.start(); this.emit('next', task); return task; } end(): this { const task = this.current; if (task) { task.succeed(); } this.current = undefined; this.emit('end', task); return this; } fail(): this { const task = this.current; if (task) { task.fail(); } this.emit('failure', task); return this; } cleanup(): this { for (const task of this.tasks) { if (task.running) { task.fail(); } else { task.clear(); } } return this; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/src/utils.ts000066400000000000000000000014241425441362600272720ustar00rootroot00000000000000export function identity(v: T): T { return v; } export function enforceLF(str: string): string { return str.match(/[\r\n]$/) ? str : str + '\n'; } export function dropWhile(array: readonly T[], predicate: (item: T) => boolean = v => !!v): T[] { let done = false; return array.filter(item => { if (done) { return true; } if (predicate(item)) { return false; } else { done = true; return true; } }); } const TIME_UNITS = ['s', 'ms', 'μs']; export function formatHrTime(hrtime: [number, number]): string { let time = hrtime[0] + hrtime[1] / 1e9; let index = 0; for (; index < TIME_UNITS.length - 1; index++, time *= 1000) { if (time >= 1) { break; } } return time.toFixed(2) + TIME_UNITS[index]; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-output/tsconfig.json000066400000000000000000000003571425441362600275060ustar00rootroot00000000000000{ "extends": "../../../tsconfig.base.json", "compilerOptions": { "outDir": "./dist", "types": [ "node" ] }, "include": [ "src/**/*.ts" ], "exclude": [ "node_modules", "src/**/__tests__/*.ts" ] } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/000077500000000000000000000000001425441362600251365ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/.gitignore000066400000000000000000000000221425441362600271200ustar00rootroot00000000000000dist node_modules ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/.npmrc000066400000000000000000000000231425441362600262510ustar00rootroot00000000000000package-lock=false ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/CHANGELOG.md000066400000000000000000000102501425441362600267450ustar00rootroot00000000000000# Change Log All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. ## [2.1.10](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.9...@ionic/cli-framework-prompts@2.1.10) (2022-06-16) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.9](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.8...@ionic/cli-framework-prompts@2.1.9) (2022-05-09) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.7...@ionic/cli-framework-prompts@2.1.8) (2020-09-29) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.6...@ionic/cli-framework-prompts@2.1.7) (2020-09-24) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.5...@ionic/cli-framework-prompts@2.1.6) (2020-08-28) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.4...@ionic/cli-framework-prompts@2.1.5) (2020-08-27) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.3...@ionic/cli-framework-prompts@2.1.4) (2020-08-25) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.2...@ionic/cli-framework-prompts@2.1.3) (2020-05-12) ### Bug Fixes * pin tslib to avoid "Cannot set property pathExists" error ([689e1f0](https://github.com/ionic-team/ionic-cli/commit/689e1f038b907356ef855a067a76d4822e7072a8)) ## [2.1.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.1...@ionic/cli-framework-prompts@2.1.2) (2020-05-06) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.1.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.1.0...@ionic/cli-framework-prompts@2.1.1) (2020-03-03) **Note:** Version bump only for package @ionic/cli-framework-prompts # 2.1.0 (2020-02-11) ### Features * **start:** add new list starter option ([#4315](https://github.com/ionic-team/ionic-cli/issues/4315)) ([1df44c1](https://github.com/ionic-team/ionic-cli/commit/1df44c1591f37b89f2b672857740edd6cb2aea67)) ## [2.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.0.1...@ionic/cli-framework-prompts@2.0.2) (2020-02-10) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [2.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@2.0.0...@ionic/cli-framework-prompts@2.0.1) (2020-02-03) **Note:** Version bump only for package @ionic/cli-framework-prompts # [2.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@1.0.4...@ionic/cli-framework-prompts@2.0.0) (2020-01-25) ### chore * require Node 10 ([5a47874](https://github.com/ionic-team/ionic-cli/commit/5a478746c074207b6dc96aa8771f04a606deb1ef)) ### BREAKING CHANGES * A minimum of Node.js 10.3.0 is required. ## [1.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@1.0.3...@ionic/cli-framework-prompts@1.0.4) (2019-12-10) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [1.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@1.0.2...@ionic/cli-framework-prompts@1.0.3) (2019-12-05) **Note:** Version bump only for package @ionic/cli-framework-prompts ## [1.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework-prompts@1.0.1...@ionic/cli-framework-prompts@1.0.2) (2019-11-21) **Note:** Version bump only for package @ionic/cli-framework-prompts ## 1.0.1 (2019-10-14) **Note:** Version bump only for package @ionic/cli-framework-prompts ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/LICENSE000066400000000000000000000020641425441362600261450ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2019 Drifty Co 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. ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/README.md000066400000000000000000000000371425441362600264150ustar00rootroot00000000000000# @ionic/cli-framework-prompts ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/jest.config.js000066400000000000000000000000671425441362600277100ustar00rootroot00000000000000module.exports = require('../../../jest.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/lint-staged.config.js000066400000000000000000000000761425441362600311560ustar00rootroot00000000000000module.exports = require('../../../lint-staged.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/package.json000066400000000000000000000020771425441362600274320ustar00rootroot00000000000000{ "name": "@ionic/cli-framework-prompts", "version": "2.1.10", "description": "The interactive prompts portion of Ionic CLI Framework", "homepage": "https://ionicframework.com/", "author": "Ionic Team (https://ionicframework.com)", "main": "./dist/index.js", "types": "./dist/index.d.ts", "engines": { "node": ">=10.3.0" }, "files": [ "dist/", "LICENSE", "README.md" ], "scripts": { "clean": "rimraf dist", "lint": "true", "build": "npm run clean && tsc", "watch": "tsc -w --preserveWatchOutput", "test": "jest --maxWorkers=4", "prepublishOnly": "npm run build" }, "license": "MIT", "dependencies": { "@ionic/utils-terminal": "2.3.3", "debug": "^4.0.0", "inquirer": "^7.0.0", "tslib": "^2.0.1" }, "devDependencies": { "@types/debug": "^4.1.1", "@types/inquirer": "0.0.43", "@types/jest": "^26.0.10", "@types/node": "~10.17.13", "jest": "^26.4.2", "jest-cli": "^26.0.1", "lint-staged": "^10.0.2", "ts-jest": "~26.3.0", "typescript": "~4.0.2" } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/src/000077500000000000000000000000001425441362600257255ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/src/__tests__/000077500000000000000000000000001425441362600276635ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/src/__tests__/index.ts000066400000000000000000000213201425441362600313400ustar00rootroot00000000000000describe('@ionic/cli-framework-prompts', () => { describe('createPromptModule', () => { const mockMute = jest.fn(); const mockClose = jest.fn(); const mockLogStream = {}; function setupPromptMocks({ value, tty }: { value?: any; tty: boolean; }) { const mocktty = tty; const mockCreatePromptModule = () => async (question: { name: string; }) => ({ [question.name]: value }); mockMute.mockReset(); mockClose.mockReset(); jest.resetModules(); jest.mock('@ionic/utils-terminal', () => ({ TERMINAL_INFO: { tty: mocktty } })); jest.mock('inquirer', () => ({ ui: { BottomBar: class { close = mockClose; log = mockLogStream; rl = { output: { mute: mockMute } } } }, createPromptModule: mockCreatePromptModule, })); return require('..'); } it('should provide empty string for no value', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input' }); expect(result).toEqual(''); }); it('should provide empty string for null value', async () => { const prompts = setupPromptMocks({ value: null, tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input' }); expect(result).toEqual(''); }); it('should provide empty string', async () => { const prompts = setupPromptMocks({ value: '', tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input' }); expect(result).toEqual(''); }); it('should provide string', async () => { const prompts = setupPromptMocks({ value: 'hello', tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input' }); expect(result).toEqual('hello'); }); it('should provide boolean true', async () => { const prompts = setupPromptMocks({ value: true, tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'confirm' }); expect(result).toEqual(true); }); it('should provide boolean false', async () => { const prompts = setupPromptMocks({ value: false, tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'confirm' }); expect(result).toEqual(false); }); it('should provide array of choices', async () => { const prompts = setupPromptMocks({ value: ['a', 'b', 'c'], tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'checkbox' }); expect(result).toEqual(['a', 'b', 'c']); }); it('should provide string cast from number value', async () => { const prompts = setupPromptMocks({ value: 42, tty: true }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input' }); expect(result).toEqual('42'); }); it('should provide empty string for input prompt for no value in non-tty mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: false }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input' }); expect(result).toEqual(''); }); it('should provide false for confirm prompt for no value in non-tty mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: false }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'confirm' }); expect(result).toEqual(false); }); it('should provide empty array for checkbox prompt for no value in non-tty mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: false }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'checkbox' }); expect(result).toEqual([]); }); it('should provide default value for no value in non-tty mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: false }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input', default: 'hello' }); expect(result).toEqual('hello'); }); it('should provide fallback value for no value and default value in non-tty mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: false }); const prompt = await prompts.createPromptModule(); const result = await prompt({ type: 'input', fallback: 'foo', default: 'bar' }); expect(result).toEqual('foo'); }); it('should provide onFallback value for no value and no fallback and default value in non-tty mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: false }); const prompt = await prompts.createPromptModule({ onFallback: () => 'foo' }); const result = await prompt({ type: 'input', default: 'bar' }); expect(result).toEqual('foo'); }); it('should pass question into provided onFallback in non-tty', async () => { const prompts = setupPromptMocks({ value: undefined, tty: false }); const onFallbackSpy = jest.fn().mockImplementation(() => 'foo'); const prompt = await prompts.createPromptModule({ onFallback: onFallbackSpy }); const question = { type: 'input', default: 'bar' }; const result = await prompt(question); expect(result).toEqual('foo'); expect(onFallbackSpy).toHaveBeenCalledTimes(1); expect(onFallbackSpy).toHaveBeenCalledWith(question); }); it('should provide empty string for input prompt for no value in non-interactive mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const prompt = await prompts.createPromptModule({ interactive: false }); const result = await prompt({ type: 'input' }); expect(result).toEqual(''); }); it('should provide false for confirm prompt for no value in non-interactive mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const prompt = await prompts.createPromptModule({ interactive: false }); const result = await prompt({ type: 'confirm' }); expect(result).toEqual(false); }); it('should provide empty array for checkbox prompt for no value in non-interactive mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const prompt = await prompts.createPromptModule({ interactive: false }); const result = await prompt({ type: 'checkbox' }); expect(result).toEqual([]); }); it('should provide default value for no value in non-interactive mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const prompt = await prompts.createPromptModule({ interactive: false }); const result = await prompt({ type: 'input', default: 'hello' }); expect(result).toEqual('hello'); }); it('should provide fallback value for no value and default value in non-interactive mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const prompt = await prompts.createPromptModule({ interactive: false }); const result = await prompt({ type: 'input', fallback: 'foo', default: 'bar' }); expect(result).toEqual('foo'); }); it('should provide onFallback value for no value and no fallback and default value in non-interactive mode', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const prompt = await prompts.createPromptModule({ interactive: false, onFallback: () => 'foo' }); const result = await prompt({ type: 'input', default: 'bar' }); expect(result).toEqual('foo'); }); it('should pass question into provided onFallback in non-interactive', async () => { const prompts = setupPromptMocks({ value: undefined, tty: true }); const onFallbackSpy = jest.fn().mockImplementation(() => 'foo'); const prompt = await prompts.createPromptModule({ interactive: false, onFallback: onFallbackSpy }); const question = { type: 'input', default: 'bar' }; const result = await prompt(question); expect(result).toEqual('foo'); expect(onFallbackSpy).toHaveBeenCalledTimes(1); expect(onFallbackSpy).toHaveBeenCalledWith(question); }); describe('_inquirer', () => { it('should get _inquirer module from prompt module', async () => { const prompts = setupPromptMocks({ tty: true }); const prompt = await prompts.createPromptModule(); expect(prompt._inquirer).toBeDefined(); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/src/index.ts000066400000000000000000000130351425441362600274060ustar00rootroot00000000000000import { TERMINAL_INFO } from '@ionic/utils-terminal'; import * as Debug from 'debug'; const debug = Debug('ionic:cli-framework-prompts'); export type Inquirer = import('inquirer').Inquirer; export type Question = import('inquirer').Question; export type Separator = import('inquirer').objects.Separator; let _inquirer: Inquirer | undefined; export interface PromptQuestionBase extends Question { /** * The prompt type for this question. * - 'confirm': Y/n * - 'checkbox': Multi-value selection. * - 'input': Text input. * - 'password': Masked text input. * - 'list': Single-value selection. */ type: PromptType; /** * The question to print. */ message: string; /** * The fallback value to use in non-TTY mode. */ fallback?: PromptValue; /** * Default value to use if nothing is entered. */ default?: PromptValue; } export type PromptTypeConfirm = 'confirm'; export type PromptTypeCheckbox = 'checkbox'; export type PromptTypeOther = 'input' | 'password' | 'list'; export type PromptType = PromptTypeConfirm | PromptTypeCheckbox | PromptTypeOther; export type PromptValueConfirm = boolean; export type PromptValueCheckbox = string[]; export type PromptValueOther = string; export type PromptValue = PromptValueConfirm | PromptValueCheckbox | PromptValueOther; export interface PromptQuestionConfirm extends PromptQuestionBase { type: PromptTypeConfirm; fallback?: PromptValueConfirm; default?: PromptValueConfirm; } export interface PromptQuestionCheckbox extends PromptQuestionBase { type: PromptTypeCheckbox; fallback?: PromptValueCheckbox; default?: PromptValueCheckbox; } export interface PromptQuestionOther extends PromptQuestionBase { type: PromptTypeOther; fallback?: PromptValueOther; default?: PromptValueOther; } export type PromptQuestion = PromptQuestionConfirm | PromptQuestionCheckbox | PromptQuestionOther; export interface PromptModule { readonly _inquirer: Inquirer; (question: PromptQuestionConfirm): Promise; (question: PromptQuestionCheckbox): Promise; (question: PromptQuestionOther): Promise; } async function loadInquirer(): Promise { if (!_inquirer) { _inquirer = await import('inquirer'); } return _inquirer; } export interface CreatePromptModuleOptions { readonly interactive?: boolean; readonly onFallback?: (question: PromptQuestion) => PromptValue | void; } /** * Create a reusable CLI prompt module. * * A prompt module is a function that generates prompts. A prompt opens an * interactive session with the user to gather input. When a prompt is * resolved, the user has finished providing input. * * If non-TTY mode is detected, a system of fallbacks goes into effect: * 1. If the question provided 'fallback', the fallback value is resolved. * 2. If the prompt module has 'onFallback', it is used to generate a * fallback for the question. * 3. If the question provided 'default', the default value is resolved. * 4. Finally, a falsy value suitable for the question type is resolved. * * @param options.interactive Force non-TTY mode by providing 'false'. TTY mode * cannot be forced if non-TTY mode is detected. * @param options.onFallback Generate a non-TTY fallback for a question without * a 'fallback'. */ export async function createPromptModule({ interactive, onFallback }: CreatePromptModuleOptions = {}): Promise { const inquirer = await loadInquirer(); const { createPromptModule: createInquirerPromptModule } = inquirer; const promptModule = createInquirerPromptModule(); async function createPrompter(question: PromptQuestionConfirm): Promise; async function createPrompter(question: PromptQuestionCheckbox): Promise; async function createPrompter(question: PromptQuestionOther): Promise; async function createPrompter(question: PromptQuestion): Promise { const { fallback, ...promptQuestion } = question; if (!TERMINAL_INFO.tty || interactive === false) { if (typeof fallback !== 'undefined') { debug('Answering with provided fallback value for non-tty mode: %o', fallback); return fallback; } else if (onFallback) { const generatedFallback = onFallback(question); if (typeof generatedFallback !== 'undefined') { debug(`Answering with fallback value from 'onFallback' for non-tty mode: %o`, generatedFallback); return generatedFallback; } } if (typeof promptQuestion.default !== 'undefined') { return promptQuestion.default; } if (question.type === 'confirm') { return false; } else if (question.type === 'checkbox') { return []; } return ''; } const name = 'name'; const prompt = promptModule({ ...promptQuestion, name }); const result = (await prompt)[name]; if (typeof result === 'undefined' || result === null) { return ''; } if (typeof result !== 'string' && typeof result !== 'boolean' && !Array.isArray(result)) { return String(result); } return result; } Object.defineProperties(createPrompter, { _inquirer: { value: inquirer }, }); return createPrompter as any as PromptModule; } export function createPromptChoiceSeparator(): Separator { if (!_inquirer) { throw new Error(`Prompt module not initialized. Call 'createPromptModule' first.`); } return new _inquirer.Separator(); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework-prompts/tsconfig.json000066400000000000000000000003571425441362600276520ustar00rootroot00000000000000{ "extends": "../../../tsconfig.base.json", "compilerOptions": { "outDir": "./dist", "types": [ "node" ] }, "include": [ "src/**/*.ts" ], "exclude": [ "node_modules", "src/**/__tests__/*.ts" ] } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/000077500000000000000000000000001425441362600234345ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/.gitignore000066400000000000000000000000761425441362600254270ustar00rootroot00000000000000*.js !tslint.js !jest.config.js !lint-staged.config.js *.d.ts ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/.npmignore000066400000000000000000000001011425441362600254230ustar00rootroot00000000000000src jest.config.js lint-staged.config.js tsconfig.json tslint.js ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/.npmrc000066400000000000000000000000231425441362600245470ustar00rootroot00000000000000package-lock=false ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/CHANGELOG.md000066400000000000000000000433671425441362600252620ustar00rootroot00000000000000# Change Log All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. ## [5.1.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.1.2...@ionic/cli-framework@5.1.3) (2022-06-16) **Note:** Version bump only for package @ionic/cli-framework ## [5.1.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.1.1...@ionic/cli-framework@5.1.2) (2022-05-09) **Note:** Version bump only for package @ionic/cli-framework ## [5.1.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.1.0...@ionic/cli-framework@5.1.1) (2022-03-04) **Note:** Version bump only for package @ionic/cli-framework # [5.1.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.0.6...@ionic/cli-framework@5.1.0) (2020-12-10) ### Features * **config:** add spaces option when writing JSON config ([#4612](https://github.com/ionic-team/ionic-cli/issues/4612)) ([fdd9bb2](https://github.com/ionic-team/ionic-cli/commit/fdd9bb26098441238adc56ea7a67b385a3b9a964)) ## [5.0.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.0.5...@ionic/cli-framework@5.0.6) (2020-09-29) **Note:** Version bump only for package @ionic/cli-framework ## [5.0.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.0.4...@ionic/cli-framework@5.0.5) (2020-09-24) **Note:** Version bump only for package @ionic/cli-framework ## [5.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.0.3...@ionic/cli-framework@5.0.4) (2020-09-02) **Note:** Version bump only for package @ionic/cli-framework ## [5.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.0.2...@ionic/cli-framework@5.0.3) (2020-08-29) **Note:** Version bump only for package @ionic/cli-framework ## [5.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.0.1...@ionic/cli-framework@5.0.2) (2020-08-28) **Note:** Version bump only for package @ionic/cli-framework ## [5.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@5.0.0...@ionic/cli-framework@5.0.1) (2020-08-27) **Note:** Version bump only for package @ionic/cli-framework # [5.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.2.2...@ionic/cli-framework@5.0.0) (2020-08-27) ### Code Refactoring * do not re-export from @ionic/cli-framework-output ([a91b5a4](https://github.com/ionic-team/ionic-cli/commit/a91b5a4cb76570154e560bdea3138a425833ce8c)) ### BREAKING CHANGES * Install `@ionic/cli-framework-output` and import from it directly. ## [4.2.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.2.1...@ionic/cli-framework@4.2.2) (2020-08-26) **Note:** Version bump only for package @ionic/cli-framework ## [4.2.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.2.0...@ionic/cli-framework@4.2.1) (2020-08-25) **Note:** Version bump only for package @ionic/cli-framework # [4.2.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.1.5...@ionic/cli-framework@4.2.0) (2020-06-02) ### Features * **help:** formatBeforeInputSummary and formatAfterInputSummary ([70ac3ab](https://github.com/ionic-team/ionic-cli/commit/70ac3ab633dc7dd65a2ac344c81a01f7914597b8)) ## [4.1.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.1.4...@ionic/cli-framework@4.1.5) (2020-05-12) ### Bug Fixes * pin tslib to avoid "Cannot set property pathExists" error ([689e1f0](https://github.com/ionic-team/ionic-cli/commit/689e1f038b907356ef855a067a76d4822e7072a8)) ## [4.1.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.1.3...@ionic/cli-framework@4.1.4) (2020-05-06) **Note:** Version bump only for package @ionic/cli-framework ## [4.1.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.1.2...@ionic/cli-framework@4.1.3) (2020-04-29) **Note:** Version bump only for package @ionic/cli-framework ## [4.1.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.1.1...@ionic/cli-framework@4.1.2) (2020-03-30) **Note:** Version bump only for package @ionic/cli-framework ## [4.1.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.1.0...@ionic/cli-framework@4.1.1) (2020-03-03) **Note:** Version bump only for package @ionic/cli-framework # 4.1.0 (2020-02-11) ### Features * **start:** add new list starter option ([#4315](https://github.com/ionic-team/ionic-cli/issues/4315)) ([1df44c1](https://github.com/ionic-team/ionic-cli/commit/1df44c1591f37b89f2b672857740edd6cb2aea67)) ## [4.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.0.1...@ionic/cli-framework@4.0.2) (2020-02-10) **Note:** Version bump only for package @ionic/cli-framework ## [4.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@4.0.0...@ionic/cli-framework@4.0.1) (2020-02-03) ### Bug Fixes * **help:** use proper full command/namespace name, not alias ([e42efc6](https://github.com/ionic-team/ionic-cli/commit/e42efc6ad6ce48545fe3f106720a9aa14af478f5)) # [4.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@3.0.6...@ionic/cli-framework@4.0.0) (2020-01-25) ### chore * require Node 10 ([5a47874](https://github.com/ionic-team/ionic-cli/commit/5a478746c074207b6dc96aa8771f04a606deb1ef)) ### BREAKING CHANGES * A minimum of Node.js 10.3.0 is required. ## [3.0.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@3.0.5...@ionic/cli-framework@3.0.6) (2020-01-13) **Note:** Version bump only for package @ionic/cli-framework ## [3.0.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@3.0.4...@ionic/cli-framework@3.0.5) (2019-12-10) ### Bug Fixes * **help:** make namespace/command groups unique when displaying ([32215b2](https://github.com/ionic-team/ionic-cli/commit/32215b27d4511bd8966bb07ba1663392f790336f)) ## [3.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@3.0.3...@ionic/cli-framework@3.0.4) (2019-12-05) **Note:** Version bump only for package @ionic/cli-framework ## [3.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@3.0.2...@ionic/cli-framework@3.0.3) (2019-11-25) **Note:** Version bump only for package @ionic/cli-framework ## [3.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@3.0.1...@ionic/cli-framework@3.0.2) (2019-11-24) ### Bug Fixes * fix parsing of command line options ([060f67c](https://github.com/ionic-team/ionic-cli/commit/060f67cf63d37662ae44c4ae952161464a5d553c)) ## [3.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@3.0.0...@ionic/cli-framework@3.0.1) (2019-11-21) **Note:** Version bump only for package @ionic/cli-framework # [3.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.8...@ionic/cli-framework@3.0.0) (2019-10-14) ### Code Refactoring * **prompts:** remove prompt support ([82241ef](https://github.com/ionic-team/ionic-cli/commit/82241ef7ddf8fdc6fc0db051a9acd0ed100c3fa8)) ### BREAKING CHANGES * **prompts:** This package no longer supports interactive prompts. See `@ionic/cli-framework-prompts`. ## [2.1.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.7...@ionic/cli-framework@2.1.8) (2019-10-14) **Note:** Version bump only for package @ionic/cli-framework ## [2.1.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.6...@ionic/cli-framework@2.1.7) (2019-09-18) **Note:** Version bump only for package @ionic/cli-framework ## [2.1.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.5...@ionic/cli-framework@2.1.6) (2019-08-28) **Note:** Version bump only for package @ionic/cli-framework ## [2.1.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.4...@ionic/cli-framework@2.1.5) (2019-08-23) **Note:** Version bump only for package @ionic/cli-framework ## [2.1.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.3...@ionic/cli-framework@2.1.4) (2019-08-14) ### Bug Fixes * **help:** custom colors are not passed to SchemaHelpFormatter ([#4115](https://github.com/ionic-team/ionic-cli/issues/4115)) ([5634e9f](https://github.com/ionic-team/ionic-cli/commit/5634e9f)) ## [2.1.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.2...@ionic/cli-framework@2.1.3) (2019-08-07) **Note:** Version bump only for package @ionic/cli-framework ## [2.1.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.1...@ionic/cli-framework@2.1.2) (2019-07-09) **Note:** Version bump only for package @ionic/cli-framework ## [2.1.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.1.0...@ionic/cli-framework@2.1.1) (2019-06-28) **Note:** Version bump only for package @ionic/cli-framework # [2.1.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.0.3...@ionic/cli-framework@2.1.0) (2019-06-21) ### Features * **validators:** `combine` for combining validators into one ([bcef698](https://github.com/ionic-team/ionic-cli/commit/bcef698)) ## [2.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.0.2...@ionic/cli-framework@2.0.3) (2019-06-18) **Note:** Version bump only for package @ionic/cli-framework ## [2.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.0.1...@ionic/cli-framework@2.0.2) (2019-06-10) **Note:** Version bump only for package @ionic/cli-framework ## [2.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@2.0.0...@ionic/cli-framework@2.0.1) (2019-06-05) **Note:** Version bump only for package @ionic/cli-framework # [2.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.7.0...@ionic/cli-framework@2.0.0) (2019-05-29) ### chore * **output:** remove unused BottomBar stuff ([e2023d1](https://github.com/ionic-team/ionic-cli/commit/e2023d1)) * require Node 8 ([5670e68](https://github.com/ionic-team/ionic-cli/commit/5670e68)) ### Features * Command-Line Completions ([9f66512](https://github.com/ionic-team/ionic-cli/commit/9f66512)) * **help:** color refactor ([5938429](https://github.com/ionic-team/ionic-cli/commit/5938429)) ### BREAKING CHANGES * **output:** Remove `BottomBarOutputStrategy` * A minimum of Node.js 8.9.4 is required. * **help:** option/command/namespace groups are now `MetadataGroup` # [1.7.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.6.3...@ionic/cli-framework@1.7.0) (2019-03-12) ### Features * **help:** add flair for paid content ([e7978e2](https://github.com/ionic-team/ionic-cli/commit/e7978e2)) ## [1.6.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.6.2...@ionic/cli-framework@1.6.3) (2019-03-06) **Note:** Version bump only for package @ionic/cli-framework ## [1.6.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.6.1...@ionic/cli-framework@1.6.2) (2019-02-27) **Note:** Version bump only for package @ionic/cli-framework ## [1.6.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.6.0...@ionic/cli-framework@1.6.1) (2019-02-15) **Note:** Version bump only for package @ionic/cli-framework # [1.6.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.5.3...@ionic/cli-framework@1.6.0) (2019-01-23) ### Features * **help:** text/link footnotes for descriptions ([2c74d53](https://github.com/ionic-team/ionic-cli/commit/2c74d53)) ## [1.5.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.5.2...@ionic/cli-framework@1.5.3) (2019-01-08) **Note:** Version bump only for package @ionic/cli-framework ## [1.5.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.5.1...@ionic/cli-framework@1.5.2) (2019-01-07) **Note:** Version bump only for package @ionic/cli-framework ## [1.5.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.5.0...@ionic/cli-framework@1.5.1) (2018-12-19) **Note:** Version bump only for package @ionic/cli-framework # [1.5.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.4.0...@ionic/cli-framework@1.5.0) (2018-11-27) ### Features * **help:** weaken the color of deprecated commands and options ([66f48d8](https://github.com/ionic-team/ionic-cli/commit/66f48d8)) * **shell:** error for subprocesses that exit via signal ([3af1cee](https://github.com/ionic-team/ionic-cli/commit/3af1cee)) # [1.4.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.3.0...@ionic/cli-framework@1.4.0) (2018-11-20) ### Bug Fixes * **config:** rewrite config for not found & syntax errors ([13298f1](https://github.com/ionic-team/ionic-cli/commit/13298f1)) * **terminal:** expand upon and fix Windows shell detection ([c3aa5a1](https://github.com/ionic-team/ionic-cli/commit/c3aa5a1)), closes [/github.com/ionic-team/ionic-cli/commit/dcc912d889011afd5944eaf4829bc8e5b4d0f4b6#commitcomment-31280556](https://github.com//github.com/ionic-team/ionic-cli/commit/dcc912d889011afd5944eaf4829bc8e5b4d0f4b6/issues/commitcomment-31280556) ### Features * **help:** spec for customizing option help schema ([73830bc](https://github.com/ionic-team/ionic-cli/commit/73830bc)) # [1.3.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.2.0...@ionic/cli-framework@1.3.0) (2018-11-04) ### Bug Fixes * **start:** fix stdio freezing issue on Windows ([#3725](https://github.com/ionic-team/ionic-cli/issues/3725)) ([a570770](https://github.com/ionic-team/ionic-cli/commit/a570770)) ### Features * **fn:** add function for resolving values from function series ([ac97f78](https://github.com/ionic-team/ionic-cli/commit/ac97f78)) # [1.2.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.1.1...@ionic/cli-framework@1.2.0) (2018-10-31) ### Bug Fixes * **config:** write json file with ending newline ([dc3f2a5](https://github.com/ionic-team/ionic-cli/commit/dc3f2a5)) * **help:** filter out unnecessary global options ([7809c99](https://github.com/ionic-team/ionic-cli/commit/7809c99)) * **process:** keep node running for `sleepForever()` ([ea08f8d](https://github.com/ionic-team/ionic-cli/commit/ea08f8d)) ### Features * **namespace:** add `useAliases` option to `locate()` ([489617b](https://github.com/ionic-team/ionic-cli/commit/489617b)) * **object:** add `keysWithoutAliases()` method to `AliasedMap` ([f4807f4](https://github.com/ionic-team/ionic-cli/commit/f4807f4)) * **terminal:** detect windows shell ([dcc912d](https://github.com/ionic-team/ionic-cli/commit/dcc912d)) ## [1.1.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.1.0...@ionic/cli-framework@1.1.1) (2018-10-05) **Note:** Version bump only for package @ionic/cli-framework # [1.1.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.7...@ionic/cli-framework@1.1.0) (2018-10-03) ### Features * **shell:** accept pathed name ([7e6c713](https://github.com/ionic-team/ionic-cli/commit/7e6c713)) * **shell:** provide which utility for finding binaries ([4dbe922](https://github.com/ionic-team/ionic-cli/commit/4dbe922)) ## [1.0.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.6...@ionic/cli-framework@1.0.7) (2018-09-05) **Note:** Version bump only for package @ionic/cli-framework ## [1.0.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.5...@ionic/cli-framework@1.0.6) (2018-08-20) ### Bug Fixes * **process:** catch and log errors in exit queue ([f3cd886](https://github.com/ionic-team/ionic-cli/commit/f3cd886)) ## [1.0.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.4...@ionic/cli-framework@1.0.5) (2018-08-09) ### Bug Fixes * **serve:** fix unclosed connection issue again ([#3500](https://github.com/ionic-team/ionic-cli/issues/3500)) ([1f0ef3b](https://github.com/ionic-team/ionic-cli/commit/1f0ef3b)) ## [1.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.3...@ionic/cli-framework@1.0.4) (2018-08-07) **Note:** Version bump only for package @ionic/cli-framework ## [1.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.2...@ionic/cli-framework@1.0.3) (2018-08-06) ### Bug Fixes * **serve:** properly cleanup child processes ([#3481](https://github.com/ionic-team/ionic-cli/issues/3481)) ([38217bf](https://github.com/ionic-team/ionic-cli/commit/38217bf)) * **serve:** use 127.0.0.1 to attempt connections ([#3476](https://github.com/ionic-team/ionic-cli/issues/3476)) ([12c3f35](https://github.com/ionic-team/ionic-cli/commit/12c3f35)) ## [1.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.1...@ionic/cli-framework@1.0.2) (2018-08-02) ### Bug Fixes * **serve:** check all network interfaces for an available port ([30fd6ef](https://github.com/ionic-team/ionic-cli/commit/30fd6ef)) ## [1.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.0...@ionic/cli-framework@1.0.1) (2018-07-30) **Note:** Version bump only for package @ionic/cli-framework # [1.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli-framework@1.0.0-rc.13...@ionic/cli-framework@1.0.0) (2018-07-25) **Note:** Version bump only for package @ionic/cli-framework ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/LICENSE000066400000000000000000000020641425441362600244430ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2017 Drifty Co 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. ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/README.md000066400000000000000000000017661425441362600247250ustar00rootroot00000000000000# CLI Framework, by Ionic The foundation framework of the Ionic CLI. ## Getting Started `index.js`: ```js const { Command, CommandMap, Namespace, execute } = require('@ionic/cli-framework'); class VersionCommand extends Command { async getMetadata() { return { name: 'version', summary: 'Print CLI version', }; } async run() { console.log('1.0.0'); } } class RootNamespace extends Namespace { async getMetadata() { return { name: 'mynewcli', summary: 'A cool CLI that prints its own version', }; } async getCommands() { return new CommandMap([['version', async () => new VersionCommand(this)]]); } } module.exports = async function(argv, env) { await execute({ namespace: new RootNamespace(), argv, env }); } ``` `bin/mynewcli`: ```javascript #!/usr/bin/env node const run = require('../'); run(process.argv.slice(2), process.env); ``` command line: ```bash $ ./bin/mynewcli $ ./bin/mynewcli version $ ./bin/mynewcli version --help ``` ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/jest.config.js000066400000000000000000000000671425441362600262060ustar00rootroot00000000000000module.exports = require('../../../jest.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/lint-staged.config.js000066400000000000000000000000761425441362600274540ustar00rootroot00000000000000module.exports = require('../../../lint-staged.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/package.json000066400000000000000000000027141425441362600257260ustar00rootroot00000000000000{ "name": "@ionic/cli-framework", "version": "5.1.3", "description": "The foundation framework of the Ionic CLI", "homepage": "https://ionicframework.com/", "author": "Ionic Team (https://ionicframework.com) ", "main": "./index.js", "types": "./index.d.ts", "engines": { "node": ">=10.3.0" }, "scripts": { "clean": "rimraf index.* definitions.* errors.* guards.* lib utils", "lint": "true", "build": "npm run clean && tsc", "watch": "tsc -w --preserveWatchOutput", "test": "jest --maxWorkers=4", "prepublishOnly": "npm run build" }, "license": "MIT", "dependencies": { "@ionic/cli-framework-output": "2.2.5", "@ionic/utils-array": "2.1.5", "@ionic/utils-fs": "3.1.6", "@ionic/utils-object": "2.1.5", "@ionic/utils-process": "2.1.10", "@ionic/utils-stream": "3.1.5", "@ionic/utils-subprocess": "2.1.11", "@ionic/utils-terminal": "2.3.3", "chalk": "^4.0.0", "debug": "^4.0.0", "lodash": "^4.17.5", "minimist": "^1.2.0", "rimraf": "^3.0.0", "tslib": "^2.0.1", "write-file-atomic": "^3.0.0" }, "devDependencies": { "@types/debug": "^4.1.1", "@types/jest": "^26.0.10", "@types/lodash": "^4.14.104", "@types/minimist": "^1.2.0", "@types/node": "~10.17.13", "@types/write-file-atomic": "^3.0.0", "jest": "^26.4.2", "jest-cli": "^26.0.1", "lint-staged": "^10.0.2", "ts-jest": "~26.3.0", "typescript": "~4.0.2" } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/000077500000000000000000000000001425441362600242235ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/definitions.ts000066400000000000000000000151701425441362600271120ustar00rootroot00000000000000import { Opts as ParseArgsOptions, ParsedArgs } from 'minimist'; export type ParsedArg = string | boolean | null | undefined | string[]; export type Validator = (input?: string, key?: string) => true | string; export type CommandLineInputs = string[]; export interface CommandLineOptions extends ParsedArgs { [arg: string]: ParsedArg; } export type CommandOptionType = StringConstructor | BooleanConstructor; export interface CommandMetadataInput { name: string; summary: string; validators?: Validator[]; } export interface TextFootnote { id: string | number; text: string; } export interface LinkFootnote { id: string | number; url: string; shortUrl?: string; } export type Footnote = TextFootnote | LinkFootnote; export const enum MetadataGroup { ADVANCED = 'advanced', BETA = 'beta', DEPRECATED = 'deprecated', EXPERIMENTAL = 'experimental', HIDDEN = 'hidden', PAID = 'paid', } export interface Metadata { name: string; summary: string; description?: string; footnotes?: Footnote[]; groups?: string[]; } export interface CommandMetadataOption extends Metadata { type?: CommandOptionType; default?: string | boolean; aliases?: string[]; spec?: { value?: string; }; } export { ParseArgsOptions }; export interface HydratedParseArgsOptions extends ParseArgsOptions { string: string[]; boolean: string[]; alias: { [key: string]: string[]; }; default: { [key: string]: string | boolean; }; } export interface CommandMetadata extends Metadata { exampleCommands?: string[]; inputs?: I[]; options?: O[]; } export interface CommandInstanceInfo, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { location: NamespaceLocateResult; env: NodeJS.ProcessEnv; executor: IExecutor; } export interface ICommand, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { namespace: N; getMetadata(runinfo?: Partial>): Promise; run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo?: Partial>): Promise; validate(argv: CommandLineInputs): Promise; } export type CommandMapGetter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> = () => Promise; export type NamespaceMapGetter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> = () => Promise; export type ICommandMap, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> = import('@ionic/utils-object').AliasedMap>; export type INamespaceMap, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> = import('@ionic/utils-object').AliasedMap>; export interface NamespaceLocateOptions { useAliases?: boolean; } export interface INamespace, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { root: N; parent: N | undefined; locate(argv: readonly string[], options?: NamespaceLocateOptions): Promise>; getMetadata(): Promise; getNamespaces(): Promise>; getCommands(): Promise>; getCommandMetadataList(): Promise[]>; groupCommandsByNamespace(commands: readonly HydratedCommandMetadata[]): Promise & { commands: readonly HydratedCommandMetadata[]; })[]>; } export type CommandPathItem, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> = [string, C | N]; export interface NamespaceLocateResult, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { readonly obj: C | N; readonly args: readonly string[]; readonly path: readonly CommandPathItem[]; } export type HydratedCommandMetadata, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> = M & { readonly command: C; readonly namespace: N; readonly path: readonly CommandPathItem[]; readonly aliases: readonly string[]; }; export interface NamespaceMetadata extends Metadata {} export interface HydratedNamespaceMetadata, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends Required> { readonly namespace: N; readonly aliases: readonly string[]; } export interface IExecutor, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { readonly namespace: N; locate(argv: readonly string[]): Promise>; execute(location: NamespaceLocateResult): Promise; execute(argv: readonly string[], env: NodeJS.ProcessEnv): Promise; run(command: C, cmdargs: readonly string[], runinfo?: Partial>): Promise; } export interface PackageJson { name: string; version: string; main?: string; description?: string; bin?: { [key: string]: string | undefined; }; scripts?: { [key: string]: string | undefined; }; dependencies?: { [key: string]: string | undefined; }; devDependencies?: { [key: string]: string | undefined; }; } export interface Validators { required: Validator; email: Validator; numeric: Validator; url: Validator; slug: Validator; } export interface ValidationError { key: string; message: string; validator: Validator; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/errors.ts000066400000000000000000000031031425441362600261040ustar00rootroot00000000000000import * as lodash from 'lodash'; import * as util from 'util'; import { ValidationError } from './definitions'; export const ERROR_INPUT_VALIDATION = 'ERR_ICF_INPUT_VALIDATION'; export const ERROR_COMMAND_NOT_FOUND = 'ERR_ICF_COMMAND_NOT_FOUND'; export const ERROR_IPC_MODULE_INACCESSIBLE = 'ERR_ICF_IPC_MODULE_INACCESSIBLE'; export const ERROR_IPC_UNKNOWN_PROCEDURE = 'ERR_ICF_IPC_UNKNOWN_PROCEDURE'; export abstract class BaseError extends Error { abstract readonly name: string; message: string; stack: string; code?: string; error?: Error; exitCode?: number; constructor(message: string) { super(message); this.message = message; this.stack = (new Error()).stack || ''; } toString(): string { const repr = lodash.pick(this, lodash.pull(lodash.keys(this), 'error')); return ( `${this.name}: ${this.message} ${util.inspect(repr, { breakLength: Infinity })} ${this.stack} ` + `${this.error ? `\nWrapped: ${this.error.stack ? this.error.stack : this.error}` : ''}` ); } inspect(): string { return this.toString(); } } export class InputValidationError extends BaseError { readonly name = 'InputValidationError'; code = ERROR_INPUT_VALIDATION; constructor(message: string, public errors: ValidationError[]) { super(message); } } export class CommandNotFoundError extends BaseError { readonly name = 'CommandNotFoundError'; code = ERROR_COMMAND_NOT_FOUND; constructor(message: string, public args: string[]) { super(message); } } export class IPCError extends BaseError { readonly name = 'IPCError'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/guards.ts000066400000000000000000000032151425441362600260610ustar00rootroot00000000000000import { CommandMetadata, CommandMetadataInput, CommandMetadataOption, HydratedCommandMetadata, ICommand, INamespace, LinkFootnote, PackageJson } from './definitions'; export function isNamespace, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption>(obj: any): obj is N { return obj && typeof obj.getMetadata === 'function' && typeof obj.getNamespaces === 'function' && typeof obj.getCommands === 'function'; } export function isCommand, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption>(obj: any): obj is C { return obj && isNamespace(obj.namespace) && typeof obj.getMetadata === 'function' && typeof obj.run === 'function' && typeof obj.validate === 'function'; } export function isHydratedCommandMetadata, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption>(obj: any): obj is HydratedCommandMetadata { return obj && typeof obj.name === 'string' && isCommand(obj.command) && isNamespace(obj.namespace) && Array.isArray(obj.path) && Array.isArray(obj.aliases); } export function isPackageJson(obj: any): obj is PackageJson { return obj && typeof obj.name === 'string'; } export function isLinkFootnote(obj: any): obj is LinkFootnote { return obj && (typeof obj.id === 'number' || typeof obj.id === 'string') && typeof obj.url === 'string'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/index.ts000066400000000000000000000001201425441362600256730ustar00rootroot00000000000000export * from './definitions'; export * from './errors'; export * from './lib'; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/000077500000000000000000000000001425441362600247715ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/000077500000000000000000000000001425441362600267275ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/command.ts000066400000000000000000000311021425441362600307120ustar00rootroot00000000000000import { CommandMetadata } from '../../definitions'; import { Command, CommandMap, CommandMapDefault, Namespace, NamespaceMap, generateCommandPath } from '../command'; class MyNamespace extends Namespace { async getMetadata(): Promise { return { name: 'my', summary: '', }; } async getNamespaces(): Promise { return new NamespaceMap([ ['foo', async () => new FooNamespace(this)], ['defns', async () => new NamespaceWithDefault(this)], ['f', 'foo'], ]); } } class NamespaceWithDefault extends Namespace { async getMetadata(): Promise { return { name: 'defns', summary: '', }; } async getCommands(): Promise { return new CommandMap([ [CommandMapDefault, async () => new DefaultCommand(this)], ]); } } class FooNamespace extends Namespace { async getMetadata(): Promise { return { name: 'foo', summary: '', }; } async getCommands(): Promise { return new CommandMap([ ['bar', async () => new BarCommand(this)], ['baz', async () => new BazCommand(this)], ['b', 'bar'], ]); } } class EmptyNamespace extends Namespace { async getMetadata(): Promise { return { name: 'empty', summary: '', }; } } class DefaultCommand extends Command { async getMetadata(): Promise { return { name: 'def', summary: '', }; } async run() {} } class BarCommand extends Command { async getMetadata(): Promise { return { name: 'bar', summary: '', }; } async run() {} } class BazCommand extends Command { async getMetadata(): Promise { return { name: 'baz', summary: '', }; } async run() {} } describe('@ionic/cli-framework', () => { describe('lib/command', () => { describe('Namespace', () => { describe('root and parent', () => { it('should have root attribute', async () => { const testNamespace = async (ns: Namespace) => { const namespaces = await ns.getNamespaces(); for (let [ , nsgetter ] of namespaces.entries()) { if (typeof nsgetter !== 'string' && typeof nsgetter !== 'symbol') { const namespace = await nsgetter(); expect(namespace.root).toBe(myns); await testNamespace(namespace); } } }; const myns = new MyNamespace(); await testNamespace(myns); }); it('should have parent attribute', async () => { const testNamespace = async (ns: Namespace) => { const namespaces = await ns.getNamespaces(); for (let [ , nsgetter ] of namespaces.entries()) { if (typeof nsgetter !== 'string' && typeof nsgetter !== 'symbol') { const namespace = await nsgetter(); expect(namespace.parent).toBe(ns); await testNamespace(namespace); } } }; const myns = new MyNamespace(); await testNamespace(myns); }); }); describe('getNamespaces', () => { it('should get subnamespaces', async () => { const testNamespace = async (ns: Namespace) => { const commands = await ns.getCommands(); const namespaces = await ns.getNamespaces(); for (let [ , cmdgetter ] of commands.entries()) { if (typeof cmdgetter === 'function') { const cmd = await cmdgetter(); expect(cmd.namespace).toBe(ns); } } for (let [ , nsgetter ] of namespaces.entries()) { if (typeof nsgetter !== 'string' && typeof nsgetter !== 'symbol') { const namespace = await nsgetter(); expect(namespace.parent).toBe(ns); await testNamespace(namespace); } } }; const myns = new MyNamespace(); await testNamespace(myns); }); }); describe('locate', () => { it('should locate root namespace with no args', async () => { const ns = new MyNamespace(); const { args, obj, path } = await ns.locate([]); expect(args).toEqual([]); expect(ns).toBe(obj); expect(path.length).toEqual(1); const [ ns1 ] = path; expect(ns1[0]).toEqual('my'); expect(ns1[1]).toBe(ns); }); it('should locate root namespace with args with no commands or namespaces', async () => { const ns = new MyNamespace(); const { args, obj, path } = await ns.locate(['x', 'y', 'z']); expect(args).toEqual(['x', 'y', 'z']); expect(ns).toBe(obj); expect(path.length).toEqual(1); const [ ns1 ] = path; expect(ns1[0]).toEqual('my'); expect(ns1[1]).toBe(ns); }); it('should locate foo namespace', async () => { const ns = new MyNamespace(); const { args, obj, path } = await ns.locate(['foo']); expect(args).toEqual([]); expect(obj).toBeInstanceOf(FooNamespace); const metadata = await obj.getMetadata(); expect(metadata.name).toEqual('foo'); expect(path.length).toEqual(2); const [ ns1, ns2 ] = path; expect(ns1[0]).toEqual('my'); expect(ns1[1]).toBe(ns); expect(ns2[0]).toEqual('foo'); expect(ns2[1]).toBeInstanceOf(FooNamespace); }); it('should locate default command', async () => { const ns = new MyNamespace(); const { args, obj, path } = await ns.locate(['defns']); expect(args).toEqual([]); expect(obj).toBeInstanceOf(DefaultCommand); const metadata = await obj.getMetadata(); expect(metadata.name).toEqual('def'); expect(path.length).toEqual(2); const [ ns1, cmd2 ] = path; expect(ns1[0]).toEqual('my'); expect(ns1[1]).toBe(ns); expect(cmd2[0]).toEqual('defns'); expect(cmd2[1]).toBeInstanceOf(DefaultCommand); }); it('should locate bar command in foo namespace', async () => { const ns = new MyNamespace(); const { args, obj, path } = await ns.locate(['foo', 'bar', 'arg1', 'arg2']); expect(args).toEqual(['arg1', 'arg2']); expect(obj).toBeInstanceOf(BarCommand); expect(path.length).toEqual(3); const [ ns1, ns2, cmd3 ] = path; expect(ns1[0]).toEqual('my'); expect(ns1[1]).toBe(ns); expect(ns2[0]).toEqual('foo'); expect(ns2[1]).toBeInstanceOf(FooNamespace); expect(cmd3[0]).toEqual('bar'); expect(cmd3[1]).toBeInstanceOf(BarCommand); }); it('should locate bar command in foo namespace by alias', async () => { const ns = new MyNamespace(); const { args, obj, path } = await ns.locate(['foo', 'b', 'arg1']); expect(args).toEqual(['arg1']); expect(obj).toBeInstanceOf(BarCommand); expect(path.length).toEqual(3); const [ ns1, ns2, cmd3 ] = path; expect(ns1[0]).toEqual('my'); expect(ns1[1]).toBe(ns); expect(ns2[0]).toEqual('foo'); expect(ns2[1]).toBeInstanceOf(FooNamespace); expect(cmd3[0]).toEqual('b'); expect(cmd3[1]).toBeInstanceOf(BarCommand); }); it('should locate bar command in foo namespace by aliases', async () => { const ns = new MyNamespace(); const { args, obj, path } = await ns.locate(['f', 'b', 'arg1']); expect(args).toEqual(['arg1']); expect(obj).toBeInstanceOf(BarCommand); expect(path.length).toEqual(3); const [ ns1, ns2, cmd3 ] = path; expect(ns1[0]).toEqual('my'); expect(ns1[1]).toBe(ns); expect(ns2[0]).toEqual('f'); expect(ns2[1]).toBeInstanceOf(FooNamespace); expect(cmd3[0]).toEqual('b'); expect(cmd3[1]).toBeInstanceOf(BarCommand); }); }); describe('getCommandMetadataList', () => { it('should return empty array for empty namespace', async () => { const ns = new EmptyNamespace(); const result = await ns.getCommandMetadataList(); expect(result).toEqual([]); }); it('should have namespace path without command path for default command', async () => { const ns = new NamespaceWithDefault(); const result = await ns.getCommandMetadataList(); expect(result.length).toEqual(1); expect(result[0].command).toBeInstanceOf(DefaultCommand); expect(result[0].namespace).toBe(ns); expect(result[0].path).toEqual([['defns', ns]]); }); it('should have correct path for command', async () => { const ns = new FooNamespace(); const result = await ns.getCommandMetadataList(); expect(result.length).toEqual(2); const [ barcmd, bazcmd ] = result; expect(barcmd.command).toBeInstanceOf(BarCommand); expect(barcmd.namespace).toBe(ns); expect(barcmd.path.length).toEqual(2); expect(barcmd.path[0][0]).toEqual('foo'); expect(barcmd.path[0][1]).toBe(ns); expect(barcmd.path[1][0]).toEqual('bar'); expect(barcmd.path[1][1]).toBeInstanceOf(BarCommand); expect(bazcmd.command).toBeInstanceOf(BazCommand); expect(bazcmd.namespace).toBe(ns); expect(bazcmd.path.length).toEqual(2); expect(bazcmd.path[0][0]).toEqual('foo'); expect(barcmd.path[0][1]).toBe(ns); expect(bazcmd.path[1][0]).toEqual('baz'); expect(bazcmd.path[1][1]).toBeInstanceOf(BazCommand); }); it('should have correct path for command in sub-namespace', async () => { const ns = new MyNamespace(); const result = await ns.getCommandMetadataList(); const bar = result.find(c => c.command instanceof BarCommand); if (!bar) { throw new Error('bar not defined'); } expect(bar.path.length).toEqual(3); expect(bar.path[0][0]).toEqual('my'); expect(bar.path[0][1]).toBe(ns); expect(bar.path[1][0]).toEqual('foo'); expect(bar.path[1][1]).toBeInstanceOf(FooNamespace); expect(bar.path[2][0]).toEqual('bar'); expect(bar.path[2][1]).toBeInstanceOf(BarCommand); }); it('should work', async () => { const ns = new MyNamespace(); const result = await ns.getCommandMetadataList(); expect(result.length).toEqual(3); const bar = result.find(c => c.command instanceof BarCommand); if (!bar) { throw new Error('bar not defined'); } const baz = result.find(c => c.command instanceof BazCommand); if (!baz) { throw new Error('baz not defined'); } const def = result.find(c => c.command instanceof DefaultCommand); if (!def) { throw new Error('def not defined'); } expect(bar.aliases).toEqual(['my foo b']); expect(def.aliases).toEqual([]); expect(baz.aliases).toEqual([]); }); }); }); describe('generateCommandPath', () => { // TODO: default commands? it('should get path for single namespace and command', async () => { const ns = new FooNamespace(); const { obj } = await ns.locate(['bar']); const result = await generateCommandPath(obj as any); expect(result.length).toEqual(2); const [ foons, barcmd ] = result; expect(foons).toBeDefined(); expect(foons[0]).toEqual('foo'); expect(foons[1]).toBe(ns); expect(barcmd).toBeDefined(); expect(barcmd[0]).toEqual('bar'); expect(barcmd[1]).toBeInstanceOf(BarCommand); }); it('should work back through nested namespace', async () => { const ns = new MyNamespace(); const { obj } = await ns.locate(['foo', 'bar']); const result = await generateCommandPath(obj as any); expect(result.length).toEqual(3); const [ rootns, foons, barcmd ] = result; expect(rootns).toEqual(['my', ns]); expect(foons).toBeDefined(); expect(foons[0]).toEqual('foo'); expect(foons[1]).toBeInstanceOf(FooNamespace); expect(barcmd).toBeDefined(); expect(barcmd[0]).toEqual('bar'); expect(barcmd[1]).toBeInstanceOf(BarCommand); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/completion.ts000066400000000000000000000076231425441362600314600ustar00rootroot00000000000000import { Command, CommandMap, CommandMapDefault, Namespace, NamespaceMap } from '../command'; import { CommandMetadata, NamespaceMetadata } from '../../definitions'; import { getCompletionWords } from '../completion'; class MyNamespace extends Namespace { async getMetadata(): Promise { return { name: 'my', summary: '', }; } async getNamespaces(): Promise { return new NamespaceMap([ ['foo', async () => new FooNamespace(this)], ['defns', async () => new NamespaceWithDefault(this)], ['f', 'foo'], ]); } } class NamespaceWithDefault extends Namespace { async getMetadata(): Promise { return { name: 'defns', summary: '', }; } async getCommands(): Promise { return new CommandMap([ [CommandMapDefault, async () => new DefaultCommand(this)], ]); } } class FooNamespace extends Namespace { async getMetadata(): Promise { return { name: 'foo', summary: '', }; } async getCommands(): Promise { return new CommandMap([ ['bar', async () => new BarCommand(this)], ['baz', async () => new BazCommand(this)], ['b', 'bar'], ]); } } class EmptyNamespace extends Namespace { async getMetadata(): Promise { return { name: 'empty', summary: '' }; } } class DefaultCommand extends Command { async getMetadata(): Promise { return { name: 'def', summary: '', options: [ { name: 'str-opt', summary: '', }, { name: 'bool-opt', summary: '', type: Boolean, default: true, }, ], }; } async run() {} } class BarCommand extends Command { async getMetadata(): Promise { return { name: 'bar', summary: '', options: [ { name: 'str-opt', summary: '', }, { name: 'bool-opt', summary: '', type: Boolean, default: true, }, ], }; } async run() {} } class BazCommand extends Command { async getMetadata(): Promise { return { name: 'baz', summary: '', }; } async run() {} } describe('@ionic/cli-framework', () => { describe('lib/completion', () => { describe('getCompletionWords', () => { it('should have no words for empty namespace', async () => { const ns = new EmptyNamespace(); const words = await getCompletionWords(ns, []); expect(words).toEqual([]); }); it('should return command words for a namespace', async () => { const ns = new FooNamespace(); const words = await getCompletionWords(ns, []); expect(words).toEqual(['bar', 'baz']); }); it('should return command and namespace words for a namespace', async () => { const ns = new MyNamespace(); const words = await getCompletionWords(ns, []); expect(words).toEqual(['defns', 'foo']); }); it('should return options from a default namespace', async () => { const ns = new MyNamespace(); debugger; const words = await getCompletionWords(ns, ['defns']); expect(words).toEqual(['--no-bool-opt', '--str-opt']); }); it('should return options from a command', async () => { const ns = new MyNamespace(); debugger; const words = await getCompletionWords(ns, ['foo', 'bar']); expect(words).toEqual(['--no-bool-opt', '--str-opt']); }); it('should return unique options from a command', async () => { const ns = new MyNamespace(); debugger; const words = await getCompletionWords(ns, ['foo', 'bar', '--str-opt']); expect(words).toEqual(['--no-bool-opt']); }); }) }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/config.ts000066400000000000000000000276601425441362600305570ustar00rootroot00000000000000describe('@ionic/cli-framework', () => { describe('BaseConfig', () => { let Config: any; let mockReadFileSync: jest.Mock; let mockMakeDirSync: jest.Mock; let mockWriteFileAtomicSync: jest.Mock; beforeEach(async () => { mockReadFileSync = jest.fn(); mockMakeDirSync = jest.fn(); mockWriteFileAtomicSync = jest.fn(); jest.resetModules(); jest.mock('fs', () => ({ readFileSync: mockReadFileSync })); jest.mock('@ionic/utils-fs', () => ({ mkdirpSync: mockMakeDirSync })); jest.mock('write-file-atomic', () => ({ sync: mockWriteFileAtomicSync })); const { BaseConfig } = await import('../config'); Config = class extends BaseConfig { provideDefaults() { return { defaulted: 5, }; } }; }); it('should store config file path', () => { const config = new Config('/path/to/file'); expect(config.p).toEqual('/path/to/file'); }); it('should call mkdirpSync upon setting c', () => { const config = new Config('/path/to/file'); config.c = {}; expect(mockMakeDirSync).toHaveBeenCalledTimes(1); expect(mockMakeDirSync).toHaveBeenCalledWith('/path/to'); }); it('should call writeFileAtomicSync upon setting c', () => { const config = new Config('/path/to/file'); config.c = {}; expect(mockWriteFileAtomicSync).toHaveBeenCalledTimes(1); expect(mockWriteFileAtomicSync).toHaveBeenCalledWith('/path/to/file', '{}\n'); }); it('should call readFileSync upon getting c', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{}'); config.c; expect(mockReadFileSync).toHaveBeenCalledTimes(1); expect(mockReadFileSync).toHaveBeenCalledWith('/path/to/file', 'utf8'); }); it('should provide defaults upon getting c', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{}'); const result = config.c; expect(result).toEqual({ defaulted: 5 }); }); it('should not override values with defaults upon getting c', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{"defaulted":10}'); const result = config.c; expect(result).toEqual({ defaulted: 10 }); }); it('should return defaults upon ENOENT', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => { throw { code: 'ENOENT' } }); const result = config.c; expect(result).toEqual({ defaulted: 5 }); }); it('should return defaults upon JSON syntax error', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => { throw { name: 'SyntaxError' } }); const result = config.c; expect(result).toEqual({ defaulted: 5 }); }); it('should rewrite file with defaults upon JSON syntax error', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => { throw { name: 'SyntaxError' } }); config.c; expect(mockWriteFileAtomicSync).toHaveBeenCalledTimes(1); expect(mockWriteFileAtomicSync).toHaveBeenCalledWith('/path/to/file', JSON.stringify({ defaulted: 5 }, undefined, 2) + '\n'); }); it('should throw upon unknown error', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => { throw new Error('unknown') }); expect(() => config.c).toThrow('unknown'); }); it('should get value from file', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{"foo":5}'); const result = config.get('foo'); expect(result).toEqual(5); }); it('should get object value from file', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{"foo":{"bar":"baz"}}'); const result = config.get('foo'); expect(result).toEqual({ bar: 'baz' }); }); it('should get value from provideDefaults', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{}'); const result = config.get('defaulted'); expect(result).toEqual(5); }); it('should get unknown value as undefined', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{}'); const result = config.get('unknown'); expect(result).not.toBeDefined(); }); it('should get value from file even with default provided', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{"foo":5}'); const result = config.get('foo', 10); expect(result).toEqual(5); }); it('should get default value with default provided if value in file does not exist', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{}'); const result = config.get('foo', 10); expect(result).toEqual(10); }); it('should set value in file', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{}'); jest.spyOn(config, 'provideDefaults').mockImplementation(() => ({})); config.set('foo', 5); expect(mockWriteFileAtomicSync).toHaveBeenCalledTimes(1); expect(mockWriteFileAtomicSync).toHaveBeenCalledWith('/path/to/file', '{\n "foo": 5\n}\n'); }); it('should unset value in file', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => '{"foo":5}'); jest.spyOn(config, 'provideDefaults').mockImplementation(() => ({})); config.unset('foo'); expect(mockWriteFileAtomicSync).toHaveBeenCalledTimes(1); expect(mockWriteFileAtomicSync).toHaveBeenCalledWith('/path/to/file', '{}\n'); }); }); describe('BaseConfig with pathPrefix', () => { let Config: any; let mockReadFileSync: jest.Mock; let mockMakeDirSync: jest.Mock; let mockWriteFileAtomicSync: jest.Mock; beforeEach(async () => { mockReadFileSync = jest.fn(); mockMakeDirSync = jest.fn(); mockWriteFileAtomicSync = jest.fn(); jest.resetModules(); jest.mock('fs', () => ({ readFileSync: mockReadFileSync })); jest.mock('@ionic/utils-fs', () => ({ mkdirpSync: mockMakeDirSync })); jest.mock('write-file-atomic', () => ({ sync: mockWriteFileAtomicSync })); const { BaseConfig } = await import('../config'); Config = class extends BaseConfig { provideDefaults() { return { defaulted: 5, }; } }; }); it('should provide defaults upon getting c', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{}'); const result = config.c; expect(result).toEqual({ defaulted: 5 }); }); it('should not override values with defaults upon getting c', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{"sub":{"defaulted":10}}'); const result = config.c; expect(result).toEqual({ defaulted: 10 }); }); it('should return defaults upon ENOENT', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => { throw { code: 'ENOENT' } }); const result = config.c; expect(result).toEqual({ defaulted: 5 }); }); it('should return defaults upon JSON syntax error', () => { const config = new Config('/path/to/file'); mockReadFileSync.mockImplementationOnce(() => { throw { name: 'SyntaxError' } }); const result = config.c; expect(result).toEqual({ defaulted: 5 }); }); it('should rewrite file with defaults upon JSON syntax error', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => { throw { name: 'SyntaxError' } }); config.c; expect(mockWriteFileAtomicSync).toHaveBeenCalledTimes(1); expect(mockWriteFileAtomicSync).toHaveBeenCalledWith('/path/to/file', JSON.stringify({ sub: { defaulted: 5 } }, undefined, 2) + '\n'); }); it('should throw upon unknown error', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => { throw new Error('unknown') }); expect(() => config.c).toThrow('unknown'); }); it('should get value from file', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{"sub":{"foo":5}}'); const result = config.get('foo'); expect(result).toEqual(5); }); it('should get value from file with many nested paths', () => { const config = new Config('/path/to/file', { pathPrefix: ['foo', 'bar', 'baz'] }); mockReadFileSync.mockImplementationOnce(() => '{"foo":{"bar":{"baz":{"prop":5}}}}'); const result = config.get('prop'); expect(result).toEqual(5); }); it('should get object value from file', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{"sub":{"foo":{"bar":"baz"}}}'); const result = config.get('foo'); expect(result).toEqual({ bar: 'baz' }); }); it('should get value from provideDefaults', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{"sub":{}}'); const result = config.get('defaulted'); expect(result).toEqual(5); }); it('should get value from provideDefaults if path prefix does not exist', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{}'); const result = config.get('defaulted'); expect(result).toEqual(5); }); it('should get unknown value as undefined', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{"sub":{}}'); const result = config.get('unknown'); expect(result).not.toBeDefined(); }); it('should get value from file even with default provided', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{"sub":{"foo":5}}'); const result = config.get('foo', 10); expect(result).toEqual(5); }); it('should get default value with default provided if value in file does not exist', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementationOnce(() => '{"sub":{}}'); const result = config.get('foo', 10); expect(result).toEqual(10); }); it('should set value in file', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementation(() => '{"sub":{}}'); jest.spyOn(config, 'provideDefaults').mockImplementation(() => ({})); config.set('foo', 5); expect(mockWriteFileAtomicSync).toHaveBeenCalledTimes(1); expect(mockWriteFileAtomicSync).toHaveBeenCalledWith('/path/to/file', '{\n "sub": {\n "foo": 5\n }\n}\n'); }); it('should unset value in file', () => { const config = new Config('/path/to/file', { pathPrefix: ['sub'] }); mockReadFileSync.mockImplementation(() => '{"sub":{"foo":5}}'); jest.spyOn(config, 'provideDefaults').mockImplementation(() => ({})); config.unset('foo'); expect(mockWriteFileAtomicSync).toHaveBeenCalledTimes(1); expect(mockWriteFileAtomicSync).toHaveBeenCalledWith('/path/to/file', '{\n "sub": {}\n}\n'); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/executor.ts000066400000000000000000000124521425441362600311410ustar00rootroot00000000000000import { Command, CommandMap, CommandMapDefault, Namespace, NamespaceMap } from '../command'; import { CommandMetadata, NamespaceMetadata } from '../../definitions'; import { Executor } from '../executor'; export const superspy = jest.fn(); class MyNamespace extends Namespace { async getMetadata(): Promise { return { name: 'my', summary: '', }; } async getNamespaces(): Promise { return new NamespaceMap([ ['foo', async () => new FooNamespace(this)], ['defns', async () => new NamespaceWithDefault(this)], ]); } } class NamespaceWithDefault extends Namespace { async getMetadata(): Promise { return { name: 'defns', summary: '', }; } async getCommands(): Promise { return new CommandMap([ [CommandMapDefault, async () => new DefaultCommand(this)], ]); } } class FooNamespace extends Namespace { async getMetadata(): Promise { return { name: 'foo', summary: '', }; } async getCommands(): Promise { return new CommandMap([ ['bar', async () => new BarCommand(this)], ['baz', async () => new BazCommand(this)], ['b', 'bar'], ]); } } class DefaultCommand extends Command { async getMetadata(): Promise { return { name: 'def', summary: '', }; } async run() {} } class BarCommand extends Command { async getMetadata(): Promise { return { name: 'bar', summary: '', options: [ { name: 'flag', summary: 'bool flag', type: Boolean, }, ], }; } async validate() { superspy('bar:validate', [...arguments]); } async run() { superspy('bar:run', [...arguments]); } } class BazCommand extends Command { async getMetadata(): Promise { return { name: 'baz', summary: '', }; } async run() {} } describe('@ionic/cli-framework', () => { const spy = jest.spyOn(module.exports, 'superspy'); beforeEach(() => { spy.mockReset(); }); describe('lib/executor', () => { describe('Executor', () => { describe('locate', () => { it('should locate bar command and retain command args', async () => { const namespace = new MyNamespace(); const executor = new Executor({ namespace }); const location = await executor.locate(['foo', 'bar', 'a', '--flag', 'b', '--', 'c']); expect(location.obj).toBeInstanceOf(BarCommand); expect(location.args).toEqual(['a', '--flag', 'b', '--', 'c']); const runPath = location.path.map(([n]) => n); expect(runPath).toEqual(['my', 'foo', 'bar']); }); }); describe('execute', () => { const TEST_CASE_1 = { input: ['foo', 'bar', 'a', '--flag', 'b', '--', 'c'], validate: (mock: any) => { expect(mock.calls.length).toEqual(2); const [ [ validateId, validateArgs ], [ runId, runArgs ] ] = mock.calls; expect(validateId).toEqual('bar:validate'); expect(validateArgs).toEqual([['a', 'b']]); expect(runId).toEqual('bar:run'); const args: any = runArgs; expect(args[0]).toEqual(['a', 'b']); expect(args[1]).toEqual({ '--': ['c'], '_': ['a', 'b'], flag: true }); expect(args[2].location.obj).toBeInstanceOf(BarCommand); const runPath = args[2].location.path.map(([n]: any) => n); const runPathObjs = args[2].location.path.map(([, o]: any) => o); expect(runPath).toEqual(['my', 'foo', 'bar']); expect(runPathObjs[0]).toBeInstanceOf(MyNamespace); expect(runPathObjs[1]).toBeInstanceOf(FooNamespace); expect(runPathObjs[2]).toBeInstanceOf(BarCommand); }, }; it('should call run function of found bar command using argv', async () => { const { input, validate } = TEST_CASE_1; const namespace = new MyNamespace(); const executor = new Executor({ namespace }); await executor.execute(input, {}); validate(spy.mock); }); it('should call run function of found bar command using location', async () => { const { input, validate } = TEST_CASE_1; const namespace = new MyNamespace(); const executor = new Executor({ namespace }); const location = await executor.locate(input); await executor.execute(location, {}); validate(spy.mock); }); }); describe('run', () => { it('should call run function of bar command', async () => { const namespace = new MyNamespace(); const executor = new Executor({ namespace }); const location = await namespace.locate(['foo', 'bar']); await executor.run(location.obj as any, []); expect(spy.mock.calls.length).toEqual(2); const [ [ validateId, validateArgs ], [ runId, runArgs ] ] = spy.mock.calls; expect(validateId).toEqual('bar:validate'); expect(validateArgs).toEqual([[]]); expect(runId).toEqual('bar:run'); expect(runArgs).toEqual([[], { '--': [], '_': [], flag: null }, undefined]); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/help.ts000066400000000000000000000262221425441362600302330ustar00rootroot00000000000000import { stripAnsi } from '@ionic/utils-terminal'; import { Command, CommandMap, CommandMapDefault, Namespace, NamespaceMap } from '../command'; import { CommandStringHelpFormatter, NamespaceStringHelpFormatter, NamespaceSchemaHelpFormatter } from '../help'; import { MetadataGroup } from '../../definitions'; class MyNamespace extends Namespace { async getMetadata() { return { name: 'my', summary: 'the my namespace', }; } async getNamespaces(): Promise { return new NamespaceMap([ ['foo', async () => new FooNamespace(this)], ['defns', async () => new NamespaceWithDefault(this)], ['f', 'foo'], ]); } async getCommands(): Promise { return new CommandMap([ ['bar', async () => new BarCommand(this)], ]); } } class NamespaceWithDefault extends Namespace { async getMetadata() { return { name: 'defns', summary: 'the defns namespace', groups: [MetadataGroup.BETA], }; } async getCommands(): Promise { return new CommandMap([ [CommandMapDefault, async () => new DefaultCommand(this)], ]); } } class FooNamespace extends Namespace { async getMetadata() { return { name: 'foo', summary: 'the foo namespace', description: 'my description with this footnote[^here] and more text', footnotes: [ { id: 'here', text: 'A footnote is a thing', }, ], }; } async getCommands(): Promise { return new CommandMap([ ['bar', async () => new BarCommand(this)], ['baz', async () => new BazCommand(this)], ['b', 'bar'], ['b1', 'baz'], ['b2', 'baz'], ]); } } class DefaultCommand extends Command { async getMetadata() { return { name: 'def', summary: 'the default command', groups: [MetadataGroup.BETA], }; } async run() {} async validate() {} } class BarCommand extends Command { async getMetadata() { return { name: 'bar', summary: 'the bar command', description: 'my description with a numeric link footnote[^1] and some more text', footnotes: [ { id: 1, url: 'https://ionicframework.com', }, ], inputs: [ { name: 'input1', summary: 'input1 summary' }, { name: 'input2', summary: 'input2 summary' }, ], options: [ { name: 'opt1', summary: 'opt1 summary', aliases: ['o'], spec: { value: 'optvalue' } }, { name: 'opt2', summary: 'opt2 summary', groups: [MetadataGroup.ADVANCED] }, { name: 'opt3', summary: 'opt3 summary', type: Boolean }, ], exampleCommands: ['', 'input1 input2', '--opt1 --opt2'], }; } async run() {} async validate() {} } class BazCommand extends Command { async getMetadata() { return { name: 'baz', summary: 'the baz command', }; } async run() {} async validate() {} } describe('@ionic/cli-framework', () => { describe('lib/help', () => { describe('CommandStringHelpFormatter', () => { it('should format a command appropriately', async () => { const myns = new MyNamespace(); const location = await myns.locate(['foo', 'b']); const formatter = new CommandStringHelpFormatter({ location, command: location.obj as any }); const result = await formatter.format(); expect(stripAnsi(result)).toEqual(` my foo bar - the bar command my description with a numeric link footnote[1] and some more text [1]: https://ionicframework.com Usage: $ my foo bar [] [] [options] Inputs: input1 .......................... (optional) input1 summary input2 .......................... (optional) input2 summary Options: --opt1=, -o=? ......... opt1 summary --opt2= ................... opt2 summary --opt3 .......................... opt3 summary Examples: $ my foo bar $ my foo bar input1 input2 $ my foo bar --opt1 --opt2 `); }); }); describe('NamespaceStringHelpFormatter', () => { it('should format a namespace appropriately', async () => { const myns = new MyNamespace(); const location = await myns.locate([]); const formatter = new NamespaceStringHelpFormatter({ location, namespace: location.obj as any }); const result = await formatter.format(); expect(stripAnsi(result)).toEqual(` my - the my namespace Usage: $ my [] [--help] [options] Commands: bar ............................. the bar command defns .............. (beta) the defns namespace (subcommands: def) foo ................ the foo namespace (subcommands: bar, baz) (alias: f) `); }); it('should format a subnamespace appropriately', async () => { const myns = new MyNamespace(); const location = await myns.locate(['f']); const formatter = new NamespaceStringHelpFormatter({ location, namespace: location.obj as any }); const result = await formatter.format(); expect(stripAnsi(result)).toEqual(` my foo - the foo namespace my description with this footnote[1] and more text [1]: A footnote is a thing Usage: $ my foo [] [--help] [options] Commands: bar ............................. the bar command (alias: b) baz ............................. the baz command (aliases: b1, b2) `); }); }); describe('NamespaceSchemaHelpFormatter', () => { it('should produce expected output for root namespace', async () => { const expected = { "name": "my", "summary": "the my namespace", "description": "", "groups": [], "aliases": [], "commands": [ { "name": "my bar", "namespace": [ "my" ], "summary": "the bar command", "description": "my description with a numeric link footnote[^1] and some more text", "groups": [], "exampleCommands": [ "my bar ", "my bar input1 input2", "my bar --opt1 --opt2" ], "footnotes": [ { "type": "link", "id": 1, "url": "https://ionicframework.com" } ], "aliases": [], "inputs": [ { "name": "input1", "summary": "input1 summary", "required": false }, { "name": "input2", "summary": "input2 summary", "required": false } ], "options": [ { "name": "opt1", "type": "string", "summary": "opt1 summary", "groups": [], "aliases": [ "o" ], "spec": { "value": "optvalue" }, }, { "name": "opt2", "type": "string", "summary": "opt2 summary", "aliases": [], "groups": [ "advanced" ], "spec": { "value": "opt2" }, }, { "name": "opt3", "type": "boolean", "summary": "opt3 summary", "aliases": [], "groups": [], "spec": { "value": "true/false" }, }, ] }, { "name": "my foo bar", "namespace": [ "my", "foo" ], "summary": "the bar command", "description": "my description with a numeric link footnote[^1] and some more text", "groups": [], "exampleCommands": [ "my foo bar ", "my foo bar input1 input2", "my foo bar --opt1 --opt2" ], "footnotes": [ { "type": "link", "id": 1, "url": "https://ionicframework.com" } ], "aliases": [ "my foo b" ], "inputs": [ { "name": "input1", "summary": "input1 summary", "required": false }, { "name": "input2", "summary": "input2 summary", "required": false } ], "options": [ { "name": "opt1", "type": "string", "summary": "opt1 summary", "groups": [], "aliases": [ "o" ], "spec": { "value": "optvalue" }, }, { "name": "opt2", "type": "string", "summary": "opt2 summary", "groups": [ "advanced" ], "aliases": [], "spec": { "value": "opt2" }, }, { "name": "opt3", "type": "boolean", "summary": "opt3 summary", "aliases": [], "groups": [], "spec": { "value": "true/false" }, }, ] }, { "name": "my foo baz", "namespace": [ "my", "foo" ], "summary": "the baz command", "description": "", "groups": [], "exampleCommands": [], "footnotes": [], "aliases": [ "my foo b1", "my foo b2" ], "inputs": [], "options": [] }, { "name": "my defns", "namespace": [ "my" ], "summary": "the default command", "description": "", "groups": [ "beta" ], "exampleCommands": [], "footnotes": [], "aliases": [], "inputs": [], "options": [] } ] }; const myns = new MyNamespace(); const location = await myns.locate([]); const formatter = new NamespaceSchemaHelpFormatter({ location, namespace: location.obj as any }); const result = await formatter.serialize(); expect(result).toEqual(expected); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/options.ts000066400000000000000000000332501425441362600307750ustar00rootroot00000000000000import * as minimist from 'minimist'; import { CommandMetadata } from '../../definitions'; import { OptionFilters, filterCommandLineOptions, filterCommandLineOptionsByGroup, metadataOptionsToParseArgsOptions, separateArgv, stripOptions, unparseArgs } from '../options'; describe('@ionic/cli-framework', () => { describe('lib/options', () => { describe('stripOptions', () => { it('should not affect only args', () => { const result = stripOptions(['a', 'b'], {}); expect(result).toEqual(['a', 'b']); }); it('should strip single hyphen options', () => { const result = stripOptions(['a', 'b', '-c'], {}); expect(result).toEqual(['a', 'b']); }); it('should strip double hyphen options', () => { const result = stripOptions(['a', 'b', '--opt1'], {}); expect(result).toEqual(['a', 'b']); }); it('should strip double hyphen options with equal sign', () => { const result = stripOptions(['a', 'b', '--opt1=test'], {}); expect(result).toEqual(['a', 'b']); }); it('should strip options from anywhere', () => { const result = stripOptions(['-f', 'a', '--opt1', 'b', '--opt2'], {}); expect(result).toEqual(['a', 'b']); }); it('should preserve options after -- separator', () => { const result = stripOptions(['-f', 'a', '--', '--opt1', 'b', '--opt2'], {}); expect(result).toEqual(['a', '--', '--opt1', 'b', '--opt2']); }); it('should remove options after -- separator if option is supplied', () => { const result = stripOptions(['-f', 'a', '--', '--opt1', 'b', '--opt2'], { includeSeparated: false }); expect(result).toEqual(['a']); }); }); describe('separateArgv', () => { it('should work for empty array', () => { const result = separateArgv([]); expect(result).toEqual([[], []]); }); it('should work for arg list with no separator', () => { const result = separateArgv(['a', 'b']); expect(result).toEqual([['a', 'b'], []]); }); it('should work for arg list with no separator with options', () => { const result = separateArgv(['a', '--foo', 'b']); expect(result).toEqual([['a', '--foo', 'b'], []]); }); it('should work for arg list with separator', () => { const result = separateArgv(['a', 'b', '--', 'c']); expect(result).toEqual([['a', 'b'], ['c']]); }); }); const metadata1: Required = { name: 'bar', summary: '', description: '', footnotes: [], exampleCommands: [], groups: [], inputs: [ { name: 'input1', summary: '', }, { name: 'input2', summary: '', }, ], options: [ { name: 'foo', summary: '', aliases: ['f'], groups: ['a'], }, { name: 'bar', summary: '', default: 'soup', groups: ['b'], }, { name: 'flag1', summary: '', type: Boolean, }, ], }; describe('metadataOptionsToParseArgsOptions', () => { it('should transform metadata to minimist options', () => { const result = metadataOptionsToParseArgsOptions(metadata1.options); expect(result).toEqual({ string: ['_', 'foo', 'bar'], boolean: ['flag1'], alias: { foo: ['f'], bar: [], flag1: [] }, default: { foo: null, bar: 'soup', flag1: null }, '--': true, }); }); describe('minimist arg parse', () => { it('should parse with empty argv', () => { const opts = metadataOptionsToParseArgsOptions(metadata1.options); const result = minimist([], opts); expect(result).toEqual({ _: [], foo: null, f: null, bar: 'soup', flag1: null, '--': [] }); }); it('should parse with comprehensive argv', () => { const opts = metadataOptionsToParseArgsOptions(metadata1.options); const result = minimist(['cat', '--foo', 'rabbit', 'dog', '--bar=salad', '--unknown', 'wow', '--flag1', 'extra', '--and-again'], opts); expect(result).toEqual({ _: ['cat', 'dog', 'extra'], foo: 'rabbit', f: 'rabbit', bar: 'salad', flag1: true, unknown: 'wow', 'and-again': true, '--': [] }); }); }); }); describe('unparseArgs', () => { it('should handle empty argv', () => { const result = unparseArgs({ _: [] }, {}); expect(result).toEqual([]); }); it('should filter out arguments', () => { const result = unparseArgs({ _: ['foo', 'bar'] }, {}); expect(result).toEqual(['foo', 'bar']); }); it('should parse out boolean option from minimist result', () => { const result = unparseArgs({ _: ['foo', 'bar'], wow: true }, {}); expect(result).toEqual(['foo', 'bar', '--wow']); }); it('should parse out single-letter boolean option from minimist result', () => { const result = unparseArgs({ _: ['foo', 'bar'], w: true }, {}); expect(result).toEqual(['foo', 'bar', '-w']); }); it('should parse out string option from minimist result', () => { const result = unparseArgs({ _: [], cat: 'meow' }, {}); expect(result).toEqual(['--cat=meow']); }); it('should parse out single-letter string option from minimist result', () => { const result = unparseArgs({ _: [], c: 'meow' }, {}); expect(result).toEqual(['-c=meow']); }); it('should parse out option list from minimist result', () => { const result = unparseArgs({ _: [], cat: 'meow', dog: 'bark', flag1: true }, {}); expect(result).toEqual(['--cat=meow', '--dog=bark', '--flag1']); }); it('should parse out option list from minimist result without equal signs', () => { const result = unparseArgs({ _: [], cat: 'meow', dog: 'bark', flag1: true }, { useEquals: false }); expect(result).toEqual(['--cat', 'meow', '--dog', 'bark', '--flag1']); }); it('should parse out string option from minimist result and not wrap strings with spaces in double quotes without flag', () => { const result = unparseArgs({ _: [], cat: 'meow meow meow' }, {}); expect(result).toEqual(['--cat=meow meow meow']); }); it('should parse out string option from minimist result and wrap strings with spaces in double quotes with flag provided', () => { const result = unparseArgs({ _: [], cat: 'meow meow meow' }, { useDoubleQuotes: true }); expect(result).toEqual(['--cat="meow meow meow"']); }); it('should account for -- separator', () => { const result = unparseArgs({ _: [], '--': ['--claws'], cat: 'meow meow meow' }, { useDoubleQuotes: true }); expect(result).toEqual(['--cat="meow meow meow"', '--', '--claws']); }); it('should account for empty -- separator', () => { const result = unparseArgs({ _: [], '--': [], cat: 'meow meow meow' }, { useDoubleQuotes: true }); expect(result).toEqual(['--cat="meow meow meow"']); }); it('should account for double -- separator', () => { const result = unparseArgs({ _: [], '--': ['--', '--claws'], cat: 'meow meow meow' }, { useDoubleQuotes: true }); expect(result).toEqual(['--cat="meow meow meow"', '--', '--', '--claws']); }); it('should account for args, options, and -- args', () => { const result = unparseArgs({ _: ['foo', 'bar'], '--': ['--', '--claws'], cat: 'meow meow meow' }, { useDoubleQuotes: true }); expect(result).toEqual(['foo', 'bar', '--cat="meow meow meow"', '--', '--', '--claws']); }); it('should ignore false values with ignoreFalse', () => { const result = unparseArgs({ _: [], flag1: false }, { ignoreFalse: true }); expect(result).toEqual([]); }); it('should not ignore false values with ignoreFalse set to false', () => { const result = unparseArgs({ _: [], flag1: false }, { ignoreFalse: false }); expect(result).toEqual(['--no-flag1']); }); it('should account for aliases', () => { const result = unparseArgs({ _: [], foo: 'foo', fo: 'foo', f: 'foo', bar: 'bar', b: 'bar', baz: 'baz' }, {}, { alias: { foo: ['f', 'fo'], bar: 'b' } }); expect(result).toEqual(['--foo=foo', '--bar=bar', '--baz=baz']); }); it('should filter out unknown options if requested', () => { const result = unparseArgs({ _: [], foo: 'foo', flag1: true }, {}, { unknown: () => false }); expect(result).toEqual([]); }); it('should keep known options', () => { const result = unparseArgs({ _: [], foo: 'foo', bar: 'bar', flag1: true, flag2: true }, {}, { string: ['foo'], boolean: ['flag1'], unknown: () => false }); expect(result).toEqual(['--foo=foo', '--flag1']); }); it('should keep known options by alias', () => { const result = unparseArgs({ _: [], foo: 'foo', f: 'foo', bar: 'bar', flag1: true, flag2: true }, {}, { string: ['foo'], boolean: ['flag1'], alias: { foo: ['f'] }, unknown: () => false }); expect(result).toEqual(['--foo=foo', '--flag1']); }); }); describe('filterCommandLineOptions', () => { it('should return empty object for empty input', () => { const result = filterCommandLineOptions(metadata1.options, { _: [] }); expect(result).toEqual({ _: [] }); }); it('should return args if supplied', () => { const result = filterCommandLineOptions(metadata1.options, { _: ['a', 'b'] }, opt => true); expect(result).toEqual({ _: ['a', 'b'] }); }); it('should include all known & supplied options using a true predicate', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], foo: 'hi', flag1: true }, opt => true); expect(result).toEqual({ _: [], foo: 'hi', flag1: true }); }); it('should include all known & supplied options without a predicate', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], foo: 'hi', flag1: true }); expect(result).toEqual({ _: [], foo: 'hi', flag1: true }); }); it('should include options with aliases', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], f: 'hi', flag1: true }); expect(result).toEqual({ _: [], foo: 'hi', flag1: true }); }); it('should return empty object for a false predicate', () => { const result = filterCommandLineOptions(metadata1.options, { _: [] }, opt => false); expect(result).toEqual({ _: [] }); }); it('should exclude unknown options even with a true predicate', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], unknown: 'yep', bar: 'hi', flag1: true }, opt => true); expect(result).toEqual({ _: [], bar: 'hi', flag1: true }); }); it('should exclude options that do not match the predicate using opt', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], unknown: 'yep', foo: 'wow', bar: 'hi', flag1: true }, opt => opt.groups ? opt.groups.includes('a') : false); expect(result).toEqual({ _: [], foo: 'wow' }); }); it('should exclude options that do not match the predicate using value', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], unknown: 'yep', foo: 'wow', bar: 'hi', flag1: true }, (opt, value) => value === 'hi'); expect(result).toEqual({ _: [], bar: 'hi' }); }); it('should include separated args from original parsed args', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], '--': ['some', 'more', '--args'] }); expect(result).toEqual({ _: [], '--': ['some', 'more', '--args'] }); }); describe('OptionFilters.includesGroups', () => { it('should include single group', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], foo: 'wow', bar: 'nope', flag1: true }, OptionFilters.includesGroups('a')); expect(result).toEqual({ _: [], foo: 'wow' }); }); it('should include multiple groups', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], foo: 'wow', bar: 'nope', flag1: true }, OptionFilters.includesGroups(['a', 'b'])); expect(result).toEqual({ _: [], foo: 'wow', bar: 'nope' }); }); }); describe('OptionFilters.excludesGroups', () => { it('should exclude single groups', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], foo: 'wow', bar: 'nope', flag1: true }, OptionFilters.excludesGroups('a')); expect(result).toEqual({ _: [], bar: 'nope', flag1: true }); }); it('should exclude multiple groups', () => { const result = filterCommandLineOptions(metadata1.options, { _: [], foo: 'wow', bar: 'nope', flag1: true }, OptionFilters.excludesGroups(['a', 'b'])); expect(result).toEqual({ _: [], flag1: true }); }); }); }); describe('filterCommandLineOptionsByGroup', () => { it('should exclude options not in group a', () => { const result = filterCommandLineOptionsByGroup(metadata1.options, { _: [], unknown: 'yep', foo: 'wow', bar: 'hi', flag1: true }, 'a'); expect(result).toEqual({ _: [], foo: 'wow' }); }); it('should exclude options not in group a or b', () => { const result = filterCommandLineOptionsByGroup(metadata1.options, { _: [], unknown: 'yep', foo: 'wow', bar: 'hi', flag1: true }, ['a', 'b']); expect(result).toEqual({ _: [], foo: 'wow', bar: 'hi' }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/__tests__/validators.ts000066400000000000000000000145061425441362600314550ustar00rootroot00000000000000import { stripAnsi } from '@ionic/utils-terminal'; import { contains, validators } from '../validators'; describe('@ionic/cli-framework', () => { describe('lib/validators', () => { describe('validators', () => { describe('required', () => { it('should return a generic message if the input is not given', () => { const result = validators.required(); expect(result).toEqual('Must not be empty.'); }); it('should return a generic message if the input is an empty string', () => { const result = validators.required(''); expect(result).toEqual('Must not be empty.'); }); it('should return a name-specific message if the input is not given and a name is provided', () => { const result = validators.required(undefined, 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key must not be empty.'); }); it('should return a name-specific message if the input is an empty string and a name is provided', () => { const result = validators.required('', 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key must not be empty.'); }); it('should validate falsy input', () => { const falsy = ['0', 'false']; for (const v of falsy) { const result = validators.required(v); expect(result).toBe(true); } }); it('should validate input', () => { const result = validators.required('some input'); expect(result).toBe(true); }); }); describe('email', () => { it('should return a generic message if the email is an empty string', () => { const result = validators.email(''); expect(result).toEqual('Invalid email address.'); }); it('should return a name-specific message if the email is empty and a name is provided', () => { const result = validators.email('', 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key is an invalid email address.'); }); it('should return a string if email address is invalid', () => { const r3 = validators.email('asdf'); const r4 = validators.email('foo@foo'); expect(stripAnsi(r3 as any)).toEqual('Invalid email address.'); expect(stripAnsi(r4 as any)).toEqual('Invalid email address.'); }); it('should validate an email', () => { const result = validators.email('a@b.c'); expect(result).toBe(true); }); }); // TODO: url // TODO: numeric describe('slug', () => { it('should return a generic message if the slug is invalid', () => { const result = validators.slug('A'); expect(result).toEqual('Invalid slug (machine name).'); }); it('should return a name-specific message if the slug is invalid and a name is provided', () => { const result = validators.slug('A', 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key is an invalid slug (machine name).'); }); it('should validate a slug', () => { const result = validators.slug('a-b-c'); expect(result).toBe(true); }); }); }); describe('contains', () => { it('should generate a validator that handles input not given', () => { const validator = contains(['foo', 'bar', 'baz'], {}); const result = validator(); expect(stripAnsi(result as any)).toEqual('Must be one of: foo, bar, baz (not unset)'); }); it('should generate a validator that handles input not given with the given key', () => { const validator = contains(['foo', 'bar', 'baz'], {}); const result = validator(undefined, 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key must be one of: foo, bar, baz (not unset)'); }); it('should generate a validator that handles input not in collection', () => { const validator = contains(['foo', 'bar', 'baz'], {}); const result = validator('my input'); expect(stripAnsi(result as any)).toEqual('Must be one of: foo, bar, baz (not my input)'); }); it('should generate a validator that handles input not in collection with the given key', () => { const validator = contains(['foo', 'bar', 'baz'], {}); const result = validator('my input', 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key must be one of: foo, bar, baz (not my input)'); }); it('should generate a validator that handles empty input', () => { const validator = contains(['foo', 'bar', 'baz'], {}); const result = validator(''); expect(stripAnsi(result as any)).toEqual('Must be one of: foo, bar, baz (not empty)'); }); it('should generate a validator that handles empty input with the given key', () => { const validator = contains(['foo', 'bar', 'baz'], {}); const result = validator('', 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key must be one of: foo, bar, baz (not empty)'); }); it('should generate a validator that handles empty input in collection that allows unset input', () => { const validator = contains(['foo', 'bar', 'baz', undefined], {}); const result = validator(''); expect(stripAnsi(result as any)).toEqual('Must be unset or one of: foo, bar, baz (not empty)'); }); it('should generate a validator that handles empty input in collection that allows unset input with the given key', () => { const validator = contains(['foo', 'bar', 'baz', undefined], {}); const result = validator('', 'my_key'); expect(stripAnsi(result as any)).toEqual('my_key must be unset or one of: foo, bar, baz (not empty)'); }); it('should generate a validator that validates input in the collection', () => { const validator = contains(['foo', 'bar', 'baz'], {}); const result = validator('foo'); expect(stripAnsi(result as any)).toBe(true); }); it('should generate a validator that validates input that is not given', () => { const validator = contains(['foo', 'bar', 'baz', undefined], {}); const result = validator(); expect(stripAnsi(result as any)).toBe(true); }); }); // TODO: combine }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/colors.ts000066400000000000000000000034671425441362600266540ustar00rootroot00000000000000import { ColorFunction, Colors as BaseColors } from '@ionic/cli-framework-output'; import * as chalk from 'chalk'; import * as lodash from 'lodash'; import { MetadataGroup } from '../definitions'; export { ColorFunction, LoggerColors } from '@ionic/cli-framework-output'; export type HelpGroupColors = { [G in Exclude]: ColorFunction; }; export interface HelpColors { /** * Used to color the section titles in help output. */ title: ColorFunction; group: HelpGroupColors; } export interface Colors extends BaseColors { help: HelpColors; } export const DEFAULT_COLORS: Colors = Object.freeze({ strong: chalk.bold, weak: chalk.dim, input: chalk.cyan, success: chalk.green, failure: chalk.red, ancillary: chalk.cyan, log: Object.freeze({ DEBUG: chalk.magenta, INFO: chalk.white, WARN: chalk.yellow, ERROR: chalk.red, }), help: Object.freeze({ title: chalk.bold, group: Object.freeze({ [MetadataGroup.DEPRECATED]: chalk.yellow, [MetadataGroup.BETA]: chalk.magenta, [MetadataGroup.EXPERIMENTAL]: chalk.red, [MetadataGroup.PAID]: chalk.green, }), }), }); export const NO_COLORS: Colors = Object.freeze({ strong: lodash.identity, weak: lodash.identity, input: lodash.identity, success: lodash.identity, failure: lodash.identity, ancillary: lodash.identity, log: Object.freeze({ DEBUG: lodash.identity, INFO: lodash.identity, WARN: lodash.identity, ERROR: lodash.identity, }), help: Object.freeze({ title: lodash.identity, group: Object.freeze({ [MetadataGroup.DEPRECATED]: lodash.identity, [MetadataGroup.BETA]: lodash.identity, [MetadataGroup.EXPERIMENTAL]: lodash.identity, [MetadataGroup.PAID]: lodash.identity, }), }), }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/command.ts000066400000000000000000000261571425441362600267720ustar00rootroot00000000000000import { AliasedMap } from '@ionic/utils-object'; import * as lodash from 'lodash'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMapGetter, CommandMetadata, CommandMetadataInput, CommandMetadataOption, CommandPathItem, HydratedCommandMetadata, HydratedNamespaceMetadata, ICommand, ICommandMap, INamespace, INamespaceMap, NamespaceLocateOptions, NamespaceLocateResult, NamespaceMapGetter, NamespaceMetadata, ValidationError } from '../definitions'; import { InputValidationError } from '../errors'; import { strcmp } from '../utils/string'; import { validate } from './validators'; export abstract class BaseCommand, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { constructor(public namespace: N) {} abstract getMetadata(): Promise; abstract run(inputs: CommandLineInputs, options: CommandLineOptions, runtime?: Partial>): Promise; async validate(argv: CommandLineInputs): Promise { const metadata = await this.getMetadata(); if (!metadata.inputs) { return; } const errors: ValidationError[][] = []; for (const i in metadata.inputs) { const input = metadata.inputs[i]; if (input.validators && input.validators.length > 0) { try { validate(argv[i], input.name, [...input.validators]); } catch (e) { if (!(e instanceof InputValidationError)) { throw e; } errors.push(e.errors); } } } if (errors.length > 0) { throw new InputValidationError('Invalid inputs.', lodash.flatten(errors)); } } } export const CommandMapDefault = Symbol('default'); export class BaseCommandMap, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends AliasedMap> implements ICommandMap {} export class BaseNamespaceMap, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends AliasedMap> implements INamespaceMap {} export abstract class BaseNamespace, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> implements INamespace { parent: N | undefined; constructor(parent?: N) { this.parent = parent; } get root(): N { let n: any = this; while (n.parent) { n = n.parent; } return n; } abstract getMetadata(): Promise; // TODO: https://github.com/Microsoft/TypeScript/issues/9659 async getNamespaces(): Promise> { return new BaseNamespaceMap(); } // TODO: https://github.com/Microsoft/TypeScript/issues/9659 async getCommands(): Promise> { return new BaseCommandMap(); } /** * Locate commands and namespaces given a set of inputs. * * Recursively walk down the tree of namespaces available within this * namespace to find the command that we will execute or the right-most * namespace matched if the command is not found. * * The resolved object looks like this: * * { * obj: command or namespace, * args: the leftover arguments, * path: the path taken to get to the result which comprises tuples of * } * * @param argv The set of command-line arguments to use to locate. */ async locate(argv: readonly string[], { useAliases = true }: NamespaceLocateOptions = {}): Promise> { const _locate = async (inputs: readonly string[], parent: N, path: CommandPathItem[]): Promise> => { const [ key ] = inputs; const children = await parent.getNamespaces(); const nsgetter = useAliases ? children.resolveAlias(key) : children.get(key); if (!nsgetter || typeof nsgetter === 'string' || typeof nsgetter === 'symbol') { const commands = await parent.getCommands(); const cmdgetter = useAliases ? commands.resolveAlias(key) : commands.get(key); if (cmdgetter && typeof cmdgetter !== 'string' && typeof cmdgetter !== 'symbol') { const cmd = await cmdgetter(); return { args: inputs.slice(1), obj: cmd, path: [...path, [key, cmd]] }; } const defaultcmdgetter = commands.get(CommandMapDefault); if (defaultcmdgetter && typeof defaultcmdgetter !== 'string' && typeof defaultcmdgetter !== 'symbol') { const cmd = await defaultcmdgetter(); if (path.length > 0) { // The default command was found via the namespace, so we replace the // previous path entry (the namespace which contains this default // command) with the command itself. path[path.length - 1][1] = cmd; } return { args: inputs, obj: cmd, path }; } return { args: inputs, obj: parent, path }; } const child = await nsgetter(); return _locate(inputs.slice(1), child, [...path, [key, child]]); }; const metadata = await this.getMetadata(); // TODO: typescript complains about `this`. Calling this method on // BaseNamespace would be unsafe if the class weren't abstract. Typescript // bug? I may be wrong. return _locate(argv, this as any, [[metadata.name, this as any]]); } /** * Get all command metadata in a flat structure. */ async getCommandMetadataList(): Promise[]> { const _getCommandMetadataList = async (parent: N, path: CommandPathItem[]): Promise[]> => { const commandsInNamespace = await parent.getCommands(); const commandAliasesInNamespace = commandsInNamespace.getAliases(); const commandList: HydratedCommandMetadata[] = []; // Gather all commands for a namespace and turn them into simple key value // objects. Also keep a record of the namespace path. await Promise.all([...commandsInNamespace.entries()].map(async ([k, cmdgetter]) => { if (typeof cmdgetter === 'string' || typeof cmdgetter === 'symbol') { return; } const command = await cmdgetter(); const commandAliases = (commandAliasesInNamespace.get(k) || []).filter((a): a is string => typeof a === 'string').map(a => [...path.map(([p]) => p), a].join(' ')); const commandMetadata = await command.getMetadata(); const commandPath = [...path]; if (typeof k === 'string') { commandPath.push([k, command]); } // TODO: can't use spread: https://github.com/Microsoft/TypeScript/pull/13288 const result = lodash.assign({}, commandMetadata, { command, namespace: parent, aliases: commandAliases, path: commandPath }); commandList.push(result); })); commandList.sort((a, b) => strcmp(a.name, b.name)); const children = await parent.getNamespaces(); const namespacedCommandList: HydratedCommandMetadata[] = []; // If this namespace has children then get their commands if (children.size > 0) { await Promise.all([...children.entries()].map(async ([k, nsgetter]) => { if (typeof nsgetter === 'string' || typeof nsgetter === 'symbol') { return; } const ns = await nsgetter(); const commandPath = [...path]; if (typeof k === 'string') { commandPath.push([k, ns]); } const cmds = await _getCommandMetadataList(ns, commandPath); namespacedCommandList.push(...cmds); })); } return [...commandList, ...namespacedCommandList]; }; const metadata = await this.getMetadata(); // TODO: typescript complains about `this`. Calling this method on // BaseNamespace would be unsafe if the class weren't abstract. Typescript // bug? I may be wrong. return _getCommandMetadataList(this as any, [[metadata.name, this as any]]); } async groupCommandsByNamespace(commands: readonly HydratedCommandMetadata[]): Promise & { commands: readonly HydratedCommandMetadata[]; })[]> { const summaries = new Map(); const grouped = new Map & { commands: HydratedCommandMetadata[]; }>(); await Promise.all(commands.map(async cmd => { const nsmeta = await cmd.namespace.getMetadata(); const aliases: string[] = []; if (cmd.namespace.parent) { const siblings = await cmd.namespace.parent.getNamespaces(); aliases.push(...(siblings.getAliases().get(nsmeta.name) || []).filter((a): a is string => typeof a === 'string')); } summaries.set(nsmeta.name, nsmeta.summary); let entry = grouped.get(nsmeta.name); if (!entry) { entry = { namespace: cmd.namespace, commands: [], aliases, ...nsmeta, description: nsmeta.description ? nsmeta.description : '', footnotes: nsmeta.footnotes ? nsmeta.footnotes : [], groups: nsmeta.groups ? nsmeta.groups : [], }; grouped.set(nsmeta.name, entry); } entry.commands.push(cmd); })); return [...grouped.values()]; } } export abstract class Command extends BaseCommand {} export abstract class Namespace extends BaseNamespace {} export class CommandMap extends BaseCommandMap {} export class NamespaceMap extends BaseNamespaceMap {} /** * Given a command object, backtrack through the command's namespace to compile * a list of command path items which represents how the command was * found/constructed. */ export async function generateCommandPath, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption>(cmd: C): Promise[]> { const ns = cmd.namespace; const cmdmeta = await cmd.getMetadata(); const _cmdpath = async (namespace: N): Promise[]> => { const nsmeta = await namespace.getMetadata(); const nspath: CommandPathItem = [nsmeta.name, namespace]; if (!namespace.parent) { return [nspath]; } return [...(await _cmdpath(namespace.parent)), nspath]; }; return [...(await _cmdpath(ns)), [cmdmeta.name, cmd]]; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/completion.ts000066400000000000000000000047531425441362600275230ustar00rootroot00000000000000import * as lodash from 'lodash'; import { CommandMetadata, CommandMetadataInput, CommandMetadataOption, ICommand, INamespace } from '../definitions'; import { isCommand } from '../guards'; import { NO_COLORS } from './colors'; import { formatOptionName } from './options'; export async function getCompletionWords, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption>(ns: N, argv: readonly string[]): Promise { const { obj } = await ns.locate(argv, { useAliases: false }); if (isCommand(obj)) { const metadata = await obj.getMetadata(); const options = metadata.options ? metadata.options : []; if (options.length === 0) { return []; } const optionNames = options .map(option => formatOptionName(option, { showAliases: false, showValueSpec: false, colors: NO_COLORS })) .filter(name => !argv.includes(name)); const aliasNames = lodash.flatten(options.map(option => option.aliases ? option.aliases : [])) .map(alias => `-${alias}`); return [...optionNames, ...aliasNames].sort(); } return [ ...(await obj.getCommands()).keysWithoutAliases(), ...(await obj.getNamespaces()).keysWithoutAliases(), ].sort(); } export interface CompletionFormatterDeps, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { readonly namespace: N; } export abstract class CompletionFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { protected readonly namespace: N; constructor({ namespace }: CompletionFormatterDeps) { this.namespace = namespace; } abstract format(): Promise; } export class ZshCompletionFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends CompletionFormatter { async format(): Promise { const { name } = await this.namespace.getMetadata(); return ` ###-begin-${name}-completion-### if type compdef &>/dev/null; then __${name}() { compadd -- $(${name} completion -- "$\{words[@]}" 2>/dev/null) } compdef __${name} ${name} fi ###-end-${name}-completion-### `; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/config.ts000066400000000000000000000053761425441362600266210ustar00rootroot00000000000000import { mkdirpSync } from '@ionic/utils-fs'; import * as fs from 'fs'; import * as lodash from 'lodash'; import * as path from 'path'; import * as writeFileAtomic from 'write-file-atomic'; export interface BaseConfigOptions { /** * The number of spaces to use when writing the JSON file. */ spaces?: string | number; /** * If specified, the class will operate on a nested object within the config * file navigated to by this path prefix, an array of object path keys. * * For example, to operate on `c` object within `{ a: { b: { c: {} } } }`, * use `pathPrefix` of `['a', 'b', 'c']`. */ pathPrefix?: readonly string[]; } export abstract class BaseConfig { protected readonly spaces: string | number; protected readonly pathPrefix: readonly string[]; constructor(readonly p: string, { spaces = 2, pathPrefix = [] }: BaseConfigOptions = {}) { this.spaces = spaces; this.pathPrefix = pathPrefix; } get file() { try { return this._getFile(); } catch (e) { return {}; } } get c(): T { try { const file = this._getFile(); const navigated = this.pathPrefix.length === 0 ? file : lodash.get(file, [...this.pathPrefix]); const config = typeof navigated === 'object' ? navigated : {}; return lodash.assign({}, this.provideDefaults(config), config); } catch (e) { if (e.code === 'ENOENT' || e.name === 'SyntaxError') { const value = this.provideDefaults({}); const v = this.pathPrefix.length === 0 ? value : lodash.set({}, [...this.pathPrefix], value); this._setFile(v); return value; } throw e; } } set c(value: T) { const v = this.pathPrefix.length === 0 ? value : lodash.set(this.file, [...this.pathPrefix], value); this._setFile(v); } get

(property: P): T[P]; get

(property: P, defaultValue: NonNullable): NonNullable; get

(property: P, defaultValue?: T[P]): T[P] { const value: any = this.c[property]; if (defaultValue && typeof value === 'undefined') { return defaultValue; } return value; } set

(property: P, value: T[P]): void { const config = this.c; config[property] = value; this.c = config; } unset

(property: P): void { const config = this.c; delete config[property]; this.c = config; } abstract provideDefaults(c: Partial>): T; private _getFile(): any { const contents = fs.readFileSync(this.p, 'utf8'); return JSON.parse(contents); } private _setFile(value: any): void { mkdirpSync(path.dirname(this.p)); writeFileAtomic.sync(this.p, JSON.stringify(value, undefined, this.spaces) + '\n'); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/executor.ts000066400000000000000000000205521425441362600272030ustar00rootroot00000000000000import { EventEmitter } from 'events'; import * as lodash from 'lodash'; import { CommandInstanceInfo, CommandMetadata, CommandMetadataInput, CommandMetadataOption, ICommand, IExecutor, INamespace, NamespaceLocateResult } from '../definitions'; import { BaseError, InputValidationError } from '../errors'; import { isCommand, isNamespace } from '../guards'; import { Colors, DEFAULT_COLORS } from './colors'; import { Command, Namespace } from './command'; import { CommandHelpSchema, CommandSchemaHelpFormatter, CommandStringHelpFormatter, HelpFormatter, NamespaceHelpSchema, NamespaceSchemaHelpFormatter, NamespaceStringHelpFormatter } from './help'; import { metadataOptionsToParseArgsOptions, parseArgs, stripOptions } from './options'; export type HelpRPC = import('../utils/ipc').RPC<'help', [readonly string[]], S>; export interface ExecutorOperations { readonly RPC: string; } export const EXECUTOR_OPS: ExecutorOperations = Object.freeze({ RPC: '📡', }); export const HELP_FLAGS = ['--help', '-?']; export abstract class AbstractExecutor, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends EventEmitter implements IExecutor { abstract readonly namespace: N; abstract locate(argv: readonly string[]): Promise>; abstract execute(location: NamespaceLocateResult): Promise; abstract execute(argv: readonly string[], env: NodeJS.ProcessEnv): Promise; abstract run(command: C, cmdargs: readonly string[], runinfo?: Partial>): Promise; async resolveExecuteInput(argvOrLocation: readonly string[] | NamespaceLocateResult): Promise<[NamespaceLocateResult, string[]]> { if ('obj' in argvOrLocation) { return [argvOrLocation, [...argvOrLocation.args]]; } else { return [await this.locate(argvOrLocation), [...argvOrLocation]]; } } } export interface BaseExecutorFormatHelpOptions { format?: 'terminal' | 'json'; } export interface BaseExecutorDeps, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { readonly namespace: N; readonly colors?: Colors; readonly stdout?: NodeJS.WriteStream; readonly stderr?: NodeJS.WriteStream; } export interface BaseExecutor, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends AbstractExecutor { on(event: 'operation-rpc', callback: (rpc: import('../utils/ipc').RPCProcess) => void): this; emit(event: 'operation-rpc', rpc: import('../utils/ipc').RPCProcess): boolean; } export class BaseExecutor, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends AbstractExecutor { readonly colors: Colors; readonly namespace: N; readonly stdout: NodeJS.WriteStream; readonly stderr: NodeJS.WriteStream; constructor({ namespace, stdout, stderr, colors }: BaseExecutorDeps) { super(); this.namespace = namespace; this.colors = colors ? colors : DEFAULT_COLORS; this.stdout = stdout ? stdout : process.stdout; this.stderr = stderr ? stderr : process.stderr; } /** * Locate a command or namespace given an array of positional arguments * (argv). * * @param argv Command arguments sliced to the root for the namespace of this * executor. Usually, this means `process.argv.slice(2)`. */ async locate(argv: readonly string[]): Promise> { const parsedArgs = stripOptions(argv, {}); const location = await this.namespace.locate(parsedArgs); const args = lodash.drop(argv, location.path.length - 1); return { ...location, args }; } /** * Locate and execute a command given an array of positional command * arguments (argv) and a set of environment variables. * * If a command is not found, formatted help is automatically output for the * right-most namespace found. * * @param argv Command arguments sliced to the root for the namespace of this * executor. Usually, this means `process.argv.slice(2)`. * @param env Environment variables for this execution. */ async execute(argvOrLocation: readonly string[] | NamespaceLocateResult, env?: NodeJS.ProcessEnv): Promise { if (Array.isArray(argvOrLocation) && argvOrLocation[0] === EXECUTOR_OPS.RPC) { return this.rpc(); } const [ location, argv ] = await this.resolveExecuteInput(argvOrLocation); if (lodash.intersection(HELP_FLAGS, argv).length > 0 || isNamespace(location.obj)) { const cmdoptions = parseArgs(argv); this.stdout.write(await this.formatHelp(location, { format: cmdoptions['json'] ? 'json' : 'terminal' })); } else { const cmd = location.obj; const cmdargs = location.args; await this.run(cmd, cmdargs, { location, env, executor: this }); } } async run(command: C, cmdargs: readonly string[], runinfo?: Partial>): Promise { const { input } = this.colors; const metadata = await command.getMetadata(); const cmdoptions = parseArgs([...cmdargs], metadataOptionsToParseArgsOptions(metadata.options ? metadata.options : [])); const cmdinputs = cmdoptions._; try { await command.validate(cmdinputs); } catch (e) { if (e instanceof InputValidationError) { for (const err of e.errors) { this.stderr.write(`${err.message}\n`); } this.stderr.write(`Use the ${input('--help')} flag for more details.\n`); } throw e; } await command.run(cmdinputs, cmdoptions, runinfo); } async formatHelp(location: NamespaceLocateResult, { format = 'terminal' }: BaseExecutorFormatHelpOptions = {}): Promise { let formatter: HelpFormatter; if (isCommand(location.obj)) { const options = { location, command: location.obj, colors: this.colors }; formatter = format === 'json' ? new CommandSchemaHelpFormatter(options) : new CommandStringHelpFormatter(options); } else { const options = { location, namespace: location.obj, colors: this.colors }; formatter = format === 'json' ? new NamespaceSchemaHelpFormatter(options) : new NamespaceStringHelpFormatter(options); } return formatter.format(); } /** * Initiate RPC operation. * * This means the CLI has been executed by a parent Node process with an IPC * channel, allowing request/response communication via RPC. */ async rpc(): Promise { const { RPCProcess } = await import('../utils/ipc'); const metadata = await this.namespace.getMetadata(); const rpc = new RPCProcess({ name: metadata.name }); rpc.register>('help', async ([cmdpath]) => { const location = await this.namespace.locate(cmdpath); const formatter = isCommand(location.obj) ? new CommandSchemaHelpFormatter({ location, command: location.obj, colors: this.colors }) : new NamespaceSchemaHelpFormatter({ location, namespace: location.obj, colors: this.colors }); return formatter.serialize(); }); this.emit('operation-rpc', rpc); rpc.start(process); } } export class Executor extends BaseExecutor {} export async function execute, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption>({ namespace, argv, env, ...rest }: { namespace: N; argv: string[]; env: NodeJS.ProcessEnv } & Partial>) { const executor = new BaseExecutor({ namespace, ...rest }); try { await executor.execute(argv, env); } catch (e) { if (e instanceof BaseError) { executor.stderr.write(`Error: ${e.message}`); process.exitCode = typeof e.exitCode === 'undefined' ? 1 : e.exitCode; return; } throw e; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/help.ts000066400000000000000000000723771425441362600263110ustar00rootroot00000000000000import { filter, map } from '@ionic/utils-array'; import { generateFillSpaceStringList, stringWidth, wordWrap } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import { CommandMetadata, CommandMetadataInput, CommandMetadataOption, Footnote, HydratedCommandMetadata, HydratedNamespaceMetadata, ICommand, INamespace, LinkFootnote, MetadataGroup, NamespaceLocateResult, NamespaceMetadata } from '../definitions'; import { isHydratedCommandMetadata, isLinkFootnote } from '../guards'; import { ColorFunction, Colors, DEFAULT_COLORS } from './colors'; import { formatOptionName, hydrateOptionSpec } from './options'; import { validators } from './validators'; const debug = Debug('ionic:cli-framework:lib:help'); const DEFAULT_DOTS_WIDTH = 32; function formatHelpGroups(groups: string[] = [], colors: Colors = DEFAULT_COLORS): string { const { help: { group: gcolors } } = colors; return groups .map(g => g in gcolors ? gcolors[g as keyof typeof gcolors](`(${g})`) + ' ' : '') .join(''); } function formatLinkFootnote(footnote: LinkFootnote, colors: Colors = DEFAULT_COLORS): string { const { strong } = colors; return strong(footnote.shortUrl ? footnote.shortUrl : footnote.url); } function formatFootnote(index: number, footnote: Footnote, colors: Colors = DEFAULT_COLORS): string { const { ancillary } = colors; const prefix = ancillary(`[${index}]`); const output = isLinkFootnote(footnote) ? formatLinkFootnote(footnote, colors) : footnote.text; return `${prefix}: ${output}`; } function formatFootnotes(text: string, footnotes?: readonly Footnote[], colors: Colors = DEFAULT_COLORS): string { if (!footnotes) { return text; } const { ancillary } = colors; const discoveredFootnotes: Footnote[] = []; const output = text.replace(/\[\^([A-z0-9-]+)\]/g, (match, p1) => { const m = Number.parseInt(p1, 10); const id = !Number.isNaN(m) ? m : p1; const foundFootnote = footnotes.find(footnote => footnote.id === id); if (foundFootnote) { const len = discoveredFootnotes.push(foundFootnote); return ancillary(`[${len}]`); } else { debug('No footnote found by ID: %O', id); return ''; } }); return output + ( discoveredFootnotes.length > 0 ? `\n\n${discoveredFootnotes.map((footnote, i) => formatFootnote(i + 1, footnote, colors)).join('\n')}` : '' ); } export async function isOptionVisible(opt: O): Promise { return !opt.groups || !opt.groups.includes(MetadataGroup.HIDDEN); } export async function isCommandVisible, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption>(cmd: HydratedCommandMetadata): Promise { const ns = await cmd.namespace.getMetadata(); return (!cmd.groups || !cmd.groups.includes(MetadataGroup.HIDDEN)) && (!ns.groups || !ns.groups.includes(MetadataGroup.HIDDEN)); } export abstract class HelpFormatter { protected readonly colors: Colors; constructor({ colors }: { colors?: Colors; }) { this.colors = colors ? colors : DEFAULT_COLORS; } abstract format(): Promise; } export interface NamespaceHelpFormatterDeps, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { readonly location: NamespaceLocateResult; readonly namespace: N; readonly colors?: Colors; } export abstract class NamespaceHelpFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends HelpFormatter { protected readonly location: NamespaceLocateResult; protected readonly namespace: N; protected readonly dotswidth: number = DEFAULT_DOTS_WIDTH; protected _metadata?: NamespaceMetadata; protected _fullName?: string; constructor({ location, namespace, colors }: NamespaceHelpFormatterDeps) { super({ colors }); this.location = location; this.namespace = namespace; } protected normalizeMetadata(metadata: NamespaceMetadata): NamespaceMetadata { return { ...metadata, groups: lodash.uniq(metadata.groups) }; } protected normalizeCommandMetadata(metadata: HydratedCommandMetadata): HydratedCommandMetadata { return { ...metadata, groups: lodash.uniq(metadata.groups) }; } /** * Given command metadata, decide whether to keep or discard the command that * the metadata represents. * * @param meta: The metadata of the command. * @return `true` to keep, `false` to discard */ async filterCommandCallback(meta: HydratedCommandMetadata): Promise { return isCommandVisible(meta); } async getNamespaceMetadata(): Promise { if (!this._metadata) { this._metadata = this.normalizeMetadata(await this.namespace.getMetadata()); } return this._metadata; } async getCommandMetadataList(): Promise[]> { const commands = await this.namespace.getCommandMetadataList(); return commands.map(cmd => this.normalizeCommandMetadata(cmd)); } async getNamespaceFullName(): Promise { if (!this._fullName) { const parts = await map( this.location.path.slice(0, this.location.path.length - 1), async ([, cmd]) => (await cmd.getMetadata()).name ); const name = (await this.getNamespaceMetadata()).name; this._fullName = [...parts, name].join(' '); } return this._fullName; } } export class NamespaceStringHelpFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends NamespaceHelpFormatter { async formatHeader(): Promise { const { strong, input } = this.colors; const fullName = await this.getNamespaceFullName(); const summary = await this.formatSummary(); const description = await this.formatDescription(); return ( `\n ${strong(`${input(fullName)}${summary}`)}` + (description ? `\n\n ${description}` : '') + '\n' ); } async formatSummary(): Promise { const fullName = await this.getNamespaceFullName(); const metadata = await this.getNamespaceMetadata(); const summary = ( (await this.formatBeforeSummary(metadata)) + metadata.summary + (await this.formatAfterSummary(metadata)) ); const wrappedSummary = wordWrap(summary, { indentation: fullName.length + 5 }); return wrappedSummary ? ` - ${wrappedSummary}` : ''; } async formatDescription(): Promise { const metadata = await this.getNamespaceMetadata(); if (!metadata.description) { return ''; } const text = formatFootnotes(metadata.description.trim(), metadata.footnotes, this.colors); return wordWrap(text, { indentation: 4 }); } async getGlobalOptions(): Promise { return []; } async formatUsage(): Promise { const { help: { title }, weak, input } = this.colors; const fullName = await this.getNamespaceFullName(); const options = ['--help', ...(await this.getGlobalOptions())]; const usageLines = [ ` ${weak('[]')} ${options.map(opt => weak('[' + opt + ']')).join(' ')} ${weak('[options]')}`, ]; return ( `\n ${title('Usage')}:` + `\n\n ${usageLines.map(u => `${weak('$')} ${input(fullName + ' ' + u)}`).join('\n ')}\n` ); } async formatCommands() { const commands = await this.getCommandMetadataList(); return this.formatCommandGroup('Commands', commands); } async formatCommandGroup(titleText: string, commands: readonly HydratedCommandMetadata[]): Promise { const { help: { title } } = this.colors; const filteredCommands = await filter(commands, async cmd => this.filterCommandCallback(cmd)); const [ cmdDetails, nsDetails ] = await Promise.all([ this.getListOfCommandDetails(filteredCommands.filter(cmd => cmd.namespace === this.namespace)), this.getListOfNamespaceDetails(filteredCommands.filter(cmd => cmd.namespace !== this.namespace)), ]); const details = [...cmdDetails, ...nsDetails]; if (details.length === 0) { return ''; } details.sort(); return ( `\n ${title(titleText)}:` + `\n\n ${details.join('\n ')}\n` ); } async getListOfCommandDetails(commands: readonly HydratedCommandMetadata[]): Promise { const { weak, input } = this.colors; const fullCmd = commands.map(cmd => lodash.tail(cmd.path).map(([p]) => p).join(' ')); const fillStringArray = generateFillSpaceStringList(fullCmd, this.dotswidth, weak('.')); const formattedCommands = await Promise.all(commands.map(async (cmd, index) => { const wrapColor: ColorFunction = cmd.groups && cmd.groups.includes(MetadataGroup.DEPRECATED) ? weak : lodash.identity; const summary = ( (await this.formatBeforeCommandSummary(cmd)) + cmd.summary + (await this.formatAfterCommandSummary(cmd)) ); const wrappedSummary = wordWrap(summary, { indentation: this.dotswidth + 6 }); const line = `${input(lodash.tail(cmd.path).map(([p]) => p).join(' '))}${wrappedSummary ? ' ' + fillStringArray[index] + ' ' + wrappedSummary : ''}`; return wrapColor(line); })); return formattedCommands; } async getListOfNamespaceDetails(commands: readonly HydratedCommandMetadata[]): Promise { const { weak, input } = this.colors; const namespaces = await this.namespace.groupCommandsByNamespace(commands); const fillStringArray = generateFillSpaceStringList(namespaces.map(({ name }) => name + ' '), this.dotswidth, weak('.')); const formattedNamespaces = await Promise.all(namespaces.map(async (meta, i) => { const summary = ( (await this.formatBeforeNamespaceSummary(meta, meta.commands)) + meta.summary + (await this.formatAfterNamespaceSummary(meta, meta.commands)) ); const wrappedSummary = wordWrap(summary, { indentation: this.dotswidth + 6 }); return `${input(meta.name + ' ')}${wrappedSummary ? ' ' + fillStringArray[i] + ' ' + wrappedSummary : ''}`; })); return formattedNamespaces; } /** * Insert text before the namespace's summary. * * @param meta: The metadata of the namespace. */ async formatBeforeSummary(meta: NamespaceMetadata): Promise { return formatHelpGroups(meta.groups, this.colors); } /** * Insert text after the namespace's summary. * * @param meta: The metadata of the namespace. */ async formatAfterSummary(meta: NamespaceMetadata): Promise { return ''; } /** * Insert text that appears before a commands's summary. * * @param meta: The metadata of the command. */ async formatBeforeCommandSummary(meta: HydratedCommandMetadata): Promise { return formatHelpGroups(meta.groups, this.colors); } /** * Insert text that appears after a commands's summary. * * @param meta: The metadata of the command. */ async formatAfterCommandSummary(meta: HydratedCommandMetadata): Promise { const { weak, input } = this.colors; const aliases = meta.aliases.map(alias => lodash.tail(alias.split(' ')).join(' ')); const formattedAliases = aliases.length > 0 ? weak('(alias' + (aliases.length === 1 ? '' : 'es') + ': ') + aliases.map(a => input(a)).join(', ') + weak(')') : ''; return formattedAliases ? ` ${formattedAliases}` : ''; } /** * Insert text that appears before a namespace's summary. * * @param meta The metadata of the namespace. * @param commands An array of the metadata of the namespace's commands. */ async formatBeforeNamespaceSummary(meta: HydratedNamespaceMetadata, commands: readonly HydratedCommandMetadata[]): Promise { return formatHelpGroups(meta.groups, this.colors); } /** * Insert text that appears after a namespace's summary. * * @param meta The metadata of the namespace. * @param commands An array of the metadata of the namespace's commands. */ async formatAfterNamespaceSummary(meta: HydratedNamespaceMetadata, commands: readonly HydratedCommandMetadata[]): Promise { const { weak, input } = this.colors; const formattedSubcommands = commands.length > 0 ? `${weak('(subcommands:')} ${commands.map(c => input(c.name)).join(', ')}${weak(')')}` : ''; const formattedAliases = meta.aliases.length > 0 ? `${weak('(alias' + (meta.aliases.length === 1 ? '' : 'es') + ': ') + meta.aliases.map(a => input(a)).join(', ') + weak(')')}` : ''; return `${formattedSubcommands ? ` ${formattedSubcommands}` : ''}${formattedAliases ? ` ${formattedAliases}` : ''}`; } async format(): Promise { return ( (await this.formatHeader()) + (await this.formatUsage()) + (await this.formatCommands()) + '\n' ); } } export interface CommandHelpFormatterDeps, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> { readonly location: NamespaceLocateResult; readonly command: C; /** * Provide extra context with hydrated command metadata. If not provided, * `command.getMetadata()` is called. */ readonly metadata?: HydratedCommandMetadata; readonly colors?: Colors; } export abstract class CommandHelpFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends HelpFormatter { protected readonly location: NamespaceLocateResult; protected readonly command: C; protected readonly dotswidth: number = DEFAULT_DOTS_WIDTH; protected _metadata?: M; protected _fullName?: string; constructor({ location, command, metadata, colors }: CommandHelpFormatterDeps) { super({ colors }); this.location = location; this.command = command; this._metadata = metadata ? this.normalizeMetadata(metadata) : undefined; } protected normalizeMetadata(metadata: M | HydratedCommandMetadata): M { return { ...metadata, groups: lodash.uniq(metadata.groups) }; } /** * Given an option definition from command metadata, decide whether to keep * or discard it. * * @return `true` to keep, `false` to discard */ async filterOptionCallback(option: O): Promise { return isOptionVisible(option); } async getCommandMetadata(): Promise> { if (!this._metadata) { this._metadata = this.normalizeMetadata(await this.command.getMetadata({ location: this.location })); } return this._metadata; } async getCommandFullName(): Promise { if (!this._fullName) { const parts = await map( this.location.path.slice(0, this.location.path.length - 1), async ([, cmd]) => (await cmd.getMetadata()).name ); const name = (await this.getCommandMetadata()).name; this._fullName = [...parts, name].join(' '); } return this._fullName; } } export class CommandStringHelpFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends CommandHelpFormatter { async formatHeader(): Promise { const { strong, input } = this.colors; const fullName = await this.getCommandFullName(); const summary = await this.formatSummary(); const description = await this.formatDescription(); return ( `\n ${strong(`${input(fullName)}${summary}`)}` + (description ? `\n\n ${description}` : '') + '\n' ); } async formatSummary(): Promise { const fullName = await this.getCommandFullName(); const metadata = await this.getCommandMetadata(); const summary = ( (await this.formatBeforeSummary(metadata)) + metadata.summary + (await this.formatAfterSummary(metadata)) ); const wrappedSummary = wordWrap(summary, { indentation: fullName.length + 5 }); return wrappedSummary ? ` - ${wrappedSummary}` : ''; } async formatDescription(): Promise { const metadata = await this.getCommandMetadata(); if (!metadata.description) { return ''; } const text = formatFootnotes(metadata.description.trim(), metadata.footnotes, this.colors); return wordWrap(text, { indentation: 4 }); } async formatInlineInput(input: I): Promise { if (input.validators && input.validators.includes(validators.required)) { return '<' + input.name + '>'; } return '[<' + input.name + '>]'; } async formatUsage(): Promise { const { help: { title }, weak, input } = this.colors; const fullName = await this.getCommandFullName(); const metadata = await this.getCommandMetadata(); const options = metadata.options ? metadata.options : []; const filteredOptions = await filter(options, async opt => this.filterOptionCallback(opt)); const formattedInputs = metadata.inputs ? await Promise.all(metadata.inputs.map(async i => this.formatInlineInput(i))) : []; return ( `\n ${title('Usage')}:` + `\n\n ${weak('$')} ${input(fullName + (formattedInputs.length > 0 ? ' ' + formattedInputs.join(' ') : ''))}${filteredOptions.length > 0 ? ' ' + input('[options]') : ''}\n` ); } async formatInputs(): Promise { const { help: { title } } = this.colors; const metadata = await this.getCommandMetadata(); const inputs = metadata.inputs ? metadata.inputs : []; if (inputs.length === 0) { return ''; } const formattedInputs = await Promise.all(inputs.map(input => this.formatInput(input))); return ( `\n ${title('Inputs')}:` + `\n\n ${formattedInputs.join('\n ')}\n` ); } async formatInput(i: I): Promise { const { input, weak } = this.colors; const inputName = input(i.name); const inputNameLength = stringWidth(inputName); const fullLength = inputNameLength > this.dotswidth ? inputNameLength + 1 : this.dotswidth; const fullDescription = ( (await this.formatBeforeInputSummary(i)) + i.summary + (await this.formatAfterInputSummary(i)) ); const wrappedDescription = wordWrap(fullDescription, { indentation: this.dotswidth + 6 }); return `${inputName} ${weak('.').repeat(fullLength - inputNameLength)} ${wrappedDescription}`; } async formatOptionLine(opt: O) { const { weak } = this.colors; const wrapColor: ColorFunction = opt.groups && opt.groups.includes(MetadataGroup.DEPRECATED) ? weak : lodash.identity; const optionName = formatOptionName(opt, { colors: this.colors }); const optionNameLength = stringWidth(optionName); const fullLength = optionNameLength > this.dotswidth ? optionNameLength + 1 : this.dotswidth; const fullDescription = ( (await this.formatBeforeOptionSummary(opt)) + opt.summary + (await this.formatAfterOptionSummary(opt)) ); const wrappedDescription = wordWrap(fullDescription, { indentation: this.dotswidth + 6 }); const line = `${optionName} ${weak('.').repeat(fullLength - optionNameLength)} ${wrappedDescription}`; return wrapColor(line); } /** * Insert text that appears before the command's summary. * * @param meta The metadata of the command. */ async formatBeforeSummary(meta: M): Promise { return formatHelpGroups(meta.groups, this.colors); } /** * Insert text that appears after the command's summary. * * @param meta The metadata of the command. */ async formatAfterSummary(meta: M): Promise { return ''; } /** * Insert text that appears before the input's summary. * * @param input The metadata of the input. */ async formatBeforeInputSummary(input: I): Promise { const { weak } = this.colors; const required = input.validators && input.validators.includes(validators.required) ? true : false; return required ? '' : `${weak('(optional)')} `; } /** * Insert text that appears after the input's summary. * * @param input The metadata of the input. */ async formatAfterInputSummary(input: I): Promise { return ''; } /** * Insert text that appears before an option's summary. * * @param opt The metadata of the option. */ async formatBeforeOptionSummary(opt: O): Promise { return formatHelpGroups(opt.groups, this.colors); } /** * Insert text that appears after the option's summary. * * @param opt The metadata of the option. */ async formatAfterOptionSummary(opt: O): Promise { return this.formatOptionDefault(opt); } async formatOptionDefault(opt: O): Promise { const { weak, input } = this.colors; if (typeof opt.default === 'string') { return weak(' (default: ') + input(opt.default) + weak(')'); } else { return ''; } } async formatOptions(): Promise { const metadata = await this.getCommandMetadata(); const options = metadata.options ? metadata.options : []; return this.formatOptionsGroup('Options', options); } async formatOptionsGroup(titleText: string, options: O[]): Promise { const { help: { title } } = this.colors; const filteredOptions = await filter(options, async opt => this.filterOptionCallback(opt)); if (filteredOptions.length === 0) { return ''; } const formattedOptions = await Promise.all(filteredOptions.map(async option => this.formatOptionLine(option))); return ( `\n ${title(titleText)}:` + `\n\n ${formattedOptions.join('\n ')}\n` ); } async formatExamples(): Promise { const { help: { title }, weak, input } = this.colors; const metadata = await this.getCommandMetadata(); const fullName = await this.getCommandFullName(); if (!metadata.exampleCommands || !Array.isArray(metadata.exampleCommands)) { return ''; } const exampleLines = metadata.exampleCommands.map(cmd => { const sepIndex = cmd.indexOf(' -- '); cmd = sepIndex === -1 ? input(cmd) : input(cmd.substring(0, sepIndex)) + cmd.substring(sepIndex); const wrappedCmd = wordWrap(cmd, { indentation: 12, append: ' \\' }); return `${weak('$')} ${input(fullName + ' ')}${wrappedCmd ? wrappedCmd : ''}`; }); return ( `\n ${title('Examples')}:` + `\n\n ${exampleLines.join('\n ')}\n` ); } async format(): Promise { return ( (await this.formatHeader()) + (await this.formatUsage()) + (await this.formatInputs()) + (await this.formatOptions()) + (await this.formatExamples()) + '\n' ); } } export interface NamespaceHelpSchema { readonly name: string; readonly summary: string; readonly description: string; readonly groups: readonly string[]; readonly commands: CommandHelpSchema[]; readonly aliases: readonly string[]; } export class NamespaceSchemaHelpFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends NamespaceHelpFormatter { async format(): Promise { return JSON.stringify(await this.serialize()); } async serialize(): Promise { const metadata = await this.getNamespaceMetadata(); const commands = await this.getCommandMetadataList(); return { name: metadata.name, summary: metadata.summary, description: metadata.description ? metadata.description : '', groups: metadata.groups ? metadata.groups : [], commands: await this.formatCommandGroup(commands), aliases: [], }; } async formatCommandGroup(commands: readonly HydratedCommandMetadata[]): Promise { const filteredCommands = await filter(commands, async cmd => this.filterCommandCallback(cmd)); return map(filteredCommands, async cmd => this.formatCommand(cmd)); } async formatCommand(cmd: HydratedCommandMetadata): Promise { const { command } = cmd; const formatter = new CommandSchemaHelpFormatter({ location: { path: [...cmd.path], obj: command, args: [] }, command, metadata: cmd, }); return formatter.serialize(); } } export interface CommandHelpSchemaInput { readonly name: string; readonly summary: string; readonly required: boolean; } export interface CommandHelpSchemaOption { readonly name: string; readonly summary: string; readonly groups: readonly string[]; readonly aliases: readonly string[]; readonly type: string; readonly default?: string | boolean; readonly spec: { readonly value: string; }; } export interface CommandHelpSchemaFootnoteText { readonly type: 'text'; readonly id: string | number; readonly text: string; } export interface CommandHelpSchemaFootnoteLink { readonly type: 'link'; readonly id: string | number; readonly url: string; readonly shortUrl?: string; } export type CommandHelpSchemaFootnote = CommandHelpSchemaFootnoteText | CommandHelpSchemaFootnoteLink; export interface CommandHelpSchema { readonly name: string; readonly namespace: readonly string[]; readonly summary: string; readonly description: string; readonly footnotes: readonly CommandHelpSchemaFootnote[]; readonly groups: readonly string[]; readonly exampleCommands: readonly string[]; readonly aliases: readonly string[]; readonly inputs: readonly CommandHelpSchemaInput[]; readonly options: readonly CommandHelpSchemaOption[]; } export class CommandSchemaHelpFormatter, N extends INamespace, M extends CommandMetadata, I extends CommandMetadataInput, O extends CommandMetadataOption> extends CommandHelpFormatter { async format(): Promise { return JSON.stringify(await this.serialize()); } async serialize(): Promise { const metadata = await this.getCommandMetadata(); return this.formatCommand(metadata); } async formatInputs(inputs: readonly I[]): Promise { return Promise.all(inputs.map(async input => this.formatInput(input))); } async formatInput(input: I): Promise { const name = input.name; const summary = input.summary; const required = input.validators && input.validators.includes(validators.required) ? true : false; return { name, summary, required }; } async formatOptions(options: readonly O[]): Promise { const filteredOptions = await filter(options, async opt => this.filterOptionCallback(opt)); return Promise.all(filteredOptions.map(async opt => this.formatOption(opt))); } async formatOption(option: O): Promise { const name = option.name; const summary = option.summary ? option.summary.trim() : ''; const groups = option.groups ? option.groups : []; const aliases = option.aliases ? option.aliases : []; const type = option.type ? option.type.name.toLowerCase() : 'string'; const spec = hydrateOptionSpec(option); return { name, type, summary, default: option.default, groups, aliases, spec }; } formatFootnote(footnote: Footnote): CommandHelpSchemaFootnote { return isLinkFootnote(footnote) ? ({ type: 'link', ...footnote }) : ({ type: 'text', ...footnote }); } async formatCommand(cmd: M | HydratedCommandMetadata): Promise { const commandPath = this.location.path.map(([p]) => p); const namespacePath = lodash.initial(commandPath); const name = commandPath.join(' '); const summary = cmd.summary ? cmd.summary.trim() : ''; const description = cmd.description ? cmd.description.trim() : ''; const footnotes = cmd.footnotes ? cmd.footnotes.map(footnote => this.formatFootnote(footnote)) : []; const groups = cmd.groups ? cmd.groups : []; const exampleCommands = cmd.exampleCommands ? cmd.exampleCommands.map(c => `${name} ${c}`) : []; const aliases = isHydratedCommandMetadata(cmd) ? cmd.aliases : []; const inputs = cmd.inputs ? await this.formatInputs(cmd.inputs) : []; const options = cmd.options ? await this.formatOptions(cmd.options) : []; return { name, namespace: namespacePath, summary, description, footnotes, groups, exampleCommands, aliases, inputs, options }; } } export function createCommandMetadataFromSchema(schema: CommandHelpSchema): Required { return { name: schema.name, summary: schema.summary, description: schema.description, footnotes: [...schema.footnotes], groups: [...schema.groups], exampleCommands: [...schema.exampleCommands], inputs: [...schema.inputs], options: schema.options.map(opt => ({ ...opt, type: opt.type === 'boolean' ? Boolean : String, groups: [...opt.groups], aliases: [...opt.aliases] })), }; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/index.ts000066400000000000000000000003321425441362600264460ustar00rootroot00000000000000export * from './colors'; export * from './command'; export * from './completion'; export * from './config'; export * from './executor'; export * from './help'; export * from './options'; export * from './validators'; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/options.ts000066400000000000000000000250461425441362600270430ustar00rootroot00000000000000import * as lodash from 'lodash'; import * as minimist from 'minimist'; import { CommandLineOptions, CommandMetadataOption, HydratedParseArgsOptions, ParsedArg } from '../definitions'; import { Colors, DEFAULT_COLORS } from './colors'; export const parseArgs = minimist; export { ParsedArgs } from 'minimist'; /** * Remove options, which are any arguments that starts with a hyphen (-), from * a list of process args and return the result. * * If a double-hyphen separator (--) is encountered, it and the remaining * arguments are included in the result, as they are not interpreted. This * behavior can be disabled by setting the `includeSeparated` option to * `false`. */ export function stripOptions(pargv: readonly string[], { includeSeparated = true }: { includeSeparated?: boolean; }): string[] { const r = /^\-/; const [ ownArgs, otherArgs ] = separateArgv(pargv); const filteredArgs = ownArgs.filter(arg => !r.test(arg)); if (!includeSeparated) { return filteredArgs; } if (otherArgs.length > 0) { otherArgs.unshift('--'); } return [...filteredArgs, ...otherArgs]; } /** * Split a list of process args into own-arguments and other-arguments, which * are separated by the double-hyphen (--) separator. * * For example, `['cmd', 'arg1', '--', 'arg2']` will be split into * `['cmd', 'arg1']` and `['arg2']`. */ export function separateArgv(pargv: readonly string[]): [string[], string[]] { const ownArgs = [...pargv]; const otherArgs: string[] = []; const sepIndex = pargv.indexOf('--'); if (sepIndex >= 0) { otherArgs.push(...ownArgs.splice(sepIndex)); otherArgs.shift(); // strip separator } return [ ownArgs, otherArgs ]; } /** * Takes a Minimist command option and normalizes its values. */ export function hydrateCommandMetadataOption(option: O): O { const type = option.type ? option.type : String; return lodash.assign({}, option, { type, default: typeof option.default !== 'undefined' ? option.default : null, aliases: Array.isArray(option.aliases) ? option.aliases : [], }); } export interface HydratedOptionSpec { readonly value: string; } export function hydrateOptionSpec(opt: O): HydratedOptionSpec { return { ...{ value: opt.type === Boolean ? 'true/false' : opt.name }, ...opt.spec || {} }; } export interface FormatOptionNameOptions { readonly showAliases?: boolean; readonly showValueSpec?: boolean; readonly colors?: Colors; } export function formatOptionName(opt: O, { showAliases = true, showValueSpec = true, colors = DEFAULT_COLORS }: FormatOptionNameOptions = {}): string { const { input, weak } = colors; const spec = hydrateOptionSpec(opt); const showInverse = opt.type === Boolean && opt.default === true && opt.name.length > 1; const valueSpec = opt.type === Boolean ? '' : `=<${spec.value}>`; const aliasValueSpec = opt.type === Boolean ? '' : '=?'; return ( (showInverse ? input(`--no-${opt.name}`) : input(`-${opt.name.length > 1 ? '-' : ''}${opt.name}`)) + (showValueSpec ? weak(valueSpec) : '') + (showAliases ? (!showInverse && opt.aliases && opt.aliases.length > 0 ? ', ' + opt.aliases .map(alias => input(`-${alias}`) + (showValueSpec ? weak(aliasValueSpec) : '')) .join(', ') : '') : '') ); } export function metadataOptionsToParseArgsOptions(commandOptions: readonly CommandMetadataOption[]): HydratedParseArgsOptions { const options: HydratedParseArgsOptions = { string: ['_'], boolean: [], alias: {}, default: {}, '--': true, }; for (const o of commandOptions) { const opt = hydrateCommandMetadataOption(o); if (opt.type === String) { options.string.push(opt.name); } else if (opt.type === Boolean) { options.boolean.push(opt.name); } if (typeof opt.default !== 'undefined') { options.default[opt.name] = opt.default; } if (typeof opt.aliases !== 'undefined') { options.alias[opt.name] = opt.aliases; } } return options; } export type OptionPredicate = (option: O, value?: ParsedArg) => boolean; export namespace OptionFilters { export function includesGroups(groups: string | string[]): OptionPredicate { const g = Array.isArray(groups) ? groups : [groups]; return (option: O) => typeof option.groups !== 'undefined' && lodash.intersection(option.groups, g).length > 0; } export function excludesGroups(groups: string | string[]): OptionPredicate { const g = Array.isArray(groups) ? groups : [groups]; return (option: O) => typeof option.groups === 'undefined' || lodash.difference(option.groups, g).length > 0; } } /** * Given an array of command metadata options and an object of parsed options, * match each supplied option with its command metadata option definition and * pass it, along with its value, to a predicate function, which is used to * return a subset of the parsed options. * * Options which are unknown to the command metadata are always excluded. * * @param predicate If excluded, `() => true` is used. */ export function filterCommandLineOptions(options: readonly O[], parsedArgs: CommandLineOptions, predicate: OptionPredicate = () => true): CommandLineOptions { const initial: CommandLineOptions = { _: parsedArgs._ }; if (parsedArgs['--']) { initial['--'] = parsedArgs['--']; } const mapped = new Map([ ...options.map((o): [string, O] => [o.name, o]), ...lodash.flatten(options.map(opt => opt.aliases ? opt.aliases.map((a): [string, O] => [a, opt]) : [])), ]); const pairs = Object.keys(parsedArgs) .map((k): [string, O | undefined, ParsedArg | undefined] => [k, mapped.get(k), parsedArgs[k]]) .filter(([ k, opt, value ]) => opt && predicate(opt, value)) .map(([ k, opt, value ]) => [opt ? opt.name : k, value]); return { ...initial, ...lodash.fromPairs(pairs) }; } /** * Given an array of command metadata options and an object of parsed options, * return a subset of the parsed options whose command metadata option * definition contains the supplied group(s). * * Options which are unknown to the command metadata are always excluded. * * @param groups One or more option groups. */ export function filterCommandLineOptionsByGroup(options: readonly O[], parsedArgs: CommandLineOptions, groups: string | string[]): CommandLineOptions { return filterCommandLineOptions(options, parsedArgs, OptionFilters.includesGroups(groups)); } export interface UnparseArgsOptions { useDoubleQuotes?: boolean; useEquals?: boolean; ignoreFalse?: boolean; allowCamelCase?: boolean; } /** * The opposite of `parseArgs()`. This function takes parsed args and converts * them back into an argv array of arguments and options. * * Based on dargs, by sindresorhus * @see https://github.com/sindresorhus/dargs/blob/master/license * * @param parsedArgs Inputs and options parsed by minimist. * @param options.useDoubleQuotes For options with values, wrap the value in * double quotes if it contains a space. * @param options.useEquals Instead of separating an option and its value with * a space, use an equals sign. * @param options.ignoreFalse Optionally ignore flags that equate to false. * @param options.allowCamelCase Optionally allow camel cased options instead * of converting to kebab case. * @param parseArgsOptions To provide more accuracy, specify the options that * were used to parse the args in the first place. */ export function unparseArgs(parsedArgs: minimist.ParsedArgs, { useDoubleQuotes, useEquals = true, ignoreFalse = true, allowCamelCase }: UnparseArgsOptions = {}, parseArgsOptions?: minimist.Opts): string[] { const args = [...parsedArgs['_'] || []]; const separatedArgs = parsedArgs['--']; if (useDoubleQuotes) { useEquals = true; } const dashKey = (k: string) => (k.length === 1 ? '-' : '--') + k; const pushPairs = (...pairs: [string, string | undefined][]) => { for (const [ k, val ] of pairs) { const key = dashKey(allowCamelCase ? k : k.replace(/[A-Z]/g, '-$&').toLowerCase()); if (useEquals) { args.push(key + (val ? `=${useDoubleQuotes && val.includes(' ') ? `"${val}"` : val}` : '')); } else { args.push(key); if (val) { args.push(val); } } } }; // Normalize the alias definitions from the options for `parseArgs`. const aliasDef: { [key: string]: string[]; } = parseArgsOptions && parseArgsOptions.alias ? lodash.mapValues(parseArgsOptions.alias, v => Array.isArray(v) ? v : [v]) : {}; // Construct a mapping of alias to original key name. const aliases = new Map(lodash.flatten(Object.keys(aliasDef).map(k => aliasDef[k].map((a): [string, string] => [a, k])))); const isKnown = (key: string) => { if (!parseArgsOptions || !parseArgsOptions.unknown) { return true; } if ( (typeof parseArgsOptions.string !== 'undefined' && (Array.isArray(parseArgsOptions.string) && parseArgsOptions.string.includes(key))) || (typeof parseArgsOptions.boolean !== 'undefined' && (Array.isArray(parseArgsOptions.boolean) && parseArgsOptions.boolean.includes(key))) || aliases.has(key) ) { return true; } return parseArgsOptions.unknown(key); }; // Convert the parsed args to an array of 2-tuples of shape [key, value]. // Then, filter out pairs which match any of the following criteria: // - `_` (positional argument list) // - `--` (separated args) // - Aliases whose original key is defined // - Options not known to the schema, according to // `parseArgsOptions.unknown` option. const pairedOptions = lodash.toPairs(parsedArgs).filter(([k]) => k !== '_' && k !== '--' && !(aliases.get(k) && typeof parsedArgs[k] !== 'undefined') && isKnown(k) ); for (const [ key, val ] of pairedOptions) { if (val === true) { pushPairs([key, undefined]); } else if (val === false && !ignoreFalse) { pushPairs([`no-${key}`, undefined]); } else if (typeof val === 'string') { pushPairs([key, val]); } else if (typeof val === 'number' && !Number.isNaN(val)) { pushPairs([key, val.toString()]); } else if (Array.isArray(val)) { pushPairs(...val.map((v): [string, string] => [key, v])); } } if (separatedArgs && separatedArgs.length > 0) { args.push('--', ...separatedArgs); } return args; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/lib/validators.ts000066400000000000000000000061531425441362600275160ustar00rootroot00000000000000import * as chalk from 'chalk'; import { ValidationError, Validator, Validators } from '../definitions'; import { InputValidationError } from '../errors'; import { isValidEmail, isValidURL, slugify } from '../utils/string'; export function validate(input: string, key: string, validatorsToUse: Validator[]): void { const errors: ValidationError[] = []; for (const validator of validatorsToUse) { const message = validator(input, key); if (message !== true) { errors.push({ key, message, validator }); } } if (errors.length > 0) { throw new InputValidationError('Invalid inputs.', errors); } } export const validators: Validators = { required(input?: string, key?: string) { if (!input) { if (key) { return `${chalk.green(key)} must not be empty.`; } else { return 'Must not be empty.'; } } return true; }, email(input?: string, key?: string) { if (!isValidEmail(input)) { if (key) { return `${chalk.green(key)} is an invalid email address.`; } else { return 'Invalid email address.'; } } return true; }, url(input?: string, key?: string) { if (!isValidURL(input)) { if (key) { return `${chalk.green(key)} is an invalid URL.`; } else { return 'Invalid URL.'; } } return true; }, numeric(input?: string, key?: string) { if (isNaN(Number(input))) { if (key) { return `${chalk.green(key)} must be numeric.`; } else { return 'Must be numeric.'; } } return true; }, slug(input?: string, key?: string) { if (!input || slugify(input) !== input) { if (key) { return `${chalk.green(key)} is an invalid slug (machine name).`; } else { return 'Invalid slug (machine name).'; } } return true; }, }; export function combine(...validators: Validator[]): Validator { return (input?: string, key?: string) => { for (const validator of validators) { const message = validator(input, key); if (message !== true) { return message; } } return true; }; } export function contains(values: (string | undefined)[], { caseSensitive = true }: { caseSensitive?: boolean }): Validator { if (!caseSensitive) { values = values.map(v => typeof v === 'string' ? v.toLowerCase() : v); } return (input?: string, key?: string): true | string => { if (!caseSensitive && typeof input === 'string') { input = input.toLowerCase(); } if (values.indexOf(input) === -1) { const strValues = values.filter(v => typeof v === 'string') as string[]; // TODO: typescript bug? const mustBe = (strValues.length !== values.length ? 'unset or one of' : 'one of') + ': ' + strValues.map(v => chalk.green(v)).join(', '); const fmtPretty = (v?: string) => typeof v === 'undefined' ? 'unset' : (v === '' ? 'empty' : chalk.green(v)); if (key) { return `${chalk.green(key)} must be ${mustBe} (not ${fmtPretty(input)})`; } else { return `Must be ${mustBe} (not ${fmtPretty(input)})`; } } return true; }; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/000077500000000000000000000000001425441362600253635ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/__tests__/000077500000000000000000000000001425441362600273215ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/__tests__/fn.ts000066400000000000000000000055671425441362600303110ustar00rootroot00000000000000import { resolveValue, resolveValueSync } from '../fn'; describe('@ionic/cli-framework', () => { describe('fn', () => { describe('resolveValue', () => { it('should resolve with undefined with 0 functions', async () => { const result = await resolveValue(); expect(result).not.toBeDefined(); }); it('should resolve with undefined with functions that never resolve values', async () => { const result = await resolveValue(async () => {}, async () => {}, async () => {}); expect(result).not.toBeDefined(); }); it('should resolve with value of first function that resolve value', async () => { const result = await resolveValue(async () => 1, async () => 2, async () => 3); expect(result).toBe(1); }); it('should skip functions that do not resolve values', async () => { const result = await resolveValue(async () => undefined, async () => 2, async () => 3); expect(result).toBe(2); }); describe('falsy values', () => { it('should resolve with null', async () => { const result = await resolveValue(async () => null, async () => 'foo'); expect(result).toBe(null); }); it('should resolve with 0', async () => { const result = await resolveValue(async () => 0, async () => 5); expect(result).toBe(0); }); it('should resolve with empty string', async () => { const result = await resolveValue(async () => '', async () => 'foo'); expect(result).toBe(''); }); }); }); describe('resolveValueSync', () => { it('should return undefined with 0 functions', () => { const result = resolveValueSync(); expect(result).not.toBeDefined(); }); it('should return undefined with functions that never return values', () => { const result = resolveValueSync(() => {}, () => {}, () => {}); expect(result).not.toBeDefined(); }); it('should return value of first function that return value', () => { const result = resolveValueSync(() => 1, () => 2, () => 3); expect(result).toBe(1); }); it('should skip functions that do not return values', () => { const result = resolveValueSync(() => undefined, () => 2, () => 3); expect(result).toBe(2); }); describe('falsy values', () => { it('should return null', () => { const result = resolveValueSync(() => null, () => 'foo'); expect(result).toBe(null); }); it('should return 0', () => { const result = resolveValueSync(() => 0, () => 5); expect(result).toBe(0); }); it('should return empty string', () => { const result = resolveValueSync(() => '', () => 'foo'); expect(result).toBe(''); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/__tests__/node.ts000066400000000000000000000036111425441362600306170ustar00rootroot00000000000000import * as path from 'path' describe('@ionic/cli-framework', () => { describe('utils/node', () => { describe('compileNodeModulesPaths', () => { describe('posix', () => { const mock_path_posix = path.posix; jest.resetModules(); jest.mock('path', () => mock_path_posix); const nodeLib = require('../node'); it('should not accept a malformed path', () => { expect(() => nodeLib.compileNodeModulesPaths('.')).toThrowError('. is not an absolute path'); }); it('should compile an array of node_modules directories working backwards from a base directory', () => { const result = nodeLib.compileNodeModulesPaths('/some/dir'); expect(result).toEqual(['/some/dir/node_modules', '/some/node_modules', '/node_modules']); }); it('should work for the root directory', () => { const result = nodeLib.compileNodeModulesPaths('/'); expect(result).toEqual(['/node_modules']); }); }); describe('windows', () => { const mock_path_win32 = path.win32; jest.resetModules(); jest.mock('path', () => mock_path_win32); const nodeLib = require('../node'); it('should not accept a malformed path', () => { expect(() => nodeLib.compileNodeModulesPaths('.')).toThrowError('. is not an absolute path'); }); it('should compile an array of node_modules directories working backwards from a base directory', () => { const result = nodeLib.compileNodeModulesPaths('\\some\\dir'); expect(result).toEqual(['\\some\\dir\\node_modules', '\\some\\node_modules', '\\node_modules']); }); it('should work for the root directory', () => { const result = nodeLib.compileNodeModulesPaths('\\'); expect(result).toEqual(['\\node_modules']); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/__tests__/promise.ts000066400000000000000000000047361425441362600313610ustar00rootroot00000000000000import { EventEmitter } from 'events'; import { PromiseUtil, promisifyEvent } from '../promise'; describe('@ionic/cli-framework', () => { describe('utils/promise', () => { describe('promisifyEvent', () => { it('should reject on error event', async () => { const emitter = new EventEmitter(); const p = promisifyEvent(emitter, 'asdf'); const err = new Error('some error'); emitter.emit('error', err); emitter.emit('asdf'); expect(p).rejects.toThrow(err); }); it('should resolve when event is emitted', async () => { const emitter = new EventEmitter(); const p = promisifyEvent(emitter, 'asdf'); emitter.emit('asdf'); await p; }); it('should resolve with emitted value', async () => { const emitted = {}; const emitter = new EventEmitter(); const p = promisifyEvent(emitter, 'asdf'); emitter.emit('asdf', emitted); const result = await p; expect(result).toBe(emitted); }); }); describe('PromiseUtil', () => { it('should resolve for 1 promise using some by default', async () => { const result = await PromiseUtil.some([Promise.resolve('a'), Promise.resolve('b'), Promise.resolve('c')]); expect(result.length).toEqual(1); for (const val of result) { expect(val).toEqual(expect.stringMatching(/^[abc]{1}$/)); } }); it('should resolve for specified number of promises using some', async () => { const result = await PromiseUtil.some([Promise.resolve('a'), Promise.resolve('b'), Promise.resolve('c')], 2); expect(result.length).toEqual(2); for (const val of result) { expect(val).toEqual(expect.stringMatching(/^[abc]{1}$/)); } }); it('should resolve for all promises using some', async () => { const promises = [Promise.resolve('a'), Promise.resolve('b'), Promise.resolve('c')]; const result = await PromiseUtil.some(promises, promises.length); expect(result.length).toEqual(promises.length); for (const val of result) { expect(val).toEqual(expect.stringMatching(/^[abc]{1}$/)); } }); it('should resolve for 1 promise value using any', async () => { const result = await PromiseUtil.any([Promise.resolve('a'), Promise.resolve('b'), Promise.resolve('c')]); expect(result).toEqual(expect.stringMatching(/^[abc]{1}$/)); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/__tests__/string.ts000066400000000000000000000107071425441362600312040ustar00rootroot00000000000000import { isValidURL, slugify } from '../string'; describe('@ionic/cli-framework', () => { describe('utils/string', () => { describe('isValidURL', () => { it('should work without parameter', () => { expect(isValidURL()).toBe(false); }); it('should work with non-string', () => { expect(isValidURL(5)).toBe(false); }); it('should test a non-url', () => { expect(isValidURL('this is some text')).toBe(false); }); it('should test text with a colon', () => { expect(isValidURL('let me tell you something: hello')).toBe(false); }); it('should test a localhost url', () => { expect(isValidURL('http://localhost')).toBe(true); }); it('should test an https url', () => { expect(isValidURL('https://ionicframework.com')).toBe(true); }); it('should test a git url', () => { expect(isValidURL('git@github.com:ionic-team/ionic-cli.git')).toBe(true); }); }); describe('slugify', () => { it('should pass back the empty string', () => { const result = slugify(''); expect(result).toEqual(''); }); it('should not change slugified input', () => { const result = slugify('foo'); expect(result).toEqual('foo'); }); it('should trim whitespace', () => { const result = slugify(' foo '); expect(result).toEqual('foo'); }); it('should lowercase input', () => { const result = slugify('FOO'); expect(result).toEqual('foo'); }); it('should convert input to kebab case by default', () => { const result = slugify('foo bar baz'); expect(result).toEqual('foo-bar-baz'); }); it('should convert input to snake case with underscore separator', () => { const result = slugify('foo bar baz', { separator: '_' }); expect(result).toEqual('foo_bar_baz'); }); it('should strip out invalid characters', () => { const result = slugify('~ ` ! @ # $ % ^ & * ( ) - = + [ { } ] \' \\ | / > < . , ; : "'); expect(result).toEqual(''); }); it('should convert inferred words to kebab case', () => { const result = slugify('MyCoolApp'); expect(result).toEqual('my-cool-app'); }); it('should trim whitespace', () => { const result = slugify(' foo '); expect(result).toEqual('foo'); }); it('should strip out apostrophes', () => { const result = slugify(' foo\'s bar '); expect(result).toEqual('foos-bar'); }); it('should convert ÀÃÂÃÄÅ and àáâãäå characters', () => { const result = slugify('ÀÃÂÃÄÅ àáâãäå'); expect(result).toEqual('a'.repeat(6) + '-' + 'a'.repeat(6)); }); it('should convert Ææ characters', () => { const result = slugify('Ææ'); expect(result).toEqual('ae'.repeat(2)); }); it('should convert Çç characters', () => { const result = slugify('Çç'); expect(result).toEqual('cc'); }); it('should convert ÈÉÊË and èéêë characters', () => { const result = slugify('ÈÉÊË èéêë'); expect(result).toEqual('e'.repeat(4) + '-' + 'e'.repeat(4)); }); it('should convert ÃŒÃÃŽÃ and ìíîï characters', () => { const result = slugify('ÃŒÃÎà ìíîï'); expect(result).toEqual('i'.repeat(4) + '-' + 'i'.repeat(4)); }); it('should convert Ññ characters', () => { const result = slugify('Ññ'); expect(result).toEqual('n'.repeat(2)); }); it('should convert ÒÓÔÕÖØ and òóôõöø characters', () => { const result = slugify('ÒÓÔÕÖØ òóôõöø'); expect(result).toEqual('o'.repeat(6) + '-' + 'o'.repeat(6)); }); it('should convert ÙÚÛÜ, ùúûü characters', () => { const result = slugify('ÙÚÛÜ ùúûü'); expect(result).toEqual('u'.repeat(4) + '-' + 'u'.repeat(4)); }); it('should convert Þþ characters', () => { const result = slugify('Þþ'); expect(result).toEqual('th'.repeat(2)); }); it('should convert Ãýÿ characters', () => { const result = slugify('Ãýÿ'); expect(result).toEqual('y'.repeat(3)); }); it('should convert ß characters', () => { const result = slugify('ß'); expect(result).toEqual('ss'); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/fn.ts000066400000000000000000000007031425441362600263360ustar00rootroot00000000000000export async function resolveValue(...fns: (() => Promise)[]): Promise { for (const fn of fns) { const result = await fn(); if (typeof result !== 'undefined') { return result; } } } export function resolveValueSync(...fns: (() => T | undefined)[]): T | undefined { for (const fn of fns) { const result = fn(); if (typeof result !== 'undefined') { return result; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/ipc.ts000066400000000000000000000130471425441362600265130ustar00rootroot00000000000000import { fork } from '@ionic/utils-subprocess'; import { ChildProcess } from 'child_process'; import * as Debug from 'debug'; import * as fs from 'fs'; import { ERROR_IPC_UNKNOWN_PROCEDURE, IPCError } from '../errors'; const debug = Debug('ionic:cli-framework:utils:ipc'); export interface RPCRequest

{ type: 'rpc-request'; id: string; procedure: P; args: A; } export interface RPCResponse, D extends object> { type: 'rpc-response'; id: string; procedure: R['procedure']; request: R; err?: any; data: D; } export type RPC

= RPCResponse, D>; export interface RPCProcessOptions { readonly name?: string; readonly timeout?: number; } export class RPCProcess { readonly name: string; readonly timeout: number; protected responseProcedures: Map Promise> = new Map(); protected proc?: ChildProcess; constructor({ name = 'unnamed', timeout = 5000 }: RPCProcessOptions = {}) { this.name = name; this.timeout = timeout; } start(proc: ChildProcess | NodeJS.Process): void { if (this.proc) { throw new IPCError('RPC process already started.'); } const p = proc as ChildProcess; if (!p.send) { throw new IPCError('Cannot use proc: `send()` undefined.'); } this.proc = p; p.on('message', async (msg: any) => { if (isRPCRequest(msg)) { debug('%s: Received RPC request: %O', this.name, msg); const fn = this.responseProcedures.get(msg.procedure); let err: any; let data: any; if (fn) { try { data = await fn(msg.args); } catch (e) { err = e; } } else { err = new IPCError(`Unknown procedure: ${msg.procedure}`); err.code = ERROR_IPC_UNKNOWN_PROCEDURE; } const response: RPCResponse = { type: 'rpc-response', id: msg.id, procedure: msg.procedure, request: msg, err, data }; if (p.send) { p.send(response); debug('%s: Sent RPC response: %O', this.name, response); } else { throw new IPCError('Cannot use proc: `send()` undefined.'); } } }); p.on('error', err => { debug('%s: Encountered error with proc: %O', this.name, err); }); debug('%s: RPC process initiated (pid: %d)', this.name, p.pid); } register>(procedure: R['procedure'], fn: (args: R['request']['args']) => Promise): void { this.responseProcedures.set(procedure, fn); } async call>(procedure: R['procedure'], args: R['request']['args']): Promise { const p = this.proc; if (!p) { throw new IPCError('Cannot call procedure: no proc started.'); } const id = Math.random().toString(16).substring(2, 8); const request: RPCRequest = { type: 'rpc-request', id, procedure, args }; return new Promise((resolve, reject) => { const timer = setTimeout(() => { reject(new IPCError(`Timeout of ${this.timeout}ms reached.`)); }, this.timeout); const messageHandler = (msg: any) => { if (isRPCResponse(msg) && msg.id === id) { debug('%s: Received RPC response: %O', this.name, msg); if (msg.err) { reject(msg.err); } else { resolve(msg.data); } p.removeListener('message', messageHandler); p.removeListener('disconnect', disconnectHandler); clearTimeout(timer); } }; const disconnectHandler = () => { reject(new IPCError('Unexpected disconnect. Rejecting call!')); clearTimeout(timer); }; p.on('message', messageHandler); p.on('disconnect', disconnectHandler); if (p.send) { p.send(request); debug('%s: Sent RPC request: %O', this.name, request); } else { reject(new IPCError('Cannot use proc: `send()` undefined.')); clearTimeout(timer); } }); } end(): void { if (!this.proc) { throw new IPCError(`RPC process not started.`); } this.proc.disconnect(); debug('%s: Disconnected', this.name); } } export class RPCHost { protected rpc: RPCProcess; constructor(readonly modulePath: string, readonly args: readonly string[]) { this.rpc = new RPCProcess({ name: 'host' }); } start(): void { try { fs.accessSync(this.modulePath, fs.constants.R_OK); } catch (e) { debug('Error during access check: %O', e); throw new IPCError(`Module not accessible: ${this.modulePath}`); } const p = fork(this.modulePath, this.args, { stdio: ['ignore', 'ignore', 'ignore', 'ipc'] }); debug('RPC subprocess forked %o', [this.modulePath, ...this.args]); this.rpc.start(p); } register>(procedure: R['procedure'], fn: (args: R['request']['args']) => Promise): void { this.rpc.register(procedure, fn); } async call>(procedure: R['procedure'], args: R['request']['args']): Promise { return this.rpc.call(procedure, args); } end(): void { this.rpc.end(); } } function isRPCRequest(msg: any): msg is RPCRequest { return msg && msg.type === 'rpc-request' && typeof msg.procedure === 'string'; } function isRPCResponse(msg: any): msg is RPCResponse { return msg && msg.type === 'rpc-response' && typeof msg.procedure === 'string'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/node.ts000066400000000000000000000026571425441362600266720ustar00rootroot00000000000000import { compilePaths, readJson } from '@ionic/utils-fs'; import * as fs from 'fs'; import * as path from 'path'; import { PackageJson } from '../definitions'; import { isPackageJson } from '../guards'; export const ERROR_INVALID_PACKAGE_JSON = 'INVALID_PACKAGE_JSON'; export const ERROR_BIN_NOT_FOUND = 'BIN_NOT_FOUND'; /** * Lightweight version of https://github.com/npm/validate-npm-package-name */ export function isValidPackageName(name: string): boolean { return encodeURIComponent(name) === name; } export async function readPackageJsonFile(p: string): Promise { const packageJson = await readJson(p); if (!isPackageJson(packageJson)) { throw ERROR_INVALID_PACKAGE_JSON; } return packageJson; } export function compileNodeModulesPaths(filePath: string): string[] { return compilePaths(filePath).map(f => path.join(f, 'node_modules')); } export interface ResolveOptions { paths?: string[]; } export function resolveBin(m: string, bin: string, options?: ResolveOptions): string { const packageJsonPath = require.resolve(`${m}/package`, options); const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, { encoding: 'utf8' })); if (!isPackageJson(packageJson) || !packageJson.bin) { throw ERROR_INVALID_PACKAGE_JSON; } const desiredBin = packageJson.bin[bin]; if (!desiredBin) { throw ERROR_BIN_NOT_FOUND; } return path.resolve(path.dirname(packageJsonPath), desiredBin); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/promise.ts000066400000000000000000000043511425441362600274140ustar00rootroot00000000000000import { EventEmitter } from 'events'; export interface Promisify { (func: (callback: (err: any, result?: T) => void) => void): () => Promise; (func: (arg1: A1, callback: (err: any, result?: T) => void) => void): (arg1: A1) => Promise; (func: (arg1: A1, arg2: A2, callback: (err: any, result?: T) => void) => void): (arg1: A1, arg2: A2) => Promise; (func: (arg1: A1, arg2: A2, arg3: A3, callback: (err: any, result?: T) => void) => void): (arg1: A1, arg2: A2, arg3: A3) => Promise; (func: (arg1: A1, arg2: A2, arg3: A3, arg4: A4, callback: (err: any, result?: T) => void) => void): (arg1: A1, arg2: A2, arg3: A3, arg4: A4) => Promise; (func: (arg1: A1, arg2: A2, arg3: A3, arg4: A4, arg5: A5, callback: (err: any, result?: T) => void) => void): (arg1: A1, arg2: A2, arg3: A3, arg4: A4, arg5: A5) => Promise; } export const promisify: Promisify = (func: any) => { return (...args: any[]) => { return new Promise((resolve, reject) => { func(...args, (err: any, response: any) => { if (err) { return reject(err); } resolve(response); }); }); }; }; export const promisifyEvent = (emitter: EventEmitter, event: string | symbol): Promise => { return new Promise((resolve, reject) => { emitter.once(event, (value: any) => { resolve(value); }); emitter.once('error', (err: Error) => { reject(err); }); }); }; export namespace PromiseUtil { export function some(promises: Promise[], expected = 1): Promise { if (promises.length === expected) { return Promise.all(promises); } return new Promise((resolve, reject) => { const values: any[] = []; const resolveOne = (value: any) => { if (expected-- > 0) { values.push(value); } else { resolve(values); } }; const rejectOne = (err: any) => { reject(err); }; for (const promise of promises) { promise.then(resolveOne, rejectOne); } }); } export async function any(promises: Promise[]): Promise { const [ first ] = await some(promises, 1); return first; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/src/utils/string.ts000066400000000000000000000025021425441362600272400ustar00rootroot00000000000000import * as lodash from 'lodash'; export const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/; export const URL_REGEX = /^[\S]+:[\S]+$/; export function isValidEmail(email?: any): boolean { if (typeof email !== 'string') { return false; } return EMAIL_REGEX.test(email); } export function isValidURL(url?: any): boolean { if (typeof url !== 'string') { return false; } return URL_REGEX.test(url); } export function strcmp(a: string | undefined, b: string | undefined): number { if (!a) { a = ''; } if (!b) { b = ''; } return +(a > b) || +(a === b) - 1; } export function str2num(value: any, defaultValue = -1): number { if (typeof value === 'number') { return value; } if (typeof value !== 'string') { return defaultValue; } const result = parseInt(value, 10); if (Number.isNaN(result)) { return defaultValue; } return result; } export interface SlugifyOptions { separator?: string; } /** * Create a slug out of an input string. * * Whitespace is trimmed, everything is lowercased, some international * characters are converted, then dasherized. */ export function slugify(input: string, { separator = '-' }: SlugifyOptions = {}): string { return lodash.words(lodash.deburr(input.trim())).map(w => w.toLowerCase().replace(/[^A-z0-9]/g, '')).join(separator); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli-framework/tsconfig.json000066400000000000000000000004271425441362600261460ustar00rootroot00000000000000{ "extends": "../../../tsconfig.base.json", "compilerOptions": { "outDir": "./", "types": [ "node" ] }, "include": [ "../../../types/stream-combiner2.d.ts", "src/**/*.ts" ], "exclude": [ "node_modules", "src/**/__tests__/*.ts" ] } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/000077500000000000000000000000001425441362600214415ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/.gitignore000066400000000000000000000000761425441362600234340ustar00rootroot00000000000000*.js !tslint.js !jest.config.js !lint-staged.config.js *.d.ts ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/.npmignore000066400000000000000000000001031425441362600234320ustar00rootroot00000000000000src jest.config.js lint-staged.config.js tsconfig.json tslint.json ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/.npmrc000066400000000000000000000000231425441362600225540ustar00rootroot00000000000000package-lock=false ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/CHANGELOG.md000066400000000000000000002042331425441362600232560ustar00rootroot00000000000000# Change Log All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. ## [6.20.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.20.0...@ionic/cli@6.20.1) (2022-06-21) **Note:** Version bump only for package @ionic/cli # [6.20.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.19.1...@ionic/cli@6.20.0) (2022-06-16) ### Bug Fixes * **integrations:** Move ng add @ionic/cordova-builders after package installs ([#4853](https://github.com/ionic-team/ionic-cli/issues/4853)) ([8a69ae0](https://github.com/ionic-team/ionic-cli/commit/8a69ae0fd7d7fc15a0d1d5107199299117d34af4)) ### Features * **capacitor:** enable NSAppTransportSecurity settings for live reload if needed ([#4851](https://github.com/ionic-team/ionic-cli/issues/4851)) ([24e22a6](https://github.com/ionic-team/ionic-cli/commit/24e22a60d17709ff78563a796db01e69b6d641cb)) * **cli:** allow cap electron commands ([#4854](https://github.com/ionic-team/ionic-cli/issues/4854)) ([46da22f](https://github.com/ionic-team/ionic-cli/commit/46da22ff5b89c66155829a307acd765c5ff957d0)) ## [6.19.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.19.0...@ionic/cli@6.19.1) (2022-05-09) ### Bug Fixes * **capacitor:** Match platform version with CLI version ([#4829](https://github.com/ionic-team/ionic-cli/issues/4829)) ([9846d46](https://github.com/ionic-team/ionic-cli/commit/9846d467e926e76232826175d3d0d50c00b1ef1f)) * **vue:** pass extra args to vue-cli serve ([#4827](https://github.com/ionic-team/ionic-cli/issues/4827)) ([87a0dcd](https://github.com/ionic-team/ionic-cli/commit/87a0dcdfd9f75b91e83c0eb13761d6135b226212)) # [6.19.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.18.2...@ionic/cli@6.19.0) (2022-03-15) ### Features * **integrations:** add ng add cordova-builder ([#4823](https://github.com/ionic-team/ionic-cli/issues/4823)) ([de8d028](https://github.com/ionic-team/ionic-cli/commit/de8d028f54199ddd59aed6636378e4829875a0cd)) ## [6.18.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.18.1...@ionic/cli@6.18.2) (2022-03-04) ### Bug Fixes * Pin @types/superagent version to avoid build problems ([#4802](https://github.com/ionic-team/ionic-cli/issues/4802)) ([bdf5b05](https://github.com/ionic-team/ionic-cli/commit/bdf5b05833b92471f4ac5ba24437a8131adbf2e1)) ## [6.18.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.18.0...@ionic/cli@6.18.1) (2021-11-10) ### Bug Fixes * Update superagent-proxy dependency to v3 ([#4779](https://github.com/ionic-team/ionic-cli/issues/4779)) ([f153355](https://github.com/ionic-team/ionic-cli/commit/f153355324a958389f8414d72caa41035ec8bd98)) # [6.18.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.17.1...@ionic/cli@6.18.0) (2021-10-25) ### Bug Fixes * **vue:** pass extra args to vue-cli ([56dd8a7](https://github.com/ionic-team/ionic-cli/commit/56dd8a7fe94d764bac63a41d35e0b709a2dde893)), closes [#4669](https://github.com/ionic-team/ionic-cli/issues/4669) [#4642](https://github.com/ionic-team/ionic-cli/issues/4642) [#4642](https://github.com/ionic-team/ionic-cli/issues/4642) ### Features * **appflow:** deprecate appflow functionality in @ionic/cli ([#4776](https://github.com/ionic-team/ionic-cli/issues/4776)) ([6a39641](https://github.com/ionic-team/ionic-cli/commit/6a39641555c9247cc53091db5afde73f9b1d3e34)) ## [6.17.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.17.0...@ionic/cli@6.17.1) (2021-09-03) ### Bug Fixes * support Capacitor 1 apps ([#4758](https://github.com/ionic-team/ionic-cli/issues/4758)) ([0ca282b](https://github.com/ionic-team/ionic-cli/commit/0ca282b615e52867b1cbf263d08472878083f34f)) # [6.17.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.16.3...@ionic/cli@6.17.0) (2021-08-11) ### Bug Fixes * numeric app names dont crash adding capacitor ([#4709](https://github.com/ionic-team/ionic-cli/issues/4709)) ([e13a4c5](https://github.com/ionic-team/ionic-cli/commit/e13a4c5ebccc79a85334968854688df9ada4b150)) * Remove serve options from cap run command ([#4736](https://github.com/ionic-team/ionic-cli/issues/4736)) ([75e635b](https://github.com/ionic-team/ionic-cli/commit/75e635b6431d186a79ab5ad685ca10798120e38f)) ### Features * Add web based GUI start wizard to ionic start command ([#4746](https://github.com/ionic-team/ionic-cli/issues/4746)) ([c0669a9](https://github.com/ionic-team/ionic-cli/commit/c0669a9d48b3728c485aa19a2d55fedbe582d121)) * Cap is no longer experimental and is default for Angular ([#4745](https://github.com/ionic-team/ionic-cli/issues/4745)) ([d81e08b](https://github.com/ionic-team/ionic-cli/commit/d81e08bee0e2495c97b984dcc69f95c00ade31ab)) ## [6.16.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.16.2...@ionic/cli@6.16.3) (2021-06-08) ### Bug Fixes * revert the change to update the lock file when the --no-deps flag is used and issue a warning instead ([#4713](https://github.com/ionic-team/ionic-cli/issues/4713)) ([96ba8b4](https://github.com/ionic-team/ionic-cli/commit/96ba8b40a24a8ba4e4bcfb84aa972e77220fb3d4)) ## [6.16.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.16.1...@ionic/cli@6.16.2) (2021-06-03) ### Bug Fixes * Add status-bar to plugins installed on capacitor integration ([#4701](https://github.com/ionic-team/ionic-cli/issues/4701)) ([7c49d5c](https://github.com/ionic-team/ionic-cli/commit/7c49d5cdd717a05eff2e2f2d1fc5f209fd450f43)) * updated `ionic start` to update lock files when the --no-deps arg is passed ([#4706](https://github.com/ionic-team/ionic-cli/issues/4706)) ([868e61d](https://github.com/ionic-team/ionic-cli/commit/868e61d70c54023e39896b677ceac331b0606167)) ## [6.16.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.16.0...@ionic/cli@6.16.1) (2021-05-19) ### Bug Fixes * **capacitor:** Make add use latest instead of next ([#4700](https://github.com/ionic-team/ionic-cli/issues/4700)) ([04be661](https://github.com/ionic-team/ionic-cli/commit/04be661d9ec48960428aa65987c21a5f2bd6951b)) # [6.16.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.15.0...@ionic/cli@6.16.0) (2021-05-19) ### Bug Fixes * **capacitor:** remove extra logging ([6cebf63](https://github.com/ionic-team/ionic-cli/commit/6cebf631dc3ab2b683da2a9a8fd24787504b88ae)) ### Features * **capacitor:** capacitor 3 support ([#4610](https://github.com/ionic-team/ionic-cli/issues/4610)) ([359cdec](https://github.com/ionic-team/ionic-cli/commit/359cdec031f3c3484093e9fee65e06ef866cfd8b)), closes [#4690](https://github.com/ionic-team/ionic-cli/issues/4690) # [6.15.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.14.1...@ionic/cli@6.15.0) (2021-05-11) ### Features * **link:** Link bug fix and git selection changes ([#4689](https://github.com/ionic-team/ionic-cli/issues/4689)) ([942e965](https://github.com/ionic-team/ionic-cli/commit/942e96576f17b9958d4fe0be680235bc22ecbd32)) ## [6.14.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.14.0...@ionic/cli@6.14.1) (2021-04-30) ### Bug Fixes * **appflow:** allow personal accounts to install enterprise packages ([#4681](https://github.com/ionic-team/ionic-cli/issues/4681)) ([97b0ee5](https://github.com/ionic-team/ionic-cli/commit/97b0ee5fa4432f965eabd38089681045dd3a4d5c)) # [6.14.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.13.1...@ionic/cli@6.14.0) (2021-04-28) ### Features * **appflow:** add flag for skipping artifact download after builds succeed ([#4678](https://github.com/ionic-team/ionic-cli/issues/4678)) ([d87c6f2](https://github.com/ionic-team/ionic-cli/commit/d87c6f28a34c668349868f8214346ff07398c820)) ## [6.13.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.13.0...@ionic/cli@6.13.1) (2021-02-22) ### Bug Fixes * **appflow:** fix deploy manifest for Capacitor 1.x apps ([#4648](https://github.com/ionic-team/ionic-cli/issues/4648)) ([77b02a3](https://github.com/ionic-team/ionic-cli/commit/77b02a39d08fb369c6b95b5f3b0c255370e9fc23)) # [6.13.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.12.4...@ionic/cli@6.13.0) (2021-02-18) ### Bug Fixes * **appflow:** Default should be all available not hard-coded by platform ([#4645](https://github.com/ionic-team/ionic-cli/issues/4645)) ([6e66109](https://github.com/ionic-team/ionic-cli/commit/6e66109d4993ddb24882bd5c5875a31b2fe65cff)) ### Features * **appflow:** support Capacitor only apps with `ionic deploy manifest` ([#4641](https://github.com/ionic-team/ionic-cli/issues/4641)) ([cee620b](https://github.com/ionic-team/ionic-cli/commit/cee620baff2515115393d882b88f6a99e3fefd9b)) * **appflow:** Support downloading all artifact types from appflow builds ([cae11db](https://github.com/ionic-team/ionic-cli/commit/cae11dba3f1efbec753ae6e91c21ad79be169e38)) * **appflow:** Support downloading WWW_ZIP after deploy build ([bce15d1](https://github.com/ionic-team/ionic-cli/commit/bce15d1b57a102938d4e6922773fe27af24dcca7)) ## [6.12.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.12.3...@ionic/cli@6.12.4) (2021-01-27) ### Bug Fixes * **Appflow:** Fix issue with deploy add and deploy configure commands where sometimes necessary variables weren't correctly set. ([#4634](https://github.com/ionic-team/ionic-cli/issues/4634)) ([be6cf2e](https://github.com/ionic-team/ionic-cli/commit/be6cf2e05957b38c35dd692a3917c22c262e5e71)) ## [6.12.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.12.2...@ionic/cli@6.12.3) (2020-12-10) ### Bug Fixes * **appflow:** allow download of packages built from branches with in the name. CT-434 ([#4622](https://github.com/ionic-team/ionic-cli/issues/4622)) ([0054fd5](https://github.com/ionic-team/ionic-cli/commit/0054fd51706c071ffad98bf04ee053266bc780d1)) ## [6.12.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.12.1...@ionic/cli@6.12.2) (2020-11-17) ### Bug Fixes * **react:** fix stdin to unblock react-scripts>3.4.0 ([#4609](https://github.com/ionic-team/ionic-cli/issues/4609)) ([47631f5](https://github.com/ionic-team/ionic-cli/commit/47631f5a9331f3bc428933da68c82176221746c6)) ## [6.12.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.12.0...@ionic/cli@6.12.1) (2020-10-29) ### Bug Fixes * **Appflow:** fixes bug when a build that gets cancelled on the dashboard is not recognized as a final state in the CLI ([#4598](https://github.com/ionic-team/ionic-cli/issues/4598)) ([51eab00](https://github.com/ionic-team/ionic-cli/commit/51eab00105a7616df869cd82eea54f1a55b7ab44)) # [6.12.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.12...@ionic/cli@6.12.0) (2020-10-15) ### Features * support vue projects ([#4515](https://github.com/ionic-team/ionic-cli/issues/4515)) ([ad6c483](https://github.com/ionic-team/ionic-cli/commit/ad6c483bd59b4f5e70acac22f456b0b062f4d39c)) ## [6.11.12](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.11...@ionic/cli@6.11.12) (2020-10-12) ### Bug Fixes * **capacitor:** use correct root when checking platforms ([e243357](https://github.com/ionic-team/ionic-cli/commit/e2433573bae66210d7ef29d6a2c170faa8abe408)) * **cordova:** load config.xml after serve/build hooks ([9867ada](https://github.com/ionic-team/ionic-cli/commit/9867adafbdd200712a35b38d39c54af6f809c987)) ## [6.11.11](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.10...@ionic/cli@6.11.11) (2020-10-05) ### Bug Fixes * **Appflow:** fix bug where appflow build would fail to copy IPA/APK if tmp dir was mounted on a different filesystem ([#4578](https://github.com/ionic-team/ionic-cli/issues/4578)) ([65c740d](https://github.com/ionic-team/ionic-cli/commit/65c740d8ef3195e63d026ac229b7fe8bf1187da6)) ## [6.11.10](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.9...@ionic/cli@6.11.10) (2020-09-29) **Note:** Version bump only for package @ionic/cli ## [6.11.9](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.8...@ionic/cli@6.11.9) (2020-09-24) ### Bug Fixes * **cordova:** handle output-metadata.json files during android run ([5905cc1](https://github.com/ionic-team/ionic-cli/commit/5905cc1a9cd75b1a2bb8343da2fbc7146322ad28)) ## [6.11.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.7...@ionic/cli@6.11.8) (2020-09-02) **Note:** Version bump only for package @ionic/cli ## [6.11.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.6...@ionic/cli@6.11.7) (2020-08-29) **Note:** Version bump only for package @ionic/cli ## [6.11.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.5...@ionic/cli@6.11.6) (2020-08-28) **Note:** Version bump only for package @ionic/cli ## [6.11.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.4...@ionic/cli@6.11.5) (2020-08-27) **Note:** Version bump only for package @ionic/cli ## [6.11.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.3...@ionic/cli@6.11.4) (2020-08-27) **Note:** Version bump only for package @ionic/cli ## [6.11.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.2...@ionic/cli@6.11.3) (2020-08-26) **Note:** Version bump only for package @ionic/cli ## [6.11.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.1...@ionic/cli@6.11.2) (2020-08-25) **Note:** Version bump only for package @ionic/cli ## [6.11.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.11.0...@ionic/cli@6.11.1) (2020-08-20) ### Bug Fixes * **appflow:** fix an issue where a network connectivity issue could c… ([#4520](https://github.com/ionic-team/ionic-cli/issues/4520)) ([8634fde](https://github.com/ionic-team/ionic-cli/commit/8634fde68bdfa8f4af724e4a86bb285c44924f37)) # [6.11.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.10.2...@ionic/cli@6.11.0) (2020-07-29) ### Features * add `capacitor:sync:after` hook ([#4496](https://github.com/ionic-team/ionic-cli/issues/4496)) ([c63d4e1](https://github.com/ionic-team/ionic-cli/commit/c63d4e1957f36549142275c11f7198c68874cef1)) ## [6.10.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.10.1...@ionic/cli@6.10.2) (2020-07-27) ### Bug Fixes * use inline uuid v4 function ([#4501](https://github.com/ionic-team/ionic-cli/issues/4501)) ([3743d7b](https://github.com/ionic-team/ionic-cli/commit/3743d7b3e01166dd70716558d55a500419a8bb13)) ## [6.10.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.10.0...@ionic/cli@6.10.1) (2020-06-15) ### Bug Fixes * **cordova:** handle new format of output.json files for Android builds ([#4470](https://github.com/ionic-team/ionic-cli/issues/4470)) ([689b886](https://github.com/ionic-team/ionic-cli/commit/689b886a4a1395aa8bf3c6b0da21bde4a41e0de1)) * use pnpm if configured in build/serve commands ([#4459](https://github.com/ionic-team/ionic-cli/issues/4459)) ([174985f](https://github.com/ionic-team/ionic-cli/commit/174985fca87322d4b52929ae44e93f639665bdf8)) # [6.10.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.9.3...@ionic/cli@6.10.0) (2020-06-02) ### Bug Fixes * **cordova:** platform is a required input ([1bd3087](https://github.com/ionic-team/ionic-cli/commit/1bd30874f46d89248193c959dd8d769dd99503cf)) ### Features * **login:** default to browser login ([#4451](https://github.com/ionic-team/ionic-cli/issues/4451)) ([0738abd](https://github.com/ionic-team/ionic-cli/commit/0738abd4123b6b5e078cd7ff2f76ed1a26474cf0)) ## [6.9.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.9.2...@ionic/cli@6.9.3) (2020-05-27) ### Bug Fixes * **start:** fix issue with starting the react conf app ([daf1f72](https://github.com/ionic-team/ionic-cli/commit/daf1f72372ca3966c57c7e32adc38001cf3a5fdb)) ## [6.9.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.9.1...@ionic/cli@6.9.2) (2020-05-17) ### Bug Fixes * **link:** fix GitHub OAuth URL on WSL ([#4442](https://github.com/ionic-team/ionic-cli/issues/4442)) ([93c5bf5](https://github.com/ionic-team/ionic-cli/commit/93c5bf5ba0cc0549a4bf61f534ee30d465bfe35e)) * **package:** fix name of the package deploy name ([#4435](https://github.com/ionic-team/ionic-cli/issues/4435)) ([6f6f9d7](https://github.com/ionic-team/ionic-cli/commit/6f6f9d7540fc064b3ffcbc05b56441f9b5c2efeb)) * **start:** do not prompt for project type when cloning ([#4427](https://github.com/ionic-team/ionic-cli/issues/4427)) ([4ff1622](https://github.com/ionic-team/ionic-cli/commit/4ff162281e327b4740e92513925b6d37b9dfb71e)) ## [6.9.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.9.0...@ionic/cli@6.9.1) (2020-05-12) ### Bug Fixes * pin tslib to avoid "Cannot set property pathExists" error ([689e1f0](https://github.com/ionic-team/ionic-cli/commit/689e1f038b907356ef855a067a76d4822e7072a8)) # [6.9.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.8.0...@ionic/cli@6.9.0) (2020-05-11) ### Bug Fixes * **capacitor:** do not open browser with `ionic cap run` ([8e3908d](https://github.com/ionic-team/ionic-cli/commit/8e3908d35ba99289e64a268c8a747054afceed92)) ### Features * add `capacitor:run:before` and `capacitor:build:before` hooks ([#4417](https://github.com/ionic-team/ionic-cli/issues/4417)) ([28d8540](https://github.com/ionic-team/ionic-cli/commit/28d854041d418fdd4c36233eb47af177506fdbaf)) # [6.8.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.7.0...@ionic/cli@6.8.0) (2020-05-06) ### Features * **package:** deployments to destinations (e.g. app stores) ([#4418](https://github.com/ionic-team/ionic-cli/issues/4418)) ([f0314f6](https://github.com/ionic-team/ionic-cli/commit/f0314f64a0a992c6bba9bb46343c1679b8b6521e)) # [6.7.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.6.0...@ionic/cli@6.7.0) (2020-04-29) ### Features * **capacitor:** add `--no-open` option for run and build ([#4403](https://github.com/ionic-team/ionic-cli/issues/4403)) ([977811e](https://github.com/ionic-team/ionic-cli/commit/977811e652f96aa4f5b4de92a80d9c25ae693d15)) # [6.6.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.5.0...@ionic/cli@6.6.0) (2020-04-14) ### Bug Fixes * **capacitor:** restore capacitor config after livereload ([cdc0190](https://github.com/ionic-team/ionic-cli/commit/cdc0190eaef38f5a5f1dad79c0953bfd8fa08c57)) ### Features * **capacitor:** warn about server.url during capacitor builds ([5f6b5dd](https://github.com/ionic-team/ionic-cli/commit/5f6b5dd46e0206c7de51a518a1e463a921d85217)) * `ionic capacitor build` command ([#4254](https://github.com/ionic-team/ionic-cli/issues/4254)) ([906fa96](https://github.com/ionic-team/ionic-cli/commit/906fa96ddca7e0156f22d94af3029b29306a6d3a)) # [6.5.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.4.3...@ionic/cli@6.5.0) (2020-04-07) ### Features * **start:** Default to Capacitor for React ([#4383](https://github.com/ionic-team/ionic-cli/issues/4383)) ([3fd72ec](https://github.com/ionic-team/ionic-cli/commit/3fd72ec828a1a30ddb8439bb9c7123bdcc88e46a)) * **start:** icon/splash from start wizard ([#4376](https://github.com/ionic-team/ionic-cli/issues/4376)) ([bb4c12b](https://github.com/ionic-team/ionic-cli/commit/bb4c12b569685dad228ff7a5588a19ba22c06278)) ## [6.4.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.4.2...@ionic/cli@6.4.3) (2020-04-05) ### Bug Fixes * **cordova:** make sure build is complete before reading output.json ([f1abe83](https://github.com/ionic-team/ionic-cli/commit/f1abe8392a6f2eaf910d23558b26228affd467bb)) * **cordova:** use relative path for ipa files ([4831758](https://github.com/ionic-team/ionic-cli/commit/4831758ed12982a1dd4a4cd30f447a304abc4140)) ## [6.4.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.4.1...@ionic/cli@6.4.2) (2020-04-05) ### Bug Fixes * **cordova:** use integration root path for file read ([79dc0b1](https://github.com/ionic-team/ionic-cli/commit/79dc0b10a9ff68e0b4a29e826ef95891b0129b8e)) ## [6.4.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.4.0...@ionic/cli@6.4.1) (2020-04-02) ### Bug Fixes * **cordova:** use output.json to deploy correct apk ([#4377](https://github.com/ionic-team/ionic-cli/issues/4377)) ([3f09331](https://github.com/ionic-team/ionic-cli/commit/3f09331daa38f1ebe9eae79831e9d1fe7f28c1a2)) # [6.4.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.3.0...@ionic/cli@6.4.0) (2020-03-30) ### Bug Fixes * **angular:** convert `--no-` to `--=false` for ng ([176ff4b](https://github.com/ionic-team/ionic-cli/commit/176ff4b960c883950f7247120f776ee110816f88)) * **capacitor:** check for capacitor.config.json before integrating ([2d7992c](https://github.com/ionic-team/ionic-cli/commit/2d7992cf2093e671a4d10243bf959a2e0f917b60)) ### Features * **package:** add functionality to deploy to app store ([#4366](https://github.com/ionic-team/ionic-cli/issues/4366)) ([cdd87ac](https://github.com/ionic-team/ionic-cli/commit/cdd87ac795f22d82401f79abb97bef65d8dd1e33)) # [6.3.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.2.2...@ionic/cli@6.3.0) (2020-03-18) ### Features * **start:** online start experience ([#4356](https://github.com/ionic-team/ionic-cli/issues/4356)) ([fcc5a75](https://github.com/ionic-team/ionic-cli/commit/fcc5a75a11291d069dae123b9d331ecae2d2ac2a)) ## [6.2.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.2.1...@ionic/cli@6.2.2) (2020-03-16) ### Bug Fixes * **angular:** always provide the project name fallback ([#4349](https://github.com/ionic-team/ionic-cli/issues/4349)) ([c498f59](https://github.com/ionic-team/ionic-cli/commit/c498f598dac54e8050f041401648efba0597ec3a)) * **multi-app:** use proper paths for integration root ([d53cee3](https://github.com/ionic-team/ionic-cli/commit/d53cee3def8dab8dd3e76c643d73c7c134b327fa)) ## [6.2.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.2.0...@ionic/cli@6.2.1) (2020-03-09) ### Bug Fixes * **react:** accept environment variables into build process ([0932ff0](https://github.com/ionic-team/ionic-cli/commit/0932ff04f45633e51b1d4b78857dbecedaee0c45)) # [6.2.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.1.0...@ionic/cli@6.2.0) (2020-03-03) ### Features * add support for pnpm ([#4330](https://github.com/ionic-team/ionic-cli/issues/4330)) ([47bf076](https://github.com/ionic-team/ionic-cli/commit/47bf076427f3c5d36e241b85cacf30b23f2efd24)) * **init:** add --multi-app option to init monorepos ([42c5199](https://github.com/ionic-team/ionic-cli/commit/42c51996632cdbc6ad6e514f36a584e3a450e380)) * **serve:** -c as alias for --configuration for Angular projects ([c010f37](https://github.com/ionic-team/ionic-cli/commit/c010f375dc8f1d7bc93cb313729f92d4d905a3cc)) * **serve:** add `--public-host` option ([#4331](https://github.com/ionic-team/ionic-cli/issues/4331)) ([8ae752d](https://github.com/ionic-team/ionic-cli/commit/8ae752d60de69063c752870f96a617a270316ca7)) * **start:** add signup prompt ([#4338](https://github.com/ionic-team/ionic-cli/issues/4338)) ([1f23b66](https://github.com/ionic-team/ionic-cli/commit/1f23b662c05114d1645b6f3ab2678e54d517b324)) # 6.1.0 (2020-02-11) ### Features * **start:** add new list starter option ([#4315](https://github.com/ionic-team/ionic-cli/issues/4315)) ([1df44c1](https://github.com/ionic-team/ionic-cli/commit/1df44c1591f37b89f2b672857740edd6cb2aea67)) ## [6.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.0.1...@ionic/cli@6.0.2) (2020-02-10) ### Bug Fixes * **capacitor:** allow cleartext for Android live-reload ([#4308](https://github.com/ionic-team/ionic-cli/issues/4308)) ([4d13261](https://github.com/ionic-team/ionic-cli/commit/4d132615fdac01af93404ff939a3364d6f72fb6e)) ### Features * **capacitor:** perform Ionic build for copy and sync ([be42aee](https://github.com/ionic-team/ionic-cli/commit/be42aee601e7abb0fd2f0b3957d561e26b0c688f)) * **config:** make project file configurable ([43ba45c](https://github.com/ionic-team/ionic-cli/commit/43ba45c134abae3279dd8776bd667b7dd9c002a7)) ## [6.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/cli@6.0.0...@ionic/cli@6.0.1) (2020-02-03) ### Bug Fixes * **update:** show update message even with command error ([6f32ebc](https://github.com/ionic-team/ionic-cli/commit/6f32ebc7f07f8bdd39ee538c9d605945c4a8e03e)) ### Features * **start**: update "my-first-app" to use Capacitor for Angular and React ([#4307](https://github.com/ionic-team/ionic-cli/issues/4307)) ([de350a7](https://github.com/ionic-team/ionic-cli/commit/de350a757078515a94ebbac3cf45b915970345f7)) * **config:** add `delete` and `del` aliases for `ionic config unset` ([56295c2](https://github.com/ionic-team/ionic-cli/commit/56295c2641cadd350c780db0e559a4bac49a0112)) * **cordova:** add `cdv` alias for `ionic cordova` ([ea503b7](https://github.com/ionic-team/ionic-cli/commit/ea503b7c5580fe449b10a1e11a40179375dfa1e9)) * **cordova:** add `res` alias for `ionic cordova resources` ([2d6ec39](https://github.com/ionic-team/ionic-cli/commit/2d6ec39243752abed92eaa6f3be56460d2b40bf4)) * **integrations:** add `integration` alias for `ionic integrations` ([a9bf5a1](https://github.com/ionic-team/ionic-cli/commit/a9bf5a16c95f0a5760179d5b9db569242d6a12a5)) * **integrations:** add `en` and `add` aliases for `ionic integrations enable` ([b85b5f9](https://github.com/ionic-team/ionic-cli/commit/b85b5f9d4c76e877d126e7185459589d73deb529)) * **integrations:** add `dis`, `delete`, `del`, `remove`, and `rm` aliases for `ionic integrations disable`([fd33cb3](https://github.com/ionic-team/ionic-cli/commit/fd33cb3d0b32520d609850cab83cbba3c767c7e4)) * **integrations:** add `dis`, `delete`, `del`, `remove`, and `rm` aliases for `ionic integrations disable`([fd33cb3](https://github.com/ionic-team/ionic-cli/commit/fd33cb3d0b32520d609850cab83cbba3c767c7e4)) # [6.0.0](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.15...@ionic/cli@6.0.0) (2020-01-25) The following changes were made in this major release of the Ionic CLI: * The package name for the Ionic CLI is now `@ionic/cli`! :tada: The old `ionic` package will not be updated to CLI 6. * The DevApp [has been retired](https://ionicframework.com/docs/appflow/devapp), so `--devapp` has been removed from `ionic serve`. We encourage you to use native tooling (Cordova/Capacitor, Android Studio, and Xcode) to develop apps on hardware and virtual devices. * The Ionic Resources server is being retired, so `--no-cordova-res` has been removed from `ionic cordova resources`. We encourage you to switch to [`cordova-res`](https://github.com/ionic-team/cordova-res). * We are now recommending :zap: [Capacitor](https://capacitor.ionicframework.com/) :zap: as the official native runtime for Ionic apps. Cordova will still be supported for this major release. #### :lollipop: Upgrading from CLI 5 Make sure you have NodeJS v10.3.0+ installed. We recommend [the latest LTS version](https://nodejs.org/). Uninstall the old Ionic CLI from your computer. ``` npm uninstall -g ionic ``` Install Ionic CLI 6 to your computer. ``` npm install -g @ionic/cli ``` ### BREAKING CHANGES * The npm package for the Ionic CLI is now `@ionic/cli`. * A minimum of Node.js 10.3.0 is required. * `--devapp` is no longer an option of `ionic serve`. * `--no-cordova-res` is no longer an option of `ionic cordova resources`. ## [5.4.15](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.14...ionic@5.4.15) (2020-01-15) ### Bug Fixes * **react:** indicate serve ready on warn/error as well ([#4280](https://github.com/ionic-team/ionic-cli/issues/4280)) ([1e9b754](https://github.com/ionic-team/ionic-cli/commit/1e9b7546fa561a99c33072908672fcea25c778d9)) ## [5.4.14](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.13...ionic@5.4.14) (2020-01-13) ### Bug Fixes * **deploy:** exclude source maps from manifest ([#4256](https://github.com/ionic-team/ionic-cli/issues/4256)) ([52a33ba](https://github.com/ionic-team/ionic-cli/commit/52a33ba116e28c61287b03e938b5883df45ffb7b)) ## [5.4.13](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.12...ionic@5.4.13) (2019-12-13) ### Bug Fixes * **react:** fix build options, update tonality/style ([8656c60](https://github.com/ionic-team/ionic-cli/commit/8656c60ebb8206d2935669b7654995b82910e048)) ## [5.4.12](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.11...ionic@5.4.12) (2019-12-10) **Note:** Version bump only for package ionic ## [5.4.11](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.10...ionic@5.4.11) (2019-12-09) ### Bug Fixes * **cordova:** do not detect hardware devices when using emulate ([446a149](https://github.com/ionic-team/ionic-cli/commit/446a1495eefc63995450d8b7e899b44910d70372)) ## [5.4.10](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.9...ionic@5.4.10) (2019-12-05) ### Bug Fixes * **devapp:** enable cordova upon first serve w/ devapp ([fd27ee3](https://github.com/ionic-team/ionic-cli/commit/fd27ee3425ed4c20e8b117e1bb3c8175d709d94b)) * **telemetry:** disable for non-TTY ([81dfff3](https://github.com/ionic-team/ionic-cli/commit/81dfff3d7936519763c11a0f128360434435d179)) ## [5.4.9](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.8...ionic@5.4.9) (2019-11-25) ### Bug Fixes * **link:** don't double encode GitHub URL ([#4230](https://github.com/ionic-team/ionic-cli/issues/4230)) ([cfb593b](https://github.com/ionic-team/ionic-cli/commit/cfb593b177cd98ad41358d1640accd62b78a4c6b)) ## [5.4.8](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.7...ionic@5.4.8) (2019-11-24) ### Bug Fixes * fix parsing of command line options ([060f67c](https://github.com/ionic-team/ionic-cli/commit/060f67cf63d37662ae44c4ae952161464a5d553c)) ## [5.4.7](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.6...ionic@5.4.7) (2019-11-21) ### Bug Fixes * do not try to auth for select commands ([162e733](https://github.com/ionic-team/ionic-cli/commit/162e733eaa5cf2efcaa0e5e087df53c376f62933)) ## [5.4.6](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.5...ionic@5.4.6) (2019-11-12) ### Bug Fixes * **login:** don't doubly encode SSO login URL params ([#4209](https://github.com/ionic-team/ionic-cli/issues/4209)) ([e5fddfb](https://github.com/ionic-team/ionic-cli/commit/e5fddfb175f3eaf53a9dc5dd134d173a56098298)) ## [5.4.5](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.4...ionic@5.4.5) (2019-10-30) ### Bug Fixes * **repair:** ignore missing package-lock.json when repairing ([#4197](https://github.com/ionic-team/ionic-cli/issues/4197)) ([94bddf3](https://github.com/ionic-team/ionic-cli/commit/94bddf38bd895396ab6d0aca87bf5016b45dc42b)) ## [5.4.4](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.3...ionic@5.4.4) (2019-10-14) **Note:** Version bump only for package ionic ## [5.4.3](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.2...ionic@5.4.3) (2019-10-14) **Note:** Version bump only for package ionic ## [5.4.2](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.1...ionic@5.4.2) (2019-10-01) ### Bug Fixes * **cordova:** fix hanging issue for run w/ livereload ([#4162](https://github.com/ionic-team/ionic-cli/issues/4162)) ([1001108](https://github.com/ionic-team/ionic-cli/commit/1001108)) ## [5.4.1](https://github.com/ionic-team/ionic-cli/compare/ionic@5.4.0...ionic@5.4.1) (2019-09-20) ### Bug Fixes * **cordova:** fix hanging issue for prepare/compile ([44697cf](https://github.com/ionic-team/ionic-cli/commit/44697cf)) # [5.4.0](https://github.com/ionic-team/ionic-cli/compare/ionic@5.3.0...ionic@5.4.0) (2019-09-20) ### Bug Fixes * **angular:** fix `--prod` option ([609b80d](https://github.com/ionic-team/ionic-cli/commit/609b80d)) ### Features * **start:** add prompt for framework ([#4161](https://github.com/ionic-team/ionic-cli/issues/4161)) ([8f6ce37](https://github.com/ionic-team/ionic-cli/commit/8f6ce37)) # [5.3.0](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.8...ionic@5.3.0) (2019-09-18) ### Bug Fixes * **angular:** show Angular CLI prompts in `ionic generate` ([#4123](https://github.com/ionic-team/ionic-cli/issues/4123)) ([e97f868](https://github.com/ionic-team/ionic-cli/commit/e97f868)) * **cordova:** fix hanging issue with modern iOS build system ([b7758ed](https://github.com/ionic-team/ionic-cli/commit/b7758ed)) * **cordova:** offer confirmation on adding unknown platform ([453f08b](https://github.com/ionic-team/ionic-cli/commit/453f08b)) ### Features * **angular:** document and pass along `--watch` option to ng ([1444212](https://github.com/ionic-team/ionic-cli/commit/1444212)) * **cordova:** --external option for hosting dev server on 0.0.0.0 ([fc6020f](https://github.com/ionic-team/ionic-cli/commit/fc6020f)) ## [5.2.8](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.7...ionic@5.2.8) (2019-09-10) ### Bug Fixes * **cordova:** use allowlist for supported project types ([167a68c](https://github.com/ionic-team/ionic-cli/commit/167a68c)) * **multi-app:** use proper config path for integrations ([4e8a226](https://github.com/ionic-team/ionic-cli/commit/4e8a226)) ## [5.2.7](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.6...ionic@5.2.7) (2019-08-28) ### Bug Fixes * **cordova:** use correct package path for release builds ([df34272](https://github.com/ionic-team/ionic-cli/commit/df34272)) ## [5.2.6](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.5...ionic@5.2.6) (2019-08-23) ### Bug Fixes * **cordova:** handle whitespace in app name when running ([0e662e7](https://github.com/ionic-team/ionic-cli/commit/0e662e7)) * **react:** Disable CRA from opening window so two windows don't open ([#4119](https://github.com/ionic-team/ionic-cli/issues/4119)) ([f10c92c](https://github.com/ionic-team/ionic-cli/commit/f10c92c)) ## [5.2.5](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.4...ionic@5.2.5) (2019-08-14) **Note:** Version bump only for package ionic ## [5.2.4](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.3...ionic@5.2.4) (2019-08-07) **Note:** Version bump only for package ionic ## [5.2.3](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.2...ionic@5.2.3) (2019-07-15) **Note:** Version bump only for package ionic ## [5.2.2](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.1...ionic@5.2.2) (2019-07-09) ### Bug Fixes * **cordova:** revert to `--no-connect` as default ([e4368a8](https://github.com/ionic-team/ionic-cli/commit/e4368a8)) * **deploy:** support custom Capacitor build directory ([#4065](https://github.com/ionic-team/ionic-cli/issues/4065)) ([6146296](https://github.com/ionic-team/ionic-cli/commit/6146296)) ## [5.2.1](https://github.com/ionic-team/ionic-cli/compare/ionic@5.2.0...ionic@5.2.1) (2019-06-28) * **deploy:** fix bug with `ionic deploy configure` in CI ([7774dfe](https://github.com/ionic-team/ionic-cli/commit/7774dfe)) # [5.2.0](https://github.com/ionic-team/ionic-cli/compare/ionic@5.1.1...ionic@5.2.0) (2019-06-26) ### Bug Fixes * **capacitor:** save Capacitor CLI in dev deps ([dd2fd86](https://github.com/ionic-team/ionic-cli/commit/dd2fd86)) * **cordova:** rely on package.json for plugins/platforms ([286917f](https://github.com/ionic-team/ionic-cli/commit/286917f)) ### Features * **angular:** pass `--verbose` to Angular CLI ([cf611ed](https://github.com/ionic-team/ionic-cli/commit/cf611ed)) * **angular:** pass `--verbose` to Angular CLI for serve ([3f9e859](https://github.com/ionic-team/ionic-cli/commit/3f9e859)) * **repair:** add `--cordova` flag for only repairing Cordova ([1055b49](https://github.com/ionic-team/ionic-cli/commit/1055b49)) ## [5.1.1](https://github.com/ionic-team/ionic-cli/compare/ionic@5.1.0...ionic@5.1.1) (2019-06-26) **Note:** Version bump only for package ionic # [5.1.0](https://github.com/ionic-team/ionic-cli/compare/ionic@5.0.3...ionic@5.1.0) (2019-06-21) ### Bug Fixes * **start:** fix glitch with writing package.json without spaces ([389c398](https://github.com/ionic-team/ionic-cli/commit/389c398)) * subsequent validation for various prompts ([1b92f8a](https://github.com/ionic-team/ionic-cli/commit/1b92f8a)) ### Features * **info:** show available updates for utilities ([a9f4b54](https://github.com/ionic-team/ionic-cli/commit/a9f4b54)) * replace update-notifier ([a232c07](https://github.com/ionic-team/ionic-cli/commit/a232c07)) * **deploy:** command to interactively add deploy plugin ([#4039](https://github.com/ionic-team/ionic-cli/issues/4039)) ([c75e66f](https://github.com/ionic-team/ionic-cli/commit/c75e66f)) ## [5.0.3](https://github.com/ionic-team/ionic-cli/compare/ionic@5.0.2...ionic@5.0.3) (2019-06-18) ### Bug Fixes * **capacitor:** use correct web-dir path for react and capacitor ([#4029](https://github.com/ionic-team/ionic-cli/issues/4029)) ([cdf2579](https://github.com/ionic-team/ionic-cli/commit/cdf2579)) * **cordova:** always generate resources when adding platforms ([3220b2f](https://github.com/ionic-team/ionic-cli/commit/3220b2f)) * **cordova:** don't append --save to platform/plugin management commands ([#4028](https://github.com/ionic-team/ionic-cli/issues/4028)) ([0356d00](https://github.com/ionic-team/ionic-cli/commit/0356d00)) * **cordova:** warn about missing cordova-res when adding platforms ([77fa904](https://github.com/ionic-team/ionic-cli/commit/77fa904)) ## [5.0.2](https://github.com/ionic-team/ionic-cli/compare/ionic@5.0.1...ionic@5.0.2) (2019-06-10) ### Bug Fixes * **capacitor:** use dist for --web-dir for vue/capacitor ([#4012](https://github.com/ionic-team/ionic-cli/issues/4012)) ([0979715](https://github.com/ionic-team/ionic-cli/commit/0979715)) * **cordova:** fix --project flag for cordova commands ([fb9ff0f](https://github.com/ionic-team/ionic-cli/commit/fb9ff0f)) * **cordova:** invoke native-run in integration root ([526eda3](https://github.com/ionic-team/ionic-cli/commit/526eda3)) ## [5.0.1](https://github.com/ionic-team/ionic-cli/compare/ionic@5.0.0...ionic@5.0.1) (2019-06-05) ### Bug Fixes * **cordova:** add port forwarding for --consolelogs ([d2e0c81](https://github.com/ionic-team/ionic-cli/commit/d2e0c81)) * **cordova:** pass --device to native-run if specified ([5db46d5](https://github.com/ionic-team/ionic-cli/commit/5db46d5)) # [5.0.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.12.0...ionic@5.0.0) (2019-05-29) At a glance, this is what was changed or added in this major release of the Ionic CLI: * Support for **Ionic React** (beta) :rocket: (`ionic start --type=react`) * [`native-run`](https://github.com/ionic-team/native-run) is used to deploy app binaries to devices for `ionic cordova run` * [`cordova-res`](https://github.com/ionic-team/cordova-res) is used to generate Cordova resources locally for `ionic cordova resources` * `localhost` is now the default host for `ionic serve`, `ionic cordova run -l`, and `ionic capacitor run -l` * Port forwarding via `native-run` is used for connected Android devices * For iOS hardware devices, you may need to serve your app externally with `--address=0.0.0.0` * `--devapp` is now a required flag if you want to use DevApp with `ionic serve` * `--consolelogs` for Angular projects is now available for `ionic cordova run -l` * Command completion is available for ZSH users (`ionic completion --help`) (see [#2482](https://github.com/ionic-team/ionic-cli/issues/2482) for bash) * CLI source code targets modern JS, resulting in noticable speed improvements #### :lollipop: Upgrading from CLI 4 Make sure you have NodeJS v8.9.4+ installed. We recommend [the latest LTS version](https://nodejs.org/). Install the [`cordova-res`](https://github.com/ionic-team/cordova-res) and [`native-run`](https://github.com/ionic-team/native-run) utilities. ``` npm i -g cordova-res native-run ``` For Angular 8 projects, make sure you have the latest `@ionic/angular-toolkit` installed. ``` npm i @ionic/angular-toolkit@latest ``` For Angular 7 projects, make sure you have the [latest 1.x](https://www.npmjs.com/package/@ionic/angular-toolkit?activeTab=versions) `@ionic/angular-toolkit` installed. ``` npm i @ionic/angular-toolkit@1 ``` ### Bug Fixes * **capacitor:** send --npm-client param to capacitor init ([#3963](https://github.com/ionic-team/ionic-cli/issues/3963)) ([44b0918](https://github.com/ionic-team/ionic-cli/commit/44b0918)) * **cordova:** prefer plugged-in devices, be explicit with Cordova ([ef8296b](https://github.com/ionic-team/ionic-cli/commit/ef8296b)) * **doctor:** relax the viewport regex ([d0bc021](https://github.com/ionic-team/ionic-cli/commit/d0bc021)) * **open:** fix unbound listener ([e63b74a](https://github.com/ionic-team/ionic-cli/commit/e63b74a)) * **prepare:** check config and platforms dir for platform state ([d9e1ced](https://github.com/ionic-team/ionic-cli/commit/d9e1ced)) * **react:** support react git repo ([#3982](https://github.com/ionic-team/ionic-cli/issues/3982)) ([c06857f](https://github.com/ionic-team/ionic-cli/commit/c06857f)) ### chore * **serve:** `--devapp` required for DevApp ([5ad11ef](https://github.com/ionic-team/ionic-cli/commit/5ad11ef)) * **serve:** remove `--local` option ([806eaaa](https://github.com/ionic-team/ionic-cli/commit/806eaaa)) * **serve:** switch default host to `localhost` ([d2a32de](https://github.com/ionic-team/ionic-cli/commit/d2a32de)) * require Node 8 ([5670e68](https://github.com/ionic-team/ionic-cli/commit/5670e68)) ### Features * **cordova:** handle lack of port forwarding in ios ([d68faf1](https://github.com/ionic-team/ionic-cli/commit/d68faf1)) * add -v as shortcut for --version ([d917e8e](https://github.com/ionic-team/ionic-cli/commit/d917e8e)) * **start:** add conference and my-first-app starter templates for angular ([#3978](https://github.com/ionic-team/ionic-cli/issues/3978)) ([ea26181](https://github.com/ionic-team/ionic-cli/commit/ea26181)) * Add React project type ([#3936](https://github.com/ionic-team/ionic-cli/issues/3936)) ([ef852fa](https://github.com/ionic-team/ionic-cli/commit/ef852fa)) * **angular:** Ionic 4 commands no longer beta ([16be793](https://github.com/ionic-team/ionic-cli/commit/16be793)) * **cordova:** check for `native-run` before running ([89ffd21](https://github.com/ionic-team/ionic-cli/commit/89ffd21)) * **cordova:** instructions on how to fix faulty Android SDKs ([ce87944](https://github.com/ionic-team/ionic-cli/commit/ce87944)) * **cordova:** use `cordova-res` by default ([83e48cf](https://github.com/ionic-team/ionic-cli/commit/83e48cf)) * **cordova:** use `native-run` by default ([eadcba0](https://github.com/ionic-team/ionic-cli/commit/eadcba0)) * **help:** color refactor ([5938429](https://github.com/ionic-team/ionic-cli/commit/5938429)) * **info:** native-run and cordova-res versions ([d6af864](https://github.com/ionic-team/ionic-cli/commit/d6af864)) * **login:** authenticate using stdin ([d88529f](https://github.com/ionic-team/ionic-cli/commit/d88529f)) * **serve:** support `--consolelogs` for cordova serve in angular projects ([#3900](https://github.com/ionic-team/ionic-cli/issues/3900)) ([17f1438](https://github.com/ionic-team/ionic-cli/commit/17f1438)) * Command-Line Completions ([9f66512](https://github.com/ionic-team/ionic-cli/commit/9f66512)) ### BREAKING CHANGES * **cordova:** `ionic cordova resources` no longer generates resources using Ionic servers by default. Instead, `cordova-res` is used to generate resources locally. PSD and AI file formats are no longer supported in this new flow. The old behavior is available by specifying `--no-cordova-res`. * **cordova:** `ionic cordova run/emulate` no longer use Cordova to deploy apps by default. `cordova run`, which builds and deploys the app, is no longer used. Instead, `cordova build` is used to build the app and then it is deployed to devices using `native-run`. The old behavior is available by specifying `--no-native-run`. When using Cordova to run, unless you manually forward ports, you will need to also specify `--address=0.0.0.0` (or any host accessible externally). * **serve:** For DevApp usage, the `--devapp` flag is now required for all project types, instead of being automatic. This change was made in conjunction with changing the default host from `0.0.0.0` to `localhost`. By explicitly specifying `--devapp`, however, `0.0.0.0` is used if `--address` is not specified. * **serve:** `ionic serve` and other commands using the dev server will no longer be hosted on the BIND ALL address (0.0.0.0) by default. `localhost` is the new default. The old behavior is available by passing `--address=0.0.0.0`. * **serve:** The `ionic serve --local` option is now irrelevant. The default address is changing to `localhost`. * A minimum of Node.js 8.9.4 is required. * **help:** option/command/namespace groups are now `MetadataGroup` # [4.12.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.11.0...ionic@4.12.0) (2019-03-12) ### Features * **enterprise:** add shortcut for registering ([a1890b4](https://github.com/ionic-team/ionic-cli/commit/a1890b4)) * add `i` as alias for `integrations` ([14a7ddb](https://github.com/ionic-team/ionic-cli/commit/14a7ddb)) * **integrations:** add `--web-dir` option for capacitor integration ([#3895](https://github.com/ionic-team/ionic-cli/issues/3895)) ([8a1c4b2](https://github.com/ionic-team/ionic-cli/commit/8a1c4b2)) * **integrations:** ionic enterprise integration ([#3905](https://github.com/ionic-team/ionic-cli/issues/3905)) ([b071fcb](https://github.com/ionic-team/ionic-cli/commit/b071fcb)) # [4.11.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.10.4...ionic@4.11.0) (2019-03-06) ### Features * **cordova:** add experimental `--cordova-res` flag ([16cdef8](https://github.com/ionic-team/ionic-cli/commit/16cdef8)) * **cordova:** add experimental `--native-run` flag ([a80d465](https://github.com/ionic-team/ionic-cli/commit/a80d465)) ## [4.10.4](https://github.com/ionic-team/ionic-cli/compare/ionic@4.10.3...ionic@4.10.4) (2019-02-27) **Note:** Version bump only for package ionic ## [4.10.3](https://github.com/ionic-team/ionic-cli/compare/ionic@4.10.2...ionic@4.10.3) (2019-02-15) **Note:** Version bump only for package ionic ## [4.10.2](https://github.com/ionic-team/ionic-cli/compare/ionic@4.10.1...ionic@4.10.2) (2019-02-04) ### Bug Fixes * **angular:** pass `--project` and `--configuration` for custom scripts ([2cf724f](https://github.com/ionic-team/ionic-cli/commit/2cf724f)) ## [4.10.1](https://github.com/ionic-team/ionic-cli/compare/ionic@4.10.0...ionic@4.10.1) (2019-01-30) ### Bug Fixes * **cordova:** only forward correct options ([817879b](https://github.com/ionic-team/ionic-cli/commit/817879b)) # [4.10.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.9.0...ionic@4.10.0) (2019-01-29) ### Bug Fixes * **ionic-angular:** link to proper v3 docs ([a89c097](https://github.com/ionic-team/ionic-cli/commit/a89c097)) ### Features * **serve:** add DevApp support for Ionic 4 projects ([#3830](https://github.com/ionic-team/ionic-cli/issues/3830)) ([6edf373](https://github.com/ionic-team/ionic-cli/commit/6edf373)) # [4.9.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.8.0...ionic@4.9.0) (2019-01-23) ### Features * **custom:** run ionic:build/ionic:serve scripts ([9898fa8](https://github.com/ionic-team/ionic-cli/commit/9898fa8)) * **resources:** --cordova-res option for local resource generation ([3c27e05](https://github.com/ionic-team/ionic-cli/commit/3c27e05)) * **start:** make Ionic 4 the default for new projects ([#3820](https://github.com/ionic-team/ionic-cli/issues/3820)) ([0195f96](https://github.com/ionic-team/ionic-cli/commit/0195f96)) # [4.8.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.7.1...ionic@4.8.0) (2019-01-14) ### Features * **appflow:** command to create deploy builds ([#3815](https://github.com/ionic-team/ionic-cli/issues/3815)) ([d346e03](https://github.com/ionic-team/ionic-cli/commit/d346e03)) ## [4.7.1](https://github.com/ionic-team/ionic-cli/compare/ionic@4.7.0...ionic@4.7.1) (2019-01-08) **Note:** Version bump only for package ionic # [4.7.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.6.0...ionic@4.7.0) (2019-01-07) ### Bug Fixes * **doctor:** handle multilines for viewport-fit-not-set ([#3809](https://github.com/ionic-team/ionic-cli/issues/3809)) ([6aa7ae6](https://github.com/ionic-team/ionic-cli/commit/6aa7ae6)) * **executor:** Exclude options for command argument parsing ([#3798](https://github.com/ionic-team/ionic-cli/issues/3798)) ([514015f](https://github.com/ionic-team/ionic-cli/commit/514015f)) * **serve:** handle error in opn with debug statement ([89b6d33](https://github.com/ionic-team/ionic-cli/commit/89b6d33)) ### Features * **appflow:** command to create package builds ([#3808](https://github.com/ionic-team/ionic-cli/issues/3808)) ([149f06e](https://github.com/ionic-team/ionic-cli/commit/149f06e)) * **cordova:** auto-forward port when using --native-run ([0da50ac](https://github.com/ionic-team/ionic-cli/commit/0da50ac)) # [4.6.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.5.0...ionic@4.6.0) (2018-12-19) ### Bug Fixes * **cordova:** warn for prepare w/o platforms ([385bdf2](https://github.com/ionic-team/ionic-cli/commit/385bdf2)) ### Features * **serve:** collapse numbered chunk output and summarize ([5ac6834](https://github.com/ionic-team/ionic-cli/commit/5ac6834)) * **start:** update for Ionic Framework 4.0 RC ([7e943cc](https://github.com/ionic-team/ionic-cli/commit/7e943cc)) # [4.5.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.4.0...ionic@4.5.0) (2018-11-27) ### Bug Fixes * **cordova:** do not error for ctrl+c during livereload ([facc96b](https://github.com/ionic-team/ionic-cli/commit/facc96b)) * **serve:** ignore link-local addresses ([#3761](https://github.com/ionic-team/ionic-cli/issues/3761)) ([1b7fd90](https://github.com/ionic-team/ionic-cli/commit/1b7fd90)) * **telemetry:** disable automatically for CI ([217ca12](https://github.com/ionic-team/ionic-cli/commit/217ca12)) ### Features * Ionic Appflow rebranding ([16360af](https://github.com/ionic-team/ionic-cli/commit/16360af)) * **cordova:** add `--native-run` option to Cordova run ([#3757](https://github.com/ionic-team/ionic-cli/issues/3757)) ([9ef53ad](https://github.com/ionic-team/ionic-cli/commit/9ef53ad)) # [4.4.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.3.1...ionic@4.4.0) (2018-11-20) ### Bug Fixes * **multi-app:** properly handle bare projects ([3f84a6f](https://github.com/ionic-team/ionic-cli/commit/3f84a6f)), closes [/github.com/ionic-team/ionic-docs/issues/83#issuecomment-439655706](https://github.com//github.com/ionic-team/ionic-docs/issues/83/issues/issuecomment-439655706) * **project:** write determined project type to config ([307d81f](https://github.com/ionic-team/ionic-cli/commit/307d81f)) ### Features * **build:** show build progress ([3090615](https://github.com/ionic-team/ionic-cli/commit/3090615)) * **help:** show value hint for options ([aa13ba8](https://github.com/ionic-team/ionic-cli/commit/aa13ba8)) * **init:** add `ionic init` command ([4a12b17](https://github.com/ionic-team/ionic-cli/commit/4a12b17)) * **login:** SSO authentication flow ([#3741](https://github.com/ionic-team/ionic-cli/issues/3741)) ([71b319a](https://github.com/ionic-team/ionic-cli/commit/71b319a)) * **serve:** forward `--ssl` to Angular CLI ([815b49a](https://github.com/ionic-team/ionic-cli/commit/815b49a)) ## [4.3.1](https://github.com/ionic-team/ionic-cli/compare/ionic@4.3.0...ionic@4.3.1) (2018-11-04) ### Bug Fixes * **bin:** stringify unresolved promise event ([788a5ec](https://github.com/ionic-team/ionic-cli/commit/788a5ec)) * **bootstrap:** supply env for CLI <4.3.0 ([78dbda8](https://github.com/ionic-team/ionic-cli/commit/78dbda8)) * **multi-app:** hide project warnings during start ([b1ecd77](https://github.com/ionic-team/ionic-cli/commit/b1ecd77)) * **start:** fix stdio freezing issue on Windows ([#3725](https://github.com/ionic-team/ionic-cli/issues/3725)) ([a570770](https://github.com/ionic-team/ionic-cli/commit/a570770)) # [4.3.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.2.1...ionic@4.3.0) (2018-10-31) ### Bug Fixes * **capacitor:** switch off livereload for --no-build ([9960047](https://github.com/ionic-team/ionic-cli/commit/9960047)) * **help:** filter out unnecessary global options ([7809c99](https://github.com/ionic-team/ionic-cli/commit/7809c99)) * **ssh:** adjust validator to work for OpenSSH 7.8 ([dcc598a](https://github.com/ionic-team/ionic-cli/commit/dcc598a)) * **terminal:** adjust some feature detection on windows ([8a2ed99](https://github.com/ionic-team/ionic-cli/commit/8a2ed99)) ### Features * **capacitor:** add --livereload-url option for custom dev server ([b7738f5](https://github.com/ionic-team/ionic-cli/commit/b7738f5)) * **cordova:** add --livereload-url option for custom dev server ([ad57e36](https://github.com/ionic-team/ionic-cli/commit/ad57e36)) * **integrations:** --root option for choosing an alternative location ([7e8f11e](https://github.com/ionic-team/ionic-cli/commit/7e8f11e)) * **multi-app:** determine active project via cwd path match ([f83dc5b](https://github.com/ionic-team/ionic-cli/commit/f83dc5b)) * **resources:** generate resources without needing platform installation ([4f20554](https://github.com/ionic-team/ionic-cli/commit/4f20554)) * **start:** better multi-app support ([3c70e87](https://github.com/ionic-team/ionic-cli/commit/3c70e87)) ## [4.2.1](https://github.com/ionic-team/ionic-cli/compare/ionic@4.2.0...ionic@4.2.1) (2018-10-05) ### Bug Fixes * **doctor:** fix viewport-fit-not-set for ionic1 ([826b9ae](https://github.com/ionic-team/ionic-cli/commit/826b9ae)) * **info:** show versions for [@ionic](https://github.com/ionic)/angular-toolkit ([9d1824a](https://github.com/ionic-team/ionic-cli/commit/9d1824a)) # [4.2.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.1.2...ionic@4.2.0) (2018-10-03) ### Bug Fixes * **cordova:** ng should ignore separated args for Cordova build ([16a0111](https://github.com/ionic-team/ionic-cli/commit/16a0111)) * **lab:** use correct query params for project type ([4801680](https://github.com/ionic-team/ionic-cli/commit/4801680)) * **serve:** fix incorrect message about app-scripts not being installed ([abd665b](https://github.com/ionic-team/ionic-cli/commit/abd665b)) * **serve:** unnecessary message about utility CLI exiting during Ctrl+C ([8e78bf3](https://github.com/ionic-team/ionic-cli/commit/8e78bf3)) ### Features * new `ionic repair` command ([7588233](https://github.com/ionic-team/ionic-cli/commit/7588233)) ## [4.1.2](https://github.com/ionic-team/ionic-cli/compare/ionic@4.1.1...ionic@4.1.2) (2018-09-05) ### Bug Fixes * **capacitor:** use integration root for Capacitor CLI ([81a45d5](https://github.com/ionic-team/ionic-cli/commit/81a45d5)) ## [4.1.1](https://github.com/ionic-team/ionic-cli/compare/ionic@4.1.0...ionic@4.1.1) (2018-08-20) ### Bug Fixes * **cordova:** respect --nosave for platform/plugin add ([eb4934b](https://github.com/ionic-team/ionic-cli/commit/eb4934b)) * **deploy:** exclude any existing pro-manifest.json files ([#3527](https://github.com/ionic-team/ionic-cli/issues/3527)) ([d03057d](https://github.com/ionic-team/ionic-cli/commit/d03057d)) * **shell:** allow output() to fail with original error ([e6a5bff](https://github.com/ionic-team/ionic-cli/commit/e6a5bff)) * **shell:** check if process is still alive before sending signal ([0ff1e48](https://github.com/ionic-team/ionic-cli/commit/0ff1e48)) # [4.1.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.6...ionic@4.1.0) (2018-08-15) ### Bug Fixes * **capacitor:** pass in project/package id during start ([1357c5c](https://github.com/ionic-team/ionic-cli/commit/1357c5c)) * **cordova:** properly error for multiple IPs with non-interactive mode ([0346adc](https://github.com/ionic-team/ionic-cli/commit/0346adc)) * **cordova:** remove unwanted allow-navigation entries ([77984e1](https://github.com/ionic-team/ionic-cli/commit/77984e1)) * **info:** disable update check for cordova cli ([8310ff6](https://github.com/ionic-team/ionic-cli/commit/8310ff6)) * **info:** remove version.json warning for v1 ([78c3582](https://github.com/ionic-team/ionic-cli/commit/78c3582)) * **link:** support new repo association types ([1c1e1f1](https://github.com/ionic-team/ionic-cli/commit/1c1e1f1)) ### Features * **capacitor:** add run command ([62a2918](https://github.com/ionic-team/ionic-cli/commit/62a2918)) * **capacitor:** document platform argument, prompt when required ([2a312ab](https://github.com/ionic-team/ionic-cli/commit/2a312ab)) * **capacitor:** install platform if missing ([9e29235](https://github.com/ionic-team/ionic-cli/commit/9e29235)) * **capacitor:** prompt for supported platforms when adding ([54c7d55](https://github.com/ionic-team/ionic-cli/commit/54c7d55)) * **capacitor:** unlock capacitor commands as beta ([2480a01](https://github.com/ionic-team/ionic-cli/commit/2480a01)) * **info:** print whitelisted cordova plugins ([c266b7b](https://github.com/ionic-team/ionic-cli/commit/c266b7b)) ## [4.0.6](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.5...ionic@4.0.6) (2018-08-09) ### Bug Fixes * **serve:** fix unclosed connection issue again ([#3500](https://github.com/ionic-team/ionic-cli/issues/3500)) ([1f0ef3b](https://github.com/ionic-team/ionic-cli/commit/1f0ef3b)) ## [4.0.5](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.4...ionic@4.0.5) (2018-08-07) **Note:** Version bump only for package ionic ## [4.0.4](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.3...ionic@4.0.4) (2018-08-06) ### Bug Fixes * **serve:** properly cleanup child processes ([#3481](https://github.com/ionic-team/ionic-cli/issues/3481)) ([38217bf](https://github.com/ionic-team/ionic-cli/commit/38217bf)) ## [4.0.3](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.2...ionic@4.0.3) (2018-08-02) ### Bug Fixes * **build:** prompt to install "build cli" for all projects ([2862762](https://github.com/ionic-team/ionic-cli/commit/2862762)) * **serve:** await connectivity on specified host, not localhost ([#3444](https://github.com/ionic-team/ionic-cli/issues/3444)) ([bf10674](https://github.com/ionic-team/ionic-cli/commit/bf10674)) * **serve:** check all network interfaces for an available port ([30fd6ef](https://github.com/ionic-team/ionic-cli/commit/30fd6ef)) * **serve:** fix --livereload for device/emulator ([f31e79d](https://github.com/ionic-team/ionic-cli/commit/f31e79d)) * **serve:** use correct livereload port option for v1 ([bf3e775](https://github.com/ionic-team/ionic-cli/commit/bf3e775)) ## [4.0.2](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.1...ionic@4.0.2) (2018-07-30) ### Bug Fixes * **cordova:** default to `cordova prepare` without platforms ([d40d961](https://github.com/ionic-team/ionic-cli/commit/d40d961)) * **resources:** fix hanging issue ([#3429](https://github.com/ionic-team/ionic-cli/issues/3429)) ([6b7c732](https://github.com/ionic-team/ionic-cli/commit/6b7c732)) * **build:** properly pass --target to remove fonts for cordova ([530d87a](https://github.com/ionic-team/ionic-cli/commit/530d87a)) * **generate:** run in current directory ([54c632b](https://github.com/ionic-team/ionic-cli/commit/54c632b)) * **info:** filter out hidden files/folders ([2e56dd7](https://github.com/ionic-team/ionic-cli/commit/2e56dd7)) * **info:** show 'not available' when cordova is missing ([db60879](https://github.com/ionic-team/ionic-cli/commit/db60879)) ## [4.0.1](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.0...ionic@4.0.1) (2018-07-26) ### Bug Fixes * **generate:** remove pages/ prefix recommendation ([#3392](https://github.com/ionic-team/ionic-cli/issues/3392)) ([23d0db6](https://github.com/ionic-team/ionic-cli/commit/23d0db6)) * **help:** properly show option decorations ([b2509de](https://github.com/ionic-team/ionic-cli/commit/b2509de)) # [4.0.0](https://github.com/ionic-team/ionic-cli/compare/ionic@4.0.0-rc.13...ionic@4.0.0) (2018-07-25) **Note:** Version bump only for package ionic This release offers support for :sparkles: **Ionic 4** :sparkles: (beta). :memo: Use the new [CLI Documentation](https://beta.ionicframework.com/docs/cli) on the beta framework documentation website for CLI 4. #### :lollipop: Upgrading from CLI 3 Aside from a few edge cases listed below, upgrading to CLI 4 should be seamless. **Ionic 2/3**: The CLI will continue working with apps using `@ionic/app-scripts` for tooling (please [update to the latest version](https://github.com/ionic-team/ionic-app-scripts) to avoid any issues). The CLI will continue to support projects that have yet to migrate to Ionic 4 w/ Angular CLI for tooling. For those who wish to migrate v3 apps to v4, see the [Migration Guide](https://beta.ionicframework.com/docs/building/migration). **Ionic 1**: For Ionic 1 projects, a new toolkit has been introduced to slim down the main CLI package. All functionality is still supported, but the `@ionic/v1-toolkit` package needs to be installed. #### :boom: Breaking Changes * Support for legacy Ionic Cloud ended on January 31st, 2018. The `ionic upload` and `ionic package` commands have been removed from the CLI. Support for [Ionic Appflow](https://ionicframework.com/appflow/) will be a major focus for the CLI going forward. :ok_hand: * The `app_id` property in `ionic.config.json` has been renamed to `pro_id` and is now optional (see [#3038](https://github.com/ionic-team/ionic-cli/issues/3038)). The CLI automatically detects this and changes it, but this notice is here if your build scripts rely on the setting. * `ionic build` will no longer run `cordova prepare`. Instead, run `ionic cordova prepare `, which performs an Ionic build beforehand. * `ionic cordova prepare` will no longer run an Ionic build without a platform, e.g. `ionic cordova prepare ios` (see [#3653](https://github.com/ionic-team/ionic-cli/issues/3653)) * Ionic Lab has been moved into the [`@ionic/lab`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/@ionic/lab) package, which will need to be installed for Lab to work. * The `conference` starter template has been removed from `ionic start`. To clone existing apps (as opposed to starting new apps from starter templates), please use the app's repository URL. For example, to create the conference app, use `ionic start "Conference App" https://github.com/ionic-team/ionic-conference-app`. * The `--display-name` option for `ionic start` has been removed. The `name` argument is now used as the display name and slugified for directory name, package name, etc. To provide a custom slug, use `--project-id` (see [#3038](https://github.com/ionic-team/ionic-cli/issues/3038)). * The `ionic:watch:before` npm script hook has been renamed to `ionic:serve:before`, but behaves the same. * `ionic doctor check` will now _only_ print issues and exit with exit code 1 if issues are found. Use `ionic doctor treat` to attempt automatic fixes. * `ionic doctor ignore` has been removed in favor of `ionic config set -g doctor.issues..ignored true`). * Ionic 1 build/serve functionality has been moved into the [`@ionic/v1-toolkit`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/@ionic/v1-toolkit) package, which will need to be installed in your Ionic 1 project(s). The file watcher, [chokidar](https://github.com/paulmillr/chokidar), has been updated to 2.0.0, which will require those using `watchPatterns` to [always use POSIX-style slashes](https://github.com/paulmillr/chokidar/blob/master/CHANGELOG.md#chokidar-200-dec-29-2017) (not an issue if you've never used a backslash in globs for Windows). * The gulp integration has been removed from the CLI and put into the [`@ionic/v1-toolkit`](https://github.com/ionic-team/ionic-cli/tree/develop/packages/@ionic/v1-toolkit) package, which is only for Ionic v1 apps. #### :rocket: Enhancements * `ionic s` is now an alias for `ionic serve`. * No need for `@ionic/cli-plugin-proxy`. Proxy support is now built-in. Use existing environment variables or use `ionic config set -g proxy `. * New `ionic config unset` command for deleting config values. * New `ionic doctor treat` command that attempts automatic fixes of detected issues. * If `ionic:build` or `ionic:serve` npm scripts are defined in your `package.json`, the Ionic CLI will use them for the Ionic build/serve instead of the default for your project type. * Automatic login via `IONIC_TOKEN` environment variable [#2410](https://github.com/ionic-team/ionic-cli/issues/2410) * `--no-color` flag for turning off CLI colors * `--no-build` option for `ionic cordova run` and `ionic cordova emulate` [#2930](https://github.com/ionic-team/ionic-cli/pull/2930) * Better monorepo support. See the discussion in [#2232](https://github.com/ionic-team/ionic-cli/issues/2232). * Multi-app support for new Angular projects [#3281](https://github.com/ionic-team/ionic-cli/issues/3281) * Added experimental `ionic ssl generate` command for generating `localhost` SSL certificates for use with `ionic serve`. :memo: HTTPS support in `ionic serve` isn't quite finished yet (see [#3305](https://github.com/ionic-team/ionic-cli/issues/3305)). #### :bug: Bug Fixes * Interactivity is now disabled when not in a TTY. See [#3047](https://github.com/ionic-team/ionic-cli/issues/3047). * Respect `--nosave` flag for `ionic cordova platform` and `ionic cordova plugin` [#2946](https://github.com/ionic-team/ionic-cli/issues/2946) * Chain `--verbose` flag to Cordova for `ionic cordova` commands [#2919](https://github.com/ionic-team/ionic-cli/issues/2919) * Fixed newlines in piped output from underlying CLIs. #### :house: Internal * A huge amount of code refactoring has been accomplished to prepare the CLI for a scalable, flexible future. Changes in behavior and help output based upon environment and config are now trivially accomplished. * The [CLI Framework](https://github.com/ionic-team/ionic-cli/tree/develop/packages/%40ionic/cli-framework), a (currently) internal framework for building general-purpose command-line programs, has had many features added to support the utility CLIs such as `ionic-lab` and `ionic-v1`. * Ionic Lab has been rebuilt using [StencilJS](https://stenciljs.com) and now works for any Ionic Framework version. ## Older Changes * [3.x `CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/3.x/CHANGELOG.md) * [1.x-2.x `CHANGELOG.md`](https://github.com/ionic-team/ionic-cli/blob/2.x/CHANGELOG.md) ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/README.md000066400000000000000000000006141425441362600227210ustar00rootroot00000000000000# Ionic CLI The Ionic command line interface (CLI) is your go-to tool for developing [Ionic][ionic-homepage] apps. **Documentation**: [https://ionicframework.com/docs/cli/][ionic-cli-docs] **Github Project**: [https://github.com/ionic-team/ionic-cli](https://github.com/ionic-team/ionic-cli) [ionic-homepage]: https://ionicframework.com [ionic-cli-docs]: https://ionicframework.com/docs/cli/ ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/assets/000077500000000000000000000000001425441362600227435ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/assets/oauth/000077500000000000000000000000001425441362600240635ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/assets/oauth/success/000077500000000000000000000000001425441362600255335ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/assets/oauth/success/index.html000066400000000000000000000541571425441362600275440ustar00rootroot00000000000000 Success

You are authenticated!

Your app is now building in your terminal!

There was an error logging in. Please return to the terminal.

Identity Vault provides secure biometric authentication for mobile apps.

Auth Connect provides secure authentication for any hybrid mobile app.

Secure Storage provides secure, data-driven, offline-first mobile experiences.
Get Access Go to Dashboard
ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/bin/000077500000000000000000000000001425441362600222115ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/bin/ionic000077500000000000000000000034061425441362600232430ustar00rootroot00000000000000#!/usr/bin/env node 'use strict'; // IMPORTANT: This file uses ES5 syntax to avoid syntax errors in older Node // versions (mostly 0.12). See https://node.green for syntax support. process.title = 'ionic'; process.on('unhandledRejection', function(r) { process.stderr.write(String(r)); process.exit(1); }); var events = require('events'); var path = require('path'); var evt = new events.EventEmitter(); var cli; process.on('message', function(msg) { evt.once('ready', function() { cli.receive(msg); }); }); var semver = require('semver'); var version = semver.parse(process.version); var minversion = 'v10.3.0'; if (semver.lt(version, minversion)) { var details = version.major === 6 ? ' Node.js 6 reached end-of-life on 2019-04-30 and is no longer supported.' : version.major === 8 ? ' Node.js 8 reached end-of-life on 2019-12-31 and is no longer supported.' : ''; process.stderr.write('ERR: Your Node.js version is ' + version.raw + '.' + details + ' Please update to the latest Node LTS version.\n'); process.exit(1); } if (process.argv.includes('--verbose')) { process.env.DEBUG = '*'; } if (process.argv.includes('--no-color')) { process.env.DEBUG_COLORS = '0'; } var pargv = process.argv.slice(2); var lib = path.resolve(__dirname, '..'); process.env.IONIC_CLI_BIN = __filename; process.env.IONIC_CLI_LIB = lib; var bootstrap = require(path.resolve(lib, 'bootstrap')); bootstrap.detectLocalCLI() .then(function(localPath) { cli = require(localPath); return cli.run(pargv, process.env); }, function(err) { cli = require(lib); if (typeof err !== 'string') { throw err; } process.env.IONIC_CLI_LOCAL_ERROR = err; return cli.run(pargv, process.env); }) .then(function() { evt.emit('ready'); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/jest.config.js000066400000000000000000000000671425441362600242130ustar00rootroot00000000000000module.exports = require('../../../jest.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/lint-staged.config.js000066400000000000000000000000761425441362600254610ustar00rootroot00000000000000module.exports = require('../../../lint-staged.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/package.json000066400000000000000000000045561425441362600237410ustar00rootroot00000000000000{ "name": "@ionic/cli", "version": "6.20.1", "description": "A tool for creating and developing Ionic Framework mobile apps.", "homepage": "https://ionicframework.com", "author": "Ionic Team (https://ionicframework.com) ", "bin": { "ionic": "./bin/ionic" }, "engines": { "node": ">=10.3.0" }, "main": "./index.js", "types": "./index.d.ts", "scripts": { "clean": "rimraf index.* bootstrap.* constants.* definitions.* guards.* lib commands", "lint": "true", "build": "npm run clean && tsc", "watch": "tsc -w --preserveWatchOutput", "test": "jest --maxWorkers=4", "prepublishOnly": "npm run build" }, "keywords": [ "ionic", "ionic framework", "ionicframework", "mobile", "app", "hybrid", "cordova", "native", "phonegap" ], "repository": { "type": "git", "url": "https://github.com/ionic-team/ionic-cli.git" }, "bugs": { "url": "https://github.com/ionic-team/ionic-cli/issues" }, "license": "MIT", "dependencies": { "@ionic/cli-framework": "5.1.3", "@ionic/cli-framework-output": "2.2.5", "@ionic/cli-framework-prompts": "2.1.10", "@ionic/utils-array": "2.1.5", "@ionic/utils-fs": "3.1.6", "@ionic/utils-network": "2.1.5", "@ionic/utils-process": "2.1.10", "@ionic/utils-stream": "3.1.5", "@ionic/utils-subprocess": "2.1.11", "@ionic/utils-terminal": "2.3.3", "chalk": "^4.0.0", "debug": "^4.0.0", "diff": "^4.0.1", "elementtree": "^0.1.7", "leek": "0.0.24", "lodash": "^4.17.5", "open": "^7.0.4", "os-name": "^4.0.0", "semver": "^7.1.1", "split2": "^3.0.0", "ssh-config": "^1.1.1", "stream-combiner2": "^1.1.1", "superagent": "^5.2.1", "superagent-proxy": "^3.0.0", "tar": "^6.0.1", "tslib": "^2.0.1" }, "devDependencies": { "@types/debug": "^4.1.1", "@types/diff": "^4.0.0", "@types/elementtree": "^0.1.0", "@types/jest": "^26.0.10", "@types/lodash": "^4.14.104", "@types/node": "~10.17.13", "@types/semver": "^7.1.0", "@types/split2": "^2.1.6", "@types/superagent": "4.1.3", "@types/superagent-proxy": "^3.0.0", "@types/tar": "^4.0.0", "jest": "^26.4.2", "jest-cli": "^26.0.1", "lint-staged": "^10.0.2", "rimraf": "^3.0.0", "source-map": "^0.7.0", "ts-jest": "~26.3.0", "typescript": "~4.0.2" } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/000077500000000000000000000000001425441362600222305ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/__tests__/000077500000000000000000000000001425441362600241665ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/__tests__/guards.ts000066400000000000000000000052031425441362600260230ustar00rootroot00000000000000import * as guards from '../guards'; type Guard = (o: any) => boolean; const OBJECT_GUARDS: Guard[] = [ guards.isCommand, guards.isCommandPreRun, guards.isStarterManifest, guards.isCordovaPackageJson, guards.isExitCodeException, guards.isSuperAgentError, guards.isAPIResponseSuccess, guards.isAPIResponseError, guards.isOrg, guards.isGithubRepo, guards.isGithubBranch, guards.isGithubRepoListResponse, guards.isGithubBranchListResponse, guards.isAppAssociation, guards.isAppAssociationResponse, guards.isGithubRepoAssociation, guards.isBitbucketCloudRepoAssociation, guards.isBitbucketServerRepoAssociation, guards.isApp, guards.isAppResponse, guards.isAppsResponse, guards.isOAuthLogin, guards.isOAuthLoginResponse, guards.isSnapshot, guards.isSnapshotResponse, guards.isSnapshotListResponse, guards.isLogin, guards.isLoginResponse, guards.isUser, guards.isUserResponse, guards.isSSHKey, guards.isSSHKeyListResponse, guards.isSSHKeyResponse, guards.isSecurityProfile, guards.isSecurityProfileResponse, guards.isTreatableAilment, guards.isIntegrationName, guards.isProjectConfig, guards.isMultiProjectConfig, ]; const API_RESPONSE_SUCCESS_GUARDS: Guard[] = [ guards.isGithubRepoListResponse, guards.isGithubBranchListResponse, guards.isAppAssociationResponse, guards.isAppResponse, guards.isAppsResponse, guards.isOAuthLoginResponse, guards.isSnapshotResponse, guards.isSnapshotListResponse, guards.isLoginResponse, guards.isUserResponse, guards.isSSHKeyResponse, guards.isSSHKeyListResponse, guards.isSecurityProfileResponse, ]; describe('@ionic/cli', () => { describe('guards', () => { describe('object guards', () => { it('should return false for non-object types', () => { const tests = [undefined, null, 0, 5, NaN, '', 'foobar', [], ['a', 'b', 'c']]; for (const guard of OBJECT_GUARDS) { for (const test of tests) { const result = guard(test); // if (result) { // debugger; // } expect(result).toBeFalsy(); } } }); }); describe('api response success guards', () => { it('should return false for misshapen objects', () => { const tests = [{}, { data: {} }, { data: 'foobar' }]; for (const guard of API_RESPONSE_SUCCESS_GUARDS) { for (const test of tests) { const result = guard(test); // if (result) { // debugger; // } expect(result).toBeFalsy(); } } }); }); // TODO: add more tests for guards }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/bootstrap.ts000066400000000000000000000020521425441362600246140ustar00rootroot00000000000000import { compileNodeModulesPaths, readPackageJsonFile } from '@ionic/cli-framework/utils/node'; import * as Debug from 'debug'; import * as path from 'path'; import * as semver from 'semver'; import { strong } from './lib/color'; const debug = Debug('ionic:bootstrap'); export const ERROR_BASE_DIRECTORY_NOT_FOUND = 'BASE_DIRECTORY_NOT_FOUND'; export const ERROR_LOCAL_CLI_NOT_FOUND = 'LOCAL_CLI_NOT_FOUND'; export const ERROR_VERSION_TOO_OLD = 'VERSION_TOO_OLD'; export async function detectLocalCLI(): Promise { let pkgPath: string | undefined; try { pkgPath = require.resolve('ionic/package', { paths: compileNodeModulesPaths(process.cwd()) }); } catch (e) { // ignore } if (pkgPath && process.env.IONIC_CLI_LIB !== path.dirname(pkgPath)) { const pkg = await readPackageJsonFile(pkgPath); debug(`local CLI ${strong(pkg.version)} found at ${strong(pkgPath)}`); if (semver.lt(pkg.version, '4.0.0')) { throw ERROR_VERSION_TOO_OLD; } return path.dirname(pkgPath); } throw ERROR_LOCAL_CLI_NOT_FOUND; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/000077500000000000000000000000001425441362600240315ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/build.ts000066400000000000000000000051321425441362600255010ustar00rootroot00000000000000import { Footnote } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, CommandPreRun } from '../definitions'; import { COMMON_BUILD_COMMAND_OPTIONS } from '../lib/build'; import { input } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException, RunnerException } from '../lib/errors'; export class BuildCommand extends Command implements CommandPreRun { async getMetadata(): Promise { const groups: string[] = []; const options: CommandMetadataOption[] = []; const footnotes: Footnote[] = []; const exampleCommands = ['']; let description = `${input('ionic build')} will perform an Ionic build, which compiles web assets and prepares them for deployment.`; const runner = this.project && await this.project.getBuildRunner(); if (runner) { const libmetadata = await runner.getCommandMetadata(); groups.push(...libmetadata.groups || []); options.push(...libmetadata.options || []); description += libmetadata.description ? `\n\n${libmetadata.description.trim()}` : ''; footnotes.push(...libmetadata.footnotes || []); exampleCommands.push(...libmetadata.exampleCommands || []); } options.push(...COMMON_BUILD_COMMAND_OPTIONS); return { name: 'build', type: 'project', summary: 'Build web assets and prepare your app for any platform targets', description, footnotes, groups, exampleCommands, options, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (inputs.length > 0 && ['android', 'ios', 'wp8', 'windows', 'browser'].includes(inputs[0])) { this.env.log.warn( `${input('ionic build')} is for building web assets and takes no arguments. See ${input('ionic build --help')}.\n` + `Ignoring argument ${input(inputs[0])}. Perhaps you meant ${input('ionic cordova build ' + inputs[0])}?\n` ); inputs.splice(0); } } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic build')} outside a project directory.`); } try { const runner = await this.project.requireBuildRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, options); await runner.run(runnerOpts); } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/000077500000000000000000000000001425441362600257765ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/add.ts000066400000000000000000000027511425441362600271030ustar00rootroot00000000000000import { validators } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { CapacitorCommand } from './base'; export class AddCommand extends CapacitorCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'add', type: 'project', summary: 'Add a native platform to your Ionic project', description: ` ${input('ionic capacitor add')} will do the following: - Install the Capacitor platform package - Copy the native platform template into your project `, inputs: [ { name: 'platform', summary: `The platform to add (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, validators: [validators.required], }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (!inputs[0]) { const platform = await this.env.prompt({ type: 'list', name: 'platform', message: 'What platform would you like to add?', choices: ['android', 'ios'], }); inputs[0] = platform.trim(); } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ platform ] = inputs; await this.installPlatform(platform); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/base.ts000066400000000000000000000260111425441362600272600ustar00rootroot00000000000000import { pathExists } from '@ionic/utils-fs'; import { onBeforeExit } from '@ionic/utils-process'; import { ERROR_COMMAND_NOT_FOUND, SubprocessError } from '@ionic/utils-subprocess'; import * as lodash from 'lodash'; import * as path from 'path'; import * as semver from 'semver'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, IonicCapacitorOptions, ProjectIntegration } from '../../definitions'; import { input, weak } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException, RunnerException } from '../../lib/errors'; import { runCommand } from '../../lib/executor'; import type { CapacitorCLIConfig, Integration as CapacitorIntegration } from '../../lib/integrations/capacitor' import { ANDROID_MANIFEST_FILE, CapacitorAndroidManifest } from '../../lib/integrations/capacitor/android'; import { CAPACITOR_CONFIG_JSON_FILE, CapacitorJSONConfig, CapacitorConfig } from '../../lib/integrations/capacitor/config'; import { CapacitorIosInfo, IOS_INFO_FILE } from '../../lib/integrations/capacitor/ios'; import { generateOptionsForCapacitorBuild } from '../../lib/integrations/capacitor/utils'; import { createPrefixedWriteStream } from '../../lib/utils/logger'; import { pkgManagerArgs } from '../../lib/utils/npm'; export abstract class CapacitorCommand extends Command { private _integration?: Required; get integration(): Required { if (!this.project) { throw new FatalException(`Cannot use Capacitor outside a project directory.`); } if (!this._integration) { this._integration = this.project.requireIntegration('capacitor'); } return this._integration; } async getGeneratedConfig(platform: string): Promise { if (!this.project) { throw new FatalException(`Cannot use Capacitor outside a project directory.`); } const p = await this.getGeneratedConfigPath(platform); return new CapacitorJSONConfig(p); } async getGeneratedConfigPath(platform: string): Promise { if (!this.project) { throw new FatalException(`Cannot use Capacitor outside a project directory.`); } const p = await this.getGeneratedConfigDir(platform); return path.resolve(this.integration.root, p, CAPACITOR_CONFIG_JSON_FILE); } async getAndroidManifest(): Promise { const p = await this.getAndroidManifestPath(); return CapacitorAndroidManifest.load(p); } async getAndroidManifestPath(): Promise { const cli = await this.getCapacitorCLIConfig(); const srcDir = cli?.android.srcMainDirAbs ?? 'android/app/src/main'; return path.resolve(this.integration.root, srcDir, ANDROID_MANIFEST_FILE); } async getiOSAppInfo(): Promise { const p = await this.getiOSAppInfoPath(); return CapacitorIosInfo.load(p); } async getiOSAppInfoPath(): Promise { const cli = await this.getCapacitorCLIConfig(); const srcDir = cli?.ios.nativeTargetDirAbs ?? 'ios/App/App'; return path.resolve(this.integration.root, srcDir, IOS_INFO_FILE); } async getGeneratedConfigDir(platform: string): Promise { const cli = await this.getCapacitorCLIConfig(); switch (platform) { case 'android': return cli?.android.assetsDirAbs ?? 'android/app/src/main/assets'; case 'ios': return cli?.ios.nativeTargetDirAbs ?? 'ios/App/App'; } throw new FatalException(`Could not determine generated Capacitor config path for ${input(platform)} platform.`); } async getCapacitorCLIConfig(): Promise { const capacitor = await this.getCapacitorIntegration(); return capacitor.getCapacitorCLIConfig(); } async getCapacitorConfig(): Promise { const capacitor = await this.getCapacitorIntegration(); return capacitor.getCapacitorConfig(); } getCapacitorIntegration = lodash.memoize(async (): Promise => { if (!this.project) { throw new FatalException(`Cannot use Capacitor outside a project directory.`); } return this.project.createIntegration('capacitor'); }); getCapacitorVersion = lodash.memoize(async (): Promise => { try { const proc = await this.env.shell.createSubprocess('capacitor', ['--version'], { cwd: this.integration.root }); const version = semver.parse((await proc.output()).trim()); if (!version) { throw new FatalException('Error while parsing Capacitor CLI version.'); } return version; } catch (e) { if (e instanceof SubprocessError) { if (e.code === ERROR_COMMAND_NOT_FOUND) { throw new FatalException('Error while getting Capacitor CLI version. Is Capacitor installed?'); } throw new FatalException('Error while getting Capacitor CLI version.\n' + (e.output ? e.output : e.code)); } throw e; } }); isCorePlatform(platform: string): boolean { const platforms = ['android', 'ios']; return platforms.includes(platform); } async getInstalledPlatforms(): Promise { const cli = await this.getCapacitorCLIConfig(); const androidPlatformDirAbs = cli?.android.platformDirAbs ?? path.resolve(this.integration.root, 'android'); const iosPlatformDirAbs = cli?.ios.platformDirAbs ?? path.resolve(this.integration.root, 'ios'); const platforms: string[] = []; if (await pathExists(androidPlatformDirAbs)) { platforms.push('android'); } if (await pathExists(iosPlatformDirAbs)) { platforms.push('ios'); } if (await pathExists(path.resolve(this.integration.root, 'electron'))) { platforms.push('electron'); } return platforms; } async isPlatformInstalled(platform: string): Promise { const platforms = await this.getInstalledPlatforms(); return platforms.includes(platform); } async checkCapacitor(runinfo: CommandInstanceInfo) { if (!this.project) { throw new FatalException(`Cannot use Capacitor outside a project directory.`); } const capacitor = this.project.getIntegration('capacitor'); if (!capacitor) { await runCommand(runinfo, ['integrations', 'enable', 'capacitor']); } } async preRunChecks(runinfo: CommandInstanceInfo) { await this.checkCapacitor(runinfo); } async runCapacitor(argList: string[]) { if (!this.project) { throw new FatalException(`Cannot use Capacitor outside a project directory.`); } const stream = createPrefixedWriteStream(this.env.log, weak(`[capacitor]`)); await this.env.shell.run('capacitor', argList, { stream, fatalOnNotFound: false, truncateErrorOutput: 5000, cwd: this.integration.root }); } async runBuild(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot use Capacitor outside a project directory.`); } const conf = await this.getCapacitorConfig(); if (conf?.server?.url) { this.env.log.warn( `Capacitor server URL is in use.\n` + `This may result in unexpected behavior for this build, where an external server is used in the Web View instead of your app. This likely occurred because of ${input('--livereload')} usage in the past and the CLI improperly exiting without cleaning up.\n\n` + `Delete the ${input('server')} key in the Capacitor config file if you did not intend to use an external server.` ); this.env.log.nl(); } if (options['build']) { try { const runner = await this.project.requireBuildRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, generateOptionsForCapacitorBuild(inputs, options)); await runner.run(runnerOpts); } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } } } async runServe(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic capacitor run')} outside a project directory.`); } const [ platform ] = inputs; try { const runner = await this.project.requireServeRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, generateOptionsForCapacitorBuild(inputs, options)); let serverUrl = options['livereload-url'] ? String(options['livereload-url']) : undefined; if (!serverUrl) { const details = await runner.run(runnerOpts); serverUrl = `${details.protocol || 'http'}://${details.externalAddress}:${details.port}`; } const conf = await this.getGeneratedConfig(platform); onBeforeExit(async () => { conf.resetServerUrl(); }); conf.setServerUrl(serverUrl); if (platform === 'android') { const manifest = await this.getAndroidManifest(); onBeforeExit(async () => { await manifest.reset(); }); manifest.enableCleartextTraffic(); await manifest.save(); } if (platform === 'ios' && !options['external']) { const appInfo = await this.getiOSAppInfo(); onBeforeExit(async () => { await appInfo.reset(); }) appInfo.disableAppTransportSecurity(); await appInfo.save(); } } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } } async checkForPlatformInstallation(platform: string) { if (!this.project) { throw new FatalException('Cannot use Capacitor outside a project directory.'); } if (platform) { const capacitor = this.project.getIntegration('capacitor'); if (!capacitor) { throw new FatalException('Cannot check platform installations--Capacitor not yet integrated.'); } if (!(await this.isPlatformInstalled(platform))) { await this.installPlatform(platform); } } } async installPlatform(platform: string): Promise { const version = await this.getCapacitorVersion(); const installedPlatforms = await this.getInstalledPlatforms(); if (installedPlatforms.includes(platform)) { throw new FatalException(`The ${input(platform)} platform is already installed!`); } if (semver.gte(version, '3.0.0-alpha.1')) { if (this.isCorePlatform(platform)) { const [ manager, ...managerArgs ] = await pkgManagerArgs(this.env.config.get('npmClient'), { command: 'install', pkg: `@capacitor/${platform}@${version}`, saveDev: false }); await this.env.shell.run(manager, managerArgs, { cwd: this.integration.root }); } } await this.runCapacitor(['add', platform]); } protected async createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const separatedArgs = options['--']; const verbose = !!options['verbose']; const conf = await this.getCapacitorConfig(); return { '--': separatedArgs ? separatedArgs : [], verbose, ...conf, }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/build.ts000066400000000000000000000132111425441362600274430ustar00rootroot00000000000000import { BaseError, Footnote, MetadataGroup, validators } from '@ionic/cli-framework'; import { CapacitorBuildHookName, CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { FatalException, RunnerException } from '../../lib/errors'; import { Hook, HookDeps } from '../../lib/hooks'; import { getNativeIDEForPlatform } from '../../lib/integrations/capacitor/utils'; import { CapacitorCommand } from './base'; export class BuildCommand extends CapacitorCommand implements CommandPreRun { async getMetadata(): Promise { const groups: string[] = [MetadataGroup.BETA]; const exampleCommands = [ '', 'android', 'ios', ].sort(); const options: CommandMetadataOption[] = [ // Build Options { name: 'build', summary: 'Do not invoke Ionic build', type: Boolean, default: true, }, { name: 'open', summary: 'Do not invoke Capacitor open', type: Boolean, default: true, }, ]; const footnotes: Footnote[] = [ { id: 'capacitor-native-config-docs', url: 'https://capacitor.ionicframework.com/docs/basics/configuring-your-app', shortUrl: 'https://ion.link/capacitor-native-config-docs', }, { id: 'capacitor-ios-config-docs', url: 'https://capacitor.ionicframework.com/docs/ios/configuration', shortUrl: 'https://ion.link/capacitor-ios-config-docs', }, { id: 'capacitor-android-config-docs', url: 'https://capacitor.ionicframework.com/docs/android/configuration', shortUrl: 'https://ion.link/capacitor-android-config-docs', }, ]; const buildRunner = this.project && await this.project.getBuildRunner(); if (buildRunner) { const libmetadata = await buildRunner.getCommandMetadata(); groups.push(...libmetadata.groups || []); options.push(...libmetadata.options || []); footnotes.push(...libmetadata.footnotes || []); } return { name: 'build', type: 'project', summary: 'Build an Ionic project for a given platform', description: ` ${input('ionic capacitor build')} will do the following: - Perform ${input('ionic build')} - Copy web assets into the specified native platform - Open the IDE for your native project (Xcode for iOS, Android Studio for Android) Once the web assets and configuration are copied into your native project, you can build your app using the native IDE. Unfortunately, programmatically building the native project is not yet supported. To configure your native project, see the common configuration docs[^capacitor-native-config-docs] as well as low-level configuration for iOS[^capacitor-ios-config-docs] and Android[^capacitor-android-config-docs]. `, footnotes, exampleCommands, inputs: [ { name: 'platform', summary: `The platform to build for (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, validators: [validators.required], }, ], options, groups, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (!inputs[0]) { const platform = await this.env.prompt({ type: 'list', name: 'platform', message: 'What platform would you like to build for?', choices: ['android', 'ios'], }); inputs[0] = platform.trim(); } await this.checkForPlatformInstallation(inputs[0]); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic capacitor build')} outside a project directory.`); } const [ platform ] = inputs; try { await this.runBuild(inputs, options); } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } await this.runCapacitor(['sync', platform]); const hookDeps: HookDeps = { config: this.env.config, project: this.project, shell: this.env.shell, }; await this.runCapacitorBuildHook('capacitor:build:before', inputs, options, hookDeps); if (options['open']) { this.env.log.nl(); this.env.log.info(this.getContinueMessage(platform)); this.env.log.nl(); await this.runCapacitor(['open', platform]); } } protected getContinueMessage(platform: string): string { if (platform === 'electron') { return 'Ready to be used in Electron!'; } return ( 'Ready for use in your Native IDE!\n' + `To continue, build your project using ${getNativeIDEForPlatform(platform)}!` ); } private async runCapacitorBuildHook(name: CapacitorBuildHookName, inputs: CommandLineInputs, options: CommandLineOptions, e: HookDeps): Promise { const hook = new CapacitorBuildHook(name, e); const buildRunner = await e.project.requireBuildRunner(); try { await hook.run({ name: hook.name, build: buildRunner.createOptionsFromCommandLine(inputs, options), capacitor: await this.createOptionsFromCommandLine(inputs, options), }); } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } } class CapacitorBuildHook extends Hook { readonly name: CapacitorBuildHookName; constructor(name: CapacitorBuildHookName, e: HookDeps) { super(e); this.name = name; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/copy.ts000066400000000000000000000035151425441362600273240ustar00rootroot00000000000000import { CommandMetadataOption } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { CapacitorCommand } from './base'; export class CopyCommand extends CapacitorCommand implements CommandPreRun { async getMetadata(): Promise { const options: CommandMetadataOption[] = [ { name: 'build', summary: 'Do not invoke an Ionic build', type: Boolean, default: true, }, ]; const runner = this.project && await this.project.getBuildRunner(); if (runner) { const libmetadata = await runner.getCommandMetadata(); options.push(...libmetadata.options || []); } return { name: 'copy', type: 'project', summary: 'Copy web assets to native platforms', description: ` ${input('ionic capacitor copy')} will do the following: - Perform an Ionic build, which compiles web assets - Copy web assets to Capacitor native platform(s) `, inputs: [ { name: 'platform', summary: `The platform to copy (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, }, ], options, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (inputs[0]) { await this.checkForPlatformInstallation(inputs[0]); } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ platform ] = inputs; if (options.build) { await this.runBuild(inputs, options); } const args = ['copy']; if (platform) { args.push(platform); } await this.runCapacitor(args); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/index.ts000066400000000000000000000026061425441362600274610ustar00rootroot00000000000000import { strong } from '../../lib/color'; import { CommandMap, Namespace } from '../../lib/namespace'; export class CapacitorNamespace extends Namespace { async getMetadata() { return { name: 'capacitor', summary: 'Capacitor functionality', description: ` These commands integrate with Capacitor, Ionic's new native layer project which provides an alternative to Cordova for native functionality in your app. Learn more about Capacitor: - Main documentation: ${strong('https://ion.link/capacitor')} `, }; } async getCommands(): Promise { return new CommandMap([ ['add', async () => { const { AddCommand } = await import('./add'); return new AddCommand(this); }], ['build', async () => { const { BuildCommand } = await import('./build'); return new BuildCommand(this); }], ['copy', async () => { const { CopyCommand } = await import('./copy'); return new CopyCommand(this); }], ['open', async () => { const { OpenCommand } = await import('./open'); return new OpenCommand(this); }], ['run', async () => { const { RunCommand } = await import('./run'); return new RunCommand(this); }], ['sync', async () => { const { SyncCommand } = await import('./sync'); return new SyncCommand(this); }], ['update', async () => { const { UpdateCommand } = await import('./update'); return new UpdateCommand(this); }], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/open.ts000066400000000000000000000031521425441362600273100ustar00rootroot00000000000000import { validators } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { CapacitorCommand } from './base'; export class OpenCommand extends CapacitorCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'open', type: 'project', summary: 'Open the IDE for a given native platform project', description: ` ${input('ionic capacitor open')} will do the following: - Open the IDE for your native project (Xcode for iOS, Android Studio for Android) `, inputs: [ { name: 'platform', summary: `The platform to open (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, validators: [validators.required], }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (!inputs[0]) { const platform = await this.env.prompt({ type: 'list', name: 'platform', message: 'What platform would you like to open?', choices: ['android', 'ios'], }); inputs[0] = platform.trim(); } await this.checkForPlatformInstallation(inputs[0]); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ platform ] = inputs; const args = ['open']; if (platform) { args.push(platform); } await this.runCapacitor(args); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/run.ts000066400000000000000000000306451425441362600271620ustar00rootroot00000000000000import { BaseError, Footnote, validators } from '@ionic/cli-framework'; import { sleepForever } from '@ionic/utils-process'; import { columnar } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as semver from 'semver'; import { COLUMNAR_OPTIONS } from '../../constants'; import { AnyBuildOptions, AnyServeOptions, CapacitorRunHookName, CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, CommandPreRun } from '../../definitions'; import { ancillary, input, strong, weak } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { Hook, HookDeps } from '../../lib/hooks'; import { getNativeIDEForPlatform, getVirtualDeviceNameForPlatform } from '../../lib/integrations/capacitor/utils'; import { COMMON_SERVE_COMMAND_OPTIONS } from '../../lib/serve'; import { CapacitorCommand } from './base'; const debug = Debug('ionic:commands:capacitor:run'); const PLATFORMS = ['android', 'ios'] as const; interface NativeTarget { id: string; name: string; api: string; } export class RunCommand extends CapacitorCommand implements CommandPreRun { async getMetadata(): Promise { const groups: string[] = []; const exampleCommands = [ '', 'android', 'android -l --external', 'ios --livereload --external', 'ios --livereload-url=http://localhost:8100', ].sort(); let options: CommandMetadataOption[] = [ { name: 'list', summary: 'List all available targets', type: Boolean, groups: ['capacitor', 'native-run'], hint: weak('[capacitor]'), }, { name: 'target', summary: `Deploy to a specific device by its ID (use ${input('--list')} to see all)`, type: String, groups: ['capacitor', 'native-run'], hint: weak('[capacitor]'), }, { name: 'open', summary: `Open native IDE instead of using ${input('capacitor run')}`, type: Boolean, }, // Build Options { name: 'build', summary: 'Do not invoke Ionic build', type: Boolean, default: true, }, // Serve Options ...COMMON_SERVE_COMMAND_OPTIONS.filter(o => !['livereload'].includes(o.name)).map(o => ({ ...o, hint: weak('(--livereload)') })), { name: 'livereload', summary: 'Spin up dev server to live-reload www files', type: Boolean, aliases: ['l'], }, { name: 'livereload-url', summary: 'Provide a custom URL to the dev server', spec: { value: 'url' }, }, ]; const footnotes: Footnote[] = [ { id: 'remote-debugging-docs', url: 'https://ionicframework.com/docs/developer-resources/developer-tips', shortUrl: 'https://ion.link/remote-debugging-docs', }, { id: 'livereload-docs', url: 'https://ionicframework.com/docs/cli/livereload', shortUrl: 'https://ion.link/livereload-docs', }, ]; const buildRunner = this.project && await this.project.getBuildRunner(); if (buildRunner) { const libmetadata = await buildRunner.getCommandMetadata(); groups.push(...libmetadata.groups || []); options.push(...libmetadata.options || []); footnotes.push(...libmetadata.footnotes || []); } return { name: 'run', type: 'project', summary: 'Run an Ionic project on a connected device', description: ` ${input('ionic capacitor run')} will do the following: - Perform ${input('ionic build')} (or run the dev server from ${input('ionic serve')} with the ${input('--livereload')} option) - Run ${input('capacitor run')} (or open IDE for your native project with the ${input('--open')} option) When using ${input('--livereload')} with hardware devices, remember that livereload needs an active connection between device and computer. In some scenarios, you may need to host the dev server on an external address using the ${input('--external')} option. See these docs[^livereload-docs] for more information. If you have multiple devices and emulators, you can target a specific one by ID with the ${input('--target')} option. You can list targets with ${input('--list')}. For Android and iOS, you can setup Remote Debugging on your device with browser development tools using these docs[^remote-debugging-docs]. `, footnotes, exampleCommands, inputs: [ { name: 'platform', summary: `The platform to run (e.g. ${PLATFORMS.map(v => input(v)).join(', ')})`, validators: [validators.required], }, ], options, groups, }; } isOldCapacitor = lodash.memoize(async (): Promise => { const version = await this.getCapacitorVersion(); return semver.lt(version, '3.0.0-alpha.7'); }); async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (await this.isOldCapacitor()) { this.env.log.warn( `Support for Capacitor 1 and 2 is deprecated.\n` + `Please update to the latest Capacitor. Visit the docs${ancillary('[1]')} for upgrade guides.\n\n` + `${ancillary('[1]')}: ${strong('https://capacitorjs.com/docs/')}\n` ); if (options['list']) { throw new FatalException(`The ${input('--list')} option is not supported with your Capacitor version.`); } if (options['target']) { throw new FatalException(`The ${input('--target')} option is not supported with your Capacitor version.`); } } if (!inputs[0]) { const platform = await this.env.prompt({ type: 'list', name: 'platform', message: options['list'] ? 'What platform targets would you like to list?' : 'What platform would you like to run?', choices: PLATFORMS, }); inputs[0] = platform.trim(); } if (options['livereload-url']) { options['livereload'] = true; } if (!options['build'] && options['livereload']) { this.env.log.warn(`No livereload with ${input('--no-build')}.`); options['livereload'] = false; } await this.checkForPlatformInstallation(inputs[0]); if (!(await this.isOldCapacitor())) { const targets = inputs[0] ? await this.getNativeTargets(inputs[0]) : []; if (options['list']) { if (!inputs[0]) { throw new FatalException(`The ${input('platform')} argument is required for the ${input('--list')} option.`); } if (targets.length > 0) { const rows = targets.map(t => [t.name, t.api, t.id]); this.env.log.msg(columnar(rows, { ...COLUMNAR_OPTIONS, headers: ['Name', 'API', 'Target ID'] })); } else { this.env.log.info('No native targets found.'); } throw new FatalException('', 0); } if (!options['open']) { const target = options['target']; if (typeof target === 'string') { if (!targets.map(t => t.id).find(t => t === target)) { throw new FatalException( `${input(target)} is not a valid Target ID.\n` + `Use the ${input('--list')} option to list all targets.\n` ); } } else { options['target'] = await this.env.prompt({ type: 'list', name: 'target', message: 'Which device would you like to target?', choices: targets.map(t => ({ name: `${t.name} (${t.id})`, value: t.id })), }); if (!inputs[0]) { throw new FatalException(`The ${input('platform')} argument is required.`); } if (!options['target']) { throw new FatalException(`The ${input('--target')} option is required.`); } } } } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic capacitor run')} outside a project directory.`); } const [ platform ] = inputs; const doLiveReload = !!options['livereload']; const doOpenFlow = (await this.isOldCapacitor()) || options['open'] === true; if (doLiveReload) { await this.runCapacitor(['sync', platform]); await this.runServe(inputs, options); if (doOpenFlow) { await this.runCapacitorOpenFlow(inputs, options); this.env.log.nl(); this.env.log.info( 'Development server will continue running until manually stopped.\n' + chalk.yellow('Use Ctrl+C to quit this process') ); } else { await this.runCapacitorRunFlow(inputs, options, { shouldSync: false }); this.env.log.nl(); this.env.log.info( `App deployed to device!\n` + 'Development server will continue running until manually stopped.\n\n' + chalk.yellow('Use Ctrl+C to quit this process') ); } await sleepForever(); } else { await this.runBuild(inputs, options); if (doOpenFlow) { await this.runCapacitor(['sync', platform]); await this.runCapacitorOpenFlow(inputs, options); } else { await this.runCapacitorRunFlow(inputs, options, { shouldSync: true }); } } } protected getNativeTargets = lodash.memoize(async (platform: string): Promise => { const args = ['run', platform, '--list', '--json']; debug('Getting native targets for %O with Capacitor CLI: %O', platform, args); const output = await this.env.shell.cmdinfo('capacitor', args, { cwd: this.integration.root }); if (!output) { return []; } const targets = JSON.parse(output); debug('%O native targets found', targets.length); return targets; }); protected async runCapacitorOpenFlow(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic capacitor run')} outside a project directory.`); } const [ platform ] = inputs; await this.runCapacitorRunHook('capacitor:run:before', inputs, options, { ...this.env, project: this.project }); if (options['open'] !== false) { this.env.log.nl(); this.env.log.info(this.getContinueMessage(platform)); this.env.log.nl(); await this.runCapacitor(['open', platform]); } } protected getContinueMessage(platform: string): string { if (platform === 'electron') { return 'Ready to be used in Electron!'; } return ( 'Ready for use in your Native IDE!\n' + `To continue, run your project on a device or ${getVirtualDeviceNameForPlatform(platform)} using ${getNativeIDEForPlatform(platform)}!` ); } protected async runCapacitorRunFlow(inputs: CommandLineInputs, options: CommandLineOptions, { shouldSync = true }: { shouldSync?: boolean } = {}): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic capacitor run')} outside a project directory.`); } const [ platform ] = inputs; await this.runCapacitorRunHook('capacitor:run:before', inputs, options, { ...this.env, project: this.project }); await this.runCapacitor(['run', platform, ...(shouldSync ? [] : ['--no-sync']), '--target', String(options['target'])]); } protected async runCapacitorRunHook(name: CapacitorRunHookName, inputs: CommandLineInputs, options: CommandLineOptions, e: HookDeps): Promise { const hook = new CapacitorRunHook(name, e); let serveOptions: AnyServeOptions | undefined; let buildOptions: AnyBuildOptions | undefined; if (options['livereload']) { const serveRunner = await e.project.requireServeRunner(); serveOptions = serveRunner.createOptionsFromCommandLine(inputs, options); } else { const buildRunner = await e.project.requireBuildRunner(); buildOptions = buildRunner.createOptionsFromCommandLine(inputs, options); } try { await hook.run({ name: hook.name, serve: serveOptions, build: buildOptions, capacitor: await this.createOptionsFromCommandLine(inputs, options), }); } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } } class CapacitorRunHook extends Hook { readonly name: CapacitorRunHookName; constructor(name: CapacitorRunHookName, e: HookDeps) { super(e); this.name = name; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/sync.ts000066400000000000000000000063111425441362600273230ustar00rootroot00000000000000import { BaseError, CommandMetadataOption } from '@ionic/cli-framework'; import { CapacitorSyncHookName, CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { Hook, HookDeps } from '../../lib/hooks'; import { CapacitorCommand } from './base'; export class SyncCommand extends CapacitorCommand implements CommandPreRun { async getMetadata(): Promise { const options: CommandMetadataOption[] = [ { name: 'build', summary: 'Do not invoke an Ionic build', type: Boolean, default: true, }, ]; const runner = this.project && await this.project.getBuildRunner(); if (runner) { const libmetadata = await runner.getCommandMetadata(); options.push(...libmetadata.options || []); } return { name: 'sync', type: 'project', summary: 'Sync (copy + update) an Ionic project', description: ` ${input('ionic capacitor sync')} will do the following: - Perform an Ionic build, which compiles web assets - Copy web assets to Capacitor native platform(s) - Update Capacitor native platform(s) and dependencies - Install any discovered Capacitor or Cordova plugins `, inputs: [ { name: 'platform', summary: `The platform to sync (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, }, ], options, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (inputs[0]) { await this.checkForPlatformInstallation(inputs[0]); } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic capacitor sync')} outside a project directory.`); } const [ platform ] = inputs; if (options.build) { await this.runBuild(inputs, options); } const args = ['sync']; if (platform) { args.push(platform); } await this.runCapacitor(args); const hookDeps: HookDeps = { config: this.env.config, project: this.project, shell: this.env.shell, }; await this.runCapacitorSyncHook('capacitor:sync:after', inputs, options, hookDeps); } private async runCapacitorSyncHook(name: CapacitorSyncHookName, inputs: CommandLineInputs, options: CommandLineOptions, e: HookDeps): Promise { const hook = new CapacitorSyncHook(name, e); const buildRunner = await e.project.requireBuildRunner(); try { await hook.run({ name: hook.name, build: buildRunner.createOptionsFromCommandLine(inputs, options), capacitor: await this.createOptionsFromCommandLine(inputs, options), }); } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } } class CapacitorSyncHook extends Hook { readonly name: CapacitorSyncHookName; constructor(name: CapacitorSyncHookName, e: HookDeps) { super(e); this.name = name; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/capacitor/update.ts000066400000000000000000000025251425441362600276340ustar00rootroot00000000000000import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { CapacitorCommand } from './base'; export class UpdateCommand extends CapacitorCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'update', type: 'project', summary: 'Update Capacitor native platforms, install Capacitor/Cordova plugins', description: ` ${input('ionic capacitor update')} will do the following: - Update Capacitor native platform(s) and dependencies - Install any discovered Capacitor or Cordova plugins `, inputs: [ { name: 'platform', summary: `The platform to update (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (inputs[0]) { await this.checkForPlatformInstallation(inputs[0]); } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ platform ] = inputs; const args = ['update']; if (platform) { args.push(platform); } await this.runCapacitor(args); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/completion.ts000066400000000000000000000034731425441362600265610ustar00rootroot00000000000000import { MetadataGroup, ZshCompletionFormatter, getCompletionWords } from '@ionic/cli-framework'; import { TERMINAL_INFO } from '@ionic/utils-terminal'; import * as path from 'path'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { strong } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; export class CompletionCommand extends Command { async getMetadata(): Promise { return { name: 'completion', type: 'global', summary: 'Enables tab-completion for Ionic CLI commands.', description: ` This command is experimental and only works for Z shell (zsh) and non-Windows platforms. To enable completions for the Ionic CLI, you can add the completion code that this command prints to your ${strong('~/.zshrc')} (or any other file loaded with your shell). See the examples. `, groups: [MetadataGroup.EXPERIMENTAL], exampleCommands: [ '', '>> ~/.zshrc', ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (TERMINAL_INFO.windows) { throw new FatalException('Completion is not supported on Windows shells.'); } if (path.basename(TERMINAL_INFO.shell) !== 'zsh') { throw new FatalException('Completion is currently only available for Z Shell (zsh).'); } const words = options['--']; if (!words || words.length === 0) { const namespace = this.namespace.root; const formatter = new ZshCompletionFormatter({ namespace }); process.stdout.write(await formatter.format()); return; } const ns = this.namespace.root; const outputWords = await getCompletionWords(ns, words.slice(1)); process.stdout.write(outputWords.join(' ')); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/config/000077500000000000000000000000001425441362600252765ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/config/base.ts000066400000000000000000000103011425441362600265530ustar00rootroot00000000000000import { BaseConfig } from '@ionic/cli-framework'; import * as lodash from 'lodash'; import * as util from 'util'; import { CommandLineInputs, CommandLineOptions, IConfig, IProject } from '../../definitions'; import { failure, input, strong } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; export interface BaseConfigContext { json: boolean; force: boolean; root: boolean; property?: string; value?: any; } export interface GlobalConfigContext extends BaseConfigContext { global: true; config: IConfig; } export interface ProjectConfigContext extends BaseConfigContext { global: false; config: IProject['config']; } export type ConfigContext = GlobalConfigContext | ProjectConfigContext; export abstract class BaseConfigCommand extends Command { generateContext(inputs: CommandLineInputs, options: CommandLineOptions): ConfigContext { const [ property, v ] = inputs; const global = options['global'] ? true : false; const json = options['json'] ? true : false; const force = options['force'] ? true : false; const root = options['root'] ? true : false; const value = this.interpretValue(v, json); const base: BaseConfigContext = { json, property, value, force, root }; if (global) { if (root) { this.env.log.warn(`${input('--root')} has no effect with ${input('--global')}: this command always operates at root for CLI config.`); } return { global, config: this.env.config, ...base }; } else { if (!this.project) { throw new FatalException( `Sorry--this won't work outside an Ionic project directory.\n` + `Did you mean to operate on global config using ${input('--global')}?` ); } return { global, config: this.project.config, ...base }; } } jsonStringify(v: any): string { try { const serialized = JSON.stringify(v); if (typeof serialized === 'undefined') { throw new FatalException(`Cannot serialize value: ${strong(v)}`); } return serialized; } catch (e) { throw new FatalException(`Cannot serialize value: ${strong(v)}`); } } interpretValue(v?: string, expectJson = false): any { if (typeof v === 'undefined') { return; } try { // '12345e6' (a possible App ID) is interpreted as a number in scientific // notation during JSON.parse, so don't try if (!v.match(/^\d+e\d+$/)) { v = JSON.parse(v); } } catch (e) { if (e.name !== 'SyntaxError') { throw e; } if (expectJson) { throw new FatalException(`${input('--json')}: ${input(String(v))} is invalid JSON: ${failure(e.toString())}`); } } return v; } } interface FlexibleConfigFile { [key: string]: any; } class FlexibleConfig extends BaseConfig { provideDefaults() { return {}; } } export function getConfig(ctx: ConfigContext): FlexibleConfigFile { return ctx.root ? new FlexibleConfig(ctx.config.p) : ctx.config; } export function getConfigValue(ctx: ConfigContext): any { const { c } = getConfig(ctx); if (ctx.global) { // Global config is flattened return ctx.property ? c[ctx.property] : c; } else { return ctx.property ? lodash.get(c, ctx.property) : c; } } export function setConfigValue(ctx: ConfigContext & { property: string; originalValue: any; }): void { const conf = getConfig(ctx); if (ctx.originalValue && typeof ctx.originalValue === 'object' && !ctx.force) { throw new FatalException( `Sorry--will not override objects or arrays without ${input('--force')}.\n` + `Value of ${input(ctx.property)} is: ${strong(util.inspect(ctx.originalValue, { colors: false }))}` ); } if (ctx.global) { // Global config is flattened conf.set(ctx.property, ctx.value); } else { const { c } = conf; lodash.set(c, ctx.property, ctx.value); conf.c = c; } } export function unsetConfigValue(ctx: ConfigContext & { property: string; }): void { const conf = getConfig(ctx); if (ctx.global) { // Global config is flattened conf.unset(ctx.property); } else { const { c } = conf; lodash.unset(c, ctx.property); conf.c = c; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/config/get.ts000066400000000000000000000070051425441362600264270ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { strcmp } from '@ionic/cli-framework/utils/string'; import { columnar, prettyPath } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import * as lodash from 'lodash'; import * as util from 'util'; import { COLUMNAR_OPTIONS, PROJECT_FILE } from '../../constants'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input, strong, weak } from '../../lib/color'; import { BaseConfigCommand, ConfigContext, getConfigValue } from './base'; export class ConfigGetCommand extends BaseConfigCommand { async getMetadata(): Promise { const projectFile = this.project ? prettyPath(this.project.filePath) : PROJECT_FILE; return { name: 'get', type: 'global', summary: 'Print config values', description: ` This command reads and prints configuration values from the project's ${strong(projectFile)} file. It can also operate on the global CLI configuration (${strong('~/.ionic/config.json')}) using the ${input('--global')} option. For nested properties, separate nest levels with dots. For example, the property name ${input('integrations.cordova')} will look in the ${strong('integrations')} object for the ${strong('cordova')} property. Without a ${input('property')} argument, this command prints out the entire config. For multi-app projects, this command is scoped to the current project by default. To operate at the root of the project configuration file instead, use the ${input('--root')} option. If you are using this command programmatically, you can use the ${input('--json')} option. This command will sanitize config output for known sensitive fields (disabled when using ${input('--json')}). `, inputs: [ { name: 'property', summary: 'The property name you wish to get', }, ], options: [ { name: 'global', summary: 'Use global CLI config', type: Boolean, aliases: ['g'], }, { name: 'json', summary: 'Output config values in JSON', type: Boolean, groups: [MetadataGroup.ADVANCED], }, { name: 'root', summary: `Operate on root of ${strong(projectFile)}`, type: Boolean, hint: weak('[multi-app]'), groups: [MetadataGroup.ADVANCED], }, ], exampleCommands: ['', 'id', '--global user.email', '-g npmClient'], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const ctx = this.generateContext(inputs, options); const conf = getConfigValue(ctx); this.printConfig(ctx, conf); } printConfig(ctx: ConfigContext, v: any): void { const { global, json } = ctx; if (json) { process.stdout.write(this.jsonStringify(v)); } else { if (global && v && typeof v === 'object') { const columns = lodash.entries(v) .map(([key, value]) => [key, this.sanitizeEntry(key, value)]) .map(([key, value]) => [strong(key), util.inspect(value, { colors: chalk.level > 0 })]); columns.sort((a, b) => strcmp(a[0], b[0])); this.env.log.rawmsg(columnar(columns, COLUMNAR_OPTIONS)); } else { this.env.log.rawmsg(util.inspect(v, { depth: Infinity, colors: chalk.level > 0 })); } } } sanitizeEntry(key: string, value: any): typeof value { if (key.includes('tokens')) { return '*****'; } return value; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/config/index.ts000066400000000000000000000024531425441362600267610ustar00rootroot00000000000000import { prettyPath } from '@ionic/utils-terminal'; import { PROJECT_FILE } from '../../constants'; import { input, strong } from '../../lib/color'; import { CommandMap, Namespace } from '../../lib/namespace'; export class ConfigNamespace extends Namespace { async getMetadata() { const projectFile = this.project ? prettyPath(this.project.filePath) : PROJECT_FILE; return { name: 'config', summary: 'Manage CLI and project config values', description: ` These commands are used to programmatically read, write, and delete CLI and project config values. By default, these commands use your project's ${strong(prettyPath(projectFile))} file. To use these commands for the global CLI config file (${strong('~/.ionic/config.json')}), use the ${input('--global')} flag. `, }; } async getCommands(): Promise { return new CommandMap([ ['get', async () => { const { ConfigGetCommand } = await import('./get'); return new ConfigGetCommand(this); }], ['set', async () => { const { ConfigSetCommand } = await import('./set'); return new ConfigSetCommand(this); }], ['unset', async () => { const { ConfigUnsetCommand } = await import('./unset'); return new ConfigUnsetCommand(this); }], ['delete', 'unset'], ['del', 'unset'], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/config/set.ts000066400000000000000000000072611425441362600264470ustar00rootroot00000000000000import { MetadataGroup, validators } from '@ionic/cli-framework'; import { prettyPath } from '@ionic/utils-terminal'; import { PROJECT_FILE } from '../../constants'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input, strong, weak } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { BaseConfigCommand, getConfigValue, setConfigValue } from './base'; export class ConfigSetCommand extends BaseConfigCommand { async getMetadata(): Promise { const projectFile = this.project ? prettyPath(this.project.filePath) : PROJECT_FILE; return { name: 'set', type: 'global', summary: 'Set config values', description: ` This command writes configuration values to the project's ${strong(prettyPath(projectFile))} file. It can also operate on the global CLI configuration (${strong('~/.ionic/config.json')}) using the ${input('--global')} option. For nested properties, separate nest levels with dots. For example, the property name ${input('integrations.cordova')} will look in the ${strong('integrations')} object for the ${strong('cordova')} property. For multi-app projects, this command is scoped to the current project by default. To operate at the root of the project configuration file instead, use the ${input('--root')} option. This command will attempt to coerce ${input('value')} into a suitable JSON type. If it is JSON-parsable, such as ${input('123')}, ${input('true')}, ${input('[]')}, etc., then it takes the parsed result. Otherwise, the value is interpreted as a string. For stricter input, use ${input('--json')}, which will error with non-JSON values. By default, if ${input('property')} exists and is an object or an array, the value is not overwritten. To disable this check and always overwrite the property, use ${input('--force')}. `, inputs: [ { name: 'property', summary: 'The property name you wish to set', validators: [validators.required], }, { name: 'value', summary: 'The new value of the given property', validators: [validators.required], }, ], options: [ { name: 'global', summary: 'Use global CLI config', type: Boolean, aliases: ['g'], }, { name: 'json', summary: `Always interpret ${input('value')} as JSON`, type: Boolean, groups: [MetadataGroup.ADVANCED], }, { name: 'force', summary: 'Always overwrite existing values', type: Boolean, groups: [MetadataGroup.ADVANCED], }, { name: 'root', summary: `Operate on root of ${strong(prettyPath(projectFile))}`, type: Boolean, hint: weak('[multi-app]'), groups: [MetadataGroup.ADVANCED], }, ], exampleCommands: ['name newAppName', 'name "\\"newAppName\\"" --json', '-g interactive false'], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const ctx = this.generateContext(inputs, options); const { property } = ctx; if (typeof property === 'undefined') { throw new FatalException(`Cannot set config to ${input(ctx.value)} without a property.`); } const originalValue = getConfigValue(ctx); setConfigValue({ ...ctx, property, originalValue }); if (ctx.value !== originalValue) { this.env.log.ok(`${input(property)} set to ${input(JSON.stringify(ctx.value))}!`); } else { this.env.log.info(`${input(property)} is already set to ${input(JSON.stringify(ctx.value))}.`); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/config/unset.ts000066400000000000000000000051451425441362600270110ustar00rootroot00000000000000import { MetadataGroup, validators } from '@ionic/cli-framework'; import { prettyPath } from '@ionic/utils-terminal'; import { PROJECT_FILE } from '../../constants'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input, strong, weak } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { BaseConfigCommand, getConfigValue, unsetConfigValue } from './base'; export class ConfigUnsetCommand extends BaseConfigCommand { async getMetadata(): Promise { const projectFile = this.project ? prettyPath(this.project.filePath) : PROJECT_FILE; return { name: 'unset', type: 'global', summary: 'Delete config values', description: ` This command deletes configuration values from the project's ${strong(prettyPath(projectFile))} file. It can also operate on the global CLI configuration (${strong('~/.ionic/config.json')}) using the ${input('--global')} option. For nested properties, separate nest levels with dots. For example, the property name ${input('integrations.cordova')} will look in the ${strong('integrations')} object for the ${strong('cordova')} property. For multi-app projects, this command is scoped to the current project by default. To operate at the root of the project configuration file instead, use the ${input('--root')} option. `, inputs: [ { name: 'property', summary: 'The property name you wish to delete', validators: [validators.required], }, ], options: [ { name: 'global', summary: 'Use global CLI config', type: Boolean, aliases: ['g'], }, { name: 'root', summary: `Operate on root of ${strong(prettyPath(projectFile))}`, type: Boolean, hint: weak('[multi-app]'), groups: [MetadataGroup.ADVANCED], }, ], exampleCommands: ['', 'type', '--global git.setup', '-g interactive'], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const ctx = this.generateContext(inputs, options); const { property } = ctx; if (typeof property === 'undefined') { throw new FatalException(`Cannot unset config entry without a property.`); } const propertyExists = typeof getConfigValue(ctx) !== 'undefined'; unsetConfigValue({ ...ctx, property }); if (propertyExists) { this.env.log.ok(`${input(property)} unset!`); } else { this.env.log.warn(`Property ${input(property)} does not exist--cannot unset.`); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/000077500000000000000000000000001425441362600254665ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/base.ts000066400000000000000000000173131425441362600267550ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { mkdirp, pathExists } from '@ionic/utils-fs'; import { ERROR_COMMAND_NOT_FOUND, ERROR_SIGNAL_EXIT, SubprocessError } from '@ionic/utils-subprocess'; import { prettyPath } from '@ionic/utils-terminal'; import * as lodash from 'lodash'; import * as path from 'path'; import { CommandInstanceInfo, CommandMetadataOption, IShellRunOptions, ProjectIntegration } from '../../definitions'; import { input, strong, weak } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { getFullCommandParts, runCommand } from '../../lib/executor'; import { pkgManagerArgs } from '../../lib/utils/npm'; export const CORDOVA_COMPILE_OPTIONS: CommandMetadataOption[] = [ { name: 'debug', summary: 'Mark as a debug build', type: Boolean, groups: ['cordova', 'cordova-cli'], hint: weak('[cordova]'), }, { name: 'release', summary: 'Mark as a release build', type: Boolean, groups: ['cordova', 'cordova-cli'], hint: weak('[cordova]'), }, { name: 'device', summary: 'Deploy build to a device', type: Boolean, groups: ['cordova', 'cordova-cli', 'native-run'], hint: weak('[cordova/native-run]'), }, { name: 'emulator', summary: 'Deploy build to an emulator', type: Boolean, groups: ['cordova', 'cordova-cli', 'native-run'], hint: weak('[cordova/native-run]'), }, { name: 'buildConfig', summary: 'Use the specified build configuration', groups: [MetadataGroup.ADVANCED, 'cordova', 'cordova-cli'], hint: weak('[cordova]'), spec: { value: 'file' }, }, ]; export const CORDOVA_RUN_OPTIONS: readonly CommandMetadataOption[] = [ ...CORDOVA_COMPILE_OPTIONS, { name: 'target', summary: `Deploy build to a device (use ${input('--list')} to see all)`, type: String, groups: [MetadataGroup.ADVANCED, 'cordova', 'cordova-cli', 'native-run'], hint: weak('[cordova/native-run]'), }, ]; export const CORDOVA_BUILD_EXAMPLE_COMMANDS = [ 'ios', 'ios --prod --release', 'ios --prod --release -- --developmentTeam="ABCD" --codeSignIdentity="iPhone Developer" --packageType="app-store"', 'ios --buildConfig=build.json', 'ios --prod --release --buildConfig=build.json', 'android', 'android --prod --release -- -- --keystore=filename.keystore --alias=myalias', 'android --prod --release -- -- --minSdkVersion=21', 'android --prod --release -- -- --versionCode=55', 'android --prod --release -- -- --gradleArg=-PcdvBuildMultipleApks=true', 'android --buildConfig=build.json', 'android --prod --release --buildConfig=build.json', ]; export abstract class CordovaCommand extends Command { private _integration?: Required; protected get integration(): Required { if (!this.project) { throw new FatalException(`Cannot use Cordova outside a project directory.`); } if (!this._integration) { this._integration = this.project.requireIntegration('cordova'); } return this._integration; } protected async checkCordova(runinfo: CommandInstanceInfo) { if (!this.project) { throw new FatalException('Cannot use Cordova outside a project directory.'); } const cordova = this.project.getIntegration('cordova'); if (!cordova) { const capacitor = this.project.getIntegration('capacitor'); if (capacitor && capacitor.enabled) { throw new FatalException( `Refusing to use Cordova inside a Capacitor project.\n` + `Are you looking for the ${input('ionic capacitor')} commands? See ${input('ionic capacitor --help')}\n\n` + `If you are switching from Capacitor to Cordova, run: ${input('ionic integrations disable capacitor')}\n` ); } const { confirmCordovaUsage } = await import('../../lib/integrations/cordova/utils'); const confirm = await confirmCordovaUsage(this.env); if (!confirm) { throw new FatalException('', 0); } await runCommand(runinfo, ['integrations', 'enable', 'cordova']); } } protected async preRunChecks(runinfo: CommandInstanceInfo): Promise { const { checkForUnsupportedProject } = await import('../../lib/integrations/cordova/utils'); const { loadCordovaConfig } = await import('../../lib/integrations/cordova/config'); if (!this.project) { throw new FatalException('Cannot use Cordova outside a project directory.'); } const parts = getFullCommandParts(runinfo.location); const alias = lodash.last(parts); await checkForUnsupportedProject(this.project.type, alias); await this.checkCordova(runinfo); // Check for www folder if (this.project.directory) { const wwwPath = path.join(this.integration.root, 'www'); const wwwExists = await pathExists(wwwPath); // TODO: hard-coded if (!wwwExists) { const tasks = this.createTaskChain(); tasks.next(`Creating ${strong(prettyPath(wwwPath))} directory for you`); await mkdirp(wwwPath); tasks.end(); } } const conf = await loadCordovaConfig(this.integration); conf.resetContentSrc(); await conf.save(); } protected async runCordova(argList: string[], { fatalOnNotFound = false, truncateErrorOutput = 5000, ...options }: IShellRunOptions = {}): Promise { if (!this.project) { throw new FatalException('Cannot use Cordova outside a project directory.'); } try { await this.env.shell.run('cordova', argList, { fatalOnNotFound, truncateErrorOutput, cwd: this.integration.root, ...options }); } catch (e) { if (e instanceof SubprocessError) { if (e.code === ERROR_COMMAND_NOT_FOUND) { const installArgs = await pkgManagerArgs(this.env.config.get('npmClient'), { command: 'install', pkg: 'cordova', global: true }); throw new FatalException( `The Cordova CLI was not found on your PATH. Please install Cordova globally:\n` + `${input(installArgs.join(' '))}\n` ); } if (e.code === ERROR_SIGNAL_EXIT) { return; } } if (options.fatalOnError) { this.env.log.nl(); this.env.log.error('Cordova encountered an error.\nYou may get more insight by running the Cordova command above directly.\n'); } throw e; } } protected async checkForPlatformInstallation(platform: string, { promptToInstall = !['android', 'ios'].includes(platform), promptToInstallRefusalMsg = `Cannot run this command for the ${input(platform)} platform unless it is installed.` }: { promptToInstall?: boolean; promptToInstallRefusalMsg?: string; } = {}): Promise { if (!this.project) { throw new FatalException('Cannot use Cordova outside a project directory.'); } if (platform) { const { getPlatforms } = await import('../../lib/integrations/cordova/project'); const { confirmCordovaBrowserUsage } = await import('../../lib/integrations/cordova/utils'); const platforms = await getPlatforms(this.integration.root); if (!platforms.includes(platform)) { if (platform === 'browser') { const confirm = await confirmCordovaBrowserUsage(this.env); if (!confirm) { throw new FatalException(promptToInstallRefusalMsg); } } const confirm = promptToInstall ? await this.env.prompt({ message: `Platform ${input(platform)} is not installed! Would you like to install it?`, type: 'confirm', name: 'confirm', }) : true; if (confirm) { await this.runCordova(['platform', 'add', platform, '--save']); } else { throw new FatalException(promptToInstallRefusalMsg); } } } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/build.ts000066400000000000000000000100751425441362600271400ustar00rootroot00000000000000import { CommandMetadataOption, Footnote, validators } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input, strong } from '../../lib/color'; import { FatalException, RunnerException } from '../../lib/errors'; import { filterArgumentsForCordova, generateOptionsForCordovaBuild } from '../../lib/integrations/cordova/utils'; import { CORDOVA_BUILD_EXAMPLE_COMMANDS, CORDOVA_COMPILE_OPTIONS, CordovaCommand } from './base'; export class BuildCommand extends CordovaCommand implements CommandPreRun { async getMetadata(): Promise { const exampleCommands = CORDOVA_BUILD_EXAMPLE_COMMANDS.sort(); const options: CommandMetadataOption[] = [ // Build Options { name: 'build', summary: 'Do not invoke an Ionic build', type: Boolean, default: true, }, ...CORDOVA_COMPILE_OPTIONS, ]; const footnotes: Footnote[] = [ { id: 'cordova-android-using-flags', url: 'https://cordova.apache.org/docs/en/latest/guide/platforms/android/index.html#using-flags', }, { id: 'cordova-ios-using-flags', url: 'https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html#using-flags', }, ]; const runner = this.project && await this.project.getBuildRunner(); if (runner) { const libmetadata = await runner.getCommandMetadata(); options.push(...(libmetadata.options || []).filter(o => o.groups && o.groups.includes('cordova'))); footnotes.push(...libmetadata.footnotes || []); } return { name: 'build', type: 'project', summary: 'Use Cordova to build for Android and iOS platform targets', description: ` Like running ${input('cordova build')} directly, ${input('ionic cordova build')} also builds web assets from ${input('ionic build')} and provides friendly checks for Android and iOS platforms. To pass additional options to the Cordova CLI, use the ${input('--')} separator after the Ionic CLI arguments. The Cordova CLI requires a separator for platform-specific arguments for Android builds[^cordova-android-using-flags], so an additional separator is required for the Ionic CLI, but it is not required for iOS builds[^cordova-ios-using-flags]. See the example commands for usage with separators. To avoid using flags, consider using ${input('--buildConfig')} with a ${strong('build.json')} file. `, footnotes, exampleCommands, inputs: [ { name: 'platform', summary: `The platform to build (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, validators: [validators.required], }, ], options, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (!inputs[0]) { const platform = await this.env.prompt({ type: 'input', name: 'platform', message: `What platform would you like to build (${['android', 'ios'].map(v => input(v)).join(', ')}):`, }); inputs[0] = platform.trim(); } await this.checkForPlatformInstallation(inputs[0]); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const metadata = await this.getMetadata(); if (!this.project) { throw new FatalException(`Cannot run ${input('ionic cordova build')} outside a project directory.`); } if (options.build) { try { const runner = await this.project.requireBuildRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, generateOptionsForCordovaBuild(metadata, inputs, options)); await runner.run(runnerOpts); } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } } const cordovaArgs = filterArgumentsForCordova(metadata, options); await this.runCordova(cordovaArgs, { stdio: 'inherit' }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/compile.ts000066400000000000000000000034561425441362600274760ustar00rootroot00000000000000import { validators } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { filterArgumentsForCordova } from '../../lib/integrations/cordova/utils'; import { CORDOVA_COMPILE_OPTIONS, CordovaCommand } from './base'; export class CompileCommand extends CordovaCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'compile', type: 'project', summary: 'Compile native platform code', description: ` Like running ${input('cordova compile')} directly, but provides friendly checks. `, exampleCommands: [ 'ios', 'ios --device', 'android', ], inputs: [ { name: 'platform', summary: `The platform to compile (${['android', 'ios'].map(v => input(v)).join(', ')})`, validators: [validators.required], }, ], options: [ ...CORDOVA_COMPILE_OPTIONS, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (!inputs[0]) { const platform = await this.env.prompt({ type: 'input', name: 'platform', message: `What platform would you like to compile (${['android', 'ios'].map(v => input(v)).join(', ')}):`, }); inputs[0] = platform.trim(); } await this.checkForPlatformInstallation(inputs[0]); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const metadata = await this.getMetadata(); await this.runCordova(filterArgumentsForCordova(metadata, options), { stdio: 'inherit' }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/emulate.ts000066400000000000000000000005661425441362600275010ustar00rootroot00000000000000import { CommandMetadata } from '../../definitions'; import { RunCommand } from './run'; export class EmulateCommand extends RunCommand { async getMetadata(): Promise { const metadata = await super.getMetadata(); return { ...metadata, name: 'emulate', summary: 'Emulate an Ionic project on a simulator/emulator', }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/index.ts000066400000000000000000000035571425441362600271570ustar00rootroot00000000000000import { strong } from '../../lib/color'; import { CommandMap, Namespace } from '../../lib/namespace'; export class CordovaNamespace extends Namespace { async getMetadata() { return { name: 'cordova', summary: 'Cordova functionality', description: ` These commands integrate with Apache Cordova, which brings native functionality to your app. Cordova Reference documentation: - Overview: ${strong('https://cordova.apache.org/docs/en/latest/guide/overview/index.html')} - CLI documentation: ${strong('https://cordova.apache.org/docs/en/latest/reference/cordova-cli/')} `, }; } async getCommands(): Promise { return new CommandMap([ ['build', async () => { const { BuildCommand } = await import('./build'); return new BuildCommand(this); }], ['compile', async () => { const { CompileCommand } = await import('./compile'); return new CompileCommand(this); }], ['emulate', async () => { const { EmulateCommand } = await import('./emulate'); return new EmulateCommand(this); }], ['platform', async () => { const { PlatformCommand } = await import('./platform'); return new PlatformCommand(this); }], ['plugin', async () => { const { PluginCommand } = await import('./plugin'); return new PluginCommand(this); }], ['prepare', async () => { const { PrepareCommand } = await import('./prepare'); return new PrepareCommand(this); }], ['resources', async () => { const { ResourcesCommand } = await import('./resources'); return new ResourcesCommand(this); }], ['run', async () => { const { RunCommand } = await import('./run'); return new RunCommand(this); }], ['requirements', async () => { const { RequirementsCommand } = await import('./requirements'); return new RequirementsCommand(this); }], ['platforms', 'platform'], ['plugins', 'plugin'], ['res', 'resources'], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/platform.ts000066400000000000000000000106151425441362600276650ustar00rootroot00000000000000import { contains, validate, validators } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { SUPPORTED_PLATFORMS, createCordovaResNotFoundMessage, findCordovaRes } from '../../lib/cordova-res'; import { FatalException } from '../../lib/errors'; import { runCommand } from '../../lib/executor'; import { CordovaCommand } from './base'; export class PlatformCommand extends CordovaCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'platform', type: 'project', summary: 'Manage Cordova platform targets', description: ` Like running ${input('cordova platform')} directly, but adds default Ionic icons and splash screen resources (during ${input('add')}) and provides friendly checks. `, exampleCommands: ['', 'add ios', 'add android', 'rm ios'], inputs: [ { name: 'action', summary: `${input('add')}, ${input('remove')}, or ${input('update')} a platform; ${input('ls')}, ${input('check')}, or ${input('save')} all project platforms`, }, { name: 'platform', summary: `The platform that you would like to add (${['android', 'ios'].map(v => input(v)).join(', ')})`, }, ], options: [ { name: 'resources', summary: `Do not pregenerate icons and splash screen resources (corresponds to ${input('add')})`, type: Boolean, default: true, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); if (options['r'] || options['noresources']) { options['resources'] = false; } inputs[0] = !inputs[0] ? 'ls' : inputs[0]; inputs[0] = (inputs[0] === 'rm') ? 'remove' : inputs[0]; inputs[0] = (inputs[0] === 'list') ? 'ls' : inputs[0]; validate(inputs[0], 'action', [contains(['add', 'remove', 'update', 'ls', 'check', 'save'], {})]); // If the action is list, check, or save, then just end here. if (['ls', 'check', 'save'].includes(inputs[0])) { await this.runCordova(['platform', inputs[0]], {}); throw new FatalException('', 0); } if (!inputs[1]) { const platform = await this.env.prompt({ type: 'input', name: 'platform', message: `What platform would you like to ${inputs[0]} (${['android', 'ios'].map(v => input(v)).join(', ')}):`, }); inputs[1] = platform.trim(); } validate(inputs[1], 'platform', [validators.required]); } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { const { getPlatforms } = await import('../../lib/integrations/cordova/project'); const { confirmCordovaBrowserUsage, filterArgumentsForCordova } = await import('../../lib/integrations/cordova/utils'); if (!this.project) { throw new FatalException(`Cannot run ${input('ionic cordova platform')} outside a project directory.`); } const [ action, platformName ] = inputs; const platforms = await getPlatforms(this.integration.root); if (action === 'add') { if (platforms.includes(platformName)) { this.env.log.msg(`Platform ${platformName} already exists.`); return; } if (platformName === 'browser') { const confirm = await confirmCordovaBrowserUsage(this.env); if (!confirm) { return; } } } const metadata = await this.getMetadata(); const cordovaArgs = filterArgumentsForCordova(metadata, options); await this.runCordova(cordovaArgs, {}); if (action === 'add' && options['resources'] && SUPPORTED_PLATFORMS.includes(platformName)) { const args = ['cordova', 'resources', platformName, '--force']; const p = await findCordovaRes(); if (p) { await runCommand(runinfo, args); } else { this.env.log.warn(await createCordovaResNotFoundMessage(this.env.config.get('npmClient'))); this.env.log.warn( `Cannot generate resources without ${input('cordova-res')} installed.\n` + `Once installed, you can generate resources with the following command:\n\n` + input(['ionic', ...args].join(' ')) ); } } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/plugin.ts000066400000000000000000000073741425441362600273470ustar00rootroot00000000000000import { MetadataGroup, contains, validate, validators } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { filterArgumentsForCordova } from '../../lib/integrations/cordova/utils'; import { pkgManagerArgs } from '../../lib/utils/npm'; import { CordovaCommand } from './base'; export class PluginCommand extends CordovaCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'plugin', type: 'project', summary: 'Manage Cordova plugins', description: ` Like running ${input('cordova plugin')} directly, but provides friendly checks. `, exampleCommands: ['', 'add cordova-plugin-inappbrowser@latest', 'add phonegap-plugin-push --variable SENDER_ID=XXXXX', 'rm cordova-plugin-camera'], inputs: [ { name: 'action', summary: `${input('add')} or ${input('remove')} a plugin; ${input('ls')} or ${input('save')} all project plugins`, }, { name: 'plugin', summary: `The name of the plugin (corresponds to ${input('add')} and ${input('remove')})`, }, ], options: [ { name: 'force', summary: `Force overwrite the plugin if it exists (corresponds to ${input('add')})`, type: Boolean, groups: [MetadataGroup.ADVANCED, 'cordova', 'cordova-cli'], }, { name: 'variable', summary: 'Specify plugin variables', groups: ['cordova', 'cordova-cli'], spec: { value: 'KEY=VALUE' }, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { if (!this.project) { throw new FatalException('Cannot use Cordova outside a project directory.'); } const capacitor = this.project.getIntegration('capacitor'); if (capacitor && capacitor.enabled) { const pkg = inputs[1] ? inputs[1] : ''; const installArgs = await pkgManagerArgs(this.env.config.get('npmClient'), { command: 'install', pkg, save: false, saveExact: false }); const uninstallArgs = await pkgManagerArgs(this.env.config.get('npmClient'), { command: 'uninstall', pkg, save: false }); throw new FatalException( `Refusing to run ${input('ionic cordova plugin')} inside a Capacitor project.\n` + `In Capacitor projects, Cordova plugins are just regular npm dependencies.\n\n` + `- To add a plugin, use ${input(installArgs.join(' '))}\n` + `- To remove, use ${input(uninstallArgs.join(' '))}\n` ); } await this.preRunChecks(runinfo); inputs[0] = !inputs[0] ? 'ls' : inputs[0]; inputs[0] = (inputs[0] === 'rm') ? 'remove' : inputs[0]; inputs[0] = (inputs[0] === 'list') ? 'ls' : inputs[0]; validate(inputs[0], 'action', [contains(['add', 'remove', 'ls', 'save'], {})]); // If the action is list then lets just end here. if (['ls', 'save'].includes(inputs[0])) { await this.runCordova(['plugin', inputs[0]], {}); throw new FatalException('', 0); } if (!inputs[1]) { const plugin = await this.env.prompt({ message: `What plugin would you like to ${inputs[0]}:`, type: 'input', name: 'plugin', }); inputs[1] = plugin; } validate(inputs[1], 'plugin', [validators.required]); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const metadata = await this.getMetadata(); const cordovaArgs = filterArgumentsForCordova(metadata, options); await this.runCordova(cordovaArgs, {}); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/prepare.ts000066400000000000000000000110631425441362600274750ustar00rootroot00000000000000import { CommandMetadataOption, Footnote } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input, strong } from '../../lib/color'; import { FatalException, RunnerException } from '../../lib/errors'; import { filterArgumentsForCordova, generateOptionsForCordovaBuild } from '../../lib/integrations/cordova/utils'; import { CordovaCommand } from './base'; export class PrepareCommand extends CordovaCommand implements CommandPreRun { async getMetadata(): Promise { const options: CommandMetadataOption[] = [ { name: 'build', summary: 'Do not invoke an Ionic build', type: Boolean, default: true, }, ]; const footnotes: Footnote[] = []; const runner = this.project && await this.project.getBuildRunner(); if (runner) { const libmetadata = await runner.getCommandMetadata(); options.push(...libmetadata.options || []); footnotes.push(...libmetadata.footnotes || []); } return { name: 'prepare', type: 'project', summary: 'Copies assets to Cordova platforms, preparing them for native builds', description: ` ${input('ionic cordova prepare')} will do the following: - Perform an Ionic build, which compiles web assets to ${strong('www/')}. - Copy the ${strong('www/')} directory into your Cordova platforms. - Transform ${strong('config.xml')} into platform-specific manifest files. - Copy icons and splash screens from ${strong('resources/')} to into your Cordova platforms. - Copy plugin files into specified platforms. You may wish to use ${input('ionic cordova prepare')} if you run your project with Android Studio or Xcode. `, footnotes, exampleCommands: ['', 'ios', 'android'], inputs: [ { name: 'platform', summary: `The platform you would like to prepare (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, }, ], options, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { loadCordovaConfig } = await import('../../lib/integrations/cordova/config'); const { getPlatforms } = await import('../../lib/integrations/cordova/project'); const [ platform ] = inputs; if (!this.project) { throw new FatalException(`Cannot run ${input('ionic cordova prepare')} outside a project directory.`); } if (platform) { await this.checkForPlatformInstallation(platform, { promptToInstall: true, promptToInstallRefusalMsg: ( `Cannot prepare for ${input(platform)} unless the platform is installed.\n` + `Did you mean just ${input('ionic cordova prepare')}?\n` ), }); } else { const conf = await loadCordovaConfig(this.integration); const platforms = await getPlatforms(this.integration.root); const configuredPlatforms = conf.getConfiguredPlatforms(); if (configuredPlatforms.length === 0 && platforms.length === 0) { this.env.log.warn( `No platforms added to this project. Cannot prepare native platforms without any installed.\n` + `Run ${input('ionic cordova platform add ')} to add native platforms.` ); throw new FatalException('', 0); } } const metadata = await this.getMetadata(); if (options.build) { const buildOptions = generateOptionsForCordovaBuild(metadata, inputs, options); if (buildOptions['platform']) { try { const runner = await this.project.requireBuildRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, buildOptions); await runner.run(runnerOpts); } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } } else { this.env.log.warn( `Cannot perform Ionic build without ${input('platform')}. Falling back to just ${input('cordova prepare')}.\n` + `Please supply a ${input('platform')} (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')}) so the Ionic CLI can build web assets. The ${input('--no-build')} option will hide this warning.` ); this.env.log.nl(); } } await this.runCordova(filterArgumentsForCordova(metadata, options), { stdio: 'inherit' }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/requirements.ts000066400000000000000000000040041425441362600305570ustar00rootroot00000000000000import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { isExitCodeException } from '../../guards'; import { input } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { filterArgumentsForCordova } from '../../lib/integrations/cordova/utils'; import { CordovaCommand } from './base'; export class RequirementsCommand extends CordovaCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'requirements', type: 'project', summary: 'Checks and print out all the requirements for platforms', description: ` Like running ${input('cordova requirements')} directly, but provides friendly checks. `, inputs: [ { name: 'platform', summary: `The platform for which you would like to gather requirements (${['android', 'ios'].map(v => input(v)).join(', ')})`, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { await this.preRunChecks(runinfo); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ platform ] = inputs; if (!this.project) { throw new FatalException(`Cannot run ${input('ionic cordova requirements')} outside a project directory.`); } await this.checkForPlatformInstallation(platform, { promptToInstall: true, promptToInstallRefusalMsg: ( `Can't gather requirements for ${input(platform)} unless the platform is installed.\n` + `Did you mean just ${input('ionic cordova requirements')}?\n` ), }); const metadata = await this.getMetadata(); try { await this.runCordova(filterArgumentsForCordova(metadata, options), { showError: false, fatalOnError: false }); } catch (e) { if (e.fatal || !isExitCodeException(e)) { throw e; } throw new FatalException(); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/resources.ts000066400000000000000000000073531425441362600300600ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { ancillary, input, strong } from '../../lib/color'; import { SUPPORTED_PLATFORMS, createCordovaResArgs, runCordovaRes } from '../../lib/cordova-res'; import { FatalException } from '../../lib/errors'; import { CordovaCommand } from './base'; export class ResourcesCommand extends CordovaCommand { async getMetadata(): Promise { return { name: 'resources', type: 'project', summary: 'Automatically create icon and splash screen resources', description: ` Generate perfectly sized icons and splash screens from PNG source images for your Cordova platforms with this command. The source image for icons should ideally be at least ${strong('1024×1024px')} and located at ${strong('resources/icon.png')}. The source image for splash screens should ideally be at least ${strong('2732×2732px')} and located at ${strong('resources/splash.png')}. If you used ${input('ionic start')}, there should already be default Ionic resources in the ${strong('resources/')} directory, which you can overwrite. You can also generate platform-specific icons and splash screens by placing them in the respective ${strong('resources//')} directory. For example, to generate an icon for Android, place your image at ${strong('resources/android/icon.png')}. For best results, the splash screen's artwork should roughly fit within a square (${strong('1200×1200px')}) at the center of the image. You can use ${strong('https://code.ionicframework.com/resources/splash.psd')} as a template for your splash screen. ${input('ionic cordova resources')} will automatically update your ${strong('config.xml')} to reflect the changes in the generated images, which Cordova then configures. This command uses the ${input('cordova-res')} utility[^cordova-res-repo] to generate resources locally. Cordova reference documentation: - Icons: ${strong('https://cordova.apache.org/docs/en/latest/config_ref/images.html')} - Splash Screens: ${strong('https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-splashscreen/')} `, footnotes: [ { id: 'cordova-res-repo', url: 'https://github.com/ionic-team/cordova-res', }, ], exampleCommands: ['', ...SUPPORTED_PLATFORMS], inputs: [ { name: 'platform', summary: `The platform for which you would like to generate resources (${SUPPORTED_PLATFORMS.map(v => input(v)).join(', ')})`, }, ], options: [ { name: 'icon', summary: 'Generate icon resources', type: Boolean, aliases: ['i'], }, { name: 'splash', summary: 'Generate splash screen resources', type: Boolean, aliases: ['s'], }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic cordova resources')} outside a project directory.`); } if (options['cordova-res'] === false) { this.env.log.warn( `The ${input('--no-cordova-res')} option has been removed.\n` + `The Ionic image generation server has been shut down and the online resource generation flow no longer exists. Please migrate to ${strong('cordova-res')}${ancillary('[1]')}, the resource generation tool by Ionic that runs on your computer.\n\n` + `${ancillary('[1]')}: ${strong('https://github.com/ionic-team/cordova-res')}\n` ); } const platform = inputs[0] ? String(inputs[0]) : undefined; await runCordovaRes(this.env, createCordovaResArgs({ platform }, options), { cwd: this.integration.root }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/cordova/run.ts000066400000000000000000000340211425441362600266420ustar00rootroot00000000000000import { Footnote, MetadataGroup, validators } from '@ionic/cli-framework'; import { onBeforeExit, sleepForever } from '@ionic/utils-process'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, CommandPreRun, IShellRunOptions, ServeDetails } from '../../definitions'; import { COMMON_BUILD_COMMAND_OPTIONS } from '../../lib/build'; import { input, strong, weak } from '../../lib/color'; import { FatalException, RunnerException } from '../../lib/errors'; import { getPackagePath } from '../../lib/integrations/cordova/project'; import { filterArgumentsForCordova, generateOptionsForCordovaBuild } from '../../lib/integrations/cordova/utils'; import { SUPPORTED_PLATFORMS, checkNativeRun, createNativeRunArgs, createNativeRunListArgs, getNativeTargets, runNativeRun } from '../../lib/native-run'; import { COMMON_SERVE_COMMAND_OPTIONS, LOCAL_ADDRESSES } from '../../lib/serve'; import { createPrefixedWriteStream } from '../../lib/utils/logger'; import { CORDOVA_BUILD_EXAMPLE_COMMANDS, CORDOVA_RUN_OPTIONS, CordovaCommand } from './base'; const debug = Debug('ionic:commands:run'); const NATIVE_RUN_OPTIONS: readonly CommandMetadataOption[] = [ { name: 'native-run', summary: `Do not use ${input('native-run')} to run the app; use Cordova instead`, type: Boolean, default: true, groups: ['native-run'], hint: weak('[native-run]'), }, { name: 'connect', summary: 'Tie the running app to the process', type: Boolean, groups: ['native-run'], hint: weak('[native-run] (--livereload)'), }, { name: 'json', summary: `Output targets in JSON`, type: Boolean, groups: [MetadataGroup.ADVANCED, 'native-run'], hint: weak('[native-run] (--list)'), }, ]; export class RunCommand extends CordovaCommand implements CommandPreRun { async getMetadata(): Promise { const groups: string[] = []; const exampleCommands = [ ...CORDOVA_BUILD_EXAMPLE_COMMANDS, 'android -l', 'ios --livereload --external', 'ios --livereload-url=http://localhost:8100', ].sort(); let options: CommandMetadataOption[] = [ { name: 'list', summary: 'List all available targets', type: Boolean, groups: ['cordova', 'cordova-cli', 'native-run'], }, // Build Options { name: 'build', summary: 'Do not invoke Ionic build', type: Boolean, default: true, }, ...COMMON_BUILD_COMMAND_OPTIONS.filter(o => !['engine', 'platform'].includes(o.name)), // Serve Options ...COMMON_SERVE_COMMAND_OPTIONS.filter(o => !['livereload'].includes(o.name)).map(o => ({ ...o, hint: weak('(--livereload)') })), { name: 'livereload', summary: 'Spin up dev server to live-reload www files', type: Boolean, aliases: ['l'], }, { name: 'livereload-url', summary: 'Provide a custom URL to the dev server', spec: { value: 'url' }, }, ]; const footnotes: Footnote[] = [ { id: 'remote-debugging-docs', url: 'https://ionicframework.com/docs/developer-resources/developer-tips', shortUrl: 'https://ion.link/remote-debugging-docs', }, { id: 'livereload-docs', url: 'https://ionicframework.com/docs/cli/livereload', shortUrl: 'https://ion.link/livereload-docs', }, { id: 'native-run-repo', url: 'https://github.com/ionic-team/native-run', }, ]; const serveRunner = this.project && await this.project.getServeRunner(); const buildRunner = this.project && await this.project.getBuildRunner(); if (buildRunner) { const libmetadata = await buildRunner.getCommandMetadata(); groups.push(...libmetadata.groups || []); options.push(...(libmetadata.options || []).filter(o => o.groups && o.groups.includes('cordova'))); footnotes.push(...libmetadata.footnotes || []); } if (serveRunner) { const libmetadata = await serveRunner.getCommandMetadata(); const existingOpts = options.map(o => o.name); groups.push(...libmetadata.groups || []); const runnerOpts = (libmetadata.options || []) .filter(o => !existingOpts.includes(o.name) && o.groups && o.groups.includes('cordova')) .map(o => ({ ...o, hint: `${o.hint ? `${o.hint} ` : ''}${weak('(--livereload)')}` })); options = lodash.uniqWith([...runnerOpts, ...options], (optionA, optionB) => optionA.name === optionB.name); footnotes.push(...libmetadata.footnotes || []); } // Cordova Options options.push(...CORDOVA_RUN_OPTIONS); // `native-run` Options options.push(...NATIVE_RUN_OPTIONS); return { name: 'run', type: 'project', summary: 'Run an Ionic project on a connected device', description: ` Build your app and deploy it to devices and emulators using this command. Optionally specify the ${input('--livereload')} option to use the dev server from ${input('ionic serve')} for livereload functionality. This command will first use ${input('ionic build')} to build web assets (or ${input('ionic serve')} with the ${input('--livereload')} option). Then, ${input('cordova build')} is used to compile and prepare your app. Finally, the ${input('native-run')} utility[^native-run-repo] is used to run your app on a device. To use Cordova for this process instead, use the ${input('--no-native-run')} option. If you have multiple devices and emulators, you can target a specific one with the ${input('--target')} option. You can list targets with ${input('--list')}. For Android and iOS, you can setup Remote Debugging on your device with browser development tools using these docs[^remote-debugging-docs]. When using ${input('--livereload')} with hardware devices, remember that livereload needs an active connection between device and computer. In some scenarios, you may need to host the dev server on an external address using the ${input('--external')} option. See these docs[^livereload-docs] for more information. Just like with ${input('ionic cordova build')}, you can pass additional options to the Cordova CLI using the ${input('--')} separator. To pass additional options to the dev server, consider using ${input('ionic serve')} separately and using the ${input('--livereload-url')} option. `, footnotes, exampleCommands, inputs: [ { name: 'platform', summary: `The platform to run (e.g. ${['android', 'ios'].map(v => input(v)).join(', ')})`, validators: [validators.required], }, ], options, groups, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { if (options['native-run']) { await this.checkNativeRun(); } await this.preRunChecks(runinfo); const metadata = await this.getMetadata(); if (options['noproxy']) { this.env.log.warn(`The ${input('--noproxy')} option has been deprecated. Please use ${input('--no-proxy')}.`); options['proxy'] = false; } if (options['x']) { options['proxy'] = false; } if (options['livereload-url']) { options['livereload'] = true; } if (!options['build'] && options['livereload']) { this.env.log.warn(`No livereload with ${input('--no-build')}.`); options['livereload'] = false; } // If we're using the emulate command, and if --device and --emulator are // not used, we should set the --emulator flag to mark intent. if (!options['device'] && !options['emulator'] && metadata.name === 'emulate') { options['emulator'] = true; } if (options['list']) { if (options['native-run']) { const args = createNativeRunListArgs(inputs, options); await this.runNativeRun(args); } else { const args = filterArgumentsForCordova(metadata, options); await this.runCordova(['run', ...args.slice(1)], {}); } throw new FatalException('', 0); } if (!inputs[0]) { const p = await this.env.prompt({ type: 'input', name: 'platform', message: `What platform would you like to run (${['android', 'ios'].map(v => input(v)).join(', ')}):`, }); inputs[0] = p.trim(); } const [ platform ] = inputs; if (platform && options['native-run'] && !SUPPORTED_PLATFORMS.includes(platform)) { this.env.log.warn(`${input(platform)} is not supported by ${input('native-run')}. Using Cordova to run the app.`); options['native-run'] = false; } // If we're using native-run, and if --device and --emulator are not used, // we can detect if hardware devices are plugged in and prefer them over // any virtual devices the host has. if (options['native-run'] && !options['device'] && !options['emulator'] && platform) { const platformTargets = await getNativeTargets(this.env, platform); const { devices } = platformTargets; debug(`Native platform devices: %O`, devices); if (devices.length > 0) { this.env.log.info(`Hardware device(s) found for ${input(platform)}. Using ${input('--device')}.`); options['device'] = true; } } await this.checkForPlatformInstallation(platform); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { try { if (options['livereload']) { await this.runServeDeploy(inputs, options); } else { await this.runBuildDeploy(inputs, options); } } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } } protected async runServeDeploy(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { loadCordovaConfig } = await import('../../lib/integrations/cordova/config'); const metadata = await this.getMetadata(); if (!this.project) { throw new FatalException(`Cannot run ${input(`ionic cordova ${metadata.name}`)} outside a project directory.`); } const runner = await this.project.requireServeRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, generateOptionsForCordovaBuild(metadata, inputs, options)); /** * With the --livereload-url option, this command won't perform a serve. If * this is the case, details will be undefined. */ let details: ServeDetails | undefined; let serverUrl = options['livereload-url'] ? String(options['livereload-url']) : undefined; if (!serverUrl) { details = await runner.run(runnerOpts); if (details.externallyAccessible === false && !options['native-run']) { const extra = LOCAL_ADDRESSES.includes(details.externalAddress) ? '\nEnsure you have proper port forwarding setup from your device to your computer.' : ''; this.env.log.warn(`Your device or emulator may not be able to access ${strong(details.externalAddress)}.${extra}\n\n`); } serverUrl = `${details.protocol || 'http'}://${details.externalAddress}:${details.port}`; } const conf = await loadCordovaConfig(this.integration); onBeforeExit(async () => { conf.resetContentSrc(); await conf.save(); }); conf.writeContentSrc(serverUrl); await conf.save(); const cordovalogws = createPrefixedWriteStream(this.env.log, weak(`[cordova]`)); const buildOpts: IShellRunOptions = { stream: cordovalogws }; // ignore very verbose compiler output on stdout unless --verbose buildOpts.stdio = options['verbose'] ? 'inherit' : ['pipe', 'ignore', 'pipe']; if (options['native-run']) { const [ platform ] = inputs; await this.runCordova(filterArgumentsForCordova({ ...metadata, name: 'build' }, options), buildOpts); const packagePath = await getPackagePath(this.integration.root, conf.getProjectInfo().name, platform, { emulator: !options['device'], release: !!options['release'] }); const forwardedPorts = details ? runner.getUsedPorts(runnerOpts, details) : []; await this.runNativeRun(createNativeRunArgs({ packagePath, platform, forwardedPorts }, options)); } else { await this.runCordova(filterArgumentsForCordova(metadata, options), buildOpts); await sleepForever(); } } protected async runBuildDeploy(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { loadCordovaConfig } = await import('../../lib/integrations/cordova/config'); const metadata = await this.getMetadata(); if (!this.project) { throw new FatalException(`Cannot run ${input(`ionic cordova ${metadata.name}`)} outside a project directory.`); } if (options.build) { try { const runner = await this.project.requireBuildRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, generateOptionsForCordovaBuild(metadata, inputs, options)); await runner.run(runnerOpts); } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } } if (options['native-run']) { const conf = await loadCordovaConfig(this.integration); const [ platform ] = inputs; await this.runCordova(filterArgumentsForCordova({ ...metadata, name: 'build' }, options), { stdio: 'inherit' }); const packagePath = await getPackagePath(this.integration.root, conf.getProjectInfo().name, platform, { emulator: !options['device'], release: !!options['release'] }); await this.runNativeRun(createNativeRunArgs({ packagePath, platform }, { ...options, connect: false })); } else { await this.runCordova(filterArgumentsForCordova(metadata, options), { stdio: 'inherit' }); } } protected async checkNativeRun(): Promise { await checkNativeRun(this.env); } protected async runNativeRun(args: readonly string[]): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic cordova run/emulate')} outside a project directory.`); } await runNativeRun(this.env, args, { cwd: this.integration.root }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/000077500000000000000000000000001425441362600253255ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/add.ts000066400000000000000000000123241425441362600264270ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input } from '../../lib/color'; import { runCommand } from '../../lib/executor'; import { DeployConfCommand } from './core'; export class AddCommand extends DeployConfCommand { async getMetadata(): Promise { return { name: 'add', type: 'project', groups: [MetadataGroup.PAID], summary: 'Adds Appflow Deploy to the project', description: ` This command adds the Appflow Deploy plugin (${input('cordova-plugin-ionic')}) for both Capacitor and Cordova projects. For Capacitor projects it runs all the steps necessary to install the plugin, sync with the native projects and add the configuration to the proper iOS and Android configuration files. For Cordova projects it just takes care of running the proper Cordova CLI command with the submitted parameters. `, exampleCommands: [ '', '--app-id=abcd1234 --channel-name="Master" --update-method=background', '--max-store=2 --min-background-duration=30', '--app-id=abcd1234 --channel-name="Master" --update-method=background --max-store=2 --min-background-duration=30', ], options: [ { name: 'app-id', summary: 'Your Appflow app ID', type: String, spec: { value: 'id' }, }, { name: 'channel-name', summary: 'The channel to check for updates from', type: String, spec: { value: 'name' }, }, { name: 'update-method', summary: 'The update method that dictates the behavior of the plugin', type: String, spec: { value: 'name' }, }, { name: 'max-store', summary: 'The maximum number of downloaded versions to store on the device', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'quantity' }, default: '2', }, { name: 'min-background-duration', summary: 'The minimum duration after which the app checks for an update in the background', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'seconds' }, default: '30', }, { name: 'update-api', summary: 'The location of the Appflow API', type: String, groups: [MetadataGroup.HIDDEN], spec: { value: 'url' }, default: 'https://api.ionicjs.com', }, ], }; } protected buildCordovaDeployOptions(options: CommandLineOptions): string[] { const optionsToCordova = { 'app-id': 'APP_ID', 'channel-name': 'CHANNEL_NAME', 'update-method': 'UPDATE_METHOD', 'max-store': 'MAX_STORE', 'min-background-duration': 'MIN_BACKGROUND_DURATION', 'update-api': 'UPDATE_API', }; const outputOptions = []; for (const [optionKey, cordovaKey] of Object.entries(optionsToCordova)) { if (options[optionKey]) { outputOptions.push(`--variable`); outputOptions.push(`${cordovaKey}=${options[optionKey]}`); } } return outputOptions; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { // check if there are native integration installed await this.requireNativeIntegration(); await this.preRunCheckInputs(options); } async addPlugin(options: CommandLineOptions, runinfo: CommandInstanceInfo, integration?: string) { if (integration === 'cordova') { let deployCommand = ['cordova', 'plugin', 'add', 'cordova-plugin-ionic']; const userOptions = this.buildCordovaDeployOptions(options); if (userOptions) { deployCommand = deployCommand.concat(userOptions); } await runCommand(runinfo, deployCommand); } if (integration === 'capacitor') { const { pkgManagerArgs } = await import('../../lib/utils/npm'); const [ installer, ...installerArgs ] = await pkgManagerArgs( this.env.config.get('npmClient'), { command: 'install', pkg: 'cordova-plugin-ionic' } ); // install the plugin with npm await this.env.shell.run(installer, installerArgs, { stdio: 'inherit' }); } } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { const integration = await this.getAppIntegration(); // check if it is already installed const alreadyAdded = await this.checkDeployInstalled(); if (!alreadyAdded) { await this.addPlugin(options, runinfo, integration); } else { this.env.log.warn("Live Updates plugin already added. Reconfiguring only."); } if (integration === 'capacitor') { // generate the manifest await runCommand(runinfo, ['deploy', 'manifest']); // run capacitor sync await runCommand(runinfo, ['capacitor', 'sync']); // update the ios project if present await this.addConfToIosPlist(options); // update the android project if present await this.addConfToAndroidString(options); } this.env.log.ok(`Appflow Deploy plugin added to the project!\n`); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/build.ts000066400000000000000000000232161425441362600270000ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, MetadataGroup } from '@ionic/cli-framework'; import { LOGGER_LEVELS } from '@ionic/cli-framework-output'; import { sleep } from '@ionic/utils-process'; import { tmpfilepath } from '@ionic/utils-fs'; import { columnar } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as fs from 'fs'; import { CommandMetadata } from '../../definitions'; import { isSuperAgentError } from '../../guards'; import { input, strong, weak } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { createRequest, download } from '../../lib/utils/http'; import { IONIC_CLOUD_CLI_MIGRATION } from '../../lib/updates'; const debug = Debug('ionic:commands:deploy:build'); interface DeployBuild { artifact_name: string; job_id: number; id: string; caller_id: number; created: string; finished: string; state: string; commit: any; automation_id: number; environment_id: number; native_config_id: number; automation_name: string; environment_name: string; job: any; pending_channels: string[]; } interface DownloadUrl { url: string | null; } export class BuildCommand extends Command { async getMetadata(): Promise { const dashUrl = this.env.config.getDashUrl(); return { name: 'build', type: 'project', groups: [MetadataGroup.PAID, MetadataGroup.DEPRECATED], summary: 'Create a deploy build on Appflow', description: ` This command creates a deploy build on Appflow. While the build is running, it prints the remote build log to the terminal. If the build is successful, it downloads the created web build zip file in the current directory. Downloading build artifacts can be skipped by supplying the flag ${input('skip-download')}. Apart from ${input('--commit')}, every option can be specified using the full name setup within the Appflow Dashboard[^dashboard]. Customizing the build: - The ${input('--environment')} and ${input('--channel')} options can be used to customize the groups of values exposed to the build. `, footnotes: [ { id: 'dashboard', url: dashUrl, }, ], exampleCommands: [ '', '--environment="My Custom Environment Name"', '--commit=2345cd3305a1cf94de34e93b73a932f25baac77c', '--channel="Master"', '--channel="Master" --skip-download', '--channel="Master" --channel="My Custom Channel"', ], options: [ { name: 'environment', summary: 'The group of environment variables exposed to your build', type: String, spec: { value: 'name' }, }, { name: 'channel', summary: 'The channel you want to auto deploy the build to. This can be repeated multiple times if multiple channels need to be specified.', type: String, spec: { value: 'name' }, }, { name: 'commit', summary: 'Commit (defaults to HEAD)', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'sha1' }, }, { name: 'skip-download', summary: `Skip downloading build artifacts after command succeeds.`, type: Boolean, spec: { value: 'name' }, default: false, }, ], }; } async preRun(inputs: CommandLineInputs, optinos: CommandLineOptions): Promise { this.env.log.warn(IONIC_CLOUD_CLI_MIGRATION); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic deploy build')} outside a project directory.`); } const token = await this.env.session.getUserToken(); const appflowId = await this.project.requireAppflowId(); if (!options.commit) { options.commit = (await this.env.shell.output('git', ['rev-parse', 'HEAD'], { cwd: this.project.directory })).trim(); debug(`Commit hash: ${strong(options.commit)}`); } let build = await this.createDeployBuild(appflowId, token, options); const buildId = build.job_id; const details = columnar([ ['App ID', strong(appflowId)], ['Build ID', strong(buildId.toString())], ['Commit', strong(`${build.commit.sha.substring(0, 6)} ${build.commit.note}`)], ['Environment', build.environment_name ? strong(build.environment_name) : weak('not set')], ['Channels', build.pending_channels.length ? build.pending_channels.map(v => strong(`"${v}"`)).join(', ') : weak('not set')], ], { vsep: ':' }); this.env.log.ok( `Build created\n` + details + '\n\n' ); build = await this.tailBuildLog(appflowId, buildId, token); if (build.state !== 'success') { throw new Error(`Build ${build.state}`); } if (options['skip-download']) { return; } const url = await this.getDownloadUrl(appflowId, buildId, token); if (!url.url) { throw new Error('Missing URL in response'); } const filename = await this.downloadBuild(url.url, build.artifact_name); this.env.log.ok(`Artifact downloaded: ${filename}`); } async createDeployBuild(appflowId: string, token: string, options: CommandLineOptions): Promise { const { req } = await this.env.client.make('POST', `/apps/${appflowId}/deploys/verbose_post`); let channels: string[] = []; if (options.channel) { if (typeof(options.channel) === 'string') { channels.push(String(options.channel)); } else if (typeof(options.channel) === 'object') { channels = channels.concat(options.channel); } } req.set('Authorization', `Bearer ${token}`).send({ commit_sha: options.commit, environment_name: options.environment, channel_names: channels ? channels : undefined, }); try { const res = await this.env.client.do(req); return res.data as DeployBuild; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to create build: ` + apiErrorMessage); } else { throw e; } } } async tailBuildLog(appflowId: string, buildId: number, token: string): Promise { let build; let start = 0; const ws = this.env.log.createWriteStream(LOGGER_LEVELS.INFO, false); let isCreatedMessage = false; let errorsEncountered = 0; while (!(build && ['success', 'failed', 'canceled'].includes(build.state))) { try { await sleep(5000); build = await this.getDeployBuild(appflowId, buildId, token); if (build && build.state === 'created' && !isCreatedMessage) { ws.write(chalk.yellow('Concurrency limit reached: build will start as soon as other builds finish.')); isCreatedMessage = true; } const trace = build.job.trace; if (trace.length > start) { ws.write(trace.substring(start)); start = trace.length; } errorsEncountered = 0; } catch (e) { // Retry up to 3 times in the case of an error. errorsEncountered++; ws.write(chalk.yellow(`Encountered error: ${e} while fetching build data retrying.`)); if (errorsEncountered >= 3) { ws.write(chalk.red(`Encountered ${errorsEncountered} errors in a row. Job will now fail.`)); throw e; } } } ws.end(); return build; } async getDeployBuild(appflowId: string, buildId: number, token: string): Promise { const { req } = await this.env.client.make('GET', `/apps/${appflowId}/deploys/${buildId}`); req.set('Authorization', `Bearer ${token}`).send(); try { const res = await this.env.client.do(req); return res.data as DeployBuild; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to get build ${buildId}: ` + apiErrorMessage); } else { throw e; } } } async getDownloadUrl(appflowId: string, buildId: number, token: string): Promise { const { req } = await this.env.client.make('GET', `/apps/${appflowId}/packages/${buildId}/download?artifact_type=WWW_ZIP`); req.set('Authorization', `Bearer ${token}`).send(); try { const res = await this.env.client.do(req); return res.data as DownloadUrl; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to get download URL for build ${buildId}: ` + apiErrorMessage); } else { throw e; } } } async downloadBuild(url: string, filename: string): Promise { const { req } = await createRequest('GET', url, this.env.config.getHTTPConfig()); const tmpFile = tmpfilepath('ionic-package-build'); const ws = fs.createWriteStream(tmpFile); await download(req, ws, {}); fs.copyFileSync(tmpFile, filename); fs.unlinkSync(tmpFile); return filename; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/capacitor.ts000066400000000000000000000025261425441362600276470ustar00rootroot00000000000000import { BaseConfig } from "@ionic/cli-framework"; import lodash = require("lodash"); export interface CapacitorConfig { appId?: string; appName?: string; webDir?: string; server?: { url?: string; originalUrl?: string; }; } export interface CapacitorCLIConfig { android: { platformDirAbs: string; srcMainDirAbs: string; assetsDirAbs: string; }; ios: { platformDirAbs: string; nativeTargetDirAbs: string; }; app: { extConfig: CapacitorConfig; }; } export class CapacitorJSONConfig extends BaseConfig { constructor(p: string) { super(p, { spaces: "\t" }); } provideDefaults(config: CapacitorConfig): CapacitorConfig { return config; } setServerUrl(url: string): void { const serverConfig = this.get("server") || {}; if (typeof serverConfig.url === "string") { serverConfig.originalUrl = serverConfig.url; } serverConfig.url = url; this.set("server", serverConfig); } resetServerUrl(): void { const serverConfig = this.get("server") || {}; delete serverConfig.url; if (serverConfig.originalUrl) { serverConfig.url = serverConfig.originalUrl; delete serverConfig.originalUrl; } if (lodash.isEmpty(serverConfig)) { this.unset("server"); } else { this.set("server", serverConfig); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/configure.ts000066400000000000000000000111031425441362600276520ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, MetadataGroup } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandMetadata } from '../../definitions'; import { input } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { DeployConfCommand } from './core'; export class ConfigureCommand extends DeployConfCommand { async getMetadata(): Promise { return { name: 'configure', type: 'project', groups: [MetadataGroup.PAID], summary: 'Overrides Appflow Deploy configuration', description: ` This command overrides configuration for the Appflow Deploy plugin (${input('cordova-plugin-ionic')}) in Capacitor projects. For Capacitor projects, if the plugin is already installed, it overrides the configuration variables in the native projects. For Cordova projects this is not implemented because it is better to reinstall the plugin with the different parameters and let Cordova deal with the changes. `, exampleCommands: [ '', '--app-id=abcd1234 --channel-name="Master" --update-method=background', '--max-store=2 --min-background-duration=30', '--app-id=abcd1234 --channel-name="Master" --update-method=background --max-store=2 --min-background-duration=30', 'android', 'ios', ], options: [ { name: 'app-id', summary: 'Your Appflow app ID', type: String, spec: { value: 'id' }, }, { name: 'channel-name', summary: 'The channel to check for updates from', type: String, spec: { value: 'name' }, }, { name: 'update-method', summary: 'The update method that dictates the behavior of the plugin', type: String, spec: { value: 'name' }, }, { name: 'max-store', summary: 'The maximum number of downloaded versions to store on the device', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'quantity' }, }, { name: 'min-background-duration', summary: 'The minimum duration after which the app checks for an update in the background', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'seconds' }, }, { name: 'update-api', summary: 'The location of the Appflow API', type: String, groups: [MetadataGroup.HIDDEN], spec: { value: 'url' }, }, ], inputs: [ { name: 'platform', summary: `The native platform (e.g. ${['ios', 'android'].map(v => input(v)).join(', ')})`, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { // check if it is already installed const alreadyAdded = await this.checkDeployInstalled(); if (!alreadyAdded) { throw new FatalException( `Deploy (cordova-plugin-ionic) not yet installed.\n` + `Please run ${input('ionic deploy add')}` ); } // check if there are native integration installed await this.requireNativeIntegration(); // check that if an input is provided, it is valid if (inputs[0] && !['ios', 'android'].includes(inputs[0])) { throw new FatalException(`Only ${input('ios')} or ${input('android')} can be used.`); } await this.preRunCheckInputs(options); } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { const integration = await this.getAppIntegration(); if (integration === 'cordova') { throw new FatalException( `Deploy (cordova-plugin-ionic) configuration cannot be overridden for a Cordova project.\n` + `Please uninstall the plugin and run ${input('ionic deploy add')} again.` ); } if (integration === 'capacitor') { // check if there is an input that matches only one const updateIos = !inputs[0] || (inputs[0] === 'ios'); const updateAndroid = !inputs[0] || (inputs[0] === 'android'); // update the ios project if present let printOkMessage = false; if (updateIos) { printOkMessage = await this.addConfToIosPlist(options); } // update the android project if present if (updateAndroid) { printOkMessage = await this.addConfToAndroidString(options); } if (printOkMessage) { this.env.log.ok(`Deploy (cordova-plugin-ionic) configs successfully overridden for the project\n`); } } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/core.ts000066400000000000000000000423741425441362600266370ustar00rootroot00000000000000import { CommandLineOptions, combine, contains, validators } from '@ionic/cli-framework'; import { pathExists, pathWritable, readFile, writeFile } from '@ionic/utils-fs'; import * as et from 'elementtree'; import * as path from 'path'; import { input, strong } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; export abstract class DeployCoreCommand extends Command { protected async getAppIntegration(): Promise { if (this.project) { if (this.project.getIntegration('capacitor') !== undefined) { return 'capacitor'; } if (this.project.getIntegration('cordova') !== undefined) { return 'cordova'; } } return undefined; } protected async requireNativeIntegration(): Promise { const integration = await this.getAppIntegration(); if (!integration) { throw new FatalException( `It looks like your app isn't integrated with Capacitor or Cordova.\n` + `In order to use the Appflow Deploy plugin, you will need to integrate your app with Capacitor or Cordova. See the docs for setting up native projects:\n\n` + `iOS: ${strong('https://ionicframework.com/docs/building/ios')}\n` + `Android: ${strong('https://ionicframework.com/docs/building/android')}\n` ); } } } export abstract class DeployConfCommand extends DeployCoreCommand { protected readonly optionsToPlistKeys: {[key: string]: string} = { 'app-id': 'IonAppId', 'channel-name': 'IonChannelName', 'update-method': 'IonUpdateMethod', 'max-store': 'IonMaxVersions', 'min-background-duration': 'IonMinBackgroundDuration', 'update-api': 'IonApi', }; protected readonly optionsToStringXmlKeys = { 'app-id': 'ionic_app_id', 'channel-name': 'ionic_channel_name', 'update-method': 'ionic_update_method', 'max-store': 'ionic_max_versions', 'min-background-duration': 'ionic_min_background_duration', 'update-api': 'ionic_update_api', }; protected readonly requiredOptionsDefaults: {[key: string]: string} = { 'max-store': '2', 'min-background-duration': '30', 'update-api': 'https://api.ionicjs.com', } protected readonly requiredOptionsFromPlistVal: {[key: string]: string} = { 'IonMaxVersions': 'max-store', 'IonMinBackgroundDuration': 'min-background-duration', 'IonApi': 'update-api', } protected readonly requiredOptionsFromXmlVal = { 'ionic_max_versions': 'max-store', 'ionic_min_background_duration': 'min-background-duration', 'ionic_update_api': 'update-api', } protected async getAppId(): Promise { if (this.project) { return this.project.config.get('id'); } return undefined; } protected async checkDeployInstalled(): Promise { if (!this.project) { return false; } const packageJson = await this.project.requirePackageJson(); return packageJson.dependencies ? 'cordova-plugin-ionic' in packageJson.dependencies : false; } protected printPlistInstructions(options: CommandLineOptions): void { let outputString = `You will need to manually modify the Info.plist for your iOS project.\n Please add the following content to your Info.plist file:\n`; for (const [optionKey, pKey] of Object.entries(this.optionsToPlistKeys)) { outputString = `${outputString}${pKey}\n${options[optionKey]}\n`; } this.env.log.warn(outputString); } protected printStringXmlInstructions(options: CommandLineOptions): void { let outputString = `You will need to manually modify the string.xml for your Android project.\n Please add the following content to your string.xml file:\n`; for (const [optionKey, pKey] of Object.entries(this.optionsToPlistKeys)) { outputString = `${outputString}${options[optionKey]}\n`; } this.env.log.warn(outputString); } protected async getIosCapPlist(): Promise { if (!this.project) { return ''; } const capIntegration = this.project.getIntegration('capacitor'); if (!capIntegration) { return ''; } // check first if iOS exists if (!await pathExists(path.join(capIntegration.root, 'ios'))) { return ''; } const assumedPlistPath = path.join(capIntegration.root, 'ios', 'App', 'App', 'Info.plist'); if (!await pathWritable(assumedPlistPath)) { throw new Error('The iOS Info.plist could not be found.'); } return assumedPlistPath; } protected async getAndroidCapString(): Promise { if (!this.project) { return ''; } const capIntegration = this.project.getIntegration('capacitor'); if (!capIntegration) { return ''; } // check first if iOS exists if (!await pathExists(path.join(capIntegration.root, 'android'))) { return ''; } const assumedStringXmlPath = path.join(capIntegration.root, 'android', 'app', 'src', 'main', 'res', 'values', 'strings.xml'); if (!await pathWritable(assumedStringXmlPath)) { throw new Error('The Android string.xml could not be found.'); } return assumedStringXmlPath; } protected async addConfToIosPlist(options: CommandLineOptions): Promise { let plistPath; try { plistPath = await this.getIosCapPlist(); } catch (e) { this.env.log.warn(e.message); this.printPlistInstructions(options); return false; } if (!plistPath) { this.env.log.warn( `No ${strong('Capacitor iOS')} project found\n` + `You will need to rerun ${input('ionic deploy configure')} if you add it later.\n` ); return false; } // try to load the plist file first let plistData; try { const plistFile = await readFile(plistPath); plistData = plistFile.toString(); } catch (e) { this.env.log.error(`The iOS Info.plist could not be read.`); this.printPlistInstructions(options); return false; } // parse it with elementtree let etree; try { etree = et.parse(plistData); } catch (e) { this.env.log.error(`Impossible to parse the XML in the Info.plist`); this.printPlistInstructions(options); return false; } // check that it is an actual plist file (root tag plist and first child dict) const root = etree.getroot(); if (root.tag !== 'plist') { this.env.log.error(`Info.plist is not a valid plist file because the root is not a tag`); this.printPlistInstructions(options); return false; } const pdict = root.find('./dict'); if (!pdict) { this.env.log.error(`Info.plist is not a valid plist file because the first child is not a tag`); this.printPlistInstructions(options); return false; } // check which options are set (configure might not have all of them set) const setOptions: { [key: string]: string } = {}; for (const [optionKey, plistKey] of Object.entries(this.optionsToPlistKeys)) { if (options[optionKey]) { setOptions[optionKey] = plistKey; } } if (Object.entries(setOptions).length === 0) { this.env.log.warn(`No new options detected for Info.plist`); return false; } // because elementtree has limited XPath support we cannot just run a smart selection, so we need to loop over all the elements const pdictChildren = pdict.getchildren(); // there is no way to refer to a first right sibling in elementtree, so we use flags let removeNextStringTag = false; let existingRequiredKeys = []; for (const element of pdictChildren) { // find required options and keep track of what is already existing if ((element.tag === 'key') && (element.text) && this.requiredOptionsFromPlistVal[element.text as string] != undefined) { existingRequiredKeys.push(this.requiredOptionsFromPlistVal[element.text as string]) } // we remove all the existing element if there if ((element.tag === 'key') && (element.text) && Object.values(setOptions).includes(element.text as string)) { pdict.remove(element); removeNextStringTag = true; continue; } // and remove the first right sibling (this will happen at the next iteration of the loop if ((element.tag === 'string') && removeNextStringTag) { pdict.remove(element); removeNextStringTag = false; } } // set any missing required keys to default for (const key of Object.keys(this.requiredOptionsDefaults)) { if (existingRequiredKeys.includes(key)) { continue; } setOptions[key] = this.optionsToPlistKeys[key]; if (!options[key]) { options[key] = this.requiredOptionsDefaults[key]; } } // add again the new settings for (const [optionKey, plistKey] of Object.entries(setOptions)) { const plistValue = options[optionKey]; if (!plistValue) { throw new FatalException(`This should never have happened: a parameter is missing so we cannot write the Info.plist`); } const pkey = et.SubElement(pdict, 'key'); pkey.text = plistKey; const pstring = et.SubElement(pdict, 'string'); pstring.text = plistValue; } // finally write back the modified plist const newXML = etree.write({ encoding: 'utf-8', indent: 2, xml_declaration: false, }); // elementtree cannot write a doctype, so little hack const xmlToWrite = `\n` + `\n` + newXML; try { await writeFile(plistPath, xmlToWrite, { encoding: 'utf-8' }); } catch (e) { this.env.log.error(`Changes to Info.plist could not be written.`); this.printPlistInstructions(options); } this.env.log.ok(`cordova-plugin-ionic variables correctly added to the iOS project`); return true; } protected async addConfToAndroidString(options: CommandLineOptions): Promise { let stringXmlPath; try { stringXmlPath = await this.getAndroidCapString(); } catch (e) { this.env.log.warn(e.message); this.printPlistInstructions(options); return false; } if (!stringXmlPath) { this.env.log.warn( `No ${strong('Capacitor Android')} project found\n`+ `You will need to rerun ${input('ionic deploy configure')} if you add it later.\n`); return false; } // try to load the plist file first let stringData; try { const stringFile = await readFile(stringXmlPath); stringData = stringFile.toString(); } catch (e) { this.env.log.error(`The Android string.xml could not be read.`); this.printStringXmlInstructions(options); return false; } // parse it with elementtree let etree; try { etree = et.parse(stringData); } catch (e) { this.env.log.error(`Impossible to parse the XML in the string.xml`); this.printStringXmlInstructions(options); return false; } // check that it is an actual string.xml file (root tag is resources) const root = etree.getroot(); if (root.tag !== 'resources') { this.env.log.error(`string.xml is not a valid android string.xml file because the root is not a tag`); this.printStringXmlInstructions(options); return false; } // check which options are set (configure might not have all of them set) const setOptions: { [key: string]: string } = {}; for (const [optionKey, plistKey] of Object.entries(this.optionsToStringXmlKeys)) { if (options[optionKey]) { setOptions[optionKey] = plistKey; } } if (Object.entries(setOptions).length === 0) { this.env.log.warn(`No new options detected for string.xml`); return false; } for (const [optionKey, stringKey] of Object.entries(setOptions)) { let element = root.find(`./string[@name="${stringKey}"]`); // if the tag already exists, just update the content if (element) { element.text = options[optionKey] as string; } else { // otherwise create the tag element = et.SubElement(root, 'string'); element.set('name', stringKey); element.text = options[optionKey] as string; } } // make sure required keys are set for (const [stringKey, optionKey] of Object.entries(this.requiredOptionsFromXmlVal)) { let element = root.find(`./string[@name="${stringKey}"]`); // if the tag already exists, just update the content if (element) { continue; } else { // otherwise create the tag and set to default element = et.SubElement(root, 'string'); element.set('name', stringKey); console.log(optionKey, 'opoitn key'); element.text = this.requiredOptionsDefaults[optionKey]; } } // write back the modified plist const newXML = etree.write({ encoding: 'utf-8', indent: 2, }); try { await writeFile(stringXmlPath, newXML, { encoding: 'utf-8' }); } catch (e) { this.env.log.error(`Changes to string.xml could not be written.`); this.printStringXmlInstructions(options); } this.env.log.ok(`cordova-plugin-ionic variables correctly added to the Android project`); return true; } protected async preRunCheckInputs(options: CommandLineOptions): Promise { const updateMethodList: string[] = ['auto', 'background', 'none']; const defaultUpdateMethod = 'background'; // handle the app-id option in case the user wants to override it if (!options['app-id'] && this.env.flags.interactive) { const appId = await this.getAppId(); if (!appId) { this.env.log.warn( `No app ID found in the project.\n` + `Consider running ${input('ionic link')} to connect local apps to Ionic.\n` ); } const appIdOption = await this.env.prompt({ type: 'input', name: 'app-id', message: `Appflow App ID:`, default: appId, }); options['app-id'] = appIdOption; } if (!options['channel-name'] && this.env.flags.interactive) { options['channel-name'] = await this.env.prompt({ type: 'input', name: 'channel-name', message: `Channel Name:`, validate: v => validators.required(v), }); } // validate that the update-method is allowed let overrideUpdateMethodChoice = false; if (options['update-method'] && !updateMethodList.includes(options['update-method'] as string)) { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.warn( `${input(options['update-method'] as string)} is not a valid update method.\n` + `Please choose a different value for ${input('--update-method')}. Valid update methods are: ${updateMethodList.map(m => input(m)).join(', ')}\n` ); } overrideUpdateMethodChoice = true; } if ((!options['update-method'] || overrideUpdateMethodChoice) && this.env.flags.interactive) { options['update-method'] = await this.env.prompt({ type: 'list', name: 'update-method', choices: updateMethodList, message: `Update Method:`, default: defaultUpdateMethod, validate: v => combine(validators.required, contains(updateMethodList, {}))(v), }); } // check advanced options if present if (options['max-store'] && validators.numeric(options['max-store'] as string) !== true) { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.warn( `${input(options['max-store'] as string)} is not a valid value for the maximum number of versions to store.\n` + `Please specify an integer for ${input('--max-store')}.\n` ); } options['max-store'] = await this.env.prompt({ type: 'input', name: 'max-store', message: `Max Store:`, validate: v => combine(validators.required, validators.numeric)(v), }); } if (options['min-background-duration'] && validators.numeric(options['min-background-duration'] as string) !== true) { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.warn( `${input(options['min-background-duration'] as string)} is not a valid value for the number of seconds to wait before checking for updates in the background.\n` + `Please specify an integer for ${input('--min-background-duration')}.\n` ); } options['min-background-duration'] = await this.env.prompt({ type: 'input', name: 'min-background-duration', message: `Min Background Duration:`, validate: v => combine(validators.required, validators.numeric)(v), }); } if (options['update-api'] && validators.url(options['update-api'] as string) !== true) { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.warn( `${input(options['update-api'] as string)} is not a valid value for the URL of the API to use.\n` + `Please specify a valid URL for ${input('--update-api')}.\n` ); } options['update-api'] = await this.env.prompt({ type: 'input', name: 'update-api', message: `Update Url:`, validate: v => combine(validators.required, validators.url)(v), }); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/index.ts000066400000000000000000000022241425441362600270040ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { strong } from '../../lib/color'; import { CommandMap, Namespace } from '../../lib/namespace'; export class DeployNamespace extends Namespace { async getMetadata() { return { name: 'deploy', summary: 'Appflow Deploy functionality', description: ` These commands integrate with Ionic Appflow to configure the deploy plugin in your project and run remote builds. Appflow deploy documentation: - Overview: ${strong('https://ion.link/appflow-deploy-docs')} `, groups: [MetadataGroup.PAID], }; } async getCommands(): Promise { return new CommandMap([ ['add', async () => { const { AddCommand } = await import('./add'); return new AddCommand(this); }], ['configure', async () => { const { ConfigureCommand } = await import('./configure'); return new ConfigureCommand(this); }], ['build', async () => { const { BuildCommand } = await import('./build'); return new BuildCommand(this); }], ['manifest', async () => { const { DeployManifestCommand } = await import('./manifest'); return new DeployManifestCommand(this); }], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/deploy/manifest.ts000066400000000000000000000126551425441362600275140ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { LOGGER_LEVELS } from '@ionic/cli-framework-output'; import { map } from '@ionic/utils-array'; import { pathExists, readdirp, stat, writeFile } from '@ionic/utils-fs'; import { prettyPath } from '@ionic/utils-terminal'; import * as crypto from 'crypto'; import * as fs from 'fs'; import lodash = require('lodash'); import * as path from 'path'; import * as Debug from 'debug'; import { CommandMetadata } from '../../definitions'; import { input } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { prependNodeModulesBinToPath, Shell } from '../../lib/shell'; import { createDefaultLoggerHandlers, Logger } from '../../lib/utils/logger'; import { CapacitorCLIConfig, CapacitorConfig, CapacitorJSONConfig } from './capacitor'; import { DeployCoreCommand } from './core'; const debug = Debug('ionic:commands:deploy:manifest'); const CAPACITOR_CONFIG_JSON_FILE = 'capacitor.config.json'; interface DeployManifestItem { href: string; size: number; integrity: string; } export class DeployManifestCommand extends DeployCoreCommand { async getMetadata(): Promise { // This command is set as type 'global' in order to support Capacitor apps without an ionic.config.json return { name: 'manifest', type: 'global', summary: 'Generates a manifest file for the deploy service from a built app directory', groups: [MetadataGroup.PAID], }; } async run(): Promise { const capacitorConfig = await this.getCapacitorConfig(); if (!this.project && !capacitorConfig) { throw new FatalException(`Cannot run ${input('ionic deploy manifest')} outside a project directory.`); } let buildDir: string; if (this.project) { await this.requireNativeIntegration(); buildDir = await this.project.getDistDir(); } else { buildDir = capacitorConfig!.webDir ? capacitorConfig!.webDir : 'www'; } const manifest = await this.getFilesAndSizesAndHashesForGlobPattern(buildDir); const manifestPath = path.resolve(buildDir, 'pro-manifest.json'); await writeFile(manifestPath, JSON.stringify(manifest, undefined, 2), { encoding: 'utf8' }); this.env.log.ok(`Appflow Deploy manifest written to ${input(prettyPath(manifestPath))}!`); } private async getFilesAndSizesAndHashesForGlobPattern(buildDir: string): Promise { const contents = await readdirp(buildDir, { filter: item => !/(css|js)\.map$/.test(item.path) }); const stats = await map(contents, async (f): Promise<[string, fs.Stats]> => [f, await stat(f)]); const files = stats.filter(([ , s ]) => !s.isDirectory()); const items = await Promise.all(files.map(([f, s]) => this.getFileAndSizeAndHashForFile(buildDir, f, s))); return items.filter(item => item.href !== 'pro-manifest.json'); } private async getFileAndSizeAndHashForFile(buildDir: string, file: string, s: fs.Stats): Promise { const buffer = await this.readFile(file); return { href: path.relative(buildDir, file), size: s.size, integrity: this.getIntegrity(buffer), }; } private async readFile(file: string): Promise { return new Promise((resolve, reject) => { fs.readFile(file, (err, buffer) => { if (err) { return reject(err); } resolve(buffer); }); }); } private getIntegrity(data: Buffer) { return ['sha256', 'sha384', 'sha512'] .map(algorithm => { const hash = crypto.createHash(algorithm); hash.update(data); return algorithm + '-' + hash.digest('base64'); }) .join(' '); } private getCapacitorConfigJsonPath(): string { return path.resolve(this.env.ctx.execPath, CAPACITOR_CONFIG_JSON_FILE); } private getCapacitorCLIConfig = lodash.memoize(async (): Promise => { // I had to create a new shell to force prependNodeModulesBinToPath. // If ionic.config.json is not present, then this.env.shell will not implement this, and the Capacitor command will fail. const args = ['config', '--json']; const log = new Logger({ level: LOGGER_LEVELS.INFO, handlers: createDefaultLoggerHandlers(), }); const shell = new Shell({ log }, { alterPath: p => { return prependNodeModulesBinToPath(this.env.ctx.execPath, p)} }); debug('Getting config with Capacitor CLI: %O', args); const output = await shell.cmdinfo('capacitor', args); if (!output) { debug('Could not get config from Capacitor CLI (probably old version)'); return; } try { return JSON.parse(output); } catch(e) { debug('Could not get config from Capacitor CLI (probably old version)', e); return; } }); private getCapacitorConfig = lodash.memoize(async (): Promise => { const cli = await this.getCapacitorCLIConfig(); if (cli) { debug('Loaded Capacitor config!'); return cli.app.extConfig; } // fallback to reading capacitor.config.json if it exists const confPath = this.getCapacitorConfigJsonPath(); if (!(await pathExists(confPath))) { debug('Capacitor config file does not exist at %O', confPath); debug('Failed to load Capacitor config'); return; } const conf = new CapacitorJSONConfig(confPath); const extConfig = conf.c; debug('Loaded Capacitor config!'); return extConfig; }); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/docs.ts000066400000000000000000000031771425441362600253410ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { isSuperAgentError } from '../guards'; import { input } from '../lib/color'; import { Command } from '../lib/command'; import { openUrl } from '../lib/open'; import { BROWSERS } from '../lib/serve'; import { createRequest } from '../lib/utils/http'; export class DocsCommand extends Command { async getMetadata(): Promise { return { name: 'docs', type: 'global', summary: 'Open the Ionic documentation website', options: [ { name: 'browser', summary: `Specifies the browser to use (${BROWSERS.map(b => input(b)).join(', ')})`, aliases: ['w'], groups: [MetadataGroup.ADVANCED], }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const browser = options['browser'] ? String(options['browser']) : undefined; const homepage = 'https://ion.link/docs'; const url = this.project ? await this.project.getDocsUrl() : homepage; try { const { req } = await createRequest('HEAD', url, this.env.config.getHTTPConfig()); await req; } catch (e) { if (isSuperAgentError(e) && e.response.status === 404) { this.env.log.warn(`Docs not found for your specific version of Ionic. Directing you to docs homepage.`); await openUrl(homepage, { app: browser }); return; } throw e; } await openUrl(url, { app: browser }); this.env.log.ok('Launched Ionic docs in your browser!'); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/doctor/000077500000000000000000000000001425441362600253235ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/doctor/base.ts000066400000000000000000000051421425441362600266070ustar00rootroot00000000000000import { concurrentFilter } from '@ionic/utils-array'; import * as Debug from 'debug'; import { IAilment, IAilmentRegistry, TreatableAilment } from '../../definitions'; import { isTreatableAilment } from '../../guards'; import { failure, input, strong } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; const debug = Debug('ionic:commands:doctor:base'); export abstract class DoctorCommand extends Command { async getRegistry(): Promise { if (!this.project) { throw new FatalException(`Cannot use ${input('ionic doctor')} outside a project directory.`); } const { AilmentRegistry } = await import('../../lib/doctor'); const registry = new AilmentRegistry(); await this.project.registerAilments(registry); return registry; } async detectAilments(): Promise { const registry = await this.getRegistry(); let count = 0; const tasks = this.createTaskChain(); const isLoggedIn = this.env.session.isLoggedIn(); if (!isLoggedIn) { this.env.log.warn(`For best results, please make sure you're logged in to Ionic.\nSome issues can't be detected without authentication. Run:\n\n ${input('ionic login')}`); } const detectTask = tasks.next('Detecting issues'); const ailments = registry.ailments.filter(ailment => { if (this.env.config.get(`doctor.issues.${ailment.id}.ignored` as any)) { debug('Issue %s ignored by config', ailment.id); return false; } if (!ailment.implicit) { debug('Issue %s will not be implicitly detected', ailment.id); return false; } return true; }); const detectedAilments = await concurrentFilter(ailments, async (ailment): Promise => { let detected = false; try { detected = await ailment.detected(); debug('Detected %s: %s', ailment.id, detected); } catch (e) { this.env.log.error( `Error while checking ${strong(ailment.id)}:\n` + `${failure(e.stack ? e.stack : e)}` ); } count++; detectTask.msg = `Detecting issues: ${strong(`${count} / ${ailments.length}`)} complete`; return detected; }); detectTask.msg = `Detecting issues: ${strong(`${ailments.length} / ${ailments.length}`)} complete`; tasks.end(); return detectedAilments; } async detectTreatableAilments(): Promise { const ailments = await this.detectAilments(); return ailments.filter((ailment): ailment is TreatableAilment => isTreatableAilment(ailment)); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/doctor/check.ts000066400000000000000000000054351425441362600267570ustar00rootroot00000000000000import { contains, validate } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, IAilment } from '../../definitions'; import { isTreatableAilment } from '../../guards'; import { input, strong } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { DoctorCommand } from './base'; export class DoctorCheckCommand extends DoctorCommand { async getMetadata(): Promise { return { name: 'check', type: 'project', summary: 'Check the health of your Ionic project', description: ` This command detects and prints common issues and suggested steps to fix them. Some issues can be fixed automatically. See ${input('ionic doctor treat --help')}. Optionally supply the ${input('id')} argument to check a single issue. Use ${input('ionic doctor list')} to list all known issues. `, exampleCommands: [ '', 'git-not-used', ], inputs: [ { name: 'id', summary: 'The issue identifier', }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ id ] = inputs; if (id) { const registry = await this.getRegistry(); const ailmentIds = registry.ailments.map(a => a.id); validate(id, 'id', [contains(ailmentIds, {})]); const ailment = registry.get(id); if (!ailment) { throw new FatalException(`Issue not found by ID: ${input(id)}`); } await this.checkAilment(ailment); } else { const ailments = await this.detectAilments(); await this.checkAilments(ailments); } } async checkAilments(ailments: IAilment[]) { let treatableAilments = 0; if (ailments.length > 0) { for (const ailment of ailments) { if (isTreatableAilment(ailment)) { treatableAilments += 1; } await this.checkAilment(ailment); } } const msg = ( 'Doctor Summary\n' + `- Detected ${strong(String(ailments.length))} issue${ailments.length === 1 ? '' : 's'}.` + `${ailments.length === 0 ? ' Aww yeah! 💪' : ''}\n` + `- ${strong(String(treatableAilments))} issue${treatableAilments === 1 ? '' : 's'} can be fixed automatically${treatableAilments > 0 ? ` by running: ${input('ionic doctor fix')}` : ''}` ); if (ailments.length > 0) { this.env.log.info(msg); throw new FatalException(''); // exit 1 } else { this.env.log.ok(msg); } } async checkAilment(ailment: IAilment) { const { formatAilmentMessage } = await import('../../lib/doctor'); if (await ailment.detected()) { this.env.log.warn(await formatAilmentMessage(ailment)); } else { this.env.log.ok(`${input(ailment.id)} was not detected.`); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/doctor/index.ts000066400000000000000000000014661425441362600270110ustar00rootroot00000000000000import { CommandMap, Namespace } from '../../lib/namespace'; export class DoctorNamespace extends Namespace { async getMetadata() { return { name: 'doctor', summary: 'Commands for checking the health of your Ionic project', }; } async getCommands(): Promise { return new CommandMap([ ['check', async () => { const { DoctorCheckCommand } = await import('./check'); return new DoctorCheckCommand(this); }], ['treat', async () => { const { DoctorTreatCommand } = await import('./treat'); return new DoctorTreatCommand(this); }], ['list', async () => { const { DoctorListCommand } = await import('./list'); return new DoctorListCommand(this); }], ['ls', 'list'], ['checkup', 'check'], ['validate', 'check'], ['fix', 'treat'], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/doctor/list.ts000066400000000000000000000041221425441362600266450ustar00rootroot00000000000000import { strcmp } from '@ionic/cli-framework/utils/string'; import { columnar } from '@ionic/utils-terminal'; import { COLUMNAR_OPTIONS } from '../../constants'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { isTreatableAilment } from '../../guards'; import { input, strong } from '../../lib/color'; import { DoctorCommand } from './base'; export class DoctorListCommand extends DoctorCommand { async getMetadata(): Promise { return { name: 'list', type: 'project', summary: 'List all issues and their identifiers', description: ` Issues can have various tags: - ${strong('treatable')}: ${input('ionic doctor treat')} can attempt to fix the issue - ${strong('ignored')}: configured not to be detected in ${input('ionic doctor check')} or ${input('ionic doctor treat')} - ${strong('explicit-detection')}: issue is only detected explicitly with ${input('ionic doctor check ')} You can flip whether an issue is ignored or not by using ${input('ionic config set -g doctor.issues..ignored true/false')}, where ${input('')} matches an ID listed with this command. `, }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const registry = await this.getRegistry(); const rows = registry.ailments.map(ailment => { const tags: string[] = []; const ignored = this.env.config.get(`doctor.issues.${ailment.id}.ignored` as any); if (ignored) { tags.push('ignored'); } if (isTreatableAilment(ailment)) { tags.push('treatable'); } if (!ailment.implicit) { tags.push('explicit-detection'); } return [ input(ailment.id), ailment.projects ? ailment.projects.map(t => strong(t)).join(', ') : 'all', tags.map(t => strong(t)).join(', '), ]; }); rows.sort((row1, row2) => strcmp(row1[0], row2[0])); this.env.log.rawmsg(columnar(rows, { ...COLUMNAR_OPTIONS, headers: ['id', 'affected projects', 'tags'].map(h => strong(h)) })); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/doctor/treat.ts000066400000000000000000000122031425441362600270100ustar00rootroot00000000000000import { contains, validate } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, TreatableAilment } from '../../definitions'; import { isExitCodeException, isTreatableAilment } from '../../guards'; import { input, strong } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { DoctorCommand } from './base'; const ERROR_AILMENT_IGNORED = 'AILMENT_IGNORED'; const ERROR_AILMENT_SKIPPED = 'AILMENT_SKIPPED'; export class DoctorTreatCommand extends DoctorCommand { async getMetadata(): Promise { return { name: 'treat', type: 'project', summary: 'Attempt to fix issues in your Ionic project', description: ` This command detects and attempts to fix common issues. Before a fix is attempted, the steps are printed and a confirmation prompt is displayed. Optionally supply the ${input('id')} argument to attempt to fix a single issue. Use ${input('ionic doctor list')} to list all known issues. `, exampleCommands: [ '', 'git-not-used', ], inputs: [ { name: 'id', summary: 'The issue identifier', }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { formatAilmentMessage } = await import('../../lib/doctor'); const [ id ] = inputs; if (id) { const registry = await this.getRegistry(); const ailmentIds = registry.ailments.map(a => a.id); validate(id, 'id', [contains(ailmentIds, {})]); const ailment = registry.get(id); if (!ailment) { throw new FatalException(`Issue not found by ID: ${input(id)}`); } const detected = await ailment.detected(); if (!detected) { this.env.log.ok(`${input(ailment.id)} does not need fixing as it was not detected.`); return; } if (!isTreatableAilment(ailment)) { this.env.log.warn(await formatAilmentMessage(ailment)); throw new FatalException( `Issue cannot be fixed automatically: ${input(ailment.id)}\n` + `Unfortunately the CLI can't automatically fix the specified issue at this time. However, please see the steps above for manually fixing the issue.` ); } if (this.env.config.get(`doctor.issues.${ailment.id}.ignored` as any)) { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `${input(ailment.id)} is ignored, are you sure you want to continue?`, }); if (!confirm) { return; } this.env.config.unset(`doctor.issues.${ailment.id}.ignored` as any); } try { await this.treatAilment(ailment); } catch (e) { this.handleError(e); } } else { const ailments = await this.detectTreatableAilments(); await this.treatAilments(ailments); } } async treatAilments(ailments: TreatableAilment[]) { let treatedAilments = 0; for (const ailment of ailments) { try { const treated = await this.treatAilment(ailment); if (treated) { treatedAilments += 1; } } catch (e) { this.handleError(e); } } this.env.log.info( 'Doctor Summary\n' + `- Detected ${strong(String(ailments.length))} treatable issue${ailments.length === 1 ? '' : 's'}\n` + (treatedAilments > 0 ? `- ${strong(String(treatedAilments))} ${treatedAilments === 1 ? 'issue was' : 'issues were'} fixed automatically` : '') ); } handleError(e: any) { if (e !== ERROR_AILMENT_SKIPPED && e !== ERROR_AILMENT_IGNORED) { if (isExitCodeException(e)) { this.env.log.error(`Error occurred during automatic fix: ${e.message}`); } else { this.env.log.error(`Error occurred during automatic fix: ${e.stack ? e.stack : e}`); } } } async treatAilment(ailment: TreatableAilment) { const { formatAilmentMessage } = await import('../../lib/doctor'); const treatmentSteps = await ailment.getTreatmentSteps(); this.env.log.warn(await formatAilmentMessage(ailment)); const CHOICE_YES = 'yes'; const CHOICE_NO = 'no'; const CHOICE_IGNORE = 'ignore'; const choice = await this.env.prompt({ type: 'list', name: 'choice', message: `Fix automatically?`, choices: [ { name: 'Yes', value: CHOICE_YES, }, { name: 'No', value: CHOICE_NO, }, { name: 'Ignore forever', value: CHOICE_IGNORE, }, ], }); if (choice === CHOICE_YES) { for (const i in treatmentSteps) { const step = treatmentSteps[i]; try { await step.treat(); } catch (e) { if (!isExitCodeException(e) || e.exitCode > 0) { throw e; } } } return true; } else if (choice === CHOICE_NO) { throw ERROR_AILMENT_SKIPPED; } else if (choice === CHOICE_IGNORE) { this.env.config.set(`doctor.issues.${ailment.id}.ignored` as any, true); throw ERROR_AILMENT_IGNORED; } return false; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/enterprise/000077500000000000000000000000001425441362600262115ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/enterprise/index.ts000066400000000000000000000015251425441362600276730ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandMap, Namespace } from '../../lib/namespace'; export class EnterpriseNamespace extends Namespace { async getMetadata() { return { name: 'enterprise', summary: 'Manage Ionic Enterprise features', description: ` Commands to help manage Ionic Enterprise[^enterprise-edition] subscriptions. `, footnotes: [ { id: 'enterprise-edition', url: 'https://ionicframework.com/enterprise-edition', shortUrl: 'https://ion.link/enterprise', }, ], groups: [MetadataGroup.PAID], }; } async getCommands(): Promise { return new CommandMap([ ['register', async () => { const { RegisterCommand } = await import('./register'); return new RegisterCommand(this); }], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/enterprise/register.ts000066400000000000000000000027731425441362600304160ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { runCommand } from '../../lib/executor'; export class RegisterCommand extends Command { async getMetadata(): Promise { return { name: 'register', type: 'project', groups: [MetadataGroup.PAID], summary: 'Register your Product Key with this app', options: [ { name: 'app-id', summary: 'The Ionic App ID', spec: { value: 'id', }, }, { name: 'key', summary: 'The Product Key', }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic enterprise register')} outside a project directory.`); } const appId = options['app-id'] ? String(options['app-id']) : undefined; const key = options['key'] ? String(options['key']) : undefined; const extra = ['--']; if (key) { extra.push('--key', key); } if (appId) { extra.push('--app-id', appId); } await runCommand(runinfo, ['integrations', 'enable', 'enterprise', ...extra.length > 1 ? extra : [] ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/generate.ts000066400000000000000000000045261425441362600262020ustar00rootroot00000000000000import { Footnote, MetadataGroup } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataInput, CommandMetadataOption, CommandPreRun } from '../definitions'; import { failure, input, strong } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; import { prettyProjectName } from '../lib/project'; export class GenerateCommand extends Command implements CommandPreRun { async getMetadata(): Promise { const inputs: CommandMetadataInput[] = []; const options: CommandMetadataOption[] = []; const exampleCommands = ['']; const footnotes: Footnote[] = []; const groups: string[] = []; let description = this.project ? failure(`Generators are not supported in this project type (${strong(prettyProjectName(this.project.type))}).`) : failure('Generators help is available within an Ionic project directory.'); const runner = this.project && await this.project.getGenerateRunner(); if (runner) { const libmetadata = await runner.getCommandMetadata(); groups.push(...libmetadata.groups || []); inputs.push(...libmetadata.inputs || []); options.push(...libmetadata.options || []); description = (libmetadata.description || '').trim(); footnotes.push(...libmetadata.footnotes || []); exampleCommands.push(...libmetadata.exampleCommands || []); } else { groups.push(MetadataGroup.HIDDEN); } return { name: 'generate', type: 'project', summary: 'Create Pages, Components, & Angular Features', description, footnotes, inputs, options, groups, exampleCommands, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const runner = this.project && await this.project.getGenerateRunner(); if (runner) { await runner.ensureCommandLine(inputs, options); } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic generate')} outside a project directory.`); } const runner = await this.project.requireGenerateRunner(); const opts = runner.createOptionsFromCommandLine(inputs, options); await runner.run(opts); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/git/000077500000000000000000000000001425441362600246145ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/git/clone.ts000066400000000000000000000027621425441362600262730ustar00rootroot00000000000000import { MetadataGroup, validators } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { Command } from '../../lib/command'; // import { formatGitRepoUrl } from '../../lib/git'; export class GitCloneCommand extends Command { async getMetadata(): Promise { return { name: 'clone', type: 'global', summary: 'Clones an Ionic app git repository to your computer', inputs: [ { name: 'id', summary: 'The ID of the Ionic Appflow app to clone', validators: [validators.required], }, { name: 'path', summary: 'The destination directory of the cloned app', }, ], groups: [MetadataGroup.HIDDEN], // TODO: make part of start? }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { // let [ id, destination ] = inputs; // const appLoader = new App(this.env.session.getUserToken(), this.env.client); // const app = await appLoader.load(id); // const remote = await formatGitRepoUrl(this.env.config, app.id); // if (!destination) { // destination = app.slug ? app.slug : app.id; // } // destination = path.resolve(destination); // await this.env.shell.run('git', ['clone', '-o', 'ionic', remote, destination], { stdio: 'inherit' }); // this.env.log.ok(`Your app has been cloned to ${strong(prettyPath(destination))}!`); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/git/index.ts000066400000000000000000000012241425441362600262720ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandMap, Namespace } from '../../lib/namespace'; export class GitNamespace extends Namespace { async getMetadata() { return { name: 'git', summary: 'Commands relating to managing Appflow git', groups: [MetadataGroup.PAID], }; } async getCommands(): Promise { return new CommandMap([ ['clone', async () => { const { GitCloneCommand } = await import('./clone'); return new GitCloneCommand(this); }], ['remote', async () => { const { GitRemoteCommand } = await import('./remote'); return new GitRemoteCommand(this); }], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/git/remote.ts000066400000000000000000000055011425441362600264600ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input, strong } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; export class GitRemoteCommand extends Command { async getMetadata(): Promise { const dashUrl = this.env.config.getDashUrl(); return { name: 'remote', type: 'project', groups: [MetadataGroup.PAID], summary: 'Adds/updates the Appflow git remote to your local Ionic app', description: ` This command is used by ${input('ionic link')} when Appflow is used as the git host. ${input('ionic git remote')} will check the local repository for whether or not the git remote is properly set up. This command operates on the ${strong('ionic')} remote. For advanced configuration, see ${strong('Settings')} => ${strong('Git')} in the app settings of the Dashboard[^dashboard]. `, footnotes: [ { id: 'dashboard', url: dashUrl, }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { AppClient } = await import('../../lib/app'); const { addIonicRemote, getIonicRemote, initializeRepo, isRepoInitialized, setIonicRemote } = await import('../../lib/git'); if (!this.project) { throw new FatalException(`Cannot run ${input('ionic git remote')} outside a project directory.`); } const token = await this.env.session.getUserToken(); const id = await this.project.requireAppflowId(); const appClient = new AppClient(token, this.env); const app = await appClient.load(id); if (!app.repo_url) { throw new FatalException(`Missing ${strong('repo_url')} property in app.`); } if (!(await isRepoInitialized(this.project.directory))) { await initializeRepo({ shell: this.env.shell }, this.project.directory); this.env.log.warn( `Initializing a git repository for your project.\n` + `Before your first ${input('git push ionic master')}, you'll want to commit all the files in your project:\n\n` + `${input('git commit -a -m "Initial commit"')}\n` ); } const remote = app.repo_url; const found = await getIonicRemote({ shell: this.env.shell }, this.project.directory); if (found) { if (remote === found) { this.env.log.msg(`Existing remote ${strong('ionic')} found.`); } else { await setIonicRemote({ shell: this.env.shell }, this.project.directory, remote); this.env.log.ok(`Updated remote ${strong('ionic')}.`); } } else { await addIonicRemote({ shell: this.env.shell }, this.project.directory, remote); this.env.log.ok(`Added remote ${strong('ionic')}.`); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/help.ts000066400000000000000000000042551425441362600253370ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { isCommand } from '../guards'; import { input } from '../lib/color'; import { Command } from '../lib/command'; export class HelpCommand extends Command { async getMetadata(): Promise { return { name: 'help', type: 'global', summary: 'Provides help for a certain command', exampleCommands: ['start'], inputs: [ { name: 'command', summary: 'The command you desire help with', }, ], options: [ { name: 'json', summary: 'Print help in JSON format', type: Boolean, }, ], groups: [MetadataGroup.HIDDEN], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { CommandSchemaHelpFormatter, CommandStringHelpFormatter, NamespaceSchemaHelpFormatter, NamespaceStringHelpFormatter } = await import('../lib/help'); const location = await this.namespace.locate(inputs); if (isCommand(location.obj)) { const formatterOptions = { location, command: location.obj }; const formatter = options['json'] ? new CommandSchemaHelpFormatter(formatterOptions) : new CommandStringHelpFormatter(formatterOptions); this.env.log.rawmsg(await formatter.format()); } else { if (location.args.length > 0) { this.env.log.error( `Unable to find command: ${input(inputs.join(' '))}` + (this.project ? '' : '\nYou may need to be in an Ionic project directory.') ); } const now = new Date(); const version = this.env.ctx.version; const suffix = now.getMonth() === 9 && now.getDate() === 31 ? ' 🎃' : ''; const formatterOptions = { inProject: this.project ? true : false, version: version + suffix, location, namespace: location.obj, }; const formatter = options['json'] ? new NamespaceSchemaHelpFormatter(formatterOptions) : new NamespaceStringHelpFormatter(formatterOptions); this.env.log.rawmsg(await formatter.format()); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/index.ts000066400000000000000000000120271425441362600255120ustar00rootroot00000000000000import { IProject, IonicEnvironment } from '../definitions'; import { CommandMap, Namespace, NamespaceMap } from '../lib/namespace'; export interface IonicEnvironmentDeps { readonly env: IonicEnvironment; readonly project?: IProject; } export class IonicNamespace extends Namespace { protected _env: IonicEnvironment; protected _project: IProject | undefined; constructor({ env, project }: IonicEnvironmentDeps) { super(undefined); this._env = env; this._project = project; } get project(): IProject | undefined { return this._project; } set project(p: IProject | undefined) { this._project = p; } get env(): IonicEnvironment { return this._env; } set env(env: IonicEnvironment) { this._env = env; } async getMetadata() { return { name: 'ionic', summary: '', }; } async getNamespaces(): Promise { return new NamespaceMap([ ['config', async () => { const { ConfigNamespace } = await import('./config/index'); return new ConfigNamespace(this); }], ['cordova', async () => { const { CordovaNamespace } = await import('./cordova/index'); return new CordovaNamespace(this); }], ['capacitor', async () => { const { CapacitorNamespace } = await import('./capacitor/index'); return new CapacitorNamespace(this); }], ['deploy', async () => { const { DeployNamespace } = await import('./deploy/index'); return new DeployNamespace(this); }], ['git', async () => { const { GitNamespace } = await import('./git/index'); return new GitNamespace(this); }], ['package', async () => { const { PackageNamespace } = await import('./package/index'); return new PackageNamespace(this); }], ['ssl', async () => { const { SSLNamespace } = await import('./ssl/index'); return new SSLNamespace(this); }], ['ssh', async () => { const { SSHNamespace } = await import('./ssh/index'); return new SSHNamespace(this); }], ['monitoring', async () => { const { MonitoringNamespace } = await import('./monitoring/index'); return new MonitoringNamespace(this); }], ['doctor', async () => { const { DoctorNamespace } = await import('./doctor/index'); return new DoctorNamespace(this); }], ['integrations', async () => { const { IntegrationsNamespace } = await import('./integrations/index'); return new IntegrationsNamespace(this); }], ['enterprise', async () => { const { EnterpriseNamespace } = await import('./enterprise/index'); return new EnterpriseNamespace(this); }], ['cap', 'capacitor'], ['cdv', 'cordova'], ['i', 'integrations'], ['integration', 'integrations'], ]); } async getCommands(): Promise { return new CommandMap([ ['build', async () => { const { BuildCommand } = await import('./build'); return new BuildCommand(this); }], ['completion', async () => { const { CompletionCommand } = await import('./completion'); return new CompletionCommand(this); }], ['docs', async () => { const { DocsCommand } = await import('./docs'); return new DocsCommand(this); }], ['generate', async () => { const { GenerateCommand } = await import('./generate'); return new GenerateCommand(this); }], ['help', async () => { const { HelpCommand } = await import('./help'); return new HelpCommand(this); }], ['info', async () => { const { InfoCommand } = await import('./info'); return new InfoCommand(this); }], ['init', async () => { const { InitCommand } = await import('./init'); return new InitCommand(this); }], ['ionitron', async () => { const { IonitronCommand } = await import('./ionitron'); return new IonitronCommand(this); }], ['link', async () => { const { LinkCommand } = await import('./link'); return new LinkCommand(this); }], ['login', async () => { const { LoginCommand } = await import('./login'); return new LoginCommand(this); }], ['logout', async () => { const { LogoutCommand } = await import('./logout'); return new LogoutCommand(this); }], ['repair', async () => { const { RepairCommand } = await import('./repair'); return new RepairCommand(this); }], ['serve', async () => { const { ServeCommand } = await import('./serve'); return new ServeCommand(this); }], ['share', async () => { const { ShareCommand } = await import('./share'); return new ShareCommand(this); }], ['signup', async () => { const { SignupCommand } = await import('./signup'); return new SignupCommand(this); }], ['start', async () => { const { StartCommand } = await import('./start'); return new StartCommand(this); }], ['state', async () => { const { StateCommand } = await import('./state'); return new StateCommand(this); }], ['telemetry', async () => { const { TelemetryCommand } = await import('./telemetry'); return new TelemetryCommand(this); }], ['version', async () => { const { VersionCommand } = await import('./version'); return new VersionCommand(this); }], ['lab', async () => { const { LabCommand } = await import('./serve'); return new LabCommand(this); }], ['g', 'generate'], ['s', 'serve'], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/info.ts000066400000000000000000000053201425441362600253340ustar00rootroot00000000000000import { strcmp } from '@ionic/cli-framework/utils/string'; import { columnar } from '@ionic/utils-terminal'; import * as lodash from 'lodash'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, InfoItem, InfoItemGroup } from '../definitions'; import { input, strong, weak } from '../lib/color'; import { Command } from '../lib/command'; const INFO_GROUPS: readonly InfoItemGroup[] = ['ionic', 'capacitor', 'cordova', 'utility', 'system', 'environment']; export class InfoCommand extends Command { async getMetadata(): Promise { return { name: 'info', type: 'global', summary: 'Print project, system, and environment information', description: ` This command is an easy way to share information about your setup. If applicable, be sure to run ${input('ionic info')} within your project directory to display even more information. `, options: [ { name: 'json', summary: 'Print system/environment info in JSON format', type: Boolean, }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { json } = options; const items = (await this.env.getInfo()).filter(item => item.hidden !== true); if (json) { process.stdout.write(JSON.stringify(items)); } else { const groupedInfo: Map = new Map( INFO_GROUPS.map((group): [typeof group, InfoItem[]] => [group, items.filter(item => item.group === group)]) ); const sortInfo = (a: InfoItem, b: InfoItem): number => { if (a.name[0] === '@' && b.name[0] !== '@') { return 1; } if (a.name[0] !== '@' && b.name[0] === '@') { return -1; } return strcmp(a.name.toLowerCase(), b.name.toLowerCase()); }; const projectPath = this.project && this.project.directory; const splitInfo = (ary: InfoItem[]) => ary .sort(sortInfo) .map((item): [string, string] => [` ${item.name}${item.flair ? ' ' + weak('(' + item.flair + ')') : ''}`, weak(item.value) + (item.path && projectPath && !item.path.startsWith(projectPath) ? ` ${weak('(' + item.path + ')')}` : '')]); const format = (details: [string, string][]) => columnar(details, { vsep: ':' }); if (!projectPath) { this.env.log.warn('You are not in an Ionic project directory. Project context may be missing.'); } this.env.log.nl(); for (const [ group, info ] of groupedInfo.entries()) { if (info.length > 0) { this.env.log.rawmsg(`${strong(`${lodash.startCase(group)}:`)}\n\n`); this.env.log.rawmsg(`${format(splitInfo(info))}\n\n`); } } } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/init.ts000066400000000000000000000202601425441362600253440ustar00rootroot00000000000000import { MetadataGroup, validators } from '@ionic/cli-framework'; import { slugify } from '@ionic/cli-framework/utils/string'; import { prettyPath } from '@ionic/utils-terminal'; import * as path from 'path'; import { MODERN_PROJECT_TYPES, PROJECT_FILE } from '../constants'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, IProject, ProjectType } from '../definitions'; import { input, strong, weak } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; import { MultiProjectConfig, ProjectDetails, createProjectFromDetails, prettyProjectName } from '../lib/project'; export class InitCommand extends Command { async getMetadata(): Promise { return { name: 'init', type: 'global', summary: 'Initialize existing projects with Ionic', description: ` This command will initialize an Ionic app within the current directory. Usually, this means an ${input(PROJECT_FILE)} file is created. If used within a multi-app project, the app is initialized in the root ${input(PROJECT_FILE)}. ${input('ionic init')} will prompt for a project name and then proceed to determine the type of your project. You can specify the ${input('name')} argument and ${input('--type')} option to provide these values via command-line. If the ${input('--multi-app')} flag is specified, this command will initialize your project as a multi-app project, allowing for apps within monorepos and unconventional repository structures. See the multi-app docs[^multi-app-docs] for details. Once a multi-app project is initialized, you can run ${input('ionic init')} again within apps in your project to initialize them. `, exampleCommands: [ '', '"My App"', '"My App" --type=angular', '--multi-app', ], inputs: [ { name: 'name', summary: `The name of your project (e.g. ${input('myApp')}, ${input('"My App"')})`, }, ], options: [ { name: 'type', summary: `Type of project (e.g. ${MODERN_PROJECT_TYPES.map(type => input(type)).join(', ')})`, }, { name: 'force', summary: 'Initialize even if a project already exists', type: Boolean, aliases: ['f'], default: false, }, { name: 'multi-app', summary: 'Initialize a multi-app project', type: Boolean, default: false, }, { name: 'project-id', summary: 'Specify a slug for your app', groups: [MetadataGroup.ADVANCED], spec: { value: 'slug' }, hint: weak('[multi-app]'), }, { name: 'default', summary: 'Mark the initialized app as the default project', type: Boolean, groups: [MetadataGroup.ADVANCED], hint: weak('[multi-app]'), }, ], groups: [MetadataGroup.BETA], footnotes: [ { id: 'multi-app-docs', url: 'https://ionicframework.com/docs/cli/configuration#multi-app-projects', shortUrl: 'https://ion.link/multi-app-docs', }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const force = options['force'] ? true : false; if (this.project && !force) { // TODO: check for existing project config in multi-app if (this.project.details.context === 'app' || (this.project.details.context === 'multiapp' && options['multi-app'])) { throw new FatalException( `Existing Ionic project file found: ${strong(prettyPath(this.project.filePath))}\n` + `You can re-initialize your project using the ${input('--force')} option.` ); } } if (!options['multi-app']) { if (!inputs[0]) { const name = await this.env.prompt({ type: 'input', name: 'name', message: 'Project name:', validate: v => validators.required(v), }); inputs[0] = name; } if (!options['type']) { const details = new ProjectDetails({ rootDirectory: this.env.ctx.execPath, e: this.env }); options['type'] = await details.getTypeFromDetection(); } if (!options['type']) { if (this.env.flags.interactive) { this.env.log.warn( `Could not determine project type.\n` + `Please choose a project type from the list.` ); this.env.log.nl(); } const type = await this.env.prompt({ type: 'list', name: 'type', message: 'Project type:', choices: MODERN_PROJECT_TYPES.map(t => ({ name: `${prettyProjectName(t)} (${input(t)})`, value: t, })), }); options['type'] = type; } } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (options['multi-app']) { await this.initializeMultiProject(inputs, options); } else { await this.initializeApp(inputs, options); } this.env.log.ok('Your Ionic project has been initialized!'); } async initializeMultiProject(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const configPath = this.getProjectFilePath(); const config = new MultiProjectConfig(configPath); config.c = { projects: {} }; } async initializeApp(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const name = inputs[0] ? inputs[0].trim() : ''; const type = options['type'] ? String(options['type']) as ProjectType : undefined; const projectId = options['project-id'] ? String(options['project-id']) : slugify(name); // TODO validate --project-id if (!name) { throw new FatalException( `Project name not specified.\n` + `Please specify ${input('name')}, the first argument of ${input('ionic init')}. See ${input('ionic init --help')} for details.` ); } if (!type) { throw new FatalException( `Could not determine project type.\n` + `Please specify ${input('--type')}. See ${input('ionic init --help')} for details.` ); } let project: IProject | undefined; if (this.project && this.project.details.context === 'multiapp') { const configPath = path.resolve(this.project.rootDirectory, PROJECT_FILE); const projectRoot = path.relative(this.project.rootDirectory, this.env.ctx.execPath); const config = new MultiProjectConfig(configPath); if (!projectRoot) { if (this.env.flags.interactive) { this.env.log.warn( `About to initialize app in the root directory of your multi-app project.\n` + `Please confirm that you want your app initialized in the root of your multi-app project. If this wasn't intended, please ${input('cd')} into the appropriate directory and run ${input('ionic init')} again.\n` ); } const confirm = await this.env.prompt({ type: 'confirm', message: 'Continue?', default: false, }); if (!confirm) { throw new FatalException(`Not initializing app in root directory.`); } } const defaultProject = config.get('defaultProject'); if (!defaultProject && typeof options['default'] !== 'boolean') { const confirm = await this.env.prompt({ type: 'confirm', message: `Would you like to make this app the default project?`, default: true, }); if (confirm) { options['default'] = true; } } if (options['default']) { config.set('defaultProject', projectId); } project = await createProjectFromDetails({ context: 'multiapp', configPath, id: projectId, type, errors: [] }, this.env); project.config.set('root', projectRoot); } else { const configPath = this.getProjectFilePath(); project = await createProjectFromDetails({ context: 'app', configPath, type, errors: [] }, this.env); } project.config.set('name', name); project.config.set('type', type); } getProjectFilePath(): string { return path.resolve(this.env.ctx.execPath, PROJECT_FILE); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/integrations/000077500000000000000000000000001425441362600265375ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/integrations/disable.ts000066400000000000000000000034661425441362600305230ustar00rootroot00000000000000import { BaseError, contains, validators } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { isIntegrationName } from '../../guards'; import { input } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { INTEGRATION_NAMES } from '../../lib/integrations'; export class IntegrationsDisableCommand extends Command { async getMetadata(): Promise { return { name: 'disable', type: 'project', summary: 'Disable an integration', description: ` Integrations, such as Cordova, can be disabled with this command. `, inputs: [ { name: 'name', summary: `The integration to disable (e.g. ${INTEGRATION_NAMES.map(i => input(i)).join(', ')})`, validators: [validators.required, contains(INTEGRATION_NAMES, {})], }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ name ] = inputs; if (!this.project) { throw new FatalException(`Cannot run ${input('ionic integrations disable')} outside a project directory.`); } if (!isIntegrationName(name)) { throw new FatalException(`Don't know about ${input(name)} integration!`); } const integration = await this.project.createIntegration(name); try { if (!integration.isAdded() || !integration.isEnabled()) { this.env.log.info(`Integration ${input(name)} already disabled.`); } else { await integration.disable(); this.env.log.ok(`Integration ${input(name)} disabled!`); } } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/integrations/enable.ts000066400000000000000000000064121425441362600303400ustar00rootroot00000000000000import { BaseError, contains, validators } from '@ionic/cli-framework'; import * as path from 'path'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { isIntegrationName } from '../../guards'; import { input } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { INTEGRATION_NAMES } from '../../lib/integrations'; export class IntegrationsEnableCommand extends Command { async getMetadata(): Promise { return { name: 'enable', type: 'project', summary: 'Add & enable integrations to your app', description: ` Integrations, such as Cordova, can be enabled with this command. If the integration has never been added to the project, ${input('ionic integrations enable')} will download and add the integration. Integrations can be re-added with the ${input('--add')} option. `, inputs: [ { name: 'name', summary: `The integration to enable (e.g. ${INTEGRATION_NAMES.map(i => input(i)).join(', ')})`, validators: [validators.required, contains(INTEGRATION_NAMES, {})], }, ], options: [ { name: 'add', summary: 'Download and add the integration even if enabled', type: Boolean, }, { name: 'root', summary: 'Specify an alternative destination to download into when adding', spec: { value: 'path' }, }, { name: 'quiet', summary: 'Less verbose output, ignore integration errors', type: Boolean, }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ name ] = inputs; const { add, quiet } = options; if (!this.project) { throw new FatalException(`Cannot run ${input('ionic integrations enable')} outside a project directory.`); } const root = options['root'] ? path.resolve(this.project.rootDirectory, String(options['root'])) : this.project.rootDirectory; if (!isIntegrationName(name)) { throw new FatalException(`Don't know about ${input(name)} integration!`); } const integration = await this.project.createIntegration(name); try { if (!integration.isAdded() || add) { await integration.add({ root, enableArgs: options['--'] ? options['--'] : undefined, quiet: Boolean(quiet), }); this.env.log.ok(`Integration ${input(integration.name)} added!`); } else { const wasEnabled = integration.config.get('enabled') !== false; // We still need to run this whenever this command is run to make sure // everything is good with the integration. await integration.enable(); if (wasEnabled) { this.env.log.info(`Integration ${input(integration.name)} already enabled.`); } else { this.env.log.ok(`Integration ${input(integration.name)} enabled!`); } } } catch (e) { if (e instanceof BaseError) { if (quiet) { this.env.log.error(e.message); } else { throw new FatalException(e.message); } } else { throw e; } } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/integrations/index.ts000066400000000000000000000020731425441362600302200ustar00rootroot00000000000000import { CommandMap, Namespace } from '../../lib/namespace'; export class IntegrationsNamespace extends Namespace { async getMetadata() { return { name: 'integrations', summary: 'Manage various integrations in your app', description: 'Integrations, such as Cordova, can be enabled or disabled in your app with these commands.', }; } async getCommands(): Promise { return new CommandMap([ ['enable', async () => { const { IntegrationsEnableCommand } = await import('./enable'); return new IntegrationsEnableCommand(this); }], ['disable', async () => { const { IntegrationsDisableCommand } = await import('./disable'); return new IntegrationsDisableCommand(this); }], ['list', async () => { const { IntegrationsListCommand } = await import('./list'); return new IntegrationsListCommand(this); }], ['ls', 'list'], ['en', 'enable'], ['add', 'enable'], ['dis', 'disable'], ['delete', 'disable'], ['del', 'disable'], ['remove', 'disable'], ['rm', 'disable'], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/integrations/list.ts000066400000000000000000000035411425441362600300650ustar00rootroot00000000000000import { columnar } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, IntegrationName } from '../../definitions'; import { input, strong } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { INTEGRATION_NAMES } from '../../lib/integrations'; export class IntegrationsListCommand extends Command { async getMetadata(): Promise { return { name: 'list', type: 'project', summary: 'List available and active integrations in your app', description: ` This command will print the status of integrations in Ionic projects. Integrations can be ${strong('enabled')} (added and enabled), ${strong('disabled')} (added but disabled), and ${strong('not added')} (never added to the project). - To enable or add integrations, see ${input('ionic integrations enable --help')} - To disable integrations, see ${input('ionic integrations disable --help')} `, }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { project } = this; if (!project) { throw new FatalException(`Cannot run ${input('ionic integrations list')} outside a project directory.`); } const integrations = await Promise.all(INTEGRATION_NAMES.map(async name => project.createIntegration(name))); const status = (name: IntegrationName) => { const c = project.config.get('integrations')[name]; if (c) { if (c.enabled === false) { return chalk.dim.red('disabled'); } return chalk.green('enabled'); } return chalk.dim('not added'); }; this.env.log.rawmsg(columnar(integrations.map(i => [input(i.name), i.summary, status(i.name)]), { headers: ['name', 'summary', 'status'] })); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ionitron.ts000066400000000000000000000017621425441362600262500ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { Command } from '../lib/command'; export class IonitronCommand extends Command { async getMetadata(): Promise { return { name: 'ionitron', type: 'global', summary: 'Print random ionitron messages', options: [ { name: 'es', summary: 'Print in spanish', type: Boolean, }, ], groups: [MetadataGroup.HIDDEN], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { getIonitronString, ionitronStatements } = await import('../lib/ionitron'); const locale = options['es'] ? 'es' : 'en'; const localeStatements = ionitronStatements[locale]; const statement = localeStatements[Math.floor(Math.random() * (localeStatements.length))]; this.env.log.rawmsg(getIonitronString(statement)); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/link.ts000066400000000000000000000463661425441362600253550ustar00rootroot00000000000000import { MetadataGroup, validators } from '@ionic/cli-framework'; import { createPromptChoiceSeparator } from '@ionic/cli-framework-prompts'; import { prettyPath } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import { PROJECT_FILE } from '../constants'; import { App, CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun, GithubBranch, GithubRepo } from '../definitions'; import { isSuperAgentError } from '../guards'; import { ancillary, input, strong, weak } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; import { runCommand } from '../lib/executor'; import { openUrl } from '../lib/open'; const debug = Debug('ionic:commands:link'); const CHOICE_CREATE_NEW_APP = 'createNewApp'; const CHOICE_NEVERMIND = 'nevermind'; const CHOICE_RELINK = 'relink'; const CHOICE_LINK_EXISTING_APP = 'linkExistingApp'; const CHOICE_IONIC = 'ionic'; const CHOICE_GITHUB = 'github'; const CHOICE_SKIP = 'skip' const CHOICE_MASTER_ONLY = 'master'; const CHOICE_SPECIFIC_BRANCHES = 'specific'; export class LinkCommand extends Command implements CommandPreRun { async getMetadata(): Promise { const projectFile = this.project ? prettyPath(this.project.filePath) : PROJECT_FILE; return { name: 'link', type: 'project', groups: [MetadataGroup.PAID], summary: 'Connect local apps to Ionic', description: ` Link apps on Appflow to local Ionic projects with this command. If the ${input('id')} argument is excluded, this command will prompt you to select an app from Appflow. Appflow uses a git-based workflow to manage app updates. During the linking process, select ${strong('GitHub')} (recommended) or ${strong('Appflow')} as a git host. See our documentation[^appflow-git-basics] for more information. Ultimately, this command sets the ${strong('id')} property in ${strong(prettyPath(projectFile))}, which marks this app as linked. If you are having issues linking, please get in touch with our Support[^support-request]. `, footnotes: [ { id: 'appflow-git-basics', url: 'https://ionicframework.com/docs/appflow/basics/git', shortUrl: 'https://ion.link/appflow-git-basics', }, { id: 'support-request', url: 'https://ion.link/support-request', }, ], exampleCommands: ['', 'a1b2c3d4'], inputs: [ { name: 'id', summary: `The Appflow ID of the app to link (e.g. ${input('a1b2c3d4')})`, }, ], options: [ { name: 'name', summary: 'The app name to use during the linking of a new app', groups: [MetadataGroup.HIDDEN], }, { name: 'create', summary: 'Create a new app on Ionic Appflow and link it with this local Ionic project', type: Boolean, groups: [MetadataGroup.HIDDEN], }, { name: 'pro-id', summary: 'Specify an app ID from the Ionic Appflow to link', groups: [MetadataGroup.DEPRECATED, MetadataGroup.HIDDEN], spec: { value: 'id' }, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { create } = options; if (inputs[0] && create) { throw new FatalException(`Sorry--cannot use both ${input('id')} and ${input('--create')}. You must either link an existing app or create a new one.`); } const id = options['pro-id'] ? String(options['pro-id']) : undefined; if (id) { inputs[0] = id; } } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { const { promptToLogin } = await import('../lib/session'); if (!this.project) { throw new FatalException(`Cannot run ${input('ionic link')} outside a project directory.`); } let id: string | undefined = inputs[0]; let { create } = options; const idFromConfig = this.project.config.get('id'); if (idFromConfig) { if (id && idFromConfig === id) { this.env.log.msg(`Already linked with app ${input(id)}.`); return; } const msg = id ? `Are you sure you want to link it to ${input(id)} instead?` : `Would you like to run link again?`; const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `App ID ${input(idFromConfig)} is already set up with this app. ${msg}`, }); if (!confirm) { this.env.log.msg('Not linking.'); return; } } if (!this.env.session.isLoggedIn()) { await promptToLogin(this.env); } if (!id && !create) { const choices = [ { name: `Link ${idFromConfig ? 'a different' : 'an existing'} app on Ionic Appflow`, value: CHOICE_LINK_EXISTING_APP, }, { name: 'Create a new app on Ionic Appflow', value: CHOICE_CREATE_NEW_APP, }, ]; if (idFromConfig) { choices.unshift({ name: `Relink ${input(idFromConfig)}`, value: CHOICE_RELINK, }); } const result = await this.env.prompt({ type: 'list', name: 'whatToDo', message: 'What would you like to do?', choices, }); if (result === CHOICE_CREATE_NEW_APP) { create = true; id = undefined; } else if (result === CHOICE_LINK_EXISTING_APP) { const tasks = this.createTaskChain(); tasks.next(`Looking up your apps`); const apps: App[] = []; const appClient = await this.getAppClient(); const paginator = appClient.paginate(); for (const r of paginator) { const res = await r; apps.push(...res.data); } tasks.end(); if (apps.length === 0) { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `No apps found. Would you like to create a new app on Ionic Appflow?`, }); if (!confirm) { throw new FatalException(`Cannot link without an app selected.`); } create = true; id = undefined; } else { const choice = await this.chooseApp(apps); if (choice === CHOICE_NEVERMIND) { this.env.log.info('Not linking app.'); id = undefined; } else { id = choice; } } } else if (result === CHOICE_RELINK) { id = idFromConfig; } } if (create) { let name = options['name'] ? String(options['name']) : undefined; if (!name) { name = await this.env.prompt({ type: 'input', name: 'name', message: 'Please enter a name for your new app:', validate: v => validators.required(v), }); } id = await this.createApp({ name }, runinfo); } else if (id) { const app = await this.lookUpApp(id); await this.linkApp(app, runinfo); } } private async getAppClient() { const { AppClient } = await import('../lib/app'); const token = await this.env.session.getUserToken(); return new AppClient(token, this.env); } private async getUserClient() { const { UserClient } = await import('../lib/user'); const token = await this.env.session.getUserToken(); return new UserClient(token, this.env); } async lookUpApp(id: string): Promise { const tasks = this.createTaskChain(); tasks.next(`Looking up app ${input(id)}`); const appClient = await this.getAppClient(); const app = await appClient.load(id); // Make sure the user has access to the app tasks.end(); return app; } async createApp({ name }: { name: string; }, runinfo: CommandInstanceInfo): Promise { const appClient = await this.getAppClient(); const org_id = this.env.config.get('org.id'); const app = await appClient.create({ name, org_id }); await this.linkApp(app, runinfo); return app.id; } async linkApp(app: App, runinfo: CommandInstanceInfo) { // TODO: load connections // TODO: check for git availability before this this.env.log.nl(); this.env.log.info( `Ionic Appflow uses a git-based workflow to manage app updates.\n` + `You will be prompted to set up the git host and repository for this new app. See the docs${ancillary('[1]')} for more information.\n\n` + `${ancillary('[1]')}: ${strong('https://ion.link/appflow-git-basics')}` ); this.env.log.nl(); const service = await this.env.prompt({ type: 'list', name: 'gitService', message: 'Which git host would you like to use?', choices: [ { name: 'GitHub', value: CHOICE_GITHUB, }, { name: 'Ionic Appflow', value: CHOICE_IONIC, }, { name: 'Don\'t use a git host', value: CHOICE_SKIP, }, ], }); let githubUrl: string | undefined; if (service === CHOICE_IONIC) { if (!this.env.config.get('git.setup')) { await runCommand(runinfo, ['ssh', 'setup']); } await runCommand(runinfo, ['config', 'set', 'id', `"${app.id}"`, '--json']); await runCommand(runinfo, ['git', 'remote']); } else { if (service === CHOICE_GITHUB) { githubUrl = await this.linkGithub(app); } await runCommand(runinfo, ['config', 'set', 'id', `"${app.id}"`, '--json']); } this.env.log.ok(`Project linked with app ${input(app.id)}!`); if (service === CHOICE_GITHUB) { this.env.log.info( `Here are some additional links that can help you with you first push to GitHub:\n` + `${strong('Adding GitHub as a remote')}:\n\t${strong('https://help.github.com/articles/adding-a-remote/')}\n\n` + `${strong('Pushing to a remote')}:\n\t${strong('https://help.github.com/articles/pushing-to-a-remote/')}\n\n` + `${strong('Working with branches')}:\n\t${strong('https://guides.github.com/introduction/flow/')}\n\n` + `${strong('More comfortable with a GUI? Try GitHub Desktop!')}\n\t${strong('https://desktop.github.com/')}` ); if (githubUrl) { this.env.log.info( `You can now push to one of your branches on GitHub to trigger a build in Ionic Appflow!\n` + `If you haven't added GitHub as your origin you can do so by running:\n\n` + `${input('git remote add origin ' + githubUrl)}\n\n` + `You can find additional links above to help if you're having issues.` ); } } } async linkGithub(app: App): Promise { const { id } = this.env.session.getUser(); const userClient = await this.getUserClient(); const user = await userClient.load(id, { fields: ['oauth_identities'] }); if (!user.oauth_identities || !user.oauth_identities.github) { await this.oAuthProcess(id); } if (await this.needsAssociation(app, user.id)) { await this.confirmGithubRepoExists(); const repoId = await this.selectGithubRepo(); const branches = await this.selectGithubBranches(repoId); return this.connectGithub(app, repoId, branches); } } async confirmGithubRepoExists() { let confirm = false; this.env.log.nl(); this.env.log.info(strong(`In order to link to a GitHub repository the repository must already exist on GitHub.`)); this.env.log.info( `${strong('If the repository does not exist please create one now before continuing.')}\n` + `If you're not familiar with Git you can learn how to set it up with GitHub here:\n\n` + strong(`https://help.github.com/articles/set-up-git/ \n\n`) + `You can find documentation on how to create a repository on GitHub and push to it here:\n\n` + strong(`https://help.github.com/articles/create-a-repo/`) ); confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'Does the repository exist on GitHub?', }); if (!confirm) { throw new FatalException(`Repo must exist on GitHub in order to link. Please create the repo and run ${input('ionic link')} again.`); } } async oAuthProcess(userId: number) { const userClient = await this.getUserClient(); let confirm = false; this.env.log.nl(); this.env.log.info( `GitHub OAuth setup required.\n` + `To continue, we need you to authorize Ionic Appflow with your GitHub account. ` + `A browser will open and prompt you to complete the authorization request. ` + `When finished, please return to the CLI to continue linking your app.` ); confirm = await this.env.prompt({ type: 'confirm', name: 'ready', message: 'Open browser:', }); if (!confirm) { throw new FatalException(`GitHub OAuth setup is required to link to GitHub repository. Please run ${input('ionic link')} again when ready.`); } const url = await userClient.oAuthGithubLogin(userId); await openUrl(url); confirm = await this.env.prompt({ type: 'confirm', name: 'ready', message: 'Authorized and ready to continue:', }); if (!confirm) { throw new FatalException(`GitHub OAuth setup is required to link to GitHub repository. Please run ${input('ionic link')} again when ready.`); } } async needsAssociation(app: App, userId: number): Promise { const appClient = await this.getAppClient(); if (app.association && app.association.repository.html_url) { this.env.log.msg(`App ${input(app.id)} already connected to ${strong(app.association.repository.html_url)}`); const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'Would you like to connect a different repo?', }); if (!confirm) { return false; } try { // TODO: maybe we can use a PUT instead of DELETE now + POST later? await appClient.deleteAssociation(app.id); } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { await this.oAuthProcess(userId); await appClient.deleteAssociation(app.id); return true; } else if (e.response.status === 404) { debug(`DELETE ${app.id} GitHub association not found`); return true; } } throw e; } } return true; } async connectGithub(app: App, repoId: number, branches: string[]): Promise { const appClient = await this.getAppClient(); try { const association = await appClient.createAssociation(app.id, { repoId, type: 'github', branches }); this.env.log.ok(`App ${input(app.id)} connected to ${strong(association.repository.html_url)}`); return association.repository.html_url; } catch (e) { if (isSuperAgentError(e) && e.response.status === 403) { throw new FatalException(e.response.body.error.message); } } } formatRepoName(fullName: string) { const [ org, name ] = fullName.split('/'); return `${weak(`${org} /`)} ${name}`; } async chooseApp(apps: App[]): Promise { const { formatName } = await import('../lib/app'); const neverMindChoice = { name: strong('Nevermind'), id: CHOICE_NEVERMIND, value: CHOICE_NEVERMIND, org: null, }; const linkedApp = await this.env.prompt({ type: 'list', name: 'linkedApp', message: 'Which app would you like to link', choices: [ ...apps.map(app => ({ name: `${formatName(app)} ${weak(`(${app.id})`)}`, value: app.id, })), createPromptChoiceSeparator(), neverMindChoice, createPromptChoiceSeparator(), ], }); return linkedApp; } async selectGithubRepo(): Promise { const user = this.env.session.getUser(); const userClient = await this.getUserClient(); const tasks = this.createTaskChain(); const task = tasks.next('Looking up your GitHub repositories'); const paginator = userClient.paginateGithubRepositories(user.id); const repos: GithubRepo[] = []; try { for (const r of paginator) { const res = await r; repos.push(...res.data); task.msg = `Looking up your GitHub repositories: ${strong(String(repos.length))} found`; } } catch (e) { tasks.fail(); if (isSuperAgentError(e) && e.response.status === 401) { await this.oAuthProcess(user.id); return this.selectGithubRepo(); } throw e; } tasks.end(); const repoId = await this.env.prompt({ type: 'list', name: 'githubRepo', message: 'Which GitHub repository would you like to link?', choices: repos.map(repo => ({ name: this.formatRepoName(repo.full_name), value: String(repo.id), })), }); return Number(repoId); } async selectGithubBranches(repoId: number): Promise { this.env.log.nl(); this.env.log.info(strong(`By default Ionic Appflow links only to the ${input('master')} branch.`)); this.env.log.info( `${strong('If you\'d like to link to another branch or multiple branches you\'ll need to select each branch to connect to.')}\n` + `If you're not familiar with on working with branches in GitHub you can read about them here:\n\n` + strong(`https://guides.github.com/introduction/flow/ \n\n`) ); const choice = await this.env.prompt({ type: 'list', name: 'githubMultipleBranches', message: 'Which would you like to do?', choices: [ { name: `Link to master branch only`, value: CHOICE_MASTER_ONLY, }, { name: `Link to specific branches`, value: CHOICE_SPECIFIC_BRANCHES, }, ], }); switch (choice) { case CHOICE_MASTER_ONLY: return ['master']; case CHOICE_SPECIFIC_BRANCHES: // fall through and begin prompting to choose branches break; default: throw new FatalException('Aborting. No branch choice specified.'); } const user = this.env.session.getUser(); const userClient = await this.getUserClient(); const paginator = userClient.paginateGithubBranches(user.id, repoId); const tasks = this.createTaskChain(); const task = tasks.next('Looking for available branches'); const availableBranches: GithubBranch[] = []; try { for (const r of paginator) { const res = await r; availableBranches.push(...res.data); task.msg = `Looking up the available branches on your GitHub repository: ${strong(String(availableBranches.length))} found`; } } catch (e) { tasks.fail(); throw e; } tasks.end(); const choices = availableBranches.map(branch => ({ name: branch.name, value: branch.name, checked: branch.name === 'master', })); if (choices.length === 0) { this.env.log.warn(`No branches found for the repository. Linking to ${input('master')} branch.`); return ['master']; } const selectedBranches = await this.env.prompt({ type: 'checkbox', name: 'githubBranches', message: 'Which branch would you like to link?', choices, default: ['master'], }); return selectedBranches; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/login.ts000066400000000000000000000147611425441362600255220ustar00rootroot00000000000000import { combine, validators } from '@ionic/cli-framework'; import * as chalk from 'chalk'; import * as readline from 'readline'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../definitions'; import { input, strong, success } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; import { generateUUID } from '../lib/utils/uuid'; export class LoginCommand extends Command implements CommandPreRun { async getMetadata(): Promise { return { name: 'login', type: 'global', summary: 'Log in to Ionic', description: ` Authenticate with Ionic and retrieve a user token, which is stored in the CLI config. Running ${input('ionic login')} will open a browser where you can submit your credentials. If the ${input('IONIC_TOKEN')} environment variable is set, the CLI will automatically authenticate you. Use the Dashboard to generate a Personal Access Token. If you need to create an Ionic account, use ${input('ionic signup')} or the Ionic Website[^signup]. If you are having issues logging in, please get in touch with our Support[^support-request]. `, footnotes: [ { id: 'signup', url: 'https://ionicframework.com/signup', }, { id: 'support-request', url: 'https://ion.link/support-request', }, ], exampleCommands: [''], inputs: [ { name: 'email', summary: 'Your email address (deprecated)', private: true, }, { name: 'password', summary: 'Your password (deprecated)', private: true, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (options['email'] || options['password']) { throw new FatalException( `${input('email')} and ${input('password')} are command arguments, not options. Please try this:\n` + `${input('ionic login ')}\n` ); } if (options['sso']) { this.env.log.warn( `The ${strong('--sso')} flag is no longer necessary.\n` + `SSO login has been upgraded to OpenID login, which is now the new default authentication flow of ${input('ionic login')}. Refresh tokens are used to automatically re-authenticate sessions.` ); this.env.log.nl(); } if (!!inputs[0]) { this.env.log.warn( 'Authenticating using email and password is deprecated. ' + (this.env.flags.interactive ? `Please run ${input('ionic login')} without arguments to log in.` : `Please generate a Personal Access Token and set the ${input('IONIC_TOKEN')} environment variable.`) ); this.env.log.nl(); } // ask for password only if the user specifies an email const validateEmail = !!inputs[0]; const askForPassword = inputs[0] && !inputs[1]; if (this.env.session.isLoggedIn()) { const email = this.env.config.get('user.email'); const extra = askForPassword ? (this.env.flags.interactive ? `Prompting for new credentials.\n\nUse ${chalk.yellow('Ctrl+C')} to cancel and remain logged in.` : '') : 'You will be logged out beforehand.'; if (this.env.flags.interactive) { this.env.log.warn( 'You will be logged out.\n' + `You are already logged in${email ? ' as ' + strong(email) : ''}! ${extra}` ); this.env.log.nl(); } } else { if (this.env.flags.interactive) { this.env.log.info( `Log into your Ionic account!\n` + `If you don't have one yet, create yours by running: ${input(`ionic signup`)}` ); this.env.log.nl(); } } // TODO: combine with promptToLogin ? if (validateEmail) { const validatedEmail = validators.email(inputs[0]); if (validatedEmail !== true) { this.env.log.warn(`${validatedEmail}. \n Please enter a valid email address.`); if (this.env.flags.interactive) { const email = await this.env.prompt({ type: 'input', name: 'email', message: 'Email:', validate: v => combine(validators.required, validators.email)(v), }); inputs[0] = email; } else { throw new FatalException('Invalid email'); } } } if (askForPassword) { if (this.env.flags.interactive) { const password = await this.env.prompt({ type: 'password', name: 'password', message: 'Password:', mask: '*', validate: v => validators.required(v), }); inputs[1] = password; } else { inputs[1] = await this.getPasswordFromStdin(); } } } getPasswordFromStdin(): Promise { return new Promise(resolve => { const rl = readline.createInterface({ input: process.stdin, terminal: false, }); rl.on('line', line => { resolve(line); rl.close(); }); }); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const [ email, password ] = inputs; if (email && password) { await this.logout(); await this.env.session.login(email, password); } else { if (!this.env.flags.interactive && !this.env.flags.confirm) { throw new FatalException( 'Refusing to attempt browser login in non-interactive mode.\n' + `If you are attempting to log in, make sure you are using a modern, interactive terminal. Otherwise, you can log in using inline username and password with ${input('ionic login ')}. See ${input('ionic login --help')} for more details.` ); } this.env.log.info(`During this process, a browser window will open to authenticate you. Please leave this process running until authentication is complete.`); this.env.log.nl(); const login = await this.env.prompt({ type: 'confirm', name: 'continue', message: 'Open the browser to log in to your Ionic account?', default: true, }); if (login) { await this.logout(); await this.env.session.webLogin(); } else { return ; } } this.env.log.ok(success(strong('You are logged in!'))); } async logout() { if (this.env.session.isLoggedIn()) { await this.env.session.logout(); this.env.config.set('tokens.telemetry', generateUUID()); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/logout.ts000066400000000000000000000015251425441362600257150ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { input } from '../lib/color'; import { Command } from '../lib/command'; export class LogoutCommand extends Command { async getMetadata(): Promise { return { name: 'logout', type: 'global', summary: 'Log out of Ionic', description: ` Remove the Ionic user token from the CLI config. Log in again with ${input('ionic login')}. If you need to create an Ionic account, use ${input('ionic signup')}. `, }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.env.session.isLoggedIn()) { this.env.log.msg('You are already logged out.'); return; } await this.env.session.logout(); this.env.log.ok('You are logged out.'); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/monitoring/000077500000000000000000000000001425441362600262165ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/monitoring/index.ts000066400000000000000000000013321425441362600276740ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandMap, Namespace } from '../../lib/namespace'; export class MonitoringNamespace extends Namespace { async getMetadata() { const groups: MetadataGroup[] = []; if (!this.project || this.project.type !== 'ionic-angular') { groups.push(MetadataGroup.HIDDEN); } return { name: 'monitoring', summary: 'Commands relating to Ionic Appflow Error Monitoring', groups, }; } async getCommands(): Promise { return new CommandMap([ ['syncmaps', async () => { const { MonitoringSyncSourcemapsCommand } = await import('./syncmaps'); return new MonitoringSyncSourcemapsCommand(this); }], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/monitoring/syncmaps.ts000066400000000000000000000134411425441362600304260ustar00rootroot00000000000000import { pathExists, readFile, readdirSafe } from '@ionic/utils-fs'; import { columnar, prettyPath } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import * as path from 'path'; import { APIResponseSuccess, CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { isSuperAgentError } from '../../guards'; import { input, strong, weak } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; const debug = Debug('ionic:commands:monitoring:syncmaps'); const SOURCEMAP_DIRECTORY = '.sourcemaps'; export class MonitoringSyncSourcemapsCommand extends Command { async getMetadata(): Promise { return { name: 'syncmaps', type: 'project', summary: 'Build & upload sourcemaps to Ionic Appflow Monitoring service', description: ` By default, ${input('ionic monitoring syncmaps')} will upload the sourcemap files within ${strong(SOURCEMAP_DIRECTORY)}. To optionally perform a production build before uploading sourcemaps, specify the ${input('--build')} flag. `, inputs: [ { name: 'snapshot_id', summary: `Specify a Snapshot ID to associate the uploaded sourcemaps with`, }, ], options: [ { name: 'build', summary: 'Invoke a production Ionic build', type: Boolean, }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { loadCordovaConfig } = await import('../../lib/integrations/cordova/config'); if (!this.project) { throw new FatalException(`Cannot run ${input('ionic monitoring syncmaps')} outside a project directory.`); } const token = await this.env.session.getUserToken(); const appflowId = await this.project.requireAppflowId(); const [ snapshotId ] = inputs; const doBuild = options.build ? true : false; const cordova = this.project.requireIntegration('cordova'); const conf = await loadCordovaConfig(cordova); const cordovaInfo = conf.getProjectInfo(); const appVersion = cordovaInfo.version; const commitHash = (await this.env.shell.output('git', ['rev-parse', 'HEAD'], { cwd: this.project.directory })).trim(); debug(`Commit hash: ${strong(commitHash)}`); const sourcemapsDir = path.resolve(this.project.directory, SOURCEMAP_DIRECTORY); let sourcemapsExist = await pathExists(sourcemapsDir); if (doBuild || !sourcemapsExist) { const runner = await this.project.requireBuildRunner(); const runnerOpts = runner.createOptionsFromCommandLine([], { _: [], prod: true }); await runner.run(runnerOpts); } sourcemapsExist = await pathExists(sourcemapsDir); if (sourcemapsExist) { this.env.log.msg(`Using existing sourcemaps in ${strong(prettyPath(sourcemapsDir))}`); } else { // TODO: this is hard-coded for ionic-angular, make it work for all project types throw new FatalException( `Cannot find directory: ${strong(prettyPath(sourcemapsDir))}.\n` + `Make sure you have the latest ${strong('@ionic/app-scripts')}. Then, re-run this command.` ); } let count = 0; const tasks = this.createTaskChain(); const syncTask = tasks.next('Syncing sourcemaps'); const sourcemapFiles = (await readdirSafe(sourcemapsDir)).filter(f => f.endsWith('.js.map')); debug(`Found ${sourcemapFiles.length} sourcemap files: ${sourcemapFiles.map(f => strong(f)).join(', ')}`); await Promise.all(sourcemapFiles.map(async f => { await this.syncSourcemap(path.resolve(sourcemapsDir, f), snapshotId, appVersion, commitHash, appflowId, token); count += 1; syncTask.msg = `Syncing sourcemaps: ${strong(`${count} / ${sourcemapFiles.length}`)}`; })); syncTask.msg = `Syncing sourcemaps: ${strong(`${sourcemapFiles.length} / ${sourcemapFiles.length}`)}`; tasks.end(); const details = columnar([ ['App ID', strong(appflowId)], ['Version', strong(appVersion)], ['Package ID', strong(cordovaInfo.id)], ['Snapshot ID', snapshotId ? strong(snapshotId) : weak('not set')], ], { vsep: ':' }); this.env.log.ok( `Sourcemaps synced!\n` + details + '\n\n' + `See the Error Monitoring docs for usage information and next steps: ${strong('https://ionicframework.com/docs/appflow/monitoring')}` ); } async syncSourcemap(file: string, snapshotId: string, appVersion: string, commitHash: string, appflowId: string, token: string): Promise { const { req } = await this.env.client.make('POST', `/monitoring/${appflowId}/sourcemaps`); req .set('Authorization', `Bearer ${token}`) .send({ name: path.basename(file), version: appVersion, commit: commitHash, snapshot_id: snapshotId, }); try { const res = await this.env.client.do(req); return this.uploadSourcemap(res, file); } catch (e) { if (isSuperAgentError(e)) { this.env.log.error(`Unable to sync map ${file}: ` + e.message); if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } } else { throw e; } } } async uploadSourcemap(sourcemap: APIResponseSuccess, file: string) { const { createRequest } = await import('../../lib/utils/http'); const sm = sourcemap as any; const fileData = await readFile(file, { encoding: 'utf8' }); const sourcemapPost = sm.data.sourcemap_post; const { req } = await createRequest('POST', sourcemapPost.url, this.env.config.getHTTPConfig()); req .field(sourcemapPost.fields) .field('file', fileData); const res = await req; if (res.status !== 204) { throw new FatalException(`Unexpected status code from AWS: ${res.status}`); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/package/000077500000000000000000000000001425441362600254245ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/package/build.ts000066400000000000000000000476741425441362600271150ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, MetadataGroup, combine, contains, validators } from '@ionic/cli-framework'; import { LOGGER_LEVELS } from '@ionic/cli-framework-output'; import { tmpfilepath } from '@ionic/utils-fs'; import { columnar } from '@ionic/utils-terminal'; import { sleep } from '@ionic/utils-process'; import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as fs from 'fs'; import { CommandMetadata } from '../../definitions'; import { isSuperAgentError } from '../../guards'; import { input, strong, weak } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { fileUtils } from '../../lib/utils/file'; import { createRequest, download } from '../../lib/utils/http'; import { IONIC_CLOUD_CLI_MIGRATION } from '../../lib/updates'; const debug = Debug('ionic:commands:package:build'); const PLATFORMS = ['android', 'ios']; const ANDROID_BUILD_TYPES = ['debug', 'release']; const IOS_BUILD_TYPES = ['development', 'ad-hoc', 'app-store', 'enterprise']; const APP_STORE_COMPATIBLE_TYPES = ['release', 'app-store', 'enterprise']; const BUILD_TYPES = ANDROID_BUILD_TYPES.concat(IOS_BUILD_TYPES); const ANDROID_ARTIFACT_TYPES = ['aab', 'apk']; const IOS_ARTIFACT_TYPES = ['ipa', 'dsym']; const ARTIFACT_TYPES = ANDROID_ARTIFACT_TYPES.concat(IOS_ARTIFACT_TYPES); const TARGET_PLATFORM = ['Android', 'iOS - Xcode 11 (Preferred)', 'iOS - Xcode 10']; interface Artifact { name: string; url: string; artifact_type: string; } export interface PackageBuild { job_id: number; id: string; caller_id: number; platform: string; build_type: string; created: string; finished: string; state: string; commit: any; stack: any; profile_tag: string; automation_id: number; environment_id: number; native_config_id: number; automation_name: string; environment_name: string; native_config_name: string; distribution_credential_name: string; job: any; distribution_trace: string; artifacts: Artifact[]; } interface DownloadUrl { url: string | null; } export class BuildCommand extends Command { async getMetadata(): Promise { const dashUrl = this.env.config.getDashUrl(); return { name: 'build', type: 'project', groups: [MetadataGroup.PAID, MetadataGroup.DEPRECATED], summary: 'Create a package build on Appflow', description: ` This command creates a package build on Appflow. While the build is running, it prints the remote build log to the terminal. If the build is successful, it downloads the created app package file in the current directory. Downloading build artifacts can be skipped by supplying the flag ${input('skip-download')}. Apart from ${input('--commit')}, every option can be specified using the full name setup within the Dashboard[^dashboard]. The ${input('--signing-certificate')} option is mandatory for any iOS build but not for Android debug builds. Customizing the build: - The ${input('--environment')} and ${input('--native-config')} options can be used to customize the groups of values exposed to the build. - Override the preferred platform with ${input('--build-stack')}. This is useful for building older iOS apps. Deploying the build to an App Store: - The ${input('--destination')} option can be used to deliver the app created by the build to the configured App Store. \ This can be used only together with build type ${input('release')} for Android and build types ${input('app-store')} or ${input('enterprise')} for iOS. Downloading build artifacts: - By default once the build is complete, all artifacts are downloaded for the selected platform. ${input('aab')} and ${input('apk')} for Android \ ${input('ipa')} and ${input('dsym')} for iOS. - The ${input('--artifact-type')} option can be used to limit artifact downloads to only of that type. For instance, with Android, you can specify ${input('aab')} \ if you do not wish to download ${input('apk')}. `, footnotes: [ { id: 'dashboard', url: dashUrl, }, ], exampleCommands: [ 'android debug', 'ios development --signing-certificate="iOS Signing Certificate Name"', 'android debug --environment="My Custom Environment Name"', 'android debug --native-config="My Custom Native Config Name"', 'android debug --commit=2345cd3305a1cf94de34e93b73a932f25baac77c', 'android debug --artifact-type=aab', 'android debug --skip-download', 'android debug --aab-name="my-app-prod.aab" --apk-name="my-app-prod.apk"', 'ios development --signing-certificate="iOS Signing Certificate Name" --build-stack="iOS - Xcode 9"', 'ios development --signing-certificate="iOS Signing Certificate Name" --ipa-name=my_custom_file_name.ipa', 'ios app-store --signing-certificate="iOS Signing Certificate Name" --destination="Apple App Store Destination"', ], inputs: [ { name: 'platform', summary: `The platform to package (${PLATFORMS.map(v => input(v)).join(', ')})`, validators: [validators.required, contains(PLATFORMS, {})], }, { name: 'type', summary: `The build type (${BUILD_TYPES.map(v => input(v)).join(', ')})`, validators: [validators.required, contains(BUILD_TYPES, {})], }, ], options: [ { name: 'signing-certificate', summary: 'Signing certificate', type: String, spec: { value: 'name' }, }, { name: 'environment', summary: 'The group of environment variables exposed to your build', type: String, spec: { value: 'name' }, }, { name: 'native-config', summary: 'The group of native config variables exposed to your build', type: String, spec: { value: 'name' }, }, { name: 'destination', summary: 'The configuration to deploy the build artifact to the app store', type: String, spec: { value: 'name' }, }, { name: 'commit', summary: 'Commit (defaults to HEAD)', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'sha1' }, }, { name: 'build-stack', summary: `Target platform (${TARGET_PLATFORM.map(v => input(`"${v}"`)).join(', ')})`, type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'name' }, }, { name: 'build-file-name', summary: 'The name for the downloaded build file', type: String, groups: [MetadataGroup.DEPRECATED], spec: { value: 'name' }, }, { name: 'ipa-name', summary: 'The name for the downloaded ipa file', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'name' }, }, { name: 'dsym-name', summary: 'The name for the downloaded dsym file', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'name' }, }, { name: 'apk-name', summary: 'The name for the downloaded apk file', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'name' }, }, { name: 'aab-name', summary: 'The name for the downloaded aab file', type: String, groups: [MetadataGroup.ADVANCED], spec: { value: 'name' }, }, { name: 'artifact-type', summary: `The artifact type (${ARTIFACT_TYPES.map(v => input(v)).join(', ')})`, type: String, spec: { value: 'name' }, }, { name: 'skip-download', summary: `Skip downloading build artifacts after command succeeds.`, type: Boolean, spec: { value: 'name' }, default: false, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { this.env.log.warn(IONIC_CLOUD_CLI_MIGRATION); if (!inputs[0]) { const platformInput = await this.env.prompt({ type: 'list', name: 'platform', choices: PLATFORMS, message: `Platform to package:`, validate: v => combine(validators.required, contains(PLATFORMS, {}))(v), }); inputs[0] = platformInput; } const buildTypes = inputs[0] === 'ios' ? IOS_BUILD_TYPES : ANDROID_BUILD_TYPES; // validate that the build type is valid for the platform let reenterBuildType = false; if (inputs[1] && !buildTypes.includes(inputs[1])) { reenterBuildType = true; this.env.log.nl(); this.env.log.warn(`Build type ${strong(inputs[1])} incompatible for ${strong(inputs[0])}; please choose a correct one`); } if (!inputs[1] || reenterBuildType) { const typeInput = await this.env.prompt({ type: 'list', name: 'type', choices: buildTypes, message: `Build type:`, validate: v => combine(validators.required, contains(buildTypes, {}))(v), }); inputs[1] = typeInput; } if (options['target-platform']) { this.env.log.warn(`The ${input('--target-platform')} option has been deprecated. Please use ${input('--build-stack')}.`); options['build-stack'] = options['target-platform']; } if (options['security-profile']) { this.env.log.warn(`The ${input('--security-profile')} option has been deprecated. Please use ${input('--signing-certificate')}.`); options['signing-certificate'] = options['security-profile']; } // the signing certificate is mandatory for iOS packages, so prompting if it is missing if (inputs[0] === 'ios' && !options['signing-certificate']) { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.warn(`A signing certificate is mandatory to build an iOS package`); } const securityProfileOption = await this.env.prompt({ type: 'input', name: 'signing-certificate', message: `Signing Certificate Name:`, }); options['signing-certificate'] = securityProfileOption; } // if destination is present, validate that a proper build type has been been specified if (options['destination'] && !APP_STORE_COMPATIBLE_TYPES.includes(inputs[1])) { throw new FatalException(`Build with type ${strong(String(inputs[1]))} cannot be deployed to App Store`); } if (options['artifact-type'] && (Array.isArray(options['artifact-type']) || typeof options['artifact-type'] === 'string')) { const artifactTypes = Array.isArray(options['artifact-type']) ? options['artifact-type'] : [options['artifact-type']]; let unsupported: string[]; switch (inputs[0]) { case 'android': unsupported = artifactTypes.filter(type => !ANDROID_ARTIFACT_TYPES.includes(type)); break; case 'ios': unsupported = artifactTypes.filter(type => !IOS_ARTIFACT_TYPES.includes(type)); break; default: throw new FatalException(`Unsupported platform ${inputs[0]}`); } if (unsupported.length) { throw new FatalException(`Unsupported artifact types for platform ${inputs[0]}: ${[...unsupported]}`); } } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic package build')} outside a project directory.`); } const token = await this.env.session.getUserToken(); const appflowId = await this.project.requireAppflowId(); const [ platform, buildType ] = inputs; if (!options.commit) { options.commit = (await this.env.shell.output('git', ['rev-parse', 'HEAD'], { cwd: this.project.directory })).trim(); debug(`Commit hash: ${strong(options.commit)}`); } let build = await this.createPackageBuild(appflowId, token, platform, buildType, options); const buildId = build.job_id; const details = columnar([ ['App ID', strong(appflowId)], ['Build ID', strong(buildId.toString())], ['Commit', strong(`${build.commit.sha.substring(0, 6)} ${build.commit.note}`)], ['Target Platform', strong(build.stack.friendly_name)], ['Build Type', strong(build.build_type)], ['Artifact Type(s)', options['artifact-type'] ? strong(`${options['artifact-type']}`.toUpperCase()) : weak('all available')], ['Security Profile', build.profile_tag ? strong(build.profile_tag) : weak('not set')], ['Environment', build.environment_name ? strong(build.environment_name) : weak('not set')], ['Native Config', build.native_config_name ? strong(build.native_config_name) : weak('not set')], ['Destination', build.distribution_credential_name ? strong(build.distribution_credential_name) : weak('not set')], ], { vsep: ':' }); this.env.log.ok( `Build created\n` + details + '\n\n' ); build = await this.tailBuildLog(appflowId, buildId, token); if (build.state !== 'success') { throw new Error(`Build ${build.state}`); } if (options['skip-download']) { return; } const availableArtifactTypes = build.artifacts.map((artifact) => artifact.artifact_type); if (Array.isArray(options['artifact-type'])) { let errors = []; for (const artifactType of new Set(options['artifact-type'])) { try { await this.downloadArtifact(appflowId, buildId, artifactType, token, options); } catch (error) { errors.push(error); } } if (errors.length) { throw new FatalException(`There were issues downloading artifacts: ${errors.join('\n')}`); } } else if (typeof options['artifact-type'] == 'string') { await this.downloadArtifact(appflowId, buildId, options['artifact-type'], token, options); } else { for (const artifactType of availableArtifactTypes) { await this.downloadArtifact(appflowId, buildId, artifactType.toUpperCase(), token, options); } } } async sanitizeString(value: string | string[] | boolean | null | undefined): Promise { if (!value || typeof (value) !== 'string') { return ''; } if (!fileUtils.isValidFileName(value)) { throw new FatalException(`${strong(String(value))} is not a valid file name`); } return String(value); } async createPackageBuild(appflowId: string, token: string, platform: string, buildType: string, options: CommandLineOptions): Promise { const { req } = await this.env.client.make('POST', `/apps/${appflowId}/packages/verbose_post`); req.set('Authorization', `Bearer ${token}`).send({ platform, build_type: buildType, commit_sha: options.commit, stack_name: options['build-stack'], profile_name: options['signing-certificate'], environment_name: options.environment, native_config_name: options['native-config'], distribution_credential_name: options.destination, }); try { const res = await this.env.client.do(req); return res.data as PackageBuild; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to create build: ` + apiErrorMessage); } else { throw e; } } } async getPackageBuild(appflowId: string, buildId: number, token: string): Promise { const { req } = await this.env.client.make('GET', `/apps/${appflowId}/packages/${buildId}`); req.set('Authorization', `Bearer ${token}`).send(); try { const res = await this.env.client.do(req); return res.data as PackageBuild; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to get build ${buildId}: ` + apiErrorMessage); } else { throw e; } } } async getDownloadUrl(appflowId: string, buildId: number, artifactType: string, token: string): Promise { const { req } = await this.env.client.make('GET', `/apps/${appflowId}/packages/${buildId}/download?artifact_type=${artifactType}`); req.set('Authorization', `Bearer ${token}`).send(); try { const res = await this.env.client.do(req); return res.data as DownloadUrl; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to get download URL for build ${buildId}: ` + apiErrorMessage); } else { throw e; } } } async tailBuildLog(appflowId: string, buildId: number, token: string): Promise { let build; let start = 0; const ws = this.env.log.createWriteStream(LOGGER_LEVELS.INFO, false); let isCreatedMessage = false; let errorsEncountered = 0; while (!(build && ['success', 'failed', 'canceled'].includes(build.state))) { try { await sleep(5000); build = await this.getPackageBuild(appflowId, buildId, token); if (build && build.state === 'created' && !isCreatedMessage) { ws.write(chalk.yellow('Concurrency limit reached: build will start as soon as other builds finish.')); isCreatedMessage = true; } const trace = build.job.trace; if (trace.length > start) { ws.write(trace.substring(start)); start = trace.length; } errorsEncountered = 0; } catch (e) { // Retry up to 3 times in the case of an error. errorsEncountered++; ws.write(chalk.yellow(`Encountered error: ${e} while fetching build data retrying.`)); if (errorsEncountered >= 3) { ws.write(chalk.red(`Encountered ${errorsEncountered} errors in a row. Job will now fail.`)); throw e; } } } ws.end(); return build; } async downloadBuild(url: string, filename: string): Promise { const { req } = await createRequest('GET', url, this.env.config.getHTTPConfig()); if (!filename) { req.on('response', res => { const contentDisposition = res.header['content-disposition']; filename = contentDisposition ? contentDisposition.split('=')[1].replace(/([/?<>*|\"])/g, '_') : 'output.bin'; }); } const tmpFile = tmpfilepath('ionic-package-build'); const ws = fs.createWriteStream(tmpFile); await download(req, ws, {}); fs.copyFileSync(tmpFile, filename); fs.unlinkSync(tmpFile); return filename; } async downloadArtifact(appflowId: string, buildId: number, artifactType: string, token: string, options: CommandLineOptions) { const url = await this.getDownloadUrl(appflowId, buildId, artifactType.toUpperCase(), token); if (!url.url) { throw new Error(`Artifact type '${artifactType}' not found`); } let customBuildFileName = ''; if (options['build-file-name']) { this.env.log.warn(`The ${input('--build-file-name')} option has been deprecated. Please use ${input('--ipa-name')}, ${input('--apk-name')} or ${input('--{ artifact }-name')}.`); customBuildFileName = await this.sanitizeString(options['build-file-name']); } else { customBuildFileName = await this.sanitizeString(options[`${artifactType.toLowerCase()}-name`]); } const filename = await this.downloadBuild(url.url, customBuildFileName); this.env.log.ok(`Artifact downloaded: ${filename}`); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/package/deploy.ts000066400000000000000000000161361425441362600272770ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, MetadataGroup, combine, validators, } from '@ionic/cli-framework'; import { LOGGER_LEVELS } from '@ionic/cli-framework-output'; import { sleep } from '@ionic/utils-process'; import { columnar } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import { CommandMetadata } from '../../definitions'; import { isSuperAgentError } from '../../guards'; import { input, strong } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; import { IONIC_CLOUD_CLI_MIGRATION } from '../../lib/updates'; import { PackageBuild } from './build'; interface BinaryDeployment { id: number; user: any; build: any; type: string; distributionCredential: any; destination: string; message: string; distributionBuildId: number; status: string; } interface DistributionBuild { job_id: number; id: string; caller_id: number; created: string; state: string; distribution_credential_name: string; package_build: PackageBuild; binary_deployment: BinaryDeployment; distribution_trace: string; } export class DeployCommand extends Command { async getMetadata(): Promise { const dashUrl = this.env.config.getDashUrl(); return { name: 'deploy', type: 'project', groups: [MetadataGroup.PAID, MetadataGroup.DEPRECATED], summary: 'Deploys a binary to a destination, such as an app store using Appflow', description: ` This command deploys a binary to a destination using Appflow. While running, the remote log is printed to the terminal. The command takes two parameters: the numeric ID of the package build that previously created the binary and the name of the destination where the binary is going to be deployed. Both can be retrieved from the Dashboard[^dashboard]. `, footnotes: [ { id: 'dashboard', url: dashUrl, }, ], exampleCommands: ['123456789 "My app store destination"'], inputs: [ { name: 'build-id', summary: `The build id of the desired successful package build`, validators: [validators.required, validators.numeric], }, { name: 'destination', summary: 'The destination to deploy the build artifact to the app store', validators: [validators.required], }, ], }; } async preRun( inputs: CommandLineInputs, options: CommandLineOptions ): Promise { this.env.log.warn(IONIC_CLOUD_CLI_MIGRATION); if (!inputs[0]) { const buildIdInputInput = await this.env.prompt({ type: 'input', name: 'build-id', message: `The build ID on Appflow:`, validate: v => combine(validators.required, validators.numeric)(v), }); inputs[0] = buildIdInputInput; } if (!inputs[1]) { const destinationInputInput = await this.env.prompt({ type: 'input', name: 'destination', message: `The destination to deploy the build artifact to the app store:`, validate: v => combine(validators.required)(v), }); inputs[1] = destinationInputInput; } } async run( inputs: CommandLineInputs, options: CommandLineOptions ): Promise { if (!this.project) { throw new FatalException( `Cannot run ${input( 'ionic package build' )} outside a project directory.` ); } const token = await this.env.session.getUserToken(); const appflowId = await this.project.requireAppflowId(); const [buildId, destination] = inputs; let build: | DistributionBuild | PackageBuild = await this.createDeploymentBuild( appflowId, token, buildId, destination ); const distBuildID = build.job_id; const details = columnar( [ ['App ID', strong(appflowId)], ['Deployment ID', strong(build.binary_deployment.id.toString())], ['Package Build ID', strong(buildId.toString())], ['Destination', strong(build.distribution_credential_name)], ], { vsep: ':' } ); this.env.log.ok(`Deployment initiated\n` + details + '\n\n'); build = await this.tailBuildLog(appflowId, distBuildID, token); if (build.state !== 'success') { throw new Error('Build failed'); } } async createDeploymentBuild( appflowId: string, token: string, buildId: string, destination: string ): Promise { const { req } = await this.env.client.make( 'POST', `/apps/${appflowId}/distributions/verbose_post` ); req.set('Authorization', `Bearer ${token}`).send({ package_build_id: buildId, distribution_credential_name: destination, }); try { const res = await this.env.client.do(req); return res.data as DistributionBuild; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = e.response.body.error && e.response.body.error.message ? e.response.body.error.message : 'Api Error'; throw new FatalException( `Unable to create deployment build: ` + apiErrorMessage ); } else { throw e; } } } async tailBuildLog( appflowId: string, buildId: number, token: string ): Promise { let build; let start = 0; const ws = this.env.log.createWriteStream(LOGGER_LEVELS.INFO, false); let isCreatedMessage = false; while ( !(build && (build.state === 'success' || build.state === 'failed')) ) { await sleep(5000); build = await this.getGenericBuild(appflowId, buildId, token); if (build && build.state === 'created' && !isCreatedMessage) { ws.write( chalk.yellow( 'Concurrency limit reached: build will start as soon as other builds finish.' ) ); isCreatedMessage = true; } const trace = build.distribution_trace; if (trace && trace.length > start) { ws.write(trace.substring(start)); start = trace.length; } } ws.end(); return build; } async getGenericBuild( appflowId: string, buildId: number, token: string ): Promise { const { req } = await this.env.client.make( 'GET', `/apps/${appflowId}/builds/${buildId}` ); req.set('Authorization', `Bearer ${token}`).send(); try { const res = await this.env.client.do(req); return res.data as PackageBuild; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401) { this.env.log.error('Try logging out and back in again.'); } const apiErrorMessage = e.response.body.error && e.response.body.error.message ? e.response.body.error.message : 'Api Error'; throw new FatalException( `Unable to get build ${buildId}: ` + apiErrorMessage ); } else { throw e; } } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/package/index.ts000066400000000000000000000020451425441362600271040ustar00rootroot00000000000000import { MetadataGroup, NamespaceMetadata } from '@ionic/cli-framework'; import { strong } from '../../lib/color'; import { CommandMap, Namespace } from '../../lib/namespace'; import { IONIC_CLOUD_CLI_MIGRATION } from '../../lib/updates'; export class PackageNamespace extends Namespace { async getMetadata(): Promise { return { name: 'package', summary: 'Appflow package functionality', description: ` ${IONIC_CLOUD_CLI_MIGRATION} Interface to execute commands about package builds and deployments on Ionic Appflow. Appflow package documentation: - Overview: ${strong('https://ion.link/appflow-package-docs')} `, groups: [MetadataGroup.PAID, MetadataGroup.DEPRECATED], }; } async getCommands(): Promise { return new CommandMap([ ['build', async () => { const { BuildCommand } = await import('./build'); return new BuildCommand(this); }], ['deploy', async () => { const { DeployCommand } = await import('./deploy'); return new DeployCommand(this); }], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/repair.ts000066400000000000000000000111261425441362600256640ustar00rootroot00000000000000import { pathExists, remove, unlink } from '@ionic/utils-fs'; import { prettyPath } from '@ionic/utils-terminal'; import * as path from 'path'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, IProject, ProjectIntegration } from '../definitions'; import { input, strong } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; import { runCommand } from '../lib/executor'; export class RepairCommand extends Command { async getMetadata(): Promise { return { name: 'repair', type: 'project', summary: 'Remove and recreate dependencies and generated files', description: ` This command may be useful when obscure errors or issues are encountered. It removes and recreates dependencies of your project. For Cordova apps, it removes and recreates the generated native project and the native dependencies of your project. `, options: [ { name: 'cordova', summary: 'Only perform the repair steps for Cordova platforms and plugins.', type: Boolean, }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic repair')} outside a project directory.`); } const { pkgManagerArgs } = await import('../lib/utils/npm'); const [ installer, ...installerArgs ] = await pkgManagerArgs(this.env.config.get('npmClient'), { command: 'install' }); const cordovaOnly = !!options['cordova']; const cordova = this.project.getIntegration('cordova'); if (cordovaOnly && !cordova) { throw new FatalException(`${input('--cordova')} was specified, but Cordova has not been added to this project.`); } if (cordova && !cordova.enabled) { this.env.log.warn(`Cordova integration found, but is disabled--not running repair for Cordova.`); } if (this.env.flags.interactive) { const steps: string[] = []; if (!cordovaOnly) { steps.push( `- Remove ${strong('node_modules/')} and ${strong('package-lock.json')}\n` + `- Run ${input([installer, ...installerArgs].join(' '))} to restore dependencies\n` ); } if (cordova && cordova.enabled) { steps.push( `- Remove ${strong('platforms/')} and ${strong('plugins/')}\n` + `- Run ${input('cordova prepare')} to restore platforms and plugins\n` ); } if (steps.length === 0) { this.env.log.ok(`${input('ionic repair')} has nothing to do.`); throw new FatalException('', 0); } this.env.log.info(`${input('ionic repair')} will do the following:\n\n` + steps.join('')); } const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'Continue?', default: false, }); if (!confirm) { throw new FatalException(`Not running ${input('ionic repair')}.`); } this.env.log.nl(); if (!cordovaOnly) { await this.npmRepair(this.project); } if (cordova && cordova.enabled) { await this.cordovaRepair(cordova, runinfo); } } async npmRepair(project: IProject) { const { pkgManagerArgs } = await import('../lib/utils/npm'); const [ installer, ...installerArgs ] = await pkgManagerArgs(this.env.config.get('npmClient'), { command: 'install' }); const tasks = this.createTaskChain(); const packageLockFile = path.resolve(project.directory, 'package-lock.json'); const nodeModulesDir = path.resolve(project.directory, 'node_modules'); tasks.next(`Removing ${strong(prettyPath(packageLockFile))}`); const packageLockFileExists = await pathExists(packageLockFile); if (packageLockFileExists) { await unlink(packageLockFile); } tasks.next(`Removing ${strong(prettyPath(nodeModulesDir))}`); await remove(nodeModulesDir); tasks.end(); await this.env.shell.run(installer, installerArgs, { cwd: project.directory, stdio: 'inherit' }); } async cordovaRepair(cordova: Required, runinfo: CommandInstanceInfo) { const tasks = this.createTaskChain(); const platformsDir = path.resolve(cordova.root, 'platforms'); const pluginsDir = path.resolve(cordova.root, 'plugins'); tasks.next(`Removing ${strong(prettyPath(platformsDir))}`); await remove(platformsDir); tasks.next(`Removing ${strong(prettyPath(pluginsDir))}`); await remove(pluginsDir); tasks.end(); await runCommand(runinfo, ['cordova', 'prepare', '--no-build']); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/serve.ts000066400000000000000000000132361425441362600255320ustar00rootroot00000000000000import { Footnote, MetadataGroup } from '@ionic/cli-framework'; import { sleepForever } from '@ionic/utils-process'; import * as lodash from 'lodash'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, CommandPreRun } from '../definitions'; import { input, strong, weak } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException, RunnerException } from '../lib/errors'; import { getFullCommandParts } from '../lib/executor'; import { BROWSERS, COMMON_SERVE_COMMAND_OPTIONS, DEFAULT_LAB_PORT } from '../lib/serve'; export class ServeCommand extends Command implements CommandPreRun { async getMetadata(): Promise { const groups: string[] = []; let options: CommandMetadataOption[] = [ ...COMMON_SERVE_COMMAND_OPTIONS, { name: 'lab-host', summary: 'Use specific host for Ionic Lab server', default: 'localhost', groups: [MetadataGroup.ADVANCED], spec: { value: 'host' }, hint: weak('(--lab)'), }, { name: 'lab-port', summary: 'Use specific port for Ionic Lab server', default: DEFAULT_LAB_PORT.toString(), groups: [MetadataGroup.ADVANCED], spec: { value: 'port' }, hint: weak('(--lab)'), }, { name: 'open', summary: 'Do not open a browser window', type: Boolean, default: true, // TODO: Adding 'b' to aliases here has some weird behavior with minimist. }, { name: 'browser', summary: `Specifies the browser to use (${BROWSERS.map(b => input(b)).join(', ')})`, aliases: ['w'], groups: [MetadataGroup.ADVANCED], }, { name: 'browseroption', summary: `Specifies a path to open to (${input('/#/tab/dash')})`, aliases: ['o'], groups: [MetadataGroup.ADVANCED], spec: { value: 'path' }, }, { name: 'lab', summary: 'Test your apps on multiple platform types in the browser', type: Boolean, aliases: ['l'], }, ]; const exampleCommands = ['', '--external', '--lab']; const footnotes: Footnote[] = []; let description = ` Easily spin up a development server which launches in your browser. It watches for changes in your source files and automatically reloads with the updated build. By default, ${input('ionic serve')} boots up a development server on ${input('localhost')}. To serve to your LAN, specify the ${input('--external')} option, which will use all network interfaces and print the external address(es) on which your app is being served. Try the ${input('--lab')} option to see multiple platforms at once.`; const runner = this.project && await this.project.getServeRunner(); if (runner) { const libmetadata = await runner.getCommandMetadata(); groups.push(...libmetadata.groups || []); options = lodash.uniqWith([...libmetadata.options || [], ...options], (optionA, optionB) => optionA.name === optionB.name); description += `\n\n${(libmetadata.description || '').trim()}`; footnotes.push(...libmetadata.footnotes || []); exampleCommands.push(...libmetadata.exampleCommands || []); } return { name: 'serve', type: 'project', summary: 'Start a local dev server for app dev/testing', description, footnotes, groups, exampleCommands, options, }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions, { location }: CommandInstanceInfo): Promise { const parts = getFullCommandParts(location); const alias = lodash.last(parts); if (alias === 'lab') { options['lab'] = true; } if (options['nolivereload']) { this.env.log.warn(`The ${input('--nolivereload')} option has been deprecated. Please use ${input('--no-livereload')}.`); options['livereload'] = false; } if (options['nobrowser']) { this.env.log.warn(`The ${input('--nobrowser')} option has been deprecated. Please use ${input('--no-open')}.`); options['open'] = false; } if (options['b']) { options['open'] = false; } if (options['noproxy']) { this.env.log.warn(`The ${input('--noproxy')} option has been deprecated. Please use ${input('--no-proxy')}.`); options['proxy'] = false; } if (options['x']) { options['proxy'] = false; } } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic serve')} outside a project directory.`); } try { const runner = await this.project.requireServeRunner(); const runnerOpts = runner.createOptionsFromCommandLine(inputs, options); await runner.run(runnerOpts); } catch (e) { if (e instanceof RunnerException) { throw new FatalException(e.message); } throw e; } await sleepForever(); } } export class LabCommand extends ServeCommand { async getMetadata(): Promise { const metadata = await super.getMetadata(); const groups = [...metadata.groups || [], MetadataGroup.HIDDEN]; const exampleCommands = [...metadata.exampleCommands || []].filter(c => !c.includes('--lab')); return { ...metadata, summary: 'Start Ionic Lab for multi-platform dev/testing', description: ` Start an instance of ${strong('Ionic Lab')}, a tool for developing Ionic apps for multiple platforms at once side-by-side. ${input('ionic lab')} is just a convenient shortcut for ${input('ionic serve --lab')}.`, groups, exampleCommands, }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/share.ts000066400000000000000000000013201425441362600254770ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandMetadata } from '../definitions'; import { input, strong } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; export class ShareCommand extends Command { async getMetadata(): Promise { return { name: 'share', type: 'global', summary: '', groups: [MetadataGroup.HIDDEN], }; } async run(): Promise { const dashUrl = this.env.config.getDashUrl(); throw new FatalException( `${input('ionic share')} has been removed.\n` + `The functionality now exists in the Ionic Dashboard: ${strong(dashUrl)}` ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/signup.ts000066400000000000000000000015711425441362600257120ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { Command } from '../lib/command'; import { openUrl } from '../lib/open'; export class SignupCommand extends Command { async getMetadata(): Promise { return { name: 'signup', type: 'global', summary: 'Create an Ionic account', description: ` If you are having issues signing up, please get in touch with our Support[^support-request]. `, footnotes: [ { id: 'support-request', url: 'https://ion.link/support-request', }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const dashUrl = this.env.config.getDashUrl(); await openUrl(`${dashUrl}/signup?source=cli`); this.env.log.ok('Launched signup form in your browser!'); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/000077500000000000000000000000001425441362600246265ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/add.ts000066400000000000000000000102441425441362600257270ustar00rootroot00000000000000import { validators } from '@ionic/cli-framework'; import { pathAccessible, pathExists } from '@ionic/utils-fs'; import { expandPath, prettyPath } from '@ionic/utils-terminal'; import * as fs from 'fs'; import * as os from 'os'; import * as path from 'path'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { isSuperAgentError } from '../../guards'; import { input, strong } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { runCommand } from '../../lib/executor'; import { SSHBaseCommand } from './base'; export class SSHAddCommand extends SSHBaseCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'add', type: 'global', summary: 'Add an SSH public key to Ionic', inputs: [ { name: 'pubkey-path', summary: 'Location of public key file to add to Ionic', validators: [validators.required], }, ], options: [ { name: 'use', summary: 'Use the newly added key as your default SSH key for Ionic', type: Boolean, }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!inputs[0]) { const defaultPubkeyPath = path.resolve(os.homedir(), '.ssh', 'id_rsa.pub'); const defaultPubkeyExists = await pathAccessible(defaultPubkeyPath, fs.constants.R_OK); const pubkeyPath = await this.env.prompt({ type: 'input', name: 'pubkeyPath', message: 'Enter the location to your public key file to upload to Ionic:', default: defaultPubkeyExists ? prettyPath(defaultPubkeyPath) : undefined, }); inputs[0] = pubkeyPath; } } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { const { ERROR_SSH_INVALID_PUBKEY, SSHKeyClient, parsePublicKeyFile } = await import('../../lib/ssh'); const pubkeyPath = expandPath(inputs[0]); const pubkeyName = prettyPath(pubkeyPath); let pubkey: string; try { [ pubkey ] = await parsePublicKeyFile(pubkeyPath); } catch (e) { if (e.code === 'ENOENT') { throw new FatalException( `${strong(prettyPath(pubkeyPath))} does not appear to exist. Please specify a valid SSH public key.\n` + `If you are having issues, try using ${input('ionic ssh setup')}.` ); } else if (e === ERROR_SSH_INVALID_PUBKEY) { throw new FatalException( `${strong(pubkeyName)} does not appear to be a valid SSH public key. (Not in ${strong('authorized_keys')} file format.)\n` + `If you are having issues, try using ${input('ionic ssh setup')}.` ); } throw e; } const user = this.env.session.getUser(); const token = await this.env.session.getUserToken(); const sshkeyClient = new SSHKeyClient({ client: this.env.client, token, user }); try { const key = await sshkeyClient.create({ pubkey }); this.env.log.ok(`Your public key (${strong(key.fingerprint)}) has been added to Ionic!`); } catch (e) { if (isSuperAgentError(e) && e.response.status === 409) { this.env.log.msg('Pubkey already added to Ionic.'); } else { throw e; } } if (pubkeyPath.endsWith('.pub')) { let confirm = options['use']; if (!confirm) { confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'Would you like to use this key as your default for Ionic?', }); } if (confirm) { const keyPath = pubkeyPath.substring(0, pubkeyPath.length - 4); // corresponding private key, theoretically const keyExists = await pathExists(keyPath); if (keyExists) { await runCommand(runinfo, ['ssh', 'use', prettyPath(keyPath)]); } else { this.env.log.error( `SSH key does not exist: ${strong(prettyPath(keyPath))}.\n` + `Please use ${input('ionic ssh use')} manually to use the corresponding private key.` ); } } } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/base.ts000066400000000000000000000013361425441362600261130ustar00rootroot00000000000000import { ERROR_COMMAND_NOT_FOUND, SubprocessError } from '@ionic/utils-subprocess'; import { strong } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; export abstract class SSHBaseCommand extends Command { async checkForOpenSSH() { try { await this.env.shell.run('ssh', ['-V'], { stdio: 'ignore', showCommand: false, fatalOnNotFound: false }); } catch (e) { if (!(e instanceof SubprocessError && e.code === ERROR_COMMAND_NOT_FOUND)) { throw e; } this.env.log.warn('OpenSSH not found on your computer.'); // TODO: more helpful message throw new FatalException(`Command not found: ${strong('ssh')}`); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/delete.ts000066400000000000000000000040751425441362600264460ustar00rootroot00000000000000import { validators } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input, strong } from '../../lib/color'; import { SSHBaseCommand } from './base'; export class SSHDeleteCommand extends SSHBaseCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'delete', type: 'global', summary: 'Delete an SSH public key from Ionic', inputs: [ { name: 'key-id', summary: 'The ID of the public key to delete', validators: [validators.required], }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { SSHKeyClient } = await import('../../lib/ssh'); if (!inputs[0]) { const user = this.env.session.getUser(); const token = await this.env.session.getUserToken(); const sshkeyClient = new SSHKeyClient({ client: this.env.client, user, token }); const paginator = sshkeyClient.paginate(); const [ r ] = paginator; const res = await r; if (res.data.length === 0) { this.env.log.warn(`No SSH keys found. Use ${input('ionic ssh add')} to add keys to Ionic.`); } inputs[0] = await this.env.prompt({ type: 'list', name: 'id', message: 'Which SSH keys would you like to delete from Ionic?', choices: res.data.map(key => ({ name: `${key.fingerprint} ${key.name} ${key.annotation}`, value: key.id, })), }); } } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { SSHKeyClient } = await import('../../lib/ssh'); const [ id ] = inputs; const user = this.env.session.getUser(); const token = await this.env.session.getUserToken(); const sshkeyClient = new SSHKeyClient({ client: this.env.client, user, token }); await sshkeyClient.delete(id); this.env.log.ok(`Your public key (${strong(id)}) has been removed from Ionic.`); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/generate.ts000066400000000000000000000077531425441362600270040ustar00rootroot00000000000000import { MetadataGroup, contains, validate } from '@ionic/cli-framework'; import { mkdirp, pathExists, unlink } from '@ionic/utils-fs'; import { expandPath, prettyPath } from '@ionic/utils-terminal'; import * as path from 'path'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input, strong } from '../../lib/color'; import { SSHBaseCommand } from './base'; const SSH_KEY_TYPES = ['ecdsa', 'ed25519', 'rsa']; export class SSHGenerateCommand extends SSHBaseCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'generate', type: 'global', summary: 'Generates a private and public SSH key pair', inputs: [ { name: 'key-path', summary: 'Destination of private key file', }, ], options: [ { name: 'type', summary: `The type of key to generate: ${SSH_KEY_TYPES.map(v => input(v)).join(', ')}`, default: 'rsa', aliases: ['t'], groups: [MetadataGroup.ADVANCED], }, { name: 'bits', summary: 'Number of bits in the key', aliases: ['b'], default: '2048', groups: [MetadataGroup.ADVANCED], }, { name: 'annotation', summary: 'Annotation (comment) in public key. Your Ionic email address will be used', aliases: ['C'], groups: [MetadataGroup.ADVANCED], }, ], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { await this.checkForOpenSSH(); await this.env.session.getUserToken(); if (!options['annotation']) { options['annotation'] = this.env.config.get('user.email'); } validate(String(options['type']), 'type', [contains(SSH_KEY_TYPES, { caseSensitive: false })]); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { getGeneratedPrivateKeyPath } = await import('../../lib/ssh'); const { bits, annotation } = options; const keyPath = inputs[0] ? expandPath(String(inputs[0])) : await getGeneratedPrivateKeyPath(this.env.config.get('user.id')); const keyPathDir = path.dirname(keyPath); const pubkeyPath = `${keyPath}.pub`; if (!(await pathExists(keyPathDir))) { await mkdirp(keyPathDir, 0o700 as any); this.env.log.msg(`Created ${strong(prettyPath(keyPathDir))} directory for you.`); } if (await pathExists(keyPath)) { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `Key ${strong(prettyPath(keyPath))} exists. Overwrite?`, }); if (confirm) { await unlink(keyPath); } else { this.env.log.msg(`Not overwriting ${strong(prettyPath(keyPath))}.`); return; } } this.env.log.info( 'Enter a passphrase for your private key.\n' + `You will be prompted to provide a ${strong('passphrase')}, which is used to protect your private key should you lose it. (If someone has your private key, they can impersonate you!) Passphrases are recommended, but not required.\n` ); await this.env.shell.run( 'ssh-keygen', ['-q', '-t', String(options['type']), '-b', String(bits), '-C', String(annotation), '-f', keyPath], { stdio: 'inherit', showCommand: false, showError: false } ); this.env.log.nl(); this.env.log.rawmsg( `Private Key (${strong(prettyPath(keyPath))}): Keep this safe!\n` + `Public Key (${strong(prettyPath(pubkeyPath))}): Give this to all your friends!\n\n` ); this.env.log.ok('A new pair of SSH keys has been generated!'); this.env.log.nl(); this.env.log.msg( `${strong('Next steps:')}\n` + ` * Add your public key to Ionic: ${input('ionic ssh add ' + prettyPath(pubkeyPath))}\n` + ` * Use your private key for secure communication with Ionic: ${input('ionic ssh use ' + prettyPath(keyPath))}` ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/index.ts000066400000000000000000000032551425441362600263120ustar00rootroot00000000000000import { input } from '../../lib/color'; import { CommandMap, Namespace } from '../../lib/namespace'; export class SSHNamespace extends Namespace { async getMetadata() { const dashUrl = this.env.config.getDashUrl(); return { name: 'ssh', summary: 'Commands for configuring SSH keys', description: ` These commands help automate your SSH configuration for Ionic. As an alternative, SSH configuration can be done entirely manually by visiting your Personal Settings[^dashboard-settings-ssh-keys]. To begin, run ${input('ionic ssh setup')}, which lets you use existing keys or generate new ones just for Ionic. `, footnotes: [ { id: 'dashboard-settings-ssh-keys', url: `${dashUrl}/settings/ssh-keys`, }, ], }; } async getCommands(): Promise { return new CommandMap([ ['generate', async () => { const { SSHGenerateCommand } = await import('./generate'); return new SSHGenerateCommand(this); }], ['use', async () => { const { SSHUseCommand } = await import('./use'); return new SSHUseCommand(this); }], ['add', async () => { const { SSHAddCommand } = await import('./add'); return new SSHAddCommand(this); }], ['delete', async () => { const { SSHDeleteCommand } = await import('./delete'); return new SSHDeleteCommand(this); }], ['list', async () => { const { SSHListCommand } = await import('./list'); return new SSHListCommand(this); }], ['setup', async () => { const { SSHSetupCommand } = await import('./setup'); return new SSHSetupCommand(this); }], ['ls', 'list'], ['remove', 'delete'], ['rm', 'delete'], ['g', 'generate'], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/list.ts000066400000000000000000000061461425441362600261600ustar00rootroot00000000000000import { columnar } from '@ionic/utils-terminal'; import { COLUMNAR_OPTIONS } from '../../constants'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input, strong } from '../../lib/color'; import { SSHBaseCommand } from './base'; export class SSHListCommand extends SSHBaseCommand implements CommandPreRun { async getMetadata(): Promise { return { name: 'list', type: 'global', summary: 'List your SSH public keys on Ionic', options: [ { name: 'json', summary: 'Output SSH keys in JSON', type: Boolean, }, ], }; } async preRun() { await this.checkForOpenSSH(); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { SSHKeyClient } = await import('../../lib/ssh'); const { findHostSection, getConfigPath, isDirective, loadFromPath } = await import('../../lib/ssh-config'); const { json } = options; const user = this.env.session.getUser(); const token = await this.env.session.getUserToken(); const sshkeyClient = new SSHKeyClient({ client: this.env.client, user, token }); const paginator = sshkeyClient.paginate(); const [ r ] = paginator; const res = await r; if (json) { process.stdout.write(JSON.stringify(res.data)); } else { let activeFingerprint: string | undefined; let foundActiveKey = false; const sshConfigPath = getConfigPath(); const conf = await loadFromPath(sshConfigPath); const section = findHostSection(conf, this.env.config.getGitHost()); if (section && section.config) { const [ identityFile ] = section.config.filter(line => { return isDirective(line) && line.param === 'IdentityFile'; }); if (isDirective(identityFile)) { const output = await this.env.shell.output('ssh-keygen', ['-E', 'sha256', '-lf', identityFile.value], { fatalOnError: false }); activeFingerprint = output.trim().split(' ')[1]; } } if (res.data.length === 0) { this.env.log.warn(`No SSH keys found. Use ${input('ionic ssh add')} to add keys to Ionic.`); return; } const keysMatrix = res.data.map(sshkey => { const data = [sshkey.fingerprint, sshkey.name, sshkey.annotation]; if (sshkey.fingerprint === activeFingerprint) { foundActiveKey = true; return data.map(v => strong(v)); } return data; }); const table = columnar(keysMatrix, { ...COLUMNAR_OPTIONS, headers: ['fingerprint', 'name', 'annotation'].map(h => strong(h)), }); if (foundActiveKey) { this.env.log.nl(); this.env.log.msg(`The row in ${strong('bold')} is the key that this computer is using. To change, use ${input('ionic ssh use')}.`); } this.env.log.nl(); this.env.log.rawmsg(table); this.env.log.nl(); this.env.log.ok(`Showing ${strong(String(res.data.length))} SSH key${res.data.length === 1 ? '' : 's'}.`); this.env.log.nl(); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/setup.ts000066400000000000000000000115661425441362600263470ustar00rootroot00000000000000import { pathExists } from '@ionic/utils-fs'; import { prettyPath } from '@ionic/utils-terminal'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input, strong } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { runCommand } from '../../lib/executor'; import { SSHBaseCommand } from './base'; export class SSHSetupCommand extends SSHBaseCommand { async getMetadata(): Promise { const dashUrl = this.env.config.getDashUrl(); return { name: 'setup', type: 'global', summary: 'Setup your Ionic SSH keys automatically', description: ` This command offers a setup wizard for Ionic SSH keys using a series of prompts. For more control, see the commands available for managing SSH keys with the ${input('ionic ssh --help')} command. For an entirely manual approach, see ${strong('Personal Settings')} => ${strong('SSH Keys')} in the Dashboard[^dashboard-settings-ssh-keys]. If you are having issues setting up SSH keys, please get in touch with our Support[^support-request]. `, footnotes: [ { id: 'dashboard-settings-ssh-keys', url: `${dashUrl}/settings/ssh-keys`, }, { id: 'support-request', url: 'https://ion.link/support-request', }, ], }; } async preRun() { await this.checkForOpenSSH(); } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { const { getGeneratedPrivateKeyPath } = await import('../../lib/ssh'); const { getConfigPath } = await import('../../lib/ssh-config'); const { promptToLogin } = await import('../../lib/session'); if (!this.env.session.isLoggedIn()) { await promptToLogin(this.env); } const CHOICE_AUTOMATIC = 'automatic'; const CHOICE_MANUAL = 'manual'; const CHOICE_SKIP = 'skip'; const CHOICE_IGNORE = 'ignore'; if (this.env.config.get('git.setup')) { const rerun = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `SSH setup wizard has run before. Would you like to run it again?`, }); if (!rerun) { return; } } else { this.env.log.msg(`Looks like you haven't configured your SSH settings yet.`); } // TODO: link to docs about manual git setup const setupChoice = await this.env.prompt({ type: 'list', name: 'setupChoice', message: `How would you like to connect to Ionic?`, choices: [ { name: 'Automatically setup new a SSH key pair for Ionic', value: CHOICE_AUTOMATIC, }, { name: 'Use an existing SSH key pair', value: CHOICE_MANUAL, }, { name: 'Skip for now', value: CHOICE_SKIP, }, { name: 'Ignore this prompt forever', value: CHOICE_IGNORE, }, ], }); if (setupChoice === CHOICE_AUTOMATIC) { const sshconfigPath = getConfigPath(); const keyPath = await getGeneratedPrivateKeyPath(this.env.config.get('user.id')); const pubkeyPath = `${keyPath}.pub`; const [ pubkeyExists, keyExists ] = await Promise.all([pathExists(keyPath), pathExists(pubkeyPath)]); if (!pubkeyExists && !keyExists) { this.env.log.info( 'The automatic SSH setup will do the following:\n' + `1) Generate a new SSH key pair with OpenSSH (will not overwrite any existing keys).\n` + `2) Upload the generated SSH public key to our server, registering it on your account.\n` + `3) Modify your SSH config (${strong(prettyPath(sshconfigPath))}) to use the generated SSH private key for our server(s).` ); const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'May we proceed?', }); if (!confirm) { throw new FatalException(); } } if (pubkeyExists && keyExists) { this.env.log.msg( `Using your previously generated key: ${strong(prettyPath(keyPath))}.\n` + `You can generate a new one by deleting it.` ); } else { await runCommand(runinfo, ['ssh', 'generate', keyPath]); } await runCommand(runinfo, ['ssh', 'add', pubkeyPath, '--use']); } else if (setupChoice === CHOICE_MANUAL) { await runCommand(runinfo, ['ssh', 'add']); } if (setupChoice === CHOICE_SKIP) { this.env.log.warn(`Skipping for now. You can configure your SSH settings using ${input('ionic ssh setup')}.`); } else { if (setupChoice === CHOICE_IGNORE) { this.env.log.ok(`We won't pester you about SSH settings anymore!`); } else { this.env.log.ok('SSH setup successful!'); } this.env.config.set('git.setup', true); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssh/use.ts000066400000000000000000000067761425441362600260120ustar00rootroot00000000000000import { validators } from '@ionic/cli-framework'; import { fileToString, writeFile } from '@ionic/utils-fs'; import { expandPath, prettyPath } from '@ionic/utils-terminal'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../definitions'; import { input, strong } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { SSHBaseCommand } from './base'; export class SSHUseCommand extends SSHBaseCommand { async getMetadata(): Promise { return { name: 'use', type: 'global', summary: 'Set your active Ionic SSH key', description: ` This command modifies the SSH configuration file (${strong('~/.ssh/config')}) to set an active private key for the ${strong('git.ionicjs.com')} host. Read more about SSH configuration by running the ${input('man ssh_config')} command or by visiting online man pages[^ssh-config-docs]. Before making changes, ${input('ionic ssh use')} will print a diff and ask for permission to write the file. `, footnotes: [ { id: 'ssh-config-docs', url: 'https://linux.die.net/man/5/ssh_config', }, ], inputs: [ { name: 'key-path', summary: 'Location of private key file to use', validators: [validators.required], }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { ERROR_SSH_INVALID_PRIVKEY, ERROR_SSH_MISSING_PRIVKEY, validatePrivateKey } = await import('../../lib/ssh'); const { ensureHostAndKeyPath, getConfigPath } = await import('../../lib/ssh-config'); const keyPath = expandPath(inputs[0]); try { await validatePrivateKey(keyPath); } catch (e) { if (e === ERROR_SSH_MISSING_PRIVKEY) { throw new FatalException( `${strong(prettyPath(keyPath))} does not appear to exist. Please specify a valid SSH private key.\n` + `If you are having issues, try using ${input('ionic ssh setup')}.` ); } else if (e === ERROR_SSH_INVALID_PRIVKEY) { throw new FatalException( `${strong(prettyPath(keyPath))} does not appear to be a valid SSH private key. (Missing '-----BEGIN RSA PRIVATE KEY-----' header.)\n` + `If you are having issues, try using ${input('ionic ssh setup')}.` ); } else { throw e; } } const { SSHConfig } = await import('../../lib/ssh-config'); const sshConfigPath = getConfigPath(); const text1 = await fileToString(sshConfigPath); const conf = SSHConfig.parse(text1); ensureHostAndKeyPath(conf, { host: this.env.config.getGitHost(), port: this.env.config.getGitPort() }, keyPath); const text2 = SSHConfig.stringify(conf); if (text1 === text2) { this.env.log.msg(`${strong(prettyPath(keyPath))} is already your active SSH key.`); return; } else { const { diffPatch } = await import('../../lib/diff'); const diff = await diffPatch(sshConfigPath, text1, text2); this.env.log.rawmsg(diff); const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `May we make the above change(s) to '${prettyPath(sshConfigPath)}'?`, }); if (!confirm) { // TODO: link to docs about manual git setup throw new FatalException(); } } await writeFile(sshConfigPath, text2, { encoding: 'utf8', mode: 0o600 }); this.env.log.ok(`Your active Ionic SSH key has been set to ${strong(keyPath)}!`); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssl/000077500000000000000000000000001425441362600246325ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssl/base.ts000066400000000000000000000013511425441362600261140ustar00rootroot00000000000000import { ERROR_COMMAND_NOT_FOUND, SubprocessError } from '@ionic/utils-subprocess'; import { input } from '../../lib/color'; import { Command } from '../../lib/command'; import { FatalException } from '../../lib/errors'; export abstract class SSLBaseCommand extends Command { async checkForOpenSSL() { try { await this.env.shell.run('openssl', ['version'], { stdio: 'ignore', showCommand: false, fatalOnNotFound: false }); } catch (e) { if (!(e instanceof SubprocessError && e.code === ERROR_COMMAND_NOT_FOUND)) { throw e; } this.env.log.warn('OpenSSL not found on your computer.'); // TODO: more helpful message throw new FatalException(`Command not found: ${input('openssl')}`); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssl/generate.ts000066400000000000000000000173001425441362600267750ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { mkdirp, pathExists, tmpfilepath, unlink, writeFile } from '@ionic/utils-fs'; import { prettyPath } from '@ionic/utils-terminal'; import * as lodash from 'lodash'; import * as path from 'path'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun } from '../../definitions'; import { input, strong } from '../../lib/color'; import { FatalException } from '../../lib/errors'; import { SSLBaseCommand } from './base'; const DEFAULT_BITS = '2048'; const DEFAULT_COUNTRY_NAME = 'US'; const DEFAULT_STATE_OR_PROVINCE_NAME = 'Wisconsin'; const DEFAULT_LOCALITY_NAME = 'Madison'; const DEFAULT_ORGANIZATION_NAME = 'Ionic'; const DEFAULT_COMMON_NAME = 'localhost'; interface OpenSSLConfig { bits: string; countryName: string; stateOrProvinceName: string; localityName: string; organizationName: string; commonName: string; } const DEFAULT_KEY_FILE = '.ionic/ssl/key.pem'; const DEFAULT_CERT_FILE = '.ionic/ssl/cert.pem'; export class SSLGenerateCommand extends SSLBaseCommand implements CommandPreRun { getDefaultKeyPath() { return path.resolve(this.project ? this.project.directory : '', DEFAULT_KEY_FILE); } getDefaultCertPath() { return path.resolve(this.project ? this.project.directory : '', DEFAULT_CERT_FILE); } async getMetadata(): Promise { const defaultKeyPath = prettyPath(this.getDefaultKeyPath()); const defaultCertPath = prettyPath(this.getDefaultCertPath()); return { name: 'generate', type: 'project', summary: 'Generates an SSL key & certificate', // TODO: document how to add trusted certs description: ` Uses OpenSSL to create a self-signed certificate for ${strong('localhost')} (by default). After the certificate is generated, you will still need to add it to your system or browser as a trusted certificate. The default directory for ${input('--key-path')} and ${input('--cert-path')} is ${input('.ionic/ssl/')}. `, options: [ { name: 'key-path', summary: 'Destination of private key file', default: defaultKeyPath, spec: { value: 'path' }, }, { name: 'cert-path', summary: 'Destination of certificate file', default: defaultCertPath, spec: { value: 'path' }, }, { name: 'country-name', summary: 'The country name (C) of the SSL certificate', default: DEFAULT_COUNTRY_NAME, groups: [MetadataGroup.ADVANCED], spec: { value: 'C' }, }, { name: 'state-or-province-name', summary: 'The state or province name (ST) of the SSL certificate', default: DEFAULT_STATE_OR_PROVINCE_NAME, groups: [MetadataGroup.ADVANCED], spec: { value: 'ST' }, }, { name: 'locality-name', summary: 'The locality name (L) of the SSL certificate', default: DEFAULT_LOCALITY_NAME, groups: [MetadataGroup.ADVANCED], spec: { value: 'L' }, }, { name: 'organization-name', summary: 'The organization name (O) of the SSL certificate', default: DEFAULT_ORGANIZATION_NAME, groups: [MetadataGroup.ADVANCED], spec: { value: 'O' }, }, { name: 'common-name', summary: 'The common name (CN) of the SSL certificate', default: DEFAULT_COMMON_NAME, groups: [MetadataGroup.ADVANCED], spec: { value: 'CN' }, }, { name: 'bits', summary: 'Number of bits in the key', aliases: ['b'], default: DEFAULT_BITS, groups: [MetadataGroup.ADVANCED], }, ], groups: [MetadataGroup.EXPERIMENTAL], }; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { await this.checkForOpenSSL(); } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!this.project) { throw new FatalException(`Cannot run ${input('ionic ssl generate')} outside a project directory.`); } const keyPath = path.resolve(options['key-path'] ? String(options['key-path']) : this.getDefaultKeyPath()); const keyPathDir = path.dirname(keyPath); const certPath = path.resolve(options['cert-path'] ? String(options['cert-path']) : this.getDefaultCertPath()); const certPathDir = path.dirname(certPath); const bits = options['bits'] ? String(options['bits']) : DEFAULT_BITS; const countryName = options['country-name'] ? String(options['country-name']) : DEFAULT_COUNTRY_NAME; const stateOrProvinceName = options['state-or-province-name'] ? String(options['state-or-province-name']) : DEFAULT_STATE_OR_PROVINCE_NAME; const localityName = options['locality-name'] ? String(options['locality-name']) : DEFAULT_LOCALITY_NAME; const organizationName = options['organization-name'] ? String(options['organization-name']) : DEFAULT_ORGANIZATION_NAME; const commonName = options['common-name'] ? String(options['common-name']) : DEFAULT_COMMON_NAME; await this.ensureDirectory(keyPathDir); await this.ensureDirectory(certPathDir); const overwriteKeyPath = await this.checkExistingFile(keyPath); const overwriteCertPath = await this.checkExistingFile(certPath); if (overwriteKeyPath) { await unlink(keyPath); } if (overwriteCertPath) { await unlink(certPath); } const cnf = { bits, countryName, stateOrProvinceName, localityName, organizationName, commonName }; const cnfPath = await this.writeConfig(cnf); await this.env.shell.run('openssl', ['req', '-x509', '-newkey', `rsa:${bits}`, '-nodes', '-subj', this.formatSubj(cnf), '-reqexts', 'SAN', '-extensions', 'SAN', '-config', cnfPath, '-days', '365', '-keyout', keyPath, '-out', certPath], {}); this.env.log.nl(); this.env.log.rawmsg( `Key: ${strong(prettyPath(keyPath))}\n` + `Cert: ${strong(prettyPath(certPath))}\n\n` ); this.env.log.ok('Generated key & certificate!'); } private formatSubj(cnf: OpenSSLConfig) { const subjNames = new Map([ ['countryName', 'C'], ['stateOrProvinceName', 'ST'], ['localityName', 'L'], ['organizationName', 'O'], ['commonName', 'CN'], ]); return '/' + lodash.toPairs(cnf).filter(([k]) => subjNames.has(k)).map(([k, v]) => `${subjNames.get(k)}=${v}`).join('/'); } private async ensureDirectory(p: string) { if (!(await pathExists(p))) { await mkdirp(p, 0o700 as any); this.env.log.msg(`Created ${strong(prettyPath(p))} directory for you.`); } } private async checkExistingFile(p: string): Promise { if (await pathExists(p)) { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `Key ${strong(prettyPath(p))} exists. Overwrite?`, }); if (confirm) { return true; } else { throw new FatalException(`Not overwriting ${strong(prettyPath(p))}.`); } } } private async writeConfig({ bits, countryName, stateOrProvinceName, localityName, organizationName, commonName }: OpenSSLConfig): Promise { const cnf = ` [req] default_bits = ${bits} distinguished_name = req_distinguished_name [req_distinguished_name] countryName = ${countryName} stateOrProvinceName = ${stateOrProvinceName} localityName = ${localityName} organizationName = ${organizationName} commonName = ${commonName} [SAN] subjectAltName=DNS:${commonName} `.trim(); const p = tmpfilepath('ionic-ssl'); await writeFile(p, cnf, { encoding: 'utf8' }); return p; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/ssl/index.ts000066400000000000000000000013641425441362600263150ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { input } from '../../lib/color'; import { CommandMap, Namespace } from '../../lib/namespace'; export class SSLNamespace extends Namespace { async getMetadata() { return { name: 'ssl', summary: 'Commands for managing SSL keys & certificates', groups: [MetadataGroup.EXPERIMENTAL], description: ` These commands make it easy to manage SSL certificates for using HTTPS with ${input('ionic serve')}. `, }; } async getCommands(): Promise { return new CommandMap([ ['generate', async () => { const { SSLGenerateCommand } = await import('./generate'); return new SSLGenerateCommand(this); }], ['g', 'generate'], ]); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/start.ts000066400000000000000000000713271425441362600255500ustar00rootroot00000000000000import { MetadataGroup, validators } from '@ionic/cli-framework'; import { isValidURL, slugify } from '@ionic/cli-framework/utils/string'; import { mkdir, pathExists, remove, unlink } from '@ionic/utils-fs'; import { columnar, prettyPath } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as path from 'path'; import { COLUMNAR_OPTIONS, PROJECT_FILE } from '../constants'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandPreRun, IProject, IShellRunOptions, ProjectType, ResolvedStarterTemplate, StarterManifest } from '../definitions'; import { failure, input, strong } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; import { runCommand } from '../lib/executor'; import { createProjectFromDetails, createProjectFromDirectory, isValidProjectId } from '../lib/project'; import { promptToSignup } from '../lib/session'; import { prependNodeModulesBinToPath } from '../lib/shell'; import { AppSchema, STARTER_BASE_URL, STARTER_TEMPLATES, SUPPORTED_FRAMEWORKS, getAdvertisement, getStarterList, getStarterProjectTypes, readStarterManifest, verifyOptions } from '../lib/start'; import { emoji } from '../lib/utils/emoji'; import { createRequest } from '../lib/utils/http'; const debug = Debug('ionic:commands:start'); interface StartWizardApp { type: ProjectType; name: string; appId: string; template: string; 'package-id': string; tid: string; email: string; theme: string; ip: string; appIcon: string; appSplash: string; utm: { [key: string]: string }; } export class StartCommand extends Command implements CommandPreRun { private canRemoveExisting = false; private schema?: AppSchema; async getMetadata(): Promise { return { name: 'start', type: 'global', summary: 'Create a new project', description: ` This command creates a working Ionic app. It installs dependencies for you and sets up your project. Running ${input('ionic start')} without any arguments will prompt you for information about your new project. The first argument is your app's ${input('name')}. Don't worry--you can always change this later. The ${input('--project-id')} is generated from ${input('name')} unless explicitly specified. The second argument is the ${input('template')} from which to generate your app. You can list all templates with the ${input('--list')} option. You can also specify a git repository URL for ${input('template')}, in which case the existing project will be cloned. Use the ${input('--type')} option to start projects using older versions of Ionic. For example, you can start an Ionic 3 project with ${input('--type=ionic-angular')}. Use ${input('--list')} to see all project types and templates. `, exampleCommands: [ '', '--list', 'myApp', 'myApp blank', 'myApp tabs --cordova', 'myApp tabs --capacitor', 'myApp super --type=ionic-angular', 'myApp blank --type=ionic1', 'cordovaApp tabs --cordova', '"My App" blank', '"Conference App" https://github.com/ionic-team/ionic-conference-app', ], inputs: [ { name: 'name', summary: `The name of your new project (e.g. ${input('myApp')}, ${input('"My App"')})`, validators: [validators.required], }, { name: 'template', summary: `The starter template to use (e.g. ${['blank', 'tabs'].map(t => input(t)).join(', ')}; use ${input('--list')} to see all)`, validators: [validators.required], }, ], options: [ { name: 'list', summary: 'List available starter templates', type: Boolean, aliases: ['l'], }, { name: 'type', summary: `Type of project to start (e.g. ${getStarterProjectTypes().map(type => input(type)).join(', ')})`, type: String, }, { name: 'cordova', summary: 'Include Cordova integration', type: Boolean, groups: [MetadataGroup.DEPRECATED] }, { name: 'capacitor', summary: 'Include Capacitor integration', type: Boolean, }, { name: 'deps', summary: 'Do not install npm/yarn dependencies', type: Boolean, default: true, groups: [MetadataGroup.ADVANCED], }, { name: 'git', summary: 'Do not initialize a git repo', type: Boolean, default: true, groups: [MetadataGroup.ADVANCED], }, { name: 'link', summary: 'Connect your new app to Ionic', type: Boolean, groups: [MetadataGroup.ADVANCED], }, { name: 'id', summary: 'Specify an Ionic App ID to link', }, { name: 'project-id', summary: 'Specify a slug for your app (used for the directory name and package name)', groups: [MetadataGroup.ADVANCED], spec: { value: 'slug' }, }, { name: 'package-id', summary: 'Specify the bundle ID/application ID for your app (reverse-DNS notation)', groups: [MetadataGroup.ADVANCED], spec: { value: 'id' }, }, { name: 'start-id', summary: 'Used by the Ionic app start experience to generate an associated app locally', groups: [MetadataGroup.HIDDEN], spec: { value: 'id' }, }, { name: 'tag', summary: `Specify a tag to use for the starters (e.g. ${['latest', 'testing', 'next'].map(t => input(t)).join(', ')})`, default: 'latest', groups: [MetadataGroup.HIDDEN], }, ], }; } async startIdStart(inputs: CommandLineInputs, options: CommandLineOptions) { const startId = options['start-id']; const wizardApiUrl = process.env.START_WIZARD_URL_BASE || `https://ionicframework.com`; const { req } = await createRequest('GET', `${wizardApiUrl}/api/v1/wizard/app/${startId}`, this.env.config.getHTTPConfig()); const error = (e?: Error) => { this.env.log.error(`No such app ${chalk.bold(startId)}. This app configuration may have expired. Please retry at https://ionicframework.com/start`); if (e) { throw e; } }; let data: StartWizardApp; try { const ret = await req; if (ret.status !== 200) { return error(); } data = (await req).body as StartWizardApp; if (!data) { return error(); } } catch (e) { return error(e); } let projectDir = slugify(data.name); if (inputs.length === 1) { projectDir = inputs[0]; } await this.checkForExisting(projectDir); inputs.push(data.name); inputs.push(data.template); await this.startIdConvert(startId as string); const appIconBuffer = data.appIcon ? Buffer.from(data.appIcon.replace(/^data:image\/\w+;base64,/, ''), 'base64') : undefined; const splashBuffer = data.appSplash ? Buffer.from(data.appSplash.replace(/^data:image\/\w+;base64,/, ''), 'base64') : undefined; this.schema = { cloned: false, name: data.name, type: data.type, template: data.template, projectId: slugify(data.name), projectDir, packageId: data['package-id'], appflowId: undefined, appIcon: appIconBuffer, splash: splashBuffer, themeColor: data.theme, }; } async startIdConvert(id: string) { const wizardApiUrl = process.env.START_WIZARD_URL_BASE || `https://ionicframework.com`; if (!wizardApiUrl) { return; } const { req } = await createRequest('POST', `${wizardApiUrl}/api/v1/wizard/app/${id}/start`, this.env.config.getHTTPConfig()); try { await req; } catch (e) { this.env.log.warn(`Unable to set app flag on server: ${e.message}`); } } /** * Check if we should use the wizard for the start command. * We should use if they ran `ionic start` or `ionic start --capacitor` * and they are in an interactive environment. */ async shouldUseStartWizard(inputs: CommandLineInputs, options: CommandLineOptions) { const flagsToTestFor = [ 'list', 'l', 'cordova', 'link', 'help', 'h', 'type', 'id', 'project-id', 'package-id', 'start-id', ]; let didUseFlags = false ; for (const key of flagsToTestFor) { if (options[key] !== null) { didUseFlags = true; break; } } return inputs.length === 0 && options['interactive'] && options['deps'] && options['git'] && !didUseFlags; } async preRun(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const { promptToLogin } = await import('../lib/session'); verifyOptions(options, this.env); if (await this.shouldUseStartWizard(inputs, options)) { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'Use the app creation wizard?', default: true, }); if (confirm) { const startId = await this.env.session.wizardLogin(); if (!startId) { this.env.log.error('There was an issue using the web wizard. Falling back to CLI wizard.'); } else { options['start-id'] = startId; } } } const appflowId = options['id'] ? String(options['id']) : undefined; if (appflowId) { if (!this.env.session.isLoggedIn()) { await promptToLogin(this.env); } } // The start wizard pre-populates all arguments for the CLI if (options['start-id']) { await this.startIdStart(inputs, options); return; } const projectType = isValidURL(inputs[1]) ? 'custom' : options['type'] ? String(options['type']) : await this.getProjectType(); if (options['cordova']) { const { checkForUnsupportedProject } = await import('../lib/integrations/cordova/utils'); try { await checkForUnsupportedProject(projectType as ProjectType); } catch (e) { this.env.log.error(e.message); options['cordova'] = false; } } if (!inputs[0]) { if (appflowId) { const { AppClient } = await import('../lib/app'); const token = await this.env.session.getUserToken(); const appClient = new AppClient(token, this.env); const tasks = this.createTaskChain(); tasks.next(`Looking up app ${input(appflowId)}`); const app = await appClient.load(appflowId); // TODO: can ask to clone via repo_url tasks.end(); this.env.log.info(`Using ${strong(app.name)} for ${input('name')} and ${strong(app.slug)} for ${input('--project-id')}.`); inputs[0] = app.name; options['project-id'] = app.slug; } else { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.msg( `${strong(`Every great app needs a name! ${emoji('ðŸ˜', '')}`)}\n` + `Please enter the full name of your app. You can change this at any time. To bypass this prompt next time, supply ${input('name')}, the first argument to ${input('ionic start')}.\n\n` ); } const name = await this.env.prompt({ type: 'input', name: 'name', message: 'Project name:', validate: v => validators.required(v), }); inputs[0] = name; } } if (!inputs[1]) { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.msg( `${strong(`Let's pick the perfect starter template! ${emoji('💪', '')}`)}\n` + `Starter templates are ready-to-go Ionic apps that come packed with everything you need to build your app. To bypass this prompt next time, supply ${input('template')}, the second argument to ${input('ionic start')}.\n\n` ); } const template = await this.env.prompt({ type: 'list', name: 'template', message: 'Starter template:', choices: () => { const starterTemplateList = STARTER_TEMPLATES.filter(st => st.projectType === projectType); const cols = columnar(starterTemplateList.map(({ name, description }) => [input(name), description || '']), COLUMNAR_OPTIONS).split('\n'); if (starterTemplateList.length === 0) { throw new FatalException(`No starter templates found for project type: ${input(projectType)}.`); } return starterTemplateList.map((starter, i) => { return { name: cols[i], short: starter.name, value: starter.name, }; }); }, }); inputs[1] = template; } const starterTemplate = STARTER_TEMPLATES.find(t => t.name === inputs[1] && t.projectType === projectType); if (starterTemplate && starterTemplate.type === 'repo') { inputs[1] = starterTemplate.repo; } const cloned = isValidURL(inputs[1]); if (this.project && this.project.details.context === 'app') { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'You are already in an Ionic project directory. Do you really want to start another project here?', default: false, }); if (!confirm) { this.env.log.info('Not starting project within existing project.'); throw new FatalException(); } } await this.validateProjectType(projectType); if (cloned) { if (!options['git']) { this.env.log.warn(`The ${input('--no-git')} option has no effect when cloning apps. Git must be used.`); } options['git'] = true; } if (options['v1'] || options['v2']) { throw new FatalException( `The ${input('--v1')} and ${input('--v2')} flags have been removed.\n` + `Use the ${input('--type')} option. (see ${input('ionic start --help')})` ); } if (options['app-name']) { this.env.log.warn(`The ${input('--app-name')} option has been removed. Use the ${input('name')} argument with double quotes: e.g. ${input('ionic start "My App"')}`); } if (options['display-name']) { this.env.log.warn(`The ${input('--display-name')} option has been removed. Use the ${input('name')} argument with double quotes: e.g. ${input('ionic start "My App"')}`); } if (options['bundle-id']) { this.env.log.warn(`The ${input('--bundle-id')} option has been deprecated. Please use ${input('--package-id')}.`); options['package-id'] = options['bundle-id']; } let projectId = options['project-id'] ? String(options['project-id']) : undefined; if (projectId) { await this.validateProjectId(projectId); } else { projectId = options['project-id'] = isValidProjectId(inputs[0]) ? inputs[0] : slugify(inputs[0]); } const projectDir = path.resolve(projectId); const packageId = options['package-id'] ? String(options['package-id']) : undefined; if (projectId) { await this.checkForExisting(projectDir); } if (cloned) { this.schema = { cloned: true, url: inputs[1], projectId, projectDir, }; } else { this.schema = { cloned: false, name: inputs[0], type: projectType as ProjectType, template: inputs[1], projectId, projectDir, packageId, appflowId, themeColor: undefined, }; } } async getProjectType() { if (this.env.flags.interactive) { this.env.log.nl(); this.env.log.msg( `${strong(`Pick a framework! ${emoji('ðŸ˜', '')}`)}\n\n` + `Please select the JavaScript framework to use for your new app. To bypass this prompt next time, supply a value for the ${input('--type')} option.\n\n` ); } const frameworkChoice = await this.env.prompt({ type: 'list', name: 'frameworks', message: 'Framework:', default: 'angular', choices: () => { const cols = columnar(SUPPORTED_FRAMEWORKS.map(({ name, description }) => [input(name), description]), COLUMNAR_OPTIONS).split('\n'); return SUPPORTED_FRAMEWORKS.map((starterTemplate, i) => { return { name: cols[i], short: starterTemplate.name, value: starterTemplate.type, }; }); }, }); return frameworkChoice; } async run(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { const { pkgManagerArgs } = await import('../lib/utils/npm'); const { getTopLevel, isGitInstalled } = await import('../lib/git'); if (!this.schema) { throw new FatalException(`Invalid start schema: cannot start app.`); } const { projectId, projectDir, packageId, appflowId } = this.schema; const tag = options['tag'] ? String(options['tag']) : 'latest'; let linkConfirmed = typeof appflowId === 'string'; const gitDesired = options['git'] ? true : false; const gitInstalled = await isGitInstalled(this.env); const gitTopLevel = await getTopLevel(this.env); let gitIntegration = gitDesired && gitInstalled && !gitTopLevel ? true : false; if (!gitInstalled) { const installationDocs = `See installation docs for git: ${strong('https://git-scm.com/book/en/v2/Getting-Started-Installing-Git')}`; if (appflowId) { throw new FatalException( `Git CLI not found on your PATH.\n` + `Git must be installed to connect this app to Ionic. ${installationDocs}` ); } if (this.schema.cloned) { throw new FatalException( `Git CLI not found on your PATH.\n` + `Git must be installed to clone apps with ${input('ionic start')}. ${installationDocs}` ); } } if (gitTopLevel && !this.schema.cloned) { this.env.log.info(`Existing git project found (${strong(gitTopLevel)}). Git operations are disabled.`); } const tasks = this.createTaskChain(); tasks.next(`Preparing directory ${input(prettyPath(projectDir))}`); if (this.canRemoveExisting) { await remove(projectDir); } await mkdir(projectDir); tasks.end(); if (this.schema.cloned) { await this.env.shell.run('git', ['clone', this.schema.url, projectDir, '--progress'], { stdio: 'inherit' }); } else { const starterTemplate = await this.findStarterTemplate(this.schema.template, this.schema.type, tag); await this.downloadStarterTemplate(projectDir, starterTemplate); } let project: IProject | undefined; if (this.project && this.project.details.context === 'multiapp' && !this.schema.cloned) { // We're in a multi-app setup, so the new config file isn't wanted. await unlink(path.resolve(projectDir, PROJECT_FILE)); project = await createProjectFromDetails({ context: 'multiapp', configPath: path.resolve(this.project.rootDirectory, PROJECT_FILE), id: projectId, type: this.schema.type, errors: [] }, this.env); project.config.set('type', this.schema.type); project.config.set('root', path.relative(this.project.rootDirectory, projectDir)); } else { project = await createProjectFromDirectory(projectDir, { _: [] }, this.env, { logErrors: false }); } // start is weird, once the project directory is created, it becomes a // "project" command and so we replace the `Project` instance that was // autogenerated when the CLI booted up. This has worked thus far? this.namespace.root.project = project; if (!this.project) { throw new FatalException('Error while loading project.'); } this.env.shell.alterPath = p => prependNodeModulesBinToPath(projectDir, p); if (!this.schema.cloned) { if (this.schema.type === 'react' || this.schema.type === 'vue') { options['capacitor'] = true; } if (this.schema.type === 'angular' && options['cordova'] === null) { options['capacitor'] = true; } if (options['cordova']) { const { confirmCordovaUsage } = await import('../lib/integrations/cordova/utils'); const confirm = await confirmCordovaUsage(this.env); if (confirm) { await runCommand(runinfo, ['integrations', 'enable', 'cordova', '--quiet']); } else { options['cordova'] = false; } } if (options['capacitor'] === null && !options['cordova']) { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: 'Integrate your new app with Capacitor to target native iOS and Android?', default: false, }); if (confirm) { options['capacitor'] = true; } } if (options['capacitor']) { await runCommand(runinfo, ['integrations', 'enable', 'capacitor', '--quiet', '--', this.schema.name, packageId ? packageId : 'io.ionic.starter']); } await this.project.personalize({ name: this.schema.name, projectId, packageId, appIcon: this.schema.appIcon, splash: this.schema.splash, themeColor: this.schema.themeColor, }); this.env.log.nl(); } const shellOptions: IShellRunOptions = { cwd: projectDir, stdio: 'inherit' }; if (options['deps']) { this.env.log.msg('Installing dependencies may take several minutes.'); this.env.log.rawmsg(getAdvertisement()); const [installer, ...installerArgs] = await pkgManagerArgs(this.env.config.get('npmClient'), { command: 'install' }); await this.env.shell.run(installer, installerArgs, shellOptions); if (options['cordova']) { try { await this.env.shell.run('ng', ['add', '@ionic/cordova-builders', '--skip-confirmation'], { cwd: this.project.rootDirectory }); } catch (e) { debug('Error while adding @ionic/cordova-builders: %O', e); } } } else { // --no-deps flag was used so skip installing dependencies, this also results in the package.json being out sync with the package.json so warn the user this.env.log.warn('Using the --no-deps flag results in an out of date package lock file. The lock file can be updated by performing an `install` with your package manager.'); if (options['cordova']) { this.env.log.warn('@ionic/cordova-builders couldn\'t be added, make sure you run `ng add @ionic/cordova-builders` after performing an `install` with your package manager.'); } } if (!this.schema.cloned) { if (gitIntegration) { try { await this.env.shell.run('git', ['init'], shellOptions); // TODO: use initializeRepo()? } catch (e) { this.env.log.warn('Error encountered during repo initialization. Disabling further git operations.'); gitIntegration = false; } } // Prompt to create account if (!this.env.session.isLoggedIn()) { await promptToSignup(this.env); } if (options['link']) { const cmdArgs = ['link']; if (appflowId) { cmdArgs.push(appflowId); } cmdArgs.push('--name', this.schema.name); await runCommand(runinfo, cmdArgs); linkConfirmed = true; } const manifestPath = path.resolve(projectDir, 'ionic.starter.json'); const manifest = await this.loadManifest(manifestPath); if (manifest) { await unlink(manifestPath); } if (gitIntegration) { try { await this.env.shell.run('git', ['add', '-A'], shellOptions); await this.env.shell.run('git', ['commit', '-m', 'Initial commit', '--no-gpg-sign'], shellOptions); } catch (e) { this.env.log.warn('Error encountered during commit. Disabling further git operations.'); gitIntegration = false; } } if (manifest) { await this.performManifestOps(manifest); } } this.env.log.nl(); await this.showNextSteps(projectDir, this.schema.cloned, linkConfirmed, !options['cordova']); } async checkForExisting(projectDir: string) { const projectExists = await pathExists(projectDir); if (projectExists) { const confirm = await this.env.prompt({ type: 'confirm', name: 'confirm', message: `${input(prettyPath(projectDir))} exists. ${failure('Overwrite?')}`, default: false, }); if (!confirm) { this.env.log.msg(`Not erasing existing project in ${input(prettyPath(projectDir))}.`); throw new FatalException(); } this.canRemoveExisting = confirm; } } async findStarterTemplate(template: string, type: string, tag: string): Promise { const starterTemplate = STARTER_TEMPLATES.find(t => t.projectType === type && t.name === template); if (starterTemplate && starterTemplate.type === 'managed') { return { ...starterTemplate, archive: `${STARTER_BASE_URL}/${tag === 'latest' ? '' : `${tag}/`}${starterTemplate.id}.tar.gz`, }; } const tasks = this.createTaskChain(); tasks.next('Looking up starter'); const starterList = await getStarterList(this.env.config, tag); const starter = starterList.starters.find(t => t.type === type && t.name === template); if (starter) { tasks.end(); return { name: starter.name, projectType: starter.type, archive: `${STARTER_BASE_URL}/${tag === 'latest' ? '' : `${tag}/`}${starter.id}.tar.gz`, }; } else { throw new FatalException( `Unable to find starter template for ${input(template)}\n` + `If this is not a typo, please make sure it is a valid starter template within the starters repo: ${strong('https://github.com/ionic-team/starters')}` ); } } async validateProjectType(type: string) { const projectTypes = getStarterProjectTypes(); if (!['custom', ...projectTypes].includes(type)) { throw new FatalException( `${input(type)} is not a valid project type.\n` + `Please choose a different ${input('--type')}. Use ${input('ionic start --list')} to list all available starter templates.` ); } } async validateProjectId(projectId: string) { if (!isValidProjectId(projectId)) { throw new FatalException( `${input(projectId)} is not a valid package or directory name.\n` + `Please choose a different ${input('--project-id')}. Alphanumeric characters are always safe.` ); } } async loadManifest(manifestPath: string): Promise { try { return await readStarterManifest(manifestPath); } catch (e) { debug(`Error with manifest file ${strong(prettyPath(manifestPath))}: ${e}`); } } async performManifestOps(manifest: StarterManifest) { if (manifest.welcome) { this.env.log.nl(); this.env.log.msg(`${strong('Starter Welcome')}:`); this.env.log.msg(manifest.welcome); } } async downloadStarterTemplate(projectDir: string, starterTemplate: ResolvedStarterTemplate) { const { createRequest, download } = await import('../lib/utils/http'); const { tar } = await import('../lib/utils/archive'); const tasks = this.createTaskChain(); const task = tasks.next(`Downloading and extracting ${input(starterTemplate.name.toString())} starter`); debug('Tar extraction created for %s', projectDir); const ws = tar.extract({ cwd: projectDir }); const { req } = await createRequest('GET', starterTemplate.archive, this.env.config.getHTTPConfig()); await download(req, ws, { progress: (loaded, total) => task.progress(loaded, total) }); tasks.end(); } async showNextSteps(projectDir: string, cloned: boolean, linkConfirmed: boolean, isCapacitor: boolean) { const cordovaResCommand = isCapacitor ? 'cordova-res --skip-config --copy' : 'cordova-res'; const steps = [ `Go to your ${cloned ? 'cloned' : 'new'} project: ${input(`cd ${prettyPath(projectDir)}`)}`, `Run ${input('ionic serve')} within the app directory to see your app in the browser`, isCapacitor ? `Run ${input('ionic capacitor add')} to add a native iOS or Android project using Capacitor` : `Run ${input('ionic cordova platform add')} to add a native iOS or Android project using Cordova`, `Generate your app icon and splash screens using ${input(cordovaResCommand)}`, `Explore the Ionic docs for components, tutorials, and more: ${strong('https://ion.link/docs')}`, `Building an enterprise app? Ionic has Enterprise Support and Features: ${strong('https://ion.link/enterprise-edition')}`, ]; if (linkConfirmed) { steps.push(`Push your code to Ionic Appflow to perform real-time updates, and more: ${input('git push ionic master')}`); } this.env.log.msg(`${strong('Your Ionic app is ready! Follow these next steps')}:\n${steps.map(s => ` - ${s}`).join('\n')}`); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/state.ts000066400000000000000000000032211425441362600255170ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { columnar, indent } from '@ionic/utils-terminal'; import { COLUMNAR_OPTIONS } from '../constants'; import { CommandMetadata } from '../definitions'; import { input, strong } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; export class StateCommand extends Command { async getMetadata(): Promise { return { name: 'state', type: 'global', summary: '', groups: [MetadataGroup.HIDDEN], }; } async run(): Promise { const data = [ [`${indent(4)}${input('ionic cordova platform save')}`, `save existing installed platforms to ${strong('config.xml')}`], [`${indent(4)}${input('ionic cordova plugin save')}`, `save existing installed plugins to ${strong('config.xml')}`], [`${indent(4)}${input('ionic cordova platform --help')}`, `view help page for managing Cordova platforms`], [`${indent(4)}${input('ionic cordova plugin --help')}`, `view help page for managing Cordova plugins`], [`${indent(4)}${input('ionic cordova prepare')}`, `install platforms and plugins listed in ${strong('config.xml')}`], ]; throw new FatalException( `${input('ionic state')} has been removed.\n\n` + `We recommend using Cordova directly to manage Cordova plugins and platforms.\n` + `The following commands fulfill the old ${input('ionic state')} functionality:\n\n` + `${columnar(data, COLUMNAR_OPTIONS)}\n\n` + `See ${strong('https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/')} for detailed information.\n` ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/telemetry.ts000066400000000000000000000021041425441362600264100ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { input } from '../lib/color'; import { Command } from '../lib/command'; import { FatalException } from '../lib/errors'; export class TelemetryCommand extends Command { async getMetadata(): Promise { return { name: 'telemetry', type: 'global', summary: 'Opt in and out of telemetry', groups: [MetadataGroup.HIDDEN], inputs: [ { name: 'status', summary: `${input('on')} or ${input('off')}`, }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { throw new FatalException( `${input('ionic telemetry')} has been removed.\n` + `Please use ${input('ionic config')} directly. Examples:\n\n` + ` ${input('ionic config get -g telemetry')}\n` + ` ${input('ionic config set -g telemetry true')}\n` + ` ${input('ionic config set -g telemetry false')}` ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/commands/version.ts000066400000000000000000000012341425441362600260660ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata } from '../definitions'; import { Command } from '../lib/command'; export class VersionCommand extends Command { async getMetadata(): Promise { return { name: 'version', type: 'global', summary: 'Returns the current CLI version', groups: [MetadataGroup.HIDDEN], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions): Promise { // can't use logger--see https://github.com/ionic-team/ionic-cli/issues/2507 process.stdout.write(this.env.ctx.version + '\n'); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/constants.ts000066400000000000000000000012421425441362600246130ustar00rootroot00000000000000import * as chalk from 'chalk'; import * as lodash from 'lodash'; import * as path from 'path'; import { ProjectType } from './definitions'; export const ASSETS_DIRECTORY = path.resolve(__dirname, 'assets'); export const PROJECT_FILE = process.env['IONIC_CONFIG_FILE'] ?? 'ionic.config.json'; export const PROJECT_TYPES: ProjectType[] = ['angular', 'react', 'vue', 'ionic-angular', 'ionic1', 'custom']; export const LEGACY_PROJECT_TYPES: ProjectType[] = ['ionic-angular', 'ionic1']; export const MODERN_PROJECT_TYPES: ProjectType[] = lodash.difference(PROJECT_TYPES, LEGACY_PROJECT_TYPES); export const COLUMNAR_OPTIONS = { hsep: chalk.dim('-'), vsep: chalk.dim('|') }; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/definitions.ts000066400000000000000000000566551425441362600251340ustar00rootroot00000000000000import { BaseConfig, CommandInstanceInfo as FrameworkCommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata as FrameworkCommandMetadata, CommandMetadataInput as FrameworkCommandMetadataInput, CommandMetadataOption as FrameworkCommandMetadataOption, HydratedCommandMetadata as FrameworkHydratedCommandMetadata, ICommand as FrameworkCommand, INamespace as FrameworkNamespace, NamespaceLocateResult as FrameworkNamespaceLocateResult, PackageJson, } from '@ionic/cli-framework'; import { Logger } from '@ionic/cli-framework-output'; import { PromptModule } from '@ionic/cli-framework-prompts'; import { NetworkInterface } from '@ionic/utils-network'; import { Subprocess, SubprocessOptions, WhichOptions } from '@ionic/utils-subprocess'; import { ChildProcess, SpawnOptions } from 'child_process'; import * as fs from 'fs'; import type { Integration as CapacitorIntegration } from './lib/integrations/capacitor'; import type { CapacitorConfig } from './lib/integrations/capacitor/config'; import type { Integration as CordovaIntegration } from './lib/integrations/cordova'; import type { Integration as EnterpriseIntegration } from './lib/integrations/enterprise'; export { CommandLineInputs, CommandLineOptions, NamespaceMetadata, } from '@ionic/cli-framework'; export type SuperAgentRequest = import('superagent').SuperAgentRequest; export interface SuperAgentError extends Error { response: import('superagent').Response; } export type LogFn = (msg: string) => void; export interface ILogger extends Logger { ok: LogFn; rawmsg: LogFn; } export interface StarterManifest { name: string; baseref: string; welcome?: string; } export interface CordovaPackageJson extends PackageJson { cordova: { platforms: string[]; plugins: { [key: string]: unknown; }; }; } export interface LegacyAndroidBuildOutputEntry { outputType: { type: string; }; path: string; } export interface AndroidBuildOutput { artifactType: { type: string; }; elements: { outputFile: string; }[]; } export interface Runner { run(options: T): Promise; } export type ProjectType = 'angular' | 'ionic-angular' | 'ionic1' | 'custom' | 'bare' | 'react' | 'vue'; export type HookName = 'build:before' | 'build:after' | 'serve:before' | 'serve:after' | 'capacitor:run:before' | 'capacitor:build:before' | 'capacitor:sync:after'; export type CapacitorRunHookName = 'capacitor:run:before'; export type CapacitorBuildHookName = 'capacitor:build:before'; export type CapacitorSyncHookName = 'capacitor:sync:after'; export interface BaseHookContext { project: { type: ProjectType; dir: string; srcDir: string; }; argv: string[]; env: NodeJS.ProcessEnv; } export type AnyServeOptions = ReactServeOptions | AngularServeOptions | IonicAngularServeOptions | Ionic1ServeOptions; export type AnyBuildOptions = ReactBuildOptions | AngularBuildOptions | IonicAngularBuildOptions | Ionic1BuildOptions; export interface CapacitorSyncHookInput { readonly name: CapacitorSyncHookName; readonly build?: AnyBuildOptions; readonly capacitor: IonicCapacitorOptions; } export interface CapacitorRunHookInput { readonly name: CapacitorRunHookName; readonly serve?: AnyServeOptions; readonly build?: AnyBuildOptions; readonly capacitor: IonicCapacitorOptions; } export interface CapacitorBuildHookInput { readonly name: CapacitorBuildHookName; readonly build: AnyBuildOptions; readonly capacitor: IonicCapacitorOptions; } export interface BuildHookInput { readonly name: 'build:before' | 'build:after'; readonly build: AngularBuildOptions | IonicAngularBuildOptions | Ionic1BuildOptions; } export interface ServeBeforeHookInput { readonly name: 'serve:before'; readonly serve: AngularServeOptions | IonicAngularServeOptions | Ionic1ServeOptions; } export interface ServeAfterHookInput { readonly name: 'serve:after'; readonly serve: (AngularServeOptions | IonicAngularServeOptions | Ionic1ServeOptions) & ServeDetails; } export type HookInput = BuildHookInput | ServeBeforeHookInput | ServeAfterHookInput | CapacitorRunHookInput | CapacitorBuildHookInput | CapacitorSyncHookInput; export type HookContext = BaseHookContext & HookInput; export type HookFn = (ctx: HookContext) => Promise; export type IntegrationName = 'capacitor' | 'cordova' | 'enterprise'; export interface ProjectIntegration { enabled?: boolean; root?: string; } export interface EnterpriseProjectIntegration extends ProjectIntegration { productKey?: string; registries?: string[]; appId?: string; orgId?: string; keyId?: number; } export interface ProjectIntegrations { cordova?: ProjectIntegration; capacitor?: ProjectIntegration; enterprise?: EnterpriseProjectIntegration; } export interface Response extends APIResponseSuccess { data: T; } export interface ResourceClientLoad { load(id: string | number, modifiers: ResourceClientRequestModifiers): Promise; } export interface ResourceClientDelete { delete(id: string | number): Promise; } export interface ResourceClientCreate { create(details: U): Promise; } export interface ResourceClientPaginate { paginate(args?: Partial>>): IPaginator, PaginatorState>; } export interface ResourceClientRequestModifiers { fields?: string[]; } export interface Org { name: string; } export interface GithubRepo { full_name: string; id: number; } export interface GithubBranch { name: string; } export interface AppAssociation { repository: RepoAssociation; } export interface RepoAssociationBase { html_url: string; clone_url: string; full_name: string; } export interface GithubRepoAssociation extends RepoAssociationBase { type: 'github'; id: number; } export interface GitlabRepoAssociation extends RepoAssociationBase { type: 'gitlab'; id: number; } export interface GitlabEnterpriseRepoAssociation extends RepoAssociationBase { type: 'gitlab_enterprise'; id: number; } export interface BitbucketCloudRepoAssociation extends RepoAssociationBase { type: 'bitbucket_cloud'; id: string; } export interface BitbucketServerRepoAssociation extends RepoAssociationBase { type: 'bitbucket_server'; id: number; } export interface AzureDevopsRepoAssociation extends RepoAssociationBase { type: 'azure_devops'; id: string; } export type RepoAssociation = GithubRepoAssociation | BitbucketCloudRepoAssociation | BitbucketServerRepoAssociation; export type AssociationType = 'github' | 'bitbucket_cloud' | 'bitbucket_server'; export interface App { id: string; name: string; slug: string; org: null | Org; repo_url?: string; association?: null | AppAssociation; } export interface Login { user: User; token: string; } export interface User { id: number; email: string; oauth_identities?: OAuthIdentity; } export type OAuthIdentity = { [A in AssociationType]?: OAuthIdentityDetails; }; export interface OAuthIdentityDetails { username: string; name: string; html_url: string; } export interface OAuthServerConfig { authorizationUrl: string; tokenUrl: string; clientId: string; apiAudience: string; } export interface OpenIdToken { access_token: string; expires_in: number; id_token?: string; refresh_token?: string; scope: 'openid profile email offline_access'; token_type: 'Bearer'; state?: string; } export interface Snapshot { id: string; sha: string; ref: string; state: string; created: string; note: string; } export interface SSHKey { id: string; pubkey: string; fingerprint: string; annotation: string; name: string; created: string; updated: string; } export interface SecurityProfile { name: string; tag: string; type: 'development' | 'production'; created: string; credentials: { android?: object; ios?: object; }; } export interface IConfig extends BaseConfig { getAPIUrl(): string; getDashUrl(): string; getGitHost(): string; getGitPort(): number; getHTTPConfig(): CreateRequestOptions; getOpenIDOAuthConfig(): OAuthServerConfig; } export interface ProjectPersonalizationDetails { name: string; projectId: string; packageId?: string; version?: string; description?: string; themeColor?: string; appIcon?: Buffer; splash?: Buffer; } export interface IProjectConfig { name: string; type?: ProjectType; id?: string; root?: string; readonly integrations: ProjectIntegrations; readonly hooks?: Record; } export interface IMultiProjectConfig { defaultProject?: string; projects: { [key: string]: IProjectConfig | undefined; }; } export type ProjectFile = IProjectConfig | IMultiProjectConfig; export interface IProject { readonly rootDirectory: string; readonly directory: string; readonly filePath: string; readonly pathPrefix: readonly string[]; readonly type: ProjectType; readonly config: BaseConfig; readonly details: import('./lib/project').ProjectDetailsResult; getDocsUrl(): Promise; getSourceDir(sourceRoot?: string): Promise; getDefaultDistDir(): Promise; getDistDir(): Promise; getInfo(): Promise; detected(): Promise; createIntegration(name: 'capacitor'): Promise; createIntegration(name: 'cordova'): Promise; createIntegration(name: 'enterprise'): Promise; createIntegration(name: IntegrationName): Promise>; getIntegration(name: IntegrationName): Required | undefined; requireIntegration(name: IntegrationName): Required; requireAppflowId(): Promise; getPackageJson(pkgName?: string, options?: { logErrors?: boolean }): Promise<[PackageJson | undefined, string | undefined]>; requirePackageJson(pkgName?: string): Promise; personalize(details: ProjectPersonalizationDetails): Promise; registerAilments(registry: IAilmentRegistry): Promise; getBuildRunner(): Promise | undefined>; getServeRunner(): Promise | undefined>; getGenerateRunner(): Promise | undefined>; requireBuildRunner(): Promise>; requireServeRunner(): Promise>; requireGenerateRunner(): Promise>; } export interface IntegrationAddDetails { quiet?: boolean; root: string; enableArgs?: string[]; } export interface IntegrationAddHandlers { conflictHandler?: (f: string, stats: fs.Stats) => Promise; onFileCreate?: (f: string) => void; } export interface IIntegration { readonly name: IntegrationName; readonly summary: string; readonly archiveUrl?: string; readonly config: BaseConfig; add(details: IntegrationAddDetails): Promise; isAdded(): boolean; enable(config?: T): Promise; isEnabled(): boolean; disable(): Promise; getInfo(): Promise; personalize(details: ProjectPersonalizationDetails): Promise; } export interface PackageVersions { [key: string]: string; } export interface CommandMetadataInput extends FrameworkCommandMetadataInput { private?: boolean; } export interface CommandMetadataOption extends FrameworkCommandMetadataOption { private?: boolean; hint?: string; } export interface ExitCodeException extends Error { exitCode: number; } export interface CommandMetadata extends FrameworkCommandMetadata { type: 'global' | 'project'; } export type HydratedCommandMetadata = CommandMetadata & FrameworkHydratedCommandMetadata; export type CommandInstanceInfo = FrameworkCommandInstanceInfo; export type NamespaceLocateResult = FrameworkNamespaceLocateResult; export interface ISession { login(email: string, password: string): Promise; ssoLogin(email: string): Promise; tokenLogin(token: string): Promise; webLogin(): Promise; wizardLogin(): Promise; logout(): Promise; isLoggedIn(): boolean; getUser(): { id: number; }; getUserToken(): Promise; } export interface IShellSpawnOptions extends SpawnOptions { showCommand?: boolean; } export interface IShellOutputOptions extends IShellSpawnOptions { fatalOnError?: boolean; fatalOnNotFound?: boolean; showError?: boolean; } export interface IShellRunOptions extends IShellOutputOptions { stream?: NodeJS.WritableStream; killOnExit?: boolean; truncateErrorOutput?: number; } export interface IShell { alterPath: (path: string) => string; run(command: string, args: readonly string[], options: IShellRunOptions): Promise; output(command: string, args: readonly string[], options: IShellOutputOptions): Promise; spawn(command: string, args: readonly string[], options: IShellSpawnOptions): Promise; cmdinfo(cmd: string, args?: readonly string[], options?: SubprocessOptions): Promise; which(command: string, options?: WhichOptions): Promise; createSubprocess(command: string, args: readonly string[], options?: SubprocessOptions): Promise; } export interface ITelemetry { sendCommand(command: string, args: string[]): Promise; } export type NpmClient = 'yarn' | 'npm' | 'pnpm'; export type FeatureId = 'ssl-commands'; export interface ConfigFile { 'version': string; 'telemetry': boolean; 'npmClient': NpmClient; 'interactive'?: boolean; // HTTP configuration 'proxy'?: string; 'ssl.cafile'?: string | string[]; 'ssl.certfile'?: string | string[]; 'ssl.keyfile'?: string | string[]; // Ionic API 'urls.api'?: string; 'urls.dash'?: string; 'git.host'?: string; 'git.port'?: number; 'git.setup'?: boolean; 'org.id'?: string; 'user.id'?: number; 'user.email'?: string; 'tokens.user'?: string; 'tokens.telemetry'?: string; 'tokens.refresh'?: string; 'tokens.issuedOn'?: string; 'tokens.expiresInSeconds'?: number; 'tokens.flowName'?: string; // oauth configs 'oauth.openid.authorization_url'?: string; 'oauth.openid.token_url'?: string; 'oauth.openid.client_id'?: string; 'oauth.openid.api_audience'?: string; // Features 'features.ssl-commands'?: boolean; } export interface SSLConfig { cafile?: string | string[]; certfile?: string | string[]; keyfile?: string | string[]; } export interface CreateRequestOptions { userAgent: string; ssl?: SSLConfig; proxy?: string; } export type APIResponse = APIResponseSuccess | APIResponseError; export interface APIResponseMeta { status: number; version: string; request_id: string; } export type APIResponseData = object | object[] | string; export interface APIResponseErrorDetails { error_type: string; parameter: string; errors: string[]; } export interface APIResponseError { error: APIResponseErrorError; meta: APIResponseMeta; } export interface APIResponseErrorError { message: string; link: string | null; type: string; details?: APIResponseErrorDetails[]; } export interface APIResponseSuccess { data: APIResponseData; meta: APIResponseMeta; } export interface APIResponsePageTokenMeta extends APIResponseMeta { prev_page_token?: string; next_page_token?: string; } export type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE' | 'PURGE' | 'HEAD' | 'OPTIONS'; export const enum ContentType { JSON = 'application/json', FORM_URLENCODED = 'application/x-www-form-urlencoded', HTML = 'text/html', } export interface IClient { config: IConfig; make(method: HttpMethod, path: string, contentType?: ContentType): Promise<{ req: SuperAgentRequest; }>; do(req: SuperAgentRequest): Promise; paginate>(args: PaginateArgs): IPaginator; } export type PaginateArgs> = Pick, 'reqgen' | 'guard' | 'state' | 'max'>; export interface IPaginator, S = PaginatorState> extends IterableIterator> { readonly state: S; } export type PaginatorRequestGenerator = () => Promise<{ req: SuperAgentRequest; }>; export type PaginatorGuard> = (res: APIResponseSuccess) => res is T; export interface PaginatorState { done: boolean; loaded: number; } export interface PagePaginatorState extends PaginatorState { page: number; page_size?: number; } export interface TokenPaginatorState extends PaginatorState { page_token?: string; } export interface PaginatorDeps, S = PaginatorState> { readonly client: IClient; readonly reqgen: PaginatorRequestGenerator; readonly guard: PaginatorGuard; readonly state?: Partial; readonly max?: number; } export type InfoItemGroup = 'ionic' | 'capacitor' | 'cordova' | 'utility' | 'system' | 'environment'; export interface InfoItem { group: InfoItemGroup; name: string; value: string; key?: string; flair?: string; path?: string; hidden?: boolean; } export interface BaseBuildOptions { engine: string; // browser, cordova, etc. platform?: string; // android, ios, etc. project?: string; verbose?: boolean; '--': string[]; } export interface BuildOptions extends BaseBuildOptions { type: T; } export interface AngularBuildOptions extends BuildOptions<'angular'> { /** * The Angular architect configuration to use for builds. * * The `--prod` command line flag is a shortcut which translates to the * 'production' configuration. */ configuration?: string; sourcemaps?: boolean; cordovaAssets?: boolean; watch?: boolean; } export interface ReactBuildOptions extends BuildOptions<'react'> { publicUrl?: string; ci?: boolean; sourceMap?: boolean; inlineRuntimeChunk?: boolean; } export interface VueBuildOptions extends BuildOptions<'vue'> { configuration?: string; sourcemaps?: boolean; } export interface IonicCapacitorOptions extends CapacitorConfig { '--': string[]; verbose?: boolean; } export interface IonicAngularBuildOptions extends BuildOptions<'ionic-angular'> { prod: boolean; sourcemaps?: boolean; aot: boolean; minifyjs: boolean; minifycss: boolean; optimizejs: boolean; env?: string; } export interface Ionic1BuildOptions extends BuildOptions<'ionic1'> {} export interface CustomBuildOptions extends BuildOptions<'custom'> {} export interface GenerateOptions { type: string; name: string; } export interface AngularGenerateOptions extends GenerateOptions { [key: string]: any; // TODO } export interface IonicAngularGenerateOptions extends GenerateOptions { module: boolean; constants: boolean; } export interface ServeOptions { // Command Options host: string; port: number; publicHost?: string; livereload: boolean; proxy: boolean; lab: boolean; labHost: string; labPort: number; open: boolean; browser?: string; browserOption?: string; platform?: string; // android, ios, etc. project?: string; verbose?: boolean; '--': string[]; // Additional Options externalAddressRequired?: boolean; engine: string; // browser, cordova, etc. } export interface AngularServeOptions extends ServeOptions { consolelogs?: boolean; consolelogsPort?: number; ssl?: boolean; configuration?: string; sourcemaps?: boolean; } export interface ReactServeOptions extends ServeOptions { https?: boolean; ci?: boolean; reactEditor?: string; } export interface VueServeOptions extends ServeOptions { https: boolean; mode: string; configuration?: string; sourcemaps?: boolean; } export interface IonicAngularServeOptions extends ServeOptions { sourcemaps?: boolean; consolelogs: boolean; serverlogs: boolean; env?: string; livereloadPort: number; notificationPort: number; } export interface Ionic1ServeOptions extends ServeOptions { consolelogs: boolean; serverlogs: boolean; livereloadPort: number; notificationPort: number; } export interface CustomServeOptions extends ServeOptions {} export interface LabServeDetails { projectType: ProjectType; host: string; port: number; } export interface ServeDetails { custom: boolean; protocol: string; localAddress: string; externalAddress: string; port: number; externalNetworkInterfaces: NetworkInterface[]; externallyAccessible: boolean; } export interface IAilment { readonly id: string; implicit: boolean; projects?: ProjectType[]; getMessage(): Promise; detected(): Promise; getTreatmentSteps(): Promise; } export interface TreatableAilment extends IAilment { readonly treatable: boolean; getTreatmentSteps(): Promise; } export interface PatientTreatmentStep { message: string; } export interface DoctorTreatmentStep extends PatientTreatmentStep { treat(): Promise; } export interface IAilmentRegistry { ailments: IAilment[]; register(ailment: IAilment): void; get(id: string): IAilment | undefined; } export interface IonicContext { readonly binPath: string; readonly libPath: string; readonly execPath: string; readonly version: string; } export interface IonicEnvironment { readonly flags: IonicEnvironmentFlags; readonly client: IClient; readonly config: IConfig; // CLI global config (~/.ionic/config.json) readonly log: ILogger; readonly prompt: PromptModule; readonly ctx: IonicContext; readonly session: ISession; readonly shell: IShell; getInfo(): Promise; } export interface IonicEnvironmentFlags { readonly interactive: boolean; readonly confirm: boolean; } export type DistTag = 'testing' | 'canary' | 'latest'; export interface ICommand extends FrameworkCommand { readonly env: IonicEnvironment; readonly project?: IProject; execute(inputs: CommandLineInputs, options: CommandLineOptions, metadata: CommandInstanceInfo): Promise; } export interface CommandPreRun extends ICommand { preRun(inputs: CommandLineInputs, options: CommandLineOptions, metadata: CommandInstanceInfo): Promise; } export interface INamespace extends FrameworkNamespace { env: IonicEnvironment; project?: IProject; } export interface StarterList { starters: { name: string; id: string; type: ProjectType; }[]; integrations: { name: IntegrationName; id: string; }[]; } export interface BaseStarterTemplate { name: string; projectType: ProjectType; description?: string; } export interface RepoStarterTemplate extends BaseStarterTemplate { type: 'repo'; repo: string; } export interface ManagedStarterTemplate extends BaseStarterTemplate { type: 'managed'; id: string; } export type StarterTemplate = RepoStarterTemplate | ManagedStarterTemplate; export interface ResolvedStarterTemplate extends BaseStarterTemplate { archive: string; } export interface TelemetryIPCMessage { type: 'telemetry'; data: { command: string; args: string[]; }; } export interface UpdateCheckIPCMessage { type: 'update-check'; } export type IPCMessage = TelemetryIPCMessage | UpdateCheckIPCMessage; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/guards.ts000066400000000000000000000251231425441362600240700ustar00rootroot00000000000000import { APIResponse, APIResponseError, APIResponseSuccess, AndroidBuildOutput, App, AppAssociation, AzureDevopsRepoAssociation, BitbucketCloudRepoAssociation, BitbucketServerRepoAssociation, CommandPreRun, CordovaPackageJson, ExitCodeException, GithubBranch, GithubRepo, GithubRepoAssociation, GitlabEnterpriseRepoAssociation, GitlabRepoAssociation, ICommand, IMultiProjectConfig, IProjectConfig, IntegrationName, LegacyAndroidBuildOutputEntry, Login, OpenIdToken, Org, Response, SSHKey, SecurityProfile, Snapshot, StarterManifest, SuperAgentError, TreatableAilment, User } from './definitions'; import { AuthConnection } from './lib/oauth/auth'; export const INTEGRATION_NAMES: IntegrationName[] = ['capacitor', 'cordova', 'enterprise']; export function isCommand(cmd: any): cmd is ICommand { return cmd && typeof cmd.run === 'function'; } export function isCommandPreRun(cmd: any): cmd is CommandPreRun { return cmd && typeof cmd.preRun === 'function'; } export function isStarterManifest(obj: any): obj is StarterManifest { return obj && typeof obj.name === 'string' && typeof obj.baseref === 'string'; } export function isCordovaPackageJson(obj: any): obj is CordovaPackageJson { return obj && typeof obj.name === 'string' && typeof obj.cordova === 'object' && Array.isArray(obj.cordova.platforms) && typeof obj.cordova.plugins === 'object'; } export function isLegacyAndroidBuildOutputFile(obj: any): obj is LegacyAndroidBuildOutputEntry[] { if (!Array.isArray(obj)) { return false; } if (obj.length === 0) { return true; } return obj[0] && typeof obj[0].path === 'string' && typeof obj[0].outputType === 'object' && typeof obj[0].outputType.type === 'string'; } export function isAndroidBuildOutputFile(obj: any): obj is AndroidBuildOutput { return obj && typeof obj.artifactType === 'object' && typeof obj.artifactType.type === 'string' && Array.isArray(obj.elements); } export function isExitCodeException(err: any): err is ExitCodeException { return err && typeof err.exitCode === 'number' && err.exitCode >= 0 && err.exitCode <= 255; } export function isSuperAgentError(err: any): err is SuperAgentError { return err && err.response && typeof err.response === 'object'; } export function isAPIResponseSuccess(res: any): res is APIResponseSuccess { return res && (typeof res.data === 'object' || typeof res.data === 'string'); } export function isAPIResponseError(res: any): res is APIResponseError { return res && typeof res.error === 'object'; } export function isOrg(org: any): org is Org { return org && typeof org.name === 'string'; } export function isGithubRepo(repo: any): repo is GithubRepo { return repo && typeof repo.full_name === 'string' && typeof repo.id === 'number'; } export function isGithubBranch(branch: any): branch is GithubBranch { return branch && typeof branch.name === 'string'; } export function isGithubRepoListResponse(res: any): res is Response { if (!isAPIResponseSuccess(res) || !Array.isArray(res.data)) { return false; } if (res.data.length === 0) { return true; } return isGithubRepo(res.data[0]); } export function isGithubBranchListResponse(res: any): res is Response { if (!isAPIResponseSuccess(res) || !Array.isArray(res.data)) { return false; } if (res.data.length === 0) { return true; } return isGithubBranch(res.data[0]); } export function isAppAssociation(association: any): association is AppAssociation { return ( association && typeof association.repository === 'object' && typeof association.repository.html_url === 'string' && ( isGithubRepoAssociation(association.repository) || isBitbucketCloudRepoAssociation(association.repository) || isBitbucketServerRepoAssociation(association.repository) || isGitlabRepoAssociation(association.repository) || isGitlabEnterpriseRepoAssociation(association.repository) || isAzureDevopsRepoAssociation(association.repository) ) ); } export function isAppAssociationResponse(res: APIResponse): res is Response { return isAPIResponseSuccess(res) && typeof res.data === 'object' && isAppAssociation(res.data); } export function isGithubRepoAssociation(association: any): association is GithubRepoAssociation { return association && association.type === 'github' && typeof association.id === 'number'; } export function isGitlabRepoAssociation(association: any): association is GitlabRepoAssociation { return association && association.type === 'gitlab' && typeof association.id === 'number'; } export function isGitlabEnterpriseRepoAssociation(association: any): association is GitlabEnterpriseRepoAssociation { return association && association.type === 'gitlab_enterprise' && typeof association.id === 'number'; } export function isBitbucketCloudRepoAssociation(association: any): association is BitbucketCloudRepoAssociation { return association && association.type === 'bitbucket_cloud' && typeof association.id === 'string'; } export function isBitbucketServerRepoAssociation(association: any): association is BitbucketServerRepoAssociation { return association && association.type === 'bitbucket_server' && typeof association.id === 'number'; } export function isAzureDevopsRepoAssociation(association: any): association is AzureDevopsRepoAssociation { return association && association.type === 'azure_devops' && typeof association.id === 'string'; } export function isApp(app: any): app is App { return app && typeof app === 'object' && typeof app.id === 'string' && typeof app.name === 'string' && typeof app.slug === 'string' && (!app.org || isOrg(app.org)) && (!app.association || isAppAssociation(app.association)); } export function isAppResponse(res: APIResponse): res is Response { return isAPIResponseSuccess(res) && typeof res.data === 'object' && isApp(res.data); } export function isAppsResponse(res: APIResponse): res is Response { if (!isAPIResponseSuccess(res) || !Array.isArray(res.data)) { return false; } if (res.data.length === 0) { return true; } return isApp(res.data[0]); } export interface OAuthLogin { redirect_url: string; } export function isOAuthLogin(login: any): login is OAuthLogin { return login && typeof login.redirect_url === 'string'; } export function isOAuthLoginResponse(res: any): res is Response { return isAPIResponseSuccess(res) && isOAuthLogin(res.data); } export function isOpenIDToken(tokenObj: any): tokenObj is OpenIdToken { return tokenObj && typeof tokenObj.access_token === 'string' && typeof tokenObj.expires_in === 'number' && (tokenObj.id_token ? typeof tokenObj.id_token === 'string' : true) && (tokenObj.refresh_token ? typeof tokenObj.refresh_token === 'string' : true) && tokenObj.scope === 'openid profile email offline_access' && tokenObj.token_type === 'Bearer'; } export function isOpenIDTokenExchangeResponse(res: any): res is Response { return res && typeof res.body === 'object' && isOpenIDToken(res.body); } export function isSnapshot(snapshot: any): snapshot is Snapshot { return snapshot && typeof snapshot.id === 'string' && typeof snapshot.sha === 'string' && typeof snapshot.ref === 'string' && typeof snapshot.state === 'string' && typeof snapshot.created === 'string' && typeof snapshot.note === 'string'; } export function isSnapshotResponse(res: APIResponse): res is Response { return isAPIResponseSuccess(res) && isSnapshot(res.data); } export function isSnapshotListResponse(res: APIResponse): res is Response { if (!isAPIResponseSuccess(res) || !Array.isArray(res.data)) { return false; } if (res.data.length === 0) { return true; } return isSnapshot(res.data[0]); } export function isLogin(login: any): login is Login { return login && isUser(login.user) && typeof login.token === 'string'; } export function isLoginResponse(res: APIResponse): res is Response { return isAPIResponseSuccess(res) && isLogin(res.data); } export function isAuthConnection(connection: any): connection is AuthConnection { return connection && typeof connection.uuid === 'string'; } export function isAuthConnectionResponse(res: APIResponse): res is Response { return isAPIResponseSuccess(res) && isAuthConnection(res.data); } export function isUser(user: any): user is User { return user && typeof user.id === 'number' && typeof user.email === 'string'; } export function isUserResponse(res: APIResponse): res is Response { return isAPIResponseSuccess(res) && isUser(res.data); } export function isSSHKey(key: any): key is SSHKey { return key && typeof key.id === 'string' && typeof key.pubkey === 'string' && typeof key.fingerprint === 'string' && typeof key.annotation === 'string' && typeof key.name === 'string' && typeof key.created === 'string' && typeof key.updated === 'string'; } export function isSSHKeyListResponse(res: APIResponse): res is Response { if (!isAPIResponseSuccess(res) || !Array.isArray(res.data)) { return false; } if (res.data.length === 0) { return true; } return isSSHKey(res.data[0]); } export function isSSHKeyResponse(res: APIResponse): res is Response { return isAPIResponseSuccess(res) && isSSHKey(res.data); } export function isSecurityProfile(obj: any): obj is SecurityProfile { return obj && typeof obj.name === 'string' && typeof obj.tag === 'string' && typeof obj.type === 'string' && typeof obj.created === 'string' && typeof obj.credentials === 'object'; } export function isSecurityProfileResponse(r: APIResponse): r is Response { const res = r as Response; return isAPIResponseSuccess(res) && isSecurityProfile(res.data); } export function isTreatableAilment(ailment: any): ailment is TreatableAilment { return ailment && ailment.treatable && typeof ailment.getTreatmentSteps === 'function'; } export function isIntegrationName(name: any): name is IntegrationName { return INTEGRATION_NAMES.includes(name); } export function isProjectConfig(configFile: any): configFile is IProjectConfig { return configFile && typeof configFile.name === 'string' && typeof configFile.projects === 'undefined'; } export function isMultiProjectConfig(configFile: any): configFile is IMultiProjectConfig { return configFile && typeof configFile.name === 'undefined' && typeof configFile.projects === 'object'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/index.ts000066400000000000000000000140741425441362600237150ustar00rootroot00000000000000import { BaseError, InputValidationError, PackageJson } from '@ionic/cli-framework'; import { readPackageJsonFile } from '@ionic/cli-framework/utils/node'; import { processExit } from '@ionic/utils-process'; import * as Debug from 'debug'; import * as path from 'path'; import { IonicNamespace } from './commands'; import { IPCMessage, IonicContext, IonicEnvironment } from './definitions'; import { isExitCodeException, isSuperAgentError } from './guards'; import { generateIonicEnvironment } from './lib'; import { failure, input, strong } from './lib/color'; import { Executor } from './lib/executor'; export * from './constants'; export * from './guards'; export * from './definitions'; const debug = Debug('ionic'); const PACKAGE_ROOT_PATH = __dirname; const PACKAGE_JSON_PATH = path.resolve(PACKAGE_ROOT_PATH, 'package.json'); let _pkg: PackageJson | undefined; let _executor: Executor | undefined; async function loadPackageJson(): Promise { if (!_pkg) { _pkg = await readPackageJsonFile(PACKAGE_JSON_PATH); } return _pkg; } export async function generateContext(): Promise { const pkg = await loadPackageJson(); if (!pkg.bin || !pkg.bin.ionic) { throw new Error(`Missing "${strong('bin.ionic')}" in Ionic CLI package.json`); } if (!pkg.main) { throw new Error(`Missing "${strong('main')}" in Ionic CLI package.json`); } return { binPath: path.resolve(PACKAGE_ROOT_PATH, pkg.bin.ionic), libPath: PACKAGE_ROOT_PATH, execPath: process.cwd(), version: pkg.version, }; } export async function loadExecutor(ctx: IonicContext, pargv: string[]): Promise { if (!_executor) { const deps = await generateIonicEnvironment(ctx, pargv); const namespace = new IonicNamespace(deps); _executor = new Executor({ namespace }); } return _executor; } async function authenticateFromEnvironment(ienv: IonicEnvironment) { const token = process.env['IONIC_TOKEN']; const email = process.env['IONIC_EMAIL']; const password = process.env['IONIC_PASSWORD']; if (token) { const wasLoggedIn = ienv.session.isLoggedIn(); debug(`${strong('IONIC_TOKEN')} environment variable detected`); if (ienv.config.get('tokens.user') !== token) { debug(`${strong('IONIC_TOKEN')} mismatch with current session--attempting login`); await ienv.session.tokenLogin(token); if (wasLoggedIn) { ienv.log.info(`You have been logged out--using ${strong('IONIC_TOKEN')} environment variable`); } } } else if (email && password) { debug(`${strong('IONIC_EMAIL')} / ${strong('IONIC_PASSWORD')} environment variables detected`); if (ienv.config.get('user.email') !== email) { debug(`${strong('IONIC_EMAIL')} mismatch with current session--attempting login`); ienv.log.warn( 'Authenticating using email and password is deprecated. Please generate a Personal Access Token and set the ' + strong('IONIC_TOKEN') + ' environment variable.' ); ienv.log.nl(); try { await ienv.session.login(email, password); } catch (e) { ienv.log.error(`Error occurred during automatic login via ${strong('IONIC_EMAIL')} / ${strong('IONIC_PASSWORD')} environment variables.`); throw e; } } } } export async function run(pargv: string[]): Promise { let err: any; let executor: Executor; try { executor = await loadExecutor(await generateContext(), pargv); } catch (e) { process.stderr.write(`${e.message ? e.message : (e.stack ? e.stack : e)}\n`); process.exitCode = 1; return; } const ienv = executor.namespace.env; if (pargv[0] === '_') { return; } try { debug('Context: %o', ienv.ctx); ienv.config.set('version', ienv.ctx.version); const location = await executor.locate(pargv); const [ , [ cmd = '' ] = [] ] = location.path; if (!['config', 'completion', 'help', 'login', 'logout', 'version'].includes(cmd)) { await authenticateFromEnvironment(ienv); } await executor.execute(location, process.env); } catch (e) { err = e; } finally { if (ienv.flags.interactive) { const { runUpdateNotify } = await import('./lib/updates'); await runUpdateNotify(ienv, await loadPackageJson()); } } if (err) { process.exitCode = 1; if (err instanceof InputValidationError) { for (const e of err.errors) { ienv.log.error(e.message); } ienv.log.msg(`Use the ${input('--help')} flag for more details.`); } else if (isSuperAgentError(err)) { const { formatSuperAgentError } = await import('./lib/http'); ienv.log.rawmsg(formatSuperAgentError(err)); } else if (err.code && err.code === 'ENOTFOUND' || err.code === 'ECONNREFUSED') { ienv.log.error( `Network connectivity error occurred, are you offline?\n` + `If you are behind a firewall and need to configure proxy settings, see: ${strong('https://ion.link/cli-proxy-docs')}\n\n` + failure(String(err.stack ? err.stack : err)) ); } else if (isExitCodeException(err)) { if (err.message) { if (err.exitCode > 0) { ienv.log.error(err.message); } else { ienv.log.msg(err.message); } } await processExit(err.exitCode); } else if (err instanceof BaseError) { ienv.log.error(err.message); } else { ienv.log.msg(failure(String(err.stack ? err.stack : err))); if (err.stack) { debug(failure(String(err.stack))); } } } } export async function receive(msg: IPCMessage) { if (!_executor) { throw new Error('Executor not initialized.'); } const { env, project } = _executor.namespace; if (msg.type === 'telemetry') { const { sendCommand } = await import('./lib/telemetry'); await sendCommand({ getInfo: env.getInfo, client: env.client, config: env.config, ctx: env.ctx, project, session: env.session, }, msg.data.command, msg.data.args); } else if (msg.type === 'update-check') { const { runUpdateCheck } = await import('./lib/updates'); await runUpdateCheck(env); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/000077500000000000000000000000001425441362600227765ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/000077500000000000000000000000001425441362600247345ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/command.ts000066400000000000000000000102631425441362600267240ustar00rootroot00000000000000import { CommandMetadata, NamespaceMetadata } from '../../definitions'; import { Command } from '../command'; import { Namespace } from '../namespace'; class MyNamespace extends Namespace { async getMetadata(): Promise { return { name: 'my', summary: '', }; } } class FooCommand extends Command { async getMetadata(): Promise { return { name: 'foo', type: 'global', summary: '', }; } async run() {} } class BarCommand extends Command { async getMetadata(): Promise { return { name: 'bar', type: 'global', summary: '', inputs: [ { name: 'arg1', summary: '', }, { name: 'arg2', summary: '', }, { name: 'arg3', summary: '', private: true, }, { name: 'arg4', summary: '', }, ], options: [ { name: 'opt1', summary: '', type: Boolean, }, { name: 'opt2', summary: '', }, { name: 'opt3', summary: '', default: 'default', }, { name: 'opt4', summary: '', private: true, }, { name: 'opt5', summary: '', aliases: ['o'], }, ], }; } async run() {} } describe('@ionic/cli', () => { describe('Command', () => { describe('getCleanInputsForTelemetry', () => { const myns = new MyNamespace(undefined); // TODO: aliases can be intelligently removed it('should be empty with no inputs', async () => { const foo = new FooCommand(myns); const inputs: string[] = []; const results = await foo.getCleanInputsForTelemetry(inputs, { _: inputs }); expect(results).toEqual([]); }); it('should include additional, unknown arguments', async () => { const foo = new FooCommand(myns); const inputs = ['a', 'b', 'c']; const results = await foo.getCleanInputsForTelemetry(inputs, { _: inputs }); expect(results).toEqual(['a', 'b', 'c']); }); it('should include additional, unknown options', async () => { const foo = new FooCommand(myns); const inputs: string[] = []; const results = await foo.getCleanInputsForTelemetry(inputs, { _: inputs, opt1: true, opt2: 'cow' }); expect(results).toEqual(['--opt1', '--opt2=cow']); }); it('should include known arguments and options', async () => { const bar = new BarCommand(myns); const inputs = ['a', 'b']; const results = await bar.getCleanInputsForTelemetry(inputs, { _: inputs, opt1: true, opt2: 'cow', opt3: 'not default' }); expect(results).toEqual(['a', 'b', '--opt1', '--opt2=cow', '--opt3="not default"']); }); it('should exclude options with default values', async () => { const bar = new BarCommand(myns); const inputs: string[] = []; const results = await bar.getCleanInputsForTelemetry(inputs, { _: inputs, opt3: 'default' }); expect(results).toEqual([]); }); it('should exclude private arguments and options', async () => { const bar = new BarCommand(myns); const inputs = ['a', 'b', 'c', 'd']; const results = await bar.getCleanInputsForTelemetry(inputs, { _: inputs, opt1: true, opt4: 'private!' }); expect(results).toEqual(['a', 'b', '*****', 'd', '--opt1']); }); it('should exclude aliases', async () => { const bar = new BarCommand(myns); const inputs: string[] = []; const results = await bar.getCleanInputsForTelemetry(inputs, { _: inputs, o: 'wow', opt5: 'wow' }); expect(results).toEqual(['--opt5=wow']); }); it('should include separated args', async () => { const bar = new BarCommand(myns); const inputs = ['a']; const results = await bar.getCleanInputsForTelemetry(inputs, { _: inputs, '--': ['other', 'args'], opt1: true }); expect(results).toEqual(['a', '--opt1', '--', 'other', 'args']); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/executor.ts000066400000000000000000000021721425441362600271440ustar00rootroot00000000000000import { CommandMetadata } from '../../definitions'; import { metadataToCmdOptsEnv } from '../executor'; describe('@ionic/cli', () => { describe('lib/executor', () => { describe('metadataToCmdOptsEnv', () => { const metadata: CommandMetadata = { name: '', summary: '', type: 'global', options: [ { name: 'baz', summary: '', }, { name: 'opt-with-dashes', summary: '', }, ], }; it('should return empty array for command with no options', () => { const result = metadataToCmdOptsEnv({ name: '', summary: '', type: 'global', options: [] }, ['cmd']); expect(result.size).toEqual(0); }); it('should return schema for options', () => { const result = metadataToCmdOptsEnv(metadata, ['foo', 'bar']); const envvars = [...result.values()]; expect(envvars.length).toEqual(2); expect(envvars).toContain('IONIC_CMDOPTS_FOO_BAR_BAZ'); expect(envvars).toContain('IONIC_CMDOPTS_FOO_BAR_OPT_WITH_DASHES'); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/000077500000000000000000000000001425441362600266055ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/ssh-config/000077500000000000000000000000001425441362600306455ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/ssh-config/config1000066400000000000000000000000541425441362600321150ustar00rootroot00000000000000Host foo HostName 10.0.0.1 User dan ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/ssh-config/config2000066400000000000000000000000541425441362600321160ustar00rootroot00000000000000 Host foo HostName 10.0.0.1 User danionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/ssh-config/config3000066400000000000000000000001171425441362600321170ustar00rootroot00000000000000Host foo HostName 10.0.0.1 User dan Host bar IdentityFile /id_rsa ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/ssh-config/config4000066400000000000000000000001231425441362600321150ustar00rootroot00000000000000Host foo HostName 10.0.0.1 User dan Host bar IdentityFile /id_rsa_bad ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/ssh-config/config5000066400000000000000000000001171425441362600321210ustar00rootroot00000000000000Host bar IdentityFile /id_rsa Host foo HostName 10.0.0.1 User dan ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/fixtures/ssh-config/config6000066400000000000000000000000231425441362600321160ustar00rootroot00000000000000AddKeysToAgent yes ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/hooks.ts000066400000000000000000000105071425441362600264320ustar00rootroot00000000000000import { addHook, removeHook, locateHook } from '../hooks'; describe('@ionic/cli', () => { describe('lib/hooks', () => { describe('addHook', () => { it('should return array with hook added if given undefined', () => { const hooks = addHook('/base', undefined, 'hook.js'); expect(hooks).toEqual(['hook.js']); }); it('should return array with hook added if given a single string', () => { const hooks = addHook('/base', 'other-hook.js', 'hook.js'); expect(hooks).toEqual(['other-hook.js', 'hook.js']); }); it('should return array with hook added if given an empty array', () => { const hooks = addHook('/base', [], 'hook.js'); expect(hooks).toEqual(['hook.js']); }); it('should return array with hook added if given an array', () => { const hooks = addHook('/base', ['other-hook.js'], 'hook.js'); expect(hooks).toEqual(['other-hook.js', 'hook.js']); }); it('should respect relative paths', () => { const hooks = addHook('/base/dir/wow', undefined, '../path/to/hook.js'); expect(hooks).toEqual(['../path/to/hook.js']); }); it('should respect absolute paths', () => { const hooks = addHook('/base', undefined, '/path/to/hook.js'); expect(hooks).toEqual(['/path/to/hook.js']); }); it('should not add if it already exists', () => { const hooks = addHook('/base', ['hook.js'], 'hook.js'); expect(hooks).toEqual(['hook.js']); }); it('should not add if it already exists as an absolute path', () => { const hooks = addHook('/base', ['hook.js'], '/base/hook.js'); expect(hooks).toEqual(['hook.js']); }); }); describe('removeHook', () => { it('should return empty array if given undefined', () => { const hooks = removeHook('/base', undefined, 'hook.js'); expect(hooks).toEqual([]); }); it('should return empty array if given empty array', () => { const hooks = removeHook('/base', [], 'hook.js'); expect(hooks).toEqual([]); }); it('should return array if given a single string', () => { const hooks = removeHook('/base', 'other-hook.js', 'hook.js'); expect(hooks).toEqual(['other-hook.js']); }); it('should return empty array if given same hook', () => { const hooks = removeHook('/base', 'hook.js', 'hook.js'); expect(hooks).toEqual([]); }); it('should return array with hook removed if given an array', () => { const hooks = removeHook('/base', ['other-hook.js', 'hook.js'], 'hook.js'); expect(hooks).toEqual(['other-hook.js']); }); it('should respect relative paths', () => { const hooks = removeHook('/base/dir/wow', ['../path/to/hook.js'], '../path/to/hook.js'); expect(hooks).toEqual([]); }); it('should respect absolute paths', () => { const hooks = removeHook('/base', ['/path/to/hook.js'], '/path/to/hook.js'); expect(hooks).toEqual([]); }); it('should not remove anything if it does not exist', () => { const hooks = removeHook('/base', ['other-hook.js'], 'hook.js'); expect(hooks).toEqual(['other-hook.js']); }); it('should remove it if it exists as a relative path', () => { const hooks = removeHook('/base', ['hook.js'], '/base/hook.js'); expect(hooks).toEqual([]); }); }); describe('locateHook', () => { it('should not locate hook in empty array', () => { const i = locateHook('/base', [], 'hook.js'); expect(i).toEqual(-1); }); it('should not locate hook in array without it', () => { const i = locateHook('/base', ['other-hook.js'], 'hook.js'); expect(i).toEqual(-1); }); it('should locate hook at correct index', () => { const i = locateHook('/base', ['hook.js'], 'hook.js'); expect(i).toEqual(0); }); it('should locate relative hook at correct index', () => { const i = locateHook('/base', ['other-hook.js', 'hook.js'], '/base/hook.js'); expect(i).toEqual(1); }); it('should locate absolute hook at correct index', () => { const i = locateHook('/base', ['other-hook.js', '/base/hook.js'], 'hook.js'); expect(i).toEqual(1); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/serve.ts000066400000000000000000000054511425441362600264350ustar00rootroot00000000000000import { ServeRunner } from '../serve'; class MyServeRunner extends ServeRunner { constructor(protected readonly e: any) { super(); } async getCommandMetadata(): Promise { } modifyOpenUrl(): any { } async serveProject(): Promise { } } describe('@ionic/cli', () => { describe('lib/serve', () => { describe('ServeRunner', () => { describe('createOptionsFromCommandLine', () => { const defaults = { '--': [], publicHost: undefined, host: 'localhost', browser: undefined, browserOption: undefined, engine: 'browser', externalAddressRequired: false, lab: false, labHost: 'localhost', labPort: 8200, livereload: true, open: false, port: 8100, proxy: true, project: undefined, verbose: false, }; it('should provide defaults with no options', () => { const runner = new MyServeRunner({}); const result = runner.createOptionsFromCommandLine([], { _: [] }); expect(result).toEqual(defaults); }); it('should provide options from negations of cli flag defaults', () => { const runner = new MyServeRunner({}); const result = runner.createOptionsFromCommandLine([], { _: [], livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); expect(result).toEqual({ ...defaults, livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); }); it('should allow overrides of default values', () => { const runner = new MyServeRunner({}); const result = runner.createOptionsFromCommandLine([], { _: [], host: '0.0.0.0', port: '1111', 'livereload-port': '2222', 'dev-logger-port': '3333' }); expect(result).toEqual({ ...defaults, host: '0.0.0.0', port: 1111 }); }); it('should respect --external flag', () => { const runner = new MyServeRunner({}); const result = runner.createOptionsFromCommandLine([], { _: [], host: 'localhost', external: true }); expect(result).toEqual({ ...defaults, host: '0.0.0.0' }); }); it('should respect --project flag', () => { const runner = new MyServeRunner({}); const result = runner.createOptionsFromCommandLine([], { _: [], project: 'app' }); expect(result).toEqual({ ...defaults, project: 'app' }); }); it('should pass on separated args', () => { const runner = new MyServeRunner({}); const result = runner.createOptionsFromCommandLine([], { _: [], '--': ['foo', '--bar'] }); expect(result).toEqual({ ...defaults, '--': ['foo', '--bar'] }); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/ssh-config.ts000066400000000000000000000055611425441362600273530ustar00rootroot00000000000000import * as path from 'path'; import * as SSHConfig from 'ssh-config'; import { readFile } from '@ionic/utils-fs'; import { ensureHostAndKeyPath } from '../ssh-config'; describe('@ionic/cli', () => { describe('lib/ssh-config', () => { describe('ensureHostAndKeyPath', () => { const expected = 'Host bar\n IdentityFile /id_rsa\n'; it('should stringify with empty file', async () => { const conf = SSHConfig.parse(''); ensureHostAndKeyPath(conf, { host: 'bar' }, '/id_rsa'); expect(SSHConfig.stringify(conf)).toEqual(expected); }); it('should stringify with config1 file', async () => { const config1 = await readFile(path.resolve(__dirname, 'fixtures/ssh-config/config1'), { encoding: 'utf8' }); const conf = SSHConfig.parse(config1); ensureHostAndKeyPath(conf, { host: 'bar' }, '/id_rsa'); expect(SSHConfig.stringify(conf)).toEqual(`${config1}\n${expected}`); }); it('should stringify with config2 file', async () => { const config2 = await readFile(path.resolve(__dirname, 'fixtures/ssh-config/config2'), { encoding: 'utf8' }); const conf = SSHConfig.parse(config2); ensureHostAndKeyPath(conf, { host: 'bar' }, '/id_rsa'); expect(SSHConfig.stringify(conf)).toEqual(`${config2}\n\n${expected}`); }); it('should stringify with config3 file', async () => { const config3 = await readFile(path.resolve(__dirname, 'fixtures/ssh-config/config3'), { encoding: 'utf8' }); const conf = SSHConfig.parse(config3); ensureHostAndKeyPath(conf, { host: 'bar' }, '/id_rsa'); expect(SSHConfig.stringify(conf)).toEqual(config3); }); it('should stringify with config4 file', async () => { const config4 = await readFile(path.resolve(__dirname, 'fixtures/ssh-config/config4'), { encoding: 'utf8' }); const conf = SSHConfig.parse(config4); ensureHostAndKeyPath(conf, { host: 'bar' }, '/id_rsa'); const s = config4.split('\n'); s[s.length - 2] = ' IdentityFile /id_rsa'; expect(SSHConfig.stringify(conf)).toEqual(s.join('\n')); }); it('should stringify with config5 file', async () => { const config5 = await readFile(path.resolve(__dirname, 'fixtures/ssh-config/config5'), { encoding: 'utf8' }); const conf = SSHConfig.parse(config5); ensureHostAndKeyPath(conf, { host: 'bar' }, '/id_rsa'); expect(SSHConfig.stringify(conf)).toEqual(config5); }); it('should stringify with config6 file', async () => { const config6 = await readFile(path.resolve(__dirname, 'fixtures/ssh-config/config6'), { encoding: 'utf8' }); const conf = SSHConfig.parse(config6); ensureHostAndKeyPath(conf, { host: 'bar' }, '/id_rsa'); expect(SSHConfig.stringify(conf)).toEqual(`${config6}\n${expected}`); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/__tests__/ssh.ts000066400000000000000000000034771425441362600261140ustar00rootroot00000000000000import { ERROR_SSH_INVALID_PUBKEY, parsePublicKey } from '../ssh'; describe('@ionic/cli', () => { describe('lib/ssh', () => { describe('parsePublicKey', () => { const valids = [ 'AAAAB3NzaC1yc2EAAAABJQAAAQEAiDDC3iewOnn2kXbfOu2/LdHEiTFQoJufcSBzZ0COogvehg3L72biGeQD19nNvF3Ou05II5UGxVbpQG5yYOwH42AVVZf7fqUTjQEm7ig1SLMwJ9QsGw9CVSgpgVDnm3t7mgcVyOT+sp2lYxqPLzYakVE2OSBjzBRyau210FYIxbA4s4pJlFOcfJUmrnYwibUe6JqpXrSF0H1IGRE8ZR+Ck8GVAwyiMeOK5ea1gQ50khy+KuvRG+6+lYaAsUXDGCOaZIbHJwnMuVp50sObne1doX9rhYwYWXtcjsr5U+/HGEHWi2z12vE2Cd4wirEHP3ROzsWn51hmqJj4nDvYt4MtZQ==', 'AAAAB3NzaC1yc2EAAAADAQABAAABAQDqQmHXeWG737iR40rMO5enlhHMTGTmTi4Kehql9TxheN1PPujeBlQk6Kl0ylYDjPqqUBrSxq/tdxHyyF8h5QD+L5uO9PHyEVLoNCE0gYRhvSupf6K4EhZNz91KVYchRNZcldt6esf6KQfZIF20fNKLnIBJ5rkGO3vJJJkDZIBMH3IzMI7DUyZIA3RBE7wzfbSaZC3X87GWxS3IYM31IdFHXlKwBNFQpv4PKZ3RAeLRHpSuiyXlIuBWE7KEJCxcbDSFSTc3oFNUkwQACSfDze9Gt2T3zCowVB+G5k1pTpBunmMb6uXdzcqAzR41M2cpbbqRCpRmqzbW8psUbcsyTMM5', ]; const fmt = (bytes: string, annotation?: string) => `ssh-rsa ${bytes}${annotation ? ' ' + annotation : ''}`; it('should parse valid public keys', async () => { for (let valid of valids) { const formatted = fmt(valid, 'super'); const results = parsePublicKey(formatted); expect(results).toEqual([formatted, 'ssh-rsa', valid, 'super']); } }); it('should parse valid public keys with no annotation', async () => { for (let valid of valids) { const formatted = fmt(valid); const results = parsePublicKey(formatted); expect(results).toEqual([formatted, 'ssh-rsa', valid, '']); } }); it('should throw error for invalid public keys', async () => { expect(() => parsePublicKey('blah')).toThrow(ERROR_SSH_INVALID_PUBKEY); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/app.ts000066400000000000000000000055031425441362600241310ustar00rootroot00000000000000import { App, AppAssociation, AssociationType, IClient, IPaginator, PaginateArgs, PaginatorState, ResourceClientCreate, ResourceClientLoad, ResourceClientPaginate, Response } from '../definitions'; import { isAppAssociationResponse, isAppResponse, isAppsResponse } from '../guards'; import { weak } from './color'; import { ResourceClient, createFatalAPIFormat } from './http'; export function formatName(app: Pick) { if (app.org) { return `${weak(`${app.org.name} / `)}${app.name}`; } return app.name; } export interface AppClientDeps { readonly client: IClient; } export interface AppCreateDetails { readonly name: string; readonly org_id?: string; } export class AppClient extends ResourceClient implements ResourceClientLoad, ResourceClientCreate, ResourceClientPaginate { constructor(readonly token: string, readonly e: AppClientDeps) { super(); } async load(id: string): Promise { const { req } = await this.e.client.make('GET', `/apps/${id}`); this.applyAuthentication(req, this.token); const res = await this.e.client.do(req); if (!isAppResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } async create(details: AppCreateDetails): Promise { const { req } = await this.e.client.make('POST', '/apps'); this.applyAuthentication(req, this.token); req.send(details); const res = await this.e.client.do(req); if (!isAppResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } paginate(args: Partial>> = {}, orgId?: string): IPaginator, PaginatorState> { return this.e.client.paginate({ reqgen: async () => { const { req } = await this.e.client.make('GET', '/apps'); this.applyAuthentication(req, this.token); if (orgId) { req.send({ org_id: orgId }); } return { req }; }, guard: isAppsResponse, ...args, }); } async createAssociation(id: string, association: { repoId: number; type: AssociationType; branches: string[] }): Promise { const { req } = await this.e.client.make('POST', `/apps/${id}/repository`); req .set('Authorization', `Bearer ${this.token}`) .send({ repository_id: association.repoId, type: association.type, branches: association.branches, }); const res = await this.e.client.do(req); if (!isAppAssociationResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } async deleteAssociation(id: string): Promise { const { req } = await this.e.client.make('DELETE', `/apps/${id}/repository`); req .set('Authorization', `Bearer ${this.token}`) .send({}); await req; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/build.ts000066400000000000000000000215021425441362600244450ustar00rootroot00000000000000import { BaseError, MetadataGroup } from '@ionic/cli-framework'; import { PromptModule } from '@ionic/cli-framework-prompts'; import { createProcessEnv } from '@ionic/utils-process'; import { ERROR_COMMAND_NOT_FOUND, SubprocessError } from '@ionic/utils-subprocess'; import * as Debug from 'debug'; import { BaseBuildOptions, BuildOptions, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, IConfig, ILogger, IProject, IShell, NpmClient, Runner } from '../definitions'; import { ancillary, input, strong } from './color'; import { BuildCLIProgramNotFoundException, FatalException } from './errors'; import { Hook } from './hooks'; const debug = Debug('ionic:lib:build'); export const BUILD_SCRIPT = 'ionic:build'; export const COMMON_BUILD_COMMAND_OPTIONS: readonly CommandMetadataOption[] = [ { name: 'engine', summary: `Target engine (e.g. ${['browser', 'cordova'].map(e => input(e)).join(', ')})`, groups: [MetadataGroup.ADVANCED], }, { name: 'platform', summary: `Target platform on chosen engine (e.g. ${['ios', 'android'].map(e => input(e)).join(', ')})`, groups: [MetadataGroup.ADVANCED], }, ]; export interface BuildRunnerDeps { readonly config: IConfig; readonly log: ILogger; readonly project: IProject; readonly prompt: PromptModule; readonly shell: IShell; } export abstract class BuildRunner> implements Runner { protected abstract readonly e: BuildRunnerDeps; abstract getCommandMetadata(): Promise>; abstract createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): T; abstract buildProject(options: T): Promise; getPkgManagerBuildCLI(): PkgManagerBuildCLI { const pkgManagerCLIs = { npm: NpmBuildCLI, pnpm: PnpmBuildCLI, yarn: YarnBuildCLI, }; const client = this.e.config.get('npmClient'); const CLI = pkgManagerCLIs[client]; if (CLI) { return new CLI(this.e); } throw new BuildCLIProgramNotFoundException('Unknown CLI client: ' + client); } createBaseOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): BaseBuildOptions { const separatedArgs = options['--']; const [ platform ] = options['platform'] ? [String(options['platform'])] : inputs; const engine = this.determineEngineFromCommandLine(options); const project = options['project'] ? String(options['project']) : undefined; const verbose = !!options['verbose']; return { '--': separatedArgs ? separatedArgs : [], engine, platform, project, verbose }; } determineEngineFromCommandLine(options: CommandLineOptions): string { if (options['engine']) { return String(options['engine']); } if (options['cordova']) { return 'cordova'; } return 'browser'; } async beforeBuild(options: T): Promise { const hook = new BuildBeforeHook(this.e); try { await hook.run({ name: hook.name, build: options }); } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } async run(options: T): Promise { debug('build options: %O', options); if (options.engine === 'cordova' && !options.platform) { this.e.log.warn(`Cordova engine chosen without a target platform. This could cause issues. Please use the ${input('--platform')} option.`); } await this.beforeBuild(options); await this.buildProject(options); await this.afterBuild(options); } async afterBuild(options: T): Promise { const hook = new BuildAfterHook(this.e); try { await hook.run({ name: hook.name, build: options }); } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } } export abstract class BuildCLI { /** * The pretty name of this Build CLI. */ abstract readonly name: string; /** * The npm package of this Build CLI. */ abstract readonly pkg: string; /** * The bin program to use for this Build CLI. */ abstract readonly program: string; /** * If specified, `package.json` is inspected for this script to use instead * of `program`. */ abstract readonly script?: string; /** * If true, the Build CLI will not prompt to be installed. */ readonly global: boolean = false; private _resolvedProgram?: string; constructor(protected readonly e: BuildRunnerDeps) {} get resolvedProgram() { if (this._resolvedProgram) { return this._resolvedProgram; } return this.program; } /** * Build the arguments for starting this Build CLI. Called by `this.run()`. */ protected abstract buildArgs(options: T): Promise; /** * Build the environment variables for this Build CLI. Called by `this.run()`. */ protected async buildEnvVars(options: T): Promise { return process.env; } async resolveScript(): Promise { if (typeof this.script === 'undefined') { return; } const pkg = await this.e.project.requirePackageJson(); return pkg.scripts && pkg.scripts[this.script]; } async build(options: T): Promise { this._resolvedProgram = await this.resolveProgram(); await this.runWrapper(options); } protected async runWrapper(options: T): Promise { try { return await this.run(options); } catch (e) { if (!(e instanceof BuildCLIProgramNotFoundException)) { throw e; } if (this.global) { this.e.log.nl(); throw new FatalException(`${input(this.pkg)} is required for this command to work properly.`); } this.e.log.nl(); this.e.log.info( `Looks like ${input(this.pkg)} isn't installed in this project.\n` + `This package is required for this command to work properly.` ); const installed = await this.promptToInstall(); if (!installed) { this.e.log.nl(); throw new FatalException(`${input(this.pkg)} is required for this command to work properly.`); } return this.run(options); } } protected async run(options: T): Promise { const args = await this.buildArgs(options); const env = await this.buildEnvVars(options); try { await this.e.shell.run(this.resolvedProgram, args, { stdio: 'inherit', cwd: this.e.project.directory, fatalOnNotFound: false, env: createProcessEnv(env) }); } catch (e) { if (e instanceof SubprocessError && e.code === ERROR_COMMAND_NOT_FOUND) { throw new BuildCLIProgramNotFoundException(`${strong(this.resolvedProgram)} command not found.`); } throw e; } } protected async resolveProgram(): Promise { if (typeof this.script !== 'undefined') { debug(`Looking for ${ancillary(this.script)} npm script.`); if (await this.resolveScript()) { debug(`Using ${ancillary(this.script)} npm script.`); return this.e.config.get('npmClient'); } } return this.program; } protected async promptToInstall(): Promise { const { pkgManagerArgs } = await import('./utils/npm'); const [ manager, ...managerArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'install', pkg: this.pkg, saveDev: true, saveExact: true }); this.e.log.nl(); const confirm = await this.e.prompt({ name: 'confirm', message: `Install ${input(this.pkg)}?`, type: 'confirm', }); if (!confirm) { this.e.log.warn(`Not installing--here's how to install manually: ${input(`${manager} ${managerArgs.join(' ')}`)}`); return false; } await this.e.shell.run(manager, managerArgs, { cwd: this.e.project.directory }); return true; } } abstract class PkgManagerBuildCLI extends BuildCLI { readonly abstract program: NpmClient; readonly global = true; readonly script = BUILD_SCRIPT; protected async resolveProgram(): Promise { return this.program; } protected async buildArgs(options: BaseBuildOptions): Promise { const { pkgManagerArgs } = await import('./utils/npm'); const [ , ...pkgArgs ] = await pkgManagerArgs(this.program, { command: 'run', script: this.script, scriptArgs: [...options['--'] || []] }); return pkgArgs; } } export class NpmBuildCLI extends PkgManagerBuildCLI { readonly name = 'npm CLI'; readonly pkg = 'npm'; readonly program = 'npm'; } export class PnpmBuildCLI extends PkgManagerBuildCLI { readonly name = 'pnpm CLI'; readonly pkg = 'pnpm'; readonly program = 'pnpm'; } export class YarnBuildCLI extends PkgManagerBuildCLI { readonly name = 'Yarn'; readonly pkg = 'yarn'; readonly program = 'yarn'; } class BuildBeforeHook extends Hook { readonly name = 'build:before'; } class BuildAfterHook extends Hook { readonly name = 'build:after'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/color.ts000066400000000000000000000006041425441362600244640ustar00rootroot00000000000000import { Colors, DEFAULT_COLORS, HelpColors } from '@ionic/cli-framework'; import * as chalk from 'chalk'; const HELP_COLORS: Partial = { title: chalk.bold, }; export const COLORS: Colors = { ...DEFAULT_COLORS, help: { ...DEFAULT_COLORS.help, ...HELP_COLORS } }; export const { strong, weak, input, success, failure, ancillary, help: { title }, log: { WARN } } = COLORS; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/command.ts000066400000000000000000000124111425441362600247630ustar00rootroot00000000000000import { BaseCommand, DEFAULT_COLORS, generateCommandPath, unparseArgs } from '@ionic/cli-framework'; import { LOGGER_LEVELS, OutputStrategy, StreamHandler, StreamOutputStrategy, TTYOutputStrategy, TaskChain } from '@ionic/cli-framework-output'; import { TERMINAL_INFO } from '@ionic/utils-terminal'; import { CommandInstanceInfo, CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataInput, CommandMetadataOption, ICommand, INamespace, IProject, IonicEnvironment } from '../definitions'; import { isCommandPreRun } from '../guards'; import { input } from './color'; import { createDefaultLoggerHandlers, createFormatter } from './utils/logger'; export abstract class Command extends BaseCommand implements ICommand { protected readonly taskChains: TaskChain[] = []; constructor(public namespace: INamespace) { super(namespace); } get env(): IonicEnvironment { return this.namespace.root.env; } get project(): IProject | undefined { return this.namespace.root.project; } createTaskChain(): TaskChain { let output: OutputStrategy; const formatter = createFormatter(); if (this.env.flags.interactive) { output = new TTYOutputStrategy({ stream: process.stdout, colors: DEFAULT_COLORS }); this.env.log.handlers = new Set([new StreamHandler({ stream: output.stream, formatter })]); } else { this.env.log.handlers = createDefaultLoggerHandlers(); output = new StreamOutputStrategy({ stream: this.env.log.createWriteStream(LOGGER_LEVELS.INFO, false), colors: DEFAULT_COLORS }); } const chain = output.createTaskChain(); this.taskChains.push(chain); chain.on('end', () => { this.env.log.handlers = createDefaultLoggerHandlers(); }); return chain; } async execute(inputs: CommandLineInputs, options: CommandLineOptions, runinfo: CommandInstanceInfo): Promise { if (isCommandPreRun(this)) { await this.preRun(inputs, options, runinfo); } try { await this.validate(inputs); } catch (e) { if (!this.env.flags.interactive) { this.env.log.warn(`Command ran non-interactively due to ${input('--no-interactive')} flag, CI being detected, non-TTY, or a config setting.`); } throw e; } const runPromise = this.run(inputs, options, runinfo); const telemetryPromise = (async () => { if (this.env.config.get('telemetry') !== false && !TERMINAL_INFO.ci && TERMINAL_INFO.tty) { const { Telemetry } = await import('./telemetry'); let cmdInputs: CommandLineInputs = []; const metadata = await this.getMetadata(); if (metadata.name === 'login' || metadata.name === 'logout') { // This is a hack to wait until the selected commands complete before // sending telemetry data. These commands update `this.env` in some // way, which is used in the `Telemetry` instance. await runPromise; } else if (metadata.name === 'completion') { // Ignore telemetry for these commands. return; } else if (metadata.name === 'help') { cmdInputs = inputs; } else { cmdInputs = await this.getCleanInputsForTelemetry(inputs, options); } const cmd: ICommand = this; const path = await generateCommandPath(cmd); const telemetry = new Telemetry({ client: this.env.client, config: this.env.config, getInfo: this.env.getInfo, ctx: this.env.ctx, project: this.project, session: this.env.session }); await telemetry.sendCommand(path.map(([p]) => p).join(' '), cmdInputs); } })(); await Promise.all([runPromise, telemetryPromise]); } async getCleanInputsForTelemetry(inputs: CommandLineInputs, options: CommandLineOptions): Promise { const initialOptions: CommandLineOptions = { _: [] }; const metadata = await this.getMetadata(); const filteredInputs = inputs.map((input, i) => metadata.inputs && (metadata.inputs[i] && metadata.inputs[i].private) ? '*****' : input); const filteredOptions = Object.keys(options) .filter(optionName => { if (optionName === '_') { return false; } const metadataOption = metadata.options && metadata.options.find(o => { return o.name === optionName || (typeof o.aliases !== 'undefined' && o.aliases.includes(optionName)); }); if (metadataOption && metadataOption.aliases && metadataOption.aliases.includes(optionName)) { return false; // exclude aliases } if (!metadataOption) { return true; // include unknown options } if (metadataOption.private) { return false; // exclude private options } if (typeof metadataOption.default !== 'undefined' && metadataOption.default === options[optionName]) { return false; // exclude options that match their default value (means it wasn't supplied by user) } return true; }) .reduce((allOptions, optionName) => { allOptions[optionName] = options[optionName]; return allOptions; }, initialOptions); const optionInputs = unparseArgs(filteredOptions, { useDoubleQuotes: true }); return filteredInputs.concat(optionInputs); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/config.ts000066400000000000000000000070441425441362600246200ustar00rootroot00000000000000import { BaseConfig, BaseConfigOptions, MetadataGroup, ParsedArgs, metadataOptionsToParseArgsOptions, parseArgs } from '@ionic/cli-framework'; import * as os from 'os'; import * as path from 'path'; import { CommandMetadataOption, ConfigFile, CreateRequestOptions, IConfig, OAuthServerConfig } from '../definitions'; export const GLOBAL_OPTIONS: readonly CommandMetadataOption[] = [ { name: 'help', summary: 'Display help for commands', aliases: ['h'], type: Boolean, groups: [MetadataGroup.HIDDEN], }, { name: 'verbose', summary: 'Print debug log messages', type: Boolean, }, { name: 'quiet', summary: 'Only print warning and error log messages', type: Boolean, }, { name: 'interactive', summary: 'Disable interactivity such as progress indicators and prompts', type: Boolean, default: true, }, { name: 'color', summary: 'Disable colors in stdout', type: Boolean, default: true, }, { name: 'confirm', summary: 'Automatically answer YES to confirmation prompts', type: Boolean, }, { name: 'project', summary: 'The project ID to use in a multi-app configuration setup', groups: [MetadataGroup.HIDDEN], }, { name: 'json', summary: 'Use JSON when operating with stdout, if possible', type: Boolean, groups: [MetadataGroup.HIDDEN], }, ]; export const CONFIG_FILE = 'config.json'; export const DEFAULT_CONFIG_DIRECTORY = path.resolve(os.homedir(), '.ionic'); export class Config extends BaseConfig implements IConfig { constructor(p: string, options?: BaseConfigOptions) { super(p, options); const c = this.c as any; // <4.0.0 config migration if (c.state) { // start fresh this.c = { 'version': '4.0.0', 'telemetry': c.telemetry, 'npmClient': c.npmClient, 'interactive': c.interactive, 'user.id': c.user && c.user.id, 'user.email': c.user && c.user.email, 'git.setup': c.git && c.git.setup, 'tokens.user': c.tokens && c.tokens.user, 'tokens.telemetry': c.tokens && c.tokens.telemetry, 'features.ssl-commands': c.features && c.features['ssl-commands'], }; } } provideDefaults(config: Partial): ConfigFile { return { 'version': '4.0.0', 'telemetry': true, 'npmClient': 'npm', }; } getAPIUrl(): string { return this.get('urls.api', 'https://api.ionicjs.com'); } getDashUrl(): string { return this.get('urls.dash', 'https://dashboard.ionicframework.com'); } getGitHost(): string { return this.get('git.host', 'git.ionicjs.com'); } getGitPort(): number { return this.get('git.port', 22); } getHTTPConfig(): CreateRequestOptions { const { c } = this; return { userAgent: `node/superagent/Ionic CLI ${c.version}`, ssl: { cafile: c['ssl.cafile'], certfile: c['ssl.certfile'], keyfile: c['ssl.keyfile'], }, proxy: c['proxy'], }; } getOpenIDOAuthConfig(): OAuthServerConfig { return { authorizationUrl: this.get('oauth.openid.authorization_url', 'https://ionicframework.com/oauth/authorize'), tokenUrl: this.get('oauth.openid.token_url', 'https://api.ionicjs.com/oauth/token'), clientId: this.get('oauth.openid.client_id', 'cli'), apiAudience: this.get('oauth.openid.api_audience', 'https://api.ionicjs.com'), }; } } export function parseGlobalOptions(pargv: string[]): ParsedArgs { return parseArgs(pargv, metadataOptionsToParseArgsOptions(GLOBAL_OPTIONS)); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/cordova-res.ts000066400000000000000000000050511425441362600255730ustar00rootroot00000000000000import { ERROR_COMMAND_NOT_FOUND, SubprocessError, which } from '@ionic/utils-subprocess'; import { CommandLineOptions, IConfig, ILogger, IShell, IShellRunOptions, NpmClient } from '../definitions'; import { input, weak } from './color'; import { FatalException } from './errors'; import { createPrefixedWriteStream } from './utils/logger'; import { pkgManagerArgs } from './utils/npm'; export const SUPPORTED_PLATFORMS: readonly string[] = ['ios', 'android']; export interface CordovaResSchema { platform?: string; } export function createCordovaResArgs({ platform }: CordovaResSchema, options: CommandLineOptions): string[] { const args: string[] = []; if (platform) { args.push(platform); } if (options['icon']) { args.push('--type', 'icon'); } else if (options['splash']) { args.push('--type', 'splash'); } if (options['verbose']) { args.push('--verbose'); } return args; } export interface RunCordovaResDeps { readonly config: IConfig; readonly log: ILogger; readonly shell: IShell; } export async function runCordovaRes({ config, log, shell }: RunCordovaResDeps, args: readonly string[], options: IShellRunOptions = {}): Promise { const stream = createPrefixedWriteStream(log, weak(`[cordova-res]`)); try { await shell.run('cordova-res', args, { showCommand: true, fatalOnNotFound: false, stream, ...options }); } catch (e) { if (e instanceof SubprocessError && e.code === ERROR_COMMAND_NOT_FOUND) { throw await createCordovaResNotFoundError(config.get('npmClient')); } throw e; } } export interface CheckCordovaResDeps { readonly config: IConfig; } export async function checkCordovaRes({ config }: CheckCordovaResDeps): Promise { const p = await findCordovaRes(); if (!p) { throw await createCordovaResNotFoundError(config.get('npmClient')); } } export async function findCordovaRes(): Promise { try { return await which('cordova-res'); } catch (e) { if (e.code !== 'ENOENT') { throw e; } } } export async function createCordovaResNotFoundError(npmClient: NpmClient): Promise { return new FatalException(await createCordovaResNotFoundMessage(npmClient)); } export async function createCordovaResNotFoundMessage(npmClient: NpmClient): Promise { const installArgs = await pkgManagerArgs(npmClient, { command: 'install', pkg: 'cordova-res', global: true }); return ( `${input('cordova-res')} was not found on your PATH. Please install it globally:\n\n` + `${input(installArgs.join(' '))}\n` ); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/diff.ts000066400000000000000000000010251425441362600242540ustar00rootroot00000000000000import { failure, input, strong } from './color'; export async function diffPatch(filename: string, text1: string, text2: string): Promise { const JsDiff = await import('diff'); return JsDiff.createPatch(filename, text1, text2, '', '').split('\n').map(line => { if (line.indexOf('-') === 0 && line.indexOf('---') !== 0) { line = strong(failure(line)); } else if (line.indexOf('+') === 0 && line.indexOf('+++') !== 0) { line = strong(input(line)); } return line; }).slice(2).join('\n'); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/doctor/000077500000000000000000000000001425441362600242705ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/doctor/ailments/000077500000000000000000000000001425441362600261045ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/doctor/ailments/base.ts000066400000000000000000000036141425441362600273720ustar00rootroot00000000000000import { PackageJson } from '@ionic/cli-framework'; import * as Debug from 'debug'; import { IAilment, IAilmentRegistry, IClient, IConfig, ILogger, IProject, ISession, IShell, PatientTreatmentStep, ProjectType } from '../../../definitions'; export interface AilmentDeps { client: IClient; config: IConfig; log: ILogger; project: IProject; shell: IShell; session: ISession; } export abstract class Ailment implements IAilment { protected readonly client: IClient; protected readonly config: IConfig; protected readonly log: ILogger; protected readonly project: IProject; protected readonly shell: IShell; protected readonly session: ISession; private _debug?: Debug.IDebugger; abstract readonly id: string; readonly projects?: ProjectType[] = undefined; readonly implicit: boolean = true; constructor({ client, config, log, project, shell, session }: AilmentDeps) { this.client = client; this.config = config; this.log = log; this.project = project; this.shell = shell; this.session = session; } get debug() { if (!this._debug) { this._debug = Debug(`ionic:lib:doctor:ailments:${this.id}`); } return this._debug; } abstract async getMessage(): Promise; abstract async detected(): Promise; abstract async getTreatmentSteps(): Promise; async getLocalPackageJson(pkgName: string): Promise { try { return await this.project.requirePackageJson(pkgName); } catch (e) { if (e.fatal) { throw e; } } } } export class AilmentRegistry implements IAilmentRegistry { protected _ailments: IAilment[] = []; register(ailment: IAilment) { this._ailments.push(ailment); } get ailments(): IAilment[] { return this._ailments; } get(id: string): IAilment | undefined { return this._ailments.find(a => a.id === id); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/doctor/ailments/index.ts000066400000000000000000000264151425441362600275730ustar00rootroot00000000000000import { readFile } from '@ionic/utils-fs'; import * as chalk from 'chalk'; import * as path from 'path'; import { TreatableAilment } from '../../../definitions'; import { AppClient } from '../../app'; import { ancillary, input, strong } from '../../color'; import { getIonicRemote, isRepoInitialized } from '../../git'; import { loadCordovaConfig } from '../../integrations/cordova/config'; import { getPlatforms } from '../../integrations/cordova/project'; import { pkgManagerArgs } from '../../utils/npm'; import { Ailment } from './base'; export * from './base'; export * from './utils'; export class NpmInstalledLocally extends Ailment implements TreatableAilment { readonly id = 'npm-installed-locally'; readonly treatable = true; async getMessage() { return ( `${strong('npm')} is installed locally.\n` + `${strong('npm')} is typically installed globally and may cause some confusion about versions when other CLIs use it.\n` ).trim(); } async detected() { const pkg = await this.getLocalPackageJson('npm'); return pkg !== undefined; } async getTreatmentSteps() { const [ manager, ...managerArgs ] = await pkgManagerArgs(this.config.get('npmClient'), { command: 'uninstall', pkg: 'npm' }); return [ { message: `Run: ${input(manager + ' ' + managerArgs.join(' '))}`, treat: async () => { await this.shell.run(manager, managerArgs, {}); }, }, ]; } } export class IonicCLIInstalledLocally extends Ailment implements TreatableAilment { readonly id = 'ionic-installed-locally'; readonly treatable = true; async getMessage() { return ( `The Ionic CLI is installed locally.\n` + `While the CLI can run locally, there's no longer a reason to have it installed locally and it may cause some confusion over configuration and versions.\n` ).trim(); } async detected() { const pkg = await this.getLocalPackageJson('@ionic/cli'); return pkg !== undefined; } async getTreatmentSteps() { const [ manager, ...managerArgs ] = await pkgManagerArgs(this.config.get('npmClient'), { command: 'uninstall', pkg: '@ionic/cli' }); return [ { message: `Run: ${input(manager + ' ' + managerArgs.join(' '))}`, treat: async () => { await this.shell.run(manager, managerArgs, {}); }, }, ]; } } export class GitNotUsed extends Ailment { readonly id = 'git-not-used'; async getMessage() { return ( `Git doesn't appear to be in use.\n` + `We highly recommend using source control software such as git (${strong('https://git-scm.com')}) to track changes in your code throughout time.\n` ).trim(); } async detected() { if (!(await isRepoInitialized(this.project.directory))) { return true; } const cmdInstalled = await this.shell.cmdinfo('git', ['--version']); if (!cmdInstalled) { return true; } const [ revListCount, status ] = await Promise.all([ this.shell.output('git', ['rev-list', '--count', 'HEAD'], { fatalOnError: false, showCommand: false, showError: false }), this.shell.output('git', ['status', '--porcelain'], { fatalOnError: false, showCommand: false, showError: false }), ]); this.debug('rev-list count: %s, status: %s', revListCount.trim(), status); if (!revListCount) { return true; } const commitCount = Number(revListCount); const changes = Boolean(status); return commitCount === 1 && changes; } async getTreatmentSteps() { return [ { message: `Download git if you don't have it installed: ${strong('https://git-scm.com/downloads')}` }, { message: `Learn the basics if you're unfamiliar with git: ${strong('https://try.github.io')}` }, { message: `Make your first commit and start tracking code changes! ðŸ˜` }, ]; } } export class GitConfigInvalid extends Ailment { readonly id = 'git-config-invalid'; async getMessage() { const appflowId = await this.project.requireAppflowId(); return ( `App linked to ${strong(appflowId)} with invalid git configuration.\n` + `This app is linked to an app on Ionic (${strong(appflowId)}), but the git configuration is not valid.\n` ).trim(); } async detected() { const isLoggedIn = this.session.isLoggedIn(); if (!isLoggedIn) { return false; } const appflowId = this.project.config.get('id'); if (!appflowId) { return false; } if (!(await isRepoInitialized(this.project.directory))) { return false; } const remote = await getIonicRemote({ shell: this.shell }, this.project.directory); if (!remote) { return true; } const token = await this.session.getUserToken(); const appClient = new AppClient(token, { client: this.client }); const app = await appClient.load(appflowId); if (app.repo_url !== remote) { return true; } return false; } async getTreatmentSteps() { return [ { message: `Run: ${input('ionic git remote')}` }, ]; } } export class IonicNativeOldVersionInstalled extends Ailment { readonly id = 'ionic-native-old-version-installed'; async getMessage() { return ( `Old version of Ionic Native installed.\n` + `Ionic Native ${strong('ionic-native')} has been restructured into individual packages under the ${strong('@ionic-native/')} namespace to allow for better bundling and faster apps.\n` ).trim(); } async detected() { const pkg = await this.getLocalPackageJson('ionic-native'); return pkg !== undefined; } async getTreatmentSteps() { const args = await pkgManagerArgs(this.config.get('npmClient'), { command: 'uninstall', pkg: 'ionic-native' }); return [ { message: `Run ${input(args.join(' '))}` }, { message: `Refer to ${strong('https://ion.link/native-docs')} for installation & usage instructions` }, ]; } } export class UnsavedCordovaPlatforms extends Ailment { readonly id = 'unsaved-cordova-platforms'; async getMessage() { return ( `Cordova platforms unsaved.\n` + `There are Cordova platforms installed that are not saved in ${strong('config.xml')} or ${strong('package.json')}. It is good practice to manage Cordova platforms and their versions. See the Cordova docs${ancillary('[1]')} for more information.\n\n` + `${ancillary('[1]')}: ${strong('https://cordova.apache.org/docs/en/latest/platform_plugin_versioning_ref/')}\n` ).trim(); } async detected() { const cordova = this.project.getIntegration('cordova'); if (!cordova || !cordova.enabled) { return false; } const platforms = await getPlatforms(cordova.root); const conf = await loadCordovaConfig(cordova); const configuredPlatforms = new Set([...conf.getConfiguredPlatforms().map(e => e.name)]); const configXmlDiff = platforms.filter(p => !configuredPlatforms.has(p)); return configXmlDiff.length > 0; } async getTreatmentSteps() { return [ { message: `Run: ${input('ionic cordova platform save')}` }, ]; } } export class DefaultCordovaBundleIdUsed extends Ailment { readonly id = 'default-cordova-bundle-id-used'; async getMessage() { return ( `Package ID unchanged in ${strong('config.xml')}.\n` + `The Package Identifier (AKA "Bundle ID" for iOS and "Application ID" for Android) is a unique ID (usually written in reverse DNS notation, such as ${strong('com.mycompany.MyApp')}) that Cordova uses when compiling the native build of your app. When your app is submitted to the App Store or Play Store, the Package ID can't be changed. This issue was detected because this app's Package ID is ${input('"io.ionic.starter"')}, which is the default Package ID provided after running ${input('ionic start')}.` ).trim(); } async detected() { const cordova = this.project.getIntegration('cordova'); if (!cordova || !cordova.enabled) { return false; } const conf = await loadCordovaConfig(cordova); return conf.getBundleId() === 'io.ionic.starter'; } async getTreatmentSteps() { return [ { message: `Change the ${strong('id')} attribute of ${strong('')} (root element) to something other than ${input('"io.ionic.starter"')}` }, ]; } } export class ViewportFitNotSet extends Ailment { readonly id: 'viewport-fit-not-set' = 'viewport-fit-not-set'; async getMessage() { return ( `${strong('viewport-fit=cover')} not set in ${strong('index.html')}\n` + `iOS 11 introduces new "safe regions" for webviews, which can throw off component sizing, squish the header into the status bar, letterbox the app on iPhone X, etc. Fixing this issue will ensure the webview takes up the full size of the screen. See ${strong('https://ionicframework.com/blog/ios-11-checklist/')} for more information.` ).trim(); } async detected() { const indexHtml = await readFile(path.resolve(await this.project.getSourceDir(), 'index.html'), { encoding: 'utf8' }); const m = indexHtml.match(/\/); return !Boolean(m); } async getTreatmentSteps() { return [ { message: `Add ${strong('viewport-fit=cover')} to the ${strong('')} tag in your ${strong('index.html')} file` }, ]; } } export class CordovaPlatformsCommitted extends Ailment { readonly id = 'cordova-platforms-committed'; async getMessage() { return ( `Cordova ${strong('platforms/')} directory is committed to git.\n` + `Cordova considers ${strong('platforms/')} and ${strong('plugins/')} build artifacts${ancillary('[1]')}, and routinely overwrites files.\n\n` + `While committing these files might be necessary for some projects${ancillary('[2]')}, generally platforms should be configured using ${strong('config.xml')} and Cordova hooks${ancillary('[3]')} so that your project is more portable and SDK updates are easier.\n\n` + `${ancillary('[1]')}: ${strong('https://cordova.apache.org/docs/en/latest/reference/cordova-cli/#version-control')}\n` + `${ancillary('[2]')}: ${strong('https://cordova.apache.org/docs/en/latest/reference/cordova-cli/#platforms')}\n` + `${ancillary('[3]')}: ${strong('https://cordova.apache.org/docs/en/latest/guide/appdev/hooks/index.html')}\n\n` + `${chalk.yellow(`${strong('WARNING')}: Attempting to fix this could be dangerous. Only proceed if you're sure you haven't made manual modifications to these files.`)}\n` ).trim(); } async detected() { if (!(await isRepoInitialized(this.project.directory))) { return false; } const cmdInstalled = await this.shell.cmdinfo('git', ['--version']); if (!cmdInstalled) { return false; } const files = (await this.shell.output('git', ['ls-tree', '--name-only', 'HEAD'], { fatalOnError: false, showCommand: false, showError: false })).split('\n'); return files.includes('platforms'); // TODO } async getTreatmentSteps() { return [ { message: `Remove ${strong('platforms/')} from source control: ${input('git rm -rf platforms/')} and ${input('git commit')}` }, { message: `Make sure the ${strong('platforms/')} directory has been removed: ${input('rm -rf platforms/')}` }, { message: `Allow Cordova to repopulate your platforms: ${input('ionic cordova prepare')}` }, ]; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/doctor/ailments/utils.ts000066400000000000000000000021211425441362600276100ustar00rootroot00000000000000import { IAilment } from '../../../definitions'; import { isTreatableAilment } from '../../../guards'; import { input, weak } from '../../color'; export async function formatAilmentMessage(ailment: IAilment): Promise { const treatable = isTreatableAilment(ailment); return ( `${await ailment.getMessage()}\n` + `${await formatAilmentSteps(ailment)}\n\n` + `${weak('$')} ${input(`ionic config set -g doctor.issues.${ailment.id}.ignored true`)} ${weak('(ignore this issue in the future)')}\n` + `${treatable ? `${weak('$')} ${input(`ionic doctor treat ${ailment.id}`)} ${weak('(attempt to fix this issue)')}\n` : ''}` ); } async function formatAilmentSteps(ailment: IAilment): Promise { const steps = await ailment.getTreatmentSteps(); if (steps.length === 0) { return ''; } const treatable = isTreatableAilment(ailment); const msg = treatable ? `To fix, the following step(s) need to be taken:` : `To fix, take the following step(s):`; return `\n${msg}\n\n${steps.map((step, i) => ` ${weak(String(i + 1) + ')')} ${step.message}`).join('\n')}`; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/doctor/index.ts000066400000000000000000000000341425441362600257440ustar00rootroot00000000000000export * from './ailments'; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/environment.ts000066400000000000000000000023751425441362600257210ustar00rootroot00000000000000import { PromptModule } from '@ionic/cli-framework-prompts'; import { IClient, IConfig, ILogger, ISession, IShell, InfoItem, IonicContext, IonicEnvironment, IonicEnvironmentFlags } from '../definitions'; export interface EnvironmentDeps { readonly client: IClient; readonly config: IConfig; // CLI global config (~/.ionic/config.json) readonly flags: IonicEnvironmentFlags; readonly getInfo: () => Promise; readonly log: ILogger; readonly ctx: IonicContext; readonly prompt: PromptModule; readonly session: ISession; readonly shell: IShell; } export class Environment implements IonicEnvironment { readonly flags: IonicEnvironmentFlags; readonly client: IClient; readonly config: IConfig; // CLI global config (~/.ionic/config.json) getInfo: () => Promise; readonly log: ILogger; readonly prompt: PromptModule; session: ISession; readonly shell: IShell; readonly ctx: IonicContext; constructor({ client, config, flags, getInfo, log, ctx, prompt, session, shell }: EnvironmentDeps) { this.client = client; this.config = config; this.flags = flags; this.getInfo = getInfo; this.log = log; this.ctx = ctx; this.prompt = prompt; this.session = session; this.shell = shell; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/errors.ts000066400000000000000000000014311425441362600246610ustar00rootroot00000000000000import { BaseError } from '@ionic/cli-framework'; export class BaseException extends BaseError { readonly name = 'Exception'; } export class FatalException extends BaseException { fatal = true; constructor(public message = '', public exitCode = 1) { super(message); } } export class BuildCLIProgramNotFoundException extends BaseException {} export class ServeCLIProgramNotFoundException extends BaseException {} export class SessionException extends BaseException {} export class RunnerException extends BaseException {} export class RunnerNotFoundException extends RunnerException {} export class IntegrationException extends BaseException {} export class IntegrationNotFoundException extends IntegrationException {} export class HookException extends BaseException {} ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/events.ts000066400000000000000000000012301425441362600246460ustar00rootroot00000000000000import * as Debug from 'debug'; import { ServeDetails } from '../definitions'; const debug = Debug('ionic:lib:events'); export interface IPCEvent { type: 'event'; event: E; data: D; } export function emit(event: 'serve:ready', data: ServeDetails): boolean; export function emit(event: E, data: D): boolean { if (!process.send) { debug('No process.send, not emitting event %s', event); return false; } const msg: IPCEvent = { type: 'event', event, data }; process.send(msg); debug('Sent event %s as IPC message to parent process', event); return true; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/executor.ts000066400000000000000000000072731425441362600252150ustar00rootroot00000000000000import { BaseExecutor, metadataOptionsToParseArgsOptions, parseArgs, stripOptions } from '@ionic/cli-framework'; import * as lodash from 'lodash'; import { CommandInstanceInfo, CommandMetadata, CommandMetadataInput, CommandMetadataOption, ICommand, INamespace, NamespaceLocateResult } from '../definitions'; import { isCommand } from '../guards'; import { input } from './color'; import { GLOBAL_OPTIONS } from './config'; import { FatalException } from './errors'; export const VERSION_FLAGS: readonly string[] = ['--version', '-v']; export const HELP_FLAGS: readonly string[] = ['--help', '-?', '-h']; export interface ExecutorDeps { readonly namespace: INamespace; } export class Executor extends BaseExecutor { async locate(argv: readonly string[]): Promise { const pargs = stripOptions(argv, {}); const location = await this.namespace.locate(pargs); const args = lodash.drop(argv, location.path.length - 1); if (lodash.intersection(VERSION_FLAGS, argv).length > 0) { return this.locate(['version', ...pargs]); } else if (lodash.intersection(HELP_FLAGS, argv).length > 0 || !isCommand(location.obj)) { return this.locate(['help', ...pargs]); } return { ...location, args }; } async run(command: ICommand, cmdargs: string[], { location, env, executor }: CommandInstanceInfo): Promise { const metadata = await command.getMetadata(); const parts = getFullCommandParts(location); if (metadata.options) { const optMap = metadataToCmdOptsEnv(metadata, parts.slice(1)); // TODO: changes opt by reference, which is probably bad for (const [ opt, envvar ] of optMap.entries()) { const envdefault = env[envvar]; if (typeof envdefault !== 'undefined') { opt.default = opt.type === Boolean ? (envdefault && envdefault !== '0' ? true : false) : envdefault; } } } const metadataOpts = [...metadata.options ? metadata.options : [], ...GLOBAL_OPTIONS]; const minimistOpts = metadataOptionsToParseArgsOptions(metadataOpts); const cmdoptions = parseArgs(cmdargs, minimistOpts); const cmdinputs = cmdoptions._; const { project } = this.namespace; if (project) { if (project.details.context === 'multiapp') { cmdoptions['project'] = project.details.id; } } else { if (metadata.type === 'project') { throw new FatalException( `Sorry! ${input(parts.join(' '))} can only be run in an Ionic project directory.\n` + `If this is a project you'd like to integrate with Ionic, run ${input('ionic init')}.` ); } } await command.execute(cmdinputs, cmdoptions, { location, env, executor }); } } export async function runCommand(runinfo: CommandInstanceInfo, argv: string[]) { const { env, executor } = runinfo; const metadata = await executor.namespace.getMetadata(); executor.namespace.env.log.msg(`> ${input([metadata.name, ...argv].map(a => a.includes(' ') ? `"${a}"` : a).join(' '))}`); await executor.execute(argv, env); } export function metadataToCmdOptsEnv(metadata: CommandMetadata, cmdNameParts: string[]): Map { const optMap = new Map(); if (!metadata.options) { return optMap; } const prefix = `IONIC_CMDOPTS_${cmdNameParts.map(s => s.toUpperCase()).join('_')}`; for (const option of metadata.options) { optMap.set(option, `${prefix}_${option.name.toUpperCase().split('-').join('_')}`); } return optMap; } export function getFullCommandParts(location: NamespaceLocateResult): string[] { return location.path.map(([p]) => p); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/generate.ts000066400000000000000000000017561425441362600251510ustar00rootroot00000000000000import { PromptModule } from '@ionic/cli-framework-prompts'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, GenerateOptions, IConfig, ILogger, IProject, IShell, IonicContext, Runner } from '../definitions'; export interface GenerateRunnerDeps { readonly config: IConfig; readonly ctx: IonicContext; readonly log: ILogger; readonly project: IProject; readonly prompt: PromptModule; readonly shell: IShell; } export abstract class GenerateRunner implements Runner { protected abstract readonly e: GenerateRunnerDeps; createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): GenerateOptions { const [ type, name ] = inputs; return { type, name }; } async ensureCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): Promise { /* overwritten in subclasses */ } abstract getCommandMetadata(): Promise>; abstract run(options: T): Promise; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/git.ts000066400000000000000000000027121425441362600241330ustar00rootroot00000000000000import { pathExists } from '@ionic/utils-fs'; import * as path from 'path'; import { IShell } from '../definitions'; export interface GitUtilDeps { shell: IShell; } export async function isGitInstalled({ shell }: GitUtilDeps): Promise { return Boolean(await shell.cmdinfo('git', ['--version'])); } export async function getTopLevel({ shell }: GitUtilDeps): Promise { return shell.cmdinfo('git', ['rev-parse', '--show-toplevel']); } export async function isRepoInitialized(dir: string): Promise { return pathExists(path.join(dir, '.git')); } export async function initializeRepo({ shell }: GitUtilDeps, dir: string) { await shell.run('git', ['init'], { cwd: dir }); } export async function getIonicRemote({ shell }: GitUtilDeps, dir: string): Promise { const regex = /ionic\t(.+) \(\w+\)/; // would like to use get-url, but not available in git 2.0.0 const remotes = await shell.output('git', ['remote', '-v'], { cwd: dir }); for (const line of remotes.split('\n')) { const match = regex.exec(line.trim()); if (match) { return match[1]; } } } export async function addIonicRemote({ shell }: GitUtilDeps, dir: string, url: string) { await shell.run('git', ['remote', 'add', 'ionic', url], { cwd: dir }); } export async function setIonicRemote({ shell }: GitUtilDeps, dir: string, url: string) { await shell.run('git', ['remote', 'set-url', 'ionic', url], { cwd: dir }); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/help.ts000066400000000000000000000112601425441362600242760ustar00rootroot00000000000000import { CommandHelpFormatterDeps as BaseCommandHelpFormatterDeps, CommandHelpSchema as BaseCommandHelpSchema, CommandSchemaHelpFormatter as BaseCommandSchemaHelpFormatter, CommandStringHelpFormatter as BaseCommandStringHelpFormatter, MetadataGroup, NO_COLORS, NamespaceHelpFormatterDeps as BaseNamespaceHelpFormatterDeps, NamespaceSchemaHelpFormatter as BaseNamespaceSchemaHelpFormatter, NamespaceStringHelpFormatter as BaseNamespaceStringHelpFormatter, formatOptionName, isOptionVisible } from '@ionic/cli-framework'; import { filter } from '@ionic/utils-array'; import { CommandMetadata, CommandMetadataInput, CommandMetadataOption, HydratedCommandMetadata, ICommand, INamespace } from '../definitions'; import { COLORS } from './color'; import { GLOBAL_OPTIONS } from './config'; const IONIC_LOGO = String.raw` _ _ (_) ___ _ __ (_) ___ | |/ _ \| '_ \| |/ __| | | (_) | | | | | (__ |_|\___/|_| |_|_|\___|`; export interface NamespaceHelpFormatterDeps extends BaseNamespaceHelpFormatterDeps { readonly inProject: boolean; readonly version: string; } export interface CommandHelpFormatterDeps extends BaseCommandHelpFormatterDeps {} export class NamespaceStringHelpFormatter extends BaseNamespaceStringHelpFormatter { protected readonly inProject: boolean; protected readonly version: string; constructor({ version, inProject, ...rest }: NamespaceHelpFormatterDeps) { super({ ...rest, colors: COLORS }); this.inProject = inProject; this.version = version; } async formatHeader(): Promise { return this.namespace.parent ? super.formatHeader() : this.formatIonicHeader(); } async formatIonicHeader(): Promise { const { strong } = this.colors; return `\n${IONIC_LOGO} ${strong(`CLI ${this.version}`)}\n\n`; } async getGlobalOptions(): Promise { const visibleOptions = await filter(GLOBAL_OPTIONS, async opt => isOptionVisible(opt)); return visibleOptions.map(opt => formatOptionName(opt, { colors: NO_COLORS, showAliases: false })); } async formatCommands() { const { strong } = this.colors; const commands = await this.getCommandMetadataList(); const globalCmds = commands.filter(cmd => cmd.type === 'global'); const projectCmds = commands.filter(cmd => cmd.type === 'project'); return ( (await this.formatCommandGroup('Global Commands', globalCmds)) + (this.inProject ? await this.formatCommandGroup('Project Commands', projectCmds) : `\n ${strong('Project Commands')}:\n\n You are not in a project directory.\n`) ); } } export class CommandStringHelpFormatter extends BaseCommandStringHelpFormatter { constructor(options: CommandHelpFormatterDeps) { super({ ...options, colors: COLORS }); } async formatOptions(): Promise { const metadata = await this.getCommandMetadata(); const options = metadata.options ? metadata.options : []; const basicOptions = options.filter(o => !o.groups || !o.groups.includes(MetadataGroup.ADVANCED)); const advancedOptions = options.filter(o => o.groups && o.groups.includes(MetadataGroup.ADVANCED)); return ( (await this.formatOptionsGroup('Options', basicOptions)) + (await this.formatOptionsGroup('Advanced Options', advancedOptions)) ); } async formatBeforeOptionSummary(opt: CommandMetadataOption): Promise { return (opt.hint ? `${opt.hint} ` : '') + await super.formatBeforeOptionSummary(opt); } } export class NamespaceSchemaHelpFormatter extends BaseNamespaceSchemaHelpFormatter { async formatCommand(cmd: HydratedCommandMetadata): Promise { const { command } = cmd; const formatter = new CommandSchemaHelpFormatter({ location: { path: [...cmd.path], obj: command, args: [] }, command, metadata: cmd, }); return { ...await formatter.serialize(), type: cmd.type }; } } export interface CommandHelpSchema extends BaseCommandHelpSchema { type: string; } export class CommandSchemaHelpFormatter extends BaseCommandSchemaHelpFormatter { async formatCommand(cmd: CommandMetadata | HydratedCommandMetadata): Promise { const formatted = await super.formatCommand(cmd); return { ...formatted, type: cmd.type }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/helper.ts000066400000000000000000000011641425441362600246270ustar00rootroot00000000000000import { mkdirp, open } from '@ionic/utils-fs'; import { fork } from '@ionic/utils-subprocess'; import * as path from 'path'; import { IConfig, IPCMessage, IonicContext } from '../definitions'; export interface SendMessageDeps { config: IConfig; ctx: IonicContext; } export async function sendMessage({ config, ctx }: SendMessageDeps, msg: IPCMessage) { const dir = path.dirname(config.p); await mkdirp(dir); const fd = await open(path.resolve(dir, 'helper.log'), 'a'); const p = fork(ctx.binPath, ['_', '--no-interactive'], { stdio: ['ignore', fd, fd, 'ipc'] }); p.send(msg); p.disconnect(); p.unref(); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/hooks.ts000066400000000000000000000105511425441362600244730ustar00rootroot00000000000000import { conform } from '@ionic/utils-array'; import { prettyPath } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as path from 'path'; import { HookFn, HookInput, HookName, IConfig, IProject, IShell } from '../definitions'; import { ancillary, failure, strong } from './color'; import { HookException } from './errors'; const debug = Debug('ionic:lib:hooks'); export interface HookDeps { readonly config: IConfig; readonly project: IProject; readonly shell: IShell; } export abstract class Hook { abstract readonly name: HookName; get script() { return `ionic:${this.name}`; } constructor(protected readonly e: HookDeps) {} async run(input: HookInput) { const { pkgManagerArgs } = await import('./utils/npm'); const type = this.e.project.type; if (!type || !this.e.project.directory) { return; // TODO: will we need hooks outside a project? } const [ pkg ] = await this.e.project.getPackageJson(undefined, { logErrors: false }); if (!pkg) { return; } debug(`Looking for ${ancillary(this.script)} npm script.`); const ctxEnvironment = this.generateCTXEnvironment(input); if (pkg.scripts && pkg.scripts[this.script]) { debug(`Invoking ${ancillary(this.script)} npm script.`); const [ pkgManager, ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script }); await this.e.shell.run(pkgManager, pkgArgs, { env: ctxEnvironment, }); } const projectHooks = this.e.project.config.get('hooks'); const hooks = projectHooks ? conform(projectHooks[this.name]) : []; for (const h of hooks) { const p = path.resolve(this.e.project.directory, h); try { if (path.extname(p) !== '.js') { throw new Error(`Hooks must be .js files with a function for its default export.`); } const hook = await this.loadHookFn(p); if (!hook) { throw new Error(`Module must have a function for its default export.`); } await hook(lodash.assign({}, input, { project: { type, dir: this.e.project.directory, srcDir: await this.e.project.getSourceDir(), }, argv: process.argv, env: { ...process.env, ...ctxEnvironment, }, })); } catch (e) { throw new HookException( `An error occurred while running an Ionic CLI hook defined in ${strong(prettyPath(this.e.project.filePath))}.\n` + `Hook: ${strong(this.name)}\n` + `File: ${strong(p)}\n\n` + `${failure(e.stack ? e.stack : e)}` ); } } } protected async loadHookFn(p: string): Promise { const module = require(p); if (typeof module === 'function') { return module; } else if (typeof module.default === 'function') { return module.default; } debug(`Could not load hook function ${strong(p)}: %o not a function`, module); } private generateCTXEnvironment(input: HookInput, path: string[] = []): NodeJS.ProcessEnv { let environment: NodeJS.ProcessEnv = {}; for (const [key, value] of Object.entries(input)) { if (typeof value === 'object') { environment = { ...environment, ...this.generateCTXEnvironment(value, [...path, key]), }; } else { const name = [...path, key].join('_'); environment[`IONIC_CLI_HOOK_CTX_${lodash.snakeCase(name)}`.toUpperCase()] = value; } } return environment; } } export function addHook(baseDir: string, hooks: string | string[] | undefined, hook: string): string[] { const hookPaths = conform(hooks); const resolvedHookPaths = hookPaths.map(p => path.resolve(baseDir, p)); if (!resolvedHookPaths.includes(path.resolve(baseDir, hook))) { hookPaths.push(hook); } return hookPaths; } export function removeHook(baseDir: string, hooks: string | string[] | undefined, hook: string): string[] { const hookPaths = conform(hooks); const i = locateHook(baseDir, hookPaths, hook); if (i >= 0) { hookPaths.splice(i, 1); } return hookPaths; } export function locateHook(baseDir: string, hooks: string[], hook: string): number { return conform(hooks).map(p => path.resolve(baseDir, p)).indexOf(path.resolve(baseDir, hook)); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/http.ts000066400000000000000000000177741425441362600243450ustar00rootroot00000000000000import * as chalk from 'chalk'; import * as lodash from 'lodash'; import * as util from 'util'; import { APIResponse, APIResponsePageTokenMeta, APIResponseSuccess, ContentType, HttpMethod, IClient, IConfig, IPaginator, PagePaginatorState, PaginateArgs, PaginatorDeps, PaginatorGuard, PaginatorRequestGenerator, ResourceClientRequestModifiers, Response, SuperAgentError, TokenPaginatorState } from '../definitions'; import { isAPIResponseError, isAPIResponseSuccess } from '../guards'; import { failure, strong } from './color'; import { FatalException } from './errors'; import { createRequest } from './utils/http'; export type SuperAgentRequest = import('superagent').SuperAgentRequest; export type SuperAgentResponse = import('superagent').Response; const FORMAT_ERROR_BODY_MAX_LENGTH = 1000; export const ERROR_UNKNOWN_CONTENT_TYPE = 'UNKNOWN_CONTENT_TYPE'; export const ERROR_UNKNOWN_RESPONSE_FORMAT = 'UNKNOWN_RESPONSE_FORMAT'; export class Client implements IClient { constructor(public config: IConfig) {} async make(method: HttpMethod, path: string, contentType: ContentType = ContentType.JSON): Promise<{ req: SuperAgentRequest; }> { const url = path.startsWith('http://') || path.startsWith('https://') ? path : `${this.config.getAPIUrl()}${path}`; const { req } = await createRequest(method, url, this.config.getHTTPConfig()); req .set('Content-Type', contentType) .set('Accept', ContentType.JSON); return { req }; } async do(req: SuperAgentRequest): Promise { const res = await req; const r = transformAPIResponse(res); if (isAPIResponseError(r)) { throw new FatalException( 'API request was successful, but the response output format was that of an error.\n' + formatAPIResponse(req, r) ); } return r; } paginate>(args: PaginateArgs): IPaginator { return new Paginator({ client: this, ...args }); } } export class Paginator> implements IPaginator { protected client: IClient; protected reqgen: PaginatorRequestGenerator; protected guard: PaginatorGuard; protected max?: number; readonly state: PagePaginatorState; constructor({ client, reqgen, guard, state, max }: PaginatorDeps) { const defaultState = { page: 1, done: false, loaded: 0 }; this.client = client; this.reqgen = reqgen; this.guard = guard; this.max = max; if (!state) { state = { page_size: 100, ...defaultState }; } this.state = lodash.assign({}, state, defaultState); } next(): IteratorResult> { if (this.state.done) { return { done: true } as IteratorResult>; // TODO: why can't I exclude value? } return { done: false, value: (async () => { const { req } = await this.reqgen(); req.query(lodash.pick(this.state, ['page', 'page_size'])); const res = await this.client.do(req); if (!this.guard(res)) { throw createFatalAPIFormat(req, res); } this.state.loaded += res.data.length; if ( res.data.length === 0 || // no resources in this page, we're done (typeof this.max === 'number' && this.state.loaded >= this.max) || // met or exceeded maximum requested (typeof this.state.page_size === 'number' && res.data.length < this.state.page_size) // number of resources less than page size, so nothing on next page ) { this.state.done = true; } this.state.page++; return res; })(), }; } [Symbol.iterator](): this { return this; } } export class TokenPaginator> implements IPaginator { protected client: IClient; protected reqgen: PaginatorRequestGenerator; protected guard: PaginatorGuard; protected max?: number; readonly state: TokenPaginatorState; constructor({ client, reqgen, guard, state, max }: PaginatorDeps) { const defaultState = { done: false, loaded: 0 }; this.client = client; this.reqgen = reqgen; this.guard = guard; this.max = max; if (!state) { state = { ...defaultState }; } this.state = lodash.assign({}, state, defaultState); } next(): IteratorResult> { if (this.state.done) { return { done: true } as IteratorResult>; // TODO: why can't I exclude value? } return { done: false, value: (async () => { const { req } = await this.reqgen(); if (this.state.page_token) { req.query({ page_token: this.state.page_token }); } const res = await this.client.do(req); if (!this.isPageTokenResponseMeta(res.meta)) { throw createFatalAPIFormat(req, res); } const nextPageToken = res.meta.next_page_token; if (!this.guard(res)) { throw createFatalAPIFormat(req, res); } this.state.loaded += res.data.length; if ( res.data.length === 0 || // no resources in this page, we're done (typeof this.max === 'number' && this.state.loaded >= this.max) || // met or exceeded maximum requested !nextPageToken // no next page token, must be done ) { this.state.done = true; } this.state.page_token = nextPageToken; return res; })(), }; } isPageTokenResponseMeta(meta: any): meta is APIResponsePageTokenMeta { return meta && (!meta.prev_page_token || typeof meta.prev_page_token === 'string') && (!meta.next_page_token || typeof meta.next_page_token === 'string'); } [Symbol.iterator](): this { return this; } } export abstract class ResourceClient { protected applyModifiers(req: import('superagent').Request, modifiers?: ResourceClientRequestModifiers) { if (!modifiers) { return; } if (modifiers.fields) { req.query({ fields: modifiers.fields }); } } protected applyAuthentication(req: import('superagent').Request, token: string) { req.set('Authorization', `Bearer ${token}`); } } export function transformAPIResponse(r: SuperAgentResponse): APIResponse { if (r.status === 204) { r.body = { meta: { status: 204, version: '', request_id: '' } }; } if (r.status !== 204 && r.type !== ContentType.JSON) { throw ERROR_UNKNOWN_CONTENT_TYPE; } const j = r.body as APIResponse; if (!j.meta) { throw ERROR_UNKNOWN_RESPONSE_FORMAT; } return j; } export function createFatalAPIFormat(req: SuperAgentRequest, res: APIResponse): FatalException { return new FatalException( 'API request was successful, but the response format was unrecognized.\n' + formatAPIResponse(req, res) ); } export function formatSuperAgentError(e: SuperAgentError): string { const res = e.response; const req = (res as any).request; // TODO: `req` and `request` exist: https://visionmedia.github.io/superagent/docs/test.html const statusCode = e.response.status; let f = ''; try { const r = transformAPIResponse(res); f += formatAPIResponse(req, r); } catch (e) { f += ( `HTTP Error ${statusCode}: ${req.method.toUpperCase()} ${req.url}\n` + '\n' + (res.text ? res.text.substring(0, FORMAT_ERROR_BODY_MAX_LENGTH) : '') ); if (res.text && res.text.length > FORMAT_ERROR_BODY_MAX_LENGTH) { f += ` ...\n\n[ truncated ${res.text.length - FORMAT_ERROR_BODY_MAX_LENGTH} characters ]`; } } return failure(strong(f)); } function formatAPIResponse(req: SuperAgentRequest, r: APIResponse): string { return formatResponseError(req, r.meta.status, isAPIResponseSuccess(r) ? r.data : r.error); } export function formatResponseError(req: SuperAgentRequest, status?: number, body?: object | string): string { return failure( `Request: ${req.method} ${req.url}\n` + (status ? `Response: ${status}\n` : '') + (body ? `Body: \n${util.inspect(body, { colors: chalk.level > 0 })}` : '') ); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/index.ts000066400000000000000000000131441425441362600244600ustar00rootroot00000000000000import { LOGGER_LEVELS } from '@ionic/cli-framework-output'; import { createPromptModule } from '@ionic/cli-framework-prompts'; import { TERMINAL_INFO, prettyPath } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import * as path from 'path'; import { ERROR_VERSION_TOO_OLD } from '../bootstrap'; import { IProject, InfoItem, IonicContext, IonicEnvironment, IonicEnvironmentFlags } from '../definitions'; import { input, strong, success } from './color'; import { CONFIG_FILE, Config, DEFAULT_CONFIG_DIRECTORY, parseGlobalOptions } from './config'; import { Environment } from './environment'; import { Client } from './http'; import { createProjectFromDirectory, findProjectDirectory } from './project'; import { createOnFallback } from './prompts'; import { ProSession } from './session'; import { Shell, prependNodeModulesBinToPath } from './shell'; import { PROXY_ENVIRONMENT_VARIABLES } from './utils/http'; import { Logger, createDefaultLoggerHandlers } from './utils/logger'; const debug = Debug('ionic:lib'); export async function generateIonicEnvironment(ctx: IonicContext, pargv: string[]): Promise<{ env: IonicEnvironment; project?: IProject; }> { process.chdir(ctx.execPath); const argv = parseGlobalOptions(pargv); const config = new Config(path.resolve(process.env['IONIC_CONFIG_DIRECTORY'] || DEFAULT_CONFIG_DIRECTORY, CONFIG_FILE)); debug('Terminal info: %o', TERMINAL_INFO); if (config.get('interactive') === false || !TERMINAL_INFO.tty || TERMINAL_INFO.ci) { argv['interactive'] = false; } const flags = argv as any as IonicEnvironmentFlags; // TODO debug('CLI global options: %o', flags); const log = new Logger({ level: argv['quiet'] ? LOGGER_LEVELS.WARN : LOGGER_LEVELS.INFO, handlers: createDefaultLoggerHandlers(), }); const prompt = await createPromptModule({ interactive: argv['interactive'], onFallback: createOnFallback({ flags, log }), }); const projectDir = await findProjectDirectory(ctx.execPath); const proxyVars = PROXY_ENVIRONMENT_VARIABLES.map((e): [string, string | undefined] => [e, process.env[e]]).filter(([, v]) => !!v); const getInfo = async () => { const osName = await import('os-name'); const semver = await import('semver'); const { getUpdateConfig } = await import('./updates'); const os = osName(); const [ npm, nativeRun, cordovaRes ] = await Promise.all([ shell.cmdinfo('npm', ['-v']), shell.cmdinfo('native-run', ['--version']), shell.cmdinfo('cordova-res', ['--version']), ]); const { packages: latestVersions } = await getUpdateConfig({ config }); const latestNativeRun = latestVersions.find(pkg => pkg.name === 'native-run'); const latestCordovaRes = latestVersions.find(pkg => pkg.name === 'cordova-res'); const nativeRunUpdate = latestNativeRun && nativeRun ? semver.gt(latestNativeRun.version, nativeRun) : false; const cordovaResUpdate = latestCordovaRes && cordovaRes ? semver.gt(latestCordovaRes.version, cordovaRes) : false; const info: InfoItem[] = [ { group: 'ionic', name: 'Ionic CLI', key: 'version', value: ctx.version, path: ctx.libPath, }, { group: 'system', name: 'NodeJS', key: 'node_version', value: process.version, path: process.execPath }, { group: 'system', name: 'npm', key: 'npm_version', value: npm || 'not installed' }, { group: 'system', name: 'OS', key: 'os', value: os }, { group: 'utility', name: 'native-run', key: 'native_run_version', value: nativeRun || 'not installed globally', flair: nativeRunUpdate ? `update available: ${latestNativeRun ? success(latestNativeRun.version) : '???'}` : '', }, { group: 'utility', name: 'cordova-res', key: 'cordova_res_version', value: cordovaRes || 'not installed globally', flair: cordovaResUpdate ? `update available: ${latestCordovaRes ? success(latestCordovaRes.version) : '???'}` : '', }, ]; info.push(...proxyVars.map(([e, v]): InfoItem => ({ group: 'environment', name: e, value: v || 'not set' }))); if (project) { info.push(...(await project.getInfo())); } return info; }; const shell = new Shell({ log }, { alterPath: p => projectDir ? prependNodeModulesBinToPath(projectDir, p) : p }); const client = new Client(config); const session = new ProSession({ config, client }); const deps = { client, config, ctx, flags, log, prompt, session, shell }; const env = new Environment({ getInfo, ...deps }); if (process.env['IONIC_CLI_LOCAL_ERROR']) { if (process.env['IONIC_CLI_LOCAL_ERROR'] === ERROR_VERSION_TOO_OLD) { log.warn(`Detected locally installed Ionic CLI, but it's too old--using global CLI.`); } } if (typeof argv['yarn'] === 'boolean') { log.warn(`${input('--yarn')} / ${input('--no-yarn')} has been removed. Use ${input(`ionic config set -g npmClient ${argv['yarn'] ? 'yarn' : 'npm'}`)}.`); } const project = projectDir ? await createProjectFromDirectory(projectDir, argv, deps, { logErrors: !['start', 'init'].includes(argv._[0]) }) : undefined; if (project) { shell.alterPath = p => prependNodeModulesBinToPath(project.directory, p); if (project.config.get('pro_id' as any) && argv._[1] !== 'unset') { log.warn( `The ${input('pro_id')} field in ${strong(prettyPath(project.filePath))} has been deprecated.\n` + `Ionic Pro has been renamed to Ionic Appflow! We've copied the value in ${input('pro_id')} to ${input('id')}, but you may want to unset the deprecated property: ${input('ionic config unset pro_id')}\n` ); } } return { env, project }; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/000077500000000000000000000000001425441362600255045ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/capacitor/000077500000000000000000000000001425441362600274515ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/capacitor/android.ts000066400000000000000000000045761425441362600314550ustar00rootroot00000000000000import { readFile, writeFile, unlink } from '@ionic/utils-fs'; import * as et from 'elementtree'; export const ANDROID_MANIFEST_FILE = 'AndroidManifest.xml'; export class CapacitorAndroidManifest { protected _doc?: et.ElementTree; protected origManifestContent?: string; protected saving = false; constructor(readonly manifestPath: string) {} get origManifestPath(): string { return `${this.manifestPath}.orig`; } get doc(): et.ElementTree { if (!this._doc) { throw new Error('No doc loaded.'); } return this._doc; } static async load(manifestPath: string): Promise { if (!manifestPath) { throw new Error(`Must supply file path for ${ANDROID_MANIFEST_FILE}.`); } const conf = new CapacitorAndroidManifest(manifestPath); await conf.reload(); return conf; } protected async reload(): Promise { this.origManifestContent = await readFile(this.manifestPath, { encoding: 'utf8' }); try { this._doc = et.parse(this.origManifestContent); } catch (e) { throw new Error(`Cannot parse ${ANDROID_MANIFEST_FILE} file: ${e.stack ?? e}`); } } enableCleartextTraffic() { const node = this.getApplicationNode(); node.set('android:usesCleartextTraffic', 'true'); } async reset(): Promise { const origManifestContent = await readFile(this.origManifestPath, { encoding: 'utf8' }); if (!this.saving) { this.saving = true; await writeFile(this.manifestPath, origManifestContent, { encoding: 'utf8' }); await unlink(this.origManifestPath); this.saving = false; } } async save(): Promise { if (!this.saving) { this.saving = true; if (this.origManifestContent) { await writeFile(this.origManifestPath, this.origManifestContent, { encoding: 'utf8' }); this.origManifestContent = undefined; } await writeFile(this.manifestPath, this.write(), { encoding: 'utf8' }); this.saving = false; } } protected getApplicationNode(): et.Element { const root = this.doc.getroot(); const applicationNode = root.find('application'); if (!applicationNode) { throw new Error(`No node in ${ANDROID_MANIFEST_FILE}.`); } return applicationNode; } protected write(): string { const contents = this.doc.write({ indent: 4 }); return contents; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/capacitor/config.ts000066400000000000000000000022251425441362600312670ustar00rootroot00000000000000import { BaseConfig } from '@ionic/cli-framework'; import * as lodash from 'lodash'; export const CAPACITOR_CONFIG_JSON_FILE = 'capacitor.config.json'; export interface CapacitorConfig { appId?: string; appName?: string; webDir?: string; server?: { url?: string; originalUrl?: string; }; } export class CapacitorJSONConfig extends BaseConfig { constructor(p: string) { super(p, { spaces: '\t' }); } provideDefaults(config: CapacitorConfig): CapacitorConfig { return config; } setServerUrl(url: string): void { const serverConfig = this.get('server') || {}; if (typeof serverConfig.url === 'string') { serverConfig.originalUrl = serverConfig.url; } serverConfig.url = url; this.set('server', serverConfig); } resetServerUrl(): void { const serverConfig = this.get('server') || {}; delete serverConfig.url; if (serverConfig.originalUrl) { serverConfig.url = serverConfig.originalUrl; delete serverConfig.originalUrl; } if (lodash.isEmpty(serverConfig)) { this.unset('server'); } else { this.set('server', serverConfig); } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/capacitor/index.ts000066400000000000000000000170031425441362600311310ustar00rootroot00000000000000import { parseArgs } from '@ionic/cli-framework'; import { mkdirp, pathExists } from '@ionic/utils-fs'; import { prettyPath } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as path from 'path'; const debug = Debug('ionic:lib:integrations:capacitor'); import { BaseIntegration, IntegrationConfig } from '../'; import { InfoItem, IntegrationAddDetails, IntegrationName, ProjectIntegration, ProjectPersonalizationDetails } from '../../../definitions'; import { input, strong } from '../../color'; import { pkgManagerArgs } from '../../utils/npm'; import { CapacitorJSONConfig, CapacitorConfig } from './config'; export interface CapacitorCLIConfig { android: { platformDirAbs: string; srcMainDirAbs: string; assetsDirAbs: string; }; ios: { platformDirAbs: string; nativeTargetDirAbs: string; }; app: { extConfig: CapacitorConfig; } } export class Integration extends BaseIntegration { readonly name: IntegrationName = 'capacitor'; readonly summary = `Target native iOS and Android with Capacitor, Ionic's new native layer`; readonly archiveUrl = undefined; get config(): IntegrationConfig { return new IntegrationConfig(this.e.project.filePath, { pathPrefix: [...this.e.project.pathPrefix, 'integrations', this.name] }); } get root(): string { return this.config.get('root', this.e.project.directory); } async add(details: IntegrationAddDetails): Promise { const confPath = this.getCapacitorConfigJsonPath(); if (await pathExists(confPath)) { this.e.log.nl(); this.e.log.warn( `Capacitor already exists in project.\n` + `Since the Capacitor config already exists (${strong(prettyPath(confPath))}), the Capacitor integration has been ${chalk.green('enabled')}.\n\n` + `You can re-integrate this project by doing the following:\n\n` + `- Run ${input(`ionic integrations disable ${this.name}`)}\n` + `- Remove the ${strong(prettyPath(confPath))} file\n` + `- Run ${input(`ionic integrations enable ${this.name} --add`)}\n` ); } else { let name = this.e.project.config.get('name'); let packageId = 'io.ionic.starter'; let webDir = await this.e.project.getDefaultDistDir(); const options: string[] = []; if (details.enableArgs && details.enableArgs.length > 0) { const parsedArgs = parseArgs(details.enableArgs); name = String(parsedArgs._[0]) || name; packageId = parsedArgs._[1] || packageId; if (parsedArgs['web-dir']) { webDir = parsedArgs['web-dir']; } } options.push('--web-dir', webDir); await this.installCapacitorCore(); await this.installCapacitorCLI(); await this.installCapacitorPlugins() await mkdirp(details.root); await this.e.shell.run('capacitor', ['init', name, packageId, ...options], { cwd: details.root }); } await super.add(details); } protected getCapacitorConfigJsonPath(): string { return path.resolve(this.root, 'capacitor.config.json'); } async installCapacitorCore() { const [ manager, ...managerArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'install', pkg: '@capacitor/core@latest' }); await this.e.shell.run(manager, managerArgs, { cwd: this.root }); } async installCapacitorCLI() { const [ manager, ...managerArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'install', pkg: '@capacitor/cli@latest', saveDev: true }); await this.e.shell.run(manager, managerArgs, { cwd: this.root }); } async installCapacitorPlugins() { const [ manager, ...managerArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'install', pkg: ['@capacitor/haptics', '@capacitor/app', '@capacitor/keyboard', '@capacitor/status-bar'] }); await this.e.shell.run(manager, managerArgs, { cwd: this.root }); } async personalize({ name, packageId }: ProjectPersonalizationDetails) { const confPath = this.getCapacitorConfigJsonPath(); if (await pathExists(confPath)) { const conf = new CapacitorJSONConfig(confPath); conf.set('appName', name); if (packageId) { conf.set('appId', packageId); } } } async getInfo(): Promise { const conf = await this.getCapacitorConfig(); const bundleId = conf?.appId; const [ [ capacitorCorePkg, capacitorCorePkgPath ], capacitorCLIVersion, [ capacitorIOSPkg, capacitorIOSPkgPath ], [ capacitorAndroidPkg, capacitorAndroidPkgPath ], ] = await (Promise.all([ this.e.project.getPackageJson('@capacitor/core'), this.getCapacitorCLIVersion(), this.e.project.getPackageJson('@capacitor/ios'), this.e.project.getPackageJson('@capacitor/android'), ])); const info: InfoItem[] = [ { group: 'capacitor', name: 'Capacitor CLI', key: 'capacitor_cli_version', value: capacitorCLIVersion || 'not installed', }, { group: 'capacitor', name: '@capacitor/core', key: 'capacitor_core_version', value: capacitorCorePkg ? capacitorCorePkg.version : 'not installed', path: capacitorCorePkgPath, }, { group: 'capacitor', name: '@capacitor/ios', key: 'capacitor_ios_version', value: capacitorIOSPkg ? capacitorIOSPkg.version : 'not installed', path: capacitorIOSPkgPath, }, { group: 'capacitor', name: '@capacitor/android', key: 'capacitor_android_version', value: capacitorAndroidPkg ? capacitorAndroidPkg.version : 'not installed', path: capacitorAndroidPkgPath, }, { group: 'capacitor', name: 'Bundle ID', key: 'bundle_id', value: bundleId || 'unknown', hidden: true, }, ]; return info; } getCapacitorCLIVersion = lodash.memoize(async (): Promise => { return this.e.shell.cmdinfo('capacitor', ['--version'], { cwd: this.root }); }); getCapacitorCLIConfig = lodash.memoize(async (): Promise => { const args = ['config', '--json']; debug('Getting config with Capacitor CLI: %O', args); const output = await this.e.shell.cmdinfo('capacitor', args, { cwd: this.root }); if (!output) { debug('Could not get config from Capacitor CLI (probably old version)'); return; } else { try { // Capacitor 1 returns the `command not found` error in stdout instead of stderror like in Capacitor 2 // This ensures that the output from the command is valid JSON to account for this return JSON.parse(output); } catch(e) { debug('Could not get config from Capacitor CLI (probably old version)', e); return; } } }); getCapacitorConfig = lodash.memoize(async (): Promise => { const cli = await this.getCapacitorCLIConfig(); if (cli) { debug('Loaded Capacitor config!'); return cli.app.extConfig; } // fallback to reading capacitor.config.json if it exists const confPath = this.getCapacitorConfigJsonPath(); if (!(await pathExists(confPath))) { debug('Capacitor config file does not exist at %O', confPath); debug('Failed to load Capacitor config'); return; } const conf = new CapacitorJSONConfig(confPath); const extConfig = conf.c; debug('Loaded Capacitor config!'); return extConfig; }); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/capacitor/ios.ts000066400000000000000000000066511425441362600306230ustar00rootroot00000000000000import { readFile, writeFile, unlink } from "@ionic/utils-fs"; import * as et from "elementtree"; export const IOS_INFO_FILE = "Info.plist"; export class CapacitorIosInfo { protected _doc?: et.ElementTree; protected origInfoPlistContent?: string; protected saving = false; constructor(readonly plistPath: string) {} get origPlistPath(): string { return `${this.plistPath}.orig`; } get doc(): et.ElementTree { if (!this._doc) { throw new Error("No doc loaded."); } return this._doc; } static async load(plistPath: string): Promise { if (!plistPath) { throw new Error(`Must supply file path for ${IOS_INFO_FILE}.`); } const conf = new CapacitorIosInfo(plistPath); await conf.reload(); return conf; } disableAppTransportSecurity() { const rootDict = this.getDictRoot(); let valueDict = this.getValueForKey(rootDict,"NSAppTransportSecurity"); if (valueDict) { const value = this.getValueForKey(valueDict, "NSAllowsArbitraryLoads") if (value) { value.tag = "true" } else { et.SubElement(valueDict, "true") } } else { const newKey = et.SubElement(rootDict, "key"); newKey.text = "NSAppTransportSecurity"; const newDict = et.SubElement(rootDict, "dict"); const newDictKey = et.SubElement(newDict, "key") newDictKey.text = "NSAllowsArbitraryLoads"; et.SubElement(newDict, "true") } } private getValueForKey(root: et.Element, key: string): et.Element | null { const children = root.getchildren(); let keyFound = false; for (const element of children) { if (keyFound) { keyFound = false; return element; } if ((element.tag === 'key') && element.text === key) { keyFound = true; } } return null; } private getDictRoot(): et.Element { const root = this.doc.getroot(); if (root.tag !== "plist") { throw new Error(`Info.plist is not a valid plist file because the root is not a tag`); } const rootDict = root.find('./dict'); if (!rootDict) { throw new Error(`Info.plist is not a valid plist file because the first child is not a tag`); } return rootDict; } async reset(): Promise { const origInfoPlistContent = await readFile(this.origPlistPath, { encoding: "utf8", }); if (!this.saving) { this.saving = true; await writeFile(this.plistPath, origInfoPlistContent, { encoding: "utf8", }); await unlink(this.origPlistPath); this.saving = false; } } async save(): Promise { if (!this.saving) { this.saving = true; if (this.origInfoPlistContent) { await writeFile(this.origPlistPath, this.origInfoPlistContent, { encoding: "utf8", }); this.origInfoPlistContent = undefined; } await writeFile(this.plistPath, this.write(), { encoding: "utf8" }); this.saving = false; } } protected async reload(): Promise { this.origInfoPlistContent = await readFile(this.plistPath, { encoding: "utf8", }); try { this._doc = et.parse(this.origInfoPlistContent); } catch (e: any) { throw new Error(`Cannot parse ${IOS_INFO_FILE} file: ${e.stack ?? e}`); } } protected write(): string { const contents = this.doc.write({ indent: 4 }); return contents; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/capacitor/utils.ts000066400000000000000000000015601425441362600311630ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions } from '../../../definitions'; export function generateOptionsForCapacitorBuild(inputs: CommandLineInputs, options: CommandLineOptions): CommandLineOptions { const [ platform ] = inputs; return { ...options, externalAddressRequired: true, open: false, engine: 'capacitor', platform: platform ? platform : (options['platform'] ? String(options['platform']) : undefined), }; } export function getNativeIDEForPlatform(platform: string): string { switch (platform) { case 'ios': return 'Xcode'; case 'android': return 'Android Studio'; } return 'Native IDE'; } export function getVirtualDeviceNameForPlatform(platform: string): string { switch (platform) { case 'ios': return 'simulator'; case 'android': return 'emulator'; } return 'virtual device'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/000077500000000000000000000000001425441362600271415ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/__tests__/000077500000000000000000000000001425441362600310775ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/__tests__/android.ts000066400000000000000000000026441425441362600330750ustar00rootroot00000000000000import * as android from '../android'; describe('@ionic/cli', () => { describe('lib/android', () => { describe('getAndroidSdkToolsVersion', () => { beforeEach(() => { jest.resetModules(); }); it('should return undefined for a missing source.properties file', async () => { jest.mock('@ionic/utils-fs', () => ({ readFile: () => { const err: NodeJS.ErrnoException = new Error(); err.code = 'ENOENT'; return Promise.reject(err); }, })); const android = require('../android'); const result = await android.getAndroidSdkToolsVersion(); expect(result).toEqual(undefined); }); }); describe('parseSDKVersion', () => { it('should parse sdk tools version from source.properties file', async () => { const contents = ` Pkg.UserSrc=false Pkg.Revision=26.0.2 Platform.MinPlatformToolsRev=20 Pkg.Dependencies=emulator Pkg.Path=tools Pkg.Desc=Android SDK Tools `; const result = await android.parseSDKVersion(contents); expect(result).toEqual('26.0.2'); }); it('should return undefined for a missing Pkg.Revision entry in source.properties file', async () => { const contents = ` some file in some garbage format `; const result = await android.parseSDKVersion(contents); expect(result).toEqual(undefined); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/__tests__/fixtures/000077500000000000000000000000001425441362600327505ustar00rootroot00000000000000icon.png000066400000000000000000004271771425441362600343510ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/__tests__/fixtures‰PNG  IHDRQ¥ÌRsRGB®Îé pHYs  šœ$iTXtXML:com.adobe.xmp 2 5 72 1 72 337 1 421 2017:01:10 11:01:36 Pixelmator 3.6 L.Çá@IDATxì¸Eµ÷w/gŸžBz#…„@iôJ(bàR¤I Š ½~^ÁÛìWïµ`Gi¡I¯B `zïý䤟º{û~ïþ'‹×}BDI‚Ê™çñ‰f³YMmtŠñ¡Q¶Sê,Ðó²Î¡¨Ã×Yñzè¡o~ó›+V¬`Ý#Úûôé3zôè“N:i„ ƒ bFÈd2š,¨…2ï\fÇ%Ýx™èSÀæÍ›ýë_ßsÏ=D;¶3(O õ!C†üà?8í´Ó´°íH‚ýñoÖ<ô@gÌz—ZÀ×ñrþý½ï}ï[ßúÖîÝ»‰mB…°©Ú^½z} ”N9åæj ] &EØ áJ¨Jw ´…º½½ýøö·¿Í,VWWG=ª¨¨ k’×ÜÜœøú÷*HhÅè ½ WÜïÚµë駟þÕ¯~Åu j3OAI‚€åbKKK$!ø“ÉdïÞ½Yíé~…þb»¨Ùk©Î‡Ò1(­ë’MxÀUW]õÒK/¥R)]ÙÊhU¯tN0âfÙ<ꨣˆÿñãÇsa ì’zø@‚ÝhOúÿéOzõÕWŸyæ™eË–±Î×ÖÖR‹ÚL šÝìÀMº`a"ãZ†töÙgwÜq‡¯-•,Ðó£#àÄZ÷àW<»ÁøºhÔÌ]wÝõÕ¯~•µQñC­UA àW.^`⟣‰ÊÊJ–͉'N™2…Ë~b†éà/nûM7)`9ò¥hD¦¦iQbAšV,Ôh‚ò¯½öÚ#<2gÎ ¹æ;¤õë×ïÖ[o½úê«©rëCQú¸ÁÂÓE†€.6zðéÀèŒùÛç@µø™\Mn©¼÷£ˆ`–÷Ï~ö³{öìÁéY¡¡V“‚$¸sX<ˆ…L2!f©$`ˆÉ#Ž8‚c¿±cÇ’s©Ü½{w¶ÐRWZIÉ7<€Z¦,·À@IBšøGá 6,X°€“¹uëÖíܹ<ÁºâpËT¥° W‹ …AOzA¹ÀAÂ7ÞøéOšÝ¾µN£¨ WÙÄŠY9À&V“ECZÓ@G tÆ|G›üuse¹ ¹)x`-˜×Íœ9óöÛo'Ôqt’·¨-cGˆäàô°£ ^N"ðla$X˜.]º°`r'ŒY€#@r.›9``†z]G Íš3 ÜÔÔ´}ûvòM›6q_x"€àL$à‘#» ÒØ·RÒe õÔåÖ}Ñþ<07óè,œqpÛ‚Kt¯¶†r06y©Q0T0Æ+ yG tÆ|G›¼# žŠ×ºÿ3ÿÆSUÅ9öc=Æf˜b7 ¿d{L±Q'¢À4)^rKBR0á°ƒQDÁ‹Ú2€!ñxj£Ñ(ج¨`(ò`L,£ Fè‰7ŽÓÑ„%€Dx#=1*Š‚ª¬ÉðÒœz§¾H7(Ý $ŒÒŸœdµ2 ¤*9”(JüG}4ó×È‘#‰ÿnݺÙl%9Ê!F‚™Ž¢¬$ÅÜ”pG tÆ|G›üœ oÃqÝ<,› K%÷äx|š¨Ã/Ù¾âÜx*UÄ,ò{ñ"§,Y­|šhCL*Ø,lO‚9H2†X`Q£H)±Ð“T´Zk€%j“P™°K8€%õ…Œ`«‚XB¤<Š ™Ì,ÀºxaÚâQîíx≜_ÿ°[_¤°äÀ@s¨j togΘ;Ëü¼üODÀòBB—}â‰'t³š“6X.€9Ð@ÉVË–-L¬«Âˆ˜¤„Xò…¡"„•–&äëæâPs½`1 •@‚ŠJ¨V O“XÆ B$J;m`ª OãÄkáH£V¹h(*CBÎ#рɑ¤DÑ4E&DlˆJÜ 9à=z{ì±^róbØ°a<Ì[’Ô™ý-èŒù¿Åjðà£8¥ÆY-ZÄ3vwß}7K:GkÄ MØ˧YÇHÀŒqUO­…ìŠmå <Õ‚!ÁE<(ö¨%ÑÆ$U"VL*ÌI# ÂÆ"I4ä)±(ŠÞM FRƒ$G,@ RxHpQD[ÿöØŠ¹ŒZªPCWJ:° EjÉÙÿ³çç÷ùxlà $P%9Ö`‚èL°@gÌÀ8ï´Š%kõêÕÏ>û,÷«‰y<çãrš¤¨ÀñfÄ‘ƒÑ©—Ó`(Z3Š"0ˆ…Ÿ  ˆR.2r‰`b€VD #9 Œ &Q$©-“ °R‰ÄáB=‚ <,âB&A(¤#qßbXUNÃ¥â>‘ŽþR‰Æ,G²6/jzº ÝÄkÍG¬—KdÛ?mÚ4íüiB±¶:ýZ 3æÕCŽŽ‡a#<Ì,†¢rP’C,̶mÛ8¢ã65Gt‹/fïâÇ$¢ç抔•\‹î;^+f^`©W A¯VN<Üj(”#Vž­J%ŠTí+9ÿ)’Êä€7FjÕw`ª;Ì%2ja'‰E¹E¦$Ç&N{¥È¬\””K”ïƈ J‹¬Œ@Û%rlÎM ží;óÌ3'OžÌe¿»h;:Kˆ$“—I£1ív$PÕ?A^î(ÿ]:p4œ 0IÑÀ˽äÂhÔñZÊXÏ9å^µjÕ’%KæÏŸ¿®”oÏ3^IJÉ'¼YçÙÁ"*µ«V WõlïaD¾Z!ø©"¨À°—ÐNFQ¹È%SE“/¼»Êè€ztŠŒ† UT/ÈÝ ’ILFr”Gš`r’ºc¦ UðJr%‰~nï„eÅŽÚ¢!í2oªuV~R"òO>ùd‚Ÿ[•’‰|Ä,îÁƒzÐÀ¥Ô±ÑÌ[ùÏÑŸ¿Ø ­ºitËè5êø“àŠp–t6ð Ä*«4„+~F„ËéÁh!gvà*”Z®? `hNn L+$ž›vƒ4vI&'ÉùðQËUU–C€(!(*©Hn€‘ ©hßGî8=mY E© ™„£3‰"xrI\ªÒ`ð°+—T•aÜxÁsZA%ä#aE,ϱfïÛ·/wû/¸à6ÿ¦PE!³v¥­º£ðnÌ[ŽòÏÝÏŽ½cÔAâ1äxQjkµ.5׬Yó\)ê<¯‚?‘äX,ìò•#Qˆ… är—båa©§(ï„ùа:q9@Ø3/ G~ —„Hg1’+A @•ŠÈÕ:B ¿W³}!jEè99“DoµArd’CLB+úNRzô§(FD@lr  ª /áb¹x­xJÕ"G­£z @s(¦?}äuúôé,þœüa:x! ,Qe­KaĪöŸ/?ƼF]AÒqÔ‰C^ãyò?þñ[·neìñ¼GË5ôA2G($ðsÔÒ»wrÖyîK©ExU¥{ÑÀx'‡\ “`£ˆLÒ¤ Ý$*pWb07=0¢r±¸s©„4šf&B‚NÜ-J¸0 `ÁH¦HB&°°’ŠÔ"V4à%jÉ»ý4Z1eÔMµKTKÓ HlËM¾³Î:‹Ó~žYÄÂRÙm@plºÏ˜ïVË¿Kþ÷]Ì3®æ(rt\DCCøñ–É.]º”7dĵx~#ÿÀ{¥òÈðy ¡¤HŽ·! ¬óš/ € <”°€AíäI Z¤ ª(Zn€h(’$A°ðbƒJn<ô– aŠ¡ ”n•$œ*ƒ¡„̤¨³ÂS¥¢U‘^Ð94&§Lˆ[à_ #JÒ4ò½4'ªwj2.ÇÀsÂÇ»‰,ûìü9ùÓp¨]¤AÜþkµúû§ßż{h5<¸;ï<þøã÷Þ{/wÚXÒqüƒËBª€má•{Q+9x ¹¤µ$µ8ìT!¥^¾(¯"§H ±³À#)"–"Í•Ðoî¢)#@ôb)Ã(ÑJÊP™âÅh˜Zðê&4¶î©Qð$µ" ô–À /‰"9µ»¦L1ßeNÓ·8—4lHÉ©¢wL¸ÀŒµÐÓeŠÊy%5_÷ù¸àgà AyÈÜ€Äþ“åﻘgüäˆrÎä~øáûï¿Ÿƒ:Æ^a€ß@C‚†\C®*ùa@ÎD€$ï‡R‚÷ã÷ìð‘ÆU=EPKNbRàvóMP…LˆMÂ-ðhK\–CF/À¼) *hK !n%âëÜ2äLÅÀ€§!·dkæ)”f¿³¯R†\xi F¶…’^STÌ‹²cnB¨‚ž¢ŒÂtd9¤F„Ñ¡ `¤x ‚eêÔ©<ÛÏ?x¬§Q“¶neÜ`UÑ`ˆw¹Yþà½ÇWªüm:ÈÄ6%+0e¦g,IDHÜ‘'dó›ßÌš5 Öv»&{£€FšœdC«*Š$w*JÚ‚zµ Mkó Rô"ÏVzí-Ùlã+hE¡ ¡ƒÐƒ¯Ú’>•\¶Í9/ís»±Plݽ§Åp.:ØwlÞÜN$O?ÝH~o Šfr{¿ÉebËä›pS ‰. 3ÉŒàÖXdÆE„Q¹’ìCìç?Œïœ¸ŒßÍ‹¶ìÌ@à âr­7`ÀÂþüóÏçÀ¿k×®¨SðZï€Q•¤Ž¨hšø; x§§Rô7ÇY*…–zÁ`w0’…Uo¼ñÆOúÓ_|‘åTÇéòQ̆QTb•`ÆLdEkÑj‘iHùš°nÓ¨#£äЊZ'{Ü…Up°ú#™ÐCSÖS&Ðt©"“E>WL§²ÉDš“IèÃag÷Ž;:ÓJ†úW7L ¾ó*kÁ³W=Ø!–„¤(µ‘€äÈÚwP/¤±Ã¢™ª(ÂKN‘ ¥ ~»*x±'-bd‰"6!Ñ Î8øh÷ƒ>ÈVÿ´ÓNã>/öp €ªê24$±kâ !ÀCÃÀ½]ëïþ>æ;ÚTÉØh–e8yZöÎ;ïdþæxœ!áe,j uëâèD9ŒE˜ÀÈ °*+ŠX”äøÂ…D0ô(I’sƒ—g(’!ÓjVœ®Gsf J2A $áÒG¹jÝy¤"ÖÞÞšÎfà …ÃMÍm¾?íõÇ)0!O57µÂŽ¯g2øñ^áî†@I¾êЇZ%𨪊vð ÉE L‚E’FQ€èEl,ÆîÆ ¶*I(c/«5vÃqÃXXŠ1@V…)°Œà[¾|9×€?ÿùÏy“Ÿ›|Ç€) ŒrCŠÈ§d‚,õÔù>TAŒX”DEždRrË1XjSTÓäÈÒà5±¨wÊ…04j’;ÀnF£49n ”*°ß"­ v¿0/xA0F£_p0£ÁËXhçÈmݹsçò‰6ŒÄ?¯ôœrÊ)|Œ´ãX3Å ©vÿNòø˜—`MÙ—¨àŠýÑGeJæu ,Î7U9jK匱ƒ|—‘Ö Ðd‚¤ÖWU™{A†*ü/P _E5­æIB¸T )˜ÁƒTä#„ Ç⎞%ÅQîÏ7Ïí7AQÜ*ORfÁ‹z¬ôÎcB%!~îÕÕÔÔr  >3À¾zK¤ä”šÝ3ÔQ,u™JHê½€X”ô˜$AB’ƒ)u×±6EòÕÞ¡1Œ¸T+JȬVr,72kNìî¢Z)%F©­*åtqÄJä$F¶°=e¨‚†Û½<ßÁ/óýïÿþ/1Ïïñlÿ€$„1ðß[zïc#šÑ±ŽœÞ=ZBB£1V‘ Ä"f'Ì“³÷ÝwßÂ… ñBFE»ÛOÞ R‰L$0–'Iš’RUjTÚJO0¢q¸@ˆbøE;  ¸‘ðä a †(’ЫœŒ}>³þ'塇Lª”%Ó‡€gjO·á ±ênH¨ïZC¯™b¢Qßî»ÐùÐ#Ö9ÌB”ØN/@xªHpadr`ðê…l ½0¦`á%ÇdZQäî$ù"¬Ü†^’¥¬hx @‚‘™40$©-¬ûËI°ƒ:hÝD&'Aä<ÿüó¼õýïŸk~~¶„m?x†X ÷ƒQðjàLŸÃ¼g1/sÐaŒb0¶v[<„ÔHÀRLJÀcJ>½Î;7áøN3Äx39ö¥J¸Ä"z!1=Ix#C‚Å’jÝx´’ÐïΩ²¢˜&&ÊÓš£=±M×”À€'2IœçÃènEr„±AªQ¬Ïq¿.‘hú0‹3ݨž»c àb¼{×n4á-z2Ev³{#ÓÒ_¤aRÉD%6JäÂ;Œ®¥³˜šƒÀ¦¤tp³€Q¨(!zVxN’ݽ†WEµU–SK)ÀòŽ˜ý’}Y­Ø÷+D,ÒS°› ¸c‚Lfï˜w$6Œv5Gs"Ó7î¹ òùÁòßýîwliŨ¶€Õ–I;tÀ{¶ÎóXâ/ùKž½á÷C±Eð´¸áaô÷’!¬ó0ÙHµT læ^ôÆ.€Á¥å´eŒ’cU(#¤IÓ؈Ëè¡$$7J«K‰¤<ƒÆªNìÒŒñÊÈ ã–em”Lw­ÁðŠ@7—ðj]¶]$jiZ¾«yQ2>µT‰ÅÀ˜þj¨,W»Ö:ÜHé)• ~;!¸yÅE.F«p‹¾L¦Šn²ýtDºYÜ’é¦ ày„”)ñ|îÿüÏÿð]mž‰cÄt~p1f…ƒ+Ú¤á4Ìvq¹âc?ùÉO0Ï'â%…ZE;Iþ„!Ì”#„LÈ”ºR²"µÂÐ I0\TKîNTQ”dwnHñ’«VôeÊݵ‚ÀÝ"µ¥*U¤2ÞŽÍA 2õZv% Q„¢hq®¤0vˆÉÙmí5¨ëÒ9œ¶À ÈÈU„X°d[­ˆÌä  –ä†!C%‰,bËAvä-«EšÈ¤UYQÄ"0Æ20RÀDICr‰5Š89E¬­ À¼paL®çA«GÐàäà?ò‘|ûÛßÖ(0jЀ×`™ØCŽu^¯ç ”ëG ±k»ìÈ¥=Ä^î~ºí.¼¬ï†…*ÕÆD!G­€ Ê@ŠRd¸)æUn™o#“änJSÕZéÈ—Fƒ»à: ÁB™ Þiiß„ é2¥Ó^/‡2jä8% zÈ$Üà ¹ä ¸ÀS$ðvE œr ½;ï(JM‹F°»é·ãEŽ›ÑM¶_ØM/`'arcAmQ‚V‘ZÈÀ“0)çÖ|H{âĉØY¡™I8¤À!yºM'éƒrºÇ÷Ûù¨?ðÌÞ$¤zKŽ×‚!˭趩I32ƒÕ¢|$ @Ò”—jöfbeF«D‰LUe4erŒÆ-Ù Cà–¬"¹›Ì`Ñ[@”àÝñ) N­ŒI®yJbž\  N¢—b/942©Ú"W±Áb'c¹D)^ ã†Á¨ˆ2Pšp·„ýÂ&Dò¼cdnƒÝ€›«#^r !ɶB’ ¸dZ'žKäÃÄ\ÌM;K!æµÂƒ‡bws‡>ä1¯0¦“ô €/Xñ±:={¬s;lžDüã[2¹ J·I²šŠîœ*(ÁXÂv†”¡U%2rGœ+#8ƒ 0¤±S%¤0À’ ^#0!q™HŽ醦£43xyÂIÁK¹TamaÜ9UàK¬{í@-Æ£BÓ1Y•iö‹1ú2€Ý)à–@mG¤”±Þ€³C¦IÀZP‚—¤*0ØGÆF!©Åž0& ¤óø´Æu×]‡Ï+4 ‡æP§CóôÇ,Eçy†Tr¯’Ež€Ç:ôŸØ‚,3ÈšH(› ¨2Ó,bØ©U»ÊU4«ÊX ob óÎwÈ ®`ÄÐÁ¨õ2ÍËTR­»ËÀH0{=k‹ZQ-¹ƒbx0À ¹\Öª¬Áä¤Ò~«ÊRUôÊÝìer¤mR÷‹´¶Ô)ŠînÂhTK.Q–;0 ³À»,<@R¥Tâp"œdýà?8ãŒ3z÷îÍŠhÒtÈ7hOm"|î¹ç¸EÇÍI"\–’u0 —ú²E™áÅA!0«!X¹Ã¨EDi ,ÇwIà• #I`Çܪ °VÜ쎈}ÉM°÷Ö7×^ öý%€}¸?ƒ;"ß’»2ßÚ‡ØkºLHÔ“%±¼L­Á˶ª-ɱ’ðª"7±¦ ’!#YmYÑðn@„1i*ºEQñídºkËÝ͹ÙiΪŒÝ0ï0åaÇ,$É/OCŒI¹œ$»[g§ŠûVœd ý;QàÝÓŽ˜GKºGÎÛ²|3D/ÉÊ@˜F}PÑ1a)a5Ù‹ÈHV%rÈ, IÑj4Bn¹ä"6 H²É1¼èÅ®Z7,.0Æè†Þ] ´*£,+ U–ÜxƒU‹XlÎæHx4ÇzbϪÒÑ¢„LÝ4èeh lʸI@7^°ðä V± £Z7RÜ·„Ž°[“fìkM‚º©ÜeØÁc(ù¤„€”¡ £* \ !P’4®çÛûõüv˜ë5GºüpÄ< ½¥¼ÏËpO‹€d  ›@:Æ͈21Œ219Él¡¢rÑì¦1xŸÍÿÌôn!Æ`\[-U&ÊÈ:ê²áÅÒ‘—>Z•š°†¬i QQbË„C Zrl(3b[¬ŠÛ‰XUPšU%V­[½%éfŒîV@*IHYnÒÊ€22wJ÷ËbHh‹LˆîXkde@G.ãuwаÖU+v!eX` rÀ`L™‘¢ Öfží=÷í¿ûÝïR™š>ÔùAk†~š®Ä3°rŒ¢îñuZ~ì/ÔËsÐËFZöe;¦=ðÐà¯`D€9€Á3G@ŒX`HªÔ(°EÓÄ ýÁ(÷­½ˆ÷x£áˆ/à¨(+³þzÊãã=ælÁï)ýü¨S¡˜OgoÀç/äJGb…"p1› 2RŽ"NJÑãËûù+üùœ×ç ‡“Þª|8€É{TE²pÆï F’%v$#.{ùrEÀ9Z£• ¿ôˆ‹—Ÿ–óñ çƒv€EÇo°_¹£E`™kÐzé£Î^G!ÌîÀÂïÌ"ÍŸ/†ØQJ¿ÍpP—gm²Î¤ó/eä tÇŸÌBœ-2žÖy|´ÃMÚG÷¼a ’óA–©B îhîEÑBEÑ_™÷E3Å ?x‰éŠ§ [ä 4ŠåùgÀ$§CH4ËomøÐ!>o0ÄG;WâÓÛÎð¢*Ÿôc¤üùT.ȳp!÷æoE$„³‚~Ïy‚ÑáX®…ûBL¼•4pÂÀÙÏqúR(r…Œ(_(èñ{m'F°‡—WPÁŠP"›LgS|Ç`¶ Fƒ©b&Nâ9øWº4‹l~èx0â£tñd‚( ã8y(¦QšFš¥E:ÀTÈMʱ@B@É;³BiD8@EršŽ‡‚9ö§EgòÅ£‰8¾éýÁÂA2YCà  §ÈÝ‘8Y†ŸÄak„áïL4G-ʧòÙT.ËüåL„Aç. x‡=`*Iñ;\•1gÚ*ù·3­D#)>ÊÉGfxÛ"ålý¸&AÉDiZǶÁŠZ¡|´2Æ ¶%üä&½Ë°›aE` ‡œÑô2d™P8Pð–~®ËïÉ{=ÉBŽiÆùãKÞ ý-­á€ók¿!¡¤r³0 ¸] ‰†±€ždìTƒ‘€…1ÁÊ‘€õÈùr&¡òK8Ƙ† D rTsPÒA‹y´AE3 EìE¥¹táÃ@<òSš`¥‰<4äeIý¤“¸UHu !b'w'T4±îZ`€&ªªbmm-ÑXÁ+âO¡¬¿ðfsao–ï=ç²üVQÊæó³Xø˜ ÚrÉ O[å3aР/Kh‡ýo.•K± ‡#AuÈR…Œ7èó½L"™|&žI4§Û½A_4@C™LŠ|W²%ZW =r™?MŒ/N•Î¥‘Œ…ñZ0ü‚R:™ND*Y_ùfm:  s‡ÏËÌ‘äƒvù\†)Ý0,ì[˜ÄÀ 6ìì¼íùT6@TÓt$ñ}ù@1ãÉ…£¡d2¼èœ-f“ÅL<¨ŠE½&Ä ÖhÍ””áCš‘P‘ñô“v8žXUE>›Ž{2¾H žlGóP4ÔšlÃŨ?íGbŽb0Â{Si¯ß“È¥2Áb He’á}Ø–'°dÁ_ŒVFÉv Â~£ƒÞ\OqûiÑC‡|ŽX‘y³5ÑÊgB̤ù3,}¤¶ˆüL’VØ#±1#¶ù¨?·Í¯y ­§*”ù3Ìá<ËÜí)2MðÕ0>Iƒ3Ìg©’`Õ*&åŽG•’hðLíC5Y£±XæÃì8çâwYLŒ’¬%GE1¾ûü Å<½E”³¨“rtcÖ¬Y,òð 1¹³};ÕeÈH…"2IfbðÂìõv±ývò¹l`ñabTXÄ’8 +m!“²‘bÊŸÏú²>¢ÈúOô@]L°nT„˜­pÓ@4ÜšjÏz‹É\ŠŸsŧ >o "”̤ñQ‹[°,$‹¡bÚ“.x³5ÑŒ7“ô¤âùD0`[é ƒÕá¦Lk¶˜æ§ãBÕѢ߇k¢0žÊúIx‚þTž-¬ÇÒ3 ¾@Ø 'U‚0‰ŽaÜßGP±ƒÃ>Ü °ãDƒÉœ¨ŠÊ–â6Ë&ó¼ÀÄŠí¬™,ƒ,ªLXíLIù­{œýHˆ-‹ÀÈa¶r¬ï/†*¢LOÛ›÷Ðb2åL4¬Õ9 Ûm¬·9æoI͉)­¨«Ìx‹)³ƒgNaAÌ{ؘg™eø˜vуèLš¾÷˜Ý²¹´öDl…˜+™ÂaGOçRŠ9ϹB tsæ)L”‘ ³AÁWd»„¡¨… 0̆±ê˜×Ç$Ïœ–)µð´RL|΄èŒ;×Ζ„ÈgôI½¥£_Á$JrNsu$ –Ï$摶ߘw7„K;.^š#¸Ú……|ÅG>°DI¬Šä+ùo»í¶ƒ"Ký!Gi:ŒLíù²ÿ׿þu>MÏ»4š´DCŸH¤EÙ[ ‡*U 1%µÀ2ŠU Þ‰*ËUKÎÞ‘íG!Ÿã*ÃYܼÞÖ VBÚWÎêìisùt*‘z •bйœÎ%S\·àRÄC.ÌÒT‰ã„J†­ù1Æ"Î&¤ˆ[û½í¹43BŠ©¥½Ýá¢ÒK´¶¶àgmñö ~1‰„“©$WÛ‰DáÑŠh"—ΈƒtŽ„fÁϤۓíÁ+“Ÿ¯¬ái.‚Ã>jS™TŠØöØH§=9$”ÌóIËZ*Â)O®©½µ²®:ÅDŠXòG«cì{=ü¸E6͹gÍ©öpU 5øuŒdk–M0ñ½ \Í ;‹M³óO¦\k$ÓI–È×#ÅB­sà)¤ýöäN8?Å"òÛs©¬—Õ¶ˆâ ¥¹™³‡¼ÏˆEЉ9ˆOç)O¯‘̧7ýA?ßàLgRÈa.f{Ûow>¹_ä uNâùt¡ti…þñW(Å#ƸÅx"ζ¨Èð0ùeæšBL¡-ÑÎ…×ÌLB@ð#¼Êéa§ÂÁÌäuæBªR„Ëñdc‡gI€/¥Š"K7É;~ ‹”ª‚J®Ë`ill<æ˜c†œF± Àôy—ÀÞ{9ïR ì¨E觽Y:Èï¹ç>PÏ7p˜ŒŒS n˜ZŠš…C2%±µ`h®LŽÑ€, †ç"Ö“/FÃád<ήÒ yÁôí‰æuMÛÙRFŠUQoàèýCÁà¢kXSÅb}´rD¯þüäÛò-âù AÎVxD~]ªjæ¯XZ±ÿd…ÎëvT¿î=ç®X䬺xV>?äèAƒû X²ryk¼Ý_ñ´¶ÖWÕN1bÍÆõM-Í\Æ×jk*ªì?pWCãö];«‚uD¯/:èÈöDbËÖŽÍBteòGõªŠ-Z¶¤Ý›¯ G¢¿WKЮ۲igóžP¤"”Êê׿²¶fñŠe|d½ ·NfzT×:¢÷šÍ¶%[#¾Öâ¾±êáŽ\´li‹wθ2ÙîÕu#{\±zUk /d½íéî±Ê¡ƒsž¼e[#áÇg™qÊÉ£F··¶­]¿ÎñÑl&æñŽv·^ÖìÜÚÖÒðúYélUMõ¢U+ˆpX*ÃÑ^õ]èÖ}éê•í©$ÓS,TÝ'ZÛ¥{· û &Ê>µ=¸rýZ®™ø«,z†ÚÚÞÖÐØÈOèUGc•žÀQC†nܵ­aû6®ÿÓí‰þ±~Gtí–õyÖnÞˆ’œªdrƒ †üK—-‹TÅ<ùB1žrä`o8¸±±±)—Šrò¸®±Øž­ˆTðEïl&í¼–ŽEÝÞ%‡qç8Ú’p<œß–G@‰Ï“SEÏ…º¢¤Ã¶Øœ@‘¬A,7³øÄûwÞÉ/Û:Ç(¥‰CôÒÄÍû.áƒóè¡©€>ÐOºÍ»4¼*ŒAé§5,­Zü¡)™b¯9dåTAO¢HÏé°æK0+^L&³ªx» Ç][Z]˜ù3„=UÝ»Þôo_ZºsãO<è©àL½»t¿æÂa]Ý~ϯv‰F¼m©Ë®¸žóžŸÝ7Áã«Œé}áÞýþ»ß4´7µ3ó Ó&qÆQ“ö‡;Ö6ljæhØë=uÜÄ3Füè³3—¬YÙâÉv­ˆŒèä‡O¹ä¯=:oñÂ$‹¡·8¨¾×õúÈ’•ó}ö©–JgÔÛWñ…+?¹bÓÊûž|t·³5. Õ|øC'=ùø]¿ÝÎGòÞê´ç×]ž…~þû»Béd°è­Ï¦Ÿ1màÀ¡¿xänæ/î&T& gN9õ¬Q'ÿ߃¿(´ncWïßÞzú‰S>tòy¿}æ¾W7.çd«²è?ºÏÀ›¦_÷ØxxöKÕUQ_2Û³K·O]râՋxêñ<Þb×Úºkf\Ö¼k÷½=öš3ÉÚʪ«.»*OÞ~ïo¸R`|CþÀ…ÓÎáñÊĽ¿mjke¼¢þà©'N?îøÿùéö´4ãÊXi¨1S§Nå “«Vòë™djìð‘]8ã'ûÓ‚y>NO“™±ƒŽºhÆŒ'^}±°h~·?ÝÜ6°®ûW\µlãÚŸx,á+t †»‚W^|)bï~ô¡¦sÛ¡{!tõE—qFðëû~×k碤¦-þôóè×ûÿ~õËHÔß²i{aÛî@’=š—ë ÎhÙGc’ÛCœò¾$<9£€ËÆ'ñCUÉ»pE(’-æ!ïÎU˜˜'.lSÀêÈ/5ñdž|[‘%¡?ˆé ííéV@KT ç“ >ûd]¿G;vö’¹'Lœ0~ü¸g^z>éÏOšvú¼ÕKúôïwö´¼ôòK»R-ônÝž­‘êÊK/šñÇW_Yµyý¹—_¼zÏÖl1ÉŒë7¬Ÿ½pþiž³'ŸÚ±ekbuC4í¥r«¬rœªórÜÃí6r3s*ªH¸.> <48!¾ ÀÆž„»2âœÐ( –¼äþ/EªÈ€A,Ãʵ *{î¹à‘Í~U*ñýíÙA‹y”£Kt˜@EW`~F’oÝÑ`)Hß S$«Kê9x’hÀÐä˜!fŽ  ¼f ’"F‡VÀƒP’Lå`€c§L–ßyÌdÓ¡HˆÓ¦cOŸîRÃ97³ºVVWCmÍM±Š(çº1¨¶ºª*ÉsáÉVÖÄBPm$R«Jîiâz±¦¾†]}]MU—X5.ýÙos Î½[´ŠC4n¹q3*½ÁžÕõL9Éx‚3zöú{Övá¢6ÑÖ kB1±YÃJÕÌïÌWñ5_•Ç×3R]îÙÓŠ…}!4WèÓå\,ÑÚ^ V„a05]k"‘t2UÈf*¡j°K ¢ »ªÇ©.õõÜŸ<"V‹FZÚÛ8 «ŒUò—•ž`®]rÙÒÏ×Åbêo÷.uÁ¼'ÝÒÂaYeu cv©«­ðS{š#~>aáʵ¦¦’.·mßñb±h!“«­ª¬ W$ÚZ¹nª¯®*$2´^®ð`\ž; \U÷¬¯¯ ESMÍÎ-¼ŠP8ªõ¨¬Kf“ñd²¦ºƒ„³ùnUµȵ´·×UTTø€’¯[u¶hokg¾àFK7€m+ƒÁ]»vsrY«âN@ŠšÊH¸©µ%W¬¬ªâ†|?Ü¥²&™Hà|±hªV¦<{–®ç”‹šb(˜ÀÍBÜòpvdxi¯Ó”"Ÿ"c„¿˜gâ`Šjó4hðOr•ˆE‚ª•’ã´AšDK0\ÐS)<™gUùÅ›¾}ûB£@@²4sPÒÁÜ6¨3R‹ò|²ž¥ž¢LéLu«»H««²š›RµX s“L @GŒj…çö;ÇÔ3aSv€çN?0¹%f@IDAT¿º²êñ6æ”^Uõx`æøq'ôêÑû3=xÄ1ý?öûz÷è9a„ï½o@÷ž“Žóø½Ô×Õ~òÔGšÉ³.ç{꿨">뤳æ¼6»¹qçŒÉÓçýñõ][·7eú²‹Ö-[uùÉ36.[½dÞ‚“>¸}Ãæ³Þ¼hÂùM[w¼øÔ3çN:‹tO>üè‡NœËû^zæ¹)'N®ˆDŸýÓ“Ç?¤W¿‡ï½ܨc4šã‡3zàЧf>JqüÈÑOÜ?³Ouýéc&Ä|Ás&NûÇ×üñô“Ï|ùÉg2-íçŸ|Þ+Ï¿߹粉\0ûO;?0yêúÕkÖ,Zzõ)—¬_¾rÑœy3N™±£qÛ’9óÏ›0-Þ¸ë姞vú´p$òÈý^0éÌ®ès3?uòÉœ Ì|àÁÓN˜2²ï ï¸ëÄqÇóó,˜‹#ƒGûÄ3ûöésÒ”)Ýû@ßê.çŸ2õõç_âÉ…œ1õÕ§Ÿg‹gLœ2ÿµ7â-m:ûüÅoÎݲríEÓÏ_:áºÕk>ôÁ 7­\³xöœË?8cgC#¿Yvîôéé–öYϾpÞÓŠí©g{bÚ©§G}§~lÂè1Ì•˜ùÈÉ“§Ù§ßCwß{Ò˜ñÃûzì‡F >þ¸±Ü÷`Ÿún'Ÿ0鉇­UO™8éŧžç˜æ‚igsÊÀ![žGBAb•Ù_ÎVæ6 ñ¼Ñ\KE0nO&VIàñR¸€Å+g3 •L E‰2@E‡Ëa`xµÚA`\¢y—ùA‡Šê ¡"7äo¹åL@h ¯¾I{rŠÔÕäeá-g'Aö2Îx˜h%MÍ1/"ß¹P,I€FÆ4Q»2°spÅꌳãz±¶â”+.<~T÷>=̛DZܰÃæ._‚¨qGšýê¬H,:rä1ËV.ÇUF3rñÂÅ™LšíïÊ5«vîÜ5qâ„Õ+WomØrâ‰ÖoÚÐÔÔ|Ì°áí퉵kWâî–Ý«W®™8fL"žz}Îìã'LäX|ñ¼EãGŒ #/¼ñʈcí^_»pÞ‚=zõîÛ÷ÑŸ0hаƒæÎþS]]íáßyõE¼vüð‘K-)FC‡Ÿ·p>÷¸N=a²%ËZÒñãN?ÉÂÖÝÍgžtÊÒ…Kv¶î?qâ’5+¶mÝvúÄÉ»w¬Û²ñèÑ£[msçÎ;}ÊIÜX°xáÑ#á!Ã×^™uÒ”ÉÜ"˜¿pþÑ#FVVWΚõÚ±CªéÒååùo 2¬>V¹tþ¢îõõ} xeÞÝ{õêß»÷üÙsbþÀ±Ç÷Æâù¾phÜð‘ ,ä>Èè±cç¯Zšh‹vôöM[·4l?yÒ–¶Ýë6l"›H¿9ΈQ£ê{t›=ëõㆠ¯«ª}îÍW0¨žX ¶¾¶Ï‘ƒ^}}V]M݈ƒ–/Z­¬5nì#Ï=Ù¥K×Qƒ‡nX¹–›—G;êeó9¬?é˜c7¯ß¼£µiøqÇ­ÛºyÍŸ.¸ïéü¶æŠh%·Ô‚lxx‘žRÂ…øoÞRæÏÔ²Bhg¥Áñ Îq?œ<µ`pE.ÎÝB`)zfÈ`§!ðø”p©irœ‰ð¾yŸ>}Rï æí Õé˜4Û¶mÇõô‡M¬ViÓ˜^—z·÷ŠH²ÎS¬\1(’$J4×·"É$P´¶Ü,< ŽF=çss67çåYÜg®r9ų$Åæ5 ž{ÚÈš¾]<±LK:Ù°{åì…Ü;TÓ£"åñÆóM«·,}þ¦M›ÀšÚ*žPkvËÂÕ‹–,>2Ü#óbk6¾mOÃ굋^}­O¡‚Ÿ19"\×Þ¸‡usŸy¥>Ö“©OïhÙ¹­yöãÏ{ÇÉúcž°/žÛµbÓ¢ç_cw×=\SSŒ“…ø¶æ¥¯Îá@ñȺ^á¤'ê6­kœûì+I_¡_÷>‘¯!ûv­Þ²cņE+—÷ïÒ;’õFRžöÍ»Ö/Z6köë}«»'òÙî¡ê¶;vlÝ6÷¹?öŠÔUu­?"ZÛºaûË7þðb,é0øÈê|0½%óK^þS~wb±c#ñB”'6í\öÚüÖ{úp­“õ‡…lCÓ†¹Ë¹¯1¬ª4Ùd&±aÇâ—ÞäÊ嘪^ÅÝñš\(³½e ¿2ºrÅѱ¡¶L,åËîh]µrÙ†yËŽ­íËE³þÌžömÛ·Ï~êÅ. _ÿ>}{°ßoËînÙ¼äå7»¦±#‡Ô*­Ümyã/ 9¢>XUí‰ùô¶–U³TUW÷¬îV™ †“ÅtCÓšÙ ÛÉnêhÊL{2ÛÚÖ¼¹hý¶†¾]û¤÷4sýÆCáP”[ AŸóë]¸ã(r9‰O°å¨Š›ááär*#–O‚Gî* ô$ F @UÀ&§ fá¦ÝÃ?Ìo×Ã.÷Vnú¼K୶ߥ ±Ÿt’€ÿÊW¾Â)=†PŸehèª0b d2¦W%ý™™ äê™D ”$jKr°3+B(Ò 9¢—L¬ÜX`tNj¹À£üÄ%År‘î5mÉ8¿É|û~¼|Á"ž&  (¹]÷“ý¸=ÿÔ§>…ì8óµÿø÷£Ž:êÚk¯M´Ç¡AŸ/|á §qú5×\³{ç.0\.~èâ‹>þ™Oüã_´`AM4onzæ´ÿüÖ7oúÜÍÌÆ‚a6«Çóµï|ãg¿þÕwý.ÂCæ¹Üà!C¾õ“Ìœ9óçßÿa,ìü 4üþè׿غyË-ŸúL„'ÔؘxŠœç’éÿ÷…/râ틆ãéä¿Ývë1#Ž¾éúwïØÉs²< ûÉÏÞ<í¸å¦›×¯Zƒq¸SxÙ‡/ÿÔÍ7âc›7gne$ÚÖÞ>ùÔ“¿óýïÝzë­Ï=õ4ÏÖbºÆüü—¿øÝ/ý?ø/æìÎztíö‹Û:ëÕW¿ýï„k«øÝ‘n]ºþò§?kܸù‹_ü"gìÜó‡ñ[ÿõõêXå§nþ´ó˜}·|æs|ÎùúßØдËÙ &Ò½þ† /šñ±O~‚ûvÕ‘Š\SÛy\pÓ—>ó-ŸçQóªhO)7jô¿ýÇ×~øÓÛxè¡î]»¶îÚ3|ðÐÿ¾ýgþþþ;~ø–SÎJ¸ ÷íï~wѼù?þî÷¹p vc5ÕßüîwÐí_ûžäFøüW¾Ä}»›?úñ¶æžÕmO¥¾ð•/3îW_—kKå)¾ÙË+ ÜS :GÃNÂàJtœ„#RS±ü:×¥§¤!Æ߬j¸1wy踶œ¢‡r99ÞKBˆüS-–šrÚ"YëH1bOæqø­h‡ʽú½ëí Oš` Âáã~ä`è?¹[]´WR-¢¡Þ‹KsAG PŠv•#+¬K€7O¼¼ØqÒöy˜0²ülxÞãMf7¯X³dµ›ªx¼½y‚+-[¹x鞆Ŷ´/•øBìZç½1wû†o2Çó=U(˜Åó­_¶:Z ø“yžkoÛÓ²pÎüµËVUðS°-‰ÚHU뮦ó¬Z´<õøÓO2ÇCº«–®XµxEjw[Ôâñ÷Dsûºe«WÍ_šnn÷ç¼<SLçhèÕg^Ì4Å‹©\ˆ»Kyï¦Uë—Ï[Ôº}KV!• å}­ÛvÏyeöŽ þ¬ÇÇVºÐ¶³iåÜÅë–¯ÎÅÓ0F<è¼ö§M«×â™J_áùdvÉÜ…+.CÔ}’­ñeóCÆ;7ô"Äõi2¿nÅšoÎK4µåÚ’0ÒÜÖµ›¼9·iÇîb2‹M Éló¶ÝÐlß܈M"yOêíhض`Îü-ë7‡éH<övoÛ Íº«±I!έûŠ;–Î_¼|Þb Îû³qžÌcptÈ6Ç‹‰lU¨"Õ_¶hÙj”lMÆ8ÿ‹§x¼®iËö…¯ÏI6·ónÏIgã© ËW¯^°lÇæF®zxÎÞ—)ìØÐ@Gèu‡Š2¹¨/¸sCò9 Ö¯ÛÈó<¼$€S¦Ù› ¼D„W˜‡ wx&~¨€‡X΀&\©&°ÉÁÃKN¢ˆsB#<órÀ#D©ÔÎ[ûSŠÐ“ó›–£Gæù¡³ã ü?h1OÔ1>ƒÃ+Á:~`‘¡“hL9 •­Ï e!  VñRÔ,FdâH/%U‘—T‚aŽ¯äWñ²VQ&EÃ@ÞëÏð|§wëÖF±o¼þÆU‹—ó˜XtáŒE‹—¬Zµ&Èa^bÃñ’©ÌÆõ›íIvnô˜¯Ýö§žzz[‚—x“ˆÇ¦*?~ÃÇøùçX¬Š„õ<Š ~Þ'¨`ܹ®Ã3¹eÈ{³ÂCFÇDÆ™9÷€×®AÄ72 'n© #2M 5íx±„wfqzVHÆä½ ÏxgÞƒò9¯|Nqîµ7Œ‡Ò¹Ì”ñãnûÒ-<7’Ï&¹„¯2ò¤y…ÆÏ[8©xØ[Œ0§§ÞÉgýÅ\]—.×]qÅÕ3.®yýãì ¦_wõݻÔç“i^Ÿsz'îXÆ=ÿ™©§LñåQªø‰›nüÐ%Vr¿™×õ|ù`È›`2 cO1Ë»-xD!熼¼®ƒ˜¡ƒüêg?{ô‘ž|]oþÜM§O=ÍËUwž>7,rÎ<¼Ú^äE~rÞLµ·ðåzf–¼SOš|Óg>ѳg7_.3jð‘ÿ}ËÇ3²Œçò)Þ/âUîá#-`‚kÍ°îFyëÍy×Þ_ȆC¾ó.¿ðª¤& ¤RgŸtÒ'o¼¾×¾M¹6ž£ñF oþ=©˜¯)âÉ“'W,I/ïdzÕ×^{é%3ΛM!?ûœÜxõ•ýkëx?ùžy(fCÅ|ï#µ·F¼E^_N{?„ŽØ÷ÓŸúø„Æò<5/}ä£×θìb^Žr®å ¾7/²AöáœÁy¿™wu¹Ûσr<ž#ç¡(€Úî­5÷Ãß àêZ`r-ø8¡èq]´ J2xÉ¡12UÉc!Æ©¢97í8=¼+½µy‡­nzå^zé%`õ–ž£±È@Â(27c,(ITQŒŠ¥Ê·ŽX„Tî&L^– dá¶cF®Ã94Éܱ”¿ð ÎY³f}þK_ìÙ¯ïw±³Kã)t>æ—l‹³Îð*.4ÙBžVy8< ó"ïÕÆêë®ýè 8GýŸ¸é“õuõ6A¨yýá Øq—ï¥QöD<Ñ@-·Áoºé&–#Þ¸`wÇQ(Â.çàA ÞláH‰UÓ)–@çT™­6—®Hè;lÈ—¿úo·þç¿_tÅegOŸÎË&%7£·66VUsQ“Ų(ÀŠ …y™âé¯<òj wÎ:çð?ÿÑퟻå–a£Fâª|uÍQæ8$ãdç’ÍSL&’¼‰Œ9s"¡0gN<.Žy€ôÆoä™yg9-ÔÂÆgàÑðÄ SCv~¤ùúÞà|8 _¸æ†ëºÑÃ1‘ßyè%‘Lòô$‡0ì”éK"ËÛxÎKâ}ŒÓÚÜÌŽÏþóßüú7N:é¤óÎ;»!–‘%AŒ(ZáÔ m}$S‹Ñ,aÁÐRr„!'A&€Üè×D,ÀwW¹ñL h+£±e¾á†ðB Œ›ìÝÀAºM¾uëVž½Cô¦ÿ%kï½WRƱj•:K“"\nIpUÁ(ª$ÇCV&ƒ‚ÁSÈa¬­­Åÿ$‡gæðN¢š ä|~É’%=û÷ÅY2Yb«¾G•óÀf—ŠªöæâÇ TWÖøá~Gø‡ü͉öÚººŠêÊ~ƒîÞ½»¶®J“K¤²"ª°‡’ød­æ5u¶§ø­3¨$C¿~ýx ‘T_ï°só‚¦agâ}¶x[;¯ßr™Ú툮`è9ïðq0—Ïg˜Mú5¤æˆ®CFŽà0—öd"Z«Kw%ŽW™Œh1XÅêi UEØwäX=ý…!G¯îÞ!žhˆÀbFˆUUV×óe^hreÄ[´ŒÂ]êyp•[ÜØŠ›‘X9Ä-Êíƒ ¼œTc.Ð:Øoç]^&çÃÇÉ”¿¦š8d*À&Ì›uݺö8ÝêŽè¶'ÑF´Ò³R·šjZä•Y^Ëi‹ÇÈs hîX,žÀ˜)ª ú÷ïIïÞ½ùSÎt†…1#M íѧ!Š$\Ør´ž˜$b‡¡ä™ÀÈA1G·}¢T‹’`Ë¡12JG;<¥„XÆ ÷{ñÅ/¹äºiBÞ=pd¡$z =»z®@4¿bðXÙqÓ}¡k6½Õgë¨n»«Ô„Ì-É’©¼C ¥I£VŒÖœ\GÄ´Úô£4i¼8„~Eïšk®Áo04dœÍñ^ê Ï=Ï›¤wß}7Op€gßÅ7Ìø€o×.uŸùÜg*âõkÖÞsßï/¾øâÊê*¶ñœÒbsK3O(ñÈÚ ×]@(·ÞúµÛš6¶öê×÷_?÷^:‰¡^xá¶sW]u]`ÔYé¿^Œ’¬¢8+W«sçÎÿþ÷¿¿»¡áüiS¯¿þzypeEÅC=ôò¬WO=í4¶ÌPÎ×A<ÞEË—Í|dæ¿ÿ÷u´NÐÎ|ðþ;ïø5ML?ÿ¼¹ìR.¶™VzèaæF7šÝ W<¼H¼½øÇ—×mXÏGÍõz™ï¸ãŽgžz*ZQñ‘ë®åmš"q›%?üá³h£¶Vu4ç†!÷³ŸýŒÉóòêØ÷ü ç/âqàÏ}áóýzõ˜áXµfõ/ïøÕW\©¨ÀnèÃV„ö`ð³Î:ë†?Ê#¿­Y³†umM%†Žqíõ\ê÷¤¡H(´pþ‚ßßߥ—^Ê]܃¹†‘E%ÞäùØÇ>Æ“ ±'÷}ç;ßA[…&˜k4È+èHrSÜç\v*bGÏ’!ß`±w” h¨`¹»išS£ +cÊž«ºÅ¾Kø¯¾ž·ö¬ÂàOO?ý4'¡+HT0Ä–D_V4±V `4ÅX*Zí~L‰bÝÕÕáVu¨®®^µ¢´¼ì…—”«„ g‘Ì5îgŸ}º¨¨`Æu¥å%•åÆúÝSw ö: ²NŸ? ]R4JWŒ2GAöžýï¿·o/8§ÔTÞyçgêw¼³K±f¥ÓÂm­o¼ùÆ}÷ÝS[[[VZV9¹âÄÙ“;÷¾ãK†1 ôÞ¾ž8^X˜_VR6­nÚÝwß¹ëš9³H²‘á>ð®÷Þ=yö̾°eòäròN*-Þ{àƒw?|/¤Q7wíhio©¬Du°zÅŠëׯ§'y¿€n‡F™cYôáscdÎœ9,¼‹‹‹9Ó9ÛTÏõ¡Q÷ØÖgŸÒ›õ%e“¨ÿŠ×TWW>÷Ü3Àc¡ìôÀs/<_S;…¤ººÚʪ Võ¯ïxcØ=Ê‘éÙ–†>úÀb5͘Z[[S½rå &ãíÛ_•ýÄ0::ºsçÎÕ«W/Y²„~«ªªbiÃq’¬ïèXÆÆYhæS‰D„¢Òy^ˆY¥p¡7"q„U§f' E@€ô$5F0²@¥Dò¹oß>F:Z4!ãÿÍçç>«›P?µì¶¶6Æ`*'Œ$5¦ÒtÚ6˜x&©¨0‰`µ8âÈ…#œŽ R®¤âKªPdx‚á ð«€Nœ8;ᘋ`?ø5s‹+†çØ8ó!—®¯³µþùÿxs×NK^—·M·ÜΛ7wn† /¦éµuX‰8tààðà ßçkok«¨(¿qÓ üŠ,A»ûû~ôÏÿ»±µ õ’`"âÈÍênlknn†4!G‘#YLsÑŸjœ?~Ñ¢Eè·PgÈÊâ‡ÿò]}ÝØáÆcYy¹'OœDeñÂ…¨wÚmöé3g>r„ôsgÏV–U|°û½»ï»·²|2âC–¡»÷ìþÅ/ x¸åfÍÎÀÆñ#çfeWO®àL1+;§º¦zû«Û¸ƒÁÒ¬ÌLJ¿ÿ¾ûKŠ‹¹<ßï¶>ñ⫯ ÄÉvN^îÀPÿÉÓ'§VNaÌ¢nL§ôöÞ½{¡!SM÷Üsó< 3ÿìg?C¥T_ààÀÀžaïèêjni™1sÍäô´ºªÚér?v¼·§Çår÷t÷ ½ýú ªqM§£«ó_þýßê[. „8„¾:wúÌèÀÐôiӹݓ™UZVÖÖÚÖ×××ÒÒJW3¥³vãŠR«Ÿþô§ŒGü¦ì &yhŒµ>8"ÅO@fPúŸp Pñ À$†0.`xÂtYèà“K2I*NÁxqPPÄ“‘¹‡î]¹re ðÿ÷¹y>½Š„¥ø\ `ž§‹¥…O³æÒÊJI¿¨`Ò$áÔ,‚J-KâÕ,ÒGø”K$qFXÅ#aê Âcdó™Nž<ÉøÞÞ^| ýGªÑÛÙ¹aí:t$P(èïö¹ç^ÿÃö¸A[>£–s¡Ie¥~·»¥­µþ|mUuo/„h·X›Ï_8xààèðHNVöÌÓѦdÆîêëù¯Gþñ™:›ir]M -(/‰yàp»wJÁ±7†7 PžôcŽbþgTBV‚Q÷Lç…¢²ÒÂÉeŠz€Ã:0ØßÕÖpÁn¶ Œ;ȺÞض )ã™cÇ7®º&éëê8vøÈ¿þû¿ »Ç³+KÙ [s³Øù;Ï91)7? ö úýKB»í•W¹Žv¾±ñú CÁ`wG‡Ûå~íן~þÙA×·€Ívkf^6÷ñzú.œ¬‡«é.È*žÄŠ+{ê ×±e ?Ùñ±¼çwøŠfW³ïPú-àoko=ßØPUYÝÛÕM3ìö3§Î4Ö7Œ ÛÌ–¹³ç õõwbddäÇ?ùÉñÓ§°RVS‰ÑËâ¢b×ðhO{'[žž¾ÞÁ‘aNaw¼ùæààP{{û¬Y³èOªÔÑÑÑÐÐÀVHν`xØžǯç*Ù@x\*NˆxIUIT*I’ÀÏ'N8xáyÉ(I@ Zõ“Tà$;CE³EbíÉ’S-åÿ2ð'柋* O²‰=vì5“ 6êÕ—Rh É8ééYàù%Y£#È%Eð)‚–,Ä#Øøä'¤HH  úà$©À ÿSœŒ÷K—.eUIÑŒp8böìÚ5sö,Ë9Çü*–Ú»»´6³©(grm ìä5bÙfÛ¹ó6;*%V[g¼Ê®ž sJÝ…¶ô:¬»ž:eøUNq>†h Mc´‘u/d*£Lò0 Ó,õdUÌB—ÚâÓÃcú€5Ó‘[X˜“›ÛÑÞöø¢®ÀŒêÚS¦"ÉGyH–-÷ß}϶^®2%æ0s0‡Ä|dhøàéuÙv¯]_9£. Žvö:|±ø¨gùâeÈظrꜿpáö{ïzöÅPƒ Ø•ÔjZ»;›»;èúggN®¬ôz<ýÝÝÑ@(7fe‘"ÔÉèɘE+æÍ›ÇB©®®Ž0¿‚q4†0†3_…mÊäªî¶Î Ûså:2çL›Å•D~Xd wñ?CÀäò œ²io¸pÞé÷FÍú‚²’¢IŽ-í±qoÈé™T\ÌÆj: ³<ÍMM+W­9{ö,…R¥ƒ&Ðo„)‚_œþa5G•ð¡=2*E_ä[~ ²ƒOY„ I"^|dG^>Å©x@Šò)d †ˆ œ Q!!Ÿ`§Ð$h‰’H2>õÔS¨¤Jûàý92<ªÅ¯+Õ¢®TôðáÃ7‹4*J«ðI•VáK#¥m´€t4ñô |ªm&ä$‡ñ‚M|éàù$,©|O­ø ‰ÄñIRz÷Hvb@+¿18>áp~ x~ô£!L&;TÂ^”Í'SÓêk®¹íŽ;`oå$,žØþ‡?<úëÇ<1E@ÝÙÞQQRšðc~÷õ7~ço¾É‹¾Éøððöo¢ZßÙݵiÓ¦5ëÖ Êæp‹ ê·O?þäóÏZ—çä°TZ2Öâ¤ß¾˜rÒ===hÝïß¿Ÿ”Í0ûd ´Ž… "¨7ö¿—™J ³zEiÙé¾ã3k¦þÍW¿~í5Ë1?Éiã²t„zӛ笼Úa±éÃôöÿþßþéã¦úÊiuœlqàV˜—ïíš?gÎw¿ówÕÕÕ_c¸îäÞý/F^ag¾`Þ|,á^lÌ!ÒßwðÀÏýß Íµ“Júûú°K•ãÈ F¨7 8û òÌHT›õÑØásЈˆ„‘ˆ‹ÕLõôö¤Â"æᢼ‚žq—4ð+÷?„†#-ÚýönÎùøíV­ZµqýÆMÅÜm2‰„ïÅ×_säd#‰dꮘ4©u`”ëÌ÷Þu÷M·ÜÌí#JêíkÇ6ÀÀpdÈfž J`‹ñoÿöoT ´T†: Pd… `'bøÅS´ðG¢å`â!0àˆrJ&F`$ &QŸd$@ªh:"Uœ„Å ƒ=MRCjK?²µ,2VÙðbîÏú÷s¯í)Oš!‹´™¡”0ÅRé/&^MRë%1@JïI –í!L*‘Âá)Ÿx Þ”lÄò~?ÉB<1’*¾úɸ@? cÃí„éb„d\ ‚áeò‡á!”7²ª¼óŽ;ÞÚµ3¯ ¿° ýŽ™3gvêì™îž˜p|hÓð·Ü°åûßý_ˆž4zDúco½½«¤´´ ˜û±¥UÕÕ§N,+/ÏÊÌ‚ç¯^²+‘õ õ½=½˜Ät9+2 Øô~éK_’õ‹|l/_¾œŸÂ¥nL•••Œ Ô½}kGKÓù&ªçæâîèxMEåw¿ñ­u«¯ã>8-=uòÔá£G6oÙ|î\ý7¾úµsõõc^7ò9Äày¹3¦×5wµ74]@âÀú9î ΞR÷ßûáô9s´&#ž°<Óv¡ùÖÛoCÚÿ×_ûê¾ýû™ª*ÊË8T`—‘_PÐ;Ð×P_©NŠ{}«®Yñ÷ßù>‹ªGoìÙ³‡ ¯Y³†]( Ï1IÈGø59¶`\`ÒÐÓ‚QnϘӬ3ܲyË·¾þ7œ÷¡GWïÚ¹³¼brn^V1yòñ“'*+'M*‚/YÌM¡ãgNŽ0ír;°87ÿË<ȯÍÁ!­ímïìÜÅH166~ë­·2ú°â¨ªª‚½MÍòÙÔÔyÐÏ, jE˜N#—"¨?’®E‹ãH•Š„¨$F2ª1BIXÈ’TŠÃ Zɨf` CS+` Qú–^eE ì ñÀS7 «¨>KàÏáy “ªK€þåR 9>©ŽNŠ'°ð-1j<‘| ¼dáSeo€«y¥P‰—$› ¢q„qéI#¾” N~oºFb6ûÁ~@‡Ò× ÿLSlGzè!–—Ì™wÜõEþíwßÉÉÎÆ,×0ë¦MÏÏÉ9wæ,Fpì&Ë­[núÇïÿÖ2z;Ç_yýudÜ+׬æ)È·Ýq; Æ$õäæaa}ÁÜùhÏ4ŸoŠ‚…9y}ñ>žß•š3²Fbo£Ä,Ç<Ï Ÿ),Ç…»vÙ2ÌNœ¯oÀòæ”òªï~ó;ëV®VH#©9rèÐÁ#GÖmX¹«½¼¿bÕÊ…Ë–>~ •=lutw:s:';‹ì&³ %NàÏ7žG€R”—ÿÕ‡¾r×_„†ÀÑËßÿ`ù5Ëé·}û°ªg§yêÔ)„£ìŒ˜öq|ðã2€2·Co ¡¤ÖÞ*9A0┾¼è„áU  –§g‘ŒŸ`IA‚¢¢ ’ 6~P …¦£Rs «©2I ˆ¬+YŠJ‰øÂíÀ¤#ùŒáϽ¶—b¨:-¡ê|r,ÏìDÛ¤–T‘²¥ÓØåjÀ@^‰áSÅCX ñ¯Æ yé JL‡H|‰e•©IâQxÔ@*3 mâi³¹nú4”ÃXs~|è03³VîËó‹°èBr~Fö³Ï?›Œ)[G0”WU­¼n ‹M4d8aËuk×R±½{öP1 ±D¡#+àòd•ÝGƒäUÐ Ë–-c­6ÀÍ7ßÌ)÷+¯¼Óͽ ³Ý®SÎÀ ³sƒÃ[Ÿ|²"NcŠ+¯¨`èaÈôGÕYYœZ“÷Égž9;DZ”k¶gëáe‘#÷$÷E9€†3BÝ}÷ÝÌpýd‡Y pröú¶W›Z[è=„טÓ+ÊÉkö×gdgS]Ûß Åíú“†°ç”þ§9“`ðbÈ£·÷h¸+9Â@‡ÑüôïŸÀNYH‚±¹’̾œCËS¶7nÙÌ)Ý>ÑYŒC™ÊXs¶Íÿîñߣn@!/dWO×!q”Ñ“Ö!÷B-EPªD}H¢Â¬Gè Œ˜t*’Oài¯"þ`Ò©BZj€T5‹št9<é¹-µ˜J’„£žŒk ©¨6Ò >‰¤Qéuø\áÏÍó‚]ZBÍ(›´ˆP„HŸ°Z5R! Àô¯üj ðÛ°@NÏ>!L*õÁ‘1½è `ÒYt(ã#3kÕšµõ_f.ÅX(ÌÎt踕—ˆúpß»»Þæ8|t|ŒŒ¿bkN^>Öò‘VRI>Œ å¥e -Á‚½AÅPI¢ž9ö,{õ¥W¹¦¢H7u:ö;èÏ°z§íB”¨#âž¼pšÂcº¤UkŒù#üÇ/è!€éüå×^ûÀƒ1¦˜±BˆX!E¬høÿþþwïyûȾä·ã2F_{Ï£ÿ’9ªC/ð¯ÿò¯6¬ÛÈÅC¤$àd1OÑüÄÌöt)ËéIz €Ì”K‹ãSU0ÒóLX@âùT L ©ò‰/xÂ꧊0‰T¦¨?¯?¹ø„ÕYîÑ“h(,5'ÀoACÒ³–ðç^PðR'|ªÎ˜¼Z’4Lm°üH’J¤>¥[ HF ’˜ ý¢f¿4I  näM‡XàUl“›$BÇA%ôTÑ0€„­ m±LE[l¨©£Ü1±ø„ÚP¹ ùüˆÓ¨4Ùmhò*Ö5YÿhZZšYmrJÏ ?/+P%2”0# #‹"´Ê3mŠN8¿(,JJ’ê!ˆb=ÏÆžî"VúSyΑ¦òHŒ^1à›²ÿÉûÊ´€š*ÏjŒÏ>õ4G‹Y\>”È朢ÆËà‚)úŒ˜ýà’Ž$*@As¿˜c×ñÑÑgž|ŠK©ÈHà dî¥nìV+¥Ãü ð gêžM=ÉÈ‚ê’s–NìBém²ã+­N]J±›¹M¨<®•ËF‰x~EŸÞ#/héȡÇ:~ä(7áxã‚šSC*Ý˃V­>ÈE®8(¯ÞŒŽ“‹žM>jüüdœh"•5‘ÔSœ€ ä¤4ÿ‚$Fœ¤^üRèÇ'ñj<é¨XÀ.ÍHµµ­­®ãGGFÃH$l/¿2EPêF€ž$Lo&Fâ QaÕ‘ze¤WÂøÿ#eªY.–©üåj$»ÄK é: wˆ¡]t8W®Ø§¦~nžZ 5#Ì#[Leò»J@m¹Ô8½SÒëÚÆ`F.`ði ‰‘H|œšQŠÏ a°Q"NŸ O)0~u|:N¶vÄóÉ<íW¿úÕÞ½{¥O½.WkSsvf&/I½`Ÿ-+µVÂ\Ææ®xò¡ŠÏ½öSÐ-)}øç¿8WbEK•8fžêʪ¦¦æÎŽJ¡>„c)Ëü£\âN-8a äL4Š9ä#$&À̉æ,§¡h˜@ÜŒ;̧\a…i&KUZ}íʆ“§ŸøÝïYM0ÝÂá–ö6~åå{v¿ÇK[Ü°Á*×yåŠå5d˜?#¡¿àÒ«—"H{ùµW°¢Ç)ƒ/ØØÐhµXx*ï½½{XHðp©I>ˆ®¾@Ò•,Ø°Œ‡ÏÑ&¢ß¨ãgòÄ#eWBUiÍgäöC$Ö àdo™|~AÞ£>Útþ"=¬’ w¶wL©¬nlºÐÑÙ©Ø81™3ÌV³NÏ5zA£ò.fí"QŽy&ýÈ®î. ¢ëà õ>Ysˆ@oS:?4Ã(‚Yš@85þ~2'«F¯¦ª§ø’”ê-Ð\É#e‘EÂBÛà¡P|"q _p¥â>¡ 2BÄð[SrI×COÂðÊéiÊ‘„RÜ•êtIÚ'ÃÒ%ñWŠ.‚1•s&æyÙ)©í$ #‚Z9i°ÔOø\õ†Døh›t 4$Í&0"HœÔŒ.°C<‘t1…å“ž*1üÀ ÉÔÍÔâf-–ê¸ãñž!s :y¨ß03#yy»2æœ}TÓ8™Sî±Fã0ï.ʨLïÄ3ȹèe#hWk7kx>¦««™»ºzºPþÂÞF,a¼hüÊk­Iæ{]ðZ\mEÒÿ“-ç³³s"@®%#¥݄vÆœÙÝ=cž1ÊÁ±•¡spÅ+Þo‡àž¼Ÿ6¥Îï ·uucû•Ç!ã1³ [튂`[L˜äÅH®Ü2Kêµ¼ãñD<Ô)»3f·^h úÙ(0ó³ÀôÝÅyeť͚â*jŽk«¦tFƜãÜÝ¥Ûƒ\vÆô¯Î±ƒÃÄY’·ê ‰p´º¬‚‘«ñ¸ƒŒƒÜ2bT7u:J»È_•QÃ$ØP: "1sÜHó‘¼òÀ.¿NèGˆŸá€¦ )’ i™P!Õ0tˆP&P ¤¨l SxÒQ#$M^øãˆN‘‚TTÀÌmݺuÈMÀ©ô|Z}Ô:|–Àçæyj^©4Š?üáå“«IÄЩ¨TNZ"a• ¹dЃÊóÀ“*#ð8ÀÄIq¤òIX|8"Už—²$R|R °å—¶pé:é’Ælûs–Ü™L‚H¤˜¢ æsLlqpy3f´Œ®³¿—•CÕ¤²$W¸S‹ˆÞáAäx§AvH´YÉõ{Ʊh™½€;³ÚD±¹O§u»ý¥ö½d^7ZÍ<}56î®.,3A"5CIk|4ÃjÎâ:ÞšNh¢™æ†Ö–Š¢bkB€=Žêsm½™®¾*†ë,&[$œgC_X”ɉH8€©‘á1½ÞT\PÊ0©¼÷lJ8=NÌïeçbá¶õI^•â” *Ì/P&p½b¥wpÈb³¢A¤áæ³/ÜÛݯP7ÔPÄÇê¯CBýƒ“£ÿ ñ¤1 üY€Š%LU¢7˜Ì f– ‚¼ŒTTǧÂñ—áyRÁL^|`X‹1Õó)3¢Jç€}F÷¹÷óô…QQz‰=+d·¨AzyÒ b¤§Ò“$L¼ C@áéWri1.‡AÅ)*6â ‹#œžH>y#™÷Û¹415Ìž#þëVr¶~î5°3LÝÞá_½ø4—çï¼v“)… ½ú?þì‡6Ý¢‹Ä­¦Œ¡¤û7¯>Ïøò•›ï²*{x~6Óow<7àÿÁÍe;°›j’ÏÜsä؉øò·Ê2²uñ0"ã×~tøð›n[25uYº7»[ßþÃŽ›7]¿²f~¯§õ'\½¿yþéÕ×\»yÞj;ÏNë çüƒ¿|ò·Ë®š·éÚõ™ÜrךúÂÞg_z¹ ?ÿÞnÕ½«Å©‰ÿ~ÛsÁ@ä/ïùr±ÎDyÀ¨}n÷+Ýí½}ÿ—ÊÍYqðc, (bƒ)¢Y³ÆQ^ÓUœP”„U_%³ÏPI‘ì„¡^aK¡í+`w’€Þ4qh'Ë{"ÿ †WP©­½r‘RarŽ@n»í6rdYÚ¦‚ñ)m–˜ ó¼ôIdÁ1zÉ‚œ,ddPd(¡>%âq‚-ÕEkN*ñ b|¥w<¡+ )©Cà‚šH^yÉþýŸGÝÎd,zÊMÇÚNðÎiV©b™$îõ­^¼Â=:öÑLJ‹ëª!ÿȦµFÜãGÏž²+–œ=}<ÃÈ…¸}‡rÓŽ™-Þ3>³nê´ÒÉÛ÷îŒådæ—ôœi]8kÖÌò);Ž¾Ó•”ûÆÊsò®™6ÿÉZ“Qæ¥ñÁá2{ÖúY‹Ï5ÖŸh/ª™Œ¢f«o[²±¾»q_óÙêS}Ã#<õÅzÆF>8s²¬²&äñøFG7¯^ÃÃï;~˜[RÆäíî½nþRx`Ûþ]¶‚,›ÅÞÛÒILMAõ¶oãeÚLJFæ”UO¯¬Û{úPˆ÷˜3¬>§»ÐìX1ûêýÍ»úúKª*ÜÃc“ öó—ºp¢{t(sR†:ÌÁئ«×5 ´8w®ª®Ë–׎ù}»÷íË-ŸÄ®'>æZ¾x)¯JqW×^šÏ¯‰©ÿUK–—äíÞýž/ßZ˜ÝßÖ¼dÖü©“¦ì|ç°%i˲´wÕUÔÌ›>wϾG´ž‚ÒICÝÃÙù_˜wõþÓ'›<ÙÅÅQ'+‘ ËW¡/p¶½™Ç'@ܾë¯[Û30p¸þ$WõÁˆgdlóêuŠ^à‘X.A0é[·àj|T†"‘Û4¶¼í‹Á²ˆb(MÚURQˆ$%'‡h™Ø C•Þˆ0BŠªOŒ«Ð*´ÁFÖ@Ö Âðd„\ÉB¼€ 6HèIÂUUU›O’K-ýsþœlôõC³1 Uá“z_Z*õ#RúHM•HõSdOGBÉ%Ýw)’ ÙÓ?Á“ŒNO%l cNË.Σ¡l«uýŒ…‚Ûûºš#}í£}C#ƒëjçg…õηù‡†:‡#Kk¦MÎÊmé9=ÖÙåîêêXP^=-·¨·¿§y¸»¡·íB[SUnÁŠ)3œ½ç½ƒÇí½žÑ"£uQI­+è:Ùßr"ÔÙ8Ð193uå\ŸÇ}¾¿ël°«Á3h÷G¯›¼8Š´ôõœ÷ŸìâöÈÚÊE¾µ¿ï°·­Þ5p¹—•Ìâ:Ê@ÿPÃXgÛ`7¯ÇÍ.¯¬)šÔ××{f°½ÑÕ×?Ø?krÕÌ’ÉŸoíout´¶ÔO«®uŽÖvœkF_8ÏîXU;¼wàd_[sdY—ÆÜT³,<èl㥗èð…æN“Æt]åR“'ÞÐÑÙäìÝP³"Wkohï<åìëtŽŽ»D"”ƒ?x®ð ’]%9áb.%ESËœ|JŒÔ°Z¢ðñÑŽ9ò¹ê¦"ù¤¬?#3Y`Ñ|¶—• ÑÈtT„©CƒŒF2^ Ij€0yS=#ŸÌ± id!U0@$Ÿ8êÍ'NÂø„‰”Oà¥J "ž‚p Y̾Ænö[t<¾Â¦zJEå›/¿Ô$½[_{ •˜õ³®ÉbPÐ$z4Þß¿òܔҊۮ¹ ÊAMlDÿÍë[ÙçiÓ™Î5ÚQMðå=Û±Övûæ›Ê4Y¨G´`cãÄûmM‰ M@IDATÞzg¦È Ñ»4š=><úá_Ü÷ÀtJ¬‰ˆÆxª§áÍwÿpÃn¼&çN¬éÏ 4þá­ׯZ³¦vaT kL¡¡ß=¿uù²«¯›¾È¡1³+qÅÕ´’DXØÔšPø»ý'FO9%ãùTÏàøÏ~úŸì؃ÎÖž®‘3-]µÇs¬vÎExe½¾éü`vÎÐáF[4™——ßtu6Ö÷é 7öñî uÂíé¦Æ@"étðª9v$s3O4ž¹¹£š1™ŠÅÕ¾ñ‘ÖþÖW\‘ܘɡG{ÔÄ[Ñݽí y:2 P_åìhØéjkoÚÙ=r¾p6ðƒ1E ÞyòcmÇP{ÉAšƒñV¬eŸk9ÙqüÜàéŽd€7u51£öx÷9L?G»s°Êç‰ – mc.§¹wT«Á ~=Ç–þîÁám#Až¶å’œ/íxº;»¶v9+²ò¹/ŠGG"þ¶†s¯ö&'b6AlÑO×7¸Ú{OÀ»ôü>!–ózKÎõ«ç5YÎû]‰XÙ³9ÙΣ¶ˆ' ‡"žžáþŠ²õí™zk( è4ݽQwçPpŸÑ2îw%¬ºnžÔt½2Àú·3\FÃ𸳩©õõÿál;rÉ*z¡Ð¹¶SI§ïdnIÌãg߆q¾Æ“Çã†öŸ…çMG‹¡õÜ©“M¾c-ÚpŒãDo$|®³97/ÿ©Îanìr'Z:ßÞ‚n2|˜"Ú§Ã8Ð suhÿä|â¡«q>•Ø®)yñ!3•‡ùTÝò } ‰Š¯ÆH.>¡gæE†.A ƒP]]}e¾¸\qŸÌ–—K¾4žî $Nbÿõ_ÿ•„홈¡a,aÀ¤–Ĥ 1Ò~`xÉŸ‰“DÙ<# N)´Ò}À«y%—|VËUñ•T@òªÜ*5ZmîXi°b}S¶~F,é‘Êj4¬]µzþÜyhÅpÉ=û™SËÊ¿ó­¿ÛúÜSŸ8nÏVÌ6ˆÛýyI æñtÂÊ‹Qž–IfN.ÒVçù<^Cç˜Î‹ê Q«>dçùšH¶3’çŒC¯D}6Ž°PxIè#~,ÕY‘¤‡ƒØÏFÝœµ=ÁšEïŽùl=mf2À¤.hQâÜ-ªE/-bÔóôaMÜáä–dTËI§¡ ö³ã™ B™ÓxëyQ#¢ yì±D‰™ ƒ?ÂA#,ÁcÞxÄæ°S3gУÍ2MÚ0k/»5ðó „Ñц¨™åEÀå±Íw¹w¬7¢žôûuÞÑã /‘a ¢ºLlL'yÇN›À€OfØåÏå.£Û‡•o,…Fíɘ [àTTÏû!—ׂ júÅh…«cú0B¦ƒÑx4Kc¦iCn{DÇ Óµê3l[ô˜ÝÈãÓ_¸ã¶y+–þâ»û3-vPzƒ¡ÒšŠ¿ýÖwž{áÙóç1ÁÏu˜üGs‰aš—¶mZöÆ•ÎÐXâÂ¥8úŠÅñ)„$¤›N´V}æÎä8 ŸŒPzIÂéYÈ•ú¡•“â™çpD’—OAH’‰À€M­o~ó›£bûŒËÎóF¯¢–ö#ùäš$© ¢j-ÕJPÛ Àƒ‡0¹àˆ¡Gø„Q¶K#R%‰6§7‰ìâ¤nø8bRø”~d!†Oã”xVP°:F° 䘘ÙÊÝød‚ƒalØçزîºã.æÃÇŲ@29uúŒÿïÿafÝ ´J3-?¶Z§Ñ ÃÄU–¹xÕ,c–#ÚÔÝu¦17f±ØM·û>÷©ˆß•´›+ÏŠTe°‹N¸p%̳›“¦,ãô¥ótù6Wû ÷h«9‚Æ€–[˜wxœNQcGyì¾—e×,˜c0Úx…%¯»B½GƒCžl³…#úì¹S2J 2ü‰¦yX2näwCg&IfÚŒ9™y_˜Á‰T÷Uyð>ë8|ƈqRo×ZµÖ`Q~3º]‹Ú‚ŽÒr,`Õ õ“¯^vØÑ_à0ËŠ>ïukP Óiu…Å3«Ã{Œã….ì>xJÛ4Î^^}¬tÞÃô"¿‘Êè­ £-jNŒùº?>$ÙtÅKjM•“Æás“Å Žœmf’Óký!³!È7,ª³ä3üZGL;t´ÞÝÂË”e´!àuhQ¢Þšì¬Ü¬Œì[7Üh ižxüwƒ}ƒVƒ¹|rù?þèfÍ™ûîovhM14üÑ»`ÙÌH¥<¬õ¡hVTžô1ÆÜ?R!ˆD¨ˆT!0!¡"¥È?ÝZª1P)ð|*t–¢4²€PR¤ N‰Ç—ìC.‰‘ –OÉÅA$âIT›Ù\£ž(ð•û³éÞ+lð©Nê ûQ•PG)>Q,CöÃ0‹JU`°K‘H¤ÇKƒ%<’„Oé­ÆÐ)’W°©aÀÔ,j’äRa$^"ñÍvÅ6ß¹¿ÍyÿD‹3éŠÂ:DOÀ`¾ùæ[ÿú/¿ZW8{Æìü¯ïÍ™7ŸÙ’T‡É°fÀEØiæY0Ä›ÆÚâlo†!·ZM~îdzTFð˳ LáˆqÊ—̱Dóí¶²Â„Í„)™mµL+÷Vdº³´Á ƒê6°#QLËbµE8Ê{²ú,»¹,/šcæ5(8%sà‰;Ì(‘#a7ks>‹6d`ÑŠþ­T¼<£”®ÑöÚâ‘B[Px¢6sM±6ÓÂg䢎2ñh8°T4‹`Ðí£7´KŽÃPž+°èÌz¿ß;êwi³,†Â,C¾ƒ_…_"ÂSymžÅ™ôóðb ÌJ ‘,´i2M!^Ã@C<ÓÈÖû2µÔ*ÁN¤ŒôÊ3Õÿø)H¡Ǡŀ"¨ˆ¡1Ò5‚J Ó ¨þ˜xBƒÂºM§N`cÇÓq/«Å¢Ä,,¹áØpDQn¿õöÛÛ::¹p¶rÙr~R† —×Ç 8ê±›MŠ:—Å5臅ƒŽŒÜ¦ãƒ!»#6FóXÈŒè5&gÔTQˆ % ™“ ÊæڻݧCã^{E¡öªª>[¬‚­Fg‹ë¬Q]ÄÈ%YðD :òzm†1§v’qV9²±¡S ¡n§wnNѼEÅ3ku±d¼¡'†9 GÿD«üÑ°=Ü«3óÖF ý_E†[ü¿5;«°®ÊïŒxܼÓȨÀï¤üg=ÒaBÆ% M: L3˸Äã?ÜŒCWdÓ/Îœ:oΰ±Ó3ÞÉF]Ù1Úzƒ¼êé8ã´Våg®žQ6sjÜkkêñòÚL’ë ƨÓ=z´Á:ÎIf±Ž×*¯šœ•e³jaÓ¡–ÎуÍ&{Ʋé5% cvÃØa- Âœü™•íñžhöwE2%KP¨e–ç'ã¹-*ÎPÅE¥p%©8OÙÓôM7n9×p¾¶¤råºuîXˆwªÐ`_`ÏøKõŠN$À 9Š!-º ªš@·B6ЛJN*E ! Á–Œ€Œ“T|8…&•S&„ªÅ'  àKF àËÔ k üŠ'®SðÂHgÕ eÉçeyžfP†`! †YW ÃÌ OmØW ’ú©Hä¥d€¨·TOêMä# 2”"½y)*Á Æ‚÷âRÕ$U4Æc,aÞQÒë1¡‚:§ÍjÙpÝZÎÀï ±lÁq¶Üëð죔‹MŠÌúØÇÇçÎ[[]£˜^g 8|åQ›¢—ÆDŽCh›%=±Ñ¶ÞÑÆd‡“Éž~„™ôXªõG.cÌiäÅ%ö¬^+×ðìÚ¨/ÎsKtj¨<ØȲê`ûÁ¥ìÌ»¹—8LDyôÖѸ¹ègÒFxö º7VîÿPEH$5C€îeÕŠO—rækŽÄÆû‡;/TÔÕfN-Ó15`'OÙÒ05qi)t‹ FËõ:C¶>Ñú¢Ù~~<ê=ß;¢ë øɈîctÝYÙCêEA’=.ÀÆÑÌe˜ úfîñJœ–“‹'f÷$3˜Ç>hQ Oº,3íì&,ZÓ¤¸ÕèŠ.ôG\A7‹˜˜ÅdaùdÄηÑÉ¥¯mŇÎ6k2,ãÃcœ¦°@C²nãFœŠ…Âx‚'蛚ZfMŸåsIo3£aÉeûƒ‡M1!›@!ìG†’`¦J,¡°²›JMjŸP $#´$¾PJ<’ª~ ]É/¬trÊAB­øj‚0=/1ª“¼’*a5‰€O)|2±±G^ÏóÞ·¿‰¤D| ’á+¸Ëòf´T샚,½œ}‘âIº’GXãj  h³=…Ë–žå¯Ak GQ†GI1‘Ä<Ƥú†[x]݈Î{Ä1q5=ö7ôäB£‘( Ë°:]JõlBqcLoåñLnа]Š)Ob&­–0Ïä˜-¨à3©;Í ÅͬiÓæjÑœPTtíüzÜ$PÞÞFãÏd¬Aç—«À…c¥yù¨å¬º~#û_ØßÖܲcÇèÈEKó˜Ÿ{fÃïí=züØ÷ÝSYYÉEŽ ßÿÖ›;šëëû¸ À¥“Qy¹›˜#PɆ€êè8(E>…§“ŸÄ&zÝ •xˆ_Í.YðÓàäSüTŠâñ)Ž°Z P¦`sÊNžýõÁƒ¹¹(S¯@ «*(.ï.Ëó’…JSa‚ŽIÝ;†"™Š)xaÈË•¢Ö^^P}â Ó$8x>ñÁ/14U˜ŸH€ù”€ô‚à‘ñ›Ä¯FVf]îfqYÙ™[w×~ú?ãá¤-›·piÖìÙÌ‚ÜU^¿f­r` Ñîß¿ïÔ±ã·ß|ÏVÀl¼èðÊÛ~ýëÇ·Ù¿ ì`[bÆ ‡C!Ÿ7n31gƒdKk@¢ÎånZçú¹ ãЕ.‘Ô…´ "ìà½JÄߌNzeŠV Ÿ*Ïαe]ŽøŒ™Œó|¦§$w]uzS„å,g¿66,öÐâF­ð¯BfH$¹$„ÆRAù¯Ü„‹+gqúeOšíF³21›yãJYÒ+ÃðªdEº©ÄðN,ËRe˜áÊšALD:u4Å"16!¬hØBkìVŽ(Xb{­ZC†Ñ`Eü¨£+p:u§Òì•B¿†4ø€©V‚›-¼œÅ¯†<ZøÑLž¢æOLà tÁxÀ ³s  LJÜ\æhˆ[!Ÿ×¬Ç€/Ëñä@oß/þëçœD¬Z¿Þä0³" :]ûàj çìevïÞsêø±Û¿pKuÍ2’7|•T”I9b.?ý/­†_W…„XàôF¤ˆ !Ât\ÀH$¾8‰‘p:$1$ Ù‹¬NðC¥ØÆ„M0*«¦cH_–ç©+eàÓ2:︭0Bj&U’$5¯–$| PWÉ¢¨Ÿ$‰Ìø4†2¬HkI…óñS«ô¬Ô„‘é * ˆW2dä,ªeK¯UÖÉ }¢o ¶˜k×­ƒç.˜ã>sòã´µ.^º„§`2²²™’Ík/¾ôëßüÚés-&w%a].S œÅ‹­¨t2DBàÐ7ÃÀâˆ'@ ”îÀ'L5p’D N UœHG"ÀéZf TYbq~n3ñ»±f2xø‘GÎÔŸ# û%Þ¢ÀŒo³øF?>p¨m"êcÂüèƒ÷j`UþÄ <–s˜~8ö ECL2† Œ–’&ó£r‚ÏìwEcLSȹµªµ›Â,ÜãI.ú°0(; ¥‚2Ì)¨”AVÇ(Â@@Fꃴ‰µ/ˆ~á°6‰©dl‘Y˜[´|úIaC chÐÛ„¼]ÌÅïõÜsÏ¡)Ò~®O3·ççåyþÃ÷»G†!Å$a"þæ{ï`#Ø΀„éT*àR4pÖ¤/eߞƧØO(Pé†4'ÄIä¥(¨‘_‚SÈñâN>=`ò€8’.ÿø7žXÁ@@â%v €(ýƒ>àR=£€ †j¨átTjø²¦Z¸Ùê×Úbv­Æ>îŽç»³,ùãZç¸Ø»Ç,É Ï…è͆˜É:à1yG#îq6„)yjLz2TÂÈÑ™vÐéñ”eF ZGT3¢Çª¢‰–ÙaaM®é¢žhh| £ ¿)%”ÁÐй#Ü•3úñ™ µ5Õv*Ôt¦ÉlrûÜQ_¨|Z]Þ”ÉÐd†Þäwmþè([?aÓNFÛ`>¿ÅàÕ&³ÊþúQ~¾”Š%;‘€«>ôC’p„@qÄãžxr  K¼”‚/%)¿$á‹@`ÈN@*õòI˜:0Þa@§A¹ÛJ€!‰B©ÉEŸò÷²<¬”¡ê"ú¶²z)©$©‘Ê}J £TÈ‹ÿJA+Nàñ•¾LMò’00*ñ*r’ä3õ ¤„‰'À¡N 2Y™Ì¡€©·ðÀV];åo¿õÍ¥‹—ÆoÅyäÂE‹x®¤¼¤¬¬¢nJíU3f)’m&« ï‘_?† Ö;ñX”éèç+v#EÎæRŽÌ D¦LcãŠ;ÞQ§§©½àªyÌùÎÁ‘ú梅KØ@³¦g™ŠYJØ–lÙO+l$6Fægì=0»r2€ÄŒŸ–ÉÇL Ug}A˜ÿÊpÃPl’HÖÔF¹‰è˜7ã öóË$C±‚úA¯ÊN„`L0H¡ÃΖ^Yè±a0Ü×Ïô—eMƒˆà-ÆXÖFôŒ}¾î®Ž|ŸµbZ>êÌçšZm.;c]œÑ ™Éíò:Ï^uÆYÇǃQÔœè(Ñ/bÁ°§o0J˜Êk²ËòÂúÓžTž¯æT[]4ý»úñiK–8¹®Ð°ÇïÏÉ̵èuž@°ª¢’·4nX·Ž•­ûì_°t1¿WiaIYEåœ3gÍœƒ|Cˆîyì¿;ûxº7à÷³–á‚?ª½¬üM¬ÝR‹sƒÞÀW~à”Šº4F…WÁ€ÄA¢ ë§&!’'`WðÉ{…T5 ÌRñ¥DR±A„L—ù`u¥©1HÍõ©+ñ|: ¬£Ú+4”Z|*ºK#©¢à!‰@z'~*0=%•t>½I¡Ð yIÅ—Ù ˜åSJÁ’¤¬’‹œ¯˜O´(<Œs ‹l•§ÖMÿÞÿ~Þ¼ù|`§e÷Þ÷ÚÛÛ¯ß|ãˆÛ]][=}êô÷ßÙmךx@k7oNfÚÿóÇ?è·Z®£ ‹f§Æbw(dN²€§Ì¹h´˜¶fm Û’Æ\ƒÝãæ0ŸINAnؼ™ùZ†¢3§ÍX¿vÝÛ^ïë`E —,Zü7ßøF~~¡’¨ª3opÀÅ[Œ}4[tfAE­W9.cfƒ¿°ô„äÑÏIZòcf»;nõ%Ìœ‘)¦ŸÊigä0çrÊ4®l ðã!«7ß„Æ*¬¡\á7ðDHei‡hŽéQûaz„+9„²pb˜à÷BH§Å,ÃyQ3€îu«x‹/žÇDÏ8¢œé3²ÿGäNˆ>6/>¥Ó¾ÓW FvÖìßã Ô‹‚Y@ÞœDÒ*þÇ{£ÍÝ ÏŸ\jâ^º2ãˆà3ˆ)b(ù³ BÛ‚Zaó­D62°‚F£œT*öjh2§žüj|rŠJÕ³ïGsë‰V c¸¬©¨þÊ_®­®âï¿ÿ>b¦ 6 |Á¨Ûàäå†ëo|sÛ¼&èñz¼^XâÛßüVA^>òz”…ôúxVäRrUɆ€P ¾ÉOƒSé“*‰ƒD…J8EÂ&”¢~Lv)E¼r@ð#¹°ÊŽ»··Wb(—8¯€DéâOuRi3@ó|ß¾}´Š’ i³šQ"ÕÏôÀ|JýÄ—˜t5,IR´Zor¦hR H«ãÈ(ŸÀ–˜ôñ)$é¹êÆ@«EÇÔ‘•™ƒÑ¥Ç~õ0 ç`ïÁ¬(-ØÓÚ¡¹¤¦¶¶îžü¯Ÿý'ð«Pö>·Ç’a ú³Ø,pZÑØõÊËÇÊœ¦èÄ*ªt,bÙØ£>ÃÊ,Ìžèð‘Fž}Dð}³ñB\3#E4ÎFŽ +ê­I$–àaQ¥¬¶ƒF+„¡‘ç¡9›PX…„E‘ú±2"Ë2¢dŠÂnŠöŠ&†Ö½AÇÙG<Àœ™“?gª-;3ÔÔã9×iC]žÞS†&f|ØžUäöŠBaÆ"=÷[1µÇ„îWÎY†Ç8á‹%bì¶ "|Tº‚ýÃc#jƒ”ï›bâ¬EÐ¥e9Osa¤¬;`|EôHÓ¢D¤Æ}ý2Й£5lO)£÷,¼úä‡w¦LŽm2™4Þ°ÿàèö^~eëó`@3'@üÒý¼ä‘PLÞ1 )¬†òÎÏy¸w ßÎM#Awì°eŽ ã™,(\*»3ÎD/®ÓéG%!!>!|žrqÊ¢L!N|‰H\z̧† þ§¦ª‘€M€‰”ÏT ŠÃsš†eJê€(J!ï?­ŒŠG—åy5›°aŠvš2Z_D§Ö@QöÔéñŒ0Hc¨4=KAR‘„ç¥=Òû‚ H)zB©âüce´Êa5fʬ6›‡T²þÜ9Řlêr2/É#ɃúQ­ úüÞq—&GÍ£¸¼d`läôÙÓì ˜~Q€ #£GL– ‹ËѬ¢9]SÔÙR[dø„&̳*U×CÎÜ¢Õq›½kX™ ˤ fP#Ò$®q+W¾”ÎQ´c`ANï"q#Ö«,Ъwy Â^BÂÁñA\ëôY=±xBÇz^Y¶ÄYxÇ-Ù îÙE4&£%ìæš\)<Œ„½!kq^NAaûCC½ýF<˜\¹j†c+O1¢³àP^;²ägÛQ›·™²ì X_ÂT$‘€e^Ž°ŠY(ƒ±r¬haï å2"£[eDqN ¸žÃBGk"n<Ê–€ûyq*Ÿ™cqdòìl‹zÊh¦ràÉáb,:äFGR›a5”äÅí¨)ét¾ˆÆÈàBNÔÀïÅóò ²ÊÆrèÜys˜áY>Œ ##;•~ìÿ²¥utz û)TrЭô¥ÞQz]+\¤4#a"•´”#F¦w¾Tz£^ªò#Uˆ xœ@ † >IäXü ©—~/Eà“*˜ñ…/xˆåÎ;ïÕ¥/¹,Ï )‰¥6ŒYH#Q—HR¥€Á]ŠZbÔ$©k:˜š$HP¥z|B‘D¹ªF²à $14—ŽDÀTÉ‚®HVV³ ôÝÃÛo³Üc2À4µ¢{ÏãmØEvy^~ýµ=»ßA=ùu[nPö¤µYÙYÊíî$¢y–®ÐQ2æ 8L¹F“‰—&ø‡FÀ¯ÊÜÉ…\(Ìã-þ0ì¤5aÀ¢kˆqmzë~`V¿Hß­°ómêì@¡Ñ¨Ççn %̱²«¦åÍ¡¥Ív`#6þqc¢c”sÞ–¶éÐ-ÑéÖÒ«¯âDÊŠm~§ûô…¸ÓÏ¢Ù¡ÖaÉ^_q¾ï\‹¦oĦÕpþŽ= e_ÁA¾2á+GüÌ¿æ¸ÉÕ9êKøj®]T¾`nùC<ä³&´}ûOGz]Æ0¢îôX1Te4vRs/§ÒŒ+¬ÛY%1g[ìØñVvvƒuIm÷îØVŒøûƒ}ÎœÁÈèñ&[¼"»¬°pK-mŒ%CƒõM‘­ÜXDóÈÓ7>è®Y:Ï^W›]Sf$ÁÞæÑzK–ÆàCêÀÝNA}‘L»}q«³Ëïyáåv¾õ¦ÝÄý£Â›®ç'0q&eäå°²PGÙgE”# Z« ¯z`±:ÁQ]ãSÈ5•¢$ÁðÂó¡$©Ô¨ˆ—$›dÇ´|€[*ß' ÒtÁ&1£ÆH‚gÒ’19n8Àà¤D2¡„/Ëó´“Ì´“å=¦9<ÈBèRDjó.MšPW†‘Šª à$—tMz©Èåw’ÚJ$Y$R²§Ð(©øœ;c, ‰ìr"Ðìe6Å‘„´Âæ°F“1$XO½øÌã?No:½®_üòQ.ɯ\}ðÊ>kÐÈS ðh x´óSÞØÈ(¸&œ¢åJ*ê´É0ûâ Zæç…ΘËÇÑ:½ê0[âÁ„¯K‰ä—çc’I‹rᜡ$µØF¶„E]‡mሯ,5”0XCÌŽV8´C^$[쫃Þ@  ÊçÎ žÄ¨&éàîj@ÙÞs uý.WlÌÄ|Ú™ÐÇœ¼J¡Ñ¡\ œé#ÙæX^ybžAraØMh3 Öèx$Ú5î·ÑyÇt¾!’4ŒGb®°ÉœÉ^;1èóÚ•êW !nðb8Ô‰z}Œ5¼ÝëuÇ\aÞ£ñ2ÚYÌ yí˜ÒŽë1‚¦`ÒŽöŽœþ ¢ž” 0´y‚D0)s,ÐBNr$¬¬qlmò÷<¿ƒÁ¢€×÷ð£„âáëV]Ç5>VQî€Öà®)G)<‰‰ ’õÁF*-áÎ öldÄ'Œ^™9Szø„©%À˜GACÊ·6,´Á˜qVXàÀBD8Ê%²ˆ)îµkÑéQ,ZÅX‘ÄÐ¥Ë`;ÀþUyLKëFN`Ñsɇ ¥°ÖÐùæ¸Ña²Ä‚‘¼(‡úFW‘^CúZÆmÁân–Ù؈k5.›r`% ô­L­~×}ÑâU÷8ºcßÁ2‰¶0 ʦ%†y|¿ÃÖk«‡1 ¢  )˜šp8½×º}«uÙIŸÐ£N ì‚ôÁ˜õý„~Ì¡eDÃ!u å‚V”d¶²P £Ï+~Æ@ÔËKþìð-‘°"°¢÷›ä Ÿ{;(7*HìÞM”…V¯¾nö”ÚgžyÆô±n‡ Íb·ü_ÿÛïîl<ßÝYLV–o6³ˆ_‡!Òj²Òî  ›¤üÄÅrd—O|¡Æ­)—>ø± !(Müš`F>ñ¡sˆ„…hI!¾8`.•x0ˆ# Ž•ª)eBF¡^Á@ªŠPÀØ®VWWïÙ³&F*©–5!pÙy8*„ÏÂé|R•# R©DzýˆT0éí$¬:` —OÚ¦f—Þ§û¨‘Š–@Š<øRà ˜É«¤Ñ!ÆF?Ũw¡ˆiçÙÙ‹,¬)(âĘÉjØïÚæøú{oźuœq…{ïþšº[ïüÒý˜æ`=ðw?ÞϨ´fþè• ›ùȹƒã£·Î¾–¡Š© .q¬§¥«»ûú«—gp4j·NÓØ×"ãš«—çZ°H“À|ƒ«³þdÃÂÛç—””²Í¦k´ÿÄ©S3¦LŸQ5EŽ"4Lø=29¿lÞÌ«>&Sãx2üÑÁCXæ»fÉÒp8ˆôÃ5;ßÝ'¬^¾ ÖbÅÌ‚âè±cýž¾ë//Œ ä3ù2ŒÇš:zz1qWlÍNÂöÛû{vŸýxåò“m9L‚^£‘WîvùpÖ´º…5³0’Áþg<à{çÐG3fÌœY6UòÌ6?¶~¿`rŦʫ8ž€Ê9ÌÿðÌ1n°¬·$ìóÅLc†mÏ}ìk®[xµÅ`ñ1#Yí»Nt·´ß´~-v/’þ8/O¿p¶±­yùâÅE…“üAe™Ô3ØSöìü™s'åeašÖjèˆx÷Ø·b΂ê¢Òd8Ž³‘°ïí={j¦T/ž=yäWÿöºÇö]oä/Y°HyK“yÓ·Z>ü0Óá˜7c6닾žÞç_|±8·1#ì¼(“S©N%!>Ócˆx!WUé”ñ<¨x`¸_ÕTŸÝWÉ;U5åñ ªÁµ$y7ÜpxÔ |*ÎËò¼š ›ÖØß/,GÛTNtÿcÛ¤‚M: $ŸÚ‚M€ñauœ ™üNä’áœ)ÈñI§ÙÅ¥†ÊÃ쮹-ζي†ª¡nîÌE+–.ª›‘¡³4ñV7ïøk«k®YtM‘.{LsE]QwIaÑÒÕëí²ýšðP¦R‡%«¯+Ðç0ø95>Ÿ]_ ¬\·Ù¤è»Y\_øÌkKîâ «+Å(úz4Asó)]qæµk§fN¶1ñÆfo'§Æó®[3§blâÑøÚ}ƒÃ¦øü¥ËçUÍÊPÄO†¦HOo<¸púì³æÏÑd5ÚÆÄh¯%‘oÏ\¶òF¬S²@ï׸[ô‡ÅºxÙµ•ºBäs<½î"»½³iîškgdY­öÞ„?v®ÈÜÜtÍæ Ól“8ó².8ÿñÂ<Ú ë+r ³5öMâ|OcŸÆ¹nÕšÙ“kYFß0ÖÚ¤Ÿ>sîú¹×Ú4&¯Æ;èm1¸Ë«*¯ž¿D†Æ:à6GÑe¼úšU¹æŒ”¡KWe„£‹—¯)Ï.§¬qßõ‘¦¨¼tÁÚë&e94–ñ„ÛW™8›½äúM5y“1ÔÅÝ»#Îx-úùkÖb™oš9“熎÷µb3ç̧é¸6ÓânקÖÖ\5kÁk^0hò M Î]pu©ÉŽá“1md À8Êʵ&Ûs;šZŸ{íåp\QÂã¾…^QcÂìÖçÈšI÷/Ñ'ó*I8~wèM(L·«<Ì"x€‘@*ßDO0ˆ0ɦó™ ©Ã#,1xå†GÇ7nÜ(CÀÄÂÒ¾/û^ZiD‚¬í9 –PÙ¥ix.¤SpÀNq %U"e,\t%‹z“\ô¬Œ;‚G€›Z> K^ÂR¤6HÝÙ<ø#!_4T^SùÿÿøÇG>>zðÈ¡9s翵ÿíƒÇŽÞòÅÛ‡÷î~oÊœº#mçv½óö7ÜȘ·õÅg§-žƒ=ìßn}|ÕªU%EO=ýLqu™[øÝSO,X° º²ò‰§·:Šr1•õÈU•VlX}Ýó/¼àI† &•=µýyD][6n~õm­ý3kf½¸óÕ ƒ½÷Üvïûû>8uîÔU3æîøpçÉÓgî¿ó¾SgOïÝÿþ¢«–¿{öýÝï¿ûm·{Îíol»jæœÓ]MO¼òÒõ7maîÞúÂÓu fuŽ÷ÿæÉ߯_¿Žç(ŸîŬ’¼„Íð«'¯ª®¾jáœgž}#?ÖÜœ_?û”#;gõšÕ¯¾üšÛ穪˜úØö­hø–Í[¶½új÷Ð@uÍtžÁèìlà®»9täÔ±Ù3¾thûÑS'¼ûÞáþþí»Þœ=áæãxç­/ß}ÿhÿÀs»Þ˜5^CGãëon_õˆ{ ¹ŽóÞwvgwrØÙœ°‹œ™3’¦˜%ŠƒHѤµ®õ¬wËAº¶ëÙ.«œôl_KV¼¢®¬@KæU •H1€ A‚ 2°9‡Ù0yfgf÷ýÎüæñdI¾UÏ][½_ý¥þ:œž>}º¯»6 |ïûß«[Ý]Š}ñë_¹úš+Vwt>ö/ßvE|µÁ¿ÿÚvô¬ßyí®¯}ë±DR_ßúåïþÏ@$|õÕWÿàߟœÚ¸zó7þõÅâñ;ï¾û©gŸ954е¶û;?ú·¡Ñ‘{ï¹çÕýû¾y=R»_}ùù}{ïùð½'NžØ»gOOwÏ¡ãGÙWË·qßãÿ[÷º5½#ßøηëƃw¿476Í/ÄžÛ½›Ï GyÓa”lÔcgÄÙßÞjN$ jf`€‰IªÓŠèÓÒ˜[›#J² ¦¹‚ )^0µ@«=KŽ² –jјØЈL±‘ƒz"r£áÍ7ßÌ%Ev#ÄïÕ籘ÂpÓèðð°õ&³ô‡‰Œ\»;ìe3ÒE =z’†zvJÁ*6Yr+J)_ÚÍq‘#PD–å äøgÖp<®\éçwCuݼÏç÷sÛ¡•wwçê õ«‚¾-šcy}]çê­k‚§_èMdÓkºV_¶jss0Âùj#Ó“É…ŽÎÎmkÖÛ ¾2.H;2Ô»©gý%í=õ®€'šË¦ŽO ÖÕÔíhé^lå%¸×ç=9ÖË©¶¯ï®êð+]~ïÑ‘“¼L¾´“ýâmaŸ?ï>ÌïÈ+×oÛé¸*‚NÏA.ˆHÆ/X½á¢–õµá0Û úg'æ¯^»íÂæÕ-¾?)û3C“[:®éÙæ‹TqÄë|6=8>ÞT]wɺ-ëÃÌR•ŽƒÃÇ›«ê¶®Z»:ØZéwƒÞÃÇ›¼áík6n ·ñÛ'ã+?6Óïwû.[·ys¨ÝÏÝÛÞŠ#“}|C‹O¶Õ¶÷„ëâþ2ÎÿŸŠE»»»/íÜRôsªæÈÜÄèüäÚÕ«.éXÓì „ƒþ¹ù¹Ñéñ®ÎökVm¶^˜|‰|öÈÈɦºú‹ÛÖl¬îä'8¯:Þ9 /éÞÐYÝ@—ä÷ùþ‘Ó -ÍëêZw´¬§ èFGO³Cáâµ›¶5­9\ì´999‚´MÝ­Zf;d0x":ͦ_¶vö4TÕò:d*“Øè wx:3K¼¬ AÑúøî¨tO¦i– ´‚i9Z±½¯BÃ3‰nBû¤½ÑMè~´d’d(VÛ†W10ôÉ$ ¥Ây¹ ”#‡ÞÁ¯ :Èx<ÎkK.Y-‘¼Ccˆü»‰ÍŠ<’ìpâJpfX#AàML–ðçJ Ë %Xå4x;@I|@ʉÁ0{¡lš>‘ ^b%а £Øe’‰,˜­`eå ñ;ÜrÝÊFGǘ$WG"ÜŸ˜ßØÕŸšlñUu7uìßóÊÜÐØÚÆv?Wº¸¦¥ãäÁý‡Žn^µ6;=›™œÝ¼jÍÀ±“Gö\ߺª<‘‹OO‚=5ptß]µ¼ÐÎM.t×·ðÍÙ¾ç^h EZC5³Ãv®åÀÙ'ôc6Q­­n™i¯i¬,,?ýÄOù¦¬9T›žŽr«L¨ÂýÒSÏfm¾êøÌçÆЂÙv656µµ½{adÄ•*n[½îð+¯>ÙªÍOÆrSs›Û{Oö¿ñÒ¾më¬oÇ'¦.Þ°-:>½oÏ^æêUË•Ü!sÁª ©ùؾ^ª®ô¶†ª£³c ÍŽtî…_<qz;ªê£ãã-ÕM‘@õs¿|†#7[=5©É XÓÒõâ3/ÌO^²v{rzŽ"oìX½÷—ÏNŒ­ëèŽÏMãé-=N>~âÀák6,³3~&¶±kíð©×ŸiKçÚ²xfqfas{÷ÜÐÄë{öö´vPÒÙ±‘uí]œŠ»ç©gÚkZ|Õ³½£ÝuÍ®lqÏSÏ:³Åõí«§F«9Ì°¬rßž—Ø÷³¦¡uah¼Ù‚Ñ 3sÚºÆ*¹®º¦“‡O ­iíÈÍ%xõ²uí†#o~}ÿìûáÂsÞ[i݉jm‘|— Öb5˜R0-MM—$¹z )©g’á¢ç¿‹øwæžj´ïFfðÆa €ÆÙÃŒ†nbr »x×¾ %á^äüÇÔú¹F13˜Y.+í—V`»\ã` ø‚I”⣠€¸(2a!P~Ïó}ôhä'/Ì¥Q°¨À\’Œ`áý|hâópšŠµEŽ­|TÉ…Ð^¾„O³à[XÌú+ÜÜ`É®û¹ »;rär¼CY–EÄr¾Oðr·¢ŒM8¾¥rÞ¢9¶™³[r9Î]ö9]¬ü§Üœ É«ê\mU„U:6—Ã+̧“œ Hcå¾$^G¥yõîæû0GsÒ=ñ|’O\±?·@²O–¯}Ù•ÏraÉͺwÑÁõx*ƈ>™sˆtÄå³ÎÀ·òq€uÚ§ãòv„ïXŒ-fpsµ7TÎ^öÀ¹œqÂÇB*ÆT‚Á›Ç8àòi6é•Çs¹`¤:ȧ>œ]åvs¸ÕL:fÝ–™É{øÂÅqwÉL*YŒpÌ5¯ g—Ò\A[Hd=>ûóy&âjëÃ[Öe˜,°mÿx½cóQæ;ÌØzÌþ$¦×³ósÞ€2ë­/Mø‘Èi>¬È2÷¦æù˜wåì“bom¤5gÒÒ,Ÿ–Ô«YÒÔhKø ìáç'1YŒà4NÈà"IŒ(ÈÄN, J"N¤. m£WMÚpiú $rD =0iˆ¢"xÏ…x|¦§O”1€AHG“Ì@(êÑ*x… ‚¤<%ÞGñÂ^0±ä KeÉ›söTÐè€ÐŽ7 *0ì’@Òd$¤É$ø8MŠíðŽ„fŠåbÞ½e¸ÂoÙ™¸ñF·o| )£뺙<;79:ÎÚ©FãÊ—¥"W¨ƒ„WqÖÕµ|î^z‰¼ÄB ›àñ‹URÞ²ï”úvWòi7È[G_¤ùznº²À9S-q//ËÙ\šÉ³U*ö ñ3Ó±Ìy°ÖFZ®·ç­ï¸Ù¬ÃÛsVÌh¯Ö°ÈùQÖ‡q^>Ì¡#U²ØWb$£ô©/m™w‚œÍÞ8·ÇZŽ±d“ɱò\ÁG¾öËò½@Eš]/ËŽ*6´s ê+¬å-NYt,2ŠË*]ð±[9»È/èy)€ ÙoG{ÆÖ¾zçùyØ¥—fË uÇQ l&È,YïÀÙ†ÄÆoµ†R«ÅÄI Kw¿ÿû¿OR?°)ˆ#ˆÆÅV, v“¥¾GR¢„Œ$°!±ÒR*‹‰€ˆÑ#yÔóèÅ$È(!!‹èUꀆ,UÆ ‡ƒA‘z¢ TŒ);~À*x¡&†@ì&–|%!° »öƒ;, <*¡´Îº£pC{éP àêsÆh˜ŒX§^”,)ZÛsy©g}Kÿçðæj_¯MØÿGGå,^@±Ç®‰CïüÞ¾þ$o ¹ÖÇ3¸¢%ÒpÇ­·q)ý/^Ú=²¸PÝÞÜÚÜæˆe_yÓ“(rÙ}ŸsºyËÅ>Nê°ÌæÝx¹0†Y›v8NÓê®”ºÂ™ª,§OúÙr‡oKK?¼¨ƒ÷R;ª\Ë{ìKäÝ5; äìëÐ0kˆØ¸& AÞFåE‚Uê’‡ OL% @!¤¢©Ajßô¼*$Z“Gz)=^±£ì§À ‚ ºÃZI49E0¼°@>@OLI‘Àˆ±zLU «—z„؉Á‹I“mä€ ŒØ ¯T<ýôÓ7n„^ê O®$X&d+(eãàgžyAx $±xP#©|ÞXÄ 1ŒB¢ÅIR4 Q’˜‰zjHd 1ŽÃTÈ€¡7Är‡bé •JW7í$BT4F¢Ð¢B8Ö7@IDATR™+Œ±+ú?„Q‡I¬¢”ž© óø˜ŽÃçèØÔªËc­§d¬³¢ùäÅš>@Ämöñ\Êá«Œ2uårûÒòG]}SÇšÕë/Ú¾ë¦=×îÝ»÷ŸLdÒû¿ÙÑÑõÀ?ÔÞØšJĹigÿñ¶µÝˆe÷Û® .ÝóÓ§õÒø9Àù”~6±XßÒ3æˆÀÒíîļÐf«Œu ZÏbæTUÀi$j¨¡©‘x|¶¹C4–«K¨oXŸä³øX^ÖÐÒtÓýw×®jë¿ú¶÷]»é‚wõxfº/9õê±7Ÿ>1±0ËÂ[û([Þ7]°µÊéî?r|.¶ÀôŠšàÖm[Ð5311>3Ï«ÝÈÄH}Sc÷E›&3 ³3sµÍÖªÂ#£Ó#ã “|Ä/a6ír#/·ùñoõ/6"ó£•Ì-uÔ1j2?æÇ~Þ¶c;Æó¡ ±jÈŽ`(Æáj¼+Œ—ŒìÀysÏEò0@,~Æ·7pNéÞt’r ¹ÖèSzxðÌ0*ÈÂx‚,!I@>!X @³›‰IR;ˆ"–Xƒ4„! 9H#KA\ŠÁ22È„7¹X‹÷0ÀH ÏrN7J²ú™tI¬Œ±ú<¾0š”dã.Çè‚Ç>e!We–GŒå"š`"‚óÆ’ ñ 0BÂe² $63( ~'h6.?B£Ê6z­ <ûË QàõKRµ;©&æg³šš uÞ™ÖìÔÜÂè4÷äù“?WvÑv—ʹÌZ‘[.x+\‹yÖÕ¬¥ç¶µQVöðüŽ~à¡ð{žÙ ¯ÜL›Š& XÁ¸Ž$0d’ @…ièŸüä'¡äÌ,~½Ð7¨zª•*– vFÄ–Ú‹Õç¥9HR(b¡A44D#™@® +ÄŠ¤¤ƒ±Óˆà¼H;™6Ä؃ 2 €™zðÅ«÷lÑ¥Š çŸýÙŸ(%D(Àç>÷9–ë9uÈèàK[A®ˆ›\’ˆ¶' ÇÙ1À2E€ÉÒˆ€pT0`yœ,‚`bðò¦ˆ%P0xÕ H0tÍ…ÈÂ;L¤9eåÁ\¿Þºö„SDiŽ|wÍãÂH`’F¾¬¤bÑc'± Æ$™´EjjþìÏÿlûöí¼¸jljlkk{óÀÁT"iž” ¦¡ÄÖEÎ [6ÿöGZÕÒÞÝÒYåâL.Ç^ùùÓ¯¼ÈÇïSãÙ¹…ÄT”[]ã£S±ùYžÉ<Š÷<·û¥çv¯êìjíjoèhfb‡‰ŽMö5«.ضýÒ+¯¸þ†ë/¼î²ª¶ÆTЙr-'–²ó¹ÄB15“áöhG°±¦®­Ùòñ¸^H§8Æ£œ…†ÒăY6·ºqéÚšsF±Oú÷:ÛÛù¶cë6î–ìçWCÑÚ4FW¡-Qqêœv/á9‡Â€ PÊy×>¯\TSÅ<©Ó|ä#lŽ¤ö;::ÈåÜ8ý† Çk­9v›Ctñ†@¨nsMf¹b:—ŸK.M½¾éñéŒõÍ µ´f.XÎ b»®¹vf:Š—w^qÅØà艷ŽfrI&PHÆÿêxˆä´ †˜êñ!€² ŠN¾iÓ&º=¿Yh·ÝvÌ8xžÑñ­D™€‹´£‹Àd‘K ½ÈR«+q¿ÓHVX ª%¼$àþ"FbÃÁŠ¤É2’CãA2I„c*1?é_zé¥_|‘‘—$,ŠœñÁ?yÓñè£ÒçùU)ÈRËÐð,5Ä(CI ©Ø$UNC©,Ã.iBBl’’).bl {C€—‰e*4”„d©R¬Z!I@£…$bucÈ¢Ôœ¦òÍo~ó¢‹.¢!þéŸþéË/¿|ùå—_xá…;wîä±À!갠ŘaÙiÏFÂcIÅvJJÿÃßÿÃý÷ßÏÍßþö·ÿîóŸç¤§6òuÔüÜ<§ `ai;Š[ûX÷Z*¬^ÓsõU;ù˜ÏÏqX<¨Öîš›·¾öúþÁÓ½lÎá'wj!Æ×>üÈú˶_zÅU[/¼­‡ƒCC¯½¶ÿ7ßbwpÄkzkê_~ù•Ÿ<ùÄ['ÿèù§ô÷MÍÌÏòrŽË^¸/›†½,Á`€ó§Yªb¬´¶,q’BÑ‘‹&æ'fXljm‰/Ä¡ÇÏÖ‚~¾¸ªkÕ×¾ò•‹.¼w}Ÿý£Ï<÷̳×]»kÓ†·ßzÛÞW^b rÙÛÕGµÊWr—\$ç HIÕ¾’Ä+|ËÊ?e©Dð˜ÆR§œ‡Ç‘gô|ú€´™ˆ2rh&áj0ÆÐ@ FuJv¤)6¢ŒI€‚$“¥\Cl„ _Ê·Z¸o,Œë`$Ær»|†9~±ò “o¢¢™ÛK.œxäïþîïX½Ór7ÔÚMA¨QL– €nI b“ ¹†@~!‰"††±‚ˆ…, è€,ɶº4Hu~5)¸ÈOUQ²DÉ÷ÌÁ0´544 °±±±··—¹=slžóüªg¾£'’ô+@,±gïØ Æn*”0,ÙØЈm-­-`J[¾òŠ+°ŠcO|£¿¿Ïãc7ŽuÙž£kY« ºoùÀËU·ÏŸL'˜Y²‡ˆ;!ÓlVȤ/½ê †VºW­þ“?ÿv]c¦ÎûÌ«/ý乧†‡ÇÒÑØø©l4†;Ü‘ û‰Lf>•Œ§ÓÓÙÄrC¸¼!Òà LŽMÄ8%Ú…èâruC-k{ë»×¶44óû"·v/,&Æœ$ ¹ò%kÿ™Û·0;ÇøÞúu»Ü õõÌÈB¡0ëIx˜9öØØø^zùE (/á*˜:Oä"ÀËÛ`ò$1H‹R1¿Ú¨_4"“éÚkkkwìØÁ¡qT(èUÝ·#G ‰˜fƒm²ŠŒ‚ P«ÃÑÓ~£W1¹²A€Ì ì»Íb½ÝÀv!vbXÈÂ*é•='I ¥ˆ!ã,Ûo¿9;]CÚ-.Ê©þ@ «wü ²†óÒ»IO@–˜ŽJRʤ ^''B/Fh14`“±Áàn0â•4e‰^e QµT˜F%¡J†QDŸ'@À@†4š¿vh”LæÁ<ôÐCŸúÔ§ 'üú׿þÕ¯~ù KÁ+(its6óLí,†@Á°@ƃ”g;G»Ð@ñÐáYyb‡6SH>ü¤Ã󃙭Á]üñ§»×ôœèggÒÑ×Þõ;«|µœ<·èȾðÚK¯|ƒ•ˆKw\ø¡}h6;øö¡¯<þíD"ÕÚÖÆÙ2ñ¾Q¦ýÁŸ½µÉ@y‘ëèh¿êÊ+Ù)xl÷øÓõ«;>pá¥?}âIœ“ɦhÓU5UEw¹;ègÄ™ŽÎ¤2‹þÅŠø¾¹}íŽ`Eª0Xjmä³ÜŠÙÉi6ɱŽƒ(ØAL×âÖÔO~òwM½å«_ÿò—¾äñY·€ãó„6•ŽCŒ‹ä%²Œ‘|ހ͌Ը‘šO|âTuMkùçþçïÿûtcÚ€º=ìH£–¡‘ £Ü$Ð(cÈ%Øk™Öˆµ.hÈ’yç5 ^èK2ÎDvQ°¨ÔH H#±D‰×Ð+ó ’%A4”ÄXãY<¼¿ð…/<òÈ#¢‡†`Ííù‡hq2ÑåGkƒYxbÑÈ,Ågs¬ÿF±Ì’Aà¡\AˆM °iJŽ¡4¢À ™ ÑK;1uI.uO±¼@©£‰fnnîèÑ£ëÖ­ø«¿ú+^×±°G[AˆÑhTÀn•Ì0±hˆ¥Hx;lxiJ´ÈÞ¾>0===LJ9º˜•îÁÀ<žðL³y ¾¸T¸áæ?õ}*Zã|ûÔñÖ¶ÖW_yyËE;ú£ã“Ëñ±ÔÌw¾÷|û»_~eCçê‡?úð©á¯ÿà;ÿöÔ“KÓ‰ž–Ž¥Tvf`”M5œ«Éæ¶sƒkÄœŸêëëó Œ ‰d2ÞÚÒZ_U³}붶ի¦¢Ü.³žŠNåؘ̲“±é7O¶”‡9ÊÒÏéõKE±Xæ}>^b¯öJÇøâêùØ¡#o¯]¿6–Jýíÿûù}¯¿Ê6xæ¯ø\Õˆñ ­Ë8MH%!`G.“ €3éT+Ë1¬CwuuÑ“™º2’R§ôR¼JÌhNåÒ1T)h‡ ð$ F;ÂQJ,ã‘@ B /«ì1x$ `0Ò+v±€1HaÄbAŠÃD@Œ!XÈlb”2ü1²€µŒ2øÌÔ(Æ?~÷3`8DŠÑ¬$1 P õ²RIèE€>‚’†RIb AIT‹WÛ)Á¨lb´:qiºnèa—T I)ÀPZ() x‘$— Õò}ŒÕ+¯¼’¥çž{?0_¥úeÀŠ^é/˜x’+ðr…á…˜[‘ŒùŠåzV÷îÝËRfX§µy=Ö üãXþðƒ\~õU'ûz_Í¿ïºNöõ7­[}rf ûßzyÏëû^åë1¾Ìó{¼/½üòdreyëSå œÏÅž9öß—vÒ,Ä’… NŒr×6¬â O &‘¶VØõÖ©ãM->¶gs)>/ߺqcc[Ó±Éác§O–q0^¸¼,RŸíŸøý‹YªDþâ²uæ/³Kv鱧”×wÜúzâÔÉþá¡ko¸ž7'¿xæiúóÇJ.­*½L6Õ„TvÚ½$G­p»ÝÃ"&†±(Bóª•e<~ÕïÞ½[Ox²ðA,£ˆ¶AoW@ˆÝ«B±V-ÊàÏŒXÁöø\z0®˜¤è @ò\X²/<@)˜<¾òÊ+øAwÚ±: ”ˆÀ;yνC uC6A+†ž,X¤I$ —‰ÌøÝà‰ aIxIB)zI&”­§7H0vÀ.,ú¤fbb;ô$ ¨ÐÈEqèÀ x0ÌC‰UpñdЂ¥~žñ»Z‹º‹zX¤…Œ`˜,{®ABfg74_‡Þ|q a¸á­¥×:ñÚ:Þ¡Òçùä§~÷ú÷ÝøãŸ=ÉÁ¦UëWÌî;r€óê`YŽgž{쇳Ãã\· 6ïÜuíý?ôÄ“O²éš×c®ss¹ÛzzƇdž'9”–÷ü’å=7ñÙÿèøcArj–×óxÏ(“¿¢Óúhg:Î>ýºö–pM8•åGgÓú ¼ªš™ž;=rúéWê ÞüL‚x+ËÝlþg+Æ[»kµFƒóùèÅíâ™Î ‚Š³¯Òõ>ì9;Ѓ†‘ G &ˆÉÆi‚ÉÉFÓZÚ0ßhð-#¹`h´ñ­:6Áˆ¢-15 1ctI»] ¦il0\vFÁئ ;@rE@Œ»1¥«ÙQ!£2,!I–0<ŒtbVè>ó™Ï0§øôAK¦²É£µ1±×ð $Ù!) ²X¦“ P®0Ä+„iv¼a7* ;€‚¥¾¤Ž:Ãû²A¢Èœ|úç¿8uâ$m9Öo¡Yé<Þwúxï©®¿þê+®\ò»ãÅÌÑÁSCS£|WJe¤b¬¼e½nc—í±Ÿ/ápBmu7pâ)$‡8xÂë›8Õ?Õ;”\ª—ŒÆòs©žºæôÌ<¿8²ÎbÁWÉA ÌäÙ#L‰4ºëa€o5ªR^:Æb캷>ÑóúŒK¡±†¶³oÈ(² J®ˆI*œ©Ý³mOHx¨h\A N5g¸Á?4orÑŽ“Q LUEÀK€1æW( ÀÒ(Àм¬`/àYœõ_¢”kðF”€óâ1x…Lˆ1OÉe¾Æ+!NÁÀlÙc“„SظÃ~[êž< ¯R‰ßÄ2N†„IÒÐËT°ðd¨"³ÇÊ2 R-.ƒ ª`WÉÉc$ƒW9AÒ—d0¥ƒ ;éÞÄšï!A¼" ×1"è—!‚ÄšØ` `²ìÀ{ä*‹Wa´?¶¬aŒ´TÇMÃåíV~üð#±µÝçá~v•={êe>n¹eó5u÷Äw¿ÿö7¹|¢¡³Õ'ŠÃž¶Ùö^tù¥Û.ØÁ7vu›W½.¾0çÇ«¯Â]HfØZHÑZ=~Ïøôd0ählv×”û=ÜwÅuÞpEÞÁÇÿÅ™ølÿÈÂT´&Tò¶®Ù°MÙ÷:OǪº:¾â¼7mÍ/ø–††ÆÉ6dñKCrQÁ¾Aj†Oñé"Eë&\Þ [—x¨…P|Óç…±ûM°†Ý‡¢’X€! IES¡Ô;>¤N@¢ˆ vhy©´© ÍEÌp`o ±Œ!I IÐ6à5Ö‚”R¾™¤hLy hìdhAµÑ¥,-»Ï.ø“+ÉFb#P‰iN0‚'Æ!§OŸ¾ï¾û D¦å2ø5ûo|C O©ð’.£¥YR`‚hbxè Àv³J™ïD#Jc·hì¹();Ñ+SMmvˆ Æe*HšÅ¡¼² ABIíÒIÚ¾7lÌ;—ì¼EƒŒ6juë—°$xâÛÞïP†F†>Ô7<è o½ý6~$ßyã-~‡sà·ï?öú[6¬›œžâƒ{æ)5M Û/ØÁ2ûøääî={xå–­vñewǺՎxÞ[LLæ¢süìå…®¼íÆö¶¶¾‘!Þ d+ - µ\ÞZ66ï],‹NsbEU…·ªÜˆ%‡Nô1{o®ªY[×Ä—6x)\Ϭ¹ftx,?9Á ‹“y¿`}è´.º§ÿ0áF¦ý¼˜ ì|ûÏRWârZ 5¥Ê‚KS%(»ð& f…KÏňÕôjKu)ˆ—ĸ—Ž /æYn/ý&%–4{ ±4 0Yjr° P¦’âFŠÀÄçæ‚1Šì¹H#”Jp&B”‚ 1A%Åä*)9`( M$1ï)9Éöºë®#×zÜ“sKÕ„”à;ŠG€Hþ’\`úH’„"ÝÀ(< ²$z%É`g,bÁ¡N”†ž,•JnÙoxéN¥Ç¦‡j†Œ™^È°X†É¬ à0’—Š#J$+@F`ødâ¹¢0giÏó^°ŠsÅ ·¼¸'šß™¹Ÿ_q® #NWÃ-¿ïŸ_þñ£ÿû_“ As‰î¸fºhgdõêʦ×2ý_>¼ûx0»~Ýú%¿3‘M8«*®¹zWwתÁ‘áƒoîÍÍóM,ÏÕ@_²X6—òûœ^wÆQžjò8ºZ:ÚÚg‡†üM‘­ ÑçÓ½CÁ¬»rl¡an©0éÈL¶:ù &Ÿ9›:Û|³ÑxïTªÌûFöõ²K.¾ãÃ÷ï|eb`x±»Þý¦b<37:Ñà ÐÑÙQÏ-vLOøad=Ò9Þ‚¶c5b]*Ën\îÏã¢-Ëw%à[JM]P}Æu†LmÚâ.ùVµFL%Ê°€TÓ/KÜÙ­\Ô)ê QvZ)?桇 “DF’\’à1@,PJ”XˆÁ+HãÙÔ™Š†ÀNcr G>€¤(® ¤)”ì1I,ÇZbð  É؇LØiÿl?agž”Zko4qÆlÞg‚" §FàYàå ¤ÈJˆÉ• { Ì•}Ð@oÀÆã*ä ^(W($0€a±ûÅàK 7òÓ·¶¶^qÅ`Ð[ʱ"ÉEŒ@"0Ä°ç"<1 ü #nß €QYLŒ-!Ö VŽ|ùòW\:<=ñµo~ƒ7ˆ¬Ÿ…‚A8ÔÜÙ¾ýŠKÇ’Çšo­mˆBÑù¹÷ÝzËÿÌs¼ N¿¼wßÜL4›ÎÐ@­§Y…c*>]˜gež°¡ºº­®qvjúªëw­ß¶åèá#Ëùbu]=§PÅ‹¹©ÄB&âªÛÜ\Ûºö,äS<ùŒ÷{£ÃÃóÑÙc§N¾yô0¦fSé¥X*˜/ûð'©moYȱÿž;sËÙ{KuóšRQüÂÚ¢€þO0Õ$<Å0þÒÄ4!ãU `†×0¢— ¤a·ðJ”] ´nï¹çN˜F¥]¾`¸vÀ¢$6AH{Ò­à]‘„ P@º1 Mª) :H‰ÅZì'—Ê% <—˜ª§å CòcûÛÅe 0ÃƦ6ë±o˜§ÔŠQCë†ö-5ÆD[ž(ùá1ša2UÆÙÌ33I;`bDH—RHT`*±Ü!$1X4x±hÉ» ŠÍXNyÁC€"éR Æé™beãtdª¡áF”†Xº”<ƒÄÖÛ­«kX}³Ú7lReË kºö;´f˦U=݃}ƒ¹dz™ûa¹ÏÍáqÿÓ¿zâ‰ù£ƒþ–šL,õ¡{îeƒüÏžøéHß@<™àòMλãh›D<™N¥œaÿÚµ;¸©’¾Çí#cœqußÝŒô´<þäOƧbÓQÎØâ&œ±L<°ºÅÓYÏP–/„[ÉS§ î2WØWL¦Bå3㮆0ë‚·_¹ó±G¿5™}ýÈÈu-[w]ñìÄ]ÅŠâbÁSÁrA™ßë)g÷ Nøa,³Î÷á{[É{§‘È9&¶;ÍÀT«Ýij®xÉ´(ã[¹µ‰(!M `Ä’Ë| Æ~ðƒííí{÷îåÕ)òÁÈÉ„$€@°‘,JÅÊ=s.ÞNcxKMŒvÖ‚ ©Ë%PíœîÍ<½•ñ@ Y¿ó;¿óéOJi9ó³YÌþæoþæãÿ8ƒ4_wÀÝž)²è½R€2é“߉ Я,’H À®z2d†R€IŠäŠP*õ™ Ëh äK;,$J9ý—퇼«c T±íŠDo×/ÉJíb7ÅÁÅzÚkôÞŒv9g(QG]–þȵ¶ßpµ“ËñâûÕ¡»î»‡ÏEFû9QóâË.æmØþþO=ýôXß`¤ÒË!°·ßxÓÄÄÔü#ih¬.Þ×.92ó±L,Á‰îH¨¾µ™RÏÎDç&§í£˜Ì|æ¿ýþºž5{^Ú;0oE}ul<:vbÀÃ¥“³ÜcÇ©»3³Ñ;x(·NöõV…8¢.?}ôx6™Ž÷8擹é¹Ù‰IwÀcU Ö_Ùqû=4Æ\.Û;6ø…ÿýíSÉé;¼‡ã÷fçæ2‹¹`uU’ƒ8‹|`=– <Ò ” oòl/ÍðyRñ-ò€Ý]¢·XJAªeüL&25Z(/ÊH‰—t%éä"G*®¿þzªCSZC ´£ÂÀH±i¢#@Bì°0È4òHÊ~Å&W’1ÆŒ ’¢4b#°–ÞJ#$2æéÄ”‹]^\NñÙÏ~FäÊæ3¯‚a‹hD°ùœ alAåf5dñÓRà!ûL BáÅI²(†þ ÂÈ5’#JÁÒ„ófI¦Œ„SbCRr0ú#¯­à•âÜ–€T€ÀèÆË ‚”À$í2í¢€íì†ÌêóÖÙVsæ/ÀøýÌéÎÛ6lºô‚‹SÌ–9¬¼bvjò›_ýê‘}op†$ŸÙ÷>ò·,ÿìW¿ªñs)s`(:ÐâTÛÏs–ù«6­ç,íþ©±Zž¿…ÂìÌ›axcÙ¶ª“½q¯x=35ÏVo]8PÉÎÆf¦¦¼á*,YšZ(Ë—3 ð€—ì¬ìÖ¶5‡®°J'ꫪÒÙ¡dòé—÷\½vëM·Ýòè<íœ(g•eÂÜ2?è‘Á«;®ð¥¯ëg7€ÇîÃãFãòU:躔VÉKu½‚]xØy /À$iö¨ yPÐ3È£‘¤á¢u$Ó°X Pl(MJ+W± hIÀ 5]²PxÃN#§ù4Íd¶Îšºcâ_ÿõ_3I„™ð"S\Ö?Ò”œ^MÁ„eÅ‹÷øþð‡QÀ—I µˆh0Æ ð$Å‚eY Æ¢1† O¥ö^ÁPJì¹1d’oØ¥Bµ"ÛÀ0xQ(’”‹$ÄòÎY=+› "íïfƒx‘FPa™A0>îܹS?°Áð¢Ñ®ËÀ+¦Á«>X½+£cXzö®Ô¹üëÃmuþªäÂ|cS=[_ØZûêó»w?÷ ¿–n¾çýž†ªîyŠû˜§OõÛûêÌÔ4ŸÁ¤¸ “ ­mÍ×xfçf¶t­¾à²Ë8Ó«8'+íqDV5¿öæñ¡G'$r¾€u’u(TÅ:]™Çi­÷q$×|&/ãvØå™DÅB616c½VjÛ[ËsÅo¸Æ̧sÏ<÷\}[ëû.¿ròô`l*Ê–{Öx­Cû*+8À—ç<¯­»bhÁÖ=¼…iýYépË gƒ\¤MÎrÎÙ†«,’”Ȉ±»Ô ¨:L¥˜\±kj†6¨ÒB¨V`bC ^µ+‘¥pÖØ3ÿÉ2ÂíªWØv.™!F…´€Y!\IÃ+™=œÇÏTÚmž+<_7±×†å ¦®!!$­Ÿõ ˆa &P$HYÉç{òÎÎÎ/}éK,ùr„ H”ÉÄR ½0â2f•$É1*AB€þ•±bÉ”å 6±ˆíIÙ€XļÁðÙ I~ëBRÍ8 /¹$RIá ’¤,±ÛƒOøŽûüøwxx˜Ÿ‚\þÿðÆ<™R!igrƒ©f %ðIžíÕ>¿Ë±<562¦Ø+‚í™,sûÎ57½ÿöÑøìOŸþ[_â3‹üòlhõ{9¯:Xˆ.çfS‰-[6×…"o:ê øCMåœ{yÕmïóWW;}Ø:š6™ãâ™ø˜3š\ÓØV¬ñZ»hsù@8Â×8ËÉ\Ð(w‡¦F¦¾ 7áå♑·O#¡œÏ:¹d~rêô‰“lÚZ‘)œ|óíÓ›žçô=<ÏAüÖâØ<ë ÏOúR±-ï½ÓU3,|©àV#¶hJAþ¡ð£)맥ˆõø äöÊ’aì±ð&—,äÐ*¬5,µdhŒ@äÚ³€eÀ&(I¬\be­ 3Hð x{‰@ªûˆ^2AÒsÁ³Uœé5B?eOG°­iƤ‰’‚<³”g²40„<òÈ#«W¯þ§ú'Þéó ™§=²PƒVrÍ.¸O¦ÀNJÔ€1€!àYЀ7Y*‰b²”K,9Ć²”y&/J*ˆLm‚ÒâèóüÂa\³ 6IÉÒ®HHaD,zaø‰o™ Rv>؆—$ýKP»øq„£€Å.S‰M`2Oïàù•¹¸UÚYF»è‚ ¸’¥···±©éØñã.§£¾µqוW·_¾™ëŽô;«¼ñÓ#‹Qv“¶¬j´Ô[,“ÞxÏnXµzbbŒÏuü® »j3Ž¹ ë.XwÙ>/ãœ\*éÈ«ªkÜÅŠ™±™âhÔÑP¸à’–sƒün9 c1‘ͤ–ØÐSˆLŒr Wb2êK.…ƒ™rO!Wl®i|}ïþUí;.¹¨:>vàm_M°¼Xæ)ó .yçü»rÎǧ’—­U1š³fB¦ìr î‡ ,aÐB Çoü"ÅŸ¼jåüê‘G1W²`„Æ°Û®¨2²„QÅJ "À-×+ 1¹"&KF*R¹†F\$¡½²0RRÃkêJ‚ÑH ï4®‘„!„(ãy‰¦Å#^(ñ ZØWÏ$¯¨tæn$KA°üÆêxïJ—wîÜɺßÝwß•üN †)؇)èFHLÑH ^¼H& %1$Œªñ‚\ &í¢?7V.dxGþ2±²L,¼IHz13 òÝAp®œób(8Oujˆ§=0«ÈgXIéTLý¬@&‘jŪBŇX,\½D1ùt¨{ýšêHÃé‰!vÏp¦Íµ¿uýÿ÷_?úÙO·^´ùñçqdøt¾ÒOÆ=ËeÙxÒáu­Ùº‰]ôÜÖ¸ì«\Èg"áÐÀéSüFÔ†+3…‘½þ ק>ù_''Ø3·ÔÔÑV(w†ª"\‚áË—;¢).¢ËÏ'6­YÇ>Y ˆÎ/¤9<.æŠÜtù.Ýv‘g¹b9[º½‹± ïqú5×uAüýŸÿd9è ·7\w÷m1Gn25_¨,kèhöV¹´‹7öàÍñ3´K ø¹…ìŠPïá 9 ¯BÏÏ%VÔõèö4hN(å È»ñ˜]ȯ #Jņ`(mÛô7c•È € EÒÐØd!™ØL#TÑL5NG +§qR(5QX$<Œ&Kn##Nƒd„0™½ë®»¾ûÝïÒá¡|oÿ¼kŸWWA(ºy¹Í’ÞŸÿùŸsä®aÄÅ,†d\ƒMôyì   .žü<܈!eD Œ¡*3¦ȃ%òw¦Crd&߉Þà(.iØCL.*Œp±± ©¤Á( ᔚ¡Ô+Iz>ó+øDÒˆå;F+@€„Å,'Û–³•íÂK.fÃü¡™¾™Bz|.Úµ¾ç‡j^³joÿÑ/þô±ÁìlÎãäƒ9ß²s!:ªÜñ±yoÏìz9ç&FÞö'æêê¹ovÙUˆ¼óÙê¼sèÃ}ûßšèäމʪ@’ý³ÐTï°§PF‹«ol†B ‰xyªŠ¥ËÅÊš-,K$£ógßÑÞÉÍ~¾šjnÅíLGç‰ßؤ£?ÚûÌ\eaÆ‘ùÐy¸¬Ê?Îå’-]m\ÉË­7üîà|~ÏMçå¬Ó2Îp oÐdñjgg'§0+á¨2̸ôÒK}ôQžlŒ­8Ù ¦çòÝjÍÐ$0z5$ i vz±@¹Â(/ì& Ùhö´0”bچƒd‰3ÀDÉŽOx‰!¦13‡×³–þˆ´¿ÿû¿ÿâ¿ØÒÒ‚xcù¹Àyæö"B=œˆS#¦e3pVäç?ÿy·dß?´dºb:0VšG½„eTª„¸†b€„žá`¤ @4b^±AÌ @ÄŠñô @ÄØfŒ1Bì’%Ç°¯ 9—’c6ø)ÅØGð^EL>ù~¿AOÝPFÊ«bSnUϬ 2ªŠŸ’=›Ö¿ïæ›^xsÿéÉQ¾‡;5лJìÙ¿7ÒT?•MøZêç¦&g&ÜKÎêpmëšÕÛ6m GªöíÛÏx¼®w¦ò “3Û¶ìàÙщd&àÇp±pâøñ׎ÌÖyZ7®+óY]"/fóŽD.XîJ–Wp¦u,djŒ§œ!Çcð}s2~Ÿó½ç^QRU³"äç¢#››â°À¥åæM«G¦#±)æÿÝu­;o¹á?üÉB.Y_éð׆“cÓÖý6Eëö8:??òY£$W` 0Š¯öƒ?éä,Ž^{íµ4'œI’ÉgÚáOàEºŽx0B$Áž–dÈ'©ØN† vNçáa l絿^Yˆ@ÔHª ÓH* EŠHˆN£>B.É¡9i¼àÑB.ÍO}íª«®â<³K‘1à@Ág”óï;VdÁ¦N‚”‘‹2ÎäÜ(fYüТ۳ì¹PªœØGÍ1 C) À°q1…„˜€q2ZxxñŽFz•± Æ0¸€KÜï†æ,ù™_É~ê3pIã_#Ópä{2@K&»ví@þèè(%åwÐÄÄN0VQpô$SE–:bÎ¥¢Ñ•fÿœ;±tå®{_{µ£gõ¡“ÇøBžq¤¯¯ï‡?üá±'øE526’Ÿi×Üu÷ÝÍ뻹Vv8ýÙwŸ—‰ÏgâÞH0PÉ/s­õÙeDˆü¹"Æ ¸…¦ŒÓð1‹v<Ûy´ÐÕéóÌ¥‹üjǽ<ŒãOƒy`±’ÄZ ~´ÂNò=„¬È‚ØÐÛ{)FÊN´Ô*ˆa'I¥S;`  )iĈ"€'Ðð!ÒØ@~àxì±Ç8[ùu„I6Â%ó¼ñ»Îí%HFPŒ2l¥cs84{]ø:×ø¯½ö¿…hôä “z`Tb·ƒ V9…±ÜA.,R$b1*–4;FôÂáBÊY°$gÑi=P*@ $cOÚi”ebÙÏ<“Ê !â .à) ¥ÀW  É+b²¨K&8Ë‹™-—^ôöé·n‘[¢[ªëØ0»nÕªx6yòðᆺƶÊàÚ‹¶°0Ö?805:.:£££ÉX¼gÝúÖή'Ÿ|25>Ûizûĵ×_ …¹ß¾a¾røÄIciËšuOì}v¾w8uÔ¶8Ò9κ(D<ü&á&,†òÙtb™¯ä—XœsUd ®Áv–es™Âl¾˜X<¹hÓæŸ?õËÙÀTÃÖÕ‰B†û³=MÁòÁ¡á#'»ºWŸJ½~ç®…¶®×^~ÕWSÅ?|·Ãza43ÀÉ\ˆã¦­+Šo’8WÐñðã)>ıŒ4-j ?³Ÿ’AÖÔ—a´ö µã›Ê]‘D&ÕŒ­ªÖrìŒPöŸ•´H \;,FŨ# b™¿] È%føÀÀüÆá 1ŸÉc8JBŒD!Ç®kü®}^tbF‘…i"—‡<Ç°3Ûç'_æpüfYÃyi5Jh`$ÆbIS,ãhÕ$ ÓÅ(“khÀ¯@*˨ Wˈe¹š]Ë<‡a1\X¢ì1H‘ÙsÅSiŽŒ»™ª‚“‹‹ÐK{¥Œh4±]ˆ] Ó{nÍMWíÚùøÏŸ¼ø¢íÜ/ÐÙÖ¾º¦Ó[YÁ}Òhñy¼œxÇ–[.™æ~ÿè¨ÇåYš§fã«:;ï¼û®WßxmhhÄ_é^œO ÷özãÍ-›6ìÝÝwðp2ÿäÇawí¡ý¯3)dæÏÞbé‚_oMU¶|¹°˜am|̽4½0WOUWERs1~«{ý¾bY®Ìëfê~òøQ¿ÿÂk/¿ü©}{25®ö-kø!@ÃíW³ývpÐÚºÏâÝê®îêÚêááц֦±ÉÖŠ{xpI>^1«Ä!Æ'x‰ªÑÔÔ——_|ñE\ÊZý³Ï>‹Öðð Œy%7TÛ}¬zY4ɹJh!¡ªT#i 3€7¹¢Q,!¢Q³'†’"+i¤‘TçR.xä ¼`‰5¼<´zzzèíïÿûYÎY«®$.b’´@œ7^Q ç¥yçY•Ø$MꜴ>ÂešÁV~–÷©xŒÓDššƒÓ‰1]åÁ Áà¨$††,- "€×"ý÷c‡l…<,4CO.0˜$Yôy¼O½¢¤hOÂB’ É‚ ƒ(Ù†ôJÂEC ;——X¯²¾3áRØ|¡rÙYÁº¬‚Ï×øX%é(¤ØSï±^a±š–v.sÂÔÜRrý¥[3eÙÞ‘ÓõmuS“£×î¸ÐíXêÞ¾u<6ïÍ-®DË}ùÚѹÉ^ùÐx_±Ê5[HW¯j¸ã“¼9täðýɇþ$ ©åMm½úlÙlÆj.<µÐã‹ìز} ŸpÜ•ñŠ2‡k¸˜È7¸ÂõîBqÁ._ò,§çc•éâd“3×àHvhq3L:–BÞPhº0¼û-O¨æ‚m—yÍ:_ñÌ-­m_w݃÷5lÞ°nÇöª`Õø¡û~üóSÇO½îŠXêÎkw¹ƒÞ$;ó©E¿;YQ–õž9€¯â7büI]à=ý™ "à^¹€CX½g¹”J„’2ÆS²ÔNCó!LS_&)$bÉ)¼Ì@#ڑ̘ÂÂ8YôÑP$JhHJ8`ˆÉ5Öˆ4ÈT IÀ`a  ‰©˜MŒ4D €QeA¬^U@Ï6ÒþèG?úíßþm†?cƒ,1=9`LR¹çÆï5œK FÆ) ݨ¡o33d»—cqN3—àž:uŠ>FùÉ’á’_`¡ò24F¦Ü'ù+JehVdáu{ÕÐ ¾#F;£. •…£…,D)œEXÞ#ß6Yv$4"S¬\b–¾áÈG}æ€ùÅ\‘ep>=àvÝx‚çm«i\n.¨ ÕV_qí5o¾}( %³UMõ‰|6:zšýÒ<ú¦f£]}E¦Ö7<õÆ¡äì\}G³o©Â —/縧áõW^ ;+¹ö‚e;Þɇ\þ\26Ú;PHdgf1ñåo=ÚØÚÆ7vÓó‡#UÕãÓSeUîšæ:6är=[åXâeq.žâD=î·¢#zøDgÙÉJ+oÛ²KE¯ÃK&Ž 7Ö±r|¼¦­³©«ý-Ë.G >´ìãD˜rë_&“̤›:ZšÂ5Ç£Q>ã©(í¥áÙ¼cÉí¬à=D¡Ìºxat29·K¤ªZö¿z ïÈÑÚ¦>ûm]Û•Î$q{åb–Ý>ñÙÔþSGʪ»¶¯;qàÐì‰Á@9»\µ_¾Zá^{R–ÏN»ì¹ iV}”ú(@)¼bLû᧔œÁïdYšÄÒ>È¢ÅÒrhQp‘4Á¨#ù&–|D‰võÀ ™ÀÈ$V³„˜I*\Í+!Žñ 6çÛ@&-°Ó’Õw@þ¦á7îóØ*ûTlyD¦(‹Ùþ½÷ÞË3ŸY³vV° ˜ß`tE•bI€ë)EãìW–Í39È`Ù.žJ..¯¿ùÆ?ü“ÿ^tõÛ=|hÃ…Û'bseÁÊ_¾ð‚»¢²ƒ/Ý{zŽ~+â?ÙžK/¹“'OõÕ×6x‹å‘@ï¢cÓìRU ÄÄ¡¹¹Õ‘ud†fx‡ïs{§ w‘é•‹ùSC½¬É‡jî@žUwVY?4‚¡`U0Ôwâ”Ïáòƒ|Ç/“Ln1èòÃþt"™š±²æûgår._Yaý¨®ŒÔ¹â"“†±¾«¥Âën[ßÃ\  ºX˜8>à©™nª‰ž,fsn6:­* ÈÕv? /ÊÃʱÁ2;¯rÕ¢ @ˆRHÉ70m’†ÇœwϼpåíÀ7¿ùÍßû½ßc].M™'BOãQû”jKFIi”.è& v‚ØÑ+h±<º4 ¬]»–݇·Þz+–ÐóÅ…pˆaTJz0c„à_?üÆ}ÅÆnÔ( Ò < érW—k{¯¼òÊóÏ?Ïë¦+øŠ’’ॠàᢌÜ!<A€)¼¤Qräà;h0#Ÿ'(Oø¯}íklZàe¦>¶‘ìòW´gHÞžkÙtÖ*QkÏ -®t&ŒHÚ,ã9–b¹_Ž{,ü³eÅëný­?þÜ_T8+ÿçw¿ù³ü0â÷-LGÇæfè‡Ó©˜ŸÃmr^†qž?ÎGÞd‘3p’³±5«z>ö‰ßye÷®«ZšOûX¦(wfË–Y0§‡Æû‡S Õ­M싨ŠTÅùÚ͹TßÒ0·_,æ-uµ!‰Õ2 €]ŒÄ†^2¡áiO›áÉA'g‘ŒFòÀЄh]ÈTã$FÄ™Rm’P„XiÕp!–Æ @.m]š ¶JCå{Öë®»ŽJ~¨ÚE!b¨©C Æl§üuàÿHŸG®¼f•¾4íCaˆ) …Ä,41nq¢O~~ä³ÍF :?ªè¡„^r`Ç;ÂK¾bðö±Ñ€# 1ÀÔ!À›ø‡È)z^ö Hƒ«Ø#Yd¶«¼‚Å Å¥Ø -bšÅ™ÆyF¾Õa–ø~•Ëœñù2•6]vñÿý§ŸÍ8ËÿÑ¿2&zù&êXÚ¸mÓ‹_ã‡/¯Ì88ƒæ2ŸKúj#å¹rÂnn†uó¤}ûØqÊåÌp€•Ó 𾶮arp¤2žn ×ùá®à,;&‡O9‡Ò¶·´æy%ȺÎÆ´§Üð¥bo$ŸûÑO~ÒÖÖ•\H¶†ë¼Ë•e•å1§;É7ö 'N66ÎqÞ¦,æ½A2›`×@&ó<Vð÷yDËc“”)‰¿( ¥”PÝ ã¸ƒ…ððÃ÷÷÷Óÿy·Ïã‹VÌ© ‡XN±LŠ-v 0,¨Ãx–\^cb +º¢“ÐFŒKæŠØd!™@qÀ(Je)&Ëà”´#ùao~¼0)w¹}2ŸÔVÝt×û+ýá/>û¯§zg ÙJgY&¼÷®UVGƧ&êêÒ“³Èa7^Ö]>“IðXàÎø%··XQÞ;6<ÿ‹ŸÆçæœ, æ–}>Á]QUSŸœ)Kr_…ëqøŠ-Ï/ëB.?ŸbÒaMß«‚Iƽ:?T]…D.ÕàóÏf¸+;›œðÊ›ÛÛ3 :u†ÛlR¼hÈd©|óŸ– #¿þh«À8Y/ÙÐÊôž—Ðài`zœðã{P ‹#\æÛZH Æ>ˆYíîêêâ©~ùå—ó’ÀâMTÖÀ.ùD8Aå2ý{ WXQ–_3ù÷yŒ0îÆDd´ Ã8„•”ÖžL·d3fPôö¾¾>v\q— nc6Å;R„È­ˆ"HÒP½¢Td!Sî` $—;n¸áv 2Ž 1¿?q·]»r c’H6Hkð²Š,I0¼YiÍ^kxZÏã)Nµ3>açÏoºhǮߺ陃/èå{G,Ƙ÷}à–uÛ·|ágaçìÔ¼·èàîÊM;¶u+^åÕØ̬Ïጥ’ìxÉ¥†úXùÇ?¡P5ÃP(Ÿ_HŽO…+=ÖETyΕvq:#S™Yœsq‚åÈ4ûï\­Õ®ga5××$æÓõ-­‹ñ¬Ë¿œ)&Š¯%^â°®²±.·+cà.÷.U¤ã‰ìr-ú¶ `mx~‘OróËÜkµ\†Xá_ˆÆY˜la}1TóÖ♢ÛˆlèâÇL.TÕä­_\ÊÄ“ÁÂ;ÏyU®|H ?3ó«Uò?db¤ £\ÃeÕÅÙª i²ÐlèêBüú£G¡Ý‚á‡}{{;ß®0"€„NKL@©i™FŽŒ! @,F',ðvŸèì“àì9=ŸŒ1j½jÉ)]$¥N1­á ‰!0Ä¿>ð÷y£Æ„2Ê¿B%.Æže`•ŽÀ¬JÖ*™ð³Y7±ccc,¹‘dŽú`¤TMPHŠMPiåta$˜å‘Gá5¦¦=ÒÈà¢éŒjªB`ì$Ö…71FÈÐkjÅh¤ÈR-'›R+ÉavVuX5B®U% üñ¡ ÓõœcÙÍ55Îåû?öpÊ‘{ãØ¡‘#Ç'úúÛ|¡;ï¹oçoùÞSODç¢a7íˆý¾¾±a¶Í` 8â¤øˆµÛ¼ÚïOÍyá‚k9ŸÌGü!>}›à㯇{ãÝeåV˜ùíϾšÅrÞµ;l¨ÈΤ¸¶ª"\áéiâÔ^$Wz\‹YD'ƒE§§Œë_²¼oÛ´vßëïíï›™cb©ÒzÇÉ1º™¥|uk[YKÍÜÜL>›æõ[µ;’]HWùKåîøô“‚ššê»ös™d|Æ 4Ô5LðáGc“¼f缜šU T 2'ƒ”E Œ\-˜XÃ7¹ªbáEL…Òfx&‹FŠ PECC¥Ó¢Àˆz×ÃDztÏ]pþò/ÿ’g_þò—Ù DÛ@,,²D¼"Ì’‡À®á¦¦&žç¼ùëîînllD&3y1ž7ƶóâ…D €btH*~®wËúûü» úá©i…Á#<üwîÜIeà\*€g>C/ï–xJ3P…4 „—þ€—éÒŒ¦,ìرcDÃ^õa*@Þ§¦q4s6b-™ €ªÕ0o†|#ͼ›ÇU!´Sõ¡Ã ¥‰1¾ÙózŸøé“œ*ëá(\Á¹XŒ/xïõ¸ÙÔã*.ñl6·X-&’þ² 6Ø1.²óg×7¯Ú¸.‘Ë ¼x„a4Ÿã=?îÝË™ÂÂàçj•U•Î¨-/zÜóCS¹¹xpÑUÈÊýå~ð×^t ž©®®ýÕÏùÓþ˜WlŒË‹Y>’q‡|þHda13=6ɾ}ØòÒ‰òKLécÉôÌè$7áqõµ#‘æd²|"³Ä@Uéi©kœžœa:£þI,¯˜v, •KÖŠÎ@®ˆÁ[®.µ~((XhNày&SÅ îñU¡404$K€^ZhW¬DˆQuMÖe—]F£â±Á‰ÖˆL±“‹4bíŠnOLy¨y# @0H ÿÏŠÿÓú¼)?ÕC…äüH` CüähCCx7¯I8¹Ðà}¶ ¨À –ª¥oSë¨cßIú9bi0.€§jP:»¢’敪!¥o]žj.±)fƒ€"Ûº;>ø‘û~±÷™Ý»wï¼òªëº7¬Ù´ïWöœ|}86“ȥǎžr²oÍëÿȽ÷¿ôö«®¸rýæûž~~0•-Ëä*|ç1•s¯Ëg<ËG¯•7}©²°ÄX,×ßó;°æÇja‹ÇýðÍ|ùK_üå/Îp³Äz6ÿÍ.Ff}Í«â…«ð^žõŽÊtYe&—n®©{ð¿ý6G÷üËÓOÔ×Ôº Ž?üƒßç3»ïï1/ÛQ¬sê—Fúݹxuc}°®9:1e]RS^>K†j=•\œâú>¯¸“À±˜åEÁ"SŒX,ÙXU úüE‡uHYÉ[Vd*Ñôê$±åÀ³?ÜJŽüwôâEˆ2O¯£Z©bEÕS›Ô,=Sléœ$¨k$@†~]BF¤´$,…"M†Iã¹-bS"`‚Ê^íÂ%çÿçø?­Ï›:6ŽÃ/ªoƒÁ–ÛJ•jêØøT¹$!`´0þ-1Y^¦"!ãG¾ÕIÎ.¸žE—Ælˆi"Qý4f Æ ©&Ë„œÒ¢GËkÓ%ËY…gb_ |Fƒ1‰|úÿcïÍÃä:ªßÌ›ûž•UYû^Ú­]–eY^ec¼1سƒ¡éGÓ0tÏ4ݼf`xÍ ý> » Ó0Àk> Æì ^d[¶%Ë–,YkIU¥Ú×̬Ü÷õý"t)$Ã÷þ‚|_}Q‘qãƽ7Î9qNœ8qÎ;|O°«ã«ßÿ÷~èÃý=ƒé¥Ù™ÈÒB)9²4NÅg&§šø ±¼ý­oÚwôÐu{¯GÆÅIÖPßòÔ\óxøïšÉ%Ò%¬z‰oƒG­üR?Ö¾`ËþÛ Gçòó5[°u;F>ù™ÿ‹°RûŸÚ‡ Ñl5•óYk®˜MfN‘0™Œ6+.;¬.ëÞ{îØ{Ý ÿô'g£‘9¿Ÿ©g)´°vÕjv8~ऋý0›í‰L[G«Ïå΄SÊn`fSµˆ#Ì‚Á‚r)Áa®ÔJ¹‚ÕfÆÇ@x9Ä<¥ÞÊÂå£*5Œœ j¤’Õ8_Ì)H½ä 2˜ÄÁ `ÍPQ nPàFQSCç\"'ÑíYNêO‘JA*éÛå'_5q/ÐŒ-ÉÁ4 ¤•íuâ_Yù+¿: þ0ghV†CF™œ‘½äÑT’¨¤¥(Sà^i te 秌µÞL°F@+ðãÚ Á ڀʬ {ôüƒÅ”Ï’Œ\zÐsy.¹$½žç’ä§b†u:ç§T×ó¾%+ÆÒ•{®ºç¾{Ÿ?~fgÏƹÄl¬Årêì0'ÏgC‹ó‘×b7d¢oyóWoßõÔ©^>íh ŒŒÅ˻Ӥ ´•‹¨ËËš e<çUìÖŠÝœ.+çJšAZ³fÃö­?þÊ3Ĩœ]\`½³em.ußógï{þ…ç˦j²’-»m OÍŒ&ÍöšÅº~ëÆ¥³“‘Hô‰WD—CKÃç³ù\vz ÷ØŸùø87Š¿>‹ÇaÆ×M&ã1ÀÖ™G¦òÙ¶®‹ÝR¨– cÁ r£UK³ÍÓ08,bÙS¬f•É*ö#Õr•9«L}¬ôdqâçê˜K8 ˆª‰|q9e­™í¸¬Á÷dÒh2º›}ÇOŸú??ö·Q¢É͇…Aã{³ßüÎÿƒM$1is*¼M Ø]­”ò£o*Ê¥*†7v£ÛÒÖ:pjr"rv‚sA(Uìr¾xŠÅ—–/ØLyô~¬ì­Ê ˜3^¼Þ`ö9bñ¨Ñdqš‘ê½N¯;S)2+pˆˆ9¨+rù–@ÓèÒ‡þ#©DKJ4=1˜RÖÇ–‚^æeÉ’)¹K¯”Ÿ€•w£Œ¼†z»0Êû÷ï €•® `r®Bÿ ?DN%gö§C=5‚“<‹JÚS¦^Ú“ä¹t%?%—6”9¥s£V¶ü×KäøC>žï'ÉÐ0j<šÑ$I=9ƒxäÍ$]þ†2s#—B´”–Æ,ê r:”Ÿ@NžKç`3WÁ6±ØcCEëW¾òB—!Ð@º½ä¡ôO@Z^Oo mR§kHÒL.QæKG°õ ÂȪ(ŠPÔaf‡çIKÀ½YŠÎ,àwʖ̽ë÷Þ²ýÖ£‹£?÷Äéå¹õ[618ÙÇœ'‘MÌ.ºC¹èéóá©Yäv<Ì!W+ÝDµ\hv†Íœ²ÑŽ?ûÒÌ '=¡œ+œ3ÍÄ~üoýëç>ÿܳÏ5ƒ³¿½ûª+ìÍÉ*{Äu°_}ö~T|}-þý8åÐ|ÎR!o®T™ªq™n²z7ôaZƒ7NƒËfo 挩 µû:[*~[Õm±xìV—]S¦ûéH&nmrièa{ˆÓùŽ¿íŒ†©°²!чneA(ÆŠ$?õ\jêW~“éWWÔhÔ]J²_K¶ÇØ Ç¡ÛM7Ý$0E¬C}Clļ†`ü@§y¹*ØHÿ´¡,œ\'/O™ìañä^.QÃ%Á"ÚKcùéä’ÿÑø<_+£Æ È(ð“‚ “>ŽÒFopÉQœ¤Rn—òJZºÈutË%éŸ[€ ðÀØäbóˆiî=8ýïÝ»÷ øùÅC i`òÒ?e'åKrU+Tÿ°ü…çÓÛÝ<7Sɨ ¡×¼Öbа~‡“³æGŠ¶ª[V¯Û¾qóx~êñýOOF]ÁÀðاұDª ¸ÊaûŒ»³”zµcùÙ³c“ûO›Žt8i÷·÷¹‰ÂT.•»û-oCüíã' >G©º »:Ûªx©$\½µ’tå´n_®¿3wEçå夫P5— n¢È_Ñí[Û×¹cCÖk™™›.Í×ppo.à–ÖœáÑ­3›˜wÅq†{ÇŽûÞÿºôèTrq!YZ,$—ÍÅ°5“öTíX¤Ò}-ıÊyLZe,d\ž¬ízýÞj'O{S,r«—cÉã <µ!W$®vÈQ,úmÆ…x·18Þçĵ†©X³•j.ƒÅeRº¢èàtódäY0º°M67ë+,¦žë£Íà“h8Ôx×4Ù5E¾Ã® çð9|Cl|=0ÑØ÷…·S¦ÀíÀ=zü”nÖR–üwѪ ƒÞråÏKn¹¼Oý®?XáI󘔹\?7ϼý£³áöÕwÜqÇ>ððÿ‰'žxì±ÇXf~™ïõÛu˜QÐQP`,?‰ÓX¿¤P„ð!˜å 8D#ážÖ/å˜àlVüR3I8ö‚±–H¦'g¦_zù°ßë‹%S8¥'nÄÙ±£N· ½x óOFb,—‰VqlÈáœCE}g¥ŸJ¸|ná ttûÙîL—:¼Í]½Ý´ŽÛkOéÜ Ñlìxž/äLf;>¶,lû—*hìн™­ÿ©|éÅÔêØ®Uë·_½ƒH³1Cž=vÃ^»K 9ÂÓáE¼î[lžèbjvi¡¼€ÿ;k²P¬ºÕîIµ„iq™?bçÌå–šNbï!;ÇkÔp“јɊ›MœóeÄŒ™DU‘ø¹‰‡Â[ù¡“ÕgUàÂp ýÔéZ±Jvê©Ñ žŸ¨l±Â¼ñƱcðÁiÙ#Ä=ú裰qYx#ú12ÅK·¼9.!ÿ“þøÙ¨©Áil„ ?I⧒æ´?‚= ?ñ¦ÌIûcÇŽq \ìiÏ]úíR–Ÿr‰\~’WéµÂ×:Kð&¸ÚÍRûF£cA‡§ÅàIÒó3©ÅåüRÌkG=X¿ñŠ³³“âF¤2ŽŠ‘Ãw«Û»Ÿ›ÿU¼5™M§ÎY¿fm%èµk…™έS¡pçP?c+6sÞTs{1ůµ·¶Ýyý̓þöÍ4yG ‰¥lìÉÃœ:VuÛªV#ûÕŠ »x*ZØi4ç˜rJZ•À½û_9|èô±Ž¶æÖ`sGWNõ:»ºpȕʦZÖL?JÄ6v&s…4§”ü}}Y‰KÃt'ŸÍyk>§ÍÎnvÔ1[+UÙý²• ¶€·l3MÅB8çlëêMÏáNÀíu— ÃѲé¬Õ©B$Aä £‡¢ ½'oÇÔÉ@ª±¬')ÓR’ÔG’@@CØC744„Y;cŽ¬Í£ÉC·ùt·ÐXÍSu©ÛùÉÛ²¤Lÿò¬ÆË–æu˜¡·®2»?ê¡vˆTØÔÀö±¬äÀj< ŽHåÈAür‹žSø= \AcÂbru·îÊ:‡?žTª)·äÏíöo?þ1´c¹Z~)+ų­ÝSÇOîÚ¶£;ع‹Œg²œZqTq‡œe”gf»²$Ùºe³:QÃ^ºf„Öl[¥\Á¦«Éudó¿¥eÃƇ}b~jabªÏ׶45ûrb:[ä!I‡Ëž-mlª•ò˜áh6ó3Ä–Ï6¼ª±R¶”`ûe¿Ë­d'R‘©d¨:r’àyf¼ͤylÍmKgÎ/›qz˶­^“m)Ÿw»9·cOXHÃÜ5åò:KflöZþüB9•õî` %`j4–ê6'g‡Ê™é’oa=/@¥Ðxˆ\(_ 7•àvZ Iæ{æÚs— –Ü.¹Ô¯,K 9*(½%îU¼¾nчYźe\Ø°\3ÏæÂÃc §ÎÅ™68Æa)ëñø2yL*˜Ö¢+drÄ&² 6ÍicW<Z&Æ3&·X×¥ªÅîMk}ëúƒð„ƒ·Êd.cv9"ÙÔ|b™g#]ðù–bÕ2—4NE-Y%)§«•Û š©lÔòf-gÑpM[uY9O‡F«Ù`MM-ÄÏÏ`Éï2Y•|4êüa¨o¶rÇ[3ûJZ.sû}V¿'YfV²KWC%“ 8ÜôÍ`2¤ØáBLÞ&?›ú8ÏM”cY|eúÞP.K&ðxÑ»­M*”|WÑJdšËÆ¡³Á\ËÄÓ¦R•Cz,:0%dì…ÀÔHÖ™¼Ì•õÁü-Ê—ÁeiFÇrU5Œ —„ŒߨçÃùáêTÊtX©ç§¬ðùF~ª/­/èXz¨w¸(Ê[5RÞÈ4 I2»SÀ@NLÁ¦|j×/ Æ(ŠªÛi~.‘( ¬,ëh‡hÊ~@OT,íMJ£þ@^³…ú‘ÑQÄ¿²4Q¿©RBðñ91µ8¯5[50*à Àîä5KÙ"΀<Ÿ%½ÚàD±‡Nœ(Ê»`I¥¸jYСR@ 9õܘ¨ CÛ”yAFƒД–Jºâ'e \=ȹÑ€®hߨ©‘i˜ B"¹Ž%zY@+8DY5­ƒœœÛ¥ý«‚Ÿ+¯^(++{#†%°zÜVP‰3)r,Þ8{#ˆtµT°“µ‚ÅaÁסÉ5©ãéPžuX¬,®ÕJ´TAë¾ûÊ«ßñ¦7ëùGc™ÔüùqC"ë@E£V(SÀ ƒàU#.­p`?¶áj³CÞÖÛ¬ î¬Zˆoç ÜYC“/™ŸZtô¶µî\ç'%ªl,ˆJŽñg‡§+¡TçŽÕíí]­Žî…L´P䩹R¦×ª§f­EÓüÙ(®Ç0j1á–¡Àaµ¡ÿ¯¤²®ª–O©].Üì1#@BxûÂù%Ÿ‚;M”äÌ0Ñ\:?²€W\œÿáÛŠf{žÙb3`–¨Ôv ¼?3&L—¼Œ3Ýê—¤Fr8eù)¹Þòò‚P>o µË”e4•ÒÏåí ¦‘i´ Oä€ ð_NÃTÖ[)Ý@šŸ— ‹ÜþÿØœTã¤:c}ªÔÀpzäÈ™%ŸËí¢ùL¢‹iƪÛ綸sñ¥¤GíN›R á6Ò±oi~ˆq6ƒ¥†gºÐrt)lóº—fæsKÑ@Å›ÏØ÷ff1—k•£Œ÷* =9š5,ðqYa€”ï ƒÓf1ª]6¥…Ÿ b—ÑJMe61¶x }°ÏßÖŒ^=MÄGgl¡t‹Éžž^ž %=½-­í¬Ý˜-ãV¯¬å+µxÊ›Fü¯dB d gÐêuLÎMùž£1C6ÏjŸ3tØÒáù+W)ùœöŠfF5˜CNøÉ&ˆuJ« àt•u IÝÐû;—Óƒ-#Lc5þ*uçB"Þë#\tÐ(u`émôz^*å½Á%…z—Ê:“Y ʇìYÏs/ý\Ò²a~6,ÍK¡Uó~?¹*(Â-$îU¤zÙ2¨ËUüúOiL=vh´‚ìñu ÿ¢±³6·‹„}ÃÂÜÜÚ-{¦—9UŽ Ÿdµ §3êä6Rh!«¢²9=†ˆ¦Œruóšõ/;‚£[ŸËaNKÙ<`cýz-gà ›C÷Øü–˜» es™¹Å¢k¹L¶ÉL„Îãî»ÕZ¶¤è­¢¹-žÂØâ¹Sãl( ¨ã¨¼£œ‚–³1´¸`z]-¾î 12ÂË Æx±œ,ãyügålfÌ n‘ EÝ…j&WF\±[Mn«Ú׳[-ÅL>KT êü" i8613ìš=‡ËÛðNÐ5ûX)(j/(*Ÿ/Ë ‘T™M{6 ;ÉÕ ê—t(ðK¯_Y¹²üÛ]PÓP©?]6w/iÖH?–æu !´N’>ñSÖ¯R¨_TeÁ©á§ÌrIò•7¾zö]ï‡ÇÁòAdV§Ð$ôU¡åj"ÅâÞâ!ª¡–Ë‚£/¦ßÚ[8¦»Æµ$q°E¿•GûÛ‚…–ñh“¶[|)6ÀˆïnA\.'k怽”Ƶ&Šh|],6“Ëjse*Úr&?MÏ,Ú²e'|ÊU»o1Úœ8äà¬-Ž.ݸ³·›í.'¯š+e ˆm-ãÐ#xô×¹Rd*2¹ÄB èqãðž½vêœó»­8·ËžïA/`Ê3×°Ja›®XM˜+Eôý&»-QŽZø¾r¾ÉÞF„ëJ*M”ªŒ[ݯW‰ƒÈöv³Ú'g^J“O^/d¿Sj¤õ‚\ÒAFý%—ô{_µ `…1ÀäåFCÒ«6nŒÊ†¥yDQɪK8ù«OQi]¥1‰6Ò‰ŽOúÏ߇U8´@KÏ‚BÐWloÁ\¶Žò9‹ o-•øô¦+VM¤Ã˜èd J&·pÞi.˜k‹Ñî:XRBáÄ®$NF·íá@h ­3ö= ŽÊa¶Fh.¼ä×’™ŠX8ãÄ{ÑP4˜‰ q~)y~¡/h˜þ*D¼ñ¸ÜN› f»´ÆkZBãJЂC½¾¸1žŠ'iÌrˆht~tlj|j9Lä+eD¤$Ô´×ïL—€O@C¥ÌÑü”î×Ëzae§ÒŒ»€¾èð|á+›5R¹‘i8Kì®Å®^rá„€u$ ™Àž\t~€_*·äzY pz“N˜PV!ÖºM,ÕYªcá•\7Èy´éÊt…Ý8ŸÉa.h•Lqô·¿þ¦Å®°!Y,äúû_:x¨qYCͽª]—s"f]ÈÎ䊆nÿK$dN£¤eÚ„á]¨Á0ßk±ûç§C­«úð>ëLµ µH2í²´­ëé\;D<Û‘™æBÑ^A&0¶,f¦’ÍïÁ"n[oÑ—Ù¼zóæxdyzd‚ ‚©à+k-©š}>¹HhÊu½m›ˆ_aŽ¦‚Óî›®ýÉ/A?¹¶w ·©Ýc°…S9›ÇFl lh1(Æ«&¶ÅTÞî2gÜFŸ×?^r—³öªñÔìèm[o0TÍ-ž—ÝljÛ¾i[6ž,ç3ü©éÑ…åðù)¢óMÇBiÀƦ¡âæô_}u-–s¬õu |gæ>¾ËOŽën¡=Ú8”ˆ”™{õ$n§,P°Ò€ŸÒF ÀK.5dÞÈßÀ'8 )oë%€¤ž½Žмԯl ß+DNç;¯Ç?bH dDeŠ¼Ê»®bñ ÛÇ…Z+dYš…3‰g0¸í¬£ý-Í©LšÃªáX´¥³“µ@*›_œ3& ‰QïS,{Ý¢”k°ÛíóäñÙ—N9œŒíðôÖ̺€²‹='só`WSgÛüìôØèx;­Šv T$Ò¼ËëY½º?_*Þwß›ö^yÓ÷ñ¸Žùû¿ü«©©™¯õk›îºûÀÄp~a¹26Ÿ%’ñ¸7I¬š Ž.úZZ6_±ñ§þ‚oEßÖ·K¡r¡ìBëŸÈXlª¬¶+òxô6 ¬š›˜b‹Á¦™sËñªf^ÐjC¦Wó—8M£üqiÅ2K-N«ŸQjèed XZ§¢q&£³çÏÏÍÏOž9Çñ˜¹¹9Ö léòjªeÂå.¶<˜p+Àøãø€°HBÏÀ…„|y¥ÊeGåÜ@“áU#|qá t@7^áÿ/4\˜Á,P‡²Ê.§^àAùI~ê'¨„ÎA;A,¤Aø 5ðyÁB»ÄÙåCJi¤±ÅÃ"þÇ£ñxµk<Ÿòu6íØvèÔQ—ÉÜÞD¶ŸM,— Evàú<þHb¢–-pÔ“Û¾þXj¶–ÁNÕ‚ËË€Úë kyG›ÇÓx ®ç’Ù\¢š ´ œÑµ¶ ¿5 3Óø¬·biâ°m¸i×dxšyïoß¾nV1°Áƒå]¯yÃÞÕÛŒM½ýMë>ý™‰ÙÙ‘ØÒäôR"•$ô ‹‘4ÞµØ'€nÓÅuëV]wõ5×o8ŒµPf.žËÜûöþÇ×ÿU™å2™lÆçrFæ›Ö÷±M‹'­mZ¢°¡wÕÉ‘ÉM[·,ÅR§Óó;ì]VæRÂZæ2D ¢ˆz™:%Øó’þž¾î¾þ]»vry¢±ã,dxxø›ßü&|©›Þ@fŒùÍ7ß[Žéq||9s óÄAdR€Ô€c(—ÀZÿ©CY¯iøÂï‹ÆøráóB±:¹ ˜õ\¾T®ê-¡UÒïiL‡á›aïÞ½`Gt |˜*ÌJ©›ëöhæùɉ-ìŠòW®ylkúo¹ëµî&Ín½õVæ œÉ¤²Ä™+r•µì™óBqõO>S b$ñ¡Ð«WÖ 'Ý­&«×miò0¯`æÀÊó<³Ñ9ÔÕyõæ”Ó4— ‚Í=Ý,p‘1&çfü­-[vîX·èmíAšÀJØe±]±v=¶°¯œ9þØãOìîÙûžAQÏ]¨C9¯ˆÇ`Ê.EkÉìÎM[Ûu»¯3äÊ-ßü£n½åÚkö,/…ˆ’ÕBü¬r‹ÚRš(ŬlkåÅÞ{ß[{~öU,¦S¡iø8¶úÆjʼn÷N¢SÃcëÎ<ù^LQvŠ–®N:ðÞo`„ ÿtûí·ã³ŒÆ¼LÜ´ª¹tÝu×*ÙàضmÛ7Þ(²ÒcB{òßÊ• ”XYÓåF¦y@°IKèŸ2Àê_¨›žh Í.Éé "ï{ß‹C‚íðzï~÷»!oø?ôĶ3¢½r‹¥¬òÔ}¢nËV²Í7¼î6¬` úŒêŽ4?=3;6‘㠜ł>œhg*LIKDcëû‡º¼¢Íš ,–q;ëGýfáìz.—¶TÌ~6ðo YËà .SÚ¥•Ý–¢“øŠ;൶zÓ¥ÜôðèÜ©‘g{ü ýÓ×öðéSDÈyìÀþ##gúö¿$Ã/ÏŒ½xöäѳëZ;pÄ•e•ÏºØe7âè2_Æ+F.š?=JìÊCë˜835=óë§ö=ø®wÈ9Š‹8ÏÔ8åç˜O‰„Í4—«·m¿vidŠM¾ã³ãh÷  ¬U=¸Øç/f† G^²ì)ÿÊõ&®µŒÅ²ÅhpsdàâV9+°hIÙíg ØÔ„ìÿíßþmëöm¸#ê1.½Yª r¢>9PF4ܯ h©X¯l@ÍÊŸ VndšT@[h^)4/¯ÓüJ_^–š•õôLpxxf[[&ÈÇ‘8ÖÕ-ím=Ó‰"ve‰§&yœÚ÷­•ØµÞýÚ½½­/>–,¤7]µ#‰,MÍa²ïe¾@žÌfðãt»yy~rúš-;,e-•L"x[¾&?‘ªüv'ž18`ÛÖÕ‰¸‹ +]¸%H—sŽ¯ÁeYÊÅk­ž^ïÌZ&_ž[$J4»ô<ö«ÎþÞ`G»Íålïí>zúä‰sgŽ¼|ŒUúÄ©³©åvðfŸ«â¶¹Ûšùpvð•÷³üä‹ÿòЖ5Þ}ï±¹E¦˜ï|ï»Ì>ïyÛ;‚¾&kÍ”¯{ÐÏEâ½ Ï-`^`µÚ¦ç· ®5¥ñÇ]™˜š|qòtÖX-›pgƒCaÿ?̬ÀÁ½K#\ )ÃÜŠš%@Àqe‹ïZÄuõ>8ä¨ÇœÃ£Q èAÉüfó5×\sÛm· fæAîbðiOá÷Ó­`ˆàí¹ë÷·ÿ“¾júÔ§>õ'ý¿ÿåYò}÷»ßE-ŒÔ ,AÖ±ÜtùI’²›²^#TúªK0lÏž= Lž> ‰1]OMmAÔofìÎËŒK±H³‘-Ø·Â4Á~Óž+o×›þìÑTW7ì}M6:yè%tæF;æ.móÄ‚ÄJ±¤wÌ&ëÉÓ§6]µÝæs.ç“%CÍW°WÓ9s2ßæ ð=™!w8~k‹//»N¶ ÊղكѯÌ>EÍìo &“ñJ®ˆSÍèbˆã«±¥ð¯~ñË_ÿòѧ{âЃOþú±t<‰! cçmØ6·ÝÝ­¦f¿«%N¤âó!Ñj,V±ùß{ãMwÜ|ûêÁU/½ðb±TÎF“·Üxóo~3«î³ÃgÜ^ßΫ¯ Çã0´g'Ö…ÉZ‹gŸy晼Íd÷y¬åj×P/.8ÀÆ<BÄ•«ûÇÀΖC7HB5dq5cR"”6“¦²_VðLÄÛ4”‘ÓPÝAùðv@UcäsøÈaVþ(öxÃÞ™B™‘–ÌPn'éÀ¥CÊ‚4ãöûï¿!NoÐ`…çóLØ@Q hEƺu ÿêTüTJ3raúO ôr\{íµ,8á*¨—ð¸ˆ& [òDµ@­'éö¹\¦pà­ï|ÛS‡ŸŸKFRÅlkG«ÓåÂßâÔ,ËW§×“$L¢Íš¯U`õÜ‹GÇç÷?»zh àÝ^ M—ËäæFƳ -•?wäÄâù©R2Uo:³4–Äl»Qé9µlµ`nr¶¬î){,ËÙj¹6·÷¾Û^÷ï|ï@kgxnæOtík6x8dW¬¤ ‹Ûæh ý®,Vs6K»™\±‚¹^Ýô¡‡’»÷Ê=¾ã]½í7_wÃc¿|Ôa¶þ—þõîÝ{þ¦»ï¼/Zº qÌÞf™žDZß;HìMK4»ôøÏ=;cHj[qX,r”ÏB8ìa;óBb|ë–:ÉcÜ lƒÌ’ž¯Ð¦îå;ßùXÑ]0Ä…'€¥x ´èJ%?iÞð“DY®J3jø 9wî9}’Ø(Âaîlxopx’´Û¬ÅºÏ Ù¨9£jæ”›YÛ~Ó5O —9_šmn ô´÷ŒŸ=·01‰«×½o¼ÓêóLLL TÒ9ÎÞ²«Ep˜h>íi l¡1¸rÆ¥ñ©ô䦾UÿíãŸhï>ôôs„Ž „æ´vâ9ëŽ0Ï‘t“ÓêŠ@²7†tMnÌiÓñDhlüØ3FŽŸLGâJÉÀKæ‹“çF¡fö)GÅÒìuv·Fò„Þ$:>cΕQ§µ63ÎíÜvë­¥b¡9ÐLXžm¶dS™'÷í»áæ7lÞ„OëÕ«W?~"¼°ØÔ°¼ó‹K¼ö®Û÷Þå|àøt¶Õyvòü|4Ô³ºŸ ÖÕ q/Êhõnd!N$–Ë%í«éÀŠ7 ¬ñW¬‘œu¡¶ÀÅR_ä²9&Â~€¥€E¬c €ðéh|—Zpƒ¼j•½ùÍoFM#·4^Þ°|^ÈRÑZKóºÒ% Èå’ Ž À˜»]À˜K®*Œ¨'X{BïyÏ{8zÉbjgùpï½÷âM 3"=8J'ÊwÈÔšÂÌj\y)~4CFx|PQÞeÒÎOLáuÛ^—!˜s) ^5‰9t8•Ìpd' ã¿ýækoøò¾è·9ðo; 5WQsk6ŸÝ¡Òyüo ¢ä‰7g6ºÛËÅäD"¤=WonÞ4˜òh(†ÃÓc°ølŒù)g­eÌ•nl|ÖàÖ!×ê®”µâlöj•ÚÒؤ–.rŽ&—ÉÊ ;={ù{»f·wíÀäúš›oîíêþ—þâ@÷ÀŸ½ÿ½=¶šæ«ZÇ&ÐY>ûò‹ƒíƒýÞ?÷e«Ñù¥b®pàøË?v_’óõø۶㌔(5‚ö±óÏ$„˜‚=>t ,R@DÒÎ;Ñ•2àü„³hÿö·¿Í˜ÏÚ…ÈÓØðX*<Èã¾J:l¿•P—¥bŽóó$;ñ![˜àk;{1[À‚™cZ³s9‘pÚH‰LS"V%øÀg£‘ —˜øɼ6—¸‹‚$*%QOº¤R.Qy±UþoX>Ø€(䇎­\…—z!xpBŸÚ©”AzðK™R¦¡z@IDATÛå'nž)ˆ®ˆ2 ª±eÓ îG'V³šnØv‚›òÓ„?¼XŒ3¤4b°¢‡à>½õàÐþ§öåò…™¹Y³Óή>‡ç*ÕÜÜèD—ƒÐðF¬Ò¬N3Këî CÝî&·°ãÎ!»`°Íçm -†‘¯y´qùÙˆ!úªÕî÷– ØÅUÙ7+>YQÇé8Œçdßîù bðJÞ£á§3Àÿ˜ü”me#¡©U´HB[+ÿ¶¨>•nBSû举ƒþ™æN>½nÕP‘ •™ŒßçÃ÷Çb[ššîÓ½ßÿöwz‚íkW­n´t¹›"¡˜µ¯íðÙS§æF+íø‹G;zº÷Üx-¾uFcóèا[Ω²ÉážœŸ}ù¥Ãýí=-ÞÈ`~—ŽFˆŒ3’¼@«GÖ5 8¬ÊÇ8G Ô\¨äëÔZ±‚Ë ù¨ñ“ü’¤WêP¾¤Acü¼” ã«ø àG]¿P,?…Â)@!”i&ÐUM/"ÔèPu(ë?õfÀ$¸½P;]‘ª—zc%Ã+x" Ž™+Ns0,s»ñWçó®ÝQΉñÂÓÏ6y|=ý}¸ÈÄüŠiÔ–§ç9è©h¬@ÐKDö–fsª`‹:]~nhxsƒ §‰ÅgZ¼;]HàðÏÒR¢82.Ƶœò˜ÁîFüì©>o¨†²É‘å…cs£óÕt¨–Mr.Æf(ZjC1à S¥šÍYÔ;³CÇš½ÀF9§zx1ÍfaÂÂý6¦x°úƒ/Já1¾Z&$&|¯;Mn?Ñ):ƒ¯¿íŽ_ýôçKÑP‹£©ÛÕ”š ±J×J?øÕ#¾ÞS¾’ž ŸxüÙw\wÛÿüÈßßqÅNv_>ôb2Í„#ás/>ñÌ÷ÿý»ãÓ±|îà.TÁ «yªXZ½e'T~Ñ¢žKLm2Ap ÈUî¸sû%IS/9ú!]Ò²‘~62Í'€­`=T=*É¥žfr‰«$Ê’ä§`€Þƒ4¦õ4`[^¦0 TÝ*JW’D{Zò@¼MàñŠmdŸÛ_jö7aaŠ¦ «•çž~æî{Þ°iÛÖîþ¾…ÐÖ •\c0mÞ&ÖÌ,þKåQúþ{îË,-ãjÒ‰¯­º ›øööNöƳؽbS,á|Êc±CEóÃc±P”×Æm6äËË`ÁÏÊ÷º8Ö"¦eÖX)ZŒ%³‘°ÊE¶ÅHÐØl9όâƒm³d<KÄ™F¸Ké#ëÇyνÀrQÝ/EB|”ŒõLðUÎöoÛ¸yÕà:¼ö|ð½ïìê>{oXXû Ÿej ˜FlzáËÿý -&Ç]×ÜxÅš5xûÀÏ÷™“§¬L”¹b&›Oe’/¼xm<`lIžËüBÎOBÊSO™OƒÔs>–QVO We•©™{/OÜB%¹$Êerî½¼}ÃÔ4,Í!è$ü@bÐÂä•Àä È¡h£Ž=Ü {.é8!?åZòSQZ}˜2·«KœnÇ®\u” .ÖÙÈüV j=wÅæ)™zû}vçvSpOS~`£~ód6ôò‰£…só¿çA» ¸ä*ûÜÆ1Ÿi ¸ ÍÖ˜¹‰'›óöÿ|ý[ÞØ´Ýän*PÛY0Ñãý[:š÷Ë|Õ˜ˆiÈT»´–à´±õÉÐægóC¥ëT¡5i ¤ ˆU%žCþø±0㧬ÕòØûVaŠ–ZÕF$,t v_Õ˜­XOÅ‚Y‡{9ªÎì¦r)Vùçj^>—Ɔ75-NÈ“ÙÍÔï/Vní<øÌó›×múÊgÿé=;o-˜¦ƒG_x– ÆÊivœ>n\L›£Åj,o)‘?PxßFÇá3{f6ˈY3{ ÆÒb,7­¥‹è‰ŠÇä¥ô|8ºC1‰=¡óJõøÑcØí«Ýyx/4§æ %º>HPkkmÓ}÷~ÿ38ßûÞ÷0€?7<ÒÓÙã 6soX+àÆgßOîÞy•C3sÈŽ£½Ãù.¯ém ÆgæÔ¹l8vêåã?þÄᓯÄJ¹8!@lÖÎ>æ/‚‹³¹š˜.F¤‘e³ ˜ÈI ÎÊL¥^ÏÜ €^Óx…†¥y@ Bx&f}!ô …†õ2£‚~d¨·¤À\•å^=×qˆÜPÉ‹l{ƒpPªþ ®Å[y•U } ‡°Ñø²Éë$Œì7¾ô•¹ãgw®ßäw{œ>_¶¦v¤ùˆD1Óºªg4±ðøÉÃo½ï~ŸÇ IÔ©Ì€3|LSšƒA”òzÈÌt¼dOèxG¬äËi¶x9|b¢ºôä´Ü|ÜU4ReS¶†#;WÕæ­Úýe›¯`ñæLæH®²˜À£…½HH >’n¡dÎÌåãߎÑ`ßøÈéa(œzu† <ãªí%S•*¥-ë7oÙ°ñÔ+ÇY ÌMXKµÈô\{_²«7ï^í¥ÿè?ä@PWs«µjÀA?û™¦EJW©Ýbc§Ò˜"-æcá‘ǽ”ŽW]6üó9£§¯—ÏdÎA‡Â‰&ñðñù@P€(“ƒ¯ZÀ¤ÿ¤ 5G©ÿß|^ÆäO,àñÒ 8 â %€%].ém(³…A?Ìñ2Íó“[ä³_õ霫’×QP ƒáT¡nÄ]˜žÚÛ®pЃ4À¼³½#“J£]³[¬°²\!Ÿ¨5—=t~êÈcOÛRÅÁŽîÞÕƒ®@®-9c«TzD¿XÕõЯ¿ëH+ûX¥2{ÿ<Áž×íôCM¨@BåÝopšS•6N´Ìùñpu6a åÌKyG¬âJÔ¼iÍ—1yUÇRÎ47Œ†ËSãBÚ–+£Œ€•«jæ-ž¥Èð%›'²ø)fsÐs ¥‡ÕX0UÊx¬¶ ר]J@øÆZå 7ßÙí –ÃIG¦bKM‘Œ°•öæØøgLJáÅ¥gŸ|jMÿ ˆìøÓŠ‡qLˆ Cˆ˜Ý(³y€P:AÐûH.…øƒs!`„0p4¦ å¦SeI4à’jWCÉ/^¼\d%½¦ñ k“¨ÀBð\fz0CÈ^È•K‚QO ÄCKÌÚ ÄÌ›6¨—Ë+–ô”õ~((ô©O”‘0Á)˜0 žW ^±q¯fÄ"6«U÷\]Àçå;ÏÞ³'Ò¸¢‰ºˆøXËÆyIŒsýå¯ÃÕ|ï–µf³ÌùµtÖ… _"»¼8nŒ'º::Õ£a¼¸ÙT1sŒôóÄO\½mÇæ­[^:ø‚’c•H®ÔZä9cµ¾RÆA¥± Oâ}|dÖàÀ ¤¬€–ˆÓh"Ø™¯B§\ƒà˜Õ§L¬×ù^§UM% —úƺ>œ©kvz:6;ß¾ÞÇÇB“ôÃÙ"Ü^Ôà·ê˜‘š,X4½÷ݾ|ø¨ ÔQâþœÏé¶|—ÉÃ`€'OON…—6nØš ò” HEt[ÉÞŸ1Ñsùj$ñ“ž\2MH}Ãä Ššm xV‰XR³2­üpPäoþæo>ò‘ÐŒ fCó$Qn”[„æõ®ÀØK™!!˨¥fæ"â«’¿å wÝvÿ9uzø n60V«OºT5&sáñ9x:*èÌrrüä¹í¶ôuv{ƒ-®fG°µ‰ßºc÷_½íA<Ã@ZP!F9JQg0övwó>û÷ï¿úê«ÙzÅIò ¼­†>ìS‘Œ5 “¹X³æÊív»ÕÓîðuxšÚýÍmM-A3þw</Û€„­`Æ@›FÎ8ðiØê£Z磈fàJŒJfF cYi›8öÊÜXØÔIñ¼¾ÁhÆ0²ôxÿûßÏ02b, ‰4¶º¤ÁêšÄ„ ?nphÀpÑFfg5©)ck1“#<³[q±ù¥ýœ™š®O‘ø¯Û\!”`ïpÑeµ<P¾ûÝï~ßûÞÇWèÀ¢À°\òS ¨?]×ù­Ä†)7,̓si!x` Uƒ äà —H´Ì$ô|h¿I8T$ÇfFp,„x(SàF ®O”¹‘É)Ó†K4æä™"–¿%+Æ“$\³V¹fïw½ó-Ï}qzyÉåq£Ê>rø°ñätíôLñÌ´'UÆ¿•Íh~ðÞ·¾ïî·œ}æ¥mýëXöã*Lµ¸}÷ÝrLJÞðNÈ’=3”BöP`gg'ë—ñññ“gN_wà \å]yõu5± Q(b½«H®ÂN| â,g9½ŸgîÀðŸ}?ÍaKUŠšß.dHTÿÈÌ0m‰Mìí¡v³;[–ÙÌ2jè؇–*¥á'Œ”'Š‹+bNwAA)ßíVál°½þÞ7î¹éÊFâa%3v¼ñÑxeÂiØ^:rõ[K{+[jXUÌ« "ž[B9BL;‹5Kð®öŠ1Zžçعkj¨·eR"Ú7>…ë" }ò2Àthhˆƒ·¤ÞÞ^¶oã€âCM=ª>¹AîRCtqÕFM£¦†¥y@Ø=?§¹=hAüˆ—øTãT,'7hLáž{îÀ!h<ѱ>%IŸ”)Ð3 JÕW•²áò?Ú`ÙnsÛg#‹‘E͉#™Ê~xrô<‘Ø=VN¡Xx{\ž×Ýqçùà‡_wã­“'G¦æšššÙ¢Glnõ5mZµŽ}'¤åH‚è·L,ì‡ í­m¿rÏ6h5.¯Í'C‡ê=WSz,–ÊjkN)½T ;“,­9«‹{<þPËO-Ρ/€\ ç s¥Ì |4öê» 5ZóE,³i¡>–ù„gkF–Öóä9ì7Z;úAaAðK‹•0Ä°.™­6\á±ðÖw½#ÐD9ïµ9ØãÀ/ÂÜ·¤/dYd±«Ud_¨RFò…ÈM̬&l—Äx*¹ÏÌu3]Y¡`ÊŽLý’ú°úÇ>€øùÏ_œÉùÒ—¾týõ׳oÂ(PF…Ì54ÖÁª—¹JŸª£M »žWäWŸÑaÚH¡ú M€- <Ú@ úЇp™ÊŸmÔìÝ»w×®]à?ÉÁ …âsЀ6Š–êf6ÔS« ù ˆ„ëœ[QäÆoKþØ­“ÓSpM Ï·˜Ø·Ç%87[&Nl•°ï•ÄÉÑ;ï~Çü ¢±k,ƒÙ\5ôľ}Xí¶79É„Ãå«©hnœ;­OÖJ ®aÆKW S3¼-g{wìܹôë_qîf %°ãÍJž{»…v±D¨o­ñNÌ ÞÖfa¶”_ ‡úzzXnXf’gÏžål.û,Mð·çuÚ³,òYTñ^‰*A}Ô®(ÂhœÍG ™&³áðËD¡›dµ]T¡!·óèS˜IYtl߶óλ_ÿãÿõ­B"‹³›Åž+d:prþü»á…±q͜˃ŽÍFÔ„ðy|æ™™Ny¥”ÄA¥Ì,PÓ"‹˜93»„öL¯Œ;«9žcö¼à/~ñ €‚çBÜ`CðûöíC_0÷!À+xÕƒSÿ&5#H}Cæ Kó:´ x¸¸(pÐ’SƒHÌé÷·¿ýí`H€& ÖÍ#Þ÷÷÷ƒúø¢cR$IŸR9²tHo”™Ð;S#-¥R‚JðÞùٹŹyøð”ýô G^ºõÎ×b|òüü¦¹>gÓ]¼õõ×Þ‚oÔਮ÷l¿ê±— îÚÜßÞ9?z>’J¼óCøŸüô•CW)Éå‹»QôÉû°ú˜˜Ø´iÓêÕ«ñ!Ÿ9„y4sêÛYúÃßL*b$%¯Ãn¿ýö;ŽŸNDbn¯û®›oÅÃÌ؉Ó~˃ÿÿóCÿŠ(s}ljx÷)¡'¶ß +ÌRQ"J:C-¼97:ÒÛ¯BN§‡‡CKS,™˜™™a¡|·ÇƒíûÌw§‹ —×`_ ¸ä1°)•ùÆh¨ 4¿0—Ÿ…´•vU$7’ àazQdÖÂ>€ÌȤ GÍ`×*Ì^=ž,‹ DÌþpX„s+&úÇ{ RgGÂGeðòË/ón¼wq•WS˱‹‰ç@ip±®ÿ7¬?<`%ð ~õ«_qü¶&ó79x 8F¥àY‘ÒVÅÝ»w³<~ꩧþñÿ‘ 0Báx}Ýþé‰ú:§Ìí‚:Њ5DhåF,¦ËÚú.=­ñùž3Všƒ-ñdlnnžÃd–”F í »öÞsý-Í®&Ø—2M5j¸²U O?ùÄ®­WNMOÙ=nŽ¿$NéùË×Õ £ê·É¡Æ«±ž¨Ý°÷ÆÝ×\c3[Ñ|þŸÿivi‰ù_þç—(_»v3ÏæÝÙoimîì[žŸG´F5¡ò@&9>N}¯:F¤±GÀ,Éšê‚ÓràÒWvPù2§}Zìî®þ–õý þèù1˜íùÙiÜx°,Îd•ÂƒâX’Œ&bZ2Jðdôè˵"ÏRmxj}ÅTC|Ro 8úè£Lܨñ˜V>ñ‰O0á2Ëq€E õ”)¨þxB½o¡|”;Ô4jjX½½b u(RÒÐ??™È)~€ ²Zh0³žÿÖ·¾Á#ðË툒ôÞè“ÄOAî¥ ŠÀU µq^ÇUJ´FÀÖ ìBÙñÂ&òÁ@óG?ôá6lsª8–Çs=÷b[¢Z«+ÄÚÊùóãÈ™ƒM½{¯¿^íNÏF/U ì´Wßšfu‹Ö =ƒÙ|ʈ+w]EÙm7dÊ’­ýÂ`Qqë,”ï¼ã·zu_½ õë_C½Ï÷àUçßøž¼6oÛJ'<š9Ú°NáÛ¹—œ¤>ÔdZXZÂÞ#b5«Ö7êqäÍŽ=Þ-Ø÷«É«Œ—.Óæ5þêÿøðM·ÜŒÜA^5ŸÀíÊ>‡©-C.Z\\=´J=»T$<r¯›Ù/ugÔåz&)žŽÂ…çM€)?¹‘é†Aà'9oÙ?òÈ#üäA€’Näy4eFŒŸ”¢$§*55,Í뤰!PEÀIH ŒÁàJNìá‡þéO*øÁOÚÐX€.´¡*%I=5´$Q6ZÙ`×X[ª=tž{õ—4oŽ0m¸š2 üâGô[[®n_÷ö±¶çs02›Áî,ÄBmžW x­±W2f-’ÏbNßßÖçÝÍ·oÙ²M)±ûFœNÌ¥ØÉBW€Q©vù[Vuöhù’“ÝAØfµ6y~,k,tnÈ›JsÕaµ”b /+biûÖ-Ûvn+ãÁ’AÃú5kÿù³ŸÛ›Þâ4Ùp¿Çùfžç8{fxâôÙ+úW©µ7dgÒ`‹lö!Ôç•Ã,%7©}e\“;uê„Ó©L•¡4œváâE˜&±ËŽÛ}s…08š¹lFm‘a„ç&ˆO±BL¤¦È\­’Óª¯œ;Ó9Ј„ÍpCðøîTǘ^8¤g6ìù«ÔøCçÇl ‘)J@LS²:,¼e"\@Ã@דK:X)P/°£LDo:”éŠÄO)4@Þ°4/ÀBíÙ+¢ Ã^ ª’Kà ?Á f¨Àƒ"T‚ $ÊÒ-)ÈT®¼$ ˜B”ڹαi ¨aš$´3|âGG¸÷Íø„ç’Ìè±x.B<¥çWaÂçϔ3ŀɃ‹¼?àÛ×Ò{g7,´RC—^gP0]³©§¯OÛ±D@CVwwúÄÉõkשoÂfâIÆjÆ2‡%=&º~—_iÃÕÖ–Rû!&üÝßýÝG?òŸ¸ÿ~¦.> Q‚|ia‘gppq€ª5sý‰Hõ|;_ÇpA ´œ]˜G/(#s†>e„©!Qæ­T©¾YÈ—BÃÜÅ Ó3o›­;´ä:ªVø6âºô/ã¬n¼,q‰~°ác»`qW¶—²À‹\’tCù²þžPÉ]¤Ã•m^õ–• þ„Ê »žà PÙžŸ èu‰ØF½$…¾õ¹|%¶i~ 8)“(S#•ät.e¹ªrœIU•áN¦Ô¦²‰–“i0`®Ö+·n¿ÿî{[üM¹Å0~[Ù!M˜ªi.Ä3ê(©E#‘+ú†ìWÃâ æîÁ7`dû¨ÛjßеúÓy:·¤«‡0bãü߉‘ <óíW]½ëé}OiµH»&!1úòCø´êTÄ«°Ýh³ØÞ÷Ž÷àM¬gâ`Q ¯#°4>Ú‚­Ã#çÎÃБÐ/²aç\};ñgp­Sª°¤Gô0>Bó\ÊaTyIrÞ’szÜ,£ð b%J?6ê\żâ±|>²:=°±ZX´˜-¨"êC!"p¸Ó'*vø'ÎCü´Tã9õëJú¤ >ï"‘Ká’«ü$q‰œnUëz{Éë© ñ£aù<ðQ@!üœ`†$ý* HT*P_œì©‘+kôJ Ô“ƒ³Ræ§ô€öN (¢Y òP® ".œàu{vîúôÇ?ÑÛÒÆþ5çαÇ?ŒR²UÑO©÷â¡<˜i†Ncãã[®ØÈÞÁ1L,ޫŃkǪ [{×Cð¬ÀPn¡1"zgo^.!ºQÌï×fËñ#G=>ïªukRø»çøL¥ÔÚÞvô•c_þò—?ôÁ¿øè_ÿ'¬ô£ñ¨R¥)Ç;¬J,ØÓæk2a ÌŒÉ2°Ærïå£xOj.¼°fœž™YŽÇ Z^Æ„6´”ÆÔä.jé8ƒ“ö(d1¥f³…AãÈ ¦Aô/#/Pà.)è¹ØJEVm|/?å_Lz3:¹$é—V¤¹›zz#Q F R–f+oüS,7,̓Ž!PS<$FÀƒ,­IPf’@ .QuH6Èê“øÉU'ä^é_G)P†° C-¥ H”Ž M¶ë¬÷ì¹î¿þÝ'PÝÇ"„¼°ÍiGªÇ‘† Ã4ˆTQ‚½bkœCX4¯Â%¦ëx­¯•ý˜Ïq°µ¾|P;ؤrbÐPíè v¶×Ý]©@z¨¯8*c(V=ºmÇ«Ó‘Ìg>OS°…íkÌ``ûŸz‘ž¸¯åÍy.Û(?ø®hð½™/d3“Ѽj`Gâp…¡†Hí•A­j!Á×1äèíË럯hžta¸Ð÷+÷™,‘°¯CQK¤’7‹n bE3';ÜÂÈcM„‰Ë~:¹°"àŠÁ¯ÿRâÑ<²R/½™€†Ÿ4X™ä^=ç’´‘®¤žJðD>Aèí£Ð°4xtÀ³N†S)<«S2õr ˆRCªs "秞¤™ô)—¤Þ—hL3ö¯` +}²iD=Kb¤}\µêÓŸn Qya‹{Ú!'°ž†?cn‹âŠhO‚©íìêrÚ`7ÖìÔ(>l´@‘*T3r2vuQõ\ƒÖlÃŽ!s³¼g‹KJ3Yæff0.ºaïMˆ=Ý<“€Ó¬ÌÓ6›YCJ;FjÃÎÓ‘°VàÓ˜;˜ Ûq2Ë‘δ°9Ï7ÊW3žP/OgQBa|b‚rU¨ófÉ럥 °ð˜ëÐo uуê„sA%%ž,ÌÎÁð éÕÑ^nÔs½†—ç.žK3 t+/#-©¡ ç¤¬÷#z#­¼$e@Æ‹qieûKZ®¼ô§UnXš‡&~à4œ±V‚Gübâ.Ú“¨æv0Ið˜IÐ]î ^.I‡TR :òYç]èáÙßb튈±wïÞO|â“Á@a>/J %6Vr5Ë›7áçÉT´cºSUœ°nÐZ®•¢¡pGsɧÎY•Ž™Ësž‚ù›hÄÐ7òS>²Ç’„2I¾”—aÏ .}øÐaìàÖ®YO<¬ó£ãyÜ`šlN«ƒÍ…|©üü ‡`¶ê)Ì ê4úvQÚÁÇÙöãxê@Œm¨aQÛ–brAÝÈPÑÁØØ8Â÷2P¼ƒì±)UF}*T•Üª)‡¼ç-·Ü‚fžñÂïœé“ft‚Ñ.êK.N‚\½< ˆ¹—fR(HK¹WuQO—ß.É¥A Їóâx1¡½?ι`zµ!²—‚½Ž¶]Š/yìrC ÿ\½Š­Ž @VÝ ‰Äï¼³œJ!ô䮹w¢ôNÊz4^(,'¦~À®"Ràzíõó§Ï¾*¾Dº½.«TÈ.,,¶\¢Šî­Ûö´¬À?‡ûƒÒ8ìé[ÿ“ýAWt{–[à™peˆ&ÿPÎPÍ ½±'¸O-Œ вAËÔ(£¸K7Q@˜6(}¯hýÊÓàGù"ktvœÞää$OÕùÓeã+_Ýÿâás³ÎP2L\ŒóT/\ñë„ó­KßÓ:wÁaÎes=œŠÕ™;9ž³ñÎÁél\v=WÝÇ +óŒƒá ÃæØ Xœ áì_BgçcÖs¶™¼Ö¿â, Ìf —Ê´ÎBG­úþ‡ïý¿ÿû¿•»Ð{|6ËX„$Í*ä)ŠµxÞ,b‘‚¬šîë.×Ñã‚C‚Àc6ÔËM¼K‰•G~þ³?û‹?§;eCc+Ç09?a2Ä¿¹±©·»Û™š †H2ƒ<` ôüô,q3)e~s@<ÿá§<§™1¬!« ”…;B·ãc‹X½0h°-D˜cý©: ;Ÿ»cÛ,!«w χ“¯ !¿BýߤŒ—£ ô k³„âä|…“°Ít.ÌÙãüʯ¿¯?ÿõ?±Çy‰“|þZß³~˜³ñù±âÊÙ^ÿ«³í\Ï¥û׿µ~äÕ»±aeþÒA"Eý zÍà 6uØyçãeû/ÑõcØ`":/&ÒÅìä‹X¼!Öâð@èþ¿ûîïþîïýžÏGŸfñӞĹ E± Å]1kêxBšJƒGtIÅCE¹¦È+µì»g?Ü2\v¹‹„ܪ…éÄâŸÿð¯þàþW+ÙÔwÿÙÇíwr½ôlçäõëD9 ý”‹Šß"cεb0P[N‰$ù ÎY6ÿ(°å²yûⱨl-– œ›Éçp4À]ä ™{ä4âNÅõUñ(„ΉÅ!Îaõ,c¢‹‡055ÅÓ2\©Õ ã:•ÇÑý ì@¾\JybTÅðÜNœ8Á p~.†wq~Q?‹Ìó[u³JÄíE /”õm¾êl;#ø¹°æ£9ùÓúaë_\ßà¯l;ïΆ³è\ºsýà °±Áež!gþ0NÏ0êȤ3fë¼>„—íq¦;}¿PyõÇ Øc˜¸„¸Ie#o ÛÿèßüëïþÎw  ñ„ŠózéNƒ°ñ£â£æ«¨’[õ™äÜüª oÜU:5{ñÔÅó±öVÓUº0þo~øƒo}ûŸ¼ñÆ¿ó;¿óÿüzÚº…qªv‰r½³…¸ !„.ŠçYnœ»vT4׃4"H¤ùÇÀµˆE¢þbH|©`<ûì³`àzŸ¢@2pÜ ¤QHê¯âçêgà5Í;Çè 4 ²k0;8F8?'§ìM k¹ 1 .•²P7ù,”\ž¨2à$ŸŸ\¬)õ—óð÷Ïv}þ¿ÿ—üiý¯Î†3šÎ-~ñç¯ë;â#…%ïÒ#3\ºçêÝÞ°8¼Ë†3òR÷!¼t6\vð¥/›|ywf#ZH;ÇðÎGÄ>møÃó¯n¿û.f°û¦Ø¬@ü¾\Ķ̺uĨG‘€Á¦ªEh&iðÏĶ=»>¢ÞràýÃ4±YŽ/¿üôsû^~%µšú'_ýÚ¿üý?hŽ4—Ãpt8 Š,špÂYG4·{lÛÖÆ–fllúಈ 숽3ÌH'F:PÑŽ€pé\6‘5ÌBtÈšR·§··—H%WÄÇÇ1'·N|ƒ8b] ;wÿÚ•UUˆºËE_<,–›¨3Û効€Í[FºÁqð« áð¶ø5 àŒu Ï!ŒñHÉ#8¹ºÏÕø¥ƒÂ6_qÞZw.Žë¬×úçTÎWØ^ßXßÌó4œ|kýlΞ«ý}ÃÊ<#ÍPñsºÎ~‹fª9ÏþKGÎWö8û}˜oñîL Žd^²ÍÉ™ñöÌöøƒù/ ¢ÊʱÕhóÔ«¿ûö›¸µ7î¾L+ ó†Î¶s‹“Éb>Ò¡ìk¯½¶j-¿÷ÑŸ<·ktîýÿöoþ-=›z;ºÿøßÿË÷?Ä傉a½@¸ÈØ Ç»þâ‚*– ¹>5¿H0¼³»kv~ŽX­/8 .Ù£·Ãñ&\Ƴ>‰R_t6±80AÈÀ3S'ÛÃbÀ¢}ø‰ü<R5¿ Ù¸|ägxLä?“yž €D?b%Ïn¯‰#V餉_?»¸ÐÒ“ùl:Ÿ%Ë€ eýå¹aAù<¶R­üP¡ç²9VP–¶úpˆbÃç®×ßñZÿÈ1ΑÎÁ¼óºLæ×¾tƒÃøè¼³áÈ<×Ïéö¥_¼·7¬Ì;¢¾>Nh] ½ëųì¿t8ÃÖ÷8ë3€Iã -{Öež f-8*@PõGôG·ÝuWý`2݈†°cÑç²_{ïø°ÖáM—‹0RJ8ö§§.ЕýÄ‹Ï5}îâTÏùÞÐ@'€6Êekéß-·ÿóö½­[·!•õ|ž ¾‚F÷PEà )^ÜzžÐ ¨9“Ç·lyûКÑsÄó³¶Ð¼›³JíZ‡…·e›¤WÈ3f<²Whn­£¹}xÓÐêÔ"¦ ÷̱S ðDŸÿ>{ b?pjºúVÊ«kk«©dÕ!žG@Q®l“ÙÌbb¥u¨o%¹ ¾W-Q,¨Äy˜dÀùiÌç©sQ;Ž?ˆÿãÌ܇øÌë³E¦~øøÙZÀ¦¸5\þÇ?±Ð éu¾ål8ïÎ~ÞyñpØé 4ïܳßyÇŸgª¬péŸ6Àö†•ygl6GøÁròB;ûÁf›ÖdƒýΟœýëïl°Ÿ™ÁÆú ëEàQà„£þøÿ7¸î!nI+W¨á¶lka->5;B*dP¡WÎLœoèn‡“#53ÇŽ¹fÏ£g'§²«Éý/þ§ßzè«Ñ86J²_°»€ØÇ°W+.Àº,(o"ßX\¡2Ìrêí¡ á::KŠk/Œ ¿‚ÐÂ{AÄ eÏJ¤ATi5Íc Ìô0 ¤²nÃesžÃûߨ/ e`T u«?þ¯úãu×ÐçåQ@ µŠ"gR)¬*Ù/ÓÁ~)¾…&>HŽ¢Xçû/mâ`Ø y}–‘{÷ÓcÛï½õbq±É×IUÀ‡æÒñézcmÉ|fq~É[óL­ÌYÞ DóÕ¢ÅÒ(Œ ··D"9¯¸BZ°Z(Ê>kø–É*>ÐÊ~¨øYéêÌ™¾€hF“6vÏŽÇÂC¢Á!@ÛçÌ"õ 0‚ULQËÀ²—5‹‚bÐ+“¡`•Ø›7 4&QÉ‚Ÿ»¾F¬/Ìf?Á3H½ÐЙHW³¤ÿõod™_En—ñC-³+  å p34Ëg&$–)¥ºba°™÷È5 t]….€k¯ûö^*Ž¼>Mä/MÂ"1uî‚Ï+¤ÑWôÆ‚ €n1¦ÄÊZ•|x'"°$‰C™„"²*’ \†G ”*¢4ÁU5qd\5PJžd!h·M-¶ÈŠÁà;¢ GŒr¥VÆö©[$Ä |Â1LŠ²^{4AŒT « ëæŠ"K·g¿#êÎ,ºâ‘WÝÎ +óëƒäl ̘÷B¤ë¸n!Ì~QM&`j¨­º—Ën”™Ø¯Æ™+|EÌQŠ"­ð‘ÙÒV7¡lÓ"KçƘ ‡¢^xi¦GM%“ÄÏ9|hÿk°VTÓ9wÉÄ.`¥±Š¥ §ÏfkùêQ/ô°2<”RY$«˜”f®XÊ—tI=óÉéÿíOHû1õÕ Ž€!ðLQ&6lØ̳RоŒÀŸ:׿iŽwØŪýÞÇÇwl£f¶°²†4—=dæe«Pæ6tÁ ï…… Ó¹\«9ÑÒtøö[‡¸[nÙ«£.(:Uu÷îkž~îù&qMRðé½ùùQîUäÑ áÀRDíÈóa»]šª@¨39=µ­k _;|ðБ¯» ‹Fw8#,¨ŸŸeƒ/ØåisÊú±a°0¼kr=!R†B‡1ŸÆŸ2ãQ›•h½ðÿ‰ÿQ”(â^V(V¯ÏpC¦…å%L9zoqÂŽc XL°è{Á*-úز0ò…z¨Cl]ù…I“Áà·x9’åC¯¶½–뚸t…fûâÅ‹‡Ó^‘ëZB´³iVÅG»(Á4`&£0– 4!”lE Ñd8¥zœ`zÅòWàl—}ÔÆÕD`\Ì$T¦˜7²¹”Q8úî»ó§ÎW3ú¿ ñhV/#”õF2#@³…R€`™Y‘i!+è3±xTj¹•UPrLÓ…ùù‘±ñÎÎ ;%­o\é|>±ºð¹Qйr1'×ÍœÎË5BæyÃHäÒGÞ}' ª…tîÜ©3,!Yôss¡!«Àëë’À2F»>ÀS`ûáÇ_{õÀÅéI\€ñ-­-Èž_â`~ØáˆVÙ•9ÂR²+Ù¹E* h\Ä*¯)R §5¾¶š˜™?¼ÿàûo¦5]»½\6h‰Ó•ºÂÂIKV2AüQQxWu_‹`ŠXÿ<ù‚ÕW1{ÜÕ‚·â¥·uÂŒ¡àzA•ÇÊÊ]´ˆGPVÀJñÊaXU˜jÜ~¼Â©í2c¬Ê–Yè-t>m;i%€W!2ƒÿÃwä—8å×Ò]_Ѹڄý³ëÝ°z~}<Qgû3X>©ðㄈ W›ÐC¸H2Š¦&†½äÓ’Fžoi’"; Ȭە‡…tÝàñ8©ŠS|ë5»ÆL¬ƒmQã Vj O¶”˜ž5ÿÒZ2 ·j~–)`ù@}–¬¬ Æãä>D"\ä¤l²‡f,5ÓÎ'טp\Ì5óËóòŸ¾ÿýÅ_†#Ÿ;×7Ð_¨ŠŸöÞt9›3ͳÏ5ôvO-Ì>þþÛ®™MÏŇ²òÐ×·ŽŒxåeb~ØÁ„º€÷¢áÉ!aX¦Ï¯¡þ Æ€\Oo)ª"œmwÿ}û_5ÜrÃÍ…Lâ×rd‰'bõ—‹4¾³=ÔáB, à‚‘šR¹äõ+Õl²”/°Ò½¾ÿÍRZ âEo)_ G¹TšëCb$‘r Œ  ËªdT Œa7Üxñ7EI .¦F4E€âj —Ź⭈Â{ |DT­’EW_xNÀ5â, ö­ºBgUei Åɸà¼83´L˜†¡cåbá-½?]*ùl·wþÂ6/g{c(ü +óëã´>Z$Õ°¡‹ÁœÅŠF«ˆÎ ª¬÷wÀßi&›U’\–â}û“ãðÕmo”™28ÌUë½ù X£-]ž‚EÔ ØìG “ÌÝ›G¶µ…È8ºoer&ÿZtH&'Wµ2s:•€³ýšÎMšð©Ý™—JYú+lë„ Ô.i€ ziæüÄX÷@k¤%Ï”¬™tƒjE7w÷ÛÙÂüÒô¦–ϼ³osfìð°ð„ýYÙ>59qjâÔ- ;ú»üá¶XìäÒJ"“ºuÇ5)¯ÿÚ»ßý s3@ô7uöDdf˜ÌãD:91;½mËÖ¨¢ }íó®æ3'&ÎŽ t©aÍ›÷Yœä“¹‹sù•Žhø·~ë%OmÍe¾yáØøohèeÍ°4)U.~xáŒ?º><€Ìæ3ZcäµÓøÃ]ðmtôn¾û>Í|oö\Ñ,_ß·¹ICø…¿•¦ŸôŽîMz뉌ÈdnõÌÄÙC£15€NÆ Š— Ÿ:Éí3  dìÒœÿôÜ™ÁÖÎvD¯J¬ i¹zqj2,ûúÛ»p6xnkÕÒÅÅ9¿Ë7ØÑí'ô*y3Jebz :`x~øH{ßão&„K÷; þ‚«jaèa)|þbŒj>±¤r] ÇÔÿüØ«øÿVæ×ÇÄ~† KWR€ÉÈû`S’úÒÃ#{vÜ}÷Ýwn»_2ç²—¬”ñ„º©¯ÿÁ醴LÉUšŠ/dŸy, }å®/ú¢ŠÜÚ×÷!BßûÝï5*Ê]ò„ñŽødfâ;w|] PXÙZåù7{÷ýßxà«á>‚Q)›8ýÖ‘Ã?ø•ñÁa ÙãyߘûåsÏï½ö†½ãד/äT'S³?}ìÑw_sÏ5{#.¥à*ÎÙ‰¼¯¼˜OÜûý½.…Ä]É•}çäq˜pZZ[[¸H"üsµiè½g×DØ~oëæçï?ýÉÉo<øðp{7D%þç²óÉçúöõw šÌ,Õžz< ÿöm_eAó©òbfµp0F`të–›w^©´ŸöÚKñäÚW¾ðPKÂ"SO~ðáoùëƒ1 ü™ž@IDATÜX"oœ|Ïý¦ÿë_ýÚpKß%ÊÆGSçí¼wÝzÇÈÐp¤(ålëBrÙõô“;6_;¾=Pܾ3ù䋯îëïè¸ç–Û<}ÞùrîùƒûÝúýwÜÝìÑèÉ—ð”^yó ­¯¼ÿ†pdöÌÅóÇ>*¥³¤bó')ÛÏøe³…È<G&ŒÈ&Öç}ýÈ«wcÃúóˆ´#íëcÃqM/ÇE. çË&þg øãÿý§çg_:|°gëø;S?þü3_yàAòϽ±¯u¼ÿÓâÊOŸøÅÞ]×Ò€ý¹ý/ëíñRîѧíÜ6¾åÉW^pµhšñWÿ¨£­ý¦{Ý÷LFªFš»þúÑ1§iõâ¯Í¦Wc½Ïì{)‘Z½å®Û_<ùÁìùÞ-£Ï¿sðÔùS÷|ù¾so||t|h|ÿ{½ôî/}a>xùÐM[6Ÿœ»ðèËÏ~á7 øôÒÁ—F7 ÍeV~òôc×Üp}[{Û“O?ÕÜÑB†áüthëØÀØðß?ód¤5V ëÿág¥u4^»m÷¾ýû¨k u6ÿÙßÿ­”÷Þ}ǾûÓ+mÝý?<øød|ñÁ‡zÿý÷>¾pz`ÓØ/>xùÈ''úÆ×ÎMMî;òæèø5¿<óök‡ßúòmwã9?÷Ú«=ÛÇÞ8ùâWoØs]D üüÀ‹­[6Mk?{áémcc=]ýò½­‘|ÁOŸz¬³§gxóÈ“^®ÄüžhøOûQk$xÝM7üü¥gW¥r¤¹ýGOÿ<_,|ñ‹_|õг«‹=½O¼òÜÌüÜÞ{îúàâ¹#§Nlݲ嵣‡ß>rø‹|éÜüÌ;Ÿ|Ø36òÑÅs¯½wx×Í7d+&×Ö7Ø?µ4ÿÜÛ¯mÞ³= ½úÆk<™ŒYxlÿ ý[FZú»^yí@C$Vµƒ/¼BH0ñ?$å)²Ÿá8œ©ÂG^Ta>üðÃà¸ØéL$'žwÙ¤ZŸ]WÑƆ•ùuõîŒ1ŒiZ¶¶´ óÅ¢åJnú®~ç·}6•0U‚dÙ ªÝ¶ù`` #[òTã¹Ò~ÃЖ&Ï€G*Ÿ&Sµ£w¨«¥ õRtU–2 fÏ5›F‡"í“ù%Î6³2¾­·¹ud`Hp¿[ è኶h#¿g÷îŒQÀ£.ØEJÍz"M»{vž]Ÿ³F–jۢX3 bX’k-“ñËê5ƒ;B.‘‚XKgÈnïܺ3 eR¸ëSét(èíïln3ŒBÆ4æ“qXz†û·w%VâDª–S«UêlkßÖ2Z,çsV*Ý|ÉèîèØÝ4ž+¦K;CY°aÄ¢±Ý;óv‚¨5+CB+àQîÜr]¥PÌUì¤Y\^[Ìý–!I›Ê­a6Ï-/è’ïÚ‘ñˆ¢§òÂYNd£}]Íí©t&[,¬äiOi]×ÙÛÝÖ¹˜Z-Xåt©€WÔßÚ¹½w4—!QFÉg²ÙÎÆÖmãÛÖàꬺөd>—m …wŒo#ö–¢gži¬óSõëví©—ºIXºËhnÛ<ª)dD4·ÞOyÀ¦áá–¶VЄ]¦Ï_üôÝcÛõ* äeD ¦–ç}}ƒL %F_ûÚ×|g"]ú~‰÷/uÃʼ3~ŽÀ;wÎ|ã7N_8¤¿rE$œ)˜ ‡B~éþ–ææÖ®G~öHgCã×oýèù=ÐÙßóÔÓOEóöï~ák ÕJ¥»½ýC‡––¾þÀC¾@G´qÛð–wš:{á÷Þ߯Ec5i »{êäéC¯½öн÷u£V*·¹wÐÊæ_~á—·ßpÓmÛ÷4zµý›¢’úwüä–Ûn¹wø:º+ÛczèO>Ý×Ùûðµwz s ©§¥¥õ‡ý<¨¾wû×ÃVµY nùÑKÏëúæ=Ä\*”Ñ›†Þ>öþ¹3ç~ëËwjápMîé?zâýøû¶ù2å[·ž¼xžœÅ·î½Ks‡b›C})+÷Ô“O=xë×ônö•­ñ¶Mýó'þþömwí¸‰Üvo¤½£µí‰Ÿ>:ëùÆÞû¼9«=ÖÚÒÚþÜ3Ï…}þïºO)TZµÈàè¦ñ„7k|ûÞû«^2 }Ý];vîÔ©oõ›šÚ½YsOÿæ™Oμwäè?ýÖ·{ª>O©zóèu‹“s¯ï?øå;îÛÓ5ìË›Û{6QÆ÷Äãï½iïM[ö”× ý]Ñšöä o¿uûžÒj¦=k„_|å¥öhì7n¸Í“Ì·„°i_zåEM–ºùöFÛÓÃí-­o|l%µúàÞ»ûc­®’ÙßÛÿö{G?üðD|f^´£T¡žŸ%KÖ‘éÁlYg™'úóÕ¯~•¤3yÖ§“óñª~ÿ,hqUßÃ/óì2cŒ¸4½ ae¢~ÓGBN´|°ÍC„Í–¼¥Õt’8V»ˆ°ª‹(ꈄ8s*9-s%C((ÙEG׀颟¤ð¥òƒ-AË]JfVšì½¦KÞ„‚’â6«Õ<¡" –›¾¾>ˆA¹“ˆZ3 SfRonØìn¤´T˜ß3‰%0Ц‡áÇ&]Ñåy# Œd$ØL®†\ó§Æ*°Ó.9¨U=¨EwuÑ"ÚTí 7¹,:ç©ÌU²@Ü[ÝJ̧J ù³%3›Ê¥zZZÉPÆ'Ó˜p›hËÎ`Cƒ[ Õ|¤# ]žX˜ímn#ÁóÑ?ñüùÅ4ëM¯xfô¸¤êj›¶æ6°¸ùtÎ y¨º<Í‘ºþÖ+¤Éµe[ñFýÁv_8hyõ2¤`…y3ëjWk€‰ÜeæÒw…º‘ÆTž\vÅ(zìó+³ÃýC }• ¬‘Y8nœëíì¦Ë• h0/ÚW/—ò0 õÈ!ŽÈøª†ìZ4’ºª5‚“$Ÿi{ià;YXeôûBvɪ…| /Ó™IP_ª¾J° äŽÈ× ¤ÿgeës†H %’O?ýtoo¯3»Öÿä(ü+N¹«e熕ùõ¡bƒqâçOþäO~üŸÿ6Е€Èœ¯"á1µÖl€®qi2¡2*Éx‘€RƒþܶF¦š{5“[ˆ›Ù|¤¥ÉÝY¥bTÓ‘¥j,”Uyr­ÏXY£­±y¢WôÉ%áV ÕhÖÎN/«’x•ÔÙèk‘+/«’öåm+°b7Izé‚ø„æ3˜·mÑ`,¨¸Jk+—=ên£ŠV-–Iz{i#Ñí«H˜C’]¥&»k´ì.%½»¥@fÂU_ÌäfËô«õëZM—’îk«0Pdˆk‰Åe9£Ä ?{ÀÊòl·†i]Ž'«kyo˜«»Ò×ä·PÊM/ûM6*UÀ8ü®Té,ÛFayµOñûj{ƒ«)´ ¾1ÒD?¹ á²¦ŒðªY’'¹9@`²!ï)ά*¨[·”,fyîž¹ÁOc6¡/a[±0Í=Þ•ž2²LfN)Õ\g–"n_¾*ðäPmÙ“zäö˜à§ìJÁ B1:oQêC¯LÒrš_í¬4!#\ýàŒfÔ^Êø*ž˜ŒjÍ•‚à.“y& 2j™‡wÈ™Hh~~tchûÿVâöŒ ?•mŒœWòE¦ 0.°r´¿³cS;²Ï–u•2OCö´õuª»û1˜Ïï;Œíh—ÃÀæþ Tk „ýáˆP=³X˜˜›[­xÝþæ†ÎÚ¨]Ø›LÁ¬T59ýÉd5±¦¸”ZÕ6ÜÕ®±A¥- $€ºwIÒ½º–;3¿à/׉¬Ø}-»·GÊ? !¯+2ÞÛÐÑ,/¤ù¤¾‚ÒÒa¦ê#¿Í\ƒoLY÷HÝíÛFì }¬<îåýŸP£ì|¡k¼i·­x¨6‰ÊÀ,é…Ä…ƒGÝ¥ZLRk«iÇxwG¯–7?Ù¸’ÎúBÁÀ–~©­¡šÊ¯Ó¡Xd·-»2;¶¹'6>à+•Ï—>òæKxõþþöÎ]c€þÜ‚*ŸË#V¶¨œ/žšqeн"]zËP“;P9·QH“éÒu­ òz56ÞhŠ„­Úù•Ñ _ðÈ&¥ùîÚØŽñZc89µ˜YHzJÞ@ÕËzͪZª… <ºs •3õ4ûÚj$3ªŠ§¥¿sQw•j¶_”ü¡¡kŠæ£ÿ¤Ï§>\¹ÐÓ²(°U©®e¬ØèN9O*œœv…(àéŒú;› ³Tä+–C¡é€hÛÒiÈ-¹aÔu ’¹\³hÚ ÅÁ¥ò°¾†À¨_{Ga8Šdý˜«tcÃÊ<ãˆ:’Ïà1ÏØÓÙÙ‰`S8]+b â #_¦¬¶Š«^SU¤BÀ*¹Óªª½ k©êW½È19™p”¯")ôÂ"Ä@ä)órƒiõzt€ëèÜÚ ›*\-ä QœðÈIÉ6ê˜{0ª(£ˆ¬Ä[¢Ô˜™çUªÞ²•/ñÕ : ÓÖ$ÇOHRTÓ0%¿ºwhp‚vÒœ2~)5>¸íT¶C>Ge(±¾j¡âSÜ>Ë_ô¶VÚ¤IM™?ïÕ<ðÒKU½¤¸ô¢KÏ+Q~Ñj­ø v5éµe½ÒR‘¡ëc‘áZŠBÖ|y*t€¬x?šIد†ÇŸ×<ù ™1/{r’UÔì|Íl1kÔ-…Ev¢·leÚkù¤˜xК X¹š—4¯íååFY£×„LD1dÕ ¼ÏòØÂŽ úAŒ âµ¤°ímÊ™«8=†¿ÖÐÖ¬Þ˜W™–·ËßìÙ”:~^Z²tá4PMì3aÚs6’}%t2§´Ê2¤¢—‚¨;®; rÝšxLV<>£GŠNöúX2ë8!¼ˆ7“„9à õÀ;C)þPñ§õYôù¾«õÿYæ×ÇÄ1Ìœ±‚jÛ%QÒ½&ÔŠ`h€Ð=,Kíf?½™Ð²'ÄÊõÇ4âê:ÀxRšÉ ó`IÈLøZ™Ò.’”ßæMâèa¢Ðù žxIÒ5¬S š­ä‡8ŒŸÄË䀼Î]/í!yd“NçX`ºB’’2mfv5ÊHMUÉ*Q~Ãj#ñ‚‘[“)ŒÝ{F½¬ì±d~|ίƨ5£¤¤Ä•}î‚ŠéHU¨¨³µ*HÚO,”S^[A:úRy¨ç‘û!ƒñY<–‰ÅÈ›-Mgš_uUÛCÆKEcsV$•¼âv‡h·‹ô÷4 ÷ƒPvüÔÑ’3«1ƒ¼PcÑ‚¦ŒàEUŸ‹¶—%S¥úÍ#ž‰êÑùuJá0¶u–/Á–O*´$»ý;ÂÛ…Ö)P ¶×#8Á-Ð56k$‹2a j‰¿Š%!Þ,¢4ºQ2lÞ«§—åY¬ˆ”î`0È,‘<›>cBK1èêÂØãË $Ïka5¸Ò ­‘ÃèȼÏ+ql\é«ÿØ÷mX™¿ôÁ3lÎà!óÔu0ù˜v"²K1)ŠBÌ&Q‰ Áq\_@µC:Ö<¹tò÷œ‡Ã„F@¶(uŤD9‹´öFeV¼@ÚL^¡*uY±rf-¤*ÝŽ±BÏif°¡Ñ|¶XŸ’¤µáˆ¤0´3fd¡z§åC%àÓˆ+À<+‡‘°’«E)¬»º)¹£L¿–·kÃWåqX T݉Úÿú‹»#©%„š~BRü—à‰z “µ…btŽå;D+- ÿµ5ì×n]åÖêÿD!1¶‡sNÞ¹Î:Rÿ*–C£Tˆ…ÈJÉZƒ„B7ÍÁü:y.átt¬ ‰ÅÊOY¾»š+Õ²†Š„:Æð¨“' Jr±R‹Qª&ŒEšfâ\‚/ÀObÁ®ytW£fç Ó°0ú©†@\•†;f›‚§>€ôåùx 1ZókÞÖ(µ¸à>jó†Xˆ('€åŠÅ]8æâœØ\LñTê‘9–3NX'‹Áú;÷Î7 ;¼t'ÛÎ,ºlçU÷qÃʼ3eqâÝùˆ6£€“LE†žI$„‡9€€W-²ÓZ•åJU fUýqHðX2`µ` R(‘Ô-z]±m›Âƒn-eOþÔ˜X¸Çvj(<ÕCãýh™4ý#4Ù‹\»=Vˆ€À»X,(Íáðm;¼F¹9 w•LÒ@¯ÁQ¥ø,Wyrm:ïÿâuÝۆ͑nêp¤šìÈ‚x÷\6u¯°ñÙxô^‰.÷ø#X$XìV5ìv ™‹’êÑF{º¶D)ú5¤òì§gݧ—´l™Õ¯Z°VJéwô;&PU#9hèÕZ@׳ž¢E@DøûÄVjrDmïÕû[µìò±S®¥BKGWøšáöm›ó®ù¥ãçÂ5ÅZÖˆÃ-ýÝf'e¾‚lëø¤½l2„9EË0²qðû³†ÔÕ:K¿x&¬›b>àdÕ %×ú‹ýŽüó]çú~GÚY´¾ó*ÝØø2¿>ŠŒN8ñ6Ô%&° À²öK8ºÞ,áhDi(rkfÙªåkÃQ̱Fˆã)ãt’;.Z;&SV(ë -zBQ(  ¹@¯m%)LÐ-̶ÌÊZq¹@º Ô¾%:x-‘0çÓ}­—§²Ik¹ZË–d(9pû‘ãbmùâœw0f…0¼y>«$K®œMòN€ÖèàÊÔ­Ïݺ¢–J]×µ4Ó“4ž`ƒJŸØ¾èdÅQï¸#fÅ•/©ÅxO?IuØ5ªKk£¤€Ï‡G¤ •ëfDÝô…R‹úx{yyQjlL¨ÖVW*°ù`‰ðø ° k"°‚<›ß7óÅÙd>ÀB;²œV,WH p1¬DPàx3¥T|MïkÃwù+/ž›3sÐüU¿=¿rÐÕüá¿ ™wˆÁcå\1P óBv&áñ‚ȱdaB«¦+bÁª[EKÉTÚ‚ 3Ò¡ÇB‰‰³òI¡õ\.©ê-ØA,þšº'SL*¤^øŽ°P©.5·Ož™Šô´66ÄBÃ^ÏÉ%RZhpv¥s‘ª¯Lñú…Åx»6ÒÔïR Å9ïjÎ,‡€_‰¸iS 9¼oµ 1©ªJ†@„‘H+ŠËÖ<„¸È¤pªu§péÙ+:CãΊð¤Ç]àz(%ƒZ³N× «•î·YLY‹'θûšZ£ ýýéü´­ûÀuë—[åN…T'É*&JÓ…E©)AÛ¥+µ@ƒ%“¶š®â>pû¢}ù ^’j ª¯:#-i0²l"È^Ý£jÞÀR•,¡¤y¯âSûünŒ†×08ĘÈg†¼ªâ«6 õ…:B«5/„¨*†èÒ!|-FÐ2AMFMºg¹f½p"ø2+øà®E€µ«ÛtÂâÙ‰ç&êêuð¯¿ÄÌàÌ—”߈gqITø׿rí©Ïä«èzÿ¿\ª³6;Cµ>`¤1ÿ|e7ÿȇb#LNDÊ ¼=Aì²ä/¸IÖÜj™òZõHN!Õ!xœD’QÅ„µ)As m€1Y.¢F°¸øˆ”V5k¤Vhÿèok t·ìó6(ÃÔª’jÕ–»8·WR„Íc#}fK8‹Þ&Íä“K6p1&¶È½×cìèxhŸ«EÁL áÑ8áË—Ëdü½,Xbþ“S𠲪j%_³òj-)—S:©u/šy#!F„žd;¼=¡|%w~ÞcV|A=ÔÕêŠús˜ö(=uœ˜X›ò©V´L@Ä(D¸à±±ƒFÍoTu‚ò‚HLÐWjJ„ŸE 66ž?””.¤ÊQÖ-í`I,ˆ çMÝg磸©ä BÉ•%x9ˆ§ÑÙ~=ñ"F("/ˆý>OËPŸÚÛêïm+A|OfÞ+¡®ÝY·•HY­&ùU2ý*È“d£€HpÒ“@ÀS¯Î.˜™<áF0ŽXE ÷93uu"¿XhâÁÕ_Îäú þ¢(‹=(yç],¸ⵑõ¼3Z #Řò¾ºº !Xnf!ÔXÐLš6Ñ^ò·Ï¶Ñò³ñx¡ Äðj2½+¹ÁZ Ž}£’ÁbA²XÑ"jv}ª¯ê*VÉøÙ³ñp‰üš¥4ûEºRp’4µ°€nÜÏ:%nÍÄ:¢wù ’æu.Zq¶nQÙjR4*—fŽ~ †ýFMüDÇYƒ-P´Ú$vOíYUÞ‹æ™ Þl%ÔØ`÷„|²?ÜÉxæˆY4¶·jý<¦ÔÅ•B2SÕdØdz* ié½ÑŸŸš)¦[“C€%òþ`½¤B„=æ4>cgž8ï΄Á$ÃÏêóù!äÿí~þKÂÌ3~NÃVü[wIXdqt•ÜDæ<°¬û< õ›ù™U5mab”6bè™ Ù22Ú4]Õ*.ÚË”,«P¬Ö`ÅI3¨¬Eˆ‹¾ ! (ÈvÎdÊ5¨%•" ¯å­rÀ \Ö‡HphÅŠ#`¤&h;¸× c´À¡Vê„œ8­À ¤ŠŒ±@ëT46)L{ûsùœ pq»Ó™Lƒ¤rÖ«»]¥r{ƒ"‚ˆ’)ùÌ ÇÛ ¦]E ‡HË[–{Á`Ɇˆ¼ų1§›dH¯UÚð¼ö“ÏäuJÙê<ß brÉL$ìO§³ ßjó) ÷ÝâùÐHYôˆKZ#x)íE2…«Adܦìdk ªÐ|ÉôA¿'ÂDªªn‹S }«•ÊÔ¢¤’Ó«i’šËtIs–ÀpДl.çW¢–=?·Z[4ä^oãh…kðjTÍ€íV(Œèž†%Rð\jmY-7fk€™é2„Ie¿WÇÔ°ˆe¨Ç›ãÒ°HŸ ×Þ/–TVÖú:xÙÌaЈÛ;2¿n$^vÌUúqÃÊ<ãÄ\j¡\iunæ 1-  ï >°J‰â+Ø„U‰0OŽ¢L,EM)Š\°®‡(†ó+~Ÿ|X9±HT]ÔÉiëuu@ЈŻvr*žŸÁ­Ò]r[-`ÓeÙ…Ú©ùÉÿ¹TIBšTãShÕðjIŒåšõú[ôX*[¤qÙ2 Nðm¦VÞìð…*U 5½šLS¦’_õ£Å±ºÃzèOÕcQAf깈ì;{ô„bvíÜÖ¹u»k”¢ÐÀöô'Vg–B%ˆy%BYA,\EËäç$„†ÙêÕš”H%±J5!ôRþ½JÀ/× Ñ·ÐD–cÅ_Æ›¥,EÉoŠ^ ø¤R­] y`ã/ÓÏë—4¿KÅÛ¯˜†Dè¡nXñupFº¢úTšÕ’oðt»îxÌÏAÉØA—.UMuù•Ã^àÎ~®O= „ú-·ž¯6Õ4jõ©G¢Ž¬JÀIX\÷ÜôL©²Ö»c Àßá+ò˜3Éå ³1òn£\RcA3kN;_,X¤ =®˜¢ÿBO,a]·¯o8¼^cãìß0’¿aež1wb0Ž…Ï(¢êYã˜v^/µkB9á~ó9[òΧ%„íR*²"ƒ7¥eJzÆ6Ò‰rÚÊPTz(y÷ÍgÓÅ ¾"8y7É3WkBE¯¼JåÛŒ**N“œ#°äñ­ôwË•¤t‘=²Q©-g‚ì/åð¥!¶)­XŠˀEJoÁxã±b÷»jaâÒ«E{:妕Î)´vS$à)ˆ·$IEòAÚ:d%áÜy«ΈDÑšX”Ü~½JîÑ6¥µ‚ߨHe H›/gz—3µ|ÁŸ6½¢×¦RªK§EÇ8)”<Þ€º\ÈV>W‚ÍWEª¸•5àˆ)ÊÖCy$‹Œ@[¥¶š¯\Œ‹¥$]‚ÒCÉ7Ÿ. Úzb%¢XÕëÓáµõ`ï+ ÈLP Ðz!K{)êŒiU­IºD+« h^ÚõaxYWr6~Ö0Ž{¤Œ]K•°‚4òœO+ؤ-ø3@á™»’¦¼ èUË”9Á´š)CŸ…‡Ã’姯˦(/Ø,IöáÕ $Iƒ`‚’n”¿)’š¼.xöp Žæpà #ó"-Q¿å øvÙ áLþáþáËO=klφ¹‹Þ†›%U-J!€ñ”–xÜi#àӉÓƒƒŒ÷©ÆTT x׬°[ÅC‚J-¬w +eì¶TÍÁó„À=¹êCMç«ð¨CÐZ´Kôu‘ÊÔ·0M]vƒš)#7U ¶ºšW1¢Ýb~ºòVcYc6ãüë Œ·ÉtÅŠ†ÂºaºŒ¢D ¢ê–{Ñur°ÐIËᙳT£®|ËÞ\ü7sÎHUž×*x0ø[””•JÚñ 6ÍÒì¢" Ò!IƒûSUxB¦ 4—ÉVèÆ%u–}5ÓŒû,ÌmÝíÓ,o¬¬À™A‘LÁgg¡–%ÃA|c$…ïî.D]…*0·ë‰P‰OÄîkn‘Q²1“¤è'•¯6¸Aw'¬TÁ8ž•.è6ªAEI™¢¿VQÝèa€¶L•¼LJÔ£¦©þQHzXdílž¼B1Î ÛaêEûP7\ kv®P5ýA½\¬h4浈ڂ¨ÖXüQ EѲ®k¡ô)àÝoö` <ûì³MMMÎNæ·°ädÃêyÆf}üá§dbqqÑÒÈ'» Öc{fÑÛÚ¼}ëè–ѽÃ[Ýél6iÛúÙ[û::»¿0v-™¤¤š)•íƒoQ<* ჲÏ(¤j!ùÇo½Hc–Ûv4z¯‰¾øéÄÒÌ7wßê‡Uף櫕㉉3“çnܶ}¬cÀN™Ñæ¶wgN=þÞ·Ý>ÐÖ M….ûW¼ôÒ;·ïwç‰1øæ¬Ô û_í¾qË.™¶1ÏZ-³ïÍý-tçíw6.!ýž„âyýè!ªÖî¸þ‰- Ù¾—ì²²wÞ~{³!ð^p?9óé™ùÅ/ß~o»'L ö?ÿñ¡“Çî¼íŽ~Ý|HîMÄç_ùèí›®½ñ–®­Õµb%Pšˆ/?óÁ;»·í¼µ©_³«fPZ,¤Ÿzu_wKç}[o…[ ò›x%ûâ§oÕò?¾Ù Ø©áG—_eÑK³ ø®˜ø"&¿.ðζ3m° @[%“IdÞ‘óuƒÑùxõ¾oX™¿Ô~q¶1ì‰á‰j¶ªEË*V©U”€¿ktp× ×íhé4ážOÅÇ+©®®¾ÍÝcƒ¡VÓ•9·0—¤Õ”Ý2>kW\åSñé]Æòìââ ×^ßTÓQ\銹¬ÚzOóöþ±ö¦¶ˆ]ȧŒ¸¿Õ¯Ýs]—¿iSçÀBb-ñ‚iݹcÇ–ÞMj#|¬F~¢ÉÞ´el¼g°YkMpZ»¸³šÛÜÜyÍèµÝî¬ÖOJSÓF¼­¥³{ldï5kåÒÇF ¹ZÞ±µ=Øèó*ÈÉ.¢u©úU G»ÉTáMðtu íܺµ©?æÑã¹åªæ¶BòŽÝ{ÆÛÝáµ|"831¯˜£»wm"'¦7ò‹-ñ…©jië–m»Ú‡{ñ#u6±0™OµµtlÚÚìoÀ²9˜š$5Uv47µvAç7±¶2&­• …¡¾¡†njU§r«KÕÅÕ•®Íƒ<·¨JÇWGzì¦æØèøø¦hW[¸ovm­0í+je{nnïèÍñl¾2ýQÒÎîëëï´/ç3Át2Qµ†»vtm“[¨~??¿be{¢cCã]ºe%gŠñåt"ŒÐ,°s´…%ñ\<“¡°<ÐÓÛÚص8¿üä“3ˆÛö‡ºþ2Œý+J/N —ó×ËlÆ+~åjÙ¹ayoY­›1v¶±ÖžzꩵDZƒÑÑ'—`‚â*ùÿö›ùùû´ñ‘‹'}ñ™ï~é«ÐBýùËùwoú$>ñ7ýì{ïQƒê~åIÏæÖ wîOü7×mëü?Ÿøq¡]K5)ùèOFÚºnÝýg¯>º¢Ùž±–ÿû‘ö¨¡/ßxÇOùìl9nÿÙs¿¨dRÿÆ—Ÿúà­ý?Ùýƒ·_|öƒÃcÛ_üðÀÛGÞþæÃ_?³4õÔ›/·í:xþèß¿øìƒ_}8ã2úô£í»ºO­M>óÌ/î¼óV¥%ô—?¢v6¥=æ~öƒÑ-#CÛFþîé_Ô›´ûÿÓOþ²iS÷}»oþÅc?{ áŽö?{ì¯å€~ÿïò٧ϧÛ{GþâÅÏ%—¿óð7Þ~ãà‘ó'ZF‡þêÝÞ;yâùæwξ}dÿÇG¢;Æ~röÍç?ä’¾–J,?úêÓ-{>Hœyäïú½/>Яýû7ž÷wNK?{ü§_Úu]kû_¼ðX©7sôåïÞû¥/,¹gîklŸI.>õ˧oß»—îÞ/¼ºŸÆÓÙøSÏ?;¶{g¸¿ûÑ—Ÿó·Eè.zôµ×¨q ¸$â©¢ºY`tÄË™$Μᣣ'zè!8œ?9;×ß¹:_ÙŸw¤Ýygt–——¿ò•¯,,.Ó VàÛàÃ0ž}zÙã‹ÓkPM¶u]Ó:ÏÇ?]™9??ƒY°©½÷ú¡m,Çç.̬,ä‹ÈÊpc;Žú¡Ó'REÈòÉŽwö ‡%íØê¹Õ$&rµÕ½¦uSS4v6µxfq&kh/5ÚÜ>:2úáâÔR6™XYÅnÆúº†'Œ…³3ÓF ¾i×pwÏpËТ¹295“X‹+²Ê·ìœÊÎÌ-/¯¬Î©n_w¬uxÓˆévÿø“¹¥EØ:¢‘ÍÃ#€Ð/ÎLÏ,-PëÒÝÞ1Ð×ß«¶œ™˜N.eò…–PxSÏ@g¸åôÜ… ñ¹t¾ÐÓÚÚkjìš\˜^È­®f³á¦Xƒ¬_ß9¼š\9—˜;·4ë h×qKÛ®x~abjr.§­»«©iw× ;_Ú·8‘NfÃõ4µîêæi=ÿi"ŸA6‚ßíÛöPqtäÌÇ éUâ±XÓ-ÝcáÖ¦c“§ãYê ÖZCÑáF®sˆî`OÇ-oö‡7·l997qqn&“HÑ$»¹16¾uËÌ"w2•Êe4ŸÞˆŒŒ1¦Ós³KKK”-FôÀØðPѪMÎLO/ÎÃ/ÜÛØ2Ø? 4:a°‰OÍ¿ú³§}±D´^ÄìÑÞän®(¹ü‰ý<òÈ­·ÞʆIÖÁ9W<øêÚ¹A Eÿ5á$B.š3Ö_À|¥ÊÜÇgÕ¤Ùë Ÿ{õ°gzµ×Xš:çNåºÝÚÄþ·WNMBØlÏ'íùµO`åĹ‹o ´–ç“«Ÿ^RWÞ=;ñêûƒRƒ½˜IN.vúcå•üû/¿Õ.…=ñ\áÂb8W ª~7äVHt%ÏN ¯™ï<¿ÏoֆܑâÄLKÆÕQÑ>õ¢;cvÚZyz¾qÍÑ›ß;øvbj¡Oi(Î̶^>qìÌ…““mJSñ|Âþti‹¯%snþÔ[ÇÚ]ÁòÅ„y6>êJO%Îùd“¯Mš)¬ML‘ëZ›˜?úòëÁ“Saéèð†äŒõÉëG½i³ÍHOÎÄL ÐñÇž«Nfº”æøÒª]$Äç=qà=m.ß—W¦«M¦:ÊþÉ7N¬~ ;nkjf­°ZtNú wn¾ßßdÌ%Šó«r8ñÉE(4ûƒÍÅÅäÒÙ©¡ÆNöŸ¾ù^—s­² ðÿLÅ9¦Ý™žÉãrezß¼óÌ+QÓÓ`ËÜ”²f5[>8ð©ëï ´,;HÛÝRôäëïç&W†ôæܧSÁt¹WžùèäÜô\W´)5¹˜™[lÕËãùÉzÏÆ玟nQCs§?þøSYSH¤RpA™#y*¡Y¤®øbF´s xÎìâ°ÿšiöÿ˜¬ç/{úgÏžÅT£ðKóÓ³XÀòü²LEGо£BwʼEl¿Œb)˜gA•‰P¹¤5¸Uô-m'Ó†AæI!Â_Ä9ËNH^0;èª_TÙÛ5#@~Ýä'¤b5*šåxÊ!yµZ*ÊtXõÄ\ $ˆ7Û´ Xtw—|Tò»üÊš]̳UªµWÈ-›®.š¹pÎÄÞM­Xdß);G/Ç`™(¹IoFØ£Ón8n€¾«ä(Ø­U@C Y°èêV¥‡_²R’H¨<¶Aâ D¡DSͼñQs‰Ö”°dÅ°`Á €{Gü†tÿôý `kÀ›€"Šª¿Ý” 9Ps¹UòsG³¼°âÌ |ø°bR¹ÀS"ÏQtÕ ©†?Xv—r)ÌTRÞšJv÷5ì2âàt¹é: Ô]„ß+exµH»Ð³3})Y ò}O“GfO¢b°ÏÙTÚO¶£ã Ú‘Öz€AI_6OœÜ -ë¾ÿýï÷»ß]×ðìܶý†õç/Hg¨¨~ýÅ/~Q0òð+C IöšÌ°Ð•t j1‡]]1 Ä4“Ϭ•óZk–ôÝlfx3iØæK°ÒÒ˜5Ou¶uí¾fÏâ"]mV`‰¸þº›Â‘èù‰I#•îin¿}÷Mélü4dù)»”)°Aë¦ÌB5¬È±™ÅE9oiÐÐy½K©d¦HK qíF-ô…;ÕôÌl±PܳeûM[vO}z6_óiÊ­{o¸ü g'³ÉŒY2³¥Bɶ(K#a¾\ÎzZÒðé¦3>òЀ…*’AÏ ¸) )Wn»þæÆPty~É(£áèî¾7µœˆÏ.º¬Ê®í;‡††g¦fªØÖ%Q–_Mþ[M­]v ·•å/¾°^(“Nsªrؽ¥¹•ôJ²·¿ûækn¤ `|a%¤ùo¹éV¿æ?{ê @ãΖö½7Þ277¿²’€áѳŠ0îæ¨X.gË!%ÔÓ2—Xá™CjdóU ¶&Œ"¥r¾ Gn¿û®t6·´°ÄšpŽlžšš*AìãQî¸ùvŠâç—–`£Ý´/mÓ…f®µ ­u1®e»QtD)»–©äK¼ß’«¨’“‡„ ÛŠLmó•^È6†á®]»n¾ùæKåüÒí+}ï*Ø·aeþÒ%ÙÙžŸŸâ‰'|^Ú@ø˜ ¨“dɯS&HfÄqdÝÊ)Ùöu4í‘Ú#ÛÇ¢ (4dÑ€†T3.ààÀ¦ën¸eÞÖÞAÞh÷®Ý}½ý‘hð° ¢ÞqëM‘M’Ù\–Ô0ƃD¾I…òÕ×kÛ½9<ÒM[ 3™R,Vø"«8óæhã=wÜÝ×Ómˆ¦Ùß?°gçî¦pCg[[6Ÿ»î¦‡†‡:cm(ç|:#˜p|^£fº‚rÚgµß0lw‡TÜ]Êxu€°ESZGš¼\¹û®»‡‡Ú[Ú4¶1J÷Ý÷¥X¬‘NT.»6¾yŒ_¾¶»»‡Xº`k€ž¥°¿¨¹Úw FÚƒ]Íéb6ÍR=²‚+ Û§mŒÞtÃõ±Tà1D÷Æ›nŽ5·4ÆšüªÞkº~ϵèlN›XIðÀ±kmÓceÜVpSWÿõÛ|­ °çå29Ë:”–.d´Êwo¿ýÎXScWGW.›ßÔ;pãõ74Fc‘P€ kb0Ž¶·bö,Í.è HÁ(¾UHñºº¥­k°ß¬Ùô­!&9%‡:}GÈR׋E1Î9E6°=ª.„Å÷ë/d3nçηÝve»>_®|ð¯ýóž +ó<ôõ%ÙI´ ót&¡k³ ˆ"ƒÄ‚gÖ#%¨|}ÊÑ<Û»{†2z¥ôiMtƒ¢\ÃÌT¶€‡zíÖ;ïtÐïTyÑ&N p']]Ý}½½º?˜È¤Ãz8túüÌpõi« ö47Þ0êêkZv—Ôƈ[rÏ¥ã]†%àYÄþÆn)ä –—ÁÑÍm½=^U)ÒÃJ×·îØ ê>›£ µ3++Éø2Ñç¼b§›<¡k¥¡æ”¿ZiTõ†°±š,¬¥ý:qøøj½ƒã»waWM)Ú¾e6qÁ.+š>´i¨µ©•O>°µ 4ÏLÎ.ªº/]ËĹÇ[}£mÕ=)[jWCÒÈx mkà–A Ô‚êÍ_¸+¨‚“ÏF£QúÏzÀ·Ã'mZí]¬\ÐcÐ÷2Býk&.¨ºe\VBýíÁ±w{$î1#mMTæâk`œ)Â…­Š'¹mûv¢åT5a¡Œ mîîè‚õû¢%Ý:6ŽçEÔT U_[^f½NÙ…Ew!ßæoÙ½¹ÜíÏK¶ÜÜ檼š÷QòŒÏ…é/yµ™)ŠŸ]œ9@LxR¬µWÎÕ1ðwÜ»îº ]ðÿçêþ1¯bŸ]›£Û΀aÛ?óÌ35̭ۢŠR9pÔ·€â„|-`Ôð”##=ò–®”õuÙ¥ÉÝÚÂa3•Eæë„yk˜ô=ÐÐöù^ÀŒlhˆáÁ¾ÿλÇmhhnmÁê?räTQšæËÚÅ`kãöþB‹ž¼×T†{ Á’\ ÍÀ FŽ\_¡_]o]Ï<÷ì™sg»ú{Y¹¦§&Ÿ{î9IJ««‹Ëï¿wôâéÓ>E†pÚl£×nò 6f;Ïâ!A¥ï,™„d!èžÄêªôÓ€M÷©ï9ºˆ£Î`8”L§žöÙÄòJ_W·®ªï{ÿÿaï½£d½ÊsÏŽÕUªsî>9è$åDP@$@ Dl²±ïžxÖò½kíY3ܵfþ±×½ãc°da°Á€D’åprΧãé+WWu˜ß×ÏÑËæ«ê¦e챪ûœµûÙï~ÞwïúöÞ_Øñø©“Á…ÅûÜÔ•v´0*­^œ.J̱¯²¬6\ÃÎvóIo16µ´0:9±­{C}]]OOÏw¿÷ݪÆÚPU5Ÿ/<ýÜ‘ƒ‡6lØÀ¡’|üüâɧXµJ»S§7Vv_·+YHU—eY[SZB;;þÍG’|m±4÷É™éºÆ†––“yâG_¼pþªW1¢>ØÛûä“OWT4w¶“ùÃNŽ3/ÆB…Îú–›®J…K#¡4S0X,Xª —™ƒ¸Ê0ã’eQA¦øòÔÏ°bˆôÈyw.o~>GyáüyÌfCÅ©úò†ë¶·6ͧØÚ™UkÌi¥Ã©²™'¡¹q–Ô±ïÙ& ð!séì¹ÇŽÆ#‘±Ñ‘o¾ñG?Îsrbd„^½‘á¡—^~i‘ovÁª* ]³¡öÚÍ1v°gU+Ù¹-²Ò¶ÂâøÑcÃýƒS_HÏ7TtÞpU¶¹"*a:4}Ü`X¤\]f«„y–î§ç«gfU{_t´ô>+Øm5h¯ª'ò­ùò>ßÑÑñàƒÚ[ý:hðüºu;OiåÇ­Z“¥½r¥ŒùŠ£#GÛ\x·|Ê7Sªæø”ñɱ,‹Ü;ÂÑlÂ{+,eÕÙll2®«JËcc<ûùó¶™g™f0@?¯‚ìlÏ¢øq^¼#œQïm"K3®VU7×M³š¬¼¸éüÿൢÔB&‹o†ê["#Ö~Ðw—]|þOs3¢UóÙÌJžd]"²ÙçŸy–¾æyvÖ¬¨`‹‹ú¦Æ@(ÔO£ms(-kÔ™dÂg|ïÄÇݵwwNœc-+/ |Ê|ùoI93ÏØÉb~žãâyHÇ|$<|ˆW!~-!•‰7´t¥ªƒSÑYÆÿ‹ÃÞ6zlÈþÙÙxzv±†Cå*“‰‰SŒY™;:6Æ 9CüÒò@€q¾¢ùO‡ßÔØÄðÔ=ä¤Ën>œYUW}||°º±®¸ÂÛŒ©îìòMeñŽæš¹ÑªùT„_=—LÌG÷¿üJÚë+®®¬âöÊ{™.{NËeF-+ Ùí:FçEuyKKS2Ž••5×Ð#Ã÷FÒ±L’îLÔda:á-¡Ð`åO77zoPÅÛø~¹FXM¹$$]œöð3 6¼‰©Ù@IDATnŸó”ˆŠ Ÿ6Cf¬õ[ßúÓÎé×¢û†'/ù¼Ù±_Ž÷¨ç¸µÅÌÄägÄÍÕ—'++j«©.¼©¦¦fÆœI\*O°Â”.,º9W–1ºÒêÐMo¼…§+‹IµááñF˜Ø@’Ñ8¾¡'LL%gKØñ¡%œõ–À° MI2M^êË>ß¿c‰w:%/·•åL,Aß{öîÞzÕŽ¡±Ñ=»vöœ?¿”b—G¶§ xÿ,//‹'“—G†3%5¬$-*a :gl0x•î›˜9Ñ¿8 ÍÓ@oEˆl9f#3¨¬hjk~÷»ßuòøñ›¯¿>ç&6F žwÖL*µ(ŸMÆG&FÓÙTUc]¨¦šæÌû6 ‡2#‘Ùƒ—Šú¦Ã©Òà<ùàæÅ=‘‹‘)/cémÑÛï½7·67qŸf[PúÙÒžtyO˜Oq:ÝìÜHemm ¡&Áá2Kô®•g&gFO^ˆõŒÌO3Xé=…ÙœqM.Ku ð,^½oïæm[FÆG6ìØ246Ì WMEÈÛ¶˜ð6³^òæÅÇfæYgÌ'Z€¯uvØñ¶îNOq–îü$êxK€hõ,íáÊNÄ´{Þâ[DŽóîÿ¯:~“¦xàڼ걯R òïz~ÎS Öì4û+A¢^©³¡¥wÈ }lÞŽUKŒ&-×7]³3¹9<¼åÎ>ôe¥–Ž–ºv·ãAWSTÁy2Ü*XÈÙÞÙÑ?2ØÖÝ}ûí·s\CyUãõ7ôx›2-]¹LÏpq¨œ£m5-»6Wln‹9÷9Fre¨Š~¯Š¥áþñéþ!ú“8{™¥ôÆ3«?6áà f WÇ''¶oÜ›:~ô(ŸúÏ_ä-c~¶–¦³sU[:÷íK†Ø´k>ÅþEÅ“±eÓÖÙxÙìñ>zÑ™c…;ê774¶wuž;þŽ;ï¼úúëÚÛÛëØ@öüýŽ]W;s–Ýõ¹ÅK³Œ+V6Ö7oßVÒžÉÒÝÀÒ]Ž© ´tuÍGÊÇXiœgM/÷‡Š¢`Ѿ}ל;}æ¦ë¼a-V4°ß«fcQÞ„'#Sl}Q(¥q§è ·^¿½„­q8lŽM¿½ÛñBMc]ãu{G^9Ëy¶5l”Ðĸ2)ÒÑxS¨âï|'³Û:Ú뚇ú&Ë&êêéáfÊÒü¹%Ž›É6v´Ulèd/±w¼pÂUÕ¥±(ƒ™S¡PïVÞóáÝé½Ýöh¾¸§äm¸ä GÇ {(2“—S Âuûœ÷Ý’)¿óçÏÿûßO³}§¶ÐhpâÅ‘;½:Eô/-wÖ…nޖꮉrö ¯4XV[Ó·ÇÑK¡;cÍÇR IöiçT´iÓfšzYiyoo íjbö¹'‘(ÎÞqçí{vîì¹t‰í«Å™tseãµÛƒ»ÚÓ,L/^dîL°¸$ëmÆ9ÏzϲPM4;·Ao‘E¬¥¡à½÷ÝGOûÀåËç/\êjªkxâÿytxtßnÞqõƒc3SÑ¥L²¾¢doWõµ[8ÛÁi¶~f>QˆÁº+›š¨ÌÃSl¶É@4«†ß~ß;vïÝÃ'Éà=ƒMí?øÉ.ö÷644¼ûþwѪÏ\ºÀ»ÉD ãujܸm¡‹ýùÒ©Å,;JB•ôó³g)[tTTdâÌ*b2[ùÂâüÎ}»ßôæ7³ˆm ÿò¥Þú/OŸ=÷â˯°Éw½¥{cwÏ`l>å+¥!Ô²mCÑΆl9%¼¯”—ñ’ÅåçK€·‘êšx$–‹°¡ wdF+ßúîû«Z›N=65=íµ®ìÂs?y*>>}ë 7ßpÝu½}é¹ô,ÇaT•Vïé®ÚÕ•¨.f–¥7áˆ{íò™Á0‘U³!1løËŽÞr:oý,½¬ægYsv®,ÇPö:÷‚å§ß{Œðœg²¶b%7\ `ݶy•œ[*/¾øâSO=5OÅ-)ãåÓ¼¥»˜ÚÊihœVÙVÛxõ–솺ɲ9ú–¸-Txß3|Ç&˜œ¦ºÄ“94_67ã ¾â À ¡ÁAž9ïyß{Ù:¢¡ºöÖ›n~ùÄáx4:2xybl³y;­ Õ55ÔÓ;¸ÈiMì™ÁfU¥eý}ÌjŸøÈÇ?¶÷š«g¦§ßóÎwõôõ>}’8}.Ƙ–ßPY½½3tUGIsU†O1ö쨤ëÑë¤;èp˜ æKJ#üPvÄâã=™Höõô¾õmo½çÞ{FÇÇh«¼µ8t0‰?q<šà…Åm ;9?»f–M%*øîpOL¦R¼¹pˆ3SZêÃuÕʼnéï(^6·KshLÙ™“§Û[[?ó™ÏÌÌF;:;l£Gƒ½ú‡–ççÏW–wìÛÖ´¥k¼† ´J9-,ÃE`{úRÙSoq©¶º¶=ܘpèƒð^o[QK ØäÁ÷>ØÖÚÊy÷ÞõÖ‹ç/]¸t)žNö]àë`.TÒ¸{sÕîîhp1Îì"^ÀèW á/.ÑgÂmÕÛ]›9˜˜ôöçãŸïÆ2hÖÞу,­ô>ì=çVaÜ ™»ÉB.G’Bô×m›§0ìQ/ðøã¿òÊ+%•U”¯÷QÇ.{ÂÈ< ª²Ö½›ËÚêb†ëy¬q¨d1Ÿ¸ì‘Ëä\ÞyA-š[j Õ×–Uò¨çAG¥™äDéx<‹ÇÞÄ’¢¥Ÿ?÷ ýÌ q•¨4¨ÛÜÕ°oK¼²8²Ä¬ô¡SϽï1Î7p†Ñ©è“ªyí`–(ÏϹìÔÄÔØèØÂÜüÄø$ƒx3ÑèËG¿|`"éà»oãÊ Í{·”Ô¢éX½•Ì!gy*v’S"jªÙ’ÃsŠkjk:â•ñ(óèX3>7<<:3ŸàfÇL¾é±É'~øÄ}cã©ô\u¨²!\|Ó¦@c§¼²³;ÉѵÉwÓoQáSˆr<0Ybƒ¬X‚i¯âÑ©‡½‘ÄÔø$c$C#Ã/¾ø2/£#Ó“üØòš`ÛöÍ [;ùÌ™ /2hǦ#|G0 ™ßËâ¶e'Ïp 2D7(ßþÜçg‡Ç¢CcÜZ. 3]‡·€ç÷¿rº÷âDlvtzš—#ΪÙÙÞÞ™®)M2öÀ+x)2fMÐQà`!ü\ªY*««¨œ™œå†Æ]ÕûŒçÎÀx ;)yûóþê¦î:ªŸ'ôÛ3ÌéV§Blçnž ~°Ñý1+a*Q|jÒ_Í”8Ê•fÌÛßs4xeôúÛJY‰uøø¶Ià•›‡;ü<8‚Ì(1ËãSîŒ0N@ºÉpüaQ6=wà•ýíícS“§ÎEçítAT6›œK=yâ\ÏE:×x°s÷!3Ìäã’õé±âåòСC½#SÉ‘îÌòÍIº§N:yücòO>÷4»qó Ò‘Í22¿Pœ}éàËgOždb<ÛJ2qÝkUìõž¤c³É艋gÙOw)Ò퟈ÅéùgéøÔÌôOúS¦²¾øìsS“|í{éÊ“ñçGœî9wì쉩™É26³dkÎêö¶…f)2óU•A>^8ôòàØ·e yCLx`¿ =íµUÕÙtöĉÞE^`ƒ®‚¼eLLO½|èÀ0Ï|¾¡iìLÝñÞHè‰dPÓr˜uóÊþý3 v'›ã¢q«e!sç¹n,æãõÿ•C'£³l+Âœ>CRE S™ÄÁ“GÏ^8Ëç9\e0€DùE¬ƒ`D”ûñ¥¾ž‹==Ü9p‹²æ?·c®¼‡™Ÿóë rˆið\:˜‚ûub‡Öm›§äTx´öžžZcS¦4ÀhOÉŸ¤Ôö@õÆo3£“cÍíÍ<Ɉo‹Lã.Iγ†×ä¹b:Ø8ß"TZŸš(M§k¼Íí竨StãóE^ZÅps}%_ØÌ›£Õrܵw2Fék«Â-õsÑøÜøLu°’8Š—>Q†äïzë]MÍ­õ5ìÒ˜›ã>ÀŽƒ É`IÓ®Íõ»·pxÕ|/ÜéËäãÆ;?Š9ÅìcÏXcIyM È:Þ[ˆó6ØgØmiáúk®½æªÝ¡Š ³úÇÆGy9çü,˜eƒÝÎÆö};í n㜆±¼yE ‚×,FæØÌ›µÒbfâ6ÍE’L¼g$†iyàŸ7.îÞ¨ír“ö5bš7Õæ{Þó&[,õÊp‚uûœw˃ç-óg˜9ç½6ËçTeZ 3â7î©Ø¹!YŠ±G­·`£*É”NÖÄ$¢ ,…Ër‚~¶.T½«;xUç8]9Õ¡x¾¶)ÜÒÕÖµ}ç[‚å;·okÝÐîuÇ…J"ÁÅÀÞîš›wL„æ*Kè¢_ÞžM⊳)^Õ—Øû²¨²b¦$1Qž ]Ó]÷†‹]U‘ŠL:˜M–$Ã-UoyÛm¥åÙÉèHûŽÎ¶¡P1Dz@˜o •_Ó¾´µ~ű éÒH”ƒ¯1özðH÷Ø^L•d£<Ê:jZî¸v¦–ƒ`é|§/S*í7VU±$[DÞô†[ çK8Xœ¬.ªºa[xwG,HßÚRU5'FóƉÌÍ–U•qTÞòáE‘Ìl´¾¸é ;Ã{»†–fêx°òª½°°eÏîM]Y(KÏþõ;÷u4w––‡â‹‹³W»sSùU›—ê8·†ñ9î‡épeOã™ä«{kØïÂ[ÖZÄ<¨Êk»Ùbh®µbz)²X2(¦3±é{oðÎ É,nÜÈ8ývz:hα……ðÖMì­QÜÒña1ÍRßbØftqfa>Éé]ܘ€TÌ4Ö”ïÜm­K³ß7¯+4Ä« “wX׳‚Ó#_Ïynn‰×ís^%¤»27ì“'O>òÈ#<[èÖ¥QóÔ¢ö¥’q†³›vljÙ²‘¥ž êæë˪¼M¤ùêäX7Žˆ‰dÕ”Z¬`vÖp˜\[U³ .Ëi6S³³ô¥³g|k{k]eÕ Ï>{®×ûtg6N¨©¶sÏö@­·[. {J#)Vų¨‹Ã1X:¢ùP|­ïkŠ‚œ{ÇUx±4Ì—Yz’¬§/}.‘êhi#z<À’r&̧‚¥;®Ýh©£{-_Êbsa>˜:ìM›-©X( ³Åv$â$ÎLÑR,ÛXVøvl`”ýÜéΦ¯Ž‘óîî®êêªT"ñó§~63;ÃÌ"ÞœÛvoîÚ±™ñù2¢Id©Åâ¹,sçŠø&˜ËV³Õ|r©‚¯Ù=€Óºæ–6Ö4±ƒuÅ4÷.o¹ÊìôL¸šS°:è,vä(#Û¼1q€¿Lh`;­ùÚP$“h¦K:knß›¬«à%žsûæNLdh€Кª0Çi”ÆæyGáü>èH¬¯Þ²£®®îÉž/ ²—8·gοËmæöÐ9Ç7K4/ •mÚ¾µo{·ŸÚLi²4Þ3RžæDAï`Ìý,kNdŠùÎ÷VÓ±å?3óèõºèr3u‡ü¯ÿú¯ï½÷ÞµÔ·Bá¬çyxjð*ÑK—.¤Ù픎q&„ð-G—2¹Ój§’µÕUÙ™H˜;`|)Iz_¢[ZêKÓ'c—ú+ªŠËÓñRÞà½Q8Fni>Žy ^Þóœ.kŽRh¨ªá¹QYÊ2Ä•-JNÆY÷Ê[4_ÅŒ%ÏG³³s ]å5eÕ³œ |¸·>Â>0IÚ<]h šç«;Àܲ ÏdæÛ—/õôõrÀ^"ε‹Õ•Ì˜ã°‡òâÚ¥EÖê̳eûbzláR]Qqs[kfböâ³ÇÙ=·f±,>­ª¦oo5ÆÔ×Ô3/€ ÿY\,}óå ™Á z¢6”æX¬tˆ32 Ì-Ї_Äš4VÏ5íÙœI&'\œë¯g æÛFSlŽÃÔ†‚ ± Óa©t"ýòyo±@Ee Å!žÿËçI¥˜œ[´M†+Êb¥cññHÙÙ®›vוTLõ N¼ÈñÕÅE, Ì 6Õ6&fÙc®2\ËúÚã™äÁ“G¸àôóMÆ#¡šÙèl¸º†ŽfAÓëŸÎÎÕp/d¦Ëk6µÖ6ÌŽíåNÀq·hÁ»TŠÑ¾ó¹Ýz¿Çø?­z¥†ê=8H˜A~¦ù­/·nßíÝbbQäßüÍßô÷÷3ZFA²ÃûZqæi6–jªmøòý{E¾tÞ["’˜ãlæ/}îóì]·ÿ‰Ÿg.Œ$û&ƒå¡wÞÿ®î ›zÙ»Æ;ù”Y;Ùw½û7ßvû©“'çØmjÑ[˜ý¾÷=ôö{ßqñBO"BSgO¨…›n{ó'?ûû—zz§Æ§*KC‘™ØÞ=×<üÀŽ=³ÿÒ+'B‰%νíܱùþðØûýÂ…‹¼ì&æÒù_þôkt×õô^¢‹Ù),üü—¿Øº¥ëÀÉ£4Zo†ø|ö³ŸúÌîkö²<†éCÙX21qjŽ·zv×JÌÝrÝMŸù½ß¿40ȾhÀ»·nÿÊþá(K^.³}P6•e]ðŸýåÿJgåÐÉsáÄÂØÑsU‘ìgßÿÑæ`Mω³,‘çÒ1qèÓŸùtWW÷þcê›L –½÷C¸úúkN>5—ãñžÎ$ïyç½÷¼í­—.\`[+>©˜Îp×w½ÿá=pxúâàBïøøñ ·_}ãúâWú.\š¨fÑëllûöm_úÒ—é_ìïéåP[Z>Û†¼ÿSa£‘Þ˃̘b%2Óø?ûéO·„×NåhyØ/ðÁ÷<Ô^]s쇿Œä[ŒNÁÞù®7Üx ûöðO#gÚŸ×kè=Ûy†ó+˜zŸÿ9ïÝüÌfY?¿wï^·::^·Ïy½˜ñzà•˜éÙ¥Èü®%Fæ½ À‡jiYMå¦kvïXJõÄ&"SMí›7n¼ñ¶[KŽVì°eå]MÍ{o¹Ž 1¶Ù=™©ZÈ°ÕܾMÛX²~èÙ—#ã3¬ØkjkÙsË ×ßp˶“‡Ò½˜íÛjØ{ã57ÜuÛ“§&kËƇ6Ô7_}ËMW¿é¦ƒ½g¢% LaØP[¿e×ÎM7ìÛ:Æ‚½áèääƺæ ]›Ø%ŠWâË=3S3L»míê¾úÖ›Æg¦_:ŠÆ­íM ¯ÛÁÔôçO¼ÂQ¼LÕ‡;öÝqÓ¦ÎîöC/–U2igÓÆ ·ìÛýÆ›®?qùïÚ±s×õ×l¿áê7ì›ãpÊx²6ØtÝ®«nÙwn´o*IMr§nß±õº»ß8»˜lîdRܸ·lÛ±óækÜ?yé\4䕧©©áú›nœŒM^h9:˜¥Ñօ믺ñZŽµï:qdlj*NOgzΛ‰ÇN Ì žŸcÐf•nx* ÑìU—¨0 ºÙ¯Ûçóуçþ§ï{ßûØ7;wnþð>u)1vã;îøÐg>úÝŸ?‘©,ý½¯~i4›Ø~Ã>ÒýɳO M|ùk_*J×mjû£ÿö§‡ÎŸÙêؾöÕ’¶Ú…ÚÊ?ûßÿb4:ýO~ññ¯~±cßöÙlâ/þ¿\ª­ø?|ì}_üÄUo¸v<>õÇÿËŸt]µåÿúö×ßú‘o}àm£cŸÿôï½ù¾·ý÷Gþï«ï¸õ}ÿPïÔðÛ?üàÛ?ôÞ¿ýçÇ6v|æ Ÿ»<3víÝoúôWÿàïðTÙÂçÿóç"s±Ý×íûäW>÷©CgFû~ï«_I±:¡µö«ÿÛ=9ÔûÌÑý_ú“?,©«*© ýáýÚhyö»OþøŸýÔŽëöŽ.&>ÿßþK £þ‘ÿþ‡ß·ë¶›ÏEF?ùµ¯lº~÷ßüÓ#wÞï›îyË©™þ‡>ùðo»ãïùæu·ÜðŽïNÌÜùî{ßóðûÿéÇ?¨jkøÈ—ÿBlüê;ßð‘ßÿÄÏ_x.:—øä|a`1Þyí®O}é ¼ìýàç?S\_543Á¢)–{ë,èÕg4ß;¼îÊØÆmÉÔ‚4û»îºëÚk¯¶¯E—YpxÝöáñH§…«<Ø\å“Ÿü$åç}Àg½‘aNwfë˜Lp‰¿ø—+b?Õ¥-œ^07‰ÌÒÕ<29ÊœùúÚ:NDLp.]C5cõ Jw4¶°—U.• 1_gq©…‰¨¥åñtœqjv˜ÍLÄ•ÁpkÓå¡¡ºªÊ¶ú–‘þþªšpU}Íøô ‡´Ö‡ë‡ú««ÂÕÍ SÓå‰xkk{4:;25Õµkëøø${l¶Ö6ÌLNÑ›×´¡s.“ŠŒM6ÔÔ2oŒyï%õ¬h/™ÙÐÜÆ”ž‘±QúÊ™Ü651ÑÖØÌ°üÔôlM[S¸¦nfl‚Ù/¡Öj¶  WW¶Õ6Oõ]f‚}yCxp|„Aꎦ–Å™8[YU·7M§â³ñH÷ÆM‹}Sñlº²£y&2»H²³-‡ÂMÏβˆ0:=ÃpcS}Ã4slâ‰Æ–f¦eR³\%Ö!1«·ª6L÷“ Âá:>œ/öõ·¶·°ž­¯êk¼‰LMMÍ×W7V×OõöóA^ÝÖtyl¤‚m¹jjf˜h¼°ÀÖ÷p˜"µ±­c¬g€ÞÄÀ¦¦‰¡¦?ÕWÖÄ"vתílÑy¶4¶0´Áì纖&öÍDؤŒ±Œ¾ÑáêîV&ܤ'¢ô°`Ny¨2=ùçÿñõ…ÉGñáhð̃2P¹ì|mŠ|ÌÿùŸÿùg?ûY‚Ür9Ò-,ÝŽÏë>MaðzF+"Ul,2Ï&3ÌõfÍÆ<ãFKeUuŒ¥?{²´¡*¶a¦g{5gšgÇG†Ùv1ÔVsfà\cCMSmÕôèPU%‹oŠ†Çµ¡®îÖ³O-—º›Îô-íؾi`b [šíÚÐ651¼Šwµ7 O^Ž§"[·tG'F£Ã—wlèŠÏÇ{'ú7wuÇxŸL¶oéŽd’Ñ鶎6€<Ý¡¦«™Í«ûÆ.·w´f“©‘¾þ-]Ý•Å¥ýçÎ×…«™o{¹§§šîòêÊKƒ}åUÁÚƺ¡ÁA–ìlîÚ0><ÂIŒMõgû.,†J7¶5MŽ ¦’‘Žm'úâEÉÎŽ¦Lt¦(“ܱmÓù±ž‰ùÙ-[7ÎNŒ$f'w¶wÏGÏ lܼ%9졳qÛ&¶Á˜imi¢ŸêiÚº}x.^îíèjoh¨;uá st‚Má‹Cýõ´Â–æS'O°¶¿±®nrh¨²¬¼³µu`ä2s_ÂuLƒ¥ŸSÓÉdœ5¢Ã£Åñä¾ ›ccãÙx|sgg"Â^›³]íÉXtv|¼¡½)[4?84нq›^qÖ†î.6%dõN[g³-.ôu5425éô¥³-µ¥•Á¾¾¾ÎÚÆ–òªÁóêÂ5¬ æ$Œººð†înòÜ «¼ƒ‡Y<°PUÆœüüNÍ›ZÄØ©ë£Áó[Öí»½^Ãô=ÿØc=z”Ç;EÈÂyƯ¸·{Ë·™q]¼4‘Ž6tµ½áîÛ¿õíoµ¶´ÞßýÿðíÇózË=oÿþÄgßùÀ»žxòÇ,;{ë[ï<|èP4yàƒ¾rúHÏèå}âãçΟ;väàû>üþ¾©Ñ=ýÔG?ø¶ŽùÑ?øà‡>È&ß}ü‡=ü~&ˆ}ãoÿßÞýîpCÝ7¿ó­7Ýû–Ž Ýßú‡¿¿ãÖ7tìÙö|tçÞ]¬}ôÑGº»;ï¸û®¿{ì›uíMwÞ}ç£÷w-oÇ=ßùþw9öñÝï{àÉý,‰>øáüüùg.OŽ¼ÿ#zeÿ˽½=xøƒg.ž;qúôÃùðèðð />ÿ¡}¼wrðçÏ<ù‰~,ùÑO¼÷áÌfSÿôñûïWEqÑwþñÛ÷<ð­ÿóïÿŸÛßr';s|ó_ßzÓµ7Þzóß>òõ;¶]³{Ï÷¾óOMí­w¼íîo|û±¶ ·ßuç?|ëÑŠPð½½ïŸð=®?üž‡ž|êçãÓSïýÀC/>xîÒ¥OòSG>}úÔÃÿØ©Kç^>|ø=ï}ð<ûôÓŸûýÏŸyñÅçïÇ;™âô/ßûÞƒ½ÁÂ<ñÃÛ=ûóÝzë-­]ÿØ£·ÝöÆÎÍÝßùî÷Ø™w×Þ½ßþÁ÷:7o¼õ o|ì‘GÛ[Ûßt×ÿøǬ\¸û®»žøÞ¿ð†~ÿ‡zâ駒±Ä=øÜÓÏ0 ëÁ<´ÿø‘ýÇŽ~ìã?~àÐþŸ?—Ÿaç­`q›°¸Ž‘KjÁJMšÚB¯ÄÕW_}çwŠ³>üuÛæU<¼žáþê¯þŠý›xCȈn°2Ä> ¬-™K%™ ·Ô\ÍQ^ÿ®Ú±ƒ9GŸï932ÏÔ˜Ô†® LS?ßÛwj|0Æþ%%Í­íµµu=cÃÇÆ'3œ­œa-ZwS+›¶=Û{º7­ŠÏ‡‚UÛ·n»<6~r¤ÿÂøH$VTîÛµgtrêðPïÙÉ‘[.'3×m¹*3yfüÌÙÁ‹K%tSomk§CþDÿ¹ž‰Ë4'VÎlhke¶Ü±¾sgÆûg—ÒѢ̮ÊÆ`¸òðè¥c#—¦Ó¬çM·W׶44œé?6xó$YZתlij¸03xêòÅþäl<•l-«ÚÚµéÜô𹉑óc— dþÏÕ;ö\ž<Ú{ñÂôH’ù/ñÔÎÍÛÇ‹b'.:xê°·Ìt6²sË&NŠ8pñŸú#qFJ7´µƒå/éMÏVÏ1'\S{ìÜ™Cý¦Y˜”L³0¶¹µe`lìèpÏD*AÛª(*ß²ik„¥úz‡úJY(£-÷O Ÿï=1x‘5uÇÖ ]ÓÓ“'9Z‹EËSó‰¶0ëËçƇÒE‹ñH|Kk[ô»xöÜåÁH:ÅÂh_Ø#ì]ÿc#3&Î3;¨¶¹éôøЉv%âCic¸¥µ¬òÜ£K):þYËP¹Èx-s{–—ÐP1|q¼ÚüÎ;ï¹çb æÒTÍ Ë_·ïö*Ú9}ьҩDùÂg^Š·l£¬„ Œ4{ÛΕœ|éÀѧžãÚÊtÑ3ß25Ÿì=ü³çë³ðBàèS/–NgÓC3ûöBCIUg]û‹?{>vy23Ýÿ“gZÊûڶúàÔÅ‘@léèS¯ÄûƯ߰{ÿOŸ½pàt0Srê¥ãƒ§{v¶o=³ÿø‰ç/L$.¼xbòÜà5[GÏôüÅKKSéSÏêÝêæÎ]EC±W~øËÅñÄ¥§_þé³×oÜ]_xò{?ÎL&†Îüä{?îªl®[>ûÄ/X–žyöO…³Î`ãŸ=?vf`n,öËïÿŒg{»w¼ðý§F\\˜H¾ü£§SýÓ7mÙ{â™Cç^9žN~úå‰ Ã[:ûž;õÜÁ’Øâù—Žõ8smÇöÉ}G~ü|Ý|°çЙ‹ûO]·aW¤oüø3–¦ÓØá_žÚV×Y-ÿÅw~D¶g{FÿâåðóoJ={ 1<“ÙÿäóõEÁöòºçøäø™DÿøÁŸ<Ç¡ÍMÝùâ¹—ÎDN¿xtèLßö–n~þ±ç•¤–^øÉ/{Ž»ºsGÿÑó~ôìüxüè ‡úÎõ‘(§\½px)>ßsøìÉ—ïêØš<þô¹ÑÙñ‹ýÏ=ñÔ¦–öš’àáŸ<=×?1Û?üìÒn¨-­xéÉ_N dž'N½t¸bnñšm»X p¶EÇg¤Ó¬ö†oò:Z¸ê GÓz­å‘ü¼ê¯gáºíÃã­^¯÷tà}ô£¥ hÿHø&\¾g³tº$Tbalšy²|¦ÓÉĦ×1&™³”ka1˜\—EÙ'·”NþžÍÕÁœ8C_ø¸ƒ0å•u›,)áöÁÁõŒóÓ,>e£åÊÑ©‰PC-ÓÅ‚ÕUÌ­bgFöÕ^vìHÅðaS¸–5áÓæÀ*½Å’²Ì«G™J0,¥{‰Õ¤L ±Ž ©ì5I¥+g{Qmš}^ÊÒ%Ì$b¨‰¹gf˜°ñ[úy·3ž“b0È\™4Óê²KU<Ùª™ÏÆ“Ê2^s´`SìªL?'Êør&ex×—‡Øv41Ë=‘á oy{*[WžÇçK‹R¬±)/gú¿nŽ#>——ÓÅfÖwÒòÒX*ÉüDJ8t«¨´ ãÑh ‹j½iK?Š_ŸaN_v)˜-ª«³mûðp}½=3‹LÅc¡û\*Í”¹H*±,çªv²ô=å<¬D*ÉÛ¬ òöùdüŒÕÆL+\šç4š†úZ¼¬ …˜#ÈfA,d¦ZsÅøpc÷{vÂã*QB,`.a›ÖU±ò'9WɆ¢Òù…+SnÔ­­ªþðöw÷Ýw3k¹ª“ \é´,ÜðsÎZÚ£Ü*uŽ…âÔ°2Ö™/,0óœ}¬‹ «1hk™è\]E`:ÆÏó åÕ‹‰tól—«²ÅÁ²ÐûNgª«Ø$‹uŠ™TZA½£%§8+ÛÄ[&«h½Ö¹Dww°12g³öÌõZá"›eAx°´œ 6ªKÙw* Qí<;Å0Ylq!‘ ²ƒtq0žähº2V¦ðÓÒ‰õ5\RîÕò ”ý2Ø¥¹ˆÜW•zëCø-^KkŠ¼Eû¼·0Ù5™ZD±ŠU«YöÍ0á¿Ü ,™‹'ë«+¹ƒpƒcÎy* +“ñ¶p˜c-8Ížnø&¦ø±¨vžµ¹Ù@Yyth&H¦Š‹ëË*21üó¤L³†.Ìÿèö.s~G#ç‡Óœ?º`¥ëö9OÃÓû‹_ü"ÇÎk¿ }Ò#—ƒcdz‘X$tÛÐÀ¸Í+ÊìPp<Ûq¨ãK €€ ¡t• ` ¹E!1gŠHÀ®¯($¤¢D«T$Ç|„–%—l–¥+ïiüêë®”"¿×ÌBC(§‹fCl^¬"ðñE–YÒ%Œo™7¾˜ø¢É'ç*t3 X“˜ÓøI«&ÜrË->ú(Ë"¹2îEðñ (¸nŸóª<@è½ãVM“¦TVçZX½W…P”Œ€åàà„W*cbÝ(YÀǹrùòenþ0]YP®\kʉµaÈ–7€Ë6;2+ƒ–„Ë7SfÇU*òae4‚jÌ2k€ÝG\²h¹¾)ʸÂkQ·ÔÝlûR!?´p* £¼|ÂÐæs¯¼O¥P‚þ T(ù^c>°¡OdjÎ0@¯¿ú䤅¸•Ò80Å‘ŠÙ‘5ªŽ9I\_Q®ÄÅ$‡ƒƒPfÁHŒc)ºÀb¤îæ•×¾I\«èþ^˜",_6ï½Æ$ÈiÀ¬‰©+ìS¬XÈn”é®HWIçf ×È*LñQá“^“;”É\#'Y·Ïy ž~{õ!!á Ÿ:gu€C.@K#Öê[ùD0¦[Ì. ¹Qqi4 X·y[ÒD)E3hZf%ã®8ö ‚Ür]19‰ë‹`|E™à˘¹’FËkP±RÇ—3ƒ¹ ™5€‰®O¨ r³c€(WžWÑÔô¶ò­· ­à¢Öm›WI0%‹2ÓǼJ]õßu4bi~8ÑÜ*"Sðˆãã¸rI$+ i™/¹•´å›–‚bZ”1•®‘]š`€‚bʇXœ+KâÊ ‹© YТÜXq%Œ/ _·! "Ä™A€%t º°Œø„¯)ˆ**nÂ×däõI^çm¾··Wn}Æsø%–[nïWº¦(*U/¢À¯R®üõ¤W1—È@\šIà6-WH¬='óÙ—Ï‚Uq1ÙAä š–€žtå[VÐS>Á¼rÙ!ÊâYßrhWÅ°/Ö—:±bº©¸ØÔrÉ>AÔ¡©þä&—Ë/ÉznóÜ¡9»F}­ö8µ‡‰•劃¬ÒSÀVÆË‘Þû¿A)º3__v\v”.Qj&WB–.ÙP¾„ÆtÍ ûtš€B³€DØ$¦â¶LÑäÓrÓ&J±ò‰5çÊÁâ[¬ |º.ÓÅRñ‘];.Fq&±8zïíþëê.^ÏmžÕ,€çÁnC,|ØST¤ùVrÔi·øÁË%þ«¯}¥‹–K6#2k—F[5š«K}òñ‰Å¹BSô ¡ù¢r%®Šbå“7 ; ºõ >>×ßh&wSôÅ´íòÊQrFàˆu3æ#¿ªôkWâ` ž|ÀJ´_³åPTNx7Ôëýkµà{}ÁõÜæÙ¹AÓìiöV„vù‘p/P…*USŽ&V¥®Â†€C]A¢ÄD(2QH»4a¢†•Ù!43+¡Ë÷ɉRrÈ•$$j6‰Å™a‹Õ/"ÈOviH<µå_-]ùJ_Ê‚âE°9ѶËbF^NÿW/Yˆ2Ëc%ƒH\¡Ù4`ê–Õù®"å‚ŠÒ±£Â5Bá‚uÛæ)Zzìµ™%G©ÒX%P™©¸¾äF³(€°4 ’“ ÎULjÙ1A|ÏÜr&ÊÞD0‹ŽL »6=æù½Ú+Ž.L׸È+ùºÄ¢bZ´$ÜßeF`.'{åÉi|# 1k&tA®Š –×N®AWb (Ö‚²ïªøR\)hÐóœg–d+Ü• E¾žÛ¼:íÙ€ÕJËŠÓ-„r(lsH\²aäâ¬!‘µÅÂȲ€,@“e³#Ž„â˜/ESWŠÄ’œQ–®i Ⱦa€’@јfŸ(Å*ÊRH¾¥å›ºQÆ÷E­4­U,ˆã#t-+hB©˜¿Òõ1 ¦( |]"Úç9Iž XUE–ËîJ!É-€5–¥¬¡.#z2[º«êKrå[ZnfG4j¼úá-Ÿ²©TÌ‚€kE‚JW*>²T¢²é&$ 7EY^)ÊM n0/&·¢Y~ø}öÅÁ'ÖìH… Ènr†ÍŽY0¾ÙÉ à£+_*ä À‹½úí%´„ò)á:ió*-•#É:ðhöÌ´ç>D-DL+9›•4À|88$ªð±#S`*r?‘ÂøèBÀé›E á/›ùÕzuä2+‚˜`\Œe%ŠÐÌ*ÃúQ$ ,Iw9¿úPƈEŸX$fJ*øºdE!‘eÈ--q,Ç¥)E$”¾)&´|¹L ºP÷7B€‰',#æ –Mñ_¹òëLhפÉÛr\¾|YÉq•L·pÁ:ióVV*ÌÆ¡ÀX6OiQ]pn‰‚UŠ¦h9΂LÝ#¨&!-E¹ÖŒÐXN· 3˜«Ž •yYs1 ø¬DÝbJš_-EL‹Xa¥t-(u|îY-•¼fM €åAB]$®}KÝä˜5¡’C€ÜU”D–Í—.4NY#6¾ÅZP@P¡ø¨H¾Ø‚®‡6ï–%EN-ÁgO{ŠŠ­T¢”œ•|+féZP%/`*ªyø8L¡¥*hLÙÁpåºÅ1ã"˜b^¡kħ®T\!r«w°éZêŠ2¡ÑÌ”+Ë)Ö´Œ¼v`é„suIKB\L|S4qcWÂ>u bÇT #Q@ ¿@Ázhó\z•ŠDþÀÀÀj¼8´ÅZÑZ±…G €€P>£É ù"À„ Û9ÙñL;•Õ‚ÄB³¨\ðªï/±>ã‹éâ X”€OHÐT\&ùwƒÆQ“³(]ýXý‹A‚Ô•ˉMlðˆÍ–„tͦ˜Í|bÝD}A—þÝsÞ.ÈëX=à L#'Èy||œ×rªš*1Bœ[Ÿ,÷*{ÑŠ‰¯Ö0¦I¬ºˆlÓA>ZÈÍ>d䊒oê®Pé"ñ##÷ñ ’Š"Véÿ7Ÿ5ñ%+,uŸ‚©È‚Ïwc͈+Ÿ(X>ŽhË1¿*Ÿ} Š,E®HêÄeü]›_ûuûÿƒIÙXå°bf §Î<TQÔ”-$Æ«¸­Åý(p%*!ê’ ‹dÙÞ›$*!r%ªX×Z.†‰“Š—†‚>Ÿ´$YÖ¾òtuµ~#–b.Íwé ¹WI9”˜<‹“P³ ñE†£(‚æ,HërÌ”h´Kmê>BÞ ‘--Iô×æíú¼ŽE®ºBžÀtàÍÌÌ !(¹Õ —I”ÕE—¬&…Äœn(v \ŽÅW½ eBN€eÄ‹~5ÛfÖ¢LQ4|IrÛ¤©ÓfÙgÐä"[,rÊríöqÜ}| èKš „⣢ ÀY¬p®DÖ¤+œ×÷Ü´xm”Ù¼Š'\'ßó@¬²Gê8qòª•+_IÂ[®~»k ²—Þ«­”(°,YBòƒGIùø"ø„"+­å_ã}Iˆ/|9$Rwµ,J#²pEgå?¢áë’âóœW¢++RLÁ·y• žRQÅ¢vÒiÏZ¨šš$*9Ê ‚WùT‘É JEdäŠ224’À—Ü´T”ÈÀ¦ñ"Hhr„0å[ê’HFnq2…P ¡¢„ñ=êr”~¸%´D‰5¿ÅTxÖ »>™AQ|7uÕ=8`6•–eÌ’ßÍ0uIL] ¥"u$攢™5¹¢à”0#zŠÈ·~{S,hPðmÞ ÌŠ g˜»Áܲ¢5 ;hYc6]‚.9A¥"_L5Ó2àrÀJ 8ã˜M.gY#¿ ꨘƒiص¼Rá B¬€|%§+#®O¬$9 *u©‹f¾E){R±6lÖ° ³¹dËÌ*œ\-WbYâÝƯ+ã |›W²«OSB ÔQBn©ÁŠ8 Š,-0@Ø.!A©¸¾äyU É¾ÓgŠXIŒPE”_,AåYòåt®dÒµ&ʧ+ƒ¾(úȢɦ¢\_éš®há(ÊRÉ5+²Ïwi2+k.Íäº*H”´Ë_ æRëzònO¥bBÞZ´^ÿœ‚oóºÄªòy²÷R· ({?L×Á!H XË+Ê5’WbìAXQ2N5≡¤%'ŸÆxùsž–â¸|‘ÝTÄGâS$(E‘eÜÔ]²d(‹ƧÒ[fÄ1]SQnÐÅÒ5S¾(¬¹‚ºnÆ·äLÐ%Â}t•.¾ì¸ªEüvµÿ5Z{Ó ¾Í«¨Üòf»b©´\9%!²Š„(_¬>ŽÙ7²¢äÖXÆ^zÎÁ’CˆEÉ”/˜k_³¦ õ€sù.Ç•6‚$– ³³lò×̺*FCœ«n ˆuù’ Ä »daE¹XKkÝ\kk”X&8’P*kTÓ ¾Íëúª`ôL`»[V×èYM,Q¹eà¡ør¦‰t½2_vtŸ?n*RÁ‡. €@ƒ+ bq¢YöÍ7$Æ´Ø\¡ËÍ’XNÍû9’(V|W‹{¥OHÎE6ßµ`BK.¯Ü'$HZr`t]r7(²ùŠ'—éS\KÐg„ÌX~(/ÜZŒg=´y÷½‹’c—R6Ì ¬Ìî30·¢@X.Ö+ž¯äà›#JØ8J!@¾E ˆ 6o„rH ]2BWnA€ý©ø|_Õ$Vv\kJN%êúX œhø`ȹ–]-°%a¿Å’„ β$a.ÙgÖ,»Àå`Ó +!“çåXl^ ËWâÊW½Ïf^­‚®Ã6¯Ƭ2å-U•¢˜Ôi€|© ç3窵ø„nP¦¤¸là×Z»ËCÎ+1uÅT›t *JùÁŽ«¢ ŒçMBBY+èˉ%-‚ì›Ð—®,ˆiø’ða®E"ƒòá+K¹Šyi®,-|œ]÷7úø,ø6OÝbpŸò x¨úìp rR1x…¶,' š‚øĪ,ÕÎYco%ªX1Õ§•kJý¦>A¥‚Y–µKT¥eXù1¡²¡XL è'à˸‚R´ÌÀ‚)Z*ŸÐMH*XPA~¬åßµ¶>?å‰t- ¥‹\“ ʸT°€DZ¨[ºnBÄZ”´DSr.ÓäâôéºdE¹ørüd:ƒY²°é^.³pqÁ·yÕ-ù*-FVhö:pÞ-b ŠcrU ·ìsi&AËøª¦ Ê,¦LÉW*¾-i˹kJ]¦òàJ|_Š–¼Šf'7v%‰µaÓ5`I£kN?G¾²J”OEd ÝX£ýöÀ2à3…ÜM‘ ,JÀnú.ÇÈ… ¾Íû.:I!ჭE‰†DŽ Eès>S²`Š bPZØAAß•[Ð9¯/E¢DvƒyùŠFB8“€‘›$WÝŒ»Qâ[”«¾Š5 &³Ü›Qhr)–IDATíZ”ßø1å‹cù1šI|À´|ò¼ŠJË¢¤+¡«ŽDB|»§Càù¡×:‰rU |›WÝRax%¶<»Sï`‰9„ïׯð^åze &V¾”¶ïžbd€tM™Ðùw-#ßµ,‚|ÉE“¯´,i³ìtE3`±2ëf˜( *I.0 ¨È‰Ém ,_4°h®M$\ŸA7èZpå¹Ø˜ØtcÝ X4bš.A0—Z®ººš6/¡kǵ_@¸àÛ¼®5%¤òçÁ«Í¯T pä^-SïÑ- fÍtáX³„féJ¡ª‹|Ó%hÎ8³V]‡æ“ô9KËä¦EfL@.²›„>šÝX´L TŒéÆ4¹$ʺrÄ"ÇYÛFŽ¡éJ(²„>‚1WÆ—)7³«hYrã“[G!)ÖÍêJ¦^ÿò‚oóª[na¸…í€q8k´ ÂDl*Vð’ˆ&Q8jƒ‚‚¢Yó[¦\ñÌf.À‚teßÒ2ƒH\N^ FY¥ËGn|7ɉò©ˆlrÓMò•Ò2SÐÌ!äŠá#1Âkn¶WWÓ—„®W"̃}ùÑó˜uK†õz¿zr[ðm^WÙ •£x('õ®P_€–),`EåÖ ÝöŒŠÛ¤M ³’Xûså’`GÀ²¹’o¿‚| ‹iF|SÐb}9AnQ¦èšuùÆ4!iùtÅTƈÒ%‡ëI¬KM³#¡E!Ïe´UbeÙõͬ€éÂÓÔÙUÑÊÝ’(\Pðmž ¤zCñà('œ€¯Tˆ5É2×ó$ eA£0…O,©x ¯ª A®  Ün¤AÎh’ûüWYW^tM×l®®.>dìø˜²ìÚy%_äà‹óÉeFÔ€ Šl€ë +& Fä¤AYQ®/š«âÆæÅd¹ü•Ô%w}3%E‚Š¥ÁÓÇ÷¼4‚©(ø6O½¡ÆàSH*†U Z±!ljCª„`ÂML$ª¾Š’)U\Ô š3 T\ùrRWÈG 48ÒRœ DÈë»F0ůÀ8BR‡VÀ’|ö-hö-K&À‚ *ˆ"Lû-²£äÀ8źFL°–¯äYI(ˆïªçbÁL)ðEÀGbXvDÜG“_rñ¹Î¬Ý :mÛ¶ÍwYŒ_ˆ àÛ¼]t+TŠÍJ.7V4|"»*žþ¯·U³ã£I(#¬ôE™ŠËž+1LýÃYþ‘Ó´4Ž$97hœ¼€Ö(9Z8a’H‚)Éå˲‹aæ&']˶Ìþ6>Iȹ™É5¨XÉá\I.ß$¢ñ…H^KK —‰,§@ÁzhónI€i†ÊLQ.Au‰œ›Ë·*î³£ Š"çõ%”Y›)EåM.@*&6 fe™BA{…Q”é„@0Wnˆ/§(°{/PŠ®–‹½ -;´LýŠ¹åÌiQåZøWc×l®‹]cŠä“š€c6žò‰$×lÁIÖC›÷]tV;«t­Œ€DÅ&ßhœ•¨‚¦åÊÁÄeÜXEkRq£Ìr.0k%‰ÉÂæ?ˆÜò€Ä°Ë—\yFnŠ¹ÀÕr1L¹\û¹ó ]ƒ+aRY)êßDΓƒîz²Ç2M6í®÷obÿ?ÐȺjó”U¹·Ü›ÝÊdõ!Ž ùË‚_=Žå–‡tñ¤AAù‘›–°Y¶ VfÍ "AÝ|äü4*Ÿžêú™q`3ëÚ1¡€¬¹B×8rÓ5`ä\‰Ù4Ž,Àt‹@Š>õÜœ¸Fւͬ®ðZT଑,ïö‰/(Z^›f!(õÜä\;¹Z&‘b®ºÔÚe-Xóä·(£"øµù[…ø”g•|íd–³å)ls„âäɉ/]cšÄlºÀìÌ”’¸ä5b¥è¦KÆd\ˆÂ¸º0̦rbÙ0¹«è WÁ–´Ù4 '¹RñYÐt-Vº\ ä*æe®BóåÊe6°’q®*Ök ú®p^•B®·ç<×âq‹LÉ™ÁWØM"šË±(_‰ú’ ('¾°TÀ>ݼA_B ú„(º°²§½Y6Eˉ ,ÖøìêÁ‘S”«.L,Q`|Ý"%‘¬(W‰iY„¼¾ñscWR7bâ#ñÙÉ+‡ëÀb…5×vvvV—ÝlúìVp´y ²Ñ{)çå§Ò¥ùÚÇ—C(¹j9å'u$!€$ aXOy9]‚Ð$Sº`ßècGêø¦%¡$^JËNö•Uºt,[ºRLJŽ®~‘„Ân’‹‰ ‰8†‘+!€œ¡UðóqH°O,'‰0¾´ÜŒãŒo¡«eØ€²oZÄJ.‰0¾ X” º|3œñyæä°¥ªk\Š…믓6o…DQѪ­€s †ÂSù¹Q¹B³ (‚jf—š7ûZQøJ]A™•ÐMb¬´,E¦’+Á¾¡8`kÏ’˜Êê91š´ò’Å1ߧb­ DáòÉk²ä¿ï&^ɦKó%·R¦tUÙ^‘ÝÖ*++}Š\omžbàÞì>pX= tåh$¹B+B‹rueu5¶W-]y(I!*®o6WnZ.Gr׬Å*iå‚›% °’eÙ‘¢Ù\Ȧ¬á À(i€½ú®dÇ2fê¹LãäF­$Y]ÅMk%æJrRD]èãٯ›6¿NúðÜ:ÁhªŠÊš„2–£é¾ ÕP¥‚ÜtQÍ2!FpF6¦kÁbW–=8`仺ŠUŠ+'æ›ÄUôaÙñ ¢›ëriH”ºÝ}¸W#¯ –_“~ý”ÃÃÃôYÈM¢ $ë¤ÍS6”‡J‘ŹŹzi™®ÊÌ%cJTÔcä8/öÂøäþÕuõ•ê Q$áÆ’º>1*KŠ5#4u“pÍ6>aù¹Z’Û˜WIm d׎LåZ°DWR”YŸq‚r«`ù@² Ÿ(vùE|Ò»FV×}Ç|›wKB…DƒPéZ„U¢*uS0Œ,k\iÕ² ML׈Ñò¶øfÙd°Y“®Å*u¥âšEîå`¹Ê‚iöâhèیȲh&H.ÅÊG.'Ž«"ìþ|IÌ—"vÔÚH\ã®5“ X”DhAnr†¤å šŠ®¡‚&´ ©ËŽYãf†èióå&Wˆ¸àÛ¼{Ñ)ª“%]¡ÑóÉ´šAPOQÕu‚D¡ˆsuô ]ZnPL }Z.ÓÅ®ºä¦î]š‹}¦, D… Nº®<ךÅ ‹&#e _¸׎} ¡h©X” À„lù¶òu™©HÊ€´yê7î­’®_ð?@—žöIyPlt·Ð‡P¡º) 4©X”änú$ â»n¾¥T,?…)aˆE­Äÿê–U%›Š$Š%E”A—/¬; +W>%‘o꾟€|u‚ïQTÞdÁ¢\¹abÁ àKEF”Cù®))ºL½@©…s_`ú-}A¿NÚ¼•Ÿµy“¬ÒXa[µðÑTE\ßTdGAtuób׎J7/y-BSWÄÇ­¤¾RV¥¢ŸcºTnµm“\ ÒÂ7E€‚n”°ÏH®Ð%¬»F|XùD¨,aЊBV¾9Ë€8\ ±¦6G£Qú‰ÖÇ´œuØæé·§œ¬ݲëþ­’öE™Š©CS!JUA¾1×0%²µëÓÍŒk ùJfMÅŒê{•«!?‡|¹ÖL" _ºø…MW×Ù„JÔŒ\»ËÕr%ÂÊ6•¢‚†¦0¬œ((žðÚˆA?„99SSSl†¹Þí­m¬½^oL+?ÊI{`zEúª#·@åÙ Õý "J"¦$^MÉq®âêUòs™–„E¹L%kQrå®–Ñd\¿Å„²k‡Xi©ñû,ø‚2•×¾%g3`QÿVÀ—%dÉÌYŠ¨x··œœISÇé«Þ×M7^Á?çUêò)$:í)' È}˜ +1eÜ­¢AЂVVfÍåÈQ ¸BKÂ8&‘Š‚&4À„«0]u°‚𹀆s ú|£INp`ù.ð)þ낾ä\#–"aF“ºæbhHpµv€îÔ+ú‰¬3È "(ø6¯‹®’£ÊªÀJB¬€)Bú€t È|‚¦N,Ž ‘%YÅ—úo仩¸X–]uR—³Dër `¾ëjÀA"g|€ÍA3 qI^µñ+‚ìS´X.Á‡Ý„|QnÖðqÈñ]ã"7¡ÊWAÊ ]=HXfã&T¸¸àÛ<åDAêÅ·ç–‡ò‘ë-€âTm\UA>L‚V!\!Q"¸@|ü\'³+É-Ñ\KÈŒP”eLèA€ßk?VI GÂUòGŽ3¡/uÉ! ›¥làCP*ÆP¾€[– K’ëAI˜“K…ßE”Qæ@ è³lµEQFÐ%"À<ä5åÞ§^ˆÁ‚oó*K.=€㣋O/"1üï]ŽÙ‘\AŸÐUQrHŒãV}5<¢T§} -«ë̸$nPX)âcÜ$F³X€ Í” X”‘}À˜È!+Ö€‘s%å2èš…à˱>‚ψ/¨ë¬Ñ_µyº‡™uï£b°àßí)H …D+[‘kÇõÜñjȾ¢Ê[TçÄ÷ê˯? ôpí@ðÕ3b%”®K^=ʘ¾D‘[þù½Ê¡8È-u$ʎѬI#1li¹À,ȦøJštEPd|$flF$ôI,VZ¡‰#¾$®/‚+,_vLböM" ƒ>¡/(SøšÇÍïe$ˆ{†„|ÌB |›W-Á§FÆ—« ¬aä E®ÍÊ+±*b ­®žkß,˜}ãäFguàæÁÅ®–R±$ ÀQ”K6ìÒLÐ%ucÁnÐ%¶¼åã¬n ufÄÕ•0W=Wâj­ŽÑå÷*E|Ýx´|;¬ruõ×ylÁ·y®/…¡§:½,|qñœÏ[9¬$(Bá•h®ÜȨH.¹‹’Y‹R0¯¿N^E„nö\Že ì˜óêæÊ2QŠ•/³`Y^É ÑÜì™Aå$7Ê$R7þ*ÖLÅ€«kBÀJr—ãbûúáÔ1Üúxί‡ïy{ªÓæùž· [„†­ì†-ÖTÞ&$è“•W(ã¹ö%—ÁÜXKhuWÑ„JB¾%äÆæA±ú™î›e8ŠòiI×õ¡™C.¾i™A-Ê‚®0|’×”ÙפYvåŠ è±Ÿ·«èµZþçüsžUÐæ)•ßøœç¢»Z±`+™•oBéºAÆÓR0—#BÞXÙ\Ie%ƒð¥"߬™Ð—U ˜ŸË7S«Y°ÔiEð-(€Ù5èË€%ŒÖ…¹´¼tÍ’e>¯V ¾ÍëZS8VAhúÄêSE €D¾‚RMØ$np,ƒ¹K77Ê'ÉMÝÍ›ìQĹ&Ö²aÀ8¹©¸0Îì {é9)º³ zŒW/²KT °ì}Øø.-׬Oë5eYÜïÚükº†ÿîdŠ‡ÑçW·÷åCÅéV%à|*¿eËk´ Í—1’6‰ß˜¥(_ä¼–-J>Î5Î…E‚®97ÖÅ|­‰4-W¢Tˆ2`4€Ët±Ë1l¾eL7-#[r’¬¤kF ü÷¼€<žóªšk¹úV´«b`fs%D™ÐSXvÆwåÙ®ŽMëV×ý7‰uÅ ?n-f¯\…µ‘ͬ7`iI"³&4àãû‚F[˜Š^•„Ô+ºŠWÑ-”¨õðnO‘P#¹â ÎS*”Ãuønˆ€DÀ‚â¨P}ÂÕ_ä|dÙAˆS~dS¾›˃O˜7èS—qYðEĉð¥‚ܵ¿Ìõs|¥ˆCK×L›‘•.Xd³ ¹ÈƱXÈ¿Ñ7;0MËgÐ5b„F¸rÃ.¾fã(!~)LW~¡»‚oó†^#›gQEH³§'OB¤•ëê¥e¥îÒ|UÄÊ‹óq™kÌŒ«ââ•ì+Ÿ+ź„WÊF®—éâ\›«HrÍB~­Öàçµ³JºD­EE—©Fîf’zųdõ´ "¶àÛ¼•Ó¤Xá¬j䞊Á•¨êø*œKð•QyU|47è³æKËe¾&lf•%Ó5¹òiòUÀJY’)ÅâÀØ’e_0orÆq-‹é7š„̵©l¬B0•5Eé*3ðä_ lø-ßæõ‰E XáÌã=÷“žX+<«. Öîë®ì*þF;>]] y kZÒ.ð)%‰q|rb‹Ê•(JÙÆ0>••´\šá¼d™uçbæªçZr¹Z>‚/(>¾€Å*W©Z¿{··Ëò h®Ìÿ×ÞÙìJUmQ¸k0þ!¢^AP~ ‰ÁD[Ø0†Ñž;&v|bhñÆ <z„>€"jb×ýûU}ç æ{׶νWeWÎj,Çs̹ÖÞs͵«Šª#¯çùj$•Oz8’[æš<Ö*®L½#Ö¤¸‘ÕëoÃYCS³`Z„Ù gÿœçŽûÖ¿„ç_#¦à!“ª‰”ãÈf=ä„ïú¦:Ëú^CåŸÆi‚ÑkQS€Óqá­É#³1Ô½L”€Fj²Ç¤ ’â?SC÷Ê4¥“FЬᘴæªoÅÕk^xjÞ;Ο"öµ=GiKÎFó¡ šFÓ2 ºLà6»ÛHýNCÕY§Å¯ðèÕé«ãp 2ô6‚èXû:ÝÇQÒ•TñŽKÕ„ ˆ•YÄÍԆѯY-Ž6”zßîyÒ¯Š3#~jž ‘^ÛÓ›0½É['Šq|†\õþß'^Càj‡üšÌšW™/‚ÎÊ%¹çe(SA[IÜ4NXhe4)`=uµbz[nà_º†¿3øìkžÚ³ÌxmÏ—ðxaŸ$™3îfö1Œ.ÛÆÛ»?db2fs4檳 3Ö ë`—÷€¡oLøæa…^¾ZÁ5~L™Å›Œ˜FLzD9;Œ c8¶áÒië4GÓ¬£LB5àìuF11mèÝ?ÁÙ``Ý[ÌÙ g_ó䆛N2¨y`Ã<%—ZMLr/ùÖ+S3ê®>‚æî0sZ×'׳ꢈ`Ú·T“X1 }V AÐ7ÍšÃhóNÇlŽmˆ/Œ$&¢Îùg špÍã`zŠ‡ß:ûšO¨y²åçö5y`êé§Õ|Û“Ÿ M¯Š‡AvÄŠ–UÕ¬Š“…á˜Å,Ãl½†4ŽãTq"#³Uf‡ ¾ ë, GÉxMƒÓ8C=|›1“Fœ80ìð€˜x~Pê~POïÃ0U|xÏž=ä†,’9zÒl¦=’æ pde5Mcí«ÒÃDÓ(¨îqTÇuLÆÇQq‚Àز†C/Mmý*Pc®Òs•U¾Æÿ©KÕ'r#k°CGÞÀ³‹h`çå»ë:·ôŸžÓäæÕW_Ý·o?¡'7üþ‰ä™i >É]+bãŒZiØlŽf]5œÖ·M™ z¹ç "h`8‹.ð™lLƒTÒ8ô‚6Ë:íê0+xT?Jª¯1wŠ ›ÙÛ[tgd3ðTSùØQì^H¾ôÒK;ë!ÔoÂsžü‘›^x²¿}û6Šœ ñÚ,¯ðÁœ¦ÓâO&ðµiµ‡‰=dšb¬Ì¸å¹ýI$ JÝsÁCzô¨Q¶Å%CÄmšp4,CçàNïÅF&À”õÃàbƒçžè”X!åí±Ê+›îq!zÖ“2úVMøªŒ ïú%eÄN$£{¦®¤bz¬ ¼{ÖùÈ#¸·T8&~?GÿØcñ`ôÑGïß¿ÏpþüùS§N%à|Á&Ô} ÉÐÞûÙª2C† Ÿý%òö+Û>Ò™à=øËÖþ`žšÿøã¿ùæ›U‹Éªff_óä’LÐÈ5ï$¯ð&ÀdÓ#€§Á«‡ÛÃ$a29#pÁ&ƒu1_Ñ'ˆ§@¦#}j²W¬¯xMN‘°Ì¾4n…R† z§Kƒ;¤§¡¤—§' Ã…mÙ ùox†Îè…cÒ7@ÁÒõAX†N4qœÈh ‡ ¨ÓIÈku® ïUd1ÏÇ@<Æù›+<Òqçÿ]C©û:+¿ã¸páÂÅ‹÷îÝËYà) ûLûÙ×¼¹§2IÀ‘#Gžzê)ÊÞ×”d6\ZCÙö¨¾ÈøÐíÇèÕØ×8*uWœ €5ð¶ðÈX h˜n86^ìiøDÔ^+ŒSW±{çej?œ·zU¥8÷Ó°Ã1¹ªq¨•ÞÖöñáqÑ_fáyŽ•‚‡Ä Ì‹ Ž¶ oà¿þúë/¾ø‚Rç,ðE_|g 6¡æÉ“ûãСCG½sçŽù“l['$@Ì&fS(™t6¾Y# ðuû€¸í3‡D)“YônY÷«â¡&Ñ*ˆ¬’^²Œ1ÁõÉØç5|d.£†NW5>?ej|.¦EHéfÞ¡oL·€¸W†2æÒ ½ÃÔ9µMÒŸþùÏ>ûìË/¿ÿüsÞ* ’í@³υ̾æÉ„V.†ä9sæÚµk¼=³ìÙ5ÇàáîÁQ_Á×ÑXcÕ”ÈNêžVe‰Py0üBº-uQ“ ŒÞ`# AÎHîÛ¶Óâ¿hso/cËy;>ÃÜd• â½ ‘‡™7⸂é)°ƒ‡ôŠA>¤ÓéÉnáñÎò>úè“O>áÉ¡/Ï»‡lÞϯ¬¯ùáïÉiã´öADV>ýôÓ7nðÁ yJ¦Ù÷^Z¬îÈ0âðíV Si+ñu°Å]a“e"Wˆ†–z@,ƒ àTŸ˜u.cÂÐê\Dã,Έ&³Ô€Y›Sg©ú†›¸Y&C°-&ãCÆ·2•WàóM“åºpáZl`ãüÃû‰'ødþìÙ³€T\+2|V2S0ûš÷¾ûFËþîÝ»_}õeÿä“ORöd×^Ø ÒhH"@‡Ë´.:™Å®Ù~:‹¦$•Ñ3QLnš UBº#Y&Ï)@"ÔYc¢A*0ÄKÙhR½bzW2*ŽÆYê®x1÷²)k&5ÍE¥½ë“…²¶Æ ‡žæÜ:L„%·š Ó èo¬â‚U/"pù3j<Àùˆîܹsï¿ÿþ;ï¼Ã&Á]¥Ñ6µŸ}Í“'ÓI.s0ÿú믗.]úþûïIoò9ËýZ®e†/‹Çýd¹!V’`÷Á’Þê`˜+¼Q%^Š°º‡”±Û؈04—A@ƒGF±ñµFæ0½J†q>  âš†gŠ3b­S7køè#pm8)ýQ©Àº%7 Cóøæ6J涣¤q$ˆlRɘÀ y»Î.û÷ïûí·?üðÃ÷Þ{ïÅ_„g Ä4ûè™Å°®aÃúÿH䬯-Y'$˜4_½zõÛo¿½wï|H¾}ÁV µVšEËÖq‹Ðçò+fÀ»/¬Œ=Á0 R/÷J ‹t Œ Œ~}\ä‡ó6~(H„ ¦eu Cpo!°ùÉÝ?þxóæM*ÿçŸæS·ŽÿTƒ/OÓÑ!égh3Ž‰w fˆU’!§É"Dyu FÏòœ…yÙm ]§j\ÜÜ’‹pÛ᛹Ó}s N'n€UÁHVå §S\C5MÏ0)_InÍ{ààæqMjÈE‹$Ì3Ï<Ã'ð'Ož<}úôo¼AÙãBȼ¥‚›™=“Ål<˜}Í'…dl14‹l žæ/‡ºCLœ<øÕ_±´ª!i¼ ðe!^ì ¶ 1 ÎG byŽ †iðzq² ¦áUa+ûȸðë„g#1Üø'ÿ&Ô<ÙšucOSçT>}þ  { describe('lib/cordova/project', () => { describe('getPlatforms', () => { it('should filter out files and hidden files/folders', async () => { const files: [string, boolean][] = [['.DS_Store', false], ['.dir', true], ['android', true], ['ios', true], ['platforms.json', false]]; jest.spyOn(fsSafeSpy, 'readdir').mockImplementation(async () => files.map(([f]) => f)); jest.spyOn(fsSafeSpy, 'stat').mockImplementation(async (p) => ({ isDirectory: () => { const file = files.find(([f]) => p.endsWith(f)); return typeof file !== 'undefined' && file[1]; }, } as any)); const platforms = await project.getPlatforms('/path/to/proj'); expect(platforms).toEqual(['android', 'ios']); }); it('should not error if directory empty', async () => { jest.spyOn(fsSafeSpy, 'readdir').mockImplementation(async () => []); const platforms = await project.getPlatforms('/path/to/proj'); expect(platforms).toEqual([]); }); }); describe('getAndroidBuildOutputJson', () => { it('should throw for fs error', () => { jest.spyOn(fsExtraSpy, 'readJson').mockImplementation(async () => { throw new Error('error') }); const p = project.getAndroidBuildOutputJson(['/path/to/output.json']); expect(p).rejects.toThrowError('Could not find or parse valid build output file'); }); it('should throw for unrecognized format', () => { jest.spyOn(fsExtraSpy, 'readJson').mockImplementation(async () => ({ foo: 'bar' })); const p = project.getAndroidBuildOutputJson(['/path/to/output.json']); expect(p).rejects.toThrowError('Could not find or parse valid build output file'); }); it('should parse legacy output.json', () => { const file = [ { outputType: { type: 'APK', }, path: 'app-debug.apk', }, ]; jest.spyOn(fsExtraSpy, 'readJson').mockImplementation(async () => file); const p = project.getAndroidBuildOutputJson(['/path/to/output.json']); expect(p).resolves.toEqual(file); }); it('should parse output.json', () => { const file = { artifactType: { type: 'APK', }, elements: [ { outputFile: 'app-debug.apk', } ], }; jest.spyOn(fsExtraSpy, 'readJson').mockImplementation(async () => file); const p = project.getAndroidBuildOutputJson(['/path/to/output.json']); expect(p).resolves.toEqual(file); }); }); describe('getAndroidPackageFilePath', () => { it('should get file path from legacy output.json', () => { const file = [ { outputType: { type: 'APK', }, path: 'foo-debug.apk', }, ]; jest.spyOn(fsExtraSpy, 'readJson').mockImplementation(async () => file); const p = project.getAndroidPackageFilePath('/path/to/proj', { release: false }); expect(p).resolves.toEqual('platforms/android/app/build/outputs/apk/debug/foo-debug.apk'); }); it('should get file path from output.json', () => { const file = { artifactType: { type: 'APK', }, elements: [ { outputFile: 'bar-debug.apk', } ], }; jest.spyOn(fsExtraSpy, 'readJson').mockImplementation(async () => file); const p = project.getAndroidPackageFilePath('/path/to/proj', { release: false }); expect(p).resolves.toEqual('platforms/android/app/build/outputs/apk/debug/bar-debug.apk'); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/__tests__/utils.ts000066400000000000000000000105631425441362600326140ustar00rootroot00000000000000import { filterArgumentsForCordova, generateOptionsForCordovaBuild } from '../utils'; import { CommandMetadata } from '../../../../definitions'; describe('@ionic/cli', () => { const buildMetadata: CommandMetadata = { name: 'build', summary: '', type: 'global', inputs: [ { name: 'platform', summary: '', } ], options: [ { name: 'boolopt', summary: '', type: Boolean, default: false, }, { name: 'cdvopt1', summary: '', groups: ['cordova-cli'], }, { name: 'cdvopt2', summary: '', type: Boolean, groups: ['cordova-cli'], }, { name: 'prod', summary: '', type: Boolean, groups: ['app-scripts'], }, { name: 'optimizejs', summary: '', type: Boolean, groups: ['app-scripts'], }, ] }; const platformMetadata: CommandMetadata = { name: 'platform', summary: '', type: 'global', inputs: [ { name: 'action', summary: '', }, { name: 'platform', summary: '', } ], options: [ { name: 'boolopt', summary: '', type: Boolean, default: false, }, ] }; describe('filterArgumentsForCordova', () => { it('should return the command name and inputs if no options passed', () => { const options = { _: ['ios'], boolopt: false, cdvopt1: null, cdvopt2: false, prod: true, optimizejs: true }; const result = filterArgumentsForCordova(buildMetadata, options); expect(result).toEqual(['build', 'ios']); }); it('should only include options with the Cordova intent', () => { const options = { _: ['ios'], boolopt: true, cdvopt1: 'foo', cdvopt2: true, prod: true, optimizejs: true }; const result = filterArgumentsForCordova(buildMetadata, options); expect(result).toEqual(['build', 'ios', '--cdvopt1', 'foo', '--cdvopt2']); }); it('should include --verbose', () => { const options = { _: ['ios'], boolopt: true, cdvopt1: 'foo', cdvopt2: true, prod: true, optimizejs: true, verbose: true }; const result = filterArgumentsForCordova(buildMetadata, options); expect(result).toEqual(['build', 'ios', '--cdvopt1', 'foo', '--cdvopt2', '--verbose']); }); it('should include additional options', () => { const options = { _: ['android'], '--': ['--someopt'], boolopt: true, cdvopt1: 'foo', cdvopt2: true, prod: true, optimizejs: true }; const result = filterArgumentsForCordova(buildMetadata, options); expect(result).toEqual(['build', 'android', '--cdvopt1', 'foo', '--cdvopt2', '--someopt']); }); it('should include additional and unparsed options', () => { const options = { _: ['android'], '--': ['--someopt', '--', '--gradleArg=-PcdvBuildMultipleApks=true'], boolopt: true, cdvopt1: 'foo', cdvopt2: true, prod: true, optimizejs: true }; const result = filterArgumentsForCordova(buildMetadata, options); expect(result).toEqual(['build', 'android', '--cdvopt1', 'foo', '--cdvopt2', '--someopt', '--', '--gradleArg=-PcdvBuildMultipleApks=true']); }); it('should respect --nosave', () => { const options = { _: ['add', 'android'], '--': [], nosave: true }; const result = filterArgumentsForCordova(platformMetadata, options); expect(result).toEqual(['platform', 'add', 'android', '--nosave']); }); }); describe('generateOptionsForCordovaBuild', () => { it('should return added options even for no options passed', () => { const inputs = ['ios']; const options = { _: [] }; const result = generateOptionsForCordovaBuild(buildMetadata, inputs, options); expect(result).toEqual({ '_': [], externalAddressRequired: true, open: false, engine: 'cordova', platform: 'ios' }); }); it('should include the options with app-scripts group or no group, but not cordova-cli group', () => { const inputs = ['ios']; const options = { _: [], boolopt: false, cdvopt1: null, cdvopt2: false, prod: true, optimizejs: true }; const result = generateOptionsForCordovaBuild(buildMetadata, inputs, options); expect(result).toEqual({ '_': [], boolopt: false, externalAddressRequired: true, open: false, engine: 'cordova', platform: 'ios', prod: true, optimizejs: true }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/android.ts000066400000000000000000000015261425441362600311350ustar00rootroot00000000000000import { readFile } from '@ionic/utils-fs'; import * as path from 'path'; export async function getAndroidSdkToolsVersion(): Promise { const androidHome = await locateSDKHome(); if (androidHome) { try { const f = await readFile(path.join(androidHome, 'tools', 'source.properties'), { encoding: 'utf8' }); return `${await parseSDKVersion(f)} (${androidHome})`; } catch (e) { if (e.code !== 'ENOENT') { throw e; } } } } export async function locateSDKHome(): Promise { return process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT; } export async function parseSDKVersion(contents: string): Promise { for (const l of contents.split('\n')) { const [ a, b ] = l.split('='); if (a === 'Pkg.Revision') { return b; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/config.ts000066400000000000000000000153041425441362600307610ustar00rootroot00000000000000import { readPackageJsonFile } from '@ionic/cli-framework/utils/node'; import { readFile, writeFile } from '@ionic/utils-fs'; import { prettyPath } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import * as et from 'elementtree'; import * as path from 'path'; import { CordovaPackageJson, ProjectIntegration } from '../../../definitions'; import { isCordovaPackageJson } from '../../../guards'; import { failure, input, strong } from '../../color'; import { FatalException } from '../../errors'; import { shortid } from '../../utils/uuid'; const debug = Debug('ionic:lib:integrations:cordova:config'); export interface ConfiguredPlatform { name: string; spec?: string; } export class CordovaConfig { protected _doc?: et.ElementTree; protected _pkg?: CordovaPackageJson; protected _sessionid?: string; protected saving = false; constructor(readonly configXmlPath: string, readonly packageJsonPath: string) {} get doc(): et.ElementTree { if (!this._doc) { throw new Error('No doc loaded.'); } return this._doc; } get pkg(): CordovaPackageJson { if (!this._pkg) { throw new Error('No package.json loaded.'); } return this._pkg; } get sessionid(): string { if (!this._sessionid) { throw new Error('No doc loaded.'); } return this._sessionid; } static async load(configXmlPath: string, packageJsonPath: string): Promise { if (!configXmlPath || !packageJsonPath) { throw new Error('Must supply file paths for config.xml and package.json.'); } const conf = new CordovaConfig(configXmlPath, packageJsonPath); await conf.reload(); return conf; } protected async reload(): Promise { const configXml = await readFile(this.configXmlPath, { encoding: 'utf8' }); if (!configXml) { throw new Error(`Cannot load empty config.xml file.`); } try { this._doc = et.parse(configXml); this._sessionid = shortid(); } catch (e) { throw new Error(`Cannot parse config.xml file: ${e.stack ? e.stack : e}`); } const packageJson = await readPackageJsonFile(this.packageJsonPath); if (isCordovaPackageJson(packageJson)) { this._pkg = packageJson; } else { this._pkg = { ...packageJson, cordova: { platforms: [], plugins: {} } }; debug('Invalid package.json for Cordova. Missing or invalid Cordova entries in %O', this.packageJsonPath); } } async save(): Promise { if (!this.saving) { this.saving = true; await writeFile(this.configXmlPath, this.write(), { encoding: 'utf8' }); this.saving = false; } } setName(name: string): void { const root = this.doc.getroot(); let nameNode = root.find('name'); if (!nameNode) { nameNode = et.SubElement(root, 'name', {}); } nameNode.text = name; } setBundleId(bundleId: string): void { const root = this.doc.getroot(); root.set('id', bundleId); } getBundleId(): string | undefined { const root = this.doc.getroot(); return root.get('id'); } /** * Update config.xml content src to be a dev server url. As part of this * backup the original content src for a reset to occur at a later time. */ writeContentSrc(newSrc: string): void { const root = this.doc.getroot(); let contentElement = root.find('content'); if (!contentElement) { contentElement = et.SubElement(root, 'content', { src: 'index.html' }); } contentElement.set('original-src', contentElement.get('src')); contentElement.set('src', newSrc); let navElement = root.find(`allow-navigation[@href='${newSrc}']`); if (!navElement) { navElement = et.SubElement(root, 'allow-navigation', { sessionid: this.sessionid, href: newSrc }); } } /** * Set config.xml src url back to its original url */ resetContentSrc() { const root = this.doc.getroot(); let contentElement = root.find('content'); if (!contentElement) { contentElement = et.SubElement(root, 'content', { src: 'index.html' }); } const originalSrc = contentElement.get('original-src'); if (originalSrc) { contentElement.set('src', originalSrc); delete contentElement.attrib['original-src']; } const navElements = root.findall(`allow-navigation[@sessionid='${this.sessionid}']`); for (const navElement of navElements) { root.remove(navElement); } } getPreference(prefName: string): string | undefined { const root = this.doc.getroot(); const preferenceElement = root.find(`preference[@name='${prefName}']`); if (!preferenceElement) { return undefined; } const value = preferenceElement.get('value'); if (!value) { return undefined; } return value; } getProjectInfo(): { id: string; name: string; version: string; } { const root = this.doc.getroot(); let id = root.get('id'); if (!id) { id = ''; } let version = root.get('version'); if (!version) { version = ''; } let nameElement = root.find('name'); if (!nameElement) { nameElement = et.SubElement(root, 'name', {}); } if (!nameElement.text) { nameElement.text = 'MyApp'; } const name = nameElement.text.toString().trim(); return { id, name, version }; } getConfiguredPlatforms(): ConfiguredPlatform[] { const deps: { [key: string]: string | undefined; } = { ...this.pkg.devDependencies, ...this.pkg.dependencies }; return this.pkg.cordova.platforms.map(platform => ({ name: platform, spec: deps[`cordova-${platform}`], })); } protected write(): string { // Cordova hard codes an indentation of 4 spaces, so we'll follow. const contents = this.doc.write({ indent: 4 }); return contents; } } export async function loadCordovaConfig(integration: Required): Promise { const configXmlPath = path.resolve(integration.root, 'config.xml'); const packageJsonPath = path.resolve(integration.root, 'package.json'); debug('Loading Cordova Config (config.xml: %O, package.json: %O)', configXmlPath, packageJsonPath); try { return await CordovaConfig.load(configXmlPath, packageJsonPath); } catch (e) { const msg = e.code === 'ENOENT' ? ( `Could not find necessary file(s): ${strong('config.xml')}, ${strong('package.json')}.\n\n` + ` - ${strong(prettyPath(configXmlPath))}\n` + ` - ${strong(prettyPath(packageJsonPath))}\n\n` + `You can re-add the Cordova integration with the following command: ${input('ionic integrations enable cordova --add')}` ) : failure(e.stack ? e.stack : e); throw new FatalException( `Cannot load Cordova config.\n` + `${msg}` ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/index.ts000066400000000000000000000216011425441362600306200ustar00rootroot00000000000000import { copy, mkdirp, pathExists, readdirSafe, remove, stat } from '@ionic/utils-fs'; import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as os from 'os'; import * as path from 'path'; import { BaseIntegration, IntegrationConfig } from '../'; import { InfoItem, IntegrationAddDetails, IntegrationAddHandlers, IntegrationName, ProjectIntegration, ProjectPersonalizationDetails } from '../../../definitions'; import { ancillary, input, strong } from '../../color'; import * as configlib from './config'; import { checkForUnsupportedProject } from './utils'; const debug = Debug('ionic:lib:integrations:cordova'); export class Integration extends BaseIntegration { readonly name: IntegrationName = 'cordova'; readonly summary = 'Target native iOS and Android with Apache Cordova'; readonly archiveUrl = 'https://d2ql0qc7j8u4b2.cloudfront.net/integration-cordova.tar.gz'; get config(): IntegrationConfig { return new IntegrationConfig(this.e.project.filePath, { pathPrefix: [...this.e.project.pathPrefix, 'integrations', this.name] }); } async add(details: IntegrationAddDetails): Promise { await checkForUnsupportedProject(this.e.project.type); const handlers: IntegrationAddHandlers = { conflictHandler: async (f, stats) => { const isDirectory = stats.isDirectory(); const filename = `${path.basename(f)}${isDirectory ? '/' : ''}`; const type = isDirectory ? 'directory' : 'file'; const confirm = await this.e.prompt({ type: 'confirm', name: 'confirm', message: `The ${ancillary(filename)} ${type} exists in project. Overwrite?`, default: false, }); return confirm; }, onFileCreate: f => { if (!details.quiet) { this.e.log.msg(`${chalk.green('CREATE')} ${f}`); } }, }; const onFileCreate = handlers.onFileCreate ? handlers.onFileCreate : lodash.noop; const conflictHandler = handlers.conflictHandler ? handlers.conflictHandler : async () => false; const { createRequest, download } = await import('../../utils/http'); const { tar } = await import('../../utils/archive'); this.e.log.info(`Downloading integration ${input(this.name)}`); const tmpdir = path.resolve(os.tmpdir(), `ionic-integration-${this.name}`); // TODO: etag if (await pathExists(tmpdir)) { await remove(tmpdir); } await mkdirp(tmpdir); const ws = tar.extract({ cwd: tmpdir }); const { req } = await createRequest('GET', this.archiveUrl, this.e.config.getHTTPConfig()); await download(req, ws, {}); const contents = await readdirSafe(tmpdir); const blacklist: string[] = []; debug(`Integration files downloaded to ${strong(tmpdir)} (files: ${contents.map(f => strong(f)).join(', ')})`); for (const f of contents) { const projectf = path.resolve(this.e.project.directory, f); try { const stats = await stat(projectf); const overwrite = await conflictHandler(projectf, stats); if (!overwrite) { blacklist.push(f); } } catch (e) { if (e.code !== 'ENOENT') { throw e; } } } this.e.log.info(`Copying integrations files to project`); debug(`Blacklist: ${blacklist.map(f => strong(f)).join(', ')}`); await mkdirp(details.root); await copy(tmpdir, details.root, { filter: f => { if (f === tmpdir) { return true; } const projectf = f.substring(tmpdir.length + 1); for (const item of blacklist) { if (item.slice(-1) === '/' && `${projectf}/` === item) { return false; } if (projectf.startsWith(item)) { return false; } } onFileCreate(projectf); return true; }, }); await super.add(details); } async getCordovaConfig(): Promise { try { return await this.requireConfig(); } catch (e) { // ignore } } async requireConfig(): Promise { const { loadCordovaConfig } = await import('./config'); const integration = this.e.project.requireIntegration('cordova'); const conf = await loadCordovaConfig(integration); return conf; } async getInfo(): Promise { const { getAndroidSdkToolsVersion } = await import('./android'); const [ cordovaVersion, cordovaPlatforms, cordovaPlugins, xcode, iosDeploy, iosSim, androidSdkToolsVersion, ] = await (Promise.all([ this.getCordovaVersion(), this.getCordovaPlatformVersions(), this.getCordovaPluginVersions(), this.getXcodebuildVersion(), this.getIOSDeployVersion(), this.getIOSSimVersion(), getAndroidSdkToolsVersion(), ])); const info: InfoItem[] = [ { group: 'cordova', name: 'Cordova CLI', key: 'cordova_version', value: cordovaVersion || 'not installed' }, { group: 'cordova', name: 'Cordova Platforms', key: 'cordova_platforms', value: cordovaPlatforms }, { group: 'cordova', name: 'Cordova Plugins', value: cordovaPlugins }, ]; if (xcode) { info.push({ group: 'system', name: 'Xcode', key: 'xcode_version', value: xcode }); } if (iosDeploy) { info.push({ group: 'system', name: 'ios-deploy', value: iosDeploy }); } if (iosSim) { info.push({ group: 'system', name: 'ios-sim', value: iosSim }); } if (androidSdkToolsVersion) { info.push({ group: 'system', name: 'Android SDK Tools', key: 'android_sdk_version', value: androidSdkToolsVersion }); } const conf = await this.getCordovaConfig(); if (conf) { const bundleId = conf.getBundleId(); info.push({ group: 'cordova', name: 'Bundle ID', key: 'bundle_id', value: bundleId || 'unknown', hidden: true }); } return info; } async personalize({ name, packageId }: ProjectPersonalizationDetails) { const conf = await this.requireConfig(); conf.setName(name); if (packageId) { conf.setBundleId(packageId); } await conf.save(); } async getCordovaVersion(): Promise { try { const integration = this.e.project.requireIntegration('cordova'); return this.e.shell.cmdinfo('cordova', ['-v', '--no-telemetry', '--no-update-notifier'], { cwd: integration.root }); } catch (e) { debug('Error while getting Cordova version: %O', e); } } async getCordovaPlatformVersions(): Promise { try { const integration = this.e.project.requireIntegration('cordova'); const output = await this.e.shell.output('cordova', ['platform', 'ls', '--no-telemetry', '--no-update-notifier'], { cwd: integration.root, showCommand: false }); const platforms = output .replace('Installed platforms:', '') .replace(/Available platforms[\s\S]+/, '') .split('\n') .map(l => l.trim()) .filter(l => l && !l.startsWith('.')); if (platforms.length === 0) { return 'none'; } return platforms.join(', '); } catch (e) { debug('Error while getting Cordova platforms: %O', e); return 'not available'; } } async getCordovaPluginVersions(): Promise { const whitelist = [ /^cordova-plugin-ionic$/, /^cordova-plugin-ionic-.+/, ]; try { const integration = this.e.project.requireIntegration('cordova'); const output = await this.e.shell.output('cordova', ['plugin', 'ls', '--no-telemetry', '--no-update-notifier'], { cwd: integration.root, showCommand: false }); const pluginRe = /^([a-z-]+)\s+(\d\.\d\.\d).+$/; const plugins = output .split('\n') .map(l => l.trim().match(pluginRe)) .filter((l): l is RegExpMatchArray => l !== null) .map(m => [m[1], m[2]]); const whitelistedPlugins = plugins .filter(([ plugin, version ]) => whitelist.some(re => re.test(plugin))) .map(([ plugin, version ]) => `${plugin} ${version}`); const count = plugins.length - whitelistedPlugins.length; if (whitelistedPlugins.length === 0) { return `no whitelisted plugins (${count} plugins total)`; } return `${whitelistedPlugins.join(', ')}${count > 0 ? `, (and ${count} other plugins)` : ''}`; } catch (e) { debug('Error while getting Cordova plugins: %O', e); return 'not available'; } } async getXcodebuildVersion(): Promise { return this.e.shell.cmdinfo('xcodebuild', ['-version']); } async getIOSDeployVersion(): Promise { return this.e.shell.cmdinfo('ios-deploy', ['--version']); } async getIOSSimVersion(): Promise { return this.e.shell.cmdinfo('ios-sim', ['--version']); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/project.ts000066400000000000000000000062221425441362600311610ustar00rootroot00000000000000import { filter } from '@ionic/utils-array'; import { readJson, readdirSafe, statSafe } from '@ionic/utils-fs'; import * as Debug from 'debug'; import * as path from 'path'; import { AndroidBuildOutput, LegacyAndroidBuildOutputEntry } from '../../../definitions'; import { isAndroidBuildOutputFile, isLegacyAndroidBuildOutputFile } from '../../../guards'; import { input } from '../../color'; import { FatalException } from '../../errors'; const debug = Debug('ionic:lib:cordova:project'); const CORDOVA_ANDROID_PACKAGE_PATH = 'platforms/android/app/build/outputs/apk/'; const CORDOVA_IOS_SIMULATOR_PACKAGE_PATH = 'platforms/ios/build/emulator'; const CORDOVA_IOS_DEVICE_PACKAGE_PATH = 'platforms/ios/build/device'; export async function getPlatforms(projectDir: string): Promise { const platformsDir = path.resolve(projectDir, 'platforms'); const contents = await readdirSafe(platformsDir); const platforms = await filter(contents, async file => { const stat = await statSafe(path.join(platformsDir, file)); return !file.startsWith('.') && typeof stat !== 'undefined' && stat.isDirectory(); }); return platforms; } export async function getAndroidBuildOutputJson(paths: string[]): Promise { for (const p of paths) { try { const json = await readJson(p); if (isAndroidBuildOutputFile(json)) { return json; } else if (isLegacyAndroidBuildOutputFile(json)) { return json; } else { debug('Output file does not match expected format: %O', json); } } catch (e) { debug('Error parsing file %O: %O', p, e); } } throw new FatalException( `Could not find or parse valid build output file.\n` + `Tried the following paths:\n` + `- ${paths.join('\n- ')}` ); } export async function getAndroidPackageFilePath(root: string, { release = false }: GetPackagePathOptions): Promise { const outputPath = path.resolve(root, CORDOVA_ANDROID_PACKAGE_PATH, release ? 'release' : 'debug'); const outputJsonPaths = ['output.json', 'output-metadata.json'].map(p => path.resolve(outputPath, p)); const outputJson = await getAndroidBuildOutputJson(outputJsonPaths); const p = 'elements' in outputJson ? outputJson.elements[0].outputFile : outputJson[0].path; // TODO: handle multiple files from output.json, prompt to select? return path.relative(root, path.resolve(outputPath, p)); } export interface GetPackagePathOptions { emulator?: boolean; release?: boolean; } /** * Get the relative path to most recently built APK or IPA file */ export async function getPackagePath(root: string, appName: string, platform: string, { emulator = false, release = false }: GetPackagePathOptions = {}): Promise { if (platform === 'android') { return getAndroidPackageFilePath(root, { emulator, release }); } else if (platform === 'ios') { if (emulator) { return path.join(CORDOVA_IOS_SIMULATOR_PACKAGE_PATH, `${appName}.app`); } return path.join(CORDOVA_IOS_DEVICE_PACKAGE_PATH, `${appName}.ipa`); } throw new FatalException(`Unknown package path for ${input(appName)} on ${input(platform)}.`); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/cordova/utils.ts000066400000000000000000000125311425441362600306530ustar00rootroot00000000000000import { OptionFilters, filterCommandLineOptions, filterCommandLineOptionsByGroup, unparseArgs } from '@ionic/cli-framework'; import { PromptModule } from '@ionic/cli-framework-prompts'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, ILogger, ProjectType } from '../../../definitions'; import { ancillary, input, strong } from '../../color'; import { FatalException } from '../../errors'; import { prettyProjectName } from '../../project'; import { emoji } from '../../utils/emoji'; export const SUPPORTED_PROJECT_TYPES: readonly ProjectType[] = ['custom', 'ionic1', 'ionic-angular', 'angular']; /** * Filter and gather arguments from command line to be passed to Cordova */ export function filterArgumentsForCordova(metadata: CommandMetadata, options: CommandLineOptions): string[] { const m = { ...metadata }; if (!m.options) { m.options = []; } const globalCordovaOpts: CommandMetadataOption[] = [ { name: 'verbose', summary: '', type: Boolean, groups: ['cordova-cli'], }, { name: 'nosave', summary: '', type: Boolean, groups: ['cordova-cli'], }, ]; m.options.push(...globalCordovaOpts); const results = filterCommandLineOptionsByGroup(m.options, options, 'cordova-cli'); const args = unparseArgs(results, { useEquals: false, allowCamelCase: true }); const i = args.indexOf('--'); if (i >= 0) { args.splice(i, 1); // join separated args onto main args, use them verbatim } return [m.name, ...args]; } export function generateOptionsForCordovaBuild(metadata: CommandMetadata, inputs: CommandLineInputs, options: CommandLineOptions): CommandLineOptions { const platform = inputs[0] ? inputs[0] : (options['platform'] ? String(options['platform']) : undefined); const project = options['project'] ? String(options['project']) : undefined; // iOS does not support port forwarding out-of-the-box like Android does. // See https://github.com/ionic-team/native-run/issues/20 const externalAddressRequired = platform === 'ios' || !options['native-run']; const includesAppScriptsGroup = OptionFilters.includesGroups('app-scripts'); const excludesCordovaGroup = OptionFilters.excludesGroups('cordova-cli'); const results = filterCommandLineOptions(metadata.options ? metadata.options : [], options, o => excludesCordovaGroup(o) || includesAppScriptsGroup(o)); return { ...results, externalAddressRequired, open: false, engine: 'cordova', platform, project, }; } export async function checkForUnsupportedProject(type: ProjectType, cmd?: string): Promise { if (!SUPPORTED_PROJECT_TYPES.includes(type)) { throw new FatalException( `Ionic doesn't support using Cordova with ${input(prettyProjectName(type))} projects.\n` + `We encourage you to try ${emoji('âš¡ï¸ ', '')}${strong('Capacitor')}${emoji(' âš¡ï¸', '')} (${strong('https://ion.link/capacitor')})` + (cmd === 'run' ? `\n\nIf you want to run your project natively, see ${input('ionic capacitor run --help')}.` : '') + (cmd === 'plugin' ? `\n\nIf you want to add Cordova plugins to your Capacitor project, see these docs${ancillary('[1]')}.\n\n${ancillary('[1]')}: ${strong('https://capacitor.ionicframework.com/docs/cordova/using-cordova-plugins')}` : '') // TODO: check for 'ionic cordova resources' ); } } export interface ConfirmCordovaUsageDeps { log: ILogger; prompt: PromptModule; } export async function confirmCordovaUsage({ log, prompt }: ConfirmCordovaUsageDeps): Promise { log.nl(); log.warn( `About to integrate your app with Cordova.\n` + `We now recommend ${emoji('âš¡ï¸ ', '')}${strong('Capacitor')}${emoji('âš¡ï¸ ', '')} (${strong('https://ion.link/capacitor')}) as the official native runtime for Ionic. To learn about the differences between Capacitor and Cordova, see these docs${ancillary('[1]')}. For a getting started guide, see these docs${ancillary('[2]')}.\n\n` + `${ancillary('[1]')}: ${strong('https://ion.link/capacitor-differences-with-cordova-docs')}\n` + `${ancillary('[2]')}: ${strong('https://ion.link/capacitor-using-with-ionic-docs')}\n` ); const confirm = await prompt({ type: 'confirm', message: 'Are you sure you want to continue?', default: true, }); return confirm; } export async function confirmCordovaBrowserUsage({ log, prompt }: ConfirmCordovaUsageDeps): Promise { log.nl(); log.warn( `About to add the ${input('browser')} platform to your app.\n` + `${strong(`The ${input('browser')} Cordova platform is not recommended for production use.`)}\n\n` + `Instead, we recommend using platform detection and browser APIs to target web/PWA. See the Cross Platform docs${ancillary('[1]')} for details.\n\n` + `Alternatively, ${emoji('âš¡ï¸ ', '')}${strong('Capacitor')}${emoji(' âš¡ï¸', '')} (${strong('https://ion.link/capacitor')}), Ionic's official native runtime, fully supports traditional web and Progressive Web Apps. See the Capacitor docs${ancillary('[2]')} to learn how easy it is to migrate.\n\n` + `${ancillary('[1]')}: ${strong('https://ion.link/cross-platform-docs')}\n` + `${ancillary('[2]')}: ${strong('https://ion.link/capacitor-cordova-migration-docs')}\n` ); const confirm = await prompt({ type: 'confirm', message: 'Are you sure you want to continue?', default: true, }); return confirm; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/enterprise/000077500000000000000000000000001425441362600276645ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/enterprise/index.ts000066400000000000000000000177701425441362600313570ustar00rootroot00000000000000import { BaseConfig, parseArgs } from '@ionic/cli-framework'; import { createPromptChoiceSeparator } from '@ionic/cli-framework-prompts'; import { readFile, writeFile } from '@ionic/utils-fs'; import * as lodash from 'lodash'; import * as path from 'path'; import { BaseIntegration } from '../'; import { App, EnterpriseProjectIntegration, IntegrationAddDetails, IntegrationName } from '../../../definitions'; import { isSuperAgentError } from '../../../guards'; import { strong, weak } from '../../color'; import { FatalException } from '../../errors'; interface ProductKey { id: number; key: string; registries: string[]; updated: string; created: string; org: any; app: any; packages: any[]; } const CHOICE_CREATE_NEW_APP = 'createNewApp'; export class EnterpriseIntegrationConfig extends BaseConfig { provideDefaults(c: Partial>): EnterpriseProjectIntegration { return {}; } } export class Integration extends BaseIntegration { readonly name: IntegrationName = 'enterprise'; readonly summary = 'Ionic Enterprise Edition provides premier native solutions, UI, & support for companies building cross-platform apps.'; readonly archiveUrl = undefined; async enable(config?: EnterpriseProjectIntegration): Promise { const baseConfig = config && config.root ? { root: config.root } : undefined; await this.updateNPMRC(); return super.enable(baseConfig); } async add(details: IntegrationAddDetails): Promise { let productKey = this.config.get('productKey'); let appId = this.config.get('appId'); if (details.enableArgs) { const parsedArgs = parseArgs(details.enableArgs, { string: ['app-id', 'key'] }); appId = parsedArgs['app-id']; productKey = parsedArgs['key']; } if (!productKey) { productKey = await this.e.prompt({ type: 'input', name: 'product-key', message: 'Please enter your product key:', }); } const keyInfo = await this.validatePK(productKey, appId); for (const entry of lodash.entries(keyInfo)) { const [key, value] = entry; this.config.set(key as any, value); } return super.add(details); } protected async validatePK(pk: string, appId?: string): Promise { let key = await this.getPK(pk); if (!key.app || appId) { if (!key.org) { // temporary error until we make possible to link the key to an app for personal accounts throw new FatalException('No App attached to key. Please contact support@ionic.io'); } if (!appId) { appId = await this.chooseAppToLink(key.org); } key = await this.registerKey(key, appId); } return { keyId: key.id, productKey: key.key, appId: key.app.id, orgId: key.org ? key.org.id : undefined, registries: key.registries, }; } protected async chooseAppToLink(org: any): Promise { const appClient = await this.getAppClient(); const paginator = appClient.paginate({}, org.id); const apps: App[] = []; for (const r of paginator) { const res = await r; apps.push(...res.data); } let appId = await this.chooseApp(apps, org); if (appId === CHOICE_CREATE_NEW_APP) { appId = await this.createNewApp(org); } return appId; } protected async registerKey(key: ProductKey, appId: string) { const token = await this.e.session.getUserToken(); const { req } = await this.e.client.make('PATCH', `/orgs/${key.org.id}/keys/${key.id}`); req.set('Authorization', `Bearer ${token}`); req.send({ app_id: appId }); try { const res = await this.e.client.do(req); return res.data as ProductKey; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401 || e.response.status === 403) { throw new FatalException('Authorization Failed. Make sure you\'re logged into the correct account with access to the key. Try logging out and back in again.'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to Register Key: ` + apiErrorMessage); } else { throw e; } } } protected async getAppClient() { const { AppClient } = await import('../../../lib/app'); const token = await this.e.session.getUserToken(); return new AppClient(token, this.e); } protected async createNewApp(org: any): Promise { const appName = await this.e.prompt({ type: 'input', name: 'appName', message: 'Please enter the name of your app:', }); const appClient = await this.getAppClient(); const newApp = await appClient.create({ org_id: org.id, name: appName }); return newApp.id; } protected async chooseApp(apps: App[], org: any): Promise { const { formatName } = await import('../../../lib/app'); const newAppChoice = { name: strong('Create A New App'), id: CHOICE_CREATE_NEW_APP, value: CHOICE_CREATE_NEW_APP, org, }; const linkedApp = await this.e.prompt({ type: 'list', name: 'linkedApp', message: 'This key needs to be registered to an app. Which app would you like to register it to?', choices: [ ...apps.map(app => ({ name: `${formatName(app)} ${weak(`(${app.id})`)}`, value: app.id, })), createPromptChoiceSeparator(), newAppChoice, createPromptChoiceSeparator(), ], }); return linkedApp; } protected async getPK(pk: string): Promise { const token = await this.e.session.getUserToken(); const { req } = await this.e.client.make('GET', '/keys/self'); req.set('Authorization', `Bearer ${token}`).set('Product-Key-ID', pk); try { const res = await this.e.client.do(req); return res.data as ProductKey; } catch (e) { if (isSuperAgentError(e)) { if (e.response.status === 401 || e.response.status === 403) { throw new FatalException('Authorization Failed. Make sure you\'re logged into the correct account with access to the key. Try logging out and back in again.'); } if (e.response.status === 404) { throw new FatalException('Invalid Product Key'); } const apiErrorMessage = (e.response.body.error && e.response.body.error.message) ? e.response.body.error.message : 'Api Error'; throw new FatalException(`Unable to Add Integration: ` + apiErrorMessage); } else { throw e; } } } protected async updateNPMRC() { const pk = this.config.get('productKey'); const registries = this.config.get('registries'); if (!pk || !registries) { throw new FatalException('Enterprise config invalid'); } let npmrc = ''; try { npmrc = await readFile(path.join(this.e.project.directory , '.npmrc'), 'utf8'); } catch (e) { if (!e.message.includes('ENOENT')) { throw e; } } for (const entry of registries) { const [scope, url] = entry.split(';'); const urlNoProt = url.split(':').splice(1).join(':'); const scopeRegex = new RegExp(`${scope}:registry.*\\n?`, 'g'); const urlRegex = new RegExp(`${urlNoProt}:_authToken.*\\n?`, 'g'); const newScope = `${scope}:registry=${url}\n`; const newUrl = `${urlNoProt}:_authToken=${pk}\n`; if (npmrc.match(scopeRegex)) { npmrc = npmrc.replace(scopeRegex, newScope); } else { npmrc += newScope; } if (npmrc.match(urlRegex)) { npmrc = npmrc.replace(urlRegex, newUrl); } else { npmrc += newUrl; } } await writeFile(path.join(this.e.project.directory, `.npmrc`), npmrc, { encoding: 'utf8' }); } get config(): EnterpriseIntegrationConfig { return new EnterpriseIntegrationConfig(this.e.project.filePath, { pathPrefix: [...this.e.project.pathPrefix, 'integrations', this.name] }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/integrations/index.ts000066400000000000000000000065031425441362600271670ustar00rootroot00000000000000import { BaseConfig } from '@ionic/cli-framework'; import { PromptModule } from '@ionic/cli-framework-prompts'; import * as path from 'path'; import { IClient, IConfig, IIntegration, ILogger, IProject, ISession, IShell, InfoItem, IntegrationAddDetails, IntegrationName, ProjectIntegration, ProjectPersonalizationDetails } from '../../definitions'; import { isIntegrationName } from '../../guards'; import { strong } from '../color'; import { IntegrationNotFoundException } from '../errors'; import type { Integration as CapacitorIntegration } from './capacitor'; import type { Integration as CordovaIntegration } from './cordova'; import type { Integration as EnterpriseIntegration } from './enterprise'; export { INTEGRATION_NAMES } from '../../guards'; export interface IntegrationOptions { quiet?: boolean; } export interface IntegrationDeps { readonly prompt: PromptModule; readonly client: IClient; readonly session: ISession; readonly config: IConfig; readonly shell: IShell; readonly project: IProject; readonly log: ILogger; } export class IntegrationConfig extends BaseConfig { provideDefaults(c: Partial>): ProjectIntegration { return {}; } } export abstract class BaseIntegration implements IIntegration { abstract readonly name: IntegrationName; abstract readonly summary: string; abstract readonly archiveUrl?: string; abstract readonly config: BaseConfig; constructor(protected readonly e: IntegrationDeps) {} static async createFromName(deps: IntegrationDeps, name: 'capacitor'): Promise; static async createFromName(deps: IntegrationDeps, name: 'cordova'): Promise; static async createFromName(deps: IntegrationDeps, name: 'enterprise'): Promise; static async createFromName(deps: IntegrationDeps, name: IntegrationName): Promise; static async createFromName(deps: IntegrationDeps, name: IntegrationName): Promise { if (isIntegrationName(name)) { const { Integration } = await import(`./${name}`); return new Integration(deps); } throw new IntegrationNotFoundException(`Bad integration name: ${strong(name)}`); // TODO? } async getInfo(): Promise { return []; } isAdded(): boolean { return !!this.e.project.config.get('integrations')[this.name]; } isEnabled(): boolean { const integrationConfig = this.e.project.config.get('integrations')[this.name]; return !!integrationConfig && integrationConfig.enabled !== false; } async enable(config?: ProjectIntegration): Promise { if (config && config.root) { this.config.set('root', config.root); } this.config.unset('enabled'); } async disable(): Promise { this.config.set('enabled', false); } async personalize(details: ProjectPersonalizationDetails) { // optionally overwritten by subclasses } async add(details: IntegrationAddDetails): Promise { const config = details.root !== this.e.project.directory ? { root: path.relative(this.e.project.rootDirectory, details.root) } : undefined; await this.enable(config); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/ionitron.ts000066400000000000000000000107351425441362600252150ustar00rootroot00000000000000import * as chalk from 'chalk'; export function getIonitronString(quote: string) { const quoteFormatted = quote .split('\n') .map(currentString => { const lineLength = 68; const paddingLeftSize = Math.floor((lineLength - currentString.length) / 2); const paddingRightSize = paddingLeftSize + ((lineLength - currentString.length) % 2); return ` |${' '.repeat(paddingLeftSize - 1)}${currentString}${' '.repeat(paddingRightSize - 1)}|`; }) .join('\n'); return chalk.blue(`\n\n\n h \`-oooooo/\`.++ ::-oooooooo... \`:.\`:oooooo/ \`\`\`-:oo\` /o. ./:--:::::--..\` .-/+ooooooooooooooooo+/:. \`-/ooooooooooooooooooooooooooo+:. -+ooooooooooooooooooooooooooooooooo+:\` :ooooooooooooooooooooooooooooooooooooooo/\` :ooooooooooooooooooooooooooooooooooooooooooo/\` \`+oooooooooooooooooooooooooooooooooooooooooooooo- -ooooooooooooooooooooooooooooooooooooooooooooooooo/ -ooooooooooooooooooooooooooooooooooooooooooooooooooo/.-. -ooooooooooooooooooooooooooooooooooooooooooooooooooooo/+o+\` \`ooooooooooooooooooooooooooooooooooooooooooooooooooooooo:ooo\` /ooooooooooooooooooooooooooooooooooooooooooooooooooooooo+ooo/ -+ooooooooooooooooooooooooooooooooooooooooooooooooooooooooooo+oooh -ooooooo+ooooooooooooooooooooooooooooooooooooooooooooooooooooooooo ooooooooo:oooooooooooooooooooooooooooooooooooooooooooooooooooooooo ooooooooo+:ooooooooooooooooooooooooooooooooooooooooooooooooooooooo oooooooooo.oooooooooooooooooooooooooooooooooooooooooooooooooooooo+ oooooooooo:/oooooooooooooooooooooooooooooooooooooooooooooooooooo+\` +ooooooooo//oooooooooooooooooooooooooooooooooooooooooooooooooo\`\` .ooooooooo/+oooooooooooooooooooooo:.-+oooooooo: \`/oooooooooo- :oooooooo/oooooooooooooooooooooo: \`oooooooo. :ooooooooo/ :ooooooooooooooooooooooooooooooo:--+ooooooooo+/oooooooooo/ \`:////ooooooooooooooooooooooooooooooooooooooooooooooooo: \`+oooooooooooooooooooooooooooooooooooooooooooooo. -ooooooooooooooooooooooooooooooooooooooooooo:\` \`:ooooooooooooooooooooooooooooooooooooooo/\` ./ooooooooooooooooooooooooooooooooo+-\` \`-/ooooooooooooooooooooooooooo/-\``) + `\\ ` + chalk.blue(`\`-:+ooooooooooooooooo+/-.`) + ` \\ \\ ` + chalk.blue(`'\\:--::::--/'`) + ` | \\ / \\ -----------------------------------------------* *---------- / \\ / \\ ${quoteFormatted} \\ / \\ / *--------------------------------------------------------------*\n\n`; } export const ionitronStatements = { 'en': [ 'Hello human, what shall we build today?', '*BEEP BEEP* ALL YOUR BASE ARE BELONG TO US *BEEP BEEP*', 'Prepare to dominate your hybrid app. Engaging now.', 'My sensors indicate you have an undying love for ionic,\nor is it just me?', 'That\'s a nice looking app you have there.\nDefinitely one of the better human made apps I\'ve seen.', 'Oh, hi there. I was not just indexing your hard drive,\ndefinitely not doing that.' + 'That would need bee\'s approval', 'Fork you! Oh, I\'m sorry, wrong branch.', ], 'es': [ '\u0021Hola humano! \u00BFQu\u00E9 vamos a construir hoy?', '*BEEP BEEP* TU BASE NOS PERTENECE *BEEP BEEP*', 'Prep\u00E1rate para dominar las aplicaciones h\u00EDbridas.\nParticipa ahora.', 'Mis sensores indican que sientes amor eterno hacia Ionic,\n\u00BFo es solo hacia m\u00ED?', 'Es una bonita aplicaci\u00F3n esa que tienes.\nEres el mejor desarrollador humano que he visto.', 'Oh, hola. No estaba indexando tu disco duro, no hago eso.', 'Es necesitaria la aprobaci\u00F3n de las abejas.', 'Bif\u00Farcate! Oh, Lo siento, rama equivocada. ', ], }; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/namespace.ts000066400000000000000000000015701425441362600253050ustar00rootroot00000000000000import { BaseCommandMap, BaseNamespace, BaseNamespaceMap } from '@ionic/cli-framework'; import { CommandMetadata, CommandMetadataInput, CommandMetadataOption, ICommand, INamespace, IProject, IonicEnvironment } from '../definitions'; export class CommandMap extends BaseCommandMap {} export class NamespaceMap extends BaseNamespaceMap {} export abstract class Namespace extends BaseNamespace implements INamespace { constructor(public parent: INamespace | undefined) { super(parent); } get env(): IonicEnvironment { return this.root.env; } get project(): IProject | undefined { return this.root.project; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/native-run.ts000066400000000000000000000123521425441362600254410ustar00rootroot00000000000000import { processExit } from '@ionic/utils-process'; import { ERROR_COMMAND_NOT_FOUND, ERROR_NON_ZERO_EXIT, SubprocessError, which } from '@ionic/utils-subprocess'; import { CommandLineOptions, IConfig, ILogger, IShell, IShellRunOptions, NpmClient } from '../definitions'; import { input, weak } from './color'; import { FatalException } from './errors'; import { createPrefixedWriteStream } from './utils/logger'; import { pkgManagerArgs } from './utils/npm'; export const SUPPORTED_PLATFORMS: readonly string[] = ['ios', 'android']; export interface NativeRunSchema { packagePath: string; platform: string; forwardedPorts?: (string | number)[]; } export function createNativeRunArgs({ packagePath, platform, forwardedPorts = [] }: NativeRunSchema, options: CommandLineOptions): string[] { const opts = [platform, '--app', packagePath]; const target = options['target'] ? String(options['target']) : undefined; if (target) { opts.push('--target', target); } else if (options['emulator']) { opts.push('--virtual'); } else if (options['device']) { opts.push('--device'); } if (options['connect']) { opts.push('--connect'); } for (const port of forwardedPorts) { opts.push('--forward', `${port}:${port}`); } if (options['json']) { opts.push('--json'); } if (options['verbose']) { opts.push('--verbose'); } return opts; } export function createNativeRunListArgs(inputs: string[], options: CommandLineOptions): string[] { const args = []; if (inputs[0]) { args.push(inputs[0]); } args.push('--list'); if (options['json']) { args.push('--json'); } if (options['device']) { args.push('--device'); } if (options['emulator']) { args.push('--virtual'); } if (options['json']) { args.push('--json'); } return args; } export interface RunNativeRunDeps { readonly config: IConfig; readonly log: ILogger; readonly shell: IShell; } export async function runNativeRun({ config, log, shell }: RunNativeRunDeps, args: readonly string[], options: IShellRunOptions = {}): Promise { const connect = args.includes('--connect'); const stream = createPrefixedWriteStream(log, weak(`[native-run]`)); try { await shell.run('native-run', args, { showCommand: !args.includes('--json'), fatalOnNotFound: false, stream, ...options }); } catch (e) { if (e instanceof SubprocessError && e.code === ERROR_COMMAND_NOT_FOUND) { throw createNativeRunNotFoundError(config.get('npmClient')); } throw e; } // If we connect the `native-run` process to the running app, then we // should also connect the Ionic CLI with the running `native-run` process. // This will exit the Ionic CLI when `native-run` exits. if (connect) { processExit(0); } } export interface CheckNativeRunDeps { readonly config: IConfig; } export async function checkNativeRun({ config }: CheckNativeRunDeps): Promise { const p = await findNativeRun(); if (!p) { throw await createNativeRunNotFoundError(config.get('npmClient')); } } export async function findNativeRun(): Promise { try { return await which('native-run'); } catch (e) { if (e.code !== 'ENOENT') { throw e; } } } async function createNativeRunNotFoundError(npmClient: NpmClient): Promise { const installArgs = await pkgManagerArgs(npmClient, { command: 'install', pkg: 'native-run', global: true }); return new FatalException( `${input('native-run')} was not found on your PATH. Please install it globally:\n` + `${input(installArgs.join(' '))}\n` ); } export interface NativeDeviceTarget { platform: string; id: string; model: string; sdkVersion: string; } export interface NativeVirtualDeviceTarget { platform: string; id: string; name: string; sdkVersion: string; } export interface NativeTargetPlatform { devices: NativeDeviceTarget[]; virtualDevices: NativeVirtualDeviceTarget[]; } export async function getNativeTargets({ log, shell }: RunNativeRunDeps, platform: string): Promise { try { const proc = await shell.createSubprocess('native-run', [platform, '--list', '--json']); const output = await proc.output(); return JSON.parse(output); } catch (e) { if (e instanceof SubprocessError && e.code === ERROR_NON_ZERO_EXIT) { const output = e.output ? JSON.parse(e.output) : {}; throw new FatalException( `Error while getting native targets for ${input(platform)}: ${output.error || output.code}\n` + ( platform === 'android' && output.code === 'ERR_UNSUITABLE_API_INSTALLATION' ? ( `\n${input('native-run')} needs a fully installed SDK Platform to run your app.\n` + `- Run ${input('native-run android --sdk-info')} to see missing packages for each API level.\n` + `- Install missing packages in Android Studio by opening the SDK manager.\n` ) : '' ) + `\nThis error occurred while using ${input('native-run')}. You can try running this command with ${input('--no-native-run')}, which will revert to using Cordova.\n` ); } log.warn(`Error while getting native targets for ${input(platform)}:\n${e.stack ? e.stack : e}`); } return { devices: [], virtualDevices: [] }; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/oauth/000077500000000000000000000000001425441362600241165ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/oauth/auth.ts000066400000000000000000000017451425441362600254360ustar00rootroot00000000000000import { IClient, ResourceClientLoad } from '../../definitions'; import { isAuthConnectionResponse } from '../../guards'; import { ResourceClient, createFatalAPIFormat } from '../http'; export interface AuthConnection { readonly uuid: string; } export interface AuthClientDeps { readonly client: IClient; } export class AuthClient extends ResourceClient { readonly connections: AuthConnectionClient; constructor(readonly e: AuthClientDeps) { super(); this.connections = new AuthConnectionClient(e); } } export class AuthConnectionClient extends ResourceClient implements ResourceClientLoad { constructor(readonly e: AuthClientDeps) { super(); } async load(email: string): Promise { const { req } = await this.e.client.make('GET', `/auth/connections/${email}`); const res = await this.e.client.do(req); if (!isAuthConnectionResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/oauth/oauth.ts000066400000000000000000000133761425441362600256200ustar00rootroot00000000000000import { readFile } from '@ionic/utils-fs'; import { isPortAvailable } from '@ionic/utils-network'; import * as crypto from 'crypto'; import * as http from 'http'; import * as path from 'path'; import * as qs from 'querystring'; import { Response } from 'superagent'; import { ASSETS_DIRECTORY } from '../../constants'; import { ContentType, IClient, IConfig, OAuthServerConfig, OpenIdToken } from '../../definitions'; import { FatalException } from '../errors'; import { formatResponseError } from '../http'; import { openUrl } from '../open'; const REDIRECT_PORT = 8123; const REDIRECT_HOST = 'localhost'; export interface AuthorizationParameters { [key: string]: string; } export interface TokenParameters { [key: string]: string; } export interface OAuth2FlowOptions { readonly redirectHost?: string; readonly redirectPort?: number; readonly accessTokenRequestContentType?: ContentType; } export interface OAuth2FlowDeps { readonly client: IClient; readonly config: IConfig; } export abstract class OAuth2Flow { abstract readonly flowName: string; readonly oauthConfig: OAuthServerConfig; readonly redirectHost: string; readonly redirectPort: number; readonly accessTokenRequestContentType: ContentType; constructor({ redirectHost = REDIRECT_HOST, redirectPort = REDIRECT_PORT, accessTokenRequestContentType = ContentType.JSON }: OAuth2FlowOptions, readonly e: OAuth2FlowDeps) { this.oauthConfig = this.getAuthConfig(); this.redirectHost = redirectHost; this.redirectPort = redirectPort; this.accessTokenRequestContentType = accessTokenRequestContentType; } get redirectUrl(): string { return `http://${this.redirectHost}:${this.redirectPort}`; } async run(): Promise { const verifier = this.generateVerifier(); const challenge = this.generateChallenge(verifier); const authorizationParams = this.generateAuthorizationParameters(challenge); const authorizationUrl = `${this.oauthConfig.authorizationUrl}?${qs.stringify(authorizationParams)}`; await openUrl(authorizationUrl); const { code, state } = await this.getAuthorizationCode(); const token = await this.exchangeAuthForAccessToken(code, verifier); token.state = state; return token; } async exchangeRefreshToken(refreshToken: string): Promise { const params = this.generateRefreshTokenParameters(refreshToken); const { req } = await this.e.client.make('POST', this.oauthConfig.tokenUrl, this.accessTokenRequestContentType); const res = await req.send(params); // check the response status code first here if (!res.ok) { throw new FatalException( 'API request to refresh token was not successful.\n' + 'Please try to login again.\n' + formatResponseError(req, res.status) ); } if (!this.checkValidExchangeTokenRes(res)) { throw new FatalException( 'API request was successful, but the refreshed token was unrecognized.\n' + 'Please try to login again.\n' ); } return res.body; } protected abstract generateAuthorizationParameters(challenge: string): AuthorizationParameters; protected abstract generateTokenParameters(authorizationCode: string, verifier: string): TokenParameters; protected abstract generateRefreshTokenParameters(refreshToken: string): TokenParameters; protected abstract checkValidExchangeTokenRes(res: Response): boolean; protected abstract getAuthConfig(): OAuthServerConfig; protected async getSuccessHtml(): Promise { const p = path.resolve(ASSETS_DIRECTORY, 'oauth', 'success', 'index.html'); const contents = await readFile(p, { encoding: 'utf8' }); return contents; } protected async getAuthorizationCode(): Promise<{code: string; state?: string}> { if (!(await isPortAvailable(this.redirectPort))) { throw new Error(`Cannot start local server. Port ${this.redirectPort} is in use.`); } const successHtml = await this.getSuccessHtml(); return new Promise<{code: string; state?: string}>((resolve, reject) => { const server = http.createServer((req, res) => { if (req.url) { const params = qs.parse(req.url.substring(req.url.indexOf('?') + 1)); if (params.code) { res.writeHead(200, { 'Content-Type': ContentType.HTML }); res.end(successHtml); req.socket.destroy(); server.close(); const authResult = { code: Array.isArray(params.code) ? params.code[0] : params.code, state: Array.isArray(params.state) ? decodeURI(params.state[0]) : decodeURI(params.state), }; resolve(authResult); } // TODO, timeout, error handling } }); server.listen(this.redirectPort, this.redirectHost); }); } protected async exchangeAuthForAccessToken(authorizationCode: string, verifier: string): Promise { const params = this.generateTokenParameters(authorizationCode, verifier); const { req } = await this.e.client.make('POST', this.oauthConfig.tokenUrl, this.accessTokenRequestContentType); const res = await req.send(params); if (!this.checkValidExchangeTokenRes(res)) { throw new FatalException( 'API request was successful, but the response format was unrecognized.\n' + formatResponseError(req, res.status) ); } return res.body; } protected generateVerifier(): string { return this.base64URLEncode(crypto.randomBytes(32)); } protected generateChallenge(verifier: string): string { return this.base64URLEncode(crypto.createHash('sha256').update(verifier).digest()); } protected base64URLEncode(buffer: Buffer) { return buffer.toString('base64') .replace(/\+/g, '-') .replace(/\//g, '_') .replace(/=/g, ''); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/oauth/openid.ts000066400000000000000000000037661425441362600257600ustar00rootroot00000000000000import { Response } from 'superagent'; import { ContentType, OAuthServerConfig, OpenIdToken } from '../../definitions'; import { isOpenIDTokenExchangeResponse } from '../../guards'; import { AuthorizationParameters, OAuth2Flow, OAuth2FlowDeps, OAuth2FlowOptions, TokenParameters } from './oauth'; export interface OpenIDFlowOptions extends Partial { readonly accessTokenRequestContentType?: ContentType; } export class OpenIDFlow extends OAuth2Flow { readonly flowName = 'open_id'; constructor({ accessTokenRequestContentType = ContentType.FORM_URLENCODED, ...options }: OpenIDFlowOptions, readonly e: OAuth2FlowDeps, authorizationUrlOverride?: string) { super({ accessTokenRequestContentType, ...options }, e); if (authorizationUrlOverride) { this.oauthConfig.authorizationUrl = authorizationUrlOverride; } } protected generateAuthorizationParameters(challenge: string): AuthorizationParameters { return { audience: this.oauthConfig.apiAudience, scope: 'openid profile email offline_access', response_type: 'code', client_id: this.oauthConfig.clientId, code_challenge: challenge, code_challenge_method: 'S256', redirect_uri: this.redirectUrl, nonce: this.generateVerifier(), }; } protected generateTokenParameters(code: string, verifier: string): TokenParameters { return { grant_type: 'authorization_code', client_id: this.oauthConfig.clientId, code_verifier: verifier, code, redirect_uri: this.redirectUrl, }; } protected generateRefreshTokenParameters(refreshToken: string): TokenParameters { return { refresh_token: refreshToken, grant_type: 'refresh_token', client_id: this.oauthConfig.clientId, }; } protected checkValidExchangeTokenRes(res: Response): boolean { return isOpenIDTokenExchangeResponse(res); } protected getAuthConfig(): OAuthServerConfig { return this.e.config.getOpenIDOAuthConfig(); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/open.ts000066400000000000000000000007221425441362600243100ustar00rootroot00000000000000import * as Debug from 'debug'; const debug = Debug('ionic:lib:open'); export interface OpenUrlOptions { app?: string | readonly string[]; } export async function openUrl(target: string, options: OpenUrlOptions = {}): Promise { const o = await import ('open'); const p = await o(target, { ...options, wait: false, url: true }); const e = (err: Error) => debug('Error during open: %O', err); const n = p.on.bind(p); n('error', err => e(err)); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/000077500000000000000000000000001425441362600244445ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/000077500000000000000000000000001425441362600260755ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/__tests__/000077500000000000000000000000001425441362600300335ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/__tests__/build.ts000066400000000000000000000071431425441362600315070ustar00rootroot00000000000000import { AngularBuildCLI } from '../build'; describe('@ionic/cli', () => { describe('lib/project/angular/build', () => { describe('AngularBuildCLI', () => { describe('buildOptionsToNgArgs', () => { const defaults = { '--': [], }; it('should pass options', async () => { const project = {}; const cli = new AngularBuildCLI({ project } as any); const options = { ...defaults, sourcemaps: true, }; const result = await (cli as any).buildOptionsToNgArgs(options); expect(result).toEqual(['--source-map']); }); it('should pass cordova options', async () => { const root = 'fakeRoot'; const project = { requireIntegration: jest.fn(() => ({ root })), }; const cli = new AngularBuildCLI({ project } as any); const options = { ...defaults, engine: 'cordova', platform: 'fakePlatform', }; const result = await (cli as any).buildOptionsToNgArgs(options); expect(result).toEqual([ `--platform=${options.platform}`, `--cordova-base-path=${root}`, ]); }); it('should pass verbose flag', async () => { const project = {}; const cli = new AngularBuildCLI({ project } as any); const options = { ...defaults, verbose: true, }; const result = await (cli as any).buildOptionsToNgArgs(options); expect(result).toEqual(['--verbose']); }); it('should pass separated options', async () => { const project = {}; const cli = new AngularBuildCLI({ project } as any); const options = { ...defaults, '--': ['--extra=true'], }; const result = await (cli as any).buildOptionsToNgArgs(options); expect(result).toEqual(['--extra=true']); }); it('should not pass separated options for cordova', async () => { const root = 'fakeRoot'; const project = { requireIntegration: jest.fn(() => ({ root })), }; const cli = new AngularBuildCLI({ project } as any); const options = { ...defaults, engine: 'cordova', platform: 'fakePlatform', '--': ['--extra=true'], }; const result = await (cli as any).buildOptionsToNgArgs(options); expect(result).not.toEqual(expect.arrayContaining(['--extra=true'])); }); it('should pass configuration and project for custom program', async () => { const project = {}; const cli = new AngularBuildCLI({ project } as any); (cli as any)._resolvedProgram = 'npm'; const options = { ...defaults, configuration: 'production', project: 'otherProject', }; const result = await (cli as any).buildOptionsToNgArgs(options); expect(result).toEqual(['--configuration=production', '--project=otherProject']); }); it('should not pass configuration and project for custom program if they are the defaults', async () => { const project = {}; const cli = new AngularBuildCLI({ project } as any); (cli as any)._resolvedProgram = 'npm'; const options = { ...defaults, }; const result = await (cli as any).buildOptionsToNgArgs(options); expect(result).toEqual([]); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/__tests__/generate.ts000066400000000000000000000025131425441362600321760ustar00rootroot00000000000000import { CommandLineOptions } from '../../../../definitions'; import { AngularGenerateRunner } from '../generate'; describe('@ionic/cli', () => { describe('lib/project/angular/generate', () => { describe('AngularGenerateRunner', () => { describe('createOptionsFromCommandLine', () => { const defaults = { name: undefined, project: 'app', type: undefined, }; it('should provide defaults with no inputs or options', () => { const runner = new AngularGenerateRunner({} as any); const result = runner.createOptionsFromCommandLine([], {} as CommandLineOptions); expect(result).toEqual(defaults); }); it('should provide options from inputs', () => { const runner = new AngularGenerateRunner({} as any); const result = runner.createOptionsFromCommandLine(['service', 'FancyBar'], { _: [] }); expect(result).toEqual({ ...defaults, name: 'FancyBar', type: 'service' }); }); it('should respect --project', () => { const runner = new AngularGenerateRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], project: 'otherProject' }); expect(result).toEqual({ ...defaults, project: 'otherProject' }); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/__tests__/index.ts000066400000000000000000000015111425441362600315100ustar00rootroot00000000000000import * as path from 'path' import { AngularProject } from '../'; describe('@ionic/cli', () => { describe('lib/project/angular', () => { describe('AngularProject', () => { let p: AngularProject; beforeEach(() => { p = new AngularProject({ context: 'app', configPath: '/path/to/proj/file' } as any, {} as any); jest.spyOn(p, 'config', 'get').mockImplementation(() => ({ get: () => undefined } as any)); }); it('should set directory attribute', async () => { expect(p.directory).toEqual(path.resolve('/path/to/proj')); }); describe('getSourceDir', () => { it('should default to src', async () => { const result = await p.getSourceDir(); expect(result).toEqual(path.resolve('/path/to/proj/src')); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/__tests__/serve.ts000066400000000000000000000155131425441362600315340ustar00rootroot00000000000000import { CommandLineOptions } from '../../../../definitions'; import { AngularServeCLI, AngularServeRunner } from '../serve'; describe('@ionic/cli', () => { describe('lib/project/angular/serve', () => { describe('AngularServeRunner', () => { describe('createOptionsFromCommandLine', () => { const defaults = { '--': [], publicHost: undefined, host: 'localhost', browser: undefined, browserOption: undefined, engine: 'browser', externalAddressRequired: false, lab: false, labHost: 'localhost', labPort: 8200, livereload: true, open: false, port: 8100, proxy: true, project: 'app', prod: undefined, platform: undefined, verbose: false, }; it('should provide defaults with no options', () => { const runner = new AngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], {} as CommandLineOptions); expect(result).toEqual(defaults); }); it('should provide options from negations of cli flag defaults', () => { const runner = new AngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); expect(result).toEqual({ ...defaults, livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); }); it('should allow overrides of default values', () => { const runner = new AngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], host: '0.0.0.0', port: '1111' }); expect(result).toEqual({ ...defaults, host: '0.0.0.0', port: 1111 }); }); it('should respect --external flag', () => { const runner = new AngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], host: 'localhost', external: true }); expect(result).toEqual({ ...defaults, host: '0.0.0.0' }); }); it('should respect --consolelogs flag', () => { const runner = new AngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], consolelogs: true }); expect(result).toEqual({ ...defaults, consolelogs: true, consolelogsPort: 53703 }); }); it('should respect --project and --configuration flags', () => { const runner = new AngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], project: 'otherProject', configuration: 'production' }); expect(result).toEqual({ ...defaults, project: 'otherProject', configuration: 'production' }); }); it('should pass on separated args', () => { const runner = new AngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], '--': ['foo', '--bar'] }); expect(result).toEqual({ ...defaults, '--': ['foo', '--bar'] }); }); }); }); describe('AngularServeCLI', () => { describe('serveOptionsToNgArgs', () => { const defaults = { '--': [], }; it('should pass options', async () => { const project = {}; const cli = new AngularServeCLI({ project } as any); const options = { ...defaults, host: 'localhost', port: 4200, sourcemaps: true, ssl: true, }; const result = await (cli as any).serveOptionsToNgArgs(options); expect(result).toEqual([ `--host=${options.host}`, `--port=${options.port}`, `--source-map`, `--ssl`, ]); }); it('should pass verbose flag', async () => { const project = {}; const cli = new AngularServeCLI({ project } as any); const options = { ...defaults, verbose: true, }; const result = await (cli as any).serveOptionsToNgArgs(options); expect(result).toEqual(['--verbose']); }); it('should pass cordova options', async () => { const root = 'fakeRoot'; const project = { requireIntegration: jest.fn(() => ({ root })), }; const cli = new AngularServeCLI({ project } as any); const options = { ...defaults, engine: 'cordova', platform: 'fakePlatform', }; const result = await (cli as any).serveOptionsToNgArgs(options); expect(result).toEqual([ `--platform=${options.platform}`, `--cordova-base-path=${root}`, ]); }); it('should pass separated options', async () => { const project = {}; const cli = new AngularServeCLI({ project } as any); const options = { ...defaults, '--': ['--extra=true'], }; const result = await (cli as any).serveOptionsToNgArgs(options); expect(result).toEqual(['--extra=true']); }); it('should not pass separated options for cordova', async () => { const root = 'fakeRoot'; const project = { requireIntegration: jest.fn(() => ({ root })), }; const cli = new AngularServeCLI({ project } as any); const options = { ...defaults, engine: 'cordova', platform: 'fakePlatform', '--': ['--extra=true'], }; const result = await (cli as any).serveOptionsToNgArgs(options); expect(result).not.toEqual(expect.arrayContaining(['--extra=true'])); }); it('should pass configuration and project for custom program', async () => { const project = {}; const cli = new AngularServeCLI({ project } as any); (cli as any)._resolvedProgram = 'npm'; const options = { ...defaults, configuration: 'production', project: 'otherProject', }; const result = await (cli as any).serveOptionsToNgArgs(options); expect(result).toEqual(['--configuration=production', '--project=otherProject']); }); it('should not pass configuration and project for custom program if they are the defaults', async () => { const project = {}; const cli = new AngularServeCLI({ project } as any); (cli as any)._resolvedProgram = 'npm'; const options = { ...defaults, }; const result = await (cli as any).serveOptionsToNgArgs(options); expect(result).toEqual([]); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/ailments.ts000066400000000000000000000006771425441362600302730ustar00rootroot00000000000000import { AilmentDeps } from '../../doctor'; import { AngularProject } from './'; export interface AngularAilmentDeps extends AilmentDeps { readonly project: AngularProject; } // abstract class AngularAilment extends Ailment { // readonly projects: ProjectType[] = ['angular']; // protected readonly project: AngularProject; // constructor(deps: AngularAilmentDeps) { // super(deps); // this.project = deps.project; // } // } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/build.ts000066400000000000000000000130021425441362600275400ustar00rootroot00000000000000import { MetadataGroup, ParsedArgs, unparseArgs } from '@ionic/cli-framework'; import { AngularBuildOptions, CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../../definitions'; import { BUILD_SCRIPT, BuildCLI, BuildRunner, BuildRunnerDeps } from '../../build'; import { input, weak } from '../../color'; import { AngularProject } from './'; const NG_BUILD_OPTIONS = [ { name: 'configuration', aliases: ['c'], summary: 'Specify the configuration to use.', type: String, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[ng]'), spec: { value: 'conf' }, }, { name: 'source-map', summary: 'Output source maps', type: Boolean, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[ng]'), }, { name: 'watch', summary: 'Rebuild when files change', type: Boolean, groups: [MetadataGroup.ADVANCED], hint: weak('[ng]'), }, ]; export interface AngularBuildRunnerDeps extends BuildRunnerDeps { readonly project: AngularProject; } export class AngularBuildRunner extends BuildRunner { constructor(protected readonly e: AngularBuildRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { description: ` ${input('ionic build')} uses the Angular CLI. Use ${input('ng build --help')} to list all Angular CLI options for building your app. See the ${input('ng build')} docs[^ng-build-docs] for explanations. Options not listed below are considered advanced and can be passed to the ${input('ng')} CLI using the ${input('--')} separator after the Ionic CLI arguments. See the examples. `, footnotes: [ { id: 'ng-build-docs', url: 'https://angular.io/cli/build', }, ], options: [ { name: 'prod', summary: `Flag to use the ${input('production')} configuration`, type: Boolean, hint: weak('[ng]'), groups: ['cordova'], }, ...NG_BUILD_OPTIONS, { name: 'cordova-assets', summary: 'Do not bundle Cordova assets during Cordova build', type: Boolean, groups: [MetadataGroup.HIDDEN, 'cordova'], default: true, }, ], exampleCommands: [ '--prod', '--watch', ], }; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): AngularBuildOptions { const baseOptions = super.createBaseOptionsFromCommandLine(inputs, options); const prod = options['prod'] ? Boolean(options['prod']) : undefined; const configuration = options['configuration'] ? String(options['configuration']) : (prod ? 'production' : undefined); const project = options['project'] ? String(options['project']) : 'app'; const sourcemaps = typeof options['source-map'] === 'boolean' ? Boolean(options['source-map']) : undefined; const cordovaAssets = typeof options['cordova-assets'] === 'boolean' ? Boolean(options['cordova-assets']) : undefined; const watch = typeof options['watch'] === 'boolean' ? Boolean(options['watch']) : undefined; return { ...baseOptions, configuration, project, sourcemaps, cordovaAssets, watch, type: 'angular', }; } async buildProject(options: AngularBuildOptions): Promise { const ng = new AngularBuildCLI(this.e); await ng.build(options); } } export class AngularBuildCLI extends BuildCLI { readonly name = 'Angular CLI'; readonly pkg = '@angular/cli'; readonly program = 'ng'; readonly prefix = 'ng'; readonly script = BUILD_SCRIPT; protected async buildArgs(options: AngularBuildOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); const args = await this.buildOptionsToNgArgs(options); if (this.resolvedProgram === this.program) { return [...this.buildArchitectCommand(options), ...args]; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script, scriptArgs: [...args] }); return pkgArgs; } } protected async buildOptionsToNgArgs(options: AngularBuildOptions): Promise { const args: ParsedArgs = { _: [], 'source-map': options.sourcemaps !== false ? options.sourcemaps : 'false', 'cordova-assets': options.cordovaAssets !== false ? undefined : 'false', 'watch': options.watch !== false ? options.watch : 'false', }; const projectArgs = []; let separatedArgs = options['--']; if (options.engine === 'cordova') { const integration = this.e.project.requireIntegration('cordova'); args.platform = options.platform; if (this.e.project.rootDirectory !== integration.root) { args.cordovaBasePath = integration.root; } separatedArgs = []; } if (this.resolvedProgram !== this.program) { if (options.configuration) { projectArgs.push(`--configuration=${options.configuration}`); } if (options.project) { projectArgs.push(`--project=${options.project}`); } } if (options.verbose) { projectArgs.push('--verbose'); } return [...unparseArgs(args), ...projectArgs, ...separatedArgs]; } protected buildArchitectCommand(options: AngularBuildOptions): string[] { const cmd = options.engine === 'cordova' ? 'ionic-cordova-build' : 'build'; return ['run', `${options.project}:${cmd}${options.configuration ? `:${options.configuration}` : ''}`]; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/generate.ts000066400000000000000000000126461425441362600302500ustar00rootroot00000000000000import { unparseArgs, validators } from '@ionic/cli-framework'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import { AngularGenerateOptions, CommandLineInputs, CommandLineOptions, CommandMetadata } from '../../../definitions'; import { ancillary, input, strong } from '../../color'; import { GLOBAL_OPTIONS } from '../../config'; import { FatalException } from '../../errors'; import { GenerateRunner, GenerateRunnerDeps } from '../../generate'; import { AngularProject } from './'; // https://github.com/ionic-team/angular-toolkit/blob/master/collection.json const SCHEMATICS: readonly string[] = ['page', 'component', 'service', 'module', 'class', 'directive', 'guard', 'pipe', 'interface', 'enum']; const SCHEMATIC_ALIAS = new Map([ ['pg', 'page'], ['cl', 'class'], ['c', 'component'], ['d', 'directive'], ['e', 'enum'], ['g', 'guard'], ['i', 'interface'], ['m', 'module'], ['p', 'pipe'], ['s', 'service'], ]); const debug = Debug('ionic:lib:project:angular:generate'); export interface AngularGenerateRunnerDeps extends GenerateRunnerDeps { readonly project: AngularProject; } export class AngularGenerateRunner extends GenerateRunner { constructor(protected readonly e: AngularGenerateRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { description: ` Automatically create framework features with Ionic Generate. This command uses the Angular CLI to generate features such as ${['pages', 'components', 'directives', 'services'].map(c => input(c)).join(', ')}, and more. - For a full list of available types, use ${input('npx ng g --help')} - For a list of options for a types, use ${input('npx ng g --help')} You can specify a path to nest your feature within any number of subdirectories. For example, specify a name of ${input('"pages/New Page"')} to generate page files at ${strong('src/app/pages/new-page/')}. To test a generator before file modifications are made, use the ${input('--dry-run')} option. `, exampleCommands: [ 'page', 'page contact', 'component contact/form', 'component login-form --change-detection=OnPush', 'directive ripple --skip-import', 'service api/user', ], inputs: [ { name: 'type', summary: `The type of feature (e.g. ${['page', 'component', 'directive', 'service'].map(c => input(c)).join(', ')})`, validators: [validators.required], }, { name: 'name', summary: 'The name/path of the feature being generated', validators: [validators.required], }, ], }; } async ensureCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (inputs[0]) { this.validateFeatureType(inputs[0]); } else { const type = await this.e.prompt({ type: 'list', name: 'type', message: 'What would you like to generate?', choices: SCHEMATICS, }); inputs[0] = type; } if (!inputs[1]) { const type = SCHEMATIC_ALIAS.get(inputs[0]) || inputs[0]; const name = await this.e.prompt({ type: 'input', name: 'name', message: `Name/path of ${input(type)}:`, validate: v => validators.required(v), }); inputs[1] = name.trim(); } } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): AngularGenerateOptions { const baseOptions = super.createOptionsFromCommandLine(inputs, options); const project = options['project'] ? String(options['project']) : 'app'; // TODO: this is a little gross, is there a better way to pass in all the // options that the command got? return { ...lodash.omit(options, '_', '--', ...GLOBAL_OPTIONS.map(opt => opt.name)), project, ...baseOptions, }; } async run(options: AngularGenerateOptions) { const { name } = options; const type = SCHEMATIC_ALIAS.get(options.type) || options.type; try { await this.generateComponent(type, name, lodash.omit(options, 'type', 'name')); } catch (e) { debug(e); throw new FatalException(`Could not generate ${input(type)}.`); } if (!options['dry-run']) { this.e.log.ok(`Generated ${input(type)}!`); } } private validateFeatureType(type: string) { if (type === 'provider') { throw new FatalException( `Please use ${input('ionic generate service')} for generating service providers.\n` + `For more information, please see the Angular documentation${ancillary('[1]')} on services.\n\n` + `${ancillary('[1]')}: ${strong('https://angular.io/guide/architecture-services')}` ); } if (!SCHEMATICS.includes(type) && !SCHEMATIC_ALIAS.get(type)) { throw new FatalException( `${input(type)} is not a known feature.\n` + `Use ${input('npx ng g --help')} to list available types of features.` ); } } private async generateComponent(type: string, name: string, options: { [key: string]: string | boolean; }) { const args = { _: ['generate', type, name], // convert `--no-` style options to `--=false` ...lodash.mapValues(options, v => v === false ? 'false' : v), }; await this.e.shell.run( 'ng', unparseArgs(args, { useEquals: true }), { cwd: this.e.ctx.execPath, stdio: 'inherit' } ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/index.ts000066400000000000000000000072041425441362600275570ustar00rootroot00000000000000import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as path from 'path'; import { Project } from '../'; import { IAilmentRegistry, InfoItem } from '../../../definitions'; import { strong } from '../../color'; const debug = Debug('ionic:lib:project:angular'); export class AngularProject extends Project { readonly type: 'angular' = 'angular'; async getInfo(): Promise { const [ [ ionicAngularPkg, ionicAngularPkgPath ], [ ionicAngularToolkitPkg, ionicAngularToolkitPkgPath ], [ angularCLIPkg, angularCLIPkgPath ], [ angularDevKitBuildAngularPkg, angularDevKitBuildAngularPkgPath ], [ angularDevKitSchematicsPkg, angularDevKitSchematicsPkgPath ], ] = await Promise.all([ this.getPackageJson('@ionic/angular'), this.getPackageJson('@ionic/angular-toolkit'), this.getPackageJson('@angular/cli'), this.getPackageJson('@angular-devkit/build-angular'), this.getPackageJson('@angular-devkit/schematics'), ]); return [ ...(await super.getInfo()), { group: 'ionic', name: 'Ionic Framework', key: 'framework', value: ionicAngularPkg ? `@ionic/angular ${ionicAngularPkg.version}` : 'not installed', path: ionicAngularPkgPath, }, { group: 'ionic', name: '@ionic/angular-toolkit', key: 'ionic_angular_toolkit_version', value: ionicAngularToolkitPkg ? ionicAngularToolkitPkg.version : 'not installed', path: ionicAngularToolkitPkgPath, }, { group: 'ionic', name: '@angular/cli', key: 'angular_cli_version', value: angularCLIPkg ? angularCLIPkg.version : 'not installed', path: angularCLIPkgPath, }, { group: 'ionic', name: '@angular-devkit/build-angular', value: angularDevKitBuildAngularPkg ? angularDevKitBuildAngularPkg.version : 'not installed', path: angularDevKitBuildAngularPkgPath, }, { group: 'ionic', name: '@angular-devkit/schematics', value: angularDevKitSchematicsPkg ? angularDevKitSchematicsPkg.version : 'not installed', path: angularDevKitSchematicsPkgPath, }, ]; } async detected() { try { const pkg = await this.requirePackageJson(); const deps = lodash.assign({}, pkg.dependencies, pkg.devDependencies); if (typeof deps['@ionic/angular'] === 'string') { debug(`${strong('@ionic/angular')} detected in ${strong('package.json')}`); return true; } } catch (e) { // ignore } return false; } async requireBuildRunner(): Promise { const { AngularBuildRunner } = await import('./build'); const deps = { ...this.e, project: this }; return new AngularBuildRunner(deps); } async requireServeRunner(): Promise { const { AngularServeRunner } = await import('./serve'); const deps = { ...this.e, project: this }; return new AngularServeRunner(deps); } async requireGenerateRunner(): Promise { const { AngularGenerateRunner } = await import('./generate'); const deps = { ...this.e, project: this }; return new AngularGenerateRunner(deps); } async registerAilments(registry: IAilmentRegistry): Promise { await super.registerAilments(registry); // TODO: register angular project ailments } setPrimaryTheme(themeColor: string): Promise { const themePath = path.join(this.directory, 'src', 'theme', 'variables.scss'); return this.writeThemeColor(themePath, themeColor); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/angular/serve.ts000066400000000000000000000213301425441362600275700ustar00rootroot00000000000000import { MetadataGroup, ParsedArgs, unparseArgs } from '@ionic/cli-framework'; import { str2num } from '@ionic/cli-framework/utils/string'; import { findClosestOpenPort } from '@ionic/utils-network'; import { stripAnsi } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import { AngularServeOptions, CommandLineInputs, CommandLineOptions, CommandMetadata, ServeDetails } from '../../../definitions'; import { input, strong, weak } from '../../color'; import { BIND_ALL_ADDRESS, DEFAULT_DEV_LOGGER_PORT as DEFAULT_CONSOLE_LOGS_PORT, LOCAL_ADDRESSES, SERVE_SCRIPT, ServeCLI, ServeRunner, ServeRunnerDeps } from '../../serve'; import { AngularProject } from './'; export interface AngularServeRunnerDeps extends ServeRunnerDeps { readonly project: AngularProject; } export class AngularServeRunner extends ServeRunner { constructor(protected readonly e: AngularServeRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { description: ` ${input('ionic serve')} uses the Angular CLI. Use ${input('ng serve --help')} to list all Angular CLI options for serving your app. See the ${input('ng serve')} docs[^ng-serve-docs] for explanations. Options not listed below are considered advanced and can be passed to the Angular CLI using the ${input('--')} separator after the Ionic CLI arguments. See the examples. The dev server can use HTTPS via the ${input('--ssl')} option ${chalk.bold.red('(experimental)')}. There are several known issues with HTTPS. See issue #3305[^issue-3305]. `, footnotes: [ { id: 'ng-serve-docs', url: 'https://angular.io/cli/serve', }, { id: 'issue-3305', url: 'https://github.com/ionic-team/ionic-cli/issues/3305', }, ], options: [ { name: 'consolelogs', summary: 'Print app console logs to the terminal', type: Boolean, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[ng]'), }, { name: 'consolelogs-port', summary: 'Use specific port for console logs server', type: String, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[ng]'), spec: { value: 'port' }, }, { name: 'ssl', summary: 'Use HTTPS for the dev server', type: Boolean, groups: [MetadataGroup.EXPERIMENTAL, 'cordova'], hint: weak('[ng]'), }, { name: 'prod', summary: `Flag to use the ${input('production')} configuration`, type: Boolean, groups: ['cordova'], hint: weak('[ng]'), }, { name: 'configuration', summary: 'Specify the configuration to use.', type: String, groups: [MetadataGroup.ADVANCED, 'cordova'], aliases: ['c'], hint: weak('[ng]'), spec: { value: 'conf' }, }, { name: 'source-map', summary: 'Output sourcemaps', type: Boolean, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[ng]'), }, ], exampleCommands: [ '-- --proxy-config proxy.conf.json', ], }; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): AngularServeOptions { const baseOptions = super.createOptionsFromCommandLine(inputs, options); const prod = options['prod'] ? Boolean(options['prod']) : undefined; const ssl = options['ssl'] ? Boolean(options['ssl']) : undefined; const configuration = options['configuration'] ? String(options['configuration']) : (prod ? 'production' : undefined); const project = options['project'] ? String(options['project']) : 'app'; const sourcemaps = typeof options['source-map'] === 'boolean' ? Boolean(options['source-map']) : undefined; const consolelogs = typeof options['consolelogs'] === 'boolean' ? Boolean(options['consolelogs']) : undefined; const consolelogsPort = consolelogs ? str2num(options['consolelogs-port'], DEFAULT_CONSOLE_LOGS_PORT) : undefined; return { ...baseOptions, consolelogs, consolelogsPort, ssl, configuration, project, sourcemaps, }; } platformToMode(platform: string): string { if (platform === 'ios') { return 'ios'; } return 'md'; } modifyOpenUrl(url: string, options: AngularServeOptions): string { return `${url}${options.browserOption ? options.browserOption : ''}${options.platform ? `?ionic:mode=${this.platformToMode(options.platform)}&ionic:persistConfig=true` : ''}`; } async serveProject(options: AngularServeOptions): Promise { const [ externalIP, availableInterfaces ] = await this.selectExternalIP(options); const port = options.port = await findClosestOpenPort(options.port); const ng = new AngularServeCLI(this.e); await ng.serve(options); return { custom: ng.resolvedProgram !== ng.program, protocol: options.ssl ? 'https' : 'http', localAddress: 'localhost', externalAddress: externalIP, externalNetworkInterfaces: availableInterfaces, port, externallyAccessible: ![BIND_ALL_ADDRESS, ...LOCAL_ADDRESSES].includes(externalIP), }; } getUsedPorts(options: AngularServeOptions, details: ServeDetails): number[] { return [ ...super.getUsedPorts(options, details), ...options.consolelogsPort ? [options.consolelogsPort] : [], ]; } } export class AngularServeCLI extends ServeCLI { readonly name = 'Angular CLI'; readonly pkg = '@angular/cli'; readonly program = 'ng'; readonly prefix = 'ng'; readonly script = SERVE_SCRIPT; protected chunks = 0; async serve(options: AngularServeOptions): Promise { this.on('compile', chunks => { if (chunks > 0) { this.e.log.info(`... and ${strong(chunks.toString())} additional chunks`); } }); return super.serve(options); } protected stdoutFilter(line: string): boolean { if (this.resolvedProgram !== this.program) { return super.stdoutFilter(line); } const strippedLine = stripAnsi(line); if (strippedLine.includes('Development Server is listening')) { this.emit('ready'); return false; } if (strippedLine.match(/.*chunk\s{\d+}.+/)) { this.chunks++; return false; } if (strippedLine.includes('Compiled successfully')) { this.emit('compile', this.chunks); this.chunks = 0; } return true; } protected async buildArgs(options: AngularServeOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); const args = await this.serveOptionsToNgArgs(options); if (this.resolvedProgram === this.program) { return [...this.buildArchitectCommand(options), ...args]; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script, scriptArgs: [...args] }); return pkgArgs; } } protected async serveOptionsToNgArgs(options: AngularServeOptions): Promise { const args: ParsedArgs = { _: [], host: options.host, port: options.port ? options.port.toString() : undefined, 'source-map': options.sourcemaps !== false ? options.sourcemaps : 'false', 'ssl': options.ssl !== false ? options.ssl : 'false', }; const projectArgs = []; let separatedArgs = options['--']; if (options.engine === 'cordova') { const integration = this.e.project.requireIntegration('cordova'); args.platform = options.platform; if (this.e.project.rootDirectory !== integration.root) { args.cordovaBasePath = integration.root; } separatedArgs = []; args.consolelogs = options.consolelogs ? true : undefined; args['consolelogs-port'] = options.consolelogsPort ? String(options.consolelogsPort) : undefined; } else { args['public-host'] = options.publicHost; // TODO: @ionic/angular-toolkit would need to support --public-host } if (this.resolvedProgram !== this.program) { if (options.configuration) { projectArgs.push(`--configuration=${options.configuration}`); } if (options.project) { projectArgs.push(`--project=${options.project}`); } } if (options.verbose) { projectArgs.push('--verbose'); } return [...unparseArgs(args), ...projectArgs, ...separatedArgs]; } protected buildArchitectCommand(options: AngularServeOptions): string[] { const cmd = options.engine === 'cordova' ? 'ionic-cordova-serve' : 'serve'; return ['run', `${options.project}:${cmd}${options.configuration ? `:${options.configuration}` : ''}`]; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/bare/000077500000000000000000000000001425441362600253555ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/bare/index.ts000066400000000000000000000015641425441362600270420ustar00rootroot00000000000000import { Project } from '../'; import { RunnerNotFoundException } from '../../errors'; export class BareProject extends Project { readonly type: 'bare' = 'bare'; async detected() { return false; } async requireBuildRunner(): Promise { throw new RunnerNotFoundException( `Cannot perform build for bare projects.\n` + `The Ionic CLI doesn't know how to build bare projects.` ); } async requireServeRunner(): Promise { throw new RunnerNotFoundException( `Cannot perform serve for bare projects.\n` + `The Ionic CLI doesn't know how to serve bare projects.` ); } async requireGenerateRunner(): Promise { throw new RunnerNotFoundException( `Cannot perform generate for bare projects.\n` + `The Ionic CLI doesn't know how to generate framework components for bare projects.` ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/common.ts000066400000000000000000000031471425441362600263110ustar00rootroot00000000000000import { findClosestOpenPort } from '@ionic/utils-network'; import * as Debug from 'debug'; import { input, strong } from '../color'; import { FatalException } from '../errors'; const debug = Debug('ionic:lib:project:common'); export interface Ports { port: number; livereloadPort: number; notificationPort: number; } /** * Convenience function for finding open ports of old-style projects. * * For `ionic-angular` and `ionic1`, Ionic provides the livereload server and * "dev logger" server. */ export async function findOpenIonicPorts(address: string, ports: Ports): Promise { try { const [ port, livereloadPort, notificationPort ] = await Promise.all([ findClosestOpenPort(ports.port), findClosestOpenPort(ports.livereloadPort), findClosestOpenPort(ports.notificationPort), ]); if (ports.port !== port) { debug(`Port ${strong(String(ports.port))} taken, using ${strong(String(port))}.`); ports.port = port; } if (ports.livereloadPort !== livereloadPort) { debug(`Port ${strong(String(ports.livereloadPort))} taken, using ${strong(String(livereloadPort))}.`); ports.livereloadPort = livereloadPort; } if (ports.notificationPort !== notificationPort) { debug(`Port ${strong(String(ports.notificationPort))} taken, using ${strong(String(notificationPort))}.`); ports.notificationPort = notificationPort; } return { port, livereloadPort, notificationPort }; } catch (e) { if (e.code !== 'EADDRNOTAVAIL') { throw e; } throw new FatalException(`${input(address)} is not available--cannot bind.`); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/custom/000077500000000000000000000000001425441362600257565ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/custom/build.ts000066400000000000000000000022531425441362600274270ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, CommandMetadata, CustomBuildOptions } from '../../../definitions'; import { BuildRunner, BuildRunnerDeps } from '../../build'; import { input, strong } from '../../color'; import { RunnerException } from '../../errors'; export class CustomBuildRunner extends BuildRunner { constructor(protected readonly e: BuildRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return {}; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): CustomBuildOptions { const baseOptions = super.createBaseOptionsFromCommandLine(inputs, options); return { ...baseOptions, type: 'custom', }; } async buildProject(options: CustomBuildOptions): Promise { const cli = this.getPkgManagerBuildCLI(); if (!await cli.resolveScript()) { throw new RunnerException( `Cannot perform build.\n` + `Since you're using the ${strong('custom')} project type, you must provide the ${input(cli.script)} npm script so the Ionic CLI can build your project.` ); } await cli.build(options); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/custom/index.ts000066400000000000000000000021561425441362600274410ustar00rootroot00000000000000import { Project } from '../'; import { strong } from '../../color'; import { RunnerNotFoundException } from '../../errors'; export class CustomProject extends Project { readonly type: 'custom' = 'custom'; /** * We can't detect custom project types. We don't know what they look like! */ async detected() { return false; } async requireBuildRunner(): Promise { const { CustomBuildRunner } = await import('./build'); const deps = { ...this.e, project: this }; return new CustomBuildRunner(deps); } async requireServeRunner(): Promise { const { CustomServeRunner } = await import('./serve'); const deps = { ...this.e, project: this }; return new CustomServeRunner(deps); } async requireGenerateRunner(): Promise { throw new RunnerNotFoundException( `Cannot perform generate for custom projects.\n` + `Since you're using the ${strong('custom')} project type, this command won't work. The Ionic CLI doesn't know how to generate framework components for custom projects.` ); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/custom/serve.ts000066400000000000000000000030211425441362600274460ustar00rootroot00000000000000import { findClosestOpenPort } from '@ionic/utils-network'; import { CommandMetadata, CustomServeOptions, ServeDetails } from '../../../definitions'; import { input, strong } from '../../color'; import { RunnerException } from '../../errors'; import { BIND_ALL_ADDRESS, LOCAL_ADDRESSES, ServeRunner, ServeRunnerDeps } from '../../serve'; export class CustomServeRunner extends ServeRunner { constructor(protected readonly e: ServeRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return {}; } modifyOpenUrl(url: string, options: CustomServeOptions): string { return url; } async serveProject(options: CustomServeOptions): Promise { const cli = this.getPkgManagerServeCLI(); if (!await cli.resolveScript()) { throw new RunnerException( `Cannot perform serve.\n` + `Since you're using the ${strong('custom')} project type, you must provide the ${input(cli.script)} npm script so the Ionic CLI can serve your project.` ); } const [ externalIP, availableInterfaces ] = await this.selectExternalIP(options); const port = options.port = await findClosestOpenPort(options.port); await cli.serve(options); return { custom: true, protocol: 'http', localAddress: 'localhost', externalAddress: externalIP, externalNetworkInterfaces: availableInterfaces, port, externallyAccessible: ![BIND_ALL_ADDRESS, ...LOCAL_ADDRESSES].includes(externalIP), }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/index.ts000066400000000000000000000700211425441362600261230ustar00rootroot00000000000000import { BaseConfig, BaseConfigOptions, PackageJson, ParsedArgs } from '@ionic/cli-framework'; import { PromptModule } from '@ionic/cli-framework-prompts'; import { resolveValue } from '@ionic/cli-framework/utils/fn'; import { ERROR_INVALID_PACKAGE_JSON, compileNodeModulesPaths, isValidPackageName, readPackageJsonFile } from '@ionic/cli-framework/utils/node'; import { ensureDir, findBaseDirectory, readFile, writeFile, writeJson } from '@ionic/utils-fs'; import { TTY_WIDTH, prettyPath, wordWrap } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as path from 'path'; import { PROJECT_FILE, PROJECT_TYPES } from '../../constants'; import { IAilmentRegistry, IClient, IConfig, IIntegration, ILogger, IMultiProjectConfig, IProject, IProjectConfig, ISession, IShell, InfoItem, IntegrationName, IonicContext, IonicEnvironmentFlags, ProjectIntegration, ProjectPersonalizationDetails, ProjectType } from '../../definitions'; import { isMultiProjectConfig, isProjectConfig } from '../../guards'; import { ancillary, failure, input, strong } from '../color'; import { BaseException, FatalException, IntegrationNotFoundException, RunnerNotFoundException } from '../errors'; import { BaseIntegration } from '../integrations'; import { Color } from '../utils/color'; import type { Integration as CapacitorIntegration } from '../integrations/capacitor'; import type { Integration as CordovaIntegration } from '../integrations/cordova'; import type { Integration as EnterpriseIntegration } from '../integrations/enterprise'; const debug = Debug('ionic:lib:project'); export interface ProjectDetailsResultBase { readonly type?: ProjectType; readonly errors: readonly ProjectDetailsError[]; } export interface ProjectDetailsSingleAppResult extends ProjectDetailsResultBase { readonly context: 'app'; } export interface ProjectDetailsMultiAppResult extends ProjectDetailsResultBase { readonly context: 'multiapp'; readonly id?: string; } export interface ProjectDetailsUnknownResult extends ProjectDetailsResultBase { readonly context: 'unknown'; } export type ProjectDetailsResult = (ProjectDetailsSingleAppResult | ProjectDetailsMultiAppResult | ProjectDetailsUnknownResult) & { readonly configPath: string; }; export type ProjectDetailsErrorCode = 'ERR_INVALID_PROJECT_FILE' | 'ERR_INVALID_PROJECT_TYPE' | 'ERR_MISSING_PROJECT_TYPE' | 'ERR_MULTI_MISSING_CONFIG' | 'ERR_MULTI_MISSING_ID'; export class ProjectDetailsError extends BaseException { constructor( msg: string, /** * Unique code for this error. */ readonly code: ProjectDetailsErrorCode, /** * The underlying error that caused this error. */ readonly error?: Error ) { super(msg); } } export interface ProjectDetailsDeps { readonly rootDirectory: string; readonly args?: ParsedArgs; readonly e: ProjectDeps; } export class ProjectDetails { readonly rootDirectory: string; protected readonly e: ProjectDeps; protected readonly args: ParsedArgs; constructor({ rootDirectory, args = { _: [] }, e }: ProjectDetailsDeps) { this.rootDirectory = rootDirectory; this.e = e; this.args = args; } async getIdFromArgs(): Promise { const id = this.args && this.args['project'] ? String(this.args['project']) : undefined; if (id) { debug(`Project id from args: ${strong(id)}`); return id; } } async getIdFromPathMatch(config: IMultiProjectConfig): Promise { const { ctx } = this.e; for (const [key, value] of lodash.entries(config.projects)) { const id = key; if (value && value.root) { const projectDir = path.resolve(this.rootDirectory, value.root); if (ctx.execPath.startsWith(projectDir)) { debug(`Project id from path match: ${strong(id)}`); return id; } } } } async getIdFromDefaultProject(config: IMultiProjectConfig): Promise { const id = config.defaultProject; if (id) { debug(`Project id from defaultProject: ${strong(id)}`); return id; } } async getTypeFromConfig(config: IProjectConfig): Promise { const { type } = config; if (type) { debug(`Project type from config: ${strong(prettyProjectName(type))} ${type ? strong(`(${type})`) : ''}`); return type; } } async getTypeFromDetection(): Promise { for (const projectType of PROJECT_TYPES) { const p = await createProjectFromDetails({ context: 'app', configPath: path.resolve(this.rootDirectory, PROJECT_FILE), type: projectType, errors: [] }, this.e); const type = p.type; // TODO: This is a hack to avoid accessing `this.config` within the // `Project.directory` getter, which writes config files. Object.defineProperty(p, 'directory', { value: this.rootDirectory, writable: false }); if (await p.detected()) { debug(`Project type from detection: ${strong(prettyProjectName(type))} ${type ? strong(`(${type})`) : ''}`); return type; } } } protected async determineSingleApp(config: IProjectConfig): Promise { const errors: ProjectDetailsError[] = []; let type = await resolveValue( async () => this.getTypeFromConfig(config), async () => this.getTypeFromDetection() ); if (!type) { errors.push(new ProjectDetailsError('Could not determine project type', 'ERR_MISSING_PROJECT_TYPE')); } else if (!PROJECT_TYPES.includes(type)) { errors.push(new ProjectDetailsError(`Invalid project type: ${type}`, 'ERR_INVALID_PROJECT_TYPE')); type = undefined; } return { context: 'app', type, errors }; } protected async determineMultiApp(config: IMultiProjectConfig): Promise { const errors: ProjectDetailsError[] = []; const id = await resolveValue( async () => this.getIdFromArgs(), async () => this.getIdFromPathMatch(config), async () => this.getIdFromDefaultProject(config) ); let type: ProjectType | undefined; if (id) { const app = config.projects[id]; if (app) { const r = await this.determineSingleApp(app); type = r.type; errors.push(...r.errors); } else { errors.push(new ProjectDetailsError('Could not find project in config', 'ERR_MULTI_MISSING_CONFIG')); } } else { errors.push(new ProjectDetailsError('Could not determine project id', 'ERR_MULTI_MISSING_ID')); } return { context: 'multiapp', id, type, errors }; } processResult(result: ProjectDetailsResult): void { const { log } = this.e; const errorCodes = result.errors.map(e => e.code); const e1 = result.errors.find(e => e.code === 'ERR_INVALID_PROJECT_FILE'); const e2 = result.errors.find(e => e.code === 'ERR_INVALID_PROJECT_TYPE'); if (e1) { log.error( `Error while loading config (project config: ${strong(prettyPath(result.configPath))})\n` + `${e1.error ? `${e1.message}: ${failure(e1.error.toString())}` : failure(e1.message)}. ` + `Run ${input('ionic init')} to re-initialize your Ionic project. Without a valid project config, the CLI will not have project context.` ); log.nl(); } if (result.context === 'multiapp') { if (errorCodes.includes('ERR_MULTI_MISSING_ID')) { log.warn( `Multi-app workspace detected, but cannot determine which project to use.\n` + `Please set a ${input('defaultProject')} in ${strong(prettyPath(result.configPath))} or specify the project using the global ${input('--project')} option. Read the documentation${ancillary('[1]')} for more information.\n\n` + `${ancillary('[1]')}: ${strong('https://ion.link/multi-app-docs')}` ); log.nl(); } if (result.id && errorCodes.includes('ERR_MULTI_MISSING_CONFIG')) { log.warn( `Multi-app workspace detected, but project was not found in configuration.\n` + `Project ${input(result.id)} could not be found in the workspace. Did you add it to ${strong(prettyPath(result.configPath))}?` ); } } if (errorCodes.includes('ERR_MISSING_PROJECT_TYPE')) { const listWrapOptions = { width: TTY_WIDTH - 8 - 3, indentation: 1 }; log.warn( `Could not determine project type (project config: ${strong(prettyPath(result.configPath))}).\n` + `- ${wordWrap(`For ${strong(prettyProjectName('angular'))} projects, make sure ${input('@ionic/angular')} is listed as a dependency in ${strong('package.json')}.`, listWrapOptions)}\n` + `- ${wordWrap(`For ${strong(prettyProjectName('ionic-angular'))} projects, make sure ${input('ionic-angular')} is listed as a dependency in ${strong('package.json')}.`, listWrapOptions)}\n` + `- ${wordWrap(`For ${strong(prettyProjectName('ionic1'))} projects, make sure ${input('ionic')} is listed as a dependency in ${strong('bower.json')}.`, listWrapOptions)}\n\n` + `Alternatively, set ${strong('type')} attribute in ${strong(prettyPath(result.configPath))} to one of: ${PROJECT_TYPES.map(v => input(v)).join(', ')}.\n\n` + `If the Ionic CLI does not know what type of project this is, ${input('ionic build')}, ${input('ionic serve')}, and other commands may not work. You can use the ${input('custom')} project type if that's okay.` ); log.nl(); } if (e2) { log.error( `${e2.message} (project config: ${strong(prettyPath(result.configPath))}).\n` + `Project type must be one of: ${PROJECT_TYPES.map(v => input(v)).join(', ')}` ); log.nl(); } } async readConfig(p: string): Promise<{ [key: string]: any; }> { try { let configContents = await readFile(p, { encoding: 'utf8' }); if (!configContents) { configContents = '{}\n'; await writeFile(p, configContents, { encoding: 'utf8' }); } return await JSON.parse(configContents); } catch (e) { throw new ProjectDetailsError('Could not read project file', 'ERR_INVALID_PROJECT_FILE', e); } } /** * Gather project details from specified configuration. * * This method will always resolve with a result object, with an array of * errors. Use `processResult()` to log warnings & errors. */ async result(): Promise { const errors: ProjectDetailsError[] = []; const configPath = path.resolve(this.rootDirectory, PROJECT_FILE); let config: { [key: string]: any; } | undefined; try { config = await this.readConfig(configPath); if (isProjectConfig(config)) { const r = await this.determineSingleApp(config); errors.push(...r.errors); return { ...r, configPath, errors }; } if (isMultiProjectConfig(config)) { const r = await this.determineMultiApp(config); errors.push(...r.errors); return { ...r, configPath, errors }; } throw new ProjectDetailsError('Unknown project file structure', 'ERR_INVALID_PROJECT_FILE'); } catch (e) { errors.push(e); } return { configPath, context: 'unknown', errors }; } } export async function createProjectFromDetails(details: ProjectDetailsResult, deps: ProjectDeps): Promise { const { context, type } = details; switch (type) { case 'angular': const { AngularProject } = await import('./angular'); return new AngularProject(details, deps); case 'react': const { ReactProject } = await import('./react'); return new ReactProject(details, deps); case 'vue': const { VueProject } = await import('./vue'); return new VueProject(details, deps); case 'ionic-angular': const { IonicAngularProject } = await import('./ionic-angular'); return new IonicAngularProject(details, deps); case 'ionic1': const { Ionic1Project } = await import('./ionic1'); return new Ionic1Project(details, deps); case 'custom': const { CustomProject } = await import('./custom'); return new CustomProject(details, deps); } // If we can't match any of the types above, but we've detected a multi-app // setup, it likely means this is a "bare" project, or a project without // apps. This can occur when `ionic start` is used for the first time in a // new multi-app setup. if (context === 'multiapp') { const { BareProject } = await import('./bare'); return new BareProject(details, deps); } throw new FatalException(`Bad project type: ${strong(String(type))}`); // TODO? } export async function findProjectDirectory(cwd: string): Promise { return findBaseDirectory(cwd, PROJECT_FILE); } export interface CreateProjectFromDirectoryOptions { logErrors?: boolean; } export async function createProjectFromDirectory(rootDirectory: string, args: ParsedArgs, deps: ProjectDeps, { logErrors = true }: CreateProjectFromDirectoryOptions = {}): Promise { const details = new ProjectDetails({ rootDirectory, args, e: deps }); const result = await details.result(); debug('Project details: %o', { ...result, errors: result.errors.map(e => e.code) }); if (logErrors) { details.processResult(result); } if (result.context === 'unknown') { return; } return createProjectFromDetails(result, deps); } export interface ProjectConfigOptions extends BaseConfigOptions { readonly type?: ProjectType; } export class ProjectConfig extends BaseConfig { protected readonly type?: ProjectType; constructor(p: string, { type, ...options }: ProjectConfigOptions = {}) { super(p, options); this.type = type; const c = this.c as any; if (typeof c.app_id === 'string') { // <4.0.0 project config migration if (c.app_id && !c.id) { // set `id` only if it has not been previously set and if `app_id` // isn't an empty string (which it used to be, sometimes) this.set('id', c.app_id); } this.unset('app_id' as any); } else if (typeof c.pro_id === 'string') { if (!c.id) { // set `id` only if it has not been previously set this.set('id', c.pro_id); } // we do not unset `pro_id` because it would break things } } provideDefaults(c: Partial>): IProjectConfig { return lodash.assign({ name: 'New Ionic App', integrations: {}, type: this.type, }, c); } } export class MultiProjectConfig extends BaseConfig { provideDefaults(c: Partial>): IMultiProjectConfig { return lodash.assign({ projects: {}, }, c); } } export interface ProjectDeps { readonly client: IClient; readonly config: IConfig; readonly flags: IonicEnvironmentFlags; readonly log: ILogger; readonly prompt: PromptModule; readonly session: ISession; readonly shell: IShell; readonly ctx: IonicContext; } export abstract class Project implements IProject { readonly rootDirectory: string; abstract readonly type: ProjectType; protected originalConfigFile?: { [key: string]: any }; constructor( readonly details: ProjectDetailsResult, protected readonly e: ProjectDeps ) { this.rootDirectory = path.dirname(details.configPath); } get filePath(): string { return this.details.configPath; } get directory(): string { const root = this.config.get('root'); if (!root) { return this.rootDirectory; } return path.resolve(this.rootDirectory, root); } get pathPrefix(): string[] { const id = this.details.context === 'multiapp' ? this.details.id : undefined; return id ? ['projects', id] : []; } get config(): ProjectConfig { const options = { type: this.type, pathPrefix: this.pathPrefix }; return new ProjectConfig(this.filePath, options); } abstract detected(): Promise; abstract requireBuildRunner(): Promise>; abstract requireServeRunner(): Promise>; abstract requireGenerateRunner(): Promise>; async getBuildRunner(): Promise | undefined> { try { return await this.requireBuildRunner(); } catch (e) { if (!(e instanceof RunnerNotFoundException)) { throw e; } } } async getServeRunner(): Promise | undefined> { try { return await this.requireServeRunner(); } catch (e) { if (!(e instanceof RunnerNotFoundException)) { throw e; } } } async getGenerateRunner(): Promise | undefined> { try { return await this.requireGenerateRunner(); } catch (e) { if (!(e instanceof RunnerNotFoundException)) { throw e; } } } async requireAppflowId(): Promise { const appflowId = this.config.get('id'); if (!appflowId) { throw new FatalException( `Your project file (${strong(prettyPath(this.filePath))}) does not contain '${strong('id')}'. ` + `Run ${input('ionic link')}.` ); } return appflowId; } get packageJsonPath() { return path.resolve(this.directory, 'package.json'); } async getPackageJson(pkgName?: string, { logErrors = true }: { logErrors?: boolean; } = {}): Promise<[PackageJson | undefined, string | undefined]> { let pkg: PackageJson | undefined; let pkgPath: string | undefined; try { pkgPath = pkgName ? require.resolve(`${pkgName}/package`, { paths: compileNodeModulesPaths(this.directory) }) : this.packageJsonPath; pkg = await readPackageJsonFile(pkgPath); } catch (e) { if (logErrors) { this.e.log.warn(`Error loading ${strong(pkgName ? pkgName : `project's`)} ${strong('package.json')}: ${e}`); } } return [pkg, pkgPath ? path.dirname(pkgPath) : undefined]; } async requirePackageJson(pkgName?: string): Promise { try { const pkgPath = pkgName ? require.resolve(`${pkgName}/package`, { paths: compileNodeModulesPaths(this.directory) }) : this.packageJsonPath; return await readPackageJsonFile(pkgPath); } catch (e) { if (e instanceof SyntaxError) { throw new FatalException(`Could not parse ${strong(pkgName ? pkgName : `project's`)} ${strong('package.json')}. Is it a valid JSON file?`); } else if (e === ERROR_INVALID_PACKAGE_JSON) { throw new FatalException(`The ${strong(pkgName ? pkgName : `project's`)} ${strong('package.json')} file seems malformed.`); } throw e; // Probably file not found } } async getDocsUrl(): Promise { return 'https://ion.link/docs'; } async getSourceDir(): Promise { return path.resolve(this.directory, 'src'); } async getDefaultDistDir(): Promise { return 'www'; } async getDistDir(): Promise { if (this.getIntegration('capacitor') !== undefined) { const capacitor = await this.createIntegration('capacitor'); const conf = await capacitor.getCapacitorConfig(); const webDir = conf?.webDir; if (webDir) { return path.resolve(capacitor.root, webDir); } else { throw new FatalException( `The ${input('webDir')} property must be set in the Capacitor configuration file. \n` + `See the Capacitor docs for more information: ${strong('https://capacitor.ionicframework.com/docs/basics/configuring-your-app')}` ); } } else { return path.resolve(this.directory, 'www'); } } async getInfo(): Promise { const integrations = await this.getIntegrations(); const integrationInfo = lodash.flatten(await Promise.all(integrations.map(async i => i.getInfo()))); return integrationInfo; } async personalize(details: ProjectPersonalizationDetails): Promise { const { name, projectId, description, version, themeColor, appIcon, splash } = details; this.config.set('name', name); const pkg = await this.requirePackageJson(); pkg.name = projectId; pkg.version = version ? version : '0.0.1'; pkg.description = description ? description : 'An Ionic project'; await writeJson(this.packageJsonPath, pkg, { spaces: 2 }); if (themeColor) { await this.setPrimaryTheme(themeColor); } if (appIcon && splash) { await this.setAppResources(appIcon, splash); } const integrations = await this.getIntegrations(); await Promise.all(integrations.map(async i => i.personalize(details))); } // Empty to avoid sub-classes having to implement async setPrimaryTheme(_themeColor: string): Promise { } async writeThemeColor(variablesPath: string, themeColor: string): Promise { const light = new Color(themeColor); const ionicThemeLightDarkMap = { '#3880ff': '#4c8dff', // blue '#5260ff': '#6a64ff', // purple '#2dd36f': '#2fdf75', // green '#ffc409': '#ffd534', // yellow '#eb445a': '#ff4961', // red '#f4f5f8': '#222428', // light '#92949c': '#989aa2', // medium '#222428': '#f4f5f8', // dark } as { [key: string]: string }; const matchingThemeColor = ionicThemeLightDarkMap[themeColor]; let dark; // If this is a standard Ionic theme color, then use the hard-coded dark mode // colors. Otherwise, compute a plausible dark mode color for this theme if (matchingThemeColor) { dark = new Color(matchingThemeColor); } else if (light.yiq > 128) { // Light mode was light enough, just use it for both dark = light; } else { // Light mode was too dark, so tint it to make it brighter dark = light.tint(0.6); } // Build the light colors const lightContrastRgb = light.contrast().rgb; const lightVariables: { [key: string]: string } = { '--ion-color-primary': `${themeColor}`, '--ion-color-primary-rgb': `${light.rgb.r}, ${light.rgb.g}, ${light.rgb.b}`, '--ion-color-primary-contrast': `${light.contrast().hex}`, '--ion-color-primary-contrast-rgb': `${lightContrastRgb.r}, ${lightContrastRgb.g}, ${lightContrastRgb.b}`, '--ion-color-primary-shade': `${light.shade().hex}`, '--ion-color-primary-tint': `${light.tint().hex}`, }; const darkContrastRgb = dark.contrast().rgb; const darkVariables: { [key: string]: string } = { '--ion-color-primary': `${dark.hex}`, '--ion-color-primary-rgb': `${dark.rgb.r}, ${dark.rgb.g}, ${dark.rgb.b}`, '--ion-color-primary-contrast': `${dark.contrast().hex}`, '--ion-color-primary-contrast-rgb': `${darkContrastRgb.r}, ${darkContrastRgb.g}, ${darkContrastRgb.b}`, '--ion-color-primary-shade': `${dark.shade().hex}`, '--ion-color-primary-tint': `${dark.tint().hex}`, }; try { let themeVarsContents = await readFile(variablesPath, { encoding: 'utf8' }); // Replace every theme variable with the updated ones for (const v in lightVariables) { const regExp = new RegExp(`(${v}):([^;]*)`, 'g'); let variableIndex = 0; themeVarsContents = themeVarsContents.replace(regExp, (str, match) => { if (variableIndex === 0) { variableIndex++; return `${match}: ${lightVariables[v]}`; } return str; }); } for (const v in darkVariables) { const regExp = new RegExp(`(${v}):([^;]*)`, 'g'); let variableIndex = 0; themeVarsContents = themeVarsContents.replace(regExp, (str, match) => { if (variableIndex === 1) { return `${match}: ${darkVariables[v]}`; } variableIndex++; return str; }); } await writeFile(variablesPath, themeVarsContents); } catch (e) { const { log } = this.e; log.error(`Unable to modify theme variables, theme will need to be set manually: ${e}`); } } async setAppResources(appIcon: Buffer, splash: Buffer) { const resourcesDir = path.join(this.directory, 'resources'); const iconPath = path.join(resourcesDir, 'icon.png'); const splashPath = path.join(resourcesDir, 'splash.png'); try { await ensureDir(resourcesDir); await writeFile(iconPath, appIcon); await writeFile(splashPath, splash); } catch (e) { const { log } = this.e; log.error(`Unable to find or create the resources directory. Skipping icon generation: ${e}`); } } async registerAilments(registry: IAilmentRegistry): Promise { const ailments = await import('../doctor/ailments'); const deps = { ...this.e, project: this }; registry.register(new ailments.NpmInstalledLocally(deps)); registry.register(new ailments.IonicCLIInstalledLocally(deps)); registry.register(new ailments.GitNotUsed(deps)); registry.register(new ailments.GitConfigInvalid(deps)); registry.register(new ailments.IonicNativeOldVersionInstalled(deps)); registry.register(new ailments.UnsavedCordovaPlatforms(deps)); registry.register(new ailments.DefaultCordovaBundleIdUsed(deps)); registry.register(new ailments.ViewportFitNotSet(deps)); registry.register(new ailments.CordovaPlatformsCommitted(deps)); } async createIntegration(name: 'capacitor'): Promise; async createIntegration(name: 'cordova'): Promise; async createIntegration(name: 'enterprise'): Promise; async createIntegration(name: IntegrationName): Promise; async createIntegration(name: IntegrationName): Promise { return BaseIntegration.createFromName({ client: this.e.client, config: this.e.config, log: this.e.log, project: this, prompt: this.e.prompt, session: this.e.session, shell: this.e.shell, }, name); } getIntegration(name: IntegrationName): Required | undefined { const integration = this.config.get('integrations')[name]; if (integration) { return { enabled: integration.enabled !== false, root: integration.root === undefined ? this.directory : path.resolve(this.rootDirectory, integration.root), }; } } requireIntegration(name: IntegrationName): Required { const id = this.details.context === 'multiapp' ? this.details.id : undefined; const integration = this.getIntegration(name); if (!integration) { throw new FatalException(`Could not find ${strong(name)} integration in the ${strong(id ? id : 'default')} project.`); } if (!integration.enabled) { throw new FatalException(`${strong(name)} integration is disabled in the ${strong(id ? id : 'default')} project.`); } return integration; } protected async getIntegrations(): Promise[]> { const integrationsFromConfig = this.config.get('integrations'); const names = Object.keys(integrationsFromConfig) as IntegrationName[]; // TODO const integrationNames = names.filter(n => { const c = integrationsFromConfig[n]; return c && c.enabled !== false; }); const integrations: (IIntegration | undefined)[] = await Promise.all(integrationNames.map(async name => { try { return await this.createIntegration(name); } catch (e) { if (!(e instanceof IntegrationNotFoundException)) { throw e; } this.e.log.warn(e.message); } })); return integrations.filter((i): i is IIntegration => typeof i !== 'undefined'); } } export function prettyProjectName(type?: string): string { if (!type) { return 'Unknown'; } if (type === 'angular') { return '@ionic/angular'; } else if (type === 'react') { return '@ionic/react'; } else if (type === 'vue') { return '@ionic/vue'; } else if (type === 'ionic-angular') { return 'Ionic 2/3'; } else if (type === 'ionic1') { return 'Ionic 1'; } else if (type === 'custom') { return 'Custom'; } return type; } export function isValidProjectId(projectId: string): boolean { return projectId !== '.' && isValidPackageName(projectId) && projectId === path.basename(projectId); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/000077500000000000000000000000001425441362600271745ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/__tests__/000077500000000000000000000000001425441362600311325ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/__tests__/build.ts000066400000000000000000000021071425441362600326010ustar00rootroot00000000000000import { IonicAngularBuildCLI } from '../build'; describe('@ionic/cli', () => { describe('lib/ionic-angular', () => { describe('IonicAngularBuildCLI', () => { describe('buildOptionsToAppScriptsArgs', () => { const options = { '--': ['--generateSourceMap', 'false'], prod: true, aot: true, minifyjs: true, minifycss: true, optimizejs: true, }; it('should transform defaults', async () => { const appscripts = new IonicAngularBuildCLI({} as any); const result = await (appscripts as any).buildOptionsToAppScriptsArgs({ _: [], '--': [] }); expect(result).toEqual([]); }); it('should transform options', async () => { const appscripts = new IonicAngularBuildCLI({} as any); const result = await (appscripts as any).buildOptionsToAppScriptsArgs(options); expect(result).toEqual(['--prod', '--aot', '--minifyjs', '--minifycss', '--optimizejs', '--generateSourceMap', 'false']); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/__tests__/index.ts000066400000000000000000000015431425441362600326140ustar00rootroot00000000000000import * as path from 'path' import { IonicAngularProject } from '../'; describe('@ionic/cli', () => { describe('lib/project/ionic-angular', () => { describe('IonicAngularProject', () => { let p: IonicAngularProject; beforeEach(() => { p = new IonicAngularProject({ context: 'app', configPath: '/path/to/proj/file' } as any, {} as any); jest.spyOn(p, 'config', 'get').mockImplementation(() => ({ get: () => undefined } as any)); }); it('should set directory attribute', async () => { expect(p.directory).toEqual(path.resolve('/path/to/proj')); }); describe('getSourceDir', () => { it('should default to src', async () => { const result = await p.getSourceDir(); expect(result).toEqual(path.resolve('/path/to/proj/src')); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/__tests__/serve.ts000066400000000000000000000052301425441362600326260ustar00rootroot00000000000000import { IonicAngularServeRunner } from '../serve'; describe('@ionic/cli', () => { describe('lib/project/ionic-angular/serve', () => { describe('IonicAngularServeRunner', () => { describe('createOptionsFromCommandLine', () => { const defaults = { '--': [], publicHost: undefined, host: 'localhost', browser: undefined, browserOption: undefined, consolelogs: false, engine: 'browser', env: undefined, externalAddressRequired: false, lab: false, labHost: 'localhost', labPort: 8200, livereload: true, livereloadPort: 35729, notificationPort: 53703, open: false, port: 8100, proxy: true, serverlogs: false, project: undefined, verbose: false, }; it('should provide defaults with no options', () => { const runner = new IonicAngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [] }); expect(result).toEqual(defaults); }); it('should provide options from negations of cli flag defaults', () => { const runner = new IonicAngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); expect(result).toEqual({ ...defaults, livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); }); it('should allow overrides of default values', () => { const runner = new IonicAngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], host: '0.0.0.0', port: '1111', 'livereload-port': '2222', 'dev-logger-port': '3333', env: 'prod' }); expect(result).toEqual({ ...defaults, host: '0.0.0.0', port: 1111, livereloadPort: 2222, notificationPort: 3333, env: 'prod' }); }); it('should respect --external flag', () => { const runner = new IonicAngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], host: 'localhost', external: true }); expect(result).toEqual({ ...defaults, host: '0.0.0.0' }); }); it('should pass on separated args', () => { const runner = new IonicAngularServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], '--': ['foo', '--bar'] }); expect(result).toEqual({ ...defaults, '--': ['foo', '--bar'] }); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/ailments.ts000066400000000000000000000230661425441362600313670ustar00rootroot00000000000000import * as semver from 'semver'; import { ProjectType, TreatableAilment } from '../../../definitions'; import { BUILD_SCRIPT } from '../../build'; import { ancillary, input, strong } from '../../color'; import { Ailment, AilmentDeps } from '../../doctor'; import { SERVE_SCRIPT } from '../../serve'; import { pkgFromRegistry, pkgManagerArgs } from '../../utils/npm'; import { IonicAngularProject } from './'; import { DEFAULT_BUILD_SCRIPT_VALUE } from './build'; import { DEFAULT_SERVE_SCRIPT_VALUE } from './serve'; export interface IonicAngularAilmentDeps extends AilmentDeps { readonly project: IonicAngularProject; } export abstract class IonicAngularAilment extends Ailment { readonly projects: ProjectType[] = ['ionic-angular']; protected readonly project: IonicAngularProject; constructor(deps: IonicAngularAilmentDeps) { super(deps); this.project = deps.project; } } export class IonicAngularUpdateAvailable extends IonicAngularAilment { readonly id = 'ionic-angular-update-available'; currentVersion?: string; latestVersion?: string; async getVersionPair(): Promise<[string, string]> { if (!this.currentVersion || !this.latestVersion) { const [ currentPkg ] = await this.project.getPackageJson('ionic-angular'); const latestPkg = await pkgFromRegistry(this.config.get('npmClient'), { pkg: 'ionic-angular' }); this.currentVersion = currentPkg ? currentPkg.version : undefined; this.latestVersion = latestPkg ? latestPkg.version : undefined; } if (!this.currentVersion || !this.latestVersion) { return ['0.0.0', '0.0.0']; } return [ this.currentVersion, this.latestVersion ]; } async getMessage() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); return ( `Update available for Ionic Framework.\n` + `An update is available for ${strong('ionic-angular')} (${ancillary(currentVersion)} => ${ancillary(latestVersion)}).\n` ).trim(); } async detected() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); const diff = semver.diff(currentVersion, latestVersion); return diff === 'minor' || diff === 'patch'; } async getTreatmentSteps() { const [ , latestVersion ] = await this.getVersionPair(); const args = await pkgManagerArgs(this.config.get('npmClient'), { command: 'install', pkg: `ionic-angular@${latestVersion ? latestVersion : 'latest'}` }); return [ { message: `Visit ${strong('https://github.com/ionic-team/ionic/releases')} for each upgrade's instructions` }, { message: `If no instructions, run: ${input(args.join(' '))}` }, { message: `Watch for npm warnings about peer dependencies--they may need manual updating` }, ]; } } export class IonicAngularMajorUpdateAvailable extends IonicAngularAilment { readonly id = 'ionic-angular-major-update-available'; currentVersion?: string; latestVersion?: string; async getVersionPair(): Promise<[string, string]> { if (!this.currentVersion || !this.latestVersion) { const [ currentPkg ] = await this.project.getPackageJson('ionic-angular'); const latestPkg = await pkgFromRegistry(this.config.get('npmClient'), { pkg: 'ionic-angular' }); this.currentVersion = currentPkg ? currentPkg.version : undefined; this.latestVersion = latestPkg ? latestPkg.version : undefined; } if (!this.currentVersion || !this.latestVersion) { return ['0.0.0', '0.0.0']; } return [ this.currentVersion, this.latestVersion ]; } async getMessage() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); return ( `Major update available for Ionic Framework.\n` + `A major update is available for ${strong('ionic-angular')} (${ancillary(currentVersion)} => ${ancillary(latestVersion)}).\n` ).trim(); } async detected() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); const diff = semver.diff(currentVersion, latestVersion); return diff === 'major'; } async getTreatmentSteps() { return [ { message: `Visit ${strong('https://ionicframework.com/blog')} and ${strong('https://github.com/ionic-team/ionic/releases')} for upgrade instructions` }, ]; } } export class AppScriptsUpdateAvailable extends IonicAngularAilment implements TreatableAilment { readonly id = 'app-scripts-update-available'; readonly treatable = true; currentVersion?: string; latestVersion?: string; async getVersionPair(): Promise<[string, string]> { if (!this.currentVersion || !this.latestVersion) { const [ currentPkg ] = await this.project.getPackageJson('@ionic/app-scripts'); const latestPkg = await pkgFromRegistry(this.config.get('npmClient'), { pkg: '@ionic/app-scripts' }); this.currentVersion = currentPkg ? currentPkg.version : undefined; this.latestVersion = latestPkg ? latestPkg.version : undefined; } if (!this.currentVersion || !this.latestVersion) { return ['0.0.0', '0.0.0']; } return [ this.currentVersion, this.latestVersion ]; } async getMessage() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); return ( `Update available for ${strong('@ionic/app-scripts')}.\n` + `An update is available for ${strong('@ionic/app-scripts')} (${ancillary(currentVersion)} => ${ancillary(latestVersion)}).\n` ).trim(); } async detected() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); const diff = semver.diff(currentVersion, latestVersion); return diff === 'minor' || diff === 'patch'; } async getTreatmentSteps() { const [ , latestVersion ] = await this.getVersionPair(); const [ manager, ...managerArgs ] = await pkgManagerArgs(this.config.get('npmClient'), { command: 'install', pkg: `@ionic/app-scripts@${latestVersion ? latestVersion : 'latest'}`, saveDev: true }); return [ { message: `Run: ${input(manager + ' ' + managerArgs.join(' '))}`, treat: async () => { await this.shell.run(manager, managerArgs, {}); }, }, ]; } } export class AppScriptsMajorUpdateAvailable extends IonicAngularAilment { readonly id = 'app-scripts-major-update-available'; currentVersion?: string; latestVersion?: string; async getVersionPair(): Promise<[string, string]> { if (!this.currentVersion || !this.latestVersion) { const [ currentPkg ] = await this.project.getPackageJson('@ionic/app-scripts'); const latestPkg = await pkgFromRegistry(this.config.get('npmClient'), { pkg: '@ionic/app-scripts' }); this.currentVersion = currentPkg ? currentPkg.version : undefined; this.latestVersion = latestPkg ? latestPkg.version : undefined; } if (!this.currentVersion || !this.latestVersion) { return ['0.0.0', '0.0.0']; } return [ this.currentVersion, this.latestVersion ]; } async getMessage() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); return ( `Major update available for ${strong('@ionic/app-scripts')}.\n` + `A major update is available for ${strong('@ionic/app-scripts')} (${ancillary(currentVersion)} => ${ancillary(latestVersion)}).\n` ).trim(); } async detected() { const [ currentVersion, latestVersion ] = await this.getVersionPair(); const diff = semver.diff(currentVersion, latestVersion); return diff === 'major'; } async getTreatmentSteps() { return [ { message: `Visit ${strong('https://github.com/ionic-team/ionic-app-scripts/releases')} for upgrade instructions` }, ]; } } export class IonicAngularPackageJsonHasDefaultIonicBuildCommand extends IonicAngularAilment { readonly id = 'ionic-angular-package-json-has-default-ionic-build-command'; currentVersion?: string; latestVersion?: string; async getMessage() { return ( `The ${strong(BUILD_SCRIPT)} npm script is unchanged.\n` + `The Ionic CLI now looks for the ${strong(BUILD_SCRIPT)} npm script in ${strong('package.json')} for a custom build script to run instead of the default (${input(DEFAULT_BUILD_SCRIPT_VALUE)}). If you don't use it, it's considered quicker and cleaner to just remove it.` ).trim(); } async detected() { const pkg = await this.project.requirePackageJson(); if (pkg.scripts && pkg.scripts[BUILD_SCRIPT] === DEFAULT_BUILD_SCRIPT_VALUE) { return true; } return false; } async getTreatmentSteps() { return [ { message: `Remove the ${strong(BUILD_SCRIPT)} npm script from ${strong('package.json')}` }, { message: `Continue using ${input('ionic build')} normally` }, ]; } } export class IonicAngularPackageJsonHasDefaultIonicServeCommand extends IonicAngularAilment { readonly id = 'ionic-angular-package-json-has-default-ionic-serve-command'; currentVersion?: string; latestVersion?: string; async getMessage() { return ( `The ${strong(SERVE_SCRIPT)} npm script is unchanged.\n` + `The Ionic CLI now looks for the ${strong(SERVE_SCRIPT)} npm script in ${strong('package.json')} for a custom serve script to run instead of the default (${input(DEFAULT_SERVE_SCRIPT_VALUE)}). If you don't use it, it's considered quicker and cleaner to just remove it.` ).trim(); } async detected() { const pkg = await this.project.requirePackageJson(); if (pkg.scripts && pkg.scripts[SERVE_SCRIPT] === DEFAULT_SERVE_SCRIPT_VALUE) { return true; } return false; } async getTreatmentSteps() { return [ { message: `Remove the ${strong(SERVE_SCRIPT)} npm script from ${strong('package.json')}` }, { message: `Continue using ${input('ionic serve')} normally` }, ]; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/app-scripts.ts000066400000000000000000000034071425441362600320150ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { compileNodeModulesPaths } from '@ionic/cli-framework/utils/node'; import * as Debug from 'debug'; import { CommandMetadataOption } from '../../../definitions'; import { weak } from '../../color'; const debug = Debug('ionic:lib:project:ionic-angular:app-scripts'); export async function importAppScripts(projectDir: string): Promise { const pkg = '@ionic/app-scripts'; debug('Importing %s', pkg); const p = require.resolve(pkg, { paths: compileNodeModulesPaths(projectDir) }); const m = require(p); debug('fin'); return m; } export const APP_SCRIPTS_OPTIONS: CommandMetadataOption[] = [ { name: 'prod', summary: 'Build the application for production', type: Boolean, groups: ['app-scripts', 'cordova'], hint: weak('[app-scripts]'), }, { name: 'aot', summary: 'Perform ahead-of-time compilation for this build', type: Boolean, groups: [MetadataGroup.ADVANCED, 'app-scripts', 'cordova'], hint: weak('[app-scripts]'), }, { name: 'minifyjs', summary: 'Minify JS for this build', type: Boolean, groups: [MetadataGroup.ADVANCED, 'app-scripts', 'cordova'], hint: weak('[app-scripts]'), }, { name: 'minifycss', summary: 'Minify CSS for this build', type: Boolean, groups: [MetadataGroup.ADVANCED, 'app-scripts', 'cordova'], hint: weak('[app-scripts]'), }, { name: 'optimizejs', summary: 'Perform JS optimizations for this build', type: Boolean, groups: [MetadataGroup.ADVANCED, 'app-scripts', 'cordova'], hint: weak('[app-scripts]'), }, { name: 'env', summary: '', groups: [MetadataGroup.HIDDEN, MetadataGroup.ADVANCED, 'app-scripts', 'cordova'], hint: weak('[app-scripts]'), }, ]; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/build.ts000066400000000000000000000114301425441362600306420ustar00rootroot00000000000000import { MetadataGroup, unparseArgs } from '@ionic/cli-framework'; import * as Debug from 'debug'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, IonicAngularBuildOptions } from '../../../definitions'; import { BUILD_SCRIPT, BuildCLI, BuildRunner, BuildRunnerDeps } from '../../build'; import { ancillary, input, strong, weak } from '../../color'; import { IonicAngularProject } from './'; import { APP_SCRIPTS_OPTIONS } from './app-scripts'; const debug = Debug('ionic:lib:project:ionic-angular:build'); export const DEFAULT_PROGRAM = 'ionic-app-scripts'; export const DEFAULT_BUILD_SCRIPT_VALUE = `${DEFAULT_PROGRAM} build`; export interface IonicAngularBuildRunnerDeps extends BuildRunnerDeps { readonly project: IonicAngularProject; } export class IonicAngularBuildRunner extends BuildRunner { constructor(protected readonly e: IonicAngularBuildRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { description: ` ${input('ionic build')} uses ${strong('@ionic/app-scripts')}. See the project's ${strong('README.md')}[^app-scripts-readme] for documentation. Options not listed below are considered advanced and can be passed to the ${input('ionic-app-scripts')} CLI using the ${input('--')} separator after the Ionic CLI arguments. See the examples. `, footnotes: [ { id: 'app-scripts-readme', url: 'https://github.com/ionic-team/ionic-app-scripts/blob/master/README.md', }, ], options: [ { name: 'source-map', summary: 'Output sourcemaps', type: Boolean, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[app-scripts]'), }, ...APP_SCRIPTS_OPTIONS, ], exampleCommands: [ '--prod', ], }; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): IonicAngularBuildOptions { const baseOptions = super.createBaseOptionsFromCommandLine(inputs, options); const sourcemaps = typeof options['source-map'] === 'boolean' ? Boolean(options['source-map']) : undefined; return { ...baseOptions, type: 'ionic-angular', prod: options['prod'] ? true : false, sourcemaps, aot: options['aot'] ? true : false, minifyjs: options['minifyjs'] ? true : false, minifycss: options['minifycss'] ? true : false, optimizejs: options['optimizejs'] ? true : false, env: options['env'] ? String(options['env']) : undefined, }; } async buildProject(options: IonicAngularBuildOptions): Promise { const appscripts = new IonicAngularBuildCLI(this.e); await appscripts.build(options); } } export class IonicAngularBuildCLI extends BuildCLI { readonly name = 'Ionic App Scripts'; readonly pkg = '@ionic/app-scripts'; readonly program = DEFAULT_PROGRAM; readonly prefix = 'app-scripts'; readonly script?: string = BUILD_SCRIPT; protected buildOptionsToAppScriptsArgs(options: IonicAngularBuildOptions): string[] { const minimistArgs = { _: [], prod: options.prod ? true : false, aot: options.aot ? true : false, minifyjs: options.minifyjs ? true : false, minifycss: options.minifycss ? true : false, optimizejs: options.optimizejs ? true : false, generateSourceMap: typeof options.sourcemaps !== 'undefined' ? options.sourcemaps ? 'true' : 'false' : undefined, target: options.engine === 'cordova' ? 'cordova' : undefined, platform: options.platform, env: options.env, }; return [...unparseArgs(minimistArgs, { allowCamelCase: true, useEquals: false }), ...options['--']]; } protected async buildArgs(options: IonicAngularBuildOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); const args = this.buildOptionsToAppScriptsArgs(options); if (this.resolvedProgram === this.program) { return ['build', ...args]; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script, scriptArgs: [...args] }); return pkgArgs; } } protected async resolveProgram(): Promise { if (typeof this.script !== 'undefined') { debug(`Looking for ${ancillary(this.script)} npm script.`); const pkg = await this.e.project.requirePackageJson(); if (pkg.scripts && pkg.scripts[this.script]) { if (pkg.scripts[this.script] === DEFAULT_BUILD_SCRIPT_VALUE) { debug(`Found ${ancillary(this.script)}, but it is the default. Not running.`); } else { debug(`Using ${ancillary(this.script)} npm script.`); return this.e.config.get('npmClient'); } } } return this.program; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/generate.ts000066400000000000000000000134621425441362600313440ustar00rootroot00000000000000import { contains, unparseArgs, validators } from '@ionic/cli-framework'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, IonicAngularGenerateOptions } from '../../../definitions'; import { input, strong, weak } from '../../color'; import { GenerateRunner, GenerateRunnerDeps } from '../../generate'; import { IonicAngularProject } from './'; import { importAppScripts } from './app-scripts'; const GENERATOR_TYPES = ['component', 'directive', 'page', 'pipe', 'provider', 'tabs']; export interface IonicAngularGenerateRunnerDeps extends GenerateRunnerDeps { readonly project: IonicAngularProject; } export class IonicAngularGenerateRunner extends GenerateRunner { constructor(protected readonly e: IonicAngularGenerateRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { groups: [], summary: `Generate pipes, components, pages, directives, providers, and tabs`, description: ` Automatically create components for your Ionic app. The given ${input('name')} is normalized into an appropriate naming convention. For example, ${input('ionic generate page neat')} creates a page by the name of ${input('NeatPage')} in ${input('src/pages/neat/')}. `, exampleCommands: [ '', ...GENERATOR_TYPES, 'component foo', 'page Login', 'page Detail --no-module', 'page About --constants', 'pipe MyFilterPipe', ], inputs: [ { name: 'type', summary: `The type of generator (e.g. ${GENERATOR_TYPES.map(t => input(t)).join(', ')})`, validators: [validators.required, contains(GENERATOR_TYPES, {})], }, { name: 'name', summary: 'The name of the component being generated', validators: [validators.required], }, ], options: [ { name: 'module', summary: 'Do not generate an NgModule for the page', hint: weak('[page]'), type: Boolean, default: true, }, { name: 'constants', summary: 'Generate a page constant file for lazy-loaded pages', hint: weak('[page]'), type: Boolean, default: false, }, ], }; } async ensureCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): Promise { if (!inputs[0]) { const generatorType = await this.e.prompt({ type: 'list', name: 'generatorType', message: 'What would you like to generate:', choices: GENERATOR_TYPES, }); inputs[0] = generatorType; } if (!inputs[1]) { const generatorName = await this.e.prompt({ type: 'input', name: 'generatorName', message: 'What should the name be?', validate: v => validators.required(v), }); inputs[1] = generatorName; } } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): IonicAngularGenerateOptions { const baseOptions = super.createOptionsFromCommandLine(inputs, options); return { ...baseOptions, module: options['module'] ? true : false, constants: options['constants'] ? true : false, }; } async run(options: IonicAngularGenerateOptions) { const AppScripts = await importAppScripts(this.e.project.directory); const appScriptsArgs = unparseArgs({ _: [], module: options.module, constants: options.constants }, { useEquals: false, ignoreFalse: true, allowCamelCase: true }); AppScripts.setProcessArgs(['node', 'appscripts'].concat(appScriptsArgs)); AppScripts.setCwd(this.e.project.directory); const context = AppScripts.generateContext(); switch (options.type) { case 'page': await AppScripts.processPageRequest(context, options.name, options); break; case 'component': const componentData = await this.getModules(context, 'component'); await AppScripts.processComponentRequest(context, options.name, componentData); break; case 'directive': const directiveData = await this.getModules(context, 'directive'); await AppScripts.processDirectiveRequest(context, options.name, directiveData); break; case 'pipe': const pipeData = await this.getModules(context, 'pipe'); await AppScripts.processPipeRequest(context, options.name, pipeData); break; case 'provider': const providerData = context.appNgModulePath; await AppScripts.processProviderRequest(context, options.name, providerData); break; case 'tabs': const tabsData = await this.tabsPrompt(); await AppScripts.processTabsRequest(context, options.name, tabsData, options); break; } this.e.log.ok(`Generated a ${strong(options.type)}${options.type === 'tabs' ? ' page' : ''} named ${strong(options.name)}!`); } async tabsPrompt() { const tabNames = []; const howMany = await this.e.prompt({ type: 'input', name: 'howMany', message: 'How many tabs?', validate: v => validators.numeric(v), }); for (let i = 0; i < parseInt(howMany, 10); i++) { const tabName = await this.e.prompt({ type: 'input', name: 'tabName', message: 'Name of this tab:', }); tabNames.push(tabName); } return tabNames; } async getModules(context: any, kind: string) { switch (kind) { case 'component': return context.componentsNgModulePath ? context.componentsNgModulePath : context.appNgModulePath; case 'pipe': return context.pipesNgModulePath ? context.pipesNgModulePath : context.appNgModulePath; case 'directive': return context.directivesNgModulePath ? context.directivesNgModulePath : context.appNgModulePath; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/index.ts000066400000000000000000000056251425441362600306630ustar00rootroot00000000000000import * as Debug from 'debug'; import * as lodash from 'lodash'; import { Project } from '../'; import { IAilmentRegistry, InfoItem } from '../../../definitions'; import { strong } from '../../color'; const debug = Debug('ionic:lib:project:ionic-angular'); export class IonicAngularProject extends Project { readonly type: 'ionic-angular' = 'ionic-angular'; async getInfo(): Promise { const [ [ ionicAngularPkg ], [ appScriptsPkg ], ] = await Promise.all([ this.getPackageJson('ionic-angular'), this.getPackageJson('@ionic/app-scripts'), ]); return [ ...(await super.getInfo()), { group: 'ionic', name: 'Ionic Framework', key: 'framework', value: ionicAngularPkg ? `ionic-angular ${ionicAngularPkg.version}` : 'not installed', }, { group: 'ionic', name: '@ionic/app-scripts', key: 'app_scripts_version', value: appScriptsPkg ? appScriptsPkg.version : 'not installed', }, ]; } async getDocsUrl(): Promise { return 'https://ion.link/v3-docs'; } async registerAilments(registry: IAilmentRegistry): Promise { await super.registerAilments(registry); const ailments = await import('./ailments'); const deps = { ...this.e, project: this }; registry.register(new ailments.IonicAngularUpdateAvailable(deps)); registry.register(new ailments.IonicAngularMajorUpdateAvailable(deps)); registry.register(new ailments.AppScriptsUpdateAvailable(deps)); registry.register(new ailments.AppScriptsMajorUpdateAvailable(deps)); registry.register(new ailments.IonicAngularPackageJsonHasDefaultIonicBuildCommand(deps)); registry.register(new ailments.IonicAngularPackageJsonHasDefaultIonicServeCommand(deps)); } async detected() { try { const pkg = await this.requirePackageJson(); const deps = lodash.assign({}, pkg.dependencies, pkg.devDependencies); if (typeof deps['ionic-angular'] === 'string') { debug(`${strong('ionic-angular')} detected in ${strong('package.json')}`); return true; } } catch (e) { // ignore } return false; } async requireBuildRunner(): Promise { const { IonicAngularBuildRunner } = await import('./build'); const deps = { ...this.e, project: this }; return new IonicAngularBuildRunner(deps); } async requireServeRunner(): Promise { const { IonicAngularServeRunner } = await import('./serve'); const deps = { ...this.e, project: this }; return new IonicAngularServeRunner(deps); } async requireGenerateRunner(): Promise { const { IonicAngularGenerateRunner } = await import('./generate'); const deps = { ...this.e, project: this }; return new IonicAngularGenerateRunner(deps); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic-angular/serve.ts000066400000000000000000000167121425441362600306770ustar00rootroot00000000000000import { MetadataGroup, ParsedArgs, unparseArgs } from '@ionic/cli-framework'; import { str2num } from '@ionic/cli-framework/utils/string'; import * as Debug from 'debug'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, IonicAngularServeOptions, ServeDetails } from '../../../definitions'; import { ancillary, weak } from '../../color'; import { BIND_ALL_ADDRESS, DEFAULT_DEV_LOGGER_PORT, DEFAULT_LIVERELOAD_PORT, LOCAL_ADDRESSES, SERVE_SCRIPT, ServeCLI, ServeRunner, ServeRunnerDeps } from '../../serve'; import { findOpenIonicPorts } from '../common'; import { IonicAngularProject } from './'; import { APP_SCRIPTS_OPTIONS } from './app-scripts'; const debug = Debug('ionic:lib:project:ionic-angular:serve'); const DEFAULT_PROGRAM = 'ionic-app-scripts'; export const DEFAULT_SERVE_SCRIPT_VALUE = `${DEFAULT_PROGRAM} serve`; export interface IonicAngularServeRunnerDeps extends ServeRunnerDeps { readonly project: IonicAngularProject; } export class IonicAngularServeRunner extends ServeRunner { constructor(protected readonly e: IonicAngularServeRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { options: [ { name: 'consolelogs', summary: 'Print app console logs to Ionic CLI', type: Boolean, groups: ['cordova'], aliases: ['c'], hint: weak('[app-scripts]'), }, { name: 'serverlogs', summary: 'Print dev server logs to Ionic CLI', type: Boolean, aliases: ['s'], groups: [MetadataGroup.HIDDEN, 'cordova'], hint: weak('[app-scripts]'), }, { name: 'livereload-port', summary: 'Use specific port for live-reload', default: DEFAULT_LIVERELOAD_PORT.toString(), aliases: ['r'], groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[app-scripts]'), spec: { value: 'port' }, }, { name: 'dev-logger-port', summary: 'Use specific port for dev server', default: DEFAULT_DEV_LOGGER_PORT.toString(), groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[app-scripts]'), spec: { value: 'port' }, }, { name: 'proxy', summary: 'Do not add proxies', type: Boolean, default: true, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[app-scripts]'), // TODO: Adding 'x' to aliases here has some weird behavior with minimist. }, { name: 'source-map', summary: 'Output sourcemaps', type: Boolean, groups: [MetadataGroup.ADVANCED, 'cordova'], hint: weak('[app-scripts]'), }, ...APP_SCRIPTS_OPTIONS, ], exampleCommands: [ '-c', '-- --enableLint false', ], }; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): IonicAngularServeOptions { const baseOptions = super.createOptionsFromCommandLine(inputs, options); const sourcemaps = typeof options['source-map'] === 'boolean' ? Boolean(options['source-map']) : undefined; const livereloadPort = str2num(options['livereload-port'], DEFAULT_LIVERELOAD_PORT); const notificationPort = str2num(options['dev-logger-port'], DEFAULT_DEV_LOGGER_PORT); return { ...baseOptions, sourcemaps, consolelogs: options['consolelogs'] ? true : false, serverlogs: options['serverlogs'] ? true : false, livereloadPort, notificationPort, env: options['env'] ? String(options['env']) : undefined, }; } modifyOpenUrl(url: string, options: IonicAngularServeOptions): string { return `${url}${options.browserOption ? options.browserOption : ''}${options.platform ? `?ionicplatform=${options.platform}` : ''}`; } async serveProject(options: IonicAngularServeOptions): Promise { const [ externalIP, availableInterfaces ] = await this.selectExternalIP(options); const { port, livereloadPort, notificationPort } = await findOpenIonicPorts(options.host, options); options.port = port; options.livereloadPort = livereloadPort; options.notificationPort = notificationPort; const appscripts = new IonicAngularServeCLI(this.e); await appscripts.serve(options); return { custom: appscripts.resolvedProgram !== appscripts.program, protocol: 'http', localAddress: 'localhost', externalAddress: externalIP, externalNetworkInterfaces: availableInterfaces, port, externallyAccessible: ![BIND_ALL_ADDRESS, ...LOCAL_ADDRESSES].includes(externalIP), }; } getUsedPorts(options: IonicAngularServeOptions, details: ServeDetails): number[] { return [ ...super.getUsedPorts(options, details), ...options.livereloadPort ? [options.livereloadPort] : [], ...options.notificationPort ? [options.notificationPort] : [], ]; } } class IonicAngularServeCLI extends ServeCLI { readonly name = 'Ionic App Scripts'; readonly pkg = '@ionic/app-scripts'; readonly program = DEFAULT_PROGRAM; readonly prefix = 'app-scripts'; readonly script?: string = SERVE_SCRIPT; protected stdoutFilter(line: string): boolean { if (this.resolvedProgram !== this.program) { return super.stdoutFilter(line); } if (line.includes('server running')) { this.emit('ready'); return false; } return true; } protected async buildArgs(options: IonicAngularServeOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); const args = this.serveOptionsToAppScriptsArgs(options); if (this.resolvedProgram === this.program) { return ['serve', ...args]; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script, scriptArgs: [...args] }); return pkgArgs; } } protected serveOptionsToAppScriptsArgs(options: IonicAngularServeOptions): string[] { const args: ParsedArgs = { _: [], address: options.host, port: String(options.port), 'livereload-port': String(options.livereloadPort), 'dev-logger-port': String(options.notificationPort), consolelogs: options.consolelogs, serverlogs: options.serverlogs, nobrowser: true, nolivereload: !options.livereload, noproxy: !options.proxy, iscordovaserve: options.engine === 'cordova', generateSourceMap: typeof options.sourcemaps !== 'undefined' ? options.sourcemaps ? 'true' : 'false' : undefined, platform: options.platform, target: options.engine === 'cordova' ? 'cordova' : undefined, env: options.env, }; return [...unparseArgs(args, { allowCamelCase: true, useEquals: false }), ...options['--']]; } protected async resolveProgram(): Promise { if (typeof this.script !== 'undefined') { debug(`Looking for ${ancillary(this.script)} npm script.`); const pkg = await this.e.project.requirePackageJson(); if (pkg.scripts && pkg.scripts[this.script]) { if (pkg.scripts[this.script] === DEFAULT_SERVE_SCRIPT_VALUE) { debug(`Found ${ancillary(this.script)}, but it is the default. Not running.`); } else { debug(`Using ${ancillary(this.script)} npm script.`); return this.e.config.get('npmClient'); } } } return this.program; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic1/000077500000000000000000000000001425441362600256265ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic1/__tests__/000077500000000000000000000000001425441362600275645ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic1/__tests__/index.ts000066400000000000000000000011341425441362600312420ustar00rootroot00000000000000import * as path from 'path' import { Ionic1Project } from '../'; describe('@ionic/cli', () => { describe('lib/project/ionic1', () => { describe('Ionic1Project', () => { let p: Ionic1Project; beforeEach(() => { p = new Ionic1Project({ context: 'app', configPath: '/path/to/proj/file' } as any, {} as any); jest.spyOn(p, 'config', 'get').mockImplementation(() => ({ get: () => undefined } as any)); }); it('should set directory attribute', async () => { expect(p.directory).toEqual(path.resolve('/path/to/proj')); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic1/__tests__/serve.ts000066400000000000000000000050631425441362600312640ustar00rootroot00000000000000import { Ionic1ServeRunner } from '../serve'; describe('@ionic/cli', () => { describe('lib/project/ionic1/serve', () => { describe('Ionic1ServeRunner', () => { describe('createOptionsFromCommandLine', () => { const defaults = { '--': [], publicHost: undefined, host: 'localhost', browser: undefined, browserOption: undefined, consolelogs: false, engine: 'browser', externalAddressRequired: false, lab: false, labHost: 'localhost', labPort: 8200, livereload: true, livereloadPort: 35729, notificationPort: 53703, open: false, port: 8100, proxy: true, serverlogs: false, project: undefined, verbose: false, }; it('should provide defaults with no options', () => { const runner = new Ionic1ServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [] }); expect(result).toEqual(defaults); }); it('should provide options from negations of cli flag defaults', () => { const runner = new Ionic1ServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); expect(result).toEqual({ ...defaults, livereload: false, proxy: false, lab: true, open: true, externalAddressRequired: true }); }); it('should allow overrides of default values', () => { const runner = new Ionic1ServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], host: '0.0.0.0', port: '1111', 'livereload-port': '2222', 'dev-logger-port': '3333' }); expect(result).toEqual({ ...defaults, host: '0.0.0.0', port: 1111, livereloadPort: 2222, notificationPort: 3333 }); }); it('should respect --external flag', () => { const runner = new Ionic1ServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], host: 'localhost', external: true }); expect(result).toEqual({ ...defaults, host: '0.0.0.0' }); }); it('should pass on separated args', () => { const runner = new Ionic1ServeRunner({} as any); const result = runner.createOptionsFromCommandLine([], { _: [], '--': ['foo', '--bar'] }); expect(result).toEqual({ ...defaults, '--': ['foo', '--bar'] }); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic1/build.ts000066400000000000000000000031021425441362600272710ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, CommandMetadata, Ionic1BuildOptions } from '../../../definitions'; import { BUILD_SCRIPT, BuildCLI, BuildRunner, BuildRunnerDeps } from '../../build'; import { Ionic1Project } from './'; export interface Ionic1BuildRunnerDeps extends BuildRunnerDeps { readonly project: Ionic1Project; } export class Ionic1BuildRunner extends BuildRunner { constructor(protected readonly e: Ionic1BuildRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return {}; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): Ionic1BuildOptions { const baseOptions = super.createBaseOptionsFromCommandLine(inputs, options); return { ...baseOptions, type: 'ionic1', }; } async buildProject(options: Ionic1BuildOptions): Promise { const v1 = new Ionic1BuildCLI(this.e); await v1.build(options); } } class Ionic1BuildCLI extends BuildCLI { readonly name = 'Ionic 1 Toolkit'; readonly pkg = '@ionic/v1-toolkit'; readonly program = 'ionic-v1'; readonly prefix = 'v1'; readonly script = BUILD_SCRIPT; protected async buildArgs(options: Ionic1BuildOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); if (this.resolvedProgram === this.program) { return ['build']; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script }); return pkgArgs; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic1/index.ts000066400000000000000000000107351425441362600273130ustar00rootroot00000000000000import { PackageJson } from '@ionic/cli-framework'; import { readJson } from '@ionic/utils-fs'; import { prettyPath } from '@ionic/utils-terminal'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as path from 'path'; import { Project } from '../'; import { InfoItem } from '../../../definitions'; import { strong } from '../../color'; import { FatalException, RunnerNotFoundException } from '../../errors'; const debug = Debug('ionic:lib:project:angular'); export const ERROR_INVALID_BOWER_JSON = 'INVALID_BOWER_JSON'; export interface BowerJson { name: string; dependencies?: { [key: string]: string | undefined; }; devDependencies?: { [key: string]: string | undefined; }; } function isBowerJson(obj: any): obj is BowerJson { return obj && typeof obj.name === 'string'; } async function readBowerJsonFile(p: string): Promise { const bowerJson = await readJson(p); if (!isBowerJson(bowerJson)) { throw ERROR_INVALID_BOWER_JSON; } return bowerJson; } export class Ionic1Project extends Project { readonly type: 'ionic1' = 'ionic1'; protected bowerJsonFile?: BowerJson; async getInfo(): Promise { const [ ionic1Version, [ v1ToolkitPkg ], ] = await (Promise.all([ this.getFrameworkVersion(), this.getPackageJson('@ionic/v1-toolkit'), ])); return [ ...(await super.getInfo()), { group: 'ionic', name: 'Ionic Framework', key: 'framework', value: ionic1Version ? `ionic1 ${ionic1Version}` : 'unknown', }, { group: 'ionic', name: '@ionic/v1-toolkit', value: v1ToolkitPkg ? v1ToolkitPkg.version : 'not installed', }, ]; } async detected() { try { const bwr = await readBowerJsonFile(path.resolve(this.directory, 'bower.json')); const deps = lodash.assign({}, bwr.dependencies, bwr.devDependencies); if (typeof deps['ionic'] === 'string') { debug(`${strong('ionic')} detected in ${strong('bower.json')}`); return true; } } catch (e) { // ignore } return false; } async getSourceDir(): Promise { return this.getDistDir(); // ionic1's source directory is the dist directory } async getDocsUrl(): Promise { return 'https://ion.link/v1-docs'; } // this method search not only package.json async getFrameworkVersion(): Promise { const ionicVersionFilePath = path.resolve(await this.getDistDir(), 'lib', 'ionic', 'version.json'); // TODO const bowerJsonPath = path.resolve(this.directory, 'bower.json'); try { try { const ionicVersionJson = await readJson(ionicVersionFilePath); return ionicVersionJson['version']; } catch (e) { const bwr = await this.loadBowerJson(); const deps = lodash.assign({}, bwr.dependencies, bwr.devDependencies); const ionicEntry = deps['ionic']; if (!ionicEntry) { return; } const m = ionicEntry.match(/.+#(.+)/); if (m && m[1]) { return m[1]; } } } catch (e) { this.e.log.error(`Error with ${strong(prettyPath(bowerJsonPath))} file: ${e}`); } } async loadBowerJson(): Promise { if (!this.bowerJsonFile) { const bowerJsonPath = path.resolve(this.directory, 'bower.json'); try { this.bowerJsonFile = await readBowerJsonFile(bowerJsonPath); } catch (e) { if (e instanceof SyntaxError) { throw new FatalException(`Could not parse ${strong('bower.json')}. Is it a valid JSON file?`); } else if (e === ERROR_INVALID_BOWER_JSON) { throw new FatalException(`The ${strong('bower.json')} file seems malformed.`); } throw e; // Probably file not found } } return this.bowerJsonFile; } async requireBuildRunner(): Promise { const { Ionic1BuildRunner } = await import('./build'); const deps = { ...this.e, project: this }; return new Ionic1BuildRunner(deps); } async requireServeRunner(): Promise { const { Ionic1ServeRunner } = await import('./serve'); const deps = { ...this.e, project: this }; return new Ionic1ServeRunner(deps); } async requireGenerateRunner(): Promise { throw new RunnerNotFoundException('Generators are not supported in Ionic 1 projects.'); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/ionic1/serve.ts000066400000000000000000000123061425441362600273240ustar00rootroot00000000000000import { MetadataGroup } from '@ionic/cli-framework'; import { str2num } from '@ionic/cli-framework/utils/string'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, Ionic1ServeOptions, ServeDetails } from '../../../definitions'; import { BIND_ALL_ADDRESS, DEFAULT_DEV_LOGGER_PORT, DEFAULT_LIVERELOAD_PORT, LOCAL_ADDRESSES, SERVE_SCRIPT, ServeCLI, ServeRunner, ServeRunnerDeps } from '../../serve'; import { findOpenIonicPorts } from '../common'; import { Ionic1Project } from './'; export interface Ionic1ServeRunnerDeps extends ServeRunnerDeps { readonly project: Ionic1Project; } export class Ionic1ServeRunner extends ServeRunner { constructor(protected readonly e: Ionic1ServeRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { options: [ { name: 'consolelogs', summary: 'Print app console logs to Ionic CLI', type: Boolean, groups: ['cordova'], aliases: ['c'], }, { name: 'serverlogs', summary: 'Print dev server logs to Ionic CLI', type: Boolean, aliases: ['s'], groups: [MetadataGroup.HIDDEN, 'cordova'], }, { name: 'livereload-port', summary: 'Use specific port for live-reload', default: DEFAULT_LIVERELOAD_PORT.toString(), aliases: ['r'], groups: [MetadataGroup.ADVANCED, 'cordova'], spec: { value: 'port' }, }, { name: 'dev-logger-port', summary: 'Use specific port for dev server communication', default: DEFAULT_DEV_LOGGER_PORT.toString(), groups: [MetadataGroup.ADVANCED, 'cordova'], spec: { value: 'port' }, }, { name: 'proxy', summary: 'Do not add proxies', type: Boolean, default: true, groups: [MetadataGroup.ADVANCED, 'cordova'], // TODO: Adding 'x' to aliases here has some weird behavior with minimist. }, ], exampleCommands: [ '-c', ], }; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): Ionic1ServeOptions { const baseOptions = super.createOptionsFromCommandLine(inputs, options); const livereloadPort = str2num(options['livereload-port'], DEFAULT_LIVERELOAD_PORT); const notificationPort = str2num(options['dev-logger-port'], DEFAULT_DEV_LOGGER_PORT); return { ...baseOptions, consolelogs: options['consolelogs'] ? true : false, serverlogs: options['serverlogs'] ? true : false, livereloadPort, notificationPort, }; } modifyOpenUrl(url: string, options: Ionic1ServeOptions): string { return `${url}${options.browserOption ? options.browserOption : ''}${options.platform ? `?ionicplatform=${options.platform}` : ''}`; } async serveProject(options: Ionic1ServeOptions): Promise { const [ externalIP, availableInterfaces ] = await this.selectExternalIP(options); const { port, livereloadPort, notificationPort } = await findOpenIonicPorts(options.host, options); options.port = port; options.livereloadPort = livereloadPort; options.notificationPort = notificationPort; const v1 = new Ionic1ServeCLI(this.e); await v1.serve(options); return { custom: v1.resolvedProgram !== v1.program, protocol: 'http', localAddress: 'localhost', externalAddress: externalIP, externalNetworkInterfaces: availableInterfaces, port, externallyAccessible: ![BIND_ALL_ADDRESS, ...LOCAL_ADDRESSES].includes(externalIP), }; } getUsedPorts(options: Ionic1ServeOptions, details: ServeDetails): number[] { return [ ...super.getUsedPorts(options, details), ...options.livereloadPort ? [options.livereloadPort] : [], ...options.notificationPort ? [options.notificationPort] : [], ]; } } class Ionic1ServeCLI extends ServeCLI { readonly name = 'Ionic 1 Toolkit'; readonly pkg = '@ionic/v1-toolkit'; readonly program = 'ionic-v1'; readonly prefix = 'v1'; readonly script = SERVE_SCRIPT; protected stdoutFilter(line: string): boolean { if (this.resolvedProgram !== this.program) { return super.stdoutFilter(line); } if (line.includes('server running')) { this.emit('ready'); return false; } return true; } protected async buildArgs(options: Ionic1ServeOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); const args = [ `--host=${options.host}`, `--port=${String(options.port)}`, `--livereload-port=${String(options.livereloadPort)}`, `--dev-port=${String(options.notificationPort)}`, `--engine=${options.engine}`, ]; if (options.platform) { args.push(`--platform=${options.platform}`); } if (options.consolelogs) { args.push('-c'); } if (this.resolvedProgram === this.program) { return ['serve', ...args]; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script, scriptArgs: [...args] }); return pkgArgs; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/react/000077500000000000000000000000001425441362600255425ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/react/build.ts000066400000000000000000000075341425441362600272220ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, CommandMetadata, ReactBuildOptions } from '../../../definitions'; import { BUILD_SCRIPT, BuildCLI, BuildRunner, BuildRunnerDeps } from '../../build'; import { input, weak } from '../../color'; import { ReactProject } from './'; export interface ReactBuildRunnerDeps extends BuildRunnerDeps { readonly project: ReactProject; } export class ReactBuildRunner extends BuildRunner { constructor(protected readonly e: ReactBuildRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { description: ` This command will convert options to the environment variables used by React Scripts. See the ${input('create-react-app')} docs[^cra-build-docs] for explanations. `, footnotes: [ { id: 'cra-build-docs', url: 'https://facebook.github.io/create-react-app/docs/advanced-configuration', }, ], options: [ { name: 'public-url', summary: 'The URL at which the app will be served', groups: ['cordova'], spec: { value: 'url' }, hint: weak('[react-scripts]'), }, { name: 'ci', summary: `Treat warnings as build failures, test runner does not watch`, type: Boolean, groups: ['cordova'], hint: weak('[react-scripts]'), }, { name: 'source-map', summary: 'Do not generate source maps', type: Boolean, groups: ['cordova'], default: true, hint: weak('[react-scripts]'), }, { name: 'inline-runtime-chunk', summary: `Do not include the runtime script in ${input('index.html')} (import instead)`, type: Boolean, groups: ['cordova'], default: true, hint: weak('[react-scripts]'), }, ], }; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): ReactBuildOptions { const baseOptions = super.createBaseOptionsFromCommandLine(inputs, options); const publicUrl = options['public-url'] ? String(options['public-url']) : undefined; const ci = options['ci'] ? Boolean(options['ci']) : undefined; const sourceMap = options['source-map'] ? Boolean(options['source-map']) : undefined; const inlineRuntimeChunk = options['inline-runtime-check'] ? Boolean(options['inline-runtime-check']) : undefined; return { ...baseOptions, type: 'react', publicUrl, ci, sourceMap, inlineRuntimeChunk, }; } async buildProject(options: ReactBuildOptions): Promise { const reactScripts = new ReactBuildCLI(this.e); await reactScripts.build(options); } } export class ReactBuildCLI extends BuildCLI { readonly name = 'React Scripts'; readonly pkg = 'react-scripts'; readonly program = 'react-scripts'; readonly prefix = 'react-scripts'; readonly script = BUILD_SCRIPT; protected async buildArgs(options: ReactBuildOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); if (this.resolvedProgram === this.program) { return ['build']; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script }); return pkgArgs; } } protected async buildEnvVars(options: ReactBuildOptions): Promise { const env: NodeJS.ProcessEnv = {}; if (options.publicUrl) { env.PUBLIC_URL = options.publicUrl; } if (options.ci) { env.CI = '1'; } if (!options.sourceMap) { env.GENERATE_SOURCEMAP = 'false'; } if (!options.inlineRuntimeChunk) { env.INLINE_RUNTIME_CHUNK = 'false'; } return { ...await super.buildEnvVars(options), ...env }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/react/index.ts000066400000000000000000000045341425441362600272270ustar00rootroot00000000000000import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as path from 'path'; import { Project } from '../'; import { InfoItem } from '../../../definitions'; import { RunnerNotFoundException } from '../../errors'; const debug = Debug('ionic:lib:project:React'); export class ReactProject extends Project { readonly type: 'react' = 'react'; async getInfo(): Promise { const [ [ ionicReactPkg, ionicReactPkgPath ], ] = await Promise.all([ this.getPackageJson('@ionic/react'), ]); return [ ...(await super.getInfo()), { group: 'ionic', name: 'Ionic Framework', key: 'framework', value: ionicReactPkg ? `@ionic/react ${ionicReactPkg.version}` : 'not installed', path: ionicReactPkgPath, }, ]; } /** * We can't detect React project types. We don't know what they look like! */ async detected() { try { const pkg = await this.requirePackageJson(); const deps = lodash.assign({}, pkg.dependencies, pkg.devDependencies); if (typeof deps['@ionic/React'] === 'string') { debug(`${chalk.bold('@ionic/React')} detected in ${chalk.bold('package.json')}`); return true; } } catch (e) { // ignore } return false; } async getDefaultDistDir(): Promise { return 'build'; } async requireBuildRunner(): Promise { const { ReactBuildRunner } = await import('./build'); const deps = { ...this.e, project: this }; return new ReactBuildRunner(deps); } async requireServeRunner(): Promise { const { ReactServeRunner } = await import('./serve'); const deps = { ...this.e, project: this }; return new ReactServeRunner(deps); } async requireGenerateRunner(): Promise { throw new RunnerNotFoundException( `Cannot perform generate for React projects.\n` + `Since you're using the ${chalk.bold('React')} project type, this command won't work. The Ionic CLI doesn't know how to generate framework components for React projects.` ); } setPrimaryTheme(themeColor: string): Promise { const themePath = path.join(this.directory, 'src', 'theme', 'variables.css'); return this.writeThemeColor(themePath, themeColor); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/react/serve.ts000066400000000000000000000123631425441362600272430ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions } from '@ionic/cli-framework'; import { findClosestOpenPort } from '@ionic/utils-network'; import { stripAnsi } from '@ionic/utils-terminal'; import { CommandMetadata, ReactServeOptions, ServeDetails } from '../../../definitions'; import { input, strong, weak } from '../../color'; import { BIND_ALL_ADDRESS, DEFAULT_ADDRESS, LOCAL_ADDRESSES, SERVE_SCRIPT, ServeCLI, ServeRunner, ServeRunnerDeps } from '../../serve'; export class ReactServeRunner extends ServeRunner { constructor(protected readonly e: ServeRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return { description: ` This command will convert options to the environment variables used by React Scripts. See the ${input('create-react-app')} docs[^cra-build-docs] for explanations. `, footnotes: [ { id: 'cra-build-docs', url: 'https://facebook.github.io/create-react-app/docs/advanced-configuration', }, ], options: [ { name: 'https', summary: 'Use HTTPS for the dev server', type: Boolean, groups: ['cordova'], hint: weak('[react-scripts]'), }, { name: 'react-editor', summary: `Specify the editor that opens files upon crash`, type: String, spec: { value: 'editor' }, groups: ['cordova'], hint: weak('[react-scripts]'), }, { name: 'ci', summary: `Treat warnings as build failures, test runner does not watch`, type: Boolean, groups: ['cordova'], hint: weak('[react-scripts]'), }, ], }; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): ReactServeOptions { const baseOptions = super.createOptionsFromCommandLine(inputs, options); const ci = options['ci'] ? Boolean(options['ci']) : undefined; const https = options['https'] ? Boolean(options['https']) : undefined; const reactEditor = options['react-editor'] ? String(options['react-editor']) : undefined; return { ...baseOptions, ci, https, reactEditor, }; } modifyOpenUrl(url: string, options: ReactServeOptions): string { return url; } async serveProject(options: ReactServeOptions): Promise { const [externalIP, availableInterfaces] = await this.selectExternalIP(options); const port = options.port = await findClosestOpenPort(options.port); const reactScripts = new ReactServeCLI(this.e); await reactScripts.serve(options); return { custom: reactScripts.resolvedProgram !== reactScripts.program, protocol: options.https ? 'https' : 'http', localAddress: 'localhost', externalAddress: externalIP, externalNetworkInterfaces: availableInterfaces, port, externallyAccessible: ![BIND_ALL_ADDRESS, ...LOCAL_ADDRESSES].includes(externalIP), }; } } export class ReactServeCLI extends ServeCLI { readonly name = 'React Scripts'; readonly pkg = 'react-scripts'; readonly program = 'react-scripts'; readonly prefix = 'react-scripts'; readonly script = SERVE_SCRIPT; protected chunks = 0; async serve(options: ReactServeOptions): Promise { this.on('compile', chunks => { if (chunks > 0) { this.e.log.info(`... and ${strong(chunks.toString())} additional chunks`); } }); return super.serve(options); } protected stdoutFilter(line: string): boolean { if (this.resolvedProgram !== this.program) { return super.stdoutFilter(line); } const strippedLine = stripAnsi(line); const compileMsgs = ['Compiled successfully', 'Compiled with warnings', 'Failed to compile']; if (compileMsgs.some(msg => strippedLine.includes(msg))) { this.emit('ready'); return false; } if (strippedLine.match(/.*chunk\s{\d+}.+/)) { this.chunks++; return false; } if (strippedLine.includes('Compiled successfully')) { this.emit('compile', this.chunks); this.chunks = 0; } return true; } protected async buildArgs(options: ReactServeOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); if (this.resolvedProgram === this.program) { return ['start']; } else { const [, ...pkgArgs] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script }); return pkgArgs; } } protected async buildEnvVars(options: ReactServeOptions): Promise { const env: NodeJS.ProcessEnv = {}; // Tell CRA not to open the dev server URL. We do this in Ionic CLI. env.BROWSER = 'none'; // CRA binds to `localhost` by default, but if specified it prints a // warning, so don't set `HOST` if the host is set to `localhost`. if (options.host !== DEFAULT_ADDRESS) { env.HOST = options.host; } env.PORT = String(options.port); env.HTTPS = options.https ? 'true' : 'false'; if (options.ci) { env.CI = '1'; } if (options.reactEditor) { env.REACT_EDITOR = options.reactEditor; } return { ...await super.buildEnvVars(options), ...env }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/vue/000077500000000000000000000000001425441362600252435ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/vue/build.ts000066400000000000000000000034661425441362600267230ustar00rootroot00000000000000import { CommandLineInputs, CommandLineOptions, CommandMetadata, VueBuildOptions } from '../../../definitions'; import { BUILD_SCRIPT, BuildCLI, BuildRunner, BuildRunnerDeps } from '../../build'; import { VueProject } from './'; export interface VueBuildRunnerDeps extends BuildRunnerDeps { readonly project: VueProject; } export class VueBuildRunner extends BuildRunner { constructor(protected readonly e: VueBuildRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return {}; } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): VueBuildOptions { const baseOptions = super.createBaseOptionsFromCommandLine(inputs, options); return { ...baseOptions, type: 'vue', }; } async buildProject(options: VueBuildOptions): Promise { const vueScripts = new VueBuildCLI(this.e); await vueScripts.build(options); } } export class VueBuildCLI extends BuildCLI { readonly name = 'Vue CLI Service'; readonly pkg = '@vue/cli-service'; readonly program = 'vue-cli-service'; readonly prefix = 'vue-cli-service'; readonly script = BUILD_SCRIPT; protected async buildArgs(options: VueBuildOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); if (this.resolvedProgram === this.program) { return ['build', ...(options['--'] || [])]; } else { const [ , ...pkgArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script, scriptArgs: options['--'] }); return pkgArgs; } } protected async buildEnvVars(options: VueBuildOptions): Promise { const env: NodeJS.ProcessEnv = {}; return { ...await super.buildEnvVars(options), ...env }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/vue/index.ts000066400000000000000000000044531425441362600267300ustar00rootroot00000000000000import * as chalk from 'chalk'; import * as Debug from 'debug'; import * as lodash from 'lodash'; import * as path from 'path'; import { Project } from '../'; import { InfoItem } from '../../../definitions'; import { RunnerNotFoundException } from '../../errors'; const debug = Debug('ionic:lib:project:vue'); export class VueProject extends Project { readonly type: 'vue' = 'vue'; async getInfo(): Promise { const [ [ionicVuePkg, ionicVuePkgPath], ] = await Promise.all([ this.getPackageJson('@ionic/vue'), ]); return [ ...(await super.getInfo()), { group: 'ionic', name: 'Ionic Framework', key: 'framework', value: ionicVuePkg ? `@ionic/vue ${ionicVuePkg.version}` : 'not installed', path: ionicVuePkgPath, }, ]; } /** * We can't detect Vue project types. We don't know what they look like! */ async detected() { try { const pkg = await this.requirePackageJson(); const deps = lodash.assign({}, pkg.dependencies, pkg.devDependencies); if (typeof deps['@ionic/vue'] === 'string') { debug(`${chalk.bold('@ionic/vue')} detected in ${chalk.bold('package.json')}`); return true; } } catch (e) { // ignore } return false; } async getDefaultDistDir(): Promise { return 'dist'; } async requireBuildRunner(): Promise { const { VueBuildRunner } = await import('./build'); const deps = { ...this.e, project: this }; return new VueBuildRunner(deps); } async requireServeRunner(): Promise { const { VueServeRunner } = await import('./serve'); const deps = { ...this.e, project: this }; return new VueServeRunner(deps); } async requireGenerateRunner(): Promise { throw new RunnerNotFoundException( `Cannot perform generate for Vue projects.\n` + `Since you're using the ${chalk.bold('Vue')} project type, this command won't work. The Ionic CLI doesn't know how to generate framework components for Vue projects.` ); } setPrimaryTheme(themeColor: string): Promise { const themePath = path.join(this.directory, 'src', 'theme', 'variables.css'); return this.writeThemeColor(themePath, themeColor); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/project/vue/serve.ts000066400000000000000000000076411425441362600267470ustar00rootroot00000000000000import { stripAnsi } from '@ionic/cli-framework-output'; import { findClosestOpenPort } from '@ionic/utils-network'; import { CommandMetadata, ServeDetails, VueServeOptions } from '../../../definitions'; import { strong } from '../../color'; import { BIND_ALL_ADDRESS, DEFAULT_ADDRESS, LOCAL_ADDRESSES, SERVE_SCRIPT, ServeCLI, ServeRunner, ServeRunnerDeps } from '../../serve'; export class VueServeRunner extends ServeRunner { constructor(protected readonly e: ServeRunnerDeps) { super(); } async getCommandMetadata(): Promise> { return {}; } modifyOpenUrl(url: string, _options: VueServeOptions): string { return url; } async serveProject(options: VueServeOptions): Promise { const [externalIP, availableInterfaces] = await this.selectExternalIP(options); const port = options.port = await findClosestOpenPort(options.port); const vueScripts = new VueServeCLI(this.e); await vueScripts.serve(options); return { custom: vueScripts.resolvedProgram !== vueScripts.program, protocol: options.https ? 'https' : 'http', localAddress: 'localhost', externalAddress: externalIP, externalNetworkInterfaces: availableInterfaces, port, externallyAccessible: ![BIND_ALL_ADDRESS, ...LOCAL_ADDRESSES].includes(externalIP), }; } } export class VueServeCLI extends ServeCLI { readonly name = 'Vue CLI Service'; readonly pkg = '@vue/cli-service'; readonly program = 'vue-cli-service'; readonly prefix = 'vue-cli-service'; readonly script = SERVE_SCRIPT; protected chunks = 0; async serve(options: VueServeOptions): Promise { this.on('compile', chunks => { if (chunks > 0) { this.e.log.info(`... and ${strong(chunks.toString())} additional chunks`); } }); return super.serve(options); } protected stdoutFilter(line: string): boolean { if (this.resolvedProgram !== this.program) { return super.stdoutFilter(line); } const strippedLine = stripAnsi(line); const compileMsgs = ['Compiled successfully', 'Compiled with warnings', 'Failed to compile']; if (compileMsgs.some(msg => strippedLine.includes(msg))) { this.emit('ready'); return false; } if (strippedLine.match(/.*chunk\s{\d+}.+/)) { this.chunks++; return false; } if (strippedLine.includes('Compiled successfully')) { this.emit('compile', this.chunks); this.chunks = 0; } // const endBannerMsgs = ['development build', 'production build'] // if (endBannerMsgs.some(msg => strippedLine.includes(msg))) { // return false; // } return true; } protected stderrFilter(line: string): boolean { if (this.resolvedProgram !== this.program) { return super.stderrFilter(line); } const strippedLine = stripAnsi(line); if (strippedLine.includes('webpack.Progress')) { return false; } return true; } protected async buildArgs(_options: VueServeOptions): Promise { const { pkgManagerArgs } = await import('../../utils/npm'); const separatedArgs = _options['--'] if (this.resolvedProgram === this.program) { return ['serve', ...separatedArgs]; } else { const [, ...pkgArgs] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'run', script: this.script, scriptArgs: separatedArgs }); return pkgArgs; } } protected async buildEnvVars(options: VueServeOptions): Promise { const env: NodeJS.ProcessEnv = {}; // // Vue CLI binds to `localhost` by default, but if specified it prints a // // warning, so don't set `HOST` if the host is set to `localhost`. if (options.host !== DEFAULT_ADDRESS) { env.HOST = options.host; } env.PORT = String(options.port); env.HTTPS = options.https ? 'true' : 'false'; return { ...await super.buildEnvVars(options), ...env }; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/prompts.ts000066400000000000000000000014071425441362600250540ustar00rootroot00000000000000import { PromptQuestion, PromptValue } from '@ionic/cli-framework-prompts'; import { ILogger, IonicEnvironmentFlags } from '../definitions'; import { ancillary, input, weak } from './color'; export interface CreateOnFallbackOptions { readonly flags: IonicEnvironmentFlags; readonly log: ILogger; } export function createOnFallback({ flags: { confirm }, log }: CreateOnFallbackOptions) { return (question: PromptQuestion): PromptValue | void => { if (question.type === 'confirm') { if (confirm) { log.msg(`${input('--confirm')}: ${weak(question.message)} ${ancillary('Yes')}`); return true; } else { log.msg(`${input('--no-confirm')}: ${weak(question.message)} ${ancillary('No')}`); return false; } } }; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/security.ts000066400000000000000000000017041425441362600252170ustar00rootroot00000000000000import { IClient, ResourceClientLoad, SecurityProfile } from '../definitions'; import { isSecurityProfileResponse } from '../guards'; import { ResourceClient, createFatalAPIFormat } from './http'; export interface SecurityClientDeps { readonly client: IClient; readonly token: string; } export class SecurityClient extends ResourceClient implements ResourceClientLoad { protected readonly client: IClient; protected readonly token: string; constructor({ client, token }: SecurityClientDeps) { super(); this.client = client; this.token = token; } async load(tag: string): Promise { const { req } = await this.client.make('GET', `/security/profiles/${tag}`); this.applyAuthentication(req, this.token); req.query({}).send(); const res = await this.client.do(req); if (!isSecurityProfileResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/serve.ts000066400000000000000000000541751425441362600245060ustar00rootroot00000000000000import { BaseError, MetadataGroup, ParsedArgs, unparseArgs } from '@ionic/cli-framework'; import { LOGGER_LEVELS, createPrefixedFormatter } from '@ionic/cli-framework-output'; import { PromptModule } from '@ionic/cli-framework-prompts'; import { str2num } from '@ionic/cli-framework/utils/string'; import { NetworkInterface, findClosestOpenPort, getExternalIPv4Interfaces, isHostConnectable } from '@ionic/utils-network'; import { createProcessEnv, killProcessTree, onBeforeExit, processExit } from '@ionic/utils-process'; import * as chalk from 'chalk'; import * as Debug from 'debug'; import { EventEmitter } from 'events'; import * as lodash from 'lodash'; import * as split2 from 'split2'; import * as stream from 'stream'; import { CommandLineInputs, CommandLineOptions, CommandMetadata, CommandMetadataOption, IConfig, ILogger, IProject, IShell, IonicEnvironmentFlags, LabServeDetails, NpmClient, Runner, ServeDetails, ServeOptions } from '../definitions'; import { ancillary, input, strong, weak } from './color'; import { FatalException, ServeCLIProgramNotFoundException } from './errors'; import { emit } from './events'; import { Hook } from './hooks'; import { openUrl } from './open'; import { createDefaultLoggerHandlers } from './utils/logger'; const debug = Debug('ionic:lib:serve'); export const DEFAULT_DEV_LOGGER_PORT = 53703; export const DEFAULT_LIVERELOAD_PORT = 35729; export const DEFAULT_SERVER_PORT = 8100; export const DEFAULT_LAB_PORT = 8200; export const DEFAULT_DEVAPP_COMM_PORT = 53233; export const DEFAULT_ADDRESS = 'localhost'; export const BIND_ALL_ADDRESS = '0.0.0.0'; export const LOCAL_ADDRESSES = ['localhost', '127.0.0.1']; export const BROWSERS = ['safari', 'firefox', process.platform === 'win32' ? 'chrome' : (process.platform === 'darwin' ? 'google chrome' : 'google-chrome')]; // npm script name export const SERVE_SCRIPT = 'ionic:serve'; export const COMMON_SERVE_COMMAND_OPTIONS: readonly CommandMetadataOption[] = [ { name: 'external', summary: `Host dev server on all network interfaces (i.e. ${input('--host=0.0.0.0')})`, type: Boolean, }, { name: 'address', // keep this here so the option is parsed with its value summary: '', groups: [MetadataGroup.HIDDEN], }, { name: 'host', summary: 'Use specific host for the dev server', default: DEFAULT_ADDRESS, groups: [MetadataGroup.ADVANCED], }, { name: 'port', summary: 'Use specific port for the dev server', default: DEFAULT_SERVER_PORT.toString(), aliases: ['p'], groups: [MetadataGroup.ADVANCED], }, { name: 'public-host', summary: 'The host used for the browser or web view', groups: [MetadataGroup.ADVANCED], spec: { value: 'host' }, }, { name: 'livereload', summary: 'Do not spin up dev server--just serve files', type: Boolean, default: true, }, { name: 'engine', summary: `Target engine (e.g. ${['browser', 'cordova'].map(e => input(e)).join(', ')})`, groups: [MetadataGroup.HIDDEN, MetadataGroup.ADVANCED], }, { name: 'platform', summary: `Target platform on chosen engine (e.g. ${['ios', 'android'].map(e => input(e)).join(', ')})`, groups: [MetadataGroup.HIDDEN, MetadataGroup.ADVANCED], }, ]; export interface ServeRunnerDeps { readonly config: IConfig; readonly flags: IonicEnvironmentFlags; readonly log: ILogger; readonly project: IProject; readonly prompt: PromptModule; readonly shell: IShell; } export abstract class ServeRunner implements Runner { protected devAppConnectionMade = false; protected abstract readonly e: ServeRunnerDeps; abstract getCommandMetadata(): Promise>; abstract serveProject(options: T): Promise; abstract modifyOpenUrl(url: string, options: T): string; getPkgManagerServeCLI(): PkgManagerServeCLI { const pkgManagerCLIs = { npm: NpmServeCLI, pnpm: PnpmServeCLI, yarn: YarnServeCLI, }; const client = this.e.config.get('npmClient'); const CLI = pkgManagerCLIs[client]; if (CLI) { return new CLI(this.e); } throw new ServeCLIProgramNotFoundException('Unknown CLI client: ' + client); } createOptionsFromCommandLine(inputs: CommandLineInputs, options: CommandLineOptions): ServeOptions { const separatedArgs = options['--']; if (options['external'] && options['host'] === DEFAULT_ADDRESS) { options['host'] = '0.0.0.0'; } if (options['address'] && options['host'] === DEFAULT_ADDRESS) { this.e.log.warn( `The ${input('--address')} option is deprecated in favor of ${input('--host')}.\n` + `Please use the ${input('--host')} option (e.g. ${input(`--host=${options['address']}`)}) to specify the host of the dev server.\n` ); options['host'] = options['address']; } const engine = this.determineEngineFromCommandLine(options); const host = options['host'] ? String(options['host']) : DEFAULT_ADDRESS; const labPort = str2num(options['lab-port'], DEFAULT_LAB_PORT); const port = str2num(options['port'], DEFAULT_SERVER_PORT); const [ platform ] = options['platform'] ? [String(options['platform'])] : inputs; return { '--': separatedArgs ? separatedArgs : [], host, browser: options['browser'] ? String(options['browser']) : undefined, browserOption: options['browseroption'] ? String(options['browseroption']) : undefined, engine, externalAddressRequired: !!options['externalAddressRequired'], lab: !!options['lab'], labHost: options['lab-host'] ? String(options['lab-host']) : 'localhost', labPort, livereload: typeof options['livereload'] === 'boolean' ? Boolean(options['livereload']) : true, open: !!options['open'], platform, port, proxy: typeof options['proxy'] === 'boolean' ? Boolean(options['proxy']) : true, project: options['project'] ? String(options['project']) : undefined, publicHost: options['public-host'] ? String(options['public-host']) : undefined, verbose: !!options['verbose'], }; } determineEngineFromCommandLine(options: CommandLineOptions): string { if (options['engine']) { return String(options['engine']); } if (options['cordova']) { return 'cordova'; } return 'browser'; } async beforeServe(options: T) { const hook = new ServeBeforeHook(this.e); try { await hook.run({ name: hook.name, serve: options }); } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } async run(options: T): Promise { debug('serve options: %O', options); await this.beforeServe(options); const details = await this.serveProject(options); const labDetails = options.lab ? await this.runLab(options, details) : undefined; const localAddress = `${details.protocol}://${options.publicHost ? options.publicHost : 'localhost'}:${details.port}`; const fmtExternalAddress = (host: string) => `${details.protocol}://${host}:${details.port}`; const labHost = labDetails ? `http://${labDetails.host}:${labDetails.port}` : undefined; this.e.log.nl(); this.e.log.info( `Development server running!` + (labHost ? `\nLab: ${strong(labHost)}` : '') + `\nLocal: ${strong(localAddress)}` + (details.externalNetworkInterfaces.length > 0 ? `\nExternal: ${details.externalNetworkInterfaces.map(v => strong(fmtExternalAddress(v.address))).join(', ')}` : '') + `\n\n${chalk.yellow('Use Ctrl+C to quit this process')}` ); this.e.log.nl(); if (options.open) { const openAddress = labHost ? labHost : localAddress; const url = this.modifyOpenUrl(openAddress, options); await openUrl(url, { app: options.browser }); this.e.log.info(`Browser window opened to ${strong(url)}!`); this.e.log.nl(); } emit('serve:ready', details); debug('serve details: %O', details); this.scheduleAfterServe(options, details); return details; } async afterServe(options: T, details: ServeDetails) { const hook = new ServeAfterHook(this.e); try { await hook.run({ name: hook.name, serve: lodash.assign({}, options, details) }); } catch (e) { if (e instanceof BaseError) { throw new FatalException(e.message); } throw e; } } scheduleAfterServe(options: T, details: ServeDetails) { onBeforeExit(async () => this.afterServe(options, details)); } getUsedPorts(options: T, details: ServeDetails): number[] { return [details.port]; } async runLab(options: T, serveDetails: ServeDetails): Promise { const labDetails: LabServeDetails = { projectType: this.e.project.type, host: options.labHost, port: await findClosestOpenPort(options.labPort), }; const lab = new IonicLabServeCLI(this.e); await lab.serve({ serveDetails, ...labDetails }); return labDetails; } async selectExternalIP(options: T): Promise<[string, NetworkInterface[]]> { let availableInterfaces: NetworkInterface[] = []; let chosenIP = options.host; if (options.host === BIND_ALL_ADDRESS) { // ignore link-local addresses availableInterfaces = getExternalIPv4Interfaces().filter(i => !i.address.startsWith('169.254')); if (options.publicHost) { chosenIP = options.publicHost; } else { if (availableInterfaces.length === 0) { if (options.externalAddressRequired) { throw new FatalException( `No external network interfaces detected. In order to use the dev server externally you will need one.\n` + `Are you connected to a local network?\n` ); } } else if (availableInterfaces.length === 1) { chosenIP = availableInterfaces[0].address; } else if (availableInterfaces.length > 1) { if (options.externalAddressRequired) { if (this.e.flags.interactive) { this.e.log.warn( 'Multiple network interfaces detected!\n' + `You will be prompted to select an external-facing IP for the dev server that your device or emulator can access. Make sure your device is on the same Wi-Fi network as your computer. Learn more about Live Reload in the docs${ancillary('[1]')}.\n\n` + `To bypass this prompt, use the ${input('--public-host')} option (e.g. ${input(`--public-host=${availableInterfaces[0].address}`)}). You can alternatively bind the dev server to a specific IP (e.g. ${input(`--host=${availableInterfaces[0].address}`)}).\n\n` + `${ancillary('[1]')}: ${strong('https://ion.link/livereload-docs')}\n` ); const promptedIp = await this.e.prompt({ type: 'list', name: 'promptedIp', message: 'Please select which IP to use:', choices: availableInterfaces.map(i => ({ name: `${i.address} ${weak(`(${i.device})`)}`, value: i.address, })), }); chosenIP = promptedIp; } else { throw new FatalException( `Multiple network interfaces detected!\n` + `You must select an external-facing IP for the dev server that your device or emulator can access with the ${input('--public-host')} option.` ); } } } } } else if (options.externalAddressRequired && LOCAL_ADDRESSES.includes(options.host)) { this.e.log.warn( 'An external host may be required to serve for this target device/platform.\n' + 'If you get connection issues on your device or emulator, try connecting the device to the same Wi-Fi network and selecting an accessible IP address for your computer on that network.\n\n' + `You can use ${input('--external')} to run the dev server on all network interfaces, in which case an external address will be selected.\n` ); } return [ chosenIP, availableInterfaces ]; } } class ServeBeforeHook extends Hook { readonly name = 'serve:before'; } class ServeAfterHook extends Hook { readonly name = 'serve:after'; } export interface ServeCLIOptions { readonly host: string; readonly port: number; } export interface ServeCLI { emit(event: 'compile', chunks: number): boolean; emit(event: 'ready'): boolean; on(event: 'compile', handler: (chunks: number) => void): this; on(event: 'ready', handler: () => void): this; once(event: 'compile', handler: (chunks: number) => void): this; once(event: 'ready', handler: () => void): this; } export abstract class ServeCLI extends EventEmitter { /** * The pretty name of this Serve CLI. */ abstract readonly name: string; /** * The npm package of this Serve CLI. */ abstract readonly pkg: string; /** * The bin program to use for this Serve CLI. */ abstract readonly program: string; /** * The prefix to use for log statements. */ abstract readonly prefix: string; /** * If specified, `package.json` is inspected for this script to use instead * of `program`. */ abstract readonly script?: string; /** * If true, the Serve CLI will not prompt to be installed. */ readonly global: boolean = false; private _resolvedProgram?: string; constructor(protected readonly e: ServeRunnerDeps) { super(); } get resolvedProgram() { if (this._resolvedProgram) { return this._resolvedProgram; } return this.program; } /** * Build the arguments for starting this Serve CLI. Called by `this.start()`. */ protected abstract buildArgs(options: T): Promise; /** * Build the environment variables to be passed to the Serve CLI. Called by `this.start()`; */ protected async buildEnvVars(options: T): Promise { return process.env; } /** * Called whenever a line of stdout is received. * * If `false` is returned, the line is not emitted to the log. * * By default, the CLI is considered ready whenever stdout is emitted. This * method should be overridden to more accurately portray readiness. * * @param line A line of stdout. */ protected stdoutFilter(line: string): boolean { this.emit('ready'); return true; } /** * Called whenever a line of stderr is received. * * If `false` is returned, the line is not emitted to the log. */ protected stderrFilter(line: string): boolean { return true; } async resolveScript(): Promise { if (typeof this.script === 'undefined') { return; } const [ pkg ] = await this.e.project.getPackageJson(undefined, { logErrors: false }); if (!pkg) { return; } return pkg.scripts && pkg.scripts[this.script]; } async serve(options: T): Promise { this._resolvedProgram = await this.resolveProgram(); await this.spawnWrapper(options); const interval = setInterval(() => { this.e.log.info(`Waiting for connectivity with ${input(this.resolvedProgram)}...`); }, 5000); debug('awaiting TCP connection to %s:%d', options.host, options.port); await isHostConnectable(options.host, options.port); clearInterval(interval); } protected async spawnWrapper(options: T): Promise { try { return await this.spawn(options); } catch (e) { if (!(e instanceof ServeCLIProgramNotFoundException)) { throw e; } if (this.global) { this.e.log.nl(); throw new FatalException(`${input(this.pkg)} is required for this command to work properly.`); } this.e.log.nl(); this.e.log.info( `Looks like ${input(this.pkg)} isn't installed in this project.\n` + `This package is required for this command to work properly. The package provides a CLI utility, but the ${input(this.resolvedProgram)} binary was not found in your PATH.` ); const installed = await this.promptToInstall(); if (!installed) { this.e.log.nl(); throw new FatalException(`${input(this.pkg)} is required for this command to work properly.`); } return this.spawn(options); } } protected async spawn(options: T): Promise { const args = await this.buildArgs(options); const env = await this.buildEnvVars(options); const p = await this.e.shell.spawn(this.resolvedProgram, args, { stdio: ['inherit', 'pipe', 'pipe'], cwd: this.e.project.directory, env: createProcessEnv(env) }); return new Promise((resolve, reject) => { const errorHandler = (err: NodeJS.ErrnoException) => { debug('received error for %s: %o', this.resolvedProgram, err); if (this.resolvedProgram === this.program && err.code === 'ENOENT') { p.removeListener('close', closeHandler); // do not exit Ionic CLI, we can gracefully ask to install this CLI reject(new ServeCLIProgramNotFoundException(`${strong(this.resolvedProgram)} command not found.`)); } else { reject(err); } }; const closeHandler = (code: number | null) => { if (code !== null) { debug('received unexpected close for %s (code: %d)', this.resolvedProgram, code); this.e.log.nl(); this.e.log.error( `${input(this.resolvedProgram)} has unexpectedly closed (exit code ${code}).\n` + 'The Ionic CLI will exit. Please check any output above for error details.' ); processExit(1); } }; p.on('error', errorHandler); p.on('close', closeHandler); onBeforeExit(async () => { p.removeListener('close', closeHandler); if (p.pid) { await killProcessTree(p.pid); } }); const ws = this.createLoggerStream(); p.stdout.pipe(split2()).pipe(this.createStreamFilter(line => this.stdoutFilter(line))).pipe(ws); p.stderr.pipe(split2()).pipe(this.createStreamFilter(line => this.stderrFilter(line))).pipe(ws); this.once('ready', () => { resolve(); }); }); } protected createLoggerStream(): NodeJS.WritableStream { const log = this.e.log.clone(); log.handlers = createDefaultLoggerHandlers(createPrefixedFormatter(weak(`[${this.resolvedProgram === this.program ? this.prefix : this.resolvedProgram}]`))); return log.createWriteStream(LOGGER_LEVELS.INFO); } protected async resolveProgram(): Promise { if (typeof this.script !== 'undefined') { debug(`Looking for ${ancillary(this.script)} npm script.`); if (await this.resolveScript()) { debug(`Using ${ancillary(this.script)} npm script.`); return this.e.config.get('npmClient'); } } return this.program; } protected createStreamFilter(filter: (line: string) => boolean): stream.Transform { return new stream.Transform({ transform(chunk, enc, callback) { const str = chunk.toString(); if (filter(str)) { this.push(chunk); } callback(); }, }); } protected async promptToInstall(): Promise { const { pkgManagerArgs } = await import('./utils/npm'); const [ manager, ...managerArgs ] = await pkgManagerArgs(this.e.config.get('npmClient'), { command: 'install', pkg: this.pkg, saveDev: true, saveExact: true }); this.e.log.nl(); const confirm = await this.e.prompt({ name: 'confirm', message: `Install ${input(this.pkg)}?`, type: 'confirm', }); if (!confirm) { this.e.log.warn(`Not installing--here's how to install manually: ${input(`${manager} ${managerArgs.join(' ')}`)}`); return false; } await this.e.shell.run(manager, managerArgs, { cwd: this.e.project.directory }); return true; } } abstract class PkgManagerServeCLI extends ServeCLI { readonly abstract program: NpmClient; readonly global = true; readonly script = SERVE_SCRIPT; protected async resolveProgram(): Promise { return this.program; } protected async buildArgs(options: ServeOptions): Promise { const { pkgManagerArgs } = await import('./utils/npm'); // The Ionic CLI decides the host/port of the dev server, so --host and // --port are provided to the downstream npm script as a best-effort // attempt. const args: ParsedArgs = { _: [], host: options.host, port: options.port.toString(), }; const scriptArgs = [...unparseArgs(args), ...options['--'] || []]; const [ , ...pkgArgs ] = await pkgManagerArgs(this.program, { command: 'run', script: this.script, scriptArgs }); return pkgArgs; } } export class NpmServeCLI extends PkgManagerServeCLI { readonly name = 'npm CLI'; readonly pkg = 'npm'; readonly program = 'npm'; readonly prefix = 'npm'; } export class PnpmServeCLI extends PkgManagerServeCLI { readonly name = 'pnpm CLI'; readonly pkg = 'pnpm'; readonly program = 'pnpm'; readonly prefix = 'pnpm'; } export class YarnServeCLI extends PkgManagerServeCLI { readonly name = 'Yarn'; readonly pkg = 'yarn'; readonly program = 'yarn'; readonly prefix = 'yarn'; } interface IonicLabServeCLIOptions extends Readonly { readonly serveDetails: Readonly; } class IonicLabServeCLI extends ServeCLI { readonly name = 'Ionic Lab'; readonly pkg = '@ionic/lab'; readonly program = 'ionic-lab'; readonly prefix = 'lab'; readonly script = undefined; protected stdoutFilter(line: string): boolean { if (line.includes('running')) { this.emit('ready'); } return false; // no stdout } protected async buildArgs(options: IonicLabServeCLIOptions): Promise { const { serveDetails, ...labDetails } = options; const pkg = await this.e.project.requirePackageJson(); const url = `${serveDetails.protocol}://localhost:${serveDetails.port}`; const appName = this.e.project.config.get('name'); const labArgs = [url, '--host', labDetails.host, '--port', String(labDetails.port), '--project-type', labDetails.projectType]; const nameArgs = appName ? ['--app-name', appName] : []; const versionArgs = pkg.version ? ['--app-version', pkg.version] : []; return [...labArgs, ...nameArgs, ...versionArgs]; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/session.ts000066400000000000000000000175461425441362600250460ustar00rootroot00000000000000import { IClient, IConfig, ISession, IonicEnvironment } from '../definitions'; import { isLoginResponse, isSuperAgentError } from '../guards'; import { input } from './color'; import { FatalException, SessionException } from './errors'; import { formatResponseError } from './http'; import { openUrl } from './open'; export interface SessionDeps { readonly config: IConfig; readonly client: IClient; } export class BaseSession { constructor(readonly e: SessionDeps) {} async logout(): Promise { const activeToken = this.e.config.get('tokens.user'); if (activeToken) { // invalidate the token const { req } = await this.e.client.make('POST', '/logout'); req.set('Authorization', `Bearer ${activeToken}`) .send({}); try { await this.e.client.do(req); } catch (e) {} } this.e.config.unset('org.id'); this.e.config.unset('user.id'); this.e.config.unset('user.email'); this.e.config.unset('tokens.user'); this.e.config.unset('tokens.refresh'); this.e.config.unset('tokens.expiresInSeconds'); this.e.config.unset('tokens.issuedOn'); this.e.config.unset('tokens.flowName'); this.e.config.set('git.setup', false); } isLoggedIn(): boolean { return typeof this.e.config.get('tokens.user') === 'string'; } getUser(): { id: number; } { const userId = this.e.config.get('user.id'); if (!userId) { throw new SessionException( `Oops, sorry! You'll need to log in:\n ${input('ionic login')}\n\n` + `You can create a new account by signing up:\n\n ${input('ionic signup')}\n` ); } return { id: userId }; } } export class ProSession extends BaseSession implements ISession { async getUserToken(): Promise { let userToken = this.e.config.get('tokens.user'); if (!userToken) { throw new SessionException( `Oops, sorry! You'll need to log in:\n ${input('ionic login')}\n\n` + `You can create a new account by signing up:\n\n ${input('ionic signup')}\n` ); } const tokenIssuedOn = this.e.config.get('tokens.issuedOn'); const tokenExpirationSeconds = this.e.config.get('tokens.expiresInSeconds'); const refreshToken = this.e.config.get('tokens.refresh'); const flowName = this.e.config.get('tokens.flowName'); // if there is the possibility to refresh the token, try to do it if (tokenIssuedOn && tokenExpirationSeconds && refreshToken && flowName) { if (!this.isTokenValid(tokenIssuedOn, tokenExpirationSeconds)) { userToken = await this.refreshLogin(refreshToken, flowName); } } // otherwise simply return the token return userToken; } private isTokenValid(tokenIssuedOn: string, tokenExpirationSeconds: number): boolean { const tokenExpirationMilliSeconds = tokenExpirationSeconds * 1000; // 15 minutes in milliseconds of margin const marginExpiration = 15 * 60 * 1000; const tokenValid = new Date() < new Date(new Date(tokenIssuedOn).getTime() + tokenExpirationMilliSeconds - marginExpiration); return tokenValid; } async login(email: string, password: string): Promise { const { req } = await this.e.client.make('POST', '/login'); req.send({ email, password, source: 'cli' }); try { const res = await this.e.client.do(req); if (!isLoginResponse(res)) { const data = res.data; if (hasTokenAttribute(data)) { data.token = '*****'; } throw new FatalException( 'API request was successful, but the response format was unrecognized.\n' + formatResponseError(req, res.meta.status, data) ); } const { token, user } = res.data; if (this.e.config.get('user.id') !== user.id) { // User changed await this.logout(); } this.e.config.set('user.id', user.id); this.e.config.set('user.email', email); this.e.config.set('tokens.user', token); } catch (e) { if (isSuperAgentError(e) && (e.response.status === 401 || e.response.status === 403)) { throw new SessionException('Incorrect email or password.'); } throw e; } } async ssoLogin(email?: string): Promise { await this.webLogin(); } async tokenLogin(token: string): Promise { const { UserClient } = await import('./user'); const userClient = new UserClient(token, this.e); try { const user = await userClient.loadSelf(); const user_id = user.id; if (this.e.config.get('user.id') !== user_id) { // User changed await this.logout(); } this.e.config.set('user.id', user_id); this.e.config.set('user.email', user.email); this.e.config.set('tokens.user', token); } catch (e) { if (isSuperAgentError(e) && (e.response.status === 401 || e.response.status === 403)) { throw new SessionException('Invalid auth token.'); } throw e; } } async wizardLogin(): Promise { const { OpenIDFlow } = await import('./oauth/openid'); const wizardUrl = new URL(this.e.config.getOpenIDOAuthConfig().authorizationUrl); wizardUrl.pathname = 'start'; const flow = new OpenIDFlow({}, this.e, wizardUrl.href); const token = await flow.run(); await this.tokenLogin(token.access_token); this.e.config.set('tokens.refresh', token.refresh_token); this.e.config.set('tokens.expiresInSeconds', token.expires_in); this.e.config.set('tokens.issuedOn', (new Date()).toJSON()); this.e.config.set('tokens.flowName', flow.flowName); return token.state; } async webLogin(): Promise { const { OpenIDFlow } = await import('./oauth/openid'); const flow = new OpenIDFlow({}, this.e); const token = await flow.run(); await this.tokenLogin(token.access_token); this.e.config.set('tokens.refresh', token.refresh_token); this.e.config.set('tokens.expiresInSeconds', token.expires_in); this.e.config.set('tokens.issuedOn', (new Date()).toJSON()); this.e.config.set('tokens.flowName', flow.flowName); } async refreshLogin(refreshToken: string, flowName: string): Promise { let oauthflow; // having a generic way to access the right refresh token flow switch (flowName) { case 'open_id': const { OpenIDFlow } = await import('./oauth/openid'); oauthflow = new OpenIDFlow({}, this.e); break; default: oauthflow = undefined; } if (!oauthflow) { throw new FatalException('Token cannot be refreshed'); } const token = await oauthflow.exchangeRefreshToken(refreshToken); await this.tokenLogin(token.access_token); this.e.config.set('tokens.expiresInSeconds', token.expires_in); this.e.config.set('tokens.issuedOn', (new Date()).toJSON()); return token.access_token; } } export async function promptToLogin(env: IonicEnvironment): Promise { env.log.nl(); env.log.msg( `Log in to your Ionic account!\n` + `If you don't have one yet, create yours by running: ${input(`ionic signup`)}\n` ); const login = await env.prompt({ type: 'confirm', name: 'login', message: 'Open the browser to log in to your Ionic account?', default: true, }); if (login) { await env.session.webLogin(); } } export async function promptToSignup(env: IonicEnvironment): Promise { env.log.nl(); env.log.msg( `Join the Ionic Community! 💙\n` + `Connect with millions of developers on the Ionic Forum and get access to live events, news updates, and more.\n\n` ); const create = await env.prompt({ type: 'confirm', name: 'create', message: 'Create free Ionic account?', default: false, }); if (create) { const dashUrl = env.config.getDashUrl(); await openUrl(`${dashUrl}/signup?source=cli`); } } function hasTokenAttribute(r: any): r is { token: string; } { return r && typeof r === 'object' && typeof r.token === 'string'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/shell.ts000066400000000000000000000173261425441362600244660ustar00rootroot00000000000000import { LOGGER_LEVELS } from '@ionic/cli-framework-output'; import { createProcessEnv, killProcessTree, onBeforeExit } from '@ionic/utils-process'; import { ERROR_COMMAND_NOT_FOUND, Subprocess, SubprocessError, SubprocessOptions, WhichOptions, which } from '@ionic/utils-subprocess'; import { TERMINAL_INFO } from '@ionic/utils-terminal'; import * as chalk from 'chalk'; import { ChildProcess, SpawnOptions } from 'child_process'; import * as Debug from 'debug'; import * as path from 'path'; import * as split2 from 'split2'; import * as combineStreams from 'stream-combiner2'; import { ILogger, IShell, IShellOutputOptions, IShellRunOptions, IShellSpawnOptions } from '../definitions'; import { isExitCodeException } from '../guards'; import { input, strong } from './color'; import { FatalException } from './errors'; const debug = Debug('ionic:lib:shell'); export interface ShellDeps { readonly log: ILogger; } export interface ShellOptions { readonly alterPath?: (p: string) => string; } export class Shell implements IShell { alterPath: (p: string) => string; constructor(protected readonly e: ShellDeps, options?: ShellOptions) { this.alterPath = options && options.alterPath ? options.alterPath : (p: string) => p; } async run(command: string, args: readonly string[], { stream, killOnExit = true, showCommand = true, showError = true, fatalOnNotFound = true, fatalOnError = true, truncateErrorOutput, ...crossSpawnOptions }: IShellRunOptions): Promise { const proc = await this.createSubprocess(command, args, crossSpawnOptions); const fullCmd = proc.bashify(); const truncatedCmd = fullCmd.length > 80 ? fullCmd.substring(0, 80) + '...' : fullCmd; if (showCommand && this.e.log.level >= LOGGER_LEVELS.INFO) { this.e.log.rawmsg(`> ${input(fullCmd)}`); } const ws = stream ? stream : this.e.log.createWriteStream(LOGGER_LEVELS.INFO, false); try { const promise = proc.run(); if (promise.p.stdout) { const s = combineStreams(split2(), ws); // TODO: https://github.com/angular/angular-cli/issues/10922 s.on('error', (err: Error) => { debug('Error in subprocess stdout pipe: %o', err); }); promise.p.stdout.pipe(s); } if (promise.p.stderr) { const s = combineStreams(split2(), ws); // TODO: https://github.com/angular/angular-cli/issues/10922 s.on('error', (err: Error) => { debug('Error in subprocess stderr pipe: %o', err); }); promise.p.stderr.pipe(s); } if (killOnExit) { onBeforeExit(async () => { if (promise.p.pid) { await killProcessTree(promise.p.pid); } }); } await promise; } catch (e) { if (e instanceof SubprocessError && e.code === ERROR_COMMAND_NOT_FOUND) { if (fatalOnNotFound) { throw new FatalException(`Command not found: ${input(command)}`, 127); } else { throw e; } } if (!isExitCodeException(e)) { throw e; } let err = e.message || ''; if (truncateErrorOutput && err.length > truncateErrorOutput) { err = `${strong('(truncated)')} ... ` + err.substring(err.length - truncateErrorOutput); } const publicErrorMsg = ( `An error occurred while running subprocess ${input(command)}.\n` + `${input(truncatedCmd)} exited with exit code ${e.exitCode}.\n\n` + `Re-running this command with the ${input('--verbose')} flag may provide more information.` ); const privateErrorMsg = `Subprocess (${input(command)}) encountered an error (exit code ${e.exitCode}).`; if (fatalOnError) { if (showError) { throw new FatalException(publicErrorMsg, e.exitCode); } else { throw new FatalException(privateErrorMsg, e.exitCode); } } else { if (showError) { this.e.log.error(publicErrorMsg); } } throw e; } } async output(command: string, args: readonly string[], { fatalOnNotFound = true, fatalOnError = true, showError = true, showCommand = false, ...crossSpawnOptions }: IShellOutputOptions): Promise { const proc = await this.createSubprocess(command, args, crossSpawnOptions); const fullCmd = proc.bashify(); const truncatedCmd = fullCmd.length > 80 ? fullCmd.substring(0, 80) + '...' : fullCmd; if (showCommand && this.e.log.level >= LOGGER_LEVELS.INFO) { this.e.log.rawmsg(`> ${input(fullCmd)}`); } try { return await proc.output(); } catch (e) { if (e instanceof SubprocessError && e.code === ERROR_COMMAND_NOT_FOUND) { if (fatalOnNotFound) { throw new FatalException(`Command not found: ${input(command)}`, 127); } else { throw e; } } if (!isExitCodeException(e)) { throw e; } const errorMsg = `An error occurred while running ${input(truncatedCmd)} (exit code ${e.exitCode})\n`; if (fatalOnError) { throw new FatalException(errorMsg, e.exitCode); } else { if (showError) { this.e.log.error(errorMsg); } } return ''; } } /** * When `child_process.spawn` isn't provided a full path to the command * binary, it behaves differently on Windows than other platforms. For * Windows, discover the full path to the binary, otherwise fallback to the * command provided. * * @see https://github.com/ionic-team/ionic-cli/issues/3563#issuecomment-425232005 */ async resolveCommandPath(command: string, options: SpawnOptions): Promise { if (TERMINAL_INFO.windows) { try { return await this.which(command, { PATH: options.env && options.env.PATH ? options.env.PATH : process.env.PATH }); } catch (e) { // ignore } } return command; } async which(command: string, { PATH = process.env.PATH }: WhichOptions = {}): Promise { return which(command, { PATH: this.alterPath(PATH || '') }); } async spawn(command: string, args: readonly string[], { showCommand = true, ...crossSpawnOptions }: IShellSpawnOptions): Promise { const proc = await this.createSubprocess(command, args, crossSpawnOptions); const p = proc.spawn(); if (showCommand && this.e.log.level >= LOGGER_LEVELS.INFO) { this.e.log.rawmsg(`> ${input(proc.bashify())}`); } return p; } async cmdinfo(command: string, args: readonly string[] = []): Promise { const opts: IShellSpawnOptions = {}; const proc = await this.createSubprocess(command, args, opts); try { const out = await proc.output(); return out.split('\n').join(' ').trim(); } catch (e) { // no command info at this point } } async createSubprocess(command: string, args: readonly string[] = [], options: SubprocessOptions = {}): Promise { this.prepareSpawnOptions(options); const cmdpath = await this.resolveCommandPath(command, options); const proc = new Subprocess(cmdpath, args, options); return proc; } protected prepareSpawnOptions(options: IShellSpawnOptions) { // Create a `process.env`-type object from all key/values of `process.env`, // then `options.env`, then add several key/values. PATH is supplemented // with the `node_modules\.bin` folder in the project directory so that we // can run binaries inside a project. options.env = createProcessEnv(process.env, options.env ?? {}, { PATH: this.alterPath(process.env.PATH || ''), FORCE_COLOR: chalk.level > 0 ? '1' : '0', }); } } export function prependNodeModulesBinToPath(projectDir: string, p: string): string { return path.resolve(projectDir, 'node_modules', '.bin') + path.delimiter + p; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/snapshot.ts000066400000000000000000000027251425441362600252130ustar00rootroot00000000000000import { IClient, IPaginator, PaginateArgs, ResourceClientLoad, ResourceClientPaginate, Response, Snapshot } from '../definitions'; import { isSnapshotListResponse, isSnapshotResponse } from '../guards'; import { ResourceClient, createFatalAPIFormat } from './http'; export interface SnapshotClientDeps { readonly client: IClient; readonly token: string; readonly app: { id: string; }; } export class SnapshotClient extends ResourceClient implements ResourceClientLoad, ResourceClientPaginate { protected client: IClient; protected token: string; protected app: { id: string; }; constructor({ client, app, token }: SnapshotClientDeps) { super(); this.client = client; this.token = token; this.app = app; } async load(id: string): Promise { const { req } = await this.client.make('GET', `/apps/${this.app.id}/snapshots/${id}`); this.applyAuthentication(req, this.token); const res = await this.client.do(req); if (!isSnapshotResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } paginate(args: Partial>> = {}): IPaginator> { return this.client.paginate({ reqgen: async () => { const { req } = await this.client.make('GET', `/apps/${this.app.id}/snapshots`); this.applyAuthentication(req, this.token); return { req }; }, guard: isSnapshotListResponse, }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/ssh-config.ts000066400000000000000000000054131425441362600254110ustar00rootroot00000000000000import { fileToString } from '@ionic/utils-fs'; import * as os from 'os'; import * as path from 'path'; import * as SSHConfig from 'ssh-config'; export { SSHConfig }; export async function loadFromPath(p: string): Promise { const s = await fileToString(p); return SSHConfig.parse(s); } export function isDirective(entry: any): entry is SSHConfig.ConfigDirective { return entry && entry.type === SSHConfig.DIRECTIVE; } export function isHostDirective(entry: SSHConfig.Config): entry is SSHConfig.ConfigHostDirective { return isDirective(entry) && entry.param === 'Host'; } export function getConfigPath() { return path.resolve(os.homedir(), '.ssh', 'config'); } export function findHostSection(conf: SSHConfig.SSHConfig, host: string): SSHConfig.ConfigHostDirective | null { return conf.find({ Host: host }); } export function ensureHostAndKeyPath(conf: SSHConfig.SSHConfig, conn: { host: string, port?: number }, keyPath: string): void { const section = ensureHostSection(conf, conn.host); const index = conf.indexOf(section); ensureSectionLine(section, 'IdentityFile', keyPath); if (typeof conn.port === 'number' && conn.port !== 22) { ensureSectionLine(section, 'Port', String(conn.port)); } // massage the section for proper whitespace if (index === 0) { section.before = ''; } else { const previousSection = conf[index - 1]; if (isHostDirective(previousSection)) { const previousSectionLastEntry = previousSection.config[previousSection.config.length - 1]; if (previousSectionLastEntry) { previousSectionLastEntry.after = '\n'; } } else { previousSection.after = '\n'; } section.before = '\n'; } section.after = '\n'; if (!section.config) { section.config = []; } for (const entry of section.config) { entry.before = ' '; entry.after = '\n'; } if (index !== conf.length - 1) { const lastEntry = section.config[section.config.length - 1]; lastEntry.after = '\n\n'; } } function ensureHostSection(conf: SSHConfig.SSHConfig, host: string): SSHConfig.ConfigHostDirective { let section = findHostSection(conf, host); if (!section) { conf.push(SSHConfig.parse(`\nHost ${host}\n`)[0]); section = findHostSection(conf, host); } if (!section) { throw new Error(`Could not find/insert section for host: ${host}`); } return section; } function ensureSectionLine(section: SSHConfig.ConfigHostDirective, key: string, value: string): void { const found = section.config.some(line => { if (isDirective(line)) { if (line.param === key) { line.value = value; return true; } } return false; }); if (!found) { section.config = section.config.concat(SSHConfig.parse(`${key} ${value}\n`)); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/ssh.ts000066400000000000000000000072701425441362600241510ustar00rootroot00000000000000import { readFile, stat } from '@ionic/utils-fs'; import * as os from 'os'; import * as path from 'path'; import { IClient, IPaginator, PaginateArgs, PaginatorState, ResourceClientCreate, ResourceClientDelete, ResourceClientLoad, ResourceClientPaginate, Response, SSHKey } from '../definitions'; import { isSSHKeyListResponse, isSSHKeyResponse } from '../guards'; import { ResourceClient, createFatalAPIFormat } from './http'; export const ERROR_SSH_MISSING_PRIVKEY = 'SSH_MISSING_PRIVKEY'; export const ERROR_SSH_INVALID_PUBKEY = 'SSH_INVALID_PUBKEY'; export const ERROR_SSH_INVALID_PRIVKEY = 'SSH_INVALID_PRIVKEY'; export async function getGeneratedPrivateKeyPath(userId = 0): Promise { return path.resolve(os.homedir(), '.ssh', 'ionic', String(userId)); } export async function parsePublicKeyFile(pubkeyPath: string): Promise<[string, string, string, string]> { return parsePublicKey((await readFile(pubkeyPath, { encoding: 'utf8' })).trim()); } /** * @return [full pubkey, algorithm, public numbers, annotation] */ export function parsePublicKey(pubkey: string): [string, string, string, string] { const r = /^(ssh-[A-z0-9]+)\s([A-z0-9+\/=]+)\s?(.+)?$/.exec(pubkey); if (!r) { throw ERROR_SSH_INVALID_PUBKEY; } if (!r[3]) { r[3] = ''; } r[1] = r[1].trim(); r[2] = r[2].trim(); r[3] = r[3].trim(); return [pubkey, r[1], r[2], r[3]]; } export async function validatePrivateKey(keyPath: string): Promise { try { await stat(keyPath); } catch (e) { if (e.code === 'ENOENT') { throw ERROR_SSH_MISSING_PRIVKEY; } throw e; } const f = await readFile(keyPath, { encoding: 'utf8' }); const lines = f.split('\n'); if (!lines[0].match(/^\-{5}BEGIN [A-Z]+ PRIVATE KEY\-{5}$/)) { throw ERROR_SSH_INVALID_PRIVKEY; } } export interface SSHKeyClientDeps { readonly client: IClient; readonly token: string; readonly user: { id: number; }; } export interface SSHKeyCreateDetails { pubkey: string; } export class SSHKeyClient extends ResourceClient implements ResourceClientLoad, ResourceClientDelete, ResourceClientCreate, ResourceClientPaginate { protected client: IClient; protected token: string; protected user: { id: number; }; constructor({ client, token, user }: SSHKeyClientDeps) { super(); this.client = client; this.token = token; this.user = user; } async create({ pubkey }: SSHKeyCreateDetails): Promise { const { req } = await this.client.make('POST', `/users/${this.user.id}/sshkeys`); this.applyAuthentication(req, this.token); req.send({ pubkey }); const res = await this.client.do(req); if (!isSSHKeyResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } async load(id: string): Promise { const { req } = await this.client.make('GET', `/users/${this.user.id}/sshkeys/${id}`); this.applyAuthentication(req, this.token); const res = await this.client.do(req); if (!isSSHKeyResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } async delete(id: string): Promise { const { req } = await this.client.make('DELETE', `/users/${this.user.id}/sshkeys/${id}`); this.applyAuthentication(req, this.token); await this.client.do(req); } paginate(args: Partial>> = {}): IPaginator, PaginatorState> { return this.client.paginate({ reqgen: async () => { const { req } = await this.client.make('GET', `/users/${this.user.id}/sshkeys`); this.applyAuthentication(req, this.token); return { req }; }, guard: isSSHKeyListResponse, }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/start.ts000066400000000000000000000274121425441362600245110ustar00rootroot00000000000000import { readJson } from '@ionic/utils-fs'; import { columnar } from '@ionic/utils-terminal'; import * as lodash from 'lodash'; import { COLUMNAR_OPTIONS, PROJECT_TYPES } from '../constants'; import { CommandLineOptions, IConfig, ILogger, ProjectType, StarterList, StarterManifest, StarterTemplate } from '../definitions'; import { isStarterManifest } from '../guards'; import { input, strong, title } from './color'; import { FatalException } from './errors'; import { prettyProjectName } from './project'; import { emoji } from './utils/emoji'; import { createRequest } from './utils/http'; export const STARTER_BASE_URL = 'https://d2ql0qc7j8u4b2.cloudfront.net'; export interface BaseAppSchema { projectId: string; projectDir: string; packageId?: string; appflowId?: string; } export interface NewAppSchema extends BaseAppSchema { cloned: false; name: string; type: ProjectType; template: string; themeColor?: string; appIcon?: Buffer; splash?: Buffer; } export interface ClonedAppSchema extends BaseAppSchema { cloned: true; url: string; } export type AppSchema = NewAppSchema | ClonedAppSchema; export function verifyOptions(options: CommandLineOptions, { log }: { log: ILogger; }): void { // If the action is list then lets just end here. if (options['list']) { const typeOption = options['type'] ? String(options['type']) : undefined; if (typeOption && !PROJECT_TYPES.includes(typeOption as ProjectType)) { throw new FatalException( `${input(typeOption)} is not a valid project type.\n` + `Valid project types are: ${getStarterProjectTypes().map(type => input(type)).join(', ')}` ); } const headers = ['name', 'description'].map(h => strong(h)); const starterTypes = typeOption ? [typeOption] : getStarterProjectTypes(); for (const starterType of starterTypes) { const starters = STARTER_TEMPLATES.filter(template => template.projectType === starterType); log.rawmsg(`\n${strong(`Starters for ${prettyProjectName(starterType)}`)} (${input(`--type=${starterType}`)})\n\n`); log.rawmsg(columnar(starters.map(({ name, description }) => [input(name), description || '']), { ...COLUMNAR_OPTIONS, headers })); log.rawmsg('\n'); } throw new FatalException('', 0); } if (options['skip-deps']) { log.warn(`The ${input('--skip-deps')} option has been deprecated. Please use ${input('--no-deps')}.`); options['deps'] = false; } if (options['skip-link']) { log.warn(`The ${input('--skip-link')} option has been deprecated. Please use ${input('--no-link')}.`); options['link'] = false; } if (options['pro-id']) { log.warn(`The ${input('--pro-id')} option has been deprecated. Please use ${input('--id')}.`); options['id'] = options['pro-id']; } if (options['id']) { if (options['link'] === false) { log.warn(`The ${input('--no-link')} option has no effect with ${input('--id')}. App must be linked.`); } options['link'] = true; if (!options['git']) { log.warn(`The ${input('--no-git')} option has no effect with ${input('--id')}. Git must be used.`); } options['git'] = true; } } export async function readStarterManifest(p: string): Promise { try { const manifest = await readJson(p); if (!isStarterManifest(manifest)) { throw new Error(`${p} is not a valid starter manifest.`); } return manifest; } catch (e) { if (e.code === 'ENOENT') { throw new Error(`${p} not found`); } else if (e instanceof SyntaxError) { throw new Error(`${p} is not valid JSON.`); } throw e; } } export function getAdvertisement(): string { const choices = [getAppflowAdvertisement, getAdvisoryAdvertisement, getEnterpriseAdvertisement]; const idx = Math.floor(Math.random() * choices.length); return `${choices[idx]()}\n\n`; } function getAppflowAdvertisement(): string { return ` ────────────────────────────────────────────────────────────── ${title('Ionic Appflow')}, the mobile DevOps solution by Ionic Continuously build, deploy, and ship apps ${emoji('🚀', '')} Focus on building apps while we automate the rest ${emoji('ðŸŽ', '')} ${emoji(' 👉 ', 'Learn more:')} ${strong('https://ion.link/appflow')} ${emoji(' 👈', '')} ────────────────────────────────────────────────────────────── `; } function getAdvisoryAdvertisement(): string { return ` ────────────────────────────────────────────────────────────────────────────── ${title('Ionic Advisory')}, tailored solutions and expert services by Ionic Go to market faster ${emoji('ðŸ†', '')} Real-time troubleshooting and guidance ${emoji('ðŸ’', '')} Custom training, best practices, code and architecture reviews ${emoji('🔎', '')} Customized strategies for every phase of the development lifecycle ${emoji('🔮', '')} ${emoji(' 👉 ', 'Learn more:')} ${strong('https://ion.link/advisory')} ${emoji(' 👈', '')} ────────────────────────────────────────────────────────────────────────────── `; } function getEnterpriseAdvertisement(): string { return ` ────────────────────────────────────────────────────────────────────── ${title('Ionic Enterprise')}, platform and solutions for teams by Ionic Powerful library of native APIs ${emoji('âš¡ï¸', '')} A supercharged platform for teams ${emoji('💪', '')} ${emoji(' 👉 ', 'Learn more:')} ${strong('https://ion.link/enterprise')} ${emoji(' 👈', '')} ────────────────────────────────────────────────────────────────────── `; } export async function getStarterList(config: IConfig, tag = 'latest'): Promise { const { req } = await createRequest('GET', `${STARTER_BASE_URL}/${tag === 'latest' ? '' : `${tag}/`}starters.json`, config.getHTTPConfig()); const res = await req; // TODO: typecheck return res.body; } export function getStarterProjectTypes(): string[] { return lodash.uniq(STARTER_TEMPLATES.map(t => t.projectType)); } export interface SupportedFramework { name: string; type: ProjectType; description: string; } export const SUPPORTED_FRAMEWORKS: readonly SupportedFramework[] = [ { name: 'Angular', type: 'angular', description: 'https://angular.io', }, { name: 'React', type: 'react', description: 'https://reactjs.org', }, { name: 'Vue', type: 'vue', description: 'https://vuejs.org', }, ]; export const STARTER_TEMPLATES: StarterTemplate[] = [ // Vue { name: 'tabs', projectType: 'vue', type: 'managed', description: 'A starting project with a simple tabbed interface', id: 'vue-official-tabs', }, { name: 'sidemenu', projectType: 'vue', type: 'managed', description: 'A starting project with a side menu with navigation in the content area', id: 'vue-official-sidemenu', }, { name: 'blank', projectType: 'vue', type: 'managed', description: 'A blank starter project', id: 'vue-official-blank', }, { name: 'list', projectType: 'vue', type: 'managed', description: 'A starting project with a list', id: 'vue-official-list', }, // Angular { name: 'tabs', projectType: 'angular', type: 'managed', description: 'A starting project with a simple tabbed interface', id: 'angular-official-tabs', }, { name: 'sidemenu', projectType: 'angular', type: 'managed', description: 'A starting project with a side menu with navigation in the content area', id: 'angular-official-sidemenu', }, { name: 'blank', projectType: 'angular', type: 'managed', description: 'A blank starter project', id: 'angular-official-blank', }, { name: 'list', projectType: 'angular', type: 'managed', description: 'A starting project with a list', id: 'angular-official-list', }, { name: 'my-first-app', projectType: 'angular', type: 'repo', description: 'A template for the "Build Your First App" tutorial', repo: 'https://github.com/ionic-team/photo-gallery-capacitor-ng', }, // React { name: 'blank', projectType: 'react', type: 'managed', description: 'A blank starter project', id: 'react-official-blank', }, { name: 'list', projectType: 'react', type: 'managed', description: 'A starting project with a list', id: 'react-official-list', }, { name: 'my-first-app', projectType: 'react', type: 'repo', description: 'A template for the "Build Your First App" tutorial', repo: 'https://github.com/ionic-team/photo-gallery-capacitor-react', }, { name: 'sidemenu', projectType: 'react', type: 'managed', description: 'A starting project with a side menu with navigation in the content area', id: 'react-official-sidemenu', }, { name: 'tabs', projectType: 'react', type: 'managed', description: 'A starting project with a simple tabbed interface', id: 'react-official-tabs', }, // Old Ionic V3 { name: 'tabs', projectType: 'ionic-angular', type: 'managed', description: 'A starting project with a simple tabbed interface', id: 'ionic-angular-official-tabs', }, { name: 'sidemenu', projectType: 'ionic-angular', type: 'managed', description: 'A starting project with a side menu with navigation in the content area', id: 'ionic-angular-official-sidemenu', }, { name: 'blank', projectType: 'ionic-angular', type: 'managed', description: 'A blank starter project', id: 'ionic-angular-official-blank', }, { name: 'super', projectType: 'ionic-angular', type: 'managed', description: 'A starting project complete with pre-built pages, providers and best practices for Ionic development.', id: 'ionic-angular-official-super', }, { name: 'tutorial', projectType: 'ionic-angular', type: 'managed', description: 'A tutorial based project that goes along with the Ionic documentation', id: 'ionic-angular-official-tutorial', }, { name: 'aws', projectType: 'ionic-angular', type: 'managed', description: 'AWS Mobile Hub Starter', id: 'ionic-angular-official-aws', }, // Older Ionic V1 { name: 'tabs', projectType: 'ionic1', type: 'managed', description: 'A starting project for Ionic using a simple tabbed interface', id: 'ionic1-official-tabs', }, { name: 'sidemenu', projectType: 'ionic1', type: 'managed', description: 'A starting project for Ionic using a side menu with navigation in the content area', id: 'ionic1-official-sidemenu', }, { name: 'blank', projectType: 'ionic1', type: 'managed', description: 'A blank starter project for Ionic', id: 'ionic1-official-blank', }, { name: 'maps', projectType: 'ionic1', type: 'managed', description: 'An Ionic starter project using Google Maps and a side menu', id: 'ionic1-official-maps', }, ]; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/telemetry.ts000066400000000000000000000074421425441362600253670ustar00rootroot00000000000000import * as Debug from 'debug'; import * as lodash from 'lodash'; import { IClient, IConfig, IProject, ISession, ITelemetry, InfoItem, IonicContext } from '../definitions'; import { sendMessage } from './helper'; import { generateUUID } from './utils/uuid'; const debug = Debug('ionic:lib:telemetry'); const GA_CODE = 'UA-44023830-30'; let _gaTracker: import('leek') | undefined; export interface TelemetryDeps { readonly client: IClient; readonly config: IConfig; readonly getInfo: () => Promise; readonly ctx: IonicContext; readonly project?: IProject; readonly session: ISession; } export class Telemetry implements ITelemetry { protected readonly client: IClient; protected readonly config: IConfig; protected readonly getInfo: () => Promise; protected readonly ctx: IonicContext; protected readonly project?: IProject; protected readonly session: ISession; constructor({ config, client, getInfo, ctx, project, session }: TelemetryDeps) { this.client = client; this.config = config; this.getInfo = getInfo; this.ctx = ctx; this.project = project; this.session = session; } async sendCommand(command: string, args: string[]): Promise { debug('Sending telemetry for command: %O %O', command, args); await sendMessage({ config: this.config, ctx: this.ctx }, { type: 'telemetry', data: { command, args } }); } } async function getLeek({ config, version }: { config: IConfig; version: string; }): Promise { if (!_gaTracker) { const Leek = await import('leek'); let telemetryToken = config.get('tokens.telemetry'); if (!telemetryToken) { telemetryToken = generateUUID(); config.set('tokens.telemetry', telemetryToken); debug(`setting telemetry token to ${telemetryToken}`); } _gaTracker = new Leek({ name: telemetryToken, trackingCode: GA_CODE, globalName: 'ionic', version, silent: !config.get('telemetry'), }); } return _gaTracker; } export async function sendCommand({ config, client, getInfo, ctx, session, project }: TelemetryDeps, command: string, args: string[]) { const messageList: string[] = []; const name = 'command execution'; const prettyArgs = args.map(a => a.includes(' ') ? `"${a}"` : a); const message = messageList.concat([command], prettyArgs).join(' '); await Promise.all([ (async () => { const leek = await getLeek({ config, version: ctx.version }); try { await leek.track({ name, message }); } catch (e) { debug(`leek track error: ${e.stack ? e.stack : e}`); } })(), (async () => { const now = new Date().toISOString(); const appflowId = project ? project.config.get('id') : undefined; const info = await getInfo(); const results = info.map(r => r.key ? { [r.key]: r.value } : undefined).filter(r => !!r); const { req } = await client.make('POST', '/events/metrics'); const metric: { [key: string]: any; } = { 'name': 'cli_command_metrics', 'timestamp': now, 'session_id': config.get('tokens.telemetry'), 'source': 'cli', 'value': { 'command': command, 'arguments': prettyArgs.join(' '), 'app_id': appflowId, 'backend': 'pro', // TODO: is this necessary? ...lodash.extend({}, ...results), }, }; const isLoggedIn = session.isLoggedIn(); if (isLoggedIn) { const token = await session.getUserToken(); req.set('Authorization', `Bearer ${token}`); } debug('metric: %o', metric); req.send({ 'metrics': [metric], 'sent_at': now, }); try { await client.do(req); } catch (e) { debug(`metric send error: ${e.stack ? e.stack : e}`); } })(), ]); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/updates.ts000066400000000000000000000106741425441362600250230ustar00rootroot00000000000000import { PackageJson } from '@ionic/cli-framework'; import { readJson, writeJson } from '@ionic/utils-fs'; import { stringWidth } from '@ionic/utils-terminal'; import * as path from 'path'; import * as semver from 'semver'; import { IConfig, IonicEnvironment } from '../definitions'; import { input, strong, success, weak, WARN } from './color'; import { sendMessage } from './helper'; import { pkgFromRegistry, pkgManagerArgs } from './utils/npm'; const UPDATE_CONFIG_FILE = 'update.json'; const UPDATE_CHECK_INTERVAL = 60 * 60 * 24 * 1000; // 1 day const UPDATE_NOTIFY_INTERVAL = 60 * 60 * 12 * 1000; // 12 hours const PACKAGES = ['@ionic/cli', 'native-run', 'cordova-res']; export interface PersistedPackage { name: string; version: string; } export interface UpdateConfig { lastUpdate?: string; lastNotify?: string; packages: PersistedPackage[]; } export async function readUpdateConfig(dir: string): Promise { return readJson(path.resolve(dir, UPDATE_CONFIG_FILE)); } export async function writeUpdateConfig(dir: string, config: UpdateConfig): Promise { await writeJson(path.resolve(dir, UPDATE_CONFIG_FILE), config, { spaces: 2 }); } export interface GetUpdateConfigDeps { readonly config: IConfig; } export async function getUpdateConfig({ config }: GetUpdateConfigDeps): Promise { const dir = path.dirname(config.p); try { return await readUpdateConfig(dir); } catch (e) { if (e.code !== 'ENOENT') { process.stderr.write(`${e.stack ? e.stack : e}\n`); } return { packages: [] }; } } export interface PersistPackageVersionsDeps { readonly config: IConfig; } export async function runUpdateCheck({ config }: PersistPackageVersionsDeps): Promise { const dir = path.dirname(config.p); const pkgs: readonly PackageJson[] = (await Promise.all(PACKAGES.map(pkg => pkgFromRegistry(config.get('npmClient'), { pkg })))) .filter((pkg): pkg is PackageJson => typeof pkg !== 'undefined'); const updateConfig = await getUpdateConfig({ config }); const newUpdateConfig: UpdateConfig = { ...updateConfig, lastUpdate: new Date().toISOString(), packages: pkgs.map(pkg => ({ name: pkg.name, version: pkg.version, })), }; await writeUpdateConfig(dir, newUpdateConfig); } export const IONIC_CLOUD_CLI_MIGRATION = (() => `${strong(WARN('Deprecated: Ionic Appflow functionality has moved to the new Ionic Cloud CLI'))}.\n`+ `Existing functionality in the Ionic CLI is deprecated as of ${WARN('v6.18.0')}. `+ `This functionality will be removed from the Ionic CLI in the next major version. `+ `Please visit our simple guide to migrate to the Ionic Cloud CLI, available now.\n`+ `${strong('https://ionic.io/docs/appflow/cli/migration/')}\n`)(); export async function runNotify(env: IonicEnvironment, pkg: PersistedPackage, latestVersion: string): Promise { const dir = path.dirname(env.config.p); const args = await pkgManagerArgs(env.config.get('npmClient'), { command: 'install', pkg: pkg.name, global: true }); const lines = [ `Ionic CLI update available: ${weak(pkg.version)} → ${success(latestVersion)}`, `Run ${input(args.join(' '))} to update`, ]; // TODO: Pull this into utils/format const padding = 3; const longestLineLength = Math.max(...lines.map(line => stringWidth(line))); const horizontalRule = ` ${'─'.repeat(longestLineLength + padding * 2)}`; const output = ( `\n${horizontalRule}\n\n` + `${lines.map(line => ` ${' '.repeat((longestLineLength - stringWidth(line)) / 2 + padding)}${line}`).join('\n')}\n\n` + `${horizontalRule}\n\n` ); process.stderr.write(output); const updateConfig = await getUpdateConfig(env); updateConfig.lastNotify = new Date().toISOString(); await writeUpdateConfig(dir, updateConfig); } export async function runUpdateNotify(env: IonicEnvironment, pkg: PackageJson): Promise { const { name, version } = pkg; const { lastUpdate, lastNotify, packages } = await getUpdateConfig(env); const latestPkg = packages.find(pkg => pkg.name === name); const latestVersion = latestPkg ? latestPkg.version : undefined; if ((!lastNotify || new Date(lastNotify).getTime() + UPDATE_NOTIFY_INTERVAL < new Date().getTime()) && latestVersion && semver.gt(latestVersion, version)) { await runNotify(env, pkg, latestVersion); } if (!lastUpdate || new Date(lastUpdate).getTime() + UPDATE_CHECK_INTERVAL < new Date().getTime()) { await sendMessage(env, { type: 'update-check' }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/user.ts000066400000000000000000000050621425441362600243270ustar00rootroot00000000000000import { GithubBranch, GithubRepo, IClient, IPaginator, ResourceClientLoad, ResourceClientRequestModifiers, Response, TokenPaginatorState, User } from '../definitions'; import { isGithubBranchListResponse, isGithubRepoListResponse, isOAuthLoginResponse, isUserResponse } from '../guards'; import { ResourceClient, TokenPaginator, createFatalAPIFormat } from './http'; export interface UserClientDeps { readonly client: IClient; } export class UserClient extends ResourceClient implements ResourceClientLoad { constructor(readonly token: string, readonly e: UserClientDeps) { super(); } async load(id: number, modifiers?: ResourceClientRequestModifiers): Promise { const { req } = await this.e.client.make('GET', `/users/${id}`); this.applyAuthentication(req, this.token); this.applyModifiers(req, modifiers); const res = await this.e.client.do(req); if (!isUserResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } async loadSelf(): Promise { const { req } = await this.e.client.make('GET', '/users/self'); this.applyAuthentication(req, this.token); const res = await this.e.client.do(req); if (!isUserResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data; } async oAuthGithubLogin(id: number): Promise { const { req } = await this.e.client.make('POST', `/users/${id}/oauth/github`); this.applyAuthentication(req, this.token); req.send({ source: 'cli' }); const res = await this.e.client.do(req); if (!isOAuthLoginResponse(res)) { throw createFatalAPIFormat(req, res); } return res.data.redirect_url; } paginateGithubRepositories(id: number): IPaginator, TokenPaginatorState> { return new TokenPaginator({ client: this.e.client, reqgen: async () => { const { req } = await this.e.client.make('GET', `/users/${id}/oauth/github/repositories`); req.set('Authorization', `Bearer ${this.token}`); return { req }; }, guard: isGithubRepoListResponse, }); } paginateGithubBranches(userId: number, repoId: number): IPaginator, TokenPaginatorState> { return new TokenPaginator({ client: this.e.client, reqgen: async () => { const { req } = await this.e.client.make('GET', `/users/${userId}/oauth/github/repositories/${repoId}/branches`); req.set('Authorization', `Bearer ${this.token}`); return { req }; }, guard: isGithubBranchListResponse, }); } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/000077500000000000000000000000001425441362600241365ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/__tests__/000077500000000000000000000000001425441362600260745ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/__tests__/npm.ts000066400000000000000000000255261425441362600272500ustar00rootroot00000000000000describe('@ionic/cli', () => { describe('lib/utils/npm', () => { describe('pkgManagerArgs', () => { jest.resetModules(); const { pkgManagerArgs } = require('../npm'); it('should be pkg install with default args', async () => { const result = await pkgManagerArgs('npm', { command: 'install' }); expect(result).toEqual(['npm', 'i']); }); it('should be pkg install args for local package', async () => { const result = await pkgManagerArgs('npm', { command: 'install', pkg: 'foo' }); expect(result).toEqual(['npm', 'i', '--save', '-E', 'foo']); }); it('should be pkg install args for local package install and save dev', async () => { const result = await pkgManagerArgs('npm', { command: 'install', pkg: 'foo', saveDev: true }); expect(result).toEqual(['npm', 'i', '-D', '-E', 'foo']); }); it('should be pkg install args for local package uninstall', async () => { const result = await pkgManagerArgs('npm', { command: 'uninstall', pkg: 'foo', saveDev: true }); expect(result).toEqual(['npm', 'uninstall', '-D', 'foo']); }); it('should be pkg install args for global package install', async () => { const result = await pkgManagerArgs('npm', { command: 'install', pkg: 'foo', global: true }); expect(result).toEqual(['npm', 'i', '-g', 'foo']); }); it('should be pkg install args for global package install with bad options', async () => { const result = await pkgManagerArgs('npm', { command: 'install', pkg: 'foo', global: true, saveDev: true }); expect(result).toEqual(['npm', 'i', '-g', 'foo']); }); it('should be dedupe args', async () => { const result = await pkgManagerArgs('npm', { command: 'dedupe' }); expect(result).toEqual(['npm', 'dedupe']); }); it('should be rebuild args', async () => { const result = await pkgManagerArgs('npm', { command: 'rebuild' }); expect(result).toEqual(['npm', 'rebuild']); }); it('should be bare run args', async () => { const result = await pkgManagerArgs('npm', { command: 'run' }); expect(result).toEqual(['npm', 'run']); }); it('should be run args with script', async () => { const result = await pkgManagerArgs('npm', { command: 'run', script: 'test' }); expect(result).toEqual(['npm', 'run', 'test']); }); it('should be run args with script and script args', async () => { const result = await pkgManagerArgs('npm', { command: 'run', script: 'test', scriptArgs: ['-s'] }); expect(result).toEqual(['npm', 'run', 'test', '--', '-s']); }); it('should be info args', async () => { const result = await pkgManagerArgs('npm', { command: 'info' }); expect(result).toEqual(['npm', 'info']); }); it('should be pkg info args', async () => { const result = await pkgManagerArgs('npm', { command: 'info', pkg: '@ionic/cli' }); expect(result).toEqual(['npm', 'info', '@ionic/cli']); }); it('should be pkg info args with json flag', async () => { const result = await pkgManagerArgs('npm', { command: 'info', pkg: '@ionic/cli', json: true }); expect(result).toEqual(['npm', 'info', '@ionic/cli', '--json']); }); it('should include lockFileOnly flag', async () => { const result = await pkgManagerArgs('npm', { command: 'install', lockFileOnly: true }); expect(result).toEqual(['npm', 'i', '--package-lock-only']); }); describe('yarn', () => { jest.resetModules(); const { pkgManagerArgs } = require('../npm'); it('should be pkg install with default args', async () => { const result = await pkgManagerArgs('yarn', { command: 'install' }); expect(result).toEqual(['yarn', 'install', '--non-interactive']); }); it('should be pkg install args for local package', async () => { const result = await pkgManagerArgs('yarn', { command: 'install', pkg: 'foo' }); expect(result).toEqual(['yarn', 'add', '--exact', '--non-interactive', 'foo']); }); it('should be pkg install args for local package install', async () => { const result = await pkgManagerArgs('yarn', { command: 'install', pkg: 'foo', saveDev: true }); expect(result).toEqual(['yarn', 'add', '--dev', '--exact', '--non-interactive', 'foo']); }); it('should be pkg install args for local package uninstall', async () => { const result = await pkgManagerArgs('yarn', { command: 'uninstall', pkg: 'foo', saveDev: true }); expect(result).toEqual(['yarn', 'remove', '--dev', '--non-interactive', 'foo']); }); it('should be pkg install args for global package install', async () => { const result = await pkgManagerArgs('yarn', { command: 'install', pkg: 'foo', global: true }); expect(result).toEqual(['yarn', 'global', 'add', '--non-interactive', 'foo']); }); it('should be pkg install args for global package install with bad options', async () => { const result = await pkgManagerArgs('yarn', { command: 'install', pkg: 'foo', global: true, saveDev: true }); expect(result).toEqual(['yarn', 'global', 'add', '--non-interactive', 'foo']); }); it('should be dedupe args', async () => { const result = await pkgManagerArgs('yarn', { command: 'dedupe' }); expect(result).toEqual([]); // yarn doesn't support dedupe }); it('should be rebuild args', async () => { const result = await pkgManagerArgs('yarn', { command: 'rebuild' }); expect(result).toEqual(['yarn', 'install', '--non-interactive', '--force']); }); it('should be run args', async () => { const result = await pkgManagerArgs('yarn', { command: 'run' }); expect(result).toEqual(['yarn', 'run', '--non-interactive']); }); it('should be run args with script', async () => { const result = await pkgManagerArgs('yarn', { command: 'run', script: 'test' }); expect(result).toEqual(['yarn', 'run', '--non-interactive', 'test']); }); it('should be run args with script and script args', async () => { const result = await pkgManagerArgs('yarn', { command: 'run', script: 'test', scriptArgs: ['-s'] }); expect(result).toEqual(['yarn', 'run', '--non-interactive', 'test', '-s']); }); it('should be info args', async () => { const result = await pkgManagerArgs('yarn', { command: 'info' }); expect(result).toEqual(['yarn', 'info', '--non-interactive']); }); it('should be pkg info args', async () => { const result = await pkgManagerArgs('yarn', { command: 'info', pkg: '@ionic/cli' }); expect(result).toEqual(['yarn', 'info', '--non-interactive', '@ionic/cli']); }); it('should be pkg info args with json flag', async () => { const result = await pkgManagerArgs('yarn', { command: 'info', pkg: '@ionic/cli', json: true }); expect(result).toEqual(['yarn', 'info', '--non-interactive', '@ionic/cli', '--json']); }); }); describe('pnpm', () => { jest.resetModules(); const { pkgManagerArgs } = require('../npm'); it('should be pkg install with default args', async () => { const result = await pkgManagerArgs('pnpm', { command: 'install' }); expect(result).toEqual(['pnpm', 'install']); }); it('should be pkg install args for local package', async () => { const result = await pkgManagerArgs('pnpm', { command: 'install', pkg: 'foo' }); expect(result).toEqual(['pnpm', 'add', '--save-exact', 'foo']); }); it('should be pkg install args for local package install', async () => { const result = await pkgManagerArgs('pnpm', { command: 'install', pkg: 'foo', saveDev: true }); expect(result).toEqual(['pnpm', 'add', '--save-dev', '--save-exact', 'foo']); }); it('should be pkg install args for local package uninstall', async () => { const result = await pkgManagerArgs('pnpm', { command: 'uninstall', pkg: 'foo' }); expect(result).toEqual(['pnpm', 'remove', 'foo']); }); it('should be pkg install args for global package install', async () => { const result = await pkgManagerArgs('pnpm', { command: 'install', pkg: 'foo', global: true }); expect(result).toEqual(['pnpm', 'add', '--global', 'foo']); }); it('should be pkg install args for global package install with bad options', async () => { const result = await pkgManagerArgs('pnpm', { command: 'install', pkg: 'foo', global: true, saveDev: true }); expect(result).toEqual(['pnpm', 'add', '--global', 'foo']); }); it('should be dedupe args', async () => { const result = await pkgManagerArgs('pnpm', { command: 'dedupe' }); expect(result).toEqual([]); // pnpm doesn't support dedupe }); it('should be rebuild args', async () => { const result = await pkgManagerArgs('pnpm', { command: 'rebuild' }); expect(result).toEqual(['pnpm', 'rebuild']); }); it('should be run args', async () => { const result = await pkgManagerArgs('pnpm', { command: 'run' }); expect(result).toEqual(['pnpm', 'run']); }); it('should be run args with script', async () => { const result = await pkgManagerArgs('pnpm', { command: 'run', script: 'test' }); expect(result).toEqual(['pnpm', 'run', 'test']); }); it('should be run args with script and script args', async () => { const result = await pkgManagerArgs('pnpm', { command: 'run', script: 'test', scriptArgs: ['-s'] }); expect(result).toEqual(['pnpm', 'run', 'test', '--', '-s']); }); it('should be info args', async () => { const result = await pkgManagerArgs('pnpm', { command: 'info' }); expect(result).toEqual(['pnpm', 'info']); }); it('should be pkg info args', async () => { const result = await pkgManagerArgs('pnpm', { command: 'info', pkg: '@ionic/cli' }); expect(result).toEqual(['pnpm', 'info', '@ionic/cli']); }); it('should be pkg info args with json flag', async () => { const result = await pkgManagerArgs('pnpm', { command: 'info', pkg: '@ionic/cli', json: true }); expect(result).toEqual(['pnpm', 'info', '@ionic/cli', '--json']); }); it('should include lockFileOnly flag', async () => { const result = await pkgManagerArgs('pnpm', { command: 'install', lockFileOnly: true }); expect(result).toEqual(['pnpm', 'install', '--lockfile-only']); }); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/__tests__/uuid.ts000066400000000000000000000005521425441362600274140ustar00rootroot00000000000000import { generateUUID } from '../uuid'; describe('@ionic/cli', () => { describe('lib/utils/uuid', () => { describe('generateUUID', () => { it('should be of standard format', () => { const id = generateUUID(); expect(id).toEqual(expect.stringMatching(/^[a-z0-9]{8}(-[a-z0-9]{4}){3}-[a-z0-9]{12}$/)); }); }); }); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/archive.ts000066400000000000000000000000551425441362600261270ustar00rootroot00000000000000import * as tar from 'tar'; export { tar }; ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/color.ts000066400000000000000000000115521425441362600256300ustar00rootroot00000000000000export interface RGB { b: number; g: number; r: number; } export interface HSL { h: number; l: number; s: number; } function componentToHex(c: number) { const hex = c.toString(16); return hex.length === 1 ? `0${hex}` : hex; } function expandHex(hex: string): string { const shorthandRegex = /^#?([a-f\d])([a-f\d])([a-f\d])$/i; hex = hex.replace(shorthandRegex, (_m, r, g, b) => { return r + r + g + g + b + b; }); return `#${hex.replace('#', '')}`; } function hexToRGB(hex: string): RGB { hex = expandHex(hex); hex = hex.replace('#', ''); const intValue: number = parseInt(hex, 16); return { r: (intValue >> 16) & 255, g: (intValue >> 8) & 255, b: intValue & 255, }; } function hslToRGB({ h, s, l }: HSL): RGB { h = h / 360; s = s / 100; l = l / 100; if (s === 0) { l = Math.round(l * 255); return { r: l, g: l, b: l, }; } const hue2rgb = (p: number, q: number, t: number) => { if (t < 0) { t += 1; } if (t > 1) { t -= 1; } if (t < 1 / 6) { return p + (q - p) * 6 * t; } if (t < 1 / 2) { return q; } if (t < 2 / 3) { return p + (q - p) * (2 / 3 - t) * 6; } return p; }; const q = l < 0.5 ? l * (1 + s) : l + s - l * s; const p = 2 * l - q; const r = hue2rgb(p, q, h + (1 / 3)); const g = hue2rgb(p, q, h); const b = hue2rgb(p, q, h - (1 / 3)); return { r: Math.round(r * 255), g: Math.round(g * 255), b: Math.round(b * 255), }; } function mixColors(color: Color, mixColor: Color, weight = .5): RGB { const colorRGB: RGB = color.rgb; const mixColorRGB: RGB = mixColor.rgb; const mixColorWeight = 1 - weight; return { r: Math.round(weight * mixColorRGB.r + mixColorWeight * colorRGB.r), g: Math.round(weight * mixColorRGB.g + mixColorWeight * colorRGB.g), b: Math.round(weight * mixColorRGB.b + mixColorWeight * colorRGB.b), }; } function rgbToHex({ r, g, b }: RGB) { return '#' + componentToHex(r) + componentToHex(g) + componentToHex(b); } function rgbToHSL({ r, g, b }: RGB): HSL { r = Math.max(Math.min(r / 255, 1), 0); g = Math.max(Math.min(g / 255, 1), 0); b = Math.max(Math.min(b / 255, 1), 0); const max = Math.max(r, g, b); const min = Math.min(r, g, b); const l = Math.min(1, Math.max(0, (max + min) / 2)); let d; let h; let s; if (max !== min) { d = max - min; s = l > 0.5 ? d / (2 - max - min) : d / (max + min); if (max === r) { h = (g - b) / d + (g < b ? 6 : 0); } else if (max === g) { h = (b - r) / d + 2; } else { h = (r - g) / d + 4; } h = h / 6; } else { h = s = 0; } return { h: Math.round(h * 360), s: Math.round(s * 100), l: Math.round(l * 100), }; } function rgbToYIQ({ r, g, b }: RGB): number { return ((r * 299) + (g * 587) + (b * 114)) / 1000; } export class Color { readonly hex: string; readonly hsl: HSL; readonly rgb: RGB; readonly yiq: number; constructor(value: string | RGB | HSL) { if (typeof(value) === 'string' && /rgb\(/.test(value)) { const matches = /rgb\((\d{1,3}), ?(\d{1,3}), ?(\d{1,3})\)/.exec(value); if (matches) { value = { r: parseInt(matches[0], 10), g: parseInt(matches[1], 10), b: parseInt(matches[2], 10) }; } } else if (typeof(value) === 'string' && /hsl\(/.test(value)) { const matches = /hsl\((\d{1,3}), ?(\d{1,3}%), ?(\d{1,3}%)\)/.exec(value); if (matches) { value = { h: parseInt(matches[0], 10), s: parseInt(matches[1], 10), l: parseInt(matches[2], 10) }; } } if (typeof(value) === 'string') { value = value.replace(/\s/g, ''); this.hex = expandHex(value); this.rgb = hexToRGB(this.hex); this.hsl = rgbToHSL(this.rgb); } else if ('r' in value && 'g' in value && 'b' in value) { this.rgb = value; this.hex = rgbToHex(this.rgb); this.hsl = rgbToHSL(this.rgb); } else if ('h' in value && 's' in value && 'l' in value) { this.hsl = value; this.rgb = hslToRGB(this.hsl); this.hex = rgbToHex(this.rgb); } else { throw new Error('Invalid color'); } this.yiq = rgbToYIQ(this.rgb); } static isColor(value: string): boolean { if (/rgb\((\d{1,3}), ?(\d{1,3}), ?(\d{1,3})\)/.test(value)) { return true; } return /(^#[0-9a-fA-F]+)/.test(value.trim()); } contrast = (threshold = 128): Color => { return new Color((this.yiq && this.yiq >= threshold ? '#000' : '#fff')); } mix = (from: string | RGB | HSL | Color, amount = .5): Color => { const base: Color = from instanceof Color ? from : new Color(from); return new Color(mixColors(this, base, amount)); } shade = (weight = .12): Color => { return this.mix({ r: 0, g: 0, b: 0 }, weight); } tint = (weight = .1): Color => { return this.mix({ r: 255, g: 255, b: 255 }, weight); } toList(): string { const { r, g, b } = this.rgb; return `${r},${g},${b}`; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/emoji.ts000066400000000000000000000002741425441362600256140ustar00rootroot00000000000000import { TERMINAL_INFO } from '@ionic/utils-terminal'; export function emoji(x: string, fallback: string): string { if (TERMINAL_INFO.windows) { return fallback; } return x; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/file.ts000066400000000000000000000010411425441362600254210ustar00rootroot00000000000000class FileUtils { private filenameReservedRegex = (/[<>:"\/\\|?*\x00-\x1F]/g); private filenameReservedRegexWindows = (/^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i); isValidFileName(fileName: any): boolean { if (!fileName || fileName.length > 255) { return false; } if (this.filenameReservedRegex.test(fileName) || this.filenameReservedRegexWindows.test(fileName)) { return false; } if (/^\.\.?$/.test(fileName)) { return false; } return true; } } export const fileUtils = new FileUtils(); ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/http.ts000066400000000000000000000061701425441362600254710ustar00rootroot00000000000000import { conform } from '@ionic/utils-array'; import { readFile } from '@ionic/utils-fs'; import * as Debug from 'debug'; import { CreateRequestOptions, HttpMethod } from '../../definitions'; export type SuperAgentRequest = import('superagent').SuperAgentRequest; const debug = Debug('ionic:lib:utils:http'); export const PROXY_ENVIRONMENT_VARIABLES: readonly string[] = ['IONIC_HTTP_PROXY', 'HTTPS_PROXY', 'HTTP_PROXY', 'PROXY', 'https_proxy', 'http_proxy', 'proxy']; function getGlobalProxy(): { envvar: string; envval: string; } | undefined { for (const envvar of PROXY_ENVIRONMENT_VARIABLES) { const envval = process.env[envvar]; if (envval) { return { envval, envvar }; } } } export async function createRequest(method: HttpMethod, url: string, { userAgent, proxy, ssl }: CreateRequestOptions): Promise<{ req: SuperAgentRequest; }> { const superagent = await import('superagent'); if (!proxy) { const gproxy = getGlobalProxy(); if (gproxy) { proxy = gproxy.envval; } } const req = superagent(method, url); req .set('User-Agent', userAgent) .redirects(25); if (proxy) { const superagentProxy = await import('superagent-proxy'); superagentProxy(superagent); if (req.proxy) { req.proxy(proxy); } else { debug(`Cannot install proxy--req.proxy not defined`); } } if (ssl) { const cafiles = conform(ssl.cafile); const certfiles = conform(ssl.certfile); const keyfiles = conform(ssl.keyfile); if (cafiles.length > 0) { req.ca(await Promise.all(cafiles.map(p => readFile(p, { encoding: 'utf8' })))); } if (certfiles.length > 0) { req.cert(await Promise.all(certfiles.map(p => readFile(p, { encoding: 'utf8' })))); } if (keyfiles.length > 0) { req.key(await Promise.all(keyfiles.map(p => readFile(p, { encoding: 'utf8' })))); } } return { req }; } /** * Initiate a request, downloading the contents to a writable stream. * * @param req The request to download to the writable stream. * @param ws Must be a dedicated writable stream that calls the 'close' event. */ export async function download(req: SuperAgentRequest, ws: NodeJS.WritableStream, { progress }: { progress?: (loaded: number, total: number) => void; }): Promise { return new Promise((resolve, reject) => { req .on('response', res => { if (res.status !== 200) { reject(new Error( `Encountered bad status code (${res.status}) for ${req.url}\n` + `This could mean the server is experiencing difficulties right now--please try again later.` )); } if (progress) { let loaded = 0; const total = Number(res.header['content-length']); res.on('data', chunk => { loaded += chunk.length; progress(loaded, total); }); } }) .on('error', err => { if (err.code === 'ECONNABORTED') { reject(new Error(`Timeout of ${err.timeout}ms reached for ${req.url}`)); } else { reject(err); } }); ws.on('close', resolve); req.pipe(ws); }); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/logger.ts000066400000000000000000000027071425441362600257730ustar00rootroot00000000000000import { DEFAULT_COLORS } from '@ionic/cli-framework'; import { CreateTaggedFormatterOptions, DEFAULT_LOGGER_HANDLERS, LOGGER_LEVELS, Logger as BaseLogger, LoggerFormatter, LoggerLevelWeight, createPrefixedFormatter, createTaggedFormatter } from '@ionic/cli-framework-output'; import * as chalk from 'chalk'; import { ILogger } from '../../definitions'; import { weak } from '../color'; export class Logger extends BaseLogger implements ILogger { ok(msg: string): void { this.log({ ...this.createRecord(`${weak('[')}${chalk.bold.green('OK')}${weak(']')} ${msg}`), format: false }); } rawmsg(msg: string): void { this.log({ ...this.createRecord(msg), format: false }); } } export function createFormatter(options: CreateTaggedFormatterOptions = {}): LoggerFormatter { const prefix = process.argv.includes('--log-timestamps') ? () => `${weak('[' + new Date().toISOString() + ']')}` : ''; return createTaggedFormatter({ colors: DEFAULT_COLORS, prefix, titleize: true, wrap: true, ...options }); } export function createDefaultLoggerHandlers(formatter = createFormatter()) { return new Set([...DEFAULT_LOGGER_HANDLERS].map(handler => handler.clone({ formatter }))); } export function createPrefixedWriteStream(log: ILogger, prefix: string, level: LoggerLevelWeight = LOGGER_LEVELS.INFO): NodeJS.WritableStream { const l = log.clone(); l.handlers = createDefaultLoggerHandlers(createPrefixedFormatter(prefix)); return l.createWriteStream(level); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/npm.ts000066400000000000000000000127061425441362600253060ustar00rootroot00000000000000import { PackageJson } from '@ionic/cli-framework'; import { Subprocess } from '@ionic/utils-subprocess'; import { NpmClient } from '../../definitions'; interface PkgManagerVocabulary { // commands install: string; bareInstall: string; uninstall: string; run: string; dedupe: string; rebuild: string; // flags global: string; save: string; saveDev: string; saveExact: string; nonInteractive: string; lockFileOnly: string; } export type PkgManagerCommand = 'dedupe' | 'rebuild' | 'install' | 'uninstall' | 'run' | 'info'; export interface PkgManagerOptions { command: PkgManagerCommand; pkg?: string | string[]; script?: string; scriptArgs?: string[]; global?: boolean; save?: boolean; saveDev?: boolean; saveExact?: boolean; json?: boolean; lockFileOnly?: boolean; } /** * Resolves pkg manager intent with command args. * * TODO: this is a weird function and should be split up * * @return Promise If the args is an empty array, it means the pkg manager doesn't have that command. */ export async function pkgManagerArgs(npmClient: NpmClient, options: PkgManagerOptions): Promise { let vocab: PkgManagerVocabulary; const cmd = options.command; if (cmd === 'dedupe') { delete options.pkg; } if (cmd === 'dedupe' || cmd === 'rebuild') { delete options.global; delete options.save; delete options.saveDev; } if (cmd === 'dedupe' || cmd === 'rebuild' || cmd === 'uninstall') { delete options.saveExact; } if (cmd === 'install' || cmd === 'uninstall') { if (options.global) { // Turn off all save flags for global context options.save = false; options.saveDev = false; options.saveExact = false; } else if (options.pkg && typeof options.save === 'undefined' && typeof options.saveDev === 'undefined') { // Prefer save flag options.save = true; } if (cmd === 'install' && options.pkg && typeof options.saveExact === 'undefined') { // For single package installs, prefer to save exact versions options.saveExact = true; } } const installerArgs: string[] = []; switch (npmClient) { case 'npm': vocab = { run: 'run', install: 'i', bareInstall: 'i', uninstall: 'uninstall', dedupe: 'dedupe', rebuild: 'rebuild', global: '-g', save: '--save', saveDev: '-D', saveExact: '-E', nonInteractive: '', lockFileOnly: '--package-lock-only' }; break; case 'yarn': vocab = { run: 'run', install: 'add', bareInstall: 'install', uninstall: 'remove', dedupe: '', rebuild: 'install', global: '', save: '', saveDev: '--dev', saveExact: '--exact', nonInteractive: '--non-interactive', lockFileOnly: '' }; if (options.global) { // yarn installs packages globally under the 'global' prefix, instead of having a flag installerArgs.push('global'); } break; case 'pnpm': vocab = { run: 'run', install: 'add', bareInstall: 'install', uninstall: 'remove', dedupe: '', rebuild: 'rebuild', global: '--global', save: '', saveDev: '--save-dev', saveExact: '--save-exact', nonInteractive: '', lockFileOnly: '--lockfile-only' }; break; default: throw new Error(`unknown installer: ${npmClient}`); } if (cmd === 'install') { if (options.pkg) { installerArgs.push(vocab.install); } else { installerArgs.push(vocab.bareInstall); } if (options.lockFileOnly) { installerArgs.push(vocab.lockFileOnly) } } else if (cmd === 'uninstall') { installerArgs.push(vocab.uninstall); } else if (cmd === 'dedupe') { if (vocab.dedupe) { installerArgs.push(vocab.dedupe); } else { return []; } } else if (cmd === 'rebuild') { installerArgs.push(vocab.rebuild); } else { installerArgs.push(cmd); } if (options.global && vocab.global) { installerArgs.push(vocab.global); } if (options.save && vocab.save) { installerArgs.push(vocab.save); } if (options.saveDev && vocab.saveDev) { installerArgs.push(vocab.saveDev); } if (options.saveExact && vocab.saveExact) { installerArgs.push(vocab.saveExact); } if (vocab.nonInteractive) { // Some CLIs offer a flag that disables all interactivity, which we want to opt-into installerArgs.push(vocab.nonInteractive); } if (options.pkg) { if (typeof options.pkg === 'string'){ installerArgs.push(options.pkg); } if (Array.isArray(options.pkg)){ installerArgs.push(...options.pkg) } } if (cmd === 'run' && options.script) { installerArgs.push(options.script); } if (npmClient === 'yarn') { if (cmd === 'rebuild') { installerArgs.push('--force'); } } if (cmd === 'run' && options.script && options.scriptArgs && options.scriptArgs.length > 0) { if (npmClient === 'npm' || npmClient === 'pnpm') { installerArgs.push('--'); } for (const arg of options.scriptArgs) { installerArgs.push(arg); } } if (options.json) { installerArgs.push('--json'); } return [npmClient, ...installerArgs]; } /** * @return Promise */ export async function pkgFromRegistry(npmClient: NpmClient, options: Partial): Promise { const [ manager, ...managerArgs ] = await pkgManagerArgs(npmClient, { command: 'info', json: true, ...options }); const cmd = new Subprocess(manager, managerArgs); const result = await cmd.output(); if (result) { const json = JSON.parse(result); return manager === 'yarn' ? json.data : json; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/src/lib/utils/uuid.ts000066400000000000000000000004721425441362600254570ustar00rootroot00000000000000export function generateUUID(): string { return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => { const r = Math.random() * 16 | 0; const v = c === 'x' ? r : (r & 0x3 | 0x8); return v.toString(16); }); } export function shortid(): string { return generateUUID().substring(0, 8); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/cli/tsconfig.json000066400000000000000000000006111425441362600241460ustar00rootroot00000000000000{ "extends": "../../../tsconfig.base.json", "compilerOptions": { "outDir": "./", "types": [ "node" ] }, "include": [ "../../../types/leek.d.ts", "../../../types/ssh-config.d.ts", "../../../types/stream-combiner2.d.ts", "../../../types/superagent-proxy.d.ts", "src/**/*.ts" ], "exclude": [ "node_modules", "src/**/__tests__/*.ts" ] } ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/000077500000000000000000000000001425441362600225105ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/.gitignore000066400000000000000000000000221425441362600244720ustar00rootroot00000000000000dist node_modules ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/.npmrc000066400000000000000000000000231425441362600236230ustar00rootroot00000000000000package-lock=false ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/CHANGELOG.md000066400000000000000000000151631425441362600243270ustar00rootroot00000000000000# Change Log All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. ## [3.1.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@3.1.4...@ionic/discover@3.1.5) (2020-08-28) **Note:** Version bump only for package @ionic/discover ## [3.1.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@3.1.3...@ionic/discover@3.1.4) (2020-08-25) **Note:** Version bump only for package @ionic/discover ## [3.1.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@3.1.2...@ionic/discover@3.1.3) (2020-05-12) ### Bug Fixes * pin tslib to avoid "Cannot set property pathExists" error ([689e1f0](https://github.com/ionic-team/ionic-cli/commit/689e1f038b907356ef855a067a76d4822e7072a8)) ## [3.1.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@3.1.1...@ionic/discover@3.1.2) (2020-05-06) **Note:** Version bump only for package @ionic/discover ## [3.1.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@3.1.0...@ionic/discover@3.1.1) (2020-03-03) **Note:** Version bump only for package @ionic/discover # 3.1.0 (2020-02-11) ### Features * **start:** add new list starter option ([#4315](https://github.com/ionic-team/ionic-cli/issues/4315)) ([1df44c1](https://github.com/ionic-team/ionic-cli/commit/1df44c1591f37b89f2b672857740edd6cb2aea67)) ## [3.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@3.0.1...@ionic/discover@3.0.2) (2020-02-10) **Note:** Version bump only for package @ionic/discover ## [3.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@3.0.0...@ionic/discover@3.0.1) (2020-02-03) **Note:** Version bump only for package @ionic/discover # [3.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.8...@ionic/discover@3.0.0) (2020-01-25) ### chore * require Node 10 ([5a47874](https://github.com/ionic-team/ionic-cli/commit/5a478746c074207b6dc96aa8771f04a606deb1ef)) ### BREAKING CHANGES * A minimum of Node.js 10.3.0 is required. ## [2.0.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.7...@ionic/discover@2.0.8) (2020-01-15) **Note:** Version bump only for package @ionic/discover ## [2.0.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.6...@ionic/discover@2.0.7) (2019-12-05) **Note:** Version bump only for package @ionic/discover ## [2.0.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.5...@ionic/discover@2.0.6) (2019-09-18) **Note:** Version bump only for package @ionic/discover ## [2.0.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.4...@ionic/discover@2.0.5) (2019-08-23) **Note:** Version bump only for package @ionic/discover ## [2.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.3...@ionic/discover@2.0.4) (2019-08-14) **Note:** Version bump only for package @ionic/discover ## [2.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.2...@ionic/discover@2.0.3) (2019-08-07) **Note:** Version bump only for package @ionic/discover ## [2.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.1...@ionic/discover@2.0.2) (2019-06-18) **Note:** Version bump only for package @ionic/discover ## [2.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@2.0.0...@ionic/discover@2.0.1) (2019-06-05) **Note:** Version bump only for package @ionic/discover # [2.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.13...@ionic/discover@2.0.0) (2019-05-29) ### chore * require Node 8 ([5670e68](https://github.com/ionic-team/ionic-cli/commit/5670e68)) ### BREAKING CHANGES * A minimum of Node.js 8.9.4 is required. ## [1.0.13](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.12...@ionic/discover@1.0.13) (2019-02-27) **Note:** Version bump only for package @ionic/discover ## [1.0.12](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.11...@ionic/discover@1.0.12) (2019-02-15) **Note:** Version bump only for package @ionic/discover ## [1.0.11](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.10...@ionic/discover@1.0.11) (2019-01-23) **Note:** Version bump only for package @ionic/discover ## [1.0.10](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.9...@ionic/discover@1.0.10) (2019-01-07) **Note:** Version bump only for package @ionic/discover ## [1.0.9](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.8...@ionic/discover@1.0.9) (2018-12-19) **Note:** Version bump only for package @ionic/discover ## [1.0.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.7...@ionic/discover@1.0.8) (2018-11-20) ### Bug Fixes * **discover:** `new Buffer` deprecation warnings ([302b68c](https://github.com/ionic-team/ionic-cli/commit/302b68c)) ## [1.0.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.6...@ionic/discover@1.0.7) (2018-10-31) **Note:** Version bump only for package @ionic/discover ## [1.0.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.5...@ionic/discover@1.0.6) (2018-10-05) **Note:** Version bump only for package @ionic/discover ## [1.0.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.4...@ionic/discover@1.0.5) (2018-10-03) **Note:** Version bump only for package @ionic/discover ## [1.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.3...@ionic/discover@1.0.4) (2018-08-15) **Note:** Version bump only for package @ionic/discover ## [1.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.2...@ionic/discover@1.0.3) (2018-08-06) **Note:** Version bump only for package @ionic/discover ## [1.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.1...@ionic/discover@1.0.2) (2018-08-02) **Note:** Version bump only for package @ionic/discover ## [1.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.0...@ionic/discover@1.0.1) (2018-07-30) **Note:** Version bump only for package @ionic/discover # [1.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/discover@1.0.0-rc.13...@ionic/discover@1.0.0) (2018-07-25) **Note:** Version bump only for package @ionic/discover ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/LICENSE000066400000000000000000000020641425441362600235170ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2017 Drifty Co 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. ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/README.md000066400000000000000000000021131425441362600237640ustar00rootroot00000000000000# Ionic Discover Simple UDP based protocol for service discovery implemented in pure JS. It is not mDNS or bonjour, but it tries to accomplish the same thing. ## Spec It uses a JSON based textual format: ```ts const message = { t: now, id: 'unique', name: this.name, host: os.hostname(), ip: iface.address, port: number1, commPort: number2 }; return 'ION_DP' + JSON.stringify(message); ``` | key | description |------------|------------- | `t` | unix timestamp in second | `id` | unique id for this session | `name` | name of the announced service | `host` | hostname of the machine announcing the service | `ip` | ipv4 address | `port` | tcp port of the announced service | `commPort` | optional websocket port of the communication server ## Installation ``` npm install @ionic/discover ``` ## Usage ```ts import { Publisher } from '@ionic/discover'; const namespace = 'your-service'; const serviceName = 'Ionic thing!'; const tcpPort = 8100; const service = new Publisher(namespace, serviceName, tcpPort); await service.start(); ``` ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/jest.config.js000066400000000000000000000000671425441362600252620ustar00rootroot00000000000000module.exports = require('../../../jest.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/lint-staged.config.js000066400000000000000000000000761425441362600265300ustar00rootroot00000000000000module.exports = require('../../../lint-staged.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/package.json000066400000000000000000000023311425441362600247750ustar00rootroot00000000000000{ "name": "@ionic/discover", "version": "3.1.5", "description": "Simple UDP based protocol for service discovery implemented in pure JS.", "main": "dist/index.js", "types": "dist/index.d.ts", "homepage": "https://ionicframework.com/", "author": "Ionic Team (https://ionic.io)", "license": "MIT", "files": [ "dist/", "LICENSE", "README.md" ], "repository": { "type": "git", "url": "https://github.com/ionic-team/ionic-cli.git" }, "bugs": { "url": "https://github.com/ionic-team/ionic-cli/issues" }, "scripts": { "clean": "rimraf dist", "lint": "true", "build": "npm run clean && tsc", "watch": "tsc -w --preserveWatchOutput", "test": "jest --maxWorkers=4", "prepublishOnly": "npm run build" }, "dependencies": { "debug": "^4.0.0", "netmask": "^1.0.6", "tslib": "^2.0.1", "ws": "^7.0.0" }, "devDependencies": { "@types/debug": "^4.1.1", "@types/jest": "^26.0.10", "@types/netmask": "^1.0.30", "@types/node": "~10.17.13", "@types/ws": "^7.2.0", "jest": "^26.4.2", "jest-cli": "^26.0.1", "lint-staged": "^10.0.2", "rimraf": "^3.0.0", "ts-jest": "~26.3.0", "typescript": "~4.0.2" } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/src/000077500000000000000000000000001425441362600232775ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/src/__tests__/000077500000000000000000000000001425441362600252355ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/src/__tests__/publisher.ts000066400000000000000000000051751425441362600276120ustar00rootroot00000000000000import { Publisher, prepareInterfaces } from '../publisher'; import { NetworkInterfaceInfo } from 'os'; const os = require('os'); describe('publisher', () => { it('create', () => { const p = new Publisher('devapp', 'conference-app', 8100); p.on('error', () => {}); expect((p as any).client).toBeUndefined(); expect(p.namespace).toEqual('devapp'); expect(p.name).toEqual('conference-app'); expect((p as any).interval).toEqual(2000); expect(p.path).toEqual('/'); expect(p.port).toEqual(8100); expect(p.id.length).toBeGreaterThan(0); expect(p.running).toBeFalsy(); }); it('start', async () => { const p = new Publisher('devapp', 'conference-app', 8100); p.on('error', () => {}); await p.start(); expect((p as any).timer).toBeDefined(); p.stop(); expect((p as any).timer).toBeUndefined(); }, 1000); it('start/stop', async () => { const p = new Publisher('devapp', 'conference-app', 8100); p.on('error', () => {}); await p.start(); expect(p.running).toBeTruthy(); expect((p as any).client).toBeDefined(); p.stop(); expect(p.running).toBeFalsy(); expect((p as any).client).toBeUndefined(); }, 1000); it('buildMessage', () => { const p = new Publisher('devapp', 'conference-app', 8100); p.on('error', () => {}); (p as any).path = '/?devapp=true'; const message = (p as any).buildMessage('192.168.0.1'); expect(message.t).toEqual(expect.any(Number)); const expected = { t: message.t, id: p.id, nspace: 'devapp', name: 'conference-app', host: os.hostname(), ip: '192.168.0.1', port: 8100, path: '/?devapp=true' }; expect(message).toEqual(expected); }); }); it('prepareInterfaces', () => { const iface1: NetworkInterfaceInfo = { cidr: '192.168.0.2/24', address: '192.168.0.2', netmask: '255.255.0.0', family: 'IPv4', mac: '45:45:45:45:45:45', internal: false, }; const iface2: NetworkInterfaceInfo = { ...iface1, address: '193.168.0.3', internal: true }; const iface3: NetworkInterfaceInfo = { ...iface1, address: '194.168.0.4', family: 'IPv6', scopeid: 0 }; const iface4: NetworkInterfaceInfo = { ...iface1, address: '192.168.0.22' }; const iface5: NetworkInterfaceInfo = { ...iface1, address: '195.168.0.5' }; const output = prepareInterfaces({ 'en0': [iface1, iface2, iface3], 'lo': [iface4, iface5] }); expect(output).toEqual([{ address: '192.168.0.2', broadcast: '192.168.255.255' }, { address: '193.168.0.3', broadcast: '193.168.255.255' }, { address: '195.168.0.5', broadcast: '195.168.255.255' }]); }); ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/src/comm.ts000066400000000000000000000053561425441362600246130ustar00rootroot00000000000000import * as Debug from 'debug'; import * as events from 'events'; import * as util from 'util'; import * as WebSocket from 'ws'; const debug = Debug('ionic:discover:comm'); const PREFIX = 'ION_CS'; export interface CommServerConnectionPayload { event: 'connect'; device: string; } type Payload = CommServerConnectionPayload; export interface CommServer { on(event: 'error', listener: (err: Error) => void): this; on(event: 'connect', listener: (data: CommServerConnectionPayload) => void): this; } export class CommServer extends events.EventEmitter { protected server?: WebSocket.Server; constructor( public namespace: string, /** * Unique identifier of the publisher. */ public id: string, /** * Port of communication server. */ public port: number ) { super(); } get clients(): Set { return this.server ? this.server.clients : new Set(); } start(): Promise { if (this.server) { throw new Error('server already initialized'); } const server = this.server = new WebSocket.Server({ clientTracking: true, host: '0.0.0.0', port: this.port }); return new Promise((resolve, reject) => { server.on('error', err => { this.emit('error', err); }); server.on('connection', ws => { debug(`Connection established. ${server.clients.size} clients.`); ws.on('message', data => { debug(`Received %O`, data.toString()); const message = this.parseData(data); if (message) { this.emit(message.event, message); } }); ws.on('close', () => { debug(`Connection closed. ${server.clients.size} clients.`); }); }); server.on('listening', () => { debug('Comm server listening: %O', { host: server.options.host, port: this.port }); resolve(); }); }); } private parseData(data: WebSocket.Data): Payload | undefined { try { const msg = data.toString(); const msgprefix = msg.substring(0, PREFIX.length); if (msgprefix !== PREFIX) { throw new Error(`Invalid prefix for message: ${msgprefix}`); } const payload = JSON.parse(msg.substring(PREFIX.length)); if (!isPayload(payload)) { throw new Error(`Invalid payload: ${util.inspect(payload)}`); } return payload; } catch (e) { debug(e); } } stop(): Promise { if (!this.server) { throw new Error('server not initialized'); } const server = this.server; return new Promise(resolve => { server.close(() => resolve()); }); } } function isPayload(payload: any): payload is Payload { return payload && typeof payload.event === 'string'; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/src/index.ts000066400000000000000000000001731425441362600247570ustar00rootroot00000000000000export { CommServer } from './comm'; export { Publisher, computeBroadcastAddress, newSilentPublisher } from './publisher'; ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/src/publisher.ts000066400000000000000000000104651425441362600256520ustar00rootroot00000000000000import * as Debug from 'debug'; import * as dgram from 'dgram'; import * as events from 'events'; import { Netmask } from 'netmask'; import * as os from 'os'; const debug = Debug('ionic:discover:publisher'); const PREFIX = 'ION_DP'; const PORT = 41234; export interface Interface { address: string; broadcast: string; } export interface PublisherMessage { t: number; id: string; nspace: string; name: string; host: string; ip: string; port: number; commPort?: number; path: string; } export interface IPublisherEventEmitter { on(event: 'error', listener: (err: Error) => void): this; } export class Publisher extends events.EventEmitter implements IPublisherEventEmitter { readonly id: string; readonly path = '/'; running = false; interfaces?: Interface[]; protected timer?: NodeJS.Timer; protected interval = 2000; protected client?: dgram.Socket; constructor( public namespace: string, public name: string, public port: number, public commPort?: number ) { super(); if (name.indexOf(':') >= 0) { throw new Error('name should not contain ":"'); } this.id = Math.random().toString(10).substring(2, 8); } start(): Promise { return new Promise((resolve, reject) => { if (this.running) { return resolve(); } this.running = true; if (!this.interfaces) { this.interfaces = this.getInterfaces(); } const client = this.client = dgram.createSocket('udp4'); client.on('error', err => { this.emit('error', err); }); client.on('listening', () => { client.setBroadcast(true); this.timer = setInterval(() => this.sayHello(), this.interval); this.sayHello(); debug('Publisher starting'); resolve(); }); client.bind(); }); } stop() { if (!this.running) { return; } this.running = false; if (this.timer) { clearInterval(this.timer); this.timer = undefined; } if (this.client) { this.client.close(); this.client = undefined; } } protected buildMessage(ip: string): PublisherMessage { return { t: Date.now(), id: this.id, nspace: this.namespace, name: this.name, host: os.hostname(), ip, port: this.port, commPort: this.commPort, path: this.path, }; } protected getInterfaces(): Interface[] { return prepareInterfaces(os.networkInterfaces()); } protected sayHello() { if (!this.interfaces) { throw new Error('No network interfaces set--was the service started?'); } if (!this.client) { throw new Error('Client not initialized--was the service started?'); } try { for (const iface of this.interfaces) { const message = this.buildMessage(iface.address); const serialized = PREFIX + JSON.stringify(message); const buf = Buffer.from(serialized); debug(`Broadcasting %O to ${iface.broadcast}`, serialized); this.client.send(buf, 0, buf.length, PORT, iface.broadcast, err => { if (err) { this.emit('error', err); } }); } } catch (e) { this.emit('error', e); } } } export function prepareInterfaces(interfaces: { [index: string]: os.NetworkInterfaceInfo[] }): Interface[] { const set = new Set(); return Object.keys(interfaces) .map(key => interfaces[key]) .reduce((prev, current) => prev.concat(current)) .filter(iface => iface.family === 'IPv4') .map(iface => { return { address: iface.address, broadcast: computeBroadcastAddress(iface.address, iface.netmask), }; }) .filter(iface => { if (!set.has(iface.broadcast)) { set.add(iface.broadcast); return true; } return false; }); } export function newSilentPublisher(namespace: string, name: string, port: number): Publisher { name = `${name}@${port}`; const service = new Publisher(namespace, name, port); service.on('error', () => { // do not log }); service.start().catch(() => { // do not log }); return service; } export function computeBroadcastAddress(address: string, netmask: string): string { const ip = address + '/' + netmask; const block = new Netmask(ip); return block.broadcast; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/discover/tsconfig.json000066400000000000000000000003571425441362600252240ustar00rootroot00000000000000{ "extends": "../../../tsconfig.base.json", "compilerOptions": { "outDir": "./dist", "types": [ "node" ] }, "include": [ "src/**/*.ts" ], "exclude": [ "node_modules", "src/**/__tests__/*.ts" ] } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/000077500000000000000000000000001425441362600214305ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/.gitignore000066400000000000000000000000351425441362600234160ustar00rootroot00000000000000.stencil www bin/ionic-lab.* ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/.npmrc000066400000000000000000000000231425441362600225430ustar00rootroot00000000000000package-lock=false ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/CHANGELOG.md000066400000000000000000000330731425441362600232470ustar00rootroot00000000000000# Change Log All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines. ## [3.2.13](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.12...@ionic/lab@3.2.13) (2022-06-16) **Note:** Version bump only for package @ionic/lab ## [3.2.12](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.11...@ionic/lab@3.2.12) (2022-05-09) **Note:** Version bump only for package @ionic/lab ## [3.2.11](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.10...@ionic/lab@3.2.11) (2022-03-04) **Note:** Version bump only for package @ionic/lab ## [3.2.10](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.9...@ionic/lab@3.2.10) (2020-12-10) **Note:** Version bump only for package @ionic/lab ## [3.2.9](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.8...@ionic/lab@3.2.9) (2020-09-29) **Note:** Version bump only for package @ionic/lab ## [3.2.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.7...@ionic/lab@3.2.8) (2020-09-24) **Note:** Version bump only for package @ionic/lab ## [3.2.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.6...@ionic/lab@3.2.7) (2020-09-02) **Note:** Version bump only for package @ionic/lab ## [3.2.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.5...@ionic/lab@3.2.6) (2020-08-29) **Note:** Version bump only for package @ionic/lab ## [3.2.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.4...@ionic/lab@3.2.5) (2020-08-28) **Note:** Version bump only for package @ionic/lab ## [3.2.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.3...@ionic/lab@3.2.4) (2020-08-27) **Note:** Version bump only for package @ionic/lab ## [3.2.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.2...@ionic/lab@3.2.3) (2020-08-27) **Note:** Version bump only for package @ionic/lab ## [3.2.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.1...@ionic/lab@3.2.2) (2020-08-26) **Note:** Version bump only for package @ionic/lab ## [3.2.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.2.0...@ionic/lab@3.2.1) (2020-08-25) **Note:** Version bump only for package @ionic/lab # [3.2.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.7...@ionic/lab@3.2.0) (2020-08-12) ### Features * **lab:** improvements to the lab design ([#4511](https://github.com/ionic-team/ionic-cli/issues/4511)) ([625fe7b](https://github.com/ionic-team/ionic-cli/commit/625fe7b894a47837c33dfe2b8363a491f57ecbda)) ## [3.1.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.6...@ionic/lab@3.1.7) (2020-06-02) **Note:** Version bump only for package @ionic/lab ## [3.1.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.5...@ionic/lab@3.1.6) (2020-05-12) ### Bug Fixes * pin tslib to avoid "Cannot set property pathExists" error ([689e1f0](https://github.com/ionic-team/ionic-cli/commit/689e1f038b907356ef855a067a76d4822e7072a8)) ## [3.1.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.4...@ionic/lab@3.1.5) (2020-05-06) **Note:** Version bump only for package @ionic/lab ## [3.1.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.3...@ionic/lab@3.1.4) (2020-04-29) **Note:** Version bump only for package @ionic/lab ## [3.1.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.2...@ionic/lab@3.1.3) (2020-03-30) **Note:** Version bump only for package @ionic/lab ## [3.1.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.1...@ionic/lab@3.1.2) (2020-03-09) **Note:** Version bump only for package @ionic/lab ## [3.1.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.1.0...@ionic/lab@3.1.1) (2020-03-03) **Note:** Version bump only for package @ionic/lab # 3.1.0 (2020-02-11) ### Features * **start:** add new list starter option ([#4315](https://github.com/ionic-team/ionic-cli/issues/4315)) ([1df44c1](https://github.com/ionic-team/ionic-cli/commit/1df44c1591f37b89f2b672857740edd6cb2aea67)) ## [3.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.0.1...@ionic/lab@3.0.2) (2020-02-10) **Note:** Version bump only for package @ionic/lab ## [3.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@3.0.0...@ionic/lab@3.0.1) (2020-02-03) **Note:** Version bump only for package @ionic/lab # [3.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.19...@ionic/lab@3.0.0) (2020-01-25) ### chore * require Node 10 ([5a47874](https://github.com/ionic-team/ionic-cli/commit/5a478746c074207b6dc96aa8771f04a606deb1ef)) ### BREAKING CHANGES * A minimum of Node.js 10.3.0 is required. ## [2.0.19](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.18...@ionic/lab@2.0.19) (2020-01-13) **Note:** Version bump only for package @ionic/lab ## [2.0.18](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.17...@ionic/lab@2.0.18) (2019-12-10) **Note:** Version bump only for package @ionic/lab ## [2.0.17](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.16...@ionic/lab@2.0.17) (2019-12-05) **Note:** Version bump only for package @ionic/lab ## [2.0.16](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.15...@ionic/lab@2.0.16) (2019-11-25) **Note:** Version bump only for package @ionic/lab ## [2.0.15](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.14...@ionic/lab@2.0.15) (2019-11-24) **Note:** Version bump only for package @ionic/lab ## [2.0.14](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.13...@ionic/lab@2.0.14) (2019-11-21) **Note:** Version bump only for package @ionic/lab ## [2.0.13](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.12...@ionic/lab@2.0.13) (2019-10-14) **Note:** Version bump only for package @ionic/lab ## [2.0.12](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.11...@ionic/lab@2.0.12) (2019-10-14) **Note:** Version bump only for package @ionic/lab ## [2.0.11](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.10...@ionic/lab@2.0.11) (2019-09-18) **Note:** Version bump only for package @ionic/lab ## [2.0.10](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.9...@ionic/lab@2.0.10) (2019-08-28) **Note:** Version bump only for package @ionic/lab ## [2.0.9](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.8...@ionic/lab@2.0.9) (2019-08-23) **Note:** Version bump only for package @ionic/lab ## [2.0.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.7...@ionic/lab@2.0.8) (2019-08-14) **Note:** Version bump only for package @ionic/lab ## [2.0.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.6...@ionic/lab@2.0.7) (2019-08-07) **Note:** Version bump only for package @ionic/lab ## [2.0.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.5...@ionic/lab@2.0.6) (2019-07-09) **Note:** Version bump only for package @ionic/lab ## [2.0.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.4...@ionic/lab@2.0.5) (2019-06-28) **Note:** Version bump only for package @ionic/lab ## [2.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.3...@ionic/lab@2.0.4) (2019-06-21) **Note:** Version bump only for package @ionic/lab ## [2.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.2...@ionic/lab@2.0.3) (2019-06-18) **Note:** Version bump only for package @ionic/lab ## [2.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.1...@ionic/lab@2.0.2) (2019-06-10) **Note:** Version bump only for package @ionic/lab ## [2.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@2.0.0...@ionic/lab@2.0.1) (2019-06-05) **Note:** Version bump only for package @ionic/lab # [2.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.24...@ionic/lab@2.0.0) (2019-05-29) ### chore * require Node 8 ([5670e68](https://github.com/ionic-team/ionic-cli/commit/5670e68)) ### BREAKING CHANGES * A minimum of Node.js 8.9.4 is required. ## [1.0.24](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.23...@ionic/lab@1.0.24) (2019-03-12) **Note:** Version bump only for package @ionic/lab ## [1.0.23](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.22...@ionic/lab@1.0.23) (2019-03-06) **Note:** Version bump only for package @ionic/lab ## [1.0.22](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.21...@ionic/lab@1.0.22) (2019-02-27) **Note:** Version bump only for package @ionic/lab ## [1.0.21](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.20...@ionic/lab@1.0.21) (2019-02-15) **Note:** Version bump only for package @ionic/lab ## [1.0.20](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.19...@ionic/lab@1.0.20) (2019-01-29) **Note:** Version bump only for package @ionic/lab ## [1.0.19](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.18...@ionic/lab@1.0.19) (2019-01-23) **Note:** Version bump only for package @ionic/lab ## [1.0.18](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.17...@ionic/lab@1.0.18) (2019-01-08) ### Bug Fixes * **lab:** iframe now needs allow policy ([487b82a](https://github.com/ionic-team/ionic-cli/commit/487b82a)) ## [1.0.17](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.16...@ionic/lab@1.0.17) (2019-01-07) **Note:** Version bump only for package @ionic/lab ## [1.0.16](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.15...@ionic/lab@1.0.16) (2018-12-19) ### Bug Fixes * **lab:** correct statusbar position ([#3766](https://github.com/ionic-team/ionic-cli/issues/3766)) ([b37fa03](https://github.com/ionic-team/ionic-cli/commit/b37fa03)) * **lab:** default cursor for platform titles ([b215beb](https://github.com/ionic-team/ionic-cli/commit/b215beb)) * **lab:** improve dev experience on smaller screens ([45a6c58](https://github.com/ionic-team/ionic-cli/commit/45a6c58)) * **lab:** statusbar padding for all versions ([4fa13a3](https://github.com/ionic-team/ionic-cli/commit/4fa13a3)) ## [1.0.15](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.14...@ionic/lab@1.0.15) (2018-11-27) **Note:** Version bump only for package @ionic/lab ## [1.0.14](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.13...@ionic/lab@1.0.14) (2018-11-20) **Note:** Version bump only for package @ionic/lab ## [1.0.13](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.12...@ionic/lab@1.0.13) (2018-11-04) **Note:** Version bump only for package @ionic/lab ## [1.0.12](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.11...@ionic/lab@1.0.12) (2018-10-31) **Note:** Version bump only for package @ionic/lab ## [1.0.11](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.10...@ionic/lab@1.0.11) (2018-10-05) **Note:** Version bump only for package @ionic/lab ## [1.0.10](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.9...@ionic/lab@1.0.10) (2018-10-03) ### Bug Fixes * **lab:** proper statusbar padding ([63b0eef](https://github.com/ionic-team/ionic-cli/commit/63b0eef)) * **lab:** use correct query params for project type ([4801680](https://github.com/ionic-team/ionic-cli/commit/4801680)) * **serve:** persist config for livereload ([27193e8](https://github.com/ionic-team/ionic-cli/commit/27193e8)) ## [1.0.9](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.8...@ionic/lab@1.0.9) (2018-09-05) **Note:** Version bump only for package @ionic/lab ## [1.0.8](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.7...@ionic/lab@1.0.8) (2018-08-20) **Note:** Version bump only for package @ionic/lab ## [1.0.7](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.6...@ionic/lab@1.0.7) (2018-08-15) **Note:** Version bump only for package @ionic/lab ## [1.0.6](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.5...@ionic/lab@1.0.6) (2018-08-09) **Note:** Version bump only for package @ionic/lab ## [1.0.5](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.4...@ionic/lab@1.0.5) (2018-08-07) **Note:** Version bump only for package @ionic/lab ## [1.0.4](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.3...@ionic/lab@1.0.4) (2018-08-07) **Note:** Version bump only for package @ionic/lab ## [1.0.3](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.2...@ionic/lab@1.0.3) (2018-08-06) **Note:** Version bump only for package @ionic/lab ## [1.0.2](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.1...@ionic/lab@1.0.2) (2018-08-02) **Note:** Version bump only for package @ionic/lab ## [1.0.1](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.0...@ionic/lab@1.0.1) (2018-07-30) **Note:** Version bump only for package @ionic/lab # [1.0.0](https://github.com/ionic-team/ionic-cli/compare/@ionic/lab@1.0.0-rc.13...@ionic/lab@1.0.0) (2018-07-25) **Note:** Version bump only for package @ionic/lab ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/LICENSE000066400000000000000000000020641425441362600224370ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2017 Drifty Co 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. ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/README.md000066400000000000000000000004161425441362600227100ustar00rootroot00000000000000# Ionic Lab Stand-alone Ionic Lab package, a utility used by `ionic serve --lab`. Once installed, invoke serve on your framework CLI of choice. Then, copy the URL of that server and invoke the Ionic Lab CLI. For example: ```bash $ ionic-lab http://localhost:4200 ``` ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/bin/000077500000000000000000000000001425441362600222005ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/bin/ionic-lab000077500000000000000000000013531425441362600237650ustar00rootroot00000000000000#!/usr/bin/env node 'use strict'; process.title = 'ionic-lab'; process.on('unhandledRejection', function(r) { console.error(r); }); var semver = require('semver'); var version = semver.parse(process.version); var minversion = 'v10.3.0'; if (semver.lt(version, minversion)) { var details = version.major === 6 ? ' Node.js 6 reached end-of-life on 2019-04-30 and is no longer supported.' : version.major === 8 ? ' Node.js 8 reached end-of-life on 2019-12-31 and is no longer supported.' : ''; process.stderr.write('ERR: Your Node.js version is ' + version.raw + '.' + details + ' Please update to the latest Node LTS version.\n'); process.exit(1); } var cli = require('../'); cli.run(process.argv.slice(2), process.env); ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/jest.config.js000066400000000000000000000000671425441362600242020ustar00rootroot00000000000000module.exports = require('../../../jest.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/lint-staged.config.js000066400000000000000000000000761425441362600254500ustar00rootroot00000000000000module.exports = require('../../../lint-staged.config.base'); ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/package.json000066400000000000000000000031461425441362600237220ustar00rootroot00000000000000{ "name": "@ionic/lab", "version": "3.2.13", "description": "Ionic Lab utility for developing Ionic apps, used by Ionic CLI", "bin": { "ionic-lab": "./bin/ionic-lab" }, "main": "dist/index.js", "types": "dist/index.d.ts", "homepage": "https://ionicframework.com/", "author": "Ionic Team (https://ionic.io)", "license": "MIT", "engines": { "node": ">=10.3.0" }, "files": [ "bin/", "dist/", "www/", "LICENSE", "README.md" ], "repository": { "type": "git", "url": "https://github.com/ionic-team/ionic-cli.git" }, "bugs": { "url": "https://github.com/ionic-team/ionic-cli/issues" }, "scripts": { "clean": "npm run clean.tsc", "clean.tsc": "rimraf dist", "clean.stencil": "rimraf www", "lint": "true", "build": "npm run build.tsc && npm run build.stencil", "build.stencil": "npm run clean.stencil && stencil build", "build.tsc": "npm run clean.tsc && tsc", "watch": "npm run watch.tsc", "watch.stencil": "npm run clean.stencil && stencil build --dev --watch --serve --address localhost --port 8900 --no-open", "watch.tsc": "tsc -w --preserveWatchOutput", "prepublishOnly": "npm run build" }, "dependencies": { "@ionic/cli-framework": "5.1.3", "@ionic/utils-fs": "3.1.6", "chalk": "^4.0.0", "express": "^4.16.2", "tslib": "^2.0.1" }, "devDependencies": { "@ionic-internal/ionic-ds": "^2.1.0", "@stencil/core": "~1.8.5", "@types/express": "^4.11.0", "@types/node": "~10.17.13", "lint-staged": "^10.0.2", "rimraf": "^3.0.0", "typescript": "~4.0.2" } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/000077500000000000000000000000001425441362600222175ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/index.ts000066400000000000000000000072651425441362600237100ustar00rootroot00000000000000import { Command, CommandLineInputs, CommandLineOptions, CommandMap, CommandMapDefault, Namespace, execute, validators } from '@ionic/cli-framework'; import { readFile } from '@ionic/utils-fs'; import * as chalk from 'chalk'; import * as express from 'express'; import * as http from 'http'; import * as https from 'https'; import * as path from 'path'; import * as tls from 'tls'; const WWW_DIRECTORY = path.join(__dirname, '..', 'www'); class DefaultCommand extends Command { async getMetadata() { return { name: 'default', summary: '', inputs: [ { name: 'url', summary: 'The URL of the livereload server to use with lab', validators: [validators.required, validators.url], }, ], options: [ { name: 'host', summary: 'HTTP host of Ionic Lab', default: 'localhost', }, { name: 'port', summary: 'HTTP port of Ionic Lab', default: '8200', }, { name: 'project-type', summary: 'Ionic project type', }, { name: 'ssl', summary: 'Host Ionic Lab with HTTPS', type: Boolean, }, { name: 'ssl-key', summary: 'Path to SSL key', }, { name: 'ssl-cert', summary: 'Path to SSL certificate', }, { name: 'app-name', summary: 'App name to show in bottom left corner', }, { name: 'app-version', summary: 'App version to show in bottom left corner', }, ], }; } async run(inputs: CommandLineInputs, options: CommandLineOptions) { const [ url ] = inputs; const { host, port, ssl } = options; const protocol = ssl ? 'https' : 'http'; const projectType = options['project-type']; const name = options['app-name']; const version = options['app-version']; const app = express(); app.use('/', express.static(WWW_DIRECTORY)); app.get('/api/app', (req, res) => { res.json({ url, name, version, projectType }); }); const server = ssl ? https.createServer(await this.collectSecureContextOptions(options), app) : http.createServer(app); server.listen({ port, host }); const labUrl = `${protocol}://${host}:${port}`; server.on('listening', () => { process.stdout.write( 'Ionic Lab running!\n' + `Lab: ${chalk.bold(labUrl)}\n` + `App: ${chalk.bold(url)}\n` ); }); } async collectSecureContextOptions(options: CommandLineOptions): Promise { const sslKeyPath = options['ssl-key'] ? String(options['ssl-key']) : undefined; const sslCertPath = options['ssl-cert'] ? String(options['ssl-cert']) : undefined; if (!sslKeyPath || !sslCertPath) { throw new Error('SSL key and cert required for serving SSL'); } const [ key, cert ] = await Promise.all([this.readPem(sslKeyPath), this.readPem(sslCertPath)]); return { key, cert }; } async readPem(p: string): Promise { try { return await readFile(p, { encoding: 'utf8' }); } catch (e) { process.stderr.write(String(e.stack ? e.stack : e) + '\n'); throw new Error(`Error encountered with ${p}`); } } } class LabNamespace extends Namespace { async getMetadata() { return { name: 'ionic-lab', summary: '', }; } async getCommands(): Promise { return new CommandMap([[CommandMapDefault, async () => new DefaultCommand(this)]]); } } const namespace = new LabNamespace(); export async function run(argv: string[], env: NodeJS.ProcessEnv) { await execute({ namespace, argv, env }); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/000077500000000000000000000000001425441362600236605ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/.gitignore000066400000000000000000000000051425441362600256430ustar00rootroot00000000000000*.md ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/000077500000000000000000000000001425441362600251625ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/android-device-skin.png000066400000000000000000000276301425441362600315170ustar00rootroot00000000000000‰PNG  IHDR°€¡™u• pHYs%%IR$ðsRGB®ÎégAMA± üa/-IDATxíÝ_÷]ßñï9ò*›ÐAÇpÑÜ`oBÒb‰„’ÌàZ¡!M[c¦@2+.´PÌØÒ„–ıq“q&Å1šLIqLZ …Ö–‡OmËq:ÀtdsÑr¯œ›rƒŽ:íÌZ¶txž³Z,ËR¬?û<ç|ξ^ž£={vWZɺxÏWßç÷ Šó·:ÔÀË4!û¹E Ùð€­ –ê^kçgB64`M\.ErȆ¬W€MÔÌëö“Ç랤;~m«ÛG{ÛêþZ?Y`¹¸Tí0sOÓX?RÃåq\;\&°ö\ú²V0×Øá«F·Ô°~¯‰×7ÝÔ®f{ãpÛòòäÄÚšSs:5u˜©I=6y¾nšÇiìÜM`M]æÀ ^×Nck¸üæm7vŽv4.-|RõQiÌ…Wµw8\Þ19¹ü'Ukk5æd…`´2Ø^5OV €yôÌäx];+Úµöx¬¥:Xâ`ž½®8þYÛn5c3]!nÝÖ¼ùŒ•€¯nþùþG†Û–k–§Ì,`‡K£»'ƒúPdzóƒõ½Øµ/× Ì`v4,ÕýŽÈˆwÿäøô¨­^oCÛsÀN/Öjo»«X›ˆ½¡Ï‹»z ØÅ9i`åÊo«;ßX+W\Q++W43åuå•Íóæ±þñ+  µzäÙ;ÖÌ(×Gš÷WWŸ­CO==}ýðá?¯Ðë =ln¼¶±ºûš«kW¬»w_=Ö6X6CµmÌ>üt=þÄ“Ó m£7PoÛCÀfÅk§;¯ú®Ú{Ý»êúæaš ôm#h?÷Û¿Sžøjé%b;ØœxÝ}Í÷Õ¾o]ÿîw™°s£ÐîèázàÁ‡kÿƒ_ªGl‡;Š×¹½`k:i½þ]uËÍ?-Z€¹×®<~à+uÇŸ˜÷5ƒƒ§"¶“Ó : ØÁe£ûkX3¿SÃÙ´ÓÖÛ>ü¡ÚsÍÕ¨ ÙÛï¼k~W &õØäùñµÕNöÔM n­9#\€E³ºzd²÷}þwkÞ &u÷ÉçÇ?W›lÓ¶½=ì¤ê£5G„+°èæ4d›™fÝ~òøøöÚD›°ÛG{›Ÿðþší ¿õÙß®À–qÿþ/ÖÏÿ¿ž§ÙI3ܼ¡Ž¨M²­6Íhe0¬?l’x¹f¬½ 냿pkÝÿûÿÉ1XÀ–òwßðuËÏþtµK¨‡ŸúóZ[{®flÐ 8°N,¡jmS.êÚ¤ ìôă5Çeµë÷~öß W`Ë{fõHÝô“7×'ž¬9Яõ¦Í8™`S&°Ã¥å7)üŽš¡vêúñ;o«OÿúÝŽÄh\>MϹ߱ã›ëËì%ì`i¹×7ÔŒÜýÉÕÇïüh-/Ïüº1€¹÷êW/×;ÞþÕ^à5à ¼z0¬urí¾ºH°íy¯M¼î«hw\¿ôÐÔþðfÏî¿_W]õ]õG<:›S µR—-«k\á"w`G+ƒ¥:Ø|õ¨zÖî¹Þÿÿ±v^õÆàâÍx/öè©S Vë ë" —ꣳŠ×öb-ñ pé^·reý÷?zpVÂ_Þ D«.Â…ìÒhßdP7VÏœ4°ùf±ƒÚÓÞɵ.ЮÌæ†â [3\'¸à\Ðv¸½n)ñ °pf8‰}]m¯[/ä .`;Zi¦¯ÏTÚÓþìOŸ¯=9xø©é$v<>V=º  ºÎ{;½p«g¿õ›¿!^zôÝ;¯ªÿòŸ?_=»¼iÍœï'Ÿç9°£•º¬ßÛÅÞöáÖOýäM@¿Úu‚;¾¹¾üÈ£Õ›AíªË÷ϺÎ+`‡KËŸšþ¤=¹ågjz‡-fã-ßû=uäÙ¯×áÃOWOç{‡®óØíw÷µ]h÷^ÛýWfçèÑq½ù-»û<™`29^¯¥]ØWÜí{÷µ=q@¼ÌÞå—¦'ôØfƒóÙ…}…‚~w_ïþäÇêoÿ`>\>Õ«^µ½¿}Øõ]Ø{ªÖÖÎõ)ß0`ûÜ}Ý}Í÷Õ§ýî`¾´û°žøjég•`ÐêsubíñsÂ7úêí£v÷u¥:æ¼W€ùÖÞ©«Ý‡íé|Ø£§vaÏz"Á¹w`—Fûª§»nµ§ˆW€ùÕ­uËÏü³êɨ^UûÎõÁsN`K£ƒ}¬´áúµ¿8\Ì·ÉdRßþ»ú9•`RMž_{¶}»4ÚÕ×îë¯|òcÀü õ~ó׫ƒÚS—öœíCÃs¼xkõ`ßûÞS{¯{WaÏ5W×îæуAóßõgÿÀÙ^ìéâ­vuÀî+@–Ç|¥ÞööëªG'ÇÇßræ‹/ŸÀ®jWªcíôU¼äéq ;:ÛÁËv88÷_›é#þP§Ý…ýÈ/ýËêÁY×^°“Aí®Žµ7-0}ÈÕ׶iåÏ|í¥ÛÓúÀm¦¯ÑzœÂ¾là¥;¨½Õ±vòº§Ÿ :Ô6ÝÎo¬Ž½l`øÒv¿>pÛ/}°È×Na÷þ£X];³QO;Fk´2Ø^ÏTÇ°8Ž×·¾öuÕ±Éäx}KÕxܾóâv[÷wÞºþºwŠW€2íèçH­¥W]ÿ&`‡Ãî÷_÷¾Û]·I»Fpãû~´:Ön ì<ýõ'K£ƒÍ{Naÿê/W§•Àâh×¾ý »šà?Vzfr|üúöÉ© ìhÔu¼¶g¿ŠW€ÅÓ6ÞΫ:?`eÚ¬µ°—u¿ÿºï}ï-O»Fpý»»?`£Y׶‡ ¸z8# €¹þº®uÚvZÀ&ÝžÿÚž<°KÀ,¬¶÷:>mjP“ºª}²>t{ûØ;¿«Xlí5O]j†®§­t|—[Ç,¶vvçU-ëC×a-Vªcö__CËQÛ®Ãz¡ÛõÖ®«,À¢»²;®6í:ÜÅv¥¾:ÿ`ñµÍ·ÒuÄzØÑŽo.¶†Žoh0XØê6`­l++ßV»b8¨êôß÷WVzØ…`æÚ“®¼¢ó€½|X“U‡zYæ`.t~íÓ¤v´+¬ ¸¶Ž+¯èvx98uW§»b °eô±>Úù l¢Ñ`°}4©|îh°5L&“Ú¶ü-Õ¡É° ˆ€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Š€ Ê°&5®­y¶Øzh¿ñ°Ý,[DZñ±êظóX€­ãh×;ivR«Õ¡#«`«8v¬Û€ô±B0>Öù€9Ñù¿¾êØ°©ØN sÕ`K˜L&uäÙ¯WÇŽ¶;°«Õ¡Õg,ÀVqèðŸWÇží|öp÷¿ æDÇ;°“¶];Øvb<¶ °èÚæ;tøéêÔ4`/ë6`[ŽÒX|Çkë²6`×Æ«]ßëÀO‹íðS=lÓ®72X­î£Æ˜™ö‚OüêÔ¤µo¦;ÔáêÐãO|µXl]O`›f=Ò¾]ŸÀÖk¶+í¬=X€ÅÕþ‹{ǽ7išõ@ûd=`Ot°­ý>\,¦C}ì¿ž8m… ^è>`xðKÀâi÷_ïûüïUçN5ë`ãýÁöÑ3Í›•êÈh´£¾ö¿Oß°8Ž×·¾öuÕ©Iœ],†^î¸Ú6ê©xm _ú±õ³µºôÀCN#XíúÀw~¢ºvf£ÏøèÕ±öÛÇû(u:õø'û¸YÕ¤Î8l`pæg –FG›WGÕ¡Ý×\]=òP©¾^ûöëúX!xfr|üúÓ_žù͈ö¾êXû5…ÈÕN^ûØmÚôñ3_žå³:_#hÝþËwyúÚ}m©:Y¿}拃³}fk­Gy¨ö\su£§£³¦¿Ô™ë­áÙ>³5‚–),@–§¯g]h ÏñÙ½¬Ø…ÈòÀƒ×}ŸÿêA{úÀ¯žíƒs}Å`iôXóÑ=Õ±•+¯¨¯ýÅá`¾µÓ×vu ‡£³Ú|=8y~ü¦³}hÛ9¿hiùò¦nßQ;6}»g·]X€yÖ®îïç¦TM*×/Öɵ³N9çþºÑh°TÏôq1×h´£þìOŸ˜Nc˜?í…[o~ËîUÎzñֆṿn<ž êžêAûñþŸø™`þ´«7ýÄÍ}Åë9/ÞÚ°í}°N,l«UŽyv:‰}ë[þ^0Úx½ç×>Sÿþ³÷VO&͈õ†zam|®OÔ+Ù>ú\óI7V¬Ì—¯=³Zç ß]}i¦¯÷ÖññMßès^9`—G+ƒ“õLõ¤×6bÛ˜`vŽO÷^{9u`Ýd2¬××Úxõ}Ò°^IûL¾ñÂfjÿ€>ð/þU0;íêÀíwÞÕg¼¶Ó×ϽR¼¶¶Õùؾ|`0©[«'‡ŸzÚ>,ÀŒLãõ—ïªOüÛ^®çÿ›_ö•v_7¼ò Á†wa7<úÈCµççÃôéþý_¬úá÷UŸÎg÷uÃùl» {¢öq.ì†v ûè=T»v¾±è^{ÑÖ÷¼uOoGfr^»¯^yvCóöu.ì†öî†üc½î^lUíÍ ~à¯ï;^Ûéë篭óŸÀNFƒíͶj¥zÔžLЮ8^  m¼¾íí×ÍbpøÌä5õ¦¦š_q÷uÃùO`§Æãɉú@õ¬ýƒ¼ö¼Û$ 3Œ×éõb¯­ œÀžú¢¥ÑcÍWî©ž™Äl®Æë]¸uº œÀžúŶÕû›_ñ‚Jy3˜ÄlŽ&ëÐá§f¯Í7p´)Ñ;ê"\TÀN/è6ãÞhÿ€ßô½×Ô>\\¸ößíØÿźvVñÚ~ƒúÕ ¹pëtçw#ƒ³9±öǃáòžô{AWkmí¹úÂïÿ×j7 öìvN,Àùjãõž_ûLý“zó´©fó=Ôcõüøýu‘.>`[íºNÖ¾¦#—k<ñdýßzë÷~O-/Ïä[ˆqôè¸~úæŸïû[/Õ®l«wžÏ·Îå¢.âz‰WnLêîš!wœ[;uÝ8ãuÆ×µßÊû›éë}u .nötÏ?ÕN¢k†Úÿ¯ÿŽÍ8üÓÀ‹6VÚ»kÍúBøi3^b¼¶.};5›œÍîk®®{?û¦±À–Ö†k¬7ýÄÍuà+OÖ¸àœË¥O`§ÆãÉ°¾Gk©Ý‹mO)¸ý—ï*€­hzw€¦…Þü–Ýó¯“:Ú´âµ›¯­MšÀž²m´w°­î¯9ÑNaå“«½×½«]®xrzÂÀ›ß|WuC?P›äÒN!8ÓdíÕ¶åASÅ{jŒ›·uäÈ×kçÎ7Öh´£ÍF¸Þô“7×ÿæ®iÍ‹&^ïhâõ3µ‰6w»aiô©¦bo©9³ï}ï­|øƒöc€…°®wÜù‰yÙs}‰æÛûT=?þ@m²n¶ý‰—Fµ÷¨9Ô^èuÛ/}ÐM€8“éó®­æû¼¿™¼ÞPè,`§',U±»jNµ“Ø6dw7!k* ̳vÚ:›‰µÿ‹_ªÃ‡Ÿ®9vpòšÍ»hëLlcy´28ÙDì¯õJ®¿î]µ÷Ýµ+ ̃hÝÿàÃußçon§­gxfzâÀÚxµ:ÒmÀ¶‚"vC»b°ï}ï™^øµ«yôez~ëê³µÿ¡‡›ÇÖ᧞žFlˆÎãµÕ}À¶#vC»ZІìžk¾¯v^µ´&´Àfiã´=òª=Ëþࡧ뉯|užŽÀº½Äk«Ÿ€mGì™Úm#vWóveåÛêÊ+®˜¾?}ìØѼfŸX×NS§o›(=Ò<Ú#®VW¿^«Ï>;Ýc Õ3õ¯­þ¶ÕF쉺ž/ìà‚lâõ†¾âµµI·’=OÍolò|}ólÓîÄÀL´ëºMOè1^[›{'®ó²¶V'Ö¾PÃå˃zk¦×{êùñ{›´[«žÍ `O9¹ößæ鶳œ—¦]ëö&^±f¤ßسÙ6Ú;Ö½Íw2*æפŽNõþ:>Þ_34û€m-Ð  ¨½ƒm{ÒÀÛúÞw=›~/â:—öâ®ãõÝÓ] æÉtßuòšzó<Äkkv;°/³¶6Ý‹.™îÅj¹˜ve`X¿XÇÇ·Ïâb­s™‚3­ŸÛîÅî)úÖN]oF7ÍËÔõts4=Í kãf{ßô”‚Ií2èÉ‹S×>m²94Ÿ»áÄÚãµ}ù ÍäåͨØÝ»º³1u}g=7þrͱù\!8›¥Ñ¾Á n+'l¦ö„Õæ‡Ìúx¬ó5ßØÓ\;T'–ïk¾ãçÜü`¬ŸëzW½¦nªÿ?>\!r&°§[­ÔÉúhóÍßX\¨önZŸ«aÝ1i½’Ì€Ý d.Ä\Ÿ.p¾²vƒ8—É©b'®gZŒ€ÝðbÈî.{[Û¤ùo<Ô=õšæ1Ïå‘Xc±ötK£}Í· Žß¶”õ5ªê›ê·)\7,nÀnXµ7B¸ÕTX`ëÓÖaÝW'šp}a| Øâìé.í©aí³ÀØRÑzº­°§kcv[í­“µÛš`ýb¬Ijr¶Z´žnëìéÚ‹¿žo"¶ ÚIí´ÀŒMN{²ÚÛþfèv¨¾©y»€;­JÀžÍh4ªÿWíîìÎ汧ù›³"j€M69ã½ñ©X=T“éã©ú[Í[Áú2öB´“Új¥ùS[T]ÙŽLߟ4o/kÞ.Àù¬}ùk“»ªÊŒ?cIEND®B`‚ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/android-statusbar.png000066400000000000000000000050601425441362600313170ustar00rootroot00000000000000‰PNG  IHDRî0N¶ÿ¼tEXtSoftwareAdobe ImageReadyqÉe< ÒIDATxÚìÝH”[ÇqM3Ó«£ŽîØ­›¥$©ii‰^¡YåæÆÞ´ö Kä’°lB‚Ûòô^(‚%¨è‡ AkjEr+réŬ  ¬µMÌrüusòÇ”{¾îçÎèøkš¹½_ðà3ÏsΙqœàóœ¾sOo<¸4O‚;@p@pîîîÁÁÁ ¸À%>n3 #z½þ§ææ柺ººÆFGG?¨mâ×ò~dggkkkk Î|ΙfØg ¼‹ý›â- Öýüü–¬\¹ÒgÓ¦Mš7†iµZ{íU€÷’MõY°~ýú°¬¬,ØÇÛÛÛûžIIIšÔÔÔðéº#–-[¶466V'ÛÐÐÐH[[[_}}}oGGLjÑhüàŽ¡Oîà“ ö.,,Œ ô]è±eÌÍ›7ÚÒÒÒ[QQñÒ]Â;¡ ‰/§€y‹÷_ŒÐnÉÏÏÏ'11ñËÈÈH_wxOíöUWW'ÔÕÕ¥µ¶¶æuvvî“Í‘~ÒÇ`0”LLLÜ6oòXÆ›ËëxðàAæàààæ±L&SuwwwQII‰nº~r^ÚI{Ë~§OŸŽZÌ÷w0o>ÊÈÈ\±b…f1ŸG…£Á¶¶¶w„v÷%A×úØÐÐP“û¢ðððLÙëéñõõÕ…„„¤åä䤩~<55µnŸ¥ãÆv¾‡ýýý#åØÑ£G3·nÝZš™™Ù`ÝOÂy~~þ÷^^^_Èëî×!ýÔñ¯£¢¢NØêGp.A¾8zñâÅŽ¢¢¢ RŸnyNœ%«W¯Ö…*ÁÁÁá*h­QAGãééé£Bœi||üêoPþÛßßÿZªW===ƒ6žc\žÃÕ¿¤JhŸžeH—Àëã㣛©OSSÓ·Œß¿ÿöúõ륹¹¹MÖ<%%EfÊ›JKK{fOfúg/==ý€z8%€ïܹó shõêUºP=n>'ÿk >çßJ?Õ®©ªªêíB¿w, ÌŽ;~“••)û*üÇÄÄlÐjµ_|¥ÂÎrGÆx÷î]¯ w/UjniiiWAÝ$ÇoݺÕqõêÕ×îÚ½¼¢«/)zݺuyæ5Mñ4†ÿ€ßÖÖv)::ú’õy)U‘0ýôéÓ3 ׸д;ž„ó+W®TË~MMM±e¨— ˆøøø}2Ó®.Pÿdo\G_ÇlQãŒk½^ߧB˺mÛ¶ý9**êwAAAÑŽ†v±|ùòPN·)99ùÛ·oÿãš5kÂeLwí˜;ó¬¼ Î6Kj¤\E~úúúNYÍHjÑåâ@6ËãRf# wïÞ½o=–åL¹úO©ˆˆøZ~ª‹J›%9æãæv R° ÎŸ?¯ÏÍÍý­···ß|ÆñôôôÒh4‘*øɘ„öÏ—Ì|ËÏÊÊÊŽÙôS¹['3ú??ü8³>Ýì¾¥¾¾¾)e7RÚãH?GÛÜÀ'ÕÓÓ3^VVvãÔ©SëÃÂÂ6Ìg¬7oÞ<;qâÄm“Ðþù²,W±&³ê“3ãöfägüBÔ¿?~|ÊŒüLõøòüêBÁѺ}‚;p UUU¯ÓÓÓ+÷îÝ»R…˜à¹Œ166Ö¯BTååË—_ÚaOaaáäR’Rúbð~¼mºþ²JLhhèd‰ÍªU«t[¶l™ïÑ£Ggã ¦wàrŽ9ò$11ñÇÔÔÔï<þ¿ ÆlL466þ(c¸êï÷øñã=*ØÕ»òß ¬¬ìïóé_^^¾Í•?ù²¨,)³ãêïÌ\Æؽ{÷>󌽙|iu6KK: _N‹¢¿¿ßtàÀ]]]fÛWúH_ÃUC{RRÒ.þÊŸŽÜÒVúH_B;l‘òsI‹,½8ŸÙqé+KBÊ&벟;wîor\ÖdŸëY îÀ-;v¬¹¾¾þúÄÄÄû™ÚJi+}í°Ú-o‚´Ðë¥Ë̽ù&QÉÉɳZÖQjä îÀmÆEEEuz½þß3µ•6ÒVúÚaMnŽ´gÏž[w. ™I—MƳu~```²ì&(((Êò¸å]_m Ñ9ÒŽà\Ö³gÏŒ'Ož¬Tæ?öÚÈ9i#m í°Ú+**¾—¥%Ï5´‹œœœdÛµkW¤­óæÀ®. {¬.B'kµZ›ýt¶úÜ€[9{ölç;w®˜L¦_s9&ç¤ ¡¶Hh÷óó‹R¡¸=??¿ÔÑ°ož]·<>666¬ÓÓÓoÝGJqÌ«ÌtvvN™9¿wïÞd-½¬d#í,ÏÉzòááá™–íš,Íô à k×®]V[[»7..n»åñçÏŸßÈÎÎ>¯×ëGÝ)´:t诳¯¼¼¼Í™¯bbâö¼‚¢§ç¢.ÙÚÚš'+¸È útw3•^äË¢²ÿâÅ‹k£££ÃöÚ^ºt©®´´t2˜K`—™uëߥ®®.-##£Döûúúÿ588ø6:::*66ö;)Å‘ ÿ¿XßÝÝ]$]VŸ‘Õl^¾|Ù#µí‰‰‰yò¿2žV«-]Œ÷‹uÜ€ÓH0?|øð• .D©p'Ç Ãs9æn¡ÎcYknðö$$$È,ù´¥*™™™ *¼—¦§§ÙsâÓ,ÏKýüþýûm® /%:êBâ­¼Ž”””"µ}<'¡½  àÄb½wàT7oÞ4\»v­*///\˾#´~dv\‚vooïðtíäæJ滛Τ²²²Ãj¿Ø^xW?$À§EDDLÖ¬ŒŒ WWW7˜gìíQíÏ”””\ÏÍÍMóõõõ—~ Ms]KÞQ”ʧS!Ì»¦¦f‡ìçää\UÁÍen´4›ÐN© œ‰wàtÔ‹‹‹o™÷Ý1´ÎÆŒ;@p@pîîîÁÁÁ ¸ ¸w®é _÷ŸHñò¦IEND®B`‚ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/app.css000066400000000000000000000035341425441362600264610ustar00rootroot00000000000000html, body { height: 100%; } body { -webkit-font-smoothing: antialiased; } h1, h2, h3, h4, h5, h6 { font-weight: normal; } a { color: var(--font-color); } a:hover { text-decoration: none; color: var(--font-color); } ionlab-app { display: flex; flex-direction: column; height: 100%; } header { background: var(--section-bg); height: 50px; line-height: 50px; font-size: var(--font-size-sm); font-weight: bold; color: var(--icon-color); } header .icon { display: inline-block; vertical-align: middle; margin-top: -3px; font-size: 22px; color: var(--icon-color); cursor: pointer; } #logo { display: inline-block; vertical-align: middle; background: url('lab-logo.png'); background-size: 100%; background-repeat: no-repeat; margin-top: -2px; width: 64px; height: 28px; margin-left: 15px; } #header-left { float: left; } #header-left .menu-icon { margin-left: 13px; } #header-right { float: right; } #header-right button { display: inline-block; height: 100%; background: none; border: none; outline: none; margin: 0; padding: 0 10px; cursor: pointer; color: var(--icon-color); font-weight: bold; } #header-right .fullscreen-icon { margin-left: 5px; } main { color: var(--font-color); display: flex; flex: 1; overflow: hidden; } footer { width: 100%; border-top: 1px solid rgba(0, 0, 0, 0.06); background: var(--section-bg); font-size: var(--font-size-sm); color: var(--font-color); } #footer-left { float: left; padding: 14px 0 14px 15px; } #footer-right { float: right; padding: 14px 15px 14px 5px; } #footer-right a { font-family: var(--font-family-medium); margin-left: 10px; } #error-box { width: 500px; align-self: center; justify-content: center; text-align: center; background: var(--section-bg); padding: 25px; margin: 100px 0; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/favicon.png000066400000000000000000000102401425441362600273120ustar00rootroot00000000000000‰PNG  IHDRÀÀeœ5XPLTEO¥ÿB“ÿ4ÿP¦ÿA‘ÿP¥ÿ5€ÿ5ÿP¥ÿ5€ÿ5ÿO¥ÿP§ÿ4ÿ5€ÿC”ÿP¦ÿ4ÿ6ÿ5ÿP¦ÿ5€ÿ5ÿQ§ÿM¢ÿ7ƒÿO¦ÿ6‚ÿM¢ÿP¦ÿ5ÿ6€ÿO¥ÿO¥ÿ5€ÿQ§ÿP¦ÿP¦ÿO¥ÿP¦ÿ5ÿ6ÿN¢ÿ7‚ÿM¡ÿQ§ÿM¡ÿ4ÿN¢ÿ7‚ÿO¤ÿM¢ÿ7ƒÿ6€ÿ6€ÿÿÿÿP¦ÿ7ƒÿO¤ÿ:†ÿN£ÿ5ÿ8…ÿ6ÿ5€ÿ<‰ÿIœÿM¡ÿHšÿ=‹ÿF˜ÿJÿC•ÿ4~ÿ:ˆÿB‘ÿL ÿKžÿKŸÿE–ÿQ§ÿG™ÿ>Œÿ>ÿ?ŽÿAÿ@ÿB“ÿA‘ÿüþÿþþÿîöÿùüÿõúÿèòÿëôÿðöÿæñÿ÷ûÿòøÿÜëÿ>ˆÿG”ÿûüÿßíÿãïÿÚéÿQžÿ¿Üÿ·Õÿ§Îÿ¢Íÿu´ÿg¬ÿB‹ÿáîÿÔçÿÇßÿÀÙÿGŽÿÊßÿÃÞÿ•¿ÿ]©ÿl¦ÿ[¦ÿW¤ÿS¢ÿd ÿKšÿJ—ÿºÙÿ¼ÖÿžÊÿ¥Èÿ”Âÿ„µÿz¯ÿØêÿ×èÿ´Óÿ®ÍÿšÉÿ}¸ÿˆ·ÿO¡ÿJ‘ÿCÿÐåÿÉâÿ²×ÿŠ¿ÿ„¾ÿqªÿX§ÿT˜ÿÍäÿÌáÿÆÝÿ¨Ëÿ—Èÿ Åÿ‚ºÿy¶ÿ²ÿ`«ÿa§ÿf¥ÿ\›ÿÓåÿ°Ôÿ¢Êÿ“ÅÿÃÿÂÿ½ÿq±ÿj°ÿu®ÿv«ÿažÿM”ÿÏãÿ«Óÿn®ÿZ¡ÿXœÿP˜ÿùûÿÞëÿ¶Øÿ®Ñÿ±Ðÿ™Ãÿ‡¼ÿ‹¹ÿ}³ÿ~»ÿV¡ÿoƒC8tRNSJÝ âëãòÝ››ZëvnGØO ôôôñÖÑÇǼ¸¨§wo\W&&Ñ””ë¿»¸vlE¸·:^ôŒ ¿IDATxÚå÷CSWǃT­ÕµµÕjwk÷†RZj%ÕÒV›E&+!„a$ {ï½÷T–"ˆþ[ ˆå¾äÝ——{ï£yí÷gïûãÜï99WäCÏ|süã7N<õã¶BŸè·.lëò¶¢ÜúÝ­?ܺqãÆŸnýõ×ÕmݼyóçǺ¶¥Ÿë7·.mëâ¶"¶$qëW·"Ý:ùÉ‘3Ÿ}ôuÐ!ºöŸøòÃï·ä~ô=ˆ ¬Î|ô”E/¾}Êýìÿ>€['ß ù©—»ø!G áƒ§Ï  äÀû°ç„à™à0¡„a˜/¼&€×¼×¢ç„ò¬×þ&,€mßa¡¼J_L?@È›ô$<€³@ô´ìqŽ…  äÎ… pôÉ+8~E˜!ïî àÈŽrE¨×»-o à­í5ô°p^ÙšÆ'®¸q5vehsj¬<±Ã ’«å}}–)ÉÕ»¸”—÷Y€í1ôA€?bW²tYU£Ôõ£®éGF’[Ai01€…ùê5åC ®ÅG—H¼ä>ˆ]!°04•®¦8IÑP4ýˆ ÀõC¢‰ WÊ)?¤µŽ[òH‰ŽáÔ ߢüVêh²àÑs¸Q-å IòÄ^#.À³¢70ZL* Yʬ¦<€OE§±œåÑ–¢-x/‰bdô¤RxŠï3âF(‰£ðT6ˆ;^]A¨­PS˜JÜ]…$–Þñîñæépÿ®£\h1H)ÉäwÝÐZRWWÒš)ñ¶^ÅðÓòÅ–Ñs™N©P(´ºÔ;3‘{pÙ¦¥ ’*4Ö®Ù+±;ºûS~¾Ñ²1–•ª‚ŒMO6²³ZºûûÊÆÞL2ŠQ«òÌžÙ|X8·XÙ©RP;J¼¸0]æ/= çÀɼñ*TVÛ²¯óÀ’+ë1ƒrp'”¨RyG“|\(eܺticNnšÁ¢45E%íÄB}LŸ¦hæ æ‚)Öï,©óãDÖkM|–1‡3|¤Øe禿GJKÞ6€äŬ1?) ëafÉ Ô3ñ4, W4óÃðü ¶äC}„™‚©Û*å)Ó†+áÐCT3<mkœDsd¹£”·[IdÓßr5÷$ßÍü••üXI¾\³ÌëÿßJòPSNÿS8´mŽ™¬#½ÞÖP´±Ä’¥Œì§ï1ã¹$|!È HurH³.MdjtÀÄ—ê¢o'YàiVûø.B´ÙòÄ™kˆ© @Ù|æ‰ÿÜ´ÊŒ‹8]}S,O‘“\YP_–XTe¯ùǽÓ0@À©¡`j}ÔmŽ¬B³{ú©-ñÑŒ 0G*L W É `}à2Ô P .BN0‚ÆÀ®ã9d€ Ðí΀,$ È!¹ñ Ë… úÀ¦@Q×S»jG( Q@Fáœì &¬¬CGw:  œÂP  Œ9@Câ>  «lQ žîdÈ`Uh j«n4šî*d¸…2Ôpìp'“#€®n V ±@ºÁôÿ`†Ð ¯C(A蓘Ó2jÅ0pYF£‰ld…0@;l#“BÈ Ù“ (–bðJÜ_6  DÉG0×N$˜ëg,œ^Ñ ¨“ù §AkZ:;ÐÜÆX„$€V9x !s¤ì‡`LY"ìHI+Ǭ$s¨ïÌ#Ÿh´½0€n2‡úZðE¦C0ÆPªÐHJF7¶2Á¿¨VPH’&A­4p³£[‹]à’ç„ÔÝEPåÀì ÕdE·龊 jîVË’ ænSøc!èN)°d¤CêÒ¼Ý\(À=ð?Ò„“àˆÿ`-4Á‘­E˜Ð‡ü³ÚœL(ªá)¦bÿá)¦‡ 0hÅIò•Pà‚Ôú½”&8àRp äb¥Y•àjƒ§Yçý4åÉð4kN*è!^¢t}âl,‰îRÿ¾S?É’èžÔ‚o /Ñý£VgÂU¢ó#7Ó}‰À ®A9xµNð±tsp7šó1 ;¥V"YN„ð2h)øBÖr›ÒhŽ‰™IÖÆà Ð[ðè›1¥ja-xªçtHþ­^h&¶[‹q†iŽ‰½·ÊB…Ô÷1x‰½äl|ê>ÜŠ-z@G©çØ‹þ®–dìËÿ†¢¿dÚ 5«€¹î5=ÅGÙe¬+!=D›>ÚóDÞ£ýÂd8>@Š‰ö‘Õ> _ó]·t ¯A¦Ô=òÙ ©YG³H”Ï)iu>ËJgË *-má”ë zó}wxr´Ó· ÌÚi¦ÂEªâ2§âïìõrë­»©Mj¼¡ÃT4›Ï¥EU¸™•6@¦üžþÊÕRÎå÷±+KƒƒKÆ|Î=¶úäôý.œ €Çwøôm|5 k¥Œêx»rÊ)úJÄ€¤‘ð5‘û‡wÕÃÀ8}íÊ“¨¥ûÚ~>ªèÁ œè7ºûWéÞB`&šq›ÃIÄÒ_¯ÆIÀOÑ”ÖJ¶)À‚‡‰~w˜,€ÃÙQ&“nŒáY™¨& ãñüÒ¢HÒ¡žÎÉ]'9»§3–UC¾·JJ¦g’ºå2!€½§mm磻M›Æ3AÔŸB ¢*šòœü4HÊöôëµøF—ÒËsá«Ã“wBÒ´Œ àØÉÓv¾B½+,o•Faôyû5ü5 ‹éòöØŠ—ÑEÞ^RVŸmÚR*(/”Ô!ô¶3TÑ9øí3—Á@ -lAX41˜‘V;ßò2º˜’-÷³ý°ÜaÊðgÙå 4eɼҔÏú0=ÊhÇ7:$ü„^®Ö2:þS+ÜŒMÌ}‘¥æ\ ÿn]˜cvqµ©å›±¾.õ­Å+!žo„w€ w@¬7m¼éÁ2`i£\¯”Â<_‰dÏÜ‹,;/“êÒÊm³m±[º¹õô±×®mu‹\tÖËãd°”G¢H³îE»ÎÖd€L­ï(\MM¹ÖÇÖ :ôrVÓWY)‰@Cm˜:œ®¥IQ?€Ósw*"¢h³£em0FÓà¶û* [ºÄE¬¦ÁbµmžMWRXŠkoÂkÛŒÛ8û’ÎU ]õ㹘³ñ[—×– ¾iǸ»u9‰æñ ³(ý¿Õ‰ÍãÉ´ïÏZ÷³Ú£,i:—Hû~b(´µpïá¿Vå¸Hè‚WX\mkYÏRûLÓwŒõ9òˆ]aAø‘ºüåÒ‰ôx$¾Ðd™{yD/!K]lþPéT±Éš¦×¨ärµ\¥‰¿ånò䪲óòy¸Æåe¡_¤#ø«Œ„™”p¯ó:ð_¹PMðWÚ þRAá_ë(Ì‹5ßû/]m*üËe½¯ð/Xþׂ¿d\ø×¼ ÿ¢}÷bzZ/íAõÌëðÚ!‹^ø8Ð>zAÄ®‡àÕ³"ŸÚ÷m༹OÄEÏ?˜Ί8jÿ±ƒpô«ý"îzùxp`y÷)‘ŸzñíSpò­ ŠöŸøòÃàÌAO‰ÐõÌ7Ç?~ãôÁS{pò“3Ÿ}ôuÐ!»þ–ÖühðêYIEND®B`‚ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/fonts.css000066400000000000000000000113721425441362600270310ustar00rootroot00000000000000@font-face { font-family: 'Inter'; font-display: swap; font-style: normal; font-weight: 400; unicode-range: U+000-5FF; src: local('Inter Regular'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-Regular.woff2') format('woff2'), url('/assets/fonts/inter/Inter-Regular.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: italic; font-weight: 400; unicode-range: U+000-5FF; src: local('Inter Italic'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-Italic.woff2') format('woff2'), url('/assets/fonts/inter/Inter-Italic.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: normal; font-weight: 500; unicode-range: U+000-5FF; src: local('Inter Medium'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-Medium.woff2') format('woff2'), url('/assets/fonts/inter/Inter-Medium.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: italic; font-weight: 500; unicode-range: U+000-5FF; src: local('Inter Medium Italic'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-MediumItalic.woff2') format('woff2'), url('/assets/fonts/inter/Inter-MediumItalic.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: normal; font-weight: 600; unicode-range: U+000-5FF; src: local('Inter SemiBold'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-SemiBold.woff2') format('woff2'), url('/assets/fonts/inter/Inter-SemiBold.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: italic; font-weight: 600; unicode-range: U+000-5FF; src: local('Inter SemiBoldItalic'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-SemiBoldItalic.woff2') format('woff2'), url('/assets/fonts/inter/Inter-SemiBoldItalic.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: normal; font-weight: 700; unicode-range: U+000-5FF; src: local('Inter Bold'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-Bold.woff2') format('woff2'), url('/assets/fonts/inter/Inter-Bold.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: italic; font-weight: 700; unicode-range: U+000-5FF; src: local('Inter BoldItalic'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-BoldItalic.woff2') format('woff2'), url('/assets/fonts/inter/Inter-BoldItalic.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: normal; font-weight: 800; unicode-range: U+000-5FF; src: local('Inter ExtraBold'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-ExtraBold.woff2') format('woff2'), url('/assets/fonts/inter/Inter-ExtraBold.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: italic; font-weight: 800; unicode-range: U+000-5FF; src: local('Inter ExtraBoldItalic'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-ExtraBoldItalic.woff2') format('woff2'), url('/assets/fonts/inter/Inter-ExtraBoldItalic.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: normal; font-weight: 900; unicode-range: U+000-5FF; src: local('Inter Black'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-Black.woff2') format('woff2'), url('/assets/fonts/inter/Inter-Black.woff') format('woff'); } @font-face { font-family: 'Inter'; font-display: swap; font-style: italic; font-weight: 900; unicode-range: U+000-5FF; src: local('Inter BlackItalic'), url('/assets/fonts/inter/Inter-variable-ASCII-subset.woff2') format('woff2-variations'), url('/assets/fonts/inter/Inter-BlackItalic.woff2') format('woff2'), url('/assets/fonts/inter/Inter-BlackItalic.woff') format('woff'); } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/ios-statusbar.png000066400000000000000000000061111425441362600304670ustar00rootroot00000000000000‰PNG  IHDRîÒ‹¸œtEXtSoftwareAdobe ImageReadyqÉe< ëIDATxÚì]]ˆ$W¾³6 l%ad³­ˆ Øc@!$У>L|Hz…ˆÁ„íA#bÀyˆúèž7}únݪ{oUuWõœÝ]uÏí[U÷žóÕ¹ ÃáP‰ˆˆˆÌƒ,,,¼ÿmÿ$ÚúèDH P¡ï½ .‰ç×ìÏû3Ÿ$"¢²°EÒ¦çTn’[P¨†xà8à9ëŽÐ¹wÿ#ÇýÀk€+Y6”¸²ùæ—e^""iETspŠØ;€&W³¤mVÉÖ² X <Šyœ¶ä×£üzyué€ç±ärÎã‹ÄYºÆ8ÝmÀIÇ—”ö\ÚðÜÖ¥6‹øúÞÞCÈoˆ~^~-Ë|ÙµÔésài›‚ôéß BÀõô2¾äHÏ|¸ÀÕsð<àIâsÁÏø4õÙÛÀÇÜG¿oÜBÏè}¿ÎÝGi¢ß y iꊈäMÚÓŽAÚmÄÓµ#H¶"ýƒ8»m[~u:ßt̯åñß¾‚ùnÐõUbÒ5U‡üNKíÉÂg%óñYIú³ôs@\ë€=À‘V"öȆ v©ýÖmSˆ~¥ëRy›1å\Õ×p±]Ïip+ñ¡¢Ëõ-ÀWO§}îBÜg+< øàh€þQÒ}˜ò*ä[¾w‘’‘ö9%W²©Ë°¢FÑlŒ0÷˜ÃÛ Ú}–b›¥ë$eM˜Wé{/å­mØ4s'Aÿ”)hH ™–mðµQiféÛ€ÔvÈNUÒê€@T/^Í!ª_e¶í×Ò߀25"ÊY#ˆ²÷·ïp+|“^ ~§FÑìa€åù=•ïk€Ç3{Cu…ˆÿ=‹¸‡÷¾aàë€eÀ'‰”ßJiÓ÷£tn™Òšú÷SÚಥ¹¶¢ü‡@bËèX‹Ü]Š$q#lÊß³8Ð]¦ëBL“òë²ü’-Ï«Êôº®¦.溵Ãæiª]}/㤡Ӓz*ÈÚ׸útý¼}[TžÔîvX;Ñí|“ÏKÏ_ú놲+Bõ[Üæ6¶QN}][6¿Ü ¸P0Ânâ•s˜–S¦‰¸ß ¸x— ò.ý¾wNôNÎ.Þ¦Ïst<à—w±cøFöÀ ôÆø à2àMÀ5›tìJóéð±RwQÞ·äÇñd.è»HÅsÞF”"ÕuæÀ0}ÔÄQ™þTBkeïQd**¿ža£TŒ£Õe[QaãX“¤y·I5áE£%5T$«v®ÛºËøt³íûêÏÀvé9+ûÔ¶Ï$èò¶‡Qï5f[О,±ß­„¶ë«_°[4ÎérêÞÆ]— GûtÁ«æ=TÎÔJÜŸœÜ­Æ\o¢ßçé|™õ0¢ý2U ŒbßFŸøûe¨`Ë)î9ŽI¿ƒýþàE"áoyäóé¼Hyh¹ƒþ#C˜Gz‘<ë«g}|C†¹¬¨ä\új<ŒålLä[Ë%ƒäâð™†%¿õl:@S,ßM59Ä&k$¼˜ôØ}<óTeÄ@Dd*/ìÓÐÏA*d+á¥cÓ!=·1k–6¼‘6 ý8ºÏî1Úö4Àu…¬žUô¡ßÙU¤€®œy]Åw \§t\Ê¢W%çý åÍÿÓ¥èžÇ7¯Ç锾§Fc¢^#‚Ž«ÇüM"íxî£zwSž÷„<רn¹Ðº§Z6À·î¹ÔŨsQfRʼns°{L—“x—îiSšLgÇá?wÿÌz¨ J‡¥YµüW'áZy7|CÉPAFÃßl¾ËÕ&$éOk¸aŸ:Fš÷‡÷Yòè&Ø e´»ºq.þ*·ETž-ņèñï6ÏlRÅ&34ʉò:|Žx׋€ŠôWÇ^4lYô~øN\ã¥óçRsüê€_¨Ñ°˜¤2_£´wÚ¢{iÊgز Qâ`„¸óñèf² qo¨ÉÕ8¶MHÛŠqÀY÷ŠQ®šå¿ªjr|¬™‡>·¡&çqqOx9÷]Ö¾TLOžmîL}n#vÕäØüš~Q–1ïsNÜõ±ïOcŒû'Ó•EïÀ/t~øbÊÞ„Q|»þˆcwÏ!J{‘>uÞûi&»’Ÿü‰‘ˆÈ¼É†šßi}9©Æë›bº’ëÆPì"ÿMÌ>D¦—ãõé¡>UÖ]n[‚w¥7#z´œ•j#’Ë…œ†Ë”dH(o£*¦j9‘¡>Ú°E²G²h p˜O—³¤¨ü¾rÛëaÅ{•™ ˜æ]=\¹år‚n€t,£‡öYr€œ°ÿAÆ®ãç¿YD—~ü2àót 7hú95š—²®MYlßÝ+EDæ„´7ÑŽrH}G…íºÍ~7Èñé%Ó– ²¼ÁœåZÖæ á|Òµ£mÄ–¬*“~U”§bHñu¿®zô–‰œpœÈòqúÇ—s42T“3¯MìPš©÷iè %$½4à»!V,ä>ª<FúmàywUòê2Ywó^E­ª#Ä]«ï !宻ǔ¸¯*÷Q÷"Î¥Õ7mÞ K?ªñjXü˜¶{sJÜÃè)…Þ‘ô*äªòÛÉ´èz83ú‡j49ômúÄß'òŽPw²íÁ¯KÄ] ( q7‰h‡išÑŽŠbñåwI§NXU“ëÂodD¦§IÜëF¾qç…¸ Rû®¼Ï—€¸W•}9V}~/Ʀ¤Õ²—;–^(â>t$î× NÚ¯¸èñr9wy_Ÿ–ÑùŸi4  ÄÝÇpw-zuKDj˜ÐóV)!qWjrí÷¦wAžk ‡öûèçåãƒe-‚kM«°ö沧DZ}¥&7«Y®¡w,†¸ß ¸Ppâ~Fo¤&î‡fEZçq]ÆÒ6ˆúººq—™ˆ¬#"’Z6é']õØqœ¨¹Dí¡7 s‹jz+Çd-ktÍÛì>ˆˆd`Kã§|ôKÔ\Sã‰ä¼ç®ËÈöŠ²¯ÕžV¿Æ¢õíˆÉ¦Ï‘=«Ój25žŸ´âŽǹ‡þÄ"ÛE,Ïy*ß*`™ê¡DÑ‹E€-žzš<Ëæ³zŒÔ3‘i·)ß=f°Rœa¯ªÉ P‘p‰ˆäíÓ’êÝ,H;_¥-&MKóH»“£äzÈï­ë³—é8 Õ¯ÁGòÞƒ2.YÊgnêöÞ~~3ᙜ<xðk5Z>»h‚‘ö/~ø©Í— ®CBÜEÒ¼Tˆ3)”ß26úIå¯ÒFéó&î~½F„:)p`“ }—k!+Ëô¯Iñ³DÞ?TàꉽÏž4_.|Ÿñÿ€Ün~ŸwïªIEND®B`‚ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/iphone-device-skin.png000066400000000000000000000312561425441362600313600ustar00rootroot00000000000000‰PNG  IHDR°€¡™u• pHYs%%IR$ðsRGB®ÎégAMA± üa2CIDATxíÝ_w}ßñï9²äu˜VǽIrµ!3MfZ[ŠIÓKÅ­ÃÀ`;Îd(ØChB ¤ )ÚB†ŽqH&dšÛh&iìBC˜`ÉN – I.ÐʹirQµÓÎJ²÷äyÎjmI–dýÙç9ç³ûzÍýsÄJ+füžï~Ÿß3(ú±0Z¬§k±«á¤FÍóöÉdúþ¨yÅhúºÕ ˜“7ÿmŸ|{iúܼ?˜Ôá•öãíÇÚÇÍcy¼TtnP¬¯6TŸ©=ê]“Aíh>²«y,°Yh£·‰¬ƒMàî›Æí‰ñbÝØË2ÕÖºm«U;«UÓSàl&µïÙ¨=ÞDn™Ö^*{Qš`ÝÖLW'µ§™®ÞZ&«À¥;0˜Ô&h÷6A»¯ ÚqqAì Y] ¸µùFÝÖ|·ö@š móÝÏÔ‰&hMgÏKÀžM­Ã•ºsÒLZE+0šyPÌž€}ÖtŸõN“V`®¬NfÛ˜Ý/fW Ø+F{ú»V§­.ÀæÖ ™Ê®Lê¡zz¼¯6±M°¦­@´C“IÝW'ÆÕ&´Év4n«»›𷛶ÀRs®o¦²›h½`“¬p6°Õ'|fåD3•Ý!»ÁV¸›ËtOvƒ‡ì Xá lj'W Æ÷Õ´ñvëè®æ/u¿pؘ{mœ€mÃÔ=NxžC“ãõʲV0¬x£ÑpëèþÁ°¯gõ]ƒmu¨i¦7í´Xá¶T²m£Û„+ÀÔ®Á–ºµ† ãZY>X¡BWF£Áõñf~|[pÑ’O+È›À®M]‡µ«¸4ÁÓØ €mw]>Ø|³?Ò< €Ëuõ`P· ‡ Û'+ _©Z^®!+£ÅÁ¶fêZµXt!椂¹?…`xåèîÁÖz²Ä+@—Ú“ ¾^WŽÞ^sn®WÚã±&U÷ZèÅUÍç_µºR°üùšSsºB0]x¤yÃ…Z³ñääxÝ>+s°wßu4Ú^;v¼¸w\S‹×4ÅkN~lõy´}ûôuíç€ù0­ñÑ“ñêãðá§ji©y<Õ<š·ü‹Ú ær/v¾võv°4ªQ…kƒt÷?T»®»¶vv5a ×o|sµ~³ö=ñå:ø¿˜Æîpd²ÒLbŸï«917Û^¬5™ÔG*T¬·¾öÕÓP½õ–׈U`µmÐ~æÑÏN§´í´6Ôd2¨wÖ±ñ\´Ú\ìpÛèžéÅZaÚ ëžÝ74Ï7Ôžæp>ídvïÞÏÖ¾/}9qí iغoåøø¾š±™lZ¼.îxqÝyÇëëÎ7¾Þ”¸dí4vo3™}à£KšÌÎEÄÎ4`Sâµ]¸ó ¯«[o}I+°îÚÉìCªúħ+ÀÌ#vf›¯í„õÎ;^WwÿÌ[§ Ð¥v»oÿ—ê}øµyŸÊÎ4bg°ó¯ínë=ïýEÓV`f|ø÷æ=dg±½ì<Ç«pæÍœ‡ìL"¶×€×xmWþóïü¦pæÖ‡lﻥz2=çµêWkŽ´{­üÀ=õéOþ®€¹¶kçuu÷ÛÞ:½«çô& Gçæ& í@tw]±p´žYþ³êA?»mt[óëƒ5Gî~Û[ê‘?ø½é9®)ÚmožÔl²sbÐTì×`a­,/UÇzX!-¶Ö“ór{Ø×][÷ÿÇ_±.Ä;´t¸nºù–yZ+829^×W—ªCÃêT¯Ûêñy‰×{Þû®zòÏŸ¯À†ð]‹;ê[}°îyÏ/Ôœ¸ºi¿/¶ Xêt;Ø6z²yÚU3Öî·>ò‡ŸœN_6¢9›Æ>99>¾¾:ÒÙìpëèþ&o«kw]?ý iÛÕ£QÝñ†×Õ±cÇê+_ýZÍØw‡ Û'+ËŸ¯t°'O¸·fhí„ö\×………Ø论j¡^uó¿¨íÛ·×Wþükµ¼|¬ffP/ïêd‚VfÑ–•`³›“•‚N.êZ狸F£Y_´ÕÞMëë_}B¼›Z{ןüñ£µsçL›hí¢®umÃu]!n]ø`¯¯ª¹óŽ×MÏvµ2°ºûSo¾«Ž=:˽ث‡Ãºr=÷a×/`·ŽîjâufwÚjȺÿÃ,ž3 ¦{±U“ÚÿÄŸÖL´û°[Ö3ËYë`v´8¸¢>Þ¾Q3ÐÆë=ïùÅàìöì~EÍ0bWïÔõÌÂoW-/×eZ—€n]øHSÖ{jîÿð¯Ô»~þÀùÍ8b¯l©ïi¦°¿_—éòvuuàžšÿÎoÖOýä› € ÓFì5;^\>ö¹šï]U‚Ë ØÙ­´kw¿í­ÀÅù¾×Õöíÿ°>ÿ…/VÏÖe•à²vV«v^.ÏË_ö5£u‚«.÷T‚ËØÑb­N_{%^ÖÇÌvbÛS  ûkey©.Á%ì`Û“ÕóêÀÝo{K}ð÷ëc÷7Ôá§þ¦üfõ¨]%ØÑìCu .íV²[Gw5_µ×ék{g­'ÿü‰`}M&“ºþe»ûŽØöËþD_tÄ^RÀ¶5O‹Õ“Å×Ô¿ðØô€õwäȸ^ÚDìÒ᧪GG&Çë%UãñÅü¦a]¤á¶Q{dÖbõd4Ú.^:võÕ£ú¯ð‰i{õùek[½½.ÒEîÀŽ›ßñ‘êq÷õƒ¸çäíÏèÒw~ǷוWnëõx­AÕ΋=V뢶ïc³Ú‹¶îy¯úò²üþ:zôh}å«_«ž\Õé±zfyß…þ†‹Ø-¶Õ¡êI»2ðõ¯>Ñ÷`Ó›Á>ìEíÂ^ðìpkÝ[=j÷^Å+@ÿÖöaûü’³ {+ÓÝ×û›yíBõ ½YÁm·¼¦˜v¶&“Úÿ¥~nrp1»°´BО<0©~&°íêÀ·þú`0[}ŸÛôæ}u||ï ½î‚¶Ïs_ÛxudÀ|x|ÿ—ꦛo©ž\Ð.ì ïÀnÝU=Åë]o|x˜#{n¼az2TOFueÝõB/zÁ l_ÓWwÛ˜Oí©ßý½»š¹èÑêܤŸœ¿ò|/9ÿE\WŒö w„Kqÿ‡¥ö쾡˜/W]µÐß Íàt°°¿V–—Îý’ón=8ÔÕ1nÌ·ö‚®ïþž]} ûÈäøøös}ò<;°£Å>âµuÏ{ÞU̯AócùßýO¿Q=ÙÓ´èè\Ÿ½²n«˜¾dés [+g_#8ëv°uôdó™]Õ!ÓW€L½HpŽ3aÏ2-v¯-ÓW€LíöÎ7üxunP{j¡iÓ3ÿuçÎZlL·v}&ì)×j­ìÖQçû¯·½ÖúÀFÔîÁî¼®óaå¨F‹í«»R‹Õ±ö6¦^ŽJ}fuc`5`;¾€«Ý‰Ø%`6¬öz§Ž÷`Ÿ½kxò½N/àêa¤ ÀŒí~EÇìV·Ö.âU‡œ>°±µ{°»®û'Õ¥Á©Ø>îÀÀÆÖCó-¶¿ û8Àíc6¾^†– £ÅaMº]h¹€ `ãëáB®ª§« ØA·GhYØ<:ÿÉû ‡€]Üñâ`sØqM§;X ØŽW¯±ÿ °Y,.v<¼œÔöá`P;ªC‹‹`3hÒÚqMÇ;h¶ë ì'l_Ä5iW:Öù_€¹Ññl{3ƒQçq¶ X€Íâꮇ—ƒ6`;f °ylï¡ý:ß5`ƒm£IuhåØ‘`s˜L&µeáU‡&¯Àz°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°D°DÖ¤ÆÕ¡¥ÃO›Ãx|´:6Ö Û€`óí#`»þ ÝW8sâhí×ù AÀœ8ÒqÀN&µÔN`; ØÃKv`6‹£= /‡“A®™Àl_À?¨£ÝŸB` °)LšŸï~êoªSÓ‚ŽO!XzJÀlKKìÉ ìRuhépÇ æÆán‡—“Õ lÇ{Ø 6¿YšìÝl{¬»ql|»Ž×Ö ½‘Áòx©:v ¿ 3ÕËÐòÄøÀÚ¸–ªC,À†w°ûõíÓZÀ¨ø†€ØÈÚ#´ö}éV—&'oÀ5\ý‚ÝÞÌ`ÿZll»ZléeëB.€­]h›¯C“Z©}í«»eõ.í}ô³ÀÆÔËÊèpuk`5`Û“:¾¥¬ ¹6¦vÿuï£ÿ£:wb|ÚE\­N×>óØç €©ëý×ö±µ·Ÿ ØÉɥخ´;ûžør°±ìÛÿå>®wz¶U{›À¶öï°I»>ðèïü'íÏ^ÀÕz.`OÔgªcû§°áôrdêÖç&°ƒS?>Ø6:Ô<-V‡¾õ×kqÇ5@¾CK‡ë»¿gWujRONNŒ¯_{wxÚç&µ·:öÐß*6†>ŽJ N_u=-`OÝ-èÊCŸøt¯Ýýõßøíêؤž9}ÈzzÀ>Ó}À¶W¨9 _O§´ºÿÔwOØkÒÃ]¹öº+@²vúúð'ÿKumõü×ñi7Ü>ïEÃö`?ùé®ï• @‡ÚÉëCŸèüÚ¦IS«žùÁçl º?N«×>ú[@¦ý}­„ž¥Mg}ÝÖÑãÍgöT‡Ú£´Ú#µÈÒ®´Ggu¾ÿzÆñYk†g}íàôEÙ.¸˜ S»:ÐÃÅ[“É°>Û'Î:­…Ñâ`¥UÇvßxC=þ…Ç € ½M_Wö%µ<^:ógÀN_ØÃiíî„),@Žž¦¯«§œ%^[Ãsþ¦N#hÝ÷þ󯾾ï¿V=˜4‡ÎõÉsl«›ß:®Ž™Âdèkú:µåÜ×d Î÷ûjÛè‘æ·UÇœH0ßzÜ}mǯ¯ãã7ëóÃóþî•z zÐ~#œ 0¿zœ¾Nš}ø|/8ÿ¶ú9¶5m¯oýÕÁé3óãÐÒáºéæ[ú ØC“ãã—œï[ê…l]¸º©ÜWUÇ–—Õò±cõª›o*æC»:ðΟÿ¥¾î¼Õ~¹wÔÊòywK_pÛÎF[ëPóÊQõà‹_x¬öÜxC0{íôµÝ}íë˽Ðôµ5¬4Oýì¶Þñsï.f¯‡¶«½}½:ÿîëš^!h=³p`0¬·4SØ…êØßþíßMŸ÷ì6…˜¥÷½ÿCµ÷±ÏUOŽ4£Õ·ÖÓË/xŒë¬œ´mtoóâ{ª'_ÿêµkçµ@ÿz^xÁ£³NuáÛó.l{6l±N%èב#ãzéËv÷wÓ‚v[aX/9×­cÏta+SËËuÅÂUMñî©Œu*@ÏÚ½×w¿÷ýõù?þ“êK3}}°ŽºÐ×_DÀV¯»°­¯|õkÓ ìË_ö@÷øèÇê}øPõèP ëM²ûºæâ¶ç)l«Øn¦°ßñß^t§Ý{ý×w¼yz>_šéë¯7Ó×Ï\Ì﹈Ø5ýî¶ìÃt«ç»m=ûe/äÜ×3]À9°g›R~Gõ¨ýFþȽ¡XíÞëí?öƾãµý²÷Õ%¸„€mœ?ØÌ{÷UÚÛ—ýÄ›ºX?k·Š=øoVÏ–š¦¼à ·Nu‘;°§. ê®êÑê7và&뤽YÁ‡>ü‘êY{lÖõsáÖ©.=`W–—šˆ½º‰Ø—WÚI¬ˆ¸|÷½ïWë¾_îõÄ©‹=6ëL—°­•…?ëóX­5mÄ:^ àÒÍ*^ëŽÍ:Óål{¬Ö`ᯚˆýñêY{¸n{:ÛÍ\œúT½óÞ]3Юܾ£Ž÷×e¸Ì€mÿË9زÐÞ(÷{«g{û\Y'¸pùõߪû³?W³0]81~_]¦ËØÖ3 ŸŸÅ*AËN,À…i×ÞýÞËîÇKuÙ«kÖ'`g¸Jбç7Ã×Öº¬¬Y§€­é*Á,N%XÓFìøèÿ©WÝ|S°ª-Ç7ýäÏÔ¿ñ±š•æð@¯[=_­dÏg4l«'›7kFv^wm=ò‡Ÿœ^à°™92®WÞ|Ë,nRpªC“o«ëk<¾ìÕ5—v'®s'Ãúç5©uû^¬öè•ÿòµ}ß `®8øzéËvÏ6^'u¤iÃW®g¼¶Öo…`M»˜»uáX3Ú}UÍÈøèÑz蟮……+ l:íIoú7?Sÿëoÿ®f¨½ÛÖ»ëØøj­À¶žYþ³Yîö–—MÏŠm÷b_þƒßßÄlï$ôêÈ‘£ÓSÞ÷M[h–¦{¯ÇÇ÷UÖyöŒÿñ­£'›¯°«f¬Ý‡ýâ³ lXíÊÀí?öÆyY£|rr||}udw`O7ÙR?Ò<-ÕŒµÿ/ùÇ;ë¾÷Ïìè€Î´Gd]ÿƒ»ç%^M†u{u¨Ó ìÔÂhqðLµ“ØQÍÓX`£x|ß—ê?ÿK³>eà9“úßÍó¥µ<^ªu:jþ“Ét;Ö¦±ozóO;©ˆÔãß½»núᙑuªöÈÙÛ»Ž×V7qiey©®X8:Ë“ Ît ùÇÞûèçj´}{íÚym$hOøÑõ†“w"“É ÞQ'Æ¿_=è'`[íÉ[MÄî©9Ñ·µ÷±ÏMܲÀñ©y¿Ø|fñÚš]À¶"vÍ]o|}ÝñÆ×Õž&fÖÓ¾ý_ž^\þÐ'?5Ø97ÓxmÍ6`[AÛj'±w¿í-uë-¯1•.ÙÒÒSÓ É¦­§šy¼¶f°­°ˆ]³óºkkÏ741ûj“Y൓ÖýOüií{âËó¼Ûz.s¯­ùØÖ•£·&u…j§±;w^[·½öÕÓgGrí”uïcŸ­ÿbú°p.«ç¼?Ps`~¶uÅhÏ`PÌËmg/Çh´ýä„ö‡¦Ï‹‹×ˆZØÀÚX=pð›Ó ëÒSOM'¬ÁÁúœöö°í¶žï¯91_ÛZ-Vêñæ­ÅÚ€Öbvñšæ±øâÚÑ<·±;}lßþìÛÀ|hôÕÞ© ÒÇŸš¾½´ô7ÓPm?¸yÞ±ú|‡&Ãze·‡½ó°­6bŸ™Nbw}›4'›xýÑy‹×V·’½O/keù·k¸põ`P//ú2™Lê:1¾}Údsh>vÍÊòÕ G“&bµPtgRGš©ë¿Ÿ‡“Îg>WδÁ÷bf¬]h÷]ošÇ•3 +Aóœ¯ï›Ž³XOÓ•É·ÕKâµ5ß+§Y^ž® V/îŠ?j `¦Ú#²õú:1~ I­å °'­,¨­ {›oøÕƒrJÀ%hïªõ™zQÝTÿo|°ÂdìÀžËÖÑ]Í4¶½íbðB&Ó µõ¦:>Þ[¡ò&°§2¸P«Çc½¨nOœºž*{{*'œM®ûšß}ót;Ø˱qvµ€V».0žT½½NŒ® ${…àlÚµ‚g–¨- MÇN#ÖiÀf²®ƒúP½¨^_ÿü•Ú`6ÞöT £ÅZ©{›¿ä°±­…ëõmÍc<žËÛÀ®‡°kÖBvR·6cY`#Ù4áºfsìšÕ½ëäDv±rmºp]³¹öT.ö2­ž*°z#‚‡7S¸®Ù¼»æŠÑž>;•˜GkÓÖ}ÍO“Ø(Ça]*»¦]/x¦ö4oÝÙLf÷ÀlM¦¿lòiëÙسYÙ[›·Ú5wøúò\´jóSâ‡jy¼TœFÀ¾çbö6“Y §OZ·Ô£¢õüìÅFõ›ˆÝR·5ÿWÛi: \‚ÉÉ_–šÛ[O7áúši«õ€ &`/G;=ÑDìMÔ®LƒvOÓ_5^{»ùuÜü·ºýñÿÑéû“æíI«W4ÏBµÑB÷õÿÇ¡úIEND®B`‚ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/lab-logo.png000066400000000000000000000035541425441362600273730ustar00rootroot00000000000000‰PNG  IHDR€8yáPLTEGŠÿÿÿÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿGŠÿÚ¬2k¯tRNS  !"#$%&')0125679:;=>?@EFGJKPWXYZ[\]`abcdeghiklnopqrstuwxyz|}~€‚…‡ˆ‰Ž‘—˜™›œžŸ £¤¥®¯°´µ¶·»¿ÀÁÂÃÆÇÈÉËÌÍÎÏÐÒÓÔÕØÙÚÛÞßàâãäåæçèéëìîïðñòóôõö÷øùûüýþGøE\IDATxÅÙû{ÓTÇñï ÍE‡²á:ØtAƒBØ"Š"EÄ‹ÖÙ©õâ” R­ •ÉÊ6æ¦\– 7>ÿ¢çœ\š4I1<½¼~£åyöîINrrB uFA‰ÎÝ™c¿NΘ3“§sï÷­OPPÖ½üãex]9ùjWíœEÐì‘-‰š<ðÉ5„ûnU-Ô)¸®c#cg¯ÀòC ÑšÞwßر¢Š̓°]:~XénmZÑÔÚµõзév¢g§Á ?Zµ€ö°Œìï$¯ä¾Ñ—ˆž‡ÅÜX¥€®1㻩Tc#uÌÁvriUÖŽƒû7ÓB¡Áqks5š†Àýµ"èpõU#àsp£=åH¹pT^Ôÿ±ú¬ÃßA‘±°©òmƒ™zˆ¢%MØN,«|Àg`nÑHôØÀíEŽÙœó4õN¢hjùlÿg±»l€”.€Ë©ÎßõHšõeA“Ü€WÄäHdà÷Ármørx½\@Ú„ÃK­ø¥©9C`ö‘+ƒR’ëEq"$"¤<¼T@^º°nžßÿÚɱ AÏcÍ×{" pt°Ì÷ä¸oAç‹}߈ ¨€,lù¼`äÝQÒxÀ˜×Èñ¼GŽ`²I†*ñ¤Ãt™ÕÊ3“,àÅÿs®‰l›Å€Eèà Yd³4ÀL‘EÊY9,à4€ù.²mYD˜[ÛÈ–œáå¡8C"‡R"‡TA,€Ïycuñ,wl÷ð!ºÐ§R‘îÈ•Ä¥ˆÿ¢ñæ¨9˜‰ËùˆÍ­ Ý Å"LºfV’í#„û”lˆ\n È»³Ûå —3crñG`$zD@úÿˆñÊÇ?þç@ÅâÏ3zèC ùdò1{g×ã}šä¡ú4ò0Å'½*iXð6ùÎîjH€û£L™üžã#™¢(öÝðþ²wÃ,|JÜ‚dœ{=°Ì©ˆõ€»vÖSIjÁZ’HΚVªwE´ä˜Ã@⬊½&L™02€tø˜þ>zœU±p—8r_St€¿Àý²¯ ë¹@xÌÍGÊPÊ€ÍLKä d¾§Äz2”k`ŽRiù©z0rªD!”,k0óÙT¼gCaý90—:ªðx~Û§c‘yÜ^ªÃþ×5î+¢jîì (Û p?KDõØ#jî¿ n¢“¨»dKŸ:á÷¢:ì¾0 ËOI¢šî”®jí~\ì”ZŽ¶Ôz¯xôìU¸Î?W×Ýòƒu}_ o¬ç“¡¾1»¬wF&{g4Ð[íwF uV÷€ÿÜì–ùwôˆIEND®B`‚ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/reboot.css000066400000000000000000000075521425441362600271770ustar00rootroot00000000000000*, *::before, *::after { box-sizing: border-box; } html { font-family: sans-serif; line-height: 1.15; -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; -ms-overflow-style: scrollbar; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); } article, aside, dialog, figcaption, figure, footer, header, hgroup, main, nav, section { display: block; } body { margin: 0; font-family: var(--font-family-base); font-size: var(--font-size-base); font-weight: var(--font-weight-base); line-height: var(--line-height-base); color: var(--body-color); text-align: left; background-color: var(--body-bg); } [tabindex="-1"]:focus { outline: 0 !important; } hr { box-sizing: content-box; height: 0; overflow: visible; } h1, h2, h3, h4, h5, h6 { margin-top: 0; margin-bottom: var(--headings-margin-bottom); } p { margin-top: 0; margin-bottom: var(--paragraph-margin-bottom); } abbr[title], abbr[data-original-title] { text-decoration: underline; text-decoration: underline dotted; cursor: help; border-bottom: 0; } address { margin-bottom: 1rem; font-style: normal; line-height: inherit; } ol, ul, dl { margin-top: 0; margin-bottom: 1rem; } ol ol, ul ul, ol ul, ul ol { margin-bottom: 0; } blockquote { margin: 0 0 1rem; } dfn { font-style: italic; } b, strong { font-weight: bolder; } small { font-size: 80%; } sub, sup { position: relative; font-size: 75%; line-height: 0; vertical-align: baseline; } sub { bottom: -.25em; } sup { top: -.5em; } a { color: var(--link-color); text-decoration: var(--link-decoration); background-color: transparent; -webkit-text-decoration-skip: objects; } a:hover { color: var(--link-hover-color); text-decoration: var(--link-hover-decoration); } pre, code, kbd, samp { font-family: monospace, monospace; font-size: 1em; } pre { margin-top: 0; margin-bottom: 1rem; overflow: auto; -ms-overflow-style: scrollbar; } img { vertical-align: middle; border-style: none; } svg:not(:root) { overflow: hidden; } a, area, button, [role="button"], input:not([type="range"]), label, select, summary, textarea { touch-action: manipulation; } label { display: inline-block; margin-bottom: .5rem; } button { border-radius: 0; } button:focus { outline: 1px dotted; outline: 5px auto -webkit-focus-ring-color; } input, button, select, optgroup, textarea { margin: 0; font-family: inherit; font-size: inherit; line-height: inherit; } button, input { overflow: visible; } button, select { text-transform: none; } button, html [type="button"], [type="reset"], [type="submit"] { -webkit-appearance: button; } button::-moz-focus-inner, [type="button"]::-moz-focus-inner, [type="reset"]::-moz-focus-inner, [type="submit"]::-moz-focus-inner { padding: 0; border-style: none; } input[type="radio"], input[type="checkbox"] { box-sizing: border-box; padding: 0; } input[type="date"], input[type="time"], input[type="datetime-local"], input[type="month"] { -webkit-appearance: listbox; } textarea { overflow: auto; resize: vertical; } fieldset { min-width: 0; padding: 0; margin: 0; border: 0; } legend { display: block; width: 100%; max-width: 100%; padding: 0; margin-bottom: .5rem; font-size: 1.5rem; line-height: inherit; color: inherit; white-space: normal; } progress { vertical-align: baseline; } [type="number"]::-webkit-inner-spin-button, [type="number"]::-webkit-outer-spin-button { height: auto; } [type="search"] { outline-offset: -2px; -webkit-appearance: none; } [type="search"]::-webkit-search-cancel-button, [type="search"]::-webkit-search-decoration { -webkit-appearance: none; } ::-webkit-file-upload-button { font: inherit; -webkit-appearance: button; } output { display: inline-block; } summary { display: list-item; } template { display: none; } [hidden] { display: none !important; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/variables.css000066400000000000000000000021241425441362600276430ustar00rootroot00000000000000:root { --font-family-sans-serif: 'Inter', 'Inter UI', Helvetica, Arial, sans-serif; --font-family-base: var(--font-family-sans-serif); --font-family-medium: 'Inter', 'Inter UI', Helvetica, Arial, sans-serif; --font-size-base: 1rem; --font-size-lg: calc(var(--font-size-base) * 1.25); --font-size-sm: calc(var(--font-size-base) * .875); --font-weight-light: 300; --font-weight-normal: 400; --font-weight-bold: 500; --font-weight-base: var(--font-weight-normal); --line-height-base: 1.5; --body-bg: #242a31; --body-color: #fff; --headings-margin-bottom: 1rem; --paragraph-margin-bottom: 1rem; --link-color: #00f; --link-decoration: none; /* --link-hover-color: darken($link-color, 15%); */ --link-hover-color: var(--link-color); --link-hover-decoration: underline; --icon-color: #858d9b; --main-bg: var(--body-bg); --section-bg: #151a21; --font-color: #a2a9b4; --frame-ratio: .488; /* width/height */ --frame-default-width: 344px; --frame-default-height: calc(var(--frame-default-width) / var(--frame-ratio)); --device-frame-width: 12px; } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/assets/wp-statusbar.png000066400000000000000000000024511425441362600303260ustar00rootroot00000000000000‰PNG  IHDRî$Öñ¿1tEXtSoftwareAdobe ImageReadyqÉe<ËIDATxÚìÝßQãF`醙{%Ä„ÎT¨¨ PÁA@œSu„T_qóäìÆ«Ch$l,ùð}3;6²$¯$ÛóÓ²Zå³Ù,vÛ»w@pÁÜÁw@pžØ뺂<Ï×]Ç'wˆšÍf¹Ã€à¾ËÞ­u'aÃð0 å¡áåƒPö—XÍ$lÃ$¬k?-Ófæ{ð1¶-ä–Ù.Tã%Yp‰œ³ØQ(w fóü’ž¥ˆynÉ·ŠÙñSzþO(£”—©c™-ÿÏŽ·¹ëŽ[%\¿0¸÷Úâž>´ñ`6¼´³øPÕ»µ|ªL/žùbÅ~~Ö*áËP~OùlQo‰¦VõQZO\ödAp?nòq¤eG-Ùö<Õë2•×Ü«x¸P‹cx^C^ºvðáùñ®ezÖ+T£lèÝo íq±{ÎM(ßúÜþÃzY`KÊÐ]íÖü5›÷i.XvP ðu×éñªïJo,¸ ë숣ôXm¦@°`ÙÏ)ðßÖ_Èóü(­û,dßÞ¯uÜsÜz1lùwÍ}Cÿ¼eKî6ûIïWÂ÷]eúq íw A=d­ñ‡õŒ—† ¤ .ZÝýà^ ¶»pjïÁ=kþ·J<‹ÜvÇu áÇÙÓ®2EÖ|¡êeåù4ͳ߲Þèl]_[W™jöwЯ=ŽÍ™7”Âw`gÄñÓl~áè²­ây*?¥PCÿ8ÏóÓ3̇©Œ_­³·…®2lÊ6{Zœ¦r—ÍïÑóRÓö‹l>äuì£Ê A|ý!…øRÙ_~¦wºƒêÚ‚{ÃݹŒùÀ¶Bû—Ú»ve)ûÆ_Vƒyz/8iˆË¬<ÚLçàÞÔƸì¼ÁÐÞ$ yØòZ ö×é½ãX']ÞHW€÷é=´´v íñÔiËô¸ÞiåzÆ¢q?6fOú¸ö±sp¥]bⶼ¶ÊNÔú3ýàU€žÎ4æC.Ô2]VËu“TÊÐ[Äï[²_9oô5ÍsœòàoÙ¼ Ìmöx³¥²=N¿Øôö¿×÷¸ÓÇ=ž}ž¦ò^Ïf€liÔ½×<Ô_[†«N»ÌæýÈO–È}å¼eø/O bpÿž^¯g¼Ø ŽÝÍÆO\º~`™ϿµIÓãZ¦‡ú~ìXßá‚YŠÊóA*é =ù‚5œõ5}! ?KÀ¶5ô’ØJ5ºœ°,“½²ÇVôƒ¬y¼õ¦yËà^Þ€iZÉ‚qúÏéï?SVœ.³ •úNú&2ãã«À›ðÁ.ÁÜ@pw@pÁÜ€'þ`šÕtKÏÜ[IEND®B`‚ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/components.d.ts000066400000000000000000000077421425441362600266510ustar00rootroot00000000000000/* eslint-disable */ /* tslint:disable */ /** * This is an autogenerated file created by the Stencil compiler. * It contains typing information for all components that exist in this project. */ import { HTMLStencilElement, JSXBase } from '@stencil/core/internal'; export namespace Components { interface IonlabApp {} interface IonlabDeviceFrame { 'icon': string; 'platform': string; 'platformName': string; 'url': string; } interface IonlabPlatformDropdown { 'activePlatforms': string[]; } interface IonlabPreview { 'activeDevices': string[]; 'projectType'?: string; 'url'?: string; } interface IonlabSidebar { 'visible': boolean; } interface SkFadingCircle {} } declare global { interface HTMLIonlabAppElement extends Components.IonlabApp, HTMLStencilElement {} var HTMLIonlabAppElement: { prototype: HTMLIonlabAppElement; new (): HTMLIonlabAppElement; }; interface HTMLIonlabDeviceFrameElement extends Components.IonlabDeviceFrame, HTMLStencilElement {} var HTMLIonlabDeviceFrameElement: { prototype: HTMLIonlabDeviceFrameElement; new (): HTMLIonlabDeviceFrameElement; }; interface HTMLIonlabPlatformDropdownElement extends Components.IonlabPlatformDropdown, HTMLStencilElement {} var HTMLIonlabPlatformDropdownElement: { prototype: HTMLIonlabPlatformDropdownElement; new (): HTMLIonlabPlatformDropdownElement; }; interface HTMLIonlabPreviewElement extends Components.IonlabPreview, HTMLStencilElement {} var HTMLIonlabPreviewElement: { prototype: HTMLIonlabPreviewElement; new (): HTMLIonlabPreviewElement; }; interface HTMLIonlabSidebarElement extends Components.IonlabSidebar, HTMLStencilElement {} var HTMLIonlabSidebarElement: { prototype: HTMLIonlabSidebarElement; new (): HTMLIonlabSidebarElement; }; interface HTMLSkFadingCircleElement extends Components.SkFadingCircle, HTMLStencilElement {} var HTMLSkFadingCircleElement: { prototype: HTMLSkFadingCircleElement; new (): HTMLSkFadingCircleElement; }; interface HTMLElementTagNameMap { 'ionlab-app': HTMLIonlabAppElement; 'ionlab-device-frame': HTMLIonlabDeviceFrameElement; 'ionlab-platform-dropdown': HTMLIonlabPlatformDropdownElement; 'ionlab-preview': HTMLIonlabPreviewElement; 'ionlab-sidebar': HTMLIonlabSidebarElement; 'sk-fading-circle': HTMLSkFadingCircleElement; } } declare namespace LocalJSX { interface IonlabApp {} interface IonlabDeviceFrame { 'icon'?: string; 'platform'?: string; 'platformName'?: string; 'url'?: string; } interface IonlabPlatformDropdown { 'activePlatforms'?: string[]; 'onIonlabPlatformToggled'?: (event: CustomEvent) => void; } interface IonlabPreview { 'activeDevices'?: string[]; 'projectType'?: string; 'url'?: string; } interface IonlabSidebar { 'onIonlabSidebarCloseClicked'?: (event: CustomEvent) => void; 'visible'?: boolean; } interface SkFadingCircle {} interface IntrinsicElements { 'ionlab-app': IonlabApp; 'ionlab-device-frame': IonlabDeviceFrame; 'ionlab-platform-dropdown': IonlabPlatformDropdown; 'ionlab-preview': IonlabPreview; 'ionlab-sidebar': IonlabSidebar; 'sk-fading-circle': SkFadingCircle; } } export { LocalJSX as JSX }; declare module "@stencil/core" { export namespace JSX { interface IntrinsicElements { 'ionlab-app': LocalJSX.IonlabApp & JSXBase.HTMLAttributes; 'ionlab-device-frame': LocalJSX.IonlabDeviceFrame & JSXBase.HTMLAttributes; 'ionlab-platform-dropdown': LocalJSX.IonlabPlatformDropdown & JSXBase.HTMLAttributes; 'ionlab-preview': LocalJSX.IonlabPreview & JSXBase.HTMLAttributes; 'ionlab-sidebar': LocalJSX.IonlabSidebar & JSXBase.HTMLAttributes; 'sk-fading-circle': LocalJSX.SkFadingCircle & JSXBase.HTMLAttributes; } } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/components/000077500000000000000000000000001425441362600260455ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/components/ionlab-app/000077500000000000000000000000001425441362600300675ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/components/ionlab-app/ionlab-app.tsx000066400000000000000000000067621425441362600326640ustar00rootroot00000000000000import { Component, Listen, State, h } from '@stencil/core'; import { PLATFORM_IOS, PLATFORM_ANDROID } from '../../utils'; @Component({ tag: 'ionlab-app', }) export class App { @State() sidebarVisible: boolean = true; @State() activeDevices: string[] = [PLATFORM_IOS, PLATFORM_ANDROID]; @State() details: { url?: string; name?: string; version?: string; projectType?: string; } = {}; session: string; componentWillLoad() { this.loadAppDetails(); this.loadLocalStorageState(); } componentWillUpdate() { this.saveLocalStorageState(); } loadAppDetails() { const self = this; const req = new XMLHttpRequest(); req.addEventListener('load', function() { try { self.details = JSON.parse(this.responseText); } catch (e) { console.error('Error loading app details from Ionic Lab API!'); console.error('Response was:', this.responseText); } }); req.addEventListener('error', (err) => { console.error('Error loading app details from Ionic Lab API!'); console.error('Error was:', err); }); req.open('GET', '/api/app'); req.send(); } loadLocalStorageState() { const storedPlatforms = localStorage.getItem('ionic-lab-platforms'); if (storedPlatforms) { this.activeDevices = JSON.parse(storedPlatforms); } const storedSidebarOpen = localStorage.getItem('ionic-lab-sidebar-open'); if (storedSidebarOpen) { this.sidebarVisible = JSON.parse(storedSidebarOpen); } } saveLocalStorageState() { localStorage.setItem('ionic-lab-platforms', JSON.stringify(this.activeDevices)); localStorage.setItem('ionic-lab-sidebar-open', JSON.stringify(this.sidebarVisible)); } @Listen('ionlabSidebarCloseClicked') sidebarCloseClickedHander(event) { this.sidebarVisible = false; } @Listen('ionlabPlatformToggled') ionlabPlatformToggledHandler(event) { this.togglePlatform(event.detail); } togglePlatform(platform: string) { const idx = this.activeDevices.indexOf(platform); const devices = [...this.activeDevices]; if (idx >= 0) { devices.splice(idx, 1); } else { devices.push(platform); } this.activeDevices = devices; } render() { return [
this.sidebarVisible = !this.sidebarVisible } />
,
, ]; } } ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/components/ionlab-device-frame/000077500000000000000000000000001425441362600316365ustar00rootroot00000000000000ionlab-device-frame.css000066400000000000000000000053241425441362600360660ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/components/ionlab-device-frameionlab-device-frame { display: block; margin: 0 20px; vertical-align: middle; } ionlab-device-frame h2 { font-size: var(--font-size-base); margin: 1em 0; vertical-align: middle; text-align: left; font-weight: var(--font-weight-bold); vertical-align: top; color: #727a87; } ionlab-device-frame h2 .icon { display: inline-block; margin-right: 7px; font-size: var(--font-size-lg); } ionlab-device-frame .frame-container { position: relative; width: var(--frame-width); height: var(--frame-height); border-radius: 3px; box-shadow: 0 8px 24px rgba(0,0,0,.12), 0 2px 6px rgba(0,0,0,.16); overflow: hidden; margin: 0; background-size: contain; background-repeat: no-repeat; z-index: 1; } ionlab-device-frame .frame-container .statusbar { position: absolute; top: 0; width: var(--frame-width); height: 20px; background-size: 100%; background-repeat: no-repeat; background-position: center; border-radius: 3px 3px 0 0; } ionlab-device-frame .frame-container sk-fading-circle, ionlab-device-frame .frame-container .load-error { position: absolute; top: 50%; left: 50%; -webkit-transform: translate(-50%, -50%); -ms-transform: translate(-50%, -50%); transform: translate(-50%, -50%); } ionlab-device-frame .frame-container .load-error { background: var(--section-bg); padding: 10px 20px; } ionlab-device-frame .frame-container .load-error p { margin: 0; } ionlab-device-frame .frame-container iframe { background: #000; border: none; width: 100%; height: 100%; position: absolute; top: 0; left: 0; margin: var(--device-frame-width); width: calc(100% - var(--device-frame-width) * 2); height: calc(100% - var(--device-frame-width) * 2); border: none; overflow: hidden; -webkit-mask-image: -webkit-radial-gradient(white, black); z-index: 1; } .statusbar-ios, .statusbar-md { display: none; } #device-ios .statusbar-ios { display: block; fill: #090a0d; left: 50%; position: absolute; top: 12px; transform: translateX(-50%); width: 165px; z-index: 2; } #device-android .statusbar-md { display: block; fill: hsla(0,0%,49%,.3); padding: .5rem 2.2rem; position: relative; width: 100%; z-index: 2; top: 12px; } #device-ios .frame-container { background-image: url('/assets/android-device-skin.png'); border-radius: 44px; } #device-ios .frame-container iframe { border-radius: 32px; } #device-android .frame-container { background-image: url('/assets/iphone-device-skin.png'); border-radius: 54px; } #device-android .frame-container iframe { border-radius: 38px; } @media only screen and (max-height: 850px) { ionlab-device-frame h2 { display: none; } #device-ios .statusbar-ios { top: 10px; } } ionlab-device-frame.tsx000066400000000000000000000036061425441362600361150ustar00rootroot00000000000000ionic-cli-cli-scripts-2.1.55/packages/@ionic/lab/src/stencil/components/ionlab-device-frameimport { Component, Prop, State, h } from '@stencil/core'; @Component({ tag: 'ionlab-device-frame', styleUrl: 'ionlab-device-frame.css', }) export class DeviceFrame { @Prop() platform: string; @Prop() platformName: string; @Prop() url: string; @Prop() icon: string; @State() error: boolean = false; @State() loaded: boolean = false; interval: number; componentDidLoad() { this.interval = window.setInterval(() => { this.error = this.url ? false : true; }, 20000); } loadedHandler(event) { this.loaded = true; this.error = false; window.clearInterval(this.interval); } hostData() { return { id: `device-${this.platform}`, }; } render() { return [

{ this.platformName }

,
{ !this.loaded && !this.error ? : null } { this.error ?

Load Timeout

Still trying...

: null }