add builtin time and duration

Author: mkideal

builtin/c.map

@@ -12,6 +12,8 @@ bool=_Bool
 string=char*
 byte=uint8_t
 bytes=uint8_t*
+time=time_t
+duration=int64_t
 any=void*
 array=%T%[%N%]
 # map=<c.map: not supported by default>

builtin/cpp.map

@@ -12,6 +12,8 @@ bool=bool
 string=std::string
 byte=unsigned char
 bytes=std::vector<unsigned char>
+time=std::time_t
+duration=int64_t
 any=std::any
 map=std::unordered_map<%K%, %V%>
 vector=std::vector<%T%>

builtin/csharp.map

@@ -12,6 +12,8 @@ bool=bool
 string=string
 byte=byte
 bytes=byte[]
+time=System.DateTime
+duration=System.TimeSpan
 any=object
 map=Dictionary<%K%, %V%>
 vector=List<%T%>

builtin/go.map

@@ -12,6 +12,8 @@ bool=bool
 string=string
 byte=byte
 bytes=[]byte
+time=time.Time
+duration=time.Duration
 any=any
 map=map[%K%]%V%
 vector=[]%T%

builtin/java.map

@@ -12,6 +12,8 @@ bool=boolean
 string=String
 byte=byte
 bytes=byte[]
+time=java.time.ZonedDateTime
+duration=java.time.Duration
 any=Object
 map=Map<box(%K%), box(%V%)>
 vector=List<box(%T%)>

builtin/js.map

@@ -12,6 +12,8 @@ bool=Boolean
 string=String
 byte=Number
 bytes=Uint8Array
+time=Date
+duration=BigInt
 any=Object
 map=Map
 vector=Array

builtin/lua.map

@@ -5,13 +5,15 @@ int=number
 int8=number
 int16=number
 int32=number
-int64=number
+int64=integer
 float32=number
 float64=number
 bool=boolean
 string=string
 byte=number
 bytes=string
+time=integer
+duration=integer
 any=any
 map=table
 vector=table

builtin/php.map

@@ -12,6 +12,8 @@ bool=bool
 string=string
 byte=int
 bytes=string
+time=DateTime
+duration=DateInterval
 any=mixed
 map=array
 vector=array

builtin/protobuf.map

@@ -12,6 +12,8 @@ bool=bool
 string=string
 byte=int32
 bytes=bytes
+time=int64
+duration=int64
 any=google.protobuf.Any
 map=map<%K%, %V%>
 vector=repeated %T.E%

builtin/python.map

@@ -12,6 +12,8 @@ bool=bool
 string=str
 byte=int
 bytes=bytes
+time=int
+duration=int
 any=Any
 map=Dict[%K%, %V%]
 vector=List[%T%]

builtin/rust.map

@@ -12,6 +12,8 @@ bool=bool
 string=String
 byte=u8
 bytes=Vec<u8>
+time=std::time::SystemTime
+duration=std::time::Duration
 any=Box<dyn Any>
 map=HashMap<%K%, %V%>
 vector=Vec<%T%>

builtin/ts.map

@@ -12,6 +12,8 @@ bool=boolean
 string=string
 byte=number
 bytes=Uint8Array
+time=Date
+duration=bigint
 any=any
 map=Map<%K%, %V%>
 vector=Array<%T%>

src/compile/kind.go

