{"id":15696969,"url":"https://github.com/kcmr/most","last_synced_at":"2025-05-08T23:30:08.564Z","repository":{"id":57303033,"uuid":"106861797","full_name":"kcmr/most","owner":"kcmr","description":"My Own Stupid Tools. A collection of CLI tools for working with Polymer Web Components.","archived":false,"fork":false,"pushed_at":"2018-06-03T18:46:01.000Z","size":1374,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-04T01:02:01.321Z","etag":null,"topics":["cli","node","polymer","tools","web-components"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kcmr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-13T18:50:41.000Z","updated_at":"2021-01-27T22:31:39.000Z","dependencies_parsed_at":"2022-09-20T18:01:14.970Z","dependency_job_id":null,"html_url":"https://github.com/kcmr/most","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kcmr%2Fmost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kcmr%2Fmost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kcmr%2Fmost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kcmr%2Fmost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kcmr","download_url":"https://codeload.github.com/kcmr/most/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253163206,"owners_count":21864039,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","node","polymer","tools","web-components"],"created_at":"2024-10-03T19:10:34.989Z","updated_at":"2025-05-08T23:30:08.532Z","avatar_url":"https://github.com/kcmr.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# M.O.S.T.\n\n\u003e A collection of CLI tools for working with Polymer Web Components.\n\n## Installation\n\n```sh\n$ npm i -g most-cli\n```\n\nor\n\n```sh\n$ yarn global add most-cli\n```\n\n## Usage\n\n```sh\n$ cd \u003ccomponent-path\u003e \u0026\u0026 most \u003ccommand\u003e\n```\n\n## Commands\n\nCommand params can also be set in a [`.mostrc` file](#config-file) placed in the component's root or any other parent directory.\n\n### 1. `css-api`\n\n```sh\n$ cd your-component\n$ most css-api\n```\n\n#### Params\n\n|    Name        | Alias |                                Description                                |      Default       |\n|:-------------- | :---- | :------------------------------------------------------------------------ | -------------------|\n|`--file`        | `f`   | File where the CSS properties will be searched.                           | `\u003ccomponent\u003e`.html |\n|`--docs`        | `d`   | File where the CSS docs in markdown format will be searched.              | `\u003ccomponent\u003e`.html |\n|`--sort`        | `s`   | Set to true to sort CSS properties alphabetically.                        | `false`            |\n|`--unformatted` | `u`   | Set to true to render the markdown table without format (unaligned cells) | `false`            | \n\nThe command compares your current CSS API docs inside your component's HTML (markdown table) with the CSS properties and mixins found in the component styles and prints a markdown table with all the properties found in your component styles. If a property is not documented previously in your docs, it will take the value used in styles.\n\nThe command also warns you about API diffs (new properties) and potentially BREAKING CHANGES (removed properties) that may require a major version upgrade for the component.\n\nUsed without params, it will search CSS properties and docs in `\u003cyour-component-name\u003e`.html.   \nIf you need to specify a different file for the styles, you can use the `--file` param. The placeholder `{{component}}` can be used instead of the component's name.\n\nExample with custom path to styles:\n\n```sh\n$ most css-api --file {{component}}-styles.html\n```\n\nExample with custom path to docs:\n\n```sh\n$ most css-api --docs README.md\n```\n\n#### Screenshots\n\nDefault output   \n![Screenshot of the default output](https://github.com/kcmr/most/blob/master/images/cssapi-default-output.png?raw=true)\n\nAdded properties   \n![Screenshot of the output with added CSS properties](https://github.com/kcmr/most/blob/master/images/cssapi-added.png?raw=true)\n\nRemoved properties   \n![Screenshot of the output with removed CSS properties](https://github.com/kcmr/most/blob/master/images/cssapi-removed.png?raw=true)\n\nUnformatted table   \n![Screenshot of the output with unformatted option](https://github.com/kcmr/most/blob/master/images/cssapi-unformatted.png?raw=true)\n\n### 2. `public-api`\n\n```sh\n$ cd your-component\n$ most public-api\n```\n\nThe command writes a file (`public-api.json`) with the public properties, methods, events and CSS properties of the analyzed component. \n\nThis command can be useful to detect breaking changes in the component's API by comparing the generated file with the same file generated in a previous version (release) of the component.\n\n## Config file\n\n### `.mostrc` \n\nYou can set the the params used for each command in a `.mostrc` file that can be placed in the component's root or any other parent directory. This file allows to use placeholders like `{{component}}` that will be replaced by the component's name.\n\nExample:\n\n```json\n{\n  \"css-api\": {\n    \"file\": \"{{component}}-styles.html\",\n    \"docs\": \"README.md\",\n    \"sort\": false,\n    \"unformatted\": true\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkcmr%2Fmost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkcmr%2Fmost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkcmr%2Fmost/lists"}