From 7e05e5570ffc0ec0012217d5f5c12fa35a1a401b Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner
Date: Thu, 6 Apr 2023 15:17:21 -0700
Subject: [PATCH 01/25] [css-typed-om] Specify that the list of unit shorthand
methods must be reduced/expanded to match the implementation's support.
---
css-typed-om/Overview.bs | 33 +++++++++++++++++++++++++++++++++
1 file changed, 33 insertions(+)
diff --git a/css-typed-om/Overview.bs b/css-typed-om/Overview.bs
index 9787351b..c4004dcd 100644
--- a/css-typed-om/Overview.bs
+++ b/css-typed-om/Overview.bs
@@ -2368,6 +2368,39 @@ partial namespace CSS {
to avoid defining the unit individually for all ~60 functions.
+The above list of methods reflects the set of CSS's valid predefined units
+at one particular point in time.
+It will be updated over time,
+but might be out-of-date at any given moment.
+If an implementation supports additional CSS units
+that do not have a corresponding method in the above list,
+but that do correspond to one of the existing {{CSSNumericType}} values,
+it must additionally support such a method,
+named after the unit
+in its defined canonical casing,
+using the generic behavior defined above.
+
+If an implementation supports units
+that do not correspond to one of the existing {{CSSNumericType}} values,
+it must not support those units in the APIs defined in this specification;
+it should request the units and their types
+be added explicitly to this specification,
+as the appropriate type name is not implicit from the unit.
+
+If an implementation does not support a given unit,
+it must not implement its corresponding method from the list above.
+
+
+ For example, the CSS Speech spec [[CSS-SPEECH-1]]
+ defines two additional units,
+ the decibel dB and semitone st.
+ No current browser implementation supports these
+ or has plans to,
+ so they're not included in the above list,
+ but if an implementation does support the Speec spec,
+ it must also expose CSS.dB() and CSS.st() methods.
+
+
+* Fixed the type match algorithm to refer to the percent hint more abstractly.
+* Clarified that "invert a type" needs to preserve the percent hint.
+* Added missing font units to CSS numeric factory. (#1107)
+* Specified that the list of unit shorthand methods must be reduced or expanded to match the implementation's support.
+* Used undefined union value for "StylePropertyMapReadOnly.get()". (#1087)
+* Removed .to() and the CSSColorValue.colorSpace, as conversion isn't really in Typed OM's remit. (#1070)
+* Added min/max to "serialize a CSSUnitValue", and pass it when serializing the argument of CSSPerspective. (#1069)
+* Changed reifying from "a CSSStyleValue" to "an identifier". (#1068)
+* Added factory functions for new viewport/container units. (#1067)
+* Added type checking to CSSNumericValue.parse. (#1065)
+* Removed CSSDeviceCMYK, add CSSOKLab and CSSOKLCH, made all the color classes accept the "none" keyword.
+* Defined how to reify a color value.
+* Allowed "new unit value" to link to "create a CSSUnitValue from a pair" since that phrasing is used everywhere already.
+* Added support for perspective(none) to CSSPerspective. (#1053)
+* Fixed accidental clash of CSSClampValue.min/max with CSSNumericValue.min/max. (#855)
+* Simplified the Abstract
+* Removed CSSGray and associated spec text, since Color 4 dropped gray() some time ago. (#1027)
+* Moved .colorSpace up to the CSSColorValue superclass. Swapped the .to*() color-conversion functions for a generic .to(colorSpace) method. (#1036)
+* Added device-cmyk() support.
+* Fix the OM for CSSColor to match recent simplifications.
+* Specified which color function each CSSColorValue subclass represents, and added CSSGray.
+* Added missing parentheses for union. (#1016)
+* Added some explanatory text about the makeup of a "type".
+* Aligned with Web IDL specification. (#965 and #1006 )
+* Fixed algorithm nesting.
+* Added default dictionary value, required by update to WebIDL. (#936)
+* Switched term from "underlying value" to :internal representation", as Web Animations already uses "underlying value" for something different.
+* Clarified that reifying as a CSSSTyleValue requires a property.
+* Defined reification behavior for registered custom properties (#886)
+* Used partial interface mixin ElementCSSInlineStyle (#853)
+* Used the correct name from WebIDL for indexed property getter.
+* Exported a number of terms for use in other specifications
+* Droped CSSPositionValue from this level.
+* Added CSSMathClamp for the "clamp()"" function.
+* Made the "match a grammar" algorithm a little more precise.
+* Reifying computed numeric values uses the canonical unit. (#725)
+* Added note about new unit types. (#734)
+* Used correct unit "percent", not "percentage" (#761).
+* Added note about custom property parsing
+* Moved Naina Raisinghani to Former Editor
+* Added an 'invert a type' operation.
+* Exported several numeric-type terms, so CSS Values & Units can refer to them.
+* Moved Shane Stephens to Former Editor
From ab6fa246514f475be8b0e82162b078b7c64a4c21 Mon Sep 17 00:00:00 2001
From: Chris Lilley
Date: Tue, 19 Mar 2024 11:25:02 -0400
Subject: [PATCH 08/25] [css-typed-om-1][editorial] Reduce autolinking errors
---
css-typed-om/Overview.bs | 53 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 53 insertions(+)
diff --git a/css-typed-om/Overview.bs b/css-typed-om/Overview.bs
index 05ab18fe..d19ce53f 100644
--- a/css-typed-om/Overview.bs
+++ b/css-typed-om/Overview.bs
@@ -43,6 +43,9 @@ Markup Shorthands: markdown yes
urlPrefix: http://www.ecma-international.org/ecma-262/6.0/#sec-; type: dfn; spec: ecma-262
text: RangeError; url: native-error-types-used-in-this-standard-rangeerror
+
Title: CSS Typed OM Level 1
-Status: ED
+Status: WD
+Date: 2024-03-21
+Prepare for TR: yes
Group: houdini
ED: https://drafts.css-houdini.org/css-typed-om-1/
TR: https://www.w3.org/TR/css-typed-om-1/
@@ -6255,7 +6257,7 @@ There are no known privacy issues introduced by these features.
Changes {#changes}
==================
-
+
+/* to 20 March 2024 */
+* Made "initial-value" have a <declaration-value>?, same as custom properties. (#9078)
+* Allowed @Property in shadow trees. (#1085)
+* Added section explaining why property registration is global, rather than shadow-scoped.
+* Exported the terms "registered custom property" and "universal syntax definition", for use in other specifications. (#1020)
+* Used the term "invalid at computed-value time" rather than "guaranteed-invalid value".
From d8434a1146155050ddb4656900bae2b1236ee6ce Mon Sep 17 00:00:00 2001
From: Chris Lilley
Date: Thu, 21 Mar 2024 12:05:50 -0400
Subject: [PATCH 12/25] [css-properties-values-api][editorial] autolink-fix
resolving-color-values
---
css-properties-values-api/Overview.bs | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs
index eaac0ae6..805d9dc1 100644
--- a/css-properties-values-api/Overview.bs
+++ b/css-properties-values-api/Overview.bs
@@ -237,7 +237,8 @@ and "<percentage>" values:
the computed value is defined by that function.
For "<color>" values,
-the value is computed by [=resolving color values=].
+the value is computed by resolving color values,
+per [[css-color-4#resolving-color-values]].
For "<custom-ident>", ident, or "*" values,
the computed value is as specified.
From dd684e120479a18728b7f6e15d01caf90a33ccaa Mon Sep 17 00:00:00 2001
From: Chris Lilley
Date: Thu, 21 Mar 2024 12:07:06 -0400
Subject: [PATCH 13/25] [css-properties-values-api][editorial] whitespace
linting
---
css-properties-values-api/Overview.bs | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs
index 805d9dc1..26dfc15a 100644
--- a/css-properties-values-api/Overview.bs
+++ b/css-properties-values-api/Overview.bs
@@ -1195,10 +1195,10 @@ The {{CSSPropertyRule}} interface represents an ''@property'' rule.
From a47f0038f118a156ea1f6bfdb2cf237cfc05e1dd Mon Sep 17 00:00:00 2001
From: Chris Lilley
Date: Thu, 21 Mar 2024 12:24:23 -0400
Subject: [PATCH 14/25] Is Houdini Ready yet
---
README.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.markdown b/README.markdown
index 68254b6e..6dd36a46 100755
--- a/README.markdown
+++ b/README.markdown
@@ -1,6 +1,6 @@
### [CSS-TAG Houdini Task Force](https://wiki.css-houdini.org/) Specifications
-This is the repository containing the [CSS/TAG Houdini Task Force specifications](https://drafts.css-houdini.org/).
+This is the repository containing the [CSS/TAG Houdini Task Force specifications](https://drafts.css-houdini.org/). For an overview of current status, see [Is Houdine Ready Yet?](https://ishoudinireadyyet.com/)
In addition to this git repository, a Mercurial mirror is maintained at `https://hg.css-houdini.org/drafts`, if for whatever reason you prefer Mercurial.
From 13c9a014b6ec524f2ff1305288f101a84ba13d96 Mon Sep 17 00:00:00 2001
From: Chris Lilley
Date: Thu, 21 Mar 2024 12:24:37 -0400
Subject: [PATCH 15/25] Update README.markdown
---
README.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.markdown b/README.markdown
index 6dd36a46..2966e613 100755
--- a/README.markdown
+++ b/README.markdown
@@ -1,6 +1,6 @@
### [CSS-TAG Houdini Task Force](https://wiki.css-houdini.org/) Specifications
-This is the repository containing the [CSS/TAG Houdini Task Force specifications](https://drafts.css-houdini.org/). For an overview of current status, see [Is Houdine Ready Yet?](https://ishoudinireadyyet.com/)
+This is the repository containing the [CSS/TAG Houdini Task Force specifications](https://drafts.css-houdini.org/). For an overview of current status, see [Is Houdini Ready Yet?](https://ishoudinireadyyet.com/)
In addition to this git repository, a Mercurial mirror is maintained at `https://hg.css-houdini.org/drafts`, if for whatever reason you prefer Mercurial.
From b8ff3ab49df009f5d86c76b582bedf4857f4b457 Mon Sep 17 00:00:00 2001
From: Zach Hoffman
Date: Thu, 4 Apr 2024 12:28:12 -0600
Subject: [PATCH 16/25] [css-properties-values-api] Specify syntax
component name (#1104)
Fixes #1103
---
css-properties-values-api/Overview.bs | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs
index 26dfc15a..0b2b9771 100644
--- a/css-properties-values-api/Overview.bs
+++ b/css-properties-values-api/Overview.bs
@@ -236,6 +236,9 @@ and "<percentage>" values:
(such as a [=math function=]),
the computed value is defined by that function.
+For "<string>" values,
+the computed value is as specified.
+
For "<color>" values,
the value is computed by resolving color values,
per [[css-color-4#resolving-color-values]].
@@ -944,6 +947,8 @@ corresponding types accepted by the resulting syntax component.
: "<length-percentage>"
:: Any valid <> or <> value, any valid <>
expression combining <> and <> components.
+: "<string>"
+:: Any valid <> value
: "<color>"
:: Any valid <> value
: "<image>"
From f1a74f02ad857ee54fe378004af4d55f2f7cac46 Mon Sep 17 00:00:00 2001
From: Tristan Fraipont
Date: Sat, 20 Jul 2024 03:43:31 +0900
Subject: [PATCH 17/25] [css-properties-values-api] Fix typo in URL example
(#1122)
The "URL behavior examples" contained a typo where the used variable in the `
`'s `style` attribute had 3 dashes (`-`) instead of 2.
---
css-properties-values-api/Overview.bs | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs
index 0b2b9771..6711babd 100644
--- a/css-properties-values-api/Overview.bs
+++ b/css-properties-values-api/Overview.bs
@@ -281,7 +281,7 @@ the computed value is one of the following:
Title: CSS Properties and Values API Level 1
-Status: ED
+Status: WD
+Date: 2024-03-26
+Prepare for TR: Yes
Group: houdini
ED: https://drafts.css-houdini.org/css-properties-values-api-1/
TR: https://www.w3.org/TR/css-properties-values-api-1/
@@ -13,10 +15,10 @@ Level: 1
Abstract: This CSS module defines an API for registering new CSS properties. Properties registered using this API are provided with a parse syntax that defines a type, inheritance behaviour, and an initial value.
Editor: Tab Atkins-Bittner, Google, http://xanthir.com/contact/, w3cid 42199
Former Editor: Shane Stephens, shanestephens@google.com, w3cid 47691
-Editor: Daniel Glazman, daniel.glazman@disruptive-innovations.com, w3cid 13329
+Former Editor: Daniel Glazman, daniel.glazman@disruptive-innovations.com, w3cid 13329
Editor: Alan Stearns, stearns@adobe.com, w3cid 46659
Former Editor: Elliot Sprehn, esprehn@chromium.org
-Editor: Greg Whitworth, gwhit@microsoft.com, w3cid 69511
+Editor: Greg Whitworth, gwhitworth@salesforce.com , w3cid 69511
Ignored Terms: boolean, Animatable, Map, Context, isolated worker, SyntaxError,
Ignored Terms: InvalidModificationError, NotFoundError, StylePropertyMapReadOnly,
Ignored Terms: worklet global scope
From 368daf92781536386e78293d59db4b992e4db9e3 Mon Sep 17 00:00:00 2001
From: Chris Lilley
Date: Wed, 31 Jul 2024 19:10:42 +0300
Subject: [PATCH 19/25] [css-properties-values-api-1][editorial] back to ED
---
css-properties-values-api/Overview.bs | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs
index 4a0b9691..b70308dd 100644
--- a/css-properties-values-api/Overview.bs
+++ b/css-properties-values-api/Overview.bs
@@ -1,8 +1,7 @@
Title: CSS Properties and Values API Level 1
-Status: WD
-Date: 2024-03-26
-Prepare for TR: Yes
+Status: ED
+Prepare for TR: no
Group: houdini
ED: https://drafts.css-houdini.org/css-properties-values-api-1/
TR: https://www.w3.org/TR/css-properties-values-api-1/
From d38422668ecbda29b5d3bdcd076a87a4b05d5aca Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner
Date: Thu, 22 Aug 2024 15:44:02 -0700
Subject: [PATCH 20/25] [css-typed-om] Tweak the validity of matching when you
have a percent hint to be more correct.
https://github.com/w3c/csswg-drafts/issues/10763
---
css-typed-om/Overview.bs | 40 +++++++++++++++++++++++++++++-----------
1 file changed, 29 insertions(+), 11 deletions(-)
diff --git a/css-typed-om/Overview.bs b/css-typed-om/Overview.bs
index 821b1b6b..712ebf56 100644
--- a/css-typed-om/Overview.bs
+++ b/css-typed-om/Overview.bs
@@ -1959,26 +1959,44 @@ and to the CSS [=math functions=].
Similarly for <>, <
-Note: [=Types=] form a semi-group under both addition
+Note: [=Types=] form a semi-group under addition,
and a monoid under multiplication
(with the multiplicative identity being «[ ]» with a null [=percent hint=]),
meaning that they're associative and commutative.
From 64a8ddc0f18e2e28fb92d88c16c605ea6f105fb9 Mon Sep 17 00:00:00 2001
From: Jeremy Roman
Date: Sat, 24 Aug 2024 21:12:03 -0400
Subject: [PATCH 21/25] Editorial: Update use of WebIDL "invoke a callback
function" (#1127)
* Editorial: Update use of WebIDL "invoke a callback function"
Rethrowing is no longer implicit (since reporting is frequently what's
desired). Here handling the exception is intended, so this is a very
small change.
Also included are the various changes required to make these specs build
and fixes to some places nearby where a clearly incorrect definition was
linked to.
Part of whatwg/webidl#1425.
* Use link-defaults rather than a manual anchor
---------
Co-authored-by: Tab Atkins Jr.
---
css-layout-api/Overview.bs | 49 +++++++++++++++++++++-----------------
css-paint-api/Overview.bs | 7 +++---
2 files changed, 31 insertions(+), 25 deletions(-)
diff --git a/css-layout-api/Overview.bs b/css-layout-api/Overview.bs
index f7ece3bc..54a7bd83 100644
--- a/css-layout-api/Overview.bs
+++ b/css-layout-api/Overview.bs
@@ -51,6 +51,7 @@ spec:css22; type:property;
text:min-height
text:min-width
spec:css2; type:property; text:max-width
+spec:webidl; type:dfn; text:is a platform object
@@ -352,8 +353,9 @@ is called, the user agent must run the following steps:
5. Let |inputPropertiesIterable| be the result of [=Get=](|layoutCtor|, "inputProperties").
6. If |inputPropertiesIterable| is not undefined, then set |inputProperties| to the result of
- [=converting=] |inputPropertiesIterable| to a sequence<DOMString>. If an
- exception is [=thrown=], rethrow the exception and abort all these steps.
+ [=converted to an IDL value|converting=] |inputPropertiesIterable| to a
+ sequence<DOMString>. If an exception is [=thrown=], rethrow the exception
+ and abort all these steps.
7. Filter |inputProperties| so that it only contains [=supported CSS properties=] and [=custom
properties=].
@@ -373,7 +375,7 @@ is called, the user agent must run the following steps:
"childInputProperties").
10. If |childInputPropertiesIterable| is not undefined, then set |childInputProperties| to the
- result of [=converting=] |childInputPropertiesIterable| to a
+ result of [=converted to an IDL value|converting=] |childInputPropertiesIterable| to a
sequence<DOMString>. If an exception is [=thrown=], rethrow the exception
and abort all these steps.
@@ -382,9 +384,9 @@ is called, the user agent must run the following steps:
12. Let |layoutOptionsValue| be the result of [=Get=](|layoutCtor|, "layoutOptions").
- 13. Let |layoutOptions| be the result of [=converting=] |layoutOptionsValue| to a
- {{LayoutOptions}}. If an exception is [=thrown=], rethrow the exception and abort all these
- steps.
+ 13. Let |layoutOptions| be the result of [=converted to an IDL value|converting=]
+ |layoutOptionsValue| to a {{LayoutOptions}}. If an exception is [=thrown=], rethrow the
+ exception and abort all these steps.
14. Let |prototype| be the result of [=Get=](|layoutCtor|, "prototype").
@@ -393,13 +395,14 @@ is called, the user agent must run the following steps:
16. Let |intrinsicSizesValue| be the result of [=Get=](|prototype|, "intrinsicSizes").
- 17. Let |intrinsicSizes| be the result of [=converting=] |intrinsicSizesValue| to the
- [=Function=] [=callback function=] type. Rethrow any exceptions from the conversion.
+ 17. Let |intrinsicSizes| be the result of [=converted to an IDL value|converting=]
+ |intrinsicSizesValue| to the {{Function}} [=callback function=] type. Rethrow any
+ exceptions from the conversion.
18. Let |layoutValue| be the result of [=Get=](|prototype|, "layout").
- 19. Let |layout| be the result of [=converting=] |layoutValue| to the [=Function=] [=callback
- function=] type. Rethrow any exceptions from the conversion.
+ 19. Let |layout| be the result of [=converted to an IDL value|converting=] |layoutValue| to
+ the {{Function}} [=callback function=] type. Rethrow any exceptions from the conversion.
20. Let |definition| be a new [=layout definition=] with:
@@ -1827,8 +1830,9 @@ When the user agent wants to invoke an intrinsic sizes callback given
10. Let |intrinsicSizesFunction| be |definition|'s [=intrinsic sizes function=].
- 11. Let |value| be the result of [=Invoke=](|intrinsicSizesFunction|, |layoutInstance|,
- «|children|, |edges|, |styleMap|»).
+ 11. Let |value| be the result of [=invoking=] |intrinsicSizesFunction| with « |children|,
+ |edges|, |styleMap| » and "`rethrow`", and with |layoutInstance| as the [=callback this
+ value=].
If an exception is [=thrown=] the let |box| fallback to the [=flow layout=] and abort all
these steps.
@@ -1847,9 +1851,9 @@ When the user agent wants to invoke an intrinsic sizes callback given
1. Let |intrinsicSizesValue| be |value|.
- 13. Let |intrinsicSizes| be the result of [=converting=] |intrinsicSizesValue| to a
- {{IntrinsicSizesResultOptions}}. If an exception is [=thrown=], let |box| fallback to the
- [=flow layout=] and abort all these steps.
+ 13. Let |intrinsicSizes| be the result of [=converted to an IDL value|converting=]
+ |intrinsicSizesValue| to a {{IntrinsicSizesResultOptions}}. If an exception is [=thrown=],
+ let |box| fallback to the [=flow layout=] and abort all these steps.
14. Set the [=intrinsic sizes=] of |box|:
@@ -1950,8 +1954,9 @@ following steps:
13. Let |layoutFunction| be |definition|'s [=layout function=].
- 14. Let |value| be the result of [=Invoke=](|layoutFunction|, |layoutInstance|, «|children|,
- |edges|, |layoutConstraints|, |styleMap|, |breakToken|»).
+ 14. Let |value| be the result of [=invoking =] |layoutFunction| with « |children|, |edges|,
+ |layoutConstraints|, |styleMap|, |breakToken| », and with |layoutInstance| as the [=callback
+ this value=].
If an exception is [=thrown=] the let |box| fallback to the [=flow layout=] and abort all
these steps.
@@ -1969,20 +1974,20 @@ following steps:
1. Let |fragmentResultValue| be |value|.
- 16. If |fragmentResultValue| is a [=platform object=]:
+ 16. If |fragmentResultValue| [=is a platform object=]:
- Then:
- 1. Let |fragmentResult| be the result [=converting=] |fragmentResultValue| to a
- {{FragmentResult}}.
+ 1. Let |fragmentResult| be the result [=converted to an IDL value|converting=]
+ |fragmentResultValue| to a {{FragmentResult}}.
If an exception is [=thrown=], let |box| fallback to the [=flow layout=] and abort all
these steps.
- Otherwise:
- 1. Let |fragmentResultOptions| be the result of [=converting=] |fragmentResultValue| to
- a {{FragmentResultOptions}}.
+ 1. Let |fragmentResultOptions| be the result of [=converted to an IDL value|converting=]
+ |fragmentResultValue| to a {{FragmentResultOptions}}.
If an exception is [=thrown=], let |box| fallback to the [=flow layout=] and abort
all these steps.
diff --git a/css-paint-api/Overview.bs b/css-paint-api/Overview.bs
index 86f48645..833f4a1f 100644
--- a/css-paint-api/Overview.bs
+++ b/css-paint-api/Overview.bs
@@ -307,10 +307,10 @@ The <> function is an additional notation to be supported by the <
@@ -664,7 +664,8 @@ When the user agent wants to invoke a paint callback given |name|, |i
11. Let |paintFunctionCallback| be |definition|'s [=paint function=].
12. [=Invoke=] |paintFunctionCallback| with arguments «|renderingContext|, |paintSize|,
- |styleMap|, |inputArguments|», and with |paintInstance| as the [=callback this value=].
+ |styleMap|, |inputArguments|» and "`rethrow`", and with |paintInstance| as the
+ [=callback this value=].
If |paintFunctionCallback| does not complete within an acceptable time (as determined by the
user agent, i.e. it is a "long running script") the user agent may terminate the
From 210f8a604041c9e5b4654f25bf1dfffd0d3bc097 Mon Sep 17 00:00:00 2001
From: Guillaume
Date: Fri, 4 Oct 2024 19:49:14 +0200
Subject: [PATCH 22/25] [css-properties-values-api-1][editorial] Match an empty
string for initialValue (#1129)
---
css-properties-values-api/Overview.bs | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs
index b70308dd..ed3591ac 100644
--- a/css-properties-values-api/Overview.bs
+++ b/css-properties-values-api/Overview.bs
@@ -740,7 +740,7 @@ as arguments of the same names.
Otherwise,
if |syntax definition| is the universal syntax definition,
- [=CSS/parse=] |initialValue| as a <>.
+ [=CSS/parse=] |initialValue| according to <>?.
If this fails,
throw a {{SyntaxError}}
and exit this algorithm.
From 3d51716987994673b9f24fbe5fa3bf94e0447781 Mon Sep 17 00:00:00 2001
From: Tab Atkins-Bittner
Date: Mon, 7 Oct 2024 11:47:16 -0700
Subject: [PATCH 23/25] [css-typed-om] Allow percent hints of 'percent' for
cases where %s are kept as themselves.
---
css-typed-om/Overview.bs | 41 ++++++++++++++++++++++++++++------------
1 file changed, 29 insertions(+), 12 deletions(-)
diff --git a/css-typed-om/Overview.bs b/css-typed-om/Overview.bs
index 712ebf56..08ddfe92 100644
--- a/css-typed-om/Overview.bs
+++ b/css-typed-om/Overview.bs
@@ -1792,12 +1792,20 @@ The base types are
and "percent".
The ordering of a [=type=]’s entries always matches this [=base type=] ordering.
The percent hint
-is either null or a [=base type=] other than "percent".
+is either null or a [=base type=].
Note: As new unit types are added to CSS,
they'll be added to this list of [=base types=],
and to the CSS [=math functions=].
+Note: A [=percent hint=] can be "percent",
+indicating the percentage is used as itself
+(or, equivalently, evaluated against a plain number),
+but this is not produced by the Typed OM methods;
+it only occurs when the type machinery
+is used directly by CSS,
+where a value's context is actually known.
+
To create a type from a string |unit|,
follow the appropriate branch of the following:
@@ -1898,13 +1906,17 @@ and to the CSS [=math functions=].
- To apply the percent hint |hint| to a |type|,
+ To apply the percent hint |hint|
+ to a |type| without a [=percent hint=],
perform the following steps:
- 1. If |type| doesn't [=map/contain=] |hint|, set |type|[|hint|] to 0.
- 2. If |type| [=map/contains=] "percent", add |type|["percent"] to |type|[|hint|],
+ 1. Set |type|’s [=percent hint=] to |hint|,
+ 2. If |type| doesn't [=map/contain=] |hint|, set |type|[|hint|] to 0.
+ 3. If |hint| is anything other than "percent",
+ and |type| [=map/contains=] "percent",
+ add |type|["percent"] to |type|[|hint|],
then set |type|["percent"] to 0.
- 4. Set |type|’s [=percent hint=] to |hint|.
+ 4. Return |type|.
@@ -1974,24 +1986,29 @@ and to the CSS [=math functions=].
* A [=type=] matches <>
if its only non-zero [=map/entry=] is «[ "percent" → 1 ]»,
- and it has a null [=percent hint=].
+ and its [=percent hint=] is either null or "percent".
+
* A [=type=] matches <>
if it matches <> or matches <>.
Same for <>, <>, etc.
+
* A [=type=] matches <>
if it has no non-zero [=map/entries=].
If the context in which the value is used
allows <> values,
- and those percentages are resolved against another type,
+ and those percentages are resolved against a type other than <>,
then for the [=type=] to be considered [=CSSNumericValue/matching=]
- it must either have a null [=percent hint=],
- or the [=percent hint=] must match the other type.
+ the [=percent hint=] must either be null
+ or match the other type.
+
+ If the context allows <> values,
+ but either doesn't resolve them against another type
+ or resolves them against a <>,
+ then for the [=type=] to be considered [=CSSNumericValue/matching=]
+ the [=percent hint=] must either be null or "percent".
If the context does not allow <> values,
- or allows them but does not resolve them against another type
- (or treats them equivalent to a <>,
- such as in 'opacity'),
then for the [=type=] to be considered [=CSSNumericValue/matching=]
the [=percent hint=] must be null.
From 9b75471289e5255b8d088cf856c286888d619a21 Mon Sep 17 00:00:00 2001
From: Sam Atkins
Date: Fri, 13 Dec 2024 14:35:47 +0000
Subject: [PATCH 24/25] [css-typed-om] Correct a typo in "apply the percent
hint" (#1134)
---
css-typed-om/Overview.bs | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/css-typed-om/Overview.bs b/css-typed-om/Overview.bs
index 08ddfe92..5c846d3e 100644
--- a/css-typed-om/Overview.bs
+++ b/css-typed-om/Overview.bs
@@ -1910,7 +1910,7 @@ where a value's context is actually known.
to a |type| without a [=percent hint=],
perform the following steps:
- 1. Set |type|’s [=percent hint=] to |hint|,
+ 1. Set |type|’s [=percent hint=] to |hint|.
2. If |type| doesn't [=map/contain=] |hint|, set |type|[|hint|] to 0.
3. If |hint| is anything other than "percent",
and |type| [=map/contains=] "percent",
From 4e9792216e731e96cbed6ab139efff06790f2920 Mon Sep 17 00:00:00 2001
From: andruud
Date: Wed, 19 Mar 2025 15:06:28 +0100
Subject: [PATCH 25/25] [css-properties-values-api] Make var() fallback
type-agnostic (#1139)
Resolves Issue 10455.
---
css-properties-values-api/Overview.bs | 10 ----------
1 file changed, 10 deletions(-)
diff --git a/css-properties-values-api/Overview.bs b/css-properties-values-api/Overview.bs
index ed3591ac..a14a4e5f 100644
--- a/css-properties-values-api/Overview.bs
+++ b/css-properties-values-api/Overview.bs
@@ -400,16 +400,6 @@ and [[css-syntax-3#tokenization|tokenizing]] the resulting string.
a <> with a value of "80" and unit "px".
-### Fallbacks In ''var()'' References ### {#fallbacks-in-var-references}
-
-References to registered custom properties using the ''var()'' function may
-provide a fallback. However, the fallback value must match the
-syntax definition of the custom property being referenced, otherwise the
-declaration is invalid at computed-value time.
-
-Note: This applies regardless of whether or not the fallback is being used.
-
-
### Dependency Cycles via Relative Units ### {#dependency-cycles}
[=Registered custom properties=] follow the same rules for dependency cycle resolution