feat(RevisionBlock): replace dir="v" to vertical attribute

Author: std-microblock

src/components/revision/RevisionBlock.astro

@@ -3,18 +3,14 @@ import RevisionTags from "./RevisionTags.astro";
 import { autoRev } from ".";
 import type { RevisionInfo } from "./types";
 
-type LayoutDirection = "h" | "v";
-
 interface Props extends RevisionInfo {
   noborder?: boolean;
-  dir?: LayoutDirection;
+  vertical?: boolean;
 }
 
 const { since, until, noborder } = Astro.props;
-const dir = Astro.props.dir ?? "h";
-
-const horizontal = dir === "h";
-const vertical = dir === "v";
+const vertical = Astro.props.vertical ?? false;
+const horizontal = !vertical;
 ---
 
 <div

src/content/docs/c/library/headers/index.mdx

@@ -24,7 +24,7 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C99">
-    <RevisionBlock slot="item" noborder since="C99" dir="v">
+    <RevisionBlock slot="item" noborder since="C99" vertical>
       <CHeader name="complex" />
     </RevisionBlock>
     Complex number arithmetic
@@ -41,7 +41,7 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C99">
-    <RevisionBlock slot="item" noborder since="C99" dir="v">
+    <RevisionBlock slot="item" noborder since="C99" vertical>
       <CHeader name="fenv" />
     </RevisionBlock>
     Floating-point environment
@@ -53,14 +53,14 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C99">
-    <RevisionBlock slot="item" noborder since="C99" dir="v">
+    <RevisionBlock slot="item" noborder since="C99" vertical>
       <CHeader name="inttypes" />
     </RevisionBlock>
     Format conversion of integer types
   </Desc>
 
   <Desc autorevSince="C95">
-    <RevisionBlock slot="item" noborder since="C95" dir="v">
+    <RevisionBlock slot="item" noborder since="C95" vertical>
       <CHeader name="iso646" />
     </RevisionBlock>
     Alternative operator spellings
@@ -96,7 +96,7 @@ The interface of C standard library is defined by the following collection of he
       slot="item"
       noborder
       since="C11"
-      dir="v"
+      vertical
       traits={[ { trait: "deprecated", since: "C23" } ]}
     >
       <CHeader name="stdalign" />
@@ -110,14 +110,14 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C11">
-    <RevisionBlock slot="item" noborder since="C11" dir="v">
+    <RevisionBlock slot="item" noborder since="C11" vertical>
       <CHeader name="stdatomic" />
     </RevisionBlock>
     Atomic operations
   </Desc>
 
   <Desc autorevSince="C23">
-    <RevisionBlock slot="item" noborder since="C23" dir="v">
+    <RevisionBlock slot="item" noborder since="C23" vertical>
       <CHeader name="stdbit" />
     </RevisionBlock>
     Macros to work with the byte and bit representations of types
@@ -128,7 +128,7 @@ The interface of C standard library is defined by the following collection of he
       slot="item"
       noborder
       since="C99"
-      dir="v"
+      vertical
       traits={[ { trait: "deprecated", since: "C23" } ]}
     >
       <CHeader name="stdbool" />
@@ -137,7 +137,7 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C23">
-    <RevisionBlock slot="item" noborder since="C23" dir="v">
+    <RevisionBlock slot="item" noborder since="C23" vertical>
       <CHeader name="stdckdint" />
     </RevisionBlock>
     Macros for performing checked integer arithmetic
@@ -149,7 +149,7 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C99">
-    <RevisionBlock slot="item" noborder since="C99" dir="v">
+    <RevisionBlock slot="item" noborder since="C99" vertical>
       <CHeader name="stdint" />
     </RevisionBlock>
     Fixed-width integer types
@@ -166,7 +166,7 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C29">
-    <RevisionBlock slot="item" noborder since="C29" dir="v">
+    <RevisionBlock slot="item" noborder since="C29" vertical>
       <CHeader name="stdmchar" />
     </RevisionBlock>
     Text transcode
@@ -177,7 +177,7 @@ The interface of C standard library is defined by the following collection of he
       slot="item"
       noborder
       since="C11"
-      dir="v"
+      vertical
       traits={[ { trait: "deprecated", since: "C23" } ]}
     >
       <CHeader name="stdnoreturn" />
@@ -191,14 +191,14 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C99">
-    <RevisionBlock slot="item" noborder since="C99" dir="v">
+    <RevisionBlock slot="item" noborder since="C99" vertical>
       <CHeader name="tgmath" />
     </RevisionBlock>
     Type-generic math (macros wrapping <CHeader name="math" /> and <CHeader name="complex" />)
   </Desc>
 
   <Desc autorevSince="C11">
-    <RevisionBlock slot="item" noborder since="C11" dir="v">
+    <RevisionBlock slot="item" noborder since="C11" vertical>
       <CHeader name="threads" />
     </RevisionBlock>
     Thread library
@@ -210,21 +210,21 @@ The interface of C standard library is defined by the following collection of he
   </Desc>
 
   <Desc autorevSince="C11">
-    <RevisionBlock slot="item" noborder since="C11" dir="v">
+    <RevisionBlock slot="item" noborder since="C11" vertical>
       <CHeader name="uchar" />
     </RevisionBlock>
     UTF-16 and UTF-32 character utilities
   </Desc>
 
   <Desc autorevSince="C95">
-    <RevisionBlock slot="item" noborder since="C95" dir="v">
+    <RevisionBlock slot="item" noborder since="C95" vertical>
       <CHeader name="wchar" />
     </RevisionBlock>
     Extended multibyte and wide character utilities
   </Desc>
 
   <Desc autorevSince="C95">
