Release 1.0.0

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,69 @@
+name: Bug Report
+description: "Create a report to help us improve"
+labels: ["bug"]
+body:
+    - type: checkboxes
+      id: prerequisites
+      attributes:
+          label: Prerequisites
+          description: For more information, see the [CONTRIBUTING guide](https://github.com/AngleSharp/AngleSharp.Css/blob/devel/.github/CONTRIBUTING.md).
+          options:
+              - label: Can you reproduce the problem in a [MWE](https://en.wikipedia.org/wiki/Minimal_working_example)?
+                required: true
+              - label: Are you running the latest version of AngleSharp.Css?
+                required: true
+              - label: Did you check the FAQs to see if that helps you?
+                required: true
+              - label: Are you reporting to the correct repository? (there are multiple AngleSharp libraries, e.g., `AngleSharp.Xml` for Xml support)
+                required: true
+              - label: Did you perform a search in the issues?
+                required: true
+
+    - type: textarea
+      id: description
+      attributes:
+          label: Description
+          description: Share a clear and concise description of the problem.
+          placeholder: Description
+      validations:
+          required: true
+
+    - type: textarea
+      id: reproduction-steps
+      attributes:
+          label: Steps to Reproduce
+          description: |
+              Include minimal steps to reproduce the problem if possible. E.g.: the smallest possible code snippet; or a small project, with steps to run it. Make sure to include logs and exceptions as text rather than screenshots.
+          placeholder: Minimal Reproduction
+      validations:
+          required: true
+
+    - type: textarea
+      id: expected-behavior
+      attributes:
+          label: Expected Behavior
+          description: |
+              Provide a description of the expected behavior.
+          placeholder: Expected Behavior
+      validations:
+          required: true
+
+    - type: textarea
+      id: actual-behavior
+      attributes:
+          label: Actual Behavior
+          description: |
+              Provide a description of the actual behavior observed. If applicable, include the error messages and the exception stacktrace.
+          placeholder: Actual Behavior
+      validations:
+          required: true
+
+    - type: textarea
+      id: known-workarounds
+      attributes:
+          label: Possible Solution / Known Workarounds
+          description: |
+              Provide a description of any possible solution or known workarounds.
+          placeholder: Possible Solution / Known Workarounds
+      validations:
+          required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+    - name: Documentation
+      url: https://anglesharp.github.io/
+      about: Read our comprehensive documentation

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,20 @@
+name: Feature Idea
+description: "Suggest an idea for this project"
+labels: ["enhancement"]
+body:
+    - type: textarea
+      attributes:
+          label: Description
+          description: What should the new feature do?
+      validations:
+          required: true
+
+    - type: textarea
+      attributes:
+          label: Background
+          description: Provide any additional background for the feature. e.g., user scenarios.
+
+    - type: textarea
+      attributes:
+          label: Specification
+          description: In case of updates that adhere to specification changes, please reference the used specification.

.github/workflows/ci.yml

@@ -56,6 +56,7 @@ jobs:
         dotnet-version: | 
           6.0.x
           7.0.x
+          8.0.x
 
     - name: Build
       run: ./build.sh
@@ -72,6 +73,7 @@ jobs:
         dotnet-version: | 
           6.0.x
           7.0.x
+          8.0.x
 
     - name: Build
       run: |

CHANGELOG.md

@@ -1,3 +1,32 @@
+# 1.0.0
+
+Released on Sunday, January 21 2024.
+
+- Updated to use AngleSharp 1.0 (#150)
+- Updated media parsing to media L4 spec (#133)
+- Updated naming of CSS values (e.g., `Color` to `CssColorValue`)
+- Fixed issue when updating shorthands with invalid values (#129)
+- Fixed issue with appended EOF character in `CssText` (#123)
+- Fixed missing semicolon in `@page` rule (#135)
+- Fixed integer serialization of keyframe stops (#128)
+- Fixed ordering of rows and columns in `grid` and `grid-gap` (#137)
+- Fixed inclusion of CSS from stylesheets (#116, #140)
+- Fixed style empty if `text-align` is `start` (#151)
+- Fixed computation of priority in CSS rules using multi selector
+- Fixed `GetInnerText` multi-line / text node behavior (#155) @Seyden
+- Fixed computation of relative (`em`) values to absolute (`px`) for `Length` (#136)
+- Added further compactification of CSS tuples (#89, #93)
+- Added new value types `CssPercentageValue`, `CssNumberValue`, and `CssIntegerValue`
+- Added support for CSS nesting in style rules (#148)
+- Added resolution of CSS variable names (#62)
+- Added support for 8-digit hex color codes (#132)
+- Added support for `margin-block` and `margin-inline` declarations
+- Added support for `padding-block` and `padding-inline` declarations
+- Added more CSSOM possibilities and helpers (#6)
+- Added parts of recent color spec update such as `rgb` with spaces (#131)
+- Added now Color L4 parsing with `hsl`, `hwb`, `lab`, `lch`, `oklab`, and `oklch`
+- Added support for recent CSS `list-type` values (#152)
+
 # 0.17.0
 
 Released on Sunday, January 15 2023.

CONTRIBUTORS.md

@@ -16,6 +16,8 @@ AngleSharp.Css contains code written by (in order of first pull request / commit
 * [Bastian Buchholz](https://github.com/campersau)
 * [Fraaankes](https://github.com/Fraaankes)
 * [Eric Mutta](https://github.com/ericmutta)
+* [Seyden](https://github.com/Seyden)
+* [Dave Dunkin](https://github.com/ddunkin)
 
 Without these awesome people AngleSharp.Css could not exist. Thanks to everyone for your contributions! :beers:
 

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2013 - 2023 AngleSharp
+Copyright (c) 2013 - 2024 AngleSharp
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -99,7 +99,7 @@ This project is supported by the [.NET Foundation](https://dotnetfoundation.org)
 
 The MIT License (MIT)
 
-Copyright (c) 2016 - 2022 AngleSharp
+Copyright (c) 2016 - 2024 AngleSharp
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

docs/README.md

@@ -2,4 +2,8 @@
 
 We have more detailed information regarding the following subjects:
 
+- [Getting Started](general/01-Basics.md)
+- [Value Model](general/02-Values.md)
 - [API Documentation](tutorials/01-API.md)
+- [Examples](tutorials/02-Examples.md)
+- [FAQ](tutorials/03-Questions.md)

nuke/Build.cs

@@ -89,11 +89,11 @@ protected override void OnBuildInitialized()
 
             if (ScheduledTargets.Contains(Default))
             {
-                Version = $"{Version}-ci-{buildNumber}";
+                Version = $"{Version}-ci.{buildNumber}";
             }
             else if (ScheduledTargets.Contains(PrePublish))
             {
-                Version = $"{Version}-alpha-{buildNumber}";
+                Version = $"{Version}-beta.{buildNumber}";
             }
         }
 

nuke/ReleaseNotesParser.cs

@@ -17,16 +17,6 @@
 /// </remarks>
 public sealed class ReleaseNotesParser
 {
-    private readonly Regex _versionRegex;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="ReleaseNotesParser"/> class.
-    /// </summary>
-    public ReleaseNotesParser()
-    {
-        _versionRegex = new Regex(@"(?<Version>\d+(\s*\.\s*\d+){0,3})(?<Release>-[a-z][0-9a-z-]*)?");
-    }
-
     /// <summary>
     /// Parses all release notes.
     /// </summary>

src/AngleSharp.Css.Tests/AngleSharp.Css.Tests.csproj

@@ -16,7 +16,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="AngleSharp.Xml" Version="0.17.0" />
+    <PackageReference Include="AngleSharp.Xml" Version="1.0.0" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
     <PackageReference Include="NUnit" Version="3.13.2" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.2.0" />

src/AngleSharp.Css.Tests/CssConstructionFunctions.cs

@@ -2,6 +2,7 @@ namespace AngleSharp.Css.Tests
 {
     using AngleSharp.Css.Dom;
     using AngleSharp.Css.Parser;
+    using AngleSharp.Css.Values;
     using AngleSharp.Html.Dom;
     using AngleSharp.Html.Parser;
     using System;
@@ -70,7 +71,6 @@ internal static CssProperty ParseDeclaration(String source, CssParserOptions opt
         internal static CssStyleDeclaration ParseDeclarations(String declarations)
         {
             var context = BrowsingContext.New(Configuration.Default.WithCss());
-            var parser = context.GetService<ICssParser>();
             var style = new CssStyleDeclaration(context);
             style.Update(declarations);
             return style;
@@ -93,7 +93,7 @@ internal static CssImportRule ParseImportRule(String source)
         internal static Predicate<IRenderDevice> CreateValidator(String name, String value)
         {
             var validator = CreateMediaFeatureValidator(name);
-            var feature = new MediaFeature(name, value);
+            var feature = new MediaFeature(name, new CssAnyValue(value));
             return device => validator.Validate(feature, device);
         }
 

src/AngleSharp.Css.Tests/Declarations/CssBackgroundProperty.cs

@@ -6,6 +6,30 @@ namespace AngleSharp.Css.Tests.Declarations
     [TestFixture]
     public class CssBackgroundPropertyTests
     {
+        [Test]
+        public void CssBackgroundSizeCoverTest()
+        {
+            var snippet = "background-size : cover";
+            var property = ParseDeclaration(snippet);
+            Assert.AreEqual("background-size", property.Name);
+            Assert.IsFalse(property.IsImportant);
+            Assert.IsFalse(property.IsInherited);
+            Assert.IsTrue(property.HasValue);
+            Assert.AreEqual("cover", property.Value);
+        }
+
+        [Test]
+        public void CssBackgroundSizeContainTest()
+        {
+            var snippet = "background-size : contain";
+            var property = ParseDeclaration(snippet);
+            Assert.AreEqual("background-size", property.Name);
+            Assert.IsFalse(property.IsImportant);
+            Assert.IsFalse(property.IsInherited);
+            Assert.IsTrue(property.HasValue);
+            Assert.AreEqual("contain", property.Value);
+        }
+
         [Test]
         public void CssBackgroundAttachmentScrollLegal()
         {

src/AngleSharp.Css.Tests/Declarations/CssGridProperty.cs

@@ -534,7 +534,7 @@ public void CssGridAreaTextValueLegal1()
             var css = ParseStyleSheet(source);
             var text = css.Rules[0].CssText;
 
-            var expected = "#nav-header { grid-area: aaa / aaa / aaa / aaa }";
+            var expected = "#nav-header { grid-area: aaa }";
             Assert.AreEqual(expected, text);
         }
 
@@ -909,5 +909,21 @@ public void CssGridTemplateLonghands_Issue68()
             var style = ParseDeclarations(snippet);
             Assert.AreEqual("grid-template: none", style.CssText);
         }
+
+        [Test]
+        public void CssGridPreservesParts_Issue137()
+        {
+            var snippet = "grid: 10px / 80px";
+            var style = ParseDeclarations(snippet);
+            Assert.AreEqual("grid: 10px / 80px", style.CssText);
+        }
+
+        [Test]
+        public void CssGridGapPreservesParts_Issue137()
+        {
+            var snippet = "grid-gap: 10px 80px";
+            var style = ParseDeclarations(snippet);
+            Assert.AreEqual("grid-gap: 10px 80px", style.CssText);
+        }
     }
 }