@wwtdev/bsds-css 0.3.0 → 1.0.1

package/README.md

@@ -1,7 +1,43 @@
 # BSDS CSS Framework
 
-## Developing Global Styles
+## Installation
 
-When adding styles with "global" or "global-like" selectors, developers should also add the `:host` selector.
+```bash
+npm install --save @wwtdev/bsds-css
+```
 
-e.g., If you're adding styles with the `:root`, `html`, `body`, go ahead and slap a comma-separated `:host` selector there as well.
+You can import the minified stylesheet in your project's `main.js` like so:
+
+```javascript
+import '@wwtdev/bsds-css/dist/wwt-bsds.min.css'
+```
+
+## Using with Tailwind CSS
+
+If your project uses Tailwind, complete the steps above and then [install Tailwind](https://tailwindcss.com/docs/installation) if you haven't already. You can follow the instructions in their docs with the exceptions listed below.
+
+### 1. Add the WWT Preset to the Tailwind config.
+
+When setting up the `tailwind.config.js` file, import the WWT preset from the CSS Framework package.
+
+```javascript
+module.exports = {
+  presets: [require('@wwtdev/bsds-css/dist/wwt-bsds-preset.js')]
+};
+```
+
+### 2. Tailwind CSS Directives
+
+Because our CSS Framework includes its own reset and default styles, you will only need to include the `utilities` directive.
+
+```css
+@tailwind utilities;
+```
+
+> Tailwind's base and component directives will cause conflicts with the CSS Framework.
+
+Once you have completed the Tailwind installation steps, you can use the classes generated from the preset.
+
+### Browser Support
+
+Our styles are compiled using Post CSS and Autoprefixer using the [`defaults` setting](https://github.com/browserslist/browserslist#full-list).

package/dist/components/_badge.scss

@@ -0,0 +1,67 @@
+@mixin badge() {
+  .bs-badge[data-position^='left']::before,
+.bs-badge:where(:not([data-position^='left']))::after {
+  align-items: center;
+  background: var(--bs-red-500);
+  border-radius: 0.5rem;
+  content: '';
+  display: inline-flex;
+  font-size: 0.8125rem;
+  font-variant-numeric: tabular-nums;
+  font-weight: 600;
+  height: 6px;
+  justify-content: center;
+  line-height: 1;
+  position: relative;
+  vertical-align: top;
+  width: 6px;
+}
+
+.bs-pill .bs-badge::before,
+.bs-pill .bs-badge::after {
+  font-size: 0.8125em;
+}
+
+.bs-badge[data-count]:where([data-position^='left'])::before,
+.bs-badge[data-count]:where(:not([data-position^='left']))::after {
+  color: white;
+  content: attr(data-count);
+  min-height: 1rem;
+  min-width: 1rem;
+  padding: 0 4px;
+  top: -0.0625rem;
+  vertical-align: unset;
+  width: auto;
+}
+
+.bs-badge[data-count]::before {
+  margin-right: 0.25rem;
+}
+
+.bs-badge[data-count]::after {
+  margin-left: 0.25rem;
+}
+
+.bs-badge[data-count='0']::before,
+.bs-badge[data-count='0']::after {
+  display: none;
+}
+
+.bs-badge[data-show-zero]:where(:not([data-show-zero="false"]))::before,
+.bs-badge[data-show-zero]:where(:not([data-show-zero="false"]))::after {
+  display: inline-flex;
+}
+
+.bs-badge[data-badge-color^='blue']::before,
+.bs-badge[data-badge-color^='blue']::after {
+  background: var(--bs-blue-500);
+}
+
+.bs-badge[data-badge-color^='white']::before,
+.bs-badge[data-badge-color^='white']::after {
+  background: white;
+  color: var(--badge-text, var(--bs-black));
+}
+
+  }
+  

package/dist/components/_buttons.scss

@@ -0,0 +1,193 @@
+@mixin buttons() {
+  :where(button) {
+  background-color: inherit;
+  border-color: transparent;
+  color: inherit;
+  font-size: var(--bs-text-base);
+  position: relative;
+  padding: var(--bs-space-0);
+  text-decoration: none;
+}
+
+.bs-button {
+  --btn-main: var(--bs-blue-400);
+  --btn-secondary: var(--bs-blue-300);
+  --btn-highlight: var(--bs-blue-100);
+  align-items: center;
+  background-color: var(--btn-main);
+  border: none;
+  border-radius: 0.25rem;
+  color: var(--bs-white);
+  cursor: pointer;
+  display: inline-flex;
+  font-size: var(--bs-text-md);
+  font-weight: 600;
+  justify-content: center;
+  line-height: 1.5;
+  outline: 2px solid transparent;
+  padding: var(--bs-space-1) var(--bs-space-4) calc(var(--bs-space-1) * 1.5);
+  position: relative;
+  text-decoration: none;
+  transition: all 100ms ease-in-out;
+  vertical-align: middle;
+}
+
+
+.bs-button:hover {
+  background-color: var(--btn-secondary);
+}
+
+.bs-button:active {
+  background-color: var(--btn-secondary);
+  transform: scale(0.97);
+  transform-origin: center;
+  box-shadow: inset 0px 0px 4px 1px var(--btn-main);
+}
+
+/* Button Focus Styles */
+.bs-button::before {
+  border-color: transparent;
+  border-radius: 0.5rem;
+  border-style: solid;
+  border-width: 0.125rem;
+  content: '';
+  height: calc(100% + 0.5rem);
+  inset: -0.25rem;
+  position: absolute;
+  transition: border-color 0.125s ease-in-out;
+  width: calc(100% + 0.5rem);
+}
+
+.bs-button:focus::before {
+  border-color: var(--btn-main);
+}
+
+.bs-button:focus-visible::before {
+  border-color: var(--btn-main);
+  box-shadow: none;
+}
+
+.bs-button:focus:not(:focus-visible)::before {
+  border-color: transparent;
+  box-shadow: none;
+}
+
+/* Ghost Buttons */
+.bs-button:where([data-ghost]) {
+  --btn-light: var(--bs-blue-10);
+  --btn-secondary: var(--bs-blue-10);
+  background-color: transparent;
+  box-shadow: inset 0 0 0 1px var(--btn-main);
+  color: var(--btn-main);
+}
+.bs-button:where([data-ghost])::before {
+  border-radius: 0.4375rem;
+}
+.bs-button:where([data-ghost]):hover,
+.bs-button:where([data-ghost]):focus {
+  background-color: var(--btn-light);
+}
+.bs-button:where([data-ghost]):active {
+  box-shadow:
+    inset 0 0 0 1px var(--btn-main),
+    inset 0px 0px 4px 1px var(--btn-highlight);
+}
+
+/* Button type */
+.bs-button:where([data-variant^='secondary']) {
+  --btn-main: var(--bs-plum-400);
+  --btn-secondary: var(--bs-plum-300);
+  --btn-light: var(--bs-plum-10);
+  --btn-highlight: var(--bs-plum-100);
+}
+.dark .bs-button:where([data-variant^='secondary']) {
+  --btn-main: var(--bs-plum-200);
+  --btn-secondary: var(--bs-plum-300);
+  --btn-light: var(--bs-navy-400);
+  --btn-highlight: var(--bs-plum-400);
+}
+.bs-button:where([data-variant^='positive']) {
+  --btn-main: var(--bs-purple-400);
+  --btn-secondary: var(--bs-purple-300);
+  --btn-light: var(--bs-purple-10);
+  --btn-highlight: var(--bs-purple-100);
+}
+.bs-button:where([data-variant^='warning']) {
+  --btn-main: var(--bs-orange-warning);
+  --btn-secondary: var(--bs-orange-300);
+  --btn-light: var(--bs-orange-10);
+  --btn-highlight: var(--bs-orange-100);
+}
+.bs-button:where([data-variant^='negative']) {
+  --btn-main: var(--bs-red-400);
+  --btn-secondary: var(--bs-red-300);
+  --btn-light: var(--bs-red-10);
+  --btn-highlight: var(--bs-red-100);
+}
+
+/* Text Button */
+.bs-button:where([data-text]) {
+  background-color: transparent;
+  color: var(--bs-blue-500);
+  cursor: pointer;
+  font-size: var(--bs-text-md);
+  font-weight: 400;
+  line-height: 150%;
+}
+.bs-button:where([data-text]):hover {
+  background-color: transparent;
+  text-decoration: underline;
+}
+.bs-button:where([data-text]):active {
+  box-shadow: none;
+}
+
+/* Button Size */
+.bs-button:where([data-size^='sm']) {
+  font-size: var(--bs-text-sm);
+}
+.bs-button:where([data-text][data-size^='sm']) {
+  font-size: var(--bs-text-base);
+}
+
+/* Disabled Styling */
+:where(button:disabled),
+.bs-button:where([aria-disabled='true']) /* for links as buttons */ {
+  pointer-events: none;
+}
+.bs-button:where(:disabled),
+.bs-button:where([aria-disabled='true']) {
+  color: var(--bs-gray-400);
+  background-color: var(--bs-gray-200);
+}
+
+.bs-button:where([data-ghost]):disabled,
+.bs-button:where([data-ghost])[aria-disabled='true'] {
+  box-shadow: inset 0 0 0 1px var(--bs-gray-400);
+}
+
+.bs-button:where([data-text]):disabled,
+.bs-button:where([data-text][aria-disabled='true']) {
+  background-color: transparent;
+}
+
+/* Icon Height */
+.bs-button :where(svg:not([height])) {
+  height: var(--bs-text-base);
+}
+
+.bs-button:where([data-size^='sm']) :where(svg:not([height])) {
+  height: var(--bs-text-xs);
+}
+
+/* links as buttons */
+a.bs-button {
+  align-items: center;
+  display: inline-flex;
+  outline: none;
+  vertical-align: middle;
+}
+
+
+  }
+  

package/dist/components/_form-booleans.scss

@@ -0,0 +1,158 @@
+@mixin form-booleans() {
+  /* Containers and Labels for Checkbox/Radio */
+.bs-boolean {
+  display: flex;
+  align-items: center;
+  font-size: var(--bs-text-base);
+  font-weight: 400;
+  gap: 0.5em;
+  line-height: 115%;
+}
+
+.bs-boolean:where([data-size='sm']) input {
+  width: var(--bs-text-xs);
+  height: var(--bs-text-xs);
+}
+
+.bs-boolean label {
+  font-size: var(--bs-text-base);
+  font-weight: 400;
+  line-height: 1.5;
+  width: auto;
+}
+
+.bs-boolean:where([data-size='sm']),
+.bs-boolean:where([data-size='sm']) label {
+  font-size: var(--bs-text-xs);
+}
+
+
+/* Checkbox & Radio Input */
+
+:where(input[type^='checkbox'], input[type^='radio']) {
+  --box-shadow: var(--bs-ink-base);
+
+  appearance: none;
+  background-color: var(--bg-base);
+  box-shadow: inset 0 0 0 0.125rem var(--box-shadow);
+  display: grid;
+  height: 1rem;
+  margin: 0;
+  place-content: center;
+  position: relative;
+  width: 1rem;
+}
+
+:where(input[type^='checkbox'], input[type^='radio']):focus {
+  box-shadow: inset 0 0 0 0.125rem var(--box-shadow),
+    0 0 0 2px var(--offset-color, var(--bs-bg-base)),
+    0 0 0 4px var(--outline-color, var(--bs-blue-400));
+}
+
+:where(input[type^='checkbox']) {
+  border-radius: 0.125rem;
+}
+
+:where(input[type^='radio']) {
+  border-radius: 50%;
+}
+
+input:where([type='checkbox'])::before {
+  --filled-size: 1rem;
+  --check-fill-color: var(--bs-blue-400);
+
+  content: '';
+  border-radius: 0.125rem;
+  box-shadow: inset var(--filled-size) var(--filled-size) var(--check-fill-color);
+  height: var(--filled-size);
+  visibility: hidden;
+  width: var(--filled-size);
+}
+
+input:where([type^='checkbox'])::after {
+  border: solid var(--bs-white);
+  border-width: 0 0.125rem 0.125rem 0;
+  content: '';
+  height: 0.75em;
+  left: 50%;
+  position: absolute;
+  top: 50%;
+  transform-origin: center;
+  transform: translate(-50%, -60%) rotate(45deg);
+  visibility: hidden;
+  width: 0.375em;
+}
+
+input:where([type='radio'])::before {
+  --filled-size: 1rem;
+  --radio-fill-color: var(--bs-blue-400);
+
+  background-color: var(--radio-fill-color);
+  border-radius: 50%;
+  box-sizing: content-box;
+  content: '';
+  height: var(--filled-size);
+  visibility: hidden;
+  width: var(--filled-size);
+}
+
+input:where([type='radio'])::after {
+  --inner-size: 0.375rem;
+  --inner-fill-color: var(--bs-white);
+
+  background-color: var(--inner-fill-color);
+  border-radius: 50%;
+  box-sizing: content-box;
+  content: '';
+  height: var(--inner-size);
+  left: 50%;
+  position: absolute;
+  top: 50%;
+  transform: translate(-50%, -50%);
+  visibility: hidden;
+  width: var(--inner-size);
+}
+
+input:where([type='checkbox']:checked, [type='radio']:checked)::before,
+input:where([type='checkbox']:checked, [type='radio']:checked)::after {
+  visibility: visible;
+}
+
+.bs-boolean:where([data-size='sm']) input::before {
+  --filled-size: var(--bs-text-xs);
+}
+
+.bs-boolean:where([data-size='sm']) input[type='checkbox']::after {
+  height: 0.5625rem;
+  width: 0.3125rem;
+}
+
+.bs-boolean:where([data-size='sm']) input[type='radio']::after {
+  --inner-size: 0.25rem;
+}
+
+
+/* Disabled State */
+
+input:where([type='checkbox'], [type='radio']):disabled {
+  --box-shadow: var(--bs-gray-400);
+  background-color: transparent;
+}
+
+input:where([type='checkbox']):checked:disabled::before {
+  --check-fill-color: var(--bs-gray-400);
+}
+
+input:where([type='radio']):checked:disabled::before {
+  --radio-fill-color: var(--bs-gray-400);
+}
+
+
+/* Error state */
+
+input:where([type^='checkbox'], [type^='radio'])[data-error] {
+  --box-shadow: var(--bs-red-400);
+}
+
+  }
+  

package/dist/components/_form-character-count.scss

@@ -0,0 +1,20 @@
+@mixin form-character-count() {
+  .bs-character-count {
+  color: var(--bs-ink-base);
+  font-size: var(--bs-text-xs);
+  font-weight: 400;
+  text-align: right;
+}
+
+:where([disabled], [data-disabled]) + .bs-character-count,
+:where([disabled], [data-disabled]) .bs-character-count,
+.bs-character-count:where([data-disabled]) {
+  color: var(--bs-gray-400);
+}
+
+.bs-character-count:where([data-error]) {
+  color: var(--bs-red-400);
+}
+
+  }
+  

package/dist/components/_form-elements.scss

@@ -0,0 +1,117 @@
+@mixin form-elements() {
+  :where([data-required]) {
+  color: var(--bs-red-400);
+}
+
+:where([data-disabled], [data-disabled] [data-required]) {
+  color: var(--bs-gray-400);
+}
+
+:where(label + input, label > input):not([type^='checkbox'], [type^='radio']),
+:where(label + textarea, label > textarea),
+:where(label + select, label > select) {
+  margin-top: 0.25rem;
+}
+
+input:not([type^='checkbox'], [type^='radio'], [type^='file'], [type^='range']),
+textarea, select {
+  appearance: none;
+  background-color: var(--input-bg, var(--bs-bg-base));
+  border: 1px solid var(--input-border, var(--bs-violet-300));
+  border-radius: 0.25rem;
+  color: var(--bs-ink-base);
+  font-size: var(--bs-text-base);
+  font-weight: 400;
+  line-height: var(--bs-leading-base);
+  min-height: 40px;
+  padding: 0.5rem 0.75rem;
+  width: 100%;
+}
+
+/* Generally applicable (all input types) */
+:is(input, textarea, select)::placeholder {
+  color: var(--bs-violet-200);
+  opacity: 1;
+}
+
+:is(input, textarea, select):focus {
+  box-shadow: 0 0 0 2px var(--offset-color, var(--bs-bg-base)),
+    0 0 0 4px var(--outline-color, var(--bs-blue-400));
+  outline: 2px solid transparent;
+}
+:where(.box) :is(input, textarea, select):focus {
+  --offset-color: var(--bs-bg-subtle);
+}
+:where(.box[data-invert]) :is(input, textarea, select):focus {
+  --offset-color: var(--bs-bg-invert);
+}
+
+:is(input, textarea, select):where([data-error]) {
+  --outline-color: var(--bs-red-200);
+}
+
+:is(input, textarea, select):disabled {
+  background-color: var(--bs-gray-200);
+  border-color: var(--bs-gray-400);
+  color: var(--bs-gray-400);
+}
+
+/*
+Removes the built-in 'margin' on bottom of textarea
+see https://bugs.chromium.org/p/chromium/issues/detail?id=89530
+:has not fully supported yet but will work for most
+*/
+:has(> textarea:only-child) {
+  display: block;
+  line-height: 0;
+}
+
+/* chrome user agent styling was applying opacity: 0.7 */
+:where(select:disabled) {
+  opacity: 1;
+}
+
+:is(input, textarea, select):disabled::placeholder,
+:is(input, textarea, select)[disabled]::placeholder {
+  color: var(--bs-gray-400);
+  opacity: 1;
+}
+
+/* Select */
+
+select {
+  /* URL Encoded SVG dropdown caret so there is something there */
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 16 16'%3E%3Cpath fill='%230A0B19' d='M8.048 13.375a.745.745 0 0 1-.526-.217L0 5.686l1.053-1.061 6.995 6.95 6.897-6.85 1.053 1.06-7.423 7.373a.745.745 0 0 1-.527.217Z'/%3E%3C/svg%3E");
+  background-position: right 0.75rem center;
+  background-repeat: no-repeat;
+  background-size: 1em 1em;
+}
+.dark select {
+  /* URL Encoded SVG dropdown caret so there is something there */
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 16 16'%3E%3Cpath fill='%23ffffff' d='M8.048 13.375a.745.745 0 0 1-.526-.217L0 5.686l1.053-1.061 6.995 6.95 6.897-6.85 1.053 1.06-7.423 7.373a.745.745 0 0 1-.527.217Z'/%3E%3C/svg%3E");
+}
+
+.dark select:disabled {
+  /* URL Encoded SVG dropdown caret so there is something there */
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 16 16'%3E%3Cpath fill='%23555775' d='M8.048 13.375a.745.745 0 0 1-.526-.217L0 5.686l1.053-1.061 6.995 6.95 6.897-6.85 1.053 1.06-7.423 7.373a.745.745 0 0 1-.527.217Z'/%3E%3C/svg%3E");
+}
+
+/* Errors and Messages */
+:is(input, select, textarea):where([data-error]) {
+  --input-border: var(--bs-red-400);
+}
+
+/* Fieldset */
+:where(fieldset) {
+  border: none;
+  margin-left: 0;
+  margin-right: 0;
+  padding: 0;
+}
+:where(fieldset legend) {
+  margin-bottom: 0.25rem;
+  padding: 0;
+}
+
+  }
+  

package/dist/components/_form-field-details.scss

@@ -0,0 +1,19 @@
+@mixin form-field-details() {
+  .bs-field-details {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 0 0.75rem;
+  margin-top: 0.5rem;
+}
+
+:where(textarea, bs-textarea) + .bs-field-details {
+  margin-top: 0.25rem;
+}
+
+.bs-field-details :where(.bs-character-count:first-child) {
+  margin-left: auto;
+}
+
+  }
+  

package/dist/components/_form-hints.scss

@@ -0,0 +1,14 @@
+@mixin form-hints() {
+  .bs-hint {
+  color: var(--bs-ink-light);
+  font-size: var(--bs-text-xs);
+  padding: 0;
+  margin: 0;
+  list-style: none;
+}
+.bs-hint:where([data-error]) {
+  color: var(--bs-red-400);
+}
+
+  }
+  

package/dist/components/_form-labels.scss

@@ -0,0 +1,22 @@
+@mixin form-labels() {
+  :where(label, legend) {
+  --label-color: var(--bs-ink-base);
+
+  color: var(--label-color);
+  display: inline-block;
+  font-size: var(--bs-text-sm);
+  font-weight: 600;
+  line-height: var(--bs-leading-base);
+  width: 100%;
+}
+
+:where([data-required]) {
+  color: var(--bs-red-400);
+}
+
+:where(label[data-disabled], [data-disabled] [data-required], [data-disabled] label) {
+  --label-color: var(--bs-ink-light);
+}
+
+  }
+