-    <RevisionBlock slot="item" noborder since="C95" dir="v">
+    <RevisionBlock slot="item" noborder since="C95" vertical>
       <CHeader name="wctype" />
     </RevisionBlock>
     Functions to determine the type contained in wide character data

src/content/docs/c/library/strings/byte/memcpy.mdx

@@ -161,7 +161,7 @@ dst = "\0\0\0\0\0yxyxy", r = 22
 <DescList>
   <Desc kind="function" autorevSince="C23">
     <DescItem slot="item">
-      <RevisionBlock noborder since="C23" dir="v"><Missing>`memccpy`</Missing></RevisionBlock>
+      <RevisionBlock noborder since="C23" vertical><Missing>`memccpy`</Missing></RevisionBlock>
     </DescItem>
     copies one buffer to another, stopping after the specified delimiter
   </Desc>
@@ -171,17 +171,17 @@ dst = "\0\0\0\0\0yxyxy", r = 22
       <Missing>`memmove`</Missing>
     </DescItem>
     <DescItem slot="item" autorevSince="C11">
-      <RevisionBlock noborder since="C11" dir="v"><Missing>`memmove_s`</Missing></RevisionBlock>
+      <RevisionBlock noborder since="C11" vertical><Missing>`memmove_s`</Missing></RevisionBlock>
     </DescItem>
     moves one buffer to another
   </Desc>
 
   <Desc kind="function" autorevSince="C95">
     <DescItem slot="item">
-      <RevisionBlock noborder since="C95" dir="v"><Missing>`wmemcpy`</Missing></RevisionBlock>
+      <RevisionBlock noborder since="C95" vertical><Missing>`wmemcpy`</Missing></RevisionBlock>
     </DescItem>
     <DescItem slot="item" autorevSince="C11">
-      <RevisionBlock noborder since="C11" dir="v"><Missing>`wmemcpy_s`</Missing></RevisionBlock>
+      <RevisionBlock noborder since="C11" vertical><Missing>`wmemcpy_s`</Missing></RevisionBlock>
     </DescItem>
     copies a certain amount of wide characters between two non-overlapping arrays
   </Desc>

src/content/docs/cpp/library/utilities/move.mdx

@@ -133,21 +133,21 @@ The contents of the vector are {"Salut", "Salut"}
 <DescList>
   <Desc kind="function template">
     <Fragment slot="item">
-      <RevisionBlock noborder since="C++11" dir="v"><Missing>`forward`</Missing></RevisionBlock>
+      <RevisionBlock noborder since="C++11" vertical><Missing>`forward`</Missing></RevisionBlock>
     </Fragment>
     forwards a function argument and use the type template argument to preserve its value category
   </Desc>
 
   <Desc kind="function template">
     <Fragment slot="item">
-      <RevisionBlock noborder since="C++11" dir="v"><Missing>`move_if_noexcept`</Missing></RevisionBlock>
+      <RevisionBlock noborder since="C++11" vertical><Missing>`move_if_noexcept`</Missing></RevisionBlock>
     </Fragment>
     converts the argument to an xvalue if the move constructor does not throw
   </Desc>
 
   <Desc kind="function template">
     <Fragment slot="item">
-      <RevisionBlock noborder since="C++11" dir="v"><Missing>`move`</Missing></RevisionBlock>
+      <RevisionBlock noborder since="C++11" vertical><Missing>`move`</Missing></RevisionBlock>
     </Fragment>
     moves a range of elements to a new location
   </Desc>

src/content/docs/development/guide/doc-everything.mdx

@@ -201,7 +201,7 @@ import { RevisionBlock } from "@components/revision";
   </Desc>
 
   <Desc autorevSince="C99">
-    <RevisionBlock slot="item" noborder since="C99" dir="v">
+    <RevisionBlock slot="item" noborder since="C99" vertical>
       <CHeader name="complex" />
     </RevisionBlock>
     Complex number arithmetic
@@ -222,7 +222,7 @@ import { RevisionBlock } from "@components/revision";
     </Desc>
 
     <Desc autorevSince="C99">
-      <RevisionBlock slot="item" noborder since="C99" dir="v">
+      <RevisionBlock slot="item" noborder since="C99" vertical>
         <CHeader name="complex" />
       </RevisionBlock>
       Complex number arithmetic
@@ -236,7 +236,7 @@ import { RevisionBlock } from "@components/revision";
 </Card>
 
 <Aside type="tip">
-  We strongly recommend you to specify the `dir="v"` attribute on the `RevisionBlock` component inside a `Decl`. This would render to a more mobile-friendly output.
+  We strongly recommend you to specify the `vertical` attribute on the `RevisionBlock` component inside a `Decl`. This would render to a more mobile-friendly output.
 </Aside>
 
 <Aside type="tip">

src/content/docs/development/guide/revision.mdx

@@ -138,11 +138,11 @@ Some more paragraphs.
 
 ### Vertical Layout
 
-By default, `RevisionBlock` has a left-to-right layout: the content sits at the left, and the revision information sits at the right. In addition, you can set the layout direction of `RevisionBlock` to top-to-bottom by setting the `dir` attribute to `v`:
+By default, `RevisionBlock` has a left-to-right layout: the content sits at the left, and the revision information sits at the right. In addition, you can set the layout direction of `RevisionBlock` to top-to-bottom by setting the `vertical` attribute to `true`:
 
 ```mdx {2}
 <RevisionBlock
-  dir="v"
+  vertical
   since="C++11"
   traits={[{ trait: "deprecated", since: "C++20" }]}
   removed="C++26"
@@ -154,7 +154,7 @@ By default, `RevisionBlock` has a left-to-right layout: the content sits at the
 
 <Card title="Preview">
   <RevisionBlock
-    dir="v"
+    vertical
     since="C++11"
     traits={[{ trait: "deprecated", since: "C++20" }]}
     removed="C++26"