{"bugs":{"url":"https://github.com/material-components/material-components-web/issues"},"dist":{"shasum":"daad590a6f3af54bb98913da0b32e21ba96892ba","tarball":"https://registry.npmjs.org/@material/shape/-/shape-5.0.0-canary.3e560b33a.0.tgz","fileCount":7,"integrity":"sha512-BBW0Uh8AnnkNFlukoMhxSyQ3Z7UyQU/9mxYRxNyabtFbC5/0a5Xvs6N4mivfyotyBIGa7qixqL5FHiFYvoIsYg==","signatures":[{"sig":"MEQCIBEG7T+SFeXUM0AMLt6Vbc1brUo/lmhEvdoHLntzgpWIAiBfHkFw3HVZsSQDI0syRB/S9TSn9e3SMtaZs8gA9iAskg==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":16145,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJd3dsFCRA9TVsSAnZWagAAwHMQAJxB2aAiR6M2F0PNO2ef\nj8su+NcT+6RUqGHgAe2kxFtlETOdQCDet0n5zQh79sWiXtKXsg8gTUYRiwPa\nw26PzLdzzRbJ0ou8ZFAelIVDAKD8uvqogLjPinx8v98dycmb9kYEqjl+rinE\n5l5mU3GXYmiOTy3YTjhfJ9WsaDIdgddGDmrI9UAaU/sCPTYt6JdxPBRi9Ch7\nI6g6hp+d5R+q1rXQMhF/PCPGKvA2xYnp1dbwy11x3KAs+tQA/RGRQWpQ3rLq\ncDLyUJrdO3baQgEHv06MmofQZ+0ArzcseSXFkMbBeXHIOnNvS77R7MSnLl96\nCUHcGql4FbOS0sNaE1hR94KIuvRRBWqOGv4p+1cUmpbhnF02wohBk+ZSk1nA\nWVrRx//qoDmBb1y/M59ivDqibmAGo529osIEa1U+DC0ETMGEaa7jXZBE4Gt6\nxsDz8+xF5K44w48oTvSqYpwnb/vojrONECtNgo8FOoRvOf0sf421hFk8QkzH\nOt+R7IL+zOgLQFicC+p/NSNLO7UsvfKnRBDCNItEMK/0ZtNhWCTKBx5MGRNF\ncuNCv8yAAWe4UAmeQGKNjGTvX0hv19K5zOn6+51tvbT1F1WYK7uJdSDRZtAs\nteK1Ix4BDMxnNYhkIY/kOPC5rt9OOssjJmN5UlpBB1j2TjY+3zEU+QQysB+g\nfPAC\r\n=kHUr\r\n-----END PGP SIGNATURE-----\r\n"},"name":"@material/shape","readme":"<!--docs:\ntitle: \"Shape\"\nlayout: detail\nsection: components\nexcerpt: \"Shapes direct attention, identify components, communicate state, and express brand.\"\npath: /catalog/shape/\n-->\n\n# Shape\n\nShapes direct attention, identify components, communicate state, and express brand.\n\n> Currently shape system for web only supports rounded corners.\n\n## Design & API Documentation\n\n<ul class=\"icon-list\">\n  <li class=\"icon-list-item icon-list-item--spec\">\n    <a href=\"https://material.io/go/design-shape\">Material Design guidelines: Shape</a>\n  </li>\n</ul>\n\n## Installation\n\n```\nnpm install @material/shape\n```\n\n## Basic Usage\n\n### Styles\n\n```scss\n@import \"@material/shape/mixins\";\n@import \"@material/shape/functions\";\n```\n\n## Style Customization\n\n### Sass Variables\n\nComponents are categorized as small, medium and large in shape system. Overriding below sass variables applies shape (rounded) to respective categories. For example, overriding `$mdc-shape-medium-radius` variable would apply shape to all components that belong to medium category.\n\nVariable | Description\n--- | ---\n`$mdc-shape-small-component-radius` | Rounded shape radius size for small components. Default value `4px`.\n`$mdc-shape-medium-component-radius` | Rounded shape radius size for medium components. Default value `4px`.\n`$mdc-shape-large-component-radius` | Rounded shape radius size for large components. Default value `0`.\n\nPlease refer [Material Design guidelines: Shape](https://material.io/go/design-shape) to learn about how components are categorized.\n\n### Sass Mixins\n\nMixin | Description\n--- | ---\n`mdc-shape-radius($radius, $rtl-reflexive)` | Shape API used by all other components to apply radius to appropriate corners. `$radius` can be single value or list of up to 4 radius corner values. Set `$rtl-reflexive` to true to flip the radius in RTL case, `false` by default.\n\n> Use `mdc-shape-resolve-percentage-radius` sass function to resolve percentage unit value to absolute radius value.\n\n### Sass Functions\n\nFunction | Description\n--- | ---\n`mdc-shape-flip-radius($radius)` | Flips the radius values in RTL context. `$radius` is list of 2-4 corner values.\n`mdc-shape-resolve-percentage-radius($component-height, $radius)` | Calculates the absolute radius value based on its component height. Use this for fixed height components only.\n`mdc-shape-mask-radius($radius, $masked-corners)` | Accepts radius number or list of 2-4 radius values and returns 4 value list with masked corners as mentioned in `$masked-corners`.\n`mdc-shape-prop-value($radius)` | Returns `$radius` value of shape category - `large`, `medium` or `small`. Otherwise, it returns the `$radius` itself if valid. `$radius` can be a single value or list of up to 4.\n\n### Additional Information\n\n#### Shapes for fixed height components\n\nStyles for applying shape to a fixed height component such as button looks like this:\n\n```scss\n@include mdc-shape-radius(mdc-shape-resolve-percentage-radius($mdc-button-height, $radius));\n```\n\nWhere, `$mdc-button-height` is the height of standard button and `$radius` is the size of shape. `mdc-shape-resolve-percentage-radius` function is used to resolve percentage unit value to absolute `$radius` value based on component height.\n\n#### Shapes for dynamic height components\n\nStyles for applying shapes to dynamic height component such as card looks like this:\n\n```scss\n@include mdc-shape-radius($radius);\n```\n\nWhere, `$radius` is absolute value only.\n\n#### Shapes for components on specific corners\n\nStyles for applying shapes for specific corners such as drawer looks like this:\n\n```scss\n@include mdc-shape-radius(0 $radius $radius 0, $rtl-reflexive: true);\n```\n\nWhere, only top-right & bottom-right corners are customizable and it automatically flips radius values based on RTL context when `$rtl-reflexive` is set to true.\n\n#### Component theming\n\nThe styles for applying custom shape to button component instance looks like this:\n\n```scss\n@import \"@material/button/mixins\";\n\n.my-custom-button {\n  @include mdc-button-shape-radius(50%);\n}\n```\n\nIn this example, the above styles applies 50% (pill) shape to button. It can also be absolute value (e.g., `8px`);\n\n> You would indirectly use the Shape API through respective component's mixin which takes care of applying radius to applicable corners for all its variants.\n","gitHead":"a86efd68e1e91c0cae784ad70b0e36c13c923dba","license":"MIT","_npmUser":{"name":"abhiomkar","email":"abhiomkar@gmail.com"},"homepage":"https://github.com/material-components/material-components-web#readme","keywords":["material components","material design","shape"],"repository":{"url":"git+https://github.com/material-components/material-components-web.git","type":"git","directory":"packages/mdc-shape"},"_npmVersion":"lerna/3.14.1/node@v10.17.0+x64 (linux)","description":"Shape utilities for Material Components for the web","directories":{},"maintainers":[{"name":"abhiomkar","email":"abhiomkar@gmail.com"},{"name":"acdvorak","email":"acdvorak@gmail.com"},{"name":"allanchen","email":"allanchen@google.com"},{"name":"aomarks","email":"aomarks@google.com"},{"name":"aprigogin","email":"andrey.prigogin@gmail.com"},{"name":"asyncliz","email":"asyncliz@gmail.com"},{"name":"azakus","email":"dfreedm2@gmail.com"},{"name":"bicknellr","email":"bicknellr@gmail.com"},{"name":"bonniez","email":"bonniez@google.com"},{"name":"bwobrien","email":"obrien.test@gmail.com"},{"name":"emarquez","email":"emarquez@google.com"},{"name":"esgonzalez","email":"esgonzalez@google.com"},{"name":"kfranqueiro","email":"kenneth.franqueiro@gmail.com"},{"name":"lynnjepsen","email":"lynnjepsen@google.com"},{"name":"material-admin","email":"aprigogin+npm@google.com"},{"name":"moog16","email":"mattgoo@gmail.com"},{"name":"patrickrodee","email":"prodee@google.com"},{"name":"williamernest","email":"williamernest@google.com"}],"_nodeVersion":"10.17.0","dependencies":{"@material/feature-targeting":"5.0.0-canary.3e560b33a.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","_npmOperationalInternal":{"tmp":"tmp/shape_5.0.0-canary.3e560b33a.0_1574820612606_0.9264819069493928","host":"s3://npm-registry-packages"},"_id":"@material/shape@5.0.0-canary.3e560b33a.0","version":"5.0.0-canary.3e560b33a.0"}