Rename Css.Foreign to Css.Global and update docs

Author: Richard Feldman

CHANGELOG.md

@@ -1,7 +1,7 @@
 ## Releases
 | Version | Notes |
 | ------- | ----- |
-| [**15.0.0** (unreleased)](https://github.com/rtfeldman/elm-css/tree/15.0.0) | Remove `asPairs`, `Css.Namespace`, and arithmetic operators. Don't report warnings, just emit CSS. Make `Property` opaque and more efficient. Fix `withMedia` nesting bug. (#352)
+| [**15.0.0** (unreleased)](https://github.com/rtfeldman/elm-css/tree/15.0.0) | Remove `asPairs`, `Css.Namespace`, and arithmetic operators. Don't report warnings, just emit CSS. Make `Property` opaque and more efficient. Fix `withMedia` nesting bug. (#352) Rename `Css.Global` to `Css.Foreign`. (#360)
 | [**14.0.0**](https://github.com/rtfeldman/elm-css/tree/14.0.0) | Remove `Css.asPairsDEPRECATED` in favor of `DEPRECATED.Css.asPairs`. (#352) Fix bug in `borderBottomWidth` functions. (#380) Make `styled` more flexible. (#420) Add `pointerEvents` (#377). Add `Css.Transitions`.
 | [**13.1.1**](https://github.com/rtfeldman/elm-css/tree/13.1.1) | Fix `AngleOrDirection` bug (#356)
 | [**13.1.0**](https://github.com/rtfeldman/elm-css/tree/13.1.0) | Add program, programWithFlags, and beginnerProgram to Html.Styled. (#381) Add `withAttribute`. (#389)

elm-package.json

@@ -10,7 +10,7 @@
         "Css",
         "Css.Transitions",
         "Css.Media",
-        "Css.Foreign",
+        "Css.Global",
         "Css.Colors",
         "Html.Styled",
         "Html.Styled.Attributes",

examples/generated-classes/css/Dreamwriter/Editor.elm

@@ -1,7 +1,7 @@
 module Dreamwriter.Editor exposing (editor, headerBar, purpleCircle)
 
 import Css exposing (..)
-import Css.Foreign exposing (..)
+import Css.Global exposing (..)
 import DEPRECATED.Css.File exposing (UniqueClass, UniqueSvgClass, uniqueClass, uniqueSvgClass)
 
 

examples/generated-classes/css/Dreamwriter/Sidebar.elm

@@ -1,7 +1,7 @@
 module Dreamwriter.Sidebar exposing (chapter, menu)
 
 import Css exposing (..)
-import Css.Foreign exposing (..)
+import Css.Global exposing (..)
 import DEPRECATED.Css.File exposing (UniqueClass, uniqueClass)
 
 

index.js

@@ -86,7 +86,7 @@ module.exports = function(
       [
         "DEPRECATED.Css.File.UniqueClass",
         "DEPRECATED.Css.File.UniqueSvgClass",
-        "Css.Foreign.Snippet"
+        "Css.Global.Snippet"
       ],
       readElmiPath,
       generatedDir,

js/generate-main.js

@@ -32,7 +32,7 @@ function writeMain(
 function generateMain(modules /*: Array<ModuleDeclaration> */) {
   const otherModules = [
     "Css",
-    "Css.Foreign",
+    "Css.Global",
     "DEPRECATED.Css.File",
     "Platform",
     "Json.Decode"
@@ -63,7 +63,7 @@ function generateMain(modules /*: Array<ModuleDeclaration> */) {
     "        , update = \\_ _ -> ( (), Cmd.none )\n" +
     "        , subscriptions = \\_ -> Sub.none\n" +
     "        }\n\n\n" +
-    "classToSnippet : String -> a -> Css.Foreign.Snippet\n" +
+    "classToSnippet : String -> a -> Css.Global.Snippet\n" +
     "classToSnippet str class =\n" +
     "    classToSnippet str class\n\n\n" + // This is just to make type-checking pass. We'll splice in a useful implementation after emitting.
     "main : Program () () Never\n" +
@@ -77,7 +77,7 @@ function generateMain(modules /*: Array<ModuleDeclaration> */) {
 function generateStylesheet(modul /*: ModuleDeclaration */) {
   const entries = modul.values.map(function(value) {
     switch (value.signature) {
-      case "Css.Foreign.Snippet":
+      case "Css.Global.Snippet":
         return modul.name + "." + value.name;
       case "DEPRECATED.Css.File.UniqueClass":
       case "DEPRECATED.Css.File.UniqueSvgClass":

js/hack-main.js

@@ -19,7 +19,7 @@ module.exports = function hackMain(
       // nobody can depend on the contents of these values--which they never should!
       const injection =
         namespacer +
-        "Main$classToSnippet = F2(function(className, styles) { return A2(_rtfeldman$elm_css$Css_Foreign$class, className, styles._0); });";
+        "Main$classToSnippet = F2(function(className, styles) { return A2(_rtfeldman$elm_css$Css_Global$class, className, styles._0); });";
 
       const newMain = [
         main.slice(0, injectionPoint),

src/Css.elm

@@ -947,7 +947,7 @@ we haven't gotten around to adding them!
 
 If you need something that `elm-css` does not support right now, the
 [`Css.property`](http://package.elm-lang.org/packages/rtfeldman/elm-css/latest/Css#property)
-and [`Css.Foreign.selector`](http://package.elm-lang.org/packages/rtfeldman/elm-css/latest/Css-Foreign#selector)
+and [`Css.Global.selector`](http://package.elm-lang.org/packages/rtfeldman/elm-css/latest/Css-Global#selector)
 functions let you define custom properties and selectors, respectively.
 
 

src/Css/Foreign.elm src/Css/Global.elmsrc/Css/Foreign.elm renamed to src/Css/Global.elm

@@ -87,13 +87,13 @@ module Css.Foreign
         , withClass
         )
 
-{-| Style foreign DOM structures (e.g. generated from markdown) where you cannot
-add attributes.
+{-| Apply global CSS to things like foreign DOM structures (e.g. generated
+from markdown) where you cannot add attributes.
 
-This works by using CSS selectors which are [globally scoped and
+This module relies on CSS selectors which are [globally scoped and
 bad for maintainability](https://medium.com/seek-blog/the-end-of-global-css-90d2a4a06284),
-so definitely avoid using this module except when you specifically need to style
-third-party DOM nodes!
+so definitely avoid using this module except when there is no reasonable way
+do to it using `Style` instead!
 
 
 # Global Styles

tests/CompileFixtures.elm

@@ -1,7 +1,7 @@
 module CompileFixtures exposing (..)
 
 import Css exposing (..)
-import Css.Foreign exposing (..)
+import Css.Global exposing (..)
 import Css.Preprocess exposing (Stylesheet, stylesheet)