@sitevision/api 2023.2.1 → 2023.2.2-beta.1

package/types/java/time/zone/ZoneOffsetTransition/index.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  of: function of() {},
+  getInstant: function getInstant() {},
+  toEpochSecond: function toEpochSecond() {},
+  getDateTimeBefore: function getDateTimeBefore() {},
+  getDateTimeAfter: function getDateTimeAfter() {},
+  getOffsetBefore: function getOffsetBefore() {},
+  getOffsetAfter: function getOffsetAfter() {},
+  getDuration: function getDuration() {},
+  isGap: function isGap() {},
+  isOverlap: function isOverlap() {},
+  isValidOffset: function isValidOffset() {},
+  compareTo: function compareTo() {},
+  equals: function equals() {},
+  hashCode: function hashCode() {},
+  toString: function toString() {}
+};
+exports["default"] = _default;

package/types/java/time/zone/ZoneRules/index.d.ts

@@ -0,0 +1,321 @@
+import type { ZoneOffset } from "../../ZoneOffset";
+import type { List } from "../../../util/List";
+
+import type { Instant } from "../../Instant";
+import type { LocalDateTime } from "../../LocalDateTime";
+import type { ZoneOffsetTransition } from "../ZoneOffsetTransition";
+import type { Duration } from "../../Duration";
+import type { Object } from "../../../lang/Object";
+
+import type { String } from "../../../lang/String";
+import type { Serializable } from "../../../io/Serializable";
+
+/**
+ * The rules defining how the zone offset varies for a single time-zone.
+ *  <p>
+ *  The rules model all the historic and future transitions for a time-zone.
+ *  {@link ZoneOffsetTransition} is used for known transitions, typically historic.
+ *  {@link ZoneOffsetTransitionRule} is used for future transitions that are based
+ *  on the result of an algorithm.
+ *  <p>
+ *  The rules are loaded via {@link ZoneRulesProvider} using a {@link ZoneId}.
+ *  The same rules may be shared internally between multiple zone IDs.
+ *  <p>
+ *  Serializing an instance of {@code ZoneRules} will store the entire set of rules.
+ *  It does not store the zone ID as it is not part of the state of this object.
+ *  <p>
+ *  A rule implementation may or may not store full information about historic
+ *  and future transitions, and the information stored is only as accurate as
+ *  that supplied to the implementation by the rules provider.
+ *  Applications should treat the data provided as representing the best information
+ *  available to the implementation of this rule.
+ * @implSpec This class is immutable and thread-safe.
+ * @since 1.8
+ */
+export type ZoneRules = Object &
+  Serializable & {
+    /**
+     * Obtains an instance of a ZoneRules.
+     * @param baseStandardOffset the standard offset to use before legal rules were set, not null
+     * @param baseWallOffset the wall offset to use before legal rules were set, not null
+     * @param standardOffsetTransitionList the list of changes to the standard offset, not null
+     * @param transitionList the list of transitions, not null
+     * @param lastRules the recurring last rules, size 16 or less, not null
+     * @return the zone rules, not null
+     */
+    of(
+      baseStandardOffset: ZoneOffset,
+      baseWallOffset: ZoneOffset,
+      standardOffsetTransitionList: List | unknown[],
+      transitionList: List | unknown[],
+      lastRules: List | unknown[]
+    ): ZoneRules;
+
+    /**
+     * Obtains an instance of ZoneRules that has fixed zone rules.
+     * @param offset the offset this fixed zone rules is based on, not null
+     * @return the zone rules, not null
+     * @see #isFixedOffset()
+     */
+    of(offset: ZoneOffset): ZoneRules;
+
+    /**
+     * Checks of the zone rules are fixed, such that the offset never varies.
+     * @return true if the time-zone is fixed and the offset never changes
+     */
+    isFixedOffset(): boolean;
+
+    /**
+     * Gets the offset applicable at the specified instant in these rules.
+     *  <p>
+     *  The mapping from an instant to an offset is simple, there is only
+     *  one valid offset for each instant.
+     *  This method returns that offset.
+     * @param instant the instant to find the offset for, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the offset, not null
+     */
+    getOffset(instant: Instant): ZoneOffset;
+
+    /**
+     * Gets a suitable offset for the specified local date-time in these rules.
+     *  <p>
+     *  The mapping from a local date-time to an offset is not straightforward.
+     *  There are three cases:
+     *  <ul>
+     *  <li>Normal, with one valid offset. For the vast majority of the year, the normal
+     *   case applies, where there is a single valid offset for the local date-time.</li>
+     *  <li>Gap, with zero valid offsets. This is when clocks jump forward typically
+     *   due to the spring daylight savings change from "winter" to "summer".
+     *   In a gap there are local date-time values with no valid offset.</li>
+     *  <li>Overlap, with two valid offsets. This is when clocks are set back typically
+     *   due to the autumn daylight savings change from "summer" to "winter".
+     *   In an overlap there are local date-time values with two valid offsets.</li>
+     *  </ul>
+     *  Thus, for any given local date-time there can be zero, one or two valid offsets.
+     *  This method returns the single offset in the Normal case, and in the Gap or Overlap
+     *  case it returns the offset before the transition.
+     *  <p>
+     *  Since, in the case of Gap and Overlap, the offset returned is a "best" value, rather
+     *  than the "correct" value, it should be treated with care. Applications that care
+     *  about the correct offset should use a combination of this method,
+     *  {@link #getValidOffsets(LocalDateTime)} and {@link #getTransition(LocalDateTime)}.
+     * @param localDateTime the local date-time to query, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the best available offset for the local date-time, not null
+     */
+    getOffset(localDateTime: LocalDateTime): ZoneOffset;
+
+    /**
+     * Gets the offset applicable at the specified local date-time in these rules.
+     *  <p>
+     *  The mapping from a local date-time to an offset is not straightforward.
+     *  There are three cases:
+     *  <ul>
+     *  <li>Normal, with one valid offset. For the vast majority of the year, the normal
+     *   case applies, where there is a single valid offset for the local date-time.</li>
+     *  <li>Gap, with zero valid offsets. This is when clocks jump forward typically
+     *   due to the spring daylight savings change from "winter" to "summer".
+     *   In a gap there are local date-time values with no valid offset.</li>
+     *  <li>Overlap, with two valid offsets. This is when clocks are set back typically
+     *   due to the autumn daylight savings change from "summer" to "winter".
+     *   In an overlap there are local date-time values with two valid offsets.</li>
+     *  </ul>
+     *  Thus, for any given local date-time there can be zero, one or two valid offsets.
+     *  This method returns that list of valid offsets, which is a list of size 0, 1 or 2.
+     *  In the case where there are two offsets, the earlier offset is returned at index 0
+     *  and the later offset at index 1.
+     *  <p>
+     *  There are various ways to handle the conversion from a {@code LocalDateTime}.
+     *  One technique, using this method, would be:
+     *  <pre>
+     *   List&lt;ZoneOffset&gt; validOffsets = rules.getOffset(localDT);
+     *   if (validOffsets.size() == 1) {
+     *     // Normal case: only one valid offset
+     *     zoneOffset = validOffsets.get(0);
+     *   } else {
+     *     // Gap or Overlap: determine what to do from transition (which will be non-null)
+     *     ZoneOffsetTransition trans = rules.getTransition(localDT);
+     *   }
+     *  </pre>
+     *  <p>
+     *  In theory, it is possible for there to be more than two valid offsets.
+     *  This would happen if clocks to be put back more than once in quick succession.
+     *  This has never happened in the history of time-zones and thus has no special handling.
+     *  However, if it were to happen, then the list would return more than 2 entries.
+     * @param localDateTime the local date-time to query for valid offsets, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the list of valid offsets, may be immutable, not null
+     */
+    getValidOffsets(localDateTime: LocalDateTime): List;
+
+    /**
+     * Gets the offset transition applicable at the specified local date-time in these rules.
+     *  <p>
+     *  The mapping from a local date-time to an offset is not straightforward.
+     *  There are three cases:
+     *  <ul>
+     *  <li>Normal, with one valid offset. For the vast majority of the year, the normal
+     *   case applies, where there is a single valid offset for the local date-time.</li>
+     *  <li>Gap, with zero valid offsets. This is when clocks jump forward typically
+     *   due to the spring daylight savings change from "winter" to "summer".
+     *   In a gap there are local date-time values with no valid offset.</li>
+     *  <li>Overlap, with two valid offsets. This is when clocks are set back typically
+     *   due to the autumn daylight savings change from "summer" to "winter".
+     *   In an overlap there are local date-time values with two valid offsets.</li>
+     *  </ul>
+     *  A transition is used to model the cases of a Gap or Overlap.
+     *  The Normal case will return null.
+     *  <p>
+     *  There are various ways to handle the conversion from a {@code LocalDateTime}.
+     *  One technique, using this method, would be:
+     *  <pre>
+     *   ZoneOffsetTransition trans = rules.getTransition(localDT);
+     *   if (trans == null) {
+     *     // Gap or Overlap: determine what to do from transition
+     *   } else {
+     *     // Normal case: only one valid offset
+     *     zoneOffset = rule.getOffset(localDT);
+     *   }
+     *  </pre>
+     * @param localDateTime the local date-time to query for offset transition, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the offset transition, null if the local date-time is not in transition
+     */
+    getTransition(localDateTime: LocalDateTime): ZoneOffsetTransition;
+
+    /**
+     * Gets the standard offset for the specified instant in this zone.
+     *  <p>
+     *  This provides access to historic information on how the standard offset
+     *  has changed over time.
+     *  The standard offset is the offset before any daylight saving time is applied.
+     *  This is typically the offset applicable during winter.
+     * @param instant the instant to find the offset information for, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the standard offset, not null
+     */
+    getStandardOffset(instant: Instant): ZoneOffset;
+
+    /**
+     * Gets the amount of daylight savings in use for the specified instant in this zone.
+     *  <p>
+     *  This provides access to historic information on how the amount of daylight
+     *  savings has changed over time.
+     *  This is the difference between the standard offset and the actual offset.
+     *  Typically the amount is zero during winter and one hour during summer.
+     *  Time-zones are second-based, so the nanosecond part of the duration will be zero.
+     *  <p>
+     *  This default implementation calculates the duration from the
+     *  {@link #getOffset(java.time.Instant) actual} and
+     *  {@link #getStandardOffset(java.time.Instant) standard} offsets.
+     * @param instant the instant to find the daylight savings for, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the difference between the standard and actual offset, not null
+     */
+    getDaylightSavings(instant: Instant): Duration;
+
+    /**
+     * Checks if the specified instant is in daylight savings.
+     *  <p>
+     *  This checks if the standard offset and the actual offset are the same
+     *  for the specified instant.
+     *  If they are not, it is assumed that daylight savings is in operation.
+     *  <p>
+     *  This default implementation compares the {@link #getOffset(java.time.Instant) actual}
+     *  and {@link #getStandardOffset(java.time.Instant) standard} offsets.
+     * @param instant the instant to find the offset information for, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the standard offset, not null
+     */
+    isDaylightSavings(instant: Instant): boolean;
+
+    /**
+     * Checks if the offset date-time is valid for these rules.
+     *  <p>
+     *  To be valid, the local date-time must not be in a gap and the offset
+     *  must match one of the valid offsets.
+     *  <p>
+     *  This default implementation checks if {@link #getValidOffsets(java.time.LocalDateTime)}
+     *  contains the specified offset.
+     * @param localDateTime the date-time to check, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @param offset the offset to check, null returns false
+     * @return true if the offset date-time is valid for these rules
+     */
+    isValidOffset(localDateTime: LocalDateTime, offset: ZoneOffset): boolean;
+
+    /**
+     * Gets the next transition after the specified instant.
+     *  <p>
+     *  This returns details of the next transition after the specified instant.
+     *  For example, if the instant represents a point where "Summer" daylight savings time
+     *  applies, then the method will return the transition to the next "Winter" time.
+     * @param instant the instant to get the next transition after, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the next transition after the specified instant, null if this is after the last transition
+     */
+    nextTransition(instant: Instant): ZoneOffsetTransition;
+
+    /**
+     * Gets the previous transition before the specified instant.
+     *  <p>
+     *  This returns details of the previous transition after the specified instant.
+     *  For example, if the instant represents a point where "summer" daylight saving time
+     *  applies, then the method will return the transition from the previous "winter" time.
+     * @param instant the instant to get the previous transition after, not null, but null&#xA; may be ignored if the rules have a single offset for all instants
+     * @return the previous transition after the specified instant, null if this is before the first transition
+     */
+    previousTransition(instant: Instant): ZoneOffsetTransition;
+
+    /**
+     * Gets the complete list of fully defined transitions.
+     *  <p>
+     *  The complete set of transitions for this rules instance is defined by this method
+     *  and {@link #getTransitionRules()}. This method returns those transitions that have
+     *  been fully defined. These are typically historical, but may be in the future.
+     *  <p>
+     *  The list will be empty for fixed offset rules and for any time-zone where there has
+     *  only ever been a single offset. The list will also be empty if the transition rules are unknown.
+     * @return an immutable list of fully defined transitions, not null
+     */
+    getTransitions(): List;
+
+    /**
+     * Gets the list of transition rules for years beyond those defined in the transition list.
+     *  <p>
+     *  The complete set of transitions for this rules instance is defined by this method
+     *  and {@link #getTransitions()}. This method returns instances of {@link ZoneOffsetTransitionRule}
+     *  that define an algorithm for when transitions will occur.
+     *  <p>
+     *  For any given {@code ZoneRules}, this list contains the transition rules for years
+     *  beyond those years that have been fully defined. These rules typically refer to future
+     *  daylight saving time rule changes.
+     *  <p>
+     *  If the zone defines daylight savings into the future, then the list will normally
+     *  be of size two and hold information about entering and exiting daylight savings.
+     *  If the zone does not have daylight savings, or information about future changes
+     *  is uncertain, then the list will be empty.
+     *  <p>
+     *  The list will be empty for fixed offset rules and for any time-zone where there is no
+     *  daylight saving time. The list will also be empty if the transition rules are unknown.
+     * @return an immutable list of transition rules, not null
+     */
+    getTransitionRules(): List;
+
+    /**
+     * Checks if this set of rules equals another.
+     *  <p>
+     *  Two rule sets are equal if they will always result in the same output
+     *  for any given input instant or local date-time.
+     *  Rules from two different groups may return false even if they are in fact the same.
+     *  <p>
+     *  This definition should result in implementations comparing their entire state.
+     * @param otherRules the other rules, null returns false
+     * @return true if this rules is the same as that specified
+     */
+    equals(otherRules: unknown): boolean;
+
+    /**
+     * Returns a suitable hash code given the definition of {@code #equals}.
+     * @return the hash code
+     */
+    hashCode(): number;
+
+    /**
+     * Returns a string describing this object.
+     * @return a string for debugging, not null
+     */
+    toString(): string;
+  };

