@papillonarts/css 0.6.0 → 0.7.0

package/build/primer/layout/README.md

@@ -0,0 +1,20 @@
+---
+bundle: "layout"
+generated: true
+---
+
+# Primer CSS: `layout` bundle
+
+## Usage
+
+Primer CSS source files are written in [SCSS]. To include this Primer CSS module in your own build, ensure that your `node_modules` directory is listed in your Sass include paths, then import it with:
+
+```scss
+@import "@primer/css/layout/index.scss";
+```
+
+## Build
+
+The `@primer/css` npm package includes a standalone CSS build of this module in `dist/layout.css`.
+
+[scss]: https://sass-lang.com/documentation/syntax#scss

package/build/primer/layout/app-frame.scss

@@ -0,0 +1,156 @@
+// stylelint-disable max-nesting-depth
+// stylelint-disable primer/spacing
+
+.AppFrame {
+
+  // AppFrame structure
+  // ===================
+  //
+  // .AppFrame
+  // ├─ .AppFrame-a11yNav
+  // │  ├─ .AppFrame-a11yLink
+  // │
+  // ├─ .AppFrame-main
+  // │  ├─ .AppFrame-header-wrapper
+  // │  │   ├─ .AppFrame-header
+  // │  │   ├─ .AppFrame-subheader
+  // │  │
+  // │  ├─ #start-of-content
+  // │  ├─ .AppFrame-body
+  // │
+  // │  .AppFrame-footer
+
+  // Accessibility navigation
+
+  .AppFrame-a11yNav {
+    position: absolute;
+    z-index: 1000;
+    display: flex;
+    width: 100%;
+    padding: var(--base-size-16, 16px);
+    background: var(--bgColor-inset, var(--color-canvas-inset));
+    padding-block-end: calc(var(--base-size-16, 16px) - var(--borderWidth-thin, 1px));
+    isolation: isolate;
+    align-items: center;
+    gap: var(--base-size-8, 8px);
+
+    &:not(:focus-within) {
+      width: 1px;
+      height: 1px;
+      padding: 0;
+      margin: -1px;
+      overflow: hidden;
+      clip: rect(1px, 1px, 1px, 1px);
+      border: 0;
+    }
+
+    &:focus-within {
+      top: 0;
+      left: 0;
+
+      // Narrow viewport
+      @media (max-width: #{map-get($breakpoints, 'md') - 0.02px}) {
+        justify-content: center;
+      }
+    }
+  }
+
+  .AppFrame-a11yLink {
+    transition: none;
+
+    &:not(:focus) {
+      display: block;
+      width: var(--base-size-8, 8px);
+      height: var(--base-size-8, 8px);
+      overflow: hidden;
+      text-indent: var(--base-size-128, 128px);
+      pointer-events: none;
+      // stylelint-disable-next-line primer/colors
+      background: var(--borderColor-default, var(--color-border-default));
+      border-radius: var(--borderRadius-full, 100vh);
+    }
+
+    &:focus {
+      z-index: 20;
+      display: grid;
+      width: auto;
+      height: auto;
+      min-height: var(--control-medium-size, 32px);
+      padding: 0 var(--control-medium-paddingInline-spacious, 16px);
+      overflow: auto;
+      color: var(--fgColor-onEmphasis, var(--color-fg-on-emphasis));
+      background: var(--bgColor-accent-emphasis, var(--color-accent-emphasis));
+      border-radius: var(--borderRadius-full, 100vh);
+      align-items: center;
+
+      @media (pointer: coarse) {
+        &::after {
+          @include minTouchTarget(var(--control-minTarget-coarse, 44px));
+        }
+      }
+
+      @media (prefers-reduced-motion: no-preference) {
+        animation: AppFrame-a11yLink-focus 200ms ease-out;
+      }
+
+      @keyframes AppFrame-a11yLink-focus {
+        0% {
+          color: var(--fgColor-accent, var(--color-accent-emphasis));
+          transform: scale(0.3, 0.25);
+        }
+
+        50% {
+          color: var(--fgColor-accent, var(--color-accent-emphasis));
+          transform: scale(1, 1);
+        }
+
+        55% {
+          color: var(--fgColor-onEmphasis, var(--color-fg-on-emphasis));
+        }
+
+        100% {
+          transform: scaleX(1);
+        }
+      }
+    }
+  }
+
+  .AppFrame-main {
+    display: flex;
+    min-height: 100vh;
+    flex-direction: column;
+
+    @supports (height: 100dvh) {
+      min-height: 100dvh;
+    }
+  }
+
+  .AppFrame-header-wrapper {
+    position: relative;
+    height: min-content;
+    overflow: visible;
+
+    .AppFrame-header {
+      position: sticky;
+      top: 0;
+      z-index: 1;
+    }
+  }
+
+  .AppFrame-header {
+    flex: 0 0 auto;
+  }
+
+  .AppFrame-subheader {
+    flex: 0 0 auto;
+  }
+
+  .AppFrame-body {
+    flex: 1 0;
+    height: 100%;
+  }
+
+  .AppFrame-footer {
+    flex: 0 0 auto;
+  }
+}