@@ -76,6 +76,8 @@ func (k Kind) grammarType() string {
 // - **byte**: byte
 // - **bytes**: byte slice
 // - **string**: string
+// - **time**: time
+// - **duration**: duration
 // - **any**: any object
 // - **map**: dictionary
 // - **vector**: vector of elements
@@ -96,6 +98,8 @@ const (
 	KindByte                  // byte
 	KindBytes                 // bytes
 	KindString                // string
+	KindTime                  // time
+	KindDuration              // duration
 	KindAny                   // any
 	KindMap                   // map
 	KindVector                // vector
@@ -177,7 +181,7 @@ func (k Kind) Bits() int {
 
 // @api(Object/Common/Type/Kind.IsPrimitive) reports whether the type is a [PrimitiveType](#Object/PrimitiveType).
 func (k Kind) IsPrimitive() bool {
-	return k.IsNumeric() || k.IsString() || k.IsBytes() || k.IsBool() || k.IsAny()
+	return k.IsNumeric() || k.IsString() || k.IsBytes() || k.IsBool() || k.IsAny() || k.IsTime() || k.IsDuration()
 }
 
 // @api(Object/Common/Type/Kind.IsInteger) reports whether the type is an integer.
@@ -216,6 +220,12 @@ func (k Kind) IsBytes() bool { return k == KindBytes }
 // @api(Object/Common/Type/Kind.IsBool) reports whether the type is a boolean.
 func (k Kind) IsBool() bool { return k == KindBool }
 
+// @api(Object/Common/Type/Kind.IsTime) reports whether the type is a time.
+func (k Kind) IsTime() bool { return k == KindTime }
+
+// @api(Object/Common/Type/Kind.IsDuration) reports whether the type is a duration.
+func (k Kind) IsDuration() bool { return k == KindDuration }
+
 // @api(Object/Common/Type/Kind.IsAny) reports whether the type is any.
 func (k Kind) IsAny() bool { return k == KindAny }
 
@@ -272,5 +282,7 @@ var primitiveKinds = []Kind{
 	KindByte,
 	KindBytes,
 	KindString,
+	KindTime,
+	KindDuration,
 	KindAny,
 }

src/compile/kind_string.go

@@ -225,6 +225,13 @@ If you want to check whether the annotation has a non-empty value, you can use t
 
 </div>
 
+###### .Len {#user-content-Object_Common_Annotation__Len}
+<div className="property-container">
+
+`.Len` returns the number of parameters in the annotation.
+
+</div>
+
 ###### .NamePos {#user-content-Object_Common_Annotation__NamePos}
 <div className="property-container">
 
@@ -1121,6 +1128,8 @@ false
 - **byte**: byte
 - **bytes**: byte slice
 - **string**: string
+- **time**: time
+- **duration**: duration
 - **any**: any object
 - **map**: dictionary
 - **vector**: vector of elements
@@ -1178,6 +1187,13 @@ false
 
 </div>
 
+###### .IsDuration {#user-content-Object_Common_Type_Kind__IsDuration}
+<div className="property-container">
+
+`.IsDuration` reports whether the type is a duration.
+
+</div>
+
 ###### .IsEnum {#user-content-Object_Common_Type_Kind__IsEnum}
 <div className="property-container">
 
@@ -1241,6 +1257,13 @@ false
 
 </div>
 
+###### .IsTime {#user-content-Object_Common_Type_Kind__IsTime}
+<div className="property-container">
+
+`.IsTime` reports whether the type is a time.
+
+</div>
+
 ###### .IsVector {#user-content-Object_Common_Type_Kind__IsVector}
 <div className="property-container">
 
@@ -2108,6 +2131,10 @@ Example:
 
 </div>
 
+## Packages {#user-content-Object_Packages}
+
+`Packages` represents a list of Next packages.
+
 ## PrimitiveType {#user-content-Object_PrimitiveType}
 
 `PrimitiveType` represents a primitive type.

website/docs/api/latest/object.mdx

@@ -1128,6 +1128,8 @@ false
 - **byte**: byte
 - **bytes**: byte slice
 - **string**: string
+- **time**: time
+- **duration**: duration
 - **any**: any object
 - **map**: dictionary
 - **vector**: vector of elements
@@ -1185,6 +1187,13 @@ false
 
 </div>
 
+###### .IsDuration {#user-content-Object_Common_Type_Kind__IsDuration}
+<div className="property-container">
+
+`.IsDuration` reports whether the type is a duration.
+
+</div>
+
 ###### .IsEnum {#user-content-Object_Common_Type_Kind__IsEnum}
 <div className="property-container">
 
@@ -1248,6 +1257,13 @@ false
 
 </div>
 
+###### .IsTime {#user-content-Object_Common_Type_Kind__IsTime}
+<div className="property-container">
+
+`.IsTime` reports whether the type is a time.
+
+</div>
+
 ###### .IsVector {#user-content-Object_Common_Type_Kind__IsVector}
 <div className="property-container">
 

website/docs/api/preview/object.mdx

@@ -12,7 +12,7 @@ const PROJECT_NAME = "next";
 const REPO = `https://github.com/${ORGANIZATION_NAME}/${PROJECT_NAME}`;
 
 const customFields = {
-  version: "0.2.7",
+  version: "0.2.8",
   repo: REPO,
 };