package/types/java/time/zone/ZoneRules/index.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  of: function of() {},
+  isFixedOffset: function isFixedOffset() {},
+  getOffset: function getOffset() {},
+  getValidOffsets: function getValidOffsets() {},
+  getTransition: function getTransition() {},
+  getStandardOffset: function getStandardOffset() {},
+  getDaylightSavings: function getDaylightSavings() {},
+  isDaylightSavings: function isDaylightSavings() {},
+  isValidOffset: function isValidOffset() {},
+  nextTransition: function nextTransition() {},
+  previousTransition: function previousTransition() {},
+  getTransitions: function getTransitions() {},
+  getTransitionRules: function getTransitionRules() {},
+  equals: function equals() {},
+  hashCode: function hashCode() {},
+  toString: function toString() {}
+};
+exports["default"] = _default;

package/types/java/util/AbstractCollection/index.d.ts

@@ -0,0 +1,250 @@
+import type { Iterator } from "../Iterator";
+
+import type { Object } from "../../lang/Object";
+
+import type { Collection } from "../Collection";
+
+import type { String } from "../../lang/String";
+
+/**
+ * This class provides a skeletal implementation of the <tt>Collection</tt>
+ *  interface, to minimize the effort required to implement this interface. <p>
+ *
+ *  To implement an unmodifiable collection, the programmer needs only to
+ *  extend this class and provide implementations for the <tt>iterator</tt> and
+ *  <tt>size</tt> methods.  (The iterator returned by the <tt>iterator</tt>
+ *  method must implement <tt>hasNext</tt> and <tt>next</tt>.)<p>
+ *
+ *  To implement a modifiable collection, the programmer must additionally
+ *  override this class's <tt>add</tt> method (which otherwise throws an
+ *  <tt>UnsupportedOperationException</tt>), and the iterator returned by the
+ *  <tt>iterator</tt> method must additionally implement its <tt>remove</tt>
+ *  method.<p>
+ *
+ *  The programmer should generally provide a void (no argument) and
+ *  <tt>Collection</tt> constructor, as per the recommendation in the
+ *  <tt>Collection</tt> interface specification.<p>
+ *
+ *  The documentation for each non-abstract method in this class describes its
+ *  implementation in detail.  Each of these methods may be overridden if
+ *  the collection being implemented admits a more efficient implementation.<p>
+ *
+ *  This class is a member of the
+ *  <a href="{@docRoot}/../technotes/guides/collections/index.html">
+ *  Java Collections Framework</a>.
+ * @author Josh Bloch
+ * @author Neal Gafter
+ * @see Collection
+ * @since 1.2
+ */
+export type AbstractCollection = Object &
+  Collection & {
+    /**
+     * Returns an iterator over the elements contained in this collection.
+     * @return an iterator over the elements contained in this collection
+     */
+    iterator(): Iterator;
+
+    size(): number;
+
+    /**
+ * {@inheritDoc}
+ * 
+ *  <p>This implementation returns <tt>size() == 0</tt>.
+  
+    */
+    isEmpty(): boolean;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation iterates over the elements in the collection,
+     *  checking each element in turn for equality with the specified element.
+     * @throws ClassCastException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     */
+    contains(o: unknown): boolean;
+
+    /**
+ * {@inheritDoc}
+ * 
+ *  <p>This implementation returns an array containing all the elements
+ *  returned by this collection's iterator, in the same order, stored in
+ *  consecutive elements of the array, starting with index {@code 0}.
+ *  The length of the returned array is equal to the number of elements
+ *  returned by the iterator, even if the size of this collection changes
+ *  during iteration, as might happen if the collection permits
+ *  concurrent modification during iteration.  The {@code size} method is
+ *  called only as an optimization hint; the correct result is returned
+ *  even if the iterator returns a different number of elements.
+ * 
+ *  <p>This method is equivalent to:
+ * 
+ *   <pre> {@code
+ *  List<E> list = new ArrayList<E>(size());
+ *  for (E e : this)
+ *      list.add(e);
+ *  return list.toArray();
+ *  }</pre>
+  
+    */
+    toArray(): unknown;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation returns an array containing all the elements
+     *  returned by this collection's iterator in the same order, stored in
+     *  consecutive elements of the array, starting with index {@code 0}.
+     *  If the number of elements returned by the iterator is too large to
+     *  fit into the specified array, then the elements are returned in a
+     *  newly allocated array with length equal to the number of elements
+     *  returned by the iterator, even if the size of this collection
+     *  changes during iteration, as might happen if the collection permits
+     *  concurrent modification during iteration.  The {@code size} method is
+     *  called only as an optimization hint; the correct result is returned
+     *  even if the iterator returns a different number of elements.
+     *
+     *  <p>This method is equivalent to:
+     *
+     *   <pre> {@code
+     *  List<E> list = new ArrayList<E>(size());
+     *  for (E e : this)
+     *      list.add(e);
+     *  return list.toArray(a);
+     *  }</pre>
+     * @throws ArrayStoreException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     */
+    toArray(a: unknown[]): unknown;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation always throws an
+     *  <tt>UnsupportedOperationException</tt>.
+     * @throws UnsupportedOperationException {@inheritDoc}
+     * @throws ClassCastException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     * @throws IllegalArgumentException {@inheritDoc}
+     * @throws IllegalStateException {@inheritDoc}
+     */
+    add(e: unknown): boolean;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation iterates over the collection looking for the
+     *  specified element.  If it finds the element, it removes the element
+     *  from the collection using the iterator's remove method.
+     *
+     *  <p>Note that this implementation throws an
+     *  <tt>UnsupportedOperationException</tt> if the iterator returned by this
+     *  collection's iterator method does not implement the <tt>remove</tt>
+     *  method and this collection contains the specified object.
+     * @throws UnsupportedOperationException {@inheritDoc}
+     * @throws ClassCastException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     */
+    remove(o: unknown): boolean;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation iterates over the specified collection,
+     *  checking each element returned by the iterator in turn to see
+     *  if it's contained in this collection.  If all elements are so
+     *  contained <tt>true</tt> is returned, otherwise <tt>false</tt>.
+     * @throws ClassCastException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     * @see #contains(Object)
+     */
+    containsAll(c: Collection | unknown[]): boolean;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation iterates over the specified collection, and adds
+     *  each object returned by the iterator to this collection, in turn.
+     *
+     *  <p>Note that this implementation will throw an
+     *  <tt>UnsupportedOperationException</tt> unless <tt>add</tt> is
+     *  overridden (assuming the specified collection is non-empty).
+     * @throws UnsupportedOperationException {@inheritDoc}
+     * @throws ClassCastException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     * @throws IllegalArgumentException {@inheritDoc}
+     * @throws IllegalStateException {@inheritDoc}
+     * @see #add(Object)
+     */
+    addAll(c: Collection | unknown[]): boolean;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation iterates over this collection, checking each
+     *  element returned by the iterator in turn to see if it's contained
+     *  in the specified collection.  If it's so contained, it's removed from
+     *  this collection with the iterator's <tt>remove</tt> method.
+     *
+     *  <p>Note that this implementation will throw an
+     *  <tt>UnsupportedOperationException</tt> if the iterator returned by the
+     *  <tt>iterator</tt> method does not implement the <tt>remove</tt> method
+     *  and this collection contains one or more elements in common with the
+     *  specified collection.
+     * @throws UnsupportedOperationException {@inheritDoc}
+     * @throws ClassCastException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     * @see #remove(Object)
+     * @see #contains(Object)
+     */
+    removeAll(c: Collection | unknown[]): boolean;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation iterates over this collection, checking each
+     *  element returned by the iterator in turn to see if it's contained
+     *  in the specified collection.  If it's not so contained, it's removed
+     *  from this collection with the iterator's <tt>remove</tt> method.
+     *
+     *  <p>Note that this implementation will throw an
+     *  <tt>UnsupportedOperationException</tt> if the iterator returned by the
+     *  <tt>iterator</tt> method does not implement the <tt>remove</tt> method
+     *  and this collection contains one or more elements not present in the
+     *  specified collection.
+     * @throws UnsupportedOperationException {@inheritDoc}
+     * @throws ClassCastException {@inheritDoc}
+     * @throws NullPointerException {@inheritDoc}
+     * @see #remove(Object)
+     * @see #contains(Object)
+     */
+    retainAll(c: Collection | unknown[]): boolean;
+
+    /**
+     * {@inheritDoc}
+     *
+     *  <p>This implementation iterates over this collection, removing each
+     *  element using the <tt>Iterator.remove</tt> operation.  Most
+     *  implementations will probably choose to override this method for
+     *  efficiency.
+     *
+     *  <p>Note that this implementation will throw an
+     *  <tt>UnsupportedOperationException</tt> if the iterator returned by this
+     *  collection's <tt>iterator</tt> method does not implement the
+     *  <tt>remove</tt> method and this collection is non-empty.
+     * @throws UnsupportedOperationException {@inheritDoc}
+     */
+    clear(): void;
+
+    /**
+     * Returns a string representation of this collection.  The string
+     *  representation consists of a list of the collection's elements in the
+     *  order they are returned by its iterator, enclosed in square brackets
+     *  (<tt>"[]"</tt>).  Adjacent elements are separated by the characters
+     *  <tt>", "</tt> (comma and space).  Elements are converted to strings as
+     *  by {@link String#valueOf(Object)}.
+     * @return a string representation of this collection
+     */
+    toString(): string;
+  };

package/types/java/util/AbstractCollection/index.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _default = {
+  iterator: function iterator() {},
+  size: function size() {},
+  isEmpty: function isEmpty() {},
+  contains: function contains() {},
+  toArray: function toArray() {},
+  add: function add() {},
+  remove: function remove() {},
+  containsAll: function containsAll() {},
+  addAll: function addAll() {},
+  removeAll: function removeAll() {},
+  retainAll: function retainAll() {},
+  clear: function clear() {},
+  toString: function toString() {}
+};
+exports["default"] = _default;