package/build/primer/layout/container.scss

@@ -0,0 +1,30 @@
+// Fixed-width, centered column for site content.
+// Handy container styles that match our breakpoints
+
+// 544px
+.container-sm {
+  max-width: $width-sm;
+  margin-right: auto;
+  margin-left: auto;
+}
+
+// 768px
+.container-md {
+  max-width: $container-md;
+  margin-right: auto;
+  margin-left: auto;
+}
+
+// 1004px - this matches the current fixed width: 980px + padding: px-3
+.container-lg {
+  max-width: $container-lg;
+  margin-right: auto;
+  margin-left: auto;
+}
+
+// 1280px
+.container-xl {
+  max-width: $container-xl;
+  margin-right: auto;
+  margin-left: auto;
+}

package/build/primer/layout/grid-offset.scss

@@ -0,0 +1,19 @@
+// Optional offset options to work with grid.scss
+
+// Offset Columns
+
+@each $breakpoint, $variant in $responsive-variants {
+  @include breakpoint($breakpoint) {
+    .offset#{$variant}-1 { margin-left: (1 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-2 { margin-left: (2 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-3 { margin-left: (3 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-4 { margin-left: (4 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-5 { margin-left: (5 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-6 { margin-left: (6 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-7 { margin-left: (7 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-8 { margin-left: (8 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-9 { margin-left: (9 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-10 { margin-left: (10 * 0.0833333333 * 100%) !important; }
+    .offset#{$variant}-11 { margin-left: (11 * 0.0833333333 * 100%) !important; }
+  }
+}

package/build/primer/layout/grid.scss

@@ -0,0 +1,77 @@
+// GRID
+
+// Columns
+
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-1 { width: (1 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-2 { width: (2 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-3 { width: (3 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-4 { width: (4 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-5 { width: (5 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-6 { width: (6 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-7 { width: (7 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-8 { width: (8 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-9 { width: (9 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-10 { width: (10 * 0.0833333333 * 100%); }
+// stylelint-disable-next-line  declaration-property-value-no-unknown
+.col-11 { width: (11 * 0.0833333333 * 100%); }
+.col-12 { width: 100%; }
+
+@each $breakpoint in map-keys($breakpoints) {
+  @include breakpoint($breakpoint) {
+    .col-#{$breakpoint}-1 { width: ( 1 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-2 { width: ( 2 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-3 { width: ( 3 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-4 { width: ( 4 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-5 { width: ( 5 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-6 { width: ( 6 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-7 { width: ( 7 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-8 { width: ( 8 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-9 { width: ( 9 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-10 { width: ( 10 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-11 { width: ( 11 * 0.0833333333 * 100%); }
+    .col-#{$breakpoint}-12 { width: 100%; }
+  }
+}
+
+// Gutters
+// Apply padding and a negative margin to the outside of the container
+// stylelint-disable primer/spacing
+@mixin gutters ($gutter-width: var(--base-size-16)) {
+  margin-right: calc($gutter-width * -1);
+  margin-left: calc($gutter-width * -1);
+
+  > [class*='col-'] {
+    padding-right: $gutter-width !important;
+    padding-left: $gutter-width !important;
+  }
+}
+
+.gutter {
+  @include gutters(var(--base-size-16));
+}
+
+.gutter-condensed {
+  @include gutters(var(--base-size-8));
+}
+
+.gutter-spacious {
+  @include gutters(var(--base-size-24));
+}
+
+@each $breakpoint in map-keys($breakpoints) {
+  @include breakpoint($breakpoint) {
+    .gutter-#{$breakpoint} { @include gutters(var(--base-size-16)); }
+    .gutter-#{$breakpoint}-condensed { @include gutters(var(--base-size-8)); }
+    .gutter-#{$breakpoint}-spacious { @include gutters(var(--base-size-24)); }
+  }
+}

package/build/primer/layout/index.scss

@@ -0,0 +1,7 @@
+@import '../support/index.scss';
+@import './app-frame.scss';
+@import './container.scss';
+@import './grid.scss';
+@import './grid-offset.scss';
+@import './page-layout.scss';
+@import './stack.scss';